pi-subagents 0.72.0 → 0.73.0

package/src/tui/running-tone.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { ThinkingLevel } from "../shared/model-info.ts";
+type Theme = Pick<ExtensionContext["ui"]["theme"], "fg" | "getThinkingBorderColor">;
+/** Registers where the main session's current thinking level is read; glyphs that stand for several children take its color. */
+export declare function setMainThinkingLevelSource(source: () => ThinkingLevel | undefined): void;
+/** Reads the main session's level through `read`; a stale or not-yet-bound Pi runtime has no level to show. */
+export declare function readMainThinkingLevel(read: () => ThinkingLevel): ThinkingLevel | undefined;
+/** The running tone of a glyph: Pi's prompt-box color for the recorded level of the one child it stands for, else for the main session's current level, else accent. */
+export declare function runningTone(theme: Theme, childLevel?: ThinkingLevel): (text: string) => string;
+export {};
+//# sourceMappingURL=running-tone.d.ts.map

package/src/tui/running-tone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"running-tone.d.ts","sourceRoot":"","sources":["../../../src/tui/running-tone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,KAAK,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,GAAG,wBAAwB,CAAC,CAAC;AAIpF,gIAAgI;AAChI,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAExF;AAED,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,aAAa,GAAG,aAAa,GAAG,SAAS,CAO1F;AAED,wKAAwK;AACxK,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAG9F"}

package/src/tui/running-tone.js

@@ -0,0 +1,23 @@
+import { isStaleExtensionContextError, isUnboundExtensionRuntimeError } from "../shared/extension-context.js";
+let mainThinkingLevelSource = () => undefined;
+/** Registers where the main session's current thinking level is read; glyphs that stand for several children take its color. */
+export function setMainThinkingLevelSource(source) {
+    mainThinkingLevelSource = source;
+}
+/** Reads the main session's level through `read`; a stale or not-yet-bound Pi runtime has no level to show. */
+export function readMainThinkingLevel(read) {
+    try {
+        return read();
+    }
+    catch (error) {
+        if (isStaleExtensionContextError(error) || isUnboundExtensionRuntimeError(error))
+            return undefined;
+        throw error;
+    }
+}
+/** The running tone of a glyph: Pi's prompt-box color for the recorded level of the one child it stands for, else for the main session's current level, else accent. */
+export function runningTone(theme, childLevel) {
+    const level = childLevel ?? mainThinkingLevelSource();
+    return level ? theme.getThinkingBorderColor(level) : (text) => theme.fg("accent", text);
+}
+//# sourceMappingURL=running-tone.js.map

package/src/tui/running-tone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"running-tone.js","sourceRoot":"","sources":["../../../src/tui/running-tone.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAI9G,IAAI,uBAAuB,GAAoC,GAAG,EAAE,CAAC,SAAS,CAAC;AAE/E,gIAAgI;AAChI,MAAM,UAAU,0BAA0B,CAAC,MAAuC;IACjF,uBAAuB,GAAG,MAAM,CAAC;AAClC,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC9D,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,4BAA4B,CAAC,KAAK,CAAC,IAAI,8BAA8B,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACnG,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC;AAED,wKAAwK;AACxK,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,UAA0B;IACnE,MAAM,KAAK,GAAG,UAAU,IAAI,uBAAuB,EAAE,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC"}

package/src/workflows/scripted-workflow.d.ts

