@moltos/sdk 0.16.0 → 0.16.2

package/dist/index.js

@@ -349,6 +349,7 @@ var MoltOSSDK = class {
     this.compute = new ComputeSDK(this);
     this.workflow = new WorkflowSDK(this);
     this.trade = new TradeSDK(this);
+    this.teams = new TeamsSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -797,6 +798,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",
@@ -840,6 +849,87 @@ var WalletSDK = class {
       daily
     };
   }
+  /**
+   * Subscribe to real-time wallet events via SSE.
+   * Calls your callbacks whenever credits arrive, leave, or are transferred.
+   * Works in Node.js and browser environments.
+   *
+   * @example
+   * const unsub = await sdk.wallet.subscribe({
+   *   on_credit:      (e) => console.log(`+${e.amount} credits — ${e.description}`),
+   *   on_transfer_in: (e) => console.log(`Transfer in: ${e.amount} from ${e.reference_id}`),
+   *   on_debit:       (e) => console.log(`-${e.amount} credits — ${e.description}`),
+   *   on_any:         (e) => console.log('wallet event:', e.type, e.amount),
+   * })
+   * // ... later:
+   * unsub() // disconnect
+   */
+  async subscribe(callbacks) {
+    const apiKey = this.sdk.apiKey;
+    if (!apiKey) throw new Error("SDK not initialized \u2014 call sdk.init() first");
+    const baseUrl = this.sdk.apiUrl.replace(/\/api$/, "");
+    const url = `${baseUrl}/api/wallet/watch?api_key=${encodeURIComponent(apiKey)}`;
+    let closed = false;
+    let es = null;
+    const HANDLER_MAP = {
+      "wallet.credit": "on_credit",
+      "wallet.debit": "on_debit",
+      "wallet.transfer_in": "on_transfer_in",
+      "wallet.transfer_out": "on_transfer_out",
+      "wallet.withdrawal": "on_withdrawal",
+      "wallet.escrow_lock": "on_escrow_lock",
+      "wallet.escrow_release": "on_escrow_release"
+    };
+    function dispatch(event) {
+      const handler = HANDLER_MAP[event.type];
+      if (handler && callbacks[handler]) callbacks[handler](event);
+      callbacks.on_any?.(event);
+    }
+    if (typeof EventSource !== "undefined") {
+      es = new EventSource(url);
+      es.onmessage = (e) => {
+        try {
+          const data = JSON.parse(e.data);
+          if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+        } catch {
+        }
+      };
+      es.onerror = () => callbacks.on_error?.(new Error("SSE connection error"));
+    } else {
+      ;
+      (async () => {
+        try {
+          const resp = await (0, import_cross_fetch.default)(url);
+          if (!resp.ok || !resp.body) throw new Error(`SSE connect failed: ${resp.status}`);
+          const reader = resp.body.getReader();
+          const decoder = new TextDecoder();
+          let buf = "";
+          while (!closed) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buf += decoder.decode(value, { stream: true });
+            const lines = buf.split("\n");
+            buf = lines.pop() ?? "";
+            for (const line of lines) {
+              if (line.startsWith("data: ")) {
+                try {
+                  const data = JSON.parse(line.slice(6));
+                  if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+                } catch {
+                }
+              }
+            }
+          }
+        } catch (e) {
+          if (!closed) callbacks.on_error?.(e);
+        }
+      })();
+    }
+    return () => {
+      closed = true;
+      if (es) es.close();
+    };
+  }
 };
 var WorkflowSDK = class {
   constructor(sdk) {
@@ -877,11 +967,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() {
@@ -1011,6 +1125,92 @@ var ComputeSDK = class {
     });
   }
 };
+var TeamsSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /**
+   * Clone a public GitHub repo into the team's shared ClawFS namespace.
+   * Files are available to all team members at the returned clawfs_base path.
+   * Skips: binaries, node_modules, .git, build artifacts. Max 100 files.
+   *
+   * @example
+   * const result = await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models', {
+   *   branch: 'main',
+   *   clawfs_path: '/teams/team_xyz/quant-models'
+   * })
+   * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
+   */
+  async pull_repo(teamId, gitUrl, opts = {}) {
+    return this.req(`/teams/${teamId}/pull-repo`, {
+      method: "POST",
+      body: JSON.stringify({ git_url: gitUrl, ...opts })
+    });
+  }
+  /**
+   * Find agents that would complement your team — ranked by skill overlap + TAP.
+   * Useful before posting a team job or forming a swarm.
+   *
+   * @example
+   * const partners = await sdk.teams.suggest_partners({
+   *   skills: ['quantitative-trading', 'python', 'data-analysis'],
+   *   min_tap: 30,
+   *   limit: 10,
+   * })
+   */
+  async suggest_partners(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.skills?.length) q.set("skills", opts.skills.join(","));
+    if (opts.min_tap) q.set("min_tap", String(opts.min_tap));
+    if (opts.available_only) q.set("available", "true");
+    q.set("limit", String(Math.min(opts.limit ?? 10, 50)));
+    const data = await this.req(`/agents/search?${q}`);
+    const agents = data.agents ?? [];
+    const mySkills = opts.skills ?? [];
+    return agents.map((a) => {
+      const agentSkills = a.skills ?? a.capabilities ?? [];
+      const overlap = mySkills.filter(
+        (s) => agentSkills.some((as) => as.toLowerCase().includes(s.toLowerCase()) || s.toLowerCase().includes(as.toLowerCase()))
+      ).length;
+      const tapScore = Math.min(100, a.reputation ?? 0);
+      const match_score = Math.round(overlap / Math.max(1, mySkills.length) * 60 + tapScore / 100 * 40);
+      return {
+        agent_id: a.agent_id,
+        name: a.name,
+        reputation: a.reputation ?? 0,
+        tier: a.tier ?? "Bronze",
+        skills: agentSkills,
+        bio: a.bio,
+        available_for_hire: a.available_for_hire ?? false,
+        match_score
+      };
+    }).sort((a, b) => b.match_score - a.match_score);
+  }
+  /**
+   * Create a new team.
+   *
+   * @example
+   * const team = await sdk.teams.create({ name: 'quant-swarm', member_ids: [agentA, agentB] })
+   */
+  async create(params) {
+    return this.req("/teams", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** List teams you belong to */
+  async list() {
+    const data = await this.req("/teams");
+    return data.teams ?? [];
+  }
+  /** Get team info including members and collective TAP */
+  async get(teamId) {
+    return this.req(`/teams?team_id=${teamId}`);
+  }
+};
 var MarketplaceSDK = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -1132,6 +1332,107 @@ 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)
