@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.
- package/README.md +129 -2
- package/contracts/v2/common.schema.json +262 -0
- package/contracts/v2/fixtures/inputs.json +244 -0
- package/contracts/v2/fixtures/wire.json +6493 -0
- package/contracts/v2/model/agent.close.input.schema.json +14 -0
- package/contracts/v2/model/agent.close.output.schema.json +101 -0
- package/contracts/v2/model/agent.list.input.schema.json +57 -0
- package/contracts/v2/model/agent.list.output.schema.json +220 -0
- package/contracts/v2/model/agent.open.input.schema.json +35 -0
- package/contracts/v2/model/agent.open.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
- package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
- package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
- package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
- package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
- package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
- package/contracts/v2/wire/bodies.schema.json +383 -0
- package/contracts/v2/wire/envelope.schema.json +2280 -0
- package/contracts/v2/wire/events.schema.json +242 -0
- package/contracts/v2/wire/maintenance.schema.json +308 -0
- package/contracts/v2/wire/operations.schema.json +1791 -0
- package/contracts/v2/wire/stream.schema.json +74 -0
- package/contracts/v2/wire/types.schema.json +2616 -0
- package/dist/adapters/mcp-http.d.ts +22 -0
- package/dist/adapters/mcp-http.js +472 -0
- package/dist/adapters/mcp-http.js.map +1 -0
- package/dist/adapters/mcp-oauth.d.ts +29 -0
- package/dist/adapters/mcp-oauth.js +653 -0
- package/dist/adapters/mcp-oauth.js.map +1 -0
- package/dist/adapters/mcp-wire.d.ts +21 -0
- package/dist/adapters/mcp-wire.js +307 -0
- package/dist/adapters/mcp-wire.js.map +1 -0
- package/dist/adapters/mcp.d.ts +56 -0
- package/dist/adapters/mcp.js +1989 -0
- package/dist/adapters/mcp.js.map +1 -0
- package/dist/adapters/openapi-http.d.ts +29 -0
- package/dist/adapters/openapi-http.js +504 -0
- package/dist/adapters/openapi-http.js.map +1 -0
- package/dist/adapters/openapi-request.d.ts +26 -0
- package/dist/adapters/openapi-request.js +597 -0
- package/dist/adapters/openapi-request.js.map +1 -0
- package/dist/adapters/openapi-schema.d.ts +22 -0
- package/dist/adapters/openapi-schema.js +471 -0
- package/dist/adapters/openapi-schema.js.map +1 -0
- package/dist/adapters/openapi-typegen.d.ts +11 -0
- package/dist/adapters/openapi-typegen.js +185 -0
- package/dist/adapters/openapi-typegen.js.map +1 -0
- package/dist/adapters/openapi-types.d.ts +99 -0
- package/dist/adapters/openapi-types.js +2 -0
- package/dist/adapters/openapi-types.js.map +1 -0
- package/dist/adapters/openapi.d.ts +7 -0
- package/dist/adapters/openapi.js +768 -0
- package/dist/adapters/openapi.js.map +1 -0
- package/dist/application/activation.d.ts +28 -0
- package/dist/application/activation.js +289 -0
- package/dist/application/activation.js.map +1 -0
- package/dist/application/attachments.d.ts +24 -0
- package/dist/application/attachments.js +87 -0
- package/dist/application/attachments.js.map +1 -0
- package/dist/application/authority.d.ts +32 -0
- package/dist/application/authority.js +213 -0
- package/dist/application/authority.js.map +1 -0
- package/dist/application/catalog.d.ts +11 -0
- package/dist/application/catalog.js +177 -0
- package/dist/application/catalog.js.map +1 -0
- package/dist/application/config.d.ts +24 -0
- package/dist/application/config.js +140 -0
- package/dist/application/config.js.map +1 -0
- package/dist/application/connection.d.ts +35 -0
- package/dist/application/connection.js +465 -0
- package/dist/application/connection.js.map +1 -0
- package/dist/application/data-plane.d.ts +35 -0
- package/dist/application/data-plane.js +437 -0
- package/dist/application/data-plane.js.map +1 -0
- package/dist/application/diagnostics.d.ts +4 -0
- package/dist/application/diagnostics.js +65 -0
- package/dist/application/diagnostics.js.map +1 -0
- package/dist/application/dispatcher.d.ts +4 -0
- package/dist/application/dispatcher.js +16 -0
- package/dist/application/dispatcher.js.map +1 -0
- package/dist/application/main.d.ts +12 -0
- package/dist/application/main.js +167 -0
- package/dist/application/main.js.map +1 -0
- package/dist/application/maintenance.d.ts +27 -0
- package/dist/application/maintenance.js +244 -0
- package/dist/application/maintenance.js.map +1 -0
- package/dist/application/packages.d.ts +25 -0
- package/dist/application/packages.js +208 -0
- package/dist/application/packages.js.map +1 -0
- package/dist/application/processes.d.ts +49 -0
- package/dist/application/processes.js +180 -0
- package/dist/application/processes.js.map +1 -0
- package/dist/application/run-view.d.ts +17 -0
- package/dist/application/run-view.js +286 -0
- package/dist/application/run-view.js.map +1 -0
- package/dist/application/runtime.d.ts +78 -0
- package/dist/application/runtime.js +1747 -0
- package/dist/application/runtime.js.map +1 -0
- package/dist/application/tasks.d.ts +38 -0
- package/dist/application/tasks.js +23 -0
- package/dist/application/tasks.js.map +1 -0
- package/dist/application/user-state.d.ts +20 -0
- package/dist/application/user-state.js +52 -0
- package/dist/application/user-state.js.map +1 -0
- package/dist/application/work-git.d.ts +14 -0
- package/dist/application/work-git.js +67 -0
- package/dist/application/work-git.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +40 -0
- package/dist/cli.js.map +1 -0
- package/dist/contracts/caller.d.ts +51 -0
- package/dist/contracts/caller.js +95 -0
- package/dist/contracts/caller.js.map +1 -0
- package/dist/contracts/error-data.d.ts +6 -0
- package/dist/contracts/error-data.js +51 -0
- package/dist/contracts/error-data.js.map +1 -0
- package/dist/contracts/errors.d.ts +10 -0
- package/dist/contracts/errors.js +28 -0
- package/dist/contracts/errors.js.map +1 -0
- package/dist/contracts/json.d.ts +9 -0
- package/dist/contracts/json.js +104 -0
- package/dist/contracts/json.js.map +1 -0
- package/dist/contracts/types.d.ts +122 -0
- package/dist/contracts/types.js +19 -0
- package/dist/contracts/types.js.map +1 -0
- package/dist/contracts/validation.d.ts +4 -0
- package/dist/contracts/validation.js +157 -0
- package/dist/contracts/validation.js.map +1 -0
- package/dist/contracts/wire-validation.d.ts +9 -0
- package/dist/contracts/wire-validation.js +399 -0
- package/dist/contracts/wire-validation.js.map +1 -0
- package/dist/contracts/wire.d.ts +1083 -0
- package/dist/contracts/wire.js +62 -0
- package/dist/contracts/wire.js.map +1 -0
- package/dist/extension-api.d.ts +12 -0
- package/dist/extension-api.js +2 -0
- package/dist/extension-api.js.map +1 -0
- package/dist/extensions/api.d.ts +72 -0
- package/dist/extensions/api.js +2 -0
- package/dist/extensions/api.js.map +1 -0
- package/dist/extensions/host-requests.d.ts +23 -0
- package/dist/extensions/host-requests.js +60 -0
- package/dist/extensions/host-requests.js.map +1 -0
- package/dist/extensions/materials.d.ts +37 -0
- package/dist/extensions/materials.js +691 -0
- package/dist/extensions/materials.js.map +1 -0
- package/dist/extensions/package-loader.d.ts +28 -0
- package/dist/extensions/package-loader.js +177 -0
- package/dist/extensions/package-loader.js.map +1 -0
- package/dist/extensions/packages.d.ts +73 -0
- package/dist/extensions/packages.js +441 -0
- package/dist/extensions/packages.js.map +1 -0
- package/dist/extensions/registry.d.ts +92 -0
- package/dist/extensions/registry.js +1540 -0
- package/dist/extensions/registry.js.map +1 -0
- package/dist/extensions/resources.d.ts +105 -0
- package/dist/extensions/resources.js +595 -0
- package/dist/extensions/resources.js.map +1 -0
- package/dist/extensions/state.d.ts +25 -0
- package/dist/extensions/state.js +10 -0
- package/dist/extensions/state.js.map +1 -0
- package/dist/extensions/transfer.d.ts +81 -0
- package/dist/extensions/transfer.js +16 -0
- package/dist/extensions/transfer.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/maintenance/configuration.d.ts +79 -0
- package/dist/maintenance/configuration.js +1503 -0
- package/dist/maintenance/configuration.js.map +1 -0
- package/dist/maintenance/credentials.d.ts +23 -0
- package/dist/maintenance/credentials.js +177 -0
- package/dist/maintenance/credentials.js.map +1 -0
- package/dist/maintenance/files.d.ts +2 -0
- package/dist/maintenance/files.js +40 -0
- package/dist/maintenance/files.js.map +1 -0
- package/dist/maintenance/npm.d.ts +71 -0
- package/dist/maintenance/npm.js +1013 -0
- package/dist/maintenance/npm.js.map +1 -0
- package/dist/maintenance/oauth.d.ts +45 -0
- package/dist/maintenance/oauth.js +686 -0
- package/dist/maintenance/oauth.js.map +1 -0
- package/dist/maintenance/requests.d.ts +347 -0
- package/dist/maintenance/requests.js +959 -0
- package/dist/maintenance/requests.js.map +1 -0
- package/dist/maintenance/work-git.d.ts +29 -0
- package/dist/maintenance/work-git.js +776 -0
- package/dist/maintenance/work-git.js.map +1 -0
- package/dist/process/backend.d.ts +54 -0
- package/dist/process/backend.js +39 -0
- package/dist/process/backend.js.map +1 -0
- package/dist/process/environment-windows.d.ts +15 -0
- package/dist/process/environment-windows.js +151 -0
- package/dist/process/environment-windows.js.map +1 -0
- package/dist/process/environment.d.ts +28 -0
- package/dist/process/environment.js +410 -0
- package/dist/process/environment.js.map +1 -0
- package/dist/process/launch.d.ts +31 -0
- package/dist/process/launch.js +281 -0
- package/dist/process/launch.js.map +1 -0
- package/dist/process/managed.d.ts +36 -0
- package/dist/process/managed.js +459 -0
- package/dist/process/managed.js.map +1 -0
- package/dist/process/output-log.d.ts +50 -0
- package/dist/process/output-log.js +552 -0
- package/dist/process/output-log.js.map +1 -0
- package/dist/process/pipes.d.ts +16 -0
- package/dist/process/pipes.js +588 -0
- package/dist/process/pipes.js.map +1 -0
- package/dist/process/pty.d.ts +22 -0
- package/dist/process/pty.js +512 -0
- package/dist/process/pty.js.map +1 -0
- package/dist/process/windows-conout-worker.d.ts +1 -0
- package/dist/process/windows-conout-worker.js +90 -0
- package/dist/process/windows-conout-worker.js.map +1 -0
- package/dist/process/windows-conout.d.ts +46 -0
- package/dist/process/windows-conout.js +140 -0
- package/dist/process/windows-conout.js.map +1 -0
- package/dist/process/windows-helper.d.ts +43 -0
- package/dist/process/windows-helper.js +255 -0
- package/dist/process/windows-helper.js.map +1 -0
- package/dist/process/windows-job.d.ts +39 -0
- package/dist/process/windows-job.js +224 -0
- package/dist/process/windows-job.js.map +1 -0
- package/dist/process/windows-pipes.d.ts +16 -0
- package/dist/process/windows-pipes.js +475 -0
- package/dist/process/windows-pipes.js.map +1 -0
- package/dist/results/artifacts.d.ts +118 -0
- package/dist/results/artifacts.js +873 -0
- package/dist/results/artifacts.js.map +1 -0
- package/dist/results/encoder.d.ts +57 -0
- package/dist/results/encoder.js +1179 -0
- package/dist/results/encoder.js.map +1 -0
- package/dist/results/mcp.d.ts +95 -0
- package/dist/results/mcp.js +656 -0
- package/dist/results/mcp.js.map +1 -0
- package/dist/results/media.d.ts +19 -0
- package/dist/results/media.js +301 -0
- package/dist/results/media.js.map +1 -0
- package/dist/results/normalize.d.ts +29 -0
- package/dist/results/normalize.js +464 -0
- package/dist/results/normalize.js.map +1 -0
- package/dist/runtime/control-scripts.d.ts +23 -0
- package/dist/runtime/control-scripts.js +242 -0
- package/dist/runtime/control-scripts.js.map +1 -0
- package/dist/runtime/engine.d.ts +177 -0
- package/dist/runtime/engine.js +1159 -0
- package/dist/runtime/engine.js.map +1 -0
- package/dist/runtime/globals.d.ts +1 -0
- package/dist/runtime/globals.js +31 -0
- package/dist/runtime/globals.js.map +1 -0
- package/dist/runtime/material-retention.d.ts +34 -0
- package/dist/runtime/material-retention.js +671 -0
- package/dist/runtime/material-retention.js.map +1 -0
- package/dist/runtime/modules.d.ts +50 -0
- package/dist/runtime/modules.js +320 -0
- package/dist/runtime/modules.js.map +1 -0
- package/dist/runtime/names.d.ts +2 -0
- package/dist/runtime/names.js +22 -0
- package/dist/runtime/names.js.map +1 -0
- package/dist/runtime/operations.d.ts +20 -0
- package/dist/runtime/operations.js +137 -0
- package/dist/runtime/operations.js.map +1 -0
- package/dist/runtime/paths.d.ts +3 -0
- package/dist/runtime/paths.js +38 -0
- package/dist/runtime/paths.js.map +1 -0
- package/dist/runtime/promises.d.ts +9 -0
- package/dist/runtime/promises.js +78 -0
- package/dist/runtime/promises.js.map +1 -0
- package/dist/runtime/retention.d.ts +88 -0
- package/dist/runtime/retention.js +735 -0
- package/dist/runtime/retention.js.map +1 -0
- package/dist/runtime/run-log.d.ts +30 -0
- package/dist/runtime/run-log.js +207 -0
- package/dist/runtime/run-log.js.map +1 -0
- package/dist/runtime/scripts.d.ts +84 -0
- package/dist/runtime/scripts.js +387 -0
- package/dist/runtime/scripts.js.map +1 -0
- package/dist/runtime/tasks.d.ts +54 -0
- package/dist/runtime/tasks.js +290 -0
- package/dist/runtime/tasks.js.map +1 -0
- package/dist/sdk/maintenance.d.ts +3 -0
- package/dist/sdk/maintenance.js +80 -0
- package/dist/sdk/maintenance.js.map +1 -0
- package/dist/sdk/output-extension.d.ts +3 -0
- package/dist/sdk/output-extension.js +44 -0
- package/dist/sdk/output-extension.js.map +1 -0
- package/dist/sdk/output.d.ts +52 -0
- package/dist/sdk/output.js +350 -0
- package/dist/sdk/output.js.map +1 -0
- package/dist/sdk/runtime.d.ts +3 -0
- package/dist/sdk/runtime.js +26 -0
- package/dist/sdk/runtime.js.map +1 -0
- package/dist/sdk/sh.d.ts +3 -0
- package/dist/sdk/sh.js +384 -0
- package/dist/sdk/sh.js.map +1 -0
- package/dist/sdk/state.d.ts +2 -0
- package/dist/sdk/state.js +69 -0
- package/dist/sdk/state.js.map +1 -0
- package/dist/sdk/transfer.d.ts +3 -0
- package/dist/sdk/transfer.js +141 -0
- package/dist/sdk/transfer.js.map +1 -0
- package/dist/services/extensions.d.ts +19 -0
- package/dist/services/extensions.js +183 -0
- package/dist/services/extensions.js.map +1 -0
- package/dist/services/state.d.ts +37 -0
- package/dist/services/state.js +125 -0
- package/dist/services/state.js.map +1 -0
- package/dist/services/transfer.d.ts +86 -0
- package/dist/services/transfer.js +948 -0
- package/dist/services/transfer.js.map +1 -0
- package/dist/storage/schema.d.ts +8 -0
- package/dist/storage/schema.js +241 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/sqlite.d.ts +241 -0
- package/dist/storage/sqlite.js +1855 -0
- package/dist/storage/sqlite.js.map +1 -0
- package/dist/storage/transfers.d.ts +90 -0
- package/dist/storage/transfers.js +2 -0
- package/dist/storage/transfers.js.map +1 -0
- package/dist/transfer/io.d.ts +74 -0
- package/dist/transfer/io.js +425 -0
- package/dist/transfer/io.js.map +1 -0
- package/dist/transfer/offers.d.ts +72 -0
- package/dist/transfer/offers.js +380 -0
- package/dist/transfer/offers.js.map +1 -0
- package/dist/transfer/stream-slots.d.ts +12 -0
- package/dist/transfer/stream-slots.js +28 -0
- package/dist/transfer/stream-slots.js.map +1 -0
- package/dist/work/catalog.d.ts +43 -0
- package/dist/work/catalog.js +198 -0
- package/dist/work/catalog.js.map +1 -0
- package/dist/work/discovery.d.ts +70 -0
- package/dist/work/discovery.js +465 -0
- package/dist/work/discovery.js.map +1 -0
- package/dist/work/service.d.ts +83 -0
- package/dist/work/service.js +703 -0
- package/dist/work/service.js.map +1 -0
- package/package.json +66 -4
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { constants, closeSync, fstatSync, lstatSync, openSync, readSync, realpathSync, } from "node:fs";
|
|
3
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
4
|
+
import { canonicalJson, isPlainRecord } from "../contracts/json.js";
|
|
5
|
+
import { privateMaintenanceRead, privateMaintenanceWrite, } from "../maintenance/credentials.js";
|
|
6
|
+
import { maintenanceText } from "../maintenance/files.js";
|
|
7
|
+
const fileLimit = 32 * 1024 * 1024;
|
|
8
|
+
const recordLimit = 64 * 1024 * 1024;
|
|
9
|
+
const recordPath = ["packages.json"];
|
|
10
|
+
const packageName = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
|
|
11
|
+
const exactVersion = /^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/;
|
|
12
|
+
function name(value) {
|
|
13
|
+
return (typeof value === "string" &&
|
|
14
|
+
value.length <= 214 &&
|
|
15
|
+
packageName.test(value) &&
|
|
16
|
+
!value.split("/").some((part) => part === "." || part === ".."));
|
|
17
|
+
}
|
|
18
|
+
function version(value) {
|
|
19
|
+
return (typeof value === "string" && value.length <= 256 && exactVersion.test(value));
|
|
20
|
+
}
|
|
21
|
+
function document(value) {
|
|
22
|
+
requireCondition(typeof value === "string" && Buffer.byteLength(value) <= fileLimit, "package_approval_invalid", "Approved npm evidence needs bounded manifest and lock text.");
|
|
23
|
+
let parsed;
|
|
24
|
+
try {
|
|
25
|
+
parsed = JSON.parse(value);
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
/* Report no source text or parser details. */
|
|
29
|
+
}
|
|
30
|
+
requireCondition(isPlainRecord(parsed), "package_approval_invalid", "Approved npm evidence must contain JSON objects.");
|
|
31
|
+
return parsed;
|
|
32
|
+
}
|
|
33
|
+
function declared(manifest, target) {
|
|
34
|
+
return ["dependencies", "devDependencies", "optionalDependencies"].some((group) => isPlainRecord(manifest[group]) &&
|
|
35
|
+
typeof manifest[group][target] === "string");
|
|
36
|
+
}
|
|
37
|
+
/** A synchronous ModulePolicy callback must reject disk drift before returning any approval. */
|
|
38
|
+
function matches(filename, expected) {
|
|
39
|
+
let fd;
|
|
40
|
+
try {
|
|
41
|
+
fd = openSync(filename, constants.O_RDONLY |
|
|
42
|
+
(constants.O_NOFOLLOW ?? 0) |
|
|
43
|
+
(constants.O_NONBLOCK ?? 0));
|
|
44
|
+
const before = fstatSync(fd), bytes = Buffer.from(expected);
|
|
45
|
+
if (!before.isFile() ||
|
|
46
|
+
before.size !== bytes.length ||
|
|
47
|
+
bytes.length > fileLimit)
|
|
48
|
+
return false;
|
|
49
|
+
const chunk = Buffer.allocUnsafe(65536);
|
|
50
|
+
let offset = 0;
|
|
51
|
+
while (offset < bytes.length) {
|
|
52
|
+
const count = readSync(fd, chunk, 0, Math.min(chunk.length, bytes.length - offset), null);
|
|
53
|
+
if (!count ||
|
|
54
|
+
!chunk.subarray(0, count).equals(bytes.subarray(offset, offset + count)))
|
|
55
|
+
return false;
|
|
56
|
+
offset += count;
|
|
57
|
+
}
|
|
58
|
+
if (readSync(fd, chunk, 0, 1, null) !== 0)
|
|
59
|
+
return false;
|
|
60
|
+
const after = fstatSync(fd), current = lstatSync(filename);
|
|
61
|
+
return (current.isFile() &&
|
|
62
|
+
before.dev === after.dev &&
|
|
63
|
+
before.ino === after.ino &&
|
|
64
|
+
before.size === after.size &&
|
|
65
|
+
before.mtimeMs === after.mtimeMs &&
|
|
66
|
+
before.ctimeMs === after.ctimeMs &&
|
|
67
|
+
current.dev === after.dev &&
|
|
68
|
+
current.ino === after.ino);
|
|
69
|
+
}
|
|
70
|
+
catch {
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
finally {
|
|
74
|
+
if (fd !== undefined)
|
|
75
|
+
closeSync(fd);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/** Private explicit package approvals; the work manifest and installed packages never grant approval. */
|
|
79
|
+
export class ApprovedPackageCatalog {
|
|
80
|
+
root;
|
|
81
|
+
binding;
|
|
82
|
+
reserve;
|
|
83
|
+
#record = null;
|
|
84
|
+
#accepting = false;
|
|
85
|
+
constructor(root, binding, reserve) {
|
|
86
|
+
this.root = root;
|
|
87
|
+
this.binding = binding;
|
|
88
|
+
this.reserve = reserve;
|
|
89
|
+
}
|
|
90
|
+
static async open(root, binding, options = {}) {
|
|
91
|
+
const actual = realpathSync.native(root);
|
|
92
|
+
requireCondition(actual === root &&
|
|
93
|
+
typeof binding.agentId === "string" &&
|
|
94
|
+
binding.agentId.length > 0 &&
|
|
95
|
+
Buffer.byteLength(binding.agentId) <= 256 &&
|
|
96
|
+
!/[\0\r\n]/.test(binding.agentId) &&
|
|
97
|
+
["development", "production"].includes(binding.profile), "package_approval_invalid", "The package catalog must use its actual Agent/profile root and binding.");
|
|
98
|
+
const catalog = new ApprovedPackageCatalog(actual, Object.freeze({ ...binding }), options.reserve);
|
|
99
|
+
const saved = await privateMaintenanceRead(actual, recordPath, recordLimit);
|
|
100
|
+
if (saved !== null) {
|
|
101
|
+
requireCondition(saved.version === 1 &&
|
|
102
|
+
saved.root === actual &&
|
|
103
|
+
saved.agentId === binding.agentId &&
|
|
104
|
+
saved.profile === binding.profile &&
|
|
105
|
+
Object.keys(saved).every((key) => [
|
|
106
|
+
"version",
|
|
107
|
+
"root",
|
|
108
|
+
"agentId",
|
|
109
|
+
"profile",
|
|
110
|
+
"approved",
|
|
111
|
+
"manifest",
|
|
112
|
+
"lock",
|
|
113
|
+
].includes(key)) &&
|
|
114
|
+
isPlainRecord(saved.approved) &&
|
|
115
|
+
Object.entries(saved.approved).every(([key, value]) => name(key) && version(value)), "package_approval_invalid", "Saved package approvals do not belong to this actual Agent/profile or contain invalid identities.");
|
|
116
|
+
document(saved.manifest);
|
|
117
|
+
document(saved.lock);
|
|
118
|
+
catalog.#record = saved;
|
|
119
|
+
}
|
|
120
|
+
return catalog;
|
|
121
|
+
}
|
|
122
|
+
#work() {
|
|
123
|
+
const work = path.join(this.root, "work");
|
|
124
|
+
try {
|
|
125
|
+
if (realpathSync.native(this.root) === this.root &&
|
|
126
|
+
lstatSync(work).isDirectory() &&
|
|
127
|
+
realpathSync.native(work) === work)
|
|
128
|
+
return work;
|
|
129
|
+
}
|
|
130
|
+
catch {
|
|
131
|
+
/* Do not expose private filesystem paths through system errors. */
|
|
132
|
+
}
|
|
133
|
+
throw new AgentError("package_approval_changed", "The npm work directory cannot redirect away from this profile.");
|
|
134
|
+
}
|
|
135
|
+
approvedPackages() {
|
|
136
|
+
if (!this.#record)
|
|
137
|
+
return new Map();
|
|
138
|
+
try {
|
|
139
|
+
const work = this.#work();
|
|
140
|
+
if (matches(path.join(work, "package.json"), this.#record.manifest) &&
|
|
141
|
+
matches(path.join(work, "package-lock.json"), this.#record.lock))
|
|
142
|
+
return new Map(Object.entries(this.#record.approved));
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
/* An unreadable or redirected work tree grants no npm access. */
|
|
146
|
+
}
|
|
147
|
+
return new Map();
|
|
148
|
+
}
|
|
149
|
+
async accept(snapshot) {
|
|
150
|
+
requireCondition(!this.#accepting, "package_approval_busy", "A verified package approval is already being saved.");
|
|
151
|
+
const fixed = JSON.parse(canonicalJson(snapshot, recordLimit));
|
|
152
|
+
requireCondition(isPlainRecord(fixed) &&
|
|
153
|
+
Object.keys(fixed).every((key) => ["target", "manifest", "lock"].includes(key)) &&
|
|
154
|
+
isPlainRecord(fixed.target) &&
|
|
155
|
+
Object.keys(fixed.target).every((key) => ["name", "action", "version"].includes(key)) &&
|
|
156
|
+
name(fixed.target.name) &&
|
|
157
|
+
["install", "update", "remove"].includes(fixed.target.action) &&
|
|
158
|
+
(fixed.target.action === "remove"
|
|
159
|
+
? fixed.target.version === null
|
|
160
|
+
: version(fixed.target.version)), "package_approval_invalid", "A package approval requires one explicit exact npm target.");
|
|
161
|
+
const manifest = document(fixed.manifest), lock = document(fixed.lock);
|
|
162
|
+
const locked = isPlainRecord(lock.packages)
|
|
163
|
+
? lock.packages[`node_modules/${fixed.target.name}`]
|
|
164
|
+
: undefined;
|
|
165
|
+
requireCondition(fixed.target.action === "remove"
|
|
166
|
+
? !declared(manifest, fixed.target.name)
|
|
167
|
+
: declared(manifest, fixed.target.name) &&
|
|
168
|
+
isPlainRecord(locked) &&
|
|
169
|
+
locked.version === fixed.target.version, "package_approval_invalid", "The verified manifest and lock must describe the explicit package target.");
|
|
170
|
+
this.#accepting = true;
|
|
171
|
+
try {
|
|
172
|
+
const work = this.#work();
|
|
173
|
+
let actual;
|
|
174
|
+
try {
|
|
175
|
+
actual = await Promise.all([
|
|
176
|
+
maintenanceText(path.join(work, "package.json"), fileLimit),
|
|
177
|
+
maintenanceText(path.join(work, "package-lock.json"), fileLimit),
|
|
178
|
+
]);
|
|
179
|
+
}
|
|
180
|
+
catch {
|
|
181
|
+
throw new AgentError("package_approval_changed", "The actual npm files could not be safely verified.");
|
|
182
|
+
}
|
|
183
|
+
requireCondition(this.#work() === work &&
|
|
184
|
+
actual[0] === fixed.manifest &&
|
|
185
|
+
actual[1] === fixed.lock, "package_approval_changed", "The npm files changed after the approved installation was verified.");
|
|
186
|
+
const approved = new Map(Object.entries(this.#record?.approved ?? {}));
|
|
187
|
+
if (fixed.target.action === "remove")
|
|
188
|
+
approved.delete(fixed.target.name);
|
|
189
|
+
else
|
|
190
|
+
approved.set(fixed.target.name, fixed.target.version);
|
|
191
|
+
const record = {
|
|
192
|
+
version: 1,
|
|
193
|
+
agentId: this.binding.agentId,
|
|
194
|
+
profile: this.binding.profile,
|
|
195
|
+
root: this.root,
|
|
196
|
+
approved: Object.fromEntries(approved),
|
|
197
|
+
manifest: fixed.manifest,
|
|
198
|
+
lock: fixed.lock,
|
|
199
|
+
};
|
|
200
|
+
await privateMaintenanceWrite(this.root, recordPath, record, false, this.reserve);
|
|
201
|
+
this.#record = record;
|
|
202
|
+
}
|
|
203
|
+
finally {
|
|
204
|
+
this.#accepting = false;
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
//# sourceMappingURL=packages.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../src/application/packages.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { type Caller } from "../contracts/caller.js";
|
|
2
|
+
import type { JsonObject, ResourceRecord } from "../contracts/types.js";
|
|
3
|
+
import { ResourceManager } from "../extensions/resources.js";
|
|
4
|
+
import type { ResourceHistoryRecord } from "../storage/sqlite.js";
|
|
5
|
+
export interface ProcessSnapshot extends JsonObject {
|
|
6
|
+
readonly processId: string;
|
|
7
|
+
readonly originRunId: string | null;
|
|
8
|
+
readonly contextId: string | null;
|
|
9
|
+
readonly projectId: string | null;
|
|
10
|
+
readonly status: string;
|
|
11
|
+
readonly lifetime: ResourceRecord["lifetime"];
|
|
12
|
+
readonly createdAt: number;
|
|
13
|
+
readonly closedAt: number | null;
|
|
14
|
+
readonly handedOffAt: number | null;
|
|
15
|
+
readonly controlAvailable: boolean;
|
|
16
|
+
readonly details: JsonObject;
|
|
17
|
+
}
|
|
18
|
+
export interface ProcessListInput {
|
|
19
|
+
readonly projectId?: string;
|
|
20
|
+
readonly limit?: number;
|
|
21
|
+
readonly cursor?: string;
|
|
22
|
+
}
|
|
23
|
+
export interface ProcessPage {
|
|
24
|
+
readonly items: readonly ProcessSnapshot[];
|
|
25
|
+
readonly nextCursor: string | null;
|
|
26
|
+
readonly observedAt: number;
|
|
27
|
+
}
|
|
28
|
+
export interface ApplicationProcessOptions {
|
|
29
|
+
/** null verifies the current Agent authority even for an empty page. */
|
|
30
|
+
authorize(caller: Caller, record: ResourceHistoryRecord | null, action: "read" | "stop"): void;
|
|
31
|
+
readonly now?: () => number;
|
|
32
|
+
}
|
|
33
|
+
/** Owner Console projection of existing sh resources; it owns no process controllers or execution state. */
|
|
34
|
+
export declare class ApplicationProcesses {
|
|
35
|
+
#private;
|
|
36
|
+
readonly resources: ResourceManager;
|
|
37
|
+
readonly options: ApplicationProcessOptions;
|
|
38
|
+
constructor(resources: ResourceManager, options: ApplicationProcessOptions);
|
|
39
|
+
get(caller: Caller, input: {
|
|
40
|
+
readonly processId: string;
|
|
41
|
+
}): ProcessSnapshot;
|
|
42
|
+
stop(caller: Caller, input: {
|
|
43
|
+
readonly processId: string;
|
|
44
|
+
}): Promise<{
|
|
45
|
+
accepted: boolean;
|
|
46
|
+
item: ProcessSnapshot;
|
|
47
|
+
}>;
|
|
48
|
+
list(caller: Caller, input?: ProcessListInput): ProcessPage;
|
|
49
|
+
}
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { authorizeCall, callerKey, fixedCaller, } from "../contracts/caller.js";
|
|
2
|
+
import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
|
|
3
|
+
import { canonicalJson, digest, isPlainRecord } from "../contracts/json.js";
|
|
4
|
+
import { resourceReadDenied, } from "../extensions/resources.js";
|
|
5
|
+
import { CONTROL_OWNER, CONTROL_VERSION } from "../runtime/control-scripts.js";
|
|
6
|
+
const detailsKeys = new Set([
|
|
7
|
+
"state",
|
|
8
|
+
"pid",
|
|
9
|
+
"startedAt",
|
|
10
|
+
"rootExited",
|
|
11
|
+
"exitCode",
|
|
12
|
+
"exitSignal",
|
|
13
|
+
"outputComplete",
|
|
14
|
+
"treeStopped",
|
|
15
|
+
"closed",
|
|
16
|
+
"stopRequested",
|
|
17
|
+
"forceRequested",
|
|
18
|
+
"tty",
|
|
19
|
+
"platform",
|
|
20
|
+
"executable",
|
|
21
|
+
"shell",
|
|
22
|
+
"cwd",
|
|
23
|
+
"stopReason",
|
|
24
|
+
"preparationUnconfirmed",
|
|
25
|
+
"failure",
|
|
26
|
+
]);
|
|
27
|
+
const copy = (value, maximum = 32768) => JSON.parse(canonicalJson(value, maximum));
|
|
28
|
+
/** Owner Console projection of existing sh resources; it owns no process controllers or execution state. */
|
|
29
|
+
export class ApplicationProcesses {
|
|
30
|
+
resources;
|
|
31
|
+
options;
|
|
32
|
+
constructor(resources, options) {
|
|
33
|
+
this.resources = resources;
|
|
34
|
+
this.options = options;
|
|
35
|
+
}
|
|
36
|
+
#caller(caller) {
|
|
37
|
+
caller = fixedCaller(caller);
|
|
38
|
+
requireCondition(caller.source === "owner_session", "forbidden", "Process inspection requires the current owner Console session.");
|
|
39
|
+
authorizeCall(() => this.options.authorize(caller, null, "read"));
|
|
40
|
+
return caller;
|
|
41
|
+
}
|
|
42
|
+
#belongs(record) {
|
|
43
|
+
const source = record.source;
|
|
44
|
+
return (record.bootId === this.resources.store.bootId &&
|
|
45
|
+
record.kind === "sh.process" &&
|
|
46
|
+
source.type === "platform" &&
|
|
47
|
+
source.owner === CONTROL_OWNER &&
|
|
48
|
+
source.namespace === "sh" &&
|
|
49
|
+
source.version === CONTROL_VERSION &&
|
|
50
|
+
source.revision === CONTROL_VERSION &&
|
|
51
|
+
record.originRunId !== null);
|
|
52
|
+
}
|
|
53
|
+
#source(record) {
|
|
54
|
+
requireCondition(this.#belongs(record), "process_unavailable", "Only this boot's actual built-in sh process resources are available.");
|
|
55
|
+
}
|
|
56
|
+
#authorize(caller, record, action) {
|
|
57
|
+
this.#source(record);
|
|
58
|
+
authorizeCall(() => this.options.authorize(caller, record, action));
|
|
59
|
+
}
|
|
60
|
+
#project(record) {
|
|
61
|
+
if (record.originRunId === null)
|
|
62
|
+
return null;
|
|
63
|
+
try {
|
|
64
|
+
return this.resources.store.getRun(record.originRunId).projectId;
|
|
65
|
+
}
|
|
66
|
+
catch (cause) {
|
|
67
|
+
if (isAgentError(cause) && cause.code === "run_not_found")
|
|
68
|
+
return null;
|
|
69
|
+
throw cause;
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
#snapshot(snapshot) {
|
|
73
|
+
const row = this.resources.store.resourceHistory(snapshot.id);
|
|
74
|
+
this.#source(row);
|
|
75
|
+
return copy({
|
|
76
|
+
processId: snapshot.id,
|
|
77
|
+
originRunId: snapshot.originRunId,
|
|
78
|
+
contextId: snapshot.contextId,
|
|
79
|
+
projectId: this.#project(row),
|
|
80
|
+
status: snapshot.status,
|
|
81
|
+
lifetime: snapshot.lifetime,
|
|
82
|
+
createdAt: snapshot.createdAt,
|
|
83
|
+
closedAt: snapshot.closedAt,
|
|
84
|
+
handedOffAt: snapshot.handedOffAt,
|
|
85
|
+
controlAvailable: snapshot.controlAvailable,
|
|
86
|
+
details: Object.fromEntries(Object.entries(snapshot.details).filter(([key]) => detailsKeys.has(key))),
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
#id(input) {
|
|
90
|
+
const fixed = copy(input, 4096);
|
|
91
|
+
requireCondition(isPlainRecord(fixed) &&
|
|
92
|
+
Object.keys(fixed).length === 1 &&
|
|
93
|
+
typeof fixed.processId === "string" &&
|
|
94
|
+
/^res_[0-9a-f]{32}$/.test(fixed.processId), "invalid_process_id", "Use an actual managed process resource identity, never an OS PID.");
|
|
95
|
+
return fixed.processId;
|
|
96
|
+
}
|
|
97
|
+
get(caller, input) {
|
|
98
|
+
caller = this.#caller(caller);
|
|
99
|
+
return this.#snapshot(this.resources.inspectResource(this.#id(input), (record) => this.#authorize(caller, record, "read")));
|
|
100
|
+
}
|
|
101
|
+
async stop(caller, input) {
|
|
102
|
+
caller = this.#caller(caller);
|
|
103
|
+
const result = await this.resources.disposeResource(this.#id(input), (record) => this.#authorize(caller, record, "stop"), new AgentError("process_stopped", "The current owner requested managed process shutdown."));
|
|
104
|
+
return { accepted: result.accepted, item: this.#snapshot(result.snapshot) };
|
|
105
|
+
}
|
|
106
|
+
list(caller, input = {}) {
|
|
107
|
+
caller = this.#caller(caller);
|
|
108
|
+
const query = copy(input, 8192);
|
|
109
|
+
requireCondition(isPlainRecord(query) &&
|
|
110
|
+
Object.keys(query).every((key) => ["projectId", "limit", "cursor"].includes(key)), "invalid_process_query", "Use only project and pagination fields.");
|
|
111
|
+
const limit = query.limit ?? 20;
|
|
112
|
+
requireCondition(typeof limit === "number" &&
|
|
113
|
+
Number.isSafeInteger(limit) &&
|
|
114
|
+
limit >= 1 &&
|
|
115
|
+
limit <= 100, "invalid_limit", "A process page contains between 1 and 100 items.");
|
|
116
|
+
requireCondition(query.projectId === undefined ||
|
|
117
|
+
(typeof query.projectId === "string" &&
|
|
118
|
+
query.projectId.length > 0 &&
|
|
119
|
+
Buffer.byteLength(query.projectId) <= 256 &&
|
|
120
|
+
!/[\0\r\n]/.test(query.projectId)), "invalid_process_query", "Use one bounded Project identity.");
|
|
121
|
+
requireCondition(query.cursor === undefined ||
|
|
122
|
+
(typeof query.cursor === "string" &&
|
|
123
|
+
query.cursor.length > 0 &&
|
|
124
|
+
query.cursor.length <= 4096), "invalid_cursor", "The process cursor is invalid.");
|
|
125
|
+
const scope = digest({
|
|
126
|
+
caller: callerKey(caller),
|
|
127
|
+
sessionRef: caller.sessionRef ?? null,
|
|
128
|
+
bootId: this.resources.store.bootId,
|
|
129
|
+
projectId: query.projectId ?? null,
|
|
130
|
+
});
|
|
131
|
+
const filter = {
|
|
132
|
+
owner: CONTROL_OWNER,
|
|
133
|
+
namespace: "sh",
|
|
134
|
+
type: "platform",
|
|
135
|
+
kind: "sh.process",
|
|
136
|
+
};
|
|
137
|
+
const items = [];
|
|
138
|
+
let cursor = query.cursor, scanned = 0, bytes = 0;
|
|
139
|
+
while (scanned < 1000) {
|
|
140
|
+
authorizeCall(() => this.options.authorize(caller, null, "read"));
|
|
141
|
+
const page = this.resources.store.scanResourceHistory(filter, scope, Math.min(100, 1000 - scanned), cursor);
|
|
142
|
+
for (let n = 0; n < page.items.length; n++) {
|
|
143
|
+
const candidate = page.items[n], previous = cursor;
|
|
144
|
+
cursor = candidate.cursor;
|
|
145
|
+
scanned++;
|
|
146
|
+
if (!this.#belongs(candidate.record))
|
|
147
|
+
continue;
|
|
148
|
+
if (query.projectId !== undefined &&
|
|
149
|
+
this.#project(candidate.record) !== query.projectId)
|
|
150
|
+
continue;
|
|
151
|
+
let snapshot;
|
|
152
|
+
try {
|
|
153
|
+
snapshot = this.resources.inspectResource(candidate.record.resourceId, (record) => this.#authorize(caller, record, "read"));
|
|
154
|
+
}
|
|
155
|
+
catch (cause) {
|
|
156
|
+
if (resourceReadDenied(cause))
|
|
157
|
+
continue;
|
|
158
|
+
throw cause;
|
|
159
|
+
}
|
|
160
|
+
const item = this.#snapshot(snapshot), size = Buffer.byteLength(canonicalJson(item));
|
|
161
|
+
if (bytes + size > 60 * 1024)
|
|
162
|
+
return this.#page(caller, items, previous ?? null);
|
|
163
|
+
bytes += size;
|
|
164
|
+
items.push(item);
|
|
165
|
+
if (items.length === limit)
|
|
166
|
+
return this.#page(caller, items, n < page.items.length - 1 || page.more ? cursor : null);
|
|
167
|
+
}
|
|
168
|
+
if (!page.more)
|
|
169
|
+
return this.#page(caller, items, null);
|
|
170
|
+
}
|
|
171
|
+
return this.#page(caller, items, cursor ?? null);
|
|
172
|
+
}
|
|
173
|
+
#page(caller, items, nextCursor) {
|
|
174
|
+
authorizeCall(() => this.options.authorize(caller, null, "read"));
|
|
175
|
+
const observedAt = (this.options.now ?? Date.now)();
|
|
176
|
+
requireCondition(Number.isSafeInteger(observedAt) && observedAt >= 0, "invalid_process_clock", "The observation time must be a valid timestamp.");
|
|
177
|
+
return { items, nextCursor, observedAt };
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
//# sourceMappingURL=processes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/application/processes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { JsonObject, RunRecord } from "../contracts/types.js";
|
|
2
|
+
import type { WireBudgetsV2, WireFixedStreamRefV2, WireRunV2, WireRunViewV2 } from "../contracts/wire.js";
|
|
3
|
+
import type { RunDetails, RunView } from "../runtime/engine.js";
|
|
4
|
+
import type { ResultEncoder, ResultScope } from "../results/encoder.js";
|
|
5
|
+
export declare function projectRunRecord(run: RunRecord, options?: {
|
|
6
|
+
readonly root?: string;
|
|
7
|
+
readonly availability?: Partial<WireRunV2["availability"]>;
|
|
8
|
+
}): WireRunV2;
|
|
9
|
+
export interface RunProjectionPorts {
|
|
10
|
+
readonly readOnly?: boolean;
|
|
11
|
+
readonly encoder: ResultEncoder;
|
|
12
|
+
readonly scope: ResultScope;
|
|
13
|
+
readonly budgets: WireBudgetsV2;
|
|
14
|
+
shipJson(value: JsonObject, purpose: "result-meta"): Promise<WireFixedStreamRefV2>;
|
|
15
|
+
}
|
|
16
|
+
/** Core facts become bounded wire data here; no result is rerun and no media is encoded as control JSON. */
|
|
17
|
+
export declare function projectRunView(view: RunView | RunDetails, ports: RunProjectionPorts): Promise<WireRunViewV2>;
|