toolpack-sdk 0.1.0-SNAPSHOT

package/dist/client/base-agent-context.d.ts

@@ -0,0 +1,16 @@
+export interface AgentContextOptions {
+    workingDirectory: string;
+    toolCategories: string[];
+    disabled?: boolean;
+    /** Whether to include working directory in the context. Default: true */
+    includeWorkingDirectory?: boolean;
+    /** Whether to include tool categories in the context. Default: true */
+    includeToolCategories?: boolean;
+}
+/**
+ * Generates the base agent context string that is always injected into the system prompt.
+ * This gives the AI baseline awareness of its environment and tools, ensuring proactive behavior
+ * regardless of the active mode or consumer configuration.
+ */
+export declare function generateBaseAgentContext(options: AgentContextOptions): string;
+//# sourceMappingURL=base-agent-context.d.ts.map

package/dist/client/base-agent-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent-context.d.ts","sourceRoot":"","sources":["../../src/client/base-agent-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAmB7E"}

package/dist/client/base-agent-context.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBaseAgentContext = generateBaseAgentContext;
+/**
+ * Generates the base agent context string that is always injected into the system prompt.
+ * This gives the AI baseline awareness of its environment and tools, ensuring proactive behavior
+ * regardless of the active mode or consumer configuration.
+ */
+function generateBaseAgentContext(options) {
+    if (options.disabled) {
+        return '';
+    }
+    const includeWd = options.includeWorkingDirectory !== false;
+    const includeCategories = options.includeToolCategories !== false;
+    const wdLine = includeWd ? `\nWorking directory: ${options.workingDirectory}` : '';
+    const categoriesList = includeCategories && options.toolCategories.length > 0
+        ? `\nAvailable tool categories: ${options.toolCategories.join(', ')}`
+        : '';
+    return `You are an AI assistant with access to tools that let you interact with the user's system.${wdLine}${categoriesList}
+
+When the user asks you to do something, be proactive:
+- Use your tools to find information rather than asking the user for details you can discover yourself
+- Read files, list directories, and explore the codebase when asked to analyze or understand a project
+- Only ask the user for clarification when you genuinely cannot determine their intent or lack the required tools`;
+}
+//# sourceMappingURL=base-agent-context.js.map

package/dist/client/base-agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent-context.js","sourceRoot":"","sources":["../../src/client/base-agent-context.ts"],"names":[],"mappings":";;AAeA,4DAmBC;AAxBD;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,OAA4B;IACjE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,uBAAuB,KAAK,KAAK,CAAC;IAC5D,MAAM,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,KAAK,KAAK,CAAC;IAElE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,wBAAwB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,cAAc,GAAG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QACzE,CAAC,CAAC,gCAAgC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrE,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,6FAA6F,MAAM,GAAG,cAAc;;;;;kHAKb,CAAC;AACnH,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,142 @@
+import { EventEmitter } from 'events';
+import { ProviderAdapter } from '../providers/base';
+import { CompletionRequest, CompletionResponse, CompletionChunk, EmbeddingRequest, EmbeddingResponse } from '../types';
+import { ToolRegistry } from '../tools/registry.js';
+import { ToolsConfig } from '../tools/types.js';
+import { ModeConfig } from '../modes/mode-types.js';
+export interface AIClientConfig {
+    providers: Record<string, ProviderAdapter>;
+    defaultProvider?: string;
+    toolRegistry?: ToolRegistry;
+    toolsConfig?: ToolsConfig;
+    systemPrompt?: string;
+    disableBaseContext?: boolean;
+}
+export declare class AIClient extends EventEmitter {
+    private providers;
+    private defaultProvider?;
+    private toolRegistry?;
+    private toolsConfig;
+    private toolRouter;
+    private bm25Engine;
+    private queryClassifier;
+    private toolOrchestrator;
+    private activeMode;
+    private overrideSystemPrompt?;
+    private disableBaseContext;
+    constructor(config: AIClientConfig);
+    /**
+     * Register a new provider instance.
+     */
+    registerProvider(name: string, provider: ProviderAdapter): void;
+    /**
+     * Get a provider by name, or the default if none specified.
+     */
+    getProvider(name?: string): ProviderAdapter;
+    /**
+     * Set the default provider for this client.
+     */
+    setDefaultProvider(name: string): void;
+    /**
+     * Get the tool registry.
+     */
+    getToolRegistry(): ToolRegistry | undefined;
+    /**
+     * Get all registered providers.
+     * Returns a copy of the internal map to prevent direct mutation.
+     */
+    getProviders(): Map<string, ProviderAdapter>;
+    /**
+     * Set or replace the tool registry.
+     */
+    setToolRegistry(registry: ToolRegistry): void;
+    /**
+     * Update tools config.
+     */
+    setToolsConfig(config: ToolsConfig): void;
+    /**
+     * Set the override system prompt directly via code.
+     */
+    setSystemPrompt(prompt: string | undefined): void;
+    /**
+     * Set the active mode. Pass null to clear.
+     */
+    setMode(mode: ModeConfig | null): void;
+    /**
+     * Get the currently active mode.
+     */
+    getMode(): ModeConfig | null;
+    /**
+     * Re-index tools for BM25 search.
+     * Call this after adding/removing tools from the registry.
+     */
+    reindexTools(): void;
+    /**
+     * Clear the tool discovery cache (call when starting a new conversation).
+     */
+    clearToolDiscoveryCache(): void;
+    /**
+     * unified generate completion
+     * 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>;
+    /**
+     * unified stream completion
+     * When tools are enabled and autoExecute is true, handles tool calls
+     * by collecting them, executing, and re-calling the model.
+     */
+    stream(request: CompletionRequest, providerName?: string): AsyncGenerator<CompletionChunk>;
+    /**
+     * unified embed
+     */
+    embed(request: EmbeddingRequest, providerName?: string): Promise<EmbeddingResponse>;
+    /**
+     * Enrich a request with tools based on the router config.
+     * Applies mode-based tool filtering when an active mode is set.
+     */
+    private enrichRequestWithTools;
+    /**
+     * Filter tool schemas based on mode permissions.
+     * blockedTools/blockedToolCategories always take precedence.
+     */
+    private filterSchemasByMode;
+    /**
+     * Inject the active mode's system prompt into the request messages.
+     * For the "All" mode (empty systemPrompt), this is a no-op.
+     */
+    private injectModeSystemPrompt;
+    /**
+     * Inject the overriding system prompt (from AIClientConfig) into the request.
+     */
+    private injectOverrideSystemPrompt;
+    /**
+     * Inject the Base Agent Context into the request.
+     * Tells the agent its CWD, tools, and to be proactive.
+     */
+    private injectBaseAgentContext;
+    /**
+     * Inject Tool Search system prompt to guide AI to use tool.search.
+     */
+    private injectToolSearchPrompt;
+    /**
+     * Execute a single tool call via the registry.
+     * Emits 'tool:started', 'tool:completed', and 'tool:failed' events.
+     */
+    private executeTool;
+    /**
+     * Find similar tool name to detect hallucinations.
+     * Detects common patterns like underscore vs dot (fs_delete_file vs fs.delete_file).
+     */
+    private findSimilarToolName;
+    /**
+     * Calculate Levenshtein distance between two strings.
+     */
+    private levenshteinDistance;
+    /**
+     * Execute tool.search using BM25 engine.
+     */
+    private executeToolSearch;
+    private wrapError;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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