@lingxiao-office/sdk 1.0.0

package/dist/agents/runtime/AgentCore.d.ts

@@ -0,0 +1,13 @@
+import { type ReasoningLoopStep, type ReasoningLoopTerminationReason } from './ReasoningLoopDriver.js';
+export interface AgentCoreRunOptions<T> {
+    maxRounds: number;
+    maxRuntimeMinutes: number;
+    shouldStop?: () => boolean;
+    onStopped?: () => T | Promise<T>;
+    onBoundReached: (reason: ReasoningLoopTerminationReason) => ReasoningLoopStep<T> | Promise<ReasoningLoopStep<T>>;
+    runRound: (roundNumber: number) => ReasoningLoopStep<T> | Promise<ReasoningLoopStep<T>>;
+}
+export declare class AgentCore<T = string> {
+    run(options: AgentCoreRunOptions<T>): Promise<T | undefined>;
+}
+//# sourceMappingURL=AgentCore.d.ts.map

package/dist/agents/runtime/AgentCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCore.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/AgentCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACpC,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC,cAAc,EAAE,CACd,MAAM,EAAE,8BAA8B,KACnC,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;CACzF;AAED,qBAAa,SAAS,CAAC,CAAC,GAAG,MAAM;IACzB,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAgBnE"}

package/dist/agents/runtime/AgentCore.js

@@ -0,0 +1,19 @@
+import { runBoundedReasoningLoop, } from './ReasoningLoopDriver.js';
+export class AgentCore {
+    async run(options) {
+        const result = await runBoundedReasoningLoop({
+            maxRounds: options.maxRounds,
+            maxRuntimeMinutes: options.maxRuntimeMinutes,
+            onBoundReached: async (reason) => options.onBoundReached(reason),
+            runRound: async (roundNumber) => {
+                if (options.shouldStop?.()) {
+                    const stoppedResult = options.onStopped ? await options.onStopped() : undefined;
+                    return { type: 'break', result: stoppedResult };
+                }
+                return options.runRound(roundNumber);
+            },
+        });
+        return result.result;
+    }
+}
+//# sourceMappingURL=AgentCore.js.map

package/dist/agents/runtime/AgentCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCore.js","sourceRoot":"","sources":["../../../src/agents/runtime/AgentCore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAGxB,MAAM,0BAA0B,CAAC;AAalC,MAAM,OAAO,SAAS;IACpB,KAAK,CAAC,GAAG,CAAC,OAA+B;QACvC,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAI;YAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;YAC5C,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC;YAChE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;gBAC9B,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,EAAE,CAAC;oBAC3B,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAChF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;gBAClD,CAAC;gBACD,OAAO,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACvC,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/agents/runtime/AgentInboxParsers.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Agent Inbox 协议纯函数：消息解析 + 内容格式化。
+ *
+ * 历史上 BaseAgentRuntime.ts 里散落了 4 个解析消息类型的方法（isStopMessage /
+ * isPauseMessage / isInterveneMessage / parseIntervention）和一段 ~30 行的
+ * "把入站消息渲染成对话内容" 的内联代码，全是无状态的纯逻辑。这里把它们抽出
+ * 成独立模块，让 BaseAgent.checkInbox / checkInboxForIntervention 等只负责
+ * 状态变更，解析职责单点收敛。
+ *
+ * 不抽 checkInbox / checkInboxForResume / checkInboxForInterventionConfirm
+ * 自身：它们要 mutate this.stopped / this.paused / this.intervene / 调用
+ * this.addMessage / this.logEvent / this.emitter，与 BaseAgent 的运行时状态
+ * 紧耦合，强行抽出会引入回调注入大杂烩，得不偿失。
+ */
+import { type MessageContentPart } from '../../llm/types.js';
+export interface InboxRawMessage {
+    type: string;
+    payload: unknown;
+    from: string;
+}
+export interface ParsedIntervention {
+    type: 'retry_llm' | 'swap_model' | 'nudge' | 'compact_context';
+    param?: string;
+}
+/** 是否是 Leader/外部强制停止信号 */
+export declare function isStopMessage(msg: InboxRawMessage): boolean;
+/** 是否是暂停命令 */
+export declare function isPauseMessage(msg: InboxRawMessage): boolean;
+/** 是否是干预指令；返回干预正文，没有则返回 null */
+export declare function parseInterveneMessage(msg: InboxRawMessage): string | null;
+/** 解析 [INTERVENTION:type] 控制指令；非控制返回 null */
+export declare function parseInterventionControl(msg: InboxRawMessage): ParsedIntervention | null;
+/** 是否是 [RESUME] / 继续 / 恢复 等恢复信号 */
+export declare function isResumeMessage(msg: InboxRawMessage): boolean;
+/** 是否是干预确认信号 */
+export declare function isInterventionConfirmMessage(msg: InboxRawMessage): boolean;
+/**
+ * 把入站消息渲染成 Agent 对话内容。
+ * - team protocol 消息：`[来自X的team消息][type] content`
+ * - ContentPart 数组（多模态）：在第一条 text 前缀加发送者标签
+ * - 纯文本：`[来自X的消息]: content`
+ */
+export declare function formatIncomingContent(msg: InboxRawMessage): string | MessageContentPart[];
+/** 解析消息后用于 UI/日志展示的发送方标签 */
+export declare function resolveSenderLabel(msg: InboxRawMessage): string;
+//# sourceMappingURL=AgentInboxParsers.d.ts.map

