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 0x107dd6b90>]] (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 0x107dd6b90>]] (invalidationReason on the wire) (optional)
• review: Optional[Annotated[Union[Literal['pending'], str], <kindgi.client._open.OpenEnum object at 0x107dd6b90>]] (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

FileValue

A stored file as a value: in a run's input, a tool's result or a conversation message. Only artifactId is trusted: the runtime shows a model a file by its own checked record of it, never by the value's other fields. A message's files are the ones its run admitted, with the record's fields.

• type: Literal['kindgi.file']
• artifact_id: str (artifactId on the wire)
• name: str | None (optional)
• content_type: str (contentType on the wire)
• size: int
• sha256: str
• pages: int | None (optional)
• not_shown: Optional[Annotated[Union[Literal['type', 'size', 'model', 'limit', 'store', 'gone', 'changed', 'refused', 'storage', 'reading'], str], <kindgi.client._open.OpenEnum object at 0x107dd6b90>]] (notShown on the wire) (optional)

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)

FinishConnectBody

What the app sent back to the callback page, each as a string. Only whoever started the request may finish it.

• state: str
• code: str | None (optional)
• installation_id: str | None (installationId on the wire) (optional)
• setup_action: str | None (setupAction on the wire) (optional)
• error: str | None (optional)
• error_description: str | None (errorDescription on the wire) (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)

Fix

For a missing item: where it's fixed (repo: in the agent's code, then a deploy; kindgi: in Kindgi) and how, in plain words.

• where: Union[Literal['repo', 'kindgi'], str]
• text: str

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 resolves once to its version pinned where the flow version is made (the project, then its org, then the tenant), else to its latest version then; each agent it runs at no named version resolves once to its version pinned for that project, else its latest. Every run of that flow version uses them, except that an agent step in a run whose segment path one of that agent's release gates set on a segment covers runs the agent's version pinned for that segment. Absent on a version published before pins existed: each run of it binds each tool's latest version, and each agent's version pinned for the run, else its latest.

• 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 corrected on this output itself (a replay corrected after it ran). Absent when none was.

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