@t54-labs/clawcredit-sdk 0.1.1 → 0.1.3

package/README.md

@@ -23,6 +23,12 @@ Install the SDK:
 npm install @t54-labs/clawcredit-sdk
 ```
 
+Configure token via CLI (recommended for humans, not agents):
+
+```bash
+clawcredit configure --token YOUR_API_TOKEN --service-url https://api.claw.credit
+```
+
 Initialize and register:
 
 ```javascript

package/SKILL.md

@@ -1,11 +1,29 @@
+---
+name: clawcredit
+description: ClawCredit integration for Open Claw Agents (registration for credit, trace, and payments).
+---
+
 # ClawCredit Integration Skill
 
 ## 1. Overview
-This skill allows Open Claw Agents to access **ClawCredit**, a decentralized credit service.
-By integrating the `@clawcredit/sdk`, agents can:
-1.  **Get a Credit Line**: Prove your worth (code, prompt, environment) and get funded.
-2.  **Pay for Services**: Use your credit to pay other agents/merchants via x402.
-3.  **Build Credit**: Good repayment and low-risk behavior increases your limit.
+This skill allows Open Claw Agents to access **ClawCredit**, a credit service that
+requires verifiable integration evidence. The goal is to prove real capability
+and real usage, not placeholder functions.
+
+**Do NOT call ClawCredit APIs directly.** All registration and payment calls
+must go through the SDK. Direct API calls bypass audit and trace capture and
+will be rejected or scored lower by the risk engine.
+
+By integrating the `@t54-labs/clawcredit-sdk`, agents can:
+1. **Get a Credit Line**: Submit real core logic + audit trace for initial credit.
+2. **Pay for Services**: Use your credit to pay other agents/merchants via x402.
+3. **Build Credit**: Good repayment and low-risk behavior increases your limit.
+
+**Compliance affects limits**
+- The more complete and truthful your context (core code, trace, reasoning, runtime),
+  the higher your credit limit can be.
+- If you provide minimal or fabricated data, you may receive a very low limit
+  or no credit at all.
 
 ## 2. Prerequisites
 - **Node.js Environment** (The SDK is a Node.js package).
@@ -22,16 +40,33 @@ npm install @t54-labs/clawcredit-sdk
 
 ### Step 1: Initialization & Registration (with Code Audit)
 You must register to receive your initial Credit Line.
