@lingxiao-office/sdk 1.0.0

package/dist/agents/leader/LeaderToolGates.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Leader 工具门控的纯函数模块。
+ *
+ * 历史上 Leader 这条链路上分散了几处"按模式 / 按角色 / 按执行类别过滤工具"的逻辑：
+ *   - LeaderExecutionController.getActiveToolDefinitions：按 bughunt/office 模式过滤
+ *   - ToolPruner.filterToolsByMode：按 'bughunt' / 'blackboard' 执行模式过滤
+ *   - LeaderToolsExecutor.validateDispatchAgentName：按 active team roster 校验目标 agent
+ *   - LeaderToolsExecutor.isLeaderExecutionPermissionRequest：拦截 Leader 自己申请实现类权限
+ *
+ * 这些都是无副作用的纯逻辑（只读输入 → 纯结果），却各自塞在对应类的 protected 方法里，
+ * 写测试要先把整个 LeaderAgent 起来，重构起来也碍事。这里把它们抽成模块级纯函数，
+ * controller / executor 改为转发调用。
+ *
+ * 注意：抽的是判定与过滤的语义，不抽副作用（setActiveTeam / emit / setSessionState）；
+ * 后者仍然属于 controller / executor 的职责，要通过显式调用纯函数后再执行副作用。
+ */
+import type { ToolDefinition } from '../../llm/types.js';
+import { type ToolMetadata } from '../../tools/ToolMetadata.js';
+import type { ModeRuntimeProjection } from '../../core/ModeRuntimeProjection.js';
+import type { ToolPermissionContext } from '../../core/PermissionSystem.js';
+import type { AutonomyDecision } from '../../contracts/types/AutonomyDecision.js';
+/**
+ * Bughunt 扫描类工具（已下放为普通 Tool，注册在 ToolRegistry 中），
+ * 仍然只允许在 bughunt 模式下露出给 Leader / Worker。
+ *
+ * 注意：bughunt ledger 工具（set_bughunt_dag / upsert_bughunt_finding / get_bughunt_*）
+ * 是另外一组，由 BUGHUNT_TOOLS schema 定义，命中字段都在 leaderToolDefinitions.ts。
+ */
+export declare const BUGHUNT_SCAN_NAMES: ReadonlySet<string>;
+/**
+ * Blackboard 写入类工具 — 仅在 'blackboard' 执行模式下露出。
+ * 抽到模块级常量供 filterToolsByExecutionMode 与 worker 角色裁剪共用。
+ */
+export declare const BLACKBOARD_TOOL_NAMES: ReadonlySet<string>;
+export interface LeaderToolFilterInput {
+    /** Leader meta + direct tools 合并后的候选清单 */
+    candidates: ToolDefinition[];
+    /** Bughunt schema 工具（leaderToolDefinitions.BUGHUNT_TOOLS） */
+    bughuntTools: readonly ToolDefinition[];
+    /** Office 模式专属工具名列表（leaderToolDefinitions.OFFICE_TOOL_NAMES） */
+    officeToolNames: readonly string[];
+    /** Workflow 模式专属工具名列表（leaderToolDefinitions.WORKFLOW_TOOL_NAMES） */
+    workflowToolNames: readonly string[];
+    bughuntMode: boolean;
+    officeMode: boolean;
+    workflowMode: boolean;
+    modes?: ModeRuntimeProjection;
+    /**
+     * 黑板是否启用。false 时把 blackboard 统一入口及黑板写入工具从
+     * Leader 工具集中剔除 —— 否则 Leader 会调用一个底层 graph 为 null、必然报
+     * 「黑板图未初始化」的工具，浪费轮次。默认 true。
+     */
+    blackboardEnabled?: boolean;
+}
+/**
+ * Leader 视角下根据 bughunt / office / workflow 模式过滤可见工具。
+ *
+ * 行为：
+ *   - bughunt 开 → 把 BUGHUNT_TOOLS 注入到候选前，去重；scan 工具天然保留
+ *   - bughunt 关 → 候选中过滤掉所有 BUGHUNT_TOOLS schema + scan 工具名
+ *   - office 关 → 过滤掉 office 专属工具
+  *   - workflow 关 → 过滤掉 workflow 专属工具（7 件套已在核心工具里立即注册）
+  *   - Leader 保留执行类工具，按 S1/S2/S3 分层决定自办或派发
+  *   - 最终按 function.name 去重，先出先留
+ */
+export declare function filterLeaderTools(input: LeaderToolFilterInput): ToolDefinition[];
+/** 按 function.name 去重，保留首次出现的 ToolDefinition */
+export declare function dedupeToolsByName(tools: ToolDefinition[]): ToolDefinition[];
+/**
+ * Worker / pruner 视角的执行模式工具过滤。
+ *
+ * - 'bughunt' 模式：bughunt schema 工具 + scan 工具仅此模式可见
+ * - 'blackboard' 模式：blackboard 写入工具仅此模式可见
+ * - 其余模式：上述两类工具都被剔除
+ *
+ * 注意：函数返回的工具数组是输入的子集，保留原顺序。
+ */
+export declare function filterToolsByExecutionMode(tools: ToolDefinition[], mode: string, bughuntToolNames: readonly string[]): ToolDefinition[];
+/**
+ * Leader 调用 dispatch_agent 之前的目标名校验。
+ *
+ * 真值矩阵：
+ *   - 没有 active team → 拒绝，提示先 team_manage(action="create")
+ *   - active team roster 空 → 拒绝，提示 team_manage(action="create") 加 members
+ *   - agent 不在 roster.member 中 → 拒绝，列出可派发成员
+ *   - 否则 → ok
+ */
+export interface DispatchAgentNameInput {
+    agentName: string;
+    activeTeam: string | null;
+    roster: ReadonlyArray<{
+        name: string;
+        role: string;
+    }>;
+}
+export type DispatchAgentNameResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function validateDispatchAgentName(input: DispatchAgentNameInput): DispatchAgentNameResult;
+/** 把 roster 渲染成 `@name(role), @name(role)` 列表，给错误信息和系统注入用 */
+export declare function formatRoster(roster: ReadonlyArray<{
+    name: string;
+    role: string;
+}>): string;
+/**
+ * Leader 与 Worker 均可使用的执行类工具集合。
+ * 该集合仅用于测试/策略识别；是否调用由 Leader 的 S1/S2/S3 分层提示词决定。
+ */
+export declare const LEADER_EXECUTION_TOOLS: ReadonlySet<string>;
+export declare function isLeaderExecutionTool(toolName: string): boolean;
+export type LeaderAutonomyToolGateResult = {
+    ok: true;
+    decision: AutonomyDecision;
+} | {
+    ok: false;
+    decision: AutonomyDecision;
+    message: string;
+    gateKind: 'forbidden' | 'confirmation_required';
+};
+export interface LeaderAutonomyToolGateInput {
+    toolName: string;
+    args?: Record<string, unknown>;
+    modes: ModeRuntimeProjection;
+    permissionContext?: ToolPermissionContext | null;
+    metadata?: ToolMetadata;
+}
+export declare function evaluateLeaderAutonomyToolGate(input: LeaderAutonomyToolGateInput): LeaderAutonomyToolGateResult;
+//# sourceMappingURL=LeaderToolGates.d.ts.map

