@lingxiao-office/sdk 1.0.0

package/dist/agents/leader/builtinRoles.js

@@ -0,0 +1,41 @@
+/**
+ * Leader builtin role builder
+ *
+ * 抽离 registerBuiltinRoles 的装配逻辑：
+ * - 11 个预置角色（research/coding/verify/...）的 prompt map
+ * - 可选的 claude_coding / codex_coding 外部 Agent 角色
+ *
+ * LeaderAgent 只负责把最终 role 数组逐个注册到 RoleRegistry。
+ */
+import { buildBuiltinRoles, } from '../RoleCapabilityModel.js';
+/**
+ * 组装 Leader 应当注册的全部内置角色（顺序：预设 → claude_coding → codex_coding）
+ */
+export function collectBuiltinRoles(input) {
+    const roles = [...buildBuiltinRoles(input.prompts)];
+    if (input.availability.claude.installed) {
+        roles.push({
+            name: 'claude_coding',
+            description: input.descriptions.claudeCoding,
+            systemPrompt: input.externalCodingPrompt.zh,
+            systemPromptByLocale: input.externalCodingPrompt,
+            tools: [],
+            createdBy: 'system',
+            worker_backend: 'claude',
+        });
+    }
+    if (input.availability.codex.installed) {
+        roles.push({
+            name: 'codex_coding',
+            description: input.descriptions.codexCoding,
+            systemPrompt: input.externalCodingPrompt.zh,
+            systemPromptByLocale: input.externalCodingPrompt,
+            tools: [],
+            createdBy: 'system',
+            worker_backend: 'codex',
+            worker_config: { wire_api: 'chat' },
+        });
+    }
+    return roles;
+}
+//# sourceMappingURL=builtinRoles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtinRoles.js","sourceRoot":"","sources":["../../../src/agents/leader/builtinRoles.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,iBAAiB,GAElB,MAAM,2BAA2B,CAAC;AAqBnC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,MAAM,KAAK,GAAgB,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjE,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,YAAY;YAC5C,YAAY,EAAE,KAAK,CAAC,oBAAoB,CAAC,EAAE;YAC3C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,QAAQ;YACnB,cAAc,EAAE,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW;YAC3C,YAAY,EAAE,KAAK,CAAC,oBAAoB,CAAC,EAAE;YAC3C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,QAAQ;YACnB,cAAc,EAAE,OAAO;YACvB,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Leader model context limit resolver
+ *
+ * 把 Leader 中两处重复的 "ProviderRegistry > ModelsDevRegistry > fallback"
+ * 优先级解析逻辑抽出为纯函数。便于单测且消除复制。
+ */
+export interface ResolveContextLimitOptions {
+    /** ProviderRegistry 中的 contextWindow（来自用户配置） */
+    providerCtx: number | null | undefined;
+    /** ModelsDevRegistry 中的 contextLimit（来自社区数据） */
+    modelInfoCtx: number | null | undefined;
+    /** settings.json 中的 llm.context_max_tokens */
+    configuredCtx?: number | null | undefined;
+    /** 兜底常量（仅 init 期需要） */
+    fallback?: number;
+}
+/**
+ * 解析模型 context window：
+ * 1. providerCtx > 0 → 直接采用
+ * 2. modelInfoCtx > 0 → 采用
+ * 3. configuredCtx > 0 → 采用 settings.json 中的 llm.context_max_tokens
+ * 4. 都缺失 → 返回 fallback（默认 undefined，让上游决定）
+ */
+export declare function resolveModelContextLimit(options: ResolveContextLimitOptions): number | undefined;
+//# sourceMappingURL=contextLimit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextLimit.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/contextLimit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,0BAA0B;IACzC,gDAAgD;IAChD,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,0BAA0B,GAClC,MAAM,GAAG,SAAS,CAMpB"}

package/dist/agents/leader/contextLimit.js

