toolpack-sdk 0.1.0-SNAPSHOT

package/dist/providers/provider-logger.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_VERBOSE = void 0;
+exports.initLogger = initLogger;
+exports.isVerbose = isVerbose;
+exports.log = log;
+exports.redact = redact;
+exports.safePreview = safePreview;
+exports.logMessagePreview = logMessagePreview;
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ── Internal state (opt-in, off by default) ──────────────────────
+let _enabled = false;
+let _logFile = (0, path_1.join)(process.cwd(), 'toolpack-sdk.log');
+let _verbose = false;
+/**
+ * Initialise the logger.  Call once at SDK start-up.
+ *
+ * Resolution order (highest wins):
+ *   1. Environment variables  (TOOLPACK_SDK_LOG_FILE / TOOLPACK_SDK_LOG_VERBOSE)
+ *   2. `config` argument      (from toolpack.config.json → logging section)
+ *   3. Defaults               (disabled)
+ */
+function initLogger(config) {
+    // Config values (only when explicitly provided)
+    if (config?.enabled !== undefined)
+        _enabled = config.enabled;
+    if (config?.filePath)
+        _logFile = config.filePath;
+    if (config?.verbose !== undefined)
+        _verbose = config.verbose;
+    // Env-var overrides always win
+    if (process.env.TOOLPACK_SDK_LOG_FILE) {
+        _logFile = process.env.TOOLPACK_SDK_LOG_FILE;
+        _enabled = true; // setting a file path implies enabled
+    }
+    if (process.env.TOOLPACK_SDK_LOG_VERBOSE === 'true') {
+        _verbose = true;
+        _enabled = true; // verbose implies enabled
+    }
+}
+// ── Public API (unchanged signatures) ────────────────────────────
+/** Whether verbose logging is active. */
+function isVerbose() {
+    return _verbose;
+}
+/**
+ * @deprecated Use `isVerbose()` instead. This is kept for backward compatibility
+ * but will always return the current dynamic value.
+ */
+exports.LOG_VERBOSE = false; // Static false; adapters should migrate to isVerbose()
+function log(message) {
+    if (!_enabled)
+        return;
+    const timestamp = new Date().toISOString();
+    const entry = `[${timestamp}] ${message}\n`;
+    (0, fs_1.appendFileSync)(_logFile, entry);
+}
+function redact(text) {
+    return text
+        .replace(/\bsk-[A-Za-z0-9_-]{10,}\b/g, '[REDACTED]')
+        .replace(/\bsk-proj-[A-Za-z0-9_-]{10,}\b/g, '[REDACTED]')
+        .replace(/\bAIza[0-9A-Za-z_-]{10,}\b/g, '[REDACTED]')
+        .replace(/\bBearer\s+[A-Za-z0-9._-]{10,}\b/g, 'Bearer [REDACTED]');
+}
+function safePreview(value, maxLen = 200) {
+    try {
+        const raw = typeof value === 'string' ? value : JSON.stringify(value);
+        const redacted = redact(raw);
+        if (redacted.length <= maxLen)
+            return redacted;
+        return `${redacted.slice(0, maxLen)}…`;
+    }
+    catch {
+        return '[Unserializable]';
+    }
+}
+function logMessagePreview(requestId, provider, messages) {
+    if (!_verbose)
+        return;
+    log(`[${provider}][${requestId}] Messages (${messages.length}):`);
+    messages.forEach((m, i) => {
+        log(`[${provider}][${requestId}]  #${i} role=${m?.role} content=${safePreview(m?.content, 300)}`);
+    });
+}
+//# sourceMappingURL=provider-logger.js.map

package/dist/providers/provider-logger.js.map

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

package/dist/toolpack.d.ts

