@frockbot/plugin-shell 0.3.15 → 0.3.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frockbot/plugin-shell",
-  "version": "0.3.15",
+  "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.15",
-    "@frockbot/application-foundation": "0.3.15",
-    "@frockbot/catalog-core": "0.3.15",
-    "@frockbot/client-core": "0.3.15",
-    "@frockbot/client-ui": "0.3.15",
-    "@frockbot/computer-core": "0.3.15",
-    "@frockbot/computer-host-protocol": "0.3.15",
-    "@frockbot/configuration-core": "0.3.15",
-    "@frockbot/connection-core": "0.3.15",
-    "@frockbot/kernel-agent-loop": "0.3.15",
-    "@frockbot/kernel-composition": "0.3.15",
-    "@frockbot/kernel-contracts": "0.3.15",
-    "@frockbot/kernel-do": "0.3.15",
-    "@frockbot/machine-protocol": "0.3.15",
-    "@frockbot/plugin-applets": "0.3.15",
-    "@frockbot/plugin-authoring": "0.3.15",
-    "@frockbot/plugin-bot-template": "0.3.15",
-    "@frockbot/plugin-computer": "0.3.15",
-    "@frockbot/plugin-flock": "0.3.15",
-    "@frockbot/plugin-image": "0.3.15",
-    "@frockbot/plugin-machine-messages": "0.3.15",
-    "@frockbot/plugin-mcp": "0.3.15",
-    "@frockbot/plugin-memory": "0.3.15",
-    "@frockbot/plugin-package-catalog": "0.3.15",
-    "@frockbot/plugin-routines": "0.3.15",
-    "@frockbot/plugin-skills": "0.3.15",
-    "@frockbot/plugin-subagents": "0.3.15",
-    "@frockbot/plugin-user-machine": "0.3.15",
-    "@frockbot/protocol": "0.3.15",
+    "@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.15",
-    "@frockbot/plugin-tools": "0.3.15",
+    "@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-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,
@@ -1156,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);
     }
@@ -1171,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,
@@ -5951,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({
@@ -5967,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 }),
@@ -6328,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 ||
@@ -6388,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/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;