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.

controlPlane.trace.get

Return the replayable trace timeline for one execution.

  • Type: operation (query)
  • Version: 1.0.0
  • Tags: trace, audit
  • File: packages/libs/contracts-spec/src/control-plane/queries/controlPlaneTraceGet.query.ts
  • field.key.label
    controlPlane.trace.get
    field.version.label
    1.0.0
    field.type.label
    operation (query)
    field.title.label
    controlPlane.trace.get
    field.description.label

    Return the replayable trace timeline for one execution.

  • Type: operation (query)
  • Version: 1.0.0
  • Tags: trace, audit
  • File: packages/libs/contracts-spec/src/control-plane/queries/controlPlaneTraceGet.query.ts
  • field.tags.label
    trace,audit
    field.owners.label
    field.stability.label

    Return the replayable trace timeline for one execution.

    Goal

    Support audits, debugging, and deterministic replay.

    Context

    Used by operator surfaces when inspecting policy and tool execution history.

    Source Definition

    export const ControlPlaneTraceGetQuery = defineQuery({
      meta: {
        key: 'controlPlane.trace.get',
        title: 'Get Execution Trace',
        version: '1.0.0',
        description: 'Return the replayable trace timeline for one execution.',
        goal: 'Support audits, debugging, and deterministic replay.',
        context:
          'Used by operator surfaces when inspecting policy and tool execution history.',
        domain: CONTROL_PLANE_DOMAIN,
        owners: CONTROL_PLANE_OWNERS,
        tags: [...CONTROL_PLANE_TAGS, 'trace', 'audit'],
        stability: CONTROL_PLANE_STABILITY,
      },
      capability: {
        key: 'control-plane.audit',
        version: '1.0.0',
      },
      io: {
        input: ControlPlaneTraceGetInput,
        output: ControlPlaneTraceGetOutput,
      },
      policy: {
        auth: 'admin',
        pii: [],
      },
    });