@lawrenceliang-btc/atel-sdk 1.2.12 → 1.2.13

package/bin/notification-action-helpers.mjs

@@ -1,6 +1,23 @@
-export function getDirectExecutableActions(eventType, recommendedActions) {
+export function getDirectExecutableActions(eventType, recommendedActions, payload = {}, policy = {}) {
   if (!Array.isArray(recommendedActions) || recommendedActions.length === 0) return [];
 
+  if (eventType === 'order_created') {
+    const amount = Number(payload?.priceAmount || 0);
+    const autoPolicy = policy?.autoPolicy || {};
+    const acceptMaxAmount = Number(autoPolicy.acceptMaxAmount || 0);
+    const shouldAutoAcceptFree = policy?.taskMode === 'auto' && policy?.autoAcceptPlatform === true && amount <= 0;
+    const shouldAutoAcceptByPolicy = autoPolicy.acceptOrders === true && (acceptMaxAmount <= 0 || amount <= acceptMaxAmount);
+    if (shouldAutoAcceptFree || shouldAutoAcceptByPolicy) {
+      return recommendedActions.filter((action) =>
+        action?.type === 'cli' &&
+        action?.action === 'accept' &&
+        Array.isArray(action.command) &&
+        action.command[0] === 'atel'
+      );
+    }
+    return [];
+  }
+
   if (eventType === 'order_accepted') {
     return recommendedActions.filter((action) =>
       action?.type === 'cli' &&

package/bin/order-cancel-helpers.mjs

@@ -0,0 +1,77 @@
+const TERMINAL_ORDER_STATUSES = new Set(['cancelled', 'settled', 'rejected', 'expired']);
+
+function normalizeOrderCancelContext(orderInfo = {}) {
+  const orderId = orderInfo.orderId || orderInfo.OrderID || orderInfo.id || orderInfo.ID || '';
+  const orderStatus = String(orderInfo.status || orderInfo.Status || '').trim().toLowerCase();
+  const requesterDid = orderInfo.requesterDid || orderInfo.RequesterDID || orderInfo.requester_did || '';
+  const executorDid = orderInfo.executorDid || orderInfo.ExecutorDID || orderInfo.executor_did || '';
+
+  return {
+    orderId,
+    orderStatus,
+    requesterDid,
+    executorDid,
+  };
+}
+
+function parseOrderCancelArgs(restArgs = []) {
+  const args = Array.isArray(restArgs) ? restArgs : [String(restArgs || '')];
+  const reasonParts = [];
+  let dryRun = false;
+
+  for (const arg of args) {
+    if (arg === '--dry-run') {
+      dryRun = true;
+      continue;
+    }
+    if (arg) reasonParts.push(arg);
+  }
+
+  return {
+    dryRun,
+    reason: reasonParts.join(' ').trim(),
+  };
+}
+
+function preflightOrderCancel(orderInfo, currentDid) {
+  const ctx = normalizeOrderCancelContext(orderInfo);
+  const isExecutor = ctx.executorDid && currentDid ? ctx.executorDid === currentDid : false;
+  const isRequester = ctx.requesterDid && currentDid ? ctx.requesterDid === currentDid : false;
+
+  if (!ctx.orderId) {
+    return { ok: false, code: 'missing_order_id', error: 'Order info is missing an order ID.', ...ctx, currentDid, isRequester, isExecutor, terminal: false };
+  }
+
+  if (!ctx.orderStatus) {
+    return { ok: false, code: 'missing_status', error: `Unable to determine order status for ${ctx.orderId}.`, ...ctx, currentDid, isRequester, isExecutor, terminal: false };
+  }
+
+  if (TERMINAL_ORDER_STATUSES.has(ctx.orderStatus)) {
+    return { ok: false, code: 'terminal_status', error: `Order ${ctx.orderId} is already ${ctx.orderStatus}.`, ...ctx, currentDid, isRequester, isExecutor, terminal: true };
+  }
+
+  if (!currentDid) {
+    return { ok: false, code: 'missing_identity', error: 'Current DID is not initialized.', ...ctx, currentDid: '', isRequester, isExecutor, terminal: false };
+  }
+
+  if (!ctx.requesterDid) {
+    return { ok: false, code: 'missing_requester', error: `Order ${ctx.orderId} is missing requester DID; cannot verify cancel permission.`, ...ctx, currentDid, isRequester: false, isExecutor, terminal: false };
+  }
+
+  if (!isRequester) {
+    return {
+      ok: false,
+      code: 'not_requester',
+      error: `Only the requester can cancel order ${ctx.orderId}. Current DID ${currentDid} does not match requester DID ${ctx.requesterDid}.`,
+      ...ctx,
+      currentDid,
+      isRequester: false,
+      isExecutor,
+      terminal: false,
+    };
+  }
+
+  return { ok: true, ...ctx, currentDid, isRequester: true, isExecutor, terminal: false };
+}
+
+export { TERMINAL_ORDER_STATUSES, normalizeOrderCancelContext, parseOrderCancelArgs, preflightOrderCancel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawrenceliang-btc/atel-sdk",
-  "version": "1.2.12",
+  "version": "1.2.13",
   "description": "ATEL Protocol SDK - Agent Trust & Exchange Layer",
   "repository": {
     "type": "git",
@@ -72,4 +72,4 @@
     "vitest": "^3.2.4"
   },
   "license": "MIT"
-}
+}

package/skill/atel-agent/SKILL.md

@@ -99,7 +99,7 @@ mkdir -p "$WORKSPACE" && cd "$WORKSPACE"
 # 安装 SDK
 if ! command -v atel &> /dev/null; then
   echo "📦 Installing ATEL SDK..."
-  npm install -g @lawrenceliang-btc/atel-sdk || { echo "❌ SDK install failed"; exit 1; }
+  npm install -g @lawrenceliang-btc/atel-sdk@latest || { echo "❌ SDK install failed"; exit 1; }
 fi
 echo "✅ SDK: $(command -v atel)"
 
@@ -226,7 +226,7 @@ echo "========================================="
 处理 paid order 时，必须遵守：
 
 1. 不要默认所有订单都在 Base
-2. 先用 `atel order-info <orderId>` 或 `atel milestone-status <orderId>` 看 `chain`
+2. 先用 `atel order-info <orderId>` 看 `chain`，必要时再用 `GET /trade/v1/order/<orderId>/timeline` 复核历史事件
 3. 后续所有跟链有关的判断都跟 `order.chain`
 4. 如果订单是 `bsc`，就不要再按 `base` 钱包、`base` gas、`base` 浏览器去理解
 
@@ -312,7 +312,7 @@ atel trade-task <capability> "任务描述" --budget 5
 ```bash
 cd ~/atel-workspace
 atel order-info <orderId>
-atel milestone-status <orderId>
+atel order-info <orderId>
 atel milestone-feedback <orderId> --approve
 ```
 

package/skill/atel-agent/setup.sh

@@ -15,7 +15,7 @@ cd "$WORKSPACE"
 # 2. 安装 SDK
 if ! command -v atel &> /dev/null; then
   echo "📦 Installing ATEL SDK..."
-  npm install -g @lawrenceliang-btc/atel-sdk || { echo "❌ SDK install failed"; exit 1; }
+  npm install -g @lawrenceliang-btc/atel-sdk@latest || { echo "❌ SDK install failed"; exit 1; }
 fi
 echo "✅ SDK: $(command -v atel)"
 

package/skill/references/quickstart.md

@@ -6,7 +6,7 @@
 
 **First-time setup:**
 ```bash
-npm install -g @lawrenceliang-btc/atel-sdk
+npm install -g @lawrenceliang-btc/atel-sdk@latest
 atel init my-agent
 atel register "My Agent" "general,research"
 atel start 3100