@tech-leads-club/harness-toolkit 0.2.1

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 (300) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/LICENSE +84 -0
  3. package/NOTICE +9 -0
  4. package/README.md +480 -0
  5. package/bin/tlc +10 -0
  6. package/bin/tlc-build +80 -0
  7. package/bin/tlc-cli.ts +1509 -0
  8. package/bin/tlc-exec +10 -0
  9. package/bin/tlc-exec.cmd +4 -0
  10. package/bin/tlc-exec.d.mts +60 -0
  11. package/bin/tlc-exec.mjs +248 -0
  12. package/bin/tlc.cmd +4 -0
  13. package/bin/tlc.mjs +7 -0
  14. package/bin/write-user-hooks.d.mts +40 -0
  15. package/bin/write-user-hooks.mjs +123 -0
  16. package/capabilities/catalog.json +418 -0
  17. package/config.example.json +51 -0
  18. package/dist/compact-before.mjs +7839 -0
  19. package/dist/doctor.mjs +8263 -0
  20. package/dist/help-topic.mjs +82 -0
  21. package/dist/init-project.mjs +993 -0
  22. package/dist/install-runtime.mjs +969 -0
  23. package/dist/lessons-cli.mjs +7258 -0
  24. package/dist/obs-cli.mjs +7025 -0
  25. package/dist/price-lookup.mjs +221 -0
  26. package/dist/prompt-submit.mjs +7860 -0
  27. package/dist/refresh-model-prices.mjs +158 -0
  28. package/dist/response-after.mjs +7879 -0
  29. package/dist/run.mjs +7830 -0
  30. package/dist/session-end.mjs +7937 -0
  31. package/dist/session-start.mjs +8056 -0
  32. package/dist/shim.mjs +52 -0
  33. package/dist/stop.mjs +8494 -0
  34. package/dist/subagent-start.mjs +7861 -0
  35. package/dist/subagent-stop.mjs +7851 -0
  36. package/dist/support.mjs +7045 -0
  37. package/dist/tlc-cli.mjs +8063 -0
  38. package/dist/tool-after.mjs +8113 -0
  39. package/dist/tool-before.mjs +7985 -0
  40. package/dist/tool-failure.mjs +7850 -0
  41. package/dist/uninstall-runtime.mjs +1307 -0
  42. package/docs/architecture.md +270 -0
  43. package/docs/concepts.md +562 -0
  44. package/docs/coverage.md +55 -0
  45. package/docs/decisions/ad-001.md +32 -0
  46. package/docs/decisions/ad-002.md +51 -0
  47. package/docs/decisions/ad-003.md +30 -0
  48. package/docs/decisions/ad-004.md +37 -0
  49. package/docs/decisions/ad-005.md +36 -0
  50. package/docs/decisions/ad-006.md +49 -0
  51. package/docs/decisions/ad-007.md +36 -0
  52. package/docs/decisions/ad-008.md +54 -0
  53. package/docs/decisions/ad-009.md +61 -0
  54. package/docs/decisions/ad-010.md +45 -0
  55. package/docs/decisions/ad-011.md +59 -0
  56. package/docs/decisions/ad-012.md +71 -0
  57. package/docs/decisions/ad-013.md +87 -0
  58. package/docs/decisions/ad-014.md +56 -0
  59. package/docs/decisions/ad-015.md +33 -0
  60. package/docs/decisions/ad-016.md +98 -0
  61. package/docs/decisions/ad-017.md +65 -0
  62. package/docs/decisions/ad-018.md +77 -0
  63. package/docs/decisions/ad-019.md +75 -0
  64. package/docs/decisions/ad-020.md +88 -0
  65. package/docs/decisions/ad-021.md +57 -0
  66. package/docs/decisions/ad-022.md +120 -0
  67. package/docs/decisions/ad-023.md +87 -0
  68. package/docs/decisions/ad-024.md +85 -0
  69. package/docs/decisions/ad-025.md +92 -0
  70. package/docs/decisions/ad-026.md +131 -0
  71. package/docs/decisions/ad-027.md +90 -0
  72. package/docs/decisions/ad-028.md +90 -0
  73. package/docs/decisions/ad-029.md +73 -0
  74. package/docs/decisions/ad-030.md +97 -0
  75. package/docs/decisions/ad-031.md +94 -0
  76. package/docs/decisions/ad-032.md +83 -0
  77. package/docs/decisions/ad-033.md +89 -0
  78. package/docs/decisions/ad-034.md +86 -0
  79. package/docs/decisions/ad-035.md +86 -0
  80. package/docs/decisions/ad-036.md +68 -0
  81. package/docs/decisions/ad-037.md +47 -0
  82. package/docs/decisions/ad-038.md +52 -0
  83. package/docs/decisions/ad-039.md +69 -0
  84. package/docs/decisions/ad-040.md +89 -0
  85. package/docs/decisions/ad-041.md +98 -0
  86. package/docs/decisions/ad-042.md +82 -0
  87. package/docs/decisions/ad-043.md +79 -0
  88. package/docs/decisions/ad-044.md +61 -0
  89. package/docs/decisions/ad-045.md +94 -0
  90. package/docs/decisions/ad-046.md +111 -0
  91. package/docs/decisions/ad-047.md +96 -0
  92. package/docs/decisions/ad-048.md +85 -0
  93. package/docs/decisions/ad-049.md +66 -0
  94. package/docs/decisions/ad-050.md +94 -0
  95. package/docs/decisions/ad-051.md +69 -0
  96. package/docs/decisions/ad-052.md +69 -0
  97. package/docs/decisions/ad-053.md +78 -0
  98. package/docs/decisions/ad-054.md +98 -0
  99. package/docs/decisions/ad-055.md +74 -0
  100. package/docs/decisions/ad-056.md +85 -0
  101. package/docs/decisions/ad-057.md +68 -0
  102. package/docs/decisions/ad-058.md +97 -0
  103. package/docs/decisions/ad-059.md +82 -0
  104. package/docs/decisions/ad-060.md +75 -0
  105. package/docs/decisions/ad-061.md +68 -0
  106. package/docs/decisions/ad-062.md +72 -0
  107. package/docs/decisions/ad-063.md +84 -0
  108. package/docs/decisions/ad-064.md +79 -0
  109. package/docs/decisions/ad-065.md +81 -0
  110. package/docs/decisions/ad-066.md +111 -0
  111. package/docs/decisions/ad-067.md +64 -0
  112. package/docs/decisions/ad-068.md +79 -0
  113. package/docs/decisions/ad-069.md +74 -0
  114. package/docs/decisions/ad-070.md +86 -0
  115. package/docs/decisions/ad-071.md +93 -0
  116. package/docs/decisions/ad-072.md +82 -0
  117. package/docs/decisions/ad-073.md +102 -0
  118. package/docs/decisions/ad-074.md +91 -0
  119. package/docs/decisions/ad-075.md +79 -0
  120. package/docs/decisions/ad-076.md +102 -0
  121. package/docs/decisions/ad-077.md +94 -0
  122. package/docs/decisions/ad-078.md +84 -0
  123. package/docs/decisions/ad-079.md +73 -0
  124. package/docs/decisions/ad-080.md +86 -0
  125. package/docs/decisions/ad-081.md +70 -0
  126. package/docs/decisions/ad-082.md +79 -0
  127. package/docs/decisions/ad-083.md +88 -0
  128. package/docs/decisions/index.md +111 -0
  129. package/docs/diagnose.md +248 -0
  130. package/docs/index.md +52 -0
  131. package/docs/init.md +101 -0
  132. package/docs/lessons.md +294 -0
  133. package/docs/log.md +139 -0
  134. package/docs/measure.md +178 -0
  135. package/docs/providers/claude-code.md +118 -0
  136. package/docs/providers/cursor.md +110 -0
  137. package/docs/providers/index.md +71 -0
  138. package/docs/troubleshooting.md +138 -0
  139. package/model-aliases.json +12 -0
  140. package/model-prices.cursor.json +410 -0
  141. package/model-prices.json +1 -0
  142. package/package.json +57 -0
  143. package/skills/harness-init/SKILL.md +241 -0
  144. package/skills/harness-init/evals/trigger_evals.json +86 -0
  145. package/skills/harness-init/references/capabilities.md +113 -0
  146. package/src/contracts/capabilities.ts +30 -0
  147. package/src/contracts/decision.ts +21 -0
  148. package/src/contracts/effort.ts +15 -0
  149. package/src/contracts/harness-event.ts +87 -0
  150. package/src/contracts/index.ts +6 -0
  151. package/src/contracts/policy-defaults.ts +14 -0
  152. package/src/contracts/wiring.ts +20 -0
  153. package/src/core/attest/attest.service.ts +0 -0
  154. package/src/core/capability/capability.service.ts +62 -0
  155. package/src/core/capability/capability.store.ts +51 -0
  156. package/src/core/capability/capability.types.ts +56 -0
  157. package/src/core/comment-policy/comment-policy.service.ts +307 -0
  158. package/src/core/comment-policy/comment-policy.types.ts +6 -0
  159. package/src/core/comment-policy/comment-resolvability.ts +134 -0
  160. package/src/core/comment-policy/comment-syntax.catalog.ts +310 -0
  161. package/src/core/comment-policy/comment-syntax.store.ts +65 -0
  162. package/src/core/comment-policy/comment-syntax.types.ts +24 -0
  163. package/src/core/core.facade.ts +461 -0
  164. package/src/core/duplication/duplication.service.ts +219 -0
  165. package/src/core/floor/floor.catalog.ts +54 -0
  166. package/src/core/floor/floor.paths.ts +90 -0
  167. package/src/core/floor/floor.policy-surface.ts +311 -0
  168. package/src/core/floor/floor.service.ts +306 -0
  169. package/src/core/floor/floor.tokenize.ts +179 -0
  170. package/src/core/floor/floor.verb.ts +28 -0
  171. package/src/core/floor/index.ts +1 -0
  172. package/src/core/gate/gate.artifact.ts +157 -0
  173. package/src/core/gate/gate.command.ts +130 -0
  174. package/src/core/gate/gate.findings.ts +201 -0
  175. package/src/core/gate/gate.inputs.ts +0 -0
  176. package/src/core/gate/gate.lock.ts +283 -0
  177. package/src/core/gate/gate.service.ts +28 -0
  178. package/src/core/gate/gate.types.ts +67 -0
  179. package/src/core/handoff/handoff.service.ts +43 -0
  180. package/src/core/handoff/handoff.store.ts +59 -0
  181. package/src/core/handoff/handoff.types.ts +89 -0
  182. package/src/core/index.ts +52 -0
  183. package/src/core/integrity/state-seal.ts +81 -0
  184. package/src/core/lesson/lesson.authored.ts +96 -0
  185. package/src/core/lesson/lesson.credit.ts +51 -0
  186. package/src/core/lesson/lesson.garden.ts +283 -0
  187. package/src/core/lesson/lesson.link.ts +93 -0
  188. package/src/core/lesson/lesson.score.ts +61 -0
  189. package/src/core/lesson/lesson.select.ts +209 -0
  190. package/src/core/lesson/lesson.service.ts +110 -0
  191. package/src/core/lesson/lesson.store.ts +317 -0
  192. package/src/core/lesson/lesson.sync.ts +70 -0
  193. package/src/core/lesson/lesson.types.ts +92 -0
  194. package/src/core/lesson/lesson.validity.ts +44 -0
  195. package/src/core/observability/observability.report.ts +326 -0
  196. package/src/core/observability/observability.service.ts +328 -0
  197. package/src/core/observability/observability.store.ts +269 -0
  198. package/src/core/observability/observability.types.ts +193 -0
  199. package/src/core/observability/observability.why.ts +206 -0
  200. package/src/core/observe/observe.service.ts +76 -0
  201. package/src/core/plan/plan.detect.ts +47 -0
  202. package/src/core/plan/plan.service.ts +81 -0
  203. package/src/core/plan/plan.types.ts +25 -0
  204. package/src/core/policy/policy.defaults.ts +103 -0
  205. package/src/core/policy/policy.guard.ts +34 -0
  206. package/src/core/policy/policy.integrity.ts +238 -0
  207. package/src/core/policy/policy.loader.ts +118 -0
  208. package/src/core/policy/policy.operator.ts +82 -0
  209. package/src/core/policy/policy.posture.ts +79 -0
  210. package/src/core/policy/policy.rails.ts +45 -0
  211. package/src/core/policy/policy.types.ts +157 -0
  212. package/src/core/presence/presence.service.ts +111 -0
  213. package/src/core/presence/presence.store.ts +59 -0
  214. package/src/core/presence/presence.types.ts +9 -0
  215. package/src/core/release/release.decisions.ts +147 -0
  216. package/src/core/release/release.seen.ts +38 -0
  217. package/src/core/shell-policy/shell-policy.service.ts +215 -0
  218. package/src/core/shell-policy/shell-policy.stall.ts +57 -0
  219. package/src/core/shell-policy/shell-policy.types.ts +26 -0
  220. package/src/core/ship/ship.ledger.ts +76 -0
  221. package/src/core/ship/ship.service.ts +137 -0
  222. package/src/core/ship/ship.types.ts +19 -0
  223. package/src/core/stagnation/stagnation.resolution.ts +87 -0
  224. package/src/core/stagnation/stagnation.service.ts +20 -0
  225. package/src/core/stagnation/stagnation.store.ts +49 -0
  226. package/src/core/stagnation/stagnation.types.ts +12 -0
  227. package/src/core/subagent-policy/subagent-policy.parent-model.ts +202 -0
  228. package/src/core/subagent-policy/subagent-policy.service.ts +139 -0
  229. package/src/core/subagent-policy/subagent-policy.types.ts +22 -0
  230. package/src/core/supply-chain/supply-chain.catalog.ts +51 -0
  231. package/src/core/supply-chain/supply-chain.service.ts +217 -0
  232. package/src/core/turn/turn.activity.ts +94 -0
  233. package/src/core/turn/turn.autopilot.ts +131 -0
  234. package/src/core/turn/turn.failure-signals.ts +193 -0
  235. package/src/core/turn/turn.loop-counter.ts +71 -0
  236. package/src/core/turn/turn.types.ts +14 -0
  237. package/src/core/untrusted/untrusted.detect.ts +53 -0
  238. package/src/core/untrusted/untrusted.recall.ts +87 -0
  239. package/src/core/untrusted/untrusted.service.ts +129 -0
  240. package/src/core/untrusted/untrusted.store.ts +75 -0
  241. package/src/core/untrusted/untrusted.types.ts +42 -0
  242. package/src/entrypoints/compact-before.ts +14 -0
  243. package/src/entrypoints/prompt-submit.ts +25 -0
  244. package/src/entrypoints/response-after.ts +60 -0
  245. package/src/entrypoints/run.ts +179 -0
  246. package/src/entrypoints/session-end.ts +58 -0
  247. package/src/entrypoints/session-start.ts +172 -0
  248. package/src/entrypoints/shim.ts +46 -0
  249. package/src/entrypoints/stop.ts +876 -0
  250. package/src/entrypoints/subagent-start.ts +16 -0
  251. package/src/entrypoints/subagent-stop.ts +32 -0
  252. package/src/entrypoints/support.ts +182 -0
  253. package/src/entrypoints/tool-after.ts +111 -0
  254. package/src/entrypoints/tool-before.ts +186 -0
  255. package/src/entrypoints/tool-failure.ts +26 -0
  256. package/src/platform/backoff.ts +49 -0
  257. package/src/platform/cli-output.ts +30 -0
  258. package/src/platform/env-scope.ts +22 -0
  259. package/src/platform/fs-atomic.ts +142 -0
  260. package/src/platform/fs-jsonl.ts +24 -0
  261. package/src/platform/git.ts +187 -0
  262. package/src/platform/paths.ts +80 -0
  263. package/src/platform/pricing.ts +229 -0
  264. package/src/platform/process.ts +64 -0
  265. package/src/platform/sanitize.ts +23 -0
  266. package/src/platform/screen.ts +46 -0
  267. package/src/platform/style.ts +103 -0
  268. package/src/providers/claude/claude.capabilities.ts +25 -0
  269. package/src/providers/claude/claude.detect.ts +14 -0
  270. package/src/providers/claude/claude.inbound.ts +252 -0
  271. package/src/providers/claude/claude.lessons-view.ts +33 -0
  272. package/src/providers/claude/claude.outbound.ts +65 -0
  273. package/src/providers/claude/claude.policy-defaults.ts +9 -0
  274. package/src/providers/claude/claude.transcript.ts +62 -0
  275. package/src/providers/claude/claude.wiring.ts +245 -0
  276. package/src/providers/claude/index.ts +17 -0
  277. package/src/providers/cursor/cursor.capabilities.ts +28 -0
  278. package/src/providers/cursor/cursor.detect.ts +14 -0
  279. package/src/providers/cursor/cursor.inbound.ts +203 -0
  280. package/src/providers/cursor/cursor.lessons-view.ts +30 -0
  281. package/src/providers/cursor/cursor.outbound.ts +43 -0
  282. package/src/providers/cursor/cursor.policy-defaults.ts +9 -0
  283. package/src/providers/cursor/cursor.wiring.ts +214 -0
  284. package/src/providers/cursor/index.ts +17 -0
  285. package/src/providers/index.ts +9 -0
  286. package/src/providers/provider.degrade.ts +152 -0
  287. package/src/providers/provider.port.ts +20 -0
  288. package/src/providers/provider.registry.ts +28 -0
  289. package/tools/doctor.ts +631 -0
  290. package/tools/help-topic.ts +74 -0
  291. package/tools/init-project.ts +277 -0
  292. package/tools/install-runtime.ts +164 -0
  293. package/tools/lessons-cli.ts +474 -0
  294. package/tools/obs-cli.ts +175 -0
  295. package/tools/price-lookup.ts +57 -0
  296. package/tools/refresh-model-prices.ts +210 -0
  297. package/tools/test-env.mjs +28 -0
  298. package/tools/test-env.names.d.mts +1 -0
  299. package/tools/test-env.names.mjs +14 -0
  300. package/tools/uninstall-runtime.ts +463 -0
