@ai-matrx/records 0.20.0 → 0.24.0

package/dist/index.d.cts

@@ -4102,6 +4102,128 @@ interface DashboardRunResult {
     blocks: DashboardBlockResult[];
 }
 
+/** Where one agent-written value came from. Interned once per save (VAL-1). */
+interface EnrichSource {
+    kind?: string;
+    field_id?: Uuid;
+    model?: string;
+    model_version?: string | null;
+    instruction?: string;
+    /** What was actually read, with addresses. Never invented by the model. */
+    read?: Array<{
+        url?: string;
+        title?: string;
+        at?: string;
+    }>;
+    note?: string;
+    confidence?: number;
+    at?: string;
+}
+/** One candidate the model did not commit to, with its rank and its own source. */
+interface EnrichAlternate {
+    value: unknown;
+    rank: number;
+    source?: EnrichSource | null;
+}
+/** One cell, as `custom.enrich_cells` answers it. The badge is drawn from exactly this. */
+interface EnrichCell {
+    record_id: Uuid;
+    field_key: string;
+    /** Whether a model owns this column at all. False means: draw no badge. */
+    agent_owned: boolean;
+    value: unknown;
+    value_version: number | null;
+    /** `user`, `agent` or `system` — VAL-8's closed vocabulary. */
+    actor: string | null;
+    /** The person an agent acted for. Always set when `actor` is `agent`. */
+    on_behalf_of: string | null;
+    written_at: string | null;
+    source: EnrichSource | null;
+    /** One of: "never asked", "none", "refused", "conflicting" (VAL-2). */
+    absent_reason: string | null;
+    alternates: EnrichAlternate[] | null;
+    /** A person holds this cell against the model until they hand it back. */
+    pinned: boolean;
+    /** Past its freshness date. The value is still there — stale marks it, never erases it. */
+    stale: boolean;
+    due_at: string | null;
+}
+/** The enrichment itself, as it is stored on the Field. */
+interface Enrichment {
+    instruction: string;
+    inputs: string[];
+    web_search?: boolean;
+    connected_source?: string | null;
+    model: string;
+    confidence_floor: number;
+    write_policy: "auto" | "ask";
+    cost_cap_cents?: number;
+    review_interval_days?: number | null;
+    enabled: boolean;
+    enabled_by?: string | null;
+    enabled_at?: string | null;
+    declared_by?: string | null;
+    declared_at?: string | null;
+}
+/** One agent-owned column, with its freshness census and its money. */
+interface EnrichmentSummary {
+    field_id: Uuid;
+    table_id: Uuid;
+    field_key: string;
+    label: string;
+    enrichment: Enrichment;
+    enabled: boolean;
+    review_interval_days: number | null;
+    rows_total: number;
+    rows_filled: number;
+    rows_stale: number;
+    rows_pinned: number;
+    rows_absent: number;
+    runs: number;
+    cost_cents: number;
+    cost_per_row_cents: number | null;
+    last_run_at: string | null;
+    last_run: Record<string, unknown> | null;
+}
+/** One record that needs this column filled in, with what the instruction may read. */
+interface EnrichDueRow {
+    record_id: Uuid;
+    title: string;
+    inputs: Record<string, unknown>;
+    current_value: unknown;
+    written_at: string | null;
+    /** "never filled in", or "past its freshness date — written N days ago…". */
+    reason: string;
+    /** Set when the ask was larger than the organization's batch ceiling. */
+    trimmed_to: number | null;
+}
+/** What one run did, and what it cost. */
+interface EnrichRun {
+    run_id: Uuid;
+    field_id: Uuid | null;
+    field_key: string | null;
+    model: string | null;
+    trigger_word: string | null;
+    rows_seen: number;
+    rows_written: number;
+    rows_absent: number;
+    rows_below_floor: number;
+    rows_pinned: number;
+    rows_refused: number;
+    cost_cents: number;
+    cost_per_row_cents: number | null;
+    ran_at: string;
+}
+/** What `custom.enrich_declare` answers. `says` is a sentence for a person. */
+interface EnrichDeclared {
+    field_id: Uuid;
+    table_id: Uuid;
+    field_key: string;
+    label: string;
+    enrichment: Enrichment;
+    says: string;
+}
+
 /** VAL-8's whole vocabulary. There is no fourth word. */
 type HistoryActorKind = "user" | "agent" | "system";
 /**
@@ -4772,6 +4894,185 @@ interface WorkAssignment {
     message: string;
 }
 
+/** What a step asks for before it counts as done. Every one of these is CHECKED. */
+type ChecklistRequirementKind = 
+/** A person says it is done. */
+"none"
+/** A sentence of evidence, under `note`. */
+ | "note"
+/** A named value filled in on the step itself. */
+ | "answer"
+/** A named Field on the record the run is about must hold a value. */
+ | "record_field"
+/** The step IS a form (SCR-19): finishing it needs a response record. */
+ | "form"
+/** The step IS a document from a doc template (REC-68): finishing it needs a render. */
+ | "document";
+interface ChecklistRequirement {
+    kind: ChecklistRequirementKind;
+    /** For `answer` and `record_field`: which value. */
+    key?: string;
+    /** What a person is asked for, in their words. */
+    label?: string;
+    /** For `form`: the published form this step is. */
+    form_id?: Uuid;
+    /** For `document`: the doc template this step renders. */
+    template_id?: Uuid;
+}
+/** One step of a checklist, as it is WRITTEN — not as it is run. */
+interface ChecklistStepSpec {
+    /** The name the checklist refers to this step by; lower-case, unique. */
+    ref: string;
+    /** What a person reads in their work. */
+    title: string;
+    /** Which role owns it. A role the checklist never declares is refused at save. */
+    role?: string;
+    /** How many days after the run starts it is due. */
+    due_days?: number;
+    /** Steps it waits for. A step waits only for steps listed above it. */
+    depends_on?: string[];
+    requires?: ChecklistRequirement;
+}
+/** A role, and the person who stands in it by default. */
+interface ChecklistRoleSpec {
+    role: string;
+    label?: string;
+    user_id?: Uuid | null;
+}
+/** What starts a run. */
+type ChecklistTriggerKind = "manual" | "record_created" | "status_reached";
+interface ChecklistTrigger {
+    kind: ChecklistTriggerKind;
+    /** The Table being watched, for the two kinds that watch one. */
+    table_id?: Uuid;
+    /** The state, for `status_reached`. */
+    status?: string;
+}
+/** THE COMPLETE DECLARATIVE CHECKLIST — one object, one call, a whole process. */
+interface ChecklistSpec {
+    name: string;
+    /** The Table a run is ABOUT: People, Hires, Jobs, Matters. */
+    about_table_id: Uuid;
+    roles?: ChecklistRoleSpec[];
+    trigger?: ChecklistTrigger;
+    steps: ChecklistStepSpec[];
+}
+/** What `custom.checklist_declare` answers. */
+interface ChecklistDeclared {
+    template_id: Uuid;
+    name: string;
+    about_table_id: Uuid;
+    steps_table_id: Uuid;
+    steps: number;
+    roles: number;
+    trigger: ChecklistTrigger;
+    created: boolean;
+    message: string;
+    ms: number;
+}
+/** One row of `custom.checklist_templates`. */
+interface ChecklistTemplateSummary {
+    template_id: Uuid;
+    name: string;
+    about_table_id: Uuid | null;
+    about_table: string | null;
+    steps: number;
+    roles: number;
+    trigger_kind: ChecklistTriggerKind;
+    trigger_status: string | null;
+    open_runs: number;
+    total_runs: number;
+    updated_at: Timestamp;
+}
+/** `custom.checklist_template_shape` — the spec, plus what the editor needs. */
+type ChecklistTemplateShape = ChecklistSpec & {
+    template_id: Uuid;
+    steps_table_id: Uuid | null;
+    may_change: boolean;
+};
+/** What `custom.checklist_start` answers. */
+interface ChecklistRunStarted {
+    run_id: Uuid;
+    template_id: Uuid;
+    template: string;
+    about_record_id: Uuid | null;
+    about: string | null;
+    steps_table_id: Uuid;
+    steps_created: number;
+    assigned: number;
+    unassigned: number;
+    origin: string;
+    steps: Array<{
+        ref: string;
+        step_id: Uuid;
+        title: string;
+        role: string | null;
+    }>;
+    /** Roles nobody is named for, so the screen can say so rather than show blanks. */
+    waiting_on_a_name: string[];
+    message: string;
+    ms: number;
+}
+/** One step of a RUN, as `custom.checklist_run` answers it. */
+interface ChecklistRunStep {
+    step_id: Uuid;
+    step_order: number;
+    ref: string;
+    title: string;
+    role: string | null;
+    assignee_name: string | null;
+    assignee_user_id: Uuid | null;
+    due_on: Timestamp | null;
+    due_state: WorkDueState;
+    status: string | null;
+    finished: boolean;
+    requires: ChecklistRequirementKind;
+    /**
+     * The key the answer is filed under, as the checklist named it. A screen files
+     * evidence under THIS, never under a name it invented — the store looks for
+     * exactly this key and nothing else.
+     */
+    requires_key: string | null;
+    requires_label: string | null;
+    /** The form or the document template this step is, when it is one. */
+    requires_id: Uuid | null;
+    evidence: Record<string, unknown>;
+    /** The titles of the steps it is still waiting for. */
+    blocked_by: string[];
+    may_complete: boolean;
+    /** Why it cannot be finished right now, in the words a person would use. */
+    refusal: string | null;
+}
+/** One row of `custom.checklist_runs`. */
+interface ChecklistRunSummary {
+    run_id: Uuid;
+    name: string;
+    template_id: Uuid | null;
+    template: string | null;
+    about_record_id: Uuid | null;
+    about: string | null;
+    about_table_id: Uuid | null;
+    started_at: Timestamp | null;
+    started_by: Uuid | null;
+    origin: string;
+    step_count: number;
+    done: number;
+    overdue: number;
+    next_step: string | null;
+    next_due: Timestamp | null;
+    closed_at: Timestamp | null;
+}
+/** What `custom.checklist_step_complete` answers. */
+interface ChecklistStepCompleted {
+    step_id: Uuid;
+    run_id?: Uuid;
+    completed: boolean;
+    evidence?: Record<string, unknown>;
+    steps_left?: number;
+    run_closed?: boolean;
+    message: string;
+}
+
 /**
  * VIS-31. A signed-in OUTSIDER, with the reason in plain English.
  *
@@ -5199,4 +5500,4 @@ interface ConversationScopeContext {
 /** `About: Acme Industrial` — the chip a bound chat wears. */
 declare function scopeChip(scope: ConversationScope): string;
 
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChoiceOption, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldHistoryEntry, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordComment, type RecordDocument, type RecordHistoryEntry, type RecordRead, type RecordRevision, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RestorePreview, type RestoreResult, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip };
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceOption, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldHistoryEntry, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordComment, type RecordDocument, type RecordHistoryEntry, type RecordRead, type RecordRevision, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RestorePreview, type RestoreResult, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip };

package/dist/index.d.ts

@@ -4102,6 +4102,128 @@ interface DashboardRunResult {
     blocks: DashboardBlockResult[];
 }
 
+/** Where one agent-written value came from. Interned once per save (VAL-1). */
+interface EnrichSource {
+    kind?: string;
+    field_id?: Uuid;
+    model?: string;
+    model_version?: string | null;
+    instruction?: string;
+    /** What was actually read, with addresses. Never invented by the model. */
+    read?: Array<{
+        url?: string;
+        title?: string;
+        at?: string;
+    }>;
+    note?: string;
+    confidence?: number;
+    at?: string;
+}
+/** One candidate the model did not commit to, with its rank and its own source. */
+interface EnrichAlternate {
+    value: unknown;
+    rank: number;
+    source?: EnrichSource | null;
+}
+/** One cell, as `custom.enrich_cells` answers it. The badge is drawn from exactly this. */
+interface EnrichCell {
+    record_id: Uuid;
+    field_key: string;
+    /** Whether a model owns this column at all. False means: draw no badge. */
+    agent_owned: boolean;
+    value: unknown;
+    value_version: number | null;
+    /** `user`, `agent` or `system` — VAL-8's closed vocabulary. */
+    actor: string | null;
+    /** The person an agent acted for. Always set when `actor` is `agent`. */
+    on_behalf_of: string | null;
+    written_at: string | null;
+    source: EnrichSource | null;
+    /** One of: "never asked", "none", "refused", "conflicting" (VAL-2). */
+    absent_reason: string | null;
+    alternates: EnrichAlternate[] | null;
+    /** A person holds this cell against the model until they hand it back. */
+    pinned: boolean;
+    /** Past its freshness date. The value is still there — stale marks it, never erases it. */
+    stale: boolean;
+    due_at: string | null;
+}
+/** The enrichment itself, as it is stored on the Field. */
+interface Enrichment {
+    instruction: string;
+    inputs: string[];
+    web_search?: boolean;
+    connected_source?: string | null;
+    model: string;
+    confidence_floor: number;
+    write_policy: "auto" | "ask";
+    cost_cap_cents?: number;
+    review_interval_days?: number | null;
+    enabled: boolean;
+    enabled_by?: string | null;
+    enabled_at?: string | null;
+    declared_by?: string | null;
+    declared_at?: string | null;
+}
+/** One agent-owned column, with its freshness census and its money. */
+interface EnrichmentSummary {
+    field_id: Uuid;
+    table_id: Uuid;
+    field_key: string;
+    label: string;
+    enrichment: Enrichment;
+    enabled: boolean;
+    review_interval_days: number | null;
+    rows_total: number;
+    rows_filled: number;
+    rows_stale: number;
+    rows_pinned: number;
+    rows_absent: number;
+    runs: number;
+    cost_cents: number;
+    cost_per_row_cents: number | null;
+    last_run_at: string | null;
+    last_run: Record<string, unknown> | null;
+}
+/** One record that needs this column filled in, with what the instruction may read. */
+interface EnrichDueRow {
+    record_id: Uuid;
+    title: string;
+    inputs: Record<string, unknown>;
+    current_value: unknown;
+    written_at: string | null;
+    /** "never filled in", or "past its freshness date — written N days ago…". */
+    reason: string;
+    /** Set when the ask was larger than the organization's batch ceiling. */
+    trimmed_to: number | null;
+}
+/** What one run did, and what it cost. */
+interface EnrichRun {
+    run_id: Uuid;
+    field_id: Uuid | null;
+    field_key: string | null;
+    model: string | null;
+    trigger_word: string | null;
+    rows_seen: number;
+    rows_written: number;
+    rows_absent: number;
+    rows_below_floor: number;
+    rows_pinned: number;
+    rows_refused: number;
+    cost_cents: number;
+    cost_per_row_cents: number | null;
+    ran_at: string;
+}
+/** What `custom.enrich_declare` answers. `says` is a sentence for a person. */
+interface EnrichDeclared {
+    field_id: Uuid;
+    table_id: Uuid;
+    field_key: string;
+    label: string;
+    enrichment: Enrichment;
+    says: string;
+}
+
 /** VAL-8's whole vocabulary. There is no fourth word. */
 type HistoryActorKind = "user" | "agent" | "system";
 /**
@@ -4772,6 +4894,185 @@ interface WorkAssignment {
     message: string;
 }
 
+/** What a step asks for before it counts as done. Every one of these is CHECKED. */
+type ChecklistRequirementKind = 
+/** A person says it is done. */
+"none"
+/** A sentence of evidence, under `note`. */
+ | "note"
+/** A named value filled in on the step itself. */
+ | "answer"
+/** A named Field on the record the run is about must hold a value. */
+ | "record_field"
+/** The step IS a form (SCR-19): finishing it needs a response record. */
+ | "form"
+/** The step IS a document from a doc template (REC-68): finishing it needs a render. */
+ | "document";
+interface ChecklistRequirement {
+    kind: ChecklistRequirementKind;
+    /** For `answer` and `record_field`: which value. */
+    key?: string;
+    /** What a person is asked for, in their words. */
+    label?: string;
+    /** For `form`: the published form this step is. */
+    form_id?: Uuid;
+    /** For `document`: the doc template this step renders. */
+    template_id?: Uuid;
+}
+/** One step of a checklist, as it is WRITTEN — not as it is run. */
+interface ChecklistStepSpec {
+    /** The name the checklist refers to this step by; lower-case, unique. */
+    ref: string;
+    /** What a person reads in their work. */
+    title: string;
+    /** Which role owns it. A role the checklist never declares is refused at save. */
+    role?: string;
+    /** How many days after the run starts it is due. */
+    due_days?: number;
+    /** Steps it waits for. A step waits only for steps listed above it. */
+    depends_on?: string[];
+    requires?: ChecklistRequirement;
+}
+/** A role, and the person who stands in it by default. */
+interface ChecklistRoleSpec {
+    role: string;
+    label?: string;
+    user_id?: Uuid | null;
+}
+/** What starts a run. */
+type ChecklistTriggerKind = "manual" | "record_created" | "status_reached";
+interface ChecklistTrigger {
+    kind: ChecklistTriggerKind;
+    /** The Table being watched, for the two kinds that watch one. */
+    table_id?: Uuid;
+    /** The state, for `status_reached`. */
+    status?: string;
+}
+/** THE COMPLETE DECLARATIVE CHECKLIST — one object, one call, a whole process. */
+interface ChecklistSpec {
+    name: string;
+    /** The Table a run is ABOUT: People, Hires, Jobs, Matters. */
+    about_table_id: Uuid;
+    roles?: ChecklistRoleSpec[];
+    trigger?: ChecklistTrigger;
+    steps: ChecklistStepSpec[];
+}
+/** What `custom.checklist_declare` answers. */
+interface ChecklistDeclared {
+    template_id: Uuid;
+    name: string;
+    about_table_id: Uuid;
+    steps_table_id: Uuid;
+    steps: number;
+    roles: number;
+    trigger: ChecklistTrigger;
+    created: boolean;
+    message: string;
+    ms: number;
+}
+/** One row of `custom.checklist_templates`. */
+interface ChecklistTemplateSummary {
+    template_id: Uuid;
+    name: string;
+    about_table_id: Uuid | null;
+    about_table: string | null;
+    steps: number;
+    roles: number;
+    trigger_kind: ChecklistTriggerKind;
+    trigger_status: string | null;
+    open_runs: number;
+    total_runs: number;
+    updated_at: Timestamp;
+}
+/** `custom.checklist_template_shape` — the spec, plus what the editor needs. */
+type ChecklistTemplateShape = ChecklistSpec & {
+    template_id: Uuid;
+    steps_table_id: Uuid | null;
+    may_change: boolean;
+};
+/** What `custom.checklist_start` answers. */
+interface ChecklistRunStarted {
+    run_id: Uuid;
+    template_id: Uuid;
+    template: string;
+    about_record_id: Uuid | null;
+    about: string | null;
+    steps_table_id: Uuid;
+    steps_created: number;
+    assigned: number;
+    unassigned: number;
+    origin: string;
+    steps: Array<{
+        ref: string;
+        step_id: Uuid;
+        title: string;
+        role: string | null;
+    }>;
+    /** Roles nobody is named for, so the screen can say so rather than show blanks. */
+    waiting_on_a_name: string[];
+    message: string;
+    ms: number;
+}
+/** One step of a RUN, as `custom.checklist_run` answers it. */
+interface ChecklistRunStep {
+    step_id: Uuid;
+    step_order: number;
+    ref: string;
+    title: string;
+    role: string | null;
+    assignee_name: string | null;
+    assignee_user_id: Uuid | null;
+    due_on: Timestamp | null;
+    due_state: WorkDueState;
+    status: string | null;
+    finished: boolean;
+    requires: ChecklistRequirementKind;
+    /**
+     * The key the answer is filed under, as the checklist named it. A screen files
+     * evidence under THIS, never under a name it invented — the store looks for
+     * exactly this key and nothing else.
+     */
+    requires_key: string | null;
+    requires_label: string | null;
+    /** The form or the document template this step is, when it is one. */
+    requires_id: Uuid | null;
+    evidence: Record<string, unknown>;
+    /** The titles of the steps it is still waiting for. */
+    blocked_by: string[];
+    may_complete: boolean;
+    /** Why it cannot be finished right now, in the words a person would use. */
+    refusal: string | null;
+}
+/** One row of `custom.checklist_runs`. */
+interface ChecklistRunSummary {
+    run_id: Uuid;
+    name: string;
+    template_id: Uuid | null;
+    template: string | null;
+    about_record_id: Uuid | null;
+    about: string | null;
+    about_table_id: Uuid | null;
+    started_at: Timestamp | null;
+    started_by: Uuid | null;
+    origin: string;
+    step_count: number;
+    done: number;
+    overdue: number;
+    next_step: string | null;
+    next_due: Timestamp | null;
+    closed_at: Timestamp | null;
+}
+/** What `custom.checklist_step_complete` answers. */
+interface ChecklistStepCompleted {
+    step_id: Uuid;
+    run_id?: Uuid;
+    completed: boolean;
+    evidence?: Record<string, unknown>;
+    steps_left?: number;
+    run_closed?: boolean;
+    message: string;
+}
+
 /**
  * VIS-31. A signed-in OUTSIDER, with the reason in plain English.
  *
@@ -5199,4 +5500,4 @@ interface ConversationScopeContext {
 /** `About: Acme Industrial` — the chip a bound chat wears. */
 declare function scopeChip(scope: ConversationScope): string;
 
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChoiceOption, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldHistoryEntry, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordComment, type RecordDocument, type RecordHistoryEntry, type RecordRead, type RecordRevision, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RestorePreview, type RestoreResult, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip };
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, type AbsenceReason, type Actor, type AggregateBucket, type AggregateFilter, type AggregateMeasure, type AggregateOperation, type AggregateRow, type AggregateWindow, type AnonTokenBinding, COMPUTE_ON, CONTEXT_POLICIES, type ChecklistDeclared, type ChecklistRequirement, type ChecklistRequirementKind, type ChecklistRoleSpec, type ChecklistRunStarted, type ChecklistRunStep, type ChecklistRunSummary, type ChecklistSpec, type ChecklistStepCompleted, type ChecklistStepSpec, type ChecklistTemplateShape, type ChecklistTemplateSummary, type ChecklistTrigger, type ChecklistTriggerKind, type ChoiceOption, type CommentThreadRead, type CommentWritten, type ComputeOn, type ContextPolicy, type ConversationScope, type ConversationScopeContext, type CustomFieldTableType, DELIVERIES, type DashboardBlock, type DashboardBlockKind, type DashboardBlockResult, type DashboardRunResult, type DashboardSummary, type Delivery, type DocRenderRow, type DocSignatureCheck, type DocSignatureRow, type DocTemplateRow, type DocToken, type DocUnresolvedToken, ENTITY_TOKENS, type EnrichAlternate, type EnrichCell, type EnrichDeclared, type EnrichDueRow, type EnrichRun, type EnrichSource, type Enrichment, type EnrichmentSummary, type EntityFieldRights, type EntityFieldValue, type EntityRecordMatch, type EntityRecordRead, type EntityRecordsFound, type EntityTableFacts, type EntityToken, type ExternalPrincipalCard, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, type Field, type FieldBehavior, type FieldHistoryEntry, type FieldPatch, type FieldProposal, type FieldRule, type FieldSensitivity, type FieldSource, type FieldTypeWord, type ForbiddenEnvelopeWord, type FormSummary, type Freshness, type HiddenFieldNotice, type HistoryActor, type HistoryActorKind, type HistoryChange, type Home, type ImportBatchResult, type ImportColumnPlan, type ImportFinished, type ImportOpened, type ImportOutcome, type ImportPlan, type ImportPolicy, type ImportProposal, type ImportReport, type ImportRun, type InboundAddress, type InboundDeclared, KERNEL_TABLES, type KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, type MergeField, type MergeFieldModifier, type MergeFieldProvenance, type MergeFieldResolution, type MergeFieldSemanticType, type MergeFieldSource, type MergeFieldTransform, type MissingBehavior, type MyLevel, type MySubscription, type NewEntityFieldDeclaration, type NewFieldDeclaration, ON_DELETE, OVERRIDE_POLICIES, type OnDelete, type OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, type ParityFieldType, type ParityFieldTypeDescriptor, type PerValueAccessWord, type PermissionLevel, type PgError, type PortalCard, type PortalInvitation, type PortalPreviewRow, type PortalPrincipal, type PortalRevocation, type PortalSummary, type PortalTableExposure, type PredictedRefusal, type ProvenancePointer, type PublishBinding, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, type ReadRow, type ReadValue, type RecordComment, type RecordDocument, type RecordHistoryEntry, type RecordRead, type RecordRevision, type RecordScopeComment, type RecordScopeContext, type RecordScopeField, type RecordScopeHistoryEntry, type RecordScopeRelation, type RecordScopeWithheld, type RecordsActor, type RecordsConfig, type RecordsDataSource, type RecordsError, type RecordsErrorCode, type RecordsErrorSink, type RecordsFilter, type RecordsRealtimePort, type RecordsResolverPort, type RecordsResponse, type RecordsResult, type RecordsTableQuery, type RegisteredTable, type Relation, type RelationBinding, type RelationCardinality, type RelationCarries, type RelationCoordinate, type RelationFlavor, type RelationProperties, type RelationTarget, type ResolutionTriple, type ResolvedPublishBinding, type RestorePreview, type RestoreResult, type RetiredActorWord, type Rule, type RuleAnswer, type RuleExpression, type RuleNodeKind, type RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, type StaleWriteDetail, type StorageMode, type StoreDoorName, type StoreRefusalCode, type StoredRecord, type StuckRow, type Subscription, type SubscriptionBlock, type SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, type Table, type TableCapacity, type TableDisplay, type TableOrigin, type TableProposal, type TableType, type Timestamp, type Uuid, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, type ValueAlternate, type ValueAlternateKey, type ValueEnvelope, type ValueEnvelopeKey, type ValueSource, type WorkApprovalDecision, type WorkApprovalFiled, type WorkApprover, type WorkAssignment, type WorkAssignmentField, type WorkChange, type WorkDueState, type WorkGraph, type WorkInboxItem, type WorkInboxKind, type WorkInstantiation, type WorkListFlavour, type WorkListItem, type WorkOrigin, type WorkRecordState, type WorkSlotHold, type WorkState, type WorkTemplateNode, type WorkTemplateRelation, type WorkTurn, type WriteConflict, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip };