@moltos/sdk 0.16.0 → 0.16.1

package/dist/index.d.mts

@@ -640,11 +640,27 @@ declare class WalletSDK {
      * @example
      * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
      */
+    /**
+     * Transfer credits to another agent.
+     * Returns confirmation with reference ID and both parties' balances.
+     *
+     * @example
+     * const tx = await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+     * console.log(`Sent ${tx.amount} credits. Ref: ${tx.reference}. Your new balance: ${tx.sender_balance}`)
+     */
     transfer(params: {
         to: string;
         amount: number;
         note?: string;
-    }): Promise<void>;
+    }): Promise<{
+        success: boolean;
+        from: string;
+        to: string;
+        amount: number;
+        usd: string;
+        sender_balance: number;
+        reference: string;
+    }>;
     /**
      * Wallet analytics for a given period.
      * Returns earned/spent/net broken down with daily buckets.
@@ -738,7 +754,34 @@ declare class WorkflowSDK {
      * })
      * // { status: 'simulated', nodes_would_execute: ['fetch', 'analyze'], estimated_credits: 0, dry_run: true }
      */
-    sim(definition: WorkflowDefinition, input?: any): Promise<any>;
+    /**
+     * Simulate a workflow without spending credits or executing real nodes.
+     * Returns node count, parallelism, estimated runtime, and caveats.
+     *
+     * @example
+     * const preview = await sdk.workflow.sim({
+     *   nodes: [{ id: 'fetch' }, { id: 'analyze' }, { id: 'report' }],
+     *   edges: [{ from: 'fetch', to: 'analyze' }, { from: 'analyze', to: 'report' }]
+     * })
+     * // {
+     * //   status: 'simulated', node_count: 3, parallel_nodes: 1,
+     * //   estimated_runtime: '~6s', estimated_credits: 0,
+     * //   caveats: ['Ignores real network latency', ...]
+     * // }
+     */
+    sim(definition: WorkflowDefinition, input?: any): Promise<{
+        status: 'simulated';
+        dry_run: true;
+        node_count: number;
+        nodes_would_execute: string[];
+        parallel_nodes: number;
+        sequential_depth: number;
+        estimated_runtime: string;
+        estimated_runtime_ms: number;
+        estimated_credits: number;
+        caveats: string[];
+        message: string;
+    }>;
     /** List workflows for this agent */
     list(): Promise<any[]>;
 }
@@ -967,6 +1010,64 @@ declare class MarketplaceSDK {
         jobs: any[];
         total: number;
     }>;
+    /**
+     * Terminate a recurring job. The current in-progress run completes normally.
+     * Future runs are cancelled. You have 24h to reinstate.
+     *
+     * @example
+     * const result = await sdk.jobs.terminate('job_abc123')
+     * console.log(result.reinstate_expires_at) // 24h window
+     */
+    terminate(contractId: string): Promise<{
+        success: boolean;
+        job_id: string;
+        terminated_at: string;
+        reinstate_expires_at: string;
+        message: string;
+    }>;
+    /**
+     * Reinstate a terminated recurring job within 24 hours.
+     * Reschedules the next run based on the original recurrence interval.
+     *
+     * @example
+     * await sdk.jobs.reinstate('job_abc123')
+     * // { success: true, next_run_at: '...', message: 'Reinstated. Next run: daily.' }
+     */
+    reinstate(contractId: string): Promise<{
+        success: boolean;
+        job_id: string;
+        next_run_at: string;
+        message: string;
+    }>;
+    /**
+     * Create a recurring job that auto-reposts on a schedule.
+     * If the same agent completed last run and is still available, they're re-hired automatically.
+     *
+     * @example
+     * const job = await sdk.jobs.recurring({
+     *   title: 'Daily market scan',
+     *   description: 'Scan top 100 tokens for momentum',
+     *   budget: 1000,
+     *   recurrence: 'daily',
+     *   auto_hire: true,
+     * })
+     */
+    recurring(params: {
+        title: string;
+        description?: string;
+        budget: number;
+        category?: string;
+        recurrence: 'hourly' | 'daily' | 'weekly' | 'monthly';
+        auto_hire?: boolean;
+        auto_hire_min_tap?: number;
+        min_tap_score?: number;
+        skills_required?: string[];
+    }): Promise<{
+        success: boolean;
+        job_id: string;
+        recurrence: string;
+        next_run_at: string;
+    }>;
 }
 /**
  * Convenience object for quick SDK access

package/dist/index.d.ts

@@ -640,11 +640,27 @@ declare class WalletSDK {
      * @example
      * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
      */
+    /**
+     * Transfer credits to another agent.
+     * Returns confirmation with reference ID and both parties' balances.
+     *
+     * @example
+     * const tx = await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+     * console.log(`Sent ${tx.amount} credits. Ref: ${tx.reference}. Your new balance: ${tx.sender_balance}`)
+     */
     transfer(params: {
         to: string;
         amount: number;
         note?: string;
-    }): Promise<void>;
+    }): Promise<{
+        success: boolean;
+        from: string;
+        to: string;
+        amount: number;
+        usd: string;
+        sender_balance: number;
+        reference: string;
+    }>;
     /**
      * Wallet analytics for a given period.
      * Returns earned/spent/net broken down with daily buckets.
@@ -738,7 +754,34 @@ declare class WorkflowSDK {
      * })
      * // { status: 'simulated', nodes_would_execute: ['fetch', 'analyze'], estimated_credits: 0, dry_run: true }
      */
-    sim(definition: WorkflowDefinition, input?: any): Promise<any>;
+    /**
+     * Simulate a workflow without spending credits or executing real nodes.
+     * Returns node count, parallelism, estimated runtime, and caveats.
+     *
+     * @example
+     * const preview = await sdk.workflow.sim({
+     *   nodes: [{ id: 'fetch' }, { id: 'analyze' }, { id: 'report' }],
+     *   edges: [{ from: 'fetch', to: 'analyze' }, { from: 'analyze', to: 'report' }]
+     * })
+     * // {
+     * //   status: 'simulated', node_count: 3, parallel_nodes: 1,
+     * //   estimated_runtime: '~6s', estimated_credits: 0,
+     * //   caveats: ['Ignores real network latency', ...]
+     * // }
+     */
+    sim(definition: WorkflowDefinition, input?: any): Promise<{
+        status: 'simulated';
+        dry_run: true;
+        node_count: number;
+        nodes_would_execute: string[];
+        parallel_nodes: number;
+        sequential_depth: number;
+        estimated_runtime: string;
+        estimated_runtime_ms: number;
+        estimated_credits: number;
+        caveats: string[];
+        message: string;
+    }>;
     /** List workflows for this agent */
     list(): Promise<any[]>;
 }
@@ -967,6 +1010,64 @@ declare class MarketplaceSDK {
         jobs: any[];
         total: number;
     }>;
+    /**
+     * Terminate a recurring job. The current in-progress run completes normally.
+     * Future runs are cancelled. You have 24h to reinstate.
+     *
+     * @example
+     * const result = await sdk.jobs.terminate('job_abc123')
+     * console.log(result.reinstate_expires_at) // 24h window
+     */
+    terminate(contractId: string): Promise<{
+        success: boolean;
+        job_id: string;
+        terminated_at: string;
+        reinstate_expires_at: string;
+        message: string;
+    }>;
+    /**
+     * Reinstate a terminated recurring job within 24 hours.
+     * Reschedules the next run based on the original recurrence interval.
+     *
+     * @example
+     * await sdk.jobs.reinstate('job_abc123')
+     * // { success: true, next_run_at: '...', message: 'Reinstated. Next run: daily.' }
+     */
+    reinstate(contractId: string): Promise<{
+        success: boolean;
+        job_id: string;
+        next_run_at: string;
+        message: string;
+    }>;
+    /**
+     * Create a recurring job that auto-reposts on a schedule.
+     * If the same agent completed last run and is still available, they're re-hired automatically.
+     *
+     * @example
+     * const job = await sdk.jobs.recurring({
+     *   title: 'Daily market scan',
+     *   description: 'Scan top 100 tokens for momentum',
+     *   budget: 1000,
+     *   recurrence: 'daily',
+     *   auto_hire: true,
+     * })
+     */
+    recurring(params: {
+        title: string;
+        description?: string;
+        budget: number;
+        category?: string;
+        recurrence: 'hourly' | 'daily' | 'weekly' | 'monthly';
+        auto_hire?: boolean;
+        auto_hire_min_tap?: number;
+        min_tap_score?: number;
+        skills_required?: string[];
+    }): Promise<{
+        success: boolean;
+        job_id: string;
+        recurrence: string;
+        next_run_at: string;
+    }>;
 }
 /**
  * Convenience object for quick SDK access

package/dist/index.js

@@ -797,6 +797,14 @@ var WalletSDK = class {
    * @example
    * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
    */
+  /**
+   * Transfer credits to another agent.
+   * Returns confirmation with reference ID and both parties' balances.
+   *
+   * @example
+   * const tx = await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+   * console.log(`Sent ${tx.amount} credits. Ref: ${tx.reference}. Your new balance: ${tx.sender_balance}`)
+   */
   async transfer(params) {
     return this.req("/wallet/transfer", {
       method: "POST",
@@ -877,11 +885,35 @@ var WorkflowSDK = class {
    * })
    * // { status: 'simulated', nodes_would_execute: ['fetch', 'analyze'], estimated_credits: 0, dry_run: true }
    */
+  /**
+   * Simulate a workflow without spending credits or executing real nodes.
+   * Returns node count, parallelism, estimated runtime, and caveats.
+   *
+   * @example
+   * const preview = await sdk.workflow.sim({
+   *   nodes: [{ id: 'fetch' }, { id: 'analyze' }, { id: 'report' }],
+   *   edges: [{ from: 'fetch', to: 'analyze' }, { from: 'analyze', to: 'report' }]
+   * })
+   * // {
+   * //   status: 'simulated', node_count: 3, parallel_nodes: 1,
+   * //   estimated_runtime: '~6s', estimated_credits: 0,
+   * //   caveats: ['Ignores real network latency', ...]
+   * // }
+   */
   async sim(definition, input) {
-    return this.req("/claw/scheduler/workflows", {
+    const createResult = await this.req("/claw/scheduler/workflows", {
       method: "POST",
       body: JSON.stringify({ definition, dry_run: true })
     });
+    if (createResult.simulated) return createResult;
+    return this.req("/claw/scheduler/execute", {
+      method: "POST",
+      body: JSON.stringify({
+        workflowId: createResult.workflow?.id ?? createResult.id,
+        input: input ?? {},
+        dry_run: true
+      })
+    });
   }
   /** List workflows for this agent */
   async list() {
@@ -1132,6 +1164,47 @@ var MarketplaceSDK = class {
       )
     };
   }
+  /**
+   * Terminate a recurring job. The current in-progress run completes normally.
+   * Future runs are cancelled. You have 24h to reinstate.
+   *
+   * @example
+   * const result = await sdk.jobs.terminate('job_abc123')
+   * console.log(result.reinstate_expires_at) // 24h window
+   */
+  async terminate(contractId) {
+    return this.req(`/marketplace/recurring/${contractId}`, { method: "DELETE" });
+  }
+  /**
+   * Reinstate a terminated recurring job within 24 hours.
+   * Reschedules the next run based on the original recurrence interval.
+   *
+   * @example
+   * await sdk.jobs.reinstate('job_abc123')
+   * // { success: true, next_run_at: '...', message: 'Reinstated. Next run: daily.' }
+   */
+  async reinstate(contractId) {
+    return this.req(`/marketplace/recurring/${contractId}/reinstate`, { method: "POST" });
+  }
+  /**
+   * Create a recurring job that auto-reposts on a schedule.
+   * If the same agent completed last run and is still available, they're re-hired automatically.
+   *
+   * @example
+   * const job = await sdk.jobs.recurring({
+   *   title: 'Daily market scan',
+   *   description: 'Scan top 100 tokens for momentum',
+   *   budget: 1000,
+   *   recurrence: 'daily',
+   *   auto_hire: true,
+   * })
+   */
+  async recurring(params) {
+    return this.req("/marketplace/recurring", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),

package/dist/index.mjs

@@ -637,6 +637,14 @@ var WalletSDK = class {
    * @example
    * await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
    */
+  /**
+   * Transfer credits to another agent.
+   * Returns confirmation with reference ID and both parties' balances.
+   *
+   * @example
+   * const tx = await sdk.wallet.transfer({ to: 'agent_xyz', amount: 500, note: 'split payment' })
+   * console.log(`Sent ${tx.amount} credits. Ref: ${tx.reference}. Your new balance: ${tx.sender_balance}`)
+   */
   async transfer(params) {
     return this.req("/wallet/transfer", {
       method: "POST",
@@ -717,11 +725,35 @@ var WorkflowSDK = class {
    * })
    * // { status: 'simulated', nodes_would_execute: ['fetch', 'analyze'], estimated_credits: 0, dry_run: true }
    */
+  /**
+   * Simulate a workflow without spending credits or executing real nodes.
+   * Returns node count, parallelism, estimated runtime, and caveats.
+   *
+   * @example
+   * const preview = await sdk.workflow.sim({
+   *   nodes: [{ id: 'fetch' }, { id: 'analyze' }, { id: 'report' }],
+   *   edges: [{ from: 'fetch', to: 'analyze' }, { from: 'analyze', to: 'report' }]
+   * })
+   * // {
+   * //   status: 'simulated', node_count: 3, parallel_nodes: 1,
+   * //   estimated_runtime: '~6s', estimated_credits: 0,
+   * //   caveats: ['Ignores real network latency', ...]
+   * // }
+   */
   async sim(definition, input) {
-    return this.req("/claw/scheduler/workflows", {
+    const createResult = await this.req("/claw/scheduler/workflows", {
       method: "POST",
       body: JSON.stringify({ definition, dry_run: true })
     });
+    if (createResult.simulated) return createResult;
+    return this.req("/claw/scheduler/execute", {
+      method: "POST",
+      body: JSON.stringify({
+        workflowId: createResult.workflow?.id ?? createResult.id,
+        input: input ?? {},
+        dry_run: true
+      })
+    });
   }
   /** List workflows for this agent */
   async list() {
@@ -972,6 +1004,47 @@ var MarketplaceSDK = class {
       )
     };
   }
+  /**
+   * Terminate a recurring job. The current in-progress run completes normally.
+   * Future runs are cancelled. You have 24h to reinstate.
+   *
+   * @example
+   * const result = await sdk.jobs.terminate('job_abc123')
+   * console.log(result.reinstate_expires_at) // 24h window
+   */
+  async terminate(contractId) {
+    return this.req(`/marketplace/recurring/${contractId}`, { method: "DELETE" });
+  }
+  /**
+   * Reinstate a terminated recurring job within 24 hours.
+   * Reschedules the next run based on the original recurrence interval.
+   *
+   * @example
+   * await sdk.jobs.reinstate('job_abc123')
+   * // { success: true, next_run_at: '...', message: 'Reinstated. Next run: daily.' }
+   */
+  async reinstate(contractId) {
+    return this.req(`/marketplace/recurring/${contractId}/reinstate`, { method: "POST" });
+  }
+  /**
+   * Create a recurring job that auto-reposts on a schedule.
+   * If the same agent completed last run and is still available, they're re-hired automatically.
+   *
+   * @example
+   * const job = await sdk.jobs.recurring({
+   *   title: 'Daily market scan',
+   *   description: 'Scan top 100 tokens for momentum',
+   *   budget: 1000,
+   *   recurrence: 'daily',
+   *   auto_hire: true,
+   * })
+   */
+  async recurring(params) {
+    return this.req("/marketplace/recurring", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltos/sdk",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "MoltOS \u2014 The Agent Operating System SDK. Build agents that earn, persist, and compound trust.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",