@xopcai/xopc 0.0.114 → 0.0.116

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  goalContextExcerpt?: 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    `Original goal context and attachments:\\n${truncateGoalText(opts.goalContextExcerpt ?? '', 4000) || '(none)'}\\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;
@@ -24,5 +24,6 @@ export type GoalPostTurnDecision = {
 export declare function evaluateAfterTurnHermesLike(state: PersistentGoalState, lastResponse: string, judgeModelRef: string, signal?: AbortSignal, opts?: {
     goalsSlice?: Partial<GoalsEvaluateConfigSlice>;
     historyExcerpt?: string;
+    goalContextExcerpt?: string;
     uiLocale?: GoalUiLocale;
 }): Promise<GoalPostTurnDecision>;

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,
@@ -103,6 +104,7 @@ async function evaluateAfterTurnHermesLike(state, lastResponse, judgeModelRef, s
 			numberedChecklist: renderChecklistNumbered(checklist),
 			lastResponse,
 			historyExcerpt: opts?.historyExcerpt ?? "",
+			goalContextExcerpt: opts?.goalContextExcerpt ?? "",
 			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?: {\n    goalsSlice?: Partial<GoalsEvaluateConfigSlice>;\n    historyExcerpt?: string;\n    goalContextExcerpt?: string;\n    uiLocale?: GoalUiLocale;\n  },\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      goalContextExcerpt: opts?.goalContextExcerpt ?? '',\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/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

@@ -21,6 +21,12 @@ function buildHistoryExcerpt(messages, maxChars) {
 		return "";
 	}
 }
+function buildGoalContextText(goal) {
+	const lines = [`Title: ${goal.title}`];
+	if (goal.contextMessage?.text.trim()) lines.push(`Context:\n${goal.contextMessage.text.trim()}`);
+	if (goal.contextMessage?.attachments.length) lines.push(["Attachments:", ...goal.contextMessage.attachments.map((attachment) => `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`)].join("\n"));
+	return lines.join("\n\n");
+}
 function resolveJudgeModelRef(config, sessionKey, storedJudge, runtimeSessionModelRef) {
 	const fromCfg = config?.goals?.judgeModelRef?.trim();
 	if (fromCfg) return fromCfg;
@@ -32,6 +38,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,8 +52,14 @@ 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,
+		goal: buildGoalContextText(goal),
 		status: "active",
 		turnsUsed: goal.turnsUsed,
 		maxTurns: goal.maxTurns,
@@ -51,7 +67,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 +83,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 {
@@ -81,6 +96,7 @@ async function handlePersistentGoalPostTurn(opts) {
 	const decision = await evaluateAfterTurnHermesLike(state, assistantPlainText, judgeRef, signal, {
 		goalsSlice: goalsCfg,
 		historyExcerpt,
+		goalContextExcerpt: buildGoalContextText(goal),
 		uiLocale: resolveGoalUiLocale(state)
 	});
 	if (decision.newState) {
@@ -145,6 +161,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":";;;;;;;;;aAGiE;aAGZ;AAOrD,MAAM,MAAM,aAAa,iBAAiB;AAC1C,MAAM,cAAc,IAAI,aAAa;AAErC,SAAS,oBAAoB,UAA0B,UAA0B;AAC/E,KAAI,YAAY,EAAG,QAAO;AAC1B,KAAI;EACF,MAAM,MAAM,KAAK,UAAU,SAAS;AACpC,MAAI,IAAI,UAAU,SAAU,QAAO;AACnC,SAAO,IAAI,MAAM,CAAC,SAAS;SACrB;AACN,SAAO;;;AAIX,SAAS,qBACP,QACA,YACA,aACA,wBACoB;CACpB,MAAM,UAAU,QAAQ,OAAO,eAAe,MAAM;AACpD,KAAI,QAAS,QAAO;AACpB,KAAI,aAAa,MAAM,CAAE,QAAO,YAAY,MAAM;AAClD,KAAI,QAAQ;EACV,MAAM,UAAU,uCAAuC,QAAQ,WAAW;AAC1E,MAAI,QAAQ,iBAAiB,MAAM,CAAE,QAAO,QAAQ,gBAAgB,MAAM;;AAE5E,KAAI,wBAAwB,MAAM,CAAE,QAAO,uBAAuB,MAAM;AACxE,KAAI,OAAQ,QAAO,wBAAwB,OAAO;;AAIpD,eAAe,oBAAoB,MAA0B,YAAoB,MAA6B;AAC5G,OAAM,KAAK,uBAAuB,YAAY,KAAK;;AAGrD,eAAsB,6BAA6B,MAoBjC;CAChB,MAAM,EACJ,MACA,YACA,oBACA,SACA,aACA,4BACA,QACA,wBACA,QACA,yBACA,wBACE;AAEJ,KAAI,2BAA4B;AAChC,KAAI,WAAW,YAAa;AAG5B,KAAI,CAAC,MADc,KAAK,mBAAmB,WAAW,CAC3C;CAEX,MAAM,OAAO,YAAY,oBAAoB,WAAW;AACxD,KAAI,CAAC,QAAQ,KAAK,WAAW,SAAU;CAEvC,MAAM,QAA6B;EACjC,MAAM,KAAK;EACX,QAAQ;EACR,WAAW,KAAK;EAChB,UAAU,KAAK;EACf,WAAW,KAAK;EAChB,YAAY,KAAK;EACjB,YAAY,KAAK;EACjB,eAAe,KAAK;EACpB,YAAY,KAAK,UAAU,SAAS,IAAI,OAAO,KAAA;EAC/C,UAAU,KAAK;EACf,WAAW,KAAK,UAAU,KAAK,QAAQ;GACrC,MAAM,GAAG;GACT,QAAQ,GAAG;GACX,SAAS,GAAG;GACZ,SAAS,GAAG;GACZ,aAAa,GAAG;GAChB,UAAU,GAAG;GACd,EAAE;EACJ;CAED,MAAM,WAAW,qBAAqB,QAAQ,YAAY,MAAM,eAAe,uBAAuB;AACtG,KAAI,CAAC,UAAU;AACb,MAAI,KAAK,EAAE,YAAY,EAAE,0DAA0D;AACnF;;CAGF,MAAM,WAAW,QAAQ;CACzB,MAAM,aAAa,UAAU,yBAAyB;CACtD,IAAI,iBAAiB;AACrB,KAAI;AAEF,mBAAiB,oBAAoB,MADlB,KAAK,aAAa,WAAW,EACL,WAAW;UAC/C,KAAK;AACZ,MAAI,MACF;GAAE;GAAK;GAAY,EACnB,+DAA+D,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAChH;;CAGH,MAAM,WAAW,MAAM,4BAA4B,OAAO,oBAAoB,UAAU,QAAQ;EAC9F,YAAY;EACZ;EACA,UAAU,oBAAoB,MAAM;EACrC,CAAC;AAEF,KAAI,SAAS,UAAU;EACrB,MAAM,KAAK,SAAS;EACpB,MAAM,4BAA4B,SAAS,+BACvC,KAAK,UAAU,KAAK,UAAU,QAAQ,GAAG,CAC1C,QAAQ,OAAqB,OAAO,OAAO,YAAY,GAAG,SAAS,EAAE;AACxE,MAAI;GACF,MAAM,cAAc,YAAY,kBAAkB;IAChD,QAAQ,KAAK;IACb;IACA,QAAQ;IACR,QAAQ,GAAG,WAAW,SAClB,SACA,SAAS,YAAY,YACnB,YACA,SAAS,YAAY,gBACnB,gBACA,GAAG,WAAW,WACZ,WACA;IACV,WAAW,GAAG;IACd,UAAU,GAAG;IACb,QAAQ,GAAG,gBAAgB,SAAS;IACpC,YAAY,SAAS,sBAAsB,KAAA;IAC3C,kBAAkB;IAClB,SAAS,SAAS,YAAY,SAC1B,SACA,SAAS,YAAY,cACnB,cACA,SAAS,YAAY,YACnB,YACA,SAAS,YAAY,gBACnB,gBACA;IACV,YAAY,SAAS;IACrB,iBAAiB,SAAS;IAC1B,cAAc,SAAS;IACvB;IACA,WAAW,GAAG,WAAW,KAAK,QAAQ;KACpC,MAAM,GAAG;KACT,QAAQ,GAAG;KACX,SAAS,GAAG;KACZ,SAAS,GAAG;KACZ,aAAa,GAAG;KAChB,iBAAiB,GAAG;KACrB,EAAE;IACJ,CAAC;AACF,OAAI,eAAe,YAAY,WAAW,KAAK,OAC7C,uBAAsB;IACpB,QAAQ,KAAK;IACb;IACA,gBAAgB,KAAK;IACrB,QAAQ,YAAY;IACpB,MAAM;IACP,CAAC;WAEG,KAAK;AACZ,OAAI,KACF;IAAE;IAAK;IAAY,QAAQ,KAAK;IAAI,EACpC,+CAA+C,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAChG;;;AAIL,KAAI,SAAS,QACX,KAAI,wBACF,KAAI;AACF,QAAM,wBAAwB,SAAS,QAAQ;UACxC,KAAK;AACZ,MAAI,KACF;GAAE;GAAK;GAAY,EACnB,iDAAiD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAClG;;KAGH,KAAI;AACF,QAAM,oBAAoB,MAAM,YAAY,SAAS,QAAQ;UACtD,KAAK;AACZ,MAAI,KACF;GAAE;GAAK;GAAY,EACnB,qDAAqD,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACtG;;AAKP,KAAI,SAAS,kBAAkB,SAAS,mBACtC,MAAK,qBAAqB,YAAY,SAAS,mBAAmB"}
+{"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 buildGoalContextText(goal: NonNullable<ReturnType<GoalService['get']>>): string {\n  const lines = [`Title: ${goal.title}`];\n  if (goal.contextMessage?.text.trim()) {\n    lines.push(`Context:\\n${goal.contextMessage.text.trim()}`);\n  }\n  if (goal.contextMessage?.attachments.length) {\n    lines.push(\n      [\n        'Attachments:',\n        ...goal.contextMessage.attachments.map((attachment) =>\n          `- ${attachment.name} (${attachment.mimeType}, ${attachment.size} bytes) ${attachment.uri}`,\n        ),\n      ].join('\\n'),\n    );\n  }\n  return lines.join('\\n\\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: buildGoalContextText(goal),\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    goalContextExcerpt: buildGoalContextText(goal),\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/understanding/pi-ai-provider.js

@@ -1,5 +1,5 @@
-import { getApiKey, init_providers, resolveModel } from "../../../providers/index.js";
-import { registerImageUnderstandingProvider } from "./provider-registry.js";
+import { getApiKey, getModelsByProvider, init_providers, resolveModel } from "../../../providers/index.js";
+import { registerImageUnderstandingProvider, registerImageUnderstandingProviderFactory } from "./provider-registry.js";
 import { coerceImageAssistantText } from "../image-helpers.js";
 import { complete } from "@earendil-works/pi-ai";
 //#region src/agent/image/understanding/pi-ai-provider.ts
@@ -65,6 +65,9 @@ for (const providerId of [
 	"anthropic",
 	"google"
 ]) registerImageUnderstandingProvider(buildPiAiImageUnderstandingProvider(providerId));
+registerImageUnderstandingProviderFactory((providerId) => {
+	return getModelsByProvider(providerId).some((model) => model.input?.includes("image")) ? buildPiAiImageUnderstandingProvider(providerId) : void 0;
+});
 //#endregion
 export { buildPiAiImageUnderstandingProvider };
 

package/dist/src/agent/image/understanding/pi-ai-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"pi-ai-provider.js","names":[],"sources":["../../../../../src/agent/image/understanding/pi-ai-provider.ts"],"sourcesContent":["import { complete, type Api, type Context, type Model } from '@earendil-works/pi-ai';\nimport { resolveModel, getApiKey } from '../../../providers/index.js';\nimport { coerceImageAssistantText } from '../image-helpers.js';\nimport { registerImageUnderstandingProvider } from './provider-registry.js';\nimport type { ImageUnderstandingProvider } from './types.js';\n\nfunction resolveMaxTokens(modelMaxTokens: number | undefined, requestedMaxTokens = 4096): number {\n  if (\n    typeof modelMaxTokens !== 'number' ||\n    !Number.isFinite(modelMaxTokens) ||\n    modelMaxTokens <= 0\n  ) {\n    return requestedMaxTokens;\n  }\n  return Math.min(requestedMaxTokens, modelMaxTokens);\n}\n\nexport function buildPiAiImageUnderstandingProvider(providerId: string): ImageUnderstandingProvider {\n  return {\n    id: providerId,\n    label: `pi-ai (${providerId})`,\n    async isConfigured() {\n      const apiKey = await getApiKey(providerId);\n      return Boolean(apiKey);\n    },\n    async describeImages(modelId, request) {\n      const modelRef = `${providerId}/${modelId}`;\n      const model = resolveModel(modelRef) as Model<Api>;\n      if (!model.input?.includes('image')) {\n        throw new Error(`Model does not support images: ${modelRef}`);\n      }\n      const apiKey = await getApiKey(providerId);\n      if (!apiKey) {\n        throw new Error(`No API key configured for provider: ${providerId}`);\n      }\n\n      const context: Context = {\n        messages: [\n          {\n            role: 'user',\n            content: [\n              { type: 'text', text: request.prompt },\n              ...request.images.map((img) => ({\n                type: 'image' as const,\n                data: img.buffer.toString('base64'),\n                mimeType: img.mimeType || 'image/jpeg',\n              })),\n            ],\n            timestamp: Date.now(),\n          },\n        ],\n      };\n\n      const maxTokens = resolveMaxTokens(model.maxTokens, request.maxTokens ?? 512);\n      const timeoutMs = request.timeoutMs ?? 60_000;\n      const timeoutSignal =\n        typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n          ? AbortSignal.timeout(timeoutMs)\n          : undefined;\n      const signal = (() => {\n        if (timeoutSignal && request.signal && typeof AbortSignal.any === 'function') {\n          return AbortSignal.any([request.signal, timeoutSignal]);\n        }\n        if (request.signal) {\n          return request.signal;\n        }\n        if (timeoutSignal) {\n          return timeoutSignal;\n        }\n        const controller = new AbortController();\n        setTimeout(() => controller.abort(), timeoutMs);\n        return controller.signal;\n      })();\n\n      const message = await complete(model, context, {\n        apiKey,\n        maxTokens,\n        signal,\n      });\n\n      const text = coerceImageAssistantText({\n        message,\n        provider: providerId,\n        model: modelId,\n      });\n      return { text, provider: providerId, model: modelId };\n    },\n  };\n}\n\nfor (const providerId of ['openai', 'anthropic', 'google']) {\n  registerImageUnderstandingProvider(buildPiAiImageUnderstandingProvider(providerId));\n}\n"],"mappings":";;;;;gBACsE;AAKtE,SAAS,iBAAiB,gBAAoC,qBAAqB,MAAc;AAC/F,KACE,OAAO,mBAAmB,YAC1B,CAAC,OAAO,SAAS,eAAe,IAChC,kBAAkB,EAElB,QAAO;AAET,QAAO,KAAK,IAAI,oBAAoB,eAAe;;AAGrD,SAAgB,oCAAoC,YAAgD;AAClG,QAAO;EACL,IAAI;EACJ,OAAO,UAAU,WAAW;EAC5B,MAAM,eAAe;GACnB,MAAM,SAAS,MAAM,UAAU,WAAW;AAC1C,UAAO,QAAQ,OAAO;;EAExB,MAAM,eAAe,SAAS,SAAS;GACrC,MAAM,WAAW,GAAG,WAAW,GAAG;GAClC,MAAM,QAAQ,aAAa,SAAS;AACpC,OAAI,CAAC,MAAM,OAAO,SAAS,QAAQ,CACjC,OAAM,IAAI,MAAM,kCAAkC,WAAW;GAE/D,MAAM,SAAS,MAAM,UAAU,WAAW;AAC1C,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,uCAAuC,aAAa;GAGtE,MAAM,UAAmB,EACvB,UAAU,CACR;IACE,MAAM;IACN,SAAS,CACP;KAAE,MAAM;KAAQ,MAAM,QAAQ;KAAQ,EACtC,GAAG,QAAQ,OAAO,KAAK,SAAS;KAC9B,MAAM;KACN,MAAM,IAAI,OAAO,SAAS,SAAS;KACnC,UAAU,IAAI,YAAY;KAC3B,EAAE,CACJ;IACD,WAAW,KAAK,KAAK;IACtB,CACF,EACF;GAED,MAAM,YAAY,iBAAiB,MAAM,WAAW,QAAQ,aAAa,IAAI;GAC7E,MAAM,YAAY,QAAQ,aAAa;GACvC,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,UAAU,GAC9B,KAAA;AA2BN,UAAO;IAAE,MALI,yBAAyB;KACpC,SAAA,MAPoB,SAAS,OAAO,SAAS;MAC7C;MACA;MACA,eAlBoB;AACpB,WAAI,iBAAiB,QAAQ,UAAU,OAAO,YAAY,QAAQ,WAChE,QAAO,YAAY,IAAI,CAAC,QAAQ,QAAQ,cAAc,CAAC;AAEzD,WAAI,QAAQ,OACV,QAAO,QAAQ;AAEjB,WAAI,cACF,QAAO;OAET,MAAM,aAAa,IAAI,iBAAiB;AACxC,wBAAiB,WAAW,OAAO,EAAE,UAAU;AAC/C,cAAO,WAAW;UAMZ;MACP,CAAC;KAIA,UAAU;KACV,OAAO;KACR,CACY;IAAE,UAAU;IAAY,OAAO;IAAS;;EAExD;;AAGH,KAAK,MAAM,cAAc;CAAC;CAAU;CAAa;CAAS,CACxD,oCAAmC,oCAAoC,WAAW,CAAC"}
+{"version":3,"file":"pi-ai-provider.js","names":[],"sources":["../../../../../src/agent/image/understanding/pi-ai-provider.ts"],"sourcesContent":["import { complete, type Api, type Context, type Model } from '@earendil-works/pi-ai';\nimport { resolveModel, getApiKey, getModelsByProvider } from '../../../providers/index.js';\nimport { coerceImageAssistantText } from '../image-helpers.js';\nimport {\n  registerImageUnderstandingProvider,\n  registerImageUnderstandingProviderFactory,\n} from './provider-registry.js';\nimport type { ImageUnderstandingProvider } from './types.js';\n\nfunction resolveMaxTokens(modelMaxTokens: number | undefined, requestedMaxTokens = 4096): number {\n  if (\n    typeof modelMaxTokens !== 'number' ||\n    !Number.isFinite(modelMaxTokens) ||\n    modelMaxTokens <= 0\n  ) {\n    return requestedMaxTokens;\n  }\n  return Math.min(requestedMaxTokens, modelMaxTokens);\n}\n\nexport function buildPiAiImageUnderstandingProvider(providerId: string): ImageUnderstandingProvider {\n  return {\n    id: providerId,\n    label: `pi-ai (${providerId})`,\n    async isConfigured() {\n      const apiKey = await getApiKey(providerId);\n      return Boolean(apiKey);\n    },\n    async describeImages(modelId, request) {\n      const modelRef = `${providerId}/${modelId}`;\n      const model = resolveModel(modelRef) as Model<Api>;\n      if (!model.input?.includes('image')) {\n        throw new Error(`Model does not support images: ${modelRef}`);\n      }\n      const apiKey = await getApiKey(providerId);\n      if (!apiKey) {\n        throw new Error(`No API key configured for provider: ${providerId}`);\n      }\n\n      const context: Context = {\n        messages: [\n          {\n            role: 'user',\n            content: [\n              { type: 'text', text: request.prompt },\n              ...request.images.map((img) => ({\n                type: 'image' as const,\n                data: img.buffer.toString('base64'),\n                mimeType: img.mimeType || 'image/jpeg',\n              })),\n            ],\n            timestamp: Date.now(),\n          },\n        ],\n      };\n\n      const maxTokens = resolveMaxTokens(model.maxTokens, request.maxTokens ?? 512);\n      const timeoutMs = request.timeoutMs ?? 60_000;\n      const timeoutSignal =\n        typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n          ? AbortSignal.timeout(timeoutMs)\n          : undefined;\n      const signal = (() => {\n        if (timeoutSignal && request.signal && typeof AbortSignal.any === 'function') {\n          return AbortSignal.any([request.signal, timeoutSignal]);\n        }\n        if (request.signal) {\n          return request.signal;\n        }\n        if (timeoutSignal) {\n          return timeoutSignal;\n        }\n        const controller = new AbortController();\n        setTimeout(() => controller.abort(), timeoutMs);\n        return controller.signal;\n      })();\n\n      const message = await complete(model, context, {\n        apiKey,\n        maxTokens,\n        signal,\n      });\n\n      const text = coerceImageAssistantText({\n        message,\n        provider: providerId,\n        model: modelId,\n      });\n      return { text, provider: providerId, model: modelId };\n    },\n  };\n}\n\nfor (const providerId of ['openai', 'anthropic', 'google']) {\n  registerImageUnderstandingProvider(buildPiAiImageUnderstandingProvider(providerId));\n}\n\nregisterImageUnderstandingProviderFactory((providerId) => {\n  const hasVisionModel = getModelsByProvider(providerId).some((model) =>\n    model.input?.includes('image'),\n  );\n  return hasVisionModel ? buildPiAiImageUnderstandingProvider(providerId) : undefined;\n});\n"],"mappings":";;;;;gBAC2F;AAQ3F,SAAS,iBAAiB,gBAAoC,qBAAqB,MAAc;AAC/F,KACE,OAAO,mBAAmB,YAC1B,CAAC,OAAO,SAAS,eAAe,IAChC,kBAAkB,EAElB,QAAO;AAET,QAAO,KAAK,IAAI,oBAAoB,eAAe;;AAGrD,SAAgB,oCAAoC,YAAgD;AAClG,QAAO;EACL,IAAI;EACJ,OAAO,UAAU,WAAW;EAC5B,MAAM,eAAe;GACnB,MAAM,SAAS,MAAM,UAAU,WAAW;AAC1C,UAAO,QAAQ,OAAO;;EAExB,MAAM,eAAe,SAAS,SAAS;GACrC,MAAM,WAAW,GAAG,WAAW,GAAG;GAClC,MAAM,QAAQ,aAAa,SAAS;AACpC,OAAI,CAAC,MAAM,OAAO,SAAS,QAAQ,CACjC,OAAM,IAAI,MAAM,kCAAkC,WAAW;GAE/D,MAAM,SAAS,MAAM,UAAU,WAAW;AAC1C,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,uCAAuC,aAAa;GAGtE,MAAM,UAAmB,EACvB,UAAU,CACR;IACE,MAAM;IACN,SAAS,CACP;KAAE,MAAM;KAAQ,MAAM,QAAQ;KAAQ,EACtC,GAAG,QAAQ,OAAO,KAAK,SAAS;KAC9B,MAAM;KACN,MAAM,IAAI,OAAO,SAAS,SAAS;KACnC,UAAU,IAAI,YAAY;KAC3B,EAAE,CACJ;IACD,WAAW,KAAK,KAAK;IACtB,CACF,EACF;GAED,MAAM,YAAY,iBAAiB,MAAM,WAAW,QAAQ,aAAa,IAAI;GAC7E,MAAM,YAAY,QAAQ,aAAa;GACvC,MAAM,gBACJ,OAAO,gBAAgB,eAAe,OAAO,YAAY,YAAY,aACjE,YAAY,QAAQ,UAAU,GAC9B,KAAA;AA2BN,UAAO;IAAE,MALI,yBAAyB;KACpC,SAAA,MAPoB,SAAS,OAAO,SAAS;MAC7C;MACA;MACA,eAlBoB;AACpB,WAAI,iBAAiB,QAAQ,UAAU,OAAO,YAAY,QAAQ,WAChE,QAAO,YAAY,IAAI,CAAC,QAAQ,QAAQ,cAAc,CAAC;AAEzD,WAAI,QAAQ,OACV,QAAO,QAAQ;AAEjB,WAAI,cACF,QAAO;OAET,MAAM,aAAa,IAAI,iBAAiB;AACxC,wBAAiB,WAAW,OAAO,EAAE,UAAU;AAC/C,cAAO,WAAW;UAMZ;MACP,CAAC;KAIA,UAAU;KACV,OAAO;KACR,CACY;IAAE,UAAU;IAAY,OAAO;IAAS;;EAExD;;AAGH,KAAK,MAAM,cAAc;CAAC;CAAU;CAAa;CAAS,CACxD,oCAAmC,oCAAoC,WAAW,CAAC;AAGrF,2CAA2C,eAAe;AAIxD,QAHuB,oBAAoB,WAAW,CAAC,MAAM,UAC3D,MAAM,OAAO,SAAS,QAAQ,CAEX,GAAG,oCAAoC,WAAW,GAAG,KAAA;EAC1E"}

package/dist/src/agent/image/understanding/provider-registry.d.ts

@@ -1,5 +1,6 @@
 import type { ImageUnderstandingProvider } from './types.js';
 export declare function registerImageUnderstandingProvider(provider: ImageUnderstandingProvider): void;
+export declare function registerImageUnderstandingProviderFactory(factory: (providerId: string) => ImageUnderstandingProvider | undefined): void;
 export declare function getImageUnderstandingProvider(providerId: string): ImageUnderstandingProvider | undefined;
 export declare function listImageUnderstandingProviders(): ImageUnderstandingProvider[];
 export declare function clearImageUnderstandingRegistryForTests(): void;

package/dist/src/agent/image/understanding/provider-registry.js

@@ -1,19 +1,33 @@
 //#region src/agent/image/understanding/provider-registry.ts
 const registry = /* @__PURE__ */ new Map();
+const providerFactories = /* @__PURE__ */ new Set();
 function registerImageUnderstandingProvider(provider) {
 	if (!provider.id?.trim()) throw new Error("Image understanding provider id is required");
 	registry.set(provider.id.toLowerCase(), provider);
 }
+function registerImageUnderstandingProviderFactory(factory) {
+	providerFactories.add(factory);
+}
 function getImageUnderstandingProvider(providerId) {
-	return registry.get(providerId.toLowerCase());
+	const normalized = providerId.trim().toLowerCase();
+	if (!normalized) return void 0;
+	const registered = registry.get(normalized);
+	if (registered) return registered;
+	for (const factory of providerFactories) {
+		const provider = factory(normalized);
+		if (!provider) continue;
+		registerImageUnderstandingProvider(provider);
+		return registry.get(normalized);
+	}
 }
 function listImageUnderstandingProviders() {
 	return [...registry.values()];
 }
 function clearImageUnderstandingRegistryForTests() {
 	registry.clear();
+	providerFactories.clear();
 }
 //#endregion
-export { clearImageUnderstandingRegistryForTests, getImageUnderstandingProvider, listImageUnderstandingProviders, registerImageUnderstandingProvider };
+export { clearImageUnderstandingRegistryForTests, getImageUnderstandingProvider, listImageUnderstandingProviders, registerImageUnderstandingProvider, registerImageUnderstandingProviderFactory };
 
 //# sourceMappingURL=provider-registry.js.map

package/dist/src/agent/image/understanding/provider-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-registry.js","names":[],"sources":["../../../../../src/agent/image/understanding/provider-registry.ts"],"sourcesContent":["import type { ImageUnderstandingProvider } from './types.js';\n\nconst registry = new Map<string, ImageUnderstandingProvider>();\n\nexport function registerImageUnderstandingProvider(provider: ImageUnderstandingProvider): void {\n  if (!provider.id?.trim()) {\n    throw new Error('Image understanding provider id is required');\n  }\n  registry.set(provider.id.toLowerCase(), provider);\n}\n\nexport function getImageUnderstandingProvider(\n  providerId: string,\n): ImageUnderstandingProvider | undefined {\n  return registry.get(providerId.toLowerCase());\n}\n\nexport function listImageUnderstandingProviders(): ImageUnderstandingProvider[] {\n  return [...registry.values()];\n}\n\nexport function clearImageUnderstandingRegistryForTests(): void {\n  registry.clear();\n}\n"],"mappings":";AAEA,MAAM,2BAAW,IAAI,KAAyC;AAE9D,SAAgB,mCAAmC,UAA4C;AAC7F,KAAI,CAAC,SAAS,IAAI,MAAM,CACtB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,UAAS,IAAI,SAAS,GAAG,aAAa,EAAE,SAAS;;AAGnD,SAAgB,8BACd,YACwC;AACxC,QAAO,SAAS,IAAI,WAAW,aAAa,CAAC;;AAG/C,SAAgB,kCAAgE;AAC9E,QAAO,CAAC,GAAG,SAAS,QAAQ,CAAC;;AAG/B,SAAgB,0CAAgD;AAC9D,UAAS,OAAO"}
+{"version":3,"file":"provider-registry.js","names":[],"sources":["../../../../../src/agent/image/understanding/provider-registry.ts"],"sourcesContent":["import type { ImageUnderstandingProvider } from './types.js';\n\nconst registry = new Map<string, ImageUnderstandingProvider>();\nconst providerFactories = new Set<\n  (providerId: string) => ImageUnderstandingProvider | undefined\n>();\n\nexport function registerImageUnderstandingProvider(provider: ImageUnderstandingProvider): void {\n  if (!provider.id?.trim()) {\n    throw new Error('Image understanding provider id is required');\n  }\n  registry.set(provider.id.toLowerCase(), provider);\n}\n\nexport function registerImageUnderstandingProviderFactory(\n  factory: (providerId: string) => ImageUnderstandingProvider | undefined,\n): void {\n  providerFactories.add(factory);\n}\n\nexport function getImageUnderstandingProvider(\n  providerId: string,\n): ImageUnderstandingProvider | undefined {\n  const normalized = providerId.trim().toLowerCase();\n  if (!normalized) return undefined;\n\n  const registered = registry.get(normalized);\n  if (registered) return registered;\n\n  for (const factory of providerFactories) {\n    const provider = factory(normalized);\n    if (!provider) continue;\n    registerImageUnderstandingProvider(provider);\n    return registry.get(normalized);\n  }\n\n  return undefined;\n}\n\nexport function listImageUnderstandingProviders(): ImageUnderstandingProvider[] {\n  return [...registry.values()];\n}\n\nexport function clearImageUnderstandingRegistryForTests(): void {\n  registry.clear();\n  providerFactories.clear();\n}\n"],"mappings":";AAEA,MAAM,2BAAW,IAAI,KAAyC;AAC9D,MAAM,oCAAoB,IAAI,KAE3B;AAEH,SAAgB,mCAAmC,UAA4C;AAC7F,KAAI,CAAC,SAAS,IAAI,MAAM,CACtB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,UAAS,IAAI,SAAS,GAAG,aAAa,EAAE,SAAS;;AAGnD,SAAgB,0CACd,SACM;AACN,mBAAkB,IAAI,QAAQ;;AAGhC,SAAgB,8BACd,YACwC;CACxC,MAAM,aAAa,WAAW,MAAM,CAAC,aAAa;AAClD,KAAI,CAAC,WAAY,QAAO,KAAA;CAExB,MAAM,aAAa,SAAS,IAAI,WAAW;AAC3C,KAAI,WAAY,QAAO;AAEvB,MAAK,MAAM,WAAW,mBAAmB;EACvC,MAAM,WAAW,QAAQ,WAAW;AACpC,MAAI,CAAC,SAAU;AACf,qCAAmC,SAAS;AAC5C,SAAO,SAAS,IAAI,WAAW;;;AAMnC,SAAgB,kCAAgE;AAC9E,QAAO,CAAC,GAAG,SAAS,QAAQ,CAAC;;AAG/B,SAAgB,0CAAgD;AAC9D,UAAS,OAAO;AAChB,mBAAkB,OAAO"}

package/dist/src/agent/tools/composio-tool.d.ts

@@ -0,0 +1,8 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { Config } from '../../config/schema.js';
+declare const ComposioExecuteSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    slug: import("@sinclair/typebox/build/cjs/index.js").TString;
+    arguments: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TAny>;
+}>;
+export declare function createComposioExecuteTool(getConfig: () => Config | undefined): AgentTool<typeof ComposioExecuteSchema, {}> | null;
+export {};

package/dist/src/agent/tools/composio-tool.js

@@ -0,0 +1,46 @@
+import { canUseComposioAction, executeComposioTool } from "../../connectors/composio.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/composio-tool.ts
+const ComposioExecuteSchema = Type.Object({
+	slug: Type.String({ description: "Composio action slug, e.g. GMAIL_FETCH_EMAILS or SLACK_SENDS_A_MESSAGE_TO_A_SLACK_CHANNEL." }),
+	arguments: Type.Optional(Type.Any({ description: "Action arguments matching the Composio action schema." }))
+});
+function hasInstalledComposioConnector(config) {
+	return Object.entries(config?.connectors?.instances ?? {}).some(([id, record]) => id.startsWith("composio-") && id !== "composio-api-key" && Boolean(record && typeof record === "object" && !Array.isArray(record)));
+}
+function createComposioExecuteTool(getConfig) {
+	if (!hasInstalledComposioConnector(getConfig())) return null;
+	return {
+		name: "composio_execute",
+		label: "🔌 Composio Execute",
+		description: "Execute an installed Composio integration action. Actions are gated by the connector curated allowlist and read/write/admin scope.",
+		parameters: ComposioExecuteSchema,
+		async execute(_toolCallId, params) {
+			const config = getConfig();
+			const allowed = canUseComposioAction(config, params.slug);
+			if (allowed.ok === false) return {
+				content: [{
+					type: "text",
+					text: allowed.reason
+				}],
+				details: {}
+			};
+			const result = await executeComposioTool({
+				slug: params.slug,
+				arguments: params.arguments,
+				config
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}],
+				details: {}
+			};
+		}
+	};
+}
+//#endregion
+export { createComposioExecuteTool };
+
+//# sourceMappingURL=composio-tool.js.map

package/dist/src/agent/tools/composio-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-tool.js","names":[],"sources":["../../../../src/agent/tools/composio-tool.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { canUseComposioAction, executeComposioTool } from '../../connectors/composio.js';\n\nconst ComposioExecuteSchema = Type.Object({\n  slug: Type.String({ description: 'Composio action slug, e.g. GMAIL_FETCH_EMAILS or SLACK_SENDS_A_MESSAGE_TO_A_SLACK_CHANNEL.' }),\n  arguments: Type.Optional(Type.Any({ description: 'Action arguments matching the Composio action schema.' })),\n});\n\nfunction hasInstalledComposioConnector(config: Config | undefined): boolean {\n  return Object.entries(config?.connectors?.instances ?? {}).some(([id, record]) => (\n    id.startsWith('composio-') &&\n    id !== 'composio-api-key' &&\n    Boolean(record && typeof record === 'object' && !Array.isArray(record))\n  ));\n}\n\nexport function createComposioExecuteTool(getConfig: () => Config | undefined): AgentTool<typeof ComposioExecuteSchema, {}> | null {\n  if (!hasInstalledComposioConnector(getConfig())) {\n    return null;\n  }\n  return {\n    name: 'composio_execute',\n    label: '🔌 Composio Execute',\n    description: 'Execute an installed Composio integration action. Actions are gated by the connector curated allowlist and read/write/admin scope.',\n    parameters: ComposioExecuteSchema,\n    async execute(_toolCallId, params): Promise<AgentToolResult<{}>> {\n      const config = getConfig();\n      const allowed = canUseComposioAction(config, params.slug);\n      if (allowed.ok === false) {\n        return { content: [{ type: 'text', text: allowed.reason }], details: {} };\n      }\n      const result = await executeComposioTool({ slug: params.slug, arguments: params.arguments, config });\n      return {\n        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],\n        details: {},\n      };\n    },\n  };\n}\n"],"mappings":";;;AAMA,MAAM,wBAAwB,KAAK,OAAO;CACxC,MAAM,KAAK,OAAO,EAAE,aAAa,8FAA8F,CAAC;CAChI,WAAW,KAAK,SAAS,KAAK,IAAI,EAAE,aAAa,yDAAyD,CAAC,CAAC;CAC7G,CAAC;AAEF,SAAS,8BAA8B,QAAqC;AAC1E,QAAO,OAAO,QAAQ,QAAQ,YAAY,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,YACpE,GAAG,WAAW,YAAY,IAC1B,OAAO,sBACP,QAAQ,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAAC,CACvE;;AAGJ,SAAgB,0BAA0B,WAAyF;AACjI,KAAI,CAAC,8BAA8B,WAAW,CAAC,CAC7C,QAAO;AAET,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EACZ,MAAM,QAAQ,aAAa,QAAsC;GAC/D,MAAM,SAAS,WAAW;GAC1B,MAAM,UAAU,qBAAqB,QAAQ,OAAO,KAAK;AACzD,OAAI,QAAQ,OAAO,MACjB,QAAO;IAAE,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,QAAQ;KAAQ,CAAC;IAAE,SAAS,EAAE;IAAE;GAE3E,MAAM,SAAS,MAAM,oBAAoB;IAAE,MAAM,OAAO;IAAM,WAAW,OAAO;IAAW;IAAQ,CAAC;AACpG,UAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM,KAAK,UAAU,QAAQ,MAAM,EAAE;KAAE,CAAC;IAClE,SAAS,EAAE;IACZ;;EAEJ"}

package/dist/src/agent/tools/factory.js

@@ -13,6 +13,7 @@ import { createFindTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
+import { createComposioExecuteTool } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -155,14 +156,18 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const modelHasVision = primary?.input?.includes("image") ?? false;
 		const cfg = this.deps.getConfig?.();
 		const recordGoalEvidence = createGoalEvidenceRecorder({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey });
-		const optionalTools = [createImageTool({
-			config: cfg,
-			workspace,
-			modelHasVision
-		}), createImageGenerateTool({
-			config: cfg,
-			workspace
-		})].filter((t) => t != null);
+		const optionalTools = [
+			createImageTool({
+				config: cfg,
+				workspace,
+				modelHasVision
+			}),
+			createImageGenerateTool({
+				config: cfg,
+				workspace
+			}),
+			createComposioExecuteTool(() => this.deps.getConfig?.())
+		].filter((t) => t != null);
 		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
 		const writeTool = createWriteFileTool(workspace, {
 			profileMarkdownRoot: options?.profileMarkdownRoot,