@claudebuddy/claudebuddy-agent-sdk 0.4.0

package/dist/types.d.ts

@@ -0,0 +1,485 @@
+/**
+ * Core type definitions for the Agent SDK
+ */
+import type { NormalizedMessageParam } from './providers/types.js';
+export type ContentBlockParam = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    source: any;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: any;
+} | {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | any[];
+    is_error?: boolean;
+};
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: any;
+} | {
+    type: 'thinking';
+    thinking: string;
+};
+export type MessageRole = 'user' | 'assistant';
+export interface ConversationMessage {
+    role: MessageRole;
+    content: string | ContentBlockParam[];
+}
+export interface UserMessage {
+    type: 'user';
+    message: ConversationMessage;
+    uuid: string;
+    timestamp: string;
+}
+export interface AssistantMessage {
+    type: 'assistant';
+    message: {
+        role: 'assistant';
+        content: ContentBlock[];
+    };
+    uuid: string;
+    timestamp: string;
+    usage?: TokenUsage;
+    cost?: number;
+}
+export type Message = UserMessage | AssistantMessage;
+export type SDKMessage = SDKAssistantMessage | SDKToolResultMessage | SDKResultMessage | SDKPartialMessage | SDKSystemMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKTaskNotificationMessage | SDKRateLimitEvent;
+export interface SDKAssistantMessage {
+    type: 'assistant';
+    uuid?: string;
+    session_id?: string;
+    message: {
+        role: 'assistant';
+        content: ContentBlock[];
+    };
+    parent_tool_use_id?: string | null;
+}
+export interface SDKToolResultMessage {
+    type: 'tool_result';
+    result: {
+        tool_use_id: string;
+        tool_name: string;
+        output: string;
+    };
+}
+export interface SDKResultMessage {
+    type: 'result';
+    subtype: 'success' | 'error_max_turns' | 'error_during_execution' | 'error_max_budget_usd' | string;
+    uuid?: string;
+    session_id?: string;
+    is_error?: boolean;
+    num_turns?: number;
+    result?: string;
+    stop_reason?: string | null;
+    total_cost_usd?: number;
+    duration_ms?: number;
+    duration_api_ms?: number;
+    usage?: TokenUsage;
+    model_usage?: Record<string, {
+        input_tokens: number;
+        output_tokens: number;
+    }>;
+    permission_denials?: Array<{
+        tool: string;
+        reason: string;
+    }>;
+    structured_output?: unknown;
+    errors?: string[];
+    /** @deprecated Use total_cost_usd */
+    cost?: number;
+}
+export interface SDKPartialMessage {
+    type: 'partial_message';
+    partial: {
+        type: 'text' | 'tool_use';
+        text?: string;
+        name?: string;
+        input?: string;
+    };
+}
+/** Emitted once at session start with initialization info. */
+export interface SDKSystemMessage {
+    type: 'system';
+    subtype: 'init';
+    uuid?: string;
+    session_id: string;
+    tools: string[];
+    model: string;
+    cwd: string;
+    mcp_servers: Array<{
+        name: string;
+        status: string;
+    }>;
+    permission_mode: string;
+}
+/** Marks a compaction boundary in the conversation. */
+export interface SDKCompactBoundaryMessage {
+    type: 'system';
+    subtype: 'compact_boundary';
+    summary?: string;
+}
+/** Status update during long operations. */
+export interface SDKStatusMessage {
+    type: 'system';
+    subtype: 'status';
+    message: string;
+}
+/** Task lifecycle notification. */
+export interface SDKTaskNotificationMessage {
+    type: 'system';
+    subtype: 'task_notification';
+    task_id: string;
+    status: string;
+    message?: string;
+}
+/** Rate limit event. */
+export interface SDKRateLimitEvent {
+    type: 'system';
+    subtype: 'rate_limit';
+    retry_after_ms?: number;
+    message: string;
+}
+export interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: ToolInputSchema;
+    call: (input: any, context: ToolContext) => Promise<ToolResult>;
+    isReadOnly?: () => boolean;
+    isConcurrencySafe?: () => boolean;
+    isEnabled?: () => boolean;
+    prompt?: (context: ToolContext) => Promise<string>;
+}
+export interface ToolInputSchema {
+    type: 'object';
+    properties: Record<string, any>;
+    required?: string[];
+}
+export interface ToolContext {
+    cwd: string;
+    abortSignal?: AbortSignal;
+    /** Parent agent's LLM provider (inherited by subagents) */
+    provider?: import('./providers/types.js').LLMProvider;
+    /** Parent agent's model ID */
+    model?: string;
+    /** Parent agent's API type */
+    apiType?: import('./providers/types.js').ApiType;
+}
+export interface ToolResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | any[];
+    is_error?: boolean;
+}
+export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan' | 'dontAsk' | 'auto';
+export type PermissionBehavior = 'allow' | 'deny';
+export type CanUseToolResult = {
+    behavior: PermissionBehavior;
+    updatedInput?: unknown;
+    message?: string;
+};
+export type CanUseToolFn = (tool: ToolDefinition, input: unknown) => Promise<CanUseToolResult>;
+export type McpServerConfig = McpStdioConfig | McpSseConfig | McpHttpConfig;
+export interface McpStdioConfig {
+    type?: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface McpSseConfig {
+    type: 'sse';
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface McpHttpConfig {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+}
+export interface AgentDefinition {
+    description: string;
+    prompt: string;
+    tools?: string[];
+    disallowedTools?: string[];
+    model?: 'sonnet' | 'opus' | 'haiku' | 'inherit' | string;
+    mcpServers?: Array<string | {
+        name: string;
+        tools?: string[];
+    }>;
+    skills?: string[];
+    maxTurns?: number;
+    criticalSystemReminder_EXPERIMENTAL?: string;
+}
+export interface ThinkingConfig {
+    type: 'adaptive' | 'enabled' | 'disabled';
+    budgetTokens?: number;
+}
+export interface SandboxSettings {
+    enabled?: boolean;
+    autoAllowBashIfSandboxed?: boolean;
+    excludedCommands?: string[];
+    allowUnsandboxedCommands?: boolean;
+    network?: SandboxNetworkConfig;
+    filesystem?: SandboxFilesystemConfig;
+    ignoreViolations?: Record<string, string[]>;
+    enableWeakerNestedSandbox?: boolean;
+    ripgrep?: {
+        command: string;
+        args?: string[];
+    };
+}
+export interface SandboxNetworkConfig {
+    allowedDomains?: string[];
+    allowManagedDomainsOnly?: boolean;
+    allowLocalBinding?: boolean;
+    allowUnixSockets?: string[];
+    allowAllUnixSockets?: boolean;
+    httpProxyPort?: number;
+    socksProxyPort?: number;
+}
+export interface SandboxFilesystemConfig {
+    allowWrite?: string[];
+    denyWrite?: string[];
+    denyRead?: string[];
+}
+export interface OutputFormat {
+    type: 'json_schema';
+    schema: Record<string, unknown>;
+}
+export type SettingSource = 'user' | 'project' | 'local';
+export interface ModelInfo {
+    value: string;
+    displayName: string;
+    description: string;
+    supportsEffort?: boolean;
+    supportedEffortLevels?: ('low' | 'medium' | 'high' | 'max')[];
+    supportsAdaptiveThinking?: boolean;
+    supportsFastMode?: boolean;
+}
+export interface AgentOptions {
+    /** LLM model ID */
+    model?: string;
+    /**
+     * API type: 'anthropic-messages' or 'openai-completions'.
+     * Falls back to CLAUDEBUDDY_API_TYPE env var. Default: 'anthropic-messages'.
+     */
+    apiType?: import('./providers/types.js').ApiType;
+    /** API key. Falls back to CLAUDEBUDDY_API_KEY env var. */
+    apiKey?: string;
+    /** API base URL override */
+    baseURL?: string;
+    /** Working directory for file/shell tools */
+    cwd?: string;
+    /** System prompt override or preset */
+    systemPrompt?: string | {
+        type: 'preset';
+        preset: 'default';
+        append?: string;
+    };
+    /** Append to default system prompt */
+    appendSystemPrompt?: string;
+    /** Available tools (ToolDefinition[] or string[] preset) */
+    tools?: ToolDefinition[] | string[] | {
+        type: 'preset';
+        preset: 'default';
+    };
+    /** Maximum number of agentic turns per query */
+    maxTurns?: number;
+    /** Maximum USD budget per query */
+    maxBudgetUsd?: number;
+    /** Extended thinking configuration */
+    thinking?: ThinkingConfig;
+    /** Maximum thinking tokens (deprecated, use thinking.budgetTokens) */
+    maxThinkingTokens?: number;
+    /** Structured output JSON schema */
+    jsonSchema?: Record<string, unknown>;
+    /** Structured output format */
+    outputFormat?: OutputFormat;
+    /** Permission handler callback */
+    canUseTool?: CanUseToolFn;
+    /** Permission mode controlling tool approval behavior */
+    permissionMode?: PermissionMode;
+    /** Abort controller for cancellation */
+    abortController?: AbortController;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+    /** Whether to include partial streaming events */
+    includePartialMessages?: boolean;
+    /** Environment variables */
+    env?: Record<string, string | undefined>;
+    /** Tool names to pre-approve without prompting */
+    allowedTools?: string[];
+    /** Tool names to deny */
+    disallowedTools?: string[];
+    /** MCP server configurations */
+    mcpServers?: Record<string, McpServerConfig | any>;
+    /** Custom subagent definitions */
+    agents?: Record<string, AgentDefinition>;
+    /** Maximum tokens for responses */
+    maxTokens?: number;
+    /** Effort level for reasoning */
+    effort?: 'low' | 'medium' | 'high' | 'max';
+    /** Fallback model if primary is unavailable */
+    fallbackModel?: string;
+    /** Continue the most recent session in cwd */
+    continue?: boolean;
+    /** Resume a specific session by ID */
+    resume?: string;
+    /** Fork a session instead of continuing it */
+    forkSession?: boolean;
+    /** Persist session to disk */
+    persistSession?: boolean;
+    /**
+     * Conversation history to start from, instead of loading it from disk.
+     *
+     * Lets a host keep sessions in its own store (a database, say) and stay
+     * stateless: pass the prior turns here with `persistSession: false` and the
+     * SDK never touches the session files. Takes precedence over `resume`.
+     */
+    history?: NormalizedMessageParam[];
+    /** Explicit session ID */
+    sessionId?: string;
+    /** Enable file checkpointing (for rewindFiles) */
+    enableFileCheckpointing?: boolean;
+    /** Sandbox configuration */
+    sandbox?: SandboxSettings;
+    /** Load settings from filesystem */
+    settingSources?: SettingSource[];
+    /** Plugin configurations */
+    plugins?: Array<{
+        name: string;
+        config?: Record<string, unknown>;
+    }>;
+    /** Additional working directories */
+    additionalDirectories?: string[];
+    /** Default agent to use */
+    agent?: string;
+    /** Debug mode */
+    debug?: boolean;
+    /** Debug log file */
+    debugFile?: string;
+    /** Tool-specific configuration */
+    toolConfig?: Record<string, unknown>;
+    /** Enable prompt suggestions */
+    promptSuggestions?: boolean;
+    /** Strict MCP config validation */
+    strictMcpConfig?: boolean;
+    /** Extra CLI arguments */
+    extraArgs?: Record<string, string | null>;
+    /** SDK betas to enable */
+    betas?: string[];
+    /** Permission prompt tool name override */
+    permissionPromptToolName?: string;
+    /** Hook configurations */
+    hooks?: Record<string, Array<{
+        matcher?: string;
+        hooks: Array<(input: any, toolUseId: string, context: {
+            signal: AbortSignal;
+        }) => Promise<any>>;
+        timeout?: number;
+    }>>;
+    /** 模型上下文窗口大小（单位：tokens），不设置则按原有模型匹配逻辑 */
+    contextWindowSize?: number;
+    /** 模型定价（每百万 tokens，USD），不设置则按原有模型匹配逻辑 */
+    pricingPerMillion?: {
+        input: number;
+        output: number;
+    };
+    /**
+     * Spill 溢出配置：超长工具结果落盘，head/tail 预览 + locator 替换，
+     * 避免超大工具输出撑爆上下文。
+     */
+    spill?: {
+        /** 工具结果超过该字节数即落盘（默认 20000） */
+        maxInlineBytes?: number;
+        /** 给模型的 head/tail 预览字节数（默认 4000） */
+        previewBytes?: number;
+        /** 永不落盘的工具名（如 read，避免 read->spill->read 循环） */
+        neverSpillTools?: string[];
+        /**
+         * 只对这些工具启用落盘（白名单）。若提供非空数组，则仅列表中
+         * 的工具超限时才会 spill，其余工具走内联截断。
+         */
+        enabledFor?: string[];
+        /** 落盘目录（默认 <cwd>/.spill） */
+        spillDir?: string;
+    };
+    /**
+     * Goal 目标驱动循环：给一个目标让 agent 一直执行到完成/受阻。
+     * agent 空闲且无新输入时自动注入 continuation，完成判定交给
+     * `update_goal` 工具，`maxGoalRounds` 防止无限循环。
+     */
+    goal?: {
+        /** 是否启用目标驱动循环（默认 false） */
+        enabled?: boolean;
+        /**
+         * 当 query() 收到一个字符串 prompt 时，自动以该 prompt 为目标进入
+         * goal 驱动的自治循环（等价于显式调用 runGoal）。默认 false。
+         */
+        enabledOnQuery?: boolean;
+        /** 最大目标轮次，超过则强制停止（默认 10） */
+        maxGoalRounds?: number;
+        /** 连续 N 轮无进展即视为受阻停止（可选） */
+        maxConsecutiveStalls?: number;
+        /** 每个目标轮次内部的最大 turn 数（默认继承 maxTurns） */
+        turnsPerRound?: number;
+    } | boolean;
+}
+export interface QueryResult {
+    /** Final text output from the assistant */
+    text: string;
+    /** Token usage */
+    usage: TokenUsage;
+    /** Number of agentic turns */
+    num_turns: number;
+    /** Duration in milliseconds */
+    duration_ms: number;
+    /** All conversation messages */
+    messages: Message[];
+}
+export interface QueryEngineConfig {
+    cwd: string;
+    model: string;
+    /** LLM provider instance (created from apiType) */
+    provider: import('./providers/types.js').LLMProvider;
+    tools: ToolDefinition[];
+    systemPrompt?: string;
+    appendSystemPrompt?: string;
+    maxTurns: number;
+    maxBudgetUsd?: number;
+    maxTokens: number;
+    thinking?: ThinkingConfig;
+    jsonSchema?: Record<string, unknown>;
+    canUseTool: CanUseToolFn;
+    includePartialMessages: boolean;
+    abortSignal?: AbortSignal;
+    agents?: Record<string, AgentDefinition>;
+    /** Hook registry for lifecycle events */
+    hookRegistry?: import('./hooks.js').HookRegistry;
+    /** Session ID for hook context */
+    sessionId?: string;
+    contextWindowSize?: number;
+    pricingPerMillion?: {
+        input: number;
+        output: number;
+    };
+    /** Spill overflow configuration passed to the engine. */
+    spill?: NonNullable<AgentOptions['spill']>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for the Agent SDK
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/compact.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Context Compression / Auto-Compaction
+ *
+ * Summarizes long conversation histories when context window fills up.
+ * Three-tier system:
+ * 1. Auto-compact: triggered when tokens exceed threshold
+ * 2. Micro-compact: cache-aware per-request optimization
+ * 3. Session memory compaction: consolidates across sessions
+ */
+import type { LLMProvider } from '../providers/types.js';
+import type { NormalizedMessageParam } from '../providers/types.js';
+/**
+ * State for tracking auto-compaction across turns.
+ */
+export interface AutoCompactState {
+    compacted: boolean;
+    turnCounter: number;
+    consecutiveFailures: number;
+}
+/**
+ * Create initial auto-compact state.
+ */
+export declare function createAutoCompactState(): AutoCompactState;
+/**
+ * Check if auto-compaction should trigger.
+ */
+export declare function shouldAutoCompact(messages: any[], model: string, state: AutoCompactState, contextWindowSize?: number): boolean;
+/**
+ * Compact conversation by summarizing with the LLM.
+ *
+ * Sends the entire conversation to the LLM for summarization,
+ * then replaces the history with a compact summary.
+ */
+export declare function compactConversation(provider: LLMProvider, model: string, messages: any[], state: AutoCompactState): Promise<{
+    compactedMessages: NormalizedMessageParam[];
+    summary: string;
+    state: AutoCompactState;
+}>;
+/**
+ * Micro-compact: optimize messages by truncating large tool results
+ * to fit within token budgets.
+ */
+export declare function microCompactMessages(messages: any[], maxToolResultChars?: number): any[];
+//# sourceMappingURL=compact.d.ts.map

package/dist/utils/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/utils/compact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAMnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAMzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,GAAG,EAAE,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,gBAAgB,EACvB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,GAAG,EAAE,EACf,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC;IACT,iBAAiB,EAAE,sBAAsB,EAAE,CAAA;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,gBAAgB,CAAA;CACxB,CAAC,CAwDD;AAqDD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,EAAE,EACf,kBAAkB,GAAE,MAAc,GACjC,GAAG,EAAE,CAsBP"}