@openserv-labs/client 1.0.0 → 1.0.1

package/README.md

@@ -215,16 +215,19 @@ const cronTrigger = await client.triggers.create({
   )
 })
 
-// Create an x402 (paid) trigger
+// Create an x402 (paid) trigger with a beautiful name and description
 const paidTrigger = await client.triggers.create({
   workflowId: 789,
-  name: 'Paid API',
+  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: 'Search query' }
+        query: { type: 'string', description: 'Research topic or question' }
       }
     })
   )
@@ -489,21 +492,23 @@ console.log(result.apiEndpoint) // Webhook URL to call
 ```typescript
 import { provision, triggers, isProvisioned, getProvisionedInfo, clearProvisionedState } from '@openserv-labs/client'
 
-// Provision with x402 (paid) trigger
+// Provision with x402 (paid) trigger - include beautiful name and description
 const paidResult = await provision({
   agent: {
-    name: 'paid-agent',
-    description: 'Premium AI service',
-    endpointUrl: 'https://paid-agent.example.com' // Required for production
+    name: 'research-assistant',
+    description: 'Premium AI research service',
+    endpointUrl: 'https://research-agent.example.com' // Required for production
   },
   workflow: {
-    name: 'paid-workflow',
+    name: 'research-workflow',
     trigger: triggers.x402({
+      name: 'AI Research Assistant',
+      description: 'Get comprehensive research reports on any topic powered by AI',
       price: '0.01',
-      input: { prompt: { type: 'string' } }
+      input: { prompt: { type: 'string', description: 'Research topic or question' } }
     }),
     task: {
-      description: 'Process paid requests and deliver premium results'
+      description: 'Process research requests and deliver comprehensive reports'
     }
   }
 })
@@ -549,29 +554,39 @@ Use the `triggers` factory for type-safe trigger configuration:
 ```typescript
 import { triggers, triggerConfigToProps } from '@openserv-labs/client'
 
-// Webhook trigger
+// Webhook trigger with name and description
 triggers.webhook({
+  name: 'Data Ingestion Webhook',
+  description: 'Receives data from external systems for processing',
   input: { message: { type: 'string' } },
   waitForCompletion: true,
   timeout: 180
 })
 
-// Cron trigger
+// Cron trigger with name and description
 triggers.cron({
-  schedule: '0 */6 * * *', // Every 6 hours
+  name: 'Daily Report Generator',
+  description: 'Generates daily analytics reports every 6 hours',
+  schedule: '0 */6 * * *',
   timezone: 'UTC'
 })
 
-// x402 (paid) trigger
+// x402 (paid) trigger with beautiful name and description
+// These appear in the x402-services listing
 triggers.x402({
+  name: 'AI Research Assistant',
+  description: 'Get comprehensive research reports on any topic powered by AI',
   price: '0.05',
-  input: { prompt: { type: 'string', description: 'User prompt' } },
+  input: { prompt: { type: 'string', description: 'Research topic or question' } },
   timeout: 300,
   walletAddress: '0x...'
 })
 
