@lingxiao-office/sdk 1.0.0

package/dist/agents/runtime/LlmRoundExecutor.js

@@ -0,0 +1,382 @@
+import { createLlmGuard } from '../LlmGuard.js';
+function hooksFromStreamCallbacks(callbacks) {
+    if (!callbacks) {
+        return undefined;
+    }
+    return {
+        onText: callbacks.onText,
+        onThinking: callbacks.onThinking,
+        onToolCall: callbacks.onToolCall,
+        onToolCallDelta: callbacks.onToolCallDelta,
+        onUsage: callbacks.onUsage,
+        onProgress: callbacks.onProgress,
+        onRetry: callbacks.onRetry,
+        onError: callbacks.onError,
+        onStreamRetry: callbacks.onStreamRetry,
+        onFirstToken: callbacks.onFirstToken,
+    };
+}
+function chainHooks(first, second) {
+    if (!first && !second) {
+        return undefined;
+    }
+    return {
+        onText: (text) => {
+            first?.onText?.(text);
+            second?.onText?.(text);
+        },
+        onThinking: (thinking) => {
+            first?.onThinking?.(thinking);
+            second?.onThinking?.(thinking);
+        },
+        onToolCall: (toolCall) => {
+            first?.onToolCall?.(toolCall);
+            second?.onToolCall?.(toolCall);
+        },
+        onToolCallDelta: (delta) => {
+            first?.onToolCallDelta?.(delta);
+            second?.onToolCallDelta?.(delta);
+        },
+        onUsage: (usage) => {
+            first?.onUsage?.(usage);
+            second?.onUsage?.(usage);
+        },
+        onProgress: (progress) => {
+            first?.onProgress?.(progress);
+            second?.onProgress?.(progress);
+        },
+        onRetry: (attempt, error) => {
+            first?.onRetry?.(attempt, error);
+            second?.onRetry?.(attempt, error);
+        },
+        onError: (error) => {
+            first?.onError?.(error);
+            second?.onError?.(error);
+        },
+        onStreamRetry: (attempt, error) => {
+            first?.onStreamRetry?.(attempt, error);
+            second?.onStreamRetry?.(attempt, error);
+        },
+        onFirstToken: () => {
+            first?.onFirstToken?.();
+            second?.onFirstToken?.();
+        },
+    };
+}
+function normalizeError(error, classifyError) {
+    if (classifyError) {
+        return classifyError(error);
+    }
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}
+class AsyncEventQueue {
+    queue = [];
+    resolvers = [];
+    closed = false;
+    push(value) {
+        if (this.closed) {
+            return;
+        }
+        const resolver = this.resolvers.shift();
+        if (resolver) {
+            resolver({ value, done: false });
+            return;
+        }
+        this.queue.push(value);
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        while (this.resolvers.length > 0) {
+            const resolver = this.resolvers.shift();
+            if (resolver) {
+                resolver({ value: undefined, done: true });
+            }
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length > 0) {
+                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                }
+                if (this.closed) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => this.resolvers.push(resolve));
+            },
+        };
+    }
+}
+export function createLlmRoundEventStream(options) {
+    const queue = new AsyncEventQueue();
+    const baseHooks = options.hooks;
+    const hooks = {
+        onText: (text) => {
+            queue.push({ type: 'text', text });
+            baseHooks?.onText?.(text);
+        },
+        onThinking: (thinking) => {
+            queue.push({ type: 'thinking', thinking });
+            baseHooks?.onThinking?.(thinking);
+        },
+        onToolCall: (toolCall) => {
+            queue.push({ type: 'tool_call', toolCall });
+            baseHooks?.onToolCall?.(toolCall);
+        },
+        onToolCallDelta: (delta) => {
+            queue.push({ type: 'tool_call_delta', delta });
+            baseHooks?.onToolCallDelta?.(delta);
+        },
+        onUsage: (usage) => {
+            queue.push({ type: 'usage', usage });
+            baseHooks?.onUsage?.(usage);
+        },
+        onProgress: (progress) => {
+            queue.push({ type: 'progress', progress });
+            baseHooks?.onProgress?.(progress);
+        },
+        onRetry: (attempt, error) => {
+            queue.push({ type: 'retry', attempt, error });
+            baseHooks?.onRetry?.(attempt, error);
+        },
+        onError: (error) => {
+            queue.push({ type: 'error', error });
+            baseHooks?.onError?.(error);
+        },
+        onStreamRetry: (attempt, error) => {
+            queue.push({ type: 'stream_retry', attempt, error });
+            baseHooks?.onStreamRetry?.(attempt, error);
+        },
+        onFirstToken: () => {
+            queue.push({ type: 'first_token' });
+            baseHooks?.onFirstToken?.();
+        },
+    };
+    const response = executeLlmRound({ ...options, hooks })
+        .catch((error) => {
+        const normalized = normalizeError(error, options.classifyError);
+        queue.push({ type: 'error', error: normalized });
+        throw error;
+    })
+        .finally(() => {
+        queue.close();
+    });
+    return { events: queue, response };
+}
+export function createEventStreamClient(options) {
+    const createCall = (params) => createLlmRoundEventStream({
+        actorLabel: options.actorLabel,
+        llm: options.llm,
+        messages: params.messages,
+        model: params.model,
+        tools: params.tools,
+        streamingEnabled: true,
+        signal: params.signal,
+        classifyError: options.classifyError,
+        gatewayContext: options.gatewayContext,
+        generateOptions: {
+            maxTokens: params.maxTokens,
+            sampling: params.sampling,
+        },
+    });
+    const makeCall = async (params, callbacks) => {
+        const mergedHooks = chainHooks(options.hooks, hooksFromStreamCallbacks(callbacks));
+        const { events, response } = createCall(params);
+        const consume = consumeLlmRoundEvents(events, mergedHooks, { signal: params.signal });
+        const result = await response;
+        await consume;
+        return result;
+    };
+    return {
+        generateContent: async (params) => {
+            return makeCall(params);
+        },
+        generateContentStream: async function* (params, callbacks) {
+            const mergedHooks = chainHooks(options.hooks, hooksFromStreamCallbacks(callbacks));
+            const { events, response } = createCall(params);
+            try {
+                for await (const event of events) {
+                    if (event.type === 'text') {
+                        mergedHooks?.onText?.(event.text);
+                        yield { type: 'text', text: event.text };
+                    }
+                    else if (event.type === 'thinking') {
+                        mergedHooks?.onThinking?.(event.thinking);
+                        yield { type: 'thinking', text: event.thinking };
+                    }
+                    else if (event.type === 'tool_call') {
+                        mergedHooks?.onToolCall?.(event.toolCall);
+                        yield { type: 'tool_call', toolCall: event.toolCall };
+                    }
+                    else if (event.type === 'tool_call_delta') {
+                        mergedHooks?.onToolCallDelta?.(event.delta);
+                        yield { type: 'tool_call_delta', delta: event.delta };
+                    }
+                    else if (event.type === 'usage') {
+                        mergedHooks?.onUsage?.(event.usage);
+                        yield { type: 'usage', usage: event.usage };
+                    }
+                    else if (event.type === 'retry') {
+                        mergedHooks?.onRetry?.(event.attempt, event.error);
+                    }
+                    else if (event.type === 'stream_retry') {
+                        mergedHooks?.onStreamRetry?.(event.attempt, event.error);
+                    }
+                    else if (event.type === 'first_token') {
+                        mergedHooks?.onFirstToken?.();
+                    }
+                    else if (event.type === 'progress') {
+                        mergedHooks?.onProgress?.(event.progress);
+                    }
+                    else if (event.type === 'error') {
+                        mergedHooks?.onError?.(event.error);
+                        yield { type: 'error', error: event.error };
+                    }
+                }
+                return await response;
+            }
+            catch (error) {
+                try {
+                    await response;
+                }
+                catch { /* preserve original stream error */ }
+                throw error;
+            }
+        },
+        generateContentWithCallbacks: async (params, callbacks) => {
+            return makeCall(params, callbacks);
+        },
+        countTokens: (params) => options.llm.countTokens(params),
+        close: () => options.llm.close(),
+    };
+}
+export async function consumeLlmRoundEvents(events, hooks, options) {
+    const signal = options?.signal;
+    if (signal?.aborted) {
+        return;
+    }
+    const iterator = events[Symbol.asyncIterator]();
+    const abortPromise = signal
+        ? new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve({ value: undefined, done: true });
+                return;
+            }
+            const onAbort = () => {
+                resolve({ value: undefined, done: true });
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+        })
+        : null;
+    const nextEvent = async () => {
+        if (!signal) {
+            return iterator.next();
+        }
+        if (signal.aborted) {
+            return { value: undefined, done: true };
+        }
+        return abortPromise ? Promise.race([iterator.next(), abortPromise]) : iterator.next();
+    };
+    const closeIterator = async () => {
+        if (typeof iterator.return === 'function') {
+            try {
+                await iterator.return();
+            }
+            catch {
+                // Ignore iterator close failures on abort.
+            }
+        }
+    };
+    if (!hooks) {
+        while (true) {
+            const result = await nextEvent();
+            if (result.done) {
+                break;
+            }
+        }
+        if (signal?.aborted) {
+            await closeIterator();
+        }
+        return;
+    }
+    while (true) {
+        const result = await nextEvent();
+        if (result.done) {
+            break;
+        }
+        const event = result.value;
+        // Check abort again after receiving event (handles queued events)
+        if (signal?.aborted) {
+            break;
+        }
+        if (event.type === 'text') {
+            hooks.onText?.(event.text);
+        }
+        else if (event.type === 'thinking') {
+            hooks.onThinking?.(event.thinking);
+        }
+        else if (event.type === 'tool_call') {
+            hooks.onToolCall?.(event.toolCall);
+        }
+        else if (event.type === 'tool_call_delta') {
+            hooks.onToolCallDelta?.(event.delta);
+        }
+        else if (event.type === 'usage') {
+            hooks.onUsage?.(event.usage);
+        }
+        else if (event.type === 'progress') {
+            hooks.onProgress?.(event.progress);
+        }
+        else if (event.type === 'retry') {
+            hooks.onRetry?.(event.attempt, event.error);
+        }
+        else if (event.type === 'stream_retry') {
+            hooks.onStreamRetry?.(event.attempt, event.error);
+        }
+        else if (event.type === 'first_token') {
+            hooks.onFirstToken?.();
+        }
+        else if (event.type === 'error') {
+            hooks.onError?.(event.error);
+        }
+    }
+    if (signal?.aborted) {
+        await closeIterator();
+    }
+}
+export async function executeLlmRound(options) {
+    const { actorLabel, llm, messages, model, tools, streamingEnabled, signal, classifyError, hooks, gatewayContext, generateOptions, } = options;
+    const callbacks = {
+        onText: hooks?.onText,
+        onThinking: hooks?.onThinking,
+        onToolCall: hooks?.onToolCall,
+        onToolCallDelta: hooks?.onToolCallDelta,
+        onUsage: hooks?.onUsage,
+        onProgress: hooks?.onProgress,
+        onRetry: hooks?.onRetry
+            ? (attempt, error) => hooks.onRetry?.(attempt, normalizeError(error, classifyError))
+            : undefined,
+        onError: hooks?.onError
+            ? (error) => hooks.onError?.(normalizeError(error, classifyError))
+            : undefined,
+        onStreamRetry: hooks?.onStreamRetry
+            ? (attempt, error) => hooks.onStreamRetry?.(attempt, normalizeError(error, classifyError))
+            : undefined,
+        onFirstToken: hooks?.onFirstToken,
+    };
+    const guard = createLlmGuard({
+        actorLabel,
+    });
+    return guard.call(llm, messages, model, tools, streamingEnabled, signal, callbacks, {
+        actorLabel,
+        requestedModel: model,
+        ...gatewayContext,
+    }, generateOptions);
+}
+//# sourceMappingURL=LlmRoundExecutor.js.map

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * LlmStreamHooks — 把 LLM 流式回调（onText / onThinking / onToolCall /
+ * onToolCallDelta / onProgress / onRetry）统一桥接到 EventEmitter。
+ *
+ * 历史上 Leader（LeaderThinkingEngine）和 Worker（BaseAgent）各有 ~80 行回
+ * 调样板，且 BaseAgent.conclude 还有第三份只接 onText 的简化版本。三处通过
+ * scope 区分事件前缀（leader:* / agent:*），但事件 payload 形状相同；本工
+ * 厂收口这部分样板。
+ *
+ * 用法：
+ * ```ts
+ * const buffers = createStreamHookBuffers({ scope: 'agent', emitter, ... });
+ * const hooks = wrapLlmHooksForEmitter({ scope: 'agent', emitter, ... }, buffers);
+ * await guard.call(llm, ..., hooks);
+ * buffers.flushAll();
+ * buffers.dispose();
+ * ```
+ */
+import type { EventEmitter } from '../../core/EventEmitter.js';
+import type { StreamCallbacks } from '../../llm/types.js';
+import { type StreamChunkBuffer } from './StreamChunkBuffer.js';
+export type LlmHookScope = 'leader' | 'agent';
+export interface LlmHookContext {
+    scope: LlmHookScope;
+    emitter: EventEmitter;
+    sessionId: string;
+    /** Leader 不需要；Worker 必填 */
+    agentId?: string;
+    /** Leader 不需要；Worker 必填 */
+    agentName?: string;
+}
+export interface StreamHookBuffers {
+    textBuffer: StreamChunkBuffer;
+    thinkingBuffer: StreamChunkBuffer;
+    flushAll(): void;
+    resetAll(): void;
+    dispose(): void;
+}
+export interface CreateStreamHookBuffersOptions extends LlmHookContext {
+    flushThreshold: number;
+    /** 仅 Worker 用：BaseAgent.onStreamChunk 是 Wiki 等下游订阅者的原始 chunk 直通 */
+    onRawTextChunk?: (chunk: string) => void;
+}
+/** 创建 text/thinking 两条 chunk buffer，绑定到对应事件 */
+export declare function createStreamHookBuffers(opts: CreateStreamHookBuffersOptions): StreamHookBuffers;
+export interface WrapLlmHooksOptions extends LlmHookContext {
+    /** 透传到 onText：Wiki 等下游的原始 chunk 订阅 */
+    onRawTextChunk?: (chunk: string) => void;
+    /** 工具调用日志记录器（leaderLogger / agentLogger.debug） */
+    logToolCall?: (name: string) => void;
+}
+/**
+ * 把 emitter 桥接成一组 StreamCallbacks。
+ * - text / thinking 走传入的 buffers
+ * - tool_call / tool_call_delta / progress / retry 直接 emit
+ * - retry 时同步 reset 两条 buffer，保证半截输出不被拼到下一次 attempt 前
+ */
+export declare function wrapLlmHooksForEmitter(ctx: WrapLlmHooksOptions, buffers: StreamHookBuffers): StreamCallbacks;
+//# sourceMappingURL=LlmStreamHooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LlmStreamHooks.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/LlmStreamHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,oBAAoB,CAAC;AAEvF,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAYzF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAqB9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,iBAAiB,CAAC;IAClC,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;IACjB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,8BAA+B,SAAQ,cAAc;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,8BAA8B,GAAG,iBAAiB,CA+B/F;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE,iBAAiB,GACzB,eAAe,CAmEjB"}