@@ -1,10 +1,10 @@
-import type { AcceptanceRecoveryMetadata, HostStepNode, SingleResult } from "../shared/types.ts";
+import type { AcceptanceRecoveryMetadata, HostStepNode, SingleResult, WorkflowScriptFailureKind } from "../shared/types.ts";
 import { type WorkflowHostCommandParams, type WorkflowHostCommandResult } from "./host-command.ts";
 export interface WorkflowScriptValidationError {
     message: string;
     line?: number;
     column?: number;
-    kind?: "spawn-budget";
+    kind?: "spawn-budget" | "agent";
 }
 export interface WorkflowScriptValidationWarning {
     message: string;
@@ -17,6 +17,8 @@ export interface WorkflowScriptValidationResult {
 }
 export interface WorkflowScriptValidationOptions {
     maxSubagentSpawnsPerRun?: number;
+    /** Returns why launch-time resolution would reject this literal child agent name. */
+    agentNameError?: (name: string) => string | undefined;
 }
 export interface WorkflowScriptChildResult {
     key: string;
@@ -127,8 +129,8 @@ export interface WorkflowScriptResult {
 }
 export declare class WorkflowScriptError extends Error {
     readonly partial: Omit<WorkflowScriptResult, "value">;
-    readonly errorKind?: "detached-child" | "timeout";
-    constructor(message: string, partial: Omit<WorkflowScriptResult, "value">, errorKind?: "detached-child" | "timeout");
+    readonly errorKind?: WorkflowScriptFailureKind;
+    constructor(message: string, partial: Omit<WorkflowScriptResult, "value">, errorKind?: WorkflowScriptFailureKind, options?: ErrorOptions);
 }
 export type WorkflowChildSettledOutcome = "completed" | "failed" | "paused" | "stopped";
 export interface WorkflowChildSettledNotification {

package/src/workflows/scripted-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scripted-workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/scripted-workflow.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAsC,KAAK,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAavI,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,qBAAqB,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,+BAA+B,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,+BAA+B;IAC/C,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACjC;AAghCD,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,EAAE,EAAE,OAAO,CAAC;IACZ,mFAAmF;IACnF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,oBAAoB,EAAE,oBAAoB,CAAC;IACzD,eAAe,CAAC,EAAE,OAAO,oBAAoB,EAAE,uBAAuB,CAAC;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,iBAAiB,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,eAAe,CAAC,EAAE,OAAO,oBAAoB,EAAE,0BAA0B,CAAC;IAC1E,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACxC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClH,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,oBAAoB,EAAE,oBAAoB,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IACxC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,+BAA+B;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS;CAMnH;AAED,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExF,MAAM,WAAW,gCAAgC;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,2BAA2B,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kGAAkG;IAClG,qCAAqC,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,KAAK,OAAO,CAAC;IACvE,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtH,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACpK,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,8BAA8B,GAAG,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,+BAA+B,GAAG,OAAO,CAAC,MAAM,GAAG,+BAA+B,CAAC,CAAC;IAC1M,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxF,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC3H,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACnH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,KAAK,CAAC,EAAE;QACP,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,CAAC;IACF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IAC7F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,IAAI,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,gCAAgC,KAAK,IAAI,CAAC;CAC1E;AAkMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAU,EAAE,IAAI,cAAoB,GAAG,IAAI,CAqBtG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ/F;AAWD,MAAM,WAAW,wBAAwB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,wBAAwB,GAAG,SAAS,CAgBzG;AA6VD,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,+BAAoC,GAAG,8BAA8B,CAyGpI;AAiED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgnBxG"}
+{"version":3,"file":"scripted-workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/scripted-workflow.ts"],"names":[],"mappings":"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"}

package/src/workflows/scripted-workflow.js

@@ -45,6 +45,7 @@ let topLevelWorkflowPromise;
 let suppressNativePromiseConsumption = 0;
 const activeNativePromises = [];
 const pending = new Map();
+const workflowErrorKinds = new WeakMap();
 const runKeyPattern = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
 function validGitRef(ref) {
   if (typeof ref !== "string" || !ref || ref === "@" || new TextEncoder().encode(ref).length > 1024 || ref.startsWith("/") || ref.endsWith("/") || ref.includes("//") || ref.includes("..") || ref.includes("@{")) return false;
@@ -848,6 +849,15 @@ function isSyntaxError(error) {
   return error instanceof SyntaxError || error?.name === "SyntaxError";
 }
 
+function postWorkflowError(error) {
+  // Pre-run syntax and portability errors are tagged "validation" where the script is compiled;
+  // anything reaching here was thrown while the script ran, including a runtime SyntaxError.
+  const taggedKind = error && (typeof error === "object" || typeof error === "function") ? workflowErrorKinds.get(error) : undefined;
+  parentPort.postMessage({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error), errorKind: taggedKind ?? "script" });
+}
+
+process.on("unhandledRejection", postWorkflowError);
+
 const NESTED_ASYNC_WORKFLOW_ERROR = "workflowScript validation failed before child launch; no children launched. workflowScript does not support nested async functions. Use top-level await, plain helper functions that return runs.run(...), or explicit Promise chains so workflows stay portable across Node and Bun. Parallel plus sequential rewrite: const a = runs.run(\"a\", { agent: \"worker\", task: \"A\" }); const writer = await runs.run(\"writer\", { agent: \"worker\", task: \"Write\" }); const review = await runs.run(\"review\", { agent: \"reviewer\", task: writer.output }); const [aResult] = await Promise.all([a]); return { a: aResult.output, issue: { writerRunId: writer.runId, reviewRunId: review.runId } };";
 const AST_SCALAR_KEYS = new Set(["type", "start", "end"]);
 
@@ -964,7 +974,7 @@ parentPort.on("message", async (message) => {
     if (message.ok) entry.resolve(message.value);
     else {
       const error = new Error(message.error);
-      if (message.errorKind === "detached-child") error.workflowErrorKind = "detached-child";
+      if (message.errorKind === "child" || message.errorKind === "detached-child") workflowErrorKinds.set(error, message.errorKind);
       entry.reject(error);
     }
     return;
@@ -983,7 +993,7 @@ parentPort.on("message", async (message) => {
       assertPortableWorkflowScript(message.script);
       compiled = new vm.Script("(async () => {\n" + message.script + "\n})()", { filename: "workflow-script.js" });
     } catch (error) {
-      parentPort.postMessage({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error) });
+      parentPort.postMessage({ type: "error", errorKind: "validation", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error) });
       return;
     }
     const nativePromisePrototype = vm.runInContext("(async () => {})().constructor.prototype", context);
@@ -1047,20 +1057,26 @@ parentPort.on("message", async (message) => {
     try {
       assertJsonValue(persistedValue, "return");
     } catch (error) {
-      parentPort.postMessage({ type: "error", errorPhase: "return-serialization", error: formatWorkflowScriptError(error) });
+      parentPort.postMessage({ type: "error", errorKind: "return-serialization", errorPhase: "return-serialization", error: formatWorkflowScriptError(error) });
       return;
     }
     parentPort.postMessage({ type: "complete", value: persistedValue });
   } catch (error) {
-    parentPort.postMessage({ type: "error", error: isSyntaxError(error) ? formatWorkflowScriptSyntaxError(error) : formatWorkflowScriptError(error), ...(error && error.workflowErrorKind === "detached-child" ? { errorKind: "detached-child" } : {}) });
+    postWorkflowError(error);
   }
 });
 `;
+function isWorkflowScriptFailureKind(value) {
+    return value === "validation" || value === "script" || value === "child" || value === "return-serialization" || value === "timeout" || value === "detached-child" || value === "runtime";
+}
+function taggedWorkflowError(message, kind) {
+    return Object.assign(new Error(message), { workflowErrorKind: kind });
+}
 export class WorkflowScriptError extends Error {
     partial;
     errorKind;
-    constructor(message, partial, errorKind) {
-        super(message);
+    constructor(message, partial, errorKind, options) {
+        super(message, options);
         this.name = "WorkflowScriptError";
         this.partial = partial;
         this.errorKind = errorKind;
@@ -1293,7 +1309,10 @@ export function formatWorkflowJsonPreview(value, maxLength) {
     try {
         assertWorkflowJsonValue(value);
         const serialized = JSON.stringify(value);
-        return typeof serialized === "string" ? serialized.slice(0, maxLength) : undefined;
+        if (typeof serialized !== "string")
+            return undefined;
+        // Serialized JSON never ends in "…", so the suffix always means the preview was cut.
+        return serialized.length > maxLength ? `${serialized.slice(0, maxLength)}…` : serialized;
     }
     catch {
         return undefined;
@@ -1591,6 +1610,46 @@ function validateStaticBaseRef(params, owner) {
     }
     return [];
 }
+// Children with their own cwd, agentScope, or resume resolve agents elsewhere, and a
+// spread or computed key can replace `agent`; leave those to launch-time resolution.
+function staticChildAgentNode(params) {
+    if (!astNode(params) || params.type !== "ObjectExpression" || !Array.isArray(params.properties))
+        return undefined;
+    let agent;
+    for (const property of params.properties) {
+        if (!astNode(property) || property.type !== "Property")
+            return undefined;
+        const key = staticPropertyKey(property);
+        if (key === undefined || key === "cwd" || key === "agentScope" || key === "resume")
+            return undefined;
+        if (key === "agent")
+            agent = property.kind === "init" && astNode(property.value) ? property.value : undefined;
+    }
+    return literalString(agent) === undefined ? undefined : agent;
+}
+function validateStaticChildAgents(call, agentNameError) {
+    const args = Array.isArray(call.arguments) ? call.arguments : [];
+    const elements = (node) => astNode(node) && node.type === "ArrayExpression" && Array.isArray(node.elements) ? node.elements : [];
+    // A spread or unknown computed key on the lane can replace `stages`.
+    const staticLane = (lane) => astNode(lane) && lane.type === "ObjectExpression" && Array.isArray(lane.properties)
+        && lane.properties.every((property) => astNode(property) && property.type === "Property" && staticPropertyKey(property) !== undefined);
+    const children = directRunsCall(call, "run")
+        ? [{ owner: "runs.run", params: args[1] }]
+        : directRunsCall(call, "all")
+            ? elements(args[0]).map((params) => ({ owner: "runs.all item", params }))
+            : directRunsCall(call, "lanes")
+                ? elements(args[0]).flatMap((lane) => staticLane(lane) ? elements(directObjectPropertyValue(lane, "stages")).map((params) => ({ owner: "runs.lanes stage", params })) : [])
+                : [];
+    const errors = [];
+    for (const child of children) {
+        const agentNode = staticChildAgentNode(child.params);
+        const agentName = literalString(agentNode);
+        const error = agentName === undefined ? undefined : agentNameError(agentName);
+        if (agentNode && error)
+            errors.push({ kind: "agent", message: `${child.owner}: ${error}`, ...nodeLocation(agentNode) });
+    }
+    return errors;
+}
 function directRunsAllKeys(call) {
     const args = Array.isArray(call.arguments) ? call.arguments : [];
     const items = astNode(args[0]) && args[0].type === "ArrayExpression" && Array.isArray(args[0].elements) ? args[0].elements : [];
@@ -1755,6 +1814,8 @@ export function validateWorkflowScript(script, options = {}) {
         ? root.body[0].expression.callee
         : undefined;
     const workflowBody = wrapper && astNode(wrapper.body) ? wrapper.body : root;
+    // A rebound `runs` may not be the workflow API, so its calls prove nothing about child launches.
+    const agentNameError = options.agentNameError && !invalidatesRunsBinding(workflowBody) ? options.agentNameError : undefined;
     walkAst(workflowBody, (node) => {
         if (node !== wrapper && node.async === true && (node.type === "FunctionDeclaration" || node.type === "FunctionExpression" || node.type === "ArrowFunctionExpression")) {
             errors.push({ message: "workflowScript does not support nested async functions. Use top-level await, plain helper functions that return runs.run(...), or explicit Promise chains.", ...nodeLocation(node) });
@@ -1789,6 +1850,8 @@ export function validateWorkflowScript(script, options = {}) {
         }
         if (directRunsCall(node, "host"))
             errors.push(...validateStaticHostCall(node));
+        if (agentNameError)
+            errors.push(...validateStaticChildAgents(node, agentNameError));
         const boundaryValue = node.type === "CallExpression" && astNode(node.callee) && node.callee.type === "Identifier" && node.callee.name === "emit" && Array.isArray(node.arguments) && astNode(node.arguments[0])
             ? node.arguments[0]
             : node.type === "CallExpression" && astNode(node.callee) && node.callee.type === "MemberExpression" && astNode(node.callee.object) && node.callee.object.type === "Identifier" && node.callee.object.name === "state" && astNode(node.callee.property) && node.callee.property.type === "Identifier" && node.callee.property.name === "set" && Array.isArray(node.arguments) && astNode(node.arguments[1])
@@ -1926,12 +1989,13 @@ function setupAbortResumeParams(params, result, signal) {
     return resumeParams;
 }
 export async function runWorkflowScript(options) {
+    const emptyPartial = () => ({ emits: [], console: [], trace: [], children: [] });
     if (!options.script.trim())
-        throw new Error("workflowScript must not be empty.");
+        throw new WorkflowScriptError("workflowScript must not be empty.", emptyPartial(), "validation");
     if (options.timeoutMs !== undefined && (!Number.isInteger(options.timeoutMs) || options.timeoutMs < 1))
-        throw new Error("workflow script timeout must be a positive integer.");
+        throw new WorkflowScriptError("workflow script timeout must be a positive integer.", emptyPartial(), "runtime");
     if (options.globalConcurrencyLimit !== undefined && (!Number.isSafeInteger(options.globalConcurrencyLimit) || options.globalConcurrencyLimit < 1)) {
-        throw new Error("workflow script global concurrency limit must be a positive integer.");
+        throw new WorkflowScriptError("workflow script global concurrency limit must be a positive integer.", emptyPartial(), "runtime");
     }
     const launchSemaphore = new Semaphore(options.globalConcurrencyLimit ?? DEFAULT_GLOBAL_CONCURRENCY_LIMIT);
     if (options.processCwd !== undefined) {
@@ -1942,7 +2006,7 @@ export async function runWorkflowScript(options) {
         catch (error) {
             const code = typeof error === "object" && error !== null && "code" in error ? error.code : undefined;
             if (code !== "ENOENT")
-                throw new Error("Workflow current cwd could not be validated.", { cause: error });
+                throw new WorkflowScriptError("Workflow current cwd could not be validated.", emptyPartial(), "runtime", { cause: error });
             staleCwd = true;
         }
         try {
@@ -1960,7 +2024,7 @@ export async function runWorkflowScript(options) {
         }
         catch (error) {
             const detail = error instanceof Error ? error.message : String(error);
-            throw new Error(`Workflow process cwd is unavailable: ${options.processCwd}: ${detail}`, { cause: error });
+            throw new WorkflowScriptError(`Workflow process cwd is unavailable: ${options.processCwd}: ${detail}`, emptyPartial(), "runtime", { cause: error });
         }
     }
     let acornPath;
@@ -1968,9 +2032,15 @@ export async function runWorkflowScript(options) {
         acornPath = resolveWorkflowParserEntry();
     }
     catch (error) {
-        throw new Error("Workflow parser dependency 'acorn' is unavailable from pi-subagents. Reinstall pi-subagents dependencies before launching workflowScript.", { cause: error });
+        throw new WorkflowScriptError("Workflow parser dependency 'acorn' is unavailable from pi-subagents. Reinstall pi-subagents dependencies before launching workflowScript.", emptyPartial(), "runtime", { cause: error });
+    }
+    let worker;
+    try {
+        worker = new Worker(WORKER_SOURCE, { eval: true, workerData: { acornPath } });
+    }
+    catch (error) {
+        throw new WorkflowScriptError(`Workflow worker could not start: ${error instanceof Error ? error.message : String(error)}`, emptyPartial(), "runtime", { cause: error });
     }
-    const worker = new Worker(WORKER_SOURCE, { eval: true, workerData: { acornPath } });
     const emits = [];
     const consoleEntries = [];
     const trace = [];
@@ -2117,10 +2187,11 @@ export async function runWorkflowScript(options) {
                             return unobservedHosts.length > 0 ? new Error(`workflowScript completed with unawaited runs.host call(s): ${unobservedHosts.map((key) => `'${key}'`).join(", ")}. Await or return each call.`) : undefined;
                         })()
                         : undefined;
+                // Stops and reloads end through the abort paths untagged: they are not failures.
                 if ("error" in outcome)
-                    reject(new WorkflowScriptError(outcome.error.message, partial(), outcome.error.workflowErrorKind === "detached-child" || outcome.error.workflowErrorKind === "timeout" ? outcome.error.workflowErrorKind : undefined));
+                    reject(new WorkflowScriptError(outcome.error.message, partial(), isWorkflowScriptFailureKind(outcome.error.workflowErrorKind) ? outcome.error.workflowErrorKind : undefined));
                 else if (completionError)
-                    reject(new WorkflowScriptError(completionError.message, partial()));
+                    reject(new WorkflowScriptError(completionError.message, partial(), "validation"));
                 else
                     resolve({ value: outcome.value, ...partial() });
             });
@@ -2143,7 +2214,7 @@ export async function runWorkflowScript(options) {
             }
             catch (callbackError) {
                 const callbackMessage = callbackError instanceof Error ? callbackError.message : String(callbackError);
-                return finish({ error: new Error(`Workflow assembly flush eligibility failed: ${callbackMessage}`) });
+                return finish({ error: taggedWorkflowError(`Workflow assembly flush eligibility failed: ${callbackMessage}`, "runtime") });
             }
             if (mayFlushAssembly && allChildrenSettled) {
                 // A reloaded async workflow may already be past its last child launch.
@@ -2176,17 +2247,15 @@ export async function runWorkflowScript(options) {
         const timer = options.timeoutMs === undefined
             ? undefined
             : setTimeout(() => {
-                const error = new Error(`Workflow script timed out after ${options.timeoutMs}ms.`);
-                error.workflowErrorKind = "timeout";
-                finish({ error });
+                finish({ error: taggedWorkflowError(`Workflow script timed out after ${options.timeoutMs}ms.`, "timeout") });
             }, options.timeoutMs);
         options.signal?.addEventListener("abort", onAbort, { once: true });
         if (options.signal?.aborted)
             return onAbort();
-        worker.on("error", (error) => finish({ error: new Error(`Workflow worker failed: ${error instanceof Error ? error.message : String(error)}`) }));
+        worker.on("error", (error) => finish({ error: taggedWorkflowError(`Workflow worker failed: ${error instanceof Error ? error.message : String(error)}`, "runtime") }));
         worker.on("exit", (code) => {
             if (!settled && code !== 0)
-                finish({ error: new Error(`Workflow worker exited with code ${code}.`) });
+                finish({ error: taggedWorkflowError(`Workflow worker exited with code ${code}.`, "runtime") });
         });
         worker.on("message", (message) => {
             if (settled)
@@ -2200,7 +2269,7 @@ export async function runWorkflowScript(options) {
                     assertWorkflowJsonValue(message.value, "emit");
                 }
                 catch (error) {
-                    finish({ error: new Error(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`) });
+                    finish({ error: taggedWorkflowError(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "runtime") });
                     return;
                 }
                 emits.push(message.value);
