@lingxiao-office/sdk 1.0.0

package/dist/agents/ProjectControlService.js

@@ -0,0 +1,99 @@
+import { ProjectRuntimeManager } from '../core/ProjectRuntimeManager.js';
+import { EternalRuntimeTelemetry } from '../core/EternalRuntimeTelemetry.js';
+export class ProjectControlService {
+    db;
+    runtimeManager;
+    telemetry;
+    constructor(db, workspace) {
+        this.db = db;
+        this.runtimeManager = new ProjectRuntimeManager(workspace);
+        this.telemetry = new EternalRuntimeTelemetry(workspace);
+    }
+    getCurrentProjectId(sessionId) {
+        const raw = this.db.getSessionState(sessionId, `orchestration_runtime:${sessionId}`);
+        if (!raw || typeof raw !== 'string')
+            return null;
+        try {
+            const parsed = JSON.parse(raw);
+            return parsed.projectId || null;
+        }
+        catch { /* expected: operation may fail gracefully */
+            return null;
+        }
+    }
+    apply(action, input) {
+        const projectId = input.projectId || this.getCurrentProjectId(input.sessionId);
+        if (!projectId) {
+            return '当前没有可控制的 orchestration 项目';
+        }
+        switch (action) {
+            case 'pause':
+                this.runtimeManager.setProjectMode(projectId, 'idle', {
+                    actor: 'operator',
+                    type: 'operator_pause',
+                    summary: input.reason || 'Operator paused project',
+                });
+                this.telemetry.increment(projectId, { projectPaused: 1 });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: 'Project paused by operator', details: input });
+                return `已暂停项目 ${projectId}`;
+            case 'resume':
+                this.runtimeManager.setProjectMode(projectId, 'planning', {
+                    actor: 'operator',
+                    type: 'operator_resume',
+                    summary: input.reason || 'Operator resumed project',
+                });
+                this.telemetry.increment(projectId, { projectResumed: 1 });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: 'Project resumed by operator', details: input });
+                return `已恢复项目 ${projectId}`;
+            case 'reprioritize':
+                this.runtimeManager.updateProject(projectId, (record) => {
+                    record.metadata = { ...(record.metadata || {}), priority: input.priority || 'normal' };
+                    return record;
+                });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: `Project reprioritized to ${input.priority || 'normal'}`, details: input });
+                return `已将项目 ${projectId} 优先级更新为 ${input.priority || 'normal'}`;
+            case 'force_replan':
+                this.runtimeManager.setProjectMode(projectId, 'replanning', {
+                    actor: 'operator',
+                    type: 'operator_force_replan',
+                    summary: input.reason || 'Operator forced replan',
+                });
+                this.telemetry.increment(projectId, { replanCount: 1 });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: 'Project forced into replanning', details: input });
+                return `已对项目 ${projectId} 发起强制重规划`;
+            case 'force_reset':
+                this.runtimeManager.setProjectMode(projectId, 'recovering', {
+                    actor: 'operator',
+                    type: 'operator_force_reset',
+                    summary: input.reason || 'Operator forced context reset',
+                });
+                this.telemetry.increment(projectId, { resetCount: 1 });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: 'Project forced into reset/recovery', details: input });
+                return `已对项目 ${projectId} 发起强制重置`;
+            case 'resolve_dependency':
+                if (!input.dependencyId) {
+                    return '请提供 dependencyId';
+                }
+                this.runtimeManager.updateDependencyStatus(projectId, input.dependencyId, {
+                    status: 'fulfilled',
+                    actor: 'operator',
+                    summary: input.reason || `Dependency ${input.dependencyId} resolved`,
+                });
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: `Dependency ${input.dependencyId} resolved`, details: input });
+                return `已将依赖 ${input.dependencyId} 标记为 fulfilled`;
+            case 'archive':
+                this.runtimeManager.setProjectMode(projectId, 'archived', {
+                    actor: 'operator',
+                    type: 'operator_archive',
+                    summary: input.reason || 'Operator archived project',
+                });
+                this.telemetry.applyRetention(projectId);
+                this.telemetry.recordAudit(projectId, { kind: 'control', summary: 'Project archived', details: input });
+                return `已归档项目 ${projectId}`;
+            default:
+                return '不支持的项目控制动作';
+        }
+    }
+}
+export default ProjectControlService;
+//# sourceMappingURL=ProjectControlService.js.map

