@openai/codex-security 0.8.3 → 0.9.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 (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"continuum-findings.js","sourceRoot":"","sources":["../src/continuum-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport {\n type ExternalImportTarget,\n validateExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { Provider } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n array,\n normalizeRecords,\n readScannerJson,\n record,\n repositoryFilePath,\n requiredText,\n strings,\n text,\n} from \"./scanner-import.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst format = \"aws-continuum-code-findings/v1\";\nconst findingArn =\n /^(arn:[a-z0-9-]+:continuum:[a-z0-9-]+:\\d{12}:environments\\/([a-z0-9]+))\\/code-findings\\/([a-z0-9]+)$/u;\n\nfunction identity(value: unknown) {\n const row = record(value, \"Continuum finding\");\n const arn = requiredText(row[\"findingArn\"], \"Continuum finding ARN\");\n const match = findingArn.exec(arn);\n if (\n !match ||\n row[\"environmentId\"] !== match[2] ||\n row[\"findingId\"] !== match[3]\n )\n throw new Error(\n \"Expected a Continuum finding ARN matching its environmentId and findingId.\",\n );\n return { arn, scope: match[1]! };\n}\n\nfunction retainedRepository(\n provider: Provider,\n finding: ExternalFinding,\n target: ExternalImportTarget,\n) {\n const {\n source_finding_id: id,\n evidence: { source_data: data },\n } = finding;\n const native = data?.[\"finding\"];\n const marked = data?.[\"format\"] === format;\n const nativeArn =\n isRecord(native) && findingArn.test(text(native[\"findingArn\"]) ?? \"\");\n if (provider !== \"continuum\") {\n if (\n marked ||\n (data?.[\"sourceRepositoryUrl\"] &&\n nativeArn &&\n native[\"findingArn\"] === id)\n )\n throw new CodexSecurityError(\n \"Retained AWS Continuum evidence requires the continuum provider.\",\n );\n return;\n }\n if (!marked && !nativeArn && !findingArn.test(id)) return;\n const { arn, scope } = identity(native);\n if (arn !== id)\n throw new Error(\n \"Continuum source finding ID does not match the retained finding ARN.\",\n );\n return {\n url: declaredScannerRepositoryUrl(\n data?.[\"sourceRepositoryUrl\"],\n \"Continuum\",\n target,\n ),\n scope,\n };\n}\n\nexport const continuumReportRepositories = repositoryScopeValidator(\n { provider: \"continuum\", label: \"AWS Continuum\", scope: \"environment\" },\n retainedRepository,\n);\n\nfunction codeLocations(\n row: Record<string, unknown>,\n vulnerabilities: Record<string, unknown>[],\n) {\n const locations: { path: string; line: number | null }[] = [];\n const seen = new Set<string>();\n let endLine: number | null = null;\n let snippet: string | null = null;\n function add(\n value: unknown,\n start: unknown,\n end: unknown,\n fragment: unknown,\n ) {\n const path = repositoryFilePath(value);\n if (!path) return;\n const line =\n typeof start === \"number\" && Number.isSafeInteger(start) && start > 0\n ? start\n : null;\n const key = JSON.stringify([path, line]);\n if (!seen.has(key)) {\n seen.add(key);\n locations.push({ path, line });\n }\n // The flat location and first nested location can describe the same range.\n if (locations[0]!.path === path && locations[0]!.line === line) {\n if (\n line !== null &&\n typeof end === \"number\" &&\n Number.isSafeInteger(end) &&\n end >= line\n )\n endLine ??= end;\n snippet ??= text(fragment);\n }\n }\n add(\n row[\"filePath\"],\n row[\"lineNumber\"],\n row[\"endLine\"],\n row[\"vulnerableCode\"],\n );\n for (const vulnerability of vulnerabilities) {\n for (const value of array(\n vulnerability[\"locations\"] ?? [],\n \"Continuum vulnerability locations\",\n )) {\n const location = record(value, \"Continuum vulnerability location\");\n add(\n location[\"filePath\"],\n location[\"startLine\"],\n location[\"endLine\"],\n vulnerability[\"code\"],\n );\n }\n }\n return { locations, code: { end_line: endLine, snippet } };\n}\n\nexport function normalizeContinuumFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const repository = declaredScannerRepositoryUrl(\n sourceRepositoryUrl,\n \"Continuum\",\n target,\n );\n const document = record(input, \"Continuum report\");\n if (\n Object.hasOwn(document, \"nextToken\") ||\n Object.hasOwn(document, \"NextToken\")\n )\n throw new Error(\n \"Continuum export has a continuation token; supply the complete paginated CLI output.\",\n );\n if (!(\"items\" in document || \"findingArn\" in document))\n throw new Error(\n \"Expected a Continuum ListCodeFindings or GetCodeFinding response.\",\n );\n const summary = \"items\" in document;\n const rows = summary\n ? array(document[\"items\"], \"Continuum items\")\n : [document];\n const scopes = new Set<string>();\n const output = normalizeRecords(\n rows,\n (value) => {\n const row = record(value, \"Continuum finding\");\n if (\n row[\"type\"] !== \"CONTINUUM_CODE_VULN\" &&\n row[\"type\"] !== \"CUSTOMER_CODE_VULN\"\n )\n throw new Error(\n \"Expected a Continuum code vulnerability finding type.\",\n );\n const severity = requiredText(\n row[\"severity\"],\n \"Continuum severity\",\n ).toLowerCase();\n const vulnerabilities = array(\n row[\"vulnerabilities\"] ?? [],\n \"Continuum vulnerabilities\",\n ).map((item) => record(item, \"Continuum vulnerability\"));\n const { locations, code } = codeLocations(row, vulnerabilities);\n const source = requiredText(row[\"source\"], \"Continuum source\");\n const status = requiredText(row[\"status\"], \"Continuum status\");\n const validation = record(\n row[\"validation\"] ?? {},\n \"Continuum validation\",\n );\n const all = [row, ...vulnerabilities];\n const advisoryIds = [\n ...new Set(strings(all.map((item) => item[\"cveId\"]))),\n ];\n const packageFinding =\n advisoryIds.length > 0 ||\n all.some(\n (v) =>\n Array.isArray(v[\"affectedPackages\"]) &&\n v[\"affectedPackages\"].length > 0,\n );\n const posture =\n row[\"ocsfClass\"] === \"APPLICATION_SECURITY_POSTURE_FINDING\" ||\n row[\"posture\"] != null;\n const codeFinding =\n !summary &&\n !posture &&\n !packageFinding &&\n (code.snippet !== null ||\n locations.some((location) => location.line !== null));\n return validateExternalEvidence(\n {\n title: requiredText(row[\"title\"], \"Continuum title\"),\n severity:\n severity === \"fatal\"\n ? \"critical\"\n : severity === \"other\"\n ? \"unknown\"\n : severity,\n description: text(row[\"detailedDescription\"]) ?? text(row[\"summary\"]),\n locations,\n advisory_ids: advisoryIds,\n source_scan_id: text(row[\"scanRunId\"]),\n ...(codeFinding && {\n details: {\n kind: \"sast\",\n repository: { url: repository },\n scanner_origin: source,\n scanner_verdict: text(validation[\"verdict\"]),\n source_status: status,\n weakness_ids: strings(row[\"cweIds\"]),\n remediation_instructions: text(row[\"mitigation\"]),\n code,\n },\n }),\n source_data: {\n format,\n sourceRepositoryUrl: repository,\n finding: structuredClone(row),\n },\n },\n target,\n );\n },\n (value) => {\n const { arn, scope } = identity(value);\n scopes.add(scope);\n return arn;\n },\n target,\n );\n if (scopes.size > 1)\n throw new Error(\"Continuum findings must belong to the same environment.\");\n return output;\n}\n\nexport async function readContinuumFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeContinuumFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
1
+ {"version":3,"file":"continuum-findings.js","sourceRoot":"","sources":["../src/continuum-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport {\n DEFAULT_CLOUD_STRING_BYTES,\n type ExternalImportTarget,\n validateEnrichedExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ImportedPackage, Provider } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n array,\n awsTimestampSeconds,\n concreteVersion,\n normalizeRecords,\n readScannerJson,\n record,\n repositoryFilePath,\n requiredText,\n strings,\n text,\n} from \"./scanner-import.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst format = \"aws-continuum-code-findings/v1\";\nconst findingArn =\n /^(arn:[a-z0-9-]+:continuum:[a-z0-9-]+:\\d{12}:environments\\/([a-z0-9]+))\\/code-findings\\/([a-z0-9]+)$/u;\n\nfunction identity(value: unknown) {\n const row = record(value, \"Continuum finding\");\n const arn = requiredText(row[\"findingArn\"], \"Continuum finding ARN\");\n const match = findingArn.exec(arn);\n if (\n !match ||\n row[\"environmentId\"] !== match[2] ||\n row[\"findingId\"] !== match[3]\n )\n throw new Error(\n \"Expected a Continuum finding ARN matching its environmentId and findingId.\",\n );\n return { arn, scope: match[1]! };\n}\n\nfunction retainedRepository(\n provider: Provider,\n finding: ExternalFinding,\n target: ExternalImportTarget,\n) {\n const {\n source_finding_id: id,\n evidence: { source_data: data },\n } = finding;\n const native = data?.[\"finding\"];\n const marked = data?.[\"format\"] === format;\n const nativeArn =\n isRecord(native) && findingArn.test(text(native[\"findingArn\"]) ?? \"\");\n if (provider !== \"continuum\") {\n if (\n marked ||\n (data?.[\"sourceRepositoryUrl\"] &&\n nativeArn &&\n native[\"findingArn\"] === id)\n )\n throw new CodexSecurityError(\n \"Retained AWS Continuum evidence requires the continuum provider.\",\n );\n return;\n }\n if (!marked && !nativeArn && !findingArn.test(id)) return;\n const { arn, scope } = identity(native);\n if (arn !== id)\n throw new Error(\n \"Continuum source finding ID does not match the retained finding ARN.\",\n );\n return {\n url: declaredScannerRepositoryUrl(\n data?.[\"sourceRepositoryUrl\"],\n \"Continuum\",\n target,\n ),\n scope,\n };\n}\n\nexport const continuumReportRepositories = repositoryScopeValidator(\n { provider: \"continuum\", label: \"AWS Continuum\", scope: \"environment\" },\n retainedRepository,\n);\n\nfunction codeLocations(\n row: Record<string, unknown>,\n vulnerabilities: Record<string, unknown>[],\n) {\n const locations: { path: string; line: number | null }[] = [];\n const seen = new Set<string>();\n let endLine: number | null = null;\n let snippet: string | null = null;\n function add(\n value: unknown,\n start: unknown,\n end: unknown,\n fragment: unknown,\n ) {\n const path = repositoryFilePath(value);\n if (!path) return;\n const line =\n typeof start === \"number\" && Number.isSafeInteger(start) && start > 0\n ? start\n : null;\n const key = JSON.stringify([path, line]);\n if (!seen.has(key)) {\n seen.add(key);\n locations.push({ path, line });\n }\n // The flat location and first nested location can describe the same range.\n if (locations[0]!.path === path && locations[0]!.line === line) {\n if (\n line !== null &&\n typeof end === \"number\" &&\n Number.isSafeInteger(end) &&\n end >= line\n )\n endLine ??= end;\n snippet ??= text(fragment);\n }\n }\n add(\n row[\"filePath\"],\n row[\"lineNumber\"],\n row[\"endLine\"],\n row[\"vulnerableCode\"],\n );\n for (const vulnerability of vulnerabilities) {\n for (const value of array(\n vulnerability[\"locations\"] ?? [],\n \"Continuum vulnerability locations\",\n )) {\n const location = record(value, \"Continuum vulnerability location\");\n add(\n location[\"filePath\"],\n location[\"startLine\"],\n location[\"endLine\"],\n vulnerability[\"code\"],\n );\n }\n }\n return { locations, code: { end_line: endLine, snippet } };\n}\n\nfunction reportRows(input: unknown, previous: boolean) {\n if (Array.isArray(input) && !previous) return { rows: input, summary: false };\n const document = record(input, \"Continuum report\");\n if (\n Object.hasOwn(document, \"nextToken\") ||\n Object.hasOwn(document, \"NextToken\")\n )\n throw new Error(\n \"Continuum export has a continuation token; supply the complete paginated CLI output.\",\n );\n if (!(\"items\" in document || \"findingArn\" in document))\n throw new Error(\n \"Expected a Continuum ListCodeFindings or GetCodeFinding response.\",\n );\n const summary = \"items\" in document;\n return {\n rows: summary ? array(document[\"items\"], \"Continuum items\") : [document],\n summary,\n };\n}\n\nfunction statusUpdatedAt(value: unknown) {\n const seconds = Math.floor(awsTimestampSeconds(value));\n return Number.isSafeInteger(seconds) && seconds >= 0 ? seconds : null;\n}\n\nconst versionEcosystems = new Map([\n [\"gradle\", \"maven\"],\n [\"pnpm\", \"npm\"],\n [\"yarn\", \"npm\"],\n]);\n\nfunction affectedPackages(\n items: unknown[],\n target: ExternalImportTarget,\n): ImportedPackage[] {\n const unique = new Map<string, ImportedPackage>();\n const field = (value: unknown) => {\n const result = text(value);\n return result &&\n !result.includes(\"\\0\") &&\n (target === \"local\" ||\n Buffer.byteLength(result) <= DEFAULT_CLOUD_STRING_BYTES)\n ? result\n : null;\n };\n for (const item of items) {\n if (!isRecord(item)) continue;\n const name = field(item[\"name\"]);\n if (!name) continue;\n const ecosystem = field(item[\"packageManager\"]);\n const manager = ecosystem?.toLowerCase();\n const syntax = manager ? (versionEcosystems.get(manager) ?? manager) : null;\n const version = (value: unknown) =>\n concreteVersion(field(value), syntax, false);\n const fixed = version(item[\"fixedInVersion\"]);\n const pkg = {\n name,\n ecosystem,\n installed_version: version(item[\"version\"]),\n fixed_versions: fixed ? [fixed] : [],\n };\n unique.set(JSON.stringify(pkg), pkg);\n // The Cloud contract accepts 100 structured packages. The native row keeps them all.\n if (target === \"cloud\" && unique.size === 100) break;\n }\n return [...unique.values()];\n}\n\nfunction normalize(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget,\n previous: boolean,\n): ExternalFindings {\n const repository = declaredScannerRepositoryUrl(\n sourceRepositoryUrl,\n \"Continuum\",\n target,\n );\n const { rows, summary } = reportRows(input, previous);\n const scopes = new Set<string>();\n const output = normalizeRecords(\n rows,\n (value) => {\n const row = record(value, \"Continuum finding\");\n if (\n row[\"type\"] !== \"CONTINUUM_CODE_VULN\" &&\n row[\"type\"] !== \"CUSTOMER_CODE_VULN\"\n )\n throw new Error(\n \"Expected a Continuum code vulnerability finding type.\",\n );\n const severity = requiredText(\n row[\"severity\"],\n \"Continuum severity\",\n ).toLowerCase();\n const vulnerabilities = array(\n row[\"vulnerabilities\"] ?? [],\n \"Continuum vulnerabilities\",\n ).map((item) => record(item, \"Continuum vulnerability\"));\n const { locations, code } = codeLocations(row, vulnerabilities);\n const source = requiredText(row[\"source\"], \"Continuum source\");\n const status = requiredText(row[\"status\"], \"Continuum status\");\n const validation = record(\n row[\"validation\"] ?? {},\n \"Continuum validation\",\n );\n const all = [row, ...vulnerabilities];\n const advisoryIds = [\n ...new Set(strings(all.map((item) => item[\"cveId\"]))),\n ];\n const packages = all.flatMap((item) =>\n Array.isArray(item[\"affectedPackages\"]) ? item[\"affectedPackages\"] : [],\n );\n const packageFinding = advisoryIds.length > 0 || packages.length > 0;\n const posture =\n row[\"ocsfClass\"] === \"APPLICATION_SECURITY_POSTURE_FINDING\" ||\n row[\"posture\"] != null;\n const codeFinding =\n !summary &&\n !posture &&\n !packageFinding &&\n (code.snippet !== null ||\n locations.some((location) => location.line !== null));\n const evidence = {\n title: requiredText(row[\"title\"], \"Continuum title\"),\n severity:\n severity === \"fatal\"\n ? \"critical\"\n : severity === \"other\"\n ? \"unknown\"\n : severity,\n description: text(row[\"detailedDescription\"]) ?? text(row[\"summary\"]),\n locations,\n advisory_ids: advisoryIds,\n source_scan_id: text(row[\"scanRunId\"]),\n ...(codeFinding && {\n details: {\n kind: \"sast\",\n repository: { url: repository },\n scanner_origin: source,\n scanner_verdict: text(validation[\"verdict\"]),\n source_status: status,\n weakness_ids: strings(row[\"cweIds\"]),\n remediation_instructions: text(row[\"mitigation\"]),\n code,\n },\n }),\n source_data: {\n format,\n sourceRepositoryUrl: repository,\n finding: structuredClone(row),\n },\n };\n const updatedAt = previous\n ? null\n : statusUpdatedAt(row[\"statusUpdatedAt\"]);\n // Keep the status timestamp when structured packages exceed the Cloud budget.\n return validateEnrichedExternalEvidence(\n evidence,\n target,\n previous\n ? undefined\n : {\n packages: affectedPackages(packages, target),\n source_updated_at: updatedAt,\n },\n packages.length && updatedAt !== null\n ? { source_updated_at: updatedAt }\n : undefined,\n );\n },\n (value) => {\n const { arn, scope } = identity(value);\n scopes.add(scope);\n return arn;\n },\n target,\n );\n if (scopes.size > 1)\n throw new Error(\"Continuum findings must belong to the same environment.\");\n return output;\n}\n\nexport function normalizeContinuumFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalize(input, sourceRepositoryUrl, target, false);\n}\n\n/** @internal Reconstruct the original evidence for an interrupted Cloud request. */\nexport function normalizePreviousContinuumFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalize(input, sourceRepositoryUrl, target, true);\n}\n\nexport async function readContinuumFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeContinuumFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
@@ -8,6 +8,8 @@ export declare const SEALED_DEFERRED_PATH_RULE = "invalidSealedDeferredPath";
8
8
  export declare const DEFERRED_PATH_LOCATION: RegExp;
9
9
  /** Match the producer's Python str.strip without changing saved text. */
10
10
  export declare function hasRequiredFindingText(value: string): boolean;
11
+ /** Return canonical spelling for a valid scan-relative POSIX path. */
12
+ export declare function normalizedScanRelativePath(value: string, allowDot?: boolean): string | undefined;
11
13
  export declare function safeRelativePath(value: string, context: string, allowDot?: boolean): string;
12
14
  export declare function portableRelativePath(value: string, context: string): string;
13
15
  export declare function safeScopePath(value: string): string;
@@ -1 +1 @@
1
- {"version":3,"file":"contract-values.d.ts","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,yBAA0B,SAAQ,mBAAmB;CAAG;AAErE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,QAAuC,CAAC;AAE3E,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,UAAQ,GACf,MAAM,CA2BR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAOD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
1
+ {"version":3,"file":"contract-values.d.ts","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,yBAA0B,SAAQ,mBAAmB;CAAG;AAErE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,QAAuC,CAAC;AAE3E,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,QAAQ,UAAQ,GACf,MAAM,GAAG,SAAS,CAmBpB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,UAAQ,GACf,MAAM,CAOR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAOD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
@@ -16,24 +16,27 @@ export const DEFERRED_PATH_LOCATION = /^\/deferred\/(\d+)\/paths\/(\d+)$/u;
16
16
  export function hasRequiredFindingText(value) {
17
17
  return !/^[\p{White_Space}\u001c-\u001f]*$/u.test(value);
18
18
  }
19
- export function safeRelativePath(value, context, allowDot = false) {
20
- const parts = value.split("/");
19
+ /** Return canonical spelling for a valid scan-relative POSIX path. */
20
+ export function normalizedScanRelativePath(value, allowDot = false) {
21
21
  if (value.length === 0 ||
22
22
  Buffer.from(value, "utf8").toString("utf8") !== value ||
23
- (!allowDot && value === ".") ||
24
23
  value.startsWith("/") ||
25
24
  /^[A-Za-z]:/.test(value) ||
26
- parts.includes("..") ||
25
+ value.split("/").includes("..") ||
27
26
  value.includes("\\") ||
28
- /[\u0000-\u001f]/u.test(value)) {
29
- throw new SealedContractError(`${context}: expected a safe scan-relative POSIX path.`);
30
- }
27
+ /[\u0000-\u001f]/u.test(value))
28
+ return;
31
29
  const normalized = posix.normalize(value).replace(/\/+$/, "");
32
30
  if ((!allowDot && normalized === ".") ||
33
31
  normalized.startsWith("../") ||
34
- isAbsolute(normalized)) {
32
+ isAbsolute(normalized))
33
+ return;
34
+ return normalized;
35
+ }
36
+ export function safeRelativePath(value, context, allowDot = false) {
37
+ const normalized = normalizedScanRelativePath(value, allowDot);
38
+ if (normalized === undefined)
35
39
  throw new SealedContractError(`${context}: expected a safe scan-relative POSIX path.`);
36
- }
37
40
  return normalized;
38
41
  }
39
42
  export function portableRelativePath(value, context) {
@@ -1 +1 @@
1
- {"version":3,"file":"contract-values.js","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,mBAAmB;CAAG;AAErE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AACrE,MAAM,CAAC,MAAM,sBAAsB,GAAG,oCAAoC,CAAC;AAE3E,yEAAyE;AACzE,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,CAAC,oCAAoC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAAe,EACf,QAAQ,GAAG,KAAK;IAEhB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,KAAK;QACrD,CAAC,CAAC,QAAQ,IAAI,KAAK,KAAK,GAAG,CAAC;QAC5B,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QACxB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAC9B,CAAC;QACD,MAAM,IAAI,mBAAmB,CAC3B,GAAG,OAAO,6CAA6C,CACxD,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9D,IACE,CAAC,CAAC,QAAQ,IAAI,UAAU,KAAK,GAAG,CAAC;QACjC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5B,UAAU,CAAC,UAAU,CAAC,EACtB,CAAC;QACD,MAAM,IAAI,mBAAmB,CAC3B,GAAG,OAAO,6CAA6C,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,OAAe;IACjE,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpD,IACE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,EACnD,CAAC;QACD,MAAM,IAAI,mBAAmB,CAC3B,GAAG,OAAO,6CAA6C,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,KAAK,GAAG;QAClB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;AAC7D,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,QAAgB,EAChB,MAAc,EACd,QAA6B;IAE7B,MAAM,WAAW,GAAG,4BAA4B,UAAU,CACxD;QACE,mBAAmB;QACnB,QAAQ;QACR,MAAM;QACN,QAAQ,CAAC,MAAM;QACf,QAAQ,CAAC,QAAQ,IAAI,EAAE;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,EAAE,CAAC;IACJ,OAAO;QACL,SAAS,EAAE,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACxD,YAAY,EAAE,OAAO,UAAU,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAChF,MAAM;QACN,QAAQ;QACR,YAAY,EAAE;YACZ,SAAS,EAAE,mBAA4B;YACvC,OAAO,EAAE,WAAW;SACrB;KACF,CAAC;AACJ,CAAC","sourcesContent":["/* Generated from plugin contract-values.ts. Run `pnpm generate:models`. */\nimport { hash } from \"node:crypto\";\nimport { isAbsolute, posix } from \"node:path\";\nimport type { Finding } from \"./models.js\";\nimport { isWindowsUnsafePathComponent } from \"./windows-path.js\";\n\nexport class SealedContractError extends Error {\n constructor(message: string, options?: ErrorOptions) {\n super(message, options);\n this.name = new.target.name;\n }\n}\n\nexport class SealedContractSchemaError extends SealedContractError {}\n\nexport const SEALED_DEFERRED_PATH_RULE = \"invalidSealedDeferredPath\";\nexport const DEFERRED_PATH_LOCATION = /^\\/deferred\\/(\\d+)\\/paths\\/(\\d+)$/u;\n\n/** Match the producer's Python str.strip without changing saved text. */\nexport function hasRequiredFindingText(value: string): boolean {\n return !/^[\\p{White_Space}\\u001c-\\u001f]*$/u.test(value);\n}\n\nexport function safeRelativePath(\n value: string,\n context: string,\n allowDot = false,\n): string {\n const parts = value.split(\"/\");\n if (\n value.length === 0 ||\n Buffer.from(value, \"utf8\").toString(\"utf8\") !== value ||\n (!allowDot && value === \".\") ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(value) ||\n parts.includes(\"..\") ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001f]/u.test(value)\n ) {\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n const normalized = posix.normalize(value).replace(/\\/+$/, \"\");\n if (\n (!allowDot && normalized === \".\") ||\n normalized.startsWith(\"../\") ||\n isAbsolute(normalized)\n ) {\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function portableRelativePath(value: string, context: string): string {\n const normalized = safeRelativePath(value, context);\n if (\n value.trim().length === 0 ||\n value.split(\"/\").some(isWindowsUnsafePathComponent)\n ) {\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function safeScopePath(value: string): string {\n return value === \".\"\n ? value\n : safeRelativePath(value, \"manifest scope include path\");\n}\n\n/** @internal */\nexport function sha256Text(value: string): string {\n return hash(\"sha256\", value);\n}\n\nexport function deriveFindingIdentity(\n scanId: string,\n targetId: string,\n ruleId: string,\n identity: Finding[\"identity\"],\n) {\n const fingerprint = `codex-security/v1:sha256:${sha256Text(\n [\n \"codex-security/v1\",\n targetId,\n ruleId,\n identity.anchor,\n identity.instance ?? \"\",\n ].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256Text([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity,\n fingerprints: {\n algorithm: \"codex-security/v1\" as const,\n primary: fingerprint,\n },\n };\n}\n"]}
1
+ {"version":3,"file":"contract-values.js","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generated from plugin contract-values.ts. Run `pnpm generate:models`. */\nimport { hash } from \"node:crypto\";\nimport { isAbsolute, posix } from \"node:path\";\nimport type { Finding } from \"./models.js\";\nimport { isWindowsUnsafePathComponent } from \"./windows-path.js\";\n\nexport class SealedContractError extends Error {\n constructor(message: string, options?: ErrorOptions) {\n super(message, options);\n this.name = new.target.name;\n }\n}\n\nexport class SealedContractSchemaError extends SealedContractError {}\n\nexport const SEALED_DEFERRED_PATH_RULE = \"invalidSealedDeferredPath\";\nexport const DEFERRED_PATH_LOCATION = /^\\/deferred\\/(\\d+)\\/paths\\/(\\d+)$/u;\n\n/** Match the producer's Python str.strip without changing saved text. */\nexport function hasRequiredFindingText(value: string): boolean {\n return !/^[\\p{White_Space}\\u001c-\\u001f]*$/u.test(value);\n}\n\n/** Return canonical spelling for a valid scan-relative POSIX path. */\nexport function normalizedScanRelativePath(\n value: string,\n allowDot = false,\n): string | undefined {\n if (\n value.length === 0 ||\n Buffer.from(value, \"utf8\").toString(\"utf8\") !== value ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(value) ||\n value.split(\"/\").includes(\"..\") ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001f]/u.test(value)\n )\n return;\n const normalized = posix.normalize(value).replace(/\\/+$/, \"\");\n if (\n (!allowDot && normalized === \".\") ||\n normalized.startsWith(\"../\") ||\n isAbsolute(normalized)\n )\n return;\n return normalized;\n}\n\nexport function safeRelativePath(\n value: string,\n context: string,\n allowDot = false,\n): string {\n const normalized = normalizedScanRelativePath(value, allowDot);\n if (normalized === undefined)\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n return normalized;\n}\n\nexport function portableRelativePath(value: string, context: string): string {\n const normalized = safeRelativePath(value, context);\n if (\n value.trim().length === 0 ||\n value.split(\"/\").some(isWindowsUnsafePathComponent)\n ) {\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function safeScopePath(value: string): string {\n return value === \".\"\n ? value\n : safeRelativePath(value, \"manifest scope include path\");\n}\n\n/** @internal */\nexport function sha256Text(value: string): string {\n return hash(\"sha256\", value);\n}\n\nexport function deriveFindingIdentity(\n scanId: string,\n targetId: string,\n ruleId: string,\n identity: Finding[\"identity\"],\n) {\n const fingerprint = `codex-security/v1:sha256:${sha256Text(\n [\n \"codex-security/v1\",\n targetId,\n ruleId,\n identity.anchor,\n identity.instance ?? \"\",\n ].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256Text([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity,\n fingerprints: {\n algorithm: \"codex-security/v1\" as const,\n primary: fingerprint,\n },\n };\n}\n"]}
@@ -1,3 +1,10 @@
1
+ export type ScanPricingContext = {
2
+ provider: "amazon-bedrock";
3
+ region: string | null;
4
+ } | {
5
+ provider: "gcp";
6
+ managedEndpoint?: boolean;
7
+ };
1
8
  export interface ScanCost {
2
9
  model: string;
3
10
  inputTokens: number;
@@ -47,7 +54,12 @@ declare function usdPerMillionTokens(pricing: ModelPricing, unitsPerUsd: number)
47
54
  output: number;
48
55
  };
49
56
  export declare function tokenUsage(value: unknown): ScanTokenUsage | null;
50
- export declare function estimateScanCost(model: string | undefined, usage: unknown): ScanCost | null;
57
+ /**
58
+ * Estimates Standard token costs using the selected provider's published rates.
59
+ * A string (or null for an unknown region) selects Bedrock for compatibility.
60
+ * Model-only Bedrock frontier estimates use the commercial in-region price.
61
+ */
62
+ export declare function estimateScanCost(model: string | undefined, usage: unknown, context?: ScanPricingContext | string | null): ScanCost | null;
51
63
  export declare function formatTokenUsage(value: unknown): string | null;
52
64
  export declare function formatScanCostTokens(cost: Readonly<ScanCost>): string;
53
65
  export declare function formatScanCost(cost: Readonly<ScanCost>): string;
@@ -1 +1 @@
1
- {"version":3,"file":"cost-model.d.ts","sourceRoot":"","sources":["../src/cost-model.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,0DAA0D;QAC1D,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,EAAE,SAAS,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,UAAU,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,sEAAsE;QACtE,mBAAmB,EAAE,WAAW,CAAC;QACjC,8BAA8B,CAAC,EAAE,WAAW,CAAC;KAC9C,CAAC;CACH;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1D,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,MAAM;IACvB,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAsED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM;IAInE,KAAK;IACL,SAAS;IACT,UAAU;IACV,MAAM;EAET;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAwChE;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,OAAO,GACb,QAAQ,GAAG,IAAI,CAgGjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyB9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,CAQrE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAwB5E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}
1
+ {"version":3,"file":"cost-model.d.ts","sourceRoot":"","sources":["../src/cost-model.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACrD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,0DAA0D;QAC1D,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,EAAE,SAAS,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,UAAU,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,sEAAsE;QACtE,mBAAmB,EAAE,WAAW,CAAC;QACjC,8BAA8B,CAAC,EAAE,WAAW,CAAC;KAC9C,CAAC;CACH;AAED,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1D,KAAK,YAAY,GAAG,SAAS;IAC3B,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,MAAM;IACvB,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAgED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM;IAInE,KAAK;IACL,SAAS;IACT,UAAU;IACV,MAAM;EAET;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAwChE;AAoBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,GAC3C,QAAQ,GAAG,IAAI,CA6DjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyB9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,CAQrE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAwB5E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}
@@ -1,55 +1,27 @@
1
+ import { vertexModelPricing } from "./vertex-pricing.js";
2
+ import { bedrockModelPricing } from "./bedrock-pricing.js";
1
3
  import { isRecord } from "./record.js";
2
4
  import { isSafeNonNegativeInteger } from "./value.js";
3
- const BEDROCK_MODEL_PRICING = {
4
- // AWS commercial in-region Standard prices already include the 10% fee.
5
- "openai.gpt-daybreak-blue-5.6-sol": {
6
- short: [4_400, 440, 5_500, 22_000],
7
- long: [8_800, 880, 11_000, 33_000],
8
- unitsPerUsd: 1_000_000_000,
9
- source: "https://docs.aws.amazon.com/en_en/bedrock/latest/userguide/model-card-openai-gpt-daybreak-blue-56-sol.html",
10
- asOf: "2026-10-01",
11
- },
12
- "openai.gpt-5.6-cyber": {
13
- // Half-nanodollar units preserve the $17.1875/M cache-write rate exactly,
14
- // including an odd number of cache-write tokens.
15
- short: [27_500, 2_750, 34_375, 165_000],
16
- unitsPerUsd: 2_000_000_000,
17
- source: "https://docs.aws.amazon.com/en_en/bedrock/latest/userguide/model-card-openai-gpt-56-cyber.html",
18
- asOf: "2026-10-01",
19
- },
20
- };
21
- const MODEL_PRICING_NANODOLLARS = {
22
- // GPT-5.5 has no additional cache-write charge.
23
- "gpt-5.5": [5_000, 500, 5_000, 30_000],
24
- "gpt-5.5-2026-04-23": [5_000, 500, 5_000, 30_000],
25
- "gpt-6-sol": [2_000, 200, 2_500, 10_000],
26
- "gpt-6.1-sol": [2_000, 100, 2_500, 10_000],
27
- "gpt-6-astra": [10_000, 1_000, 12_500, 50_000],
28
- "gpt-6-luna": [100, 10, 125, 500],
29
- "gpt-5.6": [4_000, 400, 5_000, 20_000],
30
- "gpt-5.6-sol": [4_000, 400, 5_000, 20_000],
31
- "gpt-5.6-terra": [2_000, 200, 2_500, 12_000],
32
- "gpt-5.6-luna": [200, 20, 250, 1_200],
33
- // https://developers.openai.com/api/docs/pricing#cyber-models
34
- "gpt-5.6-cyber": [12_500, 1_250, 15_625, 75_000],
35
- };
36
- // Verified Standard rates: https://developers.openai.com/api/docs/pricing
37
- // GPT-5.5: https://developers.openai.com/api/docs/models/gpt-5.5
38
- // GPT-6 Sol: https://developers.openai.com/api/docs/models/gpt-6-sol
39
- // Do not infer tiers from aggregate scan tokens: the runtime does not report
40
- // which usage received long-context pricing. GPT-5.6-Cyber has no verified
41
- // long-context rate in the pricing table, so its upper estimate stays unavailable.
42
- const LONG_CONTEXT_PRICING_NANODOLLARS = {
43
- "gpt-5.5": [10_000, 1_000, 10_000, 45_000],
44
- "gpt-5.5-2026-04-23": [10_000, 1_000, 10_000, 45_000],
45
- "gpt-6-sol": [4_000, 400, 5_000, 15_000],
46
- "gpt-6.1-sol": [4_000, 200, 5_000, 15_000],
47
- "gpt-6-astra": [20_000, 2_000, 25_000, 75_000],
48
- "gpt-6-luna": [200, 20, 250, 750],
49
- "gpt-5.6": [8_000, 800, 10_000, 30_000],
50
- "gpt-5.6-sol": [8_000, 800, 10_000, 30_000],
51
- "gpt-5.6-terra": [4_000, 400, 5_000, 18_000],
52
- "gpt-5.6-luna": [400, 40, 500, 1_800],
5
+ // Direct Standard rates in nanodollars per token. Omit the long-context
6
+ // rate when there is no verified upper estimate for a model.
7
+ function directRate(asOf, short, long, source = "https://developers.openai.com/api/docs/pricing") {
8
+ return { short, long, unitsPerUsd: 1_000_000_000, source, asOf };
9
+ }
10
+ const gpt55 = directRate("2026-09-14", [5_000, 500, 5_000, 30_000], [10_000, 1_000, 10_000, 45_000], "https://developers.openai.com/api/docs/models/gpt-5.5");
11
+ const gpt56Sol = directRate("2026-09-14", [4_000, 400, 5_000, 20_000], [8_000, 800, 10_000, 30_000]);
12
+ const directPricing = {
13
+ "gpt-5.5": gpt55,
14
+ "gpt-5.5-2026-04-23": gpt55,
15
+ "gpt-6-sol": directRate("2026-10-10", [2_000, 200, 2_500, 10_000], [4_000, 400, 5_000, 15_000], "https://developers.openai.com/api/docs/models/gpt-6-sol"),
16
+ "gpt-6.1-sol": directRate("2026-09-30", [2_000, 100, 2_500, 10_000], [4_000, 200, 5_000, 15_000]),
17
+ "gpt-6-astra": directRate("2026-09-14", [10_000, 1_000, 12_500, 50_000], [20_000, 2_000, 25_000, 75_000]),
18
+ "gpt-6-luna": directRate("2026-09-30", [100, 10, 125, 500], [200, 20, 250, 750]),
19
+ "gpt-5.6": gpt56Sol,
20
+ "gpt-5.6-sol": gpt56Sol,
21
+ "gpt-5.6-terra": directRate("2026-09-14", [2_000, 200, 2_500, 12_000], [4_000, 400, 5_000, 18_000]),
22
+ "gpt-5.6-luna": directRate("2026-09-14", [200, 20, 250, 1_200], [400, 40, 500, 1_800]),
23
+ "gpt-5.6-cyber": directRate("2026-10-06", [12_500, 1_250, 15_625, 75_000]),
24
+ "gpt-6-cyber": directRate("2026-11-05", [20_000, 2_000, 25_000, 100_000]),
53
25
  };
54
26
  function usdPerMillionTokens(pricing, unitsPerUsd) {
55
27
  const [input, cacheRead, cacheWrite, output] = pricing;
@@ -100,88 +72,70 @@ export function tokenUsage(value) {
100
72
  total_tokens: input + output,
101
73
  };
102
74
  }
103
- export function estimateScanCost(model, usage) {
75
+ function providerModelPricing(model, context) {
76
+ if (context === undefined && Object.hasOwn(directPricing, model))
77
+ return directPricing[model];
78
+ if (context == null || typeof context === "string") {
79
+ return bedrockModelPricing(model, context);
80
+ }
81
+ if (context.provider === "amazon-bedrock") {
82
+ return bedrockModelPricing(model, context.region);
83
+ }
84
+ if (context.provider === "gcp" && context.managedEndpoint !== false) {
85
+ return vertexModelPricing(model);
86
+ }
87
+ return undefined;
88
+ }
89
+ /**
90
+ * Estimates Standard token costs using the selected provider's published rates.
91
+ * A string (or null for an unknown region) selects Bedrock for compatibility.
92
+ * Model-only Bedrock frontier estimates use the commercial in-region price.
93
+ */
94
+ export function estimateScanCost(model, usage, context) {
104
95
  if (model === undefined)
105
96
  return null;
106
- const bedrockPricing = Object.hasOwn(BEDROCK_MODEL_PRICING, model)
107
- ? BEDROCK_MODEL_PRICING[model]
108
- : undefined;
109
- const unitsPerUsd = bedrockPricing?.unitsPerUsd ?? 1_000_000_000;
110
- const pricingModel = model.startsWith("openai.")
111
- ? model.slice("openai.".length)
112
- : model;
113
- const pricing = bedrockPricing?.short ??
114
- (Object.hasOwn(MODEL_PRICING_NANODOLLARS, pricingModel)
115
- ? MODEL_PRICING_NANODOLLARS[pricingModel]
116
- : undefined);
97
+ const rate = providerModelPricing(model, context);
117
98
  const normalized = tokenUsage(usage);
118
- if (pricing === undefined || normalized === null)
99
+ if (rate === undefined || normalized === null)
119
100
  return null;
120
- const [inputRate, cachedInputRate, cacheWriteInputRate, outputRate] = pricing;
101
+ const { short, long, unitsPerUsd, source, asOf } = rate;
121
102
  const { input_tokens: inputTokens, cached_input_tokens: cachedInputTokens, cache_write_input_tokens: cacheWriteInputTokens, output_tokens: outputTokens, } = normalized;
122
- const costUnits = (inputTokens - cachedInputTokens - cacheWriteInputTokens) * inputRate +
123
- cachedInputTokens * cachedInputRate +
124
- cacheWriteInputTokens * cacheWriteInputRate +
125
- outputTokens * outputRate;
126
- if (!Number.isSafeInteger(costUnits))
127
- return null;
128
- const longPricing = bedrockPricing
129
- ? bedrockPricing.long
130
- : LONG_CONTEXT_PRICING_NANODOLLARS[pricingModel];
131
- let maximumUnits = null;
132
- if (longPricing !== undefined) {
133
- const [longInput, longRead, longWrite, longOutput] = longPricing;
134
- // Unclassified input may include additional cache writes. Preserve the
135
- // reported subtotal, but include that uncertainty in the upper estimate.
136
- const uncachedRate = normalized.cache_write_input_tokens_reported === false
137
- ? Math.max(longInput, longWrite)
138
- : longInput;
139
- const maximum = (inputTokens - cachedInputTokens - cacheWriteInputTokens) * uncachedRate +
140
- cachedInputTokens * longRead +
141
- cacheWriteInputTokens * longWrite +
142
- outputTokens * longOutput;
143
- if (Number.isSafeInteger(maximum))
144
- maximumUnits = maximum;
103
+ const uncachedTokens = inputTokens - cachedInputTokens - cacheWriteInputTokens;
104
+ function priceInUsd([input, read, write, output], unknownWrites) {
105
+ // Unclassified input may include writes. Account for them only in the upper bound.
106
+ const units = uncachedTokens * (unknownWrites ? Math.max(input, write) : input) +
107
+ cachedInputTokens * read +
108
+ cacheWriteInputTokens * write +
109
+ outputTokens * output;
110
+ return Number.isSafeInteger(units) ? units / unitsPerUsd : null;
145
111
  }
112
+ const estimatedUsd = priceInUsd(short, false);
113
+ if (estimatedUsd === null)
114
+ return null;
115
+ const unknownWrites = normalized.cache_write_input_tokens_reported === false;
146
116
  return {
147
117
  model,
148
118
  inputTokens,
149
119
  cachedInputTokens,
150
120
  cacheWriteInputTokens,
151
- ...(normalized.cache_write_input_tokens_reported === false
152
- ? { cacheWriteInputTokensReported: false }
153
- : {}),
121
+ ...(unknownWrites ? { cacheWriteInputTokensReported: false } : {}),
154
122
  outputTokens,
155
- estimatedUsd: costUnits / unitsPerUsd,
123
+ estimatedUsd,
156
124
  estimatedUsdRange: {
157
- min: costUnits / unitsPerUsd,
158
- max: maximumUnits === null ? null : maximumUnits / unitsPerUsd,
125
+ min: estimatedUsd,
126
+ max: long === undefined ? null : priceInUsd(long, unknownWrites),
159
127
  context: "unknown",
160
128
  },
161
129
  pricing: {
162
- source: bedrockPricing
163
- ? bedrockPricing.source
164
- : pricingModel.startsWith("gpt-5.5")
165
- ? "https://developers.openai.com/api/docs/models/gpt-5.5"
166
- : pricingModel === "gpt-6-sol"
167
- ? "https://developers.openai.com/api/docs/models/gpt-6-sol"
168
- : "https://developers.openai.com/api/docs/pricing",
169
- asOf: bedrockPricing
170
- ? bedrockPricing.asOf
171
- : pricingModel === "gpt-6-sol"
172
- ? "2026-10-10"
173
- : pricingModel === "gpt-5.6-cyber"
174
- ? "2026-10-06"
175
- : pricingModel === "gpt-6.1-sol" || pricingModel === "gpt-6-luna"
176
- ? "2026-09-30"
177
- : "2026-09-14",
130
+ source,
131
+ asOf,
178
132
  serviceTier: "standard",
179
133
  context: "short",
180
- usdPerMillionTokens: usdPerMillionTokens(pricing, unitsPerUsd),
181
- ...(longPricing === undefined
134
+ usdPerMillionTokens: usdPerMillionTokens(short, unitsPerUsd),
135
+ ...(long === undefined
182
136
  ? {}
183
137
  : {
184
- longContextUsdPerMillionTokens: usdPerMillionTokens(longPricing, unitsPerUsd),
138
+ longContextUsdPerMillionTokens: usdPerMillionTokens(long, unitsPerUsd),
185
139
  }),
186
140
  },
187
141
  };
@@ -1 +1 @@
1
- {"version":3,"file":"cost-model.js","sourceRoot":"","sources":["../src/cost-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAgDtD,MAAM,qBAAqB,GAWvB;IACF,wEAAwE;IACxE,kCAAkC,EAAE;QAClC,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;QAClC,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC;QAClC,WAAW,EAAE,aAAa;QAC1B,MAAM,EACJ,4GAA4G;QAC9G,IAAI,EAAE,YAAY;KACnB;IACD,sBAAsB,EAAE;QACtB,0EAA0E;QAC1E,iDAAiD;QACjD,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;QACvC,WAAW,EAAE,aAAa;QAC1B,MAAM,EACJ,gGAAgG;QAClG,IAAI,EAAE,YAAY;KACnB;CACF,CAAC;AAEF,MAAM,yBAAyB,GAA2C;IACxE,gDAAgD;IAChD,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IACtC,oBAAoB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IACjD,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC9C,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC;IACjC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAC1C,eAAe,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC;IACrC,8DAA8D;IAC9D,eAAe,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;CACjD,CAAC;AAEF,0EAA0E;AAC1E,iEAAiE;AACjE,qEAAqE;AACrE,6EAA6E;AAC7E,2EAA2E;AAC3E,mFAAmF;AACnF,MAAM,gCAAgC,GACpC;IACE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC1C,oBAAoB,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACrD,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IACxC,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAC1C,aAAa,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC9C,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC;IACjC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3C,eAAe,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC;CACtC,CAAC;AAEJ,SAAS,mBAAmB,CAAC,OAAqB,EAAE,WAAmB;IACrE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IACvD,MAAM,eAAe,GAAG,WAAW,GAAG,SAAS,CAAC;IAChD,OAAO;QACL,KAAK,EAAE,KAAK,GAAG,eAAe;QAC9B,SAAS,EAAE,SAAS,GAAG,eAAe;QACtC,UAAU,EAAE,UAAU,GAAG,eAAe;QACxC,MAAM,EAAE,MAAM,GAAG,eAAe;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,mBAAmB,GAAG,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACrD,MAAM,UAAU,GACd,mBAAmB,KAAK,CAAC;QACzB,wBAAwB,CAAC,KAAK,CAAC;QAC/B,wBAAwB,CAAC,MAAM,CAAC;QAChC,wBAAwB,CAAC,gBAAgB,CAAC;QAC1C,gBAAgB,GAAG,CAAC;QACpB,MAAM,GAAG,gBAAgB,IAAI,KAAK;QAChC,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,CAAC,mBAAmB,IAAI,gBAAgB,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACxD,IACE,CAAC,wBAAwB,CAAC,KAAK,CAAC;QAChC,CAAC,wBAAwB,CAAC,MAAM,CAAC;QACjC,CAAC,wBAAwB,CAAC,UAAU,CAAC;QACrC,CAAC,wBAAwB,CAAC,MAAM,CAAC;QACjC,CAAC,wBAAwB,CAAC,SAAS,CAAC;QACpC,MAAM,GAAG,UAAU,GAAG,KAAK;QAC3B,SAAS,GAAG,MAAM,EAClB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,MAAM;QAC3B,wBAAwB,EAAE,UAAU;QACpC,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,KAAK,KAAK;YACxD,CAAC,mBAAmB,IAAI,IAAI,IAAI,gBAAgB,IAAI,IAAI,CAAC;YACvD,CAAC,CAAC,EAAE,iCAAiC,EAAE,KAAK,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,aAAa,EAAE,MAAM;QACrB,uBAAuB,EAAE,SAAS;QAClC,YAAY,EAAE,KAAK,GAAG,MAAM;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAyB,EACzB,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,CAAC;QAChE,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC;QAC9B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,WAAW,GAAG,cAAc,EAAE,WAAW,IAAI,aAAa,CAAC;IACjE,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,KAAK,CAAC;IACV,MAAM,OAAO,GACX,cAAc,EAAE,KAAK;QACrB,CAAC,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC;YACrD,CAAC,CAAC,yBAAyB,CAAC,YAAY,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjB,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9D,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC;IAC9E,MAAM,EACJ,YAAY,EAAE,WAAW,EACzB,mBAAmB,EAAE,iBAAiB,EACtC,wBAAwB,EAAE,qBAAqB,EAC/C,aAAa,EAAE,YAAY,GAC5B,GAAG,UAAU,CAAC;IAEf,MAAM,SAAS,GACb,CAAC,WAAW,GAAG,iBAAiB,GAAG,qBAAqB,CAAC,GAAG,SAAS;QACrE,iBAAiB,GAAG,eAAe;QACnC,qBAAqB,GAAG,mBAAmB;QAC3C,YAAY,GAAG,UAAU,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,MAAM,WAAW,GAAG,cAAc;QAChC,CAAC,CAAC,cAAc,CAAC,IAAI;QACrB,CAAC,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC;IACnD,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,WAAW,CAAC;QACjE,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,YAAY,GAChB,UAAU,CAAC,iCAAiC,KAAK,KAAK;YACpD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,OAAO,GACX,CAAC,WAAW,GAAG,iBAAiB,GAAG,qBAAqB,CAAC,GAAG,YAAY;YACxE,iBAAiB,GAAG,QAAQ;YAC5B,qBAAqB,GAAG,SAAS;YACjC,YAAY,GAAG,UAAU,CAAC;QAC5B,IAAI,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,YAAY,GAAG,OAAO,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,KAAK;QACL,WAAW;QACX,iBAAiB;QACjB,qBAAqB;QACrB,GAAG,CAAC,UAAU,CAAC,iCAAiC,KAAK,KAAK;YACxD,CAAC,CAAC,EAAE,6BAA6B,EAAE,KAAK,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;QACP,YAAY;QACZ,YAAY,EAAE,SAAS,GAAG,WAAW;QACrC,iBAAiB,EAAE;YACjB,GAAG,EAAE,SAAS,GAAG,WAAW;YAC5B,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,WAAW;YAC9D,OAAO,EAAE,SAAS;SACnB;QACD,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;gBACpB,CAAC,CAAC,cAAc,CAAC,MAAM;gBACvB,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC;oBAClC,CAAC,CAAC,uDAAuD;oBACzD,CAAC,CAAC,YAAY,KAAK,WAAW;wBAC5B,CAAC,CAAC,yDAAyD;wBAC3D,CAAC,CAAC,gDAAgD;YACxD,IAAI,EAAE,cAAc;gBAClB,CAAC,CAAC,cAAc,CAAC,IAAI;gBACrB,CAAC,CAAC,YAAY,KAAK,WAAW;oBAC5B,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,YAAY,KAAK,eAAe;wBAChC,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,YAAY,KAAK,aAAa,IAAI,YAAY,KAAK,YAAY;4BAC/D,CAAC,CAAC,YAAY;4BACd,CAAC,CAAC,YAAY;YACtB,WAAW,EAAE,UAAU;YACvB,OAAO,EAAE,OAAO;YAChB,mBAAmB,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC;YAC9D,GAAG,CAAC,WAAW,KAAK,SAAS;gBAC3B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,8BAA8B,EAAE,mBAAmB,CACjD,WAAW,EACX,WAAW,CACZ;iBACF,CAAC;SACP;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GACV,KAAK,CAAC,iCAAiC,KAAK,KAAK;QAC/C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IACrC,MAAM,QAAQ,GACZ,MAAM,KAAK,IAAI;QACb,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC;IAC9D,OACE;QACE,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QAC5B,CAAC,KAAK,CAAC,mBAAmB,EAAE,aAAa,CAAC;QAC1C,CAAC,MAAM,EAAE,cAAc,CAAC;QACxB,CAAC,KAAK,CAAC,aAAa,EAAE,QAAQ,CAAC;QAC/B,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC;KAEhC;SACE,GAAG,CACF,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CACjB,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,KAAK,EAAE,CAC/E;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,OAAO,gBAAgB,CAAC;QACtB,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;QAC3C,wBAAwB,EAAE,IAAI,CAAC,qBAAqB;QACpD,iCAAiC,EAAE,IAAI,CAAC,6BAA6B;QACrE,aAAa,EAAE,IAAI,CAAC,YAAY;KACjC,CAAE,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAoC;IAClE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,qCAAqC,CAAC;IACpH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAC1B,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,iBAAkB,CAAC,GAAG,EAChD,CAAC,CACF,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAkB,CAAC,GAAG,KAAK,IAAI,CAAC;QACxE,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,iBAAkB,CAAC,GAAI,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,6BAA6B,KAAK,KAAK,CACvD;QACC,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,YAAY,SAAS,CAAC,OAAO,CAAC,yCAAyC,WAAW,GAAG,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GACV,OAAO,KAAK,OAAO;QACjB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,OAAO,GAAG,MAAM,8BAA8B,WAAW,GAAG,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,KAAK;QACf,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;KACzB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC","sourcesContent":["import { isRecord } from \"./record.js\";\nimport { isSafeNonNegativeInteger } from \"./value.js\";\n\nexport interface ScanCost {\n model: string;\n inputTokens: number;\n cachedInputTokens: number;\n cacheWriteInputTokens: number;\n cacheWriteInputTokensReported?: boolean;\n outputTokens: number;\n /** Short-context baseline retained for compatibility and spending limits. */\n estimatedUsd: number;\n /** Standard token-cost bounds for the observed usage, not a billing total. */\n estimatedUsdRange?: {\n min: number;\n /** null when a verified upper estimate is unavailable. */\n max: number | null;\n context: \"unknown\";\n };\n pricing?: {\n source: string;\n asOf: string;\n serviceTier: \"standard\";\n context: \"short\";\n /** Short-context rates used by estimatedUsd and the range minimum. */\n usdPerMillionTokens: TokenPrices;\n longContextUsdPerMillionTokens?: TokenPrices;\n };\n}\n\ntype TokenPrices = ReturnType<typeof usdPerMillionTokens>;\n\ntype ModelPricing = readonly [\n input: number,\n cachedInput: number,\n cacheWriteInput: number,\n output: number,\n];\n\nexport interface ScanTokenUsage {\n input_tokens: number;\n cached_input_tokens: number;\n cache_write_input_tokens: number;\n cache_write_input_tokens_reported?: boolean;\n output_tokens: number;\n reasoning_output_tokens: number;\n total_tokens: number;\n}\n\nconst BEDROCK_MODEL_PRICING: Readonly<\n Record<\n string,\n {\n short: ModelPricing;\n long?: ModelPricing;\n unitsPerUsd: number;\n source: string;\n asOf: string;\n }\n >\n> = {\n // AWS commercial in-region Standard prices already include the 10% fee.\n \"openai.gpt-daybreak-blue-5.6-sol\": {\n short: [4_400, 440, 5_500, 22_000],\n long: [8_800, 880, 11_000, 33_000],\n unitsPerUsd: 1_000_000_000,\n source:\n \"https://docs.aws.amazon.com/en_en/bedrock/latest/userguide/model-card-openai-gpt-daybreak-blue-56-sol.html\",\n asOf: \"2026-10-01\",\n },\n \"openai.gpt-5.6-cyber\": {\n // Half-nanodollar units preserve the $17.1875/M cache-write rate exactly,\n // including an odd number of cache-write tokens.\n short: [27_500, 2_750, 34_375, 165_000],\n unitsPerUsd: 2_000_000_000,\n source:\n \"https://docs.aws.amazon.com/en_en/bedrock/latest/userguide/model-card-openai-gpt-56-cyber.html\",\n asOf: \"2026-10-01\",\n },\n};\n\nconst MODEL_PRICING_NANODOLLARS: Readonly<Record<string, ModelPricing>> = {\n // GPT-5.5 has no additional cache-write charge.\n \"gpt-5.5\": [5_000, 500, 5_000, 30_000],\n \"gpt-5.5-2026-04-23\": [5_000, 500, 5_000, 30_000],\n \"gpt-6-sol\": [2_000, 200, 2_500, 10_000],\n \"gpt-6.1-sol\": [2_000, 100, 2_500, 10_000],\n \"gpt-6-astra\": [10_000, 1_000, 12_500, 50_000],\n \"gpt-6-luna\": [100, 10, 125, 500],\n \"gpt-5.6\": [4_000, 400, 5_000, 20_000],\n \"gpt-5.6-sol\": [4_000, 400, 5_000, 20_000],\n \"gpt-5.6-terra\": [2_000, 200, 2_500, 12_000],\n \"gpt-5.6-luna\": [200, 20, 250, 1_200],\n // https://developers.openai.com/api/docs/pricing#cyber-models\n \"gpt-5.6-cyber\": [12_500, 1_250, 15_625, 75_000],\n};\n\n// Verified Standard rates: https://developers.openai.com/api/docs/pricing\n// GPT-5.5: https://developers.openai.com/api/docs/models/gpt-5.5\n// GPT-6 Sol: https://developers.openai.com/api/docs/models/gpt-6-sol\n// Do not infer tiers from aggregate scan tokens: the runtime does not report\n// which usage received long-context pricing. GPT-5.6-Cyber has no verified\n// long-context rate in the pricing table, so its upper estimate stays unavailable.\nconst LONG_CONTEXT_PRICING_NANODOLLARS: Readonly<Record<string, ModelPricing>> =\n {\n \"gpt-5.5\": [10_000, 1_000, 10_000, 45_000],\n \"gpt-5.5-2026-04-23\": [10_000, 1_000, 10_000, 45_000],\n \"gpt-6-sol\": [4_000, 400, 5_000, 15_000],\n \"gpt-6.1-sol\": [4_000, 200, 5_000, 15_000],\n \"gpt-6-astra\": [20_000, 2_000, 25_000, 75_000],\n \"gpt-6-luna\": [200, 20, 250, 750],\n \"gpt-5.6\": [8_000, 800, 10_000, 30_000],\n \"gpt-5.6-sol\": [8_000, 800, 10_000, 30_000],\n \"gpt-5.6-terra\": [4_000, 400, 5_000, 18_000],\n \"gpt-5.6-luna\": [400, 40, 500, 1_800],\n };\n\nfunction usdPerMillionTokens(pricing: ModelPricing, unitsPerUsd: number) {\n const [input, cacheRead, cacheWrite, output] = pricing;\n const unitsPerMillion = unitsPerUsd / 1_000_000;\n return {\n input: input / unitsPerMillion,\n cacheRead: cacheRead / unitsPerMillion,\n cacheWrite: cacheWrite / unitsPerMillion,\n output: output / unitsPerMillion,\n };\n}\n\nexport function tokenUsage(value: unknown): ScanTokenUsage | null {\n if (!isRecord(value)) return null;\n const input = value[\"input_tokens\"];\n const cached = value[\"cached_input_tokens\"] ?? 0;\n const canonicalCacheWrite = value[\"cache_write_input_tokens\"];\n const legacyCacheWrite = value[\"cache_write_tokens\"];\n const cacheWrite =\n canonicalCacheWrite === 0 &&\n isSafeNonNegativeInteger(input) &&\n isSafeNonNegativeInteger(cached) &&\n isSafeNonNegativeInteger(legacyCacheWrite) &&\n legacyCacheWrite > 0 &&\n cached + legacyCacheWrite <= input\n ? legacyCacheWrite\n : (canonicalCacheWrite ?? legacyCacheWrite ?? 0);\n const output = value[\"output_tokens\"];\n const reasoning = value[\"reasoning_output_tokens\"] ?? 0;\n if (\n !isSafeNonNegativeInteger(input) ||\n !isSafeNonNegativeInteger(cached) ||\n !isSafeNonNegativeInteger(cacheWrite) ||\n !isSafeNonNegativeInteger(output) ||\n !isSafeNonNegativeInteger(reasoning) ||\n cached + cacheWrite > input ||\n reasoning > output\n ) {\n return null;\n }\n return {\n input_tokens: input,\n cached_input_tokens: cached,\n cache_write_input_tokens: cacheWrite,\n ...(value[\"cache_write_input_tokens_reported\"] === false ||\n (canonicalCacheWrite == null && legacyCacheWrite == null)\n ? { cache_write_input_tokens_reported: false }\n : {}),\n output_tokens: output,\n reasoning_output_tokens: reasoning,\n total_tokens: input + output,\n };\n}\n\nexport function estimateScanCost(\n model: string | undefined,\n usage: unknown,\n): ScanCost | null {\n if (model === undefined) return null;\n const bedrockPricing = Object.hasOwn(BEDROCK_MODEL_PRICING, model)\n ? BEDROCK_MODEL_PRICING[model]\n : undefined;\n const unitsPerUsd = bedrockPricing?.unitsPerUsd ?? 1_000_000_000;\n const pricingModel = model.startsWith(\"openai.\")\n ? model.slice(\"openai.\".length)\n : model;\n const pricing =\n bedrockPricing?.short ??\n (Object.hasOwn(MODEL_PRICING_NANODOLLARS, pricingModel)\n ? MODEL_PRICING_NANODOLLARS[pricingModel]\n : undefined);\n const normalized = tokenUsage(usage);\n if (pricing === undefined || normalized === null) return null;\n const [inputRate, cachedInputRate, cacheWriteInputRate, outputRate] = pricing;\n const {\n input_tokens: inputTokens,\n cached_input_tokens: cachedInputTokens,\n cache_write_input_tokens: cacheWriteInputTokens,\n output_tokens: outputTokens,\n } = normalized;\n\n const costUnits =\n (inputTokens - cachedInputTokens - cacheWriteInputTokens) * inputRate +\n cachedInputTokens * cachedInputRate +\n cacheWriteInputTokens * cacheWriteInputRate +\n outputTokens * outputRate;\n if (!Number.isSafeInteger(costUnits)) return null;\n\n const longPricing = bedrockPricing\n ? bedrockPricing.long\n : LONG_CONTEXT_PRICING_NANODOLLARS[pricingModel];\n let maximumUnits: number | null = null;\n if (longPricing !== undefined) {\n const [longInput, longRead, longWrite, longOutput] = longPricing;\n // Unclassified input may include additional cache writes. Preserve the\n // reported subtotal, but include that uncertainty in the upper estimate.\n const uncachedRate =\n normalized.cache_write_input_tokens_reported === false\n ? Math.max(longInput, longWrite)\n : longInput;\n const maximum =\n (inputTokens - cachedInputTokens - cacheWriteInputTokens) * uncachedRate +\n cachedInputTokens * longRead +\n cacheWriteInputTokens * longWrite +\n outputTokens * longOutput;\n if (Number.isSafeInteger(maximum)) maximumUnits = maximum;\n }\n\n return {\n model,\n inputTokens,\n cachedInputTokens,\n cacheWriteInputTokens,\n ...(normalized.cache_write_input_tokens_reported === false\n ? { cacheWriteInputTokensReported: false }\n : {}),\n outputTokens,\n estimatedUsd: costUnits / unitsPerUsd,\n estimatedUsdRange: {\n min: costUnits / unitsPerUsd,\n max: maximumUnits === null ? null : maximumUnits / unitsPerUsd,\n context: \"unknown\",\n },\n pricing: {\n source: bedrockPricing\n ? bedrockPricing.source\n : pricingModel.startsWith(\"gpt-5.5\")\n ? \"https://developers.openai.com/api/docs/models/gpt-5.5\"\n : pricingModel === \"gpt-6-sol\"\n ? \"https://developers.openai.com/api/docs/models/gpt-6-sol\"\n : \"https://developers.openai.com/api/docs/pricing\",\n asOf: bedrockPricing\n ? bedrockPricing.asOf\n : pricingModel === \"gpt-6-sol\"\n ? \"2026-10-10\"\n : pricingModel === \"gpt-5.6-cyber\"\n ? \"2026-10-06\"\n : pricingModel === \"gpt-6.1-sol\" || pricingModel === \"gpt-6-luna\"\n ? \"2026-09-30\"\n : \"2026-09-14\",\n serviceTier: \"standard\",\n context: \"short\",\n usdPerMillionTokens: usdPerMillionTokens(pricing, unitsPerUsd),\n ...(longPricing === undefined\n ? {}\n : {\n longContextUsdPerMillionTokens: usdPerMillionTokens(\n longPricing,\n unitsPerUsd,\n ),\n }),\n },\n };\n}\n\nexport function formatTokenUsage(value: unknown): string | null {\n const usage = tokenUsage(value);\n if (usage === null) return null;\n const writes =\n usage.cache_write_input_tokens_reported === false\n ? null\n : usage.cache_write_input_tokens;\n const uncached =\n writes === null\n ? null\n : usage.input_tokens - usage.cached_input_tokens - writes;\n return (\n [\n [uncached, \"uncached input\"],\n [usage.cached_input_tokens, \"cache reads\"],\n [writes, \"cache writes\"],\n [usage.output_tokens, \"output\"],\n [usage.total_tokens, \"total\"],\n ] as const\n )\n .map(\n ([count, label]) =>\n `${count === null ? \"unavailable\" : count.toLocaleString(\"en-US\")} ${label}`,\n )\n .join(\", \");\n}\n\nexport function formatScanCostTokens(cost: Readonly<ScanCost>): string {\n return formatTokenUsage({\n input_tokens: cost.inputTokens,\n cached_input_tokens: cost.cachedInputTokens,\n cache_write_input_tokens: cost.cacheWriteInputTokens,\n cache_write_input_tokens_reported: cost.cacheWriteInputTokensReported,\n output_tokens: cost.outputTokens,\n })!;\n}\n\nexport function formatScanCost(cost: Readonly<ScanCost>): string {\n return formatScanCosts([cost]);\n}\n\nexport function formatScanCosts(costs: readonly Readonly<ScanCost>[]): string {\n if (costs.some((cost) => cost.estimatedUsdRange === undefined)) {\n return `${formatUsd(costs.reduce((sum, cost) => sum + cost.estimatedUsd, 0))} (legacy estimate, context unknown)`;\n }\n const minimum = costs.reduce(\n (sum, cost) => sum + cost.estimatedUsdRange!.min,\n 0,\n );\n const maximum = costs.some((cost) => cost.estimatedUsdRange!.max === null)\n ? null\n : costs.reduce((sum, cost) => sum + cost.estimatedUsdRange!.max!, 0);\n const cacheWrites = costs.some(\n (cost) => cost.cacheWriteInputTokensReported === false,\n )\n ? \", cache writes unknown\"\n : \"\";\n if (maximum === null) {\n return `at least ${formatUsd(minimum)} (standard, upper estimate unavailable${cacheWrites})`;\n }\n const amount =\n minimum === maximum\n ? formatUsd(minimum)\n : `${formatUsd(minimum)}–${formatUsd(maximum)}`;\n return `${amount} (standard, context unknown${cacheWrites})`;\n}\n\nexport function formatUsd(value: number): string {\n return new Intl.NumberFormat(\"en-US\", {\n style: \"currency\",\n currency: \"USD\",\n minimumFractionDigits: 2,\n maximumFractionDigits: 9,\n }).format(value);\n}\n"]}
1
+ {"version":3,"file":"cost-model.js","sourceRoot":"","sources":["../src/cost-model.ts"],"names":[],"mappings":"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","sourcesContent":["import { vertexModelPricing } from \"./vertex-pricing.js\";\nimport { bedrockModelPricing } from \"./bedrock-pricing.js\";\nimport { isRecord } from \"./record.js\";\nimport { isSafeNonNegativeInteger } from \"./value.js\";\n\nexport type ScanPricingContext =\n | { provider: \"amazon-bedrock\"; region: string | null }\n | { provider: \"gcp\"; managedEndpoint?: boolean };\n\nexport interface ScanCost {\n model: string;\n inputTokens: number;\n cachedInputTokens: number;\n cacheWriteInputTokens: number;\n cacheWriteInputTokensReported?: boolean;\n outputTokens: number;\n /** Short-context baseline retained for compatibility and spending limits. */\n estimatedUsd: number;\n /** Standard token-cost bounds for the observed usage, not a billing total. */\n estimatedUsdRange?: {\n min: number;\n /** null when a verified upper estimate is unavailable. */\n max: number | null;\n context: \"unknown\";\n };\n pricing?: {\n source: string;\n asOf: string;\n serviceTier: \"standard\";\n context: \"short\";\n /** Short-context rates used by estimatedUsd and the range minimum. */\n usdPerMillionTokens: TokenPrices;\n longContextUsdPerMillionTokens?: TokenPrices;\n };\n}\n\ntype TokenPrices = ReturnType<typeof usdPerMillionTokens>;\n\ntype ModelPricing = readonly [\n input: number,\n cachedInput: number,\n cacheWriteInput: number,\n output: number,\n];\n\nexport interface ScanTokenUsage {\n input_tokens: number;\n cached_input_tokens: number;\n cache_write_input_tokens: number;\n cache_write_input_tokens_reported?: boolean;\n output_tokens: number;\n reasoning_output_tokens: number;\n total_tokens: number;\n}\n\n// Direct Standard rates in nanodollars per token. Omit the long-context\n// rate when there is no verified upper estimate for a model.\nfunction directRate(\n asOf: string,\n short: ModelPricing,\n long?: ModelPricing,\n source = \"https://developers.openai.com/api/docs/pricing\",\n) {\n return { short, long, unitsPerUsd: 1_000_000_000, source, asOf };\n}\n\nconst gpt55 = directRate(\n \"2026-09-14\",\n [5_000, 500, 5_000, 30_000],\n [10_000, 1_000, 10_000, 45_000],\n \"https://developers.openai.com/api/docs/models/gpt-5.5\",\n);\nconst gpt56Sol = directRate(\n \"2026-09-14\",\n [4_000, 400, 5_000, 20_000],\n [8_000, 800, 10_000, 30_000],\n);\nconst directPricing: Readonly<Record<string, ReturnType<typeof directRate>>> = {\n \"gpt-5.5\": gpt55,\n \"gpt-5.5-2026-04-23\": gpt55,\n \"gpt-6-sol\": directRate(\n \"2026-10-10\",\n [2_000, 200, 2_500, 10_000],\n [4_000, 400, 5_000, 15_000],\n \"https://developers.openai.com/api/docs/models/gpt-6-sol\",\n ),\n \"gpt-6.1-sol\": directRate(\n \"2026-09-30\",\n [2_000, 100, 2_500, 10_000],\n [4_000, 200, 5_000, 15_000],\n ),\n \"gpt-6-astra\": directRate(\n \"2026-09-14\",\n [10_000, 1_000, 12_500, 50_000],\n [20_000, 2_000, 25_000, 75_000],\n ),\n \"gpt-6-luna\": directRate(\n \"2026-09-30\",\n [100, 10, 125, 500],\n [200, 20, 250, 750],\n ),\n \"gpt-5.6\": gpt56Sol,\n \"gpt-5.6-sol\": gpt56Sol,\n \"gpt-5.6-terra\": directRate(\n \"2026-09-14\",\n [2_000, 200, 2_500, 12_000],\n [4_000, 400, 5_000, 18_000],\n ),\n \"gpt-5.6-luna\": directRate(\n \"2026-09-14\",\n [200, 20, 250, 1_200],\n [400, 40, 500, 1_800],\n ),\n \"gpt-5.6-cyber\": directRate(\"2026-10-06\", [12_500, 1_250, 15_625, 75_000]),\n \"gpt-6-cyber\": directRate(\"2026-11-05\", [20_000, 2_000, 25_000, 100_000]),\n};\n\nfunction usdPerMillionTokens(pricing: ModelPricing, unitsPerUsd: number) {\n const [input, cacheRead, cacheWrite, output] = pricing;\n const unitsPerMillion = unitsPerUsd / 1_000_000;\n return {\n input: input / unitsPerMillion,\n cacheRead: cacheRead / unitsPerMillion,\n cacheWrite: cacheWrite / unitsPerMillion,\n output: output / unitsPerMillion,\n };\n}\n\nexport function tokenUsage(value: unknown): ScanTokenUsage | null {\n if (!isRecord(value)) return null;\n const input = value[\"input_tokens\"];\n const cached = value[\"cached_input_tokens\"] ?? 0;\n const canonicalCacheWrite = value[\"cache_write_input_tokens\"];\n const legacyCacheWrite = value[\"cache_write_tokens\"];\n const cacheWrite =\n canonicalCacheWrite === 0 &&\n isSafeNonNegativeInteger(input) &&\n isSafeNonNegativeInteger(cached) &&\n isSafeNonNegativeInteger(legacyCacheWrite) &&\n legacyCacheWrite > 0 &&\n cached + legacyCacheWrite <= input\n ? legacyCacheWrite\n : (canonicalCacheWrite ?? legacyCacheWrite ?? 0);\n const output = value[\"output_tokens\"];\n const reasoning = value[\"reasoning_output_tokens\"] ?? 0;\n if (\n !isSafeNonNegativeInteger(input) ||\n !isSafeNonNegativeInteger(cached) ||\n !isSafeNonNegativeInteger(cacheWrite) ||\n !isSafeNonNegativeInteger(output) ||\n !isSafeNonNegativeInteger(reasoning) ||\n cached + cacheWrite > input ||\n reasoning > output\n ) {\n return null;\n }\n return {\n input_tokens: input,\n cached_input_tokens: cached,\n cache_write_input_tokens: cacheWrite,\n ...(value[\"cache_write_input_tokens_reported\"] === false ||\n (canonicalCacheWrite == null && legacyCacheWrite == null)\n ? { cache_write_input_tokens_reported: false }\n : {}),\n output_tokens: output,\n reasoning_output_tokens: reasoning,\n total_tokens: input + output,\n };\n}\n\nfunction providerModelPricing(\n model: string,\n context?: ScanPricingContext | string | null,\n) {\n if (context === undefined && Object.hasOwn(directPricing, model))\n return directPricing[model];\n if (context == null || typeof context === \"string\") {\n return bedrockModelPricing(model, context);\n }\n if (context.provider === \"amazon-bedrock\") {\n return bedrockModelPricing(model, context.region);\n }\n if (context.provider === \"gcp\" && context.managedEndpoint !== false) {\n return vertexModelPricing(model);\n }\n return undefined;\n}\n\n/**\n * Estimates Standard token costs using the selected provider's published rates.\n * A string (or null for an unknown region) selects Bedrock for compatibility.\n * Model-only Bedrock frontier estimates use the commercial in-region price.\n */\nexport function estimateScanCost(\n model: string | undefined,\n usage: unknown,\n context?: ScanPricingContext | string | null,\n): ScanCost | null {\n if (model === undefined) return null;\n const rate = providerModelPricing(model, context);\n const normalized = tokenUsage(usage);\n if (rate === undefined || normalized === null) return null;\n const { short, long, unitsPerUsd, source, asOf } = rate;\n const {\n input_tokens: inputTokens,\n cached_input_tokens: cachedInputTokens,\n cache_write_input_tokens: cacheWriteInputTokens,\n output_tokens: outputTokens,\n } = normalized;\n\n const uncachedTokens =\n inputTokens - cachedInputTokens - cacheWriteInputTokens;\n\n function priceInUsd(\n [input, read, write, output]: ModelPricing,\n unknownWrites: boolean,\n ) {\n // Unclassified input may include writes. Account for them only in the upper bound.\n const units =\n uncachedTokens * (unknownWrites ? Math.max(input, write) : input) +\n cachedInputTokens * read +\n cacheWriteInputTokens * write +\n outputTokens * output;\n return Number.isSafeInteger(units) ? units / unitsPerUsd : null;\n }\n const estimatedUsd = priceInUsd(short, false);\n if (estimatedUsd === null) return null;\n const unknownWrites = normalized.cache_write_input_tokens_reported === false;\n\n return {\n model,\n inputTokens,\n cachedInputTokens,\n cacheWriteInputTokens,\n ...(unknownWrites ? { cacheWriteInputTokensReported: false } : {}),\n outputTokens,\n estimatedUsd,\n estimatedUsdRange: {\n min: estimatedUsd,\n max: long === undefined ? null : priceInUsd(long, unknownWrites),\n context: \"unknown\",\n },\n pricing: {\n source,\n asOf,\n serviceTier: \"standard\",\n context: \"short\",\n usdPerMillionTokens: usdPerMillionTokens(short, unitsPerUsd),\n ...(long === undefined\n ? {}\n : {\n longContextUsdPerMillionTokens: usdPerMillionTokens(\n long,\n unitsPerUsd,\n ),\n }),\n },\n };\n}\n\nexport function formatTokenUsage(value: unknown): string | null {\n const usage = tokenUsage(value);\n if (usage === null) return null;\n const writes =\n usage.cache_write_input_tokens_reported === false\n ? null\n : usage.cache_write_input_tokens;\n const uncached =\n writes === null\n ? null\n : usage.input_tokens - usage.cached_input_tokens - writes;\n return (\n [\n [uncached, \"uncached input\"],\n [usage.cached_input_tokens, \"cache reads\"],\n [writes, \"cache writes\"],\n [usage.output_tokens, \"output\"],\n [usage.total_tokens, \"total\"],\n ] as const\n )\n .map(\n ([count, label]) =>\n `${count === null ? \"unavailable\" : count.toLocaleString(\"en-US\")} ${label}`,\n )\n .join(\", \");\n}\n\nexport function formatScanCostTokens(cost: Readonly<ScanCost>): string {\n return formatTokenUsage({\n input_tokens: cost.inputTokens,\n cached_input_tokens: cost.cachedInputTokens,\n cache_write_input_tokens: cost.cacheWriteInputTokens,\n cache_write_input_tokens_reported: cost.cacheWriteInputTokensReported,\n output_tokens: cost.outputTokens,\n })!;\n}\n\nexport function formatScanCost(cost: Readonly<ScanCost>): string {\n return formatScanCosts([cost]);\n}\n\nexport function formatScanCosts(costs: readonly Readonly<ScanCost>[]): string {\n if (costs.some((cost) => cost.estimatedUsdRange === undefined)) {\n return `${formatUsd(costs.reduce((sum, cost) => sum + cost.estimatedUsd, 0))} (legacy estimate, context unknown)`;\n }\n const minimum = costs.reduce(\n (sum, cost) => sum + cost.estimatedUsdRange!.min,\n 0,\n );\n const maximum = costs.some((cost) => cost.estimatedUsdRange!.max === null)\n ? null\n : costs.reduce((sum, cost) => sum + cost.estimatedUsdRange!.max!, 0);\n const cacheWrites = costs.some(\n (cost) => cost.cacheWriteInputTokensReported === false,\n )\n ? \", cache writes unknown\"\n : \"\";\n if (maximum === null) {\n return `at least ${formatUsd(minimum)} (standard, upper estimate unavailable${cacheWrites})`;\n }\n const amount =\n minimum === maximum\n ? formatUsd(minimum)\n : `${formatUsd(minimum)}–${formatUsd(maximum)}`;\n return `${amount} (standard, context unknown${cacheWrites})`;\n}\n\nexport function formatUsd(value: number): string {\n return new Intl.NumberFormat(\"en-US\", {\n style: \"currency\",\n currency: \"USD\",\n minimumFractionDigits: 2,\n maximumFractionDigits: 9,\n }).format(value);\n}\n"]}
package/dist/cost.d.ts CHANGED
@@ -1,7 +1,23 @@
1
- import { type ScanCost, type ScanTokenUsage } from "./cost-model.js";
1
+ import type { JsonObject } from "./config.js";
2
+ import { type ScanCost, type ScanPricingContext, type ScanTokenUsage } from "./cost-model.js";
2
3
  import { type ScanActivity } from "./scan-activity.js";
3
4
  import { type ScanProgress } from "./worker-progress.js";
4
5
  export { estimateScanCost, formatUsd, type ScanCost } from "./cost-model.js";
6
+ export declare function readScanBudgetUsage(workbench: (args: readonly string[]) => Promise<JsonObject>, scanId: string, threadId: string, validationThreadId?: string, requireWorkerUsage?: boolean): Promise<{
7
+ warnings?: string[] | undefined;
8
+ threadCount?: number | undefined;
9
+ missingThreadCount?: number | undefined;
10
+ coverageScope?: string[] | undefined;
11
+ usage: null;
12
+ complete: boolean;
13
+ } | {
14
+ warnings?: string[] | undefined;
15
+ threadCount?: number | undefined;
16
+ missingThreadCount?: number | undefined;
17
+ coverageScope?: string[] | undefined;
18
+ usage: ScanTokenUsage;
19
+ complete: boolean;
20
+ }>;
5
21
  export interface ScanAccountRateLimitWindow {
6
22
  readonly usedPercent: number;
7
23
  readonly windowMinutes: number | null;
@@ -42,24 +58,46 @@ export type ParentProgressSource = {
42
58
  };
43
59
  interface ScanCostTrackerOptions {
44
60
  codexHome: string;
61
+ pricingContext?: ScanPricingContext;
45
62
  model: string;
46
63
  repository?: string;
47
64
  scanDirectory?: string;
65
+ /** Host-bound store outside model-writable scan artifacts, for Deep scans only. */
66
+ workerReceipts?: {
67
+ directory: string;
68
+ scanId: string;
69
+ };
48
70
  maxCostUsd?: number;
71
+ readBudgetUsage?: (threadId: string) => ReturnType<typeof readScanBudgetUsage>;
49
72
  expectedFilesTotal?: number;
50
73
  /** Incomplete costs are measured subtotals, usable for spending limits only. */
51
74
  onCost?: (cost: Readonly<ScanCost>, complete: boolean) => void;
52
75
  onUsage?: (usage: Readonly<ScanTokenUsage>) => void;
76
+ onMeasurement?: (measurement: Readonly<ScanUsageMeasurement>) => void;
53
77
  onUsageObservation?: (observation: ScanUsageObservation) => void;
54
78
  onActivity?: (activity: ScanActivity) => void;
55
79
  onProgress?: (progress: ScanProgress, source?: ParentProgressSource) => void;
56
80
  onSessionEvent?: (event: ScanSessionEvent) => void;
57
81
  onWorkerEvent?: (event: ScanWorkerEvent) => void;
58
82
  onError?: (error: unknown) => void;
83
+ onObservationError?: (error: unknown) => void;
84
+ }
85
+ export interface ScanUsageMeasurement {
86
+ usage: Readonly<ScanTokenUsage> | null;
87
+ cost: Readonly<ScanCost> | null;
88
+ coverage: "complete" | "partial" | "unavailable";
89
+ observedAt: string;
90
+ threadCount: number;
91
+ missingThreadCount: number;
92
+ /** Known thread/attempt identities for reconciling coverage, not metric labels. */
93
+ coverageScope?: string[];
94
+ /** Workbench diagnostic codes explaining coverage or price completeness. */
95
+ warnings?: string[];
59
96
  }
60
- interface ScanCostSnapshot {
97
+ export interface ScanCostSnapshot {
61
98
  usage: unknown;
62
99
  cost: ScanCost | null;
100
+ measurement: ScanUsageMeasurement;
63
101
  }
64
102
  export declare class ScanCostTracker {
65
103
  #private;
@@ -76,8 +114,9 @@ export declare class ScanCostTracker {
76
114
  acceptParentProgress(progress: ScanProgress, event: Readonly<Record<string, unknown>>): void;
77
115
  recordUsage(usage: unknown, threadId?: string | null): void;
78
116
  start(threadId: string): void;
79
- refresh(): Promise<ScanCostSnapshot>;
117
+ refresh(polling?: boolean): Promise<ScanCostSnapshot>;
80
118
  stop(fallbackUsage?: unknown): Promise<ScanCostSnapshot>;
81
119
  }
82
120
  export declare function sessionFiles(directory: string, compressed?: boolean): AsyncGenerator<string>;
121
+ export declare function addTokenUsage(previous: ScanTokenUsage | null, next: ScanTokenUsage): ScanTokenUsage;
83
122
  //# sourceMappingURL=cost.d.ts.map