npm - @fgv/ts-app-shell - Versions diffs - 5.1.0-3 → 5.1.0-31 - Mend

@fgv/ts-app-shell 5.1.0-3 → 5.1.0-31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (208) hide show

package/dist/styles/theme.css ADDED Viewed

@@ -0,0 +1,194 @@
+/*
+ * @fgv/ts-app-shell — Default theme
+ *
+ * Defines all semantic design tokens as CSS custom properties.
+ * Import this file once at your application entry point:
+ *
+ *   import '@fgv/ts-app-shell/theme.css';
+ *
+ * Then add the Tailwind preset in your tailwind.config.js:
+ *
+ *   const appShellPreset = require('@fgv/ts-app-shell/tailwind-preset');
+ *   module.exports = { presets: [appShellPreset], ... };
+ *
+ * Dark mode: put class="dark" on <html> (or any ancestor).
+ * The ThemeProvider component handles this automatically.
+ *
+ * All variables use the --fgv- prefix and can be overridden by the consumer.
+ */
+/* ============================================================
+ * LIGHT MODE (default / :root)
+ * ============================================================ */
+:root {
+  /* --- Surfaces --- */
+  /* Base application surface (page background) */
+  --fgv-surface: #ffffff;
+  /* Slightly elevated surface (cards, panels) */
+  --fgv-surface-raised: #f3f4f6;
+  /* Alternate surface (zebra rows, secondary panels) */
+  --fgv-surface-alt: #f9fafb;
+  /* Modal / dialog backdrop overlay */
+  --fgv-backdrop: rgba(0, 0, 0, 0.45);
+  /* Hover highlight background (subtle, interactive rows) */
+  --fgv-hover: #f3f4f6;
+  /* Selected item background (listbox rows, picker items) */
+  --fgv-selected: #eff6ff;
+  /* --- Text --- */
+  /* High-emphasis body text — minimum 7:1 on --fgv-surface (WCAG AAA) */
+  --fgv-text-primary: #111827;
+  /* Medium-emphasis secondary text — ~5.4:1 on #fff (WCAG AA) */
+  --fgv-text-secondary: #374151;
+  /* De-emphasized muted text — ~3.5:1, use only for decorative / supporting copy */
+  --fgv-text-muted: #6b7280;
+  /* Faintest ghost text — intentionally low contrast, only for truly ornamental content */
+  --fgv-text-faint: #9ca3af;
+  /* Star / favorite accent (golden) */
+  --fgv-text-star: #d97706;
+  /* --- Borders --- */
+  /* Default divider / input border */
+  --fgv-border: #d1d5db;
+  /* Subtle divider (row separators, inner section borders) */
+  --fgv-border-subtle: #e5e7eb;
+  /* --- Brand colors --- */
+  /* Primary action color (buttons, active nav, links) */
+  --fgv-brand-primary: #2563eb;
+  /* Darker tonal variant (pressed state, dark top-bar) */
+  --fgv-brand-secondary: #1d4ed8;
+  /* Accent / highlight (hover text on dark surfaces, checkmarks) */
+  --fgv-brand-accent: #3b82f6;
+  /* --- Focus ring --- */
+  --fgv-focus-ring: #3b82f6;
+  /* Selected item left-border accent */
+  --fgv-selected-border: #2563eb;
+  /* --- Status: error / danger --- */
+  --fgv-status-error-bg: #fef2f2;
+  --fgv-status-error-surface: #fee2e2;
+  --fgv-status-error-btn: #dc2626;
+  --fgv-status-error-btn-hover: #b91c1c;
+  --fgv-status-error-icon: #dc2626;
+  --fgv-status-error-border: #fca5a5;
+  --fgv-status-error-accent: #ef4444;
+  --fgv-status-error-text: #b91c1c;
+  --fgv-status-error-strong: #991b1b;
+  /* --- Status: warning --- */
+  --fgv-status-warning-bg: #fffbeb;
+  --fgv-status-warning-surface: #fef3c7;
+  --fgv-status-warning-btn: #d97706;
+  --fgv-status-warning-btn-hover: #b45309;
+  --fgv-status-warning-icon: #d97706;
+  --fgv-status-warning-border: #fcd34d;
+  --fgv-status-warning-accent: #f59e0b;
+  --fgv-status-warning-text: #92400e;
+  --fgv-status-warning-strong: #78350f;
+  /* --- Status: info --- */
+  --fgv-status-info-bg: #eff6ff;
+  --fgv-status-info-surface: #dbeafe;
+  --fgv-status-info-btn: #2563eb;
+  --fgv-status-info-btn-hover: #1d4ed8;
+  --fgv-status-info-icon: #3b82f6;
+  --fgv-status-info-border: #93c5fd;
+  --fgv-status-info-accent: #60a5fa;
+  --fgv-status-info-text: #1e40af;
+  --fgv-status-info-strong: #1e3a8a;
+  /* --- Status: success --- */
+  --fgv-status-success-bg: #f0fdf4;
+  --fgv-status-success-surface: #dcfce7;
+  --fgv-status-success-btn: #16a34a;
+  --fgv-status-success-btn-hover: #15803d;
+  --fgv-status-success-icon: #16a34a;
+  --fgv-status-success-border: #86efac;
+  --fgv-status-success-accent: #4ade80;
+  --fgv-status-success-text: #166534;
+  --fgv-status-success-strong: #14532d;
+}
+/* ============================================================
+ * DARK MODE  (.dark on any ancestor element)
+ * ============================================================ */
+.dark {
+  /* --- Surfaces --- */
+  --fgv-surface: #1f2937;
+  --fgv-surface-raised: #374151;
+  --fgv-surface-alt: #111827;
+  --fgv-backdrop: rgba(0, 0, 0, 0.65);
+  --fgv-hover: #374151;
+  --fgv-selected: #1e3a5f;
+  /* --- Text --- */
+  /* ~14:1 on --fgv-surface dark (WCAG AAA) */
+  --fgv-text-primary: #f9fafb;
+  /* ~8:1 on dark surface (WCAG AA) */
+  --fgv-text-secondary: #d1d5db;
+  /* ~4.5:1 on dark surface (WCAG AA) */
+  --fgv-text-muted: #9ca3af;
+  /* Faint ghost text — intentionally low contrast */
+  --fgv-text-faint: #6b7280;
+  /* Star accent — brightened slightly for dark bg */
+  --fgv-text-star: #fbbf24;
+  /* --- Borders --- */
+  --fgv-border: #4b5563;
+  --fgv-border-subtle: #374151;
+  /* --- Brand colors --- */
+  --fgv-brand-primary: #3b82f6;
+  --fgv-brand-secondary: #1e3a5f;
+  --fgv-brand-accent: #60a5fa;
+  /* --- Focus ring --- */
+  --fgv-focus-ring: #60a5fa;
+  --fgv-selected-border: #3b82f6;
+  /* --- Status: error / danger --- */
+  --fgv-status-error-bg: #450a0a;
+  --fgv-status-error-surface: #7f1d1d;
+  --fgv-status-error-btn: #dc2626;
+  --fgv-status-error-btn-hover: #b91c1c;
+  --fgv-status-error-icon: #f87171;
+  --fgv-status-error-border: #7f1d1d;
+  --fgv-status-error-accent: #ef4444;
+  --fgv-status-error-text: #fca5a5;
+  --fgv-status-error-strong: #fecaca;
+  /* --- Status: warning --- */
+  --fgv-status-warning-bg: #451a03;
+  --fgv-status-warning-surface: #78350f;
+  --fgv-status-warning-btn: #d97706;
+  --fgv-status-warning-btn-hover: #b45309;
+  --fgv-status-warning-icon: #fbbf24;
+  --fgv-status-warning-border: #78350f;
+  --fgv-status-warning-accent: #f59e0b;
+  --fgv-status-warning-text: #fde68a;
+  --fgv-status-warning-strong: #fef3c7;
+  /* --- Status: info --- */
+  --fgv-status-info-bg: #0c1d3e;
+  --fgv-status-info-surface: #1e3a5f;
+  --fgv-status-info-btn: #3b82f6;
+  --fgv-status-info-btn-hover: #2563eb;
+  --fgv-status-info-icon: #60a5fa;
+  --fgv-status-info-border: #1e3a5f;
+  --fgv-status-info-accent: #93c5fd;
+  --fgv-status-info-text: #bfdbfe;
+  --fgv-status-info-strong: #dbeafe;
+  /* --- Status: success --- */
+  --fgv-status-success-bg: #052e16;
+  --fgv-status-success-surface: #14532d;
+  --fgv-status-success-btn: #16a34a;
+  --fgv-status-success-btn-hover: #15803d;
+  --fgv-status-success-icon: #4ade80;
+  --fgv-status-success-border: #14532d;
+  --fgv-status-success-accent: #86efac;
+  --fgv-status-success-text: #bbf7d0;
+  --fgv-status-success-strong: #dcfce7;
+}

