@lotics/app-sdk 0.106.0 → 0.107.0

package/AGENTS.md

@@ -43,7 +43,7 @@ This file is the index. The **exact type** of anything is its shipped declaratio
 - **`project` only what you render; filter server-side.** → [queries](./docs/queries.md)
 - **Never hand-roll the serialization contract** — decode cells with the typed readers, and read
   only the columns the alias projects. → [data_fetching](./docs/data_fetching.md)
-- **Narrow `__source_record_id` / `__source_table_id` before use** — a grouped query emits neither.
+- **Narrow `__source_record_id` / `__source_table_id` before use** — a grouped query answers both as null.
   → [data_fetching](./docs/data_fetching.md)
 - **A standalone app takes its API address from the page it was served in**, never from a
   constant. → [runtime](./docs/runtime.md)

package/dist/comments.d.ts

@@ -53,7 +53,7 @@ export interface UseCommentsArgs {
 }
 /**
  * `record_id` must be a real id — an empty string still fetches. Gate the
- * panel on a row's `__source_record_id`, which a grouped query lacks.
+ * panel on a row's `__source_record_id`, which a grouped query answers as null.
  *
  * ```tsx
  * // In a record screen, where an id definitionally exists:

package/dist/index.js

@@ -24536,6 +24536,8 @@ var TOOL_INPUT_SEMANTICS = {
     // Also `{fld_*: value}` — a signed number rather than an item array, but the
     // key half is what this classification governs, so it validates the same way.
     increment: { kind: "record_data", table_from: "table_id" },
+    // `{fld_*: [document template id, ...]}` — the key half is a field of the table, as the ops above.
+    remove_made: { kind: "record_data", table_from: "table_id" },
     // Per-record mode — field_keys names the columns; rows holds values
     // positionally. Each cell's semantic depends on field_keys[i], so the
     // tool resolves option names at execute time. Annotated `dynamic` so the
@@ -24662,6 +24664,12 @@ var TOOL_INPUT_SEMANTICS = {
     aggregations: { kind: "dynamic" },
     group_by: { kind: "field_key_ref", table_from: "table_id" }
   },
+  evaluate_formula: {
+    table_id: { kind: "table_ref", rows: "none" },
+    record_id: { kind: "record_ref" },
+    // `{fld_…}` tokens of `table_id`, resolved against its fields at execute time.
+    expression: { kind: "dynamic" }
+  },
   get_record: {
     // Schema only takes `record_id`; table_id is optional/derived.
     record_id: { kind: "record_ref" },
@@ -27049,6 +27057,10 @@ function adjusted(current, items, op) {
   const gone = new Set(given.map(keyOf));
   return held2.filter((item) => !gone.has(keyOf(item)));
 }
+function withoutMade(current, templates) {
+  const gone = new Set(asList(templates));
+  return asList(current).filter((item) => !(item !== null && typeof item === "object" && "document_template_id" in item && gone.has(item.document_template_id)));
+}
 function note(walk, effect) {
   if (walk.unsure && effect.kind !== "unknown") {
     walk.effects.push({ kind: "unknown", table_id: effect.table_id });
@@ -27081,6 +27093,7 @@ async function predictUpdate(walk, input) {
   const removed = await fieldValues(walk, input.remove_from);
   const increments = await fieldValues(walk, input.increment);
   const replaced = await fieldValues(walk, input.replace);
+  const unmade = await fieldValues(walk, input.remove_made);
   for (const id of ids) {
     const before = recordOf(walk, id);
     const cells = {};
@@ -27107,6 +27120,7 @@ async function predictUpdate(walk, input) {
     };
     relative(added, (current, given) => adjusted(current, given, "add_to"));
     relative(removed, (current, given) => adjusted(current, given, "remove_from"));
+    relative(unmade, (current, templates) => withoutMade(current, templates));
     relative(increments, (current, given) => typeof given === "number" ? (typeof current === "number" ? current : 0) + given : current);
     if (unknown2.includes("*")) {
       note(walk, { kind: "unknown", table_id: table });
@@ -28302,6 +28316,9 @@ function useAgentRuns(sessionId, opts) {
 // src/queries.ts
 import { useCallback as useCallback5, useMemo as useMemo3, useState as useState3 } from "react";
 
+// ../shared/src/schemas/read_row.ts
+var RECORD_ID_COLUMN = "__source_record_id";
+
 // ../shared/src/schemas/app_query_aggregate.ts
 var AGGREGATE_COUNT_COLUMN = "__count";
 var AGGREGATE_SUM_COLUMN = "__sum";
@@ -28325,6 +28342,7 @@ function aggregateRows(rows, aggregate) {
       return typeof value === "number" ? [value] : [];
     });
     return {
+      [RECORD_ID_COLUMN]: null,
       ...Object.fromEntries(by.map((column) => [column, first2?.[column] ?? null])),
       ...day === void 0 ? {} : { [AGGREGATE_DAY_COLUMN]: dayOf(first2?.[day]) },
       [AGGREGATE_COUNT_COLUMN]: members2.length,

package/dist/queries.d.ts

@@ -12,10 +12,10 @@ import type { ReportColumn, ReportReading } from "./shared_types.js";
  */
 export interface QueryRow {
     [column: string]: unknown;
-    /** The record this row came from. Absent on a grouped/aggregated row. */
-    __source_record_id?: string;
-    /** The table that record lives in. Absent on a grouped/aggregated row. */
-    __source_table_id?: string;
+    /** The record this row came from: null on a grouped row, which stands for no one record. */
+    __source_record_id?: string | null;
+    /** The table that record lives in: null on a grouped row. */
+    __source_table_id?: string | null;
 }
 /**
  * The row type of alias `K`: its projected columns plus the two addressing

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.106.0",
+  "version": "0.107.0",
   "description": "The SDK a Lotics custom-code app reads and writes through \u2014 typed hooks over the host bridge, cell readers, mount() and AppRouter",
   "type": "module",
   "exports": {