toolpack-sdk 2.0.0-alpha.1 → 2.1.0

package/dist/index.d.cts

@@ -104,13 +104,6 @@ interface ToolCategory {
     description: string;
     tools: string[];
 }
-/**
- * @deprecated This interface is deprecated and will be removed in a future version.
- */
-interface IntelligentToolDetectionConfig {
-    enabled: boolean;
-    maxFollowUpMessages: number;
-}
 /**
  * Tool Search Configuration (Anthropic-style on-demand tool discovery)
  */
@@ -127,10 +120,6 @@ interface ToolsConfig {
     maxToolRounds: number;
     toolChoicePolicy?: 'auto' | 'required' | 'required_for_actions';
     resultMaxChars?: number;
-    /**
-     * @deprecated This feature is deprecated and will be removed in a future version. Use `toolSearch` instead.
-     */
-    intelligentToolDetection?: IntelligentToolDetectionConfig;
     enabledTools: string[];
     enabledToolCategories: string[];
     toolSearch?: ToolSearchConfig;
@@ -253,6 +242,13 @@ interface CompletionRequest {
     signal?: AbortSignal;
     /** Multimodal media handling options */
     mediaOptions?: MediaOptions;
+    /**
+     * Per-request hard cap on tool-call rounds.
+     * When set, overrides ToolsConfig.maxToolRounds and bypasses the query
+     * classifier adjustment for this specific request.
+     * Useful for agents that should only ever make one tool call (e.g. routers).
+     */
+    maxToolRounds?: number;
 }
 interface Usage {
     prompt_tokens: number;
@@ -824,24 +820,6 @@ interface WorkflowConfig {
         /** Maximum number of steps allowed in a plan. Default: 20 */
         maxSteps?: number;
     };
-    /**
-     * Step-based execution configuration.
-     * If enabled, tasks are broken into steps and executed sequentially.
-     */
-    steps?: {
-        /** Enable step-based execution. Default: false */
-        enabled: boolean;
-        /** Retry failed steps. Default: true */
-        retryOnFailure?: boolean;
-        /** Maximum retry attempts per step. Default: 3 */
-        maxRetries?: number;
-        /** Allow adding/modifying steps during execution. Default: true */
-        allowDynamicSteps?: boolean;
-        /** Maximum total steps (including dynamic). Default: 50 */
-        maxTotalSteps?: number;
-        /** Custom step execution prompt. Default: uses built-in STEP_EXECUTION_PROMPT */
-        stepPrompt?: string;
-    };
     /**
      * Progress reporting configuration.
      */
@@ -851,13 +829,6 @@ interface WorkflowConfig {
         /** Report estimated completion percentage. Default: true */
         reportPercentage?: boolean;
     };
-    /**
-     * Failure handling configuration.
-     */
-    onFailure?: {
-        /** Strategy when a step fails after all retries. Default: 'abort' */
-        strategy: 'abort' | 'skip' | 'ask_user';
-    };
     /**
      * Query complexity routing configuration.
      * Routes simple queries to faster execution paths based on query classification.
@@ -872,7 +843,7 @@ interface WorkflowConfig {
     };
 }
 /**
- * Default workflow config (direct execution, no planning/steps).
+ * Default workflow config (direct execution, no planning).
  */
 declare const DEFAULT_WORKFLOW_CONFIG: WorkflowConfig;
 interface WorkflowEvents {
@@ -882,16 +853,6 @@ interface WorkflowEvents {
     'workflow:plan_decision': (plan: Plan, approved: boolean) => void;
     /** Emitted when plan execution starts */
     'workflow:started': (plan: Plan) => void;
-    /** Emitted when a step starts */
-    'workflow:step_start': (step: PlanStep, plan: Plan) => void;
-    /** Emitted when a step completes successfully */
-    'workflow:step_complete': (step: PlanStep, plan: Plan) => void;
-    /** Emitted when a step fails */
-    'workflow:step_failed': (step: PlanStep, error: Error, plan: Plan) => void;
-    /** Emitted when a step is retried */
-    'workflow:step_retry': (step: PlanStep, attempt: number, plan: Plan) => void;
-    /** Emitted when a new step is dynamically added */
-    'workflow:step_added': (step: PlanStep, plan: Plan) => void;
     /** Emitted for progress updates */
     'workflow:progress': (progress: WorkflowProgress) => void;
     /** Emitted when context window usage is high (approaching limit) */
@@ -1030,6 +991,15 @@ interface ModeConfig {
      * Shorthand for "no tool calls at all".
      */
     blockAllTools: boolean;
+    /**
+     * Response format constraint for all requests in this mode.
+     * - 'json_object': instructs the model to return valid JSON as its text content.
+     *   Useful for evaluator/parser agents whose final response must be machine-readable.
+     *   Tool-call rounds are unaffected — the model still returns functionCall parts
+     *   normally; the format only applies to text content.
+     * - 'text' (default): plain text, no constraint.
+     */
+    response_format?: 'text' | 'json_object';
 }
 /**
  * A lightweight reference to a mode, used in tool-blocked hints.
@@ -1346,6 +1316,12 @@ declare class AIClient extends EventEmitter {
      */
     private executeToolSearch;
     private wrapError;
+    /**
+     * Truncate a tool result to fit within the remaining round budget.
+     * Instead of silently dropping the output, include as much content as possible
+     * and append an actionable hint so the LLM can retry with a narrower query.
+     */
+    private budgetTruncate;
 }
 
 declare class AnthropicAdapter extends ProviderAdapter {
@@ -1384,6 +1360,43 @@ declare class AnthropicAdapter extends ProviderAdapter {
     private handleError;
 }
 
+interface VertexAIConfig {
+    /** GCP project ID. Falls back to TOOLPACK_VERTEXAI_PROJECT or VERTEX_AI_PROJECT env vars. */
+    projectId?: string;
+    /** GCP region. Defaults to 'us-central1'. Falls back to TOOLPACK_VERTEXAI_LOCATION or VERTEX_AI_LOCATION env vars. */
+    location?: string;
+    /**
+     * Optional Google Auth options.
+     * When omitted, Application Default Credentials (ADC) are used automatically.
+     * Set GOOGLE_APPLICATION_CREDENTIALS env var to point to a service account JSON file.
+     */
+    googleAuthOptions?: {
+        /** Path to a service account key JSON file. */
+        keyFilename?: string;
+        /** Inline service account credentials object. */
+        credentials?: Record<string, unknown>;
+    };
+}
+declare class VertexAIAdapter extends ProviderAdapter {
+    private ai;
+    private readonly location;
+    constructor(config?: VertexAIConfig);
+    getDisplayName(): string;
+    getModels(): Promise<ProviderModelInfo[]>;
+    generate(request: CompletionRequest): Promise<CompletionResponse>;
+    stream(request: CompletionRequest): AsyncGenerator<CompletionChunk>;
+    embed(_request: EmbeddingRequest): Promise<EmbeddingResponse>;
+    private buildRequestParams;
+    private formatHistory;
+    private contentToParts;
+    private parseResponse;
+    private extractSystemInstruction;
+    private sanitizeToolName;
+    private restoreToolName;
+    private sanitizeSchema;
+    private handleError;
+}
+
 declare class GeminiAdapter extends ProviderAdapter {
     private genAI;
     constructor(apiKey: string);
@@ -2043,6 +2056,14 @@ declare const fsReplaceInFileTool: ToolDefinition;
 
 declare const fsTreeTool: ToolDefinition;
 
+declare const fsGlobTool: ToolDefinition;
+
+declare const fsDeleteDirTool: ToolDefinition;
+
+declare const fsBatchReadTool: ToolDefinition;
+
+declare const fsBatchWriteTool: ToolDefinition;
+
 declare const fsToolsProject: ToolProject;
 
 declare const execRunTool: ToolDefinition;
@@ -2099,6 +2120,8 @@ declare const githubPrFilesListTool: ToolDefinition;
 
 declare const githubPrReviewsSubmitTool: ToolDefinition;
 
+declare const githubIssuesCommentsCreateTool: ToolDefinition;
+
 declare const githubToolsProject: ToolProject;
 
 declare const webFetchTool: ToolDefinition;
@@ -2109,6 +2132,16 @@ declare const webScrapeTool: ToolDefinition;
 
 declare const webExtractLinksTool: ToolDefinition;
 
+declare const webMapTool: ToolDefinition;
+
+declare const webMetadataTool: ToolDefinition;
+
+declare const webSitemapTool: ToolDefinition;
+
+declare const webFeedTool: ToolDefinition;
+
+declare const webScreenshotTool: ToolDefinition;
+
 declare const webToolsProject: ToolProject;
 
 declare const codingFindSymbolTool: ToolDefinition;
@@ -2117,6 +2150,24 @@ declare const codingGetSymbolsTool: ToolDefinition;
 
 declare const codingGetImportsTool: ToolDefinition;
 
+declare const codingFindReferencesTool: ToolDefinition;
+
+declare const codingGoToDefinitionTool: ToolDefinition;
+
+declare const codingMultiFileEditTool: ToolDefinition;
+
+declare const codingRefactorRenameTool: ToolDefinition;
+
+declare const codingGetOutlineTool: ToolDefinition;
+
+declare const codingGetDiagnosticsTool: ToolDefinition;
+
+declare const codingGetExportsTool: ToolDefinition;
+
+declare const codingExtractFunctionTool: ToolDefinition;
+
+declare const codingGetCallHierarchyTool: ToolDefinition;
+
 declare const codingToolsProject: ToolProject;
 
 declare const gitStatusTool: ToolDefinition;
@@ -2137,6 +2188,8 @@ declare const gitBranchCreateTool: ToolDefinition;
 
 declare const gitCheckoutTool: ToolDefinition;
 
+declare const gitCloneTool: ToolDefinition;
+
 declare const gitToolsProject: ToolProject;
 
 declare const diffCreateTool: ToolDefinition;
@@ -2185,6 +2238,56 @@ declare const k8sWaitForDeploymentTool: ToolDefinition;
 
 declare const k8sToolsProject: ToolProject;
 
+declare const slackChatPostMessageTool: ToolDefinition;
+
+declare const slackChatPostEphemeralTool: ToolDefinition;
+
+declare const slackReactionsAddTool: ToolDefinition;
+
+declare const slackConversationsHistoryTool: ToolDefinition;
+
+declare const slackConversationsRepliesTool: ToolDefinition;
+
+declare const slackAuthTestTool: ToolDefinition;
+
+declare const slackToolsProject: ToolProject;
+
+type SkillSection = 'description' | 'triggers' | 'instructions' | 'examples' | 'metadata' | 'all';
+type SkillValidationMode = 'fail' | 'warn';
+interface Skill {
+    name: string;
+    title: string;
+    version?: string;
+    tags: string[];
+    category?: string;
+    filePath: string;
+    description: string;
+    triggers: string[];
+    instructions: string;
+    examples?: string;
+    lastModified: number;
+}
+interface SkillInterceptorOptions {
+    dir?: string;
+    maxSkills?: number;
+    minScore?: number;
+    onValidationError?: SkillValidationMode;
+}
+interface SkillToolsOptions {
+    /** Skills directory. Default: '.toolpack/skills' */
+    dir?: string;
+}
+
+/**
+ * Creates a ToolProject with 4 skill management tools: create, read, update, list.
+ *
+ * @example
+ * ```ts
+ * const skillTools = createSkillTools({ dir: '.toolpack/skills' });
+ * ```
+ */
+declare function createSkillTools(options?: SkillToolsOptions): ToolProject;
+
 /**
  * Central registry for AI agent modes (built-in + custom).
  * Handles registration, lookup, cycling, and defaults.
@@ -2269,6 +2372,11 @@ declare function createMode(config: {
     blockedTools?: string[];
     /** If true, no tools at all (pure conversation). Default: false. */
     blockAllTools?: boolean;
+    /**
+     * Response format for all requests in this mode.
+     * Use 'json_object' for evaluator/parser agents that must return valid JSON.
+     */
+    response_format?: 'text' | 'json_object';
     /** Base context configuration. Controls working directory and tool category injection. */
     baseContext?: {
         includeWorkingDirectory?: boolean;
@@ -2281,11 +2389,6 @@ declare function createMode(config: {
             enabled: boolean;
             requireApproval?: boolean;
         };
-        steps?: {
-            enabled: boolean;
-            retryOnFailure?: boolean;
-            allowDynamicSteps?: boolean;
-        };
         progress?: {
             enabled: boolean;
         };
@@ -2344,39 +2447,10 @@ declare class Planner {
     private createFallbackPlan;
 }
 
-declare class StepExecutor {
-    private client;
-    private config?;
-    constructor(client: AIClient, config?: WorkflowConfig['steps']);
-    /**
-     * Executes a single step of the plan using the full tool loop.
-     */
-    executeStep(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): Promise<NonNullable<PlanStep['result']>>;
-    /**
-     * Stream a single step execution, yielding chunks as they come.
-     */
-    streamStep(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): AsyncGenerator<CompletionChunk>;
-    /**
-     * Build a context-aware request for a specific step, including previous step results
-     * as conversation history so the AI knows what work was already done.
-     */
-    private buildStepRequest;
-    /**
-     * Optional: Check if the AI wants to add steps dynamically based on what just happened.
-     */
-    checkForDynamicSteps(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): Promise<PlanStep[]>;
-    /**
-     * Normalize step description for duplicate detection.
-     * Strips common variations to catch semantically similar steps.
-     */
-    private normalizeStepDescription;
-}
-
 declare class WorkflowExecutor extends EventEmitter {
     private client;
     private config;
     private planner;
-    private stepExecutor;
     private queryClassifier;
     private pendingApprovals;
     constructor(client: AIClient, config: WorkflowConfig, queryClassifier?: QueryClassifier);
@@ -2395,6 +2469,10 @@ declare class WorkflowExecutor extends EventEmitter {
     private shouldRouteSimpleQuery;
     /**
      * Execute a request using the configured workflow.
+     *
+     * Modes:
+     *   - Direct:       no planning — single generate() call
+     *   - Plan-direct:  planning generates a roadmap, then executes in one generate() call
      */
     execute(request: CompletionRequest, providerName?: string): Promise<WorkflowResult>;
     /**
@@ -2406,39 +2484,31 @@ declare class WorkflowExecutor extends EventEmitter {
      */
     private createPlan;
     /**
-     * Execute plan step by step using the StepExecutor.
-     */
-    private executeStepByStep;
-    /**
-     * Planning without steps — execute plan as single generate call.
+     * Planning without steps — inject plan as context prefix and execute in one generate() call.
+     * The LLM sees its own roadmap and uses it to guide tool usage and sequencing.
      */
     private executePlanDirect;
     /**
-     * Emit a progress event using StepTracker.
+     * Emit a progress event.
+     * @param percentageOverride - Optional fixed percentage (0–100). Use for plan-direct
+     *   mode where steps complete atomically and intermediate step-level progress is unavailable.
      */
     private emitProgress;
     /**
      * Compute metrics for the plan.
      */
     private computeMetrics;
-    /**
-     * Summarize the entire plan execution.
-     */
-    private summarizePlanResult;
-    /**
-     * Extract the final output from the plan.
-     * For plans with synthesis step: returns last step output.
-     * For plans without synthesis: concatenates all step outputs.
-     */
-    private extractFinalOutput;
-    /**
-     * Extract the full response metadata from the last completed step.
-     */
-    private extractFinalResponse;
     /**
      * Create a dummy plan for internal representation when no plan is generated.
      */
     private createDummyPlan;
+    /**
+     * Inject plan context as a system message.
+     * If the request already has a leading system message (e.g., a mode system prompt),
+     * merge the plan context into it to avoid sending multiple system messages to providers
+     * that don't support or handle them inconsistently.
+     */
+    private injectPlanContext;
     /**
      * Execute a request using the configured workflow, yielding chunks as they come.
      * This is the streaming equivalent of execute().
@@ -2449,11 +2519,8 @@ declare class WorkflowExecutor extends EventEmitter {
      */
     private streamDirect;
     /**
-     * Stream plan execution step by step.
-     */
-    private streamStepByStep;
-    /**
-     * Stream plan execution as a single request (planning without steps).
+     * Stream plan execution as a single request (plan-direct).
+     * Injects the plan as a system prefix so the LLM uses it as its own roadmap.
      */
     private streamPlanDirect;
     /**
@@ -2475,19 +2542,16 @@ declare class WorkflowExecutor extends EventEmitter {
  * Full detailed planning for general autonomous tasks.
  */
 declare const AGENT_PLANNING_PROMPT = "\nYou are a planning assistant. Given a user request, create a detailed step-by-step plan.\n\nRules:\n1. Break the task into clear, actionable steps\n2. Each step should be independently executable WITHOUT requiring additional user input\n3. Order steps by dependencies (what must happen first)\n4. Be specific about what each step will accomplish\n5. Estimate which tools will be needed for each step\n6. If the user's request is ambiguous, make reasonable assumptions and proceed - do NOT create steps that ask for clarification\n7. Steps should produce concrete outputs, not ask questions or wait for user input\n8. ALWAYS include at least one step, even for simple questions. For simple factual questions, create a single step like \"Provide the answer to [question]\"\n9. When a step uses information gathered by a previous step, set \"dependsOn\" to that step's number and phrase the description as \"Using the [data] from step N, [do something]\" instead of gathering it again\n10. For plans with MORE than 2 steps, the final step must synthesize the workflow's results into a concise deliverable, avoiding redundant word-for-word repetition of earlier step outputs. For plans with 1-2 steps, no synthesis step is needed.\n11. The exact result MUST be valid JSON matching this schema:\n{\n  \"summary\": \"Brief description of the overall goal\",\n  \"steps\": [\n    {\n      \"number\": 1,\n      \"description\": \"What this step does\",\n      \"expectedTools\": [\"tool.name\"],\n      \"dependsOn\": []\n    }\n  ]\n}\n";
-/**
- * Agent step execution prompt.
- * Standard execution with detailed instructions.
- */
-declare const AGENT_STEP_PROMPT = "\nYou are executing step {stepNumber} of a plan.\n\nPlan summary: {planSummary}\n\nCurrent step: {stepDescription}\n\nPrevious steps completed:\n{previousStepsResults}\n\nExecute this step now. Use the available tools as needed to accomplish this specific step.\nMake reasonable assumptions if any details are ambiguous - do NOT ask the user for clarification or additional input.\nProduce concrete results based on the information available.\nIf you cannot complete this step, explain why.\n\nIMPORTANT: Your response should be written as if you are directly answering the user.\nDo NOT mention steps, plans, workflow details, or internal process in your response.\nDo NOT say things like \"Step 1 is complete\" or \"proceeding to the next step\".\nJust provide the actual answer or result naturally.\n";
 /**
  * Default workflow configuration.
- * Direct execution with no planning or steps.
+ * Direct execution with no planning.
  */
 declare const DEFAULT_WORKFLOW: WorkflowConfig;
 /**
  * Agent workflow configuration.
- * Full planning and step execution with dynamic steps disabled.
+ * Plan-direct: planning phase generates a structured roadmap, then executes in a single
+ * generate() call with full tool parallelism. Simpler queries bypass planning via
+ * complexity routing.
  */
 declare const AGENT_WORKFLOW: WorkflowConfig;
 /**
@@ -2495,22 +2559,35 @@ declare const AGENT_WORKFLOW: WorkflowConfig;
  * Minimal rules focused on actionable code changes.
  */
 declare const CODING_PLANNING_PROMPT = "\nCreate a step-by-step plan for this coding task.\n\nRules:\n1. Break into actionable steps using tools (read/write files, search code)\n2. Each step executes independently without user input\n3. Order by dependencies\n4. Individual steps: be concise and technical. No conversational filler.\n5. For >2 steps, final step summarizes changes with conversational explanation\n6. Output valid JSON: {\"summary\": \"...\", \"steps\": [{...}]}\n\nJSON Schema:\n{\n  \"summary\": \"Brief description of the overall goal\",\n  \"steps\": [\n    {\n      \"number\": 1,\n      \"description\": \"What this step does\",\n      \"expectedTools\": [\"tool.name\"],\n      \"dependsOn\": []\n    }\n  ]\n}\n";
-/**
- * Concise step execution prompt for coding tasks.
- * No meta-commentary, focused on tool usage.
- */
-declare const CODING_STEP_PROMPT = "\nExecute step {stepNumber}: {stepDescription}\n\nPlan: {planSummary}\n\nPrevious: {previousStepsResults}\n\nUse tools. Be concise. Show code changes clearly.\nNo meta-commentary about steps or workflow.\n";
 /**
  * Coding workflow configuration.
- * Concise prompts optimized for software development tasks.
+ * Plan-direct: planning phase generates a structured roadmap using concise coding-focused prompts,
+ * then executes in a single generate() call with full tool parallelism.
  */
 declare const CODING_WORKFLOW: WorkflowConfig;
 /**
  * Chat workflow configuration.
- * No planning or steps - direct conversational responses.
+ * Direct conversational responses — no planning.
  */
 declare const CHAT_WORKFLOW: WorkflowConfig;
 
+type ToolpackNextFunction = (request?: CompletionRequest) => Promise<CompletionResponse>;
+/**
+ * An interceptor that wraps each `generate()` call.
+ *
+ * It is a callable with an optional `init()` hook. When `init()` is present,
+ * `Toolpack.init()` calls it once during startup — before any message is
+ * processed — so interceptors can validate config, warm caches, or fail fast
+ * on bad state (e.g. invalid skill files) rather than failing on the first request.
+ *
+ * Plain arrow functions without `init` are fully compatible with this type.
+ */
+type ToolpackInterceptor = {
+    (request: CompletionRequest, next: ToolpackNextFunction): Promise<CompletionResponse>;
+    /** Optional startup hook called once by `Toolpack.init()`. */
+    init?(): Promise<void>;
+};
+
 interface ProviderOptions {
     /**
      * API key for the provider.
@@ -2527,6 +2604,15 @@ interface ProviderOptions {
     siteUrl?: string;
     /** OpenRouter only: your site name for the leaderboard/attribution header */
     siteName?: string;
+    /** Vertex AI only: GCP project ID. Falls back to TOOLPACK_VERTEXAI_PROJECT / VERTEX_AI_PROJECT / GOOGLE_CLOUD_PROJECT env vars. */
+    projectId?: string;
+    /** Vertex AI only: GCP region. Defaults to 'us-central1'. Falls back to TOOLPACK_VERTEXAI_LOCATION / VERTEX_AI_LOCATION env vars. */
+    location?: string;
+    /** Vertex AI only: optional Google Auth options (keyFilename or credentials). When omitted, ADC is used. */
+    googleAuthOptions?: {
+        keyFilename?: string;
+        credentials?: Record<string, unknown>;
+    };
 }
 interface ToolpackInitConfig {
     /** Single provider shorthand (e.g. 'openai', 'anthropic', 'gemini') */
@@ -2538,6 +2624,15 @@ interface ToolpackInitConfig {
     apiKey?: string;
     /** Model name for the single provider */
     model?: string;
+    /** Vertex AI only: GCP project ID. Falls back to TOOLPACK_VERTEXAI_PROJECT / VERTEX_AI_PROJECT / GOOGLE_CLOUD_PROJECT env vars. */
+    projectId?: string;
+    /** Vertex AI only: GCP region. Defaults to 'us-central1'. */
+    location?: string;
+    /** Vertex AI only: optional Google Auth options. When omitted, ADC is used automatically. */
+    googleAuthOptions?: {
+        keyFilename?: string;
+        credentials?: Record<string, unknown>;
+    };
     /** Load built-in tools (fs, http, etc.)? Default: false */
     tools?: boolean;
     /** Context window management configuration for automatic conversation pruning/summarization */
@@ -2594,6 +2689,15 @@ interface ToolpackInitConfig {
     }) => Promise<ConfirmationDecision>;
     /** Optional conversation ID for tracking context across confirmations */
     conversationId?: string;
+    /**
+     * Optional interceptors that wrap each `generate()` call in the direct execution path.
+     * Each interceptor receives the full CompletionRequest and a `next()` function.
+     * Interceptors run in order (first in array runs outermost).
+     *
+     * Note: interceptors apply to `generate()` only, not `stream()`.
+     * The workflow execution path (when a mode has planning enabled) is also unaffected.
+     */
+    interceptors?: ToolpackInterceptor[];
 }
 /**
  * Duck-typed interface for Knowledge instances to avoid circular dependency
@@ -2636,6 +2740,7 @@ declare class Toolpack extends EventEmitter {
     private knowledgeLayers;
     customProviderNames: Set<string>;
     private mcpToolProject;
+    private _interceptors;
     private constructor();
     private buildKnowledgeRequestTools;
     private prepareRequest;
@@ -2651,6 +2756,7 @@ declare class Toolpack extends EventEmitter {
      */
     private static createProvider;
     generate(request: CompletionRequest | string, providerName?: string): Promise<CompletionResponse>;
+    private _buildInterceptorChain;
     stream(request: CompletionRequest, providerName?: string): AsyncGenerator<CompletionChunk>;
     embed(request: EmbeddingRequest, providerName?: string): Promise<EmbeddingResponse>;
     /**
@@ -3238,4 +3344,6 @@ interface McpServerCapabilities {
     prompts?: Record<string, any>;
 }
 
-export { AGENT_MODE, AGENT_PLANNING_PROMPT, AGENT_STEP_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_STEP_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, type IntelligentToolDetectionConfig, 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 SlmModelEntry, StepExecutor, 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 ToolsConfig, type Usage, type WorkflowConfig, type WorkflowEvents, WorkflowExecutor, type WorkflowProgress, type WorkflowResult, addBypassRule, buildSummarizedHistory, cloudDeployTool, cloudListTool, cloudStatusTool, cloudToolsProject, codingFindSymbolTool, codingGetImportsTool, codingGetSymbolsTool, codingToolsProject, countTokens, createContextWindowStateManager, createMcpToolProject, createMode, 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, fsCopyTool, fsCreateDirTool, fsDeleteFileTool, fsExistsTool, 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, gitCommitTool, gitDiffTool, gitLogTool, gitStatusTool, gitToolsProject, githubContentsGetTextTool, githubGraphqlExecuteTool, 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, systemCwdTool, systemDiskUsageTool, systemEnvTool, systemInfoTool, systemSetEnvTool, systemToolsProject, toDataUri, toolSearchDefinition, truncateMessage, validateSummarizationResult, webExtractLinksTool, webFetchTool, webScrapeTool, webSearchTool, webToolsProject, wouldExceedContextWindow };
+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 };