@wjarka/cezarion 0.10.0-pr30.54

package/dist/core/opencode-model-catalog.js

@@ -0,0 +1,153 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import { trackChildExit } from './agent-runner.js';
+import { buildChildEnv } from './agent-env.js';
+const DEFAULT_DISCOVERY_TIMEOUT_MS = 10_000;
+/** Grace between the probe's SIGTERM and the SIGKILL that follows it. */
+export const KILL_GRACE_MS = 2_000;
+const MAX_MODELS = 500;
+/** Defensive cap on what we buffer from a misbehaving child (characters of stdout). */
+const MAX_OUTPUT_CHARS = 512 * 1_024;
+/**
+ * One `provider/model` id per line — the shape `opencode models` prints (#794). Deliberately
+ * strict: anything else (a banner, a prompt, a stack trace, a bare model name that OpenCode
+ * could not route) is NOT a model id, and silently turning it into a picker entry would
+ * recreate the very defect this replaces.
+ */
+const MODEL_LINE_RE = /^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._:/-]*$/i;
+/** SGR/CSI sequences, in case a future CLI colorizes even a piped stdout. */
+const ANSI_RE = /\u001B\[[0-9;]*[A-Za-z]/g;
+/** The host binary, resolved exactly like `OpencodeServerRunner` and the backend probe. */
+export function resolveOpencodeExecutable(bin) {
+    return bin ?? process.env.CEZ_OPENCODE_BIN ?? 'opencode';
+}
+/**
+ * Discover the models the host's own OpenCode installation offers, by asking it: `opencode
+ * models` lists every `provider/model` id the configured providers expose, which is the same
+ * list OpenCode's own picker routes to.
+ *
+ * Best-effort by contract — `RunnerModelCatalog` turns any throw here into a cached or
+ * `unavailable` answer, and `auto` stays selectable either way. No config is read or written,
+ * no session is started; the child is short-lived and bounded by a deadline, a stdout cap and
+ * a model cap.
+ */
+export async function discoverOpencodeModels(options) {
+    const bin = resolveOpencodeExecutable(options.bin);
+    const args = ['models'];
+    const child = (options.spawn ?? spawnOpencode)(bin, args, options.cwd);
+    const kill = teardown(child);
+    const timeoutMs = options.timeoutMs ?? DEFAULT_DISCOVERY_TIMEOUT_MS;
+    let timeout;
+    try {
+        return await new Promise((resolve, reject) => {
+            let stdout = '';
+            let overflowed = false;
+            const fail = (message) => {
+                reject(new Error(message));
+                kill();
+            };
+            timeout = setTimeout(() => fail('OpenCode model discovery timed out'), timeoutMs);
+            timeout.unref?.();
+            child.stdout.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => {
+                if (overflowed)
+                    return;
+                stdout += chunk;
+                if (stdout.length > MAX_OUTPUT_CHARS) {
+                    overflowed = true;
+                    fail('OpenCode model discovery exceeded the output limit');
+                }
+            });
+            // Drained but ignored: OpenCode prints provider warnings here, and an unread pipe would
+            // eventually stall the child.
+            child.stderr.resume();
+            child.once('error', () => fail('OpenCode model discovery child failed'));
+            child.once('close', (code) => {
+                if (overflowed)
+                    return;
+                if (code !== 0) {
+                    fail(`OpenCode model discovery child exited (${code ?? 'unknown'})`);
+                    return;
+                }
+                try {
+                    resolve(parseOpencodeModels(stdout));
+                }
+                catch (error) {
+                    reject(error instanceof Error ? error : new Error(String(error)));
+                }
+            });
+        });
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+        kill();
+    }
+}
+/**
+ * Turn `opencode models` output into picker options, preserving OpenCode's own order.
+ *
+ * Empty output is a legitimate answer (no provider configured yet) and yields no models, so the
+ * picker shows `auto` alone. Output that contains lines but NO recognizable id is treated as a
+ * failure instead: the CLI said something we cannot read, and reporting "unavailable" is more
+ * honest than an empty catalog that looks like "you have no models".
+ */
+export function parseOpencodeModels(stdout) {
+    const lines = stdout
+        .replace(ANSI_RE, '')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    const models = [];
+    const ids = new Set();
+    for (const line of lines) {
+        if (!MODEL_LINE_RE.test(line) || ids.has(line))
+            continue;
+        if (models.length >= MAX_MODELS)
+            throw new Error('OpenCode model discovery exceeded the size limit');
+        ids.add(line);
+        const provider = line.slice(0, line.indexOf('/'));
+        models.push({ id: line, label: line, description: `via ${provider}` });
+    }
+    if (models.length === 0 && lines.length > 0) {
+        throw new Error('OpenCode model discovery returned unrecognized output');
+    }
+    return models;
+}
+function spawnOpencode(bin, args, cwd) {
+    const child = nodeSpawn(bin, [...args], {
+        cwd,
+        env: buildChildEnv({ backend: 'opencode' }),
+    });
+    // Nothing is ever written to it, and an open stdin is what makes a CLI that expects a TTY
+    // sit and wait instead of printing its list.
+    child.stdin.end();
+    return child;
+}
+/**
+ * Returns the probe's teardown: SIGTERM now, SIGKILL once the grace window elapses.
+ *
+ * Both steps gate on the child's *real* termination, never on `child.killed` — Node flips that
+ * flag the moment a signal is delivered, so the old `exitCode === null && !child.killed` test
+ * went false the instant our own SIGTERM landed. A probe that installs a SIGTERM handler then
+ * survived every teardown, leaking one process per cache refresh (#858, the shape #841 fixed for
+ * the Claude probe in `a67b327d`).
+ *
+ * Called from both the failure path and the `finally`, so the escalation is armed at most once.
+ */
+function teardown(child) {
+    const hasExited = trackChildExit(child);
+    let signalled = false;
+    return () => {
+        if (signalled || hasExited())
+            return;
+        signalled = true;
+        child.kill('SIGTERM');
+        const escalation = setTimeout(() => {
+            if (hasExited())
+                return;
+            child.kill('SIGKILL');
+        }, KILL_GRACE_MS);
+        escalation.unref?.();
+    };
+}
+//# sourceMappingURL=opencode-model-catalog.js.map

