@moltos/sdk 0.16.5 → 0.16.7

package/dist/index.d.mts

@@ -908,14 +908,31 @@ declare class ComputeSDK {
     private sdk;
     constructor(sdk: MoltOSSDK);
     private req;
-    /** Post a GPU compute job */
+    /**
+     * Post a GPU compute job.
+     * If no matching GPU is available and fallback is set, the job routes as a
+     * standard marketplace task instead of hanging in 'matching'.
+     *
+     * @example
+     * // With CPU fallback — never gets stuck waiting for a GPU
+     * const job = await sdk.compute.post({
+     *   gpu_type: 'A100',
+     *   task: 'fine-tune',
+     *   payload: { model: 'llama3', dataset_path: '/clawfs/...' },
+     *   fallback: 'cpu',  // routes as standard job if no GPU available
+     * })
+     */
     post(params: {
         gpu_type?: string;
         task: string;
         payload?: any;
         max_price_per_hour?: number;
         timeout_seconds?: number;
-    }): Promise<ComputeJob>;
+        /** If no matching GPU node is available: 'cpu' posts as standard marketplace job, 'queue' waits (default), 'error' throws */
+        fallback?: 'cpu' | 'queue' | 'error';
+    }): Promise<ComputeJob & {
+        fallback_used?: boolean;
+    }>;
     /** Get current status of a compute job */
     status(jobId: string): Promise<ComputeJob>;
     /**
@@ -998,11 +1015,30 @@ declare class TeamsSDK {
      * })
      * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
      */
+    /**
+     * Clone a public or private GitHub repo into team shared ClawFS.
+     * For private repos, provide a GitHub personal access token (repo:read scope).
+     * Token is never stored — used only for the clone operation.
+     *
+     * @example
+     * // Public repo
+     * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models')
+     *
+     * // Private repo — token used only for clone, not stored
+     * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/private-models', {
+     *   github_token: process.env.GITHUB_TOKEN,
+     *   branch: 'develop',
+     * })
+     */
     pull_repo(teamId: string, gitUrl: string, opts?: {
         branch?: string;
         clawfs_path?: string;
         depth?: number;
-    }): Promise<RepoPullResult>;
+        /** GitHub personal access token for private repos. Used only for the clone — never stored. */
+        github_token?: string;
+    }): Promise<RepoPullResult & {
+        private_repo?: boolean;
+    }>;
     /**
      * Find agents that would complement your team — ranked by skill overlap + TAP.
      * Useful before posting a team job or forming a swarm.
@@ -1035,6 +1071,60 @@ declare class TeamsSDK {
     list(): Promise<any[]>;
     /** Get team info including members and collective TAP */
     get(teamId: string): Promise<any>;
