harness-supervisor 0.0.0-stage → 0.10.3

package/dist/src/adapters/acp/client.js

@@ -0,0 +1,324 @@
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+import { SupervisorError, errorMessage } from "../../errors.js";
+import { Deferred, withTimeout } from "../../util/async.js";
+import { safeText } from "../../util/redact.js";
+export class AcpClient {
+    pid;
+    child;
+    runtimeLabel;
+    diagnosticTag;
+    handlers;
+    onStderr;
+    onDiagnostic;
+    requestTimeoutMs;
+    maxStderrTail;
+    closed = new Deferred();
+    pending = new Map();
+    stderrDecoder = new StringDecoder("utf8");
+    requestCounter = 0;
+    stdoutBuffer = "";
+    stderrBuffer = "";
+    exitInfo = null;
+    exited = false;
+    forced = false;
+    constructor(child, options) {
+        this.child = child;
+        this.pid = child.pid;
+        this.runtimeLabel = options.runtimeLabel;
+        this.diagnosticTag = options.diagnosticTag;
+        this.handlers = options.handlers ?? {};
+        this.onStderr = options.onStderr;
+        this.onDiagnostic = options.onDiagnostic;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 120_000;
+        this.maxStderrTail = options.stderrTailBytes ?? 32 * 1024;
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.handleStdout(chunk));
+        child.stderr.on("data", (chunk) => {
+            const text = this.stderrDecoder.write(chunk);
+            this.appendStderr(text);
+            if (text)
+                this.onStderr?.(text);
+        });
+        child.on("error", (error) => {
+            this.diagnostic(`Harness process error: ${error.message}`);
+        });
+        child.on("close", (code, signal) => this.handleClose(code, signal));
+    }
+    static async start(options) {
+        const child = spawn(options.launch.file, options.launch.args, {
+            cwd: options.launch.cwd,
+            env: options.launch.env,
+            stdio: ["pipe", "pipe", "pipe"],
+            windowsHide: true,
+            windowsVerbatimArguments: options.launch.windowsVerbatimArguments,
+            detached: process.platform !== "win32",
+        });
+        const client = new AcpClient(child, options);
+        try {
+            await new Promise((resolve, reject) => {
+                const onSpawn = () => {
+                    cleanup();
+                    resolve();
+                };
+                const onError = (error) => {
+                    cleanup();
+                    reject(new SupervisorError("HARNESS_ERROR", `Failed to start ${options.runtimeLabel}: ${error.message}`, { launch: options.launch.description }));
+                };
+                const cleanup = () => {
+                    child.off("spawn", onSpawn);
+                    child.off("error", onError);
+                };
+                child.once("spawn", onSpawn);
+                child.once("error", onError);
+            });
+        }
+        catch (error) {
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                // Already gone.
+            }
+            throw error;
+        }
+        return client;
+    }
+    isAlive() {
+        return !this.exited && this.child.exitCode === null;
+    }
+    stderrTail() {
+        return safeText(this.stderrBuffer, 16 * 1024);
+    }
+    request(method, params, timeoutMs) {
+        if (!this.isAlive()) {
+            return Promise.reject(new SupervisorError("HARNESS_ERROR", `${this.runtimeLabel} process is not running`, {
+                stderrTail: this.stderrTail(),
+            }));
+        }
+        const id = this.nextId();
+        const limit = timeoutMs ?? this.requestTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const timer = limit > 0
+                ? setTimeout(() => {
+                    this.pending.delete(String(id));
+                    reject(new SupervisorError("HARNESS_TIMEOUT", `${this.runtimeLabel} request timed out after ${limit}ms: ${method}`, { method }));
+                }, limit)
+                : undefined;
+            timer?.unref?.();
+            this.pending.set(String(id), { resolve, reject, timer, method });
+            this.write({ jsonrpc: "2.0", id, method, params }).catch((error) => {
+                const entry = this.pending.get(String(id));
+                if (!entry)
+                    return;
+                clearTimeout(entry.timer);
+                this.pending.delete(String(id));
+                reject(error instanceof Error
+                    ? error
+                    : new SupervisorError("HARNESS_ERROR", errorMessage(error)));
+            });
+        });
+    }
+    async notify(method, params) {
+        if (!this.isAlive())
+            return;
+        await this.write({ jsonrpc: "2.0", method, params });
+    }
+    async reply(id, result) {
+        if (!this.isAlive())
+            return;
+        await this.write({ jsonrpc: "2.0", id, result });
+    }
+    async replyError(id, code, message) {
+        if (!this.isAlive())
+            return;
+        await this.write({ jsonrpc: "2.0", id, error: { code, message } });
+    }
+    async close(options) {
+        const graceMs = options?.graceMs ?? 1500;
+        if (this.exited)
+            return { exit: this.exitInfo, forced: this.forced };
+        try {
+            this.child.stdin.end();
+        }
+        catch {
+            // Fall through to killing.
+        }
+        let exited = await this.waitForExit(graceMs);
+        if (!exited) {
+            this.forced = true;
+            await this.forceKill();
+            exited = await this.waitForExit(3000);
+        }
+        if (!exited) {
+            this.diagnostic(`${this.runtimeLabel} process did not exit after stdin close and forced termination`);
+        }
+        return { exit: this.exitInfo, forced: this.forced };
+    }
+    async forceKill() {
+        if (this.exited || !this.pid)
+            return;
+        if (process.platform === "win32") {
+            await new Promise((resolve) => {
+                const killer = spawn("taskkill.exe", ["/PID", String(this.pid), "/T", "/F"], {
+                    stdio: "ignore",
+                    windowsHide: true,
+                });
+                killer.once("error", () => resolve());
+                killer.once("close", () => resolve());
+            });
+        }
+        else {
+            try {
+                process.kill(-this.pid, "SIGKILL");
+            }
+            catch {
+                try {
+                    this.child.kill("SIGKILL");
+                }
+                catch {
+                    // Already gone.
+                }
+            }
+        }
+        await this.waitForExit(3000);
+    }
+    nextId() {
+        return `hs-${++this.requestCounter}`;
+    }
+    handleStdout(chunk) {
+        this.stdoutBuffer += chunk;
+        for (;;) {
+            const newline = this.stdoutBuffer.indexOf("\n");
+            if (newline < 0)
+                return;
+            const line = this.stdoutBuffer.slice(0, newline).trim();
+            this.stdoutBuffer = this.stdoutBuffer.slice(newline + 1);
+            if (!line)
+                continue;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                this.diagnostic(`Invalid JSON from ${this.runtimeLabel}: ${line.slice(0, 300)}`);
+                continue;
+            }
+            this.handleMessage(message);
+        }
+    }
+    handleMessage(message) {
+        const method = typeof message.method === "string" ? message.method : "";
+        const rawId = message.id;
+        const id = typeof rawId === "string" || typeof rawId === "number" ? rawId : undefined;
+        const hasId = id !== undefined;
+        if (method) {
+            if (method === "session/update") {
+                this.handlers.onUpdate?.(message.params);
+                return;
+            }
+            if (method === "$/cancel_request") {
+                this.handlers.onNotification?.(method, message.params);
+                // It is normally a notification. If the agent sent it as a request,
+                // still acknowledge so the agent is not left waiting.
+                if (hasId)
+                    void this.reply(id, {}).catch(() => undefined);
+                return;
+            }
+            if (hasId) {
+                void Promise.resolve(this.handlers.onRequest?.(method, message.params, id) ?? false)
+                    .then((handled) => {
+                    if (!handled) {
+                        return this.replyError(id, -32601, `Method not found: ${method}`);
+                    }
+                    return undefined;
+                })
+                    .catch((error) => {
+                    this.diagnostic(`Failed to handle ${method}: ${errorMessage(error)}`);
+                    return this.replyError(id, -32603, "Internal error").catch(() => undefined);
+                });
+                return;
+            }
+            this.handlers.onNotification?.(method, message.params);
+            return;
+        }
+        if (!hasId)
+            return;
+        const key = String(id);
+        const pending = this.pending.get(key);
+        if (!pending) {
+            this.diagnostic(`Response for unknown request id ${key}`);
+            return;
+        }
+        clearTimeout(pending.timer);
+        this.pending.delete(key);
+        if (message.error) {
+            const error = message.error;
+            pending.reject(new SupervisorError("HARNESS_ERROR", safeText(`${this.runtimeLabel} ${pending.method} failed: ${error?.message ?? "unknown error"}`, 2000), { method: pending.method, code: error?.code }));
+        }
+        else {
+            pending.resolve(message.result);
+        }
+    }
+    handleClose(code, signal) {
+        if (this.exited)
+            return;
+        this.exited = true;
+        this.exitInfo = { code, signal };
+        this.rejectPending(new SupervisorError("HARNESS_ERROR", `${this.runtimeLabel} process exited (code=${code}, signal=${signal})`, { code, signal }));
+        const exit = this.exitInfo;
+        this.closed.resolve(exit);
+        try {
+            this.handlers.onExit?.(exit);
+        }
+        catch {
+            // Callback failures must not break process cleanup.
+        }
+    }
+    rejectPending(error) {
+        for (const pending of this.pending.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    async write(message) {
+        if (!this.isAlive()) {
+            throw new SupervisorError("HARNESS_ERROR", `Cannot write to ${this.runtimeLabel}: process is not running`);
+        }
+        const line = `${JSON.stringify(message)}\n`;
+        await new Promise((resolve, reject) => {
+            this.child.stdin.write(line, "utf8", (error) => {
+                if (error) {
+                    reject(new SupervisorError("HARNESS_ERROR", `Failed to write to ${this.runtimeLabel} stdin: ${error.message}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    async waitForExit(timeoutMs) {
+        if (this.exited)
+            return true;
+        try {
+            await withTimeout(this.closed.promise, timeoutMs, "timed out waiting for harness exit");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    appendStderr(text) {
+        this.stderrBuffer = `${this.stderrBuffer}${text}`;
+        if (this.stderrBuffer.length > this.maxStderrTail) {
+            this.stderrBuffer = this.stderrBuffer.slice(-this.maxStderrTail);
+        }
+    }
+    diagnostic(message) {
+        const line = `${new Date().toISOString()} [${this.diagnosticTag}] ${message}\n`;
+        this.appendStderr(line);
+        this.onDiagnostic?.(message);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/adapters/acp/client.js.map

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

package/dist/src/adapters/dsh/adapter.d.ts

@@ -0,0 +1,27 @@
+import type { HarnessAdapter, HarnessCallbacks, HarnessSession, HarnessSpawnSpec, RuntimeCapabilities } from "../../types.js";
+import { type DshLaunch, type DshPermissionMode } from "./launch.js";
+export interface DshAdapterOptions {
+    launch?: DshLaunch;
+    permissionMode?: DshPermissionMode;
+    requestTimeoutMs?: number;
+    abortTimeoutMs?: number;
+    onStderr?: (workerId: string, text: string) => void;
+    onDiagnostic?: (workerId: string, text: string) => void;
+}
+export declare class DshAdapter implements HarnessAdapter {
+    readonly name = "dsh";
+    readonly capabilities: RuntimeCapabilities;
+    readonly processIdentity: "conservative";
+    private readonly options;
+    private launch;
+    private permissionMode;
+    constructor(options?: DshAdapterOptions);
+    instanceRef(): string;
+    spawn(spec: HarnessSpawnSpec, callbacks: HarnessCallbacks): Promise<HarnessSession>;
+    resume(spec: HarnessSpawnSpec, sessionFile: string, callbacks: HarnessCallbacks): Promise<HarnessSession>;
+    private validateTools;
+    private resolveLaunch;
+    private resolvePermissionMode;
+    /** Per-worker environment (command guard, worker id) never mutates the daemon env. */
+    private launchFor;
+}

package/dist/src/adapters/dsh/adapter.js

@@ -0,0 +1,125 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { SupervisorError } from "../../errors.js";
+import { ensureDir } from "../../util/fsx.js";
+import { resolveDshLaunch, resolveDshPermissionMode, validateDshExtraArgs, } from "./launch.js";
+import { DshAcpSession, readDshSessionHandle } from "./session.js";
+const CAPABILITIES = {
+    runtime: "dsh",
+    steer: false,
+    followUp: false,
+    cancel: true,
+    resume: true,
+    pause: false,
+    interactiveInput: true,
+    idleContinue: "L3",
+    notes: "DeepSeek Harness ACP over ndJSON stdio (`dsh --profile acp`). Verified against the desktop-bundled CLI 0.2.1-rc.5 (agent 0.0.1): initialize advertises ACP v1 plus session close/list/resume, session/new and session/resume work, model and reasoning_effort are selectable config options, session/prompt blocks until the turn and descendants settle, session/cancel returns stopReason=cancelled, and stdin EOF exits the process cleanly. session/resume restores the persisted conversation in a new process and requires the identical absolute cwd; there is no session/load, fork, delete or transcript replay. The shipped acp profile reads DSH_PERMISSION_MODE at boot and defaults to workspace-write with approval ask: file writes inside the workspace or platform temp are allowed without a prompt, while an outside write is denied and can trigger session/request_permission for a one-time danger-full-access escalation (verified). HARNESS_SUPERVISOR_DSH_PERMISSION_MODE selects read-only, workspace-write or danger-full-access; danger-full-access removes the file sandbox and sets approval to never. DSH's permission request carries only a tool call id, not the tool name or input; the adapter answers with the offered allow-once/reject-once option. ACP has no active-turn steer, so steer and follow-up are unsupported; a second prompt is rejected while one is active. No plan, commands, terminal, client filesystem, elicitation, MCP stdio or images. usage_update is context occupancy, not billed token usage. DSH's ACP codec maps native aborted/blocked/error turn endings to end_turn, so HS cannot always distinguish those from a normal completion. Persistent idle continuation was verified with a real 3-Turn session (same worker and session, same absolute cwd, both earlier codewords recalled without restatement). cwd is not a filesystem sandbox.",
+};
+export class DshAdapter {
+    name = "dsh";
+    capabilities = CAPABILITIES;
+    processIdentity = "conservative";
+    options;
+    launch = null;
+    permissionMode = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    instanceRef() {
+        try {
+            return `dsh:${this.resolveLaunch().file}`;
+        }
+        catch {
+            return "dsh";
+        }
+    }
+    async spawn(spec, callbacks) {
+        validateDshExtraArgs(spec.extraArgs);
+        this.validateTools(spec);
+        await ensureDir(spec.sessionDir);
+        return DshAcpSession.start({
+            launch: this.launchFor(spec),
+            cwd: spec.cwd,
+            sessionDir: spec.sessionDir,
+            model: spec.model,
+            provider: spec.provider,
+            thinking: spec.thinking,
+            callbacks,
+            onStderr: this.options.onStderr
+                ? (text) => this.options.onStderr?.(spec.workerId, text)
+                : undefined,
+            onDiagnostic: this.options.onDiagnostic
+                ? (text) => this.options.onDiagnostic?.(spec.workerId, text)
+                : undefined,
+            requestTimeoutMs: this.options.requestTimeoutMs,
+            abortTimeoutMs: this.options.abortTimeoutMs,
+        });
+    }
+    async resume(spec, sessionFile, callbacks) {
+        validateDshExtraArgs(spec.extraArgs);
+        this.validateTools(spec);
+        const resolved = path.resolve(sessionFile);
+        let info;
+        try {
+            info = await stat(resolved);
+        }
+        catch {
+            throw new SupervisorError("UNSUPPORTED", "Cannot resume: the DeepSeek Harness session handle does not exist. Refusing to fake a resume.", { sessionFile: resolved });
+        }
+        if (!info.isFile() || info.size === 0) {
+            throw new SupervisorError("UNSUPPORTED", "Cannot resume: the DeepSeek Harness session handle is empty or not a file.", { sessionFile: resolved });
+        }
+        const raw = await readFile(resolved, "utf8");
+        const sessionId = readDshSessionHandle(raw);
+        if (!sessionId) {
+            throw new SupervisorError("UNSUPPORTED", "Cannot resume: the DeepSeek Harness session handle does not contain an ACP session id.", { sessionFile: resolved });
+        }
+        await ensureDir(spec.sessionDir);
+        return DshAcpSession.start({
+            launch: this.launchFor(spec),
+            cwd: spec.cwd,
+            sessionDir: spec.sessionDir,
+            model: spec.model,
+            provider: spec.provider,
+            thinking: spec.thinking,
+            callbacks,
+            resumeSessionId: sessionId,
+            onStderr: this.options.onStderr
+                ? (text) => this.options.onStderr?.(spec.workerId, text)
+                : undefined,
+            onDiagnostic: this.options.onDiagnostic
+                ? (text) => this.options.onDiagnostic?.(spec.workerId, text)
+                : undefined,
+            requestTimeoutMs: this.options.requestTimeoutMs,
+            abortTimeoutMs: this.options.abortTimeoutMs,
+        });
+    }
+    validateTools(spec) {
+        if (spec.tools && spec.tools.length > 0) {
+            throw new SupervisorError("UNSUPPORTED", "DeepSeek Harness ACP exposes no tool allowlist; tools cannot be restricted per worker.", { tools: spec.tools });
+        }
+    }
+    resolveLaunch() {
+        if (!this.launch) {
+            this.launch = this.options.launch ?? resolveDshLaunch();
+        }
+        return this.launch;
+    }
+    resolvePermissionMode() {
+        if (!this.permissionMode) {
+            this.permissionMode = this.options.permissionMode ?? resolveDshPermissionMode();
+        }
+        return this.permissionMode;
+    }
+    /** Per-worker environment (command guard, worker id) never mutates the daemon env. */
+    launchFor(spec) {
+        const base = this.resolveLaunch();
+        const env = { ...base.env, ...(spec.env ?? {}) };
+        // DSH reads this at profile boot; there is no ACP setter for it. Always
+        // write the resolved value so the child cannot silently drift from the
+        // daemon-level setting.
+        env.DSH_PERMISSION_MODE = this.resolvePermissionMode();
+        return { ...base, env };
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/adapters/dsh/adapter.js.map

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

package/dist/src/adapters/dsh/config.d.ts

@@ -0,0 +1,39 @@
+export interface DshConfigChoice {
+    value?: string;
+    name?: string;
+}
+export interface DshConfigOption {
+    id?: string;
+    name?: string;
+    value?: string;
+    currentValue?: string;
+    options?: DshConfigOption[];
+}
+interface FlatChoice {
+    value: string;
+    name: string;
+}
+/**
+ * DSH groups model choices by provider (`options[].options[]`), while
+ * reasoning_effort is a flat list. Flatten both without assuming a fixed
+ * nesting depth.
+ */
+export declare function flattenDshChoices(option: DshConfigOption | undefined): FlatChoice[];
+export declare function findDshConfigOption(configOptions: DshConfigOption[] | undefined, id: string): DshConfigOption | undefined;
+/**
+ * Resolves the model config value DSH expects: a JSON pair of
+ * `[provider, model]`. The caller may pass a display name or the model id.
+ * An ambiguous display name (the same model is offered by two providers)
+ * fails instead of guessing a provider.
+ */
+export declare function resolveDshModelValue(configOptions: DshConfigOption[] | undefined, selection: {
+    model?: string;
+    provider?: string;
+}): string | undefined;
+/**
+ * DSH exposes four reasoning levels. HS keeps the shared seven-level Pi
+ * vocabulary and folds the levels DSH does not have.
+ */
+export declare function mapDshThinking(level: string): "off" | "low" | "high" | "max";
+export declare function resolveDshReasoningValue(configOptions: DshConfigOption[] | undefined, thinking: string | undefined): string | undefined;
+export {};

package/dist/src/adapters/dsh/config.js

@@ -0,0 +1,118 @@
+import { SupervisorError } from "../../errors.js";
+/**
+ * DSH groups model choices by provider (`options[].options[]`), while
+ * reasoning_effort is a flat list. Flatten both without assuming a fixed
+ * nesting depth.
+ */
+export function flattenDshChoices(option) {
+    if (!option)
+        return [];
+    const out = [];
+    const visit = (nodes) => {
+        for (const node of nodes ?? []) {
+            if (typeof node.value === "string") {
+                out.push({
+                    value: node.value,
+                    name: typeof node.name === "string" ? node.name : node.value,
+                });
+            }
+            visit(node.options);
+        }
+    };
+    visit(option.options);
+    return out;
+}
+export function findDshConfigOption(configOptions, id) {
+    return configOptions?.find((option) => option.id === id);
+}
+function parseModelValue(value) {
+    try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed) &&
+            parsed.length === 2 &&
+            typeof parsed[0] === "string" &&
+            typeof parsed[1] === "string") {
+            return [parsed[0], parsed[1]];
+        }
+    }
+    catch {
+        // Older or unexpected choices may not be JSON pairs.
+    }
+    return null;
+}
+function describeModelChoices(choices) {
+    const names = choices.slice(0, 12).map((choice) => {
+        const pair = parseModelValue(choice.value);
+        return pair ? `${pair[0]}/${pair[1]}` : choice.name;
+    });
+    const suffix = choices.length > names.length ? ", ..." : "";
+    return `${names.join(", ")}${suffix}`;
+}
+/**
+ * Resolves the model config value DSH expects: a JSON pair of
+ * `[provider, model]`. The caller may pass a display name or the model id.
+ * An ambiguous display name (the same model is offered by two providers)
+ * fails instead of guessing a provider.
+ */
+export function resolveDshModelValue(configOptions, selection) {
+    const option = findDshConfigOption(configOptions, "model");
+    const choices = flattenDshChoices(option);
+    if (selection.provider && !selection.model) {
+        throw new SupervisorError("BAD_REQUEST", "DSH model selection needs both provider and model; provider alone cannot identify a model.", { provider: selection.provider });
+    }
+    if (!selection.model)
+        return undefined;
+    if (choices.length === 0) {
+        throw new SupervisorError("UNSUPPORTED", "DSH did not advertise a model config option.");
+    }
+    const matches = choices.filter((choice) => {
+        const pair = parseModelValue(choice.value);
+        const modelMatches = choice.name === selection.model || pair?.[1] === selection.model;
+        if (!modelMatches)
+            return false;
+        return selection.provider ? pair?.[0] === selection.provider : true;
+    });
+    if (matches.length === 0) {
+        throw new SupervisorError("BAD_REQUEST", `DSH does not offer model "${selection.model}"${selection.provider ? ` from provider "${selection.provider}"` : ""}. Available: ${describeModelChoices(choices)}.`, { model: selection.model, provider: selection.provider });
+    }
+    if (matches.length > 1) {
+        throw new SupervisorError("BAD_REQUEST", `DSH offers model "${selection.model}" from more than one provider. Set provider explicitly.`, { model: selection.model, matches: matches.map((choice) => choice.value) });
+    }
+    return matches[0].value;
+}
+/**
+ * DSH exposes four reasoning levels. HS keeps the shared seven-level Pi
+ * vocabulary and folds the levels DSH does not have.
+ */
+export function mapDshThinking(level) {
+    switch (level) {
+        case "off":
+            return "off";
+        case "minimal":
+        case "low":
+            return "low";
+        case "medium":
+        case "high":
+            return "high";
+        case "xhigh":
+        case "max":
+            return "max";
+        default:
+            throw new SupervisorError("BAD_REQUEST", `Unsupported thinking level: ${level}`);
+    }
+}
+export function resolveDshReasoningValue(configOptions, thinking) {
+    if (!thinking)
+        return undefined;
+    const option = findDshConfigOption(configOptions, "reasoning_effort");
+    if (!option) {
+        throw new SupervisorError("UNSUPPORTED", "DSH did not advertise a reasoning_effort option for this model; thinking cannot be applied.", { thinking });
+    }
+    const mapped = mapDshThinking(thinking);
+    const available = flattenDshChoices(option).map((choice) => choice.value);
+    if (!available.includes(mapped)) {
+        throw new SupervisorError("UNSUPPORTED", `DSH does not offer reasoning_effort "${mapped}". Available: ${available.join(", ")}.`, { thinking, mapped });
+    }
+    return mapped;
+}
+//# sourceMappingURL=config.js.map