@equinor/fusion-framework-cli-plugin-ai-base 4.0.5 → 4.0.6

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @equinor/fusion-framework-cli-plugin-ai-base
 
+## 4.0.6
+
+### Patch Changes
+
+- 80c3e4a: Internal: Consolidate the eight single-export CLI option files under `src/options/` back into `options.ts` to reduce file fragmentation. No change to the public API or option behavior.
+- 80c3e4a: Internal: renamed 53 source files across `ai-base`, `ai-chat`, `ai-index`, and `copilot` to comply with the `filename-convention` lint rule (e.g. `config.ts` → `load-fusion-ai-config.ts`, `tools/write-file.ts` → `tools/create-write-file-tool.ts`, `prompts/plan.prompt.ts` → `prompts/create-plan-prompt.ts`). No public API changes.
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+- Updated dependencies [80c3e4a]
+  - @equinor/fusion-framework-module-ai@6.0.2
+  - @equinor/fusion-framework-module@6.1.1
+  - @equinor/fusion-imports@2.0.1
+
 ## 4.0.5
 
 ### Patch Changes

package/dist/esm/configure-fusion-ai.js

@@ -0,0 +1,21 @@
+/**
+ * Configuration factory function for Fusion AI operations.
+ *
+ * This helper function provides type safety and consistency for creating AI configuration
+ * functions. It accepts a function that returns configuration (either synchronously or
+ * asynchronously) and returns it unchanged, providing a typed interface for consumers.
+ *
+ * @param fn - Function that returns Fusion AI configuration (sync or async)
+ * @returns The same configuration function, typed for use with loadFusionAIConfig
+ *
+ * @example
+ * ```ts
+ * // fusion-ai.config.ts
+ * export default configureFusionAI(async () => ({
+ *   apiKey: process.env.OPENAI_API_KEY,
+ *   deployment: 'gpt-4',
+ * }));
+ * ```
+ */
+export const configureFusionAI = (fn) => fn;
+//# sourceMappingURL=configure-fusion-ai.js.map

package/dist/esm/configure-fusion-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-fusion-ai.js","sourceRoot":"","sources":["../../src/configure-fusion-ai.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAA2B,EAAwB,EAAE,EAAE,CAAC,EAAE,CAAC"}

package/dist/esm/fusion-ai-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fusion-ai-config.js.map

package/dist/esm/fusion-ai-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-ai-config.js","sourceRoot":"","sources":["../../src/fusion-ai-config.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -8,7 +8,8 @@
  *
  * @packageDocumentation
  */
-export { configureFusionAI, loadFusionAIConfig, } from './config.js';
+export { configureFusionAI } from './configure-fusion-ai.js';
+export { loadFusionAIConfig } from './load-fusion-ai-config.js';
 export { setupFramework } from './setup-framework.js';
-export { registerAiPlugin } from './register.js';
+export { registerAiPlugin } from './register-ai-plugin.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAA0B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAkC,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,cAAc,EAA0B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/{config.js → load-fusion-ai-config.js}

@@ -1,30 +1,11 @@
 import { importConfig } from '@equinor/fusion-imports';
-/**
- * Configuration factory function for Fusion AI operations.
- *
- * This helper function provides type safety and consistency for creating AI configuration
- * functions. It accepts a function that returns configuration (either synchronously or
- * asynchronously) and returns it unchanged, providing a typed interface for consumers.
- *
- * @param fn - Function that returns Fusion AI configuration (sync or async)
- * @returns The same configuration function, typed for use with loadFusionAIConfig
- *
- * @example
- * ```ts
- * // fusion-ai.config.ts
- * export default configureFusionAI(async () => ({
- *   apiKey: process.env.OPENAI_API_KEY,
- *   deployment: 'gpt-4',
- * }));
- * ```
- */
-export const configureFusionAI = (fn) => fn;
 /**
  * Loads and resolves Fusion AI configuration from a file.
  *
  * The config file should export a function (via `configureFusionAI`) that returns
  * the configuration object. The function can be synchronous or asynchronous.
  *
+ * @template T - Shape of the resolved Fusion AI configuration object.
  * @param configPath - Path to the config file without extension (default: 'fusion-ai.config')
  * @param options - Optional parameters for loading the configuration
  * @returns Promise resolving to the loaded and executed configuration
@@ -48,6 +29,7 @@ export async function loadFusionAIConfig(configPath = 'fusion-ai.config', option
     });
     // Execute the configuration function (handles both sync and async)
     const configFn = result.config;
+    // Config files export a function via configureFusionAI; execute it to resolve the value.
     if (typeof configFn === 'function') {
         return await configFn();
     }
@@ -55,4 +37,4 @@ export async function loadFusionAIConfig(configPath = 'fusion-ai.config', option
     return configFn;
 }
 export default loadFusionAIConfig;
-//# sourceMappingURL=config.js.map
+//# sourceMappingURL=load-fusion-ai-config.js.map

package/dist/esm/load-fusion-ai-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-fusion-ai-config.js","sourceRoot":"","sources":["../../src/load-fusion-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAsBvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAU,GAAW,kBAAkB,EACvC,OAAO,GAA8B,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,yFAAyF;IACzF,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/{schema.js → ai-options-schema.js}

@@ -23,4 +23,4 @@ export const AiOptionsSchema = z
     debug: z.coerce.boolean().default(false),
 })
     .describe('Base Fusion AI command options');
-//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=ai-options-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-options-schema.js","sourceRoot":"","sources":["../../../src/options/ai-options-schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACzC,CAAC;KACD,QAAQ,CAAC,gCAAgC,CAAC,CAAC"}

package/dist/esm/options/index.js

@@ -11,5 +11,5 @@
  */
 export { default as options } from './options.js';
 export { withOptions } from './with-options.js';
