@lotics/app-sdk 0.126.0 → 0.127.0

package/dist/index.js

@@ -93,6 +93,9 @@ function getMockAgent(alias) {
   if (!isMockMode()) return null;
   return registeredFixture?.agents?.[alias] ?? null;
 }
+function getMockAgentBeat() {
+  return registeredFixture?.agentBeatMs;
+}
 function getMockExport(alias) {
   if (!isMockMode()) return null;
   return registeredFixture?.exports?.[alias] ?? null;
@@ -10824,7 +10827,7 @@ function useAgentRun(alias) {
       const inflight = streamLeg(
         (onText) => mock === null ? rpcAgentRun({ alias, session_id: opts.sessionId, input: input ?? {} }, onText, (runId) => {
           runIdRef.current = runId;
-        }) : playMockRun(typeof mock === "function" ? mock(input ?? {}) : mock, onText),
+        }) : playMockRun(typeof mock === "function" ? mock(input ?? {}) : mock, onText, getMockAgentBeat()),
         initialAgentRunState()
       );
       const tracked = inflight.finally(() => {

package/dist/mock.d.ts

@@ -43,6 +43,8 @@ export interface AppFixture {
     exportApps?: Record<string, MockExportApp>;
     /** `useRecording(alias)` reads as available; `start`/`stop` change nothing. */
     recordings?: Record<string, RecordingState>;
+    /** How long a played agent run waits before each line it streams; a real run's pace when unset. */
+    agentBeatMs?: number;
 }
 export declare function registerMockFixture(fixture: AppFixture | undefined): void;
 /** The raw `?__mock=1` flag, fixture or not; false where `window.location` is absent. */
@@ -53,6 +55,8 @@ export declare function getMockRows(alias: string, call: MockQueryCall): Array<R
 export declare function getMockWorkflow(alias: string): MockWorkflow | null;
 /** Null for an unmocked alias, which runs for real. */
 export declare function getMockAgent(alias: string): MockAgent | null;
+/** The pace the fixture plays agent runs at; undefined for a real run's. */
+export declare function getMockAgentBeat(): number | undefined;
 /** Null for an unmocked alias, which the server exports. */
 export declare function getMockExport(alias: string): MockExport | null;
 /** Null for an unmocked key, which the server exports. */

package/docs/data_fetching.md

@@ -247,8 +247,8 @@ Reads paginate two different ways, and the difference is load-bearing:
   matters — **never skips or duplicates a row as the set shifts** under concurrent inserts/deletes.
   The cursor is internal: the hook sends it and reads the next one back; you never see it. The
   server keysets the sort's column keys (the runtime `sort`, else the template's own order on the
-  columns it projects, else the record id) and falls back to offset transparently for a `first`
-  key it can't seek. So an infinite feed needs **no
+  columns it projects), breaking their ties by when each row was made, then by the record id, and
+  falls back to offset transparently for a `first` key it can't seek. So an infinite feed needs **no
   dedupe** — key rows by `__source_record_id` for stable React keys, not to guard against repeats.
 - **`page`, `limit`, `queryAll` and manual `rpc("query", { limit, offset })` use offset
   pagination** — count `offset` rows, skip them, return the next page. Two consequences a keyset
@@ -261,7 +261,7 @@ Shared by both:
   says the cap cut the result, so a screen can say so instead of quietly under-reporting.
 - **Always give a paginated query a deterministic order.** With no `ORDER BY` (neither in the
   template nor runtime `sort`), row order is unspecified — offset pages may overlap or skip rows
-  even without concurrent writes, and keyset falls back to the record-id order. Sort by a stable
+  even without concurrent writes, and keyset falls back to the order the rows were made in. Sort by a stable
   column (unique where possible).
 
 Offset-only (`page`, `limit`, and manual `rpc`):

package/docs/queries.md

@@ -640,8 +640,8 @@ index that is:
 
 - **diacritics- and case-insensitive** (`"da nang"` matches `"Đà Nẵng"`),
 - **trigram-indexed** (scales to large tables — unlike `contains`, which scans),
-- **near-total field coverage** — indexes text, number, date (ISO plus `MM/dd/yyyy` and
-  `dd/MM/yyyy` forms), select option labels, member names, link display text, and
+- **near-total field coverage** — indexes text, number, date (ISO plus `MM/dd/yyyy`,
+  `dd/MM/yyyy` and `15 Jan 2026` forms), select option labels, member names, link display text, and
   formula/rollup/lookup values; boolean and files cells are not indexed,
 - multi-term: the query splits on whitespace (max 10 terms), all terms must match (AND).
 

package/docs/runtime.md

@@ -68,7 +68,8 @@ Activation is a **two-step gate** — both must hold, so demo data shipping in t
 bundle never leaks into normal traffic:
 
 1. A fixture is registered via `mount({ fixture })` (`AppFixture` type:
-   `dist/mock.d.ts` — `{ queries?, workflows?, agents?, exports?, exportApps?, recordings? }`).
+   `dist/mock.d.ts` — `{ queries?, workflows?, agents?, exports?, exportApps?, recordings?, agentBeatMs? }`;
+   `agentBeatMs` paces each line a mocked agent run streams, a real run's pace when unset, `0` in a test).
 2. The page URL carries `?__mock=1` (exactly `1`). Without the flag the fixture
    is completely inert.
 

package/package.json

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