@nodetool-ai/runtime 0.7.0-rc.11

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

@@ -0,0 +1,107 @@
+/**
+ * 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 { 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";
+/**
+ * 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`).
+ */
+export declare class ClaudeAgentError extends Error {
+    readonly kind: ClaudeAgentErrorKind;
+    constructor(kind: ClaudeAgentErrorKind, message: string, cause?: unknown);
+}
+/**
+ * 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 {
+    static requiredSecrets(): string[];
+    /**
+     * Maps threadId → Claude SDK session ID.
+     * Allows resuming conversations across multiple generateMessages() calls.
+     */
+    private _sessions;
+    constructor(_secrets?: Record<string, unknown>);
+    hasToolSupport(_model: string): Promise<boolean>;
+    getAvailableLanguageModels(): Promise<LanguageModel[]>;
+    /**
+     * Extract the system prompt and the last user message from the messages array.
+     */
+    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;
+    /**
+     * Build an in-process MCP server from ProviderTool definitions.
+     * Each tool's handler calls the onToolCall callback.
+     */
+    private buildMcpServer;
+    generateMessages(args: {
+        messages: Message[];
+        model: string;
+        tools?: ProviderTool[];
+        toolChoice?: string | "any";
+        maxTokens?: number;
+        temperature?: number;
+        topP?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        audio?: Record<string, unknown>;
+        thinkingBudget?: number;
+        threadId?: string | null;
+        /** Callback for tool execution. Required when tools are provided. */
+        onToolCall?: OnToolCall;
+        signal?: AbortSignal;
+    }): AsyncGenerator<ProviderStreamItem>;
+    generateMessage(args: {
+        messages: Message[];
+        model: string;
+        tools?: ProviderTool[];
+        maxTokens?: number;
+        temperature?: number;
+        topP?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        thinkingBudget?: number;
+        threadId?: string | null;
+        onToolCall?: OnToolCall;
+    }): Promise<Message>;
+    private describeErrorSubtype;
+    isContextLengthError(error: unknown): boolean;
+    isAuthError(error: unknown): boolean;
+    isRateLimitError(error: unknown): boolean;
+}
+//# sourceMappingURL=claude-agent-provider.d.ts.map

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

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