File artifacts¶

Package	Value
Distribution	`archetype-ecs`
Import package	`archetype`

Recommended API. Declare files, configure content-addressed storage, retain portable references to indexed artifact occurrences, and anchor interpretation to a task.

ArtifactContext ¶

One task-scoped interpretation of an immutable artifact set.

Field	Type	Default	Description
`task`	`str`	`required`	Authoritative task applied to every artifact
`artifact_ids`	`tuple[str, ...]`	`required`	UUIDv7 occurrence identities selected as evidence
`context_id`	`str`	`generated by _uuidv7_string`	UUIDv7 identity for this interpretation

ArtifactSource ¶

One exact file or Daft-readable pattern submitted for ingestion.

Field	Type	Default
`source_uri`	`str`	`required`
`logical_path`	`str`	`''`
`required`	`bool`	`True`

ArtifactRef ¶

Portable reference to one indexed, content-addressed file occurrence.

Field	Type	Default
`artifact_id`	`str`	`required`
`logical_path`	`str`	`required`
`uri`	`str`	`required`
`sha256`	`str`	`required`
`xxhash3_64`	`str`	`required`
`media_type`	`str`	`required`
`size_bytes`	`int`	`required`

ArtifactStoreConfig ¶

Configure content-addressed object storage and Daft file I/O.

local `classmethod` ¶

local(root)

Place content-addressed objects beneath a local root.

Field	Type	Default
`object_uri`	`str \\| Path \\| None`	`None`
`io_config`	`object \\| None`	`None`
`max_connections`	`int`	`32`

analyze_artifacts ¶

analyze_artifacts(
    index,
    context,
    *,
    io_config=None,
    provider=None,
    model=None,
)

Analyze an explicit set of artifact occurrences in parallel.

synthesize_artifact_context ¶

synthesize_artifact_context(
    analyses, context, *, provider=None, model=None
)

Reduce per-artifact observations into one task-scoped synthesis row.