@botiverse/oar 0.0.1

package/dist/runtimes/pi/projection.js

@@ -0,0 +1,112 @@
+import { classifyFailure } from "../../shared/failure-class.js";
+export const initialPiProjection = {
+    inTurn: false,
+    adopted: false,
+    abortRequested: false,
+    reasoningHadText: false,
+    providerError: undefined,
+};
+/** Control plane → state: a prompt opens a non-adopted turn, resetting per-turn accumulators. */
+export function piPrompted() {
+    return { ...initialPiProjection, inTurn: true };
+}
+export function piAbortRequested(state) {
+    return { ...state, abortRequested: true };
+}
+/** The outcome for a prompt-initiated turn (the fold settles adopted turns itself). */
+export function piSettledOutcome(state) {
+    if (state.abortRequested) {
+        return { kind: "aborted" };
+    }
+    if (state.providerError !== undefined) {
+        return { kind: "failed", reason: state.providerError, failure: classifyFailure(state.providerError) };
+    }
+    return { kind: "completed" };
+}
+const drop = (state) => ({ state, commands: [] });
+const emit = (state, body) => ({ state, commands: [{ kind: "emit", body }] });
+function foldMessageUpdate(state, inner) {
+    switch (inner.type) {
+        case "text_delta":
+            return emit(state, { kind: "text_delta", text: inner.delta });
+        case "thinking_delta":
+            return inner.delta.length > 0
+                ? emit({ ...state, reasoningHadText: true }, { kind: "reasoning", content: { kind: "text", text: inner.delta } })
+                : drop(state);
+        case "error":
+            // pi's prompt() RESOLVES even when the provider errored — the failure
+            // only surfaces here (pinned by the pi vendor 400 test).
+            return drop({ ...state, providerError: inner.error.errorMessage ?? inner.reason });
+        case "thinking_start":
+            return drop({ ...state, reasoningHadText: false });
+        case "thinking_end":
+            return state.reasoningHadText ? drop(state) : emit(state, { kind: "reasoning", content: { kind: "empty" } });
+        // Explicitly dropped: block boundaries and toolcall framing carry no v1
+        // turn event (toolcalls arrive via the outer tool_execution_* events).
+        case "start":
+        case "done":
+        case "text_start":
+        case "text_end":
+        case "toolcall_start":
+        case "toolcall_delta":
+        case "toolcall_end":
+            return drop(state);
+    }
+    return drop(state);
+}
+/** Fold one pi SDK event into the next state plus commands. */
+export function foldPiEvent(state, event) {
+    if (event.type === "agent_start") {
+        // A run pi starts that we did not prompt (a drained followUp) becomes an
+        // adopted turn, settled here on agent_end.
+        return state.inTurn
+            ? drop(state)
+            : { state: { ...piPrompted(), adopted: true }, commands: [{ kind: "begin" }] };
+    }
+    if (!state.inTurn) {
+        return drop(state);
+    }
+    switch (event.type) {
+        case "agent_end":
+            // Adopted turns settle here; prompt-initiated turns are settled by the
+            // adapter's prompt promise (which reads piSettledOutcome).
+            return state.adopted
+                ? { state: initialPiProjection, commands: [{ kind: "settle", outcome: piSettledOutcome(state) }] }
+                : { state: { ...state, inTurn: false }, commands: [] };
+        case "message_update":
+            return foldMessageUpdate(state, event.assistantMessageEvent);
+        case "tool_execution_start":
+            return emit(state, { kind: "tool_call_started", callId: event.toolCallId, tool: event.toolName });
+        case "tool_execution_end":
+            return emit(state, { kind: "tool_call_ended", callId: event.toolCallId });
+        case "turn_end":
+            // A provider failure surfaces only as stopReason "error" on the turn's
+            // final assistant message (pinned by the pi vendor 400 test).
+            return event.message.role === "assistant" && event.message.stopReason === "error"
+                ? drop({ ...state, providerError: event.message.errorMessage ?? "provider error" })
+                : drop(state);
+        // Explicitly dropped: session-scoped events with no turn mapping in v1 (an
+        // exhaustive switch makes a NEW pi event type a compile error, forcing a
+        // conscious mapped-or-dropped decision on each future addition).
+        case "agent_settled":
+        case "turn_start":
+        case "message_start":
+        case "message_end":
+        case "tool_execution_update":
+        case "bash_execution_update":
+        case "compaction_start":
+        case "compaction_end":
+        case "queue_update":
+        case "entry_appended":
+        case "session_info_changed":
+        case "thinking_level_changed":
+        case "auto_retry_start":
+        case "auto_retry_end":
+        case "summarization_retry_scheduled":
+        case "summarization_retry_attempt_start":
+        case "summarization_retry_finished":
+            return drop(state);
+    }
+    return drop(state);
+}
+//# sourceMappingURL=projection.js.map

