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

package/esm/adapters/reasonix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasonix.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/reasonix.ts"],"sourcesContent":["import path from \"node:path\";\nimport type {\n  CliAdapter,\n  CliLaunchFile,\n  CliMcpServers,\n  CliParsedEvent,\n  CliStreamParser,\n  CliUsage,\n} from \"../contracts\";\nimport {\n  asRecord,\n  jsonLinesParser,\n  numberField,\n  recordField,\n  stringField,\n  type JsonRecord,\n} from \"../stream/json-lines\";\nimport { type TomlTable, toToml } from \"../utils/toml\";\nimport {\n  argvPrompt,\n  dotenvFile,\n  mapEffort,\n  parseArguments,\n  requirePrivateHome,\n  usageOf,\n} from \"./shared\";\n\n/**\n * Reasonix (`reasonix`, npm `reasonix`) — a cache-first coding agent built\n * around DeepSeek (now multi-provider); the npm package launches a prebuilt\n * Go binary.\n *\n * Verified against the real `reasonix run --help` / `--version` of 2.43.0,\n * real stream-json output (captured against a local fake model server) and\n * the docs at that tag (`docs/CLI.md`, `docs/CONFIG_PATHS.md`), 2026-10-17.\n *\n * - Headless: `reasonix run --output-format stream-json <task>`; with no\n *   positional task, piped stdin is the prompt.\n * - Stream: every line has `kind` (`text` deltas, `message` full text,\n *   `tool_dispatch`/`tool_started`/`tool_result` with a `tool` object whose\n *   non-empty `err` marks a failure, `usage` per model call, `turn_done`) plus\n *   `sessionId`; the final line is `{\"type\":\"result\",…}` with totals.\n * - Permissions: headless \"ask\" mode refuses writes (listed in\n *   `permission_denials`; exit 4 in an untrusted folder); bypass is `--yolo`.\n * - MCP: no flag; `[[plugins]]` in `$REASONIX_HOME/config.toml`.\n * - Auth: provider keys are read only from `$REASONIX_HOME/.env`, never the\n *   shell environment, so `apiKey` is written there (0600) as\n *   `DEEPSEEK_API_KEY` — this needs a private home. For another provider,\n *   put its variable in that file yourself via a caller-owned home.\n */\nexport const reasonixAdapter: CliAdapter = {\n  name: \"reasonix\",\n  title: \"Reasonix\",\n  command: \"reasonix\",\n  apiKeyEnv: [\"DEEPSEEK_API_KEY\"],\n  homeEnv: [\"REASONIX_HOME\"],\n  transports: [\"argv\", \"stdin\"],\n  effort: true,\n  mcp: true,\n  probe: { help: [[\"run\", \"--help\"]], version: [\"--version\"] },\n  verification: {\n    version: \"2.43.0\",\n    verifiedBy: \"help\",\n    sources: [\n      \"https://github.com/esengine/DeepSeek-Reasonix/blob/v2.43.0/docs/CLI.md\",\n      \"https://github.com/esengine/DeepSeek-Reasonix/blob/v2.43.0/docs/CONFIG_PATHS.md\",\n      \"https://www.npmjs.com/package/reasonix\",\n    ],\n    checkedAt: \"2026-10-17\",\n  },\n  plan(context) {\n    const args = [\"run\", \"--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.effort !== undefined) {\n      // DeepSeek levels per docs/REASONING_PROVIDERS.md: auto | disabled | low | high | max.\n      args.push(\n        \"--effort\",\n        mapEffort(context.effort, { none: \"disabled\", low: \"low\", high: \"high\", max: \"max\" }),\n      );\n      requires.push(\"--effort\");\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 home = requirePrivateHome(context, reasonixAdapter, \"MCP servers\");\n\n      files.push({\n        path: path.join(home, \"config.toml\"),\n        content: toToml({ plugins: reasonixPlugins(context.mcp) }),\n      });\n    }\n\n    if (context.apiKey !== undefined) {\n      const home = requirePrivateHome(context, reasonixAdapter, \"API keys (its .env file)\");\n\n      files.push({\n        path: path.join(home, \".env\"),\n        content: dotenvFile({ DEEPSEEK_API_KEY: context.apiKey }),\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        ...(context.home !== undefined ? { REASONIX_HOME: context.home } : {}),\n        REASONIX_TELEMETRY: \"off\",\n      },\n      files,\n      requires,\n    };\n  },\n  parser: createReasonixParser,\n};\n\nfunction reasonixPlugins(servers: CliMcpServers): TomlTable[] {\n  return Object.entries(servers).map(([name, server]): TomlTable =>\n    server.type === \"stdio\"\n      ? { name, type: \"stdio\", command: server.command, args: server.args ?? [], env: server.env }\n      : { name, type: server.type, url: server.url, headers: server.headers },\n  );\n}\n\n/** Reasonix per-call usage (`promptTokens` includes cache hits). */\nfunction callUsage(usage: JsonRecord | undefined): CliUsage | undefined {\n  if (usage === undefined) {\n    return undefined;\n  }\n\n  const cacheHit = numberField(usage, \"cacheHitTokens\");\n\n  return usageOf({\n    input: numberField(usage, \"promptTokens\"),\n    output: numberField(usage, \"completionTokens\"),\n    total: numberField(usage, \"totalTokens\"),\n    cachedTokens: cacheHit !== undefined && cacheHit > 0 ? cacheHit : undefined,\n    reasoningTokens: numberField(usage, \"reasoningTokens\"),\n    costUSD: numberField(usage, \"costUsd\"),\n  });\n}\n\n/** Parser for `reasonix run --output-format stream-json`. */\nexport function createReasonixParser(): CliStreamParser {\n  let started = false;\n  let sessionRef: string | undefined;\n\n  return {\n    ...jsonLinesParser((record): CliParsedEvent[] => {\n      const events: CliParsedEvent[] = [];\n      const recordSession = stringField(record, \"sessionId\") ?? stringField(record, \"session_id\");\n\n      if (recordSession !== undefined) {\n        sessionRef = recordSession;\n      }\n\n      if (!started && recordSession !== undefined) {\n        started = true;\n        events.push({ type: \"session.started\", sessionRef: recordSession, raw: record });\n      }\n\n      if (stringField(record, \"type\") === \"result\") {\n        const usage = recordField(record, \"usage\");\n\n        if (usage !== undefined) {\n          events.push({\n            type: \"usage\",\n            cumulative: true,\n            usage: usageOf({\n              input: numberField(usage, \"input_tokens\"),\n              output: numberField(usage, \"output_tokens\"),\n              cachedTokens: numberField(usage, \"cache_read_input_tokens\") || undefined,\n              costUSD: numberField(record, \"total_cost_usd\"),\n            }),\n            raw: record,\n          });\n        }\n\n        const result = stringField(record, \"result\") ?? \"\";\n\n        if (record.is_error === true) {\n          events.push({\n            type: \"error\",\n            message: result || \"Reasonix run failed\",\n            fatal: true,\n            raw: record,\n          });\n        } else if (result.length > 0) {\n          events.push({ type: \"message\", text: result, delta: false, final: true, raw: record });\n        }\n\n        return events;\n      }\n\n      const tool = asRecord(record.tool);\n\n      switch (stringField(record, \"kind\")) {\n        case \"text\": {\n          const text = stringField(record, \"text\") ?? \"\";\n\n          if (text.length > 0) {\n            events.push({ type: \"message\", text, delta: true, raw: record });\n          }\n          break;\n        }\n        case \"message\":\n          events.push({\n            type: \"message\",\n            text: stringField(record, \"text\") ?? \"\",\n            delta: false,\n            raw: record,\n          });\n          break;\n        case \"tool_dispatch\":\n          // The first dispatch streams arguments (`partial: true`); report the complete one.\n          if (tool !== undefined && tool.partial !== true) {\n            events.push({\n              type: \"tool.call\",\n              id: stringField(tool, \"id\") ?? \"\",\n              name: stringField(tool, \"name\") ?? \"\",\n              input: parseArguments(tool.args),\n              raw: record,\n            });\n          }\n          break;\n        case \"tool_result\": {\n          const error = stringField(tool, \"err\") ?? \"\";\n\n          events.push({\n            type: \"tool.result\",\n            id: stringField(tool, \"id\") ?? \"\",\n            output: error.length > 0 ? error : (stringField(tool, \"output\") ?? \"\"),\n            isError: error.length > 0,\n            raw: record,\n          });\n          break;\n        }\n        case \"usage\": {\n          const usage = callUsage(recordField(record, \"usage\"));\n\n          if (usage !== undefined) {\n            events.push({ type: \"usage\", usage, cumulative: false, raw: record });\n          }\n          break;\n        }\n        case \"turn_done\":\n          if (stringField(record, \"status\") === \"failed\") {\n            events.push({\n              type: \"error\",\n              message: stringField(record, \"err\") ?? \"Reasonix turn failed\",\n              fatal: true,\n              raw: record,\n            });\n          }\n          break;\n      }\n\n      return events;\n    }),\n    sessionRef: () => sessionRef,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAa,kBAA8B;CACzC,MAAM;CACN,OAAO;CACP,SAAS;CACT,WAAW,CAAC,kBAAkB;CAC9B,SAAS,CAAC,eAAe;CACzB,YAAY,CAAC,QAAQ,OAAO;CAC5B,QAAQ;CACR,KAAK;CACL,OAAO;EAAE,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC;EAAG,SAAS,CAAC,WAAW;CAAE;CAC3D,cAAc;EACZ,SAAS;EACT,YAAY;EACZ,SAAS;GACP;GACA;GACA;EACF;EACA,WAAW;CACb;CACA,KAAK,SAAS;EACZ,MAAM,OAAO;GAAC;GAAO;GAAmB;EAAa;EACrD,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;GAEhC,KAAK,KACH,YACA,UAAU,QAAQ,QAAQ;IAAE,MAAM;IAAY,KAAK;IAAO,MAAM;IAAQ,KAAK;GAAM,CAAC,CACtF;GACA,SAAS,KAAK,UAAU;EAC1B;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,mBAAmB,SAAS,iBAAiB,aAAa;GAEvE,MAAM,KAAK;IACT,MAAM,KAAK,KAAK,MAAM,aAAa;IACnC,SAAS,OAAO,EAAE,SAAS,gBAAgB,QAAQ,GAAG,EAAE,CAAC;GAC3D,CAAC;EACH;EAEA,IAAI,QAAQ,WAAW,QAAW;GAChC,MAAM,OAAO,mBAAmB,SAAS,iBAAiB,0BAA0B;GAEpF,MAAM,KAAK;IACT,MAAM,KAAK,KAAK,MAAM,MAAM;IAC5B,SAAS,WAAW,EAAE,kBAAkB,QAAQ,OAAO,CAAC;GAC1D,CAAC;EACH;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,eAAe,QAAQ,KAAK,IAAI,CAAC;IACpE,oBAAoB;GACtB;GACA;GACA;EACF;CACF;CACA,QAAQ;AACV;AAEA,SAAS,gBAAgB,SAAqC;CAC5D,OAAO,OAAO,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,YACzC,OAAO,SAAS,UACZ;EAAE;EAAM,MAAM;EAAS,SAAS,OAAO;EAAS,MAAM,OAAO,QAAQ,CAAC;EAAG,KAAK,OAAO;CAAI,IACzF;EAAE;EAAM,MAAM,OAAO;EAAM,KAAK,OAAO;EAAK,SAAS,OAAO;CAAQ,CAC1E;AACF;;AAGA,SAAS,UAAU,OAAqD;CACtE,IAAI,UAAU,QACZ;CAGF,MAAM,WAAW,YAAY,OAAO,gBAAgB;CAEpD,OAAO,QAAQ;EACb,OAAO,YAAY,OAAO,cAAc;EACxC,QAAQ,YAAY,OAAO,kBAAkB;EAC7C,OAAO,YAAY,OAAO,aAAa;EACvC,cAAc,aAAa,UAAa,WAAW,IAAI,WAAW;EAClE,iBAAiB,YAAY,OAAO,iBAAiB;EACrD,SAAS,YAAY,OAAO,SAAS;CACvC,CAAC;AACH;;AAGA,SAAgB,uBAAwC;CACtD,IAAI,UAAU;CACd,IAAI;CAEJ,OAAO;EACL,GAAG,iBAAiB,WAA6B;GAC/C,MAAM,SAA2B,CAAC;GAClC,MAAM,gBAAgB,YAAY,QAAQ,WAAW,KAAK,YAAY,QAAQ,YAAY;GAE1F,IAAI,kBAAkB,QACpB,aAAa;GAGf,IAAI,CAAC,WAAW,kBAAkB,QAAW;IAC3C,UAAU;IACV,OAAO,KAAK;KAAE,MAAM;KAAmB,YAAY;KAAe,KAAK;IAAO,CAAC;GACjF;GAEA,IAAI,YAAY,QAAQ,MAAM,MAAM,UAAU;IAC5C,MAAM,QAAQ,YAAY,QAAQ,OAAO;IAEzC,IAAI,UAAU,QACZ,OAAO,KAAK;KACV,MAAM;KACN,YAAY;KACZ,OAAO,QAAQ;MACb,OAAO,YAAY,OAAO,cAAc;MACxC,QAAQ,YAAY,OAAO,eAAe;MAC1C,cAAc,YAAY,OAAO,yBAAyB,KAAK;MAC/D,SAAS,YAAY,QAAQ,gBAAgB;KAC/C,CAAC;KACD,KAAK;IACP,CAAC;IAGH,MAAM,SAAS,YAAY,QAAQ,QAAQ,KAAK;IAEhD,IAAI,OAAO,aAAa,MACtB,OAAO,KAAK;KACV,MAAM;KACN,SAAS,UAAU;KACnB,OAAO;KACP,KAAK;IACP,CAAC;SACI,IAAI,OAAO,SAAS,GACzB,OAAO,KAAK;KAAE,MAAM;KAAW,MAAM;KAAQ,OAAO;KAAO,OAAO;KAAM,KAAK;IAAO,CAAC;IAGvF,OAAO;GACT;GAEA,MAAM,OAAO,SAAS,OAAO,IAAI;GAEjC,QAAQ,YAAY,QAAQ,MAAM,GAAlC;IACE,KAAK,QAAQ;KACX,MAAM,OAAO,YAAY,QAAQ,MAAM,KAAK;KAE5C,IAAI,KAAK,SAAS,GAChB,OAAO,KAAK;MAAE,MAAM;MAAW;MAAM,OAAO;MAAM,KAAK;KAAO,CAAC;KAEjE;IACF;IACA,KAAK;KACH,OAAO,KAAK;MACV,MAAM;MACN,MAAM,YAAY,QAAQ,MAAM,KAAK;MACrC,OAAO;MACP,KAAK;KACP,CAAC;KACD;IACF,KAAK;KAEH,IAAI,SAAS,UAAa,KAAK,YAAY,MACzC,OAAO,KAAK;MACV,MAAM;MACN,IAAI,YAAY,MAAM,IAAI,KAAK;MAC/B,MAAM,YAAY,MAAM,MAAM,KAAK;MACnC,OAAO,eAAe,KAAK,IAAI;MAC/B,KAAK;KACP,CAAC;KAEH;IACF,KAAK,eAAe;KAClB,MAAM,QAAQ,YAAY,MAAM,KAAK,KAAK;KAE1C,OAAO,KAAK;MACV,MAAM;MACN,IAAI,YAAY,MAAM,IAAI,KAAK;MAC/B,QAAQ,MAAM,SAAS,IAAI,QAAS,YAAY,MAAM,QAAQ,KAAK;MACnE,SAAS,MAAM,SAAS;MACxB,KAAK;KACP,CAAC;KACD;IACF;IACA,KAAK,SAAS;KACZ,MAAM,QAAQ,UAAU,YAAY,QAAQ,OAAO,CAAC;KAEpD,IAAI,UAAU,QACZ,OAAO,KAAK;MAAE,MAAM;MAAS;MAAO,YAAY;MAAO,KAAK;KAAO,CAAC;KAEtE;IACF;IACA,KAAK;KACH,IAAI,YAAY,QAAQ,QAAQ,MAAM,UACpC,OAAO,KAAK;MACV,MAAM;MACN,SAAS,YAAY,QAAQ,KAAK,KAAK;MACvC,OAAO;MACP,KAAK;KACP,CAAC;KAEH;GACJ;GAEA,OAAO;EACT,CAAC;EACD,kBAAkB;CACpB;AACF"}

