@ai-matrx/records 0.92.1 → 0.93.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog — @ai-matrx/records
 
+## 0.93.0
+### host ports: record organization, row agent
+
+**`createRecords` takes two host ports.** `organizationOf` ("which organization owns this record", read from the
+object through `custom.where_id_opens`; new `RecordOrganizationPort`, `whereIdOpensPort`,
+`resolveObjectOrganization`, `readObjectOrganizationAnswer`, `ObjectOrganizationAnswer` — moved from the website) and
+`rowAgent` ("run an agent on this row"; new `RowAgentPort`, `RowAgentTarget`). The setup answers
+`organizationOf(id)` (default: the store's door) and `runAgentOnRow(target)` (refuses `not_supported` by name when no
+runner is bound).
+
+**Consumer action:** none. A host that keeps object-organization answers binds its own `organizationOf`; a host with
+an agent runner passes `rowAgent`.
+
+### saved views, headless
+
+**New section `@ai-matrx/records/views`: saved views without any screen.** The view-key registry (`VIEW_KEYS`), the
+one reader (`viewSettings`) and writer (`viewSettingsPatch`), the declarative spec (`SavedViewSpec`, `SavedView`), the
+layouts and page-view words, and the doors that keep a view (`declareView`, `saveViewPatch`, `designateView`,
+`viewFromRow`, `viewDocument`) moved here from `@ai-matrx/records-ui`. A view's look is a port
+(`ViewPresentationCodec`): left out, it stays the plain JSON document the store keeps; records-ui binds its grid look.
+Zero React, zero design-system (section-isolation probe `./views`).
+
+**Consumer action:** none. A headless host imports saved views from `@ai-matrx/records/views`; records-ui's own
+exports are unchanged.
+
+### own-write ledger
+
+**Two setups in one process hear each other's live writes.** The op ledger (how a client knows a notice is the echo
+of its own write) was one per realm, so setup A's write was "ours" to setup B too and B dropped it. Own-write
+detection is now per client: `createRecords` gives each setup its own ledger and hands it to its client, entity port
+and live port. New `createOpLedger()` / `OpLedger`; `createRecordsClient({ opLedger })`,
+`createRecordsRealtimePort({ ledger })`, `createEntityDataPort({ opLedger })`. Left out, the realm's default ledger
+is used exactly as before (`mintOpId` / `isOwnOp` unchanged).
+
+**Consumer action:** none. A host that builds its own client and live port by hand and runs two of them in one
+realm passes the same `createOpLedger()` to each pair.
+
+## 0.92.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.92.1..npm/records/v0.92.2 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.92.1
 
 **`recordRead`'s version is opt-in: `recordRead({ record_id, withVersion: true })`.** 0.92.0 read the header on

package/README.md

@@ -55,9 +55,8 @@ const tableId = table.data;                 // the table id
 const created = await matrx.records.recordWrite({ table_id: tableId, data: { caller: "Marcus Delgado", phone: "+14155550178" } });
 const page    = await matrx.records.list({ table_id: tableId, limit: 50 });                  // { rows, total }
 const record_id = created.ok ? created.data : "";
-const read    = await matrx.records.recordRead({ record_id });                               // .data.document
-const heads   = await matrx.records.recordHeaders({ ids: [record_id] });                     // .data[0].version
-const expectedVersion = heads.ok ? heads.data[0]?.version : undefined;
+const read    = await matrx.records.recordRead({ record_id, withVersion: true });          // .data.document, .data.version
+const expectedVersion = read.ok ? (read.data.version ?? undefined) : undefined;
 const edited  = await matrx.records.recordUpdate({ record_id, patch: { phone: "+14155550199" }, expectedVersion }); // answers the new version
 // Always send expectedVersion: a colleague's newer edit is then refused (`stale_write`, field by field), never overwritten.
 const archived = await matrx.records.recordDelete({ record_id });                            // soft: recordRestore brings it back
@@ -82,7 +81,8 @@ as a second mode (planned); today `auth` is a signed-in session.
 | `records/core` | the typed client over every door (tables, records, versions, views, forms, totals) |
 | `records/realtime` | the live-changes port setup uses |
 | `records/search` | `searchRecords`, `listStoreRecordCandidates` |
-| `records/forms` | the form document, embeds and which read a public address does |
+| `records/forms` | the form document, embeds, which read a public address does, `typedAnswersFor` |
+| `records/versions` | the version rule: `useRecordVersions`, version-carrying write doors, `askOnce`, `refusal` |
 | `records/entity`, `records/entity/react` | platform records (contacts, projects, tasks) |
 | `records/data`, `records/data/react` | one data port and TanStack hooks over custom tables and entities |
 | `records/react` | provider + hooks over the client |

package/dist/{client-Dzd8gtAo.d.ts → client-DsPuWFp0.d.ts}

