@ai-matrx/records 0.72.12 → 0.72.23

package/dist/{ports-DKBvsoya.d.cts → ports-DKOk7AT2.d.cts}

@@ -1020,4 +1020,4 @@ interface RecordsConfig {
     knownDoors?: readonly string[];
 }
 
-export { type SubscriptionBlock as $, type AggregateCompare as A, type BookingSummary as B, type DashboardTarget as C, type DashboardSummary as D, type DashboardTargetBase as E, type FormSummary as F, type DashboardTargetOp as G, type DashboardTargetResult as H, type DashboardTotals as I, type RecordsActor as J, type RecordsChangeSink as K, type RecordsErrorSink as L, type MySubscription as M, type RecordsFilter as N, type RecordsRealtimePort as O, type RecordsResolverPort as P, type QuietHours as Q, type RecordsConfig as R, type StoreFilter as S, type RecordsResponse as T, type RecordsTableQuery as U, type Rule as V, type RuleAnswer as W, type RuleExpression as X, type SavedViewColorBy as Y, type SavedViewDefinition as Z, type SavedViewLayout as _, type BookingAvailability as a, bookingPath as a0, callersTimeZone as a1, hasQuietHours as a2, isRuleFilter as a3, liftWithheld as a4, measureKey as a5, publicFormPath as a6, stableFilterKey as a7, withCallersClock as a8, type BookingDeclared as b, type DashboardBlock as c, type RecordFilter as d, type AggregateBucket as e, type DashboardRunResult as f, type StuckRow as g, type AggregateMeasure as h, type AggregateRow as i, type Subscription as j, type SubscriptionSpec as k, type DigestPreview as l, type SavedViewRow as m, type SavedViewSpecIn as n, type RowTemplateRow as o, type DashboardBlockKind as p, type AggregateFilter as q, type SubscriptionCadence as r, type AggregateOperation as s, type RecordsDataSource as t, type AggregateCompareKind as u, type AggregateCompareWindows as v, type AggregateDelta as w, type AggregateWindow as x, type BookingWindow as y, type DashboardBlockResult as z };
+export { type SubscriptionBlock as $, type AggregateOperation as A, type BookingSummary as B, type DashboardTarget as C, type DashboardBlockKind as D, type DashboardTargetBase as E, type FormSummary as F, type DashboardTargetOp as G, type DashboardTargetResult as H, type DashboardTotals as I, type RecordsActor as J, type RecordsChangeSink as K, type RecordsErrorSink as L, type MySubscription as M, type RecordsFilter as N, type RecordsRealtimePort as O, type RecordsResolverPort as P, type QuietHours as Q, type RecordsConfig as R, type SubscriptionCadence as S, type RecordsResponse as T, type RecordsTableQuery as U, type Rule as V, type RuleAnswer as W, type RuleExpression as X, type SavedViewColorBy as Y, type SavedViewDefinition as Z, type SavedViewLayout as _, type AggregateFilter as a, bookingPath as a0, callersTimeZone as a1, hasQuietHours as a2, isRuleFilter as a3, liftWithheld as a4, measureKey as a5, publicFormPath as a6, stableFilterKey as a7, withCallersClock as a8, type AggregateMeasure as b, type AggregateBucket as c, type StoreFilter as d, type BookingAvailability as e, type BookingDeclared as f, type DashboardSummary as g, type DashboardBlock as h, type RecordFilter as i, type AggregateCompare as j, type DashboardRunResult as k, type StuckRow as l, type AggregateRow as m, type Subscription as n, type SubscriptionSpec as o, type DigestPreview as p, type SavedViewRow as q, type SavedViewSpecIn as r, type RowTemplateRow as s, type RecordsDataSource as t, type AggregateCompareKind as u, type AggregateCompareWindows as v, type AggregateDelta as w, type AggregateWindow as x, type BookingWindow as y, type DashboardBlockResult as z };

package/dist/{ports-Bhu2Q3V0.d.ts → ports-Df3VghxK.d.ts}

@@ -1020,4 +1020,4 @@ interface RecordsConfig {
     knownDoors?: readonly string[];
 }
 
