@oobe-protocol-labs/synapse-client-sdk 2.0.0 → 2.0.5

package/dist/esm/ai/sap/subnetwork.js

@@ -1,361 +0,0 @@
-/**
- * @module ai/sap/subnetwork
- * @description SAP — Subnetwork builder for composing multi-agent task forces.
- *
- * Given a set of **required capabilities**, discovers the optimal set of
- * agents that collectively cover all capabilities, then provides utilities
- * to orchestrate them (cost estimation, health checks, failover selection).
- *
- * Think of it as a **query planner** for an agent-based microservice mesh:
- * you describe WHAT you need, and the SubnetworkBuilder finds WHO can do it,
- * optimizing for cost, reputation, latency, or a weighted combination.
- *
- * @example
- * ```ts
- * import { SubnetworkBuilder, SAPDiscovery } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
- *
- * const discovery = new SAPDiscovery(client, { programId });
- * const subnet = new SubnetworkBuilder(discovery);
- *
- * // Build a subnetwork that can swap, lend, and analyze risk
- * const result = await subnet.build({
- *   requiredCapabilities: ['jupiter:swap', 'solend:lend', 'ai:riskScore'],
- *   strategy: 'balanced',
- *   maxCostPerCall: 5000n,
- * });
- *
- * if (result.complete) {
- *   for (const assignment of result.assignments) {
- *     console.log(`${assignment.capability} → ${assignment.agent.name}`);
- *   }
- *   console.log(`Total cost: ${result.estimatedCostPerCall}`);
- * }
- * ```
- *
- * @since 1.4.0
- */
-/* ═══════════════════════════════════════════════════════════════
- *  SubnetworkBuilder
- * ═══════════════════════════════════════════════════════════════ */
-/**
- * @description Builds and manages agent sub-networks for multi-capability tasks.
- *
- * The builder:
- * 1. Discovers agents for each required capability via {@link SAPDiscovery}
- * 2. Scores candidates using the selected strategy
- * 3. Assigns agents to capabilities, preferring multi-capable agents
- * 4. Computes cost, reputation, and latency estimates
- * 5. Identifies failover alternatives for each assignment
- *
- * @since 1.4.0
- */
-export class SubnetworkBuilder {
-    discovery;
-    constructor(discovery) {
-        this.discovery = discovery;
-    }
-    /**
-     * @description Build an optimal subnetwork covering all required capabilities.
-     *
-     * @param {SubnetworkConfig} config - Subnetwork requirements
-     * @returns {Promise<SubnetworkResult>} The built subnetwork with assignments
-     *
-     * @example
-     * ```ts
-     * const result = await subnet.build({
-     *   requiredCapabilities: ['jupiter:swap', 'pyth:getPrice', 'ai:riskScore'],
-     *   strategy: 'balanced',
-     *   minReputation: 500,
-     *   maxCostPerCall: 10000n,
-     * });
-     * ```
-     *
-     * @since 1.4.0
-     */
-    async build(config) {
-        const start = performance.now();
-        const { requiredCapabilities, strategy = 'balanced', maxCostPerCall, minReputation = 0, minUptime = 0, pricingTier = 'standard', maxAgents = 10, preferMultiCapable = true, } = config;
-        // Phase 1: Discover candidate agents for each capability
-        const candidateMap = new Map();
-        for (const capId of requiredCapabilities) {
-            const agents = await this.discovery.findByCapability(capId);
-            const filtered = agents.filter(a => a.reputation.score >= minReputation &&
-                a.reputation.uptimePercent >= minUptime);
-            candidateMap.set(capId, filtered);
-        }
-        // Phase 2: Score and select
-        const assignments = [];
-        const unassigned = [];
-        const assignedAgentSet = new Set();
-        // Sort capabilities: those with fewer candidates first (constrained first)
-        const sortedCaps = [...requiredCapabilities].sort((a, b) => {
-            const aCount = candidateMap.get(a)?.length ?? 0;
-            const bCount = candidateMap.get(b)?.length ?? 0;
-            return aCount - bCount;
-        });
-        for (const capId of sortedCaps) {
-            const candidates = candidateMap.get(capId) ?? [];
-            if (candidates.length === 0) {
-                unassigned.push(capId);
-                continue;
-            }
-            // Score each candidate
-            const scored = candidates.map(agent => ({
-                agent,
-                score: this.scoreAgent(agent, strategy, pricingTier, preferMultiCapable, requiredCapabilities, assignedAgentSet),
-            }));
-            // Sort by score (higher = better)
-            scored.sort((a, b) => b.score - a.score);
-            const best = scored[0].agent;
-            const pricing = this.findPricing(best, pricingTier);
-            // Check cost constraint
-            if (maxCostPerCall !== undefined && pricing) {
-                const currentCost = assignments.reduce((sum, a) => sum + a.pricing.pricePerCall, 0n);
-                if (currentCost + pricing.pricePerCall > maxCostPerCall) {
-                    // Try cheaper alternatives
-                    const cheaper = scored.find(s => {
-                        const p = this.findPricing(s.agent, pricingTier);
-                        return p && currentCost + p.pricePerCall <= maxCostPerCall;
-                    });
-                    if (cheaper) {
-                        const cheaperPricing = this.findPricing(cheaper.agent, pricingTier);
-                        assignments.push({
-                            capability: capId,
-                            agent: cheaper.agent,
-                            pricing: cheaperPricing,
-                            reputationScore: cheaper.agent.reputation.score,
-                            latencyMs: cheaper.agent.reputation.avgLatencyMs,
-                            alternatives: scored
-                                .filter(s => s.agent.walletPubkey !== cheaper.agent.walletPubkey)
-                                .map(s => s.agent)
-                                .slice(0, 3),
-                        });
-                        assignedAgentSet.add(cheaper.agent.walletPubkey);
-                        continue;
-                    }
-                    else {
-                        unassigned.push(capId);
-                        continue;
-                    }
-                }
-            }
-            if (!pricing) {
-                // No matching pricing tier, use agent but warn
-                const fallbackPricing = {
-                    tierId: pricingTier,
-                    pricePerCall: 0n,
-                    rateLimit: 1,
-                    maxCallsPerSession: 0,
-                    tokenType: 'SOL',
-                };
-                assignments.push({
-                    capability: capId,
-                    agent: best,
-                    pricing: fallbackPricing,
-                    reputationScore: best.reputation.score,
-                    latencyMs: best.reputation.avgLatencyMs,
-                    alternatives: scored.slice(1, 4).map(s => s.agent),
-                });
-            }
-            else {
-                assignments.push({
-                    capability: capId,
-                    agent: best,
-                    pricing,
-                    reputationScore: best.reputation.score,
-                    latencyMs: best.reputation.avgLatencyMs,
-                    alternatives: scored.slice(1, 4).map(s => s.agent),
-                });
-            }
-            assignedAgentSet.add(best.walletPubkey);
-            // Enforce max agents
-            if (assignedAgentSet.size >= maxAgents)
-                break;
-        }
-        // Deduplicate agents
-        const agentsMap = new Map();
-        for (const a of assignments) {
-            agentsMap.set(a.agent.walletPubkey, a.agent);
-        }
-        const agents = [...agentsMap.values()];
-        // Metrics
-        const estimatedCostPerCall = assignments.reduce((sum, a) => sum + a.pricing.pricePerCall, 0n);
-        const avgReputation = agents.length > 0
-            ? Math.round(agents.reduce((sum, a) => sum + a.reputation.score, 0) / agents.length)
-            : 0;
-        const maxLatencyMs = agents.length > 0
-            ? Math.max(...agents.map(a => a.reputation.avgLatencyMs))
-            : 0;
-        return {
-            complete: unassigned.length === 0,
-            assignments,
-            unassigned,
-            agents,
-            estimatedCostPerCall,
-            avgReputation,
-            maxLatencyMs,
-            buildTimeMs: Math.round(performance.now() - start),
-            strategy,
-        };
-    }
-    /**
-     * @description Evaluate the health of an existing subnetwork result.
-     *
-     * Checks each assigned agent's reputation, uptime, and latency,
-     * and identifies capabilities at risk (single provider) or with
-     * redundancy (multiple alternatives).
-     *
-     * @param {SubnetworkResult} subnet - A previously built subnetwork
-     * @returns {SubnetworkHealth} Health assessment
-     *
-     * @since 1.4.0
-     */
-    evaluateHealth(subnet) {
-        const agentHealth = [];
-        const atRisk = [];
-        const redundant = [];
-        // Group capabilities by agent
-        const agentCaps = new Map();
-        for (const a of subnet.assignments) {
-            const key = a.agent.walletPubkey;
-            if (!agentCaps.has(key))
-                agentCaps.set(key, []);
-            agentCaps.get(key).push(a.capability);
-        }
-        for (const agent of subnet.agents) {
-            const caps = agentCaps.get(agent.walletPubkey) ?? [];
-            let isHealthy = true;
-            let reason;
-            if (agent.reputation.uptimePercent < 50) {
-                isHealthy = false;
-                reason = `Low uptime: ${agent.reputation.uptimePercent}%`;
-            }
-            else if (agent.reputation.score < 200) {
-                isHealthy = false;
-                reason = `Very low reputation: ${agent.reputation.score}/1000`;
-            }
-            else if (agent.reputation.avgLatencyMs > 10000) {
-                isHealthy = false;
-                reason = `Very high latency: ${agent.reputation.avgLatencyMs}ms`;
-            }
-            else if (!agent.isActive) {
-                isHealthy = false;
-                reason = 'Agent is deactivated';
-            }
-            agentHealth.push({ agent, capabilities: caps, isHealthy, reason });
-        }
-        // Check redundancy
-        for (const assignment of subnet.assignments) {
-            if (assignment.alternatives.length === 0) {
-                atRisk.push(assignment.capability);
-            }
-            else {
-                redundant.push(assignment.capability);
-            }
-        }
-        const unhealthyCount = agentHealth.filter(a => !a.isHealthy).length;
-        let status;
-        if (unhealthyCount === 0) {
-            status = 'healthy';
-        }
-        else if (unhealthyCount < agentHealth.length / 2) {
-            status = 'degraded';
-        }
-        else {
-            status = 'critical';
-        }
-        return { status, agents: agentHealth, atRisk, redundant };
-    }
-    /**
-     * @description Rebuild a subnetwork, replacing unhealthy agents with alternatives.
-     *
-     * @param {SubnetworkResult} current - The current subnetwork
-     * @param {SubnetworkConfig} config - Original config (for constraints)
-     * @returns {Promise<SubnetworkResult>} A rebuilt subnetwork
-     *
-     * @since 1.4.0
-     */
-    async rebuild(current, config) {
-        const health = this.evaluateHealth(current);
-        if (health.status === 'healthy')
-            return current;
-        // Identify capabilities with unhealthy agents
-        const unhealthyWallets = new Set(health.agents.filter(a => !a.isHealthy).map(a => a.agent.walletPubkey));
-        // Filter out unhealthy agents' capabilities and rebuild only those
-        const capsToRebuild = [];
-        for (const assignment of current.assignments) {
-            if (unhealthyWallets.has(assignment.agent.walletPubkey)) {
-                capsToRebuild.push(assignment.capability);
-            }
-        }
-        if (capsToRebuild.length === 0)
-            return current;
-        // Full rebuild with the same config
-        return this.build({
-            ...config,
-            requiredCapabilities: config.requiredCapabilities,
-        });
-    }
-    /**
-     * @description Estimate the total cost for N calls through the subnetwork.
-     * @param {SubnetworkResult} subnet - Built subnetwork
-     * @param {number} calls - Number of calls to estimate for
-     * @returns {{ totalCost: bigint; perAgent: Array<{ agent: string; cost: bigint }> }}
-     * @since 1.4.0
-     */
-    estimateCost(subnet, calls) {
-        const perAgent = new Map();
-        for (const assignment of subnet.assignments) {
-            const key = assignment.agent.walletPubkey;
-            const current = perAgent.get(key) ?? 0n;
-            perAgent.set(key, current + assignment.pricing.pricePerCall * BigInt(calls));
-        }
-        const totalCost = [...perAgent.values()].reduce((a, b) => a + b, 0n);
-        return {
-            totalCost,
-            perAgent: [...perAgent.entries()].map(([agent, cost]) => ({ agent, cost })),
-        };
-    }
-    /* ── Internal scoring ── */
-    scoreAgent(agent, strategy, pricingTier, preferMultiCapable, requiredCapabilities, alreadyAssigned) {
-        const pricing = this.findPricing(agent, pricingTier);
-        const priceNorm = pricing
-            ? 1 - Math.min(Number(pricing.pricePerCall) / 100000, 1) // lower price → higher score
-            : 0;
-        const repNorm = agent.reputation.score / 1000;
-        const latNorm = 1 - Math.min(agent.reputation.avgLatencyMs / 10000, 1);
-        const uptimeNorm = agent.reputation.uptimePercent / 100;
-        let score;
-        switch (strategy) {
-            case 'cheapest':
-                score = priceNorm * 0.7 + repNorm * 0.15 + uptimeNorm * 0.15;
-                break;
-            case 'reputable':
-                score = repNorm * 0.6 + uptimeNorm * 0.25 + latNorm * 0.15;
-                break;
-            case 'fastest':
-                score = latNorm * 0.6 + uptimeNorm * 0.2 + repNorm * 0.2;
-                break;
-            case 'balanced':
-            default:
-                score = repNorm * 0.3 + priceNorm * 0.25 + latNorm * 0.2 + uptimeNorm * 0.25;
-                break;
-        }
-        // Bonus: agent already in the subnetwork (reduces hop count)
-        if (alreadyAssigned.has(agent.walletPubkey)) {
-            score += 0.15;
-        }
-        // Bonus: agent covers multiple required capabilities
-        if (preferMultiCapable) {
-            const coverage = requiredCapabilities.filter(cap => agent.capabilities.some(c => c.id === cap)).length;
-            if (coverage > 1) {
-                score += 0.1 * (coverage - 1);
-            }
-        }
-        return score;
-    }
-    findPricing(agent, tierId) {
-        return agent.pricing.find(p => p.tierId === tierId) ?? agent.pricing[0];
-    }
-}
-//# sourceMappingURL=subnetwork.js.map