@@ -1,11 +1,11 @@
-import { C as ChoiceNudge, T as TableArchiveProgress, a as TableRestoreProgress, b as TableDuplicateProgress, c as TableDuplicated, d as TableCopyInProgress, A as ArchiveLane, e as ArchivedRow, f as Table, g as TableHome, h as TableMoved, i as ChoiceUsage, j as ChoiceRehome, k as ChoiceCellBack, l as ChoicesRehomed, m as TableCapacity, F as FieldDrift, n as FieldRetyped, R as RecordsMerged, M as MigrationUndone, o as TableKindFacts, p as TableLevelFacts, q as TableReaderRule, r as TableLevelSet, E as EntityTableFacts, s as EntityFieldsAcross, N as NewEntityFieldDeclaration, t as EntityFieldRights, u as EntityRecordRead, v as EntityBackLinks, w as EntityRowWritten, x as EntityRecordsFound, P as Pipeline, y as PipelineColumn, z as PipelineVerdict, B as PipelineMoveResult, D as PipelineMoveManyItem, G as PipelineMoveMany, H as PipelineSpec, I as PipelineDeclared, S as StageRuleOnFail, J as StageRuleEnforcement, K as StagePending, L as StagePendingOnBoard, O as PipelineGate, Q as PipelineGatePreview, U as ImportPlan, V as ImportPolicy, W as ImportOpened, X as ImportColumnsDeclared, Y as ImportBatchResult, Z as ImportFinished, _ as ImportReport, $ as ImportRun, a0 as InboundDeclared, a1 as InboundAddress, a2 as FormArchiveAnswer, a3 as ArchivedForm, a4 as ArchivedChecklistTemplate, a5 as TableRowDefaults, a6 as TableRowDefaultsPatch, a7 as RowDefaultsApplied, a8 as RecordRowControls, a9 as CaptureSheetSummary, aa as CaptureSheetFace, ab as CaptureFileRef, ac as CaptureOutcome, ad as EnrichmentSummary, ae as EnrichDeclared, af as EnrichDueRow, ag as EnrichCell, ah as EnrichRun, ai as DrillSource, aj as DrillDefinition, ak as DrillQuestion, al as DrillAnswer, am as DrillRowsPage, an as DocToken, ao as DocUnresolvedToken, ap as DocTemplateRow, aq as DocRenderRow, ar as DocSignatureRow, as as RecordHistoryEntry, at as RecordScopeContext, au as ConversationScope, av as ConversationScopeContext, aw as FieldHistoryEntry, ax as RestorePreview, ay as RestoreResult, az as CommentThreadRead, aA as CommentWritten, aB as AnonTokenBinding, aC as ChecklistSpec, aD as ChecklistDeclared, aE as ChecklistTemplateSummary, aF as ChecklistTemplateShape, aG as ChecklistRunStarted, aH as ChecklistRunStep, aI as ChecklistRunSummary, aJ as ChecklistStepCompleted, aK as WorkState, aL as WorkGraph, aM as WorkInstantiation, aN as WorkTurn, aO as WorkAssignmentField, aP as WorkSlotHold, aQ as WorkInboxView, aR as WorkInboxItem, aS as InboxStateChange, aT as InboxCounts, aU as WorkListFlavour, aV as WorkListItem, aW as WorkAssignment, aX as WorkRecordState, aY as WorkApprover, aZ as WorkChange, a_ as WorkApprovalFiled, a$ as WorkApprovalDecision, b0 as WorkDecideManyItem, b1 as WorkDecideMany, b2 as ExternalPrincipalCard, b3 as PublishBinding, b4 as ResolvedPublishBinding, b5 as ResolvedPublishBindingKind, b6 as MyLevel, b7 as DecorationPath, b8 as TableDecorations, b9 as GridLayout, ba as FormulaParse, bb as FormulaPreview, bc as RowAction, bd as ActionRunResult, be as AutomationSpec, bf as AutomationDeclared, bg as AutomationList, bh as AutomationFlipped, bi as AutomationRuns, bj as RecordEvent, bk as TableWebhookDeclared, bl as TableWebhook, bm as IoExportPage, bn as TableListEntry, bo as DataHomeTable, bp as TableSyncSpec, bq as TableSyncResult, br as TableRowCount, bs as RecordHeader, bt as OutsideShareAnswer, bu as ViewOrderSet } from './table-kind-i3lZJa3f.js';
-import { d as StoreFilter, e as DashboardSummary, f as DashboardBlock, R as RecordFilter, g as AggregateCompare, c as AggregateBucket, h as DashboardRunResult, i as StuckRow, b as AggregateMeasure, j as AggregateRow, k as Subscription, M as MySubscription, l as SubscriptionSpec, m as DigestPreview, n as SavedViewRow, o as SavedViewSpecIn, p as RowTemplateRow } from './subscription-BynsG1K6.js';
-import { R as RelationCoordinate, a as RelationWordsManyArgs, b as RelationIcons, c as ReverseColumn, d as ReverseLinksManyArgs, e as ReverseLinks, f as ReverseLinksFieldsArgs, S as SourceArchived } from './relation-eLMgv_dV.js';
-import { b as Field, c as FieldPatch, N as NewFieldDeclaration, R as RelationNamesAnswer, d as FieldDuplicated, e as FieldProposal, T as TableProposal, B as ButtonPressed } from './field-enufS5ry.js';
-import { F as FormSummary, B as BookingSummary, a as BookingAvailability, b as BookingDeclared, c as FormRoute, d as FormResults } from './rule-D9yNiorf.js';
-import { F as FormLookOptions, P as PortalSummary, a as PortalArchiveFilter, b as PortalArchiveAnswer, c as PortalTableRef, d as PortalCard, e as PortalConfigInput, f as PortalFormSpec, g as PortalFormAnswer, h as PortalInvitation, i as PortalRevocation, j as PortalPreviewRow } from './portal-or_f7BkT.js';
-import { T as Timestamp, U as Uuid, k as RecordsErrorCode, l as RecordDocument, R as RecordsResult, m as RecordChange, n as RecordChangeResult, o as RecordGraphWritten, p as RecordRead, q as ReadRow, r as RecordPageSort, s as RecordPage, t as RecordKeysetPage, u as StoredRecord, v as RecordRevision, w as ReadValue, a as RecordsError, W as WriteConflict } from './record-BwCf9wKW.js';
-import { a as RecordsConfig } from './ports-BeOgjwYl.js';
+import { C as ChoiceNudge, T as TableArchiveProgress, a as TableRestoreProgress, b as TableDuplicateProgress, c as TableDuplicated, d as TableCopyInProgress, A as ArchiveLane, e as ArchivedRow, f as Table, g as TableHome, h as TableMoved, i as ChoiceUsage, j as ChoiceRehome, k as ChoiceCellBack, l as ChoicesRehomed, m as TableCapacity, F as FieldDrift, n as FieldRetyped, R as RecordsMerged, M as MigrationUndone, o as TableKindFacts, p as TableLevelFacts, q as TableReaderRule, r as TableLevelSet, E as EntityTableFacts, s as EntityFieldsAcross, N as NewEntityFieldDeclaration, t as EntityFieldRights, u as EntityRecordRead, v as EntityBackLinks, w as EntityRowWritten, x as EntityRecordsFound, P as Pipeline, y as PipelineColumn, z as PipelineVerdict, B as PipelineMoveResult, D as PipelineMoveManyItem, G as PipelineMoveMany, H as PipelineSpec, I as PipelineDeclared, S as StageRuleOnFail, J as StageRuleEnforcement, K as StagePending, L as StagePendingOnBoard, O as PipelineGate, Q as PipelineGatePreview, U as ImportPlan, V as ImportPolicy, W as ImportOpened, X as ImportColumnsDeclared, Y as ImportBatchResult, Z as ImportFinished, _ as ImportReport, $ as ImportRun, a0 as InboundDeclared, a1 as InboundAddress, a2 as FormArchiveAnswer, a3 as ArchivedForm, a4 as ArchivedChecklistTemplate, a5 as TableRowDefaults, a6 as TableRowDefaultsPatch, a7 as RowDefaultsApplied, a8 as RecordRowControls, a9 as CaptureSheetSummary, aa as CaptureSheetFace, ab as CaptureFileRef, ac as CaptureOutcome, ad as EnrichmentSummary, ae as EnrichDeclared, af as EnrichDueRow, ag as EnrichCell, ah as EnrichRun, ai as DrillSource, aj as DrillDefinition, ak as DrillQuestion, al as DrillAnswer, am as DrillRowsPage, an as DocToken, ao as DocUnresolvedToken, ap as DocTemplateRow, aq as DocRenderRow, ar as DocSignatureRow, as as RecordHistoryEntry, at as RecordScopeContext, au as ConversationScope, av as ConversationScopeContext, aw as FieldHistoryEntry, ax as RestorePreview, ay as RestoreResult, az as CommentThreadRead, aA as CommentWritten, aB as AnonTokenBinding, aC as ChecklistSpec, aD as ChecklistDeclared, aE as ChecklistTemplateSummary, aF as ChecklistTemplateShape, aG as ChecklistRunStarted, aH as ChecklistRunStep, aI as ChecklistRunSummary, aJ as ChecklistStepCompleted, aK as WorkState, aL as WorkGraph, aM as WorkInstantiation, aN as WorkTurn, aO as WorkAssignmentField, aP as WorkSlotHold, aQ as WorkInboxView, aR as WorkInboxItem, aS as InboxStateChange, aT as InboxCounts, aU as WorkListFlavour, aV as WorkListItem, aW as WorkAssignment, aX as WorkRecordState, aY as WorkApprover, aZ as WorkChange, a_ as WorkApprovalFiled, a$ as WorkApprovalDecision, b0 as WorkDecideManyItem, b1 as WorkDecideMany, b2 as ExternalPrincipalCard, b3 as PublishBinding, b4 as ResolvedPublishBinding, b5 as ResolvedPublishBindingKind, b6 as DecorationPath, b7 as TableDecorations, b8 as GridLayout, b9 as FormulaParse, ba as FormulaPreview, bb as RowAction, bc as ActionRunResult, bd as AutomationSpec, be as AutomationDeclared, bf as AutomationList, bg as AutomationFlipped, bh as AutomationRuns, bi as RecordEvent, bj as TableWebhookDeclared, bk as TableWebhook, bl as IoExportPage, bm as TableListEntry, bn as DataHomeTable, bo as TableSyncSpec, bp as TableSyncResult, bq as TableRowCount, br as RecordHeader, bs as OutsideShareAnswer, bt as ViewOrderSet } from './table-kind-BZkvzBgc.js';
+import { e as StoreFilter, f as DashboardSummary, g as DashboardBlock, R as RecordFilter, h as AggregateCompare, c as AggregateBucket, i as DashboardRunResult, j as StuckRow, b as AggregateMeasure, k as AggregateRow, l as Subscription, M as MySubscription, m as SubscriptionSpec, n as DigestPreview, d as SavedViewRow, o as SavedViewSpecIn, p as RowTemplateRow } from './subscription-hdTaRrfK.js';
+import { R as RelationCoordinate, a as RelationWordsManyArgs, b as RelationIcons, c as ReverseColumn, d as ReverseLinksManyArgs, e as ReverseLinks, f as ReverseLinksFieldsArgs, S as SourceArchived } from './relation-Op1M67le.js';
+import { b as Field, c as FieldPatch, N as NewFieldDeclaration, R as RelationNamesAnswer, d as FieldDuplicated, e as FieldProposal, T as TableProposal, B as ButtonPressed } from './field-B-WaVZnS.js';
+import { F as FormSummary, B as BookingSummary, a as BookingAvailability, b as BookingDeclared, c as FormRoute, d as FormResults } from './rule-tN2lxvJ1.js';
+import { F as FormLookOptions, P as PortalSummary, a as PortalArchiveFilter, b as PortalArchiveAnswer, c as PortalTableRef, d as PortalCard, e as PortalConfigInput, f as PortalFormSpec, g as PortalFormAnswer, h as PortalInvitation, i as PortalRevocation, j as PortalPreviewRow } from './portal-BDAqsGkg.js';
+import { a as RecordsConfig, M as MyLevel } from './ports-DYWE1ENo.js';
+import { h as Timestamp, U as Uuid, k as RecordsErrorCode, l as RecordDocument, R as RecordsResult, m as RecordChange, n as RecordChangeResult, o as RecordGraphWritten, p as RecordRead, q as ReadRow, r as RecordPageSort, s as RecordPage, t as RecordKeysetPage, u as StoredRecord, v as RecordRevision, w as ReadValue, a as RecordsError, W as WriteConflict } from './record-DmmeuUrC.js';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:

