@yiaany/ghostapi 0.1.6 → 0.1.8

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 (323) hide show
  1. package/CHANGELOG.md +48 -2
  2. package/CONTRIBUTING.md +119 -117
  3. package/LICENSE +21 -21
  4. package/README.md +208 -185
  5. package/SECURITY.md +53 -37
  6. package/dist/actions/gateway.d.ts +179 -0
  7. package/dist/actions/gateway.js +514 -0
  8. package/dist/actions/gateway.js.map +1 -0
  9. package/dist/actions/index.d.ts +2 -0
  10. package/dist/actions/index.js +2 -0
  11. package/dist/actions/index.js.map +1 -0
  12. package/dist/ai/aiClient.js +4 -4
  13. package/dist/ai/aiClient.js.map +1 -1
  14. package/dist/ai/aiGenerator.d.ts +2 -2
  15. package/dist/ai/aiGenerator.js +21 -72
  16. package/dist/ai/aiGenerator.js.map +1 -1
  17. package/dist/ai/prompts.js +51 -51
  18. package/dist/ai/prompts.js.map +1 -1
  19. package/dist/approvals/approvalInbox.d.ts +150 -0
  20. package/dist/approvals/approvalInbox.js +412 -0
  21. package/dist/approvals/approvalInbox.js.map +1 -0
  22. package/dist/approvals/index.d.ts +2 -0
  23. package/dist/approvals/index.js +2 -0
  24. package/dist/approvals/index.js.map +1 -0
  25. package/dist/behavior/behaviorStore.d.ts +2 -0
  26. package/dist/behavior/behaviorStore.js +50 -46
  27. package/dist/behavior/behaviorStore.js.map +1 -1
  28. package/dist/cache/index.d.ts +2 -0
  29. package/dist/cache/index.js +58 -14
  30. package/dist/cache/index.js.map +1 -1
  31. package/dist/cli/index.js +438 -58
  32. package/dist/cli/index.js.map +1 -1
  33. package/dist/cli/openUrl.d.ts +10 -0
  34. package/dist/cli/openUrl.js +31 -0
  35. package/dist/cli/openUrl.js.map +1 -0
  36. package/dist/cli/parser.d.ts +155 -0
  37. package/dist/cli/parser.js +504 -2
  38. package/dist/cli/parser.js.map +1 -1
  39. package/dist/config/dataPaths.d.ts +31 -0
  40. package/dist/config/dataPaths.js +45 -0
  41. package/dist/config/dataPaths.js.map +1 -0
  42. package/dist/config/localConfig.d.ts +1 -2
  43. package/dist/config/localConfig.js +27 -21
  44. package/dist/config/localConfig.js.map +1 -1
  45. package/dist/config/serverConfig.d.ts +2 -0
  46. package/dist/config/serverConfig.js +8 -1
  47. package/dist/config/serverConfig.js.map +1 -1
  48. package/dist/contracts/contract.d.ts +76 -0
  49. package/dist/contracts/contract.js +603 -0
  50. package/dist/contracts/contract.js.map +1 -0
  51. package/dist/contracts/index.d.ts +2 -0
  52. package/dist/contracts/index.js +2 -0
  53. package/dist/contracts/index.js.map +1 -0
  54. package/dist/credentials/credentialBroker.d.ts +207 -0
  55. package/dist/credentials/credentialBroker.js +588 -0
  56. package/dist/credentials/credentialBroker.js.map +1 -0
  57. package/dist/credentials/index.d.ts +2 -0
  58. package/dist/credentials/index.js +2 -0
  59. package/dist/credentials/index.js.map +1 -0
  60. package/dist/dashboard/app.js +685 -615
  61. package/dist/dashboard/index.html +13 -7
  62. package/dist/dashboard/styles.css +349 -349
  63. package/dist/egress/capabilities.d.ts +32 -0
  64. package/dist/egress/capabilities.js +165 -0
  65. package/dist/egress/capabilities.js.map +1 -0
  66. package/dist/egress/linuxBootstrap.d.ts +1 -0
  67. package/dist/egress/linuxBootstrap.js +121 -0
  68. package/dist/egress/linuxBootstrap.js.map +1 -0
  69. package/dist/egress/run.d.ts +18 -0
  70. package/dist/egress/run.js +305 -0
  71. package/dist/egress/run.js.map +1 -0
  72. package/dist/errors/errorEngine.d.ts +2 -2
  73. package/dist/errors/errorEngine.js +3 -40
  74. package/dist/errors/errorEngine.js.map +1 -1
  75. package/dist/evals/evals.d.ts +126 -0
  76. package/dist/evals/evals.js +466 -0
  77. package/dist/evals/evals.js.map +1 -0
  78. package/dist/evals/index.d.ts +2 -0
  79. package/dist/evals/index.js +2 -0
  80. package/dist/evals/index.js.map +1 -0
  81. package/dist/evidence/index.d.ts +2 -0
  82. package/dist/evidence/index.js +2 -0
  83. package/dist/evidence/index.js.map +1 -0
  84. package/dist/evidence/report.d.ts +143 -0
  85. package/dist/evidence/report.js +556 -0
  86. package/dist/evidence/report.js.map +1 -0
  87. package/dist/fault/faultLab.d.ts +5 -4
  88. package/dist/fault/faultLab.js +66 -24
  89. package/dist/fault/faultLab.js.map +1 -1
  90. package/dist/index.d.ts +46 -0
  91. package/dist/index.js +23 -0
  92. package/dist/index.js.map +1 -1
  93. package/dist/inventory/analysis.d.ts +12 -0
  94. package/dist/inventory/analysis.js +457 -0
  95. package/dist/inventory/analysis.js.map +1 -0
  96. package/dist/inventory/index.d.ts +5 -0
  97. package/dist/inventory/index.js +4 -0
  98. package/dist/inventory/index.js.map +1 -0
  99. package/dist/inventory/inventoryController.d.ts +53 -0
  100. package/dist/inventory/inventoryController.js +1044 -0
  101. package/dist/inventory/inventoryController.js.map +1 -0
  102. package/dist/inventory/types.d.ts +579 -0
  103. package/dist/inventory/types.js +787 -0
  104. package/dist/inventory/types.js.map +1 -0
  105. package/dist/landing/assets/index-CxWsopzP.css +1 -0
  106. package/dist/landing/assets/index-DZlpyhqd.js +55 -0
  107. package/dist/landing/assets/index-Dk-Xezs3.js +55 -0
  108. package/dist/landing/index.html +15 -15
  109. package/dist/ledger/actionLedger.d.ts +125 -0
  110. package/dist/ledger/actionLedger.js +594 -0
  111. package/dist/ledger/actionLedger.js.map +1 -0
  112. package/dist/ledger/index.d.ts +2 -0
  113. package/dist/ledger/index.js +2 -0
  114. package/dist/ledger/index.js.map +1 -0
  115. package/dist/mcp/server.js +4 -3
  116. package/dist/mcp/server.js.map +1 -1
  117. package/dist/policy/index.d.ts +3 -0
  118. package/dist/policy/index.js +2 -0
  119. package/dist/policy/index.js.map +1 -0
  120. package/dist/policy/policy.d.ts +14 -0
  121. package/dist/policy/policy.js +282 -0
  122. package/dist/policy/policy.js.map +1 -0
  123. package/dist/policy/types.d.ts +52 -0
  124. package/dist/policy/types.js +2 -0
  125. package/dist/policy/types.js.map +1 -0
  126. package/dist/productTelemetry/index.d.ts +16 -0
  127. package/dist/productTelemetry/index.js +142 -0
  128. package/dist/productTelemetry/index.js.map +1 -0
  129. package/dist/providers/conformance.d.ts +7 -0
  130. package/dist/providers/conformance.js +48 -0
  131. package/dist/providers/conformance.js.map +1 -0
  132. package/dist/providers/index.d.ts +4 -2
  133. package/dist/providers/index.js +3 -1
  134. package/dist/providers/index.js.map +1 -1
  135. package/dist/providers/packs/resendPack.d.ts +2 -0
  136. package/dist/providers/packs/resendPack.js +147 -0
  137. package/dist/providers/packs/resendPack.js.map +1 -0
  138. package/dist/providers/packs/stripePack.d.ts +2 -0
  139. package/dist/providers/packs/stripePack.js +852 -0
  140. package/dist/providers/packs/stripePack.js.map +1 -0
  141. package/dist/providers/registry.d.ts +7 -3
  142. package/dist/providers/registry.js +55 -4
  143. package/dist/providers/registry.js.map +1 -1
  144. package/dist/providers/resend.js +2 -11
  145. package/dist/providers/resend.js.map +1 -1
  146. package/dist/providers/runtime.d.ts +8 -0
  147. package/dist/providers/runtime.js +48 -0
  148. package/dist/providers/runtime.js.map +1 -0
  149. package/dist/providers/stripeWebhook.d.ts +13 -0
  150. package/dist/providers/stripeWebhook.js +50 -0
  151. package/dist/providers/stripeWebhook.js.map +1 -0
  152. package/dist/providers/types.d.ts +153 -0
  153. package/dist/proxy/cacheKey.js +3 -3
  154. package/dist/proxy/cacheKey.js.map +1 -1
  155. package/dist/proxy/providerDetector.d.ts +2 -7
  156. package/dist/proxy/providerDetector.js +4 -4
  157. package/dist/proxy/providerDetector.js.map +1 -1
  158. package/dist/proxy/proxyHandler.js +116 -12
  159. package/dist/proxy/proxyHandler.js.map +1 -1
  160. package/dist/proxy/requestNormalizer.d.ts +0 -1
  161. package/dist/proxy/requestNormalizer.js +2 -5
  162. package/dist/proxy/requestNormalizer.js.map +1 -1
  163. package/dist/reliability/costGovernance.d.ts +175 -0
  164. package/dist/reliability/costGovernance.js +515 -0
  165. package/dist/reliability/costGovernance.js.map +1 -0
  166. package/dist/reliability/index.d.ts +8 -0
  167. package/dist/reliability/index.js +5 -0
  168. package/dist/reliability/index.js.map +1 -0
  169. package/dist/reliability/reconciliation.d.ts +157 -0
  170. package/dist/reliability/reconciliation.js +522 -0
  171. package/dist/reliability/reconciliation.js.map +1 -0
  172. package/dist/reliability/runtimeHealth.d.ts +60 -0
  173. package/dist/reliability/runtimeHealth.js +356 -0
  174. package/dist/reliability/runtimeHealth.js.map +1 -0
  175. package/dist/reliability/slo.d.ts +131 -0
  176. package/dist/reliability/slo.js +375 -0
  177. package/dist/reliability/slo.js.map +1 -0
  178. package/dist/report/safetyReport.js +7 -3
  179. package/dist/report/safetyReport.js.map +1 -1
  180. package/dist/safety/index.d.ts +2 -0
  181. package/dist/safety/index.js +2 -0
  182. package/dist/safety/index.js.map +1 -0
  183. package/dist/safety/safetyController.d.ts +187 -0
  184. package/dist/safety/safetyController.js +477 -0
  185. package/dist/safety/safetyController.js.map +1 -0
  186. package/dist/scenarios/scenarioBundle.d.ts +75 -0
  187. package/dist/scenarios/scenarioBundle.js +750 -0
  188. package/dist/scenarios/scenarioBundle.js.map +1 -0
  189. package/dist/scenarios/scenarioStore.d.ts +1 -0
  190. package/dist/scenarios/scenarioStore.js +47 -32
  191. package/dist/scenarios/scenarioStore.js.map +1 -1
  192. package/dist/security/headerSanitizer.d.ts +2 -0
  193. package/dist/security/headerSanitizer.js +36 -1
  194. package/dist/security/headerSanitizer.js.map +1 -1
  195. package/dist/security/secrets.js +24 -4
  196. package/dist/security/secrets.js.map +1 -1
  197. package/dist/server/accessControl.d.ts +5 -0
  198. package/dist/server/accessControl.js +100 -0
  199. package/dist/server/accessControl.js.map +1 -0
  200. package/dist/server/createServer.d.ts +0 -5
  201. package/dist/server/createServer.js +9 -29
  202. package/dist/server/createServer.js.map +1 -1
  203. package/dist/server/eventsStore.d.ts +6 -1
  204. package/dist/server/eventsStore.js +83 -15
  205. package/dist/server/eventsStore.js.map +1 -1
  206. package/dist/server/routes.js +36 -10
  207. package/dist/server/routes.js.map +1 -1
  208. package/dist/server/sse.d.ts +2 -1
  209. package/dist/server/sse.js +15 -3
  210. package/dist/server/sse.js.map +1 -1
  211. package/dist/setup/setupGenerator.js +53 -6
  212. package/dist/setup/setupGenerator.js.map +1 -1
  213. package/dist/state/stateStore.d.ts +5 -0
  214. package/dist/state/stateStore.js +48 -62
  215. package/dist/state/stateStore.js.map +1 -1
  216. package/dist/storage/fileStore.d.ts +10 -0
  217. package/dist/storage/fileStore.js +131 -0
  218. package/dist/storage/fileStore.js.map +1 -0
  219. package/dist/teamControl/controlPlane.d.ts +255 -0
  220. package/dist/teamControl/controlPlane.js +918 -0
  221. package/dist/teamControl/controlPlane.js.map +1 -0
  222. package/dist/teamControl/deployment.d.ts +33 -0
  223. package/dist/teamControl/deployment.js +67 -0
  224. package/dist/teamControl/deployment.js.map +1 -0
  225. package/dist/teamControl/index.d.ts +4 -0
  226. package/dist/teamControl/index.js +3 -0
  227. package/dist/teamControl/index.js.map +1 -0
  228. package/dist/tests/testGenerator.js +4 -1
  229. package/dist/tests/testGenerator.js.map +1 -1
  230. package/dist/trust/index.d.ts +2 -0
  231. package/dist/trust/index.js +2 -0
  232. package/dist/trust/index.js.map +1 -0
  233. package/dist/trust/trustLadder.d.ts +182 -0
  234. package/dist/trust/trustLadder.js +560 -0
  235. package/dist/trust/trustLadder.js.map +1 -0
  236. package/dist/worlds/index.d.ts +2 -0
  237. package/dist/worlds/index.js +2 -0
  238. package/dist/worlds/index.js.map +1 -0
  239. package/dist/worlds/worlds.d.ts +160 -0
  240. package/dist/worlds/worlds.js +491 -0
  241. package/dist/worlds/worlds.js.map +1 -0
  242. package/docs/assets/dashboard.png +0 -0
  243. package/docs/ci.md +49 -0
  244. package/docs/commercial/README.md +29 -0
  245. package/docs/commercial/data-inventory.md +36 -0
  246. package/docs/commercial/manual-invoicing.md +44 -0
  247. package/docs/commercial/metrics.md +51 -0
  248. package/docs/commercial/pricing.md +103 -0
  249. package/docs/commercial/privacy-policy-draft.md +41 -0
  250. package/docs/commercial/terms-topics-for-counsel.md +51 -0
  251. package/docs/design-partners/README.md +52 -0
  252. package/docs/design-partners/demo-narratives.md +33 -0
  253. package/docs/design-partners/design-partner-offer.md +39 -0
  254. package/docs/design-partners/discovery-questions.md +28 -0
  255. package/docs/design-partners/feedback-capture-template.md +48 -0
  256. package/docs/design-partners/icp-one-pager.md +43 -0
  257. package/docs/design-partners/onboarding-checklist.md +33 -0
  258. package/docs/design-partners/pilot-success-criteria.md +27 -0
  259. package/docs/design-partners/pricing-interview-script.md +18 -0
  260. package/docs/design-partners/telemetry-plan.md +48 -0
  261. package/docs/development/baseline.md +114 -0
  262. package/docs/development/onboarding-smoke.md +37 -0
  263. package/docs/development/verification-0.1.8.md +25 -0
  264. package/docs/enterprise-product-roadmap-ru.md +1879 -0
  265. package/docs/fundraising/README.md +87 -0
  266. package/docs/fundraising/data-room-checklist.md +72 -0
  267. package/docs/fundraising/demo-script.md +52 -0
  268. package/docs/fundraising/design-partners-50.md +74 -0
  269. package/docs/fundraising/launch-posts.md +37 -0
  270. package/docs/fundraising/metrics-and-evidence.md +30 -0
  271. package/docs/fundraising/roadmap-12-month.md +25 -0
  272. package/docs/fundraising/technical-due-diligence-index.md +37 -0
  273. package/docs/fundraising/yc-application.md +25 -0
  274. package/docs/github-actions.md +84 -0
  275. package/docs/hosted-pilot.md +111 -0
  276. package/docs/mcp.md +52 -50
  277. package/docs/operations/disaster-recovery-runbook.md +81 -0
  278. package/docs/operations/kill-switch-runbook.md +32 -0
  279. package/docs/policy.md +61 -0
  280. package/docs/providers/authoring-packs.md +175 -0
  281. package/docs/providers/stripe-core-pack.md +82 -0
  282. package/docs/release-checklist.md +83 -71
  283. package/docs/release-migration-and-rollback.md +63 -0
  284. package/docs/release-readiness.md +39 -0
  285. package/docs/security/action-gateway-threat-model.md +34 -0
  286. package/docs/security/action-ledger-incident-replay-threat-model.md +42 -0
  287. package/docs/security/approval-inbox-threat-model.md +35 -0
  288. package/docs/security/credential-broker-threat-model.md +52 -0
  289. package/docs/security/egress-threat-model.md +126 -0
  290. package/docs/security/inventory-threat-model.md +104 -0
  291. package/docs/security/kill-switch-budgets-threat-model.md +37 -0
  292. package/docs/security/reliability-threat-model.md +111 -0
  293. package/docs/security/trust-ladder-threat-model.md +33 -0
  294. package/docs/team-control-plane.md +72 -0
  295. package/docs/usage.md +571 -57
  296. package/examples/README.md +10 -0
  297. package/examples/agent-instructions/README.md +39 -39
  298. package/examples/ci-smoke/README.md +21 -0
  299. package/examples/ci-smoke/ghostapi.policy.yaml +22 -0
  300. package/examples/ci-smoke/package.json +9 -0
  301. package/examples/ci-smoke/production-egress.mjs +2 -0
  302. package/examples/ci-smoke/safe.mjs +17 -0
  303. package/examples/evals/README.md +24 -0
  304. package/examples/evals/retry-after.eval.json +52 -0
  305. package/examples/generic-rest/README.md +27 -27
  306. package/examples/github-fetch/README.md +35 -35
  307. package/examples/openai-streaming/README.md +16 -0
  308. package/examples/openai-streaming/streaming-tool-call.mjs +31 -0
  309. package/examples/policy/ghostapi.policy.yaml +27 -0
  310. package/examples/record-replay/README.md +19 -0
  311. package/examples/record-replay/replay-requests.json +22 -0
  312. package/examples/record-replay/stripe-checkout.har.json +30 -0
  313. package/examples/resend-node/README.md +22 -22
  314. package/examples/stripe-node/README.md +35 -29
  315. package/examples/stripe-node/checkout-flow.mjs +61 -0
  316. package/examples/twilio-node/README.md +21 -21
  317. package/examples/worlds/README.md +19 -0
  318. package/examples/worlds/subscription-recovery.mjs +12 -0
  319. package/package.json +26 -11
  320. package/dist/providers/stripe.d.ts +0 -2
  321. package/dist/providers/stripe.js +0 -15
  322. package/dist/providers/stripe.js.map +0 -1
  323. package/docs/assets/ghostapi-avatar.png +0 -0
