@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,465 @@
|
|
|
1
|
+
import { hostname } from "node:os";
|
|
2
|
+
import { setTimeout as delay } from "node:timers/promises";
|
|
3
|
+
import WebSocket from "ws";
|
|
4
|
+
import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
|
|
5
|
+
import { canonicalJson, isPlainRecord, newId } from "../contracts/json.js";
|
|
6
|
+
import { validateServerUrl, validateAgentToken } from "./config.js";
|
|
7
|
+
import { safeErrorData } from "../contracts/error-data.js";
|
|
8
|
+
import { validateContract } from "../contracts/validation.js";
|
|
9
|
+
const maximum = 1024 * 1024;
|
|
10
|
+
const reverseOperations = new Set([
|
|
11
|
+
"transfer.prepare",
|
|
12
|
+
"transfer.revoke",
|
|
13
|
+
"authorization.refresh",
|
|
14
|
+
"host.request",
|
|
15
|
+
"attachment.open",
|
|
16
|
+
"stream.prepare",
|
|
17
|
+
"stream.revoke",
|
|
18
|
+
"maintenance.request.create",
|
|
19
|
+
"maintenance.request.get",
|
|
20
|
+
"maintenance.request.list",
|
|
21
|
+
"maintenance.request.cancel",
|
|
22
|
+
"maintenance.request.decision",
|
|
23
|
+
"maintenance.request.beginExecution",
|
|
24
|
+
"state.user.get",
|
|
25
|
+
"state.user.set",
|
|
26
|
+
"state.user.delete",
|
|
27
|
+
]);
|
|
28
|
+
const cloudEvents = new Set([
|
|
29
|
+
"agent.catalog.sync",
|
|
30
|
+
"agent.authorization.changed",
|
|
31
|
+
]);
|
|
32
|
+
const permanent = new Map([
|
|
33
|
+
["invalid_agent_credential", 401],
|
|
34
|
+
["agent_already_connected", 409],
|
|
35
|
+
["unsupported_protocol", 400],
|
|
36
|
+
["invalid_agent_metadata", 400],
|
|
37
|
+
["unsupported_agent_environment", 400],
|
|
38
|
+
]);
|
|
39
|
+
export class ConnectionRejection extends AgentError {
|
|
40
|
+
status;
|
|
41
|
+
rejectionCode;
|
|
42
|
+
constructor(status, rejectionCode) {
|
|
43
|
+
super("connection_rejected", "The Agent connection was rejected.");
|
|
44
|
+
this.status = status;
|
|
45
|
+
this.rejectionCode = rejectionCode;
|
|
46
|
+
}
|
|
47
|
+
get stopNoRestart() {
|
|
48
|
+
return (this.rejectionCode !== null &&
|
|
49
|
+
permanent.get(this.rejectionCode) === this.status);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
function header(response, name) {
|
|
53
|
+
const value = response.headers[name];
|
|
54
|
+
const occurrences = response.rawHeaders.filter((_value, index) => index % 2 === 0 && _value.toLowerCase() === name).length;
|
|
55
|
+
requireCondition(occurrences === 1 &&
|
|
56
|
+
typeof value === "string" &&
|
|
57
|
+
value.length > 0 &&
|
|
58
|
+
value.length <= 256 &&
|
|
59
|
+
value.trim() === value &&
|
|
60
|
+
!/[\0\r\n]/.test(value), "invalid_connection_binding", "The authenticated Upgrade response is missing a unique bounded connection identity.");
|
|
61
|
+
return value;
|
|
62
|
+
}
|
|
63
|
+
function remoteError(error) {
|
|
64
|
+
const safe = safeErrorData(error, {
|
|
65
|
+
code: "agent_error",
|
|
66
|
+
message: "The Agent operation failed.",
|
|
67
|
+
});
|
|
68
|
+
// Codes locate the failure; transport errors never echo native/plugin messages or secrets.
|
|
69
|
+
const result = {
|
|
70
|
+
code: typeof safe.code === "string" && /^[a-z0-9_]{1,128}$/.test(safe.code)
|
|
71
|
+
? safe.code
|
|
72
|
+
: "agent_error",
|
|
73
|
+
message: "The Agent operation failed.",
|
|
74
|
+
};
|
|
75
|
+
// A response projection failure must not hide the already accepted Run's
|
|
76
|
+
// identity. Only these two public facts are safe; plugin/native details stay local.
|
|
77
|
+
const details = safe.details;
|
|
78
|
+
if (result.code === "run_context_too_large" &&
|
|
79
|
+
isPlainRecord(details) &&
|
|
80
|
+
typeof details.runId === "string" &&
|
|
81
|
+
/^run_[0-9a-f]{32}$/.test(details.runId) &&
|
|
82
|
+
typeof details.status === "string" &&
|
|
83
|
+
[
|
|
84
|
+
"accepted",
|
|
85
|
+
"preparing_inputs",
|
|
86
|
+
"running",
|
|
87
|
+
"waiting_input",
|
|
88
|
+
"cancelling",
|
|
89
|
+
"succeeded",
|
|
90
|
+
"failed",
|
|
91
|
+
"cancelled",
|
|
92
|
+
"interrupted",
|
|
93
|
+
].includes(details.status)) {
|
|
94
|
+
result.details = { runId: details.runId, status: details.status };
|
|
95
|
+
}
|
|
96
|
+
return result;
|
|
97
|
+
}
|
|
98
|
+
/** One actual socket and its observation RPCs; accepted Run lifetime belongs to RunEngine. */
|
|
99
|
+
export class ControlConnection {
|
|
100
|
+
binding;
|
|
101
|
+
closed;
|
|
102
|
+
signal;
|
|
103
|
+
#socket;
|
|
104
|
+
#options;
|
|
105
|
+
#controller = new AbortController();
|
|
106
|
+
#closure = Promise.withResolvers();
|
|
107
|
+
#pending = new Map();
|
|
108
|
+
#incoming = new Map();
|
|
109
|
+
#queuedBytes = 0;
|
|
110
|
+
#stopped = false;
|
|
111
|
+
#ready = false;
|
|
112
|
+
#initial = [];
|
|
113
|
+
#initialBytes = 0;
|
|
114
|
+
#events = Promise.resolve();
|
|
115
|
+
#eventCount = 0;
|
|
116
|
+
#abort;
|
|
117
|
+
constructor(socket, binding, options) {
|
|
118
|
+
this.#socket = socket;
|
|
119
|
+
this.binding = Object.freeze(binding);
|
|
120
|
+
this.#options = options;
|
|
121
|
+
this.signal = this.#controller.signal;
|
|
122
|
+
this.closed = this.#closure.promise;
|
|
123
|
+
this.#abort = () => this.close();
|
|
124
|
+
options.signal.addEventListener("abort", this.#abort, { once: true });
|
|
125
|
+
socket.on("message", (data, binary) => this.#receive(data, binary));
|
|
126
|
+
socket.on("close", () => this.#closed());
|
|
127
|
+
// A WebSocket error is followed by close. Do not report an early fake closure.
|
|
128
|
+
socket.on("error", () => {
|
|
129
|
+
if (socket.readyState !== WebSocket.CLOSED)
|
|
130
|
+
socket.terminate();
|
|
131
|
+
});
|
|
132
|
+
if (options.signal.aborted)
|
|
133
|
+
this.close();
|
|
134
|
+
}
|
|
135
|
+
static async connect(options) {
|
|
136
|
+
options.signal.throwIfAborted();
|
|
137
|
+
const url = validateServerUrl(options.serverUrl, options.profile);
|
|
138
|
+
validateAgentToken(options.token);
|
|
139
|
+
requireCondition(/^boot_[0-9a-f]{32}$/.test(options.bootId) &&
|
|
140
|
+
/^[\x21-\x7e]{1,128}$/.test(options.version), "invalid_configuration", "The selected Agent runtime metadata is invalid.");
|
|
141
|
+
url.pathname = url.pathname.replace(/\/+$/, "") + "/agent/connect";
|
|
142
|
+
url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
|
|
143
|
+
const socket = new WebSocket(url, {
|
|
144
|
+
headers: {
|
|
145
|
+
Authorization: `Bearer ${options.token}`,
|
|
146
|
+
"X-Nexum-Protocol-Version": "2",
|
|
147
|
+
"X-Nexum-Agent-Version": options.version,
|
|
148
|
+
"X-Nexum-Platform": process.platform === "win32" ? "windows" : process.platform,
|
|
149
|
+
"X-Nexum-Arch": process.arch === "x64" ? "amd64" : process.arch,
|
|
150
|
+
...(/^[\x21-\x7e]{1,255}$/.test(hostname())
|
|
151
|
+
? { "X-Nexum-Hostname": hostname() }
|
|
152
|
+
: {}),
|
|
153
|
+
"X-Nexum-Profile": options.profile,
|
|
154
|
+
"X-Nexum-Boot-Id": options.bootId,
|
|
155
|
+
},
|
|
156
|
+
maxPayload: maximum,
|
|
157
|
+
perMessageDeflate: false,
|
|
158
|
+
followRedirects: false,
|
|
159
|
+
handshakeTimeout: 10000,
|
|
160
|
+
});
|
|
161
|
+
const opening = Promise.withResolvers();
|
|
162
|
+
let connection;
|
|
163
|
+
let failure;
|
|
164
|
+
const abort = () => {
|
|
165
|
+
failure = options.signal.reason;
|
|
166
|
+
socket.terminate();
|
|
167
|
+
};
|
|
168
|
+
options.signal.addEventListener("abort", abort, { once: true });
|
|
169
|
+
socket.on("upgrade", (response) => {
|
|
170
|
+
try {
|
|
171
|
+
connection = new ControlConnection(socket, {
|
|
172
|
+
agentId: header(response, "x-nexum-agent-id"),
|
|
173
|
+
cloudEnvironment: header(response, "x-nexum-cloud-environment"),
|
|
174
|
+
connectionId: header(response, "x-nexum-connection-id"),
|
|
175
|
+
profile: options.profile,
|
|
176
|
+
bootId: options.bootId,
|
|
177
|
+
}, options);
|
|
178
|
+
requireCondition(connection.binding.cloudEnvironment === options.profile, "invalid_connection_binding", "The Cloud environment does not match the selected profile.");
|
|
179
|
+
}
|
|
180
|
+
catch (cause) {
|
|
181
|
+
failure = cause;
|
|
182
|
+
socket.terminate();
|
|
183
|
+
}
|
|
184
|
+
});
|
|
185
|
+
socket.once("unexpected-response", (_request, response) => {
|
|
186
|
+
const code = response.headers["x-nexum-error-code"];
|
|
187
|
+
failure = new ConnectionRejection(response.statusCode ?? 0, typeof code === "string" && permanent.has(code) ? code : null);
|
|
188
|
+
response.destroy();
|
|
189
|
+
socket.terminate();
|
|
190
|
+
});
|
|
191
|
+
socket.once("error", () => {
|
|
192
|
+
failure ??= new AgentError("connection_failed", "The Agent connection could not be established.");
|
|
193
|
+
});
|
|
194
|
+
socket.once("close", () => {
|
|
195
|
+
options.signal.removeEventListener("abort", abort);
|
|
196
|
+
opening.reject(failure ??
|
|
197
|
+
new AgentError("connection_closed", "The Agent connection closed before admission."));
|
|
198
|
+
});
|
|
199
|
+
socket.once("open", () => {
|
|
200
|
+
void (async () => {
|
|
201
|
+
try {
|
|
202
|
+
requireCondition(connection, "invalid_connection_binding", "No authenticated connection identity was received.");
|
|
203
|
+
await options.ready(connection);
|
|
204
|
+
connection.signal.throwIfAborted();
|
|
205
|
+
connection.#ready = true;
|
|
206
|
+
const messages = connection.#initial;
|
|
207
|
+
connection.#initial = [];
|
|
208
|
+
connection.#initialBytes = 0;
|
|
209
|
+
for (const item of messages)
|
|
210
|
+
connection.#message(item.message);
|
|
211
|
+
opening.resolve(connection);
|
|
212
|
+
}
|
|
213
|
+
catch (cause) {
|
|
214
|
+
failure = cause;
|
|
215
|
+
socket.terminate();
|
|
216
|
+
}
|
|
217
|
+
})();
|
|
218
|
+
});
|
|
219
|
+
try {
|
|
220
|
+
return await opening.promise;
|
|
221
|
+
}
|
|
222
|
+
finally {
|
|
223
|
+
options.signal.removeEventListener("abort", abort);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
#current() {
|
|
227
|
+
this.signal.throwIfAborted();
|
|
228
|
+
requireCondition(!this.#stopped && this.#socket.readyState === WebSocket.OPEN, "connection_closed", "The observation connection is no longer open.");
|
|
229
|
+
}
|
|
230
|
+
async send(message) {
|
|
231
|
+
this.#current();
|
|
232
|
+
validateContract("wire", message);
|
|
233
|
+
const text = canonicalJson(message, maximum), bytes = Buffer.byteLength(text);
|
|
234
|
+
requireCondition(this.#queuedBytes + bytes <= 4 * maximum, "control_busy", "The control connection's output budget is occupied.");
|
|
235
|
+
this.#queuedBytes += bytes;
|
|
236
|
+
try {
|
|
237
|
+
await new Promise((resolve, reject) => {
|
|
238
|
+
this.#socket.send(text, { binary: false, compress: false }, (error) => error ? reject(error) : resolve());
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
finally {
|
|
242
|
+
this.#queuedBytes -= bytes;
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
request(operation, context, input, signal, timeoutMs = 30000) {
|
|
246
|
+
this.#current();
|
|
247
|
+
signal.throwIfAborted();
|
|
248
|
+
requireCondition(this.#pending.size < 512 &&
|
|
249
|
+
Number.isSafeInteger(timeoutMs) &&
|
|
250
|
+
timeoutMs > 0 &&
|
|
251
|
+
timeoutMs <= 300000, "control_busy", "The control request budget or deadline is invalid.");
|
|
252
|
+
requireCondition(reverseOperations.has(operation), "invalid_control_direction", "The Agent cannot request a Cloud-to-Agent operation.");
|
|
253
|
+
this.#checkBinding(context.connection);
|
|
254
|
+
const id = newId("rpc_agent"), completion = Promise.withResolvers();
|
|
255
|
+
const stop = () => {
|
|
256
|
+
if (!this.#pending.delete(id))
|
|
257
|
+
return;
|
|
258
|
+
cleanup();
|
|
259
|
+
// Cancel ends this observation. It never claims that a remote side effect stopped.
|
|
260
|
+
void this.send({ type: "cancel", id }).catch(() => { });
|
|
261
|
+
completion.reject(signal.aborted
|
|
262
|
+
? signal.reason
|
|
263
|
+
: new AgentError("observation_timeout", "The control observation deadline expired."));
|
|
264
|
+
};
|
|
265
|
+
const timer = setTimeout(stop, timeoutMs);
|
|
266
|
+
timer.unref();
|
|
267
|
+
const cleanup = () => {
|
|
268
|
+
clearTimeout(timer);
|
|
269
|
+
signal.removeEventListener("abort", stop);
|
|
270
|
+
};
|
|
271
|
+
this.#pending.set(id, {
|
|
272
|
+
operation,
|
|
273
|
+
resolve: completion.resolve,
|
|
274
|
+
reject: completion.reject,
|
|
275
|
+
cleanup,
|
|
276
|
+
});
|
|
277
|
+
signal.addEventListener("abort", stop, { once: true });
|
|
278
|
+
void this.send({
|
|
279
|
+
type: "invoke",
|
|
280
|
+
id,
|
|
281
|
+
operation,
|
|
282
|
+
context,
|
|
283
|
+
input,
|
|
284
|
+
}).catch((cause) => {
|
|
285
|
+
const pending = this.#pending.get(id);
|
|
286
|
+
if (pending) {
|
|
287
|
+
this.#pending.delete(id);
|
|
288
|
+
pending.cleanup();
|
|
289
|
+
pending.reject(cause);
|
|
290
|
+
}
|
|
291
|
+
});
|
|
292
|
+
return completion.promise;
|
|
293
|
+
}
|
|
294
|
+
#checkBinding(value) {
|
|
295
|
+
requireCondition(Object.keys(this.binding).every((key) => value[key] ===
|
|
296
|
+
this.binding[key]), "connection_binding_mismatch", "The message targets a different authenticated connection.");
|
|
297
|
+
}
|
|
298
|
+
#receive(data, binary) {
|
|
299
|
+
try {
|
|
300
|
+
this.#current();
|
|
301
|
+
requireCondition(!binary, "invalid_control_message", "Binary payloads do not belong on the control connection.");
|
|
302
|
+
const bytes = Array.isArray(data)
|
|
303
|
+
? Buffer.concat(data)
|
|
304
|
+
: Buffer.from(data);
|
|
305
|
+
requireCondition(bytes.length <= maximum, "data_too_large", "The control message exceeds its budget.");
|
|
306
|
+
const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
|
|
307
|
+
const message = JSON.parse(text);
|
|
308
|
+
validateContract("wire", message);
|
|
309
|
+
if (!this.#ready &&
|
|
310
|
+
(message.type === "invoke" || message.type === "event")) {
|
|
311
|
+
if (message.type === "invoke")
|
|
312
|
+
requireCondition(!this.#initial.some((item) => item.message.type === "invoke" &&
|
|
313
|
+
item.message.id === message.id), "invalid_control_message", "An initialization request was duplicated.");
|
|
314
|
+
requireCondition(this.#initial.length < 64 &&
|
|
315
|
+
this.#initialBytes + bytes.length <= 4 * maximum, "control_busy", "Too much control input arrived during initialization.");
|
|
316
|
+
this.#initial.push({ message, bytes: bytes.length });
|
|
317
|
+
this.#initialBytes += bytes.length;
|
|
318
|
+
}
|
|
319
|
+
else
|
|
320
|
+
this.#message(message);
|
|
321
|
+
}
|
|
322
|
+
catch {
|
|
323
|
+
this.close();
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
#message(message) {
|
|
327
|
+
try {
|
|
328
|
+
this.#current();
|
|
329
|
+
if (message.type === "result" || message.type === "error") {
|
|
330
|
+
const pending = this.#pending.get(message.id);
|
|
331
|
+
// Late replies after a local observation cancel are discarded, never replayed.
|
|
332
|
+
if (!pending)
|
|
333
|
+
return;
|
|
334
|
+
if (message.type === "result")
|
|
335
|
+
requireCondition(message.operation === pending.operation, "invalid_control_message", "A control reply used a different operation identity.");
|
|
336
|
+
this.#pending.delete(message.id);
|
|
337
|
+
pending.cleanup();
|
|
338
|
+
if (message.type === "result")
|
|
339
|
+
pending.resolve(message.output);
|
|
340
|
+
else
|
|
341
|
+
pending.reject(new AgentError(message.error.code, message.error.message, message.error.details));
|
|
342
|
+
}
|
|
343
|
+
else if (message.type === "cancel") {
|
|
344
|
+
const queued = this.#initial.findIndex((item) => item.message.type === "invoke" && item.message.id === message.id);
|
|
345
|
+
if (queued !== -1) {
|
|
346
|
+
this.#initialBytes -= this.#initial[queued].bytes;
|
|
347
|
+
this.#initial.splice(queued, 1);
|
|
348
|
+
}
|
|
349
|
+
this.#incoming
|
|
350
|
+
.get(message.id)
|
|
351
|
+
?.abort(new AgentError("observation_cancelled", "The remote observer stopped waiting."));
|
|
352
|
+
}
|
|
353
|
+
else if (message.type === "invoke") {
|
|
354
|
+
this.#checkBinding(message.context.connection);
|
|
355
|
+
requireCondition(!reverseOperations.has(message.operation), "invalid_control_direction", "The Cloud cannot invoke an Agent-to-Cloud operation.");
|
|
356
|
+
requireCondition(!this.#incoming.has(message.id) && this.#incoming.size < 512, "control_busy", "The incoming control request is duplicated or the observation budget is occupied.");
|
|
357
|
+
const controller = new AbortController();
|
|
358
|
+
this.#incoming.set(message.id, controller);
|
|
359
|
+
const signal = AbortSignal.any([controller.signal, this.signal]);
|
|
360
|
+
void Promise.resolve()
|
|
361
|
+
.then(() => {
|
|
362
|
+
signal.throwIfAborted();
|
|
363
|
+
return this.#options.invoke(message, signal);
|
|
364
|
+
})
|
|
365
|
+
.then((output) => this.send({
|
|
366
|
+
type: "result",
|
|
367
|
+
id: message.id,
|
|
368
|
+
operation: message.operation,
|
|
369
|
+
output,
|
|
370
|
+
}), (cause) => this.send({
|
|
371
|
+
type: "error",
|
|
372
|
+
id: message.id,
|
|
373
|
+
error: remoteError(cause),
|
|
374
|
+
}))
|
|
375
|
+
.catch(() => {
|
|
376
|
+
this.close();
|
|
377
|
+
})
|
|
378
|
+
.finally(() => {
|
|
379
|
+
this.#incoming.delete(message.id);
|
|
380
|
+
});
|
|
381
|
+
}
|
|
382
|
+
else {
|
|
383
|
+
this.#checkBinding(message.connection);
|
|
384
|
+
requireCondition(cloudEvents.has(message.name), "invalid_control_direction", "The Cloud event direction is invalid.");
|
|
385
|
+
requireCondition(this.#eventCount < 64, "control_busy", "Too many control events are pending.");
|
|
386
|
+
this.#eventCount++;
|
|
387
|
+
this.#events = this.#events
|
|
388
|
+
.then(() => {
|
|
389
|
+
this.signal.throwIfAborted();
|
|
390
|
+
return this.#options.event(message, this.signal);
|
|
391
|
+
})
|
|
392
|
+
.catch(() => {
|
|
393
|
+
this.close();
|
|
394
|
+
})
|
|
395
|
+
.finally(() => {
|
|
396
|
+
this.#eventCount--;
|
|
397
|
+
});
|
|
398
|
+
}
|
|
399
|
+
}
|
|
400
|
+
catch {
|
|
401
|
+
this.close();
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
close() {
|
|
405
|
+
if (this.#stopped)
|
|
406
|
+
return;
|
|
407
|
+
this.#stopped = true;
|
|
408
|
+
this.#controller.abort(new AgentError("connection_closed", "The observation connection is closing."));
|
|
409
|
+
this.#socket.terminate();
|
|
410
|
+
}
|
|
411
|
+
#closed() {
|
|
412
|
+
this.#stopped = true;
|
|
413
|
+
this.#controller.abort(new AgentError("connection_closed", "The observation connection closed."));
|
|
414
|
+
this.#options.signal.removeEventListener("abort", this.#abort);
|
|
415
|
+
for (const pending of this.#pending.values()) {
|
|
416
|
+
pending.cleanup();
|
|
417
|
+
pending.reject(new AgentError("connection_closed", "The control observation ended without a confirmed reply."));
|
|
418
|
+
}
|
|
419
|
+
this.#pending.clear();
|
|
420
|
+
this.#incoming.clear();
|
|
421
|
+
this.#initial = [];
|
|
422
|
+
this.#initialBytes = 0;
|
|
423
|
+
this.#closure.resolve();
|
|
424
|
+
}
|
|
425
|
+
}
|
|
426
|
+
/** Reconnection only; the callback never replays previously accepted application requests. */
|
|
427
|
+
export async function reconnectControl(options, diagnose) {
|
|
428
|
+
let failures = 0;
|
|
429
|
+
while (!options.signal.aborted) {
|
|
430
|
+
try {
|
|
431
|
+
const connection = await ControlConnection.connect(options);
|
|
432
|
+
failures = 0;
|
|
433
|
+
await connection.closed;
|
|
434
|
+
}
|
|
435
|
+
catch (cause) {
|
|
436
|
+
if (options.signal.aborted)
|
|
437
|
+
break;
|
|
438
|
+
const local = isAgentError(cause) &&
|
|
439
|
+
Object.getOwnPropertyDescriptor(cause, "code")?.value ===
|
|
440
|
+
"invalid_configuration";
|
|
441
|
+
const stop = local || (cause instanceof ConnectionRejection && cause.stopNoRestart);
|
|
442
|
+
diagnose(local
|
|
443
|
+
? "invalid_configuration"
|
|
444
|
+
: cause instanceof ConnectionRejection
|
|
445
|
+
? (cause.rejectionCode ?? "connection_rejected")
|
|
446
|
+
: "connection_failed", !stop);
|
|
447
|
+
if (stop)
|
|
448
|
+
return "permanent";
|
|
449
|
+
}
|
|
450
|
+
if (options.signal.aborted)
|
|
451
|
+
break;
|
|
452
|
+
const wait = Math.min(30000, 1000 * 2 ** Math.min(failures++, 5));
|
|
453
|
+
try {
|
|
454
|
+
await delay(wait + Math.floor(Math.random() * 250), undefined, {
|
|
455
|
+
signal: options.signal,
|
|
456
|
+
});
|
|
457
|
+
}
|
|
458
|
+
catch {
|
|
459
|
+
if (!options.signal.aborted)
|
|
460
|
+
throw new AgentError("connection_failed", "The reconnect timer failed.");
|
|
461
|
+
}
|
|
462
|
+
}
|
|
463
|
+
return "stopped";
|
|
464
|
+
}
|
|
465
|
+
//# sourceMappingURL=connection.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/application/connection.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { Readable, type Writable } from "node:stream";
|
|
2
|
+
import type { JsonValue } from "../contracts/types.js";
|
|
3
|
+
import type { WireConnectionV2, WireStreamRefV2 } from "../contracts/wire.js";
|
|
4
|
+
export interface DataPlaneClaim {
|
|
5
|
+
readonly transferId: string;
|
|
6
|
+
readonly reservationId: string;
|
|
7
|
+
}
|
|
8
|
+
export interface DataPlaneRead {
|
|
9
|
+
readonly readable: Readable;
|
|
10
|
+
/** Settles after the local HTTP request, response, socket and consumer close. */
|
|
11
|
+
readonly closed: Promise<void>;
|
|
12
|
+
}
|
|
13
|
+
export interface DataPlaneWrite {
|
|
14
|
+
readonly writable: Writable;
|
|
15
|
+
/** Includes the actual Cloud consumer acknowledgement, beyond Writable.finish. */
|
|
16
|
+
readonly closed: Promise<void>;
|
|
17
|
+
}
|
|
18
|
+
export interface AgentDataPlaneOptions {
|
|
19
|
+
readonly serverUrl: string;
|
|
20
|
+
readonly token: string;
|
|
21
|
+
readonly binding: WireConnectionV2;
|
|
22
|
+
readonly maxBytes?: number;
|
|
23
|
+
readonly maxJsonBytes?: number;
|
|
24
|
+
assertCurrent(): void;
|
|
25
|
+
}
|
|
26
|
+
/** HTTP adaptation only. Core owns reservations, stream slots and transfer state. */
|
|
27
|
+
export declare class AgentDataPlane {
|
|
28
|
+
#private;
|
|
29
|
+
constructor(options: AgentDataPlaneOptions);
|
|
30
|
+
openRead(ref: WireStreamRefV2, signal: AbortSignal, claim?: DataPlaneClaim): Promise<DataPlaneRead>;
|
|
31
|
+
openWrite(ref: WireStreamRefV2, signal: AbortSignal, claim?: DataPlaneClaim): DataPlaneWrite;
|
|
32
|
+
sendFixedBody(ref: WireStreamRefV2, source: Readable | Uint8Array, signal: AbortSignal): Promise<void>;
|
|
33
|
+
readJson(ref: WireStreamRefV2, signal: AbortSignal): Promise<JsonValue>;
|
|
34
|
+
writeJson(ref: WireStreamRefV2, value: JsonValue, signal: AbortSignal): Promise<void>;
|
|
35
|
+
}
|