@chatpanel/events 0.91.0 → 0.91.1

package/index.js

@@ -197,7 +197,7 @@ export { fixedPlan, parsePlan, plannerPrompt, waves, breakCycles, TEAM_PLAN_SCHE
 export { createBoard, parseFindings, boardText, findingsInstruction, toBriefClaims, FINDINGS_SCHEMA, FINDING_KINDS, THREAD_KINDS, THREAD_STATUSES, POST_KINDS, POST_STATUSES, ASK_TYPES, emptyBoardState, foldBoard, findingsOf } from './team-board.js';
 export { boardToolProvider, boardToolSpec, createAnswerBox, withBoardTool, BOARD_TOOL_NAME, DEFAULT_ASK_TIMEOUT_MS } from './board-tool.js';
 export { createRunCache, withRunCache } from './team-cache.js';
-export { emptyRun, foldRun, runFromEvents, checkpointFrom, isResumable, LIVE_RUN_STATUSES, RESUMABLE_RUN_STATUSES } from './team-record.js';
+export { emptyRun, foldRun, runFromEvents, checkpointFrom, isResumable, LIVE_RUN_STATUSES, RESUMABLE_RUN_STATUSES , spendOf, describeSpend } from './team-record.js';
 export { validateProject, normalizeProject, defineProject, canTransition as canProjectTransition, blankProject, projectFromForm, emptyProjectRecord, foldProject, projectProgress, ProjectError, PROJECT_STATUSES, PROJECT_ID_RE } from './project.js';
 // Job POSTINGS (F8 §12) — `jobs.js` is the scheduler and keeps `defineJob`; a posting is a JobPost here.
 export { validateJob as validateJobPost, normalizeJob as normalizeJobPost, defineJob as defineJobPost, canTransition as canJobPostTransition, applyAll, jobToRole, readyJobs, blankJob as blankJobPost, jobFromForm as jobPostFromForm, JobError as JobPostError, JOB_STATUSES as JOB_POST_STATUSES, JOB_ID_RE as JOB_POST_ID_RE } from './job.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatpanel/events",
-  "version": "0.91.0",
+  "version": "0.91.1",
   "description": "The canonical ChatPanel event-log and capability contracts \u2014 typed durable facts, clock-free deterministic linearization, schema upcasting, and the invariants the replay harness asserts. Pure, dependency-free ESM shared by the ChatPanel extension, gateway and bridge.",
   "type": "module",
   "main": "index.js",

package/team-record.js

@@ -122,3 +122,32 @@ export function isResumable(run) {
   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 || {}) };
+  if (LIVE_RUN_STATUSES.includes(run?.status) && run?.startedAt) spent.ms = Math.max(spent.ms || 0, 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;
+  return { cap, spent, pct, exhausted: run?.usage?.exhausted || null };
+}
+
+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;
+  return [
+    cap.tokens ? `${num(spent.tokens)} / ${num(cap.tokens)} tokens` : '',
+    cap.calls ? `${num(spent.calls)} / ${num(cap.calls)} calls` : '',
+    cap.usd ? `$${(Number(spent.usd) || 0).toFixed(2)} / $${Number(cap.usd).toFixed(2)}` : '',
+    cap.ms ? `${secs(spent.ms)} / ${secs(cap.ms)}` : '',
+  ].filter(Boolean).join(' · ');
+}