package/dist/agents/runtime/LlmStreamHooks.js

@@ -0,0 +1,140 @@
+/**
+ * LlmStreamHooks — 把 LLM 流式回调（onText / onThinking / onToolCall /
+ * onToolCallDelta / onProgress / onRetry）统一桥接到 EventEmitter。
+ *
+ * 历史上 Leader（LeaderThinkingEngine）和 Worker（BaseAgent）各有 ~80 行回
+ * 调样板，且 BaseAgent.conclude 还有第三份只接 onText 的简化版本。三处通过
+ * scope 区分事件前缀（leader:* / agent:*），但事件 payload 形状相同；本工
+ * 厂收口这部分样板。
+ *
+ * 用法：
+ * ```ts
+ * const buffers = createStreamHookBuffers({ scope: 'agent', emitter, ... });
+ * const hooks = wrapLlmHooksForEmitter({ scope: 'agent', emitter, ... }, buffers);
+ * await guard.call(llm, ..., hooks);
+ * buffers.flushAll();
+ * buffers.dispose();
+ * ```
+ */
+import { classifyLLMError, formatLLMErrorLabel } from '../../llm/errors.js';
+import { createStreamChunkBuffer } from './StreamChunkBuffer.js';
+/** 安全 emit：吞掉订阅者抛出的异常，避免一个坏 listener 炸掉整条流 */
+function safeEmit(emitter, event, payload) {
+    try {
+        // Dynamic event dispatch — event name is constructed at runtime from scope+base
+        emitter.emit(event, payload);
+    }
+    catch {
+        // 订阅者错误不应影响流处理
+    }
+}
+/**
+ * 根据 scope 确定性地组装 event name 和 payload 后 emit。
+ * - leader → event = "leader:{eventBase}", payload = { sessionId, ...extra }
+ * - agent  → event = "agent:{eventBase}",  payload = { agentId, agentName, sessionId, ...extra }
+ */
+function emitScoped(emitter, scope, ctx, eventBase, extra) {
+    const event = `${scope}:${eventBase}`;
+    const base = scope === 'leader'
+        ? { sessionId: ctx.sessionId }
+        : { agentId: ctx.agentId, agentName: ctx.agentName, sessionId: ctx.sessionId };
+    safeEmit(emitter, event, { ...base, ...extra });
+}
+/** 创建 text/thinking 两条 chunk buffer，绑定到对应事件 */
+export function createStreamHookBuffers(opts) {
+    const { scope, emitter, sessionId, agentId, agentName, flushThreshold } = opts;
+    const ctx = { sessionId, agentId, agentName };
+    const textBuffer = createStreamChunkBuffer({
+        flushThreshold,
+        onFlush: (chunk) => emitScoped(emitter, scope, ctx, 'text_chunk', { chunk }),
+    });
+    const thinkingBuffer = createStreamChunkBuffer({
+        flushThreshold,
+        onFlush: (chunk) => emitScoped(emitter, scope, ctx, 'thinking_chunk', { chunk }),
+    });
+    return {
+        textBuffer,
+        thinkingBuffer,
+        flushAll() {
+            textBuffer.flush();
+            thinkingBuffer.flush();
+        },
+        resetAll() {
+            textBuffer.reset();
+            thinkingBuffer.reset();
+        },
+        dispose() {
+            textBuffer.dispose();
+            thinkingBuffer.dispose();
+        },
+    };
+}
+/**
+ * 把 emitter 桥接成一组 StreamCallbacks。
+ * - text / thinking 走传入的 buffers
+ * - tool_call / tool_call_delta / progress / retry 直接 emit
+ * - retry 时同步 reset 两条 buffer，保证半截输出不被拼到下一次 attempt 前
+ */
+export function wrapLlmHooksForEmitter(ctx, buffers) {
+    const { scope, emitter, sessionId, agentId, agentName, onRawTextChunk, logToolCall } = ctx;
+    const scopeCtx = { sessionId, agentId, agentName };
+    const onText = (text) => {
+        buffers.textBuffer.append(text);
+        if (onRawTextChunk)
+            onRawTextChunk(text);
+    };
+    const onThinking = (thinking) => {
+        buffers.thinkingBuffer.append(thinking);
+    };
+    const onToolCall = (tc) => {
+        if (logToolCall)
+            logToolCall(tc.function.name);
+        emitScoped(emitter, scope, scopeCtx, 'tool_call', {
+            tool: tc.function.name,
+            input: tc.function.arguments,
+            callId: tc.id,
+        });
+    };
+    const onToolCallDelta = (delta) => {
+        // Leader-only: 首次收到某工具的 delta 时 emit phase_change 让前端显示人类友好文案
+        if (scope === 'leader' && delta.name) {
+            safeEmit(emitter, 'leader:phase_change', { sessionId, phase: 'streaming', streamingToolName: delta.name });
+        }
+        emitScoped(emitter, scope, scopeCtx, 'tool_call_delta', {
+            index: delta.index,
+            callId: delta.id,
+            tool: delta.name,
+            partialJson: delta.partialJson,
+        });
+    };
+    const onProgress = (progress) => {
+        emitScoped(emitter, scope, scopeCtx, 'status', { status: progress.status });
+    };
+    const onRetry = (attempt, error) => {
+        const classified = classifyLLMError(error);
+        // 重试前 reset 流缓冲：与前端 canonical *_llm_retry 处理保持一致，
+        // 否则下次 attempt 会拼到半截 assistant 消息前面。
+        buffers.resetAll();
+        // Leader-only: 推 phase_change=retrying
+        if (scope === 'leader') {
+            safeEmit(emitter, 'leader:phase_change', { sessionId, phase: 'retrying' });
+        }
+        emitScoped(emitter, scope, scopeCtx, 'llm_retry', {
+            attempt,
+            message: classified.message,
+            errorKind: classified.llmErrorKind,
+            retryable: classified.retryable,
+        });
+        emitScoped(emitter, scope, scopeCtx, 'status', {
+            status: `LLM ${formatLLMErrorLabel(classified)}，第 ${attempt} 次重试: ${classified.message}`,
+        });
+    };
+    const onFirstToken = () => {
+        if (scope === 'leader') {
+            safeEmit(emitter, 'leader:phase_change', { sessionId, phase: 'streaming' });
+        }
+        // Worker 不需要推 phase_change（前端通过 agent:text_chunk 感知）
+    };
+    return { onText, onThinking, onToolCall, onToolCallDelta, onProgress, onRetry, onFirstToken };
+}
+//# sourceMappingURL=LlmStreamHooks.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { type VerificationGateConfig, type VerificationResult } from '../../core/VerificationPipeline.js';
+import type { WorkerArtifactTrace } from '../../core/AgentProtocol.js';
+export interface CompletionVerificationInput {
+    workingDir: string;
+    artifacts?: WorkerArtifactTrace;
+    toolTrace?: WorkerArtifactTrace;
+}
+export declare function collectCompletionChangedFiles(input: {
+    artifacts?: WorkerArtifactTrace;
+    toolTrace?: WorkerArtifactTrace;
+}): string[];
+/**
+ * 用 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 declare function collectGitChangedFiles(workingDir: string): string[];
+export declare function resolveVerificationGateConfig(): Partial<VerificationGateConfig>;
+export declare function runCompletionVerification(input: CompletionVerificationInput): Promise<VerificationResult | undefined>;
+//# sourceMappingURL=MandatoryVerification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MandatoryVerification.d.ts","sourceRoot":"","sources":["../../../src/agents/runtime/MandatoryVerification.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwB,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAChI,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAOvE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAiBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC,GAAG,MAAM,EAAE,CAeX;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAcnE;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAU/E;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAkCzC"}