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

package/esm/adapters/copilot.mjs

@@ -0,0 +1,244 @@
+import { asRecord, jsonLinesParser, numberField, outputText, parseJsonLine, recordField, stringField } from "../stream/json-lines.mjs";
+import { argvPrompt, jsonFile, mcpServersJson, usageOf } from "./shared.mjs";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/copilot.ts
+/** Usage file (inside the run directory) Copilot writes on exit. */
+const USAGE_FILE = "copilot-usage.json";
+/**
+* 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>`.
+*/
+const copilotAdapter = {
+	name: "copilot",
+	title: "Copilot CLI",
+	command: "copilot",
+	apiKeyEnv: ["COPILOT_GITHUB_TOKEN"],
+	homeEnv: ["COPILOT_HOME"],
+	transports: ["argv", "stdin"],
+	effort: true,
+	mcp: true,
+	probe: {
+		help: [["--help"]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "1.0.98",
+		verifiedBy: "help",
+		sources: [
+			"https://docs.github.com/en/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically",
+			"https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference",
+			"https://www.npmjs.com/package/@github/copilot"
+		],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = [
+			"--output-format",
+			"json",
+			"--stream",
+			"on",
+			"--no-ask-user",
+			"--no-auto-update",
+			"--usage-output-file",
+			path.join(context.runDir, USAGE_FILE)
+		];
+		const requires = [
+			"--output-format",
+			"--stream",
+			"--no-ask-user",
+			"--no-auto-update",
+			"--usage-output-file"
+		];
+		const files = [];
+		if (context.model !== void 0) {
+			args.push("--model", context.model);
+			requires.push("--model");
+		}
+		if (context.effort !== void 0) {
+			args.push("--reasoning-effort", context.effort);
+			requires.push("--reasoning-effort");
+		}
+		if (context.resume !== void 0) {
+			args.push("--session-id", context.resume);
+			requires.push("--session-id");
+		}
+		if (context.permission === "bypass") {
+			args.push("--allow-all");
+			requires.push("--allow-all");
+		}
+		if (context.mcp !== void 0) {
+			const file = path.join(context.runDir, "copilot-mcp.json");
+			const servers = mcpServersJson(context.mcp, {
+				typeField: true,
+				extra: { tools: ["*"] }
+			});
+			for (const server of Object.values(servers)) if (server.type === "stdio") server.type = "local";
+			files.push({
+				path: file,
+				content: jsonFile({ mcpServers: servers })
+			});
+			args.push("--additional-mcp-config", `@${file}`);
+			requires.push("--additional-mcp-config");
+		}
+		return {
+			args,
+			tail: context.transport === "argv" ? ["-p", argvPrompt(context.prompt)] : [],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env: context.home !== void 0 ? { COPILOT_HOME: context.home } : void 0,
+			files,
+			requires: context.transport === "argv" ? [...requires, "-p"] : requires
+		};
+	},
+	parser: createCopilotParser
+};
+/** Token usage summed over `modelMetrics` of the usage file. */
+function usageFileEvent(context) {
+	if (context === void 0) return;
+	let report;
+	try {
+		report = parseJsonLine(readFileSync(path.join(context.runDir, USAGE_FILE), "utf8"));
+	} catch {
+		return;
+	}
+	const metrics = recordField(report, "modelMetrics");
+	if (metrics === void 0) return;
+	let input = 0;
+	let output = 0;
+	let cached = 0;
+	let written = 0;
+	let reasoning = 0;
+	for (const value of Object.values(metrics)) {
+		const usage = recordField(asRecord(value), "usage");
+		input += numberField(usage, "inputTokens") ?? 0;
+		output += numberField(usage, "outputTokens") ?? 0;
+		cached += numberField(usage, "cacheReadTokens") ?? 0;
+		written += numberField(usage, "cacheWriteTokens") ?? 0;
+		reasoning += numberField(usage, "reasoningTokens") ?? 0;
+	}
+	return {
+		type: "usage",
+		cumulative: true,
+		usage: usageOf({
+			input,
+			output,
+			cachedTokens: cached > 0 ? cached : void 0,
+			cacheWriteTokens: written > 0 ? written : void 0,
+			reasoningTokens: reasoning > 0 ? reasoning : void 0
+		}),
+		raw: report
+	};
+}
+/** Parser for `copilot -p … --output-format json` (plus its usage file). */
+function createCopilotParser(context) {
+	let started = false;
+	let sessionRef;
+	return {
+		...jsonLinesParser((record) => {
+			const events = [];
+			const type = stringField(record, "type");
+			const data = recordField(record, "data");
+			if (!started) {
+				started = true;
+				events.push({
+					type: "session.started",
+					sessionRef: stringField(data, "sessionId"),
+					raw: record
+				});
+			}
+			switch (type) {
+				case "assistant.message_delta": {
+					const text = stringField(data, "deltaContent") ?? "";
+					if (text.length > 0) events.push({
+						type: "message",
+						text,
+						delta: true,
+						raw: record
+					});
+					break;
+				}
+				case "assistant.message": {
+					const text = stringField(data, "content") ?? "";
+					if (text.length > 0) events.push({
+						type: "message",
+						text,
+						delta: false,
+						raw: record
+					});
+					break;
+				}
+				case "tool.execution_start":
+					events.push({
+						type: "tool.call",
+						id: stringField(data, "toolCallId") ?? "",
+						name: stringField(data, "toolName") ?? "",
+						input: data?.arguments,
+						raw: record
+					});
+					break;
+				case "tool.execution_complete": {
+					const success = data?.success === true;
+					events.push({
+						type: "tool.result",
+						id: stringField(data, "toolCallId") ?? "",
+						output: success ? outputText(recordField(data, "result")?.content) : stringField(recordField(data, "error"), "message") ?? "tool failed",
+						isError: !success,
+						raw: record
+					});
+					break;
+				}
+				case "session.error":
+					events.push({
+						type: "error",
+						message: stringField(data, "message") ?? "Copilot session error",
+						fatal: true,
+						raw: record
+					});
+					break;
+				case "result":
+					sessionRef = stringField(record, "sessionId") ?? sessionRef;
+					break;
+				case "error":
+					events.push({
+						type: "error",
+						message: stringField(record, "message") ?? "error",
+						raw: record
+					});
+					break;
+			}
+			return events;
+		}, () => {
+			const usage = usageFileEvent(context);
+			return usage !== void 0 ? [usage] : [];
+		}),
+		sessionRef: () => sessionRef
+	};
+}
+
+//#endregion
+export { copilotAdapter, createCopilotParser };
+//# sourceMappingURL=copilot.mjs.map

package/esm/adapters/copilot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/copilot.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n  CliAdapter,\n  CliLaunchContext,\n  CliLaunchFile,\n  CliParsedEvent,\n  CliStreamParser,\n} from \"../contracts\";\nimport {\n  asRecord,\n  jsonLinesParser,\n  numberField,\n  outputText,\n  parseJsonLine,\n  recordField,\n  stringField,\n} from \"../stream/json-lines\";\nimport { argvPrompt, jsonFile, mcpServersJson, usageOf } from \"./shared\";\n\n/** Usage file (inside the run directory) Copilot writes on exit. */\nconst USAGE_FILE = \"copilot-usage.json\";\n\n/**\n * GitHub Copilot CLI (`copilot`, npm `@github/copilot`).\n *\n * Verified against the real `copilot --help` of 1.0.98, the JSONL writer in\n * the shipped CLI, the event types of `@github/copilot-sdk` 1.0.22 and the\n * docs (`docs.github.com/copilot/how-tos/copilot-cli/…`, programmatic and\n * command references), 2026-10-17.\n *\n * - Headless: `copilot -p <prompt> --output-format json --stream on`\n *   (piped stdin is the prompt when `-p` is absent). Stream lines are\n *   session events `{type,data,id,timestamp}`: `assistant.message_delta`\n *   (`deltaContent`), `assistant.message` (`content`),\n *   `tool.execution_start` (`toolCallId`, `toolName`, `arguments`),\n *   `tool.execution_complete` (`success`, `result.content`,\n *   `error.message`), `session.error`, and a final CLI-built `result`\n *   (`sessionId`, `exitCode`, premium-request usage).\n * - Tokens are not in the stream; the adapter passes `--usage-output-file`\n *   and reads `modelMetrics.*.usage` from it when the stream ends. Billing\n *   is in premium requests, so no USD cost is reported.\n * - Permissions: unapproved tool requests are auto-denied in `-p` mode;\n *   bypass is `--allow-all` (tools, paths and URLs). `--no-ask-user` and\n *   `--no-auto-update` are always passed.\n * - MCP: `--additional-mcp-config @<file>` (`mcpServers`, `type`\n *   `local`/`http`/`sse`, `tools: [\"*\"]`), written to the run directory.\n * - Home `COPILOT_HOME`; auth `COPILOT_GITHUB_TOKEN`. Resume with\n *   `--session-id <id>`.\n */\nexport const copilotAdapter: CliAdapter = {\n  name: \"copilot\",\n  title: \"Copilot CLI\",\n  command: \"copilot\",\n  apiKeyEnv: [\"COPILOT_GITHUB_TOKEN\"],\n  homeEnv: [\"COPILOT_HOME\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: true,\n  mcp: true,\n  probe: { help: [[\"--help\"]], version: [\"--version\"] },\n  verification: {\n    version: \"1.0.98\",\n    verifiedBy: \"help\",\n    sources: [\n      \"https://docs.github.com/en/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically\",\n      \"https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference\",\n      \"https://www.npmjs.com/package/@github/copilot\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\n      \"--output-format\",\n      \"json\",\n      \"--stream\",\n      \"on\",\n      \"--no-ask-user\",\n      \"--no-auto-update\",\n      \"--usage-output-file\",\n      path.join(context.runDir, USAGE_FILE),\n    ];\n    const requires = [\n      \"--output-format\",\n      \"--stream\",\n      \"--no-ask-user\",\n      \"--no-auto-update\",\n      \"--usage-output-file\",\n    ];\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.effort !== undefined) {\n      // Copilot accepts the framework scale verbatim: none … max.\n      args.push(\"--reasoning-effort\", context.effort);\n      requires.push(\"--reasoning-effort\");\n    }\n\n    if (context.resume !== undefined) {\n      args.push(\"--session-id\", context.resume);\n      requires.push(\"--session-id\");\n    }\n\n    if (context.permission === \"bypass\") {\n      args.push(\"--allow-all\");\n      requires.push(\"--allow-all\");\n    }\n\n    if (context.mcp !== undefined) {\n      const file = path.join(context.runDir, \"copilot-mcp.json\");\n      const servers = mcpServersJson(context.mcp, { typeField: true, extra: { tools: [\"*\"] } });\n\n      for (const server of Object.values(servers)) {\n        if (server.type === \"stdio\") {\n          server.type = \"local\";\n        }\n      }\n\n      files.push({ path: file, content: jsonFile({ mcpServers: servers }) });\n      args.push(\"--additional-mcp-config\", `@${file}`);\n      requires.push(\"--additional-mcp-config\");\n    }\n\n    return {\n      args,\n      tail: context.transport === \"argv\" ? [\"-p\", argvPrompt(context.prompt)] : [],\n      stdin: context.transport === \"stdin\" ? context.prompt : undefined,\n      env: context.home !== undefined ? { COPILOT_HOME: context.home } : undefined,\n      files,\n      requires: context.transport === \"argv\" ? [...requires, \"-p\"] : requires,\n    };\n  },\n  parser: createCopilotParser,\n};\n\n/** Token usage summed over `modelMetrics` of the usage file. */\nfunction usageFileEvent(context: CliLaunchContext | undefined): CliParsedEvent | undefined {\n  if (context === undefined) {\n    return undefined;\n  }\n\n  let report: Record<string, unknown> | undefined;\n\n  try {\n    report = parseJsonLine(readFileSync(path.join(context.runDir, USAGE_FILE), \"utf8\"));\n  } catch {\n    return undefined;\n  }\n\n  const metrics = recordField(report, \"modelMetrics\");\n\n  if (metrics === undefined) {\n    return undefined;\n  }\n\n  let input = 0;\n  let output = 0;\n  let cached = 0;\n  let written = 0;\n  let reasoning = 0;\n\n  for (const value of Object.values(metrics)) {\n    const usage = recordField(asRecord(value), \"usage\");\n\n    input += numberField(usage, \"inputTokens\") ?? 0;\n    output += numberField(usage, \"outputTokens\") ?? 0;\n    cached += numberField(usage, \"cacheReadTokens\") ?? 0;\n    written += numberField(usage, \"cacheWriteTokens\") ?? 0;\n    reasoning += numberField(usage, \"reasoningTokens\") ?? 0;\n  }\n\n  return {\n    type: \"usage\",\n    cumulative: true,\n    usage: usageOf({\n      input,\n      output,\n      cachedTokens: cached > 0 ? cached : undefined,\n      cacheWriteTokens: written > 0 ? written : undefined,\n      reasoningTokens: reasoning > 0 ? reasoning : undefined,\n    }),\n    raw: report,\n  };\n}\n\n/** Parser for `copilot -p … --output-format json` (plus its usage file). */\nexport function createCopilotParser(context?: CliLaunchContext): CliStreamParser {\n  let started = false;\n  let sessionRef: string | undefined;\n\n  const parser = jsonLinesParser(\n    (record): CliParsedEvent[] => {\n      const events: CliParsedEvent[] = [];\n      const type = stringField(record, \"type\");\n      const data = recordField(record, \"data\");\n\n      if (!started) {\n        started = true;\n        events.push({\n          type: \"session.started\",\n          sessionRef: stringField(data, \"sessionId\"),\n          raw: record,\n        });\n      }\n\n      switch (type) {\n        case \"assistant.message_delta\": {\n          const text = stringField(data, \"deltaContent\") ?? \"\";\n\n          if (text.length > 0) {\n            events.push({ type: \"message\", text, delta: true, raw: record });\n          }\n          break;\n        }\n        case \"assistant.message\": {\n          const text = stringField(data, \"content\") ?? \"\";\n\n          if (text.length > 0) {\n            events.push({ type: \"message\", text, delta: false, raw: record });\n          }\n          break;\n        }\n        case \"tool.execution_start\":\n          events.push({\n            type: \"tool.call\",\n            id: stringField(data, \"toolCallId\") ?? \"\",\n            name: stringField(data, \"toolName\") ?? \"\",\n            input: data?.arguments,\n            raw: record,\n          });\n          break;\n        case \"tool.execution_complete\": {\n          const success = data?.success === true;\n\n          events.push({\n            type: \"tool.result\",\n            id: stringField(data, \"toolCallId\") ?? \"\",\n            output: success\n              ? outputText(recordField(data, \"result\")?.content)\n              : (stringField(recordField(data, \"error\"), \"message\") ?? \"tool failed\"),\n            isError: !success,\n            raw: record,\n          });\n          break;\n        }\n        case \"session.error\":\n          events.push({\n            type: \"error\",\n            message: stringField(data, \"message\") ?? \"Copilot session error\",\n            fatal: true,\n            raw: record,\n          });\n          break;\n        case \"result\":\n          sessionRef = stringField(record, \"sessionId\") ?? sessionRef;\n          break;\n        case \"error\":\n          events.push({\n            type: \"error\",\n            message: stringField(record, \"message\") ?? \"error\",\n            raw: record,\n          });\n          break;\n      }\n\n      return events;\n    },\n    () => {\n      const usage = usageFileEvent(context);\n\n      return usage !== undefined ? [usage] : [];\n    },\n  );\n\n  return { ...parser, sessionRef: () => sessionRef };\n}\n"],"mappings":"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"}