package/dist/agents/ProjectControlService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectControlService.js","sourceRoot":"","sources":["../../src/agents/ProjectControlService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAW7E,MAAM,OAAO,qBAAqB;IACxB,EAAE,CAAkB;IACpB,cAAc,CAAwB;IACtC,SAAS,CAA0B;IAE3C,YAAY,EAAmB,EAAE,SAAiB;QAChD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,cAAc,GAAG,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,mBAAmB,CAAC,SAAiB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,yBAAyB,SAAS,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;YACzD,OAAO,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAA,6CAA6C;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAA4B,EAAE,KAMnC;QACC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/E,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,2BAA2B,CAAC;QACrC,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,OAAO;gBACV,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE;oBACpD,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,yBAAyB;iBACnD,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1D,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAClH,OAAO,SAAS,SAAS,EAAE,CAAC;YAC9B,KAAK,QAAQ;gBACX,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE;oBACxD,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,0BAA0B;iBACpD,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC3D,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,6BAA6B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnH,OAAO,SAAS,SAAS,EAAE,CAAC;YAC9B,KAAK,cAAc;gBACjB,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;oBACtD,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;oBACvF,OAAO,MAAM,CAAC;gBAChB,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,4BAA4B,KAAK,CAAC,QAAQ,IAAI,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9I,OAAO,QAAQ,SAAS,WAAW,KAAK,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAClE,KAAK,cAAc;gBACjB,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE;oBAC1D,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,wBAAwB;iBAClD,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;gBACxD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAgC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtH,OAAO,QAAQ,SAAS,UAAU,CAAC;YACrC,KAAK,aAAa;gBAChB,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE;oBAC1D,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,+BAA+B;iBACzD,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;gBACvD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC1H,OAAO,QAAQ,SAAS,SAAS,CAAC;YACpC,KAAK,oBAAoB;gBACvB,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBACxB,OAAO,kBAAkB,CAAC;gBAC5B,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,EAAE;oBACxE,MAAM,EAAE,WAAW;oBACnB,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,cAAc,KAAK,CAAC,YAAY,WAAW;iBACrE,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,KAAK,CAAC,YAAY,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjI,OAAO,QAAQ,KAAK,CAAC,YAAY,gBAAgB,CAAC;YACpD,KAAK,SAAS;gBACZ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE;oBACxD,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,2BAA2B;iBACrD,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;gBACzC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACxG,OAAO,SAAS,SAAS,EAAE,CAAC;YAC9B;gBACE,OAAO,YAAY,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/agents/RoleCapabilityModel.d.ts

