@equinor/fusion-framework-cli-plugin-ai-base 1.0.5 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @equinor/fusion-framework-cli-plugin-ai-base
 
+## 2.0.0
+
+### Major Changes
+
+- abffa53: Major version bump for Fusion Framework React 19 release.
+
+  All packages are bumped to the next major version as part of the React 19 upgrade. This release drops support for React versions below 18 and includes breaking changes across the framework.
+
+  **Breaking changes:**
+  - Peer dependencies now require React 18 or 19 (`^18.0.0 || ^19.0.0`)
+  - React Router upgraded from v6 to v7
+  - Navigation module refactored with new history API
+  - `renderComponent` and `renderApp` now use `createRoot` API
+
+  **Migration:**
+  - Update your React version to 18.0.0 or higher before upgrading
+  - Replace `NavigationProvider.createRouter()` with `@equinor/fusion-framework-react-router`
+  - See individual package changelogs for package-specific migration steps
+
+### Patch Changes
+
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [ae92f13]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [c123c39]
+- Updated dependencies [3de232c]
+- Updated dependencies [32bcf83]
+  - @equinor/fusion-framework-cli@14.0.0
+  - @equinor/fusion-framework-module@6.0.0
+  - @equinor/fusion-framework-module-ai@3.0.0
+  - @equinor/fusion-imports@2.0.0
+
 ## 1.0.5
 
 ### Patch Changes
@@ -56,7 +93,6 @@
   This package provides shared utilities and options used across multiple AI CLI plugins including framework setup, AI configuration, and command option handling.
 
   **Features:**
-
   - Shared AI options and configuration schema
   - Framework setup utilities
   - Common command option handling

package/README.md

@@ -1,30 +1,27 @@
-# AI Base Plugin Package
+# @equinor/fusion-framework-cli-plugin-ai-base
 
-> [!DANGER]
-> **⚠️ INTERNAL USE ONLY**  
-> This package provides shared utilities and options for AI CLI plugins within Equinor's Fusion Framework ecosystem. External consumers should use the higher-level AI CLI plugins instead.
+> [!CAUTION]
+> **Internal base package** — not intended for direct consumption.
+> Use the higher-level AI CLI plugins (`ai-chat`, `ai-index`) instead.
 
-## Purpose
+Shared utilities, option definitions, and framework bootstrapping for the
+Fusion Framework AI CLI plugins. Every AI sub-command in the Fusion CLI
+inherits its Commander options, Zod validation, and framework initialisation
+logic from this package.
 
-Provides common functionality for AI CLI plugins to avoid code duplication:
-- Shared AI command options (model, temperature, tokens, etc.)
-- Fusion Framework setup with AI module configuration
-- Configuration file loading and validation
-- Type definitions for AI options and configuration
+## Who should use this
 
-Used by:
-- `@equinor/fusion-framework-cli-plugin-ai-chat`
-- `@equinor/fusion-framework-cli-plugin-ai-search`
-- `@equinor/fusion-framework-cli-plugin-ai-index`
-
-Changes here affect all consuming plugins, so coordinate updates carefully.
+Authors of **new Fusion CLI AI plugins** that need the same Azure OpenAI /
+Azure Cognitive Search options and framework setup that the existing plugins
+share. If you are building a Fusion application, use the published CLI
+plugins directly.
 
-## Usage in Consuming Plugins
+## Quick start
 
-### Install as Dependency
+### 1. Add the dependency
 
