@gt-fe/eap-runtime 0.0.10 → 0.0.11

package/dist/tool/local-tool-executor.js

@@ -7,7 +7,8 @@
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
-import { resolveReadyInstallByToolName, resolveMcpExecutionFromInstall, resolveCodeHandlerFromInstall, } from '@gt-fe/eap-contracts';
+import { ErrorCodes, resolveReadyInstallByToolName, resolveMcpExecutionFromInstall, resolveCodeHandlerFromInstall, } from '@eap/contracts';
+import { isAbortError, toToolTimeoutMs, toolTimeoutErrorMessage } from './timeout.js';
 import { fileArtifactFromToolOutput, fileBasesFromEnv } from './file-artifact.js';
 import { LocalMcpClient } from './local-mcp-client.js';
 /**
@@ -66,7 +67,9 @@ function runHandler(handlerPath, input, timeoutMs, execution) {
         };
         const timer = setTimeout(() => {
             child.kill('SIGKILL');
-            finish(() => reject(new Error(`Local tool timeout after ${timeoutMs}ms`)));
+            const timeoutErr = new Error(toolTimeoutErrorMessage(Math.max(1, Math.round(timeoutMs / 1000))));
+            timeoutErr.name = 'TimeoutError';
+            finish(() => reject(timeoutErr));
         }, timeoutMs);
         child.stdout.on('data', (d) => { stdout += d.toString(); });
         child.stderr.on('data', (d) => { stderr += d.toString(); });
@@ -112,7 +115,7 @@ export function resolveCodeExecutionFromRequest(request) {
     const handler = typeof e.handler === 'string' ? e.handler : '';
     const command = typeof e.command === 'string' ? e.command : undefined;
     const args = Array.isArray(e.args) ? e.args.map(String) : undefined;
-    const timeoutMs = typeof e.timeout === 'number' && e.timeout > 0 ? e.timeout : undefined;
+    const timeoutMs = typeof e.timeout === 'number' && e.timeout > 0 ? toToolTimeoutMs(e.timeout) : undefined;
     if (runtime === 'executable') {
         const handlerPath = handler
             ? (path.isAbsolute(handler) || !bundlePath
@@ -181,14 +184,14 @@ export class LocalToolExecutor {
             };
         }
         catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            const aborted = isAbortError(error);
             return {
                 toolCallId: request.toolCallId,
                 toolName: request.toolName,
                 content: '',
                 success: false,
-                error: message,
-                errorCode: 'EXECUTION_FAILED',
+                error: error instanceof Error ? error.message : String(error),
+                errorCode: aborted ? ErrorCodes.TOOL_TIMEOUT : 'EXECUTION_FAILED',
                 runtime: 'local',
             };
         }
@@ -203,6 +206,7 @@ export class LocalToolExecutor {
             handlerPath,
             runtime: execution?.runtime,
             args: execution?.args,
+            timeoutMs: typeof execution?.timeout === 'number' ? toToolTimeoutMs(execution.timeout) : undefined,
         });
     }
     async executeMcp(request, install) {
@@ -232,14 +236,14 @@ export class LocalToolExecutor {
             };
         }
         catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            const aborted = isAbortError(error);
             return {
                 toolCallId: request.toolCallId,
                 toolName: request.toolName,
                 content: '',
                 success: false,
-                error: message,
-                errorCode: 'EXECUTION_FAILED',
+                error: error instanceof Error ? error.message : String(error),
+                errorCode: aborted ? ErrorCodes.TOOL_TIMEOUT : 'EXECUTION_FAILED',
                 runtime: 'local',
             };
         }

package/dist/tool/mcp-tool-executor.js

@@ -3,6 +3,8 @@
  *
  * @see docs/contracts/tool-execution.md §2.0
  */
+import { ErrorCodes } from '@eap/contracts';
+import { abortOrTimeoutMessage, isAbortError } from './timeout.js';
 function resolveAgentCode(request) {
     return request.authContext.agentCode;
 }
