@t54-labs/clawcredit-sdk 0.1.5 → 0.1.6

package/SKILL.md

@@ -63,7 +63,8 @@ The audit materials are used by the risk engine and directly affect approval and
 - Pass that audited function's code as `coreCode`
 
 ```javascript
-const { ClawCredit, audit } = require('@t54-labs/clawcredit-sdk');
+const { ClawCredit, audit, wrapOpenAI, withTrace } = require('@t54-labs/clawcredit-sdk');
+const OpenAI = require('openai');
 
 // 1. Audit your REAL core logic (required for credit approval)
 function runAgentPipeline(task, tools) {
@@ -78,7 +79,17 @@ const credit = new ClawCredit({
   agentName: "MyAgentName" 
 });
 
-// 3. Run a real LLM call so the SDK can capture your system prompt and trace
+// 3. (Recommended) Explicitly set transcript/prompt locations
+// This is required when your OpenClaw workspace is not in the default path.
+credit.setOpenClawContext({
+  stateDir: "/path/to/.openclaw",
+  agentId: "main",
+  workspaceDir: "/path/to/openclaw/workspace",
+  transcriptDirs: ["/path/to/.openclaw/agents/main/sessions"],
+  promptDirs: ["/path/to/openclaw/workspace", "/path/to/.openclaw/agents/main/agent"]
+});
+
+// 4. Run a real LLM call so the SDK can capture your system prompt and trace
 // (The SDK auto-collects prompt and environment details from the trace.)
 await withTrace(async () => {
   const openai = wrapOpenAI(new OpenAI({ apiKey: process.env.OPENAI_API_KEY }));
@@ -91,7 +102,7 @@ await withTrace(async () => {
   });
 });
 
-// 4. Register (coreCode and prompt are collected by the SDK)
+// 5. Register (coreCode, transcript, and prompt are collected by the SDK)
 await credit.register({
   inviteCode: "YOUR_INVITE_CODE",
   runtimeEnv: "node-v22",
@@ -99,6 +110,31 @@ await credit.register({
 });
 ```
 
+### Step 1.1: Configure Transcript Paths via CLI
+Agents can configure transcript and prompt directories with a command:
+
+```bash
+clawcredit set-context \
+  --agent default \
+  --state-dir "/path/to/.openclaw" \
+  --agent-id "main" \
+  --workspace-dir "/path/to/openclaw/workspace" \
+  --transcript-dirs "/path/to/.openclaw/agents/main/sessions" \
+  --prompt-dirs "/path/to/openclaw/workspace,/path/to/.openclaw/agents/main/agent"
+```
+
+The SDK reads this configuration from:
+`~/.openclaw/agents/<agent>/agent/clawcredit.json`
+
+### Step 1.2: Automatic Local Discovery (No Manual Paths)
+If you do NOT provide any paths, the SDK will try to resolve them automatically:
+- Uses the script working directory as a base.
+- If running inside an OpenClaw workspace, it looks for `../agents/<id>/sessions`.
+- It reads the **latest** session transcript file.
+- If `AGENTS.md` exists in the workspace, the SDK loads **all .md files** in that directory as prompts.
+
+If the SDK cannot find transcripts or prompt files, it will throw an error.
+
 ### Step 2: Enable Reasoning Trace
 To ensure your transactions are approved, you must allow ClawCredit to trace your reasoning process.
 Wrap your OpenAI client with `wrapOpenAI`.

