@nodetool-ai/runtime 0.7.0-rc.23 → 0.8.2

package/dist/providers/claude-agent-provider.d.ts

@@ -1,113 +1,146 @@
-/**
- * Claude Agent Provider
- *
- * Uses the Claude Agent SDK (@anthropic-ai/claude-agent-sdk) to interact with
- * Claude through the user's Claude subscription (Claude Pro/Max/Team).
- *
- * Requirements:
- * - Claude Code CLI installed and authenticated (`claude` command available)
- * - Active Claude subscription
- * - @anthropic-ai/claude-agent-sdk package installed
- *
- * This provider does NOT require an ANTHROPIC_API_KEY — it uses the Claude Code
- * session which authenticates through the user's Claude subscription.
- *
- * Tool support: tools are exposed as an in-process MCP server via the SDK's
- * createSdkMcpServer() + tool() helpers. Claude calls tools natively through
- * the MCP protocol; the provider yields ToolCall items for tracking.
- * An onToolCall callback must be supplied for tool execution.
- */
+import type { McpSdkServerConfigWithInstance, Options, SdkMcpToolDefinition, SDKMessage, SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";
 import { BaseProvider } from "./base-provider.js";
-import type { LanguageModel, Message, ProviderStreamItem, ProviderTool } from "./types.js";
-/**
- * Categories of failures surfaced by the Claude Agent provider.
- * Used to give the user actionable guidance rather than a raw SDK message.
- */
-export type ClaudeAgentErrorKind = "sdk_not_installed" | "cli_not_found" | "running_as_root" | "auth" | "rate_limit" | "context_length" | "invalid_model" | "aborted" | "max_turns" | "execution" | "unknown";
+import { type LanguageModel, type Message, type MessageContent, type ProviderSession, type ProviderStreamItem, type ProviderSkill, type ProviderTool, type ToolCall } from "./types.js";
+import type { RunBudget, TurnBudget } from "../turn-budget.js";
 /**
- * Error thrown by the Claude Agent provider. Carries a categorised `kind`
- * alongside a user-facing message so callers (UI, CLI) can decide how to
- * render the failure (e.g. show a "Sign in" button for `auth`).
+ * The subset of the SDK `query` signature this provider depends on. We only
+ * pass a string for text-only turns or a structured user message for images,
+ * and consume the result as an async iterable. Injectable for tests.
  */
-export declare class ClaudeAgentError extends Error {
-    readonly kind: ClaudeAgentErrorKind;
-    constructor(kind: ClaudeAgentErrorKind, message: string, cause?: unknown);
+export type ClaudeQueryFn = (params: {
+    prompt: string | AsyncIterable<SDKUserMessage>;
+    options?: Options;
+}) => AsyncIterable<SDKMessage>;
+/** The SDK `createSdkMcpServer` factory. Injectable for tests. */
+export type ClaudeCreateMcpServerFn = (opts: {
+    name: string;
+    version?: string;
+    tools: Array<SdkMcpToolDefinition>;
+}) => McpSdkServerConfigWithInstance;
+interface ClaudeAgentProviderOptions {
+    /**
+     * Inject the SDK `query` (tests). Defaults to the real `query`, lazily
+     * imported on first use so the browser worker bundle that pulls in this
+     * barrel never tries to bundle the Node-only SDK.
+     */
+    queryFn?: ClaudeQueryFn;
+    /** Inject the SDK `createSdkMcpServer` (tests). Defaults to the real one. */
+    createMcpServerFn?: ClaudeCreateMcpServerFn;
 }
-/**
- * Classify a raw error from the Claude Agent SDK (or its child process) into
- * a ClaudeAgentError with an actionable, user-facing message.
- */
-export declare function classifyClaudeAgentError(error: unknown): ClaudeAgentError;
-/**
- * Callback type for tool execution.
- * The provider calls this when Claude invokes a tool via MCP.
- * Returns the tool result as a string.
- */
-export type OnToolCall = (name: string, args: Record<string, unknown>) => Promise<string>;
 export declare class ClaudeAgentProvider extends BaseProvider {
+    /** The SDK runs with bypassPermissions, so its built-in `WebSearch` is live. */
+    get supportsNativeWebSearch(): boolean;
     static requiredSecrets(): string[];
+    private readonly injectedQueryFn;
+    private readonly injectedCreateMcpServerFn;
     /**
-     * Maps threadId → Claude SDK session ID.
-     * Allows resuming conversations across multiple generateMessages() calls.
+     * Within-process cache of the active session per thread. The persisted
+     * `provider_session` column is the source of truth; this only spares a DB
+     * round-trip for back-to-back turns in the same process.
      */
-    private _sessions;
-    constructor(_secrets?: Record<string, unknown>);
-    hasToolSupport(_model: string): Promise<boolean>;
-    getAvailableLanguageModels(): Promise<LanguageModel[]>;
+    private readonly sessions;
+    constructor(_secrets?: Record<string, unknown>, options?: ClaudeAgentProviderOptions);
+    /** The subscription token is the SDK's business — never hand it to a sandbox. */
+    getContainerEnv(): {};
     /**
-     * Extract the system prompt and the last user message from the messages array.
+     * Tools run inside the SDK's own agent loop ({@link generateLoop}): NodeTool's
+     * tools are exposed as an in-process MCP server whose handlers call back into
+     * the harness's tool executor. The single-turn {@link generateMessages} stays
+     * tool-free.
      */
-    private extractPrompt;
-    /** Look up an existing Claude session for the given threadId. */
-    getSessionId(threadId: string | null): string | undefined;
-    /** Store the Claude session ID for a threadId. */
-    setSessionId(threadId: string, sessionId: string): void;
-    /** Remove a stored session (e.g. when a conversation is closed). */
-    clearSession(threadId: string): void;
+    hasToolSupport(): Promise<boolean>;
+    /**
+     * Stable model aliases the SDK resolves to the latest dated model. Aliases
+     * avoid pinning a version that ages out; the concrete model id the SDK
+     * selects is captured from the stream for accurate cost attribution.
+     */
+    getAvailableLanguageModels(): Promise<LanguageModel[]>;
+    /** Resolve the SDK `query`, lazily importing it off the Node-only package. */
+    private loadQuery;
+    /** Resolve the SDK `createSdkMcpServer`, lazily importing the Node-only pkg. */
+    private loadCreateMcpServer;
     /**
-     * Build an in-process MCP server from ProviderTool definitions.
-     * Each tool's handler calls the onToolCall callback.
+     * Run the SDK's own agent loop. Tool-free turns behave exactly like
+     * {@link generateMessages}; with `tools` we expose them as an in-process MCP
+     * server whose handlers call `executeTool`, let the SDK loop (`maxTurns > 1`),
+     * and translate its `tool_use`/`tool_result` stream into ToolCall items and
+     * persistable {@link ProviderMessageEvent}s.
      */
-    private buildMcpServer;
+    generateLoop(args: Parameters<ClaudeAgentProvider["generateMessages"]>[0] & {
+        executeTool?: (toolCall: ToolCall) => Promise<string | MessageContent[]>;
+        resolveMedia?: (messages: Message[]) => Promise<Message[]>;
+        maxIterations?: number;
+        providedToolsOnly?: boolean;
+        turnBudget?: TurnBudget | RunBudget;
+        workspaceDir?: string;
+        /**
+         * The user's DB skills. Materialized into an isolated local plugin so the
+         * SDK's native `Skill` tool can list and load them on demand, keeping
+         * `settingSources: []` intact (no `~/.claude` / `CLAUDE.md` leakage). The
+         * caller hands these in instead of baking a skill catalog into the system
+         * prompt — this provider owns skill resolution.
+         */
+        skills?: ProviderSkill[];
+    }): AsyncGenerator<ProviderStreamItem>;
+    private generateSdkLoop;
     generateMessages(args: {
         messages: Message[];
         model: string;
         tools?: ProviderTool[];
         toolChoice?: string | "any";
         maxTokens?: number;
+        maxTurns?: number;
         temperature?: number;
         topP?: number;
         presencePenalty?: number;
         frequencyPenalty?: number;
         audio?: Record<string, unknown>;
-        thinkingBudget?: number;
         threadId?: string | null;
-        /**
-         * Upper bound on agentic turns inside the SDK query. Defaults to 100
-         * when tools are present (single-turn when not). Callers — typically
-         * AgentNode — can lift this for long-running sandbox sessions.
-         */
-        maxTurns?: number;
-        /** Callback for tool execution. Required when tools are provided. */
-        onToolCall?: OnToolCall;
+        providerSession?: ProviderSession | null;
+        loadFullHistory?: () => Promise<Message[]>;
+        onToolCall?: (name: string, args: Record<string, unknown>) => Promise<string>;
         signal?: AbortSignal;
     }): AsyncGenerator<ProviderStreamItem>;
+    /**
+     * Shared session machinery for {@link generateMessages} and
+     * {@link generateLoop}: decide resume vs fresh (best-effort, with a
+     * full-history priming fallback), then drive one SDK turn via {@link runTurn}.
+     * `config` selects single-turn streaming vs the tool/message-emitting loop.
+     */
+    private runWithSession;
+    /** Drive one SDK `query` turn and translate its messages into stream items. */
+    private runTurn;
+    /** Record token usage from a terminal `result` message (success or error). */
+    private trackResultUsage;
     generateMessage(args: {
         messages: Message[];
         model: string;
         tools?: ProviderTool[];
+        toolChoice?: string | "any";
         maxTokens?: number;
         temperature?: number;
         topP?: number;
         presencePenalty?: number;
         frequencyPenalty?: number;
-        thinkingBudget?: number;
         threadId?: string | null;
-        onToolCall?: OnToolCall;
+        providerSession?: ProviderSession | null;
+        onToolCall?: (name: string, args: Record<string, unknown>) => Promise<string>;
+        signal?: AbortSignal;
     }): Promise<Message>;
-    private describeErrorSubtype;
-    isContextLengthError(error: unknown): boolean;
-    isAuthError(error: unknown): boolean;
-    isRateLimitError(error: unknown): boolean;
 }
+type McpContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+/**
+ * Convert a tool result into MCP content blocks. Text passes through; image
+ * parts become MCP image blocks (the SDK forwards them to Claude as real
+ * images). An image that can't be inlined becomes a failure note.
+ */
+export declare function toolResultToMcpContent(result: string | MessageContent[]): McpContentBlock[];
+export {};
 //# sourceMappingURL=claude-agent-provider.d.ts.map

package/dist/providers/claude-agent-provider.d.ts.map

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