@phren/cli 0.3.36 → 0.3.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/bridge/account-choice.d.ts +82 -0
  2. package/dist/bridge/account-choice.js +173 -0
  3. package/dist/bridge/account-failover.d.ts +61 -0
  4. package/dist/bridge/account-failover.js +189 -0
  5. package/dist/bridge/account-usage.d.ts +7 -2
  6. package/dist/bridge/account-usage.js +53 -8
  7. package/dist/bridge/agent-hooks.js +2 -0
  8. package/dist/bridge/changes.d.ts +5 -0
  9. package/dist/bridge/changes.js +4 -0
  10. package/dist/bridge/claude-accounts.d.ts +15 -4
  11. package/dist/bridge/claude-accounts.js +31 -16
  12. package/dist/bridge/claude-credits.d.ts +43 -0
  13. package/dist/bridge/claude-credits.js +236 -0
  14. package/dist/bridge/claude-question-dialog.js +6 -2
  15. package/dist/bridge/command.js +64 -3
  16. package/dist/bridge/device-enroll.d.ts +34 -0
  17. package/dist/bridge/device-enroll.js +57 -0
  18. package/dist/bridge/dispatch-command.d.ts +2 -0
  19. package/dist/bridge/dispatch-command.js +25 -1
  20. package/dist/bridge/dispatch-returns.d.ts +19 -0
  21. package/dist/bridge/dispatch-returns.js +93 -12
  22. package/dist/bridge/dispatch.d.ts +83 -3
  23. package/dist/bridge/dispatch.js +82 -10
  24. package/dist/bridge/file-range.d.ts +3 -0
  25. package/dist/bridge/file-range.js +5 -4
  26. package/dist/bridge/file-search.d.ts +37 -0
  27. package/dist/bridge/file-search.js +87 -0
  28. package/dist/bridge/file-write.d.ts +6 -0
  29. package/dist/bridge/file-write.js +120 -0
  30. package/dist/bridge/git-host-auth.d.ts +31 -0
  31. package/dist/bridge/git-host-auth.js +110 -0
  32. package/dist/bridge/git-host-gitboy.d.ts +46 -0
  33. package/dist/bridge/git-host-gitboy.js +296 -0
  34. package/dist/bridge/git-host-gitlab.d.ts +25 -0
  35. package/dist/bridge/git-host-gitlab.js +229 -0
  36. package/dist/bridge/git-host-http.d.ts +33 -0
  37. package/dist/bridge/git-host-http.js +70 -0
  38. package/dist/bridge/git-hosts.d.ts +92 -0
  39. package/dist/bridge/git-hosts.js +244 -0
  40. package/dist/bridge/git-publish.d.ts +15 -5
  41. package/dist/bridge/git-publish.js +69 -21
  42. package/dist/bridge/git-review.d.ts +23 -0
  43. package/dist/bridge/git-review.js +170 -0
  44. package/dist/bridge/git-sync.d.ts +14 -0
  45. package/dist/bridge/git-sync.js +143 -0
  46. package/dist/bridge/git.d.ts +20 -7
  47. package/dist/bridge/git.js +87 -68
  48. package/dist/bridge/gitboy-contract.d.ts +32 -0
  49. package/dist/bridge/gitboy-contract.js +46 -0
  50. package/dist/bridge/hand-off.d.ts +75 -3
  51. package/dist/bridge/hand-off.js +113 -27
  52. package/dist/bridge/health.d.ts +1 -1
  53. package/dist/bridge/health.js +5 -3
  54. package/dist/bridge/install.d.ts +14 -0
  55. package/dist/bridge/install.js +40 -1
  56. package/dist/bridge/launch-brief.d.ts +3 -0
  57. package/dist/bridge/launch-brief.js +16 -0
  58. package/dist/bridge/memory-store.d.ts +8 -0
  59. package/dist/bridge/memory-store.js +80 -2
  60. package/dist/bridge/pair.d.ts +6 -1
  61. package/dist/bridge/pair.js +74 -2
  62. package/dist/bridge/peers.js +4 -2
  63. package/dist/bridge/project-memory.d.ts +94 -0
  64. package/dist/bridge/project-memory.js +235 -0
  65. package/dist/bridge/push.d.ts +15 -0
  66. package/dist/bridge/push.js +39 -0
  67. package/dist/bridge/schedule-launch.js +5 -1
  68. package/dist/bridge/schedule-watch.d.ts +3 -0
  69. package/dist/bridge/schedule-watch.js +27 -1
  70. package/dist/bridge/scoped-gateway.d.ts +29 -0
  71. package/dist/bridge/scoped-gateway.js +239 -0
  72. package/dist/bridge/server-launch.d.ts +12 -0
  73. package/dist/bridge/server-launch.js +23 -12
  74. package/dist/bridge/server-pane-routes.js +54 -3
  75. package/dist/bridge/server-routes.d.ts +12 -0
  76. package/dist/bridge/server-routes.js +64 -5
  77. package/dist/bridge/server.js +50 -5
  78. package/dist/bridge/session-move.d.ts +288 -0
  79. package/dist/bridge/session-move.js +600 -0
  80. package/dist/bridge/subscription.d.ts +15 -0
  81. package/dist/bridge/subscription.js +23 -0
  82. package/dist/bridge/transport.js +21 -1
  83. package/dist/bridge/usage.d.ts +23 -4
  84. package/dist/bridge/usage.js +63 -11
  85. package/dist/bridge-hook.mjs +23280 -13252
  86. package/dist/cli/config.js +28 -2
  87. package/dist/cli-registry.js +10 -4
  88. package/dist/computers/command.js +3 -1
  89. package/dist/computers/read.d.ts +3 -0
  90. package/dist/computers/read.js +6 -0
  91. package/dist/content/summarize.d.ts +21 -0
  92. package/dist/content/summarize.js +56 -18
  93. package/dist/init/preferences.d.ts +6 -0
  94. package/dist/modules/registry.js +13 -13
  95. package/dist/project-config.d.ts +12 -0
  96. package/dist/project-config.js +29 -0
  97. package/dist/shared/retrieval.d.ts +1 -0
  98. package/dist/shared/retrieval.js +1 -1
  99. package/dist/sync/conflict-resolve.js +5 -6
  100. package/dist/tools/dispatch.js +20 -3
  101. package/dist/tools/finding.d.ts +25 -0
  102. package/dist/tools/finding.js +2 -1
  103. package/package.json +57 -1
