@kindgi/api 0.0.0-bootstrap.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (505) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +216 -1
  3. package/dist/adapter-binding.d.ts +177 -0
  4. package/dist/adapter-binding.d.ts.map +1 -0
  5. package/dist/adapter-binding.js +12 -0
  6. package/dist/adapter-binding.js.map +1 -0
  7. package/dist/agent-binding.d.ts +207 -0
  8. package/dist/agent-binding.d.ts.map +1 -0
  9. package/dist/agent-binding.js +4 -0
  10. package/dist/agent-binding.js.map +1 -0
  11. package/dist/app.d.ts +770 -0
  12. package/dist/app.d.ts.map +1 -0
  13. package/dist/app.js +397 -0
  14. package/dist/app.js.map +1 -0
  15. package/dist/capability-binding.d.ts +76 -0
  16. package/dist/capability-binding.d.ts.map +1 -0
  17. package/dist/capability-binding.js +4 -0
  18. package/dist/capability-binding.js.map +1 -0
  19. package/dist/cost-binding.d.ts +175 -0
  20. package/dist/cost-binding.d.ts.map +1 -0
  21. package/dist/cost-binding.js +13 -0
  22. package/dist/cost-binding.js.map +1 -0
  23. package/dist/deployment-binding.d.ts +201 -0
  24. package/dist/deployment-binding.d.ts.map +1 -0
  25. package/dist/deployment-binding.js +4 -0
  26. package/dist/deployment-binding.js.map +1 -0
  27. package/dist/env-binding.d.ts +132 -0
  28. package/dist/env-binding.d.ts.map +1 -0
  29. package/dist/env-binding.js +4 -0
  30. package/dist/env-binding.js.map +1 -0
  31. package/dist/errors.d.ts +37 -0
  32. package/dist/errors.d.ts.map +1 -0
  33. package/dist/errors.js +268 -0
  34. package/dist/errors.js.map +1 -0
  35. package/dist/eval-run-binding.d.ts +196 -0
  36. package/dist/eval-run-binding.d.ts.map +1 -0
  37. package/dist/eval-run-binding.js +16 -0
  38. package/dist/eval-run-binding.js.map +1 -0
  39. package/dist/eval-run-dispatcher.d.ts +131 -0
  40. package/dist/eval-run-dispatcher.d.ts.map +1 -0
  41. package/dist/eval-run-dispatcher.js +368 -0
  42. package/dist/eval-run-dispatcher.js.map +1 -0
  43. package/dist/eval-suite-binding.d.ts +227 -0
  44. package/dist/eval-suite-binding.d.ts.map +1 -0
  45. package/dist/eval-suite-binding.js +24 -0
  46. package/dist/eval-suite-binding.js.map +1 -0
  47. package/dist/event-bus-binding.d.ts +107 -0
  48. package/dist/event-bus-binding.d.ts.map +1 -0
  49. package/dist/event-bus-binding.js +5 -0
  50. package/dist/event-bus-binding.js.map +1 -0
  51. package/dist/flow-binding.d.ts +194 -0
  52. package/dist/flow-binding.d.ts.map +1 -0
  53. package/dist/flow-binding.js +4 -0
  54. package/dist/flow-binding.js.map +1 -0
  55. package/dist/guardrail-binding.d.ts +138 -0
  56. package/dist/guardrail-binding.d.ts.map +1 -0
  57. package/dist/guardrail-binding.js +4 -0
  58. package/dist/guardrail-binding.js.map +1 -0
  59. package/dist/handler-binding.d.ts +126 -0
  60. package/dist/handler-binding.d.ts.map +1 -0
  61. package/dist/handler-binding.js +4 -0
  62. package/dist/handler-binding.js.map +1 -0
  63. package/dist/hitl-binding.d.ts +115 -0
  64. package/dist/hitl-binding.d.ts.map +1 -0
  65. package/dist/hitl-binding.js +4 -0
  66. package/dist/hitl-binding.js.map +1 -0
  67. package/dist/identity-directory-binding.d.ts +116 -0
  68. package/dist/identity-directory-binding.d.ts.map +1 -0
  69. package/dist/identity-directory-binding.js +4 -0
  70. package/dist/identity-directory-binding.js.map +1 -0
  71. package/dist/identity-provider-binding.d.ts +184 -0
  72. package/dist/identity-provider-binding.d.ts.map +1 -0
  73. package/dist/identity-provider-binding.js +4 -0
  74. package/dist/identity-provider-binding.js.map +1 -0
  75. package/dist/image-registry-binding.d.ts +165 -0
  76. package/dist/image-registry-binding.d.ts.map +1 -0
  77. package/dist/image-registry-binding.js +4 -0
  78. package/dist/image-registry-binding.js.map +1 -0
  79. package/dist/index.d.ts +72 -0
  80. package/dist/index.d.ts.map +1 -0
  81. package/dist/index.js +26 -0
  82. package/dist/index.js.map +1 -0
  83. package/dist/key-management-binding.d.ts +101 -0
  84. package/dist/key-management-binding.d.ts.map +1 -0
  85. package/dist/key-management-binding.js +4 -0
  86. package/dist/key-management-binding.js.map +1 -0
  87. package/dist/mcp-endpoint-binding.d.ts +312 -0
  88. package/dist/mcp-endpoint-binding.d.ts.map +1 -0
  89. package/dist/mcp-endpoint-binding.js +12 -0
  90. package/dist/mcp-endpoint-binding.js.map +1 -0
  91. package/dist/memory-binding.d.ts +209 -0
  92. package/dist/memory-binding.d.ts.map +1 -0
  93. package/dist/memory-binding.js +4 -0
  94. package/dist/memory-binding.js.map +1 -0
  95. package/dist/middleware/auth.d.ts +168 -0
  96. package/dist/middleware/auth.d.ts.map +1 -0
  97. package/dist/middleware/auth.js +247 -0
  98. package/dist/middleware/auth.js.map +1 -0
  99. package/dist/middleware/authorize.d.ts +26 -0
  100. package/dist/middleware/authorize.d.ts.map +1 -0
  101. package/dist/middleware/authorize.js +65 -0
  102. package/dist/middleware/authorize.js.map +1 -0
  103. package/dist/middleware/error-mapper.d.ts +20 -0
  104. package/dist/middleware/error-mapper.d.ts.map +1 -0
  105. package/dist/middleware/error-mapper.js +34 -0
  106. package/dist/middleware/error-mapper.js.map +1 -0
  107. package/dist/middleware/idempotency.d.ts +43 -0
  108. package/dist/middleware/idempotency.d.ts.map +1 -0
  109. package/dist/middleware/idempotency.js +118 -0
  110. package/dist/middleware/idempotency.js.map +1 -0
  111. package/dist/middleware/principal.d.ts +4 -0
  112. package/dist/middleware/principal.d.ts.map +1 -0
  113. package/dist/middleware/principal.js +42 -0
  114. package/dist/middleware/principal.js.map +1 -0
  115. package/dist/middleware/public-run-routes.d.ts +16 -0
  116. package/dist/middleware/public-run-routes.d.ts.map +1 -0
  117. package/dist/middleware/public-run-routes.js +43 -0
  118. package/dist/middleware/public-run-routes.js.map +1 -0
  119. package/dist/middleware/request-id.d.ts +14 -0
  120. package/dist/middleware/request-id.d.ts.map +1 -0
  121. package/dist/middleware/request-id.js +24 -0
  122. package/dist/middleware/request-id.js.map +1 -0
  123. package/dist/middleware/sigv4-verify.d.ts +64 -0
  124. package/dist/middleware/sigv4-verify.d.ts.map +1 -0
  125. package/dist/middleware/sigv4-verify.js +286 -0
  126. package/dist/middleware/sigv4-verify.js.map +1 -0
  127. package/dist/middleware/sigv4.d.ts +25 -0
  128. package/dist/middleware/sigv4.d.ts.map +1 -0
  129. package/dist/middleware/sigv4.js +120 -0
  130. package/dist/middleware/sigv4.js.map +1 -0
  131. package/dist/openapi/generate.d.ts +15 -0
  132. package/dist/openapi/generate.d.ts.map +1 -0
  133. package/dist/openapi/generate.js +241 -0
  134. package/dist/openapi/generate.js.map +1 -0
  135. package/dist/openapi/operations.d.ts +70 -0
  136. package/dist/openapi/operations.d.ts.map +1 -0
  137. package/dist/openapi/operations.js +5050 -0
  138. package/dist/openapi/operations.js.map +1 -0
  139. package/dist/openapi/schemas.d.ts +590 -0
  140. package/dist/openapi/schemas.d.ts.map +1 -0
  141. package/dist/openapi/schemas.js +5820 -0
  142. package/dist/openapi/schemas.js.map +1 -0
  143. package/dist/provenance-binding.d.ts +116 -0
  144. package/dist/provenance-binding.d.ts.map +1 -0
  145. package/dist/provenance-binding.js +31 -0
  146. package/dist/provenance-binding.js.map +1 -0
  147. package/dist/provider-binding.d.ts +174 -0
  148. package/dist/provider-binding.d.ts.map +1 -0
  149. package/dist/provider-binding.js +4 -0
  150. package/dist/provider-binding.js.map +1 -0
  151. package/dist/public-run-token.d.ts +97 -0
  152. package/dist/public-run-token.d.ts.map +1 -0
  153. package/dist/public-run-token.js +167 -0
  154. package/dist/public-run-token.js.map +1 -0
  155. package/dist/retention-binding.d.ts +69 -0
  156. package/dist/retention-binding.d.ts.map +1 -0
  157. package/dist/retention-binding.js +4 -0
  158. package/dist/retention-binding.js.map +1 -0
  159. package/dist/reviewer-binding.d.ts +84 -0
  160. package/dist/reviewer-binding.d.ts.map +1 -0
  161. package/dist/reviewer-binding.js +4 -0
  162. package/dist/reviewer-binding.js.map +1 -0
  163. package/dist/rotation-status-store.d.ts +96 -0
  164. package/dist/rotation-status-store.d.ts.map +1 -0
  165. package/dist/rotation-status-store.js +106 -0
  166. package/dist/rotation-status-store.js.map +1 -0
  167. package/dist/routes/adapters.d.ts +29 -0
  168. package/dist/routes/adapters.d.ts.map +1 -0
  169. package/dist/routes/adapters.js +230 -0
  170. package/dist/routes/adapters.js.map +1 -0
  171. package/dist/routes/agents.d.ts +17 -0
  172. package/dist/routes/agents.d.ts.map +1 -0
  173. package/dist/routes/agents.js +342 -0
  174. package/dist/routes/agents.js.map +1 -0
  175. package/dist/routes/approvals.d.ts +37 -0
  176. package/dist/routes/approvals.d.ts.map +1 -0
  177. package/dist/routes/approvals.js +551 -0
  178. package/dist/routes/approvals.js.map +1 -0
  179. package/dist/routes/artifacts.d.ts +25 -0
  180. package/dist/routes/artifacts.d.ts.map +1 -0
  181. package/dist/routes/artifacts.js +265 -0
  182. package/dist/routes/artifacts.js.map +1 -0
  183. package/dist/routes/audit.d.ts +6 -0
  184. package/dist/routes/audit.d.ts.map +1 -0
  185. package/dist/routes/audit.js +162 -0
  186. package/dist/routes/audit.js.map +1 -0
  187. package/dist/routes/auth.d.ts +47 -0
  188. package/dist/routes/auth.d.ts.map +1 -0
  189. package/dist/routes/auth.js +630 -0
  190. package/dist/routes/auth.js.map +1 -0
  191. package/dist/routes/capabilities.d.ts +14 -0
  192. package/dist/routes/capabilities.d.ts.map +1 -0
  193. package/dist/routes/capabilities.js +62 -0
  194. package/dist/routes/capabilities.js.map +1 -0
  195. package/dist/routes/compliance.d.ts +37 -0
  196. package/dist/routes/compliance.d.ts.map +1 -0
  197. package/dist/routes/compliance.js +321 -0
  198. package/dist/routes/compliance.js.map +1 -0
  199. package/dist/routes/conversations.d.ts +13 -0
  200. package/dist/routes/conversations.d.ts.map +1 -0
  201. package/dist/routes/conversations.js +295 -0
  202. package/dist/routes/conversations.js.map +1 -0
  203. package/dist/routes/cost.d.ts +24 -0
  204. package/dist/routes/cost.d.ts.map +1 -0
  205. package/dist/routes/cost.js +243 -0
  206. package/dist/routes/cost.js.map +1 -0
  207. package/dist/routes/deployments.d.ts +122 -0
  208. package/dist/routes/deployments.d.ts.map +1 -0
  209. package/dist/routes/deployments.js +1036 -0
  210. package/dist/routes/deployments.js.map +1 -0
  211. package/dist/routes/env.d.ts +62 -0
  212. package/dist/routes/env.d.ts.map +1 -0
  213. package/dist/routes/env.js +311 -0
  214. package/dist/routes/env.js.map +1 -0
  215. package/dist/routes/eval-runs.d.ts +28 -0
  216. package/dist/routes/eval-runs.d.ts.map +1 -0
  217. package/dist/routes/eval-runs.js +479 -0
  218. package/dist/routes/eval-runs.js.map +1 -0
  219. package/dist/routes/eval-suites.d.ts +24 -0
  220. package/dist/routes/eval-suites.d.ts.map +1 -0
  221. package/dist/routes/eval-suites.js +381 -0
  222. package/dist/routes/eval-suites.js.map +1 -0
  223. package/dist/routes/event-triggers.d.ts +12 -0
  224. package/dist/routes/event-triggers.d.ts.map +1 -0
  225. package/dist/routes/event-triggers.js +218 -0
  226. package/dist/routes/event-triggers.js.map +1 -0
  227. package/dist/routes/flows.d.ts +23 -0
  228. package/dist/routes/flows.d.ts.map +1 -0
  229. package/dist/routes/flows.js +344 -0
  230. package/dist/routes/flows.js.map +1 -0
  231. package/dist/routes/guardrails.d.ts +33 -0
  232. package/dist/routes/guardrails.d.ts.map +1 -0
  233. package/dist/routes/guardrails.js +236 -0
  234. package/dist/routes/guardrails.js.map +1 -0
  235. package/dist/routes/identity.d.ts +39 -0
  236. package/dist/routes/identity.d.ts.map +1 -0
  237. package/dist/routes/identity.js +138 -0
  238. package/dist/routes/identity.js.map +1 -0
  239. package/dist/routes/mcp.d.ts +23 -0
  240. package/dist/routes/mcp.d.ts.map +1 -0
  241. package/dist/routes/mcp.js +727 -0
  242. package/dist/routes/mcp.js.map +1 -0
  243. package/dist/routes/memory.d.ts +16 -0
  244. package/dist/routes/memory.d.ts.map +1 -0
  245. package/dist/routes/memory.js +353 -0
  246. package/dist/routes/memory.js.map +1 -0
  247. package/dist/routes/observations.d.ts +19 -0
  248. package/dist/routes/observations.d.ts.map +1 -0
  249. package/dist/routes/observations.js +135 -0
  250. package/dist/routes/observations.js.map +1 -0
  251. package/dist/routes/orgs.d.ts +24 -0
  252. package/dist/routes/orgs.d.ts.map +1 -0
  253. package/dist/routes/orgs.js +208 -0
  254. package/dist/routes/orgs.js.map +1 -0
  255. package/dist/routes/pagination.d.ts +18 -0
  256. package/dist/routes/pagination.d.ts.map +1 -0
  257. package/dist/routes/pagination.js +35 -0
  258. package/dist/routes/pagination.js.map +1 -0
  259. package/dist/routes/policies.d.ts +23 -0
  260. package/dist/routes/policies.d.ts.map +1 -0
  261. package/dist/routes/policies.js +314 -0
  262. package/dist/routes/policies.js.map +1 -0
  263. package/dist/routes/projects.d.ts +45 -0
  264. package/dist/routes/projects.d.ts.map +1 -0
  265. package/dist/routes/projects.js +485 -0
  266. package/dist/routes/projects.js.map +1 -0
  267. package/dist/routes/proposals.d.ts +24 -0
  268. package/dist/routes/proposals.d.ts.map +1 -0
  269. package/dist/routes/proposals.js +581 -0
  270. package/dist/routes/proposals.js.map +1 -0
  271. package/dist/routes/provenance.d.ts +34 -0
  272. package/dist/routes/provenance.d.ts.map +1 -0
  273. package/dist/routes/provenance.js +274 -0
  274. package/dist/routes/provenance.js.map +1 -0
  275. package/dist/routes/providers.d.ts +32 -0
  276. package/dist/routes/providers.d.ts.map +1 -0
  277. package/dist/routes/providers.js +490 -0
  278. package/dist/routes/providers.js.map +1 -0
  279. package/dist/routes/public-run-tokens.d.ts +17 -0
  280. package/dist/routes/public-run-tokens.d.ts.map +1 -0
  281. package/dist/routes/public-run-tokens.js +69 -0
  282. package/dist/routes/public-run-tokens.js.map +1 -0
  283. package/dist/routes/retention.d.ts +19 -0
  284. package/dist/routes/retention.d.ts.map +1 -0
  285. package/dist/routes/retention.js +152 -0
  286. package/dist/routes/retention.js.map +1 -0
  287. package/dist/routes/reviewers.d.ts +5 -0
  288. package/dist/routes/reviewers.d.ts.map +1 -0
  289. package/dist/routes/reviewers.js +161 -0
  290. package/dist/routes/reviewers.js.map +1 -0
  291. package/dist/routes/runs.d.ts +34 -0
  292. package/dist/routes/runs.d.ts.map +1 -0
  293. package/dist/routes/runs.js +705 -0
  294. package/dist/routes/runs.js.map +1 -0
  295. package/dist/routes/s3.d.ts +31 -0
  296. package/dist/routes/s3.d.ts.map +1 -0
  297. package/dist/routes/s3.js +433 -0
  298. package/dist/routes/s3.js.map +1 -0
  299. package/dist/routes/schedules.d.ts +20 -0
  300. package/dist/routes/schedules.d.ts.map +1 -0
  301. package/dist/routes/schedules.js +234 -0
  302. package/dist/routes/schedules.js.map +1 -0
  303. package/dist/routes/scope-params.d.ts +57 -0
  304. package/dist/routes/scope-params.d.ts.map +1 -0
  305. package/dist/routes/scope-params.js +105 -0
  306. package/dist/routes/scope-params.js.map +1 -0
  307. package/dist/routes/secret-ref.d.ts +20 -0
  308. package/dist/routes/secret-ref.d.ts.map +1 -0
  309. package/dist/routes/secret-ref.js +42 -0
  310. package/dist/routes/secret-ref.js.map +1 -0
  311. package/dist/routes/secrets.d.ts +53 -0
  312. package/dist/routes/secrets.d.ts.map +1 -0
  313. package/dist/routes/secrets.js +715 -0
  314. package/dist/routes/secrets.js.map +1 -0
  315. package/dist/routes/signing-keys.d.ts +23 -0
  316. package/dist/routes/signing-keys.d.ts.map +1 -0
  317. package/dist/routes/signing-keys.js +212 -0
  318. package/dist/routes/signing-keys.js.map +1 -0
  319. package/dist/routes/sse.d.ts +58 -0
  320. package/dist/routes/sse.d.ts.map +1 -0
  321. package/dist/routes/sse.js +92 -0
  322. package/dist/routes/sse.js.map +1 -0
  323. package/dist/routes/teams.d.ts +30 -0
  324. package/dist/routes/teams.d.ts.map +1 -0
  325. package/dist/routes/teams.js +443 -0
  326. package/dist/routes/teams.js.map +1 -0
  327. package/dist/routes/tenant.d.ts +57 -0
  328. package/dist/routes/tenant.d.ts.map +1 -0
  329. package/dist/routes/tenant.js +352 -0
  330. package/dist/routes/tenant.js.map +1 -0
  331. package/dist/routes/tokens.d.ts +14 -0
  332. package/dist/routes/tokens.d.ts.map +1 -0
  333. package/dist/routes/tokens.js +231 -0
  334. package/dist/routes/tokens.js.map +1 -0
  335. package/dist/routes/tools.d.ts +33 -0
  336. package/dist/routes/tools.d.ts.map +1 -0
  337. package/dist/routes/tools.js +380 -0
  338. package/dist/routes/tools.js.map +1 -0
  339. package/dist/routes/webhook-endpoints.d.ts +10 -0
  340. package/dist/routes/webhook-endpoints.d.ts.map +1 -0
  341. package/dist/routes/webhook-endpoints.js +407 -0
  342. package/dist/routes/webhook-endpoints.js.map +1 -0
  343. package/dist/routes/webhooks.d.ts +21 -0
  344. package/dist/routes/webhooks.d.ts.map +1 -0
  345. package/dist/routes/webhooks.js +228 -0
  346. package/dist/routes/webhooks.js.map +1 -0
  347. package/dist/s3-credential-binding.d.ts +54 -0
  348. package/dist/s3-credential-binding.d.ts.map +1 -0
  349. package/dist/s3-credential-binding.js +4 -0
  350. package/dist/s3-credential-binding.js.map +1 -0
  351. package/dist/secrets-binding.d.ts +281 -0
  352. package/dist/secrets-binding.d.ts.map +1 -0
  353. package/dist/secrets-binding.js +10 -0
  354. package/dist/secrets-binding.js.map +1 -0
  355. package/dist/secrets-provider-binding.d.ts +164 -0
  356. package/dist/secrets-provider-binding.d.ts.map +1 -0
  357. package/dist/secrets-provider-binding.js +4 -0
  358. package/dist/secrets-provider-binding.js.map +1 -0
  359. package/dist/session-store-binding.d.ts +148 -0
  360. package/dist/session-store-binding.d.ts.map +1 -0
  361. package/dist/session-store-binding.js +4 -0
  362. package/dist/session-store-binding.js.map +1 -0
  363. package/dist/signing-key-binding.d.ts +210 -0
  364. package/dist/signing-key-binding.d.ts.map +1 -0
  365. package/dist/signing-key-binding.js +4 -0
  366. package/dist/signing-key-binding.js.map +1 -0
  367. package/dist/state-store-binding.d.ts +53 -0
  368. package/dist/state-store-binding.d.ts.map +1 -0
  369. package/dist/state-store-binding.js +38 -0
  370. package/dist/state-store-binding.js.map +1 -0
  371. package/dist/supervisor-binding.d.ts +526 -0
  372. package/dist/supervisor-binding.d.ts.map +1 -0
  373. package/dist/supervisor-binding.js +4 -0
  374. package/dist/supervisor-binding.js.map +1 -0
  375. package/dist/tenant-host-access.d.ts +41 -0
  376. package/dist/tenant-host-access.d.ts.map +1 -0
  377. package/dist/tenant-host-access.js +42 -0
  378. package/dist/tenant-host-access.js.map +1 -0
  379. package/dist/token-admin.d.ts +99 -0
  380. package/dist/token-admin.d.ts.map +1 -0
  381. package/dist/token-admin.js +4 -0
  382. package/dist/token-admin.js.map +1 -0
  383. package/dist/tool-binding.d.ts +247 -0
  384. package/dist/tool-binding.d.ts.map +1 -0
  385. package/dist/tool-binding.js +4 -0
  386. package/dist/tool-binding.js.map +1 -0
  387. package/dist/trigger-binding.d.ts +13 -0
  388. package/dist/trigger-binding.d.ts.map +1 -0
  389. package/dist/trigger-binding.js +4 -0
  390. package/dist/trigger-binding.js.map +1 -0
  391. package/dist/types.d.ts +71 -0
  392. package/dist/types.d.ts.map +1 -0
  393. package/dist/types.js +4 -0
  394. package/dist/types.js.map +1 -0
  395. package/dist/webhook-endpoint-binding.d.ts +230 -0
  396. package/dist/webhook-endpoint-binding.d.ts.map +1 -0
  397. package/dist/webhook-endpoint-binding.js +12 -0
  398. package/dist/webhook-endpoint-binding.js.map +1 -0
  399. package/dist/xml.d.ts +79 -0
  400. package/dist/xml.d.ts.map +1 -0
  401. package/dist/xml.js +115 -0
  402. package/dist/xml.js.map +1 -0
  403. package/openapi.json +29649 -0
  404. package/package.json +76 -4
  405. package/scripts/emit-openapi.mjs +44 -0
  406. package/src/adapter-binding.ts +204 -0
  407. package/src/agent-binding.ts +231 -0
  408. package/src/app.ts +1286 -0
  409. package/src/capability-binding.ts +83 -0
  410. package/src/cost-binding.ts +213 -0
  411. package/src/deployment-binding.ts +225 -0
  412. package/src/env-binding.ts +140 -0
  413. package/src/errors.ts +295 -0
  414. package/src/eval-run-binding.ts +209 -0
  415. package/src/eval-run-dispatcher.ts +497 -0
  416. package/src/eval-suite-binding.ts +257 -0
  417. package/src/event-bus-binding.ts +127 -0
  418. package/src/flow-binding.ts +213 -0
  419. package/src/guardrail-binding.ts +151 -0
  420. package/src/handler-binding.ts +132 -0
  421. package/src/hitl-binding.ts +172 -0
  422. package/src/identity-directory-binding.ts +128 -0
  423. package/src/identity-provider-binding.ts +203 -0
  424. package/src/image-registry-binding.ts +193 -0
  425. package/src/index.ts +606 -0
  426. package/src/key-management-binding.ts +91 -0
  427. package/src/mcp-endpoint-binding.ts +311 -0
  428. package/src/memory-binding.ts +239 -0
  429. package/src/middleware/auth.ts +437 -0
  430. package/src/middleware/authorize.ts +125 -0
  431. package/src/middleware/error-mapper.ts +40 -0
  432. package/src/middleware/idempotency.ts +160 -0
  433. package/src/middleware/principal.ts +64 -0
  434. package/src/middleware/public-run-routes.ts +50 -0
  435. package/src/middleware/request-id.ts +28 -0
  436. package/src/middleware/sigv4-verify.ts +374 -0
  437. package/src/middleware/sigv4.ts +165 -0
  438. package/src/openapi/generate.ts +307 -0
  439. package/src/openapi/operations.ts +5444 -0
  440. package/src/openapi/schemas.ts +6363 -0
  441. package/src/provenance-binding.ts +169 -0
  442. package/src/provider-binding.ts +196 -0
  443. package/src/public-run-token.ts +263 -0
  444. package/src/retention-binding.ts +78 -0
  445. package/src/reviewer-binding.ts +99 -0
  446. package/src/rotation-status-store.ts +209 -0
  447. package/src/routes/adapters.ts +319 -0
  448. package/src/routes/agents.ts +424 -0
  449. package/src/routes/approvals.ts +759 -0
  450. package/src/routes/artifacts.ts +317 -0
  451. package/src/routes/audit.ts +219 -0
  452. package/src/routes/auth.ts +806 -0
  453. package/src/routes/capabilities.ts +79 -0
  454. package/src/routes/compliance.ts +482 -0
  455. package/src/routes/conversations.ts +369 -0
  456. package/src/routes/cost.ts +327 -0
  457. package/src/routes/deployments.ts +1493 -0
  458. package/src/routes/env.ts +429 -0
  459. package/src/routes/eval-runs.ts +631 -0
  460. package/src/routes/eval-suites.ts +490 -0
  461. package/src/routes/event-triggers.ts +283 -0
  462. package/src/routes/flows.ts +423 -0
  463. package/src/routes/guardrails.ts +320 -0
  464. package/src/routes/identity.ts +203 -0
  465. package/src/routes/mcp.ts +940 -0
  466. package/src/routes/memory.ts +430 -0
  467. package/src/routes/observations.ts +175 -0
  468. package/src/routes/orgs.ts +273 -0
  469. package/src/routes/pagination.ts +51 -0
  470. package/src/routes/policies.ts +413 -0
  471. package/src/routes/projects.ts +634 -0
  472. package/src/routes/proposals.ts +719 -0
  473. package/src/routes/provenance.ts +406 -0
  474. package/src/routes/providers.ts +624 -0
  475. package/src/routes/public-run-tokens.ts +104 -0
  476. package/src/routes/retention.ts +193 -0
  477. package/src/routes/reviewers.ts +209 -0
  478. package/src/routes/runs.ts +892 -0
  479. package/src/routes/s3.ts +519 -0
  480. package/src/routes/schedules.ts +300 -0
  481. package/src/routes/scope-params.ts +133 -0
  482. package/src/routes/secret-ref.ts +52 -0
  483. package/src/routes/secrets.ts +975 -0
  484. package/src/routes/signing-keys.ts +259 -0
  485. package/src/routes/sse.ts +148 -0
  486. package/src/routes/teams.ts +584 -0
  487. package/src/routes/tenant.ts +530 -0
  488. package/src/routes/tokens.ts +285 -0
  489. package/src/routes/tools.ts +491 -0
  490. package/src/routes/webhook-endpoints.ts +534 -0
  491. package/src/routes/webhooks.ts +296 -0
  492. package/src/s3-credential-binding.ts +58 -0
  493. package/src/secrets-binding.ts +308 -0
  494. package/src/secrets-provider-binding.ts +167 -0
  495. package/src/session-store-binding.ts +163 -0
  496. package/src/signing-key-binding.ts +235 -0
  497. package/src/state-store-binding.ts +84 -0
  498. package/src/supervisor-binding.ts +554 -0
  499. package/src/tenant-host-access.ts +62 -0
  500. package/src/token-admin.ts +104 -0
  501. package/src/tool-binding.ts +274 -0
  502. package/src/trigger-binding.ts +38 -0
  503. package/src/types.ts +74 -0
  504. package/src/webhook-endpoint-binding.ts +246 -0
  505. package/src/xml.ts +196 -0