package/esm/adapters/cursor.d.mts

@@ -0,0 +1,35 @@
+import { CliAdapter, CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/cursor.d.ts
+/**
+ * Cursor CLI (`cursor-agent`, also installed as `agent`), installed by the
+ * `cursor.com/install` script (no official npm package).
+ *
+ * Verified against the official docs (`cursor.com/docs/cli/{headless,mcp}`,
+ * `/docs/cli/reference/{output-format,parameters,authentication,
+ * permissions,configuration}`) and the option strings of the
+ * 2026.10.16-e3cb207 release bundle (read, not executed), 2026-10-17. The
+ * capability probe checks every flag against the installed `--help`.
+ *
+ * - Headless: `cursor-agent -p --output-format stream-json --trust <prompt>`;
+ *   with no positional prompt, stdin is the prompt. `--trust` is passed
+ *   because print mode exits in a directory that was never trusted — the
+ *   run's `cwd` is the caller's explicit choice.
+ * - Stream: `system/init` (`session_id`, `model`), `user` echo, `assistant`
+ *   messages (`message.content[].text`), `tool_call` `started`/`completed`
+ *   (`call_id`; the tool is the single key of `tool_call`, e.g.
+ *   `readToolCall{args,result{success}}`), and a final `result` with
+ *   `usage{inputTokens (net of cache), outputTokens, cacheReadTokens,
+ *   cacheWriteTokens}`. Errors are not JSON: stderr and a non-zero exit.
+ * - Permissions: headless default is the allowlist mode (unlisted actions are
+ *   rejected, changes only proposed); bypass is `--force`.
+ * - MCP: no flag; `$HOME/.cursor/mcp.json` (the path ignores
+ *   `CURSOR_CONFIG_DIR`), plus `--approve-mcps` — needs a private home.
+ * - Home: `HOME`/`USERPROFILE`, `CURSOR_CONFIG_DIR` and `CURSOR_DATA_DIR`
+ *   are pointed into it. Auth: `CURSOR_API_KEY`.
+ */
+declare const cursorAdapter: CliAdapter;
+/** Parser for `cursor-agent -p --output-format stream-json`. */
+declare function createCursorParser(): CliStreamParser;
+//#endregion
+export { createCursorParser, cursorAdapter };
+//# sourceMappingURL=cursor.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/cursor.ts"],"mappings":";;;;;AA+CA;;;;AAwEC;AAmBD;;;;AAAqD;;;;;;;;;;;;;;;cA3FxC,aAAA,EAAe,UAwE3B;;iBAmBe,kBAAA,IAAsB,eAAe"}

package/esm/adapters/cursor.mjs

@@ -0,0 +1,203 @@
+import { asArray, asRecord, jsonLinesParser, numberField, outputText, recordField, stringField } from "../stream/json-lines.mjs";
+import { argvPrompt, jsonFile, mcpServersJson, parseArguments, requirePrivateHome, usageOf } from "./shared.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/cursor.ts
+/**
+* Cursor CLI (`cursor-agent`, also installed as `agent`), installed by the
+* `cursor.com/install` script (no official npm package).
+*
+* Verified against the official docs (`cursor.com/docs/cli/{headless,mcp}`,
+* `/docs/cli/reference/{output-format,parameters,authentication,
+* permissions,configuration}`) and the option strings of the
+* 2026.10.16-e3cb207 release bundle (read, not executed), 2026-10-17. The
+* capability probe checks every flag against the installed `--help`.
+*
+* - Headless: `cursor-agent -p --output-format stream-json --trust <prompt>`;
+*   with no positional prompt, stdin is the prompt. `--trust` is passed
+*   because print mode exits in a directory that was never trusted — the
+*   run's `cwd` is the caller's explicit choice.
+* - Stream: `system/init` (`session_id`, `model`), `user` echo, `assistant`
+*   messages (`message.content[].text`), `tool_call` `started`/`completed`
+*   (`call_id`; the tool is the single key of `tool_call`, e.g.
+*   `readToolCall{args,result{success}}`), and a final `result` with
+*   `usage{inputTokens (net of cache), outputTokens, cacheReadTokens,
+*   cacheWriteTokens}`. Errors are not JSON: stderr and a non-zero exit.
+* - Permissions: headless default is the allowlist mode (unlisted actions are
+*   rejected, changes only proposed); bypass is `--force`.
+* - MCP: no flag; `$HOME/.cursor/mcp.json` (the path ignores
+*   `CURSOR_CONFIG_DIR`), plus `--approve-mcps` — needs a private home.
+* - Home: `HOME`/`USERPROFILE`, `CURSOR_CONFIG_DIR` and `CURSOR_DATA_DIR`
+*   are pointed into it. Auth: `CURSOR_API_KEY`.
+*/
+const cursorAdapter = {
+	name: "cursor",
+	title: "Cursor CLI",
+	command: "cursor-agent",
+	apiKeyEnv: ["CURSOR_API_KEY"],
+	homeEnv: [
+		"HOME",
+		"USERPROFILE",
+		"CURSOR_CONFIG_DIR",
+		"CURSOR_DATA_DIR"
+	],
+	transports: ["argv", "stdin"],
+	effort: false,
+	mcp: true,
+	probe: {
+		help: [["--help"]],
+		version: ["--version"]
+	},
+	verification: {
+		version: "2026.10.16-e3cb207",
+		verifiedBy: "docs",
+		sources: [
+			"https://cursor.com/docs/cli/headless",
+			"https://cursor.com/docs/cli/reference/output-format",
+			"https://cursor.com/docs/cli/reference/parameters",
+			"https://cursor.com/docs/cli/mcp"
+		],
+		checkedAt: "2026-10-17"
+	},
+	plan(context) {
+		const args = [
+			"--print",
+			"--output-format",
+			"stream-json",
+			"--trust"
+		];
+		const requires = [
+			"--print",
+			"--output-format",
+			"stream-json",
+			"--trust"
+		];
+		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("--force");
+			requires.push("--force");
+		}
+		if (context.mcp !== void 0) {
+			const home = requirePrivateHome(context, cursorAdapter, "MCP servers");
+			files.push({
+				path: path.join(home, ".cursor", "mcp.json"),
+				content: jsonFile({ mcpServers: mcpServersJson(context.mcp, { typeField: true }) })
+			});
+			args.push("--approve-mcps");
+			requires.push("--approve-mcps");
+		}
+		const env = context.home !== void 0 ? {
+			HOME: context.home,
+			USERPROFILE: context.home,
+			CURSOR_CONFIG_DIR: path.join(context.home, ".cursor"),
+			CURSOR_DATA_DIR: path.join(context.home, ".cursor")
+		} : {};
+		return {
+			args,
+			tail: context.transport === "argv" ? [argvPrompt(context.prompt)] : [],
+			stdin: context.transport === "stdin" ? context.prompt : void 0,
+			env,
+			files,
+			requires
+		};
+	},
+	parser: createCursorParser
+};
+/** `readToolCall` → `read`; the documented `function{name}` fallback is used as-is. */
+function toolOf(toolCall) {
+	const fn = recordField(toolCall, "function");
+	if (fn !== void 0) return {
+		name: stringField(fn, "name") ?? "function",
+		body: fn
+	};
+	const key = Object.keys(toolCall ?? {})[0] ?? "tool";
+	return {
+		name: key.replace(/ToolCall$/, ""),
+		body: recordField(toolCall, key)
+	};
+}
+/** Parser for `cursor-agent -p --output-format stream-json`. */
+function createCursorParser() {
+	return jsonLinesParser((record) => {
+		switch (stringField(record, "type")) {
+			case "system": return stringField(record, "subtype") === "init" ? [{
+				type: "session.started",
+				sessionRef: stringField(record, "session_id"),
+				model: stringField(record, "model"),
+				raw: record
+			}] : [];
+			case "assistant": {
+				const text = asArray(recordField(record, "message")?.content).map((block) => stringField(asRecord(block), "text") ?? "").join("");
+				return text.length > 0 ? [{
+					type: "message",
+					text,
+					delta: false,
+					raw: record
+				}] : [];
+			}
+			case "tool_call": {
+				const id = stringField(record, "call_id") ?? "";
+				const { name, body } = toolOf(recordField(record, "tool_call"));
+				if (stringField(record, "subtype") === "started") return [{
+					type: "tool.call",
+					id,
+					name,
+					input: body?.args ?? parseArguments(body?.arguments),
+					raw: record
+				}];
+				if (stringField(record, "subtype") === "completed") {
+					const result = recordField(body, "result");
+					const success = recordField(result, "success");
+					const content = stringField(success, "content");
+					return [{
+						type: "tool.result",
+						id,
+						output: success !== void 0 ? content ?? outputText(success) : outputText(result),
+						isError: success === void 0,
+						raw: record
+					}];
+				}
+				return [];
+			}
+			case "result": {
+				const events = [];
+				const usage = recordField(record, "usage");
+				if (usage !== void 0) {
+					const cacheRead = numberField(usage, "cacheReadTokens") ?? 0;
+					const cacheWrite = numberField(usage, "cacheWriteTokens") ?? 0;
+					events.push({
+						type: "usage",
+						cumulative: true,
+						usage: usageOf({
+							input: (numberField(usage, "inputTokens") ?? 0) + cacheRead + cacheWrite,
+							output: numberField(usage, "outputTokens"),
+							cachedTokens: cacheRead > 0 ? cacheRead : void 0,
+							cacheWriteTokens: cacheWrite > 0 ? cacheWrite : void 0
+						}),
+						raw: record
+					});
+				}
+				if (record.is_error === true) events.push({
+					type: "error",
+					message: stringField(record, "result") || "Cursor CLI reported an error",
+					fatal: true,
+					raw: record
+				});
+				return events;
+			}
+			default: return [];
+		}
+	});
+}
+
+//#endregion
+export { createCursorParser, cursorAdapter };
+//# sourceMappingURL=cursor.mjs.map

