@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,475 @@
1
+ import { EventEmitter } from "node:events";
2
+ import { fork } from "node:child_process";
3
+ import { setTimeout as delay } from "node:timers/promises";
4
+ import path from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+ import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
7
+ import { WindowsJob } from "./windows-job.js";
8
+ const trustedExecPath = process.execPath;
9
+ const helperUrl = new URL("./windows-helper.js", import.meta.url);
10
+ const helperVariables = new Set([
11
+ "SYSTEMROOT",
12
+ "WINDIR",
13
+ "COMSPEC",
14
+ "TEMP",
15
+ "TMP",
16
+ "USERPROFILE",
17
+ "APPDATA",
18
+ "LOCALAPPDATA",
19
+ ]);
20
+ function helperEnvironment() {
21
+ const env = {};
22
+ for (const [key, value] of Object.entries(process.env))
23
+ if (value !== undefined && helperVariables.has(key.toUpperCase()))
24
+ env[key] = value;
25
+ return env;
26
+ }
27
+ function boundedTime(value, fallback) {
28
+ const result = value ?? fallback;
29
+ requireCondition(Number.isInteger(result) && result >= 0 && result <= 60000, "invalid_process_stop_timeout", "Process stop intervals must be integers from 0 through 60000 milliseconds.");
30
+ return result;
31
+ }
32
+ /** Cold, host-private Windows launcher. Public resource registration precedes start. */
33
+ export class WindowsProcessBackend extends EventEmitter {
34
+ closed;
35
+ #resolveClosed;
36
+ #options;
37
+ #failure;
38
+ #state = {
39
+ pid: null,
40
+ startedAt: null,
41
+ rootExited: false,
42
+ exitCode: null,
43
+ exitSignal: null,
44
+ outputComplete: false,
45
+ treeStopped: false,
46
+ closed: false,
47
+ stopRequested: false,
48
+ forceRequested: false,
49
+ };
50
+ #started = false;
51
+ #launch;
52
+ #helper;
53
+ #job;
54
+ #assigned = false;
55
+ #helperClosed = false;
56
+ #outputSettled = false;
57
+ #outputFailed = false;
58
+ #terminalComplete = false;
59
+ #terminalClosed = false;
60
+ #finishing = false;
61
+ #poll;
62
+ #startResult = Promise.withResolvers();
63
+ #startTimer;
64
+ #stopResult;
65
+ #inputTail = Promise.resolve();
66
+ #inputEof = false;
67
+ #controlId = 0;
68
+ #controls = new Map();
69
+ constructor(options) {
70
+ super();
71
+ this.#options = options;
72
+ const closed = Promise.withResolvers();
73
+ this.closed = closed.promise;
74
+ this.#resolveClosed = closed.resolve;
75
+ void this.#startResult.promise.catch(() => { });
76
+ }
77
+ get failure() {
78
+ return this.#failure;
79
+ }
80
+ facts() {
81
+ return Object.freeze({ ...this.#state });
82
+ }
83
+ #change(update = {}) {
84
+ this.#state = { ...this.#state, ...update };
85
+ this.emit("change", this.facts());
86
+ }
87
+ #recordFailure(code, message, cause) {
88
+ const error = new AgentError(code, message, undefined, { cause });
89
+ this.#failure ??= isAgentError(cause) ? cause : error;
90
+ this.#startResult.reject(this.#failure);
91
+ this.#change();
92
+ return error;
93
+ }
94
+ #send(message) {
95
+ const child = this.#helper;
96
+ requireCondition(child?.connected, "windows_helper_disconnected", "The managed Windows helper is disconnected.");
97
+ child.send(message, (error) => {
98
+ if (error && !this.#state.closed) {
99
+ this.#recordFailure("windows_helper_ipc_failed", "The managed Windows helper channel failed.", error);
100
+ this.#force();
101
+ }
102
+ });
103
+ }
104
+ async start(launch) {
105
+ requireCondition(!this.#started && !this.#state.closed, "process_already_started", "The process backend has already started or closed.");
106
+ this.#started = true;
107
+ try {
108
+ requireCondition(process.platform === "win32", "windows_process_unsupported", "The Windows process backend is available only on Windows.");
109
+ requireCondition(!/\.(?:cmd|bat)$/i.test(launch.file), "windows_batch_direct_unsupported", "Windows batch files require an explicit command shell.");
110
+ requireCondition(path.isAbsolute(launch.file) && path.isAbsolute(launch.cwd), "invalid_process_launch", "The executable and working directory must be absolute paths.");
111
+ this.#launch = launch;
112
+ this.#job = WindowsJob.create();
113
+ this.#helper = fork(helperUrl, [], {
114
+ execPath: trustedExecPath,
115
+ execArgv: [],
116
+ cwd: path.dirname(fileURLToPath(helperUrl)),
117
+ env: helperEnvironment(),
118
+ stdio: ["ignore", "pipe", "pipe", "ipc"],
119
+ serialization: "advanced",
120
+ windowsHide: true,
121
+ });
122
+ const child = this.#helper;
123
+ child.on("message", (message) => this.#message(message));
124
+ child.once("error", (error) => {
125
+ this.#recordFailure("windows_helper_spawn_failed", "The managed Windows helper could not start.", error);
126
+ this.#force();
127
+ });
128
+ child.once("exit", (exitCode) => {
129
+ if (this.#state.pid === null && !this.#failure)
130
+ this.#recordFailure("windows_helper_exited", "The Windows helper exited before the business process started.");
131
+ else if (!this.#state.forceRequested &&
132
+ (!this.#finishing || exitCode !== 0)) {
133
+ this.#outputFailed = true;
134
+ this.#recordFailure("windows_helper_unexpected_exit", "The Windows helper exited without completing the managed output shutdown.");
135
+ }
136
+ if (!this.#finishing)
137
+ this.#force();
138
+ });
139
+ child.once("close", () => {
140
+ this.#helperClosed = true;
141
+ this.#tick();
142
+ });
143
+ const output = Promise.all([
144
+ this.#read(child.stdout, launch.tty ? "terminal" : "stdout"),
145
+ this.#read(child.stderr, launch.tty ? "terminal" : "stderr"),
146
+ ]);
147
+ void output.finally(() => {
148
+ this.#outputSettled = true;
149
+ this.#tick();
150
+ });
151
+ this.#poll = setInterval(() => this.#tick(), 20);
152
+ this.#startTimer = setTimeout(() => {
153
+ this.#recordFailure("windows_process_start_timeout", "The Windows business process start was not confirmed in time.");
154
+ this.#force();
155
+ }, 20000);
156
+ await this.#startResult.promise;
157
+ }
158
+ catch (error) {
159
+ this.#failure ??= error;
160
+ this.#startResult.reject(error);
161
+ if (this.#helper)
162
+ this.#force();
163
+ else {
164
+ this.#job?.close();
165
+ this.#change({ outputComplete: true, treeStopped: true, closed: true });
166
+ this.#resolveClosed();
167
+ }
168
+ throw error;
169
+ }
170
+ }
171
+ #message(message) {
172
+ try {
173
+ if (message?.type === "ready") {
174
+ requireCondition(!this.#assigned && this.#job && this.#helper, "windows_helper_invalid_handshake", "The Windows helper handshake is invalid.");
175
+ this.#job.assignChild(this.#helper, message.birth);
176
+ this.#assigned = true;
177
+ if (this.#state.stopRequested)
178
+ this.#force();
179
+ else
180
+ this.#send({ type: "start", launch: this.#launch });
181
+ }
182
+ else if (message?.type === "started") {
183
+ requireCondition(this.#assigned && Number.isInteger(message.pid) && message.pid > 0, "windows_helper_invalid_start", "The Windows helper did not confirm a valid process start.");
184
+ clearTimeout(this.#startTimer);
185
+ this.#change({ pid: message.pid, startedAt: message.startedAt });
186
+ this.#startResult.resolve();
187
+ }
188
+ else if (message?.type === "root-exit") {
189
+ this.#change({ rootExited: true, exitCode: message.exitCode });
190
+ }
191
+ else if (message?.type === "terminal-closed") {
192
+ this.#terminalClosed = true;
193
+ this.#terminalComplete = message.complete;
194
+ if (!message.complete)
195
+ this.#recordFailure("windows_pty_output_incomplete", "The Windows terminal closed without a complete output EOF.");
196
+ }
197
+ else if (message?.type === "input-closed") {
198
+ this.#inputEof = true;
199
+ }
200
+ else if (message?.type === "failed") {
201
+ this.#recordFailure(message.code, "The managed Windows business process failed.", new AgentError(message.code, "The managed Windows business process failed.", message.systemCode === undefined
202
+ ? undefined
203
+ : { systemCode: message.systemCode }));
204
+ this.#force();
205
+ }
206
+ else if (message?.type === "ack") {
207
+ const control = this.#controls.get(message.id);
208
+ if (control) {
209
+ this.#controls.delete(message.id);
210
+ clearTimeout(control.timer);
211
+ if (message.ok)
212
+ control.resolve();
213
+ else
214
+ control.reject(new AgentError(message.code ?? "windows_pty_control_failed", "The Windows terminal control operation failed."));
215
+ }
216
+ }
217
+ this.#tick();
218
+ }
219
+ catch (error) {
220
+ this.#recordFailure("windows_helper_protocol_failed", "The Windows helper handshake or control protocol failed.", error);
221
+ this.#force();
222
+ }
223
+ }
224
+ async #read(stream, kind) {
225
+ try {
226
+ for await (const chunk of stream) {
227
+ if (this.#outputFailed)
228
+ continue;
229
+ try {
230
+ await this.#options.onOutput(kind, Buffer.from(chunk));
231
+ }
232
+ catch (error) {
233
+ this.#outputFailed = true;
234
+ this.#recordFailure("process_output_failed", "The managed process output consumer failed.", error);
235
+ this.#force();
236
+ }
237
+ }
238
+ }
239
+ catch (error) {
240
+ this.#outputFailed = true;
241
+ this.#recordFailure("process_output_failed", "The managed process output stream failed.", error);
242
+ this.#force();
243
+ }
244
+ }
245
+ #force() {
246
+ if (this.#state.closed)
247
+ return;
248
+ this.#change({ forceRequested: true });
249
+ try {
250
+ if (this.#assigned)
251
+ this.#job.terminate(1);
252
+ else if (this.#helper &&
253
+ this.#helper.exitCode === null &&
254
+ this.#helper.signalCode === null)
255
+ this.#helper.kill(); // Only our privately retained, not-yet-assigned helper.
256
+ }
257
+ catch (error) {
258
+ this.#failure ??= isAgentError(error)
259
+ ? error
260
+ : new AgentError("windows_process_stop_failed", "The Windows process tree stop could not be delivered.", undefined, { cause: error });
261
+ this.#change();
262
+ }
263
+ }
264
+ #tick() {
265
+ if (this.#state.closed || !this.#job)
266
+ return;
267
+ try {
268
+ const active = this.#job.queryAccounting().activeProcesses;
269
+ if (this.#assigned &&
270
+ this.#state.pid !== null &&
271
+ !this.#finishing &&
272
+ this.#state.rootExited &&
273
+ active === 1 &&
274
+ (!this.#launch.tty || this.#terminalClosed)) {
275
+ this.#finishing = true;
276
+ this.#send({ type: "finish" });
277
+ }
278
+ if (active === 0 && this.#helperClosed && !this.#state.treeStopped)
279
+ this.#change({
280
+ treeStopped: true,
281
+ rootExited: this.#state.pid !== null || this.#state.rootExited,
282
+ });
283
+ if (active !== 0 || !this.#helperClosed || !this.#outputSettled)
284
+ return;
285
+ if (this.#state.forceRequested &&
286
+ this.#launch?.tty &&
287
+ !this.#terminalComplete) {
288
+ // The Job and both helper streams have physically closed. Forced
289
+ // helper termination can lose the ConPTY tail: that is a known output
290
+ // failure, not an indefinitely unknown process lifetime or a fake EOF.
291
+ this.#outputFailed = true;
292
+ this.#failure ??= new AgentError("process_output_failed", "The forced Windows terminal shutdown could not retain a complete output tail.");
293
+ }
294
+ this.#job.close();
295
+ clearInterval(this.#poll);
296
+ clearTimeout(this.#startTimer);
297
+ for (const control of this.#controls.values()) {
298
+ clearTimeout(control.timer);
299
+ control.reject(new AgentError("process_closed", "The managed process has closed."));
300
+ }
301
+ this.#controls.clear();
302
+ this.#change({
303
+ rootExited: this.#state.pid !== null || this.#state.rootExited,
304
+ treeStopped: true,
305
+ outputComplete: !this.#outputFailed && (!this.#launch?.tty || this.#terminalComplete),
306
+ closed: true,
307
+ });
308
+ this.#startResult.reject(this.#failure ??
309
+ new AgentError("process_closed", "The managed process closed before start completed."));
310
+ this.#resolveClosed();
311
+ }
312
+ catch (error) {
313
+ this.#failure ??= isAgentError(error)
314
+ ? error
315
+ : new AgentError("windows_job_query_failed", "The actual Windows Job state could not be confirmed.", undefined, { cause: error });
316
+ this.#change();
317
+ }
318
+ }
319
+ async write(data, eof, signal) {
320
+ signal.throwIfAborted();
321
+ requireCondition(!(this.#launch?.tty && eof), "pty_eof_unsupported", "A terminal does not support pipe EOF; use terminal input or stop.");
322
+ const bytes = Buffer.from(data);
323
+ const operation = this.#inputTail.then(async () => {
324
+ signal.throwIfAborted();
325
+ requireCondition(this.#state.pid !== null &&
326
+ !this.#state.rootExited &&
327
+ !this.#state.closed &&
328
+ !this.#inputEof, "process_input_closed", "The managed process input is unavailable or closed.");
329
+ // At most one 64KiB input frame awaits the actual business sink callback.
330
+ // An aborted caller stops waiting but does not release this internal queue
331
+ // until the already-sent frame settles, preventing unbounded IPC buildup.
332
+ for (let offset = 0; offset < bytes.length; offset += 64 * 1024) {
333
+ signal.throwIfAborted();
334
+ await this.#input(bytes.subarray(offset, offset + 64 * 1024), false);
335
+ }
336
+ if (eof) {
337
+ signal.throwIfAborted();
338
+ this.#inputEof = true;
339
+ await this.#input(Buffer.alloc(0), true);
340
+ }
341
+ });
342
+ this.#inputTail = operation.catch(() => { });
343
+ return this.#abortable(operation, signal);
344
+ }
345
+ #input(data, eof) {
346
+ const id = ++this.#controlId;
347
+ return new Promise((resolve, reject) => {
348
+ this.#controls.set(id, { resolve, reject });
349
+ try {
350
+ this.#send({ type: "input", id, data, eof });
351
+ }
352
+ catch (error) {
353
+ this.#controls.delete(id);
354
+ reject(error);
355
+ }
356
+ });
357
+ }
358
+ #abortable(operation, signal) {
359
+ return new Promise((resolve, reject) => {
360
+ const aborted = () => reject(signal.reason);
361
+ signal.addEventListener("abort", aborted, { once: true });
362
+ if (signal.aborted)
363
+ aborted();
364
+ void operation.then(() => {
365
+ signal.removeEventListener("abort", aborted);
366
+ resolve();
367
+ }, (error) => {
368
+ signal.removeEventListener("abort", aborted);
369
+ reject(error);
370
+ });
371
+ });
372
+ }
373
+ #control(action, cols, rows) {
374
+ requireCondition(this.#launch?.tty &&
375
+ this.#state.pid !== null &&
376
+ !this.#state.rootExited &&
377
+ !this.#state.closed, "process_terminal_unavailable", "A live managed terminal is required for this operation.");
378
+ const id = ++this.#controlId;
379
+ return new Promise((resolve, reject) => {
380
+ const timer = setTimeout(() => {
381
+ this.#controls.delete(id);
382
+ reject(new AgentError("windows_pty_control_timeout", "The terminal control operation was not confirmed in time."));
383
+ }, 5000);
384
+ this.#controls.set(id, { resolve, reject, timer });
385
+ try {
386
+ this.#send({
387
+ type: "control",
388
+ id,
389
+ action,
390
+ ...(cols === undefined ? {} : { cols, rows }),
391
+ });
392
+ }
393
+ catch (error) {
394
+ clearTimeout(timer);
395
+ this.#controls.delete(id);
396
+ reject(error);
397
+ }
398
+ });
399
+ }
400
+ async resize(cols, rows) {
401
+ requireCondition(Number.isInteger(cols) &&
402
+ cols > 0 &&
403
+ cols <= 10000 &&
404
+ Number.isInteger(rows) &&
405
+ rows > 0 &&
406
+ rows <= 10000, "invalid_terminal_size", "Terminal columns and rows must be positive bounded integers.");
407
+ await this.#control("resize", cols, rows);
408
+ }
409
+ async signal(signal) {
410
+ requireCondition(this.#state.pid !== null && !this.#state.closed, "process_closed", "The managed process is unavailable or closed.");
411
+ if (signal === "SIGKILL") {
412
+ this.#job.terminate(1);
413
+ this.#change({ forceRequested: true });
414
+ return { requested: signal, delivered: true, mechanism: "job-object" };
415
+ }
416
+ if (signal === "SIGINT" && this.#launch?.tty) {
417
+ await this.#control("interrupt");
418
+ return {
419
+ requested: signal,
420
+ delivered: true,
421
+ mechanism: "terminal-input",
422
+ };
423
+ }
424
+ throw new AgentError("process_signal_unsupported", "This Windows signal cannot be delivered through the managed backend.");
425
+ }
426
+ async #waitClosed(timeoutMs) {
427
+ if (this.#state.closed)
428
+ return true;
429
+ const controller = new AbortController();
430
+ const timeout = delay(timeoutMs, false, { signal: controller.signal });
431
+ try {
432
+ return await Promise.race([this.closed.then(() => true), timeout]);
433
+ }
434
+ finally {
435
+ controller.abort();
436
+ }
437
+ }
438
+ async stop(options = {}) {
439
+ const graceMs = boundedTime(options.graceMs, 1000);
440
+ const forceMs = boundedTime(options.forceMs, 5000);
441
+ if (this.#state.closed)
442
+ return { confirmed: true, facts: this.facts() };
443
+ if (this.#stopResult)
444
+ return this.#stopResult;
445
+ this.#stopResult = (async () => {
446
+ this.#change({ stopRequested: true });
447
+ if (!this.#started) {
448
+ this.#change({ outputComplete: true, treeStopped: true, closed: true });
449
+ this.#resolveClosed();
450
+ return { confirmed: true, facts: this.facts() };
451
+ }
452
+ if (this.#state.pid !== null && !this.#state.rootExited && graceMs > 0) {
453
+ if (this.#launch?.tty) {
454
+ void this.#control("interrupt").catch(() => { });
455
+ }
456
+ else if (!this.#inputEof)
457
+ void this.write(Buffer.alloc(0), true, new AbortController().signal).catch(() => { });
458
+ }
459
+ if (!(await this.#waitClosed(graceMs)))
460
+ this.#force();
461
+ const confirmed = await this.#waitClosed(forceMs);
462
+ return { confirmed, facts: this.facts() };
463
+ })();
464
+ try {
465
+ return await this.#stopResult;
466
+ }
467
+ finally {
468
+ this.#stopResult = undefined;
469
+ }
470
+ }
471
+ async dispose() {
472
+ await this.stop();
473
+ }
474
+ }
475
+ //# sourceMappingURL=windows-pipes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"windows-pipes.js","sourceRoot":"","sources":["../../src/process/windows-pipes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,118 @@
1
+ import { Blob } from "node:buffer";
2
+ import { Readable } from "node:stream";
3
+ export interface ArtifactRecord {
4
+ readonly resourceId: string;
5
+ readonly agentId: string;
6
+ readonly uri: string;
7
+ readonly name: string;
8
+ readonly mimeType: string;
9
+ readonly size: number;
10
+ readonly sha256: string;
11
+ readonly originRunId: string | null;
12
+ readonly createdAt: string;
13
+ readonly expiresAt: string;
14
+ }
15
+ export interface ArtifactSource {
16
+ readonly path?: string;
17
+ readonly data?: ArrayBuffer | SharedArrayBuffer | ArrayBufferView | Blob;
18
+ readonly name?: string;
19
+ readonly mimeType?: string;
20
+ }
21
+ export interface ArtifactAccess {
22
+ readonly action: "register" | "read" | "list";
23
+ readonly uri?: string;
24
+ readonly path?: string;
25
+ readonly resource?: ArtifactRecord & {
26
+ readonly ownerKey: string;
27
+ };
28
+ }
29
+ export interface ArtifactScope {
30
+ readonly pwd: string;
31
+ readonly ownerKey: string;
32
+ readonly runId?: string;
33
+ readonly signal?: AbortSignal;
34
+ /** Trusted Core control-source verdict; never parsed from a script result. */
35
+ readonly controlStorage?: boolean;
36
+ assertCurrent(): void;
37
+ authorize(target: ArtifactAccess): void;
38
+ }
39
+ export interface ArtifactOptions {
40
+ readonly maxFileBytes?: number;
41
+ readonly maxReadBytes?: number;
42
+ readonly retentionMs?: number;
43
+ readonly now?: () => number;
44
+ /** Core retention facts, never a guest callback or a substitute for current read permission. */
45
+ readonly retentionUntil?: (resourceId: string, originRunId: string | null, originalExpiresAt: number) => number;
46
+ readonly reserve?: (bytes: number, options?: {
47
+ readonly control?: boolean;
48
+ }) => Promise<{
49
+ release(): void;
50
+ }>;
51
+ }
52
+ export interface ArtifactPage {
53
+ readonly resources: readonly ArtifactRecord[];
54
+ readonly nextCursor: string | null;
55
+ }
56
+ export type ArtifactInspector = (fixed: {
57
+ readonly path: string;
58
+ readonly size: number;
59
+ readonly name: string;
60
+ readonly mimeType: string;
61
+ }) => Promise<{
62
+ readonly mimeType?: string;
63
+ }>;
64
+ export interface BlobSnapshot {
65
+ readonly blob: Blob;
66
+ /** Node's declared length; every consumer must also count the actual stream. */
67
+ readonly size: number;
68
+ readonly mimeType: string;
69
+ readonly name?: string;
70
+ readonly lastModified?: number;
71
+ }
72
+ /**
73
+ * Node's public Blob getters inspect JS Symbol fields; they are not brand probes.
74
+ * This proves execution-safe native identity, not opaque queue byte length.
75
+ * Consumers must use bounded streams rather than size-then-arrayBuffer/text.
76
+ */
77
+ export declare function snapshotBlob(value: unknown, maximum?: number): BlobSnapshot | null;
78
+ export declare function artifactUri(agentId: string, id: string): string;
79
+ export declare function parseArtifactUri(uri: string): {
80
+ agentId: string;
81
+ resourceId: string;
82
+ };
83
+ /** Fixed content and its directory catalog belong to one Agent/profile. */
84
+ export declare class ArtifactStore {
85
+ #private;
86
+ readonly root: string;
87
+ readonly agentId: string;
88
+ readonly directory: string;
89
+ readonly maxFileBytes: number;
90
+ readonly maxReadBytes: number;
91
+ readonly retentionMs: number;
92
+ constructor(root: string, agentId: string, options?: ArtifactOptions);
93
+ activeSnapshot(): {
94
+ readonly resourceIds: ReadonlySet<string>;
95
+ readonly pendingPaths: ReadonlySet<string>;
96
+ };
97
+ register(value: ArtifactSource, scope: ArtifactScope, inspect?: ArtifactInspector, options?: {
98
+ readonly maxBytes?: number;
99
+ }): Promise<ArtifactRecord>;
100
+ metadata(uri: string, scope: ArtifactScope): Promise<ArtifactRecord>;
101
+ list(scope: ArtifactScope, options?: {
102
+ limit?: number;
103
+ cursor?: string;
104
+ /** Trusted current page budget, counted before advancing its cursor. */
105
+ maxBytes?: number;
106
+ }): Promise<ArtifactPage>;
107
+ open(uri: string, scope: ArtifactScope): Promise<{
108
+ resource: ArtifactRecord;
109
+ stream: Readable;
110
+ closed: Promise<void>;
111
+ }>;
112
+ read(uri: string, scope: ArtifactScope, options: {
113
+ maxBytes: number;
114
+ }): Promise<{
115
+ resource: ArtifactRecord;
116
+ data: Buffer;
117
+ }>;
118
+ }