@nexum-hub/agent 0.0.0-stage → 0.0.2

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 (343) hide show
  1. package/README.md +133 -2
  2. package/contracts/v2/common.schema.json +262 -0
  3. package/contracts/v2/fixtures/inputs.json +244 -0
  4. package/contracts/v2/fixtures/wire.json +6493 -0
  5. package/contracts/v2/model/agent.close.input.schema.json +14 -0
  6. package/contracts/v2/model/agent.close.output.schema.json +101 -0
  7. package/contracts/v2/model/agent.list.input.schema.json +57 -0
  8. package/contracts/v2/model/agent.list.output.schema.json +220 -0
  9. package/contracts/v2/model/agent.open.input.schema.json +35 -0
  10. package/contracts/v2/model/agent.open.output.schema.json +41 -0
  11. package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
  12. package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
  13. package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
  14. package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
  15. package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
  16. package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
  17. package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
  18. package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
  19. package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
  20. package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
  21. package/contracts/v2/wire/bodies.schema.json +383 -0
  22. package/contracts/v2/wire/envelope.schema.json +2280 -0
  23. package/contracts/v2/wire/events.schema.json +242 -0
  24. package/contracts/v2/wire/maintenance.schema.json +308 -0
  25. package/contracts/v2/wire/operations.schema.json +1791 -0
  26. package/contracts/v2/wire/stream.schema.json +74 -0
  27. package/contracts/v2/wire/types.schema.json +2616 -0
  28. package/dist/adapters/mcp-http.d.ts +22 -0
  29. package/dist/adapters/mcp-http.js +472 -0
  30. package/dist/adapters/mcp-http.js.map +1 -0
  31. package/dist/adapters/mcp-oauth.d.ts +29 -0
  32. package/dist/adapters/mcp-oauth.js +653 -0
  33. package/dist/adapters/mcp-oauth.js.map +1 -0
  34. package/dist/adapters/mcp-wire.d.ts +21 -0
  35. package/dist/adapters/mcp-wire.js +307 -0
  36. package/dist/adapters/mcp-wire.js.map +1 -0
  37. package/dist/adapters/mcp.d.ts +56 -0
  38. package/dist/adapters/mcp.js +1989 -0
  39. package/dist/adapters/mcp.js.map +1 -0
  40. package/dist/adapters/openapi-http.d.ts +29 -0
  41. package/dist/adapters/openapi-http.js +504 -0
  42. package/dist/adapters/openapi-http.js.map +1 -0
  43. package/dist/adapters/openapi-request.d.ts +26 -0
  44. package/dist/adapters/openapi-request.js +597 -0
  45. package/dist/adapters/openapi-request.js.map +1 -0
  46. package/dist/adapters/openapi-schema.d.ts +22 -0
  47. package/dist/adapters/openapi-schema.js +471 -0
  48. package/dist/adapters/openapi-schema.js.map +1 -0
  49. package/dist/adapters/openapi-typegen.d.ts +11 -0
  50. package/dist/adapters/openapi-typegen.js +185 -0
  51. package/dist/adapters/openapi-typegen.js.map +1 -0
  52. package/dist/adapters/openapi-types.d.ts +99 -0
  53. package/dist/adapters/openapi-types.js +2 -0
  54. package/dist/adapters/openapi-types.js.map +1 -0
  55. package/dist/adapters/openapi.d.ts +7 -0
  56. package/dist/adapters/openapi.js +768 -0
  57. package/dist/adapters/openapi.js.map +1 -0
  58. package/dist/application/activation.d.ts +28 -0
  59. package/dist/application/activation.js +289 -0
  60. package/dist/application/activation.js.map +1 -0
  61. package/dist/application/attachments.d.ts +24 -0
  62. package/dist/application/attachments.js +87 -0
  63. package/dist/application/attachments.js.map +1 -0
  64. package/dist/application/authority.d.ts +32 -0
  65. package/dist/application/authority.js +213 -0
  66. package/dist/application/authority.js.map +1 -0
  67. package/dist/application/catalog.d.ts +11 -0
  68. package/dist/application/catalog.js +177 -0
  69. package/dist/application/catalog.js.map +1 -0
  70. package/dist/application/config.d.ts +24 -0
  71. package/dist/application/config.js +140 -0
  72. package/dist/application/config.js.map +1 -0
  73. package/dist/application/connection.d.ts +35 -0
  74. package/dist/application/connection.js +465 -0
  75. package/dist/application/connection.js.map +1 -0
  76. package/dist/application/data-plane.d.ts +35 -0
  77. package/dist/application/data-plane.js +437 -0
  78. package/dist/application/data-plane.js.map +1 -0
  79. package/dist/application/diagnostics.d.ts +4 -0
  80. package/dist/application/diagnostics.js +65 -0
  81. package/dist/application/diagnostics.js.map +1 -0
  82. package/dist/application/dispatcher.d.ts +4 -0
  83. package/dist/application/dispatcher.js +16 -0
  84. package/dist/application/dispatcher.js.map +1 -0
  85. package/dist/application/main.d.ts +12 -0
  86. package/dist/application/main.js +167 -0
  87. package/dist/application/main.js.map +1 -0
  88. package/dist/application/maintenance.d.ts +27 -0
  89. package/dist/application/maintenance.js +244 -0
  90. package/dist/application/maintenance.js.map +1 -0
  91. package/dist/application/packages.d.ts +25 -0
  92. package/dist/application/packages.js +208 -0
  93. package/dist/application/packages.js.map +1 -0
  94. package/dist/application/processes.d.ts +49 -0
  95. package/dist/application/processes.js +180 -0
  96. package/dist/application/processes.js.map +1 -0
  97. package/dist/application/run-view.d.ts +17 -0
  98. package/dist/application/run-view.js +286 -0
  99. package/dist/application/run-view.js.map +1 -0
  100. package/dist/application/runtime.d.ts +78 -0
  101. package/dist/application/runtime.js +1747 -0
  102. package/dist/application/runtime.js.map +1 -0
  103. package/dist/application/tasks.d.ts +38 -0
  104. package/dist/application/tasks.js +23 -0
  105. package/dist/application/tasks.js.map +1 -0
  106. package/dist/application/user-state.d.ts +20 -0
  107. package/dist/application/user-state.js +52 -0
  108. package/dist/application/user-state.js.map +1 -0
  109. package/dist/application/work-git.d.ts +14 -0
  110. package/dist/application/work-git.js +67 -0
  111. package/dist/application/work-git.js.map +1 -0
  112. package/dist/cli.d.ts +2 -0
  113. package/dist/cli.js +40 -0
  114. package/dist/cli.js.map +1 -0
  115. package/dist/contracts/caller.d.ts +51 -0
  116. package/dist/contracts/caller.js +95 -0
  117. package/dist/contracts/caller.js.map +1 -0
  118. package/dist/contracts/error-data.d.ts +6 -0
  119. package/dist/contracts/error-data.js +51 -0
  120. package/dist/contracts/error-data.js.map +1 -0
  121. package/dist/contracts/errors.d.ts +10 -0
  122. package/dist/contracts/errors.js +28 -0
  123. package/dist/contracts/errors.js.map +1 -0
  124. package/dist/contracts/json.d.ts +9 -0
  125. package/dist/contracts/json.js +104 -0
  126. package/dist/contracts/json.js.map +1 -0
  127. package/dist/contracts/types.d.ts +122 -0
  128. package/dist/contracts/types.js +19 -0
  129. package/dist/contracts/types.js.map +1 -0
  130. package/dist/contracts/validation.d.ts +4 -0
  131. package/dist/contracts/validation.js +157 -0
  132. package/dist/contracts/validation.js.map +1 -0
  133. package/dist/contracts/wire-validation.d.ts +9 -0
  134. package/dist/contracts/wire-validation.js +399 -0
  135. package/dist/contracts/wire-validation.js.map +1 -0
  136. package/dist/contracts/wire.d.ts +1083 -0
  137. package/dist/contracts/wire.js +62 -0
  138. package/dist/contracts/wire.js.map +1 -0
  139. package/dist/extension-api.d.ts +12 -0
  140. package/dist/extension-api.js +2 -0
  141. package/dist/extension-api.js.map +1 -0
  142. package/dist/extensions/api.d.ts +72 -0
  143. package/dist/extensions/api.js +2 -0
  144. package/dist/extensions/api.js.map +1 -0
  145. package/dist/extensions/host-requests.d.ts +23 -0
  146. package/dist/extensions/host-requests.js +60 -0
  147. package/dist/extensions/host-requests.js.map +1 -0
  148. package/dist/extensions/materials.d.ts +37 -0
  149. package/dist/extensions/materials.js +691 -0
  150. package/dist/extensions/materials.js.map +1 -0
  151. package/dist/extensions/package-loader.d.ts +28 -0
  152. package/dist/extensions/package-loader.js +177 -0
  153. package/dist/extensions/package-loader.js.map +1 -0
  154. package/dist/extensions/packages.d.ts +73 -0
  155. package/dist/extensions/packages.js +441 -0
  156. package/dist/extensions/packages.js.map +1 -0
  157. package/dist/extensions/registry.d.ts +92 -0
  158. package/dist/extensions/registry.js +1540 -0
  159. package/dist/extensions/registry.js.map +1 -0
  160. package/dist/extensions/resources.d.ts +105 -0
  161. package/dist/extensions/resources.js +595 -0
  162. package/dist/extensions/resources.js.map +1 -0
  163. package/dist/extensions/state.d.ts +25 -0
  164. package/dist/extensions/state.js +10 -0
  165. package/dist/extensions/state.js.map +1 -0
  166. package/dist/extensions/transfer.d.ts +81 -0
  167. package/dist/extensions/transfer.js +16 -0
  168. package/dist/extensions/transfer.js.map +1 -0
  169. package/dist/index.d.ts +7 -0
  170. package/dist/index.js +25 -0
  171. package/dist/index.js.map +1 -0
  172. package/dist/maintenance/configuration.d.ts +79 -0
  173. package/dist/maintenance/configuration.js +1503 -0
  174. package/dist/maintenance/configuration.js.map +1 -0
  175. package/dist/maintenance/credentials.d.ts +23 -0
  176. package/dist/maintenance/credentials.js +177 -0
  177. package/dist/maintenance/credentials.js.map +1 -0
  178. package/dist/maintenance/files.d.ts +2 -0
  179. package/dist/maintenance/files.js +40 -0
  180. package/dist/maintenance/files.js.map +1 -0
  181. package/dist/maintenance/npm.d.ts +71 -0
  182. package/dist/maintenance/npm.js +1013 -0
  183. package/dist/maintenance/npm.js.map +1 -0
  184. package/dist/maintenance/oauth.d.ts +45 -0
  185. package/dist/maintenance/oauth.js +686 -0
  186. package/dist/maintenance/oauth.js.map +1 -0
  187. package/dist/maintenance/requests.d.ts +347 -0
  188. package/dist/maintenance/requests.js +959 -0
  189. package/dist/maintenance/requests.js.map +1 -0
  190. package/dist/maintenance/work-git.d.ts +29 -0
  191. package/dist/maintenance/work-git.js +776 -0
  192. package/dist/maintenance/work-git.js.map +1 -0
  193. package/dist/process/backend.d.ts +54 -0
  194. package/dist/process/backend.js +39 -0
  195. package/dist/process/backend.js.map +1 -0
  196. package/dist/process/environment-windows.d.ts +15 -0
  197. package/dist/process/environment-windows.js +151 -0
  198. package/dist/process/environment-windows.js.map +1 -0
  199. package/dist/process/environment.d.ts +28 -0
  200. package/dist/process/environment.js +410 -0
  201. package/dist/process/environment.js.map +1 -0
  202. package/dist/process/launch.d.ts +31 -0
  203. package/dist/process/launch.js +281 -0
  204. package/dist/process/launch.js.map +1 -0
  205. package/dist/process/managed.d.ts +36 -0
  206. package/dist/process/managed.js +459 -0
  207. package/dist/process/managed.js.map +1 -0
  208. package/dist/process/output-log.d.ts +50 -0
  209. package/dist/process/output-log.js +552 -0
  210. package/dist/process/output-log.js.map +1 -0
  211. package/dist/process/pipes.d.ts +16 -0
  212. package/dist/process/pipes.js +588 -0
  213. package/dist/process/pipes.js.map +1 -0
  214. package/dist/process/pty.d.ts +22 -0
  215. package/dist/process/pty.js +512 -0
  216. package/dist/process/pty.js.map +1 -0
  217. package/dist/process/windows-conout-worker.d.ts +1 -0
  218. package/dist/process/windows-conout-worker.js +90 -0
  219. package/dist/process/windows-conout-worker.js.map +1 -0
  220. package/dist/process/windows-conout.d.ts +46 -0
  221. package/dist/process/windows-conout.js +140 -0
  222. package/dist/process/windows-conout.js.map +1 -0
  223. package/dist/process/windows-helper.d.ts +43 -0
  224. package/dist/process/windows-helper.js +255 -0
  225. package/dist/process/windows-helper.js.map +1 -0
  226. package/dist/process/windows-job.d.ts +39 -0
  227. package/dist/process/windows-job.js +224 -0
  228. package/dist/process/windows-job.js.map +1 -0
  229. package/dist/process/windows-pipes.d.ts +16 -0
  230. package/dist/process/windows-pipes.js +475 -0
  231. package/dist/process/windows-pipes.js.map +1 -0
  232. package/dist/results/artifacts.d.ts +118 -0
  233. package/dist/results/artifacts.js +873 -0
  234. package/dist/results/artifacts.js.map +1 -0
  235. package/dist/results/encoder.d.ts +57 -0
  236. package/dist/results/encoder.js +1179 -0
  237. package/dist/results/encoder.js.map +1 -0
  238. package/dist/results/mcp.d.ts +95 -0
  239. package/dist/results/mcp.js +656 -0
  240. package/dist/results/mcp.js.map +1 -0
  241. package/dist/results/media.d.ts +19 -0
  242. package/dist/results/media.js +301 -0
  243. package/dist/results/media.js.map +1 -0
  244. package/dist/results/normalize.d.ts +29 -0
  245. package/dist/results/normalize.js +464 -0
  246. package/dist/results/normalize.js.map +1 -0
  247. package/dist/runtime/control-scripts.d.ts +23 -0
  248. package/dist/runtime/control-scripts.js +242 -0
  249. package/dist/runtime/control-scripts.js.map +1 -0
  250. package/dist/runtime/engine.d.ts +177 -0
  251. package/dist/runtime/engine.js +1159 -0
  252. package/dist/runtime/engine.js.map +1 -0
  253. package/dist/runtime/globals.d.ts +1 -0
  254. package/dist/runtime/globals.js +31 -0
  255. package/dist/runtime/globals.js.map +1 -0
  256. package/dist/runtime/material-retention.d.ts +34 -0
  257. package/dist/runtime/material-retention.js +671 -0
  258. package/dist/runtime/material-retention.js.map +1 -0
  259. package/dist/runtime/modules.d.ts +50 -0
  260. package/dist/runtime/modules.js +320 -0
  261. package/dist/runtime/modules.js.map +1 -0
  262. package/dist/runtime/names.d.ts +2 -0
  263. package/dist/runtime/names.js +22 -0
  264. package/dist/runtime/names.js.map +1 -0
  265. package/dist/runtime/operations.d.ts +20 -0
  266. package/dist/runtime/operations.js +137 -0
  267. package/dist/runtime/operations.js.map +1 -0
  268. package/dist/runtime/paths.d.ts +3 -0
  269. package/dist/runtime/paths.js +38 -0
  270. package/dist/runtime/paths.js.map +1 -0
  271. package/dist/runtime/promises.d.ts +9 -0
  272. package/dist/runtime/promises.js +78 -0
  273. package/dist/runtime/promises.js.map +1 -0
  274. package/dist/runtime/retention.d.ts +88 -0
  275. package/dist/runtime/retention.js +735 -0
  276. package/dist/runtime/retention.js.map +1 -0
  277. package/dist/runtime/run-log.d.ts +30 -0
  278. package/dist/runtime/run-log.js +207 -0
  279. package/dist/runtime/run-log.js.map +1 -0
  280. package/dist/runtime/scripts.d.ts +84 -0
  281. package/dist/runtime/scripts.js +387 -0
  282. package/dist/runtime/scripts.js.map +1 -0
  283. package/dist/runtime/tasks.d.ts +54 -0
  284. package/dist/runtime/tasks.js +290 -0
  285. package/dist/runtime/tasks.js.map +1 -0
  286. package/dist/sdk/maintenance.d.ts +3 -0
  287. package/dist/sdk/maintenance.js +80 -0
  288. package/dist/sdk/maintenance.js.map +1 -0
  289. package/dist/sdk/output-extension.d.ts +3 -0
  290. package/dist/sdk/output-extension.js +44 -0
  291. package/dist/sdk/output-extension.js.map +1 -0
  292. package/dist/sdk/output.d.ts +52 -0
  293. package/dist/sdk/output.js +350 -0
  294. package/dist/sdk/output.js.map +1 -0
  295. package/dist/sdk/runtime.d.ts +3 -0
  296. package/dist/sdk/runtime.js +26 -0
  297. package/dist/sdk/runtime.js.map +1 -0
  298. package/dist/sdk/sh.d.ts +3 -0
  299. package/dist/sdk/sh.js +384 -0
  300. package/dist/sdk/sh.js.map +1 -0
  301. package/dist/sdk/state.d.ts +2 -0
  302. package/dist/sdk/state.js +69 -0
  303. package/dist/sdk/state.js.map +1 -0
  304. package/dist/sdk/transfer.d.ts +3 -0
  305. package/dist/sdk/transfer.js +141 -0
  306. package/dist/sdk/transfer.js.map +1 -0
  307. package/dist/services/extensions.d.ts +19 -0
  308. package/dist/services/extensions.js +183 -0
  309. package/dist/services/extensions.js.map +1 -0
  310. package/dist/services/state.d.ts +37 -0
  311. package/dist/services/state.js +125 -0
  312. package/dist/services/state.js.map +1 -0
  313. package/dist/services/transfer.d.ts +86 -0
  314. package/dist/services/transfer.js +948 -0
  315. package/dist/services/transfer.js.map +1 -0
  316. package/dist/storage/schema.d.ts +8 -0
  317. package/dist/storage/schema.js +241 -0
  318. package/dist/storage/schema.js.map +1 -0
  319. package/dist/storage/sqlite.d.ts +241 -0
  320. package/dist/storage/sqlite.js +1855 -0
  321. package/dist/storage/sqlite.js.map +1 -0
  322. package/dist/storage/transfers.d.ts +90 -0
  323. package/dist/storage/transfers.js +2 -0
  324. package/dist/storage/transfers.js.map +1 -0
  325. package/dist/transfer/io.d.ts +74 -0
  326. package/dist/transfer/io.js +425 -0
  327. package/dist/transfer/io.js.map +1 -0
  328. package/dist/transfer/offers.d.ts +72 -0
  329. package/dist/transfer/offers.js +380 -0
  330. package/dist/transfer/offers.js.map +1 -0
  331. package/dist/transfer/stream-slots.d.ts +12 -0
  332. package/dist/transfer/stream-slots.js +28 -0
  333. package/dist/transfer/stream-slots.js.map +1 -0
  334. package/dist/work/catalog.d.ts +43 -0
  335. package/dist/work/catalog.js +198 -0
  336. package/dist/work/catalog.js.map +1 -0
  337. package/dist/work/discovery.d.ts +70 -0
  338. package/dist/work/discovery.js +465 -0
  339. package/dist/work/discovery.js.map +1 -0
  340. package/dist/work/service.d.ts +83 -0
  341. package/dist/work/service.js +703 -0
  342. package/dist/work/service.js.map +1 -0
  343. package/package.json +66 -4
