coding-agents-sdk 0.0.1 → 0.3.0

package/dist/types-COlDAzs5.d.mts

@@ -0,0 +1,162 @@
+import { t as AgentEvent, v as AgentCapabilities, x as JsonSchema, y as ContentPart } from "./events-D31_b0sA.mjs";
+import { ZodType } from "zod/v4";
+
+//#region src/core/process/types.d.ts
+type StdioOption = "ignore" | "inherit" | "pipe" | number;
+type ProcessSignal = NodeJS.Signals;
+interface SpawnOptions {
+  cwd?: string;
+  env?: Record<string, string>;
+  stdio?: [StdioOption, StdioOption, StdioOption];
+}
+interface ProcessResult {
+  exitCode: number | null;
+  signal: ProcessSignal | null;
+}
+interface AgentProcess {
+  stdout: AsyncIterable<Uint8Array> | null;
+  stderr: AsyncIterable<Uint8Array> | null;
+  stdin: {
+    write?: (chunk: Uint8Array | string) => void;
+    end: () => void;
+  } | null;
+  kill: (signal?: ProcessSignal | number) => void;
+  wait: () => Promise<ProcessResult>;
+}
+interface ProcessSpawner {
+  spawn: (command: string, args: string[], options?: SpawnOptions) => AgentProcess;
+}
+//#endregion
+//#region src/core/agent/types.d.ts
+type AgentType = "claude-code-cli" | "claude-code-sdk" | "codex-cli" | "codex-sdk" | "gemini-cli";
+type RunStatus = "cancelled" | "completed" | "failed";
+type StopReason = "abort" | "timeout" | "user";
+interface RunStats {
+  durationMs?: number;
+  apiDurationMs?: number;
+  turns: number;
+  costUsd: number;
+  inputTokens?: number;
+  cacheCreationInputTokens?: number;
+  cacheReadInputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+}
+interface RunError {
+  kind: "abort" | "parse" | "process" | "provider" | "spawn";
+  message: string;
+}
+interface RunRequest {
+  input: ContentPart[] | string;
+  cwd?: string;
+  model?: string;
+  systemPrompt?: string;
+  timeoutMs?: number;
+  signal?: AbortSignal;
+}
+interface JsonSchemaRunRequest extends RunRequest {
+  schema: JsonSchema;
+}
+interface ZodRunRequest<TOutput = unknown> extends RunRequest {
+  schema: ZodType<TOutput>;
+}
+type StructuredRunRequest<TOutput = unknown> = JsonSchemaRunRequest | ZodRunRequest<TOutput>;
+type AnyRunRequest = RunRequest | StructuredRunRequest;
+interface RunTiming {
+  startedAt: Date;
+  endedAt: Date;
+  durationMs: number;
+}
+interface RunProcessInfo {
+  exitCode: number | null;
+  signal: ProcessSignal | null;
+  stderr: string;
+}
+interface RunResultBase {
+  type: AgentType;
+  runId: string;
+  sessionId?: string;
+  text: string;
+  events: readonly AgentEvent[];
+  stats?: RunStats;
+  timing: RunTiming;
+  process?: RunProcessInfo;
+}
+interface CancelledRunResult extends RunResultBase {
+  status: "cancelled";
+  output?: undefined;
+  error: RunError;
+  cancelReason: StopReason;
+}
+interface FailedRunResult extends RunResultBase {
+  status: "failed";
+  output?: undefined;
+  error: RunError;
+  cancelReason?: undefined;
+}
+type CompletedRunResult<TOutput = never> = RunResultBase & ([TOutput] extends [never] ? {} : {
+  output: TOutput;
+}) & {
+  status: "completed";
+  error?: undefined;
+  cancelReason?: undefined;
+};
+type RunResult<TOutput = never> = CancelledRunResult | CompletedRunResult<TOutput> | FailedRunResult;
+type AnyRunResult = RunResult | RunResult<unknown>;
+type AnyCompletedRunResult = CompletedRunResult | CompletedRunResult<unknown>;
+type AgentRun<TRunOptions extends object = {}> = {
+  <TOutput>(request: TRunOptions & ZodRunRequest<TOutput>): Promise<RunResult<TOutput>>;
+  (request: JsonSchemaRunRequest & TRunOptions): Promise<RunResult<unknown>>;
+  (request: RunRequest & TRunOptions): Promise<RunResult>;
+};
+type AgentRunOrThrow<TRunOptions extends object = {}> = {
+  <TOutput>(request: TRunOptions & ZodRunRequest<TOutput>): Promise<CompletedRunResult<TOutput>>;
+  (request: JsonSchemaRunRequest & TRunOptions): Promise<CompletedRunResult<unknown>>;
+  (request: RunRequest & TRunOptions): Promise<CompletedRunResult>;
+};
+declare class AgentRunError<TOutput = never> extends Error {
+  readonly result: RunResult<TOutput> & {
+    status: "cancelled" | "failed";
+  };
+  constructor(result: RunResult<TOutput> & {
+    status: "cancelled" | "failed";
+  });
+}
+declare class AgentValidationError extends Error {
+  constructor(message: string);
+}
+type AgentEventHandler = (event: AgentEvent) => void;
+interface AgentMetrics {
+  runCount: number;
+  messagesReceived: number;
+  toolCalls: number;
+  errors: number;
+  startedAt: Date;
+  lastActivityAt: Date;
+}
+type EffectiveKeys<T> = keyof { [K in keyof T as Required<T>[K] extends never ? never : K]: unknown };
+type EnsureDisjoint<T extends object> = EffectiveKeys<T> & keyof RunRequest extends never ? T : never;
+type ExclusiveExecutionTargetOptions<TContainer, TSandbox> = {
+  container?: never;
+  sandbox?: TSandbox;
+} | {
+  container?: TContainer;
+  sandbox?: never;
+};
+interface BaseAgent<TRunOptions extends object = {}> {
+  readonly type: AgentType;
+  readonly capabilities: Readonly<AgentCapabilities>;
+  readonly sessionId?: string;
+  readonly isRunning: boolean;
+  readonly metrics: Readonly<AgentMetrics>;
+  run: AgentRun<TRunOptions>;
+  runOrThrow: AgentRunOrThrow<TRunOptions>;
+  stop: () => Promise<AnyRunResult | undefined>;
+  reset: () => void;
+  wait: () => Promise<AnyRunResult>;
+  dispose: () => Promise<void>;
+  [Symbol.asyncDispose]: () => Promise<void>;
+  onEvent: (handler: AgentEventHandler) => () => void;
+}
+//#endregion
+export { RunTiming as C, ProcessSpawner as D, ZodRunRequest as E, RunStatus as S, StructuredRunRequest as T, RunProcessInfo as _, AgentValidationError as a, RunResultBase as b, AnyRunResult as c, CompletedRunResult as d, EnsureDisjoint as f, RunError as g, JsonSchemaRunRequest as h, AgentType as i, BaseAgent as l, FailedRunResult as m, AgentMetrics as n, AnyCompletedRunResult as o, ExclusiveExecutionTargetOptions as p, AgentRunError as r, AnyRunRequest as s, AgentEventHandler as t, CancelledRunResult as u, RunRequest as v, StopReason as w, RunStats as x, RunResult as y };

