@anthropic-ai/claude-agent-sdk 0.2.0 → 0.2.2

package/sdk.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // (c) Anthropic PBC. All rights reserved. Use is subject to the Legal Agreements outlined here: https://code.claude.com/docs/en/legal-and-compliance.
 
-// Version: 0.2.0
+// Version: 0.2.2
 
 // Want to see the unminified source? We're hiring!
 // https://job-boards.greenhouse.io/anthropic/jobs/4816199008
@@ -7178,7 +7178,8 @@ function getInitialState() {
     teleportedSessionInfo: null,
     invokedSkills: new Map,
     slowOperations: [],
-    sdkBetas: undefined
+    sdkBetas: undefined,
+    mainThreadAgentType: undefined
   };
 }
 var STATE = getInitialState();
@@ -8606,22 +8607,22 @@ class SessionImpl {
       maxBudgetUsd: undefined,
       model: options.model,
       fallbackModel: undefined,
-      permissionMode: "default",
+      permissionMode: options.permissionMode ?? "default",
       allowDangerouslySkipPermissions: false,
       continueConversation: false,
       resume: options.resume,
       settingSources: [],
-      allowedTools: [],
-      disallowedTools: [],
+      allowedTools: options.allowedTools ?? [],
+      disallowedTools: options.disallowedTools ?? [],
       mcpServers: {},
       strictMcpConfig: false,
-      canUseTool: false,
-      hooks: false,
+      canUseTool: !!options.canUseTool,
+      hooks: !!options.hooks,
       includePartialMessages: false,
       forkSession: false,
       resumeSessionAt: undefined
     });
