iobroker.javascript 10.4.0 → 10.4.1

package/build/lib/aiProviderResolver.js

@@ -1,260 +0,0 @@
-"use strict";
-/**
- * Helpers for resolving AI provider credentials in sendTo handlers.
- *
- * Keys are stored as `encryptedNative` + `protectedNative` in io-package.json —
- * they are never sent from the frontend. The backend looks them up in `this.config`
- * based on the `provider` name sent along with each `chatCompletion` or
- * `testApiConnection` request.
- *
- * These functions are extracted so they can be unit-tested in isolation.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_AI_MAX_TOKENS = exports.DEFAULT_AI_MAX_TOKENS = exports.MAX_AI_REQUEST_TIMEOUT_MS = exports.PROVIDER_CREDENTIAL_ID_FIELD = exports.PROVIDER_KEY_FIELD = void 0;
-exports.getProviderCredentialId = getProviderCredentialId;
-exports.resolveProviderCredentials = resolveProviderCredentials;
-exports.resolveTestEndpoint = resolveTestEndpoint;
-exports.resolveRequestTimeout = resolveRequestTimeout;
-exports.resolveTestCredentials = resolveTestCredentials;
-exports.listAvailableProviders = listAvailableProviders;
-exports.extractAiResponseInfo = extractAiResponseInfo;
-exports.describeEmptyAiResponse = describeEmptyAiResponse;
-exports.resolveMaxTokens = resolveMaxTokens;
-/** Maps each provider to the adapter-config field holding its API key. */
-exports.PROVIDER_KEY_FIELD = {
-    openai: 'gptKey',
-    anthropic: 'claudeKey',
-    gemini: 'geminiKey',
-    deepseek: 'deepseekKey',
-    custom: 'gptBaseUrlKey',
-};
-/**
- * Maps each provider to the adapter-config field holding the ID of its credential
- * in the central credential store (used in `manager` mode).
- */
-exports.PROVIDER_CREDENTIAL_ID_FIELD = {
-    openai: 'credentialIdGptKey',
-    anthropic: 'credentialIdClaudeKey',
-    gemini: 'credentialIdGeminiKey',
-    deepseek: 'credentialIdDeepseekKey',
-    custom: 'credentialIdGptBaseUrlKey',
-};
-/**
- * Returns the configured credential ID (e.g. `system.credentials.anthropic`) for a provider
- * in `manager` mode, or an empty string if none/unknown provider.
- */
-function getProviderCredentialId(config, provider) {
-    const cfg = config || {};
-    const field = exports.PROVIDER_CREDENTIAL_ID_FIELD[provider];
-    return field ? (cfg[field] || '').toString().trim() : '';
-}
-/**
- * Resolve API key and base URL for a provider from adapter config.
- *
- * Both come from the configuration and from nowhere else - above all not from the message that asked
- * for them. The key that is resolved here travels with the request as its authorisation, so a caller
- * who could name the address could have this instance carry the key to one of their own. An address
- * out of a message used to win over the stored one, which was the comfortable way to put a proxy in
- * front of OpenAI; a proxy belongs in the configuration now, entered once by whoever may configure
- * this instance. The test button of the settings dialog is the one exception - see
- * {@link resolveTestEndpoint}.
- *
- * The stored `gptBaseUrl` belongs to the `custom` provider and to no other. `openai` used to inherit
- * it, which sent every request meant for api.openai.com - and the OpenAI key with it - to whatever
- * host the custom endpoint pointed at (#2369).
- */
-function resolveProviderCredentials(config, provider) {
-    const cfg = config || {};
-    const keyField = exports.PROVIDER_KEY_FIELD[provider];
-    const apiKey = keyField ? (cfg[keyField] || '').toString().trim() : '';
-    const baseUrl = provider === 'custom' ? (cfg.gptBaseUrl || '').toString().trim() : '';
-    return { apiKey, baseUrl };
-}
-/**
- * The address the Test button of the settings dialog may try.
- *
- * The dialog tests what stands in the form rather than what was saved, because the first thing
- * anybody does is type a key and press it. The one thing it must not do is make this instance carry a
- * secret of its own to an address that came with the message, so an address out of the form counts
- * only together with a key out of the form: one's own key to one's own endpoint gives nothing away.
- * As soon as the key comes from this system - from the configuration or from the credential store -
- * the address comes from there too. And only the OpenAI-compatible provider has an address to try;
- * the form has no field for one anywhere else.
- *
- * @param config the adapter configuration
- * @param provider the provider that is being tested
- * @param form what the Test button sent
- * @param form.apiKey the key that stands in the form, if any
- * @param form.baseUrl the address that stands in the form, if any
- */
-function resolveTestEndpoint(config, provider, form) {
-    const stored = resolveProviderCredentials(config, provider).baseUrl;
-    const formKey = (form.apiKey || '').toString().trim();
-    const formUrl = (form.baseUrl || '').toString().trim();
-    if (provider !== 'custom' || !formKey || !formUrl) {
-        return stored;
-    }
-    return formUrl;
-}
-/** Ceiling for an AI request, and the budget when the caller names none */
-exports.MAX_AI_REQUEST_TIMEOUT_MS = 600_000;
-/**
- * How long to wait for an AI endpoint, from the `timeout` the caller put in the message.
- *
- * The inline completion asks for a short budget because it must not sit on the editor, the chat
- * panel for a long one because a reasoning model takes its time. The field was sent all along but
- * never read, so both of them waited out the full ten minutes.
- *
- * @param messageTimeout the value from the sendTo message, in milliseconds
- */
-function resolveRequestTimeout(messageTimeout) {
-    const requested = parseInt(messageTimeout, 10);
-    // Nothing usable, or a zero - which is how Node itself spells "no timeout" - gets the ceiling
-    if (isNaN(requested) || requested <= 0) {
-        return exports.MAX_AI_REQUEST_TIMEOUT_MS;
-    }
-    // A second is the floor: below that not even a local model gets a chance to answer
-    return Math.min(Math.max(requested, 1000), exports.MAX_AI_REQUEST_TIMEOUT_MS);
-}
-/**
- * For the testApiConnection sendTo command: if the caller supplied an apiKey
- * (settings-dialog form value), use it; otherwise fall back to the stored key.
- */
-function resolveTestCredentials(config, provider, messageApiKey, messageBaseUrl) {
-    const fallback = resolveProviderCredentials(config, provider);
-    const explicitKey = (messageApiKey || '').toString().trim();
-    return {
-        apiKey: explicitKey || fallback.apiKey,
-        // only together with a key of the form, and only for the endpoint of one's own
-        baseUrl: resolveTestEndpoint(config, provider, { apiKey: explicitKey, baseUrl: messageBaseUrl }),
-    };
-}
-/**
- * List of providers that have credentials configured in this.config.
- * Used by the `getAvailableAiProviders` sendTo command so the frontend
- * knows which provider icons/models to show without ever seeing a key.
- */
-function listAvailableProviders(config) {
-    const cfg = config || {};
-    const providers = [];
-    const manager = cfg.credentialType === 'manager';
-    // A key-based provider is "available" if it has a stored key (manual mode)
-    // or a selected credential ID (manager mode).
-    const has = (provider, key) => manager ? !!getProviderCredentialId(cfg, provider) : !!(key || '').trim();
-    if (has('openai', cfg.gptKey)) {
-        providers.push({ provider: 'openai' });
-    }
-    if (has('anthropic', cfg.claudeKey)) {
-        providers.push({ provider: 'anthropic' });
-    }
-    if (has('gemini', cfg.geminiKey)) {
-        providers.push({ provider: 'gemini' });
-    }
-    if (has('deepseek', cfg.deepseekKey)) {
-        providers.push({ provider: 'deepseek' });
-    }
-    // The custom/OpenAI-compatible endpoint is identified by its base URL (the key is optional,
-    // e.g. local Ollama), so its availability does not depend on the credential mode.
-    if ((cfg.gptBaseUrl || '').trim()) {
-        providers.push({ provider: 'custom', baseUrl: cfg.gptBaseUrl });
-    }
-    return providers;
-}
-function toCount(value) {
-    return typeof value === 'number' && isFinite(value) ? value : undefined;
-}
-/**
- * Pull the "why did it stop" fields out of a chat-completion response.
- *
- * Anthropic and the OpenAI-compatible endpoints spell both the reason and the token counts
- * differently. The adapter normalizes them and passes them on to the editor, so an answer that
- * was cut off or filtered can say so instead of arriving as an empty chat bubble.
- */
-function extractAiResponseInfo(parsed) {
-    const info = {};
-    const reason = parsed?.stop_reason ?? parsed?.choices?.[0]?.finish_reason;
-    if (typeof reason === 'string' && reason) {
-        info.finishReason = reason;
-    }
-    const input = toCount(parsed?.usage?.input_tokens ?? parsed?.usage?.prompt_tokens);
-    const output = toCount(parsed?.usage?.output_tokens ?? parsed?.usage?.completion_tokens);
-    if (input !== undefined || output !== undefined) {
-        info.usage = {
-            ...(input !== undefined ? { input } : {}),
-            ...(output !== undefined ? { output } : {}),
-        };
-    }
-    return info;
-}
-/**
- * Why a 200 OK answer carried neither text nor a tool call.
- *
- * "Empty response from API" is true but useless - it sends the user looking for a broken key
- * when the usual cause is a model that spent its whole output budget on reasoning tokens. The
- * endpoint nearly always says why it stopped, so repeat that, and append a slice of the raw
- * body for the cases where it does not.
- *
- * @param info the normalized stop reason and token counts
- * @param rawBody the response body as it came off the wire
- */
-function describeEmptyAiResponse(info, rawBody) {
-    let why;
-    switch (info.finishReason) {
-        case 'max_tokens':
-        case 'length':
-            why = 'the model used up its output budget before writing an answer';
-            break;
-        case 'content_filter':
-        case 'refusal':
-            why = 'the endpoint filtered the answer away';
-            break;
-        case 'tool_use':
-        case 'tool_calls':
-            why = 'the model wanted to call a tool, but the answer carried no readable tool call';
-            break;
-        default:
-            why = info.finishReason ? `the endpoint stopped with "${info.finishReason}"` : '';
-            break;
-    }
-    const details = [];
-    if (info.finishReason) {
-        details.push(`stop reason: ${info.finishReason}`);
-    }
-    if (info.usage?.input !== undefined || info.usage?.output !== undefined) {
-        details.push(`tokens in/out: ${info.usage?.input ?? '?'}/${info.usage?.output ?? '?'}`);
-    }
-    let message = 'The API answered without any content';
-    if (why) {
-        message += ` - ${why}`;
-    }
-    if (details.length) {
-        message += ` (${details.join(', ')})`;
-    }
-    // Only worth showing when the endpoint told us nothing usable at all
-    if (!info.finishReason && rawBody) {
-        message += `. Response: ${rawBody.substring(0, 200)}`;
-    }
-    return message;
-}
-/** What Anthropic gets as `max_tokens` when the setting is empty or unusable */
-exports.DEFAULT_AI_MAX_TOKENS = 8192;
-/** Highest `max_tokens` the setting may ask for - beyond this every current model answers 400 */
-exports.MAX_AI_MAX_TOKENS = 200_000;
-/**
- * The output budget for an Anthropic request.
- *
- * Anthropic insists on `max_tokens`, so there is no "let the endpoint decide". Too small and a
- * generated script is cut off mid-line; too large and the model rejects the request outright, so
- * the configured value is clamped into a range every model can live with.
- *
- * @param configured the value from the adapter settings
- */
-function resolveMaxTokens(configured) {
-    const requested = parseInt(configured, 10);
-    if (isNaN(requested) || requested <= 0) {
-        return exports.DEFAULT_AI_MAX_TOKENS;
-    }
-    // 1024 is the floor: below that not even a short answer with its reasoning fits
-    return Math.min(Math.max(requested, 1024), exports.MAX_AI_MAX_TOKENS);
-}
-//# sourceMappingURL=aiProviderResolver.js.map

