@nexum-hub/agent 0.0.0-stage → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (343) hide show
  1. package/README.md +133 -2
  2. package/contracts/v2/common.schema.json +262 -0
  3. package/contracts/v2/fixtures/inputs.json +244 -0
  4. package/contracts/v2/fixtures/wire.json +6493 -0
  5. package/contracts/v2/model/agent.close.input.schema.json +14 -0
  6. package/contracts/v2/model/agent.close.output.schema.json +101 -0
  7. package/contracts/v2/model/agent.list.input.schema.json +57 -0
  8. package/contracts/v2/model/agent.list.output.schema.json +220 -0
  9. package/contracts/v2/model/agent.open.input.schema.json +35 -0
  10. package/contracts/v2/model/agent.open.output.schema.json +41 -0
  11. package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
  12. package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
  13. package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
  14. package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
  15. package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
  16. package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
  17. package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
  18. package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
  19. package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
  20. package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
  21. package/contracts/v2/wire/bodies.schema.json +383 -0
  22. package/contracts/v2/wire/envelope.schema.json +2280 -0
  23. package/contracts/v2/wire/events.schema.json +242 -0
  24. package/contracts/v2/wire/maintenance.schema.json +308 -0
  25. package/contracts/v2/wire/operations.schema.json +1791 -0
  26. package/contracts/v2/wire/stream.schema.json +74 -0
  27. package/contracts/v2/wire/types.schema.json +2616 -0
  28. package/dist/adapters/mcp-http.d.ts +22 -0
  29. package/dist/adapters/mcp-http.js +472 -0
  30. package/dist/adapters/mcp-http.js.map +1 -0
  31. package/dist/adapters/mcp-oauth.d.ts +29 -0
  32. package/dist/adapters/mcp-oauth.js +653 -0
  33. package/dist/adapters/mcp-oauth.js.map +1 -0
  34. package/dist/adapters/mcp-wire.d.ts +21 -0
  35. package/dist/adapters/mcp-wire.js +307 -0
  36. package/dist/adapters/mcp-wire.js.map +1 -0
  37. package/dist/adapters/mcp.d.ts +56 -0
  38. package/dist/adapters/mcp.js +1989 -0
  39. package/dist/adapters/mcp.js.map +1 -0
  40. package/dist/adapters/openapi-http.d.ts +29 -0
  41. package/dist/adapters/openapi-http.js +504 -0
  42. package/dist/adapters/openapi-http.js.map +1 -0
  43. package/dist/adapters/openapi-request.d.ts +26 -0
  44. package/dist/adapters/openapi-request.js +597 -0
  45. package/dist/adapters/openapi-request.js.map +1 -0
  46. package/dist/adapters/openapi-schema.d.ts +22 -0
  47. package/dist/adapters/openapi-schema.js +471 -0
  48. package/dist/adapters/openapi-schema.js.map +1 -0
  49. package/dist/adapters/openapi-typegen.d.ts +11 -0
  50. package/dist/adapters/openapi-typegen.js +185 -0
  51. package/dist/adapters/openapi-typegen.js.map +1 -0
  52. package/dist/adapters/openapi-types.d.ts +99 -0
  53. package/dist/adapters/openapi-types.js +2 -0
  54. package/dist/adapters/openapi-types.js.map +1 -0
  55. package/dist/adapters/openapi.d.ts +7 -0
  56. package/dist/adapters/openapi.js +768 -0
  57. package/dist/adapters/openapi.js.map +1 -0
  58. package/dist/application/activation.d.ts +28 -0
  59. package/dist/application/activation.js +289 -0
  60. package/dist/application/activation.js.map +1 -0
  61. package/dist/application/attachments.d.ts +24 -0
  62. package/dist/application/attachments.js +87 -0
  63. package/dist/application/attachments.js.map +1 -0
  64. package/dist/application/authority.d.ts +32 -0
  65. package/dist/application/authority.js +213 -0
  66. package/dist/application/authority.js.map +1 -0
  67. package/dist/application/catalog.d.ts +11 -0
  68. package/dist/application/catalog.js +177 -0
  69. package/dist/application/catalog.js.map +1 -0
  70. package/dist/application/config.d.ts +24 -0
  71. package/dist/application/config.js +140 -0
  72. package/dist/application/config.js.map +1 -0
  73. package/dist/application/connection.d.ts +35 -0
  74. package/dist/application/connection.js +465 -0
  75. package/dist/application/connection.js.map +1 -0
  76. package/dist/application/data-plane.d.ts +35 -0
  77. package/dist/application/data-plane.js +437 -0
  78. package/dist/application/data-plane.js.map +1 -0
  79. package/dist/application/diagnostics.d.ts +4 -0
  80. package/dist/application/diagnostics.js +65 -0
  81. package/dist/application/diagnostics.js.map +1 -0
  82. package/dist/application/dispatcher.d.ts +4 -0
  83. package/dist/application/dispatcher.js +16 -0
  84. package/dist/application/dispatcher.js.map +1 -0
  85. package/dist/application/main.d.ts +12 -0
  86. package/dist/application/main.js +167 -0
  87. package/dist/application/main.js.map +1 -0
  88. package/dist/application/maintenance.d.ts +27 -0
  89. package/dist/application/maintenance.js +244 -0
  90. package/dist/application/maintenance.js.map +1 -0
  91. package/dist/application/packages.d.ts +25 -0
  92. package/dist/application/packages.js +208 -0
  93. package/dist/application/packages.js.map +1 -0
  94. package/dist/application/processes.d.ts +49 -0
  95. package/dist/application/processes.js +180 -0
  96. package/dist/application/processes.js.map +1 -0
  97. package/dist/application/run-view.d.ts +17 -0
  98. package/dist/application/run-view.js +286 -0
  99. package/dist/application/run-view.js.map +1 -0
  100. package/dist/application/runtime.d.ts +78 -0
  101. package/dist/application/runtime.js +1747 -0
  102. package/dist/application/runtime.js.map +1 -0
  103. package/dist/application/tasks.d.ts +38 -0
  104. package/dist/application/tasks.js +23 -0
  105. package/dist/application/tasks.js.map +1 -0
  106. package/dist/application/user-state.d.ts +20 -0
  107. package/dist/application/user-state.js +52 -0
  108. package/dist/application/user-state.js.map +1 -0
  109. package/dist/application/work-git.d.ts +14 -0
  110. package/dist/application/work-git.js +67 -0
  111. package/dist/application/work-git.js.map +1 -0
  112. package/dist/cli.d.ts +2 -0
  113. package/dist/cli.js +40 -0
  114. package/dist/cli.js.map +1 -0
  115. package/dist/contracts/caller.d.ts +51 -0
  116. package/dist/contracts/caller.js +95 -0
  117. package/dist/contracts/caller.js.map +1 -0
  118. package/dist/contracts/error-data.d.ts +6 -0
  119. package/dist/contracts/error-data.js +51 -0
  120. package/dist/contracts/error-data.js.map +1 -0
  121. package/dist/contracts/errors.d.ts +10 -0
  122. package/dist/contracts/errors.js +28 -0
  123. package/dist/contracts/errors.js.map +1 -0
  124. package/dist/contracts/json.d.ts +9 -0
  125. package/dist/contracts/json.js +104 -0
  126. package/dist/contracts/json.js.map +1 -0
  127. package/dist/contracts/types.d.ts +122 -0
  128. package/dist/contracts/types.js +19 -0
  129. package/dist/contracts/types.js.map +1 -0
  130. package/dist/contracts/validation.d.ts +4 -0
  131. package/dist/contracts/validation.js +157 -0
  132. package/dist/contracts/validation.js.map +1 -0
  133. package/dist/contracts/wire-validation.d.ts +9 -0
  134. package/dist/contracts/wire-validation.js +399 -0
  135. package/dist/contracts/wire-validation.js.map +1 -0
  136. package/dist/contracts/wire.d.ts +1083 -0
  137. package/dist/contracts/wire.js +62 -0
  138. package/dist/contracts/wire.js.map +1 -0
  139. package/dist/extension-api.d.ts +12 -0
  140. package/dist/extension-api.js +2 -0
  141. package/dist/extension-api.js.map +1 -0
  142. package/dist/extensions/api.d.ts +72 -0
  143. package/dist/extensions/api.js +2 -0
  144. package/dist/extensions/api.js.map +1 -0
  145. package/dist/extensions/host-requests.d.ts +23 -0
  146. package/dist/extensions/host-requests.js +60 -0
  147. package/dist/extensions/host-requests.js.map +1 -0
  148. package/dist/extensions/materials.d.ts +37 -0
  149. package/dist/extensions/materials.js +691 -0
  150. package/dist/extensions/materials.js.map +1 -0
  151. package/dist/extensions/package-loader.d.ts +28 -0
  152. package/dist/extensions/package-loader.js +177 -0
  153. package/dist/extensions/package-loader.js.map +1 -0
  154. package/dist/extensions/packages.d.ts +73 -0
  155. package/dist/extensions/packages.js +441 -0
  156. package/dist/extensions/packages.js.map +1 -0
  157. package/dist/extensions/registry.d.ts +92 -0
  158. package/dist/extensions/registry.js +1540 -0
  159. package/dist/extensions/registry.js.map +1 -0
  160. package/dist/extensions/resources.d.ts +105 -0
  161. package/dist/extensions/resources.js +595 -0
  162. package/dist/extensions/resources.js.map +1 -0
  163. package/dist/extensions/state.d.ts +25 -0
  164. package/dist/extensions/state.js +10 -0
  165. package/dist/extensions/state.js.map +1 -0
  166. package/dist/extensions/transfer.d.ts +81 -0
  167. package/dist/extensions/transfer.js +16 -0
  168. package/dist/extensions/transfer.js.map +1 -0
  169. package/dist/index.d.ts +7 -0
  170. package/dist/index.js +25 -0
  171. package/dist/index.js.map +1 -0
  172. package/dist/maintenance/configuration.d.ts +79 -0
  173. package/dist/maintenance/configuration.js +1503 -0
  174. package/dist/maintenance/configuration.js.map +1 -0
  175. package/dist/maintenance/credentials.d.ts +23 -0
  176. package/dist/maintenance/credentials.js +177 -0
  177. package/dist/maintenance/credentials.js.map +1 -0
  178. package/dist/maintenance/files.d.ts +2 -0
  179. package/dist/maintenance/files.js +40 -0
  180. package/dist/maintenance/files.js.map +1 -0
  181. package/dist/maintenance/npm.d.ts +71 -0
  182. package/dist/maintenance/npm.js +1013 -0
  183. package/dist/maintenance/npm.js.map +1 -0
  184. package/dist/maintenance/oauth.d.ts +45 -0
  185. package/dist/maintenance/oauth.js +686 -0
  186. package/dist/maintenance/oauth.js.map +1 -0
  187. package/dist/maintenance/requests.d.ts +347 -0
  188. package/dist/maintenance/requests.js +959 -0
  189. package/dist/maintenance/requests.js.map +1 -0
  190. package/dist/maintenance/work-git.d.ts +29 -0
  191. package/dist/maintenance/work-git.js +776 -0
  192. package/dist/maintenance/work-git.js.map +1 -0
  193. package/dist/process/backend.d.ts +54 -0
  194. package/dist/process/backend.js +39 -0
  195. package/dist/process/backend.js.map +1 -0
  196. package/dist/process/environment-windows.d.ts +15 -0
  197. package/dist/process/environment-windows.js +151 -0
  198. package/dist/process/environment-windows.js.map +1 -0
  199. package/dist/process/environment.d.ts +28 -0
  200. package/dist/process/environment.js +410 -0
  201. package/dist/process/environment.js.map +1 -0
  202. package/dist/process/launch.d.ts +31 -0
  203. package/dist/process/launch.js +281 -0
  204. package/dist/process/launch.js.map +1 -0
  205. package/dist/process/managed.d.ts +36 -0
  206. package/dist/process/managed.js +459 -0
  207. package/dist/process/managed.js.map +1 -0
  208. package/dist/process/output-log.d.ts +50 -0
  209. package/dist/process/output-log.js +552 -0
  210. package/dist/process/output-log.js.map +1 -0
  211. package/dist/process/pipes.d.ts +16 -0
  212. package/dist/process/pipes.js +588 -0
  213. package/dist/process/pipes.js.map +1 -0
  214. package/dist/process/pty.d.ts +22 -0
  215. package/dist/process/pty.js +512 -0
  216. package/dist/process/pty.js.map +1 -0
  217. package/dist/process/windows-conout-worker.d.ts +1 -0
  218. package/dist/process/windows-conout-worker.js +90 -0
  219. package/dist/process/windows-conout-worker.js.map +1 -0
  220. package/dist/process/windows-conout.d.ts +46 -0
  221. package/dist/process/windows-conout.js +140 -0
  222. package/dist/process/windows-conout.js.map +1 -0
  223. package/dist/process/windows-helper.d.ts +43 -0
  224. package/dist/process/windows-helper.js +255 -0
  225. package/dist/process/windows-helper.js.map +1 -0
  226. package/dist/process/windows-job.d.ts +39 -0
  227. package/dist/process/windows-job.js +224 -0
  228. package/dist/process/windows-job.js.map +1 -0
  229. package/dist/process/windows-pipes.d.ts +16 -0
  230. package/dist/process/windows-pipes.js +475 -0
  231. package/dist/process/windows-pipes.js.map +1 -0
  232. package/dist/results/artifacts.d.ts +118 -0
  233. package/dist/results/artifacts.js +873 -0
  234. package/dist/results/artifacts.js.map +1 -0
  235. package/dist/results/encoder.d.ts +57 -0
  236. package/dist/results/encoder.js +1179 -0
  237. package/dist/results/encoder.js.map +1 -0
  238. package/dist/results/mcp.d.ts +95 -0
  239. package/dist/results/mcp.js +656 -0
  240. package/dist/results/mcp.js.map +1 -0
  241. package/dist/results/media.d.ts +19 -0
  242. package/dist/results/media.js +301 -0
  243. package/dist/results/media.js.map +1 -0
  244. package/dist/results/normalize.d.ts +29 -0
  245. package/dist/results/normalize.js +464 -0
  246. package/dist/results/normalize.js.map +1 -0
  247. package/dist/runtime/control-scripts.d.ts +23 -0
  248. package/dist/runtime/control-scripts.js +242 -0
  249. package/dist/runtime/control-scripts.js.map +1 -0
  250. package/dist/runtime/engine.d.ts +177 -0
  251. package/dist/runtime/engine.js +1159 -0
  252. package/dist/runtime/engine.js.map +1 -0
  253. package/dist/runtime/globals.d.ts +1 -0
  254. package/dist/runtime/globals.js +31 -0
  255. package/dist/runtime/globals.js.map +1 -0
  256. package/dist/runtime/material-retention.d.ts +34 -0
  257. package/dist/runtime/material-retention.js +671 -0
  258. package/dist/runtime/material-retention.js.map +1 -0
  259. package/dist/runtime/modules.d.ts +50 -0
  260. package/dist/runtime/modules.js +320 -0
  261. package/dist/runtime/modules.js.map +1 -0
  262. package/dist/runtime/names.d.ts +2 -0
  263. package/dist/runtime/names.js +22 -0
  264. package/dist/runtime/names.js.map +1 -0
  265. package/dist/runtime/operations.d.ts +20 -0
  266. package/dist/runtime/operations.js +137 -0
  267. package/dist/runtime/operations.js.map +1 -0
  268. package/dist/runtime/paths.d.ts +3 -0
  269. package/dist/runtime/paths.js +38 -0
  270. package/dist/runtime/paths.js.map +1 -0
  271. package/dist/runtime/promises.d.ts +9 -0
  272. package/dist/runtime/promises.js +78 -0
  273. package/dist/runtime/promises.js.map +1 -0
  274. package/dist/runtime/retention.d.ts +88 -0
  275. package/dist/runtime/retention.js +735 -0
  276. package/dist/runtime/retention.js.map +1 -0
  277. package/dist/runtime/run-log.d.ts +30 -0
  278. package/dist/runtime/run-log.js +207 -0
  279. package/dist/runtime/run-log.js.map +1 -0
  280. package/dist/runtime/scripts.d.ts +84 -0
  281. package/dist/runtime/scripts.js +387 -0
  282. package/dist/runtime/scripts.js.map +1 -0
  283. package/dist/runtime/tasks.d.ts +54 -0
  284. package/dist/runtime/tasks.js +290 -0
  285. package/dist/runtime/tasks.js.map +1 -0
  286. package/dist/sdk/maintenance.d.ts +3 -0
  287. package/dist/sdk/maintenance.js +80 -0
  288. package/dist/sdk/maintenance.js.map +1 -0
  289. package/dist/sdk/output-extension.d.ts +3 -0
  290. package/dist/sdk/output-extension.js +44 -0
  291. package/dist/sdk/output-extension.js.map +1 -0
  292. package/dist/sdk/output.d.ts +52 -0
  293. package/dist/sdk/output.js +350 -0
  294. package/dist/sdk/output.js.map +1 -0
  295. package/dist/sdk/runtime.d.ts +3 -0
  296. package/dist/sdk/runtime.js +26 -0
  297. package/dist/sdk/runtime.js.map +1 -0
  298. package/dist/sdk/sh.d.ts +3 -0
  299. package/dist/sdk/sh.js +384 -0
  300. package/dist/sdk/sh.js.map +1 -0
  301. package/dist/sdk/state.d.ts +2 -0
  302. package/dist/sdk/state.js +69 -0
  303. package/dist/sdk/state.js.map +1 -0
  304. package/dist/sdk/transfer.d.ts +3 -0
  305. package/dist/sdk/transfer.js +141 -0
  306. package/dist/sdk/transfer.js.map +1 -0
  307. package/dist/services/extensions.d.ts +19 -0
  308. package/dist/services/extensions.js +183 -0
  309. package/dist/services/extensions.js.map +1 -0
  310. package/dist/services/state.d.ts +37 -0
  311. package/dist/services/state.js +125 -0
  312. package/dist/services/state.js.map +1 -0
  313. package/dist/services/transfer.d.ts +86 -0
  314. package/dist/services/transfer.js +948 -0
  315. package/dist/services/transfer.js.map +1 -0
  316. package/dist/storage/schema.d.ts +8 -0
  317. package/dist/storage/schema.js +241 -0
  318. package/dist/storage/schema.js.map +1 -0
  319. package/dist/storage/sqlite.d.ts +241 -0
  320. package/dist/storage/sqlite.js +1855 -0
  321. package/dist/storage/sqlite.js.map +1 -0
  322. package/dist/storage/transfers.d.ts +90 -0
  323. package/dist/storage/transfers.js +2 -0
  324. package/dist/storage/transfers.js.map +1 -0
  325. package/dist/transfer/io.d.ts +74 -0
  326. package/dist/transfer/io.js +425 -0
  327. package/dist/transfer/io.js.map +1 -0
  328. package/dist/transfer/offers.d.ts +72 -0
  329. package/dist/transfer/offers.js +380 -0
  330. package/dist/transfer/offers.js.map +1 -0
  331. package/dist/transfer/stream-slots.d.ts +12 -0
  332. package/dist/transfer/stream-slots.js +28 -0
  333. package/dist/transfer/stream-slots.js.map +1 -0
  334. package/dist/work/catalog.d.ts +43 -0
  335. package/dist/work/catalog.js +198 -0
  336. package/dist/work/catalog.js.map +1 -0
  337. package/dist/work/discovery.d.ts +70 -0
  338. package/dist/work/discovery.js +465 -0
  339. package/dist/work/discovery.js.map +1 -0
  340. package/dist/work/service.d.ts +83 -0
  341. package/dist/work/service.js +703 -0
  342. package/dist/work/service.js.map +1 -0
  343. package/package.json +66 -4
