@genesislcap/foundation-ai 14.409.0-FUI-2495.2 → 14.409.0-FUI-2495.4

package/dist/dts/ai-provider.d.ts

@@ -1,5 +1,5 @@
 import type { CriteriaInterpretContext } from './interactions';
-import type { AIConfig, AIStatus, CriteriaInterpretationResult } from './types';
+import { type AIConfig, type AIStatus, type CriteriaInterpretationResult } from './types';
 import type { ChatMessage, ChatRequestOptions, ChatStreamChunk } from './types/chat.types';
 /**
  * AI Provider interface for foundation-ai.
@@ -21,6 +21,14 @@ export interface AIProvider {
      * Must be called from a user gesture (e.g. click).
      */
     triggerDownload?(): Promise<void>;
+    /**
+     * Stateless one-off prompt. No conversation history is maintained.
+     * Returns the plain text response.
+     * Use this for side-calls (suggestions, summarisation, classification) that
+     * should not interact with any ongoing conversation context.
+     * Providers that support chat implement this.
+     */
+    prompt?(message: string, options?: ChatRequestOptions): Promise<string>;
     /**
      * Multi-turn chat (non-streaming). Returns the assistant's response message.
      * Providers that support chat (Gemini, OpenAI) implement this.
@@ -50,7 +58,7 @@ export declare function createAIProvider(config?: AIConfig | null): AIProvider;
 export interface ResolveAIConfigOptions {
     /** Cloud provider (openai, gemini). Default: openai */
     provider?: 'openai' | 'gemini';
-    /** Model name (e.g. gpt-4o-mini). Default: gpt-4o-mini */
+    /** Model name. OpenAI default: gpt-4o-mini. Gemini: only {@link SUPPORTED_GEMINI_MODEL_IDS} (default flash-lite). */
     model?: string;
     /** Prefer Chrome built-in AI when available */
     preferChrome?: boolean;

package/dist/dts/ai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/ai-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAQ/D,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EAER,4BAA4B,EAG7B,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI3F;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;OAGG;IACH,IAAI,CAAC,CACH,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC,CAAC;CACnC;AAcD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CAmCrE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA0B1B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,kEAAwE,CAAC;AAEhG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}
+{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/ai-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAQ/D,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,QAAQ,EAEb,KAAK,4BAA4B,EAIlC,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI3F;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEvC;;;OAGG;IACH,eAAe,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;OAGG;IACH,IAAI,CAAC,CACH,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,CACT,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC,CAAC;CACnC;AAcD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CAmCrE;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,qHAAqH;IACrH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgC1B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,kEAAwE,CAAC;AAEhG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}

package/dist/dts/index.d.ts

@@ -2,8 +2,9 @@ export { AIProvider, createAIProvider, getAIProvider, resolveAIConfig } from './
 export { GeminiProvider } from './providers/gemini-provider';
 export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini-transport';
 export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
-export type { AIConfig, AIStatus, AIProviderType, ChromeAIConfig, ChromeAvailability, GeminiAIConfig, ServerAIConfig, } from './types';
-export type { ChatAgentConfig, ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatDriverResult, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolDefinition, ChatToolHandlers, ChatToolResult, ChatUiConfig, InteractionResult, } from './types/chat.types';
+export { SUPPORTED_GEMINI_MODEL_IDS } from './types';
+export type { AIConfig, AIStatus, AIProviderType, ChromeAIConfig, ChromeAvailability, GeminiAIConfig, GeminiModelId, ServerAIConfig, } from './types';
+export type { ChatAgentConfig, ChatAnimationsConfig, ChatAttachment, ChatConfig, ChatDriverResult, ChatMessage, ChatInteraction, ChatRequestOptions, ChatRole, ChatStreamChunk, ChatToolCall, ChatToolDefinition, ChatToolHandlers, ChatToolResult, ChatUiConfig, ChatSuggestionsConfig, InteractionResult, } from './types/chat.types';
 export type { ChatTransport } from './types/chat-transport.types';
 export type { ResolveAIConfigOptions } from './ai-provider';
 export type { CriteriaInterpretContext, FieldLike } from './interactions';

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/dts/providers/gemini-provider.d.ts

