/** * Type definitions for Claude SDK integration * * Contains stream event types, callback types, and result types * used throughout the Claude integration layer. */ import type { PermissionUpdate, AgentDefinition, SandboxSettings } from '@anthropic-ai/claude-agent-sdk'; import type { PermissionMode, McpServerConfig } from '../../core/models/index.js'; import type { AgentErrorKind, ProviderUsageSnapshot, RateLimitInfo } from '../../core/models/response.js'; import type { ProviderImageAttachment } from '../providers/types.js'; import type { StreamEvent as SharedStreamEvent, StreamCallback as SharedStreamCallback, StreamInitEventData as SharedInitEventData, StreamToolUseEventData as SharedToolUseEventData, StreamToolResultEventData as SharedToolResultEventData, StreamToolOutputEventData as SharedToolOutputEventData, StreamTextEventData as SharedTextEventData, StreamThinkingEventData as SharedThinkingEventData, StreamResultEventData as SharedResultEventData, StreamErrorEventData as SharedErrorEventData, StreamAssistantErrorEventData as SharedAssistantErrorEventData, StreamRateLimitEventData as SharedRateLimitEventData, InternalAgentIsolation, ProviderActivityCallback } from '../../shared/types/provider.js'; export type { SandboxSettings }; import type { PermissionResult } from '../../core/workflow/index.js'; export type { PermissionResult, PermissionUpdate }; export type InitEventData = SharedInitEventData; export type ToolUseEventData = SharedToolUseEventData; export type ToolResultEventData = SharedToolResultEventData; export type ToolOutputEventData = SharedToolOutputEventData; export type TextEventData = SharedTextEventData; export type ThinkingEventData = SharedThinkingEventData; export type ResultEventData = SharedResultEventData; export type ErrorEventData = SharedErrorEventData; export type AssistantErrorEventData = SharedAssistantErrorEventData; export type RateLimitEventData = SharedRateLimitEventData; export type StreamEvent = SharedStreamEvent; export type StreamCallback = SharedStreamCallback; /** Permission request info passed to handler */ export interface PermissionRequest { toolName: string; input: Record; suggestions?: PermissionUpdate[]; blockedPath?: string; decisionReason?: string; } /** Permission handler callback type */ export type PermissionHandler = (request: PermissionRequest) => Promise; /** AskUserQuestion tool input */ export interface AskUserQuestionInput { questions: Array<{ question: string; header?: string; options?: Array<{ label: string; description?: string; }>; multiSelect?: boolean; }>; } /** AskUserQuestion handler callback type */ export type AskUserQuestionHandler = (input: AskUserQuestionInput) => Promise>; /** Result from Claude execution */ export interface ClaudeResult { success: boolean; content: string; sessionId?: string; error?: string; errorKind?: AgentErrorKind; rateLimitInfo?: RateLimitInfo; interrupted?: boolean; /** All assistant text accumulated during execution (for status detection) */ fullContent?: string; /** Structured output returned by Claude SDK */ structuredOutput?: Record; /** Provider-native usage payload normalized for TAKT observability */ providerUsage?: ProviderUsageSnapshot; } /** Extended result with query ID for concurrent execution */ export interface ClaudeResultWithQueryId extends ClaudeResult { queryId: string; } /** Options for calling Claude (high-level, used by client/providers/agents) */ export interface ClaudeCallOptions { cwd: string; abortSignal?: AbortSignal; sessionId?: string; internalAgentIsolation?: InternalAgentIsolation; allowedTools?: string[]; /** MCP servers configuration */ mcpServers?: Record; /** Provider-prepared MCP material (issue #1137). */ preparedMcp?: import('../providers/mcp/types.js').PreparedProviderMcp; model?: string; effort?: string; skillsEnabled?: boolean; maxTurns?: number; systemPrompt?: string; /** SDK agents to register for sub-agent execution */ agents?: Record; /** Permission mode for tool execution (from workflow step) */ permissionMode?: PermissionMode; /** Enable streaming mode with callback for real-time output */ onStream?: StreamCallback; onActivity?: ProviderActivityCallback; /** Custom permission handler for interactive permission prompts */ onPermissionRequest?: PermissionHandler; /** Custom handler for AskUserQuestion tool */ onAskUserQuestion?: AskUserQuestionHandler; /** Bypass all permission checks */ bypassPermissions?: boolean; /** Anthropic API key to inject via env (bypasses CLI auth) */ anthropicApiKey?: string; /** Anthropic-compatible API base URL */ baseUrl?: string; /** JSON Schema for structured output */ outputSchema?: Record; /** Sandbox settings for Claude SDK */ sandbox?: SandboxSettings; /** Custom path to Claude Code executable */ pathToClaudeCodeExecutable?: string; imageAttachments?: ProviderImageAttachment[]; childProcessEnv?: Readonly>; } /** Options for spawning a Claude SDK query (low-level, used by executor/process) */ export interface ClaudeSpawnOptions { cwd: string; abortSignal?: AbortSignal; sessionId?: string; internalAgentIsolation?: InternalAgentIsolation; allowedTools?: string[]; /** MCP servers configuration */ mcpServers?: Record; /** * Provider-prepared MCP material (issue #1137). When present, the SDK * options builder merges `sdkOptions.mcpServers`/`strictMcpConfig` on top * of the legacy `mcpServers` field so runtime MCP assignment takes effect * for normal agent steps (not only `strict-readonly`). */ preparedMcp?: import('../providers/mcp/types.js').PreparedProviderMcp; model?: string; effort?: string; skillsEnabled?: boolean; maxTurns?: number; systemPrompt?: string; /** Enable streaming mode with callback */ onStream?: StreamCallback; onActivity?: ProviderActivityCallback; /** Custom agents to register */ agents?: Record; /** Permission mode for tool execution (TAKT abstract value, mapped to SDK value in SdkOptionsBuilder) */ permissionMode?: PermissionMode; /** Custom permission handler for interactive permission prompts */ onPermissionRequest?: PermissionHandler; /** Custom handler for AskUserQuestion tool */ onAskUserQuestion?: AskUserQuestionHandler; /** Bypass all permission checks */ bypassPermissions?: boolean; /** Anthropic API key to inject via env (bypasses CLI auth) */ anthropicApiKey?: string; /** Anthropic-compatible API base URL */ baseUrl?: string; /** JSON Schema for structured output */ outputSchema?: Record; /** Callback for stderr output from the Claude Code process */ onStderr?: (data: string) => void; /** Sandbox settings for Claude SDK */ sandbox?: SandboxSettings; /** Custom path to Claude Code executable */ pathToClaudeCodeExecutable?: string; imageAttachments?: ProviderImageAttachment[]; childProcessEnv?: Readonly>; } //# sourceMappingURL=types.d.ts.map