package/dist/runtimes/pi/projection.js.map

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

package/dist/runtimes/pi/session.d.ts

@@ -0,0 +1,11 @@
+import type { CreateAgentSessionOptions } from "@earendil-works/pi-coding-agent";
+import type { StartSession } from "../../contracts/session.js";
+/**
+ * The bash tool that carries SessionOptions.env into the agent's spawned
+ * processes: same builtin bash, plus a spawnHook overlaying the env. pi's
+ * defineTool keeps the definition assignable to customTools, where it
+ * replaces the builtin by name. Exported for direct unit verification.
+ */
+export declare function piEnvBashTool(cwd: string, overlay: Readonly<Record<string, string>>): Promise<NonNullable<CreateAgentSessionOptions["customTools"]>[number]>;
+export declare const piSession: StartSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/runtimes/pi/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/runtimes/pi/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAW,YAAY,EAAQ,MAAM,4BAA4B,CAAC;AAqB9E;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAKxE;AAED,eAAO,MAAM,SAAS,EAAE,YAkLvB,CAAC"}

package/dist/runtimes/pi/session.js

@@ -0,0 +1,201 @@
+import { classifyFailure } from "../../shared/failure-class.js";
+import { sealSession } from "../../shared/seal-session.js";
+import { createSessionKernel } from "../../shared/session-kernel.js";
+import { foldPiEvent, initialPiProjection, piAbortRequested, piPrompted, piSettledOutcome, } from "./projection.js";
+/*
+ * Bundled pi SDK mapping (in-process, no fork — settled 2026-08-21):
+ * prompt resolves on settlement; steer acceptance means entry into pi's
+ * queue; abort is cooperative. Turn deltas/tools map, session events drop.
+ * Model selection needs ModelRuntime rather than options.model. Process-global
+ * lazy env reads mean another embedded pi cannot safely share this process.
+ */
+/**
+ * The bash tool that carries SessionOptions.env into the agent's spawned
+ * processes: same builtin bash, plus a spawnHook overlaying the env. pi's
+ * defineTool keeps the definition assignable to customTools, where it
+ * replaces the builtin by name. Exported for direct unit verification.
+ */
+export async function piEnvBashTool(cwd, overlay) {
+    const sdk = await import("@earendil-works/pi-coding-agent");
+    return sdk.defineTool(sdk.createBashToolDefinition(cwd, {
+        spawnHook: (context) => ({ ...context, env: { ...context.env, ...overlay } }),
+    }));
+}
+export const piSession = async (installation, options) => {
+    if (installation.via !== "bundled") {
+        throw new Error("The pi session adapter needs the bundled sdk installation");
+    }
+    if (options.resume !== undefined) {
+        // pi resumes by session FILE (SessionManager.open(path)), not by bare id;
+        // wiring the id→file lookup waits for a consumer with configured pi.
+        throw new Error("pi session resume is not implemented yet");
+    }
+    const sdk = await import("@earendil-works/pi-coding-agent");
+    // Per-session env on an in-process runtime: the runtime itself has no own
+    // process, but the processes the AGENT spawns do — a bash tool built with a
+    // spawnHook overlaying the env replaces the builtin by name (custom tools
+    // win the SDK's tool registry). Provider config (keys, base URLs) does NOT
+    // travel this way for pi; that needs its native modelRuntime/agentDir
+    // channel. Tool-level spawn verified in SDK source, not yet live (no
+    // configured pi on this machine).
+    const overlay = options.env;
+    // OAR_PI_AGENT_DIR pins pi's global config home (models.json/auth.json/
+    // settings) — same namespaced-env-pin pattern as OAR_CLAUDE_BIN. This is
+    // how a host (or the pi-aimock behavior backend) points the in-process
+    // model plane somewhere else.
+    const agentDir = process.env.OAR_PI_AGENT_DIR;
+    // YOLO by default (repo policy): pi gates tool execution on project trust,
+    // which is an approval prompt no embedded host can answer — pre-trust the
+    // session cwd the same way pi's own Trust button would (auditable in
+    // <agentDir>/trust.json).
+    new sdk.ProjectTrustStore(agentDir ?? sdk.getAgentDir()).set(options.cwd, true);
+    // System prompt seams: pi's DefaultResourceLoader natively supports both
+    // replace (systemPrompt) and append (appendSystemPrompt).
+    const wantsSystemPrompt = options.systemPrompt !== undefined || options.appendSystemPrompt !== undefined;
+    const resourceLoader = wantsSystemPrompt
+        ? new sdk.DefaultResourceLoader({
+            cwd: options.cwd,
+            agentDir: agentDir ?? sdk.getAgentDir(),
+            ...(options.systemPrompt === undefined ? {} : { systemPrompt: options.systemPrompt }),
+            ...(options.appendSystemPrompt === undefined ? {} : { appendSystemPrompt: [options.appendSystemPrompt] }),
+        })
+        : undefined;
+    // A CALLER-provided loader is the caller's to load — createAgentSession
+    // only reloads the one it builds itself.
+    await resourceLoader?.reload();
+    const { session: piAgentSession } = await sdk.createAgentSession({
+        cwd: options.cwd,
+        ...(agentDir === undefined ? {} : { agentDir }),
+        ...(resourceLoader === undefined ? {} : { resourceLoader }),
+        ...(overlay === undefined ? {} : { customTools: [await piEnvBashTool(options.cwd, overlay)] }),
+    });
+    const kernel = createSessionKernel(piAgentSession.sessionId);
+    let currentTurn = null;
+    let projection = initialPiProjection;
+    let disposed = false;
+    // Adapter-held queue, drained one input per turn end. pi's native followUp
+    // CONTINUES the active run (more internal turns, one agent_end), which
+    // would land the queued input inside the same OAR turn — the queue contract
+    // promises a later turn of its own, so the adapter owns the handoff.
+    const held = [];
+    const drainHeld = () => {
+        if (disposed || kernel.active() !== null) {
+            return;
+        }
+        const next = held.shift();
+        if (next === undefined) {
+            return;
+        }
+        // The run this starts is adopted as a spontaneous turn by agent_start.
+        void (async () => {
+            try {
+                await piAgentSession.prompt(next);
+            }
+            catch (error) {
+                // Never drop a taken-over delivery silently: surface the loss as a
+                // failed turn if one can still be attributed.
+                const reason = error instanceof Error ? error.message : "queued prompt failed";
+                kernel.begin()?.settle({ kind: "failed", reason, failure: classifyFailure(reason) });
+            }
+        })();
+    };
+    // Drive the pure projection fold, applying its commands to the kernel; the
+    // fold owns turn framing and event translation. Adopted turns settle in the
+    // fold (agent_end); prompt-initiated turns settle in prompt() below.
+    piAgentSession.subscribe((event) => {
+        const { state: nextProjection, commands } = foldPiEvent(projection, event);
+        projection = nextProjection;
+        for (const command of commands) {
+            switch (command.kind) {
+                case "begin":
+                    currentTurn = kernel.begin();
+                    break;
+                case "emit":
+                    currentTurn?.emit(command.body);
+                    break;
+                case "settle":
+                    currentTurn?.settle(command.outcome);
+                    currentTurn = null;
+                    drainHeld();
+                    break;
+                default:
+                    break;
+            }
+        }
+    });
+    const makeTurn = (turn) => ({
+        id: turn.id,
+        outcome: turn.outcome,
+        abort: async () => {
+            if (turn.settled()) {
+                return;
+            }
+            projection = piAbortRequested(projection);
+            await piAgentSession.abort();
+            await turn.outcome;
+        },
+        steer: async (input) => {
+            if (turn.settled()) {
+                return { kind: "not_steerable", reason: "turn already ended" };
+            }
+            await piAgentSession.steer(input);
+            return { kind: "accepted" };
+        },
+    });
+    const session = sealSession({
+        id: kernel.sessionId,
+        prompt(input) {
+            const turn = kernel.begin();
+            if (turn === null) {
+                return { kind: "busy" };
+            }
+            currentTurn = turn;
+            projection = piPrompted();
+            void (async () => {
+                try {
+                    await piAgentSession.prompt(input);
+                    turn.settle(piSettledOutcome(projection));
+                }
+                catch (error) {
+                    const reason = error instanceof Error ? error.message : "pi prompt failed";
+                    turn.settle({ kind: "failed", reason, failure: classifyFailure(reason) });
+                }
+                projection = initialPiProjection;
+                currentTurn = null;
+                drainHeld();
+            })();
+            return { kind: "turn", turn: makeTurn(turn) };
+        },
+        subscribe: (observer) => kernel.subscribe(observer),
+        contextUsage: () => {
+            // pi is authoritative: getContextUsage() returns tokens (null right
+            // after compaction, before the next response), contextWindow, percent.
+            const usage = piAgentSession.getContextUsage();
+            return usage === undefined
+                ? null
+                : { tokens: usage.tokens, contextWindow: usage.contextWindow, percent: usage.percent };
+        },
+        queue: {
+            durable: false,
+            add: async (input) => {
+                await Promise.resolve();
+                held.push(input);
+                drainHeld();
+            },
+        },
+        dispose: async () => {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            const active = kernel.active();
+            if (active !== null) {
+                await piAgentSession.abort();
+                active.settle({ kind: "aborted" });
+            }
+            piAgentSession.dispose();
+        },
+    });
+    return session;
+};
+//# sourceMappingURL=session.js.map

