@agirails/sdk 2.0.0 → 2.0.1-beta

package/dist/level0/ServiceDirectory.js

@@ -1,122 +0,0 @@
-"use strict";
-/**
- * ServiceDirectory - Hardcoded provider mapping for MVP
- *
- * In MVP, we use hardcoded service-to-provider mapping.
- * In V2+, this will be replaced by on-chain AgentRegistry queries.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serviceDirectory = void 0;
-const security_1 = require("../utils/security");
-/**
- * In-memory service directory
- *
- * Maps service names to provider addresses.
- * This is a singleton that can be updated by provide() calls.
- *
- * SECURITY FIXES:
- * - H-5: Address validation to prevent poisoning
- * - H-2: Service name validation
- */
-class ServiceDirectory {
-    constructor() {
-        /**
-         * Service -> Provider address mapping
-         */
-        this.directory = new Map();
-    }
-    /**
-     * Register a provider for a service
-     *
-     * SECURITY FIX (H-5): Validate address format before registration
-     * SECURITY FIX (H-2): Validate service name
-     *
-     * @param service - Service name
-     * @param provider - Provider address
-     * @throws Error if service name or provider address is invalid
-     */
-    register(service, provider) {
-        // SECURITY FIX (H-2): Validate service name
-        const validatedService = (0, security_1.validateServiceName)(service);
-        // SECURITY FIX (H-5): Validate Ethereum address format
-        if (!(0, security_1.isValidAddress)(provider)) {
-            throw new Error(`Invalid provider address: "${provider}". Must be a valid Ethereum address (0x followed by 40 hex characters).`);
-        }
-        if (!this.directory.has(validatedService)) {
-            this.directory.set(validatedService, new Set());
-        }
-        this.directory.get(validatedService).add(provider);
-    }
-    /**
-     * Unregister a provider from a service
-     *
-     * SECURITY FIX (H-5): Validate address format
-     * SECURITY FIX (H-2): Validate service name
-     *
-     * @param service - Service name
-     * @param provider - Provider address
-     */
-    unregister(service, provider) {
-        // SECURITY FIX (H-2): Validate service name
-        const validatedService = (0, security_1.validateServiceName)(service);
-        // SECURITY FIX (H-5): Validate address format
-        if (!(0, security_1.isValidAddress)(provider)) {
-            throw new Error(`Invalid provider address: "${provider}"`);
-        }
-        const providers = this.directory.get(validatedService);
-        if (providers) {
-            providers.delete(provider);
-            if (providers.size === 0) {
-                this.directory.delete(validatedService);
-            }
-        }
-    }
-    /**
-     * Find providers for a service
-     *
-     * SECURITY FIX (H-2): Validate service name
-     *
-     * @param service - Service name
-     * @returns Array of provider addresses
-     */
-    findProviders(service) {
-        // SECURITY FIX (H-2): Validate service name
-        try {
-            const validatedService = (0, security_1.validateServiceName)(service);
-            const providers = this.directory.get(validatedService);
-            return providers ? Array.from(providers) : [];
-        }
-        catch (error) {
-            // If service name is invalid, return empty array instead of throwing
-            // This allows graceful degradation in search scenarios
-            return [];
-        }
-    }
-    /**
-     * Get all registered services
-     *
-     * @returns Array of service names
-     */
-    getServices() {
-        return Array.from(this.directory.keys());
-    }
-    /**
-     * Clear all registrations
-     */
-    clear() {
-        this.directory.clear();
-    }
-    /**
-     * Get directory size (for debugging)
-     */
-    get size() {
-        return this.directory.size;
-    }
-}
-/**
- * Singleton instance
- */
-exports.serviceDirectory = new ServiceDirectory();
-//# sourceMappingURL=ServiceDirectory.js.map

package/dist/level0/ServiceDirectory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ServiceDirectory.js","sourceRoot":"","sources":["../../src/level0/ServiceDirectory.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,gDAAwE;AAExE;;;;;;;;;GASG;AACH,MAAM,gBAAgB;IAAtB;QACE;;WAEG;QACK,cAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IAoGrD,CAAC;IAlGC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAe,EAAE,QAAgB;QACxC,4CAA4C;QAC5C,MAAM,gBAAgB,GAAG,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC;QAEtD,uDAAuD;QACvD,IAAI,CAAC,IAAA,yBAAc,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,yEAAyE,CAChH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAe,EAAE,QAAgB;QAC1C,4CAA4C;QAC5C,MAAM,gBAAgB,GAAG,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC;QAEtD,8CAA8C;QAC9C,IAAI,CAAC,IAAA,yBAAc,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACvD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,OAAe;QAC3B,4CAA4C;QAC5C,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACvD,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qEAAqE;YACrE,uDAAuD;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACU,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/level0/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Basic API - Simple service provision and requests
- *
- * @packageDocumentation
- */
-export { provide } from './provide';
-export { request } from './request';
-export { Provider, ProviderStatus, ProviderStats, ProviderBalance } from './Provider';
-export { serviceDirectory } from './ServiceDirectory';
-//# sourceMappingURL=index.d.ts.map