@@ -0,0 +1,142 @@
+import { EventEmitter } from 'events';
+import { AIClient } from './client';
+import { ProviderAdapter, CompletionRequest, CompletionResponse, CompletionChunk, EmbeddingRequest, EmbeddingResponse } from './providers/base';
+import { ProviderInfo, ProviderModelInfo } from './types';
+import { ToolProject } from './tools';
+import { ModeConfig } from './modes/mode-types.js';
+import { WorkflowExecutor } from './workflows/workflow-executor.js';
+export interface ProviderOptions {
+    /**
+     * API key for the provider.
+     * Required for: openai, anthropic, gemini.
+     * Not needed for: ollama-*.
+     * If omitted, the SDK attempts to read TOOLPACK_<PROVIDER>_KEY from env.
+     */
+    apiKey?: string;
+    /** Model name override */
+    model?: string;
+    /** Base URL override (for OpenAI-compatible endpoints or custom Ollama host) */
+    baseUrl?: string;
+}
+export interface ToolpackInitConfig {
+    /** Single provider shorthand (e.g. 'openai', 'anthropic', 'gemini') */
+    provider?: string;
+    /**
+     * Optional API key override for the single provider.
+     * If not provided, the SDK auto-reads TOOLPACK_<PROVIDER>_KEY from env.
+     */
+    apiKey?: string;
+    /** Model name for the single provider */
+    model?: string;
+    /** Load built-in tools (fs, http, etc.)? Default: false */
+    tools?: boolean;
+    /** Custom tool projects to load in addition to built-ins */
+    customTools?: ToolProject[];
+    /** Multi-provider config (overrides single provider settings) */
+    providers?: Record<string, ProviderOptions>;
+    /** Default provider to use if multiple are configured */
+    defaultProvider?: string;
+    /** Custom modes to register (in addition to built-ins) */
+    customModes?: ModeConfig[];
+    /** Default mode to activate on init (default: 'default') */
+    defaultMode?: string;
+    /** Optional system prompt overrides for specific modes */
+    modeOverrides?: Record<string, Partial<ModeConfig>>;
+    /**
+     * Custom provider adapter instances.
+     * Can be:
+     * - Array of adapters (name auto-extracted from adapter.name property)
+     * - Record keyed by provider name
+     */
+    customProviders?: ProviderAdapter[] | Record<string, ProviderAdapter>;
+    /** Disable base agent context injection (for testing or custom prompts) */
+    disableBaseContext?: boolean;
+    /**
+     * Optional path to a configuration file.
+     * If provided, the SDK will load configuration from this path instead of the default toolpack.config.json in the current working directory.
+     */
+    configPath?: string;
+}
+export declare class Toolpack extends EventEmitter {
+    private client;
+    private activeProviderName;
+    private modeRegistry;
+    private workflowExecutor;
+    customProviderNames: Set<string>;
+    private constructor();
+    /**
+     * Initialize the Toolpack SDK.
+     *
+     * @param config Configuration options
+     * @returns Ready-to-use Toolpack instance
+     */
+    static init(config: ToolpackInitConfig): Promise<Toolpack>;
+    /**
+     * Factory to create provider instances.
+     */
+    private static createProvider;
+    generate(request: CompletionRequest | string, providerName?: string): Promise<CompletionResponse>;
+    stream(request: CompletionRequest, providerName?: string): AsyncGenerator<CompletionChunk>;
+    embed(request: EmbeddingRequest, providerName?: string): Promise<EmbeddingResponse>;
+    /**
+     * Switch the active provider for the client.
+     */
+    setProvider(name: string): void;
+    getProvider(): ProviderAdapter;
+    /**
+     * Get the underlying AIClient instance.
+     * Useful for listening to tool progress events.
+     */
+    getClient(): AIClient;
+    /**
+     * Get the WorkflowExecutor instance.
+     * Useful for workflow events and approval flows.
+     */
+    getWorkflowExecutor(): WorkflowExecutor;
+    /**
+     * Disconnect the active provider (e.g. close Chrome).
+     */
+    disconnect(): Promise<void>;
+    /**
+     * List all registered providers and their available models.
+     */
+    listProviders(): Promise<ProviderInfo[]>;
+    /**
+     * Load a custom tool project at runtime.
+     * Validates dependencies and registers all tools.
+     */
+    loadToolProject(project: ToolProject): Promise<void>;
+    /**
+     * Convenience method to get a flat list of all models across all providers.
+     */
+    listModels(): Promise<(ProviderModelInfo & {
+        provider: string;
+    })[]>;
+    /**
+     * Set the active mode by name. Throws if not found.
+     */
+    setMode(name: string): ModeConfig;
+    /**
+     * Get the currently active mode, or null if none.
+     */
+    getMode(): ModeConfig | null;
+    /**
+     * Get the active mode's display name (e.g. "Default", "Explore", "Agent", "Chat").
+     */
+    getActiveModeName(): string;
+    /**
+     * Get all registered modes in cycle order.
+     */
+    getModes(): ModeConfig[];
+    /**
+     * Cycle to the next mode and return it.
+     */
+    cycleMode(): ModeConfig;
+    /**
+     * Register a custom mode at runtime.
+     */
+    registerMode(mode: ModeConfig): void;
+    private forwardEvents;
+    private forwardWorkflowEvents;
+}
+//# sourceMappingURL=toolpack.d.ts.map

package/dist/toolpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolpack.d.ts","sourceRoot":"","sources":["../src/toolpack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAQ1D,OAAO,EAAmB,WAAW,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAE5B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE5C,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAE3B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEtE,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,QAAS,SAAQ,YAAY;IACtC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IACpC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;IAEpD,OAAO;IAiBP;;;;;OAKG;WACU,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkLhE;;OAEG;mBACkB,cAAc;IA2C7B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+EhG,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC;IAc3F,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO/B,WAAW,IAAI,eAAe;IAI9B;;;OAGG;IACH,SAAS,IAAI,QAAQ;IAIrB;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB;IAIvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA0B9C;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,CAAC,iBAAiB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAoBzE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAcjC;;OAEG;IACH,OAAO,IAAI,UAAU,GAAG,IAAI;IAI5B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAK3B;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE;IAIxB;;OAEG;IACH,SAAS,IAAI,UAAU;IAQvB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIpC,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,qBAAqB;CAehC"}