@p-dsh-market/conversation-knowledge-map 0.1.3 → 0.1.4

package/README.md

@@ -15,7 +15,7 @@ DSH 的“知识视图”插件，把同一工作路径下用户明确选择的
 
 ## 生成失败诊断
 
-Host 和生成编排器会输出带 `[conversation-knowledge-map]` 前缀的诊断日志。日志包含路由、Provider / Model、Agent Session、实时事件类型、surface/session 读取次数、提取文本长度、输出形状和错误原因，不记录 Prompt、对话正文或模型返回正文。优先查看 DSH Web Runtime 的终端日志；若 Runtime 提供 logger 服务，则同时写入该 logger。重点关注 `agent event`、`agent idle`、`agent surface read`、`agent session read` 和 `agent output parse failed`。
+Host 和生成编排器会输出带 `[conversation-knowledge-map]` 前缀的诊断日志。日志包含路由、Provider / Model、Agent Session、实时事件类型、surface/session 读取次数、提取文本长度、输出形状和错误原因，不记录 Prompt、对话正文或模型返回正文。优先查看 DSH Web Runtime 的终端日志；若 Runtime 提供 logger 服务，则同时写入该 logger。重点关注 `agent event`、`agent idle`、`agent turn failure`、`agent surface read`、`agent session read` 和 `agent output parse failed`。Runtime 在 `turn/end.reason.kind = error` 时会优先显示其 `code/message`；只有未发现 turn 错误且确实没有助手输出时，才会报告“模型没有返回 JSON 对象”。
 
 ## 本地验证
 

package/lib/generation-orchestrator.js

@@ -235,6 +235,38 @@ function extractAgentText(surface) {
   return chunks.join('')
 }
 
