@inferhub/usage 0.1.4 → 0.1.6

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 (6) hide show
  1. package/dist/format.d.ts +3 -4
  2. package/dist/format.js +30 -56
  3. package/dist/format.test.js +32 -47
  4. package/package.json +1 -1
  5. package/src/format.test.ts +35 -50
  6. package/src/format.ts +30 -69
package/dist/format.d.ts CHANGED
@@ -3,16 +3,15 @@ export declare function money(usdc: string | number | null | undefined, digits?:
3
3
  export declare function tokens(n: number | null | undefined): string;
4
4
  export declare function shortModel(model: string | null | undefined): string;
5
5
  /**
6
- * Compact one-liner for Claude statusline / Codex Stop summary.
6
+ * One-line Claude statusline — keep short (Claude only shows one row).
7
7
  *
8
- * Plain-language labels. Free models correctly show $0 billed while still
9
- * reporting request/token activity.
8
+ * Example:
9
+ * InferHub · sess 19r · day 129r · all $0.41 · bal $1.31 · top gpt-5.5
10
10
  */
11
11
  export declare function formatStatusLine(usage: AccountUsage, extras?: {
12
12
  sessionCostUsd?: number | null;
13
13
  contextPct?: number | null;
14
14
  model?: string | null;
15
- /** When true, include Claude local list-price estimate. Default false. */
16
15
  showEstimate?: boolean;
17
16
  }): string;
18
17
  /** Multi-line human report for /usage skills. */
package/dist/format.js CHANGED
@@ -1,10 +1,14 @@
1
1
  export function money(usdc, digits = 2) {
2
2
  const n = Number(usdc ?? 0);
3
3
  if (!Number.isFinite(n))
4
- return "$0.00";
5
- if (Math.abs(n) > 0 && Math.abs(n) < 0.01)
4
+ return "$0";
5
+ if (n === 0)
6
+ return "$0";
7
+ if (Math.abs(n) < 0.01)
6
8
  return `$${n.toFixed(4)}`;
7
- return `$${n.toFixed(digits)}`;
9
+ if (Math.abs(n) < 1)
10
+ return `$${n.toFixed(2)}`;
11
+ return `$${n.toFixed(2)}`;
8
12
  }
9
13
  export function tokens(n) {
10
14
  const v = Number(n ?? 0);
@@ -20,70 +24,40 @@ export function shortModel(model) {
20
24
  const parts = model.split("/");
21
25
  return parts[parts.length - 1] || model;
22
26
  }
23
- /** Human activity + optional billed spend. */
24
- function activity(label, opts) {
25
- const req = Number(opts.requests ?? 0);
26
- const tok = Number(opts.totalTokens ?? 0);
27
- const spend = Number(opts.spendUsdc ?? 0);
28
- const bits = [];
29
- if (req > 0 || tok > 0) {
30
- bits.push(`${req.toLocaleString()} req`);
31
- bits.push(`${tokens(tok)} tok`);
32
- }
33
- else {
34
- bits.push("no traffic");
27
+ /** Compact metric for one-line status.
28
+ * - billed: "$0.41" (no req clutter on all-time)
29
+ * - free/zero: "19r"
30
+ * - billed + wantReq: "$0.12/5r" when showReq=true
31
+ */
32
+ function compact(spendUsdc, requests, opts) {
33
+ const spend = Number(spendUsdc ?? 0);
34
+ const req = Number(requests ?? 0);
35
+ if (spend > 0) {
36
+ if (opts?.showReq && req > 0)
37
+ return `${money(spend)}/${req}r`;
38
+ return money(spend);
35
39
  }
36
- if (spend > 0)
37
- bits.push(money(spend));
38
- else
39
- bits.push("$0");
40
- return `${label} ${bits.join(" / ")}`;
40
+ if (req <= 0)
41
+ return "—";
42
+ return `${req}r`;
41
43
  }
42
44
  /**
43
- * Compact one-liner for Claude statusline / Codex Stop summary.
45
+ * One-line Claude statusline — keep short (Claude only shows one row).
44
46
  *
45
- * Plain-language labels. Free models correctly show $0 billed while still
46
- * reporting request/token activity.
47
+ * Example:
48
+ * InferHub · sess 19r · day 129r · all $0.41 · bal $1.31 · top gpt-5.5
47
49
  */
48
50
  export function formatStatusLine(usage, extras) {
49
- const model = extras?.model ? shortModel(extras.model) : null;
50
- const bal = money(usage.balance.amount_usdc);
51
- const top = shortModel(usage.top_model?.model);
52
- const ctx = extras?.contextPct != null && Number.isFinite(extras.contextPct)
53
- ? `${Math.round(extras.contextPct)}% context`
54
- : null;
55
51
  const parts = ["InferHub"];
56
- if (model)
57
- parts.push(model);
58
- // Latest conversation on InferHub (server-derived session), if present and useful
59
52
  if (usage.session && (usage.session.requests > 0 || Number(usage.session.spend_usdc) > 0)) {
60
- parts.push(activity("session", {
61
- spendUsdc: usage.session.spend_usdc,
62
- requests: usage.session.requests,
63
- totalTokens: usage.session.total_tokens,
64
- }));
53
+ parts.push(`sess ${compact(usage.session.spend_usdc, usage.session.requests)}`);
65
54
  }
66
- parts.push(activity("today", {
67
- spendUsdc: usage.window.spend_usdc,
68
- requests: usage.window.requests,
69
- totalTokens: usage.window.total_tokens,
70
- }));
71
- parts.push(activity("all-time", {
72
- spendUsdc: usage.all_time.spend_usdc,
73
- requests: usage.all_time.requests,
74
- totalTokens: usage.all_time.total_tokens,
75
- }));
76
- parts.push(`balance ${bal}`);
55
+ parts.push(`day ${compact(usage.window.spend_usdc, usage.window.requests)}`);
56
+ parts.push(`all ${compact(usage.all_time.spend_usdc, usage.all_time.requests)}`);
57
+ parts.push(`bal ${money(usage.balance.amount_usdc)}`);
58
+ const top = shortModel(usage.top_model?.model);
77
59
  if (top && top !== "—")
78
60
  parts.push(`top ${top}`);
79
- if (ctx)
80
- parts.push(ctx);
81
- if (extras?.showEstimate &&
82
- extras.sessionCostUsd != null &&
83
- Number.isFinite(extras.sessionCostUsd) &&
84
- extras.sessionCostUsd > 0) {
85
- parts.push(`claude-est ${money(extras.sessionCostUsd)}`);
86
- }
87
61
  return parts.join(" · ");
88
62
  }
89
63
  /** Multi-line human report for /usage skills. */
package/dist/format.test.js CHANGED
@@ -3,41 +3,39 @@ import test from "node:test";
3
3
  import { formatStatusLine, money, normalizeBaseUrl, usageUrl } from "./index.js";
4
4
  test("normalizeBaseUrl adds /v1", () => {
5
5
  assert.equal(normalizeBaseUrl("https://api.inferhub.dev"), "https://api.inferhub.dev/v1");
6
- assert.equal(normalizeBaseUrl("https://api.inferhub.dev/v1/"), "https://api.inferhub.dev/v1");
7
6
  });
8
7
  test("usageUrl", () => {
9
- assert.equal(usageUrl("https://api.inferhub.dev", "day", "UTC"), "https://api.inferhub.dev/v1/me/usage?window=day&tz=UTC");
10
8
  assert.equal(usageUrl("https://api.inferhub.dev", "day", "UTC", "abc"), "https://api.inferhub.dev/v1/me/usage?window=day&tz=UTC&session_id=abc");
11
9
  });
12
- test("formatStatusLine is plain language", () => {
10
+ test("formatStatusLine is compact one-liner", () => {
13
11
  const usage = {
14
12
  object: "account.usage",
15
13
  currency: "USDC",
16
- balance: { amount_usdc: "1.250000", updated_at: null },
14
+ balance: { amount_usdc: "1.312816", updated_at: null },
17
15
  window: {
18
16
  kind: "day",
19
17
  tz: "UTC",
20
18
  since: "",
21
19
  until: "",
22
- requests: 86,
23
- prompt_tokens: 14_000_000,
24
- completion_tokens: 100_000,
25
- total_tokens: 14_100_000,
20
+ requests: 129,
21
+ prompt_tokens: 0,
22
+ completion_tokens: 0,
23
+ total_tokens: 26_400_000,
26
24
  spend_usdc: "0",
27
25
  },
28
26
  all_time: {
29
- requests: 3890,
30
- prompt_tokens: 300_000_000,
31
- completion_tokens: 1_000_000,
32
- total_tokens: 301_000_000,
33
- spend_usdc: "0.410000",
27
+ requests: 3933,
28
+ prompt_tokens: 0,
29
+ completion_tokens: 0,
30
+ total_tokens: 354_200_000,
31
+ spend_usdc: "0.41",
34
32
  },
35
33
  session: {
36
- id: "sess-1",
37
- requests: 12,
38
- prompt_tokens: 200_000,
39
- completion_tokens: 5_000,
40
- total_tokens: 205_000,
34
+ id: "s",
35
+ requests: 19,
36
+ prompt_tokens: 0,
37
+ completion_tokens: 0,
38
+ total_tokens: 6_000_000,
41
39
  spend_usdc: "0",
42
40
  since: null,
43
41
  until: null,
@@ -45,41 +43,28 @@ test("formatStatusLine is plain language", () => {
45
43
  top_model: {
46
44
  model: "cx/gpt-5.5",
47
45
  requests: 212,
48
- tokens: 239830,
49
- spend_usdc: "0.137155",
46
+ tokens: 1,
47
+ spend_usdc: "0.14",
50
48
  },
51
49
  cache: { cached: false, ttl_seconds: 30 },
52
50
  };
53
51
  const line = formatStatusLine(usage, {
54
- model: "free/grok/grok-4.5",
52
+ model: "grok-4.5",
55
53
  contextPct: 8,
56
- sessionCostUsd: 2.69,
57
54
  });
58
- assert.match(line, /^InferHub/);
59
- assert.match(line, /session 12 req \/ 205\.0k tok \/ \$0/);
60
- assert.match(line, /today 86 req \/ 14\.1M tok \/ \$0/);
61
- assert.match(line, /all-time 3,890 req \/ 301\.0M tok \/ \$0\.41/);
62
- assert.match(line, /balance \$1\.25/);
63
- assert.match(line, /top gpt-5\.5/);
64
- assert.match(line, /8% context/);
65
- assert.doesNotMatch(line, /\bIH\b/);
66
- assert.doesNotMatch(line, /0r\/0/);
67
- assert.doesNotMatch(line, /claude-est/); // estimate off by default
68
- // empty/zero session should be omitted (not "sess 0r/0")
69
- const noSess = {
55
+ // Must be short enough for one Claude status row
56
+ assert.ok(line.length < 100, `too long: ${line.length} ${line}`);
57
+ assert.equal(line, "InferHub · sess 19r · day 129r · all $0.41 · bal $1.31 · top gpt-5.5");
58
+ assert.ok(line.length <= 72, `too long: ${line.length}`);
59
+ // paid day shows money only (no req clutter)
60
+ const paid = {
70
61
  ...usage,
71
- session: {
72
- id: "empty",
73
- requests: 0,
74
- prompt_tokens: 0,
75
- completion_tokens: 0,
76
- total_tokens: 0,
77
- spend_usdc: "0",
78
- since: null,
79
- until: null,
80
- },
62
+ window: { ...usage.window, spend_usdc: "0.12", requests: 5 },
63
+ session: null,
81
64
  };
82
- const line2 = formatStatusLine(noSess, { model: "Grok" });
83
- assert.doesNotMatch(line2, /session /);
84
- assert.equal(money("0.001"), "$0.0010");
65
+ const paidLine = formatStatusLine(paid);
66
+ assert.match(paidLine, /day \$0\.12/);
67
+ assert.doesNotMatch(paidLine, /sess /);
68
+ assert.doesNotMatch(paidLine, /\/5r/);
69
+ assert.equal(money("0"), "$0");
85
70
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inferhub/usage",
3
- "version": "0.1.4",
3
+ "version": "0.1.6",
4
4
  "description": "Shared InferHub account usage client for coding-agent plugins",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/src/format.test.ts CHANGED
@@ -5,49 +5,44 @@ import type { AccountUsage } from "./types.js";
5
5
 
6
6
  test("normalizeBaseUrl adds /v1", () => {
7
7
  assert.equal(normalizeBaseUrl("https://api.inferhub.dev"), "https://api.inferhub.dev/v1");
8
- assert.equal(normalizeBaseUrl("https://api.inferhub.dev/v1/"), "https://api.inferhub.dev/v1");
9
8
  });
10
9
 
11
10
  test("usageUrl", () => {
12
- assert.equal(
13
- usageUrl("https://api.inferhub.dev", "day", "UTC"),
14
- "https://api.inferhub.dev/v1/me/usage?window=day&tz=UTC",
15
- );
16
11
  assert.equal(
17
12
  usageUrl("https://api.inferhub.dev", "day", "UTC", "abc"),
18
13
  "https://api.inferhub.dev/v1/me/usage?window=day&tz=UTC&session_id=abc",
19
14
  );
20
15
  });
21
16
 
22
- test("formatStatusLine is plain language", () => {
17
+ test("formatStatusLine is compact one-liner", () => {
23
18
  const usage: AccountUsage = {
24
19
  object: "account.usage",
25
20
  currency: "USDC",
26
- balance: { amount_usdc: "1.250000", updated_at: null },
21
+ balance: { amount_usdc: "1.312816", updated_at: null },
27
22
  window: {
28
23
  kind: "day",
29
24
  tz: "UTC",
30
25
  since: "",
31
26
  until: "",
32
- requests: 86,
33
- prompt_tokens: 14_000_000,
34
- completion_tokens: 100_000,
35
- total_tokens: 14_100_000,
27
+ requests: 129,
28
+ prompt_tokens: 0,
29
+ completion_tokens: 0,
30
+ total_tokens: 26_400_000,
36
31
  spend_usdc: "0",
37
32
  },
38
33
  all_time: {
39
- requests: 3890,
40
- prompt_tokens: 300_000_000,
41
- completion_tokens: 1_000_000,
42
- total_tokens: 301_000_000,
43
- spend_usdc: "0.410000",
34
+ requests: 3933,
35
+ prompt_tokens: 0,
36
+ completion_tokens: 0,
37
+ total_tokens: 354_200_000,
38
+ spend_usdc: "0.41",
44
39
  },
45
40
  session: {
46
- id: "sess-1",
47
- requests: 12,
48
- prompt_tokens: 200_000,
49
- completion_tokens: 5_000,
50
- total_tokens: 205_000,
41
+ id: "s",
42
+ requests: 19,
43
+ prompt_tokens: 0,
44
+ completion_tokens: 0,
45
+ total_tokens: 6_000_000,
51
46
  spend_usdc: "0",
52
47
  since: null,
53
48
  until: null,
@@ -55,45 +50,35 @@ test("formatStatusLine is plain language", () => {
55
50
  top_model: {
56
51
  model: "cx/gpt-5.5",
57
52
  requests: 212,
58
- tokens: 239830,
59
- spend_usdc: "0.137155",
53
+ tokens: 1,
54
+ spend_usdc: "0.14",
60
55
  },
61
56
  cache: { cached: false, ttl_seconds: 30 },
62
57
  };
63
58
 
64
59
  const line = formatStatusLine(usage, {
65
- model: "free/grok/grok-4.5",
60
+ model: "grok-4.5",
66
61
  contextPct: 8,
67
- sessionCostUsd: 2.69,
68
62
  });
69
63
 
70
- assert.match(line, /^InferHub/);
71
- assert.match(line, /session 12 req \/ 205\.0k tok \/ \$0/);
72
- assert.match(line, /today 86 req \/ 14\.1M tok \/ \$0/);
73
- assert.match(line, /all-time 3,890 req \/ 301\.0M tok \/ \$0\.41/);
74
- assert.match(line, /balance \$1\.25/);
75
- assert.match(line, /top gpt-5\.5/);
76
- assert.match(line, /8% context/);
77
- assert.doesNotMatch(line, /\bIH\b/);
78
- assert.doesNotMatch(line, /0r\/0/);
79
- assert.doesNotMatch(line, /claude-est/); // estimate off by default
64
+ // Must be short enough for one Claude status row
65
+ assert.ok(line.length < 100, `too long: ${line.length} ${line}`);
66
+ assert.equal(
67
+ line,
68
+ "InferHub · sess 19r · day 129r · all $0.41 · bal $1.31 · top gpt-5.5",
69
+ );
70
+ assert.ok(line.length <= 72, `too long: ${line.length}`);
80
71
 
81
- // empty/zero session should be omitted (not "sess 0r/0")
82
- const noSess: AccountUsage = {
72
+ // paid day shows money only (no req clutter)
73
+ const paid: AccountUsage = {
83
74
  ...usage,
84
- session: {
85
- id: "empty",
86
- requests: 0,
87
- prompt_tokens: 0,
88
- completion_tokens: 0,
89
- total_tokens: 0,
90
- spend_usdc: "0",
91
- since: null,
92
- until: null,
93
- },
75
+ window: { ...usage.window, spend_usdc: "0.12", requests: 5 },
76
+ session: null,
94
77
  };
95
- const line2 = formatStatusLine(noSess, { model: "Grok" });
96
- assert.doesNotMatch(line2, /session /);
78
+ const paidLine = formatStatusLine(paid);
79
+ assert.match(paidLine, /day \$0\.12/);
80
+ assert.doesNotMatch(paidLine, /sess /);
81
+ assert.doesNotMatch(paidLine, /\/5r/);
97
82
 
98
- assert.equal(money("0.001"), "$0.0010");
83
+ assert.equal(money("0"), "$0");
99
84
  });
package/src/format.ts CHANGED
@@ -2,9 +2,11 @@ import type { AccountUsage } from "./types.js";
2
2
 
3
3
  export function money(usdc: string | number | null | undefined, digits = 2): string {
4
4
  const n = Number(usdc ?? 0);
5
- if (!Number.isFinite(n)) return "$0.00";
6
- if (Math.abs(n) > 0 && Math.abs(n) < 0.01) return `$${n.toFixed(4)}`;
7
- return `$${n.toFixed(digits)}`;
5
+ if (!Number.isFinite(n)) return "$0";
6
+ if (n === 0) return "$0";
7
+ if (Math.abs(n) < 0.01) return `$${n.toFixed(4)}`;
8
+ if (Math.abs(n) < 1) return `$${n.toFixed(2)}`;
9
+ return `$${n.toFixed(2)}`;
8
10
  }
9
11
 
10
12
  export function tokens(n: number | null | undefined): string {
@@ -20,35 +22,31 @@ export function shortModel(model: string | null | undefined): string {
20
22
  return parts[parts.length - 1] || model;
21
23
  }
22
24
 
23
- /** Human activity + optional billed spend. */
24
- function activity(
25
- label: string,
26
- opts: {
27
- spendUsdc?: string | number | null;
28
- requests?: number | null;
29
- totalTokens?: number | null;
30
- },
25
+ /** Compact metric for one-line status.
26
+ * - billed: "$0.41" (no req clutter on all-time)
27
+ * - free/zero: "19r"
28
+ * - billed + wantReq: "$0.12/5r" when showReq=true
29
+ */
30
+ function compact(
31
+ spendUsdc: string | number | null | undefined,
32
+ requests: number | null | undefined,
33
+ opts?: { showReq?: boolean },
31
34
  ): string {
32
- const req = Number(opts.requests ?? 0);
33
- const tok = Number(opts.totalTokens ?? 0);
34
- const spend = Number(opts.spendUsdc ?? 0);
35
- const bits: string[] = [];
36
- if (req > 0 || tok > 0) {
37
- bits.push(`${req.toLocaleString()} req`);
38
- bits.push(`${tokens(tok)} tok`);
39
- } else {
40
- bits.push("no traffic");
35
+ const spend = Number(spendUsdc ?? 0);
36
+ const req = Number(requests ?? 0);
37
+ if (spend > 0) {
38
+ if (opts?.showReq && req > 0) return `${money(spend)}/${req}r`;
39
+ return money(spend);
41
40
  }
42
- if (spend > 0) bits.push(money(spend));
43
- else bits.push("$0");
44
- return `${label} ${bits.join(" / ")}`;
41
+ if (req <= 0) return "—";
42
+ return `${req}r`;
45
43
  }
46
44
 
47
45
  /**
48
- * Compact one-liner for Claude statusline / Codex Stop summary.
46
+ * One-line Claude statusline — keep short (Claude only shows one row).
49
47
  *
50
- * Plain-language labels. Free models correctly show $0 billed while still
51
- * reporting request/token activity.
48
+ * Example:
49
+ * InferHub · sess 19r · day 129r · all $0.41 · bal $1.31 · top gpt-5.5
52
50
  */
53
51
  export function formatStatusLine(
54
52
  usage: AccountUsage,
@@ -56,58 +54,21 @@ export function formatStatusLine(
56
54
  sessionCostUsd?: number | null;
57
55
  contextPct?: number | null;
58
56
  model?: string | null;
59
- /** When true, include Claude local list-price estimate. Default false. */
60
57
  showEstimate?: boolean;
61
58
  },
62
59
  ): string {
63
- const model = extras?.model ? shortModel(extras.model) : null;
64
- const bal = money(usage.balance.amount_usdc);
65
- const top = shortModel(usage.top_model?.model);
66
- const ctx =
67
- extras?.contextPct != null && Number.isFinite(extras.contextPct)
68
- ? `${Math.round(extras.contextPct)}% context`
69
- : null;
70
-
71
60
  const parts: string[] = ["InferHub"];
72
- if (model) parts.push(model);
73
61
 
74
- // Latest conversation on InferHub (server-derived session), if present and useful
75
62
  if (usage.session && (usage.session.requests > 0 || Number(usage.session.spend_usdc) > 0)) {
76
- parts.push(
77
- activity("session", {
78
- spendUsdc: usage.session.spend_usdc,
79
- requests: usage.session.requests,
80
- totalTokens: usage.session.total_tokens,
81
- }),
82
- );
63
+ parts.push(`sess ${compact(usage.session.spend_usdc, usage.session.requests)}`);
83
64
  }
84
65
 
85
- parts.push(
86
- activity("today", {
87
- spendUsdc: usage.window.spend_usdc,
88
- requests: usage.window.requests,
89
- totalTokens: usage.window.total_tokens,
90
- }),
91
- );
92
- parts.push(
93
- activity("all-time", {
94
- spendUsdc: usage.all_time.spend_usdc,
95
- requests: usage.all_time.requests,
96
- totalTokens: usage.all_time.total_tokens,
97
- }),
98
- );
99
- parts.push(`balance ${bal}`);
100
- if (top && top !== "—") parts.push(`top ${top}`);
101
- if (ctx) parts.push(ctx);
66
+ parts.push(`day ${compact(usage.window.spend_usdc, usage.window.requests)}`);
67
+ parts.push(`all ${compact(usage.all_time.spend_usdc, usage.all_time.requests)}`);
68
+ parts.push(`bal ${money(usage.balance.amount_usdc)}`);
102
69
 
103
- if (
104
- extras?.showEstimate &&
105
- extras.sessionCostUsd != null &&
106
- Number.isFinite(extras.sessionCostUsd) &&
107
- extras.sessionCostUsd > 0
108
- ) {
109
- parts.push(`claude-est ${money(extras.sessionCostUsd)}`);
110
- }
70
+ const top = shortModel(usage.top_model?.model);
71
+ if (top && top !== "—") parts.push(`top ${top}`);
111
72
 
112
73
  return parts.join(" · ");
113
74
  }