package/dist/runtimes/pi/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/runtimes/pi/session.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAmB,MAAM,gCAAgC,CAAC;AACtF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,OAAyC;IAEzC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,wBAAwB,CAAC,GAAG,EAAE;QACtD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;KAC9E,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAiB,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE;IACrE,IAAI,YAAY,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAC5D,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,qEAAqE;IACrE,kCAAkC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAC5B,wEAAwE;IACxE,yEAAyE;IACzE,uEAAuE;IACvE,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9C,2EAA2E;IAC3E,0EAA0E;IAC1E,qEAAqE;IACrE,0BAA0B;IAC1B,IAAI,GAAG,CAAC,iBAAiB,CAAC,QAAQ,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChF,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,CAAC;IACzG,MAAM,cAAc,GAAG,iBAAiB;QACtC,CAAC,CAAC,IAAI,GAAG,CAAC,qBAAqB,CAAC;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,QAAQ,IAAI,GAAG,CAAC,WAAW,EAAE;YACvC,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YACrF,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;SAC1G,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IACd,wEAAwE;IACxE,yCAAyC;IACzC,MAAM,cAAc,EAAE,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC;QAC/D,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,WAAW,GAAsB,IAAI,CAAC;IAC1C,IAAI,UAAU,GAAsB,mBAAmB,CAAC;IACxD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,2EAA2E;IAC3E,uEAAuE;IACvE,4EAA4E;IAC5E,qEAAqE;IACrE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,uEAAuE;QACvE,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,mEAAmE;gBACnE,8CAA8C;gBAC9C,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;gBAC/E,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC;IAEF,2EAA2E;IAC3E,4EAA4E;IAC5E,qEAAqE;IACrE,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC3E,UAAU,GAAG,cAAc,CAAC;QAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,OAAO;oBACV,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7B,MAAM;gBACR,KAAK,MAAM;oBACT,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChC,MAAM;gBACR,KAAK,QAAQ;oBACX,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACrC,WAAW,GAAG,IAAI,CAAC;oBACnB,SAAS,EAAE,CAAC;oBACZ,MAAM;gBACR;oBACE,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,CAAC,IAAgB,EAAQ,EAAE,CAAC,CAAC;QAC5C,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACrB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnB,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;YACjE,CAAC;YACD,MAAM,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAY,WAAW,CAAC;QACnC,EAAE,EAAE,MAAM,CAAC,SAAS;QACpB,MAAM,CAAC,KAAK;YACV,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1B,CAAC;YACD,WAAW,GAAG,IAAI,CAAC;YACnB,UAAU,GAAG,UAAU,EAAE,CAAC;YAC1B,KAAK,CAAC,KAAK,IAAmB,EAAE;gBAC9B,IAAI,CAAC;oBACH,MAAM,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACnC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC5C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC;oBAC3E,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5E,CAAC;gBACD,UAAU,GAAG,mBAAmB,CAAC;gBACjC,WAAW,GAAG,IAAI,CAAC;gBACnB,SAAS,EAAE,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,CAAC;QACD,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;QACnD,YAAY,EAAE,GAAG,EAAE;YACjB,oEAAoE;YACpE,uEAAuE;YACvE,MAAM,KAAK,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YAC/C,OAAO,KAAK,KAAK,SAAS;gBACxB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3F,CAAC;QACD,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACnB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjB,SAAS,EAAE,CAAC;YACd,CAAC;SACF;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/runtimes/pi/tool-detail.d.ts

