toolpack-sdk 0.1.0-SNAPSHOT

package/dist/types/index.d.ts

@@ -0,0 +1,221 @@
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+export interface ImageDataPart {
+    type: 'image_data';
+    image_data: {
+        /** base64-encoded string */
+        data: string;
+        /** e.g., 'image/png' */
+        mimeType: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export interface ImageFilePart {
+    type: 'image_file';
+    image_file: {
+        /** local file path */
+        path: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export interface ImageUrlPart {
+    type: 'image_url';
+    image_url: {
+        /** HTTP/HTTPS URL */
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+export type ImagePart = ImageDataPart | ImageFilePart | ImageUrlPart;
+export type MessageContent = string | (TextPart | ImagePart)[] | null;
+export type MediaUploadStrategy = 'inline' | 'upload' | 'auto';
+export interface MediaOptions {
+    /** How to handle image payloads */
+    uploadStrategy?: MediaUploadStrategy;
+    /** Max size in bytes before switching from inline to upload if strategy is 'auto' (default: 4MB) */
+    maxInlineSize?: number;
+}
+export interface FileUploadRequest {
+    /** Path to file for upload */
+    filePath?: string;
+    /** Base64 or raw data for upload */
+    data?: Buffer | string;
+    mimeType: string;
+    purpose?: string;
+}
+export interface FileUploadResponse {
+    id: string;
+    url?: string;
+    expiresAt?: Date;
+}
+export interface ToolCallMessage {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface Message {
+    role: Role;
+    content: MessageContent;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: ToolCallMessage[];
+}
+export interface ToolCallFunction {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+}
+export interface ToolCallRequest {
+    type: 'function';
+    function: ToolCallFunction;
+}
+export interface ToolCallResult {
+    id: string;
+    name: string;
+    arguments: Record<string, any>;
+    result?: string;
+    duration?: number;
+}
+export interface CompletionRequest {
+    messages: Message[];
+    model: string;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    response_format?: 'text' | 'json_object';
+    stream?: boolean;
+    tools?: ToolCallRequest[];
+    tool_choice?: 'auto' | 'none' | 'required';
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
+    /** Multimodal media handling options */
+    mediaOptions?: MediaOptions;
+}
+export interface Usage {
+    prompt_tokens: number;
+    completion_tokens?: number;
+    total_tokens: number;
+}
+export interface CompletionResponse {
+    content: string | null;
+    usage?: Usage;
+    /** Detailed breakdown of token usage when executed in agent/workflow mode */
+    usage_details?: {
+        planning?: Usage;
+        steps?: Array<{
+            stepNumber: number;
+            description: string;
+            usage: Usage;
+        }>;
+    };
+    finish_reason?: 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'error';
+    tool_calls?: ToolCallResult[];
+    raw?: any;
+}
+export interface CompletionChunk {
+    delta: string;
+    usage?: Usage;
+    finish_reason?: 'stop' | 'length' | 'tool_calls' | 'content_filter' | 'error';
+    tool_calls?: ToolCallResult[];
+    /** Present when chunk comes from a workflow step */
+    workflowStep?: {
+        number: number;
+        description: string;
+    };
+}
+export interface EmbeddingRequest {
+    input: string | string[];
+    model: string;
+}
+export interface EmbeddingResponse {
+    embeddings: number[][];
+    usage?: Usage;
+}
+export interface ProviderConfig {
+    apiKey: string;
+    baseURL?: string;
+    [key: string]: any;
+}
+export interface CompletionOptions extends CompletionRequest {
+    provider?: string;
+}
+export interface ToolProgressEvent {
+    toolName: string;
+    toolCallId: string;
+    status: 'started' | 'completed' | 'failed';
+    args?: Record<string, any>;
+    result?: string;
+    error?: string;
+    duration?: number;
+}
+/**
+ * Event emitted after each tool execution with full details for logging/history.
+ * Unlike ToolProgressEvent which truncates results, this contains the complete data.
+ */
+export interface ToolLogEvent {
+    id: string;
+    name: string;
+    arguments: Record<string, any>;
+    result: string;
+    duration: number;
+    status: 'success' | 'error';
+    timestamp: number;
+}
+/**
+ * Information about a single model available from a provider.
+ */
+export interface ProviderModelInfo {
+    /** Model identifier used in API calls (e.g., "gpt-4.1", "claude-sonnet-4-20250514") */
+    id: string;
+    /** Human-readable display name (e.g., "GPT-4.1", "Claude Sonnet 4") */
+    displayName: string;
+    /** Model capabilities */
+    capabilities: {
+        /** Supports chat completions */
+        chat: boolean;
+        /** Supports streaming responses */
+        streaming: boolean;
+        /** Supports function/tool calling */
+        toolCalling: boolean;
+        /** Supports embedding generation */
+        embeddings: boolean;
+        /** Supports image/vision input */
+        vision: boolean;
+        /** Supports reasoning/thinking capabilities */
+        reasoning?: boolean;
+        /** Supports file upload API directly */
+        fileUpload?: boolean;
+    };
+    /** Context window size in tokens (if known) */
+    contextWindow?: number;
+    /** Maximum output tokens (if known) */
+    maxOutputTokens?: number;
+    /** Input modalities supported by the model (e.g., 'text', 'image', 'audio') */
+    inputModalities?: string[];
+    /** Output modalities supported by the model (e.g., 'text', 'image', 'audio') */
+    outputModalities?: string[];
+    /** Reasoning tier for models with thinking capabilities (e.g., 'standard', 'extended') */
+    reasoningTier?: string | null;
+    /** Cost tier indicator (e.g., 'low', 'medium', 'high', 'premium') */
+    costTier?: string;
+}
+/**
+ * Information about a registered provider and its available models.
+ */
+export interface ProviderInfo {
+    /** Provider name as registered (e.g., "openai", "grok") */
+    name: string;
+    /** Human-readable display name (e.g., "OpenAI", "Grok by xAI") */
+    displayName: string;
+    /** Whether this is a built-in or custom provider */
+    type: 'built-in' | 'custom';
+    /** Available models from this provider */
+    models: ProviderModelInfo[];
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/global-config-loader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Global configuration interface.
+ * Loaded from toolpack.config.json at the project root.
+ */
+export interface GlobalConfig {
+    fastAIModels?: Record<string, string>;
+}
+/**
+ * Load global config from toolpack.config.json.
+ * Falls back to defaults if the file doesn't exist or fastAIModels is missing.
+ */
+export declare function loadGlobalConfig(basePathOrFilePath?: string): GlobalConfig;
+//# sourceMappingURL=global-config-loader.d.ts.map

package/dist/utils/global-config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/global-config-loader.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAWD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,YAAY,CAiB1E"}

package/dist/utils/global-config-loader.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGlobalConfig = loadGlobalConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const CONFIG_FILENAME = 'toolpack.config.json';
+/**
+ * Default fast AI models for intelligent tool filtering and detection.
+ */
+const DEFAULT_FAST_AI_MODELS = {
+    openai: 'gpt-4.1-mini',
+    anthropic: 'claude-3-haiku-20240307',
+    gemini: 'gemini-2.0-flash',
+};
+/**
+ * Load global config from toolpack.config.json.
+ * Falls back to defaults if the file doesn't exist or fastAIModels is missing.
+ */
+function loadGlobalConfig(basePathOrFilePath) {
+    const configPath = resolveConfigPath(basePathOrFilePath);
+    if (!fs.existsSync(configPath)) {
+        return { fastAIModels: DEFAULT_FAST_AI_MODELS };
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            fastAIModels: parsed.fastAIModels || DEFAULT_FAST_AI_MODELS,
+        };
+    }
+    catch {
+        return { fastAIModels: DEFAULT_FAST_AI_MODELS };
+    }
+}
+/**
+ * Resolve the path to toolpack.config.json.
+ */
+function resolveConfigPath(basePathOrFilePath) {
+    if (basePathOrFilePath) {
+        // If the path ends with .json, assume it's a direct file path
+        if (basePathOrFilePath.endsWith('.json')) {
+            return path.resolve(basePathOrFilePath);
+        }
+        // Otherwise treat it as a directory base path
+        return path.resolve(basePathOrFilePath, CONFIG_FILENAME);
+    }
+    // Default to cwd
+    return path.resolve(process.cwd(), CONFIG_FILENAME);
+}
+//# sourceMappingURL=global-config-loader.js.map

package/dist/utils/global-config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config-loader.js","sourceRoot":"","sources":["../../src/utils/global-config-loader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,4CAiBC;AA3CD,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAU/C;;GAEG;AACH,MAAM,sBAAsB,GAA2B;IACnD,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,yBAAyB;IACpC,MAAM,EAAE,kBAAkB;CAC7B,CAAC;AAEF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,kBAA2B;IACxD,MAAM,UAAU,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,OAAO;YACH,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,sBAAsB;SAC9D,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACpD,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,kBAA2B;IAClD,IAAI,kBAAkB,EAAE,CAAC;QACrB,8DAA8D;QAC9D,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5C,CAAC;QACD,8CAA8C;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAC7D,CAAC;IAED,iBAAiB;IACjB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;AACxD,CAAC"}

package/dist/utils/home-config.d.ts

@@ -0,0 +1,40 @@
+export declare const TOOLPACK_DIR_NAME = ".toolpack";
+export declare const CONFIG_DIR_NAME = "config";
+export declare const CONFIG_FILE_NAME = "toolpack.config.json";
+/**
+ * Returns the path to the user's home directory.
+ */
+export declare function getUserHomeDir(): string;
+/**
+ * Returns the path to the global ~/.toolpack directory.
+ */
+export declare function getGlobalToolpackDir(): string;
+/**
+ * Returns the path to the global ~/.toolpack/config directory.
+ */
+export declare function getGlobalConfigDir(): string;
+/**
+ * Returns the path to the global ~/.toolpack/config/toolpack.config.json file.
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * Returns the path to the local workspace's .toolpack directory.
+ */
+export declare function getLocalToolpackDir(workspacePath?: string): string;
+/**
+ * Returns the path to the local workspace's .toolpack/config directory.
+ */
+export declare function getLocalConfigDir(workspacePath?: string): string;
+/**
+ * Returns the path to the local workspace's .toolpack/config/toolpack.config.json file.
+ */
+export declare function getLocalConfigPath(workspacePath?: string): string;
+/**
+ * Ensures the global ~/.toolpack/config directory exists.
+ */
+export declare function ensureGlobalConfigDir(): void;
+/**
+ * Ensures the local workspace's .toolpack/config directory exists.
+ */
+export declare function ensureLocalConfigDir(workspacePath?: string): void;
+//# sourceMappingURL=home-config.d.ts.map

package/dist/utils/home-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-config.d.ts","sourceRoot":"","sources":["../../src/utils/home-config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,GAAE,MAAsB,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,GAAE,MAAsB,GAAG,MAAM,CAE/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,GAAE,MAAsB,GAAG,MAAM,CAEhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,GAAE,MAAsB,GAAG,IAAI,CAKhF"}

package/dist/utils/home-config.js

@@ -0,0 +1,112 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE_NAME = exports.CONFIG_DIR_NAME = exports.TOOLPACK_DIR_NAME = void 0;
+exports.getUserHomeDir = getUserHomeDir;
+exports.getGlobalToolpackDir = getGlobalToolpackDir;
+exports.getGlobalConfigDir = getGlobalConfigDir;
+exports.getGlobalConfigPath = getGlobalConfigPath;
+exports.getLocalToolpackDir = getLocalToolpackDir;
+exports.getLocalConfigDir = getLocalConfigDir;
+exports.getLocalConfigPath = getLocalConfigPath;
+exports.ensureGlobalConfigDir = ensureGlobalConfigDir;
+exports.ensureLocalConfigDir = ensureLocalConfigDir;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+exports.TOOLPACK_DIR_NAME = '.toolpack';
+exports.CONFIG_DIR_NAME = 'config';
+exports.CONFIG_FILE_NAME = 'toolpack.config.json';
+/**
+ * Returns the path to the user's home directory.
+ */
+function getUserHomeDir() {
+    return os.homedir();
+}
+/**
+ * Returns the path to the global ~/.toolpack directory.
+ */
+function getGlobalToolpackDir() {
+    return path.join(getUserHomeDir(), exports.TOOLPACK_DIR_NAME);
+}
+/**
+ * Returns the path to the global ~/.toolpack/config directory.
+ */
+function getGlobalConfigDir() {
+    return path.join(getGlobalToolpackDir(), exports.CONFIG_DIR_NAME);
+}
+/**
+ * Returns the path to the global ~/.toolpack/config/toolpack.config.json file.
+ */
+function getGlobalConfigPath() {
+    return path.join(getGlobalConfigDir(), exports.CONFIG_FILE_NAME);
+}
+/**
+ * Returns the path to the local workspace's .toolpack directory.
+ */
+function getLocalToolpackDir(workspacePath = process.cwd()) {
+    return path.join(workspacePath, exports.TOOLPACK_DIR_NAME);
+}
+/**
+ * Returns the path to the local workspace's .toolpack/config directory.
+ */
+function getLocalConfigDir(workspacePath = process.cwd()) {
+    return path.join(getLocalToolpackDir(workspacePath), exports.CONFIG_DIR_NAME);
+}
+/**
+ * Returns the path to the local workspace's .toolpack/config/toolpack.config.json file.
+ */
+function getLocalConfigPath(workspacePath = process.cwd()) {
+    return path.join(getLocalConfigDir(workspacePath), exports.CONFIG_FILE_NAME);
+}
+/**
+ * Ensures the global ~/.toolpack/config directory exists.
+ */
+function ensureGlobalConfigDir() {
+    const configDir = getGlobalConfigDir();
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+}
+/**
+ * Ensures the local workspace's .toolpack/config directory exists.
+ */
+function ensureLocalConfigDir(workspacePath = process.cwd()) {
+    const configDir = getLocalConfigDir(workspacePath);
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+}
+//# sourceMappingURL=home-config.js.map

package/dist/utils/home-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home-config.js","sourceRoot":"","sources":["../../src/utils/home-config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,wCAEC;AAKD,oDAEC;AAKD,gDAEC;AAKD,kDAEC;AAKD,kDAEC;AAKD,8CAEC;AAKD,gDAEC;AAKD,sDAKC;AAKD,oDAKC;AA3ED,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAEZ,QAAA,iBAAiB,GAAG,WAAW,CAAC;AAChC,QAAA,eAAe,GAAG,QAAQ,CAAC;AAC3B,QAAA,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD;;GAEG;AACH,SAAgB,cAAc;IAC1B,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,yBAAiB,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,uBAAe,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,wBAAgB,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,gBAAwB,OAAO,CAAC,GAAG,EAAE;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,yBAAiB,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,gBAAwB,OAAO,CAAC,GAAG,EAAE;IACnE,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,uBAAe,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,gBAAwB,OAAO,CAAC,GAAG,EAAE;IACpE,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,wBAAgB,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACjC,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,gBAAwB,OAAO,CAAC,GAAG,EAAE;IACtE,MAAM,SAAS,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACL,CAAC"}

package/dist/utils/runtime-config-loader.d.ts

@@ -0,0 +1,22 @@
+import { ToolpackConfig } from '../providers/config.js';
+export interface RuntimeConfigStatus {
+    isFirstRun: boolean;
+    activeConfigPath: string | null;
+    configSource: 'local' | 'global' | 'base' | 'default';
+}
+/**
+ * Loads the runtime configuration by merging base, global, and local configurations.
+ * Priority: Workspace Local (.toolpack/config) > Global (~/.toolpack/config) > SDK Base (toolpack.config.json)
+ */
+export declare function loadRuntimeConfig(workspacePath?: string): ToolpackConfig;
+/**
+ * Helper to check the status of the configuration.
+ */
+export declare function getRuntimeConfigStatus(workspacePath?: string): RuntimeConfigStatus;
+/**
+ * Initializes the global configuration if it doesn't exist.
+ * This is typically called on the first run of the CLI.
+ * It copies the build-time config (if found in the current directory) to the global config path.
+ */
+export declare function initializeGlobalConfigIfFirstRun(workspacePath?: string): void;
+//# sourceMappingURL=runtime-config-loader.d.ts.map

package/dist/utils/runtime-config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,MAAM,WAAW,mBAAmB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CACzD;AAwCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,GAAE,MAAsB,GAAG,cAAc,CAcvF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,GAAE,MAAsB,GAAG,mBAAmB,CAyBjG;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,aAAa,GAAE,MAAsB,GAAG,IAAI,CAyC5F"}