@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,25 @@
1
+ import type { JsonValue } from "../contracts/types.js";
2
+ export interface StateValue {
3
+ readonly value: JsonValue;
4
+ readonly version: number;
5
+ readonly updatedAt: number;
6
+ }
7
+ export interface StateDeletion {
8
+ readonly deleted: true;
9
+ readonly version: number;
10
+ readonly updatedAt: number;
11
+ }
12
+ export interface StateNamespace {
13
+ get(key: string): Promise<StateValue | null>;
14
+ set(key: string, value: JsonValue, options: {
15
+ expectedVersion: number | null;
16
+ }): Promise<StateValue>;
17
+ delete(key: string, options: {
18
+ expectedVersion: number;
19
+ }): Promise<StateDeletion>;
20
+ }
21
+ export interface StateService {
22
+ readonly agent: StateNamespace;
23
+ readonly user: StateNamespace;
24
+ }
25
+ export declare function unavailableState(current: () => void): StateService;
@@ -0,0 +1,10 @@
1
+ import { AgentError } from "../contracts/errors.js";
2
+ export function unavailableState(current) {
3
+ const fail = async () => {
4
+ current();
5
+ throw new AgentError("state_service_unavailable", "Shared state services are not connected for this Agent.");
6
+ };
7
+ const namespace = Object.freeze({ get: fail, set: fail, delete: fail });
8
+ return Object.freeze({ agent: namespace, user: namespace });
9
+ }
10
+ //# sourceMappingURL=state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/extensions/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA6BpD,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,MAAM,IAAI,GAAG,KAAK,IAAoB,EAAE;QACtC,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,UAAU,CAClB,2BAA2B,EAC3B,yDAAyD,CAC1D,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9D,CAAC"}
@@ -0,0 +1,81 @@
1
+ import type { JsonObject } from "../contracts/types.js";
2
+ import type { ArtifactRecord } from "../results/artifacts.js";
3
+ import type { TransferStatus } from "../storage/transfers.js";
4
+ import type { UploadFileReceipt } from "../transfer/io.js";
5
+ import type { TransferOffer } from "../transfer/offers.js";
6
+ export interface UploadOptions {
7
+ readonly path: string;
8
+ readonly expectedSize?: number;
9
+ readonly expectedSha256?: string;
10
+ readonly mimeType?: string;
11
+ }
12
+ export type DownloadOptions = ({
13
+ readonly path: string;
14
+ readonly uri?: never;
15
+ } | {
16
+ readonly uri: string;
17
+ readonly path?: never;
18
+ }) & {
19
+ readonly name?: string;
20
+ readonly mimeType?: string;
21
+ };
22
+ export type TransferResource = Pick<ArtifactRecord, "uri" | "name" | "mimeType" | "size">;
23
+ /** A retained point-in-time view. No request URL or live controller is included. */
24
+ export interface TransferSnapshot {
25
+ readonly transferId: string;
26
+ readonly direction: "upload" | "download";
27
+ readonly status: TransferStatus;
28
+ readonly runId: string | null;
29
+ readonly contextId: string | null;
30
+ readonly projectId: string | null;
31
+ readonly path?: string;
32
+ readonly resource?: TransferResource;
33
+ readonly progress: {
34
+ readonly bytesTransferred: number;
35
+ readonly totalBytes: number | null;
36
+ };
37
+ readonly createdAt: string;
38
+ readonly expiresAt: string | null;
39
+ readonly startedAt: string | null;
40
+ readonly deadlineAt: string | null;
41
+ readonly finishedAt: string | null;
42
+ readonly file?: UploadFileReceipt;
43
+ readonly error: JsonObject | null;
44
+ }
45
+ export type UploadOffer = TransferSnapshot & TransferOffer & {
46
+ readonly direction: "upload";
47
+ readonly status: "pending";
48
+ readonly path: string;
49
+ readonly expiresAt: string;
50
+ readonly maxBytes: number;
51
+ };
52
+ export type DownloadOffer = TransferSnapshot & TransferOffer & {
53
+ readonly direction: "download";
54
+ readonly status: "pending";
55
+ readonly resource: TransferResource;
56
+ readonly expiresAt: string;
57
+ };
58
+ export interface TransferListOptions {
59
+ readonly direction?: "upload" | "download";
60
+ readonly status?: TransferStatus;
61
+ readonly runId?: string;
62
+ readonly limit?: number;
63
+ readonly cursor?: string;
64
+ }
65
+ export interface TransferService {
66
+ createUpload(options: UploadOptions): Promise<UploadOffer>;
67
+ createDownload(options: DownloadOptions): Promise<DownloadOffer>;
68
+ get(transferId: string, options?: {
69
+ readonly waitMs?: number;
70
+ }): Promise<TransferSnapshot>;
71
+ list(options?: TransferListOptions): Promise<{
72
+ readonly transfers: readonly TransferSnapshot[];
73
+ readonly nextCursor: string | null;
74
+ }>;
75
+ cancel(transferId: string): Promise<{
76
+ readonly accepted: boolean;
77
+ readonly transfer: TransferSnapshot;
78
+ }>;
79
+ }
80
+ /** The same fail-closed service is available to built-in and external factories. */
81
+ export declare function unavailableTransfer(assertCurrent: () => void): TransferService;
@@ -0,0 +1,16 @@
1
+ import { AgentError } from "../contracts/errors.js";
2
+ /** The same fail-closed service is available to built-in and external factories. */
3
+ export function unavailableTransfer(assertCurrent) {
4
+ const unavailable = () => {
5
+ assertCurrent();
6
+ throw new AgentError("transfer_unavailable", "The Agent transfer service is not configured.");
7
+ };
8
+ return Object.freeze({
9
+ createUpload: unavailable,
10
+ createDownload: unavailable,
11
+ get: unavailable,
12
+ list: unavailable,
13
+ cancel: unavailable,
14
+ });
15
+ }
16
+ //# sourceMappingURL=transfer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../src/extensions/transfer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAqFpD,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CACjC,aAAyB;IAEzB,MAAM,WAAW,GAAG,GAAU,EAAE;QAC9B,aAAa,EAAE,CAAC;QAChB,MAAM,IAAI,UAAU,CAClB,sBAAsB,EACtB,+CAA+C,CAChD,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,WAAW;QACzB,cAAc,EAAE,WAAW;QAC3B,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,7 @@
1
+ export interface CliResult {
2
+ readonly exitCode: number;
3
+ readonly stdout: string;
4
+ readonly stderr: string;
5
+ }
6
+ export declare function runCli(args: readonly string[], version: string): CliResult;
7
+ export type * from "./extension-api.js";
package/dist/index.js ADDED
@@ -0,0 +1,25 @@
1
+ const help = [
2
+ "NexumAgent — 本地可编程 TypeScript Agent",
3
+ "",
4
+ "用法:nexum-agent [--help | --version]",
5
+ " nexum-agent run --profile development|production",
6
+ "",
7
+ "run 使用所选 profile 的 config.json,连接其配置的 Server。",
8
+ "启动 run 时,Node 必须带 --experimental-vm-modules。",
9
+ "development 使用 ~/.nexum-dev,production 使用 ~/.nexum。",
10
+ ].join("\n") + "\n";
11
+ export function runCli(args, version) {
12
+ if (args.length === 0 ||
13
+ (args.length === 1 && ["--help", "-h"].includes(args[0] ?? ""))) {
14
+ return { exitCode: 0, stdout: help, stderr: "" };
15
+ }
16
+ if (args.length === 1 && ["--version", "-v"].includes(args[0] ?? "")) {
17
+ return { exitCode: 0, stdout: version + "\n", stderr: "" };
18
+ }
19
+ return {
20
+ exitCode: 2,
21
+ stdout: "",
22
+ stderr: "无效命令。使用 --help 查看支持的命令。\n",
23
+ };
24
+ }
25
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,MAAM,IAAI,GACR;IACE,qCAAqC;IACrC,EAAE;IACF,qCAAqC;IACrC,wDAAwD;IACxD,EAAE;IACF,+CAA+C;IAC/C,8CAA8C;IAC9C,qDAAqD;CACtD,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEtB,MAAM,UAAU,MAAM,CAAC,IAAuB,EAAE,OAAe;IAC7D,IACE,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAC/D,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,2BAA2B;KACpC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,79 @@
1
+ import type { Binding, JsonObject } from "../contracts/types.js";
2
+ import { type McpConnectionConfig } from "../adapters/mcp.js";
3
+ import { type McpOAuthProviderFactory } from "../adapters/mcp-oauth.js";
4
+ import { type OpenApiCredentialRequest, type PreparedOpenApi } from "../adapters/openapi.js";
5
+ import { CredentialVault, type CredentialBinding } from "./credentials.js";
6
+ import type { MaintenanceBackend, MaintenanceIntent, PreparedMaintenance, MaintenanceScope, MaintenanceResult, MaintenanceDraft, MaintenanceDraftInput, MaintenanceOAuthScope, MaintenanceOAuthBinding, MaintenanceOAuthComplete, MaintenanceOAuthLaunch } from "./requests.js";
7
+ import { type OAuthProvider, type OAuthSessionService } from "./oauth.js";
8
+ type Kind = "mcp" | "api";
9
+ export interface ConfigurationActivation {
10
+ /** All asynchronous discovery and validation occurs here, after approval. */
11
+ prepare(input: {
12
+ kind: Kind;
13
+ name: string;
14
+ objectId: string;
15
+ revision: string;
16
+ config: JsonObject;
17
+ api?: PreparedOpenApi;
18
+ mcp?: McpConnectionConfig;
19
+ mcpOAuth?: McpOAuthProviderFactory;
20
+ }, scope: MaintenanceScope): Promise<{
21
+ publish(): void;
22
+ dispose(): Promise<void>;
23
+ }>;
24
+ /** Remove only this exact published source and join its real resource cleanup. */
25
+ remove(input: {
26
+ kind: Kind;
27
+ name: string;
28
+ objectId: string;
29
+ revision: string;
30
+ }, scope: MaintenanceScope): Promise<void>;
31
+ }
32
+ export interface McpOAuthConfigurationPort {
33
+ start(config: JsonObject, ref: string, binding: CredentialBinding, authorization: MaintenanceOAuthBinding, scope: MaintenanceOAuthScope): Promise<MaintenanceOAuthLaunch>;
34
+ complete(config: JsonObject, ref: string, binding: CredentialBinding, input: MaintenanceOAuthComplete, scope: MaintenanceOAuthScope): Promise<string>;
35
+ /** Returns only the official SDK's trusted OAuthClientProvider, never public config. */
36
+ provider(config: JsonObject, ref: string, binding: CredentialBinding, scope: MaintenanceScope): Promise<McpOAuthProviderFactory>;
37
+ ready(config: JsonObject, ref: string, binding: CredentialBinding, scope: MaintenanceScope): Promise<boolean>;
38
+ }
39
+ export interface ConfigurationMaintenanceOptions extends Pick<Binding, "agentId" | "profile"> {
40
+ root: string;
41
+ activation: ConfigurationActivation;
42
+ credentials: CredentialVault;
43
+ /** Derive current Run authority from the adapter's trusted invocation, never the old approval request. */
44
+ runtimeScope(request: OpenApiCredentialRequest): MaintenanceScope;
45
+ oauth?: OAuthProvider;
46
+ oauthSessions?: OAuthSessionService;
47
+ mcpOAuth?: McpOAuthConfigurationPort;
48
+ maxSourceBytes?: number;
49
+ maxTotalSourceBytes?: number;
50
+ maxReferences?: number;
51
+ sourceTimeoutMs?: number;
52
+ /** Trusted Core storage admission for private plans and approved fixed configuration. */
53
+ reserve?: (bytes: number) => Promise<{
54
+ release(): void;
55
+ }>;
56
+ }
57
+ /** Portable on case-insensitive filesystems; public config retains the exact logical name. */
58
+ export declare function configurationDirectoryName(namespace: string): string;
59
+ /** Fixed approved snapshots own activation. work files are editable proposals, never approval records. */
60
+ export declare class ConfigurationMaintenanceBackend implements MaintenanceBackend {
61
+ #private;
62
+ readonly options: ConfigurationMaintenanceOptions;
63
+ private constructor();
64
+ static open(options: ConfigurationMaintenanceOptions): Promise<ConfigurationMaintenanceBackend>;
65
+ prepare(intent: MaintenanceIntent, scope: MaintenanceScope): Promise<PreparedMaintenance>;
66
+ readDraft(intent: MaintenanceIntent, candidate: PreparedMaintenance, scope: MaintenanceScope): Promise<MaintenanceDraft>;
67
+ prepareDraft(intent: MaintenanceIntent, candidate: PreparedMaintenance, input: MaintenanceDraftInput, scope: MaintenanceScope): Promise<PreparedMaintenance>;
68
+ startOAuth(intent: MaintenanceIntent, candidate: PreparedMaintenance, binding: MaintenanceOAuthBinding, scope: MaintenanceOAuthScope): Promise<MaintenanceOAuthLaunch>;
69
+ completeOAuth(intent: MaintenanceIntent, candidate: PreparedMaintenance, input: MaintenanceOAuthComplete, scope: MaintenanceOAuthScope): Promise<PreparedMaintenance>;
70
+ verify(intent: MaintenanceIntent, candidate: PreparedMaintenance, scope: MaintenanceScope): Promise<void>;
71
+ apply(intent: MaintenanceIntent, candidate: PreparedMaintenance, scope: MaintenanceScope): Promise<MaintenanceResult>;
72
+ /** Startup reuses only immutable privately approved snapshots; work edits are never auto-approved. */
73
+ restore(scope: MaintenanceScope): Promise<readonly {
74
+ kind: Kind;
75
+ name: string;
76
+ state: "ready" | "unavailable";
77
+ }[]>;
78
+ }
79
+ export {};