package/esm/adapters/cursor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/cursor.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { CliAdapter, CliLaunchFile, CliParsedEvent, CliStreamParser } from \"../contracts\";\nimport {\n  asArray,\n  asRecord,\n  jsonLinesParser,\n  numberField,\n  outputText,\n  recordField,\n  stringField,\n} from \"../stream/json-lines\";\nimport {\n  argvPrompt,\n  jsonFile,\n  mcpServersJson,\n  parseArguments,\n  requirePrivateHome,\n  usageOf,\n} from \"./shared\";\n\n/**\n * Cursor CLI (`cursor-agent`, also installed as `agent`), installed by the\n * `cursor.com/install` script (no official npm package).\n *\n * Verified against the official docs (`cursor.com/docs/cli/{headless,mcp}`,\n * `/docs/cli/reference/{output-format,parameters,authentication,\n * permissions,configuration}`) and the option strings of the\n * 2026.10.16-e3cb207 release bundle (read, not executed), 2026-10-17. The\n * capability probe checks every flag against the installed `--help`.\n *\n * - Headless: `cursor-agent -p --output-format stream-json --trust <prompt>`;\n *   with no positional prompt, stdin is the prompt. `--trust` is passed\n *   because print mode exits in a directory that was never trusted — the\n *   run's `cwd` is the caller's explicit choice.\n * - Stream: `system/init` (`session_id`, `model`), `user` echo, `assistant`\n *   messages (`message.content[].text`), `tool_call` `started`/`completed`\n *   (`call_id`; the tool is the single key of `tool_call`, e.g.\n *   `readToolCall{args,result{success}}`), and a final `result` with\n *   `usage{inputTokens (net of cache), outputTokens, cacheReadTokens,\n *   cacheWriteTokens}`. Errors are not JSON: stderr and a non-zero exit.\n * - Permissions: headless default is the allowlist mode (unlisted actions are\n *   rejected, changes only proposed); bypass is `--force`.\n * - MCP: no flag; `$HOME/.cursor/mcp.json` (the path ignores\n *   `CURSOR_CONFIG_DIR`), plus `--approve-mcps` — needs a private home.\n * - Home: `HOME`/`USERPROFILE`, `CURSOR_CONFIG_DIR` and `CURSOR_DATA_DIR`\n *   are pointed into it. Auth: `CURSOR_API_KEY`.\n */\nexport const cursorAdapter: CliAdapter = {\n  name: \"cursor\",\n  title: \"Cursor CLI\",\n  command: \"cursor-agent\",\n  apiKeyEnv: [\"CURSOR_API_KEY\"],\n  homeEnv: [\"HOME\", \"USERPROFILE\", \"CURSOR_CONFIG_DIR\", \"CURSOR_DATA_DIR\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: false,\n  mcp: true,\n  probe: { help: [[\"--help\"]], version: [\"--version\"] },\n  verification: {\n    version: \"2026.10.16-e3cb207\",\n    verifiedBy: \"docs\",\n    sources: [\n      \"https://cursor.com/docs/cli/headless\",\n      \"https://cursor.com/docs/cli/reference/output-format\",\n      \"https://cursor.com/docs/cli/reference/parameters\",\n      \"https://cursor.com/docs/cli/mcp\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\"--print\", \"--output-format\", \"stream-json\", \"--trust\"];\n    const requires = [\"--print\", \"--output-format\", \"stream-json\", \"--trust\"];\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(\"--force\");\n      requires.push(\"--force\");\n    }\n\n    if (context.mcp !== undefined) {\n      const home = requirePrivateHome(context, cursorAdapter, \"MCP servers\");\n\n      files.push({\n        path: path.join(home, \".cursor\", \"mcp.json\"),\n        content: jsonFile({ mcpServers: mcpServersJson(context.mcp, { typeField: true }) }),\n      });\n      args.push(\"--approve-mcps\");\n      requires.push(\"--approve-mcps\");\n    }\n\n    const env: Record<string, string> =\n      context.home !== undefined\n        ? {\n            HOME: context.home,\n            USERPROFILE: context.home,\n            CURSOR_CONFIG_DIR: path.join(context.home, \".cursor\"),\n            CURSOR_DATA_DIR: path.join(context.home, \".cursor\"),\n          }\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: createCursorParser,\n};\n\n/** `readToolCall` → `read`; the documented `function{name}` fallback is used as-is. */\nfunction toolOf(toolCall: Record<string, unknown> | undefined): {\n  name: string;\n  body: Record<string, unknown> | undefined;\n} {\n  const fn = recordField(toolCall, \"function\");\n\n  if (fn !== undefined) {\n    return { name: stringField(fn, \"name\") ?? \"function\", body: fn };\n  }\n\n  const key = Object.keys(toolCall ?? {})[0] ?? \"tool\";\n\n  return { name: key.replace(/ToolCall$/, \"\"), body: recordField(toolCall, key) };\n}\n\n/** Parser for `cursor-agent -p --output-format stream-json`. */\nexport function createCursorParser(): CliStreamParser {\n  return jsonLinesParser((record): CliParsedEvent[] => {\n    switch (stringField(record, \"type\")) {\n      case \"system\":\n        return stringField(record, \"subtype\") === \"init\"\n          ? [\n              {\n                type: \"session.started\",\n                sessionRef: stringField(record, \"session_id\"),\n                model: stringField(record, \"model\"),\n                raw: record,\n              },\n            ]\n          : [];\n      case \"assistant\": {\n        const text = asArray(recordField(record, \"message\")?.content)\n          .map((block) => stringField(asRecord(block), \"text\") ?? \"\")\n          .join(\"\");\n\n        return text.length > 0 ? [{ type: \"message\", text, delta: false, raw: record }] : [];\n      }\n      case \"tool_call\": {\n        const id = stringField(record, \"call_id\") ?? \"\";\n        const { name, body } = toolOf(recordField(record, \"tool_call\"));\n\n        if (stringField(record, \"subtype\") === \"started\") {\n          return [\n            {\n              type: \"tool.call\",\n              id,\n              name,\n              input: body?.args ?? parseArguments(body?.arguments),\n              raw: record,\n            },\n          ];\n        }\n\n        if (stringField(record, \"subtype\") === \"completed\") {\n          const result = recordField(body, \"result\");\n          const success = recordField(result, \"success\");\n          const content = stringField(success, \"content\");\n\n          return [\n            {\n              type: \"tool.result\",\n              id,\n              output: success !== undefined ? (content ?? outputText(success)) : outputText(result),\n              isError: success === undefined,\n              raw: record,\n            },\n          ];\n        }\n\n        return [];\n      }\n      case \"result\": {\n        const events: CliParsedEvent[] = [];\n        const usage = recordField(record, \"usage\");\n\n        if (usage !== undefined) {\n          const cacheRead = numberField(usage, \"cacheReadTokens\") ?? 0;\n          const cacheWrite = numberField(usage, \"cacheWriteTokens\") ?? 0;\n\n          events.push({\n            type: \"usage\",\n            cumulative: true,\n            usage: usageOf({\n              input: (numberField(usage, \"inputTokens\") ?? 0) + cacheRead + cacheWrite,\n              output: numberField(usage, \"outputTokens\"),\n              cachedTokens: cacheRead > 0 ? cacheRead : undefined,\n              cacheWriteTokens: cacheWrite > 0 ? cacheWrite : undefined,\n            }),\n            raw: record,\n          });\n        }\n\n        if (record.is_error === true) {\n          events.push({\n            type: \"error\",\n            message: stringField(record, \"result\") || \"Cursor CLI reported an error\",\n            fatal: true,\n            raw: record,\n          });\n        }\n\n        // `result` concatenates every assistant message, so the final answer\n        // is taken from the last assistant message instead.\n        return events;\n      }\n      default:\n        return [];\n    }\n  });\n}\n"],"mappings":"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"}