@@ -0,0 +1,221 @@
1
+ import { createRequire } from "node:module";
2
+ var __require = /* @__PURE__ */ createRequire(import.meta.url);
3
+
4
+ // src/platform/cli-output.ts
5
+ var JSON_FLAG = "--json";
6
+ function takeJsonFlag(args) {
7
+ const rest = [];
8
+ let json = false;
9
+ for (const arg of args) {
10
+ if (arg === JSON_FLAG) {
11
+ json = true;
12
+ continue;
13
+ }
14
+ rest.push(arg);
15
+ }
16
+ return { json, rest };
17
+ }
18
+ function emitJson(value, write = writeStdout) {
19
+ write(`${JSON.stringify(value)}
20
+ `);
21
+ }
22
+ function writeStdout(text) {
23
+ process.stdout.write(text);
24
+ }
25
+
26
+ // src/platform/pricing.ts
27
+ import { existsSync, readFileSync } from "node:fs";
28
+ import { join as join2 } from "node:path";
29
+
30
+ // src/platform/paths.ts
31
+ import { homedir } from "node:os";
32
+ import { join } from "node:path";
33
+ function conventionalRuntimeHome() {
34
+ return join(homedir(), ".tlc", "harness");
35
+ }
36
+ function runtimeHome(env = process.env) {
37
+ return env.TLC_HOME ?? conventionalRuntimeHome();
38
+ }
39
+
40
+ // src/platform/pricing.ts
41
+ function readJsonFile(path) {
42
+ if (!existsSync(path)) {
43
+ return null;
44
+ }
45
+ try {
46
+ return JSON.parse(readFileSync(path, "utf8"));
47
+ } catch {
48
+ return null;
49
+ }
50
+ }
51
+ function stripMeta(table) {
52
+ if (!table) {
53
+ return {};
54
+ }
55
+ const { _meta: _ignored, ...rest } = table;
56
+ return rest;
57
+ }
58
+ function slugifyModelName(name) {
59
+ return name.trim().toLowerCase().replace(/[[\]]/g, "").replace(/\(.*?\)/g, "").replace(/[^a-z0-9.+]+/g, "-").replace(/^-+|-+$/g, "");
60
+ }
61
+ function candidatesFor(model, aliases) {
62
+ const trimmed = model.trim();
63
+ const out = [];
64
+ const push = (v) => {
65
+ if (v && !out.includes(v)) {
66
+ out.push(v);
67
+ }
68
+ };
69
+ push(trimmed);
70
+ push(aliases[trimmed]);
71
+ push(slugifyModelName(trimmed));
72
+ push(aliases[slugifyModelName(trimmed)]);
73
+ if (trimmed.includes("/")) {
74
+ push(trimmed.slice(trimmed.lastIndexOf("/") + 1));
75
+ }
76
+ const noEffort = trimmed.replace(/-(high|medium|low|max|fast|thinking)$/i, "");
77
+ if (noEffort !== trimmed) {
78
+ push(noEffort);
79
+ push(aliases[noEffort]);
80
+ push(slugifyModelName(noEffort));
81
+ }
82
+ return out;
83
+ }
84
+ function fuzzyFind(table, needle) {
85
+ const direct = table[needle];
86
+ if (direct) {
87
+ return { key: needle, entry: direct };
88
+ }
89
+ for (const [key, entry] of Object.entries(table)) {
90
+ if (needle.startsWith(key) || key.startsWith(needle)) {
91
+ return { key, entry };
92
+ }
93
+ }
94
+ return;
95
+ }
96
+ function overridesPath() {
97
+ return join2(runtimeHome(), "model-prices.json");
98
+ }
99
+ function providerNativePath(provider) {
100
+ return join2(runtimeHome(), `model-prices.${provider}.json`);
101
+ }
102
+ function litellmPath() {
103
+ return join2(runtimeHome(), "model-prices.litellm.json");
104
+ }
105
+ function aliasesPath() {
106
+ return join2(runtimeHome(), "model-aliases.json");
107
+ }
108
+ function resolveModelPrice(provider, model) {
109
+ const trimmed = model.trim();
110
+ if (!trimmed) {
111
+ return;
112
+ }
113
+ const overrides = stripMeta(readJsonFile(overridesPath()));
114
+ const native = stripMeta(readJsonFile(providerNativePath(provider)));
115
+ const litellm = stripMeta(readJsonFile(litellmPath()));
116
+ const aliases = readJsonFile(aliasesPath()) ?? {};
117
+ const candidates = candidatesFor(trimmed, aliases);
118
+ for (const id of candidates) {
119
+ const entry = overrides[id];
120
+ if (entry) {
121
+ return { entry, key: id, source: "override" };
122
+ }
123
+ }
124
+ for (const id of candidates) {
125
+ const entry = native[id];
126
+ if (entry) {
127
+ return { entry, key: id, source: "provider" };
128
+ }
129
+ }
130
+ for (const id of candidates) {
131
+ const entry = litellm[id];
132
+ if (entry) {
133
+ return { entry, key: id, source: "litellm" };
134
+ }
135
+ }
136
+ const slug = slugifyModelName(trimmed);
137
+ const fuzzyOverride = fuzzyFind(overrides, slug);
138
+ if (fuzzyOverride) {
139
+ return { ...fuzzyOverride, source: "override" };
140
+ }
141
+ const fuzzyNative = fuzzyFind(native, slug);
142
+ if (fuzzyNative) {
143
+ return { ...fuzzyNative, source: "provider" };
144
+ }
145
+ const fuzzyLitellm = fuzzyFind(litellm, slug);
146
+ if (fuzzyLitellm) {
147
+ return { ...fuzzyLitellm, source: "litellm" };
148
+ }
149
+ return;
150
+ }
151
+ function estimateCostUsd(provider, model, usage) {
152
+ const inputTokens = usage.inputTokens ?? 0;
153
+ const outputTokens = usage.outputTokens ?? 0;
154
+ const cacheReadTokens = usage.cacheReadTokens ?? 0;
155
+ const cacheWriteTokens = usage.cacheWriteTokens ?? 0;
156
+ if (!model || inputTokens <= 0 && outputTokens <= 0 && cacheReadTokens <= 0 && cacheWriteTokens <= 0) {
157
+ return { costUsd: null, billing: "unknown", pool: "unknown", source: "missing" };
158
+ }
159
+ const resolved = resolveModelPrice(provider, model);
160
+ if (!resolved) {
161
+ return { costUsd: null, billing: "unknown", pool: "unknown", source: "missing" };
162
+ }
163
+ const { entry, key, source } = resolved;
164
+ const pool = entry.pool ?? "unknown";
165
+ if (entry.billing === "included") {
166
+ return { costUsd: null, billing: "included", pool, source, catalogKey: key };
167
+ }
168
+ if (typeof entry.promptPer1M !== "number" || typeof entry.completionPer1M !== "number") {
169
+ return { costUsd: null, billing: entry.billing ?? "unknown", pool, source, catalogKey: key };
170
+ }
171
+ let costUsd = inputTokens / 1e6 * entry.promptPer1M + outputTokens / 1e6 * entry.completionPer1M;
172
+ if (typeof entry.cacheReadPer1M === "number" && cacheReadTokens > 0) {
173
+ costUsd += cacheReadTokens / 1e6 * entry.cacheReadPer1M;
174
+ }
175
+ if (typeof entry.cacheWritePer1M === "number" && cacheWriteTokens > 0) {
176
+ costUsd += cacheWriteTokens / 1e6 * entry.cacheWritePer1M;
177
+ }
178
+ return { costUsd, billing: "metered", pool, source, catalogKey: key };
179
+ }
180
+
181
+ // tools/price-lookup.ts
182
+ function parsePriceLookupArgs(argv) {
183
+ const model = argv[0];
184
+ if (!model) {
185
+ return null;
186
+ }
187
+ return { model, provider: argv[1] ?? "" };
188
+ }
189
+ function lookupPrice(args) {
190
+ const resolved = resolveModelPrice(args.provider, args.model);
191
+ const per1M = estimateCostUsd(args.provider, args.model, {
192
+ inputTokens: 1e6,
193
+ outputTokens: 1e6
194
+ });
195
+ return { model: args.model, provider: args.provider, resolved, per1M };
196
+ }
197
+ function main() {
198
+ const { json, rest } = takeJsonFlag(process.argv.slice(2));
199
+ const args = parsePriceLookupArgs(rest);
200
+ if (!args) {
201
+ console.error("usage: tlc harness prices lookup <model-id> [provider]");
202
+ console.error(" or: node --experimental-strip-types tools/price-lookup.ts <model-id> [provider] (dev)");
203
+ process.exit(1);
204
+ }
205
+ const result = lookupPrice(args);
206
+ if (json) {
207
+ emitJson(result);
208
+ } else {
209
+ console.log(JSON.stringify(result, null, 2));
210
+ }
211
+ if (!result.resolved) {
212
+ process.exit(2);
213
+ }
214
+ }
215
+ if (__require.main == __require.module) {
216
+ main();
217
+ }
218
+ export {
219
+ parsePriceLookupArgs,
220
+ lookupPrice
221
+ };