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

package/esm/adapters/opencode.mjs

@@ -0,0 +1,219 @@
+import { asRecord, jsonLinesParser, numberField, recordField, stringField } from "../stream/json-lines.mjs";
+import { argvPrompt, jsonFile, usageOf } from "./shared.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/opencode.ts
+/**
+* OpenCode (`opencode`, npm `opencode-ai`).
+*
+* Verified against the real `opencode --help` / `opencode run --help` of
+* 1.19.3, the CLI source at that tag (`packages/opencode/src/cli/cmd/run.ts`)
+* and the docs (`cli.mdx`, `config.mdx`, `mcp-servers.mdx`,
+* `permissions.mdx`), 2026-10-17.
+*
+* - Headless: `opencode run --format json <message..>`; with no message,
+*   piped stdin is the prompt.
+* - Stream: `{"type","timestamp","sessionID","part"|"error"}` lines of six
+*   types: `step_start`, `text` (whole text blocks, no deltas), `reasoning`,
+*   `tool_use` (emitted once the tool finished — call and result together,
+*   `state.status` `completed`/`error`), `step_finish` (per-step `cost` in
+*   USD and `tokens{input,output,reasoning,cache{read,write}}`, input net of
+*   cache) and `error{error:{name,data:{message}}}`. No init or final record.
+* - Permissions: `standard` keeps OpenCode's own rules (permissive by
+*   default; anything that would ask is auto-rejected in `run`); bypass is
+*   `--auto`.
+* - MCP: the `mcp` key of a config file named by `OPENCODE_CONFIG`, written
+*   to the run directory — works with any home.
+* - Home: OpenCode follows XDG; a private/owned home sets `XDG_CONFIG_HOME`,
+*   `XDG_DATA_HOME` (auth lives here), `XDG_STATE_HOME` and `XDG_CACHE_HOME`
+*   beneath it. Provider keys use the provider's own variable
+*   (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …) — pass them through `env`.
+* - The working directory is passed with `--dir`, because OpenCode prefers a
+*   (possibly stale) `PWD` over the process cwd.
+*/
+const opencodeAdapter = {
+	name: "opencode",
+	title: "OpenCode",
+	command: "opencode",
+	apiKeyEnv: [],
+	homeEnv: [
+		"XDG_CONFIG_HOME",
+		"XDG_DATA_HOME",
+		"XDG_STATE_HOME",
+		"XDG_CACHE_HOME"
+	],
+	transports: ["argv", "stdin"],
+	effort: true,
+	mcp: true,
+	probe: {
+		help: [["run", "--help"]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "1.19.3",
+		verifiedBy: "help",
+		sources: [
+			"https://opencode.ai/docs/cli/",
+			"https://opencode.ai/docs/mcp-servers/",
+			"https://opencode.ai/docs/permissions/",
+			"https://github.com/anomalyco/opencode/blob/v1.19.3/packages/opencode/src/cli/cmd/run.ts"
+		],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = [
+			"run",
+			"--format",
+			"json",
+			"--dir",
+			context.cwd
+		];
+		const requires = ["--format", "--dir"];
+		const files = [];
+		const env = { OPENCODE_DISABLE_AUTOUPDATE: "1" };
+		if (context.model !== void 0) {
+			args.push("--model", context.model);
+			requires.push("--model");
+		}
+		if (context.effort !== void 0) {
+			args.push("--variant", context.effort);
+			requires.push("--variant");
+		}
+		if (context.resume !== void 0) {
+			args.push("--session", context.resume);
+			requires.push("--session");
+		}
+		if (context.permission === "bypass") {
+			args.push("--auto");
+			requires.push("--auto");
+		}
+		if (context.mcp !== void 0) {
+			const file = path.join(context.runDir, "opencode.json");
+			files.push({
+				path: file,
+				content: jsonFile({
+					$schema: "https://opencode.ai/config.json",
+					mcp: opencodeMcp(context.mcp)
+				})
+			});
+			env.OPENCODE_CONFIG = file;
+		}
+		if (context.home !== void 0) {
+			env.XDG_CONFIG_HOME = path.join(context.home, "config");
+			env.XDG_DATA_HOME = path.join(context.home, "data");
+			env.XDG_STATE_HOME = path.join(context.home, "state");
+			env.XDG_CACHE_HOME = path.join(context.home, "cache");
+		}
+		return {
+			args,
+			tail: context.transport === "argv" ? [argvPrompt(context.prompt)] : [],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env,
+			files,
+			requires
+		};
+	},
+	parser: createOpencodeParser
+};
+function opencodeMcp(servers) {
+	const rendered = {};
+	for (const [name, server] of Object.entries(servers)) rendered[name] = server.type === "stdio" ? {
+		type: "local",
+		command: [server.command, ...server.args ?? []],
+		...server.env !== void 0 ? { environment: server.env } : {},
+		enabled: true
+	} : {
+		type: "remote",
+		url: server.url,
+		...server.headers !== void 0 ? { headers: server.headers } : {},
+		enabled: true
+	};
+	return rendered;
+}
+/** Parser for `opencode run --format json`. */
+function createOpencodeParser() {
+	let started = false;
+	return jsonLinesParser((record) => {
+		const events = [];
+		const part = recordField(record, "part");
+		if (!started) {
+			started = true;
+			events.push({
+				type: "session.started",
+				sessionRef: stringField(record, "sessionID"),
+				raw: record
+			});
+		}
+		switch (stringField(record, "type")) {
+			case "text": {
+				const text = stringField(part, "text") ?? "";
+				if (text.length > 0) events.push({
+					type: "message",
+					text,
+					delta: false,
+					raw: record
+				});
+				break;
+			}
+			case "tool_use": {
+				const state = recordField(part, "state");
+				const id = stringField(part, "callID") ?? stringField(part, "id") ?? "";
+				const failed = stringField(state, "status") === "error";
+				events.push({
+					type: "tool.call",
+					id,
+					name: stringField(part, "tool") ?? "",
+					input: state?.input,
+					raw: record
+				}, {
+					type: "tool.result",
+					id,
+					output: (failed ? stringField(state, "error") : stringField(state, "output")) ?? "",
+					isError: failed,
+					raw: record
+				});
+				break;
+			}
+			case "step_finish": {
+				const tokens = recordField(part, "tokens");
+				const cache = recordField(tokens, "cache");
+				if (tokens !== void 0) {
+					const uncached = numberField(tokens, "input") ?? 0;
+					const cacheRead = numberField(cache, "read") ?? 0;
+					const cacheWrite = numberField(cache, "write") ?? 0;
+					events.push({
+						type: "usage",
+						cumulative: false,
+						usage: usageOf({
+							input: uncached + cacheRead + cacheWrite,
+							output: numberField(tokens, "output"),
+							cachedTokens: cacheRead > 0 ? cacheRead : void 0,
+							cacheWriteTokens: cacheWrite > 0 ? cacheWrite : void 0,
+							reasoningTokens: numberField(tokens, "reasoning") || void 0,
+							costUSD: numberField(part, "cost")
+						}),
+						raw: record
+					});
+				}
+				break;
+			}
+			case "error": {
+				const error = asRecord(record.error);
+				const name = stringField(error, "name") ?? "Error";
+				const message = stringField(recordField(error, "data"), "message") ?? name;
+				events.push({
+					type: "error",
+					message: `${name}: ${message}`,
+					fatal: true,
+					raw: record
+				});
+				break;
+			}
+		}
+		return events;
+	});
+}
+
+//#endregion
+export { createOpencodeParser, opencodeAdapter };
+//# sourceMappingURL=opencode.mjs.map

package/esm/adapters/opencode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/opencode.ts"],"sourcesContent":["import path from \"node:path\";\nimport type {\n  CliAdapter,\n  CliLaunchFile,\n  CliMcpServers,\n  CliParsedEvent,\n  CliStreamParser,\n} from \"../contracts\";\nimport {\n  asRecord,\n  jsonLinesParser,\n  numberField,\n  recordField,\n  stringField,\n} from \"../stream/json-lines\";\nimport { argvPrompt, jsonFile, usageOf } from \"./shared\";\n\n/**\n * OpenCode (`opencode`, npm `opencode-ai`).\n *\n * Verified against the real `opencode --help` / `opencode run --help` of\n * 1.19.3, the CLI source at that tag (`packages/opencode/src/cli/cmd/run.ts`)\n * and the docs (`cli.mdx`, `config.mdx`, `mcp-servers.mdx`,\n * `permissions.mdx`), 2026-10-17.\n *\n * - Headless: `opencode run --format json <message..>`; with no message,\n *   piped stdin is the prompt.\n * - Stream: `{\"type\",\"timestamp\",\"sessionID\",\"part\"|\"error\"}` lines of six\n *   types: `step_start`, `text` (whole text blocks, no deltas), `reasoning`,\n *   `tool_use` (emitted once the tool finished — call and result together,\n *   `state.status` `completed`/`error`), `step_finish` (per-step `cost` in\n *   USD and `tokens{input,output,reasoning,cache{read,write}}`, input net of\n *   cache) and `error{error:{name,data:{message}}}`. No init or final record.\n * - Permissions: `standard` keeps OpenCode's own rules (permissive by\n *   default; anything that would ask is auto-rejected in `run`); bypass is\n *   `--auto`.\n * - MCP: the `mcp` key of a config file named by `OPENCODE_CONFIG`, written\n *   to the run directory — works with any home.\n * - Home: OpenCode follows XDG; a private/owned home sets `XDG_CONFIG_HOME`,\n *   `XDG_DATA_HOME` (auth lives here), `XDG_STATE_HOME` and `XDG_CACHE_HOME`\n *   beneath it. Provider keys use the provider's own variable\n *   (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, …) — pass them through `env`.\n * - The working directory is passed with `--dir`, because OpenCode prefers a\n *   (possibly stale) `PWD` over the process cwd.\n */\nexport const opencodeAdapter: CliAdapter = {\n  name: \"opencode\",\n  title: \"OpenCode\",\n  command: \"opencode\",\n  apiKeyEnv: [],\n  homeEnv: [\"XDG_CONFIG_HOME\", \"XDG_DATA_HOME\", \"XDG_STATE_HOME\", \"XDG_CACHE_HOME\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: true,\n  mcp: true,\n  probe: { help: [[\"run\", \"--help\"]], version: [\"--version\"] },\n  verification: {\n    version: \"1.19.3\",\n    verifiedBy: \"help\",\n    sources: [\n      \"https://opencode.ai/docs/cli/\",\n      \"https://opencode.ai/docs/mcp-servers/\",\n      \"https://opencode.ai/docs/permissions/\",\n      \"https://github.com/anomalyco/opencode/blob/v1.19.3/packages/opencode/src/cli/cmd/run.ts\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\"run\", \"--format\", \"json\", \"--dir\", context.cwd];\n    const requires = [\"--format\", \"--dir\"];\n    const files: CliLaunchFile[] = [];\n    const env: Record<string, string> = { OPENCODE_DISABLE_AUTOUPDATE: \"1\" };\n\n    if (context.model !== undefined) {\n      args.push(\"--model\", context.model);\n      requires.push(\"--model\");\n    }\n\n    if (context.effort !== undefined) {\n      // `--variant` is provider-specific (\"high, max, minimal\"); the level is passed as-is.\n      args.push(\"--variant\", context.effort);\n      requires.push(\"--variant\");\n    }\n\n    if (context.resume !== undefined) {\n      args.push(\"--session\", context.resume);\n      requires.push(\"--session\");\n    }\n\n    if (context.permission === \"bypass\") {\n      args.push(\"--auto\");\n      requires.push(\"--auto\");\n    }\n\n    if (context.mcp !== undefined) {\n      const file = path.join(context.runDir, \"opencode.json\");\n\n      files.push({\n        path: file,\n        content: jsonFile({\n          $schema: \"https://opencode.ai/config.json\",\n          mcp: opencodeMcp(context.mcp),\n        }),\n      });\n      env.OPENCODE_CONFIG = file;\n    }\n\n    if (context.home !== undefined) {\n      env.XDG_CONFIG_HOME = path.join(context.home, \"config\");\n      env.XDG_DATA_HOME = path.join(context.home, \"data\");\n      env.XDG_STATE_HOME = path.join(context.home, \"state\");\n      env.XDG_CACHE_HOME = path.join(context.home, \"cache\");\n    }\n\n    return {\n      args,\n      tail: context.transport === \"argv\" ? [argvPrompt(context.prompt)] : [],\n      stdin: context.transport === \"stdin\" ? context.prompt : undefined,\n      env,\n      files,\n      requires,\n    };\n  },\n  parser: createOpencodeParser,\n};\n\nfunction opencodeMcp(servers: CliMcpServers): Record<string, unknown> {\n  const rendered: Record<string, unknown> = {};\n\n  for (const [name, server] of Object.entries(servers)) {\n    rendered[name] =\n      server.type === \"stdio\"\n        ? {\n            type: \"local\",\n            command: [server.command, ...(server.args ?? [])],\n            ...(server.env !== undefined ? { environment: server.env } : {}),\n            enabled: true,\n          }\n        : {\n            type: \"remote\",\n            url: server.url,\n            ...(server.headers !== undefined ? { headers: server.headers } : {}),\n            enabled: true,\n          };\n  }\n\n  return rendered;\n}\n\n/** Parser for `opencode run --format json`. */\nexport function createOpencodeParser(): CliStreamParser {\n  let started = false;\n\n  return jsonLinesParser((record): CliParsedEvent[] => {\n    const events: CliParsedEvent[] = [];\n    const part = recordField(record, \"part\");\n\n    if (!started) {\n      started = true;\n      events.push({\n        type: \"session.started\",\n        sessionRef: stringField(record, \"sessionID\"),\n        raw: record,\n      });\n    }\n\n    switch (stringField(record, \"type\")) {\n      case \"text\": {\n        const text = stringField(part, \"text\") ?? \"\";\n\n        if (text.length > 0) {\n          events.push({ type: \"message\", text, delta: false, raw: record });\n        }\n        break;\n      }\n      case \"tool_use\": {\n        const state = recordField(part, \"state\");\n        const id = stringField(part, \"callID\") ?? stringField(part, \"id\") ?? \"\";\n        const failed = stringField(state, \"status\") === \"error\";\n\n        events.push(\n          {\n            type: \"tool.call\",\n            id,\n            name: stringField(part, \"tool\") ?? \"\",\n            input: state?.input,\n            raw: record,\n          },\n          {\n            type: \"tool.result\",\n            id,\n            output: (failed ? stringField(state, \"error\") : stringField(state, \"output\")) ?? \"\",\n            isError: failed,\n            raw: record,\n          },\n        );\n        break;\n      }\n      case \"step_finish\": {\n        const tokens = recordField(part, \"tokens\");\n        const cache = recordField(tokens, \"cache\");\n\n        if (tokens !== undefined) {\n          const uncached = numberField(tokens, \"input\") ?? 0;\n          const cacheRead = numberField(cache, \"read\") ?? 0;\n          const cacheWrite = numberField(cache, \"write\") ?? 0;\n\n          events.push({\n            type: \"usage\",\n            cumulative: false,\n            usage: usageOf({\n              input: uncached + cacheRead + cacheWrite,\n              output: numberField(tokens, \"output\"),\n              cachedTokens: cacheRead > 0 ? cacheRead : undefined,\n              cacheWriteTokens: cacheWrite > 0 ? cacheWrite : undefined,\n              reasoningTokens: numberField(tokens, \"reasoning\") || undefined,\n              costUSD: numberField(part, \"cost\"),\n            }),\n            raw: record,\n          });\n        }\n        break;\n      }\n      case \"error\": {\n        const error = asRecord(record.error);\n        const name = stringField(error, \"name\") ?? \"Error\";\n        const message = stringField(recordField(error, \"data\"), \"message\") ?? name;\n\n        events.push({ type: \"error\", message: `${name}: ${message}`, fatal: true, raw: record });\n        break;\n      }\n    }\n\n    return events;\n  });\n}\n"],"mappings":"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"}

