@xopcai/xopc 0.0.113 → 0.0.115

package/dist/src/agent/goals/checklist-judge.js.map

@@ -1 +1 @@
-{"version":3,"file":"checklist-judge.js","names":[],"sources":["../../../../src/agent/goals/checklist-judge.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\nimport { complete } from '@earendil-works/pi-ai';\n\nimport { resolveModel } from '../../providers/index.js';\n\nimport {\n  DEFAULT_JUDGE_TIMEOUT_MS,\n  extractAssistantText,\n  getAssistantMessageErrorReason,\n  resolveGoalJudgeApiKey,\n  stripCodeFences,\n  truncateGoalText,\n} from './judge.js';\nimport type { GoalUiLocale } from './goal-locale.js';\nimport {\n  goalUiLocaleOrFallback,\n  judgeReasonText,\n  judgeResponseLanguageNote,\n  JUDGE_REASON_EN,\n  localizeJudgeReasonText,\n} from './goal-locale.js';\n\nconst GOAL_TRUNC = 4000;\nconst RESPONSE_SNIPPET = 4000;\nconst HISTORY_TRUNC = 24_000;\n\nconst DECOMPOSE_SYSTEM = (\n  'You break a user goal into an EXTREMELY detailed checklist of concrete, verifiable completion criteria. ' +\n  'Bias toward more items. Each item is one factual statement about finished work.\\n\\n' +\n  'Reply ONLY with a single JSON object on one line:\\n' +\n  '{\"items\":[{\"text\":\"...\"},...]}\\n' +\n  'Use at least 3 items when the goal warrants it.'\n);\n\nconst DECOMPOSE_USER = 'Goal:\\n{goal}\\n\\nReturn JSON only.';\n\nconst EVALUATE_CHECKLIST_SYSTEM = (\n  'You evaluate an autonomous agent\\'s progress on a goal with a numbered checklist.\\n' +\n  'For each pending item, decide if evidence in the agent snippet and/or history excerpt shows it is satisfied.\\n' +\n  'Flip pending→completed only with clear evidence; pending→impossible only if truly unachievable here.\\n' +\n  'Do not regress completed/impossible items — omit them from updates.\\n\\n' +\n  'Reply ONLY with one JSON object on one line:\\n' +\n  '{\"verdict\":\"continue|done|blocked|needs_input\",\"confidence\":0.0,\"reason\":\"...\",' +\n  '\"nextAction\":\"...\",\"missingEvidence\":[\"...\"],\"userQuestion\":\"...\",' +\n  '\"updates\":[{\"index\":1,\"status\":\"completed|impossible\",\"evidence\":\"short citation\"}],' +\n  '\"new_items\":[{\"text\":\"...\"}]}\\n' +\n  'Use verdict=done only when all checklist criteria are complete/impossible. ' +\n  'Use needs_input when the next step requires user input. Use blocked when external progress is impossible.'\n);\n\nfunction extractJsonObject(raw: string): Record<string, unknown> | null {\n  if (!raw?.trim()) return null;\n  const text = stripCodeFences(raw);\n  try {\n    const data = JSON.parse(text) as unknown;\n    return data && typeof data === 'object' && !Array.isArray(data) ? (data as Record<string, unknown>) : null;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start === -1 || end <= start) return null;\n    try {\n      const data = JSON.parse(text.slice(start, end + 1)) as unknown;\n      return data && typeof data === 'object' && !Array.isArray(data) ? (data as Record<string, unknown>) : null;\n    } catch {\n      return null;\n    }\n  }\n}\n\nexport type DecomposeChecklistResult = {\n  items: { text: string }[];\n  parseFailed: boolean;\n  errorReason?: string;\n};\n\nexport async function decomposeGoalChecklist(opts: {\n  goal: string;\n  judgeModelRef: string;\n  signal?: AbortSignal;\n  judgeTimeoutMs?: number;\n  uiLocale?: GoalUiLocale;\n}): Promise<DecomposeChecklistResult> {\n  const locale = goalUiLocaleOrFallback(opts.uiLocale);\n  const goal = opts.goal.trim();\n  if (!goal)\n    return { items: [], parseFailed: false, errorReason: judgeReasonText('empty_goal', locale) };\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(opts.judgeModelRef);\n  } catch {\n    return {\n      items: [],\n      parseFailed: false,\n      errorReason: judgeReasonText('judge_model_not_configured', locale),\n    };\n  }\n\n  const timeoutMs =\n    typeof opts.judgeTimeoutMs === 'number' && Number.isFinite(opts.judgeTimeoutMs)\n      ? Math.max(5_000, Math.min(120_000, Math.floor(opts.judgeTimeoutMs)))\n      : DEFAULT_JUDGE_TIMEOUT_MS;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const merged = opts.signal ? AbortSignal.any([opts.signal, controller.signal]) : controller.signal;\n\n  try {\n    const user: UserMessage = {\n      role: 'user',\n      content:\n        `${DECOMPOSE_SYSTEM}\\n\\n${DECOMPOSE_USER.replace('{goal}', truncateGoalText(goal, GOAL_TRUNC))}` +\n        judgeResponseLanguageNote(locale),\n      timestamp: Date.now(),\n    };\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await complete(\n      model,\n      { messages: [user] },\n      { apiKey, maxTokens: 2000, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return {\n        items: [],\n        parseFailed: false,\n        errorReason: judgeReasonText('decompose_call_failed', locale),\n      };\n    }\n\n    const text = extractAssistantText(result.content);\n    const data = extractJsonObject(text);\n    if (!data)\n      return {\n        items: [],\n        parseFailed: true,\n        errorReason: judgeReasonText('decompose_reply_not_json', locale),\n      };\n    const rawItems = data.items ?? data.checklist;\n    if (!Array.isArray(rawItems))\n      return {\n        items: [],\n        parseFailed: true,\n        errorReason: judgeReasonText('missing_items_array', locale),\n      };\n    const items: { text: string }[] = [];\n    for (const row of rawItems) {\n      if (typeof row === 'string') {\n        const t = row.trim();\n        if (t) items.push({ text: t });\n      } else if (row && typeof row === 'object' && !Array.isArray(row)) {\n        const t = String((row as { text?: string }).text ?? '').trim();\n        if (t) items.push({ text: t });\n      }\n    }\n    if (!items.length)\n      return { items: [], parseFailed: true, errorReason: judgeReasonText('empty_checklist', locale) };\n    return { items, parseFailed: false };\n  } catch {\n    return {\n      items: [],\n      parseFailed: false,\n      errorReason: judgeReasonText('decompose_call_failed', locale),\n    };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport type ChecklistJudgeUpdate = {\n  index: number;\n  status: 'completed' | 'impossible';\n  evidence?: string | null;\n};\n\nexport type ChecklistEvaluateParsed = {\n  verdict: 'continue' | 'done' | 'blocked' | 'needs_input';\n  confidence: number;\n  updates: ChecklistJudgeUpdate[];\n  newItems: { text: string }[];\n  reason: string;\n  nextAction?: string;\n  missingEvidence?: string[];\n  userQuestion?: string;\n};\n\nexport type EvaluateChecklistResult = {\n  parsed: ChecklistEvaluateParsed;\n  parseFailed: boolean;\n};\n\nexport async function evaluateGoalChecklistJudge(opts: {\n  goal: string;\n  numberedChecklist: string;\n  lastResponse: string;\n  historyExcerpt: string;\n  judgeModelRef: string;\n  signal?: AbortSignal;\n  judgeTimeoutMs?: number;\n  uiLocale?: GoalUiLocale;\n}): Promise<EvaluateChecklistResult> {\n  const locale = goalUiLocaleOrFallback(opts.uiLocale);\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(opts.judgeModelRef);\n  } catch {\n    return {\n      parsed: {\n        verdict: 'continue',\n        confidence: 0,\n        updates: [],\n        newItems: [],\n        reason: judgeReasonText('judge_model_not_configured', locale),\n      },\n      parseFailed: false,\n    };\n  }\n\n  const userBody =\n    `Goal:\\n${truncateGoalText(opts.goal, 2000)}\\n\\n` +\n    `Current checklist (1-based indices):\\n${opts.numberedChecklist}\\n\\n` +\n    `Agent's most recent response (snippet):\\n${truncateGoalText(opts.lastResponse, RESPONSE_SNIPPET)}\\n\\n` +\n    `Recent conversation excerpt (JSON or text, may be truncated):\\n` +\n    `${truncateGoalText(opts.historyExcerpt, HISTORY_TRUNC) || '(none)'}`;\n\n  const timeoutMs =\n    typeof opts.judgeTimeoutMs === 'number' && Number.isFinite(opts.judgeTimeoutMs)\n      ? Math.max(5_000, Math.min(120_000, Math.floor(opts.judgeTimeoutMs)))\n      : DEFAULT_JUDGE_TIMEOUT_MS;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const merged = opts.signal ? AbortSignal.any([opts.signal, controller.signal]) : controller.signal;\n\n  try {\n    const user: UserMessage = {\n      role: 'user',\n      content: `${EVALUATE_CHECKLIST_SYSTEM}\\n\\n${userBody}` + judgeResponseLanguageNote(locale),\n      timestamp: Date.now(),\n    };\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await complete(\n      model,\n      { messages: [user] },\n      { apiKey, maxTokens: 1500, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return {\n        parsed: {\n          verdict: 'continue',\n          confidence: 0,\n          updates: [],\n          newItems: [],\n          reason: judgeReasonText('judge_call_failed', locale),\n        },\n        parseFailed: false,\n      };\n    }\n\n    const text = extractAssistantText(result.content);\n    const data = extractJsonObject(text);\n    if (!data) {\n      return {\n        parsed: {\n          verdict: 'continue',\n          confidence: 0,\n          updates: [],\n          newItems: [],\n          reason: judgeReasonText('judge_reply_not_json', locale),\n        },\n        parseFailed: true,\n      };\n    }\n    const updatesRaw = data.updates;\n    const newRaw = data.new_items ?? data.newItems;\n    const verdictRaw = String(data.verdict ?? '').trim().toLowerCase();\n    const verdict =\n      verdictRaw === 'done' || verdictRaw === 'blocked' || verdictRaw === 'needs_input'\n        ? verdictRaw\n        : 'continue';\n    const confidenceRaw = Number(data.confidence);\n    const confidence = Number.isFinite(confidenceRaw) ? Math.max(0, Math.min(1, confidenceRaw)) : 0;\n    const nextAction = typeof data.nextAction === 'string' ? data.nextAction.trim() : undefined;\n    const userQuestion = typeof data.userQuestion === 'string' ? data.userQuestion.trim() : undefined;\n    const missingEvidenceRaw = data.missingEvidence ?? data.missing_evidence;\n    const trimmed = typeof data.reason === 'string' ? data.reason.trim() : '';\n    const inner = trimmed || JUDGE_REASON_EN.no_reason_provided;\n    const reason = localizeJudgeReasonText(inner, locale);\n    const updates: ChecklistJudgeUpdate[] = [];\n    if (Array.isArray(updatesRaw)) {\n      for (const u of updatesRaw) {\n        if (!u || typeof u !== 'object' || Array.isArray(u)) continue;\n        const rec = u as Record<string, unknown>;\n        const idx1 = Number(rec.index);\n        if (!Number.isFinite(idx1)) continue;\n        const idx0 = Math.floor(idx1) - 1;\n        const st = String(rec.status ?? '').trim().toLowerCase();\n        if (st !== 'completed' && st !== 'impossible') continue;\n        const evidence = typeof rec.evidence === 'string' ? rec.evidence : null;\n        updates.push({ index: idx0, status: st, evidence });\n      }\n    }\n    const newItems: { text: string }[] = [];\n    if (Array.isArray(newRaw)) {\n      for (const row of newRaw) {\n        if (typeof row === 'string') {\n          const t = row.trim();\n          if (t) newItems.push({ text: t });\n        } else if (row && typeof row === 'object' && !Array.isArray(row)) {\n          const t = String((row as { text?: string }).text ?? '').trim();\n          if (t) newItems.push({ text: t });\n        }\n      }\n    }\n    const missingEvidence: string[] = [];\n    if (Array.isArray(missingEvidenceRaw)) {\n      for (const item of missingEvidenceRaw) {\n        if (typeof item === 'string' && item.trim()) missingEvidence.push(item.trim());\n      }\n    }\n    return {\n      parsed: {\n        verdict,\n        confidence,\n        updates,\n        newItems,\n        reason: reason || judgeReasonText('no_reason_provided', locale),\n        ...(nextAction ? { nextAction } : {}),\n        ...(missingEvidence.length ? { missingEvidence } : {}),\n        ...(userQuestion ? { userQuestion } : {}),\n      },\n      parseFailed: false,\n    };\n  } catch {\n    return {\n      parsed: {\n        verdict: 'continue',\n        confidence: 0,\n        updates: [],\n        newItems: [],\n        reason: judgeReasonText('judge_call_failed', locale),\n      },\n      parseFailed: false,\n    };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"checklist-judge.js","names":[],"sources":["../../../../src/agent/goals/checklist-judge.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\nimport { complete } from '@earendil-works/pi-ai';\n\nimport { resolveModel } from '../../providers/index.js';\n\nimport {\n  DEFAULT_JUDGE_TIMEOUT_MS,\n  extractAssistantText,\n  getAssistantMessageErrorReason,\n  resolveGoalJudgeApiKey,\n  stripCodeFences,\n  truncateGoalText,\n} from './judge.js';\nimport type { GoalUiLocale } from './goal-locale.js';\nimport {\n  goalUiLocaleOrFallback,\n  judgeReasonText,\n  judgeResponseLanguageNote,\n  JUDGE_REASON_EN,\n  localizeJudgeReasonText,\n} from './goal-locale.js';\n\nconst GOAL_TRUNC = 4000;\nconst RESPONSE_SNIPPET = 4000;\nconst HISTORY_TRUNC = 24_000;\n\nconst DECOMPOSE_SYSTEM = (\n  'You break a user goal into an EXTREMELY detailed checklist of concrete, verifiable completion criteria. ' +\n  'Bias toward more items. Each item is one factual statement about finished work.\\n\\n' +\n  'If existing acceptance criteria are provided, return only missing supplemental criteria. ' +\n  'Do not repeat, rewrite, or replace existing criteria.\\n\\n' +\n  'Reply ONLY with a single JSON object on one line:\\n' +\n  '{\"items\":[{\"text\":\"...\"},...]}\\n' +\n  'Use at least 3 items when the goal warrants it.'\n);\n\nconst DECOMPOSE_USER = 'Goal:\\n{goal}\\n\\nReturn JSON only.';\n\nconst EVALUATE_CHECKLIST_SYSTEM = (\n  'You evaluate an autonomous agent\\'s progress on a goal with a numbered checklist.\\n' +\n  'For each pending item, decide if evidence in the agent snippet and/or history excerpt shows it is satisfied.\\n' +\n  'Flip pending→completed only with clear evidence; pending→impossible only if truly unachievable here.\\n' +\n  'Do not regress completed/impossible items — omit them from updates.\\n\\n' +\n  'Reply ONLY with one JSON object on one line:\\n' +\n  '{\"verdict\":\"continue|done|blocked|needs_input\",\"confidence\":0.0,\"reason\":\"...\",' +\n  '\"nextAction\":\"...\",\"missingEvidence\":[\"...\"],\"userQuestion\":\"...\",' +\n  '\"updates\":[{\"index\":1,\"status\":\"completed|impossible\",\"evidence\":\"short citation\"}],' +\n  '\"new_items\":[{\"text\":\"...\"}]}\\n' +\n  'Use verdict=done only when all checklist criteria are complete/impossible. ' +\n  'Use needs_input when the next step requires user input. Use blocked when external progress is impossible.'\n);\n\nfunction extractJsonObject(raw: string): Record<string, unknown> | null {\n  if (!raw?.trim()) return null;\n  const text = stripCodeFences(raw);\n  try {\n    const data = JSON.parse(text) as unknown;\n    return data && typeof data === 'object' && !Array.isArray(data) ? (data as Record<string, unknown>) : null;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start === -1 || end <= start) return null;\n    try {\n      const data = JSON.parse(text.slice(start, end + 1)) as unknown;\n      return data && typeof data === 'object' && !Array.isArray(data) ? (data as Record<string, unknown>) : null;\n    } catch {\n      return null;\n    }\n  }\n}\n\nexport type DecomposeChecklistResult = {\n  items: { text: string }[];\n  parseFailed: boolean;\n  errorReason?: string;\n};\n\nexport async function decomposeGoalChecklist(opts: {\n  goal: string;\n  existingChecklist?: string;\n  judgeModelRef: string;\n  signal?: AbortSignal;\n  judgeTimeoutMs?: number;\n  uiLocale?: GoalUiLocale;\n}): Promise<DecomposeChecklistResult> {\n  const locale = goalUiLocaleOrFallback(opts.uiLocale);\n  const goal = opts.goal.trim();\n  if (!goal)\n    return { items: [], parseFailed: false, errorReason: judgeReasonText('empty_goal', locale) };\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(opts.judgeModelRef);\n  } catch {\n    return {\n      items: [],\n      parseFailed: false,\n      errorReason: judgeReasonText('judge_model_not_configured', locale),\n    };\n  }\n\n  const timeoutMs =\n    typeof opts.judgeTimeoutMs === 'number' && Number.isFinite(opts.judgeTimeoutMs)\n      ? Math.max(5_000, Math.min(120_000, Math.floor(opts.judgeTimeoutMs)))\n      : DEFAULT_JUDGE_TIMEOUT_MS;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const merged = opts.signal ? AbortSignal.any([opts.signal, controller.signal]) : controller.signal;\n\n  try {\n    const existingChecklist = opts.existingChecklist?.trim();\n    const decomposeUser = DECOMPOSE_USER.replace('{goal}', truncateGoalText(goal, GOAL_TRUNC)) +\n      (existingChecklist\n        ? `\\n\\nExisting acceptance criteria:\\n${truncateGoalText(existingChecklist, GOAL_TRUNC)}\\n\\nReturn only missing supplemental criteria as JSON.`\n        : '');\n    const user: UserMessage = {\n      role: 'user',\n      content:\n        `${DECOMPOSE_SYSTEM}\\n\\n${decomposeUser}` +\n        judgeResponseLanguageNote(locale),\n      timestamp: Date.now(),\n    };\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await complete(\n      model,\n      { messages: [user] },\n      { apiKey, maxTokens: 2000, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return {\n        items: [],\n        parseFailed: false,\n        errorReason: judgeReasonText('decompose_call_failed', locale),\n      };\n    }\n\n    const text = extractAssistantText(result.content);\n    const data = extractJsonObject(text);\n    if (!data)\n      return {\n        items: [],\n        parseFailed: true,\n        errorReason: judgeReasonText('decompose_reply_not_json', locale),\n      };\n    const rawItems = data.items ?? data.checklist;\n    if (!Array.isArray(rawItems))\n      return {\n        items: [],\n        parseFailed: true,\n        errorReason: judgeReasonText('missing_items_array', locale),\n      };\n    const items: { text: string }[] = [];\n    for (const row of rawItems) {\n      if (typeof row === 'string') {\n        const t = row.trim();\n        if (t) items.push({ text: t });\n      } else if (row && typeof row === 'object' && !Array.isArray(row)) {\n        const t = String((row as { text?: string }).text ?? '').trim();\n        if (t) items.push({ text: t });\n      }\n    }\n    if (!items.length)\n      return { items: [], parseFailed: true, errorReason: judgeReasonText('empty_checklist', locale) };\n    return { items, parseFailed: false };\n  } catch {\n    return {\n      items: [],\n      parseFailed: false,\n      errorReason: judgeReasonText('decompose_call_failed', locale),\n    };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport type ChecklistJudgeUpdate = {\n  index: number;\n  status: 'completed' | 'impossible';\n  evidence?: string | null;\n};\n\nexport type ChecklistEvaluateParsed = {\n  verdict: 'continue' | 'done' | 'blocked' | 'needs_input';\n  confidence: number;\n  updates: ChecklistJudgeUpdate[];\n  newItems: { text: string }[];\n  reason: string;\n  nextAction?: string;\n  missingEvidence?: string[];\n  userQuestion?: string;\n};\n\nexport type EvaluateChecklistResult = {\n  parsed: ChecklistEvaluateParsed;\n  parseFailed: boolean;\n};\n\nexport async function evaluateGoalChecklistJudge(opts: {\n  goal: string;\n  numberedChecklist: string;\n  lastResponse: string;\n  historyExcerpt: string;\n  judgeModelRef: string;\n  signal?: AbortSignal;\n  judgeTimeoutMs?: number;\n  uiLocale?: GoalUiLocale;\n}): Promise<EvaluateChecklistResult> {\n  const locale = goalUiLocaleOrFallback(opts.uiLocale);\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(opts.judgeModelRef);\n  } catch {\n    return {\n      parsed: {\n        verdict: 'continue',\n        confidence: 0,\n        updates: [],\n        newItems: [],\n        reason: judgeReasonText('judge_model_not_configured', locale),\n      },\n      parseFailed: false,\n    };\n  }\n\n  const userBody =\n    `Goal:\\n${truncateGoalText(opts.goal, 2000)}\\n\\n` +\n    `Current checklist (1-based indices):\\n${opts.numberedChecklist}\\n\\n` +\n    `Agent's most recent response (snippet):\\n${truncateGoalText(opts.lastResponse, RESPONSE_SNIPPET)}\\n\\n` +\n    `Recent conversation excerpt (JSON or text, may be truncated):\\n` +\n    `${truncateGoalText(opts.historyExcerpt, HISTORY_TRUNC) || '(none)'}`;\n\n  const timeoutMs =\n    typeof opts.judgeTimeoutMs === 'number' && Number.isFinite(opts.judgeTimeoutMs)\n      ? Math.max(5_000, Math.min(120_000, Math.floor(opts.judgeTimeoutMs)))\n      : DEFAULT_JUDGE_TIMEOUT_MS;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  const merged = opts.signal ? AbortSignal.any([opts.signal, controller.signal]) : controller.signal;\n\n  try {\n    const user: UserMessage = {\n      role: 'user',\n      content: `${EVALUATE_CHECKLIST_SYSTEM}\\n\\n${userBody}` + judgeResponseLanguageNote(locale),\n      timestamp: Date.now(),\n    };\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await complete(\n      model,\n      { messages: [user] },\n      { apiKey, maxTokens: 1500, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return {\n        parsed: {\n          verdict: 'continue',\n          confidence: 0,\n          updates: [],\n          newItems: [],\n          reason: judgeReasonText('judge_call_failed', locale),\n        },\n        parseFailed: false,\n      };\n    }\n\n    const text = extractAssistantText(result.content);\n    const data = extractJsonObject(text);\n    if (!data) {\n      return {\n        parsed: {\n          verdict: 'continue',\n          confidence: 0,\n          updates: [],\n          newItems: [],\n          reason: judgeReasonText('judge_reply_not_json', locale),\n        },\n        parseFailed: true,\n      };\n    }\n    const updatesRaw = data.updates;\n    const newRaw = data.new_items ?? data.newItems;\n    const verdictRaw = String(data.verdict ?? '').trim().toLowerCase();\n    const verdict =\n      verdictRaw === 'done' || verdictRaw === 'blocked' || verdictRaw === 'needs_input'\n        ? verdictRaw\n        : 'continue';\n    const confidenceRaw = Number(data.confidence);\n    const confidence = Number.isFinite(confidenceRaw) ? Math.max(0, Math.min(1, confidenceRaw)) : 0;\n    const nextAction = typeof data.nextAction === 'string' ? data.nextAction.trim() : undefined;\n    const userQuestion = typeof data.userQuestion === 'string' ? data.userQuestion.trim() : undefined;\n    const missingEvidenceRaw = data.missingEvidence ?? data.missing_evidence;\n    const trimmed = typeof data.reason === 'string' ? data.reason.trim() : '';\n    const inner = trimmed || JUDGE_REASON_EN.no_reason_provided;\n    const reason = localizeJudgeReasonText(inner, locale);\n    const updates: ChecklistJudgeUpdate[] = [];\n    if (Array.isArray(updatesRaw)) {\n      for (const u of updatesRaw) {\n        if (!u || typeof u !== 'object' || Array.isArray(u)) continue;\n        const rec = u as Record<string, unknown>;\n        const idx1 = Number(rec.index);\n        if (!Number.isFinite(idx1)) continue;\n        const idx0 = Math.floor(idx1) - 1;\n        const st = String(rec.status ?? '').trim().toLowerCase();\n        if (st !== 'completed' && st !== 'impossible') continue;\n        const evidence = typeof rec.evidence === 'string' ? rec.evidence : null;\n        updates.push({ index: idx0, status: st, evidence });\n      }\n    }\n    const newItems: { text: string }[] = [];\n    if (Array.isArray(newRaw)) {\n      for (const row of newRaw) {\n        if (typeof row === 'string') {\n          const t = row.trim();\n          if (t) newItems.push({ text: t });\n        } else if (row && typeof row === 'object' && !Array.isArray(row)) {\n          const t = String((row as { text?: string }).text ?? '').trim();\n          if (t) newItems.push({ text: t });\n        }\n      }\n    }\n    const missingEvidence: string[] = [];\n    if (Array.isArray(missingEvidenceRaw)) {\n      for (const item of missingEvidenceRaw) {\n        if (typeof item === 'string' && item.trim()) missingEvidence.push(item.trim());\n      }\n    }\n    return {\n      parsed: {\n        verdict,\n        confidence,\n        updates,\n        newItems,\n        reason: reason || judgeReasonText('no_reason_provided', locale),\n        ...(nextAction ? { nextAction } : {}),\n        ...(missingEvidence.length ? { missingEvidence } : {}),\n        ...(userQuestion ? { userQuestion } : {}),\n      },\n      parseFailed: false,\n    };\n  } catch {\n    return {\n      parsed: {\n        verdict: 'continue',\n        confidence: 0,\n        updates: [],\n        newItems: [],\n        reason: judgeReasonText('judge_call_failed', locale),\n      },\n      parseFailed: false,\n    };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/goals/evaluate-turn.d.ts

@@ -5,7 +5,7 @@ import { type PersistentGoalState } from './state.js';
 export declare const CONTINUATION_PROMPT_TEMPLATE: string;
 /** Hermes `CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE` (English; parity / tests). */
 export declare const CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE: string;
-export type GoalsEvaluateConfigSlice = Pick<GoalsConfig, 'checklistMode' | 'maxConsecutiveParseFailures' | 'judgeTimeoutMs' | 'checklistHistoryChars'>;
+export type GoalsEvaluateConfigSlice = Pick<GoalsConfig, 'checklistMode' | 'checklistDecomposePolicy' | 'maxConsecutiveParseFailures' | 'judgeTimeoutMs' | 'checklistHistoryChars'>;
 export type GoalPostTurnDecision = {
     newState: PersistentGoalState | null;
     shouldContinue: boolean;

package/dist/src/agent/goals/evaluate-turn.js

@@ -71,6 +71,7 @@ async function evaluateAfterTurnHermesLike(state, lastResponse, judgeModelRef, s
 	if (checklistMode && !next.decomposed) {
 		const dec = await decomposeGoalChecklist({
 			goal: next.goal,
+			existingChecklist: next.checklist?.length ? renderChecklistNumbered(next.checklist) : void 0,
 			judgeModelRef,
 			signal,
 			judgeTimeoutMs,

package/dist/src/agent/goals/evaluate-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate-turn.js","names":[],"sources":["../../../../src/agent/goals/evaluate-turn.ts"],"sourcesContent":["import type { GoalsConfig } from '../../config/schema.js';\n\nimport { decomposeGoalChecklist, evaluateGoalChecklistJudge } from './checklist-judge.js';\nimport { allChecklistTerminal, checklistCounts } from './checklist-types.js';\nimport {\n  buildContinuationPromptFromState,\n  checklistProgressSuffix,\n  CONTINUATION_PROMPT_TEMPLATE_EN,\n  CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE_EN,\n  goalEvaluateUserCopy,\n  resolveGoalUiLocale,\n  type GoalUiLocale,\n} from './goal-locale.js';\nimport { judgeGoalHermesStyle } from './judge.js';\nimport {\n  applyJudgeChecklistUpdates,\n  mergeDecomposedChecklistItems,\n  renderChecklistNumbered,\n  type PersistentGoalState,\n} from './state.js';\n\n/** Hermes `CONTINUATION_PROMPT_TEMPLATE` (English; parity / tests). */\nexport const CONTINUATION_PROMPT_TEMPLATE = CONTINUATION_PROMPT_TEMPLATE_EN;\n\n/** Hermes `CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE` (English; parity / tests). */\nexport const CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE = CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE_EN;\n\nexport type GoalsEvaluateConfigSlice = Pick<\n  GoalsConfig,\n  'checklistMode' | 'maxConsecutiveParseFailures' | 'judgeTimeoutMs' | 'checklistHistoryChars'\n>;\n\nexport type GoalPostTurnDecision = {\n  newState: PersistentGoalState | null;\n  shouldContinue: boolean;\n  continuationPrompt: string | null;\n  verdict: 'done' | 'continue' | 'blocked' | 'needs_input' | 'skipped' | 'inactive' | 'decompose';\n  reason: string;\n  message: string;\n  confidence?: number;\n  missingEvidence?: string[];\n  userQuestion?: string;\n  completedChecklistItemIndexes?: number[];\n};\n\nfunction cloneState(s: PersistentGoalState): PersistentGoalState {\n  return {\n    ...s,\n    checklist: s.checklist?.map((it) => ({ ...it })),\n  };\n}\n\n/**\n * Hermes `GoalManager.evaluate_after_turn` equivalent (minus SessionDB I/O).\n */\nexport async function evaluateAfterTurnHermesLike(\n  state: PersistentGoalState,\n  lastResponse: string,\n  judgeModelRef: string,\n  signal?: AbortSignal,\n  opts?: { goalsSlice?: Partial<GoalsEvaluateConfigSlice>; historyExcerpt?: string; uiLocale?: GoalUiLocale },\n): Promise<GoalPostTurnDecision> {\n  const locale = opts?.uiLocale ?? resolveGoalUiLocale(state);\n  const copy = goalEvaluateUserCopy(locale);\n\n  if (state.status !== 'active') {\n    return {\n      newState: state,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'inactive',\n      reason: 'no active goal',\n      message: '',\n    };\n  }\n\n  const slice = opts?.goalsSlice;\n  const checklistMode = slice?.checklistMode !== false;\n  const maxParseFailures = slice?.maxConsecutiveParseFailures ?? 3;\n  const judgeTimeoutMs = slice?.judgeTimeoutMs;\n\n  const next = cloneState(state);\n  next.turnsUsed += 1;\n  next.lastTurnAt = Date.now();\n\n  const bumpParse = () => {\n    next.consecutiveParseFailures = (next.consecutiveParseFailures ?? 0) + 1;\n  };\n  const resetParse = () => {\n    next.consecutiveParseFailures = 0;\n  };\n\n  const pauseIfParseStorm = (reason: string): GoalPostTurnDecision | null => {\n    const n = next.consecutiveParseFailures ?? 0;\n    if (n < maxParseFailures) return null;\n    next.status = 'paused';\n    next.pausedReason = `judge parse failures (${n} consecutive)`;\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'continue',\n      reason,\n      message: copy.pauseParse(n),\n    };\n  };\n\n  const pauseIfBudget = (reason: string): GoalPostTurnDecision | null => {\n    if (next.turnsUsed < next.maxTurns) return null;\n    next.status = 'paused';\n    next.pausedReason = `turn budget exhausted (${next.turnsUsed}/${next.maxTurns})`;\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'continue',\n      reason,\n      message: copy.pauseBudget(next.turnsUsed, next.maxTurns),\n    };\n  };\n\n  // ── Phase A: decompose (once per goal when checklist mode is on) ──\n  if (checklistMode && !next.decomposed) {\n    const dec = await decomposeGoalChecklist({\n      goal: next.goal,\n      judgeModelRef,\n      signal,\n      judgeTimeoutMs,\n      uiLocale: locale,\n    });\n    next.decomposed = true;\n    if (!dec.parseFailed && dec.items.length > 0) {\n      const prior = next.checklist ?? [];\n      next.checklist = mergeDecomposedChecklistItems(prior, dec.items);\n      const mergedCount = next.checklist.length;\n      next.lastVerdict = 'decompose';\n      next.lastReason = copy.decomposedReason(mergedCount);\n      resetParse();\n      const budgetEarly = pauseIfBudget(next.lastReason);\n      if (budgetEarly) return budgetEarly;\n      return {\n        newState: next,\n        shouldContinue: true,\n        continuationPrompt: buildContinuationPromptFromState(next, locale),\n        verdict: 'decompose',\n        reason: next.lastReason ?? '',\n        message: copy.checklistReady(mergedCount),\n      };\n    }\n    next.lastReason = dec.errorReason\n      ? copy.decomposeFallbackReason(dec.errorReason)\n      : copy.noChecklistFallback();\n  }\n\n  // ── Phase B: checklist judge ──\n  const checklist = next.checklist ?? [];\n  if (checklist.length > 0) {\n    const evalResult = await evaluateGoalChecklistJudge({\n      goal: next.goal,\n      numberedChecklist: renderChecklistNumbered(checklist),\n      lastResponse,\n      historyExcerpt: opts?.historyExcerpt ?? '',\n      judgeModelRef,\n      signal,\n      judgeTimeoutMs,\n      uiLocale: locale,\n    });\n\n    if (evalResult.parseFailed) {\n      bumpParse();\n    } else {\n      resetParse();\n      next.checklist = applyJudgeChecklistUpdates(checklist, {\n        updates: evalResult.parsed.updates,\n        newItems: evalResult.parsed.newItems,\n      });\n    }\n\n    next.lastVerdict = 'continue';\n    next.lastReason = evalResult.parsed.reason;\n\n    const completedChecklistItemIndexes = evalResult.parsed.updates\n      .filter((update) => update.status === 'completed' || update.status === 'impossible')\n      .map((update) => update.index);\n    const structuredNextAction = evalResult.parsed.nextAction?.trim();\n    const continuationPrompt = structuredNextAction || buildContinuationPromptFromState(next, locale);\n\n    if (!evalResult.parseFailed && allChecklistTerminal(next.checklist ?? [])) {\n      next.status = 'done';\n      next.lastVerdict = 'done';\n      return {\n        newState: next,\n        shouldContinue: false,\n        continuationPrompt: null,\n        verdict: 'done',\n        reason: evalResult.parsed.reason,\n        message: copy.goalAchieved(evalResult.parsed.reason),\n        confidence: evalResult.parsed.confidence,\n        missingEvidence: evalResult.parsed.missingEvidence,\n        userQuestion: evalResult.parsed.userQuestion,\n        completedChecklistItemIndexes,\n      };\n    }\n\n    if (!evalResult.parseFailed && (evalResult.parsed.verdict === 'blocked' || evalResult.parsed.verdict === 'needs_input')) {\n      next.status = 'paused';\n      next.pausedReason = evalResult.parsed.reason;\n      return {\n        newState: next,\n        shouldContinue: false,\n        continuationPrompt: null,\n        verdict: evalResult.parsed.verdict,\n        reason: evalResult.parsed.reason,\n        message: evalResult.parsed.verdict === 'needs_input'\n          ? `Goal needs input: ${evalResult.parsed.userQuestion || evalResult.parsed.reason}`\n          : `Goal blocked: ${evalResult.parsed.reason}`,\n        confidence: evalResult.parsed.confidence,\n        missingEvidence: evalResult.parsed.missingEvidence,\n        userQuestion: evalResult.parsed.userQuestion,\n        completedChecklistItemIndexes,\n      };\n    }\n\n    const parseStorm = pauseIfParseStorm(evalResult.parsed.reason);\n    if (parseStorm) return parseStorm;\n\n    const budget = pauseIfBudget(evalResult.parsed.reason);\n    if (budget) return budget;\n\n    const { total, completed, impossible } = checklistCounts(next.checklist ?? []);\n    const done = completed + impossible;\n    const progressSuffix = checklistProgressSuffix(done, total, locale);\n\n    return {\n      newState: next,\n      shouldContinue: true,\n      continuationPrompt,\n      verdict: 'continue',\n      reason: evalResult.parsed.reason,\n      message: copy.continuingWithProgress(\n        next.turnsUsed,\n        next.maxTurns,\n        progressSuffix,\n        evalResult.parsed.reason,\n      ),\n      confidence: evalResult.parsed.confidence,\n      missingEvidence: evalResult.parsed.missingEvidence,\n      userQuestion: evalResult.parsed.userQuestion,\n      completedChecklistItemIndexes,\n    };\n  }\n\n  // ── Freeform judge (no checklist) ──\n  const j = await judgeGoalHermesStyle(state.goal, lastResponse, judgeModelRef, signal, {\n    judgeTimeoutMs,\n    uiLocale: locale,\n  });\n  next.lastVerdict = j.verdict === 'skipped' ? 'skipped' : j.verdict;\n  next.lastReason = j.reason;\n\n  if (j.parseFailed) bumpParse();\n  else resetParse();\n\n  if (j.verdict === 'done') {\n    next.status = 'done';\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'done',\n      reason: j.reason,\n      message: copy.goalAchieved(j.reason),\n    };\n  }\n\n  const parseStorm = pauseIfParseStorm(j.reason);\n  if (parseStorm) return parseStorm;\n\n  const budget = pauseIfBudget(j.reason);\n  if (budget) return budget;\n\n  return {\n    newState: next,\n    shouldContinue: true,\n    continuationPrompt: buildContinuationPromptFromState(next, locale),\n    verdict: 'continue',\n    reason: j.reason,\n    message: copy.continuing(next.turnsUsed, next.maxTurns, j.reason),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"evaluate-turn.js","names":[],"sources":["../../../../src/agent/goals/evaluate-turn.ts"],"sourcesContent":["import type { GoalsConfig } from '../../config/schema.js';\n\nimport { decomposeGoalChecklist, evaluateGoalChecklistJudge } from './checklist-judge.js';\nimport { allChecklistTerminal, checklistCounts } from './checklist-types.js';\nimport {\n  buildContinuationPromptFromState,\n  checklistProgressSuffix,\n  CONTINUATION_PROMPT_TEMPLATE_EN,\n  CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE_EN,\n  goalEvaluateUserCopy,\n  resolveGoalUiLocale,\n  type GoalUiLocale,\n} from './goal-locale.js';\nimport { judgeGoalHermesStyle } from './judge.js';\nimport {\n  applyJudgeChecklistUpdates,\n  mergeDecomposedChecklistItems,\n  renderChecklistNumbered,\n  type PersistentGoalState,\n} from './state.js';\n\n/** Hermes `CONTINUATION_PROMPT_TEMPLATE` (English; parity / tests). */\nexport const CONTINUATION_PROMPT_TEMPLATE = CONTINUATION_PROMPT_TEMPLATE_EN;\n\n/** Hermes `CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE` (English; parity / tests). */\nexport const CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE = CONTINUATION_PROMPT_WITH_CHECKLIST_TEMPLATE_EN;\n\nexport type GoalsEvaluateConfigSlice = Pick<\n  GoalsConfig,\n  | 'checklistMode'\n  | 'checklistDecomposePolicy'\n  | 'maxConsecutiveParseFailures'\n  | 'judgeTimeoutMs'\n  | 'checklistHistoryChars'\n>;\n\nexport type GoalPostTurnDecision = {\n  newState: PersistentGoalState | null;\n  shouldContinue: boolean;\n  continuationPrompt: string | null;\n  verdict: 'done' | 'continue' | 'blocked' | 'needs_input' | 'skipped' | 'inactive' | 'decompose';\n  reason: string;\n  message: string;\n  confidence?: number;\n  missingEvidence?: string[];\n  userQuestion?: string;\n  completedChecklistItemIndexes?: number[];\n};\n\nfunction cloneState(s: PersistentGoalState): PersistentGoalState {\n  return {\n    ...s,\n    checklist: s.checklist?.map((it) => ({ ...it })),\n  };\n}\n\n/**\n * Hermes `GoalManager.evaluate_after_turn` equivalent (minus SessionDB I/O).\n */\nexport async function evaluateAfterTurnHermesLike(\n  state: PersistentGoalState,\n  lastResponse: string,\n  judgeModelRef: string,\n  signal?: AbortSignal,\n  opts?: { goalsSlice?: Partial<GoalsEvaluateConfigSlice>; historyExcerpt?: string; uiLocale?: GoalUiLocale },\n): Promise<GoalPostTurnDecision> {\n  const locale = opts?.uiLocale ?? resolveGoalUiLocale(state);\n  const copy = goalEvaluateUserCopy(locale);\n\n  if (state.status !== 'active') {\n    return {\n      newState: state,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'inactive',\n      reason: 'no active goal',\n      message: '',\n    };\n  }\n\n  const slice = opts?.goalsSlice;\n  const checklistMode = slice?.checklistMode !== false;\n  const maxParseFailures = slice?.maxConsecutiveParseFailures ?? 3;\n  const judgeTimeoutMs = slice?.judgeTimeoutMs;\n\n  const next = cloneState(state);\n  next.turnsUsed += 1;\n  next.lastTurnAt = Date.now();\n\n  const bumpParse = () => {\n    next.consecutiveParseFailures = (next.consecutiveParseFailures ?? 0) + 1;\n  };\n  const resetParse = () => {\n    next.consecutiveParseFailures = 0;\n  };\n\n  const pauseIfParseStorm = (reason: string): GoalPostTurnDecision | null => {\n    const n = next.consecutiveParseFailures ?? 0;\n    if (n < maxParseFailures) return null;\n    next.status = 'paused';\n    next.pausedReason = `judge parse failures (${n} consecutive)`;\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'continue',\n      reason,\n      message: copy.pauseParse(n),\n    };\n  };\n\n  const pauseIfBudget = (reason: string): GoalPostTurnDecision | null => {\n    if (next.turnsUsed < next.maxTurns) return null;\n    next.status = 'paused';\n    next.pausedReason = `turn budget exhausted (${next.turnsUsed}/${next.maxTurns})`;\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'continue',\n      reason,\n      message: copy.pauseBudget(next.turnsUsed, next.maxTurns),\n    };\n  };\n\n  // ── Phase A: decompose (once per goal when checklist mode is on) ──\n  if (checklistMode && !next.decomposed) {\n    const dec = await decomposeGoalChecklist({\n      goal: next.goal,\n      existingChecklist: next.checklist?.length ? renderChecklistNumbered(next.checklist) : undefined,\n      judgeModelRef,\n      signal,\n      judgeTimeoutMs,\n      uiLocale: locale,\n    });\n    next.decomposed = true;\n    if (!dec.parseFailed && dec.items.length > 0) {\n      const prior = next.checklist ?? [];\n      next.checklist = mergeDecomposedChecklistItems(prior, dec.items);\n      const mergedCount = next.checklist.length;\n      next.lastVerdict = 'decompose';\n      next.lastReason = copy.decomposedReason(mergedCount);\n      resetParse();\n      const budgetEarly = pauseIfBudget(next.lastReason);\n      if (budgetEarly) return budgetEarly;\n      return {\n        newState: next,\n        shouldContinue: true,\n        continuationPrompt: buildContinuationPromptFromState(next, locale),\n        verdict: 'decompose',\n        reason: next.lastReason ?? '',\n        message: copy.checklistReady(mergedCount),\n      };\n    }\n    next.lastReason = dec.errorReason\n      ? copy.decomposeFallbackReason(dec.errorReason)\n      : copy.noChecklistFallback();\n  }\n\n  // ── Phase B: checklist judge ──\n  const checklist = next.checklist ?? [];\n  if (checklist.length > 0) {\n    const evalResult = await evaluateGoalChecklistJudge({\n      goal: next.goal,\n      numberedChecklist: renderChecklistNumbered(checklist),\n      lastResponse,\n      historyExcerpt: opts?.historyExcerpt ?? '',\n      judgeModelRef,\n      signal,\n      judgeTimeoutMs,\n      uiLocale: locale,\n    });\n\n    if (evalResult.parseFailed) {\n      bumpParse();\n    } else {\n      resetParse();\n      next.checklist = applyJudgeChecklistUpdates(checklist, {\n        updates: evalResult.parsed.updates,\n        newItems: evalResult.parsed.newItems,\n      });\n    }\n\n    next.lastVerdict = 'continue';\n    next.lastReason = evalResult.parsed.reason;\n\n    const completedChecklistItemIndexes = evalResult.parsed.updates\n      .filter((update) => update.status === 'completed' || update.status === 'impossible')\n      .map((update) => update.index);\n    const structuredNextAction = evalResult.parsed.nextAction?.trim();\n    const continuationPrompt = structuredNextAction || buildContinuationPromptFromState(next, locale);\n\n    if (!evalResult.parseFailed && allChecklistTerminal(next.checklist ?? [])) {\n      next.status = 'done';\n      next.lastVerdict = 'done';\n      return {\n        newState: next,\n        shouldContinue: false,\n        continuationPrompt: null,\n        verdict: 'done',\n        reason: evalResult.parsed.reason,\n        message: copy.goalAchieved(evalResult.parsed.reason),\n        confidence: evalResult.parsed.confidence,\n        missingEvidence: evalResult.parsed.missingEvidence,\n        userQuestion: evalResult.parsed.userQuestion,\n        completedChecklistItemIndexes,\n      };\n    }\n\n    if (!evalResult.parseFailed && (evalResult.parsed.verdict === 'blocked' || evalResult.parsed.verdict === 'needs_input')) {\n      next.status = 'paused';\n      next.pausedReason = evalResult.parsed.reason;\n      return {\n        newState: next,\n        shouldContinue: false,\n        continuationPrompt: null,\n        verdict: evalResult.parsed.verdict,\n        reason: evalResult.parsed.reason,\n        message: evalResult.parsed.verdict === 'needs_input'\n          ? `Goal needs input: ${evalResult.parsed.userQuestion || evalResult.parsed.reason}`\n          : `Goal blocked: ${evalResult.parsed.reason}`,\n        confidence: evalResult.parsed.confidence,\n        missingEvidence: evalResult.parsed.missingEvidence,\n        userQuestion: evalResult.parsed.userQuestion,\n        completedChecklistItemIndexes,\n      };\n    }\n\n    const parseStorm = pauseIfParseStorm(evalResult.parsed.reason);\n    if (parseStorm) return parseStorm;\n\n    const budget = pauseIfBudget(evalResult.parsed.reason);\n    if (budget) return budget;\n\n    const { total, completed, impossible } = checklistCounts(next.checklist ?? []);\n    const done = completed + impossible;\n    const progressSuffix = checklistProgressSuffix(done, total, locale);\n\n    return {\n      newState: next,\n      shouldContinue: true,\n      continuationPrompt,\n      verdict: 'continue',\n      reason: evalResult.parsed.reason,\n      message: copy.continuingWithProgress(\n        next.turnsUsed,\n        next.maxTurns,\n        progressSuffix,\n        evalResult.parsed.reason,\n      ),\n      confidence: evalResult.parsed.confidence,\n      missingEvidence: evalResult.parsed.missingEvidence,\n      userQuestion: evalResult.parsed.userQuestion,\n      completedChecklistItemIndexes,\n    };\n  }\n\n  // ── Freeform judge (no checklist) ──\n  const j = await judgeGoalHermesStyle(state.goal, lastResponse, judgeModelRef, signal, {\n    judgeTimeoutMs,\n    uiLocale: locale,\n  });\n  next.lastVerdict = j.verdict === 'skipped' ? 'skipped' : j.verdict;\n  next.lastReason = j.reason;\n\n  if (j.parseFailed) bumpParse();\n  else resetParse();\n\n  if (j.verdict === 'done') {\n    next.status = 'done';\n    return {\n      newState: next,\n      shouldContinue: false,\n      continuationPrompt: null,\n      verdict: 'done',\n      reason: j.reason,\n      message: copy.goalAchieved(j.reason),\n    };\n  }\n\n  const parseStorm = pauseIfParseStorm(j.reason);\n  if (parseStorm) return parseStorm;\n\n  const budget = pauseIfBudget(j.reason);\n  if (budget) return budget;\n\n  return {\n    newState: next,\n    shouldContinue: true,\n    continuationPrompt: buildContinuationPromptFromState(next, locale),\n    verdict: 'continue',\n    reason: j.reason,\n    message: copy.continuing(next.turnsUsed, next.maxTurns, j.reason),\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/goals/goal-locale.js

@@ -1,7 +1,7 @@
-import { checklistCounts } from "./checklist-types.js";
-import { renderChecklistPlain } from "./state.js";
 import { formatI18n } from "../../i18n/format.js";
 import { SERVER_LOCALES, isServerLocale, normalizeServerLocale, serverLocaleOrFallback } from "../../i18n/locale.js";
+import { checklistCounts } from "./checklist-types.js";
+import { renderChecklistPlain } from "./state.js";
 import { JUDGE_REASON_EN, goalsChecklistProgressSuffix, goalsContinuationChecklistTemplate, goalsContinuationPlainTemplate, goalsEvaluateCopy, goalsJudgeReason, goalsJudgeResponseLanguageNote } from "../../i18n/goals-bundle.js";
 //#region src/agent/goals/goal-locale.ts
 const GOAL_UI_LOCALES = SERVER_LOCALES;

package/dist/src/agent/goals/persistent-goal-service.js

@@ -1,9 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { handlePersistentGoalPostTurn } from "./post-turn.js";
 //#region src/agent/goals/persistent-goal-service.ts
-init_session_key();
 init_logger();
 const log = createLogger("PersistentGoalService");
 var PersistentGoalService = class {
@@ -23,7 +21,7 @@ var PersistentGoalService = class {
 	* follow-up message as an inbound bus event so the existing inbound loop picks it up.
 	*/
 	scheduleContinuation(sessionKey, message, routing) {
-		if (parseSessionKey(sessionKey)?.source === "webchat" && this.webchatContinuationScheduler) {
+		if (routing.channel === "webchat" && this.webchatContinuationScheduler) {
 			this.webchatContinuationScheduler(sessionKey, message);
 			return;
 		}
@@ -94,7 +92,7 @@ var PersistentGoalService = class {
 			chatId: payload.chatId,
 			inboundMetadata: payload.outboundMetadata
 		});
-		const publishVerdict = !(parseSessionKey(payload.sessionKey)?.source === "webchat") && payload.channel !== "cli" ? async (text) => {
+		const publishVerdict = !(payload.channel === "webchat") && payload.channel !== "cli" ? async (text) => {
 			await this.opts.bus.publishOutbound({
 				channel: payload.channel,
 				chat_id: payload.chatId,

package/dist/src/agent/goals/persistent-goal-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistent-goal-service.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/goals/persistent-goal-service.ts"],"sourcesContent":["/**\n * PersistentGoalService — owns the \"/goal\" runtime: continuation scheduling,\n * the `PersistentGoalApis` bag that command handlers receive, and the post-turn\n * verdict hook called from `OutboundCoordinator`.\n *\n * Previously this logic was scattered across `AgentService`:\n *   - `setPersistentGoalWebchatContinuationScheduler` + a private callback field\n *   - `schedulePersistentGoalContinuation` (bus vs webchat fork)\n *   - `getPersistentGoalApisForCommand` (~40-line API factory)\n *   - `recordPersistentGoalStreamOutcome` / `takePersistentGoalStreamOutcome`\n *   - the `/goal` half of `emitSessionTurnComplete` (delegated to\n *     `handlePersistentGoalPostTurn`)\n *\n * Concentrating it here gives the rest of `AgentService` a cleaner surface\n * (one collaborator instead of five methods) and makes the goal runtime\n * unit-testable in isolation.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { SessionStateBag } from '../session/index.js';\nimport type { GoalWithDetails } from '../../goals/types.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport { handlePersistentGoalPostTurn } from './post-turn.js';\n\nconst log = createLogger('PersistentGoalService');\n\nexport interface PersistentGoalRouting {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface SessionTurnCompletionForGoal {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn?: boolean;\n  outboundMetadata?: Record<string, unknown>;\n}\n\nexport interface PersistentGoalServiceOptions {\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionState: SessionStateBag;\n  /** Effective config snapshot accessor. */\n  getConfig: () => Config | undefined;\n  /** Resolve the workspace directory for `appendAssistantReceipt` writes. */\n  getResolvedWorkspaceForSession: (sessionKey: string) => string;\n  /** Notify the gateway UI after a metadata change (replaces the in-bag emit). */\n  onSessionMetadataUpdated?: (sessionKey: string) => void;\n  /** Push an assistant token + transcript refresh into a live webchat stream. */\n  notifyWebchatTranscriptAppend: (sessionKey: string, assistantText: string) => void;\n  /** Gateway: durable goal status changed after post-turn judge. */\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: GoalWithDetails;\n  }) => void;\n}\n\nexport class PersistentGoalService {\n  private readonly opts: PersistentGoalServiceOptions;\n  /** Gateway only: webchat continuations bypass the bus and reuse `runGatewayAgent`. */\n  private webchatContinuationScheduler?: (sessionKey: string, message: string) => void;\n\n  constructor(opts: PersistentGoalServiceOptions) {\n    this.opts = opts;\n  }\n\n  /** Register the gateway-side webchat continuation hook (set from `web-agent` wiring). */\n  setWebchatContinuationScheduler(\n    fn: ((sessionKey: string, message: string) => void) | undefined,\n  ): void {\n    this.webchatContinuationScheduler = fn;\n  }\n\n  /**\n   * Continue a session after `/goal` decides the previous turn needs follow-up.\n   * Webchat sessions go through the scheduler; bus-driven channels re-publish the\n   * follow-up message as an inbound bus event so the existing inbound loop picks it up.\n   */\n  scheduleContinuation(\n    sessionKey: string,\n    message: string,\n    routing: { channel: string; chatId: string; inboundMetadata?: Record<string, unknown> },\n  ): void {\n    const parsed = parseRoutingSessionKey(sessionKey);\n    if (parsed?.source === 'webchat' && this.webchatContinuationScheduler) {\n      this.webchatContinuationScheduler(sessionKey, message);\n      return;\n    }\n    queueMicrotask(() => {\n      void this.opts.bus\n        .publishInbound({\n          channel: routing.channel,\n          chat_id: routing.chatId,\n          sender_id: 'persistent-goal',\n          content: message,\n          metadata: { sessionKey, ...routing.inboundMetadata },\n        })\n        .catch((err) => {\n          log.warn({ err, sessionKey }, 'Persistent goal: publishInbound failed');\n        });\n    });\n  }\n\n  /** Build the per-command `PersistentGoalApis` bag (transcript writers + scheduler closures). */\n  buildApisForRouting(routing: PersistentGoalRouting): PersistentGoalApis {\n    return {\n      getSessionMetadata: (k) => this.opts.sessionStore.getMetadata(k),\n      updateSessionMetadata: async (k, u) => {\n        await this.opts.sessionStore.updateMetadata(k, u);\n        this.opts.onSessionMetadataUpdated?.(k);\n      },\n      loadMessages: (k) => this.opts.sessionStore.loadMessages(k),\n      appendAssistantReceipt: async (k, text) => {\n        const trimmed = text.trim();\n        if (!trimmed) return;\n        await this.opts.sessionStore.appendTranscriptMessage(k, {\n          role: 'assistant',\n          content: [{ type: 'text', text: trimmed }],\n          timestamp: Date.now(),\n        } as AgentMessage);\n        this.opts.notifyWebchatTranscriptAppend(k, trimmed);\n      },\n      scheduleContinuation: (sk, msg) => {\n        this.scheduleContinuation(sk, msg, {\n          channel: routing.channel,\n          chatId: routing.chatId,\n          inboundMetadata: routing.inboundMetadata,\n        });\n      },\n      inboundConcurrentDepth: (sk) => this.opts.sessionState.getInboundTurnDepth(sk),\n    };\n  }\n\n  recordStreamOutcome(sessionKey: string, outcome: { skipPersistentGoalPostTurn: boolean }): void {\n    this.opts.sessionState.recordPersistentGoalStreamOutcome(sessionKey, outcome);\n  }\n\n  takeStreamOutcome(sessionKey: string): { skipPersistentGoalPostTurn: boolean } | undefined {\n    return this.opts.sessionState.takePersistentGoalStreamOutcome(sessionKey);\n  }\n\n  /**\n   * Run the `/goal` post-turn verdict for a completed user turn (called from\n   * `OutboundCoordinator.emitSessionTurnComplete`).\n   */\n  async runPostTurn(payload: SessionTurnCompletionForGoal): Promise<void> {\n    const apis = this.buildApisForRouting({\n      sessionKey: payload.sessionKey,\n      channel: payload.channel,\n      chatId: payload.chatId,\n      inboundMetadata: payload.outboundMetadata,\n    });\n\n    const src = parseRoutingSessionKey(payload.sessionKey)?.source;\n    const isWebchat = src === 'webchat';\n    const publishVerdict =\n      !isWebchat && payload.channel !== 'cli'\n        ? async (text: string) => {\n            await this.opts.bus.publishOutbound({\n              channel: payload.channel,\n              chat_id: payload.chatId,\n              content: text,\n              type: 'message',\n              metadata: {\n                accountId: payload.outboundMetadata?.accountId,\n                threadId: payload.outboundMetadata?.threadId,\n              },\n            });\n          }\n        : undefined;\n\n    let runtimeSessionModelRef: string | undefined;\n    try {\n      runtimeSessionModelRef = this.opts.modelManager.getModelForSession(payload.sessionKey);\n    } catch {\n      runtimeSessionModelRef = undefined;\n    }\n\n    await handlePersistentGoalPostTurn({\n      apis,\n      sessionKey: payload.sessionKey,\n      assistantPlainText: payload.assistantPlainText,\n      aborted: payload.aborted,\n      ...(payload.streamError !== undefined ? { streamError: payload.streamError } : {}),\n      skipPersistentGoalPostTurn: payload.skipPersistentGoalPostTurn ?? false,\n      config: this.opts.getConfig(),\n      runtimeSessionModelRef,\n      publishVerdictToChannel: publishVerdict,\n      onGoalStatusUpdated: this.opts.onGoalStatusUpdated,\n    });\n  }\n}\n"],"mappings":";;;;;kBA0ByF;aACpC;AAIrD,MAAM,MAAM,aAAa,wBAAwB;AA2CjD,IAAa,wBAAb,MAAmC;CACjC;;CAEA;CAEA,YAAY,MAAoC;AAC9C,OAAK,OAAO;;;CAId,gCACE,IACM;AACN,OAAK,+BAA+B;;;;;;;CAQtC,qBACE,YACA,SACA,SACM;AAEN,MADeA,gBAAuB,WAC5B,EAAE,WAAW,aAAa,KAAK,8BAA8B;AACrE,QAAK,6BAA6B,YAAY,QAAQ;AACtD;;AAEF,uBAAqB;AACd,QAAK,KAAK,IACZ,eAAe;IACd,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,WAAW;IACX,SAAS;IACT,UAAU;KAAE;KAAY,GAAG,QAAQ;KAAiB;IACrD,CAAC,CACD,OAAO,QAAQ;AACd,QAAI,KAAK;KAAE;KAAK;KAAY,EAAE,yCAAyC;KACvE;IACJ;;;CAIJ,oBAAoB,SAAoD;AACtE,SAAO;GACL,qBAAqB,MAAM,KAAK,KAAK,aAAa,YAAY,EAAE;GAChE,uBAAuB,OAAO,GAAG,MAAM;AACrC,UAAM,KAAK,KAAK,aAAa,eAAe,GAAG,EAAE;AACjD,SAAK,KAAK,2BAA2B,EAAE;;GAEzC,eAAe,MAAM,KAAK,KAAK,aAAa,aAAa,EAAE;GAC3D,wBAAwB,OAAO,GAAG,SAAS;IACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,QAAI,CAAC,QAAS;AACd,UAAM,KAAK,KAAK,aAAa,wBAAwB,GAAG;KACtD,MAAM;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAS,CAAC;KAC1C,WAAW,KAAK,KAAK;KACtB,CAAiB;AAClB,SAAK,KAAK,8BAA8B,GAAG,QAAQ;;GAErD,uBAAuB,IAAI,QAAQ;AACjC,SAAK,qBAAqB,IAAI,KAAK;KACjC,SAAS,QAAQ;KACjB,QAAQ,QAAQ;KAChB,iBAAiB,QAAQ;KAC1B,CAAC;;GAEJ,yBAAyB,OAAO,KAAK,KAAK,aAAa,oBAAoB,GAAG;GAC/E;;CAGH,oBAAoB,YAAoB,SAAwD;AAC9F,OAAK,KAAK,aAAa,kCAAkC,YAAY,QAAQ;;CAG/E,kBAAkB,YAAyE;AACzF,SAAO,KAAK,KAAK,aAAa,gCAAgC,WAAW;;;;;;CAO3E,MAAM,YAAY,SAAsD;EACtE,MAAM,OAAO,KAAK,oBAAoB;GACpC,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,iBAAiB,QAAQ;GAC1B,CAAC;EAIF,MAAM,iBACJ,EAHUA,gBAAuB,QAAQ,WAAW,EAAE,WAC9B,cAEV,QAAQ,YAAY,QAC9B,OAAO,SAAiB;AACtB,SAAM,KAAK,KAAK,IAAI,gBAAgB;IAClC,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,SAAS;IACT,MAAM;IACN,UAAU;KACR,WAAW,QAAQ,kBAAkB;KACrC,UAAU,QAAQ,kBAAkB;KACrC;IACF,CAAC;MAEJ,KAAA;EAEN,IAAI;AACJ,MAAI;AACF,4BAAyB,KAAK,KAAK,aAAa,mBAAmB,QAAQ,WAAW;UAChF;AACN,4BAAyB,KAAA;;AAG3B,QAAM,6BAA6B;GACjC;GACA,YAAY,QAAQ;GACpB,oBAAoB,QAAQ;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,gBAAgB,KAAA,IAAY,EAAE,aAAa,QAAQ,aAAa,GAAG,EAAE;GACjF,4BAA4B,QAAQ,8BAA8B;GAClE,QAAQ,KAAK,KAAK,WAAW;GAC7B;GACA,yBAAyB;GACzB,qBAAqB,KAAK,KAAK;GAChC,CAAC"}
+{"version":3,"file":"persistent-goal-service.js","names":[],"sources":["../../../../src/agent/goals/persistent-goal-service.ts"],"sourcesContent":["/**\n * PersistentGoalService — owns the \"/goal\" runtime: continuation scheduling,\n * the `PersistentGoalApis` bag that command handlers receive, and the post-turn\n * verdict hook called from `OutboundCoordinator`.\n *\n * Previously this logic was scattered across `AgentService`:\n *   - `setPersistentGoalWebchatContinuationScheduler` + a private callback field\n *   - `schedulePersistentGoalContinuation` (bus vs webchat fork)\n *   - `getPersistentGoalApisForCommand` (~40-line API factory)\n *   - `recordPersistentGoalStreamOutcome` / `takePersistentGoalStreamOutcome`\n *   - the `/goal` half of `emitSessionTurnComplete` (delegated to\n *     `handlePersistentGoalPostTurn`)\n *\n * Concentrating it here gives the rest of `AgentService` a cleaner surface\n * (one collaborator instead of five methods) and makes the goal runtime\n * unit-testable in isolation.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { SessionStateBag } from '../session/index.js';\nimport type { GoalWithDetails } from '../../goals/types.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport { handlePersistentGoalPostTurn } from './post-turn.js';\n\nconst log = createLogger('PersistentGoalService');\n\nexport interface PersistentGoalRouting {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  inboundMetadata?: Record<string, unknown>;\n}\n\nexport interface SessionTurnCompletionForGoal {\n  sessionKey: string;\n  channel: string;\n  chatId: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn?: boolean;\n  outboundMetadata?: Record<string, unknown>;\n}\n\nexport interface PersistentGoalServiceOptions {\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n  sessionState: SessionStateBag;\n  /** Effective config snapshot accessor. */\n  getConfig: () => Config | undefined;\n  /** Resolve the workspace directory for `appendAssistantReceipt` writes. */\n  getResolvedWorkspaceForSession: (sessionKey: string) => string;\n  /** Notify the gateway UI after a metadata change (replaces the in-bag emit). */\n  onSessionMetadataUpdated?: (sessionKey: string) => void;\n  /** Push an assistant token + transcript refresh into a live webchat stream. */\n  notifyWebchatTranscriptAppend: (sessionKey: string, assistantText: string) => void;\n  /** Gateway: durable goal status changed after post-turn judge. */\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: GoalWithDetails;\n  }) => void;\n}\n\nexport class PersistentGoalService {\n  private readonly opts: PersistentGoalServiceOptions;\n  /** Gateway only: webchat continuations bypass the bus and reuse `runGatewayAgent`. */\n  private webchatContinuationScheduler?: (sessionKey: string, message: string) => void;\n\n  constructor(opts: PersistentGoalServiceOptions) {\n    this.opts = opts;\n  }\n\n  /** Register the gateway-side webchat continuation hook (set from `web-agent` wiring). */\n  setWebchatContinuationScheduler(\n    fn: ((sessionKey: string, message: string) => void) | undefined,\n  ): void {\n    this.webchatContinuationScheduler = fn;\n  }\n\n  /**\n   * Continue a session after `/goal` decides the previous turn needs follow-up.\n   * Webchat sessions go through the scheduler; bus-driven channels re-publish the\n   * follow-up message as an inbound bus event so the existing inbound loop picks it up.\n   */\n  scheduleContinuation(\n    sessionKey: string,\n    message: string,\n    routing: { channel: string; chatId: string; inboundMetadata?: Record<string, unknown> },\n  ): void {\n    if (routing.channel === 'webchat' && this.webchatContinuationScheduler) {\n      this.webchatContinuationScheduler(sessionKey, message);\n      return;\n    }\n    queueMicrotask(() => {\n      void this.opts.bus\n        .publishInbound({\n          channel: routing.channel,\n          chat_id: routing.chatId,\n          sender_id: 'persistent-goal',\n          content: message,\n          metadata: { sessionKey, ...routing.inboundMetadata },\n        })\n        .catch((err) => {\n          log.warn({ err, sessionKey }, 'Persistent goal: publishInbound failed');\n        });\n    });\n  }\n\n  /** Build the per-command `PersistentGoalApis` bag (transcript writers + scheduler closures). */\n  buildApisForRouting(routing: PersistentGoalRouting): PersistentGoalApis {\n    return {\n      getSessionMetadata: (k) => this.opts.sessionStore.getMetadata(k),\n      updateSessionMetadata: async (k, u) => {\n        await this.opts.sessionStore.updateMetadata(k, u);\n        this.opts.onSessionMetadataUpdated?.(k);\n      },\n      loadMessages: (k) => this.opts.sessionStore.loadMessages(k),\n      appendAssistantReceipt: async (k, text) => {\n        const trimmed = text.trim();\n        if (!trimmed) return;\n        await this.opts.sessionStore.appendTranscriptMessage(k, {\n          role: 'assistant',\n          content: [{ type: 'text', text: trimmed }],\n          timestamp: Date.now(),\n        } as AgentMessage);\n        this.opts.notifyWebchatTranscriptAppend(k, trimmed);\n      },\n      scheduleContinuation: (sk, msg) => {\n        this.scheduleContinuation(sk, msg, {\n          channel: routing.channel,\n          chatId: routing.chatId,\n          inboundMetadata: routing.inboundMetadata,\n        });\n      },\n      inboundConcurrentDepth: (sk) => this.opts.sessionState.getInboundTurnDepth(sk),\n    };\n  }\n\n  recordStreamOutcome(sessionKey: string, outcome: { skipPersistentGoalPostTurn: boolean }): void {\n    this.opts.sessionState.recordPersistentGoalStreamOutcome(sessionKey, outcome);\n  }\n\n  takeStreamOutcome(sessionKey: string): { skipPersistentGoalPostTurn: boolean } | undefined {\n    return this.opts.sessionState.takePersistentGoalStreamOutcome(sessionKey);\n  }\n\n  /**\n   * Run the `/goal` post-turn verdict for a completed user turn (called from\n   * `OutboundCoordinator.emitSessionTurnComplete`).\n   */\n  async runPostTurn(payload: SessionTurnCompletionForGoal): Promise<void> {\n    const apis = this.buildApisForRouting({\n      sessionKey: payload.sessionKey,\n      channel: payload.channel,\n      chatId: payload.chatId,\n      inboundMetadata: payload.outboundMetadata,\n    });\n\n    const isWebchat = payload.channel === 'webchat';\n    const publishVerdict =\n      !isWebchat && payload.channel !== 'cli'\n        ? async (text: string) => {\n            await this.opts.bus.publishOutbound({\n              channel: payload.channel,\n              chat_id: payload.chatId,\n              content: text,\n              type: 'message',\n              metadata: {\n                accountId: payload.outboundMetadata?.accountId,\n                threadId: payload.outboundMetadata?.threadId,\n              },\n            });\n          }\n        : undefined;\n\n    let runtimeSessionModelRef: string | undefined;\n    try {\n      runtimeSessionModelRef = this.opts.modelManager.getModelForSession(payload.sessionKey);\n    } catch {\n      runtimeSessionModelRef = undefined;\n    }\n\n    await handlePersistentGoalPostTurn({\n      apis,\n      sessionKey: payload.sessionKey,\n      assistantPlainText: payload.assistantPlainText,\n      aborted: payload.aborted,\n      ...(payload.streamError !== undefined ? { streamError: payload.streamError } : {}),\n      skipPersistentGoalPostTurn: payload.skipPersistentGoalPostTurn ?? false,\n      config: this.opts.getConfig(),\n      runtimeSessionModelRef,\n      publishVerdictToChannel: publishVerdict,\n      onGoalStatusUpdated: this.opts.onGoalStatusUpdated,\n    });\n  }\n}\n"],"mappings":";;;;aA0BqD;AAIrD,MAAM,MAAM,aAAa,wBAAwB;AA2CjD,IAAa,wBAAb,MAAmC;CACjC;;CAEA;CAEA,YAAY,MAAoC;AAC9C,OAAK,OAAO;;;CAId,gCACE,IACM;AACN,OAAK,+BAA+B;;;;;;;CAQtC,qBACE,YACA,SACA,SACM;AACN,MAAI,QAAQ,YAAY,aAAa,KAAK,8BAA8B;AACtE,QAAK,6BAA6B,YAAY,QAAQ;AACtD;;AAEF,uBAAqB;AACd,QAAK,KAAK,IACZ,eAAe;IACd,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,WAAW;IACX,SAAS;IACT,UAAU;KAAE;KAAY,GAAG,QAAQ;KAAiB;IACrD,CAAC,CACD,OAAO,QAAQ;AACd,QAAI,KAAK;KAAE;KAAK;KAAY,EAAE,yCAAyC;KACvE;IACJ;;;CAIJ,oBAAoB,SAAoD;AACtE,SAAO;GACL,qBAAqB,MAAM,KAAK,KAAK,aAAa,YAAY,EAAE;GAChE,uBAAuB,OAAO,GAAG,MAAM;AACrC,UAAM,KAAK,KAAK,aAAa,eAAe,GAAG,EAAE;AACjD,SAAK,KAAK,2BAA2B,EAAE;;GAEzC,eAAe,MAAM,KAAK,KAAK,aAAa,aAAa,EAAE;GAC3D,wBAAwB,OAAO,GAAG,SAAS;IACzC,MAAM,UAAU,KAAK,MAAM;AAC3B,QAAI,CAAC,QAAS;AACd,UAAM,KAAK,KAAK,aAAa,wBAAwB,GAAG;KACtD,MAAM;KACN,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM;MAAS,CAAC;KAC1C,WAAW,KAAK,KAAK;KACtB,CAAiB;AAClB,SAAK,KAAK,8BAA8B,GAAG,QAAQ;;GAErD,uBAAuB,IAAI,QAAQ;AACjC,SAAK,qBAAqB,IAAI,KAAK;KACjC,SAAS,QAAQ;KACjB,QAAQ,QAAQ;KAChB,iBAAiB,QAAQ;KAC1B,CAAC;;GAEJ,yBAAyB,OAAO,KAAK,KAAK,aAAa,oBAAoB,GAAG;GAC/E;;CAGH,oBAAoB,YAAoB,SAAwD;AAC9F,OAAK,KAAK,aAAa,kCAAkC,YAAY,QAAQ;;CAG/E,kBAAkB,YAAyE;AACzF,SAAO,KAAK,KAAK,aAAa,gCAAgC,WAAW;;;;;;CAO3E,MAAM,YAAY,SAAsD;EACtE,MAAM,OAAO,KAAK,oBAAoB;GACpC,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,QAAQ,QAAQ;GAChB,iBAAiB,QAAQ;GAC1B,CAAC;EAGF,MAAM,iBACJ,EAFgB,QAAQ,YAAY,cAEtB,QAAQ,YAAY,QAC9B,OAAO,SAAiB;AACtB,SAAM,KAAK,KAAK,IAAI,gBAAgB;IAClC,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,SAAS;IACT,MAAM;IACN,UAAU;KACR,WAAW,QAAQ,kBAAkB;KACrC,UAAU,QAAQ,kBAAkB;KACrC;IACF,CAAC;MAEJ,KAAA;EAEN,IAAI;AACJ,MAAI;AACF,4BAAyB,KAAK,KAAK,aAAa,mBAAmB,QAAQ,WAAW;UAChF;AACN,4BAAyB,KAAA;;AAG3B,QAAM,6BAA6B;GACjC;GACA,YAAY,QAAQ;GACpB,oBAAoB,QAAQ;GAC5B,SAAS,QAAQ;GACjB,GAAI,QAAQ,gBAAgB,KAAA,IAAY,EAAE,aAAa,QAAQ,aAAa,GAAG,EAAE;GACjF,4BAA4B,QAAQ,8BAA8B;GAClE,QAAQ,KAAK,KAAK,WAAW;GAC7B;GACA,yBAAyB;GACzB,qBAAqB,KAAK,KAAK;GAChC,CAAC"}

package/dist/src/agent/goals/post-turn.d.ts

@@ -1,5 +1,10 @@
-import type { Config } from '../../config/schema.js';
+import type { Config, GoalsConfig } from '../../config/schema.js';
 import type { PersistentGoalApis } from './persistent-goal-apis.js';
+export declare function shouldRunInitialChecklistDecomposition(input: {
+    checklistLength: number;
+    turnsUsed: number;
+    checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];
+}): boolean;
 export declare function handlePersistentGoalPostTurn(opts: {
     apis: PersistentGoalApis;
     sessionKey: string;

package/dist/src/agent/goals/post-turn.js

@@ -1,9 +1,9 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
-import { resolveGoalUiLocale } from "./goal-locale.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
 import { GoalService } from "../../goals/goal-service.js";
+import { resolveGoalUiLocale } from "./goal-locale.js";
 import { evaluateAfterTurnHermesLike } from "./evaluate-turn.js";
 import "../../goals/index.js";
 //#region src/agent/goals/post-turn.ts
@@ -32,6 +32,10 @@ function resolveJudgeModelRef(config, sessionKey, storedJudge, runtimeSessionMod
 	if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();
 	if (config) return getAgentDefaultModelRef(config);
 }
+function shouldRunInitialChecklistDecomposition(input) {
+	if (input.checklistLength === 0) return true;
+	return input.checklistDecomposePolicy === "supplement_existing" && input.turnsUsed === 0;
+}
 async function appendAssistantLine(apis, sessionKey, text) {
 	await apis.appendAssistantReceipt(sessionKey, text);
 }
@@ -42,6 +46,12 @@ async function handlePersistentGoalPostTurn(opts) {
 	if (!await apis.getSessionMetadata(sessionKey)) return;
 	const goal = goalService.getActiveForSession(sessionKey);
 	if (!goal || goal.status !== "active") return;
+	const goalsCfg = config?.goals;
+	const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({
+		checklistLength: goal.checklist.length,
+		turnsUsed: goal.turnsUsed,
+		checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy
+	});
 	const state = {
 		goal: goal.title,
 		status: "active",
@@ -51,7 +61,7 @@ async function handlePersistentGoalPostTurn(opts) {
 		lastTurnAt: goal.updatedAt,
 		lastReason: goal.blockedReason,
 		judgeModelRef: goal.judgeModelRef,
-		decomposed: goal.checklist.length > 0 ? true : void 0,
+		decomposed: shouldDecomposeChecklist ? void 0 : true,
 		uiLocale: goal.uiLocale,
 		checklist: goal.checklist.map((it) => ({
 			text: it.text,
@@ -67,7 +77,6 @@ async function handlePersistentGoalPostTurn(opts) {
 		log.warn({ sessionKey }, "Persistent goal: no judge model ref; skipping post-turn");
 		return;
 	}
-	const goalsCfg = config?.goals;
 	const historyCap = goalsCfg?.checklistHistoryChars ?? 24e3;
 	let historyExcerpt = "";
 	try {
@@ -145,6 +154,6 @@ async function handlePersistentGoalPostTurn(opts) {
 	if (decision.shouldContinue && decision.continuationPrompt) apis.scheduleContinuation(sessionKey, decision.continuationPrompt);
 }
 //#endregion
-export { handlePersistentGoalPostTurn };
+export { handlePersistentGoalPostTurn, shouldRunInitialChecklistDecomposition };
 
 //# sourceMappingURL=post-turn.js.map

package/dist/src/agent/goals/post-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const state: PersistentGoalState = {\n    goal: goal.title,\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: goal.checklist.length > 0 ? true : undefined,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const goalsCfg = config?.goals;\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  const decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"post-turn.js","names":[],"sources":["../../../../src/agent/goals/post-turn.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { Config, GoalsConfig } from '../../config/schema.js';\nimport { getAgentDefaultModelRef } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport { GoalService } from '../../goals/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nimport { evaluateAfterTurnHermesLike } from './evaluate-turn.js';\nimport { resolveGoalUiLocale } from './goal-locale.js';\nimport type { PersistentGoalApis } from './persistent-goal-apis.js';\nimport type { PersistentGoalState } from './state.js';\n\nconst log = createLogger('PersistentGoal');\nconst goalService = new GoalService();\n\nfunction buildHistoryExcerpt(messages: AgentMessage[], maxChars: number): string {\n  if (maxChars <= 0) return '';\n  try {\n    const raw = JSON.stringify(messages);\n    if (raw.length <= maxChars) return raw;\n    return raw.slice(-maxChars);\n  } catch {\n    return '';\n  }\n}\n\nfunction resolveJudgeModelRef(\n  config: Config | undefined,\n  sessionKey: string,\n  storedJudge?: string,\n  runtimeSessionModelRef?: string,\n): string | undefined {\n  const fromCfg = config?.goals?.judgeModelRef?.trim();\n  if (fromCfg) return fromCfg;\n  if (storedJudge?.trim()) return storedJudge.trim();\n  if (config) {\n    const profile = resolveEffectiveAgentProfileForSession(config, sessionKey);\n    if (profile.primaryModelRef?.trim()) return profile.primaryModelRef.trim();\n  }\n  if (runtimeSessionModelRef?.trim()) return runtimeSessionModelRef.trim();\n  if (config) return getAgentDefaultModelRef(config);\n  return undefined;\n}\n\nexport function shouldRunInitialChecklistDecomposition(input: {\n  checklistLength: number;\n  turnsUsed: number;\n  checklistDecomposePolicy?: GoalsConfig['checklistDecomposePolicy'];\n}): boolean {\n  if (input.checklistLength === 0) return true;\n  return input.checklistDecomposePolicy === 'supplement_existing' && input.turnsUsed === 0;\n}\n\nasync function appendAssistantLine(apis: PersistentGoalApis, sessionKey: string, text: string): Promise<void> {\n  await apis.appendAssistantReceipt(sessionKey, text);\n}\n\nexport async function handlePersistentGoalPostTurn(opts: {\n  apis: PersistentGoalApis;\n  sessionKey: string;\n  assistantPlainText: string;\n  aborted: boolean;\n  streamError?: string;\n  skipPersistentGoalPostTurn: boolean;\n  config: Config | undefined;\n  /** Active session model (overrides, per-agent defaults) when goals/global defaults are unset. */\n  runtimeSessionModelRef?: string;\n  signal?: AbortSignal;\n  /** Hermes-style: verdict line also sent as a normal outbound message (non-webchat). */\n  publishVerdictToChannel?: (text: string) => Promise<void>;\n  onGoalStatusUpdated?: (payload: {\n    goalId: string;\n    sessionKey: string;\n    previousStatus: string;\n    status: string;\n    goal: import('../../goals/types.js').GoalWithDetails;\n  }) => void;\n}): Promise<void> {\n  const {\n    apis,\n    sessionKey,\n    assistantPlainText,\n    aborted,\n    streamError,\n    skipPersistentGoalPostTurn,\n    config,\n    runtimeSessionModelRef,\n    signal,\n    publishVerdictToChannel,\n    onGoalStatusUpdated,\n  } = opts;\n\n  if (skipPersistentGoalPostTurn) return;\n  if (aborted || streamError) return;\n\n  const meta = await apis.getSessionMetadata(sessionKey);\n  if (!meta) return;\n\n  const goal = goalService.getActiveForSession(sessionKey);\n  if (!goal || goal.status !== 'active') return;\n\n  const goalsCfg = config?.goals;\n  const shouldDecomposeChecklist = shouldRunInitialChecklistDecomposition({\n    checklistLength: goal.checklist.length,\n    turnsUsed: goal.turnsUsed,\n    checklistDecomposePolicy: goalsCfg?.checklistDecomposePolicy,\n  });\n  const state: PersistentGoalState = {\n    goal: goal.title,\n    status: 'active',\n    turnsUsed: goal.turnsUsed,\n    maxTurns: goal.maxTurns,\n    createdAt: goal.createdAt,\n    lastTurnAt: goal.updatedAt,\n    lastReason: goal.blockedReason,\n    judgeModelRef: goal.judgeModelRef,\n    decomposed: shouldDecomposeChecklist ? undefined : true,\n    uiLocale: goal.uiLocale,\n    checklist: goal.checklist.map((it) => ({\n      text: it.text,\n      status: it.status,\n      addedBy: it.addedBy,\n      addedAt: it.addedAt,\n      completedAt: it.completedAt,\n      evidence: it.evidenceSummary,\n    })),\n  };\n\n  const judgeRef = resolveJudgeModelRef(config, sessionKey, state.judgeModelRef, runtimeSessionModelRef);\n  if (!judgeRef) {\n    log.warn({ sessionKey }, 'Persistent goal: no judge model ref; skipping post-turn');\n    return;\n  }\n\n  const historyCap = goalsCfg?.checklistHistoryChars ?? 24_000;\n  let historyExcerpt = '';\n  try {\n    const msgs = await apis.loadMessages(sessionKey);\n    historyExcerpt = buildHistoryExcerpt(msgs, historyCap);\n  } catch (err) {\n    log.debug(\n      { err, sessionKey },\n      `Persistent goal: could not load messages for judge context: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n\n  const decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {\n    goalsSlice: goalsCfg,\n    historyExcerpt,\n    uiLocale: resolveGoalUiLocale(state),\n  });\n\n  if (decision.newState) {\n    const ns = decision.newState;\n    const completedChecklistItemIds = decision.completedChecklistItemIndexes\n      ?.map((index) => goal.checklist[index]?.id)\n      .filter((id): id is string => typeof id === 'string' && id.length > 0);\n    try {\n      const updatedGoal = goalService.syncPostTurnState({\n        goalId: goal.id,\n        sessionKey,\n        source: 'chat',\n        status: ns.status === 'done'\n          ? 'done'\n          : decision.verdict === 'blocked'\n            ? 'blocked'\n            : decision.verdict === 'needs_input'\n              ? 'needs_input'\n              : ns.status === 'paused'\n                ? 'paused'\n                : 'active',\n        turnsUsed: ns.turnsUsed,\n        maxTurns: ns.maxTurns,\n        reason: ns.pausedReason ?? decision.reason,\n        nextAction: decision.continuationPrompt ?? undefined,\n        assistantPreview: assistantPlainText,\n        verdict: decision.verdict === 'done'\n          ? 'done'\n          : decision.verdict === 'decompose'\n            ? 'decompose'\n            : decision.verdict === 'blocked'\n              ? 'blocked'\n              : decision.verdict === 'needs_input'\n                ? 'needs_input'\n                : 'continue',\n        confidence: decision.confidence,\n        missingEvidence: decision.missingEvidence,\n        userQuestion: decision.userQuestion,\n        completedChecklistItemIds,\n        checklist: ns.checklist?.map((it) => ({\n          text: it.text,\n          status: it.status,\n          addedBy: it.addedBy,\n          addedAt: it.addedAt,\n          completedAt: it.completedAt,\n          evidenceSummary: it.evidence,\n        })),\n      });\n      if (updatedGoal && updatedGoal.status !== goal.status) {\n        onGoalStatusUpdated?.({\n          goalId: goal.id,\n          sessionKey,\n          previousStatus: goal.status,\n          status: updatedGoal.status,\n          goal: updatedGoal,\n        });\n      }\n    } catch (err) {\n      log.warn(\n        { err, sessionKey, goalId: goal.id },\n        `Persistent goal: SQLite goal update failed: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n  }\n\n  if (decision.message) {\n    if (publishVerdictToChannel) {\n      try {\n        await publishVerdictToChannel(decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: channel verdict send failed: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      try {\n        await appendAssistantLine(apis, sessionKey, decision.message);\n      } catch (err) {\n        log.warn(\n          { err, sessionKey },\n          `Persistent goal: failed to append status message: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n  }\n\n  if (decision.shouldContinue && decision.continuationPrompt) {\n    apis.scheduleContinuation(sessionKey, decision.continuationPrompt);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/image/load-image-media.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { decodeDataUrl } from "./image-helpers.js";
-import { promises } from "node:fs";
-import path from "node:path";
 import { homedir } from "node:os";
+import path from "node:path";
+import { promises } from "node:fs";
 //#region src/agent/image/load-image-media.ts
 function expandUser(p) {
 	if (p.startsWith("~/") || p === "~") return path.join(homedir(), p.slice(1));

package/dist/src/agent/inbound/inbound-loop.js

@@ -85,7 +85,11 @@ var InboundLoop = class {
 				isGroup: context.isGroup || false,
 				metadata: { transcribedVoice: msg.metadata?.transcribedVoice === true }
 			};
-			updateAsyncLogContext({ sessionId: sessionContext.sessionKey });
+			const sessionMetadata = await this.cfg.sessionStore.getMetadata(sessionContext.sessionKey).catch(() => null);
+			updateAsyncLogContext({
+				sessionKey: sessionContext.sessionKey,
+				...sessionMetadata?.sessionId ? { sessionId: sessionMetadata.sessionId } : {}
+			});
 			await this.cfg.sessionContextManager.runWith(sessionContext, async () => {
 				this.cfg.feedbackCoordinator.setContext(sessionContext);
 				this.cfg.agentManager.getOrCreateAgent(sessionContext.sessionKey);

package/dist/src/agent/inbound/inbound-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-loop.js","names":[],"sources":["../../../../src/agent/inbound/inbound-loop.ts"],"sourcesContent":["/**\n * InboundLoop — owns the bus-driven inbound pipeline.\n *\n * Replaces the previous `AgentService.start()` while-loop, `handleInboundMessage`,\n * and `handleSystemMessage` methods. Everything that \"a message arrives, run the\n * agent turn, publish the reply\" needs is concentrated here; the parent\n * `AgentService` now just constructs the loop with collaborators and forwards\n * start/stop to it.\n *\n * The constructor takes a fairly wide config because handling a single inbound\n * message touches almost every subsystem (router, command handler, lifecycle\n * manager, agent orchestrator, outbound coordinator, session state, etc.). All\n * dependencies are injected so this class is unit-testable and the inbound\n * pipeline can evolve without touching `AgentService`.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { MessageBus, InboundMessage } from '../../infra/bus/index.js';\nimport { MessageBusShutdownError } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { ChannelManager } from '../../channels/manager.js';\nimport { runWithLogContext, updateAsyncLogContext } from '../../utils/logger.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { AgentOrchestrator } from '../orchestration/index.js';\nimport type { CommandHandler, OutboundCoordinator, StreamManager } from '../messaging/index.js';\nimport type { MessageRouter } from '../messaging/message-router.js';\nimport type { ModelManager } from '../models/index.js';\nimport type {\n  SessionContext,\n  SessionContextManager,\n  SessionHydrator,\n  SessionLifecycleManager,\n  SessionStateBag,\n} from '../session/index.js';\nimport type { FeedbackCoordinator } from '../feedback/index.js';\nimport type { HookHandler } from '../lifecycle/hook-handler.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { initSessionTurn } from '../../session/init-session-turn.js';\nimport { shouldSkipResetOverlapCommand } from '../../session/reset-triggers.js';\nimport type { StreamHandle } from '../service.types.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport { inboundMessageLogRequestId } from '../service-inbound-utils.js';\n\n/** Initial back-off when bus consume fails. Doubles each consecutive failure. */\nconst INBOUND_CONSUME_BASE_BACKOFF_MS = 1_000;\n/** Hard cap on back-off so a long bus outage settles at one retry per 30s. */\nconst INBOUND_CONSUME_MAX_BACKOFF_MS = 30_000;\n\nexport interface InboundLoopConfig {\n  log: ContextualLogger;\n  agentId: string;\n  bus: MessageBus;\n  hookHandler: HookHandler;\n  messageRouter: MessageRouter;\n  commandHandler: CommandHandler;\n  sessionContextManager: SessionContextManager;\n  feedbackCoordinator: FeedbackCoordinator;\n  agentManager: AgentManager;\n  sessionLifecycleManager: SessionLifecycleManager;\n  agentOrchestrator: AgentOrchestrator;\n  outboundCoordinator: OutboundCoordinator;\n  streamManager: StreamManager;\n  sessionState: SessionStateBag;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n\n  /** Register a per-session agent-event subscription (idempotent). */\n  setupSessionEventHandling: (sessionKey: string) => void;\n  /** Per-session config hydration (workspace + model override) before a turn runs. */\n  sessionHydrator: SessionHydrator;\n  /** Returns the visible last assistant text used for outbound + persistent-goal hook. */\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  /** Pre-turn auto-compaction (only used by system messages). */\n  checkAndCompact: (sessionKey: string, messages: AgentMessage[]) => Promise<void>;\n  /** Fire-and-forget auto-title (no-ops for cron/heartbeat keys). */\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  /** Effective merged config snapshot. */\n  getConfig: () => Config | undefined;\n  /** Archive transcript + new session id (freshness / reset trigger rollover). */\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n  /** Connect a channel stream handle for partial assistant text rendering. */\n  setStreamHandle: (handle: StreamHandle) => void;\n}\n\nexport class InboundLoop {\n  private readonly cfg: InboundLoopConfig;\n  private readonly log: ContextualLogger;\n  private running = false;\n  private channelManagerRef: ChannelManager | null = null;\n\n  constructor(cfg: InboundLoopConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  setChannelManager(channelManager: ChannelManager | null): void {\n    this.channelManagerRef = channelManager;\n  }\n\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  /** Begin consuming inbound messages from the bus until {@link stop} or shutdown. */\n  async start(): Promise<void> {\n    this.running = true;\n    await this.cfg.hookHandler.trigger('session_start', { sessionId: this.cfg.agentId });\n\n    // Errors fall into two buckets:\n    //   1. `bus.consumeInbound()` itself threw → infrastructure problem; back off\n    //      exponentially so a flapping bus does not pin the CPU at 100%.\n    //   2. `handleInboundMessage(msg)` threw → per-message handler bug. The\n    //      message is already lost; do NOT sleep, just log and move on so\n    //      legitimate traffic is not held hostage.\n    // Shutdown (`MessageBusShutdownError`) is the only signal that breaks the loop.\n    let consecutiveConsumeFailures = 0;\n\n    while (this.running) {\n      let msg: InboundMessage;\n      try {\n        msg = await this.cfg.bus.consumeInbound();\n        consecutiveConsumeFailures = 0;\n      } catch (error) {\n        if (error instanceof MessageBusShutdownError) {\n          break;\n        }\n        consecutiveConsumeFailures += 1;\n        const delayMs = Math.min(\n          INBOUND_CONSUME_MAX_BACKOFF_MS,\n          INBOUND_CONSUME_BASE_BACKOFF_MS * 2 ** (consecutiveConsumeFailures - 1),\n        );\n        const em = error instanceof Error ? error.message : String(error);\n        this.log.error(\n          {\n            err: error,\n            errorMessage: em,\n            phase: 'inbound_consume',\n            consecutiveFailures: consecutiveConsumeFailures,\n            backoffMs: delayMs,\n          },\n          `Bus consume failed (backing off ${delayMs}ms): ${em}`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n        continue;\n      }\n\n      try {\n        await this.handleInboundMessage(msg);\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        this.log.error(\n          {\n            err: error,\n            errorMessage: em,\n            phase: 'inbound_handle',\n            channel: msg.channel,\n            chatId: msg.chat_id,\n          },\n          `Inbound message handler failed: ${em}`,\n        );\n        // Per-message failure: keep consuming. The next message is independent.\n      }\n    }\n\n    await this.cfg.hookHandler.trigger('session_end', {\n      sessionId: this.cfg.agentId,\n      messageCount: 0,\n    });\n  }\n\n  /** Cooperatively stop the loop; the current message (if any) is allowed to finish. */\n  stop(): void {\n    this.running = false;\n  }\n\n  private async handleInboundMessage(msg: InboundMessage): Promise<void> {\n    const requestId = inboundMessageLogRequestId(msg);\n\n    await runWithLogContext({ requestId }, async () => {\n      const routing = await this.cfg.messageRouter.routeMessage(msg);\n      const { context, isCommand, command, commandArgs } = routing;\n\n      const sessionContext: SessionContext = {\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        senderId: context.senderId || '',\n        isGroup: context.isGroup || false,\n        metadata: {\n          transcribedVoice: msg.metadata?.transcribedVoice === true,\n        },\n      };\n\n      updateAsyncLogContext({ sessionId: sessionContext.sessionKey });\n\n      await this.cfg.sessionContextManager.runWith(sessionContext, async () => {\n        this.cfg.feedbackCoordinator.setContext(sessionContext);\n\n        // `subscribeToSession` requires an Agent instance; without this the first inbound never\n        // registers `message_update` streaming (second turn behaved differently).\n        this.cfg.agentManager.getOrCreateAgent(sessionContext.sessionKey);\n        this.cfg.setupSessionEventHandling(sessionContext.sessionKey);\n\n        await this.cfg.sessionLifecycleManager.startSession(sessionContext);\n\n        let typingController: ReturnType<OutboundCoordinator['createTypingControllerForInbound']> = null;\n        let inboundTurnArmed = false;\n        let busProcessFailed: string | undefined;\n        let inboundMsg = msg;\n\n        try {\n          if (msg.channel === 'system') {\n            await this.handleSystemMessage(msg, sessionContext);\n            return;\n          }\n\n          if (this.channelManagerRef && msg.channel !== 'cli') {\n            await this.channelManagerRef.dispatchInboundMessageAction(msg);\n          }\n\n          const cfg = this.cfg.getConfig();\n          let effectiveContent = msg.content;\n          let resetTriggeredAtInit = false;\n\n          if (cfg && typeof msg.content === 'string') {\n            const turn = await initSessionTurn({\n              cfg,\n              sessionKey: sessionContext.sessionKey,\n              body: msg.content,\n              resetSession: (sk) => this.cfg.resetSession(sk),\n            });\n            resetTriggeredAtInit = turn.resetTriggered;\n\n            if (turn.bareReset && turn.ackMessage) {\n              await this.cfg.bus.publishOutbound({\n                channel: sessionContext.channel,\n                chat_id: sessionContext.chatId,\n                content: turn.ackMessage,\n                type: 'message',\n              });\n              return;\n            }\n\n            effectiveContent = turn.bodyStripped;\n          }\n\n          if (isCommand && command) {\n            if (!shouldSkipResetOverlapCommand(command, resetTriggeredAtInit)) {\n              const handled = await this.cfg.commandHandler.executeCommand(command, commandArgs || '', {\n                sessionKey: sessionContext.sessionKey,\n                channel: sessionContext.channel,\n                chatId: sessionContext.chatId,\n                senderId: sessionContext.senderId,\n                isGroup: sessionContext.isGroup,\n                inboundMetadata: msg.metadata,\n              });\n              if (handled) {\n                return;\n              }\n            }\n          }\n\n          inboundMsg =\n            effectiveContent !== msg.content ? { ...msg, content: effectiveContent } : msg;\n\n          // Continuous typing indicator (renews every 5 seconds); stopped only AFTER outbound.\n          typingController = this.cfg.outboundCoordinator.createTypingControllerForInbound(msg);\n          typingController?.start();\n\n          if (this.channelManagerRef && msg.channel !== 'cli') {\n            const meta = msg.metadata as Record<string, unknown> | undefined;\n            const streamHandle = this.channelManagerRef.startStream(\n              msg.channel,\n              msg.chat_id,\n              meta?.accountId as string | undefined,\n              {\n                threadId: meta?.threadId as string | undefined,\n                replyToMessageId: meta?.messageId as string | undefined,\n              },\n            );\n            if (streamHandle) {\n              this.cfg.setStreamHandle(streamHandle as StreamHandle);\n            }\n          }\n\n          this.cfg.sessionState.beginInboundTurn(sessionContext.sessionKey);\n          inboundTurnArmed = true;\n          try {\n            await this.cfg.agentOrchestrator.process(inboundMsg, sessionContext);\n          } catch (procErr) {\n            busProcessFailed = procErr instanceof Error ? procErr.message : String(procErr);\n            throw procErr;\n          }\n        } finally {\n          await this.cfg.sessionLifecycleManager.endSession(sessionContext);\n          await this.cfg.streamManager.end();\n          try {\n            await this.cfg.outboundCoordinator.sendFinalResponse(msg, sessionContext);\n          } finally {\n            // Clear typing AFTER outbound (incl. TTS); otherwise Weixin shows typing_off before the message.\n            await typingController?.stop();\n          }\n          if (inboundTurnArmed) {\n            const meta = msg.metadata as Record<string, unknown> | undefined;\n            const assistantPlainText = this.cfg.getLastAssistantPlainText(sessionContext.sessionKey) ?? '';\n            try {\n              await this.cfg.outboundCoordinator.emitSessionTurnComplete({\n                sessionKey: sessionContext.sessionKey,\n                channel: sessionContext.channel,\n                chatId: sessionContext.chatId,\n                inboundUserText: inboundMsg.content,\n                assistantPlainText,\n                aborted: false,\n                ...(busProcessFailed !== undefined ? { streamError: busProcessFailed } : {}),\n                skipPersistentGoalPostTurn: false,\n                outboundMetadata: {\n                  accountId: meta?.accountId,\n                  threadId: meta?.threadId,\n                },\n              });\n            } catch (turnErr) {\n              const em = turnErr instanceof Error ? turnErr.message : String(turnErr);\n              this.log.warn(\n                { err: turnErr, sessionKey: sessionContext.sessionKey },\n                `Session turn complete failed: ${em}`,\n              );\n            }\n            this.cfg.sessionState.endInboundTurn(sessionContext.sessionKey);\n          }\n          this.cfg.feedbackCoordinator.endTask();\n          this.cfg.feedbackCoordinator.clearContext();\n        }\n      });\n    });\n  }\n\n  private async handleSystemMessage(msg: InboundMessage, context: SessionContext): Promise<void> {\n    this.log.debug({ sessionKey: context.sessionKey }, 'Processing system message');\n\n    await this.cfg.sessionHydrator.workspace(context.sessionKey);\n    await this.cfg.sessionHydrator.model(context.sessionKey);\n\n    const messages = await this.cfg.sessionStore.load(context.sessionKey);\n    await this.cfg.checkAndCompact(context.sessionKey, messages);\n\n    const systemMessage: AgentMessage = {\n      role: 'user',\n      content: [{ type: 'text', text: `[System: ${msg.sender_id}] ${msg.content}` }],\n      timestamp: Date.now(),\n    };\n\n    try {\n      const result = await runEmbeddedTurnForSession({\n        sessionKey: context.sessionKey,\n        userMessage: systemMessage,\n        sessionStore: this.cfg.sessionStore,\n        agentManager: this.cfg.agentManager,\n        modelManager: this.cfg.modelManager,\n        getConfig: this.cfg.getConfig,\n      });\n\n      const finalContent = result.lastAssistantText ?? this.cfg.getLastAssistantPlainText(context.sessionKey);\n      if (finalContent) {\n        this.cfg.sessionState.setLastAssistantText(context.sessionKey, finalContent);\n        const hookResult = await this.cfg.hookHandler.runMessageSending(\n          context.chatId,\n          finalContent,\n          context.channel,\n        );\n        if (hookResult.send) {\n          await this.cfg.bus.publishOutbound({\n            channel: context.channel,\n            chat_id: context.chatId,\n            content: hookResult.content || finalContent,\n            type: 'message',\n          });\n        }\n      }\n      this.cfg.enqueueMaybeAutoTitleAfterPersist(context.sessionKey);\n    } catch (error) {\n      const em = error instanceof Error ? error.message : String(error);\n      this.log.error(\n        {\n          err: error,\n          errorMessage: em,\n          sessionKey: context.sessionKey,\n          channel: context.channel,\n          chatId: context.chatId,\n          senderId: msg.sender_id,\n        },\n        `System message handling failed: ${em}`,\n      );\n      await this.cfg.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: '❌ An error occurred while processing the system message.',\n        type: 'message',\n      });\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"inbound-loop.js","names":[],"sources":["../../../../src/agent/inbound/inbound-loop.ts"],"sourcesContent":["/**\n * InboundLoop — owns the bus-driven inbound pipeline.\n *\n * Replaces the previous `AgentService.start()` while-loop, `handleInboundMessage`,\n * and `handleSystemMessage` methods. Everything that \"a message arrives, run the\n * agent turn, publish the reply\" needs is concentrated here; the parent\n * `AgentService` now just constructs the loop with collaborators and forwards\n * start/stop to it.\n *\n * The constructor takes a fairly wide config because handling a single inbound\n * message touches almost every subsystem (router, command handler, lifecycle\n * manager, agent orchestrator, outbound coordinator, session state, etc.). All\n * dependencies are injected so this class is unit-testable and the inbound\n * pipeline can evolve without touching `AgentService`.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\n\nimport type { MessageBus, InboundMessage } from '../../infra/bus/index.js';\nimport { MessageBusShutdownError } from '../../infra/bus/index.js';\nimport type { Config } from '../../config/schema.js';\nimport type { ChannelManager } from '../../channels/manager.js';\nimport { runWithLogContext, updateAsyncLogContext } from '../../utils/logger.js';\nimport type { ContextualLogger } from '../../utils/logger/types.js';\n\nimport type { AgentManager } from '../agent-manager.js';\nimport type { AgentOrchestrator } from '../orchestration/index.js';\nimport type { CommandHandler, OutboundCoordinator, StreamManager } from '../messaging/index.js';\nimport type { MessageRouter } from '../messaging/message-router.js';\nimport type { ModelManager } from '../models/index.js';\nimport type {\n  SessionContext,\n  SessionContextManager,\n  SessionHydrator,\n  SessionLifecycleManager,\n  SessionStateBag,\n} from '../session/index.js';\nimport type { FeedbackCoordinator } from '../feedback/index.js';\nimport type { HookHandler } from '../lifecycle/hook-handler.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { initSessionTurn } from '../../session/init-session-turn.js';\nimport { shouldSkipResetOverlapCommand } from '../../session/reset-triggers.js';\nimport type { StreamHandle } from '../service.types.js';\nimport { runEmbeddedTurnForSession } from '../embedded/run-for-session.js';\nimport { inboundMessageLogRequestId } from '../service-inbound-utils.js';\n\n/** Initial back-off when bus consume fails. Doubles each consecutive failure. */\nconst INBOUND_CONSUME_BASE_BACKOFF_MS = 1_000;\n/** Hard cap on back-off so a long bus outage settles at one retry per 30s. */\nconst INBOUND_CONSUME_MAX_BACKOFF_MS = 30_000;\n\nexport interface InboundLoopConfig {\n  log: ContextualLogger;\n  agentId: string;\n  bus: MessageBus;\n  hookHandler: HookHandler;\n  messageRouter: MessageRouter;\n  commandHandler: CommandHandler;\n  sessionContextManager: SessionContextManager;\n  feedbackCoordinator: FeedbackCoordinator;\n  agentManager: AgentManager;\n  sessionLifecycleManager: SessionLifecycleManager;\n  agentOrchestrator: AgentOrchestrator;\n  outboundCoordinator: OutboundCoordinator;\n  streamManager: StreamManager;\n  sessionState: SessionStateBag;\n  sessionStore: SessionStore;\n  modelManager: ModelManager;\n\n  /** Register a per-session agent-event subscription (idempotent). */\n  setupSessionEventHandling: (sessionKey: string) => void;\n  /** Per-session config hydration (workspace + model override) before a turn runs. */\n  sessionHydrator: SessionHydrator;\n  /** Returns the visible last assistant text used for outbound + persistent-goal hook. */\n  getLastAssistantPlainText: (sessionKey: string) => string;\n  /** Pre-turn auto-compaction (only used by system messages). */\n  checkAndCompact: (sessionKey: string, messages: AgentMessage[]) => Promise<void>;\n  /** Fire-and-forget auto-title (no-ops for cron/heartbeat keys). */\n  enqueueMaybeAutoTitleAfterPersist: (sessionKey: string) => void;\n  /** Effective merged config snapshot. */\n  getConfig: () => Config | undefined;\n  /** Archive transcript + new session id (freshness / reset trigger rollover). */\n  resetSession: (sessionKey: string) => Promise<{ sessionId: string; previousSessionId: string } | null>;\n  /** Connect a channel stream handle for partial assistant text rendering. */\n  setStreamHandle: (handle: StreamHandle) => void;\n}\n\nexport class InboundLoop {\n  private readonly cfg: InboundLoopConfig;\n  private readonly log: ContextualLogger;\n  private running = false;\n  private channelManagerRef: ChannelManager | null = null;\n\n  constructor(cfg: InboundLoopConfig) {\n    this.cfg = cfg;\n    this.log = cfg.log;\n  }\n\n  setChannelManager(channelManager: ChannelManager | null): void {\n    this.channelManagerRef = channelManager;\n  }\n\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  /** Begin consuming inbound messages from the bus until {@link stop} or shutdown. */\n  async start(): Promise<void> {\n    this.running = true;\n    await this.cfg.hookHandler.trigger('session_start', { sessionId: this.cfg.agentId });\n\n    // Errors fall into two buckets:\n    //   1. `bus.consumeInbound()` itself threw → infrastructure problem; back off\n    //      exponentially so a flapping bus does not pin the CPU at 100%.\n    //   2. `handleInboundMessage(msg)` threw → per-message handler bug. The\n    //      message is already lost; do NOT sleep, just log and move on so\n    //      legitimate traffic is not held hostage.\n    // Shutdown (`MessageBusShutdownError`) is the only signal that breaks the loop.\n    let consecutiveConsumeFailures = 0;\n\n    while (this.running) {\n      let msg: InboundMessage;\n      try {\n        msg = await this.cfg.bus.consumeInbound();\n        consecutiveConsumeFailures = 0;\n      } catch (error) {\n        if (error instanceof MessageBusShutdownError) {\n          break;\n        }\n        consecutiveConsumeFailures += 1;\n        const delayMs = Math.min(\n          INBOUND_CONSUME_MAX_BACKOFF_MS,\n          INBOUND_CONSUME_BASE_BACKOFF_MS * 2 ** (consecutiveConsumeFailures - 1),\n        );\n        const em = error instanceof Error ? error.message : String(error);\n        this.log.error(\n          {\n            err: error,\n            errorMessage: em,\n            phase: 'inbound_consume',\n            consecutiveFailures: consecutiveConsumeFailures,\n            backoffMs: delayMs,\n          },\n          `Bus consume failed (backing off ${delayMs}ms): ${em}`,\n        );\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n        continue;\n      }\n\n      try {\n        await this.handleInboundMessage(msg);\n      } catch (error) {\n        const em = error instanceof Error ? error.message : String(error);\n        this.log.error(\n          {\n            err: error,\n            errorMessage: em,\n            phase: 'inbound_handle',\n            channel: msg.channel,\n            chatId: msg.chat_id,\n          },\n          `Inbound message handler failed: ${em}`,\n        );\n        // Per-message failure: keep consuming. The next message is independent.\n      }\n    }\n\n    await this.cfg.hookHandler.trigger('session_end', {\n      sessionId: this.cfg.agentId,\n      messageCount: 0,\n    });\n  }\n\n  /** Cooperatively stop the loop; the current message (if any) is allowed to finish. */\n  stop(): void {\n    this.running = false;\n  }\n\n  private async handleInboundMessage(msg: InboundMessage): Promise<void> {\n    const requestId = inboundMessageLogRequestId(msg);\n\n    await runWithLogContext({ requestId }, async () => {\n      const routing = await this.cfg.messageRouter.routeMessage(msg);\n      const { context, isCommand, command, commandArgs } = routing;\n\n      const sessionContext: SessionContext = {\n        sessionKey: context.sessionKey,\n        channel: context.channel,\n        chatId: context.chatId,\n        senderId: context.senderId || '',\n        isGroup: context.isGroup || false,\n        metadata: {\n          transcribedVoice: msg.metadata?.transcribedVoice === true,\n        },\n      };\n\n      const sessionMetadata = await this.cfg.sessionStore.getMetadata(sessionContext.sessionKey).catch(() => null);\n      updateAsyncLogContext({\n        sessionKey: sessionContext.sessionKey,\n        ...(sessionMetadata?.sessionId ? { sessionId: sessionMetadata.sessionId } : {}),\n      });\n\n      await this.cfg.sessionContextManager.runWith(sessionContext, async () => {\n        this.cfg.feedbackCoordinator.setContext(sessionContext);\n\n        // `subscribeToSession` requires an Agent instance; without this the first inbound never\n        // registers `message_update` streaming (second turn behaved differently).\n        this.cfg.agentManager.getOrCreateAgent(sessionContext.sessionKey);\n        this.cfg.setupSessionEventHandling(sessionContext.sessionKey);\n\n        await this.cfg.sessionLifecycleManager.startSession(sessionContext);\n\n        let typingController: ReturnType<OutboundCoordinator['createTypingControllerForInbound']> = null;\n        let inboundTurnArmed = false;\n        let busProcessFailed: string | undefined;\n        let inboundMsg = msg;\n\n        try {\n          if (msg.channel === 'system') {\n            await this.handleSystemMessage(msg, sessionContext);\n            return;\n          }\n\n          if (this.channelManagerRef && msg.channel !== 'cli') {\n            await this.channelManagerRef.dispatchInboundMessageAction(msg);\n          }\n\n          const cfg = this.cfg.getConfig();\n          let effectiveContent = msg.content;\n          let resetTriggeredAtInit = false;\n\n          if (cfg && typeof msg.content === 'string') {\n            const turn = await initSessionTurn({\n              cfg,\n              sessionKey: sessionContext.sessionKey,\n              body: msg.content,\n              resetSession: (sk) => this.cfg.resetSession(sk),\n            });\n            resetTriggeredAtInit = turn.resetTriggered;\n\n            if (turn.bareReset && turn.ackMessage) {\n              await this.cfg.bus.publishOutbound({\n                channel: sessionContext.channel,\n                chat_id: sessionContext.chatId,\n                content: turn.ackMessage,\n                type: 'message',\n              });\n              return;\n            }\n\n            effectiveContent = turn.bodyStripped;\n          }\n\n          if (isCommand && command) {\n            if (!shouldSkipResetOverlapCommand(command, resetTriggeredAtInit)) {\n              const handled = await this.cfg.commandHandler.executeCommand(command, commandArgs || '', {\n                sessionKey: sessionContext.sessionKey,\n                channel: sessionContext.channel,\n                chatId: sessionContext.chatId,\n                senderId: sessionContext.senderId,\n                isGroup: sessionContext.isGroup,\n                inboundMetadata: msg.metadata,\n              });\n              if (handled) {\n                return;\n              }\n            }\n          }\n\n          inboundMsg =\n            effectiveContent !== msg.content ? { ...msg, content: effectiveContent } : msg;\n\n          // Continuous typing indicator (renews every 5 seconds); stopped only AFTER outbound.\n          typingController = this.cfg.outboundCoordinator.createTypingControllerForInbound(msg);\n          typingController?.start();\n\n          if (this.channelManagerRef && msg.channel !== 'cli') {\n            const meta = msg.metadata as Record<string, unknown> | undefined;\n            const streamHandle = this.channelManagerRef.startStream(\n              msg.channel,\n              msg.chat_id,\n              meta?.accountId as string | undefined,\n              {\n                threadId: meta?.threadId as string | undefined,\n                replyToMessageId: meta?.messageId as string | undefined,\n              },\n            );\n            if (streamHandle) {\n              this.cfg.setStreamHandle(streamHandle as StreamHandle);\n            }\n          }\n\n          this.cfg.sessionState.beginInboundTurn(sessionContext.sessionKey);\n          inboundTurnArmed = true;\n          try {\n            await this.cfg.agentOrchestrator.process(inboundMsg, sessionContext);\n          } catch (procErr) {\n            busProcessFailed = procErr instanceof Error ? procErr.message : String(procErr);\n            throw procErr;\n          }\n        } finally {\n          await this.cfg.sessionLifecycleManager.endSession(sessionContext);\n          await this.cfg.streamManager.end();\n          try {\n            await this.cfg.outboundCoordinator.sendFinalResponse(msg, sessionContext);\n          } finally {\n            // Clear typing AFTER outbound (incl. TTS); otherwise Weixin shows typing_off before the message.\n            await typingController?.stop();\n          }\n          if (inboundTurnArmed) {\n            const meta = msg.metadata as Record<string, unknown> | undefined;\n            const assistantPlainText = this.cfg.getLastAssistantPlainText(sessionContext.sessionKey) ?? '';\n            try {\n              await this.cfg.outboundCoordinator.emitSessionTurnComplete({\n                sessionKey: sessionContext.sessionKey,\n                channel: sessionContext.channel,\n                chatId: sessionContext.chatId,\n                inboundUserText: inboundMsg.content,\n                assistantPlainText,\n                aborted: false,\n                ...(busProcessFailed !== undefined ? { streamError: busProcessFailed } : {}),\n                skipPersistentGoalPostTurn: false,\n                outboundMetadata: {\n                  accountId: meta?.accountId,\n                  threadId: meta?.threadId,\n                },\n              });\n            } catch (turnErr) {\n              const em = turnErr instanceof Error ? turnErr.message : String(turnErr);\n              this.log.warn(\n                { err: turnErr, sessionKey: sessionContext.sessionKey },\n                `Session turn complete failed: ${em}`,\n              );\n            }\n            this.cfg.sessionState.endInboundTurn(sessionContext.sessionKey);\n          }\n          this.cfg.feedbackCoordinator.endTask();\n          this.cfg.feedbackCoordinator.clearContext();\n        }\n      });\n    });\n  }\n\n  private async handleSystemMessage(msg: InboundMessage, context: SessionContext): Promise<void> {\n    this.log.debug({ sessionKey: context.sessionKey }, 'Processing system message');\n\n    await this.cfg.sessionHydrator.workspace(context.sessionKey);\n    await this.cfg.sessionHydrator.model(context.sessionKey);\n\n    const messages = await this.cfg.sessionStore.load(context.sessionKey);\n    await this.cfg.checkAndCompact(context.sessionKey, messages);\n\n    const systemMessage: AgentMessage = {\n      role: 'user',\n      content: [{ type: 'text', text: `[System: ${msg.sender_id}] ${msg.content}` }],\n      timestamp: Date.now(),\n    };\n\n    try {\n      const result = await runEmbeddedTurnForSession({\n        sessionKey: context.sessionKey,\n        userMessage: systemMessage,\n        sessionStore: this.cfg.sessionStore,\n        agentManager: this.cfg.agentManager,\n        modelManager: this.cfg.modelManager,\n        getConfig: this.cfg.getConfig,\n      });\n\n      const finalContent = result.lastAssistantText ?? this.cfg.getLastAssistantPlainText(context.sessionKey);\n      if (finalContent) {\n        this.cfg.sessionState.setLastAssistantText(context.sessionKey, finalContent);\n        const hookResult = await this.cfg.hookHandler.runMessageSending(\n          context.chatId,\n          finalContent,\n          context.channel,\n        );\n        if (hookResult.send) {\n          await this.cfg.bus.publishOutbound({\n            channel: context.channel,\n            chat_id: context.chatId,\n            content: hookResult.content || finalContent,\n            type: 'message',\n          });\n        }\n      }\n      this.cfg.enqueueMaybeAutoTitleAfterPersist(context.sessionKey);\n    } catch (error) {\n      const em = error instanceof Error ? error.message : String(error);\n      this.log.error(\n        {\n          err: error,\n          errorMessage: em,\n          sessionKey: context.sessionKey,\n          channel: context.channel,\n          chatId: context.chatId,\n          senderId: msg.sender_id,\n        },\n        `System message handling failed: ${em}`,\n      );\n      await this.cfg.bus.publishOutbound({\n        channel: context.channel,\n        chat_id: context.chatId,\n        content: '❌ An error occurred while processing the system message.',\n        type: 'message',\n      });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/inbound/turn-dispatcher.d.ts

@@ -36,10 +36,10 @@ export interface TurnDispatcherConfig {
     getConfig: () => Config | undefined;
     /** Strict accessor — required for direct-turn paths that must have a config. */
     requireConfig: () => Config;
-    parseSessionKey: (sessionKey: string) => {
+    resolveSessionEndpoint: (sessionKey: string) => Promise<{
         channel: string;
         chatId: string;
-    };
+    }>;
     /** Establish per-session context (also creates the Agent + subscribes to events). */
     initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;
     /** Per-session config hydration: workspace, model, thinking. */

package/dist/src/agent/inbound/turn-dispatcher.js

@@ -85,7 +85,7 @@ var TurnDispatcher = class {
 		const c = this.cfg;
 		return {
 			log: this.log,
-			parseSessionKey: c.parseSessionKey,
+			resolveSessionEndpoint: c.resolveSessionEndpoint,
 			initDirectStreamingSession: c.initSessionContext,
 			registerWebchatSsePublisher: (sk, publisher) => c.sessionState.registerWebchatPublisher(sk, publisher),
 			unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),
@@ -135,7 +135,7 @@ var TurnDispatcher = class {
 		return {
 			log: this.log,
 			config: cfg,
-			parseSessionKey: c.parseSessionKey,
+			resolveSessionEndpoint: c.resolveSessionEndpoint,
 			initSessionContext: (sk, channel, chatId) => {
 				c.initSessionContext(sk, channel, chatId);
 			},