@evelinka-ai/core 0.1.3

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 (130) hide show
  1. package/README.md +16 -0
  2. package/dist/agent-lib/llm-semaphore.d.ts +47 -0
  3. package/dist/agent-lib/llm-semaphore.d.ts.map +1 -0
  4. package/dist/agent-lib/llm-semaphore.js +255 -0
  5. package/dist/agent-lib/llm-semaphore.js.map +1 -0
  6. package/dist/agent-lib/managed-tool.d.ts +29 -0
  7. package/dist/agent-lib/managed-tool.d.ts.map +1 -0
  8. package/dist/agent-lib/managed-tool.js +28 -0
  9. package/dist/agent-lib/managed-tool.js.map +1 -0
  10. package/dist/channels/catalog.d.ts +3 -0
  11. package/dist/channels/catalog.d.ts.map +1 -0
  12. package/dist/channels/catalog.js +20 -0
  13. package/dist/channels/catalog.js.map +1 -0
  14. package/dist/channels/model-catalog.d.ts +3 -0
  15. package/dist/channels/model-catalog.d.ts.map +1 -0
  16. package/dist/channels/model-catalog.js +6 -0
  17. package/dist/channels/model-catalog.js.map +1 -0
  18. package/dist/channels/usage.d.ts +3 -0
  19. package/dist/channels/usage.d.ts.map +1 -0
  20. package/dist/channels/usage.js +35 -0
  21. package/dist/channels/usage.js.map +1 -0
  22. package/dist/lib/atomic-file.d.ts +2 -0
  23. package/dist/lib/atomic-file.d.ts.map +1 -0
  24. package/dist/lib/atomic-file.js +16 -0
  25. package/dist/lib/atomic-file.js.map +1 -0
  26. package/dist/lib/budgets/record-call-usage.d.ts +31 -0
  27. package/dist/lib/budgets/record-call-usage.d.ts.map +1 -0
  28. package/dist/lib/budgets/record-call-usage.js +44 -0
  29. package/dist/lib/budgets/record-call-usage.js.map +1 -0
  30. package/dist/lib/budgets/token-budget.d.ts +61 -0
  31. package/dist/lib/budgets/token-budget.d.ts.map +1 -0
  32. package/dist/lib/budgets/token-budget.js +250 -0
  33. package/dist/lib/budgets/token-budget.js.map +1 -0
  34. package/dist/lib/budgets/token-usage-pg.d.ts +96 -0
  35. package/dist/lib/budgets/token-usage-pg.d.ts.map +1 -0
  36. package/dist/lib/budgets/token-usage-pg.js +305 -0
  37. package/dist/lib/budgets/token-usage-pg.js.map +1 -0
  38. package/dist/lib/budgets/usage.d.ts +103 -0
  39. package/dist/lib/budgets/usage.d.ts.map +1 -0
  40. package/dist/lib/budgets/usage.js +151 -0
  41. package/dist/lib/budgets/usage.js.map +1 -0
  42. package/dist/lib/control-plane/call-context.d.ts +7 -0
  43. package/dist/lib/control-plane/call-context.d.ts.map +1 -0
  44. package/dist/lib/control-plane/call-context.js +9 -0
  45. package/dist/lib/control-plane/call-context.js.map +1 -0
  46. package/dist/lib/control-plane/catalog.d.ts +33 -0
  47. package/dist/lib/control-plane/catalog.d.ts.map +1 -0
  48. package/dist/lib/control-plane/catalog.js +163 -0
  49. package/dist/lib/control-plane/catalog.js.map +1 -0
  50. package/dist/lib/control-plane/flow-settings.d.ts +32 -0
  51. package/dist/lib/control-plane/flow-settings.d.ts.map +1 -0
  52. package/dist/lib/control-plane/flow-settings.js +139 -0
  53. package/dist/lib/control-plane/flow-settings.js.map +1 -0
  54. package/dist/lib/control-plane/tools-config.d.ts +30 -0
  55. package/dist/lib/control-plane/tools-config.d.ts.map +1 -0
  56. package/dist/lib/control-plane/tools-config.js +104 -0
  57. package/dist/lib/control-plane/tools-config.js.map +1 -0
  58. package/dist/lib/delivery/push-store.d.ts +20 -0
  59. package/dist/lib/delivery/push-store.d.ts.map +1 -0
  60. package/dist/lib/delivery/push-store.js +74 -0
  61. package/dist/lib/delivery/push-store.js.map +1 -0
  62. package/dist/lib/delivery/push.d.ts +15 -0
  63. package/dist/lib/delivery/push.d.ts.map +1 -0
  64. package/dist/lib/delivery/push.js +97 -0
  65. package/dist/lib/delivery/push.js.map +1 -0
  66. package/dist/lib/delivery/schedule-lock.d.ts +16 -0
  67. package/dist/lib/delivery/schedule-lock.d.ts.map +1 -0
  68. package/dist/lib/delivery/schedule-lock.js +86 -0
  69. package/dist/lib/delivery/schedule-lock.js.map +1 -0
  70. package/dist/lib/memory/memory-dream.d.ts +181 -0
  71. package/dist/lib/memory/memory-dream.d.ts.map +1 -0
  72. package/dist/lib/memory/memory-dream.js +405 -0
  73. package/dist/lib/memory/memory-dream.js.map +1 -0
  74. package/dist/lib/memory/memory-vault-git.d.ts +14 -0
  75. package/dist/lib/memory/memory-vault-git.d.ts.map +1 -0
  76. package/dist/lib/memory/memory-vault-git.js +345 -0
  77. package/dist/lib/memory/memory-vault-git.js.map +1 -0
  78. package/dist/lib/memory/memory-vault.d.ts +83 -0
  79. package/dist/lib/memory/memory-vault.d.ts.map +1 -0
  80. package/dist/lib/memory/memory-vault.js +466 -0
  81. package/dist/lib/memory/memory-vault.js.map +1 -0
  82. package/dist/lib/memory/static-instructions.d.ts +2 -0
  83. package/dist/lib/memory/static-instructions.d.ts.map +1 -0
  84. package/dist/lib/memory/static-instructions.js +48 -0
  85. package/dist/lib/memory/static-instructions.js.map +1 -0
  86. package/dist/lib/memory/vault-explorer.d.ts +37 -0
  87. package/dist/lib/memory/vault-explorer.d.ts.map +1 -0
  88. package/dist/lib/memory/vault-explorer.js +212 -0
  89. package/dist/lib/memory/vault-explorer.js.map +1 -0
  90. package/dist/lib/models/llm-concurrency.d.ts +29 -0
  91. package/dist/lib/models/llm-concurrency.d.ts.map +1 -0
  92. package/dist/lib/models/llm-concurrency.js +103 -0
  93. package/dist/lib/models/llm-concurrency.js.map +1 -0
  94. package/dist/lib/models/model-catalog.d.ts +32 -0
  95. package/dist/lib/models/model-catalog.d.ts.map +1 -0
  96. package/dist/lib/models/model-catalog.js +115 -0
  97. package/dist/lib/models/model-catalog.js.map +1 -0
  98. package/dist/lib/models/model-config.d.ts +27 -0
  99. package/dist/lib/models/model-config.d.ts.map +1 -0
  100. package/dist/lib/models/model-config.js +155 -0
  101. package/dist/lib/models/model-config.js.map +1 -0
  102. package/dist/lib/observability/console-link.d.ts +3 -0
  103. package/dist/lib/observability/console-link.d.ts.map +1 -0
  104. package/dist/lib/observability/console-link.js +15 -0
  105. package/dist/lib/observability/console-link.js.map +1 -0
  106. package/dist/lib/observability/event-bus.d.ts +11 -0
  107. package/dist/lib/observability/event-bus.d.ts.map +1 -0
  108. package/dist/lib/observability/event-bus.js +24 -0
  109. package/dist/lib/observability/event-bus.js.map +1 -0
  110. package/dist/lib/observability/logger.d.ts +5 -0
  111. package/dist/lib/observability/logger.d.ts.map +1 -0
  112. package/dist/lib/observability/logger.js +47 -0
  113. package/dist/lib/observability/logger.js.map +1 -0
  114. package/dist/lib/observability/payload-store.d.ts +8 -0
  115. package/dist/lib/observability/payload-store.d.ts.map +1 -0
  116. package/dist/lib/observability/payload-store.js +101 -0
  117. package/dist/lib/observability/payload-store.js.map +1 -0
  118. package/dist/lib/observability/recorder-hook.d.ts +22 -0
  119. package/dist/lib/observability/recorder-hook.d.ts.map +1 -0
  120. package/dist/lib/observability/recorder-hook.js +241 -0
  121. package/dist/lib/observability/recorder-hook.js.map +1 -0
  122. package/dist/lib/observability/recorder.d.ts +339 -0
  123. package/dist/lib/observability/recorder.d.ts.map +1 -0
  124. package/dist/lib/observability/recorder.js +1182 -0
  125. package/dist/lib/observability/recorder.js.map +1 -0
  126. package/dist/tenant.d.ts +59 -0
  127. package/dist/tenant.d.ts.map +1 -0
  128. package/dist/tenant.js +18 -0
  129. package/dist/tenant.js.map +1 -0
  130. package/package.json +119 -0
