@nimashoghi/code-agent-kit 0.1.0

package/dist/chunk-YAZLCEAU.js

@@ -0,0 +1,123 @@
+// src/runtime.ts
+import fs from "fs/promises";
+import path from "path";
+function featureDescription(feature) {
+  switch (feature) {
+    case "resumeSession":
+      return "session resume";
+    case "eventStreaming":
+      return "event streaming";
+  }
+}
+var UnsupportedRuntimeFeatureError = class extends Error {
+  runtime;
+  feature;
+  operation;
+  details;
+  constructor(options) {
+    const message = [
+      `Runtime "${options.runtime}" does not support ${featureDescription(options.feature)} for ${options.operation}.`,
+      options.details
+    ].filter(Boolean).join(" ");
+    super(message);
+    this.name = "UnsupportedRuntimeFeatureError";
+    this.runtime = options.runtime;
+    this.feature = options.feature;
+    this.operation = options.operation;
+    this.details = options.details;
+  }
+};
+function supportsFeature(capabilities, feature) {
+  switch (feature) {
+    case "resumeSession":
+      return capabilities.resumeSession;
+    case "eventStreaming":
+      return capabilities.eventStreaming;
+  }
+}
+function getRequestedRuntimeFeatures(options) {
+  const features = [];
+  if (options.onEvent) {
+    features.push("eventStreaming");
+  }
+  if (options.session?.mode === "resume") {
+    features.push("resumeSession");
+  }
+  return features;
+}
+function getRuntimeCapabilities(runtime) {
+  if (typeof runtime === "function") {
+    return runtime.capabilities;
+  }
+  const runtimeClass = runtime.constructor;
+  if (!runtimeClass.capabilities) {
+    throw new Error(
+      `Runtime "${runtime.name}" is missing static capabilities metadata on its constructor.`
+    );
+  }
+  return runtimeClass.capabilities;
+}
+function getRuntimeDisplayName(runtime) {
+  if (typeof runtime === "function") {
+    return runtime.runtimeName;
+  }
+  const runtimeClass = runtime.constructor;
+  return runtimeClass.runtimeName ?? runtime.name;
+}
+function assertRuntimeSupports(runtime, features, operation) {
+  const capabilities = getRuntimeCapabilities(runtime);
+  const runtimeName = getRuntimeDisplayName(runtime);
+  for (const feature of features) {
+    if (supportsFeature(capabilities, feature)) {
+      continue;
+    }
+    throw new UnsupportedRuntimeFeatureError({
+      runtime: runtimeName,
+      feature,
+      operation
+    });
+  }
+}
+function assertRuntimeRunOptionsSupported(runtime, options, operation) {
+  assertRuntimeSupports(
+    runtime,
+    getRequestedRuntimeFeatures(options),
+    operation
+  );
+}
+async function buildRuntimePrompt(options) {
+  const attachments = await Promise.all(
+    (options.attachments ?? []).map(async (attachment) => {
+      const content = attachment.content ?? await fs.readFile(
+        path.resolve(options.workingDirectory, attachment.path),
+        "utf8"
+      );
+      return {
+        path: attachment.path,
+        content
+      };
+    })
+  );
+  if (attachments.length === 0) {
+    return options.prompt;
+  }
+  const attachmentText = attachments.map(
+    (attachment) => [
+      `Attached file: ${attachment.path}`,
+      "```",
+      attachment.content,
+      "```"
+    ].join("\n")
+  ).join("\n\n");
+  return [attachmentText, `Task:
+${options.prompt}`].join("\n\n");
+}
+
+export {
+  UnsupportedRuntimeFeatureError,
+  getRequestedRuntimeFeatures,
+  assertRuntimeSupports,
+  assertRuntimeRunOptionsSupported,
+  buildRuntimePrompt
+};
+//# sourceMappingURL=chunk-YAZLCEAU.js.map