-export { AiOptionsSchema } from './schema.js';
+export { AiOptionsSchema } from './ai-options-schema.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"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"}
+{"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,wBAAwB,CAAC"}

package/dist/esm/options/options.js

@@ -1,6 +1,7 @@
 import { createOption } from 'commander';
-// Default Fusion AAD identifiers (same defaults as the CLI's auth options)
+// Default Fusion AAD tenant ID (same default as the CLI's auth options)
 const DEFAULT_TENANT_ID = '3aa4a235-b6e2-48d5-9195-7fcf05b459b0';
+// Default Fusion AAD client ID (same default as the CLI's auth options)
 const DEFAULT_CLIENT_ID = 'a318b8e1-0295-4e17-98d5-35f67dfeba14';
 const DEFAULT_MODEL_CHAT = 'gpt-5.1-chat';
 const DEFAULT_MODEL_EMBED = 'text-embedding-3-large';
@@ -34,6 +35,13 @@ export const indexNameOption = createOption('--index-name <name>', 'Azure AI Sea
 export const debugOption = createOption('-d, --debug', 'Enable debug mode for verbose logging')
     .env('RUNNER_DEBUG')
     .default(false);
+/**
+ * Aggregated Commander option definitions for Fusion AI CLI commands.
+ *
+ * @remarks
+ * Individual options are defined above and re-exported here for convenient
+ * access as a single object.
+ */
 export default {
     envOption,
     tokenOption,

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,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,sCAA+C,CAAC;AAC1E,MAAM,iBAAiB,GAAG,sCAA+C,CAAC;AAC1E,MAAM,kBAAkB,GAAG,cAAuB,CAAC;AACnD,MAAM,mBAAmB,GAAG,wBAAiC,CAAC;AAE9D,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,EAAE,0CAA0C,CAAC;KAC7F,GAAG,CAAC,YAAY,CAAC;KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjB,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CACrC,iBAAiB,EACjB,4DAA4D,CAC7D;KACE,GAAG,CAAC,cAAc,CAAC;KACnB,OAAO,CAAC,SAAS,CAAC,CAAC;AAEtB,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;KACjF,GAAG,CAAC,kBAAkB,CAAC;KACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;KAC7F,GAAG,CAAC,kBAAkB,CAAC;KACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC,qBAAqB,EACrB,yCAAyC,CAC1C;KACE,GAAG,CAAC,sBAAsB,CAAC;KAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE/B,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAC1C,sBAAsB,EACtB,8CAA8C,CAC/C;KACE,GAAG,CAAC,uBAAuB,CAAC;KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC,qBAAqB,EACrB,4BAA4B,CAC7B,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,EAAE,uCAAuC,CAAC;KAC5F,GAAG,CAAC,cAAc,CAAC;KACnB,OAAO,CAAC,KAAK,CAAC,CAAC;AAElB,eAAe;IACb,SAAS;IACT,WAAW;IACX,cAAc;IACd,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,WAAW;CACZ,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/options/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,wEAAwE;AACxE,MAAM,iBAAiB,GAAG,sCAA+C,CAAC;AAE1E,wEAAwE;AACxE,MAAM,iBAAiB,GAAG,sCAA+C,CAAC;AAE1E,MAAM,kBAAkB,GAAG,cAAuB,CAAC;AACnD,MAAM,mBAAmB,GAAG,wBAAiC,CAAC;AAE9D,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,EAAE,0CAA0C,CAAC;KAC7F,GAAG,CAAC,YAAY,CAAC;KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjB,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CACrC,iBAAiB,EACjB,4DAA4D,CAC7D;KACE,GAAG,CAAC,cAAc,CAAC;KACnB,OAAO,CAAC,SAAS,CAAC,CAAC;AAEtB,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;KACjF,GAAG,CAAC,kBAAkB,CAAC;KACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;KAC7F,GAAG,CAAC,kBAAkB,CAAC;KACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE9B,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC,qBAAqB,EACrB,yCAAyC,CAC1C;KACE,GAAG,CAAC,sBAAsB,CAAC;KAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE/B,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAC1C,sBAAsB,EACtB,8CAA8C,CAC/C;KACE,GAAG,CAAC,uBAAuB,CAAC;KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC,qBAAqB,EACrB,4BAA4B,CAC7B,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,EAAE,uCAAuC,CAAC;KAC5F,GAAG,CAAC,cAAc,CAAC;KACnB,OAAO,CAAC,KAAK,CAAC,CAAC;AAElB;;;;;;GAMG;AACH,eAAe;IACb,SAAS;IACT,WAAW;IACX,cAAc;IACd,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,WAAW;CACZ,CAAC"}

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

@@ -23,20 +23,26 @@ export const withOptions = (command, args) => {
     command.addOption(tenantIdOption);
     command.addOption(clientIdOption);
     command.addOption(debugOption);
+    // Optional options are only added when the corresponding feature flag is set.
     if (args?.includeChat)
         command.addOption(chatModelOption);
+    // Embed option is opt-in via includeEmbedding.
     if (args?.includeEmbedding)
         command.addOption(embedModelOption);
+    // Search option is opt-in via includeSearch.
     if (args?.includeSearch)
         command.addOption(indexNameOption);
     command.hook('preAction', (thisCommand) => {
         const opts = thisCommand.opts();
+        // Enforce chat model presence when the chat option was requested.
         if (args?.includeChat && !opts.chatModel?.trim()) {
             throw new InvalidOptionArgumentError('Chat model name is required. Provide --chat-model or set FUSION_AI_CHAT_MODEL.');
         }
+        // Enforce embed model presence when the embedding option was requested.
         if (args?.includeEmbedding && !opts.embedModel?.trim()) {
             throw new InvalidOptionArgumentError('Embedding model name is required. Provide --embed-model or set FUSION_AI_EMBED_MODEL.');
         }
+        // Enforce index name presence when the search option was requested.
         if (args?.includeSearch && !opts.indexName?.trim()) {
             throw new InvalidOptionArgumentError('Index name is required. Provide --index-name or set FUSION_AI_INDEX_NAME.');
         }

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":"AAAA,OAAO,EAAgB,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAAgB,EAChB,IAIE,EACO,EAAE;IACX,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/B,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE/B,IAAI,IAAI,EAAE,WAAW;QAAE,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC1D,IAAI,IAAI,EAAE,gBAAgB;QAAE,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAChE,IAAI,IAAI,EAAE,aAAa;QAAE,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAE5D,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,0BAA0B,CAClC,gFAAgF,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,EAAE,gBAAgB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,0BAA0B,CAClC,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,0BAA0B,CAClC,2EAA2E,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"with-options.js","sourceRoot":"","sources":["../../../src/options/with-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,OAAgB,EAChB,IAIE,EACO,EAAE;IACX,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/B,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAE/B,8EAA8E;IAC9E,IAAI,IAAI,EAAE,WAAW;QAAE,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC1D,+CAA+C;IAC/C,IAAI,IAAI,EAAE,gBAAgB;QAAE,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAChE,6CAA6C;IAC7C,IAAI,IAAI,EAAE,aAAa;QAAE,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAE5D,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAEhC,kEAAkE;QAClE,IAAI,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,0BAA0B,CAClC,gFAAgF,CACjF,CAAC;QACJ,CAAC;QACD,wEAAwE;QACxE,IAAI,IAAI,EAAE,gBAAgB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,0BAA0B,CAClC,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,oEAAoE;QACpE,IAAI,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,0BAA0B,CAClC,2EAA2E,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/esm/{register.js → register-ai-plugin.js}

@@ -21,8 +21,9 @@ import { createCommand } from 'commander';
  * ```
  */
 export function registerAiPlugin(program, command) {
-    // Create 'ai' command group if it doesn't exist
+    // Look up an existing 'ai' command group before creating a new one.
     let aiCommand = program.commands.find((cmd) => cmd.name() === 'ai');
+    // Create 'ai' command group if it doesn't exist
     if (!aiCommand) {
         aiCommand = createCommand('ai').description('Commands for interacting with AI models and Azure OpenAI services');
         program.addCommand(aiCommand);
@@ -30,4 +31,4 @@ export function registerAiPlugin(program, command) {
     aiCommand.addCommand(command);
 }
 export default registerAiPlugin;
-//# sourceMappingURL=register.js.map
+//# sourceMappingURL=register-ai-plugin.js.map

package/dist/esm/register-ai-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-ai-plugin.js","sourceRoot":"","sources":["../../src/register-ai-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,OAAgB;IACjE,oEAAoE;IACpE,IAAI,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC;IACpE,gDAAgD;IAChD,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/setup-framework.js

@@ -21,12 +21,14 @@ export const setupFramework = async (options) => {
         ? { token: options.token }
         : { defaultCredential: true };
     const env = options.env ?? FusionEnv.ContinuesIntegration;
+    // Surface resolved environment and auth mode when debug logging is enabled.
     if (debug) {
         console.debug('[debug] Environment:', env);
         console.debug('[debug] Auth mode:', options.token ? 'static-token' : 'azure-identity');
     }
     /** Initialise the framework, resolve the AI service, and pre-cache tokens. */
     const initAndSetup = async () => {
+        // Trace framework initialization start when debug logging is enabled.
         if (debug)
             console.debug('[debug] Initializing framework with AI module…');
         const framework = await initializeFramework({ env, auth }, (configurator) => {
@@ -36,6 +38,7 @@ export const setupFramework = async (options) => {
         // NoAccountsError if the user has never logged in.
         const service = await framework.serviceDiscovery.resolveService('ai');
         const scopes = service.scopes ?? service.defaultScopes ?? [];
+        // Surface resolved service URL and scopes when debug logging is enabled.
         if (debug) {
             console.debug('[debug] AI service URL:', service.uri);
             console.debug('[debug] AI service scopes:', scopes);
@@ -43,8 +46,10 @@ export const setupFramework = async (options) => {
         // Pre-cache a token for the AI service scopes so strategy callbacks
         // don't attempt (and fail) a silent acquisition later.
         const token = await framework.auth.acquireAccessToken({ request: { scopes } });
+        // Guard: acquireAccessToken can resolve falsy when the token cache is empty.
         if (!token)
             throw new Error('Failed to acquire access token for the AI service.');
+        // Trace successful token acquisition when debug logging is enabled.
         if (debug)
             console.debug('[debug] Token acquired successfully');
         return framework;

package/dist/esm/setup-framework.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-framework.js","sourceRoot":"","sources":["../../src/setup-framework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAOnF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAkB,EAAwC,EAAE;IAC/F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAErC,iBAAiB;IACjB,wEAAwE;IACxE,+DAA+D;IAC/D,MAAM,IAAI,GAAoC,OAAO,CAAC,KAAK;QACzD,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAC1B,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAEhC,MAAM,GAAG,GAAI,OAAO,CAAC,GAAiB,IAAI,SAAS,CAAC,oBAAoB,CAAC;IAEzE,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzF,CAAC;IAED,8EAA8E;IAC9E,MAAM,YAAY,GAAG,KAAK,IAA0C,EAAE;QACpE,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAE3E,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAa,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,EAAE,EAAE;YACtF,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,+DAA+D;QAC/D,mDAAmD;QACnD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAE7D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,oEAAoE;QACpE,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAElF,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAEhE,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,MAAM,YAAY,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"setup-framework.js","sourceRoot":"","sources":["../../src/setup-framework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAOnF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAkB,EAAwC,EAAE;IAC/F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAErC,iBAAiB;IACjB,wEAAwE;IACxE,+DAA+D;IAC/D,MAAM,IAAI,GAAoC,OAAO,CAAC,KAAK;QACzD,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;QAC1B,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAEhC,MAAM,GAAG,GAAI,OAAO,CAAC,GAAiB,IAAI,SAAS,CAAC,oBAAoB,CAAC;IAEzE,4EAA4E;IAC5E,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzF,CAAC;IAED,8EAA8E;IAC9E,MAAM,YAAY,GAAG,KAAK,IAA0C,EAAE;QACpE,sEAAsE;QACtE,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAE3E,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAa,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,EAAE,EAAE;YACtF,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,+DAA+D;QAC/D,mDAAmD;QACnD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAE7D,yEAAyE;QACzE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,oEAAoE;QACpE,uDAAuD;QACvD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/E,6EAA6E;QAC7E,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAElF,oEAAoE;QACpE,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAEhE,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO,MAAM,YAAY,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/esm/version.js

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