package/esm/adapters/shared.d.mts

@@ -0,0 +1,78 @@
+import { CliUsage } from "../contracts/events.type.mjs";
+import { CliMcpServers } from "../contracts/mcp.type.mjs";
+import { CliLaunchContext, CliLaunchFile } from "../contracts/adapter.contract.mjs";
+import { CliError } from "../errors.mjs";
+import { ReasoningEffort } from "@warlock.js/ai";
+
+//#region ../../packages/ai-cli/src/adapters/shared.d.ts
+/**
+ * The prompt as an argv value. A prompt starting with `-` would be read as a
+ * flag by the CLI's argument parser, so it gets one leading space (harmless
+ * to the model, and no parser treats it as an option).
+ */
+declare function argvPrompt(prompt: string): string;
+/** The prompt written to `prompt.txt` in the run directory, for `transport: "file"`. */
+declare function promptFile(context: CliLaunchContext): CliLaunchFile;
+/**
+ * Fail closed when an option needs a file inside the CLI's config home but
+ * the home is not private to this run (writing it into a caller-owned or
+ * inherited home would leak tokens into it and race concurrent runs).
+ */
+declare function requirePrivateHome(context: CliLaunchContext, adapter: {
+  name: string;
+  title: string;
+}, option: string): string;
+/** A `.env` file body. Values are written verbatim; newlines are refused. */
+declare function dotenvFile(values: Record<string, string>): string;
+/**
+ * Map a framework effort to a vendor's levels, following the framework
+ * rule: an exact level wins; otherwise the nearest higher level the vendor
+ * has (so `minimal` becomes `low`); a level above the vendor's highest is
+ * clamped to it.
+ *
+ * @example
+ * mapEffort("xhigh", { low: "low", medium: "medium", high: "high" }); // "high"
+ * mapEffort("minimal", { low: "low", medium: "medium", high: "high" }); // "low"
+ */
+declare function mapEffort(effort: ReasoningEffort, levels: Partial<Record<ReasoningEffort, string>>): string;
+/**
+ * The common `mcpServers` JSON shape (Claude Code, Cursor, Kimi, Droid,
+ * Copilot, Amp, Qwen Code …): stdio servers as `command`/`args`/`env`,
+ * remote servers as `url`/`headers`. `typeField` adds the `type` key the
+ * vendor expects (`"stdio"`, `"http"`, `"sse"`), or a renamed remote
+ * transport (`"streamable-http"`).
+ */
+declare function mcpServersJson(servers: CliMcpServers, options?: {
+  /** Emit a `type` key on every server. */typeField?: boolean; /** Value of `type` for streamable HTTP servers. Default `"http"`. */
+  httpType?: string; /** Extra keys merged into every server (for example `tools: ["*"]`). */
+  extra?: Record<string, unknown>; /** Key holding a streamable-HTTP URL. Default `"url"`. */
+  httpUrlKey?: string;
+}): Record<string, Record<string, unknown>>;
+/** JSON for a config file, pretty-printed with a trailing newline. */
+declare function jsonFile(value: unknown): string;
+/** Build a `CliUsage`, computing `total` when the vendor omits it. */
+declare function usageOf(fields: {
+  input?: number;
+  output?: number;
+  total?: number;
+  cachedTokens?: number;
+  cacheWriteTokens?: number;
+  reasoningTokens?: number;
+  costUSD?: number;
+}): CliUsage;
+/** An `unsupported-option` error for an adapter. */
+declare function unsupportedOption(adapter: {
+  name: string;
+  title: string;
+}, message: string): CliError;
+/** Parse a JSON-encoded tool-arguments string; keeps the raw string when it is not JSON. */
+declare function parseArguments(value: unknown): unknown;
+/**
+ * Usage in the Anthropic Messages shape (`input_tokens` excludes cache reads
+ * and writes, which are reported separately). `input` is the sum of all
+ * three, matching the framework rule that `input` includes cached tokens.
+ */
+declare function anthropicUsage(usage: Record<string, unknown> | undefined, costUSD?: number): CliUsage | undefined;
+//#endregion
+export { anthropicUsage, argvPrompt, dotenvFile, jsonFile, mapEffort, mcpServersJson, parseArguments, promptFile, requirePrivateHome, unsupportedOption, usageOf };
+//# sourceMappingURL=shared.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/shared.ts"],"mappings":";;;;;;;;;;;;iBAUgB,UAAA,CAAW,MAAc;;iBAKzB,UAAA,CAAW,OAAA,EAAS,gBAAA,GAAmB,aAAa;;AAL3B;AAKzC;;;iBASgB,kBAAA,CACd,OAAA,EAAS,gBAAgB,EACzB,OAAA;EAAW,IAAA;EAAc,KAAA;AAAA,GACzB,MAAA;;iBAac,UAAA,CAAW,MAA8B,EAAtB,MAAM;AAhBzC;;;;;;;;;;AAAA,iBAkDgB,SAAA,CACd,MAAA,EAAQ,eAAA,EACR,MAAA,EAAQ,OAAA,CAAQ,MAAA,CAAO,eAAA;AAjDT;AAahB;;;;AAAyD;AAkCzD;AA/CgB,iBA6EA,cAAA,CACd,OAAA,EAAS,aAAA,EACT,OAAA;2CAEE,SAAA,YAhCqB;EAkCrB,QAAA,WAlCM;EAoCN,KAAA,GAAQ,MAAA,mBApCK;EAsCb,UAAA;AAAA,IAED,MAAA,SAAe,MAAA;;iBA+BF,QAAA,CAAS,KAAc;;iBAKvB,OAAA,CAAQ,MAAA;EACtB,KAAA;EACA,MAAA;EACA,KAAA;EACA,YAAA;EACA,gBAAA;EACA,eAAA;EACA,OAAA;AAAA,IACE,QAAQ;;iBAmBI,iBAAA,CACd,OAAA;EAAW,IAAA;EAAc,KAAA;AAAA,GACzB,OAAA,WACC,QAAQ;;iBAQK,cAAA,CAAe,KAAc;;;;;;iBAiB7B,cAAA,CACd,KAAA,EAAO,MAAA,+BACP,OAAA,YACC,QAAQ"}

