@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,224 @@
1
+ import { ChildProcess } from "node:child_process";
2
+ import { createRequire } from "node:module";
3
+ import { AgentError, requireCondition } from "../contracts/errors.js";
4
+ const queryLimitedInformation = 0x1000;
5
+ const setQuota = 0x0100;
6
+ const terminateProcess = 0x0001;
7
+ const killOnJobClose = 0x2000;
8
+ let api;
9
+ function native() {
10
+ requireCondition(process.platform === "win32", "windows_job_unsupported", "Windows Job Objects are available only on Windows.");
11
+ if (api)
12
+ return api;
13
+ // Neither the native addon nor a Win32 DLL is loaded on other platforms.
14
+ const require = createRequire(import.meta.url);
15
+ let koffi;
16
+ let kernel32;
17
+ try {
18
+ koffi = require("koffi");
19
+ kernel32 = koffi.load("kernel32.dll");
20
+ }
21
+ catch {
22
+ throw new AgentError("windows_job_native_unavailable", "The Windows Job Object native binding could not be loaded.");
23
+ }
24
+ // Explicit Win32 widths (BOOL/DWORD are 32-bit even on Windows x64).
25
+ // https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-jobobject_basic_limit_information
26
+ const basicLimit = koffi.struct({
27
+ PerProcessUserTimeLimit: "int64_t",
28
+ PerJobUserTimeLimit: "int64_t",
29
+ LimitFlags: "uint32_t",
30
+ MinimumWorkingSetSize: "uintptr_t",
31
+ MaximumWorkingSetSize: "uintptr_t",
32
+ ActiveProcessLimit: "uint32_t",
33
+ Affinity: "uintptr_t",
34
+ PriorityClass: "uint32_t",
35
+ SchedulingClass: "uint32_t",
36
+ });
37
+ const ioCounters = koffi.struct({
38
+ ReadOperationCount: "uint64_t",
39
+ WriteOperationCount: "uint64_t",
40
+ OtherOperationCount: "uint64_t",
41
+ ReadTransferCount: "uint64_t",
42
+ WriteTransferCount: "uint64_t",
43
+ OtherTransferCount: "uint64_t",
44
+ });
45
+ // https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-jobobject_extended_limit_information
46
+ const extendedLimit = koffi.struct({
47
+ BasicLimitInformation: basicLimit,
48
+ IoInfo: ioCounters,
49
+ ProcessMemoryLimit: "uintptr_t",
50
+ JobMemoryLimit: "uintptr_t",
51
+ PeakProcessMemoryUsed: "uintptr_t",
52
+ PeakJobMemoryUsed: "uintptr_t",
53
+ });
54
+ // https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-jobobject_basic_accounting_information
55
+ const accounting = koffi.struct({
56
+ TotalUserTime: "int64_t",
57
+ TotalKernelTime: "int64_t",
58
+ ThisPeriodTotalUserTime: "int64_t",
59
+ ThisPeriodTotalKernelTime: "int64_t",
60
+ TotalPageFaultCount: "uint32_t",
61
+ TotalProcesses: "uint32_t",
62
+ ActiveProcesses: "uint32_t",
63
+ TotalTerminatedProcesses: "uint32_t",
64
+ });
65
+ const func = (declaration) => kernel32.func(declaration);
66
+ const loadedApi = {
67
+ createJob: func("void * __stdcall CreateJobObjectW(void *attributes, void *name)"),
68
+ setJob: func("int32_t __stdcall SetInformationJobObject(void *job, int32_t kind, void *data, uint32_t size)"),
69
+ assign: func("int32_t __stdcall AssignProcessToJobObject(void *job, void *process)"),
70
+ query: func("int32_t __stdcall QueryInformationJobObject(void *job, int32_t kind, void *data, uint32_t size, void *length)"),
71
+ terminate: func("int32_t __stdcall TerminateJobObject(void *job, uint32_t exitCode)"),
72
+ close: func("int32_t __stdcall CloseHandle(void *handle)"),
73
+ openProcess: func("void * __stdcall OpenProcess(uint32_t access, int32_t inherit, uint32_t pid)"),
74
+ currentProcess: func("void * __stdcall GetCurrentProcess()"),
75
+ processTimes: func("int32_t __stdcall GetProcessTimes(void *process, void *creation, void *exit, void *kernel, void *user)"),
76
+ lastError: func("uint32_t __stdcall GetLastError()"),
77
+ extendedLimitSize: extendedLimit.size,
78
+ limitFlagsOffset: extendedLimit.members.BasicLimitInformation.offset +
79
+ basicLimit.members.LimitFlags.offset,
80
+ accountingSize: accounting.size,
81
+ };
82
+ requireCondition(loadedApi.accountingSize === 48 && loadedApi.limitFlagsOffset === 16, "windows_job_abi_mismatch", "The Win32 Job Object structure layout is unsupported.");
83
+ api = loadedApi;
84
+ return loadedApi;
85
+ }
86
+ function failure(nativeApi, operation) {
87
+ // Read immediately, before any other Win32 call. Koffi preserves LastError
88
+ // across synchronous calls; only fixed operation names and the code escape.
89
+ const win32Code = nativeApi.lastError();
90
+ return new AgentError("windows_job_native_error", `The Windows ${operation} operation failed.`, { operation, win32Code });
91
+ }
92
+ function closeHandle(nativeApi, handle) {
93
+ if (!nativeApi.close(handle))
94
+ throw failure(nativeApi, "CloseHandle");
95
+ }
96
+ function birth(nativeApi, handle) {
97
+ // FILETIME is two DWORDs. Reading copied bytes as BigInt avoids precision loss
98
+ // and avoids the FILETIME-to-ULARGE_INTEGER pointer cast forbidden by Win32.
99
+ const creation = Buffer.alloc(8);
100
+ if (!nativeApi.processTimes(handle, creation, Buffer.alloc(8), Buffer.alloc(8), Buffer.alloc(8)))
101
+ throw failure(nativeApi, "GetProcessTimes");
102
+ return creation.readBigUInt64LE().toString();
103
+ }
104
+ function childPid(child) {
105
+ requireCondition(child instanceof ChildProcess &&
106
+ Number.isInteger(child.pid) &&
107
+ child.pid > 0 &&
108
+ child.pid <= 0xffffffff &&
109
+ child.pid !== process.pid &&
110
+ typeof child.spawnfile === "string" &&
111
+ child.spawnfile.length > 0 &&
112
+ child.exitCode === null &&
113
+ child.signalCode === null, "windows_job_invalid_child", "A live, newly spawned ChildProcess is required for Job Object assignment.");
114
+ return child.pid;
115
+ }
116
+ function withChildHandle(nativeApi, child, access, action) {
117
+ const handle = nativeApi.openProcess(access, 0, childPid(child));
118
+ if (!handle)
119
+ throw failure(nativeApi, "OpenProcess");
120
+ try {
121
+ return action(handle);
122
+ }
123
+ finally {
124
+ closeHandle(nativeApi, handle);
125
+ }
126
+ }
127
+ /** Read-only self identity for the trusted helper's pre-start IPC handshake. */
128
+ export function getCurrentProcessBirthIdentity() {
129
+ const nativeApi = native();
130
+ // GetCurrentProcess returns a pseudo-handle, which must never be closed.
131
+ return birth(nativeApi, nativeApi.currentProcess());
132
+ }
133
+ /** Read-only capture for a privately retained Node child; not a public PID API. */
134
+ export function captureChildProcessBirthIdentity(child) {
135
+ const nativeApi = native();
136
+ return withChildHandle(nativeApi, child, queryLimitedInformation, (handle) => birth(nativeApi, handle));
137
+ }
138
+ /**
139
+ * Host-private Win32 ownership primitive; never expose this controller to scripts.
140
+ * The caller must keep its trusted helper waiting for IPC until assignChild has
141
+ * succeeded. Assigning an already-running business process cannot close the
142
+ * pre-assignment descendant race. The launcher must supply only its own private
143
+ * ChildProcess object: Node exposes mutable pid/spawnfile properties, so shape
144
+ * validation here is not proof of child provenance or script authorization.
145
+ * No taskkill/PID-tree fallback is performed.
146
+ */
147
+ export class WindowsJob {
148
+ #handle;
149
+ #api;
150
+ constructor(nativeApi, handle) {
151
+ this.#api = nativeApi;
152
+ this.#handle = handle;
153
+ }
154
+ static create() {
155
+ const nativeApi = native();
156
+ // NULL attributes -> noninheritable handle; NULL name -> private fresh Job.
157
+ const handle = nativeApi.createJob(null, null);
158
+ if (!handle)
159
+ throw failure(nativeApi, "CreateJobObjectW");
160
+ try {
161
+ const limits = Buffer.alloc(nativeApi.extendedLimitSize);
162
+ limits.writeUInt32LE(killOnJobClose, nativeApi.limitFlagsOffset);
163
+ if (!nativeApi.setJob(handle, 9, limits, limits.length))
164
+ throw failure(nativeApi, "SetInformationJobObject");
165
+ return new WindowsJob(nativeApi, handle);
166
+ }
167
+ catch (error) {
168
+ closeHandle(nativeApi, handle);
169
+ throw error;
170
+ }
171
+ }
172
+ get closed() {
173
+ return this.#handle === undefined;
174
+ }
175
+ #open() {
176
+ requireCondition(this.#handle !== undefined, "windows_job_closed", "The Windows Job Object handle has been closed.");
177
+ return this.#handle;
178
+ }
179
+ assignChild(child, expectedBirthIdentity) {
180
+ const job = this.#open();
181
+ requireCondition(typeof expectedBirthIdentity === "string" &&
182
+ /^[1-9][0-9]{0,19}$/.test(expectedBirthIdentity) &&
183
+ BigInt(expectedBirthIdentity) <= 0xffffffffffffffffn, "windows_job_invalid_birth_identity", "A precise decimal Windows process creation identity is required.");
184
+ withChildHandle(this.#api, child, queryLimitedInformation | setQuota | terminateProcess, (handle) => {
185
+ requireCondition(birth(this.#api, handle) === expectedBirthIdentity, "windows_job_birth_mismatch", "The spawned child no longer matches the expected process identity.");
186
+ // The same handle stays open from identity validation through assignment:
187
+ // even if that process exits now, a reused PID cannot substitute for it.
188
+ if (!this.#api.assign(job, handle))
189
+ throw failure(this.#api, "AssignProcessToJobObject");
190
+ });
191
+ }
192
+ queryAccounting() {
193
+ const handle = this.#open();
194
+ const data = Buffer.alloc(this.#api.accountingSize);
195
+ if (!this.#api.query(handle, 1, data, data.length, null))
196
+ throw failure(this.#api, "QueryInformationJobObject");
197
+ return Object.freeze({
198
+ totalUserTime100ns: data.readBigInt64LE(0).toString(),
199
+ totalKernelTime100ns: data.readBigInt64LE(8).toString(),
200
+ thisPeriodTotalUserTime100ns: data.readBigInt64LE(16).toString(),
201
+ thisPeriodTotalKernelTime100ns: data.readBigInt64LE(24).toString(),
202
+ totalPageFaultCount: data.readUInt32LE(32),
203
+ totalProcesses: data.readUInt32LE(36),
204
+ activeProcesses: data.readUInt32LE(40),
205
+ totalTerminatedProcesses: data.readUInt32LE(44),
206
+ });
207
+ }
208
+ /** Delivery only. Query activeProcesses and await actual stdio closure after. */
209
+ terminate(exitCode = 1) {
210
+ const handle = this.#open();
211
+ requireCondition(Number.isInteger(exitCode) && exitCode >= 0 && exitCode <= 0xffffffff, "windows_job_invalid_exit_code", "A Windows termination exit code must be an unsigned 32-bit integer.");
212
+ if (!this.#api.terminate(handle, exitCode))
213
+ throw failure(this.#api, "TerminateJobObject");
214
+ }
215
+ /** True only after actual CloseHandle success; repeated close is a no-op. */
216
+ close() {
217
+ if (this.#handle === undefined)
218
+ return false;
219
+ closeHandle(this.#api, this.#handle);
220
+ this.#handle = undefined;
221
+ return true;
222
+ }
223
+ }
224
+ //# sourceMappingURL=windows-job.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"windows-job.js","sourceRoot":"","sources":["../../src/process/windows-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAuDtE,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,IAAI,GAA0B,CAAC;AAE/B,SAAS,MAAM;IACb,gBAAgB,CACd,OAAO,CAAC,QAAQ,KAAK,OAAO,EAC5B,yBAAyB,EACzB,oDAAoD,CACrD,CAAC;IACF,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,yEAAyE;IACzE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,KAA6B,CAAC;IAClC,IAAI,QAAuC,CAAC;IAC5C,IAAI,CAAC;QACH,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACzB,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAClB,gCAAgC,EAChC,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,qEAAqE;IACrE,uGAAuG;IACvG,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,uBAAuB,EAAE,SAAS;QAClC,mBAAmB,EAAE,SAAS;QAC9B,UAAU,EAAE,UAAU;QACtB,qBAAqB,EAAE,WAAW;QAClC,qBAAqB,EAAE,WAAW;QAClC,kBAAkB,EAAE,UAAU;QAC9B,QAAQ,EAAE,WAAW;QACrB,aAAa,EAAE,UAAU;QACzB,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,kBAAkB,EAAE,UAAU;QAC9B,mBAAmB,EAAE,UAAU;QAC/B,mBAAmB,EAAE,UAAU;QAC/B,iBAAiB,EAAE,UAAU;QAC7B,kBAAkB,EAAE,UAAU;QAC9B,kBAAkB,EAAE,UAAU;KAC/B,CAAC,CAAC;IACH,0GAA0G;IAC1G,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;QACjC,qBAAqB,EAAE,UAAU;QACjC,MAAM,EAAE,UAAU;QAClB,kBAAkB,EAAE,WAAW;QAC/B,cAAc,EAAE,WAAW;QAC3B,qBAAqB,EAAE,WAAW;QAClC,iBAAiB,EAAE,WAAW;KAC/B,CAAC,CAAC;IACH,4GAA4G;IAC5G,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9B,aAAa,EAAE,SAAS;QACxB,eAAe,EAAE,SAAS;QAC1B,uBAAuB,EAAE,SAAS;QAClC,yBAAyB,EAAE,SAAS;QACpC,mBAAmB,EAAE,UAAU;QAC/B,cAAc,EAAE,UAAU;QAC1B,eAAe,EAAE,UAAU;QAC3B,wBAAwB,EAAE,UAAU;KACrC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,CACX,WAAmB,EACA,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAsB,CAAC;IACxE,MAAM,SAAS,GAAc;QAC3B,SAAS,EAAE,IAAI,CACb,iEAAiE,CAClE;QACD,MAAM,EAAE,IAAI,CACV,+FAA+F,CAChG;QACD,MAAM,EAAE,IAAI,CACV,sEAAsE,CACvE;QACD,KAAK,EAAE,IAAI,CACT,+GAA+G,CAChH;QACD,SAAS,EAAE,IAAI,CACb,oEAAoE,CACrE;QACD,KAAK,EAAE,IAAI,CAAC,6CAA6C,CAAC;QAC1D,WAAW,EAAE,IAAI,CACf,8EAA8E,CAC/E;QACD,cAAc,EAAE,IAAI,CAAC,sCAAsC,CAAC;QAC5D,YAAY,EAAE,IAAI,CAChB,wGAAwG,CACzG;QACD,SAAS,EAAE,IAAI,CAAC,mCAAmC,CAAC;QACpD,iBAAiB,EAAE,aAAa,CAAC,IAAI;QACrC,gBAAgB,EACd,aAAa,CAAC,OAAQ,CAAC,qBAAsB,CAAC,MAAM;YACpD,UAAU,CAAC,OAAQ,CAAC,UAAW,CAAC,MAAM;QACxC,cAAc,EAAE,UAAU,CAAC,IAAI;KAChC,CAAC;IACF,gBAAgB,CACd,SAAS,CAAC,cAAc,KAAK,EAAE,IAAI,SAAS,CAAC,gBAAgB,KAAK,EAAE,EACpE,0BAA0B,EAC1B,uDAAuD,CACxD,CAAC;IACF,GAAG,GAAG,SAAS,CAAC;IAChB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,SAAoB,EAAE,SAAiB;IACtD,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;IACxC,OAAO,IAAI,UAAU,CACnB,0BAA0B,EAC1B,eAAe,SAAS,oBAAoB,EAC5C,EAAE,SAAS,EAAE,SAAS,EAAE,CACzB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAoB,EAAE,MAAc;IACvD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,MAAM,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,KAAK,CACZ,SAAoB,EACpB,MAAc;IAEd,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,IACE,CAAC,SAAS,CAAC,YAAY,CACrB,MAAM,EACN,QAAQ,EACR,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EACf,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EACf,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAChB;QAED,MAAM,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAmB;IACnC,gBAAgB,CACd,KAAK,YAAY,YAAY;QAC3B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QAC3B,KAAK,CAAC,GAAI,GAAG,CAAC;QACd,KAAK,CAAC,GAAI,IAAI,UAAU;QACxB,KAAK,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;QACzB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAC1B,KAAK,CAAC,QAAQ,KAAK,IAAI;QACvB,KAAK,CAAC,UAAU,KAAK,IAAI,EAC3B,2BAA2B,EAC3B,2EAA2E,CAC5E,CAAC;IACF,OAAO,KAAK,CAAC,GAAI,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CACtB,SAAoB,EACpB,KAAmB,EACnB,MAAc,EACd,MAA6B;IAE7B,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,MAAM,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,8BAA8B;IAC5C,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,yEAAyE;IACzE,OAAO,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gCAAgC,CAC9C,KAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,OAAO,eAAe,CAAC,SAAS,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,MAAM,EAAE,EAAE,CAC3E,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACrB,OAAO,CAAqB;IACnB,IAAI,CAAY;IAEzB,YAAoB,SAAoB,EAAE,MAAc;QACtD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,MAAM;QACX,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,4EAA4E;QAC5E,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,MAAM,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACzD,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACjE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACrD,MAAM,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;YACtD,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IACpC,CAAC;IAED,KAAK;QACH,gBAAgB,CACd,IAAI,CAAC,OAAO,KAAK,SAAS,EAC1B,oBAAoB,EACpB,gDAAgD,CACjD,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,WAAW,CACT,KAAmB,EACnB,qBAAkD;QAElD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,gBAAgB,CACd,OAAO,qBAAqB,KAAK,QAAQ;YACvC,oBAAoB,CAAC,IAAI,CAAC,qBAAqB,CAAC;YAChD,MAAM,CAAC,qBAAqB,CAAC,IAAI,mBAAmB,EACtD,oCAAoC,EACpC,kEAAkE,CACnE,CAAC;QACF,eAAe,CACb,IAAI,CAAC,IAAI,EACT,KAAK,EACL,uBAAuB,GAAG,QAAQ,GAAG,gBAAgB,EACrD,CAAC,MAAM,EAAE,EAAE;YACT,gBAAgB,CACd,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,qBAAqB,EAClD,4BAA4B,EAC5B,oEAAoE,CACrE,CAAC;YACF,0EAA0E;YAC1E,yEAAyE;YACzE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC;gBAChC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;QACzD,CAAC,CACF,CAAC;IACJ,CAAC;IAED,eAAe;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;YACtD,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACrD,oBAAoB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACvD,4BAA4B,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;YAChE,8BAA8B,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;YAClE,mBAAmB,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC1C,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,wBAAwB,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IACjF,SAAS,CAAC,QAAQ,GAAG,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,gBAAgB,CACd,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,UAAU,EACrE,+BAA+B,EAC/B,qEAAqE,CACtE,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;YACxC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7C,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
@@ -0,0 +1,16 @@
1
+ import { EventEmitter } from "node:events";
2
+ import type { ProcessBackend, ProcessBackendOptions, ProcessFacts, ProcessLaunch, ProcessSignalReceipt, ProcessStopOptions, ProcessStopReceipt } from "./backend.js";
3
+ /** Cold, host-private Windows launcher. Public resource registration precedes start. */
4
+ export declare class WindowsProcessBackend extends EventEmitter implements ProcessBackend {
5
+ #private;
6
+ readonly closed: Promise<void>;
7
+ constructor(options: ProcessBackendOptions);
8
+ get failure(): unknown;
9
+ facts(): ProcessFacts;
10
+ start(launch: ProcessLaunch): Promise<void>;
11
+ write(data: Uint8Array, eof: boolean, signal: AbortSignal): Promise<void>;
12
+ resize(cols: number, rows: number): Promise<void>;
13
+ signal(signal: NodeJS.Signals): Promise<ProcessSignalReceipt>;
14
+ stop(options?: ProcessStopOptions): Promise<ProcessStopReceipt>;
15
+ dispose(): Promise<void>;
16
+ }