package/esm/adapters/qwen-code.d.mts

@@ -0,0 +1,30 @@
+import { CliAdapter } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/qwen-code.d.ts
+/**
+ * Qwen Code (`qwen`, npm `@qwen-code/qwen-code`), a Gemini CLI fork.
+ *
+ * Verified against the real `qwen --help` of 0.25.2 and the docs/source at
+ * tag v0.25.2 (`docs/users/features/headless.md`, `nonInteractive/types.ts`),
+ * 2026-10-17.
+ *
+ * - Headless: positional prompt (`-p` is deprecated) with
+ *   `--output-format stream-json`; piped stdin is used as the prompt when no
+ *   positional prompt is given.
+ * - Stream: the Claude Code `stream-json` shape (`system/init`, `assistant`,
+ *   `user` tool results, `result`), with `input_tokens` that already include
+ *   cached tokens and no cost field.
+ * - Permissions: headless auto-denies tools that need confirmation (the tool
+ *   result says so and `permission_denials` lists it); bypass is `--yolo`.
+ * - MCP: `--mcp-config <file>` with `{"mcpServers":…}` — written to the run
+ *   directory, so it works with any home. Remote servers use `httpUrl`
+ *   (streamable HTTP) or `url` (SSE).
+ * - Home: `QWEN_HOME`. Auth depends on the auth type: `OPENAI_API_KEY`
+ *   (default for `apiKey`), or `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` with
+ *   `--auth-type` in `args`.
+ * - Effort has no flag (it is the `model.reasoningEffort` setting), so
+ *   `effort` is refused.
+ */
+declare const qwenCodeAdapter: CliAdapter;
+//#endregion
+export { qwenCodeAdapter };
+//# sourceMappingURL=qwen-code.d.mts.map

