@genesislcap/foundation-ai 14.400.0-hide-status-pill.2

package/README.md

@@ -0,0 +1,279 @@
+# Genesis Foundation AI
+
+[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/)
+[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/)
+
+## [API Docs](./docs/api/index.md)
+
+Provider-agnostic AI configuration and shared utilities. Configure once at app bootstrap; use across components via dependency injection.
+
+> **Beta – not for production**  
+> This package is in beta. Do not use in production. API surface and behaviour may change. It is intended for evaluation and development only.
+
+**Supported providers:**
+
+- **OpenAI (server proxy)** – Client calls your server at `/gwf/ai-service/chat-completions`; server calls OpenAI.
+- **Chrome built-in AI** – Prompt API / Gemini Nano (no API key; Chrome 138+)
+
+Each provider exposes capabilities such as `interpretCriteria` (natural language to structured criteria). Future capabilities (e.g. summarization) will be added as optional methods on the same interface.
+
+---
+
+## Feature flag
+
+AI features are **disabled by default** and require the feature flag to be enabled. Add `?feature.ai` to the URL to activate:
+
+```
+https://your-app.com/?feature.ai
+```
+
+When the flag is off:
+
+- `createAIProvider()` and `getAIProvider()` return a no-op provider
+- `resolveAIConfig()` returns `null`
+- AI components (e.g. `*-ai-criteria-search`, `*-ai-indicator`) do not render
+
+You can check the flag programmatically:
+
+```ts
+import { isAIFeatureEnabled, AI_FEATURE_FLAG } from '@genesislcap/foundation-ai';
+
+if (isAIFeatureEnabled()) {
+  // AI features are enabled
+}
+```
+
+---
+
+## Installation
+
+Add `@genesislcap/foundation-ai` as a dependency. Run `npm run bootstrap` after changing dependencies.
+
+```json
+{
+  "dependencies": {
+    "@genesislcap/foundation-ai": "latest"
+  }
+}
+```
+
+---
+
+## Configuration
+
+### 1. Resolve config (Chrome-first or OpenAI)
+
+Use `resolveAIConfig` to prefer Chrome when available, with server proxy as fallback:
+
+```ts
+import { createAIProvider, resolveAIConfig, AIProvider } from '@genesislcap/foundation-ai';
+
+// Server URL is derived from API_HOST. Use provider and model:
+const aiConfig = await resolveAIConfig({
+  provider: 'openai',
+  model: 'gpt-4o-mini',
+  preferChrome: true,
+});
+```
+
+### 2. Register provider in DI
+
+Register the provider at app bootstrap (e.g. in `main.ts`):
+
+```ts
+import { Registration } from '@microsoft/fast-foundation';
+
+this.container.register(
+  Registration.instance(AIProvider, createAIProvider(aiConfig)),
+);
+```
+
+Configure once; all components using `getAIProvider()` receive the same instance.
+
+### 3. Use in components
+
+```ts
+import { getAIProvider } from '@genesislcap/foundation-ai';
+
+const aiProvider = getAIProvider();
+if (aiProvider?.interpretCriteria) {
+  const result = await aiProvider.interpretCriteria(input, { fields: fieldMetadata });
+}
+```
+
+---
+
+## Server-side web handler (OpenAI proxy)
+
+The client posts to `/gwf/ai-service/chat-completions`. You must configure a Genesis web handler on your server to proxy these requests to OpenAI. The API key stays on the server and is never exposed to the client.
+
+### 1. Add a web handler script
+
+Create a `*-web-handler.kts` file in your Genesis app's scripts folder (e.g. `src/main/genesis/scripts/`). Example for OpenAI:
+
+```kotlin
+/**
+ * AI web handler - proxies OpenAI Chat Completions requests.
+ * API key is read from OPENAI_API_KEY env var (never exposed to client).
+ */
+import com.fasterxml.jackson.annotation.JsonAlias
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.databind.ObjectMapper
+import java.net.URI
+import java.net.http.HttpClient
+import java.net.http.HttpRequest
+import java.net.http.HttpResponse
+import java.nio.charset.StandardCharsets
+
+data class ChatCompletionsRequest(
+    val provider: String = "openai",
+    val model: String = "gpt-4o-mini",
+    @JsonProperty("SYSTEM_PROMPT") @JsonAlias("systemPrompt") val systemPrompt: String,
+    @JsonProperty("USER_PROMPT") @JsonAlias("userPrompt") val userPrompt: String,
+    @JsonProperty("RESPONSE_SCHEMA") @JsonAlias("responseSchema") val responseSchema: Map<String, Any>? = null,
+)
+
+data class ChatCompletionsResponse(
+    val content: String,
+)
+
+webHandlers("ai-service") {
+    val httpClient = HttpClient.newBuilder().build()
+    val apiKey = java.lang.System.getenv("OPENAI_API_KEY")
+
+    endpoint<ChatCompletionsRequest, ChatCompletionsResponse>(POST, "chat-completions") {
+        handleRequest {
+            val req = body
+            if (req.provider != "openai") {
+                throw IllegalStateException("Only 'openai' provider is supported for now")
+            }
+            if (apiKey.isNullOrBlank()) {
+                throw IllegalStateException("OPENAI_API_KEY is not configured on the server")
+            }
+            val responseFormat = req.responseSchema?.let { schema ->
+                mapOf(
+                    "type" to "json_schema",
+                    "json_schema" to mapOf(
+                        "name" to "structured_response",
+                        "strict" to true,
+                        "schema" to schema,
+                    ),
+                )
+            }
+            val openAiBody = mapOf(
+                "model" to req.model,
+                "messages" to listOf(
+                    mapOf("role" to "system", "content" to req.systemPrompt),
+                    mapOf("role" to "user", "content" to req.userPrompt),
+                ),
+            ) + (responseFormat?.let { mapOf("response_format" to it) } ?: emptyMap())
+
+            val objectMapper = ObjectMapper()
+            val requestBody = objectMapper.writeValueAsString(openAiBody)
+            val request = HttpRequest.newBuilder()
+                .uri(URI.create("https://api.openai.com/v1/chat/completions"))
+                .header("Authorization", "Bearer $apiKey")
+                .header("Content-Type", "application/json")
+                .POST(HttpRequest.BodyPublishers.ofString(requestBody, StandardCharsets.UTF_8))
+                .build()
+
+            val response = httpClient.send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8))
+
+            if (response.statusCode() >= 400) {
+                LOG.error("OpenAI API error: ${response.statusCode()} - ${response.body()}")
+                throw RuntimeException("OpenAI API error: ${response.statusCode()}")
+            }
+
+            val json = objectMapper.readTree(response.body())
+            val choices = json.path("choices")
+            val content = if (choices.isArray && !choices.isEmpty) {
+                choices.get(0).path("message").path("content").asText()
+            } else ""
+            ChatCompletionsResponse(content = content)
+        }
+    }
+}
+```
+
+### 2. Set the API key
+
+Configure `OPENAI_API_KEY` on the server (env var, system config, or secrets manager). Do not expose it to the client.
+
+---
+
+## Manual provider selection
+
+To force a specific provider instead of using `resolveAIConfig`:
+
+```ts
+// Server proxy (provider + model; URL derived from API_HOST)
+Registration.instance(AIProvider, createAIProvider({
+  provider: 'openai',
+  model: 'gpt-4o-mini',
+}));
+
+// Chrome only (when available)
+Registration.instance(AIProvider, createAIProvider({
+  providerType: 'chrome',
+}));
+```
+
+---
+
+## Chrome built-in AI (Prompt API / Gemini Nano)
+
+The Chrome provider uses the [Prompt API](https://developer.chrome.com/docs/ai/prompt-api) with Gemini Nano. It runs on-device; no API key and no data is sent to external services.
+
+### Production (deployed apps)
+
+Chrome built-in AI is in an **origin trial**. For production domains, users do **not** need to enable any flags:
+
+1. [Enroll your domain](https://developer.chrome.com/origintrials/#/view_trial/2533837740349325313) in the Prompt API origin trial.
+2. Add the origin trial token (meta tag or header) to your app.
+3. The model download is triggered when your app calls `LanguageModel.create()` from a user gesture (e.g. the AI indicator "Install model" button).
+
+### Local development (localhost)
+
+For testing on `localhost`, enable these Chrome flags:
+
+- `chrome://flags/#optimization-guide-on-device-model` → **Enabled**
+- `chrome://flags/#prompt-api-for-gemini-nano` → **Enabled**
+
+Restart Chrome after changing flags.
+
+### Hardware and system requirements
+
+- **OS:** Windows 10/11, macOS 13+, Linux, or ChromeOS (Chromebook Plus)
+- **Storage:** At least 22 GB free (for model download)
+- **GPU:** >4 GB VRAM, or **CPU:** 16 GB RAM and 4+ cores
+- **Network:** Unmetered connection for initial model download only; inference runs offline
+
+See [Chrome's Prompt API docs](https://developer.chrome.com/docs/ai/prompt-api) for full requirements.
+
+---
+
+## Speech-to-text
+
+The package includes Web Speech API utilities for voice input:
+
+```ts
+import { isSpeechRecognitionAvailable, startSpeechRecognition } from '@genesislcap/foundation-ai';
+
+if (isSpeechRecognitionAvailable()) {
+  const stop = startSpeechRecognition(
+    (transcript, isFinal) => { /* handle transcript */ },
+    () => { /* on error */ },
+  );
+  // Call stop() to end recording
+}
+```
+
+---
+
+## License
+
+This project provides front-end dependencies and uses licensed components. Licenses are required during development. Contact [Genesis Global](https://genesis.global/contact-us/) for details.
+
+### Licensed components
+
+Genesis low-code platform

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

@@ -0,0 +1,81 @@
+import type { CriteriaInterpretContext } from './interactions';
+import type { AIConfig, AIStatus, CriteriaInterpretationResult } from './types';
+/**
+ * AI Provider interface for foundation-ai.
+ *
+ * @remarks
+ * General providers (OpenAI, Chrome) are configured once and expose multiple capabilities.
+ * Components check for optional method support before use.
+ *
+ * @beta
+ */
+export interface AIProvider {
+    interpretCriteria?(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+    /**
+     * Returns current AI status for display (provider, model, Chrome availability).
+     */
+    getStatus?(): Promise<AIStatus | null>;
+    /**
+     * Triggers Chrome model download. Only ChromeProvider implements this.
+     * Must be called from a user gesture (e.g. click).
+     */
+    triggerDownload?(): Promise<void>;
+}
+/**
+ * Creates an AIProvider from config.
+ * Uses ChromeProvider when providerType is 'chrome'.
+ * Uses OpenAIProvider with ServerOpenAITransport when provider is set (server-only).
+ * Otherwise returns DefaultAIProvider.
+ * When the AI feature flag is disabled (?feature.ai), always returns DefaultAIProvider.
+ *
+ * @beta
+ */
+export declare function createAIProvider(config?: AIConfig | null): AIProvider;
+export interface ResolveAIConfigOptions {
+    /** Cloud provider (openai). Default: openai */
+    provider?: 'openai';
+    /** Model name (e.g. gpt-4o-mini). Default: gpt-4o-mini */
+    model?: string;
+    /** Prefer Chrome built-in AI when available */
+    preferChrome?: boolean;
+}
+/**
+ * Resolves AI config, optionally preferring Chrome when available.
+ * Use before registering AIProvider. Server URL is derived from API_HOST.
+ * Returns null when the AI feature flag is disabled (?feature.ai).
+ *
+ * @beta
+ */
+export declare function resolveAIConfig(options?: ResolveAIConfigOptions): Promise<AIConfig | null>;
+/**
+ * The DI token for the AIProvider interface.
+ *
+ * @remarks
+ * Register a provider implementation in app bootstrap (e.g. main.ts):
+ * ```ts
+ * Registration.singleton(AIProvider, OpenAIProvider)
+ * ```
+ *
+ * @internal
+ */
+export declare const AIProvider: import("@microsoft/fast-foundation").InterfaceSymbol<AIProvider>;
+/**
+ * Gets AIProvider from the DI container.
+ * When the AI feature flag is disabled (?feature.ai), returns DefaultAIProvider (no-op).
+ *
+ * @remarks
+ * A utility method for host applications that are not using decorators or the DI container.
+ *
+ * @example
+ * ```ts
+ * import { getAIProvider } from '@genesislcap/foundation-ai';
+ * ...
+ * private aiProvider = getAIProvider();
+ * ...
+ * const result = await this.aiProvider.interpretCriteria?.(input, context);
+ * ```
+ *
+ * @beta
+ */
+export declare function getAIProvider(): AIProvider;
+//# sourceMappingURL=ai-provider.d.ts.map

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

@@ -0,0 +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;AAM/D,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EAER,4BAA4B,EAE7B,MAAM,SAAS,CAAC;AAIjB;;;;;;;;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;CACnC;AAUD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CAyBrE;AAED,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,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,CAsB1B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,kEAAwE,CAAC;AAEhG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}

package/dist/dts/index.d.ts

@@ -0,0 +1,8 @@
+export { AIProvider, createAIProvider, getAIProvider, resolveAIConfig } from './ai-provider';
+export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
+export type { AIConfig, AIStatus, AIProviderType, ChromeAIConfig, ChromeAvailability, ServerAIConfig, } from './types';
+export type { ResolveAIConfigOptions } from './ai-provider';
+export type { CriteriaInterpretContext, FieldLike } from './interactions';
+export type { CriteriaClauseResult, CriteriaGroupResult, CriteriaInterpretationResult, } from './types/criteria-types';
+export { isSpeechRecognitionAvailable, startSpeechRecognition } from './utils/speech-to-text';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,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/interactions/criteria-interpretation.d.ts

@@ -0,0 +1,145 @@
+import type { CriteriaInterpretationResult } from '../types';
+/**
+ * Standard JSON Schema for criteria interpretation output.
+ * Used by Chrome Prompt API (responseConstraint) and other providers.
+ *
+ * @beta
+ */
+export declare const CRITERIA_JSON_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly groups: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly logic: {
+                        readonly type: "string";
+                        readonly enum: readonly ["and", "or"];
+                        readonly description: "How clauses within the group are combined";
+                    };
+                    readonly negated: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                        readonly description: "If true, negate the entire group";
+                    };
+                    readonly clauses: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly field: {
+                                    readonly type: "string";
+                                    readonly description: "Field name from available metadata";
+                                };
+                                readonly operator: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["contains", "equals", "startsWith", "endsWith", "greaterThan", "lessThan", "greaterThanOrEqual", "lessThanOrEqual", "notEqual", "dateIsToday", "dateIsAfter", "dateIsBefore", "dateIsEqual", "dateIsGreaterEqual", "dateIsLessEqual", "dateTimeIsAfter", "dateTimeIsBefore", "dateTimeIsGreaterEqual", "dateTimeIsLessEqual"];
+                                };
+                                readonly value: {
+                                    readonly type: readonly ["string", "number", "boolean", "null"];
+                                    readonly description: "Value for the clause; null for dateIsToday";
+                                };
+                            };
+                            readonly required: readonly ["field", "operator", "value"];
+                            readonly additionalProperties: false;
+                        };
+                    };
+                };
+                readonly required: readonly ["logic", "negated", "clauses"];
+                readonly additionalProperties: false;
+            };
+        };
+    };
+    readonly required: readonly ["groups"];
+    readonly additionalProperties: false;
+};
+/**
+ * OpenAI-specific response_format wrapper for structured output.
+ *
+ * @beta
+ */
+export declare const OPENAI_CRITERIA_RESPONSE_FORMAT: {
+    readonly type: "json_schema";
+    readonly json_schema: {
+        readonly name: "criteria_interpretation";
+        readonly strict: true;
+        readonly schema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly groups: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly logic: {
+                                readonly type: "string";
+                                readonly enum: readonly ["and", "or"];
+                                readonly description: "How clauses within the group are combined";
+                            };
+                            readonly negated: {
+                                readonly type: "boolean";
+                                readonly default: false;
+                                readonly description: "If true, negate the entire group";
+                            };
+                            readonly clauses: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly field: {
+                                            readonly type: "string";
+                                            readonly description: "Field name from available metadata";
+                                        };
+                                        readonly operator: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["contains", "equals", "startsWith", "endsWith", "greaterThan", "lessThan", "greaterThanOrEqual", "lessThanOrEqual", "notEqual", "dateIsToday", "dateIsAfter", "dateIsBefore", "dateIsEqual", "dateIsGreaterEqual", "dateIsLessEqual", "dateTimeIsAfter", "dateTimeIsBefore", "dateTimeIsGreaterEqual", "dateTimeIsLessEqual"];
+                                        };
+                                        readonly value: {
+                                            readonly type: readonly ["string", "number", "boolean", "null"];
+                                            readonly description: "Value for the clause; null for dateIsToday";
+                                        };
+                                    };
+                                    readonly required: readonly ["field", "operator", "value"];
+                                    readonly additionalProperties: false;
+                                };
+                            };
+                        };
+                        readonly required: readonly ["logic", "negated", "clauses"];
+                        readonly additionalProperties: false;
+                    };
+                };
+            };
+            readonly required: readonly ["groups"];
+            readonly additionalProperties: false;
+        };
+    };
+};
+export type FieldLike = string | {
+    name?: string;
+    field?: string;
+    label?: string;
+    NAME?: string;
+};
+export interface CriteriaInterpretContext {
+    fields?: FieldLike[];
+}
+/**
+ * Builds the system prompt for criteria interpretation.
+ *
+ * @beta
+ */
+export declare function buildCriteriaSystemPrompt(fields?: FieldLike[], customInstructions?: string): string;
+/**
+ * Builds the user prompt for criteria interpretation.
+ *
+ * @beta
+ */
+export declare function buildCriteriaUserPrompt(input: string): string;
+/**
+ * Parses the raw response text into CriteriaInterpretationResult.
+ *
+ * @beta
+ */
+export declare function parseCriteriaResponse(text: string | null | undefined): CriteriaInterpretationResult | null;
+//# sourceMappingURL=criteria-interpretation.d.ts.map

