evolcore 0.0.25 → 0.0.27

package/dist/core/interaction-router.js

@@ -46,6 +46,8 @@ export class InteractionRouter {
             clearTimeout(existing.timer);
         const isReplacement = !!existing;
         const pending = {
+            blocking: opts?.blocking !== false,
+            retainOnRejected: opts?.retainOnRejected === true,
             callback,
             sessionId,
             initiatorId: opts?.initiatorId,
@@ -61,7 +63,8 @@ export class InteractionRouter {
                 if (this.handlers.get(id) !== pending)
                     return;
                 this.handlers.delete(id);
-                this.decPending(pending.sessionId);
+                if (pending.blocking)
+                    this.decPending(pending.sessionId);
                 const cancelReason = opts.timeoutCancelReason ?? 'timeout';
                 logger.debug(`[InteractionRouter] Timeout for interaction: ${id}`);
                 opts.onTimeout?.();
@@ -73,7 +76,9 @@ export class InteractionRouter {
             }, opts.timeoutMs);
         }
         this.handlers.set(id, pending);
-        if (!isReplacement)
+        if (existing?.blocking && (!pending.blocking || existing.sessionId !== sessionId))
+            this.decPending(existing.sessionId);
+        if (pending.blocking && (!isReplacement || !existing?.blocking || existing.sessionId !== sessionId))
             this.incPending(sessionId);
     }
     dispatch(response) {
@@ -104,10 +109,15 @@ export class InteractionRouter {
             // The callback may already have resolved/cancelled this exact handler.
             if (this.handlers.get(response.id) !== handler)
                 return accepted;
+            if (!accepted && handler.retainOnRejected && rejectionReason === 'backend_rejected') {
+                handler.inFlight = false;
+                return false;
+            }
             if (handler.timer)
                 clearTimeout(handler.timer);
             this.handlers.delete(response.id);
-            this.decPending(handler.sessionId);
+            if (handler.blocking)
+                this.decPending(handler.sessionId);
             if (!accepted && handler.onCancel) {
                 Promise.resolve(handler.onCancel(rejectionReason)).catch(err => {
                     logger.error(`[InteractionRouter] Rejection cancellation error for ${response.id}:`, err);
@@ -153,10 +163,13 @@ export class InteractionRouter {
         const pending = [];
         for (const [id, handler] of this.handlers.entries()) {
             if (handler.sessionId === sessionId) {
+                if (!handler.blocking && reason === 'new_message')
+                    continue;
                 if (handler.timer)
                     clearTimeout(handler.timer);
                 this.handlers.delete(id);
-                this.decPending(handler.sessionId);
+                if (handler.blocking)
+                    this.decPending(handler.sessionId);
                 if (reason && handler.onCancel) {
                     pending.push(Promise.resolve(handler.onCancel(reason)).then(() => undefined));
                 }
@@ -170,7 +183,8 @@ export class InteractionRouter {
             if (handler.timer)
                 clearTimeout(handler.timer);
             this.handlers.delete(id);
-            this.decPending(handler.sessionId);
+            if (handler.blocking)
+                this.decPending(handler.sessionId);
             if (reason && handler.onCancel)
                 await handler.onCancel(reason);
             return true;
@@ -208,10 +222,10 @@ export class InteractionRouter {
             return false;
         }
     }
-    getPending(sessionId) {
+    getPending(sessionId, command) {
         const ids = [];
         for (const [id, handler] of this.handlers.entries()) {
-            if (handler.sessionId === sessionId)
+            if (handler.sessionId === sessionId && (!command || handler.fallbackCommand === command))
                 ids.push(id);
         }
         return ids;
@@ -281,7 +295,7 @@ export function renderActionAsText(req) {
     if (fb.acceptFreeText && fb.freeTextHint) {
         lines.push(`  ${fb.freeTextHint}`);
     }
-    if (action.allowCustomInput) {
+    if (action.allowCustomInput && req.blocking !== false) {
         lines.push(`  或直接输入自定义内容`);
     }
     return lines.join('\n');

package/dist/core/message/im-renderer.js

@@ -1,7 +1,9 @@
 import { logger } from '../../utils/logger.js';
-import { summarizeToolInput, toolInputForDisplay } from '../../utils/tool-summary.js';
+import { summarizeToolInput, summarizeToolInputForDisplay, toolInputForDisplay } from '../../utils/tool-summary.js';
 import { getErrorMessage, isContextTooLongText } from '../../utils/error-utils.js';
+import { tagErrorTextWithEvolcoreVersion } from '../../utils/evolcore-version.js';
 import { DEFAULT_FLUSH_DELAY_MS } from '../../types.js';
+import { classifyAunToolErrorCode } from '../permission/tool-error-code.js';
 export class IMRenderer {
     opts;
     itemsQueue = [];
@@ -18,6 +20,7 @@ export class IMRenderer {
     hasEmittedText = false;
     /** 自增 callId 兜底（runner 没提供时用） */
     syntheticCallSeq = 0;
+    currentAssistantUuid;
     constructor(opts) {
         this.opts = opts;
     }
@@ -60,12 +63,12 @@ export class IMRenderer {
         // interactive 模式由 MessageProcessor 显式调 addText/addToolCall/... 推入 items
     }
     /** 强制刷新所有 pending 事件 */
-    async flush(isFinal) {
+    async flush(isFinal, attention) {
         if (this.opts.envelope.chatmode === 'proactive') {
             // proactive 是 fire-and-forget，无 pending buffer
             return;
         }
-        return this.flushInternal(isFinal);
+        return this.flushInternal(isFinal, attention);
     }
     /** 仅 flush activities，保留 textBuffer（用于中间 complete 事件） */
     async flushActivitiesOnly() {
@@ -79,9 +82,9 @@ export class IMRenderer {
     }
     /** 是否有会抑制兜底错误消息的正文/过程内容；lifecycle 边界不算。 */
     hasNonLifecycleContent() {
-        return this.textBuffer.length > 0 || this.itemsQueue.some(it => {
+        return this.textBuffer.trim().length > 0 || this.itemsQueue.some(it => {
             if (it.kind === 'text')
-                return it.text.length > 0;
+                return it.text.trim().length > 0;
             return it.kind !== 'started' && it.kind !== 'completed';
         });
     }
@@ -95,6 +98,21 @@ export class IMRenderer {
             return;
         if (this.textBuffer.length === 0)
             return;
+        // 文件标记过滤后若只剩空白，应立即消费并告警；尤其避免 final-only
+        // 模式把工具调用前的空白继续带到最终回复。
+        const rawText = this.opts.fileMarkerPattern
+            ? this.textBuffer.replace(this.opts.fileMarkerPattern, '')
+            : this.textBuffer;
+        if (!rawText.trim()) {
+            if (this.timer) {
+                clearTimeout(this.timer);
+                this.timer = undefined;
+            }
+            this.textBuffer = '';
+            this.itemsQueue = this.itemsQueue.filter(it => it.kind !== 'text');
+            this.hasSendableText(rawText, 'flushText');
+            return;
+        }
         if (this.suppressIntermediateText()) {
             this.itemsQueue = this.itemsQueue.filter(it => it.kind !== 'text');
             return;
@@ -103,16 +121,15 @@ export class IMRenderer {
             clearTimeout(this.timer);
             this.timer = undefined;
         }
-        // 文件标记过滤：tool_use 前的文本块也不能把 marker 暴露给用户
-        const rawText = this.opts.fileMarkerPattern
-            ? this.textBuffer.replace(this.opts.fileMarkerPattern, '')
-            : this.textBuffer;
         this.textBuffer = '';
-        if (!rawText)
-            return;
-        // 清掉 itemsQueue 中的 text items（已发出）
+        // 清掉已消费的 text items，包括被拦截的纯空白正文。
         this.itemsQueue = this.itemsQueue.filter(it => it.kind !== 'text');
-        const payload = { kind: 'result.text', text: rawText, isFinal: false };
+        const payload = {
+            kind: 'result.text',
+            text: rawText,
+            isFinal: false,
+            ...this.forkAnchorMetadata(),
+        };
         this.sentContent = true;
         try {
             await this.sendPayload(payload);
@@ -158,12 +175,18 @@ export class IMRenderer {
     }
     // ── 文本/活动注入（替代 StreamFlusher.addText/addActivity）──
     /** 添加文本片段（流式 text） */
-    addText(text, outputTokens, turn) {
+    async addText(text, outputTokens, turn, assistantUuid) {
         if (this.opts.envelope.chatmode === 'proactive')
             return;
+        if (this.textBuffer && this.currentAssistantUuid !== assistantUuid && !this.suppressIntermediateText()) {
+            await this.flushText();
+        }
+        // Do not carry the previous item's anchor onto unanchored output.
+        this.currentAssistantUuid = assistantUuid;
         this.emitProgress('text', outputTokens, turn);
         if (!text)
             return;
+        // 保留流式片段之间的空格/换行；仅在发送完整正文时判定是否纯空白。
         // 同一窗口内连续 text delta 合并到最后一个 text item
         const last = this.itemsQueue[this.itemsQueue.length - 1];
         if (last && last.kind === 'text') {
@@ -184,18 +207,19 @@ export class IMRenderer {
         this.emitProgress('tool_call', outputTokens, turn, { toolName: name, callId });
         if (this.suppressActivityItems())
             return;
+        const displayInput = toolInputForDisplay(name, input);
         this.itemsQueue.push({
             kind: 'tool_call',
             call_id: callId || this.synthCallId(),
             name,
-            arguments: toolInputForDisplay(name, input),
-            text: descText,
+            arguments: displayInput,
+            text: displayInput !== input ? summarizeToolInput(name, displayInput || {}) : descText,
         });
         this.messageTimestamps.push(Date.now());
         this.scheduleFlush();
     }
     /** 添加工具结果 */
-    addToolResult(name, ok, result, error, callId, durationMs, descText) {
+    addToolResult(name, ok, result, error, callId, durationMs, descText, classification) {
         if (this.opts.envelope.chatmode === 'proactive')
             return;
         this.emitProgress('tool_result', undefined, undefined, { toolName: name, callId, ok, durationMs });
@@ -208,6 +232,7 @@ export class IMRenderer {
             ok,
             ...(result !== undefined && { result }),
             ...(error !== undefined && { error }),
+            ...(!ok && { error_code: classifyAunToolErrorCode(classification ?? {}) }),
             ...(durationMs !== undefined && { duration_ms: durationMs }),
             ...(descText !== undefined && { text: descText }),
         });
@@ -249,6 +274,19 @@ export class IMRenderer {
             logger.warn(`[IMRenderer] status notice send failed: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    /** Notify the client that a new model text block has started. */
+    async sendTextStart(contentIndex, turn) {
+        const payload = {
+            kind: 'status.progress',
+            metadata: { activityType: 'text', kind: 'text_start', contentIndex, turn },
+        };
+        try {
+            await this.opts.send(payload);
+        }
+        catch (error) {
+            logger.debug(`[IMRenderer] text_start status send failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
     /** 兼容旧调用方：发送 warning 级别的任务 notice。 */
     async sendWarningStatus(message, subtype, details) {
         return this.sendStatusNotice(message, 'warn', subtype, details);
@@ -302,9 +340,15 @@ export class IMRenderer {
     async sendOperationalNoticeAsText(text) {
         if (!this.opts.operationalNoticesAsText || this.opts.envelope.chatmode === 'proactive' || !text)
             return false;
+        if (!this.hasSendableText(text, 'operational-notice'))
+            return false;
         // 保持与流式正文的到达顺序：先发出已缓冲的正文，再投影运行状态。
         await this.flushText();
-        const payload = { kind: 'result.text', text, isFinal: false };
+        const payload = {
+            kind: 'result.text',
+            text,
+            isFinal: false,
+        };
         this.sentContent = true;
         await this.sendPayload(payload);
         this.lastFlush = Date.now();
@@ -315,6 +359,17 @@ export class IMRenderer {
     synthCallId() {
         return `synth-${this.opts.envelope.taskId}-${++this.syntheticCallSeq}`;
     }
+    /** Reject blank bodies before sending, without trimming meaningful formatting. */
+    hasSendableText(text, source) {
+        if (text.trim())
+            return true;
+        // An unused buffer is normal. A nonempty whitespace body is diagnostic evidence.
+        if (text.length > 0) {
+            const { envelope, agentAid } = this.opts;
+            logger.warn(`[IMRenderer] Attempted to send empty message, skipping: code=EMPTY_MESSAGE source=${source} task=${envelope.taskId} session=${envelope.sessionId ?? '<none>'} agent=${agentAid ?? envelope.agentName} textLength=${text.length} text=${JSON.stringify(text.slice(0, 80))}`);
+        }
+        return false;
+    }
     /** Convert a structured failed receipt into the same error shape as a rejected sender. */
     receiptError(receipt) {
         return Object.assign(new Error(receipt.error), {
@@ -331,6 +386,18 @@ export class IMRenderer {
             : undefined;
         return value.code === 'OUTBOX_FULL' || cause?.code === 'OUTBOX_FULL';
     }
+    isPermanentActivityError(error) {
+        const value = error && typeof error === 'object' ? error : {};
+        const cause = value.cause && typeof value.cause === 'object'
+            ? value.cause
+            : undefined;
+        const code = String(value.code ?? cause?.code ?? '');
+        return value.permanent === true
+            || value.status === 'failed'
+            || code === 'AUN_SEND_FAILED'
+            || code === '-1'
+            || /payload is too large/i.test(String(value.message ?? value.error ?? ''));
+    }
     /**
      * Serialize durable sends while keeping the chain usable after a rejected
      * operation. Activity queue saturation is best-effort: it is logged, but
@@ -344,9 +411,19 @@ export class IMRenderer {
             }
         });
         const handled = operation.catch(error => {
-            if (payload.kind === 'activity.batch' && this.isOutboxFull(error)) {
-                logger.warn(`[IMRenderer] activity outbox full; continuing without activity batch: ${error instanceof Error ? error.message : String(error)}`);
-                return;
+            if (payload.kind === 'activity.batch') {
+                const detail = error instanceof Error ? error.message : String(error);
+                if (this.isOutboxFull(error)) {
+                    logger.warn(`[IMRenderer] activity outbox full; continuing without activity batch: ${detail}`);
+                    return;
+                }
+                if (this.isPermanentActivityError(error)) {
+                    // Activity is best-effort. A permanent structured-send failure (for
+                    // example an AUN payload-size rejection) must not requeue the same
+                    // item indefinitely or prevent the final result.text from flushing.
+                    logger.warn(`[IMRenderer] activity delivery failed; dropping activity batch and continuing: ${detail}`);
+                    return;
+                }
             }
             throw error;
         });
@@ -424,7 +501,7 @@ export class IMRenderer {
      * 完整 flush：把 itemsQueue 里所有 items 打包成 activity.batch 发送。
      * 如果 isFinal=true，还会在 batch 之后单独发一条 result.text 作为最终回复。
      */
-    async flushInternal(isFinal) {
+    async flushInternal(isFinal, attention) {
         if (this.timer) {
             clearTimeout(this.timer);
             this.timer = undefined;
@@ -432,26 +509,30 @@ export class IMRenderer {
         // 文件标记过滤：marker 任何时候都不该出现在用户文本里，必须在 *每次* flush
         // （含非最终的定时 flush）执行。否则文本块若滞留 buffer 后被定时器触发，会走
         // 下方非-final 的 result.text 路径，把 [SEND_FILE:...] 原样发给用户。
-        // 非最终 flush 不做 trim，避免 trim 掉 Markdown 块级换行。
+        // 先保留空白，以便空正文告警仍能记录原长度。
         if (this.opts.fileMarkerPattern) {
-            const strip = (s) => {
-                const replaced = s.replace(this.opts.fileMarkerPattern, '');
-                return isFinal ? replaced.trim() : replaced;
-            };
-            this.textBuffer = strip(this.textBuffer);
+            this.textBuffer = this.textBuffer.replace(this.opts.fileMarkerPattern, '');
             for (const item of this.itemsQueue) {
                 if (item.kind === 'text')
                     item.text = item.text.replace(this.opts.fileMarkerPattern, '');
             }
         }
+        if (!this.hasSendableText(this.textBuffer, isFinal ? 'final' : 'flush')) {
+            this.textBuffer = '';
+        }
+        else if (isFinal && this.opts.fileMarkerPattern) {
+            // 保持既有最终文件标记过滤语义；中间文本的格式原样保留。
+            this.textBuffer = this.textBuffer.trim();
+        }
         // 清掉空 text items
         const items = this.itemsQueue.filter(it => {
             if (it.kind === 'text')
-                return it.text.length > 0;
+                return it.text.trim().length > 0;
             return true;
         });
         this.itemsQueue = [];
         const finalText = isFinal ? this.textBuffer : '';
+        const finalAnchor = this.forkAnchorMetadata();
         if (isFinal)
             this.textBuffer = '';
         // 1. interactive 模式下：不发 text items（由 result.text 统一发送最终文本）
@@ -483,7 +564,12 @@ export class IMRenderer {
                 return;
             const text = this.textBuffer;
             this.textBuffer = '';
-            const payload = { kind: 'result.text', text, isFinal: false };
+            const payload = {
+                kind: 'result.text',
+                text,
+                isFinal: false,
+                ...this.forkAnchorMetadata(),
+            };
             this.sentContent = true;
             try {
                 await this.sendPayload(payload);
@@ -497,7 +583,14 @@ export class IMRenderer {
         }
         // 2. isFinal=true 时单独发最终回复文本
         if (isFinal && finalText.length > 0) {
-            const payload = { kind: 'result.text', text: finalText, isFinal: true };
+            const payload = {
+                kind: 'result.text',
+                text: finalText,
+                isFinal: true,
+                ...finalAnchor,
+            };
+            if (attention !== undefined)
+                payload.attention = attention;
             this.sentContent = true;
             try {
                 await this.sendPayload(payload);
@@ -510,6 +603,15 @@ export class IMRenderer {
             this.flushCount++;
         }
     }
+    forkAnchorMetadata() {
+        const assistantMessageId = this.currentAssistantUuid?.trim();
+        if (!assistantMessageId)
+            return {};
+        const anchor = {
+            assistantMessageId,
+        };
+        return { metadata: { forkAnchor: anchor } };
+    }
     // ── 内部：status.progress 发送 ──
     emitProgress(activityType, outputTokens, turn, extra) {
         if (this.suppressActivityItems())
@@ -543,6 +645,15 @@ export class IMRenderer {
         const item = this.mapEventToItem(event);
         if (!item)
             return;
+        // Proactive output is optional thought content. Blank runner blocks are
+        // normal; keep diagnostics without reporting a failed message send.
+        if ((item.kind === 'text' || (item.kind === 'summary' && !item.is_error)) && !item.text.trim()) {
+            const { envelope, agentAid } = this.opts;
+            logger.debug(`[IMRenderer] Skipping blank proactive thought: kind=${item.kind}`
+                + ` task=${envelope.taskId} session=${envelope.sessionId ?? '<none>'}`
+                + ` agent=${agentAid ?? envelope.agentName} textLength=${item.text.length}`);
+            return;
+        }
         if (item.kind === 'text') {
             this.hasEmittedText = true;
             this.allText += item.text;
@@ -571,7 +682,7 @@ export class IMRenderer {
                     return null;
                 return { kind: 'text', text: event.text };
             case 'tool_use': {
-                const desc = summarizeToolInput(event.name, event.input || {});
+                const desc = summarizeToolInputForDisplay(event.name, event.input || {});
                 const item = {
                     kind: 'tool_call',
                     call_id: event.callId || this.synthCallId(),
@@ -589,6 +700,7 @@ export class IMRenderer {
                         call_id: event.callId || this.synthCallId(),
                         name: event.name,
                         ok: false,
+                        error_code: classifyAunToolErrorCode(event),
                         error: event.error || (typeof event.result === 'string' ? event.result : '执行失败'),
                         ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),
                     };
@@ -633,7 +745,7 @@ export class IMRenderer {
                 if (isContextTooLongText(event.error || ''))
                     return null;
                 const text = getErrorMessage(new Error(event.error || '任务执行失败'), undefined, false);
-                return { kind: 'notice', text, severity: 'warn' };
+                return { kind: 'notice', text: tagErrorTextWithEvolcoreVersion(text), severity: 'warn' };
             }
             case 'complete': {
                 if (event.queryFinal === false)
@@ -650,7 +762,7 @@ export class IMRenderer {
                     const text = getErrorMessage(new Error(errText), event.terminalReason, false);
                     const item = {
                         kind: 'summary',
-                        text,
+                        text: tagErrorTextWithEvolcoreVersion(text),
                         is_error: true,
                     };
                     if (event.subtype !== undefined)