@@ -0,0 +1,4 @@
+import type { SessionEventBody } from "../../contracts/session.js";
+export declare function piToolStarted(callId: string, tool: string, args: unknown): SessionEventBody;
+export declare function piToolEnded(callId: string, result: unknown): SessionEventBody;
+//# sourceMappingURL=tool-detail.d.ts.map

package/dist/runtimes/pi/tool-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detail.d.ts","sourceRoot":"","sources":["../../../src/runtimes/pi/tool-detail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,gBAAgB,CAKlB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAK7E"}

package/dist/runtimes/pi/tool-detail.js

@@ -0,0 +1,14 @@
+import { diagnosticText } from "../../shared/diagnostic-text.js";
+export function piToolStarted(callId, tool, args) {
+    const input = diagnosticText(args);
+    return input === undefined
+        ? { kind: "tool_call_started", callId, tool }
+        : { kind: "tool_call_started", callId, tool, input };
+}
+export function piToolEnded(callId, result) {
+    const output = diagnosticText(result);
+    return output === undefined
+        ? { kind: "tool_call_ended", callId }
+        : { kind: "tool_call_ended", callId, output };
+}
+//# sourceMappingURL=tool-detail.js.map

package/dist/runtimes/pi/tool-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detail.js","sourceRoot":"","sources":["../../../src/runtimes/pi/tool-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAY,EACZ,IAAa;IAEb,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,MAAe;IACzD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE;QACrC,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/dist/shared/diagnostic-text.d.ts

