@lingxiao-office/sdk 1.0.0

package/dist/agents/runtime/MandatoryVerification.js

@@ -0,0 +1,108 @@
+import { BuildDiagnosticsCollector } from '../../core/BuildDiagnosticsCollector.js';
+import { ChangeImpactResolver } from '../../core/ChangeImpactResolver.js';
+import { TestRunnerAdapter } from '../../core/TestRunnerAdapter.js';
+import { VerificationPipeline } from '../../core/VerificationPipeline.js';
+import { getConfigValue } from '../../config.js';
+import { agentLogger } from '../../core/Log.js';
+import { spawnSync } from 'child_process';
+import { existsSync } from 'fs';
+import { join } from 'path';
+function isEnabled(path, fallback) {
+    const value = getConfigValue(path);
+    return typeof value === 'boolean' ? value : fallback;
+}
+function positiveNumber(path, fallback) {
+    const value = Number(getConfigValue(path));
+    return Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function nonNegativeNumber(path, fallback) {
+    const value = Number(getConfigValue(path));
+    return Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+export function collectCompletionChangedFiles(input) {
+    const seen = new Set();
+    const out = [];
+    for (const value of [
+        ...(input.artifacts?.files_created ?? []),
+        ...(input.artifacts?.files_modified ?? []),
+        ...(input.toolTrace?.files_created ?? []),
+        ...(input.toolTrace?.files_modified ?? []),
+    ]) {
+        const trimmed = value.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+/**
+ * 用 git 真实取证改动文件(git status --porcelain -z -uall),补全 worker 自报的漏报(最大洞)。
+ * 非 git 仓库或 git 调用失败 → 返回 [](fallback 到纯自报,绝不阻塞验收)。
+ * worktree 下 .git 是指向主仓库的文件指针,existsSync 仍 true,git -C status 正常工作。
+ * -uall(=--untracked-files=all):展开未跟踪目录到逐文件。默认 normal 会把新建目录折叠成
+ * "sub/",丢失逐文件粒度——而 worker 新建整目录模块正是最该被取证的场景,验收门/契约校验
+ * 都按单文件工作,折叠目录会让 affected-test 检测漏掉新文件。
+ */
+export function collectGitChangedFiles(workingDir) {
+    if (!workingDir || !existsSync(join(workingDir, '.git')))
+        return [];
+    const result = spawnSync('git', ['-C', workingDir, 'status', '--porcelain=v1', '-z', '-uall'], {
+        encoding: 'utf-8',
+        timeout: 10_000,
+    });
+    if (result.status !== 0 || !result.stdout)
+        return [];
+    // porcelain -z 用 \0 分隔;每条形如 XY<space>path(XY 是 2 字符状态码 + 1 空格)。
+    // 只取第 3 字符为空格的条目(有 XY 状态码前缀),过滤掉重命名条目无前缀的 new path。
+    return result.stdout
+        .split('\0')
+        .filter(entry => entry.length >= 3 && entry[2] === ' ')
+        .map(entry => entry.slice(3).trim())
+        .filter(p => p.length > 0);
+}
+export function resolveVerificationGateConfig() {
+    return {
+        typeCheck: isEnabled('verification.typecheck', true),
+        build: isEnabled('verification.build', true),
+        affectedTests: isEnabled('verification.affected_tests', true),
+        fullTests: isEnabled('verification.full_tests', false),
+        selfRepairBudget: nonNegativeNumber('verification.self_repair_budget', 3),
+        buildTimeoutMs: positiveNumber('verification.build_timeout_ms', 120_000),
+        testTimeoutMs: positiveNumber('verification.test_timeout_ms', 120_000),
+    };
+}
+export async function runCompletionVerification(input) {
+    if (!isEnabled('verification.completion_gate_enabled', true)) {
+        return undefined;
+    }
+    const selfReported = collectCompletionChangedFiles(input);
+    const gitReported = collectGitChangedFiles(input.workingDir);
+    // B1: union git 真实取证 + worker 自报——漏报被 git 补全,验收管线不再因 worker 漏报而跳过。
+    const changedFiles = Array.from(new Set([...selfReported, ...gitReported]));
+    if (gitReported.length > 0) {
+        const unreported = gitReported.filter(f => !selfReported.includes(f));
+        if (unreported.length > 0) {
+            agentLogger.warn(`[verification] worker 漏报 ${unreported.length} 个改动文件,已由 git 取证补全: ${unreported.slice(0, 10).join(', ')}${unreported.length > 10 ? ' ...' : ''}`);
+        }
+    }
+    if (changedFiles.length === 0) {
+        return undefined;
+    }
+    const config = resolveVerificationGateConfig();
+    const pipeline = new VerificationPipeline({
+        buildDiagnostics: new BuildDiagnosticsCollector(),
+        changeImpactResolver: new ChangeImpactResolver({
+            projectRoot: input.workingDir,
+            runBuildCheck: false,
+            buildTimeoutMs: config.buildTimeoutMs,
+        }),
+        testRunner: new TestRunnerAdapter({
+            projectRoot: input.workingDir,
+            timeoutMs: config.testTimeoutMs,
+        }),
+        logger: agentLogger,
+    });
+    return pipeline.verify(input.workingDir, changedFiles, config);
+}
+//# sourceMappingURL=MandatoryVerification.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { type ChatMessage } from '../../llm/types.js';
+import type { ContentGenerator } from '../../llm/ContentGenerator.js';
+import { type PromptLocale } from '../prompts/i18n/catalog.js';
+/**
+ * NextSpeaker 决策（2026-05-28 重构）
+ *
+ * Why 重构：
+ *   旧实现每轮工具批 / stop 都要串联 1~3 次 LLM 判官调用
+ *   （primary verdict + self-correction rejudge + persistent-signal rejudge），
+ *   最坏一轮 = 4 次 LLM。这些 judge 调用与主 LLM 共享 baseUrl::model 的
+ *   CircuitBreaker 与重试预算，是 Leader 比 worker 卡的主因之一。
+ *
+ * 改造：信任 API 端点的 finish_reason；只有 eternal 模式下 stop 后是否需要续跑交给统一 LLM judge。
+ *   - finishReason 不是 stop/end_turn → model（API 没说停就继续，任何模式）
+ *   - finishReason 是 stop 系列：
+ *     · 非 eternal → user（完全信任 API stop 信号，不做任何本地续跑）
+ *     · eternal + continuation judge 认为输出仍需接续       → model
+ *     · eternal + hasOpenWork && !hasExplicitUserGate                 → model（自驱找活）
+ *     · 其余                                                          → user
+ *
+ * 2026-05-30 用户决策：非 eternal 下"完全信任远程 API 信号，其他全不要"——
+ *   manual 模式不做本地截断猜测、不因 open_work 自驱，杜绝"没开 eternal 却空转续跑"。
+ *
+ * rejudge*Signal 接口已删除；本模块只有一个统一入口。
+ */
+export type NextSpeakerDecision = 'model' | 'user';
+export interface EvaluateNextSpeakerInput {
+    finishReason?: string;
+    content?: string;
+    reasoningContent?: string;
+    hasOpenWork: boolean;
+    hasExplicitUserGate: boolean;
+    /** 当前是否有正在运行的 Agent（已派发、在途的工作） */
+    hasRunningAgents?: boolean;
+    /** 是否处于 eternal（自治长跑）模式。 */
+    isEternalMode?: boolean;
+    messages?: ChatMessage[];
+    llm?: ContentGenerator;
+    model?: string;
+    sessionId?: string;
+    actorLabel?: string;
+    locale?: PromptLocale;
+}
+export interface NextSpeakerVerdict {
+    nextSpeaker: NextSpeakerDecision;
+    reason: string;
+    continuationPrompt: string;
+}
+/**
+ * 主入口：硬 finish_reason / user gate / running-agent 约束 + LLM 语义续跑判定。
+ */
+export declare function evaluateNextSpeakerCandidate(input: EvaluateNextSpeakerInput): Promise<NextSpeakerVerdict>;
+//# sourceMappingURL=NextSpeakerPolicy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NextSpeakerPolicy.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/NextSpeakerPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAsKD;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE/G"}

package/dist/agents/runtime/NextSpeakerPolicy.js

@@ -0,0 +1,162 @@
+import { isStopFinishReason } from './CompletionTerminationPolicy.js';
+import { runStructuredJudgment } from '../../core/JudgmentService.js';
+import { agentLogger } from '../../core/Log.js';
+import { createLlmGuard } from '../LlmGuard.js';
+import { getPromptCatalog } from '../prompts/i18n/catalog.js';
+/**
+ * 统一的 continuation 文案。
+ *
+ * Why 统一：每条 continuation prompt 都会作为新的 user 消息追加到对话末尾，
+ * 而 Anthropic prompt caching 会在最近的消息块上打 cache_control 断点。
+ * 不同 reason 用不同文案 → 末尾文本每轮都漂移 → "最近 1 个断点"对应的
+ * cache_creation 反复发生，命中率受损。文案统一为一条稳定字符串后，
+ * 哪怕 reason 不同，缓存前缀仍能稳定命中（reason 仅在日志/事件中体现）。
+ */
+const UNIFIED_CONTINUATION_PROMPT = '请基于当前上下文接续未完成部分，已输出内容用承接方式处理。';
+function buildNextSpeakerContinuationTool(locale) {
+    const catalog = getPromptCatalog(locale).judges.nextSpeaker;
+    return {
+        type: 'function',
+        function: {
+            name: 'submit_next_speaker_verdict',
+            description: catalog.toolDescription,
+            parameters: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    should_continue: {
+                        type: 'boolean',
+                    },
+                    reason: {
+                        type: 'string',
+                    },
+                },
+                required: ['should_continue', 'reason'],
+            },
+        },
+    };
+}
+function validateContinuationVerdict(payload) {
+    if (!payload || typeof payload !== 'object')
+        return null;
+    const shouldContinue = 'should_continue' in payload ? payload.should_continue : undefined;
+    const reason = 'reason' in payload ? payload.reason : undefined;
+    if (typeof shouldContinue !== 'boolean' || typeof reason !== 'string')
+        return null;
+    return { shouldContinue, reason };
+}
+function buildContinuationJudgeMessages(input) {
+    const catalog = getPromptCatalog(input.locale).judges.nextSpeaker;
+    return [
+        {
+            role: 'system',
+            content: catalog.system,
+        },
+        {
+            role: 'user',
+            content: [
+                `finish_reason: ${input.finishReason || '(none)'}`,
+                `has_open_work: ${input.hasOpenWork ? 'true' : 'false'}`,
+                `has_explicit_user_gate: ${input.hasExplicitUserGate ? 'true' : 'false'}`,
+                `has_running_agents: ${input.hasRunningAgents ? 'true' : 'false'}`,
+                '',
+                '[assistant_visible_output]',
+                input.content || '(empty)',
+                '[/assistant_visible_output]',
+                '',
+                '[assistant_reasoning_output]',
+                input.reasoningContent || '(empty)',
+                '[/assistant_reasoning_output]',
+                '',
+                '[recent_messages]',
+                (input.messages || []).slice(-6).map((message) => {
+                    const content = typeof message.content === 'string'
+                        ? message.content
+                        : JSON.stringify(message.content);
+                    return `${message.role}: ${content.slice(0, 500)}`;
+                }).join('\n---\n') || '(none)',
+                '[/recent_messages]',
+            ].join('\n'),
+        },
+    ];
+}
+async function judgeContinuation(input) {
+    const result = await runStructuredJudgment({
+        kind: 'next_speaker_continuation',
+        llm: input.llm,
+        model: input.model,
+        messages: buildContinuationJudgeMessages(input),
+        tool: buildNextSpeakerContinuationTool(input.locale),
+        validate: validateContinuationVerdict,
+        llmGuardFactory: createLlmGuard,
+        logger: agentLogger,
+        gatewayContext: {
+            actorType: 'leader',
+            actorLabel: input.actorLabel || 'NextSpeakerJudge',
+            purpose: 'verify',
+            sessionId: input.sessionId,
+            requestedModel: input.model,
+        },
+    });
+    return result.verdict;
+}
+async function decide(input) {
+    // API 没说停（finish_reason 不是 stop/end_turn）→ 继续。任何模式都成立：
+    // 这是远程端点明确表达"输出还没完"，与本地续跑猜测无关。
+    if (!isStopFinishReason(input.finishReason)) {
+        return {
+            nextSpeaker: 'model',
+            reason: 'non_terminal_finish_reason',
+            continuationPrompt: UNIFIED_CONTINUATION_PROMPT,
+        };
+    }
+    // ── 非 eternal：完全信任远程 API 信号 ──
+    // 用户明确要求：manual 模式下 stop/end_turn 一律收尾交回用户，
+    // 不做任何本地续跑（不做截断猜测、不因 open_work 自驱）。
+    // 是否继续完全由 Leader 自己在下一条用户消息驱动时决定，杜绝空转续跑。
+    if (!input.isEternalMode) {
+        return {
+            nextSpeaker: 'user',
+            reason: 'trust_api_stop_signal',
+            continuationPrompt: '',
+        };
+    }
+    // ── 以下仅 eternal（自治长跑）模式 ──
+    const continuation = await judgeContinuation(input);
+    if (continuation?.shouldContinue) {
+        return {
+            nextSpeaker: 'model',
+            reason: continuation.reason || 'llm_incomplete_visible_response',
+            continuationPrompt: UNIFIED_CONTINUATION_PROMPT,
+        };
+    }
+    if (input.hasOpenWork && !input.hasExplicitUserGate) {
+        // open_work = dispatchable 任务（尚未派发的就绪任务），running 不算。
+        // 如果有 running agents 但没有真正需要 Leader 亲自派发的新工作，不应继续——
+        // Leader 应等 worker 汇报，而非被反复唤醒空转。
+        if (input.hasRunningAgents) {
+            return {
+                nextSpeaker: 'user',
+                reason: 'agents_running_wait_for_completion',
+                continuationPrompt: '',
+            };
+        }
+        return {
+            nextSpeaker: 'model',
+            reason: 'open_work_still_exists',
+            continuationPrompt: UNIFIED_CONTINUATION_PROMPT,
+        };
+    }
+    return {
+        nextSpeaker: 'user',
+        reason: 'turn_complete',
+        continuationPrompt: '',
+    };
+}
+/**
+ * 主入口：硬 finish_reason / user gate / running-agent 约束 + LLM 语义续跑判定。
+ */
+export async function evaluateNextSpeakerCandidate(input) {
+    return decide(input);
+}
+//# sourceMappingURL=NextSpeakerPolicy.js.map

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

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

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

@@ -0,0 +1,32 @@
+export type ReasoningLoopStep<T> = {
+    type: 'continue';
+} | {
+    type: 'repeat';
+} | {
+    type: 'reset_budget';
+} | {
+    type: 'break';
+    result?: T;
+};
+export type ReasoningLoopTerminationReason = 'max_rounds' | 'max_runtime';
+export interface ReasoningLoopBoundContext {
+    roundsCompleted: number;
+    startedAtMs: number;
+}
+export interface RunBoundedReasoningLoopOptions<T> {
+    maxRounds: number;
+    maxRuntimeMinutes: number;
+    /** 最大 reset_budget 次数，默认 3 */
+    maxResets?: number;
+    /** 最大连续 repeat 次数，默认 maxRounds */
+    maxConsecutiveRepeats?: number;
+    runRound: (roundNumber: number) => Promise<ReasoningLoopStep<T> | void> | ReasoningLoopStep<T> | void;
+    onBoundReached?: (reason: ReasoningLoopTerminationReason, context: ReasoningLoopBoundContext) => Promise<ReasoningLoopStep<T> | void> | ReasoningLoopStep<T> | void;
+}
+export interface ReasoningLoopResult<T> {
+    result?: T;
+    roundsCompleted: number;
+    terminationReason?: ReasoningLoopTerminationReason;
+}
+export declare function runBoundedReasoningLoop<T>(options: RunBoundedReasoningLoopOptions<T>): Promise<ReasoningLoopResult<T>>;
+//# sourceMappingURL=ReasoningLoopDriver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReasoningLoopDriver.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/ReasoningLoopDriver.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC3B;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtG,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,8BAA8B,EACtC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACzE;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;CACpD;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAgEjC"}

package/dist/agents/runtime/ReasoningLoopDriver.js

@@ -0,0 +1,58 @@
+export async function runBoundedReasoningLoop(options) {
+    const { maxRounds, maxRuntimeMinutes, maxResets = 3, maxConsecutiveRepeats = maxRounds, runRound, onBoundReached, } = options;
+    let roundsCompleted = 0;
+    let startedAtMs = Date.now();
+    let resetCount = 0;
+    let consecutiveRepeats = 0;
+    async function handleBoundReached(reason) {
+        const boundStep = (await onBoundReached?.(reason, { roundsCompleted, startedAtMs })) ?? { type: 'continue' };
+        if (boundStep.type === 'break') {
+            return { action: 'return', value: { result: boundStep.result, roundsCompleted, terminationReason: reason } };
+        }
+        if (boundStep.type === 'reset_budget') {
+            resetCount++;
+            if (resetCount > maxResets) {
+                return { action: 'return', value: { roundsCompleted, terminationReason: reason } };
+            }
+            return { action: 'reset' };
+        }
+        return { action: 'return', value: { roundsCompleted, terminationReason: reason } };
+    }
+    while (true) {
+        if (roundsCompleted >= maxRounds) {
+            const outcome = await handleBoundReached('max_rounds');
+            if (outcome?.action === 'reset') {
+                roundsCompleted = 0;
+                startedAtMs = Date.now();
+                continue;
+            }
+            if (outcome?.action === 'return')
+                return outcome.value;
+        }
+        if ((Date.now() - startedAtMs) / (1000 * 60) >= maxRuntimeMinutes) {
+            const outcome = await handleBoundReached('max_runtime');
+            if (outcome?.action === 'reset') {
+                roundsCompleted = 0;
+                startedAtMs = Date.now();
+                continue;
+            }
+            if (outcome?.action === 'return')
+                return outcome.value;
+        }
+        roundsCompleted += 1;
+        const step = (await runRound(roundsCompleted)) ?? { type: 'continue' };
+        if (step.type === 'break') {
+            return { result: step.result, roundsCompleted };
+        }
+        if (step.type === 'repeat') {
+            consecutiveRepeats++;
+            if (consecutiveRepeats > maxConsecutiveRepeats) {
+                return { roundsCompleted, terminationReason: 'max_rounds' };
+            }
+            roundsCompleted -= 1;
+            continue;
+        }
+        consecutiveRepeats = 0;
+    }
+}
+//# sourceMappingURL=ReasoningLoopDriver.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * StreamChunkBuffer
+ *
+ * 把 LLM 流式 chunk 聚合成更大的片段再 emit，避免每个 token 触发一次事件。
+ *
+ * 设计目标：Leader 与 Worker(BaseAgent)、文本与 thinking 共用一份缓冲实现，
+ * 修复历史上 thinking 缓冲忘记定时 flush / finally flush 导致短链思考被吞的 bug。
+ *
+ * 触发 flush 的三种路径：
+ *  - 阈值触发：累积长度 >= flushThreshold 立即 flush
+ *  - 换行触发：chunk 内含 \n 立即 flush（保留行边界，便于 UI 分行渲染）
+ *  - 定时触发：append 后启动定时器，达到 idleFlushMs 自动 flush（保证小片段也能露出）
+ *  - 显式 flush：调用方在 finally 中 flush()，保证最后一段不丢
+ *
+ * 与 src/tui/state/streamBuffer.ts 的区别：
+ *  - 这里聚合的是「单条流」，append → onFlush(text) 同步交付
+ *  - TUI streamBuffer 是「多 channel × 多 field」的 React 渲染节流，关注的是 setState 频率
+ *  两边问题域不同，不能合并。
+ */
+export interface StreamChunkBufferOptions {
+    /** 累积长度达到此阈值立即 flush */
+    flushThreshold: number;
+    /** append 后多少毫秒未再追加则 flush（默认 10ms） */
+    idleFlushMs?: number;
+    /** flush 时同步交付聚合后的字符串，空字符串不会调用 */
+    onFlush: (text: string) => void;
+}
+export interface StreamChunkBuffer {
+    /** 追加一段 chunk，按规则触发 flush */
+    append(chunk: string): void;
+    /** 强制 flush 当前缓冲（无论长度），并清掉定时器 */
+    flush(): void;
+    /**
+     * 丢弃当前缓冲，不交付任何残留。
+     *
+     * 用于 LlmGuard 外层重试场景：上一次 attempt 已经流出去的部分要被前端 discard，
+     * 残留在 buffer 里的更不能再 flush 出去和下一次 attempt 的内容拼接。
+     * 不同于 dispose（终结使用），reset 后 buffer 仍可继续 append。
+     */
+    reset(): void;
+    /** 释放资源（清定时器，丢弃缓冲，不交付） */
+    dispose(): void;
+}
+export declare function createStreamChunkBuffer(options: StreamChunkBufferOptions): StreamChunkBuffer;
+//# sourceMappingURL=StreamChunkBuffer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamChunkBuffer.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/StreamChunkBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,wBAAwB;IACvC,wBAAwB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iCAAiC;IACjC,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;OAMG;IACH,KAAK,IAAI,IAAI,CAAC;IACd,0BAA0B;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA0D5F"}

package/dist/agents/runtime/StreamChunkBuffer.js

@@ -0,0 +1,57 @@
+export function createStreamChunkBuffer(options) {
+    const idleFlushMs = options.idleFlushMs ?? 10;
+    const parts = [];
+    let len = 0;
+    let timer = null;
+    let disposed = false;
+    const clearTimer = () => {
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+    };
+    const deliver = () => {
+        if (len === 0 || disposed)
+            return;
+        const text = parts.join('');
+        parts.length = 0;
+        len = 0;
+        options.onFlush(text);
+    };
+    const flush = () => {
+        if (disposed)
+            return;
+        clearTimer();
+        deliver();
+    };
+    const append = (chunk) => {
+        if (!chunk || disposed)
+            return;
+        parts.push(chunk);
+        len += chunk.length;
+        clearTimer();
+        if (len >= options.flushThreshold || chunk.includes('\n')) {
+            deliver();
+            return;
+        }
+        timer = setTimeout(() => {
+            timer = null;
+            deliver();
+        }, idleFlushMs);
+    };
+    const dispose = () => {
+        disposed = true;
+        clearTimer();
+        parts.length = 0;
+        len = 0;
+    };
+    const reset = () => {
+        if (disposed)
+            return;
+        clearTimer();
+        parts.length = 0;
+        len = 0;
+    };
+    return { append, flush, reset, dispose };
+}
+//# sourceMappingURL=StreamChunkBuffer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamChunkBuffer.js","sourceRoot":"","sources":["../../../src/agents/runtime/StreamChunkBuffer.ts"],"names":[],"mappings":"AA6CA,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACvE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,GAAG,KAAK,CAAC,IAAI,QAAQ;YAAE,OAAO;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,GAAG,GAAG,CAAC,CAAC;QACR,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ;YAAE,OAAO;QACrB,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,IAAI,QAAQ;YAAE,OAAO;QAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,CAAC;QACb,IAAI,GAAG,IAAI,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,GAAG,GAAG,CAAC,CAAC;IACV,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ;YAAE,OAAO;QACrB,UAAU,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACjB,GAAG,GAAG,CAAC,CAAC;IACV,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { ToolCall } from '../../llm/types.js';
+import type { ToolCallExecution } from './ToolResponseProcessor.js';
+/**
+ * 从截断的 file_create arguments 中提取 partial content。
+ *
+ * 当 max_tokens 截断导致 JSON 不完整时，JSON.parse 会失败。
+ * 此函数用正则从残缺 JSON 中提取 "content" 字段的已传输部分，
+ * 即使字符串没有闭合引号也能提取。
+ *
+ * 返回 null 表示无法提取（如 content 字段尚未开始传输）。
+ */
+export declare function extractPartialFileContent(argsStr: string): string | null;
+/**
+ * 从截断的 arguments 中提取 path 字段。
+ * path 通常在 content 之前传输，所以即使 content 被截断，path 往往是完整的。
+ */
+export declare function extractPathFromArgs(argsStr: string): string | null;
+/**
+ * 截断保护 + Partial Content Rescue。
+ *
+ * 当 wasOutputTruncated=true 时调用。改进点：
+ * 1. 先尝试 JSON.parse — 如果参数完整且未被截断（JSON 以 } 闭合），正常执行。
+ * 2. 如果 JSON.parse 成功但原始字符串不以 } 结尾（safeJsonParse 修复的截断 JSON），
+ *    仍然拦截——content 值可能被截断，直接写入会生成不完整文件。
+ * 3. 如果 JSON.parse 失败（参数严重截断），从残缺 JSON 中提取 partial content 并落盘，
+ *    返回带续接策略的结构化拒绝消息。
+ * 4. 对 file_create 提取 content 字段；对 structured_patch 不提取（hunk 结构复杂，
+ *    半截 hunk 应用会导致错误修改），只给出续接指导。
+ */
+export declare function executeToolCallsWithTruncationGuard(toolCalls: ToolCall[], executeToolCallsBatch: (toolCalls: ToolCall[]) => Promise<ToolCallExecution[]>): Promise<ToolCallExecution[]>;
+/**
+ * 空参数保护：拦截文件编辑类工具的空 `{}` 参数调用。
+ *
+ * 当 streaming 截断（如 max_tokens 耗尽、provider 中断）导致 tool call 的
+ * arguments chunks 丢失时，StreamingToolCallParser 会返回 args={}。
+ * 对文件编辑工具这永远不合法——阻止执行并给出明确提示，避免模型因误解错误信息而死循环重试。
+ *
+ * 此函数在 wasOutputTruncated=false 时也可独立使用。
+ * 改进：拒绝消息升级为带续接策略的结构化消息，而非简单的"请重新输出"。
+ */
+export declare function rejectEmptyArgsFileTools(toolCalls: ToolCall[], executeToolCallsBatch: (toolCalls: ToolCall[]) => Promise<ToolCallExecution[]>): Promise<ToolCallExecution[]>;
+//# sourceMappingURL=ToolCallSafety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallSafety.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/ToolCallSafety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAgGpE;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlE;AAoHD;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,QAAQ,EAAE,EACrB,qBAAqB,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAC7E,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuD9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,QAAQ,EAAE,EACrB,qBAAqB,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAC7E,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsB9B"}