@@ -19,6 +19,7 @@ export declare class GeminiProvider implements AIProvider {
     constructor(config: GeminiProviderConfig, transport: GeminiTransport);
     getStatus(): Promise<AIStatus>;
     interpretCriteria(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+    prompt(message: string, options?: ChatRequestOptions): Promise<string>;
     chat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
     streamChat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
 }

package/dist/dts/providers/gemini-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAOhE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAG5E,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAS;gBAEnC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,eAAe;IAK9D,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAK9B,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAkBzC,IAAI,CACR,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAIhB,UAAU,CACf,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC;CAYlC"}
+{"version":3,"file":"gemini-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAOhE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAG5E,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAS;gBAEnC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,eAAe;IAK9D,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAK9B,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;IAkBzC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtE,IAAI,CACR,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IAIhB,UAAU,CACf,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,aAAa,CAAC,eAAe,CAAC;CAYlC"}

package/dist/dts/transports/gemini-transport.d.ts

@@ -1,8 +1,11 @@
-import type { AITransport, StructuredPromptOptions } from '../types';
+import { type AITransport, type GeminiModelId, type StructuredPromptOptions } from '../types';
 import type { ChatTransport } from '../types/chat-transport.types';
 import type { ChatMessage, ChatRequestOptions } from '../types/chat.types';
 export interface GeminiTransportConfig {
-    model?: string;
+    /**
+     * Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted.
+     */
+    model?: GeminiModelId;
     timeout?: number;
     /**
      * API key for direct calls to the Gemini API.
@@ -45,13 +48,11 @@ export declare class GeminiTransport implements AITransport, ChatTransport {
     constructor(config?: GeminiTransportConfig);
     getConfig(): {
         provider: 'gemini';
-        model: string;
+        model: GeminiModelId;
     };
     sendStructuredPrompt(options: StructuredPromptOptions): Promise<string>;
     sendChatMessage(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
     private static readonly TOKENS_PER_MILLION;
-    private static readonly PROMPT_COST_PER_MILLION;
-    private static readonly CANDIDATE_COST_PER_MILLION;
     private static readonly COST_DECIMAL_PLACES;
     private logTokenUsage;
     private toGeminiContents;

package/dist/dts/transports/gemini-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/gemini-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAEV,WAAW,EACX,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AAO7B,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAAtB,aAAa,CAAC,EAAE,MAAM;CAI5C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,WAAW,EAAE,aAAa;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,GAAE,qBAA0B;IAQ9C,SAAS,IAAI;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAM5C,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvE,eAAe,CACnB,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IA4BvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAO;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAO;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAEhD,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;YAEjC,IAAI;IAgDlB,OAAO,CAAC,eAAe;CAexB"}
+{"version":3,"file":"gemini-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/gemini-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAEV,WAAW,EACX,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AA6B7B,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAAtB,aAAa,CAAC,EAAE,MAAM;CAI5C;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,WAAW,EAAE,aAAa;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,MAAM,GAAE,qBAA0B;IAe9C,SAAS,IAAI;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE;IAMnD,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBvE,eAAe,CACnB,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC;IA4BvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAa;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAEhD,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAO;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;YAEjC,IAAI;IAgDlB,OAAO,CAAC,eAAe;CAexB"}

package/dist/dts/types/chat.types.d.ts

@@ -165,6 +165,12 @@ export interface ChatUiConfig {
     loadingDelay?: number;
     /** Animations feature configuration. */
     animations?: ChatAnimationsConfig;
+    /**
+     * When `true`, shows the `slot="splash"` content when there are no messages.
+     * The host element reflects a `showing-splash` boolean attribute that consumers
+     * can use as a CSS hook to animate the splash in and out. Default: `false`.
+     */
+    showSplash?: boolean;
     /**
      * Show an inline divider in the message list when the active specialist changes.
      * Also shown automatically when showToolCalls is true.
@@ -199,5 +205,36 @@ export interface ChatConfig {
     ui?: ChatUiConfig;
     /** Agent engine settings — iteration limits, handoff caps, classifier tuning. */
     agent?: ChatAgentConfig;
+    /** Query suggestions feature configuration. */
+    suggestions?: ChatSuggestionsConfig;
 }
+/**
+ * Configuration for the chat suggestions feature.
+ *
+ * @beta
+ */
+export type ChatSuggestionsConfig = {
+    /** Suggestions are disabled. */
+    behavior: 'never';
+    /** Not applicable when behavior is 'never'. */
+    count?: never;
+    /** Not applicable when behavior is 'never'. */
+    prompt?: never;
+} | {
+    /**
+     * 'initial': Show suggestions on first load before any messages are sent.
+     * 'always': Show suggestions after every assistant response.
+     */
+    behavior: 'initial' | 'always';
+    /**
+     * Number of suggestions to generate.
+     * @default 3
+     */
+    count?: number;
+    /**
+     * Custom prompt to steer the suggestion generation. If omitted, a
+     * default prompt is used.
+     */
+    prompt?: string;
+};
 //# sourceMappingURL=chat.types.d.ts.map

package/dist/dts/types/chat.types.d.ts.map

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

package/dist/dts/types/config.types.d.ts

@@ -4,6 +4,14 @@
  * @beta
  */
 export type AIProviderType = 'openai' | 'chrome' | 'gemini' | 'none';
+/**
+ * Gemini REST model ids supported by {@link GeminiTransport}.
+ *
+ * @beta
+ */
+export type GeminiModelId = 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
+/** @beta */
+export declare const SUPPORTED_GEMINI_MODEL_IDS: readonly GeminiModelId[];
 /**
  * Base provider-level configuration.
  *
@@ -56,7 +64,8 @@ export interface ChromeAIConfig extends AIProviderConfig {
  */
 export interface GeminiAIConfig extends AIProviderConfig {
     providerType: 'gemini';
-    model?: string;
+    /** Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted at runtime. */
+    model?: GeminiModelId;
     serverEndpoint?: string;
     apiKey?: string;
 }

package/dist/dts/types/config.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../../src/types/config.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,YAAY,EAAE,QAAQ,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC"}
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../../src/types/config.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;AAEzE,YAAY;AACZ,eAAO,MAAM,0BAA0B,EAAE,SAAS,aAAa,EAGrD,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,YAAY,EAAE,QAAQ,CAAC;IACvB,4GAA4G;IAC5G,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAC"}

package/dist/esm/ai-provider.js

@@ -7,6 +7,7 @@ import { OpenAIProvider } from './providers/openai-provider';
 import { ChromePromptTransport } from './transports/chrome-prompt-transport';
 import { GeminiTransport } from './transports/gemini-transport';
 import { ServerOpenAITransport } from './transports/server-openai-transport';
+import { SUPPORTED_GEMINI_MODEL_IDS, } from './types';
 import { logger } from './utils';
 import { isAIFeatureEnabled } from './utils/feature-flags';
 function isChromeConfig(config) {
@@ -74,7 +75,7 @@ export function resolveAIConfig() {
             logger.warn('resolveAIConfig: AI feature flag disabled');
             return null;
         }
-        const { provider = 'openai', model = 'gpt-4o-mini', preferChrome = true } = options;
+        const { provider = 'openai', model, preferChrome = true } = options;
         if (preferChrome) {
             const transport = new ChromePromptTransport();
             const availability = yield transport.getAvailability();
@@ -86,9 +87,13 @@ export function resolveAIConfig() {
             logger.warn('resolveAIConfig: Chrome not available', availability);
         }
         if (provider === 'gemini') {
-            return { providerType: 'gemini', model };
+            const geminiModel = model !== null && model !== void 0 ? model : 'gemini-2.5-flash-lite';
+            if (!SUPPORTED_GEMINI_MODEL_IDS.includes(geminiModel)) {
+                throw new Error(`resolveAIConfig: unsupported Gemini model "${geminiModel}". Use one of: ${SUPPORTED_GEMINI_MODEL_IDS.join(', ')}.`);
+            }
+            return { providerType: 'gemini', model: geminiModel };
         }
-        return { provider, model };
+        return { provider, model: model !== null && model !== void 0 ? model : 'gpt-4o-mini' };
     });
 }
 /**

package/dist/esm/index.js

@@ -2,4 +2,5 @@ export { AIProvider, createAIProvider, getAIProvider, resolveAIConfig } from './
 export { GeminiProvider } from './providers/gemini-provider';
 export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini-transport';
 export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
+export { SUPPORTED_GEMINI_MODEL_IDS } from './types';
 export { isSpeechRecognitionAvailable, startSpeechRecognition } from './utils/speech-to-text';

package/dist/esm/providers/gemini-provider.js

@@ -38,6 +38,12 @@ export class GeminiProvider {
             }
         });
     }
+    prompt(message, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.transport.sendChatMessage([], message, options);
+            return response.content;
+        });
+    }
     chat(history, userMessage, options) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.transport.sendChatMessage(history, userMessage, options);

package/dist/esm/transports/gemini-transport.js

@@ -1,7 +1,23 @@
 import { __awaiter } from "tslib";
+import { SUPPORTED_GEMINI_MODEL_IDS, } from '../types';
+import { logger } from '../utils/logger';
 const GEMINI_DIRECT_URL = (model) => `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`;
-const DEFAULT_MODEL = 'gemini-2.0-flash';
+const DEFAULT_MODEL = 'gemini-2.5-flash-lite';
 const DEFAULT_TIMEOUT = 180000; // 3 minutes
+function assertSupportedGeminiModel(model) {
+    if (!SUPPORTED_GEMINI_MODEL_IDS.includes(model)) {
+        throw new Error(`GeminiTransport: unsupported model "${model}". Use one of: ${SUPPORTED_GEMINI_MODEL_IDS.join(', ')}.`);
+    }
+}
+/**
+ * Paid Standard tier for supported models — https://ai.google.dev/gemini-api/docs/pricing
+ */
+function estimatedGeminiPaidRatesUsdPerMillion(model) {
+    if (model === 'gemini-2.5-flash-lite') {
+        return { promptPerMillion: 0.1, candidatePerMillion: 0.4 };
+    }
+    return { promptPerMillion: 0.3, candidatePerMillion: 2.5 };
+}
 /**
  * Thrown when Gemini returns a `MALFORMED_FUNCTION_CALL` finish reason,
  * typically because the model tried to batch multiple tool calls using
@@ -28,7 +44,12 @@ export class MalformedFunctionCallError extends Error {
 export class GeminiTransport {
     constructor(config = {}) {
         var _a, _b;
-        this.model = (_a = config.model) !== null && _a !== void 0 ? _a : DEFAULT_MODEL;
+        const model = (_a = config.model) !== null && _a !== void 0 ? _a : DEFAULT_MODEL;
+        assertSupportedGeminiModel(model);
+        this.model = model;
+        if (model === 'gemini-2.5-flash') {
+            logger.warn('GeminiTransport: using gemini-2.5-flash — higher cost than flash-lite; use for harder reasoning or agent tasks.');
+        }
         this.timeout = (_b = config.timeout) !== null && _b !== void 0 ? _b : DEFAULT_TIMEOUT;
         this.apiKey = config.apiKey;
         this.serverEndpoint = config.serverEndpoint;
@@ -75,11 +96,11 @@ export class GeminiTransport {
         });
     }
     logTokenUsage(promptTokens, candidateTokens) {
-        const promptCost = (promptTokens / GeminiTransport.TOKENS_PER_MILLION) * GeminiTransport.PROMPT_COST_PER_MILLION;
-        const candidateCost = (candidateTokens / GeminiTransport.TOKENS_PER_MILLION) *
-            GeminiTransport.CANDIDATE_COST_PER_MILLION;
+        const { promptPerMillion, candidatePerMillion } = estimatedGeminiPaidRatesUsdPerMillion(this.model);
+        const promptCost = (promptTokens / GeminiTransport.TOKENS_PER_MILLION) * promptPerMillion;
+        const candidateCost = (candidateTokens / GeminiTransport.TOKENS_PER_MILLION) * candidatePerMillion;
         const totalCost = promptCost + candidateCost;
-        console.log('--- Gemini Token Usage ---');
+        console.log(`--- Gemini Token Usage (${this.model}) ---`);
         console.log(`Prompt Tokens:    ${promptTokens} ($${promptCost.toFixed(GeminiTransport.COST_DECIMAL_PLACES)})`);
         console.log(`Candidate Tokens: ${candidateTokens} ($${candidateCost.toFixed(GeminiTransport.COST_DECIMAL_PLACES)})`);
         console.log(`Total Cost:       $${totalCost.toFixed(GeminiTransport.COST_DECIMAL_PLACES)}`);
@@ -89,7 +110,7 @@ export class GeminiTransport {
         var _a, _b;
         const contents = [];
         for (const msg of history) {
-            if (msg.role === 'system' || msg.thinking)
+            if (msg.role === 'system' || msg.role === 'system-event' || msg.thinking)
                 continue;
             const role = msg.role === 'user' ? 'user' : 'model';
             if (msg.toolResult) {
@@ -163,7 +184,7 @@ export class GeminiTransport {
         }
         // For tool-call responses, surface thought parts as `content` so the UI can
         // render them as a collapsible thinking block. Fall back to text narration
-        // (textParts) for models that don't emit native thought parts (e.g. gemini-2.0-flash)
+        // (textParts) for models that don't emit native thought parts (e.g. some Flash models)
         // but do narrate alongside tool calls when prompted to do so.
         // For final answers, surface only the response text.
         return toolCalls.length > 0
@@ -241,8 +262,6 @@ export class GeminiTransport {
 }
 // ── Private helpers ────────────────────────────────────────────────────
 GeminiTransport.TOKENS_PER_MILLION = 1000000;
-GeminiTransport.PROMPT_COST_PER_MILLION = 0.1;
-GeminiTransport.CANDIDATE_COST_PER_MILLION = 0.4;
 GeminiTransport.COST_DECIMAL_PLACES = 6;
 GeminiTransport.MAX_RETRIES = 5;
 GeminiTransport.RATE_LIMIT_STATUS = 429;

package/dist/esm/types/config.types.js

@@ -1 +1,5 @@
-export {};
+/** @beta */
+export const SUPPORTED_GEMINI_MODEL_IDS = [
+    'gemini-2.5-flash',
+    'gemini-2.5-flash-lite',
+];

