@ai-matrx/records 0.17.0 → 0.20.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, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, ReadValue, AnonTokenBinding, 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, 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, Home, 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, 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 } 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, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, 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, 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';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:
@@ -272,6 +272,95 @@ interface RecordsClient {
         form_id?: Uuid | null;
         slug?: string | null;
     }): Promise<RecordsResult<Uuid>>;
+    /**
+     * What the store makes of a file's columns, before anything is written.
+     * `columns` is `[{header, samples}]` — the first page of the file is plenty.
+     */
+    importPlan(args: {
+        table_id: Uuid;
+        columns: Array<{
+            header: string;
+            samples: unknown[];
+        }>;
+    }): Promise<RecordsResult<ImportPlan>>;
+    /**
+     * Open a run. `file_hash` is the run's IDENTITY: the same bytes into the same
+     * table a second time answer the FIRST run with `already: true` and write
+     * nothing, so a re-import doubles nothing. `force` re-opens deliberately.
+     */
+    importBegin(args: {
+        table_id: Uuid;
+        format?: "csv" | "xlsx";
+        source_name?: string | null;
+        source_columns?: unknown[];
+        file_hash?: string | null;
+        policy?: ImportPolicy;
+        /** A Field key. A row whose value for it is already here is a duplicate. */
+        dedupe_key?: string | null;
+        file_bytes?: number | null;
+        force?: boolean;
+    }): Promise<RecordsResult<ImportOpened>>;
+    /**
+     * One BATCH of rows. Every row is written through the ONE write door inside
+     * its own subtransaction, so a refused row leaves nothing behind and never
+     * costs the rows before it. Send a few hundred at a time.
+     */
+    importRows(args: {
+        import_id: Uuid;
+        rows: Array<Record<string, unknown>>;
+        /** Header -> Field key. A header that already spells a key needs no entry. */
+        mapping?: Record<string, string>;
+    }): Promise<RecordsResult<ImportBatchResult>>;
+    /**
+     * Close the run and decide the columns the file had and the table did not:
+     * `propose` (the ONE approvals inbox, and the only choice a non-admin has),
+     * `create` (an admin adds them outright) or `ignore`.
+     */
+    importFinish(args: {
+        import_id: Uuid;
+        unmapped?: "propose" | "create" | "ignore";
+    }): Promise<RecordsResult<ImportFinished>>;
+    /** The refused rows, or the ones already here, WITH the source row on each. */
+    importReport(args: {
+        import_id: Uuid;
+        state?: "refused" | "duplicate";
+        limit?: number;
+        offset?: number;
+    }): Promise<RecordsResult<ImportReport>>;
+    /** This organization's import runs, newest first. How you find yesterday's. */
+    imports(args?: {
+        table_id?: Uuid | null;
+        limit?: number;
+    }): Promise<RecordsResult<ImportRun[]>>;
+    /**
+     * Forget the RECEIPT for a file so the same bytes can be imported again
+     * deliberately. Never touches the records that import wrote.
+     */
+    importForget(args: {
+        import_id: Uuid;
+    }): Promise<RecordsResult<boolean>>;
+    /**
+     * Give a table its own address. The answer carries `mail_route`: the one
+     * sentence saying what has to exist in DNS before anything arrives. Show it
+     * wherever the address is shown — an address that silently swallows mail is
+     * the failure this whole door is against.
+     */
+    inboundDeclare(args: {
+        table_id: Uuid;
+        label?: string | null;
+    }): Promise<RecordsResult<InboundDeclared>>;
+    inboundAddresses(args?: {
+        table_id?: Uuid | null;
+    }): Promise<RecordsResult<InboundAddress[]>>;
+    inboundSet(args: {
+        inbound_id: Uuid;
+        enabled: boolean;
+    }): Promise<RecordsResult<{
+        inbound_id: Uuid;
+        address: string;
+        enabled: boolean;
+        message: string;
+    }>>;
     /** Every portal over this organization the caller may know about, with its numbers. */
     portals(): Promise<RecordsResult<PortalSummary[]>>;
     /** ONE portal in full: what it shows, and who it was opened to. */
