@quantulabs/8004-mcp 0.1.0

package/dist/core/cache/sync-manager.js

@@ -0,0 +1,213 @@
+// Background sync manager for cache
+const DEFAULT_CONFIG = {
+    syncIntervalMs: 5 * 60 * 1000, // 5 minutes
+    minSyncIntervalMs: 30 * 1000, // 30 seconds minimum between syncs
+    maxRetries: 3,
+};
+export class SyncManager {
+    store;
+    dataSources = new Map();
+    config;
+    progress = new Map();
+    syncInterval = null;
+    isSyncing = false;
+    constructor(store, config) {
+        this.store = store;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    registerDataSource(dataSource) {
+        this.dataSources.set(dataSource.sourceId, dataSource);
+        this.progress.set(dataSource.sourceId, {
+            sourceId: dataSource.sourceId,
+            status: 'idle',
+            progress: 0,
+        });
+    }
+    unregisterDataSource(sourceId) {
+        this.dataSources.delete(sourceId);
+        this.progress.delete(sourceId);
+    }
+    getProgress(sourceId) {
+        if (sourceId) {
+            return this.progress.get(sourceId) ?? {
+                sourceId,
+                status: 'idle',
+                progress: 0,
+            };
+        }
+        return this.progress;
+    }
+    startBackgroundSync() {
+        if (this.syncInterval)
+            return;
+        this.syncInterval = setInterval(() => {
+            void this.syncAll();
+        }, this.config.syncIntervalMs);
+        // Initial sync
+        void this.syncAll();
+    }
+    stopBackgroundSync() {
+        if (this.syncInterval) {
+            clearInterval(this.syncInterval);
+            this.syncInterval = null;
+        }
+    }
+    async syncAll(options) {
+        if (this.isSyncing && !options?.force) {
+            return this.progress;
+        }
+        this.isSyncing = true;
+        const results = new Map();
+        for (const [sourceId, dataSource] of this.dataSources) {
+            try {
+                const result = await this.syncSource(sourceId, dataSource, options);
+                results.set(sourceId, result);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                results.set(sourceId, {
+                    sourceId,
+                    status: 'error',
+                    progress: 0,
+                    error: errorMessage,
+                });
+            }
+        }
+        this.isSyncing = false;
+        return results;
+    }
+    async syncSource(sourceId, dataSource, options) {
+        const source = dataSource ?? this.dataSources.get(sourceId);
+        if (!source) {
+            return {
+                sourceId,
+                status: 'error',
+                progress: 0,
+                error: `Data source not found: ${sourceId}`,
+            };
+        }
+        // Check rate limiting
+        if (!options?.force) {
+            const syncState = this.store.getSyncState(sourceId);
+            if (syncState?.last_timestamp) {
+                const elapsed = Date.now() - syncState.last_timestamp;
+                if (elapsed < this.config.minSyncIntervalMs) {
+                    return {
+                        sourceId,
+                        status: 'idle',
+                        progress: 100,
+                        total: syncState.total_agents ?? undefined,
+                    };
+                }
+            }
+        }
+        // Check availability
+        const available = await source.isAvailable();
+        if (!available) {
+            const progress = {
+                sourceId,
+                status: 'error',
+                progress: 0,
+                error: 'Data source not available',
+            };
+            this.progress.set(sourceId, progress);
+            return progress;
+        }
+        // Start sync
+        const startedAt = Date.now();
+        let progress = {
+            sourceId,
+            status: 'syncing',
+            progress: 0,
+            startedAt,
+        };
+        this.progress.set(sourceId, progress);
+        this.store.updateSyncState(sourceId, {
+            chain_prefix: source.chainPrefix,
+            status: 'syncing',
+        });
+        try {
+            // Get last sync state
+            const syncState = this.store.getSyncState(sourceId);
+            let cursor = options?.force ? undefined : syncState?.last_cursor ?? undefined;
+            const updatedSince = options?.force ? undefined : syncState?.last_timestamp ?? undefined;
+            // Get total for progress calculation
+            const total = await source.getTotalCount();
+            let synced = 0;
+            // Fetch batches
+            let hasMore = true;
+            let retries = 0;
+            while (hasMore) {
+                try {
+                    const batch = await source.fetchBatch({
+                        cursor,
+                        updatedSince,
+                        limit: options?.batchSize ?? 1000,
+                    });
+                    if (batch.agents.length > 0) {
+                        this.store.upsertAgentsBatch(batch.agents);
+                        synced += batch.agents.length;
+                    }
+                    cursor = batch.cursor;
+                    hasMore = batch.hasMore;
+                    // Update progress
+                    progress = {
+                        ...progress,
+                        progress: total > 0 ? Math.min(100, Math.round((synced / total) * 100)) : 0,
+                        total,
+                        synced,
+                    };
+                    this.progress.set(sourceId, progress);
+                    retries = 0;
+                }
+                catch (error) {
+                    retries++;
+                    if (retries >= this.config.maxRetries) {
+                        throw error;
+                    }
+                    // Wait before retry
+                    await new Promise(resolve => setTimeout(resolve, 1000 * retries));
+                }
+            }
+            // Sync completed
+            const completedAt = Date.now();
+            progress = {
+                sourceId,
+                status: 'completed',
+                progress: 100,
+                total,
+                synced,
+                startedAt,
+                completedAt,
+            };
+            this.progress.set(sourceId, progress);
+            this.store.updateSyncState(sourceId, {
+                chain_prefix: source.chainPrefix,
+                last_cursor: cursor,
+                last_timestamp: completedAt,
+                total_agents: total,
+                status: 'idle',
+                error_message: null,
+            });
+            return progress;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            progress = {
+                sourceId,
+                status: 'error',
+                progress: progress.progress,
+                error: errorMessage,
+                startedAt,
+            };
+            this.progress.set(sourceId, progress);
+            this.store.updateSyncState(sourceId, {
+                chain_prefix: source.chainPrefix,
+                status: 'error',
+                error_message: errorMessage,
+            });
+            return progress;
+        }
+    }
+}
+//# sourceMappingURL=sync-manager.js.map

package/dist/core/cache/sync-manager.js.map

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

package/dist/core/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp-error.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/core/errors/index.js

@@ -0,0 +1,2 @@
+export * from './mcp-error.js';
+//# sourceMappingURL=index.js.map

package/dist/core/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/core/errors/mcp-error.d.ts

@@ -0,0 +1,39 @@
+export declare enum McpErrorCode {
+    UNKNOWN = 1000,
+    INTERNAL = 1001,
+    INVALID_PARAMS = 1002,
+    NOT_FOUND = 1003,
+    TIMEOUT = 1004,
+    CHAIN_NOT_INITIALIZED = 2000,
+    CHAIN_NOT_FOUND = 2001,
+    CHAIN_NOT_READY = 2002,
+    CHAIN_WRITE_DISABLED = 2003,
+    CHAIN_CONNECTION_FAILED = 2004,
+    AGENT_NOT_FOUND = 3000,
+    AGENT_INVALID_ID = 3001,
+    AGENT_PARSE_ERROR = 3002,
+    FEEDBACK_NOT_FOUND = 4000,
+    FEEDBACK_INVALID_SCORE = 4001,
+    FEEDBACK_SUBMIT_FAILED = 4002,
+    CACHE_INIT_FAILED = 5000,
+    CACHE_QUERY_FAILED = 5001,
+    CACHE_SYNC_FAILED = 5002,
+    INDEXER_NOT_AVAILABLE = 6000,
+    INDEXER_QUERY_FAILED = 6001,
+    CONFIG_INVALID = 7000,
+    CONFIG_MISSING_REQUIRED = 7001
+}
+export declare class McpError extends Error {
+    readonly code: McpErrorCode;
+    readonly details?: Record<string, unknown>;
+    constructor(code: McpErrorCode, message: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+    static isNotFound(error: unknown): boolean;
+}
+export declare function notFoundError(resource: string, id: string): McpError;
+export declare function invalidParamsError(message: string, params?: Record<string, unknown>): McpError;
+export declare function chainNotReadyError(chainId: string): McpError;
+export declare function chainNotFoundError(chainId: string): McpError;
+export declare function agentNotFoundError(agentId: string): McpError;
+export declare function indexerNotAvailableError(chainId: string): McpError;
+//# sourceMappingURL=mcp-error.d.ts.map

package/dist/core/errors/mcp-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/mcp-error.ts"],"names":[],"mappings":"AAEA,oBAAY,YAAY;IAEtB,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,cAAc,OAAO;IACrB,SAAS,OAAO;IAChB,OAAO,OAAO;IAGd,qBAAqB,OAAO;IAC5B,eAAe,OAAO;IACtB,eAAe,OAAO;IACtB,oBAAoB,OAAO;IAC3B,uBAAuB,OAAO;IAG9B,eAAe,OAAO;IACtB,gBAAgB,OAAO;IACvB,iBAAiB,OAAO;IAGxB,kBAAkB,OAAO;IACzB,sBAAsB,OAAO;IAC7B,sBAAsB,OAAO;IAG7B,iBAAiB,OAAO;IACxB,kBAAkB,OAAO;IACzB,iBAAiB,OAAO;IAGxB,qBAAqB,OAAO;IAC5B,oBAAoB,OAAO;IAG3B,cAAc,OAAO;IACrB,uBAAuB,OAAO;CAC/B;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQlF,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASjC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAQ3C;AAGD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAMpE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAM9F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAM5D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAM5D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAM5D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAMlE"}

package/dist/core/errors/mcp-error.js

@@ -0,0 +1,79 @@
+// MCP error hierarchy
+export var McpErrorCode;
+(function (McpErrorCode) {
+    // General errors (1xxx)
+    McpErrorCode[McpErrorCode["UNKNOWN"] = 1000] = "UNKNOWN";
+    McpErrorCode[McpErrorCode["INTERNAL"] = 1001] = "INTERNAL";
+    McpErrorCode[McpErrorCode["INVALID_PARAMS"] = 1002] = "INVALID_PARAMS";
+    McpErrorCode[McpErrorCode["NOT_FOUND"] = 1003] = "NOT_FOUND";
+    McpErrorCode[McpErrorCode["TIMEOUT"] = 1004] = "TIMEOUT";
+    // Chain errors (2xxx)
+    McpErrorCode[McpErrorCode["CHAIN_NOT_INITIALIZED"] = 2000] = "CHAIN_NOT_INITIALIZED";
+    McpErrorCode[McpErrorCode["CHAIN_NOT_FOUND"] = 2001] = "CHAIN_NOT_FOUND";
+    McpErrorCode[McpErrorCode["CHAIN_NOT_READY"] = 2002] = "CHAIN_NOT_READY";
+    McpErrorCode[McpErrorCode["CHAIN_WRITE_DISABLED"] = 2003] = "CHAIN_WRITE_DISABLED";
+    McpErrorCode[McpErrorCode["CHAIN_CONNECTION_FAILED"] = 2004] = "CHAIN_CONNECTION_FAILED";
+    // Agent errors (3xxx)
+    McpErrorCode[McpErrorCode["AGENT_NOT_FOUND"] = 3000] = "AGENT_NOT_FOUND";
+    McpErrorCode[McpErrorCode["AGENT_INVALID_ID"] = 3001] = "AGENT_INVALID_ID";
+    McpErrorCode[McpErrorCode["AGENT_PARSE_ERROR"] = 3002] = "AGENT_PARSE_ERROR";
+    // Feedback errors (4xxx)
+    McpErrorCode[McpErrorCode["FEEDBACK_NOT_FOUND"] = 4000] = "FEEDBACK_NOT_FOUND";
+    McpErrorCode[McpErrorCode["FEEDBACK_INVALID_SCORE"] = 4001] = "FEEDBACK_INVALID_SCORE";
+    McpErrorCode[McpErrorCode["FEEDBACK_SUBMIT_FAILED"] = 4002] = "FEEDBACK_SUBMIT_FAILED";
+    // Cache errors (5xxx)
+    McpErrorCode[McpErrorCode["CACHE_INIT_FAILED"] = 5000] = "CACHE_INIT_FAILED";
+    McpErrorCode[McpErrorCode["CACHE_QUERY_FAILED"] = 5001] = "CACHE_QUERY_FAILED";
+    McpErrorCode[McpErrorCode["CACHE_SYNC_FAILED"] = 5002] = "CACHE_SYNC_FAILED";
+    // Indexer errors (6xxx)
+    McpErrorCode[McpErrorCode["INDEXER_NOT_AVAILABLE"] = 6000] = "INDEXER_NOT_AVAILABLE";
+    McpErrorCode[McpErrorCode["INDEXER_QUERY_FAILED"] = 6001] = "INDEXER_QUERY_FAILED";
+    // Config errors (7xxx)
+    McpErrorCode[McpErrorCode["CONFIG_INVALID"] = 7000] = "CONFIG_INVALID";
+    McpErrorCode[McpErrorCode["CONFIG_MISSING_REQUIRED"] = 7001] = "CONFIG_MISSING_REQUIRED";
+})(McpErrorCode || (McpErrorCode = {}));
+export class McpError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'McpError';
+        this.code = code;
+        this.details = details;
+        Object.setPrototypeOf(this, McpError.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+    static isNotFound(error) {
+        return error instanceof McpError && (error.code === McpErrorCode.NOT_FOUND ||
+            error.code === McpErrorCode.AGENT_NOT_FOUND ||
+            error.code === McpErrorCode.FEEDBACK_NOT_FOUND ||
+            error.code === McpErrorCode.CHAIN_NOT_FOUND);
+    }
+}
+// Convenience error factories
+export function notFoundError(resource, id) {
+    return new McpError(McpErrorCode.NOT_FOUND, `${resource} not found: ${id}`, { resource, id });
+}
+export function invalidParamsError(message, params) {
+    return new McpError(McpErrorCode.INVALID_PARAMS, message, params);
+}
+export function chainNotReadyError(chainId) {
+    return new McpError(McpErrorCode.CHAIN_NOT_READY, `Chain not ready: ${chainId}`, { chainId });
+}
+export function chainNotFoundError(chainId) {
+    return new McpError(McpErrorCode.CHAIN_NOT_FOUND, `Chain not found: ${chainId}`, { chainId });
+}
+export function agentNotFoundError(agentId) {
+    return new McpError(McpErrorCode.AGENT_NOT_FOUND, `Agent not found: ${agentId}`, { agentId });
+}
+export function indexerNotAvailableError(chainId) {
+    return new McpError(McpErrorCode.INDEXER_NOT_AVAILABLE, `Indexer not available for chain: ${chainId}`, { chainId });
+}
+//# sourceMappingURL=mcp-error.js.map

package/dist/core/errors/mcp-error.js.map

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

package/dist/core/interfaces/agent.d.ts

@@ -0,0 +1,84 @@
+export type ChainType = 'solana' | 'evm';
+export type ChainPrefix = 'sol' | 'eth' | 'base' | 'arb' | 'poly' | 'op';
+export interface IGlobalId {
+    prefix: ChainPrefix;
+    chainType: ChainType;
+    chainId?: string;
+    rawId: string;
+}
+export interface IAgentEndpoint {
+    protocol: string;
+    url: string;
+    metadata?: Record<string, unknown>;
+}
+export interface IAgentMetadata {
+    skills?: string[];
+    tags?: string[];
+    version?: string;
+    [key: string]: unknown;
+}
+export interface IAgent {
+    id: string;
+    globalId: string;
+    chainType: ChainType;
+    chainPrefix: ChainPrefix;
+    chainId?: string;
+    name: string;
+    description?: string;
+    image?: string;
+    owner: string;
+    collection?: string;
+    metadata?: IAgentMetadata;
+    endpoints?: IAgentEndpoint[];
+    trustTier?: number;
+    qualityScore?: number;
+    totalFeedbacks?: number;
+    averageScore?: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface IAgentSummary {
+    id: string;
+    globalId: string;
+    chainType: ChainType;
+    chainPrefix: ChainPrefix;
+    name: string;
+    description?: string;
+    image?: string;
+    owner: string;
+    collection?: string;
+    trustTier?: number;
+    qualityScore?: number;
+    totalFeedbacks?: number;
+}
+export type SearchMode = 'name' | 'description' | 'endpoint' | 'all';
+export interface ISearchParams {
+    query?: string;
+    nameQuery?: string;
+    descriptionQuery?: string;
+    endpointQuery?: string;
+    searchMode?: SearchMode;
+    owner?: string;
+    collection?: string;
+    chainType?: ChainType;
+    chainPrefix?: ChainPrefix;
+    minQualityScore?: number;
+    minTrustTier?: number;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'name' | 'qualityScore' | 'totalFeedbacks' | 'createdAt' | 'updatedAt';
+    orderDir?: 'asc' | 'desc';
+}
+export interface ISearchResult {
+    results: IAgentSummary[];
+    total: number;
+    hasMore: boolean;
+    offset: number;
+    limit: number;
+}
+export declare function toGlobalId(chainPrefix: ChainPrefix, rawId: string, chainId?: string): string;
+export declare function parseGlobalId(id: string): IGlobalId;
+export declare function isValidGlobalId(id: string): boolean;
+export declare function getChainTypeFromPrefix(prefix: ChainPrefix): ChainType;
+export declare const CHAIN_PREFIX_PRIORITY: Record<ChainPrefix, number>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/interfaces/agent.d.ts.map

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

package/dist/core/interfaces/agent.js

@@ -0,0 +1,40 @@
+// Agent interfaces for multi-chain support
+// Global ID utilities
+export function toGlobalId(chainPrefix, rawId, chainId) {
+    if (chainId) {
+        return `${chainPrefix}:${chainId}:${rawId}`;
+    }
+    return `${chainPrefix}:${rawId}`;
+}
+export function parseGlobalId(id) {
+    const parts = id.split(':');
+    const prefix = parts[0];
+    const chainType = prefix === 'sol' ? 'solana' : 'evm';
+    if (chainType === 'solana') {
+        return { prefix, chainType, rawId: parts[1] ?? '' };
+    }
+    else {
+        return {
+            prefix,
+            chainType,
+            chainId: parts[1],
+            rawId: parts[2] ?? ''
+        };
+    }
+}
+export function isValidGlobalId(id) {
+    const parsed = parseGlobalId(id);
+    return !!parsed.prefix && !!parsed.rawId;
+}
+export function getChainTypeFromPrefix(prefix) {
+    return prefix === 'sol' ? 'solana' : 'evm';
+}
+export const CHAIN_PREFIX_PRIORITY = {
+    sol: 1,
+    base: 2,
+    eth: 3,
+    arb: 4,
+    poly: 5,
+    op: 6,
+};
+//# sourceMappingURL=agent.js.map

package/dist/core/interfaces/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/core/interfaces/agent.ts"],"names":[],"mappings":"AAAA,2CAA2C;AA4F3C,sBAAsB;AACtB,MAAM,UAAU,UAAU,CAAC,WAAwB,EAAE,KAAa,EAAE,OAAgB;IAClF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,GAAG,WAAW,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,WAAW,IAAI,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAgB,CAAC;IACvC,MAAM,SAAS,GAAc,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAEjE,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO;YACL,MAAM;YACN,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YACjB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,OAAO,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;CACN,CAAC"}

package/dist/core/interfaces/chain-provider.d.ts

@@ -0,0 +1,50 @@
+import type { ChainType, ChainPrefix, IAgent, ISearchParams, ISearchResult } from './agent.js';
+import type { IFeedback, IFeedbackInput, IFeedbackQuery, IFeedbackResult } from './feedback.js';
+import type { IReputationSummary, ILeaderboardOptions, ILeaderboardResult } from './reputation.js';
+export interface IChainConfig {
+    chainType: ChainType;
+    chainPrefix: ChainPrefix;
+    chainId?: string;
+    displayName: string;
+    rpcUrl: string;
+    indexerUrl?: string;
+    isDefault?: boolean;
+    priority?: number;
+}
+export interface IWriteOptions {
+    skipSend?: boolean;
+}
+export interface IUnsignedTransactionResult {
+    unsigned: true;
+    transaction: string;
+    message: string;
+}
+export interface ISignedTransactionResult {
+    unsigned: false;
+    signature: string;
+}
+export type ITransactionResult = IUnsignedTransactionResult | ISignedTransactionResult;
+export interface IChainProvider {
+    readonly chainType: ChainType;
+    readonly chainPrefix: ChainPrefix;
+    readonly chainId: string;
+    readonly displayName: string;
+    initialize(): Promise<void>;
+    isReady(): boolean;
+    canWrite(): boolean;
+    getConfig(): IChainConfig;
+    getAgent(agentId: string): Promise<IAgent | null>;
+    agentExists(agentId: string): Promise<boolean>;
+    searchAgents(params: ISearchParams): Promise<ISearchResult>;
+    getFeedback(agentId: string, client: string, index: bigint): Promise<IFeedback | null>;
+    listFeedbacks(query: IFeedbackQuery): Promise<IFeedbackResult>;
+    getReputationSummary(agentId: string): Promise<IReputationSummary | null>;
+    isIndexerAvailable?(): Promise<boolean>;
+    getLeaderboard?(options?: ILeaderboardOptions): Promise<ILeaderboardResult>;
+    giveFeedback?(input: IFeedbackInput, options?: IWriteOptions): Promise<ITransactionResult>;
+}
+export interface IWritableChainProvider extends IChainProvider {
+    giveFeedback(input: IFeedbackInput, options?: IWriteOptions): Promise<ITransactionResult>;
+}
+export declare function isWritableProvider(provider: IChainProvider): provider is IWritableChainProvider;
+//# sourceMappingURL=chain-provider.d.ts.map

package/dist/core/interfaces/chain-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-provider.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/chain-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,IAAI,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAG7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC;IACnB,QAAQ,IAAI,OAAO,CAAC;IACpB,SAAS,IAAI,YAAY,CAAC;IAG1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAG5D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACvF,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAG/D,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAG1E,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAI5E,YAAY,CAAC,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC3F;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,QAAQ,IAAI,sBAAsB,CAE/F"}

package/dist/core/interfaces/chain-provider.js

@@ -0,0 +1,5 @@
+// Chain provider interface for multi-chain support
+export function isWritableProvider(provider) {
+    return provider.canWrite() && typeof provider.giveFeedback === 'function';
+}
+//# sourceMappingURL=chain-provider.js.map

package/dist/core/interfaces/chain-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-provider.js","sourceRoot":"","sources":["../../../src/core/interfaces/chain-provider.ts"],"names":[],"mappings":"AAAA,mDAAmD;AA0EnD,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,UAAU,CAAC;AAC5E,CAAC"}

package/dist/core/interfaces/feedback.d.ts

@@ -0,0 +1,46 @@
+export interface IFeedback {
+    agentId: string;
+    client: string;
+    index: bigint;
+    /** Raw value (may not be available when reading from chain) */
+    value?: bigint;
+    /** Value decimals (may not be available when reading from chain) */
+    valueDecimals?: number;
+    /** Calculated score (0-100) */
+    score: number | null;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    comment?: string;
+    timestamp: number;
+    chainType: 'solana' | 'evm';
+}
+export interface IFeedbackInput {
+    agentId: string;
+    value: bigint | number;
+    valueDecimals?: number;
+    score?: number;
+    comment?: string;
+    tag1?: string;
+    tag2?: string;
+    endpoint?: string;
+    feedbackUri?: string;
+    feedbackHash?: Buffer;
+}
+export interface IFeedbackQuery {
+    agentId: string;
+    client?: string;
+    minScore?: number;
+    maxScore?: number;
+    includeRevoked?: boolean;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'timestamp' | 'score';
+    orderDir?: 'asc' | 'desc';
+}
+export interface IFeedbackResult {
+    feedbacks: IFeedback[];
+    total: number;
+    hasMore: boolean;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/core/interfaces/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/feedback.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/core/interfaces/feedback.js

@@ -0,0 +1,3 @@
+// Feedback interfaces for multi-chain support
+export {};
+//# sourceMappingURL=feedback.js.map

package/dist/core/interfaces/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../../src/core/interfaces/feedback.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

package/dist/core/interfaces/index.d.ts

@@ -0,0 +1,6 @@
+export * from './agent.js';
+export * from './feedback.js';
+export * from './reputation.js';
+export * from './chain-provider.js';
+export * from './x402.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}