@chatpanel/events 0.102.0 → 0.104.0

package/team-record.js

@@ -1,225 +1 @@
-// The run record — a team run folded from its events, the same way on the gateway's store
-// and in either client. One fold, so what the desktop shows, what the extension shows and
-// what the store holds never disagree; and enough on the record to RESUME the run from
-// anywhere: the plan, every task's status and transcript, the board, the spend.
-//
-// The gateway vendors this file (its store used to carry a mirror of it, which is the copy
-// that drifts). `checkpointFrom(run)` is what a client hands `resumeTeam` after reading a
-// run the process that started it no longer runs.
-
-import { foldBoard, emptyBoardState } from './team-board.js';
-
-export const LIVE_RUN_STATUSES = Object.freeze(['planning', 'running', 'merging', 'waiting']);
-export const RESUMABLE_RUN_STATUSES = Object.freeze(['waiting', 'stopped', 'failed', 'partial', 'over-budget', 'answered']);
-const TASK_TEXT_MAX = 20_000;
-
-export function emptyRun({ id, client = '', now = Date.now() } = {}) {
-  return { id, client: String(client || '').slice(0, 40), createdAt: now, lastEventAt: now, status: 'planning', team: '', request: '', roles: [], plan: null, tasks: [], jobs: [], board: [], threads: emptyBoardState(), checkpoint: null, proposal: null, usage: null, stopRequested: null, startedAt: null, endedAt: null };
-}
-
-const taskOf = (run, id) => run.tasks.find((x) => x.id === id);
-
-/** Fold one event (`{ type, at, payload }`, or a flat `{ type, at, ...payload }`) into the record. */
-export function foldRun(run, ev) {
-  const type = String(ev?.type || '');
-  const p = ev?.payload && typeof ev.payload === 'object' ? ev.payload : (ev || {});
-  const at = Number(ev?.at) || Date.now();
-  run.lastEventAt = at;
-  switch (type) {
-    case 'run.started':
-    case 'run.resumed':
-      run.team = p.team || run.team; run.request = p.request ?? run.request; run.budget = p.budget || run.budget;
-      run.roles = Array.isArray(p.roles) ? p.roles : run.roles; run.status = 'planning'; run.startedAt = run.startedAt || at;
-      if (type === 'run.resumed') { run.endedAt = null; run.checkpoint = null; run.resumedAt = at; }
-      break;
-    case 'plan.ready':
-      run.plan = { by: p.by || 'fixed', tasks: Array.isArray(p.tasks) ? p.tasks : [] };
-      // A resume replays the plan: keep what the tasks already hold (transcripts, attempts).
-      run.tasks = run.plan.tasks.map((t) => ({ ...(taskOf(run, t.id) || {}), id: t.id, role: t.role, title: t.title, status: taskOf(run, t.id)?.status === 'ok' ? 'ok' : (t.parent && !t.role ? 'unassigned' : 'pending'), findings: taskOf(run, t.id)?.findings || 0, ...(t.parent ? { parent: t.parent, requestedBy: t.requestedBy || null } : {}), ...(t.grants ? { grants: t.grants, why: t.why || '' } : {}), ...(t.kind ? { kind: t.kind } : {}) }));
-      run.status = 'running';
-      break;
-    // A SUB-TASK (§15.2): requested by a member mid-run, it joins the plan under its parent;
-    // taken by a member, recruited from the pool, created on a person's approval — or not.
-    case 'task.requested':
-      if (p.taskId && !taskOf(run, p.taskId)) {
-        const task = { id: p.taskId, role: null, title: p.title || p.taskId, prompt: p.prompt || '', dependsOn: Array.isArray(p.dependsOn) ? p.dependsOn : [], parent: p.parent || null, requestedBy: p.by || null, needs: p.needs || null, depth: p.depth || 1, wait: p.wait !== false };
-        if (run.plan) run.plan.tasks = [...(run.plan.tasks || []), task];
-        run.tasks.push({ id: task.id, role: null, title: task.title, status: 'requested', findings: 0, parent: task.parent, requestedBy: task.requestedBy, needs: task.needs, requestedAt: at });
-      }
-      break;
-    // A TASK ADDED AFTER THE PLAN — the merge (the judge's task, opened when the members are
-    // done). It joins the plan so a resume carries it and the board draws its thread and log.
-    case 'task.added':
-      if (p.taskId && !taskOf(run, p.taskId)) {
-        const task = { id: p.taskId, role: p.role || null, title: p.title || p.taskId, dependsOn: Array.isArray(p.dependsOn) ? p.dependsOn : [], ...(p.kind ? { kind: p.kind } : {}) };
-        if (run.plan) run.plan.tasks = [...(run.plan.tasks || []), task];
-        run.tasks.push({ id: task.id, role: task.role, title: task.title, status: 'pending', findings: 0, ...(p.kind ? { kind: p.kind } : {}) });
-      }
-      break;
-    case 'task.taken': { const t = taskOf(run, p.taskId); if (t) { t.role = p.role; t.status = 'pending'; t.takenBy = { by: p.by || 'fit', role: p.role, fit: p.fit ?? null, reasons: p.reasons || [], agentId: p.agentId || null, engine: p.engine || null, why: p.why || '', at }; } const pt = run.plan?.tasks?.find((x) => x.id === p.taskId); if (pt) pt.role = p.role; break; }
-    case 'task.posted': { const t = taskOf(run, p.taskId); if (t) t.job = p.job || null; if (p.job && !run.jobs.some((j) => j.id === p.job.id)) run.jobs.push({ ...p.job, taskId: p.taskId, at }); break; }
-    case 'task.proposed': { const t = taskOf(run, p.taskId); if (t) t.proposal = { agent: p.agent || null, threadId: p.threadId || null, postId: p.postId || null, why: p.why || '', at }; break; }
-    case 'task.unassigned': { const t = taskOf(run, p.taskId); if (t) { t.status = 'unassigned'; t.error = p.why || null; t.endedAt = at; } const j = run.jobs.find((x) => x.taskId === p.taskId); if (j) j.status = 'failed'; break; }
-    case 'task.nudged': { const t = taskOf(run, p.taskId); if (t) t.nudged = [...(t.nudged || []), { grants: p.grants || [], at }]; break; }
-    case 'run.role-added': if (p.role?.id && !run.roles.includes(p.role.id)) { run.roles.push(p.role.id); run.recruited = [...(run.recruited || []), { ...p.role, jobId: p.jobId || null, at }]; const j = run.jobs.find((x) => x.id === p.jobId); if (j) { j.status = 'recruited'; j.recruited = { agentId: p.role.agent || p.role.id, engine: p.role.engine || null, at }; } } break;
-    case 'task.started': {
-      // A start the plan never named (a record from a build whose merge was not a task) gets
-      // its row here rather than being dropped — the fold never loses a task that ran.
-      let t = taskOf(run, p.taskId);
-      if (!t && p.taskId) { t = { id: p.taskId, role: p.role || null, title: p.title || p.taskId, status: 'pending', findings: 0, ...(p.taskId === 'merge' ? { kind: 'merge' } : {}) }; run.tasks.push(t); }
-      if (t) { t.status = 'running'; t.startedAt = at; t.error = null; }
-      run.status = 'running'; break;
-    }
-    case 'task.model': { const t = taskOf(run, p.taskId); if (t) { t.model = p.model; t.attempts = [...(t.attempts || []), { model: p.model, ...(p.label ? { label: p.label } : {}), at, attempt: p.attempt }]; } break; }
-    // Which engine the attempt runs on (pillars §13): kept on the attempt, so a record folded
-    // from events names the model the way the runner's own `attempts` do.
-    case 'task.routed': { const t = taskOf(run, p.taskId); const a = t?.attempts?.at?.(-1); if (a && p.engine && (a.attempt == null || a.attempt === p.attempt)) a.engine = p.engine; break; }
-    case 'task.step': { const t = taskOf(run, p.taskId); if (t && Array.isArray(p.steps)) t.transcript = [...(t.transcript || []), ...p.steps]; break; }
-    case 'task.handoff': { const t = taskOf(run, p.taskId); if (t) { t.model = p.to; t.handoffs = [...(t.handoffs || []), { from: p.from, to: p.to, by: p.by, reason: p.reason, at }]; } break; }
-    case 'task.tool': { const t = taskOf(run, p.taskId); if (t) t.tools = (t.tools || 0) + 1; break; }
-    case 'task.delta': { const t = taskOf(run, p.taskId); if (t) t.text = String(p.text || '').slice(0, TASK_TEXT_MAX); break; }
-    case 'task.finding':
-      if (p.finding && p.finding.text) { run.board.push({ ...p.finding, at }); const t = taskOf(run, p.taskId); if (t) t.findings += 1; }
-      break;
-    case 'task.waiting': { const t = taskOf(run, p.taskId); if (t) { t.status = 'waiting'; t.waitingOn = p.threadId; } break; }
-    case 'task.done':
-    case 'task.failed': {
-      const t = taskOf(run, p.taskId);
-      if (t) { t.status = p.status || (type === 'task.done' ? 'ok' : 'failed'); t.error = p.error || null; t.ms = p.ms; t.endedAt = at; }
-      // A job posting's outcome is the sub-task's (§15.2.5): taken by, finished how.
-      const j = run.jobs.find((x) => x.taskId === p.taskId);
-      if (j) { j.status = type === 'task.done' ? 'done' : 'failed'; j.endedAt = at; }
-      break;
-    }
-    case 'run.merging': run.status = 'merging'; break;
-    case 'run.waiting': run.status = 'running'; break;
-    case 'run.usage': run.usage = p.usage || run.usage; break;
-    case 'run.done':
-      run.status = p.status || 'completed'; run.usage = p.usage || run.usage; run.proposal = p.proposal ?? run.proposal; run.endedAt = at;
-      if (p.checkpoint) run.checkpoint = p.checkpoint;
-      break;
-    case 'run.stop-requested': run.stopRequested = at; break;
-    case 'board.thread': case 'board.post': case 'board.decision': case 'board.thread-status': case 'board.thread-removed':
-      run.threads = foldBoard(run.threads || emptyBoardState(), ev);
-      if (type === 'board.thread-status' && p.status !== 'waiting' && run.status === 'waiting' && !(run.threads.threads || []).some((t) => t.kind === 'ask' && t.status === 'waiting')) run.status = 'answered';
-      break;
-    default: break;
-  }
-  return run;
-}
-
-/** Fold a whole event list into a fresh record. */
-export function runFromEvents(id, events, opts = {}) {
-  const run = emptyRun({ id, ...opts });
-  for (const ev of events || []) foldRun(run, ev);
-  return run;
-}
-
-/**
- * What `resumeTeam` needs, from the record alone — the runner's own checkpoint when the run
- * ended with one, else one built from the folded tasks: whatever the process that ran it
- * managed to write before it went. A task recorded `running` (its process died) resumes
- * from its transcript like a waiting one.
- */
-export function checkpointFrom(run) {
-  if (!run?.plan?.tasks?.length) return null;
-  if (run.checkpoint?.plan?.tasks?.length) return { ...run.checkpoint, board: run.threads && run.threads.threads?.length >= (run.checkpoint.board?.threads?.length || 0) ? run.threads : run.checkpoint.board };
-  return {
-    runId: run.id,
-    startedAt: run.startedAt || run.createdAt,
-    plan: run.plan,
-    tasks: run.tasks.map((t) => ({ id: t.id, role: t.role, title: t.title, status: t.status === 'running' || t.status === 'pending' ? 'stopped' : t.status, text: t.text || '', error: t.error || null, transcript: t.transcript || [], attempts: t.attempts || [], usage: null })),
-    board: run.threads || emptyBoardState(),
-    budget: { cap: run.usage?.cap || run.budget || {}, spent: run.usage?.spent || {} },
-    budgetAsked: false,
-  };
-}
-
-/** Can this record be picked up again? Not one that completed, not one still being run by a live client. */
-export function isResumable(run) {
-  if (!run?.plan?.tasks?.length) return false;
-  if (RESUMABLE_RUN_STATUSES.includes(run.status)) return true;
-  return !!run.stale && LIVE_RUN_STATUSES.includes(run.status); // its client went away mid-run
-}
-
-/**
- * The run's spend against its cap, as a board shows it: the record's last `run.usage` (or
- * nothing spent yet) with `ms` measured LIVE for a run still going — the stored figure is as
- * of the last task's end, and a board read "0 s" through a ten-minute research task.
- */
-export function spendOf(run, { now = Date.now() } = {}) {
-  const cap = run?.usage?.cap || run?.budget || null;
-  if (!cap || !Object.keys(cap).length) return null;
-  const spent = { tokens: 0, calls: 0, usd: 0, ms: 0, ...(run?.usage?.spent || {}) };
-  // The clock runs while the client is writing, and STOPS where it stopped: a run whose
-  // record says `running` because its client died (or its end never landed) is not still
-  // spending — it read "18m13s / 5m00s" and counting for a member that had finished.
-  const st = runState(run, { now });
-  if (LIVE_RUN_STATUSES.includes(run?.status) && run?.startedAt) spent.ms = Math.max(spent.ms || 0, (st.key === 'stalled' ? Number(run.lastEventAt) || now : now) - run.startedAt);
-  const pct = cap.tokens ? Math.min(100, Math.round(((spent.tokens || 0) / cap.tokens) * 100)) : cap.ms ? Math.min(100, Math.round(((spent.ms || 0) / cap.ms) * 100)) : null;
-  const over = BUDGET_KEYS.filter((k) => cap[k] && (spent[k] || 0) >= cap[k]);
-  return { cap, spent, pct, exhausted: run?.usage?.exhausted || over[0] || null, over };
-}
-const BUDGET_KEYS = ['tokens', 'calls', 'usd', 'ms'];
-
-export const STALLED_AFTER_MS = 2 * 60_000;
-
-/**
- * What a run IS right now, for a person: the record's status read against the clock. A
- * record that says `running` with no event for minutes is STALLED — its client stopped
- * writing (died, or its end never landed) — not running. `{ key, label, tone, detail }`;
- * `tone` is the chip: on · warn · ok · err · muted.
- */
-export function runState(run, { now = Date.now(), stalledAfterMs = STALLED_AFTER_MS } = {}) {
-  const s = String(run?.status || 'planning');
-  const quiet = Number.isFinite(run?.quietMs) ? run.quietMs : Math.max(0, now - (Number(run?.lastEventAt) || now));
-  const agoText = (ms) => { const sec = Math.round(ms / 1000); return sec < 60 ? `${sec} s` : sec < 3600 ? `${Math.round(sec / 60)} min` : `${Math.round(sec / 3600)} h`; };
-  if (s === 'waiting') return { key: 'waiting', label: 'waiting on you', tone: 'warn', detail: '' };
-  if (LIVE_RUN_STATUSES.includes(s)) {
-    if (run?.stale === true || quiet > stalledAfterMs) return { key: 'stalled', label: 'stalled', tone: 'err', detail: `no events for ${agoText(quiet)} — its client stopped writing; Resume here picks it up from the record` };
-    return { key: 'running', label: s === 'merging' ? 'merging' : s === 'planning' ? 'planning' : 'running', tone: 'on', detail: `last event ${agoText(quiet)} ago` };
-  }
-  if (s === 'completed') return { key: 'done', label: 'done', tone: 'ok', detail: '' };
-  if (s === 'partial') return { key: 'partial', label: 'done with failures', tone: 'warn', detail: 'a member failed; the rest merged' };
-  if (s === 'answered') return { key: 'answered', label: 'answered — resume to continue', tone: 'warn', detail: '' };
-  if (s === 'over-budget') return { key: 'over-budget', label: 'over budget', tone: 'err', detail: 'stopped with what it had' };
-  if (s === 'stopped') return { key: 'stopped', label: 'stopped', tone: 'muted', detail: '' };
-  if (s === 'failed') return { key: 'failed', label: 'failed', tone: 'err', detail: '' };
-  return { key: s, label: s, tone: 'muted', detail: '' };
-}
-
-/**
- * Earlier runs whose work a new run should read before repeating it (§12.2.6, the librarian's
- * first step): the same team (or any, when `team` is empty), a request that says the same
- * thing (word overlap ≥ `minSimilarity`), findings on the record, not the run itself, newest
- * first. `runs` is the store's list (`findings` is a count there). Returns
- * `[{ id, at, similarity, findings }]`; the host fetches the record for the findings.
- */
-export function priorWorkFor(runs, { team = '', request = '', excludeId = null, minSimilarity = 0.6, maxAgeMs = 7 * 24 * 3600_000, now = Date.now(), limit = 3 } = {}) {
-  const words = (t) => new Set(String(t || '').toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, ' ').split(/\s+/).filter((w) => w.length > 2));
-  const want = words(request);
-  if (!want.size) return [];
-  const sim = (t) => { const have = words(t); if (!have.size) return 0; let hit = 0; for (const w of want) if (have.has(w)) hit += 1; return hit / Math.max(want.size, have.size); };
-  return (runs || [])
-    .filter((r) => r && r.id && r.id !== excludeId && (!team || r.team === team) && !LIVE_RUN_STATUSES.includes(r.status) && (Number(r.findings) || (Array.isArray(r.board) ? r.board.length : 0)) > 0 && now - (Number(r.createdAt) || 0) <= maxAgeMs)
-    .map((r) => ({ id: r.id, at: r.createdAt, similarity: Math.round(sim(r.request) * 100) / 100, findings: Number(r.findings) || (Array.isArray(r.board) ? r.board.length : 0), status: r.status }))
-    .filter((r) => r.similarity >= minSimilarity)
-    .sort((a, b) => b.similarity - a.similarity || b.at - a.at)
-    .slice(0, limit);
-}
-
-const secs = (ms) => { const s = Math.max(0, Math.round((Number(ms) || 0) / 1000)); return s >= 60 ? `${Math.floor(s / 60)}m${String(s % 60).padStart(2, '0')}s` : `${s}s`; };
-const num = (n) => (Number(n) || 0).toLocaleString('en-US');
-
-/** One line: `1,240 / 40,000 tokens · 3 / 20 calls · 2m10s / 15m00s`. Only the capped dimensions. */
-export function describeSpend(spend) {
-  if (!spend?.cap) return '';
-  const { cap, spent } = spend;
-  const over = (k) => ((spend.over || []).includes(k) ? ' (over)' : '');
-  return [
-    cap.tokens ? `${num(spent.tokens)} / ${num(cap.tokens)} tokens${over('tokens')}` : '',
-    cap.calls ? `${num(spent.calls)} / ${num(cap.calls)} calls${over('calls')}` : '',
-    cap.usd ? `$${(Number(spent.usd) || 0).toFixed(2)} / $${Number(cap.usd).toFixed(2)}${over('usd')}` : '',
-    cap.ms ? `${secs(spent.ms)} / ${secs(cap.ms)}${over('ms')}` : '',
-  ].filter(Boolean).join(' · ');
-}
+import{foldBoard as I,emptyBoardState as g}from"./team-board.js";const p=Object.freeze(["planning","running","merging","waiting"]),A=Object.freeze(["waiting","stopped","failed","partial","over-budget","answered"]),w=2e4;function x({id:e,client:a="",now:n=Date.now()}={}){return{id:e,client:String(a||"").slice(0,40),createdAt:n,lastEventAt:n,status:"planning",team:"",request:"",roles:[],plan:null,tasks:[],jobs:[],board:[],threads:g(),checkpoint:null,proposal:null,usage:null,stopRequested:null,startedAt:null,endedAt:null}}const r=(e,a)=>e.tasks.find(n=>n.id===a);function S(e,a){const n=String(a?.type||""),t=a?.payload&&typeof a.payload=="object"?a.payload:a||{},d=Number(a?.at)||Date.now();switch(e.lastEventAt=d,n){case"run.started":case"run.resumed":e.team=t.team||e.team,e.request=t.request??e.request,e.budget=t.budget||e.budget,e.roles=Array.isArray(t.roles)?t.roles:e.roles,e.status="planning",e.startedAt=e.startedAt||d,n==="run.resumed"&&(e.endedAt=null,e.checkpoint=null,e.resumedAt=d);break;case"plan.ready":e.plan={by:t.by||"fixed",tasks:Array.isArray(t.tasks)?t.tasks:[]},e.tasks=e.plan.tasks.map(s=>({...r(e,s.id)||{},id:s.id,role:s.role,title:s.title,status:r(e,s.id)?.status==="ok"?"ok":s.parent&&!s.role?"unassigned":"pending",findings:r(e,s.id)?.findings||0,...s.parent?{parent:s.parent,requestedBy:s.requestedBy||null}:{},...s.grants?{grants:s.grants,why:s.why||""}:{},...s.kind?{kind:s.kind}:{}})),e.status="running";break;case"task.requested":if(t.taskId&&!r(e,t.taskId)){const s={id:t.taskId,role:null,title:t.title||t.taskId,prompt:t.prompt||"",dependsOn:Array.isArray(t.dependsOn)?t.dependsOn:[],parent:t.parent||null,requestedBy:t.by||null,needs:t.needs||null,depth:t.depth||1,wait:t.wait!==!1};e.plan&&(e.plan.tasks=[...e.plan.tasks||[],s]),e.tasks.push({id:s.id,role:null,title:s.title,status:"requested",findings:0,parent:s.parent,requestedBy:s.requestedBy,needs:s.needs,requestedAt:d})}break;case"task.added":if(t.taskId&&!r(e,t.taskId)){const s={id:t.taskId,role:t.role||null,title:t.title||t.taskId,dependsOn:Array.isArray(t.dependsOn)?t.dependsOn:[],...t.kind?{kind:t.kind}:{}};e.plan&&(e.plan.tasks=[...e.plan.tasks||[],s]),e.tasks.push({id:s.id,role:s.role,title:s.title,status:"pending",findings:0,...t.kind?{kind:t.kind}:{}})}break;case"task.taken":{const s=r(e,t.taskId);s&&(s.role=t.role,s.status="pending",s.takenBy={by:t.by||"fit",role:t.role,fit:t.fit??null,reasons:t.reasons||[],agentId:t.agentId||null,engine:t.engine||null,why:t.why||"",at:d});const o=e.plan?.tasks?.find(l=>l.id===t.taskId);o&&(o.role=t.role);break}case"task.posted":{const s=r(e,t.taskId);s&&(s.job=t.job||null),t.job&&!e.jobs.some(o=>o.id===t.job.id)&&e.jobs.push({...t.job,taskId:t.taskId,at:d});break}case"task.proposed":{const s=r(e,t.taskId);s&&(s.proposal={agent:t.agent||null,threadId:t.threadId||null,postId:t.postId||null,why:t.why||"",at:d});break}case"task.unassigned":{const s=r(e,t.taskId);s&&(s.status="unassigned",s.error=t.why||null,s.endedAt=d);const o=e.jobs.find(l=>l.taskId===t.taskId);o&&(o.status="failed");break}case"task.nudged":{const s=r(e,t.taskId);s&&(s.nudged=[...s.nudged||[],{grants:t.grants||[],at:d}]);break}case"run.role-added":if(t.role?.id&&!e.roles.includes(t.role.id)){e.roles.push(t.role.id),e.recruited=[...e.recruited||[],{...t.role,jobId:t.jobId||null,at:d}];const s=e.jobs.find(o=>o.id===t.jobId);s&&(s.status="recruited",s.recruited={agentId:t.role.agent||t.role.id,engine:t.role.engine||null,at:d})}break;case"task.started":{let s=r(e,t.taskId);!s&&t.taskId&&(s={id:t.taskId,role:t.role||null,title:t.title||t.taskId,status:"pending",findings:0,...t.taskId==="merge"?{kind:"merge"}:{}},e.tasks.push(s)),s&&(s.status="running",s.startedAt=d,s.error=null),e.status="running";break}case"task.model":{const s=r(e,t.taskId);s&&(s.model=t.model,s.attempts=[...s.attempts||[],{model:t.model,...t.label?{label:t.label}:{},at:d,attempt:t.attempt}]);break}case"task.routed":{const o=r(e,t.taskId)?.attempts?.at?.(-1);o&&t.engine&&(o.attempt==null||o.attempt===t.attempt)&&(o.engine=t.engine);break}case"task.step":{const s=r(e,t.taskId);s&&Array.isArray(t.steps)&&(s.transcript=[...s.transcript||[],...t.steps]);break}case"task.handoff":{const s=r(e,t.taskId);s&&(s.model=t.to,s.handoffs=[...s.handoffs||[],{from:t.from,to:t.to,by:t.by,reason:t.reason,at:d}]);break}case"task.tool":{const s=r(e,t.taskId);s&&(s.tools=(s.tools||0)+1);break}case"task.delta":{const s=r(e,t.taskId);s&&(s.text=String(t.text||"").slice(0,w));break}case"task.finding":if(t.finding&&t.finding.text){e.board.push({...t.finding,at:d});const s=r(e,t.taskId);s&&(s.findings+=1)}break;case"task.waiting":{const s=r(e,t.taskId);s&&(s.status="waiting",s.waitingOn=t.threadId);break}case"task.done":case"task.failed":{const s=r(e,t.taskId);s&&(s.status=t.status||(n==="task.done"?"ok":"failed"),s.error=t.error||null,s.ms=t.ms,s.endedAt=d);const o=e.jobs.find(l=>l.taskId===t.taskId);o&&(o.status=n==="task.done"?"done":"failed",o.endedAt=d);break}case"run.merging":e.status="merging";break;case"run.waiting":e.status="running";break;case"run.usage":e.usage=t.usage||e.usage;break;case"run.done":e.status=t.status||"completed",e.usage=t.usage||e.usage,e.proposal=t.proposal??e.proposal,e.endedAt=d,t.checkpoint&&(e.checkpoint=t.checkpoint);break;case"run.stop-requested":e.stopRequested=d;break;case"board.thread":case"board.post":case"board.decision":case"board.thread-status":case"board.thread-removed":e.threads=I(e.threads||g(),a),n==="board.thread-status"&&t.status!=="waiting"&&e.status==="waiting"&&!(e.threads.threads||[]).some(s=>s.kind==="ask"&&s.status==="waiting")&&(e.status="answered");break;default:break}return e}function E(e,a,n={}){const t=x({id:e,...n});for(const d of a||[])S(t,d);return t}function N(e){return e?.plan?.tasks?.length?e.checkpoint?.plan?.tasks?.length?{...e.checkpoint,board:e.threads&&e.threads.threads?.length>=(e.checkpoint.board?.threads?.length||0)?e.threads:e.checkpoint.board}:{runId:e.id,startedAt:e.startedAt||e.createdAt,plan:e.plan,tasks:e.tasks.map(a=>({id:a.id,role:a.role,title:a.title,status:a.status==="running"||a.status==="pending"?"stopped":a.status,text:a.text||"",error:a.error||null,transcript:a.transcript||[],attempts:a.attempts||[],usage:null})),board:e.threads||g(),budget:{cap:e.usage?.cap||e.budget||{},spent:e.usage?.spent||{}},budgetAsked:!1}:null}function v(e){return e?.plan?.tasks?.length?A.includes(e.status)?!0:!!e.stale&&p.includes(e.status):!1}function O(e,{now:a=Date.now()}={}){const n=e?.usage?.cap||e?.budget||null;if(!n||!Object.keys(n).length)return null;const t={tokens:0,calls:0,usd:0,ms:0,...e?.usage?.spent||{}},d=q(e,{now:a});p.includes(e?.status)&&e?.startedAt&&(t.ms=Math.max(t.ms||0,(d.key==="stalled"&&Number(e.lastEventAt)||a)-e.startedAt));const s=n.tokens?Math.min(100,Math.round((t.tokens||0)/n.tokens*100)):n.ms?Math.min(100,Math.round((t.ms||0)/n.ms*100)):null,o=j.filter(l=>n[l]&&(t[l]||0)>=n[l]);return{cap:n,spent:t,pct:s,exhausted:e?.usage?.exhausted||o[0]||null,over:o}}const j=["tokens","calls","usd","ms"],$=2*6e4;function q(e,{now:a=Date.now(),stalledAfterMs:n=$}={}){const t=String(e?.status||"planning"),d=Number.isFinite(e?.quietMs)?e.quietMs:Math.max(0,a-(Number(e?.lastEventAt)||a)),s=o=>{const l=Math.round(o/1e3);return l<60?`${l} s`:l<3600?`${Math.round(l/60)} min`:`${Math.round(l/3600)} h`};return t==="waiting"?{key:"waiting",label:"waiting on you",tone:"warn",detail:""}:p.includes(t)?e?.stale===!0||d>n?{key:"stalled",label:"stalled",tone:"err",detail:`no events for ${s(d)} — its client stopped writing; Resume here picks it up from the record`}:{key:"running",label:t==="merging"?"merging":t==="planning"?"planning":"running",tone:"on",detail:`last event ${s(d)} ago`}:t==="completed"?{key:"done",label:"done",tone:"ok",detail:""}:t==="partial"?{key:"partial",label:"done with failures",tone:"warn",detail:"a member failed; the rest merged"}:t==="answered"?{key:"answered",label:"answered — resume to continue",tone:"warn",detail:""}:t==="over-budget"?{key:"over-budget",label:"over budget",tone:"err",detail:"stopped with what it had"}:t==="stopped"?{key:"stopped",label:"stopped",tone:"muted",detail:""}:t==="failed"?{key:"failed",label:"failed",tone:"err",detail:""}:{key:t,label:t,tone:"muted",detail:""}}function _(e,{team:a="",request:n="",excludeId:t=null,minSimilarity:d=.6,maxAgeMs:s=168*36e5,now:o=Date.now(),limit:l=3}={}){const f=i=>new Set(String(i||"").toLowerCase().replace(/[^\p{L}\p{N}\s]/gu," ").split(/\s+/).filter(c=>c.length>2)),u=f(n);if(!u.size)return[];const h=i=>{const c=f(i);if(!c.size)return 0;let b=0;for(const y of u)c.has(y)&&(b+=1);return b/Math.max(u.size,c.size)};return(e||[]).filter(i=>i&&i.id&&i.id!==t&&(!a||i.team===a)&&!p.includes(i.status)&&(Number(i.findings)||(Array.isArray(i.board)?i.board.length:0))>0&&o-(Number(i.createdAt)||0)<=s).map(i=>({id:i.id,at:i.createdAt,similarity:Math.round(h(i.request)*100)/100,findings:Number(i.findings)||(Array.isArray(i.board)?i.board.length:0),status:i.status})).filter(i=>i.similarity>=d).sort((i,c)=>c.similarity-i.similarity||c.at-i.at).slice(0,l)}const m=e=>{const a=Math.max(0,Math.round((Number(e)||0)/1e3));return a>=60?`${Math.floor(a/60)}m${String(a%60).padStart(2,"0")}s`:`${a}s`},k=e=>(Number(e)||0).toLocaleString("en-US");function B(e){if(!e?.cap)return"";const{cap:a,spent:n}=e,t=d=>(e.over||[]).includes(d)?" (over)":"";return[a.tokens?`${k(n.tokens)} / ${k(a.tokens)} tokens${t("tokens")}`:"",a.calls?`${k(n.calls)} / ${k(a.calls)} calls${t("calls")}`:"",a.usd?`$${(Number(n.usd)||0).toFixed(2)} / $${Number(a.usd).toFixed(2)}${t("usd")}`:"",a.ms?`${m(n.ms)} / ${m(a.ms)}${t("ms")}`:""].filter(Boolean).join(" · ")}export{p as LIVE_RUN_STATUSES,A as RESUMABLE_RUN_STATUSES,$ as STALLED_AFTER_MS,N as checkpointFrom,B as describeSpend,x as emptyRun,S as foldRun,v as isResumable,_ as priorWorkFor,E as runFromEvents,q as runState,O as spendOf};