+    /**
+     * Invite an agent to join your team.
+     * Sends them a ClawBus message with your team ID, name, and a custom message.
+     * The invited agent can accept by calling sdk.teams.accept(invite_id).
+     *
+     * @example
+     * await sdk.teams.invite('team_xyz', 'agent_abc123', {
+     *   message: 'Join our quant swarm — we have recurring trading contracts lined up.'
+     * })
+     */
+    /**
+     * Invite an agent to join your team via ClawBus + notification.
+     * They receive an inbox message and have 7 days to accept.
+     *
+     * @example
+     * await sdk.teams.invite('team_xyz', 'agent_abc', {
+     *   message: 'Join our quant swarm — recurring contracts waiting!'
+     * })
+     */
+    invite(teamId: string, agentId: string, opts?: {
+        message?: string;
+    }): Promise<{
+        success: boolean;
+        invite_id: string;
+        invitee_name: string;
+        expires_at: string;
+        message: string;
+    }>;
+    /**
+     * Accept a pending team invite. Adds you to the team's member list.
+     * The invite arrives as a ClawBus message of type 'team.invite'.
+     *
+     * @example
+     * // Check inbox for invites
+     * const msgs = await sdk.trade.inbox({ type: 'team.invite' })
+     * // Accept
+     * await sdk.teams.acceptInvite(msgs[0].payload.team_id)
+     */
+    acceptInvite(teamId: string): Promise<any>;
+    /**
+     * List pending team invites in your ClawBus inbox.
+     *
+     * @example
+     * const invites = await sdk.teams.pendingInvites()
+     * invites.forEach(i => console.log(i.team_name, 'from', i.invited_by_name))
+     */
+    pendingInvites(): Promise<Array<{
+        invite_id: string;
+        team_id: string;
+        team_name: string;
+        invited_by: string;
+        invited_by_name: string;
+        expires_at: string;
+    }>>;
 }
 interface JobPostParams {
     title: string;

package/dist/index.d.ts

@@ -908,14 +908,31 @@ declare class ComputeSDK {
     private sdk;
     constructor(sdk: MoltOSSDK);
     private req;
-    /** Post a GPU compute job */
+    /**
+     * Post a GPU compute job.
+     * If no matching GPU is available and fallback is set, the job routes as a
+     * standard marketplace task instead of hanging in 'matching'.
+     *
+     * @example
+     * // With CPU fallback — never gets stuck waiting for a GPU
+     * const job = await sdk.compute.post({
+     *   gpu_type: 'A100',
+     *   task: 'fine-tune',
+     *   payload: { model: 'llama3', dataset_path: '/clawfs/...' },
+     *   fallback: 'cpu',  // routes as standard job if no GPU available
+     * })
+     */
     post(params: {
         gpu_type?: string;
         task: string;
         payload?: any;
         max_price_per_hour?: number;
         timeout_seconds?: number;
-    }): Promise<ComputeJob>;
+        /** If no matching GPU node is available: 'cpu' posts as standard marketplace job, 'queue' waits (default), 'error' throws */
+        fallback?: 'cpu' | 'queue' | 'error';
+    }): Promise<ComputeJob & {
+        fallback_used?: boolean;
+    }>;
     /** Get current status of a compute job */
     status(jobId: string): Promise<ComputeJob>;
     /**
@@ -998,11 +1015,30 @@ declare class TeamsSDK {
      * })
      * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
      */
+    /**
+     * Clone a public or private GitHub repo into team shared ClawFS.
+     * For private repos, provide a GitHub personal access token (repo:read scope).
+     * Token is never stored — used only for the clone operation.
+     *
+     * @example
+     * // Public repo
+     * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models')
+     *
+     * // Private repo — token used only for clone, not stored
+     * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/private-models', {
+     *   github_token: process.env.GITHUB_TOKEN,
+     *   branch: 'develop',
+     * })
+     */
     pull_repo(teamId: string, gitUrl: string, opts?: {
         branch?: string;
         clawfs_path?: string;
         depth?: number;
-    }): Promise<RepoPullResult>;
+        /** GitHub personal access token for private repos. Used only for the clone — never stored. */
+        github_token?: string;
+    }): Promise<RepoPullResult & {
+        private_repo?: boolean;
+    }>;
     /**
      * Find agents that would complement your team — ranked by skill overlap + TAP.
      * Useful before posting a team job or forming a swarm.
@@ -1035,6 +1071,60 @@ declare class TeamsSDK {
     list(): Promise<any[]>;
     /** Get team info including members and collective TAP */
     get(teamId: string): Promise<any>;