package/dist/foundation-ai.api.json

@@ -474,6 +474,73 @@
               ],
               "name": "interpretCriteria"
             },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProvider#prompt:member(1)",
+              "docComment": "/**\n * Stateless one-off prompt. No conversation history is maintained. Returns the plain text response. Use this for side-calls (suggestions, summarisation, classification) that should not interact with any ongoing conversation context. Providers that support chat implement this.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "prompt?(message: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatRequestOptions",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": true,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "message",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "prompt"
+            },
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/foundation-ai!AIProvider#streamChat:member(1)",
@@ -1074,6 +1141,34 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#suggestions:member",
+              "docComment": "/**\n * Query suggestions feature configuration.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "suggestions?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatSuggestionsConfig",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatSuggestionsConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "suggestions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/foundation-ai!ChatConfig#ui:member",
@@ -1771,6 +1866,32 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ai!ChatSuggestionsConfig:type",
+          "docComment": "/**\n * Configuration for the chat suggestions feature.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ChatSuggestionsConfig = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    behavior: 'never';\n    count?: never;\n    prompt?: never;\n} | {\n    behavior: 'initial' | 'always';\n    count?: number;\n    prompt?: string;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/types/chat.types.ts",
+          "releaseTag": "Beta",
+          "name": "ChatSuggestionsConfig",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/foundation-ai!ChatToolCall:interface",
@@ -2472,6 +2593,33 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showSplash:member",
+              "docComment": "/**\n * When `true`, shows the `slot=\"splash\"` content when there are no messages. The host element reflects a `showing-splash` boolean attribute that consumers can use as a CSS hook to animate the splash in and out. Default: `false`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showSplash?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "showSplash",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/foundation-ai!ChatUiConfig#showThinkingSteps:member",
@@ -3102,15 +3250,16 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/foundation-ai!GeminiAIConfig#model:member",
-              "docComment": "",
+              "docComment": "/**\n * Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted at runtime.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
                   "text": "model?: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "string"