@@ -0,0 +1,425 @@
1
+ import { createHash } from "node:crypto";
2
+ import { constants } from "node:fs";
3
+ import { link, lstat, open, realpath, unlink, } from "node:fs/promises";
4
+ import path from "node:path";
5
+ import { addAbortSignal } from "node:stream";
6
+ import { finished } from "node:stream/promises";
7
+ import { MIMEType, types } from "node:util";
8
+ import { AgentError, requireCondition } from "../contracts/errors.js";
9
+ import { authorizeCall } from "../contracts/caller.js";
10
+ import { digest, newId } from "../contracts/json.js";
11
+ /** Core-only failure facts; an SDK facade maps this to safe public diagnostics. */
12
+ export class TransferIoError extends AgentError {
13
+ fileCommitted;
14
+ cleanupConfirmed;
15
+ file;
16
+ constructor(code, message, fileCommitted, cleanupConfirmed, file, cause) {
17
+ super(code, message, { fileCommitted, cleanupConfirmed }, { cause });
18
+ this.fileCommitted = fileCommitted;
19
+ this.cleanupConfirmed = cleanupConfirmed;
20
+ this.file = file;
21
+ }
22
+ }
23
+ const maxPolicy = 20 * 1024 ** 3;
24
+ const typed = Object.getPrototypeOf(Uint8Array.prototype);
25
+ const byteBuffer = Object.getOwnPropertyDescriptor(typed, "buffer").get;
26
+ const byteOffset = Object.getOwnPropertyDescriptor(typed, "byteOffset").get;
27
+ const byteLength = Object.getOwnPropertyDescriptor(typed, "byteLength").get;
28
+ function integer(value, maximum) {
29
+ return (Number.isSafeInteger(value) &&
30
+ value >= 0 &&
31
+ value <= maximum);
32
+ }
33
+ function policy(value) {
34
+ requireCondition(integer(value, maxPolicy) && value > 0, "invalid_transfer_budget", "The trusted transfer limit must be positive bounded Agent configuration.");
35
+ }
36
+ function check(scope, target) {
37
+ scope.signal.throwIfAborted();
38
+ authorizeCall(() => scope.assertCurrent());
39
+ authorizeCall(() => scope.authorize(Object.freeze(target)));
40
+ }
41
+ function progress(scope, bytes) {
42
+ const result = scope.onProgress?.(bytes);
43
+ if (types.isPromise(result)) {
44
+ void Promise.prototype.then.call(result, undefined, () => { });
45
+ throw new AgentError("transfer_progress_configuration", "Transfer progress reporting must finish synchronously.");
46
+ }
47
+ }
48
+ function mime(value) {
49
+ requireCondition(typeof value === "string" &&
50
+ value.length > 0 &&
51
+ value.length <= 256 &&
52
+ !/[\0\r\n]/.test(value), "invalid_arguments", "The transfer MIME type must be bounded media-type text.");
53
+ try {
54
+ return new MIMEType(value).toString();
55
+ }
56
+ catch (cause) {
57
+ throw new AgentError("invalid_arguments", "The transfer MIME type is invalid.", undefined, { cause });
58
+ }
59
+ }
60
+ function sameParent(info, parent) {
61
+ return (info.isDirectory() &&
62
+ String(info.dev) === parent.dev &&
63
+ String(info.ino) === parent.ino);
64
+ }
65
+ function sameFile(left, right, beforeCommit = true) {
66
+ return (right.isFile() &&
67
+ left.dev === right.dev &&
68
+ left.ino === right.ino &&
69
+ left.size === right.size &&
70
+ left.mtimeNs === right.mtimeNs &&
71
+ (!beforeCommit || left.ctimeNs === right.ctimeNs));
72
+ }
73
+ async function parentCurrent(plan) {
74
+ try {
75
+ requireCondition((await realpath(path.dirname(plan.requestedPath))) === plan.parent.path &&
76
+ (await realpath(plan.parent.path)) === plan.parent.path &&
77
+ sameParent(await lstat(plan.parent.path, { bigint: true }), plan.parent), "file_changed", "The authorized upload parent directory was moved, replaced or redirected.");
78
+ }
79
+ catch (cause) {
80
+ if (cause instanceof AgentError)
81
+ throw cause;
82
+ throw new AgentError("file_changed", "The authorized upload parent directory is no longer available.", undefined, { cause });
83
+ }
84
+ }
85
+ async function absent(filename) {
86
+ try {
87
+ await lstat(filename);
88
+ }
89
+ catch (cause) {
90
+ if (cause &&
91
+ typeof cause === "object" &&
92
+ Object.getOwnPropertyDescriptor(cause, "code")?.value === "ENOENT")
93
+ return;
94
+ throw cause;
95
+ }
96
+ throw new AgentError("path_already_exists", "The upload target already exists and cannot be replaced.");
97
+ }
98
+ function copyChunk(value, remaining) {
99
+ requireCondition(value &&
100
+ typeof value === "object" &&
101
+ !types.isProxy(value) &&
102
+ types.isUint8Array(value), "invalid_transfer_chunk", "The transport must provide raw binary chunks.");
103
+ const length = byteLength.call(value);
104
+ requireCondition(length <= remaining, "resource_exhausted", "The actual transfer bytes exceed the accepted limit.");
105
+ // A producer can reuse its chunk after an await; only private copied bytes
106
+ // reach the file/socket and its matching hash calculation.
107
+ return Buffer.from(new Uint8Array(byteBuffer.call(value), byteOffset.call(value), length));
108
+ }
109
+ function errorFor(cause, signal) {
110
+ if (signal.aborted)
111
+ return signal.reason instanceof AgentError
112
+ ? { code: signal.reason.code, message: signal.reason.message }
113
+ : {
114
+ code: "transfer_cancelled",
115
+ message: "The transfer stopped before its remaining I/O could complete.",
116
+ };
117
+ if (cause instanceof AgentError)
118
+ return { code: cause.code, message: cause.message };
119
+ const code = cause && typeof cause === "object" && !types.isProxy(cause)
120
+ ? Object.getOwnPropertyDescriptor(cause, "code")?.value
121
+ : undefined;
122
+ if (code === "EEXIST")
123
+ return {
124
+ code: "path_already_exists",
125
+ message: "The upload target already exists and cannot be replaced.",
126
+ };
127
+ if (code === "ENOENT")
128
+ return {
129
+ code: "path_not_found",
130
+ message: "A required transfer path is no longer available.",
131
+ };
132
+ if ([
133
+ "forbidden",
134
+ "permission_denied",
135
+ "access_denied",
136
+ "path_not_allowed",
137
+ "resource_forbidden",
138
+ "unauthorized",
139
+ ].includes(code))
140
+ return {
141
+ code,
142
+ message: "Current authority does not permit this transfer I/O.",
143
+ };
144
+ return {
145
+ code: "transfer_failed",
146
+ message: "The actual transfer I/O did not finish successfully.",
147
+ };
148
+ }
149
+ function closing(stream) {
150
+ if (stream.closed)
151
+ return { closed: Promise.resolve(), dispose() { } };
152
+ const result = Promise.withResolvers();
153
+ const error = () => { };
154
+ const dispose = () => {
155
+ stream.off("close", closed);
156
+ stream.off("error", error);
157
+ };
158
+ const closed = () => {
159
+ dispose();
160
+ result.resolve();
161
+ };
162
+ stream.on("error", error);
163
+ stream.once("close", closed);
164
+ return { closed: result.promise, dispose };
165
+ }
166
+ /** Prepares target identity only; it does not create or reserve the user's file. */
167
+ export async function prepareUpload(target, scope, options) {
168
+ policy(options.maxBytes);
169
+ requireCondition(typeof scope.pwd === "string" &&
170
+ path.isAbsolute(scope.pwd) &&
171
+ target &&
172
+ typeof target.path === "string" &&
173
+ target.path.length > 0 &&
174
+ Buffer.byteLength(target.path) <= 262144 &&
175
+ !target.path.includes("\0"), "invalid_arguments", "An upload needs an absolute working directory and bounded target path.");
176
+ requireCondition(target.expectedSize === undefined ||
177
+ integer(target.expectedSize, maxPolicy), "invalid_arguments", "Expected size must be a non-negative safe byte count.");
178
+ requireCondition(target.expectedSize === undefined ||
179
+ target.expectedSize <= options.maxBytes, "resource_exhausted", "The declared upload size exceeds its Agent limit.");
180
+ requireCondition(target.expectedSha256 === undefined ||
181
+ (typeof target.expectedSha256 === "string" &&
182
+ /^[0-9a-f]{64}$/.test(target.expectedSha256)), "invalid_arguments", "Expected SHA-256 must contain 64 lowercase hexadecimal characters.");
183
+ const requestedPath = path.resolve(scope.pwd, target.path);
184
+ check(scope, { access: "write", path: requestedPath });
185
+ const parentPath = await realpath(path.dirname(requestedPath));
186
+ const parent = await lstat(parentPath, { bigint: true });
187
+ requireCondition(parent.isDirectory(), "invalid_arguments", "The upload parent must be an existing regular directory.");
188
+ const canonical = path.join(parentPath, path.basename(requestedPath));
189
+ check(scope, { access: "write", path: canonical });
190
+ await absent(canonical);
191
+ const result = Object.freeze({
192
+ path: canonical,
193
+ requestedPath,
194
+ parent: Object.freeze({
195
+ path: parentPath,
196
+ dev: String(parent.dev),
197
+ ino: String(parent.ino),
198
+ }),
199
+ maxBytes: options.maxBytes,
200
+ ...(target.expectedSize === undefined
201
+ ? {}
202
+ : { expectedSize: target.expectedSize }),
203
+ ...(target.expectedSha256 === undefined
204
+ ? {}
205
+ : { expectedSha256: target.expectedSha256 }),
206
+ mimeType: mime(target.mimeType ?? "application/octet-stream"),
207
+ });
208
+ await parentCurrent(result);
209
+ check(scope, { access: "write", path: result.path });
210
+ return result;
211
+ }
212
+ /** Same-directory hard-link publication is atomic no-replace on supported filesystems. */
213
+ export async function receiveUpload(source, plan, scope, options = {}) {
214
+ const inputClosure = closing(source);
215
+ let temporary, output, identity;
216
+ let createdTemporary = false;
217
+ let committed = false, receipt;
218
+ let failure;
219
+ let cleanupConfirmed = true;
220
+ try {
221
+ policy(plan.maxBytes);
222
+ if (options.maxBytes !== undefined)
223
+ policy(options.maxBytes);
224
+ const maximum = Math.min(plan.maxBytes, options.maxBytes ?? plan.maxBytes);
225
+ requireCondition(options.contentLength === undefined ||
226
+ integer(options.contentLength, maxPolicy), "invalid_arguments", "Content-Length must be a non-negative safe byte count when supplied.");
227
+ requireCondition(options.contentLength === undefined || options.contentLength <= maximum, "resource_exhausted", "Content-Length exceeds the accepted transfer limit.");
228
+ requireCondition(plan.expectedSize === undefined || plan.expectedSize <= maximum, "resource_exhausted", "The accepted expected size exceeds the current Agent limit.");
229
+ requireCondition(plan.expectedSize === undefined ||
230
+ options.contentLength === undefined ||
231
+ plan.expectedSize === options.contentLength, "transfer_size_mismatch", "Content-Length does not match the accepted expected size.");
232
+ check(scope, { access: "write", path: plan.path });
233
+ await parentCurrent(plan);
234
+ await absent(plan.path);
235
+ temporary = path.join(plan.parent.path, "." + newId("nexum-upload"));
236
+ output = await open(temporary, constants.O_CREAT |
237
+ constants.O_EXCL |
238
+ constants.O_WRONLY |
239
+ (constants.O_NOFOLLOW ?? 0), 0o600);
240
+ createdTemporary = true;
241
+ identity = await output.stat({ bigint: true });
242
+ requireCondition(identity.isFile(), "file_changed", "The random upload temporary entry must be a regular file.");
243
+ const hash = createHash("sha256");
244
+ let count = 0;
245
+ addAbortSignal(scope.signal, source);
246
+ for await (const input of source) {
247
+ check(scope, { access: "write", path: plan.path });
248
+ const chunk = copyChunk(input, maximum - count);
249
+ let offset = 0;
250
+ while (offset < chunk.byteLength) {
251
+ check(scope, { access: "write", path: plan.path });
252
+ const written = await output.write(chunk, offset, chunk.byteLength - offset, null);
253
+ requireCondition(written.bytesWritten > 0, "transfer_failed", "The upload temporary file stopped accepting bytes.");
254
+ hash.update(chunk.subarray(offset, offset + written.bytesWritten));
255
+ offset += written.bytesWritten;
256
+ count += written.bytesWritten;
257
+ progress(scope, count);
258
+ }
259
+ check(scope, { access: "write", path: plan.path });
260
+ }
261
+ requireCondition((plan.expectedSize === undefined || count === plan.expectedSize) &&
262
+ (options.contentLength === undefined ||
263
+ count === options.contentLength), "transfer_size_mismatch", "The actual upload length does not match its accepted declarations.");
264
+ const sha256 = hash.digest("hex");
265
+ requireCondition(plan.expectedSha256 === undefined || sha256 === plan.expectedSha256, "checksum_mismatch", "The actual upload SHA-256 does not match its accepted declaration.");
266
+ await output.sync();
267
+ identity = await output.stat({ bigint: true });
268
+ requireCondition(identity.isFile() && identity.size === BigInt(count), "file_changed", "The upload temporary file changed during reception.");
269
+ await parentCurrent(plan);
270
+ await absent(plan.path);
271
+ requireCondition(sameFile(identity, await lstat(temporary, { bigint: true })), "file_changed", "The upload temporary file was replaced or changed before commit.");
272
+ check(scope, { access: "write", path: plan.path });
273
+ // No exists+rename fallback: unsupported hard links fail explicitly.
274
+ await link(temporary, plan.path);
275
+ committed = true;
276
+ await parentCurrent(plan);
277
+ const final = await lstat(plan.path, { bigint: true });
278
+ requireCondition(sameFile(identity, final, false), "file_changed", "The committed upload cannot be confirmed at its bound target.");
279
+ receipt = Object.freeze({
280
+ path: plan.path,
281
+ name: path.basename(plan.path),
282
+ size: count,
283
+ mimeType: plan.mimeType,
284
+ sha256,
285
+ revision: digest({
286
+ sha256,
287
+ size: count,
288
+ dev: String(final.dev),
289
+ ino: String(final.ino),
290
+ mtime: String(final.mtimeNs),
291
+ }),
292
+ });
293
+ check(scope, { access: "write", path: plan.path });
294
+ }
295
+ catch (cause) {
296
+ failure = cause;
297
+ source.destroy();
298
+ }
299
+ finally {
300
+ source.destroy();
301
+ try {
302
+ await output?.close();
303
+ }
304
+ catch (cause) {
305
+ cleanupConfirmed = false;
306
+ failure ??= cause;
307
+ }
308
+ if (temporary && createdTemporary) {
309
+ try {
310
+ await parentCurrent(plan);
311
+ const present = await lstat(temporary, { bigint: true });
312
+ requireCondition(identity &&
313
+ present.isFile() &&
314
+ present.dev === identity.dev &&
315
+ present.ino === identity.ino, "file_changed", "The upload temporary entry no longer has its original identity.");
316
+ await unlink(temporary);
317
+ }
318
+ catch (cause) {
319
+ cleanupConfirmed = false;
320
+ failure ??= cause;
321
+ }
322
+ }
323
+ await inputClosure.closed;
324
+ }
325
+ if (failure) {
326
+ const publicError = errorFor(failure, scope.signal);
327
+ throw new TransferIoError(publicError.code, publicError.message, committed, cleanupConfirmed, receipt, failure);
328
+ }
329
+ requireCondition(committed && receipt && cleanupConfirmed, "transfer_failed", "The upload did not establish a fully confirmed commit and cleanup.");
330
+ return receipt;
331
+ }
332
+ function writeChunk(target, chunk) {
333
+ const result = Promise.withResolvers();
334
+ const failed = (cause) => result.reject(cause);
335
+ const closed = () => result.reject(new AgentError("transfer_failed", "The download destination closed before its write completed."));
336
+ target.once("error", failed);
337
+ target.once("close", closed);
338
+ try {
339
+ target.write(chunk, (cause) => cause ? result.reject(cause) : result.resolve());
340
+ }
341
+ catch (cause) {
342
+ result.reject(cause);
343
+ }
344
+ return result.promise.finally(() => {
345
+ target.off("error", failed);
346
+ target.off("close", closed);
347
+ });
348
+ }
349
+ /** Completes the byte stream, not the remote Host's save nor the transfer row. */
350
+ export async function sendDownload(source, target, scope, options) {
351
+ const { resource } = source;
352
+ const outputClosure = closing(target);
353
+ let completion;
354
+ let count = 0;
355
+ const hash = createHash("sha256");
356
+ let failure;
357
+ try {
358
+ policy(options.maxBytes);
359
+ requireCondition(integer(resource.size, options.maxBytes), "resource_exhausted", "The fixed resource exceeds the accepted transfer limit.");
360
+ requireCondition(typeof resource.sha256 === "string" &&
361
+ /^[0-9a-f]{64}$/.test(resource.sha256), "invalid_arguments", "A download must identify a fixed resource checksum.");
362
+ check(scope, { access: "read", uri: resource.uri });
363
+ completion = finished(target, { readable: false, cleanup: true });
364
+ void completion.catch((cause) => source.stream.destroy(cause));
365
+ addAbortSignal(scope.signal, source.stream);
366
+ addAbortSignal(scope.signal, target);
367
+ for await (const input of source.stream) {
368
+ check(scope, { access: "read", uri: resource.uri });
369
+ const chunk = copyChunk(input, Math.min(options.maxBytes, resource.size) - count);
370
+ await writeChunk(target, chunk);
371
+ hash.update(chunk);
372
+ count += chunk.byteLength;
373
+ progress(scope, count);
374
+ check(scope, { access: "read", uri: resource.uri });
375
+ }
376
+ requireCondition(count === resource.size, "transfer_size_mismatch", "The fixed download source ended before its registered length.");
377
+ const sha256 = hash.digest("hex");
378
+ requireCondition(sha256 === resource.sha256, "checksum_mismatch", "The fixed download source no longer matches its registered checksum.");
379
+ await source.closed;
380
+ check(scope, { access: "read", uri: resource.uri });
381
+ target.end();
382
+ await completion;
383
+ check(scope, { access: "read", uri: resource.uri });
384
+ return Object.freeze({
385
+ bytesTransferred: count,
386
+ sha256,
387
+ outputFinished: true,
388
+ });
389
+ }
390
+ catch (cause) {
391
+ failure = cause;
392
+ source.stream.destroy();
393
+ target.destroy();
394
+ const value = errorFor(cause, scope.signal);
395
+ throw new AgentError(value.code, value.message, { bytesTransferred: count }, { cause });
396
+ }
397
+ finally {
398
+ let closureFailure;
399
+ try {
400
+ await source.closed;
401
+ }
402
+ catch (cause) {
403
+ closureFailure = cause;
404
+ }
405
+ if (failure) {
406
+ await completion?.catch(() => { });
407
+ await outputClosure.closed;
408
+ }
409
+ else
410
+ outputClosure.dispose();
411
+ if (closureFailure)
412
+ throw new AgentError("transfer_cleanup_unconfirmed", "The download source could not confirm actual closure.", {
413
+ bytesTransferred: count,
414
+ cleanupConfirmed: false,
415
+ ...(failure
416
+ ? { originalCode: errorFor(failure, scope.signal).code }
417
+ : {}),
418
+ }, {
419
+ cause: failure
420
+ ? new AggregateError([failure, closureFailure], "The transfer and source cleanup both failed.")
421
+ : closureFailure,
422
+ });
423
+ }
424
+ }
425
+ //# sourceMappingURL=io.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/transfer/io.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ import type { JsonObject } from "../contracts/types.js";
2
+ import type { AccessTarget } from "../extensions/api.js";
3
+ import type { ArtifactScope } from "../results/artifacts.js";
4
+ export type IssuedTransferSnapshot = JsonObject & {
5
+ transferId: string;
6
+ direction: "upload" | "download";
7
+ status: "pending";
8
+ expiresAt: string;
9
+ };
10
+ export type TransferReference = JsonObject & {
11
+ transferId: string;
12
+ expiresAt: string;
13
+ };
14
+ export type TransferRequest = {
15
+ readonly method: "GET" | "PUT";
16
+ readonly url: string;
17
+ readonly headers: Readonly<Record<string, string>>;
18
+ readonly expiresAt: string;
19
+ };
20
+ export type TransferOffer = Readonly<IssuedTransferSnapshot & {
21
+ request: TransferRequest;
22
+ }>;
23
+ export interface TransferOfferScope extends Pick<ArtifactScope, "ownerKey" | "signal" | "assertCurrent"> {
24
+ /** The current verified Grant, never recovered from a historical snapshot. */
25
+ readonly grantId?: string;
26
+ /** Fresh Core target authority; never retain a settled creator invocation. */
27
+ readonly authorizeTarget?: (target: AccessTarget) => void;
28
+ }
29
+ export interface TransferBinding {
30
+ readonly ownerKey: string;
31
+ readonly grantId: string;
32
+ readonly agentId: string;
33
+ readonly profileRoot: string;
34
+ }
35
+ export interface IssuedTransferOffer {
36
+ readonly snapshot: IssuedTransferSnapshot;
37
+ readonly reference: TransferReference;
38
+ readonly binding: TransferBinding;
39
+ }
40
+ export type TransferDelivery = JsonObject & {
41
+ transferId: string;
42
+ available: boolean;
43
+ };
44
+ export interface TransferOfferDeliveryOptions {
45
+ readonly agentId: string;
46
+ readonly profileRoot: string;
47
+ readonly maxEntries?: number;
48
+ /** Encoded snapshot/request bytes; entry count independently bounds object overhead. */
49
+ readonly maxBytes?: number;
50
+ readonly now?: () => number;
51
+ /** Trusted current transfer/Grant/target authority, including live unconsumed state. */
52
+ readonly authorize?: (scope: TransferOfferScope, snapshot: IssuedTransferSnapshot) => void;
53
+ }
54
+ export declare function issuedTransferSnapshot(value: unknown): IssuedTransferSnapshot;
55
+ export declare function transferOffer(value: unknown): IssuedTransferOffer | null;
56
+ /** Core-only, analogous to output's issued-intent rebuild after a native-data copy. */
57
+ export declare function rebuildTransferOffer(original: unknown, copiedSnapshot: unknown): TransferOffer;
58
+ export declare function transferReference(value: unknown): TransferReference;
59
+ export declare class TransferOfferDelivery {
60
+ #private;
61
+ readonly agentId: string;
62
+ readonly profileRoot: string;
63
+ readonly maxEntries: number;
64
+ readonly maxBytes: number;
65
+ constructor(options: TransferOfferDeliveryOptions);
66
+ /** Caller has already completed registration, channel preparation and handoff. */
67
+ issue(value: unknown, channel: TransferRequest, scope: TransferOfferScope): TransferOffer;
68
+ deliver(value: TransferReference, scope: TransferOfferScope): TransferDelivery;
69
+ forget(transferId: string, reason?: "consumed" | "expired" | "terminal" | "unavailable"): void;
70
+ }
71
+ /** Only for existing synchronous JSON log/progress branches, not arbitrary URL redaction. */
72
+ export declare function transferSafeJSON(value: unknown, maxBytes?: number, project?: (value: unknown) => JsonObject | null): string;