@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,281 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { realpath, stat } from "node:fs/promises";
|
|
3
|
+
import { types } from "node:util";
|
|
4
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
5
|
+
import { authorizeCall } from "../contracts/caller.js";
|
|
6
|
+
import { isPlainRecord } from "../contracts/json.js";
|
|
7
|
+
import { discoverEnvironment, mergeChildEnvironment, whichExecutable, } from "./environment.js";
|
|
8
|
+
const KiB = 1024;
|
|
9
|
+
const MiB = KiB * KiB;
|
|
10
|
+
const textLimit = 256 * KiB;
|
|
11
|
+
const argumentLimit = MiB;
|
|
12
|
+
const inputLimit = MiB;
|
|
13
|
+
const maximumTimeout = 2_147_483_647;
|
|
14
|
+
const launchFields = new Set([
|
|
15
|
+
"command",
|
|
16
|
+
"args",
|
|
17
|
+
"shellCommand",
|
|
18
|
+
"shell",
|
|
19
|
+
"cwd",
|
|
20
|
+
"env",
|
|
21
|
+
"tty",
|
|
22
|
+
"cols",
|
|
23
|
+
"rows",
|
|
24
|
+
"input",
|
|
25
|
+
"background",
|
|
26
|
+
"check",
|
|
27
|
+
"timeoutMs",
|
|
28
|
+
]);
|
|
29
|
+
const typedPrototype = Object.getPrototypeOf(Uint8Array.prototype);
|
|
30
|
+
const typedGet = (key) => Object.getOwnPropertyDescriptor(typedPrototype, key).get;
|
|
31
|
+
const typedBuffer = typedGet("buffer");
|
|
32
|
+
const typedOffset = typedGet("byteOffset");
|
|
33
|
+
const typedLength = typedGet("byteLength");
|
|
34
|
+
const typedValues = Uint8Array.prototype.values;
|
|
35
|
+
const typedSet = Uint8Array.prototype.set;
|
|
36
|
+
function text(value, label, maximum = textLimit, nonempty = true) {
|
|
37
|
+
requireCondition(typeof value === "string" &&
|
|
38
|
+
(!nonempty || value.length > 0) &&
|
|
39
|
+
!value.includes("\0") &&
|
|
40
|
+
Buffer.byteLength(value) <= maximum, "invalid_process_arguments", `${label} must be bounded text without NUL bytes.`);
|
|
41
|
+
return value;
|
|
42
|
+
}
|
|
43
|
+
function record(value, allowed, label) {
|
|
44
|
+
requireCondition(isPlainRecord(value), "invalid_process_arguments", `${label} must be an ordinary data object.`);
|
|
45
|
+
const keys = Reflect.ownKeys(value);
|
|
46
|
+
requireCondition(keys.length <= 4096, "process_arguments_too_large", `${label} exceeds its field budget.`);
|
|
47
|
+
const copy = Object.create(null);
|
|
48
|
+
for (const key of keys) {
|
|
49
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
50
|
+
requireCondition(typeof key === "string" &&
|
|
51
|
+
allowed.has(key) &&
|
|
52
|
+
descriptor.enumerable &&
|
|
53
|
+
"value" in descriptor, "invalid_process_arguments", `${label} cannot contain unknown fields, symbols, hidden fields or accessors.`);
|
|
54
|
+
if (descriptor.value !== undefined)
|
|
55
|
+
Object.defineProperty(copy, key, {
|
|
56
|
+
value: descriptor.value,
|
|
57
|
+
enumerable: true,
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
return copy;
|
|
61
|
+
}
|
|
62
|
+
function argumentsSnapshot(value) {
|
|
63
|
+
if (value === undefined)
|
|
64
|
+
return Object.freeze([]);
|
|
65
|
+
requireCondition(!types.isProxy(value) && Array.isArray(value), "invalid_process_arguments", "args must be an ordinary array of strings.");
|
|
66
|
+
const length = Object.getOwnPropertyDescriptor(value, "length")
|
|
67
|
+
.value;
|
|
68
|
+
requireCondition(length <= 4096, "process_arguments_too_large", "The command has too many arguments.");
|
|
69
|
+
const keys = Reflect.ownKeys(value);
|
|
70
|
+
requireCondition(keys.length === length + 1, "invalid_process_arguments", "args cannot contain sparse entries or additional fields.");
|
|
71
|
+
const copy = [];
|
|
72
|
+
let bytes = 0;
|
|
73
|
+
for (let index = 0; index < length; index++) {
|
|
74
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
|
|
75
|
+
requireCondition(descriptor && "value" in descriptor && descriptor.enumerable, "invalid_process_arguments", "args must contain only explicit string data entries.");
|
|
76
|
+
const item = text(descriptor.value, "Each command argument", textLimit, false);
|
|
77
|
+
bytes += Buffer.byteLength(item);
|
|
78
|
+
requireCondition(bytes <= argumentLimit, "process_arguments_too_large", "Command arguments exceed their aggregate byte budget.");
|
|
79
|
+
copy.push(item);
|
|
80
|
+
}
|
|
81
|
+
return Object.freeze(copy);
|
|
82
|
+
}
|
|
83
|
+
function environmentSnapshot(value) {
|
|
84
|
+
if (value === undefined)
|
|
85
|
+
return Object.freeze(Object.create(null));
|
|
86
|
+
requireCondition(isPlainRecord(value), "invalid_process_arguments", "env must contain ordinary data properties.");
|
|
87
|
+
const keys = Reflect.ownKeys(value);
|
|
88
|
+
requireCondition(keys.length <= 4096, "process_arguments_too_large", "The environment has too many overrides.");
|
|
89
|
+
const copy = Object.create(null);
|
|
90
|
+
let bytes = 0;
|
|
91
|
+
for (const key of keys) {
|
|
92
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
93
|
+
requireCondition(typeof key === "string" &&
|
|
94
|
+
key.length > 0 &&
|
|
95
|
+
!/[=\0]/.test(key) &&
|
|
96
|
+
Buffer.byteLength(key) <= 1024 &&
|
|
97
|
+
descriptor.enumerable &&
|
|
98
|
+
"value" in descriptor &&
|
|
99
|
+
(descriptor.value === null || typeof descriptor.value === "string"), "invalid_process_arguments", "Environment overrides require bounded names and string/null data values.");
|
|
100
|
+
const item = descriptor.value === null
|
|
101
|
+
? null
|
|
102
|
+
: text(descriptor.value, "An environment value", textLimit, false);
|
|
103
|
+
bytes += Buffer.byteLength(key) + Buffer.byteLength(item ?? "") + 2;
|
|
104
|
+
requireCondition(bytes <= MiB, "process_arguments_too_large", "Environment overrides exceed their aggregate byte budget.");
|
|
105
|
+
Object.defineProperty(copy, key, { value: item, enumerable: true });
|
|
106
|
+
}
|
|
107
|
+
return Object.freeze(copy);
|
|
108
|
+
}
|
|
109
|
+
/** Copies only the actual native byte range; source metadata and iterators are ignored. */
|
|
110
|
+
export function copyProcessInput(value) {
|
|
111
|
+
if (typeof value === "string") {
|
|
112
|
+
text(value, "Process input", inputLimit, false);
|
|
113
|
+
const data = Buffer.from(value, "utf8");
|
|
114
|
+
const copy = new Uint8Array(data.byteLength);
|
|
115
|
+
Reflect.apply(typedSet, copy, [data]);
|
|
116
|
+
return copy;
|
|
117
|
+
}
|
|
118
|
+
requireCondition(!types.isProxy(value) && types.isUint8Array(value), "invalid_process_input", "Process input must be text or an actual Uint8Array/Buffer.");
|
|
119
|
+
try {
|
|
120
|
+
// This native check distinguishes legal empty views from detached/OOB views.
|
|
121
|
+
Reflect.apply(typedValues, value, []);
|
|
122
|
+
const buffer = Reflect.apply(typedBuffer, value, []);
|
|
123
|
+
const offset = Reflect.apply(typedOffset, value, []);
|
|
124
|
+
const length = Reflect.apply(typedLength, value, []);
|
|
125
|
+
requireCondition(length <= inputLimit, "process_input_too_large", "Process input exceeds 1 MiB.");
|
|
126
|
+
const copy = new Uint8Array(length);
|
|
127
|
+
Reflect.apply(typedSet, copy, [new Uint8Array(buffer, offset, length)]);
|
|
128
|
+
return copy;
|
|
129
|
+
}
|
|
130
|
+
catch (cause) {
|
|
131
|
+
if (cause instanceof AgentError)
|
|
132
|
+
throw cause;
|
|
133
|
+
throw new AgentError("invalid_process_input", "The process input byte range is detached or unavailable.", undefined, { cause });
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
function flag(value, label) {
|
|
137
|
+
requireCondition(value === undefined || typeof value === "boolean", "invalid_process_arguments", `${label} must be a boolean.`);
|
|
138
|
+
return value ?? false;
|
|
139
|
+
}
|
|
140
|
+
function dimension(value, label, fallback) {
|
|
141
|
+
if (value === undefined)
|
|
142
|
+
return fallback;
|
|
143
|
+
requireCondition(typeof value === "number" &&
|
|
144
|
+
Number.isSafeInteger(value) &&
|
|
145
|
+
value >= 1 &&
|
|
146
|
+
value <= 10000, "invalid_process_arguments", `${label} must be an integer between 1 and 10000.`);
|
|
147
|
+
return value;
|
|
148
|
+
}
|
|
149
|
+
/** Pure synchronous argument normalization, before authorization and operation admission. */
|
|
150
|
+
export function normalizeLaunch(args, mode) {
|
|
151
|
+
requireCondition(args.length === 1, "invalid_process_arguments", "sh startup accepts exactly one command string or options object.");
|
|
152
|
+
const value = typeof args[0] === "string" ? { shellCommand: args[0] } : args[0];
|
|
153
|
+
const fields = record(value, launchFields, "Process options");
|
|
154
|
+
const command = fields.command === undefined ? undefined : text(fields.command, "command");
|
|
155
|
+
const shellCommand = fields.shellCommand === undefined
|
|
156
|
+
? undefined
|
|
157
|
+
: text(fields.shellCommand, "shellCommand", argumentLimit);
|
|
158
|
+
requireCondition((command === undefined) !== (shellCommand === undefined), "invalid_process_arguments", "Choose exactly one of command + args or shellCommand.");
|
|
159
|
+
requireCondition(shellCommand === undefined || fields.args === undefined, "invalid_process_arguments", "shellCommand cannot also contain direct args.");
|
|
160
|
+
requireCondition(command === undefined || fields.shell === undefined, "invalid_process_arguments", "An explicit shell applies only to shellCommand.");
|
|
161
|
+
const shell = fields.shell === undefined ? undefined : text(fields.shell, "shell");
|
|
162
|
+
const cwd = fields.cwd === undefined ? undefined : text(fields.cwd, "cwd");
|
|
163
|
+
requireCondition(!command || !/[\r\n]/.test(command), "invalid_process_arguments", "command cannot contain line breaks.");
|
|
164
|
+
requireCondition(!shell || !/[\r\n]/.test(shell), "invalid_process_arguments", "shell cannot contain line breaks.");
|
|
165
|
+
if (shell !== undefined)
|
|
166
|
+
shellArguments(shell, shellCommand);
|
|
167
|
+
const tty = flag(fields.tty, "tty");
|
|
168
|
+
requireCondition(tty || (fields.cols === undefined && fields.rows === undefined), "invalid_process_arguments", "Terminal dimensions require tty: true.");
|
|
169
|
+
const background = flag(fields.background, "background"), check = flag(fields.check, "check");
|
|
170
|
+
requireCondition(mode !== "exec" || !background, "invalid_process_arguments", "Background ownership is requested through sh.start.");
|
|
171
|
+
requireCondition(mode !== "start" || !check, "invalid_process_arguments", "check applies to completed sh.exec results.");
|
|
172
|
+
const timeoutMs = fields.timeoutMs;
|
|
173
|
+
requireCondition(timeoutMs === undefined ||
|
|
174
|
+
(typeof timeoutMs === "number" &&
|
|
175
|
+
Number.isSafeInteger(timeoutMs) &&
|
|
176
|
+
timeoutMs > 0 &&
|
|
177
|
+
timeoutMs <= maximumTimeout), "invalid_process_arguments", "timeoutMs must be a positive integer within Node's native timer range.");
|
|
178
|
+
return Object.freeze({
|
|
179
|
+
...(command === undefined ? {} : { command }),
|
|
180
|
+
args: argumentsSnapshot(fields.args),
|
|
181
|
+
...(shellCommand === undefined ? {} : { shellCommand }),
|
|
182
|
+
...(shell === undefined ? {} : { shell }),
|
|
183
|
+
...(cwd === undefined ? {} : { cwd }),
|
|
184
|
+
env: environmentSnapshot(fields.env),
|
|
185
|
+
tty,
|
|
186
|
+
cols: dimension(fields.cols, "cols", 80),
|
|
187
|
+
rows: dimension(fields.rows, "rows", 24),
|
|
188
|
+
...(fields.input === undefined
|
|
189
|
+
? {}
|
|
190
|
+
: { input: copyProcessInput(fields.input) }),
|
|
191
|
+
background,
|
|
192
|
+
check,
|
|
193
|
+
...(timeoutMs === undefined ? {} : { timeoutMs: timeoutMs }),
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
function shellArguments(shell, command) {
|
|
197
|
+
const name = path
|
|
198
|
+
.basename(shell)
|
|
199
|
+
.toLowerCase()
|
|
200
|
+
.replace(/\.exe$/, "");
|
|
201
|
+
if (["sh", "bash", "zsh", "dash", "ksh", "fish"].includes(name))
|
|
202
|
+
return ["-c", command];
|
|
203
|
+
if (name === "cmd")
|
|
204
|
+
return ["/d", "/s", "/c", command];
|
|
205
|
+
if (name === "powershell" || name === "pwsh")
|
|
206
|
+
return ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command", command];
|
|
207
|
+
throw new AgentError("unsupported_shell", "The explicitly selected shell does not have a supported invocation syntax.");
|
|
208
|
+
}
|
|
209
|
+
function windowsVariable(environment, name) {
|
|
210
|
+
const key = Object.keys(environment.variables).find((item) => item.toUpperCase() === name.toUpperCase());
|
|
211
|
+
return key === undefined ? undefined : environment.variables[key];
|
|
212
|
+
}
|
|
213
|
+
/** Resolves a fresh OS-user environment after resource registration, without starting business work. */
|
|
214
|
+
export async function prepareLaunch(input, contextPwd, signal, authorize) {
|
|
215
|
+
signal.throwIfAborted();
|
|
216
|
+
requireCondition(path.isAbsolute(contextPwd) && !contextPwd.includes("\0"), "invalid_cwd", "Process preparation requires the current absolute working directory.");
|
|
217
|
+
requireCondition(process.platform !== "win32" ||
|
|
218
|
+
!input.cwd ||
|
|
219
|
+
!/^[A-Za-z]:[^\\/]/.test(input.cwd), "invalid_cwd", "A process directory cannot use implicit per-drive Windows state.");
|
|
220
|
+
const requested = path.resolve(contextPwd, input.cwd ?? ".");
|
|
221
|
+
authorizeCall(() => authorize(requested, "read"));
|
|
222
|
+
let cwd;
|
|
223
|
+
try {
|
|
224
|
+
cwd = await realpath(requested);
|
|
225
|
+
}
|
|
226
|
+
catch (cause) {
|
|
227
|
+
signal.throwIfAborted();
|
|
228
|
+
if (cause instanceof AgentError)
|
|
229
|
+
throw cause;
|
|
230
|
+
throw new AgentError("cwd_unavailable", "The process working directory cannot be resolved.", undefined, { cause });
|
|
231
|
+
}
|
|
232
|
+
signal.throwIfAborted();
|
|
233
|
+
authorizeCall(() => authorize(cwd, "read"));
|
|
234
|
+
try {
|
|
235
|
+
requireCondition((await stat(cwd)).isDirectory(), "invalid_cwd", "The process working directory is not a directory.");
|
|
236
|
+
}
|
|
237
|
+
catch (cause) {
|
|
238
|
+
signal.throwIfAborted();
|
|
239
|
+
if (cause instanceof AgentError)
|
|
240
|
+
throw cause;
|
|
241
|
+
throw new AgentError("cwd_unavailable", "The process working directory cannot be accessed.", undefined, { cause });
|
|
242
|
+
}
|
|
243
|
+
signal.throwIfAborted();
|
|
244
|
+
const environment = await discoverEnvironment({ cwd, signal });
|
|
245
|
+
signal.throwIfAborted();
|
|
246
|
+
const shell = input.shellCommand === undefined
|
|
247
|
+
? null
|
|
248
|
+
: (input.shell ??
|
|
249
|
+
(process.platform === "win32"
|
|
250
|
+
? (windowsVariable(environment, "ComSpec") ?? "cmd.exe")
|
|
251
|
+
: "/bin/sh"));
|
|
252
|
+
// Decide syntax from the requested shell, not its realpath basename: /bin/sh
|
|
253
|
+
// can be a symlink to bash/dash/busybox while retaining sh invocation meaning.
|
|
254
|
+
const args = shell === null ? input.args : shellArguments(shell, input.shellCommand);
|
|
255
|
+
const executable = await whichExecutable(shell ?? input.command, environment, cwd, { signal });
|
|
256
|
+
signal.throwIfAborted();
|
|
257
|
+
requireCondition(executable.kind !== "batch", "direct_batch_unsupported", "A Windows batch program requires an explicit shellCommand; direct argv is not rewritten into cmd text.");
|
|
258
|
+
// launchPath preserves the selected symlink/applets' argv[0] identity. The
|
|
259
|
+
// canonical file remains separately authorized by the current capability.
|
|
260
|
+
const launchPath = executable.launchPath;
|
|
261
|
+
requireCondition(path.isAbsolute(launchPath), "command_resolution_failed", "Executable discovery did not yield an absolute launch path.");
|
|
262
|
+
authorizeCall(() => authorize(launchPath, "execute"));
|
|
263
|
+
authorizeCall(() => authorize(executable.path, "execute"));
|
|
264
|
+
const env = Object.freeze(mergeChildEnvironment(environment, input.env));
|
|
265
|
+
signal.throwIfAborted();
|
|
266
|
+
return Object.freeze({
|
|
267
|
+
launch: Object.freeze({
|
|
268
|
+
file: launchPath,
|
|
269
|
+
args: Object.freeze([...args]),
|
|
270
|
+
cwd,
|
|
271
|
+
env,
|
|
272
|
+
tty: input.tty,
|
|
273
|
+
cols: input.cols,
|
|
274
|
+
rows: input.rows,
|
|
275
|
+
}),
|
|
276
|
+
executable,
|
|
277
|
+
environment,
|
|
278
|
+
shell: shell === null ? null : launchPath,
|
|
279
|
+
});
|
|
280
|
+
}
|
|
281
|
+
//# sourceMappingURL=launch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/process/launch.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { EventEmitter } from "node:events";
|
|
2
|
+
import type { JsonObject } from "../contracts/types.js";
|
|
3
|
+
import type { ResourceRef, ManagedResource } from "../extensions/resources.js";
|
|
4
|
+
import type { ProcessFacts, ProcessStopOptions } from "./backend.js";
|
|
5
|
+
import { ProcessOutputLog, type ProcessOutputOptions } from "./output-log.js";
|
|
6
|
+
import type { LaunchInput, PreparedLaunch } from "./launch.js";
|
|
7
|
+
export declare const isManagedProcess: (value: unknown) => value is ManagedProcess;
|
|
8
|
+
/** Cold public-protocol resource. No process, environment probe or log is opened by construction. */
|
|
9
|
+
export declare class ManagedProcess extends EventEmitter implements ManagedResource {
|
|
10
|
+
#private;
|
|
11
|
+
readonly agentRoot: string;
|
|
12
|
+
readonly mode: "exec" | "start";
|
|
13
|
+
readonly outputOptions: ProcessOutputOptions;
|
|
14
|
+
readonly closed: Promise<void>;
|
|
15
|
+
readonly input: LaunchInput;
|
|
16
|
+
constructor(agentRoot: string, input: LaunchInput, mode: "exec" | "start", outputOptions?: ProcessOutputOptions);
|
|
17
|
+
get revision(): number;
|
|
18
|
+
get failure(): unknown;
|
|
19
|
+
get log(): ProcessOutputLog | undefined;
|
|
20
|
+
get outputReady(): boolean;
|
|
21
|
+
bind(ref: ResourceRef<ManagedProcess>): void;
|
|
22
|
+
facts(): ProcessFacts;
|
|
23
|
+
details(): JsonObject;
|
|
24
|
+
start(prepare: (signal: AbortSignal) => Promise<PreparedLaunch>): Promise<void>;
|
|
25
|
+
wait(): Promise<void>;
|
|
26
|
+
write(data: Uint8Array, eof: boolean, signal: AbortSignal): Promise<void>;
|
|
27
|
+
resize(cols: number, rows: number): Promise<void>;
|
|
28
|
+
signal(value: NodeJS.Signals): Promise<unknown>;
|
|
29
|
+
stop(options?: ProcessStopOptions, reason?: unknown): Promise<{
|
|
30
|
+
accepted: true;
|
|
31
|
+
confirmed: boolean;
|
|
32
|
+
facts: ProcessFacts;
|
|
33
|
+
}>;
|
|
34
|
+
dispose(reason?: unknown): Promise<void>;
|
|
35
|
+
waitForChange(revision: number, waitMs: number, signal: AbortSignal): Promise<void>;
|
|
36
|
+
}
|