package/dist/chunk-YAZLCEAU.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 (): 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":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AA6EjB,SAAS,mBAAmB,SAAiC;AAC3D,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;AAEO,IAAM,iCAAN,cAA6C,MAAM;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,SAKT;AACD,UAAM,UAAU;AAAA,MACd,YAAY,QAAQ,OAAO,sBAAsB,mBAAmB,QAAQ,OAAO,CAAC,QAAQ,QAAQ,SAAS;AAAA,MAC7G,QAAQ;AAAA,IACV,EACG,OAAO,OAAO,EACd,KAAK,GAAG;AAEX,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,UAAU,QAAQ;AACvB,SAAK,UAAU,QAAQ;AACvB,SAAK,YAAY,QAAQ;AACzB,SAAK,UAAU,QAAQ;AAAA,EACzB;AACF;AAEA,SAAS,gBACP,cACA,SACS;AACT,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO,aAAa;AAAA,IACtB,KAAK;AACH,aAAO,aAAa;AAAA,EACxB;AACF;AAEO,SAAS,4BACd,SACkB;AAClB,QAAM,WAA6B,CAAC;AAEpC,MAAI,QAAQ,SAAS;AACnB,aAAS,KAAK,gBAAgB;AAAA,EAChC;AAEA,MAAI,QAAQ,SAAS,SAAS,UAAU;AACtC,aAAS,KAAK,eAAe;AAAA,EAC/B;AAEA,SAAO;AACT;AAaA,SAAS,uBACP,SACqB;AACrB,MAAI,OAAO,YAAY,YAAY;AACjC,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,eAAe,QAAQ;AAC7B,MAAI,CAAC,aAAa,cAAc;AAC9B,UAAM,IAAI;AAAA,MACR,YAAY,QAAQ,IAAI;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,aAAa;AACtB;AAEA,SAAS,sBAAsB,SAA8C;AAC3E,MAAI,OAAO,YAAY,YAAY;AACjC,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,eAAe,QAAQ;AAC7B,SAAO,aAAa,eAAe,QAAQ;AAC7C;AAEO,SAAS,sBACd,SACA,UACA,WACM;AACN,QAAM,eAAe,uBAAuB,OAAO;AACnD,QAAM,cAAc,sBAAsB,OAAO;AAEjD,aAAW,WAAW,UAAU;AAC9B,QAAI,gBAAgB,cAAc,OAAO,GAAG;AAC1C;AAAA,IACF;AAEA,UAAM,IAAI,+BAA+B;AAAA,MACvC,SAAS;AAAA,MACT;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEO,SAAS,iCACd,SACA,SACA,WACM;AACN;AAAA,IACE;AAAA,IACA,4BAA4B,OAAO;AAAA,IACnC;AAAA,EACF;AACF;AAEA,eAAsB,mBACpB,SACiB;AACjB,QAAM,cAAc,MAAM,QAAQ;AAAA,KAC/B,QAAQ,eAAe,CAAC,GAAG,IAAI,OAAO,eAAe;AACpD,YAAM,UACJ,WAAW,WACV,MAAM,GAAG;AAAA,QACR,KAAK,QAAQ,QAAQ,kBAAkB,WAAW,IAAI;AAAA,QACtD;AAAA,MACF;AAEF,aAAO;AAAA,QACL,MAAM,WAAW;AAAA,QACjB;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAEA,MAAI,YAAY,WAAW,GAAG;AAC5B,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,iBAAiB,YACpB;AAAA,IACC,CAAC,eACC;AAAA,MACE,kBAAkB,WAAW,IAAI;AAAA,MACjC;AAAA,MACA,WAAW;AAAA,MACX;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACf,EACC,KAAK,MAAM;AAEd,SAAO,CAAC,gBAAgB;AAAA,EAAU,QAAQ,MAAM,EAAE,EAAE,KAAK,MAAM;AACjE;","names":[]}

package/dist/chunk-ZUMYGBXZ.js