@@ -1,5 +1,5 @@
1
1
  import { findPhrenPath } from "../phren-paths.js";
2
- import { HARNESS_NAMES, resetsIn, USAGE_SOURCES } from "../computers/read.js";
2
+ import { creditsText, HARNESS_NAMES, resetsIn, USAGE_SOURCES } from "../computers/read.js";
3
3
  import { hookRequest } from "./client.js";
4
4
  import { notLinkedFrom } from "./hand-off.js";
5
5
  import { optionalHookPeers, peerRequest } from "./peers.js";
@@ -13,7 +13,8 @@ export { NEAR_LIMIT_LEFT };
13
13
  * unreachable and unlinked computers listed apart.
14
14
  *
15
15
  * The merge follows the phone's cards: one account is one allowance whichever
16
- * computers report it, so the freshest whole report stands. Claude and Codex
16
+ * computers report it, so each window comes from the newest report that has
17
+ * it (`mergedWindows`). Claude and Codex
17
18
  * rows merge by their account key; a Claude login with no identity
18
19
  * (`claude:home:<id>`) stays per computer, since two unknown logins are not
19
20
  * one account. A window whose reset time has passed says `reset` and has no
@@ -29,7 +30,7 @@ export const STALE_AFTER_MS = 15 * 60_000;
29
30
  const SOURCES = USAGE_SOURCES.join(",");
30
31
  const USAGE_ROUTE = `/v1/usage?${new URLSearchParams({ sources: SOURCES, goPlan: "1", accounts: "all" })}`;
31
32
  const date = (value) => value ? Date.parse(value) : NaN;
32
- const hasData = (usage) => usage.windows.length > 0 || Boolean(usage.spend) || Boolean(usage.subscription);
33
+ const hasData = (usage) => usage.windows.length > 0 || Boolean(usage.spend) || Boolean(usage.subscription) || Boolean(usage.credits);
33
34
  const newer = (a, b) => (date(b.usage.updatedAt) || 0) > (date(a.usage.updatedAt) || 0) ? b : a;
