@frockbot/plugin-shell 0.3.14 → 0.3.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frockbot/plugin-shell",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "private": false,
   "type": "module",
   "exports": {
@@ -51,42 +51,42 @@
   },
   "dependencies": {
     "@cordisjs/plugin-webui": "0.8.2",
-    "@frockbot/agent-runtime": "0.3.14",
-    "@frockbot/application-foundation": "0.3.14",
-    "@frockbot/catalog-core": "0.3.14",
-    "@frockbot/client-core": "0.3.14",
-    "@frockbot/client-ui": "0.3.14",
-    "@frockbot/computer-core": "0.3.14",
-    "@frockbot/computer-host-protocol": "0.3.14",
-    "@frockbot/configuration-core": "0.3.14",
-    "@frockbot/connection-core": "0.3.14",
-    "@frockbot/kernel-agent-loop": "0.3.14",
-    "@frockbot/kernel-composition": "0.3.14",
-    "@frockbot/kernel-contracts": "0.3.14",
-    "@frockbot/kernel-do": "0.3.14",
-    "@frockbot/machine-protocol": "0.3.14",
-    "@frockbot/plugin-applets": "0.3.14",
-    "@frockbot/plugin-authoring": "0.3.14",
-    "@frockbot/plugin-bot-template": "0.3.14",
-    "@frockbot/plugin-computer": "0.3.14",
-    "@frockbot/plugin-flock": "0.3.14",
-    "@frockbot/plugin-image": "0.3.14",
-    "@frockbot/plugin-machine-messages": "0.3.14",
-    "@frockbot/plugin-mcp": "0.3.14",
-    "@frockbot/plugin-memory": "0.3.14",
-    "@frockbot/plugin-package-catalog": "0.3.14",
-    "@frockbot/plugin-routines": "0.3.14",
-    "@frockbot/plugin-skills": "0.3.14",
-    "@frockbot/plugin-subagents": "0.3.14",
-    "@frockbot/plugin-user-machine": "0.3.14",
-    "@frockbot/protocol": "0.3.14",
+    "@frockbot/agent-runtime": "0.3.16",
+    "@frockbot/application-foundation": "0.3.16",
+    "@frockbot/catalog-core": "0.3.16",
+    "@frockbot/client-core": "0.3.16",
+    "@frockbot/client-ui": "0.3.16",
+    "@frockbot/computer-core": "0.3.16",
+    "@frockbot/computer-host-protocol": "0.3.16",
+    "@frockbot/configuration-core": "0.3.16",
+    "@frockbot/connection-core": "0.3.16",
+    "@frockbot/kernel-agent-loop": "0.3.16",
+    "@frockbot/kernel-composition": "0.3.16",
+    "@frockbot/kernel-contracts": "0.3.16",
+    "@frockbot/kernel-do": "0.3.16",
+    "@frockbot/machine-protocol": "0.3.16",
+    "@frockbot/plugin-applets": "0.3.16",
+    "@frockbot/plugin-authoring": "0.3.16",
+    "@frockbot/plugin-bot-template": "0.3.16",
+    "@frockbot/plugin-computer": "0.3.16",
+    "@frockbot/plugin-flock": "0.3.16",
+    "@frockbot/plugin-image": "0.3.16",
+    "@frockbot/plugin-machine-messages": "0.3.16",
+    "@frockbot/plugin-mcp": "0.3.16",
+    "@frockbot/plugin-memory": "0.3.16",
+    "@frockbot/plugin-package-catalog": "0.3.16",
+    "@frockbot/plugin-routines": "0.3.16",
+    "@frockbot/plugin-skills": "0.3.16",
+    "@frockbot/plugin-subagents": "0.3.16",
+    "@frockbot/plugin-user-machine": "0.3.16",
+    "@frockbot/protocol": "0.3.16",
     "cordis": "4.0.0-rc.8",
     "vue": "3.5.41"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "latest",
-    "@frockbot/plugin-prompt": "0.3.14",
-    "@frockbot/plugin-tools": "0.3.14",
+    "@frockbot/plugin-prompt": "0.3.16",
+    "@frockbot/plugin-tools": "0.3.16",
     "@types/bun": "1.3.6",
     "@types/node": "26.2.0",
     "@vitejs/plugin-vue": "6.0.8",

package/src/backend-completion.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, test } from "bun:test";
 import { type SessionEvent } from "@frockbot/kernel-contracts";
 import { initializeBotSettingsV1 } from "@frockbot/configuration-core";