package/lib/index.browser.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC"}

package/lib/index.browser.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA8D;AAC9D,0CAAwB","sourcesContent":["// Browser entry point - re-exports everything from main index\nexport * from './index';\n"]}

package/lib/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,oBAAoB,CAAC;AAGnC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC"}

package/lib/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;AAEH,qBAAqB;AACrB,qDAAmC;AAEnC,wDAAwD;AACxD,sDAAoC;AAEpC,mDAAmD;AACnD,sDAAoC;AAEpC,eAAe;AACf,mDAAiC;AAEjC,6BAA6B;AAC7B,sDAAoC;AAEpC,mDAAmD;AACnD,qDAAmC;AAEnC,2BAA2B;AAC3B,qDAAmC;AAEnC,wCAAwC;AACxC,uDAAqC;AAErC,uEAAuE;AACvE,uDAAqC;AAErC,mDAAmD;AACnD,qDAAmC;AAEnC,2CAA2C;AAC3C,oDAAkC;AAElC,yCAAyC;AACzC,uDAAqC;AAErC,+BAA+B;AAC/B,mDAAiC;AAEjC,0BAA0B;AAC1B,mDAAiC;AAEjC,0CAA0C;AAC1C,wDAAsC","sourcesContent":["/**\n * \\@fgv/ts-app-shell - Shared React UI primitives for application shells.\n *\n * Provides reusable components for:\n * - Column cascade (master-detail drill-down)\n * - Compact sidebar with flyout filter selectors\n * - Toast notifications and log message panel\n * - Command palette\n * - Keybinding registry\n *\n * @packageDocumentation\n */\n\n// Top bar components\nexport * from './packlets/top-bar';\n\n// Messages infrastructure (context, toasts, status bar)\nexport * from './packlets/messages';\n\n// URL hash synchronization for mode/tab navigation\nexport * from './packlets/url-sync';\n\n// Modal dialog\nexport * from './packlets/modal';\n\n// Keyboard shortcut registry\nexport * from './packlets/keyboard';\n\n// Sidebar layout, search, filters, and entity list\nexport * from './packlets/sidebar';\n\n// Column cascade container\nexport * from './packlets/cascade';\n\n// Selectors (PreferredSelector popover)\nexport * from './packlets/selectors';\n\n// JSON drop zone (generic drop/paste target with converter validation)\nexport * from './packlets/drop-zone';\n\n// Generic edit field primitives for entity editors\nexport * from './packlets/editing';\n\n// Generic detail-view primitive components\nexport * from './packlets/detail';\n\n// AI assist hook (generic, context-free)\nexport * from './packlets/ai-assist';\n\n// Print popup window enclosure\nexport * from './packlets/print';\n\n// Theme provider and hook\nexport * from './packlets/theme';\n\n// Responsive layout detection and context\nexport * from './packlets/responsive';\n"]}

package/lib/packlets/ai-assist/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/ai-assist/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC"}

