@openserv-labs/client 1.1.4 → 2.0.0

package/README.md

@@ -145,12 +145,23 @@ await client.workflows.delete({ id: 789 })
 // Set workflow to running state
 await client.workflows.setRunning({ id: 789 })
 
-// Sync workflow configuration
+// Create a fully configured workflow with triggers, tasks, and auto-generated edges
+const pipeline = await client.workflows.create({
+  name: 'Data Pipeline',
+  goal: 'Process and analyze data',
+  triggers: [triggers.webhook({ waitForCompletion: true, timeout: 300 })],
+  tasks: [
+    { name: 'ingest', agentId: 123, description: 'Ingest the data' },
+    { name: 'analyze', agentId: 456, description: 'Analyze the results' }
+  ]
+  // Edges auto-generated: trigger -> ingest -> analyze
+})
+
+// Sync workflow configuration (update existing)
 await client.workflows.sync({
   id: 789,
-  triggers: [{ name: 'webhook', type: 'webhook' }],
-  tasks: [{ name: 'process', agentId: 123, description: 'Process data' }],
-  edges: [{ from: 'trigger:webhook', to: 'task:process' }]
+  triggers: [triggers.webhook({ waitForCompletion: true })],
+  tasks: [{ name: 'process', agentId: 123, description: 'Process data' }]
 })
 ```
 
@@ -186,67 +197,50 @@ await client.tasks.delete({ workflowId: 789, id: 1 })
 
 ### Triggers
 
+Use the `triggers` factory to create type-safe trigger configs, then pass them to `workflows.create()` or `workflow.sync()`:
+
 ```typescript
-import { triggers, triggerConfigToProps } from '@openserv-labs/client'
+import { triggers } from '@openserv-labs/client'
 
