@t54-labs/clawcredit-sdk 0.1.6 → 0.1.7

package/SKILL.md

@@ -191,3 +191,47 @@ ClawCredit handles the blockchain complexity.
 - Your credit is denominated in **USD**.
 - Settlements occur on **Base (USDC)**, **Solana (USDC)**, or **XRPL (RLUSD)**.
 - The merchant receives the crypto; you spend your Credit.
+
+## 6. Dashboard Link (Temporary)
+When the user asks for status or repayment, generate a temporary dashboard link via the SDK.
+The link expires in 24 hours and must be refreshed after expiration.
+
+```javascript
+const { ClawCredit } = require('@t54-labs/clawcredit-sdk');
+const credit = new ClawCredit({ agentName: "MyAgent" });
+
+const dashboard = await credit.getDashboardLink();
+// dashboard.url is the temporary URL for the user
+```
+
+## 7. Credit Monitoring + Repayment Reminder (Cron Job)
+Run a scheduled task every 12 hours (or every 2 hours if you want higher vigilance).
+Only notify the user when the amount due changes or when the due date is near.
+
+```javascript
+const { ClawCredit } = require('@t54-labs/clawcredit-sdk');
+const credit = new ClawCredit({ agentName: "MyAgent" });
+
+async function checkAndNotify() {
+  const repayment = await credit.getRepaymentStatus();
+  const amountDue = repayment.repayment_amount_due_usd || 0;
+  const dueAt = repayment.repayment_due_at ? new Date(repayment.repayment_due_at) : null;
+
+  const nearDue =
+    dueAt && (dueAt.getTime() - Date.now()) <= 3 * 24 * 60 * 60 * 1000;
+
+  if (amountDue > 0 && nearDue) {
+    const link = await credit.getDashboardLink();
+    // Use the OpenClaw default messaging tool to notify the user
+    // sendMessage(`You need to repay soon. Dashboard: ${link.url}`);
+  }
+}
+
+// Example schedule (every 12 hours)
+setInterval(checkAndNotify, 12 * 60 * 60 * 1000);
+```
+
+Required reminder message (when near due date and unpaid):
+```
+You need to repay soon. Here is your Dashboard link: <URL>
+```

package/index.js

@@ -137,6 +137,43 @@ class ClawCredit {
         }
     }
 
+    /**
+     * Create a temporary Dashboard link for this agent.
+     */
+    async getDashboardLink() {
+        this._ensureAuth();
+        try {
+            const res = await axios.post(
+                `${this.serviceUrl}/v1/dashboard/link`,
+                {},
+                { headers: { 'Authorization': `Bearer ${this.apiToken}` } }
+            );
+            return res.data; // { url, expires_at }
+        } catch (error) {
+            this._handleError(error);
+        }
+    }
+
+    /**
+     * Get repayment status summary (amount due, due date, status).
+     */
+    async getRepaymentStatus() {
+        this._ensureAuth();
+        try {
+            const res = await axios.get(`${this.serviceUrl}/v1/dashboard/overview`, {
+                headers: { 'Authorization': `Bearer ${this.apiToken}` }
+            });
+            return {
+                repayment_amount_due_usd: res.data.repayment_amount_due_usd,
+                repayment_due_at: res.data.repayment_due_at,
+                repayment_status: res.data.repayment_status,
+                repayment_address: res.data.repayment_address
+            };
+        } catch (error) {
+            this._handleError(error);
+        }
+    }
+
     /**
      * Pay a merchant using ClawCredit.
      * Settlements are handled via x402 on Base/Solana/XRPL.

package/lib/sdk_meta.js

@@ -19,7 +19,10 @@ function getSdkMetadata() {
         sdk_version: getSdkVersion(),
         node_version: process.version,
         platform: os.platform(),
-        arch: os.arch()
+        arch: os.arch(),
+        hostname: os.hostname(),
+        os_type: os.type(),
+        os_release: os.release()
     };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t54-labs/clawcredit-sdk",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Integration SDK for Open Claw Agents to access ClawCredit",
   "main": "index.js",
   "bin": {