aws-runtime-bridge 1.4.0 → 1.6.1

package/dist/services/terminal-persistence.d.ts

@@ -28,6 +28,15 @@ export declare function savePersistedSessions(sessions: PersistedSession[]): Pro
  * @param session - 会话数据
  */
 export declare function upsertPersistedSession(session: PersistedSession): Promise<void>;
+/**
+ * 更新指定 Agent 的持久化自动命令配置。
+ *
+ * 主流程：加载 running 会话 -> 命中 agentId 时只替换自动命令字段，保留原 command/workspace/pid。
+ */
+export declare function updatePersistedSessionAutoCommands(agentId: string, commands: {
+    idleInputAutoCommand: string;
+    nonInputAutoCommand: string;
+}): Promise<boolean>;
 /**
  * 移除持久化会话（从完整文件中删除，包括 stopped 状态的）
  *

package/dist/services/terminal-persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-persistence.d.ts","sourceRoot":"","sources":["../../src/services/terminal-persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6BpD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAGvC;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}
+{"version":3,"file":"terminal-persistence.d.ts","sourceRoot":"","sources":["../../src/services/terminal-persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6BpD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAOzE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAED;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,oBAAoB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAGvC;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF"}

package/dist/services/terminal-persistence.js

@@ -80,6 +80,26 @@ export async function upsertPersistedSession(session) {
         return runningSessions;
     });
 }
+/**
+ * 更新指定 Agent 的持久化自动命令配置。
+ *
+ * 主流程：加载 running 会话 -> 命中 agentId 时只替换自动命令字段，保留原 command/workspace/pid。
+ */
+export async function updatePersistedSessionAutoCommands(agentId, commands) {
+    let updated = false;
+    await updatePersistedSessions((sessions) => sessions.map((session) => {
+        if (session.agentId !== agentId) {
+            return session;
+        }
+        updated = true;
+        return {
+            ...session,
+            idleInputAutoCommand: commands.idleInputAutoCommand,
+            nonInputAutoCommand: commands.nonInputAutoCommand,
+        };
+    }));
+    return updated;
+}
 /**
  * 移除持久化会话（从完整文件中删除，包括 stopped 状态的）
  *

package/dist/services/tool-installer.d.ts

@@ -1,5 +1,11 @@
 import type { ToolInstallStatus } from "../types.js";
 export declare const SUPPORTED_INSTALLABLE_TOOLS: readonly string[];
+export declare const SUPPORTED_UNINSTALLABLE_TOOLS: readonly string[];
+/**
+ * 返回工具对应的全局卸载命令副本，用于诊断与测试卸载覆盖范围。
+ */
+export declare function getToolUninstallCommands(tool: string): string[];
+export declare function isVoltaShimPath(commandPath: string): boolean;
 /**
  * 检查单个工具的 CLI 可执行状态，供实例状态展示与初始化前判断使用。
  */
@@ -12,4 +18,8 @@ export declare function detectToolStatuses(tools: string[]): Promise<Record<stri
  * 根据勾选工具自动安装缺失 CLI，安装后重新检测状态并返回。
  */
 export declare function ensureToolsInstalled(tools: string[]): Promise<Record<string, ToolInstallStatus>>;
+/**
+ * 按工具定义执行全局卸载命令，随后重新检测并返回最新安装状态。
+ */
+export declare function uninstallTools(tools: string[]): Promise<Record<string, ToolInstallStatus>>;
 //# sourceMappingURL=tool-installer.d.ts.map

