@ai-matrx/records 0.58.111 → 0.58.113

package/dist/react/index.d.cts

@@ -9854,6 +9854,16 @@ interface RecordsConfig {
      * needs one is sent NULL and refuses in its own words, never a guessed organization.
      */
     organizationId: Uuid | null;
+    /**
+     * EVERY organization the person belongs to (active-org-is-never-a-list-filter.md).
+     * `organizationId` above is where NEW things are written and which org a write
+     * runs in; it never decides what a READ shows. With this set, `tableList` /
+     * `tableFacts` span all of these organizations (or one, when the page passes
+     * its `organization_id` filter), and `tableRead` / `recordRead` /
+     * `recordValuesVersioned` open a record in ITS OWN organization. Absent ⇒ the
+     * client reads only `organizationId`, exactly as before.
+     */
+    organizationIds?: readonly Uuid[];
     realtime?: RecordsRealtimePort;
     onError?: RecordsErrorSink;
     resolver?: RecordsResolverPort;
@@ -10979,6 +10989,7 @@ interface RecordsClient {
     recordRead(args: {
         record_id: Uuid;
         withComputed?: boolean;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<RecordRead>>;
     /**
      * DOOR-1. A page of one Table's records THROUGH `custom.read_records`: the
@@ -11067,7 +11078,14 @@ interface RecordsClient {
         rows: ReadRow[];
         total: number | null;
     }>>;
-    tableList(): Promise<RecordsResult<Table[]>>;
+    /**
+     * Every Table the person can see across ALL their organizations
+     * (`config.organizationIds`); `organization_id` is the page's optional filter
+     * (absent = all). Each Table carries its own `organization_id`.
+     */
+    tableList(args?: {
+        organization_id?: Uuid | null;
+    }): Promise<RecordsResult<Table[]>>;
     /**
      * ONE Table's declaration by id — `null` when this reader may not see it or it is not a Table.
      * The same kernel record `tableList` lists, read through `read_records_by_ids` for exactly
@@ -11076,6 +11094,7 @@ interface RecordsClient {
      */
     tableRead(args: {
         table_id: Uuid;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<Table | null>>;
     /**
      * IS THIS TABLE IN THE ARCHIVE? (lane HUB-FIX, 2026-09-23.) The archived row for one
@@ -11103,7 +11122,9 @@ interface RecordsClient {
      * The door-presence pattern: when the store's catalogue does not carry the door the
      * answer is `null` — nothing asked, nothing invented.
      */
-    tableFacts(): Promise<RecordsResult<TableFact[] | null>>;
+    tableFacts(args?: {
+        organization_id?: Uuid | null;
+    }): Promise<RecordsResult<TableFact[] | null>>;
     /**
      * WHICH STORE CURRENTLY WRITES each table — `custom.where_tables_live`.
      *
@@ -12203,6 +12224,7 @@ interface RecordsClient {
      */
     recordValuesVersioned(args: {
         record_id: Uuid;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<ReadValue[]>>;
     metadataSearch(args: {
         text: string;

package/dist/react/index.d.ts

@@ -9854,6 +9854,16 @@ interface RecordsConfig {
      * needs one is sent NULL and refuses in its own words, never a guessed organization.
      */
     organizationId: Uuid | null;
+    /**
+     * EVERY organization the person belongs to (active-org-is-never-a-list-filter.md).
+     * `organizationId` above is where NEW things are written and which org a write
+     * runs in; it never decides what a READ shows. With this set, `tableList` /
+     * `tableFacts` span all of these organizations (or one, when the page passes
+     * its `organization_id` filter), and `tableRead` / `recordRead` /
+     * `recordValuesVersioned` open a record in ITS OWN organization. Absent ⇒ the
+     * client reads only `organizationId`, exactly as before.
+     */
+    organizationIds?: readonly Uuid[];
     realtime?: RecordsRealtimePort;
     onError?: RecordsErrorSink;
     resolver?: RecordsResolverPort;
@@ -10979,6 +10989,7 @@ interface RecordsClient {
     recordRead(args: {
         record_id: Uuid;
         withComputed?: boolean;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<RecordRead>>;
     /**
      * DOOR-1. A page of one Table's records THROUGH `custom.read_records`: the
@@ -11067,7 +11078,14 @@ interface RecordsClient {
         rows: ReadRow[];
         total: number | null;
     }>>;
-    tableList(): Promise<RecordsResult<Table[]>>;
+    /**
+     * Every Table the person can see across ALL their organizations
+     * (`config.organizationIds`); `organization_id` is the page's optional filter
+     * (absent = all). Each Table carries its own `organization_id`.
+     */
+    tableList(args?: {
+        organization_id?: Uuid | null;
+    }): Promise<RecordsResult<Table[]>>;
     /**
      * ONE Table's declaration by id — `null` when this reader may not see it or it is not a Table.
      * The same kernel record `tableList` lists, read through `read_records_by_ids` for exactly
@@ -11076,6 +11094,7 @@ interface RecordsClient {
      */
     tableRead(args: {
         table_id: Uuid;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<Table | null>>;
     /**
      * IS THIS TABLE IN THE ARCHIVE? (lane HUB-FIX, 2026-09-23.) The archived row for one
@@ -11103,7 +11122,9 @@ interface RecordsClient {
      * The door-presence pattern: when the store's catalogue does not carry the door the
      * answer is `null` — nothing asked, nothing invented.
      */
-    tableFacts(): Promise<RecordsResult<TableFact[] | null>>;
+    tableFacts(args?: {
+        organization_id?: Uuid | null;
+    }): Promise<RecordsResult<TableFact[] | null>>;
     /**
      * WHICH STORE CURRENTLY WRITES each table — `custom.where_tables_live`.
      *
@@ -12203,6 +12224,7 @@ interface RecordsClient {
      */
     recordValuesVersioned(args: {
         record_id: Uuid;
+        organization_id?: Uuid | null;
     }): Promise<RecordsResult<ReadValue[]>>;
     metadataSearch(args: {
         text: string;

package/dist/react/index.js

@@ -39679,6 +39679,51 @@ function createRecordsClient(config) {
       "recordRead"
     );
   }
+  const readOrgs = (filter) => {
+    if (filter) return [filter];
+    const all = [...org ? [org] : [], ...config.organizationIds ?? []];
+    const unique = [...new Set(all)];
+    return unique.length > 0 ? unique : [org];
+  };
+  const siblings = /* @__PURE__ */ new Map();
+  const clientFor = (target) => {
+    if (target === org) return client;
+    const key = target;
+    let sibling = siblings.get(key);
+    if (!sibling) {
+      sibling = createRecordsClient({ ...config, organizationId: target, organizationIds: [] });
+      siblings.set(key, sibling);
+    }
+    return sibling;
+  };
+  const recordOrgs = /* @__PURE__ */ new Map();
+  async function acrossOrgs(filter, ask, merge) {
+    const targets = readOrgs(filter);
+    if (targets.length === 1) return ask(clientFor(targets[0] ?? null));
+    const answers = await Promise.all(targets.map((t) => ask(clientFor(t))));
+    const parts = [];
+    let firstError = null;
+    for (const a of answers) {
+      if (a.ok) parts.push(a.data);
+      else firstError ??= a.error;
+    }
+    if (parts.length === 0 && firstError) return err(firstError);
+    return ok(merge(parts));
+  }
+  async function openInOwnOrg(recordId, filter, ask, found) {
+    const known = recordOrgs.get(recordId);
+    const targets = filter ? [filter] : known !== void 0 ? [known, ...readOrgs().filter((t) => t !== known)] : readOrgs();
+    let last = null;
+    for (const t of targets) {
+      const answer = await ask(clientFor(t));
+      if (answer.ok && found(answer.data)) {
+        recordOrgs.set(recordId, t);
+        return answer;
+      }
+      last ??= answer;
+    }
+    return last;
+  }
   const client = {
     config,
     async recordWrite({ table_id, data }) {
@@ -39807,7 +39852,18 @@ function createRecordsClient(config) {
         "tableArchive"
       );
     },
-    async recordRead({ record_id, withComputed = false }) {
+    async recordRead({ record_id, withComputed = false, organization_id }) {
+      if (organization_id && organization_id !== org) {
+        return clientFor(organization_id).recordRead({ record_id, withComputed, organization_id });
+      }
+      if (readOrgs(organization_id).length > 1) {
+        return openInOwnOrg(
+          record_id,
+          organization_id,
+          (sub) => sub.recordRead({ record_id, withComputed, organization_id: sub.config.organizationId }),
+          () => true
+        );
+      }
       const door = await callDoor(
         DOORS.readRecord,
         { p_organization_id: org, p_record_id: record_id },
@@ -39843,8 +39899,18 @@ function createRecordsClient(config) {
         })
       );
     },
-    async tableFacts() {
+    async tableFacts(args) {
       if (!doorExists(DOORS.tableFacts)) return ok(null);
+      if (args?.organization_id && args.organization_id !== org) {
+        return clientFor(args.organization_id).tableFacts(args);
+      }
+      if (readOrgs(args?.organization_id).length > 1) {
+        return acrossOrgs(
+          args?.organization_id,
+          (sub) => sub.tableFacts({ organization_id: sub.config.organizationId }),
+          (parts) => parts.flatMap((p) => p ?? [])
+        );
+      }
       return callDoor(DOORS.tableFacts, { p_organization_id: org }, "tableFacts");
     },
     async tablesLiveWhere({ table_ids }) {
@@ -40104,7 +40170,18 @@ function createRecordsClient(config) {
         offset: plan.read.offset
       });
     },
-    async tableRead({ table_id }) {
+    async tableRead({ table_id, organization_id }) {
+      if (organization_id && organization_id !== org) {
+        return clientFor(organization_id).tableRead({ table_id, organization_id });
+      }
+      if (readOrgs(organization_id).length > 1) {
+        return openInOwnOrg(
+          table_id,
+          organization_id,
+          (sub) => sub.tableRead({ table_id, organization_id: sub.config.organizationId }),
+          (t) => t !== null
+        );
+      }
       const kernel = await tableKernel("tableRead.kernel");
       if (!kernel.ok) return err(kernel.error);
       const door = await callDoor(
@@ -40118,7 +40195,19 @@ function createRecordsClient(config) {
       const { document: document2 } = unfold(row.document);
       return ok({ ...document2, id: row.id, organization_id: org });
     },
-    async tableList() {
+    async tableList(args) {
+      if (args?.organization_id && args.organization_id !== org) {
+        return clientFor(args.organization_id).tableList(args);
+      }
+      if (readOrgs(args?.organization_id).length > 1) {
+        const merged = await acrossOrgs(
+          args?.organization_id,
+          (sub) => sub.tableList({ organization_id: sub.config.organizationId }),
+          (parts) => parts.flat()
+        );
+        if (merged.ok) merged.data.sort((a, b) => (a.name ?? "").localeCompare(b.name ?? ""));
+        return merged;
+      }
       const kernel = await tableKernel("tableList.kernel");
       if (!kernel.ok) return err(kernel.error);
       const door = await callDoor(
@@ -41173,7 +41262,18 @@ function createRecordsClient(config) {
         answered.data.map((row) => ({ ...row, id: row["signature_id"] }))
       );
     },
-    async recordValuesVersioned({ record_id }) {
+    async recordValuesVersioned({ record_id, organization_id }) {
+      if (organization_id && organization_id !== org) {
+        return clientFor(organization_id).recordValuesVersioned({ record_id, organization_id });
+      }
+      if (readOrgs(organization_id).length > 1) {
+        return openInOwnOrg(
+          record_id,
+          organization_id,
+          (sub) => sub.recordValuesVersioned({ record_id, organization_id: sub.config.organizationId }),
+          (values) => values.length > 0
+        );
+      }
       return readValues(record_id);
     },
     async revisions({ record_id }) {
@@ -41183,7 +41283,7 @@ function createRecordsClient(config) {
         "revisions"
       );
     },
-    async recordScopeContext({ record_id, relations, history, siblings }) {
+    async recordScopeContext({ record_id, relations, history, siblings: siblings2 }) {
       return callDoor(
         DOORS.recordScopeContext,
         {
@@ -41191,7 +41291,7 @@ function createRecordsClient(config) {
           p_record_id: record_id,
           p_relations: relations ?? 12,
           p_history: history ?? 15,
-          p_siblings: siblings ?? 8
+          p_siblings: siblings2 ?? 8
         },
         "recordScopeContext"
       );
@@ -41221,7 +41321,7 @@ function createRecordsClient(config) {
         "conversationScopeUnbind"
       );
     },
-    async conversationScopeContext({ conversation_id, relations, history, siblings }) {
+    async conversationScopeContext({ conversation_id, relations, history, siblings: siblings2 }) {
       return callDoor(
         DOORS.conversationScopeContext,
         {
@@ -41229,7 +41329,7 @@ function createRecordsClient(config) {
           p_conversation_id: conversation_id,
           p_relations: relations ?? 12,
           p_history: history ?? 15,
-          p_siblings: siblings ?? 8
+          p_siblings: siblings2 ?? 8
         },
         "conversationScopeContext"
       );