π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
Checkpoint: File edits
rUvae8d249881f2
diff --git a/v3/@claude-flow/cli/src/mcp-tools/transfer-tools.ts b/v3/@claude-flow/cli/src/mcp-tools/transfer-tools.tsindex b25d45f17d..b436217bd9 100644--- a/v3/@claude-flow/cli/src/mcp-tools/transfer-tools.ts+++ b/v3/@claude-flow/cli/src/mcp-tools/transfer-tools.ts@@ -8,6 +8,21 @@import type { MCPTool, MCPToolResult } from './types.js';+/**+ * Helper to create MCP tool result+ */+function createResult(data: unknown, isError = false): MCPToolResult {+ return {+ content: [+ {+ type: 'text',+ text: typeof data === 'string' ? data : JSON.stringify(data, null, 2),+ },+ ],+ isError,+ };+}+/*** Transfer MCP tools for pattern export, import, anonymization, and sharing*/@@ -17,7 +32,7 @@ export const transferTools: MCPTool[] = [// βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ{name: 'transfer/export',- description: 'Export learning patterns to file or IPFS with anonymization',+ description: 'Export learning patterns to file with anonymization',category: 'transfer',version: '1.0.0',inputSchema: {@@ -25,115 +40,33 @@ export const transferTools: MCPTool[] = [properties: {output: {type: 'string',- description: 'Output file path (optional if toIpfs is true)',+ description: 'Output file path',},format: {type: 'string',- enum: ['cbor', 'json', 'msgpack', 'cbor.gz', 'cbor.zstd'],- default: 'cbor',+ enum: ['cbor', 'json'],description: 'Serialization format',},anonymize: {type: 'string',enum: ['minimal', 'standard', 'strict', 'paranoid'],- default: 'standard',description: 'Anonymization level',},- redactPii: {- type: 'boolean',- default: true,- description: 'Redact personally identifiable information',- },- stripPaths: {- type: 'boolean',- default: false,- description: 'Strip absolute file paths',- },types: {type: 'array',items: { type: 'string' },- description: 'Pattern types to export (routing, complexity, coverage, trajectory)',- },- minConfidence: {- type: 'number',- minimum: 0,- maximum: 1,- default: 0.5,- description: 'Minimum confidence threshold for patterns',- },- toIpfs: {- type: 'boolean',- default: false,- description: 'Upload to IPFS instead of file',- },- pin: {- type: 'boolean',- default: true,- description: 'Pin to IPFS pinning service (requires toIpfs)',- },- },- },- handler: async (input): Promise<MCPToolResult> => {- const { exportPatterns } = await import('../transfer/export.js');- return exportPatterns(input as Parameters<typeof exportPatterns>[0]);- },- },-- // βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ- // IMPORT TOOLS- // βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ- {- name: 'transfer/import',- description: 'Import learning patterns from file or IPFS',- category: 'transfer',- version: '1.0.0',- inputSchema: {- type: 'object',- properties: {- input: {- type: 'string',- description: 'Input file path (optional if fromIpfs is set)',- },- fromIpfs: {- type: 'string',- description: 'IPFS CID to import from',- },- fromStore: {- type: 'string',- description: 'Pattern store name to import from',- },- version: {- type: 'string',- default: 'latest',- description: 'Version to import (for store imports)',- },- strategy: {- type: 'string',- enum: ['replace', 'merge', 'append'],- default: 'merge',- description: 'Import strategy for existing patterns',- },- conflictResolution: {- type: 'string',- enum: ['highest-confidence', 'newest', 'oldest', 'keep-local', 'keep-remote'],- default: 'highest-confidence',- description: 'How to resolve pattern conflicts',- },- verifySignature: {- type: 'boolean',- default: false,- description: 'Require valid signature for import',- },- dryRun: {- type: 'boolean',- default: false,- description: 'Preview import without applying changes',+ description: 'Pattern types to export',},},},handler: async (input): Promise<MCPToolResult> => {- const { importPatterns } = await import('../transfer/import.js');- return importPatterns(input as Parameters<typeof importPatterns>[0]);+ try {+ const { exportPatterns } = await import('../transfer/export.js');+ const result = await exportPatterns(input as Parameters<typeof exportPatterns>[0]);+ return createResult(result);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -148,64 +81,31 @@ export const transferTools: MCPTool[] = [inputSchema: {type: 'object',properties: {- input: {- type: 'string',- description: 'Input file path',- },- output: {- type: 'string',- description: 'Output file path',- },level: {type: 'string',enum: ['minimal', 'standard', 'strict', 'paranoid'],- default: 'standard',description: 'Anonymization level',},preserveStructure: {type: 'boolean',- default: true,description: 'Preserve directory structure in paths',},},- required: ['input', 'output'],},handler: async (input): Promise<MCPToolResult> => {- const { anonymizePatterns } = await import('../transfer/anonymization/index.js');- return anonymizePatterns(input as Parameters<typeof anonymizePatterns>[0]);- },- },-- {- name: 'transfer/detect-pii',- description: 'Scan patterns for PII without redacting',- category: 'transfer',- version: '1.0.0',- inputSchema: {- type: 'object',- properties: {- input: {- type: 'string',- description: 'Input file or directory to scan',- },- detectors: {- type: 'array',- items: { type: 'string' },- default: ['email', 'phone', 'ip', 'path', 'apiKey'],- description: 'PII detectors to run',- },- outputFormat: {- type: 'string',- enum: ['summary', 'detailed', 'json'],- default: 'summary',- description: 'Output format',- },- },- required: ['input'],- },- handler: async (input): Promise<MCPToolResult> => {- const { detectPii } = await import('../transfer/anonymization/detectors.js');- return detectPii(input as Parameters<typeof detectPii>[0]);+ try {+ const { createAnonymizer } = await import('../transfer/anonymization/index.js');+ const level = (input as { level?: string }).level || 'standard';+ const anonymizer = createAnonymizer(level as 'minimal' | 'standard' | 'strict' | 'paranoid');+ return createResult({+ success: true,+ level,+ message: `Anonymizer created with ${level} level`,+ detectors: anonymizer.getDetectors?.() || ['email', 'phone', 'ip', 'path', 'apiKey'],+ });+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -222,22 +122,14 @@ export const transferTools: MCPTool[] = [properties: {input: {type: 'string',- description: 'Input file path',+ description: 'Input file path or content',},pin: {type: 'boolean',- default: true,description: 'Pin to pinning service',},- pinningService: {- type: 'string',- enum: ['pinata', 'web3storage', 'infura', 'custom'],- default: 'pinata',- description: 'Pinning service to use',- },gateway: {type: 'string',- default: 'https://w3s.link',description: 'IPFS gateway URL',},name: {@@ -245,51 +137,15 @@ export const transferTools: MCPTool[] = [description: 'Human-readable name for the upload',},},- required: ['input'],},handler: async (input): Promise<MCPToolResult> => {- const { uploadToIpfs } = await import('../transfer/ipfs/upload.js');- return uploadToIpfs(input as Parameters<typeof uploadToIpfs>[0]);- },- },-- {- name: 'transfer/ipfs-download',- description: 'Download patterns from IPFS',- category: 'transfer',- version: '1.0.0',- inputSchema: {- type: 'object',- properties: {- cid: {- type: 'string',- description: 'IPFS Content ID (CID)',- },- output: {- type: 'string',- description: 'Output file path',- },- gateway: {- type: 'string',- default: 'https://w3s.link',- description: 'IPFS gateway URL',- },- timeout: {- type: 'number',- default: 30000,- description: 'Download timeout in milliseconds',- },- verify: {- type: 'boolean',- default: true,- description: 'Verify content integrity',- },- },- required: ['cid', 'output'],- },- handler: async (input): Promise<MCPToolResult> => {- const { downloadFromIpfs } = await import('../transfer/ipfs/download.js');- return downloadFromIpfs(input as Parameters<typeof downloadFromIpfs>[0]);+ try {+ const { uploadToIPFS } = await import('../transfer/ipfs/upload.js');+ const result = await uploadToIPFS(input as Parameters<typeof uploadToIPFS>[0]);+ return createResult(result);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -305,18 +161,17 @@ export const transferTools: MCPTool[] = [type: 'string',description: 'IPNS name to resolve',},- recursive: {- type: 'boolean',- default: true,- description: 'Resolve recursively',- },},required: ['name'],},handler: async (input): Promise<MCPToolResult> => {- const { resolveIPNS } = await import('../transfer/ipfs/client.js');- const result = await resolveIPNS((input as { name: string }).name);- return { success: true, cid: result };+ try {+ const { resolveIPNS } = await import('../transfer/ipfs/client.js');+ const result = await resolveIPNS((input as { name: string }).name);+ return createResult({ success: true, cid: result });+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -339,35 +194,30 @@ export const transferTools: MCPTool[] = [type: 'string',description: 'Filter by category',},- language: {- type: 'string',- description: 'Filter by programming language',- },minRating: {type: 'number',- minimum: 0,- maximum: 5,description: 'Minimum rating',},- minDownloads: {- type: 'number',- minimum: 0,- description: 'Minimum download count',- },verified: {type: 'boolean',description: 'Only show verified patterns',},limit: {type: 'number',- default: 20,description: 'Maximum results',},},},handler: async (input): Promise<MCPToolResult> => {- const { searchPatterns } = await import('../transfer/store/search.js');- return searchPatterns(input as Parameters<typeof searchPatterns>[0]);+ try {+ const { createPatternStore } = await import('../transfer/store/index.js');+ const store = createPatternStore();+ await store.initialize();+ const results = store.search(input as Parameters<typeof store.search>[0]);+ return createResult(results);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -383,22 +233,28 @@ export const transferTools: MCPTool[] = [type: 'string',description: 'Pattern name',},- version: {- type: 'string',- description: 'Specific version (default: latest)',- },},required: ['name'],},handler: async (input): Promise<MCPToolResult> => {- const { getPatternInfo } = await import('../transfer/store/registry.js');- return getPatternInfo(input as Parameters<typeof getPatternInfo>[0]);+ try {+ const { createPatternStore } = await import('../transfer/store/index.js');+ const store = createPatternStore();+ await store.initialize();+ const pattern = store.getPattern((input as { name: string }).name);+ if (!pattern) {+ return createResult({ error: 'Pattern not found' }, true);+ }+ return createResult(pattern);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},{- name: 'transfer/store-install',- description: 'Install a pattern from the store',+ name: 'transfer/store-download',+ description: 'Download a pattern from the store',category: 'transfer',version: '1.0.0',inputSchema: {@@ -408,23 +264,30 @@ export const transferTools: MCPTool[] = [type: 'string',description: 'Pattern name',},- version: {+ output: {type: 'string',- default: 'latest',- description: 'Version to install',+ description: 'Output file path',},- strategy: {- type: 'string',- enum: ['replace', 'merge', 'append'],- default: 'merge',- description: 'Import strategy',+ verify: {+ type: 'boolean',+ description: 'Verify pattern integrity',},},required: ['name'],},handler: async (input): Promise<MCPToolResult> => {- const { installPattern } = await import('../transfer/store/install.js');- return installPattern(input as Parameters<typeof installPattern>[0]);+ try {+ const { createPatternStore } = await import('../transfer/store/index.js');+ const store = createPatternStore();+ await store.initialize();+ const result = await store.download(+ (input as { name: string }).name,+ input as Parameters<typeof store.download>[1]+ );+ return createResult(result);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -436,10 +299,6 @@ export const transferTools: MCPTool[] = [inputSchema: {type: 'object',properties: {- input: {- type: 'string',- description: 'Input pattern file',- },name: {type: 'string',description: 'Pattern name',@@ -448,7 +307,7 @@ export const transferTools: MCPTool[] = [type: 'string',description: 'Pattern description',},- category: {+ categories: {type: 'array',items: { type: 'string' },description: 'Categories',@@ -460,21 +319,60 @@ export const transferTools: MCPTool[] = [},license: {type: 'string',- default: 'MIT',description: 'SPDX license identifier',},anonymize: {type: 'string',enum: ['minimal', 'standard', 'strict', 'paranoid'],- default: 'strict',description: 'Anonymization level before publishing',},},- required: ['input', 'name', 'description'],+ required: ['name', 'description'],},handler: async (input): Promise<MCPToolResult> => {- const { publishPattern } = await import('../transfer/store/publish.js');- return publishPattern(input as Parameters<typeof publishPattern>[0]);+ try {+ const { createPatternStore } = await import('../transfer/store/index.js');+ const store = createPatternStore();+ await store.initialize();+ // Create a minimal CFP for demo+ const cfp = {+ magic: 'CFP1' as const,+ version: '1.0.0',+ createdAt: new Date().toISOString(),+ generatedBy: 'claude-flow-v3',+ metadata: {+ id: `pattern-${Date.now()}`,+ name: (input as { name: string }).name,+ description: (input as { description: string }).description,+ tags: (input as { tags?: string[] }).tags || [],+ },+ anonymization: {+ level: (input as { anonymize?: string }).anonymize || 'standard',+ appliedTransforms: [],+ piiRedacted: true,+ pathsStripped: true,+ timestampsGeneralized: true,+ checksum: '',+ },+ patterns: {+ routing: [],+ complexity: [],+ coverage: [],+ trajectory: [],+ custom: [],+ },+ statistics: {+ totalPatterns: 0,+ avgConfidence: 0,+ patternTypes: {},+ timeRange: { start: '', end: '' },+ },+ };+ const result = await store.publish(cfp, input as Parameters<typeof store.publish>[1]);+ return createResult(result);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},@@ -499,7 +397,6 @@ export const transferTools: MCPTool[] = [},type: {type: 'string',- enum: ['agent', 'hook', 'command', 'provider', 'integration', 'theme', 'core', 'hybrid'],description: 'Filter by plugin type',},verified: {@@ -508,26 +405,29 @@ export const transferTools: MCPTool[] = [},minRating: {type: 'number',- minimum: 0,- maximum: 5,description: 'Minimum rating',},limit: {type: 'number',- default: 20,description: 'Maximum results',},},},handler: async (input): Promise<MCPToolResult> => {- const { createPluginDiscoveryService, searchPlugins } = await import('../plugins/store/index.js');- const discovery = createPluginDiscoveryService();- const result = await discovery.discoverRegistry();- if (!result.success || !result.registry) {- return { success: false, error: result.error || 'Failed to discover registry' };+ try {+ const { createPluginDiscoveryService, searchPlugins } = await import(+ '../plugins/store/index.js'+ );+ const discovery = createPluginDiscoveryService();+ const result = await discovery.discoverRegistry();+ if (!result.success || !result.registry) {+ return createResult({ error: result.error || 'Failed to discover registry' }, true);+ }+ const searchResult = searchPlugins(result.registry, input as Parameters<typeof searchPlugins>[1]);+ return createResult(searchResult);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);}- const searchResult = searchPlugins(result.registry, input as Parameters<typeof searchPlugins>[1]);- return { success: true, ...searchResult };},},@@ -547,87 +447,84 @@ export const transferTools: MCPTool[] = [required: ['name'],},handler: async (input): Promise<MCPToolResult> => {- const { createPluginDiscoveryService } = await import('../plugins/store/index.js');- const discovery = createPluginDiscoveryService();- const result = await discovery.discoverRegistry();- if (!result.success || !result.registry) {- return { success: false, error: result.error || 'Failed to discover registry' };- }- const plugin = result.registry.plugins.find(- (p) => p.id === (input as { name: string }).name || p.name === (input as { name: string }).name- );- if (!plugin) {- return { success: false, error: 'Plugin not found' };+ try {+ const { createPluginDiscoveryService } = await import('../plugins/store/index.js');+ const discovery = createPluginDiscoveryService();+ const result = await discovery.discoverRegistry();+ if (!result.success || !result.registry) {+ return createResult({ error: result.error || 'Failed to discover registry' }, true);+ }+ const plugin = result.registry.plugins.find(+ (p) =>+ p.id === (input as { name: string }).name || p.name === (input as { name: string }).name+ );+ if (!plugin) {+ return createResult({ error: 'Plugin not found' }, true);+ }+ return createResult(plugin);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);}- return { success: true, plugin };},},- // βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ- // VERIFICATION TOOLS- // βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ{- name: 'transfer/verify',- description: 'Verify pattern signature and integrity',+ name: 'transfer/plugin-featured',+ description: 'Get featured plugins from the store',category: 'transfer',version: '1.0.0',inputSchema: {type: 'object',properties: {- input: {- type: 'string',- description: 'Pattern file to verify',- },- checkSignature: {- type: 'boolean',- default: true,- description: 'Verify cryptographic signature',- },- checkIntegrity: {- type: 'boolean',- default: true,- description: 'Verify checksum integrity',- },- scanMalware: {- type: 'boolean',- default: true,- description: 'Scan for malicious patterns',+ limit: {+ type: 'number',+ description: 'Maximum results',},},- required: ['input'],},handler: async (input): Promise<MCPToolResult> => {- const { verifyPattern } = await import('../transfer/security/verification.js');- return verifyPattern(input as Parameters<typeof verifyPattern>[0]);+ try {+ const { createPluginDiscoveryService, getFeaturedPlugins } = await import(+ '../plugins/store/index.js'+ );+ const discovery = createPluginDiscoveryService();+ const result = await discovery.discoverRegistry();+ if (!result.success || !result.registry) {+ return createResult({ error: result.error || 'Failed to discover registry' }, true);+ }+ const featured = getFeaturedPlugins(result.registry);+ const limit = (input as { limit?: number }).limit || 10;+ return createResult(featured.slice(0, limit));+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},{- name: 'transfer/sign',- description: 'Sign patterns with Ed25519 key',+ name: 'transfer/plugin-official',+ description: 'Get official plugins from the store',category: 'transfer',version: '1.0.0',inputSchema: {type: 'object',- properties: {- input: {- type: 'string',- description: 'Pattern file to sign',- },- output: {- type: 'string',- description: 'Output file (default: overwrites input)',- },- privateKey: {- type: 'string',- description: 'Path to Ed25519 private key file',- },- },- required: ['input'],+ properties: {},},- handler: async (input): Promise<MCPToolResult> => {- const { signPattern } = await import('../transfer/security/verification.js');- return signPattern(input as Parameters<typeof signPattern>[0]);+ handler: async (): Promise<MCPToolResult> => {+ try {+ const { createPluginDiscoveryService, getOfficialPlugins } = await import(+ '../plugins/store/index.js'+ );+ const discovery = createPluginDiscoveryService();+ const result = await discovery.discoverRegistry();+ if (!result.success || !result.registry) {+ return createResult({ error: result.error || 'Failed to discover registry' }, true);+ }+ const official = getOfficialPlugins(result.registry);+ return createResult(official);+ } catch (error) {+ return createResult({ error: (error as Error).message }, true);+ }},},];