@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,167 @@
|
|
|
1
|
+
import { lstatSync, realpathSync } from "node:fs";
|
|
2
|
+
import { homedir } from "node:os";
|
|
3
|
+
import vm from "node:vm";
|
|
4
|
+
import { AgentError, isAgentError } from "../contracts/errors.js";
|
|
5
|
+
import { newId } from "../contracts/json.js";
|
|
6
|
+
import { loadProfileConfig, profileRoot } from "./config.js";
|
|
7
|
+
import { reconnectControl } from "./connection.js";
|
|
8
|
+
import { AgentRuntime } from "./runtime.js";
|
|
9
|
+
import { maintenanceRuntimeOptions } from "./maintenance.js";
|
|
10
|
+
import { WorkGitSchedule } from "./work-git.js";
|
|
11
|
+
import { appendDiagnostic } from "./diagnostics.js";
|
|
12
|
+
/** Native process entry: one boot/Core survives reconnects; only observations are replaced. */
|
|
13
|
+
export async function runAgent(profile, options) {
|
|
14
|
+
let runtime;
|
|
15
|
+
let git;
|
|
16
|
+
let initializing;
|
|
17
|
+
let stopping = false;
|
|
18
|
+
let shutdownTask;
|
|
19
|
+
let reserve;
|
|
20
|
+
const lifetime = new AbortController();
|
|
21
|
+
const signal = lifetime.signal;
|
|
22
|
+
let failure;
|
|
23
|
+
let diagnosticRoot;
|
|
24
|
+
const diagnose = (code, retry) => {
|
|
25
|
+
// Never serialize native/plugin errors, request data, configuration or credentials.
|
|
26
|
+
if (diagnosticRoot) {
|
|
27
|
+
try {
|
|
28
|
+
appendDiagnostic(diagnosticRoot, profile, code, retry);
|
|
29
|
+
}
|
|
30
|
+
catch {
|
|
31
|
+
process.stderr.write("agent_log_unavailable\n");
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
options.diagnose?.(code, retry);
|
|
35
|
+
process.stderr.write(`${code}${retry ? ": retrying" : ""}\n`);
|
|
36
|
+
};
|
|
37
|
+
const shutdown = () => {
|
|
38
|
+
if (shutdownTask)
|
|
39
|
+
return shutdownTask;
|
|
40
|
+
stopping = true;
|
|
41
|
+
shutdownTask = (async () => {
|
|
42
|
+
try {
|
|
43
|
+
// Keep the authenticated cleanup channel open until Core/native I/O
|
|
44
|
+
// has joined. An OS stop is not an observation disconnect.
|
|
45
|
+
await initializing?.catch(() => { });
|
|
46
|
+
const closed = await Promise.allSettled([
|
|
47
|
+
git?.close(),
|
|
48
|
+
runtime?.close(),
|
|
49
|
+
]);
|
|
50
|
+
const failed = closed.find((entry) => entry.status === "rejected");
|
|
51
|
+
if (failed?.status === "rejected")
|
|
52
|
+
throw failed.reason;
|
|
53
|
+
}
|
|
54
|
+
finally {
|
|
55
|
+
lifetime.abort(new AgentError("runtime_closed", "The Agent process is stopping."));
|
|
56
|
+
}
|
|
57
|
+
})();
|
|
58
|
+
void shutdownTask.catch(() => { });
|
|
59
|
+
return shutdownTask;
|
|
60
|
+
};
|
|
61
|
+
const stop = () => {
|
|
62
|
+
void shutdown();
|
|
63
|
+
};
|
|
64
|
+
options.signal?.addEventListener("abort", stop, { once: true });
|
|
65
|
+
try {
|
|
66
|
+
if (options.signal?.aborted)
|
|
67
|
+
return 0;
|
|
68
|
+
// An existing profile can retain a fixed launch/configuration error without
|
|
69
|
+
// parsing credentials or creating a new profile as a side effect.
|
|
70
|
+
try {
|
|
71
|
+
const candidate = profileRoot(profile, realpathSync.native(options.home ?? homedir()));
|
|
72
|
+
const directory = lstatSync(candidate, { throwIfNoEntry: false });
|
|
73
|
+
if (directory?.isDirectory() &&
|
|
74
|
+
realpathSync.native(candidate) === candidate)
|
|
75
|
+
diagnosticRoot = candidate;
|
|
76
|
+
}
|
|
77
|
+
catch {
|
|
78
|
+
/* A missing home/profile cannot provide a private diagnostic location. */
|
|
79
|
+
}
|
|
80
|
+
if (typeof vm.SourceTextModule !== "function") {
|
|
81
|
+
diagnose("vm_modules_required", false);
|
|
82
|
+
return 0; // Permanent local launch configuration; a supervisor must not spin.
|
|
83
|
+
}
|
|
84
|
+
const config = loadProfileConfig(profile, options.home);
|
|
85
|
+
diagnosticRoot = config.root;
|
|
86
|
+
const bootId = newId("boot");
|
|
87
|
+
const defaults = maintenanceRuntimeOptions(config);
|
|
88
|
+
const configure = options.runtime?.configureMaintenance ?? defaults.configureMaintenance;
|
|
89
|
+
await reconnectControl({
|
|
90
|
+
serverUrl: config.serverUrl,
|
|
91
|
+
token: config.token,
|
|
92
|
+
profile,
|
|
93
|
+
bootId,
|
|
94
|
+
version: options.version,
|
|
95
|
+
signal,
|
|
96
|
+
async ready(connection) {
|
|
97
|
+
try {
|
|
98
|
+
if (stopping)
|
|
99
|
+
throw new AgentError("runtime_closed", "The Agent is stopping.");
|
|
100
|
+
if (runtime)
|
|
101
|
+
runtime.attachConnection(connection);
|
|
102
|
+
else {
|
|
103
|
+
initializing = AgentRuntime.create(config, connection, bootId, {
|
|
104
|
+
version: options.version,
|
|
105
|
+
home: options.home,
|
|
106
|
+
...defaults,
|
|
107
|
+
...options.runtime,
|
|
108
|
+
async configureMaintenance(components) {
|
|
109
|
+
reserve = components.reserve;
|
|
110
|
+
return await configure(components);
|
|
111
|
+
},
|
|
112
|
+
});
|
|
113
|
+
try {
|
|
114
|
+
runtime = await initializing;
|
|
115
|
+
}
|
|
116
|
+
finally {
|
|
117
|
+
initializing = undefined;
|
|
118
|
+
}
|
|
119
|
+
if (!stopping) {
|
|
120
|
+
git = new WorkGitSchedule(config.root, (code) => diagnose(code, false), reserve);
|
|
121
|
+
git.start();
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
if (stopping)
|
|
125
|
+
return;
|
|
126
|
+
diagnose("agent_connected", false);
|
|
127
|
+
}
|
|
128
|
+
catch (cause) {
|
|
129
|
+
if (!stopping)
|
|
130
|
+
failure = cause;
|
|
131
|
+
void shutdown();
|
|
132
|
+
throw cause;
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
invoke(message, observer) {
|
|
136
|
+
if (!runtime || stopping)
|
|
137
|
+
throw new AgentError("runtime_unavailable", "The Agent has not initialized.");
|
|
138
|
+
return runtime.dispatch(message, observer);
|
|
139
|
+
},
|
|
140
|
+
async event(message, observer) {
|
|
141
|
+
if (!runtime || stopping)
|
|
142
|
+
throw new AgentError("runtime_unavailable", "The Agent has not initialized.");
|
|
143
|
+
await runtime.event(message, observer);
|
|
144
|
+
},
|
|
145
|
+
}, diagnose);
|
|
146
|
+
if (failure)
|
|
147
|
+
throw failure;
|
|
148
|
+
return 0;
|
|
149
|
+
}
|
|
150
|
+
catch (cause) {
|
|
151
|
+
const code = isAgentError(cause) ? cause.code : "agent_failed";
|
|
152
|
+
diagnose(/^[a-z0-9_]{1,128}$/.test(code) ? code : "agent_failed", false);
|
|
153
|
+
return code === "invalid_configuration" ? 0 : 1;
|
|
154
|
+
}
|
|
155
|
+
finally {
|
|
156
|
+
options.signal?.removeEventListener("abort", stop);
|
|
157
|
+
try {
|
|
158
|
+
await shutdown();
|
|
159
|
+
}
|
|
160
|
+
catch {
|
|
161
|
+
diagnose("agent_shutdown_unconfirmed", false);
|
|
162
|
+
// This overrides a normal return; do not report successful cleanup.
|
|
163
|
+
throw new AgentError("agent_shutdown_unconfirmed", "The Agent's native resources have not confirmed closure.");
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
//# sourceMappingURL=main.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/application/main.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { WireInvokeV2 } from "../contracts/wire.js";
|
|
2
|
+
import { MaintenanceRequests, type MaintenanceAuthority, type MaintenanceBackend, type MaintenanceScope } from "../maintenance/requests.js";
|
|
3
|
+
import type { ProfileConfiguration } from "./config.js";
|
|
4
|
+
import type { ApplicationComponents, AgentRuntimeOptions } from "./runtime.js";
|
|
5
|
+
/** The six authority methods use the authenticated connection; scripts cannot mint decisions. */
|
|
6
|
+
export declare class ControlMaintenanceAuthority implements MaintenanceAuthority {
|
|
7
|
+
#private;
|
|
8
|
+
readonly components: ApplicationComponents;
|
|
9
|
+
constructor(components: ApplicationComponents);
|
|
10
|
+
create: MaintenanceAuthority["create"];
|
|
11
|
+
get: MaintenanceAuthority["get"];
|
|
12
|
+
list: MaintenanceAuthority["list"];
|
|
13
|
+
cancel: MaintenanceAuthority["cancel"];
|
|
14
|
+
decision: MaintenanceAuthority["decision"];
|
|
15
|
+
beginExecution: MaintenanceAuthority["beginExecution"];
|
|
16
|
+
}
|
|
17
|
+
/** Transport adaptation around the existing maintenance operation and native controller. */
|
|
18
|
+
export declare class MaintenanceApplication {
|
|
19
|
+
#private;
|
|
20
|
+
readonly components: ApplicationComponents;
|
|
21
|
+
readonly requests: MaintenanceRequests;
|
|
22
|
+
constructor(components: ApplicationComponents, backend: MaintenanceBackend, approvalOrigin: string);
|
|
23
|
+
dispatch(message: WireInvokeV2, scope: MaintenanceScope, observerSignal: AbortSignal): Promise<unknown>;
|
|
24
|
+
close(): Promise<void>;
|
|
25
|
+
}
|
|
26
|
+
/** Npm and connection configuration share the same confirmed authority and lifecycle. */
|
|
27
|
+
export declare function maintenanceRuntimeOptions(config: ProfileConfiguration, configuration?: (components: ApplicationComponents) => MaintenanceBackend | Promise<MaintenanceBackend>): Pick<AgentRuntimeOptions, "configureMaintenance" | "dispatchMaintenance">;
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
2
|
+
import { callerKey } from "../contracts/caller.js";
|
|
3
|
+
import { canonicalJson, isPlainRecord } from "../contracts/json.js";
|
|
4
|
+
import { validateContract } from "../contracts/validation.js";
|
|
5
|
+
import { MaintenanceRequests, } from "../maintenance/requests.js";
|
|
6
|
+
import { MaintenanceBackends, NpmMaintenanceBackend, } from "../maintenance/npm.js";
|
|
7
|
+
const plain = (value) => JSON.parse(canonicalJson(value));
|
|
8
|
+
/** The six authority methods use the authenticated connection; scripts cannot mint decisions. */
|
|
9
|
+
export class ControlMaintenanceAuthority {
|
|
10
|
+
components;
|
|
11
|
+
constructor(components) {
|
|
12
|
+
this.components = components;
|
|
13
|
+
}
|
|
14
|
+
#context(identity) {
|
|
15
|
+
const { store } = this.components;
|
|
16
|
+
for (const key of ["agentId", "profile", "cloudEnvironment"])
|
|
17
|
+
requireCondition(identity[key] === store.binding[key], "maintenance_binding_mismatch", "Maintenance belongs to this Agent profile only.");
|
|
18
|
+
const caller = {
|
|
19
|
+
principalId: identity.principalId,
|
|
20
|
+
clientId: identity.clientId,
|
|
21
|
+
grantId: identity.grantId,
|
|
22
|
+
};
|
|
23
|
+
requireCondition(callerKey(caller) === identity.callerKey, "maintenance_binding_mismatch", "The verified maintenance caller does not match its identity.");
|
|
24
|
+
return this.components.context(caller);
|
|
25
|
+
}
|
|
26
|
+
async #request(identity, operation, input, signal) {
|
|
27
|
+
return await this.components
|
|
28
|
+
.control()
|
|
29
|
+
.request(operation, this.#context(identity), input, signal);
|
|
30
|
+
}
|
|
31
|
+
create = async (who, input, signal) => plain(await this.#request(who, "maintenance.request.create", input, signal));
|
|
32
|
+
get = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.get", { requestId }, signal));
|
|
33
|
+
list = async (who, options, signal) => plain(await this.#request(who, "maintenance.request.list", options, signal));
|
|
34
|
+
cancel = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.cancel", { requestId }, signal));
|
|
35
|
+
decision = async (who, requestId, signal) => plain(await this.#request(who, "maintenance.request.decision", { requestId }, signal));
|
|
36
|
+
beginExecution = async (who, input, signal) => plain(await this.#request(who, "maintenance.request.beginExecution", input, signal));
|
|
37
|
+
}
|
|
38
|
+
function observe(promise, signal) {
|
|
39
|
+
signal.throwIfAborted();
|
|
40
|
+
return new Promise((resolve, reject) => {
|
|
41
|
+
const abort = () => reject(signal.reason);
|
|
42
|
+
signal.addEventListener("abort", abort, { once: true });
|
|
43
|
+
void promise
|
|
44
|
+
.then(resolve, reject)
|
|
45
|
+
.finally(() => signal.removeEventListener("abort", abort));
|
|
46
|
+
if (signal.aborted)
|
|
47
|
+
abort();
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
/** Transport adaptation around the existing maintenance operation and native controller. */
|
|
51
|
+
export class MaintenanceApplication {
|
|
52
|
+
components;
|
|
53
|
+
requests;
|
|
54
|
+
#executions = new Map();
|
|
55
|
+
#pending = new Set();
|
|
56
|
+
#closed = false;
|
|
57
|
+
#unregister;
|
|
58
|
+
constructor(components, backend, approvalOrigin) {
|
|
59
|
+
this.components = components;
|
|
60
|
+
this.requests = new MaintenanceRequests(components.store, new ControlMaintenanceAuthority(components), backend, { approvalOrigin, reserve: components.reserve });
|
|
61
|
+
this.#unregister = components.onShutdown(() => this.close());
|
|
62
|
+
}
|
|
63
|
+
#scope(scope, signal) {
|
|
64
|
+
return {
|
|
65
|
+
...scope,
|
|
66
|
+
signal: AbortSignal.any([scope.signal, signal, this.components.signal]),
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
async #current(requestId, revision, scope) {
|
|
70
|
+
const view = await this.requests.get(requestId, scope);
|
|
71
|
+
requireCondition(revision === undefined || revision === view.revision, "maintenance_revision_conflict", "The maintenance request changed; reload its current revision.");
|
|
72
|
+
return view;
|
|
73
|
+
}
|
|
74
|
+
#start(message, scope) {
|
|
75
|
+
const requestId = message.input.requestId;
|
|
76
|
+
const previous = this.#executions.get(requestId);
|
|
77
|
+
if (previous) {
|
|
78
|
+
requireCondition(previous.callerKey === callerKey(scope.caller) &&
|
|
79
|
+
previous.grantId === scope.caller.grantId, "maintenance_binding_mismatch", "The execution belongs to its original caller and Grant.");
|
|
80
|
+
return previous;
|
|
81
|
+
}
|
|
82
|
+
requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
|
|
83
|
+
const controller = new AbortController();
|
|
84
|
+
const accepted = Promise.withResolvers();
|
|
85
|
+
// The Core operation is independent of the observing WebSocket and the original script.
|
|
86
|
+
const signal = AbortSignal.any([controller.signal, this.components.signal]);
|
|
87
|
+
const lease = this.components.startLease(scope.caller, { maintenanceRequestId: requestId, originInvocationId: message.id }, signal);
|
|
88
|
+
const executionScope = {
|
|
89
|
+
...lease.scope,
|
|
90
|
+
onAccepted: () => accepted.resolve(),
|
|
91
|
+
};
|
|
92
|
+
const task = (async () => {
|
|
93
|
+
await lease.refresh();
|
|
94
|
+
return await this.requests.execute(requestId, executionScope);
|
|
95
|
+
})();
|
|
96
|
+
const entry = {
|
|
97
|
+
controller,
|
|
98
|
+
callerKey: callerKey(scope.caller),
|
|
99
|
+
grantId: scope.caller.grantId,
|
|
100
|
+
accepted: accepted.promise,
|
|
101
|
+
task,
|
|
102
|
+
};
|
|
103
|
+
this.#executions.set(requestId, entry);
|
|
104
|
+
void accepted.promise.catch(() => { });
|
|
105
|
+
void task
|
|
106
|
+
.then(() => accepted.resolve(), (error) => accepted.reject(error))
|
|
107
|
+
.finally(() => {
|
|
108
|
+
lease.close();
|
|
109
|
+
if (this.#executions.get(requestId) === entry)
|
|
110
|
+
this.#executions.delete(requestId);
|
|
111
|
+
});
|
|
112
|
+
// Retain errors on the real Promise without introducing an unhandled rejection.
|
|
113
|
+
void task.catch(() => { });
|
|
114
|
+
return entry;
|
|
115
|
+
}
|
|
116
|
+
async dispatch(message, scope, observerSignal) {
|
|
117
|
+
requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
|
|
118
|
+
const pending = this.#dispatch(message, scope, observerSignal);
|
|
119
|
+
this.#pending.add(pending);
|
|
120
|
+
try {
|
|
121
|
+
return await pending;
|
|
122
|
+
}
|
|
123
|
+
finally {
|
|
124
|
+
this.#pending.delete(pending);
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
async #dispatch(message, scope, observerSignal) {
|
|
128
|
+
requireCondition(!this.#closed, "runtime_closed", "The Agent is stopping.");
|
|
129
|
+
const input = message.input;
|
|
130
|
+
const reading = this.#scope(scope, observerSignal);
|
|
131
|
+
if (message.operation === "agent.maintenance.get")
|
|
132
|
+
return await this.requests.get(input.requestId, reading);
|
|
133
|
+
if (message.operation === "agent.maintenance.execute") {
|
|
134
|
+
const current = await this.#current(input.requestId, undefined, reading);
|
|
135
|
+
if (this.components.store.getMaintenanceOperation(input.requestId))
|
|
136
|
+
return current;
|
|
137
|
+
const entry = this.#start(message, scope);
|
|
138
|
+
await observe(entry.accepted, observerSignal);
|
|
139
|
+
return await this.requests.get(input.requestId, reading);
|
|
140
|
+
}
|
|
141
|
+
if (message.operation === "agent.maintenance.cancel") {
|
|
142
|
+
const current = await this.#current(input.requestId, undefined, reading);
|
|
143
|
+
const entry = this.#executions.get(input.requestId);
|
|
144
|
+
if (!entry)
|
|
145
|
+
return current.execution
|
|
146
|
+
? current
|
|
147
|
+
: await this.requests.cancel(input.requestId, reading);
|
|
148
|
+
requireCondition(entry.callerKey === callerKey(scope.caller) &&
|
|
149
|
+
entry.grantId === scope.caller.grantId, "maintenance_binding_mismatch", "The execution belongs to its original caller and Grant.");
|
|
150
|
+
entry.controller.abort(new AgentError("maintenance_cancelled", "The user requested maintenance cancellation."));
|
|
151
|
+
await observe(entry.task.catch(() => { }), observerSignal);
|
|
152
|
+
return await this.requests.get(input.requestId, reading);
|
|
153
|
+
}
|
|
154
|
+
await this.#current(input.requestId, input.revision, reading);
|
|
155
|
+
if (message.operation === "agent.maintenance.draft.notify")
|
|
156
|
+
return { requestId: input.requestId, notified: true };
|
|
157
|
+
if (message.operation === "agent.maintenance.draft.verify")
|
|
158
|
+
return await this.requests.verify(input.requestId, reading);
|
|
159
|
+
let result;
|
|
160
|
+
if (message.operation === "agent.maintenance.draft.read")
|
|
161
|
+
result = await this.requests.readDraft(input.requestId, reading);
|
|
162
|
+
else {
|
|
163
|
+
requireCondition(input.body &&
|
|
164
|
+
input.revision !== undefined &&
|
|
165
|
+
input.body.purpose === "maintenance" &&
|
|
166
|
+
input.body.direction === "cloud-to-agent" &&
|
|
167
|
+
input.body.mimeType === "application/json", "invalid_maintenance_body", "Use the authenticated fixed maintenance JSON channel.");
|
|
168
|
+
requireCondition(input.body.size <= 512 * 1024, "invalid_maintenance_body", "The maintenance input exceeds its byte budget.");
|
|
169
|
+
const permit = this.components.streams.tryAcquire();
|
|
170
|
+
requireCondition(permit, "transfer_busy", "All actual file stream slots are occupied.");
|
|
171
|
+
let value;
|
|
172
|
+
try {
|
|
173
|
+
value = await this.components
|
|
174
|
+
.data()
|
|
175
|
+
.readJson(input.body, reading.signal);
|
|
176
|
+
}
|
|
177
|
+
finally {
|
|
178
|
+
permit.release();
|
|
179
|
+
}
|
|
180
|
+
requireCondition(isPlainRecord(value), "invalid_maintenance_body", "The maintenance body must be an object.");
|
|
181
|
+
reading.assertCurrent();
|
|
182
|
+
if (message.operation === "agent.maintenance.draft.prepare") {
|
|
183
|
+
validateContract("wire.body:MaintenanceDraftInput", value);
|
|
184
|
+
requireCondition(value.revision === input.revision, "maintenance_revision_conflict", "The body revision differs from its control request.");
|
|
185
|
+
result = await this.requests.prepareDraft(input.requestId, value, reading);
|
|
186
|
+
}
|
|
187
|
+
else if (message.operation === "agent.maintenance.oauth.start") {
|
|
188
|
+
validateContract("wire.body:MaintenanceOAuthBinding", value);
|
|
189
|
+
result = await this.requests.startOAuth(input.requestId, input.revision, value, reading);
|
|
190
|
+
}
|
|
191
|
+
else if (message.operation === "agent.maintenance.oauth.complete") {
|
|
192
|
+
validateContract("wire.body:MaintenanceOAuthComplete", value);
|
|
193
|
+
result = await this.requests.completeOAuth(input.requestId, input.revision, value, reading);
|
|
194
|
+
}
|
|
195
|
+
else
|
|
196
|
+
throw new AgentError("unknown_operation", "This maintenance operation is not registered.");
|
|
197
|
+
}
|
|
198
|
+
const contract = message.operation === "agent.maintenance.draft.read"
|
|
199
|
+
? "MaintenanceDraftRead"
|
|
200
|
+
: message.operation === "agent.maintenance.oauth.start"
|
|
201
|
+
? "MaintenanceOAuthLaunch"
|
|
202
|
+
: "MaintenancePrepared";
|
|
203
|
+
validateContract(`wire.body:${contract}`, result);
|
|
204
|
+
reading.assertCurrent();
|
|
205
|
+
const object = JSON.parse(canonicalJson(result, 1024 * 1024));
|
|
206
|
+
return {
|
|
207
|
+
body: await this.components.shipJson(object, "maintenance", reading.signal, message.context, message.id),
|
|
208
|
+
};
|
|
209
|
+
}
|
|
210
|
+
async close() {
|
|
211
|
+
this.#closed = true;
|
|
212
|
+
this.#unregister();
|
|
213
|
+
const active = [...this.#executions.values()];
|
|
214
|
+
for (const entry of active)
|
|
215
|
+
entry.controller.abort(new AgentError("runtime_closed", "The Agent is stopping."));
|
|
216
|
+
await Promise.allSettled(active.map((entry) => entry.task));
|
|
217
|
+
await Promise.allSettled([...this.#pending]);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
/** Npm and connection configuration share the same confirmed authority and lifecycle. */
|
|
221
|
+
export function maintenanceRuntimeOptions(config, configuration) {
|
|
222
|
+
let application;
|
|
223
|
+
return {
|
|
224
|
+
async configureMaintenance(components) {
|
|
225
|
+
const npm = new NpmMaintenanceBackend({
|
|
226
|
+
root: config.root,
|
|
227
|
+
modules: components.modules,
|
|
228
|
+
extensions: components.extensions,
|
|
229
|
+
enablement: components.enablement,
|
|
230
|
+
refreshPackages: components.refreshPackages,
|
|
231
|
+
reserve: components.reserve,
|
|
232
|
+
});
|
|
233
|
+
application = new MaintenanceApplication(components, new MaintenanceBackends(npm, configuration
|
|
234
|
+
? await configuration(components)
|
|
235
|
+
: await components.configurationBackend()), config.serverUrl);
|
|
236
|
+
return application.requests;
|
|
237
|
+
},
|
|
238
|
+
async dispatchMaintenance(message, scope, _components, _service, observerSignal) {
|
|
239
|
+
requireCondition(application, "maintenance_unavailable", "The maintenance service has not initialized.");
|
|
240
|
+
return await application.dispatch(message, scope, observerSignal);
|
|
241
|
+
},
|
|
242
|
+
};
|
|
243
|
+
}
|
|
244
|
+
//# sourceMappingURL=maintenance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/application/maintenance.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { Profile } from "../contracts/types.js";
|
|
2
|
+
import type { VerifiedPackageSnapshot } from "../maintenance/npm.js";
|
|
3
|
+
/** Private explicit package approvals; the work manifest and installed packages never grant approval. */
|
|
4
|
+
export declare class ApprovedPackageCatalog {
|
|
5
|
+
#private;
|
|
6
|
+
readonly root: string;
|
|
7
|
+
readonly binding: Readonly<{
|
|
8
|
+
agentId: string;
|
|
9
|
+
profile: Profile;
|
|
10
|
+
}>;
|
|
11
|
+
readonly reserve?: ((bytes: number) => Promise<{
|
|
12
|
+
release(): void;
|
|
13
|
+
}>) | undefined;
|
|
14
|
+
private constructor();
|
|
15
|
+
static open(root: string, binding: {
|
|
16
|
+
agentId: string;
|
|
17
|
+
profile: Profile;
|
|
18
|
+
}, options?: {
|
|
19
|
+
reserve?: (bytes: number) => Promise<{
|
|
20
|
+
release(): void;
|
|
21
|
+
}>;
|
|
22
|
+
}): Promise<ApprovedPackageCatalog>;
|
|
23
|
+
approvedPackages(): ReadonlyMap<string, string>;
|
|
24
|
+
accept(snapshot: VerifiedPackageSnapshot): Promise<void>;
|
|
25
|
+
}
|