@anthropic-ai/claude-code 1.0.18 → 1.0.19

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@anthropic-ai/claude-code",
-  "version": "1.0.18",
+  "version": "1.0.19",
+  "main": "sdk.mjs",
   "bin": {
     "claude": "cli.js"
   },

package/sdk.d.ts

@@ -0,0 +1,145 @@
+import type {
+  Message as APIAssistantMessage,
+  MessageParam as APIUserMessage,
+  Usage,
+} from '@anthropic-ai/sdk/resources/index.mjs'
+
+export type NonNullableUsage = {
+  [K in keyof Usage]: NonNullable<Usage[K]>
+}
+
+export type ApiKeySource = 'user' | 'project' | 'org' | 'temporary'
+
+export type ConfigScope = 'local' | 'user' | 'project'
+
+export type McpStdioServerConfig = {
+  type?: 'stdio' // Optional for backwards compatibility
+  command: string
+  args?: string[]
+  env?: Record<string, string>
+}
+
+export type McpSSEServerConfig = {
+  type: 'sse'
+  url: string
+  headers?: Record<string, string>
+}
+
+export type McpServerConfig = McpStdioServerConfig | McpSSEServerConfig
+
+export type Options = {
+  abortController?: AbortController
+  allowedTools?: string[]
+  appendSystemPrompt?: string
+  customSystemPrompt?: string
+  cwd?: string
+  disallowedTools?: string[]
+  executable?: 'bun' | 'deno' | 'node'
+  executableArgs?: string[]
+  maxThinkingTokens?: number
+  maxTurns?: number
+  mcpServers?: Record<string, McpServerConfig>
+  pathToClaudeCodeExecutable?: string
+  permissionMode?: PermissionMode
+  permissionPromptToolName?: string
+  continue?: boolean
+  resume?: string
+  userSpecifiedModel?: string
+}
+
+export type PermissionMode =
+  | 'default'
+  | 'acceptEdits'
+  | 'bypassPermissions'
+  | 'plan'
+
+export type SDKUserMessage = {
+  type: 'user'
+  message: APIUserMessage
+  parent_tool_use_id: string | null
+  session_id: string
+}
+
+export type SDKAssistantMessage = {
+  type: 'assistant'
+  message: APIAssistantMessage
+  parent_tool_use_id: string | null
+  session_id: string
+}
+
+export type SDKResultMessage =
+  | {
+      type: 'result'
+      subtype: 'success'
+      cost_usd: number
+      duration_ms: number
+      duration_api_ms: number
+      is_error: boolean
+      num_turns: number
+      result: string
+      session_id: string
+      total_cost: number
+      usage: NonNullableUsage
+    }
+  | {
+      type: 'result'
+      subtype: 'error_max_turns' | 'error_during_execution'
+      cost_usd: number
+      duration_ms: number
+      duration_api_ms: number
+      is_error: boolean
+      num_turns: number
+      session_id: string
+      total_cost: number
+      usage: NonNullableUsage
+    }
+
+export type SDKSystemMessage = {
+  type: 'system'
+  subtype: 'init'
+  apiKeySource: ApiKeySource
+  cwd: string
+  session_id: string
+  tools: string[]
+  mcp_servers: {
+    name: string
+    status: string
+  }[]
+  model: string
+  permissionMode: PermissionMode
+}
+
+export type SDKMessage =
+  | SDKAssistantMessage
+  | SDKUserMessage
+  | SDKResultMessage
+  | SDKSystemMessage
+
+type Props = {
+  prompt: string
+  abortController?: AbortController
+  options?: Options
+}
+
+/**
+ * Query Claude Code
+ *
+ * Behavior:
+ * - Yields a message at a time
+ * - Uses the tools and commands you give it
+ *
+ * Usage:
+ * ```ts
+ * const response = query({ prompt: "Help me write a function", options: {} })
+ * for await (const message of response) {
+ *   console.log(message)
+ * }
+ * ```
+ */
+export function query({
+  prompt,
+  abortController,
+  options,
+}: Props): AsyncGenerator<SDKMessage>
+
+export class AbortError extends Error {}

package/sdk.mjs