-// Manual trigger
-triggers.manual()
+// Manual trigger with name and description
+triggers.manual({
+  name: 'Manual Test Trigger',
+  description: 'For testing workflows manually'
+})
 ```
 
 ## Environment Variables

package/dist/agents-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-api.d.ts","sourceRoot":"","sources":["../src/agents-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,KAAK,EAKL,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAetC;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAI1D;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAO9D;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,KAAK,CAAC;IAWlB;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,KAAK,CAAC;IAuClB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAOF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlB"}
+{"version":3,"file":"agents-api.d.ts","sourceRoot":"","sources":["../src/agents-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,KAAK,EAKL,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B;;;;;;;;OAQG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAetC;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAI1D;;;;;;;OAOG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAO9D;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,KAAK,CAAC;IAWlB;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;;;;;;;OAQG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC,GAAG,OAAO,CAAC,KAAK,CAAC;IAwClB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAOF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlB"}

package/dist/agents-api.js

@@ -145,8 +145,9 @@ class AgentsAPI {
             is_trading_agent: currentAgent.is_trading_agent ?? false,
             scopes,
         };
-        // Note: endpoint_url is required for external agents. The GET single agent
-        // endpoint doesn't return it, so it must be provided in the update params.
+        // endpoint_url is required for external agents.
+        // For your own agents, the GET endpoint returns endpoint_url.
+        // For other agents (not owned by you), endpoint_url is not returned.
         if (updatePayload.kind === "external" && !updatePayload.endpoint_url) {
             throw new Error("endpoint_url is required when updating an external agent");
         }

package/dist/provision.d.ts

@@ -100,11 +100,16 @@ export interface Logger {
 export declare function setLogger(customLogger: Logger): void;
 /**
  * Provision an agent and workflow on the OpenServ platform.
+ *
+ * **This function is idempotent** - you can call it multiple times with the same
+ * config and it will update existing resources rather than create duplicates.
+ * There's no need to check `isProvisioned()` before calling this function.
+ *
  * This function handles:
  * - Wallet creation/retrieval
  * - Platform authentication (with session persistence)
- * - Agent registration/update
- * - Workflow creation/update
+ * - Agent registration/update (creates if new, updates if exists)
+ * - Workflow creation/update (creates if new, updates if exists)
  * - State persistence to .openserv.json
  *
  * @param config - Provisioning configuration
@@ -114,11 +119,11 @@ export declare function setLogger(customLogger: Logger): void;
  * ```ts
  * import { provision, triggers } from '@openserv-labs/client';
  *
