Skip to content

Models: E

  • from_: str (from on the wire)
  • to: str
  • kind: Literal['caused-by', 'influenced-by', 'retrieved-from', 'invoked', 'produced', 'checked-against', 'waited-on', 'resumed-from']
  • data: list[kindgi.client.EnvRecord]
  • next_cursor: str | None (nextCursor on the wire) (optional)
  • deleted: bool
  • data: list[kindgi.client.EnvRecord]
  • next_cursor: str | None (nextCursor on the wire) (optional)
  • scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3
  • env_name: str (envName on the wire)
  • name: str
  • value: str
  • revision: int
  • created_at: AwareDatetime (createdAt on the wire)
  • updated_at: AwareDatetime (updatedAt on the wire)
  • tags: dict[str, str] | None (optional)
  • scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3
  • env_name: str (envName on the wire)
  • name: str
  • value: str
  • tags: dict[str, str] | None (optional)
  • if_revision: int | None (ifRevision on the wire) (optional)
  • root: kindgi.client.EnvSetOutcome1 | kindgi.client.EnvSetOutcome2 | kindgi.client.EnvSetOutcome3
  • kind: Literal['ok']
  • record: kindgi.client.EnvRecord
  • kind: Literal['revision-conflict']
  • current_revision: int (currentRevision on the wire)
  • kind: Literal['error']
  • code: str
  • message: str
  • scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3 | None (optional)
  • env_name: str | None (envName on the wire) (optional)
  • name: str | None (optional)
  • value: str
  • tags: dict[str, str] | None (optional)
  • if_revision: int | None (ifRevision on the wire) (optional)
  • code: str
  • message: str
  • details: dict[str, Any] | None (optional)
  • request_id: str (requestId on the wire)
  • run_id: uuid.UUID (runId on the wire)
  • tenant_id: uuid.UUID (tenantId on the wire)
  • suite_id: str (suiteId on the wire)
  • suite_version: str (suiteVersion on the wire)
  • kind: Literal['accuracy', 'pairwise', 'regression', 'human-review', 'benchmark', 'custom']
  • agent_ref: kindgi.client.EvalRunAgentRef | None (agentRef on the wire) (optional)
  • flow_ref: kindgi.client.EvalRunFlowRef | None (flowRef on the wire) (optional)
  • status: Literal['pending', 'running', 'completed', 'failed', 'cancelled']
  • dry_run: bool (dryRun on the wire)
  • started_at: AwareDatetime (startedAt on the wire)
  • completed_at: AwareDatetime | None (completedAt on the wire) (optional)
  • result: dict[str, Any] | None (optional)
  • error: str | None (optional)
  • correlation_id: str | None (correlationId on the wire) (optional)
  • agent_id: str (agentId on the wire)
  • version: str | None (optional)
  • data: list[kindgi.client.EvalRun]
  • next_cursor: str | None (nextCursor on the wire) (optional)
  • has_more: bool (hasMore on the wire)
  • flow_id: str (flowId on the wire)
  • version: str | None (optional)
  • root: Literal['pending', 'running', 'completed', 'failed', 'cancelled']
  • id: str
  • tenant_id: uuid.UUID (tenantId on the wire)
  • version: str
  • kind: Literal['accuracy', 'pairwise', 'regression', 'human-review', 'benchmark', 'custom']
  • description: str | None (optional)
  • spec: dict[str, Any]
  • data: list[kindgi.client.EvalSuite]
  • next_cursor: str | None (nextCursor on the wire) (optional)
  • has_more: bool (hasMore on the wire)
  • data: list[kindgi.client.EventTriggerRecord]
  • next_cursor: str | None (nextCursor on the wire) (optional)
  • has_more: bool (hasMore on the wire)
  • event_trigger_id: str (eventTriggerId on the wire)
  • trigger_id: str (triggerId on the wire)
  • flow_id: str (flowId on the wire)
  • flow_version: str (flowVersion on the wire)
  • event_kind: str (eventKind on the wire)
  • input: Any | None (optional)
  • label: str | None
  • status: Literal['active', 'paused']
  • last_fired_at: AwareDatetime | None (lastFiredAt on the wire)
  • created_at: AwareDatetime (createdAt on the wire)
  • updated_at: AwareDatetime (updatedAt on the wire)
  • event_trigger_id: str (eventTriggerId on the wire)
  • unregistered: bool
  • kind: Optional[Literal['user', 'agent', 'system', 'admin', 'external']] (optional)
  • id: str | None (optional)
  • ip_address: str | None (ipAddress on the wire) (optional)
  • user_agent: str | None (userAgent on the wire) (optional)
  • root: str
  • root: Literal['allowed', 'denied', 'succeeded', 'failed', 'escalated']
  • run_id: str | None (runId on the wire) (optional)
  • node_id: str | None (nodeId on the wire) (optional)
  • record_id: str | None (recordId on the wire) (optional)
  • algorithm: Literal['ed25519']
  • key_id: str (keyId on the wire)
  • value: str
  • signed_at: AwareDatetime (signedAt on the wire)
  • kind: str | None (optional)
  • id: str | None (optional)

