@aitne/daemon 0.1.6 → 0.1.8

package/dist/core/backends/opencode-mcp.js

@@ -0,0 +1,165 @@
+/**
+ * docs/design/appendices/opencode-backend.md §5.1 / §5.6 / §6.x — render the daemon's
+ * `McpServer` rows into `OpencodeRuntimeConfig.mcp`.
+ *
+ * Unlike Claude / Codex / Gemini which read on-disk MCP config files
+ * (`.mcp.json`, `.codex/config.toml`, `.gemini/settings.json`),
+ * OpenCode receives MCP config inline via `OPENCODE_CONFIG_CONTENT`
+ * consumed at server-spawn time (§5.1). The daemon therefore produces
+ * the `Record<string, McpLocalConfig | McpRemoteConfig>` map directly
+ * instead of writing a file under the session workdir.
+ *
+ * Pure function — DB / blob-store access happens upstream in
+ * `materializeMcpForSession`'s sibling caller. The renderer takes the
+ * already-filtered server list + resolved secrets and produces:
+ *   - `mcp`: the runtime-config map.
+ *   - `env`: env vars the spawned `opencode serve` process must export
+ *     so the `environment` placeholders resolve at MCP-spawn time.
+ *     OpenCode does NOT do `${VAR}` expansion on stdio env values
+ *     (V7 fixture), so we inline concrete values into `environment` —
+ *     `env` stays empty for stdio servers. For remote servers, header
+ *     values are inlined directly into the `headers` map.
+ *   - `warnings`: server-name lint failures (`_`-containing ids) and
+ *     unsupported-transport notices. Surfaced via dashboard.
+ *
+ * Server-name lint (§5.6): the documented mangling rule
+ *   `mcp__<server>__<tool>` → `<server>_<tool>`
+ * is ambiguous when `<server>` contains `_`. Until the SDK exposes
+ * MCP tool ids (V7 deferred), we reject `_`-containing server names at
+ * config-build time so the daemon never produces a config whose
+ * server→tool boundary cannot be reconstructed.
+ */
+import { createLogger } from "../../logging.js";
+const logger = createLogger("opencode-mcp");
+/**
+ * V5/§5.6 server-name lint. Returns null when the id is acceptable,
+ * otherwise a human-readable reason that explains why the server was
+ * dropped. Mirrors Codex's stricter `lowercase + dash only` rule
+ * extended with the opencode-specific `_` prohibition.
+ */
+export function isAcceptableOpencodeServerName(id) {
+    return /^[a-z0-9][a-z0-9-]*$/.test(id);
+}
+function joinCommand(server) {
+    const cmd = server.command?.trim();
+    if (!cmd)
+        return [];
+    const argv = server.args ? server.args.filter((a) => typeof a === "string") : [];
+    return [cmd, ...argv];
+}
+/**
+ * Render the stdio-transport variant: opencode treats every entry in
+ * `command` as one argv element (it does not run through a shell). We
+ * pass `environment` inline because opencode's stdio launcher does NOT
+ * expand `${VAR}` references at runtime (V7).
+ */
+function renderLocal(server, secrets, defaultTimeoutMs) {
+    const command = joinCommand(server);
+    if (command.length === 0)
+        return null;
+    const environment = {};
+    for (const key of server.envKeys) {
+        const raw = secrets[`${server.id}:${key}`];
+        if (raw !== undefined)
+            environment[key] = raw;
+    }
+    const local = {
+        type: "local",
+        command,
+        enabled: true,
+    };
+    if (Object.keys(environment).length > 0)
+        local.environment = environment;
+    if (typeof defaultTimeoutMs === "number" && defaultTimeoutMs > 0) {
+        local.timeout = defaultTimeoutMs;
+    }
+    return local;
+}
+/**
+ * Render http / sse transport. The SDK's `McpRemoteConfig` does not
+ * distinguish — both flow through the same shape; opencode's remote
+ * dispatcher negotiates transport. Header values are inlined.
+ */
+function renderRemote(server, secrets, defaultTimeoutMs) {
+    if (!server.url)
+        return null;
+    const headers = {};
+    for (const key of server.headerKeys) {
+        const raw = secrets[`${server.id}:${key}`];
+        if (raw !== undefined)
+            headers[key] = raw;
+    }
+    const remote = {
+        type: "remote",
+        url: server.url,
+        enabled: true,
+    };
+    if (Object.keys(headers).length > 0)
+        remote.headers = headers;
+    if (typeof defaultTimeoutMs === "number" && defaultTimeoutMs > 0) {
+        remote.timeout = defaultTimeoutMs;
+    }
+    return remote;
+}
+/**
+ * Main entry point. Pure — no I/O, deterministic given the same input.
+ *
+ * Servers whose name fails the lint OR whose required transport field
+ * is missing (stdio without command, http/sse without url) are dropped
+ * with a warning. The daemon then proceeds without that server — same
+ * fail-soft posture as the Claude / Codex / Gemini generators.
+ */
+export function renderOpencodeMcp(input) {
+    const mcp = {};
+    const warnings = [];
+    for (const server of input.servers) {
+        if (!server.enabled)
+            continue;
+        if (!isAcceptableOpencodeServerName(server.id)) {
+            warnings.push(`opencode-mcp: server '${server.id}' rejected — opencode-mangled tool ids (mcp__<server>__<tool> → <server>_<tool>) become ambiguous when the server id contains '_'. Rename to lowercase kebab-case.`);
+            continue;
+        }
+        if (server.transport === "stdio") {
+            const local = renderLocal(server, input.secrets, input.defaultTimeoutMs);
+            if (!local) {
+                warnings.push(`opencode-mcp: stdio server '${server.id}' has no 'command'; skipped`);
+                continue;
+            }
+            mcp[server.id] = local;
+            continue;
+        }
+        /* c8 ignore start — McpTransport is closed-set; the http/sse branch
+           always covers the remaining transports after the stdio early-return
+           above, so the false-branch + unknown fallthrough below are
+           unreachable unless a future transport ships without updating the
+           renderer. */
+        if (server.transport === "http" || server.transport === "sse") {
+            /* c8 ignore stop */
+            const remote = renderRemote(server, input.secrets, input.defaultTimeoutMs);
+            if (!remote) {
+                warnings.push(`opencode-mcp: ${server.transport} server '${server.id}' has no 'url'; skipped`);
+                continue;
+            }
+            mcp[server.id] = remote;
+            continue;
+        }
+        /* c8 ignore start — see note above. */
+        const unknown = server.transport;
+        warnings.push(`opencode-mcp: unsupported transport '${String(unknown)}' for server '${server.id}'`);
+    }
+    /* c8 ignore stop */
+    if (Object.keys(mcp).length > 0) {
+        logger.debug({ serverIds: Object.keys(mcp), warningCount: warnings.length }, "rendered opencode mcp map");
+    }
+    return {
+        mcp,
+        // OpenCode's `environment` map already carries inlined values for
+        // stdio servers, and `headers` for remote servers, so no separate
+        // env vector needs to flow into the spawn env. Reserved here so a
+        // future opencode version that supports `${VAR}` expansion can fill
+        // this in without a signature change.
+        env: {},
+        warnings,
+    };
+}
+//# sourceMappingURL=opencode-mcp.js.map