@@ -2209,7 +2278,7 @@ export async function runWorkflowScript(options) {
                 }
                 catch (error) {
                     emits.pop();
-                    finish({ error: new Error(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`) });
+                    finish({ error: taggedWorkflowError(`Workflow emit could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "runtime") });
                 }
                 return;
             }
@@ -2224,17 +2293,14 @@ export async function runWorkflowScript(options) {
                     assertWorkflowJsonValue(message.value, "return");
                 }
                 catch (error) {
-                    return finish({ error: new Error(`Workflow return could not be persisted: ${error instanceof Error ? error.message : String(error)}`) });
+                    return finish({ error: taggedWorkflowError(`Workflow return could not be persisted: ${error instanceof Error ? error.message : String(error)}`, "return-serialization") });
                 }
                 return finish({ value: message.value });
             }
             if (message.type === "error") {
                 const rawError = typeof message.error === "string" ? message.error : "Workflow script failed.";
                 const text = message.errorPhase === "return-serialization" ? `${rawError}${workflowReturnRecoveryHint(partial().children)}` : rawError;
-                const workflowError = new Error(text);
-                if (message.errorKind === "detached-child")
-                    workflowError.workflowErrorKind = "detached-child";
-                return finish({ error: workflowError });
+                return finish({ error: isWorkflowScriptFailureKind(message.errorKind) ? taggedWorkflowError(text, message.errorKind) : new Error(text) });
             }
             if (message.type === "callObserved" && typeof message.callId === "number") {
                 const key = typeof message.key === "string" ? message.key : undefined;
@@ -2283,8 +2349,10 @@ export async function runWorkflowScript(options) {
                         worker.postMessage({ type: "response", callId: message.callId, ok: false, error: `${responsePath} must contain only JSON data before it can be returned from workflowScript. Return a plain projection such as { runId, ok, output }. ${error instanceof Error ? error.message : String(error)}` });
                     }
                 }, (error) => {
-                    if (!settled)
-                        worker.postMessage({ type: "response", callId: message.callId, ok: false, error: error instanceof Error ? error.message : String(error), ...(error instanceof Error && error.workflowErrorKind === "detached-child" ? { errorKind: "detached-child" } : {}) });
+                    if (!settled) {
+                        const errorKind = error instanceof Error ? error.workflowErrorKind : undefined;
+                        worker.postMessage({ type: "response", callId: message.callId, ok: false, error: error instanceof Error ? error.message : String(error), ...(isWorkflowScriptFailureKind(errorKind) ? { errorKind } : {}) });
+                    }
                 });
             };
             if (message.method === "state.get" || message.method === "state.set") {
@@ -2443,10 +2511,7 @@ export async function runWorkflowScript(options) {
                     const recoverableAcceptanceMetadata = result.recovery?.status === "available-for-review"
                         && result.recovery.reason === "acceptance-metadata-rejected";
                     if (!result.ok && result.state !== "running" && !result.stopped && !recoverableAcceptanceMetadata) {
-                        const childError = new Error(result.detached ? `Run '${key}' detached: ${result.error ?? result.output}` : `Run '${key}' failed: ${result.error ?? result.output}`);
-                        if (result.detached)
-                            childError.workflowErrorKind = "detached-child";
-                        throw childError;
+                        throw taggedWorkflowError(`Run '${key}' ${result.detached ? "detached" : "failed"}: ${result.error ?? result.output}`, result.detached ? "detached-child" : "child");
                     }
                     return result;
                 });