@genesislcap/foundation-ai 14.408.0 → 14.409.0-FUI-2495.1

package/README.md

@@ -21,12 +21,18 @@ Each provider exposes capabilities such as `interpretCriteria` (natural language
 
 ## Feature flag
 
-AI features are **disabled by default** and require the feature flag to be enabled. Add `?feature.ai` to the URL to activate:
+AI features are **disabled by default**. Enable them via URL parameter or environment variable:
 
+**URL parameter** — append `?feature.ai` to any URL (useful for testing without rebuilding):
 ```
 https://your-app.com/?feature.ai
 ```
 
+**Environment variable** — set `GENX_ENABLE_AI=true` in your app's `.env` file to enable permanently without a URL parameter:
+```
+GENX_ENABLE_AI=true
+```
+
 When the flag is off:
 
 - `createAIProvider()` and `getAIProvider()` return a no-op provider

package/dist/dts/utils/feature-flags.d.ts

@@ -1,5 +1,5 @@
-/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
+/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
 export declare const AI_FEATURE_FLAG = "ai";
-/** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
+/** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
 export declare const isAIFeatureEnabled: () => boolean;
 //# sourceMappingURL=feature-flags.d.ts.map

package/dist/dts/utils/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,QAAO,OAA8C,CAAC"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,eAAO,MAAM,eAAe,OAAO,CAAC;AAUpC,iHAAiH;AACjH,eAAO,MAAM,kBAAkB,QAAO,OAA6D,CAAC"}

package/dist/esm/utils/feature-flags.js

@@ -1,5 +1,12 @@
 import { isFeatureActivated } from '@genesislcap/foundation-utils';
-/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
+/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
 export const AI_FEATURE_FLAG = 'ai';
-/** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
-export const isAIFeatureEnabled = () => isFeatureActivated(AI_FEATURE_FLAG);
+let _envEnabled = false;
+try {
+    if (typeof GENX_ENABLE_AI !== 'undefined') {
+        _envEnabled = GENX_ENABLE_AI === 'true';
+    }
+}
+catch (_a) { }
+/** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
+export const isAIFeatureEnabled = () => _envEnabled || isFeatureActivated(AI_FEATURE_FLAG);

package/dist/foundation-ai.api.json

@@ -175,7 +175,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-ai!AI_FEATURE_FLAG:var",
-          "docComment": "/**\n * Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL.\n */\n",
+          "docComment": "/**\n * Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3685,7 +3685,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-ai!isAIFeatureEnabled:function(1)",
-          "docComment": "/**\n * Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL.\n */\n",
+          "docComment": "/**\n * Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var.\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/foundation-ai.d.ts

@@ -1,6 +1,6 @@
 import { InterfaceSymbol } from '@microsoft/fast-foundation';
 
-/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL. */
+/** Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL or GENX_ENABLE_AI env var. */
 export declare const AI_FEATURE_FLAG = "ai";
 
 /**
@@ -479,7 +479,7 @@ export declare type InteractionResult<T = unknown> = {
     message?: string;
 };
 
-/** Returns true when AI features (beta) are enabled. Requires ?feature.ai in URL. */
+/** Returns true when AI features (beta) are enabled via ?feature.ai URL param or GENX_ENABLE_AI=true env var. */
 export declare const isAIFeatureEnabled: () => boolean;
 
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-ai",
   "description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
-  "version": "14.408.0",
+  "version": "14.409.0-FUI-2495.1",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -51,17 +51,17 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.408.0",
-    "@genesislcap/genx": "14.408.0",
-    "@genesislcap/rollup-builder": "14.408.0",
-    "@genesislcap/ts-builder": "14.408.0",
-    "@genesislcap/uvu-playwright-builder": "14.408.0",
-    "@genesislcap/vite-builder": "14.408.0",
-    "@genesislcap/webpack-builder": "14.408.0"
+    "@genesislcap/foundation-testing": "14.409.0-FUI-2495.1",
+    "@genesislcap/genx": "14.409.0-FUI-2495.1",
+    "@genesislcap/rollup-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/ts-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/uvu-playwright-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/vite-builder": "14.409.0-FUI-2495.1",
+    "@genesislcap/webpack-builder": "14.409.0-FUI-2495.1"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "14.408.0",
-    "@genesislcap/foundation-utils": "14.408.0",
+    "@genesislcap/foundation-logger": "14.409.0-FUI-2495.1",
+    "@genesislcap/foundation-utils": "14.409.0-FUI-2495.1",
     "@microsoft/fast-foundation": "2.50.0"
   },
   "repository": {
@@ -72,5 +72,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "26b08831fd001b4ee95c8a0d3364a18c0ec4005b"
+  "gitHead": "1587391f8f98599f221c4fe75b20868382f73144"
 }

