memory-eternal 0.14.3 → 0.16.0

package/lib/capture.js

@@ -190,7 +190,7 @@ function cleanTitleLine(line) {
  * @param llm - dsh 的 llm 服务（ctx.get('llm')）
  * @param route - { provider, model } 解析结果
  * @param conversation - 本轮对话文本（用户+助手）
- * @param opts - { maxTokens, signal, existing }：existing 为 [{path,title,summary}]
+  * @param opts - { maxTokens, signal, existing, sessionId }：existing 为 [{path,title,summary}]；sessionId 透传给 LLM（issue #51）
  * @returns Promise<null | { save:boolean } | { save:true, title, kind, tags, body } | { append_to, update }>
  */
 export async function summarizeTurn(llm, route, conversation, opts = {}) {
@@ -225,6 +225,24 @@ export function isEffortUnsupported(provider, model) { return effortRejected.has
 /** 仅供测试：清空记忆。 */
 export function resetEffortUnsupported() { effortRejected.clear() }
 
+/**
+ * LLM 请求的会话标识（issue #51）。
+ *
+ * 为什么必须有：DSH 的 GenerateOptions 里有官方字段 `sessionId`，opencode-go 之类的网关
+ * **只在拿到它时**才注入 `x-opencode-session` 头；缺了这个头，网关一律 400
+ * `{"type":"MissingSessionID"}` —— 表现就是每一轮自动沉淀的首跳必然失败、白烧一次调用，
+ * 面板长期挂「⚠ 自动沉淀异常」（卡片其实靠换 provider 兜底建出来了）。
+ *
+ * 取值优先级：调用方透传的真实会话 id（同一会话的蒸馏可被网关按会话归并）→ 稳定常量
+ * （网关只要求"有值"，同值同样能复用路由；不要每次生成随机值，否则等于没有会话亲和）。
+ */
+const CAPTURE_LLM_SESSION_ID = 'memory-eternal-capture'
+const REFINE_LLM_SESSION_ID = 'memory-eternal-refine'
+export function resolveLlmSessionId(sessionId, fallback) {
+  const s = String(sessionId ?? '').trim()
+  return s || String(fallback || CAPTURE_LLM_SESSION_ID)
+}
+
 /**
  * 单次 JSON 调用（把「发请求 → 收 finish → 抽文本」这条链复用给非沉淀场景，如矛盾判别）。
  * 与 summarizeTurnDetailed 共享同一套兼容处理：失败经 finish 暴露（不静默成"无输出"）、
@@ -232,7 +250,7 @@ export function resetEffortUnsupported() { effortRejected.clear() }
  *
  * @returns {Promise<{text?:string, failure?:{code:string,message:string}}>}
  */
-export async function callLlmJson(llm, route, { system = '', user = '', maxTokens = 1500, purpose = 'memory-refine', signal } = {}) {
+export async function callLlmJson(llm, route, { system = '', user = '', maxTokens = 1500, purpose = 'memory-refine', signal, sessionId } = {}) {
   const { BlockAssembler, createUserMessage } = await importLlmHelpers()
   const messages = [createUserMessage({
     content: [{ type: 'text', text: String(user || '') }],
@@ -249,6 +267,8 @@ export async function callLlmJson(llm, route, { system = '', user = '', maxToken
     maxTokens,
     ...(effort ? { reasoningEffort: effort } : {}),
     purpose,
+    // issue #51：网关（opencode-go 等）靠它注入 x-opencode-session；缺了首跳必 400。
+    sessionId: resolveLlmSessionId(sessionId, REFINE_LLM_SESSION_ID),
     signal: signal ?? AbortSignal.timeout(60000),
   }
   const runOnce = async (o) => {
@@ -324,6 +344,9 @@ export async function summarizeTurnDetailed(llm, route, conversation, opts = {})
     maxTokens,
     ...(effort ? { reasoningEffort: effort } : {}),
     purpose: 'memory-capture',
+    // issue #51：透传真实会话 id（拿不到就退稳定常量）。缺这个字段时 opencode-go 的蒸馏
+    // 首跳会 400 MissingSessionID，每轮白烧一次调用 + 面板误报「自动沉淀异常」。
+    sessionId: resolveLlmSessionId(opts.sessionId, CAPTURE_LLM_SESSION_ID),
     signal: opts.signal ?? AbortSignal.timeout(45000),
   }
   const runOnce = async (streamOptions) => {