@openai/codex-security 0.5.0 → 0.6.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 (299) hide show
  1. package/README.md +93 -2
  2. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  3. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  4. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  5. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +60 -9
  6. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  7. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  8. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +1 -1
  9. package/_bundled_plugin/scripts/finalize_scan_contract.py +12 -1
  10. package/_bundled_plugin/scripts/generate_in_scope_files.py +6 -6
  11. package/_bundled_plugin/scripts/generate_rank_input.py +12 -6
  12. package/_bundled_plugin/scripts/report_projection.py +2 -1
  13. package/_bundled_plugin/scripts/threat_model_projection.py +1 -3
  14. package/_bundled_plugin/scripts/workbench/saved_coverage.py +234 -0
  15. package/_bundled_plugin/scripts/workbench_cli.py +5 -7
  16. package/_bundled_plugin/scripts/workbench_db.py +12 -6
  17. package/_bundled_plugin/scripts/workbench_finding_workflows.py +2 -0
  18. package/_bundled_plugin/scripts/workbench_native_indexes.py +10 -7
  19. package/_bundled_plugin/scripts/workbench_publication.py +4 -3
  20. package/_bundled_plugin/scripts/workbench_remediation.py +5 -1
  21. package/_bundled_plugin/scripts/workbench_saved_results.py +542 -148
  22. package/_bundled_plugin/scripts/workbench_scan_history.py +79 -78
  23. package/_bundled_plugin/scripts/workbench_scan_usage.py +61 -13
  24. package/_bundled_plugin/scripts/workbench_target.py +21 -7
  25. package/_bundled_plugin/scripts/workbench_validation.py +21 -18
  26. package/_bundled_plugin/shared/workbench-migrations.json +26 -0
  27. package/_bundled_plugin/skills/fix-finding/SKILL.md +16 -8
  28. package/_bundled_plugin/skills/publish-findings/SKILL.md +130 -0
  29. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
  30. package/_bundled_plugin/skills/verify-fix/SKILL.md +4 -2
  31. package/dist/api.d.ts +4 -1
  32. package/dist/api.d.ts.map +1 -1
  33. package/dist/api.js +233 -91
  34. package/dist/api.js.map +1 -1
  35. package/dist/classify-scan-severity.d.ts.map +1 -1
  36. package/dist/classify-scan-severity.js +16 -18
  37. package/dist/classify-scan-severity.js.map +1 -1
  38. package/dist/classify-severity-records.d.ts +5 -2
  39. package/dist/classify-severity-records.d.ts.map +1 -1
  40. package/dist/classify-severity-records.js +40 -34
  41. package/dist/classify-severity-records.js.map +1 -1
  42. package/dist/classify-severity.d.ts +5 -1
  43. package/dist/classify-severity.d.ts.map +1 -1
  44. package/dist/classify-severity.js +20 -30
  45. package/dist/classify-severity.js.map +1 -1
  46. package/dist/cli-daybreak.d.ts +5 -0
  47. package/dist/cli-daybreak.d.ts.map +1 -0
  48. package/dist/cli-daybreak.js +89 -0
  49. package/dist/cli-daybreak.js.map +1 -0
  50. package/dist/cli-help.d.ts.map +1 -1
  51. package/dist/cli-help.js +1 -0
  52. package/dist/cli-help.js.map +1 -1
  53. package/dist/cli.d.ts +12 -1
  54. package/dist/cli.d.ts.map +1 -1
  55. package/dist/cli.js +1224 -596
  56. package/dist/cli.js.map +1 -1
  57. package/dist/cloud-endpoint.d.ts +6 -0
  58. package/dist/cloud-endpoint.d.ts.map +1 -0
  59. package/dist/cloud-endpoint.js +51 -0
  60. package/dist/cloud-endpoint.js.map +1 -0
  61. package/dist/cloud-publish.d.ts.map +1 -1
  62. package/dist/cloud-publish.js +7 -5
  63. package/dist/cloud-publish.js.map +1 -1
  64. package/dist/codeowners.js +2 -2
  65. package/dist/codeowners.js.map +1 -1
  66. package/dist/component-plan.d.ts.map +1 -1
  67. package/dist/component-plan.js +3 -2
  68. package/dist/component-plan.js.map +1 -1
  69. package/dist/component-scan.js +2 -2
  70. package/dist/component-scan.js.map +1 -1
  71. package/dist/config.d.ts.map +1 -1
  72. package/dist/config.js +5 -1
  73. package/dist/config.js.map +1 -1
  74. package/dist/cost.d.ts +2 -1
  75. package/dist/cost.d.ts.map +1 -1
  76. package/dist/cost.js +17 -8
  77. package/dist/cost.js.map +1 -1
  78. package/dist/custom-validation.d.ts.map +1 -1
  79. package/dist/custom-validation.js +2 -5
  80. package/dist/custom-validation.js.map +1 -1
  81. package/dist/deduplication/codex-review.d.ts.map +1 -1
  82. package/dist/deduplication/codex-review.js +8 -6
  83. package/dist/deduplication/codex-review.js.map +1 -1
  84. package/dist/deduplication/local.d.ts.map +1 -1
  85. package/dist/deduplication/local.js +5 -2
  86. package/dist/deduplication/local.js.map +1 -1
  87. package/dist/deduplication/retry.d.ts.map +1 -1
  88. package/dist/deduplication/retry.js +5 -0
  89. package/dist/deduplication/retry.js.map +1 -1
  90. package/dist/deduplication/scan.js +5 -1
  91. package/dist/deduplication/scan.js.map +1 -1
  92. package/dist/deep-scan.d.ts +6 -0
  93. package/dist/deep-scan.d.ts.map +1 -1
  94. package/dist/deep-scan.js +8 -6
  95. package/dist/deep-scan.js.map +1 -1
  96. package/dist/default-severity-rubric.d.ts +3 -0
  97. package/dist/default-severity-rubric.d.ts.map +1 -0
  98. package/dist/default-severity-rubric.js +67 -0
  99. package/dist/default-severity-rubric.js.map +1 -0
  100. package/dist/endor-findings.d.ts +7 -0
  101. package/dist/endor-findings.d.ts.map +1 -0
  102. package/dist/endor-findings.js +233 -0
  103. package/dist/endor-findings.js.map +1 -0
  104. package/dist/external-findings-import.d.ts +5 -0
  105. package/dist/external-findings-import.d.ts.map +1 -0
  106. package/dist/external-findings-import.js +38 -0
  107. package/dist/external-findings-import.js.map +1 -0
  108. package/dist/external-findings-local.d.ts +63 -0
  109. package/dist/external-findings-local.d.ts.map +1 -0
  110. package/dist/external-findings-local.js +337 -0
  111. package/dist/external-findings-local.js.map +1 -0
  112. package/dist/external-findings-publish.d.ts +73 -0
  113. package/dist/external-findings-publish.d.ts.map +1 -0
  114. package/dist/external-findings-publish.js +713 -0
  115. package/dist/external-findings-publish.js.map +1 -0
  116. package/dist/external-findings-read.d.ts +6 -0
  117. package/dist/external-findings-read.d.ts.map +1 -0
  118. package/dist/external-findings-read.js +88 -0
  119. package/dist/external-findings-read.js.map +1 -0
  120. package/dist/external-findings.d.ts +21 -0
  121. package/dist/external-findings.d.ts.map +1 -0
  122. package/dist/external-findings.js +2 -0
  123. package/dist/external-findings.js.map +1 -0
  124. package/dist/external-import-contract.d.ts +13 -0
  125. package/dist/external-import-contract.d.ts.map +1 -0
  126. package/dist/external-import-contract.js +254 -0
  127. package/dist/external-import-contract.js.map +1 -0
  128. package/dist/external-import-models.d.ts +362 -0
  129. package/dist/external-import-models.d.ts.map +1 -0
  130. package/dist/external-import-models.js +3 -0
  131. package/dist/external-import-models.js.map +1 -0
  132. package/dist/finding-workflow.d.ts +1 -1
  133. package/dist/finding-workflow.d.ts.map +1 -1
  134. package/dist/finding-workflow.js +2 -1
  135. package/dist/finding-workflow.js.map +1 -1
  136. package/dist/findings-import.d.ts.map +1 -1
  137. package/dist/findings-import.js +23 -3
  138. package/dist/findings-import.js.map +1 -1
  139. package/dist/github-advisories.d.ts +386 -0
  140. package/dist/github-advisories.d.ts.map +1 -0
  141. package/dist/github-advisories.js +131 -0
  142. package/dist/github-advisories.js.map +1 -0
  143. package/dist/github-findings.d.ts +10 -0
  144. package/dist/github-findings.d.ts.map +1 -0
  145. package/dist/github-findings.js +256 -0
  146. package/dist/github-findings.js.map +1 -0
  147. package/dist/host-protocol.d.ts +1 -0
  148. package/dist/host-protocol.d.ts.map +1 -1
  149. package/dist/host-protocol.js +1 -1
  150. package/dist/host-protocol.js.map +1 -1
  151. package/dist/hosted-remediation-protocol.d.ts +6 -0
  152. package/dist/hosted-remediation-protocol.d.ts.map +1 -0
  153. package/dist/hosted-remediation-protocol.js +32 -0
  154. package/dist/hosted-remediation-protocol.js.map +1 -0
  155. package/dist/hosted-remediation.d.ts +93 -0
  156. package/dist/hosted-remediation.d.ts.map +1 -0
  157. package/dist/hosted-remediation.js +124 -0
  158. package/dist/hosted-remediation.js.map +1 -0
  159. package/dist/hosted-scan.d.ts +16 -0
  160. package/dist/hosted-scan.d.ts.map +1 -1
  161. package/dist/hosted-scan.js +14 -2
  162. package/dist/hosted-scan.js.map +1 -1
  163. package/dist/import-scan.d.ts +1 -0
  164. package/dist/import-scan.d.ts.map +1 -1
  165. package/dist/import-scan.js +5 -1
  166. package/dist/import-scan.js.map +1 -1
  167. package/dist/index.d.ts +18 -1
  168. package/dist/index.d.ts.map +1 -1
  169. package/dist/index.js +10 -0
  170. package/dist/index.js.map +1 -1
  171. package/dist/multiscan.d.ts.map +1 -1
  172. package/dist/multiscan.js +3 -1
  173. package/dist/multiscan.js.map +1 -1
  174. package/dist/project-config-schema.d.ts +2 -0
  175. package/dist/project-config-schema.d.ts.map +1 -1
  176. package/dist/project-config-schema.js +1 -0
  177. package/dist/project-config-schema.js.map +1 -1
  178. package/dist/project-config.d.ts +1 -0
  179. package/dist/project-config.d.ts.map +1 -1
  180. package/dist/project-config.js +15 -9
  181. package/dist/project-config.js.map +1 -1
  182. package/dist/publish.d.ts +2 -0
  183. package/dist/publish.d.ts.map +1 -1
  184. package/dist/publish.js +9 -0
  185. package/dist/publish.js.map +1 -1
  186. package/dist/remediation.d.ts +69 -0
  187. package/dist/remediation.d.ts.map +1 -0
  188. package/dist/remediation.js +121 -0
  189. package/dist/remediation.js.map +1 -0
  190. package/dist/request-metadata.d.ts +17 -7
  191. package/dist/request-metadata.d.ts.map +1 -1
  192. package/dist/request-metadata.js +43 -8
  193. package/dist/request-metadata.js.map +1 -1
  194. package/dist/result.d.ts +4 -0
  195. package/dist/result.d.ts.map +1 -1
  196. package/dist/result.js +10 -0
  197. package/dist/result.js.map +1 -1
  198. package/dist/runtime.d.ts +1 -0
  199. package/dist/runtime.d.ts.map +1 -1
  200. package/dist/runtime.js +24 -15
  201. package/dist/runtime.js.map +1 -1
  202. package/dist/saved-scan-bootstrap.d.ts +1 -0
  203. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  204. package/dist/saved-scan-bootstrap.js +16 -4
  205. package/dist/saved-scan-bootstrap.js.map +1 -1
  206. package/dist/scan-activity.js +8 -8
  207. package/dist/scan-activity.js.map +1 -1
  208. package/dist/scan-comparison.d.ts.map +1 -1
  209. package/dist/scan-comparison.js +15 -9
  210. package/dist/scan-comparison.js.map +1 -1
  211. package/dist/scan-dashboard.d.ts.map +1 -1
  212. package/dist/scan-dashboard.js +12 -6
  213. package/dist/scan-dashboard.js.map +1 -1
  214. package/dist/scan-executor.d.ts +5 -1
  215. package/dist/scan-executor.d.ts.map +1 -1
  216. package/dist/scan-executor.js +9 -8
  217. package/dist/scan-executor.js.map +1 -1
  218. package/dist/scan-owner-suggestions.d.ts +8 -0
  219. package/dist/scan-owner-suggestions.d.ts.map +1 -0
  220. package/dist/scan-owner-suggestions.js +33 -0
  221. package/dist/scan-owner-suggestions.js.map +1 -0
  222. package/dist/{deep-progress.d.ts → scan-progress.d.ts} +15 -7
  223. package/dist/scan-progress.d.ts.map +1 -0
  224. package/dist/scan-progress.js +138 -0
  225. package/dist/scan-progress.js.map +1 -0
  226. package/dist/scan-settings.d.ts +1 -0
  227. package/dist/scan-settings.d.ts.map +1 -1
  228. package/dist/scan-settings.js +4 -0
  229. package/dist/scan-settings.js.map +1 -1
  230. package/dist/scanner-import.d.ts +20 -0
  231. package/dist/scanner-import.d.ts.map +1 -0
  232. package/dist/scanner-import.js +204 -0
  233. package/dist/scanner-import.js.map +1 -0
  234. package/dist/security-policy-diff.d.ts +2 -0
  235. package/dist/security-policy-diff.d.ts.map +1 -0
  236. package/dist/security-policy-diff.js +197 -0
  237. package/dist/security-policy-diff.js.map +1 -0
  238. package/dist/security-policy.d.ts +7 -3
  239. package/dist/security-policy.d.ts.map +1 -1
  240. package/dist/security-policy.js +11 -57
  241. package/dist/security-policy.js.map +1 -1
  242. package/dist/semgrep-findings.d.ts +9 -0
  243. package/dist/semgrep-findings.d.ts.map +1 -0
  244. package/dist/semgrep-findings.js +293 -0
  245. package/dist/semgrep-findings.js.map +1 -0
  246. package/dist/server/embeddings.d.ts.map +1 -1
  247. package/dist/server/embeddings.js +4 -0
  248. package/dist/server/embeddings.js.map +1 -1
  249. package/dist/server/sqlite-store.d.ts.map +1 -1
  250. package/dist/server/sqlite-store.js +14 -2
  251. package/dist/server/sqlite-store.js.map +1 -1
  252. package/dist/severity-review.d.ts +3 -0
  253. package/dist/severity-review.d.ts.map +1 -1
  254. package/dist/severity-review.js +19 -0
  255. package/dist/severity-review.js.map +1 -1
  256. package/dist/severity-store.js +11 -3
  257. package/dist/severity-store.js.map +1 -1
  258. package/dist/snyk-findings.d.ts +9 -0
  259. package/dist/snyk-findings.d.ts.map +1 -0
  260. package/dist/snyk-findings.js +349 -0
  261. package/dist/snyk-findings.js.map +1 -0
  262. package/dist/targets.d.ts +2 -2
  263. package/dist/targets.d.ts.map +1 -1
  264. package/dist/targets.js +12 -2
  265. package/dist/targets.js.map +1 -1
  266. package/dist/timestamps.d.ts +3 -0
  267. package/dist/timestamps.d.ts.map +1 -0
  268. package/dist/timestamps.js +14 -0
  269. package/dist/timestamps.js.map +1 -0
  270. package/dist/version.d.ts +1 -1
  271. package/dist/version.d.ts.map +1 -1
  272. package/dist/version.js +13 -2
  273. package/dist/version.js.map +1 -1
  274. package/dist/wiz-csv.d.ts +8 -0
  275. package/dist/wiz-csv.d.ts.map +1 -0
  276. package/dist/wiz-csv.js +116 -0
  277. package/dist/wiz-csv.js.map +1 -0
  278. package/dist/wiz-findings.d.ts +4 -0
  279. package/dist/wiz-findings.d.ts.map +1 -0
  280. package/dist/wiz-findings.js +460 -0
  281. package/dist/wiz-findings.js.map +1 -0
  282. package/dist/workbench-arguments.d.ts.map +1 -1
  283. package/dist/workbench-arguments.js +9 -3
  284. package/dist/workbench-arguments.js.map +1 -1
  285. package/dist/worker-progress.d.ts +11 -1
  286. package/dist/worker-progress.d.ts.map +1 -1
  287. package/dist/worker-progress.js +11 -1
  288. package/dist/worker-progress.js.map +1 -1
  289. package/docs/classify-severity-records.md +28 -10
  290. package/docs/cli.md +788 -46
  291. package/docs/findings-service.md +7 -2
  292. package/docs/hosted-remediation.md +134 -0
  293. package/docs/hosted-scans.md +20 -3
  294. package/package.json +9 -6
  295. package/schemas/external-findings.schema.json +1421 -0
  296. package/schemas/project-config.schema.json +4 -0
  297. package/dist/deep-progress.d.ts.map +0 -1
  298. package/dist/deep-progress.js +0 -92
  299. package/dist/deep-progress.js.map +0 -1