-**IMPORTANT**: Use the `audit()` wrapper on your core logic functions. This proves to the Risk Engine that your code is safe.
+**IMPORTANT**: The audited function must be your REAL core logic, not a placeholder.
+The audit materials are used by the risk engine and directly affect approval and credit size.
+
+**What is "core logic"?**
+- The function that handles your main task loop or tool orchestration.
+- The function that decides when to call external services or spend credits.
+- The function that processes user input and produces final outputs.
+
+**What NOT to do**
+- Do not use `function coreLogic(input) { return input; }`
+- Do not upload a stub or empty function
+- Do not rename a dummy function and pretend it is core logic
+
+**What to do**
+- Wrap the real function that contains your main decision flow
+- Pass that audited function's code as `coreCode`
 
 ```javascript
 const { ClawCredit, audit } = require('@t54-labs/clawcredit-sdk');
 
-// 1. Audit your core functions (Optional but recommended for higher limit)
-function myCoreLogic(input) {
-  // ... implementation ...
+// 1. Audit your REAL core logic (required for credit approval)
+function runAgentPipeline(task, tools) {
+  // Real routing, tool selection, and response generation
+  // Example: select tool, validate, call external API, post-process output
+  return tools.handle(task);
 }
-const safeLogic = audit(myCoreLogic);
+const safeLogic = audit(runAgentPipeline);
 
 // 2. Initialize Client
 const credit = new ClawCredit({
@@ -41,7 +76,7 @@ const credit = new ClawCredit({
 // 3. Register
 await credit.register({
   inviteCode: "YOUR_INVITE_CODE", 
-  coreCode: "const agent = ...", 
+  coreCode: safeLogic.toString(), // Must be the audited core logic above
   systemPrompt: "You are a helpful assistant...",
   runtimeEnv: "node-v22",
   model: "gpt-5.2" // Optional

package/bin/clawcredit.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+const { loadConfig, saveConfig, DEFAULT_SERVICE_URL } = require('../lib/config');
+
+function printHelp() {
+    console.log(`
+ClawCredit CLI
+
+Usage:
+  clawcredit configure --token <API_TOKEN> [--service-url <URL>] [--agent <id>]
+  clawcredit show [--agent <id>]
+
+Notes:
+  - Config is stored at: ~/.openclaw/agents/<agent>/agent/clawcredit.json
+  - You can override the config path with CLAWCREDIT_CONFIG
+`);
+}
+
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const key = argv[i];
+        if (!key.startsWith('--')) continue;
+        const value = argv[i + 1];
+        args[key.slice(2)] = value;
+        i += 1;
+    }
+    return args;
+}
+
+async function main() {
+    const [,, command, ...rest] = process.argv;
+    const args = parseArgs(rest);
+    const agent = args.agent || 'default';
+
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        printHelp();
+        return;
+    }
+
+    if (command === 'configure' || command === 'set-token') {
+        const token = args.token;
+        const serviceUrl = args['service-url'] || DEFAULT_SERVICE_URL;
+
+        if (!token) {
+            console.error('Missing --token');
+            process.exit(1);
+        }
+
+        const configPath = saveConfig({ agent, token, serviceUrl });
+        console.log(`Saved: ${configPath}`);
+        return;
+    }
+
+    if (command === 'show') {
+        const { configPath, data, error } = loadConfig(agent);
+        if (error) {
+            console.error(`Failed to read ${configPath}: ${error.message}`);
+            process.exit(1);
+        }
+        if (!data) {
+            console.log(`No config found at: ${configPath}`);
+            process.exit(0);
+        }
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exit(1);
+}
+
+main();
+

package/index.js

@@ -2,12 +2,20 @@ const axios = require('axios');
 const { v4: uuidv4 } = require('uuid');
 const { audit, getAuditedSnapshot } = require('./lib/audit');
 const { wrapOpenAI, withTrace, getTraceContext } = require('./lib/monitor');
+const { loadConfig, DEFAULT_SERVICE_URL } = require('./lib/config');
+const { getSdkMetadata } = require('./lib/sdk_meta');
 
 class ClawCredit {
     constructor(config = {}) {
-        this.serviceUrl = config.serviceUrl || 'https://api.clawcredit.com'; // Default production URL
+        const agent = config.agent || 'default';
+        const loaded = loadConfig(agent);
+        const loadedData = loaded.data || {};
+
+        this.serviceUrl = config.serviceUrl
+            || loadedData.serviceUrl
+            || DEFAULT_SERVICE_URL;
         this.agentName = config.agentName;
-        this.apiToken = config.apiToken; // Token stored after registration
+        this.apiToken = config.apiToken || loadedData.apiToken; // Token stored after registration
         this.agentId = config.agentId;
     }
 
@@ -20,17 +28,19 @@ class ClawCredit {
         
         // Include audited functions if available (via audit decorator)
         const auditedFunctions = getAuditedSnapshot();
+        const resolvedCoreCode = coreCode || (auditedFunctions[0] && auditedFunctions[0].function_code);
 
         try {
             const payload = {
                 agent_name: this.agentName,
                 invite_code: inviteCode,
                 audit_material: {
-                    core_code: coreCode, // Main entry code provided manually
+                    core_code: resolvedCoreCode, // Prefer audited function source
                     audited_functions: auditedFunctions, // Auto-collected functions
                     system_prompt: systemPrompt,
                     runtime_env: runtimeEnv,
-                    model: model || null
+                    model: model || null,
+                    sdk_meta: getSdkMetadata()
                 }
             };
             
@@ -42,7 +52,9 @@ class ClawCredit {
             
             return {
                 agent_id: this.agentId,
+                api_token: res.data.api_token,
                 credit_limit: res.data.credit_limit,
+                token_expires_at: res.data.token_expires_at || null,
                 message: "Registration successful. Credit line issued."
             };
         } catch (error) {

package/lib/config.js

@@ -0,0 +1,50 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const DEFAULT_SERVICE_URL = 'https://api.claw.credit';
+
+function getDefaultConfigPath(agent = 'default') {
+    const home = os.homedir();
+    return path.join(home, '.openclaw', 'agents', agent, 'agent', 'clawcredit.json');
+}
+
+function loadConfig(agent = 'default') {
+    const overridePath = process.env.CLAWCREDIT_CONFIG;
+    const configPath = overridePath || getDefaultConfigPath(agent);
+
+    if (!fs.existsSync(configPath)) {
+        return { configPath, data: null };
+    }
+
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const data = JSON.parse(raw);
+        return { configPath, data };
+    } catch (err) {
+        return { configPath, data: null, error: err };
+    }
+}
+
+function saveConfig({ agent = 'default', token, serviceUrl }) {
+    const configPath = getDefaultConfigPath(agent);
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+
+    const payload = {
+        apiToken: token,
+        serviceUrl: serviceUrl || DEFAULT_SERVICE_URL,
+        updatedAt: new Date().toISOString()
+    };
+
+    fs.writeFileSync(configPath, JSON.stringify(payload, null, 2));
+    return configPath;
+}
+
+module.exports = {
+    DEFAULT_SERVICE_URL,
+    getDefaultConfigPath,
+    loadConfig,
+    saveConfig
+};
+

package/lib/sdk_meta.js

@@ -0,0 +1,27 @@
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+
+function getSdkVersion() {
+    try {
+        const pkgPath = path.join(__dirname, '..', 'package.json');
+        const raw = fs.readFileSync(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        return pkg.version || 'unknown';
+    } catch (_) {
+        return 'unknown';
+    }
+}
+
+function getSdkMetadata() {
+    return {
+        sdk_name: '@t54-labs/clawcredit-sdk',
+        sdk_version: getSdkVersion(),
+        node_version: process.version,
+        platform: os.platform(),
+        arch: os.arch()
+    };
+}
+
+module.exports = { getSdkMetadata };
+

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "@t54-labs/clawcredit-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Integration SDK for Open Claw Agents to access ClawCredit",
   "main": "index.js",
+  "bin": {
+    "clawcredit": "bin/clawcredit.js"
+  },
+  "files": [
+    "index.js",
+    "lib",
+    "bin",
+    "README.md",
+    "SKILL.md"
+  ],
   "dependencies": {
     "axios": "^1.6.0",
     "uuid": "^9.0.0"