package/build/lib/aiProviderResolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"aiProviderResolver.js","sourceRoot":"","sources":["../../src/lib/aiProviderResolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Helpers for resolving AI provider credentials in sendTo handlers.\n *\n * Keys are stored as `encryptedNative` + `protectedNative` in io-package.json —\n * they are never sent from the frontend. The backend looks them up in `this.config`\n * based on the `provider` name sent along with each `chatCompletion` or\n * `testApiConnection` request.\n *\n * These functions are extracted so they can be unit-tested in isolation.\n */\n\n/** Configuration subset that carries AI credentials. */\nexport interface AiConfigSlice {\n    gptKey?: string;\n    gptBaseUrl?: string;\n    gptBaseUrlKey?: string;\n    claudeKey?: string;\n    geminiKey?: string;\n    deepseekKey?: string;\n    /**\n     * Where the API keys come from:\n     * - `manual`: keys are stored directly in the adapter config (encryptedNative)\n     * - `manager`: the config only stores the ID of a credential in the central\n     *   ioBroker credential store (`system.credentials.*`), resolved at runtime\n     */\n    credentialType?: 'manual' | 'manager';\n    credentialIdGptKey?: string;\n    credentialIdClaudeKey?: string;\n    credentialIdGeminiKey?: string;\n    credentialIdDeepseekKey?: string;\n    credentialIdGptBaseUrlKey?: string;\n}\n\nexport type AiProvider = 'openai' | 'anthropic' | 'gemini' | 'deepseek' | 'custom';\n\n/** Maps each provider to the adapter-config field holding its API key. */\nexport const PROVIDER_KEY_FIELD: Record<AiProvider, keyof AiConfigSlice> = {\n    openai: 'gptKey',\n    anthropic: 'claudeKey',\n    gemini: 'geminiKey',\n    deepseek: 'deepseekKey',\n    custom: 'gptBaseUrlKey',\n};\n\n/**\n * Maps each provider to the adapter-config field holding the ID of its credential\n * in the central credential store (used in `manager` mode).\n */\nexport const PROVIDER_CREDENTIAL_ID_FIELD: Record<AiProvider, keyof AiConfigSlice> = {\n    openai: 'credentialIdGptKey',\n    anthropic: 'credentialIdClaudeKey',\n    gemini: 'credentialIdGeminiKey',\n    deepseek: 'credentialIdDeepseekKey',\n    custom: 'credentialIdGptBaseUrlKey',\n};\n\n/**\n * Returns the configured credential ID (e.g. `system.credentials.anthropic`) for a provider\n * in `manager` mode, or an empty string if none/unknown provider.\n */\nexport function getProviderCredentialId(config: AiConfigSlice | undefined | null, provider: string): string {\n    const cfg = config || {};\n    const field = PROVIDER_CREDENTIAL_ID_FIELD[provider as AiProvider];\n    return field ? (cfg[field] || '').toString().trim() : '';\n}\n\n/**\n * Resolve API key and base URL for a provider from adapter config.\n *\n * Both come from the configuration and from nowhere else - above all not from the message that asked\n * for them. The key that is resolved here travels with the request as its authorisation, so a caller\n * who could name the address could have this instance carry the key to one of their own. An address\n * out of a message used to win over the stored one, which was the comfortable way to put a proxy in\n * front of OpenAI; a proxy belongs in the configuration now, entered once by whoever may configure\n * this instance. The test button of the settings dialog is the one exception - see\n * {@link resolveTestEndpoint}.\n *\n * The stored `gptBaseUrl` belongs to the `custom` provider and to no other. `openai` used to inherit\n * it, which sent every request meant for api.openai.com - and the OpenAI key with it - to whatever\n * host the custom endpoint pointed at (#2369).\n */\nexport function resolveProviderCredentials(\n    config: AiConfigSlice | undefined | null,\n    provider: string,\n): { apiKey: string; baseUrl: string } {\n    const cfg = config || {};\n    const keyField = PROVIDER_KEY_FIELD[provider as AiProvider];\n    const apiKey = keyField ? (cfg[keyField] || '').toString().trim() : '';\n    const baseUrl = provider === 'custom' ? (cfg.gptBaseUrl || '').toString().trim() : '';\n    return { apiKey, baseUrl };\n}\n\n/**\n * The address the Test button of the settings dialog may try.\n *\n * The dialog tests what stands in the form rather than what was saved, because the first thing\n * anybody does is type a key and press it. The one thing it must not do is make this instance carry a\n * secret of its own to an address that came with the message, so an address out of the form counts\n * only together with a key out of the form: one's own key to one's own endpoint gives nothing away.\n * As soon as the key comes from this system - from the configuration or from the credential store -\n * the address comes from there too. And only the OpenAI-compatible provider has an address to try;\n * the form has no field for one anywhere else.\n *\n * @param config the adapter configuration\n * @param provider the provider that is being tested\n * @param form what the Test button sent\n * @param form.apiKey the key that stands in the form, if any\n * @param form.baseUrl the address that stands in the form, if any\n */\nexport function resolveTestEndpoint(\n    config: AiConfigSlice | undefined | null,\n    provider: string,\n    form: { apiKey?: string; baseUrl?: string },\n): string {\n    const stored = resolveProviderCredentials(config, provider).baseUrl;\n    const formKey = (form.apiKey || '').toString().trim();\n    const formUrl = (form.baseUrl || '').toString().trim();\n    if (provider !== 'custom' || !formKey || !formUrl) {\n        return stored;\n    }\n    return formUrl;\n}\n\n/** Ceiling for an AI request, and the budget when the caller names none */\nexport const MAX_AI_REQUEST_TIMEOUT_MS = 600_000;\n\n/**\n * How long to wait for an AI endpoint, from the `timeout` the caller put in the message.\n *\n * The inline completion asks for a short budget because it must not sit on the editor, the chat\n * panel for a long one because a reasoning model takes its time. The field was sent all along but\n * never read, so both of them waited out the full ten minutes.\n *\n * @param messageTimeout the value from the sendTo message, in milliseconds\n */\nexport function resolveRequestTimeout(messageTimeout?: unknown): number {\n    const requested = parseInt(messageTimeout as string, 10);\n    // Nothing usable, or a zero - which is how Node itself spells \"no timeout\" - gets the ceiling\n    if (isNaN(requested) || requested <= 0) {\n        return MAX_AI_REQUEST_TIMEOUT_MS;\n    }\n    // A second is the floor: below that not even a local model gets a chance to answer\n    return Math.min(Math.max(requested, 1000), MAX_AI_REQUEST_TIMEOUT_MS);\n}\n\n/**\n * For the testApiConnection sendTo command: if the caller supplied an apiKey\n * (settings-dialog form value), use it; otherwise fall back to the stored key.\n */\nexport function resolveTestCredentials(\n    config: AiConfigSlice | undefined | null,\n    provider: string,\n    messageApiKey?: string,\n    messageBaseUrl?: string,\n): { apiKey: string; baseUrl: string } {\n    const fallback = resolveProviderCredentials(config, provider);\n    const explicitKey = (messageApiKey || '').toString().trim();\n    return {\n        apiKey: explicitKey || fallback.apiKey,\n        // only together with a key of the form, and only for the endpoint of one's own\n        baseUrl: resolveTestEndpoint(config, provider, { apiKey: explicitKey, baseUrl: messageBaseUrl }),\n    };\n}\n\n/**\n * List of providers that have credentials configured in this.config.\n * Used by the `getAvailableAiProviders` sendTo command so the frontend\n * knows which provider icons/models to show without ever seeing a key.\n */\nexport function listAvailableProviders(\n    config: AiConfigSlice | undefined | null,\n): { provider: AiProvider; baseUrl?: string }[] {\n    const cfg = config || {};\n    const providers: { provider: AiProvider; baseUrl?: string }[] = [];\n    const manager = cfg.credentialType === 'manager';\n    // A key-based provider is \"available\" if it has a stored key (manual mode)\n    // or a selected credential ID (manager mode).\n    const has = (provider: AiProvider, key: string | undefined | null): boolean =>\n        manager ? !!getProviderCredentialId(cfg, provider) : !!(key || '').trim();\n    if (has('openai', cfg.gptKey)) {\n        providers.push({ provider: 'openai' });\n    }\n    if (has('anthropic', cfg.claudeKey)) {\n        providers.push({ provider: 'anthropic' });\n    }\n    if (has('gemini', cfg.geminiKey)) {\n        providers.push({ provider: 'gemini' });\n    }\n    if (has('deepseek', cfg.deepseekKey)) {\n        providers.push({ provider: 'deepseek' });\n    }\n    // The custom/OpenAI-compatible endpoint is identified by its base URL (the key is optional,\n    // e.g. local Ollama), so its availability does not depend on the credential mode.\n    if ((cfg.gptBaseUrl || '').trim()) {\n        providers.push({ provider: 'custom', baseUrl: cfg.gptBaseUrl });\n    }\n    return providers;\n}\n\n/** What a chat endpoint reported about how it finished a completion. */\nexport interface AiResponseInfo {\n    /** Anthropic's `stop_reason` or the OpenAI-compatible `finish_reason`, when the endpoint sends one */\n    finishReason?: string;\n    /** Token counts, as far as the endpoint reports them */\n    usage?: { input?: number; output?: number };\n}\n\n/** The handful of fields of a chat-completion response that say how it ended. */\nexport interface AiRawResponse {\n    stop_reason?: unknown;\n    choices?: { finish_reason?: unknown }[];\n    usage?: {\n        input_tokens?: unknown;\n        output_tokens?: unknown;\n        prompt_tokens?: unknown;\n        completion_tokens?: unknown;\n    };\n}\n\nfunction toCount(value: unknown): number | undefined {\n    return typeof value === 'number' && isFinite(value) ? value : undefined;\n}\n\n/**\n * Pull the \"why did it stop\" fields out of a chat-completion response.\n *\n * Anthropic and the OpenAI-compatible endpoints spell both the reason and the token counts\n * differently. The adapter normalizes them and passes them on to the editor, so an answer that\n * was cut off or filtered can say so instead of arriving as an empty chat bubble.\n */\nexport function extractAiResponseInfo(parsed: AiRawResponse | null | undefined): AiResponseInfo {\n    const info: AiResponseInfo = {};\n    const reason = parsed?.stop_reason ?? parsed?.choices?.[0]?.finish_reason;\n    if (typeof reason === 'string' && reason) {\n        info.finishReason = reason;\n    }\n    const input = toCount(parsed?.usage?.input_tokens ?? parsed?.usage?.prompt_tokens);\n    const output = toCount(parsed?.usage?.output_tokens ?? parsed?.usage?.completion_tokens);\n    if (input !== undefined || output !== undefined) {\n        info.usage = {\n            ...(input !== undefined ? { input } : {}),\n            ...(output !== undefined ? { output } : {}),\n        };\n    }\n    return info;\n}\n\n/**\n * Why a 200 OK answer carried neither text nor a tool call.\n *\n * \"Empty response from API\" is true but useless - it sends the user looking for a broken key\n * when the usual cause is a model that spent its whole output budget on reasoning tokens. The\n * endpoint nearly always says why it stopped, so repeat that, and append a slice of the raw\n * body for the cases where it does not.\n *\n * @param info the normalized stop reason and token counts\n * @param rawBody the response body as it came off the wire\n */\nexport function describeEmptyAiResponse(info: AiResponseInfo, rawBody?: string): string {\n    let why: string;\n    switch (info.finishReason) {\n        case 'max_tokens':\n        case 'length':\n            why = 'the model used up its output budget before writing an answer';\n            break;\n        case 'content_filter':\n        case 'refusal':\n            why = 'the endpoint filtered the answer away';\n            break;\n        case 'tool_use':\n        case 'tool_calls':\n            why = 'the model wanted to call a tool, but the answer carried no readable tool call';\n            break;\n        default:\n            why = info.finishReason ? `the endpoint stopped with \"${info.finishReason}\"` : '';\n            break;\n    }\n    const details: string[] = [];\n    if (info.finishReason) {\n        details.push(`stop reason: ${info.finishReason}`);\n    }\n    if (info.usage?.input !== undefined || info.usage?.output !== undefined) {\n        details.push(`tokens in/out: ${info.usage?.input ?? '?'}/${info.usage?.output ?? '?'}`);\n    }\n    let message = 'The API answered without any content';\n    if (why) {\n        message += ` - ${why}`;\n    }\n    if (details.length) {\n        message += ` (${details.join(', ')})`;\n    }\n    // Only worth showing when the endpoint told us nothing usable at all\n    if (!info.finishReason && rawBody) {\n        message += `. Response: ${rawBody.substring(0, 200)}`;\n    }\n    return message;\n}\n\n/** What Anthropic gets as `max_tokens` when the setting is empty or unusable */\nexport const DEFAULT_AI_MAX_TOKENS = 8192;\n/** Highest `max_tokens` the setting may ask for - beyond this every current model answers 400 */\nexport const MAX_AI_MAX_TOKENS = 200_000;\n\n/**\n * The output budget for an Anthropic request.\n *\n * Anthropic insists on `max_tokens`, so there is no \"let the endpoint decide\". Too small and a\n * generated script is cut off mid-line; too large and the model rejects the request outright, so\n * the configured value is clamped into a range every model can live with.\n *\n * @param configured the value from the adapter settings\n */\nexport function resolveMaxTokens(configured?: unknown): number {\n    const requested = parseInt(configured as string, 10);\n    if (isNaN(requested) || requested <= 0) {\n        return DEFAULT_AI_MAX_TOKENS;\n    }\n    // 1024 is the floor: below that not even a short answer with its reasoning fits\n    return Math.min(Math.max(requested, 1024), MAX_AI_MAX_TOKENS);\n}\n"]}