34
35
  export function ageText(ms) {
35
36
  const minutes = Math.max(0, Math.round(ms / 60_000));
@@ -108,15 +109,17 @@ export function mergeAccountUsage(reports, now = Date.now()) {
108
109
  const source = group[0].usage.source;
109
110
  const subscriptions = group.filter(item => item.usage.subscription);
110
111
  const subscription = subscriptions.sort((a, b) => (date(b.usage.subscription?.checkedAt) || date(b.usage.updatedAt) || 0) - (date(a.usage.subscription?.checkedAt) || date(a.usage.updatedAt) || 0))[0]?.usage.subscription;
111
- // One allowance: the freshest report with windows stands whole, never mixed with another read.
112
112
  const withWindows = reporting.filter(item => item.usage.windows.length);
113
113
  const standing = (withWindows.length ? withWindows : reporting).reduce(newer);
114
- const windows = standing.usage.windows.map(window => settleWindow(window, now));
114
+ const windows = mergedWindows(withWindows).map(window => settleWindow(window, now));
115
115
  const spend = mergedSpend(source, reporting);
116
+ const withCredits = reporting.filter(item => item.usage.credits);
117
+ const credits = withCredits.length ? withCredits.reduce(newer).usage.credits : undefined;
116
118
  const updated = date(standing.usage.updatedAt);
117
119
  const leftPercent = roomLeft(windows);
118
120
  const exhausted = windows.filter(w => w.exhausted);
119
- const availableAt = exhausted.map(w => w.resetsAt).filter((value) => Boolean(value)).sort().at(-1);
121
+ // A credit's date is when it expires, not when it comes back.
122
+ const availableAt = exhausted.filter(w => !w.id.startsWith("credit:")).map(w => w.resetsAt).filter((value) => Boolean(value)).sort().at(-1);
120
123
  const availableIn = availableAt ? resetsIn(availableAt, now) : undefined;
121
124
  const name = accountName(standing.usage);
122
125
  const computers = reporting.map(item => ({ name: item.computer, ...(source === "claude" && item.usage.account?.id ? { account: item.usage.account.id } : {}) }))
@@ -128,6 +131,7 @@ export function mergeAccountUsage(reports, now = Date.now()) {
128
131
  exhausted: exhausted.length > 0, ...(availableIn ? { availableIn } : {}),
129
132
  ...(spend ? { spend } : {}),
130
133
  ...(subscription ? { subscription } : {}),
134
+ ...(credits ? { credits } : {}),
131
135
  ...(standing.usage.updatedAt ? { updatedAt: standing.usage.updatedAt } : {}),
132
136
  ...(Number.isFinite(updated) ? { age: ageText(now - updated) } : {}),
133
137
  stale: !Number.isFinite(updated) || now - updated > STALE_AFTER_MS || windows.some(w => w.reset),
@@ -142,6 +146,26 @@ export function mergeAccountUsage(reports, now = Date.now()) {
142
146
  .sort((a, b) => order(a.harness) - order(b.harness));
143
147
  return { accounts, noData };
144
148
  }
149
+ /**
150
+ * One account's windows across computers. Each window is taken from the
151
+ * newest report that has it, so a computer that has only seen the 5-hour
152
+ * window never hides the weekly one another computer reported. Between
153
+ * equally new reports the one with a reset time wins. The newest report's
154
+ * order leads; windows only older reports carry follow.
155
+ */
156
+ function mergedWindows(reports) {
157
+ const sorted = [...reports].sort((a, b) => (date(b.usage.updatedAt) || 0) - (date(a.usage.updatedAt) || 0));
158
+ const chosen = new Map();
159
+ for (const { usage } of sorted) {
160
+ const at = date(usage.updatedAt) || 0;
161
+ for (const window of usage.windows) {
162
+ const seen = chosen.get(window.id);
163
+ if (!seen || seen.at === at && !seen.window.resetsAt && window.resetsAt)
164
+ chosen.set(window.id, { window, at });
165
+ }
166
+ }
167
+ return [...chosen.values()].map(item => item.window);
168
+ }
145
169
  /** OpenCode's ledgers are per computer and add up; OpenRouter is one key seen from several, counted once per key. */
146
170
  function mergedSpend(source, reporting) {
147
171
  const spends = reporting.filter(item => item.usage.spend);
@@ -211,6 +235,9 @@ export function usageSummary(view) {
211
235
  const limitedRows = view.accounts.filter(row => row.leftPercent !== undefined || row.exhausted);
212
236
  if (limitedRows.length && limitedRows.every(row => row.exhausted))
213
237
  parts.push("Every account with limits is out of quota: tell the owner before dispatching.");
238
+ const claude = view.accounts.filter(row => row.harness === "claude" && claudeRoom(row));
239
+ if (claude.length)
240
+ parts.push(`Claude room: ${claude.map(row => `${title(row)} ${claudeRoom(row)}`).join("; ")}.`);
214
241
  const stale = view.accounts.filter(row => row.stale);
215
242
  if (stale.length)
216
243
  parts.push(`Stale: ${stale.map(row => `${title(row)} (${row.windows.some(w => w.reset) ? "a window reset since its report" : `reported ${row.age ? ago(row.age) : "at an unknown time"}`})`).join("; ")}.`);
@@ -220,6 +247,18 @@ export function usageSummary(view) {
220
247
  parts.push(`Not linked, so not checked: ${view.notLinked.map(item => item.name).join(", ")}.`);
221
248
  return parts.join(" ");
222
249
  }
250
+ /** "5-hour 82% left (resets in 2h 10m), weekly 64% left (resets in 3d 4h)": what launch and failover rank Claude accounts by. */
251
+ export function claudeRoom(row) {
252
+ const part = (id, name) => {
253
+ const w = row.windows.find(item => item.id === id);
254
+ if (!w)
255
+ return "";
256
+ if (w.reset)
257
+ return `${name} reset`;
258
+ return w.leftPercent === undefined ? "" : `${name} ${w.leftPercent}% left${w.resetsIn ? ` (resets in ${w.resetsIn})` : ""}`;
259
+ };
260
+ return [part("five_hour", "5-hour"), part("seven_day", "weekly")].filter(Boolean).join(", ");
261
+ }
223
262
  function tightest(row) {
224
263
  return row.windows.filter(w => w.leftPercent !== undefined).sort((a, b) => a.leftPercent - b.leftPercent)[0];
225
264
  }
@@ -236,9 +275,15 @@ export function formatAccountUsage(view) {
236
275
  lines.push(` ${[sub.plan, sub.startedAt ? `since ${sub.startedAt.slice(0, 10)}` : "", sub.renewsAt ? `renews ${sub.renewsEstimated ? "about " : ""}${sub.renewsAt.slice(0, 10)}` : ""].filter(Boolean).join(" · ")}`);
237
276
  }
238
277
  for (const w of row.windows) {
239
- const used = w.reset ? "reset, no new report" : w.usedPercent !== undefined ? `${w.usedPercent}% used` : w.usedUSD !== undefined ? `$${w.usedUSD.toFixed(2)}${w.limitUSD !== undefined ? ` of $${w.limitUSD.toFixed(2)}` : ""}` : "";
240
- lines.push(` ${w.name.padEnd(30)} ${used.padEnd(22)}${w.limited ? "limited now " : ""}${w.resetsIn ? `resets in ${w.resetsIn}` : ""}`.trimEnd());
278
+ if (w.id.startsWith("credit:") && w.usedUSD !== undefined && w.limitUSD !== undefined) {
279
+ lines.push(` ${w.name.padEnd(30)} $${w.usedUSD.toFixed(2)} of $${w.limitUSD.toFixed(2)}, about $${Math.max(0, w.limitUSD - w.usedUSD).toFixed(2)} left${w.resetsAt ? ` expires ${w.resetsAt.slice(0, 10)}` : ""}`);
280
+ continue;
281
+ }
282
+ const used = w.reset ? "reset, no new report" : w.usedPercent !== undefined ? `${w.usedPercent}% used${w.leftPercent !== undefined ? `, ${w.leftPercent}% left` : ""}` : w.usedUSD !== undefined ? `$${w.usedUSD.toFixed(2)}${w.limitUSD !== undefined ? ` of $${w.limitUSD.toFixed(2)}` : ""}` : "";
283
+ lines.push(` ${w.name.padEnd(30)} ${used.padEnd(22)}${w.limited ? "limited now " : ""}${w.resetsIn ? `resets in ${w.resetsIn}${w.resetsAt ? ` (${w.resetsAt.slice(0, 16).replace("T", " ")} UTC)` : ""}` : ""}`.trimEnd());
241
284
  }
285
+ if (row.credits?.hasCredits)
286
+ lines.push(` credits${" ".repeat(24)}${creditsText(row.credits)}`);
242
287
  if (row.spend)
243
288
  lines.push(` spend ${row.spend.period.replace(/_/g, " ").padEnd(24)} $${row.spend.amountUSD.toFixed(2)}`);
244
289
  if (row.message)
@@ -234,6 +234,8 @@ export class AgentHooks {
234
234
  this.push = push;
235
235
  this.modules = modules;
236
236
  this.deliveries = new PromptDeliveries(deliveriesFile);
237
+ // A push held while the owner was at the desktop is sent only if still unanswered.
238
+ push.stillPending = binding => this.pushTarget(binding) !== undefined;
237
239
  void computerDisplayName().then(name => { this.computerName = name; }, () => { });
238
240
  this.sudo = new SudoBroker({ computer: () => this.computerName, push, label: briefLabel,
239
241
  describe: async (place) => {
@@ -61,6 +61,11 @@ export declare class ToolChanges {
61
61
  private cache;
62
62
  private load;
63
63
  private record;
64
+ /** Every change this conversation's tool calls recorded, oldest first. */
65
+ history(conversation: string): Promise<{
66
+ toolUseId: string;
67
+ files: ChangedFile[];
68
+ }[]>;
64
69
  recordedPaths(conversation: string): Promise<string[]>;
65
70
  view(conversation: string): ChangeLookup;
66
71
  }
@@ -425,6 +425,10 @@ export class ToolChanges {
425
425
  await appendFile(file, line, { mode: 0o600 });
426
426
  this.onRecord?.(files);
427
427
  }
428
+ /** Every change this conversation's tool calls recorded, oldest first. */
429
+ async history(conversation) {
430
+ return [...(await this.load(conversation)).files.entries()].filter(([, files]) => files.length).map(([toolUseId, files]) => ({ toolUseId, files }));
431
+ }
428
432
  async recordedPaths(conversation) {
429
433
  return [...new Set([...(await this.load(conversation)).files.values()].flatMap(files => files.flatMap(file => [file.root, path.resolve(file.root, file.path)])))];
430
434
  }
@@ -29,12 +29,22 @@ export declare function claudeHomeOfEnv(value: string | undefined, env?: NodeJS.
29
29
  export declare const accountsFile: () => string;
30
30
  export declare function accountLabel(id: string, labels?: Record<string, string>): string;
31
31
  export declare function setAccountLabel(id: string, label: string): Promise<void>;
32
- /** Stable across computers for one subscription; home-scoped when unknown. */
32
+ /**
33
+ * Stable across computers for one subscription; home-scoped when unknown.
34
+ * One login can belong to several organizations (a personal plan and a Team
35
+ * seat), each its own allowance, so the organization is part of the key.
36
+ */
33
37
  export declare function claudeAccountKey(home: ClaudeHome): string;
34
38
  /** The login's email, so the phone can name a card merged across computers. Usage rows only. */
35
39
  export declare function claudeAccountEmail(home: ClaudeHome): string | undefined;
36
- /** The account home's own subscription, independent of the quota snapshot's age. */
37
- export declare function claudeAccountSubscription(home: ClaudeHome, now?: Date): Subscription | undefined;
40
+ /** A login is recorded but its profile names no plan Phren knows. */
41
+ export declare function claudePlanUnknown(home: ClaudeHome): boolean;
42
+ /**
43
+ * The account home's own subscription, independent of the quota snapshot's
44
+ * age. `checkedAt` is when Claude Code last fetched the profile, so the
45
+ * newest profile wins when computers disagree about a plan that changed.
46
+ */
47
+ export declare function claudeAccountSubscription(home: ClaudeHome, now?: Date, fallbackPlan?: string): Subscription | undefined;
38
48
  export declare function claudeAccountRef(home: ClaudeHome, labels?: Record<string, string>): AccountRef;
39
49
  export declare const CODEX_ACCOUNT: AccountRef;
40
50
  /** Only for tests. */
@@ -44,7 +54,8 @@ export interface AuthStatus {
44
54
  signedIn: boolean;
45
55
  unknown?: boolean;
46
56
  plan?: string;
47
- reason?: string;
57
+ reason?: string; /** Signed in with a Console (API billing) login. */
58
+ console?: boolean;
48
59
  }
49
60
  /** Parse `claude auth status --json`. Never keeps anything but the state and plan. */
50
61
  export declare function parseAuthStatus(output: string): AuthStatus;
@@ -10,7 +10,7 @@ import path from "node:path";
10
10
  import { dump, load } from "js-yaml";
11
11
  import { claudeConfigDir, homeDir } from "../home-paths.js";
12
12
  import { atomic, bridgeRoot } from "./protocol.js";
13
- import { monthlyAnniversary, planName, subscriptionDate } from "./subscription.js";
13
+ import { claudePlan, monthlyAnniversary, subscriptionDate } from "./subscription.js";
14
14
  export const DEFAULT_ACCOUNT = "default";
15
15
  const SLUG = /^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$/;
16
16
  export function isAccountSlug(value) { return value === DEFAULT_ACCOUNT || SLUG.test(value); }
@@ -114,7 +114,6 @@ export async function setAccountLabel(id, label) {
114
114
  await mkdir(bridgeRoot(), { recursive: true, mode: 0o700 });
115
115
  await atomic(accountsFile(), dump(parsed), 0o600);
116
116
  }
117
- // ── identity (.claude.json oauthAccount, no tokens) ─────────────────────────
118
117
  const identityCache = new Map();
119
118
  function oauthIdentity(configFile) {
120
119
  try {
@@ -126,12 +125,11 @@ function oauthIdentity(configFile) {
126
125
  return cached;
127
126
  const config = JSON.parse(readFileSync(configFile, "utf8"));
128
127
  const account = config.oauthAccount && typeof config.oauthAccount === "object" ? config.oauthAccount : {};
129
- const uuid = typeof account.accountUuid === "string" && account.accountUuid ? account.accountUuid : undefined;
128
+ const id = (value) => typeof value === "string" && /^[A-Za-z0-9-]{1,64}$/.test(value) ? value : undefined;
130
129
  const email = typeof account.emailAddress === "string" && /^[^\s@]{1,64}@[^\s@]{1,190}$/.test(account.emailAddress) ? account.emailAddress : undefined;
131
- const tier = planName(account.organizationRateLimitTier);
132
- const billing = typeof account.billingType === "string" && /^(?:claude_)?(?:pro|max|team|enterprise)(?:_subscription)?$/.test(account.billingType)
133
- ? planName(account.billingType.replace(/_subscription$/, "")) : undefined;
134
- const value = { mtimeMs: stat.mtimeMs, size: stat.size, uuid, email, plan: tier ?? billing, startedAt: subscriptionDate(account.subscriptionCreatedAt) };
130
+ const fetched = typeof account.profileFetchedAt === "number" ? subscriptionDate(Math.floor(account.profileFetchedAt / 1000)) : undefined;
131
+ const value = { mtimeMs: stat.mtimeMs, size: stat.size, uuid: id(account.accountUuid), email, organization: id(account.organizationUuid),
132
+ plan: claudePlan(account), startedAt: subscriptionDate(account.subscriptionCreatedAt), checkedAt: fetched };
135
133
  identityCache.set(configFile, value);
136
134
  return value;
137
135
  }
@@ -139,20 +137,37 @@ function oauthIdentity(configFile) {
139
137
  return {};
140
138
  }
141
139
  }
142
- /** Stable across computers for one subscription; home-scoped when unknown. */
140
+ /**
141
+ * Stable across computers for one subscription; home-scoped when unknown.
142
+ * One login can belong to several organizations (a personal plan and a Team
143
+ * seat), each its own allowance, so the organization is part of the key.
144
+ */
143
145
  export function claudeAccountKey(home) {
144
- const { uuid } = oauthIdentity(home.configFile);
145
- return uuid ? "claude:" + createHash("sha256").update(uuid).digest("hex").slice(0, 12) : `claude:home:${home.id}`;
146
+ const { uuid, email, organization } = oauthIdentity(home.configFile);
147
+ const login = uuid ?? email;
148
+ if (!login)
149
+ return `claude:home:${home.id}`;
150
+ return "claude:" + createHash("sha256").update(organization ? `${login}|${organization}` : login).digest("hex").slice(0, 12);
146
151
  }
147
152
  /** The login's email, so the phone can name a card merged across computers. Usage rows only. */
148
153
  export function claudeAccountEmail(home) { return oauthIdentity(home.configFile).email; }
149
- /** The account home's own subscription, independent of the quota snapshot's age. */
150
- export function claudeAccountSubscription(home, now = new Date()) {
151
- const { plan, startedAt } = oauthIdentity(home.configFile);
154
+ /** A login is recorded but its profile names no plan Phren knows. */
155
+ export function claudePlanUnknown(home) {
156
+ const identity = oauthIdentity(home.configFile);
157
+ return Boolean(identity.uuid ?? identity.email) && !identity.plan;
158
+ }
159
+ /**
160
+ * The account home's own subscription, independent of the quota snapshot's
161
+ * age. `checkedAt` is when Claude Code last fetched the profile, so the
162
+ * newest profile wins when computers disagree about a plan that changed.
163
+ */
164
+ export function claudeAccountSubscription(home, now = new Date(), fallbackPlan) {
165
+ const { plan: profilePlan, startedAt, checkedAt } = oauthIdentity(home.configFile);
166
+ const plan = profilePlan ?? fallbackPlan;
152
167
  if (!plan)
153
168
  return undefined;
154
- const renewsAt = startedAt ? monthlyAnniversary(startedAt, now) : undefined;
155
- return { plan, ...(startedAt ? { startedAt } : {}), ...(renewsAt ? { renewsAt, renewsEstimated: true } : {}), checkedAt: now.toISOString() };
169
+ const renewsAt = startedAt && profilePlan ? monthlyAnniversary(startedAt, now) : undefined;
170
+ return { plan, ...(startedAt && profilePlan ? { startedAt } : {}), ...(renewsAt ? { renewsAt, renewsEstimated: true } : {}), checkedAt: checkedAt ?? now.toISOString() };
156
171
  }
157
172
  export function claudeAccountRef(home, labels = readLabels()) {
158
173
  return { id: home.id, label: accountLabel(home.id, labels), key: claudeAccountKey(home) };
@@ -171,7 +186,7 @@ export function parseAuthStatus(output) {
171
186
  if (value.loggedIn !== true)
172
187
  return { signedIn: false, reason: "Not signed in" };
173
188
  const plan = typeof value.subscriptionType === "string" && /^[a-z0-9_-]{1,32}$/i.test(value.subscriptionType) ? value.subscriptionType : undefined;
174
- return { signedIn: true, ...(plan ? { plan } : {}) };
189
+ return { signedIn: true, ...(plan ? { plan } : {}), ...(value.authMethod === "console" ? { console: true } : {}) };
175
190
  }
176
191
  catch {
177
192
  return { signedIn: false, unknown: true, reason: "Claude did not report its sign-in state" };
@@ -0,0 +1,43 @@
1
+ import { type ClaudeHome } from "./claude-accounts.js";
2
+ import type { UsageWindow } from "./usage.js";
3
+ export interface ClaudeCredit {
4
+ /** Short id derived from the entry, for `--remove`. */
5
+ id: string;
6
+ amountUSD: number;
7
+ /** Spend counts from this day (UTC midnight). */
8
+ since: string;
9
+ expiresAt?: string;
10
+ label?: string;
11
+ }
12
+ /** One session's cost as Claude Code reported it, and when the session began. */
13
+ export interface SessionCost {
14
+ costUSD: number;
15
+ startedAt: string;
16
+ }
17
+ /** The credits entered for one Claude home, in `<bridge>/accounts.yaml` under `credits`. */
18
+ export declare function claudeCredits(home: string): ClaudeCredit[];
19
+ /** `phren bridge accounts credit <id> --amount <usd> [--expires <date>] [--since <date>] [--label <name>]`. */
20
+ export declare function addClaudeCredit(home: string, entry: {
21
+ amount: string;
22
+ expires?: string;
23
+ since?: string;
24
+ label?: string;
25
+ }, now?: Date): Promise<ClaudeCredit>;
26
+ export declare function removeClaudeCredit(home: string, id: string): Promise<boolean>;
27
+ /** Per-session costs from the status line, kept only for homes with a credit. */
28
+ export declare const costLedgerFile: (home: ClaudeHome) => string;
29
+ /** Record one status-line render: the session's running total only grows, so the largest seen stands. */
30
+ export declare function recordSessionCost(home: ClaudeHome, payload: unknown, now?: Date): Promise<void>;
31
+ /**
32
+ * Every session cost known for a home: the status-line ledger, plus the
33
+ * `lastCost` Claude Code keeps per project in the home's `.claude.json`
34
+ * (which also covers sessions with no status line), dated by the session's
35
+ * transcript. The larger figure for one session stands.
36
+ */
37
+ export declare function homeSessionCosts(home: ClaudeHome): Record<string, SessionCost>;
38
+ /**
39
+ * One window per live credit: spend is drawn from the credit that expires
40
+ * first among those active when the session began, overflowing to the next.
41
+ * Expired credits are left out. The window's `resetsAt` is the expiry.
42
+ */
43
+ export declare function creditWindows(credits: readonly ClaudeCredit[], sessions: Record<string, SessionCost>, now?: Date): UsageWindow[];
@@ -0,0 +1,236 @@
1
+ // API credits for Claude homes signed in with a Console login: the owner
2
+ // enters each credit once (amount, optional expiry and label) and the Hook
3
+ // estimates what is left from Claude Code's own per-session cost under that
4
+ // home. Opt-in: with no credit entered nothing is recorded or shown.
5
+ // The estimate never reads billing; it can drift from the Console's balance.
6
+ import { createHash } from "node:crypto";
7
+ import { readFileSync, readdirSync, statSync } from "node:fs";
8
+ import { mkdir, readFile } from "node:fs/promises";
9
+ import path from "node:path";
10
+ import { dump, load } from "js-yaml";
11
+ import { atomic, atomicInPrivateDir, bridgeRoot, object } from "./protocol.js";
12
+ import { accountsFile, isAccountSlug } from "./claude-accounts.js";
13
+ const MAX_CREDITS = 16;
14
+ const MAX_SESSIONS = 4000;
15
+ const DAY = /^\d{4}-\d{2}-\d{2}$/;
16
+ const day = (value, what) => {
17
+ if (!DAY.test(value) || !Number.isFinite(Date.parse(`${value}T00:00:00Z`)))
18
+ throw new Error(`${what} is a date like 2026-12-31.`);
19
+ return new Date(`${value}T00:00:00Z`).toISOString();
20
+ };
21
+ function readYaml(text) {
22
+ try {
23
+ const parsed = text === undefined ? undefined : load(text);
24
+ return parsed && typeof parsed === "object" ? parsed : {};
25
+ }
26
+ catch {
27
+ return {};
28
+ }
29
+ }
30
+ function creditsOf(parsed, home) {
31
+ const list = object(parsed.credits)[home];
32
+ if (!Array.isArray(list))
33
+ return [];
34
+ return list.slice(0, MAX_CREDITS).flatMap((raw) => {
35
+ const item = object(raw);
36
+ const amountUSD = item.amountUSD, since = item.since;
37
+ if (typeof item.id !== "string" || typeof amountUSD !== "number" || !Number.isFinite(amountUSD) || amountUSD <= 0
38
+ || typeof since !== "string" || !Number.isFinite(Date.parse(since)))
39
+ return [];
40
+ const expires = typeof item.expiresAt === "string" && Number.isFinite(Date.parse(item.expiresAt)) ? item.expiresAt : undefined;
41
+ const label = typeof item.label === "string" && item.label.trim() ? item.label.trim().slice(0, 40) : undefined;
42
+ return [{ id: item.id.slice(0, 16), amountUSD, since, ...(expires ? { expiresAt: expires } : {}), ...(label ? { label } : {}) }];
43
+ });
44
+ }
45
+ /** The credits entered for one Claude home, in `<bridge>/accounts.yaml` under `credits`. */
46
+ export function claudeCredits(home) {
47
+ let text;
48
+ try {
49
+ text = readFileSync(accountsFile(), "utf8");
50
+ }
51
+ catch {
52
+ return [];
53
+ }
54
+ return creditsOf(readYaml(text), home);
55
+ }
56
+ async function updateCredits(home, change) {
57
+ if (!isAccountSlug(home))
58
+ throw new Error(`"${home}" is not an account name: use lowercase letters, digits and dashes.`);
59
+ let text;
60
+ try {
61
+ text = await readFile(accountsFile(), "utf8");
62
+ }
63
+ catch { /* First entry. */ }
64
+ const parsed = readYaml(text);
65
+ const next = change(creditsOf(parsed, home));
66
+ const credits = { ...object(parsed.credits) };
67
+ if (next.length)
68
+ credits[home] = next;
69
+ else
70
+ delete credits[home];
71
+ parsed.credits = credits;
72
+ if (!Object.keys(credits).length)
73
+ delete parsed.credits;
74
+ await mkdir(bridgeRoot(), { recursive: true, mode: 0o700 });
75
+ await atomic(accountsFile(), dump(parsed), 0o600);
76
+ return next;
77
+ }
78
+ /** `phren bridge accounts credit <id> --amount <usd> [--expires <date>] [--since <date>] [--label <name>]`. */
79
+ export async function addClaudeCredit(home, entry, now = new Date()) {
80
+ const amountUSD = Number(entry.amount.replace(/^\$/, ""));
81
+ if (!Number.isFinite(amountUSD) || amountUSD <= 0 || amountUSD > 1_000_000)
82
+ throw new Error("--amount is the credit in US dollars, like 200.");
83
+ const label = entry.label?.trim();
84
+ if (label !== undefined && (!label || label.length > 40 || /[\u0000-\u001f]/.test(label)))
85
+ throw new Error("A label is 1 to 40 printable characters.");
86
+ const since = entry.since ? day(entry.since, "--since") : new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())).toISOString();
87
+ // A credit lasts through its expiry day.
88
+ const expiresAt = entry.expires ? new Date(Date.parse(day(entry.expires, "--expires")) + 86_400_000 - 1000).toISOString() : undefined;
89
+ if (expiresAt && expiresAt <= since)
90
+ throw new Error("--expires is after --since.");
91
+ const id = createHash("sha256").update(`${home}|${amountUSD}|${since}|${expiresAt ?? ""}|${label ?? ""}`).digest("hex").slice(0, 8);
92
+ const credit = { id, amountUSD, since, ...(expiresAt ? { expiresAt } : {}), ...(label ? { label } : {}) };
93
+ await updateCredits(home, list => {
94
+ if (list.some(item => item.id === id))
95
+ return list;
96
+ if (list.length >= MAX_CREDITS)
97
+ throw new Error(`An account holds at most ${MAX_CREDITS} credits; remove one first.`);
98
+ return [...list, credit];
99
+ });
100
+ return credit;
101
+ }
102
+ export async function removeClaudeCredit(home, id) {
103
+ let removed = false;
104
+ await updateCredits(home, list => list.filter(item => item.id === id ? (removed = true, false) : true));
105
+ return removed;
106
+ }
107
+ // ── spend (Claude Code's own per-session cost) ──────────────────────────────
108
+ /** Per-session costs from the status line, kept only for homes with a credit. */
109
+ export const costLedgerFile = (home) => path.join(bridgeRoot(), "usage", home.isDefault ? "claude-cost.json" : `claude-cost-${home.id}.json`);
110
+ function readLedger(file) {
111
+ try {
112
+ const stat = statSync(file);
113
+ if (!stat.isFile() || stat.size > 1_048_576)
114
+ return {};
115
+ const sessions = object(object(JSON.parse(readFileSync(file, "utf8"))).sessions);
116
+ return Object.fromEntries(Object.entries(sessions).flatMap(([id, raw]) => {
117
+ const item = object(raw);
118
+ return typeof item.costUSD === "number" && Number.isFinite(item.costUSD) && item.costUSD >= 0 && typeof item.startedAt === "string"
119
+ ? [[id, { costUSD: item.costUSD, startedAt: item.startedAt }]] : [];
120
+ }));
121
+ }
122
+ catch {
123
+ return {};
124
+ }
125
+ }
126
+ /** Record one status-line render: the session's running total only grows, so the largest seen stands. */
127
+ export async function recordSessionCost(home, payload, now = new Date()) {
128
+ if (!claudeCredits(home.id).length)
129
+ return;
130
+ const value = object(payload);
131
+ const session = typeof value.session_id === "string" && /^[A-Za-z0-9-]{1,64}$/.test(value.session_id) ? value.session_id : undefined;
132
+ const cost = object(value.cost).total_cost_usd;
133
+ if (!session || typeof cost !== "number" || !Number.isFinite(cost) || cost < 0 || cost > 100_000)
134
+ return;
135
+ const file = costLedgerFile(home);
136
+ const sessions = readLedger(file);
137
+ const seen = sessions[session];
138
+ if (seen && seen.costUSD >= cost)
139
+ return;
140
+ sessions[session] = { costUSD: cost, startedAt: seen?.startedAt ?? now.toISOString() };
141
+ const kept = Object.entries(sessions).sort(([, a], [, b]) => b.startedAt.localeCompare(a.startedAt)).slice(0, MAX_SESSIONS);
142
+ await atomicInPrivateDir(file, JSON.stringify({ sessions: Object.fromEntries(kept) }));
143
+ }
144
+ /**
145
+ * Every session cost known for a home: the status-line ledger, plus the
146
+ * `lastCost` Claude Code keeps per project in the home's `.claude.json`
147
+ * (which also covers sessions with no status line), dated by the session's
148
+ * transcript. The larger figure for one session stands.
149
+ */
150
+ export function homeSessionCosts(home) {
151
+ const sessions = readLedger(costLedgerFile(home));
152
+ let projects = {};
153
+ try {
154
+ const stat = statSync(home.configFile);
155
+ if (stat.isFile() && stat.size <= 16_777_216)
156
+ projects = object(object(JSON.parse(readFileSync(home.configFile, "utf8"))).projects);
157
+ }
158
+ catch { /* No config: the ledger stands alone. */ }
159
+ const wanted = new Map();
160
+ for (const raw of Object.values(projects)) {
161
+ const project = object(raw);
162
+ const id = project.lastSessionId, cost = project.lastCost;
163
+ if (typeof id === "string" && /^[A-Za-z0-9-]{1,64}$/.test(id) && typeof cost === "number" && Number.isFinite(cost) && cost > 0)
164
+ wanted.set(id, cost);
165
+ }
166
+ if (wanted.size) {
167
+ const started = transcriptTimes(path.join(home.dir, "projects"), new Set(wanted.keys()));
168
+ for (const [id, cost] of wanted) {
169
+ const startedAt = sessions[id]?.startedAt ?? started.get(id);
170
+ if (!startedAt)
171
+ continue;
172
+ if (!sessions[id] || sessions[id].costUSD < cost)
173
+ sessions[id] = { costUSD: cost, startedAt };
174
+ }
175
+ }
176
+ return sessions;
177
+ }
178
+ /** When each wanted session's transcript was created, from `<home>/projects/<folder>/<session>.jsonl`. */
179
+ function transcriptTimes(root, wanted) {
180
+ const found = new Map();
181
+ let folders = [];
182
+ try {
183
+ folders = readdirSync(root);
184
+ }
185
+ catch {
186
+ return found;
187
+ }
188
+ for (const folder of folders.slice(0, 2000)) {
189
+ for (const id of wanted) {
190
+ if (found.has(id))
191
+ continue;
192
+ try {
193
+ const stat = statSync(path.join(root, folder, `${id}.jsonl`));
194
+ const time = stat.birthtimeMs > 0 ? stat.birthtimeMs : stat.mtimeMs;
195
+ found.set(id, new Date(time).toISOString());
196
+ }
197
+ catch { /* Not in this folder. */ }
198
+ }
199
+ if (found.size === wanted.size)
200
+ break;
201
+ }
202
+ return found;
203
+ }
204
+ /**
205
+ * One window per live credit: spend is drawn from the credit that expires
206
+ * first among those active when the session began, overflowing to the next.
207
+ * Expired credits are left out. The window's `resetsAt` is the expiry.
208
+ */
209
+ export function creditWindows(credits, sessions, now = new Date()) {
210
+ const ordered = [...credits].sort((a, b) => (a.expiresAt ?? "9999").localeCompare(b.expiresAt ?? "9999") || a.since.localeCompare(b.since));
211
+ const used = new Map(ordered.map(credit => [credit.id, 0]));
212
+ const spend = Object.values(sessions).sort((a, b) => a.startedAt.localeCompare(b.startedAt));
213
+ for (const session of spend) {
214
+ let cost = session.costUSD;
215
+ for (const credit of ordered) {
216
+ if (cost <= 0)
217
+ break;
218
+ if (session.startedAt < credit.since || credit.expiresAt && session.startedAt > credit.expiresAt)
219
+ continue;
220
+ const take = Math.min(cost, credit.amountUSD - used.get(credit.id));
221
+ if (take <= 0)
222
+ continue;
223
+ used.set(credit.id, used.get(credit.id) + take);
224
+ cost -= take;
225
+ }
226
+ }
227
+ const round = (value) => Math.round(value * 100) / 100;
228
+ return ordered.filter(credit => !credit.expiresAt || Date.parse(credit.expiresAt) > now.getTime()).map(credit => {
229
+ const usedUSD = round(used.get(credit.id));
230
+ return {
231
+ id: `credit:${credit.id}`, name: `API credit${credit.label ? ` · ${credit.label}` : ""}, estimate`,
232
+ usedUSD, limitUSD: credit.amountUSD, usedPercent: Math.min(100, Math.round(usedUSD / credit.amountUSD * 100)),
233
+ ...(credit.expiresAt ? { resetsAt: credit.expiresAt } : {}), asOf: now.toISOString(),
234
+ };
235
+ });
236
+ }
@@ -3,6 +3,10 @@ const TAB_BAR = /^\s*(?:←\s+)?((?:[☐☒]\s+\S[^☐☒✔→]*?\s*)+)(?:✔\s
3
3
  const ROW = /^\s*(❯)?\s*(\d)\.\s+(?:\[([ ✔])\]\s+)?(.*?)\s*$/;
4
4
  const NEXT = /^\s*(❯)?\s+(?:Next|Submit)\s*$/;
5
5
  const normalize = (text) => text.replace(/\s+/g, " ").trim();
6
+ /** Claude Code (2.1.284) draws a question that has a line break or is wider
7
+ * than 80 columns inside a dimmed left border, "│ " before each line, on its
8
+ * tab and in the review. The border is not part of the question. */
9
+ const GUTTER = /^(\s*)│(?: |$)/;
6
10
  /** The question dialog the pane is drawing now, or undefined when the last
7
11
  * lines are not one: the last tab bar anchors it, and an active dialog ends
8
12
  * with its "Esc to cancel" footer or the review's Submit/Cancel rows. */
@@ -18,7 +22,7 @@ export function claudeQuestionDialog(text) {
18
22
  return undefined;
19
23
  const tabs = [...lines[bar].matchAll(/[☐☒]\s+([^☐☒✔→]+?)(?=\s{2,}|\s*[☐☒✔→]|\s*$)/g)].map(match => match[1].trim());
20
24
  const body = lines.slice(bar + 1);
21
- const content = body.map(line => line.trim()).filter(line => line && !/^─+$/.test(line));
25
+ const content = body.map(line => line.replace(GUTTER, "$1").trim()).filter(line => line && !/^─+$/.test(line));
22
26
  if (content[0] === "Review your answers") {
23
27
  if (!body.some(line => /^\s*❯?\s*1\.\s+Submit answers\s*$/.test(line)))
24
28
  return undefined;
@@ -46,7 +50,7 @@ export function claudeQuestionDialog(text) {
46
50
  const first = body.findIndex(line => ROW.test(line));
47
51
  if (first < 0)
48
52
  return undefined;
49
- const title = normalize(body.slice(0, first).filter(line => line.trim()).join(" "));
53
+ const title = normalize(body.slice(0, first).map(line => line.replace(GUTTER, "$1")).filter(line => line.trim()).join(" "));
50
54
  const rows = [];
51
55
  let cursor, chat = false;
52
56
  for (const line of body.slice(first)) {