package/lib/packlets/ai-assist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6CAOuB;AANrB,oHAAA,qBAAqB,OAAA;AACrB,0GAAA,WAAW,OAAA","sourcesContent":["/**\n * AI assist packlet — generic hook for AI-assisted entity generation.\n * @packageDocumentation\n */\n\nexport {\n checkForAiErrorObject,\n useAiAssist,\n type IAiAssistAction,\n type IAiAssistResult,\n type IUseAiAssistParams,\n type IUseAiAssistResult\n} from './useAiAssist';\n"]}

package/lib/packlets/ai-assist/useAiAssist.d.ts CHANGED Viewed

@@ -57,6 +57,32 @@ export interface IUseAiAssistResult {
      * @returns Success with the validated entity, or failure.
      */
     readonly generateDirect: <TEntity>(provider: AiAssist.AiProviderId, prompt: AiAssist.AiPrompt, convert: (from: unknown) => Result<TEntity>, tools?: ReadonlyArray<AiAssist.AiServerToolConfig>) => Promise<Result<IAiAssistResult<TEntity>>>;
+    /**
+     * Execute an image-generation action: calls the provider's image API and
+     * returns the generated images.
+     * @returns Success with the image generation response, or failure.
+     */
+    readonly generateImages: (provider: AiAssist.AiProviderId, params: AiAssist.IAiImageGenerationParams, signal?: AbortSignal) => Promise<Result<AiAssist.IAiImageGenerationResponse>>;
+    /**
+     * List the models available from a provider, optionally filtered by capability.
+     * @returns Success with the resolved model list, or failure (no silent fallback).
+     */
+    readonly listModels: (provider: AiAssist.AiProviderId, capability?: AiAssist.AiModelCapability, signal?: AbortSignal) => Promise<Result<ReadonlyArray<AiAssist.IAiModelInfo>>>;
+    /**
+     * Stream a chat completion from the provider. The `onEvent` callback fires
+     * for every event (text deltas, tool progress, errors); the returned
+     * promise resolves with the aggregated final text and truncation flag on
+     * success, or with `Result.fail` when the stream couldn't be started or
+     * ended in a terminal error event.
+     */
+    readonly streamDirect: (provider: AiAssist.AiProviderId, prompt: AiAssist.AiPrompt, onEvent: (event: AiAssist.IAiStreamEvent) => void, options?: {
+        readonly tools?: ReadonlyArray<AiAssist.AiServerToolConfig>;
+        readonly messagesBefore?: ReadonlyArray<AiAssist.IChatMessage>;
+        readonly signal?: AbortSignal;
+    }) => Promise<Result<{
+        readonly fullText: string;
+        readonly truncated: boolean;
+    }>>;
 }
 /**
  * Checks whether a parsed AI response is an error object (with an "error" field)

package/lib/packlets/ai-assist/useAiAssist.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useAiAssist.d.ts","sourceRoot":"","sources":["../../../src/packlets/ai-assist/useAiAssist.ts"],"names":[],"mappings":"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"}

package/lib/packlets/ai-assist/useAiAssist.js CHANGED Viewed

@@ -20,6 +20,13 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkForAiErrorObject = checkForAiErrorObject;
 exports.useAiAssist = useAiAssist;
@@ -37,6 +44,35 @@ const ts_utils_1 = require("@fgv/ts-utils");
 // ============================================================================
 // Helpers
 // ============================================================================
+/**
+ * Resolves the API key for a dispatcher call, honoring `descriptor.needsSecret`.
+ *
+ * - When `descriptor.needsSecret === false` (e.g. ollama, openai-compat),
+ *   returns the configured key if one happens to be set in the keystore, or
+ *   an empty string otherwise. ts-extras omits the `Authorization` header
+ *   entirely for empty keys, which self-hosted servers expect.
+ * - When `descriptor.needsSecret !== false`, requires `secretName`, an
+ *   unlocked keystore, and a successful key fetch.
+ *
+ * @internal
+ */
+function resolveApiKey(descriptor, providerConfig, keyStore) {
+    var _a;
+    const { provider, secretName } = providerConfig;
+    if (descriptor.needsSecret === false) {
+        if (!secretName || !(keyStore === null || keyStore === void 0 ? void 0 : keyStore.isUnlocked)) {
+            return (0, ts_utils_1.succeed)('');
+        }
+        return (0, ts_utils_1.succeed)((_a = keyStore.getApiKey(secretName).orDefault('')) !== null && _a !== void 0 ? _a : '');
+    }
+    if (!secretName) {
+        return (0, ts_utils_1.fail)(`Provider "${provider}" has no secret name configured`);
+    }
+    if (!keyStore) {
+        return (0, ts_utils_1.fail)('No keystore available');
+    }
+    return keyStore.getApiKey(secretName).withErrorFormat((m) => `Failed to get API key: ${m}`);
+}
 /**
  * Checks whether a parsed AI response is an error object (with an "error" field)
  * rather than a valid entity. AI prompts instruct the model to return
@@ -76,11 +112,15 @@ function useAiAssist(params) {
             ? settings.defaultProvider
             : (_c = (_b = providers[0]) === null || _b === void 0 ? void 0 : _b.provider) !== null && _c !== void 0 ? _c : 'copy-paste';
         return providers.map((config) => {
-            var _a, _b;
+            var _a;
             let isAvailable = true;
             let unavailableReason;
-            if (config.provider !== 'copy-paste') {
-                // API-based providers need a secret name and unlocked keystore with that secret
+            const descriptor = ts_extras_1.AiAssist.getProviderDescriptor(config.provider).orDefault();
+            // Self-hosted / no-secret providers (e.g. ollama, openai-compat) skip
+            // the keystore check entirely — they're available as long as the
+            // descriptor exists. Providers with `needsSecret: true` still require
+            // a configured secretName and an unlocked keystore.
+            if (config.provider !== 'copy-paste' && (descriptor === null || descriptor === void 0 ? void 0 : descriptor.needsSecret) !== false) {
                 if (!config.secretName) {
                     isAvailable = false;
                     unavailableReason = 'No API key secret configured';
@@ -101,7 +141,7 @@ function useAiAssist(params) {
                     }
                 }
             }
-            const label = (_b = (_a = ts_extras_1.AiAssist.getProviderDescriptor(config.provider).orDefault()) === null || _a === void 0 ? void 0 : _a.buttonLabel) !== null && _b !== void 0 ? _b : config.provider;
+            const label = (_a = descriptor === null || descriptor === void 0 ? void 0 : descriptor.buttonLabel) !== null && _a !== void 0 ? _a : config.provider;
             return {
                 provider: config.provider,
                 label,
@@ -131,16 +171,9 @@ function useAiAssist(params) {
             return (0, ts_utils_1.fail)(descriptorResult.message);
         }
         const descriptor = descriptorResult.value;
-        if (!providerConfig.secretName) {
-            return (0, ts_utils_1.fail)(`Provider "${provider}" has no secret name configured`);
-        }
-        if (!keyStore) {
-            return (0, ts_utils_1.fail)('No keystore available');
-        }
-        // Get API key from keystore
-        const apiKeyResult = keyStore.getApiKey(providerConfig.secretName);
+        const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);
         if (apiKeyResult.isFailure()) {
-            return (0, ts_utils_1.fail)(`Failed to get API key: ${apiKeyResult.message}`);
+            return (0, ts_utils_1.fail)(apiKeyResult.message);
         }
         setIsWorking(true);
         try {
@@ -156,6 +189,7 @@ function useAiAssist(params) {
                     prompt,
                     additionalMessages: correctionMessages.length > 0 ? correctionMessages : undefined,
                     modelOverride: providerConfig.model,
+                    endpoint: providerConfig.endpoint,
                     logger,
                     tools: effectiveTools.length > 0 ? effectiveTools : undefined
                 };
@@ -211,13 +245,180 @@ function useAiAssist(params) {
                     return (0, ts_utils_1.fail)(`AI response validation failed after ${maxAttempts} attempts: ${entityResult.message}`);
                 }
             }
-            // Unreachable, but TypeScript needs it
+            /* c8 ignore next 2 - unreachable: every loop iteration returns; TypeScript needs the trailing return */
             return (0, ts_utils_1.fail)('AI generation failed');
         }
         finally {
             setIsWorking(false);
         }
     }, [settings, keyStore, logger]);
