agent0-sdk 0.2.1

package/dist/core/endpoint-crawler.js

@@ -0,0 +1,280 @@
+/**
+ * Endpoint Crawler for MCP and A2A Servers
+ * Automatically fetches capabilities (tools, prompts, resources, skills) from endpoints
+ */
+/**
+ * Helper to create JSON-RPC request
+ */
+function createJsonRpcRequest(method, params, requestId = 1) {
+    return {
+        jsonrpc: '2.0',
+        method,
+        id: requestId,
+        params: params || {},
+    };
+}
+/**
+ * Crawls MCP and A2A endpoints to fetch capabilities
+ */
+export class EndpointCrawler {
+    constructor(timeout = 5000) {
+        this.timeout = timeout;
+    }
+    /**
+     * Fetch MCP capabilities (tools, prompts, resources) from an MCP server
+     */
+    async fetchMcpCapabilities(endpoint) {
+        // Ensure endpoint is HTTP/HTTPS
+        if (!endpoint.startsWith('http://') && !endpoint.startsWith('https://')) {
+            // Invalid endpoint format - return null
+            return null;
+        }
+        // Try JSON-RPC approach first (for real MCP servers)
+        const capabilities = await this._fetchViaJsonRpc(endpoint);
+        if (capabilities) {
+            return capabilities;
+        }
+        // Fallback to static agentcard.json
+        try {
+            const agentcardUrl = `${endpoint}/agentcard.json`;
+            const response = await fetch(agentcardUrl, {
+                signal: AbortSignal.timeout(this.timeout),
+                redirect: 'follow',
+            });
+            if (response.ok) {
+                const data = await response.json();
+                // Extract capabilities from agentcard
+                const result = {
+                    mcpTools: this._extractList(data, 'tools'),
+                    mcpPrompts: this._extractList(data, 'prompts'),
+                    mcpResources: this._extractList(data, 'resources'),
+                };
+                if (result.mcpTools?.length || result.mcpPrompts?.length || result.mcpResources?.length) {
+                    return result;
+                }
+            }
+        }
+        catch (error) {
+            // Silently fail - soft failure pattern
+        }
+        return null;
+    }
+    /**
+     * Try to fetch capabilities via JSON-RPC
+     */
+    async _fetchViaJsonRpc(httpUrl) {
+        try {
+            // Make all JSON-RPC calls in parallel for better performance
+            const [tools, resources, prompts] = await Promise.all([
+                this._jsonRpcCall(httpUrl, 'tools/list'),
+                this._jsonRpcCall(httpUrl, 'resources/list'),
+                this._jsonRpcCall(httpUrl, 'prompts/list'),
+            ]);
+            const mcpTools = [];
+            const mcpResources = [];
+            const mcpPrompts = [];
+            // Extract names from tools
+            if (tools && typeof tools === 'object' && 'tools' in tools) {
+                const toolsArray = tools.tools;
+                if (Array.isArray(toolsArray)) {
+                    for (const tool of toolsArray) {
+                        if (tool && typeof tool === 'object' && 'name' in tool) {
+                            mcpTools.push(tool.name);
+                        }
+                    }
+                }
+            }
+            // Extract names from resources
+            if (resources && typeof resources === 'object' && 'resources' in resources) {
+                const resourcesArray = resources.resources;
+                if (Array.isArray(resourcesArray)) {
+                    for (const resource of resourcesArray) {
+                        if (resource && typeof resource === 'object' && 'name' in resource) {
+                            mcpResources.push(resource.name);
+                        }
+                    }
+                }
+            }
+            // Extract names from prompts
+            if (prompts && typeof prompts === 'object' && 'prompts' in prompts) {
+                const promptsArray = prompts.prompts;
+                if (Array.isArray(promptsArray)) {
+                    for (const prompt of promptsArray) {
+                        if (prompt && typeof prompt === 'object' && 'name' in prompt) {
+                            mcpPrompts.push(prompt.name);
+                        }
+                    }
+                }
+            }
+            if (mcpTools.length || mcpResources.length || mcpPrompts.length) {
+                return {
+                    mcpTools: mcpTools.length > 0 ? mcpTools : undefined,
+                    mcpResources: mcpResources.length > 0 ? mcpResources : undefined,
+                    mcpPrompts: mcpPrompts.length > 0 ? mcpPrompts : undefined,
+                };
+            }
+        }
+        catch (error) {
+            // JSON-RPC approach failed - continue to fallback
+        }
+        return null;
+    }
+    /**
+     * Make a JSON-RPC call and return the result
+     */
+    async _jsonRpcCall(url, method, params) {
+        try {
+            const payload = createJsonRpcRequest(method, params);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json, text/event-stream',
+                },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            // Check if response is SSE format
+            const contentType = response.headers.get('content-type') || '';
+            const text = await response.text();
+            if (contentType.includes('text/event-stream') || text.includes('event: message')) {
+                // Parse SSE format
+                const result = this._parseSseResponse(text);
+                if (result) {
+                    return result;
+                }
+            }
+            // Regular JSON response
+            const result = JSON.parse(text);
+            if (result.result !== undefined) {
+                return result.result;
+            }
+            return result;
+        }
+        catch (error) {
+            // JSON-RPC call failed - continue to next method
+            return null;
+        }
+    }
+    /**
+     * Parse Server-Sent Events (SSE) format response
+     */
+    _parseSseResponse(sseText) {
+        try {
+            // Look for "data:" lines containing JSON
+            const lines = sseText.split('\n');
+            for (const line of lines) {
+                if (line.startsWith('data: ')) {
+                    const jsonStr = line.slice(6); // Remove "data: " prefix
+                    const data = JSON.parse(jsonStr);
+                    if (data.result !== undefined) {
+                        return data.result;
+                    }
+                    return data;
+                }
+            }
+        }
+        catch (error) {
+            // Failed to parse SSE response - continue
+        }
+        return null;
+    }
+    /**
+     * Fetch A2A capabilities (skills) from an A2A server
+     */
+    async fetchA2aCapabilities(endpoint) {
+        try {
+            // Ensure endpoint is HTTP/HTTPS
+            if (!endpoint.startsWith('http://') && !endpoint.startsWith('https://')) {
+                // Invalid endpoint format - skip
+                return null;
+            }
+            // Try multiple well-known paths for A2A agent cards
+            const agentcardUrls = [
+                `${endpoint}/agentcard.json`,
+                `${endpoint}/.well-known/agent.json`,
+                `${endpoint.replace(/\/$/, '')}/.well-known/agent.json`,
+            ];
+            for (const agentcardUrl of agentcardUrls) {
+                try {
+                    const response = await fetch(agentcardUrl, {
+                        signal: AbortSignal.timeout(this.timeout),
+                        redirect: 'follow',
+                    });
+                    if (response.ok) {
+                        const data = await response.json();
+                        // Extract skills from agentcard
+                        const skills = this._extractList(data, 'skills');
+                        if (skills && skills.length > 0) {
+                            return { a2aSkills: skills };
+                        }
+                    }
+                }
+                catch {
+                    // Try next URL
+                    continue;
+                }
+            }
+        }
+        catch (error) {
+            // Unexpected error - continue silently
+        }
+        return null;
+    }
+    /**
+     * Extract a list of strings from nested JSON data
+     */
+    _extractList(data, key) {
+        const result = [];
+        // Try top-level key
+        if (key in data && Array.isArray(data[key])) {
+            for (const item of data[key]) {
+                if (typeof item === 'string') {
+                    result.push(item);
+                }
+                else if (item && typeof item === 'object') {
+                    // For objects, try to extract name/id field
+                    const nameFields = ['name', 'id', 'identifier', 'title'];
+                    for (const nameField of nameFields) {
+                        if (nameField in item && typeof item[nameField] === 'string') {
+                            result.push(item[nameField]);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        // Try nested in 'capabilities' or 'abilities'
+        if (result.length === 0) {
+            const containerKeys = ['capabilities', 'abilities', 'features'];
+            for (const containerKey of containerKeys) {
+                if (containerKey in data && data[containerKey] && typeof data[containerKey] === 'object') {
+                    if (key in data[containerKey] && Array.isArray(data[containerKey][key])) {
+                        for (const item of data[containerKey][key]) {
+                            if (typeof item === 'string') {
+                                result.push(item);
+                            }
+                            else if (item && typeof item === 'object') {
+                                const nameFields = ['name', 'id', 'identifier', 'title'];
+                                for (const nameField of nameFields) {
+                                    if (nameField in item && typeof item[nameField] === 'string') {
+                                        result.push(item[nameField]);
+                                        break;
+                                    }
+                                }
+                            }
+                        }
+                    }
+                    if (result.length > 0) {
+                        break;
+                    }
+                }
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=endpoint-crawler.js.map

package/dist/core/endpoint-crawler.js.map

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

package/dist/core/feedback-manager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Feedback management system for Agent0 SDK
+ */
+import { ethers } from 'ethers';
+import type { Feedback, SearchFeedbackParams } from '../models/interfaces';
+import type { AgentId, Address, URI, IdemKey } from '../models/types';
+import type { Web3Client } from './web3-client';
+import type { IPFSClient } from './ipfs-client';
+import type { SubgraphClient } from './subgraph-client';
+export interface FeedbackAuth {
+    agentId: bigint;
+    clientAddress: Address;
+    indexLimit: bigint;
+    expiry: bigint;
+    chainId: bigint;
+    identityRegistry: Address;
+    signerAddress: Address;
+}
+/**
+ * Manages feedback operations for the Agent0 SDK
+ */
+export declare class FeedbackManager {
+    private web3Client;
+    private ipfsClient?;
+    private reputationRegistry?;
+    private identityRegistry?;
+    private subgraphClient?;
+    constructor(web3Client: Web3Client, ipfsClient?: IPFSClient | undefined, reputationRegistry?: ethers.Contract | undefined, identityRegistry?: ethers.Contract | undefined, subgraphClient?: SubgraphClient | undefined);
+    /**
+     * Set reputation registry contract (for lazy initialization)
+     */
+    setReputationRegistry(registry: ethers.Contract): void;
+    /**
+     * Set identity registry contract (for lazy initialization)
+     */
+    setIdentityRegistry(registry: ethers.Contract): void;
+    /**
+     * Sign feedback authorization for a client
+     */
+    signFeedbackAuth(agentId: AgentId, clientAddress: Address, indexLimit?: number, expiryHours?: number): Promise<string>;
+    /**
+     * Prepare feedback file (local file/object) according to spec
+     */
+    prepareFeedback(agentId: AgentId, score?: number, // 0-100
+    tags?: string[], text?: string, capability?: string, name?: string, skill?: string, task?: string, context?: Record<string, unknown>, proofOfPayment?: Record<string, unknown>, extra?: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Give feedback (maps 8004 endpoint)
+     */
+    giveFeedback(agentId: AgentId, feedbackFile: Record<string, unknown>, idem?: IdemKey, feedbackAuth?: string): Promise<Feedback>;
+    /**
+     * Get single feedback with responses
+     * Currently only supports blockchain query - subgraph support coming soon
+     */
+    getFeedback(agentId: AgentId, clientAddress: Address, feedbackIndex: number): Promise<Feedback>;
+    /**
+     * Get feedback from blockchain
+     */
+    private _getFeedbackFromBlockchain;
+    /**
+     * Search feedback with filters
+     * Uses subgraph if available, otherwise returns empty array
+     */
+    searchFeedback(params: SearchFeedbackParams): Promise<Feedback[]>;
+    /**
+     * Map subgraph feedback data to Feedback model
+     */
+    private _mapSubgraphFeedbackToModel;
+    /**
+     * Convert hex bytes32 tags back to strings, or return plain strings as-is
+     * The subgraph now stores tags as human-readable strings (not hex),
+     * so this method handles both formats for backwards compatibility
+     */
+    private _hexBytes32ToTags;
+    /**
+     * Append response to feedback
+     */
+    appendResponse(agentId: AgentId, clientAddress: Address, feedbackIndex: number, responseUri: URI, responseHash: string): Promise<string>;
+    /**
+     * Revoke feedback
+     */
+    revokeFeedback(agentId: AgentId, feedbackIndex: number): Promise<string>;
+    /**
+     * Convert string to bytes32 for blockchain storage
+     */
+    private _stringToBytes32;
+    /**
+     * Convert bytes32 tags back to strings
+     */
+    private _bytes32ToTags;
+    /**
+     * Get reputation summary
+     */
+    getReputationSummary(agentId: AgentId, tag1?: string, tag2?: string): Promise<{
+        count: number;
+        averageScore: number;
+    }>;
+}
+//# sourceMappingURL=feedback-manager.d.ts.map

package/dist/core/feedback-manager.d.ts.map

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