OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

context.pack.snapshot

Create an immutable snapshot from a context pack.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: snapshot, create
  • File: packages/libs/contracts-spec/src/context/commands/contextPackSnapshot.command.ts
  • field.key.label
    context.pack.snapshot
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    context.pack.snapshot
    field.description.label

    Create an immutable snapshot from a context pack.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: snapshot, create
  • File: packages/libs/contracts-spec/src/context/commands/contextPackSnapshot.command.ts
  • field.tags.label
    snapshot,create
    field.owners.label
    field.stability.label

    Create an immutable snapshot from a context pack.

    Goal

    Persist a versioned, auditable context snapshot for agents.

    Context

    Used when launching background agents or when operators want to lock context state.

    Source Definition

    export const ContextPackSnapshotCommand = defineCommand({
      meta: {
        key: 'context.pack.snapshot',
        title: 'Create Context Snapshot',
        version: '1.0.0',
        description: 'Create an immutable snapshot from a context pack.',
        goal: 'Persist a versioned, auditable context snapshot for agents.',
        context:
          'Used when launching background agents or when operators want to lock context state.',
        domain: CONTEXT_DOMAIN,
        owners: CONTEXT_OWNERS,
        tags: [...CONTEXT_TAGS, 'snapshot', 'create'],
        stability: CONTEXT_STABILITY,
        docId: [docId('docs.tech.context.pack.snapshot')],
      },
      capability: {
        key: 'context.system',
        version: '1.0.0',
      },
      io: {
        input: ContextPackSnapshotInput,
        output: ContextPackSnapshotOutput,
      },
      policy: {
        auth: 'admin',
        pii: [],
      },
      sideEffects: {
        emits: [
          {
            ref: ContextSnapshotCreatedEvent.meta,
            when: 'A new snapshot has been created and persisted.',
          },
        ],
      },
    });