package/dist/types-CwvWHEpy.mjs

@@ -0,0 +1 @@
+var e=class extends Error{result;constructor(e){super(e.error.message),this.name=`AgentRunError`,this.result=e}},t=class extends Error{constructor(e){super(e),this.name=`AgentValidationError`}};export{t as n,e as t};

package/dist/util-CGg8cK92.mjs

@@ -0,0 +1 @@
+const e=e=>Array.isArray(e)?e:[e],t=e=>e instanceof Error?e.message:String(e),n=e=>typeof e==`object`&&!!e,r=(...e)=>e.reduce((e,t)=>e+(t??0),0),i=e=>{let t=e.trim();return t.startsWith("```")?t.replace(/^```[\w-]*\s*/i,``).replace(/\s*```$/i,``).trim():t},a=e=>/```[\w-]*\s*([\S\s]*?)\s*```/i.exec(e)?.[1]?.trim(),o=e=>{let t=-1,n=[],r=!1,i=!1;for(let a=0;a<e.length;a++){let o=e[a];if(o){if(t===-1){(o===`{`||o===`[`)&&(t=a,n.push(o));continue}if(r){if(i){i=!1;continue}if(o===`\\`){i=!0;continue}o===`"`&&(r=!1);continue}if(o===`"`){r=!0;continue}if(o===`{`||o===`[`){n.push(o);continue}if(o===`}`||o===`]`){let r=n.pop();if(r===`{`&&o!==`}`||r===`[`&&o!==`]`)return;if(n.length===0)return e.slice(t,a+1).trim()}}}},s=e=>{let t=e.trim(),n=[i(t),a(t),o(t)],r;for(let e of new Set(n))if(e)try{return JSON.parse(e)}catch(e){r=e}throw r instanceof Error?r:SyntaxError(`Failed to parse JSON response text.`)};export{e as a,r as i,n,s as r,t};