-**For monorepo packages:**
-```json
+```jsonc
+// package.json (monorepo)
 {
   "dependencies": {
     "@equinor/fusion-framework-cli-plugin-ai-base": "workspace:*"
@@ -32,45 +29,138 @@ Changes here affect all consuming plugins, so coordinate updates carefully.
 }
 ```
 
-### Import from Base Package
+### 2. Create a sub-command with AI options
+
+```ts
+import { createCommand } from 'commander';
+import {
+  withOptions,
+  type AiOptions,
+} from '@equinor/fusion-framework-cli-plugin-ai-base/command-options';
+import {
+  registerAiPlugin,
+  setupFramework,
+} from '@equinor/fusion-framework-cli-plugin-ai-base';
+
+const myCommand = createCommand('my-task')
+  .description('Run my custom AI task');
 
-```typescript
-// Import AI options from command-options export
-import { withOptions, type AiOptions, AiOptionsSchema } from '@equinor/fusion-framework-cli-plugin-ai-base/command-options';
+// Attach core + chat + embedding options and pre-action validation
+withOptions(myCommand, { includeChat: true, includeEmbedding: true });
 
-// Import framework utilities from main export
-import { setupFramework, registerAiPlugin, loadFusionAIConfig } from '@equinor/fusion-framework-cli-plugin-ai-base';
+myCommand.action(async (options: AiOptions) => {
+  const framework = await setupFramework(options);
+  // use framework.ai …
+});
 
-// Or import everything from main export
-import { 
-  setupFramework, 
-  registerAiPlugin, 
+// Register under `fusion-cli ai my-task`
+export const register = (program: Command) =>
+  registerAiPlugin(program, myCommand);
+```
+
+### 3. Load a configuration file (optional)
+
+```ts
+import {
   loadFusionAIConfig,
-  type FrameworkInstance,
-  type FusionAIConfig 
+  configureFusionAI,
 } from '@equinor/fusion-framework-cli-plugin-ai-base';
+
+// fusion-ai.config.ts
+export default configureFusionAI(async () => ({
+  apiKey: process.env.OPENAI_API_KEY,
+  deployment: 'gpt-4',
+}));
+
+// at runtime
+const config = await loadFusionAIConfig('fusion-ai.config', {
+  baseDir: process.cwd(),
+});
 ```
 
-## Exports
-
-- `./command-options` - AI command options, validation schemas, and option helpers
-  - `withOptions` - Function to add AI options to a Commander command
-  - `options` - Default export containing all option definitions
-  - `AiOptionsSchema` - Zod schema for validating AI options
-  - `AiOptionsType` - Type inferred from the schema
-  - `AiOptions` - TypeScript interface for AI options
-- `.` - Main export containing:
-  - `setupFramework` - Initialize and configure Fusion Framework with AI module
-  - `registerAiPlugin` - Register AI plugin commands with CLI program
-  - `loadFusionAIConfig` - Load Fusion AI configuration from file
-  - `configureFusionAI` - Configuration factory function
-  - `FrameworkInstance` - Type for initialized framework instance
-  - `FusionAIConfig` - Base configuration interface
-  - `LoadFusionAIConfigOptions` - Options for loading configuration
+## Export map
+
+The package exposes two entry points:
+
+| Entry point | Import path | Purpose |
+|---|---|---|
+| Main | `@equinor/fusion-framework-cli-plugin-ai-base` | Framework setup, plugin registration, config loading |
+| Command options | `@equinor/fusion-framework-cli-plugin-ai-base/command-options` | Commander option definitions, Zod schema, types |
+
+### Main entry point (`.`)
+
+| Export | Kind | Description |
+|---|---|---|
+| `setupFramework` | function | Initialise the Fusion Framework with Azure OpenAI chat, embedding, and vector-store modules |
+| `registerAiPlugin` | function | Register a Commander sub-command under the shared `ai` command group |
+| `loadFusionAIConfig` | function | Locate and import a `fusion-ai.config.{ts,mjs,js,json}` file |
+| `configureFusionAI` | function | Type-safe factory for writing configuration files |
+| `FrameworkInstance` | type | Initialised framework with the AI module |
+| `FusionAIConfig` | interface | Base configuration shape (extend for custom fields) |
+| `LoadFusionAIConfigOptions` | interface | Options for `loadFusionAIConfig` (base dir, extensions) |
+
+### Command options entry point (`./command-options`)
+
+| Export | Kind | Description |
+|---|---|---|
+| `withOptions` | function | Attach AI options and pre-action validation to a Commander command |
+| `options` | object | All Commander `Option` instances as a single record |
+| `AiOptionsSchema` | Zod schema | Runtime validation for the AI options object |
+| `AiOptionsType` | type | Inferred type from `AiOptionsSchema` |
+| `AiOptions` | interface | Hand-authored TypeScript interface for the options |
+
+## Environment variables
+
+Every CLI flag has an environment-variable fallback, so plugins work in CI
+without explicit flags.
+
+| Flag | Environment variable | Required | Default |
+|---|---|---|---|
+| `--openai-api-key` | `AZURE_OPENAI_API_KEY` | Yes | — |
+| `--openai-api-version` | `AZURE_OPENAI_API_VERSION` | Yes | `2024-02-15-preview` |
+| `--openai-instance` | `AZURE_OPENAI_INSTANCE_NAME` | Yes | — |
+| `--openai-chat-deployment` | `AZURE_OPENAI_CHAT_DEPLOYMENT_NAME` | When chat is enabled | — |
+| `--openai-embedding-deployment` | `AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME` | When embedding is enabled | — |
+| `--azure-search-endpoint` | `AZURE_SEARCH_ENDPOINT` | When search is enabled | — |
+| `--azure-search-api-key` | `AZURE_SEARCH_API_KEY` | When search is enabled | — |
+| `--azure-search-index-name` | `AZURE_SEARCH_INDEX_NAME` | When search is enabled | — |
+
+## Key concepts
+
+### Selective option inclusion
+
+`withOptions` accepts an `args` object with three boolean flags — `includeChat`,
+`includeEmbedding`, and `includeSearch` — that control which options (and which
+pre-action validation rules) are attached. Only include what your command needs.
+
+### Pre-action validation
+
+`withOptions` registers a Commander `preAction` hook that validates required
+options before the action handler runs. If a required option is missing or
+empty the hook throws `InvalidOptionArgumentError` with a descriptive message
+that includes the corresponding environment variable name.
+
+### Framework bootstrap
+
+`setupFramework` creates a `ModulesConfigurator`, enables the AI module, and
+conditionally registers chat models, embedding models, and an Azure Cognitive
+Search vector store based on which options are present. The returned
+`FrameworkInstance` is ready for downstream use.
+
+## Consuming plugins
+
+Changes to this package affect every AI CLI plugin:
+
+- `@equinor/fusion-framework-cli-plugin-ai-chat`
+- `@equinor/fusion-framework-cli-plugin-ai-index`
+
+Coordinate updates carefully and create changesets for any consumer-visible
+change.
 
 ## Development
 
-- Build: `pnpm build` (type checking only, no bundling needed)
-- Changesets should be created for versioning and changelog tracking
-- Breaking changes affect all consuming plugins, so coordinate updates carefully
+```sh
+pnpm build        # type-check (no bundling)
+pnpm test         # run Vitest suite
+```
 

package/dist/esm/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAcvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA2B,EAAwB,EAAE,EAAE,CAAC,EAAE,CAAC;AAY5F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAqB,kBAAkB,EACvC,UAAqC,EAAE;IAEvC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAExD,gFAAgF;IAChF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAuB,UAAU,EAAE;QAClE,OAAO;QACP,UAAU;KACX,CAAC,CAAC;IAEH,mEAAmE;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,MAAM,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,sEAAsE;IACtE,OAAO,QAAa,CAAC;AACvB,CAAC;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAcvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA2B,EAAwB,EAAE,EAAE,CAAC,EAAE,CAAC;AAqB5F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAqB,kBAAkB,EACvC,UAAqC,EAAE;IAEvC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAExD,gFAAgF;IAChF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAuB,UAAU,EAAE;QAClE,OAAO;QACP,UAAU;KACX,CAAC,CAAC;IAEH,mEAAmE;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,MAAM,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,sEAAsE;IACtE,OAAO,QAAa,CAAC;AACvB,CAAC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/esm/options/index.js

@@ -1,3 +1,14 @@
+/**
+ * AI command-option utilities for Fusion Framework CLI plugins.
+ *
+ * @remarks
+ * This entry point provides Commander option definitions, a Zod validation schema,
+ * and the {@link withOptions} helper that wires options and pre-action validation
+ * into any Commander command. Import from
+ * `@equinor/fusion-framework-cli-plugin-ai-base/command-options`.
+ *
+ * @packageDocumentation
+ */
 export { default as options } from './options.js';
 export { withOptions } from './with-options.js';
 export { AiOptionsSchema } from './schema.js';

package/dist/esm/options/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/options/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/options/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAsB,MAAM,aAAa,CAAC"}

package/dist/esm/options/options.js

@@ -1,51 +1,81 @@
 import { createOption } from 'commander';
 /**
- * Option for specifying the Azure OpenAI API key.
- * Required for authentication with Azure OpenAI services.
+ * Commander option for the Azure OpenAI API key (`--openai-api-key`).
+ *
+ * @remarks
+ * Required for all Azure OpenAI operations. Falls back to the
+ * `AZURE_OPENAI_API_KEY` environment variable when the flag is omitted.
  */
 export const apiKeyOption = createOption('--openai-api-key <key>', 'API key for Azure OpenAI services').env('AZURE_OPENAI_API_KEY');
 /**
- * Option for specifying the Azure OpenAI API version.
- * Defaults to the latest stable version if not provided.
+ * Commander option for the Azure OpenAI API version (`--openai-api-version`).
+ *
+ * @remarks
+ * Defaults to `2024-02-15-preview`. Falls back to the
+ * `AZURE_OPENAI_API_VERSION` environment variable when the flag is omitted.
  */
 export const apiVersionOption = createOption('--openai-api-version <version>', 'Azure OpenAI API version')
     .env('AZURE_OPENAI_API_VERSION')
     .default('2024-02-15-preview');
 /**
- * Option for specifying the Azure OpenAI instance name.
- * Required for Azure OpenAI service endpoint construction.
+ * Commander option for the Azure OpenAI instance name (`--openai-instance`).
+ *
+ * @remarks
+ * Required for constructing the Azure OpenAI service endpoint. Falls back to
+ * the `AZURE_OPENAI_INSTANCE_NAME` environment variable when the flag is omitted.
  */
 export const apiInstanceOption = createOption('--openai-instance <name>', 'Azure OpenAI instance name').env('AZURE_OPENAI_INSTANCE_NAME');
 /**
- * Option for specifying the Azure OpenAI deployment name for chat models.
- * Required for chat completions API calls.
+ * Commander option for the Azure OpenAI chat deployment (`--openai-chat-deployment`).
+ *
+ * @remarks
+ * Required for chat-completion operations. Falls back to the
+ * `AZURE_OPENAI_CHAT_DEPLOYMENT_NAME` environment variable when the flag is omitted.
+ * Only added to a command when `withOptions` is called with `includeChat: true`.
  */
 export const chatDeploymentOption = createOption('--openai-chat-deployment <name>', 'Azure OpenAI chat deployment name').env('AZURE_OPENAI_CHAT_DEPLOYMENT_NAME');
 /**
- * Option for specifying the Azure OpenAI deployment name for embedding models.
- * Required for embeddings API calls.
+ * Commander option for the Azure OpenAI embedding deployment (`--openai-embedding-deployment`).
+ *
+ * @remarks
+ * Required for embedding and vector-search operations. Falls back to the
+ * `AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME` environment variable when the flag is omitted.
+ * Only added to a command when `withOptions` is called with `includeEmbedding: true`.
  */
 export const embeddingDeploymentOption = createOption('--openai-embedding-deployment <name>', 'Azure OpenAI embedding deployment name').env('AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME');
 /**
- * Option for specifying the Azure Search endpoint URL.
- * Required for Azure Cognitive Search operations.
+ * Commander option for the Azure Cognitive Search endpoint (`--azure-search-endpoint`).
+ *
+ * @remarks
+ * Required for vector-search operations. Falls back to the
+ * `AZURE_SEARCH_ENDPOINT` environment variable when the flag is omitted.
+ * Only added to a command when `withOptions` is called with `includeSearch: true`.
  */
 export const azureSearchEndpointOption = createOption('--azure-search-endpoint <url>', 'Azure Search endpoint URL').env('AZURE_SEARCH_ENDPOINT');
 /**
- * Option for specifying the Azure Search API key.
- * Required for authentication with Azure Cognitive Search.
+ * Commander option for the Azure Cognitive Search API key (`--azure-search-api-key`).
+ *
+ * @remarks
+ * Required for authenticating with Azure Cognitive Search. Falls back to the
+ * `AZURE_SEARCH_API_KEY` environment variable when the flag is omitted.
+ * Only added to a command when `withOptions` is called with `includeSearch: true`.
  */
 export const azureSearchApiKeyOption = createOption('--azure-search-api-key <key>', 'Azure Search API key').env('AZURE_SEARCH_API_KEY');
 /**
- * Option for specifying the Azure Search index name.
- * Required for search operations on a specific index.
+ * Commander option for the Azure Cognitive Search index name (`--azure-search-index-name`).
+ *
+ * @remarks
+ * Identifies the target search index to query or write to. Falls back to the
+ * `AZURE_SEARCH_INDEX_NAME` environment variable when the flag is omitted.
+ * Only added to a command when `withOptions` is called with `includeSearch: true`.
  */
 export const azureSearchIndexNameOption = createOption('--azure-search-index-name <name>', 'Azure Search index name').env('AZURE_SEARCH_INDEX_NAME');
 /**
- * Default export containing all AI-related command options.
+ * All AI-related Commander option definitions as a single object.
  *
- * Provides convenient access to all option definitions for use in CLI commands.
- * Each option can also be imported individually for more granular control.
+ * @remarks
+ * Use this default export for convenient bulk access when you need every option.
+ * For selective inclusion prefer importing the named constants directly.
  */
 export default {
     apiKeyOption,

package/dist/esm/options/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/options/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CACtC,wBAAwB,EACxB,mCAAmC,CACpC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAC1C,gCAAgC,EAChC,0BAA0B,CAC3B;KACE,GAAG,CAAC,0BAA0B,CAAC;KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAC3C,0BAA0B,EAC1B,4BAA4B,CAC7B,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAC9C,iCAAiC,EACjC,mCAAmC,CACpC,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACnD,sCAAsC,EACtC,wCAAwC,CACzC,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACnD,+BAA+B,EAC/B,2BAA2B,CAC5B,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CACjD,8BAA8B,EAC9B,sBAAsB,CACvB,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CACpD,kCAAkC,EAClC,yBAAyB,CAC1B,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEjC;;;;;GAKG;AACH,eAAe;IACb,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;IACjB,oBAAoB;IACpB,yBAAyB;IACzB,yBAAyB;IACzB,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/options/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CACtC,wBAAwB,EACxB,mCAAmC,CACpC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAC1C,gCAAgC,EAChC,0BAA0B,CAC3B;KACE,GAAG,CAAC,0BAA0B,CAAC;KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAC3C,0BAA0B,EAC1B,4BAA4B,CAC7B,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAC9C,iCAAiC,EACjC,mCAAmC,CACpC,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACnD,sCAAsC,EACtC,wCAAwC,CACzC,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CACnD,+BAA+B,EAC/B,2BAA2B,CAC5B,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CACjD,8BAA8B,EAC9B,sBAAsB,CACvB,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CACpD,kCAAkC,EAClC,yBAAyB,CAC1B,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEjC;;;;;;GAMG;AACH,eAAe;IACb,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;IACjB,oBAAoB;IACpB,yBAAyB;IACzB,yBAAyB;IACzB,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC"}

package/dist/esm/options/schema.js

@@ -1,3 +1,8 @@
+/**
+ * Zod validation schema and inferred type for AI command options.
+ *
+ * @packageDocumentation
+ */
 import z from 'zod';
 /**
  * Base Zod schema for AI-related command options.

package/dist/esm/options/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/options/schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,sBAAsB;IACtB,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC,EAAE,OAAO,EAAE,kEAAkE,EAAE,CAAC;SACvF,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;SAC7C,QAAQ,CAAC,yCAAyC,CAAC;IACtD,gBAAgB,EAAE,CAAC;SAChB,MAAM,CAAC,EAAE,OAAO,EAAE,sEAAsE,EAAE,CAAC;SAC3F,GAAG,CAAC,CAAC,EAAE,yCAAyC,CAAC;SACjD,QAAQ,CAAC,0BAA0B,CAAC;IACvC,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,OAAO,EAAE,wEAAwE,EAAE,CAAC;SAC7F,GAAG,CAAC,CAAC,EAAE,2CAA2C,CAAC;SACnD,QAAQ,CAAC,4BAA4B,CAAC;IAEzC,sBAAsB;IACtB,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;IAChD,yBAAyB,EAAE,CAAC;SACzB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uDAAuD,CAAC;SAC/D,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;IACrD,mBAAmB,EAAE,CAAC;SACnB,MAAM,EAAE;SACR,GAAG,CAAC,4CAA4C,CAAC;SACjD,GAAG,CAAC,CAAC,EAAE,mDAAmD,CAAC;SAC3D,QAAQ,EAAE;SACV,QAAQ,CAAC,2BAA2B,CAAC;IACxC,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IACnC,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,qDAAqD,CAAC;SAC7D,QAAQ,EAAE;SACV,QAAQ,CAAC,yBAAyB,CAAC;CACvC,CAAC;KACD,QAAQ,CAAC,iCAAiC,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/options/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,sBAAsB;IACtB,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC,EAAE,OAAO,EAAE,kEAAkE,EAAE,CAAC;SACvF,GAAG,CAAC,CAAC,EAAE,qCAAqC,CAAC;SAC7C,QAAQ,CAAC,yCAAyC,CAAC;IACtD,gBAAgB,EAAE,CAAC;SAChB,MAAM,CAAC,EAAE,OAAO,EAAE,sEAAsE,EAAE,CAAC;SAC3F,GAAG,CAAC,CAAC,EAAE,yCAAyC,CAAC;SACjD,QAAQ,CAAC,0BAA0B,CAAC;IACvC,cAAc,EAAE,CAAC;SACd,MAAM,CAAC,EAAE,OAAO,EAAE,wEAAwE,EAAE,CAAC;SAC7F,GAAG,CAAC,CAAC,EAAE,2CAA2C,CAAC;SACnD,QAAQ,CAAC,4BAA4B,CAAC;IAEzC,sBAAsB;IACtB,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CAAC,mCAAmC,CAAC;IAChD,yBAAyB,EAAE,CAAC;SACzB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uDAAuD,CAAC;SAC/D,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;IACrD,mBAAmB,EAAE,CAAC;SACnB,MAAM,EAAE;SACR,GAAG,CAAC,4CAA4C,CAAC;SACjD,GAAG,CAAC,CAAC,EAAE,mDAAmD,CAAC;SAC3D,QAAQ,EAAE;SACV,QAAQ,CAAC,2BAA2B,CAAC;IACxC,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kDAAkD,CAAC;SAC1D,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IACnC,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,qDAAqD,CAAC;SAC7D,QAAQ,EAAE;SACV,QAAQ,CAAC,yBAAyB,CAAC;CACvC,CAAC;KACD,QAAQ,CAAC,iCAAiC,CAAC,CAAC"}

package/dist/esm/options/types.js

@@ -1,2 +1,11 @@
+/**
+ * Hand-authored TypeScript interface for AI CLI command options.
+ *
+ * @remarks
+ * Use {@link AiOptions} when you need a lightweight type without pulling in Zod.
+ * For runtime validation prefer {@link AiOptionsSchema} from the schema module.
+ *
+ * @packageDocumentation
+ */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/esm/options/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/options/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/options/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/esm/options/with-options.js

@@ -55,7 +55,7 @@ export const withOptions = (command, args) => {
         if (!options.openaiApiKey ||
             typeof options.openaiApiKey !== 'string' ||
             options.openaiApiKey.trim() === '') {
-            throw new InvalidOptionArgumentError('API key is required and must be a non-empty string.');
+            throw new InvalidOptionArgumentError('Azure OpenAI API key is required. Provide it via --openai-api-key option or AZURE_OPENAI_API_KEY environment variable.');
         }
         // Validate API version
         if (!options.openaiApiVersion || typeof options.openaiApiVersion !== 'string') {
@@ -65,7 +65,7 @@ export const withOptions = (command, args) => {
         if (!options.openaiInstance ||
             typeof options.openaiInstance !== 'string' ||
             options.openaiInstance.trim() === '') {
-            throw new InvalidOptionArgumentError('API instance name is required and must be a non-empty string.');
+            throw new InvalidOptionArgumentError('Azure OpenAI instance name is required. Provide it via --openai-instance option or AZURE_OPENAI_INSTANCE_NAME environment variable.');
         }
         if (args?.includeChat === true) {
             if (!options.openaiChatDeployment ||
@@ -78,7 +78,7 @@ export const withOptions = (command, args) => {
             if (!options.openaiEmbeddingDeployment ||
                 typeof options.openaiEmbeddingDeployment !== 'string' ||
                 options.openaiEmbeddingDeployment.trim() === '') {
-                throw new InvalidOptionArgumentError('Embedding deployment name is required and must be a non-empty string.');
+                throw new InvalidOptionArgumentError('Azure OpenAI embedding deployment name is required. Provide it via --openai-embedding-deployment option or AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME environment variable.');
             }
         }
         if (args?.includeSearch === true) {
@@ -90,7 +90,7 @@ export const withOptions = (command, args) => {
             if (!options.azureSearchApiKey ||
                 typeof options.azureSearchApiKey !== 'string' ||
                 options.azureSearchApiKey.trim() === '') {
-                throw new InvalidOptionArgumentError('Azure Search API key is required and must be a non-empty string.');
+                throw new InvalidOptionArgumentError('Azure Search API key is required. Provide it via --azure-search-api-key option or AZURE_SEARCH_API_KEY environment variable.');
             }
             if (!options.azureSearchIndexName ||
                 typeof options.azureSearchIndexName !== 'string' ||

package/dist/esm/options/with-options.js.map

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

package/dist/esm/register.js

@@ -2,23 +2,22 @@ import { createCommand } from 'commander';
 /**
  * Registers an AI plugin command with the CLI program.
  *
- * This function ensures the 'ai' command group exists in the CLI program and adds
- * the provided command as a subcommand. If the 'ai' group doesn't exist, it creates
- * it with a standard description. This allows multiple AI-related plugins to register
- * their commands under a common namespace.
+ * Ensures the `ai` command group exists and attaches the provided command
+ * as a direct subcommand. Each plugin is responsible for structuring its
+ * own subcommands internally.
  *
- * @param program - The Commander program instance to register commands with
- * @param command - The command to add to the 'ai' command group
- * @returns void
+ * @param program - The Commander program instance to register commands with.
+ * @param command - The command to add under the `ai` command group.
  *
  * @example
  * ```ts
- * const myAiCommand = createCommand('chat')
- *   .description('Start an AI chat session')
- *   .action(() => { ... });
+ * // Register a command under `ai`:
+ * registerAiPlugin(program, chatCommand);
+ * // Results in: ffc ai chat
  *
- * registerAiPlugin(program, myAiCommand);
- * // Results in: fusion-cli ai chat
+ * // Register a command that has its own subcommands:
+ * registerAiPlugin(program, indexCommand);
+ * // Results in: ffc ai index embeddings, ffc ai index delete, etc.
  * ```
  */
 export function registerAiPlugin(program, command) {

package/dist/esm/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,OAAgB;IACjE,gDAAgD;IAChD,IAAI,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,WAAW,CACzC,mEAAmE,CACpE,CAAC;QACF,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IACD,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,OAAgB;IACjE,gDAAgD;IAChD,IAAI,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,WAAW,CACzC,mEAAmE,CACpE,CAAC;QACF,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '1.0.5';
+export const version = '2.0.0';
 //# sourceMappingURL=version.js.map