@@ -0,0 +1,45 @@
1
+ import { isAbsolute, relative, resolve, sep } from "node:path";
2
+ export function getDataDir(env = process.env) {
3
+ const configured = env.GHOSTAPI_DATA_DIR?.trim();
4
+ return resolve(configured && configured !== "" ? configured : ".ghostapi");
5
+ }
6
+ export function resolveDataPath(...segments) {
7
+ const root = getDataDir();
8
+ const target = resolve(root, ...segments);
9
+ const relativePath = relative(root, target);
10
+ if (relativePath === ".." || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath)) {
11
+ throw new Error("GhostAPI data path must stay inside GHOSTAPI_DATA_DIR.");
12
+ }
13
+ return target;
14
+ }
15
+ export function getDataPaths() {
16
+ return {
17
+ root: getDataDir(),
18
+ config: resolveDataPath("config.json"),
19
+ state: resolveDataPath("state.json"),
20
+ behaviors: resolveDataPath("behaviors.json"),
21
+ cache: resolveDataPath("cache"),
22
+ events: resolveDataPath("events.jsonl"),
23
+ reports: resolveDataPath("reports"),
24
+ scenarios: resolveDataPath("scenarios"),
25
+ contracts: resolveDataPath("contracts"),
26
+ worlds: resolveDataPath("worlds"),
27
+ actions: resolveDataPath("actions"),
28
+ approvals: resolveDataPath("approvals.json"),
29
+ credentialBroker: resolveDataPath("credential-broker.json"),
30
+ trustLadder: resolveDataPath("trust-ladder.json"),
31
+ safetyController: resolveDataPath("safety-controller.json"),
32
+ actionLedger: resolveDataPath("action-ledger.json"),
33
+ incidents: resolveDataPath("incidents"),
34
+ teamControlPlane: resolveDataPath("team-control-plane.json"),
35
+ faultLab: resolveDataPath("fault-lab.json"),
36
+ productTelemetry: resolveDataPath("product-telemetry.json"),
37
+ reliability: resolveDataPath("reliability"),
38
+ sloStore: resolveDataPath("reliability", "slo.json"),
39
+ reconciliationStore: resolveDataPath("reliability", "reconciliation.json"),
40
+ costStore: resolveDataPath("reliability", "costs.json"),
41
+ backups: resolveDataPath("reliability", "backups"),
42
+ inventoryStore: resolveDataPath("inventory.json")
43
+ };
44
+ }
45
+ //# sourceMappingURL=dataPaths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dataPaths.js","sourceRoot":"","sources":["../../src/config/dataPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AA+B/D,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,UAAU,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAG,QAAkB;IACnD,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE5C,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,UAAU,EAAE;QAClB,MAAM,EAAE,eAAe,CAAC,aAAa,CAAC;QACtC,KAAK,EAAE,eAAe,CAAC,YAAY,CAAC;QACpC,SAAS,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAC5C,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC;QACvC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC;QACnC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC;QACvC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC;QACvC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC;QACjC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC;QACnC,SAAS,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAC5C,gBAAgB,EAAE,eAAe,CAAC,wBAAwB,CAAC;QAC3D,WAAW,EAAE,eAAe,CAAC,mBAAmB,CAAC;QACjD,gBAAgB,EAAE,eAAe,CAAC,wBAAwB,CAAC;QAC3D,YAAY,EAAE,eAAe,CAAC,oBAAoB,CAAC;QACnD,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC;QACvC,gBAAgB,EAAE,eAAe,CAAC,yBAAyB,CAAC;QAC5D,QAAQ,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAC3C,gBAAgB,EAAE,eAAe,CAAC,wBAAwB,CAAC;QAC3D,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC;QAC3C,QAAQ,EAAE,eAAe,CAAC,aAAa,EAAE,UAAU,CAAC;QACpD,mBAAmB,EAAE,eAAe,CAAC,aAAa,EAAE,qBAAqB,CAAC;QAC1E,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,YAAY,CAAC;QACvD,OAAO,EAAE,eAAe,CAAC,aAAa,EAAE,SAAS,CAAC;QAClD,cAAc,EAAE,eAAe,CAAC,gBAAgB,CAAC;KAClD,CAAC;AACJ,CAAC"}
@@ -4,9 +4,8 @@ export type GhostApiFileConfig = {
4
4
  model?: string;
5
5
  offline?: boolean;
6
6
  https?: boolean;
7
+ allowExternalLlm?: boolean;
7
8
  };
