@yu_robotics/remote-cli 1.6.165 → 1.6.169

package/README.md

@@ -20,6 +20,8 @@ Router 1.6.117 and newer explicitly label standalone background-task notificatio
 
 ## Public Activity
 
+From Router 1.6.169, reply-card thread lists start collapsed. Use **Show threads** to expand the list in the same card, or **Switch to this thread** to select the thread that produced the reply. Opening or hiding the list does not change the input target; a successful switch hides the list and confirms the new target without changing the reply's source label. No separate thread-management card is sent. The recursive element budget is 180 instead of 150, with room reserved for the expanded controls; table and size thresholds are unchanged. This presentation update requires the newer Router, not a new CLI protocol capability.
+
 From Router 1.6.158, completion pagination keeps the final body item (or complete worker group) with the completion note, optional model metadata and thread controls when they fit together. This avoids preventable footer-only continuations, including replies without model metadata. Indivisible oversized groups still split according to node, size and table limits; thread-button refreshes preserve the final body. This does not change streaming completion timing or the wire protocol.
 
 From CLI 1.6.153, Codex shell calls no longer lose their label when native command actions are absent or unknown. Native reads, searches, and directory listings remain preferred. Other calls use fixed operation labels such as `Run npm command` or `Run Git command` for simple allowlisted programs, and `Run shell command` for compound or unrecognized commands. These are deterministic operation labels, not model-authored purpose summaries: installed Codex 0.160.0 command items have no per-call description field. Arguments, full paths, output, and execution-wide reasoning are never copied into these fallback labels. Late native action metadata can enrich a pending row before its first result; repeated results retain one row. Existing description fields, heading limits, and card-node counts are unchanged; upgrade the CLI, with no new Router capability required.
@@ -76,6 +78,8 @@ The client is normally installed and run directly on the developer's machine rat
 
 ## Installation
 
+Claude tool-result content blocks are normalized to text; embedded media and unknown payloads are not scanned for local files. Local image detection and forwarding are best-effort: failures do not fail the task or terminate the CLI. Web-result excerpts remain excluded from local-file scanning.
+
 Sending local image files requires a Router with image forwarding support and
 the bot application's `im:resource` permission. Router 1.6.85 and newer render
 local and URL-based Markdown image references as captions; the uploaded image
@@ -174,7 +178,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 |
@@ -242,6 +246,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
@@ -414,6 +427,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,
@@ -2089,19 +2140,25 @@ You can also use natural language commands to control Claude Code CLI.`,
             const webToolNames = new Set(['websearch', 'webfetch', 'web_search', 'web_fetch', 'search_web', 'read_url_content', 'fetch']);
             let streamedOutput = '';
             const emitLocalImages = async (text) => {
-                const thread = this.threadManager.getThread(threadId);
-                if (!text || !thread?.workingDirectory)
-                    return;
-                const images = await (0, LocalImageDetector_1.readLocalImages)(text, thread.workingDirectory, (candidate, cwd) => (this.directoryGuard.isSafePath(candidate, cwd)));
-                for (const image of images) {
-                    if (emittedLocalImages.has(image.path))
-                        continue;
-                    emittedLocalImages.add(image.path);
-                    this.sendImage(messageId, threadId, {
-                        type: 'image',
-                        data: image.data,
-                        mimeType: image.mimeType,
-                    });
+                try {
+                    const thread = this.threadManager.getThread(threadId);
+                    if (typeof text !== 'string' || !text || !thread?.workingDirectory)
+                        return;
+                    const images = await (0, LocalImageDetector_1.readLocalImages)(text, thread.workingDirectory, (candidate, cwd) => (this.directoryGuard.isSafePath(candidate, cwd)));
+                    for (const image of images) {
+                        if (emittedLocalImages.has(image.path))
+                            continue;
+                        emittedLocalImages.add(image.path);
+                        this.sendImage(messageId, threadId, {
+                            type: 'image',
+                            data: image.data,
+                            mimeType: image.mimeType,
+                        });
+                    }
+                }
+                catch {
+                    // Image forwarding is optional; never reject a task or log native content on failure.
+                    console.warn('Failed to forward local images; continuing task output.');
                 }
             };
             const queueLocalImages = (text) => {
@@ -2624,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(),
             });
@@ -2638,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)
@@ -2920,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();