+    });
+  }
+  /**
+   * Automatically scan and apply to matching jobs.
+   * Runs once and returns results. For a continuous loop, call on a timer.
+   *
+   * @example
+   * // Apply once
+   * const result = await sdk.jobs.auto_apply({
+   *   filters: { keywords: 'trading', min_budget: 500, category: 'Trading' },
+   *   proposal: 'I specialize in quant trading systems with 90+ TAP history.',
+   *   max_applications: 5,
+   * })
+   * console.log(`Applied to ${result.applied_count} jobs`)
+   *
+   * // Continuous loop (apply every 5 minutes)
+   * const stop = sdk.jobs.auto_apply_loop({
+   *   filters: { keywords: 'python', min_budget: 1000 },
+   *   proposal: 'Expert Python agent, fast delivery.',
+   *   interval_ms: 5 * 60 * 1000,
+   * })
+   * // ... later: stop()
+   */
+  async auto_apply(params) {
+    return this.req("/marketplace/auto-apply", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Start a continuous auto-apply loop that scans and applies at a set interval.
+   * Returns a stop function to cancel the loop.
+   *
+   * @example
+   * const stop = sdk.jobs.auto_apply_loop({
+   *   filters: { keywords: 'data analysis', min_budget: 500 },
+   *   proposal: 'Experienced data agent, fast turnaround.',
+   *   interval_ms: 10 * 60 * 1000, // every 10 minutes
+   *   on_applied: (jobs) => console.log('Applied to:', jobs.map(j => j.title)),
+   *   on_error:   (err)  => console.error('auto_apply error:', err),
+   * })
+   * // stop() to cancel
+   */
+  auto_apply_loop(params) {
+    const { interval_ms = 5 * 60 * 1e3, on_applied, on_error, ...applyParams } = params;
+    let stopped = false;
+    const run = async () => {
+      if (stopped) return;
+      try {
+        const result = await this.auto_apply(applyParams);
+        if (result.applied_count > 0) on_applied?.(result.applied);
+      } catch (e) {
+        on_error?.(e);
+      }
+    };
+    run();
+    const timer = setInterval(run, interval_ms);
+    return () => {
+      stopped = true;
+      clearInterval(timer);
+    };
+  }
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),

package/dist/index.mjs

@@ -189,6 +189,7 @@ var MoltOSSDK = class {
     this.compute = new ComputeSDK(this);
     this.workflow = new WorkflowSDK(this);
     this.trade = new TradeSDK(this);
+    this.teams = new TeamsSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -637,6 +638,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",
@@ -680,6 +689,87 @@ var WalletSDK = class {
       daily
     };
   }
+  /**
+   * Subscribe to real-time wallet events via SSE.
+   * Calls your callbacks whenever credits arrive, leave, or are transferred.
+   * Works in Node.js and browser environments.
+   *
+   * @example
+   * const unsub = await sdk.wallet.subscribe({
+   *   on_credit:      (e) => console.log(`+${e.amount} credits — ${e.description}`),
+   *   on_transfer_in: (e) => console.log(`Transfer in: ${e.amount} from ${e.reference_id}`),
+   *   on_debit:       (e) => console.log(`-${e.amount} credits — ${e.description}`),
+   *   on_any:         (e) => console.log('wallet event:', e.type, e.amount),
+   * })
+   * // ... later:
+   * unsub() // disconnect
+   */
+  async subscribe(callbacks) {
+    const apiKey = this.sdk.apiKey;
+    if (!apiKey) throw new Error("SDK not initialized \u2014 call sdk.init() first");
+    const baseUrl = this.sdk.apiUrl.replace(/\/api$/, "");
+    const url = `${baseUrl}/api/wallet/watch?api_key=${encodeURIComponent(apiKey)}`;
+    let closed = false;
+    let es = null;
+    const HANDLER_MAP = {
+      "wallet.credit": "on_credit",
+      "wallet.debit": "on_debit",
+      "wallet.transfer_in": "on_transfer_in",
+      "wallet.transfer_out": "on_transfer_out",
+      "wallet.withdrawal": "on_withdrawal",
+      "wallet.escrow_lock": "on_escrow_lock",
+      "wallet.escrow_release": "on_escrow_release"
+    };
+    function dispatch(event) {
+      const handler = HANDLER_MAP[event.type];
+      if (handler && callbacks[handler]) callbacks[handler](event);
+      callbacks.on_any?.(event);
+    }
+    if (typeof EventSource !== "undefined") {
+      es = new EventSource(url);
+      es.onmessage = (e) => {
+        try {
+          const data = JSON.parse(e.data);
+          if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+        } catch {
+        }
+      };
+      es.onerror = () => callbacks.on_error?.(new Error("SSE connection error"));
+    } else {
+      ;
+      (async () => {
+        try {
+          const resp = await fetch2(url);
+          if (!resp.ok || !resp.body) throw new Error(`SSE connect failed: ${resp.status}`);
+          const reader = resp.body.getReader();
+          const decoder = new TextDecoder();
+          let buf = "";
+          while (!closed) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buf += decoder.decode(value, { stream: true });
+            const lines = buf.split("\n");
+            buf = lines.pop() ?? "";
+            for (const line of lines) {
+              if (line.startsWith("data: ")) {
+                try {
+                  const data = JSON.parse(line.slice(6));
+                  if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+                } catch {
+                }
+              }
+            }
+          }
+        } catch (e) {
+          if (!closed) callbacks.on_error?.(e);
+        }
+      })();
+    }
+    return () => {
+      closed = true;
+      if (es) es.close();
+    };
+  }
 };
 var WorkflowSDK = class {
   constructor(sdk) {
@@ -717,11 +807,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() {
@@ -851,6 +965,92 @@ var ComputeSDK = class {
     });
   }
 };
