cayu agent

Generated from the released command parser. These commands show help only; operations run when you invoke the command without --help.

usage: cayu agent [-h] {bundle} ...

Manage portable Cayu agent representations.

positional arguments:
  {bundle}
    bundle    Inspect and convert AgentBundle representations.

options:
  -h, --help  show this help message and exit

cayu agent bundle

usage: cayu agent bundle [-h] {export,inspect,import,unpack,pack} ...

Inspect or convert the single-file .cayu transport and its canonical unpacked
AgentBundle directory.

positional arguments:
  {export,inspect,import,unpack,pack}
    export              Export an authorized durable snapshot as one .cayu
                        file.
    inspect             Validate and inspect one .cayu file.
    import              Validate, import, and pin a .cayu file into durable
                        stores.
    unpack              Unpack one .cayu file without changing bundle
                        identity.
    pack                Pack one canonical AgentBundle directory as .cayu.

options:
  -h, --help            show this help message and exit

cayu agent bundle export

usage: cayu agent bundle export [-h] --snapshot-store SNAPSHOT_STORE
                                --object-store OBJECT_STORE
                                --snapshot-root SNAPSHOT_ROOT
                                --binding-id BINDING_ID
                                --authority-scope-fingerprint AUTHORITY_SCOPE_FINGERPRINT
                                [--profile {reusable_agent,continuing_agent,evaluation_candidate}]
                                [--operation-id OPERATION_ID] --output OUTPUT

Export and protect an authorized snapshot from durable SQLite/CAS storage,
then publish one deterministic full .cayu file.

options:
  -h, --help            show this help message and exit
  --snapshot-store SNAPSHOT_STORE
                        Durable SQLite AgentSnapshot store.
  --object-store OBJECT_STORE
                        Durable filesystem AgentSnapshot object store.
  --snapshot-root SNAPSHOT_ROOT
                        Authorized snapshot root SHA-256.
  --binding-id BINDING_ID
                        Authorized binding SHA-256.
  --authority-scope-fingerprint AUTHORITY_SCOPE_FINGERPRINT
                        Authorized source scope SHA-256.
  --profile {reusable_agent,continuing_agent,evaluation_candidate}
                        Portable snapshot profile (default: reusable_agent).
  --operation-id OPERATION_ID
                        Stable retry identity; derived when omitted.
  --output OUTPUT       Destination .cayu file.

cayu agent bundle inspect

usage: cayu agent bundle inspect [-h] [--json] source

Validate every transferred entry in one .cayu file and report bounded safe
metadata before import or materialization.

positional arguments:
  source      Source .cayu file.

options:
  -h, --help  show this help message and exit
  --json      Emit canonical JSON metadata.

cayu agent bundle import

usage: cayu agent bundle import [-h] --snapshot-store SNAPSHOT_STORE
                                --object-store OBJECT_STORE --subject SUBJECT
                                --authority-scope-fingerprint AUTHORITY_SCOPE_FINGERPRINT
                                --owner OWNER
                                [--retention-class {transient,run_evidence,candidate,champion,release,legal_hold}]
                                [--operation-id OPERATION_ID]
                                source

Validate one .cayu file, import its exact closure into SQLite/CAS storage, and
atomically publish and pin the rebound snapshot root.

positional arguments:
  source                Source .cayu file.

options:
  -h, --help            show this help message and exit
  --snapshot-store SNAPSHOT_STORE
                        Durable SQLite AgentSnapshot store.
  --object-store OBJECT_STORE
                        Durable filesystem AgentSnapshot object store.
  --subject SUBJECT     Destination AgentSnapshotSubject JSON document.
  --authority-scope-fingerprint AUTHORITY_SCOPE_FINGERPRINT
                        Authorized destination scope SHA-256.
  --owner OWNER         Durable pin owner.
  --retention-class {transient,run_evidence,candidate,champion,release,legal_hold}
                        Durable pin retention class (default: release).
  --operation-id OPERATION_ID
                        Stable retry identity; derived when omitted.

cayu agent bundle unpack

usage: cayu agent bundle unpack [-h] --destination DESTINATION source

Validate and convert one .cayu file to its canonical directory for CAS,
debugging, or a later governed import.

positional arguments:
  source                Source .cayu file.

options:
  -h, --help            show this help message and exit
  --destination DESTINATION

cayu agent bundle pack

usage: cayu agent bundle pack [-h] --output OUTPUT source

Validate and convert one canonical AgentBundle directory into deterministic
.cayu bytes for copying or download.

positional arguments:
  source           Canonical unpacked AgentBundle directory.

options:
  -h, --help       show this help message and exit
  --output OUTPUT  Destination .cayu file.

Getting started · Operations · Configuration