@@ -0,0 +1,125 @@
+import type { AgentRole } from './RoleRegistry.js';
+import type { SkillDescriptor } from '../core/SkillCatalog.js';
+import type { PromptLocale } from './prompts/i18n/catalog.js';
+export type RoleCapabilityTier = 'read' | 'compute' | 'execute' | 'write';
+export type RoleCapabilitySource = 'preset' | 'preset_enhanced' | 'custom';
+export type SkillPrioritySource = 'user_explicit' | 'leader_explicit' | 'role_default';
+export type PresetRoleName = 'research' | 'explore' | 'coding' | 'verify' | 'review' | 'frontend' | 'backend' | 'fullstack' | 'qa' | 'ux_designer' | 'planner' | 'evaluator' | 'architect';
+export interface RoleCapabilityProfile {
+    source: RoleCapabilitySource;
+    baselineRole?: PresetRoleName;
+    allowedTiers: RoleCapabilityTier[];
+    defaultSkillNames: string[];
+    skillPriority: SkillPrioritySource[];
+}
+export interface PresetRoleProfile {
+    name: PresetRoleName;
+    description: string;
+    tools: string[];
+    allowedTiers: RoleCapabilityTier[];
+    defaultSkillNames: string[];
+    /** Per-role context token budget (0 = use global default). */
+    contextBudget?: number;
+}
+export interface BuiltinRolePromptMap {
+    research: Record<PromptLocale, string>;
+    explore: Record<PromptLocale, string>;
+    coding: Record<PromptLocale, string>;
+    verify: Record<PromptLocale, string>;
+    review: Record<PromptLocale, string>;
+    frontend: Record<PromptLocale, string>;
+    backend: Record<PromptLocale, string>;
+    fullstack: Record<PromptLocale, string>;
+    qa: Record<PromptLocale, string>;
+    ux_designer: Record<PromptLocale, string>;
+    planner: Record<PromptLocale, string>;
+    evaluator: Record<PromptLocale, string>;
+    architect: Record<PromptLocale, string>;
+}
+export interface ResolvedRoleCapability {
+    tools: string[];
+    droppedTools: string[];
+    skillNames: string[];
+    skillSources: Record<string, SkillPrioritySource>;
+    capabilityProfile: RoleCapabilityProfile;
+}
+/**
+ * Workflow 工具的真正常量在 `contracts/constants/leaderToolDefinitions.ts` 的 WORKFLOW_TOOL_NAMES。
+ * 默认情况下不再把它们塞进任何预设角色的工具白名单——只有当 Leader/会话开启
+ * "workflow 模式" 时，对应工具才在 Leader 候选清单中露出
+ * （见 LeaderToolGates.filterLeaderTools / SESSION_KEYS.WORKFLOW_MODE_ACTIVE）。
+ * 这避免和 Leader 自身的 create_task / dispatch_agent 编排路径形成两套
+ * 并行的任务图语义混淆。
+ */
+export declare const ROLE_SKILL_PRIORITY: SkillPrioritySource[];
+/** 暴露给配置层（settings.json）：默认基础工具集名单 */
+export declare const DEFAULT_BASIC_TOOLS: ReadonlyArray<string>;
+/**
+ * 统一 Worker 工具集 —— 不再按角色切割工具。
+ *
+ * 全系统只保留两套工具切割：Leader（元工具 + direct tools，见 contracts/constants/leaderToolDefinitions）
+ * 与 Worker（这里）。所有内置/自定义 worker 角色共享同一套工具，职责差异完全靠
+ * description + systemPrompt 引导，而不是用工具裁剪做硬隔离。
+ *
+ * 历史上按角色切工具（frontend 只有 browser、backend 只有 http_request、research
+ * 没 file_create……）反复导致 Leader 派活时因"目标角色没某个工具"被迫重派/卡死，
+ * 还漏掉了 send_message / write_work_note 这类必需的协作工具。
+ *
+ * 不包含的工具按"模式门控"动态注入，不进基础集：
+ *   - bughunt scan / ledger（仅 bughunt 模式，见 LeaderToolGates）
+ *   - workflow 统一入口（仅 workflow 模式）
+ *   - blackboard 统一入口写入（blackboard(action="...")，仅 blackboard 模式）
+ *   - office 产物工具在 Office mode 下才暴露；普通模式由 BaseAgent/ToolPruner 统一剔除
+ */
+export declare const WORKER_TOOLS: string[];
+export declare const PRESET_ROLE_PROFILES: Record<PresetRoleName, PresetRoleProfile>;
+export declare function getToolCapabilityTier(toolName: string): RoleCapabilityTier | null;
+export declare function isToolAllowedByCapabilityTiers(toolName: string, allowedTiers: RoleCapabilityTier[]): boolean;
+export declare function buildBuiltinRoles(promptMap: BuiltinRolePromptMap): AgentRole[];
+/**
+ * 用户角色覆盖配置（每个角色名 → 增/减工具）。
+ * 与 settings.json 中 roles.overrides 字段同形。
+ */
+export interface RoleToolsOverride {
+    tools_added?: string[];
+    tools_removed?: string[];
+}
+export interface RoleToolsOverrideMap {
+    [roleName: string]: RoleToolsOverride | undefined;
+}
+/**
+ * 在角色 tools 上叠加用户配置。
+ *
+ * - basicToolsEnabled=false：从 tools 里剥离 BASIC_TOOLS（保留 profile 自带的非基础工具与 workflow / team_comm）。
+ * - overrides[name].tools_added：合并补齐
+ * - overrides[name].tools_removed：移除（在 add 之后再做差集，让用户能精准否决某个 add）
+ *
+ * 注意：返回的是新数组，不修改入参 role。
+ */
+export declare function applyRoleToolsConfig(role: AgentRole, options: {
+    basicToolsEnabled?: boolean;
+    overrides?: RoleToolsOverrideMap;
+}): AgentRole;
+export declare function applyRoleToolsConfigMap(roles: AgentRole[], options: {
+    basicToolsEnabled?: boolean;
+    overrides?: RoleToolsOverrideMap;
+}): AgentRole[];
+export declare function resolveRoleSkillPriority(input: {
+    userExplicitSkillNames?: string[];
+    leaderExplicitSkillNames?: string[];
+    roleDefaultSkillNames?: string[];
+}): {
+    skillNames: string[];
+    sources: Record<string, SkillPrioritySource>;
+};
+export declare function resolveDynamicRoleCapability(input: {
+    roleName: string;
+    roleDescription: string;
+    systemPrompt: string;
+    requestedTools: string[];
+    availableSkills: SkillDescriptor[];
+    requestedSkillNames?: string[];
+    userRequestedSkillNames?: string[];
+    baseRoleName?: string;
+}): ResolvedRoleCapability;
+//# sourceMappingURL=RoleCapabilityModel.d.ts.map