@@ -0,0 +1,38 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Copyright (C) 2026 Kindgi Inc.
3
+ /**
4
+ * Trivial in-memory store — appropriate for tests + single-process dev.
5
+ * Entries are single-use (`take` deletes on hit) and time out on their
6
+ * own; the store performs a shallow expired-entry sweep on every call
7
+ * so long-lived processes don't leak memory when a callback never
8
+ * arrives.
9
+ */
10
+ export function createInMemoryOauthStateStore() {
11
+ const entries = new Map();
12
+ const sweep = (now) => {
13
+ for (const [key, entry] of entries) {
14
+ if (entry.expiresAt <= now)
15
+ entries.delete(key);
16
+ }
17
+ };
18
+ return {
19
+ async put(entry) {
20
+ sweep(Date.now());
21
+ entries.set(entry.state, entry);
22
+ },
23
+ async take({ state, providerId }) {
24
+ const now = Date.now();
25
+ sweep(now);
26
+ const entry = entries.get(state);
27
+ if (entry === undefined)
28
+ return null;
29
+ if (providerId !== undefined && entry.providerId !== providerId)
30
+ return null;
31
+ entries.delete(state);
32
+ if (entry.expiresAt <= now)
33
+ return null;
34
+ return entry;
35
+ },
36
+ };
37
+ }
38
+ //# sourceMappingURL=state-store-binding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-store-binding.js","sourceRoot":"","sources":["../src/state-store-binding.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAkDjC;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,KAAK;YACb,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACrC,IAAI,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC7E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;gBAAE,OAAO,IAAI,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,526 @@
1
+ import type { Scope } from '@kindgi/platform';
2
+ import type { AgentId, ApprovalId, Cursor, FixProposalId, ObservationId, ProvenanceId, RunId, Semver, SupervisorId, TenantId, Timestamp } from '@kindgi/types';
3
+ /**
4
+ * Caller-plugged surface for the supervisor's fix-proposal lifecycle
5
+ * + observation readback. Same shape as
6
+ * `AgentRegistryBinding` / `MemoryBinding` / `ReviewerBinding`: the API
7
+ * package does NOT own supervisor runtime, agent registry, HITL wiring,
8
+ * or eval invocation. A binding implementation composes:
9
+ *
10
+ * - the supervisor runtime (draft, dry-run, submit for review, apply,
11
+ * roll back, withdraw, list / get proposals, query observations);
12
+ * - its `Supervisor` registry (`supervisorId → Supervisor`);
13
+ * - its agent registry (for the dry-run baseline lookup + `apply`);
14
+ * - its eval dataset + judge registries and an agent-invocation
15
+ * closure (all needed by the dry-run);
16
+ * - its HITL surface (submitting for review enqueues an approval —
17
+ * the binding surfaces the resulting `ApprovalId` back to the route
18
+ * so the response body carries it).
19
+ *
20
+ * Every proposal method is tenant-scoped AND supervisor-scoped: callers
21
+ * pass both `tenantId` and `supervisorId`. `supervisorId` comes from the
22
+ * `X-Supervisor-Id` request header — tenant flows from the token,
23
+ * supervisor is a per-request scope the caller supplies.
24
+ *
25
+ * State transitions are enforced by the supervisor runtime
26
+ * (`invalid-transition` domain error). The route layer surfaces those
27
+ * as `409 conflict` with error code
28
+ * `proposal-invalid-state-transition` — out-of-order lifecycle calls
29
+ * are caller/state conflicts.
30
+ *
31
+ * `queryObservations` is the supervisor readback for `/v1/observations`
32
+ * — a straight paginated list over the observation stream. Tenant-scoped
33
+ * only; `supervisorId` is an optional filter, not a mount-time scope.
34
+ */
35
+ export interface SupervisorBinding {
36
+ /**
37
+ * Cursor-paginated list of proposals scoped to `(tenantId,
38
+ * supervisorId)`. Filters:
39
+ * - `status` — single `FixProposalStatus` value.
40
+ * - `agentId` — exact match on target agent id.
41
+ * - `tier` — `'prompt' | 'retrieval' | 'tool-config'`.
42
+ *
43
+ * Sort order is binding-defined (for example `createdAt desc, id desc`).
44
+ */
45
+ listProposals(input: SupervisorListProposalsInput): Promise<SupervisorProposalPage>;
46
+ /**
47
+ * Get a proposal by id, or `null` when unknown. The route surfaces
48
+ * `null` as `404 proposal-not-found`. The binding MUST also return
49
+ * `null` when the proposal exists but is not owned by the caller's
50
+ * supervisor id — cross-supervisor reads leak tier boundaries the
51
+ * same way cross-tenant reads leak resource existence (avoid via
52
+ * `null → 404` per `docs/API-ROUTE-CONVENTIONS.md` §2.4).
53
+ */
54
+ getProposal(input: SupervisorGetProposalInput): Promise<FixProposal | null>;
55
+ /**
56
+ * Draft a new proposal in `draft` state. The dedup fingerprint is
57
+ * computed from `(tier, agentId, agentVersion, canonical(change))`;
58
+ * duplicate proposals short-circuit to the existing non-terminal row —
59
+ * discriminated on `SupervisorDraftOutcome.kind`.
60
+ */
61
+ draftProposal(input: SupervisorDraftProposalInput): Promise<SupervisorDraftOutcome>;
62
+ /**
63
+ * Trigger a dry-run for a proposal. A dry-run needs a dataset, judges,
64
+ * eval bindings and an agent-invocation closure — all of which the
65
+ * binding assembles from `input.datasetId` / `input.datasetVersion`
66
+ * and its own runtime wiring. Returns the updated proposal (`dry-run-passed` or
67
+ * `dry-run-failed`) or a discriminated error outcome so the route
68
+ * can map `invalid-transition` → `409` without touching the runtime
69
+ * error union directly.
70
+ */
71
+ dryRunProposal(input: SupervisorDryRunProposalInput): Promise<SupervisorDryRunOutcome>;
72
+ /**
73
+ * Submit an approved dry-run proposal for HITL review. The binding
74
+ * forwards the resolved `Supervisor` (for ground-layer enforcement +
75
+ * meta-fix detection) and enqueues the approval. Returns the updated proposal (in
76
+ * `proposed-for-review` state) plus the created approval id so the
77
+ * route can surface it in the response body (the SDK correlates
78
+ * proposal → approval via that id).
79
+ */
80
+ submitReview(input: SupervisorSubmitReviewInput): Promise<SupervisorSubmitReviewOutcome>;
81
+ /**
82
+ * Apply an `approved` proposal — registers a new agent version.
83
+ * Returns a minimal ack shape
84
+ * (`proposalId`, `appliedVersion`, `appliedAt`) rather than the
85
+ * full runtime result — the route body stays lean; callers who
86
+ * need the full `Agent` snapshot can `GET /v1/agents/:agentId`.
87
+ */
88
+ applyProposal(input: SupervisorApplyProposalInput): Promise<SupervisorApplyOutcome>;
89
+ /**
90
+ * Roll back an `applied` proposal — unregisters the applied
91
+ * version from the agent registry + transitions to `rolled-back`.
92
+ */
93
+ rollbackProposal(input: SupervisorRollbackProposalInput): Promise<SupervisorRollbackOutcome>;
94
+ /**
95
+ * Withdraw a non-terminal proposal. Legal from any of
96
+ * `draft | dry-running | dry-run-passed | dry-run-failed |
97
+ * proposed-for-review`. Terminal states surface as
98
+ * `invalid-transition` (which the route maps to 409).
99
+ */
100
+ withdrawProposal(input: SupervisorWithdrawProposalInput): Promise<SupervisorWithdrawOutcome>;
101
+ /**
102
+ * Cursor-paginated observation readback for `/v1/observations`.
103
+ * Tenant-scoped; supervisor/agent/conversation/time-window filters
104
+ * are optional. Returns a discriminated `err` outcome for the runtime
105
+ * failure paths
106
+ * (persistence + envelope decode); the route surfaces those via
107
+ * `statusFor(code)`.
108
+ */
109
+ queryObservations(input: SupervisorQueryObservationsInput): Promise<SupervisorQueryObservationsOutcome>;
110
+ }
111
+ export interface SupervisorListProposalsInput {
112
+ readonly tenantId: TenantId;
113
+ readonly supervisorId: SupervisorId;
114
+ readonly limit: number;
115
+ readonly cursor?: Cursor;
116
+ readonly status?: FixProposalStatus;
117
+ readonly agentId?: AgentId;
118
+ readonly tier?: ProposedChange['tier'];
119
+ /**
120
+ * Narrow the list to a specific scope. Absent = no scope narrow
121
+ * (return every row in the tenant the caller can see — admin/audit
122
+ * default).
123
+ *
124
+ * Content-scoped semantics (this binding — fix-proposals attribute
125
+ * to the project of the agent they target):
126
+ * - `{ kind: 'project', projectId }` — rows in that project.
127
+ * - `{ kind: 'org', orgId }` — rows in every project belonging to
128
+ * that org.
129
+ * - `{ kind: 'tenant', tenantId }` — every row in the tenant.
130
+ *
131
+ * Proposals are content: every row belongs to a project, so `inherit`
132
+ * has no effect here.
133
+ */
134
+ readonly scope?: Scope;
135
+ /**
136
+ * `false` = literal-at-this-scope only (admin/audit view).
137
+ * `true` (default) = inheritance walk (user-facing view).
138
+ * No-op for content-scoped bindings (rows only exist at
139
+ * project-level — there is no upward hierarchy to walk). Kept for
140
+ * uniformity: scope-aware bindings share one filter shape across the
141
+ * SDK and OpenAPI schemas.
142
+ */
143
+ readonly inherit?: boolean;
144
+ }
145
+ export interface SupervisorGetProposalInput {
146
+ readonly tenantId: TenantId;
147
+ readonly supervisorId: SupervisorId;
148
+ readonly proposalId: FixProposalId;
149
+ }
150
+ export interface SupervisorDraftProposalInput {
151
+ readonly tenantId: TenantId;
152
+ readonly supervisorId: SupervisorId;
153
+ readonly agentId: AgentId;
154
+ readonly agentVersion: string;
155
+ readonly tier: ProposedChange['tier'];
156
+ readonly change: ProposedChange['change'];
157
+ readonly patternRefs: readonly PatternRef[];
158
+ readonly hypothesis: string;
159
+ readonly proposerRuleId: string;
160
+ }
161
+ export interface SupervisorDryRunProposalInput {
162
+ readonly tenantId: TenantId;
163
+ readonly supervisorId: SupervisorId;
164
+ readonly proposalId: FixProposalId;
165
+ /**
166
+ * Dataset the binding uses for the dry-run.
167
+ * The wire carries just `(datasetId, datasetVersion)` — the binding
168
+ * resolves both to the actual `Dataset<TInput, TExpected>` from its
169
+ * own registry.
170
+ */
171
+ readonly datasetId: string;
172
+ readonly datasetVersion: string;
173
+ readonly criterion: PassCriterion;
174
+ }
175
+ export interface SupervisorSubmitReviewInput {
176
+ readonly tenantId: TenantId;
177
+ readonly supervisorId: SupervisorId;
178
+ readonly proposalId: FixProposalId;
179
+ readonly requiredRole?: 'standard' | 'senior' | 'admin';
180
+ readonly expiresAt?: Timestamp;
181
+ }
182
+ export interface SupervisorApplyProposalInput {
183
+ readonly tenantId: TenantId;
184
+ readonly supervisorId: SupervisorId;
185
+ readonly proposalId: FixProposalId;
186
+ readonly newVersion?: string;
187
+ }
188
+ export interface SupervisorRollbackProposalInput {
189
+ readonly tenantId: TenantId;
190
+ readonly supervisorId: SupervisorId;
191
+ readonly proposalId: FixProposalId;
192
+ readonly reason: string;
193
+ }
194
+ export interface SupervisorWithdrawProposalInput {
195
+ readonly tenantId: TenantId;
196
+ readonly supervisorId: SupervisorId;
197
+ readonly proposalId: FixProposalId;
198
+ readonly reason: string;
199
+ }
200
+ /**
201
+ * Observation readback filter. Tenant-scoped; every other filter is
202
+ * optional. `since` / `until` bound `observedAt`; `cursor` is an opaque
203
+ * ISO timestamp from a prior page's `nextCursor`. `limit` is clamped by
204
+ * the binding.
205
+ */
206
+ export interface SupervisorQueryObservationsInput {
207
+ readonly tenantId: TenantId;
208
+ readonly limit: number;
209
+ readonly cursor?: Cursor;
210
+ readonly status?: ObservationStatus;
211
+ readonly supervisorId?: SupervisorId;
212
+ readonly agentId?: AgentId;
213
+ readonly agentVersion?: Semver;
214
+ readonly conversationId?: RunId;
215
+ readonly since?: Timestamp;
216
+ readonly until?: Timestamp;
217
+ }
218
+ export interface SupervisorProposalPage {
219
+ readonly data: readonly FixProposal[];
220
+ readonly nextCursor?: Cursor;
221
+ }
222
+ /**
223
+ * Result of a draft attempt. Deduplication is by
224
+ * `(supervisorId, fingerprint)`:
225
+ *
226
+ * - `ok` — a new draft row was inserted.
227
+ * - `dedup` — an existing non-terminal proposal has the same
228
+ * fingerprint; caller can treat it as their own
229
+ * draft. `proposal` is the pre-existing row.
230
+ */
231
+ export type SupervisorDraftOutcome = {
232
+ readonly kind: 'ok';
233
+ readonly proposal: FixProposal;
234
+ } | {
235
+ readonly kind: 'dedup';
236
+ readonly proposal: FixProposal;
237
+ };
238
+ /**
239
+ * Result of a dry-run attempt. `ok` carries the updated proposal
240
+ * (either `dry-run-passed` or `dry-run-failed` — both are legitimate
241
+ * outcomes; `failed` means "the criterion was not met," not "the
242
+ * request errored"). Failure outcomes surface as discriminated errors
243
+ * the route layer maps to specific HTTP statuses.
244
+ */
245
+ export type SupervisorDryRunOutcome = {
246
+ readonly kind: 'ok';
247
+ readonly proposal: FixProposal;
248
+ readonly passed: boolean;
249
+ } | {
250
+ readonly kind: 'not-found';
251
+ readonly proposalId: FixProposalId;
252
+ } | {
253
+ readonly kind: 'invalid-transition';
254
+ readonly proposalId: FixProposalId;
255
+ readonly from: FixProposalStatus;
256
+ readonly to: FixProposalStatus;
257
+ } | {
258
+ /**
259
+ * Wire back `apply-change-failed` (change couldn't be applied
260
+ * against the current baseline), `baseline-mismatch` (proposal
261
+ * targets a stale version), or any other runtime failure. The
262
+ * route maps the code through `statusFor`: the two named codes are
263
+ * `422 unprocessable` (the request was well-formed but the domain
264
+ * state prevents dry-running); unknown codes are `500`.
265
+ */
266
+ readonly kind: 'runtime-error';
267
+ readonly code: string;
268
+ readonly message: string;
269
+ };
270
+ export type SupervisorSubmitReviewOutcome = {
271
+ readonly kind: 'ok';
272
+ readonly proposal: FixProposal;
273
+ readonly approvalId: ApprovalId;
274
+ readonly metaFix: boolean;
275
+ } | {
276
+ readonly kind: 'not-found';
277
+ readonly proposalId: FixProposalId;
278
+ } | {
279
+ readonly kind: 'invalid-transition';
280
+ readonly proposalId: FixProposalId;
281
+ readonly from: FixProposalStatus;
282
+ readonly to: FixProposalStatus;
283
+ } | {
284
+ readonly kind: 'ground-layer-violation';
285
+ readonly proposalId: FixProposalId;
286
+ readonly guardrailId: string;
287
+ readonly reason: string;
288
+ } | {
289
+ readonly kind: 'runtime-error';
290
+ readonly code: string;
291
+ readonly message: string;
292
+ };
293
+ export type SupervisorApplyOutcome = {
294
+ readonly kind: 'ok';
295
+ readonly proposalId: FixProposalId;
296
+ readonly appliedVersion: string;
297
+ readonly appliedAt: Timestamp;
298
+ } | {
299
+ readonly kind: 'not-found';
300
+ readonly proposalId: FixProposalId;
301
+ } | {
302
+ readonly kind: 'invalid-transition';
303
+ readonly proposalId: FixProposalId;
304
+ readonly from: FixProposalStatus;
305
+ readonly to: FixProposalStatus;
306
+ } | {
307
+ readonly kind: 'runtime-error';
308
+ readonly code: string;
309
+ readonly message: string;
310
+ };
311
+ export type SupervisorRollbackOutcome = {
312
+ readonly kind: 'ok';
313
+ readonly proposalId: FixProposalId;
314
+ readonly rolledBackAt: Timestamp;
315
+ } | {
316
+ readonly kind: 'not-found';
317
+ readonly proposalId: FixProposalId;
318
+ } | {
319
+ readonly kind: 'invalid-transition';
320
+ readonly proposalId: FixProposalId;
321
+ readonly from: FixProposalStatus;
322
+ readonly to: FixProposalStatus;
323
+ } | {
324
+ readonly kind: 'runtime-error';
325
+ readonly code: string;
326
+ readonly message: string;
327
+ };
328
+ export type SupervisorWithdrawOutcome = {
329
+ readonly kind: 'ok';
330
+ readonly proposal: FixProposal;
331
+ } | {
332
+ readonly kind: 'not-found';
333
+ readonly proposalId: FixProposalId;
334
+ } | {
335
+ readonly kind: 'invalid-transition';
336
+ readonly proposalId: FixProposalId;
337
+ readonly from: FixProposalStatus;
338
+ readonly to: FixProposalStatus;
339
+ } | {
340
+ readonly kind: 'runtime-error';
341
+ readonly code: string;
342
+ readonly message: string;
343
+ };
344
+ export interface SupervisorObservationPage {
345
+ readonly data: readonly Observation[];
346
+ readonly nextCursor?: Cursor;
347
+ }
348
+ export type SupervisorQueryObservationsOutcome = {
349
+ readonly kind: 'ok';
350
+ readonly page: SupervisorObservationPage;
351
+ } | {
352
+ readonly kind: 'runtime-error';
353
+ readonly code: string;
354
+ readonly message: string;
355
+ };
356
+ /**
357
+ * Lifecycle of a fix proposal.
358
+ *
359
+ * `draft` — initial state after `POST /v1/proposals`.
360
+ * `dry-running` — transient state while a dry-run executes.
361
+ * `dry-run-passed` / `dry-run-failed` — dry-run terminated with a
362
+ * criterion result. `failed` is a legitimate domain outcome, not an
363
+ * error.
364
+ * `proposed-for-review` — submitted for HITL. `reviewApprovalId` is set.
365
+ * `approved` / `rejected` — HITL terminal states.
366
+ * `applied` — the change materialized. `appliedVersion` + `appliedAt` set.
367
+ * `rolled-back` — a prior `applied` proposal was undone.
368
+ * `withdrawn` — the caller withdrew the proposal before terminal review.
369
+ */
370
+ export type FixProposalStatus = 'draft' | 'dry-running' | 'dry-run-passed' | 'dry-run-failed' | 'proposed-for-review' | 'approved' | 'rejected' | 'applied' | 'rolled-back' | 'withdrawn';
371
+ /** The aggregated fingerprint kind for a failure pattern. */
372
+ export type PatternKind = 'guardrail-violation' | 'tool-error' | 'budget-exceeded' | 'model-error' | 'aborted';
373
+ /**
374
+ * A change to an agent's prompt (the `instructions` string). Three
375
+ * kinds cover the common shapes. Extensible via the `kind` discriminant.
376
+ */
377
+ export type PromptChange = {
378
+ readonly kind: 'append';
379
+ readonly text: string;
380
+ } | {
381
+ readonly kind: 'replace-section';
382
+ readonly section: string;
383
+ readonly newText: string;
384
+ } | {
385
+ readonly kind: 'replace';
386
+ readonly beforeText: string;
387
+ readonly afterText: string;
388
+ };
389
+ /**
390
+ * A retrieval intent — mirror of `Agent.retrieval[]` shape.
391
+ */
392
+ export interface RetrievalIntentShape {
393
+ readonly types: readonly string[];
394
+ readonly scope: 'same-conversation' | 'same-project' | 'tenant';
395
+ readonly limit?: number;
396
+ }
397
+ export type RetrievalChange = {
398
+ readonly kind: 'add-intent';
399
+ readonly intent: RetrievalIntentShape;
400
+ } | {
401
+ readonly kind: 'remove-intent';
402
+ readonly index: number;
403
+ } | {
404
+ readonly kind: 'replace-intent';
405
+ readonly index: number;
406
+ readonly intent: RetrievalIntentShape;
407
+ } | {
408
+ readonly kind: 'update-limit';
409
+ readonly index: number;
410
+ readonly limit: number;
411
+ };
412
+ export type ToolConfigChange = {
413
+ readonly kind: 'add-tool';
414
+ readonly toolId: string;
415
+ readonly toolVersion: string;
416
+ } | {
417
+ readonly kind: 'remove-tool';
418
+ readonly toolId: string;
419
+ } | {
420
+ readonly kind: 'set-tools';
421
+ readonly tools: readonly {
422
+ readonly id: string;
423
+ readonly version: string;
424
+ }[];
425
+ };
426
+ /**
427
+ * The change payload — polymorphic over tier.
428
+ */
429
+ export type ProposedChange = {
430
+ readonly tier: 'prompt';
431
+ readonly change: PromptChange;
432
+ } | {
433
+ readonly tier: 'retrieval';
434
+ readonly change: RetrievalChange;
435
+ } | {
436
+ readonly tier: 'tool-config';
437
+ readonly change: ToolConfigChange;
438
+ };
439
+ /**
440
+ * A reference to a failure pattern that motivated a proposal.
441
+ */
442
+ export interface PatternRef {
443
+ readonly kind: PatternKind;
444
+ readonly key: string;
445
+ readonly count: number;
446
+ readonly firstSeenAt: Timestamp;
447
+ readonly lastSeenAt: Timestamp;
448
+ readonly sampleConversations: readonly RunId[];
449
+ }
450
+ /**
451
+ * A fix proposal drafted by the supervisor. Every field is declared here
452
+ * so the API package does not depend on the supervisor runtime's types.
453
+ */
454
+ export interface FixProposal {
455
+ readonly id: FixProposalId;
456
+ readonly tenantId: TenantId;
457
+ readonly supervisorId: SupervisorId;
458
+ readonly agentId: AgentId;
459
+ readonly agentVersion: string;
460
+ readonly tier: ProposedChange['tier'];
461
+ readonly change: ProposedChange['change'];
462
+ readonly patternRefs: readonly PatternRef[];
463
+ readonly hypothesis: string;
464
+ readonly proposerRuleId: string;
465
+ readonly status: FixProposalStatus;
466
+ readonly fingerprint: string;
467
+ readonly resolutionReason?: string;
468
+ readonly reviewApprovalId?: ApprovalId;
469
+ readonly appliedVersion?: string;
470
+ readonly appliedAt?: Timestamp;
471
+ readonly rolledBackAt?: Timestamp;
472
+ readonly createdAt: Timestamp;
473
+ readonly updatedAt: Timestamp;
474
+ readonly resolvedAt?: Timestamp;
475
+ }
476
+ /** Dry-run pass criterion. */
477
+ export type PassCriterion = {
478
+ readonly kind: 'min-pass-rate';
479
+ readonly minPassRate: number;
480
+ } | {
481
+ readonly kind: 'strict-improvement';
482
+ readonly baselinePassRate: number;
483
+ readonly minDelta: number;
484
+ };
485
+ /**
486
+ * Classified outcome of an observed turn. The observations route
487
+ * validates the query param against this union.
488
+ */
489
+ export type ObservationStatus = 'succeeded' | 'guardrail-violation' | 'guardrail-warning' | 'tool-error' | 'model-error' | 'budget-exceeded' | 'aborted' | 'other';
490
+ export interface ObservedViolation {
491
+ readonly guardrailId: string;
492
+ readonly action: string;
493
+ readonly severity: string;
494
+ readonly passed: boolean;
495
+ readonly reason?: string;
496
+ }
497
+ /**
498
+ * Wire shape of a supervisor observation — the atomic unit persisted
499
+ * per observed agent turn. Serialized 1:1 into the `/v1/observations`
500
+ * response body.
501
+ */
502
+ export interface Observation {
503
+ readonly id: ObservationId;
504
+ readonly tenantId: TenantId;
505
+ readonly supervisorId: SupervisorId;
506
+ readonly agentId: AgentId;
507
+ readonly agentVersion: string;
508
+ readonly conversationId: RunId;
509
+ readonly turnNumber: number;
510
+ readonly status: ObservationStatus;
511
+ readonly failureCode?: string;
512
+ readonly violations: readonly ObservedViolation[];
513
+ readonly failureDetail?: Readonly<Record<string, unknown>>;
514
+ readonly durationMs: number;
515
+ readonly costUsd: string;
516
+ readonly provider?: {
517
+ readonly id: string;
518
+ readonly model: string;
519
+ };
520
+ readonly provenanceRef?: {
521
+ readonly runId: RunId;
522
+ readonly provenanceId?: ProvenanceId;
523
+ };
524
+ readonly observedAt: Timestamp;
525
+ }
526
+ //# sourceMappingURL=supervisor-binding.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor-binding.d.ts","sourceRoot":"","sources":["../src/supervisor-binding.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Copyright (C) 2026 Kindgi Inc.
3
+ export {};
4
+ //# sourceMappingURL=supervisor-binding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor-binding.js","sourceRoot":"","sources":["../src/supervisor-binding.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * How far tenant configuration may reach into the server's own host:
3
+ * `KINDGI_TENANT_HOST_ACCESS`. A token holder registers things (MCP
4
+ * endpoints, providers, webhooks) the server then acts on; some of them
5
+ * can act on the host itself, which only a single-user machine should
6
+ * allow.
7
+ *
8
+ * - `local` (the default under `KINDGI_DEV`): a developer's machine.
9
+ * Tenant configuration may run commands on the host.
10
+ * - `deployed` (the default otherwise): a stdio MCP endpoint, which
11
+ * runs its command in the server's container as the server's user,
12
+ * is refused at registration and at connect; and the server's
13
+ * outbound calls to hosts a tenant chose (an MCP endpoint, a model
14
+ * provider's base URL, an HTTP tool, an image registry) refuse the
15
+ * cloud metadata endpoints and the server's own host.
16
+ *
17
+ * Checks ask `deniesHostReach(level, reach)`, never compare levels, so a
18
+ * stricter level (or a new kind of reach) is one more row or entry here.
19
+ */
20
+ /** The levels, least strict first. */
21
+ export declare const TENANT_HOST_ACCESS_LEVELS: readonly ["local", "deployed"];
22
+ export type TenantHostAccess = (typeof TENANT_HOST_ACCESS_LEVELS)[number];
23
+ /** What tenant configuration can make the server do on its own host. */
24
+ export type HostReach =
25
+ /** Run a command: a `stdio` MCP endpoint. */
26
+ 'exec'
27
+ /**
28
+ * Connect to a link-local address (169.254.0.0/16, fe80::/10,
29
+ * fd00:ec2::254), where the cloud metadata endpoints hand out the
30
+ * server's own credentials.
31
+ */
32
+ | 'metadata-network'
33
+ /** Connect to the server's own host: 127.0.0.0/8, ::1, 0.0.0.0/8, `::`. */
34
+ | 'loopback';
35
+ /** Whether `level` refuses tenant configuration that needs `reach`. */
36
+ export declare function deniesHostReach(level: TenantHostAccess, reach: HostReach): boolean;
37
+ /** `value` as a level, or `undefined` when it isn't one. */
38
+ export declare function parseTenantHostAccess(value: string): TenantHostAccess | undefined;
39
+ /** Why a stdio MCP endpoint is refused, the same at registration and at connect. */
40
+ export declare function stdioRefusal(endpointId: string): string;
41
+ //# sourceMappingURL=tenant-host-access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tenant-host-access.d.ts","sourceRoot":"","sources":["../src/tenant-host-access.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,sCAAsC;AACtC,eAAO,MAAM,yBAAyB,gCAAiC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,wEAAwE;AACxE,MAAM,MAAM,SAAS;AACnB,6CAA6C;AAC3C,MAAM;AACR;;;;GAIG;GACD,kBAAkB;AACpB,2EAA2E;GACzE,UAAU,CAAC;AAOf,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAElF;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAIjF;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD"}