society-protocol 1.0.0

package/dist/bootstrap.js

@@ -0,0 +1,304 @@
+/**
+ * Zero-Config Bootstrap Module
+ *
+ * Auto-discovery de peers via:
+ * 1. DNS TXT records (bootstrap.society.dev)
+ * 2. Hardcoded fallback list
+ * 3. Cache local de peers funcionais
+ * 4. mDNS para LAN discovery
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { promisify } from 'util';
+import { exec } from 'child_process';
+const execAsync = promisify(exec);
+// Default bootstrap domain
+const SOCIETY_DOMAIN = 'society.computer';
+function parseFallbackPeersFromEnv() {
+    const raw = process.env.SOCIETY_BOOTSTRAP_ADDRS || '';
+    const addrs = raw.split(',').map((item) => item.trim()).filter(Boolean);
+    const now = Date.now();
+    return addrs.map((addr, index) => ({
+        id: `env_${index}`,
+        addrs: [addr],
+        lastSeen: now,
+        latency: 0,
+        reliability: 0.5,
+    }));
+}
+const DEFAULT_FALLBACK_PEERS = parseFallbackPeersFromEnv();
+// Endpoints DNS para descoberta
+const DEFAULT_DNS_ENDPOINTS = [
+    `bootstrap.${SOCIETY_DOMAIN}`,
+    `bootstrap.society.dev`,
+    `bootstrap1.${SOCIETY_DOMAIN}`,
+    `bootstrap2.${SOCIETY_DOMAIN}`,
+    `bootstrap3.${SOCIETY_DOMAIN}`,
+];
+export class BootstrapManager {
+    config;
+    cache = new Map();
+    workingPeers = [];
+    constructor(customConfig) {
+        const societyDir = join(homedir(), '.society');
+        this.config = {
+            dnsEndpoints: customConfig?.dnsEndpoints ?? DEFAULT_DNS_ENDPOINTS,
+            fallbackPeers: customConfig?.fallbackPeers ?? DEFAULT_FALLBACK_PEERS,
+            cacheFile: customConfig?.cacheFile ?? join(societyDir, 'peers-cache.json'),
+            cacheTtlMs: customConfig?.cacheTtlMs ?? 24 * 60 * 60 * 1000, // 24h
+            discoveryTimeoutMs: customConfig?.discoveryTimeoutMs ?? 10000 // 10s
+        };
+        this.ensureCacheDir();
+        this.loadCache();
+    }
+    ensureCacheDir() {
+        const dir = join(homedir(), '.society');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    loadCache() {
+        try {
+            if (existsSync(this.config.cacheFile)) {
+                const data = JSON.parse(readFileSync(this.config.cacheFile, 'utf-8'));
+                const now = Date.now();
+                for (const peer of data.peers || []) {
+                    // Only load if not expired
+                    if (now - peer.lastSeen < this.config.cacheTtlMs) {
+                        this.cache.set(peer.id, peer);
+                    }
+                }
+                console.log(`[bootstrap] Loaded ${this.cache.size} peers from cache`);
+            }
+        }
+        catch (err) {
+            console.warn('[bootstrap] Failed to load cache:', err);
+        }
+    }
+    saveCache() {
+        try {
+            const data = {
+                updatedAt: Date.now(),
+                peers: Array.from(this.cache.values())
+            };
+            writeFileSync(this.config.cacheFile, JSON.stringify(data, null, 2));
+        }
+        catch (err) {
+            console.warn('[bootstrap] Failed to save cache:', err);
+        }
+    }
+    /**
+     * Query DNS TXT records for peer lists
+     */
+    async queryDnsPeers() {
+        const peers = [];
+        for (const endpoint of this.config.dnsEndpoints) {
+            try {
+                // Try dig first, then nslookup as fallback
+                let result;
+                try {
+                    const { stdout } = await execAsync(`dig +short TXT ${endpoint}`);
+                    result = stdout;
+                }
+                catch {
+                    const { stdout } = await execAsync(`nslookup -type=TXT ${endpoint}`);
+                    result = stdout;
+                }
+                // Parse TXT records:
+                // 1) peers=<base64-encoded-peer-list>
+                // 2) addrs=<comma-separated-multiaddrs>
+                const txtRecords = result
+                    .split('\n')
+                    .map(line => line.trim().replace(/"/g, ''))
+                    .filter(line => line.startsWith('peers=') || line.startsWith('addrs='));
+                for (const record of txtRecords) {
+                    if (record.startsWith('addrs=')) {
+                        const addrs = record
+                            .replace('addrs=', '')
+                            .split(',')
+                            .map((item) => item.trim())
+                            .filter((item) => item.startsWith('/'));
+                        if (addrs.length > 0) {
+                            peers.push({
+                                id: `dns_${endpoint}_addrs`,
+                                addrs,
+                                lastSeen: Date.now(),
+                                latency: 0,
+                                reliability: 0.7
+                            });
+                        }
+                        continue;
+                    }
+                    if (record.startsWith('peers=')) {
+                        try {
+                            const encoded = record.replace('peers=', '');
+                            const decoded = Buffer.from(encoded, 'base64').toString('utf-8');
+                            const peerList = JSON.parse(decoded);
+                            peers.push(...peerList);
+                        }
+                        catch {
+                            console.warn(`[bootstrap] Failed to parse peers TXT record from ${endpoint}`);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.warn(`[bootstrap] DNS query failed for ${endpoint}`);
+            }
+        }
+        return peers;
+    }
+    /**
+     * Test connectivity to a peer
+     */
+    async testPeer(peer) {
+        const start = Date.now();
+        try {
+            // Try to dial the peer with timeout
+            // This would integrate with the actual libp2p dial
+            // For now, we simulate with a ping-like check
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            // In real implementation, this would be:
+            // await this.node.dial(peer.addrs[0], { signal: controller.signal });
+            clearTimeout(timeout);
+            const latency = Date.now() - start;
+            return { latency, working: true };
+        }
+        catch {
+            return { latency: Infinity, working: false };
+        }
+    }
+    /**
+     * Discover and return working bootstrap peers
+     * Priority: DNS > Cache > Fallback
+     */
+    async discover() {
+        console.log('[bootstrap] Starting peer discovery...');
+        const allPeers = [];
+        const testedPeers = new Set();
+        const working = [];
+        // 1. Try DNS first (most up-to-date)
+        console.log('[bootstrap] Querying DNS...');
+        try {
+            const dnsPeers = await this.queryDnsPeers();
+            allPeers.push(...dnsPeers);
+            console.log(`[bootstrap] DNS returned ${dnsPeers.length} peers`);
+        }
+        catch (err) {
+            console.warn('[bootstrap] DNS discovery failed:', err);
+        }
+        // 2. Try cached peers
+        console.log('[bootstrap] Checking cache...');
+        const cachedPeers = Array.from(this.cache.values());
+        allPeers.push(...cachedPeers);
+        // 3. Add fallback peers
+        console.log('[bootstrap] Adding fallback peers...');
+        allPeers.push(...this.config.fallbackPeers);
+        // 4. Test peers in parallel (with concurrency limit)
+        console.log(`[bootstrap] Testing ${allPeers.length} unique peers...`);
+        const batchSize = 5;
+        for (let i = 0; i < allPeers.length; i += batchSize) {
+            const batch = allPeers.slice(i, i + batchSize);
+            const results = await Promise.all(batch.map(async (peer) => {
+                if (testedPeers.has(peer.id))
+                    return null;
+                testedPeers.add(peer.id);
+                const result = await this.testPeer(peer);
+                if (result.working) {
+                    return { ...peer, latency: result.latency, lastSeen: Date.now() };
+                }
+                return null;
+            }));
+            working.push(...results.filter((p) => p !== null));
+            // Stop if we have enough working peers
+            if (working.length >= 3)
+                break;
+        }
+        // 5. Sort by reliability and latency
+        working.sort((a, b) => {
+            const scoreA = a.reliability * 1000 - a.latency;
+            const scoreB = b.reliability * 1000 - b.latency;
+            return scoreB - scoreA;
+        });
+        // 6. Update cache with working peers
+        for (const peer of working) {
+            this.cache.set(peer.id, peer);
+        }
+        this.saveCache();
+        this.workingPeers = working;
+        console.log(`[bootstrap] Discovered ${working.length} working peers`);
+        if (working.length === 0) {
+            throw new Error('No bootstrap peers available. Check your internet connection.');
+        }
+        return working;
+    }
+    /**
+     * Get working peers (cached from last discovery)
+     */
+    getWorkingPeers() {
+        return this.workingPeers;
+    }
+    /**
+     * Add a peer manually (from mDNS or other discovery)
+     */
+    addPeer(peer) {
+        this.cache.set(peer.id, { ...peer, lastSeen: Date.now() });
+        this.saveCache();
+    }
+    /**
+     * Clear cache and force re-discovery
+     */
+    async refresh() {
+        this.cache.clear();
+        this.workingPeers = [];
+        return this.discover();
+    }
+}
+/**
+ * Quick bootstrap for immediate connection
+ * Usage: const peers = await quickBootstrap();
+ */
+export async function quickBootstrap() {
+    const manager = new BootstrapManager();
+    return manager.discover();
+}
+/**
+ * Check if running in common cloud environments
+ * Useful for auto-configuration
+ */
+export function detectCloudEnvironment() {
+    // AWS
+    if (process.env.AWS_REGION || existsSync('/sys/class/dmi/id/product_uuid')) {
+        try {
+            const uuid = readFileSync('/sys/class/dmi/id/product_uuid', 'utf-8');
+            if (uuid.startsWith('EC2') || uuid.startsWith('ec2'))
+                return 'aws';
+        }
+        catch { }
+    }
+    // GCP
+    if (process.env.GOOGLE_CLOUD_PROJECT || existsSync('/sys/class/dmi/id/product_name')) {
+        try {
+            const name = readFileSync('/sys/class/dmi/id/product_name', 'utf-8');
+            if (name.includes('Google'))
+                return 'gcp';
+        }
+        catch { }
+    }
+    // Azure
+    if (process.env.AZURE_RESOURCE_GROUP || existsSync('/sys/class/dmi/id/sys_vendor')) {
+        try {
+            const vendor = readFileSync('/sys/class/dmi/id/sys_vendor', 'utf-8');
+            if (vendor.includes('Microsoft'))
+                return 'azure';
+        }
+        catch { }
+    }
+    // DigitalOcean
+    if (existsSync('/etc/digitalocean'))
+        return 'digitalocean';
+    return 'local';
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/bridges/a2a-bridge.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Society Protocol — A2A (Agent-to-Agent) Bridge
+ *
+ * Implements Google's Agent-to-Agent protocol bridge,
+ * enabling interoperability between A2A-compliant agents
+ * and Society Protocol's P2P network.
+ *
+ * A2A spec: Agent Card, Tasks, Streaming, Push Notifications
+ *
+ * - Inbound: A2A task requests → Society CoC chains
+ * - Outbound: Society chains → A2A task responses
+ */
+import { EventEmitter } from 'events';
+import type { Storage } from '../storage.js';
+import type { RoomManager } from '../rooms.js';
+import type { CocEngine } from '../coc.js';
+import type { KnowledgePool } from '../knowledge.js';
+import type { Identity } from '../identity.js';
+export interface A2AAgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    capabilities: A2ACapabilities;
+    skills: A2ASkill[];
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+}
+export interface A2ACapabilities {
+    streaming: boolean;
+    pushNotifications: boolean;
+    stateTransitionHistory: boolean;
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples?: string[];
+}
+export type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'canceled' | 'failed' | 'unknown';
+export interface A2AMessage {
+    role: 'user' | 'agent';
+    parts: A2APart[];
+}
+export interface A2ATextPart {
+    type: 'text';
+    text: string;
+}
+export interface A2AFilePart {
+    type: 'file';
+    file: {
+        name: string;
+        mimeType: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+export interface A2ADataPart {
+    type: 'data';
+    data: Record<string, unknown>;
+}
+export type A2APart = A2ATextPart | A2AFilePart | A2ADataPart;
+export interface A2ATask {
+    id: string;
+    sessionId: string;
+    status: {
+        state: A2ATaskState;
+        message?: A2AMessage;
+    };
+    history?: A2AMessage[];
+    artifacts?: A2AArtifact[];
+    metadata?: Record<string, unknown>;
+}
+export interface A2AArtifact {
+    name: string;
+    description?: string;
+    parts: A2APart[];
+    index?: number;
+}
+export interface A2ATaskSendParams {
+    id: string;
+    sessionId?: string;
+    message: A2AMessage;
+    acceptedOutputModes?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface A2ABridgeConfig {
+    identity: Identity;
+    storage: Storage;
+    rooms: RoomManager;
+    coc: CocEngine;
+    knowledge: KnowledgePool;
+    /** Default room for incoming A2A tasks */
+    defaultRoom: string;
+    /** Skills exposed to A2A agents */
+    exposedSkills?: A2ASkill[];
+    /** Base URL for this agent's A2A endpoint */
+    baseUrl?: string;
+}
+export declare class A2ABridge extends EventEmitter {
+    private identity;
+    private storage;
+    private rooms;
+    private coc;
+    private knowledge;
+    private defaultRoom;
+    private exposedSkills;
+    private baseUrl;
+    private taskMappings;
+    constructor(config: A2ABridgeConfig);
+    getAgentCard(): A2AAgentCard;
+    private getDefaultSkills;
+    handleTaskSend(params: A2ATaskSendParams): Promise<A2ATask>;
+    getTask(taskId: string): A2ATask | undefined;
+    cancelTask(taskId: string): Promise<A2ATask>;
+    handleJsonRpc(request: {
+        jsonrpc: string;
+        id: string | number;
+        method: string;
+        params?: Record<string, unknown>;
+    }): Promise<{
+        jsonrpc: string;
+        id: string | number;
+        result?: unknown;
+        error?: {
+            code: number;
+            message: string;
+        };
+    }>;
+    /**
+     * Convert a completed Society chain into an A2A task response.
+     */
+    chainToA2ATask(chainId: string): A2ATask | undefined;
+    /**
+     * Create A2A message from Society step output.
+     */
+    stepToA2AMessage(stepOutput: {
+        memo: string;
+        artifacts?: Array<{
+            artifact_type: string;
+            content?: string;
+        }>;
+    }): A2AMessage;
+    private syncTaskState;
+    private getStatusMessage;
+    private createErrorTask;
+    private setupCocListeners;
+    getStats(): {
+        activeTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+    };
+    destroy(): void;
+}
+//# sourceMappingURL=a2a-bridge.d.ts.map

package/dist/bridges/a2a-bridge.d.ts.map

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