linkshell-cli 0.5.16 → 0.5.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkshell-cli",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "Remote terminal bridge for Claude Code / Codex / Gemini / Copilot — control from your phone",
   "type": "module",
   "main": "dist/index.js",
@@ -36,8 +36,8 @@
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.18.1",
     "zod": "^3.24.3",
-    "@linkshell/gateway": "0.4.35",
-    "@linkshell/protocol": "0.4.7"
+    "@linkshell/protocol": "0.4.7",
+    "@linkshell/gateway": "0.4.36"
   },
   "optionalDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.128",

package/src/runtime/acp/agent-workspace.ts

@@ -1709,6 +1709,7 @@ export class AgentWorkspaceProxy {
       case "agent.v2.capabilities.request":
         await this.initialize();
         this.sendCapabilities();
+        this.sendUsageReport();
         break;
       case "agent.v2.conversation.open": {
         const payload = parseTypedPayload("agent.v2.conversation.open", envelope.payload);
@@ -1775,22 +1776,7 @@ export class AgentWorkspaceProxy {
         break;
       }
       case "agent.v2.usage.request": {
-        // Aggregate ALL on-disk transcripts (decoupled from live turns). The
-        // scan is synchronous (~3s over a large corpus); acceptable for an
-        // explicit, on-demand dashboard open. Errors must never break the
-        // session, so swallow + send an empty report.
-        try {
-          const report = aggregateUsage();
-          this.input.send(createEnvelope({
-            type: "agent.v2.usage.report",
-            sessionId: this.input.sessionId,
-            payload: report,
-          }));
-        } catch (error) {
-          if (this.input.verbose) {
-            process.stderr.write(`[agent:v2] usage aggregation failed: ${error instanceof Error ? error.message : String(error)}\n`);
-          }
-        }
+        this.sendUsageReport();
         break;
       }
       case "agent.v2.prompt": {
@@ -4282,6 +4268,27 @@ export class AgentWorkspaceProxy {
     }
     return firstString(raw, ["turnId", "id"]);
   }
+
+  // Fire-and-forget usage report — sent on init so the session list page shows
+  // summary cards without anyone clicking a button. First call scans disk (~3s)
+  // so it's deferred off the handler's critical path; cached (60s TTL)
+  // thereafter. Errors silently swallowed (best-effort, never blocks).
+  private sendUsageReport(): void {
+    setTimeout(() => {
+      try {
+        const report = aggregateUsage();
+        this.input.send(createEnvelope({
+          type: "agent.v2.usage.report",
+          sessionId: this.input.sessionId,
+          payload: report,
+        }));
+      } catch (error) {
+        if (this.input.verbose) {
+          process.stderr.write(`[agent:v2] usage aggregation failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+      }
+    }, 0);
+  }
 }
 
 function parsePermissionOptions(value: unknown): AgentPermission["options"] {

package/src/runtime/usage-report.ts

@@ -328,8 +328,15 @@ function ingestCodex(acc: Accumulator): number {
   return sessions;
 }
 
+let _cachedReport: UsageReport | null = null;
+let _cachedAt = 0;
+
 export function aggregateUsage(): UsageReport {
+  const now = Date.now();
+  if (_cachedReport && now - _cachedAt < 60_000) return _cachedReport;
   const acc = new Accumulator();
   const sessions = ingestClaude(acc) + ingestCodex(acc);
-  return acc.finish(sessions, Date.now());
+  _cachedReport = acc.finish(sessions, now);
+  _cachedAt = now;
+  return _cachedReport;
 }