package/dist/services/tool-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-installer.d.ts","sourceRoot":"","sources":["../../src/services/tool-installer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoErD,eAAO,MAAM,2BAA2B,mBAEvC,CAAC;AAmLF;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAkB5C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CA+C5C"}
+{"version":3,"file":"tool-installer.d.ts","sourceRoot":"","sources":["../../src/services/tool-installer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA8GrD,eAAO,MAAM,2BAA2B,mBAEvC,CAAC;AAEF,eAAO,MAAM,6BAA6B,mBAIzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/D;AAoDD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAM5D;AAqJD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAkB5C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CA+C5C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAiD5C"}

package/dist/services/tool-installer.js

@@ -1,13 +1,14 @@
+import { execFile } from "node:child_process";
+import { access } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { access } from "node:fs/promises";
-import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 const isWindows = process.platform === "win32";
 const TOOL_DEFINITIONS = {
     claude: {
         key: "claude",
+        packageName: "@anthropic-ai/claude-code",
         aliases: isWindows ? ["claude.cmd", "claude.exe", "claude"] : ["claude"],
         versionArgs: ["--version"],
         installCommands: isWindows
@@ -16,9 +17,20 @@ const TOOL_DEFINITIONS = {
                 "curl -fsSL https://claude.ai/install.sh | bash",
                 "npm install -g @anthropic-ai/claude-code@latest",
             ],
+        uninstallCommands: isWindows
+            ? [
+                "npm uninstall -g @anthropic-ai/claude-code",
+                "volta uninstall @anthropic-ai/claude-code",
+            ]
+            : [
+                "npm uninstall -g @anthropic-ai/claude-code",
+                "volta uninstall @anthropic-ai/claude-code",
+                "rm -f ~/.local/bin/claude",
+            ],
     },
     claudecode: {
         key: "claudecode",
+        packageName: "@anthropic-ai/claude-code",
         aliases: isWindows ? ["claude.cmd", "claude.exe", "claude"] : ["claude"],
         versionArgs: ["--version"],
         installCommands: isWindows
@@ -27,9 +39,20 @@ const TOOL_DEFINITIONS = {
                 "curl -fsSL https://claude.ai/install.sh | bash",
                 "npm install -g @anthropic-ai/claude-code@latest",
             ],
+        uninstallCommands: isWindows
+            ? [
+                "npm uninstall -g @anthropic-ai/claude-code",
+                "volta uninstall @anthropic-ai/claude-code",
+            ]
+            : [
+                "npm uninstall -g @anthropic-ai/claude-code",
+                "volta uninstall @anthropic-ai/claude-code",
+                "rm -f ~/.local/bin/claude",
+            ],
     },
     opencode: {
         key: "opencode",
+        packageName: "opencode-ai",
         aliases: isWindows
             ? ["opencode.cmd", "opencode.exe", "opencode"]
             : ["opencode"],
@@ -40,6 +63,18 @@ const TOOL_DEFINITIONS = {
                 "curl -fsSL https://opencode.ai/install | bash",
                 "npm install -g opencode-ai@latest",
             ],
+        uninstallCommands: isWindows
+            ? [
+                "opencode uninstall --force",
+                "npm uninstall -g opencode-ai",
+                "volta uninstall opencode-ai",
+            ]
+            : [
+                "opencode uninstall --force",
+                "npm uninstall -g opencode-ai",
+                "volta uninstall opencode-ai",
+                "rm -f ~/.opencode/bin/opencode",
+            ],
         extraSearchPaths: () => {
             const home = os.homedir();
             return [
@@ -53,12 +88,27 @@ const TOOL_DEFINITIONS = {
     },
     codex: {
         key: "codex",
+        packageName: "@openai/codex",
         aliases: isWindows ? ["codex.cmd", "codex.exe", "codex"] : ["codex"],
         versionArgs: ["--version"],
         installCommands: ["npm install -g @openai/codex@latest"],
+        uninstallCommands: [
+            "npm uninstall -g @openai/codex",
+            "volta uninstall @openai/codex",
+        ],
     },
 };
 export const SUPPORTED_INSTALLABLE_TOOLS = Object.freeze(Object.keys(TOOL_DEFINITIONS));
+export const SUPPORTED_UNINSTALLABLE_TOOLS = Object.freeze(Object.keys(TOOL_DEFINITIONS).filter((tool) => TOOL_DEFINITIONS[tool].uninstallCommands.length > 0));
+/**
+ * 返回工具对应的全局卸载命令副本，用于诊断与测试卸载覆盖范围。
+ */
+export function getToolUninstallCommands(tool) {
+    const normalizedTool = String(tool || "")
+        .trim()
+        .toLowerCase();
+    return [...(TOOL_DEFINITIONS[normalizedTool]?.uninstallCommands || [])];
+}
 function parseVersion(output) {
     const normalized = String(output || "").trim();
     if (!normalized) {
@@ -103,6 +153,26 @@ function describeExecError(error) {
     }
     return message || "command execution failed";
 }
+export function isVoltaShimPath(commandPath) {
+    const normalizedPath = path
+        .normalize(commandPath)
+        .replaceAll("\\", "/")
+        .toLowerCase();
+    return /(?:^|\/)\.?volta\/bin\//.test(normalizedPath);
+}
+async function isVoltaPackageInstalled(packageName) {
+    try {
+        const { stdout, stderr } = await execFileAsync("volta", ["list", "--format", "plain"], {
+            timeout: 20_000,
+        });
+        const output = `${stdout || ""}\n${stderr || ""}`;
+        const escapedPackageName = packageName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        return new RegExp(`^package\\s+${escapedPackageName}(?:@|\\s)`, "im").test(output);
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * 在 Windows 上执行命令（处理 .cmd/.bat 文件）
  * 在 Unix 系统上直接执行
@@ -151,7 +221,7 @@ async function resolveExecutableCandidate(definition) {
         }
         catch (error) {
             executionFailureMessage = describeExecError(error);
-            if (executionFailureMessage !== "command not found in PATH") {
+            if (!isWindows && executionFailureMessage !== "command not found in PATH") {
                 return {
                     executable: alias,
                     version: null,
@@ -164,6 +234,11 @@ async function resolveExecutableCandidate(definition) {
             try {
                 await access(absolutePath);
                 foundCommandPath = absolutePath;
+                if (isVoltaShimPath(absolutePath) &&
+                    !(await isVoltaPackageInstalled(definition.packageName))) {
+                    foundCommandPath = null;
+                    continue;
+                }
                 const { stdout, stderr } = await executeVersionCommand(absolutePath, definition.versionArgs);
                 const version = parseVersion(`${stdout || ""}\n${stderr || ""}`);
                 if (!version) {
@@ -196,7 +271,7 @@ async function resolveExecutableCandidate(definition) {
     }
     return { executable: null, version: null, error: "command not installed" };
 }
-async function runInstallCommand(command) {
+async function runToolCommand(command) {
     if (isWindows) {
         await execFileAsync("cmd.exe", ["/d", "/s", "/c", command], {
             timeout: 10 * 60 * 1000,
@@ -267,7 +342,7 @@ export async function ensureToolsInstalled(tools) {
         let lastError = current.error;
         for (const command of definition.installCommands) {
             try {
-                await runInstallCommand(command);
+                await runToolCommand(command);
                 const detected = await detectToolInstallStatus(tool);
                 nextStatuses[tool] = detected;
                 if (detected.installed) {
@@ -295,3 +370,49 @@ export async function ensureToolsInstalled(tools) {
     }
     return nextStatuses;
 }
+/**
+ * 按工具定义执行全局卸载命令，随后重新检测并返回最新安装状态。
+ */
+export async function uninstallTools(tools) {
+    const normalizedTools = [
+        ...new Set((Array.isArray(tools) ? tools : [])
+            .map((item) => String(item || "")
+            .trim()
+            .toLowerCase())
+            .filter(Boolean)),
+    ];
+    const nextStatuses = {};
+    for (const tool of normalizedTools) {
+        const definition = TOOL_DEFINITIONS[tool];
+        if (!definition) {
+            nextStatuses[tool] = await detectToolInstallStatus(tool);
+            continue;
+        }
+        let lastError = null;
+        for (const command of definition.uninstallCommands) {
+            try {
+                await runToolCommand(command);
+                lastError = null;
+                const detectedAfterCommand = await detectToolInstallStatus(tool);
+                if (!detectedAfterCommand.installed) {
+                    nextStatuses[tool] = detectedAfterCommand;
+                    break;
+                }
+            }
+            catch (error) {
+                lastError =
+                    error instanceof Error
+                        ? error.message
+                        : String(error || "uninstall failed");
+            }
+        }
+        const detected = await detectToolInstallStatus(tool);
+        nextStatuses[tool] = {
+            ...detected,
+            error: detected.installed
+                ? lastError || detected.error || "uninstall completed but command is still available"
+                : detected.error,
+        };
+    }
+    return nextStatuses;
+}

package/dist/services/tool-installer.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { detectToolStatuses, detectToolInstallStatus, SUPPORTED_INSTALLABLE_TOOLS } from './tool-installer.js';
+import { detectToolInstallStatus, SUPPORTED_INSTALLABLE_TOOLS, SUPPORTED_UNINSTALLABLE_TOOLS, detectToolStatuses, getToolUninstallCommands, isVoltaShimPath } from './tool-installer.js';
 describe('tool installer service', () => {
     it('returns structured status for supported tools', async () => {
         const statuses = await detectToolStatuses(['claude', 'opencode', 'codex']);
@@ -76,6 +76,37 @@ describe('tool installer service', () => {
         expect(typeof status.installed).toBe('boolean');
         expect(status.error).not.toBe('unsupported tool');
     });
+    it('supports all panel tools as uninstallable tools', () => {
+        expect(SUPPORTED_UNINSTALLABLE_TOOLS).toEqual(expect.arrayContaining(['claude', 'opencode', 'codex']));
+    });
+    it('covers npm and native installer uninstall paths for OpenCode', () => {
+        const commands = getToolUninstallCommands('opencode');
+        expect(commands).toContain('npm uninstall -g opencode-ai');
+        expect(commands).toContain('volta uninstall opencode-ai');
+        if (process.platform !== 'win32') {
+            expect(commands).toContain('opencode uninstall --force');
+            expect(commands).toContain('rm -f ~/.opencode/bin/opencode');
+        }
+    });
+    it('covers npm and native installer uninstall paths for Claude Code on Unix', () => {
+        const commands = getToolUninstallCommands('claude');
+        expect(commands).toContain('npm uninstall -g @anthropic-ai/claude-code');
+        expect(commands).toContain('volta uninstall @anthropic-ai/claude-code');
+        if (process.platform !== 'win32') {
+            expect(commands).toContain('rm -f ~/.local/bin/claude');
+        }
+    });
+    it('covers Volta package uninstall for Codex', () => {
+        const commands = getToolUninstallCommands('codex');
+        expect(commands).toContain('npm uninstall -g @openai/codex');
+        expect(commands).toContain('volta uninstall @openai/codex');
+    });
+    it('recognizes Volta shim paths for package-manager-aware detection', () => {
+        expect(isVoltaShimPath('C:\\Users\\tester\\AppData\\Local\\Volta\\bin\\codex.cmd')).toBe(true);
+        expect(isVoltaShimPath('/home/tester/.volta/bin/codex')).toBe(true);
+        expect(isVoltaShimPath('/Users/tester/.volta/bin/claude')).toBe(true);
+        expect(isVoltaShimPath('/usr/local/bin/codex')).toBe(false);
+    });
     it('detectToolStatuses returns status for all requested tools', async () => {
         const tools = ['claude', 'opencode', 'unknown-tool'];
         const statuses = await detectToolStatuses(tools);

package/dist/services/workspace-files.d.ts

@@ -6,6 +6,7 @@ export interface WorkspaceFileItem {
     name: string;
     path: string;
     isDirectory: boolean;
+    size?: number;
 }
 export interface ListWorkspaceDirectoryResult {
     currentPath: string;
@@ -17,6 +18,36 @@ export interface ReadWorkspaceFileResult {
     filePath: string;
     content: string;
 }
+export interface WorkspaceDocumentPreviewResult {
+    workspacePath: string;
+    filePath: string;
+    kind: 'html' | 'unsupported';
+    content: string;
+    message?: string;
+    size: number;
+    mtimeMs: number;
+}
+export interface WorkspaceDownloadTarget {
+    workspacePath: string;
+    targetPath: string;
+    resolvedTargetPath: string;
+    fileName: string;
+    contentType: string;
+    isDirectory: boolean;
+}
+export interface WorkspaceUploadFile {
+    originalname: string;
+    relativePath?: string;
+    path: string;
+    size: number;
+}
+export interface WorkspaceArchiveExtractResult {
+    ok: true;
+    workspacePath: string;
+    archivePath: string;
+    targetPath: string;
+    extractedEntries: number;
+}
 interface WorkspacePathParams {
     workspacePath: string;
     targetPath?: string;
@@ -36,9 +67,24 @@ interface RenameWorkspaceEntryParams extends WorkspacePathParams {
     targetPath: string;
     newName: string;
 }
+interface MoveWorkspaceEntryParams extends WorkspacePathParams {
+    targetPath: string;
+    destinationPath: string;
+}
 interface DeleteWorkspaceEntryParams extends WorkspacePathParams {
     targetPath: string;
 }
+interface UploadWorkspaceFilesParams extends WorkspacePathParams {
+    files: WorkspaceUploadFile[];
+    extractArchives?: boolean;
+}
+interface DownloadWorkspaceEntryParams extends WorkspacePathParams {
+    targetPath: string;
+}
+interface ExtractWorkspaceArchiveParams extends WorkspacePathParams {
+    archivePath: string;
+    outputPath?: string;
+}
 /**
  * 列出工作区目录内容。
  */
@@ -47,6 +93,10 @@ export declare function listWorkspaceDirectory(params: WorkspacePathParams): Pro
  * 读取工作区中的文本文件。
  */
 export declare function readWorkspaceFile(params: WorkspaceFileParams): Promise<ReadWorkspaceFileResult>;
+/**
+ * 返回工作区内 Word 文档的预览元数据；docx 由前端下载原文件后渲染，旧版 doc 明确提示不支持。
+ */
+export declare function previewWorkspaceDocument(params: WorkspaceFileParams): Promise<WorkspaceDocumentPreviewResult>;
 /**
  * 将文本内容保存到工作区文件中。
  */
@@ -73,6 +123,16 @@ export declare function renameWorkspaceEntry(params: RenameWorkspaceEntryParams)
     sourcePath: string;
     targetPath: string;
 }>;
+/**
+ * 将工作区内文件或目录移动到另一个工作区目录，保持原文件名不变。
+ */
+export declare function moveWorkspaceEntry(params: MoveWorkspaceEntryParams): Promise<{
+    ok: true;
+    workspacePath: string;
+    sourcePath: string;
+    targetPath: string;
+    destinationPath: string;
+}>;
 /**
  * 删除工作区内的文件或目录，并阻止误删工作区根目录。
  */
@@ -81,5 +141,31 @@ export declare function deleteWorkspaceEntry(params: DeleteWorkspaceEntryParams)
     workspacePath: string;
     targetPath: string;
 }>;
+/**
+ * 上传文件到工作区指定目录，并可在上传后自动解压常见归档。
+ */
+export declare function uploadWorkspaceFiles(params: UploadWorkspaceFilesParams): Promise<{
+    ok: true;
+    workspacePath: string;
+    targetPath: string;
+    files: Array<{
+        fileName: string;
+        targetPath: string;
+        size: number;
+        extracted?: WorkspaceArchiveExtractResult;
+    }>;
+}>;
+/**
+ * 解析工作区下载目标；目录由路由层打包为 zip，文件直接流式下载。
+ */
+export declare function resolveWorkspaceDownloadTarget(params: DownloadWorkspaceEntryParams): Promise<WorkspaceDownloadTarget>;
+/**
+ * 将目录内容以 zip 格式写入输出流，避免在磁盘生成临时包。
+ */
+export declare function streamWorkspaceDirectoryZip(directoryPath: string, output: NodeJS.WritableStream): Promise<void>;
+/**
+ * 解压工作区中的归档文件到指定目录，支持 zip、tar、tar.gz/tgz 与单文件 gz。
+ */
+export declare function extractWorkspaceArchive(params: ExtractWorkspaceArchiveParams): Promise<WorkspaceArchiveExtractResult>;
 export {};
 //# sourceMappingURL=workspace-files.d.ts.map

package/dist/services/workspace-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-files.d.ts","sourceRoot":"","sources":["../../src/services/workspace-files.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,wBAAyB,SAAQ,mBAAmB;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,0BAA2B,SAAQ,mBAAmB;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,0BAA2B,SAAQ,mBAAmB;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,0BAA2B,SAAQ,mBAAmB;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AA+FD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAoB/G;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAerG;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzI;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAiCxF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAkCtF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAelE"}
+{"version":3,"file":"workspace-files.d.ts","sourceRoot":"","sources":["../../src/services/workspace-files.ts"],"names":[],"mappings":"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"}