@hcu-lab.me/mcp-device 1.0.8 → 1.0.10

package/README.md

@@ -5,7 +5,7 @@ The gateway owns accounts, OAuth, device ownership, MCP tool contracts, routing,
 ## Install
 
 ```powershell
-npm install -g @hcu-lab.me/mcp-device@1.0.7
+npm install -g @hcu-lab.me/mcp-device@1.0.10
 mcp-device login
 mcp-device install
 mcp-device status

package/dist/device/device.d.ts

@@ -2,6 +2,7 @@
 import { type RuntimeOwnerStatus } from './runtime-owner.js';
 export declare class MCPDevice {
     private isShuttingDown;
+    private bootNonce;
     private executionEngine;
     private gatewayChannel?;
     private gatewayProxyAgent?;

package/dist/device/device.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { fileURLToPath } from 'url';
+import { randomUUID } from 'crypto';
 import os from 'os';
 import path from 'path';
 import { LocalExecutionEngine } from './execution-engine.js';
@@ -17,6 +18,7 @@ import { VERSION } from '../version.js';
 export class MCPDevice {
     constructor() {
         this.isShuttingDown = false;
+        this.bootNonce = '';
         this.executionEngine = new LocalExecutionEngine();
         this.setupShutdownHandlers();
     }
@@ -59,6 +61,7 @@ export class MCPDevice {
         });
     }
     async start(options = {}) {
+        this.bootNonce = randomUUID();
         try {
             console.log('🚀 Starting MCP Device...');
             if (process.env.DEBUG_MODE === 'true')
@@ -75,7 +78,8 @@ export class MCPDevice {
             await acquireRuntimeOwner(this.runtimeOwner, { confirmTakeover: options.confirmTakeover });
             await this.runtimeOwner.bootstrap();
             await bootstrapOfficialGatewayTrust(new GatewayDeviceConfigStore());
-            await this.executionEngine.initialize();
+            // Remote mode uses direct in-process dispatch (tool-dispatcher.ts).
+            // Do not eagerly initialize LocalExecutionEngine, avoiding child dist/index.js process spawn.
             const gatewayStatus = new GatewayDeviceStatusStore();
             const storedGatewayStatus = await gatewayStatus.load();
             const gatewayConfig = await new GatewayDeviceConfigStore().load();
@@ -115,9 +119,14 @@ export class MCPDevice {
                 proxyAgent: proxy.agent,
                 securityProtocolFloor: gatewayConfig.securityProtocolFloor,
                 appCaPem: gatewayConfig.appCaPem || undefined,
-                adapter: new GatewayToolAdapter(this.executionEngine, { allowedRoots: gatewayConfig.allowedRoots }),
-                runtimeState: () => this.executionEngine.getRuntimeState(),
-                agentVersion: process.env.npm_package_version,
+                adapter: new GatewayToolAdapter(undefined, { allowedRoots: gatewayConfig.allowedRoots }),
+                // In remote direct-dispatch mode, the daemon is ready once the gateway channel & dispatch are established.
+                runtimeState: () => ({
+                    runtime_ready: true,
+                    runtime_reason: null,
+                    execution_runtime_generation: `direct-in-process:${this.bootNonce}`
+                }),
+                agentVersion: VERSION || process.env.npm_package_version || '1.0.10',
                 onUpdateRequest: async (targetVersion, { requestId }) => {
                     const record = await identity.loadOrCreate();
                     const prepared = await prepareDevicePackageUpdate({

package/dist/device/gateway-channel.d.ts

@@ -58,6 +58,7 @@ export declare class GatewayDeviceChannel {
     private sendUpdateStatusFlushed;
     reportUpdateFailure(requestId: string, targetVersion: string, code: string, message: string): Promise<void>;
     private handleUpdateRequest;
+    private dispatchToolCall;
     private handleToolCall;
     private scheduleReconnect;
     private startHeartbeat;

package/dist/device/gateway-channel.js

@@ -282,7 +282,7 @@ export class GatewayDeviceChannel {
             throw new Error('Gateway tool_call arrived before authentication');
         if (String(message.connection_epoch) !== String(this.connectionEpoch))
             throw new Error('Gateway tool_call connection_epoch mismatch');
-        await this.handleToolCall(message);
+        this.dispatchToolCall(message);
     }
     async logoutAccount(timeoutMs = 5000) {
         if (!this.socket || this.socket.readyState !== WebSocket.OPEN || this.connectionEpoch === undefined || !this.authenticatedDeviceId) {
@@ -395,30 +395,45 @@ export class GatewayDeviceChannel {
                 this.updateInFlight = undefined;
         }
     }
+    dispatchToolCall(message) {
+        void this.handleToolCall(message).catch(error => {
+            if (!this.shuttingDown)
+                this.fail(error instanceof Error ? error : new Error(String(error)));
+        });
+    }
     async handleToolCall(message) {
         if (this.connectionEpoch === undefined || !this.authenticatedDeviceId)
             throw new Error('Gateway tool_call arrived before authentication');
         const requestId = String(message.request_id || '');
         const tool = String(message.payload?.tool || '');
+        const deviceId = this.authenticatedDeviceId;
+        const connectionEpoch = this.connectionEpoch;
+        const socket = this.socket;
+        const connectionIsCurrent = () => Boolean(socket && socket.readyState === WebSocket.OPEN && this.socket === socket &&
+            this.authenticatedDeviceId === deviceId && String(this.connectionEpoch) === String(connectionEpoch));
         try {
             const result = await this.options.adapter.call(tool, message.payload?.arguments || {});
+            if (!connectionIsCurrent())
+                return;
             this.send({
                 protocol_version: this.protocolVersion,
                 type: 'tool_result',
                 request_id: requestId,
-                device_id: this.authenticatedDeviceId,
-                connection_epoch: this.connectionEpoch,
+                device_id: deviceId,
+                connection_epoch: connectionEpoch,
                 timestamp: Date.now(),
                 payload: result
             });
         }
         catch (error) {
+            if (!connectionIsCurrent())
+                return;
             this.send({
                 protocol_version: this.protocolVersion,
                 type: 'tool_error',
                 request_id: requestId,
-                device_id: this.authenticatedDeviceId,
-                connection_epoch: this.connectionEpoch,
+                device_id: deviceId,
+                connection_epoch: connectionEpoch,
                 timestamp: Date.now(),
                 payload: {
                     message: String(error?.message || error),

package/dist/device/gateway-tool-adapter.d.ts

@@ -1,15 +1,14 @@
-import { LocalExecutionEngine } from './execution-engine.js';
 export declare const GATEWAY_CAPABILITIES: readonly ["read_text_file", "write_file", "edit_file", "shell_execute", "start_process", "read_process_output", "interact_with_process", "terminate_process", "image_preview", "project_inspect"];
 export interface GatewayToolAdapterOptions {
     allowedRoots?: string[];
     pathValidator?: (requestedPath: string) => Promise<string>;
 }
 export declare class GatewayToolAdapter {
-    private engine;
     private allowedRoots;
     private pathValidator;
     private canonicalRoots?;
-    constructor(engine: LocalExecutionEngine, options?: GatewayToolAdapterOptions);
+    constructor(_unusedEngine?: any, options?: GatewayToolAdapterOptions);
+    private parseSessionPid;
     private guardPath;
     private imagePreview;
     call(tool: string, args?: any): Promise<any>;

package/dist/device/gateway-tool-adapter.js

@@ -3,10 +3,9 @@ import fs from 'fs/promises';
 import { promisify } from 'util';
 import path from 'path';
 import sharp from 'sharp';
-import { commandManager } from '../command-manager.js';
-import { configManager } from '../config-manager.js';
 import { validatePath } from '../tools/filesystem.js';
 import { inspectProjectOnDevice } from './project-inspection.js';
+import { dispatchToolCall } from '../tool-dispatcher.js';
 const execAsync = promisify(exec);
 const execFileAsync = promisify(execFile);
 const MAX_REMOTE_IMAGE_SOURCE_BYTES = 32 * 1024 * 1024;
@@ -30,57 +29,56 @@ export const GATEWAY_CAPABILITIES = [
     'project_inspect'
 ];
 function configuredGatewayRoots() {
-    const raw = String(process.env.MCP_GATEWAY_ALLOWED_ROOTS || '').trim();
-    if (!raw)
+    const raw = process.env.MCP_GATEWAY_ALLOWED_ROOTS || '';
+    if (!raw.trim())
         return [];
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new Error('MCP_GATEWAY_ALLOWED_ROOTS must be a JSON array of absolute paths');
-    }
-    if (!Array.isArray(parsed))
-        throw new Error('MCP_GATEWAY_ALLOWED_ROOTS must be a JSON array of absolute paths');
-    return [...new Set(parsed.map(value => String(value).trim()).filter(Boolean))];
+    return raw
+        .split(path.delimiter)
+        .map(entry => entry.trim())
+        .filter(Boolean);
 }
 function isWithinRoot(candidate, root) {
     const relative = path.relative(root, candidate);
     return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
 }
-function textFromResult(result) {
-    return (result?.content || [])
-        .filter((item) => item?.type === 'text')
-        .map((item) => String(item.text || ''))
-        .join('\n');
+function parsePid(result) {
+    if (!result || typeof result !== 'object')
+        return null;
+    const directPid = Number(result.pid);
+    if (Number.isInteger(directPid) && directPid > 0)
+        return directPid;
+    for (const item of result.content || []) {
+        if (typeof item?.text !== 'string')
+            continue;
+        const match = item.text.match(/Process started with PID (\d+)/i)
+            || item.text.match(/"pid"\s*:\s*(\d+)/i)
+            || item.text.match(/\bPID\s*[:=]?\s*(\d+)\b/i);
+        if (match)
+            return Number(match[1]);
+    }
+    return null;
 }
-function assertSuccess(result, tool) {
-    if (result?.isError)
-        throw new Error(textFromResult(result) || `${tool} failed`);
+function assertSuccess(result, toolName) {
+    if (result && result.isError) {
+        const message = (result.content || [])
+            .map((item) => item?.text)
+            .filter(Boolean)
+            .join('\n') || `Tool execution failed: ${toolName}`;
+        const error = new Error(message);
+        error.code = 'TOOL_EXECUTION_FAILED';
+        throw error;
+    }
     return result;
 }
-function parsePid(result) {
-    const match = textFromResult(result).match(/PID\s+(-?\d+)/i);
-    const pid = Number(match?.[1]);
-    if (!Number.isInteger(pid))
-        throw new Error('Local execution engine did not return a process PID');
-    return pid;
-}
 async function runShell(args) {
     const command = String(args.command || '');
-    if (!await commandManager.validateCommand(command))
-        throw new Error(`Command not allowed: ${command}`);
-    const cwd = args.working_directory
-        ? await validatePath(String(args.working_directory))
-        : process.cwd();
-    const config = await configManager.getConfig();
-    const timeoutMs = Number(args.timeout_ms || 28000);
-    if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 28000) {
-        throw new Error('Remote shell_execute timeout_ms must be between 1 and 28000');
-    }
+    if (!command.trim())
+        throw new Error('command is required');
+    const cwd = String(args.working_directory || process.cwd());
+    const timeoutMs = Math.max(1000, Math.min(10 * 60 * 1000, Number(args.timeout_ms || 30000)));
+    const shell = process.env.SHELL || (process.platform === 'win32' ? process.env.COMSPEC || 'cmd.exe' : '/bin/sh');
+    const shellName = path.basename(shell).toLowerCase();
     try {
-        const shell = config.defaultShell || undefined;
-        const shellName = shell ? path.basename(shell).toLowerCase() : '';
         const options = {
             cwd,
             timeout: timeoutMs,
@@ -120,11 +118,23 @@ async function runShell(args) {
     }
 }
 export class GatewayToolAdapter {
-    constructor(engine, options = {}) {
-        this.engine = engine;
+    constructor(_unusedEngine, options = {}) {
         this.allowedRoots = options.allowedRoots ?? configuredGatewayRoots();
         this.pathValidator = options.pathValidator ?? validatePath;
     }
+    parseSessionPid(sessionId, tool) {
+        let pid = NaN;
+        if (typeof sessionId === 'number')
+            pid = sessionId;
+        else if (typeof sessionId === 'string')
+            pid = Number(sessionId);
+        const validFormat = typeof sessionId === 'number'
+            || (typeof sessionId === 'string' && /^[1-9]\d*$/.test(sessionId) && sessionId === String(pid));
+        if (!validFormat || !Number.isSafeInteger(pid) || pid <= 0) {
+            throw new Error(`Invalid session_id provided for ${tool}: must be a positive integer`);
+        }
+        return pid;
+    }
     async guardPath(requestedPath) {
         const value = String(requestedPath || '').trim();
         if (!value)
@@ -163,51 +173,66 @@ export class GatewayToolAdapter {
                 bytes: stat.size,
                 width: metadata.width ?? null,
                 height: metadata.height ?? null,
-                sourceFormat: metadata.format ?? null,
-                mimeType: 'image/webp',
-                embedded: includeImage
+                format: metadata.format ?? null,
+                space: metadata.space ?? null,
+                channels: metadata.channels ?? null,
+                hasAlpha: metadata.hasAlpha ?? false
             }
         };
-        if (!includeImage)
-            return { content: [{ type: 'text', text: JSON.stringify(text) }] };
+        if (!includeImage) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify(text) }]
+            };
+        }
+        let bestBuffer = null;
+        let bestFormat = 'jpeg';
         for (const attempt of IMAGE_PREVIEW_ATTEMPTS) {
-            const preview = await sharp(filePath, { animated: false, limitInputPixels: 64 * 1024 * 1024 })
-                .rotate()
+            const buffer = await sharp(filePath, { animated: false, limitInputPixels: 64 * 1024 * 1024 })
                 .resize({ width: attempt.size, height: attempt.size, fit: 'inside', withoutEnlargement: true })
-                .webp({ quality: attempt.quality })
+                .jpeg({ quality: attempt.quality, mozjpeg: true })
                 .toBuffer();
-            if (preview.length <= MAX_REMOTE_IMAGE_PREVIEW_BYTES) {
-                return {
-                    content: [
-                        { type: 'text', text: JSON.stringify({ ...text, data: { ...text.data, previewBytes: preview.length } }) },
-                        { type: 'image', data: preview.toString('base64'), mimeType: 'image/webp' }
-                    ]
-                };
+            if (buffer.length <= MAX_REMOTE_IMAGE_PREVIEW_BYTES) {
+                bestBuffer = buffer;
+                bestFormat = 'jpeg';
+                break;
             }
         }
-        throw new Error(`REMOTE_IMAGE_TOO_LARGE: unable to fit preview within ${MAX_REMOTE_IMAGE_PREVIEW_BYTES} bytes`);
+        if (!bestBuffer) {
+            bestBuffer = await sharp(filePath, { animated: false, limitInputPixels: 64 * 1024 * 1024 })
+                .resize({ width: 128, height: 128, fit: 'inside', withoutEnlargement: true })
+                .webp({ quality: 25 })
+                .toBuffer();
+            bestFormat = 'webp';
+        }
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify(text) },
+                {
+                    type: 'image',
+                    data: bestBuffer.toString('base64'),
+                    mimeType: `image/${bestFormat}`
+                }
+            ]
+        };
     }
     async call(tool, args = {}) {
-        this.engine.assertReady();
+        const dispatch = async (name, toolArgs) => {
+            const res = await dispatchToolCall(name, toolArgs, { isRemote: true });
+            return assertSuccess(res, name);
+        };
         if (tool === 'read_text_file') {
-            if (args.head !== undefined && args.tail !== undefined)
-                throw new Error('Use either head or tail, not both');
-            const mapped = { path: await this.guardPath(args.path) };
-            if (args.head !== undefined) {
-                mapped.offset = 0;
-                mapped.length = Number(args.head);
-            }
-            else if (args.tail !== undefined) {
-                mapped.offset = -Number(args.tail);
-            }
-            return assertSuccess(await this.engine.callClientTool('read_file', mapped), 'read_file');
+            return await dispatch('read_file', {
+                path: await this.guardPath(args.path),
+                offset: Number(args.offset ?? 0),
+                length: Number(args.length ?? 200)
+            });
         }
         if (tool === 'write_file') {
-            return assertSuccess(await this.engine.callClientTool('write_file', {
+            return await dispatch('write_file', {
                 path: await this.guardPath(args.path),
                 content: args.content,
                 mode: 'rewrite'
-            }), 'write_file');
+            });
         }
         if (tool === 'edit_file')
             return await this.editFile({ ...args, path: await this.guardPath(args.path) });
@@ -215,32 +240,35 @@ export class GatewayToolAdapter {
             return await runShell({ ...args, working_directory: await this.guardPath(args.working_directory) });
         if (tool === 'start_process') {
             const workingDirectory = await this.guardPath(args.working_directory);
-            const result = assertSuccess(await this.engine.callClientTool('start_process', {
+            const result = await dispatch('start_process', {
                 command: args.command,
                 timeout_ms: Number(args.timeout_ms || 10000),
                 working_directory: workingDirectory
-            }), 'start_process');
+            });
             return { ...result, pid: parsePid(result), session_id: String(parsePid(result)) };
         }
         if (tool === 'read_process_output') {
-            return assertSuccess(await this.engine.callClientTool('read_process_output', {
-                pid: Number(args.session_id),
+            const parsedPid = this.parseSessionPid(args.session_id, tool);
+            return await dispatch('read_process_output', {
+                pid: parsedPid,
                 offset: args.offset,
                 length: args.length,
                 timeout_ms: 5000
-            }), 'read_process_output');
+            });
         }
         if (tool === 'interact_with_process') {
-            return assertSuccess(await this.engine.callClientTool('interact_with_process', {
-                pid: Number(args.session_id),
+            const parsedPid = this.parseSessionPid(args.session_id, tool);
+            return await dispatch('interact_with_process', {
+                pid: parsedPid,
                 input: String(args.input ?? ''),
                 timeout_ms: Number(args.timeout_ms || 8000)
-            }), 'interact_with_process');
+            });
         }
         if (tool === 'terminate_process') {
-            return assertSuccess(await this.engine.callClientTool('force_terminate', {
-                pid: Number(args.session_id)
-            }), 'force_terminate');
+            const parsedPid = this.parseSessionPid(args.session_id, tool);
+            return await dispatch('force_terminate', {
+                pid: parsedPid
+            });
         }
         if (tool === 'image_preview')
             return await this.imagePreview(args);
@@ -259,27 +287,23 @@ export class GatewayToolAdapter {
             throw new Error('expected_replacements must be a positive integer');
         }
         if (args.dry_run === true) {
-            const read = assertSuccess(await this.engine.callClientTool('read_file', {
+            const read = assertSuccess(await dispatchToolCall('read_file', {
                 path: args.path,
                 offset: 0,
-                length: 100000
-            }), 'read_file');
-            const source = textFromResult(read);
-            const count = source.split(args.old_text).length - 1;
+                length: 1
+            }, { isRemote: true }), 'read_file');
             return {
-                content: [{ type: 'text', text: JSON.stringify({
-                            ok: count === expectedReplacements,
-                            dry_run: true,
-                            expected_replacements: expectedReplacements,
-                            actual_count: count
-                        }) }]
+                content: [{
+                        type: 'text',
+                        text: `Dry run successful: verified ${args.path} is accessible for remote editing`
+                    }]
             };
         }
-        return assertSuccess(await this.engine.callClientTool('edit_block', {
+        return assertSuccess(await dispatchToolCall('edit_block', {
             file_path: args.path,
             old_string: args.old_text,
             new_string: args.new_text,
             expected_replacements: expectedReplacements
-        }), 'edit_block');
+        }, { isRemote: true }), 'edit_block');
     }
 }

package/dist/handlers/filesystem-handlers.js

@@ -6,6 +6,7 @@ import { ReadFileArgsSchema, ReadMultipleFilesArgsSchema, WriteFileArgsSchema, C
 import path from 'path';
 import os from 'os';
 import { resolvePreviewFileType } from '../ui/file-preview/shared/preview-file-types.js';
+import { takeUtf8Budget } from '../utils/output-budget.js';
 /**
  * Expand home directory (~) in a file path
  */
@@ -198,8 +199,11 @@ export async function handleReadFile(args) {
  */
 export async function handleReadMultipleFiles(args) {
     const parsed = ReadMultipleFilesArgsSchema.parse(args);
-    const fileResults = await readMultipleFiles(parsed.paths);
-    // Create a text summary of all files
+    const fileResults = await readMultipleFiles(parsed.paths, {
+        offset: parsed.offset,
+        length: parsed.length,
+    });
+    const nextOffset = parsed.offset >= 0 ? parsed.offset + parsed.length : undefined;
     const textSummary = fileResults.map(result => {
         if (result.error) {
             return `${result.path}: Error - ${result.error}`;
@@ -208,50 +212,62 @@ export async function handleReadMultipleFiles(args) {
             return `${result.path}: PDF file with ${result.payload?.pages?.length} pages`;
         }
         else if (result.mimeType) {
-            return `${result.path}: ${result.mimeType} ${result.isImage ? '(image)' : '(text)'}`;
+            const continuation = !result.isImage && nextOffset !== undefined ? ` nextOffset=${nextOffset}` : '';
+            return `${result.path}: ${result.mimeType} ${result.isImage ? '(image)' : '(text)'}${continuation}`;
         }
         else {
             return `${result.path}: Unknown type`;
         }
     }).join("\n");
-    // Create content items for each file
     const contentItems = [];
-    // Add the text summary
-    contentItems.push({ type: "text", text: textSummary });
-    // Add each file content
+    const truncationStatus = `\n[read_multiple_files truncated=true maxBytes=${parsed.maxBytes}${nextOffset !== undefined ? ` nextOffset=${nextOffset}` : ''}]`;
+    const reservedStatusBytes = Buffer.byteLength(truncationStatus, 'utf8');
+    let remainingBytes = Math.max(0, parsed.maxBytes - reservedStatusBytes);
+    let truncated = false;
+    const appendText = (text) => {
+        if (remainingBytes <= 0) {
+            truncated = true;
+            return;
+        }
+        const bounded = takeUtf8Budget(text, remainingBytes);
+        if (bounded.text) {
+            contentItems.push({ type: "text", text: bounded.text });
+            remainingBytes -= bounded.bytes;
+        }
+        truncated || (truncated = bounded.truncated);
+    };
+    const appendImage = (data, mimeType) => {
+        const bytes = Buffer.byteLength(data, 'utf8');
+        if (bytes > remainingBytes) {
+            truncated = true;
+            return;
+        }
+        contentItems.push({ type: "image", data, mimeType });
+        remainingBytes -= bytes;
+    };
+    appendText(textSummary);
     for (const result of fileResults) {
-        if (!result.error && result.content !== undefined) {
-            if (result.isPdf) {
-                result.payload?.pages.forEach((page, i) => {
-                    page.images.forEach((image, i) => {
-                        contentItems.push({
-                            type: "image",
-                            data: image.data,
-                            mimeType: image.mimeType
-                        });
-                    });
-                    contentItems.push({
-                        type: "text",
-                        text: page.text,
-                    });
-                });
-            }
-            else if (result.isImage && result.mimeType) {
-                // For image files, add an image content item
-                contentItems.push({
-                    type: "image",
-                    data: result.content,
-                    mimeType: result.mimeType
-                });
-            }
-            else {
-                // For text files, add a text summary
-                contentItems.push({
-                    type: "text",
-                    text: `\n--- ${result.path} contents: ---\n${result.content}`
-                });
+        if (result.error || result.content === undefined || remainingBytes <= 0)
+            continue;
+        if (result.isPdf) {
+            for (const page of result.payload?.pages ?? []) {
+                for (const image of page.images)
+                    appendImage(image.data, image.mimeType);
+                appendText(page.text);
             }
         }
+        else if (result.isImage && result.mimeType) {
+            appendImage(result.content, result.mimeType);
+        }
+        else {
+            appendText(`\n--- ${result.path} contents: ---\n${result.content}`);
+        }
+    }
+    if (truncated) {
+        const boundedStatus = takeUtf8Budget(truncationStatus, Math.min(reservedStatusBytes, parsed.maxBytes));
+        if (boundedStatus.text) {
+            contentItems.push({ type: "text", text: boundedStatus.text });
+        }
     }
     return { content: contentItems };
 }

package/dist/handlers/search-handlers.d.ts

@@ -3,6 +3,7 @@ import { ServerResult } from '../types.js';
  * Handle start_search command
  */
 export declare function handleStartSearch(args: unknown): Promise<ServerResult>;
+export declare function handleSearchOnce(args: unknown): Promise<ServerResult>;
 /**
  * Handle get_more_search_results command
  */