-export { type SubscriptionBlock as $, type AggregateCompare as A, type BookingSummary as B, type DashboardTarget as C, type DashboardSummary as D, type DashboardTargetBase as E, type FormSummary as F, type DashboardTargetOp as G, type DashboardTargetResult as H, type DashboardTotals as I, type RecordsActor as J, type RecordsChangeSink as K, type RecordsErrorSink as L, type MySubscription as M, type RecordsFilter as N, type RecordsRealtimePort as O, type RecordsResolverPort as P, type QuietHours as Q, type RecordsConfig as R, type StoreFilter as S, type RecordsResponse as T, type RecordsTableQuery as U, type Rule as V, type RuleAnswer as W, type RuleExpression as X, type SavedViewColorBy as Y, type SavedViewDefinition as Z, type SavedViewLayout as _, type BookingAvailability as a, bookingPath as a0, callersTimeZone as a1, hasQuietHours as a2, isRuleFilter as a3, liftWithheld as a4, measureKey as a5, publicFormPath as a6, stableFilterKey as a7, withCallersClock as a8, type BookingDeclared as b, type DashboardBlock as c, type RecordFilter as d, type AggregateBucket as e, type DashboardRunResult as f, type StuckRow as g, type AggregateMeasure as h, type AggregateRow as i, type Subscription as j, type SubscriptionSpec as k, type DigestPreview as l, type SavedViewRow as m, type SavedViewSpecIn as n, type RowTemplateRow as o, type DashboardBlockKind as p, type AggregateFilter as q, type SubscriptionCadence as r, type AggregateOperation as s, type RecordsDataSource as t, type AggregateCompareKind as u, type AggregateCompareWindows as v, type AggregateDelta as w, type AggregateWindow as x, type BookingWindow as y, type DashboardBlockResult as z };
+export { type SubscriptionBlock as $, type AggregateOperation as A, type BookingSummary as B, type DashboardTarget as C, type DashboardBlockKind as D, type DashboardTargetBase as E, type FormSummary as F, type DashboardTargetOp as G, type DashboardTargetResult as H, type DashboardTotals as I, type RecordsActor as J, type RecordsChangeSink as K, type RecordsErrorSink as L, type MySubscription as M, type RecordsFilter as N, type RecordsRealtimePort as O, type RecordsResolverPort as P, type QuietHours as Q, type RecordsConfig as R, type SubscriptionCadence as S, type RecordsResponse as T, type RecordsTableQuery as U, type Rule as V, type RuleAnswer as W, type RuleExpression as X, type SavedViewColorBy as Y, type SavedViewDefinition as Z, type SavedViewLayout as _, type AggregateFilter as a, bookingPath as a0, callersTimeZone as a1, hasQuietHours as a2, isRuleFilter as a3, liftWithheld as a4, measureKey as a5, publicFormPath as a6, stableFilterKey as a7, withCallersClock as a8, type AggregateMeasure as b, type AggregateBucket as c, type StoreFilter as d, type BookingAvailability as e, type BookingDeclared as f, type DashboardSummary as g, type DashboardBlock as h, type RecordFilter as i, type AggregateCompare as j, type DashboardRunResult as k, type StuckRow as l, type AggregateRow as m, type Subscription as n, type SubscriptionSpec as o, type DigestPreview as p, type SavedViewRow as q, type SavedViewSpecIn as r, type RowTemplateRow as s, type RecordsDataSource as t, type AggregateCompareKind as u, type AggregateCompareWindows as v, type AggregateDelta as w, type AggregateWindow as x, type BookingWindow as y, type DashboardBlockResult as z };

package/dist/{table-kind-D6Lz7ebE.d.ts → table-kind-CD9B1vtx.d.ts}

@@ -1,5 +1,5 @@
 import { n as ReadRow, g as Timestamp, U as Uuid, h as RecordDocument, R as RelationFlavor, O as OnDelete, aK as RelationBinding, f as RelationCardinality, i as RecordsResult, r as StoredRecord, q as Field, az as ParityFieldType, T as TableType, a as TableDisplay, S as StorageMode, b0 as TableOrigin, z as RecordsError } from './field-CekLWOPw.js';
