Models: F

Fact

• id: str
• 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)

FactCollectionPage

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

FactScope

Fact scope object. tenantId is required; every optional key narrows the fact (userId, orgId, projectId, threadId, sessionId). 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)

FactSource

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

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: Literal['completed', 'failed', 'cancelled']
• dry_run: bool (dryRun on the wire)
• failure_message: str | None (failureMessage on the wire)
• created_at: AwareDatetime (createdAt on the wire)
• completed_at: AwareDatetime (completedAt on the wire)

FixProposal

• id: uuid.UUID
• tenant_id: uuid.UUID (tenantId on the wire)
• supervisor_id: str (supervisorId on the wire)
• agent_id: str (agentId on the wire)
• agent_version: str (agentVersion on the wire)
• tier: Literal['prompt', 'retrieval', 'tool-config']
• change: dict[str, Any]
• pattern_refs: list[kindgi.client.PatternRef] (patternRefs on the wire)
• hypothesis: str
• proposer_rule_id: str (proposerRuleId on the wire)
• status: Literal['draft', 'dry-running', 'dry-run-passed', 'dry-run-failed', 'proposed-for-review', 'approved', 'rejected', 'applied', 'rolled-back', 'withdrawn']
• fingerprint: str
• resolution_reason: str | None (resolutionReason on the wire) (optional)
• review_approval_id: uuid.UUID | None (reviewApprovalId on the wire) (optional)
• applied_version: str | None (appliedVersion on the wire) (optional)
• applied_at: AwareDatetime | None (appliedAt on the wire) (optional)
• rolled_back_at: AwareDatetime | None (rolledBackAt on the wire) (optional)
• created_at: AwareDatetime (createdAt on the wire)
• updated_at: AwareDatetime (updatedAt on the wire)
• resolved_at: AwareDatetime | None (resolvedAt on the wire) (optional)

FixProposalCollectionPage

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

FixProposalStatus

• root: Literal['draft', 'dry-running', 'dry-run-passed', 'dry-run-failed', 'proposed-for-review', 'approved', 'rejected', 'applied', 'rolled-back', 'withdrawn']

Flow

• id: str
• version: str
• 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)

Flow1

• id: str
• version: str | None (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: Literal['tool', 'agent', 'loop', 'fanout', 'subgraph']
• ref: str | None (optional)
• config: dict[str, Any] | None (optional)

FlowRef

• id: str
• version: str