@openai/codex-security 0.2.0 → 0.4.0

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 (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +556 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +43 -170
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
@@ -0,0 +1,19 @@
1
+ import { type Readable } from "node:stream";
2
+ type Output = Pick<NodeJS.WriteStream, "write"> & {
3
+ on?(event: "error", listener: (error: Error) => void): unknown;
4
+ off?(event: "error", listener: (error: Error) => void): unknown;
5
+ };
6
+ type Execute = (id: string, request: unknown, onProgress?: (event: unknown) => void) => Promise<unknown>;
7
+ /** One bidirectional run, shared with dedupe. This transport never replays. */
8
+ export declare function runHostProtocol(input: Readable, output: Output, operation: {
9
+ label: string;
10
+ requestMethod: string;
11
+ /** Scan cancellation must retain the host's eventual receipt and usage. */
12
+ awaitCancellationReceipt?: boolean;
13
+ errorData?: (error: unknown) => object | undefined;
14
+ run(params: unknown, execute: Execute, signal: AbortSignal, onProgress: (event: unknown) => void): Promise<{
15
+ status: string;
16
+ }>;
17
+ }, signal?: AbortSignal): Promise<number>;
18
+ export {};
19
+ //# sourceMappingURL=host-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host-protocol.d.ts","sourceRoot":"","sources":["../src/host-protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,aAAa,CAAC;AA6BtD,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;IAChD,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IAC/D,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;CACjE,CAAC;AACF,KAAK,OAAO,GAAG,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAClC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,+EAA+E;AAC/E,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE;IACT,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD,GAAG,CACD,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACnC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChC,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CA8PjB"}
@@ -0,0 +1,270 @@
1
+ import { createInterface } from "node:readline";
2
+ import { Writable } from "node:stream";
3
+ import { z } from "incur";
4
+ const rpcId = z.union([z.string(), z.number().int()]);
5
+ const envelope = z.strictObject({ jsonrpc: z.literal("2.0") });
6
+ const request = envelope.extend({
7
+ id: rpcId,
8
+ method: z.literal("run"),
9
+ params: z.unknown(),
10
+ });
11
+ const cancellation = envelope.extend({
12
+ method: z.literal("cancel"),
13
+ params: z.strictObject({ id: rpcId }),
14
+ });
15
+ const progress = envelope.extend({
16
+ method: z.literal("execution.progress"),
17
+ params: z.strictObject({ requestId: z.string(), event: z.unknown() }),
18
+ });
19
+ const response = z.union([
20
+ envelope.extend({ id: rpcId, result: z.unknown() }),
21
+ envelope.extend({
22
+ id: rpcId,
23
+ error: z.strictObject({
24
+ code: z.number().int(),
25
+ message: z.string(),
26
+ data: z.unknown().optional(),
27
+ }),
28
+ }),
29
+ ]);
30
+ /** One bidirectional run, shared with dedupe. This transport never replays. */
31
+ export async function runHostProtocol(input, output, operation, signal) {
32
+ const controller = new AbortController();
33
+ let runId;
34
+ let terminalCode;
35
+ let completed = false;
36
+ let pending;
37
+ const { promise: completion, resolve: resolveCompletion } = Promise.withResolvers();
38
+ const complete = (code) => {
39
+ if (completed)
40
+ return;
41
+ completed = true;
42
+ resolveCompletion(code);
43
+ };
44
+ const stopOutput = (code) => {
45
+ if (completed)
46
+ return;
47
+ complete(code);
48
+ if (output instanceof Writable) {
49
+ // Native stdout can emit close repeatedly when destroy() is called from
50
+ // its close listener. Detach before destroying, even before cleanup runs.
51
+ output.off("close", outputClosed);
52
+ output.destroy();
53
+ }
54
+ };
55
+ const lines = createInterface({
56
+ input,
57
+ crlfDelay: Infinity,
58
+ terminal: false,
59
+ });
60
+ const send = async (message, onFlushed) => {
61
+ const line = `${JSON.stringify(message)}\n`;
62
+ if (output instanceof Writable) {
63
+ if (output.destroyed)
64
+ throw new Error("Host output is closed.");
65
+ await new Promise((resolve, reject) => {
66
+ let settled = false;
67
+ const settle = (error) => {
68
+ if (settled)
69
+ return;
70
+ settled = true;
71
+ output.off("close", closed);
72
+ // Node can emit error/close before the rejected Promise is observed.
73
+ // Record the failed write now, so the selected result cannot win.
74
+ if (error)
75
+ outputError(error);
76
+ else
77
+ onFlushed?.();
78
+ error ? reject(error) : resolve();
79
+ };
80
+ const closed = () => settle(new Error("Host output closed during write."));
81
+ output.once("close", closed);
82
+ output.write(line, settle);
83
+ });
84
+ }
85
+ else {
86
+ output.write(line);
87
+ onFlushed?.();
88
+ }
89
+ };
90
+ const fail = (code, message, canWrite = true, data) => {
91
+ if (completed)
92
+ return;
93
+ if (terminalCode !== undefined) {
94
+ if (!canWrite)
95
+ stopOutput(2);
96
+ return;
97
+ }
98
+ terminalCode = 2;
99
+ controller.abort(new Error(message));
100
+ pending?.reject(new Error(message));
101
+ pending = undefined;
102
+ // A peer that stopped reading cannot receive an error. Unblock both the
103
+ // request write and completion instead of waiting for a write callback.
104
+ if (!canWrite ||
105
+ (output instanceof Writable &&
106
+ (output.writableLength > 0 || output.writableNeedDrain))) {
107
+ stopOutput(2);
108
+ return;
109
+ }
110
+ void send({
111
+ jsonrpc: "2.0",
112
+ id: runId ?? null,
113
+ error: { code, message, ...(data === undefined ? {} : { data }) },
114
+ })
115
+ .catch(() => undefined)
116
+ .then(() => complete(2));
117
+ };
118
+ const disconnected = () => {
119
+ // Stdin EOF does not close stdout. If a terminal response is already being
120
+ // written, its callback decides whether delivery succeeded.
121
+ if (terminalCode === undefined)
122
+ fail(-32000, "Host disconnected before the run completed.");
123
+ };
124
+ const inputError = (error) => fail(-32000, error.message);
125
+ const outputError = (error) => fail(-32000, error.message, false);
126
+ const outputClosed = () => outputError(new Error("Host output is closed."));
127
+ const interrupted = () => {
128
+ if (terminalCode !== undefined)
129
+ stopOutput(2);
130
+ else
131
+ fail(-32800, `${operation.label} canceled.`);
132
+ };
133
+ const canceled = () => {
134
+ if (!operation.awaitCancellationReceipt ||
135
+ terminalCode !== undefined ||
136
+ (output instanceof Writable &&
137
+ (output.writableLength > 0 || output.writableNeedDrain))) {
138
+ interrupted();
139
+ return;
140
+ }
141
+ if (controller.signal.aborted)
142
+ return;
143
+ controller.abort(new Error(`${operation.label} canceled.`));
144
+ if (pending)
145
+ void send({
146
+ jsonrpc: "2.0",
147
+ method: "execution.cancel",
148
+ params: { requestId: pending.id },
149
+ }).catch(outputError);
150
+ };
151
+ input.on("error", inputError);
152
+ input.on("close", disconnected);
153
+ if (output instanceof Writable)
154
+ output.on("close", outputClosed);
155
+ lines.on("close", disconnected);
156
+ lines.on("error", inputError);
157
+ output.on?.("error", outputError);
158
+ signal?.addEventListener("abort", interrupted, { once: true });
159
+ lines.on("line", (line) => {
160
+ let message;
161
+ try {
162
+ message = JSON.parse(line);
163
+ }
164
+ catch {
165
+ fail(-32700, "Invalid JSON.");
166
+ return;
167
+ }
168
+ const cancel = cancellation.safeParse(message);
169
+ if (cancel.success) {
170
+ if (runId === undefined || cancel.data.params.id !== runId)
171
+ fail(-32600, "Cancellation does not match the active run.");
172
+ else
173
+ canceled();
174
+ return;
175
+ }
176
+ if (terminalCode !== undefined)
177
+ return;
178
+ const run = request.safeParse(message);
179
+ if (run.success) {
180
+ if (runId !== undefined) {
181
+ fail(-32600, "Only one run request is allowed.");
182
+ return;
183
+ }
184
+ runId = run.data.id;
185
+ void operation
186
+ .run(run.data.params, (id, params, onProgress) => {
187
+ if (terminalCode !== undefined || controller.signal.aborted)
188
+ return Promise.reject(controller.signal.reason);
189
+ if (pending)
190
+ return Promise.reject(new Error("Execution is already pending."));
191
+ return new Promise((resolve, reject) => {
192
+ pending = { id, resolve, reject, onProgress };
193
+ void send({
194
+ jsonrpc: "2.0",
195
+ id,
196
+ method: operation.requestMethod,
197
+ params,
198
+ }).catch(outputError);
199
+ });
200
+ }, controller.signal, (event) => {
201
+ if (terminalCode === undefined)
202
+ void send({
203
+ jsonrpc: "2.0",
204
+ method: "scan.progress",
205
+ params: { id: runId, event },
206
+ }).catch(outputError);
207
+ })
208
+ .then(async (result) => {
209
+ if (terminalCode !== undefined)
210
+ return;
211
+ const code = result.status === "completed" ? 0 : 1;
212
+ terminalCode = code;
213
+ try {
214
+ await send({ jsonrpc: "2.0", id: runId, result }, () => complete(code));
215
+ }
216
+ catch {
217
+ complete(2);
218
+ }
219
+ }, (error) => fail(-32602, error instanceof Error
220
+ ? error.message
221
+ : "Invalid run parameters.", true, operation.errorData?.(error)));
222
+ return;
223
+ }
224
+ const event = progress.safeParse(message);
225
+ if (event.success &&
226
+ operation.awaitCancellationReceipt &&
227
+ pending &&
228
+ event.data.params.requestId === pending.id) {
229
+ // Optional progress must never interrupt execution, including bad events
230
+ // or host observer exceptions. Correlation still rejects stale messages.
231
+ try {
232
+ pending.onProgress?.(event.data.params.event);
233
+ }
234
+ catch { }
235
+ return;
236
+ }
237
+ const reply = response.safeParse(message);
238
+ if (!reply.success || !pending || reply.data.id !== pending.id) {
239
+ fail(-32600, `Malformed, unexpected, or mismatched ${operation.requestMethod === "review.run" ? "review" : "execution"} response.`);
240
+ return;
241
+ }
242
+ const execution = pending;
243
+ pending = undefined;
244
+ if ("error" in reply.data)
245
+ execution.reject(new Error(reply.data.error.message));
246
+ else
247
+ execution.resolve(reply.data.result);
248
+ });
249
+ if (signal?.aborted)
250
+ interrupted();
251
+ if (input.readableEnded || input.destroyed)
252
+ disconnected();
253
+ try {
254
+ return await completion;
255
+ }
256
+ finally {
257
+ lines.removeAllListeners("line");
258
+ lines.removeListener("close", disconnected);
259
+ lines.removeListener("error", inputError);
260
+ lines.close();
261
+ input.pause();
262
+ input.removeListener("error", inputError);
263
+ input.removeListener("close", disconnected);
264
+ if (output instanceof Writable)
265
+ output.removeListener("close", outputClosed);
266
+ output.off?.("error", outputError);
267
+ signal?.removeEventListener("abort", interrupted);
268
+ }
269
+ }
270
+ //# sourceMappingURL=host-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host-protocol.js","sourceRoot":"","sources":["../src/host-protocol.ts"],"names":[],"mappings":"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","sourcesContent":["import { createInterface } from \"node:readline\";\nimport { type Readable, Writable } from \"node:stream\";\nimport { z } from \"incur\";\n\nconst rpcId = z.union([z.string(), z.number().int()]);\nconst envelope = z.strictObject({ jsonrpc: z.literal(\"2.0\") });\nconst request = envelope.extend({\n id: rpcId,\n method: z.literal(\"run\"),\n params: z.unknown(),\n});\nconst cancellation = envelope.extend({\n method: z.literal(\"cancel\"),\n params: z.strictObject({ id: rpcId }),\n});\nconst progress = envelope.extend({\n method: z.literal(\"execution.progress\"),\n params: z.strictObject({ requestId: z.string(), event: z.unknown() }),\n});\nconst response = z.union([\n envelope.extend({ id: rpcId, result: z.unknown() }),\n envelope.extend({\n id: rpcId,\n error: z.strictObject({\n code: z.number().int(),\n message: z.string(),\n data: z.unknown().optional(),\n }),\n }),\n]);\ntype Output = Pick<NodeJS.WriteStream, \"write\"> & {\n on?(event: \"error\", listener: (error: Error) => void): unknown;\n off?(event: \"error\", listener: (error: Error) => void): unknown;\n};\ntype Execute = (\n id: string,\n request: unknown,\n onProgress?: (event: unknown) => void,\n) => Promise<unknown>;\n\n/** One bidirectional run, shared with dedupe. This transport never replays. */\nexport async function runHostProtocol(\n input: Readable,\n output: Output,\n operation: {\n label: string;\n requestMethod: string;\n /** Scan cancellation must retain the host's eventual receipt and usage. */\n awaitCancellationReceipt?: boolean;\n errorData?: (error: unknown) => object | undefined;\n run(\n params: unknown,\n execute: Execute,\n signal: AbortSignal,\n onProgress: (event: unknown) => void,\n ): Promise<{ status: string }>;\n },\n signal?: AbortSignal,\n): Promise<number> {\n const controller = new AbortController();\n let runId: string | number | undefined;\n let terminalCode: number | undefined;\n let completed = false;\n let pending:\n | {\n id: string;\n resolve(value: unknown): void;\n reject(error: Error): void;\n onProgress?: (event: unknown) => void;\n }\n | undefined;\n const { promise: completion, resolve: resolveCompletion } =\n Promise.withResolvers<number>();\n const complete = (code: number) => {\n if (completed) return;\n completed = true;\n resolveCompletion(code);\n };\n const stopOutput = (code: number) => {\n if (completed) return;\n complete(code);\n if (output instanceof Writable) {\n // Native stdout can emit close repeatedly when destroy() is called from\n // its close listener. Detach before destroying, even before cleanup runs.\n output.off(\"close\", outputClosed);\n output.destroy();\n }\n };\n const lines = createInterface({\n input,\n crlfDelay: Infinity,\n terminal: false,\n });\n const send = async (message: object, onFlushed?: () => void) => {\n const line = `${JSON.stringify(message)}\\n`;\n if (output instanceof Writable) {\n if (output.destroyed) throw new Error(\"Host output is closed.\");\n await new Promise<void>((resolve, reject) => {\n let settled = false;\n const settle = (error?: Error | null) => {\n if (settled) return;\n settled = true;\n output.off(\"close\", closed);\n // Node can emit error/close before the rejected Promise is observed.\n // Record the failed write now, so the selected result cannot win.\n if (error) outputError(error);\n else onFlushed?.();\n error ? reject(error) : resolve();\n };\n const closed = () =>\n settle(new Error(\"Host output closed during write.\"));\n output.once(\"close\", closed);\n output.write(line, settle);\n });\n } else {\n output.write(line);\n onFlushed?.();\n }\n };\n const fail = (\n code: number,\n message: string,\n canWrite = true,\n data?: object,\n ) => {\n if (completed) return;\n if (terminalCode !== undefined) {\n if (!canWrite) stopOutput(2);\n return;\n }\n terminalCode = 2;\n controller.abort(new Error(message));\n pending?.reject(new Error(message));\n pending = undefined;\n // A peer that stopped reading cannot receive an error. Unblock both the\n // request write and completion instead of waiting for a write callback.\n if (\n !canWrite ||\n (output instanceof Writable &&\n (output.writableLength > 0 || output.writableNeedDrain))\n ) {\n stopOutput(2);\n return;\n }\n void send({\n jsonrpc: \"2.0\",\n id: runId ?? null,\n error: { code, message, ...(data === undefined ? {} : { data }) },\n })\n .catch(() => undefined)\n .then(() => complete(2));\n };\n const disconnected = () => {\n // Stdin EOF does not close stdout. If a terminal response is already being\n // written, its callback decides whether delivery succeeded.\n if (terminalCode === undefined)\n fail(-32000, \"Host disconnected before the run completed.\");\n };\n const inputError = (error: Error) => fail(-32000, error.message);\n const outputError = (error: Error) => fail(-32000, error.message, false);\n const outputClosed = () => outputError(new Error(\"Host output is closed.\"));\n const interrupted = () => {\n if (terminalCode !== undefined) stopOutput(2);\n else fail(-32800, `${operation.label} canceled.`);\n };\n const canceled = () => {\n if (\n !operation.awaitCancellationReceipt ||\n terminalCode !== undefined ||\n (output instanceof Writable &&\n (output.writableLength > 0 || output.writableNeedDrain))\n ) {\n interrupted();\n return;\n }\n if (controller.signal.aborted) return;\n controller.abort(new Error(`${operation.label} canceled.`));\n if (pending)\n void send({\n jsonrpc: \"2.0\",\n method: \"execution.cancel\",\n params: { requestId: pending.id },\n }).catch(outputError);\n };\n input.on(\"error\", inputError);\n input.on(\"close\", disconnected);\n if (output instanceof Writable) output.on(\"close\", outputClosed);\n lines.on(\"close\", disconnected);\n lines.on(\"error\", inputError);\n output.on?.(\"error\", outputError);\n signal?.addEventListener(\"abort\", interrupted, { once: true });\n lines.on(\"line\", (line) => {\n let message: unknown;\n try {\n message = JSON.parse(line);\n } catch {\n fail(-32700, \"Invalid JSON.\");\n return;\n }\n const cancel = cancellation.safeParse(message);\n if (cancel.success) {\n if (runId === undefined || cancel.data.params.id !== runId)\n fail(-32600, \"Cancellation does not match the active run.\");\n else canceled();\n return;\n }\n if (terminalCode !== undefined) return;\n const run = request.safeParse(message);\n if (run.success) {\n if (runId !== undefined) {\n fail(-32600, \"Only one run request is allowed.\");\n return;\n }\n runId = run.data.id;\n void operation\n .run(\n run.data.params,\n (id, params, onProgress) => {\n if (terminalCode !== undefined || controller.signal.aborted)\n return Promise.reject(controller.signal.reason);\n if (pending)\n return Promise.reject(new Error(\"Execution is already pending.\"));\n return new Promise((resolve, reject) => {\n pending = { id, resolve, reject, onProgress };\n void send({\n jsonrpc: \"2.0\",\n id,\n method: operation.requestMethod,\n params,\n }).catch(outputError);\n });\n },\n controller.signal,\n (event) => {\n if (terminalCode === undefined)\n void send({\n jsonrpc: \"2.0\",\n method: \"scan.progress\",\n params: { id: runId, event },\n }).catch(outputError);\n },\n )\n .then(\n async (result) => {\n if (terminalCode !== undefined) return;\n const code = result.status === \"completed\" ? 0 : 1;\n terminalCode = code;\n try {\n await send({ jsonrpc: \"2.0\", id: runId, result }, () =>\n complete(code),\n );\n } catch {\n complete(2);\n }\n },\n (error: unknown) =>\n fail(\n -32602,\n error instanceof Error\n ? error.message\n : \"Invalid run parameters.\",\n true,\n operation.errorData?.(error),\n ),\n );\n return;\n }\n const event = progress.safeParse(message);\n if (\n event.success &&\n operation.awaitCancellationReceipt &&\n pending &&\n event.data.params.requestId === pending.id\n ) {\n // Optional progress must never interrupt execution, including bad events\n // or host observer exceptions. Correlation still rejects stale messages.\n try {\n pending.onProgress?.(event.data.params.event);\n } catch {}\n return;\n }\n const reply = response.safeParse(message);\n if (!reply.success || !pending || reply.data.id !== pending.id) {\n fail(\n -32600,\n `Malformed, unexpected, or mismatched ${operation.requestMethod === \"review.run\" ? \"review\" : \"execution\"} response.`,\n );\n return;\n }\n const execution = pending;\n pending = undefined;\n if (\"error\" in reply.data)\n execution.reject(new Error(reply.data.error.message));\n else execution.resolve(reply.data.result);\n });\n if (signal?.aborted) interrupted();\n if (input.readableEnded || input.destroyed) disconnected();\n try {\n return await completion;\n } finally {\n lines.removeAllListeners(\"line\");\n lines.removeListener(\"close\", disconnected);\n lines.removeListener(\"error\", inputError);\n lines.close();\n input.pause();\n input.removeListener(\"error\", inputError);\n input.removeListener(\"close\", disconnected);\n if (output instanceof Writable)\n output.removeListener(\"close\", outputClosed);\n output.off?.(\"error\", outputError);\n signal?.removeEventListener(\"abort\", interrupted);\n }\n}\n"]}
@@ -0,0 +1,4 @@
1
+ import type { Readable } from "node:stream";
2
+ import { runHostProtocol } from "./host-protocol.js";
3
+ export declare function runHostedScanProtocol(input: Readable, output: Parameters<typeof runHostProtocol>[1], signal?: AbortSignal): Promise<number>;
4
+ //# sourceMappingURL=hosted-scan-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-scan-protocol.d.ts","sourceRoot":"","sources":["../src/hosted-scan-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAWrD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,EAC7C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CA6BjB"}
@@ -0,0 +1,25 @@
1
+ import { runHostProtocol } from "./host-protocol.js";
2
+ import { HostedScanPreparationError, runHostedScan, } from "./hosted-scan.js";
3
+ import { ScanExecutionEventSchema, ScanExecutionResultSchema, } from "./scan-executor.js";
4
+ export async function runHostedScanProtocol(input, output, signal) {
5
+ return await runHostProtocol(input, output, {
6
+ label: "Scan",
7
+ requestMethod: "execution.run",
8
+ awaitCancellationReceipt: true,
9
+ errorData: (error) => error instanceof HostedScanPreparationError
10
+ ? { reason: error.reason }
11
+ : undefined,
12
+ run: async (params, execute, signal, onEvent) => await runHostedScan(params, {
13
+ signal,
14
+ onEvent,
15
+ executor: {
16
+ run: async (request, options) => ScanExecutionResultSchema.parse(await execute(request.requestId, request, (event) => {
17
+ const parsed = ScanExecutionEventSchema.safeParse(event);
18
+ if (parsed.success)
19
+ options.onEvent?.(parsed.data);
20
+ })),
21
+ },
22
+ }),
23
+ }, signal);
24
+ }
25
+ //# sourceMappingURL=hosted-scan-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-scan-protocol.js","sourceRoot":"","sources":["../src/hosted-scan-protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEL,0BAA0B,EAC1B,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAe,EACf,MAA6C,EAC7C,MAAoB;IAEpB,OAAO,MAAM,eAAe,CAC1B,KAAK,EACL,MAAM,EACN;QACE,KAAK,EAAE,MAAM;QACb,aAAa,EAAE,eAAe;QAC9B,wBAAwB,EAAE,IAAI;QAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnB,KAAK,YAAY,0BAA0B;YACzC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;YAC1B,CAAC,CAAC,SAAS;QACf,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAC9C,MAAM,aAAa,CAAC,MAAyB,EAAE;YAC7C,MAAM;YACN,OAAO;YACP,QAAQ,EAAE;gBACR,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAC9B,yBAAyB,CAAC,KAAK,CAC7B,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBAClD,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBACzD,IAAI,MAAM,CAAC,OAAO;wBAAE,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC,CAAC,CACH;aACJ;SACF,CAAC;KACL,EACD,MAAM,CACP,CAAC;AACJ,CAAC","sourcesContent":["import type { Readable } from \"node:stream\";\nimport { runHostProtocol } from \"./host-protocol.js\";\nimport {\n type HostedScanInput,\n HostedScanPreparationError,\n runHostedScan,\n} from \"./hosted-scan.js\";\nimport {\n ScanExecutionEventSchema,\n ScanExecutionResultSchema,\n} from \"./scan-executor.js\";\n\nexport async function runHostedScanProtocol(\n input: Readable,\n output: Parameters<typeof runHostProtocol>[1],\n signal?: AbortSignal,\n): Promise<number> {\n return await runHostProtocol(\n input,\n output,\n {\n label: \"Scan\",\n requestMethod: \"execution.run\",\n awaitCancellationReceipt: true,\n errorData: (error) =>\n error instanceof HostedScanPreparationError\n ? { reason: error.reason }\n : undefined,\n run: async (params, execute, signal, onEvent) =>\n await runHostedScan(params as HostedScanInput, {\n signal,\n onEvent,\n executor: {\n run: async (request, options) =>\n ScanExecutionResultSchema.parse(\n await execute(request.requestId, request, (event) => {\n const parsed = ScanExecutionEventSchema.safeParse(event);\n if (parsed.success) options.onEvent?.(parsed.data);\n }),\n ),\n },\n }),\n },\n signal,\n );\n}\n"]}
@@ -0,0 +1,117 @@
1
+ import { type ScanExecutor, type ScanExecutionEvent } from "./scan-executor.js";
2
+ export type { ScanExecutor, ScanExecutionRequest } from "./scan-executor.js";
3
+ import { z } from "zod";
4
+ /** Hosted v2 mirrors repository/paths targets; only Standard scans are supported. */
5
+ export declare const HostedScanInputSchema: z.ZodObject<{
6
+ version: z.ZodLiteral<2>;
7
+ repository: z.ZodString;
8
+ revision: z.ZodString;
9
+ scope: z.ZodOptional<z.ZodObject<{
10
+ paths: z.ZodArray<z.ZodString>;
11
+ }, z.core.$strict>>;
12
+ outputDirectory: z.ZodString;
13
+ stateDirectory: z.ZodString;
14
+ model: z.ZodString;
15
+ reasoningEffort: z.ZodEnum<{
16
+ high: "high";
17
+ low: "low";
18
+ medium: "medium";
19
+ xhigh: "xhigh";
20
+ }>;
21
+ identity: z.ZodObject<{
22
+ runId: z.ZodString;
23
+ attemptId: z.ZodString;
24
+ buildId: z.ZodString;
25
+ }, z.core.$strict>;
26
+ }, z.core.$strict>;
27
+ export type HostedScanInput = z.infer<typeof HostedScanInputSchema>;
28
+ export declare class HostedScanPreparationError extends Error {
29
+ readonly reason: "scope_syntax" | "scope_missing" | "scope_outside_repository" | "scope_alias" | "revision_mismatch";
30
+ constructor(reason: "scope_syntax" | "scope_missing" | "scope_outside_repository" | "scope_alias" | "revision_mismatch", message: string);
31
+ }
32
+ export declare function normalizeHostedScope(path: string): string;
33
+ export declare function normalizeHostedPaths(paths?: readonly string[]): string[];
34
+ export interface HostedScanOptions {
35
+ executor: ScanExecutor;
36
+ signal?: AbortSignal;
37
+ onEvent?: (event: ScanExecutionEvent) => void;
38
+ }
39
+ /** One invocation, with only scan-domain state. The host decides retry/reconciliation. */
40
+ export declare function runHostedScan(value: HostedScanInput, options: HostedScanOptions): Promise<{
41
+ repository: string;
42
+ revision: string;
43
+ scope: {
44
+ paths: string[];
45
+ };
46
+ identity: {
47
+ runId: string;
48
+ attemptId: string;
49
+ buildId: string;
50
+ };
51
+ version: 2;
52
+ outputDirectory: string;
53
+ scanId?: string | undefined;
54
+ pluginVersion?: string | undefined;
55
+ provenance: {
56
+ cliVersion: string;
57
+ buildId: string;
58
+ pluginVersion?: string | undefined;
59
+ };
60
+ execution?: {
61
+ requestId: string;
62
+ status: "acceptance_unknown" | "canceled" | "completed" | "failed";
63
+ sessionId?: string | undefined;
64
+ finalResponse?: string | undefined;
65
+ usage?: unknown;
66
+ message?: string | undefined;
67
+ error?: {
68
+ code: number;
69
+ message: string;
70
+ data?: unknown;
71
+ } | undefined;
72
+ } | undefined;
73
+ status: "completed";
74
+ artifacts: {
75
+ path: string;
76
+ sha256: string;
77
+ bytes: number;
78
+ }[];
79
+ } | {
80
+ repository: string;
81
+ revision: string;
82
+ scope: {
83
+ paths: string[];
84
+ };
85
+ identity: {
86
+ runId: string;
87
+ attemptId: string;
88
+ buildId: string;
89
+ };
90
+ version: 2;
91
+ outputDirectory: string;
92
+ scanId?: string | undefined;
93
+ pluginVersion?: string | undefined;
94
+ provenance: {
95
+ cliVersion: string;
96
+ buildId: string;
97
+ pluginVersion?: string | undefined;
98
+ };
99
+ execution?: {
100
+ requestId: string;
101
+ status: "acceptance_unknown" | "canceled" | "completed" | "failed";
102
+ sessionId?: string | undefined;
103
+ finalResponse?: string | undefined;
104
+ usage?: unknown;
105
+ message?: string | undefined;
106
+ error?: {
107
+ code: number;
108
+ message: string;
109
+ data?: unknown;
110
+ } | undefined;
111
+ } | undefined;
112
+ status: "acceptance_unknown" | "canceled" | "failed";
113
+ error: string;
114
+ artifacts: never[];
115
+ }>;
116
+ export type HostedScanResult = Awaited<ReturnType<typeof runHostedScan>>;
117
+ //# sourceMappingURL=hosted-scan.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-scan.d.ts","sourceRoot":"","sources":["../src/hosted-scan.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,qFAAqF;AACrF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;kBAgBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,MAAM,EACX,cAAc,GACd,eAAe,GACf,0BAA0B,GAC1B,aAAa,GACb,mBAAmB;IANzB,YACW,MAAM,EACX,cAAc,GACd,eAAe,GACf,0BAA0B,GAC1B,aAAa,GACb,mBAAmB,EACvB,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBzD;AAMD,wBAAgB,oBAAoB,CAClC,KAAK,GAAE,SAAS,MAAM,EAAU,GAC/B,MAAM,EAAE,CAeV;AAmED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C;AAED,0FAA0F;AAC1F,wBAAsB,aAAa,CACjC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,iBAAiB;;;;;;;;;;;aAwCf,CAAC;;;;;;;;;;;;;;;;;;;;;;YA8EA,WAAW;;;;;;;;;;;;;;;;;aA9EZ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;GAgHb;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC"}