@nimashoghi/code-agent-kit 0.1.0 → 0.2.0

package/README.md

@@ -35,6 +35,7 @@ npm install @anthropic-ai/claude-agent-sdk
 
 ```bash
 code-agent-kit --runtime claude "Fix the failing tests"
+code-agent-kit --model claude-sonnet-4-20250514 "Fix the failing tests"
 code-agent-kit --runtime codex --system "Run tests before finishing." "Add validation"
 code-agent-kit --runtime gemini --file src/runtime.ts "Summarize this file"
 code-agent-kit --runtime claude --resume session-123 "Continue the last task"
@@ -43,6 +44,7 @@ code-agent-kit --runtime claude --resume session-123 "Continue the last task"
 Options:
 
 - `--runtime <name>`: `claude`, `codex`, `copilot`, or `gemini`
+- `--model <name>`: model override for the selected runtime
 - `--directory <path>`: working directory for the agent
 - `--system <text>`: system prompt text
 - `--file <path>`: attach a text file, repeatable
@@ -51,6 +53,41 @@ Options:
 
 When you explicitly pass `--runtime`, the CLI propagates that choice to child processes through `CODE_AGENT_KIT_RUNTIME`. Nested invocations of `code-agent-kit` use that value as their default runtime.
 
+## Local Config
+
+The CLI reads a local JSON config from the standard config directory:
+
+- Linux: `${XDG_CONFIG_HOME:-~/.config}/code-agent-kit/config.json`
+- macOS: `~/Library/Application Support/code-agent-kit/config.json`
+- Windows: `%APPDATA%\\code-agent-kit\\config.json`
+
+Supported keys:
+
+- `runtime`
+- `model`
+- `systemPrompt`
+- `directory`
+- `timeoutMs`
+
+Priority is:
+
+1. Explicit CLI flags
+2. Propagated `CODE_AGENT_KIT_RUNTIME`
+3. `DEFAULT_RUNTIME`
+4. Local config
+5. Built-in defaults
+
+Examples:
+
+```bash
+code-agent-kit config set runtime codex
+code-agent-kit config set model gpt-5-codex
+code-agent-kit config set timeoutMs 300000
+code-agent-kit config show
+code-agent-kit config unset model
+code-agent-kit config path
+```
+
 ## Library Usage
 
 ```ts

package/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-import { createCliProgram } from "./dist/cli/index.js";
+import { runCli } from "./dist/cli/index.js";
 