+import { SessionEventLog } from "@frockbot/kernel-do";
 import {
   botTurnCommandFingerprintV1,
   type BotTurnCompletion,
@@ -81,11 +82,15 @@ class MemoryRunStorage implements RunTerminalStorage {
     return Promise.resolve(this.values.get(key) as T | undefined);
   }
 
-  put(entries: Record<string, unknown>): Promise<void> {
-    this.putBatches.push(structuredClone(entries));
-    if (this.putFailure) return Promise.reject(this.putFailure);
-    for (const [key, value] of Object.entries(entries)) {
+  put(key: string | Record<string, unknown>, value?: unknown): Promise<void> {
+    if (typeof key === "string") {
       this.values.set(key, structuredClone(value));
+      return Promise.resolve();
+    }
+    this.putBatches.push(structuredClone(key));
+    if (this.putFailure) return Promise.reject(this.putFailure);
+    for (const [entry, item] of Object.entries(key)) {
+      this.values.set(entry, structuredClone(item));
     }
     return Promise.resolve();
   }
@@ -93,6 +98,16 @@ class MemoryRunStorage implements RunTerminalStorage {
   delete(key: string): Promise<boolean> {
     return Promise.resolve(this.values.delete(key));
   }
+
+  list<T>(options: { prefix: string }): Promise<Map<string, T>> {
+    return Promise.resolve(
+      new Map(
+        [...this.values.entries()].filter(([key]) =>
+          key.startsWith(options.prefix),
+        ) as Array<[string, T]>,
+      ),
+    );
+  }
 }
 
 describe("Bot run terminal persistence", () => {
@@ -284,6 +299,8 @@ describe("Bot run terminal persistence", () => {
       failure: "provider-bound retrieval unavailable",
     });
     expect(storage.values.get(keys.activeRun)).toBe("run-1");
-    expect(storage.values.get(keys.latestEvents)).toEqual([request]);
+    expect(await new SessionEventLog(storage).read("user:primary")).toEqual([
+      request,
+    ]);
   });
 });

package/src/backend-configuration.test.ts

@@ -6,6 +6,7 @@ import type {
   UserSettingsViewV1,
 } from "@frockbot/configuration-core";
 import type { PackageSettingDefinition } from "@frockbot/kernel-composition";
+import { SessionEventLog } from "@frockbot/kernel-do";
 import { createShellBotBackendContribution } from "./backend.js";
 import { createIsolateCapabilityHost } from "./backend-isolate.js";
 import { notificationIdV1 } from "./notification-id.js";
@@ -549,11 +550,12 @@ describe("generic per-Turn model resolution", () => {
     });
 
     expect(result.text).toBe("Cordis runtime: hello");
-    const durableEvents = storage.values.get("latest-events") as
-      Array<{ seq: number }> | undefined;
-    expect(durableEvents?.length).toBeGreaterThan(0);
-    expect(durableEvents?.map((event) => event.seq)).toEqual(
-      durableEvents?.map((_, index) => index),
+    const durableEvents = await new SessionEventLog(storage).read(
+      "user-1:primary",
+    );
+    expect(durableEvents.length).toBeGreaterThan(0);
+    expect(durableEvents.map((event) => event.seq)).toEqual(
+      durableEvents.map((_, index) => index),
     );
     const settings = await contribution.getSettings(identity);
     expect(settings).toMatchObject({ revision: 0, packageValues: {} });

package/src/backend-debug.test.ts

@@ -1,5 +1,6 @@
 import { describe, expect, test } from "bun:test";
 import { initializeBotSettingsV1 } from "@frockbot/configuration-core";
+import { SessionEventLog, storedRunRecordV2 } from "@frockbot/kernel-do";
 import { createShellBotBackendContribution } from "./backend.js";
 import type { StoredRun } from "./backend-contracts.js";
 
@@ -154,6 +155,54 @@ describe("Bot debug snapshot", () => {
     expect(snapshot.activeRunId).toBeUndefined();
   });
 
+  test("reads bounded projections instead of hydrating full model prompts", async () => {
+    const storage = new MemoryStorage();
+    const event = {
+      type: "model/request",
+      turn: 1,
+      step: 1,
+      request: {
+        requestId: "request-large",
+        provider: "fake",
+        model: "large-context",
+        system: "s".repeat(80_000),
+        messages: [{ role: "user", content: "last question" }],
+        tools: [],
+      },
+      seq: 0,
+      timestamp: "2026-08-28T00:00:01.000Z",
+    } as StoredRun["events"][number];
+    const run = storedRun({ events: [event] });
+    await new SessionEventLog(storage).rewrite(run.sessionId, [event]);
+    await storage.put({
+      identity: IDENTITY,
+      [`run:${run.runId}`]: storedRunRecordV2(run),
+      [`run-index:${run.acceptedAt}:${run.runId}`]: run.runId,
+    });
+
+    const snapshot = await contributionOver(storage).debugSnapshot(IDENTITY, {
+      schemaVersion: 1,
+      runId: run.runId,
+    });
+
+    expect(snapshot.runs[0]?.eventCount).toBe(1);
+    expect(snapshot.runs[0]?.events?.[0]).toMatchObject({
+      type: "model/request",
+      cut: { marker: "content-cut", originalBytes: expect.any(Number) },
+      request: {
+        requestId: "request-large",
+        messageCount: 1,
+        toolCount: 0,
+        sha256: expect.stringMatching(/^[0-9a-f]{64}$/),
+        truncated: true,
+      },
+    });
+    expect(JSON.stringify(snapshot)).not.toContain("s".repeat(10_000));
+    expect(
+      new TextEncoder().encode(JSON.stringify(snapshot)).byteLength,
+    ).toBeLessThan(20_000);
+  });
+
   test("includes an active run older than the page it would otherwise fall off", async () => {
     const storage = new MemoryStorage();
     const stale = storedRun({

package/src/backend-memory.ts

@@ -25,6 +25,7 @@ import type {
   MemoryRuntimeHostV1,
 } from "@frockbot/plugin-memory/agent";
 import { MemoryStore } from "@frockbot/plugin-memory/store";
+import type { MemoryChunkIndexWriterV1 } from "@frockbot/plugin-memory/chunk-index";
 
 /** The Bot and User whose Memory a Turn may read and write. */
 export interface BotMemoryIdentity {
@@ -50,6 +51,8 @@ export interface BotMemoryEnv {
   MEMORY_PROJECTS?: MemoryProjectsV1;
   /** Display names per Bot id, for the `[via …]` tag on a shared fact. */
   MEMORY_BOT_NAMES?: Readonly<Record<string, string>>;
+  /** Bot-scoped vector-id ledger supplied by the Durable Object host. */
+  MEMORY_CHUNK_INDEX?: MemoryChunkIndexWriterV1;
 }
 
 /**
@@ -85,5 +88,8 @@ export function createBotMemoryHost(
       runId: turn.runId,
     },
     ...(bindings.MEMORY_PROJECTS ? { projects: bindings.MEMORY_PROJECTS } : {}),
+    ...(bindings.MEMORY_CHUNK_INDEX
+      ? { chunkIndex: bindings.MEMORY_CHUNK_INDEX }
+      : {}),
   };
 }

package/src/backend-recovery-integration.test.ts

@@ -9,6 +9,7 @@ import {
   type UserSettingsViewV1,
 } from "@frockbot/configuration-core";
 import { compileFoundationApplication } from "@frockbot/application-foundation/runtime";
+import { SessionEventLog } from "@frockbot/kernel-do";
 import { createShellBotBackendContribution } from "./backend.js";
 import {
   botTurnCommandFingerprintV1,
@@ -291,10 +292,23 @@ describe("Bot recovery", () => {
       },
     ]);
     expect(settledEffects).toHaveLength(2);
+    const eventLog = new SessionEventLog(storage);
     for (const runId of ["ollama-run-1", "ollama-run-2"]) {
-      const run = await storage.get<StoredRun>(`run:${runId}`);
+      const run = await storage.get<
+        Omit<StoredRun, "events"> & {
+          eventRange: { startSeq: number; endSeq: number };
+        }
+      >(`run:${runId}`);
+      expect(run).not.toHaveProperty("events");
+      const events = run
+        ? await eventLog.readRange(
+            "user-1:primary",
+            run.eventRange.startSeq,
+            run.eventRange.endSeq,
+          )
+        : [];
       expect(
-        run?.events.find((event) => event.type === "model/request"),
+        events.find((event) => event.type === "model/request"),
       ).toMatchObject({
         request: {
           provider: "ollama-cloud",

package/src/backend.ts

@@ -46,12 +46,13 @@ import {
   ACTIVE_RUN_KEY,
   BotDurableAuthority,
   IDENTITY_KEY,
-  LATEST_EVENTS_KEY,
   NOTIFICATION_PREFIX,
   RECOVERY_ALARM_DELAY_MS,
   RUN_ADMISSION_FENCE_PREFIX,
   RUN_INDEX_PREFIX,
   RUN_PREFIX,
+  SessionEventLog,
+  storedRunRecordV2,
   CONVERSATION_BUSY_MESSAGE_V1,
   isConversationBusyV1,
   type BotIdentity,
@@ -589,7 +590,8 @@ export interface BotStateEnv {
    * Bot authoring still compiles; `package_author` then refuses visibly.
    */
   PACKAGE_BUNDLER?: PackageBundlerBinding;
-  MEMORY_INDEX: VectorizeIndex;
+  /** Optional in local and workerd hosts, which have no Vectorize simulator. */
+  MEMORY_INDEX?: VectorizeIndex;
   /** The native AI binding consumed through the image Package adapter. */
   AI?: NativeAiBindingV1;
   /** The Frock AI Gateway adapter constructed by the Cloudflare host. */
@@ -1155,8 +1157,10 @@ export class ShellBotBackendContribution {
     const announcements = [...stored.entries()]
       .sort(([left], [right]) => left.localeCompare(right))
       .map(([, value]) => decodeSessionEvent(value));
-    const session =
-      (await this.ctx.storage.get<SessionEvent[]>(LATEST_EVENTS_KEY)) ?? [];
+    const sessionId = await this.authority.readConversationSessionId();
+    const session = sessionId
+      ? await this.authority.readSessionEvents(sessionId)
+      : [];
     for (const event of session) {
       if (event.type === "conversation/compacted") announcements.push(event);
     }
@@ -1170,8 +1174,10 @@ export class ShellBotBackendContribution {
    * timestamp of the place it belongs rather than the moment it was written.
    */
   private async projectAnnouncementPage() {
-    const session =
-      (await this.ctx.storage.get<SessionEvent[]>(LATEST_EVENTS_KEY)) ?? [];
+    const sessionId = await this.authority.readConversationSessionId();
+    const session = sessionId
+      ? await this.authority.readSessionEvents(sessionId)
+      : [];
     return projectClientAnnouncementsV1(
       await this.listAnnouncements(),
       session,
@@ -5950,10 +5956,13 @@ export class ShellBotBackendContribution {
     let budget = BOT_DEBUG_EVENT_BYTES_V1;
     const runs: BotDebugRunV1[] = [];
     for (const candidate of candidates) {
-      const stored = await this.authority.readStoredRun(candidate.runId);
-      if (!stored) continue;
+      const projected = await this.authority.readRunEventProjections(
+        candidate.runId,
+      );
+      if (!projected) continue;
+      const { run: stored } = projected;
       const bounded = includeEvents
-        ? boundDebugEventsV1(stored.events, budget)
+        ? boundDebugEventsV1(projected.events, budget)
         : undefined;
       if (bounded) budget = Math.max(0, budget - bounded.spent);
       runs.push({
@@ -5966,7 +5975,7 @@ export class ShellBotBackendContribution {
         commandFingerprint: stored.commandFingerprint,
         compositionGenerationId: stored.compositionGenerationId,
         previousEventCount: stored.previousEventCount,
-        eventCount: stored.events.length,
+        eventCount: projected.eventCount,
         ...(stored.responseText === undefined
           ? {}
           : { responseText: stored.responseText }),
@@ -6327,7 +6336,24 @@ export class ShellBotBackendContribution {
         transaction.get<BotIdentity>(IDENTITY_KEY),
         transaction.get<unknown>(`${RUN_PREFIX}${runId}`),
       ]);
-      const run = optionalStoredRun(candidate);
+      const storedRun = optionalStoredRun(candidate);
+      let run = storedRun;
+      if (storedRun?.eventRange) {
+        const events = await new SessionEventLog(transaction).readRange(
+          storedRun.sessionId,
+          storedRun.eventRange.startSeq,
+          storedRun.eventRange.endSeq,
+        );
+        if (
+          events.length !==
+          storedRun.eventRange.endSeq - storedRun.eventRange.startSeq
+        ) {
+          throw new Error(
+            `run "${storedRun.runId}" has an incomplete event range`,
+          );
+        }
+        run = requireStoredRunV1({ ...storedRun, events });
+      }
       if (
         activeRunId !== runId ||
         !run ||
@@ -6387,7 +6413,10 @@ export class ShellBotBackendContribution {
           { kind: effect.kind, effectId: effect.effectId, outcome },
         ],
       } satisfies StoredRun);
-      await transaction.put(`${RUN_PREFIX}${runId}`, structuredClone(next));
+      await transaction.put(
+        `${RUN_PREFIX}${runId}`,
+        structuredClone(storedRunRecordV2(next)),
+      );
       return outcome === "admitted";
     });
   }

package/src/client/voice-microphone.ts

@@ -11,17 +11,17 @@ import {
 } from "./voice-worklet.js";
 
 /** What the upstream is told to expect, and therefore what leaves here. */
-export const VOICE_CAPTURE_SAMPLE_RATE_V1 = 16_000;
+export const VOICE_CAPTURE_SAMPLE_RATE_V1 = 24_000;
 
-/** Samples per frame at 16 kHz: 32 ms, small enough to feel live. */
-const FRAME_SAMPLES = 512;
+/** Samples per frame at 24 kHz: 32 ms, small enough to feel live. */
+const FRAME_SAMPLES = 768;
 
 export interface VoiceMicrophoneV1 {
   stop(): Promise<void>;
 }
 
 export interface VoiceMicrophoneOptionsV1 {
-  /** One frame of PCM16, little-endian, mono, 16 kHz. */
+  /** One frame of PCM16, little-endian, mono, 24 kHz. */
   audio(pcm16: ArrayBuffer): void;
   /** Peak amplitude of the frame, 0…1, for the capture animation. */
   level(value: number): void;

package/src/debug-protocol.ts

@@ -20,9 +20,10 @@ export const BOT_DEBUG_RUN_LIMIT_V1 = 20;
 export const BOT_DEBUG_DEFAULT_RUN_LIMIT_V1 = 5;
 export const BOT_DEBUG_GENERATION_LIMIT_V1 = 5;
 /**
- * The event budget one snapshot spends. Session events carry whole prompts, so
- * a handful of runs can be megabytes; past this the *oldest* events of a run
- * are dropped, because a failure is described by the tail of its log.
+ * The event budget one snapshot spends. Large durable events are already
+ * bounded diagnostic projections, but a handful of runs can still accumulate
+ * many of them; past this the *oldest* events of a run are dropped, because a
+ * failure is described by the tail of its log.
  */
 export const BOT_DEBUG_EVENT_BYTES_V1 = 512_000;
 

package/src/run-failure-copy.test.ts

@@ -3,6 +3,7 @@ import type { SessionEvent } from "@frockbot/kernel-contracts";
 import { MODEL_FIRST_BYTE_DEADLINE_REASON_V1 } from "@frockbot/kernel-contracts";
 import {
   knownFailureCopyV1,
+  MODEL_PROVIDER_FAILURE_COPY_V1,
   RUN_FAILURE_COPY_V1,
   RUN_FAILURE_FALLBACK_COPY_V1,
   runFailureCopyV1,
@@ -75,6 +76,14 @@ function failedRun(failure: string, events: SessionEvent[]): StoredRun {
 describe("runFailureCopyV1", () => {
   test("every mapped sentence is written for a person", () => {
     for (const copy of Object.values(RUN_FAILURE_COPY_V1)) assertPlainV1(copy);
+    expect(Object.keys(MODEL_PROVIDER_FAILURE_COPY_V1).sort()).toEqual([
+      "permanent",
+      "transient",
+      "unknown",
+    ]);
+    for (const copy of Object.values(MODEL_PROVIDER_FAILURE_COPY_V1)) {
+      assertPlainV1(copy);
+    }
     assertPlainV1(RUN_FAILURE_FALLBACK_COPY_V1);
     for (const reason of USER_FACING_FAILURE_REASONS_V1) assertPlainV1(reason);
   });

package/src/run-failure-copy.ts

@@ -1,4 +1,8 @@
-import type { SessionEvent, TurnOutcome } from "@frockbot/kernel-contracts";
+import type {
+  ModelProviderFailureClassV1,
+  SessionEvent,
+  TurnOutcome,
+} from "@frockbot/kernel-contracts";
 import {
   MODEL_FIRST_BYTE_DEADLINE_REASON_V1,
   MODEL_IDLE_DEADLINE_REASON_V1,
@@ -59,6 +63,16 @@ export const RUN_FAILURE_COPY_V1: Record<TurnOutcome, string> = {
   "tool-error": "Something the Bot was using didn't work. Try again.",
 };
 
+/** Every provider class reaches the same intentionally plain model-error copy. */
+export const MODEL_PROVIDER_FAILURE_COPY_V1: Record<
+  ModelProviderFailureClassV1,
+  string
+> = {
+  transient: RUN_FAILURE_COPY_V1["model-error"],
+  permanent: RUN_FAILURE_COPY_V1["model-error"],
+  unknown: RUN_FAILURE_COPY_V1["model-error"],
+};
+
 /** What a Turn says when nothing more specific is known about how it ended. */
 export const RUN_FAILURE_FALLBACK_COPY_V1 =
   "This Bot couldn't finish its reply. Try again.";