@warlock.js/ai-cli 0.0.0-stage → 5.31.0

package/esm/adapters/codex.d.mts

@@ -0,0 +1,37 @@
+import { CliAdapter, CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/codex.d.ts
+/**
+ * OpenAI Codex CLI (`codex`, npm `@openai/codex`).
+ *
+ * Verified against the real `codex exec --help` / `codex exec resume
+ * --help` of 0.163.0, the source at tag `rust-v0.163.0` (`exec_events.rs`,
+ * the JSONL event processor, `cli.rs`) and the docs (non-interactive mode,
+ * config reference), 2026-10-17.
+ *
+ * - Headless: `codex exec --json --skip-git-repo-check <prompt>` (`-` reads
+ *   the prompt from stdin); resume is `codex exec resume … <thread_id>
+ *   <prompt>`.
+ * - Stream: `thread.started` (`thread_id`), `item.started`/`item.completed`
+ *   with `item.type` `agent_message`, `reasoning`, `command_execution`,
+ *   `file_change`, `mcp_tool_call`, `web_search`, `error`; `turn.completed`
+ *   with the thread's cumulative `usage` (`input_tokens` includes
+ *   `cached_input_tokens`); `turn.failed` and `error` on failure. No text
+ *   deltas and no cost field.
+ * - Permissions: exec never asks (approval policy "never"); `standard` keeps
+ *   Codex's default **read-only** sandbox — allow edits with
+ *   `args: ["-c", "sandbox_mode=workspace-write"]`. Bypass is
+ *   `--dangerously-bypass-approvals-and-sandbox`.
+ * - Effort: `-c model_reasoning_effort=<level>`.
+ * - MCP: no flag. With a private home the servers go into
+ *   `$CODEX_HOME/config.toml` (0600). With a caller-owned or inherited home
+ *   they are passed as `-c mcp_servers.<name>.…` overrides that carry only
+ *   the command, args and URL; secret `env` values and headers travel in the
+ *   process environment, named through `env_vars` / `env_http_headers`.
+ * - Home `CODEX_HOME`; auth `CODEX_API_KEY`.
+ */
+declare const codexAdapter: CliAdapter;
+/** Parser for `codex exec --json`. */
+declare function createCodexParser(): CliStreamParser;
+//#endregion
+export { codexAdapter, createCodexParser };
+//# sourceMappingURL=codex.d.mts.map

package/esm/adapters/codex.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/codex.ts"],"mappings":";;;;;AA+CA;;;;AA0FC;AAgJD;;;;AAAoD;;;;;;;;;;;;;;;;;cA1OvC,YAAA,EAAc,UA0F1B;;iBAgJe,iBAAA,IAAqB,eAAe"}

package/esm/adapters/codex.mjs

@@ -0,0 +1,320 @@
+import { jsonLinesParser, numberField, outputText, recordField, stringField } from "../stream/json-lines.mjs";
+import { toToml, tomlKey } from "../utils/toml.mjs";
+import { argvPrompt, mapEffort, unsupportedOption, usageOf } from "./shared.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/codex.ts
+/**
+* OpenAI Codex CLI (`codex`, npm `@openai/codex`).
+*
+* Verified against the real `codex exec --help` / `codex exec resume
+* --help` of 0.163.0, the source at tag `rust-v0.163.0` (`exec_events.rs`,
+* the JSONL event processor, `cli.rs`) and the docs (non-interactive mode,
+* config reference), 2026-10-17.
+*
+* - Headless: `codex exec --json --skip-git-repo-check <prompt>` (`-` reads
+*   the prompt from stdin); resume is `codex exec resume … <thread_id>
+*   <prompt>`.
+* - Stream: `thread.started` (`thread_id`), `item.started`/`item.completed`
+*   with `item.type` `agent_message`, `reasoning`, `command_execution`,
+*   `file_change`, `mcp_tool_call`, `web_search`, `error`; `turn.completed`
+*   with the thread's cumulative `usage` (`input_tokens` includes
+*   `cached_input_tokens`); `turn.failed` and `error` on failure. No text
+*   deltas and no cost field.
+* - Permissions: exec never asks (approval policy "never"); `standard` keeps
+*   Codex's default **read-only** sandbox — allow edits with
+*   `args: ["-c", "sandbox_mode=workspace-write"]`. Bypass is
+*   `--dangerously-bypass-approvals-and-sandbox`.
+* - Effort: `-c model_reasoning_effort=<level>`.
+* - MCP: no flag. With a private home the servers go into
+*   `$CODEX_HOME/config.toml` (0600). With a caller-owned or inherited home
+*   they are passed as `-c mcp_servers.<name>.…` overrides that carry only
+*   the command, args and URL; secret `env` values and headers travel in the
+*   process environment, named through `env_vars` / `env_http_headers`.
+* - Home `CODEX_HOME`; auth `CODEX_API_KEY`.
+*/
+const codexAdapter = {
+	name: "codex",
+	title: "Codex CLI",
+	command: "codex",
+	apiKeyEnv: ["CODEX_API_KEY"],
+	homeEnv: ["CODEX_HOME"],
+	transports: ["argv", "stdin"],
+	effort: true,
+	mcp: true,
+	probe: {
+		help: [["exec", "--help"], [
+			"exec",
+			"resume",
+			"--help"
+		]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "0.163.0",
+		verifiedBy: "help",
+		sources: [
+			"https://developers.openai.com/codex/noninteractive",
+			"https://developers.openai.com/codex/config-reference",
+			"https://github.com/openai/codex/blob/rust-v0.163.0/codex-rs/exec/src/exec_events.rs"
+		],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = ["exec"];
+		const requires = [
+			"exec",
+			"--json",
+			"--skip-git-repo-check"
+		];
+		const files = [];
+		const env = {};
+		if (context.resume !== void 0) {
+			args.push("resume");
+			requires.push("resume");
+		}
+		args.push("--json", "--skip-git-repo-check", "-c", "check_for_update_on_startup=false");
+		if (context.model !== void 0) {
+			args.push("--model", context.model);
+			requires.push("--model");
+		}
+		if (context.effort !== void 0) {
+			const effort = mapEffort(context.effort, {
+				low: "low",
+				medium: "medium",
+				high: "high",
+				xhigh: "xhigh",
+				max: "max"
+			});
+			args.push("-c", `model_reasoning_effort=${effort}`);
+			requires.push("--config");
+		}
+		if (context.permission === "bypass") {
+			args.push("--dangerously-bypass-approvals-and-sandbox");
+			requires.push("--dangerously-bypass-approvals-and-sandbox");
+		}
+		if (context.mcp !== void 0) if (context.home !== void 0 && context.homeIsPrivate) files.push({
+			path: path.join(context.home, "config.toml"),
+			content: toToml({ mcp_servers: codexMcpTable(context.mcp) })
+		});
+		else {
+			args.push(...codexMcpOverrides(context.mcp, env));
+			requires.push("--config");
+		}
+		if (context.home !== void 0) env.CODEX_HOME = context.home;
+		const prompt = context.transport === "argv" ? argvPrompt(context.prompt) : "-";
+		return {
+			args,
+			tail: context.resume !== void 0 ? [context.resume, prompt] : [prompt],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env,
+			files,
+			requires
+		};
+	},
+	parser: createCodexParser
+};
+/** `[mcp_servers.<name>]` tables for a private `config.toml`. */
+function codexMcpTable(servers) {
+	const table = {};
+	for (const [name, server] of Object.entries(servers)) {
+		if (server.type === "sse") throw unsupportedOption(codexAdapter, `MCP server "${name}" uses SSE; Codex supports stdio and streamable HTTP.`);
+		table[name] = server.type === "stdio" ? {
+			command: server.command,
+			args: server.args ?? [],
+			env: server.env
+		} : {
+			url: server.url,
+			http_headers: server.headers
+		};
+	}
+	return table;
+}
+/** A TOML string for a `-c key=value` override. */
+function tomlString(value) {
+	return JSON.stringify(value);
+}
+/**
+* `-c` overrides that carry no secret: env values and header values are put
+* in `env` (the Codex process environment) and only their names go to argv.
+*/
+function codexMcpOverrides(servers, env) {
+	const overrides = [];
+	const claim = (name, value) => {
+		if (env[name] !== void 0 && env[name] !== value) throw unsupportedOption(codexAdapter, `two MCP servers set ${name} to different values; with a shared home they share one environment.`);
+		env[name] = value;
+	};
+	for (const [name, server] of Object.entries(servers)) {
+		const prefix = `mcp_servers.${tomlKey(name)}`;
+		if (server.type === "sse") throw unsupportedOption(codexAdapter, `MCP server "${name}" uses SSE; Codex supports stdio and streamable HTTP.`);
+		if (server.type === "stdio") {
+			overrides.push("-c", `${prefix}.command=${tomlString(server.command)}`);
+			overrides.push("-c", `${prefix}.args=[${(server.args ?? []).map(tomlString).join(",")}]`);
+			const names = Object.keys(server.env ?? {});
+			for (const [key, value] of Object.entries(server.env ?? {})) claim(key, value);
+			if (names.length > 0) overrides.push("-c", `${prefix}.env_vars=[${names.map(tomlString).join(",")}]`);
+			continue;
+		}
+		overrides.push("-c", `${prefix}.url=${tomlString(server.url)}`);
+		const headers = Object.entries(server.headers ?? {});
+		if (headers.length > 0) {
+			const mapping = headers.map(([header, value], index) => {
+				const variable = `WARLOCK_MCP_${name.replace(/\W/g, "_").toUpperCase()}_HEADER_${index}`;
+				claim(variable, value);
+				return `${tomlString(header)}=${tomlString(variable)}`;
+			});
+			overrides.push("-c", `${prefix}.env_http_headers={${mapping.join(",")}}`);
+		}
+	}
+	return overrides;
+}
+const TOOL_ITEMS = new Set([
+	"command_execution",
+	"file_change",
+	"mcp_tool_call",
+	"web_search",
+	"collab_tool_call"
+]);
+function toolCall(item) {
+	switch (stringField(item, "type")) {
+		case "command_execution": return {
+			name: "shell",
+			input: { command: item.command }
+		};
+		case "file_change": return {
+			name: "apply_patch",
+			input: { changes: item.changes }
+		};
+		case "mcp_tool_call": return {
+			name: `${stringField(item, "server") ?? "mcp"}.${stringField(item, "tool") ?? "tool"}`,
+			input: item.arguments
+		};
+		case "web_search": return {
+			name: "web_search",
+			input: { query: item.query }
+		};
+		default: return {
+			name: stringField(item, "type") ?? "tool",
+			input: item
+		};
+	}
+}
+function toolResult(item) {
+	const status = stringField(item, "status");
+	const failed = status === "failed" || status === "declined";
+	switch (stringField(item, "type")) {
+		case "command_execution": {
+			const exitCode = numberField(item, "exit_code");
+			return {
+				output: stringField(item, "aggregated_output") ?? "",
+				isError: failed || exitCode !== void 0 && exitCode !== 0
+			};
+		}
+		case "mcp_tool_call": {
+			const error = stringField(recordField(item, "error"), "message");
+			return error !== void 0 ? {
+				output: error,
+				isError: true
+			} : {
+				output: outputText(recordField(item, "result")?.content),
+				isError: failed
+			};
+		}
+		default: return {
+			output: outputText(item.changes ?? item.result ?? ""),
+			isError: failed
+		};
+	}
+}
+/** Parser for `codex exec --json`. */
+function createCodexParser() {
+	const announced = /* @__PURE__ */ new Set();
+	return jsonLinesParser((record) => {
+		const type = stringField(record, "type");
+		const item = recordField(record, "item");
+		const itemType = stringField(item, "type");
+		const id = stringField(item, "id") ?? "";
+		if (type === "thread.started") return [{
+			type: "session.started",
+			sessionRef: stringField(record, "thread_id"),
+			raw: record
+		}];
+		if (type === "item.started" && item !== void 0 && itemType !== void 0 && TOOL_ITEMS.has(itemType)) {
+			announced.add(id);
+			return [{
+				type: "tool.call",
+				id,
+				...toolCall(item),
+				raw: record
+			}];
+		}
+		if (type === "item.completed" && item !== void 0) {
+			if (itemType === "agent_message") {
+				const text = stringField(item, "text") ?? "";
+				return text.length > 0 ? [{
+					type: "message",
+					text,
+					delta: false,
+					raw: record
+				}] : [];
+			}
+			if (itemType === "error") return [{
+				type: "error",
+				message: stringField(item, "message") ?? "error",
+				raw: record
+			}];
+			if (itemType !== void 0 && TOOL_ITEMS.has(itemType)) {
+				const events = [];
+				if (!announced.has(id)) events.push({
+					type: "tool.call",
+					id,
+					...toolCall(item),
+					raw: record
+				});
+				events.push({
+					type: "tool.result",
+					id,
+					...toolResult(item),
+					raw: record
+				});
+				return events;
+			}
+			return [];
+		}
+		if (type === "turn.completed") {
+			const usage = recordField(record, "usage");
+			if (usage === void 0) return [];
+			const cached = numberField(usage, "cached_input_tokens");
+			const written = numberField(usage, "cache_write_input_tokens");
+			return [{
+				type: "usage",
+				cumulative: true,
+				usage: usageOf({
+					input: numberField(usage, "input_tokens"),
+					output: numberField(usage, "output_tokens"),
+					cachedTokens: cached !== void 0 && cached > 0 ? cached : void 0,
+					cacheWriteTokens: written !== void 0 && written > 0 ? written : void 0,
+					reasoningTokens: numberField(usage, "reasoning_output_tokens") || void 0
+				}),
+				raw: record
+			}];
+		}
+		if (type === "turn.failed") return [{
+			type: "error",
+			message: stringField(recordField(record, "error"), "message") ?? "Codex turn failed",
+			fatal: true,
+			raw: record
+		}];
+		if (type === "error") return [{
+			type: "error",
+			message: stringField(record, "message") ?? "Codex error",
+			fatal: true,
+			raw: record
+		}];
+		return [];
+	});
+}
+
+//#endregion
+export { codexAdapter, createCodexParser };
+//# sourceMappingURL=codex.mjs.map

package/esm/adapters/codex.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/codex.ts"],"sourcesContent":["import path from \"node:path\";\nimport type {\n  CliAdapter,\n  CliLaunchFile,\n  CliMcpServers,\n  CliParsedEvent,\n  CliStreamParser,\n} from \"../contracts\";\nimport {\n  jsonLinesParser,\n  numberField,\n  outputText,\n  recordField,\n  stringField,\n} from \"../stream/json-lines\";\nimport { type TomlTable, tomlKey, toToml } from \"../utils/toml\";\nimport { argvPrompt, mapEffort, unsupportedOption, usageOf } from \"./shared\";\n\n/**\n * OpenAI Codex CLI (`codex`, npm `@openai/codex`).\n *\n * Verified against the real `codex exec --help` / `codex exec resume\n * --help` of 0.163.0, the source at tag `rust-v0.163.0` (`exec_events.rs`,\n * the JSONL event processor, `cli.rs`) and the docs (non-interactive mode,\n * config reference), 2026-10-17.\n *\n * - Headless: `codex exec --json --skip-git-repo-check <prompt>` (`-` reads\n *   the prompt from stdin); resume is `codex exec resume … <thread_id>\n *   <prompt>`.\n * - Stream: `thread.started` (`thread_id`), `item.started`/`item.completed`\n *   with `item.type` `agent_message`, `reasoning`, `command_execution`,\n *   `file_change`, `mcp_tool_call`, `web_search`, `error`; `turn.completed`\n *   with the thread's cumulative `usage` (`input_tokens` includes\n *   `cached_input_tokens`); `turn.failed` and `error` on failure. No text\n *   deltas and no cost field.\n * - Permissions: exec never asks (approval policy \"never\"); `standard` keeps\n *   Codex's default **read-only** sandbox — allow edits with\n *   `args: [\"-c\", \"sandbox_mode=workspace-write\"]`. Bypass is\n *   `--dangerously-bypass-approvals-and-sandbox`.\n * - Effort: `-c model_reasoning_effort=<level>`.\n * - MCP: no flag. With a private home the servers go into\n *   `$CODEX_HOME/config.toml` (0600). With a caller-owned or inherited home\n *   they are passed as `-c mcp_servers.<name>.…` overrides that carry only\n *   the command, args and URL; secret `env` values and headers travel in the\n *   process environment, named through `env_vars` / `env_http_headers`.\n * - Home `CODEX_HOME`; auth `CODEX_API_KEY`.\n */\nexport const codexAdapter: CliAdapter = {\n  name: \"codex\",\n  title: \"Codex CLI\",\n  command: \"codex\",\n  apiKeyEnv: [\"CODEX_API_KEY\"],\n  homeEnv: [\"CODEX_HOME\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: true,\n  mcp: true,\n  probe: {\n    help: [\n      [\"exec\", \"--help\"],\n      [\"exec\", \"resume\", \"--help\"],\n    ],\n    version: [\"--version\"],\n  },\n  verification: {\n    version: \"0.163.0\",\n    verifiedBy: \"help\",\n    sources: [\n      \"https://developers.openai.com/codex/noninteractive\",\n      \"https://developers.openai.com/codex/config-reference\",\n      \"https://github.com/openai/codex/blob/rust-v0.163.0/codex-rs/exec/src/exec_events.rs\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\"exec\"];\n    const requires = [\"exec\", \"--json\", \"--skip-git-repo-check\"];\n    const files: CliLaunchFile[] = [];\n    const env: Record<string, string> = {};\n\n    if (context.resume !== undefined) {\n      args.push(\"resume\");\n      requires.push(\"resume\");\n    }\n\n    args.push(\"--json\", \"--skip-git-repo-check\", \"-c\", \"check_for_update_on_startup=false\");\n\n    if (context.model !== undefined) {\n      args.push(\"--model\", context.model);\n      requires.push(\"--model\");\n    }\n\n    if (context.effort !== undefined) {\n      const effort = mapEffort(context.effort, {\n        low: \"low\",\n        medium: \"medium\",\n        high: \"high\",\n        xhigh: \"xhigh\",\n        max: \"max\",\n      });\n\n      args.push(\"-c\", `model_reasoning_effort=${effort}`);\n      requires.push(\"--config\");\n    }\n\n    if (context.permission === \"bypass\") {\n      args.push(\"--dangerously-bypass-approvals-and-sandbox\");\n      requires.push(\"--dangerously-bypass-approvals-and-sandbox\");\n    }\n\n    if (context.mcp !== undefined) {\n      if (context.home !== undefined && context.homeIsPrivate) {\n        files.push({\n          path: path.join(context.home, \"config.toml\"),\n          content: toToml({ mcp_servers: codexMcpTable(context.mcp) }),\n        });\n      } else {\n        args.push(...codexMcpOverrides(context.mcp, env));\n        requires.push(\"--config\");\n      }\n    }\n\n    if (context.home !== undefined) {\n      env.CODEX_HOME = context.home;\n    }\n\n    const prompt = context.transport === \"argv\" ? argvPrompt(context.prompt) : \"-\";\n\n    return {\n      args,\n      tail: context.resume !== undefined ? [context.resume, prompt] : [prompt],\n      stdin: context.transport === \"stdin\" ? context.prompt : undefined,\n      env,\n      files,\n      requires,\n    };\n  },\n  parser: createCodexParser,\n};\n\n/** `[mcp_servers.<name>]` tables for a private `config.toml`. */\nfunction codexMcpTable(servers: CliMcpServers): TomlTable {\n  const table: TomlTable = {};\n\n  for (const [name, server] of Object.entries(servers)) {\n    if (server.type === \"sse\") {\n      throw unsupportedOption(\n        codexAdapter,\n        `MCP server \"${name}\" uses SSE; Codex supports stdio and streamable HTTP.`,\n      );\n    }\n\n    table[name] =\n      server.type === \"stdio\"\n        ? { command: server.command, args: server.args ?? [], env: server.env }\n        : { url: server.url, http_headers: server.headers };\n  }\n\n  return table;\n}\n\n/** A TOML string for a `-c key=value` override. */\nfunction tomlString(value: string): string {\n  return JSON.stringify(value);\n}\n\n/**\n * `-c` overrides that carry no secret: env values and header values are put\n * in `env` (the Codex process environment) and only their names go to argv.\n */\nfunction codexMcpOverrides(servers: CliMcpServers, env: Record<string, string>): string[] {\n  const overrides: string[] = [];\n  const claim = (name: string, value: string): void => {\n    if (env[name] !== undefined && env[name] !== value) {\n      throw unsupportedOption(\n        codexAdapter,\n        `two MCP servers set ${name} to different values; with a shared home they share one environment.`,\n      );\n    }\n\n    env[name] = value;\n  };\n\n  for (const [name, server] of Object.entries(servers)) {\n    const prefix = `mcp_servers.${tomlKey(name)}`;\n\n    if (server.type === \"sse\") {\n      throw unsupportedOption(\n        codexAdapter,\n        `MCP server \"${name}\" uses SSE; Codex supports stdio and streamable HTTP.`,\n      );\n    }\n\n    if (server.type === \"stdio\") {\n      overrides.push(\"-c\", `${prefix}.command=${tomlString(server.command)}`);\n      overrides.push(\"-c\", `${prefix}.args=[${(server.args ?? []).map(tomlString).join(\",\")}]`);\n\n      const names = Object.keys(server.env ?? {});\n\n      for (const [key, value] of Object.entries(server.env ?? {})) {\n        claim(key, value);\n      }\n\n      if (names.length > 0) {\n        overrides.push(\"-c\", `${prefix}.env_vars=[${names.map(tomlString).join(\",\")}]`);\n      }\n\n      continue;\n    }\n\n    overrides.push(\"-c\", `${prefix}.url=${tomlString(server.url)}`);\n\n    const headers = Object.entries(server.headers ?? {});\n\n    if (headers.length > 0) {\n      const mapping = headers.map(([header, value], index) => {\n        const variable = `WARLOCK_MCP_${name.replace(/\\W/g, \"_\").toUpperCase()}_HEADER_${index}`;\n\n        claim(variable, value);\n\n        return `${tomlString(header)}=${tomlString(variable)}`;\n      });\n\n      overrides.push(\"-c\", `${prefix}.env_http_headers={${mapping.join(\",\")}}`);\n    }\n  }\n\n  return overrides;\n}\n\nconst TOOL_ITEMS = new Set([\n  \"command_execution\",\n  \"file_change\",\n  \"mcp_tool_call\",\n  \"web_search\",\n  \"collab_tool_call\",\n]);\n\nfunction toolCall(item: Record<string, unknown>): { name: string; input: unknown } {\n  switch (stringField(item, \"type\")) {\n    case \"command_execution\":\n      return { name: \"shell\", input: { command: item.command } };\n    case \"file_change\":\n      return { name: \"apply_patch\", input: { changes: item.changes } };\n    case \"mcp_tool_call\":\n      return {\n        name: `${stringField(item, \"server\") ?? \"mcp\"}.${stringField(item, \"tool\") ?? \"tool\"}`,\n        input: item.arguments,\n      };\n    case \"web_search\":\n      return { name: \"web_search\", input: { query: item.query } };\n    default:\n      return { name: stringField(item, \"type\") ?? \"tool\", input: item };\n  }\n}\n\nfunction toolResult(item: Record<string, unknown>): { output: string; isError: boolean } {\n  const status = stringField(item, \"status\");\n  const failed = status === \"failed\" || status === \"declined\";\n\n  switch (stringField(item, \"type\")) {\n    case \"command_execution\": {\n      const exitCode = numberField(item, \"exit_code\");\n\n      return {\n        output: stringField(item, \"aggregated_output\") ?? \"\",\n        isError: failed || (exitCode !== undefined && exitCode !== 0),\n      };\n    }\n    case \"mcp_tool_call\": {\n      const error = stringField(recordField(item, \"error\"), \"message\");\n\n      return error !== undefined\n        ? { output: error, isError: true }\n        : { output: outputText(recordField(item, \"result\")?.content), isError: failed };\n    }\n    default:\n      return { output: outputText(item.changes ?? item.result ?? \"\"), isError: failed };\n  }\n}\n\n/** Parser for `codex exec --json`. */\nexport function createCodexParser(): CliStreamParser {\n  const announced = new Set<string>();\n\n  return jsonLinesParser((record): CliParsedEvent[] => {\n    const type = stringField(record, \"type\");\n    const item = recordField(record, \"item\");\n    const itemType = stringField(item, \"type\");\n    const id = stringField(item, \"id\") ?? \"\";\n\n    if (type === \"thread.started\") {\n      return [\n        { type: \"session.started\", sessionRef: stringField(record, \"thread_id\"), raw: record },\n      ];\n    }\n\n    if (\n      type === \"item.started\" &&\n      item !== undefined &&\n      itemType !== undefined &&\n      TOOL_ITEMS.has(itemType)\n    ) {\n      announced.add(id);\n\n      return [{ type: \"tool.call\", id, ...toolCall(item), raw: record }];\n    }\n\n    if (type === \"item.completed\" && item !== undefined) {\n      if (itemType === \"agent_message\") {\n        const text = stringField(item, \"text\") ?? \"\";\n\n        return text.length > 0 ? [{ type: \"message\", text, delta: false, raw: record }] : [];\n      }\n\n      if (itemType === \"error\") {\n        return [{ type: \"error\", message: stringField(item, \"message\") ?? \"error\", raw: record }];\n      }\n\n      if (itemType !== undefined && TOOL_ITEMS.has(itemType)) {\n        const events: CliParsedEvent[] = [];\n\n        if (!announced.has(id)) {\n          events.push({ type: \"tool.call\", id, ...toolCall(item), raw: record });\n        }\n\n        events.push({ type: \"tool.result\", id, ...toolResult(item), raw: record });\n\n        return events;\n      }\n\n      return [];\n    }\n\n    if (type === \"turn.completed\") {\n      const usage = recordField(record, \"usage\");\n\n      if (usage === undefined) {\n        return [];\n      }\n\n      const cached = numberField(usage, \"cached_input_tokens\");\n      const written = numberField(usage, \"cache_write_input_tokens\");\n\n      return [\n        {\n          type: \"usage\",\n          cumulative: true,\n          usage: usageOf({\n            input: numberField(usage, \"input_tokens\"),\n            output: numberField(usage, \"output_tokens\"),\n            cachedTokens: cached !== undefined && cached > 0 ? cached : undefined,\n            cacheWriteTokens: written !== undefined && written > 0 ? written : undefined,\n            reasoningTokens: numberField(usage, \"reasoning_output_tokens\") || undefined,\n          }),\n          raw: record,\n        },\n      ];\n    }\n\n    if (type === \"turn.failed\") {\n      return [\n        {\n          type: \"error\",\n          message: stringField(recordField(record, \"error\"), \"message\") ?? \"Codex turn failed\",\n          fatal: true,\n          raw: record,\n        },\n      ];\n    }\n\n    if (type === \"error\") {\n      return [\n        {\n          type: \"error\",\n          message: stringField(record, \"message\") ?? \"Codex error\",\n          fatal: true,\n          raw: record,\n        },\n      ];\n    }\n\n    return [];\n  });\n}\n"],"mappings":"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"}