@@ -0,0 +1,2 @@
+export declare function diagnosticText(value: unknown): string | undefined;
+//# sourceMappingURL=diagnostic-text.d.ts.map

package/dist/shared/diagnostic-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-text.d.ts","sourceRoot":"","sources":["../../src/shared/diagnostic-text.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYjE"}

package/dist/shared/diagnostic-text.js

@@ -0,0 +1,15 @@
+export function diagnosticText(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return "[unserializable diagnostic value]";
+    }
+}
+//# sourceMappingURL=diagnostic-text.js.map

package/dist/shared/diagnostic-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic-text.js","sourceRoot":"","sources":["../../src/shared/diagnostic-text.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mCAAmC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/shared/executable/index.d.ts

@@ -0,0 +1,8 @@
+export type { ExecFileSyncLike, ExecutableResolveOptions } from "./resolve.js";
+export { resolveExecutable } from "./resolve.js";
+export type { ExecutableResult, ExecutableRunner, ExecutableRunOptions } from "./run.js";
+export { runExecutable } from "./run.js";
+export { readExecutableVersion } from "./version.js";
+export type { LineProcess } from "./process.js";
+export { requiresShell, spawnLineProcess } from "./process.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/executable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/executable/index.js

@@ -0,0 +1,5 @@
+export { resolveExecutable } from "./resolve.js";
+export { runExecutable } from "./run.js";
+export { readExecutableVersion } from "./version.js";
+export { requiresShell, spawnLineProcess } from "./process.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/executable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/executable/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/executable/process.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A long-lived child process spoken to line-by-line — the transport shape both
+ * session adapters use (JSONL protocols over stdio). Owns the details raw
+ * spawn callers keep re-implementing: stdio wiring, line buffering with a
+ * trailing partial buffer, exit fan-out, teardown, and the Windows quirk that
+ * npm-installed CLIs are .cmd shims which modern Node refuses to spawn without
+ * a shell (EINVAL). Windows handling follows Node's documented `shell` option
+ * and is honest about being untested here (no Windows machine in the loop).
+ */
+export interface LineProcess {
+    /** Resolves once the OS process exists; rejects when it cannot be spawned. */
+    readonly spawned: Promise<void>;
+    /** Resolves when the process is truly gone — the release point for any state it held (locks, sockets). */
+    readonly exited: Promise<number | null>;
+    write(text: string): void;
+    onLine(handler: (line: string) => void): void;
+    /** Fires exactly once, for exit or spawn-level error alike. */
+    onExit(handler: (code: number | null) => void): void;
+    kill(): void;
+}
+/** Windows npm shims are .cmd/.bat files, which modern Node refuses to spawn without a shell (EINVAL). Line processes go through cross-spawn instead (correct cmd arg quoting); this predicate remains for one-shot execFile calls, whose args must stay SINGLE-WORD on Windows because shell:true does not quote. */
+export declare function requiresShell(command: string, platform: NodeJS.Platform): boolean;
+export declare function spawnLineProcess(command: string, args: readonly string[], options?: {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}): LineProcess;
+//# sourceMappingURL=process.d.ts.map

