Models: F

Fact

• id: str
• revision_id: str | None (revisionId on the wire) (optional)
• type: str
• scope: kindgi.client.FactScope
• version: int
• created_at: AwareDatetime (createdAt on the wire)
• updated_at: AwareDatetime | None (updatedAt on the wire) (optional)
• content: Any | None (optional)
• content_ref: str | None (contentRef on the wire) (optional)
• content_hash: str | None (contentHash on the wire) (optional)
• size: int | None (optional)
• embedding_model: str | None (embeddingModel on the wire) (optional)
• retention: kindgi.client.Retention | None (optional)
• source: kindgi.client.FactSource | None (optional)
• caused_by_log_id: list[str] | None (causedByLogId on the wire) (optional)
• supersedes: str | None (optional)
• trust: Optional[Annotated[Union[Literal['verified', 'asserted', 'unverified'], str], <kindgi.client._open.OpenEnum object at 0x10700bbd0>]] (optional)
• verified_by: str | None (verifiedBy on the wire) (optional)
• verified_at: AwareDatetime | None (verifiedAt on the wire) (optional)
• attributed_to: kindgi.client.FactAttribution | None (attributedTo on the wire) (optional)
• generated_by: kindgi.client.FactGeneratedBy | None (generatedBy on the wire) (optional)
• subjects: list[kindgi.client.FactSubject] | None (optional)
• valid_from: AwareDatetime | None (validFrom on the wire) (optional)
• valid_until: AwareDatetime | None (validUntil on the wire) (optional)
• observed_at: AwareDatetime | None (observedAt on the wire) (optional)
• invalidated_at: AwareDatetime | None (invalidatedAt on the wire) (optional)
• invalidated_by: str | None (invalidatedBy on the wire) (optional)
• invalidation_reason: Optional[Annotated[Union[Literal['superseded', 'deleted', 'erased', 'expired'], str], <kindgi.client._open.OpenEnum object at 0x10700bbd0>]] (invalidationReason on the wire) (optional)
• review: Optional[Annotated[Union[Literal['pending'], str], <kindgi.client._open.OpenEnum object at 0x10700bbd0>]] (optional)
• expires_at: AwareDatetime | None (expiresAt on the wire) (optional)

FactAttribution

Who asserted a fact, set by the server from the writer.

• kind: Union[Literal['user', 'service', 'agent'], str]
• id: str
• agent_version: str | None (agentVersion on the wire) (optional)

FactCollectionPage

• data: list[kindgi.client.Fact]
• next_cursor: str | None (nextCursor on the wire) (optional)
• has_more: bool (hasMore on the wire)

FactGeneratedBy

The run step that wrote a fact, for one an agent wrote.

• run_id: str (runId on the wire)
• step_id: str | None (stepId on the wire) (optional)
• tool_call_id: str | None (toolCallId on the wire) (optional)

FactRevisionList

• data: list[kindgi.client.Fact]

FactScope

Fact scope object. tenantId is required; every optional key narrows the fact (userId, orgId, projectId, threadId, sessionId, participantId). A fact is readable by whoever has every container it names. Additional keys accepted for forward compatibility.

• tenant_id: str (tenantId on the wire)
• user_id: str | None (userId on the wire) (optional)
• org_id: str | None (orgId on the wire) (optional)
• project_id: str | None (projectId on the wire) (optional)
• thread_id: str | None (threadId on the wire) (optional)
• session_id: str | None (sessionId on the wire) (optional)
• participant_id: str | None (participantId on the wire) (optional)

FactSource

• kind: Union[Literal['http-api', 'blob', 'mcp-tool', 'external-db', 'user-input'], str]
• uri: str | None (optional)
• freshness: kindgi.client.SourceFreshness
• refresh: kindgi.client.SourceRefresh

FactSubject

Whom a fact is about: what access and erasure requests by person find.

• kind: Union[Literal['participant', 'user', 'external'], str]
• id: str

FailureGroup

One group of failed runs: the same cause, subject and version.

• code: str | None (optional)
• reason: str | None (optional)
• subject: kindgi.client.FailureSubject
• version: str | None (optional)
• count: int
• first_seen: AwareDatetime (firstSeen on the wire)
• last_seen: AwareDatetime (lastSeen on the wire)
• example_run_id: uuid.UUID (exampleRunId on the wire)

FailureSubject

Whose runs a failure group counts: an agent's turns, or a flow's runs.

• kind: Union[Literal['agent', 'flow'], str]
• id: str

Filter

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)

FinishedRun

A finished top-level run: its identity and outcome, never its input or output. Field names match GET /v1/runs/{runId}.

