@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,208 @@
1
+ import path from "node:path";
2
+ import { constants, closeSync, fstatSync, lstatSync, openSync, readSync, realpathSync, } from "node:fs";
3
+ import { AgentError, requireCondition } from "../contracts/errors.js";
4
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
5
+ import { privateMaintenanceRead, privateMaintenanceWrite, } from "../maintenance/credentials.js";
6
+ import { maintenanceText } from "../maintenance/files.js";
7
+ const fileLimit = 32 * 1024 * 1024;
8
+ const recordLimit = 64 * 1024 * 1024;
9
+ const recordPath = ["packages.json"];
10
+ const packageName = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
11
+ const exactVersion = /^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/;
12
+ function name(value) {
13
+ return (typeof value === "string" &&
14
+ value.length <= 214 &&
15
+ packageName.test(value) &&
16
+ !value.split("/").some((part) => part === "." || part === ".."));
17
+ }
18
+ function version(value) {
19
+ return (typeof value === "string" && value.length <= 256 && exactVersion.test(value));
20
+ }
21
+ function document(value) {
22
+ requireCondition(typeof value === "string" && Buffer.byteLength(value) <= fileLimit, "package_approval_invalid", "Approved npm evidence needs bounded manifest and lock text.");
23
+ let parsed;
24
+ try {
25
+ parsed = JSON.parse(value);
26
+ }
27
+ catch {
28
+ /* Report no source text or parser details. */
29
+ }
30
+ requireCondition(isPlainRecord(parsed), "package_approval_invalid", "Approved npm evidence must contain JSON objects.");
31
+ return parsed;
32
+ }
33
+ function declared(manifest, target) {
34
+ return ["dependencies", "devDependencies", "optionalDependencies"].some((group) => isPlainRecord(manifest[group]) &&
35
+ typeof manifest[group][target] === "string");
36
+ }
37
+ /** A synchronous ModulePolicy callback must reject disk drift before returning any approval. */
38
+ function matches(filename, expected) {
39
+ let fd;
40
+ try {
41
+ fd = openSync(filename, constants.O_RDONLY |
42
+ (constants.O_NOFOLLOW ?? 0) |
43
+ (constants.O_NONBLOCK ?? 0));
44
+ const before = fstatSync(fd), bytes = Buffer.from(expected);
45
+ if (!before.isFile() ||
46
+ before.size !== bytes.length ||
47
+ bytes.length > fileLimit)
48
+ return false;
49
+ const chunk = Buffer.allocUnsafe(65536);
50
+ let offset = 0;
51
+ while (offset < bytes.length) {
52
+ const count = readSync(fd, chunk, 0, Math.min(chunk.length, bytes.length - offset), null);
53
+ if (!count ||
54
+ !chunk.subarray(0, count).equals(bytes.subarray(offset, offset + count)))
55
+ return false;
56
+ offset += count;
57
+ }
58
+ if (readSync(fd, chunk, 0, 1, null) !== 0)
59
+ return false;
60
+ const after = fstatSync(fd), current = lstatSync(filename);
61
+ return (current.isFile() &&
62
+ before.dev === after.dev &&
63
+ before.ino === after.ino &&
64
+ before.size === after.size &&
65
+ before.mtimeMs === after.mtimeMs &&
66
+ before.ctimeMs === after.ctimeMs &&
67
+ current.dev === after.dev &&
68
+ current.ino === after.ino);
69
+ }
70
+ catch {
71
+ return false;
72
+ }
73
+ finally {
74
+ if (fd !== undefined)
75
+ closeSync(fd);
76
+ }
77
+ }
78
+ /** Private explicit package approvals; the work manifest and installed packages never grant approval. */
79
+ export class ApprovedPackageCatalog {
80
+ root;
81
+ binding;
82
+ reserve;
83
+ #record = null;
84
+ #accepting = false;
85
+ constructor(root, binding, reserve) {
86
+ this.root = root;
87
+ this.binding = binding;
88
+ this.reserve = reserve;
89
+ }
90
+ static async open(root, binding, options = {}) {
91
+ const actual = realpathSync.native(root);
92
+ requireCondition(actual === root &&
93
+ typeof binding.agentId === "string" &&
94
+ binding.agentId.length > 0 &&
95
+ Buffer.byteLength(binding.agentId) <= 256 &&
96
+ !/[\0\r\n]/.test(binding.agentId) &&
97
+ ["development", "production"].includes(binding.profile), "package_approval_invalid", "The package catalog must use its actual Agent/profile root and binding.");
98
+ const catalog = new ApprovedPackageCatalog(actual, Object.freeze({ ...binding }), options.reserve);
99
+ const saved = await privateMaintenanceRead(actual, recordPath, recordLimit);
100
+ if (saved !== null) {
101
+ requireCondition(saved.version === 1 &&
102
+ saved.root === actual &&
103
+ saved.agentId === binding.agentId &&
104
+ saved.profile === binding.profile &&
105
+ Object.keys(saved).every((key) => [
106
+ "version",
107
+ "root",
108
+ "agentId",
109
+ "profile",
110
+ "approved",
111
+ "manifest",
112
+ "lock",
113
+ ].includes(key)) &&
114
+ isPlainRecord(saved.approved) &&
115
+ Object.entries(saved.approved).every(([key, value]) => name(key) && version(value)), "package_approval_invalid", "Saved package approvals do not belong to this actual Agent/profile or contain invalid identities.");
116
+ document(saved.manifest);
117
+ document(saved.lock);
118
+ catalog.#record = saved;
119
+ }
120
+ return catalog;
121
+ }
122
+ #work() {
123
+ const work = path.join(this.root, "work");
124
+ try {
125
+ if (realpathSync.native(this.root) === this.root &&
126
+ lstatSync(work).isDirectory() &&
127
+ realpathSync.native(work) === work)
128
+ return work;
129
+ }
130
+ catch {
131
+ /* Do not expose private filesystem paths through system errors. */
132
+ }
133
+ throw new AgentError("package_approval_changed", "The npm work directory cannot redirect away from this profile.");
134
+ }
135
+ approvedPackages() {
136
+ if (!this.#record)
137
+ return new Map();
138
+ try {
139
+ const work = this.#work();
140
+ if (matches(path.join(work, "package.json"), this.#record.manifest) &&
141
+ matches(path.join(work, "package-lock.json"), this.#record.lock))
142
+ return new Map(Object.entries(this.#record.approved));
143
+ }
144
+ catch {
145
+ /* An unreadable or redirected work tree grants no npm access. */
146
+ }
147
+ return new Map();
148
+ }
149
+ async accept(snapshot) {
150
+ requireCondition(!this.#accepting, "package_approval_busy", "A verified package approval is already being saved.");
151
+ const fixed = JSON.parse(canonicalJson(snapshot, recordLimit));
152
+ requireCondition(isPlainRecord(fixed) &&
153
+ Object.keys(fixed).every((key) => ["target", "manifest", "lock"].includes(key)) &&
154
+ isPlainRecord(fixed.target) &&
155
+ Object.keys(fixed.target).every((key) => ["name", "action", "version"].includes(key)) &&
156
+ name(fixed.target.name) &&
157
+ ["install", "update", "remove"].includes(fixed.target.action) &&
158
+ (fixed.target.action === "remove"
159
+ ? fixed.target.version === null
160
+ : version(fixed.target.version)), "package_approval_invalid", "A package approval requires one explicit exact npm target.");
161
+ const manifest = document(fixed.manifest), lock = document(fixed.lock);
162
+ const locked = isPlainRecord(lock.packages)
163
+ ? lock.packages[`node_modules/${fixed.target.name}`]
164
+ : undefined;
165
+ requireCondition(fixed.target.action === "remove"
166
+ ? !declared(manifest, fixed.target.name)
167
+ : declared(manifest, fixed.target.name) &&
168
+ isPlainRecord(locked) &&
169
+ locked.version === fixed.target.version, "package_approval_invalid", "The verified manifest and lock must describe the explicit package target.");
170
+ this.#accepting = true;
171
+ try {
172
+ const work = this.#work();
173
+ let actual;
174
+ try {
175
+ actual = await Promise.all([
176
+ maintenanceText(path.join(work, "package.json"), fileLimit),
177
+ maintenanceText(path.join(work, "package-lock.json"), fileLimit),
178
+ ]);
179
+ }
180
+ catch {
181
+ throw new AgentError("package_approval_changed", "The actual npm files could not be safely verified.");
182
+ }
183
+ requireCondition(this.#work() === work &&
184
+ actual[0] === fixed.manifest &&
185
+ actual[1] === fixed.lock, "package_approval_changed", "The npm files changed after the approved installation was verified.");
186
+ const approved = new Map(Object.entries(this.#record?.approved ?? {}));
187
+ if (fixed.target.action === "remove")
188
+ approved.delete(fixed.target.name);
189
+ else
190
+ approved.set(fixed.target.name, fixed.target.version);
191
+ const record = {
192
+ version: 1,
193
+ agentId: this.binding.agentId,
194
+ profile: this.binding.profile,
195
+ root: this.root,
196
+ approved: Object.fromEntries(approved),
197
+ manifest: fixed.manifest,
198
+ lock: fixed.lock,
199
+ };
200
+ await privateMaintenanceWrite(this.root, recordPath, record, false, this.reserve);
201
+ this.#record = record;
202
+ }
203
+ finally {
204
+ this.#accepting = false;
205
+ }
206
+ }
207
+ }
208
+ //# sourceMappingURL=packages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"packages.js","sourceRoot":"","sources":["../../src/application/packages.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACnC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,MAAM,UAAU,GAAG,CAAC,eAAe,CAAU,CAAC;AAC9C,MAAM,WAAW,GAAG,oDAAoD,CAAC;AACzE,MAAM,YAAY,GAAG,0DAA0D,CAAC;AAUhF,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,IAAI,GAAG;QACnB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;QACvB,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAChE,CAAC;AACJ,CAAC;AACD,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAC7E,CAAC;AACJ,CAAC;AACD,SAAS,QAAQ,CAAC,KAAc;IAC9B,gBAAgB,CACd,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,EAClE,0BAA0B,EAC1B,6DAA6D,CAC9D,CAAC;IACF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;IACD,gBAAgB,CACd,aAAa,CAAC,MAAM,CAAC,EACrB,0BAA0B,EAC1B,kDAAkD,CACnD,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,SAAS,QAAQ,CAAC,QAAiC,EAAE,MAAc;IACjE,OAAO,CAAC,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,IAAI,CACrE,CAAC,KAAK,EAAE,EAAE,CACR,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAC9C,CAAC;AACJ,CAAC;AACD,gGAAgG;AAChG,SAAS,OAAO,CAAC,QAAgB,EAAE,QAAgB;IACjD,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CACX,QAAQ,EACR,SAAS,CAAC,QAAQ;YAChB,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC;YAC3B,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAC9B,CAAC;QACF,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,EAC1B,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,IACE,CAAC,MAAM,CAAC,MAAM,EAAE;YAChB,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;YAC5B,KAAK,CAAC,MAAM,GAAG,SAAS;YAExB,OAAO,KAAK,CAAC;QACf,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,QAAQ,CACpB,EAAE,EACF,KAAK,EACL,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC7C,IAAI,CACL,CAAC;YACF,IACE,CAAC,KAAK;gBACN,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;gBAExE,OAAO,KAAK,CAAC;YACf,MAAM,IAAI,KAAK,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACxD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,EACzB,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CACL,OAAO,CAAC,MAAM,EAAE;YAChB,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;YACxB,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;YACxB,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YAC1B,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAChC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAChC,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG;YACzB,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAC1B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,OAAO,sBAAsB;IAItB;IACA;IACA;IALX,OAAO,GAAyB,IAAI,CAAC;IACrC,UAAU,GAAG,KAAK,CAAC;IACnB,YACW,IAAY,EACZ,OAAwD,EACxD,OAAyD;QAFzD,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAiD;QACxD,YAAO,GAAP,OAAO,CAAkD;IACjE,CAAC;IACJ,MAAM,CAAC,KAAK,CAAC,IAAI,CACf,IAAY,EACZ,OAA8C,EAC9C,UAAyE,EAAE;QAE3E,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,gBAAgB,CACd,MAAM,KAAK,IAAI;YACb,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YACnC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC1B,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,GAAG;YACzC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACjC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EACzD,0BAA0B,EAC1B,yEAAyE,CAC1E,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,sBAAsB,CACxC,MAAM,EACN,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,EAC7B,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,gBAAgB,CACd,KAAK,CAAC,OAAO,KAAK,CAAC;gBACjB,KAAK,CAAC,IAAI,KAAK,MAAM;gBACrB,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;gBACjC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;gBACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/B;oBACE,SAAS;oBACT,MAAM;oBACN,SAAS;oBACT,SAAS;oBACT,UAAU;oBACV,UAAU;oBACV,MAAM;iBACP,CAAC,QAAQ,CAAC,GAAG,CAAC,CAChB;gBACD,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAClC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAC9C,EACH,0BAA0B,EAC1B,mGAAmG,CACpG,CAAC;YACF,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACzB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,CAAC,OAAO,GAAG,KAAiC,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,IACE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;gBAC5C,SAAS,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;gBAC7B,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI;gBAElC,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;QACD,MAAM,IAAI,UAAU,CAClB,0BAA0B,EAC1B,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IACE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAEhE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;QACD,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,QAAiC;QAC5C,gBAAgB,CACd,CAAC,IAAI,CAAC,UAAU,EAChB,uBAAuB,EACvB,qDAAqD,CACtD,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CACtB,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CACV,CAAC;QAC7B,gBAAgB,CACd,aAAa,CAAC,KAAK,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAC/B,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC7C;YACD,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACtC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC5C;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7D,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAC/B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI;gBAC/B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EACpC,0BAA0B,EAC1B,4DAA4D,CAC7D,CAAC;QACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EACvC,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpD,CAAC,CAAC,SAAS,CAAC;QACd,gBAAgB,CACd,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;YAC9B,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;YACxC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;gBACnC,aAAa,CAAC,MAAM,CAAC;gBACrB,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,EAC7C,0BAA0B,EAC1B,2EAA2E,CAC5E,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,MAAkC,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBACzB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC;oBAC3D,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,SAAS,CAAC;iBACjE,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,UAAU,CAClB,0BAA0B,EAC1B,oDAAoD,CACrD,CAAC;YACJ,CAAC;YACD,gBAAgB,CACd,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI;gBACnB,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ;gBAC5B,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,EAC1B,0BAA0B,EAC1B,qEAAqE,CACtE,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;YACvE,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;gBAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;gBACpE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,OAAQ,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAkB;gBAC5B,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;gBACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC;YACF,MAAM,uBAAuB,CAC3B,IAAI,CAAC,IAAI,EACT,UAAU,EACV,MAA+B,EAC/B,KAAK,EACL,IAAI,CAAC,OAAO,CACb,CAAC;YACF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,49 @@
1
+ import { type Caller } from "../contracts/caller.js";
2
+ import type { JsonObject, ResourceRecord } from "../contracts/types.js";
3
+ import { ResourceManager } from "../extensions/resources.js";
4
+ import type { ResourceHistoryRecord } from "../storage/sqlite.js";
5
+ export interface ProcessSnapshot extends JsonObject {
6
+ readonly processId: string;
7
+ readonly originRunId: string | null;
8
+ readonly contextId: string | null;
9
+ readonly projectId: string | null;
10
+ readonly status: string;
11
+ readonly lifetime: ResourceRecord["lifetime"];
12
+ readonly createdAt: number;
13
+ readonly closedAt: number | null;
14
+ readonly handedOffAt: number | null;
15
+ readonly controlAvailable: boolean;
16
+ readonly details: JsonObject;
17
+ }
18
+ export interface ProcessListInput {
19
+ readonly projectId?: string;
20
+ readonly limit?: number;
21
+ readonly cursor?: string;
22
+ }
23
+ export interface ProcessPage {
24
+ readonly items: readonly ProcessSnapshot[];
25
+ readonly nextCursor: string | null;
26
+ readonly observedAt: number;
27
+ }
28
+ export interface ApplicationProcessOptions {
29
+ /** null verifies the current Agent authority even for an empty page. */
30
+ authorize(caller: Caller, record: ResourceHistoryRecord | null, action: "read" | "stop"): void;
31
+ readonly now?: () => number;
32
+ }
33
+ /** Owner Console projection of existing sh resources; it owns no process controllers or execution state. */
34
+ export declare class ApplicationProcesses {
35
+ #private;
36
+ readonly resources: ResourceManager;
37
+ readonly options: ApplicationProcessOptions;
38
+ constructor(resources: ResourceManager, options: ApplicationProcessOptions);
39
+ get(caller: Caller, input: {
40
+ readonly processId: string;
41
+ }): ProcessSnapshot;
42
+ stop(caller: Caller, input: {
43
+ readonly processId: string;
44
+ }): Promise<{
45
+ accepted: boolean;
46
+ item: ProcessSnapshot;
47
+ }>;
48
+ list(caller: Caller, input?: ProcessListInput): ProcessPage;
49
+ }
@@ -0,0 +1,180 @@
1
+ import { authorizeCall, callerKey, fixedCaller, } from "../contracts/caller.js";
2
+ import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
3
+ import { canonicalJson, digest, isPlainRecord } from "../contracts/json.js";
4
+ import { resourceReadDenied, } from "../extensions/resources.js";
5
+ import { CONTROL_OWNER, CONTROL_VERSION } from "../runtime/control-scripts.js";
6
+ const detailsKeys = new Set([
7
+ "state",
8
+ "pid",
9
+ "startedAt",
10
+ "rootExited",
11
+ "exitCode",
12
+ "exitSignal",
13
+ "outputComplete",
14
+ "treeStopped",
15
+ "closed",
16
+ "stopRequested",
17
+ "forceRequested",
18
+ "tty",
19
+ "platform",
20
+ "executable",
21
+ "shell",
22
+ "cwd",
23
+ "stopReason",
24
+ "preparationUnconfirmed",
25
+ "failure",
26
+ ]);
27
+ const copy = (value, maximum = 32768) => JSON.parse(canonicalJson(value, maximum));
28
+ /** Owner Console projection of existing sh resources; it owns no process controllers or execution state. */
29
+ export class ApplicationProcesses {
30
+ resources;
31
+ options;
32
+ constructor(resources, options) {
33
+ this.resources = resources;
34
+ this.options = options;
35
+ }
36
+ #caller(caller) {
37
+ caller = fixedCaller(caller);
38
+ requireCondition(caller.source === "owner_session", "forbidden", "Process inspection requires the current owner Console session.");
39
+ authorizeCall(() => this.options.authorize(caller, null, "read"));
40
+ return caller;
41
+ }
42
+ #belongs(record) {
43
+ const source = record.source;
44
+ return (record.bootId === this.resources.store.bootId &&
45
+ record.kind === "sh.process" &&
46
+ source.type === "platform" &&
47
+ source.owner === CONTROL_OWNER &&
48
+ source.namespace === "sh" &&
49
+ source.version === CONTROL_VERSION &&
50
+ source.revision === CONTROL_VERSION &&
51
+ record.originRunId !== null);
52
+ }
53
+ #source(record) {
54
+ requireCondition(this.#belongs(record), "process_unavailable", "Only this boot's actual built-in sh process resources are available.");
55
+ }
56
+ #authorize(caller, record, action) {
57
+ this.#source(record);
58
+ authorizeCall(() => this.options.authorize(caller, record, action));
59
+ }
60
+ #project(record) {
61
+ if (record.originRunId === null)
62
+ return null;
63
+ try {
64
+ return this.resources.store.getRun(record.originRunId).projectId;
65
+ }
66
+ catch (cause) {
67
+ if (isAgentError(cause) && cause.code === "run_not_found")
68
+ return null;
69
+ throw cause;
70
+ }
71
+ }
72
+ #snapshot(snapshot) {
73
+ const row = this.resources.store.resourceHistory(snapshot.id);
74
+ this.#source(row);
75
+ return copy({
76
+ processId: snapshot.id,
77
+ originRunId: snapshot.originRunId,
78
+ contextId: snapshot.contextId,
79
+ projectId: this.#project(row),
80
+ status: snapshot.status,
81
+ lifetime: snapshot.lifetime,
82
+ createdAt: snapshot.createdAt,
83
+ closedAt: snapshot.closedAt,
84
+ handedOffAt: snapshot.handedOffAt,
85
+ controlAvailable: snapshot.controlAvailable,
86
+ details: Object.fromEntries(Object.entries(snapshot.details).filter(([key]) => detailsKeys.has(key))),
87
+ });
88
+ }
89
+ #id(input) {
90
+ const fixed = copy(input, 4096);
91
+ requireCondition(isPlainRecord(fixed) &&
92
+ Object.keys(fixed).length === 1 &&
93
+ typeof fixed.processId === "string" &&
94
+ /^res_[0-9a-f]{32}$/.test(fixed.processId), "invalid_process_id", "Use an actual managed process resource identity, never an OS PID.");
95
+ return fixed.processId;
96
+ }
97
+ get(caller, input) {
98
+ caller = this.#caller(caller);
99
+ return this.#snapshot(this.resources.inspectResource(this.#id(input), (record) => this.#authorize(caller, record, "read")));
100
+ }
101
+ async stop(caller, input) {
102
+ caller = this.#caller(caller);
103
+ const result = await this.resources.disposeResource(this.#id(input), (record) => this.#authorize(caller, record, "stop"), new AgentError("process_stopped", "The current owner requested managed process shutdown."));
104
+ return { accepted: result.accepted, item: this.#snapshot(result.snapshot) };
105
+ }
106
+ list(caller, input = {}) {
107
+ caller = this.#caller(caller);
108
+ const query = copy(input, 8192);
109
+ requireCondition(isPlainRecord(query) &&
110
+ Object.keys(query).every((key) => ["projectId", "limit", "cursor"].includes(key)), "invalid_process_query", "Use only project and pagination fields.");
111
+ const limit = query.limit ?? 20;
112
+ requireCondition(typeof limit === "number" &&
113
+ Number.isSafeInteger(limit) &&
114
+ limit >= 1 &&
115
+ limit <= 100, "invalid_limit", "A process page contains between 1 and 100 items.");
116
+ requireCondition(query.projectId === undefined ||
117
+ (typeof query.projectId === "string" &&
118
+ query.projectId.length > 0 &&
119
+ Buffer.byteLength(query.projectId) <= 256 &&
120
+ !/[\0\r\n]/.test(query.projectId)), "invalid_process_query", "Use one bounded Project identity.");
121
+ requireCondition(query.cursor === undefined ||
122
+ (typeof query.cursor === "string" &&
123
+ query.cursor.length > 0 &&
124
+ query.cursor.length <= 4096), "invalid_cursor", "The process cursor is invalid.");
125
+ const scope = digest({
126
+ caller: callerKey(caller),
127
+ sessionRef: caller.sessionRef ?? null,
128
+ bootId: this.resources.store.bootId,
129
+ projectId: query.projectId ?? null,
130
+ });
131
+ const filter = {
132
+ owner: CONTROL_OWNER,
133
+ namespace: "sh",
134
+ type: "platform",
135
+ kind: "sh.process",
136
+ };
137
+ const items = [];
138
+ let cursor = query.cursor, scanned = 0, bytes = 0;
139
+ while (scanned < 1000) {
140
+ authorizeCall(() => this.options.authorize(caller, null, "read"));
141
+ const page = this.resources.store.scanResourceHistory(filter, scope, Math.min(100, 1000 - scanned), cursor);
142
+ for (let n = 0; n < page.items.length; n++) {
143
+ const candidate = page.items[n], previous = cursor;
144
+ cursor = candidate.cursor;
145
+ scanned++;
146
+ if (!this.#belongs(candidate.record))
147
+ continue;
148
+ if (query.projectId !== undefined &&
149
+ this.#project(candidate.record) !== query.projectId)
150
+ continue;
151
+ let snapshot;
152
+ try {
153
+ snapshot = this.resources.inspectResource(candidate.record.resourceId, (record) => this.#authorize(caller, record, "read"));
154
+ }
155
+ catch (cause) {
156
+ if (resourceReadDenied(cause))
157
+ continue;
158
+ throw cause;
159
+ }
160
+ const item = this.#snapshot(snapshot), size = Buffer.byteLength(canonicalJson(item));
161
+ if (bytes + size > 60 * 1024)
162
+ return this.#page(caller, items, previous ?? null);
163
+ bytes += size;
164
+ items.push(item);
165
+ if (items.length === limit)
166
+ return this.#page(caller, items, n < page.items.length - 1 || page.more ? cursor : null);
167
+ }
168
+ if (!page.more)
169
+ return this.#page(caller, items, null);
170
+ }
171
+ return this.#page(caller, items, cursor ?? null);
172
+ }
173
+ #page(caller, items, nextCursor) {
174
+ authorizeCall(() => this.options.authorize(caller, null, "read"));
175
+ const observedAt = (this.options.now ?? Date.now)();
176
+ requireCondition(Number.isSafeInteger(observedAt) && observedAt >= 0, "invalid_process_clock", "The observation time must be a valid timestamp.");
177
+ return { items, nextCursor, observedAt };
178
+ }
179
+ }
180
+ //# sourceMappingURL=processes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/application/processes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { JsonObject, RunRecord } from "../contracts/types.js";
2
+ import type { WireBudgetsV2, WireFixedStreamRefV2, WireRunV2, WireRunViewV2 } from "../contracts/wire.js";
3
+ import type { RunDetails, RunView } from "../runtime/engine.js";
4
+ import type { ResultEncoder, ResultScope } from "../results/encoder.js";
5
+ export declare function projectRunRecord(run: RunRecord, options?: {
6
+ readonly root?: string;
7
+ readonly availability?: Partial<WireRunV2["availability"]>;
8
+ }): WireRunV2;
9
+ export interface RunProjectionPorts {
10
+ readonly readOnly?: boolean;
11
+ readonly encoder: ResultEncoder;
12
+ readonly scope: ResultScope;
13
+ readonly budgets: WireBudgetsV2;
14
+ shipJson(value: JsonObject, purpose: "result-meta"): Promise<WireFixedStreamRefV2>;
15
+ }
16
+ /** Core facts become bounded wire data here; no result is rerun and no media is encoded as control JSON. */
17
+ export declare function projectRunView(view: RunView | RunDetails, ports: RunProjectionPorts): Promise<WireRunViewV2>;