@osolmaz/pi-workflows 0.1.0 → 0.3.0

package/dist/extension/session-events.d.ts

@@ -0,0 +1,134 @@
+export type PublicAssistantMessageEvent = {
+    type: "start";
+    partial: unknown;
+} | {
+    type: "text_start";
+    contentIndex: number;
+    partial: unknown;
+} | {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+    partial: unknown;
+} | {
+    type: "text_end";
+    contentIndex: number;
+    content: string;
+    partial: unknown;
+} | {
+    type: "thinking_start";
+    contentIndex: number;
+    partial: unknown;
+} | {
+    type: "thinking_delta";
+    contentIndex: number;
+    delta: string;
+    partial: unknown;
+} | {
+    type: "thinking_end";
+    contentIndex: number;
+    content: string;
+    partial: unknown;
+} | {
+    type: "toolcall_start";
+    contentIndex: number;
+    partial: unknown;
+} | {
+    type: "toolcall_delta";
+    contentIndex: number;
+    delta: string;
+    partial: unknown;
+} | {
+    type: "toolcall_end";
+    contentIndex: number;
+    toolCall: unknown;
+    partial: unknown;
+} | {
+    type: "done";
+    reason: "stop" | "length" | "toolUse";
+    message: unknown;
+} | {
+    type: "error";
+    reason: "aborted" | "error";
+    error: unknown;
+};
+export type TurnStartEventLike = {
+    turnIndex: number;
+};
+export type TurnEndEventLike = {
+    turnIndex: number;
+    message: unknown;
+};
+export type MessageStartEventLike = {
+    message: unknown;
+};
+export type MessageUpdateEventLike = {
+    message: unknown;
+    assistantMessageEvent: PublicAssistantMessageEvent;
+};
+export type MessageEndEventLike = {
+    message: unknown;
+};
+export type ToolExecutionStartEventLike = {
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+};
+export type ToolExecutionUpdateEventLike = {
+    toolCallId: string;
+};
+export type ToolExecutionEndEventLike = {
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    isError: boolean;
+};
+export type NormalizedAssistantEvent = {
+    type: "start";
+} | {
+    type: "text_start";
+    contentIndex: number;
+} | {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "text_end";
+    contentIndex: number;
+    content: string;
+} | {
+    type: "thinking_start";
+    contentIndex: number;
+} | {
+    type: "thinking_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "thinking_end";
+    contentIndex: number;
+    content: string;
+} | {
+    type: "toolcall_start";
+    contentIndex: number;
+} | {
+    type: "toolcall_delta";
+    contentIndex: number;
+    delta: string;
+} | {
+    type: "toolcall_end";
+    contentIndex: number;
+    toolCall: unknown;
+} | {
+    type: "done";
+    reason: "stop" | "length" | "toolUse";
+} | {
+    type: "error";
+    reason: "aborted" | "error";
+};
+/** Remove cumulative snapshots while preserving every semantic stream event. */
+export declare function normalizeAssistantEvent(event: PublicAssistantMessageEvent): NormalizedAssistantEvent;
+export declare function messageRole(message: unknown): string;
+export declare function toolCallIdFromAssistantEvent(event: NormalizedAssistantEvent): string | null;
+export declare function toolStartedPayload(event: ToolExecutionStartEventLike): Record<string, unknown>;
+export declare function toolFinishedPayload(event: ToolExecutionEndEventLike): Record<string, unknown>;
+export declare function turnFinishedPayload(event: TurnEndEventLike, messageId: string | undefined, toolCallIds: string[]): Record<string, unknown>;

package/dist/extension/session-events.js

