@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,242 @@
1
+ import { lstatSync, readFileSync, realpathSync } from "node:fs";
2
+ import path from "node:path";
3
+ import { createHash } from "node:crypto";
4
+ import { types } from "node:util";
5
+ import { AgentError, requireCondition } from "../contracts/errors.js";
6
+ import { atomicText, privateDirectory } from "./paths.js";
7
+ // Installed Agent metadata is trusted program input. Importing this module only
8
+ // reads it; platform files are written solely by explicit initialization below.
9
+ const installed = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
10
+ requireCondition(typeof installed.name === "string" &&
11
+ installed.name.length > 0 &&
12
+ installed.name.length <= 256 &&
13
+ typeof installed.version === "string" &&
14
+ /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(installed.version), "invalid_control_package", "Fixed platform scripts require the actual installed Agent name and version.");
15
+ export const CONTROL_OWNER = installed.name;
16
+ export const CONTROL_VERSION = installed.version;
17
+ export { DEFAULT_CONTROL_CAPACITY } from "../contracts/types.js";
18
+ const id = { type: "string", minLength: 1, maxLength: 256 };
19
+ const cursor = { type: "string", minLength: 1, maxLength: 8192 };
20
+ const wait = { type: "integer", minimum: 0, maximum: 30000 };
21
+ const limit = { type: "integer", minimum: 1, maximum: 100 };
22
+ function schema(properties, required = [], extra = {}) {
23
+ return {
24
+ type: "object",
25
+ properties,
26
+ required,
27
+ additionalProperties: false,
28
+ ...extra,
29
+ };
30
+ }
31
+ function immutable(value) {
32
+ if (value && typeof value === "object") {
33
+ for (const child of Object.values(value))
34
+ immutable(child);
35
+ Object.freeze(value);
36
+ }
37
+ return value;
38
+ }
39
+ function define(namespace, method, description, when, input, body) {
40
+ const filename = `${method}.js`;
41
+ const metadata = {
42
+ scriptName: filename,
43
+ scriptDesc: description,
44
+ scriptWhenUse: when,
45
+ scriptInputSchema: input,
46
+ scriptOpenDefault: true,
47
+ };
48
+ const code = `/**\n${JSON.stringify(metadata, null, 2)}\n*/\n${body ?? `return await ${namespace}.${method}(context.input);`}\n`;
49
+ return immutable({
50
+ name: `${namespace}/${filename}`,
51
+ namespace,
52
+ filename,
53
+ code,
54
+ revision: createHash("sha256").update(code).digest("hex"),
55
+ metadata,
56
+ });
57
+ }
58
+ // This closed set is program code, never an allowlist accepted from an SDK,
59
+ // script header, MCP input, local contribution or extension configuration.
60
+ export const FIXED_CONTROL_SCRIPTS = immutable([
61
+ define("sh", "get", "读取托管进程的当前状态和增量输出", "普通运行已满时查询原进程;不启动新命令", schema({
62
+ processId: id,
63
+ cursor,
64
+ maxBytes: { type: "integer", minimum: 1, maximum: 1048576 },
65
+ waitMs: wait,
66
+ encoding: {
67
+ anyOf: [
68
+ {
69
+ type: "string",
70
+ enum: [
71
+ "ascii",
72
+ "utf8",
73
+ "utf-8",
74
+ "utf16le",
75
+ "utf-16le",
76
+ "ucs2",
77
+ "ucs-2",
78
+ "base64",
79
+ "base64url",
80
+ "latin1",
81
+ "binary",
82
+ "hex",
83
+ ],
84
+ },
85
+ { type: "null" },
86
+ ],
87
+ },
88
+ }, ["processId"])),
89
+ define("sh", "list", "按当前授权查询托管进程历史和活动记录", "寻找可继续读取或控制的原进程身份", schema({
90
+ status: { type: "string", minLength: 1, maxLength: 128 },
91
+ state: { type: "string", minLength: 1, maxLength: 128 },
92
+ runId: id,
93
+ contextId: id,
94
+ limit,
95
+ cursor,
96
+ })),
97
+ define("sh", "write", "向托管进程写入文本或结束普通 stdin", "向现有交互进程提交输入;不创建进程", schema({
98
+ processId: id,
99
+ data: {
100
+ type: "string",
101
+ maxLength: 1048576,
102
+ description: "UTF-8 实际字节上限仍由 sh SDK 检查",
103
+ },
104
+ eof: { type: "boolean" },
105
+ }, ["processId"], {
106
+ anyOf: [
107
+ { required: ["data"], properties: { data: {} } },
108
+ { required: ["eof"], properties: { eof: { const: true } } },
109
+ ],
110
+ })),
111
+ define("sh", "resize", "调整托管 PTY 的列数和行数", "调整现有终端尺寸,非 PTY 会明确报错", schema({
112
+ processId: id,
113
+ cols: { type: "integer", minimum: 1, maximum: 1000 },
114
+ rows: { type: "integer", minimum: 1, maximum: 1000 },
115
+ }, ["processId", "cols", "rows"])),
116
+ define("sh", "signal", "向托管进程投递平台支持的信号", "请求现有进程中断;投递不等于已退出", schema({
117
+ processId: id,
118
+ signal: { type: "string", pattern: "^SIG[A-Z0-9]+$", maxLength: 32 },
119
+ }, ["processId", "signal"])),
120
+ define("sh", "stop", "停止托管进程及受管后代并报告实际收尾", "普通运行已满时停止原进程或后台服务", schema({
121
+ processId: id,
122
+ graceMs: wait,
123
+ forceMs: wait,
124
+ }, ["processId"])),
125
+ define("transfer", "get", "查询传输状态并可短暂等待", "继续跟踪已登记的上传或下载,不新建通道", schema({
126
+ transferId: id,
127
+ waitMs: wait,
128
+ }, ["transferId"]), "const { transferId, ...options } = context.input;\nreturn await transfer.get(transferId, options);"),
129
+ define("transfer", "list", "按当前授权查询传输记录", "寻找原传输身份,不创建或重复执行传输", schema({
130
+ direction: { type: "string", enum: ["upload", "download"] },
131
+ status: {
132
+ type: "string",
133
+ enum: [
134
+ "preparing",
135
+ "pending",
136
+ "transferring",
137
+ "cancelling",
138
+ "succeeded",
139
+ "failed",
140
+ "cancelled",
141
+ "expired",
142
+ "interrupted",
143
+ ],
144
+ },
145
+ runId: id,
146
+ limit,
147
+ cursor,
148
+ })),
149
+ define("transfer", "cancel", "请求取消已登记传输", "停止原上传或下载,结果以实际传输状态为准", schema({ transferId: id }, ["transferId"]), "return await transfer.cancel(context.input.transferId);"),
150
+ ]);
151
+ const definitions = new Map(FIXED_CONTROL_SCRIPTS.map((script) => [script.name, script]));
152
+ /** Explicit installation/initialization; this source is isolated from local bare-name scripts. */
153
+ export function materializeControlScripts(work) {
154
+ requireCondition(path.isAbsolute(work) && realpathSync.native(work) === work, "storage_path_escape", "Platform control sources require the established profile work directory.");
155
+ const root = privateDirectory(work, ".platform-controls", CONTROL_VERSION);
156
+ const sources = [];
157
+ for (const namespace of ["sh", "transfer"]) {
158
+ const directory = privateDirectory(root, namespace);
159
+ for (const script of FIXED_CONTROL_SCRIPTS.filter((value) => value.namespace === namespace)) {
160
+ const filename = path.join(directory, script.filename);
161
+ const existing = lstatSync(filename, { throwIfNoEntry: false });
162
+ requireCondition(!existing || existing.isFile(), "storage_path_escape", "A platform control file cannot redirect to another location.");
163
+ atomicText(filename, script.code);
164
+ }
165
+ sources.push(Object.freeze({
166
+ type: "platform",
167
+ owner: CONTROL_OWNER,
168
+ namespace,
169
+ version: CONTROL_VERSION,
170
+ directory,
171
+ }));
172
+ }
173
+ return Object.freeze(sources);
174
+ }
175
+ /** Fixed lifecycle sources may use the Core's reserved control headroom. */
176
+ export async function materializeManagedControlScripts(work, reserve) {
177
+ const bytes = FIXED_CONTROL_SCRIPTS.reduce((total, script) => total + Buffer.byteLength(script.code) + 1024, 0);
178
+ const ticket = await reserve(bytes, { control: true });
179
+ try {
180
+ return materializeControlScripts(work);
181
+ }
182
+ finally {
183
+ ticket.release();
184
+ }
185
+ }
186
+ const changedSource = new Set([
187
+ "script_not_found",
188
+ "script_name_conflict",
189
+ "script_path_escape",
190
+ "script_too_large",
191
+ "invalid_script_header",
192
+ "script_header_mismatch",
193
+ "invalid_script_name",
194
+ "invalid_input_schema",
195
+ ]);
196
+ const unreadable = new Set(["ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP"]);
197
+ /** A source mismatch is ordinary work, not a request to elevate arbitrary code. */
198
+ export function qualifyControlScript(catalog, name) {
199
+ const fixed = definitions.get(name);
200
+ if (!fixed)
201
+ return undefined;
202
+ let current;
203
+ try {
204
+ current = catalog.resolve(name);
205
+ }
206
+ catch (cause) {
207
+ if (types.isProxy(cause))
208
+ throw cause;
209
+ if (cause instanceof AgentError && changedSource.has(cause.code))
210
+ return undefined;
211
+ const code = cause && typeof cause === "object"
212
+ ? Object.getOwnPropertyDescriptor(cause, "code")
213
+ : undefined;
214
+ if (code && "value" in code && unreadable.has(code.value))
215
+ return undefined;
216
+ // Unknown policy/configuration failures must not be treated as permission.
217
+ throw cause;
218
+ }
219
+ if (current.name !== fixed.name ||
220
+ current.code !== fixed.code ||
221
+ current.origin.type !== "platform" ||
222
+ current.origin.owner !== CONTROL_OWNER ||
223
+ current.origin.namespace !== fixed.namespace ||
224
+ current.origin.version !== CONTROL_VERSION ||
225
+ current.origin.revision !== fixed.revision ||
226
+ createHash("sha256").update(current.code).digest("hex") !== fixed.revision)
227
+ return undefined;
228
+ return immutable({
229
+ name: fixed.name,
230
+ code: fixed.code,
231
+ metadata: { ...fixed.metadata },
232
+ path: current.path,
233
+ origin: {
234
+ type: "platform",
235
+ owner: CONTROL_OWNER,
236
+ namespace: fixed.namespace,
237
+ version: CONTROL_VERSION,
238
+ revision: fixed.revision,
239
+ },
240
+ });
241
+ }
242
+ //# sourceMappingURL=control-scripts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"control-scripts.js","sourceRoot":"","sources":["../../src/runtime/control-scripts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,177 @@
1
+ import { EventEmitter } from "node:events";
2
+ import type { JsonObject, JsonValue, ContributionOrigin, RunRecord, RunStatus, WaitRecord, WorkRecord } from "../contracts/types.js";
3
+ import { SqliteStore } from "../storage/sqlite.js";
4
+ import { ModuleLoader } from "./modules.js";
5
+ import { ScriptCatalog, type ScriptSnapshot } from "./scripts.js";
6
+ import type { ResourceManager } from "../extensions/resources.js";
7
+ import { type OperationHooks } from "./operations.js";
8
+ import { type Caller } from "../contracts/caller.js";
9
+ export { callerKey, type Caller } from "../contracts/caller.js";
10
+ export interface StartInput {
11
+ contextId: string;
12
+ script?: string;
13
+ scriptName?: string;
14
+ replayRunId?: string;
15
+ input?: JsonValue;
16
+ attachments?: JsonObject[];
17
+ requestId?: string;
18
+ pwd?: string;
19
+ timeoutMs?: number;
20
+ waitMs?: number;
21
+ }
22
+ export interface GetInput {
23
+ agentId: string;
24
+ runId?: string;
25
+ requestId?: string;
26
+ waitMs?: number;
27
+ }
28
+ export interface ListInput {
29
+ agentId: string;
30
+ status?: RunStatus;
31
+ scriptName?: string;
32
+ source?: "inline" | "named" | "history";
33
+ projectId?: string;
34
+ contextId?: string;
35
+ from?: string;
36
+ to?: string;
37
+ limit?: number;
38
+ cursor?: string;
39
+ }
40
+ export interface RetainedSnapshot {
41
+ readonly ref: string | null;
42
+ readonly status: "available" | "unavailable" | "not_recorded" | "too_large";
43
+ readonly bytes: number | null;
44
+ readonly value?: JsonValue;
45
+ readonly truncated?: true;
46
+ readonly nextOffset?: number;
47
+ readonly startOffset?: number;
48
+ readonly endOffset?: number;
49
+ readonly dataOffset?: number;
50
+ }
51
+ export interface CancelView extends RunView {
52
+ /** This invocation actually recorded the first stop request; it does not confirm shutdown. */
53
+ readonly accepted: boolean;
54
+ }
55
+ /** Internal retained detail; the Cloud adapter must project results and move media before model delivery. */
56
+ export interface RunDetails extends RunView {
57
+ readonly snapshots: {
58
+ readonly code: RetainedSnapshot;
59
+ readonly input: RetainedSnapshot;
60
+ readonly logs: RetainedSnapshot;
61
+ };
62
+ }
63
+ export interface RunSummary extends JsonObject {
64
+ runId: string;
65
+ scriptName: string | null;
66
+ scriptDesc: string | null;
67
+ source: "inline" | "named" | "history";
68
+ origin: JsonObject | null;
69
+ projectId: string | null;
70
+ contextId: string;
71
+ status: RunStatus;
72
+ acceptedAt: string;
73
+ startedAt: string | null;
74
+ endedAt: string | null;
75
+ replayOfRunId: string | null;
76
+ availability: JsonObject;
77
+ }
78
+ export interface InputRequest {
79
+ message: string;
80
+ inputSchema: JsonValue;
81
+ timeoutMs?: number;
82
+ }
83
+ export interface RunServices {
84
+ readonly runId: string;
85
+ readonly signal: AbortSignal;
86
+ readonly context: JsonObject;
87
+ /** Fixed Core verdict; not script context or an extension-provided permission. */
88
+ readonly controlStorage?: boolean;
89
+ readonly deadlineAt: number;
90
+ assertActive(): void;
91
+ /** Existing operations keep current authority while root admission is closed. */
92
+ assertCurrent(): void;
93
+ /** Trusted wrappers check script admission, normalize/validate and authorize before this core service. */
94
+ operation<T>(origin: ContributionOrigin, method: string, action: (operationId: string) => T | Promise<T>, hooks?: OperationHooks<T>): T | Promise<T>;
95
+ requestInput(request: InputRequest): Promise<JsonObject>;
96
+ }
97
+ export interface EngineOptions {
98
+ authorize(caller: Caller, target: {
99
+ action: string;
100
+ run?: RunRecord;
101
+ work?: WorkRecord;
102
+ path?: string;
103
+ origin?: ScriptSnapshot["origin"];
104
+ }): void;
105
+ loadWork(work: WorkRecord): JsonObject | Promise<JsonObject>;
106
+ encodeResult(value: unknown, services: RunServices): Promise<JsonObject>;
107
+ bindings(services: RunServices): Readonly<Record<string, unknown>>;
108
+ prepareAttachments?(references: readonly JsonObject[], directory: string, services: RunServices): Promise<JsonObject[]>;
109
+ capacity?: number;
110
+ controlCapacity?: number;
111
+ resources?: ResourceManager;
112
+ leaseScript?(origin: ContributionOrigin): () => void;
113
+ reserve?(bytes: number, options?: {
114
+ readonly control?: boolean;
115
+ }): Promise<{
116
+ release(): void;
117
+ }>;
118
+ }
119
+ export interface RunView {
120
+ run: RunRecord;
121
+ wait: WaitRecord | null;
122
+ result: JsonObject | null;
123
+ unavailable?: JsonObject;
124
+ operations: {
125
+ items: JsonObject[];
126
+ complete: boolean;
127
+ };
128
+ resources: {
129
+ items: JsonObject[];
130
+ complete: boolean;
131
+ };
132
+ }
133
+ export declare class RunEngine extends EventEmitter {
134
+ #private;
135
+ readonly store: SqliteStore;
136
+ readonly loader: ModuleLoader;
137
+ readonly scripts: ScriptCatalog;
138
+ constructor(store: SqliteStore, loader: ModuleLoader, scripts: ScriptCatalog, options: EngineOptions);
139
+ activeSnapshotRefs(): ReadonlySet<string>;
140
+ get(caller: Caller, input: GetInput, signal?: AbortSignal): Promise<RunDetails>;
141
+ list(caller: Caller, input: ListInput): {
142
+ runs: RunSummary[];
143
+ nextCursor: string | null;
144
+ };
145
+ start(caller: Caller, input: StartInput, observationSignal?: AbortSignal): Promise<RunView>;
146
+ input(caller: Caller, input: {
147
+ agentId: string;
148
+ runId: string;
149
+ waitId: string;
150
+ input: JsonValue;
151
+ attachments?: JsonObject[];
152
+ waitMs?: number;
153
+ }, signal?: AbortSignal): Promise<{
154
+ submission: WaitRecord;
155
+ run: RunRecord;
156
+ wait: WaitRecord | null;
157
+ result: JsonObject | null;
158
+ unavailable?: JsonObject;
159
+ operations: {
160
+ items: JsonObject[];
161
+ complete: boolean;
162
+ };
163
+ resources: {
164
+ items: JsonObject[];
165
+ complete: boolean;
166
+ };
167
+ }>;
168
+ /** Trusted Core authority revocation, never a script/transport parameter entry. */
169
+ stopAcceptedRun(runId: string, reason: {
170
+ readonly code: string;
171
+ }): {
172
+ accepted: boolean;
173
+ run: RunRecord;
174
+ };
175
+ cancel(caller: Caller, runId: string): CancelView;
176
+ observe(caller: Caller, runId: string, waitMs?: number, signal?: AbortSignal, afterInput?: boolean): Promise<RunView>;
177
+ }