trantor 0.17.20 → 0.17.21

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + context-handoff for independent AI coding agents (Claude, Codex, Gemini, …)",
-    "version": "0.17.20"
+    "version": "0.17.21"
   },
   "plugins": [
     {
       "name": "trantor",
       "source": "./",
       "description": "The hub-world for AI agent crews. Say \"fire up the crew\" and Claude becomes the architect: a plan-aware Advisor routes the work (solo / cheap inline calls / live crew of Codex, Gemini, Kimi & DeepSeek in their own terminal windows), a Kanban/flow command center with a testing gate tracks it, and an economics brain (Scrooge) keeps the receipts. Includes the relay MCP, a SessionStart auto-discovery hook, and a PreCompact context-handoff so a fresh session can take over a full window instead of compacting.",
-      "version": "0.17.20",
+      "version": "0.17.21",
       "author": {
         "name": "Sasha Bogojevic"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.20",
+  "version": "0.17.21",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/hub.mjs

@@ -228,7 +228,7 @@ function derivePhases(tasks) {
   const phases = [...byPhase.entries()].map(([key, cards]) => {
     const counts = { todo:0, doing:0, testing:0, failed:0, done:0, blocked:0 };
     for (const c of cards) counts[c.status] = (counts[c.status] || 0) + 1;
-    const node = (c) => ({ id: c.id, title: c.title, assignee: c.assignee || "", agent: agentBrand(c.assignee), model: c.model || "", status: c.status, difficulty: c.difficulty || "", ts: c.ts || 0, updated: c.updated || c.ts || 0, deps: Array.isArray(c.deps) ? c.deps : [] });
+    const node = (c) => ({ id: c.id, title: c.title, assignee: c.assignee || "", agent: agentBrand(c.assignee), model: c.model || "", status: c.status, difficulty: c.difficulty || "", ts: c.ts || 0, updated: c.updated || c.ts || 0, deps: Array.isArray(c.deps) ? c.deps : [], costKind: c.costKind || "", costUsd: (typeof c.costUsd === "number") ? c.costUsd : null, source: c.source || "" });
     const crew = cards.filter(c => !isOrchAssignee(c.assignee)).map(node);
     const orchestrators = cards.filter(c => isOrchAssignee(c.assignee)).map(node);
     return {
@@ -526,6 +526,39 @@ const server = http.createServer(async (req, res) => {
         // back-compat: `scrooge` is the window older dashboards read (honor ?hours= if passed)
         out.scrooge = q.hours ? rollup(rows.filter(c => c.ts >= nowS - Number(q.hours) * 3600)) : out.windows["24h"];
       } catch {}
+      // --- card-based costs (FLOW v2): the orchestrator's OWN work, by costKind ---
+      // NOTIONAL (Claude sub-agents/orchestrator — plan-covered) is kept STRICTLY SEPARATE from REAL
+      // spend (Scrooge). We never sum them into one headline — that would imply we paid for plan-covered
+      // tokens. Crew is subscription (no per-task $). Card ts is in ms (the scrooge ledger is in seconds).
+      try {
+        const WINDOWS_MS = { "24h": 864e5, week: 7 * 864e5, month: 30 * 864e5, quarter: 90 * 864e5, year: 365 * 864e5 };
+        const costCards = state.tasks.filter(t => t.costKind || t.costUsd != null);
+        const rollupCards = cards => {
+          const byKind = {};
+          for (const t of cards) {
+            const k = t.costKind || "other";
+            const e = byKind[k] ||= { count: 0, usd: 0, tokens_in: 0, tokens_out: 0, cache_read: 0, cache_write: 0, by_model: {}, hasUsd: false };
+            e.count++;
+            if (typeof t.costUsd === "number") { e.usd += t.costUsd; e.hasUsd = true; }
+            if (t.tokens) { e.tokens_in += t.tokens.input || 0; e.tokens_out += t.tokens.output || 0; e.cache_read += t.tokens.cacheRead || 0; e.cache_write += t.tokens.cacheWrite || 0; }
+            if (t.model) { const m = e.by_model[t.model] ||= { count: 0, usd: 0 }; m.count++; m.usd += t.costUsd || 0; }
+          }
+          for (const e of Object.values(byKind)) { e.usd = +e.usd.toFixed(4); e.usd = e.hasUsd ? e.usd : null; }
+          return byKind;
+        };
+        out.costKinds = {};
+        const nowMs = now();
+        for (const [k, ms] of Object.entries(WINDOWS_MS)) out.costKinds[k] = rollupCards(costCards.filter(t => (t.ts || 0) >= nowMs - ms));
+        out.costKinds.lifetime = rollupCards(costCards);
+        // per-project notional totals (subagent+orchestrator) so the dashboard can scope it like reliability
+        const perProject = {};
+        for (const t of costCards) {
+          if (typeof t.costUsd !== "number") continue;
+          if (t.costKind !== "subagent-notional" && t.costKind !== "orchestrator-notional") continue;
+          perProject[canon(t.project)] = +((perProject[canon(t.project)] || 0) + t.costUsd).toFixed(4);
+        }
+        out.notionalByProject = perProject;
+      } catch {}
       return json(res, 200, out);
     }
     if (req.method === "GET" && P === "/lessons") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.20",
+  "version": "0.17.21",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"

package/ui.html

@@ -189,6 +189,7 @@ main:not(.learn-open) .learn-body{display:none}
 .gnode.failed .gnbox,.gnode.blocked .gnbox{stroke:var(--red)}
 .gntext{fill:#eaf1fa;font-size:11px;font-family:ui-sans-serif,system-ui;pointer-events:none}
 .gnsub{fill:var(--mut);font-size:9.5px;font-family:ui-sans-serif,system-ui;pointer-events:none}
+.gncost{fill:var(--blu);font-size:9px;font-family:ui-sans-serif,system-ui;text-anchor:end;pointer-events:none}
 .pfband{fill:#0c1320;opacity:.45}
 .pfband.alt{fill:#0e1626;opacity:.55}
 .pfbandtop{opacity:.12}
@@ -318,8 +319,16 @@ let ECON=null;
 const ECON_WINS=[['24h','last 24h'],['week','last week'],['month','last month'],['quarter','last quarter'],['year','last year']];
 let econWin=localStorage.getItem('abEconWin')||'24h';
 const econSaved=x=>x?(x.saved_usd!=null?(+x.saved_usd):Math.max(0,(x.opus_equiv_usd||0)-(x.cost_usd||0))):0;
+// notional (plan-covered) cost of the orchestrator's OWN Claude work for a window — subagent +
+// orchestrator costKinds, summed ONLY with each other (never with real Scrooge spend).
+function econNotional(win){
+  const ck=ECON&&ECON.costKinds&&ECON.costKinds[win]; if(!ck)return 0;
+  return ((ck['subagent-notional']&&ck['subagent-notional'].usd)||0)+((ck['orchestrator-notional']&&ck['orchestrator-notional'].usd)||0);
+}
 function renderEcon(){
-  if(!ECON||!ECON.lifetime||!ECON.lifetime.calls)return;
+  const lifeCalls=(ECON&&ECON.lifetime&&ECON.lifetime.calls)||0;
+  const notionalLife=ECON?econNotional('lifetime'):0;
+  if(!ECON||(!lifeCalls&&!(notionalLife>0)))return;     // show once we have EITHER real savings OR notional CC cost
   const el=$('#econ'); el.style.display='';
   // lifetime running total is the fixed headline; the dropdown picks the comparison window.
   if(!el.dataset.built){
@@ -327,7 +336,8 @@ function renderEcon(){
       `<span style="opacity:.55"> · lifetime · </span>`+
       `<select id="econsel" title="comparison window" style="background:#1a2030;color:inherit;border:1px solid rgba(255,255,255,.18);border-radius:4px;font:inherit;font-size:11px;padding:1px 3px;cursor:pointer;outline:none">`+
         ECON_WINS.map(([k,l])=>`<option value="${k}">${l}</option>`).join('')+`</select>`+
-      `<span style="opacity:.85" id="econwinval"></span>`;
+      `<span style="opacity:.85" id="econwinval"></span>`+
+      `<span id="econnotional" title="Claude's OWN sub-agent work (Agent/Workflow/ultracode) at API rates — plan-covered on a subscription, NOT real spend. Shown separately so it's never confused with the real Scrooge \$ saved." style="opacity:.9;margin-left:2px"></span>`;
     const sel=$('#econsel'); sel.value=econWin;
     sel.onchange=()=>{econWin=sel.value; localStorage.setItem('abEconWin',econWin); renderEcon();};
     el.dataset.built='1';
@@ -335,6 +345,11 @@ function renderEcon(){
   const w=(ECON.windows&&ECON.windows[econWin])||ECON.scrooge, wc=w?w.calls:0;
   $('#econlife').textContent='$'+econSaved(ECON.lifetime).toFixed(2);
   $('#econwinval').textContent=' $'+econSaved(w).toFixed(2)+' ('+wc+' call'+(wc===1?'':'s')+')';
+  // separate notional line — distinct icon + "notional" wording, never added to the savings number
+  const nEl=$('#econnotional');
+  if(nEl) nEl.innerHTML = notionalLife>0
+    ? `<span style="opacity:.5"> · </span>🤖 CC sub-agents <b style="color:var(--blu)">$${notionalLife.toFixed(2)}</b> <span style="opacity:.7">notional</span>`
+    : '';
   const sel=$('#econsel'); if(sel)sel.value=econWin;
 }
 async function econ(){
@@ -395,14 +410,16 @@ function flowHTML(pt, proj){
   const maxColCount = Math.max(1, ...layouts.flatMap(L => L.cols.map(c => c.length)));
   const Y0 = MT + stackH(maxColCount)/2;               // shared horizontal spine midline
   const totalH = MT + stackH(maxColCount) + MB;
-  const gnode = (x, y, title, status, id, orch, agent) => {
+  const gnode = (x, y, title, status, id, orch, agent, cost) => {
     const stripe = SCOL[status] || '#3a4458';
+    const c = (typeof cost === 'number') ? (cost < 0.005 ? '$' + cost.toFixed(4) : '$' + cost.toFixed(2)) : '';
     return `<g class="gnode ${status}${orch?' orch':''}"${id?` data-id="${id}"`:''}>`
       + `<rect class="gnbox" x="${x}" y="${y}" width="${NW}" height="${NH}" rx="8"/>`
       + `<rect x="${x}" y="${y}" width="4" height="${NH}" rx="2" fill="${stripe}"/>`
       + `<text class="gntext" x="${x+11}" y="${y+(agent?15:23)}">${esc(title.slice(0,24))}${title.length>24?'…':''}</text>`
       + (agent?`<text class="gnsub" x="${x+11}" y="${y+29}">@${esc(agent)}</text>`:'')
-      + `<title>${esc(title)}${agent?' · @'+esc(agent):''} — ${status}</title></g>`;
+      + (c?`<text class="gncost" x="${x+NW-8}" y="${y+(agent?15:23)}">${c}</text>`:'')
+      + `<title>${esc(title)}${agent?' · @'+esc(agent):''}${c?` · ${c} notional`:''} — ${status}</title></g>`;
   };
   const gedge = (x1,y1,x2,y2,done) => { const mx=(x1+x2)/2;
     return `<path class="gedge${done?' done':''}" d="M${x1},${y1} C${mx},${y1} ${mx},${y2} ${x2},${y2}"/>`; };
@@ -435,7 +452,7 @@ function flowHTML(pt, proj){
       const p = pos[c.id], parents = parentsOf(c);
       if (parents.length) for (const pid of parents){ const pp = pos[pid]; if (pp) svg += gedge(pp.x+NW, pp.y+NH/2, p.x, p.y+NH/2, byId[pid].status==='done'); }
       else svg += gedge(planX+NW, planY+NH/2, p.x, p.y+NH/2, ph.status==='done');   // root → plan
-      svg += gnode(p.x, p.y, (c.id?'#'+c.id+' ':'')+c.title, c.status, c.synthetic?null:c.id, !!c._orch, c.agent||'');
+      svg += gnode(p.x, p.y, (c.id?'#'+c.id+' ':'')+c.title, c.status, c.synthetic?null:c.id, !!c._orch, c.agent||'', c.costUsd);
       if (!hasChild(c)) svg += gedge(p.x+NW, p.y+NH/2, intX, intY+NH/2, c.status==='done');   // leaf → integrate
     }
     svg += gnode(intX, intY, '◆ integrate', ph.status, null, true, '');