@vinkius-core/mcp-fusion 2.8.1 → 2.9.0

package/dist/cli/templates/vectors/openapi.js

@@ -0,0 +1,106 @@
+/** Generate `openapi.yaml` — Sample OpenAPI spec */
+export function openapiYaml(config) {
+    return `# OpenAPI 3.0 Specification — Sample
+#
+# Replace this with your actual API spec, then run:
+#   npx mcp-fusion-openapi-gen ./openapi.yaml --outDir ./src/generated
+#
+# The generator creates Presenters, Tools, Registry, and server
+# bootstrap — all configurable via YAML annotations.
+
+openapi: '3.0.3'
+info:
+  title: '${config.name} API'
+  version: '0.1.0'
+  description: Sample API for MCP Fusion OpenAPI generation
+
+servers:
+  - url: http://localhost:3000/api
+
+paths:
+  /health:
+    get:
+      operationId: getHealth
+      summary: Health check endpoint
+      responses:
+        '200':
+          description: Server health status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    example: healthy
+                  uptime:
+                    type: number
+                    example: 12345.67
+
+  /users:
+    get:
+      operationId: listUsers
+      summary: List all users
+      parameters:
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 10
+      responses:
+        '200':
+          description: List of users
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/User'
+
+components:
+  schemas:
+    User:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        email:
+          type: string
+`;
+}
+/** Generate `SETUP.md` — OpenAPI generation instructions */
+export function openapiSetupMd() {
+    return `# OpenAPI Generator Setup
+
+This project is configured for the **Legacy API Proxy** ingestion vector.
+
+## Steps
+
+1. Replace \`openapi.yaml\` with your actual OpenAPI 3.x spec
+
+2. Generate the MCP server from the spec:
+   \`\`\`bash
+   npx mcp-fusion-openapi-gen ./openapi.yaml --outDir ./src/generated
+   \`\`\`
+
+3. The generator creates:
+   - Presenters with Zod schemas (Egress Firewall)
+   - Tool builders with typed handlers
+   - Registry setup with all endpoints
+
+4. Import and register in \`src/server.ts\`:
+   \`\`\`typescript
+   import { generatedTools } from './generated/registry.js';
+   registry.registerAll(...generatedTools);
+   \`\`\`
+
+## Documentation
+
+See: [OpenAPI Generator](https://mcp-fusion.vinkius.com/openapi-gen)
+`;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/cli/templates/vectors/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/openapi.ts"],"names":[],"mappings":"AAMA,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC7C,OAAO;;;;;;;;;;YAUC,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DtB,CAAC;AACF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,cAAc;IAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BV,CAAC;AACF,CAAC"}

package/dist/cli/templates/vectors/workflow.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workflow Vector — n8n connector template
+ * @module
+ */
+/** Generate `src/n8n.ts` — n8n workflow connector */
+export declare function n8nConnectorTs(): string;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/cli/templates/vectors/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,MAAM,CA0CvC"}

package/dist/cli/templates/vectors/workflow.js

@@ -0,0 +1,49 @@
+/**
+ * Workflow Vector — n8n connector template
+ * @module
+ */
+/** Generate `src/n8n.ts` — n8n workflow connector */
+export function n8nConnectorTs() {
+    return [
+        '/**',
+        ' * n8n Connector — Workflow Automation Bridge',
+        ' *',
+        ' * Auto-discovers webhook workflows from your n8n instance',
+        ' * and registers them as MCP tools. The connector infers',
+        ' * tool semantics from workflow Notes and maintains',
+        ' * live-sync with zero downtime.',
+        ' *',
+        ' * Configure N8N_BASE_URL and N8N_API_KEY in your .env file.',
+        ' */',
+        "import { N8nConnector } from 'mcp-fusion-n8n';",
+        "import type { ToolRegistry } from '@vinkius-core/mcp-fusion';",
+        '',
+        'export async function discoverWorkflows<TContext>(',
+        '    registry: ToolRegistry<TContext>,',
+        '): Promise<number> {',
+        "    const baseUrl = process.env['N8N_BASE_URL'];",
+        "    const apiKey = process.env['N8N_API_KEY'];",
+        '',
+        '    if (!baseUrl || !apiKey) {',
+        "        console.error('\u26A0\uFE0F  N8N_BASE_URL and N8N_API_KEY are required in .env');",
+        '        return 0;',
+        '    }',
+        '',
+        '    const connector = new N8nConnector({',
+        '        baseUrl,',
+        '        apiKey,',
+        '    });',
+        '',
+        '    const tools = await connector.discover();',
+        '',
+        '    for (const tool of tools) {',
+        '        registry.register(tool);',
+        '    }',
+        '',
+        '    console.error(`\uD83D\uDD17 Discovered ${tools.length} n8n workflow(s)`);',
+        '    return tools.length;',
+        '}',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=workflow.js.map

package/dist/cli/templates/vectors/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,MAAM,UAAU,cAAc;IAC1B,OAAO;QACH,KAAK;QACL,+CAA+C;QAC/C,IAAI;QACJ,4DAA4D;QAC5D,0DAA0D;QAC1D,qDAAqD;QACrD,kCAAkC;QAClC,IAAI;QACJ,8DAA8D;QAC9D,KAAK;QACL,gDAAgD;QAChD,+DAA+D;QAC/D,EAAE;QACF,oDAAoD;QACpD,uCAAuC;QACvC,sBAAsB;QACtB,kDAAkD;QAClD,gDAAgD;QAChD,EAAE;QACF,gCAAgC;QAChC,2FAA2F;QAC3F,mBAAmB;QACnB,OAAO;QACP,EAAE;QACF,0CAA0C;QAC1C,kBAAkB;QAClB,iBAAiB;QACjB,SAAS;QACT,EAAE;QACF,+CAA+C;QAC/C,EAAE;QACF,iCAAiC;QACjC,kCAAkC;QAClC,OAAO;QACP,EAAE;QACF,+EAA+E;QAC/E,0BAA0B;QAC1B,GAAG;QACH,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI Types — Shared Configuration Types
+ *
+ * Configuration types collected from the interactive wizard
+ * or CLI flags for the `fusion create` command.
+ *
+ * @module
+ */
+/** Primary ingestion vector for the scaffolded project */
+export type IngestionVector = 'vanilla' | 'prisma' | 'n8n' | 'openapi' | 'oauth';
+/** Transport layer for MCP communication */
+export type TransportLayer = 'stdio' | 'sse';
+/**
+ * Project scaffold configuration.
+ *
+ * Collected from CLI flags or the interactive wizard.
+ * Drives template generation and file selection.
+ */
+export interface ProjectConfig {
+    /** Project name (directory name + package.json name) */
+    readonly name: string;
+    /** Transport layer for MCP communication */
+    readonly transport: TransportLayer;
+    /** Primary ingestion vector */
+    readonly vector: IngestionVector;
+    /** Include @vinkius-core/mcp-fusion-testing + Vitest */
+    readonly testing: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjF,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC7B"}

package/dist/cli/types.js

@@ -0,0 +1,10 @@
+/**
+ * CLI Types — Shared Configuration Types
+ *
+ * Configuration types collected from the interactive wizard
+ * or CLI flags for the `fusion create` command.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vinkius-core/mcp-fusion",
-    "version": "2.8.1",
+    "version": "2.9.0",
     "description": "MVA (Model-View-Agent) framework for the Model Context Protocol. Structured perception packages with Presenters, cognitive guardrails, self-healing errors, action consolidation, and tRPC-style type safety — so AI agents perceive and act on your data deterministically.",
     "type": "module",
     "main": "dist/index.js",