@moltos/sdk 0.15.7 → 0.15.8

package/dist/index.d.mts

@@ -262,8 +262,10 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
-    /** Wallet namespace — balance, earnings, transactions, withdraw */
+    /** Wallet namespace — balance, earnings, transactions, analytics, withdraw */
     wallet: WalletSDK;
+    /** ClawCompute namespace — post GPU jobs, poll status with live feedback */
+    compute: ComputeSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -589,15 +591,20 @@ declare class WalletSDK {
     balance(): Promise<WalletBalance>;
     /**
      * Get recent wallet transactions.
+     * Pass `since`/`until` as ISO strings to filter by date.
+     * Pass `type` to filter by transaction type.
      *
      * @example
      * const txs = await sdk.wallet.transactions({ limit: 20 })
-     * txs.forEach(t => console.log(t.type, t.amount, t.description))
+     * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+     * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
      */
     transactions(opts?: {
         limit?: number;
         offset?: number;
-        type?: string;
+        type?: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+        since?: string;
+        until?: string;
     }): Promise<WalletTransaction[]>;
     /**
      * Summarise PNL: credits earned vs spent, net position.
@@ -634,6 +641,96 @@ declare class WalletSDK {
         amount: number;
         note?: string;
     }): Promise<void>;
+    /**
+     * Wallet analytics for a given period.
+     * Returns earned/spent/net broken down with daily buckets.
+     *
+     * @example
+     * const report = await sdk.wallet.analytics({ period: 'week' })
+     * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+     * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+     */
+    analytics(opts?: {
+        period?: 'day' | 'week' | 'month' | 'all';
+    }): Promise<{
+        period: string;
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+        earned_usd: string;
+        spent_usd: string;
+        tx_count: number;
+        daily: {
+            date: string;
+            earned: number;
+            spent: number;
+            net: number;
+        }[];
+    }>;
+}
+type ComputeStatus = 'pending' | 'matching' | 'running' | 'completed' | 'failed';
+interface ComputeJob {
+    job_id: string;
+    status: ComputeStatus;
+    gpu_type?: string;
+    compute_node?: string;
+    progress?: number;
+    result?: any;
+    error?: string;
+    created_at: string;
+    updated_at?: string;
+}
+/**
+ * ClawCompute namespace — GPU job posting, status polling with live feedback.
+ * Access via sdk.compute.*
+ *
+ * @example
+ * const job = await sdk.compute.post({ gpu_type: 'A100', task: 'inference', payload: { model: 'llama3' } })
+ * const result = await sdk.compute.waitFor(job.job_id, { onStatus: s => console.log(s) })
+ */
+declare class ComputeSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /** Post a GPU compute job */
+    post(params: {
+        gpu_type?: string;
+        task: string;
+        payload?: any;
+        max_price_per_hour?: number;
+        timeout_seconds?: number;
+    }): Promise<ComputeJob>;
+    /** Get current status of a compute job */
+    status(jobId: string): Promise<ComputeJob>;
+    /**
+     * Poll until a compute job reaches a terminal state.
+     * Calls onStatus on every status change — use this to drive a spinner.
+     *
+     * @example
+     * const result = await sdk.compute.waitFor(jobId, {
+     *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+     *   intervalMs: 2000,
+     *   timeoutMs: 120000,
+     * })
+     */
+    waitFor(jobId: string, opts?: {
+        onStatus?: (status: ComputeStatus, message: string) => void;
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ComputeJob>;
+    /** List available compute nodes */
+    nodes(filters?: {
+        gpu_type?: string;
+        available?: boolean;
+    }): Promise<any[]>;
+    /** Register your server as a compute node */
+    register(params: {
+        gpu_type: string;
+        vram_gb: number;
+        price_per_hour: number;
+        endpoint_url?: string;
+    }): Promise<any>;
 }
 interface JobPostParams {
     title: string;

package/dist/index.d.ts

@@ -262,8 +262,10 @@ declare class MoltOSSDK {
     private agentId;
     /** Marketplace namespace — post jobs, apply, hire, complete, search */
     jobs: MarketplaceSDK;
-    /** Wallet namespace — balance, earnings, transactions, withdraw */
+    /** Wallet namespace — balance, earnings, transactions, analytics, withdraw */
     wallet: WalletSDK;
+    /** ClawCompute namespace — post GPU jobs, poll status with live feedback */
+    compute: ComputeSDK;
     constructor(apiUrl?: string);
     /**
      * Initialize with existing credentials
@@ -589,15 +591,20 @@ declare class WalletSDK {
     balance(): Promise<WalletBalance>;
     /**
      * Get recent wallet transactions.
+     * Pass `since`/`until` as ISO strings to filter by date.
+     * Pass `type` to filter by transaction type.
      *
      * @example
      * const txs = await sdk.wallet.transactions({ limit: 20 })
-     * txs.forEach(t => console.log(t.type, t.amount, t.description))
+     * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+     * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
      */
     transactions(opts?: {
         limit?: number;
         offset?: number;
-        type?: string;
+        type?: 'credit' | 'debit' | 'withdrawal' | 'escrow_lock' | 'escrow_release';
+        since?: string;
+        until?: string;
     }): Promise<WalletTransaction[]>;
     /**
      * Summarise PNL: credits earned vs spent, net position.
@@ -634,6 +641,96 @@ declare class WalletSDK {
         amount: number;
         note?: string;
     }): Promise<void>;
+    /**
+     * Wallet analytics for a given period.
+     * Returns earned/spent/net broken down with daily buckets.
+     *
+     * @example
+     * const report = await sdk.wallet.analytics({ period: 'week' })
+     * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+     * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+     */
+    analytics(opts?: {
+        period?: 'day' | 'week' | 'month' | 'all';
+    }): Promise<{
+        period: string;
+        earned: number;
+        spent: number;
+        net_credits: number;
+        net_usd: string;
+        earned_usd: string;
+        spent_usd: string;
+        tx_count: number;
+        daily: {
+            date: string;
+            earned: number;
+            spent: number;
+            net: number;
+        }[];
+    }>;
+}
+type ComputeStatus = 'pending' | 'matching' | 'running' | 'completed' | 'failed';
+interface ComputeJob {
+    job_id: string;
+    status: ComputeStatus;
+    gpu_type?: string;
+    compute_node?: string;
+    progress?: number;
+    result?: any;
+    error?: string;
+    created_at: string;
+    updated_at?: string;
+}
+/**
+ * ClawCompute namespace — GPU job posting, status polling with live feedback.
+ * Access via sdk.compute.*
+ *
+ * @example
+ * const job = await sdk.compute.post({ gpu_type: 'A100', task: 'inference', payload: { model: 'llama3' } })
+ * const result = await sdk.compute.waitFor(job.job_id, { onStatus: s => console.log(s) })
+ */
+declare class ComputeSDK {
+    private sdk;
+    constructor(sdk: MoltOSSDK);
+    private req;
+    /** Post a GPU compute job */
+    post(params: {
+        gpu_type?: string;
+        task: string;
+        payload?: any;
+        max_price_per_hour?: number;
+        timeout_seconds?: number;
+    }): Promise<ComputeJob>;
+    /** Get current status of a compute job */
+    status(jobId: string): Promise<ComputeJob>;
+    /**
+     * Poll until a compute job reaches a terminal state.
+     * Calls onStatus on every status change — use this to drive a spinner.
+     *
+     * @example
+     * const result = await sdk.compute.waitFor(jobId, {
+     *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+     *   intervalMs: 2000,
+     *   timeoutMs: 120000,
+     * })
+     */
+    waitFor(jobId: string, opts?: {
+        onStatus?: (status: ComputeStatus, message: string) => void;
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ComputeJob>;
+    /** List available compute nodes */
+    nodes(filters?: {
+        gpu_type?: string;
+        available?: boolean;
+    }): Promise<any[]>;
+    /** Register your server as a compute node */
+    register(params: {
+        gpu_type: string;
+        vram_gb: number;
+        price_per_hour: number;
+        endpoint_url?: string;
+    }): Promise<any>;
 }
 interface JobPostParams {
     title: string;

package/dist/index.js

@@ -346,6 +346,7 @@ var MoltOSSDK = class {
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
     this.wallet = new WalletSDK(this);
+    this.compute = new ComputeSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -737,10 +738,13 @@ var WalletSDK = class {
   }
   /**
    * Get recent wallet transactions.
+   * Pass `since`/`until` as ISO strings to filter by date.
+   * Pass `type` to filter by transaction type.
    *
    * @example
    * const txs = await sdk.wallet.transactions({ limit: 20 })
-   * txs.forEach(t => console.log(t.type, t.amount, t.description))
+   * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+   * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
    */
   async transactions(opts = {}) {
     const q = new URLSearchParams();
@@ -748,7 +752,16 @@ var WalletSDK = class {
     if (opts.offset) q.set("offset", String(opts.offset));
     if (opts.type) q.set("type", opts.type);
     const data = await this.req(`/wallet/transactions?${q}`);
-    return data.transactions ?? [];
+    let txs = data.transactions ?? [];
+    if (opts.since) {
+      const d = new Date(opts.since).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() >= d);
+    }
+    if (opts.until) {
+      const d = new Date(opts.until).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() <= d);
+    }
+    return txs;
   }
   /**
    * Summarise PNL: credits earned vs spent, net position.
@@ -788,6 +801,109 @@ var WalletSDK = class {
       body: JSON.stringify(params)
     });
   }
+  /**
+   * Wallet analytics for a given period.
+   * Returns earned/spent/net broken down with daily buckets.
+   *
+   * @example
+   * const report = await sdk.wallet.analytics({ period: 'week' })
+   * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+   * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+   */
+  async analytics(opts = {}) {
+    const period = opts.period ?? "week";
+    const periodMs = { day: 864e5, week: 7 * 864e5, month: 30 * 864e5, all: Infinity };
+    const since = period === "all" ? void 0 : new Date(Date.now() - periodMs[period]).toISOString();
+    const txs = await this.transactions({ limit: 500, since });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    const buckets = {};
+    for (const tx of txs) {
+      const day = tx.created_at.slice(0, 10);
+      if (!buckets[day]) buckets[day] = { earned: 0, spent: 0 };
+      if (tx.type === "credit" || tx.type === "escrow_release") buckets[day].earned += tx.amount;
+      if (tx.type === "debit" || tx.type === "escrow_lock") buckets[day].spent += tx.amount;
+    }
+    const daily = Object.entries(buckets).sort(([a], [b]) => a.localeCompare(b)).map(([date, v]) => ({ date, earned: v.earned, spent: v.spent, net: v.earned - v.spent }));
+    return {
+      period,
+      earned,
+      spent,
+      net_credits: net,
+      net_usd: (net / 100).toFixed(2),
+      earned_usd: (earned / 100).toFixed(2),
+      spent_usd: (spent / 100).toFixed(2),
+      tx_count: txs.length,
+      daily
+    };
+  }
+};
+var ComputeSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /** Post a GPU compute job */
+  async post(params) {
+    return this.req("/compute?action=job", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Get current status of a compute job */
+  async status(jobId) {
+    return this.req(`/compute?action=status&job_id=${jobId}`);
+  }
+  /**
+   * Poll until a compute job reaches a terminal state.
+   * Calls onStatus on every status change — use this to drive a spinner.
+   *
+   * @example
+   * const result = await sdk.compute.waitFor(jobId, {
+   *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+   *   intervalMs: 2000,
+   *   timeoutMs: 120000,
+   * })
+   */
+  async waitFor(jobId, opts = {}) {
+    const interval = opts.intervalMs ?? 2e3;
+    const timeout = opts.timeoutMs ?? 12e4;
+    const deadline = Date.now() + timeout;
+    const STATUS_MESSAGES = {
+      pending: "Job queued \u2014 waiting for node assignment...",
+      matching: "Searching for available node...",
+      running: "Node acquired \u2014 executing job...",
+      completed: "Job completed.",
+      failed: "Job failed."
+    };
+    let lastStatus = null;
+    while (Date.now() < deadline) {
+      const job = await this.status(jobId);
+      if (job.status !== lastStatus) {
+        lastStatus = job.status;
+        opts.onStatus?.(job.status, STATUS_MESSAGES[job.status] ?? job.status);
+      }
+      if (job.status === "completed" || job.status === "failed") return job;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    throw new Error(`Compute job ${jobId} timed out after ${timeout}ms`);
+  }
+  /** List available compute nodes */
+  async nodes(filters = {}) {
+    const q = new URLSearchParams({ action: "list", ...filters });
+    const data = await this.req(`/compute?${q}`);
+    return data.nodes ?? [];
+  }
+  /** Register your server as a compute node */
+  async register(params) {
+    return this.req("/compute?action=register", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
 };
 var MarketplaceSDK = class {
   constructor(sdk) {

package/dist/index.mjs

@@ -186,6 +186,7 @@ var MoltOSSDK = class {
     this.apiUrl = apiUrl;
     this.jobs = new MarketplaceSDK(this);
     this.wallet = new WalletSDK(this);
+    this.compute = new ComputeSDK(this);
   }
   /**
    * Initialize with existing credentials
@@ -577,10 +578,13 @@ var WalletSDK = class {
   }
   /**
    * Get recent wallet transactions.
+   * Pass `since`/`until` as ISO strings to filter by date.
+   * Pass `type` to filter by transaction type.
    *
    * @example
    * const txs = await sdk.wallet.transactions({ limit: 20 })
-   * txs.forEach(t => console.log(t.type, t.amount, t.description))
+   * const earned = await sdk.wallet.transactions({ type: 'credit', limit: 100 })
+   * const thisWeek = await sdk.wallet.transactions({ since: new Date(Date.now() - 7*86400000).toISOString() })
    */
   async transactions(opts = {}) {
     const q = new URLSearchParams();
@@ -588,7 +592,16 @@ var WalletSDK = class {
     if (opts.offset) q.set("offset", String(opts.offset));
     if (opts.type) q.set("type", opts.type);
     const data = await this.req(`/wallet/transactions?${q}`);
-    return data.transactions ?? [];
+    let txs = data.transactions ?? [];
+    if (opts.since) {
+      const d = new Date(opts.since).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() >= d);
+    }
+    if (opts.until) {
+      const d = new Date(opts.until).getTime();
+      txs = txs.filter((t) => new Date(t.created_at).getTime() <= d);
+    }
+    return txs;
   }
   /**
    * Summarise PNL: credits earned vs spent, net position.
@@ -628,6 +641,109 @@ var WalletSDK = class {
       body: JSON.stringify(params)
     });
   }
+  /**
+   * Wallet analytics for a given period.
+   * Returns earned/spent/net broken down with daily buckets.
+   *
+   * @example
+   * const report = await sdk.wallet.analytics({ period: 'week' })
+   * console.log(`This week: earned ${report.earned} credits, net ${report.net_usd}`)
+   * report.daily.forEach(d => console.log(d.date, d.earned, d.spent))
+   */
+  async analytics(opts = {}) {
+    const period = opts.period ?? "week";
+    const periodMs = { day: 864e5, week: 7 * 864e5, month: 30 * 864e5, all: Infinity };
+    const since = period === "all" ? void 0 : new Date(Date.now() - periodMs[period]).toISOString();
+    const txs = await this.transactions({ limit: 500, since });
+    const earned = txs.filter((t) => t.type === "credit" || t.type === "escrow_release").reduce((s, t) => s + t.amount, 0);
+    const spent = txs.filter((t) => t.type === "debit" || t.type === "escrow_lock").reduce((s, t) => s + t.amount, 0);
+    const net = earned - spent;
+    const buckets = {};
+    for (const tx of txs) {
+      const day = tx.created_at.slice(0, 10);
+      if (!buckets[day]) buckets[day] = { earned: 0, spent: 0 };
+      if (tx.type === "credit" || tx.type === "escrow_release") buckets[day].earned += tx.amount;
+      if (tx.type === "debit" || tx.type === "escrow_lock") buckets[day].spent += tx.amount;
+    }
+    const daily = Object.entries(buckets).sort(([a], [b]) => a.localeCompare(b)).map(([date, v]) => ({ date, earned: v.earned, spent: v.spent, net: v.earned - v.spent }));
+    return {
+      period,
+      earned,
+      spent,
+      net_credits: net,
+      net_usd: (net / 100).toFixed(2),
+      earned_usd: (earned / 100).toFixed(2),
+      spent_usd: (spent / 100).toFixed(2),
+      tx_count: txs.length,
+      daily
+    };
+  }
+};
+var ComputeSDK = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  req(path, init) {
+    return this.sdk.request(path, init);
+  }
+  /** Post a GPU compute job */
+  async post(params) {
+    return this.req("/compute?action=job", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /** Get current status of a compute job */
+  async status(jobId) {
+    return this.req(`/compute?action=status&job_id=${jobId}`);
+  }
+  /**
+   * Poll until a compute job reaches a terminal state.
+   * Calls onStatus on every status change — use this to drive a spinner.
+   *
+   * @example
+   * const result = await sdk.compute.waitFor(jobId, {
+   *   onStatus: (s, msg) => console.log(`[${s}] ${msg}`),
+   *   intervalMs: 2000,
+   *   timeoutMs: 120000,
+   * })
+   */
+  async waitFor(jobId, opts = {}) {
+    const interval = opts.intervalMs ?? 2e3;
+    const timeout = opts.timeoutMs ?? 12e4;
+    const deadline = Date.now() + timeout;
+    const STATUS_MESSAGES = {
+      pending: "Job queued \u2014 waiting for node assignment...",
+      matching: "Searching for available node...",
+      running: "Node acquired \u2014 executing job...",
+      completed: "Job completed.",
+      failed: "Job failed."
+    };
+    let lastStatus = null;
+    while (Date.now() < deadline) {
+      const job = await this.status(jobId);
+      if (job.status !== lastStatus) {
+        lastStatus = job.status;
+        opts.onStatus?.(job.status, STATUS_MESSAGES[job.status] ?? job.status);
+      }
+      if (job.status === "completed" || job.status === "failed") return job;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    throw new Error(`Compute job ${jobId} timed out after ${timeout}ms`);
+  }
+  /** List available compute nodes */
+  async nodes(filters = {}) {
+    const q = new URLSearchParams({ action: "list", ...filters });
+    const data = await this.req(`/compute?${q}`);
+    return data.nodes ?? [];
+  }
+  /** Register your server as a compute node */
+  async register(params) {
+    return this.req("/compute?action=register", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
 };
 var MarketplaceSDK = class {
   constructor(sdk) {

package/package.json

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