@yu_robotics/remote-cli 1.6.111 → 1.6.113

package/dist/client/MessageHandler.d.ts

@@ -37,11 +37,13 @@ export declare class MessageHandler {
     private readonly abortOperations;
     private automaticUpdateInProgress;
     private approvalCardsSupported;
+    private streamingContextSupported;
     private delegationProgressSupported;
     private delegationProgressTextSupported;
     private readonly pendingApprovalCards;
     private readonly delegation;
     private readonly delegationBridges;
+    private fileInbox?;
     constructor(wsClient: WebSocketClient, threadPool: ThreadExecutorPool, threadManager: ThreadManager, directoryGuard: DirectoryGuard, config: ConfigManager);
     reconcilePendingDelegatedWorkers(): Promise<void>;
     /**
@@ -165,6 +167,8 @@ export declare class MessageHandler {
     private showApprovalFallback;
     private resolveApprovalCard;
     private handleApprovalResponse;
+    /** Publish routing metadata before backend startup or the first output token. */
+    private sendStreamContext;
     private sendStreamChunk;
     private sendToolUse;
     private sendToolResult;

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

@@ -1,6 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageHandler = void 0;
+const FileInbox_1 = require("../files/FileInbox");
+const DeviceIdentity_1 = require("../files/DeviceIdentity");
+const crypto_1 = require("crypto");
+const DocumentExtractor_1 = require("../files/DocumentExtractor");
+const path_1 = __importDefault(require("path"));
 const hooks_1 = require("../hooks");
 const FileReadDetector_1 = require("../utils/FileReadDetector");
 const LocalImageDetector_1 = require("../utils/LocalImageDetector");
@@ -10,7 +18,7 @@ const child_process_1 = require("child_process");
 const promises_1 = require("fs/promises");
 const fs_1 = require("fs");
 const os_1 = require("os");
-const path_1 = require("path");
+const path_2 = require("path");
 const config_1 = require("../types/config");
 const uuid_1 = require("uuid");
 const ZCodeCommand_1 = require("../executor/zcode/ZCodeCommand");
@@ -94,17 +102,20 @@ class MessageHandler {
     abortOperations = new Map();
     automaticUpdateInProgress = false;
     approvalCardsSupported = false;
+    streamingContextSupported = false;
     delegationProgressSupported = false;
     delegationProgressTextSupported = false;
     pendingApprovalCards = new Map();
     delegation;
     delegationBridges = new Map();
+    fileInbox;
     constructor(wsClient, threadPool, threadManager, directoryGuard, config) {
         this.wsClient = wsClient;
         this.threadPool = threadPool;
         this.threadManager = threadManager;
         this.directoryGuard = directoryGuard;
         this.config = config;
+        this.wsClient.onClose?.(() => this.fileInbox?.disconnect());
         this.delegation = new DelegationManager_1.DelegationManager(directoryGuard);
         this.notificationAdapter = new hooks_1.FeishuNotificationAdapter(wsClient);
         this.notificationAdapter.setThreadNameResolver((threadId) => this.threadManager.getThread(threadId)?.name);
@@ -140,7 +151,20 @@ class MessageHandler {
                 await this.handleStatusQuery(message.messageId);
                 return;
             case 'command':
-                await this.handleCommandMessage(message);
+                await this.handleCommandMessage(message, this.fileInbox?.mark());
+                return;
+            case 'file_pending':
+                if (this.fileInbox)
+                    await this.fileInbox.accept(message);
+                else
+                    this.wsClient.send({ type: 'file_status', fileId: message.fileId, status: 'failed',
+                        detail: 'Local file staging is unavailable. Check secure enrollment, files.retentionDays and storage permissions.' });
+                return;
+            case 'file_available':
+                this.fileInbox?.available(message);
+                return;
+            case 'file_failed':
+                await this.fileInbox?.failed(message.fileId, message.detail);
                 return;
             case 'heartbeat':
                 return;
@@ -148,7 +172,24 @@ class MessageHandler {
                 const data = message.data;
                 if (data?.success !== true)
                     return;
+                if (data.capabilities?.fileTransferV1 === true && !this.fileInbox) {
+                    try {
+                        const fileServer = this.config.get('serverUrl');
+                        const fileNamespace = (0, crypto_1.createHash)('sha256').update((0, DeviceIdentity_1.fileOrigin)(fileServer)).digest('hex');
+                        this.fileInbox = new FileInbox_1.FileInbox(path_1.default.join(this.config.getConfigDir(), 'attachments', fileNamespace), fileServer, {
+                            thread: id => id ? this.threadManager.getThread(id) : this.threadManager.getDefaultThread(),
+                            send: value => this.wsClient.send(value), extract: DocumentExtractor_1.extractDocument,
+                        }, this.config.get('files.retentionDays'));
+                        await this.fileInbox.initialize();
+                    }
+                    catch {
+                        await this.fileInbox?.destroy();
+                        this.fileInbox = undefined;
+                        console.error('[Files] Local staging is unavailable. File requests will fail without running a model.');
+                    }
+                }
                 this.approvalCardsSupported = data.capabilities?.approvalCards === true;
+                this.streamingContextSupported = data.capabilities?.streamingContext === true;
                 this.delegationProgressSupported = data.capabilities?.delegationProgress === true;
                 this.delegationProgressTextSupported = this.delegationProgressSupported
                     && data.capabilities?.delegationProgressText === true;
@@ -196,7 +237,7 @@ class MessageHandler {
     /**
      * Handle command message — route to the correct thread executor.
      */
-    async handleCommandMessage(message) {
+    async handleCommandMessage(message, fileOrder) {
         const { messageId, content, attachments, workingDirectory, openId, isSlashCommand, threadId } = message;
         this.currentOpenId = openId;
         this.messageOpenIds.set(message.messageId, openId);
@@ -221,6 +262,7 @@ class MessageHandler {
             return;
         }
         const executor = this.threadPool.getExecutor(resolvedThreadId);
+        this.sendStreamContext(messageId, resolvedThreadId, executor);
         // Handle /abort for this specific thread (bypasses busy check)
         if (content?.trim() === '/abort') {
             await this.handleAbortCommand(messageId, resolvedThreadId, executor);
@@ -291,12 +333,26 @@ class MessageHandler {
                 return;
             }
         }
+        const ordinaryMessage = !isSlashCommand && !content?.trim().startsWith('/');
+        if (ordinaryMessage) {
+            try {
+                if (message.fileIds?.length && !this.fileInbox)
+                    throw new Error('File support was not negotiated. Upgrade and enroll this CLI first.');
+                if (this.fileInbox) {
+                    await this.fileInbox.initialize();
+                    this.fileInbox.claim(messageId, resolvedThreadId, openId, message.fileIds, fileOrder);
+                }
+            }
+            catch (error) {
+                this.sendResponse(messageId, resolvedThreadId, { success: false, error: error instanceof Error ? error.message : 'Attachment is unavailable.' });
+                return;
+            }
+        }
         const threadBusy = this.threadPool.isThreadBusy(resolvedThreadId);
         const queuedCount = this.threadQueues.get(resolvedThreadId)?.length ?? 0;
         if (!threadBusy && !this.hasThreadQueueState(resolvedThreadId))
             this.pausedQueues.delete(resolvedThreadId);
         const queuePaused = this.pausedQueues.has(resolvedThreadId);
-        const ordinaryMessage = !isSlashCommand && !content?.trim().startsWith('/');
         // An idle executor can still have a paused queue. New work must not overtake it.
         if (threadBusy || (ordinaryMessage && (queuedCount > 0 || queuePaused))) {
             // Allow pending replace even when busy
@@ -405,6 +461,7 @@ class MessageHandler {
      * Handle /abort command for a specific thread executor
      */
     async handleAbortCommand(messageId, threadId, executor) {
+        this.fileInbox?.cancelThread(threadId);
         const existingAbort = this.abortOperations.get(threadId);
         if (existingAbort) {
             await existingAbort;
@@ -490,6 +547,12 @@ class MessageHandler {
      */
     async handleBuiltInCommand(messageId, threadId, content, executor) {
         const trimmed = content.trim();
+        if (trimmed === '/files' || trimmed === '/files clear') {
+            this.sendResponse(messageId, threadId, { success: true, output: this.fileInbox
+                    ? await this.fileInbox.list(threadId, this.getMessageOpenId(messageId), trimmed === '/files clear')
+                    : 'File reception is unavailable. Upgrade both peers, configure Router TLS, run remote-cli files enable locally, approve its binding code, and reconnect.' });
+            return true;
+        }
         if (trimmed === '/delegation' || trimmed.startsWith('/delegation ')) {
             const argumentsList = trimmed.slice('/delegation'.length).trim().split(/\s+/).filter(Boolean);
             const action = argumentsList[0];
@@ -917,23 +980,30 @@ You can also use natural language commands to control Claude Code CLI.`,
         });
         setTimeout(() => {
             const pending = this.pendingQueueConfirmations.get(id);
-            if (pending && pending.info.expiresAt <= Date.now())
+            if (pending && pending.info.expiresAt <= Date.now()) {
+                this.fileInbox?.release(pending.command.messageId);
                 this.pendingQueueConfirmations.delete(id);
+            }
         }, QUEUE_CONFIRMATION_TTL_MS).unref?.();
         return info;
     }
     removeExpiredQueueConfirmations() {
         const now = Date.now();
         for (const [id, pending] of this.pendingQueueConfirmations) {
-            if (pending.info.expiresAt <= now)
+            if (pending.info.expiresAt <= now) {
+                this.fileInbox?.release(pending.command.messageId);
                 this.pendingQueueConfirmations.delete(id);
+            }
         }
     }
     clearThreadQueue(threadId) {
         let cleared = this.threadQueues.get(threadId)?.length ?? 0;
+        for (const command of this.threadQueues.get(threadId) ?? [])
+            this.fileInbox?.release(command.messageId);
         this.threadQueues.delete(threadId);
         for (const [id, pending] of this.pendingQueueConfirmations) {
             if (pending.info.threadId === threadId) {
+                this.fileInbox?.release(pending.command.messageId);
                 this.pendingQueueConfirmations.delete(id);
                 cleared += 1;
             }
@@ -960,6 +1030,8 @@ You can also use natural language commands to control Claude Code CLI.`,
             if (!pending || pending.info.threadId !== threadId || pending.info.expiresAt <= Date.now()
                 || pending.info.backend !== this.threadPool.getBackendKey(threadId) || pending.info.cwd !== currentCwd
                 || (pending.command.openId && pending.command.openId !== this.getMessageOpenId(messageId))) {
+                if (pending)
+                    this.fileInbox?.release(pending.command.messageId);
                 this.pendingQueueConfirmations.delete(id);
                 this.sendResponse(messageId, threadId, { success: false, error: 'Queue confirmation is no longer valid. The message was not queued.' });
                 return;
@@ -967,9 +1039,11 @@ You can also use natural language commands to control Claude Code CLI.`,
             this.pendingQueueConfirmations.delete(id);
             const queue = this.threadQueues.get(threadId) ?? [];
             if (queue.length >= MAX_THREAD_QUEUE_LENGTH) {
+                this.fileInbox?.release(pending.command.messageId);
                 this.sendResponse(messageId, threadId, { success: false, error: `This thread queue is full (${MAX_THREAD_QUEUE_LENGTH} messages).` });
                 return;
             }
+            this.fileInbox?.moveClaim(pending.command.messageId, parts[3] || pending.command.messageId);
             queue.push({ ...pending.command, messageId: parts[3] || pending.command.messageId });
             this.threadQueues.set(threadId, queue);
             console.log(`[MessageHandler] Queued message ${parts[3] || pending.command.messageId} in thread ${threadId}: position=${queue.length}, paused=${this.pausedQueues.has(threadId)}`);
@@ -983,6 +1057,7 @@ You can also use natural language commands to control Claude Code CLI.`,
         if (action === 'cancel' && id) {
             const pending = this.pendingQueueConfirmations.get(id);
             if (pending?.info.threadId === threadId) {
+                this.fileInbox?.release(pending.command.messageId);
                 this.pendingQueueConfirmations.delete(id);
                 this.sendResponse(messageId, threadId, { success: true, output: '❌ Message was not queued.' });
             }
@@ -1276,6 +1351,7 @@ You can also use natural language commands to control Claude Code CLI.`,
                 await this.delegation.store.deleteThread(target.id);
                 await this.threadPool.destroyThread(target.id);
                 await this.threadManager.deleteThread(target.id);
+                await this.fileInbox?.deleteThread(target.id);
                 this.sendResponse(messageId, callerThreadId, {
                     success: true,
                     output: `✅ Thread "${name}" deleted.`,
@@ -1543,8 +1619,8 @@ You can also use natural language commands to control Claude Code CLI.`,
     ]);
     async listLocalSkills(cwd, backend) {
         const roots = backend === 'codex'
-            ? [(0, path_1.join)(cwd, '.agents', 'skills'), (0, path_1.join)((0, os_1.homedir)(), '.codex', 'skills'), (0, path_1.join)((0, os_1.homedir)(), '.codex', 'skills', '.system')]
-            : [(0, path_1.join)(cwd, '.claude', 'skills'), (0, path_1.join)((0, os_1.homedir)(), '.claude', 'skills')];
+            ? [(0, path_2.join)(cwd, '.agents', 'skills'), (0, path_2.join)((0, os_1.homedir)(), '.codex', 'skills'), (0, path_2.join)((0, os_1.homedir)(), '.codex', 'skills', '.system')]
+            : [(0, path_2.join)(cwd, '.claude', 'skills'), (0, path_2.join)((0, os_1.homedir)(), '.claude', 'skills')];
         const skills = [];
         const seen = new Set();
         for (const root of roots) {
@@ -1558,7 +1634,7 @@ You can also use natural language commands to control Claude Code CLI.`,
             for (const entry of entries) {
                 if (!entry.isDirectory() || seen.has(entry.name))
                     continue;
-                const skillPath = (0, path_1.join)(root, entry.name, 'SKILL.md');
+                const skillPath = (0, path_2.join)(root, entry.name, 'SKILL.md');
                 try {
                     const content = await (0, promises_1.readFile)(skillPath, 'utf8');
                     const description = content.match(/^description:\s*(.+)$/mi)?.[1]?.trim();
@@ -1705,6 +1781,7 @@ You can also use natural language commands to control Claude Code CLI.`,
      * Execute AI command on a specific executor
      */
     async executeCommand(messageId, threadId, content, executor, attachments, fromQueue = false) {
+        this.sendStreamContext(messageId, threadId, executor);
         let delegationScope;
         let delegationBridge;
         const complete = async (success, error) => {
@@ -1736,6 +1813,12 @@ You can also use natural language commands to control Claude Code CLI.`,
             return success;
         };
         try {
+            if (this.fileInbox?.hasClaim(messageId)) {
+                this.sendStreamChunk(messageId, threadId, '📎 Waiting for attached files to be ready...\n');
+                content += await this.fileInbox.prepare(messageId);
+                if (this.isDestroyed || this.abortOperations.has(threadId))
+                    throw new Error('Attachment task cancelled.');
+            }
             const openId = this.getMessageOpenId(messageId);
             const thread = this.threadManager.getThread(threadId);
             if (thread?.delegation && executor.configureDelegation) {
@@ -2057,6 +2140,24 @@ You can also use natural language commands to control Claude Code CLI.`,
                 error: 'Approval could not be applied. Check the task output or choose another action.', timestamp: Date.now() });
         }
     }
+    /** Publish routing metadata before backend startup or the first output token. */
+    sendStreamContext(messageId, threadId, executor) {
+        if (!this.streamingContextSupported)
+            return;
+        const thread = this.threadManager.getThread(threadId);
+        const openId = this.getMessageOpenId(messageId);
+        if (!thread || !openId)
+            return;
+        try {
+            this.wsClient.send({
+                type: 'stream_context', messageId, openId, threadId,
+                threadName: thread.name, cwd: executor.getCurrentWorkingDirectory(), timestamp: Date.now(),
+            });
+        }
+        catch (error) {
+            console.error('Failed to send stream context:', error);
+        }
+    }
     sendStreamChunk(messageId, threadId, chunk) {
         try {
             this.wsClient.send({
@@ -2186,6 +2287,8 @@ You can also use natural language commands to control Claude Code CLI.`,
         }
     }
     sendResponse(messageId, threadId, result) {
+        if (!result.queueConfirmation)
+            this.fileInbox?.release(messageId, !result.success);
         try {
             // Resolve CWD from thread executor if possible
             let cwd;
@@ -2348,6 +2451,7 @@ You can also use natural language commands to control Claude Code CLI.`,
      */
     async destroy() {
         this.isDestroyed = true;
+        await this.fileInbox?.destroy();
         this.notificationAdapter.unregister();
         try {
             await this.delegation.destroy();