8
- export declare const GHOSTAPI_DIR = ".ghostapi";
9
- export declare const CONFIG_PATH = ".ghostapi/config.json";
10
9
  export declare function readLocalConfigSync(): GhostApiFileConfig;
11
10
  export declare function readLocalConfig(): Promise<GhostApiFileConfig>;
12
11
  export declare function writeLocalConfig(config: GhostApiFileConfig): Promise<void>;
@@ -1,18 +1,19 @@
1
- import { mkdir, readFile, writeFile } from "node:fs/promises";
2
- import { dirname } from "node:path";
1
+ import { readFile } from "node:fs/promises";
3
2
  import { existsSync, readFileSync } from "node:fs";
4
3
  import { isJsonObject } from "../utils/json.js";
5
- export const GHOSTAPI_DIR = ".ghostapi";
6
- export const CONFIG_PATH = ".ghostapi/config.json";
4
+ import { getDataPaths } from "./dataPaths.js";
5
+ import { atomicWriteJson, withFileLock } from "../storage/fileStore.js";
7
6
  export function readLocalConfigSync() {
8
- if (!existsSync(CONFIG_PATH))
7
+ const configPath = getDataPaths().config;
8
+ if (!existsSync(configPath))
9
9
  return {};
10
- const parsed = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
10
+ const parsed = JSON.parse(readFileSync(configPath, "utf8"));
11
11
  return sanitizeConfig(parsed);
12
12
  }
