@nexum-hub/agent 0.0.0-stage → 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (343) hide show
  1. package/README.md +129 -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,459 @@
1
+ import { EventEmitter, once } from "node:events";
2
+ import { performance } from "node:perf_hooks";
3
+ import { AgentError } from "../contracts/errors.js";
4
+ import { safeErrorData } from "../contracts/error-data.js";
5
+ import { defaultEofAlreadyClosed } from "./backend.js";
6
+ import { ProcessOutputLog } from "./output-log.js";
7
+ const instances = new WeakSet();
8
+ export const isManagedProcess = (value) => !!value && typeof value === "object" && instances.has(value);
9
+ async function createBackend(tty, options) {
10
+ const file = process.platform === "win32" ? "windows-pipes" : tty ? "pty" : "pipes";
11
+ const name = process.platform === "win32"
12
+ ? "WindowsProcessBackend"
13
+ : tty
14
+ ? "PtyProcessBackend"
15
+ : "PipeProcessBackend";
16
+ const module = (await import(new URL(`./${file}.js`, import.meta.url).href));
17
+ return new module[name](options);
18
+ }
19
+ const initialFacts = {
20
+ pid: null,
21
+ startedAt: null,
22
+ rootExited: false,
23
+ exitCode: null,
24
+ exitSignal: null,
25
+ outputComplete: false,
26
+ treeStopped: false,
27
+ closed: false,
28
+ stopRequested: false,
29
+ forceRequested: false,
30
+ };
31
+ /** Cold public-protocol resource. No process, environment probe or log is opened by construction. */
32
+ export class ManagedProcess extends EventEmitter {
33
+ agentRoot;
34
+ mode;
35
+ outputOptions;
36
+ closed;
37
+ input;
38
+ #closed = Promise.withResolvers();
39
+ #completed = Promise.withResolvers();
40
+ #stop = new AbortController();
41
+ #ref;
42
+ #backend;
43
+ #log;
44
+ #flow;
45
+ #preparing = false;
46
+ #started = false;
47
+ #logOpened = false;
48
+ #outputComplete = false;
49
+ #outputFailed = false;
50
+ #preparationUnconfirmed = false;
51
+ #confirmed = false;
52
+ #finishing;
53
+ #disposing;
54
+ #failure;
55
+ #stopReason;
56
+ #prepared;
57
+ #lastReport = "";
58
+ #revision = 0;
59
+ #timer;
60
+ #deadlineWall;
61
+ #deadlineMono;
62
+ #detach = [];
63
+ constructor(agentRoot, input, mode, outputOptions = {}) {
64
+ super();
65
+ this.agentRoot = agentRoot;
66
+ this.mode = mode;
67
+ this.outputOptions = outputOptions;
68
+ this.setMaxListeners(0);
69
+ this.input = input;
70
+ this.closed = this.#closed.promise;
71
+ void this.closed.catch(() => { });
72
+ void this.#completed.promise.catch(() => { });
73
+ instances.add(this);
74
+ }
75
+ get revision() {
76
+ return this.#revision;
77
+ }
78
+ get failure() {
79
+ return this.#failure ?? this.#backend?.failure;
80
+ }
81
+ get log() {
82
+ return this.#log;
83
+ }
84
+ get outputReady() {
85
+ return this.#logOpened;
86
+ }
87
+ bind(ref) {
88
+ if (this.#ref || ref.value !== this)
89
+ throw new AgentError("invalid_process_binding", "The process must retain its one registered identity.");
90
+ this.#ref = ref;
91
+ if (this.#confirmed)
92
+ return;
93
+ const stop = () => {
94
+ void this.dispose(ref.signal.reason).catch((cause) => this.#failed(cause));
95
+ };
96
+ ref.signal.addEventListener("abort", stop, { once: true });
97
+ this.#detach.push(() => ref.signal.removeEventListener("abort", stop));
98
+ if (ref.signal.aborted)
99
+ stop();
100
+ this.#publish();
101
+ }
102
+ facts() {
103
+ const facts = this.#backend?.facts() ?? initialFacts;
104
+ return {
105
+ ...facts,
106
+ closed: this.#confirmed,
107
+ outputComplete: this.#outputComplete,
108
+ treeStopped: this.#backend ? facts.treeStopped : this.#confirmed,
109
+ };
110
+ }
111
+ #checkDeadline() {
112
+ if (!this.#confirmed &&
113
+ !this.#stop.signal.aborted &&
114
+ this.#deadlineWall !== undefined &&
115
+ (Date.now() >= this.#deadlineWall ||
116
+ performance.now() >= this.#deadlineMono))
117
+ void this.dispose(new AgentError("process_timeout", "The process resource deadline expired.")).catch((cause) => this.#failed(cause));
118
+ }
119
+ details() {
120
+ this.#checkDeadline();
121
+ const facts = this.facts();
122
+ const state = this.#confirmed
123
+ ? this.#failure
124
+ ? "failed"
125
+ : "exited"
126
+ : this.#stop.signal.aborted
127
+ ? "stopping"
128
+ : this.#failure
129
+ ? "failed"
130
+ : facts.rootExited
131
+ ? "finishing"
132
+ : this.#started
133
+ ? "running"
134
+ : this.#preparing
135
+ ? "preparing"
136
+ : "registered";
137
+ return {
138
+ state,
139
+ ...facts,
140
+ outputComplete: this.#outputComplete,
141
+ tty: this.input.tty,
142
+ platform: process.platform,
143
+ ...(this.#prepared
144
+ ? {
145
+ executable: this.#prepared.executable.path,
146
+ shell: this.#prepared.shell,
147
+ cwd: this.#prepared.launch.cwd,
148
+ }
149
+ : {}),
150
+ ...(this.#stopReason ? { stopReason: this.#stopReason } : {}),
151
+ ...(this.#preparationUnconfirmed ? { preparationUnconfirmed: true } : {}),
152
+ ...(this.#failure
153
+ ? {
154
+ failure: {
155
+ code: safeErrorData(this.#failure, {
156
+ code: "process_failed",
157
+ message: "The managed process failed.",
158
+ }).code ?? "process_failed",
159
+ },
160
+ }
161
+ : {}),
162
+ };
163
+ }
164
+ #publish() {
165
+ this.#revision++;
166
+ if (this.#ref && !this.#confirmed) {
167
+ const details = this.details(), encoded = JSON.stringify(details);
168
+ if (encoded !== this.#lastReport) {
169
+ this.#ref.report(details);
170
+ this.#lastReport = encoded;
171
+ }
172
+ }
173
+ this.emit("change");
174
+ }
175
+ #changed = () => {
176
+ try {
177
+ this.#publish();
178
+ }
179
+ catch (cause) {
180
+ this.#failed(cause);
181
+ void this.dispose(cause).catch(() => { });
182
+ }
183
+ };
184
+ #failed(cause) {
185
+ this.#failure ??= cause;
186
+ this.#completed.reject(cause);
187
+ try {
188
+ this.#publish();
189
+ }
190
+ catch {
191
+ this.#revision++;
192
+ this.emit("change");
193
+ }
194
+ }
195
+ async start(prepare) {
196
+ if (!this.#ref || this.#flow)
197
+ throw new AgentError("invalid_process_start", "A process starts exactly once after resource registration.");
198
+ this.#stop.signal.throwIfAborted();
199
+ this.#preparing = true;
200
+ if (this.input.timeoutMs !== undefined) {
201
+ this.#deadlineWall = Date.now() + this.input.timeoutMs;
202
+ this.#deadlineMono = performance.now() + this.input.timeoutMs;
203
+ this.#timer = setTimeout(() => this.#checkDeadline(), this.input.timeoutMs);
204
+ }
205
+ const flow = this.#start(prepare);
206
+ this.#flow = flow;
207
+ try {
208
+ await flow;
209
+ }
210
+ catch (cause) {
211
+ if (safeErrorData(cause, {
212
+ code: "process_failed",
213
+ message: "Process preparation failed.",
214
+ }).code === "environment_cleanup_unconfirmed")
215
+ this.#preparationUnconfirmed = true;
216
+ this.#failed(cause);
217
+ await this.dispose(cause).catch((cleanup) => this.#failed(cleanup));
218
+ throw cause;
219
+ }
220
+ }
221
+ async #start(prepare) {
222
+ const signal = this.#stop.signal;
223
+ this.#log = new ProcessOutputLog(this.agentRoot, this.#ref.id, this.outputOptions);
224
+ this.#log.on("change", this.#changed);
225
+ this.#detach.push(() => this.#log?.off("change", this.#changed));
226
+ this.#publish();
227
+ await this.#log.open({ signal });
228
+ this.#logOpened = true;
229
+ signal.throwIfAborted();
230
+ this.#backend = await createBackend(this.input.tty, {
231
+ onOutput: async (stream, bytes) => {
232
+ try {
233
+ await this.#log.append(stream, bytes);
234
+ }
235
+ catch (cause) {
236
+ this.#outputFailed = true;
237
+ this.#failure ??= cause;
238
+ throw cause;
239
+ }
240
+ },
241
+ });
242
+ this.#backend.on("change", this.#changed);
243
+ this.#detach.push(() => this.#backend?.off("change", this.#changed));
244
+ // Observe real native completion before any environment or start operation.
245
+ void this.#backend.closed.then(() => {
246
+ void this.#finish().catch((cause) => this.#failed(cause));
247
+ }, (cause) => this.#failed(cause));
248
+ signal.throwIfAborted();
249
+ this.#prepared = await prepare(signal);
250
+ signal.throwIfAborted();
251
+ await this.#backend.start(this.#prepared.launch);
252
+ signal.throwIfAborted();
253
+ this.#started = true;
254
+ this.#preparing = false;
255
+ this.#publish();
256
+ if (this.input.input !== undefined)
257
+ await this.#backend.write(this.input.input, !this.input.tty && this.mode === "exec", signal);
258
+ else if (!this.input.tty &&
259
+ this.mode === "exec" &&
260
+ !this.#backend.facts().rootExited &&
261
+ !this.#backend.facts().closed) {
262
+ try {
263
+ await this.#backend.write(new Uint8Array(), true, signal);
264
+ }
265
+ catch (cause) {
266
+ signal.throwIfAborted();
267
+ // This is only an idempotent close of an empty Agent write end. Explicit
268
+ // input/user writes, fatal backend errors and unknown I/O failures retain
269
+ // their failures; actual process/output closure is still awaited.
270
+ if (this.#backend.failure !== undefined ||
271
+ !defaultEofAlreadyClosed(cause, this.#backend.facts()))
272
+ throw cause;
273
+ }
274
+ }
275
+ signal.throwIfAborted();
276
+ }
277
+ async #finish() {
278
+ if (this.#confirmed)
279
+ return;
280
+ if (this.#finishing)
281
+ return await this.#finishing;
282
+ const work = (async () => {
283
+ if (this.#flow)
284
+ await this.#flow.catch(() => { });
285
+ if (this.#backend?.failure)
286
+ this.#failure ??= this.#backend.failure;
287
+ const facts = this.#backend?.facts() ?? initialFacts;
288
+ if (this.#backend?.failure && facts.closed && !facts.outputComplete)
289
+ this.#outputFailed = true;
290
+ if (this.#backend &&
291
+ (!facts.closed ||
292
+ !facts.treeStopped ||
293
+ (!facts.outputComplete && !this.#outputFailed)))
294
+ throw new AgentError("process_cleanup_unconfirmed", "The process backend has not confirmed actual tree and output closure.");
295
+ // Known backend failure with settled native readers keeps output incomplete,
296
+ // but cannot retain a physically closed process after its log also closes.
297
+ // Unknown incomplete output still cannot establish resource closure.
298
+ if (this.#preparationUnconfirmed) {
299
+ await this.#log?.close();
300
+ throw new AgentError("process_preparation_unconfirmed", "A preparation process group could not confirm closure.");
301
+ }
302
+ if (this.#logOpened && !this.#outputFailed) {
303
+ try {
304
+ await this.#log.finish();
305
+ this.#outputComplete = true;
306
+ }
307
+ catch (cause) {
308
+ this.#failure ??= cause;
309
+ this.#outputComplete = false;
310
+ // Failed durability is a failure outcome, not evidence that the OS
311
+ // process is still alive. Closure requires the real handle close.
312
+ await this.#log.close();
313
+ }
314
+ }
315
+ else
316
+ await this.#log?.close();
317
+ this.#preparing = false;
318
+ const details = {
319
+ ...this.details(),
320
+ state: this.#failure ? "failed" : "exited",
321
+ closed: true,
322
+ treeStopped: this.#backend ? facts.treeStopped : true,
323
+ outputComplete: this.#outputComplete,
324
+ };
325
+ this.#ref?.report(details);
326
+ this.#confirmed = true;
327
+ if (this.#timer)
328
+ clearTimeout(this.#timer);
329
+ for (const detach of this.#detach.splice(0))
330
+ detach();
331
+ this.#closed.resolve();
332
+ if (this.#failure)
333
+ this.#completed.reject(this.#failure);
334
+ else
335
+ this.#completed.resolve();
336
+ this.#revision++;
337
+ this.emit("change");
338
+ })();
339
+ this.#finishing = work;
340
+ try {
341
+ await work;
342
+ }
343
+ finally {
344
+ if (this.#finishing === work)
345
+ this.#finishing = undefined;
346
+ }
347
+ }
348
+ async wait() {
349
+ return await this.#completed.promise;
350
+ }
351
+ async write(data, eof, signal) {
352
+ this.#checkDeadline();
353
+ this.#stop.signal.throwIfAborted();
354
+ signal.throwIfAborted();
355
+ if (!this.#started || !this.#backend)
356
+ throw new AgentError("process_not_running", "The process input is not available.");
357
+ await this.#backend.write(data, eof, signal);
358
+ }
359
+ async resize(cols, rows) {
360
+ this.#checkDeadline();
361
+ this.#stop.signal.throwIfAborted();
362
+ if (!this.#backend)
363
+ throw new AgentError("process_not_running", "The process terminal is not available.");
364
+ await this.#backend.resize(cols, rows);
365
+ }
366
+ async signal(value) {
367
+ this.#checkDeadline();
368
+ this.#stop.signal.throwIfAborted();
369
+ if (!this.#backend)
370
+ throw new AgentError("process_not_running", "The process signal target is not available.");
371
+ return await this.#backend.signal(value);
372
+ }
373
+ async stop(options = {}, reason = new AgentError("process_stopped", "Process stop was requested.")) {
374
+ this.#requestStop(reason, false);
375
+ const stopping = this.#backend?.stop(options);
376
+ if (this.#flow)
377
+ await this.#flow.catch(() => { });
378
+ if (this.#backend) {
379
+ await (stopping ?? this.#backend.stop(options));
380
+ if (this.#backend.facts().closed)
381
+ await this.#finish().catch((cause) => this.#failed(cause));
382
+ }
383
+ else
384
+ await this.#finish().catch((cause) => this.#failed(cause));
385
+ return { accepted: true, confirmed: this.#confirmed, facts: this.facts() };
386
+ }
387
+ #requestStop(reason, stopBackend = true) {
388
+ if (this.#confirmed || this.#stop.signal.aborted)
389
+ return;
390
+ const safe = safeErrorData(reason, {
391
+ code: "process_stopped",
392
+ message: "Process stop was requested.",
393
+ });
394
+ this.#stopReason = { code: safe.code ?? "process_stopped" };
395
+ if (safe.code === "process_timeout")
396
+ this.#failure ??= reason;
397
+ this.#stop.abort(reason);
398
+ // Stopping must reach a cold/starting backend immediately, before awaiting
399
+ // the preparation flow that may itself still be waiting on native readiness.
400
+ if (stopBackend && this.#backend)
401
+ void Promise.resolve()
402
+ .then(() => this.#backend.dispose(reason))
403
+ .catch((cause) => this.#failed(cause));
404
+ this.#changed();
405
+ }
406
+ async dispose(reason) {
407
+ if (this.#confirmed)
408
+ return;
409
+ this.#requestStop(reason ??
410
+ new AgentError("process_stopped", "Process cleanup was requested."));
411
+ if (this.#disposing)
412
+ return await this.#disposing;
413
+ const work = (async () => {
414
+ // Abort preparation immediately. Its own actual cleanup must finish before
415
+ // this resource can confirm closure or a delayed backend could start.
416
+ if (this.#flow)
417
+ await this.#flow.catch(() => { });
418
+ if (this.#backend) {
419
+ await this.#backend.dispose(reason);
420
+ if (this.#backend.facts().closed)
421
+ await this.#finish();
422
+ }
423
+ else
424
+ await this.#finish();
425
+ })();
426
+ this.#disposing = work;
427
+ try {
428
+ await work;
429
+ }
430
+ finally {
431
+ if (this.#disposing === work)
432
+ this.#disposing = undefined;
433
+ }
434
+ }
435
+ async waitForChange(revision, waitMs, signal) {
436
+ signal.throwIfAborted();
437
+ this.#checkDeadline();
438
+ if (this.#revision !== revision || this.#confirmed || waitMs === 0)
439
+ return;
440
+ const timeout = new AbortController();
441
+ const timer = setTimeout(() => timeout.abort(), waitMs);
442
+ const changed = once(this, "change", {
443
+ signal: AbortSignal.any([signal, timeout.signal]),
444
+ });
445
+ if (this.#revision !== revision || this.#confirmed)
446
+ timeout.abort();
447
+ try {
448
+ await changed;
449
+ }
450
+ catch {
451
+ signal.throwIfAborted();
452
+ }
453
+ finally {
454
+ clearTimeout(timer);
455
+ timeout.abort();
456
+ }
457
+ }
458
+ }
459
+ //# sourceMappingURL=managed.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"managed.js","sourceRoot":"","sources":["../../src/process/managed.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ import { EventEmitter } from "node:events";
2
+ export type ProcessOutputStream = "stdout" | "stderr" | "terminal";
3
+ export interface ProcessOutputOptions {
4
+ /** Total file bytes, including the fixed header and framing. */
5
+ readonly maxBytes?: number;
6
+ readonly maxPendingBytes?: number;
7
+ /** Trusted Core admission for this writer's complete bounded ring and marker. */
8
+ readonly reserve?: (bytes: number) => Promise<{
9
+ release(): void;
10
+ }>;
11
+ }
12
+ export interface ProcessOutputReadOptions {
13
+ readonly cursor?: string;
14
+ readonly maxBytes?: number;
15
+ readonly encoding?: BufferEncoding | null;
16
+ readonly signal?: AbortSignal;
17
+ }
18
+ export interface ProcessOutputPage {
19
+ readonly output: {
20
+ stream: ProcessOutputStream;
21
+ data: string | Buffer;
22
+ }[];
23
+ readonly nextCursor: string;
24
+ readonly hasMoreOutput: boolean;
25
+ readonly truncated: boolean;
26
+ readonly outputComplete: boolean;
27
+ }
28
+ /** A cold, one-writer, bounded disk ring. History is an independent read-only view. */
29
+ export declare class ProcessOutputLog extends EventEmitter {
30
+ #private;
31
+ readonly root: string;
32
+ readonly processId: string;
33
+ readonly path: string;
34
+ readonly maxPendingBytes: number;
35
+ constructor(agentRoot: string, processId: string, options?: ProcessOutputOptions);
36
+ get maxBytes(): number;
37
+ get outputComplete(): boolean;
38
+ open(options?: {
39
+ readonly readOnly?: boolean;
40
+ readonly signal?: AbortSignal;
41
+ }): Promise<void>;
42
+ append(stream: ProcessOutputStream, bytes: Uint8Array, options?: {
43
+ readonly signal?: AbortSignal;
44
+ }): Promise<void>;
45
+ read(options?: ProcessOutputReadOptions): Promise<ProcessOutputPage>;
46
+ finish(options?: {
47
+ readonly signal?: AbortSignal;
48
+ }): Promise<void>;
49
+ close(): Promise<void>;
50
+ }