@nexum-hub/agent 0.0.0-stage → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +129 -2
- package/contracts/v2/common.schema.json +262 -0
- package/contracts/v2/fixtures/inputs.json +244 -0
- package/contracts/v2/fixtures/wire.json +6493 -0
- package/contracts/v2/model/agent.close.input.schema.json +14 -0
- package/contracts/v2/model/agent.close.output.schema.json +101 -0
- package/contracts/v2/model/agent.list.input.schema.json +57 -0
- package/contracts/v2/model/agent.list.output.schema.json +220 -0
- package/contracts/v2/model/agent.open.input.schema.json +35 -0
- package/contracts/v2/model/agent.open.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
- package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
- package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
- package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
- package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
- package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
- package/contracts/v2/wire/bodies.schema.json +383 -0
- package/contracts/v2/wire/envelope.schema.json +2280 -0
- package/contracts/v2/wire/events.schema.json +242 -0
- package/contracts/v2/wire/maintenance.schema.json +308 -0
- package/contracts/v2/wire/operations.schema.json +1791 -0
- package/contracts/v2/wire/stream.schema.json +74 -0
- package/contracts/v2/wire/types.schema.json +2616 -0
- package/dist/adapters/mcp-http.d.ts +22 -0
- package/dist/adapters/mcp-http.js +472 -0
- package/dist/adapters/mcp-http.js.map +1 -0
- package/dist/adapters/mcp-oauth.d.ts +29 -0
- package/dist/adapters/mcp-oauth.js +653 -0
- package/dist/adapters/mcp-oauth.js.map +1 -0
- package/dist/adapters/mcp-wire.d.ts +21 -0
- package/dist/adapters/mcp-wire.js +307 -0
- package/dist/adapters/mcp-wire.js.map +1 -0
- package/dist/adapters/mcp.d.ts +56 -0
- package/dist/adapters/mcp.js +1989 -0
- package/dist/adapters/mcp.js.map +1 -0
- package/dist/adapters/openapi-http.d.ts +29 -0
- package/dist/adapters/openapi-http.js +504 -0
- package/dist/adapters/openapi-http.js.map +1 -0
- package/dist/adapters/openapi-request.d.ts +26 -0
- package/dist/adapters/openapi-request.js +597 -0
- package/dist/adapters/openapi-request.js.map +1 -0
- package/dist/adapters/openapi-schema.d.ts +22 -0
- package/dist/adapters/openapi-schema.js +471 -0
- package/dist/adapters/openapi-schema.js.map +1 -0
- package/dist/adapters/openapi-typegen.d.ts +11 -0
- package/dist/adapters/openapi-typegen.js +185 -0
- package/dist/adapters/openapi-typegen.js.map +1 -0
- package/dist/adapters/openapi-types.d.ts +99 -0
- package/dist/adapters/openapi-types.js +2 -0
- package/dist/adapters/openapi-types.js.map +1 -0
- package/dist/adapters/openapi.d.ts +7 -0
- package/dist/adapters/openapi.js +768 -0
- package/dist/adapters/openapi.js.map +1 -0
- package/dist/application/activation.d.ts +28 -0
- package/dist/application/activation.js +289 -0
- package/dist/application/activation.js.map +1 -0
- package/dist/application/attachments.d.ts +24 -0
- package/dist/application/attachments.js +87 -0
- package/dist/application/attachments.js.map +1 -0
- package/dist/application/authority.d.ts +32 -0
- package/dist/application/authority.js +213 -0
- package/dist/application/authority.js.map +1 -0
- package/dist/application/catalog.d.ts +11 -0
- package/dist/application/catalog.js +177 -0
- package/dist/application/catalog.js.map +1 -0
- package/dist/application/config.d.ts +24 -0
- package/dist/application/config.js +140 -0
- package/dist/application/config.js.map +1 -0
- package/dist/application/connection.d.ts +35 -0
- package/dist/application/connection.js +465 -0
- package/dist/application/connection.js.map +1 -0
- package/dist/application/data-plane.d.ts +35 -0
- package/dist/application/data-plane.js +437 -0
- package/dist/application/data-plane.js.map +1 -0
- package/dist/application/diagnostics.d.ts +4 -0
- package/dist/application/diagnostics.js +65 -0
- package/dist/application/diagnostics.js.map +1 -0
- package/dist/application/dispatcher.d.ts +4 -0
- package/dist/application/dispatcher.js +16 -0
- package/dist/application/dispatcher.js.map +1 -0
- package/dist/application/main.d.ts +12 -0
- package/dist/application/main.js +167 -0
- package/dist/application/main.js.map +1 -0
- package/dist/application/maintenance.d.ts +27 -0
- package/dist/application/maintenance.js +244 -0
- package/dist/application/maintenance.js.map +1 -0
- package/dist/application/packages.d.ts +25 -0
- package/dist/application/packages.js +208 -0
- package/dist/application/packages.js.map +1 -0
- package/dist/application/processes.d.ts +49 -0
- package/dist/application/processes.js +180 -0
- package/dist/application/processes.js.map +1 -0
- package/dist/application/run-view.d.ts +17 -0
- package/dist/application/run-view.js +286 -0
- package/dist/application/run-view.js.map +1 -0
- package/dist/application/runtime.d.ts +78 -0
- package/dist/application/runtime.js +1747 -0
- package/dist/application/runtime.js.map +1 -0
- package/dist/application/tasks.d.ts +38 -0
- package/dist/application/tasks.js +23 -0
- package/dist/application/tasks.js.map +1 -0
- package/dist/application/user-state.d.ts +20 -0
- package/dist/application/user-state.js +52 -0
- package/dist/application/user-state.js.map +1 -0
- package/dist/application/work-git.d.ts +14 -0
- package/dist/application/work-git.js +67 -0
- package/dist/application/work-git.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +40 -0
- package/dist/cli.js.map +1 -0
- package/dist/contracts/caller.d.ts +51 -0
- package/dist/contracts/caller.js +95 -0
- package/dist/contracts/caller.js.map +1 -0
- package/dist/contracts/error-data.d.ts +6 -0
- package/dist/contracts/error-data.js +51 -0
- package/dist/contracts/error-data.js.map +1 -0
- package/dist/contracts/errors.d.ts +10 -0
- package/dist/contracts/errors.js +28 -0
- package/dist/contracts/errors.js.map +1 -0
- package/dist/contracts/json.d.ts +9 -0
- package/dist/contracts/json.js +104 -0
- package/dist/contracts/json.js.map +1 -0
- package/dist/contracts/types.d.ts +122 -0
- package/dist/contracts/types.js +19 -0
- package/dist/contracts/types.js.map +1 -0
- package/dist/contracts/validation.d.ts +4 -0
- package/dist/contracts/validation.js +157 -0
- package/dist/contracts/validation.js.map +1 -0
- package/dist/contracts/wire-validation.d.ts +9 -0
- package/dist/contracts/wire-validation.js +399 -0
- package/dist/contracts/wire-validation.js.map +1 -0
- package/dist/contracts/wire.d.ts +1083 -0
- package/dist/contracts/wire.js +62 -0
- package/dist/contracts/wire.js.map +1 -0
- package/dist/extension-api.d.ts +12 -0
- package/dist/extension-api.js +2 -0
- package/dist/extension-api.js.map +1 -0
- package/dist/extensions/api.d.ts +72 -0
- package/dist/extensions/api.js +2 -0
- package/dist/extensions/api.js.map +1 -0
- package/dist/extensions/host-requests.d.ts +23 -0
- package/dist/extensions/host-requests.js +60 -0
- package/dist/extensions/host-requests.js.map +1 -0
- package/dist/extensions/materials.d.ts +37 -0
- package/dist/extensions/materials.js +691 -0
- package/dist/extensions/materials.js.map +1 -0
- package/dist/extensions/package-loader.d.ts +28 -0
- package/dist/extensions/package-loader.js +177 -0
- package/dist/extensions/package-loader.js.map +1 -0
- package/dist/extensions/packages.d.ts +73 -0
- package/dist/extensions/packages.js +441 -0
- package/dist/extensions/packages.js.map +1 -0
- package/dist/extensions/registry.d.ts +92 -0
- package/dist/extensions/registry.js +1540 -0
- package/dist/extensions/registry.js.map +1 -0
- package/dist/extensions/resources.d.ts +105 -0
- package/dist/extensions/resources.js +595 -0
- package/dist/extensions/resources.js.map +1 -0
- package/dist/extensions/state.d.ts +25 -0
- package/dist/extensions/state.js +10 -0
- package/dist/extensions/state.js.map +1 -0
- package/dist/extensions/transfer.d.ts +81 -0
- package/dist/extensions/transfer.js +16 -0
- package/dist/extensions/transfer.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/maintenance/configuration.d.ts +79 -0
- package/dist/maintenance/configuration.js +1503 -0
- package/dist/maintenance/configuration.js.map +1 -0
- package/dist/maintenance/credentials.d.ts +23 -0
- package/dist/maintenance/credentials.js +177 -0
- package/dist/maintenance/credentials.js.map +1 -0
- package/dist/maintenance/files.d.ts +2 -0
- package/dist/maintenance/files.js +40 -0
- package/dist/maintenance/files.js.map +1 -0
- package/dist/maintenance/npm.d.ts +71 -0
- package/dist/maintenance/npm.js +1013 -0
- package/dist/maintenance/npm.js.map +1 -0
- package/dist/maintenance/oauth.d.ts +45 -0
- package/dist/maintenance/oauth.js +686 -0
- package/dist/maintenance/oauth.js.map +1 -0
- package/dist/maintenance/requests.d.ts +347 -0
- package/dist/maintenance/requests.js +959 -0
- package/dist/maintenance/requests.js.map +1 -0
- package/dist/maintenance/work-git.d.ts +29 -0
- package/dist/maintenance/work-git.js +776 -0
- package/dist/maintenance/work-git.js.map +1 -0
- package/dist/process/backend.d.ts +54 -0
- package/dist/process/backend.js +39 -0
- package/dist/process/backend.js.map +1 -0
- package/dist/process/environment-windows.d.ts +15 -0
- package/dist/process/environment-windows.js +151 -0
- package/dist/process/environment-windows.js.map +1 -0
- package/dist/process/environment.d.ts +28 -0
- package/dist/process/environment.js +410 -0
- package/dist/process/environment.js.map +1 -0
- package/dist/process/launch.d.ts +31 -0
- package/dist/process/launch.js +281 -0
- package/dist/process/launch.js.map +1 -0
- package/dist/process/managed.d.ts +36 -0
- package/dist/process/managed.js +459 -0
- package/dist/process/managed.js.map +1 -0
- package/dist/process/output-log.d.ts +50 -0
- package/dist/process/output-log.js +552 -0
- package/dist/process/output-log.js.map +1 -0
- package/dist/process/pipes.d.ts +16 -0
- package/dist/process/pipes.js +588 -0
- package/dist/process/pipes.js.map +1 -0
- package/dist/process/pty.d.ts +22 -0
- package/dist/process/pty.js +512 -0
- package/dist/process/pty.js.map +1 -0
- package/dist/process/windows-conout-worker.d.ts +1 -0
- package/dist/process/windows-conout-worker.js +90 -0
- package/dist/process/windows-conout-worker.js.map +1 -0
- package/dist/process/windows-conout.d.ts +46 -0
- package/dist/process/windows-conout.js +140 -0
- package/dist/process/windows-conout.js.map +1 -0
- package/dist/process/windows-helper.d.ts +43 -0
- package/dist/process/windows-helper.js +255 -0
- package/dist/process/windows-helper.js.map +1 -0
- package/dist/process/windows-job.d.ts +39 -0
- package/dist/process/windows-job.js +224 -0
- package/dist/process/windows-job.js.map +1 -0
- package/dist/process/windows-pipes.d.ts +16 -0
- package/dist/process/windows-pipes.js +475 -0
- package/dist/process/windows-pipes.js.map +1 -0
- package/dist/results/artifacts.d.ts +118 -0
- package/dist/results/artifacts.js +873 -0
- package/dist/results/artifacts.js.map +1 -0
- package/dist/results/encoder.d.ts +57 -0
- package/dist/results/encoder.js +1179 -0
- package/dist/results/encoder.js.map +1 -0
- package/dist/results/mcp.d.ts +95 -0
- package/dist/results/mcp.js +656 -0
- package/dist/results/mcp.js.map +1 -0
- package/dist/results/media.d.ts +19 -0
- package/dist/results/media.js +301 -0
- package/dist/results/media.js.map +1 -0
- package/dist/results/normalize.d.ts +29 -0
- package/dist/results/normalize.js +464 -0
- package/dist/results/normalize.js.map +1 -0
- package/dist/runtime/control-scripts.d.ts +23 -0
- package/dist/runtime/control-scripts.js +242 -0
- package/dist/runtime/control-scripts.js.map +1 -0
- package/dist/runtime/engine.d.ts +177 -0
- package/dist/runtime/engine.js +1159 -0
- package/dist/runtime/engine.js.map +1 -0
- package/dist/runtime/globals.d.ts +1 -0
- package/dist/runtime/globals.js +31 -0
- package/dist/runtime/globals.js.map +1 -0
- package/dist/runtime/material-retention.d.ts +34 -0
- package/dist/runtime/material-retention.js +671 -0
- package/dist/runtime/material-retention.js.map +1 -0
- package/dist/runtime/modules.d.ts +50 -0
- package/dist/runtime/modules.js +320 -0
- package/dist/runtime/modules.js.map +1 -0
- package/dist/runtime/names.d.ts +2 -0
- package/dist/runtime/names.js +22 -0
- package/dist/runtime/names.js.map +1 -0
- package/dist/runtime/operations.d.ts +20 -0
- package/dist/runtime/operations.js +137 -0
- package/dist/runtime/operations.js.map +1 -0
- package/dist/runtime/paths.d.ts +3 -0
- package/dist/runtime/paths.js +38 -0
- package/dist/runtime/paths.js.map +1 -0
- package/dist/runtime/promises.d.ts +9 -0
- package/dist/runtime/promises.js +78 -0
- package/dist/runtime/promises.js.map +1 -0
- package/dist/runtime/retention.d.ts +88 -0
- package/dist/runtime/retention.js +735 -0
- package/dist/runtime/retention.js.map +1 -0
- package/dist/runtime/run-log.d.ts +30 -0
- package/dist/runtime/run-log.js +207 -0
- package/dist/runtime/run-log.js.map +1 -0
- package/dist/runtime/scripts.d.ts +84 -0
- package/dist/runtime/scripts.js +387 -0
- package/dist/runtime/scripts.js.map +1 -0
- package/dist/runtime/tasks.d.ts +54 -0
- package/dist/runtime/tasks.js +290 -0
- package/dist/runtime/tasks.js.map +1 -0
- package/dist/sdk/maintenance.d.ts +3 -0
- package/dist/sdk/maintenance.js +80 -0
- package/dist/sdk/maintenance.js.map +1 -0
- package/dist/sdk/output-extension.d.ts +3 -0
- package/dist/sdk/output-extension.js +44 -0
- package/dist/sdk/output-extension.js.map +1 -0
- package/dist/sdk/output.d.ts +52 -0
- package/dist/sdk/output.js +350 -0
- package/dist/sdk/output.js.map +1 -0
- package/dist/sdk/runtime.d.ts +3 -0
- package/dist/sdk/runtime.js +26 -0
- package/dist/sdk/runtime.js.map +1 -0
- package/dist/sdk/sh.d.ts +3 -0
- package/dist/sdk/sh.js +384 -0
- package/dist/sdk/sh.js.map +1 -0
- package/dist/sdk/state.d.ts +2 -0
- package/dist/sdk/state.js +69 -0
- package/dist/sdk/state.js.map +1 -0
- package/dist/sdk/transfer.d.ts +3 -0
- package/dist/sdk/transfer.js +141 -0
- package/dist/sdk/transfer.js.map +1 -0
- package/dist/services/extensions.d.ts +19 -0
- package/dist/services/extensions.js +183 -0
- package/dist/services/extensions.js.map +1 -0
- package/dist/services/state.d.ts +37 -0
- package/dist/services/state.js +125 -0
- package/dist/services/state.js.map +1 -0
- package/dist/services/transfer.d.ts +86 -0
- package/dist/services/transfer.js +948 -0
- package/dist/services/transfer.js.map +1 -0
- package/dist/storage/schema.d.ts +8 -0
- package/dist/storage/schema.js +241 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/sqlite.d.ts +241 -0
- package/dist/storage/sqlite.js +1855 -0
- package/dist/storage/sqlite.js.map +1 -0
- package/dist/storage/transfers.d.ts +90 -0
- package/dist/storage/transfers.js +2 -0
- package/dist/storage/transfers.js.map +1 -0
- package/dist/transfer/io.d.ts +74 -0
- package/dist/transfer/io.js +425 -0
- package/dist/transfer/io.js.map +1 -0
- package/dist/transfer/offers.d.ts +72 -0
- package/dist/transfer/offers.js +380 -0
- package/dist/transfer/offers.js.map +1 -0
- package/dist/transfer/stream-slots.d.ts +12 -0
- package/dist/transfer/stream-slots.js +28 -0
- package/dist/transfer/stream-slots.js.map +1 -0
- package/dist/work/catalog.d.ts +43 -0
- package/dist/work/catalog.js +198 -0
- package/dist/work/catalog.js.map +1 -0
- package/dist/work/discovery.d.ts +70 -0
- package/dist/work/discovery.js +465 -0
- package/dist/work/discovery.js.map +1 -0
- package/dist/work/service.d.ts +83 -0
- package/dist/work/service.js +703 -0
- package/dist/work/service.js.map +1 -0
- package/package.json +66 -4
|
@@ -0,0 +1,437 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { request as httpRequest, } from "node:http";
|
|
3
|
+
import { request as httpsRequest } from "node:https";
|
|
4
|
+
import { Readable, Transform } from "node:stream";
|
|
5
|
+
import { pipeline } from "node:stream/promises";
|
|
6
|
+
import { MIMEType } from "node:util";
|
|
7
|
+
import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
|
|
8
|
+
import { authorizeCall } from "../contracts/caller.js";
|
|
9
|
+
import { canonicalJson, isPlainRecord } from "../contracts/json.js";
|
|
10
|
+
import { validateAgentToken, validateServerUrl } from "./config.js";
|
|
11
|
+
const identity = /^[A-Za-z0-9_-]{1,256}$/;
|
|
12
|
+
const headerIdentity = /^[\x21-\x7e]{1,256}$/;
|
|
13
|
+
const directions = {
|
|
14
|
+
resource: ["agent-to-cloud"],
|
|
15
|
+
attachment: ["cloud-to-agent"],
|
|
16
|
+
transfer: ["agent-to-cloud", "cloud-to-agent"],
|
|
17
|
+
"host-request": ["agent-to-cloud"],
|
|
18
|
+
"host-response": ["cloud-to-agent"],
|
|
19
|
+
"result-meta": ["agent-to-cloud"],
|
|
20
|
+
maintenance: ["agent-to-cloud", "cloud-to-agent"],
|
|
21
|
+
};
|
|
22
|
+
const refKeys = new Set([
|
|
23
|
+
"streamId",
|
|
24
|
+
"purpose",
|
|
25
|
+
"direction",
|
|
26
|
+
"expiresAt",
|
|
27
|
+
"maxBytes",
|
|
28
|
+
"mimeType",
|
|
29
|
+
"size",
|
|
30
|
+
"sha256",
|
|
31
|
+
]);
|
|
32
|
+
function plainData(value, allowed) {
|
|
33
|
+
return (isPlainRecord(value) &&
|
|
34
|
+
Reflect.ownKeys(value).every((key) => typeof key === "string" &&
|
|
35
|
+
allowed.has(key) &&
|
|
36
|
+
"value" in Object.getOwnPropertyDescriptor(value, key)));
|
|
37
|
+
}
|
|
38
|
+
function error(code) {
|
|
39
|
+
// Native socket/parser messages, response bodies and credentials never escape.
|
|
40
|
+
return new AgentError(code, "The authenticated Agent data stream could not complete.");
|
|
41
|
+
}
|
|
42
|
+
function safeFailure(cause) {
|
|
43
|
+
return isAgentError(cause) ? cause : error("stream_closed");
|
|
44
|
+
}
|
|
45
|
+
/** HTTP adaptation only. Core owns reservations, stream slots and transfer state. */
|
|
46
|
+
export class AgentDataPlane {
|
|
47
|
+
#server;
|
|
48
|
+
#token;
|
|
49
|
+
#binding;
|
|
50
|
+
#assertCurrent;
|
|
51
|
+
#maxBytes;
|
|
52
|
+
#maxJsonBytes;
|
|
53
|
+
constructor(options) {
|
|
54
|
+
this.#server = validateServerUrl(options.serverUrl, options.binding.profile);
|
|
55
|
+
this.#token = validateAgentToken(options.token);
|
|
56
|
+
const binding = options.binding;
|
|
57
|
+
requireCondition([
|
|
58
|
+
binding.agentId,
|
|
59
|
+
binding.bootId,
|
|
60
|
+
binding.connectionId,
|
|
61
|
+
binding.cloudEnvironment,
|
|
62
|
+
].every((value) => typeof value === "string" && headerIdentity.test(value)) &&
|
|
63
|
+
binding.cloudEnvironment === binding.profile &&
|
|
64
|
+
typeof options.assertCurrent === "function", "invalid_connection_binding", "The authenticated Agent connection binding is invalid.");
|
|
65
|
+
this.#binding = Object.freeze({ ...binding });
|
|
66
|
+
this.#assertCurrent = options.assertCurrent;
|
|
67
|
+
this.#maxBytes = options.maxBytes ?? 256 * 1024 * 1024;
|
|
68
|
+
this.#maxJsonBytes = options.maxJsonBytes ?? 1024 * 1024;
|
|
69
|
+
requireCondition(Number.isSafeInteger(this.#maxBytes) &&
|
|
70
|
+
this.#maxBytes > 0 &&
|
|
71
|
+
Number.isSafeInteger(this.#maxJsonBytes) &&
|
|
72
|
+
this.#maxJsonBytes > 0 &&
|
|
73
|
+
this.#maxJsonBytes <= this.#maxBytes, "invalid_configuration", "The data stream budgets are invalid.");
|
|
74
|
+
}
|
|
75
|
+
#current(signal, deadline) {
|
|
76
|
+
if (signal.aborted)
|
|
77
|
+
throw error("stream_cancelled");
|
|
78
|
+
if (Date.now() >= deadline)
|
|
79
|
+
throw error("stream_timeout");
|
|
80
|
+
try {
|
|
81
|
+
authorizeCall(this.#assertCurrent);
|
|
82
|
+
}
|
|
83
|
+
catch {
|
|
84
|
+
throw error("invalid_connection_binding");
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
#reference(ref, direction, signal, claim) {
|
|
88
|
+
requireCondition(plainData(ref, refKeys) &&
|
|
89
|
+
typeof ref.streamId === "string" &&
|
|
90
|
+
identity.test(ref.streamId) &&
|
|
91
|
+
typeof ref.purpose === "string" &&
|
|
92
|
+
Object.hasOwn(directions, ref.purpose) &&
|
|
93
|
+
directions[ref.purpose].includes(ref.direction) &&
|
|
94
|
+
typeof ref.expiresAt === "string" &&
|
|
95
|
+
/^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-5][0-9](?:\.[0-9]+)?Z$/.test(ref.expiresAt) &&
|
|
96
|
+
Number.isFinite(Date.parse(ref.expiresAt)) &&
|
|
97
|
+
Number.isSafeInteger(ref.maxBytes) &&
|
|
98
|
+
ref.maxBytes > 0 &&
|
|
99
|
+
ref.maxBytes <= this.#maxBytes &&
|
|
100
|
+
(ref.size === undefined ||
|
|
101
|
+
(Number.isSafeInteger(ref.size) &&
|
|
102
|
+
ref.size >= 0 &&
|
|
103
|
+
ref.size <= ref.maxBytes)) &&
|
|
104
|
+
(ref.sha256 === undefined ||
|
|
105
|
+
(typeof ref.sha256 === "string" &&
|
|
106
|
+
/^[0-9a-f]{64}$/.test(ref.sha256))) &&
|
|
107
|
+
(ref.mimeType === undefined ||
|
|
108
|
+
(typeof ref.mimeType === "string" &&
|
|
109
|
+
ref.mimeType.length <= 256 &&
|
|
110
|
+
!/[\x00-\x1f\x7f]/.test(ref.mimeType))), "invalid_stream_reference", "The authenticated stream reference is invalid.");
|
|
111
|
+
requireCondition(ref.direction === direction, "stream_direction_mismatch", "The stream direction does not match this endpoint.");
|
|
112
|
+
if (ref.mimeType !== undefined) {
|
|
113
|
+
try {
|
|
114
|
+
new MIMEType(ref.mimeType);
|
|
115
|
+
}
|
|
116
|
+
catch {
|
|
117
|
+
throw error("invalid_stream_reference");
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
requireCondition(ref.purpose === "transfer"
|
|
121
|
+
? plainData(claim, new Set(["transferId", "reservationId"])) &&
|
|
122
|
+
claim !== undefined &&
|
|
123
|
+
Object.keys(claim).length === 2 &&
|
|
124
|
+
typeof claim.transferId === "string" &&
|
|
125
|
+
typeof claim.reservationId === "string" &&
|
|
126
|
+
identity.test(claim.transferId) &&
|
|
127
|
+
identity.test(claim.reservationId)
|
|
128
|
+
: claim === undefined, "invalid_stream_reference", "The actual transfer reservation must match the stream purpose.");
|
|
129
|
+
const deadline = Date.parse(ref.expiresAt);
|
|
130
|
+
requireCondition(deadline - Date.now() <= 2_147_483_647, "invalid_stream_reference", "The stream deadline is invalid.");
|
|
131
|
+
this.#current(signal, deadline);
|
|
132
|
+
return Object.freeze({ ...ref });
|
|
133
|
+
}
|
|
134
|
+
async openRead(ref, signal, claim) {
|
|
135
|
+
const stream = this.#reference(ref, "cloud-to-agent", signal, claim);
|
|
136
|
+
const exchange = this.#open(stream, signal, claim);
|
|
137
|
+
try {
|
|
138
|
+
await exchange.opened;
|
|
139
|
+
}
|
|
140
|
+
catch (cause) {
|
|
141
|
+
await exchange.closed.catch(() => { });
|
|
142
|
+
throw cause;
|
|
143
|
+
}
|
|
144
|
+
return { readable: exchange.body, closed: exchange.closed };
|
|
145
|
+
}
|
|
146
|
+
openWrite(ref, signal, claim) {
|
|
147
|
+
const stream = this.#reference(ref, "agent-to-cloud", signal, claim);
|
|
148
|
+
const exchange = this.#open(stream, signal, claim);
|
|
149
|
+
return { writable: exchange.body, closed: exchange.closed };
|
|
150
|
+
}
|
|
151
|
+
#open(ref, signal, claim) {
|
|
152
|
+
const reading = ref.direction === "cloud-to-agent";
|
|
153
|
+
const deadline = Date.parse(ref.expiresAt);
|
|
154
|
+
const url = new URL(this.#server);
|
|
155
|
+
url.pathname =
|
|
156
|
+
url.pathname.replace(/\/+$/, "") + "/agent/file-stream/" + ref.streamId;
|
|
157
|
+
const headers = {
|
|
158
|
+
Authorization: `Bearer ${this.#token}`,
|
|
159
|
+
Connection: "close",
|
|
160
|
+
"X-Nexum-Connection-Id": this.#binding.connectionId,
|
|
161
|
+
"X-Nexum-Agent-Profile": this.#binding.profile,
|
|
162
|
+
"X-Nexum-Agent-Boot-Id": this.#binding.bootId,
|
|
163
|
+
"X-Nexum-Stream-Purpose": ref.purpose,
|
|
164
|
+
"X-Nexum-Stream-Direction": ref.direction,
|
|
165
|
+
...(claim
|
|
166
|
+
? {
|
|
167
|
+
"X-Nexum-Transfer-Id": claim.transferId,
|
|
168
|
+
"X-Nexum-Reservation-Id": claim.reservationId,
|
|
169
|
+
}
|
|
170
|
+
: {}),
|
|
171
|
+
...(!reading && ref.mimeType ? { "Content-Type": ref.mimeType } : {}),
|
|
172
|
+
// A transfer consumer may acknowledge fixed bytes before Core has verified
|
|
173
|
+
// source closure. Chunked framing carries the producer's real final EOF.
|
|
174
|
+
...(!reading && ref.purpose !== "transfer" && ref.size !== undefined
|
|
175
|
+
? { "Content-Length": ref.size }
|
|
176
|
+
: {}),
|
|
177
|
+
};
|
|
178
|
+
const completion = Promise.withResolvers();
|
|
179
|
+
const opening = Promise.withResolvers();
|
|
180
|
+
// Callers may await HTTP admission/body production before observing closure.
|
|
181
|
+
void completion.promise.catch(() => { });
|
|
182
|
+
void opening.promise.catch(() => { });
|
|
183
|
+
let request;
|
|
184
|
+
let response;
|
|
185
|
+
let failure;
|
|
186
|
+
let requestClosed = false, responseClosed = false, socketClosed = false, bodyClosed = false;
|
|
187
|
+
let socketAssigned = false, pipeStarted = false, pipeDone = false, acknowledged = false;
|
|
188
|
+
let settled = false, count = 0;
|
|
189
|
+
const hash = createHash("sha256");
|
|
190
|
+
const current = () => this.#current(signal, deadline);
|
|
191
|
+
let timer;
|
|
192
|
+
const finish = () => {
|
|
193
|
+
if (settled ||
|
|
194
|
+
!requestClosed ||
|
|
195
|
+
!responseClosed ||
|
|
196
|
+
!socketClosed ||
|
|
197
|
+
!bodyClosed ||
|
|
198
|
+
!pipeDone)
|
|
199
|
+
return;
|
|
200
|
+
if (!failure) {
|
|
201
|
+
try {
|
|
202
|
+
current();
|
|
203
|
+
}
|
|
204
|
+
catch (cause) {
|
|
205
|
+
failure = safeFailure(cause);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
if (!failure && !acknowledged)
|
|
209
|
+
failure = error("stream_closed");
|
|
210
|
+
settled = true;
|
|
211
|
+
clearTimeout(timer);
|
|
212
|
+
signal.removeEventListener("abort", abort);
|
|
213
|
+
if (failure)
|
|
214
|
+
completion.reject(failure);
|
|
215
|
+
else
|
|
216
|
+
completion.resolve();
|
|
217
|
+
};
|
|
218
|
+
const fail = (cause) => {
|
|
219
|
+
failure ??= safeFailure(cause);
|
|
220
|
+
opening.reject(failure);
|
|
221
|
+
body.destroy(failure);
|
|
222
|
+
response?.destroy(failure);
|
|
223
|
+
request?.destroy(failure);
|
|
224
|
+
if (!pipeStarted)
|
|
225
|
+
pipeDone = true;
|
|
226
|
+
finish();
|
|
227
|
+
};
|
|
228
|
+
const body = new Transform({
|
|
229
|
+
highWaterMark: 64 * 1024,
|
|
230
|
+
transform(chunk, _encoding, callback) {
|
|
231
|
+
try {
|
|
232
|
+
current();
|
|
233
|
+
requireCondition(Buffer.isBuffer(chunk), "invalid_stream_body", "Only raw byte stream data is accepted.");
|
|
234
|
+
requireCondition(chunk.length <= ref.maxBytes - count, "resource_exhausted", "The actual stream exceeds its byte budget.");
|
|
235
|
+
count += chunk.length;
|
|
236
|
+
requireCondition(ref.size === undefined || count <= ref.size, "stream_size_mismatch", "The actual stream size does not match its fixed reference.");
|
|
237
|
+
hash.update(chunk);
|
|
238
|
+
callback(null, chunk);
|
|
239
|
+
}
|
|
240
|
+
catch (cause) {
|
|
241
|
+
callback(safeFailure(cause));
|
|
242
|
+
}
|
|
243
|
+
},
|
|
244
|
+
flush(callback) {
|
|
245
|
+
try {
|
|
246
|
+
current();
|
|
247
|
+
requireCondition(ref.size === undefined || count === ref.size, "stream_size_mismatch", "The actual stream size does not match its fixed reference.");
|
|
248
|
+
const actual = hash.digest("hex");
|
|
249
|
+
requireCondition(ref.sha256 === undefined || actual === ref.sha256, "checksum_mismatch", "The actual stream checksum does not match its fixed reference.");
|
|
250
|
+
callback();
|
|
251
|
+
}
|
|
252
|
+
catch (cause) {
|
|
253
|
+
callback(safeFailure(cause));
|
|
254
|
+
}
|
|
255
|
+
},
|
|
256
|
+
});
|
|
257
|
+
body.on("error", fail);
|
|
258
|
+
body.once("close", () => {
|
|
259
|
+
bodyClosed = true;
|
|
260
|
+
if (!failure && (!body.readableEnded || !body.writableFinished))
|
|
261
|
+
fail(error("stream_closed"));
|
|
262
|
+
finish();
|
|
263
|
+
});
|
|
264
|
+
const abort = () => fail(error("stream_cancelled"));
|
|
265
|
+
signal.addEventListener("abort", abort, { once: true });
|
|
266
|
+
timer = setTimeout(() => fail(error("stream_timeout")), Math.max(1, deadline - Date.now()));
|
|
267
|
+
try {
|
|
268
|
+
request = (url.protocol === "https:" ? httpsRequest : httpRequest)(url, {
|
|
269
|
+
method: reading ? "GET" : "PUT",
|
|
270
|
+
headers,
|
|
271
|
+
agent: false,
|
|
272
|
+
maxHeaderSize: 16 * 1024,
|
|
273
|
+
});
|
|
274
|
+
request.once("socket", (socket) => {
|
|
275
|
+
socketAssigned = true;
|
|
276
|
+
socket.once("close", () => {
|
|
277
|
+
socketClosed = true;
|
|
278
|
+
finish();
|
|
279
|
+
});
|
|
280
|
+
});
|
|
281
|
+
request.on("error", () => fail(error("stream_closed")));
|
|
282
|
+
request.once("upgrade", (incoming, socket) => {
|
|
283
|
+
response = incoming;
|
|
284
|
+
incoming.on("error", () => { });
|
|
285
|
+
incoming.once("close", () => {
|
|
286
|
+
responseClosed = true;
|
|
287
|
+
finish();
|
|
288
|
+
});
|
|
289
|
+
fail(error("stream_http_error"));
|
|
290
|
+
socket.destroy();
|
|
291
|
+
});
|
|
292
|
+
request.once("close", () => {
|
|
293
|
+
requestClosed = true;
|
|
294
|
+
if (!socketAssigned)
|
|
295
|
+
socketClosed = true;
|
|
296
|
+
if (!response)
|
|
297
|
+
responseClosed = true;
|
|
298
|
+
if (!failure && (!response || !response.complete))
|
|
299
|
+
fail(error("stream_closed"));
|
|
300
|
+
finish();
|
|
301
|
+
});
|
|
302
|
+
request.once("response", (incoming) => {
|
|
303
|
+
response = incoming;
|
|
304
|
+
incoming.on("error", () => fail(error("stream_closed")));
|
|
305
|
+
incoming.once("aborted", () => fail(error("stream_closed")));
|
|
306
|
+
incoming.once("close", () => {
|
|
307
|
+
responseClosed = true;
|
|
308
|
+
if (!incoming.complete)
|
|
309
|
+
fail(error("stream_closed"));
|
|
310
|
+
finish();
|
|
311
|
+
});
|
|
312
|
+
try {
|
|
313
|
+
current();
|
|
314
|
+
requireCondition((incoming.statusCode ?? 0) >= 200 && incoming.statusCode < 300, "stream_http_error", "The data stream endpoint did not accept the request.");
|
|
315
|
+
if (reading) {
|
|
316
|
+
const length = incoming.headers["content-length"];
|
|
317
|
+
if (length !== undefined) {
|
|
318
|
+
requireCondition(typeof length === "string" &&
|
|
319
|
+
/^(0|[1-9][0-9]*)$/.test(length) &&
|
|
320
|
+
Number.isSafeInteger(Number(length)), "invalid_stream_reference", "The data stream length is invalid.");
|
|
321
|
+
requireCondition(Number(length) <= ref.maxBytes, "resource_exhausted", "The data stream exceeds its byte budget.");
|
|
322
|
+
requireCondition(ref.size === undefined || Number(length) === ref.size, "stream_size_mismatch", "The data stream length does not match its fixed reference.");
|
|
323
|
+
}
|
|
324
|
+
pipeStarted = true;
|
|
325
|
+
void pipeline(incoming, body).then(() => {
|
|
326
|
+
pipeDone = true;
|
|
327
|
+
acknowledged = true;
|
|
328
|
+
finish();
|
|
329
|
+
}, (cause) => {
|
|
330
|
+
pipeDone = true;
|
|
331
|
+
fail(cause);
|
|
332
|
+
});
|
|
333
|
+
opening.resolve();
|
|
334
|
+
}
|
|
335
|
+
else {
|
|
336
|
+
// Cloud sends success only after the actual consumer's EOF. Drain a
|
|
337
|
+
// bounded response without parsing or exposing an arbitrary body.
|
|
338
|
+
let responseBytes = 0;
|
|
339
|
+
incoming.on("data", (chunk) => {
|
|
340
|
+
responseBytes += chunk.length;
|
|
341
|
+
if (responseBytes > 64 * 1024)
|
|
342
|
+
fail(error("resource_exhausted"));
|
|
343
|
+
});
|
|
344
|
+
incoming.once("end", () => {
|
|
345
|
+
try {
|
|
346
|
+
current();
|
|
347
|
+
acknowledged = true;
|
|
348
|
+
finish();
|
|
349
|
+
}
|
|
350
|
+
catch (cause) {
|
|
351
|
+
fail(cause);
|
|
352
|
+
}
|
|
353
|
+
});
|
|
354
|
+
incoming.resume();
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
catch (cause) {
|
|
358
|
+
fail(cause);
|
|
359
|
+
}
|
|
360
|
+
});
|
|
361
|
+
if (reading)
|
|
362
|
+
request.end();
|
|
363
|
+
else {
|
|
364
|
+
pipeStarted = true;
|
|
365
|
+
void pipeline(body, request).then(() => {
|
|
366
|
+
pipeDone = true;
|
|
367
|
+
finish();
|
|
368
|
+
}, (cause) => {
|
|
369
|
+
pipeDone = true;
|
|
370
|
+
fail(cause);
|
|
371
|
+
});
|
|
372
|
+
// A real Go relay must see the handshake before it starts the consumer.
|
|
373
|
+
request.flushHeaders();
|
|
374
|
+
opening.resolve();
|
|
375
|
+
}
|
|
376
|
+
if (signal.aborted)
|
|
377
|
+
abort();
|
|
378
|
+
}
|
|
379
|
+
catch (cause) {
|
|
380
|
+
if (!request) {
|
|
381
|
+
requestClosed = responseClosed = socketClosed = true;
|
|
382
|
+
}
|
|
383
|
+
fail(cause);
|
|
384
|
+
}
|
|
385
|
+
return { body, opened: opening.promise, closed: completion.promise };
|
|
386
|
+
}
|
|
387
|
+
async sendFixedBody(ref, source, signal) {
|
|
388
|
+
requireCondition(ref.size !== undefined && ref.sha256 !== undefined, "invalid_stream_reference", "A fixed size and checksum are required.");
|
|
389
|
+
let readable;
|
|
390
|
+
if (source instanceof Uint8Array) {
|
|
391
|
+
const bytes = Buffer.from(source.buffer, source.byteOffset, source.byteLength);
|
|
392
|
+
requireCondition(bytes.length === ref.size, "stream_size_mismatch", "The fixed body size does not match its reference.");
|
|
393
|
+
requireCondition(createHash("sha256").update(bytes).digest("hex") === ref.sha256, "checksum_mismatch", "The fixed body checksum does not match its reference.");
|
|
394
|
+
readable = Readable.from([bytes]);
|
|
395
|
+
}
|
|
396
|
+
else {
|
|
397
|
+
requireCondition(source instanceof Readable, "invalid_stream_body", "A native byte stream or Uint8Array is required.");
|
|
398
|
+
readable = source;
|
|
399
|
+
}
|
|
400
|
+
const { writable, closed } = this.openWrite(ref, signal);
|
|
401
|
+
try {
|
|
402
|
+
await pipeline(readable, writable);
|
|
403
|
+
await closed;
|
|
404
|
+
}
|
|
405
|
+
catch (cause) {
|
|
406
|
+
writable.destroy(safeFailure(cause));
|
|
407
|
+
await closed.catch(() => { });
|
|
408
|
+
throw safeFailure(cause);
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
async readJson(ref, signal) {
|
|
412
|
+
requireCondition(ref.size !== undefined && ref.sha256 !== undefined, "invalid_stream_reference", "A fixed JSON size and checksum are required.");
|
|
413
|
+
requireCondition(ref.size <= this.#maxJsonBytes, "resource_exhausted", "The JSON body exceeds its byte budget.");
|
|
414
|
+
const { readable, closed } = await this.openRead(ref, signal);
|
|
415
|
+
const chunks = [];
|
|
416
|
+
try {
|
|
417
|
+
for await (const chunk of readable)
|
|
418
|
+
chunks.push(chunk);
|
|
419
|
+
await closed;
|
|
420
|
+
const value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks, ref.size)));
|
|
421
|
+
canonicalJson(value, this.#maxJsonBytes);
|
|
422
|
+
return value;
|
|
423
|
+
}
|
|
424
|
+
catch (cause) {
|
|
425
|
+
readable.destroy(safeFailure(cause));
|
|
426
|
+
await closed.catch(() => { });
|
|
427
|
+
if (isAgentError(cause))
|
|
428
|
+
throw cause;
|
|
429
|
+
throw error("invalid_stream_json");
|
|
430
|
+
}
|
|
431
|
+
}
|
|
432
|
+
async writeJson(ref, value, signal) {
|
|
433
|
+
const bytes = Buffer.from(canonicalJson(value, this.#maxJsonBytes));
|
|
434
|
+
await this.sendFixedBody(ref, bytes, signal);
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
//# sourceMappingURL=data-plane.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"data-plane.js","sourceRoot":"","sources":["../../src/application/data-plane.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Profile } from "../contracts/types.js";
|
|
2
|
+
export declare const MAX_DIAGNOSTIC_BYTES: number;
|
|
3
|
+
/** Private, bounded control diagnostics. Native/plugin errors and payloads never enter this file. */
|
|
4
|
+
export declare function appendDiagnostic(root: string, profile: Profile, code: string, retry: boolean): void;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { closeSync, constants, fchmodSync, fstatSync, ftruncateSync, lstatSync, openSync, readSync, realpathSync, writeSync, } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
4
|
+
import { privateDirectory } from "../runtime/paths.js";
|
|
5
|
+
export const MAX_DIAGNOSTIC_BYTES = 1024 * 1024;
|
|
6
|
+
/** Private, bounded control diagnostics. Native/plugin errors and payloads never enter this file. */
|
|
7
|
+
export function appendDiagnostic(root, profile, code, retry) {
|
|
8
|
+
const directory = privateDirectory(root, "logs");
|
|
9
|
+
const filename = path.join(directory, "agent.log");
|
|
10
|
+
const before = lstatSync(filename, { throwIfNoEntry: false });
|
|
11
|
+
requireCondition(!before || (before.isFile() && before.nlink === 1), "agent_log_unavailable", "The diagnostic file is unavailable.");
|
|
12
|
+
const file = openSync(filename, constants.O_RDWR |
|
|
13
|
+
constants.O_CREAT |
|
|
14
|
+
(constants.O_NOFOLLOW ?? 0) |
|
|
15
|
+
(constants.O_NONBLOCK ?? 0), 0o600);
|
|
16
|
+
try {
|
|
17
|
+
const actual = fstatSync(file);
|
|
18
|
+
const current = lstatSync(filename);
|
|
19
|
+
requireCondition(actual.isFile() &&
|
|
20
|
+
actual.nlink === 1 &&
|
|
21
|
+
actual.dev === current.dev &&
|
|
22
|
+
actual.ino === current.ino &&
|
|
23
|
+
(!before || (actual.dev === before.dev && actual.ino === before.ino)) &&
|
|
24
|
+
realpathSync.native(root) === root &&
|
|
25
|
+
realpathSync.native(directory) === directory, "agent_log_unavailable", "The diagnostic file is unavailable.");
|
|
26
|
+
fchmodSync(file, 0o600);
|
|
27
|
+
const entry = Buffer.from(JSON.stringify({
|
|
28
|
+
time: new Date().toISOString(),
|
|
29
|
+
profile,
|
|
30
|
+
code: /^[a-z][a-z0-9_]{0,127}$/.test(code) ? code : "agent_failed",
|
|
31
|
+
retry,
|
|
32
|
+
}) + "\n");
|
|
33
|
+
let position = actual.size;
|
|
34
|
+
if (position + entry.length > MAX_DIAGNOSTIC_BYTES) {
|
|
35
|
+
const length = Math.min(actual.size, MAX_DIAGNOSTIC_BYTES / 2);
|
|
36
|
+
const tail = Buffer.alloc(length);
|
|
37
|
+
let read = 0;
|
|
38
|
+
while (read < length) {
|
|
39
|
+
const count = readSync(file, tail, read, length - read, actual.size - length + read);
|
|
40
|
+
if (!count)
|
|
41
|
+
break;
|
|
42
|
+
read += count;
|
|
43
|
+
}
|
|
44
|
+
// Drop the first partial record, including any partial UTF-8 character.
|
|
45
|
+
const newline = tail.subarray(0, read).indexOf(10);
|
|
46
|
+
const retained = newline < 0 ? Buffer.alloc(0) : tail.subarray(newline + 1, read);
|
|
47
|
+
ftruncateSync(file, 0);
|
|
48
|
+
writeAll(file, retained, 0);
|
|
49
|
+
position = retained.length;
|
|
50
|
+
}
|
|
51
|
+
writeAll(file, entry, position);
|
|
52
|
+
}
|
|
53
|
+
finally {
|
|
54
|
+
closeSync(file);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
function writeAll(file, bytes, position) {
|
|
58
|
+
let offset = 0;
|
|
59
|
+
while (offset < bytes.length) {
|
|
60
|
+
const count = writeSync(file, bytes, offset, bytes.length - offset, position + offset);
|
|
61
|
+
requireCondition(count > 0, "agent_log_unavailable", "The diagnostic write did not complete.");
|
|
62
|
+
offset += count;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
//# sourceMappingURL=diagnostics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/application/diagnostics.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { WireConnectionV2, WireInvokeV2 } from "../contracts/wire.js";
|
|
2
|
+
export type ApplicationHandler = (input: any) => unknown | Promise<unknown>;
|
|
3
|
+
/** Wire validation and routing only; the owning Core services implement behavior. */
|
|
4
|
+
export declare function dispatchApplication(message: WireInvokeV2, binding: WireConnectionV2, handlers: Readonly<Record<string, ApplicationHandler>>): Promise<unknown>;
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
2
|
+
import { validateContract } from "../contracts/validation.js";
|
|
3
|
+
import { validateConnectionV2 } from "../contracts/wire-validation.js";
|
|
4
|
+
/** Wire validation and routing only; the owning Core services implement behavior. */
|
|
5
|
+
export async function dispatchApplication(message, binding, handlers) {
|
|
6
|
+
validateContract("wire", message);
|
|
7
|
+
validateConnectionV2(message.context.connection, binding);
|
|
8
|
+
const handler = Object.hasOwn(handlers, message.operation)
|
|
9
|
+
? handlers[message.operation]
|
|
10
|
+
: undefined;
|
|
11
|
+
requireCondition(handler, "invalid_control_direction", "This operation is not an Agent application entry.");
|
|
12
|
+
const output = await handler(message.input);
|
|
13
|
+
validateContract("wire.output:" + message.operation, output);
|
|
14
|
+
return output;
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=dispatcher.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/application/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAIvE,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAqB,EACrB,OAAyB,EACzB,QAAsD;IAEtD,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC;QACxD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7B,CAAC,CAAC,SAAS,CAAC;IACd,gBAAgB,CACd,OAAO,EACP,2BAA2B,EAC3B,mDAAmD,CACpD,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,gBAAgB,CAAC,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { Profile } from "../contracts/types.js";
|
|
2
|
+
import { type AgentRuntimeOptions } from "./runtime.js";
|
|
3
|
+
export interface AgentProgramOptions {
|
|
4
|
+
readonly version: string;
|
|
5
|
+
readonly signal?: AbortSignal;
|
|
6
|
+
/** Trusted embedding/test home; the installed CLI uses the actual OS home. */
|
|
7
|
+
readonly home?: string;
|
|
8
|
+
readonly runtime?: AgentRuntimeOptions;
|
|
9
|
+
diagnose?(code: string, retry: boolean): void;
|
|
10
|
+
}
|
|
11
|
+
/** Native process entry: one boot/Core survives reconnects; only observations are replaced. */
|
|
12
|
+
export declare function runAgent(profile: Profile, options: AgentProgramOptions): Promise<number>;
|