@ai-matrx/records 0.21.0 → 0.24.0

package/dist/react/index.d.cts

@@ -4105,6 +4105,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";
 /**
@@ -5786,6 +5908,53 @@ interface RecordsClient {
         filter?: Record<string, AggregateFilter>;
         limit?: number;
     }): Promise<RecordsResult<StuckRow[]>>;
+    /** Every agent-owned column, with how many cells are filled, stale or pinned, and what it has cost. */
+    enrichments(args?: {
+        table_id?: Uuid | null;
+    }): Promise<RecordsResult<EnrichmentSummary[]>>;
+    /**
+     * Define, change or TURN ON an Enrichment on one Field. Admin on the Table.
+     * `{enabled: true}` on its own turns an existing one on without resetting it —
+     * and turning it on is what authorises every value it writes afterwards.
+     */
+    enrichDeclare(args: {
+        field_id: Uuid;
+        spec: Record<string, unknown>;
+    }): Promise<RecordsResult<EnrichDeclared>>;
+    /**
+     * The rows that need this column filled in, each with what the instruction may
+     * read. A cell somebody pinned is never returned. This is what a PREVIEW shows
+     * before anybody enables anything.
+     */
+    enrichDue(args: {
+        field_id: Uuid;
+        limit?: number;
+        include_fresh?: boolean;
+    }): Promise<RecordsResult<EnrichDueRow[]>>;
+    /**
+     * THE BADGE DATA FOR A WHOLE PAGE, in one call. Who wrote each value, when, out
+     * of what source, its candidates, whether a person pinned it and whether it is
+     * past its freshness date. Asked per cell this would be one round trip per badge.
+     */
+    enrichCells(args: {
+        table_id: Uuid;
+        field_keys?: string[] | null;
+        record_ids?: Uuid[] | null;
+    }): Promise<RecordsResult<EnrichCell[]>>;
+    /** Hold one cell against the model that fills its column, or hand it back. */
+    enrichPin(args: {
+        record_id: Uuid;
+        field_key: string;
+        pinned?: boolean;
+    }): Promise<RecordsResult<{
+        pinned: boolean;
+        says: string;
+    }>>;
+    /** What this column has cost, run by run. */
+    enrichRuns(args?: {
+        field_id?: Uuid | null;
+        limit?: number;
+    }): Promise<RecordsResult<EnrichRun[]>>;
     /** Take a dashboard away. The records it counted are untouched — a canvas owns nothing. */
     dashboardDelete(args: {
         dashboard_id: Uuid;
@@ -6584,4 +6753,4 @@ declare function useFieldMutation(): UseFieldMutation;
  */
 declare function useMergeField(key: string | null, state?: Record<string, unknown>): MergeFieldResolution | null;
 
-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 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, RecordsProvider, type RecordsProviderProps, 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 UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordsOptions, type UseRecordsState, 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, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordMutation, useRecords, useRecordsActor, useRecordsClient, useTable, useTables };
+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, RecordsProvider, type RecordsProviderProps, 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 UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordsOptions, type UseRecordsState, 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, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordMutation, useRecords, useRecordsActor, useRecordsClient, useTable, useTables };

package/dist/react/index.d.ts

@@ -4105,6 +4105,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";
 /**
@@ -5786,6 +5908,53 @@ interface RecordsClient {
         filter?: Record<string, AggregateFilter>;
         limit?: number;
     }): Promise<RecordsResult<StuckRow[]>>;
+    /** Every agent-owned column, with how many cells are filled, stale or pinned, and what it has cost. */
+    enrichments(args?: {
+        table_id?: Uuid | null;
+    }): Promise<RecordsResult<EnrichmentSummary[]>>;
+    /**
+     * Define, change or TURN ON an Enrichment on one Field. Admin on the Table.
+     * `{enabled: true}` on its own turns an existing one on without resetting it —
+     * and turning it on is what authorises every value it writes afterwards.
+     */
+    enrichDeclare(args: {
+        field_id: Uuid;
+        spec: Record<string, unknown>;
+    }): Promise<RecordsResult<EnrichDeclared>>;
+    /**
+     * The rows that need this column filled in, each with what the instruction may
+     * read. A cell somebody pinned is never returned. This is what a PREVIEW shows
+     * before anybody enables anything.
+     */
+    enrichDue(args: {
+        field_id: Uuid;
+        limit?: number;
+        include_fresh?: boolean;
+    }): Promise<RecordsResult<EnrichDueRow[]>>;
+    /**
+     * THE BADGE DATA FOR A WHOLE PAGE, in one call. Who wrote each value, when, out
+     * of what source, its candidates, whether a person pinned it and whether it is
+     * past its freshness date. Asked per cell this would be one round trip per badge.
+     */
+    enrichCells(args: {
+        table_id: Uuid;
+        field_keys?: string[] | null;
+        record_ids?: Uuid[] | null;
+    }): Promise<RecordsResult<EnrichCell[]>>;
+    /** Hold one cell against the model that fills its column, or hand it back. */
+    enrichPin(args: {
+        record_id: Uuid;
+        field_key: string;
+        pinned?: boolean;
+    }): Promise<RecordsResult<{
+        pinned: boolean;
+        says: string;
+    }>>;
+    /** What this column has cost, run by run. */
+    enrichRuns(args?: {
+        field_id?: Uuid | null;
+        limit?: number;
+    }): Promise<RecordsResult<EnrichRun[]>>;
     /** Take a dashboard away. The records it counted are untouched — a canvas owns nothing. */
     dashboardDelete(args: {
         dashboard_id: Uuid;
@@ -6584,4 +6753,4 @@ declare function useFieldMutation(): UseFieldMutation;
  */
 declare function useMergeField(key: string | null, state?: Record<string, unknown>): MergeFieldResolution | null;
 
-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 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, RecordsProvider, type RecordsProviderProps, 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 UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordsOptions, type UseRecordsState, 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, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordMutation, useRecords, useRecordsActor, useRecordsClient, useTable, useTables };
+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, RecordsProvider, type RecordsProviderProps, 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 UseEntityFieldMutation, type UseFieldMutation, type UseRecordMutation, type UseRecordsOptions, type UseRecordsState, 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, useEntityFieldMutation, useEntityFieldRights, useEntityFields, useEntityRecord, useEntityTable, useFieldMutation, useFields, useMergeField, useMyLevel, useMyLevels, useOptionalRecordsClient, useRecord, useRecordMutation, useRecords, useRecordsActor, useRecordsClient, useTable, useTables };