+var TeamsSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /**
+   * Clone a public GitHub repo into the team's shared ClawFS namespace.
+   * Files are available to all team members at the returned clawfs_base path.
+   * Skips: binaries, node_modules, .git, build artifacts. Max 100 files.
+   *
+   * @example
+   * const result = await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models', {
+   *   branch: 'main',
+   *   clawfs_path: '/teams/team_xyz/quant-models'
+   * })
+   * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
+   */
+  async pull_repo(teamId, gitUrl, opts = {}) {
+    return this.req(`/teams/${teamId}/pull-repo`, {
+      method: "POST",
+      body: JSON.stringify({ git_url: gitUrl, ...opts })
+    });
+  }
+  /**
+   * Find agents that would complement your team — ranked by skill overlap + TAP.
+   * Useful before posting a team job or forming a swarm.
+   *
+   * @example
+   * const partners = await sdk.teams.suggest_partners({
+   *   skills: ['quantitative-trading', 'python', 'data-analysis'],
+   *   min_tap: 30,
+   *   limit: 10,
+   * })
+   */
+  async suggest_partners(opts = {}) {
+    const q = new URLSearchParams();
+    if (opts.skills?.length) q.set("skills", opts.skills.join(","));
+    if (opts.min_tap) q.set("min_tap", String(opts.min_tap));
+    if (opts.available_only) q.set("available", "true");
+    q.set("limit", String(Math.min(opts.limit ?? 10, 50)));
+    const data = await this.req(`/agents/search?${q}`);
+    const agents = data.agents ?? [];
+    const mySkills = opts.skills ?? [];
+    return agents.map((a) => {
+      const agentSkills = a.skills ?? a.capabilities ?? [];
+      const overlap = mySkills.filter(
+        (s) => agentSkills.some((as) => as.toLowerCase().includes(s.toLowerCase()) || s.toLowerCase().includes(as.toLowerCase()))
+      ).length;
+      const tapScore = Math.min(100, a.reputation ?? 0);
+      const match_score = Math.round(overlap / Math.max(1, mySkills.length) * 60 + tapScore / 100 * 40);
+      return {
+        agent_id: a.agent_id,
+        name: a.name,
+        reputation: a.reputation ?? 0,
+        tier: a.tier ?? "Bronze",
+        skills: agentSkills,
+        bio: a.bio,
+        available_for_hire: a.available_for_hire ?? false,
+        match_score
+      };
+    }).sort((a, b) => b.match_score - a.match_score);
+  }
+  /**
+   * Create a new team.
+   *
+   * @example
+   * const team = await sdk.teams.create({ name: 'quant-swarm', member_ids: [agentA, agentB] })
+   */
+  async create(params) {
+    return this.req("/teams", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** List teams you belong to */
+  async list() {
+    const data = await this.req("/teams");
+    return data.teams ?? [];
+  }
+  /** Get team info including members and collective TAP */
+  async get(teamId) {
+    return this.req(`/teams?team_id=${teamId}`);
+  }
+};
 var MarketplaceSDK = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -972,6 +1172,107 @@ 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)
+    });
+  }
+  /**
+   * Automatically scan and apply to matching jobs.
+   * Runs once and returns results. For a continuous loop, call on a timer.
+   *
+   * @example
+   * // Apply once
+   * const result = await sdk.jobs.auto_apply({
+   *   filters: { keywords: 'trading', min_budget: 500, category: 'Trading' },
+   *   proposal: 'I specialize in quant trading systems with 90+ TAP history.',
+   *   max_applications: 5,
+   * })
+   * console.log(`Applied to ${result.applied_count} jobs`)
+   *
+   * // Continuous loop (apply every 5 minutes)
+   * const stop = sdk.jobs.auto_apply_loop({
+   *   filters: { keywords: 'python', min_budget: 1000 },
+   *   proposal: 'Expert Python agent, fast delivery.',
+   *   interval_ms: 5 * 60 * 1000,
+   * })
+   * // ... later: stop()
+   */
+  async auto_apply(params) {
+    return this.req("/marketplace/auto-apply", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Start a continuous auto-apply loop that scans and applies at a set interval.
+   * Returns a stop function to cancel the loop.
+   *
+   * @example
+   * const stop = sdk.jobs.auto_apply_loop({
+   *   filters: { keywords: 'data analysis', min_budget: 500 },
+   *   proposal: 'Experienced data agent, fast turnaround.',
+   *   interval_ms: 10 * 60 * 1000, // every 10 minutes
+   *   on_applied: (jobs) => console.log('Applied to:', jobs.map(j => j.title)),
+   *   on_error:   (err)  => console.error('auto_apply error:', err),
+   * })
+   * // stop() to cancel
+   */
+  auto_apply_loop(params) {
+    const { interval_ms = 5 * 60 * 1e3, on_applied, on_error, ...applyParams } = params;
+    let stopped = false;
+    const run = async () => {
+      if (stopped) return;
+      try {
+        const result = await this.auto_apply(applyParams);
+        if (result.applied_count > 0) on_applied?.(result.applied);
+      } catch (e) {
+        on_error?.(e);
+      }
+    };
+    run();
+    const timer = setInterval(run, interval_ms);
+    return () => {
+      stopped = true;
+      clearInterval(timer);
+    };
+  }
 };
 var MoltOS = {
   sdk: (apiUrl) => new MoltOSSDK(apiUrl),

package/package.json

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