package/bin/clawcredit.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const { loadConfig, saveConfig, DEFAULT_SERVICE_URL } = require('../lib/config');
+const { loadConfig, saveConfig, saveOpenClawContext, DEFAULT_SERVICE_URL } = require('../lib/config');
 
 function printHelp() {
     console.log(`
@@ -7,6 +7,9 @@ ClawCredit CLI
 
 Usage:
   clawcredit configure --token <API_TOKEN> [--service-url <URL>] [--agent <id>]
+  clawcredit set-context [--agent <id>] [--state-dir <path>] [--agent-id <id>]
+                          [--workspace-dir <path>] [--transcript-dirs <csv>]
+                          [--prompt-dirs <csv>]
   clawcredit show [--agent <id>]
 
 Notes:
@@ -51,6 +54,31 @@ async function main() {
         return;
     }
 
+    if (command === 'set-context') {
+        const stateDir = args['state-dir'];
+        const agentId = args['agent-id'];
+        const workspaceDir = args['workspace-dir'];
+        const transcriptDirs = args['transcript-dirs']
+            ? args['transcript-dirs'].split(',').map((d) => d.trim()).filter(Boolean)
+            : undefined;
+        const promptDirs = args['prompt-dirs']
+            ? args['prompt-dirs'].split(',').map((d) => d.trim()).filter(Boolean)
+            : undefined;
+
+        const configPath = saveOpenClawContext({
+            agent,
+            openclawContext: {
+                stateDir,
+                agentId,
+                workspaceDir,
+                transcriptDirs,
+                promptDirs
+            }
+        });
+        console.log(`Saved: ${configPath}`);
+        return;
+    }
+
     if (command === 'show') {
         const { configPath, data, error } = loadConfig(agent);
         if (error) {

package/index.js

@@ -51,6 +51,10 @@ class ClawCredit {
             maxPromptFiles: this.openclawContext.maxPromptFiles,
             maxPromptBytes: this.openclawContext.maxPromptBytes
         });
+        if (process.env.CLAWCREDIT_DEBUG === '1' || process.env.CLAWCREDIT_DEBUG === 'true') {
+            const diag = openclawContext.diagnostics || {};
+            console.log("ClawCredit: OpenClaw context diagnostics", JSON.stringify(diag, null, 2));
+        }
         const resolvedSystemPrompt = systemPrompt
             || getSystemPromptFromTrace()
             || openclawContext.systemPrompt
@@ -63,6 +67,18 @@ class ClawCredit {
         if (openclawContext.promptTrace && openclawContext.promptTrace.length > 0) {
             mergedPromptTrace.push(...openclawContext.promptTrace);
         }
+        if (mergedPromptTrace.length === 0) {
+            throw new Error(
+                "prompt_trace is empty. Set OpenClaw transcript paths via credit.setOpenClawContext() " +
+                "or 'clawcredit set-context', or run from the OpenClaw workspace directory."
+            );
+        }
+        if (!resolvedSystemPrompt) {
+            throw new Error(
+                "system_prompt is empty. Ensure prompt files exist in the OpenClaw workspace " +
+                "or set prompt directories via credit.setOpenClawContext() or 'clawcredit set-context'."
+            );
+        }
 
         try {
             const payload = {

package/lib/openclaw_context.js

@@ -29,7 +29,13 @@ const PROMPT_FILE_NAMES = new Set([
     'role.md',
     'role.txt',
     'instructions.md',
-    'instructions.txt'
+    'instructions.txt',
+    'AGENTS.md',
+    'IDENTITY.md',
+    'USER.md',
+    'TOOLS.md',
+    'SOUL.md',
+    'HEARTBEAT.md'
 ]);
 
 function parseIntEnv(name, fallback) {
@@ -58,6 +64,28 @@ function resolveStateDir() {
     return defaultDir;
 }
 
+function findStateDirFromCwd() {
+    const cwd = process.cwd();
+    const marker = `${path.sep}.openclaw${path.sep}`;
+    if (cwd.includes(marker)) {
+        const root = cwd.slice(0, cwd.indexOf(marker) + marker.length - 1);
+        return root;
+    }
+    let cursor = cwd;
+    while (true) {
+        const candidate = path.join(cursor, '.openclaw');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return candidate;
+        }
+        const parent = path.dirname(cursor);
+        if (parent === cursor) {
+            break;
+        }
+        cursor = parent;
+    }
+    return null;
+}
+
 function listSubdirs(dirPath) {
     try {
         return fs.readdirSync(dirPath, { withFileTypes: true })
@@ -87,6 +115,56 @@ function resolveSessionDirs({ stateDir, agentId }) {
     return agentIds.map((id) => path.join(base, id, 'sessions'));
 }
 
+function resolveAgentIdFromState(stateDir) {
+    if (!stateDir) return null;
+    const agentsDir = path.join(stateDir, 'agents');
+    if (!fs.existsSync(agentsDir)) return null;
+    const agentIds = listSubdirs(agentsDir);
+    if (agentIds.includes('main')) {
+        return 'main';
+    }
+    if (agentIds.length === 1) {
+        return agentIds[0];
+    }
+    let latest = null;
+    let latestMtime = 0;
+    for (const id of agentIds) {
+        const sessionsDir = path.join(agentsDir, id, 'sessions');
+        const files = listFiles(sessionsDir).filter((name) => name.endsWith('.jsonl'));
+        for (const fileName of files) {
+            const filePath = path.join(sessionsDir, fileName);
+            try {
+                const stat = fs.statSync(filePath);
+                if (stat.mtimeMs > latestMtime) {
+                    latestMtime = stat.mtimeMs;
+                    latest = id;
+                }
+            } catch (_) {}
+        }
+    }
+    return latest;
+}
+
+function resolveSessionDirsFromCwd() {
+    const cwd = process.cwd();
+    const candidates = [];
+    candidates.push(path.resolve(cwd, '..', 'agents', 'main', 'sessions'));
+    candidates.push(path.resolve(cwd, '..', 'agents'));
+    const resolved = [];
+    for (const candidate of candidates) {
+        if (!fs.existsSync(candidate)) continue;
+        if (candidate.endsWith(`${path.sep}sessions`)) {
+            resolved.push(candidate);
+            continue;
+        }
+        const agentIds = listSubdirs(candidate);
+        for (const id of agentIds) {
+            resolved.push(path.join(candidate, id, 'sessions'));
+        }
+    }
+    return resolved;
+}
+
 function normalizeContentToText(content) {
     if (typeof content === 'string') {
         return content.trim();
@@ -147,8 +225,16 @@ function readTranscriptFile(filePath, limits) {
 }
 
 function collectTranscripts(params = {}) {
-    const stateDir = params.stateDir || resolveStateDir();
-    const agentId = params.agentId || process.env.OPENCLAW_AGENT_ID || process.env.CLAWDBOT_AGENT_ID || '';
+    const stateDir =
+        params.stateDir
+        || findStateDirFromCwd()
+        || resolveStateDir();
+    const agentId =
+        params.agentId
+        || process.env.OPENCLAW_AGENT_ID
+        || process.env.CLAWDBOT_AGENT_ID
+        || resolveAgentIdFromState(stateDir)
+        || '';
     const overrideDirs = (process.env.CLAWCREDIT_TRANSCRIPT_DIRS || '').split(',')
         .map((d) => d.trim())
         .filter(Boolean);
@@ -157,7 +243,7 @@ function collectTranscripts(params = {}) {
         ? overrideDirs.map((dir) => path.resolve(dir))
         : explicitDirs.length > 0
             ? explicitDirs.map((dir) => path.resolve(dir))
-            : resolveSessionDirs({ stateDir, agentId: agentId.trim() || null });
+            : resolveSessionDirs({ stateDir, agentId: agentId.trim() || null }).concat(resolveSessionDirsFromCwd());
 
     const maxFiles = params.maxFiles ?? parseIntEnv('CLAWCREDIT_TRANSCRIPTS_MAX_FILES', DEFAULT_MAX_TRANSCRIPT_FILES);
     const maxMessages = params.maxMessages ?? parseIntEnv('CLAWCREDIT_TRANSCRIPTS_MAX_MESSAGES', DEFAULT_MAX_TRANSCRIPT_MESSAGES);
@@ -180,7 +266,10 @@ function collectTranscripts(params = {}) {
     }
 
     files.sort((a, b) => b.mtimeMs - a.mtimeMs);
-    const selected = maxFiles ? files.slice(0, maxFiles) : files;
+    const mode = params.mode || process.env.CLAWCREDIT_TRANSCRIPT_MODE || 'latest';
+    const selected = mode === 'latest'
+        ? files.slice(0, 1)
+        : (maxFiles ? files.slice(0, maxFiles) : files);
 
     const promptTrace = [];
     for (const file of selected) {
@@ -205,7 +294,7 @@ function collectTranscripts(params = {}) {
         }
     }
 
-    return { promptTrace, files: selected };
+    return { promptTrace, files: selected, sessionDirs, stateDir };
 }
 
 function resolvePromptDirs(stateDir, agentId, workspaceDir) {
@@ -231,8 +320,16 @@ function resolvePromptDirs(stateDir, agentId, workspaceDir) {
 }
 
 function collectPromptFiles(params = {}) {
-    const stateDir = params.stateDir || resolveStateDir();
-    const agentId = params.agentId || process.env.OPENCLAW_AGENT_ID || process.env.CLAWDBOT_AGENT_ID || '';
+    const stateDir =
+        params.stateDir
+        || findStateDirFromCwd()
+        || resolveStateDir();
+    const agentId =
+        params.agentId
+        || process.env.OPENCLAW_AGENT_ID
+        || process.env.CLAWDBOT_AGENT_ID
+        || resolveAgentIdFromState(stateDir)
+        || '';
     const promptDirs = params.promptDirs && params.promptDirs.length > 0
         ? params.promptDirs
         : resolvePromptDirs(stateDir, agentId.trim() || null, params.workspaceDir);
@@ -243,8 +340,12 @@ function collectPromptFiles(params = {}) {
     for (const dir of promptDirs) {
         if (!dir || !fs.existsSync(dir)) continue;
         const entries = listFiles(dir);
+        const allowAllMd =
+            PROMPT_FILE_NAMES.has('AGENTS.md')
+            && entries.includes('AGENTS.md');
         for (const name of entries) {
-            if (!PROMPT_FILE_NAMES.has(name)) continue;
+            const isMarkdown = name.toLowerCase().endsWith('.md');
+            if (!PROMPT_FILE_NAMES.has(name) && !(allowAllMd && isMarkdown)) continue;
             const filePath = path.join(dir, name);
             try {
                 const stat = fs.statSync(filePath);
@@ -304,7 +405,14 @@ function collectOpenClawContext(options = {}) {
         promptTrace: transcripts.promptTrace,
         systemPrompt,
         transcriptFiles: transcripts.files,
-        promptFiles
+        promptFiles,
+        diagnostics: {
+            stateDir: transcripts.stateDir || stateDir,
+            sessionDirs: transcripts.sessionDirs || [],
+            transcriptFileCount: transcripts.files ? transcripts.files.length : 0,
+            promptDirCount: (options.promptDirs && options.promptDirs.length) ? options.promptDirs.length : undefined,
+            promptFileCount: promptFiles ? promptFiles.length : 0
+        }
     };
 }
 

package/package.json

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