Agent Missions¶

Package	Value
Distribution	`archetype-missions`
Import package	`archetype.missions`

Recommended API. Run coding-agent missions and inspect mission-owned transcript and trajectory evidence.

Missions ¶

Missions(
    runtime, name="agent-missions", *, config, storage=None
)

Batteries-included authoring handle for one mission-capable world.

world_id `property` ¶

world_id

Return the activated world's durable identity.

submit `async` ¶

submit(
    *,
    repository,
    branch,
    tasks,
    name="agent-mission",
    base_ref="main",
)

Persist one coding mission and return its durable identity.

accept `async` ¶

accept(
    *,
    repository,
    branch,
    tasks,
    principal,
    idempotency_key,
    name="agent-mission",
    base_ref="main",
)

Admit one durable MissionRun and return its run_id before completion.

get_run `async` ¶

get_run(run_id)

Load one durable MissionRun and resume supervision if it is still open.

cancel_run `async` ¶

cancel_run(run_id, *, reason='')

Record cancellation intent without cancelling already admitted work.

run `async` ¶

run(mission, *, max_ticks=None)

Run a submitted mission to a terminal result.

restore_sandbox `async` ¶

restore_sandbox(mission, checkpoint)

Fail explicitly until checkpoint identity is bound into Activity admission.

query `async` ¶

query(*components)

Query persisted mission state through the underlying world read path.

close `async` ¶

close()

Release this mission workflow handle and its world reservation.

MissionWorld ¶

MissionWorld(world)

Mission transcript and trajectory capabilities over one generic world.

world `property` ¶

world

Return the wrapped generic world handle.

ingest_claude_transcript `async` ¶

ingest_claude_transcript(source)

Redact and index one Claude JSONL session as mission evidence.

transcript_rows `async` ¶

transcript_rows()

Return normalized coding-agent transcript rows for this run.

query_trajectory `async` ¶

query_trajectory(
    component_type,
    *,
    selection=None,
    ticks=None,
    entity_ids=None,
)

Return one trajectory table filtered by its typed index fields.

grade_trajectory `async` ¶

grade_trajectory(
    component_type,
    *,
    graders,
    selection=None,
    ticks=None,
    entity_ids=None,
)

Query one trajectory table and run graders over the lazy frame.

AgentMissionConfig `dataclass` ¶

AgentMissionConfig(
    sandbox_backend,
    sandbox_environment,
    driver=None,
    critic_driver=None,
    workspace="/workspace/repo",
    critic_workspace="/workspace/review",
    model="",
    max_ticks=100,
    checkpoint_after_dispatch=True,
    on_sandbox_event=None,
)

Process configuration bound once to a mission runtime handle.

Field	Type	Default
`sandbox_backend`	`SandboxBackend`	`required`
`sandbox_environment`	`str`	`required`
`driver`	`CodingAgentDriver \\| None`	`None`
`critic_driver`	`CriticDriver \\| None`	`None`
`workspace`	`str`	`'/workspace/repo'`
`critic_workspace`	`str`	`'/workspace/review'`
`model`	`str`	`''`
`max_ticks`	`int`	`100`
`checkpoint_after_dispatch`	`bool`	`True`
`on_sandbox_event`	`SandboxEventObserver \\| None`	`None`

AgentTask `dataclass` ¶

AgentTask(
    name,
    prompt,
    validators,
    depends_on=(),
    max_dispatches=3,
    publication_policy=COMMIT_AND_PUSH,
    critic_policy=CriticPolicy(),
)

One explicitly authored task and its incoming dependency names.

Field	Type	Default
`name`	`str`	`required`
`prompt`	`str`	`required`
`validators`	`tuple[CommandValidator, ...]`	`required`
`depends_on`	`tuple[str, ...]`	`()`
`max_dispatches`	`int`	`3`
`publication_policy`	`RepositoryPublicationPolicy`	`'commit_and_push'`
`critic_policy`	`CriticPolicy`	`CriticPolicy(policy_id='archetype.exact-head', version='1', perspective='repository-correctness', information_view='task-diff-validators', driver='codex', model='', sampling='provider-default', max_reviews=2, timeout_seconds=2700, output_schema_version=1, max_output_chars=16000, max_subject_bytes=4194304)`

CommandValidator `dataclass` ¶

CommandValidator(
    name,
    command,
    expected_returncode=0,
    timeout_seconds=900,
)

One repository command whose exit code gates a task transition.

Field	Type	Default
`name`	`str`	`required`
`command`	`tuple[str, ...]`	`required`
`expected_returncode`	`int`	`0`
`timeout_seconds`	`int`	`900`

CriticPolicy `dataclass` ¶

CriticPolicy(
    policy_id="archetype.exact-head",
    version="1",
    perspective="repository-correctness",
    information_view="task-diff-validators",
    driver="codex",
    model="",
    sampling="provider-default",
    max_reviews=2,
    timeout_seconds=45 * 60,
    output_schema_version=1,
    max_output_chars=16000,
    max_subject_bytes=4 << 20,
)

Stable, digestible policy for one independent exact-head review.

Field	Type	Default
`policy_id`	`str`	`'archetype.exact-head'`
`version`	`str`	`'1'`
`perspective`	`str`	`'repository-correctness'`
`information_view`	`str`	`'task-diff-validators'`
`driver`	`str`	`'codex'`
`model`	`str`	`''`
`sampling`	`str`	`'provider-default'`
`max_reviews`	`int`	`2`
`timeout_seconds`	`int`	`2700`
`output_schema_version`	`int`	`1`
`max_output_chars`	`int`	`16000`
`max_subject_bytes`	`int`	`4194304`

