@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,286 @@
1
+ import { lstatSync, realpathSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { authorizeCall } from "../contracts/caller.js";
4
+ import { isAgentError, requireCondition, } from "../contracts/errors.js";
5
+ import { canonicalJson, isPlainRecord } from "../contracts/json.js";
6
+ import { validateContract } from "../contracts/validation.js";
7
+ import { contains } from "../runtime/paths.js";
8
+ const iso = (value) => value === null ? null : new Date(value).toISOString();
9
+ const json = (value, maximum = 1024 * 1024) => JSON.parse(canonicalJson(value, maximum));
10
+ function error(value) {
11
+ if (!value)
12
+ return null;
13
+ return {
14
+ code: typeof value.code === "string" ? value.code : "agent_error",
15
+ message: typeof value.message === "string"
16
+ ? value.message
17
+ : "The Agent operation failed.",
18
+ ...((value.details &&
19
+ typeof value.details === "object" &&
20
+ !Array.isArray(value.details)) ||
21
+ value.phase
22
+ ? {
23
+ details: {
24
+ ...(value.details ?? {}),
25
+ ...(value.phase ? { phase: value.phase } : {}),
26
+ },
27
+ }
28
+ : {}),
29
+ };
30
+ }
31
+ function retained(root, run, ref) {
32
+ if (!ref || !root)
33
+ return false;
34
+ try {
35
+ const filename = path.resolve(root, ref);
36
+ const allowed = [
37
+ path.join(root, "work", "tmp", "runs", run.runId),
38
+ path.join(root, "logs", "runs", run.runId),
39
+ ];
40
+ return (allowed.some((dir) => contains(dir, filename)) &&
41
+ realpathSync.native(filename) === filename &&
42
+ lstatSync(filename).isFile());
43
+ }
44
+ catch {
45
+ return false;
46
+ }
47
+ }
48
+ export function projectRunRecord(run, options = {}) {
49
+ const source = run.source;
50
+ const candidate = source.origin;
51
+ const origin = candidate &&
52
+ typeof candidate === "object" &&
53
+ !Array.isArray(candidate) &&
54
+ ["local", "platform", "extension"].includes(String(candidate.type)) &&
55
+ typeof candidate.owner === "string" &&
56
+ typeof candidate.revision === "string"
57
+ ? json(candidate)
58
+ : null;
59
+ return {
60
+ runId: run.runId,
61
+ contextId: run.contextId,
62
+ projectId: run.projectId,
63
+ revision: run.revision,
64
+ status: run.status,
65
+ scriptName: run.scriptName,
66
+ source: { inline: "inline", script: "named", replay: "history" }[run.sourceKind],
67
+ origin,
68
+ replayOfRunId: typeof source.replayRunId === "string" ? source.replayRunId : null,
69
+ acceptedAt: iso(run.acceptedAt),
70
+ startedAt: iso(run.startedAt),
71
+ finishedAt: iso(run.endedAt),
72
+ updatedAt: iso(run.updatedAt),
73
+ deadlineAt: iso(run.deadlineAt),
74
+ error: error(run.error),
75
+ stop: json(run.stop),
76
+ cleanup: json(run.cleanup),
77
+ availability: {
78
+ code: retained(options.root, run, run.codeRef),
79
+ input: retained(options.root, run, run.inputRef),
80
+ result: retained(options.root, run, run.resultRef),
81
+ logs: retained(options.root, run, run.logsRef),
82
+ ...options.availability,
83
+ },
84
+ ...(typeof source.scriptDesc === "string"
85
+ ? {
86
+ scriptDesc: source.scriptDesc.slice(0, 2048),
87
+ ...(source.scriptDesc.length > 2048
88
+ ? { descriptionTruncated: true }
89
+ : {}),
90
+ }
91
+ : {}),
92
+ };
93
+ }
94
+ function hasInlineIcon(value) {
95
+ return value.content.some((item) => Array.isArray(item.icons) &&
96
+ item.icons.some((icon) => {
97
+ if (!icon ||
98
+ typeof icon !== "object" ||
99
+ Array.isArray(icon) ||
100
+ typeof icon.src !== "string")
101
+ return false;
102
+ try {
103
+ return new URL(icon.src).protocol === "data:";
104
+ }
105
+ catch {
106
+ return false;
107
+ }
108
+ }));
109
+ }
110
+ /** Core facts become bounded wire data here; no result is rerun and no media is encoded as control JSON. */
111
+ export async function projectRunView(view, ports) {
112
+ authorizeCall(() => ports.scope.assertCurrent());
113
+ ports.scope.signal?.throwIfAborted();
114
+ const textBytes = Math.min(65536, ports.budgets.textBytes ?? 65536);
115
+ const controlBytes = Math.min(1024 * 1024, ports.budgets.controlBytes ?? 1024 * 1024);
116
+ requireCondition(textBytes > 0 && controlBytes > 0, "run_context_too_large", "The current response budget cannot carry the Run state.", { runId: view.run.runId, status: view.run.status });
117
+ const projected = {
118
+ run: projectRunRecord(view.run, {
119
+ root: ports.encoder.artifacts.root,
120
+ availability: { result: view.result !== null },
121
+ }),
122
+ wait: view.wait
123
+ ? {
124
+ waitId: view.wait.waitId,
125
+ revision: view.wait.revision,
126
+ status: view.wait.status,
127
+ deliveryState: view.wait.deliveryState,
128
+ request: json(view.wait.request),
129
+ createdAt: iso(view.wait.createdAt),
130
+ deadlineAt: iso(view.wait.deadlineAt),
131
+ consumedAt: iso(view.wait.consumedAt),
132
+ error: error(view.wait.error),
133
+ }
134
+ : null,
135
+ result: null,
136
+ observedAt: new Date().toISOString(),
137
+ operations: json(view.operations),
138
+ resources: json(view.resources),
139
+ ...(view.unavailable ? { unavailable: error(view.unavailable) } : {}),
140
+ };
141
+ const output = projected;
142
+ const notes = {};
143
+ if ("snapshots" in view) {
144
+ const snapshots = view.snapshots;
145
+ for (const name of ["code", "input", "logs"]) {
146
+ const snapshot = snapshots[name];
147
+ if (snapshot.status === "available" && Object.hasOwn(snapshot, "value")) {
148
+ if (name === "input")
149
+ output.input = snapshot.value;
150
+ else {
151
+ const text = name === "code" && isPlainRecord(snapshot.value)
152
+ ? snapshot.value.code
153
+ : snapshot.value;
154
+ requireCondition(typeof text === "string", "run_detail_invalid", "The retained Run text snapshot is invalid.");
155
+ output[name] = {
156
+ text,
157
+ complete: snapshot.truncated !== true,
158
+ nextCursor: null,
159
+ };
160
+ }
161
+ }
162
+ if (snapshot.status === "unavailable" ||
163
+ snapshot.status === "too_large" ||
164
+ snapshot.truncated) {
165
+ notes[name] = {
166
+ status: snapshot.status,
167
+ bytes: snapshot.bytes,
168
+ ...(snapshot.nextOffset === undefined
169
+ ? {}
170
+ : { nextOffset: snapshot.nextOffset }),
171
+ ...(snapshot.startOffset === undefined
172
+ ? {}
173
+ : {
174
+ startOffset: snapshot.startOffset,
175
+ endOffset: snapshot.endOffset,
176
+ dataOffset: snapshot.dataOffset,
177
+ }),
178
+ ...(snapshot.ref &&
179
+ retained(ports.encoder.artifacts.root, view.run, snapshot.ref)
180
+ ? { path: path.resolve(ports.encoder.artifacts.root, snapshot.ref) }
181
+ : {}),
182
+ };
183
+ }
184
+ }
185
+ }
186
+ const size = () => Buffer.byteLength(canonicalJson(output));
187
+ // Optional retained bodies may be omitted whole, rather than returning a partial JSON value or Schema.
188
+ const frameLimit = Math.max(0, textBytes - (view.result ? 4096 : 1024));
189
+ for (const name of ["logs", "input", "code"]) {
190
+ if (size() <= frameLimit)
191
+ break;
192
+ if (Object.hasOwn(output, name)) {
193
+ delete output[name];
194
+ notes[name] = {
195
+ ...(notes[name] ?? {}),
196
+ reason: "context_budget",
197
+ };
198
+ }
199
+ }
200
+ for (const group of [projected.operations, projected.resources]) {
201
+ while (size() > frameLimit && group.items.length > 0) {
202
+ group.items.pop();
203
+ group.complete = false;
204
+ }
205
+ }
206
+ if (Object.keys(notes).length) {
207
+ const previous = projected.unavailable;
208
+ output.unavailable = {
209
+ code: previous?.code ?? "retained_details_partial",
210
+ message: previous?.message ??
211
+ "Some retained details are unavailable or exceed this observation's context budget.",
212
+ details: { ...(previous?.details ?? {}), snapshots: notes },
213
+ };
214
+ }
215
+ requireCondition(size() <= Math.min(textBytes - 512, controlBytes - 512), "run_context_too_large", "The complete mandatory Run or input-request metadata exceeds this response budget.", { runId: view.run.runId, status: view.run.status });
216
+ if (view.result) {
217
+ let described;
218
+ const unavailable = (reason) => {
219
+ output.unavailable = {
220
+ code: "retained_result_partial",
221
+ message: "The saved result cannot be included completely in this read-only view.",
222
+ details: {
223
+ ...(projected.unavailable?.details ?? {}),
224
+ result: { reason },
225
+ },
226
+ };
227
+ };
228
+ try {
229
+ described = await ports.encoder.describe(view.result, ports.scope, {
230
+ textBytes: Math.max(1, textBytes - size() - 512),
231
+ ...(ports.readOnly ? { readOnly: true } : {}),
232
+ });
233
+ }
234
+ catch (cause) {
235
+ if (!ports.readOnly ||
236
+ !isAgentError(cause) ||
237
+ ![
238
+ "resource_expired",
239
+ "resource_changed",
240
+ "resource_unavailable",
241
+ ].includes(cause.code))
242
+ throw cause;
243
+ unavailable(cause.code);
244
+ }
245
+ if (described) {
246
+ validateContract("wire.body:Result", described.result);
247
+ if (ports.readOnly) {
248
+ if (hasInlineIcon(described.result) ||
249
+ Buffer.byteLength(canonicalJson(described.result, 64 * 1024 * 1024)) +
250
+ size() >
251
+ Math.min(textBytes, controlBytes) - 512)
252
+ unavailable("context_budget");
253
+ else
254
+ output.result = JSON.parse(canonicalJson(described.result, controlBytes));
255
+ }
256
+ else {
257
+ let protocolMeta;
258
+ if (described.hostMeta)
259
+ protocolMeta = {
260
+ stream: await ports.shipJson(described.hostMeta, "result-meta"),
261
+ };
262
+ // The same fixed metadata body carries large standard icons without putting data URIs into WSS JSON.
263
+ const body = hasInlineIcon(described.result) ||
264
+ Buffer.byteLength(canonicalJson(described.result, 64 * 1024 * 1024)) +
265
+ size() >
266
+ controlBytes - 1024;
267
+ const result = body
268
+ ? {
269
+ body: await ports.shipJson(described.result, "result-meta"),
270
+ ...(protocolMeta ? { protocolMeta } : {}),
271
+ }
272
+ : { ...described.result, ...(protocolMeta ? { protocolMeta } : {}) };
273
+ output.result = JSON.parse(canonicalJson(result, controlBytes));
274
+ if (described.transfers.length)
275
+ output.transient = {
276
+ transfers: described.transfers,
277
+ };
278
+ }
279
+ }
280
+ }
281
+ authorizeCall(() => ports.scope.assertCurrent());
282
+ ports.scope.signal?.throwIfAborted();
283
+ requireCondition(Buffer.byteLength(canonicalJson(output)) <= controlBytes - 256, "data_too_large", "The actual Run response exceeds its control-message budget.");
284
+ return projected;
285
+ }
286
+ //# sourceMappingURL=run-view.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-view.js","sourceRoot":"","sources":["../../src/application/run-view.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ import { type Caller } from "../contracts/caller.js";
2
+ import type { JsonObject } from "../contracts/types.js";
3
+ import type { WireConnectionV2, WireInvokeV2, WireInvocationContextV2, WireOperationV2, WireInputsV2, WireOutputsV2, WireEventV2, WireFixedStreamRefV2, WireAuthorizationRefreshInputV2 } from "../contracts/wire.js";
4
+ import { SqliteStore } from "../storage/sqlite.js";
5
+ import { ModuleLoader, type ModulePolicy } from "../runtime/modules.js";
6
+ import { RunEngine } from "../runtime/engine.js";
7
+ import type { VerifiedPackageSnapshot } from "../maintenance/npm.js";
8
+ import { ExtensionRegistry } from "../extensions/registry.js";
9
+ import { ResourceManager } from "../extensions/resources.js";
10
+ import { ArtifactStore } from "../results/artifacts.js";
11
+ import { ResultEncoder } from "../results/encoder.js";
12
+ import { TransferStreamSlots } from "../transfer/stream-slots.js";
13
+ import { type UserStateBackend } from "../services/state.js";
14
+ import { ExtensionServices } from "../services/extensions.js";
15
+ import { ExtensionEnablement } from "../maintenance/npm.js";
16
+ import { type MaintenanceRequests, type MaintenanceScope } from "../maintenance/requests.js";
17
+ import type { MaintenanceBackend } from "../maintenance/requests.js";
18
+ import { AgentDataPlane } from "./data-plane.js";
19
+ import type { ProfileConfiguration } from "./config.js";
20
+ export interface AgentControlPort {
21
+ readonly binding: Readonly<WireConnectionV2>;
22
+ readonly signal: AbortSignal;
23
+ send(message: WireEventV2): Promise<void>;
24
+ request<O extends WireOperationV2>(operation: O, context: WireInvocationContextV2, input: WireInputsV2[O], signal: AbortSignal, timeoutMs?: number): Promise<WireOutputsV2[O]>;
25
+ }
26
+ /** Only the trusted application composition callback receives these Core objects. */
27
+ export interface ApplicationComponents {
28
+ readonly store: SqliteStore;
29
+ readonly engine: RunEngine;
30
+ readonly artifacts: ArtifactStore;
31
+ readonly encoder: ResultEncoder;
32
+ readonly resources: ResourceManager;
33
+ readonly modules: ModuleLoader;
34
+ readonly extensions: ExtensionServices;
35
+ readonly enablement: ExtensionEnablement;
36
+ readonly registry: ExtensionRegistry;
37
+ readonly streams: TransferStreamSlots;
38
+ reserve(bytes: number, options?: {
39
+ control?: boolean;
40
+ }): Promise<{
41
+ release(): void;
42
+ }>;
43
+ readonly signal: AbortSignal;
44
+ control(): AgentControlPort;
45
+ data(): AgentDataPlane;
46
+ context(caller: Caller, projectId?: string | null): WireInvocationContextV2;
47
+ scope(caller: Caller, signal: AbortSignal, runId?: string): MaintenanceScope;
48
+ startLease(caller: Caller, source: WireAuthorizationRefreshInputV2, signal: AbortSignal): ApplicationAuthorityLease;
49
+ onShutdown(join: () => Promise<void>): () => void;
50
+ shipJson(value: JsonObject, purpose: "maintenance" | "host-request" | "result-meta", signal: AbortSignal, context?: WireInvocationContextV2, originInvocationId?: string, runId?: string): Promise<WireFixedStreamRefV2>;
51
+ configurationBackend(): Promise<MaintenanceBackend>;
52
+ refreshPackages(snapshot?: VerifiedPackageSnapshot): Promise<void>;
53
+ }
54
+ export interface AgentRuntimeOptions {
55
+ readonly version?: string;
56
+ readonly home?: string | null;
57
+ readonly modulePolicy?: ModulePolicy;
58
+ readonly extensionPermissions?: ReadonlySet<string>;
59
+ readonly userState?: UserStateBackend;
60
+ readonly shutdownWaitMs?: number;
61
+ configureMaintenance?(components: ApplicationComponents): MaintenanceRequests | Promise<MaintenanceRequests>;
62
+ dispatchMaintenance?(message: WireInvokeV2, scope: MaintenanceScope, components: ApplicationComponents, service: MaintenanceRequests, observerSignal: AbortSignal): Promise<unknown>;
63
+ }
64
+ export interface ApplicationAuthorityLease {
65
+ readonly scope: MaintenanceScope;
66
+ refresh(): Promise<void>;
67
+ close(): void;
68
+ }
69
+ /** One process boot's actual Core composition. A control reconnect never creates another engine. */
70
+ export declare class AgentRuntime {
71
+ #private;
72
+ private constructor();
73
+ static create(config: ProfileConfiguration, connection: AgentControlPort, bootId: string, options?: AgentRuntimeOptions): Promise<AgentRuntime>;
74
+ attachConnection(connection: AgentControlPort): Promise<void>;
75
+ event(message: WireEventV2, signal: AbortSignal): Promise<void>;
76
+ dispatch(message: WireInvokeV2, signal: AbortSignal): Promise<unknown>;
77
+ close(): Promise<void>;
78
+ }