pi-extensible-workflows 3.3.0 → 3.4.1

package/dist/src/cli.js

@@ -386,6 +386,8 @@ class CliProgress {
     #frame = 0;
     #run;
     #runId;
+    #runtimeStartedAt = 0;
+    #runtimeBaseMs = 0;
     #timer;
     #interactive;
     #styles;
@@ -399,6 +401,12 @@ class CliProgress {
         if (this.#runId !== run.id) {
             this.#runId = run.id;
             this.onRunId(run.id);
+            this.#runtimeStartedAt = Date.now();
+            this.#runtimeBaseMs = run.usage?.durationMs ?? 0;
+        }
+        else if (this.#run && this.#run.state !== "running" && run.state === "running") {
+            this.#runtimeStartedAt = Date.now();
+            this.#runtimeBaseMs = run.usage?.durationMs ?? 0;
         }
         this.#run = run;
         if (!this.#interactive) {
@@ -414,8 +422,9 @@ class CliProgress {
     render() {
         if (!this.#run)
             return;
+        const run = this.#run.state !== "running" ? this.#run : { ...this.#run, usage: { ...(this.#run.usage ?? { tokens: 0, costUsd: 0, durationMs: 0, agentLaunches: 0 }), durationMs: Math.max(this.#run.usage?.durationMs ?? 0, this.#runtimeBaseMs + Date.now() - this.#runtimeStartedAt) } };
         if (!this.#interactive) {
-            const stable = formatWorkflowProgress(this.#run, "◇", this.#styles);
+            const stable = formatWorkflowProgress(run, "◇", this.#styles);
             if (stable !== this.#lastStable) {
                 this.#lastStable = stable;
                 this.stderr(`${stable}\n`);
@@ -424,7 +433,7 @@ class CliProgress {
         }
         const spinner = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"][this.#frame++ % 10] ?? "◇";
         const width = process.stderr.columns || 80;
-        const text = truncateWorkflowProgress(formatWorkflowProgress(this.#run, spinner, this.#styles), width).join("\n");
+        const text = truncateWorkflowProgress(formatWorkflowProgress(run, spinner, this.#styles), width).join("\n");
         this.stderr(`${this.#lines ? `\x1b[${String(this.#lines)}A` : ""}${this.#lines ? "" : "\x1b[?25l"}\x1b[0J${text}\n`);
         this.#lines = text.split("\n").length;
     }

package/dist/src/doctor-cleanup.js

@@ -63,36 +63,70 @@ function validateScheduledOptions(value, label) { if (!object(value) || typeof v
     optionalString(value.agentIdentity.parentBreadcrumb, `${label}.agentIdentity.parentBreadcrumb`);
     optionalString(value.agentIdentity.worktreeOwner, `${label}.agentIdentity.worktreeOwner`);
 } }
-function validateAgent(value, label) { if (!object(value) || typeof value.id !== "string" || !value.id || typeof value.name !== "string" || !value.name || typeof value.path !== "string" || !value.path || typeof value.state !== "string" || !AGENT_STATES.has(value.state))
-    throw new Error(`${label} is invalid`); optionalString(value.label, `${label}.label`); optionalString(value.parentId, `${label}.parentId`); if (value.structuralPath !== undefined)
-    stringList(value.structuralPath, `${label}.structuralPath`); optionalString(value.parentBreadcrumb, `${label}.parentBreadcrumb`); optionalString(value.worktreeOwner, `${label}.worktreeOwner`); optionalString(value.role, `${label}.role`); optionalString(value.requestedModel, `${label}.requestedModel`); model(value.model, `${label}.model`); stringList(value.tools, `${label}.tools`); nonNegativeInteger(value.attempts, `${label}.attempts`); if (value.lastEventAt !== undefined)
-    finiteNumber(value.lastEventAt, `${label}.lastEventAt`); if (value.attemptDetails !== undefined) {
-    if (!Array.isArray(value.attemptDetails))
-        throw new Error(`${label}.attemptDetails is invalid`);
-    for (const [index, attempt] of value.attemptDetails.entries()) {
-        const at = `${label}.attemptDetails[${String(index)}]`;
-        if (!object(attempt) || !Number.isSafeInteger(attempt.attempt) || Number(attempt.attempt) < 1 || typeof attempt.sessionId !== "string" || !attempt.sessionId || typeof attempt.sessionFile !== "string" || !attempt.sessionFile)
-            throw new Error(`${at} is invalid`);
-        accounting(attempt.accounting, `${at}.accounting`);
-        if (attempt.error !== undefined && (!object(attempt.error) || typeof attempt.error.code !== "string" || typeof attempt.error.message !== "string"))
-            throw new Error(`${at}.error is invalid`);
-        if (attempt.setup !== undefined) {
-            if (!object(attempt.setup) || !Array.isArray(attempt.setup.hookNames) || attempt.setup.hookNames.some((name) => typeof name !== "string") || typeof attempt.setup.cwd !== "string")
-                throw new Error(`${at}.setup is invalid`);
-            model(attempt.setup.model, `${at}.setup.model`);
-            stringList(attempt.setup.tools, `${at}.setup.tools`);
-            resourceExclusions(attempt.setup.disabledAgentResources, `${at}.setup.disabledAgentResources`);
+function validateSessionReference(value, label) {
+    if (!object(value) || typeof value.transport !== "string" || !value.transport || typeof value.sessionId !== "string" || !value.sessionId || (value.locator !== undefined && !jsonValue(value.locator)))
+        throw new Error(`${label} is invalid`);
+}
+function validateAgentSetup(value, label) {
+    if (!object(value))
+        throw new Error(`${label} is invalid`);
+    stringList(value.hookNames, `${label}.hookNames`);
+    model(value.model, `${label}.model`);
+    stringList(value.tools, `${label}.tools`);
+    if (typeof value.cwd !== "string" || !value.cwd)
+        throw new Error(`${label}.cwd is invalid`);
+    resourceExclusions(value.disabledAgentResources, `${label}.disabledAgentResources`);
+}
+function validateAgent(value, label) {
+    if (!object(value) || typeof value.id !== "string" || !value.id || typeof value.name !== "string" || !value.name || typeof value.path !== "string" || !value.path || typeof value.state !== "string" || !AGENT_STATES.has(value.state))
+        throw new Error(`${label} is invalid`);
+    optionalString(value.systemPrompt, `${label}.systemPrompt`);
+    optionalString(value.prompt, `${label}.prompt`);
+    optionalString(value.label, `${label}.label`);
+    optionalString(value.parentId, `${label}.parentId`);
+    if (value.structuralPath !== undefined)
+        stringList(value.structuralPath, `${label}.structuralPath`);
+    optionalString(value.parentBreadcrumb, `${label}.parentBreadcrumb`);
+    optionalString(value.worktreeOwner, `${label}.worktreeOwner`);
+    optionalString(value.role, `${label}.role`);
+    optionalString(value.requestedModel, `${label}.requestedModel`);
+    model(value.model, `${label}.model`);
+    stringList(value.tools, `${label}.tools`);
+    nonNegativeInteger(value.attempts, `${label}.attempts`);
+    if (value.attemptDetails !== undefined) {
+        if (!Array.isArray(value.attemptDetails))
+            throw new Error(`${label}.attemptDetails is invalid`);
+        for (const [index, attempt] of value.attemptDetails.entries()) {
+            const at = `${label}.attemptDetails[${String(index)}]`;
+            if (!object(attempt) || !Number.isSafeInteger(attempt.attempt) || Number(attempt.attempt) < 1 || typeof attempt.transport !== "string" || !attempt.transport || Object.hasOwn(attempt, "sessionId") || Object.hasOwn(attempt, "sessionFile"))
+                throw new Error(`${at} is invalid`);
+            validateAgentSetup(attempt.setup, `${at}.setup`);
+            if (attempt.session !== undefined) {
+                validateSessionReference(attempt.session, `${at}.session`);
+                if (attempt.session.transport !== attempt.transport)
+                    throw new Error(`${at}.session transport does not match attempt transport`);
+            }
+            accounting(attempt.accounting, `${at}.accounting`);
+            if (attempt.error !== undefined && (!object(attempt.error) || typeof attempt.error.code !== "string" || typeof attempt.error.message !== "string"))
+                throw new Error(`${at}.error is invalid`);
         }
     }
-} if (value.accounting !== undefined)
-    accounting(value.accounting, `${label}.accounting`); if (value.toolCalls !== undefined) {
-    if (!Array.isArray(value.toolCalls))
-        throw new Error(`${label}.toolCalls is invalid`);
-    for (const call of value.toolCalls)
-        if (!object(call) || typeof call.id !== "string" || typeof call.name !== "string" || !["running", "completed", "failed"].includes(call.state))
+    if (value.accounting !== undefined)
+        accounting(value.accounting, `${label}.accounting`);
+    if (value.toolCalls !== undefined) {
+        if (!Array.isArray(value.toolCalls))
             throw new Error(`${label}.toolCalls is invalid`);
-} if (value.activity !== undefined && (!object(value.activity) || !["reasoning", "tool", "text"].includes(value.activity.kind) || typeof value.activity.text !== "string"))
-    throw new Error(`${label}.activity is invalid`); }
+        for (const [index, call] of value.toolCalls.entries())
+            if (!object(call) || typeof call.id !== "string" || !call.id || typeof call.name !== "string" || !call.name || !["running", "completed", "failed"].includes(call.state))
+                throw new Error(`${label}.toolCalls[${String(index)}] is invalid`);
+    }
+    if (value.activity !== undefined) {
+        if (!object(value.activity) || !["reasoning", "tool", "text"].includes(value.activity.kind) || typeof value.activity.text !== "string")
+            throw new Error(`${label}.activity is invalid`);
+    }
+    if (value.lastEventAt !== undefined)
+        finiteNumber(value.lastEventAt, `${label}.lastEventAt`);
+}
 function validateUsage(value, label) { if (!object(value))
     throw new Error(`${label} is invalid`); for (const key of ["tokens", "costUsd", "durationMs", "agentLaunches"])
     finiteNumber(value[key], `${label}.${key}`); }
@@ -107,7 +141,7 @@ function validateBudgetEvents(value) { if (value === undefined)
 } }
 function validateRunRecord(run) {
     const value = run;
-    if (!object(value) || typeof value.id !== "string" || !value.id || typeof value.workflowName !== "string" || !value.workflowName || typeof value.cwd !== "string" || !value.cwd || typeof value.sessionId !== "string" || !value.sessionId || !RUN_STATES.includes(value.state) || !Array.isArray(value.agents) || !Array.isArray(value.nativeSessions))
+    if (!object(value) || typeof value.id !== "string" || !value.id || typeof value.workflowName !== "string" || !value.workflowName || typeof value.cwd !== "string" || !value.cwd || typeof value.sessionId !== "string" || !value.sessionId || !RUN_STATES.includes(value.state) || !Array.isArray(value.agents) || !Array.isArray(value.agentSessions) || Object.hasOwn(value, "nativeSessions"))
         throw new Error("Persisted run state is invalid");
     const agents = value.agents;
     agents.forEach((agent, index) => { validateAgent(agent, `agents[${String(index)}]`); });
@@ -132,9 +166,9 @@ function validateRunRecord(run) {
             parent = typeof parentAgent?.parentId === "string" ? parentAgent.parentId : undefined;
         }
     }
-    for (const [index, session] of value.nativeSessions.entries())
-        if (!object(session) || typeof session.sessionId !== "string" || !session.sessionId || typeof session.sessionFile !== "string" || !session.sessionFile)
-            throw new Error(`nativeSessions[${String(index)}] is invalid`);
+    const sessions = value.agentSessions;
+    for (const [index, session] of sessions.entries())
+        validateSessionReference(session, `agentSessions[${String(index)}]`);
     optionalString(value.parentRunId, "Persisted parent run");
     optionalString(value.failedAt, "Persisted failed path");
     if (value.retry !== undefined) {
@@ -267,6 +301,7 @@ async function validateRunArtifacts(store, workflowScript, state) {
             throw new Error(`${label} is invalid`);
         ownershipIds.add(record.id);
         optionalString(record.parentId, `${label}.parentId`);
+        optionalString(record.prompt, `${label}.prompt`);
         validateScheduledOptions(record.options, `${label}.options`);
     }
     for (const record of ownership)

package/dist/src/execution.d.ts

@@ -12,6 +12,6 @@ export declare function agentWorktree(identity: AgentIdentity): {
 };
 export declare function executeShellCommand(command: string, options: ShellOptions, signal: AbortSignal, cwd?: string): Promise<ShellResult>;
 export declare function runWorkflow(script: string, args?: JsonValue, bridge?: WorkflowBridge, signal?: AbortSignal): WorkflowExecution;
-export declare function persistActiveAgentAttempt(store: RunStore, id: string, active: Pick<AgentAttempt, "attempt" | "sessionId" | "sessionFile" | "setup">): Promise<void>;
+export declare function persistActiveAgentAttempt(store: RunStore, id: string, active: AgentAttempt): Promise<void>;
 export declare function persistAgentAttempts(store: RunStore, id: string, attempts: readonly AgentAttempt[]): Promise<void>;
 export type { AgentIdentity, ShellIdentity, WorkflowBridge, WorkflowExecution } from "./types.js";

package/dist/src/execution.js

@@ -9,6 +9,7 @@ import { asWorkflowError, errorText, fail, isWorkflowAuthored, jsonValue, markWo
 import { instrumentWorkflow, validateAgentOptions, validateShellCommand, validateShellOptions } from "./validation.js";
 export const RPC_LIMIT_BYTES = 10 * 1024 * 1024;
 export const HEARTBEAT_TIMEOUT_MS = 5000;
+const HEARTBEAT_INTERVAL_MS = 1000;
 const OUTCOME_ERRORS = new Set(["AGENT_TIMEOUT", "AGENT_FAILED", "RESULT_INVALID"]);
 const WORK_RESULT_BRAND = "__workResult";
 const childSource = String.raw `
@@ -58,7 +59,7 @@ process.on("message", raw => {
   if (message.ok) request.resolve(message.value);
   else request.reject(workflowError(message.error));
 });
-const heartbeat = setInterval(() => send({ type: "heartbeat" }), 1000);
+const heartbeat = setInterval(() => send({ type: "heartbeat" }), ${HEARTBEAT_INTERVAL_MS});
 send({ type: "heartbeat" });
 const BRAND = "${WORK_RESULT_BRAND}";
 const workError = (code, message) => Object.assign(new Error(message), { code });
@@ -458,7 +459,20 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
     const controller = new AbortController();
     let settled = false;
     let rejectResult = () => undefined;
-    let watchdog = setTimeout(() => { stop("WORKER_UNRESPONSIVE", "Workflow worker missed its five-second heartbeat"); }, HEARTBEAT_TIMEOUT_MS);
+    let lastHeartbeatAt = performance.now();
+    let lastWatchdogCheckAt = lastHeartbeatAt;
+    const watchdog = setInterval(() => {
+        const now = performance.now();
+        // A check delayed enough to bridge the normal heartbeat margin makes elapsed time unreliable.
+        const watchdogCheckWasDelayed = now - lastWatchdogCheckAt >= HEARTBEAT_TIMEOUT_MS - HEARTBEAT_INTERVAL_MS;
+        lastWatchdogCheckAt = now;
+        if (watchdogCheckWasDelayed) {
+            lastHeartbeatAt = now;
+            return;
+        }
+        if (now - lastHeartbeatAt >= HEARTBEAT_TIMEOUT_MS)
+            stop("WORKER_UNRESPONSIVE", "Workflow worker missed its five-second heartbeat");
+    }, HEARTBEAT_INTERVAL_MS);
     const result = new Promise((resolve, reject) => {
         rejectResult = reject;
         child.on("message", (raw) => {
@@ -469,8 +483,7 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
                 if (!jsonValue(message))
                     fail("RPC_LIMIT_EXCEEDED", "Worker RPC must contain JSON-compatible values");
                 if (message.type === "heartbeat") {
-                    clearTimeout(watchdog);
-                    watchdog = setTimeout(() => { stop("WORKER_UNRESPONSIVE", "Workflow worker missed its five-second heartbeat"); }, HEARTBEAT_TIMEOUT_MS);
+                    lastHeartbeatAt = performance.now();
                     return;
                 }
                 if (message.type === "result") {
@@ -502,7 +515,7 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
                 child.kill("SIGKILL"); }, 1000).unref();
         }
     }
-    function finish() { settled = true; clearTimeout(watchdog); signal?.removeEventListener("abort", cancel); killChild(); rmSync(childDir, { recursive: true, force: true }); }
+    function finish() { settled = true; clearInterval(watchdog); signal?.removeEventListener("abort", cancel); killChild(); rmSync(childDir, { recursive: true, force: true }); }
     function stop(code, message) { if (settled)
         return; controller.abort(); finish(); rejectResult(new WorkflowError(code, message)); }
     function branded(result) { return { ...result, [WORK_RESULT_BRAND]: true }; }
@@ -612,8 +625,8 @@ export function runWorkflow(script, args = null, bridge = {}, signal) {
         signal?.addEventListener("abort", cancel, { once: true });
     return { result, cancel };
 }
-function nativeSessionReference(attempt) {
-    return { sessionId: attempt.sessionId, sessionFile: attempt.sessionFile };
+function attemptSummary(attempt, accounting = attempt.accounting) {
+    return { attempt: attempt.attempt, transport: attempt.transport, ...(attempt.session ? { session: attempt.session } : {}), ...(attempt.error ? { error: attempt.error } : {}), accounting, setup: attempt.setup };
 }
 export async function persistActiveAgentAttempt(store, id, active) {
     await store.updateState((run) => {
@@ -621,9 +634,11 @@ export async function persistActiveAgentAttempt(store, id, active) {
         if (!agent)
             throw new WorkflowError("INTERNAL_ERROR", `Missing production ownership record: ${id}`);
         const accounting = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
-        const details = [...(agent.attemptDetails ?? []).filter((candidate) => candidate.attempt !== active.attempt), { ...active, accounting }];
-        const nativeSessions = run.nativeSessions.some(({ sessionId }) => sessionId === active.sessionId) ? run.nativeSessions : [...run.nativeSessions, nativeSessionReference(active)];
-        return { ...run, agents: run.agents.map((candidate) => candidate.id === id ? { ...candidate, attempts: Math.max(candidate.attempts, active.attempt), attemptDetails: details } : candidate), nativeSessions };
+        const detail = attemptSummary(active, accounting);
+        const details = [...(agent.attemptDetails ?? []).filter((candidate) => candidate.attempt !== active.attempt), detail];
+        const session = active.session;
+        const agentSessions = session && !run.agentSessions.some(({ transport, sessionId }) => transport === session.transport && sessionId === session.sessionId) ? [...run.agentSessions, session] : run.agentSessions;
+        return { ...run, agents: run.agents.map((candidate) => candidate.id === id ? { ...candidate, attempts: Math.max(candidate.attempts, active.attempt), attemptDetails: details } : candidate), agentSessions };
     });
 }
 export async function persistAgentAttempts(store, id, attempts) {
@@ -632,8 +647,9 @@ export async function persistAgentAttempts(store, id, attempts) {
         if (!agent)
             throw new WorkflowError("INTERNAL_ERROR", `Missing production ownership record: ${id}`);
         const total = attempts.reduce((sum, attempt) => ({ input: sum.input + attempt.accounting.input, output: sum.output + attempt.accounting.output, cacheRead: sum.cacheRead + attempt.accounting.cacheRead, cacheWrite: sum.cacheWrite + attempt.accounting.cacheWrite, cost: sum.cost + attempt.accounting.cost }), { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 });
-        const attemptDetails = attempts.map(({ attempt, sessionId, sessionFile, error, accounting, setup }) => ({ attempt, sessionId, sessionFile, ...(error ? { error } : {}), accounting, ...(setup ? { setup } : {}) }));
-        const sessionIds = new Set(attempts.map(({ sessionId }) => sessionId));
-        return { ...run, agents: run.agents.map((candidate) => candidate.id === id ? { ...candidate, attempts: attempts.length, attemptDetails, accounting: total } : candidate), nativeSessions: [...run.nativeSessions.filter(({ sessionId }) => !sessionIds.has(sessionId)), ...attempts.map((attempt) => nativeSessionReference(attempt))] };
+        const attemptDetails = attempts.map((attempt) => attemptSummary(attempt));
+        const sessions = attempts.map((attempt) => attempt.session).filter((session) => session !== undefined);
+        const sessionKeys = new Set(sessions.map(({ transport, sessionId }) => `${transport}:${sessionId}`));
+        return { ...run, agents: run.agents.map((candidate) => candidate.id === id ? { ...candidate, attempts: attempts.length, attemptDetails, accounting: total } : candidate), agentSessions: [...run.agentSessions.filter(({ transport, sessionId }) => !sessionKeys.has(`${transport}:${sessionId}`)), ...sessions] };
     });
 }

package/dist/src/host.d.ts

@@ -1,8 +1,7 @@
 import { Type } from "@earendil-works/pi-ai";
 import { copyToClipboard, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { type SessionFactory } from "./agent-execution.js";
 import type { AwaitingCheckpoint, PersistedRun, WorktreeReference } from "./persistence.js";
-import { type AgentRecord, type LaunchSnapshot, type RunState, type WorkflowFailureDiagnostics } from "./types.js";
+import { type AgentRecord, type AgentTransport, type LaunchSnapshot, type RunState, type WorkflowFailureDiagnostics } from "./types.js";
 export interface WorkflowProgressStyles {
     accent(text: string): string;
     success(text: string): string;
@@ -34,12 +33,13 @@ export declare function formatWorkflowPreview(args: {
     description?: unknown;
 }): string;
 export declare const WORKFLOW_TOOL_LABEL = "Workflow";
-export declare const WORKFLOW_TOOL_DESCRIPTION = "Run a deterministic JavaScript workflow with a named inline parallel-to-summary path by default";
-export declare const WORKFLOW_TOOL_PROMPT_SNIPPET = "Run a deterministic, resumable JavaScript workflow. Prefer a named inline script that fans out independent work with parallel(...), awaits the keyed results before interpolating them into one summarizing agent(...), and returns. Inline launches require an explicit non-empty name; registered function launches reject name and use workflow as the run name. Advanced controls include registered functions, outputSchema, budgets, checkpoints, worktrees, retry/resume, CLI export, and pipelines. Use workflow_retry with an explicit failed run ID; parentRunId only reuses named worktrees. Runs are in the background by default; completion arrives as a follow-up message. Set foreground: true when the caller must wait for the final value. If a foreground call detaches before its result is accepted, its terminal success or failure is promoted to one follow-up message. Foreground results include the completed run ID. Recovery inherits the source launch mode; legacy snapshots without launchMode recover in the background. Set foreground: true or false on workflow_resume/workflow_retry to override it; foreground recovery waits for terminal value and run details, while background recovery returns immediately with a follow-up. Recovery map: agent(..., { retries }) reruns one agent call in the same run for transient failures; workflow_retry({ runId, foreground? }) replays a failed run into a child; workflow_resume({ runId, budget?, foreground? }) continues a budget_exhausted run; parentRunId on a new launch only borrows named worktrees and never replays or resumes.";
+export declare const WORKFLOW_TOOL_DESCRIPTION = "Run a deterministic JavaScript workflow with a named inline or file-backed parallel-to-summary path by default";
+export declare const WORKFLOW_TOOL_PROMPT_SNIPPET = "Run a deterministic, resumable JavaScript workflow. Prefer a named inline script that fans out independent work with parallel(...), awaits the keyed results before interpolating them into one summarizing agent(...), and returns. Inline and file-backed launches require a non-empty name; registered function launches may use name as an optional run label and otherwise use workflow as the run name. Advanced controls include registered functions, outputSchema, budgets, checkpoints, worktrees, retry/resume, CLI export, and pipelines. Use workflow_retry with an explicit failed run ID; parentRunId only reuses named worktrees. Runs are in the background by default; completion arrives as a follow-up message. Set foreground: true when the caller must wait for the final value. If a foreground call detaches before its result is accepted, its terminal success or failure is promoted to one follow-up message. Foreground results include the completed run ID. Recovery inherits the source launch mode; legacy snapshots without launchMode recover in the background. Set foreground: true or false on workflow_resume/workflow_retry to override it; foreground recovery waits for terminal value and run details, while background recovery returns immediately with a follow-up. Recovery map: agent(..., { retries }) reruns one agent call in the same run for transient failures; workflow_retry({ runId, foreground? }) replays a failed run into a child; workflow_resume({ runId, budget?, foreground? }) continues a budget_exhausted run; parentRunId on a new launch only borrows named worktrees and never replays or resumes.";
 export declare const WORKFLOW_TOOL_PARAMETERS: Type.TObject<{
     name: Type.TOptional<Type.TString>;
     description: Type.TOptional<Type.TString>;
     script: Type.TOptional<Type.TString>;
+    scriptPath: Type.TOptional<Type.TString>;
     workflow: Type.TOptional<Type.TString>;
     args: Type.TOptional<Type.TUnknown>;
     foreground: Type.TOptional<Type.TBoolean>;
@@ -140,5 +140,5 @@ export declare function formatNavigatorRun(loaded: {
 export declare function formatWorkflowPhaseDashboard(run: PersistedRun, snapshot: Readonly<LaunchSnapshot>, width: number, selection?: WorkflowPhaseSelection, styles?: WorkflowProgressStyles, now?: number): string[];
 export declare function formatWorkflowFailureDiagnostics(diagnostic: WorkflowFailureDiagnostics): string;
 export declare function formatWorkflowFailureDelivery(diagnostic: WorkflowFailureDiagnostics): string;
-export default function workflowExtension(pi: ExtensionAPI, home?: string, clipboard?: typeof copyToClipboard, createSession?: SessionFactory, agentDir?: string, additionalSkillPaths?: readonly string[]): void;
+export default function workflowExtension(pi: ExtensionAPI, home?: string, clipboard?: typeof copyToClipboard, transport?: AgentTransport, agentDir?: string, additionalSkillPaths?: readonly string[]): void;
 export {};