@yu_robotics/remote-cli 1.6.117 → 1.6.121

package/README.md

@@ -91,6 +91,8 @@ Help me fix TypeScript errors in ~/projects/my-app
 
 Manual starts automatically install updates when tasks and queues are idle, without exiting the running client. Updates take effect on the next start. Use `remote-cli service install` for automatic startup and supervised restarts after updates. If the Router rejects the running protocol, restart the manual client after installation to reconnect. See [Automatic Client Startup](../../README.md#automatic-client-startup) for update behavior and recovery.
 
+From CLI 1.6.119, Linux and macOS startup append deterministic backend installation directories to the inherited `PATH`, preserving existing executable and Node precedence. Valid old systemd units and LaunchAgents need only a restarted upgraded client, not reinstallation; broken Node or CLI startup paths still require repair. Later installs into covered directories are visible to a fresh `/backend`, with up to 30 seconds of delegation discovery caching. Custom locations use `executor.<backend>.command`, preferably an absolute real executable; ZCode preserves native unset/empty-command discovery. No shell profiles, runtime-version scans, or new version-manager shim directories are used. See [Backend Executable Discovery](../../README.md#backend-executable-discovery).
+
 ## Commands
 
 | Command | Description |
@@ -139,23 +141,33 @@ Linux users upgrading from version 1.6.23 or earlier should run `remote-cli serv
 
 ### Threads & Machines
 
-Use `/delegation on` in an existing thread to let its selected backend assign
-bounded tasks to other installed, authenticated backends. Claude Code, Codex,
-Pi, AGY, OpenCode, Kimi Code, and ZCode can coordinate or work. From CLI 1.6.95,
+From CLI 1.6.121, new and existing threads without a saved preference enable
+delegation by default. Their selected backend can assign bounded tasks to other
+installed, authenticated backends. Claude Code, Codex, Pi, AGY, OpenCode, Kimi
+Code, ZCode, and DSH can coordinate or work. From CLI 1.6.95,
 same-backend delegation is rejected before launching a worker; discovery marks
 the current backend unavailable as a worker. Use the current backend directly
 or its native subagents, if supported. Workers return results to the original conversation and use
 its working directory; they do not create extra thread buttons. `/delegation`
-shows discovery and restrictions; `/delegation off` disables the feature. The
-setting is off by default and persists per thread. Start with one trial thread;
-never-enabled threads skip managed tools, prompt changes, and delegation
-configuration. Turning it off cleans only backends used for delegation, including
-when resumed after a CLI restart or a backend switch, while preserving their
-conversations.
+shows discovery and restrictions; `/delegation off` explicitly disables the
+feature and `/delegation on` enables it again. Saved opt-outs remain off across
+upgrades, context resets, backend switches, and CLI restarts. No historical
+thread migration or conversation reset is required. Default-on makes tools
+available without automatically starting workers. Explicitly disabled threads
+skip managed tools, prompt changes, and delegation admission checks. Turning it
+off cleans only backends used for delegation, including when resumed after a
+CLI restart or backend switch, while preserving conversations. An implicit
+default alone does not reconfigure unused native sessions during opt-out.
+Upgrade and restart the local CLI to obtain the new default; existing Routers
+remain compatible, and older CLIs retain their own default.
 
 `/status` shows `Delegation: on/off (current thread)` for the thread receiving
 the command. Reading this setting does not initialize delegation or start workers.
 
+From CLI 1.6.118, `/status` shows DSH's official recharge and bonus wallet balances when available. Native official-account sign-in is required; API-key-only or custom-provider setup does not supply these wallets. Amounts retain their native decimal precision and currency; balances are not token usage or plan quota. The query does not create or change an ACP conversation. Its owned process uses the same log-upload and telemetry suppression as the DSH executor, is stopped after the query, and omits the balance section on failure or timeout. No other backend or Router protocol changes are required.
+
+From CLI 1.6.120, Claude SDK `[claude-code:unrecognized_model]` records with a valid `{model, query_source: "sdk"}` payload are omitted from Feishu streaming/results and Claude slash-command error details. Model names are not hard-coded. Other diagnostics, malformed or unexpected records, actual errors, exit status, and assistant reply text are retained. The persistent Claude process's raw stderr remains in local CLI logs; this presentation filter does not disable Claude Code telemetry or change the configured model, other backends, or the Router protocol.
+
 CLI 1.6.94 and newer show each finished worker as a result block in the existing
 reply card, with a colored status label, backend name, short task description,
 and elapsed time. Failed, timed-out, cancelled, and interrupted tasks include a

package/dist/client/MessageHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../../src/client/MessageHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../../src/client/MessageHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAgK,MAAM,UAAU,CAAC;AACzM,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA4GxD;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAA4B;IACvD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsC;IACnE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA+C;IACzF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyC;IACxE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA4C;IACnF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,yBAAyB,CAAS;IAC1C,OAAO,CAAC,2BAA2B,CAAS;IAC5C,OAAO,CAAC,+BAA+B,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAoG;IACzI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,SAAS,CAAC,CAAY;gBAG5B,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,kBAAkB,EAC9B,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,aAAa;IAkBjB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvD;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8EtE,uBAAuB,IAAI,OAAO;IAoBlC,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;YACW,oBAAoB;IAwPlC;;OAEG;YACW,kBAAkB;IAwDhC;;OAEG;YACW,iBAAiB;IAiB/B,OAAO,CAAC,cAAc;IAOtB;;;OAGG;YACW,oBAAoB;IA+blC,OAAO,CAAC,uBAAuB;IAmC/B,OAAO,CAAC,+BAA+B;IAUvC,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,cAAc;YASR,kBAAkB;YA8ElB,sBAAsB;IAkDpC,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;IAK3B;;;;;;;;;OASG;YACW,eAAe;IA+C7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;YACW,mBAAmB;IA0GjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;OAGG;YACW,oBAAoB;IA6MlC;;OAEG;YACW,qBAAqB;IAiBnC;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAG7C;YAEW,eAAe;IAgC7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;;;;;;;;;OAaG;YACW,mBAAmB;IAgEjC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA0E/B;;OAEG;YACW,cAAc;YAuPd,sBAAsB;IAoBpC,OAAO,CAAC,4BAA4B;IAOpC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAuB9B,iFAAiF;IACjF,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,YAAY;YAUN,cAAc;YAuBd,oBAAoB;IAkHlC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc/B"}

package/dist/client/MessageHandler.js

@@ -9,6 +9,7 @@ const DeviceIdentity_1 = require("../files/DeviceIdentity");
 const crypto_1 = require("crypto");
 const DocumentExtractor_1 = require("../files/DocumentExtractor");
 const path_1 = __importDefault(require("path"));
+const DelegationSettings_1 = require("../thread/DelegationSettings");
 const hooks_1 = require("../hooks");
 const FileReadDetector_1 = require("../utils/FileReadDetector");
 const LocalImageDetector_1 = require("../utils/LocalImageDetector");
@@ -26,6 +27,8 @@ const DelegationManager_1 = require("../delegation/DelegationManager");
 const DelegationBridge_1 = require("../delegation/DelegationBridge");
 const contract_1 = require("../delegation/contract");
 const DelegationStatusFormatter_1 = require("../delegation/DelegationStatusFormatter");
+const BackendCommand_1 = require("../utils/BackendCommand");
+const ClaudeStderrFilter_1 = require("../executor/claude/ClaudeStderrFilter");
 const EFFORT_BACKENDS = new Set(['codex', 'agy', 'opencode', 'kimi', 'zcode', 'pi', 'dsh']);
 const NATIVE_MODEL_LIST_BACKENDS = new Set(['codex', 'opencode', 'kimi', 'zcode', 'pi', 'dsh']);
 const SLASH_SESSION_BACKENDS = new Set(['opencode', 'kimi', 'zcode', 'pi']);
@@ -477,7 +480,7 @@ class MessageHandler {
         const activeOperation = this.activeThreadOperations.get(threadId);
         let aborted = false;
         const operation = (async () => {
-            if (this.threadManager.getThread(threadId)?.delegation)
+            if ((0, DelegationSettings_1.isDelegationEnabled)(this.threadManager.getThread(threadId)))
                 await this.delegation.cancelThread(threadId);
             aborted = await executor.abort();
             if (activeOperation)
@@ -605,7 +608,8 @@ class MessageHandler {
                 if (action === 'off') {
                     const thread = this.threadManager.getThread(threadId);
                     const backend = this.threadPool.getBackendKey(threadId);
-                    if (thread.delegationBackends?.includes(backend) || (thread.delegation && !thread.delegationBackends)) {
+                    // An implicit default does not imply that native tools were ever registered.
+                    if (thread.delegationBackends?.includes(backend) || (thread.delegation === true && !thread.delegationBackends)) {
                         await executor.configureDelegation?.(undefined);
                         // Preserve cleanup ownership across process recreation and backend switches.
                         if (!thread.delegationBackends)
@@ -622,7 +626,7 @@ class MessageHandler {
             this.sendResponse(messageId, threadId, {
                 success: true,
                 output: (0, DelegationStatusFormatter_1.formatDelegationStatus)({
-                    enabled: Boolean(this.threadManager.getThread(threadId)?.delegation),
+                    enabled: (0, DelegationSettings_1.isDelegationEnabled)(this.threadManager.getThread(threadId)),
                     coordinatorBackend,
                     coordinatorSupported: Boolean(executor.configureDelegation),
                     backends,
@@ -632,7 +636,7 @@ class MessageHandler {
         }
         if (trimmed.startsWith('/')) {
             const thread = this.threadManager.getThread(threadId);
-            if (!thread?.delegation && thread?.delegationBackends?.includes(this.threadPool.getBackendKey(threadId))) {
+            if (!(0, DelegationSettings_1.isDelegationEnabled)(thread) && thread?.delegationBackends?.includes(this.threadPool.getBackendKey(threadId))) {
                 // Native slash commands can resume a session before the next ordinary turn.
                 await executor.configureDelegation?.(undefined);
             }
@@ -681,7 +685,7 @@ class MessageHandler {
                 output: `📊 Status:
 - Thread: ${thread?.name ?? threadId}
 - Backend: ${backend}
-- Delegation: ${thread?.delegation ? 'on' : 'off'} (current thread)
+- Delegation: ${(0, DelegationSettings_1.isDelegationEnabled)(thread) ? 'on' : 'off'} (current thread)
 - Model: ${model ?? 'backend default'}
 - Reasoning effort: ${effort}
 - Working Directory: ${cwd}
@@ -1230,7 +1234,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             }
         }
         else {
-            const bin = key === 'agy' ? (executorConfig.agy?.command ?? 'agy') : 'claude';
+            const bin = (0, BackendCommand_1.getBackendCommand)(key === 'agy' ? 'agy' : 'claude', executorConfig);
             const args = key === 'agy' ? ['models'] : ['/model', '--print'];
             const listing = await this.runListingCommand(bin, args);
             if (listing) {
@@ -1719,17 +1723,19 @@ You can also use natural language commands to control Claude Code CLI.`,
                 return;
             }
             const executorConfig = this.config.get('executor') ?? { type: 'auto' };
-            const agyCommand = executorConfig.agy?.command ?? 'agy';
-            return this.spawnPassthroughCommand(messageId, threadId, agyCommand, ['-p', command], executor, 'AGY CLI');
+            const agyCommand = (0, BackendCommand_1.getBackendCommand)('agy', executorConfig);
+            return this.spawnPassthroughCommand(messageId, threadId, agyCommand, ['-p', command], executor, 'agy');
         }
-        return this.spawnPassthroughCommand(messageId, threadId, 'claude', [command, '--print'], executor, 'Claude CLI', { CLAUDECODE: '' });
+        const executorConfig = this.config.get('executor') ?? { type: 'auto' };
+        return this.spawnPassthroughCommand(messageId, threadId, (0, BackendCommand_1.getBackendCommand)('claude', executorConfig), [command, '--print'], executor, 'claude', { CLAUDECODE: '' });
     }
     /**
      * Spawn a one-shot CLI process for a passthrough slash command and relay
      * its output back to the user.
      */
-    spawnPassthroughCommand(messageId, threadId, bin, args, executor, label, extraEnv = {}) {
+    spawnPassthroughCommand(messageId, threadId, bin, args, executor, backend, extraEnv = {}) {
         return new Promise((resolve) => {
+            const label = backend === 'agy' ? 'AGY CLI' : 'Claude CLI';
             const chunks = [];
             const errorChunks = [];
             // spawn() reports a missing cwd as an ENOENT naming this binary, so check
@@ -1768,7 +1774,8 @@ You can also use natural language commands to control Claude Code CLI.`,
                     });
                 }
                 else {
-                    const errorOutput = errorChunks.join('') || chunks.join('');
+                    const stderr = errorChunks.join('');
+                    const errorOutput = (backend === 'claude' ? (0, ClaudeStderrFilter_1.filterClaudeStderr)(stderr) : stderr) || chunks.join('');
                     this.sendResponse(messageId, threadId, {
                         success: false,
                         error: errorOutput.trim() || `Command failed with exit code ${code}`,
@@ -1830,7 +1837,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             }
             const openId = this.getMessageOpenId(messageId);
             const thread = this.threadManager.getThread(threadId);
-            if (thread?.delegation && executor.configureDelegation) {
+            if (thread && (0, DelegationSettings_1.isDelegationEnabled)(thread) && executor.configureDelegation) {
                 if (this.delegation.blocksWorkspace(executor.getCurrentWorkingDirectory(), threadId)) {
                     throw new Error('A delegated worker holds this workspace. Wait for it to finish; if worker cleanup failed, stop the worker and restart the CLI.');
                 }
@@ -2332,29 +2339,34 @@ You can also use natural language commands to control Claude Code CLI.`,
     // ── Backend switching ─────────────────────────────────────────────────────
     checkCommand(cmd, args) {
         return new Promise((resolve) => {
-            (0, child_process_1.execFile)(cmd, args, { timeout: 5000 }, (err) => resolve(!err));
+            try {
+                (0, child_process_1.execFile)(cmd, args, { timeout: 5000 }, (err) => resolve({ installed: !err, ...(err ? { reason: (0, BackendCommand_1.backendProbeFailure)(err) } : {}) }));
+            }
+            catch (error) {
+                resolve({ installed: false, reason: (0, BackendCommand_1.backendProbeFailure)(error) });
+            }
         });
     }
     async detectBackends() {
         const executorConfig = this.config.get('executor') ?? { type: 'auto' };
         const [claudeInstalled, codexInstalled, openCodeInstalled, kimiInstalled, piInstalled, agyInstalled, dshInstalled] = await Promise.all([
-            this.checkCommand('claude', ['--version']),
-            this.checkCommand('codex', ['--version']),
-            this.checkCommand('opencode', ['--version']),
-            this.checkCommand('kimi', ['--version']),
-            this.checkCommand(executorConfig.pi?.command ?? 'pi', ['--version']),
-            this.checkCommand('agy', ['--version']),
-            this.checkCommand(executorConfig.dsh?.command ?? 'dsh', ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('claude', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('codex', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('opencode', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('kimi', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('pi', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('agy', executorConfig), ['--version']),
+            this.checkCommand((0, BackendCommand_1.getBackendCommand)('dsh', executorConfig), ['--version']),
         ]);
         return [
-            { id: 'auto', label: 'Claude Code', installed: claudeInstalled },
-            { id: 'codex', label: 'Codex CLI (OpenAI)', installed: codexInstalled },
-            { id: 'opencode', label: 'OpenCode CLI', installed: openCodeInstalled },
-            { id: 'kimi', label: 'Kimi Code CLI', installed: kimiInstalled },
-            { id: 'zcode', label: 'ZCode', installed: (0, ZCodeCommand_1.isZCodeAvailable)(executorConfig.zcode?.command) },
-            { id: 'pi', label: 'Pi', installed: piInstalled },
-            { id: 'agy', label: 'AGY CLI (Antigravity)', installed: agyInstalled },
-            { id: 'dsh', label: 'DeepSeek Harness (DSH)', installed: dshInstalled },
+            { id: 'auto', label: 'Claude Code', ...claudeInstalled },
+            { id: 'codex', label: 'Codex CLI (OpenAI)', ...codexInstalled },
+            { id: 'opencode', label: 'OpenCode CLI', ...openCodeInstalled },
+            { id: 'kimi', label: 'Kimi Code CLI', ...kimiInstalled },
+            { id: 'zcode', label: 'ZCode', installed: (0, ZCodeCommand_1.isZCodeAvailable)((0, BackendCommand_1.getBackendCommand)('zcode', executorConfig)) },
+            { id: 'pi', label: 'Pi', ...piInstalled },
+            { id: 'agy', label: 'AGY CLI (Antigravity)', ...agyInstalled },
+            { id: 'dsh', label: 'DeepSeek Harness (DSH)', ...dshInstalled },
         ];
     }
     async handleBackendCommand(messageId, threadId, trimmed) {
@@ -2369,7 +2381,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             if (installed.length === 0) {
                 this.sendResponse(messageId, threadId, {
                     success: false,
-                    error: 'No supported AI backends found.\n\nMake sure Claude Code is installed: npm install -g @anthropic-ai/claude-code',
+                    error: `No supported AI backends passed their executable checks.\n\n${backends.map(b => `${b.label}: ${b.reason ?? 'Executable could not be located.'}`).join('\n')}\n\nCheck executor.<backend>.command; an absolute executable path is recommended.`,
                 });
                 return;
             }