@@ -0,0 +1,228 @@
+import {
+  assertRuntimeRunOptionsSupported,
+  buildRuntimePrompt
+} from "./chunk-YAZLCEAU.js";
+
+// src/runtimes/gemini.ts
+import { execFile, spawn } from "child_process";
+import { createInterface } from "readline";
+var GeminiRuntime = class _GeminiRuntime {
+  static runtimeName = "gemini";
+  static capabilities = {
+    resumeSession: true,
+    eventStreaming: true
+  };
+  name = _GeminiRuntime.runtimeName;
+  config;
+  constructor(config) {
+    this.config = config ?? {};
+  }
+  async run(options) {
+    assertRuntimeRunOptionsSupported(_GeminiRuntime, options, "runtime.run");
+    const prompt = applySystemPrompt(
+      await buildRuntimePrompt(options),
+      options.systemPrompt
+    );
+    if (options.onEvent) {
+      return this.runStreamed(prompt, options);
+    }
+    return this.runBuffered(prompt, options);
+  }
+  async runBuffered(prompt, options) {
+    const args = this.buildArgs(prompt, options, "json");
+    try {
+      const stdout = await execGemini(args, {
+        cwd: options.workingDirectory,
+        env: buildGeminiEnv(process.env, options.env),
+        timeoutMs: options.timeoutMs,
+        signal: options.signal
+      });
+      const result = JSON.parse(stdout);
+      return {
+        success: true,
+        output: result.response,
+        sessionId: result.session_id
+      };
+    } catch (error) {
+      return {
+        success: false,
+        output: "",
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  async runStreamed(prompt, options) {
+    const args = this.buildArgs(prompt, options, "stream-json");
+    const child = spawn("gemini", args, {
+      cwd: options.workingDirectory,
+      env: buildGeminiEnv(process.env, options.env),
+      signal: options.signal
+    });
+    const stderrChunks = [];
+    child.stderr?.on("data", (chunk) => {
+      stderrChunks.push(String(chunk));
+    });
+    let timeoutId;
+    if (options.timeoutMs) {
+      timeoutId = setTimeout(() => child.kill(), options.timeoutMs);
+    }
+    try {
+      if (!child.stdout) {
+        throw new Error("Gemini process did not provide stdout");
+      }
+      const exitCodePromise = new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("close", (code) => resolve(code));
+      });
+      const lines = createInterface({
+        input: child.stdout,
+        crlfDelay: Infinity
+      });
+      let sessionId;
+      let output = "";
+      let hasDeltaOutput = false;
+      let reportedError;
+      for await (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+          continue;
+        }
+        const event = JSON.parse(trimmed);
+        if (isGeminiInitEvent(event)) {
+          sessionId = event.session_id;
+          continue;
+        }
+        if (isGeminiMessageEvent(event)) {
+          if (event.role !== "assistant") {
+            continue;
+          }
+          if (event.delta) {
+            hasDeltaOutput = true;
+            output += event.content;
+            options.onEvent?.({ type: "text", content: event.content });
+            continue;
+          }
+          if (!hasDeltaOutput) {
+            output = event.content;
+            options.onEvent?.({ type: "text", content: event.content });
+          } else if (!output) {
+            output = event.content;
+          }
+          continue;
+        }
+        if (isGeminiResultEvent(event) && event.status !== "success") {
+          reportedError = event.message ?? `Gemini run failed with status: ${event.status}`;
+          options.onEvent?.({ type: "error", message: reportedError });
+        }
+      }
+      const exitCode = await exitCodePromise;
+      if (exitCode !== 0) {
+        const stderr = stderrChunks.join("").trim();
+        const suffix = stderr ? `: ${stderr}` : "";
+        return {
+          success: false,
+          output: "",
+          error: `Gemini exited with code ${exitCode}${suffix}`
+        };
+      }
+      if (reportedError) {
+        return { success: false, output, error: reportedError, sessionId };
+      }
+      return { success: true, output, sessionId };
+    } catch (error) {
+      return {
+        success: false,
+        output: "",
+        error: error instanceof Error ? error.message : String(error)
+      };
+    } finally {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+    }
+  }
+  buildArgs(prompt, options, outputFormat) {
+    const args = ["-p", prompt, "-o", outputFormat];
+    if (this.config.model) {
+      args.push("--model", this.config.model);
+    }
+    if (this.config.sandbox !== void 0) {
+      args.push(`--sandbox=${this.config.sandbox ? "true" : "false"}`);
+    }
+    if (this.config.approvalMode) {
+      args.push("--approval-mode", this.config.approvalMode);
+    }
+    for (const policy of this.config.policy ?? []) {
+      args.push("--policy", policy);
+    }
+    for (const extension of this.config.extensions ?? []) {
+      args.push("--extensions", extension);
+    }
+    for (const directory of this.config.includeDirectories ?? []) {
+      args.push("--include-directories", directory);
+    }
+    if (options.session?.mode === "resume") {
+      args.push("--resume", options.session.sessionId);
+    }
+    return args;
+  }
+};
+function applySystemPrompt(prompt, systemPrompt) {
+  if (!systemPrompt) {
+    return prompt;
+  }
+  return [`System instructions:
+${systemPrompt}`, prompt].join("\n\n");
+}
+function isGeminiInitEvent(event) {
+  return isRecord(event) && event.type === "init" && typeof event.session_id === "string";
+}
+function isGeminiMessageEvent(event) {
+  return isRecord(event) && event.type === "message" && (event.role === "user" || event.role === "assistant") && typeof event.content === "string" && (event.delta === void 0 || typeof event.delta === "boolean");
+}
+function isGeminiResultEvent(event) {
+  return isRecord(event) && event.type === "result" && typeof event.status === "string" && (event.message === void 0 || typeof event.message === "string");
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function buildGeminiEnv(...sources) {
+  const env = {};
+  for (const source of sources) {
+    if (!source) {
+      continue;
+    }
+    for (const [key, value] of Object.entries(source)) {
+      if (value !== void 0) {
+        env[key] = value;
+      }
+    }
+  }
+  return env;
+}
+function execGemini(args, options) {
+  return new Promise((resolve, reject) => {
+    execFile(
+      "gemini",
+      args,
+      {
+        cwd: options.cwd,
+        env: options.env,
+        timeout: options.timeoutMs,
+        signal: options.signal
+      },
+      (error, stdout, stderr) => {
+        if (error) {
+          reject(new Error(stderr.trim() || error.message));
+          return;
+        }
+        resolve(stdout.trim());
+      }
+    );
+  });
+}
+
+export {
+  GeminiRuntime
+};
+//# sourceMappingURL=chunk-ZUMYGBXZ.js.map

package/dist/chunk-ZUMYGBXZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtimes/gemini.ts"],"sourcesContent":["import { execFile, spawn } from \"node:child_process\";\nimport { createInterface } from \"node:readline\";\nimport {\n  assertRuntimeRunOptionsSupported,\n  type AgentRuntime,\n  type AgentResult,\n  buildRuntimePrompt,\n  type RuntimeRunOptions,\n} from \"../runtime.js\";\n\nexport interface GeminiRuntimeConfig {\n  /** Gemini model to use. */\n  model?: string;\n  /** Whether to enable sandbox mode. */\n  sandbox?: boolean;\n  /** Gemini approval mode. */\n  approvalMode?: \"default\" | \"auto_edit\" | \"yolo\" | \"plan\";\n  /** Additional policy files or directories to load. */\n  policy?: string[];\n  /** Limit Gemini to the specified extensions. */\n  extensions?: string[];\n  /** Additional directories to include in the workspace. */\n  includeDirectories?: string[];\n}\n\ninterface GeminiJsonResult {\n  session_id: string;\n  response: string;\n}\n\ninterface GeminiInitEvent {\n  type: \"init\";\n  session_id: string;\n}\n\ninterface GeminiMessageEvent {\n  type: \"message\";\n  role: \"user\" | \"assistant\";\n  content: string;\n  delta?: boolean;\n}\n\ninterface GeminiResultEvent {\n  type: \"result\";\n  status: string;\n  message?: string;\n}\n\nexport class GeminiRuntime implements AgentRuntime {\n  static readonly runtimeName = \"gemini\";\n  static readonly capabilities = {\n    resumeSession: true,\n    eventStreaming: true,\n  } as const;\n  readonly name = GeminiRuntime.runtimeName;\n  private readonly config: GeminiRuntimeConfig;\n\n  constructor(config?: GeminiRuntimeConfig) {\n    this.config = config ?? {};\n  }\n\n  async run(options: RuntimeRunOptions): Promise<AgentResult> {\n    assertRuntimeRunOptionsSupported(GeminiRuntime, options, \"runtime.run\");\n    const prompt = applySystemPrompt(\n      await buildRuntimePrompt(options),\n      options.systemPrompt,\n    );\n\n    if (options.onEvent) {\n      return this.runStreamed(prompt, options);\n    }\n\n    return this.runBuffered(prompt, options);\n  }\n\n  private async runBuffered(\n    prompt: string,\n    options: RuntimeRunOptions,\n  ): Promise<AgentResult> {\n    const args = this.buildArgs(prompt, options, \"json\");\n\n    try {\n      const stdout = await execGemini(args, {\n        cwd: options.workingDirectory,\n        env: buildGeminiEnv(process.env, options.env),\n        timeoutMs: options.timeoutMs,\n        signal: options.signal,\n      });\n      const result = JSON.parse(stdout) as GeminiJsonResult;\n\n      return {\n        success: true,\n        output: result.response,\n        sessionId: result.session_id,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        output: \"\",\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  private async runStreamed(\n    prompt: string,\n    options: RuntimeRunOptions,\n  ): Promise<AgentResult> {\n    const args = this.buildArgs(prompt, options, \"stream-json\");\n    const child = spawn(\"gemini\", args, {\n      cwd: options.workingDirectory,\n      env: buildGeminiEnv(process.env, options.env),\n      signal: options.signal,\n    });\n\n    const stderrChunks: string[] = [];\n    child.stderr?.on(\"data\", (chunk: Buffer | string) => {\n      stderrChunks.push(String(chunk));\n    });\n\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\n    if (options.timeoutMs) {\n      timeoutId = setTimeout(() => child.kill(), options.timeoutMs);\n    }\n\n    try {\n      if (!child.stdout) {\n        throw new Error(\"Gemini process did not provide stdout\");\n      }\n\n      const exitCodePromise = new Promise<number | null>((resolve, reject) => {\n        child.once(\"error\", reject);\n        child.once(\"close\", (code) => resolve(code));\n      });\n\n      const lines = createInterface({\n        input: child.stdout,\n        crlfDelay: Infinity,\n      });\n      let sessionId: string | undefined;\n      let output = \"\";\n      let hasDeltaOutput = false;\n      let reportedError: string | undefined;\n\n      for await (const line of lines) {\n        const trimmed = line.trim();\n        if (!trimmed) {\n          continue;\n        }\n\n        const event = JSON.parse(trimmed) as unknown;\n\n        if (isGeminiInitEvent(event)) {\n          sessionId = event.session_id;\n          continue;\n        }\n\n        if (isGeminiMessageEvent(event)) {\n          if (event.role !== \"assistant\") {\n            continue;\n          }\n\n          if (event.delta) {\n            hasDeltaOutput = true;\n            output += event.content;\n            options.onEvent?.({ type: \"text\", content: event.content });\n            continue;\n          }\n\n          if (!hasDeltaOutput) {\n            output = event.content;\n            options.onEvent?.({ type: \"text\", content: event.content });\n          } else if (!output) {\n            output = event.content;\n          }\n          continue;\n        }\n\n        if (isGeminiResultEvent(event) && event.status !== \"success\") {\n          reportedError =\n            event.message ?? `Gemini run failed with status: ${event.status}`;\n          options.onEvent?.({ type: \"error\", message: reportedError });\n        }\n      }\n\n      const exitCode = await exitCodePromise;\n\n      if (exitCode !== 0) {\n        const stderr = stderrChunks.join(\"\").trim();\n        const suffix = stderr ? `: ${stderr}` : \"\";\n        return {\n          success: false,\n          output: \"\",\n          error: `Gemini exited with code ${exitCode}${suffix}`,\n        };\n      }\n\n      if (reportedError) {\n        return { success: false, output, error: reportedError, sessionId };\n      }\n\n      return { success: true, output, sessionId };\n    } catch (error) {\n      return {\n        success: false,\n        output: \"\",\n        error: error instanceof Error ? error.message : String(error),\n      };\n    } finally {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n    }\n  }\n\n  private buildArgs(\n    prompt: string,\n    options: RuntimeRunOptions,\n    outputFormat: \"json\" | \"stream-json\",\n  ): string[] {\n    const args = [\"-p\", prompt, \"-o\", outputFormat];\n\n    if (this.config.model) {\n      args.push(\"--model\", this.config.model);\n    }\n\n    if (this.config.sandbox !== undefined) {\n      args.push(`--sandbox=${this.config.sandbox ? \"true\" : \"false\"}`);\n    }\n\n    if (this.config.approvalMode) {\n      args.push(\"--approval-mode\", this.config.approvalMode);\n    }\n\n    for (const policy of this.config.policy ?? []) {\n      args.push(\"--policy\", policy);\n    }\n\n    for (const extension of this.config.extensions ?? []) {\n      args.push(\"--extensions\", extension);\n    }\n\n    for (const directory of this.config.includeDirectories ?? []) {\n      args.push(\"--include-directories\", directory);\n    }\n\n    if (options.session?.mode === \"resume\") {\n      args.push(\"--resume\", options.session.sessionId);\n    }\n\n    return args;\n  }\n}\n\nfunction applySystemPrompt(prompt: string, systemPrompt?: string): string {\n  if (!systemPrompt) {\n    return prompt;\n  }\n\n  return [`System instructions:\\n${systemPrompt}`, prompt].join(\"\\n\\n\");\n}\n\nfunction isGeminiInitEvent(event: unknown): event is GeminiInitEvent {\n  return (\n    isRecord(event) &&\n    event.type === \"init\" &&\n    typeof event.session_id === \"string\"\n  );\n}\n\nfunction isGeminiMessageEvent(event: unknown): event is GeminiMessageEvent {\n  return (\n    isRecord(event) &&\n    event.type === \"message\" &&\n    (event.role === \"user\" || event.role === \"assistant\") &&\n    typeof event.content === \"string\" &&\n    (event.delta === undefined || typeof event.delta === \"boolean\")\n  );\n}\n\nfunction isGeminiResultEvent(event: unknown): event is GeminiResultEvent {\n  return (\n    isRecord(event) &&\n    event.type === \"result\" &&\n    typeof event.status === \"string\" &&\n    (event.message === undefined || typeof event.message === \"string\")\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction buildGeminiEnv(\n  ...sources: (Record<string, string> | NodeJS.ProcessEnv | undefined)[]\n): Record<string, string> {\n  const env: Record<string, string> = {};\n\n  for (const source of sources) {\n    if (!source) {\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(source)) {\n      if (value !== undefined) {\n        env[key] = value;\n      }\n    }\n  }\n\n  return env;\n}\n\nfunction execGemini(\n  args: string[],\n  options: {\n    cwd: string;\n    env: Record<string, string>;\n    timeoutMs?: number;\n    signal?: AbortSignal;\n  },\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    execFile(\n      \"gemini\",\n      args,\n      {\n        cwd: options.cwd,\n        env: options.env,\n        timeout: options.timeoutMs,\n        signal: options.signal,\n      },\n      (error, stdout, stderr) => {\n        if (error) {\n          reject(new Error(stderr.trim() || error.message));\n          return;\n        }\n\n        resolve(stdout.trim());\n      },\n    );\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/cli/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { RuntimeName } from '../index.js';
+import '../runtime-DxAkSUZk.js';
+
+declare const RUNTIME_SELECTION_ENV = "CODE_AGENT_KIT_RUNTIME";
+declare function getDefaultRuntime(env?: NodeJS.ProcessEnv): RuntimeName;
+declare function createCliProgram(): Command;
+
+export { RUNTIME_SELECTION_ENV, createCliProgram, getDefaultRuntime };

package/dist/cli/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import {
+  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";
+
+// src/cli/index.ts
+import { Command, Option } from "commander";
+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) {
+  if (isRuntimeName(env[RUNTIME_SELECTION_ENV])) {
+    return env[RUNTIME_SELECTION_ENV];
+  }
+  if (isRuntimeName(env.DEFAULT_RUNTIME)) {
+    return env.DEFAULT_RUNTIME;
+  }
+  return FALLBACK_RUNTIME;
+}
+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(
+    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(
+    "-f, --file <path>",
+    "Attach a text file (can be used multiple times)",
+    (value, previous) => previous.concat(value),
+    []
+  ).action(
+    async (prompt, opts, command) => {
+      const runtimeOptionSource = command.getOptionValueSource("runtime");
+      const runtime = createRuntime({
+        name: opts.runtime,
+        defaultRuntime
+      });
+      const result = await runtime.run({
+        workingDirectory: opts.directory,
+        prompt,
+        systemPrompt: opts.system,
+        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,
+        session: opts.resume ? { mode: "resume", sessionId: opts.resume } : void 0
+      });
+      if (result.sessionId) {
+        console.error(`Session ID: ${result.sessionId}`);
+      }
+      if (!result.success) {
+        console.error(result.error ?? "Runtime execution failed.");
+        process.exitCode = 1;
+        return;
+      }
+      if (result.output) {
+        console.log(result.output);
+      }
+    }
+  );
+}
+if (process.argv[1]) {
+  const entryUrl = pathToFileURL(process.argv[1]).href;
+  if (import.meta.url === entryUrl) {
+    createCliProgram().parseAsync().catch((error) => {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(message);
+      process.exit(1);
+    });
+  }
+}
+export {
+  RUNTIME_SELECTION_ENV,
+  createCliProgram,
+  getDefaultRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +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":[]}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+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';
+
+type RuntimeName = "claude" | "codex" | "copilot" | "gemini";
+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;
+}): AgentRuntime;
+declare function getRuntimeCapabilities(runtime: AgentRuntime): RuntimeCapabilities;
+
+export { AgentRuntime, RuntimeCapabilities, RuntimeFeature, type RuntimeName, createRuntime, getAvailableRuntimeClasses, getAvailableRuntimeNames, getRuntimeCapabilities };

