@bastani/atomic 0.9.4-alpha.1 → 0.9.4-alpha.11

package/dist/builtin/workflows/builtin/ralph-models.ts

@@ -1,27 +1,42 @@
 import { reviewDecisionSchema } from "./ralph-core.js";
 
+// Model chains are curated from Atomic's agentic-coding benchmark
+// (pass@1 / avg $ per task, 2026-07-02):
+// - Placement principle: REVIEWERS get best-in-class verification quality
+//   (fable-5:xhigh 70%/$13.41 leads reviewer-A and the goal reviewer);
+//   EVERY OTHER stage gets the best measured performance-per-dollar
+//   (gpt-5.5:xhigh 67%/$7.23 for hard stages, gpt-5.5:medium 54%/$2.75 for
+//   workhorse stages, gpt-5.5:low $1.20 for retrieval).
+// - Pareto frontier: gpt-5.5 low ($1.20/27%) → gpt-5.5 medium ($2.75/54%) →
+//   fable-5 low ($3.76/60%) → gpt-5.5 high ($5.10/64%) → fable-5 medium
+//   ($6.09/65%) → gpt-5.5 xhigh ($7.23/67%) → fable-5 high ($9.18/69%) →
+//   fable-5 xhigh ($13.41/70%).
+// - Dropped as strictly dominated: claude-sonnet-5 (40-54% at $4-26, up to
+//   268 steps), claude-sonnet-4.6 (30%/$5.52), gemini-3.1-pro (12%/$9.48),
+//   gemini-3.5-flash (37%/$7.34, 276k output tokens).
+// - claude-opus-4.8 rides at :high — its value point (52%/$4.28); :xhigh
+//   doubles the cost for +2pts.
+// - glm-5.2 is reviewer-C's diversity primary only (third model family
+//   decorrelates review errors); elsewhere it is a budget fallback. Note:
+//   GLM-5.2 has only two real reasoning tiers — its thinkingLevelMap collapses
+//   minimal/low/medium/high to "high" and xhigh to "max" — so chains only use
+//   :high (budget tier, 36%/$2.84) or :xhigh (best tier, 44%/$3.92); the
+//   openrouter/z-ai mirror maps :xhigh exclusively, so it is always :xhigh.
+
 export const promptEngineerModelConfig = {
-    model: "anthropic/claude-fable-5:xhigh",
+    model: "openai-codex/gpt-5.5:xhigh",
     fallbackModels: [
-      "openai-codex/gpt-5.5:xhigh",
       "github-copilot/gpt-5.5:xhigh",
       "openai/gpt-5.5:xhigh",
-      "github-copilot/claude-opus-4.8 (1m):xhigh",
-      "anthropic/claude-opus-4-8:xhigh",
+      "anthropic/claude-fable-5:xhigh",
+      "github-copilot/claude-opus-4.8 (1m):high",
+      "anthropic/claude-opus-4-8:high",
       "zai/glm-5.2:xhigh",
       "zai-coding-cn/glm-5.2:xhigh",
-      "github-copilot/gemini-3.5-flash (1m):high",
-      "google/gemini-3.5-flash:high",
-      "google-vertex/gemini-3.5-flash:high",
-      "github-copilot/gemini-3.1-pro-preview (1m):high",
-      "google/gemini-3.1-pro-preview:high",
-      "google-vertex/gemini-3.1-pro-preview:high",
-      "openrouter/anthropic/claude-fable-5:xhigh",
       "openrouter/openai/gpt-5.5:xhigh",
-      "openrouter/anthropic/claude-opus-4-8:xhigh",
-      "openrouter/z-ai/glm-5.2:xhigh",
-      "openrouter/google/gemini-3.5-flash:high",
-      "openrouter/google/gemini-3.1-pro-preview:high"
+      "openrouter/anthropic/claude-fable-5:xhigh",
+      "openrouter/anthropic/claude-opus-4-8:high",
+      "openrouter/z-ai/glm-5.2:xhigh"
     ],
     excludedTools: ["ask_user_question"],
 };
@@ -31,21 +46,15 @@ export const researchModelConfig = {
     fallbackModels: [
         "github-copilot/gpt-5.5:medium",
         "openai/gpt-5.5:medium",
+        "anthropic/claude-fable-5:low",
         "github-copilot/claude-opus-4.8 (1m):medium",
         "anthropic/claude-opus-4-8:medium",
-        "zai/glm-5.2:medium",
-        "zai-coding-cn/glm-5.2:medium",
-        "github-copilot/gemini-3.5-flash (1m):medium",
-        "google/gemini-3.5-flash:medium",
-        "google-vertex/gemini-3.5-flash:medium",
-        "github-copilot/gemini-3.1-pro-preview (1m):medium",
-        "google/gemini-3.1-pro-preview:medium",
-        "google-vertex/gemini-3.1-pro-preview:medium",
+        "zai/glm-5.2:high",
+        "zai-coding-cn/glm-5.2:high",
         "openrouter/openai/gpt-5.5:medium",
+        "openrouter/anthropic/claude-fable-5:low",
         "openrouter/anthropic/claude-opus-4-8:medium",
-        "openrouter/z-ai/glm-5.2:medium",
-        "openrouter/google/gemini-3.5-flash:medium",
-        "openrouter/google/gemini-3.1-pro-preview:medium"
+        "openrouter/z-ai/glm-5.2:xhigh"
     ],
     excludedTools: ["ask_user_question"],
 };