package/build/lib/anthropicAdapter.js

@@ -1,212 +0,0 @@
-"use strict";
-/**
- * Translation layer between OpenAI-style chat-completion messages/tools and
- * Anthropic's native Messages API.
- *
- * The frontend (AiChatService / useAiChat) always speaks the OpenAI format:
- *   - tools[] = [{ type: 'function', function: { name, description, parameters } }]
- *   - assistant message with tool_calls[] = [{ id, type: 'function', function: { name, arguments } }]
- *   - tool-result message with { role: 'tool', tool_call_id, content }
- *   - response = { content, tool_calls? }
- *
- * Anthropic's API uses a different shape:
- *   - tools[] = [{ name, description, input_schema }]
- *   - assistant message content = [{ type: 'text', text }, { type: 'tool_use', id, name, input }]
- *   - tool-result = user message with content = [{ type: 'tool_result', tool_use_id, content }]
- *   - response body = { content: [text/tool_use blocks], stop_reason }
- *
- * These functions are pure so they can be unit-tested in isolation.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.translateToolsToAnthropic = translateToolsToAnthropic;
-exports.translateMessagesToAnthropic = translateMessagesToAnthropic;
-exports.translateAnthropicResponseToOpenAI = translateAnthropicResponseToOpenAI;
-exports.describeAnthropicContent = describeAnthropicContent;
-/** Translate OpenAI function-tool definitions to Anthropic tool definitions. */
-function translateToolsToAnthropic(tools) {
-    if (!Array.isArray(tools)) {
-        return [];
-    }
-    const result = [];
-    for (const t of tools) {
-        // Only `function`-type tools are supported. Anthropic uses a flat shape.
-        const tool = t;
-        const fn = tool?.function;
-        if (!fn?.name) {
-            continue;
-        }
-        result.push({
-            name: fn.name,
-            description: fn.description,
-            // OpenAI's `parameters` and Anthropic's `input_schema` share the JSON Schema shape.
-            // If none is provided, Anthropic still requires an object schema.
-            input_schema: fn.parameters || { type: 'object', properties: {} },
-        });
-    }
-    return result;
-}
-/** Safe JSON.parse that returns an object on failure so we never throw mid-translation. */
-function safeParseArgs(args) {
-    if (!args) {
-        return {};
-    }
-    try {
-        const parsed = JSON.parse(args);
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            return parsed;
-        }
-        return {};
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Translate a flat OpenAI-style message array into Anthropic's content-block format.
- *  System messages are extracted and returned separately (Anthropic takes `system`
- *  as a top-level request field, not an inline message).
- */
-function translateMessagesToAnthropic(messages) {
-    if (!Array.isArray(messages)) {
-        return { system: '', messages: [] };
-    }
-    const systemChunks = [];
-    const out = [];
-    // Pending tool-results that must be grouped into a single `user` message per Anthropic's rules.
-    let pendingToolResults = [];
-    const flushToolResults = () => {
-        if (pendingToolResults.length) {
-            out.push({ role: 'user', content: pendingToolResults });
-            pendingToolResults = [];
-        }
-    };
-    for (const m of messages) {
-        if (!m || typeof m !== 'object') {
-            continue;
-        }
-        if (m.role === 'system') {
-            if (typeof m.content === 'string' && m.content) {
-                systemChunks.push(m.content);
-            }
-            continue;
-        }
-        if (m.role === 'tool') {
-            // Tool results accumulate; they're flushed when the next non-tool message appears.
-            pendingToolResults.push({
-                type: 'tool_result',
-                tool_use_id: m.tool_call_id || '',
-                content: typeof m.content === 'string' ? m.content : JSON.stringify(m.content ?? ''),
-            });
-            continue;
-        }
-        flushToolResults();
-        if (m.role === 'assistant') {
-            const blocks = [];
-            if (typeof m.content === 'string' && m.content) {
-                blocks.push({ type: 'text', text: m.content });
-            }
-            if (Array.isArray(m.tool_calls)) {
-                for (const tc of m.tool_calls) {
-                    if (!tc?.id || !tc.function?.name) {
-                        continue;
-                    }
-                    blocks.push({
-                        type: 'tool_use',
-                        id: tc.id,
-                        name: tc.function.name,
-                        input: safeParseArgs(tc.function.arguments),
-                    });
-                }
-            }
-            // Anthropic requires a non-empty content array for assistant messages.
-            if (blocks.length) {
-                out.push({ role: 'assistant', content: blocks });
-            }
-            continue;
-        }
-        if (m.role === 'user') {
-            // Plain text user message. Content blocks aren't needed here.
-            const text = typeof m.content === 'string' ? m.content : '';
-            if (text) {
-                out.push({ role: 'user', content: text });
-            }
-            continue;
-        }
-    }
-    flushToolResults();
-    return { system: systemChunks.join('\n\n'), messages: out };
-}
-/**
- * Translate an Anthropic Messages API response back into the OpenAI-style
- *  `{ content, tool_calls }` shape that our frontend already understands.
- */
-function translateAnthropicResponseToOpenAI(response) {
-    if (!response || !Array.isArray(response.content)) {
-        return { content: '' };
-    }
-    const textParts = [];
-    const toolCalls = [];
-    for (const block of response.content) {
-        if (!block || typeof block !== 'object') {
-            continue;
-        }
-        if (block.type === 'text' && typeof block.text === 'string') {
-            textParts.push(block.text);
-        }
-        else if (block.type === 'tool_use') {
-            const tu = block;
-            toolCalls.push({
-                id: tu.id || '',
-                type: 'function',
-                function: {
-                    name: tu.name || '',
-                    arguments: JSON.stringify(tu.input ?? {}),
-                },
-            });
-        }
-    }
-    const result = {
-        content: textParts.join('\n'),
-    };
-    if (toolCalls.length) {
-        result.tool_calls = toolCalls;
-    }
-    return result;
-}
-/**
- * Name the content blocks an answer consists of, for the log.
- *
- * When the translation above comes back empty although the endpoint reported a normal end and a
- * few hundred output tokens, the whole question is *what* it sent instead - a `thinking` block, a
- * block type that did not exist when this was written, an empty text. Without this the log can
- * only say "no content", which is the one thing already known.
- *
- * @param response the parsed answer of the Anthropic API
- */
-function describeAnthropicContent(response) {
-    if (!response) {
-        return 'no response';
-    }
-    if (!Array.isArray(response.content)) {
-        return `content is ${typeof response.content}`;
-    }
-    if (!response.content.length) {
-        return 'no content blocks';
-    }
-    return response.content
-        .map(block => {
-        if (!block || typeof block !== 'object') {
-            return typeof block;
-        }
-        const type = block.type;
-        const name = typeof type === 'string' ? type : 'untyped';
-        // An empty text block is a different problem from a block nobody reads
-        if (name === 'text') {
-            const text = block.text;
-            return typeof text === 'string' ? `text(${text.length} chars)` : `text(${typeof text})`;
-        }
-        return name;
-    })
-        .join(', ');
-}
-//# sourceMappingURL=anthropicAdapter.js.map

package/build/lib/anthropicAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"anthropicAdapter.js","sourceRoot":"","sources":["../../src/lib/anthropicAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Translation layer between OpenAI-style chat-completion messages/tools and\n * Anthropic's native Messages API.\n *\n * The frontend (AiChatService / useAiChat) always speaks the OpenAI format:\n *   - tools[] = [{ type: 'function', function: { name, description, parameters } }]\n *   - assistant message with tool_calls[] = [{ id, type: 'function', function: { name, arguments } }]\n *   - tool-result message with { role: 'tool', tool_call_id, content }\n *   - response = { content, tool_calls? }\n *\n * Anthropic's API uses a different shape:\n *   - tools[] = [{ name, description, input_schema }]\n *   - assistant message content = [{ type: 'text', text }, { type: 'tool_use', id, name, input }]\n *   - tool-result = user message with content = [{ type: 'tool_result', tool_use_id, content }]\n *   - response body = { content: [text/tool_use blocks], stop_reason }\n *\n * These functions are pure so they can be unit-tested in isolation.\n */\n\nexport interface OpenAITool {\n    type: 'function';\n    function: {\n        name: string;\n        description?: string;\n        parameters?: unknown;\n    };\n}\n\nexport interface AnthropicTool {\n    name: string;\n    description?: string;\n    input_schema: unknown;\n}\n\nexport interface OpenAIToolCall {\n    id: string;\n    type: 'function';\n    function: {\n        name: string;\n        arguments: string;\n    };\n}\n\nexport interface OpenAIMessage {\n    role: 'system' | 'user' | 'assistant' | 'tool';\n    content?: string | null;\n    tool_calls?: OpenAIToolCall[];\n    tool_call_id?: string;\n    name?: string;\n}\n\ntype AnthropicContentBlock =\n    | { type: 'text'; text: string }\n    | { type: 'tool_use'; id: string; name: string; input: Record<string, unknown> }\n    | { type: 'tool_result'; tool_use_id: string; content: string; is_error?: boolean };\n\nexport interface AnthropicMessage {\n    role: 'user' | 'assistant';\n    content: string | AnthropicContentBlock[];\n}\n\nexport interface AnthropicResponse {\n    content?: AnthropicContentBlock[];\n    stop_reason?: string;\n    [key: string]: unknown;\n}\n\n/** Translate OpenAI function-tool definitions to Anthropic tool definitions. */\nexport function translateToolsToAnthropic(tools: unknown[] | undefined | null): AnthropicTool[] {\n    if (!Array.isArray(tools)) {\n        return [];\n    }\n    const result: AnthropicTool[] = [];\n    for (const t of tools) {\n        // Only `function`-type tools are supported. Anthropic uses a flat shape.\n        const tool = t as OpenAITool;\n        const fn = tool?.function;\n        if (!fn?.name) {\n            continue;\n        }\n        result.push({\n            name: fn.name,\n            description: fn.description,\n            // OpenAI's `parameters` and Anthropic's `input_schema` share the JSON Schema shape.\n            // If none is provided, Anthropic still requires an object schema.\n            input_schema: fn.parameters || { type: 'object', properties: {} },\n        });\n    }\n    return result;\n}\n\n/** Safe JSON.parse that returns an object on failure so we never throw mid-translation. */\nfunction safeParseArgs(args: string | undefined): Record<string, unknown> {\n    if (!args) {\n        return {};\n    }\n    try {\n        const parsed: unknown = JSON.parse(args);\n        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {\n            return parsed as Record<string, unknown>;\n        }\n        return {};\n    } catch {\n        return {};\n    }\n}\n\n/**\n * Translate a flat OpenAI-style message array into Anthropic's content-block format.\n *  System messages are extracted and returned separately (Anthropic takes `system`\n *  as a top-level request field, not an inline message).\n */\nexport function translateMessagesToAnthropic(messages: OpenAIMessage[] | undefined | null): {\n    system: string;\n    messages: AnthropicMessage[];\n} {\n    if (!Array.isArray(messages)) {\n        return { system: '', messages: [] };\n    }\n\n    const systemChunks: string[] = [];\n    const out: AnthropicMessage[] = [];\n    // Pending tool-results that must be grouped into a single `user` message per Anthropic's rules.\n    let pendingToolResults: AnthropicContentBlock[] = [];\n\n    const flushToolResults = (): void => {\n        if (pendingToolResults.length) {\n            out.push({ role: 'user', content: pendingToolResults });\n            pendingToolResults = [];\n        }\n    };\n\n    for (const m of messages) {\n        if (!m || typeof m !== 'object') {\n            continue;\n        }\n\n        if (m.role === 'system') {\n            if (typeof m.content === 'string' && m.content) {\n                systemChunks.push(m.content);\n            }\n            continue;\n        }\n\n        if (m.role === 'tool') {\n            // Tool results accumulate; they're flushed when the next non-tool message appears.\n            pendingToolResults.push({\n                type: 'tool_result',\n                tool_use_id: m.tool_call_id || '',\n                content: typeof m.content === 'string' ? m.content : JSON.stringify(m.content ?? ''),\n            });\n            continue;\n        }\n\n        flushToolResults();\n\n        if (m.role === 'assistant') {\n            const blocks: AnthropicContentBlock[] = [];\n            if (typeof m.content === 'string' && m.content) {\n                blocks.push({ type: 'text', text: m.content });\n            }\n            if (Array.isArray(m.tool_calls)) {\n                for (const tc of m.tool_calls) {\n                    if (!tc?.id || !tc.function?.name) {\n                        continue;\n                    }\n                    blocks.push({\n                        type: 'tool_use',\n                        id: tc.id,\n                        name: tc.function.name,\n                        input: safeParseArgs(tc.function.arguments),\n                    });\n                }\n            }\n            // Anthropic requires a non-empty content array for assistant messages.\n            if (blocks.length) {\n                out.push({ role: 'assistant', content: blocks });\n            }\n            continue;\n        }\n\n        if (m.role === 'user') {\n            // Plain text user message. Content blocks aren't needed here.\n            const text = typeof m.content === 'string' ? m.content : '';\n            if (text) {\n                out.push({ role: 'user', content: text });\n            }\n            continue;\n        }\n    }\n\n    flushToolResults();\n\n    return { system: systemChunks.join('\\n\\n'), messages: out };\n}\n\n/**\n * Translate an Anthropic Messages API response back into the OpenAI-style\n *  `{ content, tool_calls }` shape that our frontend already understands.\n */\nexport function translateAnthropicResponseToOpenAI(response: AnthropicResponse | undefined | null): {\n    content: string;\n    tool_calls?: OpenAIToolCall[];\n} {\n    if (!response || !Array.isArray(response.content)) {\n        return { content: '' };\n    }\n    const textParts: string[] = [];\n    const toolCalls: OpenAIToolCall[] = [];\n    for (const block of response.content) {\n        if (!block || typeof block !== 'object') {\n            continue;\n        }\n        if (block.type === 'text' && typeof (block as { text?: unknown }).text === 'string') {\n            textParts.push((block as { text: string }).text);\n        } else if (block.type === 'tool_use') {\n            const tu = block as { id?: string; name?: string; input?: unknown };\n            toolCalls.push({\n                id: tu.id || '',\n                type: 'function',\n                function: {\n                    name: tu.name || '',\n                    arguments: JSON.stringify(tu.input ?? {}),\n                },\n            });\n        }\n    }\n    const result: { content: string; tool_calls?: OpenAIToolCall[] } = {\n        content: textParts.join('\\n'),\n    };\n    if (toolCalls.length) {\n        result.tool_calls = toolCalls;\n    }\n    return result;\n}\n\n/**\n * Name the content blocks an answer consists of, for the log.\n *\n * When the translation above comes back empty although the endpoint reported a normal end and a\n * few hundred output tokens, the whole question is *what* it sent instead - a `thinking` block, a\n * block type that did not exist when this was written, an empty text. Without this the log can\n * only say \"no content\", which is the one thing already known.\n *\n * @param response the parsed answer of the Anthropic API\n */\nexport function describeAnthropicContent(response: AnthropicResponse | undefined | null): string {\n    if (!response) {\n        return 'no response';\n    }\n    if (!Array.isArray(response.content)) {\n        return `content is ${typeof response.content}`;\n    }\n    if (!response.content.length) {\n        return 'no content blocks';\n    }\n    return response.content\n        .map(block => {\n            if (!block || typeof block !== 'object') {\n                return typeof block;\n            }\n            const type = (block as { type?: unknown }).type;\n            const name = typeof type === 'string' ? type : 'untyped';\n            // An empty text block is a different problem from a block nobody reads\n            if (name === 'text') {\n                const text = (block as { text?: unknown }).text;\n                return typeof text === 'string' ? `text(${text.length} chars)` : `text(${typeof text})`;\n            }\n            return name;\n        })\n        .join(', ');\n}\n"]}