@lotics/app-sdk 0.120.3 → 0.121.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`). |
+| [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 and the undo of one change (`useRecordActivity`, `undoRecordChange`). |
 | [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/activity.d.ts

@@ -1,4 +1,4 @@
-import type { ActivityEntry } from "./shared_types.js";
+import type { ActivityEntry, ActivityUndoResult } from "./shared_types.js";
 export interface RecordActivityState {
     /** Newest first. */
     entries: ActivityEntry[];
@@ -6,7 +6,7 @@ export interface RecordActivityState {
     next: string | undefined;
     loading: boolean;
     error: string | null;
-    /** A signed-in member; standalone nothing is read and `entries` stays empty. */
+    /** A signed-in member of the app's organization; for anyone else nothing is read and `entries` stays empty. */
     available: boolean;
     refetch: () => void;
 }
@@ -25,3 +25,16 @@ export interface RecordActivityOptions {
  * ```
  */
 export declare function useRecordActivity(entity: string, record_id: string, options?: RecordActivityOptions): RecordActivityState;
+/**
+ * Put one change entry of the record's activity back, as the viewer's own save: each field the entry changed returns
+ * to what it held before it where the record still holds what the entry wrote. The answer names the fields put back
+ * (`reverted`) and those left as they stand (`kept`), each with its `reason` — `changed_since`, or `refused` where the
+ * table refused the write (a lock, a check) — and arrives once the record's reads are read anew. Refused for an entry
+ * whose `undoable` is false: the record's making, an undo, an entry already put back, and a viewer who may not write
+ * the record.
+ *
+ * ```tsx
+ * const { reverted, kept } = await undoRecordChange("job", recordId, entry.id);
+ * ```
+ */
+export declare function undoRecordChange(entity: string, record_id: string, entry_id: string): Promise<ActivityUndoResult>;

package/dist/{chunk-ABDSJ25E.js → chunk-MK4DBY6R.js}

@@ -1656,6 +1656,7 @@ function rpcStandalone(op, payload) {
     case "comments.counts":
       return rejectCommentsStandalone();
     case "activity.list":
+    case "activity.undo":
       return Promise.reject(new Error("A record's activity is available only in embedded apps \u2014 a signed-in member is required."));
     case "recording.start":
     case "recording.stop":

package/dist/index.d.ts

@@ -11,9 +11,9 @@ export type { ExportedFile } from "./shared_types.js";
 export type { AttachedFile, AttachmentPiles, AttachmentPilesOptions, AttachmentsOptions, AttachmentsState } from "./attachments.js";
 export { useComments, useCommentCounts } from "./comments.js";
 export type { AppComment, AppCommentAuthor, AppCommentFile, CommentsState, UseCommentsArgs, CommentCountsState, UseCommentCountsArgs, } from "./comments.js";
-export { useRecordActivity } from "./activity.js";
+export { undoRecordChange, useRecordActivity } from "./activity.js";
 export type { RecordActivityOptions, RecordActivityState } from "./activity.js";
-export type { ActivityActor, ActivityActorKind, ActivityChange, ActivityComment, ActivityEntry, ActivityValue, RecordActivityPage, } from "./shared_types.js";
+export type { ActivityActor, ActivityActorKind, ActivityChange, ActivityComment, ActivityEntry, ActivityUndoResult, ActivityValue, RecordActivityPage, UndoKeptReason, } from "./shared_types.js";
 export { useAppContext, useViewer, useWorkspaceCurrency, useWorkspaceTimezone } from "./viewer.js";
 export type { AppAbsence } from "./shared_types.js";
 export { useRecording, useRecordings } from "./recording.js";

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sumDecimal,
   tiersAscend,
   urlParam
-} from "./chunk-ABDSJ25E.js";
+} from "./chunk-MK4DBY6R.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";
@@ -611,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) };
@@ -26395,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({
@@ -26736,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 —
@@ -26771,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" },
@@ -29032,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,
@@ -32717,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 } }),
@@ -32734,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";
@@ -33077,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-ABDSJ25E.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 …"`) |

package/docs/security.md

@@ -103,6 +103,7 @@ 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 |
+| Undo of a record's change (`undoRecordChange`) | **No** — a member of the app's organization holding `write_data` on the record's table, on a row their own row rule covers |
 | 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/docs/workflows.md

@@ -392,7 +392,7 @@ body does not look like what you typed.
 | `arr.at(i)` | `at(arr, i)` — negative counts from the end |
 | `arr.filter(Boolean)` | `compact(arr)` — drops every falsy element |
 | `[...a, b]` | `concat(a, [b])` |
-| `{ ...a, b: 1 }` | `merge(a, { b: 1 })` — later sources win, as in JS |
+| `{ ...a, b: 1 }` | `merge(merge({}, a), { b: 1 })` — later sources win, as in JS — and reads back as the spread, typed as you wrote it |
 | `{ table_id }` | `{ table_id: table_id }` — in expressions **and** tool inputs |
 | `undefined` | `null` |
 | `xs.push(a, b);` | `xs = concat(xs, [a, b])` — statement form |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.120.3",
+  "version": "0.121.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": {