+                  "kind": "Reference",
+                  "text": "GeminiModelId",
+                  "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
                 },
                 {
                   "kind": "Content",
@@ -3188,6 +3337,32 @@
             }
           ]
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type",
+          "docComment": "/**\n * Gemini REST model ids supported by {@link GeminiTransport}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type GeminiModelId = "
+            },
+            {
+              "kind": "Content",
+              "text": "'gemini-2.5-flash' | 'gemini-2.5-flash-lite'"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/types/config.types.ts",
+          "releaseTag": "Beta",
+          "name": "GeminiModelId",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider:class",
@@ -3487,6 +3662,76 @@
               "isAbstract": false,
               "name": "interpretCriteria"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider#prompt:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "prompt(message: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatRequestOptions",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatRequestOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<string>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 7
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "message",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "prompt"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/foundation-ai!GeminiProvider#streamChat:member(1)",
@@ -3673,7 +3918,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "{\n        provider: 'gemini';\n        model: string;\n    }"
+                  "text": "{\n        provider: 'gemini';\n        model: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "GeminiModelId",
+                  "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n    }"
                 },
                 {
                   "kind": "Content",
@@ -3683,7 +3937,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 4
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -4159,7 +4413,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/foundation-ai!ResolveAIConfigOptions#model:member",
-              "docComment": "/**\n * Model name (e.g. gpt-4o-mini). Default: gpt-4o-mini\n */\n",
+              "docComment": "/**\n * Model name. OpenAI default: gpt-4o-mini. Gemini: only {@link SUPPORTED_GEMINI_MODEL_IDS} (default flash-lite).\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4362,6 +4616,38 @@
             }
           ],
           "name": "startSpeechRecognition"
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!SUPPORTED_GEMINI_MODEL_IDS:var",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "SUPPORTED_GEMINI_MODEL_IDS: "
+            },
+            {
+              "kind": "Content",
+              "text": "readonly "
+            },
+            {
+              "kind": "Reference",
+              "text": "GeminiModelId",
+              "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            }
+          ],
+          "fileUrlPath": "src/types/config.types.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "SUPPORTED_GEMINI_MODEL_IDS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
         }
       ]
     }