@@ -0,0 +1,141 @@
+// (c) Anthropic PBC. All rights reserved. Use is subject to Anthropic's Commercial Terms of Service (https://www.anthropic.com/legal/commercial-terms).
+
+// Version: 1.0.19
+
+// src/entrypoints/sdk.ts
+import { spawn } from "child_process";
+import { join } from "path";
+import { fileURLToPath } from "url";
+import { createInterface } from "readline";
+import { existsSync } from "fs";
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = join(__filename2, "..");
+async function* query({
+  prompt,
+  options: {
+    abortController = new AbortController,
+    allowedTools = [],
+    appendSystemPrompt,
+    customSystemPrompt,
+    cwd,
+    disallowedTools = [],
+    executable = "node",
+    executableArgs = [],
+    maxTurns,
+    mcpServers,
+    pathToClaudeCodeExecutable = join(__dirname2, "cli.js"),
+    permissionMode = "default",
+    permissionPromptToolName,
+    continue: continueConversation,
+    resume,
+    userSpecifiedModel
+  } = {}
+}) {
+  process.env.CLAUDE_CODE_ENTRYPOINT = "sdk-ts";
+  const args = ["--output-format", "stream-json", "--verbose"];
+  if (customSystemPrompt)
+    args.push("--system-prompt", customSystemPrompt);
+  if (appendSystemPrompt)
+    args.push("--append-system-prompt", appendSystemPrompt);
+  if (maxTurns)
+    args.push("--max-turns", maxTurns.toString());
+  if (userSpecifiedModel)
+    args.push("--model", userSpecifiedModel);
+  if (permissionPromptToolName)
+    args.push("--permission-prompt-tool", permissionPromptToolName);
+  if (continueConversation)
+    args.push("--continue");
+  if (resume)
+    args.push("--resume", resume);
+  if (allowedTools.length > 0) {
+    args.push("--allowedTools", allowedTools.join(","));
+  }
+  if (disallowedTools.length > 0) {
+    args.push("--disallowedTools", disallowedTools.join(","));
+  }
+  if (mcpServers && Object.keys(mcpServers).length > 0) {
+    args.push("--mcp-config", JSON.stringify({ mcpServers }));
+  }
+  if (permissionMode !== "default") {
+    args.push("--permission-mode", permissionMode);
+  }
+  if (!prompt.trim()) {
+    throw new RangeError("Prompt is required");
+  }
+  args.push("--print", prompt.trim());
+  if (!existsSync(pathToClaudeCodeExecutable)) {
+    throw new ReferenceError(`Claude Code executable not found at ${pathToClaudeCodeExecutable}. Is options.pathToClaudeCodeExecutable set?`);
+  }
+  logDebug(`Spawning Claude Code process: ${executable} ${[...executableArgs, pathToClaudeCodeExecutable, ...args].join(" ")}`);
+  const child = spawn(executable, [...executableArgs, pathToClaudeCodeExecutable, ...args], {
+    cwd,
+    stdio: ["pipe", "pipe", "pipe"],
+    signal: abortController.signal,
+    env: {
+      ...process.env
+    }
+  });
+  child.stdin.end();
+  if (process.env.DEBUG) {
+    child.stderr.on("data", (data) => {
+      console.error("Claude Code stderr:", data.toString());
+    });
+  }
+  const cleanup = () => {
+    if (!child.killed) {
+      child.kill("SIGTERM");
+    }
+  };
+  abortController.signal.addEventListener("abort", cleanup);
+  process.on("exit", cleanup);
+  try {
+    let processError = null;
+    child.on("error", (error) => {
+      processError = new Error(`Failed to spawn Claude Code process: ${error.message}`);
+    });
+    const processExitPromise = new Promise((resolve, reject) => {
+      child.on("close", (code) => {
+        if (abortController.signal.aborted) {
+          reject(new AbortError("Claude Code process aborted by user"));
+        }
+        if (code !== 0) {
+          reject(new Error(`Claude Code process exited with code ${code}`));
+        } else {
+          resolve();
+        }
+      });
+    });
+    const rl = createInterface({ input: child.stdout });
+    try {
+      for await (const line of rl) {
+        if (processError) {
+          throw processError;
+        }
+        if (line.trim()) {
+          yield JSON.parse(line);
+        }
+      }
+    } finally {
+      rl.close();
+    }
+    await processExitPromise;
+  } finally {
+    cleanup();
+    abortController.signal.removeEventListener("abort", cleanup);
+    if (process.env.CLAUDE_SDK_MCP_SERVERS) {
+      delete process.env.CLAUDE_SDK_MCP_SERVERS;
+    }
+  }
+}
+function logDebug(message) {
+  if (process.env.DEBUG) {
+    console.debug(message);
+  }
+}
+
+class AbortError extends Error {
+}
+export {
+  query,
+  AbortError
+};