@equinor/fusion-framework-cli-plugin-ai-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,76 @@
+# @equinor/fusion-framework-cli-plugin-ai-mcp
+
+## 1.0.0
+
+### Major Changes
+
+- [`e2d2a76`](https://github.com/equinor/fusion-framework/commit/e2d2a76d08b86c3a9d8783fed1606551df9d5633) Thanks [@odinr](https://github.com/odinr)! - Add new MCP server plugin package for Model Context Protocol integration.
+
+  This plugin extends the Fusion Framework CLI with MCP server capabilities, enabling AI assistants to search and query Fusion Framework documentation through specialized semantic search tools.
+
+  **Features:**
+
+  - MCP protocol server implementation (stdio transport)
+  - Fusion Framework API reference search (TypeScript/TSDoc)
+  - Cookbook examples and tutorials search
+  - EDS component search (Storybook)
+  - Markdown documentation search
+  - Vector store integration via Azure Cognitive Search
+
+  **Quick Usage:**
+
+  1. Install the plugin:
+
+  ```sh
+  pnpm add -D @equinor/fusion-framework-cli-plugin-ai-mcp
+  ```
+
+  2. Configure in `fusion-cli.config.ts`:
+
+  ```typescript
+  import { defineFusionCli } from "@equinor/fusion-framework-cli";
+
+  export default defineFusionCli(() => ({
+    plugins: ["@equinor/fusion-framework-cli-plugin-ai-mcp"],
+  }));
+  ```
+
+  3. Start the MCP server:
+
+  ```sh
+  # Start MCP server (uses stdio by default)
+  ffc ai mcp
+
+  # With verbose output
+  ffc ai mcp --verbose
+  ```
+
+  4. Configure in your AI assistant (e.g., Claude Desktop):
+
+  ```json
+  {
+    "mcpServers": {
+      "fusion-framework": {
+        "command": "ffc",
+        "args": ["ai", "mcp"],
+        "env": {
+          "AZURE_OPENAI_API_KEY": "your-api-key",
+          "AZURE_OPENAI_INSTANCE_NAME": "your-instance",
+          "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME": "your-embedding-deployment",
+          "AZURE_SEARCH_ENDPOINT": "https://your-search.search.windows.net",
+          "AZURE_SEARCH_API_KEY": "your-search-key",
+          "AZURE_SEARCH_INDEX_NAME": "your-index-name"
+        }
+      }
+    }
+  }
+  ```
+
+  The server exposes four specialized search tools: `fusion_search_markdown`, `fusion_search_api`, `fusion_search_cookbook`, and `fusion_search_eds` for semantic search across different documentation types.
+
+### Patch Changes
+
+- Updated dependencies [[`e2d2a76`](https://github.com/equinor/fusion-framework/commit/e2d2a76d08b86c3a9d8783fed1606551df9d5633), [`e2d2a76`](https://github.com/equinor/fusion-framework/commit/e2d2a76d08b86c3a9d8783fed1606551df9d5633), [`e2d2a76`](https://github.com/equinor/fusion-framework/commit/e2d2a76d08b86c3a9d8783fed1606551df9d5633)]:
+  - @equinor/fusion-framework-cli-plugin-ai-base@1.0.0
+  - @equinor/fusion-framework-cli@13.0.0
+  - @equinor/fusion-framework-module-ai@2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Equinor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @equinor/fusion-framework-cli-plugin-ai-mcp
+
+MCP server plugin for Fusion Framework CLI providing Model Context Protocol server capabilities for AI assistants.
+
+## Installation
+
+```sh
+pnpm add -D @equinor/fusion-framework-cli-plugin-ai-mcp
+```
+
+## Configuration
+
+After installing the plugin, create a `fusion-cli.config.ts` file in your project root:
+
+```typescript
+import { defineFusionCli } from '@equinor/fusion-framework-cli';
+
+export default defineFusionCli(() => ({
+  plugins: [
+    '@equinor/fusion-framework-cli-plugin-ai-mcp',
+  ],
+}));
+```
+
+The CLI will automatically discover and load plugins listed in this configuration file. The config file can be `.ts`, `.js`, or `.json`. The `defineFusionCli` helper provides type safety and IntelliSense support.
+
+## Features
+
+This plugin extends the Fusion Framework CLI with MCP server capabilities:
+
+- **MCP Protocol Server** - Implements the Model Context Protocol for AI assistant integration
+- **Fusion Framework Tools** - Exposes tools for searching and querying the Fusion Framework codebase
+- **Vector Store Integration** - Uses Azure Cognitive Search for semantic code search
+- **Framework Information** - Provides tools to query framework configuration and capabilities
+
+## Usage
+
+Once installed, the MCP server command is automatically available:
+
+```sh
+# Start the MCP server (uses stdio by default)
+ffc ai mcp
+```
+
+## Commands
+
+### `ai mcp`
+
+Starts a Model Context Protocol (MCP) server that provides tools and resources for AI assistants to interact with the Fusion Framework.
+
+**Features:**
+- Implements MCP protocol over stdio (standard for MCP servers)
+- Exposes tools for semantic search of Fusion Framework codebase
+- Provides framework information and configuration details
+- Integrates with Azure Cognitive Search for vector-based code search
+
+**Options:**
+- `--openai-api-key <key>` - API key for Azure OpenAI (required)
+- `--openai-api-version <version>` - API version (default: 2024-02-15-preview)
+- `--openai-instance <name>` - Azure OpenAI instance name (required)
+- `--openai-embedding-deployment <name>` - Azure OpenAI embedding deployment name (required for search)
+- `--azure-search-endpoint <url>` - Azure Search endpoint URL (required for search)
+- `--azure-search-api-key <key>` - Azure Search API key (required for search)
+- `--azure-search-index-name <name>` - Azure Search index name (required for search)
+- `--verbose` - Enable verbose output
+
+**Examples:**
+```sh
+$ ffc ai mcp
+$ ffc ai mcp --verbose
+$ ffc ai mcp --azure-search-endpoint https://my-search.search.windows.net
+```
+
+## MCP Tools
+
+The server exposes the following tools:
+
+### `fusion_search`
+
+Search the Fusion Framework codebase and documentation using semantic search.
+
+**Parameters:**
+- `query` (string, required) - The search query to find relevant code or documentation
+- `limit` (number, optional) - Maximum number of results to return (default: 5)
+
+**Returns:**
+- JSON object with search results including content and metadata
+
+### `fusion_info`
+
+Get information about the Fusion Framework instance and available modules.
+
+**Parameters:**
+- None
+
+**Returns:**
+- JSON object with framework version, module status, and service configuration
+
+## Integration with AI Assistants
+
+To use this MCP server with an AI assistant (like Claude Desktop, Cursor, etc.), configure the MCP server in your AI client's configuration file.
+
+**Example configuration for Claude Desktop:**
+
+```json
+{
+  "mcpServers": {
+    "fusion-framework": {
+      "command": "ffc",
+      "args": ["ai", "mcp"],
+      "env": {
+        "AZURE_OPENAI_API_KEY": "your-api-key",
+        "AZURE_OPENAI_INSTANCE_NAME": "your-instance",
+        "AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME": "your-embedding-deployment",
+        "AZURE_SEARCH_ENDPOINT": "https://your-search.search.windows.net",
+        "AZURE_SEARCH_API_KEY": "your-search-key",
+        "AZURE_SEARCH_INDEX_NAME": "your-index-name"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+The plugin requires Azure OpenAI and Azure Cognitive Search configuration for full functionality. See the main CLI documentation for details on setting up API keys and endpoints.
+
+## License
+
+ISC
+

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+import { registerAiPlugin as registerAiPluginBase } from '@equinor/fusion-framework-cli-plugin-ai-base';
+import { command as mcpCommand } from './mcp.js';
+/**
+ * Registers the AI MCP server plugin command with the CLI program
+ * @param program - The Commander program instance to register commands with
+ */
+export function registerAiPlugin(program) {
+    registerAiPluginBase(program, mcpCommand);
+}
+export default registerAiPlugin;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACxG,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,UAAU,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,oBAAoB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/esm/mcp.js

@@ -0,0 +1,66 @@
+import { createCommand, createOption } from 'commander';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { setupFramework } from '@equinor/fusion-framework-cli-plugin-ai-base';
+import { withOptions as withAiOptions, } from '@equinor/fusion-framework-cli-plugin-ai-base/command-options';
+import { handleTool as handleSearchTool, toolConfig as searchToolConfig, } from './tools/fusion-search.tool.js';
+const _command = createCommand('mcp')
+    .description('Start a Model Context Protocol (MCP) server for Fusion Framework')
+    .addOption(createOption('--verbose', 'Enable verbose output').default(false))
+    .action(async (options) => {
+    if (options.verbose) {
+        console.error('🚀 Starting MCP server for Fusion Framework...');
+    }
+    // Initialize the framework
+    const framework = await setupFramework(options);
+    if (options.verbose) {
+        console.error('✅ Framework initialized successfully');
+    }
+    // Create MCP server instance
+    const server = new McpServer({
+        name: 'fusion-framework-mcp',
+        version: '1.0.0',
+        title: 'Fusion Framework MCP Server',
+    });
+    // Register search tool (will return error if not configured)
+    server.registerTool('fusion_search', searchToolConfig, handleSearchTool(framework, options));
+    if (options.verbose) {
+        if (options.azureSearchIndexName && framework.ai) {
+            console.error('✅ Registered tool: fusion_search');
+        }
+        else {
+            console.error('⚠️  Registered tool: fusion_search (configuration missing - will return error when called)');
+        }
+    }
+    // Start the server using stdio transport (standard for MCP)
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    if (options.verbose) {
+        console.error('✅ MCP server started and ready');
+        console.error('📡 Listening on stdio for MCP protocol messages');
+    }
+    // Keep the process alive
+    process.on('SIGINT', async () => {
+        if (options.verbose) {
+            console.error('\n🛑 Shutting down MCP server...');
+        }
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        if (options.verbose) {
+            console.error('\n🛑 Shutting down MCP server...');
+        }
+        await server.close();
+        process.exit(0);
+    });
+});
+// Export the command with AI options
+// Note: Search tools require embedding deployment, so we include it
+export const command = withAiOptions(_command, {
+    includeChat: false,
+    includeEmbedding: true,
+    includeSearch: true,
+});
+export default command;
+//# sourceMappingURL=mcp.js.map

package/dist/esm/mcp.js.map

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

package/dist/esm/tools/fusion-search-api.js

@@ -0,0 +1,65 @@
+/**
+ * Tool definition for searching Fusion Framework API reference.
+ * This tool enables semantic search across TypeScript/TSDoc code documentation, function signatures, and class definitions.
+ */
+export const toolDefinition = {
+    name: 'fusion_search_api',
+    description: 'Search the Fusion Framework API reference using semantic search. Use this for finding TypeScript/TSDoc code documentation, function signatures, class definitions, and API details.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to find relevant API reference documentation',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 5)',
+                default: 5,
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Tool handler for fusion_search_api
+ */
+export async function handleTool(args, framework, options) {
+    if (!options.azureSearchIndexName || !framework.ai) {
+        throw new Error('Vector store is not configured. Azure Search is required for search functionality.');
+    }
+    const query = args?.query;
+    const limit = args?.limit || 5;
+    if (!query || typeof query !== 'string') {
+        throw new Error('Query parameter is required and must be a string');
+    }
+    if (options.verbose) {
+        console.error(`🔍 Searching API reference for: ${query}`);
+    }
+    const vectorStoreService = framework.ai.getService('search', options.azureSearchIndexName);
+    const retriever = vectorStoreService.asRetriever({
+        k: limit,
+        searchType: 'similarity',
+        filter: {
+            filterExpression: "metadata/attributes/any(x: x/key eq 'type' and x/value eq 'tsdoc')",
+        },
+    });
+    const docs = await retriever.invoke(query);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    query,
+                    type: 'api',
+                    results: docs.map((doc) => ({
+                        content: doc.pageContent,
+                        metadata: doc.metadata,
+                    })),
+                    count: docs.length,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=fusion-search-api.js.map

package/dist/esm/tools/fusion-search-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-search-api.js","sourceRoot":"","sources":["../../../src/tools/fusion-search-api.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,qLAAqL;IACvL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAA6B,EAC7B,SAA4B,EAC5B,OAA0C;IAK1C,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;IACpC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,mCAAmC,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC;QAC/C,CAAC,EAAE,KAAK;QACR,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,oEAAoE;SACvF;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,KAAK;oBACL,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,CAAC,GAA+D,EAAE,EAAE,CAAC,CAAC;wBACpE,OAAO,EAAE,GAAG,CAAC,WAAW;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB,CAAC,CACH;oBACD,KAAK,EAAE,IAAI,CAAC,MAAM;iBACnB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/tools/fusion-search-cookbook.js

@@ -0,0 +1,65 @@
+/**
+ * Tool definition for searching Fusion Framework cookbooks.
+ * This tool enables semantic search across example implementations, tutorials, and how-to guides.
+ */
+export const toolDefinition = {
+    name: 'fusion_search_cookbook',
+    description: 'Search the Fusion Framework cookbooks using semantic search. Use this for finding example implementations, tutorials, guides, and how-to content.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to find relevant cookbook examples and tutorials',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 5)',
+                default: 5,
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Tool handler for fusion_search_cookbook
+ */
+export async function handleTool(args, framework, options) {
+    if (!options.azureSearchIndexName || !framework.ai) {
+        throw new Error('Vector store is not configured. Azure Search is required for search functionality.');
+    }
+    const query = args?.query;
+    const limit = args?.limit || 5;
+    if (!query || typeof query !== 'string') {
+        throw new Error('Query parameter is required and must be a string');
+    }
+    if (options.verbose) {
+        console.error(`🔍 Searching cookbooks for: ${query}`);
+    }
+    const vectorStoreService = framework.ai.getService('search', options.azureSearchIndexName);
+    const retriever = vectorStoreService.asRetriever({
+        k: limit,
+        searchType: 'similarity',
+        filter: {
+            filterExpression: "metadata/attributes/any(x: x/key eq 'type' and x/value eq 'cookbook')",
+        },
+    });
+    const docs = await retriever.invoke(query);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    query,
+                    type: 'cookbook',
+                    results: docs.map((doc) => ({
+                        content: doc.pageContent,
+                        metadata: doc.metadata,
+                    })),
+                    count: docs.length,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=fusion-search-cookbook.js.map

package/dist/esm/tools/fusion-search-cookbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-search-cookbook.js","sourceRoot":"","sources":["../../../src/tools/fusion-search-cookbook.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,mJAAmJ;IACrJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mEAAmE;aACjF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAA6B,EAC7B,SAA4B,EAC5B,OAA0C;IAK1C,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;IACpC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC;QAC/C,CAAC,EAAE,KAAK;QACR,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,uEAAuE;SAC1F;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,KAAK;oBACL,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,CAAC,GAA+D,EAAE,EAAE,CAAC,CAAC;wBACpE,OAAO,EAAE,GAAG,CAAC,WAAW;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB,CAAC,CACH;oBACD,KAAK,EAAE,IAAI,CAAC,MAAM;iBACnB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/tools/fusion-search-eds.js

@@ -0,0 +1,65 @@
+/**
+ * Tool definition for searching EDS (Equinor Design System) components from Storybook.
+ * This tool enables semantic search across component examples, props, usage patterns, and Storybook stories.
+ */
+export const toolDefinition = {
+    name: 'fusion_search_eds',
+    description: 'Search EDS (Equinor Design System) components from Storybook using semantic search. Use this for finding component examples, props, usage patterns, and Storybook stories.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to find relevant EDS component examples and Storybook stories',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 5)',
+                default: 5,
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Tool handler for fusion_search_eds
+ */
+export async function handleTool(args, framework, options) {
+    if (!options.azureSearchIndexName || !framework.ai) {
+        throw new Error('Vector store is not configured. Azure Search is required for search functionality.');
+    }
+    const query = args?.query;
+    const limit = args?.limit || 5;
+    if (!query || typeof query !== 'string') {
+        throw new Error('Query parameter is required and must be a string');
+    }
+    if (options.verbose) {
+        console.error(`🔍 Searching EDS components/Storybook for: ${query}`);
+    }
+    const vectorStoreService = framework.ai.getService('search', options.azureSearchIndexName);
+    const retriever = vectorStoreService.asRetriever({
+        k: limit,
+        searchType: 'similarity',
+        filter: {
+            filterExpression: "metadata/attributes/any(x: x/key eq 'type' and x/value eq 'storybook')",
+        },
+    });
+    const docs = await retriever.invoke(query);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    query,
+                    type: 'eds-component',
+                    results: docs.map((doc) => ({
+                        content: doc.pageContent,
+                        metadata: doc.metadata,
+                    })),
+                    count: docs.length,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=fusion-search-eds.js.map

package/dist/esm/tools/fusion-search-eds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-search-eds.js","sourceRoot":"","sources":["../../../src/tools/fusion-search-eds.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4KAA4K;IAC9K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gFAAgF;aACnF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAA6B,EAC7B,SAA4B,EAC5B,OAA0C;IAK1C,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;IACpC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,8CAA8C,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC;QAC/C,CAAC,EAAE,KAAK;QACR,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,wEAAwE;SAC3F;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,KAAK;oBACL,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,CAAC,GAA+D,EAAE,EAAE,CAAC,CAAC;wBACpE,OAAO,EAAE,GAAG,CAAC,WAAW;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB,CAAC,CACH;oBACD,KAAK,EAAE,IAAI,CAAC,MAAM;iBACnB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/tools/fusion-search-markdown.js

@@ -0,0 +1,65 @@
+/**
+ * Tool definition for searching Fusion Framework markdown documentation.
+ * This tool enables semantic search across markdown files, guides, and documentation.
+ */
+export const toolDefinition = {
+    name: 'fusion_search_markdown',
+    description: 'Search the Fusion Framework markdown documentation using semantic search. Use this for finding documentation, guides, and explanatory content.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query to find relevant markdown documentation',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results to return (default: 5)',
+                default: 5,
+            },
+        },
+        required: ['query'],
+    },
+};
+/**
+ * Tool handler for fusion_search_markdown
+ */
+export async function handleTool(args, framework, options) {
+    if (!options.azureSearchIndexName || !framework.ai) {
+        throw new Error('Vector store is not configured. Azure Search is required for search functionality.');
+    }
+    const query = args?.query;
+    const limit = args?.limit || 5;
+    if (!query || typeof query !== 'string') {
+        throw new Error('Query parameter is required and must be a string');
+    }
+    if (options.verbose) {
+        console.error(`🔍 Searching markdown documentation for: ${query}`);
+    }
+    const vectorStoreService = framework.ai.getService('search', options.azureSearchIndexName);
+    const retriever = vectorStoreService.asRetriever({
+        k: limit,
+        searchType: 'similarity',
+        filter: {
+            filterExpression: "metadata/attributes/any(x: x/key eq 'type' and x/value eq 'markdown')",
+        },
+    });
+    const docs = await retriever.invoke(query);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    query,
+                    type: 'markdown',
+                    results: docs.map((doc) => ({
+                        content: doc.pageContent,
+                        metadata: doc.metadata,
+                    })),
+                    count: docs.length,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=fusion-search-markdown.js.map

package/dist/esm/tools/fusion-search-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion-search-markdown.js","sourceRoot":"","sources":["../../../src/tools/fusion-search-markdown.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,gJAAgJ;IAClJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,CAAC;aACX;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAA6B,EAC7B,SAA4B,EAC5B,OAA0C;IAK1C,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;IACpC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;IAE3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,4CAA4C,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,kBAAkB,GAAG,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC;QAC/C,CAAC,EAAE,KAAK;QACR,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE;YACN,gBAAgB,EAAE,uEAAuE;SAC1F;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,KAAK;oBACL,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,IAAI,CAAC,GAAG,CACf,CAAC,GAA+D,EAAE,EAAE,CAAC,CAAC;wBACpE,OAAO,EAAE,GAAG,CAAC,WAAW;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;qBACvB,CAAC,CACH;oBACD,KAAK,EAAE,IAAI,CAAC,MAAM;iBACnB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}