claude-flow 3.0.0-alpha.7 → 3.0.0-alpha.71

package/v3/@claude-flow/cli/dist/src/mcp-tools/auto-install.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Auto-install utility for optional MCP tool dependencies
+ *
+ * When an MCP tool requires an optional package that isn't installed,
+ * this utility attempts to install it automatically on first use.
+ */
+export interface AutoInstallOptions {
+    /**
+     * Timeout in milliseconds for npm install (default: 60000)
+     */
+    timeout?: number;
+    /**
+     * Whether to save to package.json (default: false)
+     */
+    save?: boolean;
+    /**
+     * Silent install (no console output)
+     */
+    silent?: boolean;
+}
+/**
+ * Auto-install a package if not available
+ *
+ * @param packageName - npm package name to install
+ * @param options - Installation options
+ * @returns true if installed successfully or already attempted
+ */
+export declare function autoInstallPackage(packageName: string, options?: AutoInstallOptions): Promise<boolean>;
+/**
+ * Try to import a package, auto-install if not found, and retry
+ *
+ * @param packageName - npm package name
+ * @param options - Installation options
+ * @returns The imported module or null if failed
+ */
+export declare function tryImportOrInstall<T = unknown>(packageName: string, options?: AutoInstallOptions): Promise<T | null>;
+/**
+ * Check if a package is available without installing
+ */
+export declare function isPackageAvailable(packageName: string): Promise<boolean>;
+/**
+ * Reset install attempts (useful for testing)
+ */
+export declare function resetInstallAttempts(): void;
+/**
+ * Optional package dependencies and their purposes
+ */
+export declare const OPTIONAL_PACKAGES: {
+    readonly '@claude-flow/aidefence': {
+        readonly description: "AI manipulation defense (prompt injection, PII detection)";
+        readonly tools: readonly ["aidefence_scan", "aidefence_analyze", "aidefence_stats", "aidefence_learn"];
+    };
+    readonly '@claude-flow/embeddings': {
+        readonly description: "Vector embeddings with ONNX support";
+        readonly tools: readonly ["embeddings_generate", "embeddings_search", "embeddings_batch"];
+    };
+    readonly 'onnxruntime-node': {
+        readonly description: "ONNX runtime for neural network inference";
+        readonly tools: readonly ["neural_*"];
+    };
+};
+declare const _default: {
+    autoInstallPackage: typeof autoInstallPackage;
+    tryImportOrInstall: typeof tryImportOrInstall;
+    isPackageAvailable: typeof isPackageAvailable;
+    resetInstallAttempts: typeof resetInstallAttempts;
+    OPTIONAL_PACKAGES: {
+        readonly '@claude-flow/aidefence': {
+            readonly description: "AI manipulation defense (prompt injection, PII detection)";
+            readonly tools: readonly ["aidefence_scan", "aidefence_analyze", "aidefence_stats", "aidefence_learn"];
+        };
+        readonly '@claude-flow/embeddings': {
+            readonly description: "Vector embeddings with ONNX support";
+            readonly tools: readonly ["embeddings_generate", "embeddings_search", "embeddings_batch"];
+        };
+        readonly 'onnxruntime-node': {
+            readonly description: "ONNX runtime for neural network inference";
+            readonly tools: readonly ["neural_*"];
+        };
+    };
+};
+export default _default;
+//# sourceMappingURL=auto-install.d.ts.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/auto-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-install.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/auto-install.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA8ClB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAClD,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAoBnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;;;;;;;;;;;;;;;;;;;;;AAEX,wBAME"}

package/v3/@claude-flow/cli/dist/src/mcp-tools/auto-install.js