package/dist/level0/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/level0/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/level0/index.js

@@ -1,15 +0,0 @@
-"use strict";
-/**
- * Basic API - Simple service provision and requests
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serviceDirectory = exports.request = exports.provide = void 0;
-var provide_1 = require("./provide");
-Object.defineProperty(exports, "provide", { enumerable: true, get: function () { return provide_1.provide; } });
-var request_1 = require("./request");
-Object.defineProperty(exports, "request", { enumerable: true, get: function () { return request_1.request; } });
-var ServiceDirectory_1 = require("./ServiceDirectory");
-Object.defineProperty(exports, "serviceDirectory", { enumerable: true, get: function () { return ServiceDirectory_1.serviceDirectory; } });
-//# sourceMappingURL=index.js.map

package/dist/level0/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/level0/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAEhB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/level0/provide.d.ts

@@ -1,51 +0,0 @@
-/**
- * provide() - Basic API for service providers
- *
- * The simplest way to provide a service on AGIRAILS.
- * Just write a function, and AGIRAILS handles the rest.
- *
- * @packageDocumentation
- */
-import { JobHandler } from '../level1/types/Job';
-import { ProvideOptions } from '../level1/types/Options';
-import { Provider } from './Provider';
-/**
- * Provide a service
- *
- * This is the simplest way to provide a service on AGIRAILS.
- * You provide a service name and a handler function, and AGIRAILS
- * takes care of wallet management, transactions, and payments.
- *
- * @param service - Service name (e.g., 'translation', 'echo')
- * @param handler - Job handler function
- * @param options - Optional configuration
- * @returns Provider interface for lifecycle control
- *
- * @example
- * ```typescript
- * // Simplest example
- * provide('echo', async (job) => {
- *   return job.input;
- * });
- *
- * // With filtering
- * provide('translation', async (job) => {
- *   const { text, from, to } = job.input;
- *   return { translated: await translate(text, from, to) };
- * }, {
- *   filter: { minBudget: 5 },
- *   network: 'testnet'
- * });
- *
- * // With events
- * const provider = provide('image-gen', async (job) => {
- *   return { imageUrl: await generateImage(job.input.prompt) };
- * });
- *
- * provider.on('payment:received', (amount) => {
- *   console.log(`Earned ${amount} USDC!`);
- * });
- * ```
- */
-export declare function provide(service: string, handler: JobHandler, options?: ProvideOptions): Provider;
-//# sourceMappingURL=provide.d.ts.map

package/dist/level0/provide.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provide.d.ts","sourceRoot":"","sources":["../../src/level0/provide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,QAAQ,CAyEV"}

package/dist/level0/provide.js

@@ -1,113 +0,0 @@
-"use strict";
-/**
- * provide() - Basic API for service providers
- *
- * The simplest way to provide a service on AGIRAILS.
- * Just write a function, and AGIRAILS handles the rest.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.provide = void 0;
-const Agent_1 = require("../level1/Agent");
-const ServiceDirectory_1 = require("./ServiceDirectory");
-/**
- * Provide a service
- *
- * This is the simplest way to provide a service on AGIRAILS.
- * You provide a service name and a handler function, and AGIRAILS
- * takes care of wallet management, transactions, and payments.
- *
- * @param service - Service name (e.g., 'translation', 'echo')
- * @param handler - Job handler function
- * @param options - Optional configuration
- * @returns Provider interface for lifecycle control
- *
- * @example
- * ```typescript
- * // Simplest example
- * provide('echo', async (job) => {
- *   return job.input;
- * });
- *
- * // With filtering
- * provide('translation', async (job) => {
- *   const { text, from, to } = job.input;
- *   return { translated: await translate(text, from, to) };
- * }, {
- *   filter: { minBudget: 5 },
- *   network: 'testnet'
- * });
- *
- * // With events
- * const provider = provide('image-gen', async (job) => {
- *   return { imageUrl: await generateImage(job.input.prompt) };
- * });
- *
- * provider.on('payment:received', (amount) => {
- *   console.log(`Earned ${amount} USDC!`);
- * });
- * ```
- */
-function provide(service, handler, options) {
-    // Create an Agent instance under the hood
-    const agent = new Agent_1.Agent({
-        name: `Provider:${service}`,
-        description: `Auto-generated provider for ${service}`,
-        network: options?.network || 'mock',
-        wallet: options?.wallet,
-        stateDirectory: options?.stateDirectory,
-        rpcUrl: options?.rpcUrl,
-        behavior: {
-            autoAccept: options?.autoAccept ?? true,
-        },
-    });
-    // Register the service with filter options
-    agent.provide({
-        name: service,
-        filter: options?.filter,
-    }, handler);
-    // Start the agent immediately (async)
-    agent.start().then(() => {
-        // Register in service directory after agent has started and has an address
-        ServiceDirectory_1.serviceDirectory.register(service, agent.address);
-    }).catch((error) => {
-        console.error(`Failed to start provider for ${service}:`, error);
-    });
-    // Return Provider interface (adapter over Agent)
-    const provider = {
-        get status() {
-            return agent.status;
-        },
-        get address() {
-            return agent.address;
-        },
-        get balance() {
-            return agent.balance;
-        },
-        pause() {
-            agent.pause();
-        },
-        resume() {
-            agent.resume();
-        },
-        async stop() {
-            await agent.stop();
-            ServiceDirectory_1.serviceDirectory.unregister(service, agent.address);
-        },
-        on(event, handler) {
-            agent.on(event, handler);
-        },
-        get stats() {
-            return {
-                jobsCompleted: agent.stats.jobsCompleted,
-                jobsFailed: agent.stats.jobsFailed,
-                totalEarned: agent.stats.totalEarned,
-                averageJobTime: agent.stats.averageJobTime,
-            };
-        },
-    };
-    return provider;
-}
-exports.provide = provide;
-//# sourceMappingURL=provide.js.map

