aws-runtime-bridge 1.4.0 → 1.6.1

package/dist/routes/terminal.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { SDK_PROVIDER_DEFINITIONS } from '../adapter/SdkProviderSpi.js';
-import { resolveSdkProviderId } from './terminal.js';
+import { buildRuntimeEnv, createTerminalOutputDecoder, decodeTerminalOutputChunk, formatTerminalPrompt, formatSdkOutputEvent, normalizeTerminalCommandInput, parseTerminalDirectoryChangeTarget, resolveTerminalOutputEncoding, resolveSdkProviderId, } from './terminal.js';
 describe('terminal route validation', () => {
     it('requires agentId and workspacePath for start', () => {
         const validateStartRequest = (body) => {
@@ -11,12 +11,32 @@ describe('terminal route validation', () => {
         expect(validateStartRequest({}).valid).toBe(false);
         expect(validateStartRequest({ agentId: 'agent-1', workspacePath: '/path' }).valid).toBe(true);
     });
-    it('uses default command when not provided', () => {
+    it('uses SDK default command when not provided', () => {
         const resolveCommand = (command) => command || 'claude';
         expect(resolveCommand(undefined)).toBe('claude');
-        expect(resolveCommand('custom-cli')).toBe('custom-cli');
+        expect(resolveCommand('codex')).toBe('codex');
     });
-    it('requires sessionId and input for input', () => {
+    it('uses SDK launch mode for unsupported mode values', () => {
+        const resolveLaunchMode = (mode) => (mode === 'sdk' ? 'sdk' : 'sdk');
+        expect(resolveLaunchMode(undefined)).toBe('sdk');
+        expect(resolveLaunchMode('sdk')).toBe('sdk');
+        expect(resolveLaunchMode('unsupported')).toBe('sdk');
+    });
+    it('keeps shortcut mode available for manual key injection', () => {
+        const buildInputResponse = (mode) => mode === 'shortcut' ? { ok: true, mode: 'shortcut' } : { ok: true, mode: 'sdk' };
+        expect(buildInputResponse('shortcut')).toEqual({ ok: true, mode: 'shortcut' });
+        expect(buildInputResponse(undefined)).toEqual({ ok: true, mode: 'sdk' });
+    });
+    it('does not downgrade unsupported shortcut input to normal SDK messages', () => {
+        const buildShortcutFallbackResponse = (hasShortcutSupport) => (hasShortcutSupport
+            ? { status: 200, body: { ok: true, mode: 'shortcut' } }
+            : { status: 400, body: { error: 'shortcut input is not supported by this SDK provider' } });
+        expect(buildShortcutFallbackResponse(false)).toEqual({
+            status: 400,
+            body: { error: 'shortcut input is not supported by this SDK provider' },
+        });
+    });
+    it('requires sessionId and input for SDK terminal input', () => {
         const validateInputRequest = (body) => {
             if (!body.sessionId || body.input === undefined || body.input === null) {
                 return { valid: false, error: 'sessionId and input are required' };
@@ -24,16 +44,11 @@ describe('terminal route validation', () => {
             return { valid: true };
         };
         expect(validateInputRequest({}).valid).toBe(false);
-        expect(validateInputRequest({ sessionId: 'session-1', input: 'ls' }).valid).toBe(true);
+        expect(validateInputRequest({ sessionId: 'session-1', input: 'continue' }).valid).toBe(true);
     });
-    it('requires sessionId, cols, and rows for resize', () => {
-        const validateResizeRequest = (body) => {
-            if (!body.sessionId || !body.cols || !body.rows)
-                return { valid: false, error: 'sessionId, cols, rows are required' };
-            return { valid: true };
-        };
-        expect(validateResizeRequest({}).valid).toBe(false);
-        expect(validateResizeRequest({ sessionId: 'session-1', cols: 120, rows: 30 }).valid).toBe(true);
+    it('keeps resize contract as SDK no-op compatibility endpoint', () => {
+        const buildResizeResponse = (cols, rows) => ({ ok: true, mode: 'sdk', noop: true, cols, rows });
+        expect(buildResizeResponse(120, 30)).toEqual({ ok: true, mode: 'sdk', noop: true, cols: 120, rows: 30 });
     });
     it('requires sessionId for stop', () => {
         const validateStopRequest = (body) => {
@@ -46,26 +61,53 @@ describe('terminal route validation', () => {
     });
 });
 describe('terminal configuration', () => {
-    it('selects correct shell for platform', () => {
-        const getShellConfig = (platform) => {
-            if (platform === 'win32')
-                return { shell: 'powershell.exe', args: ['-NoLogo'] };
-            return { shell: 'bash', args: [] };
-        };
-        expect(getShellConfig('win32').shell).toBe('powershell.exe');
-        expect(getShellConfig('linux').shell).toBe('bash');
-    });
-    it('builds correct terminal environment', () => {
-        const buildTerminalEnv = (agentId, baseEnv) => ({
-            ...baseEnv,
-            AWS_AGENT_ID: agentId,
-            AWS_MCP_CLAIM_LAUNCH_BINDING: 'true',
-        });
-        const env = buildTerminalEnv('agent-123', { PATH: '/usr/bin' });
+    it('builds correct SDK runtime environment', () => {
+        const env = buildRuntimeEnv('agent-123', undefined, { PATH: '/usr/bin' });
         expect(env.AWS_AGENT_ID).toBe('agent-123');
         expect(env.AWS_MCP_LAUNCH_BINDING_ID).toBeUndefined();
         expect(env.AWS_MCP_CLAIM_LAUNCH_BINDING).toBe('true');
     });
+    it('merges launch env overrides without allowing agent identity override', () => {
+        const env = buildRuntimeEnv('agent-123', '/workspace', { PATH: '/usr/bin' }, {
+            ANTHROPIC_BASE_URL: ' https://api.example.com ',
+            ANTHROPIC_AUTH_TOKEN: 'secret-token',
+            ANTHROPIC_MODEL: 'claude-sonnet-4-5',
+            AWS_AGENT_ID: 'malicious-agent',
+            EMPTY_VALUE: '   ',
+        });
+        expect(env.ANTHROPIC_BASE_URL).toBe('https://api.example.com');
+        expect(env.ANTHROPIC_AUTH_TOKEN).toBe('secret-token');
+        expect(env.ANTHROPIC_MODEL).toBe('claude-sonnet-4-5');
+        expect(env.EMPTY_VALUE).toBeUndefined();
+        expect(env.AWS_AGENT_ID).toBe('agent-123');
+        expect(env.AWS_WORKSPACE_PATH).toBe('/workspace');
+    });
+});
+describe('terminal command helpers', () => {
+    it('normalizes carriage-return terminal input into executable command text', () => {
+        expect(normalizeTerminalCommandInput('npm test\r')).toBe('npm test');
+        expect(normalizeTerminalCommandInput(' pwd \n')).toBe('pwd');
+    });
+    it('parses cd commands without treating other shell commands as directory changes', () => {
+        expect(parseTerminalDirectoryChangeTarget('cd')).toBeNull();
+        expect(parseTerminalDirectoryChangeTarget('cd /d "D:\\code\\repo"')).toBe('D:\\code\\repo');
+        expect(parseTerminalDirectoryChangeTarget('npm run build')).toBeUndefined();
+    });
+    it('formats the working directory prompt as terminal output text', () => {
+        expect(formatTerminalPrompt('D:\\code\\repo')).toBe('\x1b[36mD:\\code\\repo>\x1b[0m ');
+    });
+    it('defaults Windows terminal command output to GB18030 decoding', () => {
+        expect(resolveTerminalOutputEncoding('win32', {})).toBe('gb18030');
+        expect(resolveTerminalOutputEncoding('linux', {})).toBe('utf-8');
+        expect(resolveTerminalOutputEncoding('win32', { AWS_TERMINAL_OUTPUT_ENCODING: 'utf-8' })).toBe('utf-8');
+    });
+    it('decodes GB18030 Chinese output across chunk boundaries', () => {
+        const decoder = createTerminalOutputDecoder('gb18030');
+        const first = decodeTerminalOutputChunk(decoder, Buffer.from([0xd6]));
+        const second = decodeTerminalOutputChunk(decoder, Buffer.from([0xd0, 0xce, 0xc4]));
+        const flushed = decodeTerminalOutputChunk(decoder, undefined, true);
+        expect(`${first}${second}${flushed}`).toBe('中文');
+    });
 });
 describe('resolveSdkProviderId', () => {
     it('exposes codex through the SDK provider SPI', () => {
@@ -88,3 +130,37 @@ describe('resolveSdkProviderId', () => {
         expect(resolveSdkProviderId(undefined)).toBe('claude-code');
     });
 });
+describe('SDK output forwarding', () => {
+    it('formats text and thinking provider events for the terminal output callback path', () => {
+        const textEvent = {
+            type: 'text_delta',
+            sessionId: 'session-1',
+            timestamp: new Date(0).toISOString(),
+            data: { text: 'hello' },
+        };
+        const thinkingEvent = {
+            type: 'thinking',
+            sessionId: 'session-1',
+            timestamp: new Date(0).toISOString(),
+            data: { text: 'thinking...' },
+        };
+        expect(formatSdkOutputEvent(textEvent)).toBe('hello');
+        expect(formatSdkOutputEvent(thinkingEvent)).toBe('thinking...');
+    });
+    it('formats SDK errors as terminal output and ignores non-output events', () => {
+        const errorEvent = {
+            type: 'error',
+            sessionId: 'session-1',
+            timestamp: new Date(0).toISOString(),
+            data: { text: 'boom' },
+        };
+        const toolEvent = {
+            type: 'tool_use_start',
+            sessionId: 'session-1',
+            timestamp: new Date(0).toISOString(),
+            data: { toolName: 'read_file' },
+        };
+        expect(formatSdkOutputEvent(errorEvent)).toBe('\r\n[SDK Error] boom\r\n');
+        expect(formatSdkOutputEvent(toolEvent)).toBeUndefined();
+    });
+});

package/dist/services/agent-process-manager.d.ts

@@ -14,7 +14,7 @@ export interface ProcessConfig {
     agentId: string;
     sessionId: string;
     pid: number;
-    mode: 'pty' | 'sdk';
+    mode: 'sdk';
     workspacePath: string;
     command: string;
 }
@@ -201,7 +201,7 @@ export declare class AgentProcessManager {
         pid?: number;
         workspacePath?: string;
         command?: string;
-        mode?: 'pty' | 'sdk';
+        mode?: 'sdk';
     }>): Promise<void>;
     /**
      * Get process statistics

package/dist/services/agent-process-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-process-manager.d.ts","sourceRoot":"","sources":["../../src/services/agent-process-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-process-manager.d.ts","sourceRoot":"","sources":["../../src/services/agent-process-manager.ts"],"names":[],"mappings":"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"}

package/dist/services/agent-process-manager.js

@@ -482,7 +482,7 @@ export class AgentProcessManager {
                         agentId,
                         sessionId: session?.sessionId || `reclaimed-${Date.now()}`,
                         pid: orphan.pid,
-                        mode: session?.mode || 'sdk',
+                        mode: 'sdk',
                         state: 'running',
                         workspacePath: session?.workspacePath || orphan.cwd || '',
                         command: orphan.command || session?.command || '',
@@ -521,7 +521,7 @@ export class AgentProcessManager {
                 agentId,
                 sessionId: session?.sessionId || `reclaimed-${Date.now()}`,
                 pid: orphan.pid,
-                mode: session?.mode || 'sdk',
+                mode: 'sdk',
                 state: 'running',
                 workspacePath: session?.workspacePath || orphan.cwd || '',
                 command: orphan.command || session?.command || '',
@@ -696,7 +696,7 @@ export class AgentProcessManager {
                     agentId: session.agentId,
                     sessionId: session.sessionId,
                     pid: session.pid,
-                    mode: session.mode || 'pty',
+                    mode: 'sdk',
                     state,
                     workspacePath: session.workspacePath || '',
                     command: session.command || '',

package/dist/services/process-detector.d.ts

@@ -32,9 +32,7 @@ export declare function findClaudeCodeProcesses(): ProcessInfo[];
  * 检测策略（按优先级）：
  * 1. 通过命令行中的 agentId 直接匹配
  * 2. Windows: 通过 PowerShell 在命令行中模糊搜索 agentId
- * 3. Windows: 通过进程树搜索（解决 PTY 场景下 agentId 仅存在于环境变量的问题）
- *    PTY 启动链: pty.spawn('powershell.exe', {env: {AWS_AGENT_ID}}) → 用户运行 'claude'
- *    此时 claude 是 powershell 子进程，agentId 仅存在于父进程的环境变量中
+ * 3. Windows: 通过进程树搜索，覆盖 agentId 仅存在于祖先进程环境变量中的场景
  *
  * @param agentId Agent ID
  * @returns 进程信息或 undefined
@@ -46,7 +44,7 @@ export declare function findOrphanProcessByAgentId(agentId: string): ProcessInfo
  * 当 agentId 无法匹配到进程时，通过工作目录路径做宽泛搜索。
  * 适用于以下场景：
  * - runtime-bridge 重启后持久化会话丢失
- * - PTY 模式下 agentId 仅在环境变量中，命令行搜索不到
+ * - agentId 可能仅在祖先进程环境变量中，命令行搜索不到
  * - 进程树断链，无法通过祖先链匹配
  *
  * @param workspacePath 工作目录路径

package/dist/services/process-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-detector.d.ts","sourceRoot":"","sources":["../../src/services/process-detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process-detector.d.ts","sourceRoot":"","sources":["../../src/services/process-detector.ts"],"names":[],"mappings":"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"}

package/dist/services/process-detector.js

@@ -241,9 +241,7 @@ function extractAgentId(cmd) {
  * 检测策略（按优先级）：
  * 1. 通过命令行中的 agentId 直接匹配
  * 2. Windows: 通过 PowerShell 在命令行中模糊搜索 agentId
- * 3. Windows: 通过进程树搜索（解决 PTY 场景下 agentId 仅存在于环境变量的问题）
- *    PTY 启动链: pty.spawn('powershell.exe', {env: {AWS_AGENT_ID}}) → 用户运行 'claude'
- *    此时 claude 是 powershell 子进程，agentId 仅存在于父进程的环境变量中
+ * 3. Windows: 通过进程树搜索，覆盖 agentId 仅存在于祖先进程环境变量中的场景
  *
  * @param agentId Agent ID
  * @returns 进程信息或 undefined
@@ -301,18 +299,14 @@ function findProcessByEnvVarWindows(agentId) {
     return undefined;
 }
 /**
- * Windows: 通过祖先环境变量搜索孤儿进程（解决 PTY 模式检测问题）
+ * Windows: 通过祖先环境变量搜索孤儿进程。
  *
  * 场景说明：
- * PTY 模式启动 Agent 时，runtime-bridge 执行:
- *   pty.spawn('powershell.exe', [], { env: { AWS_AGENT_ID: 'agent-xxx' } })
- * 然后用户在 shell 中执行 'claude' 命令，产生如下进程树:
- *   node.exe (runtime-bridge, PID=R)
- *     └── powershell.exe (PID=A, 有 AWS_AGENT_ID 环境变量)
- *           └── claude.exe (PID=B, 无 AWS_AGENT_ID, 命令行含 'claude')
+ * runtime-bridge 或其子进程可能把 AWS_AGENT_ID 传给 shell/agent 祖先进程，
+ * 最终运行的 claude/opencode/codex 进程命令行里不一定包含 agentId。
  *
  * 此时：
- * - findProcessesWindows() 能找到 claude.exe，但 extractAgentId() 提取不到 agentId
+ * - findProcessesWindows() 能找到 agent CLI 进程，但 extractAgentId() 提取不到 agentId
  * - findProcessByEnvVarWindows() 在命令行中搜不到 agentId（环境变量不在命令行中）
  *
  * 策略：用极简 PowerShell 获取全量进程树数据 → 在 Node.js 层做祖先链匹配
@@ -429,8 +423,7 @@ function searchOrphanInProcessTree(rawJson, agentId) {
         const shellInfo = findAncestorShell(proc.processId);
         if (shellInfo) {
             // ★ 验证 agentId：检查 shell 命令行中是否包含目标 agentId
-            // PTY 模式下，shell 的命令行中不直接包含 agentId，但可以尝试匹配
-            // 如果无法验证，仍然返回（保持向后兼容）
+            // shell 的命令行中不一定直接包含 agentId，但可以尝试匹配。
             const shellCmdLower = shellInfo.shellCmd.toLowerCase();
             const cmdLineIncludesAgentId = shellCmdLower.includes(agentId.toLowerCase());
             if (cmdLineIncludesAgentId) {
@@ -501,7 +494,7 @@ function extractJsonFromOutput(output) {
  *
  * Windows 下无法直接读取其他进程的环境变量，但可以通过以下方式间接验证：
  * 1. 检查进程命令行中是否包含 agentId
- * 2. 检查父进程命令行中是否包含 agentId（PTY 模式下环境变量在父进程）
+ * 2. 检查父进程命令行中是否包含 agentId
  * 3. 检查进程的整个祖先链中是否有匹配的 runtime-bridge 启动的 shell
  *
  * @param pid 进程 PID
@@ -520,7 +513,7 @@ function verifyProcessAgentId(pid, targetAgentId) {
         const result = execPowerShell(psScript, 5000).trim();
         if (result === 'MATCH')
             return true;
-        // 策略2：检查父进程命令行是否包含 agentId（PTY 场景）
+        // 策略2：检查父进程命令行是否包含 agentId
         const parentPsScript = `
       try {
         $proc = Get-CimInstance Win32_Process -Filter "ProcessId = ${pid}" -ErrorAction SilentlyContinue
@@ -563,7 +556,7 @@ function verifyProcessAgentId(pid, targetAgentId) {
  * 当 agentId 无法匹配到进程时，通过工作目录路径做宽泛搜索。
  * 适用于以下场景：
  * - runtime-bridge 重启后持久化会话丢失
- * - PTY 模式下 agentId 仅在环境变量中，命令行搜索不到
+ * - agentId 可能仅在祖先进程环境变量中，命令行搜索不到
  * - 进程树断链，无法通过祖先链匹配
  *
  * @param workspacePath 工作目录路径

package/dist/services/process-registry.d.ts

@@ -22,7 +22,7 @@ export interface ProcessRecord {
     agentId: string;
     sessionId: string;
     pid: number;
-    mode: 'pty' | 'sdk';
+    mode: 'sdk';
     state: ProcessState;
     workspacePath: string;
     command: string;
@@ -41,7 +41,7 @@ export interface PersistedSessionInput {
     pid?: number;
     workspacePath?: string;
     command?: string;
-    mode?: 'pty' | 'sdk';
+    mode?: 'sdk';
 }
 /**
  * 获取持久化注册表文件路径

package/dist/services/process-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/services/process-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process-registry.d.ts","sourceRoot":"","sources":["../../src/services/process-registry.ts"],"names":[],"mappings":"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"}

package/dist/services/process-registry.js

@@ -280,7 +280,7 @@ export class ProcessRegistry {
                     agentId: session.agentId,
                     sessionId: session.sessionId,
                     pid: session.pid,
-                    mode: session.mode || 'sdk',
+                    mode: 'sdk',
                     state: 'unknown', // 重建时状态未知，需要外部检测
                     workspacePath: session.workspacePath || '',
                     command: session.command || '',

package/dist/services/session-output.d.ts

@@ -4,6 +4,13 @@
  * 管理终端会话的输出缓冲和刷新机制
  */
 import type { Session } from '../types.js';
+interface RuntimeStatusActionInfo {
+    actionType?: string;
+    actionLabel?: string;
+    actionDetail?: string;
+    actionResult?: string;
+    actionId?: string;
+}
 /** 活跃会话存储 */
 export declare const sessions: Map<string, Session>;
 /**
@@ -14,11 +21,7 @@ export declare const sessions: Map<string, Session>;
  * @param status - 状态
  * @param actionInfo - 可选的动作详情
  */
-export declare function sendStatus(agentId: string, sessionId: string | null, status: string, actionInfo?: {
-    actionType?: string;
-    actionLabel?: string;
-    actionDetail?: string;
-}, usage?: {
+export declare function sendStatus(agentId: string, sessionId: string | null, status: string, actionInfo?: RuntimeStatusActionInfo, usage?: {
     inputTokens: number;
     outputTokens: number;
 }): Promise<void | {
@@ -41,6 +44,24 @@ export declare function sendOutput(agentId: string, output: string, sessionId: s
  * @param questions - 结构化问题列表
  */
 export declare function sendQuestionRequest(agentId: string, sessionId: string, questions: unknown[]): Promise<void>;
+export interface RuntimeFileChangedPayload {
+    bridgeBaseUrl?: string;
+    workspacePath: string;
+    filePath: string;
+    eventType: string;
+    size?: number;
+    mtimeMs?: number;
+}
+/**
+ * 发送工作区文件变更事件到调度器，由调度器通过 WebSocket 通知前端刷新预览。
+ */
+export declare function sendFileChanged(payload: RuntimeFileChangedPayload): Promise<void>;
+/**
+ * 追加会话输出到有界缓冲区。
+ *
+ * 主流程：拼接新输出 -> 超过上限时丢弃最旧终端噪声并保留截断提示 -> 等待 flush pump 批量发送。
+ */
+export declare function appendSessionOutput(sessionId: string, data: string): void;
 /**
  * 调度输出刷新
  *
@@ -53,4 +74,5 @@ export declare function scheduleOutputFlush(sessionId: string): void;
  * @param sessionId - 会话 ID
  */
 export declare function flushSessionOutput(sessionId: string): Promise<void>;
+export {};
 //# sourceMappingURL=session-output.d.ts.map

package/dist/services/session-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-output.d.ts","sourceRoot":"","sources":["../../src/services/session-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,aAAa;AACb,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACjF,KAAK,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}
+{"version":3,"file":"session-output.d.ts","sourceRoot":"","sources":["../../src/services/session-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,UAAU,uBAAuB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD,aAAa;AACb,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,uBAAuB,EACpC,KAAK,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/G;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjH;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}

package/dist/services/session-output.js

@@ -10,6 +10,12 @@ function runtimeAuthHeaders() {
     const token = getRuntimeAccessToken(undefined, schedulerBaseUrl) || getRuntimeAccessToken();
     return token ? { 'X-Runtime-Token': token } : undefined;
 }
+/** 输出刷新防抖时间：合并启动期高频小块输出，降低 HTTP/WebSocket 压力。 */
+const OUTPUT_FLUSH_DEBOUNCE_MS = 100;
+/** 单个会话待发送输出上限，避免调度器不可达时内存无限增长。 */
+const MAX_PENDING_OUTPUT_CHARS = 64 * 1024;
+/** 单次回调最大发送量，避免一次 POST 携带过大的终端噪声。 */
+const MAX_OUTPUT_FLUSH_CHARS = 32 * 1024;
 /** 活跃会话存储 */
 export const sessions = new Map();
 /**
@@ -30,6 +36,10 @@ export async function sendStatus(agentId, sessionId, status, actionInfo, usage)
             payload.actionLabel = actionInfo.actionLabel;
         if (actionInfo.actionDetail)
             payload.actionDetail = actionInfo.actionDetail;
+        if (actionInfo.actionResult)
+            payload.actionResult = actionInfo.actionResult;
+        if (actionInfo.actionId)
+            payload.actionId = actionInfo.actionId;
     }
     // 添加 token 用量信息
     if (usage) {
@@ -81,6 +91,41 @@ export async function sendQuestionRequest(agentId, sessionId, questions) {
         // ignore transient callback failures
     }
 }
+/**
+ * 发送工作区文件变更事件到调度器，由调度器通过 WebSocket 通知前端刷新预览。
+ */
+export async function sendFileChanged(payload) {
+    try {
+        const headers = runtimeAuthHeaders();
+        if (!headers) {
+            return;
+        }
+        await axios.post(`${schedulerBaseUrl}/api/runtime/callback/file-changed`, payload, { headers });
+    }
+    catch {
+        // ignore transient callback failures
+    }
+}
+/**
+ * 追加会话输出到有界缓冲区。
+ *
+ * 主流程：拼接新输出 -> 超过上限时丢弃最旧终端噪声并保留截断提示 -> 等待 flush pump 批量发送。
+ */
+export function appendSessionOutput(sessionId, data) {
+    const session = sessions.get(sessionId);
+    if (!session || !data) {
+        return;
+    }
+    const combinedOutput = `${session.outputBuffer}${data}`;
+    if (combinedOutput.length <= MAX_PENDING_OUTPUT_CHARS) {
+        session.outputBuffer = combinedOutput;
+        return;
+    }
+    const omittedChars = combinedOutput.length - MAX_PENDING_OUTPUT_CHARS;
+    const marker = `\r\n[AgentsWorkStudio: omitted ${omittedChars} chars of old terminal output]\r\n`;
+    const retainedLength = Math.max(0, MAX_PENDING_OUTPUT_CHARS - marker.length);
+    session.outputBuffer = `${marker}${combinedOutput.slice(-retainedLength)}`;
+}
 /**
  * 调度输出刷新
  *
@@ -97,7 +142,7 @@ export function scheduleOutputFlush(sessionId) {
     session.flushTimer = setTimeout(() => {
         session.flushTimer = null;
         flushSessionOutput(sessionId).catch(() => undefined);
-    }, 30);
+    }, OUTPUT_FLUSH_DEBOUNCE_MS);
 }
 /**
  * 刷新会话输出
@@ -115,8 +160,8 @@ export async function flushSessionOutput(sessionId) {
     if (!session.outputBuffer) {
         return;
     }
-    const output = session.outputBuffer;
-    session.outputBuffer = '';
+    const output = session.outputBuffer.slice(0, MAX_OUTPUT_FLUSH_CHARS);
+    session.outputBuffer = session.outputBuffer.slice(MAX_OUTPUT_FLUSH_CHARS);
     const running = (async () => {
         const seq = session.seq + 1;
         session.seq = seq;

package/dist/services/session-output.test.js

@@ -1,11 +1,23 @@
 /**
  * Session Output 服务单元测试
  */
-import { describe, it, expect } from 'vitest';
+import { afterEach, describe, expect, it } from 'vitest';
+import { appendSessionOutput, sessions } from './session-output.js';
+const createSession = (overrides = {}) => ({
+    agentId: 'agent-1',
+    workspacePath: 'D:/workspace',
+    outputBuffer: '',
+    flushTimer: null,
+    flushInFlight: null,
+    seq: 0,
+    ...overrides,
+});
+afterEach(() => {
+    sessions.clear();
+});
 describe('session-output service', () => {
     it('manages sessions map correctly', () => {
-        const sessions = new Map();
-        sessions.set('session-1', { agentId: 'agent-1', outputBuffer: '' });
+        sessions.set('session-1', createSession());
         expect(sessions.size).toBe(1);
         expect(sessions.has('session-1')).toBe(true);
         const session = sessions.get('session-1');
@@ -16,10 +28,8 @@ describe('session-output service', () => {
         expect(sessions.size).toBe(0);
     });
     it('finds session by agentId', () => {
-        const sessions = new Map([
-            ['session-1', { agentId: 'agent-1' }],
-            ['session-2', { agentId: 'agent-2' }],
-        ]);
+        sessions.set('session-1', createSession({ agentId: 'agent-1' }));
+        sessions.set('session-2', createSession({ agentId: 'agent-2' }));
         const findByAgentId = (agentId) => {
             for (const [id, session] of sessions) {
                 if (session.agentId === agentId)
@@ -31,38 +41,42 @@ describe('session-output service', () => {
         expect(findByAgentId('agent-3')).toBe(null);
     });
     it('accumulates output correctly', () => {
-        let outputBuffer = '';
-        const appendOutput = (data) => { outputBuffer += data; };
-        appendOutput('line1\n');
-        appendOutput('line2\n');
-        expect(outputBuffer).toBe('line1\nline2\n');
+        sessions.set('session-1', createSession());
+        appendSessionOutput('session-1', 'line1\n');
+        appendSessionOutput('session-1', 'line2\n');
+        expect(sessions.get('session-1')?.outputBuffer).toBe('line1\nline2\n');
     });
-    it('clears buffer after flush', () => {
-        let outputBuffer = 'pending output';
-        const flushBuffer = () => {
-            const output = outputBuffer;
-            outputBuffer = '';
-            return output;
-        };
-        const flushed = flushBuffer();
-        expect(flushed).toBe('pending output');
-        expect(outputBuffer).toBe('');
+    it('bounds pending SDK output so callback failures cannot grow memory without limit', () => {
+        sessions.set('session-bounded', createSession());
+        appendSessionOutput('session-bounded', 'a'.repeat(70 * 1024));
+        const output = sessions.get('session-bounded')?.outputBuffer ?? '';
+        expect(output.length).toBeLessThanOrEqual(64 * 1024);
+        expect(output).toContain('AgentsWorkStudio: omitted');
+        expect(output.endsWith('a')).toBe(true);
     });
     it('increments sequence correctly', () => {
-        let seq = 0;
-        const nextSeq = () => { seq += 1; return seq; };
-        expect(nextSeq()).toBe(1);
-        expect(nextSeq()).toBe(2);
+        const session = createSession();
+        sessions.set('session-1', session);
+        session.seq += 1;
+        expect(session.seq).toBe(1);
+        session.seq += 1;
+        expect(session.seq).toBe(2);
     });
     it('builds correct status payload', () => {
         const buildStatusPayload = (agentId, sessionId, status) => ({
-            agentId, sessionId, status
+            agentId,
+            sessionId,
+            status,
         });
         expect(buildStatusPayload('agent-1', 'session-1', 'running')).toEqual({
-            agentId: 'agent-1', sessionId: 'session-1', status: 'running'
+            agentId: 'agent-1',
+            sessionId: 'session-1',
+            status: 'running',
         });
         expect(buildStatusPayload('agent-1', null, 'stopped')).toEqual({
-            agentId: 'agent-1', sessionId: null, status: 'stopped'
+            agentId: 'agent-1',
+            sessionId: null,
+            status: 'stopped',
         });
     });
 });