-import { t as RecordsDataSource } from './ports-Bhu2Q3V0.js';
+import { t as RecordsDataSource } from './ports-Df3VghxK.js';
 
 /**
  * THE TWO LANES THE ARCHIVED-ITEMS LAW NAMES (Arman, 2026-09-09) — the same

package/dist/{table-kind-D6VOew74.d.cts → table-kind-e-g5kGXV.d.cts}

@@ -1,5 +1,5 @@
 import { n as ReadRow, g as Timestamp, U as Uuid, h as RecordDocument, R as RelationFlavor, O as OnDelete, aK as RelationBinding, f as RelationCardinality, i as RecordsResult, r as StoredRecord, q as Field, az as ParityFieldType, T as TableType, a as TableDisplay, S as StorageMode, b0 as TableOrigin, z as RecordsError } from './field-CekLWOPw.cjs';
-import { t as RecordsDataSource } from './ports-DKBvsoya.cjs';
+import { t as RecordsDataSource } from './ports-DKOk7AT2.cjs';
 
 /**
  * THE TWO LANES THE ARCHIVED-ITEMS LAW NAMES (Arman, 2026-09-09) — the same

package/dist/templates/index.cjs

@@ -37,6 +37,7 @@ __export(templates_exports, {
   RECORDS_UI_FIELD_SURFACES: () => RECORDS_UI_FIELD_SURFACES,
   RECORDS_UI_VIEW_LAYOUTS: () => RECORDS_UI_VIEW_LAYOUTS,
   RELATIVE_DATE: () => RELATIVE_DATE,
+  RESOLVABLE_FIELD_TYPE_WORDS: () => RESOLVABLE_FIELD_TYPE_WORDS,
   SERVER_DATE_GRAMMAR: () => SERVER_DATE_GRAMMAR,
   SHARED_BLOCKS: () => SHARED_BLOCKS,
   SHARED_BLOCK_IDS: () => SHARED_BLOCK_IDS,
@@ -3601,6 +3602,12 @@ function validateTemplate(raw, options = {}) {
     seedLooks.add(p);
     problems.push(p);
   };
+  const galleryBar = /* @__PURE__ */ new WeakSet();
+  const sayGallery = (at, says) => {
+    const p = { at, says };
+    galleryBar.add(p);
+    problems.push(p);
+  };
   const tz = raw.business?.timezone || "UTC";
   const tablesRaw = allTables(raw);
   const ISO_DAY = /\b\d{4}-\d{2}-\d{2}\b/;
@@ -3923,7 +3930,7 @@ function validateTemplate(raw, options = {}) {
       say(`${tat}.rows`, `Only ${titles.size} of ${table.rows.length} rows have a title of their own; a list of look-alike names reads as generated.`);
     }
   });