@@ -0,0 +1,10 @@
1
+ import type { ExternalFindings } from "./external-findings.js";
2
+ import type { ImportedGitHubCodeScanningAlert } from "./github.js";
3
+ import type { ImportedGitHubAdvisory } from "./github-advisories.js";
4
+ /** Map selected code-scanning instances while retaining complete upstream evidence. */
5
+ export declare function normalizeGitHubCodeScanningAlerts(alerts: readonly ImportedGitHubCodeScanningAlert[]): ExternalFindings;
6
+ /** Map advisory disclosures without asserting an installed vulnerable dependency. */
7
+ export declare function normalizeGitHubAdvisories(advisories: readonly ImportedGitHubAdvisory[]): ExternalFindings;
8
+ /** Read unfiltered JSON/JSONL output saved by the read-only GitHub import commands. */
9
+ export declare function readGitHubFindings(path: string): Promise<ExternalFindings>;
10
+ //# sourceMappingURL=github-findings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github-findings.d.ts","sourceRoot":"","sources":["../src/github-findings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAwRrE,uFAAuF;AACvF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,+BAA+B,EAAE,GACjD,gBAAgB,CAElB;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,sBAAsB,EAAE,GAC5C,gBAAgB,CAElB;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}
@@ -0,0 +1,256 @@
1
+ import { hash } from "node:crypto";
2
+ import { CodexSecurityError, errorMessage } from "./errors.js";
3
+ import { validateExternalEvidence } from "./external-import-contract.js";
4
+ import { parseJsonOrJsonl, readScannerText, text } from "./scanner-import.js";
5
+ function object(value) {
6
+ return value !== null && typeof value === "object" && !Array.isArray(value)
7
+ ? value
8
+ : undefined;
9
+ }
10
+ function repositoryName(value) {
11
+ const repository = text(value);
12
+ const parts = /^([a-z0-9_.-]+)\/([a-z0-9_.-]+)$/iu.exec(repository ?? "");
13
+ if (!parts || parts.slice(1).some((part) => /^\.{1,2}$/u.test(part)))
14
+ throw new Error("GitHub repository must be OWNER/REPO.");
15
+ return repository;
16
+ }
17
+ function sourceUrl(value) {
18
+ const parsed = new URL(value);
19
+ const origin = /^(https?:\/\/([^/?#]+))/iu.exec(value);
20
+ if (!origin)
21
+ throw new Error("GitHub evidence URL must be an HTTP(S) link.");
22
+ // URL.origin/host remove explicit default ports; Cloud keeps those distinct.
23
+ return { parsed, host: origin[2].toLowerCase(), origin: origin[1] };
24
+ }
25
+ function sourceTimestamp(value) {
26
+ if (value === undefined || value === null)
27
+ return null;
28
+ const seconds = typeof value === "string" ? Date.parse(value) / 1000 : NaN;
29
+ if (!Number.isFinite(seconds) || seconds < 0)
30
+ throw new Error("GitHub updated_at is not a valid timestamp.");
31
+ return Math.floor(seconds);
32
+ }
33
+ function severity(value) {
34
+ // SARIF error/warning/note are not vulnerability severity ratings.
35
+ return typeof value === "string" &&
36
+ ["critical", "high", "medium", "low", "informational"].includes(value)
37
+ ? value
38
+ : "unknown";
39
+ }
40
+ function codeScanningFinding(record) {
41
+ const repository = repositoryName(record["repository"]);
42
+ const alert = object(record["alert"]);
43
+ const number = record["number"];
44
+ if (!alert ||
45
+ typeof number !== "number" ||
46
+ !Number.isSafeInteger(number) ||
47
+ number < 1 ||
48
+ alert["number"] !== number)
49
+ throw new Error("Expected a GitHub code-scanning import with matching alert numbers.");
50
+ const url = text(record["url"]);
51
+ if (!url || url !== alert["html_url"])
52
+ throw new Error("GitHub alert URL must match the original alert.");
53
+ const { parsed: parsedUrl, host, origin } = sourceUrl(url);
54
+ if (!["security/code-scanning", "code-scanning"].some((route) => parsedUrl.pathname.toLowerCase() ===
55
+ `/${repository}/${route}/${number}`.toLowerCase()))
56
+ throw new Error("GitHub alert URL does not match the selected repository and alert.");
57
+ const rule = object(alert["rule"]);
58
+ const instance = object(alert["most_recent_instance"]);
59
+ const ref = text(instance?.["ref"]);
60
+ if (!ref)
61
+ throw new Error("GitHub code-scanning evidence requires the selected instance ref.");
62
+ const location = object(instance?.["location"]);
63
+ const tool = object(alert["tool"]);
64
+ const message = text(object(instance?.["message"])?.["text"]);
65
+ const description = text(rule?.["full_description"]) ?? text(rule?.["description"]);
66
+ const tags = Array.isArray(rule?.["tags"]) ? rule["tags"] : [];
67
+ const weaknessIds = [
68
+ ...new Set(tags.flatMap((tag) => {
69
+ const match = typeof tag === "string"
70
+ ? /^external\/cwe\/cwe-(\d+)$/iu.exec(tag)
71
+ : null;
72
+ return match ? [`CWE-${Number(match[1])}`] : [];
73
+ })),
74
+ ];
75
+ const path = text(location?.["path"]);
76
+ const sourceId = `${host}/${repository.toLowerCase()}/code-scanning/${number}/${hash("sha256", ref)}`;
77
+ return {
78
+ source_finding_id: sourceId,
79
+ evidence: validateExternalEvidence({
80
+ title: text(rule?.["name"]) ??
81
+ text(rule?.["description"]) ??
82
+ `GitHub code-scanning alert #${number}`,
83
+ severity: severity(rule?.["security_severity_level"]),
84
+ description: [...new Set([message, description].filter(Boolean))].join("\n\n") ||
85
+ null,
86
+ url,
87
+ locations: path ? [{ path, line: location?.["start_line"] ?? null }] : [],
88
+ branch: ref,
89
+ code_revision: text(instance?.["commit_sha"]),
90
+ source_updated_at: sourceTimestamp(alert["updated_at"]),
91
+ source_data: record,
92
+ details: {
93
+ kind: "sast",
94
+ repository: {
95
+ url: `${origin}/${repository}`,
96
+ name: repository,
97
+ },
98
+ // Dismissal covers every branch; detection state belongs to the selected ref.
99
+ source_status: alert["state"] === "dismissed"
100
+ ? "dismissed"
101
+ : (text(instance?.["state"]) ?? text(alert["state"])),
102
+ scanner_origin: text(tool?.["name"]),
103
+ rule: { id: text(rule?.["id"]), name: text(rule?.["name"]) },
104
+ weakness_ids: weaknessIds,
105
+ remediation_instructions: text(rule?.["help"]),
106
+ code: path ? { end_line: location?.["end_line"] ?? null } : null,
107
+ },
108
+ }),
109
+ };
110
+ }
111
+ function advisoryFinding(record) {
112
+ const repository = repositoryName(record["repository"]);
113
+ const advisory = object(record["advisory"]);
114
+ const id = text(record["ghsaId"]);
115
+ const selection = record["selection"];
116
+ if (!advisory ||
117
+ !id ||
118
+ !/^GHSA-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/iu.test(id) ||
119
+ text(advisory["ghsa_id"])?.toUpperCase() !== id.toUpperCase())
120
+ throw new Error("Expected a GitHub advisory import with matching GHSA IDs.");
121
+ if (selection !== "repository" && selection !== "global")
122
+ throw new Error("GitHub advisory selection must be repository or global.");
123
+ const url = text(record["url"]);
124
+ if (!url || url !== advisory["html_url"])
125
+ throw new Error("GitHub advisory URL must match the original advisory.");
126
+ const { parsed: parsedUrl, host: linkHost, origin } = sourceUrl(url);
127
+ const host = text(record["githubHost"])?.toLowerCase();
128
+ // Enterprise APIs may return the public advisory database's canonical link.
129
+ const canonicalGlobalLink = selection === "global" && parsedUrl.host === "github.com";
130
+ const expectedPath = selection === "repository"
131
+ ? `/${repository}/security/advisories/${id}`
132
+ : `/advisories/${id}`;
133
+ if (!host ||
134
+ (linkHost !== host && !canonicalGlobalLink) ||
135
+ parsedUrl.pathname.toLowerCase() !== expectedPath.toLowerCase())
136
+ throw new Error("GitHub advisory URL does not match the selected source and GHSA ID.");
137
+ const vulnerabilities = advisory["vulnerabilities"] === null ? [] : advisory["vulnerabilities"];
138
+ if (!Array.isArray(vulnerabilities))
139
+ throw new Error("GitHub advisory vulnerabilities must be an array.");
140
+ const identifiers = Array.isArray(advisory["identifiers"])
141
+ ? advisory["identifiers"]
142
+ : [];
143
+ const advisoryIds = [
144
+ id,
145
+ text(advisory["cve_id"]),
146
+ ...identifiers.map((identifier) => text(object(identifier)?.["value"])),
147
+ ].filter((value) => value !== null);
148
+ const packages = vulnerabilities.flatMap((value) => {
149
+ const vulnerability = object(value);
150
+ const pkg = object(vulnerability?.["package"]);
151
+ const name = text(pkg?.["name"]);
152
+ // GitHub permits incomplete package metadata in advisory disclosures.
153
+ // Preserve it in source_data without inventing a typed package identity.
154
+ if (!name)
155
+ return [];
156
+ const fixedVersion = text(vulnerability?.["first_patched_version"]) ??
157
+ text(vulnerability?.["patched_versions"]);
158
+ return [
159
+ {
160
+ name,
161
+ ecosystem: text(pkg?.["ecosystem"]),
162
+ vulnerable_version_range: text(vulnerability?.["vulnerable_version_range"]),
163
+ fixed_versions: fixedVersion ? [fixedVersion] : [],
164
+ },
165
+ ];
166
+ });
167
+ const cwes = Array.isArray(advisory["cwes"]) ? advisory["cwes"] : [];
168
+ return {
169
+ source_finding_id: `${host}/${selection === "repository" ? repository.toLowerCase() : "global"}/security-advisory/${id.toUpperCase()}`,
170
+ evidence: validateExternalEvidence({
171
+ title: text(advisory["summary"]) ?? id,
172
+ severity: severity(advisory["severity"]),
173
+ description: text(advisory["description"]),
174
+ url,
175
+ advisory_ids: [...new Set(advisoryIds)],
176
+ packages,
177
+ source_updated_at: sourceTimestamp(advisory["updated_at"]),
178
+ source_data: record,
179
+ details: {
180
+ kind: "advisory",
181
+ advisory: { source: selection },
182
+ ...(selection === "repository"
183
+ ? {
184
+ repository: {
185
+ url: `${origin}/${repository}`,
186
+ name: repository,
187
+ },
188
+ }
189
+ : {}),
190
+ source_status: text(advisory["withdrawn_at"])
191
+ ? "withdrawn"
192
+ : (text(advisory["state"]) ??
193
+ (selection === "global" ? "published" : null)),
194
+ scanner_origin: "GitHub Security Advisories",
195
+ weakness_ids: cwes
196
+ .map((value) => text(object(value)?.["cwe_id"]))
197
+ .filter((value) => value !== null),
198
+ },
199
+ }),
200
+ };
201
+ }
202
+ function normalizeRecords(records) {
203
+ const result = {
204
+ read: records.length,
205
+ findings: [],
206
+ excluded: [],
207
+ };
208
+ const identities = new Set();
209
+ for (const [index, value] of records.entries()) {
210
+ const record = object(value);
211
+ try {
212
+ if (!record)
213
+ throw new Error("GitHub finding must be an object.");
214
+ let finding;
215
+ if (record["source"] === "github-code-scanning")
216
+ finding = codeScanningFinding(record);
217
+ else if (record["source"] === "github-security-advisory")
218
+ finding = advisoryFinding(record);
219
+ else
220
+ throw new Error("Expected saved output from import github or import github-advisories; raw or incomplete API responses need an explicit mapping.");
221
+ if (identities.has(finding.source_finding_id))
222
+ throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(finding.source_finding_id)}. Select each GitHub occurrence once.`);
223
+ identities.add(finding.source_finding_id);
224
+ result.findings.push(finding);
225
+ }
226
+ catch (error) {
227
+ if (error instanceof CodexSecurityError)
228
+ throw error;
229
+ result.excluded.push({
230
+ position: index + 1,
231
+ source_finding_id: text(record?.["url"]),
232
+ reason: errorMessage(error),
233
+ });
234
+ }
235
+ }
236
+ return result;
237
+ }
238
+ /** Map selected code-scanning instances while retaining complete upstream evidence. */
239
+ export function normalizeGitHubCodeScanningAlerts(alerts) {
240
+ return normalizeRecords(alerts);
241
+ }
242
+ /** Map advisory disclosures without asserting an installed vulnerable dependency. */
243
+ export function normalizeGitHubAdvisories(advisories) {
244
+ return normalizeRecords(advisories);
245
+ }
246
+ /** Read unfiltered JSON/JSONL output saved by the read-only GitHub import commands. */
247
+ export async function readGitHubFindings(path) {
248
+ try {
249
+ const payload = parseJsonOrJsonl(await readScannerText(path));
250
+ return normalizeRecords(Array.isArray(payload) ? payload : [payload]);
251
+ }
252
+ catch (cause) {
253
+ throw new CodexSecurityError(`Could not read GitHub findings as UTF-8 JSON or JSONL: ${errorMessage(cause)}`, { cause });
254
+ }
255
+ }
256
+ //# sourceMappingURL=github-findings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github-findings.js","sourceRoot":"","sources":["../src/github-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { validateExternalEvidence } from \"./external-import-contract.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport type { ImportedGitHubCodeScanningAlert } from \"./github.js\";\nimport type { ImportedGitHubAdvisory } from \"./github-advisories.js\";\nimport { parseJsonOrJsonl, readScannerText, text } from \"./scanner-import.js\";\n\nfunction object(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction repositoryName(value: unknown): string {\n const repository = text(value);\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository ?? \"\");\n if (!parts || parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part)))\n throw new Error(\"GitHub repository must be OWNER/REPO.\");\n return repository!;\n}\n\nfunction sourceUrl(value: string): {\n parsed: URL;\n host: string;\n origin: string;\n} {\n const parsed = new URL(value);\n const origin = /^(https?:\\/\\/([^/?#]+))/iu.exec(value);\n if (!origin) throw new Error(\"GitHub evidence URL must be an HTTP(S) link.\");\n // URL.origin/host remove explicit default ports; Cloud keeps those distinct.\n return { parsed, host: origin[2]!.toLowerCase(), origin: origin[1]! };\n}\n\nfunction sourceTimestamp(value: unknown): number | null {\n if (value === undefined || value === null) return null;\n const seconds = typeof value === \"string\" ? Date.parse(value) / 1000 : NaN;\n if (!Number.isFinite(seconds) || seconds < 0)\n throw new Error(\"GitHub updated_at is not a valid timestamp.\");\n return Math.floor(seconds);\n}\n\nfunction severity(value: unknown): string {\n // SARIF error/warning/note are not vulnerability severity ratings.\n return typeof value === \"string\" &&\n [\"critical\", \"high\", \"medium\", \"low\", \"informational\"].includes(value)\n ? value\n : \"unknown\";\n}\n\nfunction codeScanningFinding(record: Record<string, unknown>): ExternalFinding {\n const repository = repositoryName(record[\"repository\"]);\n const alert = object(record[\"alert\"]);\n const number = record[\"number\"];\n if (\n !alert ||\n typeof number !== \"number\" ||\n !Number.isSafeInteger(number) ||\n number < 1 ||\n alert[\"number\"] !== number\n )\n throw new Error(\n \"Expected a GitHub code-scanning import with matching alert numbers.\",\n );\n const url = text(record[\"url\"]);\n if (!url || url !== alert[\"html_url\"])\n throw new Error(\"GitHub alert URL must match the original alert.\");\n const { parsed: parsedUrl, host, origin } = sourceUrl(url);\n if (\n ![\"security/code-scanning\", \"code-scanning\"].some(\n (route) =>\n parsedUrl.pathname.toLowerCase() ===\n `/${repository}/${route}/${number}`.toLowerCase(),\n )\n )\n throw new Error(\n \"GitHub alert URL does not match the selected repository and alert.\",\n );\n const rule = object(alert[\"rule\"]);\n const instance = object(alert[\"most_recent_instance\"]);\n const ref = text(instance?.[\"ref\"]);\n if (!ref)\n throw new Error(\n \"GitHub code-scanning evidence requires the selected instance ref.\",\n );\n const location = object(instance?.[\"location\"]);\n const tool = object(alert[\"tool\"]);\n const message = text(object(instance?.[\"message\"])?.[\"text\"]);\n const description =\n text(rule?.[\"full_description\"]) ?? text(rule?.[\"description\"]);\n const tags = Array.isArray(rule?.[\"tags\"]) ? rule[\"tags\"] : [];\n const weaknessIds = [\n ...new Set(\n tags.flatMap((tag: unknown) => {\n const match =\n typeof tag === \"string\"\n ? /^external\\/cwe\\/cwe-(\\d+)$/iu.exec(tag)\n : null;\n return match ? [`CWE-${Number(match[1])}`] : [];\n }),\n ),\n ];\n const path = text(location?.[\"path\"]);\n const sourceId = `${host}/${repository.toLowerCase()}/code-scanning/${number}/${hash(\"sha256\", ref)}`;\n return {\n source_finding_id: sourceId,\n evidence: validateExternalEvidence({\n title:\n text(rule?.[\"name\"]) ??\n text(rule?.[\"description\"]) ??\n `GitHub code-scanning alert #${number}`,\n severity: severity(rule?.[\"security_severity_level\"]),\n description:\n [...new Set([message, description].filter(Boolean))].join(\"\\n\\n\") ||\n null,\n url,\n locations: path ? [{ path, line: location?.[\"start_line\"] ?? null }] : [],\n branch: ref,\n code_revision: text(instance?.[\"commit_sha\"]),\n source_updated_at: sourceTimestamp(alert[\"updated_at\"]),\n source_data: record,\n details: {\n kind: \"sast\",\n repository: {\n url: `${origin}/${repository}`,\n name: repository,\n },\n // Dismissal covers every branch; detection state belongs to the selected ref.\n source_status:\n alert[\"state\"] === \"dismissed\"\n ? \"dismissed\"\n : (text(instance?.[\"state\"]) ?? text(alert[\"state\"])),\n scanner_origin: text(tool?.[\"name\"]),\n rule: { id: text(rule?.[\"id\"]), name: text(rule?.[\"name\"]) },\n weakness_ids: weaknessIds,\n remediation_instructions: text(rule?.[\"help\"]),\n code: path ? { end_line: location?.[\"end_line\"] ?? null } : null,\n },\n }),\n };\n}\n\nfunction advisoryFinding(record: Record<string, unknown>): ExternalFinding {\n const repository = repositoryName(record[\"repository\"]);\n const advisory = object(record[\"advisory\"]);\n const id = text(record[\"ghsaId\"]);\n const selection = record[\"selection\"];\n if (\n !advisory ||\n !id ||\n !/^GHSA-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/iu.test(id) ||\n text(advisory[\"ghsa_id\"])?.toUpperCase() !== id.toUpperCase()\n )\n throw new Error(\n \"Expected a GitHub advisory import with matching GHSA IDs.\",\n );\n if (selection !== \"repository\" && selection !== \"global\")\n throw new Error(\"GitHub advisory selection must be repository or global.\");\n const url = text(record[\"url\"]);\n if (!url || url !== advisory[\"html_url\"])\n throw new Error(\"GitHub advisory URL must match the original advisory.\");\n const { parsed: parsedUrl, host: linkHost, origin } = sourceUrl(url);\n const host = text(record[\"githubHost\"])?.toLowerCase();\n // Enterprise APIs may return the public advisory database's canonical link.\n const canonicalGlobalLink =\n selection === \"global\" && parsedUrl.host === \"github.com\";\n const expectedPath =\n selection === \"repository\"\n ? `/${repository}/security/advisories/${id}`\n : `/advisories/${id}`;\n if (\n !host ||\n (linkHost !== host && !canonicalGlobalLink) ||\n parsedUrl.pathname.toLowerCase() !== expectedPath.toLowerCase()\n )\n throw new Error(\n \"GitHub advisory URL does not match the selected source and GHSA ID.\",\n );\n const vulnerabilities =\n advisory[\"vulnerabilities\"] === null ? [] : advisory[\"vulnerabilities\"];\n if (!Array.isArray(vulnerabilities))\n throw new Error(\"GitHub advisory vulnerabilities must be an array.\");\n const identifiers = Array.isArray(advisory[\"identifiers\"])\n ? advisory[\"identifiers\"]\n : [];\n const advisoryIds = [\n id,\n text(advisory[\"cve_id\"]),\n ...identifiers.map((identifier) => text(object(identifier)?.[\"value\"])),\n ].filter((value): value is string => value !== null);\n const packages = vulnerabilities.flatMap((value) => {\n const vulnerability = object(value);\n const pkg = object(vulnerability?.[\"package\"]);\n const name = text(pkg?.[\"name\"]);\n // GitHub permits incomplete package metadata in advisory disclosures.\n // Preserve it in source_data without inventing a typed package identity.\n if (!name) return [];\n const fixedVersion =\n text(vulnerability?.[\"first_patched_version\"]) ??\n text(vulnerability?.[\"patched_versions\"]);\n return [\n {\n name,\n ecosystem: text(pkg?.[\"ecosystem\"]),\n vulnerable_version_range: text(\n vulnerability?.[\"vulnerable_version_range\"],\n ),\n fixed_versions: fixedVersion ? [fixedVersion] : [],\n },\n ];\n });\n const cwes = Array.isArray(advisory[\"cwes\"]) ? advisory[\"cwes\"] : [];\n return {\n source_finding_id: `${host}/${selection === \"repository\" ? repository.toLowerCase() : \"global\"}/security-advisory/${id.toUpperCase()}`,\n evidence: validateExternalEvidence({\n title: text(advisory[\"summary\"]) ?? id,\n severity: severity(advisory[\"severity\"]),\n description: text(advisory[\"description\"]),\n url,\n advisory_ids: [...new Set(advisoryIds)],\n packages,\n source_updated_at: sourceTimestamp(advisory[\"updated_at\"]),\n source_data: record,\n details: {\n kind: \"advisory\",\n advisory: { source: selection },\n ...(selection === \"repository\"\n ? {\n repository: {\n url: `${origin}/${repository}`,\n name: repository,\n },\n }\n : {}),\n source_status: text(advisory[\"withdrawn_at\"])\n ? \"withdrawn\"\n : (text(advisory[\"state\"]) ??\n (selection === \"global\" ? \"published\" : null)),\n scanner_origin: \"GitHub Security Advisories\",\n weakness_ids: cwes\n .map((value) => text(object(value)?.[\"cwe_id\"]))\n .filter((value): value is string => value !== null),\n },\n }),\n };\n}\n\nfunction normalizeRecords(records: readonly unknown[]): ExternalFindings {\n const result: ExternalFindings = {\n read: records.length,\n findings: [],\n excluded: [],\n };\n const identities = new Set<string>();\n for (const [index, value] of records.entries()) {\n const record = object(value);\n try {\n if (!record) throw new Error(\"GitHub finding must be an object.\");\n let finding: ExternalFinding;\n if (record[\"source\"] === \"github-code-scanning\")\n finding = codeScanningFinding(record);\n else if (record[\"source\"] === \"github-security-advisory\")\n finding = advisoryFinding(record);\n else\n throw new Error(\n \"Expected saved output from import github or import github-advisories; raw or incomplete API responses need an explicit mapping.\",\n );\n if (identities.has(finding.source_finding_id))\n throw new CodexSecurityError(\n `Duplicate source finding id ${JSON.stringify(finding.source_finding_id)}. Select each GitHub occurrence once.`,\n );\n identities.add(finding.source_finding_id);\n result.findings.push(finding);\n } catch (error) {\n if (error instanceof CodexSecurityError) throw error;\n result.excluded.push({\n position: index + 1,\n source_finding_id: text(record?.[\"url\"]),\n reason: errorMessage(error),\n });\n }\n }\n return result;\n}\n\n/** Map selected code-scanning instances while retaining complete upstream evidence. */\nexport function normalizeGitHubCodeScanningAlerts(\n alerts: readonly ImportedGitHubCodeScanningAlert[],\n): ExternalFindings {\n return normalizeRecords(alerts);\n}\n\n/** Map advisory disclosures without asserting an installed vulnerable dependency. */\nexport function normalizeGitHubAdvisories(\n advisories: readonly ImportedGitHubAdvisory[],\n): ExternalFindings {\n return normalizeRecords(advisories);\n}\n\n/** Read unfiltered JSON/JSONL output saved by the read-only GitHub import commands. */\nexport async function readGitHubFindings(\n path: string,\n): Promise<ExternalFindings> {\n try {\n const payload = parseJsonOrJsonl(await readScannerText(path));\n return normalizeRecords(Array.isArray(payload) ? payload : [payload]);\n } catch (cause) {\n throw new CodexSecurityError(\n `Could not read GitHub findings as UTF-8 JSON or JSONL: ${errorMessage(cause)}`,\n { cause },\n );\n }\n}\n"]}
@@ -8,6 +8,7 @@ type Execute = (id: string, request: unknown, onProgress?: (event: unknown) => v
8
8
  export declare function runHostProtocol(input: Readable, output: Output, operation: {
9
9
  label: string;
10
10
  requestMethod: string;
11
+ progressMethod?: string;
11
12
  /** Scan cancellation must retain the host's eventual receipt and usage. */
12
13
  awaitCancellationReceipt?: boolean;
13
14
  errorData?: (error: unknown) => object | undefined;
@@ -1 +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"}
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,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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"}
@@ -201,7 +201,7 @@ export async function runHostProtocol(input, output, operation, signal) {
201
201
  if (terminalCode === undefined)
202
202
  void send({
203
203
  jsonrpc: "2.0",
204
- method: "scan.progress",
204
+ method: operation.progressMethod ?? "scan.progress",
205
205
  params: { id: runId, event },
206
206
  }).catch(outputError);
207
207
  })
@@ -1 +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 \"zod\";\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"]}
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 \"zod\";\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 progressMethod?: 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: operation.progressMethod ?? \"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,6 @@
1
+ import type { Readable } from "node:stream";
2
+ import { runHostProtocol } from "./host-protocol.js";
3
+ import { type HostedRemediationInput } from "./hosted-remediation.js";
4
+ /** SDK launcher for prepared hosted checkouts; no local inference fallback. */
5
+ export declare function runHostedRemediationProtocol(input: Readable, output: Parameters<typeof runHostProtocol>[1], signal?: AbortSignal, operation?: HostedRemediationInput["operation"]): Promise<number>;
6
+ //# sourceMappingURL=hosted-remediation-protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-remediation-protocol.d.ts","sourceRoot":"","sources":["../src/hosted-remediation-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AAGjC,+EAA+E;AAC/E,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,EAC7C,MAAM,CAAC,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAoCjB"}
@@ -0,0 +1,32 @@
1
+ import { runHostProtocol } from "./host-protocol.js";
2
+ import { HostedRemediationPreparationError, runHostedRemediation, } from "./hosted-remediation.js";
3
+ import { isRecord } from "./record.js";
4
+ /** SDK launcher for prepared hosted checkouts; no local inference fallback. */
5
+ export async function runHostedRemediationProtocol(input, output, signal, operation) {
6
+ return await runHostProtocol(input, output, {
7
+ label: "Remediation",
8
+ requestMethod: "execution.run",
9
+ progressMethod: "remediation.progress",
10
+ awaitCancellationReceipt: true,
11
+ errorData: (error) => error instanceof HostedRemediationPreparationError
12
+ ? { reason: error.reason }
13
+ : undefined,
14
+ run: async (params, execute, signal, onEvent) => {
15
+ if (operation !== undefined &&
16
+ (!isRecord(params) || params["operation"] !== operation)) {
17
+ throw new Error(`Hosted ${operation} requires operation "${operation}".`);
18
+ }
19
+ return await runHostedRemediation(params, {
20
+ signal,
21
+ onEvent,
22
+ executor: {
23
+ run: async (request, options) => (await execute(request.requestId, request, (event) => {
24
+ if (isRecord(event))
25
+ options.onEvent?.(event);
26
+ })),
27
+ },
28
+ });
29
+ },
30
+ }, signal);
31
+ }
32
+ //# sourceMappingURL=hosted-remediation-protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-remediation-protocol.js","sourceRoot":"","sources":["../src/hosted-remediation-protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,iCAAiC,EACjC,oBAAoB,GAGrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAAe,EACf,MAA6C,EAC7C,MAAoB,EACpB,SAA+C;IAE/C,OAAO,MAAM,eAAe,CAC1B,KAAK,EACL,MAAM,EACN;QACE,KAAK,EAAE,aAAa;QACpB,aAAa,EAAE,eAAe;QAC9B,cAAc,EAAE,sBAAsB;QACtC,wBAAwB,EAAE,IAAI;QAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnB,KAAK,YAAY,iCAAiC;YAChD,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;YAC9C,IACE,SAAS,KAAK,SAAS;gBACvB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,EACxD,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,UAAU,SAAS,wBAAwB,SAAS,IAAI,CACzD,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,oBAAoB,CAAC,MAAgC,EAAE;gBAClE,MAAM;gBACN,OAAO;gBACP,QAAQ,EAAE;oBACR,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAC9B,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;wBACnD,IAAI,QAAQ,CAAC,KAAK,CAAC;4BAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;oBAChD,CAAC,CAAC,CAA+B;iBACpC;aACF,CAAC,CAAC;QACL,CAAC;KACF,EACD,MAAM,CACP,CAAC;AACJ,CAAC","sourcesContent":["import type { Readable } from \"node:stream\";\nimport { runHostProtocol } from \"./host-protocol.js\";\nimport {\n HostedRemediationPreparationError,\n runHostedRemediation,\n type HostedRemediationInput,\n type RemediationExecutionResult,\n} from \"./hosted-remediation.js\";\nimport { isRecord } from \"./record.js\";\n\n/** SDK launcher for prepared hosted checkouts; no local inference fallback. */\nexport async function runHostedRemediationProtocol(\n input: Readable,\n output: Parameters<typeof runHostProtocol>[1],\n signal?: AbortSignal,\n operation?: HostedRemediationInput[\"operation\"],\n): Promise<number> {\n return await runHostProtocol(\n input,\n output,\n {\n label: \"Remediation\",\n requestMethod: \"execution.run\",\n progressMethod: \"remediation.progress\",\n awaitCancellationReceipt: true,\n errorData: (error) =>\n error instanceof HostedRemediationPreparationError\n ? { reason: error.reason }\n : undefined,\n run: async (params, execute, signal, onEvent) => {\n if (\n operation !== undefined &&\n (!isRecord(params) || params[\"operation\"] !== operation)\n ) {\n throw new Error(\n `Hosted ${operation} requires operation \"${operation}\".`,\n );\n }\n return await runHostedRemediation(params as HostedRemediationInput, {\n signal,\n onEvent,\n executor: {\n run: async (request, options) =>\n (await execute(request.requestId, request, (event) => {\n if (isRecord(event)) options.onEvent?.(event);\n })) as RemediationExecutionResult,\n },\n });\n },\n },\n signal,\n );\n}\n"]}
@@ -0,0 +1,93 @@
1
+ import { z } from "zod";
2
+ import { type FindingPatch, type FindingVerification } from "./remediation.js";
3
+ import { type ScanExecutionResult } from "./scan-executor.js";
4
+ export declare const HostedRemediationInputSchema: z.ZodObject<{
5
+ version: z.ZodLiteral<1>;
6
+ operation: z.ZodEnum<{
7
+ patch: "patch";
8
+ verify: "verify";
9
+ }>;
10
+ repository: z.ZodString;
11
+ revision: z.ZodString;
12
+ finding: z.ZodObject<{
13
+ id: z.ZodString;
14
+ context: z.ZodString;
15
+ }, z.core.$strict>;
16
+ instructions: z.ZodOptional<z.ZodString>;
17
+ validationInstructions: z.ZodOptional<z.ZodString>;
18
+ verificationMode: z.ZodOptional<z.ZodEnum<{
19
+ standard: "standard";
20
+ static: "static";
21
+ }>>;
22
+ model: z.ZodString;
23
+ reasoningEffort: z.ZodString;
24
+ identity: z.ZodObject<{
25
+ runId: z.ZodString;
26
+ attemptId: z.ZodString;
27
+ buildId: z.ZodString;
28
+ }, z.core.$strict>;
29
+ }, z.core.$strict>;
30
+ export type HostedRemediationInput = z.infer<typeof HostedRemediationInputSchema>;
31
+ export interface RemediationExecutionRequest {
32
+ version: 1;
33
+ requestId: string;
34
+ operation: HostedRemediationInput["operation"];
35
+ repository: string;
36
+ revision: string;
37
+ identity: HostedRemediationInput["identity"];
38
+ findingId: string;
39
+ prompt: string;
40
+ model: string;
41
+ reasoningEffort: HostedRemediationInput["reasoningEffort"];
42
+ sandbox: "workspace-write" | "read-only";
43
+ runtime: {
44
+ pluginRoot: string;
45
+ pluginVersion: string;
46
+ };
47
+ }
48
+ export type RemediationExecutionResult = ScanExecutionResult;
49
+ export type RemediationExecutionEvent = Readonly<Record<string, unknown>>;
50
+ export interface RemediationExecutor {
51
+ /** Submit once and settle cancellation with the host's recorded receipt. */
52
+ run(request: RemediationExecutionRequest, options: {
53
+ signal: AbortSignal;
54
+ onEvent?: (event: RemediationExecutionEvent) => void;
55
+ }): Promise<RemediationExecutionResult>;
56
+ }
57
+ export interface HostedRemediationOptions {
58
+ executor: RemediationExecutor;
59
+ signal?: AbortSignal;
60
+ onEvent?: (event: RemediationExecutionEvent) => void;
61
+ }
62
+ export interface HostedRemediationResult {
63
+ version: 1;
64
+ operation: HostedRemediationInput["operation"];
65
+ repository: string;
66
+ revision: string;
67
+ identity: HostedRemediationInput["identity"];
68
+ findingId: string;
69
+ status: RemediationExecutionResult["status"];
70
+ provenance: {
71
+ cliVersion: string;
72
+ pluginVersion: string;
73
+ buildId: string;
74
+ };
75
+ execution?: RemediationExecutionResult;
76
+ patch?: FindingPatch;
77
+ verification?: FindingVerification;
78
+ error?: {
79
+ code: string;
80
+ message: string;
81
+ };
82
+ }
83
+ export declare class HostedRemediationPreparationError extends Error {
84
+ readonly reason = "revision_mismatch";
85
+ constructor();
86
+ }
87
+ /**
88
+ * Run one patch or verification through the supplied host executor.
89
+ * The host prepares the candidate checkout, enforces the requested sandbox,
90
+ * and owns patch artifacts, durable attempts, usage, and reconciliation.
91
+ */
92
+ export declare function runHostedRemediation(value: HostedRemediationInput, options: HostedRemediationOptions): Promise<HostedRemediationResult>;
93
+ //# sourceMappingURL=hosted-remediation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosted-remediation.d.ts","sourceRoot":"","sources":["../src/hosted-remediation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAC3D,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAAC;IACzC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAC7D,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,GAAG,CACD,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE;QACP,MAAM,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;KACtD,GACA,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC7C,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,MAAM,uBAAuB;IACtC,cAGC;CACF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA0FlC"}