@@ -55,21 +64,15 @@ export const orchestratorModelConfig = {
     fallbackModels: [
         "github-copilot/gpt-5.5:medium",
         "openai/gpt-5.5:medium",
+        "anthropic/claude-fable-5:low",
         "github-copilot/claude-opus-4.8 (1m):medium",
         "anthropic/claude-opus-4-8:medium",
-        "zai/glm-5.2:medium",
-        "zai-coding-cn/glm-5.2:medium",
-        "github-copilot/gemini-3.5-flash (1m):medium",
-        "google/gemini-3.5-flash:medium",
-        "google-vertex/gemini-3.5-flash:medium",
-        "github-copilot/gemini-3.1-pro-preview (1m):medium",
-        "google/gemini-3.1-pro-preview:medium",
-        "google-vertex/gemini-3.1-pro-preview:medium",
+        "zai/glm-5.2:high",
+        "zai-coding-cn/glm-5.2:high",
         "openrouter/openai/gpt-5.5:medium",
+        "openrouter/anthropic/claude-fable-5:low",
         "openrouter/anthropic/claude-opus-4-8:medium",
-        "openrouter/z-ai/glm-5.2:medium",
-        "openrouter/google/gemini-3.5-flash:medium",
-        "openrouter/google/gemini-3.1-pro-preview:medium"
+        "openrouter/z-ai/glm-5.2:xhigh"
     ],
     excludedTools: ["ask_user_question"],
 };