package/docs/api/foundation-ai.ai_feature_flag.md

@@ -1,13 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AI\_FEATURE\_FLAG](./foundation-ai.ai_feature_flag.md)
-
-## AI\_FEATURE\_FLAG variable
-
-Feature flag name for AI functionality (beta). Enable via ?feature.ai in URL.
-
-**Signature:**
-
-```typescript
-AI_FEATURE_FLAG = "ai"
-```

package/docs/api/foundation-ai.aiconfig.md

@@ -1,18 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIConfig](./foundation-ai.aiconfig.md)
-
-## AIConfig type
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Union type for provider-specific configs. Extend when adding new providers.
-
-**Signature:**
-
-```typescript
-export type AIConfig = ServerAIConfig | ChromeAIConfig | GeminiAIConfig;
-```
-**References:** [ServerAIConfig](./foundation-ai.serveraiconfig.md)<!-- -->, [ChromeAIConfig](./foundation-ai.chromeaiconfig.md)<!-- -->, [GeminiAIConfig](./foundation-ai.geminiaiconfig.md)
-

package/docs/api/foundation-ai.aiprovider.chat.md

@@ -1,85 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md) &gt; [chat](./foundation-ai.aiprovider.chat.md)
-
-## AIProvider.chat() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Multi-turn chat (non-streaming). Returns the assistant's response message. Providers that support chat (Gemini, OpenAI) implement this.
-
-**Signature:**
-
-```typescript
-chat?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-history
-
-
-</td><td>
-
-[ChatMessage](./foundation-ai.chatmessage.md)<!-- -->\[\]
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-userMessage
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-options
-
-
-</td><td>
-
-[ChatRequestOptions](./foundation-ai.chatrequestoptions.md)
-
-
-</td><td>
-
-_(Optional)_
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;[ChatMessage](./foundation-ai.chatmessage.md)<!-- -->&gt;
-

package/docs/api/foundation-ai.aiprovider.getstatus.md

@@ -1,20 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md) &gt; [getStatus](./foundation-ai.aiprovider.getstatus.md)
-
-## AIProvider.getStatus() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Returns current AI status for display (provider, model, Chrome availability).
-
-**Signature:**
-
-```typescript
-getStatus?(): Promise<AIStatus | null>;
-```
-**Returns:**
-
-Promise&lt;[AIStatus](./foundation-ai.aistatus.md) \| null&gt;
-

package/docs/api/foundation-ai.aiprovider.interpretcriteria.md

@@ -1,67 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md) &gt; [interpretCriteria](./foundation-ai.aiprovider.interpretcriteria.md)
-
-## AIProvider.interpretCriteria() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-**Signature:**
-
-```typescript
-interpretCriteria?(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-input
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-context
-
-
-</td><td>
-
-[CriteriaInterpretContext](./foundation-ai.criteriainterpretcontext.md)
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-Promise&lt;[CriteriaInterpretationResult](./foundation-ai.criteriainterpretationresult.md) \| null&gt;
-

package/docs/api/foundation-ai.aiprovider.md

@@ -1,91 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md)
-
-## AIProvider interface
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-AI Provider interface for foundation-ai.
-
-**Signature:**
-
-```typescript
-export interface AIProvider 
-```
-
-## Remarks
-
-General providers (OpenAI, Chrome) are configured once and expose multiple capabilities. Components check for optional method support before use.
-
-## Methods
-
-<table><thead><tr><th>
-
-Method
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[chat(history, userMessage, options)?](./foundation-ai.aiprovider.chat.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Multi-turn chat (non-streaming). Returns the assistant's response message. Providers that support chat (Gemini, OpenAI) implement this.
-
-
-</td></tr>
-<tr><td>
-
-[getStatus()?](./foundation-ai.aiprovider.getstatus.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Returns current AI status for display (provider, model, Chrome availability).
-
-
-</td></tr>
-<tr><td>
-
-[interpretCriteria(input, context)?](./foundation-ai.aiprovider.interpretcriteria.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_
-
-
-</td></tr>
-<tr><td>
-
-[streamChat(history, userMessage, options)?](./foundation-ai.aiprovider.streamchat.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Multi-turn chat (streaming). Yields chunks as they arrive. Providers that support streaming implement this.
-
-
-</td></tr>
-<tr><td>
-
-[triggerDownload()?](./foundation-ai.aiprovider.triggerdownload.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Triggers Chrome model download. Only ChromeProvider implements this. Must be called from a user gesture (e.g. click).
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/foundation-ai.aiprovider.streamchat.md

@@ -1,85 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md) &gt; [streamChat](./foundation-ai.aiprovider.streamchat.md)
-
-## AIProvider.streamChat() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Multi-turn chat (streaming). Yields chunks as they arrive. Providers that support streaming implement this.
-
-**Signature:**
-
-```typescript
-streamChat?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-history
-
-
-</td><td>
-
-[ChatMessage](./foundation-ai.chatmessage.md)<!-- -->\[\]
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-userMessage
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-options
-
-
-</td><td>
-
-[ChatRequestOptions](./foundation-ai.chatrequestoptions.md)
-
-
-</td><td>
-
-_(Optional)_
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-AsyncIterable&lt;[ChatStreamChunk](./foundation-ai.chatstreamchunk.md)<!-- -->&gt;
-

package/docs/api/foundation-ai.aiprovider.triggerdownload.md

@@ -1,20 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProvider](./foundation-ai.aiprovider.md) &gt; [triggerDownload](./foundation-ai.aiprovider.triggerdownload.md)
-
-## AIProvider.triggerDownload() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Triggers Chrome model download. Only ChromeProvider implements this. Must be called from a user gesture (e.g. click).
-
-**Signature:**
-
-```typescript
-triggerDownload?(): Promise<void>;
-```
-**Returns:**
-
-Promise&lt;void&gt;
-

package/docs/api/foundation-ai.aiprovidertype.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIProviderType](./foundation-ai.aiprovidertype.md)
-
-## AIProviderType type
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-All AI provider identifiers (server, client, unconfigured).
-
-**Signature:**
-
-```typescript
-export type AIProviderType = 'openai' | 'chrome' | 'gemini' | 'none';
-```

package/docs/api/foundation-ai.aistatus.chromeavailability.md

@@ -1,14 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIStatus](./foundation-ai.aistatus.md) &gt; [chromeAvailability](./foundation-ai.aistatus.chromeavailability.md)
-
-## AIStatus.chromeAvailability property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-**Signature:**
-
-```typescript
-chromeAvailability?: ChromeAvailability;
-```

package/docs/api/foundation-ai.aistatus.md

@@ -1,99 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIStatus](./foundation-ai.aistatus.md)
-
-## AIStatus interface
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-AI status for display in the header indicator.
-
-**Signature:**
-
-```typescript
-export interface AIStatus 
-```
-
-## Properties
-
-<table><thead><tr><th>
-
-Property
-
-
-</th><th>
-
-Modifiers
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[chromeAvailability?](./foundation-ai.aistatus.chromeavailability.md)
-
-
-</td><td>
-
-
-</td><td>
-
-[ChromeAvailability](./foundation-ai.chromeavailability.md)
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_
-
-
-</td></tr>
-<tr><td>
-
-[model](./foundation-ai.aistatus.model.md)
-
-
-</td><td>
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-**_(BETA)_**
-
-
-</td></tr>
-<tr><td>
-
-[provider](./foundation-ai.aistatus.provider.md)
-
-
-</td><td>
-
-
-</td><td>
-
-[AIProviderType](./foundation-ai.aiprovidertype.md)
-
-
-</td><td>
-
-**_(BETA)_**
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/foundation-ai.aistatus.model.md

@@ -1,14 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/foundation-ai](./foundation-ai.md) &gt; [AIStatus](./foundation-ai.aistatus.md) &gt; [model](./foundation-ai.aistatus.model.md)
-
-## AIStatus.model property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-**Signature:**
-
-```typescript
-model: string;
-```