package/dist/esm/ai/sap/subnetwork.js.map

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

package/dist/esm/ai/sap/validator.d.ts

@@ -1,160 +0,0 @@
-/**
- * @module ai/sap/validator
- * @description SAP — Deep validation engine for agent registration & updates.
- *
- * Goes far beyond the basic name/description length checks: validates
- * capability ID format, pricing consistency, wallet pubkey format,
- * URL structure, duplicate detection, and cross-field coherence.
- *
- * Can operate in **strict** mode (throws on first error) or **lenient**
- * mode (collects all issues and returns a report).
- *
- * @example
- * ```ts
- * import { SAPValidator } from '@oobe-protocol-labs/synapse-client-sdk/ai/sap';
- *
- * const validator = new SAPValidator({ strict: false });
- * const report = validator.validateRegistration({
- *   walletPubkey: 'ABC...',
- *   name: 'My Agent',
- *   description: 'Tools',
- *   capabilities: [{ id: 'bad_format' }],  // ← will flag this
- *   pricing: [{ tierId: '', pricePerCall: 0n, rateLimit: -1, ... }],
- * });
- *
- * if (!report.valid) {
- *   console.error(report.errors);   // detailed error list
- *   console.warn(report.warnings);  // non-fatal suggestions
- * }
- * ```
- *
- * @since 1.4.0
- */
-import type { RegisterAgentParams, UpdateAgentParams, AgentCapability, AgentPricingOnChain } from './types';
-import { SAPCapabilityRegistry } from './registry';
-/**
- * @description Severity of a validation finding.
- * @since 1.4.0
- */
-export type ValidationSeverity = 'error' | 'warning' | 'info';
-/**
- * @description A single validation finding.
- * @since 1.4.0
- */
-export interface ValidationIssue {
-    /** Severity level. */
-    severity: ValidationSeverity;
-    /** Machine-readable error code. */
-    code: string;
-    /** Human-readable message. */
-    message: string;
-    /** The field path that triggered the issue (e.g. `"capabilities[2].id"`). */
-    field?: string;
-    /** The offending value. */
-    value?: unknown;
-}
-/**
- * @description Complete validation report.
- * @since 1.4.0
- */
-export interface ValidationReport {
-    /** `true` if zero errors (warnings/info are OK). */
-    valid: boolean;
-    /** Error-severity issues (block registration). */
-    errors: ValidationIssue[];
-    /** Warning-severity issues (allow but flag). */
-    warnings: ValidationIssue[];
-    /** Informational notes. */
-    info: ValidationIssue[];
-    /** Total time spent validating (ms). */
-    durationMs: number;
-}
-/**
- * @description Error thrown in strict mode when validation fails.
- * @since 1.4.0
- */
-export declare class SAPValidationError extends Error {
-    readonly code: string;
-    readonly issues: ValidationIssue[];
-    constructor(message: string, code: string, issues: ValidationIssue[]);
-}
-/**
- * @description Validator configuration.
- * @since 1.4.0
- */
-export interface SAPValidatorConfig {
-    /** Throw on first error (default: `false` → collect all). */
-    strict?: boolean;
-    /** Capability registry for validating capability IDs. If omitted, uses default. */
-    registry?: SAPCapabilityRegistry;
-    /** Allow unrecognised capability IDs (default: `true` — warn but don't error). */
-    allowUnknownCapabilities?: boolean;
-    /** Maximum number of capabilities per agent (default: 50). */
-    maxCapabilities?: number;
-    /** Maximum number of pricing tiers per agent (default: 10). */
-    maxPricingTiers?: number;
-}
-/**
- * @description Deep validation engine for SAP agent data.
- *
- * Checks performed:
- * - **Wallet pubkey**: Base58, 32–44 chars, valid character set
- * - **Name**: Non-empty, ≤ 64 UTF-8 bytes, no control characters
- * - **Description**: Non-empty, ≤ 512 UTF-8 bytes
- * - **Capabilities**: `protocol:method` format, no duplicates, max count,
- *   registry check (known vs unknown)
- * - **Pricing**: Non-empty tierId, positive pricePerCall, rateLimit > 0,
- *   maxCallsPerSession ≥ 0, valid tokenType, no duplicate tiers,
- *   SPL requires tokenMint
- * - **x402 Endpoint**: Must be HTTPS, valid URL structure
- * - **Cross-field**: At least one capability for each pricing tier's
- *   implied protocol (warning)
- *
- * @since 1.4.0
- */
-export declare class SAPValidator {
-    private readonly config;
-    constructor(config?: SAPValidatorConfig);
-    /**
-     * @description Validate a full registration payload.
-     * @param {RegisterAgentParams} params - Registration parameters
-     * @returns {ValidationReport}
-     * @throws {SAPValidationError} In strict mode, on first error
-     * @since 1.4.0
-     */
-    validateRegistration(params: RegisterAgentParams): ValidationReport;
-    /**
-     * @description Validate an update payload.
-     * Only validates fields that are present (non-undefined).
-     * @param {UpdateAgentParams} params - Update parameters
-     * @returns {ValidationReport}
-     * @throws {SAPValidationError} In strict mode, on first error
-     * @since 1.4.0
-     */
-    validateUpdate(params: UpdateAgentParams): ValidationReport;
-    /**
-     * @description Validate a single capability entry.
-     * @param {AgentCapability} cap - Capability to validate
-     * @returns {ValidationReport}
-     * @since 1.4.0
-     */
-    validateCapability(cap: AgentCapability): ValidationReport;
-    /**
-     * @description Validate a single pricing tier.
-     * @param {AgentPricingOnChain} tier - Pricing tier to validate
-     * @returns {ValidationReport}
-     * @since 1.4.0
-     */
-    validatePricingTier(tier: AgentPricingOnChain): ValidationReport;
-    private validateWalletPubkey;
-    private validateName;
-    private validateDescription;
-    private validateCapabilities;
-    private checkCapability;
-    private validatePricing;
-    private checkPricingTier;
-    private validateX402Endpoint;
-    private validateCrossField;
-    private buildReport;
-}
-//# sourceMappingURL=validator.d.ts.map

package/dist/esm/ai/sap/validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/ai/sap/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,eAAe,EAAE;gBAFzC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EAAE;CAK5C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,kFAAkF;IAClF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAE1C,MAAM,CAAC,EAAE,kBAAkB;IAYvC;;;;;;OAMG;IACH,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB;IAmCnE;;;;;;;OAOG;IACH,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB;IAe3D;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,gBAAgB;IAO1D;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB;IAShE,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,YAAY;IA2DpB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,oBAAoB;IAoE5B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,gBAAgB;IAgHxB,OAAO,CAAC,oBAAoB;IAgD5B,OAAO,CAAC,kBAAkB;IAsC1B,OAAO,CAAC,WAAW;CAyBpB"}