@lotics/app-sdk 0.120.2 → 0.121.0

package/dist/index.js

@@ -3,35 +3,44 @@ import {
   AGGREGATE_SUM_COLUMN,
   DEFAULT_IMAGE_FIDELITY,
   __export,
+  addDecimal,
   aggregateRows,
   anyRecordingLive,
   applyPatch,
-  assertNever,
   bandKey,
   bandOf,
+  compareDecimal,
   decodeAll,
+  divideDecimal,
   encodePatch,
+  fixedDecimal,
   getUrlParams,
   isEmbedded,
+  moduloDecimal,
+  multiplyDecimal,
+  multiplyExactly,
   paramsEqual,
   peekUrlParams,
+  percentOf,
   postHostNotification,
+  powerDecimal,
   readRecordingSnapshot,
   recordingStateOf,
   recordingsVersion,
   replaceRecordings,
+  roundDecimal,
   rpc,
   rpcAgentRun,
   rpcAgentRunContinue,
-  sample,
   setUrlParams,
   subscribeQueriesChanged,
   subscribeRecordings,
   subscribeUrlParams,
+  subtractDecimal,
   sumDecimal,
   tiersAscend,
   urlParam
-} from "./chunk-NZXJENJ2.js";
+} from "./chunk-MK4DBY6R.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";
@@ -602,6 +611,14 @@ function readNow(aliases) {
 function refetchReads(aliases) {
   for (const slot of readNow(aliases)) void ask(slot, true);
 }
+async function readsAnswered(aliases) {
+  await Promise.all(
+    readNow(aliases).map(async (slot) => {
+      await ask(slot, true);
+      while (slot.inflight !== null) await slot.inflight;
+    })
+  );
+}
 function askInOnePaint(read2) {
   if (read2.length === 0) return;
   const paint = { waiting: new Set(read2), held: [], drawn: false, cap: setTimeout(() => draw(paint), PAINT_CAP_MS) };
@@ -1729,6 +1746,15 @@ var customRandom = (alphabet, defaultSize, getRandom) => {
 };
 var customAlphabet = (alphabet, size2 = 21) => customRandom(alphabet, size2 | 0, random);
 
+// ../shared/src/utils.ts
+function sample(arr) {
+  if (arr.length === 0) return void 0;
+  return arr[Math.floor(Math.random() * arr.length)];
+}
+function assertNever(value) {
+  throw new Error(`Unhandled union member: ${JSON.stringify(value)}`);
+}
+
 // ../shared/src/expression_array.ts
 var expression_array_exports = {};
 __export(expression_array_exports, {
@@ -2782,7 +2808,7 @@ function formatNumber(value, decimals) {
     throw new Error("formatNumber: expected number, got " + typeof value);
   }
   assertDecimals(decimals, "formatNumber");
-  return value.toFixed(decimals);
+  return fixedDecimal(value, decimals);
 }
 function formatDecimal(value, decimals, locale) {
   if (value == null) return "";
@@ -2902,9 +2928,7 @@ function round(value, precision) {
   if (precision != null && typeof precision !== "number") {
     throw new Error("round: precision must be a number");
   }
-  const prec = precision != null ? precision : 0;
-  const multiplier = Math.pow(10, prec);
-  return Math.round(value * multiplier) / multiplier;
+  return roundDecimal(value, precision ?? 0);
 }
 function sum(arr) {
   if (arr == null) return 0;
@@ -2970,12 +2994,8 @@ function percentage(part, total, decimals) {
   if (decimals != null && typeof decimals !== "number") {
     throw new Error("percentage: decimals must be a number");
   }
-  const percent = part / total * 100;
-  if (decimals != null) {
-    const multiplier = Math.pow(10, decimals);
-    return Math.round(percent * multiplier) / multiplier;
-  }
-  return percent;
+  const percent = divideDecimal(multiplyDecimal(part, 100), total);
+  return decimals != null ? roundDecimal(percent, decimals) : percent;
 }
 function pow(base, exponent) {
   if (base == null || exponent == null) return null;
@@ -2985,7 +3005,7 @@ function pow(base, exponent) {
   if (typeof exponent !== "number") {
     throw new Error("pow: exponent must be a number");
   }
-  return Math.pow(base, exponent);
+  return powerDecimal(base, exponent);
 }
 function sqrt(n) {
   if (n == null) return null;
@@ -3008,7 +3028,7 @@ function mod(n, divisor) {
   if (divisor === 0) {
     throw new Error("mod: divisor cannot be zero");
   }
-  return n % divisor;
+  return moduloDecimal(n, divisor);
 }
 
 // ../shared/src/expression_object.ts
@@ -5815,9 +5835,21 @@ function isNothing(value) {
   return value === null || value === void 0;
 }
 var MULTIPLICATIVE_OPERATORS = /* @__PURE__ */ new Map([
-  ["*", (left, right) => left * right],
-  ["/", (left, right) => left / right],
-  ["%", (left, right) => left % right]
+  ["*", multiplyDecimal],
+  ["/", divideDecimal],
+  ["%", moduloDecimal]
+]);
+var COMPARISONS = /* @__PURE__ */ new Map([
+  // eslint-disable-next-line eqeqeq
+  ["==", { ofNumbers: (order) => order === 0, ofOthers: (left, right) => left == right }],
+  // eslint-disable-next-line eqeqeq
+  ["!=", { ofNumbers: (order) => order !== 0, ofOthers: (left, right) => left != right }],
+  ["===", { ofNumbers: (order) => order === 0, ofOthers: (left, right) => left === right }],
+  ["!==", { ofNumbers: (order) => order !== 0, ofOthers: (left, right) => left !== right }],
+  ["<", { ofNumbers: (order) => order < 0, ofOthers: (left, right) => left < right }],
+  ["<=", { ofNumbers: (order) => order <= 0, ofOthers: (left, right) => left <= right }],
+  [">", { ofNumbers: (order) => order > 0, ofOthers: (left, right) => left > right }],
+  [">=", { ofNumbers: (order) => order >= 0, ofOthers: (left, right) => left >= right }]
 ]);
 var SafeEvalAstFactory = class extends EvalAstFactory {
   id(name) {
@@ -5856,6 +5888,26 @@ var SafeEvalAstFactory = class extends EvalAstFactory {
         }
       };
     }
+    const comparison = COMPARISONS.get(op);
+    if (comparison) {
+      return {
+        type: "Binary",
+        operator: op,
+        left,
+        right,
+        evaluate(scope) {
+          const leftValue = this.left.evaluate(scope);
+          const rightValue = this.right.evaluate(scope);
+          if (typeof leftValue === "number" && typeof rightValue === "number") return comparison.ofNumbers(compareDecimal(leftValue, rightValue));
+          return comparison.ofOthers(leftValue, rightValue);
+        },
+        getIds(idents) {
+          this.left.getIds(idents);
+          this.right.getIds(idents);
+          return idents;
+        }
+      };
+    }
     if (op !== "+" && op !== "-") {
       return super.binary(left, op, right);
     }
@@ -5871,7 +5923,8 @@ var SafeEvalAstFactory = class extends EvalAstFactory {
           if (isNothing(leftValue) && isNothing(rightValue)) return null;
           const leftOperand = leftValue ?? 0;
           const rightOperand = rightValue ?? 0;
-          return op === "+" ? leftOperand + rightOperand : Number(leftOperand) - Number(rightOperand);
+          if (op === "-") return subtractDecimal(Number(leftOperand), Number(rightOperand));
+          return typeof leftOperand === "number" && typeof rightOperand === "number" ? addDecimal(leftOperand, rightOperand) : leftOperand + rightOperand;
         };
         return op === "+" ? addOrConcat(leftValue, rightValue, combine) : combine();
       },
@@ -21164,7 +21217,7 @@ function aggregateTextField(values2, operation) {
       const emptyCount = values2.filter(
         (value) => value === null || value === void 0 || value === ""
       ).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
@@ -21172,7 +21225,7 @@ function aggregateTextField(values2, operation) {
       const filledCount = values2.filter(
         (value) => value !== null && value !== void 0 && value !== ""
       ).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "unique": {
@@ -21188,7 +21241,7 @@ function aggregateTextField(values2, operation) {
       );
       if (filledValues.length === 0) return { result: 0 };
       const uniqueValues = new Set(filledValues);
-      const percentage2 = Math.round(uniqueValues.size / filledValues.length * 100);
+      const percentage2 = percentOf(uniqueValues.size, filledValues.length);
       return { result: percentage2 };
     }
     default:
@@ -21212,13 +21265,13 @@ function aggregateNumberField(values2, operation) {
     case "percent_empty": {
       if (totalCount === 0) return { result: 0 };
       const emptyCount = values2.filter((value) => !hasNumberValue(value)).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
       if (totalCount === 0) return { result: 0 };
       const filledCount = values2.filter(hasNumberValue).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "unique": {
@@ -21230,7 +21283,7 @@ function aggregateNumberField(values2, operation) {
       const filledValues = values2.filter(hasNumberValue);
       if (filledValues.length === 0) return { result: 0 };
       const uniqueValues = new Set(filledValues);
-      const percentage2 = Math.round(uniqueValues.size / filledValues.length * 100);
+      const percentage2 = percentOf(uniqueValues.size, filledValues.length);
       return { result: percentage2 };
     }
   }
@@ -21288,13 +21341,13 @@ function aggregateBooleanField(values2, operation) {
     case "percent_checked": {
       if (totalCount === 0) return { result: 0 };
       const checkedCount = values2.filter((value) => value === true).length;
-      const percentage2 = Math.round(checkedCount / totalCount * 100);
+      const percentage2 = percentOf(checkedCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_unchecked": {
       if (totalCount === 0) return { result: 0 };
       const uncheckedCount = values2.filter((value) => !value).length;
-      const percentage2 = Math.round(uncheckedCount / totalCount * 100);
+      const percentage2 = percentOf(uncheckedCount, totalCount);
       return { result: percentage2 };
     }
     default:
@@ -21321,7 +21374,7 @@ function aggregateDateField(values2, operation) {
       const emptyCount = values2.filter(
         (value) => value === null || value === void 0 || value === ""
       ).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
@@ -21329,7 +21382,7 @@ function aggregateDateField(values2, operation) {
       const filledCount = values2.filter(
         (value) => value !== null && value !== void 0 && value !== ""
       ).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "unique": {
@@ -21345,7 +21398,7 @@ function aggregateDateField(values2, operation) {
       );
       if (filledValues.length === 0) return { result: 0 };
       const uniqueValues = new Set(filledValues);
-      const percentage2 = Math.round(uniqueValues.size / filledValues.length * 100);
+      const percentage2 = percentOf(uniqueValues.size, filledValues.length);
       return { result: percentage2 };
     }
   }
@@ -21451,13 +21504,13 @@ function aggregateGenericField(values2, operation) {
     case "percent_empty": {
       if (totalCount === 0) return { result: 0 };
       const emptyCount = values2.filter(isEmpty2).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
       if (totalCount === 0) return { result: 0 };
       const filledCount = values2.filter((value) => !isEmpty2(value)).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "unique": {
@@ -21484,7 +21537,7 @@ function aggregateGenericField(values2, operation) {
           uniqueValues.add(value);
         }
       }
-      const percentage2 = Math.round(uniqueValues.size / filledValues.length * 100);
+      const percentage2 = percentOf(uniqueValues.size, filledValues.length);
       return { result: percentage2 };
     }
     case "selected":
@@ -21513,13 +21566,13 @@ function aggregateSelectRecordLinkField(values2, operation) {
     case "percent_empty": {
       if (totalCount === 0) return { result: 0 };
       const emptyCount = values2.filter(isEmpty2).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
       if (totalCount === 0) return { result: 0 };
       const filledCount = values2.filter((value) => !isEmpty2(value)).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "selected":
@@ -21564,13 +21617,13 @@ function aggregateRollupField(values2, operation) {
     case "percent_empty": {
       if (totalCount === 0) return { result: 0 };
       const emptyCount = values2.filter(isEmpty2).length;
-      const percentage2 = Math.round(emptyCount / totalCount * 100);
+      const percentage2 = percentOf(emptyCount, totalCount);
       return { result: percentage2 };
     }
     case "percent_filled": {
       if (totalCount === 0) return { result: 0 };
       const filledCount = values2.filter((value) => !isEmpty2(value)).length;
-      const percentage2 = Math.round(filledCount / totalCount * 100);
+      const percentage2 = percentOf(filledCount, totalCount);
       return { result: percentage2 };
     }
     case "unique": {
@@ -21583,7 +21636,7 @@ function aggregateRollupField(values2, operation) {
       const filledValues = values2.filter((value) => !isEmpty2(value));
       if (filledValues.length === 0) return { result: 0 };
       const uniqueValues = new Set(filledValues);
-      const percentage2 = Math.round(uniqueValues.size / filledValues.length * 100);
+      const percentage2 = percentOf(uniqueValues.size, filledValues.length);
       return { result: percentage2 };
     }
   }
@@ -21904,9 +21957,8 @@ function currencyCodeOf(written) {
   if (Intl.supportedValuesOf("currency").includes(upper2)) return upper2;
   return DONG_SPELLINGS.includes(unitKey(written)) ? "VND" : void 0;
 }
-var EXACT_DIGITS = 15;
 function convert(value, from, to) {
-  return from.code === to.code ? value : Number((value * from.factor / to.factor).toPrecision(EXACT_DIGITS));
+  return from.code === to.code ? value : divideDecimal(multiplyDecimal(value, from.factor), to.factor);
 }
 function scaleIn(own, pack) {
   const kin = MEASURED_UNITS.filter((one) => one.dimension === own.dimension);
@@ -26351,6 +26403,9 @@ var appQueryDeclarationSchema = zod_default.object({
   ),
   templates: zod_default.record(zod_default.string().regex(APP_ALIAS_REGEX), appExportTemplateSchema).optional().describe(
     "Document templates an export of this query's rows may fill, by the name the export asks for. An export names one of these or none; a template it does not declare is refused."
+  ),
+  screen_only: zod_default.literal(true).optional().describe(
+    "The query feeds one control of the app's screen and answers no question a person asks. It runs like any other; a catalog of what an agent may ask leaves it out."
   )
 });
 var appAgentWritesSchema = zod_default.object({
@@ -26692,6 +26747,15 @@ var TOOL_INPUT_SEMANTICS = {
     // same position `query_records.field_keys` holds.
     return_fields: { kind: "field_key_refs", table_from: "table_id" }
   },
+  import_rows: {
+    table_id: { kind: "table_ref", rows: "change" },
+    match: { kind: "field_key_refs", table_from: "table_id" },
+    // Each row's `values` are keyed by field, a link cell possibly `{ lookup }`; the tool resolves both at execute.
+    rows: { kind: "dynamic" },
+    create: { kind: "scalar" },
+    // `fields` is keyed by field; the tool resolves it at execute.
+    conflicts: { kind: "dynamic" }
+  },
   delete_records: {
     // THE ONE CALL THAT TAKES ROWS. Every column of the row goes with it, so
     // nothing field-keyed can carry the fact and it rides the table position —
@@ -26727,6 +26791,22 @@ var TOOL_INPUT_SEMANTICS = {
     changes: { kind: "dynamic" },
     reason: { kind: "text" }
   },
+  // The record names its own table; an entry's id and a cursor are the trail's.
+  get_record_activity: {
+    record_id: { kind: "record_ref" },
+    after: { kind: "scalar" }
+  },
+  undo_record_change: {
+    record_id: { kind: "record_ref" },
+    entry_id: { kind: "scalar" }
+  },
+  // `table_id` names the table whose rows the undo changes, moves to the trash and brings back; a run's id is the
+  // trail's.
+  undo_record_changes: {
+    table_id: { kind: "table_ref", rows: "remove" },
+    record_ids: { kind: "record_refs" },
+    workflow_execution_id: { kind: "scalar" }
+  },
   // ─── Query surfaces ────────────────────────────────────────────────────
   query_records: {
     table_id: { kind: "table_ref", rows: "none" },
@@ -28163,33 +28243,34 @@ async function evaluateBinary(op, leftExpr, rightExpr, ctx) {
         assertCheap(ctx.evaluation_budget, left, right);
         assertTextWithin("+", typeof left === "string" ? null : left, typeof right === "string" ? null : right);
       }
-      const sum2 = addOrConcat(left, right, () => assertNumber(left, "add", "left") + assertNumber(right, "add", "right"));
+      const sum2 = addOrConcat(left, right, () => addDecimal(assertNumber(left, "add", "left"), assertNumber(right, "add", "right")));
       charge(ctx, builtSize(sum2));
       return sum2;
     }
     case "sub":
-      return assertNumber(left, "sub", "left") - assertNumber(right, "sub", "right");
+      return subtractDecimal(assertNumber(left, "sub", "left"), assertNumber(right, "sub", "right"));
     case "mul":
-      return assertNumber(left, "mul", "left") * assertNumber(right, "mul", "right");
+      return multiplyDecimal(assertNumber(left, "mul", "left"), assertNumber(right, "mul", "right"));
     case "div": {
       const r = assertNumber(right, "div", "right");
       if (r === 0) {
         throw new WorkflowEvalError("Division by zero", { kind: "binary", at: "div" });
       }
-      return assertNumber(left, "div", "left") / r;
+      return divideDecimal(assertNumber(left, "div", "left"), r);
     }
     case "mod": {
       const r = assertNumber(right, "mod", "right");
       if (r === 0) {
         throw new WorkflowEvalError("Modulo by zero", { kind: "binary", at: "mod" });
       }
-      return assertNumber(left, "mod", "left") % r;
+      return moduloDecimal(assertNumber(left, "mod", "left"), r);
     }
   }
 }
 function looseEq(a, b) {
   if (isComposite(a) && b !== null && b !== void 0 && !isComposite(b)) return looseEq(textOf(a), b);
   if (isComposite(b) && a !== null && a !== void 0 && !isComposite(a)) return looseEq(a, textOf(b));
+  if (typeof a === "number" && typeof b === "number") return compareDecimal(a, b) === 0;
   return a == b;
 }
 function isComposite(value) {
@@ -28204,6 +28285,7 @@ function isScalar(value) {
   return typeof value === "string" || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint";
 }
 function strictEq(a, b) {
+  if (typeof a === "number" && typeof b === "number") return compareDecimal(a, b) === 0;
   return a === b;
 }
 function compareOrdered(a, b) {
@@ -28211,7 +28293,7 @@ function compareOrdered(a, b) {
     return NaN;
   }
   if (typeof a === "number" && typeof b === "number") {
-    return a - b;
+    return compareDecimal(a, b);
   }
   if (typeof a === "string" && typeof b === "string") {
     return a < b ? -1 : a > b ? 1 : 0;
@@ -28986,6 +29068,7 @@ function useAppContext() {
   const { data, error: error51, refetch } = useKey(APP_CONTEXT_KEY, readContext, { focus: false, arrival: false });
   return {
     memberId: data?.member_id ?? null,
+    insider: data !== void 0 && data.member_id !== null && data.group_ids !== void 0,
     groupIds: data?.group_ids ?? null,
     absences: data?.absences ?? null,
     openableApps: data?.openable_apps ?? null,
@@ -30510,7 +30593,7 @@ function evaluateCondition(record2, fieldByKey, looseCondition, memberContext, f
     if (reading.unit !== void 0 && filterCondition.value !== null && filterCondition.value !== void 0) {
       const factor = rowUnitFactor(reading.unit, data);
       if (factor === void 0) return false;
-      const inBase = { ...filterCondition, value: filterCondition.value * reading.unit.factor };
+      const inBase = { ...filterCondition, value: multiplyExactly(filterCondition.value, reading.unit.factor) };
       return matchCell(columnValue, field, inBase, looseCondition, memberContext, fileFacts, factor);
     }
   }
@@ -30619,7 +30702,7 @@ function matchCell(cell, field, filterCondition, looseCondition, memberContext,
       matches = foldedValue !== void 0 && needles.some((needle) => foldedValue.includes(needle));
     }
   } else if (filterCondition.type === "number") {
-    const numberValue = typeof columnValue === "number" ? columnValue * figureFactor : columnValue;
+    const numberValue = typeof columnValue === "number" ? multiplyExactly(columnValue, figureFactor) : columnValue;
     if (filterCondition.operator === "is_empty") {
       matches = !numberValue && numberValue !== 0;
     } else if (filterCondition.operator === "is_not_empty") {
@@ -32671,8 +32754,7 @@ function oneQueryAlias(entity) {
 var NO_ENTRIES = [];
 function useRecordActivity(entity, record_id, options = {}) {
   const { after } = options;
-  const { memberId, resolved } = useAppContext();
-  const available = memberId !== null;
+  const { insider: available, resolved } = useAppContext();
   const page = useKey(
     available ? JSON.stringify(["activity", entity, record_id, after ?? null]) : null,
     () => rpc("activity.list", { entity, record_id, ...after === void 0 ? {} : { after } }),
@@ -32688,6 +32770,12 @@ function useRecordActivity(entity, record_id, options = {}) {
     refetch: page.refetch
   };
 }
+async function undoRecordChange(entity, record_id, entry_id) {
+  const result = await rpc("activity.undo", { entity, record_id, entry_id });
+  refetchReads([listQueryAlias(entity)]);
+  await readsAnswered([oneQueryAlias(entity)]);
+  return result;
+}
 
 // src/recording.ts
 import { useCallback as useCallback7, useMemo as useMemo4, useSyncExternalStore as useSyncExternalStore3 } from "react";
@@ -33031,6 +33119,7 @@ export {
   requestGeofencedLocation,
   row,
   rpc,
+  undoRecordChange,
   urlParam,
   useAgentRun,
   useAgentRuns,

package/dist/router.js

@@ -2,7 +2,7 @@ import {
   isEmbedded,
   postHostNotification,
   setUrlParams
-} from "./chunk-NZXJENJ2.js";
+} from "./chunk-MK4DBY6R.js";
 
 // src/router.tsx
 import { useEffect } from "react";

package/dist/rpc.d.ts

@@ -9,7 +9,7 @@ import { type UrlParams, type UrlParamsPatch } from "./url_params.js";
  *   app  → host: { id, op, payload }
  *   host → app:  { id, type: "result", data } | { id, type: "error", message }
  */
-export type RpcOp = "query" | "export" | "field_options" | "workflow" | "agentRuns" | "agentRun.get" | "agentRun.cancel" | "upload" | "file.rename" | "members" | "context" | "write_model" | "prediction_miss" | "openExternal" | "openApp" | "askAi" | "urlState.get" | "urlState.set" | "folder.get" | "folder.set" | "comments.list" | "comments.create" | "comments.update" | "comments.delete" | "comments.counts" | "activity.list" | "recording.start" | "recording.stop";
+export type RpcOp = "query" | "export" | "field_options" | "workflow" | "agentRuns" | "agentRun.get" | "agentRun.cancel" | "upload" | "file.rename" | "members" | "context" | "write_model" | "prediction_miss" | "openExternal" | "openApp" | "askAi" | "urlState.get" | "urlState.set" | "folder.get" | "folder.set" | "comments.list" | "comments.create" | "comments.update" | "comments.delete" | "comments.counts" | "activity.list" | "activity.undo" | "recording.start" | "recording.stop";
 export interface AgentRunPayload {
     alias: string;
     session_id: string;

package/dist/shared_types.d.ts

@@ -3,7 +3,8 @@
  * `scripts/build_sdk.mjs`, because that package is private and ships in no
  * tarball. Written at every build, never edited.
  */
-export type ActivityEntry = { changes: { field_id: string; label: string; before: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; after: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; removed?: true | undefined; }[]; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "change"; created?: true | undefined; } | { comment: { id: string; body: string; mentions: { id: string; name: string; }[]; files?: { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | undefined; }; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "comment"; };
+export type ActivityEntry = { undoable: boolean; changes: { field_id: string; label: string; before: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; after: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; removed?: true | undefined; }[]; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "change"; created?: true | undefined; undo?: true | undefined; undone?: { by: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; } | undefined; } | { comment: { id: string; body: string; mentions: { id: string; name: string; }[]; files?: { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | undefined; }; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "comment"; };
+export type ActivityUndoResult = { reverted: { field_id: string; label: string; }[]; kept: { field_id: string; label: string; reason: "changed_since" | "refused"; }[]; };
 export type AppAbsence = { member: { id: string; name: string; }; stand_in: { id: string; name: string; }; starts_on: string; ends_on: string; group_ids: string[]; };
 /** The file an app export made, as a link to download it: no workspace file, so no id, and kept a day. */
 export type ExportedFile = {

package/dist/store.d.ts

@@ -4,6 +4,8 @@ export type Fetcher<T> = (askedAt: number, current: T | undefined) => Promise<T>
 export declare function tick(): number;
 /** Ask again every key reading one of `aliases` — every query key where none is named; an unmounted one on its next mount. */
 export declare function refetchReads(aliases: readonly string[] | undefined): void;
+/** `refetchReads`, settled once every key a screen reads now holds an answer asked after this call — or its refusal. */
+export declare function readsAnswered(aliases: readonly string[]): Promise<void>;
 /** The host's push, naming the aliases whose tables moved: each key reading one asked again (`refetchReads`), in one
  *  paint. */
 export declare function refetchPushed(aliases: readonly string[]): void;

package/dist/viewer.d.ts

@@ -10,6 +10,8 @@ export declare function readContext(): Promise<AppContext>;
  */
 export declare function useAppContext(): {
     memberId: string | null;
+    /** The viewer is a signed-in member of the app's organization: the host named them and told their groups. */
+    insider: boolean;
     /** The viewer's member groups, by id; `null` where the host did not say. */
     groupIds: readonly string[] | null;
     /** Who in the organization is away, or will be, and who stands in; `null` where the host did not say. */

package/docs/members_and_options.md

@@ -373,7 +373,7 @@ table's id: read it off a row of the query that renders the badges (`rows[0]?.__
 rather than pasting a `tbl_` id, which a copy of the app cannot carry. Pass `undefined` while no
 row is on screen — no request is sent and `counts` is `{}`.
 
-## Record activity: `useRecordActivity`
+## Record activity: `useRecordActivity`, `undoRecordChange`
 
 Who changed which of a record's fields, and who commented on it — one entry per save
 (`dist/activity.d.ts`). For a JSON app: `entity` is the alias the app's spec names the record's
@@ -383,6 +383,8 @@ entity under.
 const { entries, next, loading, error, available, refetch } = useRecordActivity("job", recordId);
 // The page past it, mounted where the reader asks for more:
 const older = useRecordActivity("job", recordId, { after: next });
+// One change entry put back, as the viewer's own save:
+const { reverted, kept } = await undoRecordChange("job", recordId, entry.id);
 ```
 
 - **Authority: the app's own read of the record.** The server reaches the record through the
@@ -392,8 +394,8 @@ const older = useRecordActivity("job", recordId, { after: next });
   entry. A field taken out of the app while its table keeps it stays hidden; a field gone from its
   table appears where the version serving when it was written read it, marked `removed`. Comments
   appear only where the app declares `comments`.
-- **Members of the app's organization only** — the trail names its people. Standalone, `available`
-  is `false` and nothing is read.
+- **Members of the app's organization only** — the trail names its people. For a public visitor,
+  a member of another organization, and standalone, `available` is `false` and nothing is asked.
 - **One entry per save.** Edits by one actor on one record less than ten minutes apart read as one
   entry: each field from its value before the first edit to its value after the last, a field edited
   back to where it began dropped (and an entry left with nothing). A comment, another actor or a
@@ -401,7 +403,9 @@ const older = useRecordActivity("job", recordId, { after: next });
   its maker's edits after it, however soon, are entries of their own. `at` is the entry's first
   write, `until` its last.
 - **An entry** (`ActivityEntry`) is `kind: "change"` with `changes`, or `kind: "comment"` with
-  `comment: { id, body, mentions }`. `actor`: `{ kind, id, name, image? }` — `member` (a person),
+  `comment: { id, body, mentions }`. A change entry also says `undoable` — the viewer may put it
+  back — `undone: { by, at }` once someone has, and `undo: true` where it is itself the save that
+  put an earlier one back. `actor`: `{ kind, id, name, image? }` — `member` (a person),
   `agent` (an AI acting for a member: the chat, an app's agent, an MCP client — named by that
   member), `workflow` (a workflow on its own, named by the workflow) or `import` (a script over the
   API or the CLI, named by the member whose key ran it). `name` is empty where nothing resolves it.
@@ -411,6 +415,17 @@ const older = useRecordActivity("job", recordId, { after: next });
   `[{ key, label }]` (`readSelect`; each option's label as it was when written), a member field
   `[{ id, name, image? }]`, a link `[{ id, display }]` (`readLinks`), files presigned (`readFiles`),
   `null` for empty.
+- **`undoRecordChange(entity, record_id, entry_id)`** puts one change entry back: each field it
+  changed that the app reads returns to what it held before the entry, where the record still holds
+  what the entry wrote. It answers `{ reverted, kept }`: the fields put back (`{ field_id, label }`),
+  and those left as they stand with a `reason` — `changed_since` (someone changed it since) or
+  `refused` (the table refused the write: a lock, a check). A field already holding what it held
+  before is in neither. The write is the viewer's own save: they hold `write_data` on the table as
+  the call arrives, on a row their own row rule covers, and the record's lock, the table's checks
+  and its write rules answer as for any save of theirs. `undoable` is `false`, and the call
+  refused, for the entry that made the record, an entry that is an undo, one already put back, and
+  a viewer who may not write the record.
+  The undo is an entry of its own; the answer arrives once the record's reads are read anew.
 - **Pages**: newest first, about thirty entries each; `next` is where the trail goes on —
   `undefined` at its end. A page may hold fewer entries and still say `next` where the trail it read
   held little the reader may see.
@@ -428,4 +443,5 @@ const older = useRecordActivity("job", recordId, { after: next });
 | `useViewer` | member id (view-as target) | `null` |
 | `useWorkspaceTimezone` / `useWorkspaceCurrency` | ✓ | ✓ |
 | `useComments` / `useCommentCounts` | ✓ when capability declared | ✗ `available: false` |
-| `useRecordActivity` | ✓ the app's organization's members | ✗ `available: false` |
+| `useRecordActivity` | ✓ the app's organization's members | ✗ `available: false`, nothing asked |
+| `undoRecordChange` | ✓ a member holding the table's write, on a row they may write | ✗ rejects |

package/docs/runtime.md

@@ -210,6 +210,7 @@ surfaces:
 |---|---|---|
 | `query`, `field_options`, `workflow`, `members`, `context`, `upload`, `urlState.get/set`, `openExternal` | yes | yes |
 | `comments.*` | yes | rejects — `"Comments are available only in embedded apps — a signed-in member is required."` |
+| `activity.list`, `activity.undo` | yes, for a member of the app's organization; `activity.undo` for one who may write the record. A host that does not carry the op answers `"Unknown RPC op: activity.undo"` | rejects — `"A record's activity is available only in embedded apps — a signed-in member is required."` |
 | `agentRun` (streaming, internal to `useAgentRun`) | yes | yes |
 | `agentRun.get`, `agentRun.cancel` | yes | yes |
 | `agentRuns` (session history) | **no** — the product host doesn't implement it either (`"Unknown RPC op: agentRuns"`) | rejects — a standalone caller is anonymous, and a history is its member's (`"App agent runs require an authenticated member …"`) |