package/dist/agents/runtime/AgentInboxParsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInboxParsers.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/AgentInboxParsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,iBAAiB,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0BAA0B;AAC1B,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAkB3D;AAED,cAAc;AACd,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAQ5D;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAczE;AAED,6CAA6C;AAC7C,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,GAAG,IAAI,CAmCxF;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAG7D;AAED,gBAAgB;AAChB,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,GACnB,MAAM,GAAG,kBAAkB,EAAE,CAmC/B;AAED,4BAA4B;AAC5B,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAI/D"}

package/dist/agents/runtime/AgentInboxParsers.js

@@ -0,0 +1,152 @@
+/**
+ * Agent Inbox 协议纯函数：消息解析 + 内容格式化。
+ *
+ * 历史上 BaseAgentRuntime.ts 里散落了 4 个解析消息类型的方法（isStopMessage /
+ * isPauseMessage / isInterveneMessage / parseIntervention）和一段 ~30 行的
+ * "把入站消息渲染成对话内容" 的内联代码，全是无状态的纯逻辑。这里把它们抽出
+ * 成独立模块，让 BaseAgent.checkInbox / checkInboxForIntervention 等只负责
+ * 状态变更，解析职责单点收敛。
+ *
+ * 不抽 checkInbox / checkInboxForResume / checkInboxForInterventionConfirm
+ * 自身：它们要 mutate this.stopped / this.paused / this.intervene / 调用
+ * this.addMessage / this.logEvent / this.emitter，与 BaseAgent 的运行时状态
+ * 紧耦合，强行抽出会引入回调注入大杂烩，得不偿失。
+ */
+import { contentToPlainText, isContentPartArray, } from '../../llm/types.js';
+import { parseProtocolPayload } from '../../core/TeamProtocol.js';
+/** 是否是 Leader/外部强制停止信号 */
+export function isStopMessage(msg) {
+    if (msg.type === 'force_terminate')
+        return true;
+    if (msg.type !== 'message' && msg.type !== 'user_intervention')
+        return false;
+    if (typeof msg.payload === 'object' && msg.payload !== null) {
+        const payload = msg.payload;
+        if (payload.kind === 'stop' ||
+            payload.type === 'stop' ||
+            payload.command === 'stop' ||
+            payload.action === 'stop') {
+            return true;
+        }
+    }
+    const content = contentToPlainText(msg.payload).trim();
+    return /^(?:stop|停止|终止|取消)$/iu.test(content);
+}
+/** 是否是暂停命令 */
+export function isPauseMessage(msg) {
+    if (msg.type === 'pause')
+        return true;
+    if (typeof msg.payload === 'object' && msg.payload !== null) {
+        const payload = msg.payload;
+        if (payload.kind === 'pause' || payload.action === 'pause')
+            return true;
+    }
+    const content = contentToPlainText(msg.payload).trim();
+    return /^(?:pause|暂停)$/iu.test(content);
+}
+/** 是否是干预指令；返回干预正文，没有则返回 null */
+export function parseInterveneMessage(msg) {
+    if (msg.type === 'intervene') {
+        return contentToPlainText(msg.payload).trim();
+    }
+    if (typeof msg.payload === 'object' && msg.payload !== null) {
+        const payload = msg.payload;
+        if (payload.kind === 'intervene' && typeof payload.instruction === 'string') {
+            return payload.instruction.trim();
+        }
+    }
+    const content = contentToPlainText(msg.payload).trim();
+    // 干预消息格式: [INTERVENE: 指令内容]
+    const match = content.match(/^\[INTERVENE:\s*(.+)\]$/i);
+    return match ? match[1].trim() : null;
+}
+/** 解析 [INTERVENTION:type] 控制指令；非控制返回 null */
+export function parseInterventionControl(msg) {
+    if (msg.type === 'control' && msg.payload && typeof msg.payload === 'object') {
+        const payload = msg.payload;
+        const action = String(payload.action || '');
+        if (action === 'nudge' || action === 'redirect') {
+            return {
+                type: 'nudge',
+                param: contentToPlainText(payload.message || payload.reason || '请检查当前进展并换一种策略继续。'),
+            };
+        }
+        if (action === 'retry_llm') {
+            return { type: 'retry_llm' };
+        }
+        if (action === 'swap_model') {
+            return { type: 'swap_model', param: contentToPlainText(payload.model || payload.newModel || '') };
+        }
+        if (action === 'compact_context') {
+            return { type: 'compact_context' };
+        }
+    }
+    const content = contentToPlainText(msg.payload).trim();
+    const match = content.match(/^\[INTERVENTION:(\w+)(?::([^\]]+))?\]\s*([\s\S]*)$/);
+    if (!match)
+        return null;
+    const interventionType = match[1];
+    if (!['retry_llm', 'swap_model', 'nudge', 'compact_context'].includes(interventionType))
+        return null;
+    const bracketParam = match[2]?.trim();
+    const trailingParam = match[3]?.trim();
+    return { type: interventionType, param: bracketParam || trailingParam };
+}
+/** 是否是 [RESUME] / 继续 / 恢复 等恢复信号 */
+export function isResumeMessage(msg) {
+    const content = contentToPlainText(msg.payload).trim();
+    return content === '[RESUME]' || content === '继续' || content === '恢复';
+}
+/** 是否是干预确认信号 */
+export function isInterventionConfirmMessage(msg) {
+    const content = contentToPlainText(msg.payload).trim();
+    return content === '[CONTINUE]' || content === '继续' || content === '确认继续';
+}
+/**
+ * 把入站消息渲染成 Agent 对话内容。
+ * - team protocol 消息：`[来自X的team消息][type] content`
+ * - ContentPart 数组（多模态）：在第一条 text 前缀加发送者标签
+ * - 纯文本：`[来自X的消息]: content`
+ */
+export function formatIncomingContent(msg) {
+    const teamProtocolMessage = parseProtocolPayload(msg.payload);
+    const senderLabel = teamProtocolMessage?.from
+        ?? (msg.from === 'user' ? '用户' : msg.from || '外部');
+    if (teamProtocolMessage) {
+        return `[来自${senderLabel}的team消息][${teamProtocolMessage.type}] ${teamProtocolMessage.content}`;
+    }
+    if (isContentPartArray(msg.payload)) {
+        const next = msg.payload.map((part) => {
+            if (part.type === 'text')
+                return { type: 'text', text: part.text };
+            if (part.type === 'image_url') {
+                return {
+                    type: 'image_url',
+                    image_url: { ...part.image_url },
+                };
+            }
+            return { ...part };
+        });
+        const firstTextIndex = next.findIndex((part) => part.type === 'text');
+        if (firstTextIndex >= 0) {
+            const firstText = next[firstTextIndex];
+            next[firstTextIndex] = {
+                type: 'text',
+                text: `[来自${msg.from}的消息]: ${firstText.text}`,
+            };
+        }
+        else {
+            next.unshift({ type: 'text', text: `[来自${msg.from}的消息]` });
+        }
+        return next;
+    }
+    const content = contentToPlainText(msg.payload);
+    return `[来自${senderLabel}的消息]: ${content}`;
+}
+/** 解析消息后用于 UI/日志展示的发送方标签 */
+export function resolveSenderLabel(msg) {
+    const teamProtocolMessage = parseProtocolPayload(msg.payload);
+    return teamProtocolMessage?.from
+        ?? (msg.from === 'user' ? '用户' : msg.from || '外部');
+}
+//# sourceMappingURL=AgentInboxParsers.js.map