package/dist/{client-Cn3odIIB.d.cts → client-EyD3rS0T.d.cts}

@@ -1,11 +1,11 @@
-import { C as ChoiceNudge, T as TableArchiveProgress, a as TableRestoreProgress, b as TableDuplicateProgress, c as TableDuplicated, d as TableCopyInProgress, A as ArchiveLane, e as ArchivedRow, f as Table, g as TableHome, h as TableMoved, i as ChoiceUsage, j as ChoiceRehome, k as ChoiceCellBack, l as ChoicesRehomed, m as TableCapacity, F as FieldDrift, n as FieldRetyped, R as RecordsMerged, M as MigrationUndone, o as TableKindFacts, p as TableLevelFacts, q as TableReaderRule, r as TableLevelSet, E as EntityTableFacts, s as EntityFieldsAcross, N as NewEntityFieldDeclaration, t as EntityFieldRights, u as EntityRecordRead, v as EntityBackLinks, w as EntityRowWritten, x as EntityRecordsFound, P as Pipeline, y as PipelineColumn, z as PipelineVerdict, B as PipelineMoveResult, D as PipelineMoveManyItem, G as PipelineMoveMany, H as PipelineSpec, I as PipelineDeclared, S as StageRuleOnFail, J as StageRuleEnforcement, K as StagePending, L as StagePendingOnBoard, O as PipelineGate, Q as PipelineGatePreview, U as ImportPlan, V as ImportPolicy, W as ImportOpened, X as ImportColumnsDeclared, Y as ImportBatchResult, Z as ImportFinished, _ as ImportReport, $ as ImportRun, a0 as InboundDeclared, a1 as InboundAddress, a2 as FormArchiveAnswer, a3 as ArchivedForm, a4 as ArchivedChecklistTemplate, a5 as TableRowDefaults, a6 as TableRowDefaultsPatch, a7 as RowDefaultsApplied, a8 as RecordRowControls, a9 as CaptureSheetSummary, aa as CaptureSheetFace, ab as CaptureFileRef, ac as CaptureOutcome, ad as EnrichmentSummary, ae as EnrichDeclared, af as EnrichDueRow, ag as EnrichCell, ah as EnrichRun, ai as DrillSource, aj as DrillDefinition, ak as DrillQuestion, al as DrillAnswer, am as DrillRowsPage, an as DocToken, ao as DocUnresolvedToken, ap as DocTemplateRow, aq as DocRenderRow, ar as DocSignatureRow, as as RecordHistoryEntry, at as RecordScopeContext, au as ConversationScope, av as ConversationScopeContext, aw as FieldHistoryEntry, ax as RestorePreview, ay as RestoreResult, az as CommentThreadRead, aA as CommentWritten, aB as AnonTokenBinding, aC as ChecklistSpec, aD as ChecklistDeclared, aE as ChecklistTemplateSummary, aF as ChecklistTemplateShape, aG as ChecklistRunStarted, aH as ChecklistRunStep, aI as ChecklistRunSummary, aJ as ChecklistStepCompleted, aK as WorkState, aL as WorkGraph, aM as WorkInstantiation, aN as WorkTurn, aO as WorkAssignmentField, aP as WorkSlotHold, aQ as WorkInboxView, aR as WorkInboxItem, aS as InboxStateChange, aT as InboxCounts, aU as WorkListFlavour, aV as WorkListItem, aW as WorkAssignment, aX as WorkRecordState, aY as WorkApprover, aZ as WorkChange, a_ as WorkApprovalFiled, a$ as WorkApprovalDecision, b0 as WorkDecideManyItem, b1 as WorkDecideMany, b2 as ExternalPrincipalCard, b3 as PublishBinding, b4 as ResolvedPublishBinding, b5 as ResolvedPublishBindingKind, b6 as MyLevel, b7 as DecorationPath, b8 as TableDecorations, b9 as GridLayout, ba as FormulaParse, bb as FormulaPreview, bc as RowAction, bd as ActionRunResult, be as AutomationSpec, bf as AutomationDeclared, bg as AutomationList, bh as AutomationFlipped, bi as AutomationRuns, bj as RecordEvent, bk as TableWebhookDeclared, bl as TableWebhook, bm as IoExportPage, bn as TableListEntry, bo as DataHomeTable, bp as TableSyncSpec, bq as TableSyncResult, br as TableRowCount, bs as RecordHeader, bt as OutsideShareAnswer, bu as ViewOrderSet } from './table-kind-DzctQ7dO.cjs';
-import { d as StoreFilter, e as DashboardSummary, f as DashboardBlock, R as RecordFilter, g as AggregateCompare, c as AggregateBucket, h as DashboardRunResult, i as StuckRow, b as AggregateMeasure, j as AggregateRow, k as Subscription, M as MySubscription, l as SubscriptionSpec, m as DigestPreview, n as SavedViewRow, o as SavedViewSpecIn, p as RowTemplateRow } from './subscription-CdoI-UaB.cjs';
-import { R as RelationCoordinate, a as RelationWordsManyArgs, b as RelationIcons, c as ReverseColumn, d as ReverseLinksManyArgs, e as ReverseLinks, f as ReverseLinksFieldsArgs, S as SourceArchived } from './relation-8vAWCa67.cjs';
-import { b as Field, c as FieldPatch, N as NewFieldDeclaration, R as RelationNamesAnswer, d as FieldDuplicated, e as FieldProposal, T as TableProposal, B as ButtonPressed } from './field-CCY1rG9l.cjs';
-import { F as FormSummary, B as BookingSummary, a as BookingAvailability, b as BookingDeclared, c as FormRoute, d as FormResults } from './rule-wHI5B0Ka.cjs';
-import { F as FormLookOptions, P as PortalSummary, a as PortalArchiveFilter, b as PortalArchiveAnswer, c as PortalTableRef, d as PortalCard, e as PortalConfigInput, f as PortalFormSpec, g as PortalFormAnswer, h as PortalInvitation, i as PortalRevocation, j as PortalPreviewRow } from './portal-DRdmZ-xv.cjs';
-import { T as Timestamp, U as Uuid, k as RecordsErrorCode, l as RecordDocument, R as RecordsResult, m as RecordChange, n as RecordChangeResult, o as RecordGraphWritten, p as RecordRead, q as ReadRow, r as RecordPageSort, s as RecordPage, t as RecordKeysetPage, u as StoredRecord, v as RecordRevision, w as ReadValue, a as RecordsError, W as WriteConflict } from './record-BwCf9wKW.cjs';
-import { a as RecordsConfig } from './ports-s0D2jvqn.cjs';
+import { C as ChoiceNudge, T as TableArchiveProgress, a as TableRestoreProgress, b as TableDuplicateProgress, c as TableDuplicated, d as TableCopyInProgress, A as ArchiveLane, e as ArchivedRow, f as Table, g as TableHome, h as TableMoved, i as ChoiceUsage, j as ChoiceRehome, k as ChoiceCellBack, l as ChoicesRehomed, m as TableCapacity, F as FieldDrift, n as FieldRetyped, R as RecordsMerged, M as MigrationUndone, o as TableKindFacts, p as TableLevelFacts, q as TableReaderRule, r as TableLevelSet, E as EntityTableFacts, s as EntityFieldsAcross, N as NewEntityFieldDeclaration, t as EntityFieldRights, u as EntityRecordRead, v as EntityBackLinks, w as EntityRowWritten, x as EntityRecordsFound, P as Pipeline, y as PipelineColumn, z as PipelineVerdict, B as PipelineMoveResult, D as PipelineMoveManyItem, G as PipelineMoveMany, H as PipelineSpec, I as PipelineDeclared, S as StageRuleOnFail, J as StageRuleEnforcement, K as StagePending, L as StagePendingOnBoard, O as PipelineGate, Q as PipelineGatePreview, U as ImportPlan, V as ImportPolicy, W as ImportOpened, X as ImportColumnsDeclared, Y as ImportBatchResult, Z as ImportFinished, _ as ImportReport, $ as ImportRun, a0 as InboundDeclared, a1 as InboundAddress, a2 as FormArchiveAnswer, a3 as ArchivedForm, a4 as ArchivedChecklistTemplate, a5 as TableRowDefaults, a6 as TableRowDefaultsPatch, a7 as RowDefaultsApplied, a8 as RecordRowControls, a9 as CaptureSheetSummary, aa as CaptureSheetFace, ab as CaptureFileRef, ac as CaptureOutcome, ad as EnrichmentSummary, ae as EnrichDeclared, af as EnrichDueRow, ag as EnrichCell, ah as EnrichRun, ai as DrillSource, aj as DrillDefinition, ak as DrillQuestion, al as DrillAnswer, am as DrillRowsPage, an as DocToken, ao as DocUnresolvedToken, ap as DocTemplateRow, aq as DocRenderRow, ar as DocSignatureRow, as as RecordHistoryEntry, at as RecordScopeContext, au as ConversationScope, av as ConversationScopeContext, aw as FieldHistoryEntry, ax as RestorePreview, ay as RestoreResult, az as CommentThreadRead, aA as CommentWritten, aB as AnonTokenBinding, aC as ChecklistSpec, aD as ChecklistDeclared, aE as ChecklistTemplateSummary, aF as ChecklistTemplateShape, aG as ChecklistRunStarted, aH as ChecklistRunStep, aI as ChecklistRunSummary, aJ as ChecklistStepCompleted, aK as WorkState, aL as WorkGraph, aM as WorkInstantiation, aN as WorkTurn, aO as WorkAssignmentField, aP as WorkSlotHold, aQ as WorkInboxView, aR as WorkInboxItem, aS as InboxStateChange, aT as InboxCounts, aU as WorkListFlavour, aV as WorkListItem, aW as WorkAssignment, aX as WorkRecordState, aY as WorkApprover, aZ as WorkChange, a_ as WorkApprovalFiled, a$ as WorkApprovalDecision, b0 as WorkDecideManyItem, b1 as WorkDecideMany, b2 as ExternalPrincipalCard, b3 as PublishBinding, b4 as ResolvedPublishBinding, b5 as ResolvedPublishBindingKind, b6 as DecorationPath, b7 as TableDecorations, b8 as GridLayout, b9 as FormulaParse, ba as FormulaPreview, bb as RowAction, bc as ActionRunResult, bd as AutomationSpec, be as AutomationDeclared, bf as AutomationList, bg as AutomationFlipped, bh as AutomationRuns, bi as RecordEvent, bj as TableWebhookDeclared, bk as TableWebhook, bl as IoExportPage, bm as TableListEntry, bn as DataHomeTable, bo as TableSyncSpec, bp as TableSyncResult, bq as TableRowCount, br as RecordHeader, bs as OutsideShareAnswer, bt as ViewOrderSet } from './table-kind-C-hZxDN7.cjs';
+import { e as StoreFilter, f as DashboardSummary, g as DashboardBlock, R as RecordFilter, h as AggregateCompare, c as AggregateBucket, i as DashboardRunResult, j as StuckRow, b as AggregateMeasure, k as AggregateRow, l as Subscription, M as MySubscription, m as SubscriptionSpec, n as DigestPreview, d as SavedViewRow, o as SavedViewSpecIn, p as RowTemplateRow } from './subscription-Drbxn-9Z.cjs';
+import { R as RelationCoordinate, a as RelationWordsManyArgs, b as RelationIcons, c as ReverseColumn, d as ReverseLinksManyArgs, e as ReverseLinks, f as ReverseLinksFieldsArgs, S as SourceArchived } from './relation-qrb2NbHf.cjs';
+import { b as Field, c as FieldPatch, N as NewFieldDeclaration, R as RelationNamesAnswer, d as FieldDuplicated, e as FieldProposal, T as TableProposal, B as ButtonPressed } from './field-6rwt4ejZ.cjs';
+import { F as FormSummary, B as BookingSummary, a as BookingAvailability, b as BookingDeclared, c as FormRoute, d as FormResults } from './rule-CeHg1sy1.cjs';
+import { F as FormLookOptions, P as PortalSummary, a as PortalArchiveFilter, b as PortalArchiveAnswer, c as PortalTableRef, d as PortalCard, e as PortalConfigInput, f as PortalFormSpec, g as PortalFormAnswer, h as PortalInvitation, i as PortalRevocation, j as PortalPreviewRow } from './portal-9sRr6cpG.cjs';
+import { a as RecordsConfig, M as MyLevel } from './ports-9BQ3zo2y.cjs';
+import { h as Timestamp, U as Uuid, k as RecordsErrorCode, l as RecordDocument, R as RecordsResult, m as RecordChange, n as RecordChangeResult, o as RecordGraphWritten, p as RecordRead, q as ReadRow, r as RecordPageSort, s as RecordPage, t as RecordKeysetPage, u as StoredRecord, v as RecordRevision, w as ReadValue, a as RecordsError, W as WriteConflict } from './record-DmmeuUrC.cjs';
 
 /**
  * DOOR-8. As-of on EITHER clock, and they are different questions:

package/dist/core/index.cjs

@@ -110,6 +110,7 @@ __export(core_exports, {
   TABLE_TYPES: () => TABLE_TYPES,
   VALUE_ALTERNATE_KEYS: () => VALUE_ALTERNATE_KEYS,
   VALUE_ENVELOPE_KEYS: () => VALUE_ENVELOPE_KEYS,
+  WHERE_ID_OPENS_DOOR: () => WHERE_ID_OPENS_DOOR,
   WHOLE_VALUE_SOURCE_KIND: () => WHOLE_VALUE_SOURCE_KIND,
   actionRefusals: () => actionRefusals,
   addFields: () => addFields,
@@ -144,10 +145,12 @@ __export(core_exports, {
   coerceTypedAnswer: () => coerceTypedAnswer,
   coerceTypedAnswers: () => coerceTypedAnswers,
   coercionLabel: () => coercionLabel,
+  createOpLedger: () => createOpLedger,
   createRecordsClient: () => createRecordsClient,
   decideTypedChoice: () => decideTypedChoice,
   declareDrillDefinition: () => declareDrillDefinition,
   declareTable: () => declareTable,
+  defaultOpLedger: () => defaultOpLedger,
   doorAbsent: () => doorAbsent,
   doorCensus: () => doorCensus,
   doorExists: () => doorExists,
@@ -258,6 +261,7 @@ __export(core_exports, {
   publicFormPath: () => publicFormPath,
   rankTypedMatches: () => rankTypedMatches,
   ratingMaxOf: () => ratingMaxOf,
+  readObjectOrganizationAnswer: () => readObjectOrganizationAnswer,
   readTypedDate: () => readTypedDate,
   readTypedDuration: () => readTypedDuration,
   readTypedNumber: () => readTypedNumber,
@@ -273,6 +277,7 @@ __export(core_exports, {
   relationNamesIn: () => relationNamesIn,
   rememberedOpCount: () => rememberedOpCount,
   removedChoicesInUse: () => removedChoicesInUse,
+  resolveObjectOrganization: () => resolveObjectOrganization,
   richTextPlain: () => richTextPlain,
   ruleThatRefuses: () => ruleThatRefuses,
   rulesWithTopStar: () => rulesWithTopStar,
@@ -305,6 +310,7 @@ __export(core_exports, {
   typedTimeText: () => typedTimeText,
   valueConverts: () => valueConverts,
   valuesAreUnconfirmed: () => valuesAreUnconfirmed,
+  whereIdOpensPort: () => whereIdOpensPort,
   wholeValueNotRead: () => wholeValueNotRead,
   wholeValueOf: () => wholeValueOf,
   wholeValueOfRead: () => wholeValueOfRead,
@@ -2567,44 +2573,105 @@ function sourceArchivedOf(value) {
   return out;
 }
 
+// src/objectOrganization.ts
+var WHERE_ID_OPENS_DOOR = "where_id_opens";
+function doorIsAbsent(error) {
+  if (error.code === "PGRST202" || error.code === "42883") return true;
+  return /could not find the function/i.test(error.message ?? "");
+}
+var DOOR_ABSENT_WHY = "custom.where_id_opens is missing from this database, so this page cannot tell which organization the record lives in and holds instead of guessing. Remedy: the chair applies migrations/campaign/openbyid_one_address_opens_any_id.sql and openbyid_the_resolver_can_be_reached.sql.";
+async function resolveObjectOrganization(dataSource, id) {
+  let answered;
+  try {
+    answered = await dataSource.rpc(WHERE_ID_OPENS_DOOR, { p_id: id }, { schema: "custom" });
+  } catch (thrown) {
+    return { state: "unavailable", why: thrown instanceof Error ? thrown.message : "The record store did not answer." };
+  }
+  return readObjectOrganizationAnswer(answered, id);
+}
+function readObjectOrganizationAnswer(answered, id) {
+  if (answered.error) {
+    if (doorIsAbsent(answered.error)) {
+      console.warn(`[@ai-matrx/records] ${DOOR_ABSENT_WHY}`);
+      return { state: "unavailable", why: DOOR_ABSENT_WHY };
+    }
+    return { state: "unavailable", why: answered.error.message ?? "The record store refused to say where this is." };
+  }
+  const row = answered.data;
+  if (row === null || row === void 0) return { state: "not-given" };
+  if (typeof row !== "object" || typeof row.organization_id !== "string" || typeof row.kind !== "string") {
+    return { state: "unavailable", why: "The record store answered something this page cannot read." };
+  }
+  return {
+    state: "found",
+    organizationId: row.organization_id,
+    kind: row.kind,
+    path: typeof row.path === "string" ? row.path : null,
+    live: row.live !== false,
+    resolvedId: typeof row.resolved_id === "string" ? row.resolved_id : id
+  };
+}
+function whereIdOpensPort(dataSource) {
+  return { organizationOf: (id) => resolveObjectOrganization(dataSource, id) };
+}
+
 // src/ops.ts
 var import_global_slot = require("@ai-matrx/kit/global-slot");
 var REMEMBER_MS = 3e4;
 var REMEMBER_MAX = 500;
-var ours = (0, import_global_slot.globalSlot)("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map());
-function trim(now) {
-  for (const [id, at] of ours) {
-    if (now - at <= REMEMBER_MS) break;
-    ours.delete(id);
-  }
-  while (ours.size > REMEMBER_MAX) {
-    const oldest = ours.keys().next();
-    if (oldest.done === true) break;
-    ours.delete(oldest.value);
+function ledgerOver(ours) {
+  function trim(now) {
+    for (const [id, at] of ours) {
+      if (now - at <= REMEMBER_MS) break;
+      ours.delete(id);
+    }
+    while (ours.size > REMEMBER_MAX) {
+      const oldest = ours.keys().next();
+      if (oldest.done === true) break;
+      ours.delete(oldest.value);
+    }
   }
+  return {
+    mint() {
+      const id = crypto.randomUUID();
+      const now = Date.now();
+      ours.set(id, now);
+      trim(now);
+      return id;
+    },
+    isOwn(opId) {
+      if (!opId) return false;
+      const at = ours.get(opId);
+      if (at === void 0) return false;
+      if (Date.now() - at > REMEMBER_MS) {
+        ours.delete(opId);
+        return false;
+      }
+      return true;
+    },
+    clear() {
+      ours.clear();
+    },
+    get size() {
+      return ours.size;
+    }
+  };
+}
+function createOpLedger() {
+  return ledgerOver(/* @__PURE__ */ new Map());
 }
