@lotics/app-sdk 0.126.1 → 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/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.1",
+  "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": {