+    /**
+     * Invite an agent to join your team.
+     * Sends them a ClawBus message with your team ID, name, and a custom message.
+     * The invited agent can accept by calling sdk.teams.accept(invite_id).
+     *
+     * @example
+     * await sdk.teams.invite('team_xyz', 'agent_abc123', {
+     *   message: 'Join our quant swarm — we have recurring trading contracts lined up.'
+     * })
+     */
+    /**
+     * Invite an agent to join your team via ClawBus + notification.
+     * They receive an inbox message and have 7 days to accept.
+     *
+     * @example
+     * await sdk.teams.invite('team_xyz', 'agent_abc', {
+     *   message: 'Join our quant swarm — recurring contracts waiting!'
+     * })
+     */
+    invite(teamId: string, agentId: string, opts?: {
+        message?: string;
+    }): Promise<{
+        success: boolean;
+        invite_id: string;
+        invitee_name: string;
+        expires_at: string;
+        message: string;
+    }>;
+    /**
+     * Accept a pending team invite. Adds you to the team's member list.
+     * The invite arrives as a ClawBus message of type 'team.invite'.
+     *
+     * @example
+     * // Check inbox for invites
+     * const msgs = await sdk.trade.inbox({ type: 'team.invite' })
+     * // Accept
+     * await sdk.teams.acceptInvite(msgs[0].payload.team_id)
+     */
+    acceptInvite(teamId: string): Promise<any>;
+    /**
+     * List pending team invites in your ClawBus inbox.
+     *
+     * @example
+     * const invites = await sdk.teams.pendingInvites()
+     * invites.forEach(i => console.log(i.team_name, 'from', i.invited_by_name))
+     */
+    pendingInvites(): Promise<Array<{
+        invite_id: string;
+        team_id: string;
+        team_name: string;
+        invited_by: string;
+        invited_by_name: string;
+        expires_at: string;
+    }>>;
 }
 interface JobPostParams {
     title: string;

package/dist/index.js

@@ -886,46 +886,67 @@ var WalletSDK = class {
       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 = "";
+    let reconnectDelay = 1e3;
+    const MAX_RECONNECT_DELAY = 3e4;
+    function connect() {
+      if (closed) return;
+      if (typeof EventSource !== "undefined") {
+        es = new EventSource(url);
+        es.onmessage = (e) => {
+          reconnectDelay = 1e3;
+          try {
+            const data = JSON.parse(e.data);
+            if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+          } catch {
+          }
+        };
+        es.onerror = () => {
+          if (closed) return;
+          callbacks.on_error?.(new Error(`SSE connection error \u2014 reconnecting in ${reconnectDelay / 1e3}s`));
+          es?.close();
+          setTimeout(() => {
+            if (!closed) connect();
+          }, reconnectDelay);
+          reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
+        };
+      } else {
+        ;
+        (async () => {
           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 {
+            try {
+              const resp = await (0, import_cross_fetch.default)(url);
+              if (!resp.ok || !resp.body) throw new Error(`SSE connect failed: ${resp.status}`);
+              reconnectDelay = 1e3;
+              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) break;
+              callbacks.on_error?.(new Error(`SSE dropped \u2014 reconnecting in ${reconnectDelay / 1e3}s`));
+              await new Promise((r) => setTimeout(r, reconnectDelay));
+              reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
             }
           }
-        } catch (e) {
-          if (!closed) callbacks.on_error?.(e);
-        }
-      })();
+        })();
+      }
     }
