@nexum-hub/agent 0.0.0-stage → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +133 -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,213 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { realpathSync, lstatSync } from "node:fs";
|
|
3
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
4
|
+
import { callerKey } from "../contracts/caller.js";
|
|
5
|
+
import { canonicalJson } from "../contracts/json.js";
|
|
6
|
+
import { validateConnectionV2, validatePolicyLeaseV2, } from "../contracts/wire-validation.js";
|
|
7
|
+
import { contains } from "../runtime/paths.js";
|
|
8
|
+
import { validateContract } from "../contracts/validation.js";
|
|
9
|
+
import { performance } from "node:perf_hooks";
|
|
10
|
+
const copy = (value) => JSON.parse(canonicalJson(value));
|
|
11
|
+
function targetPath(value) {
|
|
12
|
+
requireCondition(path.isAbsolute(value) && !value.includes("\0"), "path_not_allowed", "A managed filesystem target needs an absolute path.");
|
|
13
|
+
let ancestor = path.normalize(value);
|
|
14
|
+
const remaining = [];
|
|
15
|
+
while (true) {
|
|
16
|
+
try {
|
|
17
|
+
return path.resolve(realpathSync.native(ancestor), ...remaining);
|
|
18
|
+
}
|
|
19
|
+
catch (cause) {
|
|
20
|
+
const code = cause.code;
|
|
21
|
+
// Broken redirects and access errors cannot be treated as absent directories.
|
|
22
|
+
if (code !== "ENOENT" || lstatSync(ancestor, { throwIfNoEntry: false }))
|
|
23
|
+
throw new AgentError("path_not_allowed", "The managed path cannot be resolved safely.");
|
|
24
|
+
const parent = path.dirname(ancestor);
|
|
25
|
+
requireCondition(parent !== ancestor, "path_not_allowed", "The managed path has no existing ancestor.");
|
|
26
|
+
remaining.unshift(path.basename(ancestor));
|
|
27
|
+
ancestor = parent;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/** Synchronous current policy for Core callbacks, refreshed only through authenticated Cloud evidence. */
|
|
32
|
+
export class AgentAuthority {
|
|
33
|
+
binding;
|
|
34
|
+
work;
|
|
35
|
+
#connection;
|
|
36
|
+
#policies = new Map();
|
|
37
|
+
#now;
|
|
38
|
+
constructor(binding, work, now = Date.now) {
|
|
39
|
+
this.binding = Object.freeze({
|
|
40
|
+
agentId: binding.agentId,
|
|
41
|
+
profile: binding.profile,
|
|
42
|
+
bootId: binding.bootId,
|
|
43
|
+
cloudEnvironment: binding.cloudEnvironment,
|
|
44
|
+
});
|
|
45
|
+
this.work = realpathSync.native(work);
|
|
46
|
+
let logical = now(), monotonic = performance.now();
|
|
47
|
+
this.#now = () => {
|
|
48
|
+
const next = performance.now();
|
|
49
|
+
logical = Math.max(now(), logical + next - monotonic);
|
|
50
|
+
monotonic = next;
|
|
51
|
+
return Math.floor(logical);
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
connect(binding) {
|
|
55
|
+
for (const key of [
|
|
56
|
+
"agentId",
|
|
57
|
+
"profile",
|
|
58
|
+
"bootId",
|
|
59
|
+
"cloudEnvironment",
|
|
60
|
+
])
|
|
61
|
+
requireCondition(binding[key] === this.binding[key], "runtime_binding_mismatch", "This process cannot adopt a different Agent, profile, boot or Cloud environment.");
|
|
62
|
+
this.#connection = copy(binding);
|
|
63
|
+
}
|
|
64
|
+
#key(caller, projectId = null) {
|
|
65
|
+
const session = caller.source === "owner_session";
|
|
66
|
+
requireCondition(session
|
|
67
|
+
? typeof caller.sessionRef === "string" &&
|
|
68
|
+
/^[0-9a-f]{64}$/.test(caller.sessionRef) &&
|
|
69
|
+
caller.clientId === `nexum-console:${caller.sessionRef}` &&
|
|
70
|
+
caller.grantId === undefined
|
|
71
|
+
: (caller.source === undefined || caller.source === "mcp") &&
|
|
72
|
+
typeof caller.grantId === "string" &&
|
|
73
|
+
caller.grantId.length > 0, "unauthorized", "Current Agent access requires its verified Grant or owner session.");
|
|
74
|
+
requireCondition(projectId === null ||
|
|
75
|
+
(typeof projectId === "string" &&
|
|
76
|
+
projectId.length > 0 &&
|
|
77
|
+
projectId.length <= 256), "invalid_authorization_scope", "The policy must retain its actual Agent or Project scope.");
|
|
78
|
+
return canonicalJson([
|
|
79
|
+
callerKey(caller),
|
|
80
|
+
session ? "owner_session" : "mcp",
|
|
81
|
+
session ? caller.sessionRef : caller.grantId,
|
|
82
|
+
projectId,
|
|
83
|
+
]);
|
|
84
|
+
}
|
|
85
|
+
observe(context) {
|
|
86
|
+
validateContract("wire.type:Caller", context.caller);
|
|
87
|
+
requireCondition(this.#connection, "connection_closed", "No authenticated control connection exists.");
|
|
88
|
+
validateConnectionV2(context.connection, this.#connection);
|
|
89
|
+
validatePolicyLeaseV2(context.authorization, this.#now());
|
|
90
|
+
requireCondition(context.authorization.agentId === this.binding.agentId, "agent_mismatch", "The current policy belongs to another Agent.");
|
|
91
|
+
const fixed = copy(context), projectId = fixed.authorization.projectId ?? null, key = this.#key(fixed.caller, projectId);
|
|
92
|
+
if (!this.#policies.has(key) && this.#policies.size >= 4096) {
|
|
93
|
+
for (const [candidate, cell] of this.#policies)
|
|
94
|
+
if (cell.policy && Date.parse(cell.policy.expiresAt) <= this.#now())
|
|
95
|
+
this.#policies.delete(candidate);
|
|
96
|
+
requireCondition(this.#policies.size < 4096, "authorization_busy", "The current policy cache is occupied.");
|
|
97
|
+
}
|
|
98
|
+
const token = Symbol("policy-observation");
|
|
99
|
+
this.#policies.set(key, {
|
|
100
|
+
token,
|
|
101
|
+
caller: fixed.caller,
|
|
102
|
+
policy: fixed.authorization,
|
|
103
|
+
});
|
|
104
|
+
return { key, token, projectId, context: fixed };
|
|
105
|
+
}
|
|
106
|
+
revoke(caller) {
|
|
107
|
+
const identity = this.#key(caller);
|
|
108
|
+
for (const [key, cell] of this.#policies)
|
|
109
|
+
if (this.#key(cell.caller) === identity)
|
|
110
|
+
this.#policies.set(key, {
|
|
111
|
+
token: Symbol("policy-revoked"),
|
|
112
|
+
caller: copy(caller),
|
|
113
|
+
policy: null,
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
current(caller, projectId = null) {
|
|
117
|
+
const cell = this.#policies.get(this.#key(caller, projectId));
|
|
118
|
+
requireCondition(cell?.policy, "forbidden", "The current Cloud authority was revoked or is unavailable.");
|
|
119
|
+
validatePolicyLeaseV2(cell.policy, this.#now());
|
|
120
|
+
return copy(cell.policy);
|
|
121
|
+
}
|
|
122
|
+
capture(caller, projectId = null) {
|
|
123
|
+
const key = this.#key(caller, projectId), cell = this.#policies.get(key);
|
|
124
|
+
requireCondition(cell?.policy && this.#connection, "forbidden", "No current policy observation is available.");
|
|
125
|
+
this.current(caller, projectId);
|
|
126
|
+
return {
|
|
127
|
+
key,
|
|
128
|
+
token: cell.token,
|
|
129
|
+
projectId,
|
|
130
|
+
context: {
|
|
131
|
+
caller: copy(caller),
|
|
132
|
+
authorization: copy(cell.policy),
|
|
133
|
+
connection: copy(this.#connection),
|
|
134
|
+
},
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
refresh(observation, policy) {
|
|
138
|
+
if (this.#policies.get(observation.key)?.token !== observation.token)
|
|
139
|
+
return false;
|
|
140
|
+
requireCondition(this.#connection, "connection_closed", "No authenticated control connection exists.");
|
|
141
|
+
requireCondition((policy.projectId ?? null) === observation.projectId, "authorization_scope_mismatch", "A refreshed policy cannot change its Project scope.");
|
|
142
|
+
this.observe({
|
|
143
|
+
...observation.context,
|
|
144
|
+
connection: this.#connection,
|
|
145
|
+
authorization: policy,
|
|
146
|
+
});
|
|
147
|
+
return true;
|
|
148
|
+
}
|
|
149
|
+
/** Cleanup proves original ownership separately; it does not obtain a new business-access lease. */
|
|
150
|
+
cleanupContext(caller, previous) {
|
|
151
|
+
for (const key of [
|
|
152
|
+
"agentId",
|
|
153
|
+
"profile",
|
|
154
|
+
"bootId",
|
|
155
|
+
"cloudEnvironment",
|
|
156
|
+
])
|
|
157
|
+
requireCondition(previous.connection[key] === this.binding[key], "connection_mismatch", "Cleanup cannot adopt a resource from another Agent boot or profile.");
|
|
158
|
+
requireCondition(this.#connection && this.#key(caller) === this.#key(previous.caller), "forbidden", "Cleanup must retain the original verified caller.");
|
|
159
|
+
return copy({
|
|
160
|
+
caller,
|
|
161
|
+
authorization: previous.authorization,
|
|
162
|
+
connection: this.#connection,
|
|
163
|
+
});
|
|
164
|
+
}
|
|
165
|
+
context(caller, projectId = null) {
|
|
166
|
+
return this.capture(caller, projectId).context;
|
|
167
|
+
}
|
|
168
|
+
authorize(caller, target, projectId = null) {
|
|
169
|
+
const policy = this.current(caller, projectId);
|
|
170
|
+
if (!target)
|
|
171
|
+
return;
|
|
172
|
+
requireCondition(caller.source !== "owner_session" ||
|
|
173
|
+
target.access === "read" ||
|
|
174
|
+
(target.type === "resource" && target.access === "stop"), "forbidden", "This action is unavailable to the current owner session.");
|
|
175
|
+
if (target.type === "path") {
|
|
176
|
+
const actual = targetPath(target.value);
|
|
177
|
+
// Process execution has its own declared capability. Installed system
|
|
178
|
+
// executables need not live below a data directory; cwd and data access do.
|
|
179
|
+
if (target.access === "execute")
|
|
180
|
+
return;
|
|
181
|
+
const roots = [
|
|
182
|
+
this.work,
|
|
183
|
+
...policy.allowedRoots,
|
|
184
|
+
...(target.access === "read"
|
|
185
|
+
? [path.join(path.dirname(this.work), "logs")]
|
|
186
|
+
: []),
|
|
187
|
+
];
|
|
188
|
+
requireCondition(roots.some((root) => {
|
|
189
|
+
try {
|
|
190
|
+
return (path.isAbsolute(root) &&
|
|
191
|
+
realpathSync.native(root) === root &&
|
|
192
|
+
contains(root, actual));
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
return false;
|
|
196
|
+
}
|
|
197
|
+
}), "path_not_allowed", "The managed path is outside the current approved roots.");
|
|
198
|
+
}
|
|
199
|
+
else if (target.type === "url") {
|
|
200
|
+
let url;
|
|
201
|
+
try {
|
|
202
|
+
url = new URL(target.value);
|
|
203
|
+
}
|
|
204
|
+
catch {
|
|
205
|
+
throw new AgentError("url_not_allowed", "The managed network target is invalid.");
|
|
206
|
+
}
|
|
207
|
+
requireCondition(["http:", "https:"].includes(url.protocol) &&
|
|
208
|
+
!url.username &&
|
|
209
|
+
!url.password, "url_not_allowed", "The managed network target is invalid.");
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
//# sourceMappingURL=authority.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"authority.js","sourceRoot":"","sources":["../../src/application/authority.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { WireCatalogProjectV2, WireEventDataV2 } from "../contracts/wire.js";
|
|
2
|
+
/** Cloud owns the project catalog; this is its bounded live README projection. */
|
|
3
|
+
export declare class AgentCatalog {
|
|
4
|
+
#private;
|
|
5
|
+
readonly publish: (data: WireEventDataV2["agent.catalog.changed"]) => Promise<void>;
|
|
6
|
+
constructor(publish: (data: WireEventDataV2["agent.catalog.changed"]) => Promise<void>);
|
|
7
|
+
project(id: string): WireCatalogProjectV2 | undefined;
|
|
8
|
+
sync(data: WireEventDataV2["agent.catalog.sync"], signal: AbortSignal): Promise<void>;
|
|
9
|
+
refresh(signal?: AbortSignal): Promise<void>;
|
|
10
|
+
close(): Promise<void>;
|
|
11
|
+
}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
import { realpathSync, watch } from "node:fs";
|
|
3
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
4
|
+
import { canonicalJson } from "../contracts/json.js";
|
|
5
|
+
import { contains } from "../runtime/paths.js";
|
|
6
|
+
import { readProjectSummary } from "../work/discovery.js";
|
|
7
|
+
/** Cloud owns the project catalog; this is its bounded live README projection. */
|
|
8
|
+
export class AgentCatalog {
|
|
9
|
+
publish;
|
|
10
|
+
#projects = new Map();
|
|
11
|
+
#watchers = [];
|
|
12
|
+
#generation;
|
|
13
|
+
#nextPage = 0;
|
|
14
|
+
#pending = [];
|
|
15
|
+
#roots = [];
|
|
16
|
+
#sequence = 0;
|
|
17
|
+
#closed = false;
|
|
18
|
+
#tail = Promise.resolve();
|
|
19
|
+
#timer;
|
|
20
|
+
constructor(publish) {
|
|
21
|
+
this.publish = publish;
|
|
22
|
+
}
|
|
23
|
+
project(id) {
|
|
24
|
+
return this.#projects.get(id);
|
|
25
|
+
}
|
|
26
|
+
async sync(data, signal) {
|
|
27
|
+
signal.throwIfAborted();
|
|
28
|
+
requireCondition(!this.#closed, "runtime_closed", "The Agent catalog has closed.");
|
|
29
|
+
if (data.page === 0) {
|
|
30
|
+
this.#generation = data.generation;
|
|
31
|
+
this.#nextPage = 0;
|
|
32
|
+
this.#pending = [];
|
|
33
|
+
}
|
|
34
|
+
requireCondition(this.#generation === data.generation &&
|
|
35
|
+
data.page === this.#nextPage &&
|
|
36
|
+
this.#pending.length + data.projects.length <= 10000, "catalog_page_mismatch", "The catalog pages are stale, out of order or too large.");
|
|
37
|
+
this.#pending.push(...JSON.parse(canonicalJson(data.projects)));
|
|
38
|
+
this.#nextPage++;
|
|
39
|
+
if (!data.complete)
|
|
40
|
+
return;
|
|
41
|
+
const projects = new Map();
|
|
42
|
+
for (const item of this.#pending) {
|
|
43
|
+
requireCondition(!projects.has(item.projectId), "catalog_page_mismatch", "A project was repeated in one catalog generation.");
|
|
44
|
+
projects.set(item.projectId, item);
|
|
45
|
+
}
|
|
46
|
+
this.#roots = [...data.allowedRoots];
|
|
47
|
+
this.#projects = projects;
|
|
48
|
+
this.#pending = [];
|
|
49
|
+
for (const watcher of this.#watchers)
|
|
50
|
+
watcher.close();
|
|
51
|
+
this.#watchers = [];
|
|
52
|
+
for (const project of projects.values()) {
|
|
53
|
+
try {
|
|
54
|
+
this.#path(project.root);
|
|
55
|
+
const watcher = watch(project.root, (_event, filename) => {
|
|
56
|
+
if (filename === null ||
|
|
57
|
+
/^readme(?:\..*)?$/i.test(filename.toString()))
|
|
58
|
+
this.#schedule();
|
|
59
|
+
});
|
|
60
|
+
watcher.on("error", () => this.#schedule());
|
|
61
|
+
this.#watchers.push(watcher);
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
/* The published summary below records unavailable roots. */
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
await this.refresh(signal);
|
|
68
|
+
}
|
|
69
|
+
#path(root) {
|
|
70
|
+
requireCondition(path.isAbsolute(root) &&
|
|
71
|
+
realpathSync.native(root) === root &&
|
|
72
|
+
this.#roots.some((allowed) => {
|
|
73
|
+
try {
|
|
74
|
+
return (path.isAbsolute(allowed) &&
|
|
75
|
+
realpathSync.native(allowed) === allowed &&
|
|
76
|
+
contains(allowed, root));
|
|
77
|
+
}
|
|
78
|
+
catch {
|
|
79
|
+
return false;
|
|
80
|
+
}
|
|
81
|
+
}), "path_not_allowed", "The catalog root is outside its current approved roots.");
|
|
82
|
+
}
|
|
83
|
+
#schedule() {
|
|
84
|
+
if (this.#closed || this.#timer)
|
|
85
|
+
return;
|
|
86
|
+
this.#timer = setTimeout(() => {
|
|
87
|
+
this.#timer = undefined;
|
|
88
|
+
void this.refresh().catch(() => { });
|
|
89
|
+
}, 100);
|
|
90
|
+
this.#timer.unref();
|
|
91
|
+
}
|
|
92
|
+
refresh(signal = new AbortController().signal) {
|
|
93
|
+
const task = this.#tail.then(async () => {
|
|
94
|
+
if (this.#closed)
|
|
95
|
+
return;
|
|
96
|
+
const projects = [...this.#projects.values()], generation = this.#generation;
|
|
97
|
+
const summaries = [];
|
|
98
|
+
for (const project of projects) {
|
|
99
|
+
signal.throwIfAborted();
|
|
100
|
+
try {
|
|
101
|
+
this.#path(project.root);
|
|
102
|
+
const summary = await readProjectSummary(project.root, signal);
|
|
103
|
+
summaries.push(summary.status === "updated" &&
|
|
104
|
+
summary.description !== null &&
|
|
105
|
+
summary.revision !== null
|
|
106
|
+
? {
|
|
107
|
+
projectId: project.projectId,
|
|
108
|
+
root: project.root,
|
|
109
|
+
status: "ok",
|
|
110
|
+
description: summary.description,
|
|
111
|
+
revision: summary.revision,
|
|
112
|
+
}
|
|
113
|
+
: summary.status === "missing"
|
|
114
|
+
? {
|
|
115
|
+
projectId: project.projectId,
|
|
116
|
+
root: project.root,
|
|
117
|
+
status: "missing",
|
|
118
|
+
}
|
|
119
|
+
: {
|
|
120
|
+
projectId: project.projectId,
|
|
121
|
+
root: project.root,
|
|
122
|
+
status: "unavailable",
|
|
123
|
+
error: {
|
|
124
|
+
code: "readme_unavailable",
|
|
125
|
+
message: "The current project summary is unavailable.",
|
|
126
|
+
},
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
signal.throwIfAborted();
|
|
131
|
+
summaries.push({
|
|
132
|
+
projectId: project.projectId,
|
|
133
|
+
root: project.root,
|
|
134
|
+
status: "unavailable",
|
|
135
|
+
error: {
|
|
136
|
+
code: "readme_unavailable",
|
|
137
|
+
message: "The current project summary is unavailable.",
|
|
138
|
+
},
|
|
139
|
+
});
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
if (this.#closed || generation !== this.#generation)
|
|
143
|
+
return;
|
|
144
|
+
// Keep each ordinary control event below its one-MiB envelope limit.
|
|
145
|
+
let page = [];
|
|
146
|
+
for (const item of summaries) {
|
|
147
|
+
if (page.length &&
|
|
148
|
+
Buffer.byteLength(canonicalJson([...page, item])) > 512 * 1024) {
|
|
149
|
+
await this.publish({
|
|
150
|
+
sequence: ++this.#sequence,
|
|
151
|
+
observedAt: new Date().toISOString(),
|
|
152
|
+
projects: page,
|
|
153
|
+
});
|
|
154
|
+
page = [];
|
|
155
|
+
}
|
|
156
|
+
page.push(item);
|
|
157
|
+
}
|
|
158
|
+
if (page.length)
|
|
159
|
+
await this.publish({
|
|
160
|
+
sequence: ++this.#sequence,
|
|
161
|
+
observedAt: new Date().toISOString(),
|
|
162
|
+
projects: page,
|
|
163
|
+
});
|
|
164
|
+
});
|
|
165
|
+
this.#tail = task.catch(() => { });
|
|
166
|
+
return task;
|
|
167
|
+
}
|
|
168
|
+
async close() {
|
|
169
|
+
this.#closed = true;
|
|
170
|
+
clearTimeout(this.#timer);
|
|
171
|
+
for (const watcher of this.#watchers)
|
|
172
|
+
watcher.close();
|
|
173
|
+
this.#watchers = [];
|
|
174
|
+
await this.#tail;
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
//# sourceMappingURL=catalog.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/application/catalog.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { Profile } from "../contracts/types.js";
|
|
2
|
+
export interface AgentStorageConfiguration {
|
|
3
|
+
readonly max_managed_bytes?: number;
|
|
4
|
+
}
|
|
5
|
+
export interface AgentRetentionConfiguration {
|
|
6
|
+
readonly work_idle_ms?: number;
|
|
7
|
+
readonly run_history_ms?: number;
|
|
8
|
+
readonly run_logs_ms?: number;
|
|
9
|
+
readonly input_attachments_ms?: number;
|
|
10
|
+
readonly artifact_ms?: number;
|
|
11
|
+
readonly material_copies_ms?: number;
|
|
12
|
+
}
|
|
13
|
+
export interface ProfileConfiguration {
|
|
14
|
+
readonly profile: Profile;
|
|
15
|
+
readonly root: string;
|
|
16
|
+
readonly serverUrl: string;
|
|
17
|
+
readonly token: string;
|
|
18
|
+
readonly storage?: Readonly<AgentStorageConfiguration>;
|
|
19
|
+
readonly retention?: Readonly<AgentRetentionConfiguration>;
|
|
20
|
+
}
|
|
21
|
+
export declare function validateServerUrl(value: unknown, profile: Profile): URL;
|
|
22
|
+
export declare function validateAgentToken(value: unknown): string;
|
|
23
|
+
export declare function profileRoot(profile: Profile, home?: string): string;
|
|
24
|
+
export declare function loadProfileConfig(profile: Profile, home?: string): ProfileConfiguration;
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import { homedir } from "node:os";
|
|
2
|
+
import { constants, openSync, closeSync, fstatSync, readSync, realpathSync, lstatSync, } from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
5
|
+
import { isPlainRecord } from "../contracts/json.js";
|
|
6
|
+
function invalid() {
|
|
7
|
+
// Never attach the source text, filename, credential or parser/system cause.
|
|
8
|
+
return new AgentError("invalid_configuration", "The selected Agent profile configuration is unavailable or invalid.");
|
|
9
|
+
}
|
|
10
|
+
function numericPolicy(value, fields, duration = false) {
|
|
11
|
+
if (value === undefined)
|
|
12
|
+
return undefined;
|
|
13
|
+
if (!isPlainRecord(value))
|
|
14
|
+
throw invalid();
|
|
15
|
+
for (const [key, number] of Object.entries(value))
|
|
16
|
+
if (!fields.includes(key) ||
|
|
17
|
+
typeof number !== "number" ||
|
|
18
|
+
!Number.isSafeInteger(number) ||
|
|
19
|
+
number <= 0 ||
|
|
20
|
+
(duration && number > 253_402_300_799_999 - Date.now()))
|
|
21
|
+
throw invalid();
|
|
22
|
+
return Object.freeze({ ...value });
|
|
23
|
+
}
|
|
24
|
+
export function validateServerUrl(value, profile) {
|
|
25
|
+
try {
|
|
26
|
+
requireCondition((profile === "production" || profile === "development") &&
|
|
27
|
+
typeof value === "string" &&
|
|
28
|
+
value.length > 0 &&
|
|
29
|
+
Buffer.byteLength(value) <= 8192 &&
|
|
30
|
+
value.trim() === value &&
|
|
31
|
+
!/[\x00-\x20\x7f]/.test(value), "invalid_configuration", "The Server URL is invalid.");
|
|
32
|
+
const url = new URL(value);
|
|
33
|
+
requireCondition(["http:", "https:"].includes(url.protocol) &&
|
|
34
|
+
(profile === "development" || url.protocol === "https:") &&
|
|
35
|
+
!url.username &&
|
|
36
|
+
!url.password &&
|
|
37
|
+
!url.search &&
|
|
38
|
+
!url.hash, "invalid_configuration", "The Server URL is invalid.");
|
|
39
|
+
return url;
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
throw invalid();
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
export function validateAgentToken(value) {
|
|
46
|
+
if (typeof value !== "string" || !/^[\x21-\x7e]{1,8192}$/.test(value))
|
|
47
|
+
throw invalid();
|
|
48
|
+
return value;
|
|
49
|
+
}
|
|
50
|
+
export function profileRoot(profile, home = homedir()) {
|
|
51
|
+
if (!((profile === "production" || profile === "development") &&
|
|
52
|
+
typeof home === "string" &&
|
|
53
|
+
path.isAbsolute(home)))
|
|
54
|
+
throw invalid();
|
|
55
|
+
return path.join(home, profile === "development" ? ".nexum-dev" : ".nexum");
|
|
56
|
+
}
|
|
57
|
+
export function loadProfileConfig(profile, home = homedir()) {
|
|
58
|
+
let file;
|
|
59
|
+
try {
|
|
60
|
+
const root = profileRoot(profile, realpathSync.native(home));
|
|
61
|
+
const directory = lstatSync(root);
|
|
62
|
+
if (!directory.isDirectory() ||
|
|
63
|
+
directory.isSymbolicLink() ||
|
|
64
|
+
realpathSync.native(root) !== root)
|
|
65
|
+
throw invalid();
|
|
66
|
+
const filename = path.join(root, "config.json"), before = lstatSync(filename);
|
|
67
|
+
if (!before.isFile() || before.isSymbolicLink())
|
|
68
|
+
throw invalid();
|
|
69
|
+
file = openSync(filename, constants.O_RDONLY |
|
|
70
|
+
(constants.O_NOFOLLOW ?? 0) |
|
|
71
|
+
(constants.O_NONBLOCK ?? 0));
|
|
72
|
+
const stat = fstatSync(file);
|
|
73
|
+
if (!stat.isFile() ||
|
|
74
|
+
stat.dev !== before.dev ||
|
|
75
|
+
stat.ino !== before.ino ||
|
|
76
|
+
stat.size > 16384 ||
|
|
77
|
+
realpathSync.native(root) !== root)
|
|
78
|
+
throw invalid();
|
|
79
|
+
if (process.platform !== "win32" &&
|
|
80
|
+
((stat.mode & 0o077) !== 0 ||
|
|
81
|
+
(process.getuid && stat.uid !== process.getuid())))
|
|
82
|
+
throw invalid();
|
|
83
|
+
const bytes = Buffer.alloc(16385);
|
|
84
|
+
let size = 0;
|
|
85
|
+
while (size < bytes.length) {
|
|
86
|
+
const count = readSync(file, bytes, size, bytes.length - size, null);
|
|
87
|
+
if (!count)
|
|
88
|
+
break;
|
|
89
|
+
size += count;
|
|
90
|
+
}
|
|
91
|
+
if (size > 16384)
|
|
92
|
+
throw invalid();
|
|
93
|
+
const value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(0, size)));
|
|
94
|
+
if (!value ||
|
|
95
|
+
typeof value !== "object" ||
|
|
96
|
+
Array.isArray(value) ||
|
|
97
|
+
!Object.keys(value).every((key) => ["server_url", "token", "storage", "retention"].includes(key)) ||
|
|
98
|
+
!Object.hasOwn(value, "server_url") ||
|
|
99
|
+
!Object.hasOwn(value, "token"))
|
|
100
|
+
throw invalid();
|
|
101
|
+
const fields = value;
|
|
102
|
+
const serverUrl = validateServerUrl(fields.server_url, profile).href;
|
|
103
|
+
const token = validateAgentToken(fields.token);
|
|
104
|
+
const storage = numericPolicy(fields.storage, ["max_managed_bytes"]);
|
|
105
|
+
const retention = numericPolicy(fields.retention, [
|
|
106
|
+
"work_idle_ms",
|
|
107
|
+
"run_history_ms",
|
|
108
|
+
"run_logs_ms",
|
|
109
|
+
"input_attachments_ms",
|
|
110
|
+
"artifact_ms",
|
|
111
|
+
"material_copies_ms",
|
|
112
|
+
], true);
|
|
113
|
+
const configuration = {
|
|
114
|
+
profile,
|
|
115
|
+
root,
|
|
116
|
+
serverUrl,
|
|
117
|
+
...(storage ? { storage } : {}),
|
|
118
|
+
...(retention ? { retention } : {}),
|
|
119
|
+
};
|
|
120
|
+
Object.defineProperty(configuration, "token", {
|
|
121
|
+
value: token,
|
|
122
|
+
enumerable: false,
|
|
123
|
+
});
|
|
124
|
+
return Object.freeze(configuration);
|
|
125
|
+
}
|
|
126
|
+
catch {
|
|
127
|
+
throw invalid();
|
|
128
|
+
}
|
|
129
|
+
finally {
|
|
130
|
+
if (file !== undefined) {
|
|
131
|
+
try {
|
|
132
|
+
closeSync(file);
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
throw invalid();
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
//# sourceMappingURL=config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/application/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { AgentError } from "../contracts/errors.js";
|
|
2
|
+
import type { WireConnectionV2, WireEnvelopeV2, WireEventV2, WireInvokeV2, WireInvocationContextV2, WireOperationV2, WireInputsV2, WireOutputsV2 } from "../contracts/wire.js";
|
|
3
|
+
import type { Profile } from "../contracts/types.js";
|
|
4
|
+
export interface ControlConnectionOptions {
|
|
5
|
+
readonly serverUrl: string;
|
|
6
|
+
readonly token: string;
|
|
7
|
+
readonly profile: Profile;
|
|
8
|
+
readonly bootId: string;
|
|
9
|
+
readonly version: string;
|
|
10
|
+
readonly signal: AbortSignal;
|
|
11
|
+
/** Application initialization completes before an incoming invocation is admitted. */
|
|
12
|
+
ready(connection: ControlConnection): Promise<void>;
|
|
13
|
+
invoke(message: WireInvokeV2, signal: AbortSignal): Promise<unknown>;
|
|
14
|
+
event(message: WireEventV2, signal: AbortSignal): Promise<void>;
|
|
15
|
+
}
|
|
16
|
+
export declare class ConnectionRejection extends AgentError {
|
|
17
|
+
readonly status: number;
|
|
18
|
+
readonly rejectionCode: string | null;
|
|
19
|
+
constructor(status: number, rejectionCode: string | null);
|
|
20
|
+
get stopNoRestart(): boolean;
|
|
21
|
+
}
|
|
22
|
+
/** One actual socket and its observation RPCs; accepted Run lifetime belongs to RunEngine. */
|
|
23
|
+
export declare class ControlConnection {
|
|
24
|
+
#private;
|
|
25
|
+
readonly binding: Readonly<WireConnectionV2>;
|
|
26
|
+
readonly closed: Promise<void>;
|
|
27
|
+
readonly signal: AbortSignal;
|
|
28
|
+
private constructor();
|
|
29
|
+
static connect(options: ControlConnectionOptions): Promise<ControlConnection>;
|
|
30
|
+
send(message: WireEnvelopeV2): Promise<void>;
|
|
31
|
+
request<O extends WireOperationV2>(operation: O, context: WireInvocationContextV2, input: WireInputsV2[O], signal: AbortSignal, timeoutMs?: number): Promise<WireOutputsV2[O]>;
|
|
32
|
+
close(): void;
|
|
33
|
+
}
|
|
34
|
+
/** Reconnection only; the callback never replays previously accepted application requests. */
|
|
35
|
+
export declare function reconnectControl(options: ControlConnectionOptions, diagnose: (code: string, retry: boolean) => void): Promise<"stopped" | "permanent">;
|