package/dist/agents/RoleCapabilityModel.d.ts.map

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

package/dist/agents/RoleCapabilityModel.js

@@ -0,0 +1,303 @@
+import { getToolCapabilityTier as getMetadataToolCapabilityTier } from '../tools/ToolMetadata.js';
+import { OFFICE_TOOL_NAMES } from '../tools/officeToolContract.js';
+/**
+ * Workflow 工具的真正常量在 `contracts/constants/leaderToolDefinitions.ts` 的 WORKFLOW_TOOL_NAMES。
+ * 默认情况下不再把它们塞进任何预设角色的工具白名单——只有当 Leader/会话开启
+ * "workflow 模式" 时，对应工具才在 Leader 候选清单中露出
+ * （见 LeaderToolGates.filterLeaderTools / SESSION_KEYS.WORKFLOW_MODE_ACTIVE）。
+ * 这避免和 Leader 自身的 create_task / dispatch_agent 编排路径形成两套
+ * 并行的任务图语义混淆。
+ */
+// P0-1b: TOOL_TIER_MAP 已移除，tier 统一由 ToolMetadata.ts 的 TOOL_METADATA 单一事实源提供。
+// getToolCapabilityTier 直接委托 getMetadataToolCapabilityTier，不再有 fallback 双源。
+export const ROLE_SKILL_PRIORITY = [
+    'user_explicit',
+    'leader_explicit',
+    'role_default',
+];
+const TEAM_COMM_TOOLS = ['team_message', 'team_inbox', 'team_manage'];
+/**
+ * 通信 / 工作笔记工具 —— 跨 Agent 协作的核心机制。
+ *
+ * 历史 bug：这 4 个工具在 ToolRegistry 里注册了，却没进任何角色的 tools 白名单，
+ * 于是 BaseAgent.getToolDefinitions() 按 role.tools 过滤后 worker 永远看不到它们，
+ * 哪怕 prompt 一直叫它调 write_work_note / send_message —— 表现为"环境未提供
+ * write_work_note 工具"。统一并入 WORKER_TOOLS，从根上修掉。
+ */
+const COMM_TOOLS = ['send_message', 'write_work_note', 'read_work_notes', 'request_work_note'];
+const MEMORY_TOOLS = ['memory', 'memory_read', 'memory_write'];
+/**
+ * 所有内置角色的"基础工具集"——读 / 写 / 搜索 / 结构化补丁 / python / shell。
+ * 保留给 settings.json 的 basic_tools_enabled 开关与前端 RolesRoutes 使用。
+ */
+const BASIC_TOOLS = [
+    'file_read',
+    'file_create',
+    'structured_patch',
+    'code_search',
+    'list_dir',
+    'glob',
+    'shell',
+    'python_exec',
+];
+/** 暴露给配置层（settings.json）：默认基础工具集名单 */
+export const DEFAULT_BASIC_TOOLS = BASIC_TOOLS;
+const ALL_TIERS = ['read', 'compute', 'execute', 'write'];
+function mergeTools(...groups) {
+    return Array.from(new Set(groups.flat().filter(Boolean)));
+}
+/**
+ * 统一 Worker 工具集 —— 不再按角色切割工具。
+ *
+ * 全系统只保留两套工具切割：Leader（元工具 + direct tools，见 contracts/constants/leaderToolDefinitions）
+ * 与 Worker（这里）。所有内置/自定义 worker 角色共享同一套工具，职责差异完全靠
+ * description + systemPrompt 引导，而不是用工具裁剪做硬隔离。
+ *
+ * 历史上按角色切工具（frontend 只有 browser、backend 只有 http_request、research
+ * 没 file_create……）反复导致 Leader 派活时因"目标角色没某个工具"被迫重派/卡死，
+ * 还漏掉了 send_message / write_work_note 这类必需的协作工具。
+ *
+ * 不包含的工具按"模式门控"动态注入，不进基础集：
+ *   - bughunt scan / ledger（仅 bughunt 模式，见 LeaderToolGates）
+ *   - workflow 统一入口（仅 workflow 模式）
+ *   - blackboard 统一入口写入（blackboard(action="...")，仅 blackboard 模式）
+ *   - office 产物工具在 Office mode 下才暴露；普通模式由 BaseAgent/ToolPruner 统一剔除
+ */
+export const WORKER_TOOLS = mergeTools(['session_artifacts', 'find_tools', 'tool_preflight', 'parallel_read_batch', 'design_asset'], BASIC_TOOLS, ['web_fetch', 'web_search', 'http_request', 'parse_file'], [...OFFICE_TOOL_NAMES], ['screenshot', 'visual_contact_sheet', 'browser_visual_verify', 'browser_action', 'ocr', 'mcp', 'node_repl'], MEMORY_TOOLS, COMM_TOOLS, TEAM_COMM_TOOLS, 
+// Blackboard 统一入口 — 普通模式会由 ToolPruner 剔除；黑板启用时使用单一写入入口。
+['blackboard'], 
+// 任务收尾 + 假设声明：必须对所有角色可见，否则无法产出结构化验收/早期证伪证据
+['attempt_completion', 'declare_assumption']);
+export const PRESET_ROLE_PROFILES = {
+    research: {
+        name: 'research',
+        description: '调研分析专家，负责代码库调研和技术方案分析',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute'],
+        defaultSkillNames: [],
+        contextBudget: 120_000,
+    },
+    explore: {
+        name: 'explore',
+        description: '只读探索 Agent：在独立上下文中对代码库/资料做广度优先搜索，只回流结论与证据（文件路径:行号），不污染主上下文。工具集经 capability tier 硬裁剪为只读（read/compute tier），无任何写入或执行代码能力。',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute'],
+        defaultSkillNames: [],
+        contextBudget: 80_000,
+    },
+    coding: {
+        name: 'coding',
+        description: '代码实现专家，负责编写和修改代码。注意：HTML/PPT/Word/Excel/海报等交付物由 Leader 统一生成，agent 只产出 markdown 写到 scratchpad',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: ['explore-implement-verify'],
+        contextBudget: 200_000,
+    },
+    verify: {
+        name: 'verify',
+        description: '验证测试专家，负责运行测试和验证实现',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: ['explore-implement-verify'],
+        contextBudget: 150_000,
+    },
+    review: {
+        name: 'review',
+        description: '代码审查专家，负责审查代码质量和提出改进建议',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute'],
+        defaultSkillNames: [],
+    },
+    frontend: {
+        name: 'frontend',
+        description: '前端开发专家，负责 UI/UX 实现、组件开发、样式调试和前端构建',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+        contextBudget: 200_000,
+    },
+    backend: {
+        name: 'backend',
+        description: '后端开发专家，负责 API 开发、数据库设计、服务架构和性能优化',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: ['debug-frontend-backend-contract'],
+    },
+    fullstack: {
+        name: 'fullstack',
+        description: '全栈开发专家，负责前后端契约清晰的小到中型跨栈实现和端到端验证。注意：HTML/PPT/Word/Excel/海报等交付物由 Leader 统一生成，agent 只产出 markdown 写到 scratchpad',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+        contextBudget: 300_000,
+    },
+    qa: {
+        name: 'qa',
+        description: '质量保证专家，负责测试策略制定、自动化测试编写和质量门禁把控',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    ux_designer: {
+        name: 'ux_designer',
+        description: '用户体验设计师，负责交互设计、用户体验优化和可用性评估',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    planner: {
+        name: 'planner',
+        description: '规划智能体，负责将简短需求扩展为完整产品规格与编排节点',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute'],
+        defaultSkillNames: [],
+    },
+    evaluator: {
+        name: 'evaluator',
+        description: '独立评估智能体，负责基于契约和评分标准严格评判生成结果，使用浏览器工具实际测试运行中的应用',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute', 'execute'],
+        defaultSkillNames: [],
+    },
+    architect: {
+        name: 'architect',
+        description: '架构契约责任人。跨栈任务开工前先把前后端共享接口、数据结构、错误码和状态流写成 graph_contract（surface/title/version/content），落到黑板供 frontend/backend worker 消费。不下沉到具体代码实现，由 Leader 派发实现。',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: ['read', 'compute', 'write'],
+        defaultSkillNames: ['debug-frontend-backend-contract'],
+    },
+};
+function unique(values) {
+    return Array.from(new Set(values.filter(Boolean)));
+}
+export function getToolCapabilityTier(toolName) {
+    return getMetadataToolCapabilityTier(toolName);
+}
+export function isToolAllowedByCapabilityTiers(toolName, allowedTiers) {
+    const tier = getToolCapabilityTier(toolName);
+    if (!tier) {
+        return false;
+    }
+    return allowedTiers.includes(tier);
+}
+export function buildBuiltinRoles(promptMap) {
+    return Object.keys(PRESET_ROLE_PROFILES).map((name) => {
+        const profile = PRESET_ROLE_PROFILES[name];
+        return {
+            name: profile.name,
+            description: profile.description,
+            systemPrompt: promptMap[name].zh,
+            systemPromptByLocale: promptMap[name],
+            tools: unique([...profile.tools]),
+            skillNames: [...profile.defaultSkillNames],
+            createdBy: 'system',
+            capabilityProfile: {
+                source: 'preset',
+                baselineRole: profile.name,
+                allowedTiers: [...profile.allowedTiers],
+                defaultSkillNames: [...profile.defaultSkillNames],
+                skillPriority: [...ROLE_SKILL_PRIORITY],
+            },
+        };
+    });
+}
+/**
+ * 在角色 tools 上叠加用户配置。
+ *
+ * - basicToolsEnabled=false：从 tools 里剥离 BASIC_TOOLS（保留 profile 自带的非基础工具与 workflow / team_comm）。
+ * - overrides[name].tools_added：合并补齐
+ * - overrides[name].tools_removed：移除（在 add 之后再做差集，让用户能精准否决某个 add）
+ *
+ * 注意：返回的是新数组，不修改入参 role。
+ */
+export function applyRoleToolsConfig(role, options) {
+    const basicEnabled = options.basicToolsEnabled !== false;
+    const override = options.overrides?.[role.name];
+    let tools = [...role.tools];
+    if (!basicEnabled) {
+        const basicSet = new Set(BASIC_TOOLS);
+        // 还原到 profile 中"非基础工具"集合（如 ux_designer 历史上只有 file_read/code_search）
+        // 但我们已经把所有角色统一带 BASIC，这里给关闭后兜底回 read-only 视图。
+        tools = tools.filter((t) => !basicSet.has(t) || t === 'file_read');
+    }
+    if (override?.tools_added && override.tools_added.length > 0) {
+        tools.push(...override.tools_added);
+    }
+    if (override?.tools_removed && override.tools_removed.length > 0) {
+        const removeSet = new Set(override.tools_removed);
+        tools = tools.filter((t) => !removeSet.has(t));
+    }
+    return {
+        ...role,
+        tools: unique(tools),
+    };
+}
+export function applyRoleToolsConfigMap(roles, options) {
+    if (options.basicToolsEnabled !== false && (!options.overrides || Object.keys(options.overrides).length === 0)) {
+        return roles;
+    }
+    return roles.map((r) => applyRoleToolsConfig(r, options));
+}
+export function resolveRoleSkillPriority(input) {
+    const ordered = [
+        ['user_explicit', input.userExplicitSkillNames],
+        ['leader_explicit', input.leaderExplicitSkillNames],
+        ['role_default', input.roleDefaultSkillNames],
+    ];
+    const seen = new Set();
+    const skillNames = [];
+    const sources = {};
+    for (const [source, values] of ordered) {
+        for (const name of values || []) {
+            if (!name || seen.has(name)) {
+                continue;
+            }
+            seen.add(name);
+            skillNames.push(name);
+            sources[name] = source;
+        }
+    }
+    return { skillNames, sources };
+}
+export function resolveDynamicRoleCapability(input) {
+    // 仅在 Leader/调用方显式传 baseRoleName 时套用对应预设 profile；
+    // base role 只能来自显式字段，description/systemPrompt/tools 不参与本地推断。
+    const baseProfile = input.baseRoleName && input.baseRoleName in PRESET_ROLE_PROFILES
+        ? PRESET_ROLE_PROFILES[input.baseRoleName]
+        : undefined;
+    const requestedTools = unique(input.requestedTools);
+    const baselineTools = baseProfile ? unique([...baseProfile.tools]) : [];
+    const mergedTools = unique([...baselineTools, ...requestedTools]);
+    const allowedTiers = baseProfile?.allowedTiers || ['read', 'compute', 'execute'];
+    // 受限角色（allowedTiers 不含 write 或 execute）强制按 capability tier 硬裁剪：
+    // 任何来源（baseline / 增强 / settings override / role_definition 请求）塞入的写/执行
+    // 工具都会被剥离到 droppedTools，保证只读角色在工具层确定性只读，不靠 prompt 自觉。
+    // 全 tier 角色走原路径，零行为变化。
+    const tierRestricted = !allowedTiers.includes('write') || !allowedTiers.includes('execute');
+    const tools = tierRestricted
+        ? mergedTools.filter((t) => isToolAllowedByCapabilityTiers(t, allowedTiers))
+        : mergedTools;
+    const droppedTools = tierRestricted
+        ? mergedTools.filter((t) => !isToolAllowedByCapabilityTiers(t, allowedTiers))
+        : [];
+    const availableSkillNames = new Set(input.availableSkills.map((skill) => skill.name));
+    const skillResolution = resolveRoleSkillPriority({
+        userExplicitSkillNames: (input.userRequestedSkillNames || []).filter((name) => availableSkillNames.has(name)),
+        leaderExplicitSkillNames: (input.requestedSkillNames || []).filter((name) => availableSkillNames.has(name)),
+        roleDefaultSkillNames: (baseProfile?.defaultSkillNames || []).filter((name) => availableSkillNames.has(name)),
+    });
+    return {
+        tools,
+        droppedTools,
+        skillNames: skillResolution.skillNames,
+        skillSources: skillResolution.sources,
+        capabilityProfile: {
+            source: baseProfile ? 'preset_enhanced' : 'custom',
+            baselineRole: baseProfile?.name,
+            allowedTiers,
+            defaultSkillNames: baseProfile?.defaultSkillNames || [],
+            skillPriority: [...ROLE_SKILL_PRIORITY],
+        },
+    };
+}
+//# sourceMappingURL=RoleCapabilityModel.js.map

package/dist/agents/RoleCapabilityModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoleCapabilityModel.js","sourceRoot":"","sources":["../../src/agents/RoleCapabilityModel.ts"],"names":[],"mappings":"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"}

package/dist/agents/RoleRegistry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * AgentRoleRegistry - Agent 角色注册表
+ * 管理预设角色和动态定义的自定义角色
+ */
+import type { RoleCapabilityProfile } from './RoleCapabilityModel.js';
+import type { PromptLocale } from './prompts/i18n/catalog.js';
+/** 角色解析回落到的默认规范角色（无法从名字推断出任何已存在角色时使用）。 */
+export declare const ROLE_FALLBACK_DEFAULT = "fullstack";
+export declare function resolveRoleFromName(rawName: string, availableRoleNames: string[]): string | undefined;
+/**
+ * Agent 角色定义
+ */
+export interface AgentRole {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    /** 按 locale 的 system prompt 映射；派发时由 getPromptLocale() 选定，缺失则回落 systemPrompt */
+    systemPromptByLocale?: Record<PromptLocale, string>;
+    tools: string[];
+    droppedTools?: string[];
+    skillNames?: string[];
+    capabilityProfile?: RoleCapabilityProfile;
+    model?: string;
+    worker_backend?: 'worker_process' | 'claude' | 'codex';
+    worker_config?: {
+        env?: Record<string, string>;
+        extra_args?: string[];
+        timeout_ms?: number;
+        idle_timeout_ms?: number;
+        wire_api?: 'chat' | 'responses';
+        no_bare?: boolean;
+    };
+    /** Git author identity for this role's commits. When set, git commit uses
+     *  `git -c user.name=... -c user.email=...` to attribute the commit.
+     *  Useful for multi-agent team workflows where audit trail matters. */
+    gitIdentity?: {
+        name: string;
+        email: string;
+    };
+    createdBy: 'system' | 'llm' | 'user';
+}
+/**
+ * Agent 角色注册表
+ */
+export declare class AgentRoleRegistry {
+    protected roles: Map<string, AgentRole>;
+    /**
+     * 注册角色
+     */
+    register(role: AgentRole): AgentRole;
+    /**
+     * 检查角色是否存在
+     */
+    exists(name: string): boolean;
+    /**
+     * 把一个（可能为变体/缩写的）角色名归约到注册表里真实存在的规范角色名；
+     * 命中不了返回 undefined。确定性匹配，详见模块级 resolveRoleFromName。
+     */
+    resolveFromName(rawName: string): string | undefined;
+    /**
+     * 获取角色
+     */
+    get(name: string): AgentRole | undefined;
+    /**
+     * 删除角色。默认禁止删除系统预设角色，避免把基础能力面删坏。
+     */
+    unregister(name: string, options?: {
+        allowSystem?: boolean;
+    }): AgentRole | undefined;
+    /**
+     * 列出所有角色名
+     */
+    listRoleNames(): string[];
+    /**
+     * 列出所有角色
+     */
+    listRoles(): AgentRole[];
+    /**
+     * 生成 LLM 可读的角色上下文
+     */
+    toLLMContext(): string;
+    /**
+     * 转换为字典格式（用于持久化）
+     */
+    toDict(): Record<string, AgentRole>;
+    /**
+     * 从字典加载角色
+     */
+    loadFromDict(data: Record<string, AgentRole>): void;
+}
+export default AgentRoleRegistry;
+//# sourceMappingURL=RoleRegistry.d.ts.map