13
13
  export async function readLocalConfig() {
14
+ const configPath = getDataPaths().config;
14
15
  try {
15
- const parsed = JSON.parse(await readFile(CONFIG_PATH, "utf8"));
16
+ const parsed = JSON.parse(await readFile(configPath, "utf8"));
16
17
  return sanitizeConfig(parsed);
17
18
  }
18
19
  catch (error) {
@@ -22,22 +23,25 @@ export async function readLocalConfig() {
22
23
  }
23
24
  }
24
25
  export async function writeLocalConfig(config) {
25
- await mkdir(dirname(CONFIG_PATH), { recursive: true });
26
- await writeFile(CONFIG_PATH, JSON.stringify(sanitizeConfig(config), null, 2) + "\n", "utf8");
26
+ const configPath = getDataPaths().config;
27
+ await withFileLock(configPath, () => atomicWriteJson(configPath, sanitizeConfig(config)));
27
28
  }
28
29
  export async function initializeLocalConfig() {
29
- if (existsSync(CONFIG_PATH)) {
30
- return { created: false, config: await readLocalConfig() };
31
- }
32
- const config = {
33
- host: "127.0.0.1",
34
- port: 8080,
35
- model: "gpt-4o-mini",
36
- offline: false,
37
- https: false
38
- };
39
- await writeLocalConfig(config);
40
- return { created: true, config };
30
+ const configPath = getDataPaths().config;
31
+ return withFileLock(configPath, async () => {
32
+ if (existsSync(configPath))
33
+ return { created: false, config: await readLocalConfig() };
34
+ const config = {
35
+ host: "127.0.0.1",
36
+ port: 8080,
37
+ model: "gpt-4o-mini",
38
+ offline: false,
39
+ https: false,
40
+ allowExternalLlm: false
41
+ };
42
+ await atomicWriteJson(configPath, config);
43
+ return { created: true, config };
44
+ });
41
45
  }
42
46
  function sanitizeConfig(value) {
43
47
  if (!isJsonObject(value))
@@ -53,6 +57,8 @@ function sanitizeConfig(value) {
53
57
  config.offline = value.offline;
54
58
  if (typeof value.https === "boolean")
55
59
  config.https = value.https;
60
+ if (typeof value.allowExternalLlm === "boolean")
61
+ config.allowExternalLlm = value.allowExternalLlm;
56
62
  return config;
57
63
  }
58
64
  //# sourceMappingURL=localConfig.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"localConfig.js","sourceRoot":"","sources":["../../src/config/localConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAEnD,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;IACxE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;QAC1E,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACpF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA0B;IAC/D,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAuB;QACjC,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK;KACb,CAAC;IACF,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzF,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC7F,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACvI,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACvE,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC"}
1
+ {"version":3,"file":"localConfig.js","sourceRoot":"","sources":["../../src/config/localConfig.ts"],"names":[],"mappings":"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"}
@@ -5,7 +5,9 @@ export type ServerConfig = {
5
5
  model: string;
6
6
  offline?: boolean;
7
7
  https?: boolean;
8
+ allowExternalLlm?: boolean;
8
9
  apiKey?: string;
10
+ authToken?: string;
9
11
  };
10
12
  export declare const DEFAULT_HOST = "127.0.0.1";
11
13
  export declare const DEFAULT_PORT = 8080;
@@ -5,13 +5,16 @@ export const DEFAULT_MODEL = "gpt-4o-mini";
5
5
  export function loadServerConfig(env = process.env, args = process.argv, overrides = {}) {
6
6
  const localConfig = readLocalConfigSync();
7
7
  const offline = parseBoolean(overrides.offline, parseBooleanEnv(env.GHOSTAPI_OFFLINE, localConfig.offline ?? false));
8
+ const allowExternalLlm = !offline && parseBoolean(overrides.allowExternalLlm, parseBooleanEnv(env.GHOSTAPI_ALLOW_EXTERNAL_LLM, localConfig.allowExternalLlm ?? false));
8
9
  return {
9
10
  host: overrides.host ?? env.GHOSTAPI_HOST ?? localConfig.host ?? DEFAULT_HOST,
10
11
  port: overrides.port ?? parsePort(env.GHOSTAPI_PORT, localConfig.port),
11
12
  model: overrides.model ?? parseModel(env.GHOSTAPI_MODEL, args, localConfig.model),
12
13
  offline,
13
14
  https: parseBoolean(overrides.https, parseBooleanEnv(env.GHOSTAPI_HTTPS, localConfig.https ?? false)),
14
- apiKey: offline ? undefined : env.GHOSTAPI_LLM_API_KEY ?? env.OPENAI_API_KEY
15
+ allowExternalLlm,
16
+ apiKey: allowExternalLlm ? readNonEmpty(env.GHOSTAPI_LLM_API_KEY) : undefined,
17
+ authToken: readNonEmpty(env.GHOSTAPI_AUTH_TOKEN)
15
18
  };
16
19
  }
17
20
  function parseModel(envModel, args, configModel) {
@@ -41,4 +44,8 @@ function parseBooleanEnv(value, fallback) {
41
44
  return fallback;
42
45
  return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
43
46
  }
47
+ function readNonEmpty(value) {
48
+ const trimmed = value?.trim();
49
+ return trimmed ? trimmed : undefined;
50
+ }
44
51
  //# sourceMappingURL=serverConfig.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"serverConfig.js","sourceRoot":"","sources":["../../src/config/serverConfig.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"serverConfig.js","sourceRoot":"","sources":["../../src/config/serverConfig.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ import { type ScenarioBundle, type ScenarioRecordingOptions } from "../scenarios/scenarioBundle.js";
2
+ export type ContractSchema = {
3
+ type?: "string" | "number" | "integer" | "boolean" | "array" | "object" | "null";
4
+ enum?: Array<string | number | boolean | null>;
5
+ required?: string[];
6
+ properties?: Record<string, ContractSchema>;
7
+ items?: ContractSchema;
8
+ };
9
+ export type ContractOperation = {
10
+ method: string;
11
+ path: string;
12
+ request?: ContractSchema;
13
+ responses: Record<string, ContractSchema | null>;
14
+ };
15
+ export type ContractProviderCapability = {
16
+ name: string;
17
+ packVersion: string | null;
18
+ capabilities: Record<string, boolean>;
19
+ };
20
+ export type GhostApiContract = {
21
+ schemaVersion: 1;
22
+ kind: "ghostapi.contract";
23
+ metadata: {
24
+ title: string;
25
+ source: "openapi" | "har";
26
+ importedAt: string;
27
+ };
28
+ operations: ContractOperation[];
29
+ providerCapabilities: ContractProviderCapability[];
30
+ };
31
+ export type OpenApiImportOptions = {
32
+ title?: string;
33
+ importedAt?: string;
34
+ };
35
+ export type HarContractImportOptions = ScenarioRecordingOptions & {
36
+ title?: string;
37
+ importedAt?: string;
38
+ };
39
+ export type ContractDiffSeverity = "breaking" | "non-breaking" | "uncertain";
40
+ export type ContractDiffFinding = {
41
+ id: string;
42
+ severity: ContractDiffSeverity;
43
+ message: string;
44
+ };
45
+ export type ContractDiff = {
46
+ schemaVersion: 1;
47
+ kind: "ghostapi.contract-diff";
48
+ baselineHash: string;
49
+ candidateHash: string;
50
+ findings: ContractDiffFinding[];
51
+ summary: {
52
+ breaking: number;
53
+ nonBreaking: number;
54
+ uncertain: number;
55
+ };
56
+ };
57
+ export declare class ContractError extends Error {
58
+ constructor(message: string);
59
+ }
60
+ export declare function importOpenApiContract(input: unknown, options?: OpenApiImportOptions): GhostApiContract;
61
+ export declare function importHarContract(input: unknown, options: HarContractImportOptions): {
62
+ bundle: ScenarioBundle;
63
+ contract: GhostApiContract;
64
+ };
65
+ export declare function contractFromScenarioBundle(bundle: ScenarioBundle, title?: string, importedAt?: string): GhostApiContract;
66
+ export declare function importOpenApiContractFromFile(path: string, options?: OpenApiImportOptions, projectRoot?: string): Promise<GhostApiContract>;
67
+ export declare function importHarContractFromFile(path: string, options: HarContractImportOptions, projectRoot?: string): Promise<{
68
+ bundle: ScenarioBundle;
69
+ contract: GhostApiContract;
70
+ }>;
71
+ export declare function writeContract(contract: GhostApiContract, outPath?: string, projectRoot?: string): Promise<string>;
72
+ export declare function loadContract(path: string, projectRoot?: string): Promise<GhostApiContract>;
73
+ export declare function validateContract(input: unknown): GhostApiContract;
74
+ export declare function diffContracts(baselineInput: GhostApiContract, candidateInput: GhostApiContract): ContractDiff;
75
+ export declare function formatContractDiff(diff: ContractDiff): string;
76
+ export declare function contractHash(contract: GhostApiContract): string;