@@ -0,0 +1,131 @@
+/**
+ * Auto-install utility for optional MCP tool dependencies
+ *
+ * When an MCP tool requires an optional package that isn't installed,
+ * this utility attempts to install it automatically on first use.
+ */
+import { spawnSync } from 'child_process';
+// Track which packages we've attempted to install this session
+const installAttempts = new Set();
+/**
+ * Auto-install a package if not available
+ *
+ * @param packageName - npm package name to install
+ * @param options - Installation options
+ * @returns true if installed successfully or already attempted
+ */
+export async function autoInstallPackage(packageName, options = {}) {
+    const { timeout = 60000, save = false, silent = false } = options;
+    // Validate package name to prevent command injection (CVE fix)
+    // Valid npm package names: @scope/name or name, alphanumeric with - . _ ~
+    const validPackageName = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*(@[a-z0-9-._~]+)?$/i;
+    if (!validPackageName.test(packageName)) {
+        if (!silent) {
+            console.error(`[claude-flow] Invalid package name: ${packageName}`);
+        }
+        return false;
+    }
+    // Only attempt once per session
+    if (installAttempts.has(packageName)) {
+        return false;
+    }
+    installAttempts.add(packageName);
+    try {
+        if (!silent) {
+            console.error(`[claude-flow] Auto-installing ${packageName}...`);
+        }
+        // Use spawn with array args to prevent shell injection
+        const args = ['install', packageName, save ? '--save' : '--no-save'];
+        const result = spawnSync('npm', args, {
+            stdio: silent ? 'pipe' : ['pipe', 'pipe', 'pipe'],
+            timeout,
+            shell: false, // Explicitly disable shell
+        });
+        if (result.status !== 0) {
+            throw new Error(result.stderr?.toString() || 'Installation failed');
+        }
+        if (!silent) {
+            console.error(`[claude-flow] Successfully installed ${packageName}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (!silent) {
+            console.error(`[claude-flow] Failed to auto-install ${packageName}: ${error}`);
+        }
+        return false;
+    }
+}
+/**
+ * Try to import a package, auto-install if not found, and retry
+ *
+ * @param packageName - npm package name
+ * @param options - Installation options
+ * @returns The imported module or null if failed
+ */
+export async function tryImportOrInstall(packageName, options = {}) {
+    try {
+        // First try to import
+        return await import(packageName);
+    }
+    catch {
+        // Package not found, try to install
+        const installed = await autoInstallPackage(packageName, options);
+        if (installed) {
+            try {
+                // ESM caches failed imports, so we need to bust the cache
+                // Add a timestamp query parameter to force a fresh import
+                const cacheBuster = `?t=${Date.now()}`;
+                return await import(`${packageName}${cacheBuster}`);
+            }
+            catch {
+                console.error(`[claude-flow] ${packageName} installed but failed to load. Restart MCP server.`);
+                return null;
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Check if a package is available without installing
+ */
+export async function isPackageAvailable(packageName) {
+    try {
+        await import(packageName);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Reset install attempts (useful for testing)
+ */
+export function resetInstallAttempts() {
+    installAttempts.clear();
+}
+/**
+ * Optional package dependencies and their purposes
+ */
+export const OPTIONAL_PACKAGES = {
+    '@claude-flow/aidefence': {
+        description: 'AI manipulation defense (prompt injection, PII detection)',
+        tools: ['aidefence_scan', 'aidefence_analyze', 'aidefence_stats', 'aidefence_learn'],
+    },
+    '@claude-flow/embeddings': {
+        description: 'Vector embeddings with ONNX support',
+        tools: ['embeddings_generate', 'embeddings_search', 'embeddings_batch'],
+    },
+    'onnxruntime-node': {
+        description: 'ONNX runtime for neural network inference',
+        tools: ['neural_*'],
+    },
+};
+export default {
+    autoInstallPackage,
+    tryImportOrInstall,
+    isPackageAvailable,
+    resetInstallAttempts,
+    OPTIONAL_PACKAGES,
+};
+//# sourceMappingURL=auto-install.js.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/auto-install.js.map

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

package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Claims MCP Tools for CLI
+ *
+ * Implements MCP tools for ADR-016: Collaborative Issue Claims
+ * Provides programmatic access to claim operations for MCP clients.
+ *
+ * @module @claude-flow/cli/mcp-tools/claims
+ */
+import type { MCPTool } from './types.js';
+export declare const claimsTools: MCPTool[];
+export default claimsTools;
+//# sourceMappingURL=claims-tools.d.ts.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claims-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/claims-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAqF1C,eAAO,MAAM,WAAW,EAAE,OAAO,EAuwBhC,CAAC;AAEF,eAAe,WAAW,CAAC"}