@sift-wiki/conductor 0.0.0 → 0.2.0-beta.1

package/dist/adapters/fakeAgent.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { isAbortError } from "../runtime/sleep.js";
+const DEFAULT_DELAY_MS = 50;
+const QA_SCENARIOS = ["complete", "review", "blocked", "hard_stop", "slow"];
+const QA_ARTIFACT_REFERENCE_URL = "https://github.com/Sift-wiki/conductor-v1/blob/main/qa/work-orchestration/README.md";
+const qaScenarioSchema = z.object({
+    qaScenario: z.enum(QA_SCENARIOS),
+    qa: z
+        .object({
+        delayMs: z.number().int().min(0).max(10 * 60 * 1000).optional(),
+        costMicros: z.number().int().nonnegative().optional(),
+        durationMs: z.number().int().nonnegative().optional(),
+        comment: z.string().min(1).max(4000).optional(),
+    })
+        .optional(),
+});
+const artifactResponseSchema = z.object({ id: z.string().min(1) });
+const usageResponseSchema = z.object({ hardStop: z.boolean() });
+export function createFakeAgentAdapter(input = {}) {
+    const delayMs = input.delayMs ?? DEFAULT_DELAY_MS;
+    const fetch = input.fetch ?? globalThis.fetch.bind(globalThis);
+    return {
+        localKey: input.localKey ?? "fake-agent",
+        displayName: input.displayName ?? "Fake Agent",
+        adapterType: "fake",
+        capabilities: { streaming: false, qaScenarios: [...QA_SCENARIOS], ...input.capabilities },
+        check: () => Promise.resolve({ status: "ready", message: "Fake adapter is always ready." }),
+        async run(runInput) {
+            await runInput.emit({
+                eventType: "health",
+                payload: {
+                    phase: "starting",
+                    adapterType: "fake",
+                },
+            });
+            await runInput.emit({
+                eventType: "progress",
+                payload: {
+                    summary: "Fake agent accepted local Conductor job.",
+                },
+            });
+            const scenario = readQaScenario(runInput.wakeEnvelope?.wake.payload);
+            if (scenario?.qaScenario === "review") {
+                return runReviewScenario(runInput, scenario.qa, fetch);
+            }
+            if (scenario?.qaScenario === "blocked") {
+                return runBlockedScenario(runInput, scenario.qa, fetch);
+            }
+            if (scenario?.qaScenario === "hard_stop") {
+                return runHardStopScenario(runInput, scenario.qa, fetch);
+            }
+            try {
+                await runInput.sleep(scenario?.qa?.delayMs ?? delayMs, runInput.signal);
+            }
+            catch (error) {
+                if (!isAbortError(error)) {
+                    throw error;
+                }
+            }
+            if (runInput.signal.aborted) {
+                return {
+                    status: "cancelled",
+                    resultSummary: { summary: "Stopped fake agent after cancellation." },
+                };
+            }
+            await runInput.emit({
+                eventType: "progress",
+                payload: {
+                    summary: "Fake agent completed tracer-bullet work.",
+                },
+            });
+            return {
+                status: "completed",
+                resultSummary: {
+                    summary: `Fake agent completed tracer-bullet work for: ${runInput.objective}`,
+                },
+            };
+        },
+    };
+}
+function readQaScenario(payload) {
+    if (payload?.["qaScenario"] === undefined)
+        return undefined;
+    return qaScenarioSchema.parse(payload);
+}
+async function runReviewScenario(input, qa, fetch) {
+    await bridgePost(input, fetch, "/v1/task/comments", {
+        bodyMarkdown: qa?.comment ?? "QA agent prepared an artifact for human review.",
+    });
+    const artifact = artifactResponseSchema.parse(await bridgePost(input, fetch, "/v1/artifacts", {
+        type: "report",
+        provider: "sift-conductor-qa",
+        title: `QA review artifact for ${input.wakeEnvelope?.task.title ?? "task"}`,
+        url: QA_ARTIFACT_REFERENCE_URL,
+        summary: "Deterministic artifact generated by the Sift Conductor live QA adapter.",
+        idempotencyKey: `qa-artifact:${input.wakeEnvelope?.runId ?? "unknown"}`,
+    }));
+    await bridgePost(input, fetch, "/v1/approvals", {
+        type: "human_review",
+        payload: { artifactId: artifact.id },
+        idempotencyKey: `qa-approval:${input.wakeEnvelope?.runId ?? "unknown"}`,
+    });
+    return {
+        status: "completed",
+        disposition: "in_review",
+        resultSummary: { summary: "QA artifact is ready for human review.", artifactId: artifact.id },
+    };
+}
+async function runBlockedScenario(input, qa, fetch) {
+    await bridgePost(input, fetch, "/v1/task/comments", {
+        bodyMarkdown: qa?.comment ?? "QA agent is blocked pending a human-provided decision.",
+    });
+    return {
+        status: "completed",
+        disposition: "blocked",
+        resultSummary: { summary: "QA agent stopped with an actionable blocker." },
+    };
+}
+async function runHardStopScenario(input, qa, fetch) {
+    const decision = usageResponseSchema.parse(await bridgePost(input, fetch, "/v1/usage", {
+        eventKey: `qa-usage:${input.wakeEnvelope?.runId ?? "unknown"}`,
+        costMicros: qa?.costMicros ?? 2_000_000,
+        durationMs: qa?.durationMs ?? 1_000,
+    }));
+    if (!decision.hardStop) {
+        throw new Error("QA hard-stop scenario did not reach a configured hard limit.");
+    }
+    return {
+        status: "cancelled",
+        resultSummary: { summary: "QA run stopped after reaching its Sift usage policy." },
+    };
+}
+async function bridgePost(input, fetch, path, body) {
+    const apiUrl = input.env?.["SIFT_API_URL"];
+    const token = input.env?.["SIFT_RUN_TOKEN"];
+    if (apiUrl === undefined || token === undefined) {
+        throw new Error("QA scenario requires a task-linked local bridge session.");
+    }
+    const response = await fetch(`${apiUrl.replace(/\/$/u, "")}${path}`, {
+        method: "POST",
+        headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const value = await response.json();
+    if (!response.ok)
+        throw new Error(`QA bridge request failed with HTTP ${String(response.status)}.`);
+    return value;
+}
+//# sourceMappingURL=fakeAgent.js.map

package/dist/adapters/fakeAgent.js.map

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

package/dist/adapters/httpAgent.d.ts

@@ -0,0 +1,19 @@
+import type { LocalAgentAdapter } from "./types.js";
+import type { JsonObject } from "../types.js";
+export type FetchLike = (url: string, init: RequestInit) => Promise<Response>;
+export type HttpAgentConfig = {
+    localKey: string;
+    displayName: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    payloadTemplate: JsonObject;
+    timeoutMs: number;
+    outputLimitBytes: number;
+    capabilities: JsonObject;
+};
+export type HttpAgentDeps = {
+    fetch?: FetchLike;
+};
+export declare function createHttpAgentAdapter(config: HttpAgentConfig, deps?: HttpAgentDeps): LocalAgentAdapter;
+export declare function isJsonObject(value: unknown): value is JsonObject;

package/dist/adapters/httpAgent.js

@@ -0,0 +1,164 @@
+import { LocalAgentExecutionError } from "./errors.js";
+import { boundedOutputSummary, boundAndRedactText } from "./output.js";
+export function createHttpAgentAdapter(config, deps = {}) {
+    const fetch = deps.fetch ?? globalThis.fetch.bind(globalThis);
+    return {
+        localKey: config.localKey,
+        displayName: config.displayName,
+        adapterType: "http",
+        capabilities: {
+            streaming: false,
+            cancellation: "abort",
+            ...config.capabilities,
+        },
+        check: () => checkHttpAdapter(config),
+        run: (input) => runHttpAdapter(input, config, fetch),
+    };
+}
+async function runHttpAdapter(input, config, fetch) {
+    const cancellationState = cancellationStateFor(input.signal);
+    if (isCancellationRequested(cancellationState)) {
+        return {
+            status: "cancelled",
+            resultSummary: { summary: "HTTP adapter was cancelled before start." },
+        };
+    }
+    await input.emit({
+        eventType: "health",
+        payload: {
+            summary: "Starting HTTP adapter.",
+            adapterType: "http",
+            localKey: config.localKey,
+        },
+    });
+    const controller = new AbortController();
+    const timeoutState = { timedOut: false };
+    const timeout = config.timeoutMs > 0
+        ? setTimeout(() => {
+            timeoutState.timedOut = true;
+            controller.abort();
+        }, config.timeoutMs)
+        : undefined;
+    const abort = () => {
+        cancellationState.requested = true;
+        controller.abort();
+    };
+    input.signal.addEventListener("abort", abort, { once: true });
+    try {
+        await input.emit({
+            eventType: "progress",
+            payload: {
+                summary: "Invoking HTTP adapter endpoint.",
+                method: config.method,
+                url: boundAndRedactText(config.url).text,
+            },
+        });
+        const response = await fetch(config.url, requestInit(config, input, controller.signal));
+        const responseText = await response.text();
+        const summary = {
+            summary: `HTTP ${config.method} returned ${String(response.status)}.`,
+            status: response.status,
+            ok: response.ok,
+            method: config.method,
+            url: boundAndRedactText(config.url).text,
+            ...boundedOutputSummary({
+                output: responseText,
+                limitBytes: config.outputLimitBytes,
+            }),
+        };
+        if (isCancellationRequested(cancellationState)) {
+            return {
+                status: "cancelled",
+                resultSummary: { summary: "Stopped HTTP adapter after cancellation." },
+            };
+        }
+        if (!response.ok) {
+            throw new LocalAgentExecutionError(`HTTP adapter returned status ${String(response.status)}.`, {
+                ...summary,
+                message: `HTTP adapter returned status ${String(response.status)}.`,
+            });
+        }
+        return {
+            status: "completed",
+            resultSummary: summary,
+        };
+    }
+    catch (error) {
+        if (isCancellationRequested(cancellationState)) {
+            return {
+                status: "cancelled",
+                resultSummary: { summary: "Stopped HTTP adapter after cancellation." },
+            };
+        }
+        if (timeoutState.timedOut) {
+            throw new LocalAgentExecutionError(`HTTP adapter timed out after ${String(config.timeoutMs)}ms.`, {
+                message: `HTTP adapter timed out after ${String(config.timeoutMs)}ms.`,
+                timedOut: true,
+                method: config.method,
+                url: boundAndRedactText(config.url).text,
+            });
+        }
+        if (error instanceof LocalAgentExecutionError) {
+            throw error;
+        }
+        throw new LocalAgentExecutionError(error instanceof Error ? error.message : "HTTP adapter failed.", {
+            message: error instanceof Error ? boundAndRedactText(error.message).text : "HTTP adapter failed.",
+            method: config.method,
+            url: boundAndRedactText(config.url).text,
+        });
+    }
+    finally {
+        input.signal.removeEventListener("abort", abort);
+        if (timeout !== undefined) {
+            clearTimeout(timeout);
+        }
+    }
+}
+function requestInit(config, input, signal) {
+    const method = config.method.toUpperCase();
+    const init = {
+        method,
+        headers: {
+            "content-type": "application/json",
+            ...config.headers,
+        },
+        signal,
+    };
+    if (method !== "GET" && method !== "HEAD") {
+        init.body = JSON.stringify({
+            ...config.payloadTemplate,
+            objective: input.objective,
+            contextRefs: input.contextRefs,
+            limits: input.limits,
+            job: input.job ?? null,
+            wakeEnvelope: input.wakeEnvelope ?? null,
+        });
+    }
+    return init;
+}
+function checkHttpAdapter(config) {
+    try {
+        const url = new URL(config.url);
+        return Promise.resolve({
+            status: "ready",
+            message: `Endpoint configured: ${boundAndRedactText(url.toString()).text}`,
+        });
+    }
+    catch {
+        return Promise.resolve({
+            status: "error",
+            message: `Invalid URL: ${boundAndRedactText(config.url).text}`,
+            hint: "Configure a valid HTTP or HTTPS adapter URL.",
+        });
+    }
+}
+export function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cancellationStateFor(signal) {
+    return { requested: signal.aborted };
+}
+function isCancellationRequested(state) {
+    return state.requested;
+}
+//# sourceMappingURL=httpAgent.js.map

package/dist/adapters/httpAgent.js.map

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

package/dist/adapters/output.d.ts

@@ -0,0 +1,16 @@
+import type { JsonObject } from "../types.js";
+export declare const DEFAULT_OUTPUT_LIMIT_BYTES: number;
+export type BoundedText = {
+    text: string;
+    bytes: number;
+    truncated: boolean;
+    limitBytes: number;
+};
+export declare function boundAndRedactText(input: string, limitBytes?: number): BoundedText;
+export declare function boundedOutputSummary(input: {
+    stdout?: string;
+    stderr?: string;
+    output?: string;
+    limitBytes?: number;
+}): JsonObject;
+export declare function safeMessage(message: string, limitBytes?: number): string;

package/dist/adapters/output.js

@@ -0,0 +1,48 @@
+import { Buffer } from "node:buffer";
+import { redactSecrets } from "../redaction.js";
+export const DEFAULT_OUTPUT_LIMIT_BYTES = 32 * 1024;
+export function boundAndRedactText(input, limitBytes = DEFAULT_OUTPUT_LIMIT_BYTES) {
+    const redacted = redactSecrets(input);
+    const bytes = Buffer.byteLength(redacted, "utf8");
+    if (bytes <= limitBytes) {
+        return {
+            text: redacted,
+            bytes,
+            truncated: false,
+            limitBytes,
+        };
+    }
+    return {
+        text: Buffer.from(redacted, "utf8").subarray(0, limitBytes).toString("utf8"),
+        bytes,
+        truncated: true,
+        limitBytes,
+    };
+}
+export function boundedOutputSummary(input) {
+    const limitBytes = input.limitBytes ?? DEFAULT_OUTPUT_LIMIT_BYTES;
+    const summary = {};
+    if (input.stdout !== undefined) {
+        const stdout = boundAndRedactText(input.stdout, limitBytes);
+        summary.stdout = stdout.text;
+        summary.stdoutTruncated = stdout.truncated;
+        summary.stdoutBytes = stdout.bytes;
+    }
+    if (input.stderr !== undefined) {
+        const stderr = boundAndRedactText(input.stderr, limitBytes);
+        summary.stderr = stderr.text;
+        summary.stderrTruncated = stderr.truncated;
+        summary.stderrBytes = stderr.bytes;
+    }
+    if (input.output !== undefined) {
+        const output = boundAndRedactText(input.output, limitBytes);
+        summary.output = output.text;
+        summary.outputTruncated = output.truncated;
+        summary.outputBytes = output.bytes;
+    }
+    return summary;
+}
+export function safeMessage(message, limitBytes = DEFAULT_OUTPUT_LIMIT_BYTES) {
+    return boundAndRedactText(message, limitBytes).text;
+}
+//# sourceMappingURL=output.js.map

package/dist/adapters/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/adapters/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,IAAI,CAAC;AASpD,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,UAAU,GAAG,0BAA0B;IAEvC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK;YACL,SAAS,EAAE,KAAK;YAChB,UAAU;SACX,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5E,KAAK;QACL,SAAS,EAAE,IAAI;QACf,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAKpC;IACC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,0BAA0B,CAAC;IAClE,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC5D,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;QAC3C,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC5D,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;QAC3C,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC5D,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;QAC3C,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAAU,GAAG,0BAA0B;IAClF,OAAO,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC"}

package/dist/adapters/processAgent.d.ts

@@ -0,0 +1,21 @@
+import type { LocalAgentAdapter } from "./types.js";
+import { type RunProcess } from "../runtime/process.js";
+import type { JsonObject } from "../types.js";
+export type ProcessAgentConfig = {
+    localKey: string;
+    displayName: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    timeoutMs: number;
+    graceMs: number;
+    outputLimitBytes: number;
+    capabilities: JsonObject;
+    paperclipEnvAliases: boolean;
+};
+export type ProcessAgentDeps = {
+    runProcess?: RunProcess;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function createProcessAgentAdapter(config: ProcessAgentConfig, deps?: ProcessAgentDeps): LocalAgentAdapter;

package/dist/adapters/processAgent.js

@@ -0,0 +1,166 @@
+import { access } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+import path from "node:path";
+import { LocalAgentExecutionError } from "./errors.js";
+import { boundedOutputSummary, boundAndRedactText } from "./output.js";
+import { buildPaperclipAliasEnvironment } from "../runtime/runEnvironment.js";
+import { runChildProcess } from "../runtime/process.js";
+export function createProcessAgentAdapter(config, deps = {}) {
+    const runProcess = deps.runProcess ?? runChildProcess;
+    return {
+        localKey: config.localKey,
+        displayName: config.displayName,
+        adapterType: "process",
+        capabilities: {
+            streaming: false,
+            cancellation: "cooperative",
+            ...config.capabilities,
+        },
+        check: () => checkProcessAdapter(config, deps.env ?? process.env),
+        run: (input) => runProcessAdapter(input, config, runProcess),
+    };
+}
+async function runProcessAdapter(input, config, runProcess) {
+    const cancellationState = cancellationStateFor(input.signal);
+    if (isCancellationRequested(cancellationState)) {
+        return {
+            status: "cancelled",
+            resultSummary: { summary: "Process adapter was cancelled before start." },
+        };
+    }
+    const onAbort = () => {
+        cancellationState.requested = true;
+    };
+    input.signal.addEventListener("abort", onAbort, { once: true });
+    try {
+        await input.emit({
+            eventType: "health",
+            payload: {
+                summary: "Starting process adapter.",
+                adapterType: "process",
+                localKey: config.localKey,
+            },
+        });
+        await input.emit({
+            eventType: "progress",
+            payload: {
+                summary: "Launching local command.",
+                command: boundAndRedactText(config.command).text,
+                cwd: boundAndRedactText(config.cwd).text,
+            },
+        });
+        const runEnv = input.env ?? {};
+        const result = await runProcess({
+            command: config.command,
+            args: config.args,
+            cwd: config.cwd,
+            env: {
+                ...config.env,
+                ...runEnv,
+                ...(config.paperclipEnvAliases ? buildPaperclipAliasEnvironment(runEnv) : {}),
+            },
+            timeoutMs: config.timeoutMs,
+            graceMs: config.graceMs,
+            outputLimitBytes: config.outputLimitBytes,
+            signal: input.signal,
+            onLog: async (stream, chunk) => {
+                const safeChunk = boundAndRedactText(chunk, config.outputLimitBytes);
+                await input.emit({
+                    eventType: "log",
+                    payload: {
+                        stream,
+                        text: safeChunk.text,
+                        truncated: safeChunk.truncated,
+                    },
+                });
+            },
+        });
+        if (isCancellationRequested(cancellationState)) {
+            return {
+                status: "cancelled",
+                resultSummary: {
+                    summary: "Stopped process adapter after cancellation.",
+                    exitCode: result.exitCode,
+                    signal: result.signal,
+                },
+            };
+        }
+        const summary = {
+            summary: `Process exited with code ${String(result.exitCode ?? -1)}.`,
+            exitCode: result.exitCode,
+            signal: result.signal,
+            timedOut: result.timedOut,
+            ...boundedOutputSummary({
+                stdout: result.stdout,
+                stderr: result.stderr,
+                limitBytes: config.outputLimitBytes,
+            }),
+        };
+        if (result.timedOut) {
+            throw new LocalAgentExecutionError(`Process timed out after ${String(config.timeoutMs)}ms.`, {
+                ...summary,
+                message: `Process timed out after ${String(config.timeoutMs)}ms.`,
+            });
+        }
+        if ((result.exitCode ?? 0) !== 0) {
+            throw new LocalAgentExecutionError(`Process exited with code ${String(result.exitCode ?? -1)}.`, {
+                ...summary,
+                message: `Process exited with code ${String(result.exitCode ?? -1)}.`,
+            });
+        }
+        return {
+            status: "completed",
+            resultSummary: summary,
+        };
+    }
+    finally {
+        input.signal.removeEventListener("abort", onAbort);
+    }
+}
+async function checkProcessAdapter(config, env) {
+    const resolved = await resolveCommand(config.command, config.cwd, env);
+    if (resolved === undefined) {
+        return {
+            status: "error",
+            message: `Command not found: ${boundAndRedactText(config.command).text}`,
+            hint: "Verify the adapter command, working directory, and PATH.",
+        };
+    }
+    return {
+        status: "ready",
+        message: `Command resolved: ${boundAndRedactText(resolved).text}`,
+    };
+}
+function cancellationStateFor(signal) {
+    return { requested: signal.aborted };
+}
+function isCancellationRequested(state) {
+    return state.requested;
+}
+async function resolveCommand(command, cwd, env) {
+    if (command.includes("/") || command.includes("\\")) {
+        const candidate = path.isAbsolute(command) ? command : path.resolve(cwd, command);
+        return canExecute(candidate).then((ok) => ok ? candidate : undefined);
+    }
+    const pathValue = env.PATH ?? env.Path ?? "";
+    const candidates = pathValue
+        .split(path.delimiter)
+        .filter((entry) => entry.length > 0)
+        .map((entry) => path.join(entry, command));
+    for (const candidate of candidates) {
+        if (await canExecute(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+async function canExecute(candidate) {
+    try {
+        await access(candidate, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=processAgent.js.map

package/dist/adapters/processAgent.js.map

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

package/dist/adapters/provider/discovery.d.ts

@@ -0,0 +1,31 @@
+import type { RunProcess } from "../../runtime/process.js";
+import type { ProviderAccessProfile, ProviderType } from "./types.js";
+export type ProviderProbeDeps = {
+    runProcess?: RunProcess | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+};
+export declare function resolveProviderExecutable(input: {
+    provider: ProviderType;
+    executablePath?: string | undefined;
+    cwd: string;
+    env?: NodeJS.ProcessEnv | undefined;
+}): Promise<string | undefined>;
+export declare function probeCommand(input: {
+    command: string;
+    args: string[];
+    cwd: string;
+    env?: Record<string, string> | undefined;
+    timeoutMs?: number | undefined;
+    deps?: ProviderProbeDeps | undefined;
+}): Promise<import("../../runtime/process.js").RunProcessResult>;
+export declare function validateWorkspace(input: {
+    workspacePath: string;
+    accessProfile: ProviderAccessProfile;
+}): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+}>;
+export declare function safeExecutableLabel(executablePath: string): string;
+export declare function defaultProviderCommand(provider: ProviderType): string;