RepositoryPublicationPolicy ¶

Repository finalization required before a task may be accepted.

Field	Type	Default
`COMMIT_AND_PUSH`	`RepositoryPublicationPolicy`	`'commit_and_push'`

SubmittedMission `dataclass` ¶

SubmittedMission(
    mission_id,
    task_ids,
    episode_id,
    repository="",
    branch="",
    base_ref="main",
    world_id="",
)

Stable entity identities produced by missions.submit.

Field	Type	Default
`mission_id`	`int`	`required`
`task_ids`	`tuple[tuple[str, int], ...]`	`required`
`episode_id`	`str`	`required`
`repository`	`str`	`''`
`branch`	`str`	`''`
`base_ref`	`str`	`'main'`
`world_id`	`str`	`''`

MissionRun `dataclass` ¶

MissionRun(
    run_id,
    principal,
    idempotency_key,
    request_digest,
    profile,
    status,
    submission,
    world_id="",
    mission_id=None,
    episode_id="",
    task_ids=(),
    active_operation="",
    cancellation_intent=False,
    cancellation_reason="",
    result=None,
    cleanup_state=NONE,
    accepted_at_ms=0,
    running_at_ms=None,
    terminal_at_ms=None,
    updated_at_ms=0,
    interrupted_reason="",
)

Durable asynchronous handle for one externally requested Agent Mission.

Field	Type	Default
`run_id`	`str`	`required`
`principal`	`str`	`required`
`idempotency_key`	`str`	`required`
`request_digest`	`str`	`required`
`profile`	`ExecutionProfileIdentity`	`required`
`status`	`MissionRunStatus`	`required`
`submission`	`MissionSubmission`	`required`
`world_id`	`str`	`''`
`mission_id`	`int \\| None`	`None`
`episode_id`	`str`	`''`
`task_ids`	`tuple[tuple[str, int], ...]`	`()`
`active_operation`	`str`	`''`
`cancellation_intent`	`bool`	`False`
`cancellation_reason`	`str`	`''`
`result`	`MissionResult \\| None`	`None`
`cleanup_state`	`MissionRunCleanupState`	`'none'`
`accepted_at_ms`	`int`	`0`
`running_at_ms`	`int \\| None`	`None`
`terminal_at_ms`	`int \\| None`	`None`
`updated_at_ms`	`int`	`0`
`interrupted_reason`	`str`	`''`

MissionResult `dataclass` ¶

MissionResult(
    mission_id,
    episode_id,
    status,
    repository,
    branch,
    ticks_completed,
    tasks,
    reason="",
)

Terminal mission projection.

Field	Type	Default
`mission_id`	`int`	`required`
`episode_id`	`str`	`required`
`status`	`str`	`required`
`repository`	`str`	`required`
`branch`	`str`	`required`
`ticks_completed`	`int`	`required`
`tasks`	`tuple[TaskResult, ...]`	`required`
`reason`	`str`	`''`

TaskResult `dataclass` ¶

TaskResult(
    task_id,
    name,
    status,
    dispatches,
    commit_shas,
    reason="",
)

Terminal task projection returned to mission authors.

Field	Type	Default
`task_id`	`int`	`required`
`name`	`str`	`required`
`status`	`str`	`required`
`dispatches`	`int`	`required`
`commit_shas`	`tuple[str, ...]`	`required`
`reason`	`str`	`''`

MissionsExtensionConfig `dataclass` ¶

MissionsExtensionConfig(*, execution_profiles=empty())

Bind server-owned mission profiles during the wiring transaction.

ExecutionProfile ¶

Canonical policy and provider identity for one immutable profile version.

canonical_payload `property` ¶

canonical_payload

Return the complete secret-free authority document.

ExecutionProfileBinding `dataclass` ¶

ExecutionProfileBinding(profile, config_factory)

Trusted process binding from canonical authority to live provider config.

build_config ¶

build_config()

Materialize live execution config and prove shared fields did not drift.

ExecutionProfileCatalog `dataclass` ¶

ExecutionProfileCatalog(
    bindings=(), *, current_versions=None
)

Immutable explicit-current catalog retaining every admitted profile version.

ExecutionProfileIdentity ¶

Durable identity copied into the authoritative MissionRun record.

MissionProfileRequest ¶

Client-owned coordinates evaluated against a selected server profile.

installed_execution_profiles ¶

installed_execution_profiles(installed)

Return the execution-profile catalog retained by the installed library.

installed is the value RuntimeResources.world_library("missions") resolves after composition: the Missions installer retains the validated MissionsExtensionConfig (or its typed empty default) on InstalledWorldLibrary.config, so profile authority flows through the existing world-library seam rather than a parallel service locator.

Agent Missions¶

Missions ¶

world_id property ¶

submit async ¶

accept async ¶

get_run async ¶

cancel_run async ¶

run async ¶

restore_sandbox async ¶

query async ¶

close async ¶

MissionWorld ¶

world property ¶

ingest_claude_transcript async ¶

transcript_rows async ¶

query_trajectory async ¶

grade_trajectory async ¶

AgentMissionConfig dataclass ¶

AgentTask dataclass ¶

CommandValidator dataclass ¶

CriticPolicy dataclass ¶