@xopcai/xopc 0.0.141 → 0.0.142

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/compat';\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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"}
+{"version":3,"file":"checklist-judge.js","names":[],"sources":["../../../../src/agent/goals/checklist-judge.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\n\nimport { resolveModel } from '../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../providers/model-call.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 completeWithResolvedCredentials(\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 completeWithResolvedCredentials(\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/judge.js

@@ -1,7 +1,7 @@
 import { getApiKey, init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { JUDGE_REASON_EN } from "../../i18n/goals-bundle.js";
 import { goalUiLocaleOrFallback, judgeFreeformBuiltinMessages, judgeResponseLanguageNote, localizeJudgeReasonText } from "./goal-locale.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/agent/goals/judge.ts
 init_providers();
 const JUDGE_RESPONSE_SNIPPET_CHARS = 4e3;
@@ -144,7 +144,7 @@ async function judgeGoalHermesStyle(goal, lastResponse, judgeModelRef, signal, o
 			timestamp: Date.now()
 		};
 		const apiKey = await resolveGoalJudgeApiKey(model);
-		const result = await complete(model, { messages: [combinedUser] }, {
+		const result = await completeWithResolvedCredentials(model, { messages: [combinedUser] }, {
 			apiKey,
 			maxTokens: 200,
 			temperature: 0,

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

@@ -1 +1 @@
-{"version":3,"file":"judge.js","names":[],"sources":["../../../../src/agent/goals/judge.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\nimport { complete } from '@earendil-works/pi-ai/compat';\n\nimport { getApiKey, resolveModel } from '../../providers/index.js';\n\nimport type { GoalUiLocale } from './goal-locale.js';\nimport {\n  goalUiLocaleOrFallback,\n  judgeFreeformBuiltinMessages,\n  JUDGE_REASON_EN,\n  judgeResponseLanguageNote,\n  localizeJudgeReasonText,\n} from './goal-locale.js';\n\nconst JUDGE_RESPONSE_SNIPPET_CHARS = 4000;\n\n/**\n * Extract visible text from a pi-ai `AssistantMessage.content` array.\n * Handles `TextContent` (`type: 'text'`) and falls back to `ThinkingContent`\n * (`type: 'thinking'`) when the text blocks are empty — reasoning models\n * (DeepSeek-R1, Qwen-thinking, etc.) may place the entire response inside\n * thinking blocks, leaving the text portion blank.\n */\nexport function extractAssistantText(content: unknown): string {\n  if (!Array.isArray(content)) return '';\n\n  let textParts = '';\n  let thinkingParts = '';\n\n  for (const block of content) {\n    if (!block || typeof block !== 'object') continue;\n    const typed = block as Record<string, unknown>;\n    const blockType = typed.type;\n    if (blockType === 'text' && typeof typed.text === 'string') {\n      textParts += typed.text;\n    } else if (blockType === 'thinking') {\n      const thinking =\n        typeof typed.thinking === 'string'\n          ? typed.thinking\n          : typeof typed.text === 'string'\n            ? typed.text\n            : '';\n      thinkingParts += thinking;\n    }\n  }\n\n  // Prefer text blocks; fall back to thinking blocks when text is empty.\n  return textParts.trim() ? textParts : thinkingParts;\n}\n\n/**\n * Strip markdown code fences (opening AND closing) from raw model output.\n * Handles `` ```json ``, `` ``` ``, and trailing `` ``` `` with optional whitespace.\n */\nexport function stripCodeFences(raw: string): string {\n  let text = raw.trim();\n\n  // Remove opening code fence: ```<optional-lang>\\n\n  const openMatch = text.match(/^`{3,}[^\\n]*\\n?/);\n  if (openMatch) {\n    text = text.slice(openMatch[0].length);\n  }\n\n  // Remove closing code fence: \\n```<optional-whitespace>\n  const closeMatch = text.match(/\\n?`{3,}\\s*$/);\n  if (closeMatch) {\n    text = text.slice(0, -closeMatch[0].length);\n  }\n\n  return text.trim();\n}\n\n/** Mirrors `hermes_cli/goals.py` — strict judge, JSON-only reply. */\nexport const JUDGE_SYSTEM_PROMPT =\n  'You are a strict judge evaluating whether an autonomous agent has ' +\n  \"achieved a user's stated goal. You receive the goal text and the \" +\n  \"agent's most recent response. Your only job is to decide whether \" +\n  'the goal is fully satisfied based on that response.\\n\\n' +\n  'A goal is DONE only when:\\n' +\n  '- The response explicitly confirms the goal was completed, OR\\n' +\n  '- The response clearly shows the final deliverable was produced, OR\\n' +\n  '- The response explains the goal is unachievable / blocked / needs ' +\n  'user input (treat this as DONE with reason describing the block).\\n\\n' +\n  'Otherwise the goal is NOT done — CONTINUE.\\n\\n' +\n  'Reply ONLY with a single JSON object on one line:\\n' +\n  '{\"done\": <true|false>, \"reason\": \"<one-sentence rationale>\"}';\n\nexport const JUDGE_USER_PROMPT_TEMPLATE =\n  'Goal:\\n{goal}\\n\\n' + \"Agent's most recent response:\\n{response}\\n\\n\" + 'Is the goal satisfied?';\n\nexport const DEFAULT_JUDGE_TIMEOUT_MS = 60_000;\n\nexport function truncateGoalText(text: string, limit: number): string {\n  if (!text) return '';\n  if (text.length <= limit) return text;\n  return text.slice(0, limit) + '… [truncated]';\n}\n\nexport async function resolveGoalJudgeApiKey(\n  model: ReturnType<typeof resolveModel>,\n): Promise<string | undefined> {\n  try {\n    return await getApiKey(model.provider);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getAssistantMessageErrorReason(message: unknown): string | null {\n  if (!message || typeof message !== 'object') return null;\n\n  const record = message as Record<string, unknown>;\n  const stopReason = record.stopReason;\n  const errorMessage = typeof record.errorMessage === 'string' ? record.errorMessage.trim() : '';\n\n  if (stopReason === 'error') {\n    return errorMessage || 'Judge model call failed.';\n  }\n\n  return null;\n}\n\n/** Parse judge JSON — fail-open to **continue** (Hermes semantics). */\nexport function parseJudgeResponseFailOpen(raw: string): {\n  done: boolean;\n  reason: string;\n  parseFailed: boolean;\n} {\n  if (!raw?.trim()) {\n    return { done: false, reason: JUDGE_REASON_EN.judge_returned_empty, parseFailed: true };\n  }\n\n  const text = stripCodeFences(raw);\n\n  let data: Record<string, unknown> | null = null;\n  try {\n    data = JSON.parse(text) as Record<string, unknown>;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start !== -1 && end > start) {\n      try {\n        data = JSON.parse(text.slice(start, end + 1)) as Record<string, unknown>;\n      } catch {\n        data = null;\n      }\n    }\n  }\n\n  if (!data || typeof data !== 'object') {\n    return { done: false, reason: JUDGE_REASON_EN.judge_reply_not_json, parseFailed: true };\n  }\n\n  const doneVal = data.done;\n  let done: boolean;\n  if (typeof doneVal === 'string') {\n    done = ['true', 'yes', '1', 'done'].includes(doneVal.trim().toLowerCase());\n  } else {\n    done = Boolean(doneVal);\n  }\n  const reason = typeof data.reason === 'string' ? data.reason.trim() : '';\n  return { done, reason: reason || JUDGE_REASON_EN.no_reason_provided, parseFailed: false };\n}\n\nexport type GoalJudgeVerdict = 'done' | 'continue' | 'skipped';\n\n/**\n * Ask the configured model whether the goal is satisfied.\n * Fail-open: any error → `continue` (Hermes — turn budget is the backstop).\n */\nexport async function judgeGoalHermesStyle(\n  goal: string,\n  lastResponse: string,\n  judgeModelRef: string,\n  signal?: AbortSignal,\n  opts?: { judgeTimeoutMs?: number; uiLocale?: GoalUiLocale },\n): Promise<{ verdict: GoalJudgeVerdict; reason: string; parseFailed: boolean }> {\n  const locale = goalUiLocaleOrFallback(opts?.uiLocale);\n  const b = judgeFreeformBuiltinMessages(locale);\n\n  if (!goal.trim()) {\n    return { verdict: 'skipped', reason: b.emptyGoal, parseFailed: false };\n  }\n  if (!lastResponse.trim()) {\n    return { verdict: 'continue', reason: b.emptyResponse, parseFailed: false };\n  }\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(judgeModelRef);\n  } catch {\n    return { verdict: 'continue', reason: b.noModel, parseFailed: false };\n  }\n\n  const userContent =\n    JUDGE_USER_PROMPT_TEMPLATE.replace('{goal}', truncateGoalText(goal, 2000)).replace(\n      '{response}',\n      truncateGoalText(lastResponse, JUDGE_RESPONSE_SNIPPET_CHARS),\n    ) + judgeResponseLanguageNote(locale);\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 = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;\n\n  try {\n    const combinedUser: UserMessage = {\n      role: 'user',\n      content: `${JUDGE_SYSTEM_PROMPT}\\n\\n${userContent}`,\n      timestamp: Date.now(),\n    };\n\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await complete(\n      model,\n      {\n        messages: [combinedUser],\n      },\n      { apiKey, maxTokens: 200, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return { verdict: 'continue', reason: b.callFailed, parseFailed: false };\n    }\n\n    const text = extractAssistantText(result.content);\n    const { done, reason, parseFailed } = parseJudgeResponseFailOpen(text);\n    const reasonOut = localizeJudgeReasonText(reason, locale);\n    return { verdict: done ? 'done' : 'continue', reason: reasonOut, parseFailed };\n  } catch {\n    return { verdict: 'continue', reason: b.callFailed, parseFailed: false };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"judge.js","names":[],"sources":["../../../../src/agent/goals/judge.ts"],"sourcesContent":["import type { UserMessage } from '@earendil-works/pi-ai';\n\nimport { getApiKey, resolveModel } from '../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../providers/model-call.js';\n\nimport type { GoalUiLocale } from './goal-locale.js';\nimport {\n  goalUiLocaleOrFallback,\n  judgeFreeformBuiltinMessages,\n  JUDGE_REASON_EN,\n  judgeResponseLanguageNote,\n  localizeJudgeReasonText,\n} from './goal-locale.js';\n\nconst JUDGE_RESPONSE_SNIPPET_CHARS = 4000;\n\n/**\n * Extract visible text from a pi-ai `AssistantMessage.content` array.\n * Handles `TextContent` (`type: 'text'`) and falls back to `ThinkingContent`\n * (`type: 'thinking'`) when the text blocks are empty — reasoning models\n * (DeepSeek-R1, Qwen-thinking, etc.) may place the entire response inside\n * thinking blocks, leaving the text portion blank.\n */\nexport function extractAssistantText(content: unknown): string {\n  if (!Array.isArray(content)) return '';\n\n  let textParts = '';\n  let thinkingParts = '';\n\n  for (const block of content) {\n    if (!block || typeof block !== 'object') continue;\n    const typed = block as Record<string, unknown>;\n    const blockType = typed.type;\n    if (blockType === 'text' && typeof typed.text === 'string') {\n      textParts += typed.text;\n    } else if (blockType === 'thinking') {\n      const thinking =\n        typeof typed.thinking === 'string'\n          ? typed.thinking\n          : typeof typed.text === 'string'\n            ? typed.text\n            : '';\n      thinkingParts += thinking;\n    }\n  }\n\n  // Prefer text blocks; fall back to thinking blocks when text is empty.\n  return textParts.trim() ? textParts : thinkingParts;\n}\n\n/**\n * Strip markdown code fences (opening AND closing) from raw model output.\n * Handles `` ```json ``, `` ``` ``, and trailing `` ``` `` with optional whitespace.\n */\nexport function stripCodeFences(raw: string): string {\n  let text = raw.trim();\n\n  // Remove opening code fence: ```<optional-lang>\\n\n  const openMatch = text.match(/^`{3,}[^\\n]*\\n?/);\n  if (openMatch) {\n    text = text.slice(openMatch[0].length);\n  }\n\n  // Remove closing code fence: \\n```<optional-whitespace>\n  const closeMatch = text.match(/\\n?`{3,}\\s*$/);\n  if (closeMatch) {\n    text = text.slice(0, -closeMatch[0].length);\n  }\n\n  return text.trim();\n}\n\n/** Mirrors `hermes_cli/goals.py` — strict judge, JSON-only reply. */\nexport const JUDGE_SYSTEM_PROMPT =\n  'You are a strict judge evaluating whether an autonomous agent has ' +\n  \"achieved a user's stated goal. You receive the goal text and the \" +\n  \"agent's most recent response. Your only job is to decide whether \" +\n  'the goal is fully satisfied based on that response.\\n\\n' +\n  'A goal is DONE only when:\\n' +\n  '- The response explicitly confirms the goal was completed, OR\\n' +\n  '- The response clearly shows the final deliverable was produced, OR\\n' +\n  '- The response explains the goal is unachievable / blocked / needs ' +\n  'user input (treat this as DONE with reason describing the block).\\n\\n' +\n  'Otherwise the goal is NOT done — CONTINUE.\\n\\n' +\n  'Reply ONLY with a single JSON object on one line:\\n' +\n  '{\"done\": <true|false>, \"reason\": \"<one-sentence rationale>\"}';\n\nexport const JUDGE_USER_PROMPT_TEMPLATE =\n  'Goal:\\n{goal}\\n\\n' + \"Agent's most recent response:\\n{response}\\n\\n\" + 'Is the goal satisfied?';\n\nexport const DEFAULT_JUDGE_TIMEOUT_MS = 60_000;\n\nexport function truncateGoalText(text: string, limit: number): string {\n  if (!text) return '';\n  if (text.length <= limit) return text;\n  return text.slice(0, limit) + '… [truncated]';\n}\n\nexport async function resolveGoalJudgeApiKey(\n  model: ReturnType<typeof resolveModel>,\n): Promise<string | undefined> {\n  try {\n    return await getApiKey(model.provider);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function getAssistantMessageErrorReason(message: unknown): string | null {\n  if (!message || typeof message !== 'object') return null;\n\n  const record = message as Record<string, unknown>;\n  const stopReason = record.stopReason;\n  const errorMessage = typeof record.errorMessage === 'string' ? record.errorMessage.trim() : '';\n\n  if (stopReason === 'error') {\n    return errorMessage || 'Judge model call failed.';\n  }\n\n  return null;\n}\n\n/** Parse judge JSON — fail-open to **continue** (Hermes semantics). */\nexport function parseJudgeResponseFailOpen(raw: string): {\n  done: boolean;\n  reason: string;\n  parseFailed: boolean;\n} {\n  if (!raw?.trim()) {\n    return { done: false, reason: JUDGE_REASON_EN.judge_returned_empty, parseFailed: true };\n  }\n\n  const text = stripCodeFences(raw);\n\n  let data: Record<string, unknown> | null = null;\n  try {\n    data = JSON.parse(text) as Record<string, unknown>;\n  } catch {\n    const start = text.indexOf('{');\n    const end = text.lastIndexOf('}');\n    if (start !== -1 && end > start) {\n      try {\n        data = JSON.parse(text.slice(start, end + 1)) as Record<string, unknown>;\n      } catch {\n        data = null;\n      }\n    }\n  }\n\n  if (!data || typeof data !== 'object') {\n    return { done: false, reason: JUDGE_REASON_EN.judge_reply_not_json, parseFailed: true };\n  }\n\n  const doneVal = data.done;\n  let done: boolean;\n  if (typeof doneVal === 'string') {\n    done = ['true', 'yes', '1', 'done'].includes(doneVal.trim().toLowerCase());\n  } else {\n    done = Boolean(doneVal);\n  }\n  const reason = typeof data.reason === 'string' ? data.reason.trim() : '';\n  return { done, reason: reason || JUDGE_REASON_EN.no_reason_provided, parseFailed: false };\n}\n\nexport type GoalJudgeVerdict = 'done' | 'continue' | 'skipped';\n\n/**\n * Ask the configured model whether the goal is satisfied.\n * Fail-open: any error → `continue` (Hermes — turn budget is the backstop).\n */\nexport async function judgeGoalHermesStyle(\n  goal: string,\n  lastResponse: string,\n  judgeModelRef: string,\n  signal?: AbortSignal,\n  opts?: { judgeTimeoutMs?: number; uiLocale?: GoalUiLocale },\n): Promise<{ verdict: GoalJudgeVerdict; reason: string; parseFailed: boolean }> {\n  const locale = goalUiLocaleOrFallback(opts?.uiLocale);\n  const b = judgeFreeformBuiltinMessages(locale);\n\n  if (!goal.trim()) {\n    return { verdict: 'skipped', reason: b.emptyGoal, parseFailed: false };\n  }\n  if (!lastResponse.trim()) {\n    return { verdict: 'continue', reason: b.emptyResponse, parseFailed: false };\n  }\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(judgeModelRef);\n  } catch {\n    return { verdict: 'continue', reason: b.noModel, parseFailed: false };\n  }\n\n  const userContent =\n    JUDGE_USER_PROMPT_TEMPLATE.replace('{goal}', truncateGoalText(goal, 2000)).replace(\n      '{response}',\n      truncateGoalText(lastResponse, JUDGE_RESPONSE_SNIPPET_CHARS),\n    ) + judgeResponseLanguageNote(locale);\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 = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;\n\n  try {\n    const combinedUser: UserMessage = {\n      role: 'user',\n      content: `${JUDGE_SYSTEM_PROMPT}\\n\\n${userContent}`,\n      timestamp: Date.now(),\n    };\n\n    const apiKey = await resolveGoalJudgeApiKey(model);\n    const result = await completeWithResolvedCredentials(\n      model,\n      {\n        messages: [combinedUser],\n      },\n      { apiKey, maxTokens: 200, temperature: 0, signal: merged },\n    );\n    const errorReason = getAssistantMessageErrorReason(result);\n    if (errorReason) {\n      return { verdict: 'continue', reason: b.callFailed, parseFailed: false };\n    }\n\n    const text = extractAssistantText(result.content);\n    const { done, reason, parseFailed } = parseJudgeResponseFailOpen(text);\n    const reasonOut = localizeJudgeReasonText(reason, locale);\n    return { verdict: done ? 'done' : 'continue', reason: reasonOut, parseFailed };\n  } catch {\n    return { verdict: 'continue', reason: b.callFailed, parseFailed: false };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { getApiKey, getModelsByProvider, init_providers, resolveModel } from "../../../providers/index.js";
+import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
 import { registerImageUnderstandingProvider, registerImageUnderstandingProviderFactory } from "./provider-registry.js";
 import { coerceImageAssistantText } from "../image-helpers.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/agent/image/understanding/pi-ai-provider.ts
 init_providers();
 function resolveMaxTokens(modelMaxTokens, requestedMaxTokens = 4096) {
@@ -39,7 +39,7 @@ function buildPiAiImageUnderstandingProvider(providerId) {
 			const timeoutSignal = typeof AbortSignal !== "undefined" && typeof AbortSignal.timeout === "function" ? AbortSignal.timeout(timeoutMs) : void 0;
 			return {
 				text: coerceImageAssistantText({
-					message: await complete(model, context, {
+					message: await completeWithResolvedCredentials(model, context, {
 						apiKey,
 						maxTokens,
 						signal: (() => {

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/compat';\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"}
+{"version":3,"file":"pi-ai-provider.js","names":[],"sources":["../../../../../src/agent/image/understanding/pi-ai-provider.ts"],"sourcesContent":["import { type Api, type Context, type Model } from '@earendil-works/pi-ai/compat';\nimport { resolveModel, getApiKey, getModelsByProvider } from '../../../providers/index.js';\nimport { completeWithResolvedCredentials } from '../../../providers/model-call.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 completeWithResolvedCredentials(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;AAS3F,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,gCAAgC,OAAO,SAAS;MACpE;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/memory/compaction.js

@@ -1,6 +1,6 @@
+import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { readAgentMessageContent } from "./agent-message-access.js";
 import { formatSummaryAsText, generateStructuredSummary } from "./summary-generator.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/agent/memory/compaction.ts
 const DEFAULT_CONFIG = {
 	enabled: true,
@@ -212,7 +212,7 @@ Summary:`;
 				content: prompt,
 				timestamp: Date.now()
 			};
-			const result = await complete(this.model, { messages: [summaryMessage] }, {
+			const result = await completeWithResolvedCredentials(this.model, { messages: [summaryMessage] }, {
 				maxTokens: this.config.summaryMaxTokens,
 				temperature: .3,
 				signal: controller.signal

package/dist/src/agent/memory/compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.js","names":[],"sources":["../../../../src/agent/memory/compaction.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type Model, type Api, type UserMessage } from '@earendil-works/pi-ai/compat';\nimport { readAgentMessageContent } from './agent-message-access.js';\nimport { generateStructuredSummary, formatSummaryAsText, type ConversationSummary } from './summary-generator.js';\n\nexport interface CompactionResult {\n  summary: string;\n  firstKeptIndex: number;\n  tokensBefore: number;\n  tokensAfter: number;\n  compacted: boolean;\n  structuredSummary?: ConversationSummary;\n  compactedUsage?: {\n    input: number;\n    output: number;\n    total: number;\n    cost?: number;\n  };\n}\n\nexport interface CompactionConfig {\n  enabled: boolean;\n  mode: 'extractive' | 'abstractive' | 'structured';\n  reserveTokens: number;\n  triggerThreshold: number;\n  minMessagesBeforeCompact: number;\n  keepRecentMessages: number;\n  summaryMaxTokens: number;\n  evictionWindow: number;\n  retentionWindow: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nconst DEFAULT_CONFIG: CompactionConfig = {\n  enabled: true,\n  mode: 'abstractive',\n  reserveTokens: 8000,\n  triggerThreshold: 0.8,\n  minMessagesBeforeCompact: 10,\n  keepRecentMessages: 10,\n  summaryMaxTokens: 500,\n  evictionWindow: 0.2,\n  retentionWindow: 6,\n  preserveReasoning: true,\n  accumulateUsage: true,\n};\n\nfunction estimateTokens(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n\nfunction estimateMessageTokens(msg: AgentMessage): number {\n  let text = '';\n  const raw = readAgentMessageContent(msg);\n\n  if (typeof raw === 'string') {\n    text = raw;\n  } else if (Array.isArray(raw)) {\n    text = raw\n      .filter(c => c.type === 'text')\n      .map(c => (c as { text?: string }).text || '')\n      .join('\\n');\n  }\n  \n  return estimateTokens(text) + 10;\n}\n\n// Internal: Reasoning extraction utilities\ninterface ReasoningDetails {\n  thinking?: string;\n  signature?: string;\n}\n\nfunction extractLastReasoning(messages: AgentMessage[]): ReasoningDetails | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (msg.role === 'assistant') {\n      const rd = (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details;\n      if (rd && (rd.thinking || rd.signature)) {\n        return rd;\n      }\n    }\n  }\n  return null;\n}\n\n// Internal: Inject reasoning into first assistant message\nfunction injectReasoningIntoFirstAssistant(\n  messages: AgentMessage[],\n  reasoning: ReasoningDetails\n): void {\n  for (const msg of messages) {\n    if (msg.role === 'assistant') {\n      const existing = (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details;\n      if (!existing || (!existing.thinking && !existing.signature)) {\n        (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details = reasoning;\n      }\n      break;\n    }\n  }\n}\n\n// Internal: Message usage tracking\ninterface MessageUsage {\n  input: number;\n  output: number;\n  total: number;\n  cost?: number;\n}\n\nexport function accumulateUsage(messages: AgentMessage[]): MessageUsage | undefined {\n  let totalInput = 0;\n  let totalOutput = 0;\n  let totalCost = 0;\n  let hasUsage = false;\n\n  for (const msg of messages) {\n    const usage = (msg as unknown as { usage?: MessageUsage }).usage;\n    if (usage) {\n      hasUsage = true;\n      totalInput += usage.input || 0;\n      totalOutput += usage.output || 0;\n      totalCost += usage.cost || 0;\n    }\n  }\n\n  if (!hasUsage) return undefined;\n\n  return {\n    input: totalInput,\n    output: totalOutput,\n    total: totalInput + totalOutput,\n    cost: totalCost > 0 ? totalCost : undefined,\n  };\n}\n\n// Internal: Droppable message filtering\ntype DroppableMessage = AgentMessage & {\n  droppable?: boolean;\n};\n\nfunction filterDroppableMessages(messages: AgentMessage[]): AgentMessage[] {\n  return messages.filter(msg => !(msg as DroppableMessage).droppable);\n}\n\nfunction findNthTurnFromEnd(messages: AgentMessage[], n: number): number {\n  if (n <= 0) return messages.length;\n  \n  let turnsFound = 0;\n  let lastRole: string | null = null;\n  \n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    \n    if (msg.role === 'user' && lastRole !== 'user') {\n      turnsFound++;\n      if (turnsFound === n) {\n        return i;\n      }\n    }\n    lastRole = msg.role;\n  }\n  \n  return 0;\n}\n\n// Internal: Calculate compaction range\nfunction calculateCompactionRange(\n  messages: AgentMessage[],\n  config: CompactionConfig\n): { start: number; end: number } | null {\n  const totalMessages = messages.length;\n  \n  if (totalMessages < config.minMessagesBeforeCompact) {\n    return null;\n  }\n  \n  const evictionEnd = Math.floor(totalMessages * config.evictionWindow);\n  const retentionStart = findNthTurnFromEnd(messages, config.retentionWindow);\n  const retentionEnd = retentionStart > 0 ? retentionStart - 1 : 0;\n  const compactionEnd = Math.min(evictionEnd, retentionEnd);\n  \n  if (compactionEnd <= 1) {\n    return null;\n  }\n  \n  return { start: 0, end: compactionEnd };\n}\n\nexport class SessionCompactor {\n  private config: CompactionConfig;\n  \n  constructor(\n    config?: Partial<CompactionConfig>,\n    private model?: Model<Api>\n  ) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  needsCompaction(\n    messages: AgentMessage[],\n    contextWindow: number\n  ): { needed: boolean; reason: string; usagePercent?: number } {\n    if (!this.config.enabled) {\n      return { needed: false, reason: 'disabled' };\n    }\n\n    if (messages.length < this.config.minMessagesBeforeCompact) {\n      return { needed: false, reason: 'not_enough_messages' };\n    }\n\n    const totalTokens = this.estimateTotalTokens(messages);\n    const usagePercent = totalTokens / contextWindow;\n\n    if (usagePercent > this.config.triggerThreshold) {\n      return { \n        needed: true, \n        reason: 'threshold_exceeded',\n        usagePercent \n      };\n    }\n\n    return { needed: false, reason: 'within_threshold' };\n  }\n\n  async compact(\n    messages: AgentMessage[],\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    const effectiveMessages = filterDroppableMessages(messages);\n\n    const minRequired = this.config.minMessagesBeforeCompact;\n    if (!force && effectiveMessages.length < minRequired) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    if (force && effectiveMessages.length < 2) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    const range = calculateCompactionRange(effectiveMessages, this.config);\n    let messagesToSummarize: AgentMessage[];\n    let keptMessages: AgentMessage[];\n\n    if (range) {\n      messagesToSummarize = effectiveMessages.slice(0, range.end);\n      keptMessages = effectiveMessages.slice(range.end);\n    } else if (force) {\n      const keep = Math.min(\n        this.config.keepRecentMessages,\n        Math.max(1, effectiveMessages.length - 1),\n      );\n      messagesToSummarize = effectiveMessages.slice(0, effectiveMessages.length - keep);\n      keptMessages = effectiveMessages.slice(-keep);\n    } else {\n      const keepRecent = this.config.keepRecentMessages;\n      messagesToSummarize = effectiveMessages.slice(0, -keepRecent);\n      keptMessages = effectiveMessages.slice(-keepRecent);\n    }\n\n    if (messagesToSummarize.length === 0) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    let preservedReasoning: ReasoningDetails | null = null;\n    if (this.config.preserveReasoning) {\n      preservedReasoning = extractLastReasoning(messagesToSummarize);\n      if (preservedReasoning) {\n        injectReasoningIntoFirstAssistant(keptMessages, preservedReasoning);\n      }\n    }\n\n    const summary = await this.generateSummary(messagesToSummarize, instructions);\n    const structuredSummary = this.config.mode === 'structured' \n      ? generateStructuredSummary(messagesToSummarize)\n      : undefined;\n\n    const tokensBefore = this.estimateTotalTokens(effectiveMessages);\n    const summaryTokens = estimateTokens(summary) + 20;\n    const keptTokens = this.estimateTotalTokens(keptMessages);\n    const tokensAfter = summaryTokens + keptTokens;\n\n    let compactedUsage: MessageUsage | undefined;\n    if (this.config.accumulateUsage) {\n      compactedUsage = accumulateUsage(messagesToSummarize);\n    }\n\n    return {\n      summary,\n      firstKeptIndex: keptMessages.length > 0 ? effectiveMessages.length - keptMessages.length : 0,\n      tokensBefore,\n      tokensAfter,\n      compacted: true,\n      structuredSummary,\n      compactedUsage,\n    };\n  }\n\n  private async generateSummary(messages: AgentMessage[], instructions?: string): Promise<string> {\n    if (this.model && (this.config.mode === 'abstractive' || this.config.mode === 'structured')) {\n      try {\n        if (this.config.mode === 'structured') {\n          const structured = generateStructuredSummary(messages);\n          return formatSummaryAsText(structured, true);\n        } else {\n          return await this.llmAbstractiveSummary(messages, instructions);\n        }\n      } catch (err) {\n        console.warn('[Compactor] LLM summarization failed, falling back to extractive', err);\n      }\n    }\n\n    return this.extractiveSummary(messages);\n  }\n\n  private async llmAbstractiveSummary(messages: AgentMessage[], instructions?: string): Promise<string> {\n    if (!this.model) {\n      throw new Error('Model not available');\n    }\n\n    const conversation = this.formatMessages(messages);\n    const extra = instructions?.trim()\n      ? `\\nAdditional focus from the user:\\n${instructions.trim()}\\n`\n      : '';\n    const prompt = `Summarize the following conversation in 2-3 concise sentences. Focus on:\n1. What the user was trying to accomplish\n2. Key decisions, outcomes, or solutions\n3. Any important context that should be preserved\n${extra}\nConversation:\n${conversation}\n\nSummary:`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30000);\n\n    try {\n      const summaryMessage: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n      const result = await complete(this.model, { \n        messages: [summaryMessage]\n      }, {\n        maxTokens: this.config.summaryMaxTokens,\n        temperature: 0.3,\n        signal: controller.signal as any,\n      });\n\n      const text = Array.isArray(result.content)\n        ? result.content.filter((c: any) => c.type === 'text').map((c: any) => c.text).join('')\n        : '';\n\n      return text.trim();\n    } catch (err) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw new Error('LLM summarization timed out after 30 seconds');\n      }\n      throw err;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private formatMessages(messages: AgentMessage[]): string {\n    return messages\n      .map(m => {\n        const role = m.role;\n        const raw = readAgentMessageContent(m);\n        const content = typeof raw === 'string'\n          ? raw\n          : (raw as Array<{ type: string; text?: string }>).filter(c => c.type === 'text').map(c => c.text || '').join('\\n');\n        return `[${role}]: ${content}`;\n      })\n      .join('\\n\\n');\n  }\n\n  private extractiveSummary(messages: AgentMessage[]): string {\n    const userMessages = messages\n      .filter(m => m.role === 'user')\n      .slice(-5)\n      .map(m => {\n        const raw = readAgentMessageContent(m);\n        if (typeof raw === 'string') return raw;\n        if (Array.isArray(raw)) {\n          return raw\n            .filter(c => c.type === 'text')\n            .map(c => (c as { text?: string }).text || '')\n            .join('\\n');\n        }\n        return '';\n      })\n      .filter(t => t.length > 0)\n      .join('; ');\n\n    return `Previous conversation covered: ${userMessages.slice(0, 300)}...`;\n  }\n\n  estimateTotalTokens(messages: AgentMessage[]): number {\n    return messages.reduce((sum, msg) => sum + estimateMessageTokens(msg), 0);\n  }\n\n  applyCompaction(\n    messages: AgentMessage[],\n    result: CompactionResult\n  ): AgentMessage[] {\n    if (!result.compacted || !result.summary) {\n      return messages;\n    }\n\n    const summaryMessage: AgentMessage & { usage?: MessageUsage } = {\n      role: 'user',\n      content: [{ type: 'text', text: `[Previous conversation summary]: ${result.summary}` }],\n      timestamp: Date.now(),\n    };\n\n    if (result.compactedUsage) {\n      summaryMessage.usage = result.compactedUsage;\n    }\n\n    const keptMessages = messages.slice(result.firstKeptIndex);\n    return [summaryMessage, ...keptMessages];\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"compaction.js","names":[],"sources":["../../../../src/agent/memory/compaction.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { type Model, type Api, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { completeWithResolvedCredentials } from '../../providers/model-call.js';\nimport { readAgentMessageContent } from './agent-message-access.js';\nimport { generateStructuredSummary, formatSummaryAsText, type ConversationSummary } from './summary-generator.js';\n\nexport interface CompactionResult {\n  summary: string;\n  firstKeptIndex: number;\n  tokensBefore: number;\n  tokensAfter: number;\n  compacted: boolean;\n  structuredSummary?: ConversationSummary;\n  compactedUsage?: {\n    input: number;\n    output: number;\n    total: number;\n    cost?: number;\n  };\n}\n\nexport interface CompactionConfig {\n  enabled: boolean;\n  mode: 'extractive' | 'abstractive' | 'structured';\n  reserveTokens: number;\n  triggerThreshold: number;\n  minMessagesBeforeCompact: number;\n  keepRecentMessages: number;\n  summaryMaxTokens: number;\n  evictionWindow: number;\n  retentionWindow: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nconst DEFAULT_CONFIG: CompactionConfig = {\n  enabled: true,\n  mode: 'abstractive',\n  reserveTokens: 8000,\n  triggerThreshold: 0.8,\n  minMessagesBeforeCompact: 10,\n  keepRecentMessages: 10,\n  summaryMaxTokens: 500,\n  evictionWindow: 0.2,\n  retentionWindow: 6,\n  preserveReasoning: true,\n  accumulateUsage: true,\n};\n\nfunction estimateTokens(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n\nfunction estimateMessageTokens(msg: AgentMessage): number {\n  let text = '';\n  const raw = readAgentMessageContent(msg);\n\n  if (typeof raw === 'string') {\n    text = raw;\n  } else if (Array.isArray(raw)) {\n    text = raw\n      .filter(c => c.type === 'text')\n      .map(c => (c as { text?: string }).text || '')\n      .join('\\n');\n  }\n  \n  return estimateTokens(text) + 10;\n}\n\n// Internal: Reasoning extraction utilities\ninterface ReasoningDetails {\n  thinking?: string;\n  signature?: string;\n}\n\nfunction extractLastReasoning(messages: AgentMessage[]): ReasoningDetails | null {\n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    if (msg.role === 'assistant') {\n      const rd = (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details;\n      if (rd && (rd.thinking || rd.signature)) {\n        return rd;\n      }\n    }\n  }\n  return null;\n}\n\n// Internal: Inject reasoning into first assistant message\nfunction injectReasoningIntoFirstAssistant(\n  messages: AgentMessage[],\n  reasoning: ReasoningDetails\n): void {\n  for (const msg of messages) {\n    if (msg.role === 'assistant') {\n      const existing = (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details;\n      if (!existing || (!existing.thinking && !existing.signature)) {\n        (msg as unknown as { reasoning_details?: ReasoningDetails }).reasoning_details = reasoning;\n      }\n      break;\n    }\n  }\n}\n\n// Internal: Message usage tracking\ninterface MessageUsage {\n  input: number;\n  output: number;\n  total: number;\n  cost?: number;\n}\n\nexport function accumulateUsage(messages: AgentMessage[]): MessageUsage | undefined {\n  let totalInput = 0;\n  let totalOutput = 0;\n  let totalCost = 0;\n  let hasUsage = false;\n\n  for (const msg of messages) {\n    const usage = (msg as unknown as { usage?: MessageUsage }).usage;\n    if (usage) {\n      hasUsage = true;\n      totalInput += usage.input || 0;\n      totalOutput += usage.output || 0;\n      totalCost += usage.cost || 0;\n    }\n  }\n\n  if (!hasUsage) return undefined;\n\n  return {\n    input: totalInput,\n    output: totalOutput,\n    total: totalInput + totalOutput,\n    cost: totalCost > 0 ? totalCost : undefined,\n  };\n}\n\n// Internal: Droppable message filtering\ntype DroppableMessage = AgentMessage & {\n  droppable?: boolean;\n};\n\nfunction filterDroppableMessages(messages: AgentMessage[]): AgentMessage[] {\n  return messages.filter(msg => !(msg as DroppableMessage).droppable);\n}\n\nfunction findNthTurnFromEnd(messages: AgentMessage[], n: number): number {\n  if (n <= 0) return messages.length;\n  \n  let turnsFound = 0;\n  let lastRole: string | null = null;\n  \n  for (let i = messages.length - 1; i >= 0; i--) {\n    const msg = messages[i];\n    \n    if (msg.role === 'user' && lastRole !== 'user') {\n      turnsFound++;\n      if (turnsFound === n) {\n        return i;\n      }\n    }\n    lastRole = msg.role;\n  }\n  \n  return 0;\n}\n\n// Internal: Calculate compaction range\nfunction calculateCompactionRange(\n  messages: AgentMessage[],\n  config: CompactionConfig\n): { start: number; end: number } | null {\n  const totalMessages = messages.length;\n  \n  if (totalMessages < config.minMessagesBeforeCompact) {\n    return null;\n  }\n  \n  const evictionEnd = Math.floor(totalMessages * config.evictionWindow);\n  const retentionStart = findNthTurnFromEnd(messages, config.retentionWindow);\n  const retentionEnd = retentionStart > 0 ? retentionStart - 1 : 0;\n  const compactionEnd = Math.min(evictionEnd, retentionEnd);\n  \n  if (compactionEnd <= 1) {\n    return null;\n  }\n  \n  return { start: 0, end: compactionEnd };\n}\n\nexport class SessionCompactor {\n  private config: CompactionConfig;\n  \n  constructor(\n    config?: Partial<CompactionConfig>,\n    private model?: Model<Api>\n  ) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  needsCompaction(\n    messages: AgentMessage[],\n    contextWindow: number\n  ): { needed: boolean; reason: string; usagePercent?: number } {\n    if (!this.config.enabled) {\n      return { needed: false, reason: 'disabled' };\n    }\n\n    if (messages.length < this.config.minMessagesBeforeCompact) {\n      return { needed: false, reason: 'not_enough_messages' };\n    }\n\n    const totalTokens = this.estimateTotalTokens(messages);\n    const usagePercent = totalTokens / contextWindow;\n\n    if (usagePercent > this.config.triggerThreshold) {\n      return { \n        needed: true, \n        reason: 'threshold_exceeded',\n        usagePercent \n      };\n    }\n\n    return { needed: false, reason: 'within_threshold' };\n  }\n\n  async compact(\n    messages: AgentMessage[],\n    instructions?: string,\n    force?: boolean,\n  ): Promise<CompactionResult> {\n    const effectiveMessages = filterDroppableMessages(messages);\n\n    const minRequired = this.config.minMessagesBeforeCompact;\n    if (!force && effectiveMessages.length < minRequired) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    if (force && effectiveMessages.length < 2) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    const range = calculateCompactionRange(effectiveMessages, this.config);\n    let messagesToSummarize: AgentMessage[];\n    let keptMessages: AgentMessage[];\n\n    if (range) {\n      messagesToSummarize = effectiveMessages.slice(0, range.end);\n      keptMessages = effectiveMessages.slice(range.end);\n    } else if (force) {\n      const keep = Math.min(\n        this.config.keepRecentMessages,\n        Math.max(1, effectiveMessages.length - 1),\n      );\n      messagesToSummarize = effectiveMessages.slice(0, effectiveMessages.length - keep);\n      keptMessages = effectiveMessages.slice(-keep);\n    } else {\n      const keepRecent = this.config.keepRecentMessages;\n      messagesToSummarize = effectiveMessages.slice(0, -keepRecent);\n      keptMessages = effectiveMessages.slice(-keepRecent);\n    }\n\n    if (messagesToSummarize.length === 0) {\n      return {\n        summary: '',\n        firstKeptIndex: 0,\n        tokensBefore: this.estimateTotalTokens(effectiveMessages),\n        tokensAfter: this.estimateTotalTokens(effectiveMessages),\n        compacted: false,\n      };\n    }\n\n    let preservedReasoning: ReasoningDetails | null = null;\n    if (this.config.preserveReasoning) {\n      preservedReasoning = extractLastReasoning(messagesToSummarize);\n      if (preservedReasoning) {\n        injectReasoningIntoFirstAssistant(keptMessages, preservedReasoning);\n      }\n    }\n\n    const summary = await this.generateSummary(messagesToSummarize, instructions);\n    const structuredSummary = this.config.mode === 'structured' \n      ? generateStructuredSummary(messagesToSummarize)\n      : undefined;\n\n    const tokensBefore = this.estimateTotalTokens(effectiveMessages);\n    const summaryTokens = estimateTokens(summary) + 20;\n    const keptTokens = this.estimateTotalTokens(keptMessages);\n    const tokensAfter = summaryTokens + keptTokens;\n\n    let compactedUsage: MessageUsage | undefined;\n    if (this.config.accumulateUsage) {\n      compactedUsage = accumulateUsage(messagesToSummarize);\n    }\n\n    return {\n      summary,\n      firstKeptIndex: keptMessages.length > 0 ? effectiveMessages.length - keptMessages.length : 0,\n      tokensBefore,\n      tokensAfter,\n      compacted: true,\n      structuredSummary,\n      compactedUsage,\n    };\n  }\n\n  private async generateSummary(messages: AgentMessage[], instructions?: string): Promise<string> {\n    if (this.model && (this.config.mode === 'abstractive' || this.config.mode === 'structured')) {\n      try {\n        if (this.config.mode === 'structured') {\n          const structured = generateStructuredSummary(messages);\n          return formatSummaryAsText(structured, true);\n        } else {\n          return await this.llmAbstractiveSummary(messages, instructions);\n        }\n      } catch (err) {\n        console.warn('[Compactor] LLM summarization failed, falling back to extractive', err);\n      }\n    }\n\n    return this.extractiveSummary(messages);\n  }\n\n  private async llmAbstractiveSummary(messages: AgentMessage[], instructions?: string): Promise<string> {\n    if (!this.model) {\n      throw new Error('Model not available');\n    }\n\n    const conversation = this.formatMessages(messages);\n    const extra = instructions?.trim()\n      ? `\\nAdditional focus from the user:\\n${instructions.trim()}\\n`\n      : '';\n    const prompt = `Summarize the following conversation in 2-3 concise sentences. Focus on:\n1. What the user was trying to accomplish\n2. Key decisions, outcomes, or solutions\n3. Any important context that should be preserved\n${extra}\nConversation:\n${conversation}\n\nSummary:`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 30000);\n\n    try {\n      const summaryMessage: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n      const result = await completeWithResolvedCredentials(this.model, {\n        messages: [summaryMessage]\n      }, {\n        maxTokens: this.config.summaryMaxTokens,\n        temperature: 0.3,\n        signal: controller.signal as any,\n      });\n\n      const text = Array.isArray(result.content)\n        ? result.content.filter((c: any) => c.type === 'text').map((c: any) => c.text).join('')\n        : '';\n\n      return text.trim();\n    } catch (err) {\n      if (err instanceof Error && err.name === 'AbortError') {\n        throw new Error('LLM summarization timed out after 30 seconds');\n      }\n      throw err;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private formatMessages(messages: AgentMessage[]): string {\n    return messages\n      .map(m => {\n        const role = m.role;\n        const raw = readAgentMessageContent(m);\n        const content = typeof raw === 'string'\n          ? raw\n          : (raw as Array<{ type: string; text?: string }>).filter(c => c.type === 'text').map(c => c.text || '').join('\\n');\n        return `[${role}]: ${content}`;\n      })\n      .join('\\n\\n');\n  }\n\n  private extractiveSummary(messages: AgentMessage[]): string {\n    const userMessages = messages\n      .filter(m => m.role === 'user')\n      .slice(-5)\n      .map(m => {\n        const raw = readAgentMessageContent(m);\n        if (typeof raw === 'string') return raw;\n        if (Array.isArray(raw)) {\n          return raw\n            .filter(c => c.type === 'text')\n            .map(c => (c as { text?: string }).text || '')\n            .join('\\n');\n        }\n        return '';\n      })\n      .filter(t => t.length > 0)\n      .join('; ');\n\n    return `Previous conversation covered: ${userMessages.slice(0, 300)}...`;\n  }\n\n  estimateTotalTokens(messages: AgentMessage[]): number {\n    return messages.reduce((sum, msg) => sum + estimateMessageTokens(msg), 0);\n  }\n\n  applyCompaction(\n    messages: AgentMessage[],\n    result: CompactionResult\n  ): AgentMessage[] {\n    if (!result.compacted || !result.summary) {\n      return messages;\n    }\n\n    const summaryMessage: AgentMessage & { usage?: MessageUsage } = {\n      role: 'user',\n      content: [{ type: 'text', text: `[Previous conversation summary]: ${result.summary}` }],\n      timestamp: Date.now(),\n    };\n\n    if (result.compactedUsage) {\n      summaryMessage.usage = result.compactedUsage;\n    }\n\n    const keptMessages = messages.slice(result.firstKeptIndex);\n    return [summaryMessage, ...keptMessages];\n  }\n}\n"],"mappings":";;;;AAoCA,MAAM,iBAAmC;CACvC,SAAS;CACT,MAAM;CACN,eAAe;CACf,kBAAkB;CAClB,0BAA0B;CAC1B,oBAAoB;CACpB,kBAAkB;CAClB,gBAAgB;CAChB,iBAAiB;CACjB,mBAAmB;CACnB,iBAAiB;CAClB;AAED,SAAS,eAAe,MAAsB;AAC5C,QAAO,KAAK,KAAK,KAAK,SAAS,EAAE;;AAGnC,SAAS,sBAAsB,KAA2B;CACxD,IAAI,OAAO;CACX,MAAM,MAAM,wBAAwB,IAAI;AAExC,KAAI,OAAO,QAAQ,SACjB,QAAO;UACE,MAAM,QAAQ,IAAI,CAC3B,QAAO,IACJ,QAAO,MAAK,EAAE,SAAS,OAAO,CAC9B,KAAI,MAAM,EAAwB,QAAQ,GAAG,CAC7C,KAAK,KAAK;AAGf,QAAO,eAAe,KAAK,GAAG;;AAShC,SAAS,qBAAqB,UAAmD;AAC/E,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;EAC7C,MAAM,MAAM,SAAS;AACrB,MAAI,IAAI,SAAS,aAAa;GAC5B,MAAM,KAAM,IAA4D;AACxE,OAAI,OAAO,GAAG,YAAY,GAAG,WAC3B,QAAO;;;AAIb,QAAO;;AAIT,SAAS,kCACP,UACA,WACM;AACN,MAAK,MAAM,OAAO,SAChB,KAAI,IAAI,SAAS,aAAa;EAC5B,MAAM,WAAY,IAA4D;AAC9E,MAAI,CAAC,YAAa,CAAC,SAAS,YAAY,CAAC,SAAS,UAC/C,KAA4D,oBAAoB;AAEnF;;;AAaN,SAAgB,gBAAgB,UAAoD;CAClF,IAAI,aAAa;CACjB,IAAI,cAAc;CAClB,IAAI,YAAY;CAChB,IAAI,WAAW;AAEf,MAAK,MAAM,OAAO,UAAU;EAC1B,MAAM,QAAS,IAA4C;AAC3D,MAAI,OAAO;AACT,cAAW;AACX,iBAAc,MAAM,SAAS;AAC7B,kBAAe,MAAM,UAAU;AAC/B,gBAAa,MAAM,QAAQ;;;AAI/B,KAAI,CAAC,SAAU,QAAO,KAAA;AAEtB,QAAO;EACL,OAAO;EACP,QAAQ;EACR,OAAO,aAAa;EACpB,MAAM,YAAY,IAAI,YAAY,KAAA;EACnC;;AAQH,SAAS,wBAAwB,UAA0C;AACzE,QAAO,SAAS,QAAO,QAAO,CAAE,IAAyB,UAAU;;AAGrE,SAAS,mBAAmB,UAA0B,GAAmB;AACvE,KAAI,KAAK,EAAG,QAAO,SAAS;CAE5B,IAAI,aAAa;CACjB,IAAI,WAA0B;AAE9B,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;EAC7C,MAAM,MAAM,SAAS;AAErB,MAAI,IAAI,SAAS,UAAU,aAAa,QAAQ;AAC9C;AACA,OAAI,eAAe,EACjB,QAAO;;AAGX,aAAW,IAAI;;AAGjB,QAAO;;AAIT,SAAS,yBACP,UACA,QACuC;CACvC,MAAM,gBAAgB,SAAS;AAE/B,KAAI,gBAAgB,OAAO,yBACzB,QAAO;CAGT,MAAM,cAAc,KAAK,MAAM,gBAAgB,OAAO,eAAe;CACrE,MAAM,iBAAiB,mBAAmB,UAAU,OAAO,gBAAgB;CAC3E,MAAM,eAAe,iBAAiB,IAAI,iBAAiB,IAAI;CAC/D,MAAM,gBAAgB,KAAK,IAAI,aAAa,aAAa;AAEzD,KAAI,iBAAiB,EACnB,QAAO;AAGT,QAAO;EAAE,OAAO;EAAG,KAAK;EAAe;;AAGzC,IAAa,mBAAb,MAA8B;CAC5B;CAEA,YACE,QACA,OACA;AADQ,OAAA,QAAA;AAER,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;CAGhD,gBACE,UACA,eAC4D;AAC5D,MAAI,CAAC,KAAK,OAAO,QACf,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAY;AAG9C,MAAI,SAAS,SAAS,KAAK,OAAO,yBAChC,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAuB;EAIzD,MAAM,eADc,KAAK,oBAAoB,SACb,GAAG;AAEnC,MAAI,eAAe,KAAK,OAAO,iBAC7B,QAAO;GACL,QAAQ;GACR,QAAQ;GACR;GACD;AAGH,SAAO;GAAE,QAAQ;GAAO,QAAQ;GAAoB;;CAGtD,MAAM,QACJ,UACA,cACA,OAC2B;EAC3B,MAAM,oBAAoB,wBAAwB,SAAS;EAE3D,MAAM,cAAc,KAAK,OAAO;AAChC,MAAI,CAAC,SAAS,kBAAkB,SAAS,YACvC,QAAO;GACL,SAAS;GACT,gBAAgB;GAChB,cAAc,KAAK,oBAAoB,kBAAkB;GACzD,aAAa,KAAK,oBAAoB,kBAAkB;GACxD,WAAW;GACZ;AAGH,MAAI,SAAS,kBAAkB,SAAS,EACtC,QAAO;GACL,SAAS;GACT,gBAAgB;GAChB,cAAc,KAAK,oBAAoB,kBAAkB;GACzD,aAAa,KAAK,oBAAoB,kBAAkB;GACxD,WAAW;GACZ;EAGH,MAAM,QAAQ,yBAAyB,mBAAmB,KAAK,OAAO;EACtE,IAAI;EACJ,IAAI;AAEJ,MAAI,OAAO;AACT,yBAAsB,kBAAkB,MAAM,GAAG,MAAM,IAAI;AAC3D,kBAAe,kBAAkB,MAAM,MAAM,IAAI;aACxC,OAAO;GAChB,MAAM,OAAO,KAAK,IAChB,KAAK,OAAO,oBACZ,KAAK,IAAI,GAAG,kBAAkB,SAAS,EAAE,CAC1C;AACD,yBAAsB,kBAAkB,MAAM,GAAG,kBAAkB,SAAS,KAAK;AACjF,kBAAe,kBAAkB,MAAM,CAAC,KAAK;SACxC;GACL,MAAM,aAAa,KAAK,OAAO;AAC/B,yBAAsB,kBAAkB,MAAM,GAAG,CAAC,WAAW;AAC7D,kBAAe,kBAAkB,MAAM,CAAC,WAAW;;AAGrD,MAAI,oBAAoB,WAAW,EACjC,QAAO;GACL,SAAS;GACT,gBAAgB;GAChB,cAAc,KAAK,oBAAoB,kBAAkB;GACzD,aAAa,KAAK,oBAAoB,kBAAkB;GACxD,WAAW;GACZ;EAGH,IAAI,qBAA8C;AAClD,MAAI,KAAK,OAAO,mBAAmB;AACjC,wBAAqB,qBAAqB,oBAAoB;AAC9D,OAAI,mBACF,mCAAkC,cAAc,mBAAmB;;EAIvE,MAAM,UAAU,MAAM,KAAK,gBAAgB,qBAAqB,aAAa;EAC7E,MAAM,oBAAoB,KAAK,OAAO,SAAS,eAC3C,0BAA0B,oBAAoB,GAC9C,KAAA;EAEJ,MAAM,eAAe,KAAK,oBAAoB,kBAAkB;EAGhE,MAAM,cAFgB,eAAe,QAAQ,GAAG,KAC7B,KAAK,oBAAoB,aACE;EAE9C,IAAI;AACJ,MAAI,KAAK,OAAO,gBACd,kBAAiB,gBAAgB,oBAAoB;AAGvD,SAAO;GACL;GACA,gBAAgB,aAAa,SAAS,IAAI,kBAAkB,SAAS,aAAa,SAAS;GAC3F;GACA;GACA,WAAW;GACX;GACA;GACD;;CAGH,MAAc,gBAAgB,UAA0B,cAAwC;AAC9F,MAAI,KAAK,UAAU,KAAK,OAAO,SAAS,iBAAiB,KAAK,OAAO,SAAS,cAC5E,KAAI;AACF,OAAI,KAAK,OAAO,SAAS,aAEvB,QAAO,oBADY,0BAA0B,SACR,EAAE,KAAK;OAE5C,QAAO,MAAM,KAAK,sBAAsB,UAAU,aAAa;WAE1D,KAAK;AACZ,WAAQ,KAAK,oEAAoE,IAAI;;AAIzF,SAAO,KAAK,kBAAkB,SAAS;;CAGzC,MAAc,sBAAsB,UAA0B,cAAwC;AACpG,MAAI,CAAC,KAAK,MACR,OAAM,IAAI,MAAM,sBAAsB;EAGxC,MAAM,eAAe,KAAK,eAAe,SAAS;EAIlD,MAAM,SAAS;;;;EAHD,cAAc,MAAM,GAC9B,sCAAsC,aAAa,MAAM,CAAC,MAC1D,GAKA;;EAEN,aAAa;;;EAIX,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,IAAM;AAE7D,MAAI;GACF,MAAM,iBAA8B;IAAE,MAAM;IAAQ,SAAS;IAAQ,WAAW,KAAK,KAAK;IAAE;GAC5F,MAAM,SAAS,MAAM,gCAAgC,KAAK,OAAO,EAC/D,UAAU,CAAC,eAAe,EAC3B,EAAE;IACD,WAAW,KAAK,OAAO;IACvB,aAAa;IACb,QAAQ,WAAW;IACpB,CAAC;AAMF,WAJa,MAAM,QAAQ,OAAO,QAAQ,GACtC,OAAO,QAAQ,QAAQ,MAAW,EAAE,SAAS,OAAO,CAAC,KAAK,MAAW,EAAE,KAAK,CAAC,KAAK,GAAG,GACrF,IAEQ,MAAM;WACX,KAAK;AACZ,OAAI,eAAe,SAAS,IAAI,SAAS,aACvC,OAAM,IAAI,MAAM,+CAA+C;AAEjE,SAAM;YACE;AACR,gBAAa,UAAU;;;CAI3B,eAAuB,UAAkC;AACvD,SAAO,SACJ,KAAI,MAAK;GACR,MAAM,OAAO,EAAE;GACf,MAAM,MAAM,wBAAwB,EAAE;AAItC,UAAO,IAAI,KAAK,KAHA,OAAO,QAAQ,WAC3B,MACC,IAA+C,QAAO,MAAK,EAAE,SAAS,OAAO,CAAC,KAAI,MAAK,EAAE,QAAQ,GAAG,CAAC,KAAK,KAAK;IAEpH,CACD,KAAK,OAAO;;CAGjB,kBAA0B,UAAkC;AAkB1D,SAAO,kCAjBc,SAClB,QAAO,MAAK,EAAE,SAAS,OAAO,CAC9B,MAAM,GAAG,CACT,KAAI,MAAK;GACR,MAAM,MAAM,wBAAwB,EAAE;AACtC,OAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,OAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IACJ,QAAO,MAAK,EAAE,SAAS,OAAO,CAC9B,KAAI,MAAM,EAAwB,QAAQ,GAAG,CAC7C,KAAK,KAAK;AAEf,UAAO;IACP,CACD,QAAO,MAAK,EAAE,SAAS,EAAE,CACzB,KAAK,KAE6C,CAAC,MAAM,GAAG,IAAI,CAAC;;CAGtE,oBAAoB,UAAkC;AACpD,SAAO,SAAS,QAAQ,KAAK,QAAQ,MAAM,sBAAsB,IAAI,EAAE,EAAE;;CAG3E,gBACE,UACA,QACgB;AAChB,MAAI,CAAC,OAAO,aAAa,CAAC,OAAO,QAC/B,QAAO;EAGT,MAAM,iBAA0D;GAC9D,MAAM;GACN,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,oCAAoC,OAAO;IAAW,CAAC;GACvF,WAAW,KAAK,KAAK;GACtB;AAED,MAAI,OAAO,eACT,gBAAe,QAAQ,OAAO;AAIhC,SAAO,CAAC,gBAAgB,GADH,SAAS,MAAM,OAAO,eACJ,CAAC"}

package/dist/src/agent/service/btw-query.d.ts

@@ -1,4 +1,5 @@
 import type { SessionStore } from '../../session/index.js';
+import type { CredentialResolverOptions } from '../../auth/credentials.js';
 type BtwLog = {
     warn: (obj: Record<string, unknown>, msg: string) => void;
 };
@@ -11,6 +12,9 @@ export declare function runBtwQuery(opts: {
     log: BtwLog;
     maxTokens?: number;
     temperature?: number;
+    includeSessionContext?: boolean;
+    onTextDelta?: (delta: string) => void | Promise<void>;
+    credentialOptions?: CredentialResolverOptions;
 }): Promise<{
     text: string;
     error?: string;

package/dist/src/agent/service/btw-query.js

@@ -1,6 +1,6 @@
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { completeWithResolvedCredentials, createResolvedModelStream, resolveModelCallApiKey } from "../../providers/model-call.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
-import { complete } from "@earendil-works/pi-ai/compat";
 //#region src/agent/service/btw-query.ts
 init_providers();
 function textFromCompleteContent(content) {
@@ -26,7 +26,6 @@ async function runBtwQuery(opts) {
 		text: "",
 		error: "Empty question."
 	};
-	const messages = await opts.sessionStore.load(opts.sessionKey);
 	const modelRef = opts.modelForSession;
 	let model;
 	try {
@@ -43,10 +42,37 @@ async function runBtwQuery(opts) {
 			error: `Could not resolve model: ${modelRef}`
 		};
 	}
-	const background = formatMessagesForBtw(messages.slice(-40));
-	const userMessage = {
-		role: "user",
-		content: [
+	let apiKey;
+	try {
+		apiKey = await resolveModelCallApiKey(model, opts.credentialOptions);
+	} catch (err) {
+		const em = err instanceof Error ? err.message : String(err);
+		opts.log.warn({
+			err,
+			modelRef,
+			provider: model.provider,
+			errorMessage: em
+		}, "btwQuery: credential lookup failed");
+		return {
+			text: "",
+			error: `Could not load credentials for provider: ${model.provider}`
+		};
+	}
+	if (!apiKey) {
+		opts.log.warn({
+			modelRef,
+			provider: model.provider
+		}, "btwQuery: provider credentials are not configured");
+		return {
+			text: "",
+			error: `No API key for provider: ${model.provider}`
+		};
+	}
+	const includeSessionContext = opts.includeSessionContext ?? true;
+	let userPrompt = q;
+	if (includeSessionContext) {
+		const background = formatMessagesForBtw((await opts.sessionStore.load(opts.sessionKey)).slice(-40));
+		userPrompt = [
 			[
 				"You are answering an ephemeral /btw side question about the current conversation.",
 				"Use the conversation only as background context.",
@@ -62,7 +88,11 @@ async function runBtwQuery(opts) {
 			"---",
 			"Side question:",
 			q
-		].join("\n"),
+		].join("\n");
+	}
+	const userMessage = {
+		role: "user",
+		content: userPrompt,
 		timestamp: Date.now()
 	};
 	const controller = new AbortController();
@@ -70,14 +100,65 @@ async function runBtwQuery(opts) {
 	try {
 		const requestedMaxTokens = Math.max(1, Math.trunc(opts.maxTokens ?? 2048));
 		const modelMaxTokens = typeof model.maxTokens === "number" && Number.isFinite(model.maxTokens) ? Math.max(1, Math.trunc(model.maxTokens)) : void 0;
-		const text = textFromCompleteContent((await complete(model, { messages: [userMessage] }, {
+		const modelCallOptions = {
 			maxTokens: modelMaxTokens ? Math.min(requestedMaxTokens, modelMaxTokens) : requestedMaxTokens,
-			temperature: opts.temperature ?? .4,
-			signal: controller.signal
-		})).content).trim();
-		return text ? { text } : {
+			signal: controller.signal,
+			apiKey,
+			...opts.temperature !== void 0 ? { temperature: opts.temperature } : {}
+		};
+		let streamedText = "";
+		const response = opts.onTextDelta ? await (async () => {
+			const stream = await createResolvedModelStream(model, { messages: [userMessage] }, modelCallOptions, opts.credentialOptions);
+			for await (const event of stream) {
+				const streamEvent = event;
+				if (streamEvent.type === "text_delta" && typeof streamEvent.delta === "string") {
+					streamedText += streamEvent.delta;
+					await opts.onTextDelta?.(streamEvent.delta);
+					continue;
+				}
+				if (streamEvent.type === "error") {
+					const error = streamEvent.error;
+					const message = error && typeof error === "object" && "errorMessage" in error ? error.errorMessage : void 0;
+					throw new Error(typeof message === "string" && message ? message : "Model stream failed");
+				}
+			}
+			return await stream.result();
+		})() : await completeWithResolvedCredentials(model, { messages: [userMessage] }, modelCallOptions, opts.credentialOptions);
+		const text = (streamedText || textFromCompleteContent(response.content)).trim();
+		if (text) return { text };
+		const stopReason = typeof response.stopReason === "string" ? response.stopReason : void 0;
+		const errorMessage = typeof response.errorMessage === "string" ? response.errorMessage.trim() : "";
+		if (stopReason === "error" && errorMessage) {
+			opts.log.warn({
+				sessionKey: opts.sessionKey,
+				modelRef,
+				stopReason,
+				errorMessage
+			}, "btwQuery model call failed");
+			return {
+				text: "",
+				error: errorMessage
+			};
+		}
+		const contentTypes = Array.isArray(response.content) ? response.content.map((block) => block && typeof block === "object" && "type" in block ? String(block.type) : "unknown").join(", ") : void 0;
+		const reasoningTokens = typeof response.usage?.reasoning === "number" ? response.usage.reasoning : void 0;
+		const detail = [
+			stopReason ? `stop reason: ${stopReason}` : "",
+			contentTypes ? `content: ${contentTypes}` : "",
+			reasoningTokens != null ? `reasoning tokens: ${reasoningTokens}` : ""
+		].filter(Boolean).join("; ");
+		const error = `No text returned from model${detail ? ` (${detail})` : ""}.`;
+		opts.log.warn({
+			sessionKey: opts.sessionKey,
+			modelRef,
+			stopReason,
+			errorMessage: errorMessage || void 0,
+			contentTypes,
+			reasoningTokens
+		}, "btwQuery returned no text");
+		return {
 			text: "",
-			error: "No text returned from model."
+			error
 		};
 	} catch (err) {
 		const em = err instanceof Error ? err.message : String(err);

package/dist/src/agent/service/btw-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"btw-query.js","names":[],"sources":["../../../../src/agent/service/btw-query.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport type { SessionStore } from '../../session/index.js';\nimport { resolveModel } from '../../providers/index.js';\n\ntype BtwLog = { warn: (obj: Record<string, unknown>, msg: string) => void };\n\nfunction textFromCompleteContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter(\n      (c): c is { type: 'text'; text: string } =>\n        c?.type === 'text' && typeof (c as { text?: unknown }).text === 'string',\n    )\n    .map((c) => c.text || '')\n    .join('');\n}\n\nfunction formatMessagesForBtw(messages: AgentMessage[]): string {\n  return messages\n    .map((m) => {\n      const role = m.role;\n      let body = '';\n      const raw = readAgentMessageContent(m);\n      if (typeof raw === 'string') {\n        body = raw;\n      } else if (Array.isArray(raw)) {\n        body = raw\n          .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n          .map((c) => c.text || '')\n          .join('\\n');\n      }\n      const line = `[${role}]: ${body}`;\n      return line.length > 4000 ? `${line.slice(0, 4000)}…` : line;\n    })\n    .join('\\n\\n');\n}\n\n/** One-shot LLM answer for /btw: transcript as background only; does not persist. */\nexport async function runBtwQuery(opts: {\n  sessionKey: string;\n  question: string;\n  sessionStore: SessionStore;\n  modelForSession: string;\n  log: BtwLog;\n  maxTokens?: number;\n  temperature?: number;\n}): Promise<{ text: string; error?: string }> {\n  const q = opts.question.trim();\n  if (!q) {\n    return { text: '', error: 'Empty question.' };\n  }\n  const messages = await opts.sessionStore.load(opts.sessionKey);\n  const modelRef = opts.modelForSession;\n  let model;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, modelRef, errorMessage: em }, 'btwQuery: model resolve failed');\n    return { text: '', error: `Could not resolve model: ${modelRef}` };\n  }\n\n  const background = formatMessagesForBtw(messages.slice(-40));\n  const systemBlock = [\n    'You are answering an ephemeral /btw side question about the current conversation.',\n    'Use the conversation only as background context.',\n    'Answer only the side question. Do not continue or complete any unfinished task from the conversation.',\n    'Do not use tools, commands, or file writes unless the question explicitly requires a tiny code snippet.',\n    'If the question can be answered briefly, answer briefly.',\n  ].join('\\n');\n\n  const userPrompt = [\n    systemBlock,\n    '',\n    '---',\n    'Conversation background (read-only):',\n    background || '(empty)',\n    '',\n    '---',\n    'Side question:',\n    q,\n  ].join('\\n');\n\n  const userMessage: UserMessage = { role: 'user', content: userPrompt, timestamp: Date.now() };\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), 90_000);\n  try {\n    const requestedMaxTokens = Math.max(1, Math.trunc(opts.maxTokens ?? 2048));\n    const modelMaxTokens = typeof model.maxTokens === 'number' && Number.isFinite(model.maxTokens)\n      ? Math.max(1, Math.trunc(model.maxTokens))\n      : undefined;\n    const out = await complete(model, { messages: [userMessage] }, {\n      maxTokens: modelMaxTokens ? Math.min(requestedMaxTokens, modelMaxTokens) : requestedMaxTokens,\n      temperature: opts.temperature ?? 0.4,\n      signal: controller.signal as AbortSignal,\n    });\n    const text = textFromCompleteContent((out as { content?: unknown }).content).trim();\n    return text ? { text } : { text: '', error: 'No text returned from model.' };\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, sessionKey: opts.sessionKey, errorMessage: em }, 'btwQuery failed');\n    return { text: '', error: em };\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":";;;;gBAKwD;AAIxD,SAAS,wBAAwB,SAA0B;AACzD,KAAI,OAAO,YAAY,SACrB,QAAO;AAET,KAAI,CAAC,MAAM,QAAQ,QAAQ,CACzB,QAAO;AAET,QAAO,QACJ,QACE,MACC,GAAG,SAAS,UAAU,OAAQ,EAAyB,SAAS,SACnE,CACA,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,GAAG;;AAGb,SAAS,qBAAqB,UAAkC;AAC9D,QAAO,SACJ,KAAK,MAAM;EACV,MAAM,OAAO,EAAE;EACf,IAAI,OAAO;EACX,MAAM,MAAM,wBAAwB,EAAE;AACtC,MAAI,OAAO,QAAQ,SACjB,QAAO;WACE,MAAM,QAAQ,IAAI,CAC3B,QAAO,IACJ,QAAQ,MAA2C,EAAE,SAAS,OAAO,CACrE,KAAK,MAAM,EAAE,QAAQ,GAAG,CACxB,KAAK,KAAK;EAEf,MAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,SAAO,KAAK,SAAS,MAAO,GAAG,KAAK,MAAM,GAAG,IAAK,CAAC,KAAK;GACxD,CACD,KAAK,OAAO;;;AAIjB,eAAsB,YAAY,MAQY;CAC5C,MAAM,IAAI,KAAK,SAAS,MAAM;AAC9B,KAAI,CAAC,EACH,QAAO;EAAE,MAAM;EAAI,OAAO;EAAmB;CAE/C,MAAM,WAAW,MAAM,KAAK,aAAa,KAAK,KAAK,WAAW;CAC9D,MAAM,WAAW,KAAK;CACtB,IAAI;AACJ,KAAI;AACF,UAAQ,aAAa,SAAS;UACvB,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAK,IAAI,KAAK;GAAE;GAAK;GAAU,cAAc;GAAI,EAAE,iCAAiC;AACpF,SAAO;GAAE,MAAM;GAAI,OAAO,4BAA4B;GAAY;;CAGpE,MAAM,aAAa,qBAAqB,SAAS,MAAM,IAAI,CAAC;CAqB5D,MAAM,cAA2B;EAAE,MAAM;EAAQ,SAZ9B;GARC;IAClB;IACA;IACA;IACA;IACA;IACD,CAAC,KAAK,KAGM;GACX;GACA;GACA;GACA,cAAc;GACd;GACA;GACA;GACA;GACD,CAAC,KAAK,KAE6D;EAAE,WAAW,KAAK,KAAK;EAAE;CAC7F,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,IAAO;AAC9D,KAAI;EACF,MAAM,qBAAqB,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,aAAa,KAAK,CAAC;EAC1E,MAAM,iBAAiB,OAAO,MAAM,cAAc,YAAY,OAAO,SAAS,MAAM,UAAU,GAC1F,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,UAAU,CAAC,GACxC,KAAA;EAMJ,MAAM,OAAO,yBAAyB,MALpB,SAAS,OAAO,EAAE,UAAU,CAAC,YAAY,EAAE,EAAE;GAC7D,WAAW,iBAAiB,KAAK,IAAI,oBAAoB,eAAe,GAAG;GAC3E,aAAa,KAAK,eAAe;GACjC,QAAQ,WAAW;GACpB,CAAC,EACkE,QAAQ,CAAC,MAAM;AACnF,SAAO,OAAO,EAAE,MAAM,GAAG;GAAE,MAAM;GAAI,OAAO;GAAgC;UACrE,KAAK;EACZ,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAC3D,OAAK,IAAI,KAAK;GAAE;GAAK,YAAY,KAAK;GAAY,cAAc;GAAI,EAAE,kBAAkB;AACxF,SAAO;GAAE,MAAM;GAAI,OAAO;GAAI;WACtB;AACR,eAAa,UAAU"}
+{"version":3,"file":"btw-query.js","names":[],"sources":["../../../../src/agent/service/btw-query.ts"],"sourcesContent":["import type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport type { SessionStore } from '../../session/index.js';\nimport type { CredentialResolverOptions } from '../../auth/credentials.js';\nimport { resolveModel } from '../../providers/index.js';\nimport {\n  completeWithResolvedCredentials,\n  createResolvedModelStream,\n  resolveModelCallApiKey,\n} from '../../providers/model-call.js';\n\ntype BtwLog = { warn: (obj: Record<string, unknown>, msg: string) => void };\n\nfunction textFromCompleteContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  return content\n    .filter(\n      (c): c is { type: 'text'; text: string } =>\n        c?.type === 'text' && typeof (c as { text?: unknown }).text === 'string',\n    )\n    .map((c) => c.text || '')\n    .join('');\n}\n\nfunction formatMessagesForBtw(messages: AgentMessage[]): string {\n  return messages\n    .map((m) => {\n      const role = m.role;\n      let body = '';\n      const raw = readAgentMessageContent(m);\n      if (typeof raw === 'string') {\n        body = raw;\n      } else if (Array.isArray(raw)) {\n        body = raw\n          .filter((c): c is { type: 'text'; text: string } => c.type === 'text')\n          .map((c) => c.text || '')\n          .join('\\n');\n      }\n      const line = `[${role}]: ${body}`;\n      return line.length > 4000 ? `${line.slice(0, 4000)}…` : line;\n    })\n    .join('\\n\\n');\n}\n\n/** One-shot LLM answer for /btw: transcript as background only; does not persist. */\nexport async function runBtwQuery(opts: {\n  sessionKey: string;\n  question: string;\n  sessionStore: SessionStore;\n  modelForSession: string;\n  log: BtwLog;\n  maxTokens?: number;\n  temperature?: number;\n  includeSessionContext?: boolean;\n  onTextDelta?: (delta: string) => void | Promise<void>;\n  credentialOptions?: CredentialResolverOptions;\n}): Promise<{ text: string; error?: string }> {\n  const q = opts.question.trim();\n  if (!q) {\n    return { text: '', error: 'Empty question.' };\n  }\n  const modelRef = opts.modelForSession;\n  let model;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, modelRef, errorMessage: em }, 'btwQuery: model resolve failed');\n    return { text: '', error: `Could not resolve model: ${modelRef}` };\n  }\n\n  let apiKey: string | undefined;\n  try {\n    apiKey = await resolveModelCallApiKey(model, opts.credentialOptions);\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, modelRef, provider: model.provider, errorMessage: em }, 'btwQuery: credential lookup failed');\n    return { text: '', error: `Could not load credentials for provider: ${model.provider}` };\n  }\n  if (!apiKey) {\n    opts.log.warn({ modelRef, provider: model.provider }, 'btwQuery: provider credentials are not configured');\n    return { text: '', error: `No API key for provider: ${model.provider}` };\n  }\n\n  const includeSessionContext = opts.includeSessionContext ?? true;\n  let userPrompt = q;\n  if (includeSessionContext) {\n    const messages = await opts.sessionStore.load(opts.sessionKey);\n    const background = formatMessagesForBtw(messages.slice(-40));\n    const systemBlock = [\n      'You are answering an ephemeral /btw side question about the current conversation.',\n      'Use the conversation only as background context.',\n      'Answer only the side question. Do not continue or complete any unfinished task from the conversation.',\n      'Do not use tools, commands, or file writes unless the question explicitly requires a tiny code snippet.',\n      'If the question can be answered briefly, answer briefly.',\n    ].join('\\n');\n    userPrompt = [\n      systemBlock,\n      '',\n      '---',\n      'Conversation background (read-only):',\n      background || '(empty)',\n      '',\n      '---',\n      'Side question:',\n      q,\n    ].join('\\n');\n  }\n\n  const userMessage: UserMessage = { role: 'user', content: userPrompt, timestamp: Date.now() };\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), 90_000);\n  try {\n    const requestedMaxTokens = Math.max(1, Math.trunc(opts.maxTokens ?? 2048));\n    const modelMaxTokens = typeof model.maxTokens === 'number' && Number.isFinite(model.maxTokens)\n      ? Math.max(1, Math.trunc(model.maxTokens))\n      : undefined;\n    const modelCallOptions = {\n      maxTokens: modelMaxTokens ? Math.min(requestedMaxTokens, modelMaxTokens) : requestedMaxTokens,\n      signal: controller.signal as AbortSignal,\n      apiKey,\n      ...(opts.temperature !== undefined ? { temperature: opts.temperature } : {}),\n    };\n    let streamedText = '';\n    const out = opts.onTextDelta\n      ? await (async () => {\n          const stream = await createResolvedModelStream(\n            model,\n            { messages: [userMessage] },\n            modelCallOptions,\n            opts.credentialOptions,\n          );\n          for await (const event of stream) {\n            const streamEvent = event as { type?: unknown; delta?: unknown; error?: unknown };\n            if (streamEvent.type === 'text_delta' && typeof streamEvent.delta === 'string') {\n              streamedText += streamEvent.delta;\n              await opts.onTextDelta?.(streamEvent.delta);\n              continue;\n            }\n            if (streamEvent.type === 'error') {\n              const error = streamEvent.error;\n              const message = error && typeof error === 'object' && 'errorMessage' in error\n                ? (error as { errorMessage?: unknown }).errorMessage\n                : undefined;\n              throw new Error(typeof message === 'string' && message ? message : 'Model stream failed');\n            }\n          }\n          return await stream.result();\n        })()\n      : await completeWithResolvedCredentials(model, { messages: [userMessage] }, modelCallOptions, opts.credentialOptions);\n    const response = out as {\n      content?: unknown;\n      stopReason?: unknown;\n      errorMessage?: unknown;\n      usage?: { output?: unknown; reasoning?: unknown };\n    };\n    const text = (streamedText || textFromCompleteContent(response.content)).trim();\n    if (text) return { text };\n\n    const stopReason = typeof response.stopReason === 'string' ? response.stopReason : undefined;\n    const errorMessage = typeof response.errorMessage === 'string' ? response.errorMessage.trim() : '';\n    if (stopReason === 'error' && errorMessage) {\n      opts.log.warn({ sessionKey: opts.sessionKey, modelRef, stopReason, errorMessage }, 'btwQuery model call failed');\n      return { text: '', error: errorMessage };\n    }\n    const contentTypes = Array.isArray(response.content)\n      ? response.content\n        .map((block) => block && typeof block === 'object' && 'type' in block\n          ? String((block as { type?: unknown }).type)\n          : 'unknown')\n        .join(', ')\n      : undefined;\n    const reasoningTokens = typeof response.usage?.reasoning === 'number' ? response.usage.reasoning : undefined;\n    const detail = [\n      stopReason ? `stop reason: ${stopReason}` : '',\n      contentTypes ? `content: ${contentTypes}` : '',\n      reasoningTokens != null ? `reasoning tokens: ${reasoningTokens}` : '',\n    ].filter(Boolean).join('; ');\n    const error = `No text returned from model${detail ? ` (${detail})` : ''}.`;\n    opts.log.warn({\n      sessionKey: opts.sessionKey,\n      modelRef,\n      stopReason,\n      errorMessage: errorMessage || undefined,\n      contentTypes,\n      reasoningTokens,\n    }, 'btwQuery returned no text');\n    return { text: '', error };\n  } catch (err) {\n    const em = err instanceof Error ? err.message : String(err);\n    opts.log.warn({ err, sessionKey: opts.sessionKey, errorMessage: em }, 'btwQuery failed');\n    return { text: '', error: em };\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/session/session-inspector.js

@@ -48,6 +48,8 @@ var SessionInspector = class {
 	}
 	/** One-shot LLM answer for `/btw`: transcript as background, not persisted. */
 	btwQuery(sessionKey, question, options) {
+		const config = this.opts.getConfig();
+		const profile = config ? resolveEffectiveAgentProfileForSession(config, sessionKey) : void 0;
 		return runBtwQuery({
 			sessionKey,
 			question,
@@ -55,7 +57,13 @@ var SessionInspector = class {
 			modelForSession: options?.modelRef?.trim() || this.opts.modelManager.getModelForSession(sessionKey),
 			log,
 			maxTokens: options?.maxTokens,
-			temperature: options?.temperature
+			temperature: options?.temperature,
+			includeSessionContext: options?.includeSessionContext,
+			onTextDelta: options?.onTextDelta,
+			credentialOptions: profile && config ? {
+				agentId: profile.agentId,
+				appConfig: config
+			} : void 0
 		});
 	}
 	/** Cheap stats used by both the report and other callers. */