@ai-matrx/records 0.60.7 → 0.60.9

package/dist/core/index.d.cts

@@ -2549,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;
@@ -2559,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

@@ -2549,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;
@@ -2559,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

@@ -44264,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) {
@@ -44284,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 {