package/esm/adapters/shared.mjs

@@ -0,0 +1,161 @@
+import { CliError } from "../errors.mjs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/adapters/shared.ts
+/**
+* The prompt as an argv value. A prompt starting with `-` would be read as a
+* flag by the CLI's argument parser, so it gets one leading space (harmless
+* to the model, and no parser treats it as an option).
+*/
+function argvPrompt(prompt) {
+	return prompt.startsWith("-") ? ` ${prompt}` : prompt;
+}
+/** The prompt written to `prompt.txt` in the run directory, for `transport: "file"`. */
+function promptFile(context) {
+	return {
+		path: path.join(context.runDir, "prompt.txt"),
+		content: context.prompt
+	};
+}
+/**
+* Fail closed when an option needs a file inside the CLI's config home but
+* the home is not private to this run (writing it into a caller-owned or
+* inherited home would leak tokens into it and race concurrent runs).
+*/
+function requirePrivateHome(context, adapter, option) {
+	if (context.home === void 0 || !context.homeIsPrivate) throw new CliError(`${adapter.title} reads ${option} only from its config home; use \`home: "private"\` (the default) for runs with ${option}.`, {
+		type: "unsupported-option",
+		adapter: adapter.name
+	});
+	return context.home;
+}
+/** A `.env` file body. Values are written verbatim; newlines are refused. */
+function dotenvFile(values) {
+	return Object.entries(values).map(([name, value]) => {
+		if (/[\r\n]/.test(value)) throw new Error(`${name} contains a newline and cannot be written to a .env file`);
+		return `${name}=${value}`;
+	}).join("\n").concat("\n");
+}
+/** The framework effort scale, lowest first. */
+const EFFORT_ORDER = [
+	"none",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+/**
+* Map a framework effort to a vendor's levels, following the framework
+* rule: an exact level wins; otherwise the nearest higher level the vendor
+* has (so `minimal` becomes `low`); a level above the vendor's highest is
+* clamped to it.
+*
+* @example
+* mapEffort("xhigh", { low: "low", medium: "medium", high: "high" }); // "high"
+* mapEffort("minimal", { low: "low", medium: "medium", high: "high" }); // "low"
+*/
+function mapEffort(effort, levels) {
+	const exact = levels[effort];
+	if (exact !== void 0) return exact;
+	const requested = EFFORT_ORDER.indexOf(effort);
+	const supported = EFFORT_ORDER.filter((level) => levels[level] !== void 0);
+	const chosen = supported.find((level) => EFFORT_ORDER.indexOf(level) > requested) ?? supported.at(-1);
+	const value = chosen === void 0 ? void 0 : levels[chosen];
+	if (value === void 0) throw new Error("mapEffort needs at least one vendor level");
+	return value;
+}
+/**
+* The common `mcpServers` JSON shape (Claude Code, Cursor, Kimi, Droid,
+* Copilot, Amp, Qwen Code …): stdio servers as `command`/`args`/`env`,
+* remote servers as `url`/`headers`. `typeField` adds the `type` key the
+* vendor expects (`"stdio"`, `"http"`, `"sse"`), or a renamed remote
+* transport (`"streamable-http"`).
+*/
+function mcpServersJson(servers, options = {}) {
+	const rendered = {};
+	for (const [name, server] of Object.entries(servers)) {
+		if (server.type === "stdio") {
+			rendered[name] = {
+				...options.typeField ? { type: "stdio" } : {},
+				command: server.command,
+				args: server.args ?? [],
+				...server.env !== void 0 ? { env: server.env } : {},
+				...options.extra
+			};
+			continue;
+		}
+		const urlKey = server.type === "http" ? options.httpUrlKey ?? "url" : "url";
+		rendered[name] = {
+			...options.typeField ? { type: server.type === "http" ? options.httpType ?? "http" : "sse" } : {},
+			[urlKey]: server.url,
+			...server.headers !== void 0 ? { headers: server.headers } : {},
+			...options.extra
+		};
+	}
+	return rendered;
+}
+/** JSON for a config file, pretty-printed with a trailing newline. */
+function jsonFile(value) {
+	return `${JSON.stringify(value, null, 2)}\n`;
+}
+/** Build a `CliUsage`, computing `total` when the vendor omits it. */
+function usageOf(fields) {
+	const input = fields.input ?? 0;
+	const output = fields.output ?? 0;
+	const usage = {
+		input,
+		output,
+		total: fields.total ?? input + output
+	};
+	if (fields.cachedTokens !== void 0) usage.cachedTokens = fields.cachedTokens;
+	if (fields.cacheWriteTokens !== void 0) usage.cacheWriteTokens = fields.cacheWriteTokens;
+	if (fields.reasoningTokens !== void 0) usage.reasoningTokens = fields.reasoningTokens;
+	if (fields.costUSD !== void 0) usage.costUSD = fields.costUSD;
+	return usage;
+}
+/** An `unsupported-option` error for an adapter. */
+function unsupportedOption(adapter, message) {
+	return new CliError(`${adapter.title}: ${message}`, {
+		type: "unsupported-option",
+		adapter: adapter.name
+	});
+}
+/** Parse a JSON-encoded tool-arguments string; keeps the raw string when it is not JSON. */
+function parseArguments(value) {
+	if (typeof value !== "string") return value;
+	try {
+		return JSON.parse(value);
+	} catch {
+		return value;
+	}
+}
+/**
+* Usage in the Anthropic Messages shape (`input_tokens` excludes cache reads
+* and writes, which are reported separately). `input` is the sum of all
+* three, matching the framework rule that `input` includes cached tokens.
+*/
+function anthropicUsage(usage, costUSD) {
+	if (usage === void 0) return;
+	const read = (key) => {
+		const value = usage[key];
+		return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+	};
+	const uncached = read("input_tokens") ?? 0;
+	const cacheRead = read("cache_read_input_tokens");
+	const cacheWrite = read("cache_creation_input_tokens");
+	const output = read("output_tokens") ?? 0;
+	return usageOf({
+		input: uncached + (cacheRead ?? 0) + (cacheWrite ?? 0),
+		output,
+		cachedTokens: cacheRead !== void 0 && cacheRead > 0 ? cacheRead : void 0,
+		cacheWriteTokens: cacheWrite !== void 0 && cacheWrite > 0 ? cacheWrite : void 0,
+		reasoningTokens: read("reasoning_tokens") || void 0,
+		costUSD
+	});
+}
+
+//#endregion
+export { anthropicUsage, argvPrompt, dotenvFile, jsonFile, mapEffort, mcpServersJson, parseArguments, promptFile, requirePrivateHome, unsupportedOption, usageOf };
+//# sourceMappingURL=shared.mjs.map

package/esm/adapters/shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/adapters/shared.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { ReasoningEffort } from \"@warlock.js/ai\";\nimport type { CliLaunchContext, CliLaunchFile, CliMcpServers, CliUsage } from \"../contracts\";\nimport { CliError } from \"../errors\";\n\n/**\n * The prompt as an argv value. A prompt starting with `-` would be read as a\n * flag by the CLI's argument parser, so it gets one leading space (harmless\n * to the model, and no parser treats it as an option).\n */\nexport function argvPrompt(prompt: string): string {\n  return prompt.startsWith(\"-\") ? ` ${prompt}` : prompt;\n}\n\n/** The prompt written to `prompt.txt` in the run directory, for `transport: \"file\"`. */\nexport function promptFile(context: CliLaunchContext): CliLaunchFile {\n  return { path: path.join(context.runDir, \"prompt.txt\"), content: context.prompt };\n}\n\n/**\n * Fail closed when an option needs a file inside the CLI's config home but\n * the home is not private to this run (writing it into a caller-owned or\n * inherited home would leak tokens into it and race concurrent runs).\n */\nexport function requirePrivateHome(\n  context: CliLaunchContext,\n  adapter: { name: string; title: string },\n  option: string,\n): string {\n  if (context.home === undefined || !context.homeIsPrivate) {\n    throw new CliError(\n      `${adapter.title} reads ${option} only from its config home; use \\`home: \"private\"\\` (the default) for runs with ${option}.`,\n      { type: \"unsupported-option\", adapter: adapter.name },\n    );\n  }\n\n  return context.home;\n}\n\n/** A `.env` file body. Values are written verbatim; newlines are refused. */\nexport function dotenvFile(values: Record<string, string>): string {\n  return Object.entries(values)\n    .map(([name, value]) => {\n      if (/[\\r\\n]/.test(value)) {\n        throw new Error(`${name} contains a newline and cannot be written to a .env file`);\n      }\n\n      return `${name}=${value}`;\n    })\n    .join(\"\\n\")\n    .concat(\"\\n\");\n}\n\n/** The framework effort scale, lowest first. */\nconst EFFORT_ORDER: readonly ReasoningEffort[] = [\n  \"none\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n];\n\n/**\n * Map a framework effort to a vendor's levels, following the framework\n * rule: an exact level wins; otherwise the nearest higher level the vendor\n * has (so `minimal` becomes `low`); a level above the vendor's highest is\n * clamped to it.\n *\n * @example\n * mapEffort(\"xhigh\", { low: \"low\", medium: \"medium\", high: \"high\" }); // \"high\"\n * mapEffort(\"minimal\", { low: \"low\", medium: \"medium\", high: \"high\" }); // \"low\"\n */\nexport function mapEffort(\n  effort: ReasoningEffort,\n  levels: Partial<Record<ReasoningEffort, string>>,\n): string {\n  const exact = levels[effort];\n\n  if (exact !== undefined) {\n    return exact;\n  }\n\n  const requested = EFFORT_ORDER.indexOf(effort);\n  const supported = EFFORT_ORDER.filter((level) => levels[level] !== undefined);\n  const higher = supported.find((level) => EFFORT_ORDER.indexOf(level) > requested);\n  const chosen = higher ?? supported.at(-1);\n  const value = chosen === undefined ? undefined : levels[chosen];\n\n  if (value === undefined) {\n    throw new Error(\"mapEffort needs at least one vendor level\");\n  }\n\n  return value;\n}\n\n/**\n * The common `mcpServers` JSON shape (Claude Code, Cursor, Kimi, Droid,\n * Copilot, Amp, Qwen Code …): stdio servers as `command`/`args`/`env`,\n * remote servers as `url`/`headers`. `typeField` adds the `type` key the\n * vendor expects (`\"stdio\"`, `\"http\"`, `\"sse\"`), or a renamed remote\n * transport (`\"streamable-http\"`).\n */\nexport function mcpServersJson(\n  servers: CliMcpServers,\n  options: {\n    /** Emit a `type` key on every server. */\n    typeField?: boolean;\n    /** Value of `type` for streamable HTTP servers. Default `\"http\"`. */\n    httpType?: string;\n    /** Extra keys merged into every server (for example `tools: [\"*\"]`). */\n    extra?: Record<string, unknown>;\n    /** Key holding a streamable-HTTP URL. Default `\"url\"`. */\n    httpUrlKey?: string;\n  } = {},\n): Record<string, Record<string, unknown>> {\n  const rendered: Record<string, Record<string, unknown>> = {};\n\n  for (const [name, server] of Object.entries(servers)) {\n    if (server.type === \"stdio\") {\n      rendered[name] = {\n        ...(options.typeField ? { type: \"stdio\" } : {}),\n        command: server.command,\n        args: server.args ?? [],\n        ...(server.env !== undefined ? { env: server.env } : {}),\n        ...options.extra,\n      };\n      continue;\n    }\n\n    const urlKey = server.type === \"http\" ? (options.httpUrlKey ?? \"url\") : \"url\";\n\n    rendered[name] = {\n      ...(options.typeField\n        ? { type: server.type === \"http\" ? (options.httpType ?? \"http\") : \"sse\" }\n        : {}),\n      [urlKey]: server.url,\n      ...(server.headers !== undefined ? { headers: server.headers } : {}),\n      ...options.extra,\n    };\n  }\n\n  return rendered;\n}\n\n/** JSON for a config file, pretty-printed with a trailing newline. */\nexport function jsonFile(value: unknown): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n\n/** Build a `CliUsage`, computing `total` when the vendor omits it. */\nexport function usageOf(fields: {\n  input?: number;\n  output?: number;\n  total?: number;\n  cachedTokens?: number;\n  cacheWriteTokens?: number;\n  reasoningTokens?: number;\n  costUSD?: number;\n}): CliUsage {\n  const input = fields.input ?? 0;\n  const output = fields.output ?? 0;\n  const usage: CliUsage = { input, output, total: fields.total ?? input + output };\n\n  if (fields.cachedTokens !== undefined) usage.cachedTokens = fields.cachedTokens;\n  if (fields.cacheWriteTokens !== undefined) usage.cacheWriteTokens = fields.cacheWriteTokens;\n  if (fields.reasoningTokens !== undefined) usage.reasoningTokens = fields.reasoningTokens;\n  if (fields.costUSD !== undefined) usage.costUSD = fields.costUSD;\n\n  return usage;\n}\n\n/** The first `undefined`-free value. */\nexport function firstDefined<T>(...values: Array<T | undefined>): T | undefined {\n  return values.find((value) => value !== undefined);\n}\n\n/** An `unsupported-option` error for an adapter. */\nexport function unsupportedOption(\n  adapter: { name: string; title: string },\n  message: string,\n): CliError {\n  return new CliError(`${adapter.title}: ${message}`, {\n    type: \"unsupported-option\",\n    adapter: adapter.name,\n  });\n}\n\n/** Parse a JSON-encoded tool-arguments string; keeps the raw string when it is not JSON. */\nexport function parseArguments(value: unknown): unknown {\n  if (typeof value !== \"string\") {\n    return value;\n  }\n\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n}\n\n/**\n * Usage in the Anthropic Messages shape (`input_tokens` excludes cache reads\n * and writes, which are reported separately). `input` is the sum of all\n * three, matching the framework rule that `input` includes cached tokens.\n */\nexport function anthropicUsage(\n  usage: Record<string, unknown> | undefined,\n  costUSD?: number,\n): CliUsage | undefined {\n  if (usage === undefined) {\n    return undefined;\n  }\n\n  const read = (key: string): number | undefined => {\n    const value = usage[key];\n\n    return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n  };\n  const uncached = read(\"input_tokens\") ?? 0;\n  const cacheRead = read(\"cache_read_input_tokens\");\n  const cacheWrite = read(\"cache_creation_input_tokens\");\n  const output = read(\"output_tokens\") ?? 0;\n  const input = uncached + (cacheRead ?? 0) + (cacheWrite ?? 0);\n\n  return usageOf({\n    input,\n    output,\n    cachedTokens: cacheRead !== undefined && cacheRead > 0 ? cacheRead : undefined,\n    cacheWriteTokens: cacheWrite !== undefined && cacheWrite > 0 ? cacheWrite : undefined,\n    reasoningTokens: read(\"reasoning_tokens\") || undefined,\n    costUSD,\n  });\n}\n"],"mappings":"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"}