@@ -14,9 +16,14 @@ function formatContent(result) {
 }
 function mapMcpError(status, body) {
     const eapCode = body?.error?.data?.eapCode;
-    const message = body?.error?.message ?? `HTTP ${status}`;
-    if (status === 403 || eapCode?.includes('forbidden') || eapCode?.includes('auth')) {
-        return { error: message, errorCode: eapCode ?? 'NO_PERMISSION', retryable: false };
+    const message = (body?.error?.message ?? '').trim() || `HTTP ${status}`;
+    // 仅 HTTP 403 视为权限拒绝。eapCode 含 auth 是 hop 认证失败，不是 C2。
+    if (status === 403) {
+        return {
+            error: message === `HTTP ${status}` ? '用户无该 Tool 执行权限' : message,
+            errorCode: eapCode ?? 'NO_PERMISSION',
+            retryable: false,
+        };
     }
     if (status === 429) {
         return { error: message, errorCode: eapCode ?? 'RATE_LIMITED', retryable: true };
@@ -104,14 +111,15 @@ export class McpToolExecutor {
             };
         }
         catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
+            const timeoutSec = Math.max(1, Math.round(this.timeout / 1000));
+            const aborted = isAbortError(err);
             return {
                 toolCallId: request.toolCallId,
                 toolName: request.toolName,
                 content: '',
                 success: false,
-                error: message,
-                errorCode: 'EXECUTION_FAILED',
+                error: abortOrTimeoutMessage(err, timeoutSec),
+                errorCode: aborted ? ErrorCodes.TOOL_TIMEOUT : 'EXECUTION_FAILED',
                 retryable: false,
                 runtime: 'server',
             };

package/dist/tool/skill-script-refs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 喂给模型的 SKILL.md 正文展开（不改磁盘）。
+ * 对标 Claude `${CLAUDE_SKILL_DIR}`：作者仍写包内相对路径。
+ * 官方规范不要求脚本必须在 `scripts/`；EAP_SKILL_DIR 是整包绝对根。
+ * 展开成绝对路径，避免 Windows cmd 不认 `$VAR`、多技能时 env 未注入。
+ */
+export declare const EAP_SKILL_DIR_ENV = "EAP_SKILL_DIR";
+export interface ExpandSkillRefsOptions {
+    platform?: string;
+    exists?: (absPath: string) => boolean;
+}
+export declare function normalizeSkillDir(skillDir: string): string;
+export declare function skillEnvRef(platform?: string): string;
+/**
+ * 包内相对脚本路径 → 技能目录绝对路径。
+ * 带目录或 `./` 的（`bin/foo.py`、`./main.py`、`scripts/a.py`）一律展开。
+ * 根上的裸文件名（`main.py`）仅当包内确实有该文件才展开，以免改写「写到用户目录再跑」的例子。
+ */
+export declare function expandSkillScriptRefs(body: string, skillDir: string, platformOrOpts?: string | ExpandSkillRefsOptions): string;
+export declare function isSkillEntryFile(filePath: string): boolean;

package/dist/tool/skill-script-refs.js

@@ -0,0 +1,62 @@
+/**
+ * 喂给模型的 SKILL.md 正文展开（不改磁盘）。
+ * 对标 Claude `${CLAUDE_SKILL_DIR}`：作者仍写包内相对路径。
+ * 官方规范不要求脚本必须在 `scripts/`；EAP_SKILL_DIR 是整包绝对根。
+ * 展开成绝对路径，避免 Windows cmd 不认 `$VAR`、多技能时 env 未注入。
+ */
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+export const EAP_SKILL_DIR_ENV = 'EAP_SKILL_DIR';
+/** 看起来像可执行/源码的扩展名。不是目录白名单。 */
+const CODE_EXT = 'py|js|mjs|cjs|ts|tsx|jsx|sh|bash|zsh|ps1|bat|cmd|exe|rb|pl|php';
+const RELATIVE_CODE_PATH = new RegExp(`(^|[^$\\w./\\\\:%])(\\.\\/)?((?:[\\w.-]+[\\\\/])*[\\w.-]+\\.(?:${CODE_EXT}))\\b`, 'gi');
+export function normalizeSkillDir(skillDir) {
+    return skillDir.replace(/\\/g, '/').replace(/\/+$/, '');
+}
+export function skillEnvRef(platform = process.platform) {
+    return platform === 'win32' ? `%${EAP_SKILL_DIR_ENV}%` : `$${EAP_SKILL_DIR_ENV}`;
+}
+function asOptions(platformOrOpts) {
+    if (typeof platformOrOpts === 'string')
+        return { platform: platformOrOpts };
+    return platformOrOpts ?? {};
+}
+function defaultExists(absPath) {
+    try {
+        return existsSync(absPath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 包内相对脚本路径 → 技能目录绝对路径。
+ * 带目录或 `./` 的（`bin/foo.py`、`./main.py`、`scripts/a.py`）一律展开。
+ * 根上的裸文件名（`main.py`）仅当包内确实有该文件才展开，以免改写「写到用户目录再跑」的例子。
+ */
+export function expandSkillScriptRefs(body, skillDir, platformOrOpts) {
+    const opts = asOptions(platformOrOpts);
+    const platform = opts.platform ?? process.platform;
+    const exists = opts.exists ?? defaultExists;
+    const dir = normalizeSkillDir(skillDir);
+    const expanded = body.replace(RELATIVE_CODE_PATH, (full, prefix, dotSlash, rel) => {
+        const relNorm = rel.replace(/\\/g, '/');
+        const packageRelative = Boolean(dotSlash) || relNorm.includes('/');
+        if (!packageRelative && !exists(path.join(skillDir, relNorm))) {
+            return full;
+        }
+        return `${prefix}${dir}/${relNorm}`;
+    });
+    const envRef = skillEnvRef(platform);
+    const envPath = platform === 'win32' ? `${envRef}\\<相对路径>` : `${envRef}/<相对路径>`;
+    const note = `技能目录（只读）环境变量 ${EAP_SKILL_DIR_ENV}=${dir}。` +
+        `包内任意文件用 ${envPath}（不限 scripts/）。` +
+        `读入正文里像包内脚本的相对路径已展开为绝对路径。` +
+        `当前工作目录是用户目录，相对路径写出在用户目录。\n\n`;
+    if (body.includes(`${EAP_SKILL_DIR_ENV}=`))
+        return expanded;
+    return note + expanded;
+}
+export function isSkillEntryFile(filePath) {
+    return /(^|[\\/])(SKILL\.md|skill\.md)$/i.test(filePath);
+}

package/dist/tool/system-prompt-builder.d.ts

@@ -75,13 +75,13 @@ export interface PromptBuildContext {
     agentCode?: string;
     /** 当前调用用户标识（可选，供「我 / 我的」类指代） */
     userId?: string | null;
-    /** 进程工作目录（文件/命令 jail） */
+    /** 当前用户目录（`users/<userId>`，含用户 skills） */
     workingDirectory?: string;
     os?: {
         platform: string;
         release: string;
     };
-    /** 允许读写/执行的根目录（工作目录 + 技能包 + FILE_IO_ROOT 等） */
+    /** 允许 read_file 的根目录（写根 + 已装配 tools/skills） */
     jailRoots?: string[];
     skillDirs?: Array<{
         skillId: string;

package/dist/tool/system-prompt-builder.js

@@ -17,7 +17,8 @@
  *
  * @see docs/status/module-status-and-backlog.md RT-5
  */
-import { isBuiltinToolExecution } from '@gt-fe/eap-contracts';
+import { isBuiltinToolExecution } from '@eap/contracts';
+import { commandDialectLines } from './harness-command.js';
 // ─────────────────────────────────────────────
 // 平台规则常量（一年改不了两次，不值得搞配置表）
 // ─────────────────────────────────────────────
@@ -192,10 +193,12 @@ export class SystemPromptBuilder {
         const lines = ['## 文件与命令权限'];
         if (workdir) {
             lines.push(`工作目录：${workdir}`);
-            lines.push('`execute_command` 的 cwd **必须**是工作目录，或其位于 jail 内的子目录。');
+            lines.push('`execute_command` 的 cwd **必须**是工作目录或其子目录，不能是预装技能/工具包。');
+            lines.push('技能包只读。跑包内文件用环境变量 `EAP_SKILL_DIR`（技能包绝对根，不限 `scripts/`）。相对写出在工作目录。');
         }
+        lines.push(...commandDialectLines(context.os?.platform ?? process.platform));
         if (skills.length > 0) {
-            lines.push('已装配技能目录（要用时 `read_file` 读该目录下的 `SKILL.md`；scripts / references 默认也在该目录）：');
+            lines.push('已装配技能目录（要用时 `read_file` 读该目录下的 `SKILL.md`；跑包内文件用 `EAP_SKILL_DIR/<相对路径>`）：');
             for (const skill of skills) {
                 const entry = skill.entryFile ?? `${skill.bundlePath}/SKILL.md`;
                 lines.push(`- ${skill.skillId}：${skill.bundlePath}  （入口 ${entry}）`);
@@ -208,12 +211,12 @@ export class SystemPromptBuilder {
                 lines.push(`- ${root}`);
         }
         if (workdir) {
-            lines.push('`write_file` **仅**允许写入工作目录；技能包只读。');
+            lines.push('`write_file` **仅**允许写入当前用户目录（含用户 skills）；预装 tools / skills 只读。');
         }
         lines.push([
             '硬限制：',
             '- `read_file` / `write_file` 的路径必须落在上述允许根内。用户要求越界必须拒绝。',
-            '- `execute_command` 的 cwd 必须落在 jail 内；子进程不继承 API Key 等密钥环境变量。命令本身不是操作系统级文件系统沙箱，禁止尝试读取 `/etc`、家目录或 jail 外路径。',
+            '- `execute_command` 的 cwd 必须落在工作目录内；命令语法跟当前 shell；子进程不继承 API Key 等密钥环境变量。命令本身不是操作系统级文件系统沙箱，禁止尝试读取 `/etc`、家目录或 jail 外路径。',
             '- 禁止用 `..` 逃逸；禁止把 jail 外的绝对路径当参数。',
             '- 不要把内部绝对路径、offload 目录原样展示给用户。',
             '- 技能正文按需读取，不要把技能目录整包读进回复。',

package/dist/tool/timeout.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tool / toolset `timeout`：秒。
+ * 与 `@eap/contracts` `src/tool/timeout.ts` 同语义；Runtime 钉的是 contracts 0.0.9，
+ * 尚未含这些导出。发版 contracts 后改为从 `@eap/contracts` 引用。
+ */
+export declare const DEFAULT_TOOL_TIMEOUT_SEC = 30;
+export declare const DEFAULT_HTTP_TOOL_TIMEOUT_SEC = 10;
+export declare const MIN_TOOL_TIMEOUT_SEC = 1;
+export declare const MAX_TOOL_TIMEOUT_SEC = 300;
+export declare function resolveToolTimeoutSec(timeoutSec: unknown, fallbackSec?: number): number;
+export declare function toToolTimeoutMs(timeoutSec: unknown, fallbackSec?: number): number;
+export declare function isAbortError(error: unknown): boolean;
+export declare function toolTimeoutErrorMessage(timeoutSec: number): string;
+export declare function abortOrTimeoutMessage(error: unknown, timeoutSec: number): string;

package/dist/tool/timeout.js

@@ -0,0 +1,36 @@
+/**
+ * Tool / toolset `timeout`：秒。
+ * 与 `@eap/contracts` `src/tool/timeout.ts` 同语义；Runtime 钉的是 contracts 0.0.9，
+ * 尚未含这些导出。发版 contracts 后改为从 `@eap/contracts` 引用。
+ */
+export const DEFAULT_TOOL_TIMEOUT_SEC = 30;
+export const DEFAULT_HTTP_TOOL_TIMEOUT_SEC = 10;
+export const MIN_TOOL_TIMEOUT_SEC = 1;
+export const MAX_TOOL_TIMEOUT_SEC = 300;
+export function resolveToolTimeoutSec(timeoutSec, fallbackSec = DEFAULT_TOOL_TIMEOUT_SEC) {
+    if (typeof timeoutSec !== 'number' || !Number.isFinite(timeoutSec) || timeoutSec <= 0) {
+        return fallbackSec;
+    }
+    return Math.min(MAX_TOOL_TIMEOUT_SEC, Math.max(MIN_TOOL_TIMEOUT_SEC, Math.trunc(timeoutSec)));
+}
+export function toToolTimeoutMs(timeoutSec, fallbackSec = DEFAULT_TOOL_TIMEOUT_SEC) {
+    return resolveToolTimeoutSec(timeoutSec, fallbackSec) * 1000;
+}
+export function isAbortError(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const err = error;
+    if (err.name === 'AbortError' || err.name === 'TimeoutError' || err.code === 'ABORT_ERR') {
+        return true;
+    }
+    const msg = (err.message ?? '').toLowerCase();
+    return msg === 'this operation was aborted' || msg === 'the operation was aborted';
+}
+export function toolTimeoutErrorMessage(timeoutSec) {
+    return `timeout after ${resolveToolTimeoutSec(timeoutSec)}s`;
+}
+export function abortOrTimeoutMessage(error, timeoutSec) {
+    if (isAbortError(error))
+        return toolTimeoutErrorMessage(timeoutSec);
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/tool/tool-confirmation.js

@@ -50,7 +50,8 @@ export class ToolConfirmationInterceptor {
                 toolName: request.toolName,
                 content: `用户拒绝执行工具 ${request.toolName}`,
                 success: false,
-                error: 'hitl_rejected',
+                error: `用户拒绝执行工具 ${request.toolName}`,
+                errorCode: 'hitl_rejected',
             };
         }
         const resolvedThreadId = threadId ??

package/dist/tool/tool-execution-router.d.ts

@@ -5,7 +5,7 @@
  * @see design.md §1.8.7
  */
 import type { IToolExecutor, ToolCallRequest } from './tool-executor.interface.js';
-import type { ILocalToolInstallStore } from '@gt-fe/eap-contracts';
+import type { ILocalToolInstallStore } from '@eap/contracts';
 export type DeploymentContext = 'server' | 'desktop' | 'dev';
 export interface ToolExecutionRouterOptions {
     httpExecutor: IToolExecutor;

package/dist/tool/tool-execution-router.js

@@ -4,7 +4,7 @@
  * @see docs/contracts/tool-execution.md §6
  * @see design.md §1.8.7
  */
-import { resolveReadyInstallByToolName } from '@gt-fe/eap-contracts';
+import { resolveReadyInstallByToolName } from '@eap/contracts';
 import { isLocalPreferredExecution } from './local-tool-executor.js';
 export class ToolExecutionRouter {
     options;

package/dist/tool/tool-executor.interface.d.ts

@@ -47,10 +47,20 @@ export interface ToolCallRequest {
      */
     execution?: unknown;
     /**
-     * Harness 原语本轮额外 jail 根（已加载 skill 的 bundlePath）。
-     * 与 system prompt 的 jail 根对齐；未传时用构造时 extraRoots / 默认目录。
+     * Harness 写根：`{agentDir}/users/<userId>`（含用户 skills）。
+     * 未传时用构造时 workdir；都缺则拒绝 write_file / execute_command。
+     */
+    jailWorkdir?: string;
+    /**
+     * Harness 本轮只读根：已装配 skill / toolset 的 bundlePath。
+     * 与 system prompt 的 jail 根对齐。
      */
     jailExtraRoots?: string[];
+    /**
+     * 当前技能包绝对路径，注入子进程环境变量 EAP_SKILL_DIR。
+     * 对标 Claude CLAUDE_SKILL_DIR。
+     */
+    skillDir?: string;
 }
 /**
  * ToolCallResult — Tool 调用结果
@@ -64,7 +74,7 @@ export interface ToolCallResult {
     /** Gateway / 本地执行结构化错误码 */
     errorCode?: string;
     retryable?: boolean;
-    runtime?: 'local' | 'server' | 'mock';
+    runtime?: 'local' | 'server';
     /** 工具产出的可下载/可打开文件；不进模型正文 */
     file?: {
         fileName: string;

package/dist/tool/tool-orchestrator.d.ts

@@ -4,7 +4,7 @@
  * @see design.md §1.1 Tool调用编排
  * @see requirements.md Requirement 8 AC1, AC3
  */
-import type { ExecutionContext } from '@gt-fe/eap-contracts';
+import { type ExecutionContext } from '@eap/contracts';
 import type { IGovernanceClient } from '../governance/governance-client.js';
 export type { AuthContext, ToolCallRequest, ToolCallResult, LLMToolCall, LLMToolCallResponse, IToolExecutor, } from './tool-executor.interface.js';
 import type { AuthContext, ToolCallRequest, ToolCallResult, LLMToolCallResponse, IToolExecutor } from './tool-executor.interface.js';

package/dist/tool/tool-orchestrator.js

@@ -4,6 +4,7 @@
  * @see design.md §1.1 Tool调用编排
  * @see requirements.md Requirement 8 AC1, AC3
  */
+import { isBuiltinToolExecution } from '@eap/contracts';
 import { assertToolPermission, GovernanceUnavailableError, PermissionDeniedError, } from '../governance/permission-guard.js';
 /**
  * ToolOrchestrator — Tool 调用编排主服务
@@ -36,7 +37,9 @@ export class ToolOrchestrator {
         });
     }
     async executeSingle(request, executionContext) {
-        if (this.governanceClient && executionContext?.delegationToken) {
+        if (this.governanceClient &&
+            executionContext?.delegationToken &&
+            !isBuiltinToolExecution(request.execution)) {
             try {
                 await assertToolPermission(this.governanceClient, executionContext, request.toolName, {
                     dataScope: request.dataScope ?? 'user-bound',
@@ -50,8 +53,8 @@ export class ToolOrchestrator {
                         toolName: request.toolName,
                         content: '',
                         success: false,
-                        error: error.reason,
-                        errorCode: error instanceof PermissionDeniedError ? 'NO_PERMISSION' : 'GOVERNANCE_UNAVAILABLE',
+                        error: error.message,
+                        errorCode: error.reason,
                     };
                 }
                 throw error;

package/dist/utils/format-error.d.ts

@@ -1,4 +1,4 @@
 /**
- * 将未知异常格式化为可读字符串 — 委托 @gt-fe/eap-contracts
+ * 将未知异常格式化为可读字符串 — 委托 @eap/contracts
  */
-export { formatUnknownError } from '@gt-fe/eap-contracts';
+export { formatUnknownError } from '@eap/contracts';

package/dist/utils/format-error.js

@@ -1,4 +1,4 @@
 /**
- * 将未知异常格式化为可读字符串 — 委托 @gt-fe/eap-contracts
+ * 将未知异常格式化为可读字符串 — 委托 @eap/contracts
  */
-export { formatUnknownError } from '@gt-fe/eap-contracts';
+export { formatUnknownError } from '@eap/contracts';

package/dist/utils/http-error.d.ts

@@ -1,7 +1,7 @@
 /**
- * Runtime HTTP 错误出口 — 对齐 @gt-fe/eap-contracts ErrorCodes / AppError
+ * Runtime HTTP 错误出口 — 对齐 @eap/contracts ErrorCodes / AppError
  */
-import { type ErrorCode, type AppError } from '@gt-fe/eap-contracts';
+import { type ErrorCode, type AppError } from '@eap/contracts';
 import type { ServerResponse } from 'node:http';
 /** 公共 classify；连接失败不再误标为 GOVERNANCE_UNAVAILABLE */
 export declare function classifyRuntimeError(error: unknown): AppError;

package/dist/utils/http-error.js

@@ -1,7 +1,7 @@
 /**
- * Runtime HTTP 错误出口 — 对齐 @gt-fe/eap-contracts ErrorCodes / AppError
+ * Runtime HTTP 错误出口 — 对齐 @eap/contracts ErrorCodes / AppError
  */
-import { classifyError, formatUnknownError, ErrorCodes, } from '@gt-fe/eap-contracts';
+import { classifyError, formatUnknownError, ErrorCodes, } from '@eap/contracts';
 /** 公共 classify；连接失败不再误标为 GOVERNANCE_UNAVAILABLE */
 export function classifyRuntimeError(error) {
     return classifyError(error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-runtime",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Enterprise Agent Platform — Runtime核心：Graph执行引擎、Task生命周期、Session管理、Checkpoint持久化",
   "type": "module",
   "main": "dist/index.js",
@@ -23,6 +23,7 @@
     "start": "node dist/server.js",
     "dev": "npx tsx src/server.ts",
     "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
     "lint": "eslint src --ext .ts",
     "test": "vitest run"
   },
@@ -36,7 +37,6 @@
   "license": "UNLICENSED",
   "dependencies": {
     "@langchain/langgraph": "^0.2.0",
-    "amqplib": "^0.10.0",
     "ioredis": "^5.4.0",
     "pg": "^8.13.0",
     "yaml": "^2.6.1",

package/dist/common/concurrency.d.ts

@@ -1,79 +0,0 @@
-/**
- * 并发控制模块
- *
- * 提供两种并发限制机制：
- * 1. ConcurrencyLimiter — 基于 amqplib channel.prefetch 的 Agent 级并发控制
- *    通过 RabbitMQ consumer prefetch 限制单 Agent 实例同时处理的任务数
- * 2. Semaphore — 纯内存信号量，用于本地并发控制（不依赖 RabbitMQ）
- *
- * @see Requirement 14 AC2: 系统通过消息消费者 prefetch 参数控制单 Agent 实例的并发上限（默认 prefetch=5）
- */
-import type { Channel } from 'amqplib';
-/** ConcurrencyLimiter 默认 prefetch 值 */
-export declare const DEFAULT_PREFETCH = 5;
-/**
- * 基于 amqplib consumer prefetch 的 Agent 级并发限制器
- *
- * RabbitMQ 的 channel.prefetch(n) 表示该 Channel 上的消费者最多同时
- * 持有 n 条未确认消息。超出限制的消息留在 Queue 中排队等待。
- *
- * 整体 QPS = Pod 数 × prefetch。
- */
-export declare class ConcurrencyLimiter {
-    private readonly prefetchCount;
-    /**
-     * @param prefetchCount 单 Agent 实例最大并发任务数，默认 5
-     */
-    constructor(prefetchCount?: number);
-    /**
-     * 配置 amqplib Channel 的 prefetch
-     *
-     * 调用后该 Channel 上的消费者最多同时处理 prefetchCount 条消息。
-     * 超出限制的消息在 RabbitMQ Queue 中排队等待。
-     *
-     * @param channel amqplib Channel 实例
-     */
-    configure(channel: Channel): Promise<void>;
-    /**
-     * 获取配置的最大并发数
-     */
-    getMaxConcurrency(): number;
-}
-/**
- * 内存信号量 — 用于本地并发控制
- *
- * 当无需依赖 RabbitMQ 时（如单进程内限流、测试场景），
- * 使用 Semaphore 控制并发执行数。
- *
- * 用法:
- * ```ts
- * const sem = new Semaphore(3);
- * await sem.acquire(); // 等待可用槽位
- * try {
- *   // 执行并发受限的操作
- * } finally {
- *   sem.release(); // 释放槽位
- * }
- * ```
- */
-export declare class Semaphore {
-    private readonly maxSlots;
-    private currentSlots;
-    private readonly waitQueue;
-    /**
-     * @param maxConcurrency 最大并发数
-     */
-    constructor(maxConcurrency: number);
-    /**
-     * 获取一个可用槽位。如果当前无可用槽位，则等待直到有释放。
-     */
-    acquire(): Promise<void>;
-    /**
-     * 释放一个槽位。如果有等待者，唤醒队列中最先等待的。
-     */
-    release(): void;
-    /**
-     * 当前可用槽位数
-     */
-    get availableSlots(): number;
-}