@@ -0,0 +1,60 @@
+/** Remove cumulative snapshots while preserving every semantic stream event. */
+export function normalizeAssistantEvent(event) {
+    switch (event.type) {
+        case "start":
+            return { type: event.type };
+        case "text_start":
+        case "thinking_start":
+        case "toolcall_start":
+            return { type: event.type, contentIndex: event.contentIndex };
+        case "text_delta":
+        case "thinking_delta":
+        case "toolcall_delta":
+            return { type: event.type, contentIndex: event.contentIndex, delta: event.delta };
+        case "text_end":
+        case "thinking_end":
+            return { type: event.type, contentIndex: event.contentIndex, content: event.content };
+        case "toolcall_end":
+            return {
+                type: event.type,
+                contentIndex: event.contentIndex,
+                toolCall: event.toolCall,
+            };
+        case "done":
+            return { type: event.type, reason: event.reason };
+        case "error":
+            return { type: event.type, reason: event.reason };
+        default: {
+            const exhaustive = event;
+            return exhaustive;
+        }
+    }
+}
+export function messageRole(message) {
+    if (typeof message !== "object" || message === null || !("role" in message)) {
+        return "unknown";
+    }
+    const role = message.role;
+    return typeof role === "string" && role.length > 0 ? role : "unknown";
+}
+export function toolCallIdFromAssistantEvent(event) {
+    if (event.type !== "toolcall_end" || typeof event.toolCall !== "object" || !event.toolCall) {
+        return null;
+    }
+    const id = event.toolCall.id;
+    return typeof id === "string" && id.length > 0 ? id : null;
+}
+export function toolStartedPayload(event) {
+    return { toolName: event.toolName, args: event.args };
+}
+export function toolFinishedPayload(event) {
+    return { toolName: event.toolName, isError: event.isError, result: event.result };
+}
+export function turnFinishedPayload(event, messageId, toolCallIds) {
+    return {
+        turnIndex: event.turnIndex,
+        ...(messageId === undefined ? {} : { messageId }),
+        toolCallIds,
+    };
+}
+//# sourceMappingURL=session-events.js.map

package/dist/extension/session-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-events.js","sourceRoot":"","sources":["../../src/extension/session-events.ts"],"names":[],"mappings":"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"}

package/dist/extension/widget.js