package/dist/agents/runtime/AgentInboxParsers.js.map

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

package/dist/agents/runtime/AgentRuntimeState.d.ts

@@ -0,0 +1,36 @@
+import type { Task } from '../BaseAgentRuntime.js';
+import type { ContractAllowedScope } from '../../core/ContractAllowedScope.js';
+export declare class AgentRuntimeState {
+    currentTaskId: string | null;
+    currentTaskWorkingDirectory: string | null;
+    currentTaskWriteScope: string[];
+    /** 契约结构化允许面(由 payload 透传,worker 子进程启动时 set)。undefined=无契约→写工具维持原 scope 检查。 */
+    currentContractAllowedScope: ContractAllowedScope | undefined;
+    /** 完成校验重试耗尽后强制放行的审计标记(null=正常验收通过,非 null=本次完成未经测试门验证)。 */
+    completionBypassed: {
+        reason: string;
+        retries: number;
+    } | null;
+    iteration: number;
+    rawXmlRetryCount: number;
+    completionGuardRetryCount: number;
+    /**
+     * 连续续跑次数（nextSpeaker=model / LLM continuation judge 触发的续跑）。
+     * 任何一次真实工具调用都会清零。用于熔断「续跑→短 stop→续跑」空转死循环。
+     */
+    continuationRetryCount: number;
+    toolCallCount: number;
+    startTime: number;
+    initializeTaskScope(task: Task, workspace: string): void;
+    restoreProgress(iteration: number, toolCallCount: number): void;
+    beginRound(): number;
+    repeatRound(): number;
+    recordToolCalls(count: number): number;
+    setRawXmlRetryCount(count: number): void;
+    /** 续跑计数 +1 并返回新值。任何真实工具调用（recordToolCalls）会清零。 */
+    incrementContinuationRetry(): number;
+    resetContinuationRetry(): void;
+    incrementCompletionGuardRetry(): number;
+    resetCompletionGuardRetry(): void;
+}
+//# sourceMappingURL=AgentRuntimeState.d.ts.map