@@ -496,6 +585,115 @@ interface RecordsClient {
     revisions(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<RecordRevision[]>>;
+    /**
+     * PRODUCTS row 4. One record's version list, newest first: who (a person, or
+     * an agent AND the person it acted for), when, the operation in the word
+     * somebody used, and every field that moved with its before, its after, the
+     * Rule version that produced a derived value and its source pointer. Viewer
+     * on the record — reading how something got to be the way it is is reading.
+     */
+    recordHistory(args: {
+        record_id: Uuid;
+        limit?: number;
+        offset?: number;
+    }): Promise<RecordsResult<RecordHistoryEntry[]>>;
+    /**
+     * AGT-N-9 — EVERYTHING A CHAT OPENED ON THIS RECORD MAY KNOW, IN ONE ROUND TRIP.
+     *
+     * The Fields with their `(record, field, value version)` triples, the relations one hop
+     * out, the history, the comments and the Table's other records — assembled INSIDE the
+     * database, every piece through the read door, under this person's own field-level
+     * security. A Field the store masks comes back in `withheld` with the store's own
+     * sentence and no value; a Field the organization keeps out of conversations comes back
+     * there too, saying which of the two it is.
+     */
+    recordScopeContext(args: {
+        record_id: Uuid;
+        relations?: number;
+        history?: number;
+        siblings?: number;
+    }): Promise<RecordsResult<RecordScopeContext>>;
+    /** What is this conversation about? */
+    conversationScope(args: {
+        conversation_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** Point a conversation at one record. Refused unless this person may open it. */
+    conversationScopeBind(args: {
+        conversation_id: Uuid;
+        record_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** This conversation is no longer about a particular record. */
+    conversationScopeUnbind(args: {
+        conversation_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** The binding AND the context of a bound conversation, in one round trip. */
+    conversationScopeContext(args: {
+        conversation_id: Uuid;
+        relations?: number;
+        history?: number;
+        siblings?: number;
+    }): Promise<RecordsResult<ConversationScopeContext>>;
+    /**
+     * "Who changed the price on ANY record?" One column's history across a whole
+     * Table, narrowed to the records this person may see by a predicate in the
+     * same statement. A column that names no Field is refused BY NAME, never
+     * answered empty.
+     */
+    fieldHistory(args: {
+        table_id: Uuid;
+        field_key: string;
+        limit?: number;
+        offset?: number;
+        record_id?: Uuid;
+    }): Promise<RecordsResult<FieldHistoryEntry[]>>;
+    /**
+     * WHAT A RESTORE WOULD CHANGE, BEFORE IT DOES. Editor on the record: this is
+     * the first half of an act, and somebody who may not perform it is not shown
+     * its preview. Pass `field_key` for one column.
+     */
+    restorePreview(args: {
+        record_id: Uuid;
+        version: number;
+        field_key?: string;
+    }): Promise<RecordsResult<RestorePreview>>;
+    /** Put the whole record back to a version, as a NEW version. Editor. */
+    restoreVersion(args: {
+        record_id: Uuid;
+        version: number;
+    }): Promise<RecordsResult<RestoreResult>>;
+    /** Put ONE column back to what it said at a version, as a NEW version (HIS-N-2). Editor. */
+    valueRestore(args: {
+        record_id: Uuid;
+        field_key: string;
+        version: number;
+    }): Promise<RecordsResult<RestoreResult>>;
+    /**
+     * SCR-18. The record's comment thread with everybody named, plus what THIS
+     * person may do in it — decided by the store, in the same call, so a screen
+     * never draws a composer the write door will refuse.
+     */
+    commentThread(args: {
+        record_id: Uuid;
+        include_resolved?: boolean;
+    }): Promise<RecordsResult<CommentThreadRead>>;
+    /**
+     * Write a comment at the `commenter` rung, optionally naming people. A
+     * mention is a reference and not a regex over the body: the ids come from the
+     * picker and the store refuses one who is not in the organization, or who
+     * cannot open the record — because that notification would be a dead end.
+     */
+    commentWrite(args: {
+        record_id: Uuid;
+        body: string;
+        field_key?: string;
+        parent_comment_id?: Uuid;
+        mentions?: Uuid[];
+    }): Promise<RecordsResult<CommentWritten>>;
+    /** Resolve (or re-open) a thread. `commenter` — resolution is not a delete. */
+    commentResolve(args: {
+        comment_id: Uuid;
+        resolved?: boolean;
+    }): Promise<RecordsResult<boolean>>;
     /**
      * Every value of one record WITH its envelope — its own version, who wrote
      * it, who they were acting for and when. The timeline IS the record (REC-19);
@@ -859,6 +1057,17 @@ declare const DOORS: {
     readonly ruleEval: "rule_eval";
     readonly forms: "forms";
     readonly formDeclare: "form_declare";
+    readonly importPlan: "io_import_plan";
+    readonly importBegin: "io_import_begin";
+    readonly importRows: "io_import_rows";
+    readonly importFinish: "io_import_finish";
+    readonly importReport: "io_import_report";
+    readonly imports: "io_imports";
+    readonly importForget: "io_import_forget";
+    readonly inferColumn: "io_infer_column";
+    readonly inboundDeclare: "inbound_declare";
+    readonly inboundAddresses: "inbound_addresses";
+    readonly inboundSet: "inbound_set";
     readonly portals: "portals";
     readonly portalCard: "portal_card";
     readonly portalDeclare: "portal_declare";
@@ -870,6 +1079,19 @@ declare const DOORS: {
     readonly dashboardRun: "dashboard_run";
     readonly dashboardStuck: "dashboard_stuck";
     readonly dashboardDelete: "dashboard_delete";
+    readonly recordHistory: "record_history";
+    readonly fieldHistory: "field_history";
+    readonly restorePreview: "record_restore_preview";
+    readonly restoreVersion: "record_restore_version";
+    readonly valueRestore: "value_restore";
+    readonly recordScopeContext: "record_scope_context";
+    readonly conversationScope: "conversation_scope";
+    readonly conversationScopeBind: "conversation_scope_bind";
+    readonly conversationScopeUnbind: "conversation_scope_unbind";
+    readonly conversationScopeContext: "conversation_scope_context";
+    readonly commentThread: "comment_thread";
+    readonly commentWrite: "comment_write";
+    readonly commentResolve: "io_comment_resolve";
     readonly recordAggregate: "record_aggregate";
     readonly aggOperations: "agg_operations";
     readonly aggBuckets: "agg_buckets";
@@ -1047,4 +1269,4 @@ declare function parseCsv(text: string): string[][];
 declare function importCsv(fields: Field[], text: string): ParsedImport;
 declare function importXlsx(fields: Field[], bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
 
-export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, 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, FieldPatch, FieldProposal, FormSummary, 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, type RecordQuery, RecordRead, RecordRevision, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, 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, 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 };

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, PortalSummary, PortalCard, PortalInvitation, PortalRevocation, PortalPreviewRow, DashboardSummary, DashboardBlock, AggregateFilter, DashboardRunResult, StuckRow, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, ReadValue, AnonTokenBinding, 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, 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, Home, 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, 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 } 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, AggregateMeasure, AggregateBucket, AggregateRow, Subscription, MySubscription, DocToken, DocUnresolvedToken, DocTemplateRow, DocRenderRow, DocSignatureRow, RecordRevision, RecordHistoryEntry, RecordScopeContext, ConversationScope, ConversationScopeContext, FieldHistoryEntry, RestorePreview, RestoreResult, CommentThreadRead, CommentWritten, ReadValue, AnonTokenBinding, 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, 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';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:
@@ -272,6 +272,95 @@ interface RecordsClient {
         form_id?: Uuid | null;
         slug?: string | null;
     }): Promise<RecordsResult<Uuid>>;
+    /**
+     * What the store makes of a file's columns, before anything is written.
+     * `columns` is `[{header, samples}]` — the first page of the file is plenty.
+     */
+    importPlan(args: {
+        table_id: Uuid;
+        columns: Array<{
+            header: string;
+            samples: unknown[];
+        }>;
+    }): Promise<RecordsResult<ImportPlan>>;
+    /**
+     * Open a run. `file_hash` is the run's IDENTITY: the same bytes into the same
+     * table a second time answer the FIRST run with `already: true` and write
+     * nothing, so a re-import doubles nothing. `force` re-opens deliberately.
+     */
+    importBegin(args: {
+        table_id: Uuid;
+        format?: "csv" | "xlsx";
+        source_name?: string | null;
+        source_columns?: unknown[];
+        file_hash?: string | null;
+        policy?: ImportPolicy;
+        /** A Field key. A row whose value for it is already here is a duplicate. */
+        dedupe_key?: string | null;
+        file_bytes?: number | null;
+        force?: boolean;
+    }): Promise<RecordsResult<ImportOpened>>;
+    /**
+     * One BATCH of rows. Every row is written through the ONE write door inside
+     * its own subtransaction, so a refused row leaves nothing behind and never
+     * costs the rows before it. Send a few hundred at a time.
+     */
+    importRows(args: {
+        import_id: Uuid;
+        rows: Array<Record<string, unknown>>;
+        /** Header -> Field key. A header that already spells a key needs no entry. */
+        mapping?: Record<string, string>;
+    }): Promise<RecordsResult<ImportBatchResult>>;
+    /**
+     * Close the run and decide the columns the file had and the table did not:
+     * `propose` (the ONE approvals inbox, and the only choice a non-admin has),
+     * `create` (an admin adds them outright) or `ignore`.
+     */
+    importFinish(args: {
+        import_id: Uuid;
+        unmapped?: "propose" | "create" | "ignore";
+    }): Promise<RecordsResult<ImportFinished>>;
+    /** The refused rows, or the ones already here, WITH the source row on each. */
+    importReport(args: {
+        import_id: Uuid;
+        state?: "refused" | "duplicate";
+        limit?: number;
+        offset?: number;
+    }): Promise<RecordsResult<ImportReport>>;
+    /** This organization's import runs, newest first. How you find yesterday's. */
+    imports(args?: {
+        table_id?: Uuid | null;
+        limit?: number;
+    }): Promise<RecordsResult<ImportRun[]>>;
+    /**
+     * Forget the RECEIPT for a file so the same bytes can be imported again
+     * deliberately. Never touches the records that import wrote.
+     */
+    importForget(args: {
+        import_id: Uuid;
+    }): Promise<RecordsResult<boolean>>;
+    /**
+     * Give a table its own address. The answer carries `mail_route`: the one
+     * sentence saying what has to exist in DNS before anything arrives. Show it
+     * wherever the address is shown — an address that silently swallows mail is
+     * the failure this whole door is against.
+     */
+    inboundDeclare(args: {
+        table_id: Uuid;
+        label?: string | null;
+    }): Promise<RecordsResult<InboundDeclared>>;
+    inboundAddresses(args?: {
+        table_id?: Uuid | null;
+    }): Promise<RecordsResult<InboundAddress[]>>;
+    inboundSet(args: {
+        inbound_id: Uuid;
+        enabled: boolean;
+    }): Promise<RecordsResult<{
+        inbound_id: Uuid;
+        address: string;
+        enabled: boolean;
+        message: string;
+    }>>;
     /** Every portal over this organization the caller may know about, with its numbers. */
     portals(): Promise<RecordsResult<PortalSummary[]>>;
     /** ONE portal in full: what it shows, and who it was opened to. */
@@ -496,6 +585,115 @@ interface RecordsClient {
     revisions(args: {
         record_id: Uuid;
     }): Promise<RecordsResult<RecordRevision[]>>;
+    /**
+     * PRODUCTS row 4. One record's version list, newest first: who (a person, or
+     * an agent AND the person it acted for), when, the operation in the word
+     * somebody used, and every field that moved with its before, its after, the
+     * Rule version that produced a derived value and its source pointer. Viewer
+     * on the record — reading how something got to be the way it is is reading.
+     */
+    recordHistory(args: {
+        record_id: Uuid;
+        limit?: number;
+        offset?: number;
+    }): Promise<RecordsResult<RecordHistoryEntry[]>>;
+    /**
+     * AGT-N-9 — EVERYTHING A CHAT OPENED ON THIS RECORD MAY KNOW, IN ONE ROUND TRIP.
+     *
+     * The Fields with their `(record, field, value version)` triples, the relations one hop
+     * out, the history, the comments and the Table's other records — assembled INSIDE the
+     * database, every piece through the read door, under this person's own field-level
+     * security. A Field the store masks comes back in `withheld` with the store's own
+     * sentence and no value; a Field the organization keeps out of conversations comes back
+     * there too, saying which of the two it is.
+     */
+    recordScopeContext(args: {
+        record_id: Uuid;
+        relations?: number;
+        history?: number;
+        siblings?: number;
+    }): Promise<RecordsResult<RecordScopeContext>>;
+    /** What is this conversation about? */
+    conversationScope(args: {
+        conversation_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** Point a conversation at one record. Refused unless this person may open it. */
+    conversationScopeBind(args: {
+        conversation_id: Uuid;
+        record_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** This conversation is no longer about a particular record. */
+    conversationScopeUnbind(args: {
+        conversation_id: Uuid;
+    }): Promise<RecordsResult<ConversationScope>>;
+    /** The binding AND the context of a bound conversation, in one round trip. */
+    conversationScopeContext(args: {
+        conversation_id: Uuid;
+        relations?: number;
+        history?: number;
+        siblings?: number;
+    }): Promise<RecordsResult<ConversationScopeContext>>;
+    /**
+     * "Who changed the price on ANY record?" One column's history across a whole
+     * Table, narrowed to the records this person may see by a predicate in the
+     * same statement. A column that names no Field is refused BY NAME, never
+     * answered empty.
+     */
+    fieldHistory(args: {
+        table_id: Uuid;
+        field_key: string;
+        limit?: number;
+        offset?: number;
+        record_id?: Uuid;
+    }): Promise<RecordsResult<FieldHistoryEntry[]>>;
+    /**
+     * WHAT A RESTORE WOULD CHANGE, BEFORE IT DOES. Editor on the record: this is
+     * the first half of an act, and somebody who may not perform it is not shown
+     * its preview. Pass `field_key` for one column.
+     */
+    restorePreview(args: {
+        record_id: Uuid;
+        version: number;
+        field_key?: string;
+    }): Promise<RecordsResult<RestorePreview>>;
+    /** Put the whole record back to a version, as a NEW version. Editor. */
+    restoreVersion(args: {
+        record_id: Uuid;
+        version: number;
+    }): Promise<RecordsResult<RestoreResult>>;
+    /** Put ONE column back to what it said at a version, as a NEW version (HIS-N-2). Editor. */
+    valueRestore(args: {
+        record_id: Uuid;
+        field_key: string;
+        version: number;
+    }): Promise<RecordsResult<RestoreResult>>;
+    /**
+     * SCR-18. The record's comment thread with everybody named, plus what THIS
+     * person may do in it — decided by the store, in the same call, so a screen
+     * never draws a composer the write door will refuse.
+     */
+    commentThread(args: {
+        record_id: Uuid;
+        include_resolved?: boolean;
+    }): Promise<RecordsResult<CommentThreadRead>>;
+    /**
+     * Write a comment at the `commenter` rung, optionally naming people. A
+     * mention is a reference and not a regex over the body: the ids come from the
+     * picker and the store refuses one who is not in the organization, or who
+     * cannot open the record — because that notification would be a dead end.
+     */
+    commentWrite(args: {
+        record_id: Uuid;
+        body: string;
+        field_key?: string;
+        parent_comment_id?: Uuid;
+        mentions?: Uuid[];
+    }): Promise<RecordsResult<CommentWritten>>;
+    /** Resolve (or re-open) a thread. `commenter` — resolution is not a delete. */
+    commentResolve(args: {
+        comment_id: Uuid;
+        resolved?: boolean;
+    }): Promise<RecordsResult<boolean>>;
     /**
      * Every value of one record WITH its envelope — its own version, who wrote
      * it, who they were acting for and when. The timeline IS the record (REC-19);
@@ -859,6 +1057,17 @@ declare const DOORS: {
     readonly ruleEval: "rule_eval";
     readonly forms: "forms";
     readonly formDeclare: "form_declare";
+    readonly importPlan: "io_import_plan";
+    readonly importBegin: "io_import_begin";
+    readonly importRows: "io_import_rows";
+    readonly importFinish: "io_import_finish";
+    readonly importReport: "io_import_report";
+    readonly imports: "io_imports";
+    readonly importForget: "io_import_forget";
+    readonly inferColumn: "io_infer_column";
+    readonly inboundDeclare: "inbound_declare";
+    readonly inboundAddresses: "inbound_addresses";
+    readonly inboundSet: "inbound_set";
     readonly portals: "portals";
     readonly portalCard: "portal_card";
     readonly portalDeclare: "portal_declare";
@@ -870,6 +1079,19 @@ declare const DOORS: {
     readonly dashboardRun: "dashboard_run";
     readonly dashboardStuck: "dashboard_stuck";
     readonly dashboardDelete: "dashboard_delete";
+    readonly recordHistory: "record_history";
+    readonly fieldHistory: "field_history";
+    readonly restorePreview: "record_restore_preview";
+    readonly restoreVersion: "record_restore_version";
+    readonly valueRestore: "value_restore";
+    readonly recordScopeContext: "record_scope_context";
+    readonly conversationScope: "conversation_scope";
+    readonly conversationScopeBind: "conversation_scope_bind";
+    readonly conversationScopeUnbind: "conversation_scope_unbind";
+    readonly conversationScopeContext: "conversation_scope_context";
+    readonly commentThread: "comment_thread";
+    readonly commentWrite: "comment_write";
+    readonly commentResolve: "io_comment_resolve";
     readonly recordAggregate: "record_aggregate";
     readonly aggOperations: "agg_operations";
     readonly aggBuckets: "agg_buckets";
@@ -1047,4 +1269,4 @@ declare function parseCsv(text: string): string[][];
 declare function importCsv(fields: Field[], text: string): ParsedImport;
 declare function importXlsx(fields: Field[], bytes: ArrayBuffer | Uint8Array): Promise<ParsedImport>;
 
-export { AggregateBucket, AggregateFilter, AggregateMeasure, AggregateRow, AnonTokenBinding, type AsOf, 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, FieldPatch, FieldProposal, FormSummary, 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, type RecordQuery, RecordRead, RecordRevision, type RecordsClient, RecordsConfig, RecordsDataSource, RecordsError, RecordsResult, RelationCoordinate, ResolvedPublishBinding, 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, 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 };