@ai-matrx/records 0.21.0 → 0.24.0

package/dist/core/index.d.cts

@@ -1,5 +1,5 @@
-import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.cjs';
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.cjs';
+import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, EnrichmentSummary, EnrichDeclared, EnrichDueRow, EnrichCell, EnrichRun, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.cjs';
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EnrichAlternate, EnrichSource, Enrichment, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.cjs';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:
@@ -450,6 +450,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;
@@ -1140,6 +1187,13 @@ declare const DOORS: {
     readonly dashboardRun: "dashboard_run";
     readonly dashboardStuck: "dashboard_stuck";
     readonly dashboardDelete: "dashboard_delete";
+    readonly enrichments: "enrichments";
+    readonly enrichDeclare: "enrich_declare";
+    readonly enrichDue: "enrich_due";
+    readonly enrichCells: "enrich_cells";
+    readonly enrichLand: "enrich_land";
+    readonly enrichPin: "enrich_pin";
+    readonly enrichRuns: "enrich_runs";
     readonly recordHistory: "record_history";
     readonly fieldHistory: "field_history";
     readonly restorePreview: "record_restore_preview";
@@ -1319,24 +1373,34 @@ declare function toAoa(fields: Field[], rows: ExportRow[]): string[][];
  * the same way, and for the same reason.
  */
 declare function exportXlsx(fields: Field[], rows: ExportRow[], sheetLabel?: string): Promise<Uint8Array>;
-/** A parsed import: the header row mapped onto field keys, and the rows. */
+/**
+ * A PARSED FILE, AND NOTHING ELSE: its headings, and every row keyed by them.
+ *
+ * 🚨 THERE IS NO `field`, NO `unmapped` AND NO WAY TO ASK FOR ONE, and that is
+ * the point. Until 2026-09-20 this parse ALSO decided which Field each heading
+ * meant — it took `fields`, matched each header by key or label, keyed the rows
+ * by whatever it matched, and **dropped every column it did not**. That cannot
+ * be the input to `custom.io_import_plan` / `custom.io_import_rows`, whose whole
+ * job is to decide the mapping and to OFFER what they could not match as a new
+ * column: the store can only offer a column whose values reached it.
+ *
+ * Measured by looking at the screen: every unmapped column's samples came back
+ * empty and its proposal read "every row in this column is empty, so there is
+ * nothing to go on" — for columns plainly full of values.
+ *
+ * The fix is the SHAPE, not a second field beside the first. These functions no
+ * longer take `fields`, so a parse cannot decide a mapping even by accident, and
+ * there is no safe path left beside the unsafe one.
+ */
 interface ParsedImport {
-    /** Header text -> the Field it matched, or null when nothing matched. */
-    columns: Array<{
-        header: string;
-        field: Field | null;
-    }>;
+    /** The file's own headings, in the file's own order and spelling. */
+    headers: string[];
+    /** Every row, keyed by heading. Every column is here; nothing is dropped. */
     rows: Array<Record<string, string>>;
-    /**
-     * DOOR-14 / AGT-N-7. Headers that matched no Field. They are NEVER dropped
-     * quietly: an unmapped key becomes a field proposal a person approves, and the
-     * import surface shows this list.
-     */
-    unmapped: string[];
 }
 /** RFC-4180 enough for what the canonical table writes, quotes and embedded newlines included. */
 declare function parseCsv(text: string): string[][];
-declare function importCsv(fields: Field[], text: string): ParsedImport;
-declare function importXlsx(fields: Field[], bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
+declare function importCsv(text: string): ParsedImport;
+declare function importXlsx(bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
 
-export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
+export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EnrichCell, EnrichDeclared, EnrichDueRow, EnrichRun, EnrichmentSummary, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
-import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.js';
-export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.js';
+import { Timestamp, Uuid, RelationCoordinate, RecordsConfig, RecordDocument, RecordsResult, RecordRead, ReadRow, Table, Field, StoredRecord, TableCapacity, NewFieldDeclaration, FieldPatch, EntityTableFacts, NewEntityFieldDeclaration, EntityFieldRights, EntityRecordRead, EntityRecordsFound, FormSummary, ImportPlan, ImportPolicy, ImportOpened, ImportBatchResult, ImportFinished, ImportReport, ImportRun, InboundDeclared, InboundAddress, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, EnrichmentSummary, EnrichDeclared, EnrichDueRow, EnrichCell, EnrichRun, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, ChecklistSpec, ChecklistDeclared, ChecklistTemplateSummary, ChecklistTemplateShape, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistStepCompleted, WorkState, WorkGraph, WorkInstantiation, WorkTurn, WorkAssignmentField, WorkSlotHold, WorkInboxItem, WorkListFlavour, WorkListItem, WorkAssignment, WorkRecordState, WorkApprover, WorkChange, WorkApprovalFiled, WorkApprovalDecision, ExternalPrincipalCard, PublishBinding, ResolvedPublishBinding, FieldProposal, TableProposal, MyLevel, RecordsError, WriteConflict, PgError, RecordsDataSource, StaleWriteDetail, PredictedRefusal } from '../index.js';
+export { ABSENCE_REASONS, ACTOR_VOCABULARY, AbsenceReason, Actor, AggregateOperation, AggregateWindow, COMPUTE_ON, CONTEXT_POLICIES, ChecklistRequirement, ChecklistRequirementKind, ChecklistRoleSpec, ChecklistStepSpec, ChecklistTrigger, ChecklistTriggerKind, ChoiceOption, ComputeOn, ContextPolicy, CustomFieldTableType, DELIVERIES, DashboardBlockKind, DashboardBlockResult, Delivery, DocSignatureCheck, ENTITY_TOKENS, EnrichAlternate, EnrichSource, Enrichment, EntityFieldValue, EntityRecordMatch, EntityToken, FIELD_SENSITIVITIES, FIELD_SOURCES, FRESHNESS, FieldBehavior, FieldRule, FieldSensitivity, FieldSource, FieldTypeWord, ForbiddenEnvelopeWord, Freshness, HiddenFieldNotice, HistoryActor, HistoryActorKind, HistoryChange, Home, ImportColumnPlan, ImportOutcome, ImportProposal, KERNEL_TABLES, KernelTableName, MERGE_FIELD_MODIFIERS, MERGE_FIELD_SEMANTIC_TYPES, MERGE_FIELD_SOURCES, MergeField, MergeFieldModifier, MergeFieldProvenance, MergeFieldResolution, MergeFieldSemanticType, MergeFieldSource, MergeFieldTransform, MissingBehavior, ON_DELETE, OVERRIDE_POLICIES, OnDelete, OverridePolicy, PARITY_FIELD_TYPES, PERMISSION_LEVELS, PER_VALUE_ACCESS_WORDS, ParityFieldType, ParityFieldTypeDescriptor, PerValueAccessWord, PermissionLevel, PortalPrincipal, PortalTableExposure, ProvenancePointer, RELATION_BINDINGS, RELATION_CARDINALITIES, RELATION_FLAVORS, RETIRED_ACTOR_WORDS, RULE_NODE_KINDS, RULE_USES, RecordComment, RecordScopeComment, RecordScopeField, RecordScopeHistoryEntry, RecordScopeRelation, RecordScopeWithheld, RecordsActor, RecordsErrorCode, RecordsErrorSink, RecordsFilter, RecordsRealtimePort, RecordsResolverPort, RecordsResponse, RecordsTableQuery, RegisteredTable, Relation, RelationBinding, RelationCardinality, RelationCarries, RelationFlavor, RelationProperties, RelationTarget, ResolutionTriple, RetiredActorWord, Rule, RuleAnswer, RuleExpression, RuleNodeKind, RuleUse, STORAGE_MODES, STORE_DOORS, STORE_KNOBS, STORE_REFUSAL_CODES, StorageMode, StoreDoorName, StoreRefusalCode, SubscriptionBlock, SubscriptionCadence, TABLE_DISPLAYS, TABLE_ORIGINS, TABLE_TYPES, TableDisplay, TableOrigin, TableType, VALUE_ALTERNATE_KEYS, VALUE_ENVELOPE_KEYS, ValueAlternate, ValueAlternateKey, ValueEnvelope, ValueEnvelopeKey, ValueSource, WorkDueState, WorkInboxKind, WorkOrigin, WorkTemplateNode, WorkTemplateRelation, asPermissionLevel, atLeast, choiceSlug, choiceValuesOf, choicesOf, err, highestLevel, holdsARetiredChoice, isRecordsErr, isTheChosen, looksLikeAnId, measureKey, ok, optionKey, optionLabel, portalPath, publicFormPath, scopeChip } from '../index.js';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:
@@ -450,6 +450,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;
@@ -1140,6 +1187,13 @@ declare const DOORS: {
     readonly dashboardRun: "dashboard_run";
     readonly dashboardStuck: "dashboard_stuck";
     readonly dashboardDelete: "dashboard_delete";
+    readonly enrichments: "enrichments";
+    readonly enrichDeclare: "enrich_declare";
+    readonly enrichDue: "enrich_due";
+    readonly enrichCells: "enrich_cells";
+    readonly enrichLand: "enrich_land";
+    readonly enrichPin: "enrich_pin";
+    readonly enrichRuns: "enrich_runs";
     readonly recordHistory: "record_history";
     readonly fieldHistory: "field_history";
     readonly restorePreview: "record_restore_preview";
@@ -1319,24 +1373,34 @@ declare function toAoa(fields: Field[], rows: ExportRow[]): string[][];
  * the same way, and for the same reason.
  */
 declare function exportXlsx(fields: Field[], rows: ExportRow[], sheetLabel?: string): Promise<Uint8Array>;
-/** A parsed import: the header row mapped onto field keys, and the rows. */
+/**
+ * A PARSED FILE, AND NOTHING ELSE: its headings, and every row keyed by them.
+ *
+ * 🚨 THERE IS NO `field`, NO `unmapped` AND NO WAY TO ASK FOR ONE, and that is
+ * the point. Until 2026-09-20 this parse ALSO decided which Field each heading
+ * meant — it took `fields`, matched each header by key or label, keyed the rows
+ * by whatever it matched, and **dropped every column it did not**. That cannot
+ * be the input to `custom.io_import_plan` / `custom.io_import_rows`, whose whole
+ * job is to decide the mapping and to OFFER what they could not match as a new
+ * column: the store can only offer a column whose values reached it.
+ *
+ * Measured by looking at the screen: every unmapped column's samples came back
+ * empty and its proposal read "every row in this column is empty, so there is
+ * nothing to go on" — for columns plainly full of values.
+ *
+ * The fix is the SHAPE, not a second field beside the first. These functions no
+ * longer take `fields`, so a parse cannot decide a mapping even by accident, and
+ * there is no safe path left beside the unsafe one.
+ */
 interface ParsedImport {
-    /** Header text -> the Field it matched, or null when nothing matched. */
-    columns: Array<{
-        header: string;
-        field: Field | null;
-    }>;
+    /** The file's own headings, in the file's own order and spelling. */
+    headers: string[];
+    /** Every row, keyed by heading. Every column is here; nothing is dropped. */
     rows: Array<Record<string, string>>;
-    /**
-     * DOOR-14 / AGT-N-7. Headers that matched no Field. They are NEVER dropped
-     * quietly: an unmapped key becomes a field proposal a person approves, and the
-     * import surface shows this list.
-     */
-    unmapped: string[];
 }
 /** RFC-4180 enough for what the canonical table writes, quotes and embedded newlines included. */
 declare function parseCsv(text: string): string[][];
-declare function importCsv(fields: Field[], text: string): ParsedImport;
-declare function importXlsx(fields: Field[], bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
+declare function importCsv(text: string): ParsedImport;
+declare function importXlsx(bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
 
-export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };
+export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, ChecklistDeclared, ChecklistRunStarted, ChecklistRunStep, ChecklistRunSummary, ChecklistSpec, ChecklistStepCompleted, ChecklistTemplateShape, ChecklistTemplateSummary, CommentThreadRead, CommentWritten, ConversationScope, ConversationScopeContext, DEFAULT_DOCUMENT_MAX_BYTES, DEFAULT_PAGE_SIZE, DEFAULT_VALUE_MAX_BYTES, DOORS, DashboardBlock, DashboardRunResult, DashboardSummary, DocRenderRow, DocSignatureRow, DocTemplateRow, DocToken, DocUnresolvedToken, type DoorKey, EnrichCell, EnrichDeclared, EnrichDueRow, EnrichRun, EnrichmentSummary, EntityFieldRights, EntityRecordRead, EntityRecordsFound, EntityTableFacts, type ExportRow, ExternalPrincipalCard, Field, FieldHistoryEntry, FieldPatch, FieldProposal, FormSummary, ImportBatchResult, ImportFinished, ImportOpened, ImportPlan, ImportPolicy, ImportReport, ImportRun, InboundAddress, InboundDeclared, MAPPED_SQLSTATES, type MirrorLimits, MyLevel, MySubscription, NewEntityFieldDeclaration, NewFieldDeclaration, type ParsedImport, PgError, PortalCard, PortalInvitation, PortalPreviewRow, PortalRevocation, PortalSummary, PredictedRefusal, type PromotedPredicate, PublishBinding, type QueryPlan, ReadRow, ReadValue, RecordDocument, RecordHistoryEntry, type RecordQuery, RecordRead, RecordRevision, RecordScopeContext, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, RestorePreview, RestoreResult, StaleWriteDetail, StoredRecord, StuckRow, Subscription, type SupabaseLike, Table, TableCapacity, TableProposal, Timestamp, Uuid, WorkApprovalDecision, WorkApprovalFiled, WorkApprover, WorkAssignment, WorkAssignmentField, WorkChange, WorkGraph, WorkInboxItem, WorkInstantiation, WorkListFlavour, WorkListItem, WorkRecordState, WorkSlotHold, WorkState, WorkTurn, WriteConflict, asWriteConflict, cellText, createRecordsClient, doorAbsent, doorCensus, doorExists, exportCsv, exportXlsx, importCsv, importXlsx, intersectIds, mapPgError, parseCsv, planQuery, predictEnvelopeRefusal, predictSizeRefusal, predictValueRefusals, predictWriteRefusals, staleWriteDetail, supabaseDataSource, toAoa };

package/dist/core/index.js

@@ -1973,6 +1973,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
@@ -2890,6 +2906,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,
@@ -4188,10 +4265,6 @@ async function exportXlsx(fields, rows, sheetLabel = "Records") {
   XLSX.utils.book_append_sheet(workbook, worksheet, name);
   return XLSX.write(workbook, { type: "array", bookType: "xlsx", compression: true });
 }
-function matchField(header, fields) {
-  const wanted = header.trim().toLowerCase();
-  return fields.find((f) => f.key.toLowerCase() === wanted) ?? fields.find((f) => (f.label ?? "").toLowerCase() === wanted) ?? null;
-}
 function parseCsv(text) {
   const rows = [];
   let row = [];
@@ -4226,32 +4299,31 @@ function parseCsv(text) {
   }
   return rows;
 }
-function importCsv(fields, text) {
-  return fromMatrix(fields, parseCsv(text));
+function importCsv(text) {
+  return fromMatrix(parseCsv(text));
 }
-async function importXlsx(fields, bytes) {
+async function importXlsx(bytes) {
   const XLSX = await import("xlsx");
   const workbook = XLSX.read(bytes, { type: "array" });
   const first = workbook.SheetNames[0];
-  if (!first) return { columns: [], rows: [], unmapped: [] };
+  if (!first) return { headers: [], rows: [] };
   const sheet = workbook.Sheets[first];
-  if (!sheet) return { columns: [], rows: [], unmapped: [] };
+  if (!sheet) return { headers: [], rows: [] };
   const matrix = XLSX.utils.sheet_to_json(sheet, { header: 1, raw: false, defval: "" });
-  return fromMatrix(fields, matrix);
+  return fromMatrix(matrix);
 }
-function fromMatrix(fields, matrix) {
+function fromMatrix(matrix) {
   const [header, ...body] = matrix;
-  if (!header) return { columns: [], rows: [], unmapped: [] };
-  const columns = header.map((text) => ({ header: text, field: matchField(text, fields) }));
-  const unmapped = columns.filter((c) => c.field === null).map((c) => c.header).filter((h) => h.trim().length > 0);
+  if (!header) return { headers: [], rows: [] };
+  const headers = header.map((text) => String(text ?? ""));
   const rows = body.filter((line) => line.some((cell) => String(cell ?? "").trim().length > 0)).map((line) => {
     const record = {};
-    columns.forEach((column, index) => {
-      if (column.field) record[column.field.key] = String(line[index] ?? "");
+    headers.forEach((heading, index) => {
+      if (heading.trim().length > 0) record[heading] = String(line[index] ?? "");
     });
     return record;
   });
-  return { columns, rows, unmapped };
+  return { headers, rows };
 }
 export {
   ABSENCE_REASONS,