package/dist/foundation-ai.d.ts

@@ -31,6 +31,14 @@ export declare interface AIProvider {
      * Must be called from a user gesture (e.g. click).
      */
     triggerDownload?(): Promise<void>;
+    /**
+     * Stateless one-off prompt. No conversation history is maintained.
+     * Returns the plain text response.
+     * Use this for side-calls (suggestions, summarisation, classification) that
+     * should not interact with any ongoing conversation context.
+     * Providers that support chat implement this.
+     */
+    prompt?(message: string, options?: ChatRequestOptions): Promise<string>;
     /**
      * Multi-turn chat (non-streaming). Returns the assistant's response message.
      * Providers that support chat (Gemini, OpenAI) implement this.
@@ -156,6 +164,8 @@ export declare interface ChatConfig {
     ui?: ChatUiConfig;
     /** Agent engine settings — iteration limits, handoff caps, classifier tuning. */
     agent?: ChatAgentConfig;
+    /** Query suggestions feature configuration. */
+    suggestions?: ChatSuggestionsConfig;
 }
 
 /**
@@ -231,6 +241,36 @@ export declare interface ChatStreamChunk {
     toolCalls?: ChatToolCall[];
 }
 
+/**
+ * Configuration for the chat suggestions feature.
+ *
+ * @beta
+ */
+export declare type ChatSuggestionsConfig = {
+    /** Suggestions are disabled. */
+    behavior: 'never';
+    /** Not applicable when behavior is 'never'. */
+    count?: never;
+    /** Not applicable when behavior is 'never'. */
+    prompt?: never;
+} | {
+    /**
+     * 'initial': Show suggestions on first load before any messages are sent.
+     * 'always': Show suggestions after every assistant response.
+     */
+    behavior: 'initial' | 'always';
+    /**
+     * Number of suggestions to generate.
+     * @default 3
+     */
+    count?: number;
+    /**
+     * Custom prompt to steer the suggestion generation. If omitted, a
+     * default prompt is used.
+     */
+    prompt?: string;
+};
+
 /**
  * A tool call requested by the assistant.
  *
@@ -313,6 +353,12 @@ export declare interface ChatUiConfig {
     loadingDelay?: number;
     /** Animations feature configuration. */
     animations?: ChatAnimationsConfig;
