@wjarka/cezarion 0.15.1 → 0.16.0

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

@@ -0,0 +1,205 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import { effortLevelSchema } from '../contract/index.js';
+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;
+/**
+ * Ruling 19: volume never makes discovery fail. `omp models --json` prints ~350 bytes per model
+ * and OpenRouter alone lists 561 chat models on v18.4.11, so past this cap the first models in
+ * OMP's own order are kept and the cut is logged once.
+ */
+const MAX_MODELS = 2_000;
+/** Defensive cap on what we buffer from a misbehaving child (characters of stdout): ~6,000
+ *  models at v18.4.11's entry size, well past the model cap. */
+const MAX_OUTPUT_CHARS = 2 * 1_024 * 1_024;
+/** The host binary, resolved exactly like `OmpRunner` and the backend probe. */
+export function resolveOmpExecutable(bin) {
+    return bin ?? process.env.CEZ_OMP_BIN ?? 'omp';
+}
+/**
+ * Discover the models the host's own OMP installation offers, by asking it: `omp models --json`
+ * prints `{ "models": [...] }`, the same list OMP's own picker routes to, so no RPC session is
+ * needed (unlike Pi, whose thinking levels need a second probe).
+ *
+ * Best-effort by contract — `RunnerModelCatalog` turns any throw here into a cached or
+ * `unavailable` answer, and `auto` stays selectable either way. The throw messages are stable
+ * one-line categories (never the child's output); the catalog does not surface them to the
+ * client, they are for logs and direct callers. No config is read or written; the child is
+ * short-lived and bounded by a deadline and a stdout cap; a model list past the model cap is
+ * cut, never refused.
+ */
+export async function discoverOmpModels(options) {
+    // `OmpRunner` swaps in the bundled mock under CEZ_DRY_RUN=1. Without an explicit binary, skip
+    // the host probe so an offline dry-run cockpit never shells out to a real `omp`.
+    if (options.bin === undefined && process.env.CEZ_OMP_BIN === undefined && process.env.CEZ_DRY_RUN === '1') {
+        return [];
+    }
+    const bin = resolveOmpExecutable(options.bin);
+    const spawn = options.spawn ?? spawnOmp;
+    let child;
+    try {
+        child = spawn(bin, ['models', '--json'], options.cwd);
+    }
+    catch (error) {
+        throw spawnFailure(error);
+    }
+    const output = collectOmpOutput(child, options.timeoutMs ?? DEFAULT_DISCOVERY_TIMEOUT_MS);
+    child.stdin.end();
+    return parseOmpModels(await output);
+}
+async function collectOmpOutput(child, timeoutMs) {
+    const kill = teardown(child);
+    let timeout;
+    try {
+        return await new Promise((resolve, reject) => {
+            let stdout = '';
+            let settled = false;
+            const fail = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(error);
+                kill();
+            };
+            timeout = setTimeout(() => fail(new Error('OMP model discovery timed out')), timeoutMs);
+            timeout.unref?.();
+            child.stdout.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => {
+                if (settled)
+                    return;
+                stdout += chunk;
+                // A listing that outgrows the cap cannot be a model list we may trust.
+                if (stdout.length > MAX_OUTPUT_CHARS)
+                    fail(malformed());
+            });
+            child.stderr.resume();
+            child.stdin.once('error', () => undefined);
+            child.once('error', (error) => fail(spawnFailure(error)));
+            child.once('close', (code) => {
+                if (settled)
+                    return;
+                if (code !== 0) {
+                    fail(new Error(`OMP model discovery failed (exit ${code ?? 'unknown'})`));
+                    return;
+                }
+                settled = true;
+                resolve(stdout);
+            });
+        });
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+        kill();
+    }
+}
+function malformed() {
+    return new Error('OMP model discovery returned malformed output');
+}
+function spawnFailure(error) {
+    if (isRecord(error) && error.code === 'ENOENT')
+        return new Error('OMP CLI not installed');
+    return new Error('OMP model discovery failed to start');
+}
+/**
+ * Turn `omp models --json` output into picker options, preserving OMP's own order.
+ *
+ * v18.4.11 prints an object, `{ "models": [...] }`; a bare array is accepted too. Each entry
+ * carries `provider`, `kind`, `id`, `selector`, `name` and `thinking` (null, or the levels the
+ * model accepts). Entries with another `kind` than `chat` (absent counts as chat) are not
+ * runnable tasks and are skipped. `thinking` is intersected with cezar's `EffortLevel`s: OMP's
+ * own extras (`minimal`) are dropped, never remapped, so a pinned effort always means what the
+ * picker said it means.
+ *
+ * Anything that is not that shape is a failure — the CLI said something we cannot read, and
+ * "unavailable" is more honest than an empty catalog that looks like "you have no models".
+ */
+export function parseOmpModels(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw malformed();
+    }
+    const entries = Array.isArray(parsed) ? parsed : isRecord(parsed) ? parsed.models : undefined;
+    if (!Array.isArray(entries))
+        throw malformed();
+    const models = [];
+    const ids = new Set();
+    for (const entry of entries) {
+        if (!isRecord(entry))
+            continue;
+        if (entry.kind !== undefined && entry.kind !== 'chat')
+            continue;
+        const { provider, id, name } = entry;
+        if (typeof provider !== 'string' || !provider || typeof id !== 'string' || !id)
+            continue;
+        const modelId = `${provider}/${id}`;
+        if (ids.has(modelId))
+            continue;
+        if (models.length >= MAX_MODELS) {
+            console.warn(`[cez] OMP lists more than ${MAX_MODELS} models; the picker keeps the first ${MAX_MODELS} in OMP's order`);
+            break;
+        }
+        ids.add(modelId);
+        const effortLevels = effortLevelsOf(entry.thinking);
+        models.push({
+            id: modelId,
+            label: typeof name === 'string' && name ? name : id,
+            description: provider,
+            ...(effortLevels ? { effortLevels } : {}),
+        });
+    }
+    if (models.length === 0)
+        throw new Error('OMP reported no models (run omp login)');
+    return models;
+}
+function effortLevelsOf(thinking) {
+    if (!Array.isArray(thinking))
+        return undefined;
+    const levels = [];
+    for (const value of thinking) {
+        const level = effortLevelSchema.safeParse(value);
+        if (level.success && !levels.includes(level.data))
+            levels.push(level.data);
+    }
+    return levels.length > 0 ? levels : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// Copy of `spawnPi` (pi-model-catalog.ts) with OMP's child env.
+export function spawnOmp(bin, args, cwd, spawnImpl = nodeSpawn) {
+    return spawnImpl(bin, [...args], {
+        cwd,
+        env: buildChildEnv({ backend: 'omp' }),
+    });
+}
+/**
+ * Returns the probe's teardown: SIGTERM now, SIGKILL once the grace window elapses.
+ * Copy of `teardown` in pi-model-catalog.ts.
+ *
+ * Both steps gate on the child's *real* termination, never on `child.killed` — Node flips that
+ * flag the moment a signal is delivered. 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=omp-model-catalog.js.map

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

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

package/dist/core/omp-runner.d.ts

@@ -0,0 +1,73 @@
+import type { AgentEvent, AgentRunResult, AgentRunSpec, AgentRunSpecSupport, InputDelivery, AgentRunner, AgentSession, SessionOptions } from './agent-runner.js';
+/**
+ * OMP's built-in tool names at the pinned version (`src/tools/builtin-names.ts`, oh-my-pi
+ * v18.4.11; the real binary lists the same 30 in its `--tools` rejection). `--tools` is an
+ * allowlist validated against the registry, and an unknown name exits 2 before any frame, so
+ * only these, cezar's mapped names and `mcp__*` ever reach it.
+ */
+export declare const OMP_BUILTIN_TOOL_NAMES: readonly string[];
+/**
+ * What the omp CLI receives from each `AgentRunSpec` field (#284, spec § Spawn and spec
+ * support). Held against the mock's recorded argv and RPC by the harness parity matrix.
+ */
+export declare const OMP_SPEC_SUPPORT: AgentRunSpecSupport;
+export interface OmpToolSelection {
+    /** `tools` → `--tools <list>`, `no-tools` → `--no-tools`, `null` → OMP's own default set. */
+    flag: 'tools' | 'no-tools' | null;
+    tools: string[];
+    /** Requested names with no OMP equivalent, reported once as a v1 note. */
+    dropped: string[];
+}
+/**
+ * Maps cezar's tool names onto OMP's `--tools` allowlist (spec § Tools). Fails closed: a
+ * non-empty request that maps to nothing disables every built-in rather than widening to OMP's
+ * defaults, and every narrowing (`bashAllowlist`, D1) only ever removes names.
+ */
+export declare function ompTools(allowedTools: string[] | undefined, opts: {
+    bashAllowlist?: string[];
+    restrictNativeDelegation?: boolean;
+    cezarTools?: boolean;
+    /** Env the extension will read: `CEZ_PREVIEW=1` there decides which cezar tools it registers. */
+    env?: NodeJS.ProcessEnv;
+    /** OMP names the user's settings disabled (Ruling 13), removed from the list; never added to it. */
+    exclude?: readonly string[];
+}): OmpToolSelection;
+/** `omp --mode rpc` argv, in the order of the spec's spawn block. */
+export declare function buildOmpArgs(spec: AgentRunSpec, excludeTools?: readonly string[], 
+/** Ruling 22: an omp build that rejects `--add-dir` runs without the additional directories. */
+opts?: {
+    omitAddDir?: boolean;
+}): string[];
+export interface OmpRunnerOptions {
+    /** Override the binary name/path; defaults to `omp` on PATH (`CEZ_OMP_BIN`). */
+    bin?: string;
+    /** Wall-clock timeout for a run (ms); per-spec `timeoutMs` still wins. */
+    timeoutMs?: number;
+    /** Grace before each shutdown signal escalates (ms); defaults to `KILL_GRACE_MS`. Tests shorten it. */
+    killGraceMs?: number;
+}
+/**
+ * Persistent subprocess adapter for OMP's RPC mode (#595), one `omp --mode rpc` child per
+ * session. Structure follows `pi-runner.ts` step for step (Pi stays untouched); what OMP changes
+ * is the turn boundary — `session_settled`, or the turn-opening prompt OMP completed without the
+ * agent or rejected before admission (`ompTurnBoundary`, gated by prompt id in the mapper), never
+ * `agent_end` — plus the startup commands and the error paths. v1 `turn-end` follows the mapper
+ * closing its turn, so the two streams cannot disagree on a boundary.
+ *
+ * Contract: oh-my-pi v18.4.11 `docs/rpc.md`, `packages/coding-agent/src/modes/rpc/rpc-mode.ts`.
+ * Design record and the implementation-time rulings: `.ai/specs/2026-10-02-omp-runner.md`.
+ */
+export declare class OmpRunner implements AgentRunner {
+    readonly backend: 'omp';
+    readonly specSupport: Readonly<Record<keyof AgentRunSpec, import("./agent-runner.js").SpecFieldSupport>>;
+    readonly systemPromptOnResume: 'resent';
+    readonly inputDelivery: InputDelivery;
+    private readonly bin;
+    private readonly timeoutMs;
+    private readonly killGraceMs;
+    private lastSession;
+    constructor(opts?: OmpRunnerOptions);
+    run(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void): Promise<AgentRunResult>;
+    interrupt(): Promise<void>;
+    startSession(spec: AgentRunSpec, onEvent?: (event: AgentEvent) => void, opts?: SessionOptions): AgentSession;
+}