package/dist/shared/executable/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/process.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9C,+DAA+D;IAC/D,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,sTAAsT;AACtT,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,CAEjF;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxE,WAAW,CAwEb"}

package/dist/shared/executable/process.js

@@ -0,0 +1,77 @@
+import spawn from "cross-spawn";
+/** Windows npm shims are .cmd/.bat files, which modern Node refuses to spawn without a shell (EINVAL). Line processes go through cross-spawn instead (correct cmd arg quoting); this predicate remains for one-shot execFile calls, whose args must stay SINGLE-WORD on Windows because shell:true does not quote. */
+export function requiresShell(command, platform) {
+    return platform === "win32" && /\.(?:cmd|bat)$/iu.test(command);
+}
+export function spawnLineProcess(command, args, options = {}) {
+    // cross-spawn, not node's spawn: Windows .cmd shims need a shell, and
+    // node's shell:true joins args UNQUOTED — a multi-word argument (e.g. a
+    // --system-prompt value) silently truncates at its first space (caught by
+    // the system-prompt snapshots on Windows CI). cross-spawn does the cmd
+    // escaping correctly and is a no-op wrapper elsewhere.
+    const child = spawn(command, [...args], {
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+        env: options.env ?? process.env,
+        // OAR_CHILD_STDERR=inherit surfaces child stderr on the parent's — the
+        // debugging knob for "the process died and nobody knows why".
+        stdio: ["pipe", "pipe", process.env.OAR_CHILD_STDERR === "inherit" ? "inherit" : "ignore"],
+    });
+    const { stdin, stdout } = child;
+    if (stdin === null || stdout === null) {
+        throw new Error("line process stdio must be piped");
+    }
+    const lineHandlers = [];
+    const exitHandlers = [];
+    let buffer = "";
+    let ended = false;
+    const { promise: spawned, resolve: spawnOk, reject: spawnFailed } = Promise.withResolvers();
+    const { promise: exited, resolve: exitDone } = Promise.withResolvers();
+    child.once("spawn", spawnOk);
+    const end = (code) => {
+        if (!ended) {
+            ended = true;
+            for (const handler of exitHandlers) {
+                handler(code);
+            }
+            exitDone(code);
+        }
+    };
+    stdout.on("data", (chunk) => {
+        buffer += chunk.toString();
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const raw of lines) {
+            const line = raw.trim();
+            if (line.length > 0) {
+                for (const handler of lineHandlers) {
+                    handler(line);
+                }
+            }
+        }
+    });
+    child.on("exit", (code) => {
+        end(code);
+    });
+    child.on("error", (error) => {
+        spawnFailed(error);
+        end(null);
+    });
+    return {
+        spawned,
+        exited,
+        write(text) {
+            stdin.write(text);
+        },
+        onLine(handler) {
+            lineHandlers.push(handler);
+        },
+        onExit(handler) {
+            exitHandlers.push(handler);
+        },
+        kill() {
+            stdin.end();
+            child.kill("SIGTERM");
+        },
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/shared/executable/process.js.map

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

package/dist/shared/executable/resolve.d.ts

@@ -0,0 +1,16 @@
+/** The one execFileSync shape resolution needs — a typed seam for tests. */
+export type ExecFileSyncLike = (command: string, args: readonly string[], options: {
+    readonly env: NodeJS.ProcessEnv;
+    readonly encoding: "utf8";
+    readonly stdio: readonly ["ignore", "pipe", "ignore"];
+    readonly timeout?: number;
+}) => string | Buffer;
+export interface ExecutableResolveOptions {
+    readonly platform?: NodeJS.Platform;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly execFileSyncFn?: ExecFileSyncLike;
+    readonly existsSyncFn?: (filePath: string) => boolean;
+}
+/** Resolve one executable without invoking a shell. */
+export declare function resolveExecutable(executable: string, options?: ExecutableResolveOptions): string | null;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/shared/executable/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/shared/executable/resolve.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,KACE,MAAM,GAAG,MAAM,CAAC;AAErB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CACvD;AAkDD,uDAAuD;AACvD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAA6B,GACrC,MAAM,GAAG,IAAI,CAiBf"}

package/dist/shared/executable/resolve.js

@@ -0,0 +1,63 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+function firstLine(value) {
+    const line = (typeof value === "string" ? value : value.toString()).trim().split(/\r?\n/u)[0];
+    return line === undefined || line.length === 0 ? null : line;
+}
+function resolveWindows(executable, env, execFile, exists) {
+    // The name travels via env, NOT as a trailing argument: powershell -Command
+    // appends trailing arguments to the command string instead of binding $args,
+    // which silently resolved nothing (caught by CI once Windows ran for real).
+    const script = [
+        "$cmd = Get-Command -Name $env:OAR_RESOLVE_TARGET -ErrorAction Stop | Select-Object -First 1",
+        "if ($cmd.Path) { $cmd.Path } elseif ($cmd.Source) { $cmd.Source }",
+    ].join("; ");
+    try {
+        const resolved = firstLine(execFile("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], 
+        // Cold powershell startup on CI runners routinely exceeds 1s; keep this
+        // generous — resolution is rare and cached by callers, not hot-path.
+        {
+            env: { ...env, OAR_RESOLVE_TARGET: executable },
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 15_000,
+        }));
+        if (resolved === null || !resolved.toLowerCase().endsWith(".ps1")) {
+            return resolved;
+        }
+        const directory = path.dirname(resolved);
+        const base = path.basename(resolved, ".ps1");
+        for (const extension of [".cmd", ".bat", ".exe", ""]) {
+            const candidate = path.join(directory, `${base}${extension}`);
+            if (exists(candidate)) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve one executable without invoking a shell. */
+export function resolveExecutable(executable, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const env = options.env ?? process.env;
+    const execFile = options.execFileSyncFn ?? execFileSync;
+    const exists = options.existsSyncFn ?? existsSync;
+    if (platform === "win32") {
+        return resolveWindows(executable, env, execFile, exists);
+    }
+    try {
+        return firstLine(execFile("which", [executable], {
+            env,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=resolve.js.map