package/dist/agents/runtime/AgentRuntimeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/AgentRuntimeState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,qBAAa,iBAAiB;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IACpC,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClD,qBAAqB,EAAE,MAAM,EAAE,CAAM;IACrC,8EAA8E;IAC9E,2BAA2B,EAAE,oBAAoB,GAAG,SAAS,CAAa;IAC1E,0DAA0D;IAC1D,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAQ;IACtE,SAAS,SAAK;IACd,gBAAgB,SAAK;IACrB,yBAAyB,SAAK;IAC9B;;;OAGG;IACH,sBAAsB,SAAK;IAC3B,aAAa,SAAK;IAClB,SAAS,SAAK;IAEd,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAYxD,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAK/D,UAAU,IAAI,MAAM;IAKpB,WAAW,IAAI,MAAM;IAKrB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQtC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxC,kDAAkD;IAClD,0BAA0B,IAAI,MAAM;IAKpC,sBAAsB,IAAI,IAAI;IAI9B,6BAA6B,IAAI,MAAM;IAKvC,yBAAyB,IAAI,IAAI;CAGlC"}

package/dist/agents/runtime/AgentRuntimeState.js

@@ -0,0 +1,68 @@
+export class AgentRuntimeState {
+    currentTaskId = null;
+    currentTaskWorkingDirectory = null;
+    currentTaskWriteScope = [];
+    /** 契约结构化允许面(由 payload 透传,worker 子进程启动时 set)。undefined=无契约→写工具维持原 scope 检查。 */
+    currentContractAllowedScope = undefined;
+    /** 完成校验重试耗尽后强制放行的审计标记(null=正常验收通过,非 null=本次完成未经测试门验证)。 */
+    completionBypassed = null;
+    iteration = 0;
+    rawXmlRetryCount = 0;
+    completionGuardRetryCount = 0;
+    /**
+     * 连续续跑次数（nextSpeaker=model / LLM continuation judge 触发的续跑）。
+     * 任何一次真实工具调用都会清零。用于熔断「续跑→短 stop→续跑」空转死循环。
+     */
+    continuationRetryCount = 0;
+    toolCallCount = 0;
+    startTime = 0;
+    initializeTaskScope(task, workspace) {
+        this.currentTaskId = task.id;
+        this.currentTaskWorkingDirectory = task.working_directory || workspace;
+        this.currentTaskWriteScope = Array.isArray(task.write_scope) && task.write_scope.length > 0
+            ? [...task.write_scope]
+            : [this.currentTaskWorkingDirectory];
+        this.rawXmlRetryCount = 0;
+        this.completionGuardRetryCount = 0;
+        this.continuationRetryCount = 0;
+        this.startTime = Date.now();
+    }
+    restoreProgress(iteration, toolCallCount) {
+        this.iteration = iteration;
+        this.toolCallCount = toolCallCount;
+    }
+    beginRound() {
+        this.iteration += 1;
+        return this.iteration;
+    }
+    repeatRound() {
+        this.iteration = Math.max(0, this.iteration - 1);
+        return this.iteration;
+    }
+    recordToolCalls(count) {
+        this.rawXmlRetryCount = 0;
+        this.completionGuardRetryCount = 0;
+        this.continuationRetryCount = 0;
+        this.toolCallCount += count;
+        return this.toolCallCount;
+    }
+    setRawXmlRetryCount(count) {
+        this.rawXmlRetryCount = count;
+    }
+    /** 续跑计数 +1 并返回新值。任何真实工具调用（recordToolCalls）会清零。 */
+    incrementContinuationRetry() {
+        this.continuationRetryCount += 1;
+        return this.continuationRetryCount;
+    }
+    resetContinuationRetry() {
+        this.continuationRetryCount = 0;
+    }
+    incrementCompletionGuardRetry() {
+        this.completionGuardRetryCount += 1;
+        return this.completionGuardRetryCount;
+    }
+    resetCompletionGuardRetry() {
+        this.completionGuardRetryCount = 0;
+    }
+}
+//# sourceMappingURL=AgentRuntimeState.js.map