@@ -0,0 +1,24 @@
+/**
+ * Leader model context limit resolver
+ *
+ * 把 Leader 中两处重复的 "ProviderRegistry > ModelsDevRegistry > fallback"
+ * 优先级解析逻辑抽出为纯函数。便于单测且消除复制。
+ */
+/**
+ * 解析模型 context window：
+ * 1. providerCtx > 0 → 直接采用
+ * 2. modelInfoCtx > 0 → 采用
+ * 3. configuredCtx > 0 → 采用 settings.json 中的 llm.context_max_tokens
+ * 4. 都缺失 → 返回 fallback（默认 undefined，让上游决定）
+ */
+export function resolveModelContextLimit(options) {
+    const { providerCtx, modelInfoCtx, configuredCtx, fallback } = options;
+    if (typeof providerCtx === 'number' && providerCtx > 0)
+        return providerCtx;
+    if (typeof modelInfoCtx === 'number' && modelInfoCtx > 0)
+        return modelInfoCtx;
+    if (typeof configuredCtx === 'number' && configuredCtx > 0)
+        return configuredCtx;
+    return fallback;
+}
+//# sourceMappingURL=contextLimit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextLimit.js","sourceRoot":"","sources":["../../../src/agents/leader/contextLimit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAmC;IAEnC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACvE,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC;IAC3E,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IAC9E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IACjF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Leader context memory helpers
+ *
+ * appendContextMemoryIfChanged 的纯逻辑：
+ * - 计算 memory items 指纹（用于「上下文记忆是否变化」去重）
+ *
+ * 历史上有 buildMemoryQuery / selectOpenTasksForMemory 用于 LLM 语义重排的查询，但该重排从未被
+ * 任何调用方启用、属死代码且引入非确定性，已随 ContextMemoryIndex 的语义重排一并移除。
+ */
+export interface MemoryItemLite {
+    id: string;
+    score: number;
+    timestamp?: number;
+}
+/**
+ * 计算 memory items 指纹：id:score:timestamp 用 '|' 串联。空数组返回 ''。
+ */
+export declare function buildMemoryItemsFingerprint(items: MemoryItemLite[]): string;
+//# sourceMappingURL=contextMemory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextMemory.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/contextMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAI3E"}

package/dist/agents/leader/contextMemory.js

@@ -0,0 +1,18 @@
+/**
+ * Leader context memory helpers
+ *
+ * appendContextMemoryIfChanged 的纯逻辑：
+ * - 计算 memory items 指纹（用于「上下文记忆是否变化」去重）
+ *
+ * 历史上有 buildMemoryQuery / selectOpenTasksForMemory 用于 LLM 语义重排的查询，但该重排从未被
+ * 任何调用方启用、属死代码且引入非确定性，已随 ContextMemoryIndex 的语义重排一并移除。
+ */
+/**
+ * 计算 memory items 指纹：id:score:timestamp 用 '|' 串联。空数组返回 ''。
+ */
+export function buildMemoryItemsFingerprint(items) {
+    return items
+        .map((item) => `${item.id}:${item.score}:${item.timestamp || 0}`)
+        .join('|');
+}
+//# sourceMappingURL=contextMemory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextMemory.js","sourceRoot":"","sources":["../../../src/agents/leader/contextMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAuB;IACjE,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;SAChE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Leader conversation buffer trimmer
+ *
+ * 策略：剥离旧图片 base64 payload 和压缩旧 tool results，不删任何消息。
+ * - 旧图片按 image_history_retain_rounds 剥离 base64 payload，保留文字部分
+ * - 旧 tool results 按 tool_result_retain_rounds 压缩为占位符，保留元信息
+ * - 消息裁剪（含 tool 消息）统一由 compact 路径负责，此处不再做条数裁剪
+ */
+import type { ChatMessage } from '../../llm/types.js';
+/**
+ * 给消息打默认 timestamp（秒，浮点）：仅在缺失时填充
+ */
+export declare function ensureMessageTimestamp(msg: ChatMessage, nowMs?: number): ChatMessage;
+/**
+ * 对 conversation 做旧图片剥离和 tool result 压缩，不删任何消息。
+ *
+ * 行为：
+ * - 旧图片按配置轮数剥离 base64 payload，保留文字部分
+ * - 旧 tool results 按配置轮数压缩为占位符，保留元信息
+ * - 不做条数裁剪（tool 消息也不删）；消息裁剪统一由 compact 路径负责
+ */
+export declare function trimConversationBuffer(conversation: ChatMessage[], _maxMessages?: number, _maxBytes?: number): ChatMessage[];
+//# sourceMappingURL=conversationBuffer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversationBuffer.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/conversationBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,SAAa,GAAG,WAAW,CAKxF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,WAAW,EAAE,EAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,EAAE,CAgBf"}

package/dist/agents/leader/conversationBuffer.js

