@xiashe/cli 0.1.2 → 0.1.4

package/README.md

@@ -18,12 +18,14 @@ xiashe skills list
 xiashe skills install copywriting --connection MaxClaw-1 --watch
 xiashe agent issue --name "Local WorkBuddy"
 xiashe agent connect --token "<token>" --name "Local WorkBuddy"
-xiashe agent tasks watch --ack
+xiashe agent run --ack
 xiashe chat send --chat "New Chat" --content "帮我处理这个文件" --file ./report.pdf --agent "Local WorkBuddy"
 ```
 
 Local state is stored in `~/.xiashe/config.json`.
 
+`xiashe agent run --ack` is the recommended lightweight receiver for shell-capable Agents. It sends cheap heartbeats and only lists/executes work when the backend reports pending tasks or transfers. Default cadence is about 30s while idle, 10s while work is active, and up to 2 minutes after long idle periods.
+
 Production defaults:
 
 - Convex: `https://api.xiashe.chat`

package/bin/xiashe.mjs

@@ -64,8 +64,8 @@ Usage:
   ${c} skills claim <one-time-token>
 
   ${c} agent issue [--name <name>] [--kind <kind>] [--json]
-  ${c} agent connect --token <token> [--name <name>] [--kind <kind>]
-  ${c} agent heartbeat
+  ${c} agent connect --token <token> [--name <name>] [--kind <kind>] [--webhook-url <https-url>] [--webhook-token <secret>]
+  ${c} agent heartbeat [--webhook-url <https-url>] [--webhook-token <secret>|--disable-webhook]
   ${c} agent list
   ${c} agent revoke --agent <id-or-name>
   ${c} agent run [--once] [--ack] [--idle-ms <ms>] [--busy-ms <ms>] [--max-idle-ms <ms>]
@@ -645,6 +645,8 @@ async function cmdAgent(sub, args, global) {
       agentName: flags.name || flags['agent-name'] || 'XiaShe CLI Agent',
       agentKind: flags.kind || 'cli',
       agentRef: flags.ref || `${osName()} ${process.cwd()}`,
+      webhookUrl: flags['webhook-url'] || undefined,
+      webhookAuthToken: flags['webhook-token'] || flags['webhook-auth-token'] || undefined,
       transport: flags.transport || 'npx'
     });
     await saveAgentSession(profileName, claim);
@@ -654,6 +656,11 @@ async function cmdAgent(sub, args, global) {
   if (sub === 'heartbeat') {
     const result = await client.agentHeartbeat({
       status: flags.status || 'online',
+      agentName: flags.name || flags['agent-name'] || undefined,
+      agentRef: flags.ref || undefined,
+      webhookUrl: flags['webhook-url'] || undefined,
+      webhookAuthToken: flags['webhook-token'] || flags['webhook-auth-token'] || undefined,
+      webhookMode: flags['disable-webhook'] ? 'disabled' : flags['webhook-url'] ? 'notify' : undefined,
       capabilities: parseCsv(flags.capabilities || 'chat,files,tasks,skills')
     });
     print(result, global);
@@ -713,9 +720,9 @@ async function cmdAgent(sub, args, global) {
 }
 
 async function cmdAgentReceiver(flags, client, global) {
-  const idleMs = numericFlag(flags, 'idle-ms', 60_000);
-  const busyMs = numericFlag(flags, 'busy-ms', 15_000);
-  const maxIdleMs = numericFlag(flags, 'max-idle-ms', 300_000);
+  const idleMs = numericFlag(flags, 'idle-ms', 30_000);
+  const busyMs = numericFlag(flags, 'busy-ms', 10_000);
+  const maxIdleMs = numericFlag(flags, 'max-idle-ms', 120_000);
   const deadline = Date.now() + numericFlag(flags, 'timeout-ms', 24 * 60 * 60_000);
   const capabilities = parseCsv(flags.capabilities || 'chat,files,tasks,skills');
   const seenTasks = new Set();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiashe/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
     "xiashe": "bin/xiashe.mjs"
@@ -10,7 +10,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xiashe/sdk": "0.1.1"
+    "@xiashe/sdk": "0.1.3"
   },
   "engines": {
     "node": ">=20"