@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,167 @@
1
+ import { lstatSync, realpathSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import vm from "node:vm";
4
+ import { AgentError, isAgentError } from "../contracts/errors.js";
5
+ import { newId } from "../contracts/json.js";
6
+ import { loadProfileConfig, profileRoot } from "./config.js";
7
+ import { reconnectControl } from "./connection.js";
8
+ import { AgentRuntime } from "./runtime.js";
9
+ import { maintenanceRuntimeOptions } from "./maintenance.js";
10
+ import { WorkGitSchedule } from "./work-git.js";
11
+ import { appendDiagnostic } from "./diagnostics.js";
12
+ /** Native process entry: one boot/Core survives reconnects; only observations are replaced. */
13
+ export async function runAgent(profile, options) {
14
+ let runtime;
15
+ let git;
16
+ let initializing;
17
+ let stopping = false;
18
+ let shutdownTask;
19
+ let reserve;
20
+ const lifetime = new AbortController();
21
+ const signal = lifetime.signal;
22
+ let failure;
23
+ let diagnosticRoot;
24
+ const diagnose = (code, retry) => {
25
+ // Never serialize native/plugin errors, request data, configuration or credentials.
26
+ if (diagnosticRoot) {
27
+ try {
28
+ appendDiagnostic(diagnosticRoot, profile, code, retry);
29
+ }
30
+ catch {
31
+ process.stderr.write("agent_log_unavailable\n");
32
+ }
33
+ }
34
+ options.diagnose?.(code, retry);
35
+ process.stderr.write(`${code}${retry ? ": retrying" : ""}\n`);
36
+ };
37
+ const shutdown = () => {
38
+ if (shutdownTask)
39
+ return shutdownTask;
40
+ stopping = true;
41
+ shutdownTask = (async () => {
42
+ try {
43
+ // Keep the authenticated cleanup channel open until Core/native I/O
44
+ // has joined. An OS stop is not an observation disconnect.
45
+ await initializing?.catch(() => { });
46
+ const closed = await Promise.allSettled([
47
+ git?.close(),
48
+ runtime?.close(),
49
+ ]);
50
+ const failed = closed.find((entry) => entry.status === "rejected");
51
+ if (failed?.status === "rejected")
52
+ throw failed.reason;
53
+ }
54
+ finally {
55
+ lifetime.abort(new AgentError("runtime_closed", "The Agent process is stopping."));
56
+ }
57
+ })();
58
+ void shutdownTask.catch(() => { });
59
+ return shutdownTask;
60
+ };
61
+ const stop = () => {
62
+ void shutdown();
63
+ };
64
+ options.signal?.addEventListener("abort", stop, { once: true });
65
+ try {
66
+ if (options.signal?.aborted)
67
+ return 0;
68
+ // An existing profile can retain a fixed launch/configuration error without
69
+ // parsing credentials or creating a new profile as a side effect.
70
+ try {
71
+ const candidate = profileRoot(profile, realpathSync.native(options.home ?? homedir()));
72
+ const directory = lstatSync(candidate, { throwIfNoEntry: false });
73
+ if (directory?.isDirectory() &&
74
+ realpathSync.native(candidate) === candidate)
75
+ diagnosticRoot = candidate;
76
+ }
77
+ catch {
78
+ /* A missing home/profile cannot provide a private diagnostic location. */
79
+ }
80
+ if (typeof vm.SourceTextModule !== "function") {
81
+ diagnose("vm_modules_required", false);
82
+ return 0; // Permanent local launch configuration; a supervisor must not spin.
83
+ }
84
+ const config = loadProfileConfig(profile, options.home);
85
+ diagnosticRoot = config.root;
86
+ const bootId = newId("boot");
87
+ const defaults = maintenanceRuntimeOptions(config);
88
+ const configure = options.runtime?.configureMaintenance ?? defaults.configureMaintenance;
89
+ await reconnectControl({
90
+ serverUrl: config.serverUrl,
91
+ token: config.token,
92
+ profile,
93
+ bootId,
94
+ version: options.version,
95
+ signal,
96
+ async ready(connection) {
97
+ try {
98
+ if (stopping)
99
+ throw new AgentError("runtime_closed", "The Agent is stopping.");
100
+ if (runtime)
101
+ runtime.attachConnection(connection);
102
+ else {
103
+ initializing = AgentRuntime.create(config, connection, bootId, {
104
+ version: options.version,
105
+ home: options.home,
106
+ ...defaults,
107
+ ...options.runtime,
108
+ async configureMaintenance(components) {
109
+ reserve = components.reserve;
110
+ return await configure(components);
111
+ },
112
+ });
113
+ try {
114
+ runtime = await initializing;
115
+ }
116
+ finally {
117
+ initializing = undefined;
118
+ }
119
+ if (!stopping) {
120
+ git = new WorkGitSchedule(config.root, (code) => diagnose(code, false), reserve);
121
+ git.start();
122
+ }
123
+ }
124
+ if (stopping)
125
+ return;
126
+ diagnose("agent_connected", false);
127
+ }
128
+ catch (cause) {
129
+ if (!stopping)
130
+ failure = cause;
131
+ void shutdown();
132
+ throw cause;
133
+ }
134
+ },
135
+ invoke(message, observer) {
136
+ if (!runtime || stopping)
137
+ throw new AgentError("runtime_unavailable", "The Agent has not initialized.");
138
+ return runtime.dispatch(message, observer);
139
+ },
140
+ async event(message, observer) {
141
+ if (!runtime || stopping)
142
+ throw new AgentError("runtime_unavailable", "The Agent has not initialized.");
143
+ await runtime.event(message, observer);
144
+ },
145
+ }, diagnose);
146
+ if (failure)
147
+ throw failure;
148
+ return 0;
149
+ }
150
+ catch (cause) {
151
+ const code = isAgentError(cause) ? cause.code : "agent_failed";
152
+ diagnose(/^[a-z0-9_]{1,128}$/.test(code) ? code : "agent_failed", false);
153
+ return code === "invalid_configuration" ? 0 : 1;
154
+ }
155
+ finally {
156
+ options.signal?.removeEventListener("abort", stop);
157
+ try {
158
+ await shutdown();
159
+ }
160
+ catch {
161
+ diagnose("agent_shutdown_unconfirmed", false);
162
+ // This overrides a normal return; do not report successful cleanup.
163
+ throw new AgentError("agent_shutdown_unconfirmed", "The Agent's native resources have not confirmed closure.");
164
+ }
165
+ }
166
+ }
167
+ //# sourceMappingURL=main.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/application/main.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import type { WireInvokeV2 } from "../contracts/wire.js";
2
+ import { MaintenanceRequests, type MaintenanceAuthority, type MaintenanceBackend, type MaintenanceScope } from "../maintenance/requests.js";
3
+ import type { ProfileConfiguration } from "./config.js";
4
+ import type { ApplicationComponents, AgentRuntimeOptions } from "./runtime.js";
5
+ /** The six authority methods use the authenticated connection; scripts cannot mint decisions. */
6
+ export declare class ControlMaintenanceAuthority implements MaintenanceAuthority {
7
+ #private;
8
+ readonly components: ApplicationComponents;
9
+ constructor(components: ApplicationComponents);
10
+ create: MaintenanceAuthority["create"];
11
+ get: MaintenanceAuthority["get"];
12
+ list: MaintenanceAuthority["list"];
13
+ cancel: MaintenanceAuthority["cancel"];
14
+ decision: MaintenanceAuthority["decision"];
15
+ beginExecution: MaintenanceAuthority["beginExecution"];
16
+ }
17
+ /** Transport adaptation around the existing maintenance operation and native controller. */
18
+ export declare class MaintenanceApplication {
19
+ #private;
20
+ readonly components: ApplicationComponents;
21
+ readonly requests: MaintenanceRequests;
22
+ constructor(components: ApplicationComponents, backend: MaintenanceBackend, approvalOrigin: string);
23
+ dispatch(message: WireInvokeV2, scope: MaintenanceScope, observerSignal: AbortSignal): Promise<unknown>;
24
+ close(): Promise<void>;
25
+ }
26
+ /** Npm and connection configuration share the same confirmed authority and lifecycle. */
27
+ export declare function maintenanceRuntimeOptions(config: ProfileConfiguration, configuration?: (components: ApplicationComponents) => MaintenanceBackend | Promise<MaintenanceBackend>): Pick<AgentRuntimeOptions, "configureMaintenance" | "dispatchMaintenance">;
@@ -0,0 +1,244 @@
1
+ import { AgentError, requireCondition } from "../contracts/errors.js";
2
+ import { callerKey } from "../contracts/caller.js";
3
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
4
+ import { validateContract } from "../contracts/validation.js";
5
+ import { MaintenanceRequests, } from "../maintenance/requests.js";
6
+ import { MaintenanceBackends, NpmMaintenanceBackend, } from "../maintenance/npm.js";
7
+ const plain = (value) => JSON.parse(canonicalJson(value));
8
+ /** The six authority methods use the authenticated connection; scripts cannot mint decisions. */
9
+ export class ControlMaintenanceAuthority {
10
+ components;
11
+ constructor(components) {
12
+ this.components = components;
13
+ }
14
+ #context(identity) {
15
+ const { store } = this.components;
16
+ for (const key of ["agentId", "profile", "cloudEnvironment"])
17
+ requireCondition(identity[key] === store.binding[key], "maintenance_binding_mismatch", "Maintenance belongs to this Agent profile only.");
18
+ const caller = {
19
+ principalId: identity.principalId,
20
+ clientId: identity.clientId,
21
+ grantId: identity.grantId,
22
+ };
23
+ requireCondition(callerKey(caller) === identity.callerKey, "maintenance_binding_mismatch", "The verified maintenance caller does not match its identity.");
24
+ return this.components.context(caller);
25
+ }
26
+ async #request(identity, operation, input, signal) {
27
+ return await this.components
28
+ .control()
29
+ .request(operation, this.#context(identity), input, signal);
30
+ }
31
+ create = async (who, input, signal) => plain(await this.#request(who, "maintenance.request.create", input, signal));
32
+ get = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.get", { requestId }, signal));
33
+ list = async (who, options, signal) => plain(await this.#request(who, "maintenance.request.list", options, signal));
34
+ cancel = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.cancel", { requestId }, signal));
35
+ decision = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.decision", { requestId }, signal));
36
+ beginExecution = async (who, input, signal) => plain(await this.#request(who, "maintenance.request.beginExecution", input, signal));
37
+ }
38
+ function observe(promise, signal) {
39
+ signal.throwIfAborted();
40
+ return new Promise((resolve, reject) => {
41
+ const abort = () => reject(signal.reason);
42
+ signal.addEventListener("abort", abort, { once: true });
43
+ void promise
44
+ .then(resolve, reject)
45
+ .finally(() => signal.removeEventListener("abort", abort));
46
+ if (signal.aborted)
47
+ abort();
48
+ });
49
+ }
50
+ /** Transport adaptation around the existing maintenance operation and native controller. */
51
+ export class MaintenanceApplication {
52
+ components;
53
+ requests;
54
+ #executions = new Map();
55
+ #pending = new Set();
56
+ #closed = false;
57
+ #unregister;
58
+ constructor(components, backend, approvalOrigin) {
59
+ this.components = components;
60
+ this.requests = new MaintenanceRequests(components.store, new ControlMaintenanceAuthority(components), backend, { approvalOrigin, reserve: components.reserve });
61
+ this.#unregister = components.onShutdown(() => this.close());
62
+ }
63
+ #scope(scope, signal) {
64
+ return {
65
+ ...scope,
66
+ signal: AbortSignal.any([scope.signal, signal, this.components.signal]),
67
+ };
68
+ }
69
+ async #current(requestId, revision, scope) {
70
+ const view = await this.requests.get(requestId, scope);
71
+ requireCondition(revision === undefined || revision === view.revision, "maintenance_revision_conflict", "The maintenance request changed; reload its current revision.");
72
+ return view;
73
+ }
74
+ #start(message, scope) {
75
+ const requestId = message.input.requestId;
76
+ const previous = this.#executions.get(requestId);
77
+ if (previous) {
78
+ requireCondition(previous.callerKey === callerKey(scope.caller) &&
79
+ previous.grantId === scope.caller.grantId, "maintenance_binding_mismatch", "The execution belongs to its original caller and Grant.");
80
+ return previous;
81
+ }
82
+ requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
83
+ const controller = new AbortController();
84
+ const accepted = Promise.withResolvers();
85
+ // The Core operation is independent of the observing WebSocket and the original script.
86
+ const signal = AbortSignal.any([controller.signal, this.components.signal]);
87
+ const lease = this.components.startLease(scope.caller, { maintenanceRequestId: requestId, originInvocationId: message.id }, signal);
88
+ const executionScope = {
89
+ ...lease.scope,
90
+ onAccepted: () => accepted.resolve(),
91
+ };
92
+ const task = (async () => {
93
+ await lease.refresh();
94
+ return await this.requests.execute(requestId, executionScope);
95
+ })();
96
+ const entry = {
97
+ controller,
98
+ callerKey: callerKey(scope.caller),
99
+ grantId: scope.caller.grantId,
100
+ accepted: accepted.promise,
101
+ task,
102
+ };
103
+ this.#executions.set(requestId, entry);
104
+ void accepted.promise.catch(() => { });
105
+ void task
106
+ .then(() => accepted.resolve(), (error) => accepted.reject(error))
107
+ .finally(() => {
108
+ lease.close();
109
+ if (this.#executions.get(requestId) === entry)
110
+ this.#executions.delete(requestId);
111
+ });
112
+ // Retain errors on the real Promise without introducing an unhandled rejection.
113
+ void task.catch(() => { });
114
+ return entry;
115
+ }
116
+ async dispatch(message, scope, observerSignal) {
117
+ requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
118
+ const pending = this.#dispatch(message, scope, observerSignal);
119
+ this.#pending.add(pending);
120
+ try {
121
+ return await pending;
122
+ }
123
+ finally {
124
+ this.#pending.delete(pending);
125
+ }
126
+ }
127
+ async #dispatch(message, scope, observerSignal) {
128
+ requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
129
+ const input = message.input;
130
+ const reading = this.#scope(scope, observerSignal);
131
+ if (message.operation === "agent.maintenance.get")
132
+ return await this.requests.get(input.requestId, reading);
133
+ if (message.operation === "agent.maintenance.execute") {
134
+ const current = await this.#current(input.requestId, undefined, reading);
135
+ if (this.components.store.getMaintenanceOperation(input.requestId))
136
+ return current;
137
+ const entry = this.#start(message, scope);
138
+ await observe(entry.accepted, observerSignal);
139
+ return await this.requests.get(input.requestId, reading);
140
+ }
141
+ if (message.operation === "agent.maintenance.cancel") {
142
+ const current = await this.#current(input.requestId, undefined, reading);
143
+ const entry = this.#executions.get(input.requestId);
144
+ if (!entry)
145
+ return current.execution
146
+ ? current
147
+ : await this.requests.cancel(input.requestId, reading);
148
+ requireCondition(entry.callerKey === callerKey(scope.caller) &&
149
+ entry.grantId === scope.caller.grantId, "maintenance_binding_mismatch", "The execution belongs to its original caller and Grant.");
150
+ entry.controller.abort(new AgentError("maintenance_cancelled", "The user requested maintenance cancellation."));
151
+ await observe(entry.task.catch(() => { }), observerSignal);
152
+ return await this.requests.get(input.requestId, reading);
153
+ }
154
+ await this.#current(input.requestId, input.revision, reading);
155
+ if (message.operation === "agent.maintenance.draft.notify")
156
+ return { requestId: input.requestId, notified: true };
157
+ if (message.operation === "agent.maintenance.draft.verify")
158
+ return await this.requests.verify(input.requestId, reading);
159
+ let result;
160
+ if (message.operation === "agent.maintenance.draft.read")
161
+ result = await this.requests.readDraft(input.requestId, reading);
162
+ else {
163
+ requireCondition(input.body &&
164
+ input.revision !== undefined &&
165
+ input.body.purpose === "maintenance" &&
166
+ input.body.direction === "cloud-to-agent" &&
167
+ input.body.mimeType === "application/json", "invalid_maintenance_body", "Use the authenticated fixed maintenance JSON channel.");
168
+ requireCondition(input.body.size <= 512 * 1024, "invalid_maintenance_body", "The maintenance input exceeds its byte budget.");
169
+ const permit = this.components.streams.tryAcquire();
170
+ requireCondition(permit, "transfer_busy", "All actual file stream slots are occupied.");
171
+ let value;
172
+ try {
173
+ value = await this.components
174
+ .data()
175
+ .readJson(input.body, reading.signal);
176
+ }
177
+ finally {
178
+ permit.release();
179
+ }
180
+ requireCondition(isPlainRecord(value), "invalid_maintenance_body", "The maintenance body must be an object.");
181
+ reading.assertCurrent();
182
+ if (message.operation === "agent.maintenance.draft.prepare") {
183
+ validateContract("wire.body:MaintenanceDraftInput", value);
184
+ requireCondition(value.revision === input.revision, "maintenance_revision_conflict", "The body revision differs from its control request.");
185
+ result = await this.requests.prepareDraft(input.requestId, value, reading);
186
+ }
187
+ else if (message.operation === "agent.maintenance.oauth.start") {
188
+ validateContract("wire.body:MaintenanceOAuthBinding", value);
189
+ result = await this.requests.startOAuth(input.requestId, input.revision, value, reading);
190
+ }
191
+ else if (message.operation === "agent.maintenance.oauth.complete") {
192
+ validateContract("wire.body:MaintenanceOAuthComplete", value);
193
+ result = await this.requests.completeOAuth(input.requestId, input.revision, value, reading);
194
+ }
195
+ else
196
+ throw new AgentError("unknown_operation", "This maintenance operation is not registered.");
197
+ }
198
+ const contract = message.operation === "agent.maintenance.draft.read"
199
+ ? "MaintenanceDraftRead"
200
+ : message.operation === "agent.maintenance.oauth.start"
201
+ ? "MaintenanceOAuthLaunch"
202
+ : "MaintenancePrepared";
203
+ validateContract(`wire.body:${contract}`, result);
204
+ reading.assertCurrent();
205
+ const object = JSON.parse(canonicalJson(result, 1024 * 1024));
206
+ return {
207
+ body: await this.components.shipJson(object, "maintenance", reading.signal, message.context, message.id),
208
+ };
209
+ }
210
+ async close() {
211
+ this.#closed = true;
212
+ this.#unregister();
213
+ const active = [...this.#executions.values()];
214
+ for (const entry of active)
215
+ entry.controller.abort(new AgentError("runtime_closed", "The Agent is stopping."));
216
+ await Promise.allSettled(active.map((entry) => entry.task));
217
+ await Promise.allSettled([...this.#pending]);
218
+ }
219
+ }
220
+ /** Npm and connection configuration share the same confirmed authority and lifecycle. */
221
+ export function maintenanceRuntimeOptions(config, configuration) {
222
+ let application;
223
+ return {
224
+ async configureMaintenance(components) {
225
+ const npm = new NpmMaintenanceBackend({
226
+ root: config.root,
227
+ modules: components.modules,
228
+ extensions: components.extensions,
229
+ enablement: components.enablement,
230
+ refreshPackages: components.refreshPackages,
231
+ reserve: components.reserve,
232
+ });
233
+ application = new MaintenanceApplication(components, new MaintenanceBackends(npm, configuration
234
+ ? await configuration(components)
235
+ : await components.configurationBackend()), config.serverUrl);
236
+ return application.requests;
237
+ },
238
+ async dispatchMaintenance(message, scope, _components, _service, observerSignal) {
239
+ requireCondition(application, "maintenance_unavailable", "The maintenance service has not initialized.");
240
+ return await application.dispatch(message, scope, observerSignal);
241
+ },
242
+ };
243
+ }
244
+ //# sourceMappingURL=maintenance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/application/maintenance.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { Profile } from "../contracts/types.js";
2
+ import type { VerifiedPackageSnapshot } from "../maintenance/npm.js";
3
+ /** Private explicit package approvals; the work manifest and installed packages never grant approval. */
4
+ export declare class ApprovedPackageCatalog {
5
+ #private;
6
+ readonly root: string;
7
+ readonly binding: Readonly<{
8
+ agentId: string;
9
+ profile: Profile;
10
+ }>;
11
+ readonly reserve?: ((bytes: number) => Promise<{
12
+ release(): void;
13
+ }>) | undefined;
14
+ private constructor();
15
+ static open(root: string, binding: {
16
+ agentId: string;
17
+ profile: Profile;
18
+ }, options?: {
19
+ reserve?: (bytes: number) => Promise<{
20
+ release(): void;
21
+ }>;
22
+ }): Promise<ApprovedPackageCatalog>;
23
+ approvedPackages(): ReadonlyMap<string, string>;
24
+ accept(snapshot: VerifiedPackageSnapshot): Promise<void>;
25
+ }