@@ -0,0 +1,42 @@
+/**
+ * Leader conversation buffer trimmer
+ *
+ * 策略：剥离旧图片 base64 payload 和压缩旧 tool results，不删任何消息。
+ * - 旧图片按 image_history_retain_rounds 剥离 base64 payload，保留文字部分
+ * - 旧 tool results 按 tool_result_retain_rounds 压缩为占位符，保留元信息
+ * - 消息裁剪（含 tool 消息）统一由 compact 路径负责，此处不再做条数裁剪
+ */
+import { config as runtimeConfig } from '../../config.js';
+import { stripOldImageParts, compactOldToolResults, } from '../messageMemoryBudget.js';
+/**
+ * 给消息打默认 timestamp（秒，浮点）：仅在缺失时填充
+ */
+export function ensureMessageTimestamp(msg, nowMs = Date.now()) {
+    if (!msg.timestamp) {
+        msg.timestamp = nowMs / 1000;
+    }
+    return msg;
+}
+/**
+ * 对 conversation 做旧图片剥离和 tool result 压缩，不删任何消息。
+ *
+ * 行为：
+ * - 旧图片按配置轮数剥离 base64 payload，保留文字部分
+ * - 旧 tool results 按配置轮数压缩为占位符，保留元信息
+ * - 不做条数裁剪（tool 消息也不删）；消息裁剪统一由 compact 路径负责
+ */
+export function trimConversationBuffer(conversation, _maxMessages, _maxBytes) {
+    const protectedCount = Math.min(2, conversation.length);
+    // 1. 剥离旧图片 base64
+    let trimmed = stripOldImageParts(conversation, {
+        retainImageMessages: runtimeConfig.advanced.image_history_retain_rounds,
+        protectedCount,
+    });
+    // 2. 压缩旧 tool results
+    trimmed = compactOldToolResults(trimmed, {
+        retainRecentTurns: runtimeConfig.advanced.tool_result_retain_rounds,
+        protectedCount,
+    });
+    return trimmed;
+}
+//# sourceMappingURL=conversationBuffer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversationBuffer.js","sourceRoot":"","sources":["../../../src/agents/leader/conversationBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAgB,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;IACzE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,GAAG,CAAC,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAA2B,EAC3B,YAAqB,EACrB,SAAkB;IAElB,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExD,kBAAkB;IAClB,IAAI,OAAO,GAAG,kBAAkB,CAAC,YAAY,EAAE;QAC7C,mBAAmB,EAAE,aAAa,CAAC,QAAQ,CAAC,2BAA2B;QACvE,cAAc;KACf,CAAC,CAAC;IAEH,sBAAsB;IACtB,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE;QACvC,iBAAiB,EAAE,aAAa,CAAC,QAAQ,CAAC,yBAAyB;QACnE,cAAc;KACf,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Leader dynamic context builder
+ *
+ * 抽离 Leader 的动态上下文装配：直觉快照 + 长期记忆索引 + 模式协议。
+ * 作为独立 system 消息注入，以避免动态内容污染 Anthropic cache 的稳定核心。
+ */
+import { type ContextManifestSection } from '../../core/ContextManifest.js';
+export interface DynamicContextInput {
+    sessionId: string;
+    /** 读取 intuition 快照（可能失败，返回 null 即忽略） */
+    readIntuitionPrompt: () => string | null;
+    /** 读取记忆索引 markdown（返回非空字符串才注入） */
+    readMemoryIndex: () => string | null;
+    /** 额外动态协议块，如 Office 模式协议 */
+    sections?: ContextManifestSection[];
+}
+/**
+ * 组合动态上下文为统一 Context Manifest：
+ * - 两者都缺省返回 null（调用方应跳过注入）
+ * - 有任一动态块时统一输出 Context Manifest，避免多套上下文标题并存
+ */
+export declare function buildDynamicContext(input: DynamicContextInput): string | null;
+//# sourceMappingURL=dynamicContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicContext.d.ts","sourceRoot":"","sources":["../../../src/agents/leader/dynamicContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,mBAAmB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACzC,kCAAkC;IAClC,eAAe,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACrC,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAuC7E"}

package/dist/agents/leader/dynamicContext.js

