@frockbot/plugin-shell 0.3.22 → 0.3.23

package/package.json

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

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

@@ -19,6 +19,7 @@ import { planBotRunRecovery } from "./backend-recovery.js";
 import {
   CLIENT_RUN_LIST_MAX_BYTES,
   CLIENT_RUN_PAGE_LIMIT,
+  CLIENT_RUN_SCAN_LIMIT,
   clientRunListWireBytes,
 } from "./run-protocol.js";
 
@@ -1475,6 +1476,139 @@ describe("Bot recovery", () => {
     ).toBe(false);
   });
 
+  /**
+   * The run index is global; the transcript is one conversation. These cover
+   * the shape that used to answer "this conversation is empty" whenever the
+   * newest page of the index happened to hold nothing the reader could see.
+   */
+  async function writeRunHistory(
+    storage: MemoryStorage,
+    runs: Array<{
+      runId: string;
+      sessionId: string;
+      turnType?: "chat" | "automation";
+    }>,
+  ): Promise<void> {
+    const baseTime = Date.parse("2026-09-01T00:00:00.000Z");
+    for (const [index, entry] of runs.entries()) {
+      const acceptedAt = new Date(baseTime + index * 1_000).toISOString();
+      const run = {
+        runId: entry.runId,
+        commandFingerprint: `fingerprint-${index}`,
+        sessionId: entry.sessionId,
+        acceptedAt,
+        input: "hello",
+        events: [],
+        effectAdmissions: [],
+        status: "completed",
+        phase: "executing",
+        compositionGenerationId: "test-composition-generation",
+        configurationSnapshot: initializeBotSettingsV1("primary"),
+        previousEventCount: 0,
+        responseText: "answer",
+        ...(entry.turnType && entry.turnType !== "chat"
+          ? { admission: { schemaVersion: 1, turnType: entry.turnType } }
+          : {}),
+      } satisfies StoredRun;
+      await storage.put({
+        [`run:${entry.runId}`]: run,
+        [`run-index:${acceptedAt}:${entry.runId}`]: entry.runId,
+      });
+    }
+  }
+
+  test("reaches an older conversation buried under newer Turns", async () => {
+    const storage = new MemoryStorage();
+    await writeRunHistory(storage, [
+      { runId: "run-older", sessionId: "user:primary:older" },
+      ...Array.from({ length: CLIENT_RUN_PAGE_LIMIT + 2 }, (_value, index) => ({
+        runId: `run-newer-${index.toString().padStart(3, "0")}`,
+        sessionId: "user:primary:newer",
+      })),
+    ]);
+    const contribution = createShellBotBackendContribution({
+      state: { storage } as unknown as DurableObjectState,
+      env: {} as never,
+    });
+
+    const page = await contribution.listRuns({
+      schemaVersion: 1,
+      conversationId: "user:primary:older",
+    });
+
+    expect(page.runs.map((run) => run.runId)).toEqual(["run-older"]);
+    expect(page.page.truncated).toBe(false);
+  });
+
+  test("keeps the visible chat reachable behind a page of automation", async () => {
+    const storage = new MemoryStorage();
+    await writeRunHistory(storage, [
+      { runId: "run-chat", sessionId: "user:primary" },
+      ...Array.from({ length: CLIENT_RUN_PAGE_LIMIT + 2 }, (_value, index) => ({
+        runId: `run-automation-${index.toString().padStart(3, "0")}`,
+        sessionId: "user:primary",
+        turnType: "automation" as const,
+      })),
+    ]);
+    const contribution = createShellBotBackendContribution({
+      state: { storage } as unknown as DurableObjectState,
+      env: {} as never,
+    });
+
+    const page = await contribution.listRuns({
+      schemaVersion: 1,
+      conversationId: "user:primary",
+    });
+
+    expect(page.runs.map((run) => run.runId)).toEqual(["run-chat"]);
+  });
+
+  test("offers a continuation when a scanned page selects nothing", async () => {
+    const storage = new MemoryStorage();
+    const buried = CLIENT_RUN_SCAN_LIMIT + CLIENT_RUN_PAGE_LIMIT;
+    await writeRunHistory(storage, [
+      { runId: "run-older", sessionId: "user:primary:older" },
+      ...Array.from({ length: buried }, (_value, index) => ({
+        runId: `run-newer-${index.toString().padStart(4, "0")}`,
+        sessionId: "user:primary:newer",
+      })),
+    ]);
+    const contribution = createShellBotBackendContribution({
+      state: { storage } as unknown as DurableObjectState,
+      env: {} as never,
+    });
+
+    let page = await contribution.listRuns({
+      schemaVersion: 1,
+      conversationId: "user:primary:older",
+    });
+    // The budget stops the scan short of the match, so the page must be empty
+    // *and* say where to resume. Answering `truncated: false` here is the
+    // defect: it told the client the conversation had nothing in it.
+    expect(page.runs).toEqual([]);
+    expect(page.page.truncated).toBe(true);
+    expect(page.page.nextCursor).toBeDefined();
+
+    const seen = new Set<string>();
+    let requests = 0;
+    while (page.runs.length === 0 && page.page.nextCursor) {
+      if (seen.has(page.page.nextCursor)) {
+        throw new Error("run list cursor stopped advancing");
+      }
+      seen.add(page.page.nextCursor);
+      requests += 1;
+      if (requests > 20) throw new Error("run list did not converge");
+      page = await contribution.listRuns({
+        schemaVersion: 1,
+        conversationId: "user:primary:older",
+        before: page.page.nextCursor,
+      });
+    }
+
+    expect(page.runs.map((run) => run.runId)).toEqual(["run-older"]);
+    expect(page.page.truncated).toBe(false);
+  });
+
   test("pages large run history with bounded indexed reads and wire bytes", async () => {
     const storage = new MemoryStorage();
     const baseTime = Date.parse("2026-08-28T00:00:00.000Z");

package/src/backend.ts

@@ -404,6 +404,7 @@ import {
 import {
   CLIENT_RUN_LIST_MAX_BYTES,
   CLIENT_RUN_PAGE_LIMIT,
+  CLIENT_RUN_SCAN_LIMIT,
   clientRunListWireBytes,
   createClientRunListV1,
   createClientRunStopReceiptV1,
@@ -5833,7 +5834,7 @@ export class ShellBotBackendContribution {
 
     const selected = new Map<string, { cursor?: string; run: ClientRunV1 }>();
     if (activeRunId) {
-      const active = await this.authority.readStoredRun(activeRunId);
+      const active = await this.authority.readStoredRunForDisplay(activeRunId);
       // An automation firing occupies the object like any other run, and is
       // still not part of the conversation: the visible transcript never
       // shows one, running or settled.
@@ -5842,60 +5843,110 @@ export class ShellBotBackendContribution {
           run: projectClientRunOrDegradedV1(active),
         });
     }
-    const available = candidates.slice(0, CLIENT_RUN_PAGE_LIMIT);
+    // The run index is global and the transcript is one conversation, so a
+    // page of candidates is not a page of answers: 33 Turns of another
+    // conversation, or of automation, used to come back as an empty,
+    // *untruncated* page that told the client there was nothing older. The
+    // scan cursor now advances over every candidate this call consumed,
+    // whether or not it was kept, so a filtered-out page still says where to
+    // resume; and the scan keeps reading batches, up to a budget, so the
+    // common case answers in one request rather than making the client walk
+    // the history a page at a time. Filtering reads run records only —
+    // hydrating a Turn's journal is what selection costs, not what the scan
+    // costs.
     let stoppedEarly = false;
-    for (const candidate of available) {
-      if (selected.has(candidate.runId)) {
-        const current = selected.get(candidate.runId)!;
-        selected.set(candidate.runId, { ...current, cursor: candidate.cursor });
-        continue;
-      }
-      const stored = await this.authority.readStoredRun(candidate.runId);
-      if (!stored || !isVisibleRunV1(stored) || !inConversation(stored))
-        continue;
-      const projected = projectClientRunOrDegradedV1(stored);
-      const tentative = [
-        ...selected.values(),
-        { cursor: candidate.cursor, run: projected },
-      ];
-      const ordered = tentative
-        .map((entry) => entry.run)
-        .sort(
-          (left, right) =>
-            left.admittedAt.localeCompare(right.admittedAt) ||
-            left.runId.localeCompare(right.runId),
+    let exhausted = false;
+    let scanCursor: string | undefined;
+    let scanned = 0;
+    let batch = candidates;
+    for (;;) {
+      const available = batch.slice(0, CLIENT_RUN_PAGE_LIMIT);
+      const hasMore = batch.length > CLIENT_RUN_PAGE_LIMIT;
+      for (const candidate of available) {
+        if (selected.has(candidate.runId)) {
+          const current = selected.get(candidate.runId)!;
+          selected.set(candidate.runId, {
+            ...current,
+            cursor: candidate.cursor,
+          });
+          scanCursor = candidate.cursor;
+          continue;
+        }
+        const header = await this.authority.readRunHeader(candidate.runId);
+        if (!header || !isVisibleRunV1(header) || !inConversation(header)) {
+          scanCursor = candidate.cursor;
+          continue;
+        }
+        const stored = await this.authority.readStoredRunForDisplay(
+          candidate.runId,
         );
-      const tentativePage = createClientRunListV1(ordered, {
-        truncated: true,
-        nextCursor: candidate.cursor,
+        if (!stored) {
+          scanCursor = candidate.cursor;
+          continue;
+        }
+        const projected = projectClientRunOrDegradedV1(stored);
+        const tentative = [
+          ...selected.values(),
+          { cursor: candidate.cursor, run: projected },
+        ];
+        const ordered = tentative
+          .map((entry) => entry.run)
+          .sort(
+            (left, right) =>
+              left.admittedAt.localeCompare(right.admittedAt) ||
+              left.runId.localeCompare(right.runId),
+          );
+        const tentativePage = createClientRunListV1(ordered, {
+          truncated: true,
+          nextCursor: candidate.cursor,
+        });
+        const isNewestTerminal =
+          ![...selected.values()].some(
+            (entry) =>
+              entry.run.status === "completed" || entry.run.status === "failed",
+          ) &&
+          (projected.status === "completed" || projected.status === "failed");
+        if (
+          selected.size >= CLIENT_RUN_PAGE_LIMIT ||
+          (!isNewestTerminal &&
+            clientRunListWireBytes(tentativePage) > CLIENT_RUN_LIST_MAX_BYTES)
+        ) {
+          stoppedEarly = true;
+          break;
+        }
+        selected.set(stored.runId, {
+          cursor: candidate.cursor,
+          run: projected,
+        });
+        scanCursor = candidate.cursor;
+      }
+      scanned += available.length;
+      if (stoppedEarly) break;
+      if (!hasMore) {
+        exhausted = true;
+        break;
+      }
+      if (selected.size >= CLIENT_RUN_PAGE_LIMIT) break;
+      if (scanned >= CLIENT_RUN_SCAN_LIMIT || scanCursor === undefined) break;
+      batch = await this.authority.listRunIndex({
+        limit: CLIENT_RUN_PAGE_LIMIT + 1,
+        before: scanCursor,
       });
-      const isNewestTerminal =
-        ![...selected.values()].some(
-          (entry) =>
-            entry.run.status === "completed" || entry.run.status === "failed",
-        ) &&
-        (projected.status === "completed" || projected.status === "failed");
-      if (
-        selected.size >= CLIENT_RUN_PAGE_LIMIT ||
-        (!isNewestTerminal &&
-          clientRunListWireBytes(tentativePage) > CLIENT_RUN_LIST_MAX_BYTES)
-      ) {
-        stoppedEarly = true;
+      if (batch.length === 0) {
+        exhausted = true;
         break;
       }
-      selected.set(stored.runId, { cursor: candidate.cursor, run: projected });
     }
     const orderedEntries = [...selected.values()].sort(
       (left, right) =>
         left.run.admittedAt.localeCompare(right.run.admittedAt) ||
         left.run.runId.localeCompare(right.run.runId),
     );
-    const oldestCursor = orderedEntries.find((entry) => entry.cursor)?.cursor;
-    const truncated = stoppedEarly || candidates.length > CLIENT_RUN_PAGE_LIMIT;
+    const truncated = !exhausted;
     const page = createClientRunListV1(
       orderedEntries.map((entry) => entry.run),
-      truncated && oldestCursor
-        ? { truncated: true, nextCursor: oldestCursor }
+      truncated && scanCursor
+        ? { truncated: true, nextCursor: scanCursor }
         : { truncated: false },
       // Announcements belong to the Session, not to a page of Turns, so only
       // the newest page carries them.

package/src/client/AppletCanvas.vue

@@ -22,6 +22,11 @@ import {
   appletSourceFingerprintV1,
   mostRecentlyChangedFileV1,
 } from "./applets-client.js";
+import {
+  appletIsBeingBuiltV1,
+  appletProgressToolsV1,
+  appletProgressV1,
+} from "./applet-progress.js";
 import { packageIframePagesForSlotV1 } from "./package-iframe-entries.js";
 import PackageIframeHost from "./PackageIframeHost.vue";
 
@@ -46,6 +51,26 @@ const isRunning = computed(() => Boolean(web.value.activeRunId));
 const canvasState = computed(() => web.value.appletCanvas);
 const failure = computed(() => web.value.appletCanvasError);
 
+/*
+ * What the Bot is doing to this Applet, in one line.
+ *
+ * A publish is minutes away from a create, and for all of it there is nothing
+ * to run. The panel used to answer that with one fixed line about the Applet
+ * not being live and a file list, which never changed and never said whether
+ * anything was happening. This is the sentence in between, projected from what
+ * the thread already shows: no new read, no new durable state.
+ */
+const progress = computed(() =>
+  appletProgressV1({
+    applet: applet.value ?? null,
+    source: source.value,
+    build: build.value,
+    tools: appletProgressToolsV1(web.value.messages),
+    running: isRunning.value,
+  }),
+);
+const beingBuilt = computed(() => appletIsBeingBuiltV1(progress.value));
+
 /** The Applets Package's right-panel page, when its Composition carries one. */
 const panelPage = computed(
   () => packageIframePagesForSlotV1(web.value.packageUi, RIGHT_PANEL_SLOT)[0],
@@ -212,8 +237,11 @@ async function clearFocus(): Promise<void> {
       /></span>
       <div class="applet-canvas-title">
         <strong>{{ applet?.displayName ?? "Applet" }}</strong>
+        <!--
+          While it is being built the line under the name is the pinned
+          building view below, not a copy of it here.
+        -->
         <small v-if="viewer">{{ generationLabel(viewer.generationId) }}</small>
-        <small v-else>Not published yet</small>
       </div>
       <div
         v-if="canShowApp"
@@ -255,6 +283,39 @@ async function clearFocus(): Promise<void> {
       />
     </header>
 
+    <!--
+      Where the work has got to, pinned under the header while the Applet is
+      still being built: one line a person can read, the reason it stopped when
+      it stopped, and the tail of whatever the check or the build printed —
+      which is the only thing that helps when the Bot is going round in circles
+      on a type error. It sits outside the scrolling column deliberately: a
+      person reading the source still wants to know what is happening to it.
+    -->
+    <section
+      v-if="applet && !loading && progress && beingBuilt"
+      class="applet-canvas-progress"
+      :class="{ 'applet-canvas-progress-wrong': Boolean(progress.failure) }"
+      data-testid="applet-canvas-progress"
+      role="status"
+    >
+      <p class="applet-canvas-progress-line">
+        <span
+          v-if="progress.working"
+          class="applet-canvas-progress-dot"
+          aria-hidden="true"
+        />
+        <UiIcon v-else-if="progress.failure" name="close" size="sm" />
+        <span>{{ progress.label }}</span>
+      </p>
+      <p v-if="progress.failure" class="applet-canvas-progress-failure">
+        {{ progress.failure }}
+      </p>
+      <pre
+        v-if="progress.output"
+        class="applet-canvas-progress-output"
+      ><code>{{ progress.output.join("\n") }}</code></pre>
+    </section>
+
     <div class="applet-canvas-body">
       <!-- Loading: the shape of what is coming, with a caption that says so. -->
       <div v-if="loading" class="applet-canvas-loading">
@@ -297,21 +358,6 @@ async function clearFocus(): Promise<void> {
             <span>This is taking longer than it should.</span>
             <button type="button" @click="retry">Try again</button>
           </div>
-          <p
-            v-if="build && build.status !== 'unknown'"
-            class="applet-canvas-build"
-            :class="`applet-canvas-build-${build.status}`"
-          >
-            <UiIcon
-              :name="build.status === 'passed' ? 'check' : 'close'"
-              size="sm"
-            />
-            <span
-              >{{ build.command === "build" ? "Build" : "Check" }}
-              {{ build.status
-              }}{{ build.summary ? `: ${build.summary}` : "" }}</span
-            >
-          </p>
           <div v-if="sortedFiles.length > 0" class="applet-canvas-files">
             <button
               v-for="file in sortedFiles"
@@ -573,28 +619,76 @@ async function clearFocus(): Promise<void> {
   white-space: pre;
 }
 
-.applet-canvas-build {
+/* Where the work has got to: the panel's own header for the building state. */
+.applet-canvas-progress {
+  display: flex;
+  flex: 0 0 auto;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--frock-border);
+  background: var(--frock-surface-subtle);
+}
+
+.applet-canvas-progress-wrong {
+  border-bottom-color: var(--frock-danger-border);
+  background: var(--frock-danger-surface);
+}
+
+.applet-canvas-progress-line {
   display: flex;
   align-items: center;
-  gap: 6px;
+  gap: 8px;
   margin: 0;
-  padding: 6px 10px;
-  border: 1px solid var(--frock-border);
-  border-radius: var(--frock-radius-control);
-  color: var(--frock-text-muted);
-  font-size: var(--frock-text-xs);
+  color: var(--frock-text);
+  font-size: var(--frock-text-sm);
+  font-weight: 600;
+}
+
+.applet-canvas-progress-wrong .applet-canvas-progress-line {
+  color: var(--frock-danger-text);
+}
+
+/* The same "something is happening" the thread uses, at the size of a word. */
+.applet-canvas-progress-dot {
+  width: 8px;
+  height: 8px;
+  flex: 0 0 auto;
+  border-radius: 999px;
+  background: var(--frock-action-primary);
+  animation: applet-progress-pulse 1.4s ease-in-out infinite;
 }
 
-.applet-canvas-build-passed {
-  border-color: var(--frock-success-border);
-  color: var(--frock-success);
-  background: var(--frock-success-surface);
+@keyframes applet-progress-pulse {
+  0%,
+  100% {
+    opacity: 0.35;
+  }
+
+  50% {
+    opacity: 1;
+  }
 }
 
-.applet-canvas-build-failed {
-  border-color: var(--frock-danger-border);
+.applet-canvas-progress-failure {
+  margin: 0;
   color: var(--frock-danger-text);
-  background: var(--frock-danger-surface);
+  font-size: var(--frock-text-sm);
+}
+
+.applet-canvas-progress-output {
+  max-height: 180px;
+  margin: 0;
+  overflow: auto;
+  padding: 8px 10px;
+  border: 1px solid var(--frock-border);
+  border-radius: var(--frock-radius-control);
+  color: var(--frock-text-muted);
+  background: var(--frock-surface);
+  font-family: var(--frock-font-mono);
+  font-size: var(--frock-text-xs);
+  line-height: var(--frock-leading-snug);
+  white-space: pre;
 }
 
 .applet-canvas-failure {
@@ -686,5 +780,9 @@ async function clearFocus(): Promise<void> {
   .applet-app-leave-active {
     transition: none;
   }
+
+  .applet-canvas-progress-dot {
+    animation: none;
+  }
 }
 </style>