package/esm/adapters/copilot.d.mts

@@ -0,0 +1,35 @@
+import { CliAdapter, CliLaunchContext, CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/copilot.d.ts
+/**
+ * GitHub Copilot CLI (`copilot`, npm `@github/copilot`).
+ *
+ * Verified against the real `copilot --help` of 1.0.98, the JSONL writer in
+ * the shipped CLI, the event types of `@github/copilot-sdk` 1.0.22 and the
+ * docs (`docs.github.com/copilot/how-tos/copilot-cli/…`, programmatic and
+ * command references), 2026-10-17.
+ *
+ * - Headless: `copilot -p <prompt> --output-format json --stream on`
+ *   (piped stdin is the prompt when `-p` is absent). Stream lines are
+ *   session events `{type,data,id,timestamp}`: `assistant.message_delta`
+ *   (`deltaContent`), `assistant.message` (`content`),
+ *   `tool.execution_start` (`toolCallId`, `toolName`, `arguments`),
+ *   `tool.execution_complete` (`success`, `result.content`,
+ *   `error.message`), `session.error`, and a final CLI-built `result`
+ *   (`sessionId`, `exitCode`, premium-request usage).
+ * - Tokens are not in the stream; the adapter passes `--usage-output-file`
+ *   and reads `modelMetrics.*.usage` from it when the stream ends. Billing
+ *   is in premium requests, so no USD cost is reported.
+ * - Permissions: unapproved tool requests are auto-denied in `-p` mode;
+ *   bypass is `--allow-all` (tools, paths and URLs). `--no-ask-user` and
+ *   `--no-auto-update` are always passed.
+ * - MCP: `--additional-mcp-config @<file>` (`mcpServers`, `type`
+ *   `local`/`http`/`sse`, `tools: ["*"]`), written to the run directory.
+ * - Home `COPILOT_HOME`; auth `COPILOT_GITHUB_TOKEN`. Resume with
+ *   `--session-id <id>`.
+ */
+declare const copilotAdapter: CliAdapter;
+/** Parser for `copilot -p … --output-format json` (plus its usage file). */
+declare function createCopilotParser(context?: CliLaunchContext): CliStreamParser;
+//#endregion
+export { copilotAdapter, createCopilotParser };
+//# sourceMappingURL=copilot.d.mts.map

package/esm/adapters/copilot.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/copilot.ts"],"mappings":";;;;;AAkDA;;;;AAsFC;AAqDD;;;;;;;;AAAgF;;;;;;;;;;;cA3InE,cAAA,EAAgB,UAsF5B;;iBAqDe,mBAAA,CAAoB,OAAA,GAAU,gBAAA,GAAmB,eAAe"}