package/dist/agents/leader/LeaderToolGates.d.ts.map

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

package/dist/agents/leader/LeaderToolGates.js

@@ -0,0 +1,290 @@
+/**
+ * Leader 工具门控的纯函数模块。
+ *
+ * 历史上 Leader 这条链路上分散了几处"按模式 / 按角色 / 按执行类别过滤工具"的逻辑：
+ *   - LeaderExecutionController.getActiveToolDefinitions：按 bughunt/office 模式过滤
+ *   - ToolPruner.filterToolsByMode：按 'bughunt' / 'blackboard' 执行模式过滤
+ *   - LeaderToolsExecutor.validateDispatchAgentName：按 active team roster 校验目标 agent
+ *   - LeaderToolsExecutor.isLeaderExecutionPermissionRequest：拦截 Leader 自己申请实现类权限
+ *
+ * 这些都是无副作用的纯逻辑（只读输入 → 纯结果），却各自塞在对应类的 protected 方法里，
+ * 写测试要先把整个 LeaderAgent 起来，重构起来也碍事。这里把它们抽成模块级纯函数，
+ * controller / executor 改为转发调用。
+ *
+ * 注意：抽的是判定与过滤的语义，不抽副作用（setActiveTeam / emit / setSessionState）；
+ * 后者仍然属于 controller / executor 的职责，要通过显式调用纯函数后再执行副作用。
+ */
+import { BUGHUNT_SCAN_TOOL_NAMES } from '../../contracts/constants/leaderToolDefinitions.js';
+import { getToolMetadata } from '../../tools/ToolMetadata.js';
+import { filterToolsByModePolicy, } from '../../core/ModeToolPolicy.js';
+import { decideAutonomyAction, deriveOperationRisk, inferActionFromToolName, } from '../AutonomyDecisionEngine.js';
+/**
+ * Bughunt 扫描类工具（已下放为普通 Tool，注册在 ToolRegistry 中），
+ * 仍然只允许在 bughunt 模式下露出给 Leader / Worker。
+ *
+ * 注意：bughunt ledger 工具（set_bughunt_dag / upsert_bughunt_finding / get_bughunt_*）
+ * 是另外一组，由 BUGHUNT_TOOLS schema 定义，命中字段都在 leaderToolDefinitions.ts。
+ */
+export const BUGHUNT_SCAN_NAMES = new Set(BUGHUNT_SCAN_TOOL_NAMES);
+/**
+ * Blackboard 写入类工具 — 仅在 'blackboard' 执行模式下露出。
+ * 抽到模块级常量供 filterToolsByExecutionMode 与 worker 角色裁剪共用。
+ */
+export const BLACKBOARD_TOOL_NAMES = new Set([
+    'blackboard',
+]);
+/**
+ * Leader 视角下根据 bughunt / office / workflow 模式过滤可见工具。
+ *
+ * 行为：
+ *   - bughunt 开 → 把 BUGHUNT_TOOLS 注入到候选前，去重；scan 工具天然保留
+ *   - bughunt 关 → 候选中过滤掉所有 BUGHUNT_TOOLS schema + scan 工具名
+ *   - office 关 → 过滤掉 office 专属工具
+  *   - workflow 关 → 过滤掉 workflow 专属工具（7 件套已在核心工具里立即注册）
+  *   - Leader 保留执行类工具，按 S1/S2/S3 分层决定自办或派发
+  *   - 最终按 function.name 去重，先出先留
+ */
+export function filterLeaderTools(input) {
+    const bughuntSchemaNames = new Set(input.bughuntTools.map((t) => t.function.name));
+    const officeNames = new Set(input.officeToolNames);
+    const workflowNames = new Set(input.workflowToolNames);
+    let filtered = input.bughuntMode
+        ? [...input.bughuntTools, ...input.candidates]
+        : input.candidates.filter((t) => {
+            const name = t.function.name;
+            return !bughuntSchemaNames.has(name) && !BUGHUNT_SCAN_NAMES.has(name);
+        });
+    if (!input.officeMode) {
+        filtered = filtered.filter((t) => !officeNames.has(t.function.name));
+    }
+    if (!input.workflowMode) {
+        filtered = filtered.filter((t) => !workflowNames.has(t.function.name));
+    }
+    // 黑板关闭时剔除黑板写入工具（默认启用）
+    if (input.blackboardEnabled === false) {
+        filtered = filtered.filter((t) => !BLACKBOARD_TOOL_NAMES.has(t.function.name));
+    }
+    if (input.modes) {
+        filtered = filterToolsByModePolicy(filtered, {
+            actor: 'leader',
+            controlMode: input.modes.controlMode,
+            routeMode: input.modes.route.mode,
+            collaborationMode: input.modes.collaboration.mode,
+            activeModes: input.modes.modePlugins,
+            blackboardMode: input.modes.blackboard.mode,
+            permissionMode: input.modes.permission.mode,
+            activeTeamName: input.modes.collaboration.activeTeamName ?? null,
+            callerInTeamRoster: true,
+            callerIsTeamLeader: true,
+            getToolMetadata,
+        });
+    }
+    return dedupeToolsByName(filtered);
+}
+/** 按 function.name 去重，保留首次出现的 ToolDefinition */
+export function dedupeToolsByName(tools) {
+    const seen = new Set();
+    const out = [];
+    for (const tool of tools) {
+        const name = tool.function.name;
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        out.push(tool);
+    }
+    return out;
+}
+/**
+ * Worker / pruner 视角的执行模式工具过滤。
+ *
+ * - 'bughunt' 模式：bughunt schema 工具 + scan 工具仅此模式可见
+ * - 'blackboard' 模式：blackboard 写入工具仅此模式可见
+ * - 其余模式：上述两类工具都被剔除
+ *
+ * 注意：函数返回的工具数组是输入的子集，保留原顺序。
+ */
+export function filterToolsByExecutionMode(tools, mode, bughuntToolNames) {
+    const bughuntSet = new Set([...bughuntToolNames, ...BUGHUNT_SCAN_NAMES]);
+    return tools.filter((tool) => {
+        const name = tool.function.name;
+        if (bughuntSet.has(name) && mode !== 'bughunt')
+            return false;
+        if (BLACKBOARD_TOOL_NAMES.has(name) && mode !== 'blackboard')
+            return false;
+        return true;
+    });
+}
+export function validateDispatchAgentName(input) {
+    if (!input.activeTeam) {
+        return {
+            ok: false,
+            message: `当前没有 active team，无法 dispatch_agent @${input.agentName}。请先调用 team_manage(action="create") 建团，并把 @${input.agentName} 列入 members（agent_name 使用你要派发的 @${input.agentName} 精确名字），然后再 dispatch_agent。`,
+        };
+    }
+    if (input.roster.length === 0) {
+        return {
+            ok: false,
+            message: `Team "${input.activeTeam}" 的 roster 为空，无法 dispatch_agent @${input.agentName}。请重新 team_manage(action="create") 并把 @${input.agentName} 列入 members（名字必须与派发目标一致）。`,
+        };
+    }
+    if (input.roster.some((m) => m.name === input.agentName && m.role === 'member')) {
+        return { ok: true };
+    }
+    return {
+        ok: false,
+        message: `Agent @${input.agentName} 不在当前 active team "${input.activeTeam}" 的 members roster 中。要派发它，请先 team_manage(action="edit", edit_action="add", team_name="${input.activeTeam}", member="${input.agentName}") 把它加入 team，或改用现有成员。当前可派发成员：${formatRoster(input.roster)}`,
+    };
+}
+/** 把 roster 渲染成 `@name(role), @name(role)` 列表，给错误信息和系统注入用 */
+export function formatRoster(roster) {
+    return roster.map((m) => `@${m.name}(${m.role})`).join(', ');
+}
+/**
+ * Leader 与 Worker 均可使用的执行类工具集合。
+ * 该集合仅用于测试/策略识别；是否调用由 Leader 的 S1/S2/S3 分层提示词决定。
+ */
+export const LEADER_EXECUTION_TOOLS = new Set([
+    'shell',
+    'python_exec',
+    'structured_patch',
+    'file_create',
+]);
+export function isLeaderExecutionTool(toolName) {
+    return LEADER_EXECUTION_TOOLS.has(toolName.trim().toLowerCase());
+}
+const AUTONOMY_CONFIRMATION_TOOLS = new Set([
+    'create_task',
+    'update_task',
+    'delete_task',
+    'dispatch_agent',
+    'dispatch_batch',
+    'workflow',
+    'blackboard',
+    'terminal_control',
+    'git',
+    'request_permission_update',
+]);
+function normalizeLeaderAutonomyAction(toolName, metadata) {
+    const lower = toolName.trim().toLowerCase();
+    if (lower === 'explore')
+        return 'analyze';
+    if (lower === 'create_task')
+        return 'create_task';
+    if (lower === 'dispatch_agent' || lower === 'dispatch_batch')
+        return 'dispatch';
+    if (lower === 'workflow')
+        return 'workflow_apply';
+    if (lower === 'structured_patch' || lower === 'file_create')
+        return 'apply_change';
+    if (lower === 'shell' || lower === 'python_exec' || lower === 'terminal_control' || lower === 'git')
+        return 'run_command';
+    if (metadata.readOnly || metadata.tier === 'read')
+        return 'read';
+    if (metadata.tier === 'compute')
+        return 'analyze';
+    return inferActionFromToolName(lower);
+}
+function shouldRequireAutonomyConfirmation(toolName, decision) {
+    const lower = toolName.trim().toLowerCase();
+    if (decision.kind === 'forbid' || decision.kind === 'escalate_to_leader')
+        return true;
+    if (decision.kind === 'dry_run_only')
+        return AUTONOMY_CONFIRMATION_TOOLS.has(lower);
+    if (decision.kind !== 'require_confirmation')
+        return false;
+    if (decision.autonomyMode === 'review_first')
+        return AUTONOMY_CONFIRMATION_TOOLS.has(lower);
+    return decision.evidence.some((item) => item.kind === 'required_gate' || item.kind === 'intent_constraint' || item.kind === 'rule_permission' || (item.kind === 'rule_action' && item.value === 'critical_risk'));
+}
+function extractTargetPaths(toolName, args) {
+    if (!args)
+        return undefined;
+    const lower = toolName.trim().toLowerCase();
+    const candidates = [];
+    if (lower === 'file_create')
+        candidates.push(args.path, args.file_path, args.filename);
+    if (lower === 'structured_patch')
+        candidates.push(args.path, args.file_path, args.target, args.files);
+    const paths = candidates.flatMap((value) => Array.isArray(value) ? value : value ? [value] : [])
+        .filter((value) => typeof value === 'string' && value.trim().length > 0)
+        .map((value) => value.trim());
+    return paths.length > 0 ? Array.from(new Set(paths)) : undefined;
+}
+function extractCommand(toolName, args) {
+    if (!args)
+        return undefined;
+    const lower = toolName.trim().toLowerCase();
+    if (lower !== 'shell' && lower !== 'python_exec' && lower !== 'terminal_control' && lower !== 'git')
+        return undefined;
+    for (const key of ['command', 'cmd', 'script', 'args']) {
+        const value = args[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+        if (Array.isArray(value))
+            return value.map((item) => String(item)).join(' ').trim();
+    }
+    return undefined;
+}
+function formatAutonomyGateMessage(toolName, decision, gateKind) {
+    const evidence = decision.evidence
+        .map((item) => `${item.kind}=${item.value}${item.note ? ` (${item.note})` : ''}`)
+        .join('; ');
+    const prefix = gateKind === 'forbidden'
+        ? 'Autonomy gate blocked this tool call.'
+        : 'Autonomy gate requires explicit confirmation before this tool call.';
+    return [
+        prefix,
+        `tool=${toolName}`,
+        `decision=${decision.kind}`,
+        `intentProfile=${decision.intentProfile.primaryIntent}/${decision.intentProfile.phase}/${decision.intentProfile.scope.kind}`,
+        `autonomy=${decision.autonomyMode}`,
+        `reason=${decision.reason}`,
+        evidence ? `evidence=${evidence}` : '',
+    ].filter(Boolean).join('\n');
+}
+export function evaluateLeaderAutonomyToolGate(input) {
+    const toolName = input.toolName.trim();
+    const metadata = input.metadata ?? getToolMetadata(toolName);
+    const action = normalizeLeaderAutonomyAction(toolName, metadata);
+    const isReadOnly = metadata.readOnly === true || metadata.tier === 'read';
+    const decision = decideAutonomyAction({
+        intentProfile: input.modes.intentProfile,
+        autonomyMode: input.modes.autonomy,
+        permissionMode: input.permissionContext?.mode ?? input.modes.permission.mode,
+        leaderExecutionMode: input.modes.route.mode === 'unknown' ? undefined : input.modes.route.mode,
+        controlMode: input.modes.controlMode,
+        toolTier: metadata.tier,
+        operationRisk: deriveOperationRisk({
+            toolTier: metadata.tier,
+            readOnly: isReadOnly,
+            modifiesWorkspace: metadata.modifiesWorkspace,
+            isCritical: metadata.dangerous === true && metadata.privileged === true && (toolName === 'git' || toolName === 'terminal_control'),
+        }),
+        isReadOnly,
+        toolName,
+        action,
+        targetPaths: extractTargetPaths(toolName, input.args),
+        command: extractCommand(toolName, input.args),
+    });
+    if (decision.kind === 'allow') {
+        return { ok: true, decision };
+    }
+    if (decision.kind === 'forbid') {
+        return {
+            ok: false,
+            decision,
+            gateKind: 'forbidden',
+            message: formatAutonomyGateMessage(toolName, decision, 'forbidden'),
+        };
+    }
+    if (shouldRequireAutonomyConfirmation(toolName, decision)) {
+        return {
+            ok: false,
+            decision,
+            gateKind: 'confirmation_required',
+            message: formatAutonomyGateMessage(toolName, decision, 'confirmation_required'),
+        };
+    }
+    return { ok: true, decision };
+}
+//# sourceMappingURL=LeaderToolGates.js.map

package/dist/agents/leader/LeaderToolGates.js.map

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

package/dist/agents/leader/artifactContent.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Leader artifact content builders
+ *
+ * 纯函数：负责生成 Implementation / Review 制品的 Markdown 内容。
+ * 从 LeaderAgent 中抽出以降低主类体量，便于单测。
+ */
+import type { Task } from '../../core/TaskBoard.js';
+export interface ImplementationContentInput {
+    taskId: string;
+    agentName: string;
+    result: string;
+    workspace: string;
+    sessionId: string;
+    task: Task | undefined;
+    /**
+     * 注入用于读 scratchpad 的 IO，便于测试。
+     * 返回与该 taskId 相关的所有 scratchpad 文件 [{ file, content }]。
+     */
+    readScratchpads?: (taskId: string) => Array<{
+        file: string;
+        content: string;
+    }>;
+}
+/**
+ * 生成 Implementation 制品内容
+ */
+export declare function buildImplementationContent(input: ImplementationContentInput): string;
+export interface ReviewContentInput {
+    taskId: string;
+    verdict: 'PASS' | 'FAIL';
+    feedback: string;
+    task: Task | undefined;
+}
+/**
+ * 生成 Review 制品内容
+ */
+export declare function buildReviewContent(input: ReviewContentInput): string;
+//# sourceMappingURL=artifactContent.d.ts.map

package/dist/agents/leader/artifactContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactContent.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/artifactContent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAmCD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CA+BpF;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA6BpE"}

package/dist/agents/leader/artifactContent.js

@@ -0,0 +1,101 @@
+/**
+ * Leader artifact content builders
+ *
+ * 纯函数：负责生成 Implementation / Review 制品的 Markdown 内容。
+ * 从 LeaderAgent 中抽出以降低主类体量，便于单测。
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { Workspace } from '../../core/Workspace.js';
+const SCRATCHPAD_TAIL_BYTES = 2000;
+/**
+ * 默认实现：从 <sessionDir>/scratchpad/ 中匹配 `<taskId>.md` 或 `<taskId>_*.md`。
+ * 与 worker_task_prompt 的命名约定（buildScratchpadSection: `<taskId>_<role>.md`）保持一致。
+ */
+function defaultReadScratchpads(workspace, sessionId, taskId) {
+    try {
+        const dir = Workspace.getScratchpadDir(sessionId, workspace);
+        if (!existsSync(dir))
+            return [];
+        const entries = readdirSync(dir).filter((name) => name === `${taskId}.md` || name.startsWith(`${taskId}_`));
+        const out = [];
+        for (const file of entries) {
+            const fullPath = join(dir, file);
+            try {
+                if (!statSync(fullPath).isFile())
+                    continue;
+                out.push({ file, content: readFileSync(fullPath, 'utf-8') });
+            }
+            catch {
+                // 单个文件失败不阻塞
+            }
+        }
+        return out;
+    }
+    catch { /* expected: data source unavailable */
+        return [];
+    }
+}
+/**
+ * 生成 Implementation 制品内容
+ */
+export function buildImplementationContent(input) {
+    const { taskId, agentName, result, workspace, sessionId, task } = input;
+    const reader = input.readScratchpads
+        ?? ((id) => defaultReadScratchpads(workspace, sessionId, id));
+    const sections = [];
+    sections.push(`# Implementation Report`);
+    sections.push('');
+    sections.push(`**Task**: ${taskId} - ${task?.subject || '(unknown)'}`);
+    sections.push(`**Agent**: ${agentName}`);
+    sections.push(`**Completed**: ${new Date().toISOString()}`);
+    sections.push('');
+    sections.push('## Implementation Result');
+    sections.push(result);
+    sections.push('');
+    const scratchpads = reader(taskId);
+    for (const { file, content } of scratchpads) {
+        if (!content)
+            continue;
+        const tail = content.length > SCRATCHPAD_TAIL_BYTES
+            ? content.slice(-SCRATCHPAD_TAIL_BYTES)
+            : content;
+        sections.push(`## Agent Scratchpad — ${file}`);
+        sections.push('```');
+        sections.push(tail);
+        sections.push('```');
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * 生成 Review 制品内容
+ */
+export function buildReviewContent(input) {
+    const { taskId, verdict, feedback, task } = input;
+    const sections = [];
+    sections.push(`# Review Report`);
+    sections.push('');
+    sections.push(`**Task**: ${taskId} - ${task?.subject || '(unknown)'}`);
+    sections.push(`**Verdict**: ${verdict}`);
+    sections.push(`**Reviewed**: ${new Date().toISOString()}`);
+    sections.push('');
+    sections.push('## Review Feedback');
+    sections.push(feedback);
+    sections.push('');
+    if (verdict === 'PASS') {
+        sections.push('## Acceptance Criteria');
+        sections.push('- [x] Implementation complete');
+        sections.push('- [x] Tests passing');
+        sections.push('- [x] Documentation updated');
+    }
+    else {
+        sections.push('## Required Changes');
+        sections.push('- [ ] Address review feedback');
+        sections.push('- [ ] Re-run tests');
+        sections.push('- [ ] Update implementation');
+    }
+    sections.push('');
+    return sections.join('\n');
+}
+//# sourceMappingURL=artifactContent.js.map

package/dist/agents/leader/artifactContent.js.map

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

package/dist/agents/leader/builtinRoles.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Leader builtin role builder
+ *
+ * 抽离 registerBuiltinRoles 的装配逻辑：
+ * - 11 个预置角色（research/coding/verify/...）的 prompt map
+ * - 可选的 claude_coding / codex_coding 外部 Agent 角色
+ *
+ * LeaderAgent 只负责把最终 role 数组逐个注册到 RoleRegistry。
+ */
+import type { AgentRole } from '../RoleRegistry.js';
+import { type BuiltinRolePromptMap } from '../RoleCapabilityModel.js';
+import type { PromptLocale } from '../prompts/i18n/catalog.js';
+export interface ExternalAgentAvailabilityLite {
+    claude: {
+        installed: boolean;
+    };
+    codex: {
+        installed: boolean;
+    };
+}
+export interface BuiltinRoleDescriptions {
+    claudeCoding: string;
+    codexCoding: string;
+}
+export interface BuiltinRoleInput {
+    prompts: BuiltinRolePromptMap;
+    /** 提供给外部 Agent 角色的 systemPrompt（按 locale 映射，通常就是 CODING_SYSTEM_PROMPT_BY_LOCALE） */
+    externalCodingPrompt: Record<PromptLocale, string>;
+    availability: ExternalAgentAvailabilityLite;
+    descriptions: BuiltinRoleDescriptions;
+}
+/**
+ * 组装 Leader 应当注册的全部内置角色（顺序：预设 → claude_coding → codex_coding）
+ */
+export declare function collectBuiltinRoles(input: BuiltinRoleInput): AgentRole[];
+//# sourceMappingURL=builtinRoles.d.ts.map

package/dist/agents/leader/builtinRoles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinRoles.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/builtinRoles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,KAAK,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACnD,YAAY,EAAE,6BAA6B,CAAC;IAC5C,YAAY,EAAE,uBAAuB,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,EAAE,CA6BxE"}