@genesislcap/foundation-ai 14.407.0-workspaces.4 → 14.408.0

package/docs/api-report.md.api.md

@@ -10,15 +10,17 @@ import { InterfaceSymbol } from '@microsoft/fast-foundation';
 export const AI_FEATURE_FLAG = "ai";
 
 // @beta
-export type AIConfig = ServerAIConfig | ChromeAIConfig;
+export type AIConfig = ServerAIConfig | ChromeAIConfig | GeminiAIConfig;
 
 // Warning: (ae-internal-mixed-release-tag) Mixed release tags are not allowed for "AIProvider" because one of its declarations is marked as @internal
 //
 // @beta
 export interface AIProvider {
+    chat?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
     getStatus?(): Promise<AIStatus | null>;
     // (undocumented)
     interpretCriteria?(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+    streamChat?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
     triggerDownload?(): Promise<void>;
 }
 
@@ -26,7 +28,7 @@ export interface AIProvider {
 export const AIProvider: InterfaceSymbol<AIProvider>;
 
 // @beta
-export type AIProviderType = 'openai' | 'chrome' | 'none';
+export type AIProviderType = 'openai' | 'chrome' | 'gemini' | 'none';
 
 // @beta
 export interface AIStatus {
@@ -38,6 +40,128 @@ export interface AIStatus {
     provider: AIProviderType;
 }
 
+// @beta
+export interface ChatAnimationsConfig {
+    enabled?: string[];
+    userConfigurable: boolean;
+}
+
+// @beta
+export interface ChatAttachment {
+    // (undocumented)
+    content: string;
+    // (undocumented)
+    mimeType: string;
+    // (undocumented)
+    name: string;
+}
+
+// @beta
+export interface ChatConfig {
+    acceptedFiles?: string;
+    allowDebugDownload?: boolean;
+    animations?: ChatAnimationsConfig;
+    loadingDelay?: number;
+    maxToolIterations?: number;
+    showThinkingSteps?: boolean | null;
+    showToolCalls?: boolean | null;
+}
+
+// @beta
+export interface ChatInteraction {
+    // (undocumented)
+    componentName: string;
+    // (undocumented)
+    data: any;
+    // (undocumented)
+    interactionId: string;
+    resolved?: boolean;
+}
+
+// @beta
+export interface ChatMessage {
+    // (undocumented)
+    attachments?: ChatAttachment[];
+    // (undocumented)
+    content: string;
+    // (undocumented)
+    interaction?: ChatInteraction;
+    // (undocumented)
+    role: ChatRole;
+    // (undocumented)
+    thinking?: boolean;
+    // (undocumented)
+    toolCalls?: ChatToolCall[];
+    // (undocumented)
+    toolResult?: ChatToolResult;
+}
+
+// @beta
+export interface ChatRequestOptions {
+    // (undocumented)
+    attachments?: ChatAttachment[];
+    // (undocumented)
+    signal?: AbortSignal;
+    // (undocumented)
+    systemPrompt?: string;
+    // (undocumented)
+    tools?: ChatToolDefinition[];
+}
+
+// @beta
+export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
+
+// @beta
+export interface ChatStreamChunk {
+    // (undocumented)
+    delta: string;
+    // (undocumented)
+    done: boolean;
+    // (undocumented)
+    toolCalls?: ChatToolCall[];
+}
+
+// @beta
+export interface ChatToolCall {
+    // (undocumented)
+    args: Record<string, unknown>;
+    // (undocumented)
+    id: string;
+    // (undocumented)
+    name: string;
+}
+
+// @beta
+export interface ChatToolDefinition {
+    // (undocumented)
+    description: string;
+    // (undocumented)
+    name: string;
+    // (undocumented)
+    parameters: Record<string, unknown>;
+}
+
+// @beta
+export type ChatToolHandlers = Record<string, (args: Record<string, unknown>, context: {
+    requestInteraction: <T = unknown>(componentName: string, data: any) => Promise<T>;
+}) => Promise<unknown>>;
+
+// @beta
+export interface ChatToolResult {
+    // (undocumented)
+    content: string;
+    // (undocumented)
+    toolCallId: string;
+}
+
+// @beta
+export interface ChatTransport {
+    // (undocumented)
+    sendChatMessage(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
+    // (undocumented)
+    streamChatMessage?(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
+}
+
 // Warning: (ae-forgotten-export) The symbol "AIProviderConfig" needs to be exported by the entry point index.d.ts
 //
 // @beta
@@ -66,10 +190,8 @@ export interface CriteriaClauseResult {
     value: string | number | boolean | null;
 }
 
-// @public (undocumented)
+// @beta
 export interface CriteriaGroupResult {
-    // Warning: (ae-incompatible-release-tags) The symbol "clauses" is marked as @public, but its signature references "CriteriaClauseResult" which is marked as @beta
-    //
     // (undocumented)
     clauses: CriteriaClauseResult[];
     // (undocumented)
@@ -78,19 +200,19 @@ export interface CriteriaGroupResult {
     negated?: boolean;
 }
 
-// @public (undocumented)
+// @beta
 export interface CriteriaInterpretationResult {
     // (undocumented)
     groups: CriteriaGroupResult[];
 }
 
-// @public (undocumented)
+// @beta
 export interface CriteriaInterpretContext {
     // (undocumented)
     fields?: FieldLike[];
 }
 
-// @public (undocumented)
+// @beta
 export type FieldLike = string | {
     name?: string;
     field?: string;
@@ -98,23 +220,82 @@ export type FieldLike = string | {
     NAME?: string;
 };
 
+// @beta
+export interface GeminiAIConfig extends AIProviderConfig {
+    // (undocumented)
+    apiKey?: string;
+    // (undocumented)
+    model?: string;
+    // (undocumented)
+    providerType: 'gemini';
+    // (undocumented)
+    serverEndpoint?: string;
+}
+
+// @beta
+export class GeminiProvider implements AIProvider {
+    // Warning: (ae-forgotten-export) The symbol "GeminiProviderConfig" needs to be exported by the entry point index.d.ts
+    constructor(config: GeminiProviderConfig, transport: GeminiTransport);
+    // (undocumented)
+    chat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
+    // (undocumented)
+    getStatus(): Promise<AIStatus>;
+    // (undocumented)
+    interpretCriteria(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+    // (undocumented)
+    streamChat(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): AsyncIterable<ChatStreamChunk>;
+}
+
+// Warning: (ae-forgotten-export) The symbol "AITransport" needs to be exported by the entry point index.d.ts
+//
+// @beta
+export class GeminiTransport implements AITransport, ChatTransport {
+    // Warning: (ae-forgotten-export) The symbol "GeminiTransportConfig" needs to be exported by the entry point index.d.ts
+    constructor(config?: GeminiTransportConfig);
+    // (undocumented)
+    getConfig(): {
+        provider: 'gemini';
+        model: string;
+    };
+    // (undocumented)
+    sendChatMessage(history: ChatMessage[], userMessage: string, options?: ChatRequestOptions): Promise<ChatMessage>;
+    // Warning: (ae-forgotten-export) The symbol "StructuredPromptOptions" needs to be exported by the entry point index.d.ts
+    //
+    // (undocumented)
+    sendStructuredPrompt(options: StructuredPromptOptions): Promise<string>;
+}
+
 // @beta
 export function getAIProvider(): AIProvider;
 
+// @beta
+export type InteractionResult<T = unknown> = {
+    status: 'approved' | 'rejected';
+    payload?: T;
+    message?: string;
+};
+
 // @public
 export const isAIFeatureEnabled: () => boolean;
 
 // @beta
 export function isSpeechRecognitionAvailable(): boolean;
 
+// @beta
+export class MalformedFunctionCallError extends Error {
+    constructor(finishMessage?: string);
+    // (undocumented)
+    readonly finishMessage?: string;
+}
+
 // @beta
 export function resolveAIConfig(options?: ResolveAIConfigOptions): Promise<AIConfig | null>;
 
-// @public (undocumented)
+// @beta
 export interface ResolveAIConfigOptions {
     model?: string;
     preferChrome?: boolean;
-    provider?: 'openai';
+    provider?: 'openai' | 'gemini';
 }
 
 // @beta
@@ -128,7 +309,7 @@ export interface ServerAIConfig extends AIProviderConfig {
 // Warning: (ae-forgotten-export) The symbol "SpeechRecognitionResultHandler" needs to be exported by the entry point index.d.ts
 // Warning: (ae-forgotten-export) The symbol "SpeechRecognitionErrorHandler" needs to be exported by the entry point index.d.ts
 //
-// @public (undocumented)
+// @beta
 export function startSpeechRecognition(onResult: SpeechRecognitionResultHandler, onError?: SpeechRecognitionErrorHandler): (() => void) | null;
 
 // (No @packageDocumentation comment for this package)

package/package.json

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