@ai-matrx/records 0.73.3 → 0.73.5

package/dist/memory/index.js

@@ -1,3 +1,171 @@
+// src/memory/entity.ts
+var ok = (data) => ({ data, error: null });
+var refuse = (message, code = "22023", hint = null) => ({
+  data: null,
+  error: { code, message, details: null, hint }
+});
+function memoryEntityDescribe(e) {
+  const dimensions = e.columns.filter((c) => c.type === "choice" && Array.isArray(c.choices)).map((c) => ({
+    key: c.api_name,
+    label: c.name,
+    from: c.api_name,
+    kind: "choice",
+    cardinality: "low",
+    choices: (c.choices ?? []).map((w) => ({ value: w, label: w }))
+  }));
+  const measures = [
+    { key: "count", label: `Number of ${e.label.toLowerCase()}`, op: "count", unit: "count", additive: true },
+    ...e.columns.filter((c) => c.type === "number").map((c) => ({
+      key: `sum_${c.api_name}`,
+      label: `Total ${c.name.toLowerCase()}`,
+      op: "sum",
+      of: c.api_name,
+      additive: true
+    }))
+  ];
+  return {
+    key: e.token,
+    label: e.label,
+    grain: `one row per ${e.label.toLowerCase()}`,
+    lanes: ["organization", "platform"],
+    dimensions,
+    measures,
+    paths: [],
+    inferred: [],
+    detail: { columns: e.columns.map((c) => c.api_name) },
+    source: { kind: "entity", token: e.token },
+    mode: "invoker",
+    api: { label: e.label, reach: "read_write", columns: e.columns },
+    calendar: { time_zone: "UTC", week_start: "monday" }
+  };
+}
+function matches(row, where) {
+  for (const [k, want] of Object.entries(where ?? {})) {
+    const have = row[k] ?? null;
+    if (Array.isArray(want)) {
+      if (!want.includes(have)) return false;
+    } else if (want === null) {
+      if (have !== null) return false;
+    } else if (typeof want === "object") continue;
+    else if (String(have).toLowerCase() !== String(want).toLowerCase()) return false;
+  }
+  return true;
+}
+function memoryEntityRows(e, question2) {
+  const limit = Number(question2["limit"] ?? 50);
+  const offset = Number(question2["offset"] ?? 0);
+  const rows = e.rows.filter((r) => matches(r, question2["where"]));
+  const page = rows.slice(offset, offset + limit);
+  return {
+    rows: page,
+    total: rows.length,
+    limit,
+    offset,
+    as_of: null,
+    columns: e.columns.map((c) => c.api_name),
+    ...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");
+  const next = {};
+  for (const [k, v] of Object.entries(columns ?? {})) {
+    const c = e.columns.find((x) => x.api_name === k);
+    if (!c) return refuse(`This table has no column called "${k}".`);
+    if (c.lookup && !c.lookup.replaces) return refuse(`"${c.name}" is shown from another table, so it is changed there. Nothing was written.`);
+    if (!c.writable) return refuse(`"${c.name}" is not changed through this door.`, "42501");
+    if (c.type === "choice" && v !== null && v !== "") {
+      const word = (c.choices ?? []).find((w) => w === v) ?? (c.choices ?? []).find((w) => w.toLowerCase() === String(v).toLowerCase());
+      if (!word) return refuse(`"${String(v)}" is not one of the choices of "${c.name}".`, "22023", "The columns call lists its choices.");
+      next[k] = word;
+    } else next[k] = v === "" ? null : v;
+  }
+  const changed = Object.entries(next).some(([k, v]) => row[k] !== v);
+  Object.assign(row, next);
+  return ok({ id: recordId, organization_id: row["organization_id"] ?? null, changed, row });
+}
+function memoryEntityDoors(entities) {
+  const of = (args) => {
+    const src = args["p_source"];
+    return src && src["kind"] === "entity" ? entities.get(String(src["token"])) : void 0;
+  };
+  return {
+    drill_describe: (args) => {
+      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;
+    },
+    entity_row_write: (args) => {
+      const e = entities.get(String(args["p_token"] ?? ""));
+      if (!e) return null;
+      return memoryEntityWrite(e, String(args["p_record_id"] ?? ""), args["p_columns"] ?? {});
+    }
+  };
+}
+
 // src/templates/payloads.ts
 var ACTOR = "user";
 var COMPUTED = /* @__PURE__ */ new Set(["lookup", "rollup", "formula"]);
@@ -2226,10 +2394,10 @@ var PREVIEW_REFUSAL = {
   hint: null
 };
 var WRITE_DOOR = /(^|_)(write|writes|declare|delete|update|upsert|archive|restore|set|move|save|submit|insert|merge|retype|undo|retire|assign|claim|clear|snooze|unsnooze|publish|invite|revoke|issue|pin|duplicate|designate|bind|unbind|change|start|complete|decide|request|hold|release|expire|forget|begin|finish|rows|take|nudge|import|mute|sign|render|instantiate|ensure)(_|$)/;
-function ok(data) {
+function ok2(data) {
   return { data, error: null };
 }
-function refuse(message, code = "PGRST202") {
+function refuse2(message, code = "PGRST202") {
   return { data: null, error: { code, message, details: null, hint: null } };
 }
 function stamp(world) {
@@ -2414,16 +2582,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);
@@ -2465,8 +2628,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) {
@@ -2553,55 +2733,55 @@ function memoryDataSource(world) {
     return typeof v === "string" ? v : v === void 0 || v === null ? null : String(v);
   };
   const doors = {
-    table_kernel_id: () => ok(MEMORY_KERNEL.table),
-    field_kernel_id: () => ok(MEMORY_KERNEL.field),
-    person_kernel_id: () => ok(MEMORY_KERNEL.person),
-    file_kernel_id: () => ok(MEMORY_KERNEL.file),
-    rule_kernel_id: () => ok(MEMORY_KERNEL.rule),
-    store_is_open: () => ok(true),
+    table_kernel_id: () => ok2(MEMORY_KERNEL.table),
+    field_kernel_id: () => ok2(MEMORY_KERNEL.field),
+    person_kernel_id: () => ok2(MEMORY_KERNEL.person),
+    file_kernel_id: () => ok2(MEMORY_KERNEL.file),
+    rule_kernel_id: () => ok2(MEMORY_KERNEL.rule),
+    store_is_open: () => ok2(true),
     read_records: (args) => {
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok(world.tables.slice(offset, offset + limit).map(tableRow));
+      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok2(world.tables.slice(offset, offset + limit).map(tableRow));
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(t.order.slice(offset, offset + limit).map((id) => row(t, id)));
+      if (!t) return ok2([]);
+      return ok2(t.order.slice(offset, offset + limit).map((id) => row(t, id)));
     },
     read_records_by_ids: (args) => {
       const ids = args["p_record_ids"] ?? [];
-      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok(world.tables.filter((t2) => ids.includes(t2.id)).map(tableRow));
+      if (args["p_table_id"] === MEMORY_KERNEL.table) return ok2(world.tables.filter((t2) => ids.includes(t2.id)).map(tableRow));
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(ids.filter((id) => t.rows.has(id)).map((id) => row(t, id)));
+      if (!t) return ok2([]);
+      return ok2(ids.filter((id) => t.rows.has(id)).map((id) => row(t, id)));
     },
     read_records_matching: (args) => {
       const t = tableOf(args);
-      if (!t) return ok([]);
+      if (!t) return ok2([]);
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      return ok(matching(world, t, args).slice(offset, offset + limit).map((id) => row(t, id)));
+      return ok2(matching(world, t, args).slice(offset, offset + limit).map((id) => row(t, id)));
     },
     read_records_page: (args) => {
       const t = tableOf(args);
       const limit = Number(args["p_limit"] ?? 50);
       const offset = Number(args["p_offset"] ?? 0);
-      if (!t) return ok({ rows: [], total: 0, limit, offset, sort_ignored: [] });
+      if (!t) return ok2({ rows: [], total: 0, limit, offset, sort_ignored: [] });
       const ids = matching(world, t, args);
-      return ok({ rows: ids.slice(offset, offset + limit).map((id) => row(t, id)), total: ids.length, limit, offset, sort_ignored: [] });
+      return ok2({ rows: ids.slice(offset, offset + limit).map((id) => row(t, id)), total: ids.length, limit, offset, sort_ignored: [] });
     },
     read_record: (args) => {
       const id = String(args["p_record_id"] ?? "");
       const t = world.recordTable.get(id);
-      if (!t) return refuse("That record is not in this template.", "P0002");
-      return ok(readDocument(world, t, id));
+      if (!t) return refuse2("That record is not in this template.", "P0002");
+      return ok2(readDocument(world, t, id));
     },
-    record_headers: (args) => ok(
+    record_headers: (args) => ok2(
       (args["p_ids"] ?? []).filter((id) => world.recordTable.has(id)).map((id) => ({ id, mine: false, version: 1, table_id: world.recordTable.get(id).id, deleted_at: null, ...stamp(world) }))
     ),
     applicable_fields: (args) => {
       const t = tableOf(args);
-      if (!t) return ok([]);
-      return ok(
+      if (!t) return ok2([]);
+      return ok2(
         t.fields.map((f) => ({
           id: f.id,
           data: f.data,
@@ -2620,9 +2800,9 @@ function memoryDataSource(world) {
     },
     field_options: (args) => {
       const hit = fieldById(args["p_field_id"]);
-      if (!hit) return ok([]);
+      if (!hit) return ok2([]);
       const opts = hit.t.options.get(String(hit.f.data["key"])) ?? [];
-      return ok(
+      return ok2(
         opts.map((o, i) => ({
           id: o.id,
           organization_id: world.organization_id,
@@ -2638,46 +2818,46 @@ function memoryDataSource(world) {
         }))
       );
     },
-    my_levels: (args) => ok((args["p_ids"] ?? []).map((id) => ({ id, level: VIEWER }))),
-    views: (args) => ok(
+    my_levels: (args) => ok2((args["p_ids"] ?? []).map((id) => ({ id, level: VIEWER }))),
+    views: (args) => ok2(
       world.views.filter((v) => !args["p_table_id"] || v.table_id === args["p_table_id"]).map((v) => ({ view_id: v.view_id, name: v.name, table_id: v.table_id, filters: v.filters, definition: v.definition, created_at: `${world.today}T09:00:00Z` }))
     ),
     view_look_read: (args) => {
       const out = {};
       for (const [key, look] of looks) if (key.startsWith(`${String(args["p_table_id"])}:`)) out[key.split(":")[1]] = look;
-      return ok(out);
+      return ok2(out);
     },
     view_look_set: (args) => {
       const key = `${String(args["p_table_id"])}:${String(args["p_view_id"])}`;
       const look = args["p_look"] ?? null;
       if (look) looks.set(key, { look, updated_at: (/* @__PURE__ */ new Date()).toISOString() });
       else looks.delete(key);
-      return ok(look);
+      return ok2(look);
     },
-    grid_layout: (args) => ok({
+    grid_layout: (args) => ok2({
       layout: { mode: "auto", wrap: false, row_height: "normal", fit_max_columns: 8, freeze_first_column: false },
       source: { mode: "platform", wrap: "platform", row_height: "platform", fit_max_columns: "platform", freeze_first_column: "platform" },
       refused: [],
       view_id: args["p_view_id"] ?? null
     }),
-    table_decorations: () => ok({ rows: {}, cells: {}, rules: [], stale: [], colors: ["slate", "green", "amber", "red", "blue", "violet", "teal"], columns: {}, version: 1, rule_ops: [] }),
-    row_actions: () => ok({ stale: [], actions: [] }),
-    table_stage_field: (args) => ok(world.stageField.get(String(args["p_table_id"])) ?? null),
+    table_decorations: () => ok2({ rows: {}, cells: {}, rules: [], stale: [], colors: ["slate", "green", "amber", "red", "blue", "violet", "teal"], columns: {}, version: 1, rule_ops: [] }),
+    row_actions: () => ok2({ stale: [], actions: [] }),
+    table_stage_field: (args) => ok2(world.stageField.get(String(args["p_table_id"])) ?? null),
     pipeline_read: (args) => {
       const t = tableOf(args);
       const stage = t ? world.stageField.get(t.id) : void 0;
       const field = stage ? t.fields.find((f) => f.data["key"] === stage) : void 0;
-      if (!t || !stage || !field) return ok({ is_pipeline: false, why: "This table has no stage column." });
+      if (!t || !stage || !field) return ok2({ is_pipeline: false, why: "This table has no stage column." });
       const stages = (t.options.get(stage) ?? []).map((o) => ({ key: o.key, label: o.label, retired: false }));
-      return ok({ is_pipeline: true, table_id: t.id, stage_field: stage, field_id: field.id, stage_label: field.data["label"], stages, rules: [] });
+      return ok2({ is_pipeline: true, table_id: t.id, stage_field: stage, field_id: field.id, stage_label: field.data["label"], stages, rules: [] });
     },
     pipeline_board: (args) => {
       const t = tableOf(args);
       const stage = t ? world.stageField.get(t.id) : void 0;
-      if (!t || !stage) return ok([]);
+      if (!t || !stage) return ok2([]);
       const measure = typeof args["p_measure"] === "string" ? args["p_measure"] : null;
       const ids = t.order.filter((id) => admits(world, t, id, args["p_filter"]));
-      return ok(
+      return ok2(
         (t.options.get(stage) ?? []).map((o, i) => {
           const inIt = ids.filter((id) => t.rows.get(id)[stage] === o.key);
           const total = measure ? inIt.reduce((sum, id) => sum + (typeof t.rows.get(id)[measure] === "number" ? t.rows.get(id)[measure] : 0), 0) : null;
@@ -2685,7 +2865,7 @@ function memoryDataSource(world) {
         })
       );
     },
-    relation_words_many: (args) => ok((args["p_record_ids"] ?? []).map((id) => ({ record_id: id, words: nameOf(id), archived: false }))),
+    relation_words_many: (args) => ok2((args["p_record_ids"] ?? []).map((id) => ({ record_id: id, words: nameOf(id), archived: false }))),
     reverse_columns: (args) => {
       const target = String(args["p_table_id"] ?? "");
       const out = [];
@@ -2705,11 +2885,11 @@ function memoryDataSource(world) {
           });
         }
       }
-      return ok(out);
+      return ok2(out);
     },
     reverse_links_many: (args) => {
       const hit = fieldById(args["p_field_id"]);
-      return ok(
+      return ok2(
         (args["p_record_ids"] ?? []).map((rid) => {
           if (!hit) return { record_id: rid, total: 0, links: [] };
           const key = String(hit.f.data["key"]);
@@ -2723,28 +2903,28 @@ function memoryDataSource(world) {
     },
     // A template's own record has no history, comments, checklists or worked-out provenance yet:
     // these are the answers an installed template gives on its first day.
-    record_history: () => ok([]),
-    field_history: () => ok([]),
-    computed_provenance: () => ok([]),
-    comment_thread: (args) => ok({ record_id: args["p_record_id"] ?? null, comments: [], may_comment: false, may_resolve: false }),
-    checklist_runs: () => ok([]),
-    checklist_templates: () => ok([]),
-    doc_templates: () => ok([]),
-    doc_renders: () => ok([]),
-    doc_signatures: () => ok([]),
-    record_row_controls: () => ok({
+    record_history: () => ok2([]),
+    field_history: () => ok2([]),
+    computed_provenance: () => ok2([]),
+    comment_thread: (args) => ok2({ record_id: args["p_record_id"] ?? null, comments: [], may_comment: false, may_resolve: false }),
+    checklist_runs: () => ok2([]),
+    checklist_templates: () => ok2([]),
+    doc_templates: () => ok2([]),
+    doc_renders: () => ok2([]),
+    doc_signatures: () => ok2([]),
+    record_row_controls: () => ok2({
       shown_to: { value: null, effective: "everyone", type_default: null, table_default: null, allowed: ["everyone"], is_child: false, can_change: false },
       published_to_web: { available: false, value: false, table_default: null, can_change: false },
       indexed: { available: false, value: null, table_default: null, effective: false, can_change: false }
     }),
-    enrich_cells: () => ok([]),
-    enrichments: () => ok([]),
-    pipeline_pending: () => ok([]),
-    record_stage_pending: () => ok([]),
-    io_imports: () => ok([]),
-    relation_words: (args) => ok(nameOf(String(args["p_value"] ?? ""))),
+    enrich_cells: () => ok2([]),
+    enrichments: () => ok2([]),
+    pipeline_pending: () => ok2([]),
+    record_stage_pending: () => ok2([]),
+    io_imports: () => ok2([]),
+    relation_words: (args) => ok2(nameOf(String(args["p_value"] ?? ""))),
     // The read doors a form, a booking page and a dashboard are drawn from (lane CHAIR-GALLERY-3).
-    forms: (args) => ok(
+    forms: (args) => ok2(
       world.forms.filter((f) => !f.booking && (!args["p_table_id"] || f.table_id === args["p_table_id"])).map((f) => ({
         form_id: f.form_id,
         table_id: f.table_id,
@@ -2767,7 +2947,7 @@ function memoryDataSource(world) {
     form_preview_asks: (args) => {
       const t = tableOf(args);
       const values = args["p_values"] ?? {};
-      return ok(
+      return ok2(
         (args["p_questions"] ?? []).map((q) => {
           const when = q["show_if"] ?? q["showIf"] ?? null;
           const asked = !when || !t ? true : rule(t, values, values, when) !== false;
@@ -2775,7 +2955,7 @@ function memoryDataSource(world) {
         })
       );
     },
-    bookings: (args) => ok(
+    bookings: (args) => ok2(
       world.forms.filter((f) => f.booking && (!args["p_table_id"] || f.table_id === args["p_table_id"])).map((f) => ({
         form_id: f.form_id,
         table_id: f.table_id,
@@ -2797,9 +2977,9 @@ function memoryDataSource(world) {
     booking_public: (args) => {
       const f = world.forms.find((x) => x.form_id === args["p_form_id"] && x.booking);
       const t = f ? world.tableById.get(f.table_id) : void 0;
-      if (!f || !t) return refuse("That booking page is not in this template.", "P0002");
+      if (!f || !t) return refuse2("That booking page is not in this template.", "P0002");
       const availability = bookingAvailability(world, f.booking);
-      return ok({
+      return ok2({
         form_id: f.form_id,
         organization_id: world.organization_id,
         table_id: t.id,
@@ -2813,7 +2993,7 @@ function memoryDataSource(world) {
         message: null
       });
     },
-    dashboards: (args) => ok(
+    dashboards: (args) => ok2(
       world.dashboards.filter((d) => !args["p_table_id"] || d.table_id === args["p_table_id"]).map((d) => ({
         dashboard_id: d.dashboard_id,
         table_id: d.table_id,
@@ -2828,9 +3008,9 @@ function memoryDataSource(world) {
     ),
     dashboard_run: (args) => {
       const d = world.dashboards.find((x) => x.dashboard_id === args["p_dashboard_id"]);
-      if (!d) return refuse("That dashboard is not in this template.", "P0002");
+      if (!d) return refuse2("That dashboard is not in this template.", "P0002");
       const canvas = args["p_filter"] ?? {};
-      return ok({
+      return ok2({
         dashboard_id: d.dashboard_id,
         name: d.name,
         subject_table_id: d.table_id,
@@ -2842,16 +3022,34 @@ function memoryDataSource(world) {
         blocks: d.blocks.map((b, i) => runBlock(world, d.table_id, b, canvas, i))
       });
     },
-    dashboard_stuck: () => ok([])
+    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,
     rpc(fn, args) {
-      const name = fn.replace(/^custom\./, "");
+      const name = fn.replace(/^custom\./, "").replace(/^platform\./, "");
+      const entityDoor = world.entities ? memoryEntityDoors(world.entities)[name] : void 0;
+      const fromEntity = entityDoor ? entityDoor(args ?? {}) : null;
+      if (fromEntity) return Promise.resolve(fromEntity);
       const door = doors[name];
       if (door) return Promise.resolve(door(args ?? {}));
       if (WRITE_DOOR.test(name)) return Promise.resolve({ data: null, error: PREVIEW_REFUSAL });
-      return Promise.resolve(refuse(`A template preview does not answer ${name}.`));
+      return Promise.resolve(refuse2(`A template preview does not answer ${name}.`));
     },
     schema() {
       return {
@@ -2865,6 +3063,12 @@ function memoryDataSource(world) {
 }
 
 // src/memory/index.ts
+function withEntities(world, specs) {
+  const entities = new Map(world.entities ?? []);
+  for (const s of specs) entities.set(s.token, { ...s, rows: s.rows.map((r) => ({ ...r })) });
+  world.entities = entities;
+  return world;
+}
 function templatePreview(spec, options = {}) {
   const world = templateWorld(spec, options);
   const config = {
@@ -2880,12 +3084,39 @@ function templatePreview(spec, options = {}) {
     dashboards: world.dashboards.map((d) => ({ id: d.dashboard_id, token: d.token, name: d.name, tableId: d.table_id }))
   };
 }
+function entityStore(specs, options = {}) {
+  const world = {
+    organization_id: stableId("entity-store-organization"),
+    user_id: stableId("entity-store-person"),
+    timezone: "UTC",
+    today: options.today ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    businessName: "",
+    tables: [],
+    tableById: /* @__PURE__ */ new Map(),
+    views: [],
+    forms: [],
+    dashboards: [],
+    recordTable: /* @__PURE__ */ new Map(),
+    stageField: /* @__PURE__ */ new Map()
+  };
+  withEntities(world, specs);
+  return {
+    world,
+    config: { dataSource: memoryDataSource(world), actor: { actor: "user", user_id: world.user_id }, organizationId: world.organization_id }
+  };
+}
 export {
   MEMORY_KERNEL,
   PREVIEW_REFUSAL,
+  entityStore,
   memoryDataSource,
+  memoryEntityAsk,
+  memoryEntityDescribe,
+  memoryEntityRows,
+  memoryEntityWrite,
   stableId,
   templatePreview,
-  templateWorld
+  templateWorld,
+  withEntities
 };
 //# sourceMappingURL=index.js.map