-  if (!hasLookupOrRollup) say("tables", "At least one relationship has to be read across: add a lookup or a rollup through a relation field.");
+  if (!hasLookupOrRollup) sayGallery("tables", "At least one relationship has to be read across: add a lookup or a rollup through a relation field.");
   if (main) {
     const normTitle = (v) => (storeText(v) ?? "").toLowerCase().replace(/\s+/g, " ").trim();
     const rows = main.rows;
@@ -3991,8 +3998,8 @@ function validateTemplate(raw, options = {}) {
     else surfaces.set(token, { at, ...table ? { table } : {} });
   };
   const views = spec.views ?? [];
-  if (views.length < 3) say("views", `A template shows at least three views; this one has ${views.length}.`);
-  if (!views.some((v) => v.kind === "grid")) say("views", "One of the views is a grid \u2014 the table everyone recognises.");
+  if (views.length < 3) sayGallery("views", `A template shows at least three views; this one has ${views.length}.`);
+  if (!views.some((v) => v.kind === "grid")) sayGallery("views", "One of the views is a grid \u2014 the table everyone recognises.");
   views.forEach((view, i) => {
     const at = `views[${i}] (${view.token})`;
     claim(view.token, at, view.table);
@@ -4118,7 +4125,7 @@ function validateTemplate(raw, options = {}) {
     }
   };
   const extras = spec.extras ?? [];
-  if (extras.length < 2) say("extras", `A template carries at least two extras; this one has ${extras.length}.`);
+  if (extras.length < 2) sayGallery("extras", `A template carries at least two extras; this one has ${extras.length}.`);
   const formTokens = new Set(forms.map((f) => f.token));
   const viewTokens = new Set(views.map((v) => v.token));
   const docTokens = new Set(extras.filter((e) => e.kind === "document").map((e) => e.token));
@@ -4467,7 +4474,8 @@ function validateTemplate(raw, options = {}) {
       if (here >= 0 && Number.isFinite(firstWhen) && here < firstWhen && !TERMINAL_STAGE.test(st)) {
         for (const k of rule.filled ?? []) {
           if (!/^(?:datetime|date|checkbox|signature|attachment)$/.test(fieldOf(table, k)?.parityType ?? "")) continue;
-          if (filled(row.values?.[k])) say(at, `"${row.key}" is ${st}, but already has "${fieldOf(table, k)?.label ?? k}", which only a ${rule.when.join("/")} record carries. Leave it empty until the record gets there.`);
+          const v = row.values?.[k];
+          if (fieldOf(table, k)?.parityType === "checkbox" ? v === true || v === "true" : filled(v)) say(at, `"${row.key}" is ${st}, but already has "${fieldOf(table, k)?.label ?? k}", which only a ${rule.when.join("/")} record carries. Leave it empty until the record gets there.`);
         }
       }
       if (!rule.when.includes(st)) continue;
@@ -4805,6 +4813,7 @@ function validateTemplate(raw, options = {}) {
               }
             }
             adds += 1;
+            for (const f of table.fields) if (f.default !== void 0 && !isComputed(f) && values[f.key] === void 0) values[f.key] = f.default;
             const added = { key: `walk-${i}-${ri}`, values };
             const landed = rules ? storeText(values[rules.stageField]) : null;
             for (const k of landed ? rules?.requires?.[landed] ?? [] : []) if (!filled(values[k])) say(`${at}.action.rows[${ri}]`, `The new row "${keyValue}" lands in "${landed}", which needs "${k}" filled; the store would refuse it.`);
@@ -5128,7 +5137,8 @@ function validateTemplate(raw, options = {}) {
       const at = `tables (${t.token}).fields (${f.key})`;
       const text2 = `${f.key} ${norm(f.label)}`;
       const e = effective(t.token, f);
-      const criminalCharges = /(^|_)charges?($|_)/.test(f.key) && behaviorOf(f) === "text";
+      const billingTable = /(invoice|bill|statement|receipt|payment|charge|fee|order|account)/i.test(`${t.token} ${t.labelSingular}`);
+      const criminalCharges = /(^|_)charges?($|_)/.test(f.key) && behaviorOf(f) === "text" && !billingTable;
       const phoneLike = behaviorOf(f) === "text" && /\b(cell|mobile|phone)\b/.test(norm(f.label));
       const personal = PERSONAL_ONLY.test(f.key) || /\b(medical conditions?|medications?|diagnos[ie]s)\b/.test(norm(f.label));
       const floored = (RESTRICTED_KEY.test(f.key) || RESTRICTED_LABEL.test(norm(f.label)) || criminalCharges) && (!personal || holdsPeople(t));
@@ -5432,7 +5442,8 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
     const qq = agent.question;
     const ask = norm(qq.ask);
     const words = (t) => norm(t).split(" ").filter((w) => w.length >= 4);
-    const mentions = (t) => words(t).some((w) => ask.includes(w.replace(/s$/, "")));
+    const askWords = new Set(ask.split(" "));
+    const mentions = (t) => !!norm(t) && ask.includes(norm(t)) || words(t).some((w) => ask.includes(w.replace(/s$/, ""))) || words(t).length === 0 && norm(t).split(" ").filter(Boolean).some((w) => w.length >= 3 && (askWords.has(w) || askWords.has(`${w}s`)));
     for (const [k, v] of Object.entries(qq.expect.filter ?? {})) {
       if (typeof v === "string" && !mentions(v) && !ask.includes(norm(v))) say("agent.question.ask", `It filters on ${k} = "${v}", and the question never says so.`);
     }
@@ -5513,7 +5524,8 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
     const named = (t) => {
       if (!t) return false;
       if (says.includes(norm(t))) return true;
-      const words = [...new Set(norm(t).split(" ").filter((w) => w.length >= 4))];
+      const long = [...new Set(norm(t).split(" ").filter((w) => w.length >= 4))];
+      const words = long.length ? long : [...new Set(norm(t).split(" ").filter((w) => w.length >= 2))];
       const said = new Set(says.split(" "));
       return words.length > 0 && words.filter((w) => said.has(w) || said.has(`${w}s`)).length >= Math.min(2, words.length);
     };
@@ -5929,7 +5941,7 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
       if (bothDates && !datesStated) say(`${at}.childDates`, `"${t.token}" and its ${rel.label.toLowerCase()} ("${parent.token}") both carry dates; say how they agree, e.g. {"relation": "${rel.key}", "field": "<this table's date>", "parentField": "<${parent.token}'s date>"} or say why they are independent in independentOf {"${rel.key}": "<reason>"}.`);
       if (bothStatus && !statusStated) say(`${at}.statusAgrees`, `"${t.token}" and its ${rel.label.toLowerCase()} ("${parent.token}") both carry a status; say which child statuses need which parent status (statusAgrees), e.g. a Closed deal means a Sold listing.`);
     }
-    for (const f of t.fields.filter((x) => isNumber(x) && !isComputed(x) && /(^|_)(count|roster_size|size|number_of|enrolled|headcount|players|members)($|_)/.test(x.key))) {
+    for (const f of t.fields.filter((x) => isNumber(x) && !isComputed(x) && /(^|_)(count|roster_size|team_size|class_size|number_of|enrolled|headcount|players|members)($|_)/.test(x.key))) {
       const linked = own.find((c) => c.fields.some((cf) => isRelation(cf) && cf.relationTarget === t.token));
       const declared = (t.countMatches ?? []).find((c) => c.field === f.key);
       const linkers = own.filter((c) => c.fields.some((cf) => isRelation(cf) && cf.relationTarget === t.token)).map((c) => c.labelPlural.toLowerCase());
@@ -5964,7 +5976,7 @@ ${e.body}`.matchAll(MERGE_TOKEN)].map((m) => m[1]));
     const describeOwes = (p) => {
       const root = p.at.split(/[.\s[(]/)[0];
       if (GALLERY_ONLY_ROOTS.includes(root)) return false;
-      if (seedLooks.has(p)) return false;
+      if (seedLooks.has(p) || galleryBar.has(p)) return false;
       if (/^tables\[\d+\] \([^)]*\)\.rows$/.test(p.at)) return false;
       return true;
     };
@@ -6063,7 +6075,14 @@ function compileInstallPlan(written) {
   const attachments = written.attachments ?? [];
   const attachmentKeys = new Set(attachments.map((a) => a.key));
   const spec = tokenizeValues({ ...written, attachments: void 0 }, attachmentKeys);
-  const tables = allTables(spec);
+  const bound = new Map(allTables(spec).filter((t) => t.bindsTo?.tableId).map((t) => [t.token, t.bindsTo]));
+  const has = (token, key) => bound.get(token)?.fields.includes(key) ?? false;
+  const tables = allTables(spec).map((t) => {
+    if (bound.has(t.token)) return { ...t, rows: [] };
+    const toBound = t.fields.filter((f) => f.parityType === "relation" && f.relationTarget && bound.has(f.relationTarget)).map((f) => f.key);
+    if (!toBound.length) return t;
+    return { ...t, rows: t.rows.map((r) => ({ ...r, values: Object.fromEntries(Object.entries(r.values ?? {}).filter(([k]) => !toBound.includes(k))) })) };
+  });
   const steps = [];
   const tableRef = (token) => {
     if (!tables.some((t) => t.token === token)) throw new Error(`The template names a table "${token}" it does not have.`);
@@ -6093,6 +6112,18 @@ function compileInstallPlan(written) {
     }
   }
   for (const t of tables) {
+    if (bound.has(t.token)) {
+      for (const f of t.fields.filter((x) => !DERIVED.has(x.parityType) && x.parityType !== "formula" && x.parityType !== "relation" && !isSelfDeclaredField(x) && !has(t.token, x.key))) {
+        steps.push({
+          label: `bound.${t.token}.${f.key}`,
+          door: "field_declare",
+          args: { p_organization_id: "${org}", p_table_id: tableRef(t.token), p_spec: selfDeclaredFieldSpec(f) },
+          save: { [`fields.${t.token}.${f.key}`]: [] },
+          made: [{ kind: "field", ref: `fields.${t.token}.${f.key}`, table: `tables.${t.token}` }]
+        });
+      }
+      continue;
+    }
     steps.push({
       label: `tables.${t.token}`,
       door: "table_from_example",
@@ -6103,7 +6134,7 @@ function compileInstallPlan(written) {
   }
   steps.push(...membersAddRowsSteps(spec, tableRef));
   for (const t of tables) {
-    for (const f of t.fields.filter((x) => x.parityType === "relation" && x.relationTarget)) {
+    for (const f of t.fields.filter((x) => x.parityType === "relation" && x.relationTarget && !has(t.token, x.key))) {
       steps.push({
         label: `relations.${t.token}.${f.key}`,
         door: "field_declare",
@@ -6114,7 +6145,7 @@ function compileInstallPlan(written) {
     }
   }
   for (const t of tables) {
-    for (const f of t.fields.filter(isSelfDeclaredField)) {
+    for (const f of t.fields.filter((x) => isSelfDeclaredField(x) && !has(t.token, x.key))) {
       steps.push({
         label: `self_declared.${t.token}.${f.key}`,
         door: "field_declare",
@@ -6150,7 +6181,7 @@ function compileInstallPlan(written) {
     }
   }
   for (const t of tables) {
-    for (const f of t.fields.filter((x) => DERIVED.has(x.parityType))) {
+    for (const f of t.fields.filter((x) => DERIVED.has(x.parityType) && !has(t.token, x.key))) {
       steps.push({
         label: `derived.${t.token}.${f.key}`,
         door: "field_declare",
@@ -6161,7 +6192,7 @@ function compileInstallPlan(written) {
     }
   }
   for (const t of tables) {
-    for (const f of formulaOrder(t)) {
+    for (const f of formulaOrder(t).filter((x) => !has(t.token, x.key))) {
       steps.push({
         label: `formula.${t.token}.${f.key}`,
         door: "field_declare",
@@ -6187,7 +6218,7 @@ function compileInstallPlan(written) {
       saveEach: { array: [], key: ["data", "key"], value: ["id"], prefix: `fields.${token}.` }
     });
   }
-  for (const d of spec.dimensions) {
+  for (const d of spec.dimensions.filter((x) => !bound.has(x.table))) {
     const overrides = {};
     if (d.dimensions) overrides["dimensions"] = d.dimensions;
     if (d.measures) overrides["measures"] = d.measures;
@@ -6344,18 +6375,22 @@ function compileInstallPlan(written) {
     });
   }
   const host = compileHostExtras(spec);
+  const agent = spec.agent;
   return {
     planVersion: INSTALL_PLAN_VERSION,
     timezone: spec.business.timezone || "UTC",
     steps,
-    agent: {
-      platformAgent: spec.agent.platformAgent,
-      name: spec.agent.name,
-      bindings: spec.agent.variables.map((v) => {
-        const binding = host.agentBindings.get(v.name);
-        return { variable: v.name, tableToken: v.table, describes: v.describes, ...binding ? { binding } : {} };
-      })
-    },
+    ...agent?.platformAgent ? {
+      agent: {
+        platformAgent: agent.platformAgent,
+        name: agent.name,
+        bindings: (agent.variables ?? []).map((v) => {
+          const binding = host.agentBindings.get(v.name);
+          return { variable: v.name, tableToken: v.table, describes: v.describes, ...binding ? { binding } : {} };
+        })
+      }
+    } : {},
+    ...bound.size ? { ids: Object.fromEntries([...bound].map(([token, b]) => [`ref:tables.${token}`, b.tableId])) } : {},
     ...host.extras
   };
 }