toolpack-sdk 2.1.1 → 2.2.0

package/dist/index.d.cts

@@ -1,4 +1,7 @@
+import * as zod from 'zod';
 import { EventEmitter } from 'events';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+export { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
 
 /**
  * Core type definitions for the Tool Calling System.
@@ -26,6 +29,45 @@ interface ToolContext {
     /** Scoped logger — writes to toolpack-sdk.log */
     log: (message: string) => void;
 }
+/**
+ * Hints about tool behaviour sent to MCP clients in tools/list.
+ * All fields are optional — clients use them for safety UX (e.g. confirmation
+ * dialogs before destructive actions) but must not rely on them for security.
+ *
+ * MCP spec defaults when annotations are omitted entirely:
+ *   readOnlyHint: false, destructiveHint: true, openWorldHint: true, idempotentHint: false
+ *
+ * The MCP server auto-derives annotations when this field is not set:
+ *   - confirmation present → { destructiveHint: true }
+ *   - neither set          → annotations omitted (MCP spec defaults apply)
+ * Set explicitly to override.
+ */
+interface ToolAnnotations {
+    /**
+     * Tool only reads data — never writes, calls APIs, or modifies state.
+     * MCP spec default (when absent): false.
+     * Set to true for pure read tools: fs.read_file, search, list-dir.
+     */
+    readOnlyHint?: boolean;
+    /**
+     * Tool may cause irreversible side-effects (delete, overwrite, deploy, send).
+     * MCP spec default (when absent): true — clients assume worst case.
+     * Set to false for safe write operations (e.g. create-if-not-exists).
+     */
+    destructiveHint?: boolean;
+    /**
+     * Calling the tool multiple times with the same args has no additional effect.
+     * MCP spec default (when absent): false.
+     * Set to true for idempotent operations.
+     */
+    idempotentHint?: boolean;
+    /**
+     * Tool may interact with external systems: web, APIs, databases, shell, filesystem.
+     * MCP spec default (when absent): true.
+     * Set to false only for purely in-process, local tools with no side-effects.
+     */
+    openWorldHint?: boolean;
+}
 type ConfirmationLevel$1 = 'high' | 'medium';
 interface ToolConfirmation {
     level: ConfirmationLevel$1;
@@ -51,6 +93,15 @@ interface ToolDefinition {
      * Note: Only effective when onToolConfirm callback is provided to AIClient.
      */
     confirmation?: ToolConfirmation;
+    /**
+     * MCP annotation hints describing tool behaviour to clients.
+     * When omitted, the MCP server auto-derives from `confirmation`:
+     *   - confirmation set  → { destructiveHint: true }
+     *   - no confirmation   → annotations omitted (MCP spec defaults apply)
+     * Set explicitly to override — particularly useful for marking read-only tools
+     * (readOnlyHint: true) or idempotent tools (idempotentHint: true).
+     */
+    annotations?: ToolAnnotations;
 }
 /**
  * Schema-only version of ToolDefinition (no execute function).
@@ -68,6 +119,8 @@ interface ToolSchema {
      * Default: true
      */
     cacheable?: boolean;
+    /** MCP annotation hints. See ToolAnnotations for details. */
+    annotations?: ToolAnnotations;
 }
 interface ToolProjectManifest {
     key: string;
@@ -227,13 +280,30 @@ interface ToolCallResult {
     result?: string;
     duration?: number;
 }
-interface CompletionRequest {
+interface CompletionRequest<T = unknown> {
     messages: Message[];
     model: string;
     temperature?: number;
     max_tokens?: number;
     top_p?: number;
-    response_format?: 'text' | 'json_object';
+    /**
+     * Controls the output format:
+     * - `'text'`        — plain text (default)
+     * - `'json_object'` — unstructured JSON; you parse `response.content` yourself
+     * - `ZodType<T>`    — structured JSON matching the schema; parsed and validated result
+     *                     available in `response.data` as fully typed `T`
+     *
+     * @example structured output
+     * ```typescript
+     * import { z } from 'zod'
+     * const result = await sdk.generate({
+     *   messages,
+     *   response_format: z.object({ sentiment: z.string(), score: z.number() }),
+     * })
+     * result.data.sentiment // typed as string
+     * ```
+     */
+    response_format?: 'text' | 'json_object' | zod.ZodType<T>;
     stream?: boolean;
     tools?: ToolCallRequest[];
     requestTools?: RequestToolDefinition[];
@@ -255,8 +325,14 @@ interface Usage {
     completion_tokens?: number;
     total_tokens: number;
 }
-interface CompletionResponse {
+interface CompletionResponse<T = unknown> {
     content: string | null;
+    /**
+     * Parsed and validated structured output.
+     * Only present when `response_format` is a ZodType.
+     * TypeScript type is inferred from the schema via the generic on `generate<T>()`.
+     */
+    data?: T;
     usage?: Usage;
     /** Detailed breakdown of token usage when executed in agent/workflow mode */
     usage_details?: {
@@ -1251,7 +1327,7 @@ declare class AIClient extends EventEmitter {
      * When tools are enabled and autoExecute is true, handles the full
      * tool call → execute → send result → get final answer loop.
      */
-    generate(request: CompletionRequest, providerName?: string): Promise<CompletionResponse>;
+    generate<T = unknown>(request: CompletionRequest<T>, providerName?: string): Promise<CompletionResponse<T>>;
     /**
      * unified stream completion
      * When tools are enabled and autoExecute is true, handles tool calls
@@ -1314,7 +1390,7 @@ declare class AIClient extends EventEmitter {
     /**
      * Execute tool.search using BM25 engine.
      */
-    private executeToolSearch;
+    executeToolSearch(args: Record<string, any>): string;
     private wrapError;
     /**
      * Truncate a tool result to fit within the remaining round budget.
@@ -2072,8 +2148,12 @@ declare const execRunShellTool: ToolDefinition;
 
 declare const execRunBackgroundTool: ToolDefinition;
 
+declare const execRunBlockingTool: ToolDefinition;
+
 declare const execReadOutputTool: ToolDefinition;
 
+declare const execTailOutputTool: ToolDefinition;
+
 declare const execKillTool: ToolDefinition;
 
 declare const execListProcessesTool: ToolDefinition;
@@ -2588,6 +2668,210 @@ type ToolpackInterceptor = {
     init?(): Promise<void>;
 };
 
+type McpTransport = 'stdio' | 'http';
+
+interface McpServerExposeConfig {
+    /** Expose only tools in these categories. Mutually exclusive with `tools`. */
+    categories?: string[];
+    /** Expose only these exact tool names. Mutually exclusive with `categories`. */
+    tools?: string[];
+}
+interface McpStaticAuthConfig {
+    mode: 'static';
+    /**
+     * One or more pre-shared bearer tokens that grant access.
+     * Generate with: crypto.randomBytes(32).toString('hex')
+     * All tokens in the array are valid — useful for token rotation.
+     */
+    tokens: string[];
+}
+interface McpJwtAuthConfig {
+    mode: 'jwt';
+    /**
+     * JWKS endpoint URL for JWT signature verification.
+     * @example 'https://your-tenant.auth0.com/.well-known/jwks.json'
+     * @example 'https://your-project.supabase.co/auth/v1/jwks'
+     */
+    jwksUrl: string;
+    /**
+     * Expected `aud` claim in the JWT.
+     * Required for most OIDC providers — omitting may accept tokens intended for other services.
+     */
+    audience?: string;
+    /**
+     * Expected `iss` claim in the JWT. Recommended.
+     * Also used to populate the `authorization_servers` field in
+     * /.well-known/oauth-protected-resource when serverUrl is set.
+     */
+    issuer?: string;
+    /** JWT must have all of these scopes. Checked after signature verification. */
+    requiredScopes?: string[];
+}
+interface McpCustomAuthConfig {
+    mode: 'custom';
+    /**
+     * Your own token verification logic.
+     * Throw any error to reject the token — the caller receives a 401.
+     * Return a valid AuthInfo on success.
+     *
+     * @example
+     * ```typescript
+     * verifyAccessToken: async (token) => {
+     *   const user = await db.findByToken(token);
+     *   if (!user) throw new Error('Invalid token');
+     *   return { token, clientId: user.id, scopes: user.scopes };
+     * }
+     * ```
+     */
+    verifyAccessToken(token: string): Promise<AuthInfo>;
+    /** Token must have all of these scopes. Checked after verifyAccessToken resolves. */
+    requiredScopes?: string[];
+}
+type McpAuthConfig = McpStaticAuthConfig | McpJwtAuthConfig | McpCustomAuthConfig;
+/**
+ * Minimal contract for exposing an agent as an MCP tool.
+ * Satisfied by McpChannel.asAgentDefinition() from toolpack-agents,
+ * or by any plain object with these four fields.
+ */
+interface McpAgentDefinition {
+    /** Exposed as "agent.<name>" in tools/list. Must be unique across all agents. */
+    name: string;
+    /** Shown to the MCP client as the tool description. */
+    description: string;
+    /** JSON Schema for the arguments the agent accepts. Defaults to empty object schema. */
+    inputSchema?: Record<string, unknown>;
+    /**
+     * Called when tools/call arrives for this agent.
+     * Must return the agent's output as a string.
+     * Throw to signal an error — the MCP client receives isError: true.
+     */
+    invoke(args: Record<string, unknown>): Promise<string>;
+}
+interface ToolpackMcpServerConfig {
+    /** Transport type. 'stdio' for Claude Desktop / Cursor. 'http' for remote use. */
+    transport: McpTransport;
+    /** Port for HTTP transport. Default: 3000. Only used when transport is 'http'. */
+    port?: number;
+    /** Filter which tools to expose. Exposes all enabled tools when omitted. */
+    expose?: McpServerExposeConfig;
+    /** Server name shown to MCP clients. Default: 'Toolpack SDK'. */
+    serverName?: string;
+    /** Server version shown to MCP clients. Default: '2.0.0'. */
+    serverVersion?: string;
+    /**
+     * Authentication for the HTTP transport. Ignored when transport is 'stdio'.
+     *
+     * When omitted, the HTTP server accepts all requests — safe for localhost only.
+     * When set, every request must carry a valid Bearer token; missing or invalid
+     * tokens are rejected with 401. Scope violations are rejected with 403.
+     *
+     * @example Static tokens (dev / self-hosted)
+     * ```typescript
+     * auth: { mode: 'static', tokens: [process.env.MCP_TOKEN!] }
+     * ```
+     *
+     * @example JWT with Auth0 / Supabase / Clerk
+     * ```typescript
+     * auth: {
+     *   mode: 'jwt',
+     *   jwksUrl: 'https://your-tenant.auth0.com/.well-known/jwks.json',
+     *   audience: 'https://your-mcp-server.example.com',
+     *   issuer:   'https://your-tenant.auth0.com/',
+     * }
+     * ```
+     *
+     * @example Custom verification
+     * ```typescript
+     * auth: {
+     *   mode: 'custom',
+     *   verifyAccessToken: async (token) => {
+     *     const user = await db.findByToken(token);
+     *     if (!user) throw new Error('invalid');
+     *     return { token, clientId: user.id, scopes: user.scopes };
+     *   }
+     * }
+     * ```
+     */
+    auth?: McpAuthConfig;
+    /**
+     * Agents to expose as MCP tools alongside regular tools.
+     * Each agent appears in tools/list as "agent.<name>".
+     *
+     * Agents run to completion before returning — synchronous from the MCP
+     * client's perspective. For long-running agents, ensure the MCP client's
+     * timeout is set appropriately.
+     *
+     * The easiest way to produce an entry is via McpChannel.asAgentDefinition()
+     * from toolpack-agents. A plain object with { name, description, invoke }
+     * also works — no import from toolpack-agents required.
+     *
+     * @example using McpChannel (toolpack-agents)
+     * ```typescript
+     * const ch = new McpChannel();
+     * const agent = new PrReviewerAgent({ channels: [ch] });
+     * await agent.start();
+     * await sdk.startMcpServer({
+     *   transport: 'stdio',
+     *   agents: [ch.asAgentDefinition(agent)],
+     * });
+     * ```
+     *
+     * @example plain object (no extra dependency)
+     * ```typescript
+     * await sdk.startMcpServer({
+     *   transport: 'stdio',
+     *   agents: [{
+     *     name: 'pr_reviewer',
+     *     description: 'Reviews a pull request end-to-end.',
+     *     inputSchema: { type: 'object', properties: { pr_url: { type: 'string' } }, required: ['pr_url'] },
+     *     invoke: async (args) => {
+     *       const result = await prReviewer.invokeAgent({ data: args });
+     *       return result.output;
+     *     },
+     *   }],
+     * });
+     * ```
+     */
+    agents?: McpAgentDefinition[];
+    /**
+     * Enable tool search mode.
+     *
+     * When true, tools/list returns only `tool.search` plus any always-loaded tools
+     * configured in ToolSearchConfig (alwaysLoadedTools / alwaysLoadedCategories).
+     * MCP clients call `tool.search` first to discover tools on-demand, dramatically
+     * reducing context token usage for registries with 110+ tools.
+     *
+     * Requires the system prompt to instruct the client to use tool.search.
+     * See docs/examples/mcp-server-example.ts for the recommended prompt snippet.
+     *
+     * Default: false — all enabled tools sent upfront.
+     */
+    searchMode?: boolean;
+    /**
+     * Public base URL of this MCP server (e.g. 'https://mcp.example.com').
+     * Only used when auth.mode is 'jwt'.
+     *
+     * When provided alongside jwt auth, the server mounts
+     * /.well-known/oauth-protected-resource so MCP clients can
+     * auto-discover which OAuth server issues tokens for this server.
+     *
+     * Ignored for static and custom auth modes.
+     */
+    serverUrl?: string;
+}
+interface McpServerHandle {
+    /** Stop the MCP server and release all resources. */
+    stop(): Promise<void>;
+    /** Number of tools currently exposed. */
+    toolCount: number;
+    /**
+     * Actual bound port (HTTP transport only). Useful when port:0 is passed and
+     * the OS assigns a free port — integration tests read this to know where to connect.
+     * Always 0 for stdio transport.
+     */
+    port: number;
+}
+
 interface ProviderOptions {
     /**
      * API key for the provider.
@@ -2793,6 +3077,67 @@ declare class Toolpack extends EventEmitter {
      * Validates dependencies and registers all tools.
      */
     loadToolProject(project: ToolProject): Promise<void>;
+    /**
+     * Expose Toolpack's built-in tools as an MCP server.
+     *
+     * Any MCP-compatible client (Claude Desktop, Cursor, Windsurf, custom agents)
+     * can connect and use the full tool catalog without importing this SDK.
+     *
+     * Requires `@modelcontextprotocol/sdk` to be installed:
+     *   npm install @modelcontextprotocol/sdk
+     *
+     * @example stdio — Claude Desktop / Cursor
+     * ```typescript
+     * const sdk = await Toolpack.init({ provider: 'anthropic', tools: true });
+     * await sdk.startMcpServer({ transport: 'stdio' });
+     * ```
+     *
+     * @example HTTP — open (localhost only)
+     * ```typescript
+     * await sdk.startMcpServer({ transport: 'http', port: 3000 });
+     * ```
+     *
+     * @example HTTP — with static bearer token auth (dev / self-hosted)
+     * ```typescript
+     * await sdk.startMcpServer({
+     *   transport: 'http',
+     *   port: 3000,
+     *   auth: { mode: 'static', tokens: [process.env.MCP_TOKEN!] },
+     * });
+     * ```
+     *
+     * @example HTTP — with JWT auth (Auth0 / Supabase / Clerk / any OIDC provider)
+     * ```typescript
+     * await sdk.startMcpServer({
+     *   transport: 'http',
+     *   port: 3000,
+     *   auth: {
+     *     mode: 'jwt',
+     *     jwksUrl: 'https://your-tenant.auth0.com/.well-known/jwks.json',
+     *     audience: 'https://your-mcp-server.example.com',
+     *     issuer:   'https://your-tenant.auth0.com/',
+     *   },
+     *   serverUrl: 'https://your-mcp-server.example.com',
+     * });
+     * ```
+     *
+     * @example expose only specific categories
+     * ```typescript
+     * await sdk.startMcpServer({
+     *   transport: 'stdio',
+     *   expose: { categories: ['filesystem', 'github', 'slack'] },
+     * });
+     * ```
+     *
+     * @example search mode — reduces context token usage for 110+ tools
+     * ```typescript
+     * // tools/list returns only tool.search; clients discover tools on-demand.
+     * // Add this to your system prompt:
+     * //   "Use tool.search to discover tools before calling them."
+     * await sdk.startMcpServer({ transport: 'stdio', searchMode: true });
+     * ```
+     */
+    startMcpServer(config: ToolpackMcpServerConfig): Promise<McpServerHandle>;
     /**
      * Convenience method to get a flat list of all models across all providers.
      */
@@ -3346,4 +3691,4 @@ interface McpServerCapabilities {
 
 declare function createSkillInterceptor(options?: SkillInterceptorOptions): ToolpackInterceptor;
 
-export { AGENT_MODE, AGENT_PLANNING_PROMPT, AGENT_WORKFLOW, AIClient, type AIClientConfig, type AddBypassRuleOptions, AnthropicAdapter, type AssembledPrompt, type AssemblerOptions, AuthenticationError, BM25SearchEngine, BUILT_IN_MODES, type BypassRuleType, CHAT_MODE, CHAT_WORKFLOW, CODING_MODE, CODING_PLANNING_PROMPT, CODING_WORKFLOW, CONFIG_DIR_NAME, CONFIG_FILE_NAME, type CompletionChunk, type CompletionOptions, type CompletionRequest, type CompletionResponse, type ConfirmationDecision, type ConfirmationLevel$1 as ConfirmationLevel, ConnectionError, type ContextPrunedEvent, type ContextWindowConfig, ContextWindowConfigError, ContextWindowExceededError, type ContextWindowExceededEvent, type ContextWindowState, ContextWindowStateManager, type ContextWindowStrategy, type ContextWindowWarningEvent, ConversationNotFoundError, type ConversationScope, type ConversationSearchOptions, type ConversationStore, type ConversationSummarizedEvent, DEFAULT_MODE_NAME, DEFAULT_TOOLS_CONFIG, DEFAULT_TOOL_SEARCH_CONFIG, DEFAULT_WORKFLOW, DEFAULT_WORKFLOW_CONFIG, type EmbeddingRequest, type EmbeddingResponse, type FileUploadRequest, type FileUploadResponse, GeminiAdapter, type GetOptions, type HitlConfig, type ImageDataPart, type ImageFilePart, type ImagePart, type ImageUrlPart, InMemoryConversationStore, type InMemoryConversationStoreConfig, InsufficientContextError, InvalidRequestError, type JsonRpcRequest, type JsonRpcResponse, type KnowledgeInstance, McpClient, type McpClientConfig, McpConnectionError, type McpServerCapabilities, type McpServerConfig, McpTimeoutError, type McpTool, McpToolManager, type McpToolsConfig, type MediaOptions, type MediaUploadStrategy, type Message, type MessageContent, type ModeBlockedHint, type ModeConfig, ModeRegistry, OllamaAdapter, type OllamaAdapterConfig, type OllamaModelInfo, OllamaProvider, type OllamaProviderEntry, type OnToolConfirmCallback, OpenAIAdapter, OpenRouterAdapter, type OpenRouterOptions, PageError, type Participant, type Plan, type PlanStep, Planner, type PromptMessage, ProviderAdapter, type ProviderConfig, ProviderError, type ProviderInfo, type ProviderModelInfo, type ProviderOptions, type PruneResult, RateLimitError, type RequestToolDefinition, type Role, type RuntimeConfigStatus, SDKError, SQLiteConversationStore, type SQLiteConversationStoreConfig, type SearchHistoryEntry, type SearchOptions, type SearchResult, type Skill, type SkillInterceptorOptions, type SkillSection, type SkillToolsOptions, type SkillValidationMode, type SlmModelEntry, type StoredMessage, SummarizationError, type SummarizationOptions, type SummarizationResult, TOOLPACK_DIR_NAME, TOOL_SEARCH_NAME, type TextPart, TimeoutError, type ToolCall, type ToolCallFunction, type ToolCallMessage, type ToolCallRequest, type ToolCallResult, type ToolCategory, type ToolConfirmation, type ToolConfirmationRequestedEvent, type ToolConfirmationResolvedEvent, type ToolContext, type ToolDefinition, ToolDiscoveryCache, type ToolLogEvent, type ToolParameterProperty, type ToolParameters, type ToolProgressEvent, type ToolProject, type ToolProjectDependencies, type ToolProjectManifest, ToolRegistry, type ToolResult, ToolRouter, type ToolSchema, type ToolSearchConfig, Toolpack, type ToolpackConfig, type ToolpackInitConfig, type ToolpackInterceptor, type ToolpackNextFunction, type ToolsConfig, type Usage, VertexAIAdapter, type VertexAIConfig, type WorkflowConfig, type WorkflowEvents, WorkflowExecutor, type WorkflowProgress, type WorkflowResult, addBypassRule, buildSummarizedHistory, cloudDeployTool, cloudListTool, cloudStatusTool, cloudToolsProject, codingExtractFunctionTool, codingFindReferencesTool, codingFindSymbolTool, codingGetCallHierarchyTool, codingGetDiagnosticsTool, codingGetExportsTool, codingGetImportsTool, codingGetOutlineTool, codingGetSymbolsTool, codingGoToDefinitionTool, codingMultiFileEditTool, codingRefactorRenameTool, codingToolsProject, countTokens, createContextWindowStateManager, createMcpToolProject, createMode, createSkillInterceptor, createSkillTools, createSummarizationReport, createSummarySystemMessage, createToolProject, dbCountTool, dbDeleteTool, dbInsertTool, dbQueryTool, dbSchemaTool, dbTablesTool, dbToolsProject, dbUpdateTool, diffApplyTool, diffCreateTool, diffPreviewTool, diffToolsProject, disconnectMcpToolProject, ensureGlobalConfigDir, ensureLocalConfigDir, estimateSummaryTokens, estimateTokenCount, execKillTool, execListProcessesTool, execReadOutputTool, execRunBackgroundTool, execRunShellTool, execRunTool, execToolsProject, extractConversationKeypoints, fetchUrlAsBase64, fsAppendFileTool, fsBatchReadTool, fsBatchWriteTool, fsCopyTool, fsCreateDirTool, fsDeleteDirTool, fsDeleteFileTool, fsExistsTool, fsGlobTool, fsListDirTool, fsMoveTool, fsReadFileRangeTool, fsReadFileTool, fsReplaceInFileTool, fsSearchTool, fsStatTool, fsToolsProject, fsTreeTool, fsWriteFileTool, generateSummarizationPrompt, generateToolCategoriesPrompt, getContextWindowPercentage, getDefaultSlmModel, getGlobalConfigDir, getGlobalConfigPath, getGlobalToolpackDir, getLocalConfigDir, getLocalConfigPath, getLocalToolpackDir, getMessageStats, getMimeType, getOllamaBaseUrl, getOllamaProviderEntries, getRegisteredSlmModels, getRuntimeConfigStatus, getSafeOutputReserve, getToolSearchSchema, getToolpackConfig, getUserHomeDir, gitAddTool, gitBlameTool, gitBranchCreateTool, gitBranchListTool, gitCheckoutTool, gitCloneTool, gitCommitTool, gitDiffTool, gitLogTool, gitStatusTool, gitToolsProject, githubContentsGetTextTool, githubGraphqlExecuteTool, githubIssuesCommentsCreateTool, githubPrDiffGetTool, githubPrFilesListTool, githubPrReviewCommentsReplyTool, githubPrReviewThreadsListTool, githubPrReviewThreadsResolveTool, githubPrReviewsSubmitTool, githubToolsProject, groupMessagesByRole, handleContextWindowError, httpDeleteTool, httpDownloadTool, httpGetTool, httpPostTool, httpPutTool, httpToolsProject, initializeGlobalConfigIfFirstRun, isContextWindowError, isDataUri, isRegisteredSlm, isToolSearchTool, k8sApplyManifestTool, k8sDeleteResourceTool, k8sDescribeTool, k8sGetConfigMapTool, k8sGetLogsTool, k8sGetNamespacesTool, k8sListDeploymentsTool, k8sListPodsTool, k8sListServicesTool, k8sSwitchContextTool, k8sToolsProject, k8sWaitForDeploymentTool, loadFullConfig, loadRuntimeConfig, loadToolsConfig, mergeSummarizationResults, normalizeImagePart, ollamaRequest, ollamaStream, parseDataUri, parseSummarizationResponse, prepareSummarizationRequest, pruneMessages, readFileAsBase64, reloadToolpackConfig, removeBypassRule, saveToolsConfig, slackAuthTestTool, slackChatPostEphemeralTool, slackChatPostMessageTool, slackConversationsHistoryTool, slackConversationsRepliesTool, slackReactionsAddTool, slackToolsProject, systemCwdTool, systemDiskUsageTool, systemEnvTool, systemInfoTool, systemSetEnvTool, systemToolsProject, toDataUri, toolSearchDefinition, truncateMessage, validateSummarizationResult, webExtractLinksTool, webFeedTool, webFetchTool, webMapTool, webMetadataTool, webScrapeTool, webScreenshotTool, webSearchTool, webSitemapTool, webToolsProject, wouldExceedContextWindow };
+export { AGENT_MODE, AGENT_PLANNING_PROMPT, AGENT_WORKFLOW, AIClient, type AIClientConfig, type AddBypassRuleOptions, AnthropicAdapter, type AssembledPrompt, type AssemblerOptions, AuthenticationError, BM25SearchEngine, BUILT_IN_MODES, type BypassRuleType, CHAT_MODE, CHAT_WORKFLOW, CODING_MODE, CODING_PLANNING_PROMPT, CODING_WORKFLOW, CONFIG_DIR_NAME, CONFIG_FILE_NAME, type CompletionChunk, type CompletionOptions, type CompletionRequest, type CompletionResponse, type ConfirmationDecision, type ConfirmationLevel$1 as ConfirmationLevel, ConnectionError, type ContextPrunedEvent, type ContextWindowConfig, ContextWindowConfigError, ContextWindowExceededError, type ContextWindowExceededEvent, type ContextWindowState, ContextWindowStateManager, type ContextWindowStrategy, type ContextWindowWarningEvent, ConversationNotFoundError, type ConversationScope, type ConversationSearchOptions, type ConversationStore, type ConversationSummarizedEvent, DEFAULT_MODE_NAME, DEFAULT_TOOLS_CONFIG, DEFAULT_TOOL_SEARCH_CONFIG, DEFAULT_WORKFLOW, DEFAULT_WORKFLOW_CONFIG, type EmbeddingRequest, type EmbeddingResponse, type FileUploadRequest, type FileUploadResponse, GeminiAdapter, type GetOptions, type HitlConfig, type ImageDataPart, type ImageFilePart, type ImagePart, type ImageUrlPart, InMemoryConversationStore, type InMemoryConversationStoreConfig, InsufficientContextError, InvalidRequestError, type JsonRpcRequest, type JsonRpcResponse, type KnowledgeInstance, type McpAgentDefinition, type McpAuthConfig, McpClient, type McpClientConfig, McpConnectionError, type McpCustomAuthConfig, type McpJwtAuthConfig, type McpServerCapabilities, type McpServerConfig, type McpServerExposeConfig, type McpServerHandle, type McpStaticAuthConfig, McpTimeoutError, type McpTool, McpToolManager, type McpToolsConfig, type McpTransport, type MediaOptions, type MediaUploadStrategy, type Message, type MessageContent, type ModeBlockedHint, type ModeConfig, ModeRegistry, OllamaAdapter, type OllamaAdapterConfig, type OllamaModelInfo, OllamaProvider, type OllamaProviderEntry, type OnToolConfirmCallback, OpenAIAdapter, OpenRouterAdapter, type OpenRouterOptions, PageError, type Participant, type Plan, type PlanStep, Planner, type PromptMessage, ProviderAdapter, type ProviderConfig, ProviderError, type ProviderInfo, type ProviderModelInfo, type ProviderOptions, type PruneResult, RateLimitError, type RequestToolDefinition, type Role, type RuntimeConfigStatus, SDKError, SQLiteConversationStore, type SQLiteConversationStoreConfig, type SearchHistoryEntry, type SearchOptions, type SearchResult, type Skill, type SkillInterceptorOptions, type SkillSection, type SkillToolsOptions, type SkillValidationMode, type SlmModelEntry, type StoredMessage, SummarizationError, type SummarizationOptions, type SummarizationResult, TOOLPACK_DIR_NAME, TOOL_SEARCH_NAME, type TextPart, TimeoutError, type ToolAnnotations, type ToolCall, type ToolCallFunction, type ToolCallMessage, type ToolCallRequest, type ToolCallResult, type ToolCategory, type ToolConfirmation, type ToolConfirmationRequestedEvent, type ToolConfirmationResolvedEvent, type ToolContext, type ToolDefinition, ToolDiscoveryCache, type ToolLogEvent, type ToolParameterProperty, type ToolParameters, type ToolProgressEvent, type ToolProject, type ToolProjectDependencies, type ToolProjectManifest, ToolRegistry, type ToolResult, ToolRouter, type ToolSchema, type ToolSearchConfig, Toolpack, type ToolpackConfig, type ToolpackInitConfig, type ToolpackInterceptor, type ToolpackMcpServerConfig, type ToolpackNextFunction, type ToolsConfig, type Usage, VertexAIAdapter, type VertexAIConfig, type WorkflowConfig, type WorkflowEvents, WorkflowExecutor, type WorkflowProgress, type WorkflowResult, addBypassRule, buildSummarizedHistory, cloudDeployTool, cloudListTool, cloudStatusTool, cloudToolsProject, codingExtractFunctionTool, codingFindReferencesTool, codingFindSymbolTool, codingGetCallHierarchyTool, codingGetDiagnosticsTool, codingGetExportsTool, codingGetImportsTool, codingGetOutlineTool, codingGetSymbolsTool, codingGoToDefinitionTool, codingMultiFileEditTool, codingRefactorRenameTool, codingToolsProject, countTokens, createContextWindowStateManager, createMcpToolProject, createMode, createSkillInterceptor, createSkillTools, createSummarizationReport, createSummarySystemMessage, createToolProject, dbCountTool, dbDeleteTool, dbInsertTool, dbQueryTool, dbSchemaTool, dbTablesTool, dbToolsProject, dbUpdateTool, diffApplyTool, diffCreateTool, diffPreviewTool, diffToolsProject, disconnectMcpToolProject, ensureGlobalConfigDir, ensureLocalConfigDir, estimateSummaryTokens, estimateTokenCount, execKillTool, execListProcessesTool, execReadOutputTool, execRunBackgroundTool, execRunBlockingTool, execRunShellTool, execRunTool, execTailOutputTool, execToolsProject, extractConversationKeypoints, fetchUrlAsBase64, fsAppendFileTool, fsBatchReadTool, fsBatchWriteTool, fsCopyTool, fsCreateDirTool, fsDeleteDirTool, fsDeleteFileTool, fsExistsTool, fsGlobTool, fsListDirTool, fsMoveTool, fsReadFileRangeTool, fsReadFileTool, fsReplaceInFileTool, fsSearchTool, fsStatTool, fsToolsProject, fsTreeTool, fsWriteFileTool, generateSummarizationPrompt, generateToolCategoriesPrompt, getContextWindowPercentage, getDefaultSlmModel, getGlobalConfigDir, getGlobalConfigPath, getGlobalToolpackDir, getLocalConfigDir, getLocalConfigPath, getLocalToolpackDir, getMessageStats, getMimeType, getOllamaBaseUrl, getOllamaProviderEntries, getRegisteredSlmModels, getRuntimeConfigStatus, getSafeOutputReserve, getToolSearchSchema, getToolpackConfig, getUserHomeDir, gitAddTool, gitBlameTool, gitBranchCreateTool, gitBranchListTool, gitCheckoutTool, gitCloneTool, gitCommitTool, gitDiffTool, gitLogTool, gitStatusTool, gitToolsProject, githubContentsGetTextTool, githubGraphqlExecuteTool, githubIssuesCommentsCreateTool, githubPrDiffGetTool, githubPrFilesListTool, githubPrReviewCommentsReplyTool, githubPrReviewThreadsListTool, githubPrReviewThreadsResolveTool, githubPrReviewsSubmitTool, githubToolsProject, groupMessagesByRole, handleContextWindowError, httpDeleteTool, httpDownloadTool, httpGetTool, httpPostTool, httpPutTool, httpToolsProject, initializeGlobalConfigIfFirstRun, isContextWindowError, isDataUri, isRegisteredSlm, isToolSearchTool, k8sApplyManifestTool, k8sDeleteResourceTool, k8sDescribeTool, k8sGetConfigMapTool, k8sGetLogsTool, k8sGetNamespacesTool, k8sListDeploymentsTool, k8sListPodsTool, k8sListServicesTool, k8sSwitchContextTool, k8sToolsProject, k8sWaitForDeploymentTool, loadFullConfig, loadRuntimeConfig, loadToolsConfig, mergeSummarizationResults, normalizeImagePart, ollamaRequest, ollamaStream, parseDataUri, parseSummarizationResponse, prepareSummarizationRequest, pruneMessages, readFileAsBase64, reloadToolpackConfig, removeBypassRule, saveToolsConfig, slackAuthTestTool, slackChatPostEphemeralTool, slackChatPostMessageTool, slackConversationsHistoryTool, slackConversationsRepliesTool, slackReactionsAddTool, slackToolsProject, systemCwdTool, systemDiskUsageTool, systemEnvTool, systemInfoTool, systemSetEnvTool, systemToolsProject, toDataUri, toolSearchDefinition, truncateMessage, validateSummarizationResult, webExtractLinksTool, webFeedTool, webFetchTool, webMapTool, webMetadataTool, webScrapeTool, webScreenshotTool, webSearchTool, webSitemapTool, webToolsProject, wouldExceedContextWindow };