+ * // Just call provision - it handles create vs update automatically
  * const result = await provision({
  *   agent: {
  *     name: 'my-agent',
  *     description: 'My autonomous agent',
- *     // endpointUrl is optional - SDK v2.0.0+ auto-updates to agents-proxy when run(agent) is called
  *   },
  *   workflow: {
  *     name: 'default',
@@ -139,17 +144,25 @@ export declare function provision(config: ProvisionConfig): Promise<ProvisionRes
  *
  * This checks the local `.openserv.json` state file.
  *
+ * **Note:** Since `provision()` is idempotent, you typically don't need to call
+ * this before provisioning. This function is useful for:
+ * - Skipping setup logs/messages on subsequent runs
+ * - Checking status without making API calls
+ * - Conditional logic based on provisioning state
+ *
  * @param agentName - Name of the agent to check
  * @param workflowName - Name of the workflow (defaults to "default")
  * @returns True if both agent and workflow are provisioned
  *
  * @example
  * ```typescript
- * if (isProvisioned('my-agent', 'api-workflow')) {
- *   console.log('Already provisioned!');
- * } else {
- *   await provision(config);
+ * // Optional: use for conditional logging
+ * if (!isProvisioned('my-agent', 'api-workflow')) {
+ *   console.log('First-time setup...');
  * }
+ *
+ * // provision() is idempotent - safe to call regardless
+ * await provision(config);
  * ```
  */
 export declare function isProvisioned(agentName: string, workflowName?: string): boolean;

package/dist/provision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAM1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,EAAE;QACL,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,8CAA8C;QAC9C,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,6BAA6B;IAC7B,QAAQ,EAAE;QACR,4BAA4B;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,mDAAmD;QACnD,OAAO,EAAE,aAAa,CAAC;QACvB,kCAAkC;QAClC,IAAI,CAAC,EAAE;YACL,uBAAuB;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,yBAAyB;YACzB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2BD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,yBAAyB;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEpD;AA2bD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAMT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAmBP;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C"}
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../src/provision.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAM1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,EAAE;QACL,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,8CAA8C;QAC9C,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,6BAA6B;IAC7B,QAAQ,EAAE;QACR,4BAA4B;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,mDAAmD;QACnD,OAAO,EAAE,aAAa,CAAC;QACvB,kCAAkC;QAClC,IAAI,CAAC,EAAE;YACL,uBAAuB;YACvB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,yBAAyB;YACzB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA4BD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,yBAAyB;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEpD;AA2hBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAMT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB;IACD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAmBP;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAU5C"}

package/dist/provision.js

@@ -227,28 +227,41 @@ async function createAuthenticatedClient(privateKey) {
 // Default endpoint URL - SDK v2.0.0+ automatically updates to this when run(agent) is called
 const DEFAULT_AGENT_ENDPOINT = "https://agents-proxy.openserv.ai";
 /**
- * Register or update an agent on the platform
+ * Check if an error is a "not found" error (404)
+ */
+function isNotFoundError(error) {
+    const axiosError = error;
+    return axiosError.response?.status === 404;
+}
+/**
+ * Register or update an agent on the platform.
+ * This function is idempotent - calling it multiple times with the same config
+ * will update the existing agent rather than create duplicates.
  */
 async function provisionAgent(client, config) {
     const state = readState();
     const existingAgent = state.agents[config.name];
-    const endpointUrl = config.endpointUrl || DEFAULT_AGENT_ENDPOINT;
     if (existingAgent) {
-        // Update existing agent - only update endpoint if explicitly provided
+        // Update existing agent
         const agentId = existingAgent.id;
         try {
-            const updateParams = {
+            // Fetch current agent from API to get the latest endpoint_url
+            const currentAgent = await client.agents.get({ id: agentId });
+            // Use config endpoint if provided, otherwise preserve current endpoint, or use default
+            const endpointUrl = config.endpointUrl ||
+                currentAgent.endpoint_url ||
+                DEFAULT_AGENT_ENDPOINT;
+            await client.agents.update({
                 id: agentId,
                 name: config.name,
                 capabilities_description: config.description,
-            };
-            // Only update endpoint if explicitly provided (not using default)
-            if (config.endpointUrl) {
-                updateParams.endpoint_url = config.endpointUrl;
-                logger.info(`Updating agent ${agentId} endpoint to ${config.endpointUrl}`);
-            }
-            await client.agents.update(updateParams);
+                endpoint_url: endpointUrl,
+            });
             logger.info(`Updated agent ${agentId}`);
+            // Update stored endpoint
+            const freshState = readState();
+            freshState.agents[config.name] = { ...existingAgent, endpointUrl };
+            writeState(freshState);
             return {
                 agentId,
                 apiKey: existingAgent.apiKey,
@@ -256,10 +269,22 @@ async function provisionAgent(client, config) {
             };
         }
         catch (error) {
-            logger.warn(`Failed to update agent ${agentId}: ${formatAxiosError(error)}`);
+            // Only create a new agent if the existing one was deleted from the platform (404)
+            // For any other error (network issues, auth problems, etc.), propagate the error
+            if (isNotFoundError(error)) {
+                logger.info(`Agent ${agentId} no longer exists on platform, will create new one`);
+                // Clear the stale agent from state before creating new one
+                delete state.agents[config.name];
+                writeState(state);
+            }
+            else {
+                // Re-throw non-404 errors to avoid creating duplicate agents
+                throw new Error(`Failed to update agent ${agentId}: ${formatAxiosError(error)}`);
+            }
         }
     }
-    // Register new agent
+    // Register new agent (only reached if no existing agent, or existing was deleted)
+    const endpointUrl = config.endpointUrl || DEFAULT_AGENT_ENDPOINT;
     const agent = await client.agents.create({
         name: config.name,
         capabilities_description: config.description,
@@ -272,9 +297,15 @@ async function provisionAgent(client, config) {
     const { authToken, authTokenHash } = await client.agents.generateAuthToken();
     await client.agents.saveAuthToken({ id: agentId, authTokenHash });
     logger.info("Generated and saved auth token for agent");
-    // Persist agent state (including auth token)
-    state.agents[config.name] = { id: agentId, apiKey, authToken };
-    writeState(state);
+    // Re-read state to avoid overwriting concurrent changes
+    const freshState = readState();
+    freshState.agents[config.name] = {
+        id: agentId,
+        apiKey,
+        authToken,
+        endpointUrl,
+    };
+    writeState(freshState);
     logger.info(`Registered agent ${agentId}: ${config.name}`);
     return { agentId, apiKey, authToken };
 }
@@ -316,8 +347,18 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
             logger.info(`Updated workflow ${workflowName} (${workflowId})`);
         }
         catch (error) {
-            logger.warn(`Failed to update workflow ${workflowName}: ${formatAxiosError(error)}`);
-            needsCreate = true;
+            // Only create a new workflow if the existing one was deleted from the platform (404)
+            // For any other error, propagate it to avoid creating duplicates
+            if (isNotFoundError(error)) {
+                logger.info(`Workflow ${workflowId} no longer exists on platform, will create new one`);
+                // Clear stale workflow from state
+                delete state.workflows[agentName][workflowName];
+                writeState(state);
+                needsCreate = true;
+            }
+            else {
+                throw new Error(`Failed to update workflow ${workflowName}: ${formatAxiosError(error)}`);
+            }
         }
     }
     if (needsCreate) {
@@ -342,9 +383,13 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
         // 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: config.trigger.type,
+            name: triggerName,
+            description: triggerDescription,
             integrationConnectionId,
             props: triggerProps,
         });
@@ -352,25 +397,70 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
         triggerToken = trigger.token || "";
         logger.info(`Created trigger ${triggerId} (token: ${triggerToken || "N/A"})`);
         // Step 4: Create task using direct API
-        await client.tasks.create({
+        const task = await client.tasks.create({
             workflowId,
             agentId,
             description: config.task?.description || "Process the incoming request",
             body: config.task?.body || "",
             input: "",
         });
-        logger.info(`Created task for workflow ${workflowId}`);
-        // Step 5: Activate trigger
+        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: "output" }],
+                isEndNode: false,
+            },
+            {
+                id: taskNodeId,
+                type: "task",
+                taskId,
+                position: { x: 300, y: 100 },
+                inputPorts: [{ id: "input" }],
+                outputPorts: [{ id: "output" }],
+                isEndNode: true,
+            },
+        ];
+        const workflowEdges = [
+            {
+                id: `edge-${triggerId}-${taskId}`,
+                source: triggerNodeId,
+                target: taskNodeId,
+                sourcePort: "output",
+                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 6: Set workspace to running
+        // Step 7: Set workspace to running
         await client.workflows.setRunning({ id: workflowId });
-        // Persist workflow state
-        state.workflows[agentName][workflowName] = {
+        // Re-read state to avoid overwriting concurrent changes
+        const freshState = readState();
+        if (!freshState.workflows[agentName]) {
+            freshState.workflows[agentName] = {};
+        }
+        freshState.workflows[agentName][workflowName] = {
             workspaceId: workflowId,
             triggerId,
             triggerToken,
         };
-        writeState(state);
+        writeState(freshState);
         logger.info(`Provisioned workflow ${workflowName} (${workflowId})`);
     }
     // Validate that all required values are set
@@ -402,11 +492,16 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
 // ============================================================================
 /**
  * Provision an agent and workflow on the OpenServ platform.
+ *
+ * **This function is idempotent** - you can call it multiple times with the same
+ * config and it will update existing resources rather than create duplicates.
+ * There's no need to check `isProvisioned()` before calling this function.
+ *
  * This function handles:
  * - Wallet creation/retrieval
  * - Platform authentication (with session persistence)
- * - Agent registration/update
- * - Workflow creation/update
+ * - Agent registration/update (creates if new, updates if exists)
+ * - Workflow creation/update (creates if new, updates if exists)
  * - State persistence to .openserv.json
  *
  * @param config - Provisioning configuration
@@ -416,11 +511,11 @@ async function provisionWorkflow(client, agentId, agentName, walletAddress, conf
  * ```ts
  * import { provision, triggers } from '@openserv-labs/client';
  *
+ * // Just call provision - it handles create vs update automatically
  * const result = await provision({
  *   agent: {
  *     name: 'my-agent',
  *     description: 'My autonomous agent',
- *     // endpointUrl is optional - SDK v2.0.0+ auto-updates to agents-proxy when run(agent) is called
  *   },
  *   workflow: {
  *     name: 'default',
@@ -461,17 +556,25 @@ async function provision(config) {
  *
  * This checks the local `.openserv.json` state file.
  *
+ * **Note:** Since `provision()` is idempotent, you typically don't need to call
+ * this before provisioning. This function is useful for:
+ * - Skipping setup logs/messages on subsequent runs
+ * - Checking status without making API calls
+ * - Conditional logic based on provisioning state
+ *
  * @param agentName - Name of the agent to check
  * @param workflowName - Name of the workflow (defaults to "default")
  * @returns True if both agent and workflow are provisioned
  *
  * @example
  * ```typescript
- * if (isProvisioned('my-agent', 'api-workflow')) {
- *   console.log('Already provisioned!');
- * } else {
- *   await provision(config);
+ * // Optional: use for conditional logging
+ * if (!isProvisioned('my-agent', 'api-workflow')) {
+ *   console.log('First-time setup...');
  * }
+ *
+ * // provision() is idempotent - safe to call regardless
+ * await provision(config);
  * ```
  */
 function isProvisioned(agentName, workflowName) {

package/dist/triggers-api.d.ts

@@ -21,6 +21,10 @@ export interface InputSchema {
  */
 export interface WebhookTriggerConfig {
     type: "webhook";
+    /** Display name for the trigger (shown in listings and UI) */
+    name?: string;
+    /** Description of what this trigger does */
+    description?: string;
     /** Input schema for webhook payload validation */
     input?: InputSchema;
     /** Whether to wait for workflow completion before responding */
@@ -33,6 +37,10 @@ export interface WebhookTriggerConfig {
  */
 export interface X402TriggerConfig {
     type: "x402";
+    /** Display name for the service (e.g., "AI Research Assistant") - shown in x402-services listing */
+    name?: string;
+    /** Description of what this service does - shown in x402-services listing */
+    description?: string;
     /** Price in USD (e.g., "0.01") */
     price: string;
     /** Input schema for request validation */
@@ -47,6 +55,10 @@ export interface X402TriggerConfig {
  */
 export interface CronTriggerConfig {
     type: "cron";
+    /** Display name for the trigger (shown in listings and UI) */
+    name?: string;
+    /** Description of what this trigger does */
+    description?: string;
     /** Cron expression (e.g., "0 9 * * *" for daily at 9 AM) */
     schedule: string;
     /** Timezone (default: "UTC") */
@@ -57,6 +69,10 @@ export interface CronTriggerConfig {
  */
 export interface ManualTriggerConfig {
     type: "manual";
+    /** Display name for the trigger (shown in listings and UI) */
+    name?: string;
+    /** Description of what this trigger does */
+    description?: string;
 }
 /**
  * Union type for all trigger configurations.
@@ -86,6 +102,8 @@ export declare const triggers: {
      * @returns Webhook trigger configuration
      */
     webhook: (opts?: {
+        name?: string;
+        description?: string;
         input?: InputSchema;
         waitForCompletion?: boolean;
         timeout?: number;
@@ -93,10 +111,14 @@ export declare const triggers: {
     /**
      * Create an x402 (paid) trigger configuration.
      * @param opts - Options for the x402 trigger
+     * @param opts.name - Display name for the service (e.g., "AI Research Assistant")
+     * @param opts.description - Description of what this service does
      * @param opts.price - Price in USD (e.g., "0.01")
      * @returns x402 trigger configuration
      */
     x402: (opts: {
+        name?: string;
+        description?: string;
         price: string;
         input?: InputSchema;
         timeout?: number;
@@ -110,14 +132,20 @@ export declare const triggers: {
      * @returns Cron trigger configuration
      */
     cron: (opts: {
+        name?: string;
+        description?: string;
         schedule: string;
         timezone?: string;
     }) => CronTriggerConfig;
     /**
      * Create a manual trigger configuration.
+     * @param opts - Optional settings for the manual trigger
      * @returns Manual trigger configuration
      */
-    manual: () => ManualTriggerConfig;
+    manual: (opts?: {
+        name?: string;
+        description?: string;
+    }) => ManualTriggerConfig;
 };
 /**
  * Convert an InputSchema to JSON Schema format.
@@ -167,7 +195,8 @@ export declare class TriggersAPI {
      * Create a new trigger in a workflow.
      * @param params - Parameters object
      * @param params.workflowId - The workflow ID
-     * @param params.name - Name for the trigger
+     * @param params.name - Display name for the trigger (e.g., "AI Research Assistant")
+     * @param params.description - Description of what this trigger does
      * @param params.integrationConnectionId - Integration connection ID (e.g., from getOrCreateConnection)
      * @param params.props - Trigger properties (use triggerConfigToProps helper)
      * @param params.trigger_name - Optional specific trigger name
@@ -176,6 +205,7 @@ export declare class TriggersAPI {
     create(params: {
         workflowId: number | string;
         name: string;
+        description?: string;
         integrationConnectionId: string;
         props?: Record<string, unknown>;
         trigger_name?: string;

package/dist/triggers-api.d.ts.map

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

package/dist/triggers-api.js

@@ -36,6 +36,8 @@ exports.triggers = {
     /**
      * Create an x402 (paid) trigger configuration.
      * @param opts - Options for the x402 trigger
+     * @param opts.name - Display name for the service (e.g., "AI Research Assistant")
+     * @param opts.description - Description of what this service does
      * @param opts.price - Price in USD (e.g., "0.01")
      * @returns x402 trigger configuration
      */
@@ -56,10 +58,12 @@ exports.triggers = {
     }),
     /**
      * Create a manual trigger configuration.
+     * @param opts - Optional settings for the manual trigger
      * @returns Manual trigger configuration
      */
-    manual: () => ({
+    manual: (opts) => ({
         type: "manual",
+        ...opts,
     }),
 };
 // ============================================================================
@@ -167,16 +171,18 @@ class TriggersAPI {
      * Create a new trigger in a workflow.
      * @param params - Parameters object
      * @param params.workflowId - The workflow ID
-     * @param params.name - Name for the trigger
+     * @param params.name - Display name for the trigger (e.g., "AI Research Assistant")
+     * @param params.description - Description of what this trigger does
      * @param params.integrationConnectionId - Integration connection ID (e.g., from getOrCreateConnection)
      * @param params.props - Trigger properties (use triggerConfigToProps helper)
      * @param params.trigger_name - Optional specific trigger name
      * @returns The created trigger
      */
     async create(params) {
-        const { workflowId, name, integrationConnectionId, props, trigger_name } = params;
+        const { workflowId, name, description, integrationConnectionId, props, trigger_name, } = params;
         const data = await this.client.post(`/workspaces/${workflowId}/trigger`, {
             name,
+            description: description || name,
             // If trigger_name not specified, server will use the integration's default
             ...(trigger_name && { trigger_name }),
             integrationConnectionId,

package/dist/workflows-api.d.ts

@@ -134,7 +134,7 @@ export declare class WorkflowsAPI {
         edges?: EdgeDefinition[];
     }): Promise<void>;
     private syncInternal;
-    private getIntegrationConnectionId;
+    private getIntegrationIdentifier;
     private getTriggerName;
     private resolveEdgeRef;
     private resolveNodeId;

package/dist/workflows-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows-api.d.ts","sourceRoot":"","sources":["../src/workflows-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,IAAI,EAGL,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4BvD;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8C7D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWjC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWrB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5E;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;YAWH,YAAY;IA8H1B,OAAO,CAAC,0BAA0B;IAWlC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;CAQtB"}
+{"version":3,"file":"workflows-api.d.ts","sourceRoot":"","sources":["../src/workflows-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,IAAI,EAGL,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4BvD;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8C7D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWjC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWrB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5E;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;YAWH,YAAY;IA2J1B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;CAQtB"}

package/dist/workflows-api.js

@@ -231,20 +231,27 @@ class WorkflowsAPI {
         for (const t of currentTasks || []) {
             taskNameToId.set(t.name || t.description, t.id);
         }
-        // Build triggers array with IDs
+        // Build triggers array with IDs - need to resolve integration connection IDs
         if (config.triggers) {
-            syncPayload.triggers = config.triggers.map((t) => ({
-                id: t.id || triggerNameToId.get(t.name) || `new-${t.name}`,
-                name: t.name,
-                description: t.name,
-                // Use integrationConnectionId if provided, otherwise fall back to type-based lookup
-                integrationConnectionId: t.integrationConnectionId || this.getIntegrationConnectionId(t.type),
-                // trigger_name is required by the sync endpoint
-                // Different triggers use different names: manual uses "on_event", webhook uses "on_request"
-                trigger_name: this.getTriggerName(t.type),
-                props: t.props || {},
-                attributes: {},
+            const triggersWithConnections = await Promise.all(config.triggers.map(async (t) => {
+                // Get the actual integration connection ID (UUID)
+                let integrationConnectionId = t.integrationConnectionId;
+                if (!integrationConnectionId && t.type) {
+                    const identifier = this.getIntegrationIdentifier(t.type);
+                    integrationConnectionId =
+                        await this.client.integrations.getOrCreateConnection(identifier);
+                }
+                return {
+                    id: t.id || triggerNameToId.get(t.name) || `new-${t.name}`,
+                    name: t.name,
+                    description: t.name,
+                    integrationConnectionId: integrationConnectionId || "",
+                    trigger_name: this.getTriggerName(t.type),
+                    props: t.props || {},
+                    attributes: {},
+                };
             }));
+            syncPayload.triggers = triggersWithConnections;
         }
         // Build tasks array with IDs
         if (config.tasks) {
@@ -301,7 +308,7 @@ class WorkflowsAPI {
                     });
                 }
             }
-            // Add edges with required fields
+            // Add edges
             if (config.edges) {
                 config.edges.forEach((e, i) => {
                     const sourceNode = this.resolveEdgeRef(e.from);
@@ -315,21 +322,40 @@ class WorkflowsAPI {
                     });
                 });
             }
+            else if (config.triggers &&
+                config.tasks &&
+                config.triggers.length > 0 &&
+                config.tasks.length > 0) {
+                // Auto-generate edges connecting triggers to the first task
+                const firstTask = config.tasks[0];
+                if (firstTask) {
+                    const firstTaskName = firstTask.name;
+                    config.triggers.forEach((trigger, i) => {
+                        edges.push({
+                            id: `edge-auto-${i}`,
+                            source: `trigger-${trigger.name}`,
+                            target: `task-${firstTaskName}`,
+                            sourcePort: "output",
+                            targetPort: "input",
+                        });
+                    });
+                }
+            }
             syncPayload.workflow = { nodes, edges };
         }
         // Call the sync endpoint
         await this.client.put(`/workspaces/${workflowId}/sync`, syncPayload);
     }
-    getIntegrationConnectionId(type) {
+    getIntegrationIdentifier(type) {
         if (!type)
-            return "";
+            return "manual-trigger";
         const mapping = {
             x402: "x402-trigger",
             webhook: "webhook-trigger",
             cron: "cron-trigger",
             manual: "manual-trigger",
         };
-        return mapping[type] || type;
+        return mapping[type] || "manual-trigger";
     }
     getTriggerName(type) {
         if (!type)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openserv-labs/client",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "OpenServ Platform Client - Manage agents, workflows, tasks, and triggers via the OpenServ API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",