@skaile/workspaces 0.8.5

package/dist/bridge/drivers/omp.js

@@ -0,0 +1,431 @@
+import { registerDriver, DRIVER_CATALOG, AgentDriver, getBridgeLogger } from '../../chunk-MBBTBKAS.js';
+import '../../chunk-V37HONL7.js';
+import '../../chunk-NSBPE2FW.js';
+import { spawn, execFile } from 'child_process';
+import fs from 'fs/promises';
+import path from 'path';
+import { createInterface } from 'readline';
+
+function buildOmpChildEnv(parent) {
+  const out = {};
+  const explicit = ["ANTHROPIC_API_KEY", "PATH", "HOME", "USER", "HOSTNAME", "SKAILE_SESSION_ID"];
+  for (const key of explicit) {
+    const v = parent[key];
+    if (v !== void 0) out[key] = v;
+  }
+  for (const [key, value] of Object.entries(parent)) {
+    if (typeof value !== "string") continue;
+    if (key.startsWith("PI_") || key.startsWith("OMP_BRIDGE_") || key.startsWith("FAKE_OMP_")) {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+var OmpDriver = class extends AgentDriver {
+  driverInfo = {
+    id: "omp",
+    name: "omp (oh-my-pi)",
+    modelAgnostic: true,
+    supportsInBandAbort: true
+  };
+  log = getBridgeLogger("omp");
+  proc = null;
+  rl = null;
+  reqId = 0;
+  config;
+  ready = false;
+  startPromise = null;
+  stderrBuffer = [];
+  prevText = "";
+  /** OMP session ID captured via `get_state` after each turn. */
+  _ompSessionId;
+  get runtimeSessionId() {
+    return this._ompSessionId;
+  }
+  getModel() {
+    return this.config.model;
+  }
+  /**
+   * @param config - Driver configuration. omp-relevant fields:
+   *   - `cwd` — working directory; omp session files are stored under `<cwd>/.omp/sessions/`.
+   *   - `model` / `provider` — forwarded as `--model [provider/]model`.
+   *   - `systemPrompt` — written to `<cwd>/.omp/system.md` and appended via `--append-system-prompt`.
+   *   - `agentDir` — sets `PI_CODING_AGENT_DIR`; omp reads agent identity from this directory.
+   *   - `sshKeyPath` — injected as `GIT_SSH_COMMAND` for authenticated git operations.
+   *   - `resumeSessionId` — omp session UUID to restore via `--session <id>`.
+   */
+  constructor(config) {
+    super();
+    this.config = config;
+  }
+  async start() {
+    if (this.proc) return;
+    if (this.startPromise) return this.startPromise;
+    this.startPromise = this._start();
+    return this.startPromise;
+  }
+  async _start() {
+    const args = ["--mode", "rpc"];
+    const sessionDir = path.join(this.config.cwd, ".omp", "sessions");
+    await fs.mkdir(sessionDir, { recursive: true });
+    args.push("--session-dir", sessionDir);
+    if (this.config.resumeSessionId) {
+      this.log.info("resuming OMP session", { sessionId: this.config.resumeSessionId });
+      args.push("--session", this.config.resumeSessionId);
+    }
+    if (this.config.model) {
+      const modelArg = this.config.provider ? `${this.config.provider}/${this.config.model}` : this.config.model;
+      args.push("--model", modelArg);
+    }
+    if (this.config.systemPrompt) {
+      const ompDir = path.join(this.config.cwd, ".omp");
+      await fs.mkdir(ompDir, { recursive: true });
+      const systemFile = path.join(ompDir, "system.md");
+      await fs.writeFile(systemFile, this.config.systemPrompt);
+      args.push("--append-system-prompt", systemFile);
+    }
+    const env = this.config.env ? { ...this.config.env } : buildOmpChildEnv(process.env);
+    if (this.config.agentDir) {
+      env.PI_CODING_AGENT_DIR = this.config.agentDir;
+    }
+    if (this.config.sshKeyPath) {
+      env.GIT_SSH_COMMAND = `ssh -i "${this.config.sshKeyPath}" -o StrictHostKeyChecking=accept-new`;
+    }
+    const overrideBin = process.env.OMP_BRIDGE_BIN;
+    const overridePreArgs = process.env.OMP_BRIDGE_PREARGS ? process.env.OMP_BRIDGE_PREARGS.split(/\s+/).filter(Boolean) : [];
+    const spawnBin = overrideBin || "omp";
+    const spawnArgs = overrideBin ? [...overridePreArgs, ...args] : args;
+    return new Promise((resolve, reject) => {
+      this.log.info("spawning omp", {
+        bin: spawnBin,
+        args: spawnArgs,
+        cwd: this.config.cwd
+      });
+      if (env.PI_CODING_AGENT_DIR)
+        this.log.debug("env: PI_CODING_AGENT_DIR set", { value: env.PI_CODING_AGENT_DIR });
+      if (env.GIT_SSH_COMMAND) this.log.debug("env: GIT_SSH_COMMAND set");
+      const proc = spawn(spawnBin, spawnArgs, {
+        cwd: this.config.cwd,
+        env,
+        stdio: ["pipe", "pipe", "pipe"]
+      });
+      this.proc = proc;
+      const procEmitter = proc;
+      procEmitter.on("error", (err) => {
+        const detail = this.classifyProcessError(err);
+        this.log.error("process error", err, { detail });
+        this.emit("agent-event", { type: "error", error: detail.message, detail });
+        if (!this.ready) reject(err);
+      });
+      procEmitter.on("exit", (code, signal) => {
+        this.log.info("process exited", { code, signal });
+        if (code !== null && code !== 0) {
+          const lastStderr = this.stderrBuffer.slice(-10).join("\n");
+          const detail = {
+            message: `omp process crashed (exit code ${code})${lastStderr ? `: ${this.stderrBuffer[this.stderrBuffer.length - 1]}` : ""}`,
+            category: "process",
+            retryable: true,
+            hint: lastStderr || "The agent process exited unexpectedly. Try sending your prompt again."
+          };
+          this.emit("agent-event", { type: "error", error: detail.message, detail });
+        }
+        this.cleanup();
+        this.emit("exit", { code, signal });
+      });
+      if (proc.stdout) {
+        const rl = createInterface({ input: proc.stdout });
+        this.rl = rl;
+        rl.on("line", (line) => {
+          if (!line.trim()) return;
+          try {
+            const event = JSON.parse(line);
+            this.handleEvent(event);
+          } catch {
+            this.log.debug("stdout", { line });
+          }
+        });
+      }
+      if (proc.stderr) {
+        const stderrRl = createInterface({ input: proc.stderr });
+        stderrRl.on("line", (line) => {
+          this.log.warn("stderr", { line });
+          this.stderrBuffer.push(line);
+          if (this.stderrBuffer.length > 20) this.stderrBuffer.shift();
+        });
+      }
+      const startTime = Date.now();
+      const readyTimeout = setTimeout(() => {
+        if (!this.ready) {
+          this.log.warn("ready timeout, proceeding", { timeoutMs: 5e3 });
+          this.ready = true;
+          resolve();
+        }
+      }, 5e3);
+      this.once("ready", () => {
+        clearTimeout(readyTimeout);
+        if (!this.ready) {
+          this.log.info("process ready", { elapsedMs: Date.now() - startTime });
+          this.ready = true;
+          resolve();
+        }
+      });
+    });
+  }
+  extractMessageText(msg) {
+    if (!msg) return "";
+    const c = msg.content;
+    if (typeof c === "string") return c;
+    if (Array.isArray(c))
+      return c.filter((b) => b.type === "text" && b.text).map((b) => b.text).join("");
+    return "";
+  }
+  handleEvent(event) {
+    if (event.type === "ready") {
+      this.emit("ready");
+      return;
+    }
+    if (event.type === "response") {
+      if (!event.success && event.error) {
+        const detail = this.classifyErrorMessage(event.error);
+        this.emit("agent-event", { type: "error", error: event.error, detail });
+      }
+      this.emit(`response:${event.id}`, event);
+      return;
+    }
+    if (event.type === "error" && event.error) {
+      const detail = this.classifyErrorMessage(event.error);
+      this.emit("agent-event", { ...event, detail });
+      return;
+    }
+    if (event.type === "message_update" && event.message) {
+      const text = this.extractMessageText(event.message);
+      let delta = "";
+      if (text.startsWith(this.prevText)) {
+        delta = text.slice(this.prevText.length);
+      } else {
+        delta = text;
+      }
+      this.prevText = text;
+      this.emit("agent-event", { ...event, _textDelta: delta });
+      return;
+    }
+    if (event.type === "message_start" || event.type === "message_end" || event.type === "agent_end") {
+      this.prevText = "";
+    }
+    if (event.type === "agent_end") {
+      void this.captureSessionId();
+    }
+    this.emit("agent-event", event);
+  }
+  /**
+   * Query OMP for the current session ID via `get_state` RPC.
+   * Emits a `session_info` event on success so the forge layer can persist the ID.
+   * Failures are silently swallowed — session tracking is best-effort.
+   */
+  async captureSessionId() {
+    try {
+      const id = this.nextId();
+      const response = await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error("get_state timeout")), 5e3);
+        this.once(`response:${id}`, (resp) => {
+          clearTimeout(timer);
+          resolve(resp);
+        });
+        try {
+          this.send({ id, type: "get_state" });
+        } catch (err) {
+          clearTimeout(timer);
+          reject(err);
+        }
+      });
+      if (response.success && response.data) {
+        const data = response.data;
+        const sessionId = data.sessionId;
+        const sessionFile = data.sessionFile;
+        if (sessionId) {
+          this._ompSessionId = sessionId;
+          this.log.debug("omp session id assigned", { sessionId });
+          this.emit("agent-event", {
+            type: "session_info",
+            driverSessionId: sessionId,
+            ...sessionFile ? { sessionFile } : {}
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  nextId() {
+    return `req-${++this.reqId}`;
+  }
+  send(msg) {
+    if (!this.proc?.stdin?.writable) {
+      const detail = {
+        message: "omp process not running",
+        category: "process",
+        retryable: true,
+        hint: "The agent process is not available. It will restart automatically on the next prompt."
+      };
+      const err = Object.assign(new Error(detail.message), { detail });
+      throw err;
+    }
+    this.proc.stdin.write(`${JSON.stringify(msg)}
+`);
+  }
+  /**
+   * Sends a prompt to the omp process via JSON-RPC and returns immediately.
+   *
+   * The driver emits `agent-event` payloads as omp streams responses on stdout.
+   * Callers should await the `agent_end` event (or the `prompt()` resolution) to
+   * know when the turn is complete.
+   *
+   * @param message - Plain-text user prompt.
+   * @throws {Error} When the omp process is not running or its stdin is closed.
+   */
+  async prompt(message) {
+    await this.start();
+    const id = this.nextId();
+    this.send({ id, type: "prompt", message });
+  }
+  /**
+   * Sends an in-band abort RPC to the omp process, requesting it to stop the
+   * current turn without terminating the child process.
+   *
+   * @remarks This is a best-effort signal — omp may not honour the abort
+   *   immediately. The process remains alive after `abort()`.
+   */
+  async abort() {
+    if (!this.proc) return;
+    const id = this.nextId();
+    this.send({ id, type: "abort" });
+  }
+  /** `true` when the omp child process is alive and has not been killed. */
+  get isRunning() {
+    return this.proc !== null && !this.proc.killed;
+  }
+  /**
+   * Sends SIGTERM to the omp child process and performs cleanup.
+   *
+   * The driver instance must not be reused after `kill()`. Create a new
+   * `OmpDriver` to start a fresh session.
+   */
+  kill() {
+    if (this.proc) {
+      this.proc.kill("SIGTERM");
+      this.cleanup();
+    }
+  }
+  async resetSession() {
+    this.kill();
+    await this.start();
+  }
+  classifyProcessError(err) {
+    if (err.code === "ENOENT") {
+      return {
+        message: "omp command not found",
+        category: "config",
+        retryable: false,
+        hint: "The omp agent is not installed or not on your PATH. Install it and try again."
+      };
+    }
+    if (err.code === "EACCES") {
+      return {
+        message: "Permission denied running omp",
+        category: "config",
+        retryable: false,
+        hint: "Check file permissions for the omp binary."
+      };
+    }
+    return {
+      message: err.message,
+      category: "process",
+      retryable: true,
+      hint: "An unexpected process error occurred. Try sending your prompt again."
+    };
+  }
+  classifyErrorMessage(msg) {
+    const lower = msg.toLowerCase();
+    if (lower.includes("api key") || lower.includes("unauthorized") || lower.includes("authentication") || lower.includes("401")) {
+      return {
+        message: msg,
+        category: "auth",
+        retryable: false,
+        hint: "Check your API key configuration in Settings."
+      };
+    }
+    if (lower.includes("rate limit") || lower.includes("429") || lower.includes("too many requests") || lower.includes("quota")) {
+      return {
+        message: msg,
+        category: "rate_limit",
+        retryable: true,
+        hint: "You have hit the provider rate limit. Wait a moment and try again."
+      };
+    }
+    if (lower.includes("model") && (lower.includes("not found") || lower.includes("not available") || lower.includes("does not exist"))) {
+      return {
+        message: msg,
+        category: "model",
+        retryable: false,
+        hint: "The selected model is not available. Change the model in settings."
+      };
+    }
+    if (lower.includes("context length") || lower.includes("too long") || lower.includes("token limit") || lower.includes("max_tokens")) {
+      return {
+        message: msg,
+        category: "model",
+        retryable: false,
+        hint: "The conversation is too long. Start a new session or choose a model with a larger context window."
+      };
+    }
+    if (lower.includes("timeout") || lower.includes("econnrefused") || lower.includes("enotfound") || lower.includes("network") || lower.includes("fetch failed")) {
+      return {
+        message: msg,
+        category: "network",
+        retryable: true,
+        hint: "A network error occurred. Check your connection and try again."
+      };
+    }
+    return { message: msg, category: "unknown", retryable: true };
+  }
+  async listModels() {
+    return new Promise((resolve, reject) => {
+      execFile("omp", ["--list-models"], { timeout: 1e4 }, (err, stdout, stderr) => {
+        if (err) {
+          reject(new Error(`omp --list-models failed: ${stderr || err.message}`));
+          return;
+        }
+        const models = [];
+        let inCanonical = false;
+        let headerSkipped = false;
+        for (const raw of stdout.split("\n")) {
+          const line = raw.trimEnd();
+          if (!inCanonical) {
+            if (line.startsWith("Canonical models")) inCanonical = true;
+            continue;
+          }
+          if (!headerSkipped) {
+            headerSkipped = true;
+            continue;
+          }
+          if (line === "" || !line.startsWith(" ") && line.endsWith("models")) break;
+          const canonical = line.split(/\s{2,}/)[0]?.trim();
+          if (canonical) models.push({ id: canonical, name: canonical });
+        }
+        resolve(models);
+      });
+    });
+  }
+  cleanup() {
+    this.rl?.close();
+    this.rl = null;
+    this.proc = null;
+    this.ready = false;
+    this.startPromise = null;
+    this.stderrBuffer = [];
+  }
+};
+registerDriver("omp", (config) => new OmpDriver(config), DRIVER_CATALOG.omp);
+
+export { OmpDriver };
+//# sourceMappingURL=omp.js.map
+//# sourceMappingURL=omp.js.map

package/dist/bridge/drivers/omp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../bridge/src/drivers/omp.ts"],"names":[],"mappings":"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","file":"omp.js","sourcesContent":["import { type ChildProcess, execFile, spawn } from \"node:child_process\";\nimport type { EventEmitter } from \"node:events\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { createInterface, type Interface } from \"node:readline\";\nimport type { Logger } from \"@skaile/workspaces/types\";\nimport { getBridgeLogger } from \"../logger.js\";\nimport type { ModelEntry } from \"../models.js\";\nimport { DRIVER_CATALOG, registerDriver } from \"../registry.js\";\nimport { type AgentConfig, AgentDriver, type AgentError, type DriverInfo } from \"../types.js\";\n\n/**\n * Build the explicit env whitelist forwarded to the omp child process.\n *\n * Omits anything provisioned by `provision_secrets` so user credentials\n * stay out of the subprocess environment. PATH / HOME / USER / HOSTNAME\n * are required for omp to function; the API key passes through so omp\n * can authenticate against the LLM; any `PI_*` keys are app-specific\n * config the host operator may have set explicitly.\n *\n * Test seams (`OMP_BRIDGE_*`, `FAKE_OMP_*`) are passed through so the\n * subprocess harness in `tests/omp-driver.test.ts` can drive a fake-omp\n * script via env-driven mode flags.\n *\n * @docLink packages/bridge/concepts#omp-env-whitelist\n */\nfunction buildOmpChildEnv(parent: NodeJS.ProcessEnv): Record<string, string> {\n  const out: Record<string, string> = {};\n  const explicit = [\"ANTHROPIC_API_KEY\", \"PATH\", \"HOME\", \"USER\", \"HOSTNAME\", \"SKAILE_SESSION_ID\"];\n  for (const key of explicit) {\n    const v = parent[key];\n    if (v !== undefined) out[key] = v;\n  }\n  for (const [key, value] of Object.entries(parent)) {\n    if (typeof value !== \"string\") continue;\n    if (key.startsWith(\"PI_\") || key.startsWith(\"OMP_BRIDGE_\") || key.startsWith(\"FAKE_OMP_\")) {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\ninterface OmpEvent {\n  type: string;\n  data?: unknown;\n  id?: string;\n  success?: boolean;\n  error?: string;\n  message?: OmpMessage;\n  [key: string]: unknown;\n}\n\ninterface OmpMessage {\n  role?: string;\n  content?: string | OmpContentBlock[];\n}\n\ninterface OmpContentBlock {\n  type: string;\n  text?: string;\n  id?: string;\n  name?: string;\n  input?: unknown;\n  thinking?: string;\n}\n\n/**\n * Agent driver for the oh-my-pi (omp) coding agent.\n *\n * Spawns `omp --mode rpc` as a child process and communicates via newline-delimited\n * JSON-RPC over stdin/stdout. Model-agnostic: supports any LLM provider.\n *\n * @see https://github.com/can1357/oh-my-pi\n *\n * @remarks\n * **Session persistence** — omp writes JSONL session files to `<cwd>/.omp/sessions/`\n * (via `--session-dir`). After each turn (`agent_end`), sends a `get_state` RPC to\n * capture the native session ID and emits a `session_info` event so the forge layer\n * can persist it. On the next spawn, callers pass `resumeSessionId` to restore omp's\n * native context.\n *\n * **stderrBuffer** — collects the last 20 lines of stderr so they can be appended to\n * crash error messages for diagnostics without blocking the stdout readline loop.\n *\n * **systemPrompt injection** — omp does not accept a system prompt string directly.\n * The driver writes `AgentConfig.systemPrompt` to `<cwd>/.omp/system.md` and passes\n * the path via `--append-system-prompt` before spawning.\n *\n * **agentDir** — maps to the `PI_CODING_AGENT_DIR` environment variable. omp reads the\n * GitAgent directory at this path natively (agent.yaml, SOUL.md, RULES.md, knowledge/).\n *\n * @docLink packages/bridge/drivers#omp-driver\n */\nexport class OmpDriver extends AgentDriver {\n  readonly driverInfo: DriverInfo = {\n    id: \"omp\",\n    name: \"omp (oh-my-pi)\",\n    modelAgnostic: true,\n    supportsInBandAbort: true,\n  };\n\n  private readonly log: Logger = getBridgeLogger(\"omp\");\n  private proc: ChildProcess | null = null;\n  private rl: Interface | null = null;\n  private reqId = 0;\n  private config: AgentConfig;\n  private ready = false;\n  private startPromise: Promise<void> | null = null;\n  private stderrBuffer: string[] = [];\n  private prevText = \"\";\n  /** OMP session ID captured via `get_state` after each turn. */\n  private _ompSessionId?: string;\n\n  override get runtimeSessionId(): string | undefined {\n    return this._ompSessionId;\n  }\n\n  override getModel(): string | undefined {\n    return this.config.model;\n  }\n\n  /**\n   * @param config - Driver configuration. omp-relevant fields:\n   *   - `cwd` — working directory; omp session files are stored under `<cwd>/.omp/sessions/`.\n   *   - `model` / `provider` — forwarded as `--model [provider/]model`.\n   *   - `systemPrompt` — written to `<cwd>/.omp/system.md` and appended via `--append-system-prompt`.\n   *   - `agentDir` — sets `PI_CODING_AGENT_DIR`; omp reads agent identity from this directory.\n   *   - `sshKeyPath` — injected as `GIT_SSH_COMMAND` for authenticated git operations.\n   *   - `resumeSessionId` — omp session UUID to restore via `--session <id>`.\n   */\n  constructor(config: AgentConfig) {\n    super();\n    this.config = config;\n  }\n\n  public async start(): Promise<void> {\n    if (this.proc) return;\n    if (this.startPromise) return this.startPromise;\n    this.startPromise = this._start();\n    return this.startPromise;\n  }\n\n  private async _start(): Promise<void> {\n    const args = [\"--mode\", \"rpc\"];\n\n    // ── Session persistence ───────────────────────────────────────────────────\n    // Store OMP session files in <cwd>/.omp/sessions/ so they survive process\n    // restarts. The caller passes resumeSessionId to restore a prior session.\n    const sessionDir = path.join(this.config.cwd, \".omp\", \"sessions\");\n    await fs.mkdir(sessionDir, { recursive: true });\n    args.push(\"--session-dir\", sessionDir);\n\n    if (this.config.resumeSessionId) {\n      this.log.info(\"resuming OMP session\", { sessionId: this.config.resumeSessionId });\n      args.push(\"--session\", this.config.resumeSessionId);\n    }\n\n    if (this.config.model) {\n      const modelArg = this.config.provider\n        ? `${this.config.provider}/${this.config.model}`\n        : this.config.model;\n      args.push(\"--model\", modelArg);\n    }\n\n    // ── System prompt injection ───────────────────────────────────────────────\n    // omp does not accept a system prompt string directly; it reads from a file.\n    // We write it to .omp/system.md (inside the project cwd) and pass the path\n    // via --append-system-prompt.  This file is overwritten on each driver start.\n    //\n    // In flow mode (base-assets/connectors/flow/run-flow.ts conductFlow), systemPrompt carries the full agent\n    // identity (SOUL + RULES + knowledge + connector docs) because no agentDir is set.\n    // In REPL mode (agent.ts buildDriver), systemPrompt carries only connector docs\n    // because PI_CODING_AGENT_DIR already gives omp the full agent identity.\n    if (this.config.systemPrompt) {\n      const ompDir = path.join(this.config.cwd, \".omp\");\n      await fs.mkdir(ompDir, { recursive: true });\n      const systemFile = path.join(ompDir, \"system.md\");\n      await fs.writeFile(systemFile, this.config.systemPrompt);\n      args.push(\"--append-system-prompt\", systemFile);\n    }\n\n    // Explicit env whitelist for the omp child process. Avoids leaking the\n    // runner's full environment (which may carry user secrets provisioned by\n    // the platform) into the spawned subprocess. `this.config.env`, when\n    // supplied, fully overrides the whitelist (used by tests + advanced\n    // callers).\n    const env: Record<string, string> = this.config.env\n      ? { ...(this.config.env as Record<string, string>) }\n      : buildOmpChildEnv(process.env);\n    // ── Main-agent handoff ────────────────────────────────────────────────────\n    // PI_CODING_AGENT_DIR is the omp equivalent of `claude --agent <name>`.\n    // omp reads the GitAgent directory at this path natively: agent.yaml for the\n    // manifest, SOUL.md for identity, RULES.md for constraints, knowledge/ for domain\n    // context.  The path may be the source directory (agentDir in REPL mode) or a\n    // rendered copy installed by ompRenderer under .omp/agents/<name>/.\n    // Unlike the claude-sdk path, no prior `skaile install` is required for REPL mode\n    // because omp reads the source directory directly via this env variable.\n    if (this.config.agentDir) {\n      env.PI_CODING_AGENT_DIR = this.config.agentDir;\n    }\n    if (this.config.sshKeyPath) {\n      env.GIT_SSH_COMMAND = `ssh -i \"${this.config.sshKeyPath}\" -o StrictHostKeyChecking=accept-new`;\n    }\n\n    // test-only: `OMP_BRIDGE_BIN` overrides the binary name and `OMP_BRIDGE_PREARGS`\n    // (space-delimited) supplies any leading args (e.g. a JS script path when the\n    // override binary is `node` or `bun`). Used by the subprocess harness tests in\n    // `tests/omp-driver.test.ts` to point spawn at a fake-omp script without\n    // monkey-patching `node:child_process`. Both are ignored in production.\n    const overrideBin = process.env.OMP_BRIDGE_BIN;\n    const overridePreArgs = process.env.OMP_BRIDGE_PREARGS\n      ? process.env.OMP_BRIDGE_PREARGS.split(/\\s+/).filter(Boolean)\n      : [];\n    const spawnBin = overrideBin || \"omp\";\n    const spawnArgs = overrideBin ? [...overridePreArgs, ...args] : args;\n\n    return new Promise<void>((resolve, reject) => {\n      this.log.info(\"spawning omp\", {\n        bin: spawnBin,\n        args: spawnArgs,\n        cwd: this.config.cwd,\n      });\n      if (env.PI_CODING_AGENT_DIR)\n        this.log.debug(\"env: PI_CODING_AGENT_DIR set\", { value: env.PI_CODING_AGENT_DIR });\n      if (env.GIT_SSH_COMMAND) this.log.debug(\"env: GIT_SSH_COMMAND set\");\n\n      // Cast to ChildProcess: spawn infers ChildProcessWithoutNullStreams for\n      // pipe stdio, but bun-types doesn't expose EventEmitter.on on that subtype.\n      const proc = spawn(spawnBin, spawnArgs, {\n        cwd: this.config.cwd,\n        env,\n        stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      }) as ChildProcess;\n      this.proc = proc;\n      // bun-types 1.3.11 omits EventEmitter.on from ChildProcess; cast to subscribe.\n      const procEmitter = proc as unknown as EventEmitter;\n\n      procEmitter.on(\"error\", (err: Error) => {\n        const detail = this.classifyProcessError(err as NodeJS.ErrnoException);\n        this.log.error(\"process error\", err, { detail });\n        this.emit(\"agent-event\", { type: \"error\", error: detail.message, detail });\n        if (!this.ready) reject(err);\n      });\n\n      procEmitter.on(\"exit\", (code: number | null, signal: NodeJS.Signals | null) => {\n        this.log.info(\"process exited\", { code, signal });\n        if (code !== null && code !== 0) {\n          const lastStderr = this.stderrBuffer.slice(-10).join(\"\\n\");\n          const detail: AgentError = {\n            message: `omp process crashed (exit code ${code})${lastStderr ? `: ${this.stderrBuffer[this.stderrBuffer.length - 1]}` : \"\"}`,\n            category: \"process\",\n            retryable: true,\n            hint:\n              lastStderr || \"The agent process exited unexpectedly. Try sending your prompt again.\",\n          };\n          this.emit(\"agent-event\", { type: \"error\", error: detail.message, detail });\n        }\n        this.cleanup();\n        this.emit(\"exit\", { code, signal });\n      });\n\n      if (proc.stdout) {\n        const rl = createInterface({ input: proc.stdout });\n        this.rl = rl;\n        // bun-types 1.3.11 omits EventEmitter.on from readline.Interface; cast to subscribe.\n        (rl as unknown as EventEmitter).on(\"line\", (line: string) => {\n          if (!line.trim()) return;\n          try {\n            const event: OmpEvent = JSON.parse(line);\n            this.handleEvent(event);\n          } catch {\n            this.log.debug(\"stdout\", { line });\n          }\n        });\n      }\n\n      if (proc.stderr) {\n        const stderrRl = createInterface({ input: proc.stderr });\n        (stderrRl as unknown as EventEmitter).on(\"line\", (line: string) => {\n          this.log.warn(\"stderr\", { line });\n          this.stderrBuffer.push(line);\n          if (this.stderrBuffer.length > 20) this.stderrBuffer.shift();\n        });\n      }\n\n      const startTime = Date.now();\n      const readyTimeout = setTimeout(() => {\n        if (!this.ready) {\n          this.log.warn(\"ready timeout, proceeding\", { timeoutMs: 5000 });\n          this.ready = true;\n          resolve();\n        }\n      }, 5000);\n\n      this.once(\"ready\", () => {\n        clearTimeout(readyTimeout);\n        if (!this.ready) {\n          this.log.info(\"process ready\", { elapsedMs: Date.now() - startTime });\n          this.ready = true;\n          resolve();\n        }\n      });\n    });\n  }\n\n  private extractMessageText(msg: OmpMessage): string {\n    if (!msg) return \"\";\n    const c = msg.content;\n    if (typeof c === \"string\") return c;\n    if (Array.isArray(c))\n      return c\n        .filter((b) => b.type === \"text\" && b.text)\n        .map((b) => b.text)\n        .join(\"\");\n    return \"\";\n  }\n\n  private handleEvent(event: OmpEvent) {\n    if (event.type === \"ready\") {\n      this.emit(\"ready\");\n      return;\n    }\n    if (event.type === \"response\") {\n      if (!event.success && event.error) {\n        const detail = this.classifyErrorMessage(event.error);\n        this.emit(\"agent-event\", { type: \"error\", error: event.error, detail });\n      }\n      this.emit(`response:${event.id}`, event);\n      return;\n    }\n    if (event.type === \"error\" && event.error) {\n      const detail = this.classifyErrorMessage(event.error);\n      this.emit(\"agent-event\", { ...event, detail });\n      return;\n    }\n    // Compute text delta for message_update events\n    if (event.type === \"message_update\" && event.message) {\n      const text = this.extractMessageText(event.message);\n      let delta = \"\";\n      if (text.startsWith(this.prevText)) {\n        delta = text.slice(this.prevText.length);\n      } else {\n        // Content restructured (e.g. thinking blocks changed) — emit full text as delta\n        delta = text;\n      }\n      this.prevText = text;\n      this.emit(\"agent-event\", { ...event, _textDelta: delta });\n      return;\n    }\n    // Reset delta tracking on message boundaries\n    if (\n      event.type === \"message_start\" ||\n      event.type === \"message_end\" ||\n      event.type === \"agent_end\"\n    ) {\n      this.prevText = \"\";\n    }\n    // After each turn ends, capture the OMP session ID so callers can persist it\n    // and pass it as resumeSessionId on the next spawn.\n    if (event.type === \"agent_end\") {\n      void this.captureSessionId();\n    }\n    this.emit(\"agent-event\", event);\n  }\n\n  /**\n   * Query OMP for the current session ID via `get_state` RPC.\n   * Emits a `session_info` event on success so the forge layer can persist the ID.\n   * Failures are silently swallowed — session tracking is best-effort.\n   */\n  private async captureSessionId(): Promise<void> {\n    try {\n      const id = this.nextId();\n      const response = await new Promise<OmpEvent>((resolve, reject) => {\n        const timer = setTimeout(() => reject(new Error(\"get_state timeout\")), 5000);\n        this.once(`response:${id}`, (resp: OmpEvent) => {\n          clearTimeout(timer);\n          resolve(resp);\n        });\n        try {\n          this.send({ id, type: \"get_state\" });\n        } catch (err) {\n          clearTimeout(timer);\n          reject(err);\n        }\n      });\n\n      if (response.success && response.data) {\n        const data = response.data as Record<string, unknown>;\n        const sessionId = data.sessionId as string | undefined;\n        const sessionFile = data.sessionFile as string | undefined;\n        if (sessionId) {\n          this._ompSessionId = sessionId;\n          this.log.debug(\"omp session id assigned\", { sessionId });\n          this.emit(\"agent-event\", {\n            type: \"session_info\",\n            driverSessionId: sessionId,\n            ...(sessionFile ? { sessionFile } : {}),\n          });\n        }\n      }\n    } catch {\n      // get_state is best-effort — OMP may not support it yet or the process\n      // may have exited. The short-term history injection fallback still works.\n    }\n  }\n\n  private nextId(): string {\n    return `req-${++this.reqId}`;\n  }\n\n  private send(msg: object): void {\n    if (!this.proc?.stdin?.writable) {\n      const detail: AgentError = {\n        message: \"omp process not running\",\n        category: \"process\",\n        retryable: true,\n        hint: \"The agent process is not available. It will restart automatically on the next prompt.\",\n      };\n      const err = Object.assign(new Error(detail.message), { detail });\n      throw err;\n    }\n    this.proc.stdin.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  /**\n   * Sends a prompt to the omp process via JSON-RPC and returns immediately.\n   *\n   * The driver emits `agent-event` payloads as omp streams responses on stdout.\n   * Callers should await the `agent_end` event (or the `prompt()` resolution) to\n   * know when the turn is complete.\n   *\n   * @param message - Plain-text user prompt.\n   * @throws {Error} When the omp process is not running or its stdin is closed.\n   */\n  public async prompt(message: string): Promise<void> {\n    await this.start();\n    const id = this.nextId();\n    this.send({ id, type: \"prompt\", message });\n  }\n\n  /**\n   * Sends an in-band abort RPC to the omp process, requesting it to stop the\n   * current turn without terminating the child process.\n   *\n   * @remarks This is a best-effort signal — omp may not honour the abort\n   *   immediately. The process remains alive after `abort()`.\n   */\n  public async abort(): Promise<void> {\n    if (!this.proc) return;\n    const id = this.nextId();\n    this.send({ id, type: \"abort\" });\n  }\n\n  /** `true` when the omp child process is alive and has not been killed. */\n  public get isRunning(): boolean {\n    return this.proc !== null && !this.proc.killed;\n  }\n\n  /**\n   * Sends SIGTERM to the omp child process and performs cleanup.\n   *\n   * The driver instance must not be reused after `kill()`. Create a new\n   * `OmpDriver` to start a fresh session.\n   */\n  kill(): void {\n    if (this.proc) {\n      this.proc.kill(\"SIGTERM\");\n      this.cleanup();\n    }\n  }\n\n  async resetSession(): Promise<void> {\n    this.kill();\n    await this.start();\n  }\n\n  private classifyProcessError(err: NodeJS.ErrnoException): AgentError {\n    if (err.code === \"ENOENT\") {\n      return {\n        message: \"omp command not found\",\n        category: \"config\",\n        retryable: false,\n        hint: \"The omp agent is not installed or not on your PATH. Install it and try again.\",\n      };\n    }\n    if (err.code === \"EACCES\") {\n      return {\n        message: \"Permission denied running omp\",\n        category: \"config\",\n        retryable: false,\n        hint: \"Check file permissions for the omp binary.\",\n      };\n    }\n    return {\n      message: err.message,\n      category: \"process\",\n      retryable: true,\n      hint: \"An unexpected process error occurred. Try sending your prompt again.\",\n    };\n  }\n\n  private classifyErrorMessage(msg: string): AgentError {\n    const lower = msg.toLowerCase();\n    if (\n      lower.includes(\"api key\") ||\n      lower.includes(\"unauthorized\") ||\n      lower.includes(\"authentication\") ||\n      lower.includes(\"401\")\n    ) {\n      return {\n        message: msg,\n        category: \"auth\",\n        retryable: false,\n        hint: \"Check your API key configuration in Settings.\",\n      };\n    }\n    if (\n      lower.includes(\"rate limit\") ||\n      lower.includes(\"429\") ||\n      lower.includes(\"too many requests\") ||\n      lower.includes(\"quota\")\n    ) {\n      return {\n        message: msg,\n        category: \"rate_limit\",\n        retryable: true,\n        hint: \"You have hit the provider rate limit. Wait a moment and try again.\",\n      };\n    }\n    if (\n      lower.includes(\"model\") &&\n      (lower.includes(\"not found\") ||\n        lower.includes(\"not available\") ||\n        lower.includes(\"does not exist\"))\n    ) {\n      return {\n        message: msg,\n        category: \"model\",\n        retryable: false,\n        hint: \"The selected model is not available. Change the model in settings.\",\n      };\n    }\n    if (\n      lower.includes(\"context length\") ||\n      lower.includes(\"too long\") ||\n      lower.includes(\"token limit\") ||\n      lower.includes(\"max_tokens\")\n    ) {\n      return {\n        message: msg,\n        category: \"model\",\n        retryable: false,\n        hint: \"The conversation is too long. Start a new session or choose a model with a larger context window.\",\n      };\n    }\n    if (\n      lower.includes(\"timeout\") ||\n      lower.includes(\"econnrefused\") ||\n      lower.includes(\"enotfound\") ||\n      lower.includes(\"network\") ||\n      lower.includes(\"fetch failed\")\n    ) {\n      return {\n        message: msg,\n        category: \"network\",\n        retryable: true,\n        hint: \"A network error occurred. Check your connection and try again.\",\n      };\n    }\n    return { message: msg, category: \"unknown\", retryable: true };\n  }\n\n  override async listModels(): Promise<ModelEntry[]> {\n    return new Promise((resolve, reject) => {\n      execFile(\"omp\", [\"--list-models\"], { timeout: 10_000 }, (err, stdout, stderr) => {\n        if (err) {\n          reject(new Error(`omp --list-models failed: ${stderr || err.message}`));\n          return;\n        }\n        const models: ModelEntry[] = [];\n        let inCanonical = false;\n        let headerSkipped = false;\n        for (const raw of stdout.split(\"\\n\")) {\n          const line = raw.trimEnd();\n          if (!inCanonical) {\n            if (line.startsWith(\"Canonical models\")) inCanonical = true;\n            continue;\n          }\n          if (!headerSkipped) {\n            headerSkipped = true;\n            continue;\n          }\n          // blank line or a new section header ends the canonical block\n          if (line === \"\" || (!line.startsWith(\" \") && line.endsWith(\"models\"))) break;\n          const canonical = line.split(/\\s{2,}/)[0]?.trim();\n          if (canonical) models.push({ id: canonical, name: canonical });\n        }\n        resolve(models);\n      });\n    });\n  }\n\n  private cleanup(): void {\n    this.rl?.close();\n    this.rl = null;\n    this.proc = null;\n    this.ready = false;\n    this.startPromise = null;\n    this.stderrBuffer = [];\n  }\n}\n\nregisterDriver(\"omp\", (config) => new OmpDriver(config), DRIVER_CATALOG.omp);\n"]}

package/dist/bridge/index.js

@@ -0,0 +1,9 @@
+export { BridgeRuntime, EventNormalizer, createRuntime, detectFileChange, detectFileChanges, summarizeToolCall, summarizeToolResult, validateApiKey } from '../chunk-CCKGX5AS.js';
+export { AuthError, classifyClaudeSdkError } from '../chunk-EWP5HZBV.js';
+export { STATIC_MODELS, fetchProviderModels, getModels, getStaticModels } from '../chunk-KOVLSBXK.js';
+export { dispatchCapability, filterRenderCapabilities, renderFallback } from '../chunk-RRVQAE5D.js';
+export { AgentDriver, DRIVER_CATALOG, createDriver, getBridgeLogger, listDrivers, listModelsForDriver, loadDriver, registerDriver } from '../chunk-MBBTBKAS.js';
+import '../chunk-V37HONL7.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/bridge/src/capability-dispatch.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Capability dispatch helpers for bridge drivers.
+ *
+ * The runner builds a {@link BridgeCapabilityHooks} bundle from its
+ * `CapabilityRegistry` and threads it through `AgentConfig.capabilities`.
+ * Drivers consume the bundle via these helpers without taking a runtime
+ * dependency on `@skaile/workspaces/runner` (which would create a circular dep).
+ *
+ * Three behaviours are layered into a single dispatch path:
+ *
+ * 1. **Standard tool call** — the LLM invokes a capability; the bridge calls
+ *    `hooks.invoke()`, awaits the result, and returns it to the LLM.
+ * 2. **Fire-and-forget** — when the resolved Capability has `fireAndForget`
+ *    set, the bridge resolves to `{}` immediately and runs the handler in
+ *    the background. Background errors are logged but never surfaced to the
+ *    LLM since the call is already settled.
+ * 3. **Render capability** — when the resolved Capability has a non-undefined
+ *    `render`, the bridge emits `RenderInvokedEvent` to the runner via
+ *    `hooks.emitRender` and (when `render.fallback` is set) a parallel text
+ *    event via `hooks.emitText` with simple `{{prop}}` substitution. The
+ *    placeholder convention follows the v2 spec — top-level keys of `props`
+ *    only, with optional dotted-path traversal (`{{user.name}}`). The legacy
+ *    AAP `{{props.x}}` form was retired in Phase 6.
+ *
+ * @category Capabilities
+ * @since 2.0.0
+ */
+import type { Capability } from "@skaile/workspaces/types";
+import type { BridgeCapabilityHooks } from "./types.js";
+/**
+ * Result of a capability dispatch returned by {@link dispatchCapability}.
+ *
+ * The bridge feeds `{ result }` back to the LLM tool-use response. For
+ * fire-and-forget capabilities `result` is always `{}` and `background` is `true`.
+ *
+ * @docLink packages/bridge/concepts#capability-dispatch-result
+ */
+export interface CapabilityDispatchResult {
+    /** Value returned to the LLM. `{}` for fire-and-forget capabilities. */
+    result: unknown;
+    /** True when the handler is still running in the background (fire-and-forget). */
+    background: boolean;
+}
+/**
+ * Run a capability invocation through the runner-provided hooks, applying
+ * render-event emission and fire-and-forget short-circuit.
+ *
+ * The result is always shaped for direct return to the LLM. For
+ * fire-and-forget capabilities the background promise is fired and any error
+ * is logged through `onBackgroundError` (defaulting to a no-op). For all
+ * other capabilities the handler is awaited; errors propagate as a rejection
+ * so the driver can surface them as tool errors.
+ *
+ * @param hooks - Capability dispatch bundle from `AgentConfig.capabilities`.
+ * @param callId - Correlation ID for the tool-use invocation (used in render events).
+ * @param name - Registered capability name.
+ * @param input - Raw tool input from the LLM.
+ * @param onBackgroundError - Optional error handler for fire-and-forget failures.
+ * @returns Resolved dispatch result with the LLM-facing value and background flag.
+ * @docLink packages/bridge/concepts#dispatch-capability
+ */
+export declare function dispatchCapability(hooks: BridgeCapabilityHooks, callId: string, name: string, input: unknown, onBackgroundError?: (err: unknown) => void): Promise<CapabilityDispatchResult>;
+/**
+ * Substitute `{{prop}}` placeholders inside a fallback template using the
+ * input record. Top-level keys of `props` resolve directly
+ * (`{{name}}` → `props.name`); dotted paths traverse nested records
+ * (`{{user.name}}` → `props.user.name`). Missing keys collapse to an empty
+ * string; non-record inputs collapse all placeholders.
+ *
+ * The convention is fixed by the v2 spec (§1, `RenderSpec.fallback`). The
+ * legacy AAP form `{{props.x}}` is no longer accepted — author fallbacks
+ * with bare keys.
+ *
+ * Intentionally minimal — full template engines belong in the platform's
+ * render layer, not the bridge.
+ *
+ * @param template - Fallback string from `RenderSpec.fallback` with `{{key}}` placeholders.
+ * @param input - LLM tool input object; non-object values collapse all placeholders.
+ * @returns Template with all resolvable placeholders replaced.
+ * @docLink packages/bridge/concepts#render-fallback
+ */
+export declare function renderFallback(template: string, input: unknown): string;
+/**
+ * Filter a capability list to those marked as render-capable (having a `render` spec).
+ *
+ * Used by drivers that emit a separate render manifest at registration time.
+ * Currently unused in production drivers; reserved for future phases.
+ *
+ * @param caps - Full capability list to filter.
+ * @returns Subset of capabilities with a non-undefined `render` property.
+ * @docLink packages/bridge/concepts#filter-render-capabilities
+ */
+export declare function filterRenderCapabilities(caps: Capability[]): Capability[];
+//# sourceMappingURL=capability-dispatch.d.ts.map

package/dist/bridge/src/capability-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-dispatch.d.ts","sourceRoot":"","sources":["../../../bridge/src/capability-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,iBAAiB,GAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAe,GACnD,OAAO,CAAC,wBAAwB,CAAC,CA2BnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CASvE;AAcD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAEzE"}