@lotics/app-sdk 0.118.1 → 0.120.0

package/AGENTS.md

@@ -20,7 +20,7 @@ This file is the index. The **exact type** of anything is its shipped declaratio
 | [docs/workflows.md](./docs/workflows.md) | **The workflow-BODY reference** — the JS subset a body may use, opaque `fld_*`/`opt_*` keys, every step form, the accepted sugar, helpers, record-write surfaces, the traps and the verify loop. |
 | [docs/recipes.md](./docs/recipes.md) | Task-shaped how-tos — returning a generated file, returning structured data, parameterized lookups, composable optional filters, cell decoding, testing an AI action without spending credits. |
 | [docs/files.md](./docs/files.md) | Files end to end — `useFileUpload` and its `fidelity` and a photo's `place`, `renameFile` (a new file over the same bytes), `useAttachments`/`useAttachmentPiles`, `readFiles` and presigned URLs (a bearer credential — never logged or persisted), workflow-generated files, naming a zip's entries, the delivery bounds. |
-| [docs/members_and_options.md](./docs/members_and_options.md) | People, select options and comments — `useMembers`, `useFieldOptions`, `useViewer`, `useWorkspaceTimezone`/`useWorkspaceCurrency`, `useAppContext`, the workspace's zone at the root, `useComments`, a record's activity (`useRecordActivity`), a register's imports log (`useImportsLog`, `useImportRun`). |
+| [docs/members_and_options.md](./docs/members_and_options.md) | People, select options and comments — `useMembers`, `useFieldOptions`, `useViewer`, `useWorkspaceTimezone`/`useWorkspaceCurrency`, `useAppContext`, the workspace's zone at the root, `useComments`, a record's activity (`useRecordActivity`). |
 | [docs/navigation_and_state.md](./docs/navigation_and_state.md) | `AppRouter` (embedded/standalone URL model, the screens and `drawers` it reports to the host), `useUrlState` + `urlParam` codecs, `useRecents`, `useFolderPick`. |
 | [docs/ai.md](./docs/ai.md) | `useAgentRun` (structured vs free-text, streaming parts, the agent's ask-back), `askAi`, `useAiContext`, and what the member's own chat agent can do with the app while it is open. |
 | [docs/security.md](./docs/security.md) | **Read before shipping** — the owner-principal model, `is_current_member` scoping, write attribution, group gates, public-app bounds, why a per-input bound is a tenancy floor rather than an authorization check. |

package/dist/{chunk-XL5LZFGB.js → chunk-NZXJENJ2.js}

@@ -174,6 +174,41 @@ function transportErrorMessage(status, parsed) {
   return status < 500 || authored ? jsonMessage : gatewayErrorMessage(status);
 }
 
+// ../shared/src/schemas/app_spec_rules.ts
+function tiersAscend(tiers) {
+  return tiers.every((tier, index) => index === 0 || tier > (tiers[index - 1] ?? tier));
+}
+var bandKey = (band) => `${band.min ?? ""}..${band.max ?? ""}`;
+function bandOf(tiers, figure) {
+  const above = tiers.findIndex((tier) => figure < tier);
+  const at = above < 0 ? tiers.length : above;
+  return { min: tiers[at - 1] ?? null, max: tiers[at] ?? null };
+}
+
+// ../shared/src/utils.ts
+function decimalPlaces(value) {
+  if (Number.isInteger(value)) return 0;
+  const [mantissa = "", exponent = "0"] = String(value).split("e");
+  const fraction = mantissa.split(".")[1]?.length ?? 0;
+  return Math.max(0, fraction - Number(exponent));
+}
+function sumDecimal(values, divisor = 1) {
+  const float = values.reduce((total2, value) => total2 + value, 0) / divisor;
+  if (!values.every(Number.isFinite)) return float;
+  const factor = 10 ** values.reduce((places, value) => Math.max(places, decimalPlaces(value)), 0);
+  const scaled = values.map((value) => Math.round(value * factor));
+  const total = scaled.reduce((sum, value) => sum + value, 0);
+  const exact = Number.isSafeInteger(total) && scaled.every((one, index) => Number.isSafeInteger(one) && one / factor === values[index]);
+  return exact ? total / (factor * divisor) : float;
+}
+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/schemas/read_row.ts
 var RECORD_ID_COLUMN = "__source_record_id";
 
@@ -189,12 +224,19 @@ function aggregateRows(rows, aggregate) {
   const by = aggregate.by ?? [];
   const day = aggregate.day;
   const sum = aggregate.sum;
+  const keyOf = (row, column) => {
+    const tiers = aggregate.bands?.[column];
+    const cell = row[column] ?? null;
+    if (tiers === void 0) return cell;
+    return typeof cell === "number" ? bandKey(bandOf(tiers, cell)) : null;
+  };
   const keyed = /* @__PURE__ */ new Map();
   for (const row of rows) {
-    const key = JSON.stringify([...by.map((column) => row[column] ?? null), ...day === void 0 ? [] : [dayOf(row[day])]]);
-    keyed.set(key, [...keyed.get(key) ?? [], row]);
+    const keys = by.map((column) => keyOf(row, column));
+    const key = JSON.stringify([...keys, ...day === void 0 ? [] : [dayOf(row[day])]]);
+    keyed.set(key, { keys, members: [...keyed.get(key)?.members ?? [], row] });
   }
-  return [...keyed.values()].map((members) => {
+  return [...keyed.values()].map(({ keys, members }) => {
     const [first2] = members;
     const figures = members.flatMap((member) => {
       const value = sum === void 0 ? void 0 : member[sum];
@@ -202,10 +244,10 @@ function aggregateRows(rows, aggregate) {
     });
     return {
       [RECORD_ID_COLUMN]: null,
-      ...Object.fromEntries(by.map((column) => [column, first2?.[column] ?? null])),
+      ...Object.fromEntries(by.map((column, at) => [column, keys[at] ?? null])),
       ...day === void 0 ? {} : { [AGGREGATE_DAY_COLUMN]: dayOf(first2?.[day]) },
       [AGGREGATE_COUNT_COLUMN]: members.length,
-      ...sum === void 0 ? {} : { [AGGREGATE_SUM_COLUMN]: figures.length === 0 ? null : figures.reduce((total, value) => total + value, 0) }
+      ...sum === void 0 ? {} : { [AGGREGATE_SUM_COLUMN]: figures.length === 0 ? null : sumDecimal(figures) }
     };
   });
 }
@@ -992,9 +1034,6 @@ function rpcStandalone(op, payload) {
       return rejectCommentsStandalone();
     case "activity.list":
       return Promise.reject(new Error("A record's activity is available only in embedded apps \u2014 a signed-in member is required."));
-    case "imports.list":
-    case "imports.run":
-      return Promise.reject(new Error("A register's imports log is available only in embedded apps \u2014 a signed-in member is required."));
     case "recording.start":
     case "recording.stop":
       return Promise.reject(
@@ -1200,6 +1239,12 @@ async function standaloneUpload(file, fidelity, place) {
 
 export {
   __export,
+  tiersAscend,
+  bandKey,
+  bandOf,
+  sumDecimal,
+  sample,
+  assertNever,
   AGGREGATE_COUNT_COLUMN,
   AGGREGATE_SUM_COLUMN,
   aggregateRows,

package/dist/index.d.ts

@@ -13,9 +13,6 @@ export { useComments, useCommentCounts } from "./comments.js";
 export type { AppComment, AppCommentAuthor, AppCommentFile, CommentsState, UseCommentsArgs, CommentCountsState, UseCommentCountsArgs, } from "./comments.js";
 export { useRecordActivity } from "./activity.js";
 export type { RecordActivityOptions, RecordActivityState } from "./activity.js";
-export { useImportRun, useImportsLog } from "./imports.js";
-export type { ImportRunState, ImportsLogState, ImportsPageOptions } from "./imports.js";
-export type { ImportRow, ImportRowKind, ImportRun, ImportRunEnd, ImportRunPage, ImportRunStop, ImportsLogPage, ImportWorkflow } from "./shared_types.js";
 export type { ActivityActor, ActivityActorKind, ActivityChange, ActivityComment, ActivityEntry, ActivityValue, RecordActivityPage, } from "./shared_types.js";
 export { useAppContext, useViewer, useWorkspaceCurrency, useWorkspaceTimezone } from "./viewer.js";
 export type { AppAbsence } from "./shared_types.js";

package/dist/index.js

@@ -6,6 +6,9 @@ import {
   aggregateRows,
   anyRecordingLive,
   applyPatch,
+  assertNever,
+  bandKey,
+  bandOf,
   decodeAll,
   encodePatch,
   getUrlParams,
@@ -20,12 +23,15 @@ import {
   rpc,
   rpcAgentRun,
   rpcAgentRunContinue,
+  sample,
   setUrlParams,
   subscribeQueriesChanged,
   subscribeRecordings,
   subscribeUrlParams,
+  sumDecimal,
+  tiersAscend,
   urlParam
-} from "./chunk-XL5LZFGB.js";
+} from "./chunk-NZXJENJ2.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";
@@ -1723,15 +1729,6 @@ 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, {
@@ -1790,6 +1787,9 @@ function getField(obj, field) {
   }
   return value;
 }
+function addends(values2) {
+  return values2.map((value) => typeof value === "number" ? value : 0);
+}
 function countInto(result, key) {
   defineOwn(result, key, (Object.hasOwn(result, key) ? result[key] : 0) + 1);
 }
@@ -1847,14 +1847,10 @@ function sumBy(arr, fieldOrCb) {
   if (typeof fieldOrCb !== "string") {
     throw new Error("sumBy: second arg must be a function or field path string");
   }
-  return arr.reduce((sum2, item) => {
-    const val = getField(item, fieldOrCb);
-    return sum2 + (typeof val === "number" ? val : 0);
-  }, 0);
+  return sumDecimal(addends(arr.map((item) => getField(item, fieldOrCb))));
 }
 async function sumByCallback(arr, cb) {
-  const values2 = await callEach(arr, cb);
-  return values2.reduce((sum2, val) => sum2 + (typeof val === "number" ? val : 0), 0);
+  return sumDecimal(addends(await callEach(arr, cb)));
 }
 function meanBy(arr, fieldOrCb) {
   if (!Array.isArray(arr)) {
@@ -1865,19 +1861,13 @@ function meanBy(arr, fieldOrCb) {
   }
   if (isCallback(fieldOrCb)) {
     assertCallbackInput("meanBy", arr);
-    return callEach(arr, fieldOrCb).then(
-      (vals) => vals.reduce((acc, v) => acc + (typeof v === "number" ? v : 0), 0) / arr.length
-    );
+    return callEach(arr, fieldOrCb).then((values2) => sumDecimal(addends(values2), arr.length));
   }
   const field = fieldOrCb;
   if (typeof field !== "string") {
     throw new Error("meanBy: second arg must be a function or field path string");
   }
-  const sum2 = arr.reduce((acc, item) => {
-    const val = getField(item, field);
-    return acc + (typeof val === "number" ? val : 0);
-  }, 0);
-  return sum2 / arr.length;
+  return sumDecimal(addends(arr.map((item) => getField(item, field))), arr.length);
 }
 function minBy(arr, fieldOrCb) {
   if (!Array.isArray(arr)) {
@@ -2842,9 +2832,7 @@ function mean(arr) {
   if (present.length === 0) {
     return null;
   }
-  const numArr = present;
-  const total = numArr.reduce((a, b) => a + b, 0);
-  const result = total / numArr.length;
+  const result = present.every((item) => typeof item === "number") ? sumDecimal(present, present.length) : NaN;
   if (isNaN(result)) {
     throw new Error("mean: array contains non-numeric values");
   }
@@ -2923,7 +2911,11 @@ function sum(arr) {
   if (!Array.isArray(arr)) {
     throw new Error("sum: expected array, got " + typeof arr);
   }
-  return arr.reduce((a, b) => a + b, 0);
+  const present = arr.filter((item) => item != null);
+  if (!present.every((item) => typeof item === "number")) {
+    throw new Error("sum: array contains non-numeric values");
+  }
+  return sumDecimal(present);
 }
 function abs(n) {
   if (n == null) return null;
@@ -5955,11 +5947,10 @@ function parseExpression(expression) {
   return parseWholeExpression(expression, astFactory);
 }
 function evaluateJsExpression(expression, data, additionalFunctions, defaultTimezone) {
-  const timezoneAwareFunctions = createTimezoneAwareFunctions(defaultTimezone);
   const expr2 = parseWholeExpression(expression, astFactory);
   const result = expr2?.evaluate({
     ...data,
-    ...timezoneAwareFunctions,
+    ...timezoneAwareFunctions(defaultTimezone),
     ...additionalFunctions
   });
   return result;
@@ -6116,6 +6107,16 @@ function createTimezoneAwareFunctions(defaultTimezone) {
     ...expression_type_exports
   };
 }
+var MAX_HELD_TIMEZONES = 512;
+var functionsByTimezone = /* @__PURE__ */ new Map();
+function timezoneAwareFunctions(defaultTimezone) {
+  const held2 = functionsByTimezone.get(defaultTimezone);
+  if (held2 !== void 0) return held2;
+  if (functionsByTimezone.size >= MAX_HELD_TIMEZONES) functionsByTimezone.clear();
+  const built = Object.freeze(createTimezoneAwareFunctions(defaultTimezone));
+  functionsByTimezone.set(defaultTimezone, built);
+  return built;
+}
 var numericAlphabet = customAlphabet("0123456789");
 function assertRandomLength(helper, length2) {
   if (length2 > MAX_RANDOM_LENGTH) {
@@ -21239,19 +21240,17 @@ function aggregateNumberField(values2, operation) {
   }
   switch (operation) {
     case "sum": {
-      const sum2 = numericValues.reduce((acc, val) => acc + val, 0);
-      return { result: sum2 };
+      return { result: sumDecimal(numericValues) };
     }
     case "avg": {
-      const sum2 = numericValues.reduce((acc, val) => acc + val, 0);
-      const average = sum2 / numericValues.length;
+      const average = sumDecimal(numericValues, numericValues.length);
       return { result: average };
     }
     case "median": {
       const sorted = [...numericValues].sort((a, b) => a - b);
       const middle = Math.floor(sorted.length / 2);
       if (sorted.length % 2 === 0) {
-        const median = (sorted[middle - 1] + sorted[middle]) / 2;
+        const median = sumDecimal([sorted[middle - 1], sorted[middle]], 2);
         return { result: median };
       } else {
         return { result: sorted[middle] };
@@ -21268,7 +21267,7 @@ function aggregateNumberField(values2, operation) {
     case "range": {
       const min3 = Math.min(...numericValues);
       const max3 = Math.max(...numericValues);
-      const range2 = max3 - min3;
+      const range2 = sumDecimal([max3, -min3]);
       return { result: range2 };
     }
     default:
@@ -25244,9 +25243,6 @@ var workflowSchema = zod_default.object({
   metadata: workflowMetadataSchema.nullable().optional().describe("Metadata for the workflow"),
   current_version: zod_default.number().int().describe("Current version number"),
   enabled: zod_default.boolean().describe("Whether this workflow is active"),
-  imports_into: zod_default.string().nullable().optional().describe(
-    "The table this workflow brings data into: its runs are the imports log of a register over that table that keeps one (`register.imports`). Null, it imports into none."
-  ),
   workspace_id: zod_default.string().describe("ID of the workspace this workflow belongs to"),
   created_at: zod_default.string().describe("Timestamp when workflow was created"),
   updated_at: zod_default.string().describe("Timestamp of last update")
@@ -25986,7 +25982,7 @@ var queryFromTableNodeSchema = zod_default.object({
   table_id: zod_default.string().describe("Source table ID"),
   filter: tableRecordFiltersSchema.optional(),
   search: zod_default.string().optional().describe(
-    "Free-text search across the record's indexed text (the maintained `search_document`): diacritics- and case-insensitive, trigram-indexed. It matches ALL text-bearing fields of the row, not just the query's projected columns \u2014 bound search-bearing queries accordingly. AND-ed with `filter`. Templatable with `{{params.x}}`. Prefer this over an OR-group of per-field `contains` for a search box \u2014 it can't silently miss a field and matches accented text."
+    "Free-text search across the record's text: every term must appear, as a substring, diacritics- and case-insensitive. It matches ALL text-bearing fields of the row, not just the query's projected columns \u2014 bound search-bearing queries accordingly. AND-ed with `filter`. Templatable with `{{params.x}}`. Prefer this over an OR-group of per-field `contains` for a search box \u2014 it can't silently miss a field and matches accented text."
   ),
   sort: tableRecordSortSchema.optional(),
   limit: zod_default.number().optional()
@@ -26021,12 +26017,20 @@ var queryGroupBucketKeySchema = zod_default.object({
     output: zod_default.string().describe("Output column name for the bucket.")
   })
 });
-var queryGroupKeySchema = zod_default.union([zod_default.string(), queryGroupBucketKeySchema]);
+var bandTiersSchema = zod_default.array(zod_default.number()).min(1).refine(tiersAscend, "Breakpoints ascend, each above the one before it.");
+var queryGroupBandKeySchema = zod_default.object({
+  band: zod_default.object({
+    source: zod_default.string().describe("Input number column to band."),
+    tiers: bandTiersSchema.describe("Ascending breakpoints. A value on one is in the band above it."),
+    output: zod_default.string().describe("Output column name for the band's key.")
+  })
+});
+var queryGroupKeySchema = zod_default.union([zod_default.string(), queryGroupBucketKeySchema, queryGroupBandKeySchema]);
 var queryGroupNodeSchema = zod_default.object({
   kind: zod_default.literal("group"),
   from: zod_default.lazy(() => queryNodeSchema),
   by: zod_default.array(queryGroupKeySchema).describe(
-    "Group keys: input column names, or `{ bucket: { source, granularity, output } }` date buckets. A bucket truncates a date/datetime column to the bucket START as a `date` column (wall-clock semantics; `week` starts on ISO Monday; null source \u2192 null bucket). Empty = single-row aggregate."
+    "Group keys: input column names, `{ bucket: { source, granularity, output } }` date buckets, or `{ band: { source, tiers, output } }` bands of a number. A bucket truncates a date/datetime column to the bucket START as a `date` column (wall-clock semantics; `week` starts on ISO Monday; null source \u2192 null bucket). A band answers a text column holding `from..to`, the two breakpoints the value stands between (the lower held, the upper not; an open end empty: `..10`, `10..20`, `20..`); no number \u2192 null band. Empty = single-row aggregate."
   ),
   sets: zod_default.array(zod_default.array(zod_default.string())).min(1).optional().describe(
     "Several groupings answered by one read: each lists the `by` outputs it groups by (`[]` = one row over every row). A key outside a row's set is null there, and `__grouping` holds the set's bits: one per `by` key it leaves out, the last key the lowest. Absent: one grouping by every key."
@@ -28984,6 +28988,7 @@ function useAppContext() {
     memberId: data?.member_id ?? null,
     groupIds: data?.group_ids ?? null,
     absences: data?.absences ?? null,
+    openableApps: data?.openable_apps ?? null,
     commentsEnabled: data?.comments_enabled ?? false,
     recordingEnabled: data?.recording_enabled === true,
     timezone: data?.timezone,
@@ -31345,6 +31350,13 @@ var HELPERS2 = new Set(Object.keys(createTimezoneAwareFunctions()));
 var BY_LOWERCASE = new Map([...HELPERS2].map((name) => [name.toLowerCase(), name]));
 
 // ../shared/src/formula.ts
+function parseOnce(evaluable) {
+  try {
+    return { kind: "parsed", expression: parseExpression(evaluable) };
+  } catch (error51) {
+    return { kind: "unparsable", error: error51 };
+  }
+}
 function prepareFormulaContext(fields) {
   const formulaFields = fields.filter((field) => field.type === "formula");
   const { sortedFields, circularDependencies } = buildDependencyGraph(formulaFields, fields);
@@ -31380,8 +31392,9 @@ function prepareFormulaContext(fields) {
 function computeFormulaFieldsWithContext(row2, fields, context, linkedTableRecords = /* @__PURE__ */ new Map(), linkedTableFields = /* @__PURE__ */ new Map(), timezone, loadedLinkKeys, linkExpandedTableIds, fileFacts, memberNames) {
   const result = { ...row2 };
   const mayRecompute = (linkKey) => loadedLinkKeys === void 0 || loadedLinkKeys.has(linkKey) || isEmptyFieldValue(row2[linkKey]);
+  const computes = (key) => context.computedAggregates === void 0 || context.computedAggregates.has(key);
   for (const { field, sourceField } of context.rollupFields) {
-    if (!mayRecompute(sourceField.key)) continue;
+    if (!computes(field.key) || !mayRecompute(sourceField.key)) continue;
     if (linkedTableRecords.has(sourceField.table_id) && linkedTableFields.has(sourceField.table_id)) {
       const linkedRecords = linkedTableRecords.get(sourceField.table_id) ?? [];
       const linkedTableFieldsArray = linkedTableFields.get(sourceField.table_id) ?? [];
@@ -31431,7 +31444,7 @@ function computeFormulaFieldsWithContext(row2, fields, context, linkedTableRecor
     }
   }
   for (const { field, sourceField } of context.lookupFields) {
-    if (!mayRecompute(sourceField.key)) continue;
+    if (!computes(field.key) || !mayRecompute(sourceField.key)) continue;
     if (linkedTableRecords.has(sourceField.table_id)) {
       const linkedRecords = linkedTableRecords.get(sourceField.table_id);
       const linkedFieldsArray = linkedTableFields.get(sourceField.table_id);
@@ -31479,7 +31492,7 @@ function computeFormulaFieldsWithContext(row2, fields, context, linkedTableRecor
     if (context.circularDependencies.has(formulaField.key)) {
       continue;
     }
-    if (prepared.refs.evaluable === null) {
+    if (prepared.parsed === void 0) {
       const refs = prepared.refs.unresolved.map((ref) => `{${ref}}`).join(", ");
       result[formulaField.key] = `${FORMULA_ERROR_PREFIX}${refs} ${prepared.refs.unresolved.length === 1 ? "is not a field" : "are not fields"} on this table`;
       evaluationContext[formulaField.key] = null;
@@ -31497,7 +31510,7 @@ function computeFormulaFieldsWithContext(row2, fields, context, linkedTableRecor
     }
     const everyReferenceEmpty = referencedKeys.length > 0 && referencedKeys.every((fieldKey) => evaluationContext[fieldKey] === null);
     const evaluated2 = evaluateFormulaWithJS(
-      prepared.refs.evaluable,
+      prepared.parsed,
       { data: evaluationContext },
       timezone,
       everyReferenceEmpty
@@ -31591,10 +31604,8 @@ function buildDependencyGraph(formulaFields, allFields) {
   for (const field of formulaFields) {
     graph.set(field.key, /* @__PURE__ */ new Set());
     inDegree.set(field.key, 0);
-    fieldMap.set(field.key, {
-      field,
-      refs: prepareFormulaExpression(field.formula.expression, allFields)
-    });
+    const refs = prepareFormulaExpression(field.formula.expression, allFields);
+    fieldMap.set(field.key, { field, refs, parsed: refs.evaluable === null ? void 0 : parseOnce(refs.evaluable) });
   }
   for (const field of formulaFields) {
     for (const referencedKey of fieldMap.get(field.key).refs.referencedKeys) {
@@ -31674,17 +31685,18 @@ function readsFieldsOnlyThroughEmptinessPredicates(node, taken) {
 function isFieldRead(node) {
   return node !== void 0 && node.type === "Index" && node.receiver.type === "ID" && node.receiver.value === "data";
 }
-function evaluateFormulaWithJS(preparedExpression, data, timezone, everyReferenceEmpty) {
+function evaluateFormulaWithJS(parsed, data, timezone, everyReferenceEmpty) {
   try {
+    if (parsed.kind === "unparsable") throw parsed.error;
+    const scope = { ...timezoneAwareFunctions(timezone), data: data.data };
     if (everyReferenceEmpty) {
-      const helpers = createTimezoneAwareFunctions(timezone);
       const taken = (condition2) => {
-        const answer = condition2.evaluate({ ...data, ...helpers });
+        const answer = condition2.evaluate(scope);
         return typeof answer === "boolean" ? answer : void 0;
       };
-      if (!readsFieldsOnlyThroughEmptinessPredicates(parseExpression(preparedExpression), taken)) return null;
+      if (!readsFieldsOnlyThroughEmptinessPredicates(parsed.expression, taken)) return null;
     }
-    const result = evaluateJsExpression(preparedExpression, data, void 0, timezone);
+    const result = parsed.expression?.evaluate(scope);
     if (result === null || result === void 0) {
       return null;
     }
@@ -31749,18 +31761,36 @@ function planFilterTraversal(filter2, aggregatedTableId, aggregatedFields, linke
         );
         if (ids.size === 0) return null;
         return {
-          records: rows.filter((r) => ids.has(r.id)),
+          records: linkedRowsNamed(rows, [...ids]),
           fields: fieldMapOf(hop.table_id, hopFields)
         };
       }
     }
   };
 }
+var positionsOfFrozenRows = /* @__PURE__ */ new WeakMap();
+function linkedRowPositions(rows) {
+  const frozen = Object.isFrozen(rows);
+  const held2 = frozen ? positionsOfFrozenRows.get(rows) : void 0;
+  if (held2 !== void 0) return held2;
+  const positions = /* @__PURE__ */ new Map();
+  for (let at2 = 0; at2 < rows.length; at2++) {
+    const of = positions.get(rows[at2].id);
+    if (of === void 0) positions.set(rows[at2].id, [at2]);
+    else of.push(at2);
+  }
+  if (frozen) positionsOfFrozenRows.set(rows, positions);
+  return positions;
+}
+function linkedRowsNamed(rows, ids) {
+  const positions = linkedRowPositions(rows);
+  const found = [...new Set(ids)].flatMap((id) => positions.get(id) ?? []);
+  return found.sort((a, b) => a - b).map((at2) => rows[at2]);
+}
 function calculateRollupValue(value, fieldType, allLinkedTableRecords, aggregateOption, filter2, linkedTableFields, subject, traversalContext, fileFacts) {
   if (aggregateOption?.operation === "count") {
     if (!value) return 0;
-    const recordIds2 = extractRecordLinkIds(value);
-    let relevantRecords2 = allLinkedTableRecords.filter((r) => recordIds2.includes(r.id));
+    let relevantRecords2 = linkedRowsNamed(allLinkedTableRecords, extractRecordLinkIds(value));
     if (filter2 && linkedTableFields) {
       relevantRecords2 = filterRecords(relevantRecords2, linkedTableFields, filter2, null, traversalContext, fileFacts);
     }
@@ -31769,8 +31799,7 @@ function calculateRollupValue(value, fieldType, allLinkedTableRecords, aggregate
   if (!value || !allLinkedTableRecords.length || !aggregateOption?.field_key) {
     return null;
   }
-  const recordIds = extractRecordLinkIds(value);
-  let relevantRecords = allLinkedTableRecords.filter((record2) => recordIds.includes(record2.id));
+  let relevantRecords = linkedRowsNamed(allLinkedTableRecords, extractRecordLinkIds(value));
   if (relevantRecords.length === 0) {
     return null;
   }
@@ -31786,9 +31815,11 @@ function calculateLookupValue(value, linkedRecords, lookupFieldKey, linkedField,
   if (!linkedRecords.length || !lookupFieldKey) {
     return null;
   }
-  const recordIds = extractRecordLinkIds(value);
-  const recordMap = new Map(linkedRecords.map((record2) => [record2.id, record2]));
-  const relevantRecords = recordIds.map((id) => recordMap.get(id)).filter((record2) => record2 !== void 0);
+  const positions = linkedRowPositions(linkedRecords);
+  const relevantRecords = extractRecordLinkIds(value).flatMap((id) => {
+    const at2 = positions.get(id)?.at(-1);
+    return at2 === void 0 ? [] : [linkedRecords[at2]];
+  });
   if (relevantRecords.length === 0) {
     return null;
   }
@@ -32099,7 +32130,15 @@ function groupsOf(totals, side) {
   if (!totals.by.every(({ field_key }) => side.cells.has(field_key) && !side.unknown.has(field_key))) return null;
   const [only] = totals.by;
   if (totals.each && only !== void 0) return Object.keys(countsOf([{ cell: side.cells.get(only.field_key) }], "cell"));
-  return [JSON.stringify(totals.by.map(({ field_key }) => storedCellOf(side.cells.get(field_key))))];
+  return [
+    JSON.stringify(
+      totals.by.map(({ field_key, tiers }) => {
+        const cell = side.cells.get(field_key);
+        if (tiers === void 0) return storedCellOf(cell);
+        return typeof cell === "number" ? bandKey(bandOf(tiers, cell)) : null;
+      })
+    )
+  ];
 }
 function groupOfRow(totals, row2) {
   return totals.each ? String(row2[VALUE_COLUMN]) : JSON.stringify(totals.by.map(({ output }) => storedCellOf(row2[output])));
@@ -32153,12 +32192,12 @@ function overlayTotals(over, totals, admits, closed, rows) {
 function totalsAsked(shape, aggregate) {
   const table = shape.rows?.table_id;
   if (table === void 0 || aggregate.day !== void 0) return null;
-  const by = (aggregate.by ?? []).map((column) => ({ output: column, field_key: fieldKeyOf(shape, column, table) }));
+  const by = (aggregate.by ?? []).map((column) => ({ output: column, field_key: fieldKeyOf(shape, column, table), tiers: aggregate.bands?.[column] }));
   const sum2 = aggregate.sum === void 0 ? void 0 : fieldKeyOf(shape, aggregate.sum, table);
   if (by.some((one) => one.field_key === void 0) || aggregate.sum !== void 0 && sum2 === void 0) return null;
   return {
     table_id: table,
-    by: by.flatMap(({ output, field_key }) => field_key === void 0 ? [] : [{ output, field_key }]),
+    by: by.flatMap(({ output, field_key, tiers }) => field_key === void 0 ? [] : [{ output, field_key, ...tiers === void 0 ? {} : { tiers } }]),
     aggregates: [{ output: AGGREGATE_COUNT_COLUMN, operation: "count" }, ...sum2 === void 0 ? [] : [{ output: AGGREGATE_SUM_COLUMN, operation: "sum", field_key: sum2 }]],
     each: false
   };
@@ -32650,75 +32689,6 @@ function useRecordActivity(entity, record_id, options = {}) {
   };
 }
 
-// src/imports.ts
-import { useEffect as useEffect5 } from "react";
-var NO_WORKFLOWS = [];
-var NO_RUNS = [];
-var NO_ROWS = [];
-var IMPORTS_BURST_QUIET_MS = 2e3;
-function useImportsLog(entity, options = {}) {
-  const { after } = options;
-  const { memberId, resolved } = useAppContext();
-  const member = memberId !== null;
-  const page = useKey(
-    member ? JSON.stringify(["imports", entity, after ?? null]) : null,
-    () => rpc("imports.list", after === void 0 ? {} : { after })
-  );
-  useAfterBurst(member ? entity : null, page.refetch);
-  const bridged = !refusedByHost(page.error, "imports.list");
-  const log = page.data?.kind === "log" ? page.data : void 0;
-  return {
-    workflows: log?.workflows ?? NO_WORKFLOWS,
-    runs: log?.runs ?? NO_RUNS,
-    next: log?.next,
-    // Waiting on the context counts as loading.
-    loading: member ? page.loading : !resolved,
-    error: bridged ? page.error?.message ?? null : null,
-    available: member && bridged && page.data?.kind !== "none",
-    refetch: page.refetch
-  };
-}
-function useImportRun(entity, run_id, options = {}) {
-  const { after } = options;
-  const { memberId, resolved } = useAppContext();
-  const member = memberId !== null;
-  const page = useKey(
-    member ? JSON.stringify(["import_run", entity, run_id, after ?? null]) : null,
-    () => rpc("imports.run", { run_id, ...after === void 0 ? {} : { after } })
-  );
-  const read2 = page.data?.kind === "run" ? page.data : void 0;
-  useAfterBurst(member && read2?.run.end === "running" ? entity : null, page.refetch);
-  const bridged = !refusedByHost(page.error, "imports.run");
-  return {
-    run: read2?.run,
-    rows: read2?.rows ?? NO_ROWS,
-    next: read2?.next,
-    loading: member ? page.loading : !resolved,
-    error: bridged ? page.error?.message ?? null : null,
-    available: member && bridged && page.data?.kind !== "none",
-    refetch: page.refetch
-  };
-}
-function useAfterBurst(entity, ask2) {
-  useEffect5(() => {
-    if (entity === null) return;
-    const alias = listQueryAlias(entity);
-    let quiet;
-    const unsubscribe = subscribeQueriesChanged((aliases) => {
-      if (!aliases.includes(alias)) return;
-      clearTimeout(quiet);
-      quiet = setTimeout(ask2, IMPORTS_BURST_QUIET_MS);
-    });
-    return () => {
-      clearTimeout(quiet);
-      unsubscribe();
-    };
-  }, [entity, ask2]);
-}
-function refusedByHost(error51, op) {
-  return error51?.message === `Unknown RPC op: ${op}`;
-}
-
 // src/recording.ts
 import { useCallback as useCallback7, useMemo as useMemo4, useSyncExternalStore as useSyncExternalStore3 } from "react";
 var NO_MOCKS = {};
@@ -32917,7 +32887,7 @@ function readSelect(value) {
 }
 
 // src/use_recents.ts
-import { useCallback as useCallback8, useEffect as useEffect6, useRef as useRef4, useState as useState4 } from "react";
+import { useCallback as useCallback8, useEffect as useEffect5, useRef as useRef4, useState as useState4 } from "react";
 var PREFIX = "lotics.recents.";
 function read(storageKey) {
   try {
@@ -32942,7 +32912,7 @@ function useRecents(key, options = {}) {
   const maxRef = useRef4(options.max ?? 5);
   maxRef.current = options.max ?? 5;
   const [recents, setRecents] = useState4(() => read(storageKey).slice(0, maxRef.current));
-  useEffect6(() => {
+  useEffect5(() => {
     setRecents(read(storageKey).slice(0, maxRef.current));
   }, [storageKey]);
   const remember = useCallback8(
@@ -32975,13 +32945,13 @@ function useRecents(key, options = {}) {
 }
 
 // src/use_url_state.ts
-import { useCallback as useCallback9, useEffect as useEffect7, useMemo as useMemo5, useRef as useRef5, useState as useState5 } from "react";
+import { useCallback as useCallback9, useEffect as useEffect6, useMemo as useMemo5, useRef as useRef5, useState as useState5 } from "react";
 function useUrlState(defs) {
   const defsRef = useRef5(defs);
   defsRef.current = defs;
   const [params, setParams] = useState5(peekUrlParams);
   const editedRef = useRef5(false);
-  useEffect7(() => {
+  useEffect6(() => {
     let active = true;
     const apply = (next) => {
       if (active) setParams((prev) => paramsEqual(prev, next) ? prev : next);
@@ -33073,8 +33043,6 @@ export {
   useFieldOptions,
   useFileUpload,
   useFolderPick,
-  useImportRun,
-  useImportsLog,
   useMembers,
   useNewRecord,
   useQueries,

package/dist/router.js

@@ -2,7 +2,7 @@ import {
   isEmbedded,
   postHostNotification,
   setUrlParams
-} from "./chunk-XL5LZFGB.js";
+} from "./chunk-NZXJENJ2.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" | "imports.list" | "imports.run" | "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" | "recording.start" | "recording.stop";
 export interface AgentRunPayload {
     alias: string;
     session_id: string;
@@ -77,6 +77,12 @@ export interface AppContext {
     /** Who in the organization is away, or will be, and who stands in — absent from an older host and for a visitor from
      *  outside the organization. */
     absences?: AppAbsence[];
+    /** The apps of the workspace the viewer can open, each by its id and its name — absent from an older host,
+     *  for a visitor and until the host has listed them. */
+    openable_apps?: {
+        id: string;
+        name: string;
+    }[];
 }
 /** Whether a Lotics host embeds the app, rather than it standing alone on its own origin. */
 export declare function isEmbedded(): boolean;

package/dist/shared_types.d.ts

@@ -3,8 +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: ImportWorkflow[]; 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 AppAbsence = { member: ImportWorkflow; stand_in: ImportWorkflow; starts_on: string; ends_on: string; group_ids: string[]; };
+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 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 = {
   filename: string;
@@ -16,12 +16,14 @@ export type ExportedFile = {
   /** When the server made it, ISO 8601. */
   created_at: string;
 };
-export type ImportRow = { record_id: string; kind: "removed" | "added" | "changed"; at: string; 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; }[]; };
-export type ImportRun = { id: string; workflow: ImportWorkflow; at: string; end: "running" | "done" | "failed" | "partial"; added: number; changed: number; removed: number; until?: string | undefined; stopped?: { step?: string | undefined; reason?: string | undefined; } | undefined; };
-export type ImportWorkflow = { id: string; name: string; };
 /** What an aggregate asks: output columns to group by, an output date grouped by its day, an output number summed. */
 export type QueryAggregate = {
   by?: readonly string[];
+  /**
+   * The `by` columns grouped by the band of their number in place of its value, each with its ascending
+   * breakpoints: the group answers the band's key (`bandKey`) under the column, null for the rows holding no number.
+   */
+  bands?: { readonly [x: string]: readonly number[]; };
   day?: string;
   sum?: string;
 };

package/dist/viewer.d.ts

@@ -14,6 +14,11 @@ export declare function useAppContext(): {
     groupIds: readonly string[] | null;
     /** Who in the organization is away, or will be, and who stands in; `null` where the host did not say. */
     absences: readonly AppAbsence[] | null;
+    /** The apps the viewer can open, by id and name; `null` where the host did not say. */
+    openableApps: readonly {
+        id: string;
+        name: string;
+    }[] | null;
     commentsEnabled: boolean;
     recordingEnabled: boolean;
     timezone: string | undefined;

package/docs/data_fetching.md

@@ -93,7 +93,7 @@ all its calls, and each call states its own `filter`, `sort`, `total` and `rows`
 |---|---|---|---|
 | `enabled` | `boolean` | `true` | `false` = no request is sent, `rows` is `[]`, `loading` is `false`. Flip to `true` to fetch. The gate for search-as-you-type and on-demand detail. Disabling also **hides** previously loaded rows (the cached answer survives; it re-renders instantly when re-enabled). |
 | `revalidateOnFocus` | `boolean` | `true` | `false` = no re-read on window focus / tab return / network reconnect (`refetch()` still works). Keep the default for dashboards; turn off for transient queries (a search bound to an ephemeral term) where a refocus re-run is wasted work and a visible reload. |
-| `revalidateOnChange` | `boolean` | `true` | `false` = no re-read on a realtime push or this app's own write over the query's tables: the rows stay as first read until `refetch()`, this app's own writes still drawn over them — a moment's rows (what an import touched, read beside a live register) that never join the render a push draws. A read of the same call left on the default is its own read, live. |
+| `revalidateOnChange` | `boolean` | `true` | `false` = no re-read on a realtime push or this app's own write over the query's tables: the rows stay as first read until `refetch()`, this app's own writes still drawn over them — a moment's rows, read beside a live screen, that never join the render a push draws. A read of the same call left on the default is its own read, live. |
 | `sort` | `QuerySortKey[]` | — | Runtime sort, applied server-side **after** the named query, over its output columns, each key breaking the ties of the ones before: `{ field_key, order: "asc" \| "desc", blank_position? }` a column's order, or `{ first: [filter, …] }` the rows each filter keeps, in turn, before the rest ([queries](./queries.md)). An empty/omitted array leaves the query's own order intact. Part of the read's key — changing it re-queries. |
 | `filter` | `QueryFilter` | — | Runtime filter, applied server-side after the named query, over its output columns. A single condition or a recursive `{ node_type: "group", logic: "and" \| "or", children }`. Part of the read's key. |
 | `limit` | `number` | — | The first `limit` rows only — a **cap**, not pages; omit to read up to the server's row cap. |

package/docs/members_and_options.md

@@ -261,6 +261,11 @@ host did not say (a visitor from outside the organization, an older host). Both
 context, read once as the app opens. Display only: the workflow body re-checks who may act
 (`current_member_stands_in_for(...)`).
 
+`openableApps` lists the workspace's apps the viewer can open, each by its `id` and its `name` — what a
+way through to a sibling app (`openApp`) is offered by. `null` where the host did not say (standalone, a
+render, an older host, or a page that had not listed its apps when the app opened). Display only: the
+app opened checks the viewer itself.
+
 ## The workspace's zone at the root
 
 An app's root draws nothing until `useAppContext()` has `settled` — where it failed, it draws
@@ -412,45 +417,6 @@ const older = useRecordActivity("job", recordId, { after: next });
 - **Freshness:** read again when a push or this app's own write names the entity's reads, when a
   comment is written or deleted through `useComments`, on focus, and on `refetch()`.
 
-## A register's imports log: `useImportsLog`, `useImportRun`
-
-The workflows marked as importing into the register's table (an automation's `imports_into`) and
-their runs, each with how it ended and how many rows it added, changed and removed; and one run's
-rows, each with its fields before and after (`dist/imports.d.ts`). A JSON app whose model states
-`register.imports: true` keeps it. `entity` is the register's entity alias.
-
-```tsx
-const { workflows, runs, next, loading, error, available, refetch } = useImportsLog("order");
-const { run, rows } = useImportRun("order", runs[0]?.id ?? "");
-```
-
-- **Authority: the app's own reads**, as record activity's: only the fields the app reads appear, and
-  a row counts — and is listed — only where the register's own read reaches it for the viewer; a
-  removed row, where it reached it before it was removed. A row the viewer does not see is in no
-  count and does not make a failed run `partial`.
-- **Members of the app's organization only.** Standalone, in a host that bridges no imports log, and
-  where the register keeps none (the server answers `{ kind: "none" }`), `available` is `false`,
-  `error` is `null` and nothing is shown. Any other refusal is an `error`.
-- **The workflows** (`ImportWorkflow`): `{ id, name }`, every one importing into the table whether
-  or not it has run, by name.
-- **A run** (`ImportRun`): `{ id, workflow: { id, name }, at, until?, end, added, changed, removed,
-  stopped? }`. `end` is `running`, `done`, `failed` (it wrote none of the rows the viewer sees) or
-  `partial` (it failed after writing some). `until` is absent while it runs. A `failed` or `partial`
-  run carries `stopped: { step?, reason? }` (`ImportRunStop`): the description of the step it stopped
-  at, for every viewer; and the error it recorded there, only for a viewer who manages the automation
-  (it can quote data from tables the viewer cannot open) — each absent where the run recorded none.
-- **A run's row** (`ImportRow`): `{ record_id, kind, at, changes }`, one per row however many times
-  the run wrote it — `added`, `removed`, or `changed` (a field the viewer sees left other than the
-  run found it). `changes` are record activity's (`ActivityChange`): an added row's fields from
-  `null`, a removed row's to `null`. Rows come in the order the run first wrote them.
-- **Pages**: up to twenty runs — fewer where they wrote thousands of rows between them, always at
-  least one — or fifty rows; `next` continues — `undefined` at the end. A page of rows may hold fewer
-  and still say `next`, where the rows it looked through were ones the viewer does not see.
-- **Freshness:** the log is read again once pushes naming the entity's rows have stopped for two
-  seconds — an import's writes landing — never with each push, so the register's own rows never wait
-  on it; a run's rows only while it runs. Both are read again on focus and on `refetch()`. A run that
-  wrote nothing pushes nothing.
-
 ## Where each hook works
 
 | Surface | Embedded (signed-in member) | Standalone / public (anonymous) |
@@ -463,4 +429,3 @@ const { run, rows } = useImportRun("order", runs[0]?.id ?? "");
 | `useWorkspaceTimezone` / `useWorkspaceCurrency` | ✓ | ✓ |
 | `useComments` / `useCommentCounts` | ✓ when capability declared | ✗ `available: false` |
 | `useRecordActivity` | ✓ the app's organization's members | ✗ `available: false` |
-| `useImportsLog` / `useImportRun` | ✓ the app's organization's members | ✗ `available: false` |

package/docs/mutations.md

@@ -527,10 +527,10 @@ every read before the request answers:
   leaves it; a created row it admits joins it, standing by the read's order (the call's `sort`,
   then the query's own) where its sort cells are numbers or dates, else first. A row the read does
   not hold that a write may move into it waits for the server, and `pending` says so.
-- **Totals.** A `total`, a count per value (`total: { by }`) or per named filter (`total: { where }`), a group asked with `aggregate` or
-  declared by the query, and a parent's count or sum rollup move by exactly what the written row adds
+- **Totals.** A `total`, a count per value (`total: { by }`) or per named filter (`total: { where }`), a group asked with `aggregate` (by a
+  number's `bands` too) or declared by the query, and a parent's count or sum rollup move by exactly what the written row adds
   or takes away; a group the last row leaves is gone, and a count per value gains the value a row
-  first holds. A mean, an extreme, a distinct count, a group by day, an aggregate with its own
+  first holds. A mean, an extreme, a distinct count, a group by day or by a declared band key, an aggregate with its own
   `filter`, a group none of the read's rows counted in yet, a read whose rows a search or a cap
   decides, or a row the app never read is left
   as the server said it until a read asked after the write answers.

package/docs/queries.md

@@ -775,6 +775,25 @@ Sort by the bucket column for a time series; filter it with date operators for a
 window. **Always bucket server-side** — shipping raw rows to bucket in JS burns the row cap and
 the timeout for nothing.
 
+### Band group keys
+
+`group.by` also accepts a number read by the bands its breakpoints cut:
+
+```jsonc
+{ "band": { "source": "days_late", "tiers": [1, 31, 61], "output": "age" } }
+```
+
+- `source` must be a `number` **column** of the input (checked at bind); `tiers` are its breakpoints,
+  ascending, at least one.
+- The output is a new **`text`** column holding the band as `from..to` — the two breakpoints a row's
+  number stands between, the lower held and the upper not, an open end empty: `..1`, `1..31`,
+  `31..61`, `61..`. A number on a breakpoint is in the band above it. A row holding no number
+  yields a NULL band (its rows group together).
+- A band no row falls in is no group: the answer holds only the bands with rows.
+
+One group per band, however many distinct numbers the rows hold — grouping by the number itself
+answers a group per value, which the row cap cuts.
+
 **Window `aggregates` — the OVER-legal aggregate subset.** Only operations that compile to a single
 legal SQL window call are accepted: **`count`, `sum`, `avg`, `min`, `max`, `earliest`, `latest`,
 `filled`, `checked`, `unchecked`.** The rest cannot take an OVER clause (`median` is an
@@ -870,10 +889,12 @@ template as derived nodes, in this order: `filter` (narrow) → `sort` (order)
   at most 32. It is a
   **second full execution** of the template — sent only where a read asks for its `total`, and
   one count serves every read of the same set ([data_fetching](./data_fetching.md)).
-- **`aggregate: { by?, day?, sum? }`** — the groups of the *filtered* set in place of its rows: one
-  row per value of up to two `by` output columns (a cell holding several values groups by all of
+- **`aggregate: { by?, bands?, day?, sum? }`** — the groups of the *filtered* set in place of its rows: one
+  row per value of up to three `by` output columns (a cell holding several values groups by all of
   them) and per day of a `day` output date, each holding its `by` columns, `__day`, `__count`, and
-  `__sum` of a `sum` output number (`null` where no row holds one). Every column it names is an
+  `__sum` of a `sum` output number (`null` where no row holds one). `bands: { <column>: [breakpoints] }`
+  groups a number column of `by` by its band in place of its value — the column then holds `from..to`
+  as a band group key does (above), `null` for the rows holding no number. Every column it names is an
   output column, like `filter`'s, so what leaves is counts and sums of what a page of the same
   query returns. Sent with `params` and `filter` alone; `truncated` past the row cap. One read
   over a list's rows serves the figures above it — its filter is the list's own.

package/docs/security.md

@@ -11,7 +11,6 @@ Every data operation an app performs — queries, workflows, agent runs — exec
 | Agent runs (`useAgentRun`) | App owner | Yes — requires an authenticated member; runs are private to that member |
 | Comments (`useComments`) | App authority for **access**; the **author** is always the real member | Always — members-only, anonymous callers are rejected |
 | Record activity (`useRecordActivity`) | The app's own read of the record — the entity's read of one row, and only the fields it draws | Always — the app's organization's members only |
-| Imports log (`useImportsLog`, `useImportRun`) | The register's own read — only the rows it reaches for the viewer, and only the fields the app reads | Always — the app's organization's members only |
 
 Consequences of owner authority:
 
@@ -104,7 +103,6 @@ A publicly-shared app (its own origin, or its public link) is reachable by **any
 | Agent runs (`useAgentRun`) | **No** — rejected: agent runs require an authenticated member, and each member's run history is private to them (a guessed session id cannot read another member's thread) |
 | Comments (`useComments`) | **No** — members-only |
 | Record activity (`useRecordActivity`) | **No** — the app's organization's members only |
-| Imports log (`useImportsLog`, `useImportRun`) | **No** — the app's organization's members only |
 | Member roster (`useMembers`) | **No** — same-org members only (below) |
 
 **Warning — `is_current_member` on a public app resolves to the app owner.** An anonymous request has no viewer to bind, so both `is_current_member` and `current_member in_any_group` fall back to the owner's identity and the owner's groups. A "my items" query shows every anonymous visitor the *owner's* items, and a manager-only read template gated on a group the owner belongs to **passes for every anonymous visitor**. Never rely on viewer-bound predicates in a public app.

package/package.json

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

package/dist/imports.d.ts

@@ -1,51 +0,0 @@
-import type { ImportRow, ImportRun, ImportWorkflow } from "./shared_types.js";
-export interface ImportsLogState {
-    /** The workflows importing into the register's table, whether or not they have run. */
-    workflows: ImportWorkflow[];
-    /** Newest first. */
-    runs: ImportRun[];
-    /** Where the log goes on — pass it as `after` to read the page past this one; `undefined` at its end. */
-    next: string | undefined;
-    loading: boolean;
-    error: string | null;
-    /** A signed-in member, in a host that bridges the log, of a register keeping one; otherwise `runs` stays empty. */
-    available: boolean;
-    refetch: () => void;
-}
-export interface ImportRunState {
-    /** The run, as the log lists it; `undefined` until read. */
-    run: ImportRun | undefined;
-    /** In the order the run first wrote them. */
-    rows: ImportRow[];
-    /** Where its rows go on — pass it as `after`; `undefined` at their end. */
-    next: string | undefined;
-    loading: boolean;
-    error: string | null;
-    available: boolean;
-    refetch: () => void;
-}
-export interface ImportsPageOptions {
-    /** A page's `next`: read the page past it. Absent, the first page. */
-    after?: string;
-}
-/** No push over the register's rows for this long ends a burst: longer than the second the server waits at most
- *  between pushes while a run writes. */
-export declare const IMPORTS_BURST_QUIET_MS = 2000;
-/**
- * One page of the register's imports log. `entity` is the alias of the register's entity: the page is asked again once
- * pushes naming its rows have gone quiet.
- *
- * ```tsx
- * const { runs, next } = useImportsLog("order");
- * ```
- */
-export declare function useImportsLog(entity: string, options?: ImportsPageOptions): ImportsLogState;
-/**
- * One page of one run's rows — `run_id` a run's `id` from `useImportsLog` — with the run beside them. Asked again after
- * a burst of pushes over the register's rows only while the run runs: an ended run's rows are what they are.
- *
- * ```tsx
- * const { run, rows, next } = useImportRun("order", runId);
- * ```
- */
-export declare function useImportRun(entity: string, run_id: string, options?: ImportsPageOptions): ImportRunState;