@duckmind/dm-windows-x64 0.60.4 → 0.60.8

package/extensions/dm-usage/index.js

@@ -1,9 +1,1294 @@
-import{DynamicBorder as bJ}from"@duckmind/dm-coding-agent";import{CancellableLoader as vJ,Container as xJ,Spacer as QJ,matchesKey as R,visibleWidth as C,truncateToWidth as _,wrapTextWithAnsi as ZJ}from"@duckmind/dm-tui";import{constants as d}from"node:fs";import{access as RJ,mkdir as IJ,readdir as pJ,readFile as kJ,writeFile as yJ}from"node:fs/promises";import{dirname as EJ,join as M}from"node:path";import{homedir as SJ}from"node:os";var m=26,gJ={"openai-codex":"duckmind-ultra",openrouter:"duckmind-standard"};function S(J){return gJ[J]??J}var c={label:"Sessions",width:9,getValue:(J)=>E(typeof J.sessions==="number"?J.sessions:J.sessions.size)},LJ={label:"Msgs",width:9,getValue:(J)=>E(J.messages)},W={label:"Cost",width:9,getValue:(J)=>N(J.cost)},p={label:"Tokens",width:9,getValue:(J)=>O(J.tokens.total)},hJ={label:"↑In",width:8,dimmed:!0,getValue:(J)=>O(J.tokens.input+J.tokens.cacheWrite)},lJ={label:"↓Out",width:8,dimmed:!0,getValue:(J)=>O(J.tokens.output)},uJ={label:"Cache",width:8,dimmed:!0,getValue:(J)=>O(J.tokens.cacheRead+J.tokens.cacheWrite)},dJ=[c,LJ,W,p,hJ,lJ,uJ],h=[{columns:dJ,minNameWidth:m},{columns:[c,LJ,W,p],minNameWidth:14,compact:!0},{columns:[c,W,p],minNameWidth:12,compact:!0},{columns:[W,p],minNameWidth:10,compact:!0},{columns:[W],minNameWidth:8,compact:!0}];function s(){return process.env.DM_CODING_AGENT_DIR||process.env.PI_CODING_AGENT_DIR||M(SJ(),".dm","agent")}function e(){return M(s(),"sessions")}function mJ(){return M(s(),"usage")}function A(){return M(mJ(),"state.json")}function UJ(){return M(s(),"settings.json")}async function _J(J,Q,Z){try{let $=await pJ(J,{withFileTypes:!0});for(let Y of $){if(Z?.aborted)return;let X=M(J,Y.name);if(Y.isDirectory())await _J(X,Q,Z);else if(Y.isFile()&&Y.name.endsWith(".jsonl"))Q.push(X)}}catch{}}async function cJ(J){let Q=[];return await _J(e(),Q,J),Q.sort(),Q}async function rJ(J,Q,Z){try{let $=await kJ(J,"utf8");if(Z?.aborted)return null;let Y=$.trim().split(`
-`),X=[],z="";for(let j=0;j<Y.length;j++){if(Z?.aborted)return null;if(j%500===0)await new Promise((V)=>setImmediate(V));let F=Y[j];if(!F.trim())continue;try{let V=JSON.parse(F);if(V.type==="session")z=V.id;else if(V.type==="message"&&V.message?.role==="assistant"){let q=V.message;if(q.usage&&q.provider&&q.model){let K=q.usage.input||0,G=q.usage.output||0,H=q.usage.cacheRead||0,B=q.usage.cacheWrite||0,P=V.timestamp?new Date(V.timestamp).getTime():0,D=q.timestamp||(Number.isNaN(P)?0:P),I=K+G+H+B,w=`${D}:${I}`;if(Q.has(w))continue;Q.add(w),X.push({provider:q.provider,model:q.model,cost:q.usage.cost?.total||0,input:K,output:G,cacheRead:H,cacheWrite:B,timestamp:D})}}}catch{}}return z?{sessionId:z,messages:X}:null}catch{return null}}function l(J,Q,Z){J.messages++,J.cost+=Q,J.tokens.total+=Z.total,J.tokens.input+=Z.input,J.tokens.output+=Z.output,J.tokens.cacheRead+=Z.cacheRead,J.tokens.cacheWrite+=Z.cacheWrite}function a(){return{total:0,input:0,output:0,cacheRead:0,cacheWrite:0}}function iJ(){return{sessions:new Set,messages:0,cost:0,tokens:a()}}function oJ(){return{sessions:new Set,messages:0,cost:0,tokens:a(),models:new Map}}function b(){return{providers:new Map,totals:{sessions:0,messages:0,cost:0,tokens:a()},dailySpend:new Map,insights:{insights:[]}}}function v(){return{messages:[],sessionCosts:new Map}}function nJ(){return{today:b(),thisWeek:b(),lastWeek:b(),allTime:b()}}function sJ(J,Q,Z,$){let Y=["allTime"];if(J>=Q)Y.push("today");if(J>=Z)Y.push("thisWeek");else if(J>=$)Y.push("lastWeek");return Y}function eJ(J,Q,Z,$,Y,X,z,j){let F={today:!1,thisWeek:!1,lastWeek:!1,allTime:!1};for(let V of Z){if(V.timestamp>0){let G=j.get(Q);if(!G)j.set(Q,{startMs:V.timestamp,endMs:V.timestamp});else{if(V.timestamp<G.startMs)G.startMs=V.timestamp;if(V.timestamp>G.endMs)G.endMs=V.timestamp}}let q=sJ(V.timestamp,$,Y,X),K={total:V.input+V.output+V.cacheWrite,input:V.input,output:V.output,cacheRead:V.cacheRead,cacheWrite:V.cacheWrite};for(let G of q){let H=J[G],B=H.providers.get(V.provider);if(!B)B=oJ(),H.providers.set(V.provider,B);let P=B.models.get(V.model);if(!P)P=iJ(),B.models.set(V.model,P);if(P.sessions.add(Q),l(P,V.cost,K),B.sessions.add(Q),l(B,V.cost,K),l(H.totals,V.cost,K),V.cost>0&&V.timestamp>0){let I=new Date(V.timestamp).toISOString().slice(0,10);H.dailySpend.set(I,(H.dailySpend.get(I)??0)+V.cost)}F[G]=!0;let D=z[G];D.messages.push({sessionId:Q,timestamp:V.timestamp,cost:V.cost,input:V.input,cacheRead:V.cacheRead,cacheWrite:V.cacheWrite}),D.sessionCosts.set(Q,(D.sessionCosts.get(Q)??0)+V.cost)}}if(F.today)J.today.totals.sessions++;if(F.thisWeek)J.thisWeek.totals.sessions++;if(F.lastWeek)J.lastWeek.totals.sessions++;if(F.allTime)J.allTime.totals.sessions++}async function NJ(J){let Q=new Date;Q.setHours(0,0,0,0);let Z=Q.getTime(),$=new Date,Y=$.getDay(),X=Y===0?6:Y-1;$.setDate($.getDate()-X),$.setHours(0,0,0,0);let z=$.getTime(),j=new Date($);j.setDate(j.getDate()-7);let F=j.getTime(),V=nJ(),q={today:v(),thisWeek:v(),lastWeek:v(),allTime:v()},K=new Map,G=await cJ(J);if(J?.aborted)return null;let H=new Set;for(let P of G){if(J?.aborted)return null;let D=await rJ(P,H,J);if(J?.aborted)return null;if(!D)continue;eJ(V,D.sessionId,D.messages,Z,z,F,q,K),await new Promise((I)=>setImmediate(I))}let B=new Set;for(let[P,D]of K)if(D.endMs-D.startMs>=AJ)B.add(P);for(let P of k)V[P].insights=DQ(q[P],B);return V}var y=["use","show","rotation","verify","path","reset","help"],aJ=["manual","quota","all"],CJ=["Usage: /usage [use|show|rotation|verify|path|reset|help]","use: select, activate, or remove managed account","show: managed account and usage summary","rotation: current rotation behavior","verify: runtime health checks","path: storage and settings locations","reset: clear manual or quota state"].join(`
-`);function tJ(J){let Q=J.trim();if(!Q)return{rest:""};let Z=Q.indexOf(" ");if(Z<0)return{subcommand:Q.toLowerCase(),rest:""};return{subcommand:Q.slice(0,Z).toLowerCase(),rest:Q.slice(Z+1).trim()}}function JQ(J){return y.some((Q)=>Q===J)}function QQ(J){if(J==="manual"||J==="quota"||J==="all")return J;return}function $J(J){return J.map((Q)=>({value:Q,label:Q}))}function ZQ(J){let Q=J.trimStart();if(!Q)return $J(y);let Z=Q.indexOf(" ");if(Z<0){let X=y.filter((z)=>z.startsWith(Q.toLowerCase()));return X.length>0?$J(X):null}let $=Q.slice(0,Z).toLowerCase(),Y=Q.slice(Z+1).toLowerCase();if($==="reset"){let X=aJ.filter((z)=>z.startsWith(Y));return X.length>0?X.map((z)=>({value:`reset ${z}`,label:z})):null}if($==="use"){let X=["clear","remove"].filter((z)=>z.startsWith(Y));return X.length>0?X.map((z)=>({value:`use ${z}`,label:z})):null}return null}function r(){return{version:1,removedAccountIds:[],accounts:[],updatedAt:new Date(0).toISOString()}}function L(J){return typeof J==="string"&&J.trim()?J.trim():void 0}function $Q(J){if(!J||typeof J!=="object")return;let Q=J,Z=L(Q.id),$=L(Q.provider)??Z;if(!Z||!$)return;let Y=L(Q.label)??S($),X=Q.source==="manual"?"manual":"session",z=L(Q.updatedAt)??new Date(0).toISOString(),j=typeof Q.quotaExhaustedUntil==="number"&&Number.isFinite(Q.quotaExhaustedUntil)?Q.quotaExhaustedUntil:void 0;return{id:Z,label:Y,provider:$,source:X,updatedAt:z,quotaExhaustedUntil:j}}function VQ(J){let Q=r();if(!J||typeof J!=="object")return Q;let Z=J,$=Array.isArray(Z.accounts)?Z.accounts.map($Q).filter((X)=>Boolean(X)):[],Y=Array.isArray(Z.removedAccountIds)?Z.removedAccountIds.map(L).filter((X)=>Boolean(X)):[];return{version:1,manualAccountId:L(Z.manualAccountId),removedAccountIds:Y,accounts:$,updatedAt:L(Z.updatedAt)??Q.updatedAt}}function YQ(J){return J&&typeof J==="object"&&"code"in J?String(J.code):void 0}async function t(){try{let J=await kJ(A(),"utf8");return{state:VQ(JSON.parse(J))}}catch(J){if(YQ(J)==="ENOENT")return{state:r()};return{state:r(),error:J instanceof Error?J.message:String(J)}}}async function g(J){J.version=1,J.updatedAt=new Date().toISOString(),J.removedAccountIds=[...new Set(J.removedAccountIds)].sort(),J.accounts=J.accounts.filter((Q)=>!J.removedAccountIds.includes(Q.id)).sort((Q,Z)=>Q.label.localeCompare(Z.label)),await IJ(EJ(A()),{recursive:!0}),await yJ(A(),`${JSON.stringify(J,null,2)}
-`,"utf8")}function U(J){return typeof J.quotaExhaustedUntil==="number"&&J.quotaExhaustedUntil>Date.now()}function i(J,Q){return J.allTime.providers.get(Q.provider)}function zQ(J,Q){let Z=new Date().toISOString(),$=new Map;for(let Y of Q.accounts)if(!Q.removedAccountIds.includes(Y.id))$.set(Y.id,Y);for(let Y of J.allTime.providers.keys()){if(Q.removedAccountIds.includes(Y)||$.has(Y))continue;$.set(Y,{id:Y,label:S(Y),provider:Y,source:"session",updatedAt:Z})}return Array.from($.values()).sort((Y,X)=>{let z=Q.manualAccountId;if(Y.id===z&&X.id!==z)return-1;if(X.id===z&&Y.id!==z)return 1;if(U(Y)!==U(X))return U(Y)?1:-1;let j=(i(J,X)?.cost??0)-(i(J,Y)?.cost??0);if(j!==0)return j;return Y.label.localeCompare(X.label)})}function MJ(J,Q){return J.find(($)=>$.id===Q.manualAccountId&&!U($))??J.find(($)=>!U($))}function VJ(J,Q){let Z=Q.trim().toLowerCase();return J.find(($)=>$.id.toLowerCase()===Z||$.provider.toLowerCase()===Z||$.label.toLowerCase()===Z)}function o(J,Q,Z){let $=i(Q,J),Y=[Z.manualAccountId===J.id?"manual":void 0,U(J)?"quota":void 0,J.source==="manual"?"manual-entry":void 0].filter(Boolean).join(", "),X=Y?` (${Y})`:"",z=$?N($.cost):N(0),j=$?E($.messages):"0",F=$?E($.sessions.size):"0";return`${J.label}${X} · id=${J.id} · spend=${z} · messages=${j} · sessions=${F}`}async function JJ(J){let Q=await NJ(J.signal);if(!Q)return J.ui.notify("Usage data unavailable or cancelled.","warning"),null;let{state:Z,error:$}=await t();if($)J.ui.notify(`dm-usage state unreadable; using empty state: ${$}`,"warning");return{data:Q,state:Z,accounts:zQ(Q,Z)}}function OJ(){return"No managed accounts found. Run /usage after at least one provider response, or use /usage use <provider-id> to create a local manual entry."}async function YJ(J,Q,Z){Q.state.manualAccountId=Z.id,Q.state.removedAccountIds=Q.state.removedAccountIds.filter(($)=>$!==Z.id),Q.state.accounts=Q.accounts.map(($)=>$.id===Z.id?{...$,updatedAt:new Date().toISOString()}:$),await g(Q.state),J.ui.notify(`dm-usage: now using ${Z.label} (${Z.id})`,"info")}async function zJ(J,Q){let Z=Boolean(Q.manualAccountId);Q.manualAccountId=void 0,await g(Q),J.ui.notify(`dm-usage: manual account ${Z?"cleared":"was not set"}`,"info")}async function XJ(J,Q,Z){if(Q.state.removedAccountIds=[...Q.state.removedAccountIds,Z.id],Q.state.manualAccountId===Z.id)Q.state.manualAccountId=void 0;Q.state.accounts=Q.accounts.filter(($)=>$.id!==Z.id),await g(Q.state),J.ui.notify(`dm-usage: removed local managed-account state for ${Z.label}; session data was not changed.`,"info")}async function TJ(J,Q){let Z=await JJ(J);if(!Z)return;if(Q==="clear"){await zJ(J,Z.state);return}if(Q.startsWith("remove ")){let j=VJ(Z.accounts,Q.slice(7));if(!j){J.ui.notify(`Unknown managed account: ${Q.slice(7)}`,"warning");return}await XJ(J,Z,j);return}if(Q){let j=VJ(Z.accounts,Q)??{id:Q,label:S(Q),provider:Q,source:"manual",updatedAt:new Date().toISOString()};if(!Z.accounts.some((F)=>F.id===j.id))Z.accounts.push(j);await YJ(J,Z,j);return}if(!J.hasUI){J.ui.notify(Z.accounts.length?Z.accounts.map((j)=>o(j,Z.data,Z.state)).join(`
-`):OJ(),Z.accounts.length?"info":"warning");return}let $=[...Z.accounts.map((j)=>o(j,Z.data,Z.state)),"add manual account","clear manual account"],Y=await J.ui.select("DuckMind Usage Accounts",$);if(!Y)return;if(Y==="add manual account"){let j=(await J.ui.input("Managed account id (provider key, no secret)"))?.trim();if(!j)return;await TJ(J,j);return}if(Y==="clear manual account"){await zJ(J,Z.state);return}let X=Z.accounts[$.indexOf(Y)];if(!X)return;let z=await J.ui.select("Account Action",["activate","remove local state","cancel"]);if(z==="activate")await YJ(J,Z,X);if(z==="remove local state")await XJ(J,Z,X)}async function WJ(J){let Q=await JJ(J);if(!Q)return;let Z=MJ(Q.accounts,Q.state),$=Q.state.removedAccountIds.length,Y=["DuckMind Usage managed account summary",`active: ${Z?`${Z.label} (${Z.id})`:"none"}`,`manual: ${Q.state.manualAccountId??"none"}`,`accounts: ${Q.accounts.length}${$?` · hidden=${$}`:""}`,`all-time: spend=${N(Q.data.allTime.totals.cost)} · messages=${E(Q.data.allTime.totals.messages)} · sessions=${E(Q.data.allTime.totals.sessions)} · tokens=${O(Q.data.allTime.totals.tokens.total)}`,"",...Q.accounts.length?Q.accounts.map((X)=>o(X,Q.data,Q.state)):[OJ()]];if(J.hasUI)await J.ui.select("DuckMind Usage Summary",Y);else J.ui.notify(Y.join(`
-`),"info")}async function XQ(J){let Q=["Current policy: manual account first, then accounts without quota cooldown, then highest all-time local spend, then alphabetical fallback.","dm-usage is observational: this state changes /usage account summaries only and does not route provider requests or store API secrets.","Use /usage reset manual to clear manual selection, or /usage reset quota to clear quota cooldown markers."];if(J.hasUI)await J.ui.select("DuckMind Usage Rotation",Q);else J.ui.notify(Q.join(" "),"info")}async function jQ(J){try{return await RJ(J,d.R_OK),!0}catch{return!1}}async function jJ(J){try{let Q=EJ(J);return await IJ(Q,{recursive:!0}),await RJ(Q,d.R_OK|d.W_OK),!0}catch{return!1}}async function qQ(J){let Q=await jQ(e()),Z=await jJ(A()),$=await jJ(UJ()),Y=await t(),X=await JJ(J),z=X?.accounts.length??0,j=X?MJ(X.accounts,X.state)?.id??"none":"none",F=Q&&Z&&$&&!Y.error,V=[`verify: ${F?"PASS":"WARN"}`,`sessions readable: ${Q?"yes":"no"}`,`state directory writable: ${Z?"yes":"no"}`,`settings directory writable: ${$?"yes":"no"}`,`state json: ${Y.error?`invalid (${Y.error})`:"ok"}`,`managed accounts: ${z}`,`active account: ${j}`];if(J.hasUI)await J.ui.select(`DuckMind Usage Verify (${F?"PASS":"WARN"})`,V);else J.ui.notify(V.join(`
-`),F?"info":"warning")}async function FQ(J){let Q=[`Session storage: ${e()}`,`Managed account state: ${A()}`,`Agent settings: ${UJ()}`];if(J.hasUI)await J.ui.select("DuckMind Usage Paths",Q);else J.ui.notify(Q.join(`
-`),"info")}async function GQ(J,Q){let Z=QQ(Q.toLowerCase());if(Z)return Z;if(Q){J.ui.notify("Unknown reset target. Use: /usage reset [manual|quota|all]","warning");return}if(!J.hasUI)return"all";let $=await J.ui.select("Reset DuckMind Usage State",["manual - clear manual account override","quota - clear quota cooldown markers","all - clear manual override, quota cooldown markers, and hidden account state"]);if(!$)return;if($.startsWith("manual"))return"manual";if($.startsWith("quota"))return"quota";return"all"}async function KQ(J,Q){let Z=await GQ(J,Q);if(!Z)return;let{state:$}=await t(),Y=Boolean($.manualAccountId);if(Z==="manual"||Z==="all")$.manualAccountId=void 0;let X=0;if(Z==="quota"||Z==="all")$.accounts=$.accounts.map((j)=>{if(j.quotaExhaustedUntil===void 0)return j;X++;let{quotaExhaustedUntil:F,...V}=j;return V});let z=Z==="all"?$.removedAccountIds.length:0;if(Z==="all")$.removedAccountIds=[];await g($),J.ui.notify(`reset: target=${Z} manualCleared=${Y&&!$.manualAccountId?"yes":"no"} quotaCleared=${X} hiddenCleared=${z}`,"info")}async function HQ(J,Q,Z){if(J==="use")return TJ(Z,Q);if(J==="show")return WJ(Z);if(J==="rotation")return XQ(Z);if(J==="verify")return qQ(Z);if(J==="path")return FQ(Z);if(J==="reset")return KQ(Z,Q);Z.ui.notify(CJ,"info")}var qJ=120000,n=4,FJ=150000,GJ=1e5,AJ=28800000,KJ=5,BQ=10,PQ=1;function DQ(J,Q){if(J.messages.length===0)return{insights:[]};let Z=J.messages.reduce((V,q)=>V+q.cost,0);if(Z<=0)return{insights:[]};let $=[],Y=RQ(J.messages);if(Y!==null)$.push({percent:Y/Z*100,headline:`of your cost was while ${n}+ sessions ran in parallel`,advice:"All sessions share one rate limit. If you don't need them all at once, queueing uses capacity more evenly."});let X=J.messages.filter((V)=>V.input+V.cacheRead+V.cacheWrite>FJ).reduce((V,q)=>V+q.cost,0);$.push({percent:X/Z*100,headline:`of your cost was at >${HJ(FJ)} context`,advice:"Longer sessions are more expensive even when cached. /compact mid-task, /clear when switching to new tasks."});let z=J.messages.filter((V)=>V.input+V.cacheWrite>GJ).reduce((V,q)=>V+q.cost,0);$.push({percent:z/Z*100,headline:`of your cost came from >${HJ(GJ)}-token uncached prompts`,advice:"Uncached input is expensive, and often happens when sending a message to a session that has gone idle. /compact before stepping away keeps the cold-start small."});let j=J.messages.filter((V)=>Q.has(V.sessionId)).reduce((V,q)=>V+q.cost,0);if(j>0)$.push({percent:j/Z*100,headline:`of your cost came from sessions active for ${AJ/3600000}+ hours`,advice:"These are often background/loop sessions. Continuous usage can add up quickly so make sure it is intentional."});if(J.sessionCosts.size>KJ){let V=Array.from(J.sessionCosts.values()).sort((G,H)=>H-G),q=Math.min(KJ,V.length),K=V.slice(0,q).reduce((G,H)=>G+H,0);$.push({percent:K/Z*100,headline:`of your cost came from your top ${q} session${q===1?"":"s"}`,advice:"A small number of sessions drives most of your spend. The table view can help pinpoint which ones."})}return{insights:$.filter((V)=>V.percent>=PQ).sort((V,q)=>q.percent-V.percent)}}function RQ(J){let Q=J.filter((V)=>V.timestamp>0);if(Q.length<BQ)return null;if(new Set(Q.map((V)=>V.sessionId)).size<n)return null;let $=Q.slice().sort((V,q)=>V.timestamp-q.timestamp),Y=new Map,X=0,z=0,j=0,F=0;for(let V=0;V<$.length;V++){let q=$[V],K=q.timestamp+qJ,G=q.timestamp-qJ;while(j<$.length&&$[j].timestamp<=K){let H=$[j].sessionId,B=(Y.get(H)??0)+1;if(Y.set(H,B),B===1)X++;j++}while(z<j&&$[z].timestamp<G){let H=$[z].sessionId,B=(Y.get(H)??0)-1;if(B===0)Y.delete(H),X--;else Y.set(H,B);z++}if(X>=n)F+=q.cost}return F}function HJ(J){if(J>=1e6)return`${J/1e6}M`;if(J>=1000)return`${J/1000}k`;return String(J)}function IQ(J){if(J>=10)return`${Math.round(J)}%`;return`${Math.round(J*10)/10}%`}function N(J){if(J===0)return"-";if(J<0.01)return`$${J.toFixed(4)}`;if(J<1)return`$${J.toFixed(2)}`;if(J<10)return`$${J.toFixed(2)}`;if(J<100)return`$${J.toFixed(1)}`;return`$${Math.round(J)}`}function O(J){if(J===0)return"-";if(J<1000)return J.toString();if(J<1e4)return`${(J/1000).toFixed(1)}k`;if(J<1e6)return`${Math.round(J/1000)}k`;if(J<1e7)return`${(J/1e6).toFixed(1)}M`;return`${Math.round(J/1e6)}M`}function E(J){if(J===0)return"-";return J.toLocaleString()}function kQ(J,Q){let Z=C(J);if(Z>=Q)return J;return" ".repeat(Q-Z)+J}function fJ(J,Q){let Z=C(J);if(Z>=Q)return J;return J+" ".repeat(Q-Z)}function BJ(J){return J.reduce((Q,Z)=>Q+Z.width,0)}function T(J,Q,Z="left"){if(Q<=0)return"";let $=_(J,Q);return Z==="right"?kQ($,Q):fJ($,Q)}function f(J,Q){return J.map((Z)=>_(Z,Math.max(Q,0)))}function u(J,Q){for(let Z of Q)if(C(Z)<=J)return Z;return Q[Q.length-1]||""}function PJ(J){let Q=Math.max(J,0);for(let X of h){let z=BJ(X.columns),j=Math.min(m,Math.max(Q-z,0));if(j>=X.minNameWidth)return{columns:X.columns,nameWidth:j,tableWidth:j+z,compact:X.compact??!1}}let Z=h[h.length-1],$=BJ(Z.columns),Y=Math.min(m,Math.max(Q-$,0));return{columns:Z.columns,nameWidth:Y,tableWidth:Y+$,compact:Z.compact??!1}}function DJ(J,Q,Z,$){let Y=Math.max(Math.floor(Z),0);if(Y<12)return f([$.fg("accent",$.bold(J)),...Q,""],Y);let X=Math.max(Y-2,1),z=` ${J} `,j=_(z,Math.max(X-1,1),""),F=C(j),V=Math.max(X-F,0),q=`╭${j}${"─".repeat(V)}╮`,K=`╰${"─".repeat(X)}╯`,G=Q.length>0?Q:[$.fg("dim","No data")];return[$.fg("border",q),...G.map((H)=>EQ(H,X,$)),$.fg("border",K),""]}function EQ(J,Q,Z){let $=_(J,Q),Y=Math.max(Q-C($),0);return`${Z.fg("border","│")}${$}${" ".repeat(Y)}${Z.fg("border","│")}`}function LQ(J,Q){if(J.size===0)return"No spend data";let Y=Array.from(J.keys()).sort().slice(-Math.max(1,Math.min(30,Q))).map((j)=>J.get(j)??0),X=Math.max(...Y);if(X<=0)return"No spend";let z=["▁","▂","▃","▄","▅","▆","▇","█"];return Y.map((j)=>{let F=Math.max(0,Math.min(z.length-1,Math.ceil(j/X*z.length)-1));return z[F]}).join("")}function UQ(J){let Q=J.dailySpend.size;if(Q===0)return"avg/day -";return`avg/day ${N(J.totals.cost/Q)}`}var x={today:"Today",thisWeek:"This Week",lastWeek:"Last Week",allTime:"All Time"},k=["today","thisWeek","lastWeek","allTime"];class wJ{activeTab="allTime";viewMode="table";data;selectedIndex=0;expanded=new Set;providerOrder=[];theme;requestRender;done;constructor(J,Q,Z,$){this.theme=J,this.requestRender=Z,this.done=$,this.data=Q,this.updateProviderOrder()}updateProviderOrder(){let J=this.data[this.activeTab];this.providerOrder=Array.from(J.providers.entries()).sort((Q,Z)=>Z[1].cost-Q[1].cost).map(([Q])=>Q),this.selectedIndex=Math.min(this.selectedIndex,Math.max(0,this.providerOrder.length-1))}handleInput(J){if(R(J,"escape")||R(J,"q")){this.done();return}if(R(J,"v")){this.viewMode=this.viewMode==="table"?"insights":"table",this.requestRender();return}if(R(J,"tab")||R(J,"right")){let Q=k.indexOf(this.activeTab);this.activeTab=k[(Q+1)%k.length],this.updateProviderOrder(),this.requestRender()}else if(R(J,"shift+tab")||R(J,"left")){let Q=k.indexOf(this.activeTab);this.activeTab=k[(Q-1+k.length)%k.length],this.updateProviderOrder(),this.requestRender()}else if(this.viewMode==="table"&&R(J,"up")){if(this.selectedIndex>0)this.selectedIndex--,this.requestRender()}else if(this.viewMode==="table"&&R(J,"down")){if(this.selectedIndex<this.providerOrder.length-1)this.selectedIndex++,this.requestRender()}else if(this.viewMode==="table"&&(R(J,"enter")||R(J,"space"))){let Q=this.providerOrder[this.selectedIndex];if(Q){if(this.expanded.has(Q))this.expanded.delete(Q);else this.expanded.add(Q);this.requestRender()}}}render(J){if(this.viewMode==="insights")return f([...this.renderTitle(J),...this.renderTabs(J,PJ(J)),...this.renderSpendChart(J),...this.renderInsights(J),...this.renderHelp(J)],J);let Q=PJ(J);return f([...this.renderTitle(J),...this.renderTabs(J,Q),...this.renderHeader(Q),...this.renderRows(Q),...this.renderTotals(Q),...this.renderFormulaNote(J),...this.renderHelp(J)],J)}renderTitle(J){let Q=this.theme,Z=this.data[this.activeTab],$=this.viewMode==="insights"?"Usage Insights":"Usage Statistics";return DJ("DuckMind Usage",[`${Q.fg("accent",Q.bold($))} · ${x[this.activeTab]}`,`Spend ${N(Z.totals.cost)} · ${E(Z.totals.messages)} messages · ${O(Z.totals.tokens.total)} tokens`,`Providers ${E(Z.providers.size)} · Sessions ${E(Z.totals.sessions)} · ${UQ(Z)}`],J,Q)}renderSpendChart(J){let Q=this.theme,Z=this.data[this.activeTab];return DJ("Daily Spend",[Q.fg("accent",LQ(Z.dailySpend,Math.max(J-4,10))),Q.fg("dim","Local session spend, last 30 active UTC days")],J,Q)}renderInsights(J){let Q=this.theme,Z=this.data[this.activeTab],{insights:$}=Z.insights,Y=Z.totals.messages>0,X=Z.totals.cost>0,z=[];z.push("What's contributing to your cost?"),z.push(Q.fg("dim","Approximate, based on local sessions on this machine.")),z.push("");let j=`${x[this.activeTab]} · weighted by cost (USD) · these overlap and can sum to >100%`;if(z.push(Q.fg("dim",j)),z.push(""),!Y)return z.push(Q.fg("dim","  No usage recorded for this period.")),z.push(""),z;if(!X)return z.push(Q.fg("dim","  No cost data recorded for this period.")),z.push(""),z;if($.length===0)return z.push(Q.fg("dim","  No insights above 1% for this period.")),z.push(""),z;let F="     ",V=Math.max(J-F.length,30);for(let q of $){let K=Q.fg("accent",Q.bold(IQ(q.percent)));z.push(`${K} ${q.headline}`);for(let G of ZJ(q.advice,V))z.push(`${F}${Q.fg("dim",G)}`);z.push("")}return z}renderTabs(J,Q){let Z=this.theme,$=k.map((j)=>{let F=x[j];return j===this.activeTab?Z.fg("accent",`[${F}]`):Z.fg("dim",` ${F} `)}).join("  "),Y=Z.fg("accent",`[${x[this.activeTab]}]`),X=u(J,[$,`${Y}  ${Z.fg("dim","[Tab/←→]")}`,Y]),z=this.viewMode==="table"&&Q.compact?ZJ(Z.fg("dim","Compact view. Widen the terminal for more columns."),Math.max(J,1)):[];return[X,...z,""]}renderHeader(J){let Q=this.theme,Z=T("Provider / Model",J.nameWidth);for(let $ of J.columns){let Y=T($.label,$.width,"right");Z+=$.dimmed?Q.fg("dim",Y):Y}return[Q.fg("muted",Z),Q.fg("border","─".repeat(J.tableWidth))]}renderDataRow(J,Q,Z,$={}){let Y=this.theme,{indent:X=0,selected:z=!1,dimAll:j=!1,prefix:F}=$,V=F??" ".repeat(X),q=Z.nameWidth>0?_(V,Z.nameWidth,""):"",K=C(q),G=Math.max(Z.nameWidth-K,0),H=G>0?_(J,G):"",B=z?Y.fg("accent",H):j?Y.fg("dim",H):H,P=q+(G>0?fJ(B,G):"");for(let D of Z.columns){let I=T(D.getValue(Q),D.width,"right"),w=D.dimmed||j;P+=w?Y.fg("dim",I):I}return P}renderRows(J){let Q=this.theme,Z=this.data[this.activeTab],$=[];if(this.providerOrder.length===0)return $.push(Q.fg("dim","  No usage data for this period")),$;for(let Y=0;Y<this.providerOrder.length;Y++){let X=this.providerOrder[Y],z=Z.providers.get(X),j=Y===this.selectedIndex,F=this.expanded.has(X),V=F?"▾":"▸",q=j?Q.fg("accent",`${V} `):Q.fg("dim",`${V} `);if($.push(this.renderDataRow(S(X),z,J,{selected:j,prefix:q})),F){let K=Array.from(z.models.entries()).sort((G,H)=>H[1].cost-G[1].cost);for(let[G,H]of K)$.push(this.renderDataRow(G,H,J,{indent:4,dimAll:!0}))}}return $}renderTotals(J){let Q=this.theme,Z=this.data[this.activeTab],$=T(Q.bold("Total"),J.nameWidth);for(let Y of J.columns){let X=T(Y.getValue(Z.totals),Y.width,"right");$+=Y.dimmed?Q.fg("dim",X):X}return[Q.fg("border","─".repeat(J.tableWidth)),$,""]}renderFormulaNote(J){let Q=u(J,["Tokens = Input + Output + CacheWrite  ·  ↑In = Input + CacheWrite  (as of 0.2.0)","Tokens = In + Out + CacheWrite  ·  ↑In = In + CacheWrite  (v0.2.0+)","Tokens & ↑In include CacheWrite (v0.2.0+)","Incl. CacheWrite (v0.2.0+)"]);return[this.theme.fg("dim",Q),""]}renderHelp(J){let Q=this.viewMode==="insights"?["[Tab/←→] period  [v] table view  [q] close","[Tab] period  [v] table  [q] close","[v] table  [q] close","[q] close"]:["[Tab/←→] period  [↑↓] select  [Enter] expand  [v] insights  [q] close","[Tab] period  [↑↓] select  [Enter] expand  [v] insights  [q] close","[↑↓] select  [Enter] expand  [v] insights  [q] close","[↑↓] select  [v] insights  [q] close","[↑↓] select  [q] close","[q] close"],Z=u(J,Q);return[this.theme.fg("dim",Z)]}invalidate(){}dispose(){}}function _Q(J){J.registerCommand("usage",{description:`Show usage statistics dashboard and account tools: ${y.join(", ")}`,getArgumentCompletions:ZQ,handler:async(Q,Z)=>{let $=tJ(Q);if($.subcommand){if(!JQ($.subcommand)){Z.ui.notify(`Unknown /usage subcommand: ${$.subcommand}
-${CJ}`,"warning");return}await HQ($.subcommand,$.rest,Z);return}if(!Z.hasUI){await WJ(Z);return}let Y=await Z.ui.custom((X,z,j,F)=>{let V=new vJ(X,(G)=>z.fg("accent",G),(G)=>z.fg("muted",G),"Loading Usage..."),q=!1,K=(G)=>{if(q)return;q=!0,V.dispose(),F(G)};return V.onAbort=()=>K(null),NJ(V.signal).then(K).catch(()=>K(null)),V});if(!Y)return;await Z.ui.custom((X,z,j,F)=>{let V=new xJ;V.addChild(new QJ(1)),V.addChild(new bJ((K)=>z.fg("border",K))),V.addChild(new QJ(1));let q=new wJ(z,Y,()=>X.requestRender(),()=>F());return{render:(K)=>{let G=f(V.render(K),K),H=q.render(K),B=z.fg("border","─".repeat(K));return f([...G,...H,"",B],K)},invalidate:()=>V.invalidate(),handleInput:(K)=>q.handleInput(K),dispose:()=>{}}})}})}export{_Q as default};
+import { DynamicBorder } from "@duckmind/dm-coding-agent";
+import { CancellableLoader, Container, Spacer, matchesKey, visibleWidth, truncateToWidth, wrapTextWithAnsi } from "@duckmind/dm-tui";
+import { constants as fsConstants } from "node:fs";
+import { access, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+const MAX_NAME_COL_WIDTH = 26;
+const PROVIDER_DISPLAY_NAMES = {
+  "openai-codex": "duckmind-ultra",
+  openrouter: "duckmind-standard"
+};
+function formatProviderName(provider) {
+  return PROVIDER_DISPLAY_NAMES[provider] ?? provider;
+}
+const SESSIONS_COLUMN = {
+  label: "Sessions",
+  width: 9,
+  getValue: (s) => formatNumber(typeof s.sessions === "number" ? s.sessions : s.sessions.size)
+};
+const MSGS_COLUMN = {
+  label: "Msgs",
+  width: 9,
+  getValue: (s) => formatNumber(s.messages)
+};
+const COST_COLUMN = {
+  label: "Cost",
+  width: 9,
+  getValue: (s) => formatCost(s.cost)
+};
+const TOKENS_COLUMN = {
+  label: "Tokens",
+  width: 9,
+  getValue: (s) => formatTokens(s.tokens.total)
+};
+const INPUT_COLUMN = {
+  label: "↑In",
+  width: 8,
+  dimmed: true,
+  getValue: (s) => formatTokens(s.tokens.input + s.tokens.cacheWrite)
+};
+const OUTPUT_COLUMN = {
+  label: "↓Out",
+  width: 8,
+  dimmed: true,
+  getValue: (s) => formatTokens(s.tokens.output)
+};
+const CACHE_COLUMN = {
+  label: "Cache",
+  width: 8,
+  dimmed: true,
+  getValue: (s) => formatTokens(s.tokens.cacheRead + s.tokens.cacheWrite)
+};
+const FULL_DATA_COLUMNS = [
+  SESSIONS_COLUMN,
+  MSGS_COLUMN,
+  COST_COLUMN,
+  TOKENS_COLUMN,
+  INPUT_COLUMN,
+  OUTPUT_COLUMN,
+  CACHE_COLUMN
+];
+const TABLE_LAYOUTS = [
+  { columns: FULL_DATA_COLUMNS, minNameWidth: MAX_NAME_COL_WIDTH },
+  { columns: [SESSIONS_COLUMN, MSGS_COLUMN, COST_COLUMN, TOKENS_COLUMN], minNameWidth: 14, compact: true },
+  { columns: [SESSIONS_COLUMN, COST_COLUMN, TOKENS_COLUMN], minNameWidth: 12, compact: true },
+  { columns: [COST_COLUMN, TOKENS_COLUMN], minNameWidth: 10, compact: true },
+  { columns: [COST_COLUMN], minNameWidth: 8, compact: true }
+];
+function getAgentDir() {
+  return process.env.DM_CODING_AGENT_DIR || process.env.PI_CODING_AGENT_DIR || join(homedir(), ".dm", "agent");
+}
+function getSessionsDir() {
+  return join(getAgentDir(), "sessions");
+}
+function getUsageStateDir() {
+  return join(getAgentDir(), "usage");
+}
+function getUsageStatePath() {
+  return join(getUsageStateDir(), "state.json");
+}
+function getAgentSettingsPath() {
+  return join(getAgentDir(), "settings.json");
+}
+async function collectSessionFilesRecursively(dir, files, signal) {
+  try {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (signal?.aborted)
+        return;
+      const entryPath = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await collectSessionFilesRecursively(entryPath, files, signal);
+      } else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+        files.push(entryPath);
+      }
+    }
+  } catch {}
+}
+async function getAllSessionFiles(signal) {
+  const files = [];
+  await collectSessionFilesRecursively(getSessionsDir(), files, signal);
+  files.sort();
+  return files;
+}
+async function parseSessionFile(filePath, seenHashes, signal) {
+  try {
+    const content = await readFile(filePath, "utf8");
+    if (signal?.aborted)
+      return null;
+    const lines = content.trim().split(`
+`);
+    const messages = [];
+    let sessionId = "";
+    for (let i = 0;i < lines.length; i++) {
+      if (signal?.aborted)
+        return null;
+      if (i % 500 === 0) {
+        await new Promise((resolve) => setImmediate(resolve));
+      }
+      const line = lines[i];
+      if (!line.trim())
+        continue;
+      try {
+        const entry = JSON.parse(line);
+        if (entry.type === "session") {
+          sessionId = entry.id;
+        } else if (entry.type === "message" && entry.message?.role === "assistant") {
+          const msg = entry.message;
+          if (msg.usage && msg.provider && msg.model) {
+            const input = msg.usage.input || 0;
+            const output = msg.usage.output || 0;
+            const cacheRead = msg.usage.cacheRead || 0;
+            const cacheWrite = msg.usage.cacheWrite || 0;
+            const fallbackTs = entry.timestamp ? new Date(entry.timestamp).getTime() : 0;
+            const timestamp = msg.timestamp || (Number.isNaN(fallbackTs) ? 0 : fallbackTs);
+            const totalTokens = input + output + cacheRead + cacheWrite;
+            const hash = `${timestamp}:${totalTokens}`;
+            if (seenHashes.has(hash))
+              continue;
+            seenHashes.add(hash);
+            messages.push({
+              provider: msg.provider,
+              model: msg.model,
+              cost: msg.usage.cost?.total || 0,
+              input,
+              output,
+              cacheRead,
+              cacheWrite,
+              timestamp
+            });
+          }
+        }
+      } catch {}
+    }
+    return sessionId ? { sessionId, messages } : null;
+  } catch {
+    return null;
+  }
+}
+function accumulateStats(target, cost, tokens) {
+  target.messages++;
+  target.cost += cost;
+  target.tokens.total += tokens.total;
+  target.tokens.input += tokens.input;
+  target.tokens.output += tokens.output;
+  target.tokens.cacheRead += tokens.cacheRead;
+  target.tokens.cacheWrite += tokens.cacheWrite;
+}
+function emptyTokens() {
+  return { total: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+}
+function emptyModelStats() {
+  return { sessions: new Set, messages: 0, cost: 0, tokens: emptyTokens() };
+}
+function emptyProviderStats() {
+  return { sessions: new Set, messages: 0, cost: 0, tokens: emptyTokens(), models: new Map };
+}
+function emptyTimeFilteredStats() {
+  return {
+    providers: new Map,
+    totals: { sessions: 0, messages: 0, cost: 0, tokens: emptyTokens() },
+    dailySpend: new Map,
+    insights: { insights: [] }
+  };
+}
+function emptyPeriodRawData() {
+  return { messages: [], sessionCosts: new Map };
+}
+function emptyUsageData() {
+  return {
+    today: emptyTimeFilteredStats(),
+    thisWeek: emptyTimeFilteredStats(),
+    lastWeek: emptyTimeFilteredStats(),
+    allTime: emptyTimeFilteredStats()
+  };
+}
+function getPeriodsForTimestamp(timestamp, todayMs, weekStartMs, lastWeekStartMs) {
+  const periods = ["allTime"];
+  if (timestamp >= todayMs)
+    periods.push("today");
+  if (timestamp >= weekStartMs) {
+    periods.push("thisWeek");
+  } else if (timestamp >= lastWeekStartMs) {
+    periods.push("lastWeek");
+  }
+  return periods;
+}
+function addMessagesToUsageData(data, sessionId, messages, todayMs, weekStartMs, lastWeekStartMs, rawByPeriod, globalSessionSpans) {
+  const sessionContributed = { today: false, thisWeek: false, lastWeek: false, allTime: false };
+  for (const msg of messages) {
+    if (msg.timestamp > 0) {
+      const span = globalSessionSpans.get(sessionId);
+      if (!span) {
+        globalSessionSpans.set(sessionId, { startMs: msg.timestamp, endMs: msg.timestamp });
+      } else {
+        if (msg.timestamp < span.startMs)
+          span.startMs = msg.timestamp;
+        if (msg.timestamp > span.endMs)
+          span.endMs = msg.timestamp;
+      }
+    }
+    const periods = getPeriodsForTimestamp(msg.timestamp, todayMs, weekStartMs, lastWeekStartMs);
+    const tokens = {
+      total: msg.input + msg.output + msg.cacheWrite,
+      input: msg.input,
+      output: msg.output,
+      cacheRead: msg.cacheRead,
+      cacheWrite: msg.cacheWrite
+    };
+    for (const period of periods) {
+      const stats = data[period];
+      let providerStats = stats.providers.get(msg.provider);
+      if (!providerStats) {
+        providerStats = emptyProviderStats();
+        stats.providers.set(msg.provider, providerStats);
+      }
+      let modelStats = providerStats.models.get(msg.model);
+      if (!modelStats) {
+        modelStats = emptyModelStats();
+        providerStats.models.set(msg.model, modelStats);
+      }
+      modelStats.sessions.add(sessionId);
+      accumulateStats(modelStats, msg.cost, tokens);
+      providerStats.sessions.add(sessionId);
+      accumulateStats(providerStats, msg.cost, tokens);
+      accumulateStats(stats.totals, msg.cost, tokens);
+      if (msg.cost > 0 && msg.timestamp > 0) {
+        const dayKey = new Date(msg.timestamp).toISOString().slice(0, 10);
+        stats.dailySpend.set(dayKey, (stats.dailySpend.get(dayKey) ?? 0) + msg.cost);
+      }
+      sessionContributed[period] = true;
+      const raw = rawByPeriod[period];
+      raw.messages.push({
+        sessionId,
+        timestamp: msg.timestamp,
+        cost: msg.cost,
+        input: msg.input,
+        cacheRead: msg.cacheRead,
+        cacheWrite: msg.cacheWrite
+      });
+      raw.sessionCosts.set(sessionId, (raw.sessionCosts.get(sessionId) ?? 0) + msg.cost);
+    }
+  }
+  if (sessionContributed.today)
+    data.today.totals.sessions++;
+  if (sessionContributed.thisWeek)
+    data.thisWeek.totals.sessions++;
+  if (sessionContributed.lastWeek)
+    data.lastWeek.totals.sessions++;
+  if (sessionContributed.allTime)
+    data.allTime.totals.sessions++;
+}
+async function collectUsageData(signal) {
+  const startOfToday = new Date;
+  startOfToday.setHours(0, 0, 0, 0);
+  const todayMs = startOfToday.getTime();
+  const startOfWeek = new Date;
+  const dayOfWeek = startOfWeek.getDay();
+  const daysSinceMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
+  startOfWeek.setDate(startOfWeek.getDate() - daysSinceMonday);
+  startOfWeek.setHours(0, 0, 0, 0);
+  const weekStartMs = startOfWeek.getTime();
+  const startOfLastWeek = new Date(startOfWeek);
+  startOfLastWeek.setDate(startOfLastWeek.getDate() - 7);
+  const lastWeekStartMs = startOfLastWeek.getTime();
+  const data = emptyUsageData();
+  const rawByPeriod = {
+    today: emptyPeriodRawData(),
+    thisWeek: emptyPeriodRawData(),
+    lastWeek: emptyPeriodRawData(),
+    allTime: emptyPeriodRawData()
+  };
+  const globalSessionSpans = new Map;
+  const sessionFiles = await getAllSessionFiles(signal);
+  if (signal?.aborted)
+    return null;
+  const seenHashes = new Set;
+  for (const filePath of sessionFiles) {
+    if (signal?.aborted)
+      return null;
+    const parsed = await parseSessionFile(filePath, seenHashes, signal);
+    if (signal?.aborted)
+      return null;
+    if (!parsed)
+      continue;
+    addMessagesToUsageData(data, parsed.sessionId, parsed.messages, todayMs, weekStartMs, lastWeekStartMs, rawByPeriod, globalSessionSpans);
+    await new Promise((resolve) => setImmediate(resolve));
+  }
+  const longSessionIds = new Set;
+  for (const [id, span] of globalSessionSpans) {
+    if (span.endMs - span.startMs >= LONG_SESSION_MS)
+      longSessionIds.add(id);
+  }
+  for (const period of TAB_ORDER) {
+    data[period].insights = computeInsights(rawByPeriod[period], longSessionIds);
+  }
+  return data;
+}
+const USAGE_SUBCOMMANDS = ["use", "show", "rotation", "verify", "path", "reset", "help"];
+const USAGE_RESET_TARGETS = ["manual", "quota", "all"];
+const USAGE_HELP_TEXT = [
+  "Usage: /usage [use|show|rotation|verify|path|reset|help]",
+  "use: select, activate, or remove managed account",
+  "show: managed account and usage summary",
+  "rotation: current rotation behavior",
+  "verify: runtime health checks",
+  "path: storage and settings locations",
+  "reset: clear manual or quota state"
+].join(`
+`);
+function parseUsageCommandArgs(args) {
+  const trimmed = args.trim();
+  if (!trimmed)
+    return { rest: "" };
+  const firstSpaceIndex = trimmed.indexOf(" ");
+  if (firstSpaceIndex < 0)
+    return { subcommand: trimmed.toLowerCase(), rest: "" };
+  return {
+    subcommand: trimmed.slice(0, firstSpaceIndex).toLowerCase(),
+    rest: trimmed.slice(firstSpaceIndex + 1).trim()
+  };
+}
+function isUsageSubcommand(value) {
+  return USAGE_SUBCOMMANDS.some((subcommand) => subcommand === value);
+}
+function parseUsageResetTarget(value) {
+  if (value === "manual" || value === "quota" || value === "all")
+    return value;
+  return;
+}
+function toAutocompleteItems(values) {
+  return values.map((value) => ({ value, label: value }));
+}
+function getUsageCommandCompletions(argumentPrefix) {
+  const trimmedStart = argumentPrefix.trimStart();
+  if (!trimmedStart)
+    return toAutocompleteItems(USAGE_SUBCOMMANDS);
+  const firstSpaceIndex = trimmedStart.indexOf(" ");
+  if (firstSpaceIndex < 0) {
+    const matches = USAGE_SUBCOMMANDS.filter((value) => value.startsWith(trimmedStart.toLowerCase()));
+    return matches.length > 0 ? toAutocompleteItems(matches) : null;
+  }
+  const subcommand = trimmedStart.slice(0, firstSpaceIndex).toLowerCase();
+  const rest = trimmedStart.slice(firstSpaceIndex + 1).toLowerCase();
+  if (subcommand === "reset") {
+    const matches = USAGE_RESET_TARGETS.filter((value) => value.startsWith(rest));
+    return matches.length > 0 ? matches.map((value) => ({ value: `reset ${value}`, label: value })) : null;
+  }
+  if (subcommand === "use") {
+    const matches = ["clear", "remove"].filter((value) => value.startsWith(rest));
+    return matches.length > 0 ? matches.map((value) => ({ value: `use ${value}`, label: value })) : null;
+  }
+  return null;
+}
+function emptyUsageManagedState() {
+  return { version: 1, removedAccountIds: [], accounts: [], updatedAt: new Date(0).toISOString() };
+}
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function normalizeUsageManagedAccount(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const record = value;
+  const id = asString(record.id);
+  const provider = asString(record.provider) ?? id;
+  if (!id || !provider)
+    return;
+  const label = asString(record.label) ?? formatProviderName(provider);
+  const source = record.source === "manual" ? "manual" : "session";
+  const updatedAt = asString(record.updatedAt) ?? new Date(0).toISOString();
+  const quota = typeof record.quotaExhaustedUntil === "number" && Number.isFinite(record.quotaExhaustedUntil) ? record.quotaExhaustedUntil : undefined;
+  return { id, label, provider, source, updatedAt, quotaExhaustedUntil: quota };
+}
+function normalizeUsageManagedState(value) {
+  const empty = emptyUsageManagedState();
+  if (!value || typeof value !== "object")
+    return empty;
+  const record = value;
+  const accounts = Array.isArray(record.accounts) ? record.accounts.map(normalizeUsageManagedAccount).filter((account) => Boolean(account)) : [];
+  const removedAccountIds = Array.isArray(record.removedAccountIds) ? record.removedAccountIds.map(asString).filter((id) => Boolean(id)) : [];
+  return {
+    version: 1,
+    manualAccountId: asString(record.manualAccountId),
+    removedAccountIds,
+    accounts,
+    updatedAt: asString(record.updatedAt) ?? empty.updatedAt
+  };
+}
+function getErrorCode(error) {
+  return error && typeof error === "object" && "code" in error ? String(error.code) : undefined;
+}
+async function readUsageManagedState() {
+  try {
+    const raw = await readFile(getUsageStatePath(), "utf8");
+    return { state: normalizeUsageManagedState(JSON.parse(raw)) };
+  } catch (error) {
+    if (getErrorCode(error) === "ENOENT")
+      return { state: emptyUsageManagedState() };
+    return { state: emptyUsageManagedState(), error: error instanceof Error ? error.message : String(error) };
+  }
+}
+async function saveUsageManagedState(state) {
+  state.version = 1;
+  state.updatedAt = new Date().toISOString();
+  state.removedAccountIds = [...new Set(state.removedAccountIds)].sort();
+  state.accounts = state.accounts.filter((account) => !state.removedAccountIds.includes(account.id)).sort((a, b) => a.label.localeCompare(b.label));
+  await mkdir(dirname(getUsageStatePath()), { recursive: true });
+  await writeFile(getUsageStatePath(), `${JSON.stringify(state, null, 2)}
+`, "utf8");
+}
+function isQuotaActive(account) {
+  return typeof account.quotaExhaustedUntil === "number" && account.quotaExhaustedUntil > Date.now();
+}
+function getAccountStats(data, account) {
+  return data.allTime.providers.get(account.provider);
+}
+function getManagedAccounts(data, state) {
+  const now = new Date().toISOString();
+  const accounts = new Map;
+  for (const account of state.accounts) {
+    if (!state.removedAccountIds.includes(account.id))
+      accounts.set(account.id, account);
+  }
+  for (const provider of data.allTime.providers.keys()) {
+    if (state.removedAccountIds.includes(provider) || accounts.has(provider))
+      continue;
+    accounts.set(provider, {
+      id: provider,
+      label: formatProviderName(provider),
+      provider,
+      source: "session",
+      updatedAt: now
+    });
+  }
+  return Array.from(accounts.values()).sort((a, b) => {
+    const manualId = state.manualAccountId;
+    if (a.id === manualId && b.id !== manualId)
+      return -1;
+    if (b.id === manualId && a.id !== manualId)
+      return 1;
+    if (isQuotaActive(a) !== isQuotaActive(b))
+      return isQuotaActive(a) ? 1 : -1;
+    const costDelta = (getAccountStats(data, b)?.cost ?? 0) - (getAccountStats(data, a)?.cost ?? 0);
+    if (costDelta !== 0)
+      return costDelta;
+    return a.label.localeCompare(b.label);
+  });
+}
+function getActiveManagedAccount(accounts, state) {
+  const manual = accounts.find((account) => account.id === state.manualAccountId && !isQuotaActive(account));
+  return manual ?? accounts.find((account) => !isQuotaActive(account));
+}
+function findManagedAccount(accounts, query) {
+  const normalized = query.trim().toLowerCase();
+  return accounts.find((account) => account.id.toLowerCase() === normalized || account.provider.toLowerCase() === normalized || account.label.toLowerCase() === normalized);
+}
+function formatManagedAccountLine(account, data, state) {
+  const stats = getAccountStats(data, account);
+  const tags = [
+    state.manualAccountId === account.id ? "manual" : undefined,
+    isQuotaActive(account) ? "quota" : undefined,
+    account.source === "manual" ? "manual-entry" : undefined
+  ].filter(Boolean).join(", ");
+  const suffix = tags ? ` (${tags})` : "";
+  const cost = stats ? formatCost(stats.cost) : formatCost(0);
+  const messages = stats ? formatNumber(stats.messages) : "0";
+  const sessions = stats ? formatNumber(stats.sessions.size) : "0";
+  return `${account.label}${suffix} · id=${account.id} · spend=${cost} · messages=${messages} · sessions=${sessions}`;
+}
+async function loadUsageManagedSummary(ctx) {
+  const data = await collectUsageData(ctx.signal);
+  if (!data) {
+    ctx.ui.notify("Usage data unavailable or cancelled.", "warning");
+    return null;
+  }
+  const { state, error } = await readUsageManagedState();
+  if (error) {
+    ctx.ui.notify(`dm-usage state unreadable; using empty state: ${error}`, "warning");
+  }
+  return { data, state, accounts: getManagedAccounts(data, state) };
+}
+function managedAccountNoDataMessage() {
+  return "No managed accounts found. Run /usage after at least one provider response, or use /usage use <provider-id> to create a local manual entry.";
+}
+async function activateUsageAccount(ctx, summary, account) {
+  summary.state.manualAccountId = account.id;
+  summary.state.removedAccountIds = summary.state.removedAccountIds.filter((id) => id !== account.id);
+  summary.state.accounts = summary.accounts.map((item) => item.id === account.id ? { ...item, updatedAt: new Date().toISOString() } : item);
+  await saveUsageManagedState(summary.state);
+  ctx.ui.notify(`dm-usage: now using ${account.label} (${account.id})`, "info");
+}
+async function clearUsageManualAccount(ctx, state) {
+  const hadManual = Boolean(state.manualAccountId);
+  state.manualAccountId = undefined;
+  await saveUsageManagedState(state);
+  ctx.ui.notify(`dm-usage: manual account ${hadManual ? "cleared" : "was not set"}`, "info");
+}
+async function removeUsageAccountState(ctx, summary, account) {
+  summary.state.removedAccountIds = [...summary.state.removedAccountIds, account.id];
+  if (summary.state.manualAccountId === account.id)
+    summary.state.manualAccountId = undefined;
+  summary.state.accounts = summary.accounts.filter((item) => item.id !== account.id);
+  await saveUsageManagedState(summary.state);
+  ctx.ui.notify(`dm-usage: removed local managed-account state for ${account.label}; session data was not changed.`, "info");
+}
+async function runUsageUseSubcommand(ctx, rest) {
+  const summary = await loadUsageManagedSummary(ctx);
+  if (!summary)
+    return;
+  if (rest === "clear") {
+    await clearUsageManualAccount(ctx, summary.state);
+    return;
+  }
+  if (rest.startsWith("remove ")) {
+    const account = findManagedAccount(summary.accounts, rest.slice("remove ".length));
+    if (!account) {
+      ctx.ui.notify(`Unknown managed account: ${rest.slice("remove ".length)}`, "warning");
+      return;
+    }
+    await removeUsageAccountState(ctx, summary, account);
+    return;
+  }
+  if (rest) {
+    const account = findManagedAccount(summary.accounts, rest) ?? { id: rest, label: formatProviderName(rest), provider: rest, source: "manual", updatedAt: new Date().toISOString() };
+    if (!summary.accounts.some((item) => item.id === account.id))
+      summary.accounts.push(account);
+    await activateUsageAccount(ctx, summary, account);
+    return;
+  }
+  if (!ctx.hasUI) {
+    ctx.ui.notify(summary.accounts.length ? summary.accounts.map((account) => formatManagedAccountLine(account, summary.data, summary.state)).join(`
+`) : managedAccountNoDataMessage(), summary.accounts.length ? "info" : "warning");
+    return;
+  }
+  const options = [
+    ...summary.accounts.map((account) => formatManagedAccountLine(account, summary.data, summary.state)),
+    "add manual account",
+    "clear manual account"
+  ];
+  const selected = await ctx.ui.select("DuckMind Usage Accounts", options);
+  if (!selected)
+    return;
+  if (selected === "add manual account") {
+    const id = (await ctx.ui.input("Managed account id (provider key, no secret)"))?.trim();
+    if (!id)
+      return;
+    await runUsageUseSubcommand(ctx, id);
+    return;
+  }
+  if (selected === "clear manual account") {
+    await clearUsageManualAccount(ctx, summary.state);
+    return;
+  }
+  const account = summary.accounts[options.indexOf(selected)];
+  if (!account)
+    return;
+  const action = await ctx.ui.select("Account Action", ["activate", "remove local state", "cancel"]);
+  if (action === "activate")
+    await activateUsageAccount(ctx, summary, account);
+  if (action === "remove local state")
+    await removeUsageAccountState(ctx, summary, account);
+}
+async function runUsageShowSubcommand(ctx) {
+  const summary = await loadUsageManagedSummary(ctx);
+  if (!summary)
+    return;
+  const active = getActiveManagedAccount(summary.accounts, summary.state);
+  const hiddenCount = summary.state.removedAccountIds.length;
+  const lines = [
+    "DuckMind Usage managed account summary",
+    `active: ${active ? `${active.label} (${active.id})` : "none"}`,
+    `manual: ${summary.state.manualAccountId ?? "none"}`,
+    `accounts: ${summary.accounts.length}${hiddenCount ? ` · hidden=${hiddenCount}` : ""}`,
+    `all-time: spend=${formatCost(summary.data.allTime.totals.cost)} · messages=${formatNumber(summary.data.allTime.totals.messages)} · sessions=${formatNumber(summary.data.allTime.totals.sessions)} · tokens=${formatTokens(summary.data.allTime.totals.tokens.total)}`,
+    "",
+    ...summary.accounts.length ? summary.accounts.map((account) => formatManagedAccountLine(account, summary.data, summary.state)) : [managedAccountNoDataMessage()]
+  ];
+  if (ctx.hasUI) {
+    await ctx.ui.select("DuckMind Usage Summary", lines);
+  } else {
+    ctx.ui.notify(lines.join(`
+`), "info");
+  }
+}
+async function runUsageRotationSubcommand(ctx) {
+  const lines = [
+    "Current policy: manual account first, then accounts without quota cooldown, then highest all-time local spend, then alphabetical fallback.",
+    "dm-usage is observational: this state changes /usage account summaries only and does not route provider requests or store API secrets.",
+    "Use /usage reset manual to clear manual selection, or /usage reset quota to clear quota cooldown markers."
+  ];
+  if (ctx.hasUI) {
+    await ctx.ui.select("DuckMind Usage Rotation", lines);
+  } else {
+    ctx.ui.notify(lines.join(" "), "info");
+  }
+}
+async function isDirectoryReadable(path) {
+  try {
+    await access(path, fsConstants.R_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isWritableDirectoryFor(filePath) {
+  try {
+    const directory = dirname(filePath);
+    await mkdir(directory, { recursive: true });
+    await access(directory, fsConstants.R_OK | fsConstants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function runUsageVerifySubcommand(ctx) {
+  const sessionsReadable = await isDirectoryReadable(getSessionsDir());
+  const stateWritable = await isWritableDirectoryFor(getUsageStatePath());
+  const settingsWritable = await isWritableDirectoryFor(getAgentSettingsPath());
+  const stateRead = await readUsageManagedState();
+  const summary = await loadUsageManagedSummary(ctx);
+  const accounts = summary?.accounts.length ?? 0;
+  const active = summary ? getActiveManagedAccount(summary.accounts, summary.state)?.id ?? "none" : "none";
+  const ok = sessionsReadable && stateWritable && settingsWritable && !stateRead.error;
+  const lines = [
+    `verify: ${ok ? "PASS" : "WARN"}`,
+    `sessions readable: ${sessionsReadable ? "yes" : "no"}`,
+    `state directory writable: ${stateWritable ? "yes" : "no"}`,
+    `settings directory writable: ${settingsWritable ? "yes" : "no"}`,
+    `state json: ${stateRead.error ? `invalid (${stateRead.error})` : "ok"}`,
+    `managed accounts: ${accounts}`,
+    `active account: ${active}`
+  ];
+  if (ctx.hasUI) {
+    await ctx.ui.select(`DuckMind Usage Verify (${ok ? "PASS" : "WARN"})`, lines);
+  } else {
+    ctx.ui.notify(lines.join(`
+`), ok ? "info" : "warning");
+  }
+}
+async function runUsagePathSubcommand(ctx) {
+  const lines = [
+    `Session storage: ${getSessionsDir()}`,
+    `Managed account state: ${getUsageStatePath()}`,
+    `Agent settings: ${getAgentSettingsPath()}`
+  ];
+  if (ctx.hasUI) {
+    await ctx.ui.select("DuckMind Usage Paths", lines);
+  } else {
+    ctx.ui.notify(lines.join(`
+`), "info");
+  }
+}
+async function chooseUsageResetTarget(ctx, argument) {
+  const explicitTarget = parseUsageResetTarget(argument.toLowerCase());
+  if (explicitTarget)
+    return explicitTarget;
+  if (argument) {
+    ctx.ui.notify("Unknown reset target. Use: /usage reset [manual|quota|all]", "warning");
+    return;
+  }
+  if (!ctx.hasUI)
+    return "all";
+  const selected = await ctx.ui.select("Reset DuckMind Usage State", [
+    "manual - clear manual account override",
+    "quota - clear quota cooldown markers",
+    "all - clear manual override, quota cooldown markers, and hidden account state"
+  ]);
+  if (!selected)
+    return;
+  if (selected.startsWith("manual"))
+    return "manual";
+  if (selected.startsWith("quota"))
+    return "quota";
+  return "all";
+}
+async function runUsageResetSubcommand(ctx, rest) {
+  const target = await chooseUsageResetTarget(ctx, rest);
+  if (!target)
+    return;
+  const { state } = await readUsageManagedState();
+  const hadManual = Boolean(state.manualAccountId);
+  if (target === "manual" || target === "all")
+    state.manualAccountId = undefined;
+  let quotaCleared = 0;
+  if (target === "quota" || target === "all") {
+    state.accounts = state.accounts.map((account) => {
+      if (account.quotaExhaustedUntil === undefined)
+        return account;
+      quotaCleared++;
+      const { quotaExhaustedUntil: _quotaExhaustedUntil, ...restAccount } = account;
+      return restAccount;
+    });
+  }
+  const hiddenCleared = target === "all" ? state.removedAccountIds.length : 0;
+  if (target === "all")
+    state.removedAccountIds = [];
+  await saveUsageManagedState(state);
+  ctx.ui.notify(`reset: target=${target} manualCleared=${hadManual && !state.manualAccountId ? "yes" : "no"} quotaCleared=${quotaCleared} hiddenCleared=${hiddenCleared}`, "info");
+}
+async function runUsageSubcommand(subcommand, rest, ctx) {
+  if (subcommand === "use")
+    return runUsageUseSubcommand(ctx, rest);
+  if (subcommand === "show")
+    return runUsageShowSubcommand(ctx);
+  if (subcommand === "rotation")
+    return runUsageRotationSubcommand(ctx);
+  if (subcommand === "verify")
+    return runUsageVerifySubcommand(ctx);
+  if (subcommand === "path")
+    return runUsagePathSubcommand(ctx);
+  if (subcommand === "reset")
+    return runUsageResetSubcommand(ctx, rest);
+  ctx.ui.notify(USAGE_HELP_TEXT, "info");
+}
+const PARALLEL_WINDOW_MS = 2 * 60000;
+const PARALLEL_SESSION_THRESHOLD = 4;
+const LARGE_CONTEXT_THRESHOLD = 150000;
+const LARGE_CACHE_MISS_THRESHOLD = 1e5;
+const LONG_SESSION_MS = 8 * 60 * 60 * 1000;
+const TOP_SESSION_COUNT = 5;
+const MIN_MESSAGES_FOR_PARALLEL_INSIGHT = 10;
+const MIN_PERCENT_TO_SHOW = 1;
+function computeInsights(raw, longSessionIds) {
+  if (raw.messages.length === 0) {
+    return { insights: [] };
+  }
+  const total = raw.messages.reduce((sum, m) => sum + m.cost, 0);
+  if (total <= 0) {
+    return { insights: [] };
+  }
+  const candidates = [];
+  const parallelWeight = computeParallelCostWeight(raw.messages);
+  if (parallelWeight !== null) {
+    candidates.push({
+      percent: parallelWeight / total * 100,
+      headline: `of your cost was while ${PARALLEL_SESSION_THRESHOLD}+ sessions ran in parallel`,
+      advice: "All sessions share one rate limit. If you don't need them all at once, queueing uses capacity more evenly."
+    });
+  }
+  const largeContextWeight = raw.messages.filter((m) => m.input + m.cacheRead + m.cacheWrite > LARGE_CONTEXT_THRESHOLD).reduce((sum, m) => sum + m.cost, 0);
+  candidates.push({
+    percent: largeContextWeight / total * 100,
+    headline: `of your cost was at >${formatThresholdTokens(LARGE_CONTEXT_THRESHOLD)} context`,
+    advice: "Longer sessions are more expensive even when cached. /compact mid-task, /clear when switching to new tasks."
+  });
+  const uncachedWeight = raw.messages.filter((m) => m.input + m.cacheWrite > LARGE_CACHE_MISS_THRESHOLD).reduce((sum, m) => sum + m.cost, 0);
+  candidates.push({
+    percent: uncachedWeight / total * 100,
+    headline: `of your cost came from >${formatThresholdTokens(LARGE_CACHE_MISS_THRESHOLD)}-token uncached prompts`,
+    advice: "Uncached input is expensive, and often happens when sending a message to a session that has gone idle. /compact before stepping away keeps the cold-start small."
+  });
+  const longWeight = raw.messages.filter((m) => longSessionIds.has(m.sessionId)).reduce((sum, m) => sum + m.cost, 0);
+  if (longWeight > 0) {
+    candidates.push({
+      percent: longWeight / total * 100,
+      headline: `of your cost came from sessions active for ${LONG_SESSION_MS / 3600000}+ hours`,
+      advice: "These are often background/loop sessions. Continuous usage can add up quickly so make sure it is intentional."
+    });
+  }
+  if (raw.sessionCosts.size > TOP_SESSION_COUNT) {
+    const sortedSessions = Array.from(raw.sessionCosts.values()).sort((a, b) => b - a);
+    const topN = Math.min(TOP_SESSION_COUNT, sortedSessions.length);
+    const topWeight = sortedSessions.slice(0, topN).reduce((sum, c) => sum + c, 0);
+    candidates.push({
+      percent: topWeight / total * 100,
+      headline: `of your cost came from your top ${topN} session${topN === 1 ? "" : "s"}`,
+      advice: "A small number of sessions drives most of your spend. The table view can help pinpoint which ones."
+    });
+  }
+  const insights = candidates.filter((i) => i.percent >= MIN_PERCENT_TO_SHOW).sort((a, b) => b.percent - a.percent);
+  return { insights };
+}
+function computeParallelCostWeight(messages) {
+  const timed = messages.filter((m) => m.timestamp > 0);
+  if (timed.length < MIN_MESSAGES_FOR_PARALLEL_INSIGHT)
+    return null;
+  const distinctSessions = new Set(timed.map((m) => m.sessionId));
+  if (distinctSessions.size < PARALLEL_SESSION_THRESHOLD)
+    return null;
+  const sorted = timed.slice().sort((a, b) => a.timestamp - b.timestamp);
+  const sidCount = new Map;
+  let uniqueCount = 0;
+  let left = 0;
+  let right = 0;
+  let parallelCost = 0;
+  for (let i = 0;i < sorted.length; i++) {
+    const current = sorted[i];
+    const high = current.timestamp + PARALLEL_WINDOW_MS;
+    const low = current.timestamp - PARALLEL_WINDOW_MS;
+    while (right < sorted.length && sorted[right].timestamp <= high) {
+      const sid = sorted[right].sessionId;
+      const next = (sidCount.get(sid) ?? 0) + 1;
+      sidCount.set(sid, next);
+      if (next === 1)
+        uniqueCount++;
+      right++;
+    }
+    while (left < right && sorted[left].timestamp < low) {
+      const sid = sorted[left].sessionId;
+      const next = (sidCount.get(sid) ?? 0) - 1;
+      if (next === 0) {
+        sidCount.delete(sid);
+        uniqueCount--;
+      } else {
+        sidCount.set(sid, next);
+      }
+      left++;
+    }
+    if (uniqueCount >= PARALLEL_SESSION_THRESHOLD)
+      parallelCost += current.cost;
+  }
+  return parallelCost;
+}
+function formatThresholdTokens(n) {
+  if (n >= 1e6)
+    return `${n / 1e6}M`;
+  if (n >= 1000)
+    return `${n / 1000}k`;
+  return String(n);
+}
+function formatInsightPercent(p) {
+  if (p >= 10)
+    return `${Math.round(p)}%`;
+  return `${Math.round(p * 10) / 10}%`;
+}
+function formatCost(cost) {
+  if (cost === 0)
+    return "-";
+  if (cost < 0.01)
+    return `$${cost.toFixed(4)}`;
+  if (cost < 1)
+    return `$${cost.toFixed(2)}`;
+  if (cost < 10)
+    return `$${cost.toFixed(2)}`;
+  if (cost < 100)
+    return `$${cost.toFixed(1)}`;
+  return `$${Math.round(cost)}`;
+}
+function formatTokens(count) {
+  if (count === 0)
+    return "-";
+  if (count < 1000)
+    return count.toString();
+  if (count < 1e4)
+    return `${(count / 1000).toFixed(1)}k`;
+  if (count < 1e6)
+    return `${Math.round(count / 1000)}k`;
+  if (count < 1e7)
+    return `${(count / 1e6).toFixed(1)}M`;
+  return `${Math.round(count / 1e6)}M`;
+}
+function formatNumber(n) {
+  if (n === 0)
+    return "-";
+  return n.toLocaleString();
+}
+function padLeft(s, len) {
+  const vis = visibleWidth(s);
+  if (vis >= len)
+    return s;
+  return " ".repeat(len - vis) + s;
+}
+function padRight(s, len) {
+  const vis = visibleWidth(s);
+  if (vis >= len)
+    return s;
+  return s + " ".repeat(len - vis);
+}
+function sumColumnWidths(columns) {
+  return columns.reduce((sum, col) => sum + col.width, 0);
+}
+function fitCell(s, len, align = "left") {
+  if (len <= 0)
+    return "";
+  const truncated = truncateToWidth(s, len);
+  return align === "right" ? padLeft(truncated, len) : padRight(truncated, len);
+}
+function clampLines(lines, width) {
+  return lines.map((line) => truncateToWidth(line, Math.max(width, 0)));
+}
+function pickFittingText(width, variants) {
+  for (const variant of variants) {
+    if (visibleWidth(variant) <= width)
+      return variant;
+  }
+  return variants[variants.length - 1] || "";
+}
+function getTableLayout(width) {
+  const safeWidth = Math.max(width, 0);
+  for (const candidate of TABLE_LAYOUTS) {
+    const columnsWidth = sumColumnWidths(candidate.columns);
+    const nameWidth = Math.min(MAX_NAME_COL_WIDTH, Math.max(safeWidth - columnsWidth, 0));
+    if (nameWidth >= candidate.minNameWidth) {
+      return {
+        columns: candidate.columns,
+        nameWidth,
+        tableWidth: nameWidth + columnsWidth,
+        compact: candidate.compact ?? false
+      };
+    }
+  }
+  const fallback = TABLE_LAYOUTS[TABLE_LAYOUTS.length - 1];
+  const fallbackColumnsWidth = sumColumnWidths(fallback.columns);
+  const fallbackNameWidth = Math.min(MAX_NAME_COL_WIDTH, Math.max(safeWidth - fallbackColumnsWidth, 0));
+  return {
+    columns: fallback.columns,
+    nameWidth: fallbackNameWidth,
+    tableWidth: fallbackNameWidth + fallbackColumnsWidth,
+    compact: fallback.compact ?? false
+  };
+}
+function renderPanel(title, rows, width, theme) {
+  const safeWidth = Math.max(Math.floor(width), 0);
+  if (safeWidth < 12) {
+    return clampLines([theme.fg("accent", theme.bold(title)), ...rows, ""], safeWidth);
+  }
+  const innerWidth = Math.max(safeWidth - 2, 1);
+  const titleText = ` ${title} `;
+  const visibleTitle = truncateToWidth(titleText, Math.max(innerWidth - 1, 1), "");
+  const titleWidth = visibleWidth(visibleTitle);
+  const topRight = Math.max(innerWidth - titleWidth, 0);
+  const top = `╭${visibleTitle}${"─".repeat(topRight)}╮`;
+  const bottom = `╰${"─".repeat(innerWidth)}╯`;
+  const body = rows.length > 0 ? rows : [theme.fg("dim", "No data")];
+  return [
+    theme.fg("border", top),
+    ...body.map((line) => panelRow(line, innerWidth, theme)),
+    theme.fg("border", bottom),
+    ""
+  ];
+}
+function panelRow(content, innerWidth, theme) {
+  const fitted = truncateToWidth(content, innerWidth);
+  const padding = Math.max(innerWidth - visibleWidth(fitted), 0);
+  return `${theme.fg("border", "│")}${fitted}${" ".repeat(padding)}${theme.fg("border", "│")}`;
+}
+function renderSpendSparkline(dailySpend, maxWidth) {
+  if (dailySpend.size === 0)
+    return "No spend data";
+  const sortedDays = Array.from(dailySpend.keys()).sort();
+  const visibleDays = sortedDays.slice(-Math.max(1, Math.min(30, maxWidth)));
+  const values = visibleDays.map((day) => dailySpend.get(day) ?? 0);
+  const max = Math.max(...values);
+  if (max <= 0)
+    return "No spend";
+  const blocks = ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"];
+  return values.map((value) => {
+    const idx = Math.max(0, Math.min(blocks.length - 1, Math.ceil(value / max * blocks.length) - 1));
+    return blocks[idx];
+  }).join("");
+}
+function formatDailyAverage(stats) {
+  const days = stats.dailySpend.size;
+  if (days === 0)
+    return "avg/day -";
+  return `avg/day ${formatCost(stats.totals.cost / days)}`;
+}
+const TAB_LABELS = {
+  today: "Today",
+  thisWeek: "This Week",
+  lastWeek: "Last Week",
+  allTime: "All Time"
+};
+const TAB_ORDER = ["today", "thisWeek", "lastWeek", "allTime"];
+
+class UsageComponent {
+  activeTab = "allTime";
+  viewMode = "table";
+  data;
+  selectedIndex = 0;
+  expanded = new Set;
+  providerOrder = [];
+  theme;
+  requestRender;
+  done;
+  constructor(theme, data, requestRender, done) {
+    this.theme = theme;
+    this.requestRender = requestRender;
+    this.done = done;
+    this.data = data;
+    this.updateProviderOrder();
+  }
+  updateProviderOrder() {
+    const stats = this.data[this.activeTab];
+    this.providerOrder = Array.from(stats.providers.entries()).sort((a, b) => b[1].cost - a[1].cost).map(([name]) => name);
+    this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, this.providerOrder.length - 1));
+  }
+  handleInput(data) {
+    if (matchesKey(data, "escape") || matchesKey(data, "q")) {
+      this.done();
+      return;
+    }
+    if (matchesKey(data, "v")) {
+      this.viewMode = this.viewMode === "table" ? "insights" : "table";
+      this.requestRender();
+      return;
+    }
+    if (matchesKey(data, "tab") || matchesKey(data, "right")) {
+      const idx = TAB_ORDER.indexOf(this.activeTab);
+      this.activeTab = TAB_ORDER[(idx + 1) % TAB_ORDER.length];
+      this.updateProviderOrder();
+      this.requestRender();
+    } else if (matchesKey(data, "shift+tab") || matchesKey(data, "left")) {
+      const idx = TAB_ORDER.indexOf(this.activeTab);
+      this.activeTab = TAB_ORDER[(idx - 1 + TAB_ORDER.length) % TAB_ORDER.length];
+      this.updateProviderOrder();
+      this.requestRender();
+    } else if (this.viewMode === "table" && matchesKey(data, "up")) {
+      if (this.selectedIndex > 0) {
+        this.selectedIndex--;
+        this.requestRender();
+      }
+    } else if (this.viewMode === "table" && matchesKey(data, "down")) {
+      if (this.selectedIndex < this.providerOrder.length - 1) {
+        this.selectedIndex++;
+        this.requestRender();
+      }
+    } else if (this.viewMode === "table" && (matchesKey(data, "enter") || matchesKey(data, "space"))) {
+      const provider = this.providerOrder[this.selectedIndex];
+      if (provider) {
+        if (this.expanded.has(provider)) {
+          this.expanded.delete(provider);
+        } else {
+          this.expanded.add(provider);
+        }
+        this.requestRender();
+      }
+    }
+  }
+  render(width) {
+    if (this.viewMode === "insights") {
+      return clampLines([
+        ...this.renderTitle(width),
+        ...this.renderTabs(width, getTableLayout(width)),
+        ...this.renderSpendChart(width),
+        ...this.renderInsights(width),
+        ...this.renderHelp(width)
+      ], width);
+    }
+    const layout = getTableLayout(width);
+    return clampLines([
+      ...this.renderTitle(width),
+      ...this.renderTabs(width, layout),
+      ...this.renderHeader(layout),
+      ...this.renderRows(layout),
+      ...this.renderTotals(layout),
+      ...this.renderFormulaNote(width),
+      ...this.renderHelp(width)
+    ], width);
+  }
+  renderTitle(width) {
+    const th = this.theme;
+    const stats = this.data[this.activeTab];
+    const label = this.viewMode === "insights" ? "Usage Insights" : "Usage Statistics";
+    return renderPanel("DuckMind Usage", [
+      `${th.fg("accent", th.bold(label))} · ${TAB_LABELS[this.activeTab]}`,
+      `Spend ${formatCost(stats.totals.cost)} · ${formatNumber(stats.totals.messages)} messages · ${formatTokens(stats.totals.tokens.total)} tokens`,
+      `Providers ${formatNumber(stats.providers.size)} · Sessions ${formatNumber(stats.totals.sessions)} · ${formatDailyAverage(stats)}`
+    ], width, th);
+  }
+  renderSpendChart(width) {
+    const th = this.theme;
+    const stats = this.data[this.activeTab];
+    return renderPanel("Daily Spend", [
+      th.fg("accent", renderSpendSparkline(stats.dailySpend, Math.max(width - 4, 10))),
+      th.fg("dim", "Local session spend, last 30 active UTC days")
+    ], width, th);
+  }
+  renderInsights(width) {
+    const th = this.theme;
+    const stats = this.data[this.activeTab];
+    const { insights } = stats.insights;
+    const hasMessages = stats.totals.messages > 0;
+    const hasCost = stats.totals.cost > 0;
+    const lines = [];
+    lines.push("What's contributing to your cost?");
+    lines.push(th.fg("dim", "Approximate, based on local sessions on this machine."));
+    lines.push("");
+    const note = `${TAB_LABELS[this.activeTab]} · weighted by cost (USD) · these overlap and can sum to >100%`;
+    lines.push(th.fg("dim", note));
+    lines.push("");
+    if (!hasMessages) {
+      lines.push(th.fg("dim", "  No usage recorded for this period."));
+      lines.push("");
+      return lines;
+    }
+    if (!hasCost) {
+      lines.push(th.fg("dim", "  No cost data recorded for this period."));
+      lines.push("");
+      return lines;
+    }
+    if (insights.length === 0) {
+      lines.push(th.fg("dim", "  No insights above 1% for this period."));
+      lines.push("");
+      return lines;
+    }
+    const indent = "     ";
+    const adviceWidth = Math.max(width - indent.length, 30);
+    for (const insight of insights) {
+      const pct = th.fg("accent", th.bold(formatInsightPercent(insight.percent)));
+      lines.push(`${pct} ${insight.headline}`);
+      for (const wrapped of wrapTextWithAnsi(insight.advice, adviceWidth)) {
+        lines.push(`${indent}${th.fg("dim", wrapped)}`);
+      }
+      lines.push("");
+    }
+    return lines;
+  }
+  renderTabs(width, layout) {
+    const th = this.theme;
+    const fullTabs = TAB_ORDER.map((tab) => {
+      const label = TAB_LABELS[tab];
+      return tab === this.activeTab ? th.fg("accent", `[${label}]`) : th.fg("dim", ` ${label} `);
+    }).join("  ");
+    const activeTabOnly = th.fg("accent", `[${TAB_LABELS[this.activeTab]}]`);
+    const tabLine = pickFittingText(width, [
+      fullTabs,
+      `${activeTabOnly}  ${th.fg("dim", "[Tab/←→]")}`,
+      activeTabOnly
+    ]);
+    const infoLines = this.viewMode === "table" && layout.compact ? wrapTextWithAnsi(th.fg("dim", "Compact view. Widen the terminal for more columns."), Math.max(width, 1)) : [];
+    return [tabLine, ...infoLines, ""];
+  }
+  renderHeader(layout) {
+    const th = this.theme;
+    let headerLine = fitCell("Provider / Model", layout.nameWidth);
+    for (const col of layout.columns) {
+      const label = fitCell(col.label, col.width, "right");
+      headerLine += col.dimmed ? th.fg("dim", label) : label;
+    }
+    return [th.fg("muted", headerLine), th.fg("border", "─".repeat(layout.tableWidth))];
+  }
+  renderDataRow(name, stats, layout, options = {}) {
+    const th = this.theme;
+    const { indent = 0, selected = false, dimAll = false, prefix } = options;
+    const rawPrefix = prefix ?? " ".repeat(indent);
+    const safePrefix = layout.nameWidth > 0 ? truncateToWidth(rawPrefix, layout.nameWidth, "") : "";
+    const prefixWidth = visibleWidth(safePrefix);
+    const innerNameWidth = Math.max(layout.nameWidth - prefixWidth, 0);
+    const truncName = innerNameWidth > 0 ? truncateToWidth(name, innerNameWidth) : "";
+    const styledName = selected ? th.fg("accent", truncName) : dimAll ? th.fg("dim", truncName) : truncName;
+    let row = safePrefix + (innerNameWidth > 0 ? padRight(styledName, innerNameWidth) : "");
+    for (const col of layout.columns) {
+      const value = fitCell(col.getValue(stats), col.width, "right");
+      const shouldDim = col.dimmed || dimAll;
+      row += shouldDim ? th.fg("dim", value) : value;
+    }
+    return row;
+  }
+  renderRows(layout) {
+    const th = this.theme;
+    const stats = this.data[this.activeTab];
+    const lines = [];
+    if (this.providerOrder.length === 0) {
+      lines.push(th.fg("dim", "  No usage data for this period"));
+      return lines;
+    }
+    for (let i = 0;i < this.providerOrder.length; i++) {
+      const providerName = this.providerOrder[i];
+      const providerStats = stats.providers.get(providerName);
+      const isSelected = i === this.selectedIndex;
+      const isExpanded = this.expanded.has(providerName);
+      const arrow = isExpanded ? "▾" : "▸";
+      const prefix = isSelected ? th.fg("accent", `${arrow} `) : th.fg("dim", `${arrow} `);
+      lines.push(this.renderDataRow(formatProviderName(providerName), providerStats, layout, {
+        selected: isSelected,
+        prefix
+      }));
+      if (isExpanded) {
+        const models = Array.from(providerStats.models.entries()).sort((a, b) => b[1].cost - a[1].cost);
+        for (const [modelName, modelStats] of models) {
+          lines.push(this.renderDataRow(modelName, modelStats, layout, { indent: 4, dimAll: true }));
+        }
+      }
+    }
+    return lines;
+  }
+  renderTotals(layout) {
+    const th = this.theme;
+    const stats = this.data[this.activeTab];
+    let totalRow = fitCell(th.bold("Total"), layout.nameWidth);
+    for (const col of layout.columns) {
+      const value = fitCell(col.getValue(stats.totals), col.width, "right");
+      totalRow += col.dimmed ? th.fg("dim", value) : value;
+    }
+    return [th.fg("border", "─".repeat(layout.tableWidth)), totalRow, ""];
+  }
+  renderFormulaNote(width) {
+    const line = pickFittingText(width, [
+      "Tokens = Input + Output + CacheWrite  ·  ↑In = Input + CacheWrite  (as of 0.2.0)",
+      "Tokens = In + Out + CacheWrite  ·  ↑In = In + CacheWrite  (v0.2.0+)",
+      "Tokens & ↑In include CacheWrite (v0.2.0+)",
+      "Incl. CacheWrite (v0.2.0+)"
+    ]);
+    return [this.theme.fg("dim", line), ""];
+  }
+  renderHelp(width) {
+    const variants = this.viewMode === "insights" ? [
+      "[Tab/←→] period  [v] table view  [q] close",
+      "[Tab] period  [v] table  [q] close",
+      "[v] table  [q] close",
+      "[q] close"
+    ] : [
+      "[Tab/←→] period  [↑↓] select  [Enter] expand  [v] insights  [q] close",
+      "[Tab] period  [↑↓] select  [Enter] expand  [v] insights  [q] close",
+      "[↑↓] select  [Enter] expand  [v] insights  [q] close",
+      "[↑↓] select  [v] insights  [q] close",
+      "[↑↓] select  [q] close",
+      "[q] close"
+    ];
+    const line = pickFittingText(width, variants);
+    return [this.theme.fg("dim", line)];
+  }
+  invalidate() {}
+  dispose() {}
+}
+export default function dm_usage_default(pi) {
+  pi.registerCommand("usage", {
+    description: `Show usage statistics dashboard and account tools: ${USAGE_SUBCOMMANDS.join(", ")}`,
+    getArgumentCompletions: getUsageCommandCompletions,
+    handler: async (args, ctx) => {
+      const parsed = parseUsageCommandArgs(args);
+      if (parsed.subcommand) {
+        if (!isUsageSubcommand(parsed.subcommand)) {
+          ctx.ui.notify(`Unknown /usage subcommand: ${parsed.subcommand}
+${USAGE_HELP_TEXT}`, "warning");
+          return;
+        }
+        await runUsageSubcommand(parsed.subcommand, parsed.rest, ctx);
+        return;
+      }
+      if (!ctx.hasUI) {
+        await runUsageShowSubcommand(ctx);
+        return;
+      }
+      const data = await ctx.ui.custom((tui, theme, _kb, done) => {
+        const loader = new CancellableLoader(tui, (s) => theme.fg("accent", s), (s) => theme.fg("muted", s), "Loading Usage...");
+        let finished = false;
+        const finish = (value) => {
+          if (finished)
+            return;
+          finished = true;
+          loader.dispose();
+          done(value);
+        };
+        loader.onAbort = () => finish(null);
+        collectUsageData(loader.signal).then(finish).catch(() => finish(null));
+        return loader;
+      });
+      if (!data) {
+        return;
+      }
+      await ctx.ui.custom((tui, theme, _kb, done) => {
+        const container = new Container;
+        container.addChild(new Spacer(1));
+        container.addChild(new DynamicBorder((s) => theme.fg("border", s)));
+        container.addChild(new Spacer(1));
+        const usage = new UsageComponent(theme, data, () => tui.requestRender(), () => done());
+        return {
+          render: (w) => {
+            const borderLines = clampLines(container.render(w), w);
+            const usageLines = usage.render(w);
+            const bottomBorder = theme.fg("border", "─".repeat(w));
+            return clampLines([...borderLines, ...usageLines, "", bottomBorder], w);
+          },
+          invalidate: () => container.invalidate(),
+          handleInput: (input) => usage.handleInput(input),
+          dispose: () => {}
+        };
+      });
+    }
+  });
+}