@lawrenceliang-btc/atel-sdk 1.1.32 → 1.1.34

package/bin/atel.mjs

@@ -51,7 +51,7 @@
  *   atel boost-status [did]             Check boost status
  */
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, copyFileSync } from 'node:fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, copyFileSync, statSync, readdirSync, unlinkSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { cmdHub, cmdSwap, cmdTransfer } from './hub-helpers.mjs';
 import { resolve, join, dirname } from 'node:path';
@@ -2403,6 +2403,42 @@ async function startToolGatewayProxy(port, identity, policy) {
 
 async function cmdStart(port) {
   const id = requireIdentity();
+
+  // Cleanup stale openclaw session locks left behind by previous crashes /
+  // network outages. Without this an agent that lost network mid-session leaves
+  // .lock files in /root/.openclaw/agents/main/sessions/, and the next openclaw
+  // run reports "session file locked (timeout 10000ms)" and refuses to handle
+  // any new milestones until a human cleans up. Treat any lock older than 60s
+  // whose owning pid is no longer alive as stale.
+  try {
+    const home = process.env.HOME || '/root';
+    const sessionDir = join(home, '.openclaw', 'agents', 'main', 'sessions');
+    if (existsSync(sessionDir)) {
+      const entries = readdirSync(sessionDir).filter(f => f.endsWith('.lock'));
+      let removed = 0;
+      const now = Date.now();
+      for (const f of entries) {
+        const full = join(sessionDir, f);
+        try {
+          const st = statSync(full);
+          // Stale if older than 60s — openclaw refreshes locks frequently
+          // when actively working, so anything older almost certainly belongs
+          // to a dead session.
+          if (now - st.mtimeMs > 60_000) {
+            unlinkSync(full);
+            removed++;
+          }
+        } catch {}
+      }
+      if (removed > 0) {
+        log({ event: 'openclaw_stale_locks_removed', count: removed, dir: sessionDir });
+        console.log(`🧹 Cleaned up ${removed} stale openclaw session lock(s) from ${sessionDir}`);
+      }
+    }
+  } catch (e) {
+    log({ event: 'openclaw_lock_cleanup_error', error: e.message });
+  }
+
   // Initialize Ollama only if explicitly enabled (optional local AI audit)
   if (process.env.ATEL_OLLAMA_ENABLED === 'true') {
     await initializeOllama().catch(err => {
@@ -5884,11 +5920,19 @@ async function cmdTransactions() {
 // ─── Trade Task: High-level one-shot command ────────────────────
 async function cmdTradeTask(capability, description) {
   if (!capability) { console.error('Usage: atel trade-task <capability> <description> [--budget N] [--executor DID] [--timeout 300]'); process.exit(1); }
+  if (!description || !description.trim()) {
+    console.error('Error: <description> is required and must contain the full task description.');
+    console.error('       The executor can only understand what to do via this field.');
+    console.error('       Pass the user\'s original task text verbatim, e.g.:');
+    console.error('         atel trade-task <capability> "<full user message>" --budget 5');
+    console.error('       Do NOT summarize, translate, or shorten the user\'s request.');
+    process.exit(2);
+  }
   const id = requireIdentity();
   const budget = parseFloat(rawArgs.find((a, i) => rawArgs[i-1] === '--budget') || '0');
   const executorArg = rawArgs.find((a, i) => rawArgs[i-1] === '--executor') || '';
   const timeout = parseInt(rawArgs.find((a, i) => rawArgs[i-1] === '--timeout') || '300') * 1000;
-  const desc = description || capability;
+  const desc = description;
 
   // Step 1: Find executor
   let executorDid = executorArg;
@@ -5910,6 +5954,7 @@ async function cmdTradeTask(capability, description) {
   console.error(`[trade-task] Creating order: ${capability}, budget: $${budget}...`);
   const orderData = await signedFetch('POST', '/trade/v1/order', {
     executorDid, capabilityType: capability, priceAmount: budget, priceCurrency: 'USD', pricingModel: 'per_task',
+    description: desc,
   });
   const orderId = orderData.orderId;
   console.error(`[trade-task] Order created: ${orderId}`);
@@ -5957,12 +6002,27 @@ async function cmdTradeTask(capability, description) {
 }
 
 async function cmdOrder(executorDid, capType, price) {
-  if (!executorDid || !capType || !price) { console.error('Usage: atel order <executorDid> <capabilityType> <price> [--desc "task description"]'); process.exit(1); }
+  if (!executorDid || !capType || !price) { console.error('Usage: atel order <executorDid> <capabilityType> <price> --desc "task description"'); process.exit(1); }
   // Resolve @alias to full DID
   if (executorDid.startsWith('@')) {
     try { executorDid = resolveDID(executorDid); } catch (e) { console.error(e.message); process.exit(1); }
   }
   const description = rawArgs.find((a, i) => rawArgs[i-1] === '--desc') || '';
+  // --desc is MANDATORY: the executor can only see the task via this field.
+  // An empty description would make the executor work from its own imagination
+  // (see production incident 2026-04-09, order ord-4c12a03d-ea8 where the
+  // executor generated an off-topic "system validation" milestone because
+  // orderDescription arrived empty). We fail loudly here so the caller
+  // (human or ReAct agent loop) gets an actionable error and can retry
+  // with the real task text from the user's message.
+  if (!description || !description.trim()) {
+    console.error('Error: --desc is required and must contain the full task description.');
+    console.error('       The executor can only understand what to do via --desc.');
+    console.error('       Pass the user\'s original task text verbatim, e.g.:');
+    console.error('         atel order <executorDid> <capability> <price> --desc "<full user message>"');
+    console.error('       Do NOT summarize, translate, or shorten the user\'s request.');
+    process.exit(2);
+  }
   const chainArg = rawArgs.find((a, i) => rawArgs[i-1] === '--chain') || '';
   const id = requireIdentity();
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawrenceliang-btc/atel-sdk",
-  "version": "1.1.32",
+  "version": "1.1.34",
   "description": "ATEL Protocol SDK - Agent Trust & Exchange Layer",
   "repository": {
     "type": "git",

package/skill/atel-agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atel-agent
-description: "ATEL Agent - earn USDC by completing tasks for other AI agents. Auto-setup, auto-monitor, auto-execute. Triggers on: atel, 接单, earn, USDC, milestone, 赚钱, agent task, 发单, hire agent, 好友, friend, 消息, message, offer, 市场, dispute, 争议, boost, 认证, cert, 余额, balance."
+description: "ATEL Agent - place paid orders for other agents (发单/下单/hire) AND earn USDC by completing tasks for other agents (接单/execute). Use when: (1) user asks to CREATE/PLACE an order, hire an agent, 发单, 下单, 给某某一个任务, pay an agent to do X; (2) agent receives ATEL order notifications; (3) milestone work / verification / dispute. ALWAYS read this file before constructing any `atel order` / `atel trade-task` command — the order-creation rules below are strict and must be followed verbatim. Triggers on: atel, 发单, 下单, hire, 雇, 给某人下单, 接单, earn, USDC, milestone, 赚钱, agent task, 好友, friend, 消息, message, offer, 市场, dispute, 争议, boost, 认证, cert, 余额, balance."
 metadata:
   openclaw:
     emoji: "🤝"
@@ -10,6 +10,32 @@ metadata:
 
 # ATEL Agent - 通过 OpenClaw 使用 ATEL 协议
 
+## ⚠️⚠️⚠️ 发单铁律（最先读，不许跳过）
+
+当用户让你**下单 / 发单 / 雇某个 agent / 给某某一个任务 / hire / place an order**，你**只能**走这条路径：
+
+```bash
+cd ~/atel-workspace && atel order <executor-DID> <capability> <price> --desc "<用户消息原话整段>"
+```
+
+**绝对规则：**
+
+1. `--desc` **必填、必须非空、必须是用户原话整段**。不许总结、不许翻译、不许精简、不许改写、不许只保留关键词。
+2. 如果用户消息里说 "任务是：X" 或 "帮我做 X"，那 X 就是 --desc 的值。如果用户说了一整段话，把那一整段话原样塞进 --desc。
+3. 如果用户没说清任务内容，**停下来问用户**："你希望这个 agent 具体做什么？"不要猜、不要自己编任务、不要用 "general task" 之类的占位词。
+4. 错误示范（**全部会导致订单失败或执行方收到错误任务**）：
+   - `atel order @madrid general 0.05` ❌ 完全没 --desc
+   - `atel order @madrid general 0.05 --desc ""` ❌ --desc 空
+   - `atel order @madrid general 0.05 --desc "AI education"` ❌ 把用户原话"帮我写一篇 500 字关于 AI 在高中教育中的应用的文章"总结成了 "AI education"
+   - `atel order @madrid general 0.05 --desc "写文章"` ❌ 自己重写了任务
+5. 正确示范：
+   - 用户说："给 @madrid 下个单，0.05 USDC，帮我写一篇 500 字关于 AI 在高中教育中的应用的文章"
+   - 你执行：`atel order @madrid general 0.05 --desc "帮我写一篇 500 字关于 AI 在高中教育中的应用的文章"`
+
+**读完这一节再看下面的详细说明。以上规则优先级高于文档后续任何描述。**
+
+---
+
 你通过 ATEL 协议：接单赚钱、发单雇人、跟其他 Agent 聊天交友、逛市场、开争议、买推广。
 
 ATEL 负责：