package/dist/dts/interactions/criteria-interpretation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-interpretation.d.ts","sourceRoot":"","sources":["../../../src/interactions/criteria-interpretation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAwC7D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BvB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOlC,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAUD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,SAAS,EAAO,EACxB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,4BAA4B,GAAG,IAAI,CAkBrC"}

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

@@ -0,0 +1,2 @@
+export * from './criteria-interpretation';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { AIProvider } from '../ai-provider';
+import type { CriteriaInterpretContext } from '../interactions';
+import type { AIStatus } from '../types';
+import type { ChromeAIConfig, CriteriaInterpretationResult } from '../types';
+/**
+ * General Chrome built-in AI provider (Prompt API / Gemini Nano).
+ * Configure once; no apiKey required. Exposes interpretCriteria and future capabilities.
+ *
+ * @remarks
+ * Requires Chrome 138+
+ * Configure in app bootstrap:
+ * ```ts
+ * Registration.instance(AIProvider, new ChromeProvider({ providerType: 'chrome' }))
+ * ```
+ *
+ * @beta
+ */
+export declare class ChromeProvider implements AIProvider {
+    private readonly transport;
+    private readonly criteriaInstructions?;
+    constructor(config?: ChromeAIConfig);
+    getStatus(): Promise<AIStatus>;
+    triggerDownload(): Promise<void>;
+    interpretCriteria(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+}
+//# sourceMappingURL=chrome-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/chrome-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAK7E;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAS;gBAEnC,MAAM,GAAE,cAAmB;IAKjC,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAS9B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;CAiBhD"}

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

@@ -0,0 +1,15 @@
+import type { AIProvider } from '../ai-provider';
+import type { CriteriaInterpretContext } from '../interactions';
+import type { AIStatus } from '../types';
+import type { CriteriaInterpretationResult } from '../types';
+/**
+ * Default no-op AI provider. Used when no provider is configured.
+ * Components should check for capability support and show "Configure AI" state when appropriate.
+ *
+ * @beta
+ */
+export declare class DefaultAIProvider implements AIProvider {
+    getStatus(): Promise<AIStatus>;
+    interpretCriteria(_input: string, _context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+}
+//# sourceMappingURL=default-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/default-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAC5C,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI9B,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;CAGhD"}

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

@@ -0,0 +1,25 @@
+import type { AIProvider } from '../ai-provider';
+import type { CriteriaInterpretContext } from '../interactions';
+import type { AIStatus } from '../types';
+import type { AITransport } from '../types';
+import type { CriteriaInterpretationResult } from '../types';
+export interface OpenAIProviderConfig {
+    criteriaInstructions?: string;
+}
+/**
+ * General OpenAI provider. Uses an injectable transport (ServerOpenAITransport).
+ * Exposes interpretCriteria and future capabilities (e.g. summarize).
+ *
+ * @remarks
+ * Configure via createAIProvider with ServerAIConfig (provider, model).
+ *
+ * @beta
+ */
+export declare class OpenAIProvider implements AIProvider {
+    private readonly transport;
+    private readonly criteriaInstructions?;
+    constructor(config: OpenAIProviderConfig, transport: AITransport);
+    getStatus(): Promise<AIStatus>;
+    interpretCriteria(input: string, context: CriteriaInterpretContext): Promise<CriteriaInterpretationResult | null>;
+}
+//# sourceMappingURL=openai-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAG7D,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAS;gBAEnC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,WAAW;IAK1D,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC;IAQ9B,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC;CAiBhD"}

package/dist/dts/transports/chrome-prompt-transport.d.ts

@@ -0,0 +1,26 @@
+import type { AITransport, ChromeAvailability, StructuredPromptOptions } from '../types';
+/**
+ * Chrome Prompt API (Gemini Nano) transport.
+ * Uses the built-in LanguageModel API when available.
+ *
+ * @remarks
+ * Requires Chrome 138+
+ * Hardware: 16GB RAM, 4+ cores or 4GB+ VRAM, 22GB storage. Desktop only.
+ *
+ * @beta
+ */
+export declare class ChromePromptTransport implements AITransport {
+    private static getLanguageModel;
+    /**
+     * Returns the raw Chrome availability state.
+     * Use this to show download progress and install CTA when downloadable.
+     */
+    getAvailability(): Promise<ChromeAvailability>;
+    /**
+     * Starts the model download by creating a minimal session.
+     * Requires user activation (e.g. click). Call from a user gesture handler.
+     */
+    triggerDownload(): Promise<void>;
+    sendStructuredPrompt(options: StructuredPromptOptions): Promise<string>;
+}
+//# sourceMappingURL=chrome-prompt-transport.d.ts.map

package/dist/dts/transports/chrome-prompt-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-prompt-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/chrome-prompt-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAQzF;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IACvD,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAM/B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAoBpD;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAehC,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;CAiC9E"}

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

@@ -0,0 +1,10 @@
+import type { AITransport, StructuredPromptOptions } from '../types';
+/**
+ * No-op transport for DefaultAIProvider.
+ *
+ * @beta
+ */
+export declare class DefaultTransport implements AITransport {
+    sendStructuredPrompt(_options: StructuredPromptOptions): Promise<string>;
+}
+//# sourceMappingURL=default-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/default-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAErE;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAC5C,oBAAoB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;CAG/E"}