monomind 2.7.4 → 2.7.6

package/packages/@monomind/cli/dist/src/transfer/ipfs/upload.js

@@ -1,450 +0,0 @@
-/**
- * IPFS Upload Module
- * Real upload support via web3.storage, Pinata, or local IPFS
- *
- * @module @monomind/cli/transfer/ipfs/upload
- * @version 3.0.0
- */
-import * as crypto from 'crypto';
-/**
- * Sanitize a user-supplied filename before embedding it inside a multipart
- * Content-Disposition header.  Strip all CR/LF characters (MIME header injection)
- * and cap length to prevent oversized headers.
- */
-function sanitizeFileName(name) {
-    return name.replace(/[\r\n]/g, '').slice(0, 200);
-}
-/**
- * Get web3.storage token from environment or config
- */
-function getWeb3StorageToken() {
-    return process.env.WEB3_STORAGE_TOKEN ||
-        process.env.W3_TOKEN ||
-        process.env.IPFS_TOKEN;
-}
-/**
- * Generate a CID from content (for demo mode when no token available)
- * Uses CIDv1 with dag-pb codec and sha2-256 multihash
- */
-function generateDemoCID(content) {
-    const hash = crypto.createHash('sha256').update(content).digest();
-    // CIDv1 with dag-pb codec and sha2-256 multihash
-    const prefix = Buffer.from([0x01, 0x70, 0x12, 0x20]);
-    const cidBytes = Buffer.concat([prefix, hash]);
-    // Base32 encode
-    const base32Chars = 'abcdefghijklmnopqrstuvwxyz234567';
-    let result = 'bafybei';
-    for (let i = 0; i < 44; i++) {
-        const byte = cidBytes[i % cidBytes.length] || 0;
-        result += base32Chars[byte % 32];
-    }
-    return result;
-}
-/**
- * Upload to web3.storage (real IPFS)
- */
-async function uploadToWeb3Storage(content, options) {
-    const token = options.apiKey || getWeb3StorageToken();
-    if (!token) {
-        throw new Error('Web3.storage token not found. Set WEB3_STORAGE_TOKEN environment variable.\n' +
-            'Get a free token at: https://web3.storage');
-    }
-    const endpoint = options.endpoint || 'https://api.web3.storage';
-    const name = sanitizeFileName(options.name || 'pattern.cfp.json');
-    console.log(`[IPFS] Uploading ${content.length} bytes to web3.storage...`);
-    // Create FormData-like body for upload
-    const boundary = '----WebKitFormBoundary' + crypto.randomBytes(16).toString('hex');
-    const body = Buffer.concat([
-        Buffer.from(`--${boundary}\r\n`),
-        Buffer.from(`Content-Disposition: form-data; name="file"; filename="${name}"\r\n`),
-        Buffer.from(`Content-Type: application/json\r\n\r\n`),
-        content,
-        Buffer.from(`\r\n--${boundary}--\r\n`),
-    ]);
-    const response = await fetch(`${endpoint}/upload`, {
-        method: 'POST',
-        headers: {
-            'Authorization': `Bearer ${token}`,
-            'Content-Type': `multipart/form-data; boundary=${boundary}`,
-        },
-        body,
-    });
-    if (!response.ok) {
-        const error = await response.text();
-        throw new Error(`Web3.storage upload failed: ${response.status} ${error}`);
-    }
-    const rawText = await response.arrayBuffer();
-    if (rawText.byteLength > 64 * 1024)
-        throw new Error('Web3.storage response too large');
-    const result = JSON.parse(new TextDecoder().decode(rawText));
-    const cid = result.cid;
-    const gateway = options.gateway || 'https://w3s.link';
-    console.log(`[IPFS] Upload complete!`);
-    console.log(`[IPFS] CID: ${cid}`);
-    return {
-        cid,
-        size: content.length,
-        gateway,
-        pinnedAt: new Date().toISOString(),
-        url: `${gateway}/ipfs/${cid}`,
-    };
-}
-/**
- * Upload to Pinata
- */
-async function uploadToPinata(content, options) {
-    const apiKey = options.apiKey || process.env.PINATA_API_KEY;
-    const apiSecret = options.apiSecret || process.env.PINATA_API_SECRET;
-    if (!apiKey || !apiSecret) {
-        throw new Error('Pinata API credentials not found. Set PINATA_API_KEY and PINATA_API_SECRET.\n' +
-            'Get credentials at: https://pinata.cloud');
-    }
-    const name = sanitizeFileName(options.name || 'pattern.cfp.json');
-    console.log(`[IPFS] Uploading ${content.length} bytes to Pinata...`);
-    const boundary = '----WebKitFormBoundary' + crypto.randomBytes(16).toString('hex');
-    const metadata = JSON.stringify({ name });
-    const body = Buffer.concat([
-        Buffer.from(`--${boundary}\r\n`),
-        Buffer.from(`Content-Disposition: form-data; name="pinataMetadata"\r\n\r\n`),
-        Buffer.from(`${metadata}\r\n`),
-        Buffer.from(`--${boundary}\r\n`),
-        Buffer.from(`Content-Disposition: form-data; name="file"; filename="${name}"\r\n`),
-        Buffer.from(`Content-Type: application/json\r\n\r\n`),
-        content,
-        Buffer.from(`\r\n--${boundary}--\r\n`),
-    ]);
-    const response = await fetch('https://api.pinata.cloud/pinning/pinFileToIPFS', {
-        method: 'POST',
-        headers: {
-            'pinata_api_key': apiKey,
-            'pinata_secret_api_key': apiSecret,
-            'Content-Type': `multipart/form-data; boundary=${boundary}`,
-        },
-        body,
-    });
-    if (!response.ok) {
-        const error = await response.text();
-        throw new Error(`Pinata upload failed: ${response.status} ${error}`);
-    }
-    const rawText2 = await response.arrayBuffer();
-    if (rawText2.byteLength > 64 * 1024)
-        throw new Error('Pinata response too large');
-    const result = JSON.parse(new TextDecoder().decode(rawText2));
-    const cid = result.IpfsHash;
-    const gateway = options.gateway || 'https://gateway.pinata.cloud';
-    console.log(`[IPFS] Upload complete!`);
-    console.log(`[IPFS] CID: ${cid}`);
-    return {
-        cid,
-        size: content.length,
-        gateway,
-        pinnedAt: new Date().toISOString(),
-        url: `${gateway}/ipfs/${cid}`,
-    };
-}
-/**
- * Upload content to IPFS
- *
- * Supports (in order of preference):
- * - Local/Custom IPFS node (IPFS_API_URL) - FREE, your own node
- * - web3.storage (WEB3_STORAGE_TOKEN) - Free 5GB tier
- * - Pinata (PINATA_API_KEY + PINATA_API_SECRET) - Free 1GB tier
- * - Demo mode (generates deterministic CIDs when no credentials)
- */
-export async function uploadToIPFS(content, options = {}) {
-    const { pin = true, pinningService, gateway = 'https://w3s.link', name = 'pattern', } = options;
-    // Check environment variables
-    const localIPFS = process.env.IPFS_API_URL;
-    const web3Token = getWeb3StorageToken();
-    const pinataKey = process.env.PINATA_API_KEY;
-    // 1. Try local/custom IPFS node first (FREE - your own node)
-    if (localIPFS || pinningService === 'local') {
-        try {
-            const isAvailable = await checkLocalIPFSNode();
-            if (isAvailable) {
-                return await uploadToLocalIPFS(content, options);
-            }
-            else {
-                console.warn(`[IPFS] Local node at ${localIPFS || 'localhost:5001'} not available`);
-            }
-        }
-        catch (error) {
-            console.warn(`[IPFS] Local IPFS upload failed: ${error}`);
-        }
-    }
-    // 2. Try Pinata
-    if (pinningService === 'pinata' || (pinataKey && !web3Token)) {
-        try {
-            return await uploadToPinata(content, options);
-        }
-        catch (error) {
-            console.warn(`[IPFS] Pinata upload failed: ${error}`);
-        }
-    }
-    // 3. Try Web3.storage
-    if (web3Token || pinningService === 'web3storage') {
-        try {
-            return await uploadToWeb3Storage(content, options);
-        }
-        catch (error) {
-            console.warn(`[IPFS] Web3.storage upload failed: ${error}`);
-        }
-    }
-    // Fall back to demo mode - WARN user prominently
-    console.warn(`⚠ [IPFS] DEMO MODE - No IPFS credentials configured`);
-    console.warn(`⚠ [IPFS] Content will NOT be uploaded to decentralized storage`);
-    console.warn(`⚠ [IPFS] To enable real uploads, configure one of:`);
-    console.warn(`⚠ [IPFS]   - IPFS_API_URL=http://YOUR_NODE:5001 (FREE - your own node)`);
-    console.warn(`⚠ [IPFS]   - WEB3_STORAGE_TOKEN (free 5GB at web3.storage)`);
-    console.warn(`⚠ [IPFS]   - PINATA_API_KEY + PINATA_SECRET_KEY (free tier available)`);
-    const cid = generateDemoCID(content);
-    const size = content.length;
-    console.log(`[IPFS] Demo upload: ${size} bytes`);
-    console.log(`[IPFS] Name: ${name}`);
-    const result = {
-        cid,
-        size,
-        gateway,
-        url: `${gateway}/ipfs/${cid}`,
-    };
-    if (pin) {
-        result.pinnedAt = new Date().toISOString();
-        console.log(`[IPFS] Demo pinned at: ${result.pinnedAt}`);
-    }
-    console.log(`[IPFS] Demo CID: ${cid}`);
-    console.log(`[IPFS] Demo URL: ${result.url}`);
-    return result;
-}
-/**
- * Pin content by CID
- */
-export async function pinContent(cid, options = {}) {
-    const web3Token = getWeb3StorageToken();
-    const pinataKey = process.env.PINATA_API_KEY;
-    // Real pinning with Pinata
-    if (pinataKey && options.service !== 'web3storage') {
-        try {
-            const pinataSecret = process.env.PINATA_API_SECRET;
-            const response = await fetch('https://api.pinata.cloud/pinning/pinByHash', {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'pinata_api_key': pinataKey,
-                    'pinata_secret_api_key': pinataSecret || '',
-                },
-                body: JSON.stringify({
-                    hashToPin: cid,
-                    pinataMetadata: { name: options.name || cid },
-                }),
-            });
-            if (response.ok) {
-                const pinnedAt = new Date().toISOString();
-                console.log(`[IPFS] Pinned ${cid} via Pinata at ${pinnedAt}`);
-                return { success: true, pinnedAt };
-            }
-        }
-        catch (error) {
-            console.warn(`[IPFS] Pinata pin failed: ${error}`);
-        }
-    }
-    // Demo mode
-    const pinnedAt = new Date().toISOString();
-    console.log(`[IPFS] Demo pinning ${cid}...`);
-    await new Promise(resolve => setTimeout(resolve, 300));
-    console.log(`[IPFS] Demo pinned at ${pinnedAt}`);
-    return { success: true, pinnedAt };
-}
-/**
- * Unpin content by CID
- */
-export async function unpinContent(cid, options = {}) {
-    const pinataKey = process.env.PINATA_API_KEY;
-    // Real unpinning with Pinata
-    if (pinataKey) {
-        try {
-            const pinataSecret = process.env.PINATA_API_SECRET;
-            const response = await fetch(`https://api.pinata.cloud/pinning/unpin/${cid}`, {
-                method: 'DELETE',
-                headers: {
-                    'pinata_api_key': pinataKey,
-                    'pinata_secret_api_key': pinataSecret || '',
-                },
-            });
-            if (response.ok) {
-                console.log(`[IPFS] Unpinned ${cid} from Pinata`);
-                return { success: true };
-            }
-        }
-        catch (error) {
-            console.warn(`[IPFS] Pinata unpin failed: ${error}`);
-        }
-    }
-    // Demo mode
-    console.log(`[IPFS] Demo unpinning ${cid}...`);
-    await new Promise(resolve => setTimeout(resolve, 200));
-    console.log(`[IPFS] Demo unpinned`);
-    return { success: true };
-}
-/** Allowlisted IPFS gateway hosts for SSRF prevention */
-const ALLOWED_GATEWAY_HOSTS_UPLOAD = new Set([
-    'w3s.link',
-    'gateway.pinata.cloud',
-    'cloudflare-ipfs.com',
-    'ipfs.io',
-    'dweb.link',
-]);
-function isAllowedGateway(gateway) {
-    try {
-        const parsed = new URL(gateway);
-        return parsed.protocol === 'https:' && ALLOWED_GATEWAY_HOSTS_UPLOAD.has(parsed.hostname);
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if content exists on IPFS
- */
-export async function checkContent(cid, gateway = 'https://w3s.link') {
-    if (!isAllowedGateway(gateway)) {
-        console.warn(`[IPFS] Blocked checkContent: gateway not in allowlist: ${gateway}`);
-        return { exists: false };
-    }
-    console.log(`[IPFS] Checking ${cid}...`);
-    try {
-        const response = await fetch(`${gateway}/ipfs/${cid}`, {
-            method: 'HEAD',
-            signal: AbortSignal.timeout(10000),
-        });
-        if (response.ok) {
-            const size = parseInt(response.headers.get('content-length') || '0', 10);
-            console.log(`[IPFS] Content exists, size: ${size}`);
-            return { exists: true, size };
-        }
-    }
-    catch (error) {
-        console.log(`[IPFS] Content check failed: ${error}`);
-    }
-    return { exists: false };
-}
-/**
- * Get gateway URL for CID
- */
-export function getGatewayURL(cid, gateway = 'https://w3s.link') {
-    return `${gateway}/ipfs/${cid}`;
-}
-/**
- * Get IPNS URL for name
- */
-export function getIPNSURL(name, gateway = 'https://w3s.link') {
-    return `${gateway}/ipns/${name}`;
-}
-/**
- * Upload to a local/custom IPFS node
- * Connect to your own IPFS daemon via HTTP API
- */
-async function uploadToLocalIPFS(content, options) {
-    const apiUrl = process.env.IPFS_API_URL || 'http://localhost:5001';
-    const name = sanitizeFileName(options.name || 'pattern.cfp.json');
-    console.log(`[IPFS] Uploading ${content.length} bytes to ${apiUrl}...`);
-    const boundary = '----IPFSBoundary' + crypto.randomBytes(16).toString('hex');
-    const body = Buffer.concat([
-        Buffer.from(`--${boundary}\r\n`),
-        Buffer.from(`Content-Disposition: form-data; name="file"; filename="${name}"\r\n`),
-        Buffer.from(`Content-Type: application/json\r\n\r\n`),
-        content,
-        Buffer.from(`\r\n--${boundary}--\r\n`),
-    ]);
-    const response = await fetch(`${apiUrl}/api/v0/add?pin=${options.pin !== false}`, {
-        method: 'POST',
-        headers: {
-            'Content-Type': `multipart/form-data; boundary=${boundary}`,
-        },
-        body,
-    });
-    if (!response.ok) {
-        const error = await response.text();
-        throw new Error(`Local IPFS upload failed: ${response.status} ${error}`);
-    }
-    const rawText3 = await response.arrayBuffer();
-    if (rawText3.byteLength > 64 * 1024)
-        throw new Error('Local IPFS response too large');
-    const result = JSON.parse(new TextDecoder().decode(rawText3));
-    const cid = result.Hash;
-    // Try to get external gateway URL if configured
-    const gatewayUrl = process.env.IPFS_GATEWAY_URL || options.gateway || 'https://ipfs.io';
-    console.log(`[IPFS] Upload complete!`);
-    console.log(`[IPFS] CID: ${cid}`);
-    return {
-        cid,
-        size: content.length,
-        gateway: gatewayUrl,
-        pinnedAt: options.pin !== false ? new Date().toISOString() : undefined,
-        url: `${gatewayUrl}/ipfs/${cid}`,
-    };
-}
-/**
- * Check if local IPFS node is available
- */
-async function checkLocalIPFSNode() {
-    const apiUrl = process.env.IPFS_API_URL || 'http://localhost:5001';
-    try {
-        const response = await fetch(`${apiUrl}/api/v0/id`, {
-            method: 'POST',
-            signal: AbortSignal.timeout(2000),
-        });
-        return response.ok;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if real IPFS credentials are available
- */
-export function hasIPFSCredentials() {
-    return !!(getWeb3StorageToken() || process.env.PINATA_API_KEY || process.env.IPFS_API_URL);
-}
-/**
- * Get IPFS service status
- */
-export function getIPFSServiceStatus() {
-    const localIPFS = process.env.IPFS_API_URL;
-    const web3Token = getWeb3StorageToken();
-    const pinataKey = process.env.PINATA_API_KEY;
-    if (localIPFS) {
-        return {
-            service: 'local',
-            configured: true,
-            message: `Local IPFS node configured at ${localIPFS} - FREE uploads enabled`,
-            apiUrl: localIPFS,
-        };
-    }
-    if (web3Token) {
-        return {
-            service: 'web3storage',
-            configured: true,
-            message: 'Web3.storage configured - real IPFS uploads enabled',
-        };
-    }
-    if (pinataKey) {
-        return {
-            service: 'pinata',
-            configured: true,
-            message: 'Pinata configured - real IPFS uploads enabled',
-        };
-    }
-    return {
-        service: 'demo',
-        configured: false,
-        message: 'No IPFS credentials - using demo mode. Options:\n' +
-            '  1. IPFS_API_URL=http://YOUR_NODE:5001 (FREE - your own node)\n' +
-            '  2. WEB3_STORAGE_TOKEN (free 5GB at web3.storage)\n' +
-            '  3. PINATA_API_KEY (free 1GB at pinata.cloud)',
-    };
-}
-/**
- * Export the local IPFS check for external use
- */
-export { checkLocalIPFSNode };
-//# sourceMappingURL=upload.js.map

package/packages/@monomind/cli/dist/src/transfer/models/seraphine.d.ts

@@ -1,72 +0,0 @@
-/**
- * Seraphine Genesis Model
- * The first Monomind pattern model - "Hello World" for pattern sharing
- *
- * Seraphine represents the foundational patterns for intelligent agent coordination.
- * Named after the Greek "Seraphim" (burning ones), symbolizing the spark of knowledge
- * that ignites collaborative AI intelligence.
- */
-import type { CFPFormat, PatternCollection, RoutingPattern, ComplexityPattern, CoveragePattern, TrajectoryPattern, CustomPattern } from '../types.js';
-/**
- * Seraphine model version
- */
-export declare const SERAPHINE_VERSION = "1.0.0";
-/**
- * Seraphine model metadata
- */
-export declare const SERAPHINE_METADATA: {
-    name: string;
-    displayName: string;
-    description: string;
-    author: {
-        id: string;
-        displayName: string;
-    };
-    license: string;
-    tags: string[];
-    language: string;
-    framework: string;
-};
-/**
- * Core routing patterns for Seraphine
- * These define how tasks are routed to appropriate agents
- */
-export declare const SERAPHINE_ROUTING_PATTERNS: RoutingPattern[];
-/**
- * Complexity heuristics for Seraphine
- * These help estimate task complexity for resource allocation
- */
-export declare const SERAPHINE_COMPLEXITY_PATTERNS: ComplexityPattern[];
-/**
- * Coverage patterns for Seraphine
- * These track knowledge domain coverage
- */
-export declare const SERAPHINE_COVERAGE_PATTERNS: CoveragePattern[];
-/**
- * Trajectory patterns for Seraphine
- * These capture successful task execution paths
- */
-export declare const SERAPHINE_TRAJECTORY_PATTERNS: TrajectoryPattern[];
-/**
- * Custom patterns for Seraphine
- * These are specialized patterns unique to Seraphine
- */
-export declare const SERAPHINE_CUSTOM_PATTERNS: CustomPattern[];
-/**
- * Create the complete Seraphine pattern collection
- */
-export declare function createSeraphinePatterns(): PatternCollection;
-/**
- * Create the Seraphine Genesis CFP document
- */
-export declare function createSeraphineGenesis(): CFPFormat;
-/**
- * Get Seraphine model info
- */
-export declare function getSeraphineInfo(): {
-    name: string;
-    version: string;
-    description: string;
-    patternCounts: Record<string, number>;
-};
-//# sourceMappingURL=seraphine.d.ts.map