@agirails/sdk 2.0.1-beta → 2.0.2

package/dist/level0/provide.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,113 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,53 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}