-    this.query = new Query(transport, false, undefined, undefined, this.abortController, new Map);
+    this.query = new Query(transport, false, options.canUseTool, options.hooks, this.abortController, new Map);
     this.query.streamInput(this.inputStream);
   }
   async send(message) {
@@ -21329,7 +21330,7 @@ function query({
     const dirname2 = join5(filename, "..");
     pathToClaudeCodeExecutable = join5(dirname2, "cli.js");
   }
-  process.env.CLAUDE_AGENT_SDK_VERSION = "0.2.0";
+  process.env.CLAUDE_AGENT_SDK_VERSION = "0.2.2";
   const {
     abortController = createAbortController(),
     additionalDirectories = [],

package/entrypoints/agentSdkTypes.d.ts

@@ -1,56 +0,0 @@
-/**
- * Main entrypoint for Claude Code Agent SDK types.
- *
- * This file re-exports the public SDK API from:
- * - sdk/coreTypes.ts - Common serializable types (messages, configs)
- * - sdk/runtimeTypes.ts - Non-serializable types (callbacks, interfaces)
- *
- * SDK builders who need control protocol types should import from
- * sdk/controlTypes.ts directly.
- */
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-export * from './sdk/coreTypes.js';
-export * from './sdk/runtimeTypes.js';
-import type { Query, Options, SDKSessionOptions, SDKSession, SdkMcpToolDefinition, McpSdkServerConfigWithInstance, AnyZodRawShape, InferShape } from './sdk/runtimeTypes.js';
-import type { SDKUserMessage, SDKResultMessage } from './sdk/coreTypes.js';
-export declare function tool<Schema extends AnyZodRawShape>(_name: string, _description: string, _inputSchema: Schema, _handler: (args: InferShape<Schema>, extra: unknown) => Promise<CallToolResult>): SdkMcpToolDefinition<Schema>;
-type CreateSdkMcpServerOptions = {
-    name: string;
-    version?: string;
-    tools?: Array<SdkMcpToolDefinition<any>>;
-};
-/**
- * Creates an MCP server instance that can be used with the SDK transport.
- * This allows SDK users to define custom tools that run in the same process.
- *
- * If your SDK MCP calls will run longer than 60s, override CLAUDE_CODE_STREAM_CLOSE_TIMEOUT
- */
-export declare function createSdkMcpServer(_options: CreateSdkMcpServerOptions): McpSdkServerConfigWithInstance;
-export declare class AbortError extends Error {
-}
-export declare function query(_params: {
-    prompt: string | AsyncIterable<SDKUserMessage>;
-    options?: Options;
-}): Query;
-/**
- * V2 API - UNSTABLE
- * Create a persistent session for multi-turn conversations.
- */
-export declare function unstable_v2_createSession(_options: SDKSessionOptions): SDKSession;
-/**
- * V2 API - UNSTABLE
- * Resume an existing session by ID.
- */
-export declare function unstable_v2_resumeSession(_sessionId: string, _options: SDKSessionOptions): SDKSession;
-/**
- * V2 API - UNSTABLE
- * One-shot convenience function for single prompts.
- *
- * @example
- * ```typescript
- * const result = await unstable_v2_prompt("What files are here?", {
- *   model: 'claude-sonnet-4-5-20250929'
- * })
- * ```
- */
-export declare function unstable_v2_prompt(_message: string, _options: SDKSessionOptions): Promise<SDKResultMessage>;

package/entrypoints/sandboxTypes.d.ts

@@ -1,44 +0,0 @@
-/**
- * Sandbox types for the Claude Code Agent SDK
- *
- * This file is the single source of truth for sandbox configuration types.
- * Both the SDK and the settings validation import from here.
- */
-import { z } from 'zod/v4';
-/**
- * Network configuration schema for sandbox.
- */
-export declare const SandboxNetworkConfigSchema: z.ZodOptional<z.ZodObject<{
-    allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
-    allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
-    httpProxyPort: z.ZodOptional<z.ZodNumber>;
-    socksProxyPort: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>>;
-/**
- * Sandbox settings schema.
- */
-export declare const SandboxSettingsSchema: z.ZodObject<{
-    enabled: z.ZodOptional<z.ZodBoolean>;
-    autoAllowBashIfSandboxed: z.ZodOptional<z.ZodBoolean>;
-    allowUnsandboxedCommands: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodObject<{
-        allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        allowUnixSockets: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        allowAllUnixSockets: z.ZodOptional<z.ZodBoolean>;
-        allowLocalBinding: z.ZodOptional<z.ZodBoolean>;
-        httpProxyPort: z.ZodOptional<z.ZodNumber>;
-        socksProxyPort: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    ignoreViolations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
-    enableWeakerNestedSandbox: z.ZodOptional<z.ZodBoolean>;
-    excludedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    ripgrep: z.ZodOptional<z.ZodObject<{
-        command: z.ZodString;
-        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$loose>;
-export type SandboxSettings = z.infer<typeof SandboxSettingsSchema>;
-export type SandboxNetworkConfig = NonNullable<z.infer<typeof SandboxNetworkConfigSchema>>;
-export type SandboxIgnoreViolations = NonNullable<SandboxSettings['ignoreViolations']>;

package/entrypoints/sdk/controlTypes.d.ts

@@ -1,2 +0,0 @@
-export * from './coreTypes.js';
-export * from './controlTypes.generated.js';

package/entrypoints/sdk/controlTypes.generated.d.ts

@@ -1,135 +0,0 @@
-/**
- * AUTO-GENERATED - DO NOT EDIT
- *
- * This file is auto-generated from Zod schemas in controlSchemas.ts.
- * To modify these types, edit the Zod schemas and run:
- *
- *   bun scripts/generate-sdk-types.ts
- */
-import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
-import type * as coreTypes from './coreTypes.js';
-export type ControlErrorResponse = {
-    subtype: 'error';
-    request_id: string;
-    error: string;
-    pending_permission_requests?: SDKControlRequest[];
-};
-export type ControlResponse = {
-    subtype: 'success';
-    request_id: string;
-    response?: Record<string, unknown>;
-};
-/**
- * Cancels a currently open control request.
- */
-export type SDKControlCancelRequest = {
-    type: 'control_cancel_request';
-    request_id: string;
-};
-export type SDKControlInitializeRequest = {
-    subtype: 'initialize';
-    hooks?: Partial<Record<coreTypes.HookEvent, SDKHookCallbackMatcher[]>>;
-    sdkMcpServers?: string[];
-    jsonSchema?: Record<string, unknown>;
-    systemPrompt?: string;
-    appendSystemPrompt?: string;
-    agents?: Record<string, coreTypes.AgentDefinition>;
-};
-export type SDKControlInitializeResponse = {
-    commands: coreTypes.SlashCommand[];
-    output_style: string;
-    available_output_styles: string[];
-    models: coreTypes.ModelInfo[];
-    /** Information about the logged in user's account. */
-    account: coreTypes.AccountInfo;
-};
-export type SDKControlInterruptRequest = {
-    subtype: 'interrupt';
-};
-export type SDKControlMcpMessageRequest = {
-    subtype: 'mcp_message';
-    server_name: string;
-    message: JSONRPCMessage;
-};
-export type SDKControlMcpSetServersRequest = {
-    subtype: 'mcp_set_servers';
-    servers: Record<string, coreTypes.McpServerConfigForProcessTransport>;
-};
-export type SDKControlMcpSetServersResponse = {
-    added: string[];
-    removed: string[];
-    errors: Record<string, string>;
-};
-export type SDKControlMcpStatusRequest = {
-    subtype: 'mcp_status';
-};
-export type SDKControlPermissionRequest = {
-    subtype: 'can_use_tool';
-    tool_name: string;
-    input: Record<string, unknown>;
-    permission_suggestions?: coreTypes.PermissionUpdate[];
-    blocked_path?: string;
-    decision_reason?: string;
-    tool_use_id: string;
-    agent_id?: string;
-};
-export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlMcpSetServersRequest;
-export type SDKControlRequest = {
-    type: 'control_request';
-    request_id: string;
-    request: SDKControlRequestInner;
-};
-export type SDKControlResponse = {
-    type: 'control_response';
-    response: ControlResponse | ControlErrorResponse;
-};
-export type SDKControlRewindFilesRequest = {
-    subtype: 'rewind_files';
-    user_message_id: string;
-    dry_run?: boolean;
-};
-/**
- * Result of a rewindFiles operation.
- */
-export type SDKControlRewindFilesResponse = {
-    canRewind: boolean;
-    error?: string;
-    filesChanged?: string[];
-    insertions?: number;
-    deletions?: number;
-};
-export type SDKControlSetMaxThinkingTokensRequest = {
-    subtype: 'set_max_thinking_tokens';
-    max_thinking_tokens: number | null;
-};
-export type SDKControlSetModelRequest = {
-    subtype: 'set_model';
-    model?: string;
-};
-export type SDKControlSetPermissionModeRequest = {
-    subtype: 'set_permission_mode';
-    /** Permission mode for controlling how tool executions are handled. 'default' - Standard behavior, prompts for dangerous operations. 'acceptEdits' - Auto-accept file edit operations. 'bypassPermissions' - Bypass all permission checks (requires allowDangerouslySkipPermissions). 'plan' - Planning mode, no actual tool execution. 'delegate' - Delegate mode, restricts team leader to only Teammate and Task tools. 'dontAsk' - Don't prompt for permissions, deny if not pre-approved. */
-    mode: coreTypes.PermissionMode;
-};
-/**
- * Configuration for matching and routing hook callbacks.
- */
-export type SDKHookCallbackMatcher = {
-    matcher?: string;
-    hookCallbackIds: string[];
-    timeout?: number;
-};
-export type SDKHookCallbackRequest = {
-    subtype: 'hook_callback';
-    callback_id: string;
-    input: coreTypes.HookInput;
-    tool_use_id?: string;
-};
-/**
- * Keep-alive message to maintain WebSocket connection.
- */
-export type SDKKeepAliveMessage = {
-    type: 'keep_alive';
-};
-export type StdinMessage = coreTypes.SDKUserMessage | SDKControlRequest | SDKControlResponse | SDKKeepAliveMessage;
-export type StdoutMessage = coreTypes.SDKMessage | SDKControlResponse | SDKControlRequest | SDKControlCancelRequest | SDKKeepAliveMessage;

package/entrypoints/sdk/coreTypes.d.ts

@@ -1,5 +0,0 @@
-export * from './coreTypes.generated.js';
-export type { SandboxSettings, SandboxNetworkConfig, SandboxIgnoreViolations, } from '../sandboxTypes.js';
-export type { NonNullableUsage } from './sdkUtilityTypes.js';
-export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PermissionRequest"];
-export declare const EXIT_REASONS: readonly ["clear", "logout", "prompt_input_exit", "other", "bypass_permissions_disabled"];