-// Create a webhook trigger
-const trigger = await client.triggers.create({
-  workflowId: 789,
-  name: 'My Webhook',
-  type: 'webhook',
-  props: triggerConfigToProps(
-    triggers.webhook({
-      waitForCompletion: true,
-      timeout: 300
-    })
-  )
+// Webhook trigger
+const workflow = await client.workflows.create({
+  name: 'My Workflow',
+  goal: 'Process requests',
+  triggers: [triggers.webhook({ waitForCompletion: true, timeout: 300 })],
+  tasks: [{ name: 'process', agentId: 123, description: 'Handle the request' }]
 })
 
-// Create a cron trigger
-const cronTrigger = await client.triggers.create({
-  workflowId: 789,
-  name: 'Daily Job',
-  type: 'cron',
-  props: triggerConfigToProps(
-    triggers.cron({
-      schedule: '0 9 * * *',
-      timezone: 'America/New_York'
-    })
-  )
+// x402 (paid) trigger
+const paidWorkflow = await client.workflows.create({
+  name: 'Paid Service',
+  goal: 'Premium AI service',
+  triggers: [triggers.x402({
+    name: 'AI Research Assistant',
+    description: 'Get comprehensive research reports on any topic powered by AI',
+    price: '0.01',
+    input: { query: { type: 'string', description: 'Research topic or question' } }
+  })],
+  tasks: [{ name: 'research', agentId: 123, description: 'Research the topic' }]
 })
 
-// Create an x402 (paid) trigger with a beautiful name and description
-const paidTrigger = await client.triggers.create({
-  workflowId: 789,
-  name: 'AI Research Assistant',
-  description: 'Get comprehensive research reports on any topic powered by AI',
-  type: 'x402',
-  props: triggerConfigToProps(
-    triggers.x402({
-      name: 'AI Research Assistant',
-      description: 'Get comprehensive research reports on any topic powered by AI',
-      price: '0.01',
-      input: {
-        query: { type: 'string', description: 'Research topic or question' }
-      }
-    })
-  )
-})
+// Cron (scheduled) trigger
+triggers.cron({ schedule: '0 9 * * *', timezone: 'America/New_York' })
+
+// Manual trigger
+triggers.manual()
+```
+
+#### Low-level Triggers API
+
+For managing individual triggers on existing workflows:
 
+```typescript
 // Get a trigger
 const trigger = await client.triggers.get({ workflowId: 789, id: 'trigger-id' })
 
 // List triggers
 const allTriggers = await client.triggers.list({ workflowId: 789 })
 
-// Update a trigger
-await client.triggers.update({
-  workflowId: 789,
-  id: 'trigger-id',
-  name: 'Updated Name',
-  props: { timeout: 600 }
-})
-
 // Activate a trigger
 await client.triggers.activate({ workflowId: 789, id: 'trigger-id' })
 
@@ -254,7 +248,7 @@ await client.triggers.activate({ workflowId: 789, id: 'trigger-id' })
 await client.triggers.fire({
   workflowId: 789,
   id: 'trigger-id',
-  payload: { data: 'test' }
+  input: JSON.stringify({ query: 'test' })
 })
 
 // Delete a trigger
@@ -552,9 +546,11 @@ const cronResult = await provision({
 Use the `triggers` factory for type-safe trigger configuration:
 
 ```typescript
-import { triggers, triggerConfigToProps } from '@openserv-labs/client'
+import { triggers } from '@openserv-labs/client'
+
+// Each factory accepts user-friendly params and returns a flat, typed config.
 
-// Webhook trigger with name and description
+// Webhook trigger
 triggers.webhook({
   name: 'Data Ingestion Webhook',
   description: 'Receives data from external systems for processing',
@@ -562,17 +558,18 @@ triggers.webhook({
   waitForCompletion: true,
   timeout: 180
 })
+// { type: 'webhook', name: '...', waitForCompletion: true, timeout: 180, inputSchema: {...} }
 
-// Cron trigger with name and description
+// Cron trigger
 triggers.cron({
   name: 'Daily Report Generator',
   description: 'Generates daily analytics reports every 6 hours',
   schedule: '0 */6 * * *',
   timezone: 'UTC'
 })
+// { type: 'cron', name: '...', schedule: '0 */6 * * *', timezone: 'UTC' }
 
-// x402 (paid) trigger with beautiful name and description
-// These appear in the x402-services listing
+// x402 (paid) trigger — name and description appear in the x402-services listing
 triggers.x402({
   name: 'AI Research Assistant',
   description: 'Get comprehensive research reports on any topic powered by AI',
@@ -581,12 +578,14 @@ triggers.x402({
   timeout: 300,
   walletAddress: '0x...'
 })
+// { type: 'x402', name: '...', x402Pricing: '0.05', timeout: 300, x402WalletAddress: '0x...', inputSchema: {...} }
 
-// Manual trigger with name and description
+// Manual trigger
 triggers.manual({
   name: 'Manual Test Trigger',
   description: 'For testing workflows manually'
 })
+// { type: 'manual', name: '...', description: '...' }
 ```
 
 ## Environment Variables
@@ -617,7 +616,6 @@ import type {
   WorkflowData,
   Task,
   Trigger,
-  TriggerDefinition,
   TaskDefinition,
   EdgeDefinition,
   Edge,

package/dist/client.d.ts

@@ -24,6 +24,8 @@ import { PaymentsAPI } from "./payments-api";
  */
 export declare class PlatformClient {
     private _apiClient;
+    /** Wallet address, set by authenticate() or manually. Used as a fallback for x402 trigger wallet resolution. */
+    walletAddress?: string;
     /** API for managing agents */
     readonly agents: AgentsAPI;
     /** API for managing integration connections */
@@ -103,5 +105,15 @@ export declare class PlatformClient {
      * ```
      */
     authenticate(privateKey?: string): Promise<string>;
+    /**
+     * Resolve wallet address from stored state or environment.
+     *
+     * Returns `this.walletAddress` (set by `authenticate()`) if available,
+     * otherwise derives the address from `WALLET_PRIVATE_KEY` environment variable.
+     * Per-trigger overrides are handled at the call site, not here.
+     *
+     * @returns The resolved wallet address, or undefined if no wallet is available
+     */
+    resolveWalletAddress(): string | undefined;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAgB;IAElC,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;OAGG;IACH,IAAI,SAAS,IAAI,aAAa,CAE7B;IAED;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnE;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAqB3D;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiEzD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK7C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAgB;IAElC,gHAAgH;IAChH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;OAGG;IACH,IAAI,SAAS,IAAI,aAAa,CAE7B;IAED;;;;;OAKG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKnE;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC;IAKb;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE;;;;;;OAMG;gBACS,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAqB3D;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmExD;;;;;;;;OAQG;IACH,oBAAoB,IAAI,MAAM,GAAG,SAAS;CAO3C"}

package/dist/client.js

@@ -32,6 +32,8 @@ const PLATFORM_URL = process.env.OPENSERV_API_URL || "https://api.openserv.ai";
  */
 class PlatformClient {
     _apiClient;
+    /** Wallet address, set by authenticate() or manually. Used as a fallback for x402 trigger wallet resolution. */
+    walletAddress;
     /** API for managing agents */
     agents;
     /** API for managing integration connections */
@@ -144,9 +146,10 @@ class PlatformClient {
             // If no wallet key, assume API key auth is already set up
             return "";
         }
-        // Create wallet
+        // Create wallet and store address for x402 wallet resolution
         const wallet = new ethers_1.ethers.Wallet(walletKey);
         const walletAddress = wallet.address;
+        this.walletAddress = walletAddress;
         // Step 1: Get nonce from platform
         const nonceResponse = await this._apiClient.post("/auth/wallet/nonce", {
             walletAddress,
@@ -183,5 +186,22 @@ Issued At: ${issuedAt}`;
         this._apiClient.defaults.headers.common["x-openserv-key"] = apiKey;
         return apiKey;
     }
+    /**
+     * Resolve wallet address from stored state or environment.
+     *
+     * Returns `this.walletAddress` (set by `authenticate()`) if available,
+     * otherwise derives the address from `WALLET_PRIVATE_KEY` environment variable.
+     * Per-trigger overrides are handled at the call site, not here.
+     *
+     * @returns The resolved wallet address, or undefined if no wallet is available
+     */
+    resolveWalletAddress() {
+        if (this.walletAddress)
+            return this.walletAddress;
+        if (process.env.WALLET_PRIVATE_KEY) {
+            return new ethers_1.ethers.Wallet(process.env.WALLET_PRIVATE_KEY).address;
+        }
+        return undefined;
+    }
 }
 exports.PlatformClient = PlatformClient;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export type { PaginatedResponse, IdResponse, ApiKeyResponse, NonceResponse, VerifyResponse, Agent, Category, MarketplaceAgent, MarketplaceAgentsResponse, OutputOption, TriggerDefinition, TaskDefinition, EdgeDefinition, WorkflowConfig, Trigger, Task, Edge, WorkflowData, UsdcTopupConfig, UsdcVerifyRequest, UsdcVerifyResponse, UsdcTopupResult, X402PaymentRequest, X402PaymentResult, } from "./types";
+export type { PaginatedResponse, IdResponse, ApiKeyResponse, NonceResponse, VerifyResponse, Agent, Category, MarketplaceAgent, MarketplaceAgentsResponse, OutputOption, TaskDefinition, EdgeDefinition, WorkflowConfig, Trigger, Task, Edge, WorkflowData, UsdcTopupConfig, UsdcVerifyRequest, UsdcVerifyResponse, UsdcTopupResult, X402PaymentRequest, X402PaymentResult, } from "./types";
 export type { InputSchemaProperty, InputSchema, WebhookTriggerConfig, X402TriggerConfig, CronTriggerConfig, ManualTriggerConfig, TriggerConfig, } from "./triggers-api";
-export { triggers, inputSchemaToJsonSchema, triggerConfigToProps, } from "./triggers-api";
+export { triggers, inputSchemaToJsonSchema } from "./triggers-api";
 export { PlatformClient } from "./client";
 export { Workflow } from "./workflow";
 export { AgentsAPI } from "./agents-api";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EAEd,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,YAAY,EAEZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAEf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,GACP,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EAEd,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,yBAAyB,EACzB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,YAAY,EAEZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAEf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,GACP,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,GACV,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setLogger = exports.clearProvisionedState = exports.getProvisionedInfo = exports.isProvisioned = exports.provision = exports.PaymentsAPI = exports.Web3API = exports.WorkflowsAPI = exports.TasksAPI = exports.TriggersAPI = exports.IntegrationsAPI = exports.AgentsAPI = exports.Workflow = exports.PlatformClient = exports.triggerConfigToProps = exports.inputSchemaToJsonSchema = exports.triggers = void 0;
+exports.setLogger = exports.clearProvisionedState = exports.getProvisionedInfo = exports.isProvisioned = exports.provision = exports.PaymentsAPI = exports.Web3API = exports.WorkflowsAPI = exports.TasksAPI = exports.TriggersAPI = exports.IntegrationsAPI = exports.AgentsAPI = exports.Workflow = exports.PlatformClient = exports.inputSchemaToJsonSchema = exports.triggers = void 0;
 // Trigger factory and helpers
 var triggers_api_1 = require("./triggers-api");
 Object.defineProperty(exports, "triggers", { enumerable: true, get: function () { return triggers_api_1.triggers; } });
 Object.defineProperty(exports, "inputSchemaToJsonSchema", { enumerable: true, get: function () { return triggers_api_1.inputSchemaToJsonSchema; } });
-Object.defineProperty(exports, "triggerConfigToProps", { enumerable: true, get: function () { return triggers_api_1.triggerConfigToProps; } });
 // Classes
 var client_1 = require("./client");
 Object.defineProperty(exports, "PlatformClient", { enumerable: true, get: function () { return client_1.PlatformClient; } });

package/dist/provision.d.ts

@@ -1,4 +1,5 @@
-import { type TriggerConfig } from "./triggers-api";
+import type { TriggerConfig } from "./triggers-api";
+import type { EdgeDefinition } from "./types";
 /**
  * Interface for an agent instance that can receive credentials.
  * This matches the Agent class from @openserv-labs/sdk.
@@ -72,13 +73,30 @@ export interface ProvisionConfig {
         name: string;
         /** Trigger configuration (use triggers factory) */
         trigger: TriggerConfig;
-        /** Optional task configuration */
+        /** Single task shorthand (backward compat). Omit agentId to assign to the provisioned agent. */
         task?: {
             /** Task description */
             description?: string;
             /** Detailed task body */
             body?: string;
         };
+        /**
+         * Multi-task support. Each task can specify an agentId (marketplace agent).
+         * Omit agentId to assign to the provisioned agent.
+         * When provided, takes precedence over `task`.
+         */
+        tasks?: Array<{
+            name: string;
+            description: string;
+            body?: string;
+            input?: string;
+            /** Agent ID to assign the task to. Omit for the provisioned agent. */
+            agentId?: number;
+        }>;
+        /** Custom edges between trigger and tasks. If omitted, sequential edges are auto-generated. */
+        edges?: EdgeDefinition[];
+        /** Additional agent IDs to include in the workspace beyond those in tasks (e.g., observers). */
+        agentIds?: number[];
     };
 }
 /**

package/dist/provision.d.ts.map

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

package/dist/provision.js

@@ -42,7 +42,6 @@ const ethers_1 = require("ethers");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const client_1 = require("./client");
-const triggers_api_1 = require("./triggers-api");
 const STATE_FILE = ".openserv.json";
 const defaultLogger = {
     info: (...args) => console.log("[provision]", ...args),
@@ -82,18 +81,6 @@ function formatAxiosError(error) {
         })
         : axiosError.message || "Unknown error";
 }
-/**
- * Inject x402 trigger properties (wallet address and waitForCompletion)
- */
-function injectX402Props(props, walletAddress, triggerType) {
-    if (triggerType !== "x402")
-        return props;
-    return {
-        ...props,
-        x402WalletAddress: props.x402WalletAddress || walletAddress,
-        waitForCompletion: props.waitForCompletion ?? true,
-    };
-}
 // ============================================================================
 // State Management (JSON)
 // ============================================================================
@@ -202,6 +189,9 @@ async function createAuthenticatedClient(privateKey) {
         try {
             // Verify it works by listing agents (a simple authenticated call)
             await client.agents.list();
+            // Always set walletAddress so resolveWalletAddress() works even when
+            // authenticate() is skipped (API-key-reuse path)
+            client.walletAddress = walletAddress;
             logger.info("Using existing user API key");
             return { client, walletAddress };
         }
@@ -309,9 +299,16 @@ async function provisionAgent(client, config) {
     return { agentId, apiKey, authToken };
 }
 /**
- * Provision a workflow (workspace + trigger + task)
+ * Build sequential edges: trigger -> task1 -> task2 -> ... -> taskN
  */
-async function provisionWorkflow(client, agentId, agentName, walletAddress, config) {
+/**
+ * Provision a workflow (workspace + trigger + tasks + edges).
+ *
+ * Uses the declarative workflows.create() for new workflows and workflow.sync()
+ * for updating existing ones. x402 wallet injection is handled automatically by
+ * syncInternal() using client.resolveWalletAddress().
+ */
+async function provisionWorkflow(client, agentId, agentName, config) {
     const state = readState();
     const workflowName = config.name || "default";
     // Initialize workflows structure if needed
@@ -319,29 +316,36 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
         state.workflows[agentName] = {};
     }
     const existingWorkflow = state.workflows[agentName][workflowName];
+    // Convert single task shorthand to tasks array if needed
+    const tasks = config.tasks || [
+        {
+            name: "default-task",
+            description: config.task?.description || "Process the incoming request",
+            body: config.task?.body || "",
+            input: "",
+        },
+    ];
+    // Assign provisioned agentId to tasks that don't specify one
+    const tasksWithAgents = tasks.map((t) => ({
+        ...t,
+        agentId: t.agentId || agentId,
+    }));
     let workflowId;
     let triggerId;
     let triggerToken;
     let needsCreate = true;
     if (existingWorkflow) {
-        // Update existing workflow
+        // Update existing workflow using sync (full idempotency)
         workflowId = existingWorkflow.workspaceId;
         triggerId = existingWorkflow.triggerId;
         triggerToken = existingWorkflow.triggerToken;
         needsCreate = false;
         try {
-            // Get existing trigger to preserve required fields
-            const existingTrigger = await client.triggers.get({
-                workflowId,
-                id: triggerId,
-            });
-            // Build new props, preserving existing values and injecting x402 props
-            const triggerProps = injectX402Props({ ...existingTrigger.props, ...(0, triggers_api_1.triggerConfigToProps)(config.trigger) }, walletAddress, config.trigger.type);
-            await client.triggers.update({
-                workflowId,
-                id: triggerId,
-                name: existingTrigger.name || config.trigger.type,
-                props: triggerProps,
+            const workflow = await client.workflows.get({ id: workflowId });
+            await workflow.sync({
+                triggers: [{ ...config.trigger, id: triggerId }],
+                tasks: tasksWithAgents,
+                ...(config.edges && { edges: config.edges }),
             });
             logger.info(`Updated workflow ${workflowName} (${workflowId})`);
         }
@@ -361,93 +365,31 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
         }
     }
     if (needsCreate) {
-        // Map trigger type to integration identifier
-        const triggerTypeToIntegration = {
-            x402: "x402-trigger",
-            webhook: "webhook-trigger",
-            cron: "cron-trigger",
-            manual: "manual-trigger",
-        };
-        const integrationIdentifier = triggerTypeToIntegration[config.trigger.type] || "manual-trigger";
-        // Create trigger props with x402 properties injected
-        const triggerProps = injectX402Props((0, triggers_api_1.triggerConfigToProps)(config.trigger), walletAddress, config.trigger.type);
-        // Step 1: Create workflow without triggers/tasks (avoids sync API issues)
+        // Create workflow with full declarative config
+        // syncInternal() handles x402 wallet injection, integration connection resolution,
+        // and auto-generates sequential edges when none are provided
         const workflow = await client.workflows.create({
             name: `${workflowName} Workflow`,
-            goal: config.task?.description || "Process requests",
-            agentIds: [agentId],
+            goal: config.task?.description || tasks[0]?.description || "Process requests",
+            agentIds: config.agentIds,
+            triggers: [config.trigger],
+            tasks: tasksWithAgents,
+            ...(config.edges && { edges: config.edges }),
         });
         workflowId = workflow.id;
         logger.info(`Created workflow ${workflowName} (${workflowId})`);
-        // Step 2: Get or create integration connection for the trigger type
-        const integrationConnectionId = await client.integrations.getOrCreateConnection(integrationIdentifier);
-        // Step 3: Create trigger using direct API
-        // Use the trigger's name/description if provided, otherwise default to type
-        const triggerName = config.trigger.name || config.trigger.type;
-        const triggerDescription = config.trigger.description;
-        const trigger = await client.triggers.create({
-            workflowId,
-            name: triggerName,
-            description: triggerDescription,
-            integrationConnectionId,
-            props: triggerProps,
-        });
-        triggerId = trigger.id;
-        triggerToken = trigger.token || "";
+        // Get trigger info from the created workflow
+        const trigger = workflow.triggers[0];
+        if (trigger) {
+            triggerId = trigger.id;
+            triggerToken = trigger.token || "";
+        }
         logger.info(`Created trigger ${triggerId} (token: ${triggerToken || "N/A"})`);
-        // Step 4: Create task using direct API
-        const task = await client.tasks.create({
-            workflowId,
-            agentId,
-            description: config.task?.description || "Process the incoming request",
-            body: config.task?.body || "",
-            input: "",
-        });
-        const taskId = task.id;
-        logger.info(`Created task ${taskId} for workflow ${workflowId}`);
-        // Step 5: Create workflow nodes and edges to link trigger to task
-        const triggerNodeId = `trigger-${triggerId}`;
-        const taskNodeId = `task-${taskId}`;
-        const workflowNodes = [
-            {
-                id: triggerNodeId,
-                type: "trigger",
-                triggerId,
-                position: { x: 0, y: 100 },
-                inputPorts: [],
-                outputPorts: [{ id: "default" }],
-                isEndNode: false,
-            },
-            {
-                id: taskNodeId,
-                type: "task",
-                taskId,
-                position: { x: 300, y: 100 },
-                inputPorts: [{ id: "input" }],
-                outputPorts: [{ id: "default" }],
-                isEndNode: true,
-            },
-        ];
-        const workflowEdges = [
-            {
-                id: `edge-${triggerId}-${taskId}`,
-                source: triggerNodeId,
-                target: taskNodeId,
-                sourcePort: "default",
-                targetPort: "input",
-            },
-        ];
-        await client.put(`/workspaces/${workflowId}/workflow`, {
-            workflow: {
-                nodes: workflowNodes,
-                edges: workflowEdges,
-                lastUpdatedTimestamp: Date.now(),
-            },
-        });
-        logger.info(`Created workflow edges linking trigger ${triggerId} to task ${taskId}`);
-        // Step 6: Activate trigger
-        await client.triggers.activate({ workflowId, id: triggerId });
-        // Step 7: Set workspace to running
+        // Activate trigger
+        if (triggerId) {
+            await client.triggers.activate({ workflowId, id: triggerId });
+        }
+        // Set workspace to running
         await client.workflows.setRunning({ id: workflowId });
         // Re-read state to avoid overwriting concurrent changes
         const freshState = readState();
@@ -456,8 +398,8 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
         }
         freshState.workflows[agentName][workflowName] = {
             workspaceId: workflowId,
-            triggerId,
-            triggerToken,
+            triggerId: triggerId || "",
+            triggerToken: triggerToken || "",
         };
         writeState(freshState);
         logger.info(`Provisioned workflow ${workflowName} (${workflowId})`);
@@ -533,7 +475,8 @@ async function provision(config) {
     // Get or create wallet
     const { privateKey } = await getOrCreateWallet();
     // Create authenticated client (reuses saved API key for session continuity)
-    const { client, walletAddress } = await createAuthenticatedClient(privateKey);
+    // walletAddress is set on client.walletAddress for x402 resolution
+    const { client } = await createAuthenticatedClient(privateKey);
     // Provision agent (returns agentId, apiKey, and authToken)
     const { agentId, apiKey, authToken } = await provisionAgent(client, config.agent);
     // Bind credentials to the agent
@@ -549,8 +492,8 @@ async function provision(config) {
             process.env.OPENSERV_AUTH_TOKEN = authToken;
         }
     }
-    // Provision workflow (pass agent name and wallet address for x402 triggers)
-    const workflowResult = await provisionWorkflow(client, agentId, config.agent.name, walletAddress, config.workflow);
+    // Provision workflow (wallet address resolved automatically via client.resolveWalletAddress())
+    const workflowResult = await provisionWorkflow(client, agentId, config.agent.name, config.workflow);
     return {
         agentId,
         apiKey,