package/esm/adapters/qwen-code.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-code.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/qwen-code.ts"],"mappings":";;;;;AA6BA;;;;AA+DC;;;;;;;;;;;;;;;;;cA/DY,eAAA,EAAiB,UA+D7B"}

package/esm/adapters/qwen-code.mjs

@@ -0,0 +1,94 @@
+import { argvPrompt, jsonFile, mcpServersJson } from "./shared.mjs";
+import { createClaudeStreamParser } from "./claude-stream.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/qwen-code.ts
+/**
+* Qwen Code (`qwen`, npm `@qwen-code/qwen-code`), a Gemini CLI fork.
+*
+* Verified against the real `qwen --help` of 0.25.2 and the docs/source at
+* tag v0.25.2 (`docs/users/features/headless.md`, `nonInteractive/types.ts`),
+* 2026-10-17.
+*
+* - Headless: positional prompt (`-p` is deprecated) with
+*   `--output-format stream-json`; piped stdin is used as the prompt when no
+*   positional prompt is given.
+* - Stream: the Claude Code `stream-json` shape (`system/init`, `assistant`,
+*   `user` tool results, `result`), with `input_tokens` that already include
+*   cached tokens and no cost field.
+* - Permissions: headless auto-denies tools that need confirmation (the tool
+*   result says so and `permission_denials` lists it); bypass is `--yolo`.
+* - MCP: `--mcp-config <file>` with `{"mcpServers":…}` — written to the run
+*   directory, so it works with any home. Remote servers use `httpUrl`
+*   (streamable HTTP) or `url` (SSE).
+* - Home: `QWEN_HOME`. Auth depends on the auth type: `OPENAI_API_KEY`
+*   (default for `apiKey`), or `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` with
+*   `--auth-type` in `args`.
+* - Effort has no flag (it is the `model.reasoningEffort` setting), so
+*   `effort` is refused.
+*/
+const qwenCodeAdapter = {
+	name: "qwen-code",
+	title: "Qwen Code",
+	command: "qwen",
+	apiKeyEnv: ["OPENAI_API_KEY"],
+	homeEnv: ["QWEN_HOME"],
+	transports: ["argv", "stdin"],
+	effort: false,
+	mcp: true,
+	probe: {
+		help: [["--help"]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "0.25.2",
+		verifiedBy: "help",
+		sources: ["https://qwenlm.github.io/qwen-code-docs/", "https://github.com/QwenLM/qwen-code/blob/v0.25.2/docs/users/features/headless.md"],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = ["--output-format", "stream-json"];
+		const requires = ["--output-format", "stream-json"];
+		const files = [];
+		if (context.model !== void 0) {
+			args.push("--model", context.model);
+			requires.push("--model");
+		}
+		if (context.resume !== void 0) {
+			args.push("--resume", context.resume);
+			requires.push("--resume");
+		}
+		if (context.permission === "bypass") {
+			args.push("--yolo");
+			requires.push("--yolo");
+		}
+		if (context.mcp !== void 0) {
+			const file = path.join(context.runDir, "mcp.json");
+			files.push({
+				path: file,
+				content: jsonFile({ mcpServers: mcpServersJson(context.mcp, { httpUrlKey: "httpUrl" }) })
+			});
+			args.push("--mcp-config", file);
+			requires.push("--mcp-config");
+		}
+		return {
+			args,
+			tail: context.transport === "argv" ? [argvPrompt(context.prompt)] : [],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env: {
+				...context.home !== void 0 ? { QWEN_HOME: context.home } : {},
+				QWEN_CODE_SUPPRESS_YOLO_WARNING: "1"
+			},
+			files,
+			requires
+		};
+	},
+	parser: () => createClaudeStreamParser({
+		usage: "inclusive",
+		vendor: "Qwen Code"
+	})
+};
+
+//#endregion
+export { qwenCodeAdapter };
+//# sourceMappingURL=qwen-code.mjs.map

package/esm/adapters/qwen-code.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-code.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/qwen-code.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { CliAdapter, CliLaunchFile } from \"../contracts\";\nimport { createClaudeStreamParser } from \"./claude-stream\";\nimport { argvPrompt, jsonFile, mcpServersJson } from \"./shared\";\n\n/**\n * Qwen Code (`qwen`, npm `@qwen-code/qwen-code`), a Gemini CLI fork.\n *\n * Verified against the real `qwen --help` of 0.25.2 and the docs/source at\n * tag v0.25.2 (`docs/users/features/headless.md`, `nonInteractive/types.ts`),\n * 2026-10-17.\n *\n * - Headless: positional prompt (`-p` is deprecated) with\n *   `--output-format stream-json`; piped stdin is used as the prompt when no\n *   positional prompt is given.\n * - Stream: the Claude Code `stream-json` shape (`system/init`, `assistant`,\n *   `user` tool results, `result`), with `input_tokens` that already include\n *   cached tokens and no cost field.\n * - Permissions: headless auto-denies tools that need confirmation (the tool\n *   result says so and `permission_denials` lists it); bypass is `--yolo`.\n * - MCP: `--mcp-config <file>` with `{\"mcpServers\":…}` — written to the run\n *   directory, so it works with any home. Remote servers use `httpUrl`\n *   (streamable HTTP) or `url` (SSE).\n * - Home: `QWEN_HOME`. Auth depends on the auth type: `OPENAI_API_KEY`\n *   (default for `apiKey`), or `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` with\n *   `--auth-type` in `args`.\n * - Effort has no flag (it is the `model.reasoningEffort` setting), so\n *   `effort` is refused.\n */\nexport const qwenCodeAdapter: CliAdapter = {\n  name: \"qwen-code\",\n  title: \"Qwen Code\",\n  command: \"qwen\",\n  apiKeyEnv: [\"OPENAI_API_KEY\"],\n  homeEnv: [\"QWEN_HOME\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: false,\n  mcp: true,\n  probe: { help: [[\"--help\"]], version: [\"--version\"] },\n  verification: {\n    version: \"0.25.2\",\n    verifiedBy: \"help\",\n    sources: [\n      \"https://qwenlm.github.io/qwen-code-docs/\",\n      \"https://github.com/QwenLM/qwen-code/blob/v0.25.2/docs/users/features/headless.md\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\"--output-format\", \"stream-json\"];\n    const requires = [\"--output-format\", \"stream-json\"];\n    const files: CliLaunchFile[] = [];\n\n    if (context.model !== undefined) {\n      args.push(\"--model\", context.model);\n      requires.push(\"--model\");\n    }\n\n    if (context.resume !== undefined) {\n      args.push(\"--resume\", context.resume);\n      requires.push(\"--resume\");\n    }\n\n    if (context.permission === \"bypass\") {\n      args.push(\"--yolo\");\n      requires.push(\"--yolo\");\n    }\n\n    if (context.mcp !== undefined) {\n      const file = path.join(context.runDir, \"mcp.json\");\n\n      files.push({\n        path: file,\n        content: jsonFile({ mcpServers: mcpServersJson(context.mcp, { httpUrlKey: \"httpUrl\" }) }),\n      });\n      args.push(\"--mcp-config\", file);\n      requires.push(\"--mcp-config\");\n    }\n\n    return {\n      args,\n      tail: context.transport === \"argv\" ? [argvPrompt(context.prompt)] : [],\n      stdin: context.transport === \"stdin\" ? context.prompt : undefined,\n      env: {\n        ...(context.home !== undefined ? { QWEN_HOME: context.home } : {}),\n        QWEN_CODE_SUPPRESS_YOLO_WARNING: \"1\",\n      },\n      files,\n      requires,\n    };\n  },\n  parser: () => createClaudeStreamParser({ usage: \"inclusive\", vendor: \"Qwen Code\" }),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,kBAA8B;CACzC,MAAM;CACN,OAAO;CACP,SAAS;CACT,WAAW,CAAC,gBAAgB;CAC5B,SAAS,CAAC,WAAW;CACrB,YAAY,CAAC,QAAQ,OAAO;CAC5B,QAAQ;CACR,KAAK;CACL,OAAO;EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC;EAAG,SAAS,CAAC,WAAW;CAAE;CACpD,cAAc;EACZ,SAAS;EACT,YAAY;EACZ,SAAS,CACP,4CACA,kFACF;EACA,WAAW;CACb;CACA,KAAK,SAAS;EACZ,MAAM,OAAO,CAAC,mBAAmB,aAAa;EAC9C,MAAM,WAAW,CAAC,mBAAmB,aAAa;EAClD,MAAM,QAAyB,CAAC;EAEhC,IAAI,QAAQ,UAAU,QAAW;GAC/B,KAAK,KAAK,WAAW,QAAQ,KAAK;GAClC,SAAS,KAAK,SAAS;EACzB;EAEA,IAAI,QAAQ,WAAW,QAAW;GAChC,KAAK,KAAK,YAAY,QAAQ,MAAM;GACpC,SAAS,KAAK,UAAU;EAC1B;EAEA,IAAI,QAAQ,eAAe,UAAU;GACnC,KAAK,KAAK,QAAQ;GAClB,SAAS,KAAK,QAAQ;EACxB;EAEA,IAAI,QAAQ,QAAQ,QAAW;GAC7B,MAAM,OAAO,KAAK,KAAK,QAAQ,QAAQ,UAAU;GAEjD,MAAM,KAAK;IACT,MAAM;IACN,SAAS,SAAS,EAAE,YAAY,eAAe,QAAQ,KAAK,EAAE,YAAY,UAAU,CAAC,EAAE,CAAC;GAC1F,CAAC;GACD,KAAK,KAAK,gBAAgB,IAAI;GAC9B,SAAS,KAAK,cAAc;EAC9B;EAEA,OAAO;GACL;GACA,MAAM,QAAQ,cAAc,SAAS,CAAC,WAAW,QAAQ,MAAM,CAAC,IAAI,CAAC;GACrE,OAAO,QAAQ,cAAc,UAAU,QAAQ,SAAS;GACxD,KAAK;IACH,GAAI,QAAQ,SAAS,SAAY,EAAE,WAAW,QAAQ,KAAK,IAAI,CAAC;IAChE,iCAAiC;GACnC;GACA;GACA;EACF;CACF;CACA,cAAc,yBAAyB;EAAE,OAAO;EAAa,QAAQ;CAAY,CAAC;AACpF"}