@@ -0,0 +1,437 @@
1
+ import { createHash } from "node:crypto";
2
+ import { request as httpRequest, } from "node:http";
3
+ import { request as httpsRequest } from "node:https";
4
+ import { Readable, Transform } from "node:stream";
5
+ import { pipeline } from "node:stream/promises";
6
+ import { MIMEType } from "node:util";
7
+ import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
8
+ import { authorizeCall } from "../contracts/caller.js";
9
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
10
+ import { validateAgentToken, validateServerUrl } from "./config.js";
11
+ const identity = /^[A-Za-z0-9_-]{1,256}$/;
12
+ const headerIdentity = /^[\x21-\x7e]{1,256}$/;
13
+ const directions = {
14
+ resource: ["agent-to-cloud"],
15
+ attachment: ["cloud-to-agent"],
16
+ transfer: ["agent-to-cloud", "cloud-to-agent"],
17
+ "host-request": ["agent-to-cloud"],
18
+ "host-response": ["cloud-to-agent"],
19
+ "result-meta": ["agent-to-cloud"],
20
+ maintenance: ["agent-to-cloud", "cloud-to-agent"],
21
+ };
22
+ const refKeys = new Set([
23
+ "streamId",
24
+ "purpose",
25
+ "direction",
26
+ "expiresAt",
27
+ "maxBytes",
28
+ "mimeType",
29
+ "size",
30
+ "sha256",
31
+ ]);
32
+ function plainData(value, allowed) {
33
+ return (isPlainRecord(value) &&
34
+ Reflect.ownKeys(value).every((key) => typeof key === "string" &&
35
+ allowed.has(key) &&
36
+ "value" in Object.getOwnPropertyDescriptor(value, key)));
37
+ }
38
+ function error(code) {
39
+ // Native socket/parser messages, response bodies and credentials never escape.
40
+ return new AgentError(code, "The authenticated Agent data stream could not complete.");
41
+ }
42
+ function safeFailure(cause) {
43
+ return isAgentError(cause) ? cause : error("stream_closed");
44
+ }
45
+ /** HTTP adaptation only. Core owns reservations, stream slots and transfer state. */
46
+ export class AgentDataPlane {
47
+ #server;
48
+ #token;
49
+ #binding;
50
+ #assertCurrent;
51
+ #maxBytes;
52
+ #maxJsonBytes;
53
+ constructor(options) {
54
+ this.#server = validateServerUrl(options.serverUrl, options.binding.profile);
55
+ this.#token = validateAgentToken(options.token);
56
+ const binding = options.binding;
57
+ requireCondition([
58
+ binding.agentId,
59
+ binding.bootId,
60
+ binding.connectionId,
61
+ binding.cloudEnvironment,
62
+ ].every((value) => typeof value === "string" && headerIdentity.test(value)) &&
63
+ binding.cloudEnvironment === binding.profile &&
64
+ typeof options.assertCurrent === "function", "invalid_connection_binding", "The authenticated Agent connection binding is invalid.");
65
+ this.#binding = Object.freeze({ ...binding });
66
+ this.#assertCurrent = options.assertCurrent;
67
+ this.#maxBytes = options.maxBytes ?? 256 * 1024 * 1024;
68
+ this.#maxJsonBytes = options.maxJsonBytes ?? 1024 * 1024;
69
+ requireCondition(Number.isSafeInteger(this.#maxBytes) &&
70
+ this.#maxBytes > 0 &&
71
+ Number.isSafeInteger(this.#maxJsonBytes) &&
72
+ this.#maxJsonBytes > 0 &&
73
+ this.#maxJsonBytes <= this.#maxBytes, "invalid_configuration", "The data stream budgets are invalid.");
74
+ }
75
+ #current(signal, deadline) {
76
+ if (signal.aborted)
77
+ throw error("stream_cancelled");
78
+ if (Date.now() >= deadline)
79
+ throw error("stream_timeout");
80
+ try {
81
+ authorizeCall(this.#assertCurrent);
82
+ }
83
+ catch {
84
+ throw error("invalid_connection_binding");
85
+ }
86
+ }
87
+ #reference(ref, direction, signal, claim) {
88
+ requireCondition(plainData(ref, refKeys) &&
89
+ typeof ref.streamId === "string" &&
90
+ identity.test(ref.streamId) &&
91
+ typeof ref.purpose === "string" &&
92
+ Object.hasOwn(directions, ref.purpose) &&
93
+ directions[ref.purpose].includes(ref.direction) &&
94
+ typeof ref.expiresAt === "string" &&
95
+ /^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-5][0-9](?:\.[0-9]+)?Z$/.test(ref.expiresAt) &&
96
+ Number.isFinite(Date.parse(ref.expiresAt)) &&
97
+ Number.isSafeInteger(ref.maxBytes) &&
98
+ ref.maxBytes > 0 &&
99
+ ref.maxBytes <= this.#maxBytes &&
100
+ (ref.size === undefined ||
101
+ (Number.isSafeInteger(ref.size) &&
102
+ ref.size >= 0 &&
103
+ ref.size <= ref.maxBytes)) &&
104
+ (ref.sha256 === undefined ||
105
+ (typeof ref.sha256 === "string" &&
106
+ /^[0-9a-f]{64}$/.test(ref.sha256))) &&
107
+ (ref.mimeType === undefined ||
108
+ (typeof ref.mimeType === "string" &&
109
+ ref.mimeType.length <= 256 &&
110
+ !/[\x00-\x1f\x7f]/.test(ref.mimeType))), "invalid_stream_reference", "The authenticated stream reference is invalid.");
111
+ requireCondition(ref.direction === direction, "stream_direction_mismatch", "The stream direction does not match this endpoint.");
112
+ if (ref.mimeType !== undefined) {
113
+ try {
114
+ new MIMEType(ref.mimeType);
115
+ }
116
+ catch {
117
+ throw error("invalid_stream_reference");
118
+ }
119
+ }
120
+ requireCondition(ref.purpose === "transfer"
121
+ ? plainData(claim, new Set(["transferId", "reservationId"])) &&
122
+ claim !== undefined &&
123
+ Object.keys(claim).length === 2 &&
124
+ typeof claim.transferId === "string" &&
125
+ typeof claim.reservationId === "string" &&
126
+ identity.test(claim.transferId) &&
127
+ identity.test(claim.reservationId)
128
+ : claim === undefined, "invalid_stream_reference", "The actual transfer reservation must match the stream purpose.");
129
+ const deadline = Date.parse(ref.expiresAt);
130
+ requireCondition(deadline - Date.now() <= 2_147_483_647, "invalid_stream_reference", "The stream deadline is invalid.");
131
+ this.#current(signal, deadline);
132
+ return Object.freeze({ ...ref });
133
+ }
134
+ async openRead(ref, signal, claim) {
135
+ const stream = this.#reference(ref, "cloud-to-agent", signal, claim);
136
+ const exchange = this.#open(stream, signal, claim);
137
+ try {
138
+ await exchange.opened;
139
+ }
140
+ catch (cause) {
141
+ await exchange.closed.catch(() => { });
142
+ throw cause;
143
+ }
144
+ return { readable: exchange.body, closed: exchange.closed };
145
+ }
146
+ openWrite(ref, signal, claim) {
147
+ const stream = this.#reference(ref, "agent-to-cloud", signal, claim);
148
+ const exchange = this.#open(stream, signal, claim);
149
+ return { writable: exchange.body, closed: exchange.closed };
150
+ }
151
+ #open(ref, signal, claim) {
152
+ const reading = ref.direction === "cloud-to-agent";
153
+ const deadline = Date.parse(ref.expiresAt);
154
+ const url = new URL(this.#server);
155
+ url.pathname =
156
+ url.pathname.replace(/\/+$/, "") + "/agent/file-stream/" + ref.streamId;
157
+ const headers = {
158
+ Authorization: `Bearer ${this.#token}`,
159
+ Connection: "close",
160
+ "X-Nexum-Connection-Id": this.#binding.connectionId,
161
+ "X-Nexum-Agent-Profile": this.#binding.profile,
162
+ "X-Nexum-Agent-Boot-Id": this.#binding.bootId,
163
+ "X-Nexum-Stream-Purpose": ref.purpose,
164
+ "X-Nexum-Stream-Direction": ref.direction,
165
+ ...(claim
166
+ ? {
167
+ "X-Nexum-Transfer-Id": claim.transferId,
168
+ "X-Nexum-Reservation-Id": claim.reservationId,
169
+ }
170
+ : {}),
171
+ ...(!reading && ref.mimeType ? { "Content-Type": ref.mimeType } : {}),
172
+ // A transfer consumer may acknowledge fixed bytes before Core has verified
173
+ // source closure. Chunked framing carries the producer's real final EOF.
174
+ ...(!reading && ref.purpose !== "transfer" && ref.size !== undefined
175
+ ? { "Content-Length": ref.size }
176
+ : {}),
177
+ };
178
+ const completion = Promise.withResolvers();
179
+ const opening = Promise.withResolvers();
180
+ // Callers may await HTTP admission/body production before observing closure.
181
+ void completion.promise.catch(() => { });
182
+ void opening.promise.catch(() => { });
183
+ let request;
184
+ let response;
185
+ let failure;
186
+ let requestClosed = false, responseClosed = false, socketClosed = false, bodyClosed = false;
187
+ let socketAssigned = false, pipeStarted = false, pipeDone = false, acknowledged = false;
188
+ let settled = false, count = 0;
189
+ const hash = createHash("sha256");
190
+ const current = () => this.#current(signal, deadline);
191
+ let timer;
192
+ const finish = () => {
193
+ if (settled ||
194
+ !requestClosed ||
195
+ !responseClosed ||
196
+ !socketClosed ||
197
+ !bodyClosed ||
198
+ !pipeDone)
199
+ return;
200
+ if (!failure) {
201
+ try {
202
+ current();
203
+ }
204
+ catch (cause) {
205
+ failure = safeFailure(cause);
206
+ }
207
+ }
208
+ if (!failure && !acknowledged)
209
+ failure = error("stream_closed");
210
+ settled = true;
211
+ clearTimeout(timer);
212
+ signal.removeEventListener("abort", abort);
213
+ if (failure)
214
+ completion.reject(failure);
215
+ else
216
+ completion.resolve();
217
+ };
218
+ const fail = (cause) => {
219
+ failure ??= safeFailure(cause);
220
+ opening.reject(failure);
221
+ body.destroy(failure);
222
+ response?.destroy(failure);
223
+ request?.destroy(failure);
224
+ if (!pipeStarted)
225
+ pipeDone = true;
226
+ finish();
227
+ };
228
+ const body = new Transform({
229
+ highWaterMark: 64 * 1024,
230
+ transform(chunk, _encoding, callback) {
231
+ try {
232
+ current();
233
+ requireCondition(Buffer.isBuffer(chunk), "invalid_stream_body", "Only raw byte stream data is accepted.");
234
+ requireCondition(chunk.length <= ref.maxBytes - count, "resource_exhausted", "The actual stream exceeds its byte budget.");
235
+ count += chunk.length;
236
+ requireCondition(ref.size === undefined || count <= ref.size, "stream_size_mismatch", "The actual stream size does not match its fixed reference.");
237
+ hash.update(chunk);
238
+ callback(null, chunk);
239
+ }
240
+ catch (cause) {
241
+ callback(safeFailure(cause));
242
+ }
243
+ },
244
+ flush(callback) {
245
+ try {
246
+ current();
247
+ requireCondition(ref.size === undefined || count === ref.size, "stream_size_mismatch", "The actual stream size does not match its fixed reference.");
248
+ const actual = hash.digest("hex");
249
+ requireCondition(ref.sha256 === undefined || actual === ref.sha256, "checksum_mismatch", "The actual stream checksum does not match its fixed reference.");
250
+ callback();
251
+ }
252
+ catch (cause) {
253
+ callback(safeFailure(cause));
254
+ }
255
+ },
256
+ });
257
+ body.on("error", fail);
258
+ body.once("close", () => {
259
+ bodyClosed = true;
260
+ if (!failure && (!body.readableEnded || !body.writableFinished))
261
+ fail(error("stream_closed"));
262
+ finish();
263
+ });
264
+ const abort = () => fail(error("stream_cancelled"));
265
+ signal.addEventListener("abort", abort, { once: true });
266
+ timer = setTimeout(() => fail(error("stream_timeout")), Math.max(1, deadline - Date.now()));
267
+ try {
268
+ request = (url.protocol === "https:" ? httpsRequest : httpRequest)(url, {
269
+ method: reading ? "GET" : "PUT",
270
+ headers,
271
+ agent: false,
272
+ maxHeaderSize: 16 * 1024,
273
+ });
274
+ request.once("socket", (socket) => {
275
+ socketAssigned = true;
276
+ socket.once("close", () => {
277
+ socketClosed = true;
278
+ finish();
279
+ });
280
+ });
281
+ request.on("error", () => fail(error("stream_closed")));
282
+ request.once("upgrade", (incoming, socket) => {
283
+ response = incoming;
284
+ incoming.on("error", () => { });
285
+ incoming.once("close", () => {
286
+ responseClosed = true;
287
+ finish();
288
+ });
289
+ fail(error("stream_http_error"));
290
+ socket.destroy();
291
+ });
292
+ request.once("close", () => {
293
+ requestClosed = true;
294
+ if (!socketAssigned)
295
+ socketClosed = true;
296
+ if (!response)
297
+ responseClosed = true;
298
+ if (!failure && (!response || !response.complete))
299
+ fail(error("stream_closed"));
300
+ finish();
301
+ });
302
+ request.once("response", (incoming) => {
303
+ response = incoming;
304
+ incoming.on("error", () => fail(error("stream_closed")));
305
+ incoming.once("aborted", () => fail(error("stream_closed")));
306
+ incoming.once("close", () => {
307
+ responseClosed = true;
308
+ if (!incoming.complete)
309
+ fail(error("stream_closed"));
310
+ finish();
311
+ });
312
+ try {
313
+ current();
314
+ requireCondition((incoming.statusCode ?? 0) >= 200 && incoming.statusCode < 300, "stream_http_error", "The data stream endpoint did not accept the request.");
315
+ if (reading) {
316
+ const length = incoming.headers["content-length"];
317
+ if (length !== undefined) {
318
+ requireCondition(typeof length === "string" &&
319
+ /^(0|[1-9][0-9]*)$/.test(length) &&
320
+ Number.isSafeInteger(Number(length)), "invalid_stream_reference", "The data stream length is invalid.");
321
+ requireCondition(Number(length) <= ref.maxBytes, "resource_exhausted", "The data stream exceeds its byte budget.");
322
+ requireCondition(ref.size === undefined || Number(length) === ref.size, "stream_size_mismatch", "The data stream length does not match its fixed reference.");
323
+ }
324
+ pipeStarted = true;
325
+ void pipeline(incoming, body).then(() => {
326
+ pipeDone = true;
327
+ acknowledged = true;
328
+ finish();
329
+ }, (cause) => {
330
+ pipeDone = true;
331
+ fail(cause);
332
+ });
333
+ opening.resolve();
334
+ }
335
+ else {
336
+ // Cloud sends success only after the actual consumer's EOF. Drain a
337
+ // bounded response without parsing or exposing an arbitrary body.
338
+ let responseBytes = 0;
339
+ incoming.on("data", (chunk) => {
340
+ responseBytes += chunk.length;
341
+ if (responseBytes > 64 * 1024)
342
+ fail(error("resource_exhausted"));
343
+ });
344
+ incoming.once("end", () => {
345
+ try {
346
+ current();
347
+ acknowledged = true;
348
+ finish();
349
+ }
350
+ catch (cause) {
351
+ fail(cause);
352
+ }
353
+ });
354
+ incoming.resume();
355
+ }
356
+ }
357
+ catch (cause) {
358
+ fail(cause);
359
+ }
360
+ });
361
+ if (reading)
362
+ request.end();
363
+ else {
364
+ pipeStarted = true;
365
+ void pipeline(body, request).then(() => {
366
+ pipeDone = true;
367
+ finish();
368
+ }, (cause) => {
369
+ pipeDone = true;
370
+ fail(cause);
371
+ });
372
+ // A real Go relay must see the handshake before it starts the consumer.
373
+ request.flushHeaders();
374
+ opening.resolve();
375
+ }
376
+ if (signal.aborted)
377
+ abort();
378
+ }
379
+ catch (cause) {
380
+ if (!request) {
381
+ requestClosed = responseClosed = socketClosed = true;
382
+ }
383
+ fail(cause);
384
+ }
385
+ return { body, opened: opening.promise, closed: completion.promise };
386
+ }
387
+ async sendFixedBody(ref, source, signal) {
388
+ requireCondition(ref.size !== undefined && ref.sha256 !== undefined, "invalid_stream_reference", "A fixed size and checksum are required.");
389
+ let readable;
390
+ if (source instanceof Uint8Array) {
391
+ const bytes = Buffer.from(source.buffer, source.byteOffset, source.byteLength);
392
+ requireCondition(bytes.length === ref.size, "stream_size_mismatch", "The fixed body size does not match its reference.");
393
+ requireCondition(createHash("sha256").update(bytes).digest("hex") === ref.sha256, "checksum_mismatch", "The fixed body checksum does not match its reference.");
394
+ readable = Readable.from([bytes]);
395
+ }
396
+ else {
397
+ requireCondition(source instanceof Readable, "invalid_stream_body", "A native byte stream or Uint8Array is required.");
398
+ readable = source;
399
+ }
400
+ const { writable, closed } = this.openWrite(ref, signal);
401
+ try {
402
+ await pipeline(readable, writable);
403
+ await closed;
404
+ }
405
+ catch (cause) {
406
+ writable.destroy(safeFailure(cause));
407
+ await closed.catch(() => { });
408
+ throw safeFailure(cause);
409
+ }
410
+ }
411
+ async readJson(ref, signal) {
412
+ requireCondition(ref.size !== undefined && ref.sha256 !== undefined, "invalid_stream_reference", "A fixed JSON size and checksum are required.");
413
+ requireCondition(ref.size <= this.#maxJsonBytes, "resource_exhausted", "The JSON body exceeds its byte budget.");
414
+ const { readable, closed } = await this.openRead(ref, signal);
415
+ const chunks = [];
416
+ try {
417
+ for await (const chunk of readable)
418
+ chunks.push(chunk);
419
+ await closed;
420
+ const value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks, ref.size)));
421
+ canonicalJson(value, this.#maxJsonBytes);
422
+ return value;
423
+ }
424
+ catch (cause) {
425
+ readable.destroy(safeFailure(cause));
426
+ await closed.catch(() => { });
427
+ if (isAgentError(cause))
428
+ throw cause;
429
+ throw error("invalid_stream_json");
430
+ }
431
+ }
432
+ async writeJson(ref, value, signal) {
433
+ const bytes = Buffer.from(canonicalJson(value, this.#maxJsonBytes));
434
+ await this.sendFixedBody(ref, bytes, signal);
435
+ }
436
+ }
437
+ //# sourceMappingURL=data-plane.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-plane.js","sourceRoot":"","sources":["../../src/application/data-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,OAAO,IAAI,WAAW,GAGvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOpE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyBpE,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAC1C,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,UAAU,GAA+D;IAC7E,QAAQ,EAAE,CAAC,gBAAgB,CAAC;IAC5B,UAAU,EAAE,CAAC,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC9C,cAAc,EAAE,CAAC,gBAAgB,CAAC;IAClC,eAAe,EAAE,CAAC,gBAAgB,CAAC;IACnC,aAAa,EAAE,CAAC,gBAAgB,CAAC;IACjC,WAAW,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAClD,CAAC;AACF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;IACtB,UAAU;IACV,SAAS;IACT,WAAW;IACX,WAAW;IACX,UAAU;IACV,UAAU;IACV,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AACH,SAAS,SAAS,CAAC,KAAc,EAAE,OAA4B;IAC7D,OAAO,CACL,aAAa,CAAC,KAAK,CAAC;QACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAC1B,CAAC,GAAG,EAAE,EAAE,CACN,OAAO,GAAG,KAAK,QAAQ;YACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAChB,OAAO,IAAI,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAE,CAC1D,CACF,CAAC;AACJ,CAAC;AACD,SAAS,KAAK,CAAC,IAAY;IACzB,+EAA+E;IAC/E,OAAO,IAAI,UAAU,CACnB,IAAI,EACJ,yDAAyD,CAC1D,CAAC;AACJ,CAAC;AACD,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;AAC9D,CAAC;AAED,qFAAqF;AACrF,MAAM,OAAO,cAAc;IACzB,OAAO,CAAM;IACb,MAAM,CAAS;IACf,QAAQ,CAA6B;IACrC,cAAc,CAAa;IAC3B,SAAS,CAAS;IAClB,aAAa,CAAS;IACtB,YAAY,OAA8B;QACxC,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAC9B,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAAC,OAAO,CACxB,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,gBAAgB,CACd;YACE,OAAO,CAAC,OAAO;YACf,OAAO,CAAC,MAAM;YACd,OAAO,CAAC,YAAY;YACpB,OAAO,CAAC,gBAAgB;SACzB,CAAC,KAAK,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CACnE;YACC,OAAO,CAAC,gBAAgB,KAAK,OAAO,CAAC,OAAO;YAC5C,OAAO,OAAO,CAAC,aAAa,KAAK,UAAU,EAC7C,4BAA4B,EAC5B,wDAAwD,CACzD,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;QACvD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,GAAG,IAAI,CAAC;QACzD,gBAAgB,CACd,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC;YAClC,IAAI,CAAC,SAAS,GAAG,CAAC;YAClB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC;YACxC,IAAI,CAAC,aAAa,GAAG,CAAC;YACtB,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,EACtC,uBAAuB,EACvB,sCAAsC,CACvC,CAAC;IACJ,CAAC;IACD,QAAQ,CAAC,MAAmB,EAAE,QAAgB;QAC5C,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,MAAM,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,UAAU,CACR,GAAoB,EACpB,SAAgC,EAChC,MAAmB,EACnB,KAAsB;QAEtB,gBAAgB,CACd,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC;YACrB,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;YAChC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC3B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;YAChD,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YACjC,yEAAyE,CAAC,IAAI,CAC5E,GAAG,CAAC,SAAS,CACd;YACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClC,GAAG,CAAC,QAAQ,GAAG,CAAC;YAChB,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS;YAC9B,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS;gBACrB,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;oBAC7B,GAAG,CAAC,IAAI,IAAI,CAAC;oBACb,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS;gBACvB,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;oBAC7B,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS;gBACzB,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;oBAC/B,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;oBAC1B,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC7C,0BAA0B,EAC1B,gDAAgD,CACjD,CAAC;QACF,gBAAgB,CACd,GAAG,CAAC,SAAS,KAAK,SAAS,EAC3B,2BAA2B,EAC3B,oDAAoD,CACrD,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,gBAAgB,CACd,GAAG,CAAC,OAAO,KAAK,UAAU;YACxB,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;gBACxD,KAAK,KAAK,SAAS;gBACnB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;gBAC/B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;gBACpC,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;gBACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACtC,CAAC,CAAC,KAAK,KAAK,SAAS,EACvB,0BAA0B,EAC1B,gEAAgE,CACjE,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,gBAAgB,CACd,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,aAAa,EACtC,0BAA0B,EAC1B,iCAAiC,CAClC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK,CAAC,QAAQ,CACZ,GAAoB,EACpB,MAAmB,EACnB,KAAsB;QAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,MAAM,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IACD,SAAS,CACP,GAAoB,EACpB,MAAmB,EACnB,KAAsB;QAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IACD,KAAK,CACH,GAA8B,EAC9B,MAAmB,EACnB,KAAsB;QAEtB,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,KAAK,gBAAgB,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,GAAG,CAAC,QAAQ;YACV,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,qBAAqB,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC1E,MAAM,OAAO,GAAoC;YAC/C,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACtC,UAAU,EAAE,OAAO;YACnB,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY;YACnD,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9C,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC7C,wBAAwB,EAAE,GAAG,CAAC,OAAO;YACrC,0BAA0B,EAAE,GAAG,CAAC,SAAS;YACzC,GAAG,CAAC,KAAK;gBACP,CAAC,CAAC;oBACE,qBAAqB,EAAE,KAAK,CAAC,UAAU;oBACvC,wBAAwB,EAAE,KAAK,CAAC,aAAa;iBAC9C;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,2EAA2E;YAC3E,yEAAyE;YACzE,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAClE,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,IAAI,EAAE;gBAChC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;QAC9C,6EAA6E;QAC7E,KAAK,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,IAAI,OAAkC,CAAC;QACvC,IAAI,QAAqC,CAAC;QAC1C,IAAI,OAA+B,CAAC;QACpC,IAAI,aAAa,GAAG,KAAK,EACvB,cAAc,GAAG,KAAK,EACtB,YAAY,GAAG,KAAK,EACpB,UAAU,GAAG,KAAK,CAAC;QACrB,IAAI,cAAc,GAAG,KAAK,EACxB,WAAW,GAAG,KAAK,EACnB,QAAQ,GAAG,KAAK,EAChB,YAAY,GAAG,KAAK,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,EACjB,KAAK,GAAG,CAAC,CAAC;QACZ,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,KAAiC,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IACE,OAAO;gBACP,CAAC,aAAa;gBACd,CAAC,cAAc;gBACf,CAAC,YAAY;gBACb,CAAC,UAAU;gBACX,CAAC,QAAQ;gBAET,OAAO;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY;gBAAE,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;YAChE,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,OAAO;gBAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;;gBACnC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;YAC9B,OAAO,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtB,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,WAAW;gBAAE,QAAQ,GAAG,IAAI,CAAC;YAClC,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC;YACzB,aAAa,EAAE,EAAE,GAAG,IAAI;YACxB,SAAS,CAAC,KAAa,EAAE,SAAS,EAAE,QAAQ;gBAC1C,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC;oBACV,gBAAgB,CACd,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EACtB,qBAAqB,EACrB,wCAAwC,CACzC,CAAC;oBACF,gBAAgB,CACd,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,GAAG,KAAK,EACpC,oBAAoB,EACpB,4CAA4C,CAC7C,CAAC;oBACF,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;oBACtB,gBAAgB,CACd,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,IAAI,GAAG,CAAC,IAAI,EAC3C,sBAAsB,EACtB,4DAA4D,CAC7D,CAAC;oBACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACnB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,KAAK,CAAC,QAAQ;gBACZ,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC;oBACV,gBAAgB,CACd,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,EAC5C,sBAAsB,EACtB,4DAA4D,CAC7D,CAAC;oBACF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAClC,gBAAgB,CACd,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,GAAG,CAAC,MAAM,EACjD,mBAAmB,EACnB,gEAAgE,CACjE,CAAC;oBACF,QAAQ,EAAE,CAAC;gBACb,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,UAAU,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;gBAC7D,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;YAC/B,MAAM,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,EACnC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CACnC,CAAC;QACF,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE;gBACtE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;gBAC/B,OAAO;gBACP,KAAK,EAAE,KAAK;gBACZ,aAAa,EAAE,EAAE,GAAG,IAAI;aACzB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;gBAChC,cAAc,GAAG,IAAI,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;oBACxB,YAAY,GAAG,IAAI,CAAC;oBACpB,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBAC3C,QAAQ,GAAG,QAAQ,CAAC;gBACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC1B,cAAc,GAAG,IAAI,CAAC;oBACtB,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACjC,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACzB,aAAa,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,cAAc;oBAAE,YAAY,GAAG,IAAI,CAAC;gBACzC,IAAI,CAAC,QAAQ;oBAAE,cAAc,GAAG,IAAI,CAAC;gBACrC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAC/C,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;gBAC/B,MAAM,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACpC,QAAQ,GAAG,QAAQ,CAAC;gBACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;gBAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;oBAC1B,cAAc,GAAG,IAAI,CAAC;oBACtB,IAAI,CAAC,QAAQ,CAAC,QAAQ;wBAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;oBACrD,MAAM,EAAE,CAAC;gBACX,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC;oBACV,gBAAgB,CACd,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,GAAG,IAAI,QAAQ,CAAC,UAAW,GAAG,GAAG,EAC/D,mBAAmB,EACnB,sDAAsD,CACvD,CAAC;oBACF,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;wBAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;4BACzB,gBAAgB,CACd,OAAO,MAAM,KAAK,QAAQ;gCACxB,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;gCAChC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EACtC,0BAA0B,EAC1B,oCAAoC,CACrC,CAAC;4BACF,gBAAgB,CACd,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAC9B,oBAAoB,EACpB,0CAA0C,CAC3C,CAAC;4BACF,gBAAgB,CACd,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,EACrD,sBAAsB,EACtB,4DAA4D,CAC7D,CAAC;wBACJ,CAAC;wBACD,WAAW,GAAG,IAAI,CAAC;wBACnB,KAAK,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAChC,GAAG,EAAE;4BACH,QAAQ,GAAG,IAAI,CAAC;4BAChB,YAAY,GAAG,IAAI,CAAC;4BACpB,MAAM,EAAE,CAAC;wBACX,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;4BACR,QAAQ,GAAG,IAAI,CAAC;4BAChB,IAAI,CAAC,KAAK,CAAC,CAAC;wBACd,CAAC,CACF,CAAC;wBACF,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,CAAC;yBAAM,CAAC;wBACN,oEAAoE;wBACpE,kEAAkE;wBAClE,IAAI,aAAa,GAAG,CAAC,CAAC;wBACtB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;4BACpC,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;4BAC9B,IAAI,aAAa,GAAG,EAAE,GAAG,IAAI;gCAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;wBACnE,CAAC,CAAC,CAAC;wBACH,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE;4BACxB,IAAI,CAAC;gCACH,OAAO,EAAE,CAAC;gCACV,YAAY,GAAG,IAAI,CAAC;gCACpB,MAAM,EAAE,CAAC;4BACX,CAAC;4BAAC,OAAO,KAAK,EAAE,CAAC;gCACf,IAAI,CAAC,KAAK,CAAC,CAAC;4BACd,CAAC;wBACH,CAAC,CAAC,CAAC;wBACH,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACpB,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,EAAE,CAAC;iBACtB,CAAC;gBACJ,WAAW,GAAG,IAAI,CAAC;gBACnB,KAAK,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAC/B,GAAG,EAAE;oBACH,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,EAAE,CAAC;gBACX,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;oBACR,QAAQ,GAAG,IAAI,CAAC;oBAChB,IAAI,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC,CACF,CAAC;gBACF,wEAAwE;gBACxE,OAAO,CAAC,YAAY,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;YACD,IAAI,MAAM,CAAC,OAAO;gBAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,IAAI,CAAC;YACvD,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;IACvE,CAAC;IACD,KAAK,CAAC,aAAa,CACjB,GAAoB,EACpB,MAA6B,EAC7B,MAAmB;QAEnB,gBAAgB,CACd,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAClD,0BAA0B,EAC1B,yCAAyC,CAC1C,CAAC;QACF,IAAI,QAAkB,CAAC;QACvB,IAAI,MAAM,YAAY,UAAU,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CACvB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,CAClB,CAAC;YACF,gBAAgB,CACd,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,EACzB,sBAAsB,EACtB,mDAAmD,CACpD,CAAC;YACF,gBAAgB,CACd,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,EAC/D,mBAAmB,EACnB,uDAAuD,CACxD,CAAC;YACF,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,gBAAgB,CACd,MAAM,YAAY,QAAQ,EAC1B,qBAAqB,EACrB,iDAAiD,CAClD,CAAC;YACF,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM,MAAM,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC7B,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,QAAQ,CACZ,GAAoB,EACpB,MAAmB;QAEnB,gBAAgB,CACd,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAClD,0BAA0B,EAC1B,8CAA8C,CAC/C,CAAC;QACF,gBAAgB,CACd,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,EAC9B,oBAAoB,EACpB,wCAAwC,CACzC,CAAC;QACF,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;YACjE,MAAM,MAAM,CAAC;YACb,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAC/B,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAChC,CACF,CAAC;YACF,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACzC,OAAO,KAAkB,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YACrC,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC7B,IAAI,YAAY,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACrC,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,KAAK,CAAC,SAAS,CACb,GAAoB,EACpB,KAAgB,EAChB,MAAmB;QAEnB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF"}
@@ -0,0 +1,4 @@
1
+ import type { Profile } from "../contracts/types.js";
2
+ export declare const MAX_DIAGNOSTIC_BYTES: number;
3
+ /** Private, bounded control diagnostics. Native/plugin errors and payloads never enter this file. */
4
+ export declare function appendDiagnostic(root: string, profile: Profile, code: string, retry: boolean): void;
@@ -0,0 +1,65 @@
1
+ import { closeSync, constants, fchmodSync, fstatSync, ftruncateSync, lstatSync, openSync, readSync, realpathSync, writeSync, } from "node:fs";
2
+ import path from "node:path";
3
+ import { requireCondition } from "../contracts/errors.js";
4
+ import { privateDirectory } from "../runtime/paths.js";
5
+ export const MAX_DIAGNOSTIC_BYTES = 1024 * 1024;
6
+ /** Private, bounded control diagnostics. Native/plugin errors and payloads never enter this file. */
7
+ export function appendDiagnostic(root, profile, code, retry) {
8
+ const directory = privateDirectory(root, "logs");
9
+ const filename = path.join(directory, "agent.log");
10
+ const before = lstatSync(filename, { throwIfNoEntry: false });
11
+ requireCondition(!before || (before.isFile() && before.nlink === 1), "agent_log_unavailable", "The diagnostic file is unavailable.");
12
+ const file = openSync(filename, constants.O_RDWR |
13
+ constants.O_CREAT |
14
+ (constants.O_NOFOLLOW ?? 0) |
15
+ (constants.O_NONBLOCK ?? 0), 0o600);
16
+ try {
17
+ const actual = fstatSync(file);
18
+ const current = lstatSync(filename);
19
+ requireCondition(actual.isFile() &&
20
+ actual.nlink === 1 &&
21
+ actual.dev === current.dev &&
22
+ actual.ino === current.ino &&
23
+ (!before || (actual.dev === before.dev && actual.ino === before.ino)) &&
24
+ realpathSync.native(root) === root &&
25
+ realpathSync.native(directory) === directory, "agent_log_unavailable", "The diagnostic file is unavailable.");
26
+ fchmodSync(file, 0o600);
27
+ const entry = Buffer.from(JSON.stringify({
28
+ time: new Date().toISOString(),
29
+ profile,
30
+ code: /^[a-z][a-z0-9_]{0,127}$/.test(code) ? code : "agent_failed",
31
+ retry,
32
+ }) + "\n");
33
+ let position = actual.size;
34
+ if (position + entry.length > MAX_DIAGNOSTIC_BYTES) {
35
+ const length = Math.min(actual.size, MAX_DIAGNOSTIC_BYTES / 2);
36
+ const tail = Buffer.alloc(length);
37
+ let read = 0;
38
+ while (read < length) {
39
+ const count = readSync(file, tail, read, length - read, actual.size - length + read);
40
+ if (!count)
41
+ break;
42
+ read += count;
43
+ }
44
+ // Drop the first partial record, including any partial UTF-8 character.
45
+ const newline = tail.subarray(0, read).indexOf(10);
46
+ const retained = newline < 0 ? Buffer.alloc(0) : tail.subarray(newline + 1, read);
47
+ ftruncateSync(file, 0);
48
+ writeAll(file, retained, 0);
49
+ position = retained.length;
50
+ }
51
+ writeAll(file, entry, position);
52
+ }
53
+ finally {
54
+ closeSync(file);
55
+ }
56
+ }
57
+ function writeAll(file, bytes, position) {
58
+ let offset = 0;
59
+ while (offset < bytes.length) {
60
+ const count = writeSync(file, bytes, offset, bytes.length - offset, position + offset);
61
+ requireCondition(count > 0, "agent_log_unavailable", "The diagnostic write did not complete.");
62
+ offset += count;
63
+ }
64
+ }
65
+ //# sourceMappingURL=diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/application/diagnostics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { WireConnectionV2, WireInvokeV2 } from "../contracts/wire.js";
2
+ export type ApplicationHandler = (input: any) => unknown | Promise<unknown>;
3
+ /** Wire validation and routing only; the owning Core services implement behavior. */
4
+ export declare function dispatchApplication(message: WireInvokeV2, binding: WireConnectionV2, handlers: Readonly<Record<string, ApplicationHandler>>): Promise<unknown>;
@@ -0,0 +1,16 @@
1
+ import { requireCondition } from "../contracts/errors.js";
2
+ import { validateContract } from "../contracts/validation.js";
3
+ import { validateConnectionV2 } from "../contracts/wire-validation.js";
4
+ /** Wire validation and routing only; the owning Core services implement behavior. */
5
+ export async function dispatchApplication(message, binding, handlers) {
6
+ validateContract("wire", message);
7
+ validateConnectionV2(message.context.connection, binding);
8
+ const handler = Object.hasOwn(handlers, message.operation)
9
+ ? handlers[message.operation]
10
+ : undefined;
11
+ requireCondition(handler, "invalid_control_direction", "This operation is not an Agent application entry.");
12
+ const output = await handler(message.input);
13
+ validateContract("wire.output:" + message.operation, output);
14
+ return output;
15
+ }
16
+ //# sourceMappingURL=dispatcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/application/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAIvE,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAqB,EACrB,OAAyB,EACzB,QAAsD;IAEtD,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC;QACxD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,CAAC,CAAC,SAAS,CAAC;IACd,gBAAgB,CACd,OAAO,EACP,2BAA2B,EAC3B,mDAAmD,CACpD,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,gBAAgB,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,12 @@
1
+ import type { Profile } from "../contracts/types.js";
2
+ import { type AgentRuntimeOptions } from "./runtime.js";
3
+ export interface AgentProgramOptions {
4
+ readonly version: string;
5
+ readonly signal?: AbortSignal;
6
+ /** Trusted embedding/test home; the installed CLI uses the actual OS home. */
7
+ readonly home?: string;
8
+ readonly runtime?: AgentRuntimeOptions;
9
+ diagnose?(code: string, retry: boolean): void;
10
+ }
11
+ /** Native process entry: one boot/Core survives reconnects; only observations are replaced. */
12
+ export declare function runAgent(profile: Profile, options: AgentProgramOptions): Promise<number>;