@fgv/ts-extras 5.1.0-4 → 5.1.0-40

package/dist/packlets/ai-assist/registry.js

@@ -39,7 +39,10 @@ const BUILTIN_PROVIDERS = [
         baseUrl: '',
         defaultModel: '',
         supportedTools: [],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: false,
+        thinkingMode: 'unsupported'
     },
     {
         id: 'anthropic',
@@ -48,9 +51,25 @@ const BUILTIN_PROVIDERS = [
         needsSecret: true,
         apiFormat: 'anthropic',
         baseUrl: 'https://api.anthropic.com/v1',
-        defaultModel: 'claude-sonnet-4-5-20250929',
+        defaultModel: {
+            base: '@anthropic:sonnet', // claude-sonnet-5 (was 'claude-sonnet-4-5-20250929')
+            advanced: '@anthropic:opus' // claude-opus-4-8
+            // no frontier key → a frontier request cascades advanced → opus (see resolveModel)
+        },
+        aliases: {
+            '@anthropic:sonnet': 'claude-sonnet-5', // base tier
+            '@anthropic:opus': 'claude-opus-4-8', // advanced tier
+            '@anthropic:haiku': 'claude-haiku-4-5-20251001', // NON-tier alias; modelOverride only
+            '@anthropic:fable': 'claude-fable-5' // NON-tier alias; modelOverride only
+            // NOTE: no thinking/image/embedding keys — Anthropic completions are all text; base
+            // (sonnet-5) and advanced (opus-4-8) are both thinking-capable, so a thinking-context
+            // call flat-falls to base safely.
+        },
         supportedTools: ['web_search'],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: true,
+        thinkingMode: 'optional'
     },
     {
         id: 'google-gemini',
@@ -59,9 +78,50 @@ const BUILTIN_PROVIDERS = [
         needsSecret: true,
         apiFormat: 'gemini',
         baseUrl: 'https://generativelanguage.googleapis.com/v1beta',
-        defaultModel: 'gemini-2.5-flash',
+        defaultModel: {
+            base: '@google-gemini:flash',
+            advanced: '@google-gemini:pro', // reuses the existing @google-gemini:pro alias (no new alias entry)
+            image: '@google-gemini:flash-image',
+            embedding: '@google-gemini:embedding'
+            // no frontier key → a frontier request cascades advanced → pro (see resolveModel)
+        },
+        aliases: {
+            // NOTE: the base flash line is at 3.5 while pro / flash-lite / flash-image are at 3.1 — this is
+            // NOT a typo. The targets come verbatim from Google's official deprecation table: the flash base
+            // line advanced to 3.5 while the other roles are on the 3.1 generation. The per-role version
+            // split is exactly why the alias layer exists — consumers never see these numbers.
+            '@google-gemini:flash': 'gemini-3.5-flash', // base (was gemini-2.5-flash, shutdown 2026-10-16)
+            '@google-gemini:pro': 'gemini-3.1-pro-preview', // advanced-tier role (wired to the 'advanced' defaultModel key); also the frontier cascade target (was gemini-2.5-pro, 2026-10-16)
+            '@google-gemini:flash-lite': 'gemini-3.1-flash-lite', // cheaper thinking-capable line; available via modelOverride only (was gemini-2.5-flash-lite, 2026-10-16)
+            '@google-gemini:flash-image': 'gemini-3.1-flash-image-preview', // image (was gemini-2.5-flash-image, 2026-10-02)
+            '@google-gemini:embedding': 'gemini-embedding-001' // NOT deprecated — aliased for uniformity only
+        },
         supportedTools: ['web_search'],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: true,
+        thinkingMode: 'optional',
+        embedding: [
+            {
+                modelPrefix: '',
+                format: 'gemini-embeddings',
+                supportsDimensions: true,
+                supportsTaskType: true,
+                defaultDimensions: 3072
+            }
+        ],
+        imageGeneration: [
+            {
+                // Gemini Flash Image: chat-style generateContent
+                modelPrefix: '',
+                format: 'gemini-image-out',
+                acceptsImageReferenceInput: true,
+                supportsQualityParam: false,
+                maxCount: 1,
+                outputParamStyle: 'none',
+                defaultOutputMimeType: 'image/jpeg'
+            }
+        ]
     },
     {
         id: 'groq',
@@ -72,7 +132,10 @@ const BUILTIN_PROVIDERS = [
         baseUrl: 'https://api.groq.com/openai/v1',
         defaultModel: 'llama-3.3-70b-versatile',
         supportedTools: [],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: false,
+        thinkingMode: 'unsupported'
     },
     {
         id: 'mistral',
@@ -81,9 +144,28 @@ const BUILTIN_PROVIDERS = [
         needsSecret: true,
         apiFormat: 'openai',
         baseUrl: 'https://api.mistral.ai/v1',
-        defaultModel: 'mistral-large-latest',
+        defaultModel: { base: 'mistral-large-latest', embedding: 'mistral-embed' },
         supportedTools: [],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: false,
+        thinkingMode: 'unsupported',
+        embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]
+    },
+    {
+        id: 'ollama',
+        label: 'Ollama (self-hosted)',
+        buttonLabel: 'AI Assist | Ollama',
+        needsSecret: false,
+        apiFormat: 'openai',
+        baseUrl: 'http://localhost:11434/v1',
+        defaultModel: '',
+        supportedTools: [],
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: false,
+        thinkingMode: 'unsupported',
+        embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]
     },
     {
         id: 'openai',
@@ -92,9 +174,77 @@ const BUILTIN_PROVIDERS = [
         needsSecret: true,
         apiFormat: 'openai',
         baseUrl: 'https://api.openai.com/v1',
-        defaultModel: 'gpt-4o',
+        defaultModel: {
+            base: '@openai:mini', // gpt-5.4-mini (was 'gpt-4o' — EOL-behind)
+            advanced: '@openai:flagship', // gpt-5.5
+            // gpt-5.5-pro is a Responses-API-only model (400s on chat completions). The completion
+            // and streaming dispatch route Responses-only models to the Responses API via the
+            // `responsesOnlyModelPrefixes` marker below, so `frontier` is invokable again.
+            frontier: '@openai:pro', // gpt-5.5-pro (Responses-API-only; routed via responsesOnlyModelPrefixes)
+            image: '@openai:image', // gpt-image-1.5 (was 'dall-e-3' — EOL 2026-05-12)
+            embedding: '@openai:embedding' // text-embedding-3-small (unchanged, aliased for uniformity)
+        },
+        aliases: {
+            '@openai:mini': 'gpt-5.4-mini', // base tier
+            '@openai:flagship': 'gpt-5.5', // advanced tier
+            '@openai:pro': 'gpt-5.5-pro', // frontier tier; Responses-API-only (routed via responsesOnlyModelPrefixes)
+            '@openai:nano': 'gpt-5.4-nano', // NON-tier alias; modelOverride only
+            '@openai:image': 'gpt-image-1.5', // image (matches the gpt-image- capability prefix)
+            '@openai:embedding': 'text-embedding-3-small' // NOT deprecated — aliased for uniformity
+            // NOTE: gpt-5.1 deliberately absent — retired March 2026.
+        },
         supportedTools: ['web_search'],
-        corsRestricted: false
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: true,
+        thinkingMode: 'optional',
+        responsesOnlyModelPrefixes: ['gpt-5.5-pro'],
+        embedding: [
+            {
+                modelPrefix: 'text-embedding-3',
+                format: 'openai-embeddings',
+                supportsDimensions: true,
+                maxBatchSize: 2048
+            },
+            {
+                modelPrefix: '',
+                format: 'openai-embeddings'
+            }
+        ],
+        imageGeneration: [
+            {
+                modelPrefix: 'gpt-image-',
+                format: 'openai-images',
+                acceptsImageReferenceInput: true,
+                acceptedSizes: ['1024x1024', '1536x1024', '1024x1536', 'auto'],
+                supportsQualityParam: true,
+                acceptedQualities: ['low', 'medium', 'high', 'auto'],
+                maxCount: 10,
+                outputParamStyle: 'output-format',
+                defaultOutputMimeType: 'image/png'
+            },
+            {
+                modelPrefix: '',
+                format: 'openai-images',
+                outputParamStyle: 'response-format',
+                defaultOutputMimeType: 'image/png'
+            }
+        ]
+    },
+    {
+        id: 'openai-compat',
+        label: 'OpenAI-compatible (self-hosted)',
+        buttonLabel: 'AI Assist | OpenAI-compat',
+        needsSecret: false,
+        apiFormat: 'openai',
+        baseUrl: '',
+        defaultModel: '',
+        supportedTools: [],
+        corsRestricted: false,
+        streamingCorsRestricted: false,
+        acceptsImageInput: false,
+        thinkingMode: 'unsupported',
+        embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]
     },
     {
         id: 'xai-grok',
@@ -103,9 +253,37 @@ const BUILTIN_PROVIDERS = [
         needsSecret: true,
         apiFormat: 'openai',
         baseUrl: 'https://api.x.ai/v1',
-        defaultModel: { base: 'grok-4-1-fast', tools: 'grok-4-1-fast-reasoning' },
+        defaultModel: {
+            base: 'grok-4.3',
+            image: 'grok-imagine-image-quality'
+        },
         supportedTools: ['web_search'],
-        corsRestricted: true
+        corsRestricted: true,
+        streamingCorsRestricted: true,
+        acceptsImageInput: true,
+        thinkingMode: 'optional',
+        imageGeneration: [
+            {
+                // grok-imagine models use JSON edits with image_url objects (different wire format)
+                modelPrefix: 'grok-imagine-',
+                format: 'xai-images-edits',
+                acceptsImageReferenceInput: true,
+                supportsQualityParam: false,
+                maxCount: 10,
+                outputParamStyle: 'response-format',
+                defaultOutputMimeType: 'image/jpeg'
+            },
+            {
+                // catch-all for other xai image models
+                modelPrefix: '',
+                format: 'xai-images',
+                acceptsImageReferenceInput: false,
+                supportsQualityParam: false,
+                maxCount: 10,
+                outputParamStyle: 'response-format',
+                defaultOutputMimeType: 'image/jpeg'
+            }
+        ]
     }
 ];
 /**
@@ -142,4 +320,128 @@ export function getProviderDescriptor(id) {
     }
     return succeed(descriptor);
 }
+/**
+ * Whether a provider declares any image-generation capability at all.
+ *
+ * @param descriptor - The provider descriptor
+ * @returns `true` when {@link IAiProviderDescriptor.imageGeneration} has at
+ *   least one entry; `false` otherwise.
+ * @public
+ */
+export function supportsImageGeneration(descriptor) {
+    var _a, _b;
+    return ((_b = (_a = descriptor.imageGeneration) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0;
+}
+/**
+ * Resolve the image-generation capability that applies to a given model id
+ * for a provider. Returns the entry from
+ * {@link IAiProviderDescriptor.imageGeneration} whose `modelPrefix` is the
+ * longest prefix of `modelId`. Ties are broken by first-encountered, so rule
+ * order does not matter for correctness — only for tie-breaking among rules
+ * with identical-length prefixes (an unusual case).
+ *
+ * @param descriptor - The provider descriptor
+ * @param modelId - The resolved image model id
+ * @returns The matching capability, or `undefined` when no rule matches or
+ *   the provider declares no image-generation capabilities.
+ * @public
+ */
+export function resolveImageCapability(descriptor, modelId) {
+    var _a;
+    return ((_a = descriptor.imageGeneration) !== null && _a !== void 0 ? _a : [])
+        .filter((cap) => modelId.startsWith(cap.modelPrefix))
+        .reduce((best, cap) => (best && best.modelPrefix.length >= cap.modelPrefix.length ? best : cap), undefined);
+}
+/**
+ * Whether a provider declares any embedding capability at all.
+ *
+ * @param descriptor - The provider descriptor
+ * @returns `true` when {@link IAiProviderDescriptor.embedding} has at least one
+ *   entry; `false` otherwise.
+ * @public
+ */
+export function supportsEmbedding(descriptor) {
+    var _a, _b;
+    return ((_b = (_a = descriptor.embedding) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0;
+}
+/**
+ * Resolve the embedding capability that applies to a given model id for a
+ * provider. Returns the entry from {@link IAiProviderDescriptor.embedding} whose
+ * `modelPrefix` is the longest prefix of `modelId`. Ties are broken by
+ * first-encountered.
+ *
+ * @param descriptor - The provider descriptor
+ * @param modelId - The resolved embedding model id
+ * @returns The matching capability, or `undefined` when no rule matches or the
+ *   provider declares no embedding capabilities.
+ * @public
+ */
+export function resolveEmbeddingCapability(descriptor, modelId) {
+    var _a;
+    return ((_a = descriptor.embedding) !== null && _a !== void 0 ? _a : [])
+        .filter((cap) => modelId.startsWith(cap.modelPrefix))
+        .reduce((best, cap) => (best && best.modelPrefix.length >= cap.modelPrefix.length ? best : cap), undefined);
+}
+// ============================================================================
+// Default model capability config
+// ============================================================================
+/**
+ * Default capability config used by `callProviderListModels` when callers
+ * don't supply their own. Patterns are intentionally narrow — false
+ * positives are worse than missing a model. Caller can override per call
+ * via {@link IProviderListModelsParams.capabilityConfig}.
+ *
+ * @public
+ */
+export const DEFAULT_MODEL_CAPABILITY_CONFIG = {
+    perProvider: {
+        openai: [
+            { idPattern: /^gpt-image/, capabilities: ['image-generation'] },
+            { idPattern: /^text-embedding/, capabilities: ['embedding'] },
+            { idPattern: /^gpt-5/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },
+            { idPattern: /^gpt-4/, capabilities: ['chat', 'tools', 'vision'] },
+            { idPattern: /^gpt-3\.5/, capabilities: ['chat'] },
+            { idPattern: /^o\d/, capabilities: ['chat', 'tools', 'thinking'] }
+        ],
+        'xai-grok': [
+            { idPattern: /-image/, capabilities: ['image-generation'] },
+            { idPattern: /^grok-4\.3/, capabilities: ['chat', 'tools', 'thinking'] },
+            { idPattern: /^grok-4$/, capabilities: ['chat', 'tools', 'thinking'] },
+            { idPattern: /^grok-4/, capabilities: ['chat', 'tools', 'vision'] },
+            { idPattern: /^grok-3-mini/, capabilities: ['chat', 'tools', 'thinking'] },
+            { idPattern: /^grok-3/, capabilities: ['chat', 'tools'] },
+            { idPattern: /^grok-2/, capabilities: ['chat', 'vision'] }
+        ],
+        'google-gemini': [
+            { idPattern: /^imagen/, capabilities: ['image-generation'] },
+            { idPattern: /^gemini-.*-image/, capabilities: ['image-generation'] },
+            { idPattern: /embedding/, capabilities: ['embedding'] },
+            { idPattern: /^gemini-3/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },
+            { idPattern: /^gemini-2\.5/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },
+            { idPattern: /^gemini-/, capabilities: ['chat', 'tools', 'vision'] }
+        ],
+        anthropic: [
+            // Broadened from /^claude-opus-4/ and /^claude-sonnet-4/ so the sonnet-5+ / opus-5+ lines
+            // are detected as thinking-capable. Detection accumulates across matching rules, so this is
+            // purely additive: every existing opus-4 / sonnet-4 id still matches. The sonnet broadening
+            // is required (claude-sonnet-5 otherwise hits only /^claude-/ and loses thinking); the opus
+            // broadening is future-proofing (claude-opus-4-8 already matches /^claude-opus-4/).
+            { idPattern: /^claude-opus-/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },
+            { idPattern: /^claude-sonnet-/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },
+            { idPattern: /^claude-/, capabilities: ['chat', 'tools', 'vision'] }
+        ],
+        groq: [{ idPattern: /./, capabilities: ['chat'] }],
+        mistral: [
+            { idPattern: /embed/, capabilities: ['embedding'] },
+            { idPattern: /./, capabilities: ['chat'] }
+        ],
+        // Self-hosted OpenAI-compatible servers (Ollama, LM Studio, llama.cpp) serve
+        // arbitrary, caller-chosen models whose ids we can't enumerate ahead of time.
+        // The catch-all `/./` intentionally departs from the "narrow patterns" rule
+        // above: assume `chat` for everything and let the caller override via
+        // `capabilityConfig` when they know their deployment serves image/embedding models.
+        ollama: [{ idPattern: /./, capabilities: ['chat'] }],
+        'openai-compat': [{ idPattern: /./, capabilities: ['chat'] }]
+    }
+};
 //# sourceMappingURL=registry.js.map

package/dist/packlets/ai-assist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/registry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Centralized provider registry — single source of truth for all AI provider metadata.\n * @packageDocumentation\n */\n\nimport { fail, Result, succeed } from '@fgv/ts-utils';\n\nimport {\n  type AiProviderId,\n  type IAiEmbeddingModelCapability,\n  type IAiImageModelCapability,\n  type IAiModelCapabilityConfig,\n  type IAiProviderDescriptor\n} from './model';\n\n// ============================================================================\n// Built-in providers\n// ============================================================================\n\n/**\n * All known AI provider descriptors. Copy-paste first, then alphabetical.\n * @internal\n */\nconst BUILTIN_PROVIDERS: ReadonlyArray<IAiProviderDescriptor> = [\n  {\n    id: 'copy-paste',\n    label: 'Copy / Paste',\n    buttonLabel: 'AI Assist | Copy',\n    needsSecret: false,\n    apiFormat: 'openai',\n    baseUrl: '',\n    defaultModel: '',\n    supportedTools: [],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: false,\n    thinkingMode: 'unsupported'\n  },\n  {\n    id: 'anthropic',\n    label: 'Anthropic Claude',\n    buttonLabel: 'AI Assist | Claude',\n    needsSecret: true,\n    apiFormat: 'anthropic',\n    baseUrl: 'https://api.anthropic.com/v1',\n    defaultModel: {\n      base: '@anthropic:sonnet', // claude-sonnet-5 (was 'claude-sonnet-4-5-20250929')\n      advanced: '@anthropic:opus' // claude-opus-4-8\n      // no frontier key → a frontier request cascades advanced → opus (see resolveModel)\n    },\n    aliases: {\n      '@anthropic:sonnet': 'claude-sonnet-5', // base tier\n      '@anthropic:opus': 'claude-opus-4-8', // advanced tier\n      '@anthropic:haiku': 'claude-haiku-4-5-20251001', // NON-tier alias; modelOverride only\n      '@anthropic:fable': 'claude-fable-5' // NON-tier alias; modelOverride only\n      // NOTE: no thinking/image/embedding keys — Anthropic completions are all text; base\n      // (sonnet-5) and advanced (opus-4-8) are both thinking-capable, so a thinking-context\n      // call flat-falls to base safely.\n    },\n    supportedTools: ['web_search'],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: true,\n    thinkingMode: 'optional'\n  },\n  {\n    id: 'google-gemini',\n    label: 'Google Gemini',\n    buttonLabel: 'AI Assist | Gemini',\n    needsSecret: true,\n    apiFormat: 'gemini',\n    baseUrl: 'https://generativelanguage.googleapis.com/v1beta',\n    defaultModel: {\n      base: '@google-gemini:flash',\n      advanced: '@google-gemini:pro', // reuses the existing @google-gemini:pro alias (no new alias entry)\n      image: '@google-gemini:flash-image',\n      embedding: '@google-gemini:embedding'\n      // no frontier key → a frontier request cascades advanced → pro (see resolveModel)\n    },\n    aliases: {\n      // NOTE: the base flash line is at 3.5 while pro / flash-lite / flash-image are at 3.1 — this is\n      // NOT a typo. The targets come verbatim from Google's official deprecation table: the flash base\n      // line advanced to 3.5 while the other roles are on the 3.1 generation. The per-role version\n      // split is exactly why the alias layer exists — consumers never see these numbers.\n      '@google-gemini:flash': 'gemini-3.5-flash', // base (was gemini-2.5-flash, shutdown 2026-10-16)\n      '@google-gemini:pro': 'gemini-3.1-pro-preview', // advanced-tier role (wired to the 'advanced' defaultModel key); also the frontier cascade target (was gemini-2.5-pro, 2026-10-16)\n      '@google-gemini:flash-lite': 'gemini-3.1-flash-lite', // cheaper thinking-capable line; available via modelOverride only (was gemini-2.5-flash-lite, 2026-10-16)\n      '@google-gemini:flash-image': 'gemini-3.1-flash-image-preview', // image (was gemini-2.5-flash-image, 2026-10-02)\n      '@google-gemini:embedding': 'gemini-embedding-001' // NOT deprecated — aliased for uniformity only\n    },\n    supportedTools: ['web_search'],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: true,\n    thinkingMode: 'optional',\n    embedding: [\n      {\n        modelPrefix: '',\n        format: 'gemini-embeddings',\n        supportsDimensions: true,\n        supportsTaskType: true,\n        defaultDimensions: 3072\n      }\n    ],\n    imageGeneration: [\n      {\n        // Gemini Flash Image: chat-style generateContent\n        modelPrefix: '',\n        format: 'gemini-image-out',\n        acceptsImageReferenceInput: true,\n        supportsQualityParam: false,\n        maxCount: 1,\n        outputParamStyle: 'none',\n        defaultOutputMimeType: 'image/jpeg'\n      }\n    ]\n  },\n  {\n    id: 'groq',\n    label: 'Groq',\n    buttonLabel: 'AI Assist | Groq',\n    needsSecret: true,\n    apiFormat: 'openai',\n    baseUrl: 'https://api.groq.com/openai/v1',\n    defaultModel: 'llama-3.3-70b-versatile',\n    supportedTools: [],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: false,\n    thinkingMode: 'unsupported'\n  },\n  {\n    id: 'mistral',\n    label: 'Mistral',\n    buttonLabel: 'AI Assist | Mistral',\n    needsSecret: true,\n    apiFormat: 'openai',\n    baseUrl: 'https://api.mistral.ai/v1',\n    defaultModel: { base: 'mistral-large-latest', embedding: 'mistral-embed' },\n    supportedTools: [],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: false,\n    thinkingMode: 'unsupported',\n    embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]\n  },\n  {\n    id: 'ollama',\n    label: 'Ollama (self-hosted)',\n    buttonLabel: 'AI Assist | Ollama',\n    needsSecret: false,\n    apiFormat: 'openai',\n    baseUrl: 'http://localhost:11434/v1',\n    defaultModel: '',\n    supportedTools: [],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: false,\n    thinkingMode: 'unsupported',\n    embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]\n  },\n  {\n    id: 'openai',\n    label: 'OpenAI',\n    buttonLabel: 'AI Assist | OpenAI',\n    needsSecret: true,\n    apiFormat: 'openai',\n    baseUrl: 'https://api.openai.com/v1',\n    defaultModel: {\n      base: '@openai:mini', // gpt-5.4-mini (was 'gpt-4o' — EOL-behind)\n      advanced: '@openai:flagship', // gpt-5.5\n      // gpt-5.5-pro is a Responses-API-only model (400s on chat completions). The completion\n      // and streaming dispatch route Responses-only models to the Responses API via the\n      // `responsesOnlyModelPrefixes` marker below, so `frontier` is invokable again.\n      frontier: '@openai:pro', // gpt-5.5-pro (Responses-API-only; routed via responsesOnlyModelPrefixes)\n      image: '@openai:image', // gpt-image-1.5 (was 'dall-e-3' — EOL 2026-05-12)\n      embedding: '@openai:embedding' // text-embedding-3-small (unchanged, aliased for uniformity)\n    },\n    aliases: {\n      '@openai:mini': 'gpt-5.4-mini', // base tier\n      '@openai:flagship': 'gpt-5.5', // advanced tier\n      '@openai:pro': 'gpt-5.5-pro', // frontier tier; Responses-API-only (routed via responsesOnlyModelPrefixes)\n      '@openai:nano': 'gpt-5.4-nano', // NON-tier alias; modelOverride only\n      '@openai:image': 'gpt-image-1.5', // image (matches the gpt-image- capability prefix)\n      '@openai:embedding': 'text-embedding-3-small' // NOT deprecated — aliased for uniformity\n      // NOTE: gpt-5.1 deliberately absent — retired March 2026.\n    },\n    supportedTools: ['web_search'],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: true,\n    thinkingMode: 'optional',\n    responsesOnlyModelPrefixes: ['gpt-5.5-pro'],\n    embedding: [\n      {\n        modelPrefix: 'text-embedding-3',\n        format: 'openai-embeddings',\n        supportsDimensions: true,\n        maxBatchSize: 2048\n      },\n      {\n        modelPrefix: '',\n        format: 'openai-embeddings'\n      }\n    ],\n    imageGeneration: [\n      {\n        modelPrefix: 'gpt-image-',\n        format: 'openai-images',\n        acceptsImageReferenceInput: true,\n        acceptedSizes: ['1024x1024', '1536x1024', '1024x1536', 'auto'],\n        supportsQualityParam: true,\n        acceptedQualities: ['low', 'medium', 'high', 'auto'],\n        maxCount: 10,\n        outputParamStyle: 'output-format',\n        defaultOutputMimeType: 'image/png'\n      },\n      {\n        modelPrefix: '',\n        format: 'openai-images',\n        outputParamStyle: 'response-format',\n        defaultOutputMimeType: 'image/png'\n      }\n    ]\n  },\n  {\n    id: 'openai-compat',\n    label: 'OpenAI-compatible (self-hosted)',\n    buttonLabel: 'AI Assist | OpenAI-compat',\n    needsSecret: false,\n    apiFormat: 'openai',\n    baseUrl: '',\n    defaultModel: '',\n    supportedTools: [],\n    corsRestricted: false,\n    streamingCorsRestricted: false,\n    acceptsImageInput: false,\n    thinkingMode: 'unsupported',\n    embedding: [{ modelPrefix: '', format: 'openai-embeddings' }]\n  },\n  {\n    id: 'xai-grok',\n    label: 'xAI Grok',\n    buttonLabel: 'AI Assist | Grok',\n    needsSecret: true,\n    apiFormat: 'openai',\n    baseUrl: 'https://api.x.ai/v1',\n    defaultModel: {\n      base: 'grok-4.3',\n      image: 'grok-imagine-image-quality'\n    },\n    supportedTools: ['web_search'],\n    corsRestricted: true,\n    streamingCorsRestricted: true,\n    acceptsImageInput: true,\n    thinkingMode: 'optional',\n    imageGeneration: [\n      {\n        // grok-imagine models use JSON edits with image_url objects (different wire format)\n        modelPrefix: 'grok-imagine-',\n        format: 'xai-images-edits',\n        acceptsImageReferenceInput: true,\n        supportsQualityParam: false,\n        maxCount: 10,\n        outputParamStyle: 'response-format',\n        defaultOutputMimeType: 'image/jpeg'\n      },\n      {\n        // catch-all for other xai image models\n        modelPrefix: '',\n        format: 'xai-images',\n        acceptsImageReferenceInput: false,\n        supportsQualityParam: false,\n        maxCount: 10,\n        outputParamStyle: 'response-format',\n        defaultOutputMimeType: 'image/jpeg'\n      }\n    ]\n  }\n];\n\n/**\n * Index for O(1) lookup by id.\n * @internal\n */\nconst PROVIDER_BY_ID: ReadonlyMap<string, IAiProviderDescriptor> = new Map(\n  BUILTIN_PROVIDERS.map((d) => [d.id, d])\n);\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * All valid provider ID values, in the same order as the registry.\n * @public\n */\nexport const allProviderIds: ReadonlyArray<AiProviderId> = BUILTIN_PROVIDERS.map((d) => d.id);\n\n/**\n * Get all known provider descriptors. Copy-paste first, then alphabetical.\n * @returns All built-in provider descriptors\n * @public\n */\nexport function getProviderDescriptors(): ReadonlyArray<IAiProviderDescriptor> {\n  return BUILTIN_PROVIDERS;\n}\n\n/**\n * Get a provider descriptor by id.\n * @param id - The provider identifier\n * @returns The descriptor, or a failure if the provider is unknown\n * @public\n */\nexport function getProviderDescriptor(id: string): Result<IAiProviderDescriptor> {\n  const descriptor = PROVIDER_BY_ID.get(id);\n  if (!descriptor) {\n    return fail(`unknown AI provider: ${id}`);\n  }\n  return succeed(descriptor);\n}\n\n/**\n * Whether a provider declares any image-generation capability at all.\n *\n * @param descriptor - The provider descriptor\n * @returns `true` when {@link IAiProviderDescriptor.imageGeneration} has at\n *   least one entry; `false` otherwise.\n * @public\n */\nexport function supportsImageGeneration(descriptor: IAiProviderDescriptor): boolean {\n  return (descriptor.imageGeneration?.length ?? 0) > 0;\n}\n\n/**\n * Resolve the image-generation capability that applies to a given model id\n * for a provider. Returns the entry from\n * {@link IAiProviderDescriptor.imageGeneration} whose `modelPrefix` is the\n * longest prefix of `modelId`. Ties are broken by first-encountered, so rule\n * order does not matter for correctness — only for tie-breaking among rules\n * with identical-length prefixes (an unusual case).\n *\n * @param descriptor - The provider descriptor\n * @param modelId - The resolved image model id\n * @returns The matching capability, or `undefined` when no rule matches or\n *   the provider declares no image-generation capabilities.\n * @public\n */\nexport function resolveImageCapability(\n  descriptor: IAiProviderDescriptor,\n  modelId: string\n): IAiImageModelCapability | undefined {\n  return (descriptor.imageGeneration ?? [])\n    .filter((cap) => modelId.startsWith(cap.modelPrefix))\n    .reduce<IAiImageModelCapability | undefined>(\n      (best, cap) => (best && best.modelPrefix.length >= cap.modelPrefix.length ? best : cap),\n      undefined\n    );\n}\n\n/**\n * Whether a provider declares any embedding capability at all.\n *\n * @param descriptor - The provider descriptor\n * @returns `true` when {@link IAiProviderDescriptor.embedding} has at least one\n *   entry; `false` otherwise.\n * @public\n */\nexport function supportsEmbedding(descriptor: IAiProviderDescriptor): boolean {\n  return (descriptor.embedding?.length ?? 0) > 0;\n}\n\n/**\n * Resolve the embedding capability that applies to a given model id for a\n * provider. Returns the entry from {@link IAiProviderDescriptor.embedding} whose\n * `modelPrefix` is the longest prefix of `modelId`. Ties are broken by\n * first-encountered.\n *\n * @param descriptor - The provider descriptor\n * @param modelId - The resolved embedding model id\n * @returns The matching capability, or `undefined` when no rule matches or the\n *   provider declares no embedding capabilities.\n * @public\n */\nexport function resolveEmbeddingCapability(\n  descriptor: IAiProviderDescriptor,\n  modelId: string\n): IAiEmbeddingModelCapability | undefined {\n  return (descriptor.embedding ?? [])\n    .filter((cap) => modelId.startsWith(cap.modelPrefix))\n    .reduce<IAiEmbeddingModelCapability | undefined>(\n      (best, cap) => (best && best.modelPrefix.length >= cap.modelPrefix.length ? best : cap),\n      undefined\n    );\n}\n\n// ============================================================================\n// Default model capability config\n// ============================================================================\n\n/**\n * Default capability config used by `callProviderListModels` when callers\n * don't supply their own. Patterns are intentionally narrow — false\n * positives are worse than missing a model. Caller can override per call\n * via {@link IProviderListModelsParams.capabilityConfig}.\n *\n * @public\n */\nexport const DEFAULT_MODEL_CAPABILITY_CONFIG: IAiModelCapabilityConfig = {\n  perProvider: {\n    openai: [\n      { idPattern: /^gpt-image/, capabilities: ['image-generation'] },\n      { idPattern: /^text-embedding/, capabilities: ['embedding'] },\n      { idPattern: /^gpt-5/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },\n      { idPattern: /^gpt-4/, capabilities: ['chat', 'tools', 'vision'] },\n      { idPattern: /^gpt-3\\.5/, capabilities: ['chat'] },\n      { idPattern: /^o\\d/, capabilities: ['chat', 'tools', 'thinking'] }\n    ],\n    'xai-grok': [\n      { idPattern: /-image/, capabilities: ['image-generation'] },\n      { idPattern: /^grok-4\\.3/, capabilities: ['chat', 'tools', 'thinking'] },\n      { idPattern: /^grok-4$/, capabilities: ['chat', 'tools', 'thinking'] },\n      { idPattern: /^grok-4/, capabilities: ['chat', 'tools', 'vision'] },\n      { idPattern: /^grok-3-mini/, capabilities: ['chat', 'tools', 'thinking'] },\n      { idPattern: /^grok-3/, capabilities: ['chat', 'tools'] },\n      { idPattern: /^grok-2/, capabilities: ['chat', 'vision'] }\n    ],\n    'google-gemini': [\n      { idPattern: /^imagen/, capabilities: ['image-generation'] },\n      { idPattern: /^gemini-.*-image/, capabilities: ['image-generation'] },\n      { idPattern: /embedding/, capabilities: ['embedding'] },\n      { idPattern: /^gemini-3/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },\n      { idPattern: /^gemini-2\\.5/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },\n      { idPattern: /^gemini-/, capabilities: ['chat', 'tools', 'vision'] }\n    ],\n    anthropic: [\n      // Broadened from /^claude-opus-4/ and /^claude-sonnet-4/ so the sonnet-5+ / opus-5+ lines\n      // are detected as thinking-capable. Detection accumulates across matching rules, so this is\n      // purely additive: every existing opus-4 / sonnet-4 id still matches. The sonnet broadening\n      // is required (claude-sonnet-5 otherwise hits only /^claude-/ and loses thinking); the opus\n      // broadening is future-proofing (claude-opus-4-8 already matches /^claude-opus-4/).\n      { idPattern: /^claude-opus-/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },\n      { idPattern: /^claude-sonnet-/, capabilities: ['chat', 'tools', 'vision', 'thinking'] },\n      { idPattern: /^claude-/, capabilities: ['chat', 'tools', 'vision'] }\n    ],\n    groq: [{ idPattern: /./, capabilities: ['chat'] }],\n    mistral: [\n      { idPattern: /embed/, capabilities: ['embedding'] },\n      { idPattern: /./, capabilities: ['chat'] }\n    ],\n    // Self-hosted OpenAI-compatible servers (Ollama, LM Studio, llama.cpp) serve\n    // arbitrary, caller-chosen models whose ids we can't enumerate ahead of time.\n    // The catch-all `/./` intentionally departs from the \"narrow patterns\" rule\n    // above: assume `chat` for everything and let the caller override via\n    // `capabilityConfig` when they know their deployment serves image/embedding models.\n    ollama: [{ idPattern: /./, capabilities: ['chat'] }],\n    'openai-compat': [{ idPattern: /./, capabilities: ['chat'] }]\n  }\n};\n"]}

package/dist/packlets/ai-assist/sseParser.js

@@ -0,0 +1,123 @@
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+/**
+ * Parses a single SSE message (the text between blank-line separators) into
+ * an {@link ISseEvent}. Returns undefined for messages with no `data:` lines
+ * (comments, heartbeats).
+ *
+ * @internal
+ */
+export function parseSseEvent(chunk) {
+    let event;
+    const dataLines = [];
+    for (const line of chunk.split('\n')) {
+        if (line.startsWith('event:')) {
+            event = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            // Per the SSE spec the value starts after the colon, with one optional leading space stripped.
+            const value = line.slice(5);
+            dataLines.push(value.startsWith(' ') ? value.slice(1) : value);
+        }
+    }
+    if (dataLines.length === 0) {
+        return undefined;
+    }
+    return event !== undefined ? { event, data: dataLines.join('\n') } : { data: dataLines.join('\n') };
+}
+/**
+ * Reads an SSE response body and yields parsed events. Buffers across read()
+ * boundaries so a message split mid-chunk still parses cleanly. Terminates
+ * when the stream closes (normal EOF or aborted fetch).
+ *
+ * @internal
+ */
+export function readSseEvents(body) {
+    return __asyncGenerator(this, arguments, function* readSseEvents_1() {
+        var _a;
+        const reader = body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            let streaming = true;
+            while (streaming) {
+                const { value, done } = yield __await(reader.read());
+                if (done) {
+                    streaming = false;
+                    if (buffer.length > 0) {
+                        const tail = parseSseEvent(buffer.replace(/\r\n/g, '\n'));
+                        if (tail) {
+                            yield yield __await(tail);
+                        }
+                    }
+                    break;
+                }
+                buffer += decoder.decode(value, { stream: true });
+                // SSE messages are separated by a blank line; some servers use \r\n.
+                const normalized = buffer.replace(/\r\n/g, '\n');
+                const parts = normalized.split('\n\n');
+                // Last element is the partial chunk (no terminating blank line yet); buffer it.
+                /* c8 ignore next 1 - defensive: parts.pop() returning undefined is unreachable after split */
+                buffer = (_a = parts.pop()) !== null && _a !== void 0 ? _a : '';
+                for (const chunk of parts) {
+                    const event = parseSseEvent(chunk);
+                    if (event) {
+                        yield yield __await(event);
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    });
+}
+/**
+ * Parses the `data` payload of an SSE event as JSON. Returns undefined for
+ * the OpenAI `[DONE]` sentinel and for any payload that fails to parse —
+ * adapters treat both as "skip this event."
+ *
+ * @internal
+ */
+export function parseSseEventJson(data) {
+    if (data === '[DONE]') {
+        return undefined;
+    }
+    try {
+        return JSON.parse(data);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sseParser.js.map

package/dist/packlets/ai-assist/sseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParser.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/sseParser.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Server-Sent Events (SSE) parser primitives shared by the streaming format\n * adapters in `streamingClient.ts`. Implements the subset of the SSE wire\n * format that LLM providers actually emit: optional `event:` line, one or\n * more `data:` lines per message, messages separated by a blank line.\n *\n * @packageDocumentation\n */\n\n/**\n * One parsed SSE message (the SSE spec calls each blank-line-terminated\n * record an \"event\").\n *\n * @internal\n */\nexport interface ISseEvent {\n  /** The `event:` field, if present (some providers omit it). */\n  readonly event?: string;\n  /** Concatenated contents of the message's `data:` lines. */\n  readonly data: string;\n}\n\n/**\n * Parses a single SSE message (the text between blank-line separators) into\n * an {@link ISseEvent}. Returns undefined for messages with no `data:` lines\n * (comments, heartbeats).\n *\n * @internal\n */\nexport function parseSseEvent(chunk: string): ISseEvent | undefined {\n  let event: string | undefined;\n  const dataLines: string[] = [];\n  for (const line of chunk.split('\\n')) {\n    if (line.startsWith('event:')) {\n      event = line.slice(6).trim();\n    } else if (line.startsWith('data:')) {\n      // Per the SSE spec the value starts after the colon, with one optional leading space stripped.\n      const value = line.slice(5);\n      dataLines.push(value.startsWith(' ') ? value.slice(1) : value);\n    }\n  }\n  if (dataLines.length === 0) {\n    return undefined;\n  }\n  return event !== undefined ? { event, data: dataLines.join('\\n') } : { data: dataLines.join('\\n') };\n}\n\n/**\n * Reads an SSE response body and yields parsed events. Buffers across read()\n * boundaries so a message split mid-chunk still parses cleanly. Terminates\n * when the stream closes (normal EOF or aborted fetch).\n *\n * @internal\n */\nexport async function* readSseEvents(body: ReadableStream<Uint8Array>): AsyncGenerator<ISseEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n  try {\n    let streaming = true;\n    while (streaming) {\n      const { value, done } = await reader.read();\n      if (done) {\n        streaming = false;\n        if (buffer.length > 0) {\n          const tail = parseSseEvent(buffer.replace(/\\r\\n/g, '\\n'));\n          if (tail) {\n            yield tail;\n          }\n        }\n        break;\n      }\n      buffer += decoder.decode(value, { stream: true });\n      // SSE messages are separated by a blank line; some servers use \\r\\n.\n      const normalized = buffer.replace(/\\r\\n/g, '\\n');\n      const parts = normalized.split('\\n\\n');\n      // Last element is the partial chunk (no terminating blank line yet); buffer it.\n      /* c8 ignore next 1 - defensive: parts.pop() returning undefined is unreachable after split */\n      buffer = parts.pop() ?? '';\n      for (const chunk of parts) {\n        const event = parseSseEvent(chunk);\n        if (event) {\n          yield event;\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * Parses the `data` payload of an SSE event as JSON. Returns undefined for\n * the OpenAI `[DONE]` sentinel and for any payload that fails to parse —\n * adapters treat both as \"skip this event.\"\n *\n * @internal\n */\nexport function parseSseEventJson(data: string): unknown | undefined {\n  if (data === '[DONE]') {\n    return undefined;\n  }\n  try {\n    return JSON.parse(data);\n  } catch {\n    return undefined;\n  }\n}\n"]}