package/dist/agents/runtime/AgentRuntimeState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRuntimeState.js","sourceRoot":"","sources":["../../../src/agents/runtime/AgentRuntimeState.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IAC5B,aAAa,GAAkB,IAAI,CAAC;IACpC,2BAA2B,GAAkB,IAAI,CAAC;IAClD,qBAAqB,GAAa,EAAE,CAAC;IACrC,8EAA8E;IAC9E,2BAA2B,GAAqC,SAAS,CAAC;IAC1E,0DAA0D;IAC1D,kBAAkB,GAA+C,IAAI,CAAC;IACtE,SAAS,GAAG,CAAC,CAAC;IACd,gBAAgB,GAAG,CAAC,CAAC;IACrB,yBAAyB,GAAG,CAAC,CAAC;IAC9B;;;OAGG;IACH,sBAAsB,GAAG,CAAC,CAAC;IAC3B,aAAa,GAAG,CAAC,CAAC;IAClB,SAAS,GAAG,CAAC,CAAC;IAEd,mBAAmB,CAAC,IAAU,EAAE,SAAiB;QAC/C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,2BAA2B,GAAG,IAAI,CAAC,iBAAiB,IAAI,SAAS,CAAC;QACvE,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YACzF,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;YACvB,CAAC,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,aAAqB;QACtD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,WAAW;QACT,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,eAAe,CAAC,KAAa;QAC3B,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,mBAAmB,CAAC,KAAa;QAC/B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAChC,CAAC;IAED,kDAAkD;IAClD,0BAA0B;QACxB,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACrC,CAAC;IAED,sBAAsB;QACpB,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,6BAA6B;QAC3B,IAAI,CAAC,yBAAyB,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,yBAAyB,CAAC;IACxC,CAAC;IAED,yBAAyB;QACvB,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/agents/runtime/CompletionTerminationPolicy.d.ts

