@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,213 @@
1
+ import path from "node:path";
2
+ import { realpathSync, lstatSync } from "node:fs";
3
+ import { AgentError, requireCondition } from "../contracts/errors.js";
4
+ import { callerKey } from "../contracts/caller.js";
5
+ import { canonicalJson } from "../contracts/json.js";
6
+ import { validateConnectionV2, validatePolicyLeaseV2, } from "../contracts/wire-validation.js";
7
+ import { contains } from "../runtime/paths.js";
8
+ import { validateContract } from "../contracts/validation.js";
9
+ import { performance } from "node:perf_hooks";
10
+ const copy = (value) => JSON.parse(canonicalJson(value));
11
+ function targetPath(value) {
12
+ requireCondition(path.isAbsolute(value) && !value.includes("\0"), "path_not_allowed", "A managed filesystem target needs an absolute path.");
13
+ let ancestor = path.normalize(value);
14
+ const remaining = [];
15
+ while (true) {
16
+ try {
17
+ return path.resolve(realpathSync.native(ancestor), ...remaining);
18
+ }
19
+ catch (cause) {
20
+ const code = cause.code;
21
+ // Broken redirects and access errors cannot be treated as absent directories.
22
+ if (code !== "ENOENT" || lstatSync(ancestor, { throwIfNoEntry: false }))
23
+ throw new AgentError("path_not_allowed", "The managed path cannot be resolved safely.");
24
+ const parent = path.dirname(ancestor);
25
+ requireCondition(parent !== ancestor, "path_not_allowed", "The managed path has no existing ancestor.");
26
+ remaining.unshift(path.basename(ancestor));
27
+ ancestor = parent;
28
+ }
29
+ }
30
+ }
31
+ /** Synchronous current policy for Core callbacks, refreshed only through authenticated Cloud evidence. */
32
+ export class AgentAuthority {
33
+ binding;
34
+ work;
35
+ #connection;
36
+ #policies = new Map();
37
+ #now;
38
+ constructor(binding, work, now = Date.now) {
39
+ this.binding = Object.freeze({
40
+ agentId: binding.agentId,
41
+ profile: binding.profile,
42
+ bootId: binding.bootId,
43
+ cloudEnvironment: binding.cloudEnvironment,
44
+ });
45
+ this.work = realpathSync.native(work);
46
+ let logical = now(), monotonic = performance.now();
47
+ this.#now = () => {
48
+ const next = performance.now();
49
+ logical = Math.max(now(), logical + next - monotonic);
50
+ monotonic = next;
51
+ return Math.floor(logical);
52
+ };
53
+ }
54
+ connect(binding) {
55
+ for (const key of [
56
+ "agentId",
57
+ "profile",
58
+ "bootId",
59
+ "cloudEnvironment",
60
+ ])
61
+ requireCondition(binding[key] === this.binding[key], "runtime_binding_mismatch", "This process cannot adopt a different Agent, profile, boot or Cloud environment.");
62
+ this.#connection = copy(binding);
63
+ }
64
+ #key(caller, projectId = null) {
65
+ const session = caller.source === "owner_session";
66
+ requireCondition(session
67
+ ? typeof caller.sessionRef === "string" &&
68
+ /^[0-9a-f]{64}$/.test(caller.sessionRef) &&
69
+ caller.clientId === `nexum-console:${caller.sessionRef}` &&
70
+ caller.grantId === undefined
71
+ : (caller.source === undefined || caller.source === "mcp") &&
72
+ typeof caller.grantId === "string" &&
73
+ caller.grantId.length > 0, "unauthorized", "Current Agent access requires its verified Grant or owner session.");
74
+ requireCondition(projectId === null ||
75
+ (typeof projectId === "string" &&
76
+ projectId.length > 0 &&
77
+ projectId.length <= 256), "invalid_authorization_scope", "The policy must retain its actual Agent or Project scope.");
78
+ return canonicalJson([
79
+ callerKey(caller),
80
+ session ? "owner_session" : "mcp",
81
+ session ? caller.sessionRef : caller.grantId,
82
+ projectId,
83
+ ]);
84
+ }
85
+ observe(context) {
86
+ validateContract("wire.type:Caller", context.caller);
87
+ requireCondition(this.#connection, "connection_closed", "No authenticated control connection exists.");
88
+ validateConnectionV2(context.connection, this.#connection);
89
+ validatePolicyLeaseV2(context.authorization, this.#now());
90
+ requireCondition(context.authorization.agentId === this.binding.agentId, "agent_mismatch", "The current policy belongs to another Agent.");
91
+ const fixed = copy(context), projectId = fixed.authorization.projectId ?? null, key = this.#key(fixed.caller, projectId);
92
+ if (!this.#policies.has(key) && this.#policies.size >= 4096) {
93
+ for (const [candidate, cell] of this.#policies)
94
+ if (cell.policy && Date.parse(cell.policy.expiresAt) <= this.#now())
95
+ this.#policies.delete(candidate);
96
+ requireCondition(this.#policies.size < 4096, "authorization_busy", "The current policy cache is occupied.");
97
+ }
98
+ const token = Symbol("policy-observation");
99
+ this.#policies.set(key, {
100
+ token,
101
+ caller: fixed.caller,
102
+ policy: fixed.authorization,
103
+ });
104
+ return { key, token, projectId, context: fixed };
105
+ }
106
+ revoke(caller) {
107
+ const identity = this.#key(caller);
108
+ for (const [key, cell] of this.#policies)
109
+ if (this.#key(cell.caller) === identity)
110
+ this.#policies.set(key, {
111
+ token: Symbol("policy-revoked"),
112
+ caller: copy(caller),
113
+ policy: null,
114
+ });
115
+ }
116
+ current(caller, projectId = null) {
117
+ const cell = this.#policies.get(this.#key(caller, projectId));
118
+ requireCondition(cell?.policy, "forbidden", "The current Cloud authority was revoked or is unavailable.");
119
+ validatePolicyLeaseV2(cell.policy, this.#now());
120
+ return copy(cell.policy);
121
+ }
122
+ capture(caller, projectId = null) {
123
+ const key = this.#key(caller, projectId), cell = this.#policies.get(key);
124
+ requireCondition(cell?.policy && this.#connection, "forbidden", "No current policy observation is available.");
125
+ this.current(caller, projectId);
126
+ return {
127
+ key,
128
+ token: cell.token,
129
+ projectId,
130
+ context: {
131
+ caller: copy(caller),
132
+ authorization: copy(cell.policy),
133
+ connection: copy(this.#connection),
134
+ },
135
+ };
136
+ }
137
+ refresh(observation, policy) {
138
+ if (this.#policies.get(observation.key)?.token !== observation.token)
139
+ return false;
140
+ requireCondition(this.#connection, "connection_closed", "No authenticated control connection exists.");
141
+ requireCondition((policy.projectId ?? null) === observation.projectId, "authorization_scope_mismatch", "A refreshed policy cannot change its Project scope.");
142
+ this.observe({
143
+ ...observation.context,
144
+ connection: this.#connection,
145
+ authorization: policy,
146
+ });
147
+ return true;
148
+ }
149
+ /** Cleanup proves original ownership separately; it does not obtain a new business-access lease. */
150
+ cleanupContext(caller, previous) {
151
+ for (const key of [
152
+ "agentId",
153
+ "profile",
154
+ "bootId",
155
+ "cloudEnvironment",
156
+ ])
157
+ requireCondition(previous.connection[key] === this.binding[key], "connection_mismatch", "Cleanup cannot adopt a resource from another Agent boot or profile.");
158
+ requireCondition(this.#connection && this.#key(caller) === this.#key(previous.caller), "forbidden", "Cleanup must retain the original verified caller.");
159
+ return copy({
160
+ caller,
161
+ authorization: previous.authorization,
162
+ connection: this.#connection,
163
+ });
164
+ }
165
+ context(caller, projectId = null) {
166
+ return this.capture(caller, projectId).context;
167
+ }
168
+ authorize(caller, target, projectId = null) {
169
+ const policy = this.current(caller, projectId);
170
+ if (!target)
171
+ return;
172
+ requireCondition(caller.source !== "owner_session" ||
173
+ target.access === "read" ||
174
+ (target.type === "resource" && target.access === "stop"), "forbidden", "This action is unavailable to the current owner session.");
175
+ if (target.type === "path") {
176
+ const actual = targetPath(target.value);
177
+ // Process execution has its own declared capability. Installed system
178
+ // executables need not live below a data directory; cwd and data access do.
179
+ if (target.access === "execute")
180
+ return;
181
+ const roots = [
182
+ this.work,
183
+ ...policy.allowedRoots,
184
+ ...(target.access === "read"
185
+ ? [path.join(path.dirname(this.work), "logs")]
186
+ : []),
187
+ ];
188
+ requireCondition(roots.some((root) => {
189
+ try {
190
+ return (path.isAbsolute(root) &&
191
+ realpathSync.native(root) === root &&
192
+ contains(root, actual));
193
+ }
194
+ catch {
195
+ return false;
196
+ }
197
+ }), "path_not_allowed", "The managed path is outside the current approved roots.");
198
+ }
199
+ else if (target.type === "url") {
200
+ let url;
201
+ try {
202
+ url = new URL(target.value);
203
+ }
204
+ catch {
205
+ throw new AgentError("url_not_allowed", "The managed network target is invalid.");
206
+ }
207
+ requireCondition(["http:", "https:"].includes(url.protocol) &&
208
+ !url.username &&
209
+ !url.password, "url_not_allowed", "The managed network target is invalid.");
210
+ }
211
+ }
212
+ }
213
+ //# sourceMappingURL=authority.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authority.js","sourceRoot":"","sources":["../../src/application/authority.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { WireCatalogProjectV2, WireEventDataV2 } from "../contracts/wire.js";
2
+ /** Cloud owns the project catalog; this is its bounded live README projection. */
3
+ export declare class AgentCatalog {
4
+ #private;
5
+ readonly publish: (data: WireEventDataV2["agent.catalog.changed"]) => Promise<void>;
6
+ constructor(publish: (data: WireEventDataV2["agent.catalog.changed"]) => Promise<void>);
7
+ project(id: string): WireCatalogProjectV2 | undefined;
8
+ sync(data: WireEventDataV2["agent.catalog.sync"], signal: AbortSignal): Promise<void>;
9
+ refresh(signal?: AbortSignal): Promise<void>;
10
+ close(): Promise<void>;
11
+ }
@@ -0,0 +1,177 @@
1
+ import path from "node:path";
2
+ import { realpathSync, watch } from "node:fs";
3
+ import { requireCondition } from "../contracts/errors.js";
4
+ import { canonicalJson } from "../contracts/json.js";
5
+ import { contains } from "../runtime/paths.js";
6
+ import { readProjectSummary } from "../work/discovery.js";
7
+ /** Cloud owns the project catalog; this is its bounded live README projection. */
8
+ export class AgentCatalog {
9
+ publish;
10
+ #projects = new Map();
11
+ #watchers = [];
12
+ #generation;
13
+ #nextPage = 0;
14
+ #pending = [];
15
+ #roots = [];
16
+ #sequence = 0;
17
+ #closed = false;
18
+ #tail = Promise.resolve();
19
+ #timer;
20
+ constructor(publish) {
21
+ this.publish = publish;
22
+ }
23
+ project(id) {
24
+ return this.#projects.get(id);
25
+ }
26
+ async sync(data, signal) {
27
+ signal.throwIfAborted();
28
+ requireCondition(!this.#closed, "runtime_closed", "The Agent catalog has closed.");
29
+ if (data.page === 0) {
30
+ this.#generation = data.generation;
31
+ this.#nextPage = 0;
32
+ this.#pending = [];
33
+ }
34
+ requireCondition(this.#generation === data.generation &&
35
+ data.page === this.#nextPage &&
36
+ this.#pending.length + data.projects.length <= 10000, "catalog_page_mismatch", "The catalog pages are stale, out of order or too large.");
37
+ this.#pending.push(...JSON.parse(canonicalJson(data.projects)));
38
+ this.#nextPage++;
39
+ if (!data.complete)
40
+ return;
41
+ const projects = new Map();
42
+ for (const item of this.#pending) {
43
+ requireCondition(!projects.has(item.projectId), "catalog_page_mismatch", "A project was repeated in one catalog generation.");
44
+ projects.set(item.projectId, item);
45
+ }
46
+ this.#roots = [...data.allowedRoots];
47
+ this.#projects = projects;
48
+ this.#pending = [];
49
+ for (const watcher of this.#watchers)
50
+ watcher.close();
51
+ this.#watchers = [];
52
+ for (const project of projects.values()) {
53
+ try {
54
+ this.#path(project.root);
55
+ const watcher = watch(project.root, (_event, filename) => {
56
+ if (filename === null ||
57
+ /^readme(?:\..*)?$/i.test(filename.toString()))
58
+ this.#schedule();
59
+ });
60
+ watcher.on("error", () => this.#schedule());
61
+ this.#watchers.push(watcher);
62
+ }
63
+ catch {
64
+ /* The published summary below records unavailable roots. */
65
+ }
66
+ }
67
+ await this.refresh(signal);
68
+ }
69
+ #path(root) {
70
+ requireCondition(path.isAbsolute(root) &&
71
+ realpathSync.native(root) === root &&
72
+ this.#roots.some((allowed) => {
73
+ try {
74
+ return (path.isAbsolute(allowed) &&
75
+ realpathSync.native(allowed) === allowed &&
76
+ contains(allowed, root));
77
+ }
78
+ catch {
79
+ return false;
80
+ }
81
+ }), "path_not_allowed", "The catalog root is outside its current approved roots.");
82
+ }
83
+ #schedule() {
84
+ if (this.#closed || this.#timer)
85
+ return;
86
+ this.#timer = setTimeout(() => {
87
+ this.#timer = undefined;
88
+ void this.refresh().catch(() => { });
89
+ }, 100);
90
+ this.#timer.unref();
91
+ }
92
+ refresh(signal = new AbortController().signal) {
93
+ const task = this.#tail.then(async () => {
94
+ if (this.#closed)
95
+ return;
96
+ const projects = [...this.#projects.values()], generation = this.#generation;
97
+ const summaries = [];
98
+ for (const project of projects) {
99
+ signal.throwIfAborted();
100
+ try {
101
+ this.#path(project.root);
102
+ const summary = await readProjectSummary(project.root, signal);
103
+ summaries.push(summary.status === "updated" &&
104
+ summary.description !== null &&
105
+ summary.revision !== null
106
+ ? {
107
+ projectId: project.projectId,
108
+ root: project.root,
109
+ status: "ok",
110
+ description: summary.description,
111
+ revision: summary.revision,
112
+ }
113
+ : summary.status === "missing"
114
+ ? {
115
+ projectId: project.projectId,
116
+ root: project.root,
117
+ status: "missing",
118
+ }
119
+ : {
120
+ projectId: project.projectId,
121
+ root: project.root,
122
+ status: "unavailable",
123
+ error: {
124
+ code: "readme_unavailable",
125
+ message: "The current project summary is unavailable.",
126
+ },
127
+ });
128
+ }
129
+ catch {
130
+ signal.throwIfAborted();
131
+ summaries.push({
132
+ projectId: project.projectId,
133
+ root: project.root,
134
+ status: "unavailable",
135
+ error: {
136
+ code: "readme_unavailable",
137
+ message: "The current project summary is unavailable.",
138
+ },
139
+ });
140
+ }
141
+ }
142
+ if (this.#closed || generation !== this.#generation)
143
+ return;
144
+ // Keep each ordinary control event below its one-MiB envelope limit.
145
+ let page = [];
146
+ for (const item of summaries) {
147
+ if (page.length &&
148
+ Buffer.byteLength(canonicalJson([...page, item])) > 512 * 1024) {
149
+ await this.publish({
150
+ sequence: ++this.#sequence,
151
+ observedAt: new Date().toISOString(),
152
+ projects: page,
153
+ });
154
+ page = [];
155
+ }
156
+ page.push(item);
157
+ }
158
+ if (page.length)
159
+ await this.publish({
160
+ sequence: ++this.#sequence,
161
+ observedAt: new Date().toISOString(),
162
+ projects: page,
163
+ });
164
+ });
165
+ this.#tail = task.catch(() => { });
166
+ return task;
167
+ }
168
+ async close() {
169
+ this.#closed = true;
170
+ clearTimeout(this.#timer);
171
+ for (const watcher of this.#watchers)
172
+ watcher.close();
173
+ this.#watchers = [];
174
+ await this.#tail;
175
+ }
176
+ }
177
+ //# sourceMappingURL=catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/application/catalog.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import type { Profile } from "../contracts/types.js";
2
+ export interface AgentStorageConfiguration {
3
+ readonly max_managed_bytes?: number;
4
+ }
5
+ export interface AgentRetentionConfiguration {
6
+ readonly work_idle_ms?: number;
7
+ readonly run_history_ms?: number;
8
+ readonly run_logs_ms?: number;
9
+ readonly input_attachments_ms?: number;
10
+ readonly artifact_ms?: number;
11
+ readonly material_copies_ms?: number;
12
+ }
13
+ export interface ProfileConfiguration {
14
+ readonly profile: Profile;
15
+ readonly root: string;
16
+ readonly serverUrl: string;
17
+ readonly token: string;
18
+ readonly storage?: Readonly<AgentStorageConfiguration>;
19
+ readonly retention?: Readonly<AgentRetentionConfiguration>;
20
+ }
21
+ export declare function validateServerUrl(value: unknown, profile: Profile): URL;
22
+ export declare function validateAgentToken(value: unknown): string;
23
+ export declare function profileRoot(profile: Profile, home?: string): string;
24
+ export declare function loadProfileConfig(profile: Profile, home?: string): ProfileConfiguration;
@@ -0,0 +1,140 @@
1
+ import { homedir } from "node:os";
2
+ import { constants, openSync, closeSync, fstatSync, readSync, realpathSync, lstatSync, } from "node:fs";
3
+ import path from "node:path";
4
+ import { AgentError, requireCondition } from "../contracts/errors.js";
5
+ import { isPlainRecord } from "../contracts/json.js";
6
+ function invalid() {
7
+ // Never attach the source text, filename, credential or parser/system cause.
8
+ return new AgentError("invalid_configuration", "The selected Agent profile configuration is unavailable or invalid.");
9
+ }
10
+ function numericPolicy(value, fields, duration = false) {
11
+ if (value === undefined)
12
+ return undefined;
13
+ if (!isPlainRecord(value))
14
+ throw invalid();
15
+ for (const [key, number] of Object.entries(value))
16
+ if (!fields.includes(key) ||
17
+ typeof number !== "number" ||
18
+ !Number.isSafeInteger(number) ||
19
+ number <= 0 ||
20
+ (duration && number > 253_402_300_799_999 - Date.now()))
21
+ throw invalid();
22
+ return Object.freeze({ ...value });
23
+ }
24
+ export function validateServerUrl(value, profile) {
25
+ try {
26
+ requireCondition((profile === "production" || profile === "development") &&
27
+ typeof value === "string" &&
28
+ value.length > 0 &&
29
+ Buffer.byteLength(value) <= 8192 &&
30
+ value.trim() === value &&
31
+ !/[\x00-\x20\x7f]/.test(value), "invalid_configuration", "The Server URL is invalid.");
32
+ const url = new URL(value);
33
+ requireCondition(["http:", "https:"].includes(url.protocol) &&
34
+ (profile === "development" || url.protocol === "https:") &&
35
+ !url.username &&
36
+ !url.password &&
37
+ !url.search &&
38
+ !url.hash, "invalid_configuration", "The Server URL is invalid.");
39
+ return url;
40
+ }
41
+ catch {
42
+ throw invalid();
43
+ }
44
+ }
45
+ export function validateAgentToken(value) {
46
+ if (typeof value !== "string" || !/^[\x21-\x7e]{1,8192}$/.test(value))
47
+ throw invalid();
48
+ return value;
49
+ }
50
+ export function profileRoot(profile, home = homedir()) {
51
+ if (!((profile === "production" || profile === "development") &&
52
+ typeof home === "string" &&
53
+ path.isAbsolute(home)))
54
+ throw invalid();
55
+ return path.join(home, profile === "development" ? ".nexum-dev" : ".nexum");
56
+ }
57
+ export function loadProfileConfig(profile, home = homedir()) {
58
+ let file;
59
+ try {
60
+ const root = profileRoot(profile, realpathSync.native(home));
61
+ const directory = lstatSync(root);
62
+ if (!directory.isDirectory() ||
63
+ directory.isSymbolicLink() ||
64
+ realpathSync.native(root) !== root)
65
+ throw invalid();
66
+ const filename = path.join(root, "config.json"), before = lstatSync(filename);
67
+ if (!before.isFile() || before.isSymbolicLink())
68
+ throw invalid();
69
+ file = openSync(filename, constants.O_RDONLY |
70
+ (constants.O_NOFOLLOW ?? 0) |
71
+ (constants.O_NONBLOCK ?? 0));
72
+ const stat = fstatSync(file);
73
+ if (!stat.isFile() ||
74
+ stat.dev !== before.dev ||
75
+ stat.ino !== before.ino ||
76
+ stat.size > 16384 ||
77
+ realpathSync.native(root) !== root)
78
+ throw invalid();
79
+ if (process.platform !== "win32" &&
80
+ ((stat.mode & 0o077) !== 0 ||
81
+ (process.getuid && stat.uid !== process.getuid())))
82
+ throw invalid();
83
+ const bytes = Buffer.alloc(16385);
84
+ let size = 0;
85
+ while (size < bytes.length) {
86
+ const count = readSync(file, bytes, size, bytes.length - size, null);
87
+ if (!count)
88
+ break;
89
+ size += count;
90
+ }
91
+ if (size > 16384)
92
+ throw invalid();
93
+ const value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(0, size)));
94
+ if (!value ||
95
+ typeof value !== "object" ||
96
+ Array.isArray(value) ||
97
+ !Object.keys(value).every((key) => ["server_url", "token", "storage", "retention"].includes(key)) ||
98
+ !Object.hasOwn(value, "server_url") ||
99
+ !Object.hasOwn(value, "token"))
100
+ throw invalid();
101
+ const fields = value;
102
+ const serverUrl = validateServerUrl(fields.server_url, profile).href;
103
+ const token = validateAgentToken(fields.token);
104
+ const storage = numericPolicy(fields.storage, ["max_managed_bytes"]);
105
+ const retention = numericPolicy(fields.retention, [
106
+ "work_idle_ms",
107
+ "run_history_ms",
108
+ "run_logs_ms",
109
+ "input_attachments_ms",
110
+ "artifact_ms",
111
+ "material_copies_ms",
112
+ ], true);
113
+ const configuration = {
114
+ profile,
115
+ root,
116
+ serverUrl,
117
+ ...(storage ? { storage } : {}),
118
+ ...(retention ? { retention } : {}),
119
+ };
120
+ Object.defineProperty(configuration, "token", {
121
+ value: token,
122
+ enumerable: false,
123
+ });
124
+ return Object.freeze(configuration);
125
+ }
126
+ catch {
127
+ throw invalid();
128
+ }
129
+ finally {
130
+ if (file !== undefined) {
131
+ try {
132
+ closeSync(file);
133
+ }
134
+ catch {
135
+ throw invalid();
136
+ }
137
+ }
138
+ }
139
+ }
140
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/application/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ import { AgentError } from "../contracts/errors.js";
2
+ import type { WireConnectionV2, WireEnvelopeV2, WireEventV2, WireInvokeV2, WireInvocationContextV2, WireOperationV2, WireInputsV2, WireOutputsV2 } from "../contracts/wire.js";
3
+ import type { Profile } from "../contracts/types.js";
4
+ export interface ControlConnectionOptions {
5
+ readonly serverUrl: string;
6
+ readonly token: string;
7
+ readonly profile: Profile;
8
+ readonly bootId: string;
9
+ readonly version: string;
10
+ readonly signal: AbortSignal;
11
+ /** Application initialization completes before an incoming invocation is admitted. */
12
+ ready(connection: ControlConnection): Promise<void>;
13
+ invoke(message: WireInvokeV2, signal: AbortSignal): Promise<unknown>;
14
+ event(message: WireEventV2, signal: AbortSignal): Promise<void>;
15
+ }
16
+ export declare class ConnectionRejection extends AgentError {
17
+ readonly status: number;
18
+ readonly rejectionCode: string | null;
19
+ constructor(status: number, rejectionCode: string | null);
20
+ get stopNoRestart(): boolean;
21
+ }
22
+ /** One actual socket and its observation RPCs; accepted Run lifetime belongs to RunEngine. */
23
+ export declare class ControlConnection {
24
+ #private;
25
+ readonly binding: Readonly<WireConnectionV2>;
26
+ readonly closed: Promise<void>;
27
+ readonly signal: AbortSignal;
28
+ private constructor();
29
+ static connect(options: ControlConnectionOptions): Promise<ControlConnection>;
30
+ send(message: WireEnvelopeV2): Promise<void>;
31
+ request<O extends WireOperationV2>(operation: O, context: WireInvocationContextV2, input: WireInputsV2[O], signal: AbortSignal, timeoutMs?: number): Promise<WireOutputsV2[O]>;
32
+ close(): void;
33
+ }
34
+ /** Reconnection only; the callback never replays previously accepted application requests. */
35
+ export declare function reconnectControl(options: ControlConnectionOptions, diagnose: (code: string, retry: boolean) => void): Promise<"stopped" | "permanent">;