notsleep 1.0.0

package/dist/provider.js

@@ -0,0 +1,396 @@
+"use strict";
+// ============================================================
+// NotSleep - Unified LLM Provider Abstraction
+// ============================================================
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMProvider = void 0;
+const openai_1 = __importDefault(require("openai"));
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+/**
+ * Converts our ToolDefinition[] to provider-specific tool format.
+ * Handles retries with exponential backoff.
+ * Normalizes responses to a unified LLMResponse format.
+ *
+ * Supports two endpoints — primary (chat) and an optional cheaper small model
+ * (chatSmall) — which may be different providers entirely. Clients are built
+ * lazily and cached per (baseURL, apiKey), so a mixed setup (e.g. Anthropic
+ * primary + OpenAI small) works without extra wiring.
+ */
+class LLMProvider {
+    config;
+    logger;
+    primary;
+    small;
+    openaiClients = new Map();
+    anthropicClients = new Map();
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+        this.primary = this.endpointFromConfig();
+        if (config.smallModel) {
+            this.small = {
+                type: config.smallModel.provider,
+                model: config.smallModel.model,
+                apiKey: config.smallModel.apiKey,
+                baseURL: config.smallModel.baseURL,
+            };
+        }
+    }
+    /** Build the primary endpoint from the resolved config blocks. */
+    endpointFromConfig() {
+        if (this.config.provider === 'openai') {
+            const o = this.config.openai;
+            return { type: 'openai', model: o.model, apiKey: o.apiKey, baseURL: o.baseURL };
+        }
+        const a = this.config.anthropic;
+        return { type: 'anthropic', model: a.model, apiKey: a.apiKey, baseURL: a.baseURL };
+    }
+    getOpenAIClient(ep) {
+        const key = `${ep.baseURL || ''}|${ep.apiKey}`;
+        let client = this.openaiClients.get(key);
+        if (!client) {
+            client = new openai_1.default({ apiKey: ep.apiKey, baseURL: ep.baseURL });
+            this.openaiClients.set(key, client);
+        }
+        return client;
+    }
+    getAnthropicClient(ep) {
+        const key = `${ep.baseURL || ''}|${ep.apiKey}`;
+        let client = this.anthropicClients.get(key);
+        if (!client) {
+            client = new sdk_1.default({ apiKey: ep.apiKey, baseURL: ep.baseURL });
+            this.anthropicClients.set(key, client);
+        }
+        return client;
+    }
+    /**
+     * Send messages to the PRIMARY model and get a response.
+     * Automatically retries on transient errors with exponential backoff.
+     */
+    async chat(messages, tools, opts) {
+        return this.callEndpoint(this.primary, messages, tools, opts);
+    }
+    /**
+     * Send messages to the SMALL model (if configured), else the primary. Used
+     * for the agent's own internal calls — context summarization and follow-up
+     * task generation — so they run on a cheaper model when one is set.
+     */
+    async chatSmall(messages, tools, opts) {
+        return this.callEndpoint(this.small ?? this.primary, messages, tools, opts);
+    }
+    /** True when a distinct small model is configured. */
+    hasSmallModel() {
+        return this.small !== undefined;
+    }
+    async callEndpoint(ep, messages, tools, opts) {
+        let lastError = null;
+        // Allow the caller to bound retries/backoff. Used by the summarization
+        // call so a flaky upstream (e.g. repeated 524s) can't block a single
+        // iteration for ~20 minutes; it fails fast and falls back to truncation.
+        const maxRetries = opts?.maxRetries ?? this.config.maxRetries;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                if (ep.type === 'openai') {
+                    return await this.chatOpenAI(ep, messages, tools);
+                }
+                else {
+                    return await this.chatAnthropic(ep, messages, tools);
+                }
+            }
+            catch (error) {
+                lastError = error;
+                const isRetryable = this.isRetryableError(error);
+                if (!isRetryable || attempt === maxRetries) {
+                    throw this.enhanceError(error, ep);
+                }
+                let delay = this.calculateBackoff(attempt, error);
+                // Clamp the delay when the caller asked for a cap (even if the server
+                // sent a large Retry-After), so a bounded call stays bounded.
+                if (opts?.maxDelayMs !== undefined) {
+                    delay = Math.min(delay, opts.maxDelayMs);
+                }
+                this.logger.warn(`API call failed (attempt ${attempt + 1}/${maxRetries + 1}): ${error.message}. ` +
+                    `Retrying in ${(delay / 1000).toFixed(1)}s...`);
+                await this.sleep(delay);
+            }
+        }
+        throw lastError || new Error('All retry attempts exhausted');
+    }
+    // ─── OpenAI Implementation ───────────────────────────────
+    async chatOpenAI(ep, messages, tools) {
+        const client = this.getOpenAIClient(ep);
+        const openaiMessages = messages.map((m) => this.toOpenAIMessage(m));
+        const openaiTools = tools
+            .filter((t) => t.name !== 'task_complete') // handled separately below
+            .map((t) => this.toOpenAITool(t));
+        // Always include task_complete
+        const taskCompleteTool = tools.find((t) => t.name === 'task_complete');
+        if (taskCompleteTool) {
+            openaiTools.push(this.toOpenAITool(taskCompleteTool));
+        }
+        const params = {
+            model: ep.model,
+            messages: openaiMessages,
+            temperature: 0.2,
+            max_tokens: 16384,
+        };
+        if (openaiTools.length > 0) {
+            params.tools = openaiTools;
+            params.tool_choice = 'auto';
+        }
+        const response = await client.chat.completions.create(params);
+        const choice = response.choices[0];
+        const toolCalls = (choice.message.tool_calls || []).map((tc) => ({
+            id: tc.id,
+            type: 'function',
+            function: {
+                name: tc.function.name,
+                arguments: tc.function.arguments,
+            },
+        }));
+        return {
+            content: choice.message.content,
+            tool_calls: toolCalls,
+            usage: {
+                prompt_tokens: response.usage?.prompt_tokens || 0,
+                completion_tokens: response.usage?.completion_tokens || 0,
+                total_tokens: response.usage?.total_tokens || 0,
+            },
+            finish_reason: choice.finish_reason || 'stop',
+        };
+    }
+    toOpenAIMessage(msg) {
+        if (msg.role === 'tool') {
+            return {
+                role: 'tool',
+                content: msg.content,
+                tool_call_id: msg.tool_call_id,
+            };
+        }
+        if (msg.role === 'assistant' && msg.tool_calls && msg.tool_calls.length > 0) {
+            return {
+                role: 'assistant',
+                content: msg.content,
+                tool_calls: msg.tool_calls.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: {
+                        name: tc.function.name,
+                        arguments: tc.function.arguments,
+                    },
+                })),
+            };
+        }
+        return { role: msg.role, content: msg.content };
+    }
+    toOpenAITool(tool) {
+        return {
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        };
+    }
+    // ─── Anthropic Implementation ────────────────────────────
+    async chatAnthropic(ep, messages, tools) {
+        const client = this.getAnthropicClient(ep);
+        // Anthropic separates system prompt from messages
+        const systemPrompt = messages.find((m) => m.role === 'system')?.content || '';
+        const nonSystemMessages = messages.filter((m) => m.role !== 'system');
+        const anthropicMessages = this.toAnthropicMessages(nonSystemMessages);
+        const anthropicTools = tools.map((t) => this.toAnthropicTool(t));
+        const params = {
+            model: ep.model,
+            max_tokens: 16384,
+            system: systemPrompt,
+            messages: anthropicMessages,
+        };
+        if (anthropicTools.length > 0) {
+            params.tools = anthropicTools;
+        }
+        const response = await client.messages.create(params);
+        // Parse Anthropic response into unified format
+        let content = null;
+        const toolCalls = [];
+        for (const block of response.content) {
+            if (block.type === 'text') {
+                content = (content || '') + block.text;
+            }
+            else if (block.type === 'tool_use') {
+                toolCalls.push({
+                    id: block.id,
+                    type: 'function',
+                    function: {
+                        name: block.name,
+                        arguments: JSON.stringify(block.input),
+                    },
+                });
+            }
+        }
+        return {
+            content,
+            tool_calls: toolCalls,
+            usage: {
+                prompt_tokens: response.usage?.input_tokens || 0,
+                completion_tokens: response.usage?.output_tokens || 0,
+                total_tokens: (response.usage?.input_tokens || 0) + (response.usage?.output_tokens || 0),
+            },
+            finish_reason: response.stop_reason || 'end_turn',
+        };
+    }
+    toAnthropicMessages(messages) {
+        const result = [];
+        // Append a content block to a message of the given role, MERGING with the
+        // previous message when it shares the same role. Anthropic requires roles
+        // to strictly alternate (user/assistant/user/...), so consecutive
+        // same-role messages — e.g. a tool_result (user) followed by a system
+        // nudge or error message (also user) — must be combined into one message
+        // with multiple content blocks, or the API returns a 400.
+        const push = (role, block) => {
+            const last = result[result.length - 1];
+            if (last && last.role === role) {
+                if (!Array.isArray(last.content)) {
+                    last.content = [{ type: 'text', text: last.content }];
+                }
+                last.content.push(block);
+            }
+            else {
+                result.push({ role, content: [block] });
+            }
+        };
+        for (const msg of messages) {
+            if (msg.role === 'assistant') {
+                if (msg.content) {
+                    push('assistant', { type: 'text', text: msg.content });
+                }
+                if (msg.tool_calls) {
+                    for (const tc of msg.tool_calls) {
+                        let input;
+                        try {
+                            input = JSON.parse(tc.function.arguments);
+                        }
+                        catch {
+                            input = {};
+                        }
+                        push('assistant', {
+                            type: 'tool_use',
+                            id: tc.id,
+                            name: tc.function.name,
+                            input,
+                        });
+                    }
+                }
+            }
+            else if (msg.role === 'tool') {
+                // Tool results map to a user message with tool_result content blocks.
+                push('user', {
+                    type: 'tool_result',
+                    tool_use_id: msg.tool_call_id,
+                    content: msg.content,
+                });
+            }
+            else if (msg.role === 'user') {
+                push('user', { type: 'text', text: msg.content });
+            }
+        }
+        // Anthropic requires the first message to have the 'user' role. If the
+        // conversation somehow begins with an assistant turn (e.g. an odd
+        // checkpoint), drop leading assistant messages so the request is valid.
+        while (result.length > 0 && result[0].role !== 'user') {
+            result.shift();
+        }
+        return result;
+    }
+    toAnthropicTool(tool) {
+        return {
+            name: tool.name,
+            description: tool.description,
+            input_schema: tool.parameters,
+        };
+    }
+    // ─── Retry Logic ─────────────────────────────────────────
+    isRetryableError(error) {
+        // Rate limits
+        if (error?.status === 429)
+            return true;
+        // Request timeout
+        if (error?.status === 408)
+            return true;
+        // Server errors
+        if (error?.status >= 500)
+            return true;
+        // Network errors (Node-level)
+        if (error?.code === 'ECONNRESET' || error?.code === 'ETIMEDOUT' ||
+            error?.code === 'ENOTFOUND' || error?.code === 'ECONNREFUSED' ||
+            error?.code === 'EPIPE' || error?.code === 'EAI_AGAIN')
+            return true;
+        // SDK-level connection/timeout errors (OpenAI & Anthropic wrap these and
+        // often don't expose a numeric status). Match by class name defensively.
+        const name = error?.name || error?.constructor?.name;
+        if (name === 'APIConnectionError' || name === 'APIConnectionTimeoutError' ||
+            name === 'InternalServerError' || name === 'AbortError')
+            return true;
+        // Overloaded (Anthropic)
+        if (error?.error?.type === 'overloaded_error')
+            return true;
+        return false;
+    }
+    calculateBackoff(attempt, error) {
+        // Check for Retry-After header
+        const retryAfter = error?.headers?.['retry-after'];
+        if (retryAfter) {
+            const retryMs = parseInt(retryAfter, 10) * 1000;
+            if (!isNaN(retryMs))
+                return retryMs;
+        }
+        // Exponential backoff with jitter
+        const baseDelay = this.config.retryBaseDelayMs;
+        const maxDelay = 120000; // 2 minutes max
+        const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+        const jitter = delay * 0.2 * Math.random();
+        return delay + jitter;
+    }
+    /**
+     * Wrap common API errors with actionable, user-friendly messages so the
+     * operator can fix config issues without digging through raw HTTP bodies.
+     */
+    enhanceError(error, ep = this.primary) {
+        const status = error?.status;
+        const provider = ep.type;
+        const model = ep.model;
+        if (status === 401) {
+            const envVar = provider === 'openai' ? 'OPENAI_API_KEY' : 'ANTHROPIC_API_KEY';
+            return Object.assign(new Error(`Authentication failed (HTTP 401) for ${provider}. ` +
+                `Your API key is missing or invalid. ` +
+                `Check the ${envVar} environment variable or --${provider === 'openai' ? 'openai-key' : 'anthropic-key'} flag.`), { cause: error });
+        }
+        if (status === 403) {
+            return Object.assign(new Error(`Access denied (HTTP 403) for ${provider}. ` +
+                `Your API key does not have permission to use model "${model}". ` +
+                `Check your organization settings, billing status, and model access.`), { cause: error });
+        }
+        if (status === 404) {
+            return Object.assign(new Error(`Model not found (HTTP 404): "${model}" is not a valid ${provider} model. ` +
+                `Use --model to specify a different model. ` +
+                `Run with --help to see available options.`), { cause: error });
+        }
+        if (status === 400 || status === 422) {
+            const body = error?.error?.message || error?.message || 'unknown';
+            return Object.assign(new Error(`Invalid request (HTTP ${status}) from ${provider}: ${body}. ` +
+                `This usually means the request parameters are malformed. ` +
+                `If this persists, try a different model or check your configuration.`), { cause: error });
+        }
+        // For any other error, return as-is
+        return error;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.LLMProvider = LLMProvider;
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,+DAA+D;;;;;;AAE/D,oDAA4B;AAC5B,4DAA0C;AAgB1C;;;;;;;;;GASG;AACH,MAAa,WAAW;IACd,MAAM,CAAc;IACpB,MAAM,CAAS;IAEN,OAAO,CAAW;IAClB,KAAK,CAAY;IAE1B,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,gBAAgB,GAAG,IAAI,GAAG,EAAqB,CAAC;IAExD,YAAY,MAAmB,EAAE,MAAc;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,GAAG;gBACX,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;gBAChC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;gBAC9B,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM;gBAChC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO;aACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kEAAkE;IAC1D,kBAAkB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAO,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAU,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IACrF,CAAC;IAEO,eAAe,CAAC,EAAY;QAClC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;QAC/C,IAAI,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,gBAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,kBAAkB,CAAC,EAAY;QACrC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;QAC/C,IAAI,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CACR,QAAmB,EACnB,KAAuB,EACvB,IAAmD;QAEnD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CACb,QAAmB,EACnB,KAAuB,EACvB,IAAmD;QAEnD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,sDAAsD;IACtD,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,EAAY,EACZ,QAAmB,EACnB,KAAuB,EACvB,IAAmD;QAEnD,IAAI,SAAS,GAAiB,IAAI,CAAC;QAEnC,uEAAuE;QACvE,qEAAqE;QACrE,yEAAyE;QACzE,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAE9D,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACzB,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAEjD,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;oBAC3C,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAED,IAAI,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAClD,sEAAsE;gBACtE,8DAA8D;gBAC9D,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;oBACnC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC3C,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4BAA4B,OAAO,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,MAAM,KAAK,CAAC,OAAO,IAAI;oBAChF,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAC/C,CAAC;gBACF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC/D,CAAC;IAED,4DAA4D;IAEpD,KAAK,CAAC,UAAU,CAAC,EAAY,EAAE,QAAmB,EAAE,KAAuB;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAExC,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,KAAK;aACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,2BAA2B;aACrE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpC,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;QACvE,IAAI,gBAAgB,EAAE,CAAC;YACrB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAQ;YAClB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,QAAQ,EAAE,cAAc;YACxB,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,KAAK;SAClB,CAAC;QAEF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;YAC3B,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;QAC9B,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAEnC,MAAM,SAAS,GAAe,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC;YAChF,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACR,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;gBACtB,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS;aACjC;SACF,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;YAC/B,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE;gBACL,aAAa,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;gBACjD,iBAAiB,EAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;gBACzD,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;aAChD;YACD,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,MAAM;SAC9C,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,GAAY;QAClC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5E,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACtC,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;wBACtB,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS;qBACjC;iBACF,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;IAEO,YAAY,CAAC,IAAoB;QACvC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,4DAA4D;IAEpD,KAAK,CAAC,aAAa,CAAC,EAAY,EAAE,QAAmB,EAAE,KAAuB;QACpF,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QAE3C,kDAAkD;QAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;QAC9E,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAEtE,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;QACtE,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAQ;YAClB,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,iBAAiB;SAC5B,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC;QAChC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEtD,+CAA+C;QAC/C,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,OAAO,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;YACzC,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACrC,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;qBACvC;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO;YACP,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE;gBACL,aAAa,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;gBAChD,iBAAiB,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;gBACrD,YAAY,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC;aACzF;YACD,aAAa,EAAE,QAAQ,CAAC,WAAW,IAAI,UAAU;SAClD,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,QAAmB;QAC7C,MAAM,MAAM,GAAU,EAAE,CAAC;QAEzB,0EAA0E;QAC1E,0EAA0E;QAC1E,kEAAkE;QAClE,sEAAsE;QACtE,yEAAyE;QACzE,0DAA0D;QAC1D,MAAM,IAAI,GAAG,CAAC,IAA0B,EAAE,KAAU,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvC,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC7B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAChB,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;oBACnB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;wBAChC,IAAI,KAAU,CAAC;wBACf,IAAI,CAAC;4BACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;wBAC5C,CAAC;wBAAC,MAAM,CAAC;4BACP,KAAK,GAAG,EAAE,CAAC;wBACb,CAAC;wBACD,IAAI,CAAC,WAAW,EAAE;4BAChB,IAAI,EAAE,UAAU;4BAChB,EAAE,EAAE,EAAE,CAAC,EAAE;4BACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;4BACtB,KAAK;yBACN,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/B,sEAAsE;gBACtE,IAAI,CAAC,MAAM,EAAE;oBACX,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,GAAG,CAAC,YAAY;oBAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,kEAAkE;QAClE,wEAAwE;QACxE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtD,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,IAAoB;QAC1C,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IAED,4DAA4D;IAEpD,gBAAgB,CAAC,KAAU;QACjC,cAAc;QACd,IAAI,KAAK,EAAE,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACvC,kBAAkB;QAClB,IAAI,KAAK,EAAE,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACvC,gBAAgB;QAChB,IAAI,KAAK,EAAE,MAAM,IAAI,GAAG;YAAE,OAAO,IAAI,CAAC;QACtC,8BAA8B;QAC9B,IACE,KAAK,EAAE,IAAI,KAAK,YAAY,IAAI,KAAK,EAAE,IAAI,KAAK,WAAW;YAC3D,KAAK,EAAE,IAAI,KAAK,WAAW,IAAI,KAAK,EAAE,IAAI,KAAK,cAAc;YAC7D,KAAK,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,KAAK,WAAW;YACtD,OAAO,IAAI,CAAC;QACd,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC;QACrD,IACE,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,2BAA2B;YACrE,IAAI,KAAK,qBAAqB,IAAI,IAAI,KAAK,YAAY;YACvD,OAAO,IAAI,CAAC;QACd,yBAAyB;QACzB,IAAI,KAAK,EAAE,KAAK,EAAE,IAAI,KAAK,kBAAkB;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,OAAe,EAAE,KAAU;QAClD,+BAA+B;QAC/B,MAAM,UAAU,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,CAAC;QACnD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QACtC,CAAC;QAED,kCAAkC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,gBAAgB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,OAAO,KAAK,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,KAAU,EAAE,KAAe,IAAI,CAAC,OAAO;QAC1D,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;QAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC;QACzB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;QAEvB,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC;YAC9E,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,wCAAwC,QAAQ,IAAI;gBACpD,sCAAsC;gBACtC,aAAa,MAAM,8BAA8B,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,QAAQ,CAChH,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,gCAAgC,QAAQ,IAAI;gBAC5C,uDAAuD,KAAK,KAAK;gBACjE,qEAAqE,CACtE,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,gCAAgC,KAAK,oBAAoB,QAAQ,UAAU;gBAC3E,4CAA4C;gBAC5C,2CAA2C,CAC5C,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,IAAI,SAAS,CAAC;YAClE,OAAO,MAAM,CAAC,MAAM,CAClB,IAAI,KAAK,CACP,yBAAyB,MAAM,UAAU,QAAQ,KAAK,IAAI,IAAI;gBAC9D,2DAA2D;gBAC3D,sEAAsE,CACvE,EACD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AAncD,kCAmcC"}

package/dist/registry.d.ts

@@ -0,0 +1,60 @@
+/** The protocol used to talk to a provider. */
+export type ProviderType = 'openai' | 'anthropic';
+/** A known provider's connection defaults. */
+export interface RegistryProvider {
+    /** Protocol: 'openai' (OpenAI-compatible) or 'anthropic' (native SDK). */
+    type: ProviderType;
+    /** Base URL for the API. Undefined = the SDK's default (official endpoint). */
+    baseURL?: string;
+    /** Environment variable the API key is read from when not given explicitly. */
+    envKey?: string;
+    /** Human label for diagnostics. */
+    label?: string;
+}
+/**
+ * Built-in providers. Keyed by the short name used in "provider/model".
+ * baseURLs reflect each provider's public OpenAI-compatible endpoint.
+ */
+export declare const BUILTIN_PROVIDERS: Record<string, RegistryProvider>;
+/** A user-supplied provider entry from notsleep.json (all fields optional). */
+export interface UserProvider {
+    type?: ProviderType;
+    baseURL?: string;
+    apiKey?: string;
+}
+/** A fully-resolved active model ready to construct a client from. */
+export interface ResolvedModel {
+    /** Registry name of the provider, e.g. 'groq'. */
+    providerName: string;
+    /** Protocol to use. */
+    type: ProviderType;
+    /** The model id passed to the API (may contain '/', e.g. openrouter). */
+    model: string;
+    /** Resolved API key. */
+    apiKey: string;
+    /** Resolved base URL (may be undefined = SDK default). */
+    baseURL?: string;
+}
+/** True when a string is a unified "provider/model" selector. */
+export declare function isModelRef(value: string | undefined): value is string;
+/**
+ * Split "provider/model" on the FIRST slash only, so model ids that
+ * themselves contain slashes (e.g. "anthropic/claude-3.5-sonnet" on
+ * OpenRouter) are preserved.
+ */
+export declare function parseModelRef(ref: string): {
+    providerName: string;
+    model: string;
+};
+/**
+ * Resolve a "provider/model" reference against the built-in registry,
+ * overlaid with user-defined providers from config. Returns a fully
+ * resolved model spec, or throws with an actionable message.
+ *
+ * @param ref            e.g. "groq/llama-3.3-70b-versatile"
+ * @param userProviders  the `providers` map from notsleep.json (env refs
+ *                       already resolved), or undefined.
+ * @param env            environment (defaults to process.env), for envKey lookup.
+ */
+export declare function resolveModelRef(ref: string, userProviders?: Record<string, UserProvider>, env?: NodeJS.ProcessEnv): ResolvedModel;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAoBA,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElD,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,IAAI,EAAE,YAAY,CAAC;IACnB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAuE9D,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,aAAa,CAmCf"}

package/dist/registry.js

@@ -0,0 +1,153 @@
+"use strict";
+// ============================================================
+// NotSleep - Built-in Provider Registry
+// ============================================================
+//
+// A small registry of well-known LLM providers, in the spirit of
+// OpenCode / models.dev. The insight it exploits: almost every provider
+// speaks the OpenAI-compatible protocol (POST /v1/chat/completions), so
+// they can all be driven by the OpenAI SDK with a different `baseURL` and
+// `apiKey`. Only Anthropic needs its native SDK (`type: 'anthropic'`).
+//
+// A model is selected with a unified "provider/model" string, e.g.
+//   "groq/llama-3.3-70b-versatile"
+//   "openrouter/anthropic/claude-3.5-sonnet"   (model id may contain '/')
+//   "anthropic/claude-sonnet-4-20250514"
+//
+// Users can add providers or override any field (apiKey, baseURL, type)
+// via the `providers` map in notsleep.json. Unknown provider names are
+// allowed as long as the user defines them there.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_PROVIDERS = void 0;
+exports.isModelRef = isModelRef;
+exports.parseModelRef = parseModelRef;
+exports.resolveModelRef = resolveModelRef;
+/**
+ * Built-in providers. Keyed by the short name used in "provider/model".
+ * baseURLs reflect each provider's public OpenAI-compatible endpoint.
+ */
+exports.BUILTIN_PROVIDERS = {
+    openai: { type: 'openai', envKey: 'OPENAI_API_KEY', label: 'OpenAI' },
+    anthropic: { type: 'anthropic', envKey: 'ANTHROPIC_API_KEY', label: 'Anthropic' },
+    openrouter: {
+        type: 'openai',
+        baseURL: 'https://openrouter.ai/api/v1',
+        envKey: 'OPENROUTER_API_KEY',
+        label: 'OpenRouter',
+    },
+    groq: {
+        type: 'openai',
+        baseURL: 'https://api.groq.com/openai/v1',
+        envKey: 'GROQ_API_KEY',
+        label: 'Groq',
+    },
+    deepseek: {
+        type: 'openai',
+        baseURL: 'https://api.deepseek.com/v1',
+        envKey: 'DEEPSEEK_API_KEY',
+        label: 'DeepSeek',
+    },
+    together: {
+        type: 'openai',
+        baseURL: 'https://api.together.xyz/v1',
+        envKey: 'TOGETHER_API_KEY',
+        label: 'Together AI',
+    },
+    xai: {
+        type: 'openai',
+        baseURL: 'https://api.x.ai/v1',
+        envKey: 'XAI_API_KEY',
+        label: 'xAI (Grok)',
+    },
+    fireworks: {
+        type: 'openai',
+        baseURL: 'https://api.fireworks.ai/inference/v1',
+        envKey: 'FIREWORKS_API_KEY',
+        label: 'Fireworks AI',
+    },
+    mistral: {
+        type: 'openai',
+        baseURL: 'https://api.mistral.ai/v1',
+        envKey: 'MISTRAL_API_KEY',
+        label: 'Mistral',
+    },
+    perplexity: {
+        type: 'openai',
+        baseURL: 'https://api.perplexity.ai',
+        envKey: 'PERPLEXITY_API_KEY',
+        label: 'Perplexity',
+    },
+    gemini: {
+        type: 'openai',
+        baseURL: 'https://generativelanguage.googleapis.com/v1beta/openai/',
+        envKey: 'GEMINI_API_KEY',
+        label: 'Google Gemini',
+    },
+    ollama: {
+        type: 'openai',
+        baseURL: 'http://localhost:11434/v1',
+        // Local server: no real key, but the OpenAI SDK requires a non-empty one.
+        envKey: 'OLLAMA_API_KEY',
+        label: 'Ollama (local)',
+    },
+    limitrouter: {
+        type: 'openai',
+        baseURL: 'https://limitrouter.com/v1',
+        envKey: 'OPENAI_API_KEY',
+        label: 'LimitRouter',
+    },
+};
+/** True when a string is a unified "provider/model" selector. */
+function isModelRef(value) {
+    return typeof value === 'string' && value.includes('/') && value.indexOf('/') > 0;
+}
+/**
+ * Split "provider/model" on the FIRST slash only, so model ids that
+ * themselves contain slashes (e.g. "anthropic/claude-3.5-sonnet" on
+ * OpenRouter) are preserved.
+ */
+function parseModelRef(ref) {
+    const slash = ref.indexOf('/');
+    return {
+        providerName: ref.slice(0, slash).trim(),
+        model: ref.slice(slash + 1).trim(),
+    };
+}
+/**
+ * Resolve a "provider/model" reference against the built-in registry,
+ * overlaid with user-defined providers from config. Returns a fully
+ * resolved model spec, or throws with an actionable message.
+ *
+ * @param ref            e.g. "groq/llama-3.3-70b-versatile"
+ * @param userProviders  the `providers` map from notsleep.json (env refs
+ *                       already resolved), or undefined.
+ * @param env            environment (defaults to process.env), for envKey lookup.
+ */
+function resolveModelRef(ref, userProviders, env = process.env) {
+    const { providerName, model } = parseModelRef(ref);
+    if (!providerName || !model) {
+        throw new Error(`Invalid model "${ref}". Use the "provider/model" format, e.g. "groq/llama-3.3-70b-versatile".`);
+    }
+    const builtin = exports.BUILTIN_PROVIDERS[providerName];
+    const user = userProviders?.[providerName];
+    if (!builtin && !user) {
+        const known = Object.keys(exports.BUILTIN_PROVIDERS).join(', ');
+        throw new Error(`Unknown provider "${providerName}" in model "${ref}". ` +
+            `Either use a built-in provider (${known}) or define "${providerName}" ` +
+            `in the "providers" section of your config with a baseURL and apiKey.`);
+    }
+    const type = user?.type ?? builtin?.type ?? 'openai';
+    const baseURL = user?.baseURL ?? builtin?.baseURL;
+    // API key: explicit user value wins; otherwise read the registry env var.
+    let apiKey = user?.apiKey ?? '';
+    if (!apiKey && builtin?.envKey) {
+        apiKey = env[builtin.envKey] ?? '';
+    }
+    // Local providers (Ollama) work without a real key; give the SDK a filler.
+    if (!apiKey && providerName === 'ollama') {
+        apiKey = 'ollama';
+    }
+    return { providerName, type, model, apiKey, baseURL };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/safety.d.ts

@@ -0,0 +1,21 @@
+/**
+ * True if `child` is the same as, or nested inside, `parent`.
+ * Comparison is case-insensitive on Windows (path.relative handles this).
+ */
+export declare function isPathWithin(child: string, parent: string): boolean;
+/**
+ * Decide whether a file-writing/deleting operation is allowed to touch
+ * `target`. Writes are confined to the workspace root or the OS temp dir.
+ * Returns the resolved absolute path when allowed, or a reason when not.
+ */
+export declare function assertWritablePath(target: string, workspaceRoot: string): {
+    allowed: boolean;
+    resolved: string;
+    reason?: string;
+};
+/**
+ * Inspect a shell command for destructive operations. Returns a human
+ * reason string if the command should be refused, or null if it is allowed.
+ */
+export declare function checkShellCommand(command: string): string | null;
+//# sourceMappingURL=safety.d.ts.map