@@ -77,25 +80,17 @@ export const orchestratorModelConfig = {
 export const reviewerAModelConfig = {
     model: "anthropic/claude-fable-5:xhigh",
     fallbackModels: [
-      "github-copilot/claude-opus-4.8 (1m):xhigh",
-      "anthropic/claude-opus-4-8:xhigh",
       "openai-codex/gpt-5.5:xhigh",
       "github-copilot/gpt-5.5:xhigh",
       "openai/gpt-5.5:xhigh",
+      "github-copilot/claude-opus-4.8 (1m):high",
+      "anthropic/claude-opus-4-8:high",
       "zai/glm-5.2:xhigh",
       "zai-coding-cn/glm-5.2:xhigh",
-      "github-copilot/gemini-3.5-flash (1m):high",
-      "google/gemini-3.5-flash:high",
-      "google-vertex/gemini-3.5-flash:high",
-      "github-copilot/gemini-3.1-pro-preview (1m):high",
-      "google/gemini-3.1-pro-preview:high",
-      "google-vertex/gemini-3.1-pro-preview:high",
       "openrouter/anthropic/claude-fable-5:xhigh",
-      "openrouter/anthropic/claude-opus-4-8:xhigh",
       "openrouter/openai/gpt-5.5:xhigh",
-      "openrouter/z-ai/glm-5.2:xhigh",
-      "openrouter/google/gemini-3.5-flash:high",
-      "openrouter/google/gemini-3.1-pro-preview:high"
+      "openrouter/anthropic/claude-opus-4-8:high",
+      "openrouter/z-ai/glm-5.2:xhigh"
     ],
     excludedTools: ["ask_user_question"],
     schema: reviewDecisionSchema,
@@ -107,22 +102,14 @@ export const reviewerBModelConfig = {
       "github-copilot/gpt-5.5:xhigh",
       "openai/gpt-5.5:xhigh",
       "anthropic/claude-fable-5:xhigh",
-      "github-copilot/claude-opus-4.8 (1m):xhigh",
-      "anthropic/claude-opus-4-8:xhigh",
+      "github-copilot/claude-opus-4.8 (1m):high",
+      "anthropic/claude-opus-4-8:high",
       "zai/glm-5.2:xhigh",
       "zai-coding-cn/glm-5.2:xhigh",
-      "github-copilot/gemini-3.5-flash (1m):high",
-      "google/gemini-3.5-flash:high",
-      "google-vertex/gemini-3.5-flash:high",
-      "github-copilot/gemini-3.1-pro-preview (1m):high",
-      "google/gemini-3.1-pro-preview:high",
-      "google-vertex/gemini-3.1-pro-preview:high",
       "openrouter/openai/gpt-5.5:xhigh",
       "openrouter/anthropic/claude-fable-5:xhigh",
-      "openrouter/anthropic/claude-opus-4-8:xhigh",
-      "openrouter/z-ai/glm-5.2:xhigh",
-      "openrouter/google/gemini-3.5-flash:high",
-      "openrouter/google/gemini-3.1-pro-preview:high"
+      "openrouter/anthropic/claude-opus-4-8:high",
+      "openrouter/z-ai/glm-5.2:xhigh"
     ],
     excludedTools: ["ask_user_question"],
     schema: reviewDecisionSchema,
@@ -132,26 +119,17 @@ export const reviewerCModelConfig = {
     model: "zai/glm-5.2:xhigh",
     fallbackModels: [
       "zai-coding-cn/glm-5.2:xhigh",
-      "github-copilot/gemini-3.5-flash (1m):high",
-      "google/gemini-3.5-flash:high",
-      "google-vertex/gemini-3.5-flash:high",
-      "github-copilot/gemini-3.1-pro-preview (1m):high",
-      "google/gemini-3.1-pro-preview:high",
-      "google-vertex/gemini-3.1-pro-preview:high",
+      "openrouter/z-ai/glm-5.2:xhigh",
       "openai-codex/gpt-5.5:xhigh",
       "github-copilot/gpt-5.5:xhigh",
       "openai/gpt-5.5:xhigh",
       "anthropic/claude-fable-5:xhigh",
-      "github-copilot/claude-opus-4.8 (1m):xhigh",
-      "anthropic/claude-opus-4-8:xhigh",
-      "openrouter/anthropic/claude-fable-5:xhigh",
-      "openrouter/anthropic/claude-opus-4-8:xhigh",
+      "github-copilot/claude-opus-4.8 (1m):high",
+      "anthropic/claude-opus-4-8:high",
       "openrouter/openai/gpt-5.5:xhigh",
-      "openrouter/z-ai/glm-5.2:xhigh",
-      "openrouter/google/gemini-3.5-flash:high",
-      "openrouter/google/gemini-3.1-pro-preview:high"
+      "openrouter/anthropic/claude-fable-5:xhigh",
+      "openrouter/anthropic/claude-opus-4-8:high"
     ],
     excludedTools: ["ask_user_question"],
     schema: reviewDecisionSchema,
 };
-

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.4-alpha.1",
+  "version": "0.9.4-alpha.11",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [
@@ -83,7 +83,7 @@
   },
   "peerDependencies": {
     "@bastani/atomic": "*",
-    "@earendil-works/pi-tui": "^0.80.2"
+    "@earendil-works/pi-tui": "^0.80.3"
   },
   "peerDependenciesMeta": {
     "@bastani/atomic": {

package/dist/builtin/workflows/src/runs/shared/model-fallback-failures.ts

@@ -49,7 +49,9 @@ export type ModelFallbackFailureKind =
   | "rate_limit"
   | "provider_unavailable"
   | "network_timeout"
+  | "transport_error"
   | "model_unavailable"
+  | "request_incompatible"
   | "cancelled"
   | "task_failure"
   | "unknown";
@@ -76,7 +78,9 @@ const FALLBACKABLE_FAILURE_KINDS: ReadonlySet<ModelFallbackFailureKind> = new Se
   "rate_limit",
   "provider_unavailable",
   "network_timeout",
+  "transport_error",
   "model_unavailable",
+  "request_incompatible",
 ]);
 
 function asRecord(value: unknown): Record<string, unknown> | undefined {
@@ -155,6 +159,9 @@ function normalizeCode(value: string | number | undefined): string | undefined {
 
 function kindFromStatus(status: number | undefined): ModelFallbackFailureKind | undefined {
   switch (status) {
+    case 400:
+    case 413: case 422:
+      return "request_incompatible";
     case 401:
     case 403:
       return "auth_on_candidate_provider";
@@ -191,6 +198,15 @@ function refusalKindFromCode(code: string | number | undefined): ModelFallbackFa
   }
 }
 
+const REQUEST_INCOMPATIBLE_CODES: ReadonlySet<string> = new Set([
+  "invalid_request", "invalid_request_error", "bad_request", "context_length_exceeded",
+  "request_too_large", "too_large", "request_entity_too_large", "max_tokens",
+  "max_context_length", "context_window_exceeded",
+]);
+function requestIncompatibleKindFromCode(code: string | number | undefined): ModelFallbackFailureKind | undefined {
+  const normalizedCode = normalizeCode(code);
+  return normalizedCode !== undefined && REQUEST_INCOMPATIBLE_CODES.has(normalizedCode) ? "request_incompatible" : undefined;
+}
 function kindFromCode(code: string | number | undefined): ModelFallbackFailureKind | undefined {
   const normalizedCode = normalizeCode(code);
   if (normalizedCode === undefined) return undefined;
@@ -198,6 +214,8 @@ function kindFromCode(code: string | number | undefined): ModelFallbackFailureKi
   if (refusalKind !== undefined) return refusalKind;
   const httpStatusKind = kindFromStatus(integerFrom(code));
   if (httpStatusKind !== undefined) return httpStatusKind;
+  const requestIncompatibleKind = requestIncompatibleKindFromCode(code);
+  if (requestIncompatibleKind !== undefined) return requestIncompatibleKind;
 
   switch (normalizedCode) {
     case "auth":
@@ -246,6 +264,18 @@ function kindFromCode(code: string | number | undefined): ModelFallbackFailureKi
   }
 }
 
+const REQUEST_INCOMPATIBLE_FAILURE_PATTERNS: readonly RegExp[] = [
+  /\bcontext[_\s-]?length(?:[_\s-]?exceeded)?\b/i,
+  /\bcontext[_\s-]?window(?:[_\s-]?exceeded)?\b/i,
+  /\bmax[_\s-]?context\b/i,
+  /\bmax[_\s-]?tokens?\b/i,
+  /\brequest(?:[_\s-]?entity)?[_\s-]?too[_\s-]?large\b/i,
+  /\btoo[_\s-]?large\b/i,
+  /\b(?:unsupported|unknown|invalid)\s+(?:tool|parameter|function)\b/i,
+  /\b(?:tool|parameter|function)\s+(?:not\s+(?:supported|found|allowed)|unknown|invalid)\b/i,
+  /\binvalid[_\s-]?request(?:[_\s-]?error)?\b/i,
+  /\bbad[_\s-]?request\b/i,
+];
 const PROVIDER_REFUSAL_FAILURE_PATTERNS: readonly RegExp[] = [
   /\bfinish[_\s-]?reason\b[^\n]*\bcontent[_\s-]?filter\b/i,
   /\bcontent[_\s-]?filter(?:ed|ing)?\b/i,
@@ -258,6 +288,17 @@ const PROVIDER_REFUSAL_FAILURE_PATTERNS: readonly RegExp[] = [
   /\bprovider\b[^\n]*\brefus(?:e|al|ed|es|ing)?\b[^\n]*\b(?:prompt|request|content|policy|safety)\b/i,
 ];
 
+const TRANSPORT_OUTAGE_FAILURE_PATTERNS: readonly RegExp[] = [
+  /^connection\s+error\.?$/i,
+  /^fetch\s+failed\.?$/i,
+];
+
+function transportOutageKindFromMessage(message: string): ModelFallbackFailureKind | undefined {
+  return TRANSPORT_OUTAGE_FAILURE_PATTERNS.some((pattern) => pattern.test(message.trim()))
+    ? "transport_error"
+    : undefined;
+}
+
 function refusalKindFromMessage(message: string): ModelFallbackFailureKind | undefined {
   if (CANCELLED_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) return "cancelled";
   if (NON_RETRYABLE_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) return "task_failure";
@@ -268,6 +309,9 @@ function refusalKindFromMessage(message: string): ModelFallbackFailureKind | und
 function fallbackKindFromMessage(message: string, name: string | undefined): ModelFallbackFailureKind | undefined {
   const refusalKind = refusalKindFromMessage(message);
   if (refusalKind !== undefined) return refusalKind;
+  const transportOutageKind = transportOutageKindFromMessage(message);
+  if (transportOutageKind !== undefined) return transportOutageKind;
+  if (REQUEST_INCOMPATIBLE_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) return "request_incompatible";
   const nameKind = kindFromCode(name);
   if (nameKind !== undefined) return nameKind;
   if (!RETRYABLE_MODEL_FAILURE_PATTERNS.some((pattern) => pattern.test(message))) return undefined;
@@ -305,6 +349,16 @@ function makeSignal(
   };
 }
 
+function fallbackSignalFromDirectMessage(
+  value: unknown,
+  source: ModelFallbackFailureSource | undefined,
+): ModelFallbackFailureSignal | undefined {
+  const message = directMessageFrom(value);
+  if (message === undefined) return undefined;
+  const kind = fallbackKindFromMessage(message, errorName(value));
+  return kind === undefined ? undefined : makeSignal(kind, value, source);
+}
+
 function fallbackSignalFromMessage(
   value: unknown,
   source: ModelFallbackFailureSource | undefined,
@@ -359,7 +413,6 @@ function structuredSignal(
     if (isRefusalSignal(diagnosticSignal)) return diagnosticSignal;
     firstNestedFallbackSignal ??= diagnosticSignal;
   }
-
   const cause = causeOf(value);
   const causeSignal = structuredSignal(cause, nestedSeen, source)
     ?? fallbackSignalFromMessage(cause, source);
@@ -368,6 +421,11 @@ function structuredSignal(
     firstNestedFallbackSignal ??= causeSignal;
   }
 
+  // Direct-message classification runs after nested traversal so a generic wrapper
+  // ("invalid request"/"400 bad request") cannot mask a non-retryable nested signal.
+  const directMessageSignal = fallbackSignalFromDirectMessage(value, source);
+  if (directMessageSignal !== undefined) return directMessageSignal;
+
   const statusKind = kindFromStatus(statusFrom(value));
   if (statusKind !== undefined) return makeSignal(statusKind, value, source);
   if (codeKind !== undefined) return makeSignal(codeKind, value, source);

package/dist/builtin/workflows/src/tui/keybindings-adapter.ts

@@ -38,6 +38,10 @@ export interface KeybindingsLike {
   matches(data: string, action: string): boolean;
 }
 
+export const APP_ACTION = {
+  toolsExpand: "app.tools.expand",
+} as const;
+
 export const TUI_ACTION = {
   editorCursorUp: "tui.editor.cursorUp",
   editorCursorDown: "tui.editor.cursorDown",

package/dist/builtin/workflows/src/tui/overlay-adapter.ts

@@ -48,6 +48,8 @@ export interface OverlayUISurface {
   focusHostInlineCustomUi?: () => boolean;
   getEditorComponent?: () => PiEditorFactory | undefined;
   getChatRenderSettings?: () => OverlayChatRenderSettings | undefined;
+  getToolsExpanded?: () => boolean;
+  setToolsExpanded?: (expanded: boolean) => void;
   getFooterDataProvider?: () => ReadonlyFooterDataProvider;
   setStatus?: (key: string, value: string | undefined) => void;
 }
@@ -334,6 +336,8 @@ export function buildGraphOverlayAdapter(
         piKeybindings: keybindings,
         piEditorFactory: ui?.getEditorComponent?.(),
         getChatRenderSettings: ui?.getChatRenderSettings,
+        getToolsExpanded: ui?.getToolsExpanded,
+        setToolsExpanded: ui?.setToolsExpanded,
         footerData: ui?.getFooterDataProvider?.(),
         // Pi-tui owns terminal dimensions; thread its row count down
         // so the overlay frame fills the actual viewport rather than

package/dist/builtin/workflows/src/tui/stage-chat-view-input.ts

@@ -3,7 +3,7 @@ import {
   handlePromptCardInput,
   isPromptEscapeInput,
 } from "./prompt-card.js";
-import { isKeybindingsLike } from "./keybindings-adapter.js";
+import { APP_ACTION, isKeybindingsLike, matchesAction } from "./keybindings-adapter.js";
 import {
   setComponentFocused,
   setEditorFocused,
@@ -35,6 +35,7 @@ export function handleStageChatInput(
     ctx.requestRender?.();
     return true;
   }
+  if (handleToolsExpandInput(ctx, data)) return true;
   if (ctx.mountedCustomUi) {
     return handleMountedCustomUiInput(ctx, data);
   }
@@ -87,6 +88,16 @@ export function handleStageChatInput(
   return ctx.chatHost.handleInput(data);
 }
 
+function handleToolsExpandInput(ctx: StageChatViewContext, data: string): boolean {
+  const keybindings = isKeybindingsLike(ctx.piKeybindings) ? ctx.piKeybindings : undefined;
+  if (!matchesAction(keybindings, data, APP_ACTION.toolsExpand)) return false;
+  const expanded = ctx.getToolsExpanded?.() === true;
+  ctx.setToolsExpanded?.(!expanded);
+  ctx.chatHost.invalidate();
+  ctx.requestRender?.();
+  return true;
+}
+
 function handleMountedCustomUiInput(
   ctx: StageChatViewContext,
   data: string,

package/dist/builtin/workflows/src/tui/stage-chat-view-state.ts

@@ -57,6 +57,8 @@ export function initializeStageChatView(
   ctx.piTheme = opts.piTheme;
   ctx.piKeybindings = opts.piKeybindings;
   ctx.piEditorFactory = opts.piEditorFactory;
+  ctx.getToolsExpanded = opts.getToolsExpanded;
+  ctx.setToolsExpanded = opts.setToolsExpanded;
   ctx.stageUiBroker = opts.stageUiBroker ?? stageUiBroker;
   ctx.canSubmitPrompt = opts.canSubmitPrompt;
   ctx.mountedCustomUi = null;

package/dist/builtin/workflows/src/tui/stage-chat-view-types.ts

@@ -63,6 +63,10 @@ export interface StageChatViewOpts {
   getChatRenderSettings?: () =>
     | Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">>
     | undefined;
+  /** Parent host expansion state for tool-output/live-detail widgets. */
+  getToolsExpanded?: () => boolean;
+  /** Toggle parent host expansion state for tool-output/live-detail widgets. */
+  setToolsExpanded?: (expanded: boolean) => void;
   /** Parent footer data provider inherited from the host UI for core footer/usage rendering. */
   footerData?: ReadonlyFooterDataProvider;
   /**
@@ -133,6 +137,8 @@ export interface StageChatViewContext {
   piTheme: unknown;
   piKeybindings: unknown;
   piEditorFactory: StageChatViewOpts["piEditorFactory"] | undefined;
+  getToolsExpanded: (() => boolean) | undefined;
+  setToolsExpanded: ((expanded: boolean) => void) | undefined;
   chatHost: ChatSessionHost<NoticeEntry>;
   stageUiBroker: StageUiBroker;
   canSubmitPrompt: ((runId: string, stageId: string, promptId: string) => boolean) | undefined;

package/dist/builtin/workflows/src/tui/stage-chat-view.ts

@@ -83,6 +83,8 @@ export class StageChatView implements Component, Focusable {
   private piTheme!: StageChatViewContext["piTheme"];
   private piKeybindings!: StageChatViewContext["piKeybindings"];
   private piEditorFactory!: StageChatViewContext["piEditorFactory"];
+  private getToolsExpanded!: StageChatViewContext["getToolsExpanded"];
+  private setToolsExpanded!: StageChatViewContext["setToolsExpanded"];
   private chatHost!: StageChatViewContext["chatHost"];
   private stageUiBroker!: StageChatViewContext["stageUiBroker"];
   private canSubmitPrompt!: StageChatViewContext["canSubmitPrompt"];
@@ -213,6 +215,8 @@ export class StageChatView implements Component, Focusable {
     void this.piTheme;
     void this.piKeybindings;
     void this.piEditorFactory;
+    void this.getToolsExpanded;
+    void this.setToolsExpanded;
     void this.stageUiBroker;
     void this.canSubmitPrompt;
     void this.mountingRequestId;

package/dist/builtin/workflows/src/tui/workflow-attach-pane-types.ts

@@ -41,6 +41,10 @@ export interface WorkflowAttachPaneOpts {
   piEditorFactory?: (tui: TUI, theme: EditorTheme, keybindings: unknown) => EditorComponent;
   /** Parent chat rendering settings and extension renderers, inherited from the host UI. */
   getChatRenderSettings?: () => Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">> | undefined;
+  /** Parent host tool-output/live-detail expansion state, inherited from the host UI. */
+  getToolsExpanded?: () => boolean;
+  /** Parent host tool-output/live-detail expansion setter, inherited from the host UI. */
+  setToolsExpanded?: (expanded: boolean) => void;
   /** Parent footer data provider, inherited so attached chats can render the core coding-agent footer. */
   footerData?: ReadonlyFooterDataProvider;
   /**

package/dist/builtin/workflows/src/tui/workflow-attach-pane.ts

@@ -24,16 +24,9 @@ import type { ChatMessageRenderOptions, ReadonlyFooterDataProvider } from "@bast
 import type { Store } from "../shared/store.js";
 import type { GraphTheme } from "./graph-theme.js";
 import { GraphView } from "./graph-view.js";
-import {
-  StageChatView,
-  type StageChatDetachMetadata,
-  type StageChatDetachReason,
-} from "./stage-chat-view.js";
+import { StageChatView, type StageChatDetachMetadata, type StageChatDetachReason } from "./stage-chat-view.js";
 import { Key, matchesKey } from "./text-helpers.js";
-import type {
-  StageControlHandle,
-  StageControlRegistry,
-} from "../runs/foreground/stage-control-registry.js";
+import type { StageControlHandle, StageControlRegistry } from "../runs/foreground/stage-control-registry.js";
 import type { StageUiBroker } from "../shared/stage-ui-broker.js";
 import type { StageSnapshot, StoreSnapshot } from "../shared/store-types.js";
 import { expandWorkflowGraph } from "../shared/expanded-workflow-graph.js";
@@ -68,6 +61,8 @@ export class WorkflowAttachPane implements Component {
   private piKeybindings?: unknown;
   private piEditorFactory?: (tui: TUI, theme: EditorTheme, keybindings: unknown) => EditorComponent;
   private getChatRenderSettings?: () => Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">> | undefined;
+  private getToolsExpanded?: () => boolean;
+  private setToolsExpanded?: (expanded: boolean) => void;
   private footerData?: ReadonlyFooterDataProvider;
   private now: () => number;
   private mode: WorkflowAttachPaneMode = "graph";
@@ -104,6 +99,8 @@ export class WorkflowAttachPane implements Component {
     this.piKeybindings = opts.piKeybindings;
     this.piEditorFactory = opts.piEditorFactory;
     this.getChatRenderSettings = opts.getChatRenderSettings;
+    this.getToolsExpanded = opts.getToolsExpanded;
+    this.setToolsExpanded = opts.setToolsExpanded;
     this.footerData = opts.footerData;
     this.now = opts.now ?? Date.now;
     this.unsubscribeStore = this.store.subscribe((snapshot) => this._handleStoreUpdate(snapshot));
@@ -197,6 +194,8 @@ export class WorkflowAttachPane implements Component {
       piKeybindings: this.piKeybindings,
       piEditorFactory: this.piEditorFactory,
       getChatRenderSettings: this.getChatRenderSettings,
+      getToolsExpanded: this.getToolsExpanded,
+      setToolsExpanded: this.setToolsExpanded,
       footerData: this.footerData,
       getViewportRows: this.getViewportRows,
       stageUiBroker: this.stageUiBroker,

package/dist/bun/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\nawait import(\"./register-bedrock.ts\");\nawait import(\"../cli.ts\");\n"]}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\n// No top-level await: the compiled binary is built with --bytecode (CJS),\n// which forbids TLA anywhere in the bundled graph.\nvoid import(\"./register-bedrock.ts\").then(() => import(\"../cli.ts\"));\n"]}

package/dist/bun/cli.js

@@ -4,6 +4,7 @@ process.title = APP_NAME;
 process.emitWarning = (() => { });
 import { restoreSandboxEnv } from "./restore-sandbox-env.js";
 restoreSandboxEnv();
-await import("./register-bedrock.js");
-await import("../cli.js");
+// No top-level await: the compiled binary is built with --bytecode (CJS),
+// which forbids TLA anywhere in the bundled graph.
+void import("./register-bedrock.js").then(() => import("../cli.js"));
 //# sourceMappingURL=cli.js.map

package/dist/bun/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,GAAE,CAAC,CAA+B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,iBAAiB,EAAE,CAAC;AAEpB,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACtC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\nawait import(\"./register-bedrock.ts\");\nawait import(\"../cli.ts\");\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,GAAE,CAAC,CAA+B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,iBAAiB,EAAE,CAAC;AAEpB,0EAA0E;AAC1E,mDAAmD;AACnD,KAAK,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nrestoreSandboxEnv();\n\n// No top-level await: the compiled binary is built with --bytecode (CJS),\n// which forbids TLA anywhere in the bundled graph.\nvoid import(\"./register-bedrock.ts\").then(() => import(\"../cli.ts\"));\n"]}

package/dist/cli/file-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/cli/file-processor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAOjE,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,sEAAsE;AACtE,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2EpH","sourcesContent":["/**\n * Process @file CLI arguments into text content and image attachments\n */\n\nimport { access, readFile, stat } from \"node:fs/promises\";\nimport type { ImageContent } from \"@earendil-works/pi-ai/compat\";\nimport chalk from \"chalk\";\nimport { resolve } from \"path\";\nimport { resolveReadPath } from \"../core/tools/path-utils.ts\";\nimport { formatDimensionNote, resizeImage } from \"../utils/image-resize.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../utils/mime.ts\";\n\nexport interface ProcessedFiles {\n\ttext: string;\n\timages: ImageContent[];\n}\n\nexport interface ProcessFileOptions {\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\n\tautoResizeImages?: boolean;\n}\n\n/** Process @file arguments into text content and image attachments */\nexport async function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles> {\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\n\tlet text = \"\";\n\tconst images: ImageContent[] = [];\n\n\tfor (const fileArg of fileArgs) {\n\t\t// Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)\n\t\tconst absolutePath = resolve(resolveReadPath(fileArg, process.cwd()));\n\n\t\t// Check if file exists\n\t\ttry {\n\t\t\tawait access(absolutePath);\n\t\t} catch {\n\t\t\tconsole.error(chalk.red(`Error: File not found: ${absolutePath}`));\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\t// Check if file is empty\n\t\tconst stats = await stat(absolutePath);\n\t\tif (stats.size === 0) {\n\t\t\t// Skip empty files\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst mimeType = await detectSupportedImageMimeTypeFromFile(absolutePath);\n\n\t\tif (mimeType) {\n\t\t\t// Handle image file\n\t\t\tconst content = await readFile(absolutePath);\n\n\t\t\tlet attachment: ImageContent;\n\t\t\tlet dimensionNote: string | undefined;\n\n\t\t\tif (autoResizeImages) {\n\t\t\t\tconst resized = await resizeImage(content, mimeType);\n\t\t\t\tif (!resized) {\n\t\t\t\t\ttext += `<file name=\"${absolutePath}\">[Image omitted: could not be resized below the inline image size limit.]</file>\\n`;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tdimensionNote = formatDimensionNote(resized);\n\t\t\t\tattachment = {\n\t\t\t\t\ttype: \"image\",\n\t\t\t\t\tmimeType: resized.mimeType,\n\t\t\t\t\tdata: resized.data,\n\t\t\t\t};\n\t\t\t} else {\n\t\t\t\tattachment = {\n\t\t\t\t\ttype: \"image\",\n\t\t\t\t\tmimeType,\n\t\t\t\t\tdata: content.toString(\"base64\"),\n\t\t\t\t};\n\t\t\t}\n\n\t\t\timages.push(attachment);\n\n\t\t\t// Add text reference to image with optional dimension note\n\t\t\tif (dimensionNote) {\n\t\t\t\ttext += `<file name=\"${absolutePath}\">${dimensionNote}</file>\\n`;\n\t\t\t} else {\n\t\t\t\ttext += `<file name=\"${absolutePath}\"></file>\\n`;\n\t\t\t}\n\t\t} else {\n\t\t\t// Handle text file\n\t\t\ttry {\n\t\t\t\tconst content = await readFile(absolutePath, \"utf-8\");\n\t\t\t\ttext += `<file name=\"${absolutePath}\">\\n${content}\\n</file>\\n`;\n\t\t\t} catch (error: unknown) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tconsole.error(chalk.red(`Error: Could not read file ${absolutePath}: ${message}`));\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { text, images };\n}\n"]}
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/cli/file-processor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAOjE,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,sEAAsE;AACtE,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+DpH","sourcesContent":["/**\n * Process @file CLI arguments into text content and image attachments\n */\n\nimport { access, readFile, stat } from \"node:fs/promises\";\nimport type { ImageContent } from \"@earendil-works/pi-ai/compat\";\nimport chalk from \"chalk\";\nimport { resolve } from \"path\";\nimport { resolveReadPath } from \"../core/tools/path-utils.ts\";\nimport { processImage } from \"../utils/image-process.ts\";\nimport { detectSupportedImageMimeTypeFromFile } from \"../utils/mime.ts\";\n\nexport interface ProcessedFiles {\n\ttext: string;\n\timages: ImageContent[];\n}\n\nexport interface ProcessFileOptions {\n\t/** Whether to auto-resize images to 2000x2000 max. Default: true */\n\tautoResizeImages?: boolean;\n}\n\n/** Process @file arguments into text content and image attachments */\nexport async function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles> {\n\tconst autoResizeImages = options?.autoResizeImages ?? true;\n\tlet text = \"\";\n\tconst images: ImageContent[] = [];\n\n\tfor (const fileArg of fileArgs) {\n\t\t// Expand and resolve path (handles ~ expansion and macOS screenshot Unicode spaces)\n\t\tconst absolutePath = resolve(resolveReadPath(fileArg, process.cwd()));\n\n\t\t// Check if file exists\n\t\ttry {\n\t\t\tawait access(absolutePath);\n\t\t} catch {\n\t\t\tconsole.error(chalk.red(`Error: File not found: ${absolutePath}`));\n\t\t\tprocess.exit(1);\n\t\t}\n\n\t\t// Check if file is empty\n\t\tconst stats = await stat(absolutePath);\n\t\tif (stats.size === 0) {\n\t\t\t// Skip empty files\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst mimeType = await detectSupportedImageMimeTypeFromFile(absolutePath);\n\n\t\tif (mimeType) {\n\t\t\t// Handle image file\n\t\t\tconst content = await readFile(absolutePath);\n\t\t\tconst processed = await processImage(content, mimeType, { autoResizeImages });\n\n\t\t\tif (!processed.ok) {\n\t\t\t\ttext += `<file name=\"${absolutePath}\">${processed.message}</file>\\n`;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst attachment: ImageContent = {\n\t\t\t\ttype: \"image\",\n\t\t\t\tmimeType: processed.mimeType,\n\t\t\t\tdata: processed.data,\n\t\t\t};\n\t\t\timages.push(attachment);\n\n\t\t\t// Add text reference to image with optional processing hints\n\t\t\tif (processed.hints.length > 0) {\n\t\t\t\ttext += `<file name=\"${absolutePath}\">${processed.hints.join(\"\\n\")}</file>\\n`;\n\t\t\t} else {\n\t\t\t\ttext += `<file name=\"${absolutePath}\"></file>\\n`;\n\t\t\t}\n\t\t} else {\n\t\t\t// Handle text file\n\t\t\ttry {\n\t\t\t\tconst content = await readFile(absolutePath, \"utf-8\");\n\t\t\t\ttext += `<file name=\"${absolutePath}\">\\n${content}\\n</file>\\n`;\n\t\t\t} catch (error: unknown) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tconsole.error(chalk.red(`Error: Could not read file ${absolutePath}: ${message}`));\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { text, images };\n}\n"]}

package/dist/cli/file-processor.js

@@ -5,7 +5,7 @@ import { access, readFile, stat } from "node:fs/promises";
 import chalk from "chalk";
 import { resolve } from "path";
 import { resolveReadPath } from "../core/tools/path-utils.js";
-import { formatDimensionNote, resizeImage } from "../utils/image-resize.js";
+import { processImage } from "../utils/image-process.js";
 import { detectSupportedImageMimeTypeFromFile } from "../utils/mime.js";
 /** Process @file arguments into text content and image attachments */
 export async function processFileArguments(fileArgs, options) {
@@ -33,32 +33,20 @@ export async function processFileArguments(fileArgs, options) {
         if (mimeType) {
             // Handle image file
             const content = await readFile(absolutePath);
-            let attachment;
-            let dimensionNote;
-            if (autoResizeImages) {
-                const resized = await resizeImage(content, mimeType);
-                if (!resized) {
-                    text += `<file name="${absolutePath}">[Image omitted: could not be resized below the inline image size limit.]</file>\n`;
-                    continue;
-                }
-                dimensionNote = formatDimensionNote(resized);
-                attachment = {
-                    type: "image",
-                    mimeType: resized.mimeType,
-                    data: resized.data,
-                };
-            }
-            else {
-                attachment = {
-                    type: "image",
-                    mimeType,
-                    data: content.toString("base64"),
-                };
+            const processed = await processImage(content, mimeType, { autoResizeImages });
+            if (!processed.ok) {
+                text += `<file name="${absolutePath}">${processed.message}</file>\n`;
+                continue;
             }
+            const attachment = {
+                type: "image",
+                mimeType: processed.mimeType,
+                data: processed.data,
+            };
             images.push(attachment);
-            // Add text reference to image with optional dimension note
-            if (dimensionNote) {
-                text += `<file name="${absolutePath}">${dimensionNote}</file>\n`;
+            // Add text reference to image with optional processing hints
+            if (processed.hints.length > 0) {
+                text += `<file name="${absolutePath}">${processed.hints.join("\n")}</file>\n`;
             }
             else {
                 text += `<file name="${absolutePath}"></file>\n`;