+function agentTurnError(event) {
+  if (String(event?.type || '') !== 'turn/end') return null
+  const data = event?.data && typeof event.data === 'object' ? event.data : {}
+  const reason = data.reason && typeof data.reason === 'object' ? data.reason : null
+  if (reason?.kind !== 'error') return null
+  const nestedError = reason.error && typeof reason.error === 'object' ? reason.error : null
+  const code = String(nestedError?.code || reason.code || '').trim()
+  const message = String(nestedError?.message || reason.message || (typeof reason.error === 'string' ? reason.error : '')).trim()
+  const detail = shortText(message || 'Agent turn 执行失败。', 1200)
+  const error = new Error(`Agent Runtime 生成失败${code ? `（${code}）` : ''}：${detail}`)
+  error.code = code
+  error.agentTurn = true
+  error.cause = nestedError || reason
+  return error
+}
+
+function findAgentTurnError(surface) {
+  const events = Array.isArray(surface?.events) ? surface.events : []
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    const error = agentTurnError(events[index])
+    if (error) return error
+  }
+  return null
+}
+
+function wrapAgentRuntimeError(error) {
+  if (error?.agentTurn || /^Agent Runtime 生成失败/.test(errorMessage(error))) return error
+  const wrapped = new Error(`Agent Runtime 生成失败：${errorMessage(error)}`)
+  wrapped.cause = error
+  return wrapped
+}
+
 async function readAgentText(sessionQuery, sessionId, signal, { logger, diagnostics } = {}) {
   const stats = diagnostics || { surfaceReads: 0, sessionReads: 0 }
   for (let attempt = 0; attempt < 6; attempt += 1) {
@@ -247,6 +279,13 @@ async function readAgentText(sessionQuery, sessionId, signal, { logger, diagnost
     stats.lastSurfaceShape = diagnosticSummary(surface)
     stats.lastSurfaceTextLength = text.length
     logMessage(logger, 'info', 'agent surface read session=%s attempt=%d events=%d extractedTextLength=%d shape=%s', logId(sessionId), attempt + 1, eventCount, text.length, stats.lastSurfaceShape)
+    const surfaceError = findAgentTurnError(surface)
+    if (surfaceError) {
+      stats.agentFailureSource = 'surface'
+      stats.agentFailureCode = surfaceError.code || ''
+      logMessage(logger, 'error', 'agent turn failure session=%s source=surface code=%s error=%s', logId(sessionId), surfaceError.code || '', errorMessage(surfaceError))
+      throw surfaceError
+    }
     if (text.trim()) return text
     if (attempt < 5) await new Promise((resolve) => setTimeout(resolve, 40 * (attempt + 1)))
   }
@@ -259,6 +298,13 @@ async function readAgentText(sessionQuery, sessionId, signal, { logger, diagnost
     stats.lastSessionShape = diagnosticSummary(log)
     stats.lastSessionTextLength = text.length
     logMessage(logger, 'info', 'agent session read session=%s events=%d extractedTextLength=%d shape=%s', logId(sessionId), eventCount, text.length, stats.lastSessionShape)
+    const sessionError = findAgentTurnError(log)
+    if (sessionError) {
+      stats.agentFailureSource = 'session'
+      stats.agentFailureCode = sessionError.code || ''
+      logMessage(logger, 'error', 'agent turn failure session=%s source=session code=%s error=%s', logId(sessionId), sessionError.code || '', errorMessage(sessionError))
+      throw sessionError
+    }
     if (text.trim()) return text
   }
   return ''
@@ -513,7 +559,10 @@ export class KnowledgeGenerationOrchestrator {
       surfaceReads: 0,
       sessionReads: 0,
       lastSurfaceEventCount: 0,
-      lastSessionEventCount: 0
+      lastSessionEventCount: 0,
+      agentFailureSource: '',
+      agentFailureCode: '',
+      agentFailure: null
     }
     logMessage(this.logger, 'info', 'agent call start kind=%s session=%s provider=%s model=%s promptLength=%d', input.kind, logId(sessionId), provider, model, String(input.prompt || '').length)
     let unsubscribe
@@ -528,6 +577,13 @@ export class KnowledgeGenerationOrchestrator {
           else if (event.type === 'assistant/chunk') diagnostics.liveAssistantChunks += 1
           else diagnostics.liveOtherEvents += 1
           logMessage(this.logger, 'info', 'agent event session=%s type=%s data=%s', logId(sessionId), String(event.type || 'unknown'), diagnosticSummary(event.data))
+          const failure = agentTurnError(event)
+          if (failure && !diagnostics.agentFailure) {
+            diagnostics.agentFailure = failure
+            diagnostics.agentFailureSource = 'live-event'
+            diagnostics.agentFailureCode = failure.code || ''
+            logMessage(this.logger, 'error', 'agent turn failure session=%s source=live-event code=%s error=%s', logId(sessionId), failure.code || '', errorMessage(failure))
+          }
         })
         logMessage(this.logger, 'info', 'agent event subscription ready session=%s', logId(sessionId))
       } catch (error) {
@@ -535,6 +591,7 @@ export class KnowledgeGenerationOrchestrator {
       }
     }
     let handle
+    let stage = 'create'
     try {
       handle = await this.agents.create({
         sessionId,
@@ -552,8 +609,12 @@ export class KnowledgeGenerationOrchestrator {
           } catch { /* older runtimes may not expose tool restriction */ }
         }
       })
+      stage = 'followup'
       handle.agent.followup(makeUserMessage(input.prompt, `${sessionId}-${input.kind}`))
+      stage = 'idle'
       await handle.agent.whenIdle()
+      if (diagnostics.agentFailure) throw diagnostics.agentFailure
+      stage = 'read-output'
       const liveText = extractAgentText({ events: liveEvents })
       logMessage(this.logger, 'info', 'agent idle session=%s liveEvents=%d assistantMessages=%d assistantChunks=%d otherEvents=%d liveTextLength=%d', logId(sessionId), diagnostics.liveEvents, diagnostics.liveAssistantMessages, diagnostics.liveAssistantChunks, diagnostics.liveOtherEvents, liveText.length)
       if (liveText.trim()) return parseModelOutput(liveText, 'live-events', diagnostics)
@@ -561,8 +622,9 @@ export class KnowledgeGenerationOrchestrator {
       logMessage(this.logger, 'info', 'agent persisted output session=%s textLength=%d surfaceReads=%d sessionReads=%d', logId(sessionId), persistedText.length, diagnostics.surfaceReads, diagnostics.sessionReads)
       return parseModelOutput(persistedText, 'persisted-session', diagnostics)
     } catch (error) {
-      logMessage(this.logger, 'error', 'agent call failed kind=%s session=%s liveEvents=%d surfaceReads=%d sessionReads=%d error=%s', input.kind, logId(sessionId), diagnostics.liveEvents, diagnostics.surfaceReads, diagnostics.sessionReads, errorMessage(error))
-      throw error
+      const surfacedError = diagnostics.agentFailure || (stage === 'read-output' ? error : wrapAgentRuntimeError(error))
+      logMessage(this.logger, 'error', 'agent call failed kind=%s session=%s liveEvents=%d surfaceReads=%d sessionReads=%d error=%s', input.kind, logId(sessionId), diagnostics.liveEvents, diagnostics.surfaceReads, diagnostics.sessionReads, errorMessage(surfacedError))
+      throw surfacedError
     } finally {
       if (typeof unsubscribe === 'function') await unsubscribe()
       await handle?.dispose?.()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p-dsh-market/conversation-knowledge-map",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "DSH 多对话思维导图与静态知识图谱",
   "keywords": [
     "dsh",