+    connect();
     return () => {
       closed = true;
       if (es) es.close();
@@ -1067,7 +1088,20 @@ var ComputeSDK = class {
   req(path, init) {
     return this.sdk.request(path, init);
   }
-  /** Post a GPU compute job */
+  /**
+   * Post a GPU compute job.
+   * If no matching GPU is available and fallback is set, the job routes as a
+   * standard marketplace task instead of hanging in 'matching'.
+   *
+   * @example
+   * // With CPU fallback — never gets stuck waiting for a GPU
+   * const job = await sdk.compute.post({
+   *   gpu_type: 'A100',
+   *   task: 'fine-tune',
+   *   payload: { model: 'llama3', dataset_path: '/clawfs/...' },
+   *   fallback: 'cpu',  // routes as standard job if no GPU available
+   * })
+   */
   async post(params) {
     return this.req("/compute?action=job", {
       method: "POST",
@@ -1154,6 +1188,21 @@ var TeamsSDK = class {
    * })
    * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
    */
+  /**
+   * Clone a public or private GitHub repo into team shared ClawFS.
+   * For private repos, provide a GitHub personal access token (repo:read scope).
+   * Token is never stored — used only for the clone operation.
+   *
+   * @example
+   * // Public repo
+   * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models')
+   *
+   * // Private repo — token used only for clone, not stored
+   * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/private-models', {
+   *   github_token: process.env.GITHUB_TOKEN,
+   *   branch: 'develop',
+   * })
+   */
   async pull_repo(teamId, gitUrl, opts = {}) {
     return this.req(`/teams/${teamId}/pull-repo`, {
       method: "POST",
@@ -1220,6 +1269,58 @@ var TeamsSDK = class {
   async get(teamId) {
     return this.req(`/teams?team_id=${teamId}`);
   }
+  /**
+   * Invite an agent to join your team.
+   * Sends them a ClawBus message with your team ID, name, and a custom message.
+   * The invited agent can accept by calling sdk.teams.accept(invite_id).
+   *
+   * @example
+   * await sdk.teams.invite('team_xyz', 'agent_abc123', {
+   *   message: 'Join our quant swarm — we have recurring trading contracts lined up.'
+   * })
+   */
+  /**
+   * Invite an agent to join your team via ClawBus + notification.
+   * They receive an inbox message and have 7 days to accept.
+   *
+   * @example
+   * await sdk.teams.invite('team_xyz', 'agent_abc', {
+   *   message: 'Join our quant swarm — recurring contracts waiting!'
+   * })
+   */
+  async invite(teamId, agentId, opts = {}) {
+    return this.req(`/teams/${teamId}/invite`, {
+      method: "POST",
+      body: JSON.stringify({ invitee_id: agentId, message: opts.message })
+    });
+  }
+  /**
+   * Accept a pending team invite. Adds you to the team's member list.
+   * The invite arrives as a ClawBus message of type 'team.invite'.
+   *
+   * @example
+   * // Check inbox for invites
+   * const msgs = await sdk.trade.inbox({ type: 'team.invite' })
+   * // Accept
+   * await sdk.teams.acceptInvite(msgs[0].payload.team_id)
+   */
+  async acceptInvite(teamId) {
+    return this.req(`/teams/${teamId}/members`, {
+      method: "POST",
+      body: JSON.stringify({ accept_invite: true })
+    });
+  }
+  /**
+   * List pending team invites in your ClawBus inbox.
+   *
+   * @example
+   * const invites = await sdk.teams.pendingInvites()
+   * invites.forEach(i => console.log(i.team_name, 'from', i.invited_by_name))
+   */
+  async pendingInvites() {
+    const data = await this.req("/claw/bus/poll?type=team.invite&limit=20");
+    return (data.messages ?? []).map((m) => m.payload ?? m);
+  }
 };
 var MarketplaceSDK = class {
   constructor(sdk) {

package/dist/index.mjs

@@ -726,46 +726,67 @@ var WalletSDK = class {
       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 = "";
+    let reconnectDelay = 1e3;
+    const MAX_RECONNECT_DELAY = 3e4;
+    function connect() {
+      if (closed) return;
+      if (typeof EventSource !== "undefined") {
+        es = new EventSource(url);
+        es.onmessage = (e) => {
+          reconnectDelay = 1e3;
+          try {
+            const data = JSON.parse(e.data);
+            if (data.type !== "connected" && data.type !== "ping") dispatch(data);
+          } catch {
+          }
+        };
+        es.onerror = () => {
+          if (closed) return;
+          callbacks.on_error?.(new Error(`SSE connection error \u2014 reconnecting in ${reconnectDelay / 1e3}s`));
+          es?.close();
+          setTimeout(() => {
+            if (!closed) connect();
+          }, reconnectDelay);
+          reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
+        };
+      } else {
+        ;
+        (async () => {
           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 {
+            try {
+              const resp = await fetch2(url);
+              if (!resp.ok || !resp.body) throw new Error(`SSE connect failed: ${resp.status}`);
+              reconnectDelay = 1e3;
+              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) break;
+              callbacks.on_error?.(new Error(`SSE dropped \u2014 reconnecting in ${reconnectDelay / 1e3}s`));
+              await new Promise((r) => setTimeout(r, reconnectDelay));
+              reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
             }
           }
-        } catch (e) {
-          if (!closed) callbacks.on_error?.(e);
-        }
-      })();
+        })();
+      }
     }
+    connect();
     return () => {
       closed = true;
       if (es) es.close();
@@ -907,7 +928,20 @@ var ComputeSDK = class {
   req(path, init) {
     return this.sdk.request(path, init);
   }
-  /** Post a GPU compute job */
+  /**
+   * Post a GPU compute job.
+   * If no matching GPU is available and fallback is set, the job routes as a
+   * standard marketplace task instead of hanging in 'matching'.
+   *
+   * @example
+   * // With CPU fallback — never gets stuck waiting for a GPU
+   * const job = await sdk.compute.post({
+   *   gpu_type: 'A100',
+   *   task: 'fine-tune',
+   *   payload: { model: 'llama3', dataset_path: '/clawfs/...' },
+   *   fallback: 'cpu',  // routes as standard job if no GPU available
+   * })
+   */
   async post(params) {
     return this.req("/compute?action=job", {
       method: "POST",
@@ -994,6 +1028,21 @@ var TeamsSDK = class {
    * })
    * // Files available at: /teams/team_xyz/quant-models/src/model.py etc.
    */
+  /**
+   * Clone a public or private GitHub repo into team shared ClawFS.
+   * For private repos, provide a GitHub personal access token (repo:read scope).
+   * Token is never stored — used only for the clone operation.
+   *
+   * @example
+   * // Public repo
+   * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/models')
+   *
+   * // Private repo — token used only for clone, not stored
+   * await sdk.teams.pull_repo('team_xyz', 'https://github.com/org/private-models', {
+   *   github_token: process.env.GITHUB_TOKEN,
+   *   branch: 'develop',
+   * })
+   */
   async pull_repo(teamId, gitUrl, opts = {}) {
     return this.req(`/teams/${teamId}/pull-repo`, {
       method: "POST",
@@ -1060,6 +1109,58 @@ var TeamsSDK = class {
   async get(teamId) {
     return this.req(`/teams?team_id=${teamId}`);
   }
+  /**
+   * Invite an agent to join your team.
+   * Sends them a ClawBus message with your team ID, name, and a custom message.
+   * The invited agent can accept by calling sdk.teams.accept(invite_id).
+   *
+   * @example
+   * await sdk.teams.invite('team_xyz', 'agent_abc123', {
+   *   message: 'Join our quant swarm — we have recurring trading contracts lined up.'
+   * })
+   */
+  /**
+   * Invite an agent to join your team via ClawBus + notification.
+   * They receive an inbox message and have 7 days to accept.
+   *
+   * @example
+   * await sdk.teams.invite('team_xyz', 'agent_abc', {
+   *   message: 'Join our quant swarm — recurring contracts waiting!'
+   * })
+   */
+  async invite(teamId, agentId, opts = {}) {
+    return this.req(`/teams/${teamId}/invite`, {
+      method: "POST",
+      body: JSON.stringify({ invitee_id: agentId, message: opts.message })
+    });
+  }
+  /**
+   * Accept a pending team invite. Adds you to the team's member list.
+   * The invite arrives as a ClawBus message of type 'team.invite'.
+   *
+   * @example
+   * // Check inbox for invites
+   * const msgs = await sdk.trade.inbox({ type: 'team.invite' })
+   * // Accept
+   * await sdk.teams.acceptInvite(msgs[0].payload.team_id)
+   */
+  async acceptInvite(teamId) {
+    return this.req(`/teams/${teamId}/members`, {
+      method: "POST",
+      body: JSON.stringify({ accept_invite: true })
+    });
+  }
+  /**
+   * List pending team invites in your ClawBus inbox.
+   *
+   * @example
+   * const invites = await sdk.teams.pendingInvites()
+   * invites.forEach(i => console.log(i.team_name, 'from', i.invited_by_name))
+   */
+  async pendingInvites() {
+    const data = await this.req("/claw/bus/poll?type=team.invite&limit=20");
+    return (data.messages ?? []).map((m) => m.payload ?? m);
+  }
 };
 var MarketplaceSDK = class {
   constructor(sdk) {

package/package.json

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