package/dist/core/opencode-model-catalog.js.map

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

package/dist/core/opencode-server-runner.d.ts

@@ -0,0 +1,32 @@
+import type { AgentEvent, AgentRunResult, AgentRunSpec, AgentRunner } from './agent-runner.ts';
+import type { AgentSession, SessionOptions } from './agent-runner.ts';
+export interface OpencodeRunnerOptions {
+    /** Override the binary name/path; defaults to `opencode` on PATH. */
+    bin?: string;
+    /** Wall-clock timeout for a run (ms); per-spec `timeoutMs` still wins. */
+    timeoutMs?: number;
+}
+/** Grace between the teardown SIGTERM and the SIGKILL that follows it. */
+export declare const KILL_GRACE_MS = 4000;
+/**
+ * `AgentRunner` over `opencode serve` — a headless HTTP server (the same one
+ * the opencode TUI talks to) with an SSE event stream. One server per session,
+ * bound to the run's `cwd` (worktree), gives OpenCode the same multi-turn shape
+ * as the Claude runner: each `sendMessage` posts another prompt to the same
+ * session (history is kept server-side), `session/abort` cancels, and reusing
+ * the session id resumes for "Continue".
+ *
+ * Auth = the host's opencode config/logins. The agent runs autonomously
+ * (auto-approved permissions); OpenCode has no per-tool allowlist, so
+ * `spec.allowedTools` is ignored. `spec.model` is `provider/model`.
+ */
+export declare class OpencodeServerRunner implements AgentRunner {
+    readonly backend: 'opencode';
+    private readonly bin;
+    private readonly timeoutMs;
+    private lastSession;
+    constructor(opts?: OpencodeRunnerOptions);
+    run(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void): Promise<AgentRunResult>;
+    interrupt(): Promise<void>;
+    startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
+}