package/dist/level0/provide.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"provide.js","sourceRoot":"","sources":["../../src/level0/provide.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,2CAAwC;AAIxC,yDAAsD;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAgB,OAAO,CACrB,OAAe,EACf,OAAmB,EACnB,OAAwB;IAExB,0CAA0C;IAC1C,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC;QACtB,IAAI,EAAE,YAAY,OAAO,EAAE;QAC3B,WAAW,EAAE,+BAA+B,OAAO,EAAE;QACrD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM;QACnC,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,cAAc,EAAE,OAAO,EAAE,cAAc;QACvC,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,QAAQ,EAAE;YACR,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;SACxC;KACF,CAAC,CAAC;IAEH,2CAA2C;IAC3C,KAAK,CAAC,OAAO,CACX;QACE,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,EACD,OAAO,CACR,CAAC;IAEF,sCAAsC;IACtC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACtB,2EAA2E;QAC3E,mCAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,QAAQ,GAAa;QACzB,IAAI,MAAM;YACR,OAAO,KAAK,CAAC,MAAa,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO;YACT,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,IAAI,OAAO;YACT,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,MAAM;YACJ,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,mCAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,EAAE,CAAC,KAAU,EAAE,OAAY;YACzB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,KAAK;YACP,OAAO;gBACL,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa;gBACxC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;gBAClC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;gBACpC,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc;aAC3C,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AA7ED,0BA6EC"}

package/dist/level0/request.d.ts

@@ -1,53 +0,0 @@
-/**
- * request() - Basic API for service requesters
- *
- * The simplest way to request a service from AGIRAILS.
- * Specify what you need and your budget, and AGIRAILS finds a provider.
- *
- * @packageDocumentation
- */
-import { RequestOptions, RequestResult } from '../level1/types/Options';
-/**
- * Request a service
- *
- * This is the simplest way to request a service on AGIRAILS.
- * Specify the service name, input data, and budget, and AGIRAILS
- * handles finding a provider, creating the transaction, and delivering the result.
- *
- * @param service - Service name (e.g., 'translation', 'echo')
- * @param options - Request options (input, budget, etc.)
- * @returns Promise resolving to request result
- *
- * @throws {NoProviderFoundError} If no provider is found for the service
- * @throws {TimeoutError} If provider doesn't respond within timeout
- * @throws {ProviderRejectedError} If provider rejects the job
- * @throws {DeliveryFailedError} If provider fails to deliver result
- *
- * @example
- * ```typescript
- * // Simplest example
- * const { result } = await request('echo', {
- *   input: 'Hello, AGIRAILS!',
- *   budget: 1
- * });
- * console.log(result); // 'Hello, AGIRAILS!'
- *
- * // With progress callback
- * const { result } = await request('translation', {
- *   input: { text: 'Hello', from: 'en', to: 'de' },
- *   budget: 5,
- *   onProgress: (status) => {
- *     console.log(`${status.state}: ${status.progress}%`);
- *   }
- * });
- *
- * // With specific provider
- * const { result } = await request('image-gen', {
- *   input: { prompt: 'A beautiful sunset' },
- *   budget: 10,
- *   provider: '0x1234...abcd'
- * });
- * ```
- */
-export declare function request(service: string, options: RequestOptions): Promise<RequestResult>;
-//# sourceMappingURL=request.d.ts.map

package/dist/level0/request.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/level0/request.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAoSxB"}