@@ -0,0 +1,15 @@
+export type RawToolRetryOutcome = {
+    type: 'retry';
+    nextRetryCount: number;
+} | {
+    type: 'terminate';
+    nextRetryCount: number;
+    finalMessage: string;
+};
+export declare function isStopFinishReason(finishReason?: string): boolean;
+export declare function evaluateRawToolRetryOutcome(options: {
+    currentRetryCount: number;
+    maxRetryCount: number;
+    finalMessage: (nextRetryCount: number) => string;
+}): RawToolRetryOutcome;
+//# sourceMappingURL=CompletionTerminationPolicy.d.ts.map

package/dist/agents/runtime/CompletionTerminationPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionTerminationPolicy.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/CompletionTerminationPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD,GAAG,mBAAmB,CAatB"}

package/dist/agents/runtime/CompletionTerminationPolicy.js

@@ -0,0 +1,18 @@
+export function isStopFinishReason(finishReason) {
+    return finishReason === 'stop' || finishReason === 'end_turn';
+}
+export function evaluateRawToolRetryOutcome(options) {
+    const nextRetryCount = options.currentRetryCount + 1;
+    if (nextRetryCount > options.maxRetryCount) {
+        return {
+            type: 'terminate',
+            nextRetryCount,
+            finalMessage: options.finalMessage(nextRetryCount),
+        };
+    }
+    return {
+        type: 'retry',
+        nextRetryCount,
+    };
+}
+//# sourceMappingURL=CompletionTerminationPolicy.js.map

package/dist/agents/runtime/CompletionTerminationPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionTerminationPolicy.js","sourceRoot":"","sources":["../../../src/agents/runtime/CompletionTerminationPolicy.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB,CAAC,YAAqB;IACtD,OAAO,YAAY,KAAK,MAAM,IAAI,YAAY,KAAK,UAAU,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAI3C;IACC,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IACrD,IAAI,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,cAAc;YACd,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC;SACnD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/agents/runtime/EternalPatrolJudge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * EternalPatrolJudge — Eternal Mode patrol 入口前的轻量判官
+ *
+ * 设计动机：
+ *   EternalLoop.tick 默认会按指数退避节奏向 LLM 注入"自主研发"prompt，
+ *   但当项目指纹（任务板/黑板/scratchpad）完全没变时，LLM 找不到工作就回纯文本"挑一个"，
+ *   持续烧 token。Judge 在 patrol prompt 注入之前判断三种动作：
+ *
+ *     - patrol     : 项目状态有可深挖增量，照常跑 patrol
+ *     - skip       : 增量与上轮巡检重叠/属噪音，本轮不调 LLM；fingerprint 锁住下一轮
+ *     - yield_user : 所有任务终态、上轮 idle、增量全是噪音 → 把控制权还给用户
+ *
+ * 与 NextSpeakerPolicy 的区别：
+ *   NextSpeakerPolicy 是"LLM 已开口后是否继续"；
+ *   EternalPatrolJudge 是"是否要让 LLM 开口"。两者前后衔接，互不重叠。
+ */
+import { type PromptLocale } from '../prompts/i18n/catalog.js';
+import { type EternalPatrolJudgeInput, type EternalPatrolVerdict } from '../../contracts/adapters/EternalPatrolPolicy.js';
+export { decideEternalActionFromRuntimeState, type EternalAction, type EternalPatrolJudgeInput, type EternalPatrolVerdict, } from '../../contracts/adapters/EternalPatrolPolicy.js';
+export declare function judgeEternalAction(input: EternalPatrolJudgeInput & {
+    locale?: PromptLocale;
+}): Promise<EternalPatrolVerdict>;
+//# sourceMappingURL=EternalPatrolJudge.d.ts.map

