@yu_robotics/remote-cli 1.6.166 → 1.6.170

package/README.md

@@ -176,7 +176,7 @@ Linux users upgrading from version 1.6.23 or earlier should run `remote-cli serv
 | `/clear` | Clear context for this thread |
 | `/new` | Alias for `/clear`; start a fresh conversation in this thread |
 | `/compact` | Compress history to save tokens |
-| `/cd <dir>` | Change directory; a different directory starts fresh conversations for this thread |
+| `/cd [dir]` | Browse directories as a card, or change directory directly with a path |
 | `/model [name]` | Open native model settings, or set the active backend model with a text argument |
 | `/effort [auto|level]` | Open native effort settings, or set/clear the active backend effort with a text argument |
 | `/sandbox [on/off/read-only/default]` | Configure the current Codex or Claude Code thread sandbox, directory grants, and networking |
@@ -244,6 +244,15 @@ bound retained delegation results, not backend output buffers. Worker timeouts,
 cancellation, and cleanup still apply. This requires a local CLI upgrade and
 works with existing Routers.
 
+With CLI and Router 1.6.167 or newer, terminal Worker card excerpts retain up to
+4 KiB of UTF-8 text. Excerpts containing standalone omission markers are shown
+as escaped plain text with a separate explanation rather than interpreting
+contextless Markdown fragments. Intact result Markdown is preserved. Upgrade
+both peers for the larger preview; newer Routers also safely display older
+CLI omission markers. Older or unknown Routers keep the legacy 1000-byte
+head/tail summary, including after reconnect. The 32 KiB result and 64 KiB
+continuation limits stay unchanged.
+
 Child progress, approvals, and questions use the existing reply flow. `/abort`
 stops managed children as well as the parent. While delegated results remain
 missing from the active execution, the CLI suppresses coordinator prose/plans/images and displays
@@ -416,6 +425,8 @@ Backend-specific commands are forwarded only where the active backend supports t
 
 Use one thread per project or task so each thread keeps its own working directory, backend session, model, and queue. Use `/backend <index>` for a global switch, or `/backend <index> @` to override only the current thread. `/backend default @` removes that override.
 
+With CLI and Router 1.6.168 or newer, `/cd` opens a directory-only browser with child, Parent, Allowed roots, Refresh, Use this directory, and Cancel controls. Navigation never changes context or runs a backend. Only Apply changes the original thread, following the existing all-backend context reset and delegation-lane invalidation; the same directory remains a no-op. Both card Apply and text `/cd <path>` share exclusive settings admission and reject active, delegated, queued, aborting, or updating work. Older peers retain text behavior. Symbolic-link directories are omitted; Parent stops at the nearest allowed root. Snapshots expire after ten minutes and reject changed policy, cwd, root, directory, or ancestor identity. Scans cap at 4096 entries, 128 directories, or five seconds between filesystem operations, with explicit partial-list guidance; at most 32 roots are offered. Cards fill before budget-driven paging. Application-level canonical and identity checks are not an OS sandbox or protection against all external filesystem races and bind mounts.
+
 With CLI 1.6.93 or newer, `/cd` to a different normalized directory clears saved conversation bindings for every backend in that thread, including inactive ones. Returning to the old directory does not restore its previous conversation. Selecting the same directory preserves context; backend switching without a directory change still resumes conversations. Thread identity, model, effort, sandbox grants, delegation settings, and native history files remain intact. Separate plans should use separate threads, even when they share a directory. This change requires a CLI upgrade and works with existing Routers.
 
 Thread switch panels show `Reply from:` with the reply's full thread name and workspace. Under `Switch thread`, a check mark (`✓`) and primary button styling identify the destination of new top-level messages when the card is finalized or clicked. Selected buttons remain clickable. Switching updates only the clicked card; other historical cards retain their last displayed selection.

package/dist/client/MessageHandler.d.ts

@@ -38,10 +38,13 @@ export declare class MessageHandler {
     private approvalCardsSupported;
     private streamingContextSupported;
     private delegationProgressSupported;
+    private routerVersion?;
     private delegationProgressTextSupported;
     private activityProgressSupported;
     private workerContextResetSupported;
     private settingsCardsSupported;
+    private directoryCardsSupported;
+    private readonly directoryBrowser;
     private delegationCardsSupported;
     private readonly settingsAdmission;
     private readonly settingsCatalogReader;
@@ -183,6 +186,8 @@ export declare class MessageHandler {
     private sendStructuredContent;
     private sendResponse;
     private executorConfiguration;
+    /** Shared card/text Apply path. Callers hold exclusive settings admission. */
+    private changeWorkingDirectory;
     private settingsState;
     private settingsBusy;
     private settingsFallback;

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":"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"}

package/dist/client/MessageHandler.js

@@ -37,6 +37,7 @@ const ActivityProgress_1 = require("../utils/ActivityProgress");
 const SettingsAdmission_1 = require("../settings/SettingsAdmission");
 const SettingsCatalog_1 = require("../settings/SettingsCatalog");
 const SettingsService_1 = require("../settings/SettingsService");
+const DirectoryBrowser_1 = require("../settings/DirectoryBrowser");
 const SessionResumeService_1 = require("../session/SessionResumeService");
 const adapters_1 = require("../session/adapters");
 const PiSessionCatalog_1 = require("../session/adapters/PiSessionCatalog");
@@ -170,10 +171,13 @@ class MessageHandler {
     approvalCardsSupported = false;
     streamingContextSupported = false;
     delegationProgressSupported = false;
+    routerVersion;
     delegationProgressTextSupported = false;
     activityProgressSupported = false;
     workerContextResetSupported = false;
     settingsCardsSupported = false;
+    directoryCardsSupported = false;
+    directoryBrowser;
     delegationCardsSupported = false;
     settingsAdmission = new SettingsAdmission_1.SettingsAdmission();
     settingsCatalogReader;
@@ -188,7 +192,10 @@ class MessageHandler {
         this.threadManager = threadManager;
         this.directoryGuard = directoryGuard;
         this.config = config;
-        this.wsClient.onClose?.(() => this.fileInbox?.disconnect());
+        this.wsClient.onClose?.(() => {
+            this.routerVersion = undefined;
+            this.fileInbox?.disconnect();
+        });
         this.delegation = new DelegationManager_1.DelegationManager(directoryGuard);
         this.settingsCatalogReader = new SettingsCatalog_1.SettingsCatalogReader(directoryGuard);
         this.settingsService = new SettingsService_1.SettingsService({
@@ -228,7 +235,26 @@ class MessageHandler {
             delegation: (id, enabled) => this.applyDelegationSetting(id, enabled),
             delegationSupported: id => Boolean(this.threadPool.getExecutor(id).configureDelegation),
         });
-        this.wsClient.onClose?.(() => this.settingsService.invalidate());
+        this.directoryBrowser = new DirectoryBrowser_1.DirectoryBrowser({
+            guard: this.directoryGuard,
+            state: id => {
+                const thread = this.threadManager.getThread(id);
+                const state = this.settingsState(id);
+                return thread && state ? { threadName: thread.name, cwd: thread.workingDirectory,
+                    revision: state.revision, backend: state.coordinatorBackend } : undefined;
+            },
+            busy: (id, except) => this.settingsBusy(id, except),
+            exclusive: async (id, body) => {
+                try {
+                    return await this.settingsAdmission.mutation(id, body);
+                }
+                finally {
+                    void this.startNextQueuedCommand(id);
+                }
+            },
+            apply: (id, target) => this.changeWorkingDirectory(id, target),
+        });
+        this.wsClient.onClose?.(() => { this.settingsService.invalidate(); this.directoryCardsSupported = false; this.directoryBrowser.invalidate(); });
         this.notificationAdapter = new hooks_1.FeishuNotificationAdapter(wsClient);
         this.notificationAdapter.setThreadNameResolver((threadId) => this.threadManager.getThread(threadId)?.name);
         this.notificationAdapter.register();
@@ -267,7 +293,12 @@ class MessageHandler {
                 return;
             case 'settings_action':
                 if (this.settingsCardsSupported) {
-                    const result = await this.settingsService.action(message, this.delegationCardsSupported);
+                    const request = message;
+                    const directory = typeof request.snapshotId === 'string' && request.snapshotId.startsWith('directory-');
+                    if (directory && !this.directoryCardsSupported)
+                        return;
+                    const result = directory ? await this.directoryBrowser.action(request)
+                        : await this.settingsService.action(request, this.delegationCardsSupported);
                     this.wsClient.send(result);
                 }
                 return;
@@ -290,6 +321,7 @@ class MessageHandler {
                 const data = message.data;
                 if (data?.success !== true)
                     return;
+                this.routerVersion = typeof data.routerVersion === 'string' ? data.routerVersion : undefined;
                 if (data.capabilities?.fileTransferV1 === true && !this.fileInbox) {
                     try {
                         const fileServer = this.config.get('serverUrl');
@@ -312,6 +344,7 @@ class MessageHandler {
                 this.delegationProgressSupported = data.capabilities?.delegationProgress === true;
                 this.workerContextResetSupported = this.delegationProgressSupported && data.capabilities?.workerContextReset === true;
                 this.settingsCardsSupported = data.capabilities?.settingsCards === true;
+                this.directoryCardsSupported = this.settingsCardsSupported && data.capabilities?.directoryCards === true;
                 this.delegationCardsSupported = this.settingsCardsSupported && data.capabilities?.delegationCards === true;
                 this.delegationProgressTextSupported = this.delegationProgressSupported
                     && data.capabilities?.delegationProgressText === true;
@@ -350,7 +383,8 @@ class MessageHandler {
             || this.pendingQueueConfirmations.size > 0
             || this.pendingReplaces.size > 0
             || this.activeThreadOperations.size > 0
-            || this.abortOperations.size > 0) {
+            || this.abortOperations.size > 0
+            || this.threadManager.listThreads().some(thread => this.settingsAdmission.isBlocked(thread.id))) {
             return false;
         }
         this.automaticUpdateInProgress = true;
@@ -406,16 +440,18 @@ class MessageHandler {
             // Abort and addressed human replies must remain available during native work.
             if (content === '/abort' || /^(?:yes|no)(?:\s|$)/.test(content) || content.startsWith('/input '))
                 return await body();
-            if (/^\/(?:backend|model|effort)\s+\S/.test(content)) {
+            if (/^\/(?:backend|model|effort|cd)\s+\S/.test(content)) {
                 const global = /^\/backend\s/.test(content) && !/\s@$/.test(content);
                 await this.settingsAdmission.mutation(global ? '*' : threadId, async () => {
                     this.settingsService.invalidate(global ? undefined : threadId);
+                    if (/^\/cd\s/.test(content))
+                        this.directoryBrowser.invalidate(threadId);
                     await body();
                 });
             }
             else {
                 await this.settingsAdmission.command(threadId, message.messageId, async () => {
-                    if (/^\/(?:clear|new|cd|sandbox)(?:\s|$)/.test(content) || /^\/thread\s+delete(?:\s|$)/.test(content))
+                    if (/^\/(?:clear|new|sandbox)(?:\s|$)/.test(content) || /^\/thread\s+delete(?:\s|$)/.test(content))
                         this.settingsService.invalidate(threadId);
                     await body();
                 });
@@ -450,6 +486,31 @@ class MessageHandler {
             return;
         }
         const settingsCommand = content?.trim() ?? '';
+        if (this.directoryCardsSupported && openId && settingsCommand === '/cd') {
+            try {
+                const menu = await this.directoryBrowser.open(resolvedThreadId, openId, messageId);
+                this.sendResponse(messageId, resolvedThreadId, { success: true,
+                    output: 'Directory browser. Navigation does not change the thread; choose Use this directory to apply. Text command: /cd <path>.', settingsMenu: menu }, true);
+            }
+            catch {
+                this.sendResponse(messageId, resolvedThreadId, { success: false,
+                    error: 'The directory browser could not open. Check allowed directories and permissions, or use /cd <path>.' }, true);
+            }
+            return;
+        }
+        // Text Apply also runs before acquiring a model-turn busy flag. Its caller
+        // already holds the same exclusive admission writer as directory-card Apply.
+        if (/^\/cd\s+\S/.test(settingsCommand)) {
+            try {
+                const result = await this.changeWorkingDirectory(resolvedThreadId, settingsCommand.slice(3).trim());
+                this.sendResponse(messageId, resolvedThreadId, result, true);
+            }
+            catch (error) {
+                this.sendResponse(messageId, resolvedThreadId, { success: false,
+                    error: error instanceof Error ? error.message : 'Failed to change directory. Check /status before retrying.' }, true);
+            }
+            return;
+        }
         if (this.settingsCardsSupported && openId && (/^\/(?:backend|model|effort)$/.test(settingsCommand)
             || (this.delegationCardsSupported && settingsCommand === '/delegation'))) {
             const kind = content.trim().slice(1);
@@ -1051,7 +1112,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             await this.handleBackendCommand(messageId, threadId, trimmed);
             return true;
         }
-        if (trimmed.startsWith('/cd')) {
+        if (trimmed === '/cd' || trimmed.startsWith('/cd ')) {
             const parts = trimmed.split(/\s+/);
             if (parts.length < 2) {
                 this.sendResponse(messageId, threadId, { success: false, error: 'Usage: /cd <directory>' });
@@ -1059,18 +1120,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             }
             const targetDir = parts.slice(1).join(' ');
             try {
-                if (this.delegation.hasActiveTasks(threadId)) {
-                    throw new Error('Cannot change working directory while a delegated worker is running. Wait for it to finish or send /abort first.');
-                }
-                const generation = this.threadManager.getThread(threadId)?.delegationWorkspaceGeneration ?? 0;
-                const { cwd: newCwd, changed } = await this.threadPool.setWorkingDirectory(threadId, targetDir);
-                const cleanup = changed
-                    ? await this.delegation.invalidateWorkspaceGeneration(threadId, generation + 1)
-                    : { removed: 0, failed: 0 };
-                this.sendResponse(messageId, threadId, {
-                    success: true,
-                    output: `✅ Changed working directory to: ${newCwd}${changed ? '\nConversation context cleared for all direct and delegated backends in this thread.' : ''}${cleanup.failed ? `\n⚠️ ${cleanup.failed} delegated worker lane(s) could not be cleaned up. Retry with /delegation reset after checking filesystem permissions.` : ''}`,
-                });
+                this.sendResponse(messageId, threadId, await this.changeWorkingDirectory(threadId, targetDir));
             }
             catch (error) {
                 this.sendResponse(messageId, threadId, {
@@ -2044,6 +2094,7 @@ You can also use natural language commands to control Claude Code CLI.`,
                     onToolUse: tool => this.sendToolUse(messageId, threadId, tool),
                     onToolResult: result => this.sendToolResult(messageId, threadId, result),
                     onNotice: text => this.sendStreamChunk(messageId, threadId, text),
+                    routerVersion: () => this.routerVersion,
                     onProgress: this.delegationProgressSupported
                         ? progress => this.sendDelegationProgress(messageId, threadId, progress)
                         : undefined,
@@ -2630,7 +2681,8 @@ You can also use natural language commands to control Claude Code CLI.`,
                 queueConfirmation: result.queueConfirmation,
                 ...(result.executionMetadata ? { executionMetadata: result.executionMetadata } : {}),
                 ...(this.settingsCardsSupported && result.settingsMenu
-                    && (result.settingsMenu.kind !== 'delegation' || this.delegationCardsSupported) ? { settingsMenu: result.settingsMenu } : {}),
+                    && (result.settingsMenu.kind !== 'delegation' || this.delegationCardsSupported)
+                    && (result.settingsMenu.kind !== 'directory' || this.directoryCardsSupported) ? { settingsMenu: result.settingsMenu } : {}),
                 cwd,
                 timestamp: Date.now(),
             });
@@ -2644,6 +2696,22 @@ You can also use natural language commands to control Claude Code CLI.`,
     executorConfiguration() {
         return this.config.get('executor') ?? { type: 'auto' };
     }
+    /** Shared card/text Apply path. Callers hold exclusive settings admission. */
+    async changeWorkingDirectory(threadId, targetDir) {
+        if (this.isDestroyed || this.automaticUpdateInProgress || this.abortOperations.has(threadId)
+            || this.threadPool.isThreadBusy(threadId) || this.hasThreadQueueState(threadId)) {
+            throw new Error('Cannot change working directory while the thread has active or queued work. Retry when it is idle.');
+        }
+        if (this.delegation.hasActiveTasks(threadId)) {
+            throw new Error('Cannot change working directory while a delegated worker is running. Wait for it to finish or send /abort first.');
+        }
+        this.settingsService.invalidate(threadId);
+        const generation = this.threadManager.getThread(threadId)?.delegationWorkspaceGeneration ?? 0;
+        const { cwd, changed } = await this.threadPool.setWorkingDirectory(threadId, targetDir);
+        const cleanup = changed ? await this.delegation.invalidateWorkspaceGeneration(threadId, generation + 1) : { removed: 0, failed: 0 };
+        this.directoryBrowser.invalidate(threadId);
+        return { success: true, output: `✅ Changed working directory to: ${cwd}${changed ? '\nConversation context cleared for all direct and delegated backends in this thread.' : ''}${cleanup.failed ? `\n⚠️ ${cleanup.failed} delegated worker lane(s) could not be cleaned up. Retry with /delegation reset after checking filesystem permissions.` : ''}` };
+    }
     settingsState(threadId) {
         const thread = this.threadManager.getThread(threadId);
         if (!thread)
@@ -2926,6 +2994,7 @@ You can also use natural language commands to control Claude Code CLI.`,
      * Destroy handler and all executors
      */
     async destroy() {
+        this.directoryBrowser.destroy();
         this.settingsService.destroy();
         this.isDestroyed = true;
         await this.fileInbox?.destroy();