• id: uuid.UUID
• project_id: uuid.UUID (projectId on the wire)
• flow_id: str (flowId on the wire)
• flow_version: str (flowVersion on the wire)
• status: Union[Literal['completed', 'failed', 'cancelled'], str]
• dry_run: bool (dryRun on the wire)
• failure_message: str | None (failureMessage on the wire)
• failure: kindgi.client.RunFailure | None (optional)
• created_at: AwareDatetime (createdAt on the wire)
• completed_at: AwareDatetime (completedAt on the wire)
• usage: kindgi.client.RunTreeUsage | None (optional)
• agent: kindgi.client.RunAgent | None (optional)

FirstAdmin

The person made the tenant's admin and member, by email: the runtime's own sign-in finds them. The runtime gives them every capability but secrets:reveal, to put on the keys they make. Absent: the answer carries an admin key instead, which takes the full system capability.

• email: str
• name: str

FirstAdmin1

• person_id: str (personId on the wire)

FixProposal

An improvement proposal: a change to one data block an agent version pins, for one live scope, taken through the same comparison, gate and promotion as any other version.

• id: uuid.UUID
• agent_id: str (agentId on the wire)
• from_version: str (fromVersion on the wire)
• scope: kindgi.client.LiveScopeTenant | kindgi.client.LiveScopeOrg | kindgi.client.LiveScopeProject | kindgi.client.LiveScopeSegment | kindgi.client.LiveScopeUnrecognized
• tier: Union[Literal['settings-block', 'prompt-block'], str]
• change: kindgi.client.ProposalChange
• hypothesis: str
• evidence: kindgi.client.Evidence1 | None (optional)
• drafter: kindgi.client.ProposalDrafter
• status: Union[Literal['draft', 'evaluating', 'evaluated', 'not-better', 'evaluation-failed', 'in-review', 'promoted', 'refused', 'rejected', 'expired', 'superseded', 'rolled-back', 'withdrawn'], str]
• candidate: kindgi.client.ProposalCandidate | None (optional)
• evaluation: kindgi.client.ProposalEvaluation | None (optional)
• promotion: kindgi.client.ProposalPromotion | None (optional)
• rolled_back: kindgi.client.RolledBack | None (rolledBack on the wire) (optional)
• withdrawn: kindgi.client.Withdrawn | None (optional)
• created_at: AwareDatetime (createdAt on the wire)
• updated_at: AwareDatetime (updatedAt on the wire)

FixProposalCollectionPage

• data: list[kindgi.client.FixProposal]
• has_more: bool (hasMore on the wire)
• next_cursor: str | None (nextCursor on the wire) (optional)

Flow

• id: str
• version: str
• project_id: uuid.UUID | None (projectId on the wire) (optional)
• name: str | None (optional)
• description: str | None (optional)
• nodes: list[kindgi.client.FlowNode]
• edges: list[kindgi.client.FlowEdge]
• max_parallelism: int | None (maxParallelism on the wire) (optional)
• metadata: dict[str, Any] | None (optional)
• pins: kindgi.client.FlowPins | None (optional)
• pins_digest: str | None (pinsDigest on the wire) (optional)
• derived_from: kindgi.client.VersionDerivation | None (derivedFrom on the wire) (optional)
• unregistered_at: AwareDatetime | None (unregisteredAt on the wire) (optional)

FlowCollectionPage

• data: list[kindgi.client.Flow]
• next_cursor: str | None (nextCursor on the wire) (optional)
• has_more: bool (hasMore on the wire)

FlowEdge

• id: str
• from_: str (from on the wire)
• to: str
• when: dict[str, Any] | None (optional)
• policy: dict[str, Any] | None (optional)

FlowId

• root: str

FlowNode

• id: str
• kind: Union[Literal['tool', 'agent', 'loop', 'fanout', 'subgraph'], str]
• ref: str | None (optional)
• config: dict[str, Any] | None (optional)

FlowPins

The exact tool and agent versions a flow version runs: its lockfile. Set by the runtime when the version is published, never in the publish body: each tool the flow runs, and each agent it runs at no named version, resolves once to its latest version then, which every run of that flow version uses. Absent on a version published before pins existed (it binds the latest versions per run).

• tools: dict[str, str]
• agents: dict[str, str]

FlowRef

• id: str
• version: str

FlowVersionOverrides

Agents and tools a flow runs at other exact versions than the flow version's pins ("this flow, with acme.scorer at 0.4.0"), without publishing a new flow version: a comparison's flow candidate (versions on the start body and the run's comparison), and the flow runs that replay it (a run's versions). Each id must be an agent or tool the flow uses.

• tools: dict[str, str] | None (optional)
• agents: dict[str, str] | None (optional)

Fresh

The part of these sums judged on this output itself (a replay judged after it ran). Absent when none was.

• yes_weight: float (yesWeight on the wire)
• total_weight: float (totalWeight on the wire)
• items: int