@@ -0,0 +1,51 @@
+/**
+ * Leader dynamic context builder
+ *
+ * 抽离 Leader 的动态上下文装配：直觉快照 + 长期记忆索引 + 模式协议。
+ * 作为独立 system 消息注入，以避免动态内容污染 Anthropic cache 的稳定核心。
+ */
+import { renderContextManifest, } from '../../core/ContextManifest.js';
+/**
+ * 组合动态上下文为统一 Context Manifest：
+ * - 两者都缺省返回 null（调用方应跳过注入）
+ * - 有任一动态块时统一输出 Context Manifest，避免多套上下文标题并存
+ */
+export function buildDynamicContext(input) {
+    let intuition = null;
+    let memory = null;
+    try {
+        const value = input.readIntuitionPrompt();
+        if (value?.trim()) {
+            intuition = value.trim();
+        }
+    }
+    catch {
+        /* intuition context is optional */
+    }
+    try {
+        const value = input.readMemoryIndex();
+        if (value?.trim()) {
+            memory = value.trim();
+        }
+    }
+    catch {
+        /* memory not available */
+    }
+    const sections = (input.sections ?? [])
+        .filter((section) => section.title.trim() && section.content.trim());
+    if (!intuition && !memory && sections.length === 0) {
+        return null;
+    }
+    return renderContextManifest({
+        scope: 'leader',
+        // leader_init 槽：init/resume 一次性装配的动态上下文（直觉/记忆/mission/contract）。
+        // 带 slot 才能被 SystemMessageSlot 单槽 in-place 管理，resume 从 DB 重建带回的旧
+        // leader_init 残留也能被 collapseSystemSlots 收敛（每会话一条，不堆积）。
+        slot: 'leader_init',
+        sessionId: input.sessionId,
+        intuition,
+        persistentMemoryIndex: memory,
+        sections,
+    });
+}
+//# sourceMappingURL=dynamicContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicContext.js","sourceRoot":"","sources":["../../../src/agents/leader/dynamicContext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AAYvC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA0B;IAC5D,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC1C,IAAI,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YAClB,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YAClB,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;SACpC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,qBAAqB,CAAC;QAC3B,KAAK,EAAE,QAAQ;QACf,iEAAiE;QACjE,iEAAiE;QACjE,uDAAuD;QACvD,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS;QACT,qBAAqB,EAAE,MAAM;QAC7B,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,154 @@
+/**
+ * Leader P0 message parsing helpers
+ *
+ * 抽出 handleLeaderP0Message 内部的纯解析逻辑：
+ * - 判定是否为应直接忽略的 user_intervention
+ * - 解析 task_complete / task_failed 消息为结构化字段
+ * - 在已存在的 pending signal 中追加 result（去重）
+ *
+ * 同时提供 LeaderP0Handler — 把 LeaderAgent 内联的 P0 消息处理函数
+ * （权限直送 / completion 入队 / 紧急中断）整体搬入，原 LeaderAgent
+ * 方法改为薄委托。行为/优先级/时序保持不变。
+ */
+import { type WorkerContractComplianceProof } from '../../core/AgentProtocol.js';
+import type { EventMap, EventEmitter } from '../../core/EventEmitter.js';
+import type { LeaderPermissionManager } from '../LeaderPermissionManager.js';
+export interface P0MessageLite {
+    priority?: number;
+    to?: string;
+    from?: unknown;
+    type?: string;
+    payload?: unknown;
+}
+/**
+ * 该 P0 消息是否应该被 leader handler 处理：
+ * - priority 必须为 0
+ * - to 必须等于 leaderBusName
+ */
+export declare function shouldHandleP0Message(data: P0MessageLite, leaderBusName: string): boolean;
+/**
+ * 是否是来自用户的 user_intervention（按既有行为：直接忽略，由其他通道处理）
+ */
+export declare function isUserInterventionMessage(data: P0MessageLite): boolean;
+export interface WorkerArtifactTraceLite {
+    files_created?: string[];
+    files_modified?: string[];
+    commands_run?: string[];
+}
+export interface WorkerVerificationLite {
+    kind: string;
+    detail: string;
+    passed?: boolean;
+}
+export interface ParsedTaskTermination {
+    taskId: string;
+    taskRunGeneration?: number;
+    exitReason: 'completed' | 'failed';
+    result: string;
+    summary?: string;
+    verdict?: 'PASS' | 'FAIL' | 'BLOCKED';
+    artifacts?: WorkerArtifactTraceLite;
+    verification?: WorkerVerificationLite[];
+    next_steps?: string[];
+    blocked_by_discovery?: string[];
+    needs_leader_coordination?: boolean;
+    evidence_refs?: string[];
+    contract_compliance?: WorkerContractComplianceProof;
+    toolTrace?: WorkerArtifactTraceLite;
+}
+/**
+ * 解析 task_complete / task_failed 的 payload，返回结构化字段。
+ * - taskId 缺失则返回 null
+ * - completed → 取 payload.result；failed → 取 payload.error
+ */
+export declare function parseTaskTermination(data: P0MessageLite): ParsedTaskTermination | null;
+export interface CompletionSignal {
+    agentName: string;
+    taskId: string;
+    taskRunGeneration?: number;
+    status: 'terminal';
+    exitReason: 'completed' | 'failed';
+    result?: string;
+    summary?: string;
+    verdict?: 'PASS' | 'FAIL' | 'BLOCKED';
+    artifacts?: WorkerArtifactTraceLite;
+    verification?: WorkerVerificationLite[];
+    next_steps?: string[];
+    blocked_by_discovery?: string[];
+    needs_leader_coordination?: boolean;
+    evidence_refs?: string[];
+    contract_compliance?: WorkerContractComplianceProof;
+    toolTrace?: WorkerArtifactTraceLite;
+}
+/**
+ * 把新的 termination 合并到 pending signal 列表（去重 + 补全结构化 completion 字段）。
+ * 直接修改传入数组（与 LeaderAgent 既有语义一致）。
+ */
+export declare function mergeAgentCompletionSignal(pending: CompletionSignal[], agentName: string, parsed: ParsedTaskTermination): void;
+/**
+ * P0 消息分派决策（纯函数，不持状态）。
+ *
+ * 关键设计：**只有用户主动消息才硬中断当前 LLM 调用**。
+ *
+ * 历史问题：旧逻辑在 task_complete / task_failed 路径上一律调
+ * interruptCurrentRound('agent_completion')，把模型正在生成的长 tool_input
+ * 整轮 abort。表现为"工具参数没生成完，没触发 max_tokens，却莫名其妙重新思考"。
+ *
+ * 新策略：
+ * - task_complete / task_failed → 'queue_completion'：仅入队 pending signal，
+ *   等当前 LLM 轮自然结束。LeaderThinkingEngine 在每轮结束后已检查
+ *   pendingSignals.length>0 并 break。
+ * - 其他非 user_intervention 的 P0 → 'interrupt'：保留旧行为。
+ * - 不应处理 / 已被消费的消息 → 'ignore'。
+ */
+export type LeaderP0Action = {
+    kind: 'ignore';
+} | {
+    kind: 'queue_completion';
+    sender: string;
+    parsed: ParsedTaskTermination;
+} | {
+    kind: 'interrupt';
+    sender: string;
+};
+export declare function decideLeaderP0Action(data: P0MessageLite, leaderBusName: string): LeaderP0Action;
+/**
+ * LeaderP0Handler — LeaderAgent 内联 P0 消息处理的搬迁载体。
+ *
+ * 行为契约（与原 handleLeaderP0Message 完全一致，仅搬位置不改逻辑）：
+ * - permission_request 直送用户审批（fast-path），不进 completion/interrupt 分支
+ * - task_complete / task_failed → queue_completion：仅入队，不 abort 当前 LLM
+ *   （关键：旧逻辑 abort 会丢弃模型正在生成的 partial tool_input，已废弃）
+ * - 其他非 user_intervention 的 P0 → interrupt：保留旧行为
+ */
+export interface LeaderP0HandlerDeps {
+    sessionId: string;
+    leaderBusName: string;
+    emitter: EventEmitter;
+    permManager: LeaderPermissionManager;
+    /** pending completion 信号队列（handler 直接修改，与原 LA 语义一致）。
+     *  注意：主循环会用 `.filter(...)` 重新赋值该数组，所以必须走 getter 取活引用。 */
+    pendingAgentCompletionSignals: () => CompletionSignal[];
+    /** 是否处于 eternal 模式（影响权限请求处理） */
+    isEternalMode: () => boolean;
+    /** 是否正忙于一轮 LLM（决定是否中断） */
+    isBusy: () => boolean;
+    /** Leader 是否在等待用户（permission/completion 路径都需据此刷新状态文案） */
+    waitingForUser: () => boolean;
+    /** 设置委派模式文案（permission fast-path 用） */
+    setDelegateMode: (reason: string) => void;
+    /** 软性清掉 waitingForUser（completion 路径用） */
+    clearSoftWaitingForUser: (reason: string) => Promise<boolean>;
+    /** 中断当前 LLM round（紧急消息路径用） */
+    interruptCurrentRound: (reason: 'user_input') => void;
+    /** 设置 userInterruptPending 标志（completion 入队后清零） */
+    setUserInterruptPending: (value: boolean) => void;
+    /** 从 busName 还原 worker 名（permission fast-path 富化用） */
+    stripSessionPrefix: (sessionId: string, agentName: string) => string;
+}
+export declare class LeaderP0Handler {
+    private readonly deps;
+    constructor(deps: LeaderP0HandlerDeps);
+    handle(data: EventMap['message:bus:priority']): void;
+}
+//# sourceMappingURL=p0Message.d.ts.map

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

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