@xiashe/cli 0.1.2 → 0.1.5

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

@@ -39,6 +39,7 @@ const EXIT_NETWORK = 4;
 const EXIT_RUNTIME = 5;
 const COMMAND_NAME = process.env.XIASHE_CLI_NAME || 'xiashe';
 const PRODUCT_NAME = process.env.XIASHE_PRODUCT_NAME || (COMMAND_NAME === 'agentpie' ? 'AgentPie' : 'XiaShe');
+const PRODUCT_ENV = COMMAND_NAME === 'agentpie' ? 'global' : 'cn';
 
 function usage() {
   const c = COMMAND_NAME;
@@ -50,7 +51,7 @@ Usage:
   ${c} whoami
 
   ${c} config path|get|set <key> <value>|use <profile>
-  ${c} env use cn|global
+  ${c} env use ${PRODUCT_ENV}
 
   ${c} connections list
   ${c} claw pair --connection <id-or-name>
@@ -64,8 +65,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>]
@@ -87,8 +88,6 @@ Global flags:
   --profile <name>       Local config profile. Default: active profile.
   --convex-url <url>     Convex deployment URL.
   --actions-url <url>    ${PRODUCT_NAME} action site URL.
-  --market <cn|intl>     Skill market.
-  --locale <zh-CN|en>    Catalog locale.
   --json                 Print JSON output.
   --timeout-ms <ms>      HTTP timeout. Default: 20000.
   --help                 Show help.
@@ -329,11 +328,15 @@ async function cmdConfig(sub, args, global) {
 async function cmdEnv(sub, args, global) {
   const flags = parseFlags(args);
   if (sub !== 'use') {
-    fail('Usage: xiashe env use cn|global', EXIT_USAGE);
+    fail(`Usage: ${COMMAND_NAME} env use ${PRODUCT_ENV}`, EXIT_USAGE);
   }
   const envName = requireArg(flags._[0], 'environment');
+  const normalized = String(envName || '').toLowerCase();
+  if (normalized !== PRODUCT_ENV && !(PRODUCT_ENV === 'global' && normalized === 'intl')) {
+    fail(`${PRODUCT_NAME} only supports the ${PRODUCT_ENV} environment.`, EXIT_USAGE);
+  }
   const loaded = await loadProfile({ profile: global.profile || undefined });
-  const defaults = await useEnvironment(envName, loaded.profileName);
+  const defaults = await useEnvironment(PRODUCT_ENV, loaded.profileName);
   print({ ok: true, profile: loaded.profileName, ...defaults }, global);
 }
 
@@ -645,6 +648,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 +659,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 +723,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.5",
   "type": "module",
   "bin": {
     "xiashe": "bin/xiashe.mjs"
@@ -10,7 +10,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xiashe/sdk": "0.1.1"
+    "@xiashe/sdk": "0.1.6"
   },
   "engines": {
     "node": ">=20"