package/package.json

@@ -1,15 +1,96 @@
 {
   "name": "coding-agents-sdk",
-  "version": "0.0.1",
-  "license": "UNLICENSED",
-  "main": "index.js",
+  "version": "0.3.0",
+  "type": "module",
+  "types": "./dist/index.d.mts",
   "exports": {
-    ".": "./index.js"
-  },
-  "publishConfig": {
-    "access": "public"
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.mts",
+      "default": "./dist/schemas/index.mjs"
+    },
+    "./container": {
+      "types": "./dist/container/index.d.mts",
+      "default": "./dist/container/index.mjs"
+    },
+    "./sandbox": {
+      "types": "./dist/sandbox/index.d.mts",
+      "default": "./dist/sandbox/index.mjs"
+    },
+    "./adapters/claude-code-cli": {
+      "types": "./dist/adapters/claude-code-cli/index.d.mts",
+      "default": "./dist/adapters/claude-code-cli/index.mjs"
+    },
+    "./adapters/claude-code-sdk": {
+      "types": "./dist/adapters/claude-code-sdk/index.d.mts",
+      "default": "./dist/adapters/claude-code-sdk/index.mjs"
+    },
+    "./adapters/codex-cli": {
+      "types": "./dist/adapters/codex-cli/index.d.mts",
+      "default": "./dist/adapters/codex-cli/index.mjs"
+    },
+    "./adapters/codex-sdk": {
+      "types": "./dist/adapters/codex-sdk/index.d.mts",
+      "default": "./dist/adapters/codex-sdk/index.mjs"
+    },
+    "./adapters/gemini-cli": {
+      "types": "./dist/adapters/gemini-cli/index.d.mts",
+      "default": "./dist/adapters/gemini-cli/index.mjs"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "index.js"
-  ]
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown && bun run test:package",
+    "start": "bun run examples/claude-code-cli/simple.ts",
+    "test": "bun test",
+    "test:agent": "bun test ./tests",
+    "test:package": "bun run test:package:runtime",
+    "test:package:runtime": "bun test ./tests/package-exports.smoke.ts",
+    "test:agent:claude-code-cli": "CODE_WORKFLOW_TEST_AGENTS=claude-code-cli bun run test:agent",
+    "test:agent:claude-code-sdk": "CODE_WORKFLOW_TEST_AGENTS=claude-code-sdk bun run test:agent",
+    "test:agent:codex-cli": "CODE_WORKFLOW_TEST_AGENTS=codex-cli bun run test:agent",
+    "test:agent:codex-sdk": "CODE_WORKFLOW_TEST_AGENTS=codex-sdk bun run test:agent",
+    "test:agent:gemini-cli": "CODE_WORKFLOW_TEST_AGENTS=gemini-cli bun run test:agent",
+    "knip": "knip",
+    "tsc": "tsc --noEmit --pretty",
+    "typecheck": "bun run tsc"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.74",
+    "@openai/codex-sdk": "^0.114.0",
+    "@types/bun": "latest",
+    "@types/node": "^25.5.0",
+    "e2b": "^2.14.1",
+    "knip": "^5.87.0",
+    "picoprint": "^1.0.6",
+    "tsdown": "^0.21.4"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.74",
+    "@openai/codex-sdk": "^0.114.0",
+    "e2b": "^2.14.1",
+    "typescript": "^5"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@openai/codex-sdk": {
+      "optional": true
+    },
+    "e2b": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  }
 }

package/index.js

@@ -1,7 +0,0 @@
-"use strict";
-
-function getCodingAgentNames() {
-  return ["claude-code-cli", "codex-cli"];
-}
-
-module.exports = getCodingAgentNames;