package/dist/react/index.js

@@ -1865,6 +1865,22 @@ var DOORS = {
   dashboardRun: "dashboard_run",
   dashboardStuck: "dashboard_stuck",
   dashboardDelete: "dashboard_delete",
+  // PRODUCTS row 10 — "fill in each company's industry and headcount, and keep
+  // it fresh". An Enrichment is not an object of its own: it is a Field saying
+  // `source = agent`, with its instruction, inputs, model, confidence floor and
+  // freshness in `source_config` (AGT-6). `enrichCells` is the one a GRID calls —
+  // the badge data for a whole page in one round trip, because a badge asked per
+  // cell is fifty round trips to draw fifty badges. `enrichPin` is the half of
+  // this product that decides whether anybody ever trusts it: the moment a
+  // person types over an agent-owned cell the store pins it, and the next run
+  // leaves it exactly as they left it.
+  enrichments: "enrichments",
+  enrichDeclare: "enrich_declare",
+  enrichDue: "enrich_due",
+  enrichCells: "enrich_cells",
+  enrichLand: "enrich_land",
+  enrichPin: "enrich_pin",
+  enrichRuns: "enrich_runs",
   // PRODUCTS row 4 — "Who changed this price, and can I put it back?" The
   // history has been in the store since W3-HIST; until 2026-09-20 the only way
   // to ask for it was `io_revisions`, which answers a raw uuid for the author
@@ -2774,6 +2790,67 @@ function createRecordsClient(config) {
         "ruleEval"
       );
     },
+    async enrichments(args) {
+      return callDoor(
+        DOORS.enrichments,
+        { p_organization_id: org, p_table_id: args?.table_id ?? null },
+        "enrichments"
+      );
+    },
+    async enrichDeclare(args) {
+      return callDoor(
+        DOORS.enrichDeclare,
+        { p_organization_id: org, p_field_id: args.field_id, p_spec: args.spec },
+        "enrichDeclare"
+      );
+    },
+    async enrichDue(args) {
+      return callDoor(
+        DOORS.enrichDue,
+        {
+          p_organization_id: org,
+          p_field_id: args.field_id,
+          p_limit: args.limit ?? 50,
+          p_include_fresh: args.include_fresh ?? false
+        },
+        "enrichDue"
+      );
+    },
+    async enrichCells(args) {
+      return callDoor(
+        DOORS.enrichCells,
+        {
+          p_organization_id: org,
+          p_table_id: args.table_id,
+          p_field_keys: args.field_keys ?? null,
+          p_record_ids: args.record_ids ?? null
+        },
+        "enrichCells"
+      );
+    },
+    async enrichPin(args) {
+      return callDoor(
+        DOORS.enrichPin,
+        {
+          p_organization_id: org,
+          p_record_id: args.record_id,
+          p_field_key: args.field_key,
+          p_pinned: args.pinned ?? true
+        },
+        "enrichPin"
+      );
+    },
+    async enrichRuns(args) {
+      return callDoor(
+        DOORS.enrichRuns,
+        {
+          p_organization_id: org,
+          p_field_id: args?.field_id ?? null,
+          p_limit: args?.limit ?? 50
+        },
+        "enrichRuns"
+      );
+    },
     async dashboards(args) {
       return callDoor(
         DOORS.dashboards,