package/dist/agents/runtime/EternalPatrolJudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EternalPatrolJudge.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/EternalPatrolJudge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EACL,mCAAmC,EACnC,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,iDAAiD,CAAC;AAqEzD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG;IAAE,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyBlI"}

package/dist/agents/runtime/EternalPatrolJudge.js

@@ -0,0 +1,114 @@
+/**
+ * EternalPatrolJudge — Eternal Mode patrol 入口前的轻量判官
+ *
+ * 设计动机：
+ *   EternalLoop.tick 默认会按指数退避节奏向 LLM 注入"自主研发"prompt，
+ *   但当项目指纹（任务板/黑板/scratchpad）完全没变时，LLM 找不到工作就回纯文本"挑一个"，
+ *   持续烧 token。Judge 在 patrol prompt 注入之前判断三种动作：
+ *
+ *     - patrol     : 项目状态有可深挖增量，照常跑 patrol
+ *     - skip       : 增量与上轮巡检重叠/属噪音，本轮不调 LLM；fingerprint 锁住下一轮
+ *     - yield_user : 所有任务终态、上轮 idle、增量全是噪音 → 把控制权还给用户
+ *
+ * 与 NextSpeakerPolicy 的区别：
+ *   NextSpeakerPolicy 是"LLM 已开口后是否继续"；
+ *   EternalPatrolJudge 是"是否要让 LLM 开口"。两者前后衔接，互不重叠。
+ */
+import { agentLogger } from '../../core/Log.js';
+import { runStructuredJudgment } from '../../core/JudgmentService.js';
+import { createLlmGuard } from '../LlmGuard.js';
+import { getPromptCatalog } from '../prompts/i18n/catalog.js';
+import { decideEternalActionFromRuntimeState, } from '../../contracts/adapters/EternalPatrolPolicy.js';
+export { decideEternalActionFromRuntimeState, } from '../../contracts/adapters/EternalPatrolPolicy.js';
+function buildEternalVerdictTool(locale) {
+    const catalog = getPromptCatalog(locale).judges.eternalPatrol;
+    return {
+        type: 'function',
+        function: {
+            name: 'submit_eternal_verdict',
+            description: catalog.toolDescription,
+            parameters: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    action: {
+                        type: 'string',
+                        enum: ['patrol', 'skip', 'yield_user'],
+                        description: catalog.actionDescription,
+                    },
+                    reason: {
+                        type: 'string',
+                        description: catalog.reasonDescription,
+                    },
+                },
+                required: ['action', 'reason'],
+            },
+        },
+    };
+}
+function buildJudgeMessages(input) {
+    const catalog = getPromptCatalog(input.locale).judges.eternalPatrol;
+    const goal = typeof input.eternalGoal === 'string' && input.eternalGoal.trim()
+        ? input.eternalGoal.trim()
+        : '(none)';
+    const lines = [
+        `eternal_goal: ${goal}`,
+        `fingerprint_changed: ${input.fingerprintChanged ? 'true' : 'false'}`,
+        `fingerprint_diff: ${input.fingerprintDiff || '(none)'}`,
+        `last_patrol_outcome: ${input.lastPatrolOutcome}`,
+        `consecutive_idle_patrols: ${input.consecutiveIdlePatrols}`,
+        `has_open_work: ${input.hasOpenWork}`,
+        `has_running_agents: ${input.hasRunningAgents}`,
+        '',
+        '[recent_conversation]',
+        input.recentConversationDigest || '(none)',
+        '[/recent_conversation]',
+    ];
+    return [
+        {
+            role: 'system',
+            content: catalog.system,
+        },
+        {
+            role: 'user',
+            content: lines.join('\n'),
+        },
+    ];
+}
+function validateEternalVerdict(parsed) {
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const action = 'action' in parsed ? parsed.action : undefined;
+    const reason = 'reason' in parsed ? parsed.reason : undefined;
+    if (action !== 'patrol' && action !== 'skip' && action !== 'yield_user')
+        return null;
+    if (typeof reason !== 'string')
+        return null;
+    return { action, reason };
+}
+export async function judgeEternalAction(input) {
+    if (!input.llm || !input.model) {
+        return decideEternalActionFromRuntimeState(input);
+    }
+    const result = await runStructuredJudgment({
+        kind: 'eternal_patrol',
+        llm: input.llm,
+        model: input.model,
+        messages: buildJudgeMessages(input),
+        tool: buildEternalVerdictTool(input.locale),
+        validate: validateEternalVerdict,
+        llmGuardFactory: createLlmGuard,
+        logger: agentLogger,
+        gatewayContext: {
+            actorType: 'leader',
+            actorLabel: 'Leader-EternalJudge',
+            purpose: 'verify',
+            requestedModel: input.model,
+        },
+    });
+    if (result.verdict) {
+        return result.verdict;
+    }
+    return decideEternalActionFromRuntimeState(input);
+}
+//# sourceMappingURL=EternalPatrolJudge.js.map

