agent0-sdk 0.2.1

package/dist/core/sdk.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Main SDK class for Agent0
+ */
+import { ethers } from 'ethers';
+import type { AgentSummary, Feedback, SearchParams } from '../models/interfaces';
+import type { AgentId, ChainId, Address, URI } from '../models/types';
+import { Web3Client } from './web3-client';
+import { IPFSClient } from './ipfs-client';
+import { SubgraphClient } from './subgraph-client';
+import { Agent } from './agent';
+export interface SDKConfig {
+    chainId: ChainId;
+    rpcUrl: string;
+    signer?: string;
+    registryOverrides?: Record<ChainId, Record<string, Address>>;
+    ipfs?: 'node' | 'filecoinPin' | 'pinata';
+    ipfsNodeUrl?: string;
+    filecoinPrivateKey?: string;
+    pinataJwt?: string;
+    subgraphUrl?: string;
+    subgraphOverrides?: Record<ChainId, string>;
+}
+/**
+ * Main SDK class for Agent0
+ */
+export declare class SDK {
+    private readonly _web3Client;
+    private _ipfsClient?;
+    private _subgraphClient?;
+    private readonly _feedbackManager;
+    private readonly _indexer;
+    private _identityRegistry?;
+    private _reputationRegistry?;
+    private _validationRegistry?;
+    private readonly _registries;
+    private readonly _chainId;
+    private readonly _subgraphUrls;
+    constructor(config: SDKConfig);
+    /**
+     * Initialize IPFS client based on configuration
+     */
+    private _initializeIpfsClient;
+    /**
+     * Get current chain ID
+     */
+    chainId(): Promise<ChainId>;
+    /**
+     * Get resolved registry addresses for current chain
+     */
+    registries(): Record<string, Address>;
+    /**
+     * Get identity registry contract
+     */
+    getIdentityRegistry(): ethers.Contract;
+    /**
+     * Get reputation registry contract
+     */
+    getReputationRegistry(): ethers.Contract;
+    /**
+     * Get validation registry contract
+     */
+    getValidationRegistry(): ethers.Contract;
+    /**
+     * Check if SDK is in read-only mode (no signer)
+     */
+    get isReadOnly(): boolean;
+    /**
+     * Create a new agent (off-chain object in memory)
+     */
+    createAgent(name: string, description: string, image?: URI): Agent;
+    /**
+     * Load an existing agent (hydrates from registration file if registered)
+     */
+    loadAgent(agentId: AgentId): Promise<Agent>;
+    /**
+     * Get agent summary from subgraph (read-only)
+     */
+    getAgent(agentId: AgentId): Promise<AgentSummary | null>;
+    /**
+     * Search agents with filters
+     */
+    searchAgents(params?: SearchParams, sort?: string[], pageSize?: number, cursor?: string): Promise<{
+        items: AgentSummary[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Search agents by reputation
+     */
+    searchAgentsByReputation(agents?: AgentId[], tags?: string[], reviewers?: Address[], capabilities?: string[], skills?: string[], tasks?: string[], names?: string[], minAverageScore?: number, includeRevoked?: boolean, pageSize?: number, cursor?: string, sort?: string[]): Promise<{
+        items: AgentSummary[];
+        nextCursor?: string;
+    }>;
+    /**
+     * Transfer agent ownership
+     */
+    transferAgent(agentId: AgentId, newOwner: Address): Promise<{
+        txHash: string;
+        from: Address;
+        to: Address;
+        agentId: AgentId;
+    }>;
+    /**
+     * Check if address is agent owner
+     */
+    isAgentOwner(agentId: AgentId, address: Address): Promise<boolean>;
+    /**
+     * Get agent owner
+     */
+    getAgentOwner(agentId: AgentId): Promise<Address>;
+    /**
+     * Sign feedback authorization for a client
+     */
+    signFeedbackAuth(agentId: AgentId, clientAddress: Address, indexLimit?: number, expiryHours?: number): Promise<string>;
+    /**
+     * Prepare feedback file
+     */
+    prepareFeedback(agentId: AgentId, score?: number, 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
+     */
+    giveFeedback(agentId: AgentId, feedbackFile: Record<string, unknown>, feedbackAuth?: string): Promise<Feedback>;
+    /**
+     * Read feedback
+     */
+    getFeedback(agentId: AgentId, clientAddress: Address, feedbackIndex: number): Promise<Feedback>;
+    /**
+     * Search feedback
+     */
+    searchFeedback(agentId: AgentId, tags?: string[], capabilities?: string[], skills?: string[], minScore?: number, maxScore?: number): Promise<Feedback[]>;
+    /**
+     * Append response to feedback
+     */
+    appendResponse(agentId: AgentId, clientAddress: Address, feedbackIndex: number, response: {
+        uri: URI;
+        hash: string;
+    }): Promise<string>;
+    /**
+     * Revoke feedback
+     */
+    revokeFeedback(agentId: AgentId, feedbackIndex: number): Promise<string>;
+    /**
+     * Get reputation summary
+     */
+    getReputationSummary(agentId: AgentId, tag1?: string, tag2?: string): Promise<{
+        count: number;
+        averageScore: number;
+    }>;
+    /**
+     * Create an empty registration file structure
+     */
+    private _createEmptyRegistrationFile;
+    /**
+     * Private helper methods
+     */
+    private _loadRegistrationFile;
+    /**
+     * Transform raw registration file (from IPFS/HTTP) to RegistrationFile format
+     * Accepts raw JSON data which may have legacy format or new format
+     */
+    private _transformRegistrationFile;
+    /**
+     * Transform endpoints from old format { name, endpoint, version } to new format { type, value, meta }
+     */
+    private _transformEndpoints;
+    /**
+     * Transform a single endpoint from legacy format
+     */
+    private _transformEndpointLegacy;
+    /**
+     * Extract wallet address and chain ID from raw data
+     */
+    private _extractWalletInfo;
+    get web3Client(): Web3Client;
+    get ipfsClient(): IPFSClient | undefined;
+    get subgraphClient(): SubgraphClient | undefined;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/core/sdk.d.ts.map

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