package/esm/adapters/droid.d.mts

@@ -0,0 +1,32 @@
+import { CliAdapter, CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/adapters/droid.d.ts
+/**
+ * Factory Droid (`droid`, npm `droid` / `@factory/cli`).
+ *
+ * Verified against the real `droid exec --help` of 0.244.0, a real
+ * `droid exec` run without credentials (init and error lines), the field
+ * names in the shipped code and the docs (`docs.factory.ai/cli/droid-exec`,
+ * `/cli/configuration/mcp`), 2026-10-17.
+ *
+ * - Headless: `droid exec -o stream-json <prompt>` (or `-f <file>`).
+ * - Stream: `system/init` (`session_id`, `model`), whole `message` records
+ *   (`role`, `text`), `tool_call` (`id`, `toolName`, `parameters`),
+ *   `tool_result` (`id`, `isError`, `value` | `error.message`), a final
+ *   `completion` (`finalText`, `usage` with Anthropic-style
+ *   `input_tokens`/`cache_read_input_tokens`/`cache_creation_input_tokens`,
+ *   read with Anthropic semantics) and `error` (`source`, `message`).
+ *   Billing is in Factory credits; no USD cost is reported.
+ * - Permissions: `standard` is Droid's default **read-only** autonomy; raise
+ *   it with `args: ["--auto", "medium"]` (low | medium | high). Bypass is
+ *   `--skip-permissions-unsafe`. Blocked actions end the run non-zero.
+ * - MCP: `<home>/.factory/mcp.json` (`mcpServers`); the home is relocated
+ *   with `FACTORY_HOME_OVERRIDE` (found in the shipped code and confirmed
+ *   with `droid mcp list`), so per-run MCP needs a private home.
+ * - Auth: `FACTORY_API_KEY`.
+ */
+declare const droidAdapter: CliAdapter;
+/** Parser for `droid exec -o stream-json`. */
+declare function createDroidParser(): CliStreamParser;
+//#endregion
+export { createDroidParser, droidAdapter };
+//# sourceMappingURL=droid.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"droid.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/droid.ts"],"mappings":";;;;;AAoCA;;;;AA8EC;AAGD;;;;AAAoD;;;;;;;;;;;;cAjFvC,YAAA,EAAc,UA8E1B;;iBAGe,iBAAA,IAAqB,eAAe"}