@@ -81,16 +81,23 @@ export function buildWidgetLines(state, snapshot, now = new Date()) {
 /** The graph row the window should center on: the active or waiting node. */
 function focusLine(graph, state) {
     const active = graph.findIndex((line) => stripAnsi(line).includes("◐"));
-    if (active !== -1) {
-        return active;
+    const focus = active !== -1
+        ? active
+        : state.waitingOn
+            ? graph.findIndex((line) => stripAnsi(line).includes(state.waitingOn))
+            : -1;
+    if (focus === -1) {
+        return graph.length - 1;
     }
-    if (state.waitingOn) {
-        const waiting = graph.findIndex((line) => stripAnsi(line).includes(state.waitingOn));
-        if (waiting !== -1) {
-            return waiting;
-        }
+    let top = focus;
+    while (top > 0 && !/[┌┏]/u.test(stripAnsi(graph[top] ?? ""))) {
+        top -= 1;
     }
-    return graph.length - 1;
+    let bottom = focus;
+    while (bottom + 1 < graph.length && !/[└┗]/u.test(stripAnsi(graph[bottom] ?? ""))) {
+        bottom += 1;
+    }
+    return Math.floor((top + bottom) / 2);
 }
 /**
  * Slice `lines` to at most `budget` rows, marking hidden rows at either end.
@@ -101,24 +108,18 @@ function windowLines(lines, budget, anchor, anchorIsStart) {
     if (lines.length <= budget) {
         return { lines, scroll: 0, maxScroll: 0 };
     }
-    // First pass decides which markers exist; the second re-fits within the
-    // remaining space. A marker flag can only turn on (never off) in the
-    // second pass, so the result stays within budget.
-    let inner = budget;
-    for (let pass = 0; pass < 2; pass += 1) {
-        const start = clampStart(anchor, inner, lines.length, anchorIsStart);
-        inner = budget - (start > 0 ? 1 : 0) - (start + inner < lines.length ? 1 : 0);
-    }
+    // Reserve one combined overflow row, leaving seven rows for a complete
+    // full card even when the widget also has an error footer.
+    const inner = Math.max(1, budget - 1);
     const start = clampStart(anchor, inner, lines.length, anchorIsStart);
     const end = start + inner;
-    const out = [];
-    if (start > 0) {
-        out.push(ansi.dim(`↑ ${start} more`));
-    }
-    out.push(...lines.slice(start, end));
-    if (end < lines.length) {
-        out.push(ansi.dim(`↓ ${lines.length - end} more · shift+↑/↓ scroll`));
-    }
+    const above = start;
+    const below = Math.max(0, lines.length - end);
+    const out = lines.slice(start, end);
+    const directions = [above > 0 ? `↑ ${above}` : "", below > 0 ? `↓ ${below}` : ""]
+        .filter(Boolean)
+        .join(" · ");
+    out.push(ansi.dim(`${directions} more · shift+↑/↓ scroll`));
     return { lines: out, scroll: start, maxScroll: Math.max(0, lines.length - inner) };
 }
 function clampStart(anchor, inner, total, anchorIsStart) {

package/dist/extension/widget.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../src/extension/widget.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../../src/extension/widget.ts"],"names":[],"mappings":"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"}

package/dist/extension/workflow-tool.d.ts

@@ -0,0 +1,28 @@
+import { type TSchema } from "typebox";
+export declare const WorkflowToolParameters: TSchema;
+export type WorkflowToolInput = {
+    action: "list";
+    offset?: number;
+} | {
+    action: "start";
+    workflow: string;
+    input?: unknown;
+} | {
+    action: "status";
+    runId?: string;
+} | {
+    action: "pause";
+} | {
+    action: "resume";
+} | {
+    action: "cancel";
+} | {
+    action: "answer";
+    input: unknown;
+    runId?: string;
+} | {
+    action: "submit";
+    step: string;
+    attempt: string;
+    output: unknown;
+};

package/dist/extension/workflow-tool.js

@@ -0,0 +1,33 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+const noExtraProperties = { additionalProperties: false };
+export const WorkflowToolParameters = Type.Union([
+    Type.Object({
+        action: StringEnum(["list"]),
+        offset: Type.Optional(Type.Integer({ minimum: 0, description: "Workflow list offset" })),
+    }, noExtraProperties),
+    Type.Object({
+        action: StringEnum(["start"]),
+        workflow: Type.String({ description: "Discovered workflow name or workflow file path" }),
+        input: Type.Optional(Type.Unknown({ description: "Structured workflow input" })),
+    }, noExtraProperties),
+    Type.Object({
+        action: StringEnum(["status"]),
+        runId: Type.Optional(Type.String({ description: "Run id; omit for the active run" })),
+    }, noExtraProperties),
+    Type.Object({ action: StringEnum(["pause"]) }, noExtraProperties),
+    Type.Object({ action: StringEnum(["resume"]) }, noExtraProperties),
+    Type.Object({ action: StringEnum(["cancel"]) }, noExtraProperties),
+    Type.Object({
+        action: StringEnum(["answer"]),
+        input: Type.Unknown({ description: "Checkpoint answer" }),
+        runId: Type.Optional(Type.String({ description: "Waiting run id" })),
+    }, noExtraProperties),
+    Type.Object({
+        action: StringEnum(["submit"]),
+        step: Type.String({ description: "Step id from the workflow step contract" }),
+        attempt: Type.String({ description: "Attempt id from the workflow step contract" }),
+        output: Type.Unknown({ description: "Step output matching the expected shape" }),
+    }, noExtraProperties),
+]);
+//# sourceMappingURL=workflow-tool.js.map

package/dist/extension/workflow-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-tool.js","sourceRoot":"","sources":["../../src/extension/workflow-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAgB,MAAM,SAAS,CAAC;AAE7C,MAAM,iBAAiB,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAW,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GAAY,IAAI,CAAC,KAAK,CAAC;IACxD,IAAI,CAAC,MAAM,CACT;QACE,MAAM,EAAE,UAAU,CAAC,CAAC,MAAM,CAAU,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC,CAAC;KACzF,EACD,iBAAiB,CAClB;IACD,IAAI,CAAC,MAAM,CACT;QACE,MAAM,EAAE,UAAU,CAAC,CAAC,OAAO,CAAU,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;QACxF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;KACjF,EACD,iBAAiB,CAClB;IACD,IAAI,CAAC,MAAM,CACT;QACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;QACvC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAAC;KACtF,EACD,iBAAiB,CAClB;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,OAAO,CAAU,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC3E,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC3E,IAAI,CAAC,MAAM,CACT;QACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;QACvC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;QACzD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;KACrE,EACD,iBAAiB,CAClB;IACD,IAAI,CAAC,MAAM,CACT;QACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;QACvC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;QAC7E,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;QACnF,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;KACjF,EACD,iBAAiB,CAClB;CACF,CAAC,CAAC"}

package/dist/host/processes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tracks headless child processes (spawned `pi --mode rpc` sessions) so a
+ * killed host never leaves orphans working. Children spawn in their own
+ * process group; the registry file lets a later host reap leftovers by
+ * killing the whole group. The file lives next to the project store and is
+ * only ever touched by one host at a time (the advisory lock ensures it).
+ */
+export declare class HostProcessRegistry {
+    private readonly filePath;
+    private readonly pids;
+    constructor(storeDir: string);
+    register(pid: number): void;
+    unregister(pid: number): void;
+    get size(): number;
+    /** Kill every registered child's process group, escalating to SIGKILL. */
+    killAll(): void;
+    /**
+     * Reap children recorded by a previous host that died without cleanup.
+     * Called once at host start, before the lock is taken.
+     */
+    reapOrphans(): number[];
+    private readFile;
+    private persist;
+}

package/dist/host/processes.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Tracks headless child processes (spawned `pi --mode rpc` sessions) so a
+ * killed host never leaves orphans working. Children spawn in their own
+ * process group; the registry file lets a later host reap leftovers by
+ * killing the whole group. The file lives next to the project store and is
+ * only ever touched by one host at a time (the advisory lock ensures it).
+ */
+export class HostProcessRegistry {
+    filePath;
+    pids = new Set();
+    constructor(storeDir) {
+        this.filePath = path.join(storeDir, "host.children.json");
+    }
+    register(pid) {
+        this.pids.add(pid);
+        this.persist();
+    }
+    unregister(pid) {
+        this.pids.delete(pid);
+        this.persist();
+    }
+    get size() {
+        return this.pids.size;
+    }
+    /** Kill every registered child's process group, escalating to SIGKILL. */
+    killAll() {
+        for (const pid of this.pids) {
+            killProcessGroup(pid, "SIGTERM");
+        }
+        for (const pid of this.pids) {
+            killProcessGroup(pid, "SIGKILL");
+        }
+        this.pids.clear();
+        this.persist();
+    }
+    /**
+     * Reap children recorded by a previous host that died without cleanup.
+     * Called once at host start, before the lock is taken.
+     */
+    reapOrphans() {
+        const recorded = this.readFile();
+        const reaped = [];
+        const stillAlive = [];
+        for (const pid of recorded) {
+            if (isAlive(pid)) {
+                killProcessGroup(pid, "SIGKILL");
+                reaped.push(pid);
+                if (isAlive(pid)) {
+                    // A group kill that left the leader alive stays registered so a
+                    // later start tries again instead of forgetting it.
+                    stillAlive.push(pid);
+                }
+            }
+        }
+        this.pids.clear();
+        for (const pid of stillAlive) {
+            this.pids.add(pid);
+        }
+        this.persist();
+        return reaped;
+    }
+    readFile() {
+        try {
+            const parsed = JSON.parse(fs.readFileSync(this.filePath, "utf8"));
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+            return parsed.filter((pid) => Number.isSafeInteger(pid) && pid > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    persist() {
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true, mode: 0o700 });
+            // Write exactly the live set. Unioning with the previous file would
+            // resurrect exited pids, and a later host reaping them could kill an
+            // unrelated process group that reused one.
+            fs.writeFileSync(this.filePath, `${JSON.stringify([...this.pids])}\n`, {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+        }
+        catch {
+            // Registry bookkeeping is best-effort; orphan reaping is the backstop.
+        }
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function killProcessGroup(pid, signal) {
+    try {
+        process.kill(-pid, signal);
+    }
+    catch {
+        try {
+            process.kill(pid, signal);
+        }
+        catch {
+            // Already gone.
+        }
+    }
+}
+//# sourceMappingURL=processes.js.map

package/dist/host/processes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/host/processes.ts"],"names":[],"mappings":"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"}

package/dist/host/rpc-bridge.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare const RPC_SUBMISSION_PREFIX = "PI_WORKFLOWS_STEP_SUBMISSION ";
+/**
+ * Loaded into headless `pi --mode rpc` children spawned by the standalone
+ * host. The child has no workflow engine, so this bridge only registers the
+ * `workflow` tool and reports every submission to the host over stderr; the
+ * host validates against the engine and re-prompts on rejection.
+ */
+export default function piWorkflowsRpcBridge(pi: ExtensionAPI): void;

package/dist/host/rpc-bridge.js

@@ -0,0 +1,39 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+export const RPC_SUBMISSION_PREFIX = "PI_WORKFLOWS_STEP_SUBMISSION ";
+/**
+ * Loaded into headless `pi --mode rpc` children spawned by the standalone
+ * host. The child has no workflow engine, so this bridge only registers the
+ * `workflow` tool and reports every submission to the host over stderr; the
+ * host validates against the engine and re-prompts on rejection.
+ */
+export default function piWorkflowsRpcBridge(pi) {
+    pi.registerTool({
+        name: "workflow",
+        label: "Workflow",
+        description: [
+            "Submit the output for the pending workflow step with action submit.",
+            "Only call this tool when a workflow step contract in the conversation asks you to.",
+            "Pass the exact step id from the contract and your result as the output.",
+        ].join(" "),
+        parameters: Type.Object({
+            action: StringEnum(["submit"]),
+            step: Type.String({ description: "Step id from the workflow step contract" }),
+            attempt: Type.String({ description: "Attempt id from the workflow step contract" }),
+            output: Type.Unknown({ description: "Step output matching the expected shape" }),
+        }, { additionalProperties: false }),
+        async execute(_toolCallId, params) {
+            process.stderr.write(`${RPC_SUBMISSION_PREFIX}${JSON.stringify(params)}\n`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Submission recorded. Continue only when the workflow sends the next step.",
+                    },
+                ],
+                details: {},
+            };
+        },
+    });
+}
+//# sourceMappingURL=rpc-bridge.js.map

package/dist/host/rpc-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-bridge.js","sourceRoot":"","sources":["../../src/host/rpc-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAgB;IAC3D,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE;YACX,qEAAqE;YACrE,oFAAoF;YACpF,yEAAyE;SAC1E,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE,IAAI,CAAC,MAAM,CACrB;YACE,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAU,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;YAC7E,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;YACnF,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;SACjF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC;QACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,qBAAqB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2EAA2E;qBAClF;iBACF;gBACD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/host/rpc-executor.d.ts

@@ -0,0 +1,38 @@
+import type { AgentStepExecutor, AgentStepRequest, AgentStepSubmission } from "../workflows/types.js";
+import type { HostProcessRegistry } from "./processes.js";
+export type RpcStepExecutorOptions = {
+    cwd: string;
+    registry: HostProcessRegistry;
+    /** Absolute path to the pi binary; defaults to the installed `pi`. */
+    piBin?: string;
+    /** Extra environment for the child; the host's environment is inherited. */
+    env?: Record<string, string>;
+    /** Extra pi arguments, for example a model override. */
+    piArgs?: string[];
+};
+/**
+ * Runs agent steps in a headless `pi --mode rpc` child. One child serves one
+ * workflow run. The rpc-bridge extension inside the child registers the
+ * `workflow` tool and reports submissions over stderr; this executor
+ * validates them through `request.accept` and re-prompts on rejection, so
+ * the model sees the same tool contract as an in-session run.
+ */
+export declare class RpcStepExecutor implements AgentStepExecutor {
+    private readonly options;
+    private child;
+    private childExited;
+    private stderrBuffer;
+    private submissions;
+    private submissionWaiters;
+    private stdoutBuffer;
+    constructor(options: RpcStepExecutorOptions);
+    runAgentStep(request: AgentStepRequest, signal: AbortSignal): Promise<AgentStepSubmission>;
+    /** Stop the child's whole process group, then unregister it. */
+    close(): Promise<void>;
+    private currentExit;
+    private ensureStarted;
+    private promptForSubmission;
+    private takeMatchingSubmission;
+    private sendAbortQuietly;
+    private wakeSubmissionWaiters;
+}