Models: E
from_: str(fromon the wire)to: strkind: Literal['caused-by', 'influenced-by', 'retrieved-from', 'invoked', 'produced', 'checked-against', 'waited-on', 'resumed-from']
EnvCollectionPage
Section titled “EnvCollectionPage”data: list[kindgi.client.EnvRecord]next_cursor: str | None(nextCursoron the wire) (optional)
EnvDeleteResult
Section titled “EnvDeleteResult”deleted: bool
EnvListPage
Section titled “EnvListPage”data: list[kindgi.client.EnvRecord]next_cursor: str | None(nextCursoron the wire) (optional)
EnvRecord
Section titled “EnvRecord”scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3env_name: str(envNameon the wire)name: strvalue: strrevision: intcreated_at: AwareDatetime(createdAton the wire)updated_at: AwareDatetime(updatedAton the wire)tags: dict[str, str] | None(optional)
EnvSetInput
Section titled “EnvSetInput”scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3env_name: str(envNameon the wire)name: strvalue: strtags: dict[str, str] | None(optional)if_revision: int | None(ifRevisionon the wire) (optional)
EnvSetOutcome
Section titled “EnvSetOutcome”root: kindgi.client.EnvSetOutcome1 | kindgi.client.EnvSetOutcome2 | kindgi.client.EnvSetOutcome3
EnvSetOutcome1
Section titled “EnvSetOutcome1”kind: Literal['ok']record: kindgi.client.EnvRecord
EnvSetOutcome2
Section titled “EnvSetOutcome2”kind: Literal['revision-conflict']current_revision: int(currentRevisionon the wire)
EnvSetOutcome3
Section titled “EnvSetOutcome3”kind: Literal['error']code: strmessage: str
EnvSetRequest
Section titled “EnvSetRequest”scope: kindgi.client.Scope1 | kindgi.client.Scope2 | kindgi.client.Scope3 | None(optional)env_name: str | None(envNameon the wire) (optional)name: str | None(optional)value: strtags: dict[str, str] | None(optional)if_revision: int | None(ifRevisionon the wire) (optional)
code: strmessage: strdetails: dict[str, Any] | None(optional)request_id: str(requestIdon the wire)
EvalRun
Section titled “EvalRun”run_id: uuid.UUID(runIdon the wire)tenant_id: uuid.UUID(tenantIdon the wire)suite_id: str(suiteIdon the wire)suite_version: str(suiteVersionon the wire)kind: Literal['accuracy', 'pairwise', 'regression', 'human-review', 'benchmark', 'custom']agent_ref: kindgi.client.EvalRunAgentRef | None(agentRefon the wire) (optional)flow_ref: kindgi.client.EvalRunFlowRef | None(flowRefon the wire) (optional)status: Literal['pending', 'running', 'completed', 'failed', 'cancelled']dry_run: bool(dryRunon the wire)started_at: AwareDatetime(startedAton the wire)completed_at: AwareDatetime | None(completedAton the wire) (optional)result: dict[str, Any] | None(optional)error: str | None(optional)correlation_id: str | None(correlationIdon the wire) (optional)
EvalRunAgentRef
Section titled “EvalRunAgentRef”agent_id: str(agentIdon the wire)version: str | None(optional)
EvalRunCollectionPage
Section titled “EvalRunCollectionPage”data: list[kindgi.client.EvalRun]next_cursor: str | None(nextCursoron the wire) (optional)has_more: bool(hasMoreon the wire)
EvalRunFlowRef
Section titled “EvalRunFlowRef”flow_id: str(flowIdon the wire)version: str | None(optional)
EvalRunStatus
Section titled “EvalRunStatus”root: Literal['pending', 'running', 'completed', 'failed', 'cancelled']
EvalSuite
Section titled “EvalSuite”id: strtenant_id: uuid.UUID(tenantIdon the wire)version: strkind: Literal['accuracy', 'pairwise', 'regression', 'human-review', 'benchmark', 'custom']description: str | None(optional)spec: dict[str, Any]
EvalSuiteCollectionPage
Section titled “EvalSuiteCollectionPage”data: list[kindgi.client.EvalSuite]next_cursor: str | None(nextCursoron the wire) (optional)has_more: bool(hasMoreon the wire)
EventTriggerCollectionPage
Section titled “EventTriggerCollectionPage”data: list[kindgi.client.EventTriggerRecord]next_cursor: str | None(nextCursoron the wire) (optional)has_more: bool(hasMoreon the wire)
EventTriggerRecord
Section titled “EventTriggerRecord”event_trigger_id: str(eventTriggerIdon the wire)trigger_id: str(triggerIdon the wire)flow_id: str(flowIdon the wire)flow_version: str(flowVersionon the wire)event_kind: str(eventKindon the wire)input: Any | None(optional)label: str | Nonestatus: Literal['active', 'paused']last_fired_at: AwareDatetime | None(lastFiredAton the wire)created_at: AwareDatetime(createdAton the wire)updated_at: AwareDatetime(updatedAton the wire)
EventTriggerUnregisterResult
Section titled “EventTriggerUnregisterResult”event_trigger_id: str(eventTriggerIdon the wire)unregistered: bool
EvidenceActor
Section titled “EvidenceActor”kind: Optional[Literal['user', 'agent', 'system', 'admin', 'external']](optional)id: str | None(optional)ip_address: str | None(ipAddresson the wire) (optional)user_agent: str | None(userAgenton the wire) (optional)
EvidenceKind
Section titled “EvidenceKind”root: str
EvidenceOutcome
Section titled “EvidenceOutcome”root: Literal['allowed', 'denied', 'succeeded', 'failed', 'escalated']
EvidenceProvenanceRef
Section titled “EvidenceProvenanceRef”run_id: str | None(runIdon the wire) (optional)node_id: str | None(nodeIdon the wire) (optional)record_id: str | None(recordIdon the wire) (optional)
EvidenceSignature
Section titled “EvidenceSignature”algorithm: Literal['ed25519']key_id: str(keyIdon the wire)value: strsigned_at: AwareDatetime(signedAton the wire)
EvidenceSubject
Section titled “EvidenceSubject”kind: str | None(optional)id: str | None(optional)
ExportAuditBundleBody
Section titled “ExportAuditBundleBody”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(signingKeyIdon the wire)include_messages: bool | None(includeMessageson the wire) (optional)
ExportAuditBundleResult
Section titled “ExportAuditBundleResult”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(approvalIdon the wire)bundle: strbundle_schema_version: int(bundleSchemaVersionon the wire)algorithm: Literal['ed25519']signing_key_id: str(signingKeyIdon the wire)signature: strpublic_key: str(publicKeyon the wire)canonicalization: Literal['sorted-key-json']exported_at: AwareDatetime(exportedAton the wire)
ExportComplianceEvidenceBody
Section titled “ExportComplianceEvidenceBody”signing_key_id: str(signingKeyIdon the wire)filter: kindgi.client.Filter | None(optional)
ExportComplianceEvidenceFilter
Section titled “ExportComplianceEvidenceFilter”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(runIdon the wire) (optional)agent_id: str | None(agentIdon the wire) (optional)flow_id: str | None(flowIdon the wire) (optional)kind: str | None(optional)from_: AwareDatetime | None(fromon the wire) (optional)to: AwareDatetime | None(optional)
ExportProvenanceBody
Section titled “ExportProvenanceBody”signing_key_id: str(signingKeyIdon the wire)include_messages: bool | None(includeMessageson the wire) (optional)
ExportProvenanceResult
Section titled “ExportProvenanceResult”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(runIdon the wire)bundle: strbundle_schema_version: str(bundleSchemaVersionon the wire)algorithm: Literal['ed25519']signing_key_id: str(signingKeyIdon the wire)signature: strpublic_key: str(publicKeyon the wire)canonicalization: Literal['sorted-key-json']exported_at: AwareDatetime(exportedAton the wire)