Body for POST /v1/approvals/{approvalId}/audit-bundle. signingKeyId selects the Ed25519 key from the deployment's signingKey binding. includeMessages optionally hydrates conversation messages tied to the approval's run.

  • signing_key_id: str (signingKeyId on the wire)
  • include_messages: bool | None (includeMessages on the wire) (optional)

Signed exportable audit bundle. Same envelope shape as ExportProvenanceResult — clients can reuse the same verifyEd25519 wrapper for both. bundle is base64 of the exact bytes that were signed (sorted-key canonical JSON, no whitespace). Bundle body: { bundleVersion, approvalId, tenantId, subjectKind, subjectRef, requiredRole, status, decision, decidedAt?, evidence: { guardrailResults?, messages? }, createdAt, exportedAt }.

  • approval_id: uuid.UUID (approvalId on the wire)
  • bundle: str
  • bundle_schema_version: int (bundleSchemaVersion on the wire)
  • algorithm: Literal['ed25519']
  • signing_key_id: str (signingKeyId on the wire)
  • signature: str
  • public_key: str (publicKey on the wire)
  • canonicalization: Literal['sorted-key-json']
  • exported_at: AwareDatetime (exportedAt on the wire)
  • signing_key_id: str (signingKeyId on the wire)
  • filter: kindgi.client.Filter | None (optional)

Optional filter narrowing the export set. Composition is AND — every populated field must match. Absent / empty filter exports every record for the tenant.

  • run_id: str | None (runId on the wire) (optional)
  • agent_id: str | None (agentId on the wire) (optional)
  • flow_id: str | None (flowId on the wire) (optional)
  • kind: str | None (optional)
  • from_: AwareDatetime | None (from on the wire) (optional)
  • to: AwareDatetime | None (optional)
  • signing_key_id: str (signingKeyId on the wire)
  • include_messages: bool | None (includeMessages on the wire) (optional)

Signed exportable bundle. bundle is base64 of the exact bytes that were signed (sorted-key canonical JSON, no whitespace); verifiers can pass those bytes directly to verifyEd25519. The bundle body itself includes bundleSchemaVersion, runId, tenantId, dag: { nodes, edges }, messages? (if requested), etc. See canonicalization for the deterministic serialization algorithm.

  • run_id: uuid.UUID (runId on the wire)
  • bundle: str
  • bundle_schema_version: str (bundleSchemaVersion on the wire)
  • algorithm: Literal['ed25519']
  • signing_key_id: str (signingKeyId on the wire)
  • signature: str
  • public_key: str (publicKey on the wire)
  • canonicalization: Literal['sorted-key-json']
  • exported_at: AwareDatetime (exportedAt on the wire)