@ai-matrx/records 0.60.6 → 0.60.9

package/dist/core/index.d.cts

@@ -2120,18 +2120,26 @@ interface RecordsClient {
         limit?: number;
     }): Promise<RecordsResult<IoExportPage>>;
     /** G5. That page as an .xlsx; a withheld column is named on its own sheet. */
-    /** G9. Every table a picker may offer here, from BOTH stores, each saying which store opens it. */
-    tableListEverywhere(): Promise<RecordsResult<{
+    /**
+     * G9. Every table a picker may offer here, from BOTH stores, each saying which store opens it.
+     * A table the app keeps out of default lists (`custom.table_kept_out_of_lists`: an agent's
+     * outputs) is left out unless `include_app_tables` is true — the "Show app tables" switch.
+     */
+    tableListEverywhere(args?: {
+        include_app_tables?: boolean;
+    }): Promise<RecordsResult<{
         success: boolean;
         tables: TableListEntry[];
     }>>;
     /**
      * Every table the person reaches (`custom.data_home_tables`), as the data home lists them.
      * `organization_id` names one organization; `null` asks for every organization the person
-     * reaches — never the client's bound organization by default.
+     * reaches — never the client's bound organization by default. A table the app keeps out of
+     * default lists (an agent's outputs) is answered only with `include_app_tables: true`.
      */
     dataHomeTables(args: {
         organization_id: Uuid | null;
+        include_app_tables?: boolean;
     }): Promise<RecordsResult<DataHomeTable[]>>;
     /**
      * G10. Refresh a synced source (a sheet tab) into ONE Table under `home_id`: new rows added,
@@ -2541,6 +2549,18 @@ interface NewFieldSpec {
      * `recordUpsert` finds a record by must carry it.
      */
     unique?: boolean;
+    /**
+     * An EXISTING choice list's Table — the column uses those very option records instead of making a
+     * new list (a drafts table copying its source table's column keeps the same choices). Sent as
+     * `config.options_table_id`.
+     */
+    optionsTableId?: Uuid;
+    /**
+     * Anything else `custom.field_declare` accepts, passed through verbatim and applied LAST (a stored
+     * Field document copied key for key, `format`, `sensitivity`, `via` / `pick` / `agg` / `of`, …).
+     * The store judges every key; a word it does not take is refused by name.
+     */
+    declaration?: Partial<NewFieldDeclaration> & Record<string, unknown>;
 }
 interface NewTableSpec {
     name: string;
@@ -2551,6 +2571,24 @@ interface NewTableSpec {
     /** The Field whose value is the record's title (REC-2). Defaults to the first Field. */
     titleField?: string;
     fields?: NewFieldSpec[];
+    /**
+     * `ensureTable` only: put a NEW table in this existing Home (one the caller may change, in this
+     * organization) instead of making a Home for it. A table that already exists stays where it is.
+     */
+    homeId?: Uuid;
+    /** SC-1 placement: the app (one of its features) keeps this table, not the organization. */
+    keptByTheApp?: boolean;
+    /**
+     * WHICH feature keeps it, one lower-case word (`agent_output`, `context`, …). `ensureTable` finds a
+     * table by slug AND this word: a person's table of the same slug is a different table.
+     */
+    keptFor?: string;
+    /** The content kind whose outputs this table holds. */
+    kind?: string;
+    /** A drafts table: the Table its records are drafts of. */
+    draftsFor?: Uuid;
+    /** A drafts table: that Table's stamp when the drafts table last matched it. */
+    draftsStamp?: string;
 }
 /**
  * What `ensureTable` answers: `declareTable`'s answer, plus whether this call MADE the table and

package/dist/core/index.d.ts

@@ -2120,18 +2120,26 @@ interface RecordsClient {
         limit?: number;
     }): Promise<RecordsResult<IoExportPage>>;
     /** G5. That page as an .xlsx; a withheld column is named on its own sheet. */
-    /** G9. Every table a picker may offer here, from BOTH stores, each saying which store opens it. */
-    tableListEverywhere(): Promise<RecordsResult<{
+    /**
+     * G9. Every table a picker may offer here, from BOTH stores, each saying which store opens it.
+     * A table the app keeps out of default lists (`custom.table_kept_out_of_lists`: an agent's
+     * outputs) is left out unless `include_app_tables` is true — the "Show app tables" switch.
+     */
+    tableListEverywhere(args?: {
+        include_app_tables?: boolean;
+    }): Promise<RecordsResult<{
         success: boolean;
         tables: TableListEntry[];
     }>>;
     /**
      * Every table the person reaches (`custom.data_home_tables`), as the data home lists them.
      * `organization_id` names one organization; `null` asks for every organization the person
-     * reaches — never the client's bound organization by default.
+     * reaches — never the client's bound organization by default. A table the app keeps out of
+     * default lists (an agent's outputs) is answered only with `include_app_tables: true`.
      */
     dataHomeTables(args: {
         organization_id: Uuid | null;
+        include_app_tables?: boolean;
     }): Promise<RecordsResult<DataHomeTable[]>>;
     /**
      * G10. Refresh a synced source (a sheet tab) into ONE Table under `home_id`: new rows added,
@@ -2541,6 +2549,18 @@ interface NewFieldSpec {
      * `recordUpsert` finds a record by must carry it.
      */
     unique?: boolean;
+    /**
+     * An EXISTING choice list's Table — the column uses those very option records instead of making a
+     * new list (a drafts table copying its source table's column keeps the same choices). Sent as
+     * `config.options_table_id`.
+     */
+    optionsTableId?: Uuid;
+    /**
+     * Anything else `custom.field_declare` accepts, passed through verbatim and applied LAST (a stored
+     * Field document copied key for key, `format`, `sensitivity`, `via` / `pick` / `agg` / `of`, …).
+     * The store judges every key; a word it does not take is refused by name.
+     */
+    declaration?: Partial<NewFieldDeclaration> & Record<string, unknown>;
 }
 interface NewTableSpec {
     name: string;
@@ -2551,6 +2571,24 @@ interface NewTableSpec {
     /** The Field whose value is the record's title (REC-2). Defaults to the first Field. */
     titleField?: string;
     fields?: NewFieldSpec[];
+    /**
+     * `ensureTable` only: put a NEW table in this existing Home (one the caller may change, in this
+     * organization) instead of making a Home for it. A table that already exists stays where it is.
+     */
+    homeId?: Uuid;
+    /** SC-1 placement: the app (one of its features) keeps this table, not the organization. */
+    keptByTheApp?: boolean;
+    /**
+     * WHICH feature keeps it, one lower-case word (`agent_output`, `context`, …). `ensureTable` finds a
+     * table by slug AND this word: a person's table of the same slug is a different table.
+     */
+    keptFor?: string;
+    /** The content kind whose outputs this table holds. */
+    kind?: string;
+    /** A drafts table: the Table its records are drafts of. */
+    draftsFor?: Uuid;
+    /** A drafts table: that Table's stamp when the drafts table last matched it. */
+    draftsStamp?: string;
 }
 /**
  * What `ensureTable` answers: `declareTable`'s answer, plus whether this call MADE the table and

package/dist/core/index.js

@@ -44109,17 +44109,18 @@ function createRecordsClient(given) {
         "tableFromExample"
       );
     },
-    async tableListEverywhere() {
+    async tableListEverywhere(args) {
       return callDoor(
         DOORS.tableListEverywhere,
-        { p_organization_id: org },
+        // The two-argument overload is chosen by naming both arguments (CHAIR-DOORS-2, N-C8).
+        args?.include_app_tables ? { p_organization_id: org, p_include_app_tables: true } : { p_organization_id: org },
         "tableListEverywhere"
       );
     },
-    async dataHomeTables({ organization_id }) {
+    async dataHomeTables({ organization_id, include_app_tables }) {
       return callDoor(
         DOORS.dataHomeTables,
-        { p_organization_id: organization_id },
+        include_app_tables ? { p_organization_id: organization_id, p_include_app_tables: true } : { p_organization_id: organization_id },
         "dataHomeTables"
       );
     },
@@ -44263,7 +44264,9 @@ function fieldDeclarationFor(field) {
     ...field.unit ? { unit: field.unit } : {},
     ...field.kind ? { kind: field.kind } : {},
     ...field.allowedTypes ? { allowed_types: field.allowedTypes } : {},
-    ...field.unique ? { rules: [{ kind: "unique" }] } : {}
+    ...field.unique ? { rules: [{ kind: "unique" }] } : {},
+    ...field.optionsTableId ? { config: { ...field.config ?? {}, options_table_id: field.optionsTableId } } : {},
+    ...field.declaration ?? {}
   };
 }
 function tableSpecFor(spec, fields, slug) {
@@ -44283,14 +44286,23 @@ function tableSpecFor(spec, fields, slug) {
     // AGT-1: a table a person made is agent-writable by declaration; the
     // organization turns it off, never this package.
     agent_writable: true,
-    default_sort: [{ field: titleField, direction: "asc" }]
+    default_sort: [{ field: titleField, direction: "asc" }],
+    ...spec.keptByTheApp !== void 0 ? { kept_by_the_app: spec.keptByTheApp } : {},
+    ...spec.keptFor ? { kept_for: spec.keptFor } : {},
+    ...spec.kind ? { kind: spec.kind } : {},
+    ...spec.draftsFor ? { drafts_for: spec.draftsFor } : {},
+    ...spec.draftsStamp ? { drafts_stamp: spec.draftsStamp } : {}
   };
 }
 async function ensureTable(client, spec) {
   const fields = spec.fields && spec.fields.length > 0 ? spec.fields : DEFAULT_FIELDS;
   const slug = spec.slug ?? tokenFor(spec.name);
   const ensured = await client.tableEnsure({
-    spec: { ...tableSpecFor(spec, fields, slug), fields: fields.map(fieldDeclarationFor) }
+    spec: {
+      ...tableSpecFor(spec, fields, slug),
+      ...spec.homeId ? { home_id: spec.homeId } : {},
+      fields: fields.map(fieldDeclarationFor)
+    }
   });
   if (!ensured.ok) return ensured;
   return {