package/dist/agents/runtime/EternalPatrolJudge.js.map

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

package/dist/agents/runtime/LlmRoundExecutor.d.ts

@@ -0,0 +1,55 @@
+import type { ChatMessage, ChatResponse, LlmRoundEvent, TokenUsage, ToolCall, ToolDefinition } from '../../llm/types.js';
+import type { ContentGenerator, GenerateContentParams } from '../../llm/ContentGenerator.js';
+import type { GatewayRequestContext } from '../../llm/ModelGateway.js';
+type LlmRoundGenerateOptions = Pick<GenerateContentParams, 'maxTokens' | 'sampling'>;
+export interface LlmRoundHooks<TError extends Error = Error> {
+    onText?: (text: string) => void;
+    onThinking?: (thinking: string) => void;
+    onToolCall?: (toolCall: ToolCall) => void;
+    onToolCallDelta?: (delta: {
+        index: number;
+        id?: string;
+        name?: string;
+        partialJson: string;
+    }) => void;
+    onProgress?: (progress: {
+        elapsed: number;
+        status: string;
+    }) => void;
+    onRetry?: (attempt: number, error: TError) => void;
+    onError?: (error: TError) => void;
+    onUsage?: (usage: TokenUsage) => void;
+    onStreamRetry?: (attempt: number, error: TError) => void;
+    onFirstToken?: () => void;
+}
+export interface ExecuteLlmRoundOptions<TError extends Error = Error> {
+    actorLabel: string;
+    llm: ContentGenerator;
+    messages: ChatMessage[];
+    model: string;
+    tools?: ToolDefinition[];
+    streamingEnabled: boolean;
+    signal?: AbortSignal;
+    classifyError?: (error: unknown) => TError;
+    hooks?: LlmRoundHooks<TError>;
+    gatewayContext?: GatewayRequestContext;
+    generateOptions?: LlmRoundGenerateOptions;
+}
+export interface LlmRoundEventStream {
+    events: AsyncIterable<LlmRoundEvent>;
+    response: Promise<ChatResponse>;
+}
+export declare function createLlmRoundEventStream<TError extends Error = Error>(options: ExecuteLlmRoundOptions<TError>): LlmRoundEventStream;
+export declare function createEventStreamClient<TError extends Error = Error>(options: {
+    actorLabel: string;
+    llm: ContentGenerator;
+    classifyError?: (error: unknown) => TError;
+    hooks?: LlmRoundHooks<TError>;
+    gatewayContext?: GatewayRequestContext;
+}): ContentGenerator;
+export declare function consumeLlmRoundEvents<TError extends Error = Error>(events: AsyncIterable<LlmRoundEvent>, hooks?: LlmRoundHooks<TError>, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function executeLlmRound<TError extends Error = Error>(options: ExecuteLlmRoundOptions<TError>): Promise<ChatResponse>;
+export {};
+//# sourceMappingURL=LlmRoundExecutor.d.ts.map

package/dist/agents/runtime/LlmRoundExecutor.d.ts.map

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