-    return { actions, isWorking, copyPrompt, generateDirect };
+    const generateImages = (0, react_1.useCallback)(async (provider, params, signal) => {
+        const providerConfig = settings === null || settings === void 0 ? void 0 : settings.providers.find((p) => p.provider === provider);
+        if (!providerConfig) {
+            return (0, ts_utils_1.fail)(`Provider "${provider}" not configured`);
+        }
+        const descriptorResult = ts_extras_1.AiAssist.getProviderDescriptor(provider);
+        if (descriptorResult.isFailure()) {
+            return (0, ts_utils_1.fail)(descriptorResult.message);
+        }
+        const descriptor = descriptorResult.value;
+        if (!ts_extras_1.AiAssist.supportsImageGeneration(descriptor)) {
+            return (0, ts_utils_1.fail)(`Provider "${provider}" does not support image generation`);
+        }
+        const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);
+        if (apiKeyResult.isFailure()) {
+            return (0, ts_utils_1.fail)(apiKeyResult.message);
+        }
+        setIsWorking(true);
+        try {
+            const requestParams = {
+                descriptor,
+                apiKey: apiKeyResult.value,
+                params,
+                modelOverride: providerConfig.model,
+                endpoint: providerConfig.endpoint,
+                logger,
+                signal
+            };
+            const useProxy = !!(settings === null || settings === void 0 ? void 0 : settings.proxyUrl) && (settings.proxyAllProviders === true || descriptor.corsRestricted);
+            const result = useProxy
+                ? await ts_extras_1.AiAssist.callProxiedImageGeneration(settings.proxyUrl, requestParams)
+                : await ts_extras_1.AiAssist.callProviderImageGeneration(requestParams);
+            if (result.isFailure()) {
+                logger === null || logger === void 0 ? void 0 : logger.error(`AI image generation failed: ${result.message}`);
+            }
+            return result;
+        }
+        finally {
+            setIsWorking(false);
+        }
+    }, [settings, keyStore, logger]);
+    const listModels = (0, react_1.useCallback)(async (provider, capability, signal) => {
+        const providerConfig = settings === null || settings === void 0 ? void 0 : settings.providers.find((p) => p.provider === provider);
+        if (!providerConfig) {
+            return (0, ts_utils_1.fail)(`Provider "${provider}" not configured`);
+        }
+        const descriptorResult = ts_extras_1.AiAssist.getProviderDescriptor(provider);
+        if (descriptorResult.isFailure()) {
+            return (0, ts_utils_1.fail)(descriptorResult.message);
+        }
+        const descriptor = descriptorResult.value;
+        const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);
+        if (apiKeyResult.isFailure()) {
+            return (0, ts_utils_1.fail)(apiKeyResult.message);
+        }
+        const requestParams = Object.assign(Object.assign({ descriptor, apiKey: apiKeyResult.value }, (capability !== undefined ? { capability } : {})), { endpoint: providerConfig.endpoint, logger,
+            signal });
+        const useProxy = !!(settings === null || settings === void 0 ? void 0 : settings.proxyUrl) && (settings.proxyAllProviders === true || descriptor.corsRestricted);
+        const result = useProxy
+            ? await ts_extras_1.AiAssist.callProxiedListModels(settings.proxyUrl, requestParams)
+            : await ts_extras_1.AiAssist.callProviderListModels(requestParams);
+        if (result.isFailure()) {
+            logger === null || logger === void 0 ? void 0 : logger.error(`AI list-models failed: ${result.message}`);
+        }
+        return result;
+    }, [settings, keyStore, logger]);
+    const streamDirect = (0, react_1.useCallback)(async (provider, prompt, onEvent, options) => {
+        var _a, e_1, _b, _c;
+        const providerConfig = settings === null || settings === void 0 ? void 0 : settings.providers.find((p) => p.provider === provider);
+        if (!providerConfig) {
+            return (0, ts_utils_1.fail)(`Provider "${provider}" not configured`);
+        }
+        const descriptorResult = ts_extras_1.AiAssist.getProviderDescriptor(provider);
+        if (descriptorResult.isFailure()) {
+            return (0, ts_utils_1.fail)(descriptorResult.message);
+        }
+        const descriptor = descriptorResult.value;
+        const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);
+        if (apiKeyResult.isFailure()) {
+            return (0, ts_utils_1.fail)(apiKeyResult.message);
+        }
+        const effectiveTools = ts_extras_1.AiAssist.resolveEffectiveTools(descriptor, providerConfig.tools, options === null || options === void 0 ? void 0 : options.tools);
+        const requestParams = {
+            descriptor,
+            apiKey: apiKeyResult.value,
+            prompt,
+            messagesBefore: options === null || options === void 0 ? void 0 : options.messagesBefore,
+            modelOverride: providerConfig.model,
+            endpoint: providerConfig.endpoint,
+            logger,
+            tools: effectiveTools.length > 0 ? effectiveTools : undefined,
+            signal: options === null || options === void 0 ? void 0 : options.signal
+        };
+        const useProxy = !!(settings === null || settings === void 0 ? void 0 : settings.proxyUrl) && (settings.proxyAllProviders === true || descriptor.streamingCorsRestricted);
+        const openResult = useProxy
+            ? await ts_extras_1.AiAssist.callProxiedCompletionStream(settings.proxyUrl, requestParams)
+            : await ts_extras_1.AiAssist.callProviderCompletionStream(requestParams);
+        if (openResult.isFailure()) {
+            logger === null || logger === void 0 ? void 0 : logger.error(`AI streaming failed to start: ${openResult.message}`);
+            return (0, ts_utils_1.fail)(openResult.message);
+        }
+        setIsWorking(true);
+        let fullText = '';
+        let truncated = false;
+        let terminalError;
+        let receivedTerminalEvent = false;
+        try {
+            try {
+                for (var _d = true, _e = __asyncValues(openResult.value), _f; _f = await _e.next(), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const event = _c;
+                    try {
+                        onEvent(event);
+                    }
+                    catch (err) {
+                        // Consumer callback threw (e.g. setState-after-unmount). Convert
+                        // into a terminal failure so streamDirect always resolves to a
+                        // Result instead of rejecting and breaking its contract.
+                        terminalError = `AI stream event handler failed: ${err instanceof Error ? err.message : String(err)}`;
+                        receivedTerminalEvent = true;
+                        break;
+                    }
+                    if (event.type === 'text-delta') {
+                        fullText += event.delta;
+                    }
+                    else if (event.type === 'done') {
+                        fullText = event.fullText;
+                        truncated = event.truncated;
+                        receivedTerminalEvent = true;
+                    }
+                    else if (event.type === 'error') {
+                        terminalError = event.message;
+                        receivedTerminalEvent = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) await _b.call(_e);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        finally {
+            setIsWorking(false);
+        }
+        if (terminalError !== undefined) {
+            logger === null || logger === void 0 ? void 0 : logger.error(`AI streaming ended in error: ${terminalError}`);
+            return (0, ts_utils_1.fail)(terminalError);
+        }
+        if (!receivedTerminalEvent) {
+            const message = 'AI stream ended without a terminal done or error event';
+            logger === null || logger === void 0 ? void 0 : logger.error(message);
+            return (0, ts_utils_1.fail)(message);
+        }
+        return (0, ts_utils_1.succeed)({ fullText, truncated });
+    }, [settings, keyStore, logger]);
+    return {
+        actions,
+        isWorking,
+        copyPrompt,
+        generateDirect,
+        generateImages,
+        listModels,
+        streamDirect
+    };
 }
 //# sourceMappingURL=useAiAssist.js.map

package/lib/packlets/ai-assist/useAiAssist.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useAiAssist.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/useAiAssist.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 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/**\n * Generic AI assist hook — parameterized by settings and keystore, no app-specific context.\n *\n * Provides a list of available AI assist actions and functions for copy-paste\n * and direct API generation flows.\n *\n * @packageDocumentation\n */\n\nimport { useCallback, useMemo, useState } from 'react';\n\nimport { AiAssist } from '@fgv/ts-extras';\nimport { fail, type Logging, Result, succeed } from '@fgv/ts-utils';\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Parameters for the generic useAiAssist hook.\n * @public\n */\nexport interface IUseAiAssistParams {\n /** Resolved AI assist settings (provider list + default). */\n readonly settings: AiAssist.IAiAssistSettings | undefined;\n /** Keystore for API key resolution (or undefined if no keystore). */\n readonly keyStore: AiAssist.IAiAssistKeyStore | undefined;\n /** Optional logger for request/response observability. */\n readonly logger?: Logging.ILogger;\n}\n\n/**\n * A single available AI assist action.\n * @public\n */\nexport interface IAiAssistAction {\n /** The provider identifier */\n readonly provider: AiAssist.AiProviderId;\n /** Display label (e.g. \"AI Assist | Copy\", \"AI Assist | Grok\") */\n readonly label: string;\n /** Whether this is the default (first) action */\n readonly isDefault: boolean;\n /** Whether the provider is currently available (keystore unlocked, secret present) */\n readonly isAvailable: boolean;\n /** Reason the provider is unavailable, if any */\n readonly unavailableReason?: string;\n}\n\n/**\n * Result of executing an AI assist action.\n * @public\n */\nexport interface IAiAssistResult<TEntity> {\n /** The generated entity */\n readonly entity: TEntity;\n /** Source indicator */\n readonly source: 'ai';\n}\n\n/**\n * Return type of the useAiAssist hook.\n * @public\n */\nexport interface IUseAiAssistResult {\n /** Available actions based on settings + keystore state */\n readonly actions: ReadonlyArray<IAiAssistAction>;\n /** Whether a direct assist call is in progress */\n readonly isWorking: boolean;\n /**\n * Execute a copy-paste action: copies the combined prompt to clipboard.\n * @returns Success with `'copied'`, or failure.\n */\n readonly copyPrompt: (prompt: AiAssist.AiPrompt) => Promise<Result<'copied'>>;\n /**\n * Execute a direct API action: calls the provider, validates the response, returns the entity.\n * @returns Success with the validated entity, or failure.\n */\n readonly generateDirect: <TEntity>(\n provider: AiAssist.AiProviderId,\n prompt: AiAssist.AiPrompt,\n convert: (from: unknown) => Result<TEntity>,\n tools?: ReadonlyArray<AiAssist.AiServerToolConfig>\n ) => Promise<Result<IAiAssistResult<TEntity>>>;\n /**\n * Execute an image-generation action: calls the provider's image API and\n * returns the generated images.\n * @returns Success with the image generation response, or failure.\n */\n readonly generateImages: (\n provider: AiAssist.AiProviderId,\n params: AiAssist.IAiImageGenerationParams,\n signal?: AbortSignal\n ) => Promise<Result<AiAssist.IAiImageGenerationResponse>>;\n /**\n * List the models available from a provider, optionally filtered by capability.\n * @returns Success with the resolved model list, or failure (no silent fallback).\n */\n readonly listModels: (\n provider: AiAssist.AiProviderId,\n capability?: AiAssist.AiModelCapability,\n signal?: AbortSignal\n ) => Promise<Result<ReadonlyArray<AiAssist.IAiModelInfo>>>;\n /**\n * Stream a chat completion from the provider. The `onEvent` callback fires\n * for every event (text deltas, tool progress, errors); the returned\n * promise resolves with the aggregated final text and truncation flag on\n * success, or with `Result.fail` when the stream couldn't be started or\n * ended in a terminal error event.\n */\n readonly streamDirect: (\n provider: AiAssist.AiProviderId,\n prompt: AiAssist.AiPrompt,\n onEvent: (event: AiAssist.IAiStreamEvent) => void,\n options?: {\n readonly tools?: ReadonlyArray<AiAssist.AiServerToolConfig>;\n readonly messagesBefore?: ReadonlyArray<AiAssist.IChatMessage>;\n readonly signal?: AbortSignal;\n }\n ) => Promise<Result<{ readonly fullText: string; readonly truncated: boolean }>>;\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Resolves the API key for a dispatcher call, honoring `descriptor.needsSecret`.\n *\n * - When `descriptor.needsSecret === false` (e.g. ollama, openai-compat),\n * returns the configured key if one happens to be set in the keystore, or\n * an empty string otherwise. ts-extras omits the `Authorization` header\n * entirely for empty keys, which self-hosted servers expect.\n * - When `descriptor.needsSecret !== false`, requires `secretName`, an\n * unlocked keystore, and a successful key fetch.\n *\n * @internal\n */\nfunction resolveApiKey(\n descriptor: AiAssist.IAiProviderDescriptor,\n providerConfig: AiAssist.IAiAssistProviderConfig,\n keyStore: AiAssist.IAiAssistKeyStore | undefined\n): Result<string> {\n const { provider, secretName } = providerConfig;\n if (descriptor.needsSecret === false) {\n if (!secretName || !keyStore?.isUnlocked) {\n return succeed('');\n }\n return succeed(keyStore.getApiKey(secretName).orDefault('') ?? '');\n }\n if (!secretName) {\n return fail(`Provider \"${provider}\" has no secret name configured`);\n }\n if (!keyStore) {\n return fail('No keystore available');\n }\n return keyStore.getApiKey(secretName).withErrorFormat((m) => `Failed to get API key: ${m}`);\n}\n\n/**\n * Checks whether a parsed AI response is an error object (with an \"error\" field)\n * rather than a valid entity. AI prompts instruct the model to return\n * `{ \"error\": \"...\", \"term\": \"...\" }` when it cannot confidently generate the entity.\n *\n * @param parsed - The parsed JSON from the AI response\n * @returns A failure Result with the error message if it's an error object, or undefined if not\n */\nexport function checkForAiErrorObject(parsed: unknown): Result<never> | undefined {\n if (\n typeof parsed === 'object' &&\n parsed !== null &&\n 'error' in parsed &&\n typeof (parsed as Record<string, unknown>).error === 'string'\n ) {\n const errorObj = parsed as Record<string, unknown>;\n const term = typeof errorObj.term === 'string' ? ` (term: \"${errorObj.term}\")` : '';\n return fail(`AI declined to generate${term}: ${errorObj.error}`);\n }\n return undefined;\n}\n\n// ============================================================================\n// Hook\n// ============================================================================\n\n/**\n * Generic hook providing AI assist actions based on supplied settings and keystore.\n * @param params - Settings and keystore to use (typically from a workspace or app context)\n * @returns Available actions and execution functions\n * @public\n */\nexport function useAiAssist(params: IUseAiAssistParams): IUseAiAssistResult {\n const { settings, keyStore, logger } = params;\n const [isWorking, setIsWorking] = useState(false);\n\n const actions = useMemo((): ReadonlyArray<IAiAssistAction> => {\n const providers = settings?.providers ?? [{ provider: 'copy-paste' as AiAssist.AiProviderId }];\n const enabledSet = new Set(providers.map((p) => p.provider));\n const defaultProvider: AiAssist.AiProviderId =\n settings?.defaultProvider && enabledSet.has(settings.defaultProvider)\n ? settings.defaultProvider\n : providers[0]?.provider ?? ('copy-paste' as AiAssist.AiProviderId);\n\n return providers.map((config) => {\n let isAvailable = true;\n let unavailableReason: string | undefined;\n\n const descriptor = AiAssist.getProviderDescriptor(config.provider).orDefault();\n\n // Self-hosted / no-secret providers (e.g. ollama, openai-compat) skip\n // the keystore check entirely — they're available as long as the\n // descriptor exists. Providers with `needsSecret: true` still require\n // a configured secretName and an unlocked keystore.\n if (config.provider !== 'copy-paste' && descriptor?.needsSecret !== false) {\n if (!config.secretName) {\n isAvailable = false;\n unavailableReason = 'No API key secret configured';\n } else if (!keyStore) {\n isAvailable = false;\n unavailableReason = 'No keystore available';\n } else if (!keyStore.isUnlocked) {\n isAvailable = false;\n unavailableReason = 'Keystore is locked';\n } else {\n const hasSecret = keyStore.hasSecret(config.secretName);\n if (hasSecret.isFailure() || !hasSecret.value) {\n isAvailable = false;\n unavailableReason = `API key \"${config.secretName}\" not found in keystore`;\n }\n }\n }\n\n const label = descriptor?.buttonLabel ?? config.provider;\n return {\n provider: config.provider,\n label,\n isDefault: config.provider === defaultProvider,\n isAvailable,\n unavailableReason\n };\n });\n }, [settings, keyStore]);\n\n const copyPrompt = useCallback(async (prompt: AiAssist.AiPrompt): Promise<Result<'copied'>> => {\n try {\n await navigator.clipboard.writeText(prompt.combined);\n return succeed('copied' as const);\n } catch {\n return fail('Failed to copy prompt to clipboard');\n }\n }, []);\n\n const generateDirect = useCallback(\n async <TEntity>(\n provider: AiAssist.AiProviderId,\n prompt: AiAssist.AiPrompt,\n convert: (from: unknown) => Result<TEntity>,\n tools?: ReadonlyArray<AiAssist.AiServerToolConfig>\n ): Promise<Result<IAiAssistResult<TEntity>>> => {\n // Find the provider config and descriptor\n const providerConfig = settings?.providers.find((p) => p.provider === provider);\n\n if (!providerConfig) {\n return fail(`Provider \"${provider}\" not configured`);\n }\n\n const descriptorResult = AiAssist.getProviderDescriptor(provider);\n if (descriptorResult.isFailure()) {\n return fail(descriptorResult.message);\n }\n const descriptor = descriptorResult.value;\n\n const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n if (apiKeyResult.isFailure()) {\n return fail(apiKeyResult.message);\n }\n\n setIsWorking(true);\n try {\n const maxAttempts = 3;\n const correctionMessages: Array<AiAssist.IChatMessage> = [];\n\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n // Resolve effective tools: per-call override > settings defaults > none\n const effectiveTools = AiAssist.resolveEffectiveTools(descriptor, providerConfig.tools, tools);\n\n // Call the API — through proxy if configured, otherwise direct\n const completionParams: AiAssist.IProviderCompletionParams = {\n descriptor,\n apiKey: apiKeyResult.value,\n prompt,\n additionalMessages: correctionMessages.length > 0 ? correctionMessages : undefined,\n modelOverride: providerConfig.model,\n endpoint: providerConfig.endpoint,\n logger,\n tools: effectiveTools.length > 0 ? effectiveTools : undefined\n };\n const useProxy: boolean =\n !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n const responseResult = useProxy\n ? await AiAssist.callProxiedCompletion(settings!.proxyUrl!, completionParams)\n : await AiAssist.callProviderCompletion(completionParams);\n if (responseResult.isFailure()) {\n logger?.error(`AI completion failed: ${responseResult.message}`);\n return fail(responseResult.message);\n }\n\n const { content: rawResponse, truncated } = responseResult.value;\n logger?.detail(`AI response received (${rawResponse.length} chars, truncated=${truncated})`);\n\n // Truncated responses are almost certainly malformed JSON — fail early\n if (truncated) {\n logger?.warn('AI response truncated due to token limits');\n return fail('AI response was truncated due to token limits — try a shorter prompt');\n }\n\n // Strip markdown code fences and parse JSON\n const stripped = rawResponse\n .trim()\n .replace(/^```(?:\\w+)?\\s*\\n?([\\s\\S]*?)\\n?\\s*```$/, '$1')\n .trim();\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(stripped);\n } catch (err: unknown) {\n const detail = err instanceof Error ? err.message : String(err);\n // JSON parse failures are not retryable — the model isn't producing valid JSON at all\n return fail(`AI returned invalid JSON: ${detail}`);\n }\n\n // Check for AI error object (model declined to generate)\n const aiError = checkForAiErrorObject(parsed);\n if (aiError !== undefined) {\n return aiError;\n }\n\n // Validate with the provided converter\n const entityResult = convert(parsed);\n if (entityResult.isSuccess()) {\n return succeed({ entity: entityResult.value, source: 'ai' as const });\n }\n\n // Validation failed — if we have retries left, send a correction\n logger?.warn(\n `AI response validation failed (attempt ${attempt + 1}/${maxAttempts}): ${entityResult.message}`\n );\n if (attempt < maxAttempts - 1) {\n correctionMessages.push(\n { role: 'assistant', content: rawResponse },\n {\n role: 'user',\n content: `The JSON you returned failed validation with the following error:\\n\\n${entityResult.message}\\n\\nPlease fix the JSON and return ONLY the corrected JSON object, nothing else.`\n }\n );\n } else {\n // Out of retries\n return fail(\n `AI response validation failed after ${maxAttempts} attempts: ${entityResult.message}`\n );\n }\n }\n\n /* c8 ignore next 2 - unreachable: every loop iteration returns; TypeScript needs the trailing return */\n return fail('AI generation failed');\n } finally {\n setIsWorking(false);\n }\n },\n [settings, keyStore, logger]\n );\n\n const generateImages = useCallback(\n async (\n provider: AiAssist.AiProviderId,\n params: AiAssist.IAiImageGenerationParams,\n signal?: AbortSignal\n ): Promise<Result<AiAssist.IAiImageGenerationResponse>> => {\n const providerConfig = settings?.providers.find((p) => p.provider === provider);\n if (!providerConfig) {\n return fail(`Provider \"${provider}\" not configured`);\n }\n\n const descriptorResult = AiAssist.getProviderDescriptor(provider);\n if (descriptorResult.isFailure()) {\n return fail(descriptorResult.message);\n }\n const descriptor = descriptorResult.value;\n\n if (!AiAssist.supportsImageGeneration(descriptor)) {\n return fail(`Provider \"${provider}\" does not support image generation`);\n }\n\n const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n if (apiKeyResult.isFailure()) {\n return fail(apiKeyResult.message);\n }\n\n setIsWorking(true);\n try {\n const requestParams: AiAssist.IProviderImageGenerationParams = {\n descriptor,\n apiKey: apiKeyResult.value,\n params,\n modelOverride: providerConfig.model,\n endpoint: providerConfig.endpoint,\n logger,\n signal\n };\n const useProxy: boolean =\n !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n const result = useProxy\n ? await AiAssist.callProxiedImageGeneration(settings!.proxyUrl!, requestParams)\n : await AiAssist.callProviderImageGeneration(requestParams);\n if (result.isFailure()) {\n logger?.error(`AI image generation failed: ${result.message}`);\n }\n return result;\n } finally {\n setIsWorking(false);\n }\n },\n [settings, keyStore, logger]\n );\n\n const listModels = useCallback(\n async (\n provider: AiAssist.AiProviderId,\n capability?: AiAssist.AiModelCapability,\n signal?: AbortSignal\n ): Promise<Result<ReadonlyArray<AiAssist.IAiModelInfo>>> => {\n const providerConfig = settings?.providers.find((p) => p.provider === provider);\n if (!providerConfig) {\n return fail(`Provider \"${provider}\" not configured`);\n }\n\n const descriptorResult = AiAssist.getProviderDescriptor(provider);\n if (descriptorResult.isFailure()) {\n return fail(descriptorResult.message);\n }\n const descriptor = descriptorResult.value;\n\n const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n if (apiKeyResult.isFailure()) {\n return fail(apiKeyResult.message);\n }\n\n const requestParams: AiAssist.IProviderListModelsParams = {\n descriptor,\n apiKey: apiKeyResult.value,\n ...(capability !== undefined ? { capability } : {}),\n endpoint: providerConfig.endpoint,\n logger,\n signal\n };\n const useProxy: boolean =\n !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.corsRestricted);\n const result = useProxy\n ? await AiAssist.callProxiedListModels(settings!.proxyUrl!, requestParams)\n : await AiAssist.callProviderListModels(requestParams);\n if (result.isFailure()) {\n logger?.error(`AI list-models failed: ${result.message}`);\n }\n return result;\n },\n [settings, keyStore, logger]\n );\n\n const streamDirect = useCallback(\n async (\n provider: AiAssist.AiProviderId,\n prompt: AiAssist.AiPrompt,\n onEvent: (event: AiAssist.IAiStreamEvent) => void,\n options?: {\n readonly tools?: ReadonlyArray<AiAssist.AiServerToolConfig>;\n readonly messagesBefore?: ReadonlyArray<AiAssist.IChatMessage>;\n readonly signal?: AbortSignal;\n }\n ): Promise<Result<{ readonly fullText: string; readonly truncated: boolean }>> => {\n const providerConfig = settings?.providers.find((p) => p.provider === provider);\n if (!providerConfig) {\n return fail(`Provider \"${provider}\" not configured`);\n }\n\n const descriptorResult = AiAssist.getProviderDescriptor(provider);\n if (descriptorResult.isFailure()) {\n return fail(descriptorResult.message);\n }\n const descriptor = descriptorResult.value;\n\n const apiKeyResult = resolveApiKey(descriptor, providerConfig, keyStore);\n if (apiKeyResult.isFailure()) {\n return fail(apiKeyResult.message);\n }\n\n const effectiveTools = AiAssist.resolveEffectiveTools(descriptor, providerConfig.tools, options?.tools);\n const requestParams: AiAssist.IProviderCompletionStreamParams = {\n descriptor,\n apiKey: apiKeyResult.value,\n prompt,\n messagesBefore: options?.messagesBefore,\n modelOverride: providerConfig.model,\n endpoint: providerConfig.endpoint,\n logger,\n tools: effectiveTools.length > 0 ? effectiveTools : undefined,\n signal: options?.signal\n };\n const useProxy: boolean =\n !!settings?.proxyUrl && (settings.proxyAllProviders === true || descriptor.streamingCorsRestricted);\n const openResult = useProxy\n ? await AiAssist.callProxiedCompletionStream(settings!.proxyUrl!, requestParams)\n : await AiAssist.callProviderCompletionStream(requestParams);\n if (openResult.isFailure()) {\n logger?.error(`AI streaming failed to start: ${openResult.message}`);\n return fail(openResult.message);\n }\n\n setIsWorking(true);\n let fullText = '';\n let truncated = false;\n let terminalError: string | undefined;\n let receivedTerminalEvent = false;\n try {\n for await (const event of openResult.value) {\n try {\n onEvent(event);\n } catch (err: unknown) {\n // Consumer callback threw (e.g. setState-after-unmount). Convert\n // into a terminal failure so streamDirect always resolves to a\n // Result instead of rejecting and breaking its contract.\n terminalError = `AI stream event handler failed: ${\n err instanceof Error ? err.message : String(err)\n }`;\n receivedTerminalEvent = true;\n break;\n }\n if (event.type === 'text-delta') {\n fullText += event.delta;\n } else if (event.type === 'done') {\n fullText = event.fullText;\n truncated = event.truncated;\n receivedTerminalEvent = true;\n } else if (event.type === 'error') {\n terminalError = event.message;\n receivedTerminalEvent = true;\n }\n }\n } finally {\n setIsWorking(false);\n }\n if (terminalError !== undefined) {\n logger?.error(`AI streaming ended in error: ${terminalError}`);\n return fail(terminalError);\n }\n if (!receivedTerminalEvent) {\n const message = 'AI stream ended without a terminal done or error event';\n logger?.error(message);\n return fail(message);\n }\n return succeed({ fullText, truncated });\n },\n [settings, keyStore, logger]\n );\n\n return {\n actions,\n isWorking,\n copyPrompt,\n generateDirect,\n generateImages,\n listModels,\n streamDirect\n };\n}\n"]}

package/lib/packlets/badge/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { renderStatusBadge } from './renderStatusBadge';
2	+ //# sourceMappingURL=index.d.ts.map

package/lib/packlets/badge/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/badge/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}