+    /**
+     * When `true`, shows the `slot="splash"` content when there are no messages.
+     * The host element reflects a `showing-splash` boolean attribute that consumers
+     * can use as a CSS hook to animate the splash in and out. Default: `false`.
+     */
+    showSplash?: boolean;
     /**
      * Show an inline divider in the message list when the active specialist changes.
      * Also shown automatically when showToolCalls is true.
@@ -419,11 +465,19 @@ export declare type FieldLike = string | {
  */
 export declare interface GeminiAIConfig extends AIProviderConfig {
     providerType: 'gemini';
-    model?: string;
+    /** Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted at runtime. */
+    model?: GeminiModelId;
     serverEndpoint?: string;
     apiKey?: string;
 }
 
+/**
+ * Gemini REST model ids supported by {@link GeminiTransport}.
+ *
+ * @beta
+ */
+export declare type GeminiModelId = 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
+
 /**
  * Gemini AI provider. Uses {@link GeminiTransport} to handle requests.
  * Implements criteria interpretation and multi-turn chat.
@@ -436,6 +490,7 @@ export declare class GeminiProvider implements AIProvider {
     constructor(config: GeminiProviderConfig, transport: GeminiTransport);
     getStatus(): Promise<AIStatus>;
     interpretCriteria(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+    prompt(message: string, options?: ChatRequestOptions): Promise<string>;
     chat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
     streamChat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
 }
@@ -461,13 +516,11 @@ export declare class GeminiTransport implements AITransport, ChatTransport {
     constructor(config?: GeminiTransportConfig);
     getConfig(): {
         provider: 'gemini';
-        model: string;
+        model: GeminiModelId;
     };
     sendStructuredPrompt(options: StructuredPromptOptions): Promise<string>;
     sendChatMessage(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
     private static readonly TOKENS_PER_MILLION;
-    private static readonly PROMPT_COST_PER_MILLION;
-    private static readonly CANDIDATE_COST_PER_MILLION;
     private static readonly COST_DECIMAL_PLACES;
     private logTokenUsage;
     private toGeminiContents;
@@ -481,7 +534,10 @@ export declare class GeminiTransport implements AITransport, ChatTransport {
 }
 
 declare interface GeminiTransportConfig {
-    model?: string;
+    /**
+     * Defaults to `gemini-2.5-flash-lite`. Only {@link SUPPORTED_GEMINI_MODEL_IDS} are accepted.
+     */
+    model?: GeminiModelId;
     timeout?: number;
     /**
      * API key for direct calls to the Gemini API.
@@ -573,7 +629,7 @@ export declare function resolveAIConfig(options?: ResolveAIConfigOptions): Promi
 export declare interface ResolveAIConfigOptions {
     /** Cloud provider (openai, gemini). Default: openai */
     provider?: 'openai' | 'gemini';
-    /** Model name (e.g. gpt-4o-mini). Default: gpt-4o-mini */
+    /** Model name. OpenAI default: gpt-4o-mini. Gemini: only {@link SUPPORTED_GEMINI_MODEL_IDS} (default flash-lite). */
     model?: string;
     /** Prefer Chrome built-in AI when available */
     preferChrome?: boolean;
@@ -618,4 +674,7 @@ declare interface StructuredPromptOptions {
     responseSchema?: object;
 }
 
+/** @beta */
+export declare const SUPPORTED_GEMINI_MODEL_IDS: readonly GeminiModelId[];
+
 export { }

package/package.json

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