package/dist/index.js

@@ -0,0 +1,29 @@
+import {
+  createRuntime,
+  getAvailableRuntimeClasses,
+  getAvailableRuntimeNames,
+  getRuntimeCapabilities
+} from "./chunk-NKMHTQVX.js";
+import "./chunk-EN5WJJ2G.js";
+import "./chunk-CGK4TBZD.js";
+import "./chunk-AVSJQKCD.js";
+import "./chunk-ZUMYGBXZ.js";
+import {
+  UnsupportedRuntimeFeatureError,
+  assertRuntimeRunOptionsSupported,
+  assertRuntimeSupports,
+  buildRuntimePrompt,
+  getRequestedRuntimeFeatures
+} from "./chunk-YAZLCEAU.js";
+export {
+  UnsupportedRuntimeFeatureError,
+  assertRuntimeRunOptionsSupported,
+  assertRuntimeSupports,
+  buildRuntimePrompt,
+  createRuntime,
+  getAvailableRuntimeClasses,
+  getAvailableRuntimeNames,
+  getRequestedRuntimeFeatures,
+  getRuntimeCapabilities
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime-DxAkSUZk.d.ts

@@ -0,0 +1,97 @@
+/** Core runtime abstractions for running a coding agent on a task. */
+/** Event emitted during agent execution for real-time progress streaming. */
+type RuntimeEvent = {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_use";
+    tool: string;
+    input?: unknown;
+} | {
+    type: "tool_result";
+    tool: string;
+    output?: string;
+    isError?: boolean;
+} | {
+    type: "thinking";
+    content: string;
+} | {
+    type: "error";
+    message: string;
+};
+type RuntimeFeature = "resumeSession" | "eventStreaming";
+interface RuntimeCapabilities {
+    readonly resumeSession: boolean;
+    readonly eventStreaming: boolean;
+}
+interface RuntimeClass<T extends AgentRuntime = AgentRuntime> {
+    new (): T;
+    readonly runtimeName: string;
+    readonly capabilities: RuntimeCapabilities;
+}
+type RuntimeSession = {
+    mode: "new";
+} | {
+    mode: "resume";
+    sessionId: string;
+};
+/** Options passed to AgentRuntime.run(). */
+interface RuntimeRunOptions {
+    /** Directory the agent operates in. */
+    workingDirectory: string;
+    /** The task/instructions for the agent. */
+    prompt: string;
+    /** Optional system prompt text for the run. */
+    systemPrompt?: string;
+    /** Optional text file attachments included alongside the prompt. */
+    attachments?: RuntimeAttachment[];
+    /** Environment variables injected into the agent process. */
+    env?: Record<string, string>;
+    /** Session behavior for the run. */
+    session?: RuntimeSession;
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Abort signal for cancellation. */
+    signal?: AbortSignal;
+    /** Optional streaming callback for real-time progress. */
+    onEvent?: (event: RuntimeEvent) => void;
+}
+/** Result returned by AgentRuntime.run(). */
+interface AgentResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    sessionId?: string;
+}
+interface RuntimeAttachment {
+    /** File path to attach. Relative paths resolve from workingDirectory. */
+    path: string;
+    /** Optional inline content. When omitted, the file is read from disk. */
+    content?: string;
+}
+declare class UnsupportedRuntimeFeatureError extends Error {
+    readonly runtime: string;
+    readonly feature: RuntimeFeature;
+    readonly operation: string;
+    readonly details?: string;
+    constructor(options: {
+        runtime: string;
+        feature: RuntimeFeature;
+        operation: string;
+        details?: string;
+    });
+}
+declare function getRequestedRuntimeFeatures(options: Pick<RuntimeRunOptions, "onEvent" | "session">): RuntimeFeature[];
+/** The core abstraction: run a coding agent on a task. */
+interface AgentRuntime {
+    readonly name: string;
+    /** Run the agent on a prompt in a directory, return when done. */
+    run(options: RuntimeRunOptions): Promise<AgentResult>;
+    /** Optional cleanup. */
+    dispose?(): Promise<void>;
+}
+declare function assertRuntimeSupports(runtime: AgentRuntime | RuntimeClass, features: readonly RuntimeFeature[], operation: string): void;
+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 };