@ai-matrx/records 0.73.4 → 0.73.5

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @ai-matrx/records
 
+## 0.73.5
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records/v0.73.4..npm/records/v0.73.5 -- apps/shared/records`).
+No source changes intended and no consumer action required.
+
 ## 0.73.4
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/memory/index.cjs

@@ -24,6 +24,7 @@ __export(memory_exports, {
   PREVIEW_REFUSAL: () => PREVIEW_REFUSAL,
   entityStore: () => entityStore,
   memoryDataSource: () => memoryDataSource,
+  memoryEntityAsk: () => memoryEntityAsk,
   memoryEntityDescribe: () => memoryEntityDescribe,
   memoryEntityRows: () => memoryEntityRows,
   memoryEntityWrite: () => memoryEntityWrite,
@@ -102,6 +103,61 @@ function memoryEntityRows(e, question2) {
     ...offset + page.length < rows.length ? { next_offset: offset + page.length } : {}
   };
 }
+function memoryEntityAsk(e, question2) {
+  const by = (question2["by"] ?? []).map((k) => k.split(":")[0]);
+  const shown = question2["show"] ?? ["count"];
+  const measures = (shown.length ? shown : ["count"]).map((m) => typeof m === "string" ? m === "count" ? { key: "count", op: "count", of: null } : { key: m, op: m.split("_")[0], of: m.slice(m.indexOf("_") + 1) } : { key: m.op === "count" ? "count" : `${m.op}_${m.of ?? ""}`, op: m.op, of: m.of ?? null });
+  const rows = e.rows.filter((r) => matches(r, question2["where"]));
+  const measure = (list) => {
+    const out2 = {};
+    for (const m of measures) {
+      if (m.op === "count") {
+        out2[m.key] = list.length;
+        continue;
+      }
+      const nums = list.map((r) => r[m.of ?? ""]).filter((v) => typeof v === "number");
+      const sum = nums.reduce((a, b) => a + b, 0);
+      out2[m.key] = !nums.length ? null : m.op === "sum" ? sum : m.op === "avg" ? sum / nums.length : m.op === "min" ? Math.min(...nums) : m.op === "max" ? Math.max(...nums) : null;
+    }
+    return out2;
+  };
+  const row = (kind, groups, list) => ({
+    kind,
+    groups,
+    measures: measure(list),
+    row_count: list.length,
+    prior_groups: null,
+    prior_measures: null,
+    prior_row_count: null,
+    delta: null,
+    compare: null,
+    distinct_groups: null,
+    labels: {},
+    says: null,
+    as_of: null
+  });
+  const out = [];
+  if (by.length) {
+    const groups = /* @__PURE__ */ new Map();
+    for (const r of rows) {
+      const g = {};
+      for (const k of by) {
+        const v = r[k];
+        g[k] = v === void 0 || v === "" ? null : v;
+      }
+      const key = JSON.stringify(g);
+      const hit = groups.get(key) ?? { groups: g, rows: [] };
+      hit.rows.push(r);
+      groups.set(key, hit);
+    }
+    const first = measures[0].key;
+    const answered = [...groups.values()].map((g) => row("group", g.groups, g.rows));
+    answered.sort((a, b) => Number(b["measures"][first] ?? 0) - Number(a["measures"][first] ?? 0));
+    out.push(...answered.slice(0, Number(question2["limit"] ?? 50)));
+  }
+  out.push(row("total", {}, rows));
+  return out;
+}
 function memoryEntityWrite(e, recordId, columns) {
   const row = e.rows.find((r) => r["id"] === recordId);
   if (!row) return refuse(`There is no ${e.label} you can open with that id.`, "02000");
@@ -131,6 +187,10 @@ function memoryEntityDoors(entities) {
       const e = of(args);
       return e ? ok(memoryEntityDescribe(e)) : null;
     },
+    drill_ask: (args) => {
+      const e = of(args);
+      return e ? ok(memoryEntityAsk(e, args["p_question"] ?? {})) : null;
+    },
     drill_rows: (args) => {
       const e = of(args);
       return e ? ok(memoryEntityRows(e, args["p_question"] ?? {})) : null;
@@ -2559,16 +2619,11 @@ function groupValues(doc, stored, key) {
   const out = list.map((v) => v === void 0 || v === null || v === "" ? null : String(v));
   return out.length ? out : [null];
 }
-function runBlock(world, subject, raw, canvas, index) {
-  const table = world.tableById.get(String(raw["table_id"] ?? subject));
-  const title = String(raw["title"] ?? `Block ${index + 1}`);
-  const base = { ...raw, title, table_id: table?.id ?? subject, ms: 0 };
-  if (!table) return { ...base, rows: [], refused: "This block's table is not in this template." };
-  if (raw["kind"] === "stuck") return { ...base, rows: [] };
-  const measures = (raw["measures"] ?? [{ op: "count" }]).map((m) => ({ op: String(m["op"] ?? "count"), key: m["key"] }));
-  const groupBy = (raw["group_by"] ?? []).slice();
-  const bucket = raw["bucket"] ?? null;
-  const ids = table.order.filter((id) => admits(world, table, id, raw["filter"]) && admits(world, table, id, canvas));
+function aggregateRows(world, table, ask) {
+  const { groupBy, measures, bucket } = ask;
+  const search = (ask.search ?? "").trim().toLowerCase();
+  let ids = table.order.filter((id) => ask.filters.every((f) => admits(world, table, id, f)));
+  if (search) ids = ids.filter((id) => JSON.stringify(readDocument(world, table, id)).toLowerCase().includes(search));
   const groups = /* @__PURE__ */ new Map();
   for (const id of ids) {
     const doc = readDocument(world, table, id);
@@ -2610,8 +2665,25 @@ function runBlock(world, subject, raw, canvas, index) {
     const k = `${bucket.key}_${bucket.by ?? "month"}`;
     rows.sort((a, b) => String(a.groups[k]).localeCompare(String(b.groups[k])));
   } else rows.sort((a, b) => (b.measures[primary] ?? 0) - (a.measures[primary] ?? 0));
-  const limit = Number(raw["limit"] ?? 0);
+  const limit = Number(ask.limit ?? 0);
   if (limit > 0) rows = rows.slice(0, limit);
+  return rows;
+}
+function measuresOf(raw) {
+  const list = Array.isArray(raw) ? raw : [];
+  const out = list.map((m) => ({ op: String(m["op"] ?? "count"), key: m["key"] }));
+  return out.length ? out : [{ op: "count" }];
+}
+function runBlock(world, subject, raw, canvas, index) {
+  const table = world.tableById.get(String(raw["table_id"] ?? subject));
+  const title = String(raw["title"] ?? `Block ${index + 1}`);
+  const base = { ...raw, title, table_id: table?.id ?? subject, ms: 0 };
+  if (!table) return { ...base, rows: [], refused: "This block's table is not in this template." };
+  if (raw["kind"] === "stuck") return { ...base, rows: [] };
+  const measures = measuresOf(raw["measures"]);
+  const groupBy = (raw["group_by"] ?? []).slice();
+  const bucket = raw["bucket"] ?? null;
+  const rows = aggregateRows(world, table, { groupBy, measures, bucket, filters: [raw["filter"], canvas], limit: Number(raw["limit"] ?? 0) });
   return { ...base, measures, group_by: groupBy, rows };
 }
 function bookingAvailability(world, raw) {
@@ -2987,7 +3059,22 @@ function memoryDataSource(world) {
         blocks: d.blocks.map((b, i) => runBlock(world, d.table_id, b, canvas, i))
       });
     },
-    dashboard_stuck: () => ok2([])
+    dashboard_stuck: () => ok2([]),
+    // THE EIGHTH VERB, in memory: the same groups and measures as the live `custom.record_aggregate`
+    // (and its row shape: no comparison asked ⇒ every prior_* null).
+    record_aggregate: (args) => {
+      const t = tableOf(args);
+      if (!t) return refuse2("That table is not in this template.", "P0002");
+      const rows = aggregateRows(world, t, {
+        groupBy: (args["p_group_by"] ?? []).slice(),
+        measures: measuresOf(args["p_measures"]),
+        bucket: args["p_bucket"] ?? null,
+        filters: [args["p_filter"]],
+        ...typeof args["p_search"] === "string" ? { search: args["p_search"] } : {},
+        limit: Number(args["p_limit"] ?? 200)
+      });
+      return ok2(rows.map((r) => ({ ...r, prior_groups: null, prior_measures: null, prior_row_count: null, delta: null, compare: null })));
+    }
   };
   const source = {
     world,