package/esm/adapters/reasonix.d.mts

@@ -0,0 +1,31 @@
+import { CliAdapter, CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/reasonix.d.ts
+/**
+ * Reasonix (`reasonix`, npm `reasonix`) — a cache-first coding agent built
+ * around DeepSeek (now multi-provider); the npm package launches a prebuilt
+ * Go binary.
+ *
+ * Verified against the real `reasonix run --help` / `--version` of 2.43.0,
+ * real stream-json output (captured against a local fake model server) and
+ * the docs at that tag (`docs/CLI.md`, `docs/CONFIG_PATHS.md`), 2026-10-17.
+ *
+ * - Headless: `reasonix run --output-format stream-json <task>`; with no
+ *   positional task, piped stdin is the prompt.
+ * - Stream: every line has `kind` (`text` deltas, `message` full text,
+ *   `tool_dispatch`/`tool_started`/`tool_result` with a `tool` object whose
+ *   non-empty `err` marks a failure, `usage` per model call, `turn_done`) plus
+ *   `sessionId`; the final line is `{"type":"result",…}` with totals.
+ * - Permissions: headless "ask" mode refuses writes (listed in
+ *   `permission_denials`; exit 4 in an untrusted folder); bypass is `--yolo`.
+ * - MCP: no flag; `[[plugins]]` in `$REASONIX_HOME/config.toml`.
+ * - Auth: provider keys are read only from `$REASONIX_HOME/.env`, never the
+ *   shell environment, so `apiKey` is written there (0600) as
+ *   `DEEPSEEK_API_KEY` — this needs a private home. For another provider,
+ *   put its variable in that file yourself via a caller-owned home.
+ */
+declare const reasonixAdapter: CliAdapter;
+/** Parser for `reasonix run --output-format stream-json`. */
+declare function createReasonixParser(): CliStreamParser;
+//#endregion
+export { createReasonixParser, reasonixAdapter };
+//# sourceMappingURL=reasonix.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reasonix.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/reasonix.ts"],"mappings":";;;;;AAkDA;;;;AAgFC;AA6BD;;;;AAAuD;;;;;;;;;;;cA7G1C,eAAA,EAAiB,UAgF7B;;iBA6Be,oBAAA,IAAwB,eAAe"}

package/esm/adapters/reasonix.mjs

@@ -0,0 +1,250 @@
+import { asRecord, jsonLinesParser, numberField, recordField, stringField } from "../stream/json-lines.mjs";
+import { toToml } from "../utils/toml.mjs";
+import { argvPrompt, dotenvFile, mapEffort, parseArguments, requirePrivateHome, usageOf } from "./shared.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/reasonix.ts
+/**
+* Reasonix (`reasonix`, npm `reasonix`) — a cache-first coding agent built
+* around DeepSeek (now multi-provider); the npm package launches a prebuilt
+* Go binary.
+*
+* Verified against the real `reasonix run --help` / `--version` of 2.43.0,
+* real stream-json output (captured against a local fake model server) and
+* the docs at that tag (`docs/CLI.md`, `docs/CONFIG_PATHS.md`), 2026-10-17.
+*
+* - Headless: `reasonix run --output-format stream-json <task>`; with no
+*   positional task, piped stdin is the prompt.
+* - Stream: every line has `kind` (`text` deltas, `message` full text,
+*   `tool_dispatch`/`tool_started`/`tool_result` with a `tool` object whose
+*   non-empty `err` marks a failure, `usage` per model call, `turn_done`) plus
+*   `sessionId`; the final line is `{"type":"result",…}` with totals.
+* - Permissions: headless "ask" mode refuses writes (listed in
+*   `permission_denials`; exit 4 in an untrusted folder); bypass is `--yolo`.
+* - MCP: no flag; `[[plugins]]` in `$REASONIX_HOME/config.toml`.
+* - Auth: provider keys are read only from `$REASONIX_HOME/.env`, never the
+*   shell environment, so `apiKey` is written there (0600) as
+*   `DEEPSEEK_API_KEY` — this needs a private home. For another provider,
+*   put its variable in that file yourself via a caller-owned home.
+*/
+const reasonixAdapter = {
+	name: "reasonix",
+	title: "Reasonix",
+	command: "reasonix",
+	apiKeyEnv: ["DEEPSEEK_API_KEY"],
+	homeEnv: ["REASONIX_HOME"],
+	transports: ["argv", "stdin"],
+	effort: true,
+	mcp: true,
+	probe: {
+		help: [["run", "--help"]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "2.43.0",
+		verifiedBy: "help",
+		sources: [
+			"https://github.com/esengine/DeepSeek-Reasonix/blob/v2.43.0/docs/CLI.md",
+			"https://github.com/esengine/DeepSeek-Reasonix/blob/v2.43.0/docs/CONFIG_PATHS.md",
+			"https://www.npmjs.com/package/reasonix"
+		],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = [
+			"run",
+			"--output-format",
+			"stream-json"
+		];
+		const requires = ["--output-format", "stream-json"];
+		const files = [];
+		if (context.model !== void 0) {
+			args.push("--model", context.model);
+			requires.push("--model");
+		}
+		if (context.effort !== void 0) {
+			args.push("--effort", mapEffort(context.effort, {
+				none: "disabled",
+				low: "low",
+				high: "high",
+				max: "max"
+			}));
+			requires.push("--effort");
+		}
+		if (context.resume !== void 0) {
+			args.push("--resume", context.resume);
+			requires.push("--resume");
+		}
+		if (context.permission === "bypass") {
+			args.push("--yolo");
+			requires.push("--yolo");
+		}
+		if (context.mcp !== void 0) {
+			const home = requirePrivateHome(context, reasonixAdapter, "MCP servers");
+			files.push({
+				path: path.join(home, "config.toml"),
+				content: toToml({ plugins: reasonixPlugins(context.mcp) })
+			});
+		}
+		if (context.apiKey !== void 0) {
+			const home = requirePrivateHome(context, reasonixAdapter, "API keys (its .env file)");
+			files.push({
+				path: path.join(home, ".env"),
+				content: dotenvFile({ DEEPSEEK_API_KEY: context.apiKey })
+			});
+		}
+		return {
+			args,
+			tail: context.transport === "argv" ? [argvPrompt(context.prompt)] : [],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env: {
+				...context.home !== void 0 ? { REASONIX_HOME: context.home } : {},
+				REASONIX_TELEMETRY: "off"
+			},
+			files,
+			requires
+		};
+	},
+	parser: createReasonixParser
+};
+function reasonixPlugins(servers) {
+	return Object.entries(servers).map(([name, server]) => server.type === "stdio" ? {
+		name,
+		type: "stdio",
+		command: server.command,
+		args: server.args ?? [],
+		env: server.env
+	} : {
+		name,
+		type: server.type,
+		url: server.url,
+		headers: server.headers
+	});
+}
+/** Reasonix per-call usage (`promptTokens` includes cache hits). */
+function callUsage(usage) {
+	if (usage === void 0) return;
+	const cacheHit = numberField(usage, "cacheHitTokens");
+	return usageOf({
+		input: numberField(usage, "promptTokens"),
+		output: numberField(usage, "completionTokens"),
+		total: numberField(usage, "totalTokens"),
+		cachedTokens: cacheHit !== void 0 && cacheHit > 0 ? cacheHit : void 0,
+		reasoningTokens: numberField(usage, "reasoningTokens"),
+		costUSD: numberField(usage, "costUsd")
+	});
+}
+/** Parser for `reasonix run --output-format stream-json`. */
+function createReasonixParser() {
+	let started = false;
+	let sessionRef;
+	return {
+		...jsonLinesParser((record) => {
+			const events = [];
+			const recordSession = stringField(record, "sessionId") ?? stringField(record, "session_id");
+			if (recordSession !== void 0) sessionRef = recordSession;
+			if (!started && recordSession !== void 0) {
+				started = true;
+				events.push({
+					type: "session.started",
+					sessionRef: recordSession,
+					raw: record
+				});
+			}
+			if (stringField(record, "type") === "result") {
+				const usage = recordField(record, "usage");
+				if (usage !== void 0) events.push({
+					type: "usage",
+					cumulative: true,
+					usage: usageOf({
+						input: numberField(usage, "input_tokens"),
+						output: numberField(usage, "output_tokens"),
+						cachedTokens: numberField(usage, "cache_read_input_tokens") || void 0,
+						costUSD: numberField(record, "total_cost_usd")
+					}),
+					raw: record
+				});
+				const result = stringField(record, "result") ?? "";
+				if (record.is_error === true) events.push({
+					type: "error",
+					message: result || "Reasonix run failed",
+					fatal: true,
+					raw: record
+				});
+				else if (result.length > 0) events.push({
+					type: "message",
+					text: result,
+					delta: false,
+					final: true,
+					raw: record
+				});
+				return events;
+			}
+			const tool = asRecord(record.tool);
+			switch (stringField(record, "kind")) {
+				case "text": {
+					const text = stringField(record, "text") ?? "";
+					if (text.length > 0) events.push({
+						type: "message",
+						text,
+						delta: true,
+						raw: record
+					});
+					break;
+				}
+				case "message":
+					events.push({
+						type: "message",
+						text: stringField(record, "text") ?? "",
+						delta: false,
+						raw: record
+					});
+					break;
+				case "tool_dispatch":
+					if (tool !== void 0 && tool.partial !== true) events.push({
+						type: "tool.call",
+						id: stringField(tool, "id") ?? "",
+						name: stringField(tool, "name") ?? "",
+						input: parseArguments(tool.args),
+						raw: record
+					});
+					break;
+				case "tool_result": {
+					const error = stringField(tool, "err") ?? "";
+					events.push({
+						type: "tool.result",
+						id: stringField(tool, "id") ?? "",
+						output: error.length > 0 ? error : stringField(tool, "output") ?? "",
+						isError: error.length > 0,
+						raw: record
+					});
+					break;
+				}
+				case "usage": {
+					const usage = callUsage(recordField(record, "usage"));
+					if (usage !== void 0) events.push({
+						type: "usage",
+						usage,
+						cumulative: false,
+						raw: record
+					});
+					break;
+				}
+				case "turn_done":
+					if (stringField(record, "status") === "failed") events.push({
+						type: "error",
+						message: stringField(record, "err") ?? "Reasonix turn failed",
+						fatal: true,
+						raw: record
+					});
+					break;
+			}
+			return events;
+		}),
+		sessionRef: () => sessionRef
+	};
+}
+
+//#endregion
+export { createReasonixParser, reasonixAdapter };
+//# sourceMappingURL=reasonix.mjs.map