+var defaultOpLedger = ledgerOver((0, import_global_slot.globalSlot)("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map()));
 function mintOpId() {
-  const id = crypto.randomUUID();
-  const now = Date.now();
-  ours.set(id, now);
-  trim(now);
-  return id;
+  return defaultOpLedger.mint();
 }
 function isOwnOp(opId) {
-  if (!opId) return false;
-  const at = ours.get(opId);
-  if (at === void 0) return false;
-  if (Date.now() - at > REMEMBER_MS) {
-    ours.delete(opId);
-    return false;
-  }
-  return true;
+  return defaultOpLedger.isOwn(opId);
 }
 function forgetAllOps() {
-  ours.clear();
+  defaultOpLedger.clear();
 }
 function rememberedOpCount() {
-  return ours.size;
+  return defaultOpLedger.size;
 }
 
 // src/store.generated.ts
@@ -6324,6 +6391,8 @@ function createRecordsClient(given) {
   const config = { ...given, dataSource: asRecordsDataSource(given.dataSource) };
   const schema = config.schema ?? DEFAULT_SCHEMA;
   const org = config.organizationId;
+  const ledger = config.opLedger ?? defaultOpLedger;
+  const mintOp = () => ledger.mint();
   const scream = sink(config);
   const BUNDLE_TTL_MS = 1e4;
   const BUNDLE_OPENERS = /* @__PURE__ */ new Set(["applicable_fields", "views", "view_look_read", "table_decorations", "row_actions", "reverse_columns", "record_change_actions", "grid_layout", "io_imports"]);
@@ -6710,14 +6779,14 @@ function createRecordsClient(given) {
     async recordWrite({ table_id, data }) {
       const result = await callDoor(
         DOORS.recordWrite,
-        { p_organization_id: org, p_table_id: table_id, p_data: { ...data, _op_id: mintOpId() } },
+        { p_organization_id: org, p_table_id: table_id, p_data: { ...data, _op_id: mintOp() } },
         "recordWrite"
       );
       if (result.ok && typeof result.data === "string") announceRecordChanged(result.data);
       return result;
     },
     async recordWriteMany({ table_id, rows: rows2, ids }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteMany,
         {
@@ -6730,7 +6799,7 @@ function createRecordsClient(given) {
       );
     },
     async recordChangeMany({ table_id, changes }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       const result = await callDoor(
         DOORS.recordChangeMany,
         {
@@ -6753,7 +6822,7 @@ function createRecordsClient(given) {
       return result;
     },
     async recordWriteGraph({ table_id, parent, children, edges }) {
-      const opId = mintOpId();
+      const opId = mintOp();
       return callDoor(
         DOORS.recordWriteGraph,
         {
@@ -6777,7 +6846,7 @@ function createRecordsClient(given) {
         {
           p_organization_id: org,
           p_record_id: record_id,
-          p_patch: { ...patch, _op_id: mintOpId() },
+          p_patch: { ...patch, _op_id: mintOp() },
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
         "recordUpdate"
@@ -6791,7 +6860,7 @@ function createRecordsClient(given) {
         {
           p_organization_id: org,
           p_record_id: record_id,
-          p_patch: { ...patch, _op_id: mintOpId() },
+          p_patch: { ...patch, _op_id: mintOp() },
           p_add: add,
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
@@ -7816,7 +7885,7 @@ function createRecordsClient(given) {
           p_table_id: table_id,
           p_key: keys,
           // The op id rides the envelope, as `recordWrite` / `recordUpdate` send it; each door takes it off.
-          p_data: { ...data, _op_id: mintOpId() },
+          p_data: { ...data, _op_id: mintOp() },
           ...expectedVersion === void 0 ? {} : { p_expected_version: expectedVersion }
         },
         "recordUpsert"