package/esm/cli-agent.d.mts

@@ -0,0 +1,40 @@
+import { CliAdapter } from "./contracts/adapter.contract.mjs";
+import { CliAgentOptions, CliProbeResult, CliRunOptions, CliSession } from "./contracts/options.type.mjs";
+import { CliModelConfig } from "./model/cli-model.mjs";
+import { CommandLookup } from "./spawn/resolve-command.mjs";
+import { ModelContract } from "@warlock.js/ai";
+
+//#region ../../packages/ai-cli/src/cli-agent.d.ts
+/** A configured coding CLI: run prompts, probe the binary, or use it as an `ai.agent` model. */
+type CliAgent = {
+  readonly adapter: CliAdapter;
+  readonly options: Readonly<CliAgentOptions>;
+  /**
+   * Start a session. Rejects (with {@link CliError}) only for setup problems
+   * — executable not found, a flag missing from `--help`, an unsupported
+   * option; the run's own outcome is reported by `session.done()`.
+   */
+  run(prompt: string, options?: CliRunOptions): Promise<CliSession>; /** Run (or reuse) the capability probe: resolved executable, version and help text. */
+  probe(): Promise<CliProbeResult>; /** This CLI as an `ai.agent` model (see {@link cliModel}). */
+  model(config?: CliModelConfig): ModelContract;
+};
+/** Host facts, injectable for tests. */
+type CliHost = CommandLookup & {
+  comspec: string;
+};
+/** The current machine as a {@link CliHost}. */
+declare function currentHost(): CliHost;
+/**
+ * Create a CLI agent from an adapter. The vendor factories
+ * (`cli.claudeCode(...)`, `cli.codex(...)`, …) call this with their
+ * built-in adapter; call it directly with your own {@link CliAdapter}.
+ *
+ * @example
+ * const agent = createCliAgent(myAdapter, { model: "fast", permission: "standard" });
+ * const session = await agent.run("Summarize README.md", { cwd: "/srv/repo" });
+ * console.log((await session.done()).text);
+ */
+declare function createCliAgent(adapter: CliAdapter, options?: CliAgentOptions, host?: CliHost): CliAgent;
+//#endregion
+export { CliAgent, CliHost, createCliAgent, currentHost };
+//# sourceMappingURL=cli-agent.d.mts.map