@@ -0,0 +1,61 @@
1
+ import { type UsageRow } from "./token-usage-pg.js";
2
+ export declare const DEFAULT_TOKEN_BUDGET = 10000000;
3
+ export declare const TOKEN_BUDGET_CODE = "TOKEN_BUDGET_EXCEEDED";
4
+ export interface TokenBudgetConfig {
5
+ defaultBudget?: number;
6
+ byFlow?: Record<string, number>;
7
+ }
8
+ export declare class TokenBudgetExceededError extends Error {
9
+ readonly code = "TOKEN_BUDGET_EXCEEDED";
10
+ readonly flow: string | undefined;
11
+ readonly rootId: string;
12
+ readonly total: number;
13
+ readonly budget: number;
14
+ constructor(args: {
15
+ flow?: string;
16
+ rootId: string;
17
+ total: number;
18
+ budget: number;
19
+ });
20
+ }
21
+ export declare function isTokenBudgetError(err: unknown): boolean;
22
+ export declare function tokenBudgetsPath(): string;
23
+ export declare function readTokenBudgetConfig(): TokenBudgetConfig;
24
+ export declare function effectiveTokenBudget(flow: string | undefined, cfg?: TokenBudgetConfig): number;
25
+ export interface TokenBudgetsView {
26
+ defaultBudget: number | null;
27
+ byFlow: Record<string, number>;
28
+ hardDefault: number;
29
+ }
30
+ export declare function tokenBudgetView(cfg?: TokenBudgetConfig): TokenBudgetsView;
31
+ export type TokenBudgetPatch = {
32
+ ok: true;
33
+ cfg: TokenBudgetConfig;
34
+ } | {
35
+ ok: false;
36
+ error: string;
37
+ };
38
+ export declare function applyTokenBudgetPatch(cur: TokenBudgetConfig, body: {
39
+ defaultBudget?: unknown;
40
+ byFlow?: unknown;
41
+ }): TokenBudgetPatch;
42
+ export declare function writeTokenBudgetConfig(cfg: TokenBudgetConfig): TokenBudgetConfig;
43
+ export interface TokenBudgetStatus {
44
+ rootId: string | undefined;
45
+ total: number;
46
+ budget: number;
47
+ exceeded: boolean;
48
+ }
49
+ export declare function tokenBudgetStatus(args: {
50
+ sessionId?: string;
51
+ rootId?: string;
52
+ flow?: string;
53
+ }): TokenBudgetStatus;
54
+ export declare function assertTokenBudget(args: {
55
+ sessionId?: string;
56
+ rootId?: string;
57
+ flow?: string;
58
+ }): void;
59
+ export declare function _resetTokenBudget(): void;
60
+ export declare function _noteUsageForTest(row: UsageRow): void;
61
+ //# sourceMappingURL=token-budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../../src/lib/budgets/token-budget.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIvF,eAAO,MAAM,oBAAoB,WAAa,CAAC;AAC/C,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAGhC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,2BAAqB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAenF;AAKD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAcxD;AAID,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAOD,wBAAgB,qBAAqB,IAAI,iBAAiB,CAezD;AAsBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,GAAG,oBAA0B,GAC5B,MAAM,CAYR;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,GAAG,GAAE,iBAA2C,GAC/C,gBAAgB,CAMlB;AAQD,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAInG,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,gBAAgB,CA2BlB;AAKD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,GAAG,iBAAiB,CAShF;AAqED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,iBAAiB,CAcpB;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAwBP;AAID,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAErD"}
@@ -0,0 +1,250 @@
1
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { logger } from "../observability/logger.js";
4
+ import { onUsageRecorded, readRootDayTotal } from "./token-usage-pg.js";
5
+ const log = logger.child({ module: "token-budget" });
6
+ export const DEFAULT_TOKEN_BUDGET = 10_000_000;
7
+ export const TOKEN_BUDGET_CODE = "TOKEN_BUDGET_EXCEEDED";
8
+ export class TokenBudgetExceededError extends Error {
9
+ code = TOKEN_BUDGET_CODE;
10
+ flow;
11
+ rootId;
12
+ total;
13
+ budget;
14
+ constructor(args) {
15
+ super(`${TOKEN_BUDGET_CODE}: run ${args.rootId} spent ${args.total.toLocaleString("en-US")} tokens today` +
16
+ ` (budget ${args.budget.toLocaleString("en-US")}${args.flow ? `, flow ${args.flow}` : ""})` +
17
+ " — stopping before the next model call. Raise the budget in the console (Budgets) to resume.");
18
+ this.name = "TokenBudgetExceededError";
19
+ this.flow = args.flow;
20
+ this.rootId = args.rootId;
21
+ this.total = args.total;
22
+ this.budget = args.budget;
23
+ }
24
+ }
25
+ export function isTokenBudgetError(err) {
26
+ let cur = err;
27
+ for (let depth = 0; depth < 8 && cur; depth++) {
28
+ if (typeof cur === "object") {
29
+ const o = cur;
30
+ if (o.code === TOKEN_BUDGET_CODE)
31
+ return true;
32
+ if (typeof o.message === "string" && o.message.includes(TOKEN_BUDGET_CODE))
33
+ return true;
34
+ cur = o.cause;
35
+ continue;
36
+ }
37
+ if (typeof cur === "string")
38
+ return cur.includes(TOKEN_BUDGET_CODE);
39
+ break;
40
+ }
41
+ return false;
42
+ }
43
+ export function tokenBudgetsPath() {
44
+ return (process.env.EVE_TOKEN_BUDGETS_PATH ??
45
+ join(process.cwd(), ".workflow-data", "token-budgets.json"));
46
+ }
47
+ let cfgCache = null;
48
+ const CFG_TTL_MS = 3_000;
49
+ export function readTokenBudgetConfig() {
50
+ const now = Date.now();
51
+ if (cfgCache && now - cfgCache.at < CFG_TTL_MS)
52
+ return cfgCache.cfg;
53
+ let cfg = {};
54
+ try {
55
+ const raw = JSON.parse(readFileSync(tokenBudgetsPath(), "utf8"));
56
+ if (raw && typeof raw === "object" && !Array.isArray(raw))
57
+ cfg = sanitize(raw);
58
+ }
59
+ catch (err) {
60
+ if (err.code !== "ENOENT") {
61
+ log.warn({ err: String(err) }, "token-budgets config unreadable — using defaults");
62
+ }
63
+ }
64
+ cfgCache = { at: now, cfg };
65
+ return cfg;
66
+ }
67
+ function budgetValue(raw) {
68
+ const n = Number(raw);
69
+ return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;
70
+ }
71
+ function sanitize(raw) {
72
+ const out = {};
73
+ const def = budgetValue(raw.defaultBudget);
74
+ if (def !== undefined)
75
+ out.defaultBudget = def;
76
+ if (raw.byFlow && typeof raw.byFlow === "object") {
77
+ const byFlow = {};
78
+ for (const [k, v] of Object.entries(raw.byFlow)) {
79
+ const n = budgetValue(v);
80
+ if (n !== undefined)
81
+ byFlow[k] = n;
82
+ }
83
+ if (Object.keys(byFlow).length)
84
+ out.byFlow = byFlow;
85
+ }
86
+ return out;
87
+ }
88
+ export function effectiveTokenBudget(flow, cfg = readTokenBudgetConfig()) {
89
+ if (flow && cfg.byFlow) {
90
+ if (flow in cfg.byFlow)
91
+ return cfg.byFlow[flow];
92
+ const base = flow.slice(0, flow.indexOf(":"));
93
+ if (base && base in cfg.byFlow)
94
+ return cfg.byFlow[base];
95
+ }
96
+ return cfg.defaultBudget ?? DEFAULT_TOKEN_BUDGET;
97
+ }
98
+ export function tokenBudgetView(cfg = readTokenBudgetConfig()) {
99
+ return {
100
+ defaultBudget: cfg.defaultBudget ?? null,
101
+ byFlow: cfg.byFlow ?? {},
102
+ hardDefault: DEFAULT_TOKEN_BUDGET,
103
+ };
104
+ }
105
+ function budgetOrNull(raw) {
106
+ if (raw === null)
107
+ return null;
108
+ const n = Number(raw);
109
+ return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;
110
+ }
111
+ export function applyTokenBudgetPatch(cur, body) {
112
+ const next = {
113
+ ...(cur.defaultBudget !== undefined ? { defaultBudget: cur.defaultBudget } : {}),
114
+ ...(cur.byFlow ? { byFlow: { ...cur.byFlow } } : {}),
115
+ };
116
+ if ("defaultBudget" in body) {
117
+ const v = budgetOrNull(body.defaultBudget);
118
+ if (v === undefined)
119
+ return { ok: false, error: "defaultBudget must be a number ≥ 0 or null" };
120
+ if (v === null)
121
+ delete next.defaultBudget;
122
+ else
123
+ next.defaultBudget = v;
124
+ }
125
+ if (body.byFlow !== undefined) {
126
+ if (!body.byFlow || typeof body.byFlow !== "object" || Array.isArray(body.byFlow)) {
127
+ return { ok: false, error: "byFlow must be an object" };
128
+ }
129
+ const byFlow = { ...(next.byFlow ?? {}) };
130
+ for (const [flow, raw] of Object.entries(body.byFlow)) {
131
+ const v = budgetOrNull(raw);
132
+ if (v === undefined)
133
+ return { ok: false, error: `byFlow.${flow} must be a number ≥ 0 or null` };
134
+ if (v === null)
135
+ delete byFlow[flow];
136
+ else
137
+ byFlow[flow] = v;
138
+ }
139
+ if (Object.keys(byFlow).length)
140
+ next.byFlow = byFlow;
141
+ else
142
+ delete next.byFlow;
143
+ }
144
+ return { ok: true, cfg: next };
145
+ }
146
+ export function writeTokenBudgetConfig(cfg) {
147
+ const clean = sanitize(cfg);
148
+ const path = tokenBudgetsPath();
149
+ mkdirSync(dirname(path), { recursive: true });
150
+ const tmp = `${path}.tmp`;
151
+ writeFileSync(tmp, `${JSON.stringify(clean, null, 2)}\n`);
152
+ renameSync(tmp, path);
153
+ cfgCache = null;
154
+ return clean;
155
+ }
156
+ const totals = new Map();
157
+ const rootOf = new Map();
158
+ const hydrated = new Set();
159
+ const screamed = new Set();
160
+ const TOTALS_CAP = 8_192;
161
+ const ROOTOF_CAP = 16_384;
162
+ function prune(coll, cap) {
163
+ while (coll.size > cap) {
164
+ const oldest = coll.keys().next();
165
+ if (oldest.done)
166
+ return;
167
+ coll.delete(oldest.value);
168
+ }
169
+ }
170
+ function dayOf(atIso) {
171
+ return atIso.slice(0, 10);
172
+ }
173
+ function keyFor(rootId, day) {
174
+ return `${rootId}|${day}`;
175
+ }
176
+ function noteUsage(row) {
177
+ if (row.sessionId && row.rootId) {
178
+ rootOf.set(row.sessionId, row.rootId);
179
+ prune(rootOf, ROOTOF_CAP);
180
+ }
181
+ const key = keyFor(row.rootId, dayOf(row.at));
182
+ totals.set(key, (totals.get(key) ?? 0) + row.input + row.output);
183
+ prune(totals, TOTALS_CAP);
184
+ }
185
+ onUsageRecorded(noteUsage);
186
+ function hydrate(rootId, day) {
187
+ const key = keyFor(rootId, day);
188
+ if (hydrated.has(key))
189
+ return;
190
+ hydrated.add(key);
191
+ void readRootDayTotal(rootId, day)
192
+ .then((pgTotal) => {
193
+ if (pgTotal <= 0)
194
+ return;
195
+ const cur = totals.get(key) ?? 0;
196
+ if (pgTotal > cur) {
197
+ totals.set(key, pgTotal);
198
+ prune(totals, TOTALS_CAP);
199
+ }
200
+ })
201
+ .catch(() => undefined);
202
+ }
203
+ export function tokenBudgetStatus(args) {
204
+ const budget = effectiveTokenBudget(args.flow);
205
+ if (budget <= 0 || !(args.sessionId || args.rootId)) {
206
+ return { rootId: undefined, total: 0, budget, exceeded: false };
207
+ }
208
+ const rootId = args.rootId ?? (args.sessionId ? (rootOf.get(args.sessionId) ?? args.sessionId) : undefined);
209
+ if (!rootId)
210
+ return { rootId: undefined, total: 0, budget, exceeded: false };
211
+ const day = dayOf(new Date().toISOString());
212
+ hydrate(rootId, day);
213
+ const total = totals.get(keyFor(rootId, day)) ?? 0;
214
+ return { rootId, total, budget, exceeded: total >= budget };
215
+ }
216
+ export function assertTokenBudget(args) {
217
+ let status;
218
+ try {
219
+ status = tokenBudgetStatus(args);
220
+ }
221
+ catch (err) {
222
+ log.warn({ err: String(err) }, "token budget check failed — failing open");
223
+ return;
224
+ }
225
+ if (!status.exceeded || !status.rootId)
226
+ return;
227
+ const key = keyFor(status.rootId, dayOf(new Date().toISOString()));
228
+ if (!screamed.has(key)) {
229
+ screamed.add(key);
230
+ prune(screamed, 1_024);
231
+ log.error({ rootId: status.rootId, flow: args.flow, total: status.total, budget: status.budget }, "TOKEN BUDGET EXCEEDED — refusing further model calls for this run today");
232
+ }
233
+ throw new TokenBudgetExceededError({
234
+ ...(args.flow ? { flow: args.flow } : {}),
235
+ rootId: status.rootId,
236
+ total: status.total,
237
+ budget: status.budget,
238
+ });
239
+ }
240
+ export function _resetTokenBudget() {
241
+ totals.clear();
242
+ rootOf.clear();
243
+ hydrated.clear();
244
+ screamed.clear();
245
+ cfgCache = null;
246
+ }
247
+ export function _noteUsageForTest(row) {
248
+ noteUsage(row);
249
+ }
250
+ //# sourceMappingURL=token-budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-budget.js","sourceRoot":"","sources":["../../../src/lib/budgets/token-budget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ export interface UsageRow {
2
+ sessionId: string;
3
+ rootId: string;
4
+ flow: string | null;
5
+ model: string;
6
+ turnId: string | null;
7
+ stepIndex: number | null;
8
+ at: string;
9
+ input: number;
10
+ output: number;
11
+ cacheRead: number;
12
+ cacheWrite: number;
13
+ instance: string;
14
+ }
15
+ type UsageListener = (row: UsageRow) => void;
16
+ export declare function onUsageRecorded(fn: UsageListener): () => void;
17
+ export declare function recordUsage(r: UsageRow): Promise<void>;
18
+ export interface AggregateQuery {
19
+ from: string;
20
+ to: string;
21
+ bucket: "day" | "hour";
22
+ instance?: string;
23
+ }
24
+ export interface UsageBreakdownRow {
25
+ key: string | null;
26
+ input: number;
27
+ output: number;
28
+ total: number;
29
+ requests: number;
30
+ cacheRead?: number;
31
+ cacheWrite?: number;
32
+ }
33
+ export interface UsageRootRow {
34
+ rootId: string;
35
+ input: number;
36
+ output: number;
37
+ total: number;
38
+ requests: number;
39
+ }
40
+ export interface UsageAggregate {
41
+ totals: {
42
+ input: number;
43
+ output: number;
44
+ cacheRead: number;
45
+ cacheWrite: number;
46
+ requests: number;
47
+ sessions: number;
48
+ };
49
+ series: {
50
+ at: string;
51
+ input: number;
52
+ output: number;
53
+ cacheRead: number;
54
+ cacheWrite: number;
55
+ }[];
56
+ seriesByModel: {
57
+ at: string;
58
+ model: string;
59
+ total: number;
60
+ }[];
61
+ byModel: UsageBreakdownRow[];
62
+ byFlow: UsageBreakdownRow[];
63
+ byInstance: UsageBreakdownRow[];
64
+ byRoot: UsageRootRow[];
65
+ }
66
+ export declare function readUsageAggregate(q: AggregateQuery): Promise<UsageAggregate>;
67
+ export declare function readRunUsageByModel(rootId: string, flow?: string): Promise<UsageBreakdownRow[]>;
68
+ export declare function readRootDayTotal(rootId: string, dayIso: string): Promise<number>;
69
+ export interface LogsQuery {
70
+ limit: number;
71
+ before?: number;
72
+ flow?: string;
73
+ model?: string;
74
+ instance?: string;
75
+ }
76
+ export interface UsageLogRow {
77
+ id: number;
78
+ sessionId: string;
79
+ rootId: string;
80
+ flow: string | null;
81
+ model: string;
82
+ at: string;
83
+ input: number;
84
+ output: number;
85
+ cacheRead: number;
86
+ cacheWrite: number;
87
+ instance: string;
88
+ }
89
+ export interface UsageLogsPage {
90
+ rows: UsageLogRow[];
91
+ nextCursor: number | null;
92
+ hasMore: boolean;
93
+ }
94
+ export declare function readUsageLogsPage(q: LogsQuery): Promise<UsageLogsPage>;
95
+ export {};
96
+ //# sourceMappingURL=token-usage-pg.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-usage-pg.d.ts","sourceRoot":"","sources":["../../../src/lib/budgets/token-usage-pg.ts"],"names":[],"mappings":"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"}