-createCliProgram().parseAsync().catch((error) => {
+runCli().catch((error) => {
   const message = error instanceof Error ? error.message : String(error);
   console.error(message);
   process.exit(1);

package/dist/{chunk-ZUMYGBXZ.js → chunk-4LBC5KHN.js}

@@ -1,7 +1,7 @@
 import {
   assertRuntimeRunOptionsSupported,
   buildRuntimePrompt
-} from "./chunk-YAZLCEAU.js";
+} from "./chunk-R7CCLWKJ.js";
 
 // src/runtimes/gemini.ts
 import { execFile, spawn } from "child_process";
@@ -225,4 +225,4 @@ function execGemini(args, options) {
 export {
   GeminiRuntime
 };
-//# sourceMappingURL=chunk-ZUMYGBXZ.js.map
+//# sourceMappingURL=chunk-4LBC5KHN.js.map

package/dist/{chunk-AVSJQKCD.js → chunk-4OVN4G22.js}

@@ -1,7 +1,7 @@
 import {
   assertRuntimeRunOptionsSupported,
   buildRuntimePrompt
-} from "./chunk-YAZLCEAU.js";
+} from "./chunk-R7CCLWKJ.js";
 
 // src/runtimes/copilot.ts
 var CopilotRuntime = class _CopilotRuntime {
@@ -51,4 +51,4 @@ ${systemPrompt}`, prompt].join("\n\n");
 export {
   CopilotRuntime
 };
-//# sourceMappingURL=chunk-AVSJQKCD.js.map
+//# sourceMappingURL=chunk-4OVN4G22.js.map

package/dist/{chunk-EN5WJJ2G.js → chunk-BPQL5GAO.js}

@@ -1,7 +1,7 @@
 import {
   assertRuntimeRunOptionsSupported,
   buildRuntimePrompt
-} from "./chunk-YAZLCEAU.js";
+} from "./chunk-R7CCLWKJ.js";
 
 // src/runtimes/claude.ts
 import {
@@ -150,4 +150,4 @@ function emitAssistantBlocks(message, onEvent) {
 export {
   ClaudeRuntime
 };
-//# sourceMappingURL=chunk-EN5WJJ2G.js.map
+//# sourceMappingURL=chunk-BPQL5GAO.js.map

package/dist/{chunk-YAZLCEAU.js → chunk-R7CCLWKJ.js}

@@ -120,4 +120,4 @@ export {
   assertRuntimeRunOptionsSupported,
   buildRuntimePrompt
 };
-//# sourceMappingURL=chunk-YAZLCEAU.js.map
+//# sourceMappingURL=chunk-R7CCLWKJ.js.map

package/dist/chunk-R7CCLWKJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Core runtime abstractions for running a coding agent on a task. */\n\n/** Event emitted during agent execution for real-time progress streaming. */\nexport type RuntimeEvent =\n  | { type: \"text\"; content: string }\n  | { type: \"tool_use\"; tool: string; input?: unknown }\n  | { type: \"tool_result\"; tool: string; output?: string; isError?: boolean }\n  | { type: \"thinking\"; content: string }\n  | { type: \"error\"; message: string };\n\nexport type RuntimeFeature =\n  | \"resumeSession\"\n  | \"eventStreaming\";\n\nexport interface RuntimeCapabilities {\n  readonly resumeSession: boolean;\n  readonly eventStreaming: boolean;\n}\n\nexport interface RuntimeClass<T extends AgentRuntime = AgentRuntime> {\n  new (...args: any[]): T;\n  readonly runtimeName: string;\n  readonly capabilities: RuntimeCapabilities;\n}\n\nexport type RuntimeSession =\n  | { mode: \"new\" }\n  | { mode: \"resume\"; sessionId: string };\n\n/** Options passed to AgentRuntime.run(). */\nexport interface RuntimeRunOptions {\n  /** Directory the agent operates in. */\n  workingDirectory: string;\n\n  /** The task/instructions for the agent. */\n  prompt: string;\n\n  /** Optional system prompt text for the run. */\n  systemPrompt?: string;\n\n  /** Optional text file attachments included alongside the prompt. */\n  attachments?: RuntimeAttachment[];\n\n  /** Environment variables injected into the agent process. */\n  env?: Record<string, string>;\n\n  /** Session behavior for the run. */\n  session?: RuntimeSession;\n\n  /** Timeout in milliseconds. */\n  timeoutMs?: number;\n\n  /** Abort signal for cancellation. */\n  signal?: AbortSignal;\n\n  /** Optional streaming callback for real-time progress. */\n  onEvent?: (event: RuntimeEvent) => void;\n}\n\n/** Result returned by AgentRuntime.run(). */\nexport interface AgentResult {\n  success: boolean;\n  output: string;\n  error?: string;\n  sessionId?: string;\n}\n\nexport interface RuntimeAttachment {\n  /** File path to attach. Relative paths resolve from workingDirectory. */\n  path: string;\n\n  /** Optional inline content. When omitted, the file is read from disk. */\n  content?: string;\n}\n\nfunction featureDescription(feature: RuntimeFeature): string {\n  switch (feature) {\n    case \"resumeSession\":\n      return \"session resume\";\n    case \"eventStreaming\":\n      return \"event streaming\";\n  }\n}\n\nexport class UnsupportedRuntimeFeatureError extends Error {\n  readonly runtime: string;\n  readonly feature: RuntimeFeature;\n  readonly operation: string;\n  readonly details?: string;\n\n  constructor(options: {\n    runtime: string;\n    feature: RuntimeFeature;\n    operation: string;\n    details?: string;\n  }) {\n    const message = [\n      `Runtime \"${options.runtime}\" does not support ${featureDescription(options.feature)} for ${options.operation}.`,\n      options.details,\n    ]\n      .filter(Boolean)\n      .join(\" \");\n\n    super(message);\n    this.name = \"UnsupportedRuntimeFeatureError\";\n    this.runtime = options.runtime;\n    this.feature = options.feature;\n    this.operation = options.operation;\n    this.details = options.details;\n  }\n}\n\nfunction supportsFeature(\n  capabilities: RuntimeCapabilities,\n  feature: RuntimeFeature,\n): boolean {\n  switch (feature) {\n    case \"resumeSession\":\n      return capabilities.resumeSession;\n    case \"eventStreaming\":\n      return capabilities.eventStreaming;\n  }\n}\n\nexport function getRequestedRuntimeFeatures(\n  options: Pick<RuntimeRunOptions, \"onEvent\" | \"session\">,\n): RuntimeFeature[] {\n  const features: RuntimeFeature[] = [];\n\n  if (options.onEvent) {\n    features.push(\"eventStreaming\");\n  }\n\n  if (options.session?.mode === \"resume\") {\n    features.push(\"resumeSession\");\n  }\n\n  return features;\n}\n\n/** The core abstraction: run a coding agent on a task. */\nexport interface AgentRuntime {\n  readonly name: string;\n\n  /** Run the agent on a prompt in a directory, return when done. */\n  run(options: RuntimeRunOptions): Promise<AgentResult>;\n\n  /** Optional cleanup. */\n  dispose?(): Promise<void>;\n}\n\nfunction getRuntimeCapabilities(\n  runtime: AgentRuntime | RuntimeClass,\n): RuntimeCapabilities {\n  if (typeof runtime === \"function\") {\n    return runtime.capabilities;\n  }\n\n  const runtimeClass = runtime.constructor as RuntimeClass;\n  if (!runtimeClass.capabilities) {\n    throw new Error(\n      `Runtime \"${runtime.name}\" is missing static capabilities metadata on its constructor.`,\n    );\n  }\n\n  return runtimeClass.capabilities;\n}\n\nfunction getRuntimeDisplayName(runtime: AgentRuntime | RuntimeClass): string {\n  if (typeof runtime === \"function\") {\n    return runtime.runtimeName;\n  }\n\n  const runtimeClass = runtime.constructor as RuntimeClass;\n  return runtimeClass.runtimeName ?? runtime.name;\n}\n\nexport function assertRuntimeSupports(\n  runtime: AgentRuntime | RuntimeClass,\n  features: readonly RuntimeFeature[],\n  operation: string,\n): void {\n  const capabilities = getRuntimeCapabilities(runtime);\n  const runtimeName = getRuntimeDisplayName(runtime);\n\n  for (const feature of features) {\n    if (supportsFeature(capabilities, feature)) {\n      continue;\n    }\n\n    throw new UnsupportedRuntimeFeatureError({\n      runtime: runtimeName,\n      feature,\n      operation,\n    });\n  }\n}\n\nexport function assertRuntimeRunOptionsSupported(\n  runtime: AgentRuntime | RuntimeClass,\n  options: Pick<RuntimeRunOptions, \"onEvent\" | \"session\">,\n  operation: string,\n): void {\n  assertRuntimeSupports(\n    runtime,\n    getRequestedRuntimeFeatures(options),\n    operation,\n  );\n}\n\nexport async function buildRuntimePrompt(\n  options: Pick<RuntimeRunOptions, \"workingDirectory\" | \"prompt\" | \"attachments\">,\n): Promise<string> {\n  const attachments = await Promise.all(\n    (options.attachments ?? []).map(async (attachment) => {\n      const content =\n        attachment.content ??\n        (await fs.readFile(\n          path.resolve(options.workingDirectory, attachment.path),\n          \"utf8\",\n        ));\n\n      return {\n        path: attachment.path,\n        content,\n      };\n    }),\n  );\n\n  if (attachments.length === 0) {\n    return options.prompt;\n  }\n\n  const attachmentText = attachments\n    .map(\n      (attachment) =>\n        [\n          `Attached file: ${attachment.path}`,\n          \"```\",\n          attachment.content,\n          \"```\",\n        ].join(\"\\n\"),\n    )\n    .join(\"\\n\\n\");\n\n  return [attachmentText, `Task:\\n${options.prompt}`].join(\"\\n\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-CGK4TBZD.js → chunk-UINMTZRO.js}

@@ -1,7 +1,7 @@
 import {
   assertRuntimeRunOptionsSupported,
   buildRuntimePrompt
-} from "./chunk-YAZLCEAU.js";
+} from "./chunk-R7CCLWKJ.js";
 
 // src/runtimes/codex.ts
 import {
@@ -218,4 +218,4 @@ function serializeMcpResult(result) {
 export {
   CodexRuntime
 };
-//# sourceMappingURL=chunk-CGK4TBZD.js.map
+//# sourceMappingURL=chunk-UINMTZRO.js.map

package/dist/chunk-VPJA6I2O.js

@@ -0,0 +1,180 @@
+import {
+  ClaudeRuntime
+} from "./chunk-BPQL5GAO.js";
+import {
+  CodexRuntime
+} from "./chunk-UINMTZRO.js";
+import {
+  CopilotRuntime
+} from "./chunk-4OVN4G22.js";
+import {
+  GeminiRuntime
+} from "./chunk-4LBC5KHN.js";
+
+// src/runtimes/registry.ts
+var RUNTIME_NAMES = [
+  "claude",
+  "codex",
+  "copilot",
+  "gemini"
+];
+var RUNTIME_CLASSES = [
+  ClaudeRuntime,
+  CodexRuntime,
+  CopilotRuntime,
+  GeminiRuntime
+];
+function getAvailableRuntimeClasses(requiredCapabilities = []) {
+  return RUNTIME_CLASSES.filter(
+    (runtimeClass) => requiredCapabilities.every((feature) => runtimeClass.capabilities[feature])
+  );
+}
+function getAvailableRuntimeNames(requiredCapabilities = []) {
+  return getAvailableRuntimeClasses(requiredCapabilities).map(
+    (runtimeClass) => runtimeClass.runtimeName
+  );
+}
+function createRuntime(options) {
+  const requiredCapabilities = options?.requiredCapabilities ?? [];
+  const availableRuntimeClasses = getAvailableRuntimeClasses(requiredCapabilities);
+  if (availableRuntimeClasses.length === 0) {
+    throw new Error(
+      `No runtimes support the required capabilities: ${requiredCapabilities.join(", ")}`
+    );
+  }
+  const targetName = options?.name ?? options?.defaultRuntime ?? availableRuntimeClasses[0].runtimeName;
+  const selectedRuntimeClass = availableRuntimeClasses.find(
+    (runtimeClass) => runtimeClass.runtimeName === targetName
+  );
+  if (!selectedRuntimeClass) {
+    throw new Error(
+      `Unknown or unsupported runtime: ${targetName}. Available runtimes: ${availableRuntimeClasses.map((runtimeClass) => runtimeClass.runtimeName).join(", ")}`
+    );
+  }
+  return new selectedRuntimeClass(options?.config);
+}
+function getRuntimeCapabilities(runtime) {
+  return runtime.constructor.capabilities;
+}
+
+// src/config.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { z } from "zod";
+var CONFIG_DIR_NAME = "code-agent-kit";
+var CONFIG_FILE_NAME = "config.json";
+var CliConfigSchema = z.object({
+  runtime: z.enum(RUNTIME_NAMES).optional(),
+  model: z.string().min(1).optional(),
+  systemPrompt: z.string().min(1).optional(),
+  directory: z.string().min(1).optional(),
+  timeoutMs: z.number().int().positive().optional()
+}).strict();
+var CLI_CONFIG_KEYS = [
+  "runtime",
+  "model",
+  "systemPrompt",
+  "directory",
+  "timeoutMs"
+];
+var CLI_CONFIG_VALUE_SCHEMAS = {
+  runtime: z.enum(RUNTIME_NAMES),
+  model: z.string().min(1),
+  systemPrompt: z.string().min(1),
+  directory: z.string().min(1),
+  timeoutMs: z.coerce.number().int().positive()
+};
+function getCliConfigDir(env = process.env, platform = process.platform) {
+  if (platform === "win32") {
+    return path.join(
+      env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming"),
+      CONFIG_DIR_NAME
+    );
+  }
+  if (platform === "darwin") {
+    return path.join(
+      env.XDG_CONFIG_HOME ?? path.join(os.homedir(), "Library", "Application Support"),
+      CONFIG_DIR_NAME
+    );
+  }
+  return path.join(
+    env.XDG_CONFIG_HOME ?? path.join(os.homedir(), ".config"),
+    CONFIG_DIR_NAME
+  );
+}
+function getCliConfigPath(env = process.env, platform = process.platform) {
+  return path.join(getCliConfigDir(env, platform), CONFIG_FILE_NAME);
+}
+function readCliConfig(env = process.env, platform = process.platform) {
+  const configPath = getCliConfigPath(env, platform);
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to read CLI config at ${configPath}: ${message}`);
+  }
+  const result = CliConfigSchema.safeParse(parsed);
+  if (!result.success) {
+    throw new Error(
+      `Invalid CLI config at ${configPath}: ${result.error.issues.map((issue) => issue.message).join("; ")}`
+    );
+  }
+  return result.data;
+}
+function writeCliConfig(config, env = process.env, platform = process.platform) {
+  const validated = CliConfigSchema.parse(config);
+  const configPath = getCliConfigPath(env, platform);
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, `${JSON.stringify(validated, null, 2)}
+`, "utf8");
+  return configPath;
+}
+function setCliConfigValue(key, value, env = process.env, platform = process.platform) {
+  const current = readCliConfig(env, platform);
+  const next = {
+    ...current,
+    [key]: CLI_CONFIG_VALUE_SCHEMAS[key].parse(value)
+  };
+  return {
+    config: next,
+    configPath: writeCliConfig(next, env, platform)
+  };
+}
+function unsetCliConfigValue(key, env = process.env, platform = process.platform) {
+  const current = { ...readCliConfig(env, platform) };
+  delete current[key];
+  return {
+    config: current,
+    configPath: writeCliConfig(current, env, platform)
+  };
+}
+function isRuntimeName(value) {
+  return value != null && RUNTIME_NAMES.includes(value);
+}
+function isCliConfigKey(value) {
+  return value in CLI_CONFIG_VALUE_SCHEMAS;
+}
+
+export {
+  RUNTIME_NAMES,
+  getAvailableRuntimeClasses,
+  getAvailableRuntimeNames,
+  createRuntime,
+  getRuntimeCapabilities,
+  CliConfigSchema,
+  CLI_CONFIG_KEYS,
+  getCliConfigDir,
+  getCliConfigPath,
+  readCliConfig,
+  writeCliConfig,
+  setCliConfigValue,
+  unsetCliConfigValue,
+  isRuntimeName,
+  isCliConfigKey
+};
+//# sourceMappingURL=chunk-VPJA6I2O.js.map

package/dist/chunk-VPJA6I2O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtimes/registry.ts","../src/config.ts"],"sourcesContent":["import type {\n  AgentRuntime,\n  RuntimeCapabilities,\n  RuntimeFeature,\n  RuntimeClass,\n} from \"../runtime.js\";\nimport { ClaudeRuntime } from \"./claude.js\";\nimport { CodexRuntime } from \"./codex.js\";\nimport { CopilotRuntime } from \"./copilot.js\";\nimport { GeminiRuntime } from \"./gemini.js\";\nimport type { ClaudeRuntimeConfig } from \"./claude.js\";\nimport type { CodexRuntimeConfig } from \"./codex.js\";\nimport type { CopilotRuntimeConfig } from \"./copilot.js\";\nimport type { GeminiRuntimeConfig } from \"./gemini.js\";\n\nexport type RuntimeName = \"claude\" | \"codex\" | \"copilot\" | \"gemini\";\nexport const RUNTIME_NAMES = [\n  \"claude\",\n  \"codex\",\n  \"copilot\",\n  \"gemini\",\n] as const satisfies readonly RuntimeName[];\n\nexport interface RuntimeConfigByName {\n  claude: ClaudeRuntimeConfig;\n  codex: CodexRuntimeConfig;\n  copilot: CopilotRuntimeConfig;\n  gemini: GeminiRuntimeConfig;\n}\n\nexport type RuntimeConfig = RuntimeConfigByName[RuntimeName];\n\ntype RegisteredRuntimeClass = RuntimeClass<AgentRuntime> & {\n  readonly runtimeName: RuntimeName;\n};\n\nconst RUNTIME_CLASSES = [\n  ClaudeRuntime,\n  CodexRuntime,\n  CopilotRuntime,\n  GeminiRuntime,\n] as const satisfies readonly RegisteredRuntimeClass[];\n\nexport function getAvailableRuntimeClasses(\n  requiredCapabilities: readonly RuntimeFeature[] = [],\n): RegisteredRuntimeClass[] {\n  return RUNTIME_CLASSES.filter((runtimeClass) =>\n    requiredCapabilities.every((feature) => runtimeClass.capabilities[feature]),\n  );\n}\n\nexport function getAvailableRuntimeNames(\n  requiredCapabilities: readonly RuntimeFeature[] = [],\n): RuntimeName[] {\n  return getAvailableRuntimeClasses(requiredCapabilities).map(\n    (runtimeClass) => runtimeClass.runtimeName,\n  );\n}\n\nexport function createRuntime(options?: {\n  name?: string;\n  requiredCapabilities?: readonly RuntimeFeature[];\n  defaultRuntime?: RuntimeName;\n  config?: RuntimeConfig;\n}): AgentRuntime {\n  const requiredCapabilities = options?.requiredCapabilities ?? [];\n  const availableRuntimeClasses =\n    getAvailableRuntimeClasses(requiredCapabilities);\n\n  if (availableRuntimeClasses.length === 0) {\n    throw new Error(\n      `No runtimes support the required capabilities: ${requiredCapabilities.join(\", \")}`,\n    );\n  }\n\n  const targetName =\n    options?.name ??\n    options?.defaultRuntime ??\n    availableRuntimeClasses[0]!.runtimeName;\n  const selectedRuntimeClass = availableRuntimeClasses.find(\n    (runtimeClass) => runtimeClass.runtimeName === targetName,\n  );\n\n  if (!selectedRuntimeClass) {\n    throw new Error(\n      `Unknown or unsupported runtime: ${targetName}. Available runtimes: ${availableRuntimeClasses\n        .map((runtimeClass) => runtimeClass.runtimeName)\n        .join(\", \")}`,\n    );\n  }\n\n  return new selectedRuntimeClass(options?.config);\n}\n\nexport function getRuntimeCapabilities(\n  runtime: AgentRuntime,\n): RuntimeCapabilities {\n  return (runtime.constructor as RuntimeClass).capabilities;\n}\n","import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport { RUNTIME_NAMES, type RuntimeName } from \"./runtimes/registry.js\";\n\nconst CONFIG_DIR_NAME = \"code-agent-kit\";\nconst CONFIG_FILE_NAME = \"config.json\";\n\nexport const CliConfigSchema = z\n  .object({\n    runtime: z.enum(RUNTIME_NAMES).optional(),\n    model: z.string().min(1).optional(),\n    systemPrompt: z.string().min(1).optional(),\n    directory: z.string().min(1).optional(),\n    timeoutMs: z.number().int().positive().optional(),\n  })\n  .strict();\n\nexport type CliConfig = z.infer<typeof CliConfigSchema>;\nexport type CliConfigKey = keyof CliConfig;\nexport const CLI_CONFIG_KEYS = [\n  \"runtime\",\n  \"model\",\n  \"systemPrompt\",\n  \"directory\",\n  \"timeoutMs\",\n] as const satisfies readonly CliConfigKey[];\n\nconst CLI_CONFIG_VALUE_SCHEMAS = {\n  runtime: z.enum(RUNTIME_NAMES),\n  model: z.string().min(1),\n  systemPrompt: z.string().min(1),\n  directory: z.string().min(1),\n  timeoutMs: z.coerce.number().int().positive(),\n} as const satisfies Record<CliConfigKey, z.ZodType>;\n\nexport function getCliConfigDir(\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): string {\n  if (platform === \"win32\") {\n    return path.join(\n      env.APPDATA ?? path.join(os.homedir(), \"AppData\", \"Roaming\"),\n      CONFIG_DIR_NAME,\n    );\n  }\n\n  if (platform === \"darwin\") {\n    return path.join(\n      env.XDG_CONFIG_HOME ??\n        path.join(os.homedir(), \"Library\", \"Application Support\"),\n      CONFIG_DIR_NAME,\n    );\n  }\n\n  return path.join(\n    env.XDG_CONFIG_HOME ?? path.join(os.homedir(), \".config\"),\n    CONFIG_DIR_NAME,\n  );\n}\n\nexport function getCliConfigPath(\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): string {\n  return path.join(getCliConfigDir(env, platform), CONFIG_FILE_NAME);\n}\n\nexport function readCliConfig(\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): CliConfig {\n  const configPath = getCliConfigPath(env, platform);\n  if (!fs.existsSync(configPath)) {\n    return {};\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(configPath, \"utf8\"));\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    throw new Error(`Failed to read CLI config at ${configPath}: ${message}`);\n  }\n\n  const result = CliConfigSchema.safeParse(parsed);\n  if (!result.success) {\n    throw new Error(\n      `Invalid CLI config at ${configPath}: ${result.error.issues\n        .map((issue) => issue.message)\n        .join(\"; \")}`,\n    );\n  }\n\n  return result.data;\n}\n\nexport function writeCliConfig(\n  config: CliConfig,\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): string {\n  const validated = CliConfigSchema.parse(config);\n  const configPath = getCliConfigPath(env, platform);\n  fs.mkdirSync(path.dirname(configPath), { recursive: true });\n  fs.writeFileSync(configPath, `${JSON.stringify(validated, null, 2)}\\n`, \"utf8\");\n  return configPath;\n}\n\nexport function setCliConfigValue<K extends CliConfigKey>(\n  key: K,\n  value: string,\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): { config: CliConfig; configPath: string } {\n  const current = readCliConfig(env, platform);\n  const next = {\n    ...current,\n    [key]: CLI_CONFIG_VALUE_SCHEMAS[key].parse(value),\n  } as CliConfig;\n\n  return {\n    config: next,\n    configPath: writeCliConfig(next, env, platform),\n  };\n}\n\nexport function unsetCliConfigValue<K extends CliConfigKey>(\n  key: K,\n  env: NodeJS.ProcessEnv = process.env,\n  platform = process.platform,\n): { config: CliConfig; configPath: string } {\n  const current = { ...readCliConfig(env, platform) };\n  delete current[key];\n\n  return {\n    config: current,\n    configPath: writeCliConfig(current, env, platform),\n  };\n}\n\nexport function isRuntimeName(value: string | undefined): value is RuntimeName {\n  return value != null && RUNTIME_NAMES.includes(value as RuntimeName);\n}\n\nexport function isCliConfigKey(value: string): value is CliConfigKey {\n  return value in CLI_CONFIG_VALUE_SCHEMAS;\n}\n"],"mappings":"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","names":[]}

package/dist/cli/index.d.ts

@@ -1,10 +1,23 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { RuntimeName } from '../index.js';
-import '../runtime-DxAkSUZk.js';
+import { R as RuntimeName } from '../registry-DkM8QbUx.js';
+import '../runtime-Zjyjv8M_.js';
+import '../runtimes/claude.js';
+import '@anthropic-ai/claude-agent-sdk';
+import '../runtimes/codex.js';
+import '@openai/codex-sdk';
+import '../runtimes/copilot.js';
+import '../runtimes/gemini.js';
 
 declare const RUNTIME_SELECTION_ENV = "CODE_AGENT_KIT_RUNTIME";
-declare function getDefaultRuntime(env?: NodeJS.ProcessEnv): RuntimeName;
+declare function getDefaultRuntime(env?: NodeJS.ProcessEnv, config?: {
+    runtime?: "claude" | "codex" | "copilot" | "gemini" | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    directory?: string | undefined;
+    timeoutMs?: number | undefined;
+}): RuntimeName;
 declare function createCliProgram(): Command;
+declare function runCli(argv?: string[]): Promise<void>;
 
-export { RUNTIME_SELECTION_ENV, createCliProgram, getDefaultRuntime };
+export { RUNTIME_SELECTION_ENV, createCliProgram, getDefaultRuntime, runCli };

package/dist/cli/index.js

@@ -1,13 +1,20 @@
 #!/usr/bin/env node
 import {
+  CLI_CONFIG_KEYS,
   createRuntime,
-  getAvailableRuntimeNames
-} from "../chunk-NKMHTQVX.js";
-import "../chunk-EN5WJJ2G.js";
-import "../chunk-CGK4TBZD.js";
-import "../chunk-AVSJQKCD.js";
-import "../chunk-ZUMYGBXZ.js";
-import "../chunk-YAZLCEAU.js";
+  getAvailableRuntimeNames,
+  getCliConfigPath,
+  isCliConfigKey,
+  isRuntimeName,
+  readCliConfig,
+  setCliConfigValue,
+  unsetCliConfigValue
+} from "../chunk-VPJA6I2O.js";
+import "../chunk-BPQL5GAO.js";
+import "../chunk-UINMTZRO.js";
+import "../chunk-4OVN4G22.js";
+import "../chunk-4LBC5KHN.js";
+import "../chunk-R7CCLWKJ.js";
 
 // src/cli/index.ts
 import { Command, Option } from "commander";
@@ -15,23 +22,68 @@ import { pathToFileURL } from "url";
 var AVAILABLE_RUNTIMES = getAvailableRuntimeNames();
 var RUNTIME_SELECTION_ENV = "CODE_AGENT_KIT_RUNTIME";
 var FALLBACK_RUNTIME = "claude";
-function isRuntimeName(value) {
-  return AVAILABLE_RUNTIMES.includes(value);
-}
-function getDefaultRuntime(env = process.env) {
+function getDefaultRuntime(env = process.env, config = readCliConfig(env)) {
   if (isRuntimeName(env[RUNTIME_SELECTION_ENV])) {
     return env[RUNTIME_SELECTION_ENV];
   }
   if (isRuntimeName(env.DEFAULT_RUNTIME)) {
     return env.DEFAULT_RUNTIME;
   }
+  if (config.runtime) {
+    return config.runtime;
+  }
   return FALLBACK_RUNTIME;
 }
+function parseTimeoutMs(value) {
+  if (value == null) {
+    return void 0;
+  }
+  const timeoutMs = typeof value === "number" ? value : Number.parseInt(value, 10);
+  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    throw new Error(`Invalid timeout value: ${value}`);
+  }
+  return timeoutMs;
+}
+function createConfigCommand() {
+  const config = new Command("config").description(
+    `Manage local CLI config at ${getCliConfigPath()}`
+  );
+  config.command("show").description("Print the current local CLI config").action(() => {
+    console.log(JSON.stringify(readCliConfig(), null, 2));
+  });
+  config.command("path").description("Print the local CLI config path").action(() => {
+    console.log(getCliConfigPath());
+  });
+  config.command("set").description(`Set a config value (${CLI_CONFIG_KEYS.join(", ")})`).argument("<key>", "Config key").argument("<value>", "Config value").action((key, value) => {
+    if (!isCliConfigKey(key)) {
+      throw new Error(
+        `Unknown config key: ${key}. Supported keys: ${CLI_CONFIG_KEYS.join(", ")}`
+      );
+    }
+    const { configPath } = setCliConfigValue(key, value);
+    console.log(`Updated ${key} in ${configPath}`);
+  });
+  config.command("unset").description(`Remove a config value (${CLI_CONFIG_KEYS.join(", ")})`).argument("<key>", "Config key").action((key) => {
+    if (!isCliConfigKey(key)) {
+      throw new Error(
+        `Unknown config key: ${key}. Supported keys: ${CLI_CONFIG_KEYS.join(", ")}`
+      );
+    }
+    const { configPath } = unsetCliConfigValue(key);
+    console.log(`Removed ${key} from ${configPath}`);
+  });
+  return config;
+}
+function buildRuntimeConfig(options, config) {
+  const model = options.model ?? config.model;
+  return model ? { model } : void 0;
+}
 function createCliProgram() {
-  const defaultRuntime = getDefaultRuntime();
-  return new Command().name("code-agent-kit").description("Run a prompt against a supported coding-agent runtime").version("0.1.0").argument("<prompt>", "Task description or prompt for the agent").addOption(
+  const cliConfig = readCliConfig();
+  const defaultRuntime = getDefaultRuntime(process.env, cliConfig);
+  return new Command().name("code-agent-kit").description("Run a prompt against a supported coding-agent runtime").version("0.1.0").showHelpAfterError().addCommand(createConfigCommand()).argument("<prompt>", "Task description or prompt for the agent").addOption(
     new Option("-t, --runtime <name>", "Agent runtime to use").choices(AVAILABLE_RUNTIMES).default(defaultRuntime)
-  ).option("-d, --directory <path>", "Working directory", process.cwd()).option("-r, --resume <sessionId>", "Resume a previous session by ID").option("--timeout <ms>", "Timeout in milliseconds").option("-s, --system <text>", "System prompt text").option(
+  ).option("-m, --model <name>", "Model override for the selected runtime").option("-d, --directory <path>", "Working directory override").option("-r, --resume <sessionId>", "Resume a previous session by ID").option("--timeout <ms>", "Timeout in milliseconds").option("-s, --system <text>", "System prompt text").option(
     "-f, --file <path>",
     "Attach a text file (can be used multiple times)",
     (value, previous) => previous.concat(value),
@@ -41,15 +93,16 @@ function createCliProgram() {
       const runtimeOptionSource = command.getOptionValueSource("runtime");
       const runtime = createRuntime({
         name: opts.runtime,
-        defaultRuntime
+        defaultRuntime,
+        config: buildRuntimeConfig(opts, cliConfig)
       });
       const result = await runtime.run({
-        workingDirectory: opts.directory,
+        workingDirectory: opts.directory ?? cliConfig.directory ?? process.cwd(),
         prompt,
-        systemPrompt: opts.system,
+        systemPrompt: opts.system ?? cliConfig.systemPrompt,
         attachments: opts.file.map((filePath) => ({ path: filePath })),
         env: runtimeOptionSource === "cli" ? { [RUNTIME_SELECTION_ENV]: opts.runtime } : void 0,
-        timeoutMs: opts.timeout ? Number.parseInt(opts.timeout, 10) : void 0,
+        timeoutMs: parseTimeoutMs(opts.timeout ?? cliConfig.timeoutMs),
         session: opts.resume ? { mode: "resume", sessionId: opts.resume } : void 0
       });
       if (result.sessionId) {
@@ -66,10 +119,13 @@ function createCliProgram() {
     }
   );
 }
+async function runCli(argv = process.argv) {
+  await createCliProgram().parseAsync(argv);
+}
 if (process.argv[1]) {
   const entryUrl = pathToFileURL(process.argv[1]).href;
   if (import.meta.url === entryUrl) {
-    createCliProgram().parseAsync().catch((error) => {
+    runCli().catch((error) => {
       const message = error instanceof Error ? error.message : String(error);
       console.error(message);
       process.exit(1);
@@ -79,6 +135,7 @@ if (process.argv[1]) {
 export {
   RUNTIME_SELECTION_ENV,
   createCliProgram,
-  getDefaultRuntime
+  getDefaultRuntime,
+  runCli
 };
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command, Option } from \"commander\";\nimport { pathToFileURL } from \"node:url\";\nimport {\n  createRuntime,\n  getAvailableRuntimeNames,\n  type RuntimeName,\n} from \"../runtimes/registry.js\";\n\nconst AVAILABLE_RUNTIMES = getAvailableRuntimeNames();\nexport const RUNTIME_SELECTION_ENV = \"CODE_AGENT_KIT_RUNTIME\";\nconst FALLBACK_RUNTIME: RuntimeName = \"claude\";\n\nfunction isRuntimeName(value: string | undefined): value is RuntimeName {\n  return AVAILABLE_RUNTIMES.includes(value as RuntimeName);\n}\n\nexport function getDefaultRuntime(\n  env: NodeJS.ProcessEnv = process.env,\n): RuntimeName {\n  if (isRuntimeName(env[RUNTIME_SELECTION_ENV])) {\n    return env[RUNTIME_SELECTION_ENV];\n  }\n\n  if (isRuntimeName(env.DEFAULT_RUNTIME)) {\n    return env.DEFAULT_RUNTIME;\n  }\n\n  return FALLBACK_RUNTIME;\n}\n\nexport function createCliProgram(): Command {\n  const defaultRuntime = getDefaultRuntime();\n\n  return new Command()\n    .name(\"code-agent-kit\")\n    .description(\"Run a prompt against a supported coding-agent runtime\")\n    .version(\"0.1.0\")\n    .argument(\"<prompt>\", \"Task description or prompt for the agent\")\n    .addOption(\n      new Option(\"-t, --runtime <name>\", \"Agent runtime to use\")\n        .choices(AVAILABLE_RUNTIMES)\n        .default(defaultRuntime),\n    )\n    .option(\"-d, --directory <path>\", \"Working directory\", process.cwd())\n    .option(\"-r, --resume <sessionId>\", \"Resume a previous session by ID\")\n    .option(\"--timeout <ms>\", \"Timeout in milliseconds\")\n    .option(\"-s, --system <text>\", \"System prompt text\")\n    .option(\n      \"-f, --file <path>\",\n      \"Attach a text file (can be used multiple times)\",\n      (value: string, previous: string[]) => previous.concat(value),\n      [] as string[],\n    )\n    .action(\n      async (\n        prompt: string,\n        opts: {\n          runtime: RuntimeName;\n          directory: string;\n          resume?: string;\n          timeout?: string;\n          system?: string;\n          file: string[];\n        },\n        command: Command,\n      ) => {\n        const runtimeOptionSource = command.getOptionValueSource(\"runtime\");\n        const runtime = createRuntime({\n          name: opts.runtime,\n          defaultRuntime,\n        });\n\n        const result = await runtime.run({\n          workingDirectory: opts.directory,\n          prompt,\n          systemPrompt: opts.system,\n          attachments: opts.file.map((filePath) => ({ path: filePath })),\n          env:\n            runtimeOptionSource === \"cli\"\n              ? { [RUNTIME_SELECTION_ENV]: opts.runtime }\n              : undefined,\n          timeoutMs: opts.timeout ? Number.parseInt(opts.timeout, 10) : undefined,\n          session: opts.resume\n            ? { mode: \"resume\", sessionId: opts.resume }\n            : undefined,\n        });\n\n        if (result.sessionId) {\n          console.error(`Session ID: ${result.sessionId}`);\n        }\n\n        if (!result.success) {\n          console.error(result.error ?? \"Runtime execution failed.\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (result.output) {\n          console.log(result.output);\n        }\n      },\n    );\n}\n\nif (process.argv[1]) {\n  const entryUrl = pathToFileURL(process.argv[1]).href;\n  if (import.meta.url === entryUrl) {\n    createCliProgram().parseAsync().catch((error: unknown) => {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error(message);\n      process.exit(1);\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAEA,SAAS,SAAS,cAAc;AAChC,SAAS,qBAAqB;AAO9B,IAAM,qBAAqB,yBAAyB;AAC7C,IAAM,wBAAwB;AACrC,IAAM,mBAAgC;AAEtC,SAAS,cAAc,OAAiD;AACtE,SAAO,mBAAmB,SAAS,KAAoB;AACzD;AAEO,SAAS,kBACd,MAAyB,QAAQ,KACpB;AACb,MAAI,cAAc,IAAI,qBAAqB,CAAC,GAAG;AAC7C,WAAO,IAAI,qBAAqB;AAAA,EAClC;AAEA,MAAI,cAAc,IAAI,eAAe,GAAG;AACtC,WAAO,IAAI;AAAA,EACb;AAEA,SAAO;AACT;AAEO,SAAS,mBAA4B;AAC1C,QAAM,iBAAiB,kBAAkB;AAEzC,SAAO,IAAI,QAAQ,EAChB,KAAK,gBAAgB,EACrB,YAAY,uDAAuD,EACnE,QAAQ,OAAO,EACf,SAAS,YAAY,0CAA0C,EAC/D;AAAA,IACC,IAAI,OAAO,wBAAwB,sBAAsB,EACtD,QAAQ,kBAAkB,EAC1B,QAAQ,cAAc;AAAA,EAC3B,EACC,OAAO,0BAA0B,qBAAqB,QAAQ,IAAI,CAAC,EACnE,OAAO,4BAA4B,iCAAiC,EACpE,OAAO,kBAAkB,yBAAyB,EAClD,OAAO,uBAAuB,oBAAoB,EAClD;AAAA,IACC;AAAA,IACA;AAAA,IACA,CAAC,OAAe,aAAuB,SAAS,OAAO,KAAK;AAAA,IAC5D,CAAC;AAAA,EACH,EACC;AAAA,IACC,OACE,QACA,MAQA,YACG;AACH,YAAM,sBAAsB,QAAQ,qBAAqB,SAAS;AAClE,YAAM,UAAU,cAAc;AAAA,QAC5B,MAAM,KAAK;AAAA,QACX;AAAA,MACF,CAAC;AAED,YAAM,SAAS,MAAM,QAAQ,IAAI;AAAA,QAC/B,kBAAkB,KAAK;AAAA,QACvB;AAAA,QACA,cAAc,KAAK;AAAA,QACnB,aAAa,KAAK,KAAK,IAAI,CAAC,cAAc,EAAE,MAAM,SAAS,EAAE;AAAA,QAC7D,KACE,wBAAwB,QACpB,EAAE,CAAC,qBAAqB,GAAG,KAAK,QAAQ,IACxC;AAAA,QACN,WAAW,KAAK,UAAU,OAAO,SAAS,KAAK,SAAS,EAAE,IAAI;AAAA,QAC9D,SAAS,KAAK,SACV,EAAE,MAAM,UAAU,WAAW,KAAK,OAAO,IACzC;AAAA,MACN,CAAC;AAED,UAAI,OAAO,WAAW;AACpB,gBAAQ,MAAM,eAAe,OAAO,SAAS,EAAE;AAAA,MACjD;AAEA,UAAI,CAAC,OAAO,SAAS;AACnB,gBAAQ,MAAM,OAAO,SAAS,2BAA2B;AACzD,gBAAQ,WAAW;AACnB;AAAA,MACF;AAEA,UAAI,OAAO,QAAQ;AACjB,gBAAQ,IAAI,OAAO,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AACJ;AAEA,IAAI,QAAQ,KAAK,CAAC,GAAG;AACnB,QAAM,WAAW,cAAc,QAAQ,KAAK,CAAC,CAAC,EAAE;AAChD,MAAI,YAAY,QAAQ,UAAU;AAChC,qBAAiB,EAAE,WAAW,EAAE,MAAM,CAAC,UAAmB;AACxD,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,cAAQ,MAAM,OAAO;AACrB,cAAQ,KAAK,CAAC;AAAA,IAChB,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { Command, Option } from \"commander\";\nimport { pathToFileURL } from \"node:url\";\nimport {\n  CLI_CONFIG_KEYS,\n  getCliConfigPath,\n  isCliConfigKey,\n  isRuntimeName,\n  readCliConfig,\n  setCliConfigValue,\n  unsetCliConfigValue,\n  type CliConfig,\n} from \"../config.js\";\nimport { createRuntime, getAvailableRuntimeNames, type RuntimeName } from \"../runtimes/registry.js\";\n\nconst AVAILABLE_RUNTIMES = getAvailableRuntimeNames();\nexport const RUNTIME_SELECTION_ENV = \"CODE_AGENT_KIT_RUNTIME\";\nconst FALLBACK_RUNTIME: RuntimeName = \"claude\";\n\ninterface RunCliOptions {\n  runtime: RuntimeName;\n  model?: string;\n  directory?: string;\n  resume?: string;\n  timeout?: string;\n  system?: string;\n  file: string[];\n}\n\nexport function getDefaultRuntime(\n  env: NodeJS.ProcessEnv = process.env,\n  config = readCliConfig(env),\n): RuntimeName {\n  if (isRuntimeName(env[RUNTIME_SELECTION_ENV])) {\n    return env[RUNTIME_SELECTION_ENV];\n  }\n\n  if (isRuntimeName(env.DEFAULT_RUNTIME)) {\n    return env.DEFAULT_RUNTIME;\n  }\n\n  if (config.runtime) {\n    return config.runtime;\n  }\n\n  return FALLBACK_RUNTIME;\n}\n\nfunction parseTimeoutMs(value: number | string | undefined): number | undefined {\n  if (value == null) {\n    return undefined;\n  }\n\n  const timeoutMs =\n    typeof value === \"number\" ? value : Number.parseInt(value, 10);\n\n  if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n    throw new Error(`Invalid timeout value: ${value}`);\n  }\n\n  return timeoutMs;\n}\n\nfunction createConfigCommand(): Command {\n  const config = new Command(\"config\").description(\n    `Manage local CLI config at ${getCliConfigPath()}`,\n  );\n\n  config\n    .command(\"show\")\n    .description(\"Print the current local CLI config\")\n    .action(() => {\n      console.log(JSON.stringify(readCliConfig(), null, 2));\n    });\n\n  config\n    .command(\"path\")\n    .description(\"Print the local CLI config path\")\n    .action(() => {\n      console.log(getCliConfigPath());\n    });\n\n  config\n    .command(\"set\")\n    .description(`Set a config value (${CLI_CONFIG_KEYS.join(\", \")})`)\n    .argument(\"<key>\", \"Config key\")\n    .argument(\"<value>\", \"Config value\")\n    .action((key: string, value: string) => {\n      if (!isCliConfigKey(key)) {\n        throw new Error(\n          `Unknown config key: ${key}. Supported keys: ${CLI_CONFIG_KEYS.join(\", \")}`,\n        );\n      }\n\n      const { configPath } = setCliConfigValue(key, value);\n      console.log(`Updated ${key} in ${configPath}`);\n    });\n\n  config\n    .command(\"unset\")\n    .description(`Remove a config value (${CLI_CONFIG_KEYS.join(\", \")})`)\n    .argument(\"<key>\", \"Config key\")\n    .action((key: string) => {\n      if (!isCliConfigKey(key)) {\n        throw new Error(\n          `Unknown config key: ${key}. Supported keys: ${CLI_CONFIG_KEYS.join(\", \")}`,\n        );\n      }\n\n      const { configPath } = unsetCliConfigValue(key);\n      console.log(`Removed ${key} from ${configPath}`);\n    });\n\n  return config;\n}\n\nfunction buildRuntimeConfig(\n  options: Pick<RunCliOptions, \"model\">,\n  config: CliConfig,\n): { model?: string } | undefined {\n  const model = options.model ?? config.model;\n  return model ? { model } : undefined;\n}\n\nexport function createCliProgram(): Command {\n  const cliConfig = readCliConfig();\n  const defaultRuntime = getDefaultRuntime(process.env, cliConfig);\n\n  return new Command()\n    .name(\"code-agent-kit\")\n    .description(\"Run a prompt against a supported coding-agent runtime\")\n    .version(\"0.1.0\")\n    .showHelpAfterError()\n    .addCommand(createConfigCommand())\n    .argument(\"<prompt>\", \"Task description or prompt for the agent\")\n    .addOption(\n      new Option(\"-t, --runtime <name>\", \"Agent runtime to use\")\n        .choices(AVAILABLE_RUNTIMES)\n        .default(defaultRuntime),\n    )\n    .option(\"-m, --model <name>\", \"Model override for the selected runtime\")\n    .option(\"-d, --directory <path>\", \"Working directory override\")\n    .option(\"-r, --resume <sessionId>\", \"Resume a previous session by ID\")\n    .option(\"--timeout <ms>\", \"Timeout in milliseconds\")\n    .option(\"-s, --system <text>\", \"System prompt text\")\n    .option(\n      \"-f, --file <path>\",\n      \"Attach a text file (can be used multiple times)\",\n      (value: string, previous: string[]) => previous.concat(value),\n      [] as string[],\n    )\n    .action(\n      async (\n        prompt: string,\n        opts: RunCliOptions,\n        command: Command,\n      ) => {\n        const runtimeOptionSource = command.getOptionValueSource(\"runtime\");\n        const runtime = createRuntime({\n          name: opts.runtime,\n          defaultRuntime,\n          config: buildRuntimeConfig(opts, cliConfig),\n        });\n\n        const result = await runtime.run({\n          workingDirectory: opts.directory ?? cliConfig.directory ?? process.cwd(),\n          prompt,\n          systemPrompt: opts.system ?? cliConfig.systemPrompt,\n          attachments: opts.file.map((filePath) => ({ path: filePath })),\n          env:\n            runtimeOptionSource === \"cli\"\n              ? { [RUNTIME_SELECTION_ENV]: opts.runtime }\n              : undefined,\n          timeoutMs: parseTimeoutMs(opts.timeout ?? cliConfig.timeoutMs),\n          session: opts.resume\n            ? { mode: \"resume\", sessionId: opts.resume }\n            : undefined,\n        });\n\n        if (result.sessionId) {\n          console.error(`Session ID: ${result.sessionId}`);\n        }\n\n        if (!result.success) {\n          console.error(result.error ?? \"Runtime execution failed.\");\n          process.exitCode = 1;\n          return;\n        }\n\n        if (result.output) {\n          console.log(result.output);\n        }\n      },\n    );\n}\n\nexport async function runCli(argv = process.argv): Promise<void> {\n  await createCliProgram().parseAsync(argv);\n}\n\nif (process.argv[1]) {\n  const entryUrl = pathToFileURL(process.argv[1]).href;\n  if (import.meta.url === entryUrl) {\n    runCli().catch((error: unknown) => {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error(message);\n      process.exit(1);\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,17 +1,42 @@
-import { b as RuntimeFeature, A as AgentRuntime, c as RuntimeClass, d as RuntimeCapabilities } from './runtime-DxAkSUZk.js';
-export { a as AgentResult, e as RuntimeAttachment, f as RuntimeEvent, R as RuntimeRunOptions, g as RuntimeSession, U as UnsupportedRuntimeFeatureError, h as assertRuntimeRunOptionsSupported, i as assertRuntimeSupports, j as buildRuntimePrompt, k as getRequestedRuntimeFeatures } from './runtime-DxAkSUZk.js';
+export { A as AgentResult, a as AgentRuntime, R as RuntimeAttachment, b as RuntimeCapabilities, c as RuntimeEvent, d as RuntimeFeature, e as RuntimeRunOptions, f as RuntimeSession, U as UnsupportedRuntimeFeatureError, g as assertRuntimeRunOptionsSupported, h as assertRuntimeSupports, i as buildRuntimePrompt, j as getRequestedRuntimeFeatures } from './runtime-Zjyjv8M_.js';
+import { R as RuntimeName } from './registry-DkM8QbUx.js';
+export { a as RUNTIME_NAMES, b as RuntimeConfig, c as RuntimeConfigByName, d as createRuntime, g as getAvailableRuntimeClasses, e as getAvailableRuntimeNames, f as getRuntimeCapabilities } from './registry-DkM8QbUx.js';
+import { z } from 'zod';
+import './runtimes/claude.js';
+import '@anthropic-ai/claude-agent-sdk';
+import './runtimes/codex.js';
+import '@openai/codex-sdk';
+import './runtimes/copilot.js';
+import './runtimes/gemini.js';
 
-type RuntimeName = "claude" | "codex" | "copilot" | "gemini";
-type RegisteredRuntimeClass = RuntimeClass<AgentRuntime> & {
-    readonly runtimeName: RuntimeName;
+declare const CliConfigSchema: z.ZodObject<{
+    runtime: z.ZodOptional<z.ZodEnum<{
+        codex: "codex";
+        claude: "claude";
+        copilot: "copilot";
+        gemini: "gemini";
+    }>>;
+    model: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    directory: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type CliConfig = z.infer<typeof CliConfigSchema>;
+type CliConfigKey = keyof CliConfig;
+declare const CLI_CONFIG_KEYS: readonly ["runtime", "model", "systemPrompt", "directory", "timeoutMs"];
+declare function getCliConfigDir(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+declare function getCliConfigPath(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+declare function readCliConfig(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): CliConfig;
+declare function writeCliConfig(config: CliConfig, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+declare function setCliConfigValue<K extends CliConfigKey>(key: K, value: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): {
+    config: CliConfig;
+    configPath: string;
 };
-declare function getAvailableRuntimeClasses(requiredCapabilities?: readonly RuntimeFeature[]): RegisteredRuntimeClass[];
-declare function getAvailableRuntimeNames(requiredCapabilities?: readonly RuntimeFeature[]): RuntimeName[];
-declare function createRuntime(options?: {
-    name?: string;
-    requiredCapabilities?: readonly RuntimeFeature[];
-    defaultRuntime?: RuntimeName;
-}): AgentRuntime;
-declare function getRuntimeCapabilities(runtime: AgentRuntime): RuntimeCapabilities;
+declare function unsetCliConfigValue<K extends CliConfigKey>(key: K, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): {
+    config: CliConfig;
+    configPath: string;
+};
+declare function isRuntimeName(value: string | undefined): value is RuntimeName;
+declare function isCliConfigKey(value: string): value is CliConfigKey;
 
-export { AgentRuntime, RuntimeCapabilities, RuntimeFeature, type RuntimeName, createRuntime, getAvailableRuntimeClasses, getAvailableRuntimeNames, getRuntimeCapabilities };
+export { CLI_CONFIG_KEYS, type CliConfig, type CliConfigKey, CliConfigSchema, RuntimeName, getCliConfigDir, getCliConfigPath, isCliConfigKey, isRuntimeName, readCliConfig, setCliConfigValue, unsetCliConfigValue, writeCliConfig };

package/dist/index.js

@@ -1,21 +1,35 @@
 import {
+  CLI_CONFIG_KEYS,
+  CliConfigSchema,
+  RUNTIME_NAMES,
   createRuntime,
   getAvailableRuntimeClasses,
   getAvailableRuntimeNames,
-  getRuntimeCapabilities
-} from "./chunk-NKMHTQVX.js";
-import "./chunk-EN5WJJ2G.js";
-import "./chunk-CGK4TBZD.js";
-import "./chunk-AVSJQKCD.js";
-import "./chunk-ZUMYGBXZ.js";
+  getCliConfigDir,
+  getCliConfigPath,
+  getRuntimeCapabilities,
+  isCliConfigKey,
+  isRuntimeName,
+  readCliConfig,
+  setCliConfigValue,
+  unsetCliConfigValue,
+  writeCliConfig
+} from "./chunk-VPJA6I2O.js";
+import "./chunk-BPQL5GAO.js";
+import "./chunk-UINMTZRO.js";
+import "./chunk-4OVN4G22.js";
+import "./chunk-4LBC5KHN.js";
 import {
   UnsupportedRuntimeFeatureError,
   assertRuntimeRunOptionsSupported,
   assertRuntimeSupports,
   buildRuntimePrompt,
   getRequestedRuntimeFeatures
-} from "./chunk-YAZLCEAU.js";
+} from "./chunk-R7CCLWKJ.js";
 export {
+  CLI_CONFIG_KEYS,
+  CliConfigSchema,
+  RUNTIME_NAMES,
   UnsupportedRuntimeFeatureError,
   assertRuntimeRunOptionsSupported,
   assertRuntimeSupports,
@@ -23,7 +37,15 @@ export {
   createRuntime,
   getAvailableRuntimeClasses,
   getAvailableRuntimeNames,
+  getCliConfigDir,
+  getCliConfigPath,
   getRequestedRuntimeFeatures,
-  getRuntimeCapabilities
+  getRuntimeCapabilities,
+  isCliConfigKey,
+  isRuntimeName,
+  readCliConfig,
+  setCliConfigValue,
+  unsetCliConfigValue,
+  writeCliConfig
 };
 //# sourceMappingURL=index.js.map

package/dist/registry-DkM8QbUx.d.ts

@@ -0,0 +1,29 @@
+import { d as RuntimeFeature, a as AgentRuntime, k as RuntimeClass, b as RuntimeCapabilities } from './runtime-Zjyjv8M_.js';
+import { ClaudeRuntimeConfig } from './runtimes/claude.js';
+import { CodexRuntimeConfig } from './runtimes/codex.js';
+import { CopilotRuntimeConfig } from './runtimes/copilot.js';
+import { GeminiRuntimeConfig } from './runtimes/gemini.js';
+
+type RuntimeName = "claude" | "codex" | "copilot" | "gemini";
+declare const RUNTIME_NAMES: readonly ["claude", "codex", "copilot", "gemini"];
+interface RuntimeConfigByName {
+    claude: ClaudeRuntimeConfig;
+    codex: CodexRuntimeConfig;
+    copilot: CopilotRuntimeConfig;
+    gemini: GeminiRuntimeConfig;
+}
+type RuntimeConfig = RuntimeConfigByName[RuntimeName];
+type RegisteredRuntimeClass = RuntimeClass<AgentRuntime> & {
+    readonly runtimeName: RuntimeName;
+};
+declare function getAvailableRuntimeClasses(requiredCapabilities?: readonly RuntimeFeature[]): RegisteredRuntimeClass[];
+declare function getAvailableRuntimeNames(requiredCapabilities?: readonly RuntimeFeature[]): RuntimeName[];
+declare function createRuntime(options?: {
+    name?: string;
+    requiredCapabilities?: readonly RuntimeFeature[];
+    defaultRuntime?: RuntimeName;
+    config?: RuntimeConfig;
+}): AgentRuntime;
+declare function getRuntimeCapabilities(runtime: AgentRuntime): RuntimeCapabilities;
+
+export { type RuntimeName as R, RUNTIME_NAMES as a, type RuntimeConfig as b, type RuntimeConfigByName as c, createRuntime as d, getAvailableRuntimeNames as e, getRuntimeCapabilities as f, getAvailableRuntimeClasses as g };

package/dist/{runtime-DxAkSUZk.d.ts → runtime-Zjyjv8M_.d.ts}

@@ -25,7 +25,7 @@ interface RuntimeCapabilities {
     readonly eventStreaming: boolean;
 }
 interface RuntimeClass<T extends AgentRuntime = AgentRuntime> {
-    new (): T;
+    new (...args: any[]): T;
     readonly runtimeName: string;
     readonly capabilities: RuntimeCapabilities;
 }
@@ -94,4 +94,4 @@ declare function assertRuntimeSupports(runtime: AgentRuntime | RuntimeClass, fea
 declare function assertRuntimeRunOptionsSupported(runtime: AgentRuntime | RuntimeClass, options: Pick<RuntimeRunOptions, "onEvent" | "session">, operation: string): void;
 declare function buildRuntimePrompt(options: Pick<RuntimeRunOptions, "workingDirectory" | "prompt" | "attachments">): Promise<string>;
 
-export { type AgentRuntime as A, type RuntimeRunOptions as R, UnsupportedRuntimeFeatureError as U, type AgentResult as a, type RuntimeFeature as b, type RuntimeClass as c, type RuntimeCapabilities as d, type RuntimeAttachment as e, type RuntimeEvent as f, type RuntimeSession as g, assertRuntimeRunOptionsSupported as h, assertRuntimeSupports as i, buildRuntimePrompt as j, getRequestedRuntimeFeatures as k };
+export { type AgentResult as A, type RuntimeAttachment as R, UnsupportedRuntimeFeatureError as U, type AgentRuntime as a, type RuntimeCapabilities as b, type RuntimeEvent as c, type RuntimeFeature as d, type RuntimeRunOptions as e, type RuntimeSession as f, assertRuntimeRunOptionsSupported as g, assertRuntimeSupports as h, buildRuntimePrompt as i, getRequestedRuntimeFeatures as j, type RuntimeClass as k };

package/dist/runtimes/claude.d.ts

@@ -1,5 +1,5 @@
 import { PermissionMode, SettingSource } from '@anthropic-ai/claude-agent-sdk';
-import { A as AgentRuntime, R as RuntimeRunOptions, a as AgentResult } from '../runtime-DxAkSUZk.js';
+import { a as AgentRuntime, e as RuntimeRunOptions, A as AgentResult } from '../runtime-Zjyjv8M_.js';
 
 interface ClaudeRuntimeConfig {
     /** Claude model to use (e.g., "claude-sonnet-4-20250514"). */

package/dist/runtimes/claude.js

@@ -1,7 +1,7 @@
 import {
   ClaudeRuntime
-} from "../chunk-EN5WJJ2G.js";
-import "../chunk-YAZLCEAU.js";
+} from "../chunk-BPQL5GAO.js";
+import "../chunk-R7CCLWKJ.js";
 export {
   ClaudeRuntime
 };

package/dist/runtimes/codex.d.ts

@@ -1,5 +1,5 @@
 import { SandboxMode, ApprovalMode, WebSearchMode, ModelReasoningEffort, CodexOptions } from '@openai/codex-sdk';
-import { A as AgentRuntime, R as RuntimeRunOptions, a as AgentResult } from '../runtime-DxAkSUZk.js';
+import { a as AgentRuntime, e as RuntimeRunOptions, A as AgentResult } from '../runtime-Zjyjv8M_.js';
 
 interface CodexRuntimeConfig {
     /** Codex model to use. */

package/dist/runtimes/codex.js

@@ -1,7 +1,7 @@
 import {
   CodexRuntime
-} from "../chunk-CGK4TBZD.js";
-import "../chunk-YAZLCEAU.js";
+} from "../chunk-UINMTZRO.js";
+import "../chunk-R7CCLWKJ.js";
 export {
   CodexRuntime
 };

package/dist/runtimes/copilot.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentRuntime, R as RuntimeRunOptions, a as AgentResult } from '../runtime-DxAkSUZk.js';
+import { a as AgentRuntime, e as RuntimeRunOptions, A as AgentResult } from '../runtime-Zjyjv8M_.js';
 
 interface CopilotRuntimeConfig {
     /** Copilot model to use. */

package/dist/runtimes/copilot.js

@@ -1,7 +1,7 @@
 import {
   CopilotRuntime
-} from "../chunk-AVSJQKCD.js";
-import "../chunk-YAZLCEAU.js";
+} from "../chunk-4OVN4G22.js";
+import "../chunk-R7CCLWKJ.js";
 export {
   CopilotRuntime
 };

package/dist/runtimes/gemini.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentRuntime, R as RuntimeRunOptions, a as AgentResult } from '../runtime-DxAkSUZk.js';
+import { a as AgentRuntime, e as RuntimeRunOptions, A as AgentResult } from '../runtime-Zjyjv8M_.js';
 
 interface GeminiRuntimeConfig {
     /** Gemini model to use. */

package/dist/runtimes/gemini.js

@@ -1,7 +1,7 @@
 import {
   GeminiRuntime
-} from "../chunk-ZUMYGBXZ.js";
-import "../chunk-YAZLCEAU.js";
+} from "../chunk-4LBC5KHN.js";
+import "../chunk-R7CCLWKJ.js";
 export {
   GeminiRuntime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimashoghi/code-agent-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Multi-runtime coding agent runtime toolkit",
   "type": "module",
   "repository": {
@@ -58,7 +58,8 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.79",
     "@openai/codex-sdk": "^0.115.0",
-    "commander": "^13.1.0"
+    "commander": "^13.1.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/dist/chunk-NKMHTQVX.js

@@ -1,60 +0,0 @@
-import {
-  ClaudeRuntime
-} from "./chunk-EN5WJJ2G.js";
-import {
-  CodexRuntime
-} from "./chunk-CGK4TBZD.js";
-import {
-  CopilotRuntime
-} from "./chunk-AVSJQKCD.js";
-import {
-  GeminiRuntime
-} from "./chunk-ZUMYGBXZ.js";
-
-// src/runtimes/registry.ts
-var RUNTIME_CLASSES = [
-  ClaudeRuntime,
-  CodexRuntime,
-  CopilotRuntime,
-  GeminiRuntime
-];
-function getAvailableRuntimeClasses(requiredCapabilities = []) {
-  return RUNTIME_CLASSES.filter(
-    (runtimeClass) => requiredCapabilities.every((feature) => runtimeClass.capabilities[feature])
-  );
-}
-function getAvailableRuntimeNames(requiredCapabilities = []) {
-  return getAvailableRuntimeClasses(requiredCapabilities).map(
-    (runtimeClass) => runtimeClass.runtimeName
-  );
-}
-function createRuntime(options) {
-  const requiredCapabilities = options?.requiredCapabilities ?? [];
-  const availableRuntimeClasses = getAvailableRuntimeClasses(requiredCapabilities);
-  if (availableRuntimeClasses.length === 0) {
-    throw new Error(
-      `No runtimes support the required capabilities: ${requiredCapabilities.join(", ")}`
-    );
-  }
-  const targetName = options?.name ?? options?.defaultRuntime ?? availableRuntimeClasses[0].runtimeName;
-  const selectedRuntimeClass = availableRuntimeClasses.find(
-    (runtimeClass) => runtimeClass.runtimeName === targetName
-  );
-  if (!selectedRuntimeClass) {
-    throw new Error(
-      `Unknown or unsupported runtime: ${targetName}. Available runtimes: ${availableRuntimeClasses.map((runtimeClass) => runtimeClass.runtimeName).join(", ")}`
-    );
-  }
-  return new selectedRuntimeClass();
-}
-function getRuntimeCapabilities(runtime) {
-  return runtime.constructor.capabilities;
-}
-
-export {
-  getAvailableRuntimeClasses,
-  getAvailableRuntimeNames,
-  createRuntime,
-  getRuntimeCapabilities
-};
-//# sourceMappingURL=chunk-NKMHTQVX.js.map

package/dist/chunk-NKMHTQVX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtimes/registry.ts"],"sourcesContent":["import type {\n  AgentRuntime,\n  RuntimeCapabilities,\n  RuntimeFeature,\n  RuntimeClass,\n} from \"../runtime.js\";\nimport { ClaudeRuntime } from \"./claude.js\";\nimport { CodexRuntime } from \"./codex.js\";\nimport { CopilotRuntime } from \"./copilot.js\";\nimport { GeminiRuntime } from \"./gemini.js\";\n\nexport type RuntimeName = \"claude\" | \"codex\" | \"copilot\" | \"gemini\";\n\ntype RegisteredRuntimeClass = RuntimeClass<AgentRuntime> & {\n  readonly runtimeName: RuntimeName;\n};\n\nconst RUNTIME_CLASSES = [\n  ClaudeRuntime,\n  CodexRuntime,\n  CopilotRuntime,\n  GeminiRuntime,\n] as const satisfies readonly RegisteredRuntimeClass[];\n\nexport function getAvailableRuntimeClasses(\n  requiredCapabilities: readonly RuntimeFeature[] = [],\n): RegisteredRuntimeClass[] {\n  return RUNTIME_CLASSES.filter((runtimeClass) =>\n    requiredCapabilities.every((feature) => runtimeClass.capabilities[feature]),\n  );\n}\n\nexport function getAvailableRuntimeNames(\n  requiredCapabilities: readonly RuntimeFeature[] = [],\n): RuntimeName[] {\n  return getAvailableRuntimeClasses(requiredCapabilities).map(\n    (runtimeClass) => runtimeClass.runtimeName,\n  );\n}\n\nexport function createRuntime(options?: {\n  name?: string;\n  requiredCapabilities?: readonly RuntimeFeature[];\n  defaultRuntime?: RuntimeName;\n}): AgentRuntime {\n  const requiredCapabilities = options?.requiredCapabilities ?? [];\n  const availableRuntimeClasses =\n    getAvailableRuntimeClasses(requiredCapabilities);\n\n  if (availableRuntimeClasses.length === 0) {\n    throw new Error(\n      `No runtimes support the required capabilities: ${requiredCapabilities.join(\", \")}`,\n    );\n  }\n\n  const targetName =\n    options?.name ??\n    options?.defaultRuntime ??\n    availableRuntimeClasses[0]!.runtimeName;\n  const selectedRuntimeClass = availableRuntimeClasses.find(\n    (runtimeClass) => runtimeClass.runtimeName === targetName,\n  );\n\n  if (!selectedRuntimeClass) {\n    throw new Error(\n      `Unknown or unsupported runtime: ${targetName}. Available runtimes: ${availableRuntimeClasses\n        .map((runtimeClass) => runtimeClass.runtimeName)\n        .join(\", \")}`,\n    );\n  }\n\n  return new selectedRuntimeClass();\n}\n\nexport function getRuntimeCapabilities(\n  runtime: AgentRuntime,\n): RuntimeCapabilities {\n  return (runtime.constructor as RuntimeClass).capabilities;\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,IAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,2BACd,uBAAkD,CAAC,GACzB;AAC1B,SAAO,gBAAgB;AAAA,IAAO,CAAC,iBAC7B,qBAAqB,MAAM,CAAC,YAAY,aAAa,aAAa,OAAO,CAAC;AAAA,EAC5E;AACF;AAEO,SAAS,yBACd,uBAAkD,CAAC,GACpC;AACf,SAAO,2BAA2B,oBAAoB,EAAE;AAAA,IACtD,CAAC,iBAAiB,aAAa;AAAA,EACjC;AACF;AAEO,SAAS,cAAc,SAIb;AACf,QAAM,uBAAuB,SAAS,wBAAwB,CAAC;AAC/D,QAAM,0BACJ,2BAA2B,oBAAoB;AAEjD,MAAI,wBAAwB,WAAW,GAAG;AACxC,UAAM,IAAI;AAAA,MACR,kDAAkD,qBAAqB,KAAK,IAAI,CAAC;AAAA,IACnF;AAAA,EACF;AAEA,QAAM,aACJ,SAAS,QACT,SAAS,kBACT,wBAAwB,CAAC,EAAG;AAC9B,QAAM,uBAAuB,wBAAwB;AAAA,IACnD,CAAC,iBAAiB,aAAa,gBAAgB;AAAA,EACjD;AAEA,MAAI,CAAC,sBAAsB;AACzB,UAAM,IAAI;AAAA,MACR,mCAAmC,UAAU,yBAAyB,wBACnE,IAAI,CAAC,iBAAiB,aAAa,WAAW,EAC9C,KAAK,IAAI,CAAC;AAAA,IACf;AAAA,EACF;AAEA,SAAO,IAAI,qBAAqB;AAClC;AAEO,SAAS,uBACd,SACqB;AACrB,SAAQ,QAAQ,YAA6B;AAC/C;","names":[]}

package/dist/chunk-YAZLCEAU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/runtime.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Core runtime abstractions for running a coding agent on a task. */\n\n/** Event emitted during agent execution for real-time progress streaming. */\nexport type RuntimeEvent =\n  | { type: \"text\"; content: string }\n  | { type: \"tool_use\"; tool: string; input?: unknown }\n  | { type: \"tool_result\"; tool: string; output?: string; isError?: boolean }\n  | { type: \"thinking\"; content: string }\n  | { type: \"error\"; message: string };\n\nexport type RuntimeFeature =\n  | \"resumeSession\"\n  | \"eventStreaming\";\n\nexport interface RuntimeCapabilities {\n  readonly resumeSession: boolean;\n  readonly eventStreaming: boolean;\n}\n\nexport interface RuntimeClass<T extends AgentRuntime = AgentRuntime> {\n  new (): T;\n  readonly runtimeName: string;\n  readonly capabilities: RuntimeCapabilities;\n}\n\nexport type RuntimeSession =\n  | { mode: \"new\" }\n  | { mode: \"resume\"; sessionId: string };\n\n/** Options passed to AgentRuntime.run(). */\nexport interface RuntimeRunOptions {\n  /** Directory the agent operates in. */\n  workingDirectory: string;\n\n  /** The task/instructions for the agent. */\n  prompt: string;\n\n  /** Optional system prompt text for the run. */\n  systemPrompt?: string;\n\n  /** Optional text file attachments included alongside the prompt. */\n  attachments?: RuntimeAttachment[];\n\n  /** Environment variables injected into the agent process. */\n  env?: Record<string, string>;\n\n  /** Session behavior for the run. */\n  session?: RuntimeSession;\n\n  /** Timeout in milliseconds. */\n  timeoutMs?: number;\n\n  /** Abort signal for cancellation. */\n  signal?: AbortSignal;\n\n  /** Optional streaming callback for real-time progress. */\n  onEvent?: (event: RuntimeEvent) => void;\n}\n\n/** Result returned by AgentRuntime.run(). */\nexport interface AgentResult {\n  success: boolean;\n  output: string;\n  error?: string;\n  sessionId?: string;\n}\n\nexport interface RuntimeAttachment {\n  /** File path to attach. Relative paths resolve from workingDirectory. */\n  path: string;\n\n  /** Optional inline content. When omitted, the file is read from disk. */\n  content?: string;\n}\n\nfunction featureDescription(feature: RuntimeFeature): string {\n  switch (feature) {\n    case \"resumeSession\":\n      return \"session resume\";\n    case \"eventStreaming\":\n      return \"event streaming\";\n  }\n}\n\nexport class UnsupportedRuntimeFeatureError extends Error {\n  readonly runtime: string;\n  readonly feature: RuntimeFeature;\n  readonly operation: string;\n  readonly details?: string;\n\n  constructor(options: {\n    runtime: string;\n    feature: RuntimeFeature;\n    operation: string;\n    details?: string;\n  }) {\n    const message = [\n      `Runtime \"${options.runtime}\" does not support ${featureDescription(options.feature)} for ${options.operation}.`,\n      options.details,\n    ]\n      .filter(Boolean)\n      .join(\" \");\n\n    super(message);\n    this.name = \"UnsupportedRuntimeFeatureError\";\n    this.runtime = options.runtime;\n    this.feature = options.feature;\n    this.operation = options.operation;\n    this.details = options.details;\n  }\n}\n\nfunction supportsFeature(\n  capabilities: RuntimeCapabilities,\n  feature: RuntimeFeature,\n): boolean {\n  switch (feature) {\n    case \"resumeSession\":\n      return capabilities.resumeSession;\n    case \"eventStreaming\":\n      return capabilities.eventStreaming;\n  }\n}\n\nexport function getRequestedRuntimeFeatures(\n  options: Pick<RuntimeRunOptions, \"onEvent\" | \"session\">,\n): RuntimeFeature[] {\n  const features: RuntimeFeature[] = [];\n\n  if (options.onEvent) {\n    features.push(\"eventStreaming\");\n  }\n\n  if (options.session?.mode === \"resume\") {\n    features.push(\"resumeSession\");\n  }\n\n  return features;\n}\n\n/** The core abstraction: run a coding agent on a task. */\nexport interface AgentRuntime {\n  readonly name: string;\n\n  /** Run the agent on a prompt in a directory, return when done. */\n  run(options: RuntimeRunOptions): Promise<AgentResult>;\n\n  /** Optional cleanup. */\n  dispose?(): Promise<void>;\n}\n\nfunction getRuntimeCapabilities(\n  runtime: AgentRuntime | RuntimeClass,\n): RuntimeCapabilities {\n  if (typeof runtime === \"function\") {\n    return runtime.capabilities;\n  }\n\n  const runtimeClass = runtime.constructor as RuntimeClass;\n  if (!runtimeClass.capabilities) {\n    throw new Error(\n      `Runtime \"${runtime.name}\" is missing static capabilities metadata on its constructor.`,\n    );\n  }\n\n  return runtimeClass.capabilities;\n}\n\nfunction getRuntimeDisplayName(runtime: AgentRuntime | RuntimeClass): string {\n  if (typeof runtime === \"function\") {\n    return runtime.runtimeName;\n  }\n\n  const runtimeClass = runtime.constructor as RuntimeClass;\n  return runtimeClass.runtimeName ?? runtime.name;\n}\n\nexport function assertRuntimeSupports(\n  runtime: AgentRuntime | RuntimeClass,\n  features: readonly RuntimeFeature[],\n  operation: string,\n): void {\n  const capabilities = getRuntimeCapabilities(runtime);\n  const runtimeName = getRuntimeDisplayName(runtime);\n\n  for (const feature of features) {\n    if (supportsFeature(capabilities, feature)) {\n      continue;\n    }\n\n    throw new UnsupportedRuntimeFeatureError({\n      runtime: runtimeName,\n      feature,\n      operation,\n    });\n  }\n}\n\nexport function assertRuntimeRunOptionsSupported(\n  runtime: AgentRuntime | RuntimeClass,\n  options: Pick<RuntimeRunOptions, \"onEvent\" | \"session\">,\n  operation: string,\n): void {\n  assertRuntimeSupports(\n    runtime,\n    getRequestedRuntimeFeatures(options),\n    operation,\n  );\n}\n\nexport async function buildRuntimePrompt(\n  options: Pick<RuntimeRunOptions, \"workingDirectory\" | \"prompt\" | \"attachments\">,\n): Promise<string> {\n  const attachments = await Promise.all(\n    (options.attachments ?? []).map(async (attachment) => {\n      const content =\n        attachment.content ??\n        (await fs.readFile(\n          path.resolve(options.workingDirectory, attachment.path),\n          \"utf8\",\n        ));\n\n      return {\n        path: attachment.path,\n        content,\n      };\n    }),\n  );\n\n  if (attachments.length === 0) {\n    return options.prompt;\n  }\n\n  const attachmentText = attachments\n    .map(\n      (attachment) =>\n        [\n          `Attached file: ${attachment.path}`,\n          \"```\",\n          attachment.content,\n          \"```\",\n        ].join(\"\\n\"),\n    )\n    .join(\"\\n\\n\");\n\n  return [attachmentText, `Task:\\n${options.prompt}`].join(\"\\n\\n\");\n}\n"],"mappings":"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","names":[]}