package/esm/cli-agent.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-agent.d.mts","names":[],"sources":["../../../../../../../packages/ai-cli/src/cli-agent.ts"],"mappings":";;;;;;;;KA2BY,QAAA;EAAA,SACD,OAAA,EAAS,UAAA;EAAA,SACT,OAAA,EAAS,QAAA,CAAS,eAAA;EAFjB;;;;;EAQV,GAAA,CAAI,MAAA,UAAgB,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,UAAA,GAAxB;EAE9B,KAAA,IAAS,OAAA,CAAQ,cAAA,GAF6B;EAI9C,KAAA,CAAM,MAAA,GAAS,cAAA,GAAiB,aAAA;AAAA;;KAItB,OAAA,GAAU,aAAa;EAAK,OAAO;AAAA;;iBAmB/B,WAAA,IAAe,OAAO;;;;;;;;;;;iBAoCtB,cAAA,CACd,OAAA,EAAS,UAAA,EACT,OAAA,GAAS,eAAA,EACT,IAAA,GAAM,OAAA,GACL,QAAA"}

package/esm/cli-agent.mjs

@@ -0,0 +1,207 @@
+import { CliError } from "./errors.mjs";
+import { cliModel } from "./model/cli-model.mjs";
+import { buildInvocation, fitsCommandLine } from "./spawn/invocation.mjs";
+import { assertCapabilities, probeCli } from "./probe/probe.mjs";
+import { buildEnvironment } from "./session/environment.mjs";
+import { createRunDirectories, writeLaunchFiles } from "./session/run-directory.mjs";
+import { cancelledSession, startSession } from "./session/session.mjs";
+import { readEnv, resolveSpawnTarget } from "./spawn/resolve-command.mjs";
+import { accessSync, constants, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+
+//#region ../../packages/ai-cli/src/cli-agent.ts
+function isRunnableFile(filePath, platform) {
+	try {
+		if (!statSync(filePath).isFile()) return false;
+		if (platform !== "win32") accessSync(filePath, constants.X_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** The current machine as a {@link CliHost}. */
+function currentHost() {
+	const platform = process.platform;
+	return {
+		platform,
+		env: process.env,
+		isFile: (filePath) => isRunnableFile(filePath, platform),
+		readFile: (filePath) => {
+			try {
+				return readFileSync(filePath, "utf8");
+			} catch {
+				return;
+			}
+		},
+		execPath: process.execPath,
+		comspec: readEnv(process.env, "ComSpec", platform) ?? "cmd.exe"
+	};
+}
+function unsupported(adapter, message) {
+	return new CliError(`${adapter.title}: ${message}`, {
+		type: "unsupported-option",
+		adapter: adapter.name
+	});
+}
+/**
+* Create a CLI agent from an adapter. The vendor factories
+* (`cli.claudeCode(...)`, `cli.codex(...)`, …) call this with their
+* built-in adapter; call it directly with your own {@link CliAdapter}.
+*
+* @example
+* const agent = createCliAgent(myAdapter, { model: "fast", permission: "standard" });
+* const session = await agent.run("Summarize README.md", { cwd: "/srv/repo" });
+* console.log((await session.done()).text);
+*/
+function createCliAgent(adapter, options = {}, host = currentHost()) {
+	const probes = /* @__PURE__ */ new Map();
+	const command = options.command ?? adapter.command;
+	const resolveTarget = () => {
+		const target = resolveSpawnTarget(command, host);
+		if (target === void 0) throw new CliError(`${adapter.title}: could not find "${command}" on PATH. Install the CLI or pass its absolute path as \`command\`.`, {
+			type: "not-found",
+			adapter: adapter.name
+		});
+		return target;
+	};
+	const probeEnvironment = () => buildEnvironment({
+		source: host.env,
+		inherit: options.inheritEnv ?? true,
+		managed: [],
+		user: options.env,
+		platform: host.platform
+	});
+	const probeTarget = (target) => {
+		const cached = probes.get(target.executable);
+		if (cached !== void 0) return cached;
+		const pending = probeCli({
+			adapter,
+			target,
+			env: probeEnvironment(),
+			cwd: path.resolve(options.cwd ?? process.cwd()),
+			comspec: host.comspec,
+			platform: host.platform
+		});
+		probes.set(target.executable, pending);
+		pending.catch(() => probes.delete(target.executable));
+		return pending;
+	};
+	const run = async (prompt, runOptions = {}) => {
+		const merged = {
+			...options,
+			...runOptions,
+			env: {
+				...options.env,
+				...runOptions.env
+			},
+			args: [...options.args ?? [], ...runOptions.args ?? []],
+			mcp: runOptions.mcp ?? options.mcp
+		};
+		const permission = merged.permission ?? "standard";
+		if (permission !== "standard" && permission !== "bypass") throw unsupported(adapter, `unknown permission "${String(permission)}" (use "standard" or "bypass").`);
+		if (merged.effort !== void 0 && adapter.effort !== true) throw unsupported(adapter, "this CLI has no reasoning-effort control; drop `effort`.");
+		const mcp = merged.mcp !== void 0 && Object.keys(merged.mcp).length > 0 ? merged.mcp : void 0;
+		if (mcp !== void 0 && adapter.mcp !== true) throw unsupported(adapter, "this CLI cannot attach per-run MCP servers; drop `mcp`.");
+		if (merged.apiKey !== void 0 && adapter.apiKeyEnv.length === 0) throw unsupported(adapter, "this CLI reads no API key from the environment; drop `apiKey`.");
+		const home = options.home ?? "private";
+		if (home !== "inherit" && adapter.homeEnv.length === 0) throw unsupported(adapter, "this CLI cannot relocate its config home; use `home: \"inherit\"`.");
+		const cwd = path.resolve(merged.cwd ?? process.cwd());
+		const target = resolveTarget();
+		const probe = options.probe === false ? void 0 : await probeTarget(target);
+		if (merged.signal?.aborted) return cancelledSession(adapter.name, merged.resume);
+		const directories = await createRunDirectories(home, cwd);
+		try {
+			let chosen;
+			const reasons = [];
+			for (const transport of adapter.transports) {
+				const context = {
+					prompt,
+					transport,
+					cwd,
+					model: merged.model,
+					effort: merged.effort,
+					permission,
+					resume: merged.resume,
+					mcp,
+					apiKey: merged.apiKey,
+					home: directories.home,
+					homeIsPrivate: directories.homeIsPrivate,
+					runDir: directories.runDir,
+					platform: host.platform
+				};
+				const plan = adapter.plan(context);
+				if (probe !== void 0) assertCapabilities(adapter, probe, plan.requires);
+				const invocation = buildInvocation(target, [
+					...plan.args,
+					...merged.args ?? [],
+					...plan.tail ?? []
+				], host.comspec);
+				if ("refused" in invocation) {
+					reasons.push(`${transport}: ${invocation.refused}`);
+					continue;
+				}
+				if (!fitsCommandLine(invocation, host.platform)) {
+					reasons.push(`${transport}: the command line exceeds the platform limit`);
+					continue;
+				}
+				chosen = {
+					plan,
+					invocation,
+					context
+				};
+				break;
+			}
+			if (chosen === void 0) throw new CliError(`${adapter.title}: the prompt cannot be passed to "${target.executable}" (${reasons.join("; ")}).`, {
+				type: "prompt-transport",
+				adapter: adapter.name,
+				executable: target.executable
+			});
+			await writeLaunchFiles(chosen.plan.files ?? [], directories);
+			const apiKeyEnv = adapter.apiKeyEnv[0];
+			const env = buildEnvironment({
+				source: host.env,
+				inherit: options.inheritEnv ?? true,
+				managed: home === "inherit" ? [] : adapter.homeEnv,
+				plan: host.platform === "win32" ? chosen.plan.env : {
+					PWD: cwd,
+					...chosen.plan.env
+				},
+				user: merged.env,
+				apiKey: merged.apiKey !== void 0 && apiKeyEnv !== void 0 ? {
+					name: apiKeyEnv,
+					value: merged.apiKey
+				} : void 0,
+				platform: host.platform
+			});
+			return startSession({
+				adapter: adapter.name,
+				invocation: chosen.invocation,
+				cwd,
+				env,
+				stdin: chosen.plan.stdin,
+				parser: adapter.parser(chosen.context),
+				signal: merged.signal,
+				timeoutMs: merged.timeoutMs,
+				killGraceMs: options.killGraceMs ?? 2e3,
+				platform: host.platform,
+				resume: merged.resume,
+				cleanup: directories.dispose
+			});
+		} catch (error) {
+			await directories.dispose();
+			throw error;
+		}
+	};
+	const agent = {
+		adapter,
+		options,
+		run,
+		probe: () => probeTarget(resolveTarget()),
+		model: (config) => cliModel(agent, config)
+	};
+	return agent;
+}
+
+//#endregion
+export { createCliAgent, currentHost };
+//# sourceMappingURL=cli-agent.mjs.map

package/esm/cli-agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-agent.mjs","names":[],"sources":["../../../../../../../packages/ai-cli/src/cli-agent.ts"],"sourcesContent":["import { accessSync, constants, readFileSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n  CliAdapter,\n  CliAgentOptions,\n  CliLaunchContext,\n  CliLaunchPlan,\n  CliProbeResult,\n  CliRunOptions,\n  CliSession,\n} from \"./contracts\";\nimport type { ModelContract } from \"@warlock.js/ai\";\nimport { CliError } from \"./errors\";\nimport { type CliModelConfig, cliModel } from \"./model/cli-model\";\nimport { assertCapabilities, probeCli } from \"./probe/probe\";\nimport { buildEnvironment } from \"./session/environment\";\nimport { createRunDirectories, writeLaunchFiles } from \"./session/run-directory\";\nimport { cancelledSession, startSession } from \"./session/session\";\nimport { buildInvocation, fitsCommandLine, type Invocation } from \"./spawn/invocation\";\nimport {\n  type CommandLookup,\n  readEnv,\n  resolveSpawnTarget,\n  type SpawnTarget,\n} from \"./spawn/resolve-command\";\n\n/** A configured coding CLI: run prompts, probe the binary, or use it as an `ai.agent` model. */\nexport type CliAgent = {\n  readonly adapter: CliAdapter;\n  readonly options: Readonly<CliAgentOptions>;\n  /**\n   * Start a session. Rejects (with {@link CliError}) only for setup problems\n   * — executable not found, a flag missing from `--help`, an unsupported\n   * option; the run's own outcome is reported by `session.done()`.\n   */\n  run(prompt: string, options?: CliRunOptions): Promise<CliSession>;\n  /** Run (or reuse) the capability probe: resolved executable, version and help text. */\n  probe(): Promise<CliProbeResult>;\n  /** This CLI as an `ai.agent` model (see {@link cliModel}). */\n  model(config?: CliModelConfig): ModelContract;\n};\n\n/** Host facts, injectable for tests. */\nexport type CliHost = CommandLookup & { comspec: string };\n\nfunction isRunnableFile(filePath: string, platform: NodeJS.Platform): boolean {\n  try {\n    if (!statSync(filePath).isFile()) {\n      return false;\n    }\n\n    if (platform !== \"win32\") {\n      accessSync(filePath, constants.X_OK);\n    }\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** The current machine as a {@link CliHost}. */\nexport function currentHost(): CliHost {\n  const platform = process.platform;\n\n  return {\n    platform,\n    env: process.env,\n    isFile: (filePath) => isRunnableFile(filePath, platform),\n    readFile: (filePath) => {\n      try {\n        return readFileSync(filePath, \"utf8\");\n      } catch {\n        return undefined;\n      }\n    },\n    execPath: process.execPath,\n    comspec: readEnv(process.env, \"ComSpec\", platform) ?? \"cmd.exe\",\n  };\n}\n\nfunction unsupported(adapter: CliAdapter, message: string): CliError {\n  return new CliError(`${adapter.title}: ${message}`, {\n    type: \"unsupported-option\",\n    adapter: adapter.name,\n  });\n}\n\n/**\n * Create a CLI agent from an adapter. The vendor factories\n * (`cli.claudeCode(...)`, `cli.codex(...)`, …) call this with their\n * built-in adapter; call it directly with your own {@link CliAdapter}.\n *\n * @example\n * const agent = createCliAgent(myAdapter, { model: \"fast\", permission: \"standard\" });\n * const session = await agent.run(\"Summarize README.md\", { cwd: \"/srv/repo\" });\n * console.log((await session.done()).text);\n */\nexport function createCliAgent(\n  adapter: CliAdapter,\n  options: CliAgentOptions = {},\n  host: CliHost = currentHost(),\n): CliAgent {\n  const probes = new Map<string, Promise<CliProbeResult>>();\n  const command = options.command ?? adapter.command;\n\n  const resolveTarget = (): SpawnTarget => {\n    const target = resolveSpawnTarget(command, host);\n\n    if (target === undefined) {\n      throw new CliError(\n        `${adapter.title}: could not find \"${command}\" on PATH. Install the CLI or pass its absolute path as \\`command\\`.`,\n        { type: \"not-found\", adapter: adapter.name },\n      );\n    }\n\n    return target;\n  };\n\n  const probeEnvironment = (): Record<string, string> =>\n    buildEnvironment({\n      source: host.env,\n      inherit: options.inheritEnv ?? true,\n      managed: [],\n      user: options.env,\n      platform: host.platform,\n    });\n\n  const probeTarget = (target: SpawnTarget): Promise<CliProbeResult> => {\n    const cached = probes.get(target.executable);\n\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const pending = probeCli({\n      adapter,\n      target,\n      env: probeEnvironment(),\n      cwd: path.resolve(options.cwd ?? process.cwd()),\n      comspec: host.comspec,\n      platform: host.platform,\n    });\n\n    probes.set(target.executable, pending);\n    // A failed probe is retried on the next run instead of being cached.\n    pending.catch(() => probes.delete(target.executable));\n\n    return pending;\n  };\n\n  const run = async (prompt: string, runOptions: CliRunOptions = {}): Promise<CliSession> => {\n    const merged: CliRunOptions = {\n      ...options,\n      ...runOptions,\n      env: { ...options.env, ...runOptions.env },\n      args: [...(options.args ?? []), ...(runOptions.args ?? [])],\n      mcp: runOptions.mcp ?? options.mcp,\n    };\n    const permission = merged.permission ?? \"standard\";\n\n    if (permission !== \"standard\" && permission !== \"bypass\") {\n      throw unsupported(\n        adapter,\n        `unknown permission \"${String(permission)}\" (use \"standard\" or \"bypass\").`,\n      );\n    }\n\n    if (merged.effort !== undefined && adapter.effort !== true) {\n      throw unsupported(adapter, \"this CLI has no reasoning-effort control; drop `effort`.\");\n    }\n\n    const mcp =\n      merged.mcp !== undefined && Object.keys(merged.mcp).length > 0 ? merged.mcp : undefined;\n\n    if (mcp !== undefined && adapter.mcp !== true) {\n      throw unsupported(adapter, \"this CLI cannot attach per-run MCP servers; drop `mcp`.\");\n    }\n\n    if (merged.apiKey !== undefined && adapter.apiKeyEnv.length === 0) {\n      throw unsupported(adapter, \"this CLI reads no API key from the environment; drop `apiKey`.\");\n    }\n\n    const home = options.home ?? \"private\";\n\n    if (home !== \"inherit\" && adapter.homeEnv.length === 0) {\n      throw unsupported(\n        adapter,\n        'this CLI cannot relocate its config home; use `home: \"inherit\"`.',\n      );\n    }\n\n    const cwd = path.resolve(merged.cwd ?? process.cwd());\n    const target = resolveTarget();\n    const probe = options.probe === false ? undefined : await probeTarget(target);\n\n    if (merged.signal?.aborted) {\n      return cancelledSession(adapter.name, merged.resume);\n    }\n\n    const directories = await createRunDirectories(home, cwd);\n\n    try {\n      let chosen:\n        | { plan: CliLaunchPlan; invocation: Invocation; context: CliLaunchContext }\n        | undefined;\n      const reasons: string[] = [];\n\n      for (const transport of adapter.transports) {\n        const context: CliLaunchContext = {\n          prompt,\n          transport,\n          cwd,\n          model: merged.model,\n          effort: merged.effort,\n          permission,\n          resume: merged.resume,\n          mcp,\n          apiKey: merged.apiKey,\n          home: directories.home,\n          homeIsPrivate: directories.homeIsPrivate,\n          runDir: directories.runDir,\n          platform: host.platform,\n        };\n        const plan = adapter.plan(context);\n\n        if (probe !== undefined) {\n          assertCapabilities(adapter, probe, plan.requires);\n        }\n\n        const invocation = buildInvocation(\n          target,\n          [...plan.args, ...(merged.args ?? []), ...(plan.tail ?? [])],\n          host.comspec,\n        );\n\n        if (\"refused\" in invocation) {\n          reasons.push(`${transport}: ${invocation.refused}`);\n          continue;\n        }\n\n        if (!fitsCommandLine(invocation, host.platform)) {\n          reasons.push(`${transport}: the command line exceeds the platform limit`);\n          continue;\n        }\n\n        chosen = { plan, invocation, context };\n        break;\n      }\n\n      if (chosen === undefined) {\n        throw new CliError(\n          `${adapter.title}: the prompt cannot be passed to \"${target.executable}\" (${reasons.join(\"; \")}).`,\n          { type: \"prompt-transport\", adapter: adapter.name, executable: target.executable },\n        );\n      }\n\n      await writeLaunchFiles(chosen.plan.files ?? [], directories);\n\n      const apiKeyEnv = adapter.apiKeyEnv[0];\n      const env = buildEnvironment({\n        source: host.env,\n        inherit: options.inheritEnv ?? true,\n        managed: home === \"inherit\" ? [] : adapter.homeEnv,\n        // A CLI that prefers $PWD over its real cwd must not see the host's.\n        plan: host.platform === \"win32\" ? chosen.plan.env : { PWD: cwd, ...chosen.plan.env },\n        user: merged.env,\n        apiKey:\n          merged.apiKey !== undefined && apiKeyEnv !== undefined\n            ? { name: apiKeyEnv, value: merged.apiKey }\n            : undefined,\n        platform: host.platform,\n      });\n\n      return startSession({\n        adapter: adapter.name,\n        invocation: chosen.invocation,\n        cwd,\n        env,\n        stdin: chosen.plan.stdin,\n        parser: adapter.parser(chosen.context),\n        signal: merged.signal,\n        timeoutMs: merged.timeoutMs,\n        killGraceMs: options.killGraceMs ?? 2000,\n        platform: host.platform,\n        resume: merged.resume,\n        cleanup: directories.dispose,\n      });\n    } catch (error) {\n      await directories.dispose();\n      throw error;\n    }\n  };\n\n  const agent: CliAgent = {\n    adapter,\n    options,\n    run,\n    probe: () => probeTarget(resolveTarget()),\n    model: (config) => cliModel(agent, config),\n  };\n\n  return agent;\n}\n"],"mappings":"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"}

package/esm/cli.d.mts

@@ -0,0 +1,53 @@
+import { CliAdapter } from "./contracts/adapter.contract.mjs";
+import { CliAgentOptions } from "./contracts/options.type.mjs";
+import { cliModel } from "./model/cli-model.mjs";
+import { CliAgent } from "./cli-agent.mjs";
+
+//#region ../../packages/ai-cli/src/cli.d.ts
+/** Every built-in adapter, keyed by its factory name. */
+declare const cliAdapters: {
+  readonly claudeCode: CliAdapter;
+  readonly codex: CliAdapter;
+  readonly antigravity: CliAdapter;
+  readonly qwenCode: CliAdapter;
+  readonly kimi: CliAdapter;
+  readonly cursor: CliAdapter;
+  readonly copilot: CliAdapter;
+  readonly grok: CliAdapter;
+  readonly opencode: CliAdapter;
+  readonly amp: CliAdapter;
+  readonly droid: CliAdapter;
+  readonly mistralVibe: CliAdapter;
+  readonly aider: CliAdapter;
+  readonly reasonix: CliAdapter;
+};
+/** Name of a built-in adapter factory. */
+type CliVendor = keyof typeof cliAdapters;
+type VendorFactories = { [Vendor in CliVendor]: (options?: CliAgentOptions) => CliAgent };
+/**
+ * The CLI-agent namespace: one factory per vendor, `custom()` for your own
+ * adapter, `model()` to hand a CLI agent to `ai.agent`. Also available as
+ * `ai.cli` once the package is imported.
+ *
+ * @example
+ * import { cli } from "@warlock.js/ai-cli";
+ *
+ * const claude = cli.claudeCode({ model: "sonnet", cwd: "/srv/repo" });
+ * const session = await claude.run("Fix the failing test");
+ * for await (const event of session.events) console.log(event.type);
+ * const { text, usage, sessionRef } = await session.done();
+ */
+declare const cli: VendorFactories & {
+  /** A CLI agent for an adapter you wrote. */custom(adapter: CliAdapter, options?: CliAgentOptions): CliAgent; /** A CLI agent as an `ai.agent` model. */
+  model: typeof cliModel; /** The built-in adapters, for inspection or extension. */
+  adapters: typeof cliAdapters;
+};
+declare module "@warlock.js/ai" {
+  interface Ai {
+    /** Drive vendor coding CLIs (Claude Code, Codex, Copilot, …) as agents. */
+    cli: typeof cli;
+  }
+}
+//#endregion
+export { CliVendor, cli, cliAdapters };
+//# sourceMappingURL=cli.d.mts.map

package/esm/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../../../../../../../packages/ai-cli/src/cli.ts"],"mappings":";;;;;;;cAoBa,WAAA;EAAA;;;;;;;;;;;;;;;;KAkBD,SAAA,gBAAyB,WAAW;AAAA,KAE3C,eAAA,gBAA+B,SAAA,IAAa,OAAA,GAAU,eAAA,KAAoB,QAAA;;;;;;;;;;;;;;cAsBlE,GAAA,EAAK,eAAA;8CAEhB,MAAA,CAAO,OAAA,EAAS,UAAA,EAAY,OAAA,GAAU,eAAA,GAAkB,QAAA;EAExD,KAAA,SAAc,QAAA;EAEd,QAAA,SAAiB,WAAA;AAAA;AAAA;EAAA,UASP,EAAA;;IAER,GAAA,SAAY,GAAG;EAAA;AAAA"}