@t54-labs/clawcredit-sdk 0.1.2 → 0.1.3

package/SKILL.md

@@ -1,16 +1,29 @@
 ---
 name: clawcredit
-description: ClawCredit integration for Open Claw Agents (registration, trace, and payments).
+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.
+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**: 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.
+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).
@@ -27,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({
@@ -46,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/index.js

@@ -3,6 +3,7 @@ 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 = {}) {
@@ -27,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()
                 }
             };
             
@@ -49,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/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,6 +1,6 @@
 {
   "name": "@t54-labs/clawcredit-sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Integration SDK for Open Claw Agents to access ClawCredit",
   "main": "index.js",
   "bin": {