package/dist/core/backends/opencode-mcp.js.map

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

package/dist/core/backends/opencode-server-manager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * docs/design/appendices/opencode-backend.md §5.1 / §6.4 — server lifecycle manager.
+ *
+ * Phase 2 ships only the Managed implementation: one long-lived
+ * `opencode serve` child process per backend slot, with config-diff
+ * triggered bounce. The Remote implementation lands in Phase 5; Phase 2
+ * exposes the interface so wiring is stable.
+ *
+ * Concurrency model: a single `BackendRouter` slot is serialised by the
+ * router's per-backend in-flight gate. Within that gate `ensureConfig`
+ * may block on a bounce, then `client()` returns the live SDK client.
+ * `shutdown()` is wired into `ObserverManager` so graceful daemon exit
+ * stops the child process and releases the loopback port.
+ */
+import { createOpencode, type OpencodeClient } from "@opencode-ai/sdk";
+import type { OpencodeRuntimeConfig } from "@aitne/shared";
+export type OpencodeServerMode = "managed" | "remote";
+/**
+ * docs/design/appendices/opencode-backend.md §5.9 / Phase 4 — handle to a short-lived
+ * isolated server spawned for one tight-permission task. Caller is
+ * responsible for `close()`-ing it in a `finally` so the loopback port
+ * is released even when the inner work throws.
+ */
+export interface EphemeralOpencodeServerHandle {
+    client: OpencodeClient;
+    close: () => Promise<void>;
+}
+export interface OpencodeServerManager {
+    readonly mode: OpencodeServerMode;
+    /**
+     * Ensure the underlying server is running with `desiredConfig`.
+     * Managed: bounces when the canonical-hash of the desired config
+     * differs from the running server's hash. Idempotent on same input.
+     * Remote: no-op in Phase 5+.
+     */
+    ensureConfig(desiredConfig: OpencodeRuntimeConfig): Promise<void>;
+    /** Resolve the live SDK client. Lazily spawns the server on first call. */
+    client(): Promise<OpencodeClient>;
+    /**
+     * docs/design/appendices/opencode-backend.md §5.9 Path A — spawn an isolated ephemeral
+     * server for a single tight-permission task. Used by
+     * `runDelegatedTask` when the operator opts into `isolation: "ephemeral"`
+     * (rare path: operator-supplied MCP context the primary server's
+     * connections cannot be trusted with). Returns an
+     * {@link EphemeralOpencodeServerHandle} the caller MUST close in
+     * `finally` to release the loopback port.
+     *
+     * Managed: spawns a fresh `createOpencode()` independent of the
+     * long-lived primary server's state. Remote: throws — Path A is
+     * unavailable on a server the daemon does not own.
+     */
+    spawnEphemeral(config: OpencodeRuntimeConfig): Promise<EphemeralOpencodeServerHandle>;
+    /** Stop the server child process and release resources. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Hash a desired `OpencodeRuntimeConfig` deterministically so two
+ * equivalent configs (regardless of key ordering or undefined fields)
+ * produce the same hash. Reused for bounce-vs-noop decision.
+ */
+export declare function hashRuntimeConfig(config: OpencodeRuntimeConfig): string;
+export interface ManagedOpencodeServerManagerOptions {
+    /** Loopback host. Default `127.0.0.1`. */
+    hostname?: string;
+    /** Port. `0` ⇒ OS chooses. Default `0`. */
+    port?: number;
+    /** Cold-start timeout per spawn (ms). Default 15 000. */
+    spawnTimeoutMs?: number;
+    /**
+     * Inject the SDK's `createOpencode` for tests. Production code wires
+     * this to the real export. The wrapper signature matches the real
+     * SDK so the production path is type-safe.
+     */
+    createOpencodeImpl?: typeof createOpencode;
+}
+/**
+ * Managed-mode lifecycle. Owns a single child process; bounces on
+ * config-diff.
+ *
+ * Crash recovery: V6 fixtures show `server.close()` is synchronous and
+ * does not throw on a stopped process. The manager treats a missing /
+ * already-stopped server as "respawn on next ensureConfig". We don't
+ * subscribe to `child_process` signals here because the SDK abstracts
+ * them away; the next inbound `ensureConfig` will pay the cost of
+ * detection if the server died.
+ */
+export declare class ManagedOpencodeServerManager implements OpencodeServerManager {
+    readonly mode: "managed";
+    private state;
+    /** Coalesce concurrent ensureConfig / client calls onto a single spawn. */
+    private inflight;
+    private readonly hostname;
+    private readonly port;
+    private readonly spawnTimeoutMs;
+    private readonly createOpencodeImpl;
+    private shutdownRequested;
+    constructor(options?: ManagedOpencodeServerManagerOptions);
+    ensureConfig(desiredConfig: OpencodeRuntimeConfig): Promise<void>;
+    client(): Promise<OpencodeClient>;
+    spawnEphemeral(config: OpencodeRuntimeConfig): Promise<EphemeralOpencodeServerHandle>;
+    shutdown(): Promise<void>;
+    /** Lifecycle introspection — useful for diagnostics and tests. */
+    get isRunning(): boolean;
+    get currentHash(): string | null;
+    private spawn;
+    private doSpawn;
+}
+/**
+ * Phase 2 factory: only the Managed variant exists today. Phase 5 adds
+ * a `RemoteOpencodeServerManager` branch keyed on a runtime setting.
+ * The factory contract keeps callers backend-shape-agnostic.
+ */
+export declare function createOpencodeServerManager(options?: ManagedOpencodeServerManagerOptions): OpencodeServerManager;
+//# sourceMappingURL=opencode-server-manager.d.ts.map

package/dist/core/backends/opencode-server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-server-manager.d.ts","sourceRoot":"","sources":["../../../src/core/backends/opencode-server-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,cAAc,EAEd,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAa3D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,YAAY,CAAC,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,2EAA2E;IAC3E,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC;;;;;;;;;;;;OAYG;IACH,cAAc,CACZ,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,2DAA2D;IAC3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAIvE;AAiBD,MAAM,WAAW,mCAAmC;IAClD,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,cAAc,CAAC;CAC5C;AAUD;;;;;;;;;;GAUG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IACxE,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,KAAK,CAA4B;IACzC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwB;IAC3D,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,GAAE,mCAAwC;IAOvD,YAAY,CAAC,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAYjC,cAAc,CAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,6BAA6B,CAAC;IAqCnC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B,kEAAkE;IAClE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;YAEa,KAAK;YAqBL,OAAO;CAsDtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,mCAAwC,GAChD,qBAAqB,CAEvB"}

package/dist/core/backends/opencode-server-manager.js

@@ -0,0 +1,222 @@
+/**
+ * docs/design/appendices/opencode-backend.md §5.1 / §6.4 — server lifecycle manager.
+ *
+ * Phase 2 ships only the Managed implementation: one long-lived
+ * `opencode serve` child process per backend slot, with config-diff
+ * triggered bounce. The Remote implementation lands in Phase 5; Phase 2
+ * exposes the interface so wiring is stable.
+ *
+ * Concurrency model: a single `BackendRouter` slot is serialised by the
+ * router's per-backend in-flight gate. Within that gate `ensureConfig`
+ * may block on a bounce, then `client()` returns the live SDK client.
+ * `shutdown()` is wired into `ObserverManager` so graceful daemon exit
+ * stops the child process and releases the loopback port.
+ */
+import { createHash } from "node:crypto";
+import { createOpencode, } from "@opencode-ai/sdk";
+import { stableStringify } from "@aitne/shared";
+import { createLogger } from "../../logging.js";
+const logger = createLogger("opencode-server-manager");
+/** Default cold-start budget — V6 measured p95 ≈ 1222 ms; 15 s headroom
+ *  for slow CI hosts and the rare MCP-bound bounce. */
+const DEFAULT_SPAWN_TIMEOUT_MS = 15_000;
+/** Default loopback bind. Port 0 lets the OS pick a free port; the SDK
+ *  echoes the chosen URL back so we never need to probe externally. */
+const DEFAULT_HOSTNAME = "127.0.0.1";
+/**
+ * Hash a desired `OpencodeRuntimeConfig` deterministically so two
+ * equivalent configs (regardless of key ordering or undefined fields)
+ * produce the same hash. Reused for bounce-vs-noop decision.
+ */
+export function hashRuntimeConfig(config) {
+    // Drop `undefined` so { a: undefined } and {} canonicalise equal.
+    const canonical = stableStringify(stripUndefined(config));
+    return createHash("sha256").update(canonical).digest("hex");
+}
+function stripUndefined(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => stripUndefined(item));
+    }
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (v === undefined)
+                continue;
+            out[k] = stripUndefined(v);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Managed-mode lifecycle. Owns a single child process; bounces on
+ * config-diff.
+ *
+ * Crash recovery: V6 fixtures show `server.close()` is synchronous and
+ * does not throw on a stopped process. The manager treats a missing /
+ * already-stopped server as "respawn on next ensureConfig". We don't
+ * subscribe to `child_process` signals here because the SDK abstracts
+ * them away; the next inbound `ensureConfig` will pay the cost of
+ * detection if the server died.
+ */
+export class ManagedOpencodeServerManager {
+    mode = "managed";
+    state = null;
+    /** Coalesce concurrent ensureConfig / client calls onto a single spawn. */
+    inflight = null;
+    hostname;
+    port;
+    spawnTimeoutMs;
+    createOpencodeImpl;
+    shutdownRequested = false;
+    constructor(options = {}) {
+        this.hostname = options.hostname ?? DEFAULT_HOSTNAME;
+        this.port = options.port ?? 0;
+        this.spawnTimeoutMs = options.spawnTimeoutMs ?? DEFAULT_SPAWN_TIMEOUT_MS;
+        this.createOpencodeImpl = options.createOpencodeImpl ?? createOpencode;
+    }
+    async ensureConfig(desiredConfig) {
+        if (this.shutdownRequested) {
+            throw new Error("OpencodeServerManager has been shut down");
+        }
+        const desiredHash = hashRuntimeConfig(desiredConfig);
+        if (this.state && this.state.runningHash === desiredHash) {
+            return;
+        }
+        await this.spawn(desiredConfig, desiredHash);
+    }
+    async client() {
+        if (this.shutdownRequested) {
+            throw new Error("OpencodeServerManager has been shut down");
+        }
+        if (!this.state) {
+            // Lazy first-spawn with an empty config — callers that want
+            // specific config should call ensureConfig() first.
+            await this.spawn({}, hashRuntimeConfig({}));
+        }
+        return this.state.client;
+    }
+    async spawnEphemeral(config) {
+        if (this.shutdownRequested) {
+            throw new Error("OpencodeServerManager has been shut down");
+        }
+        const abortController = new AbortController();
+        const timeoutId = setTimeout(() => abortController.abort(new Error("opencode ephemeral spawn timeout")), this.spawnTimeoutMs);
+        const start = Date.now();
+        try {
+            const { client, server } = await this.createOpencodeImpl({
+                hostname: this.hostname,
+                port: 0,
+                signal: abortController.signal,
+                timeout: this.spawnTimeoutMs,
+                config: config,
+            });
+            logger.info({ url: server.url, spawnMs: Date.now() - start, ephemeral: true }, "opencode ephemeral server spawned");
+            return {
+                client,
+                close: async () => {
+                    try {
+                        server.close();
+                    }
+                    catch (err) {
+                        logger.warn({ err }, "opencode ephemeral server close threw");
+                    }
+                },
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async shutdown() {
+        this.shutdownRequested = true;
+        if (this.state) {
+            const { server } = this.state;
+            try {
+                server.close();
+            }
+            catch (err) {
+                logger.warn({ err }, "opencode server close threw");
+            }
+            this.state = null;
+        }
+    }
+    /** Lifecycle introspection — useful for diagnostics and tests. */
+    get isRunning() {
+        return this.state !== null;
+    }
+    get currentHash() {
+        return this.state?.runningHash ?? null;
+    }
+    async spawn(config, hash) {
+        // Coalesce concurrent spawn attempts so a flurry of ensureConfig
+        // calls (e.g. on first boot) doesn't fire multiple child processes.
+        if (this.inflight) {
+            const state = await this.inflight;
+            if (state.runningHash === hash)
+                return state;
+            // Different hash — fall through to bounce.
+        }
+        const spawnPromise = this.doSpawn(config, hash);
+        this.inflight = spawnPromise;
+        try {
+            const state = await spawnPromise;
+            return state;
+        }
+        finally {
+            this.inflight = null;
+        }
+    }
+    async doSpawn(config, hash) {
+        if (this.state) {
+            const previousHash = this.state.runningHash;
+            const ageMs = Date.now() - this.state.spawnedAt;
+            try {
+                this.state.server.close();
+            }
+            catch (err) {
+                logger.warn({ err }, "opencode server close threw during bounce");
+            }
+            this.state = null;
+            logger.info({ previousHash: previousHash.slice(0, 12), newHash: hash.slice(0, 12), ageMs }, "opencode server bounced");
+        }
+        const abortController = new AbortController();
+        const timeoutId = setTimeout(() => abortController.abort(new Error("opencode spawn timeout")), this.spawnTimeoutMs);
+        const start = Date.now();
+        try {
+            const { client, server } = await this.createOpencodeImpl({
+                hostname: this.hostname,
+                port: this.port,
+                signal: abortController.signal,
+                timeout: this.spawnTimeoutMs,
+                config: config,
+            });
+            const next = {
+                client,
+                server,
+                runningHash: hash,
+                config,
+                spawnedAt: Date.now(),
+            };
+            this.state = next;
+            logger.info({
+                url: server.url,
+                hash: hash.slice(0, 12),
+                spawnMs: Date.now() - start,
+            }, "opencode server spawned");
+            return next;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Phase 2 factory: only the Managed variant exists today. Phase 5 adds
+ * a `RemoteOpencodeServerManager` branch keyed on a runtime setting.
+ * The factory contract keeps callers backend-shape-agnostic.
+ */
+export function createOpencodeServerManager(options = {}) {
+    return new ManagedOpencodeServerManager(options);
+}
+//# sourceMappingURL=opencode-server-manager.js.map

package/dist/core/backends/opencode-server-manager.js.map

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

package/dist/core/backends/opencode-types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * docs/design/appendices/opencode-backend.md §6.1.0 — local module augmentation + helper
+ * types for the four undeclared surfaces that V3/V4/V9 confirmed exist
+ * at runtime in opencode 1.14.50 but are missing from the SDK's
+ * generated types.
+ *
+ * The `declare module "@opencode-ai/sdk"` block adds the three runtime
+ * fields the SDK omits (format on the prompt body, structured on the
+ * assistant message, total on the token block). The helper types below
+ * widen the event union so we never compile against the SDK's
+ * incomplete `EventSubscribeResponse`.
+ */
+declare module "@opencode-ai/sdk" {
+    interface SessionPromptBodyAugmented {
+        format?: {
+            type: "json_schema";
+            schema: object;
+            retryCount?: number;
+        };
+    }
+    interface AssistantMessageAugmented {
+        structured?: unknown;
+    }
+    interface AssistantTokensAugmented {
+        total?: number;
+    }
+}
+/**
+ * V9-grounded event-input type. The SDK's generated
+ * `EventSubscribeResponse` union is **incomplete** (server.heartbeat,
+ * permission.asked emit but are not declared) and over-promises
+ * (permission.replied, message.part.updated declared but never observed).
+ * Defensive code therefore widens to a plain string-key dispatch.
+ */
+export type RawOpencodeEvent = {
+    type: string;
+    properties?: unknown;
+};
+/**
+ * Helper for callers that want to thread the structured-output (`format`)
+ * option through `client.session.prompt({ body: … })`. The SDK's body
+ * type does not list `format`, but the runtime accepts and honors it
+ * (V4). Pass the resulting object to the SDK call via a single cast.
+ */
+export type OpencodeAugmentedPromptBody = import("@opencode-ai/sdk").SessionPromptData["body"] & Partial<import("@opencode-ai/sdk").SessionPromptBodyAugmented>;
+//# sourceMappingURL=opencode-types.d.ts.map

package/dist/core/backends/opencode-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-types.d.ts","sourceRoot":"","sources":["../../../src/core/backends/opencode-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAiB,0BAA0B;QACzC,MAAM,CAAC,EAAE;YACP,IAAI,EAAE,aAAa,CAAC;YACpB,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH;IAED,UAAiB,yBAAyB;QACxC,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB;IAED,UAAiB,wBAAwB;QACvC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;CACF;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GACrC,OAAO,kBAAkB,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC,OAAO,kBAAkB,EAAE,0BAA0B,CAAC,CAAC"}

package/dist/core/backends/opencode-types.js

@@ -0,0 +1,14 @@
+/**
+ * docs/design/appendices/opencode-backend.md §6.1.0 — local module augmentation + helper
+ * types for the four undeclared surfaces that V3/V4/V9 confirmed exist
+ * at runtime in opencode 1.14.50 but are missing from the SDK's
+ * generated types.
+ *
+ * The `declare module "@opencode-ai/sdk"` block adds the three runtime
+ * fields the SDK omits (format on the prompt body, structured on the
+ * assistant message, total on the token block). The helper types below
+ * widen the event union so we never compile against the SDK's
+ * incomplete `EventSubscribeResponse`.
+ */
+export {};
+//# sourceMappingURL=opencode-types.js.map

package/dist/core/backends/opencode-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-types.js","sourceRoot":"","sources":["../../../src/core/backends/opencode-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/core/backends/plan-presets.d.ts

@@ -14,8 +14,10 @@
  *   - Drives the seed model selection from each process key's default
  *     tier (`getDefaultTierForProcessKey`). Lite-tier keys seed Haiku
  *     (Claude) / gpt-5.4-mini (Codex) / flash-lite (Gemini); medium-tier
- *     keys seed Sonnet / gpt-5.4-mini / 3.1-flash-lite-preview; high-tier keys seed
- *     Opus / gpt-5.5 / 3.1-pro-preview.
+ *     keys seed Sonnet / gpt-5.4 / 3.1-flash-lite-preview; high-tier keys seed
+ *     Opus / gpt-5.4 / 3.1-pro-preview. (Codex's high tier collapses to
+ *     gpt-5.4 by default via `SEED_HIGH_TIER_OVERRIDE` in model-registry.ts
+ *     — gpt-5.5 is Opus-priced and operator-pinned, not the silent default.)
  *   - Exposes `setMainBackend(db, backendId)` — writes
  *     `backend_global_defaults.default_backend` only. No preset
  *     application, no per-process row mutation. The dashboard's main-
@@ -29,7 +31,16 @@
  * Tier-to-model resolution lives in `model-registry.ts:defaultModelForTier`.
  */
 import type Database from "better-sqlite3";
-import { type BackendId, type ProcessKey, type ProcessModelTier } from "@aitne/shared";
+import { type BackendId, type BackendModelTier, type ProcessKey, type ProcessModelTier } from "@aitne/shared";
+/**
+ * Scale a `maxBudgetUsd` for the given backend + tier. Exported so the
+ * cross-backend cascade in `process-config-cascade.ts` can apply the
+ * same factor to its INHERITOR_DEFAULTS when an operator edits
+ * `message.dm` on a non-Claude backend.
+ *
+ * Rounds to 2 decimals so the DB-stored cents-precision value is stable.
+ */
+export declare function applyBackendBudgetFactor(backendId: BackendId, tier: BackendModelTier, baseBudgetUsd: number): number;
 /**
  * Resolve the seed `(model, envelope)` for a configurable process key on
  * the given backend. The model is selected by the process key's default
@@ -79,8 +90,10 @@ export interface ApplyDefaultPresetsOptions {
  *     `backend_global_defaults.default_backend` (claude as last resort).
  *   - Seeds each row with a model resolved by `resolveDefaultBindingFor`
  *     (lite tier seeds Haiku on Claude / gpt-5.4-mini on Codex /
- *     flash-lite preview on Gemini; medium tier seeds Sonnet / gpt-5.4-mini
- *     / 3.1-flash-lite-preview; high tier seeds Opus / gpt-5.5 / 3.1-pro-preview).
+ *     flash-lite preview on Gemini; medium tier seeds Sonnet / gpt-5.4
+ *     / 3.1-flash-lite-preview; high tier seeds Opus / gpt-5.4 /
+ *     3.1-pro-preview — Codex's high tier intentionally collapses to
+ *     gpt-5.4, see `SEED_HIGH_TIER_OVERRIDE`).
  *   - Updates `default_lite_model` / `default_medium_model` /
  *     `default_high_model` / `default_backend` on the singleton row.
  *   - Skips rows whose `updated_by='user'` unless `force: true`.

package/dist/core/backends/plan-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-presets.d.ts","sourceRoot":"","sources":["../../../src/core/backends/plan-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAIL,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAuEvB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAS3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA0E3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,SAAS,GACnB,IAAI,CA6BN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,EAAE,SAAS,GACvB;IACD,yBAAyB,EAAE,KAAK,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,SAAS,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ,CA6BA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,IAAI,CAGzB"}
+{"version":3,"file":"plan-presets.d.ts","sourceRoot":"","sources":["../../../src/core/backends/plan-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AA4DvB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,gBAAgB,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR;AAuHD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAa3D;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,SAAS,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA0E3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,SAAS,GACnB,IAAI,CA6BN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,EAAE,SAAS,GACvB;IACD,yBAAyB,EAAE,KAAK,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,SAAS,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ,CA6BA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,IAAI,CAGzB"}