@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,475 @@
|
|
|
1
|
+
import { EventEmitter } from "node:events";
|
|
2
|
+
import { fork } from "node:child_process";
|
|
3
|
+
import { setTimeout as delay } from "node:timers/promises";
|
|
4
|
+
import path from "node:path";
|
|
5
|
+
import { fileURLToPath } from "node:url";
|
|
6
|
+
import { AgentError, isAgentError, requireCondition, } from "../contracts/errors.js";
|
|
7
|
+
import { WindowsJob } from "./windows-job.js";
|
|
8
|
+
const trustedExecPath = process.execPath;
|
|
9
|
+
const helperUrl = new URL("./windows-helper.js", import.meta.url);
|
|
10
|
+
const helperVariables = new Set([
|
|
11
|
+
"SYSTEMROOT",
|
|
12
|
+
"WINDIR",
|
|
13
|
+
"COMSPEC",
|
|
14
|
+
"TEMP",
|
|
15
|
+
"TMP",
|
|
16
|
+
"USERPROFILE",
|
|
17
|
+
"APPDATA",
|
|
18
|
+
"LOCALAPPDATA",
|
|
19
|
+
]);
|
|
20
|
+
function helperEnvironment() {
|
|
21
|
+
const env = {};
|
|
22
|
+
for (const [key, value] of Object.entries(process.env))
|
|
23
|
+
if (value !== undefined && helperVariables.has(key.toUpperCase()))
|
|
24
|
+
env[key] = value;
|
|
25
|
+
return env;
|
|
26
|
+
}
|
|
27
|
+
function boundedTime(value, fallback) {
|
|
28
|
+
const result = value ?? fallback;
|
|
29
|
+
requireCondition(Number.isInteger(result) && result >= 0 && result <= 60000, "invalid_process_stop_timeout", "Process stop intervals must be integers from 0 through 60000 milliseconds.");
|
|
30
|
+
return result;
|
|
31
|
+
}
|
|
32
|
+
/** Cold, host-private Windows launcher. Public resource registration precedes start. */
|
|
33
|
+
export class WindowsProcessBackend extends EventEmitter {
|
|
34
|
+
closed;
|
|
35
|
+
#resolveClosed;
|
|
36
|
+
#options;
|
|
37
|
+
#failure;
|
|
38
|
+
#state = {
|
|
39
|
+
pid: null,
|
|
40
|
+
startedAt: null,
|
|
41
|
+
rootExited: false,
|
|
42
|
+
exitCode: null,
|
|
43
|
+
exitSignal: null,
|
|
44
|
+
outputComplete: false,
|
|
45
|
+
treeStopped: false,
|
|
46
|
+
closed: false,
|
|
47
|
+
stopRequested: false,
|
|
48
|
+
forceRequested: false,
|
|
49
|
+
};
|
|
50
|
+
#started = false;
|
|
51
|
+
#launch;
|
|
52
|
+
#helper;
|
|
53
|
+
#job;
|
|
54
|
+
#assigned = false;
|
|
55
|
+
#helperClosed = false;
|
|
56
|
+
#outputSettled = false;
|
|
57
|
+
#outputFailed = false;
|
|
58
|
+
#terminalComplete = false;
|
|
59
|
+
#terminalClosed = false;
|
|
60
|
+
#finishing = false;
|
|
61
|
+
#poll;
|
|
62
|
+
#startResult = Promise.withResolvers();
|
|
63
|
+
#startTimer;
|
|
64
|
+
#stopResult;
|
|
65
|
+
#inputTail = Promise.resolve();
|
|
66
|
+
#inputEof = false;
|
|
67
|
+
#controlId = 0;
|
|
68
|
+
#controls = new Map();
|
|
69
|
+
constructor(options) {
|
|
70
|
+
super();
|
|
71
|
+
this.#options = options;
|
|
72
|
+
const closed = Promise.withResolvers();
|
|
73
|
+
this.closed = closed.promise;
|
|
74
|
+
this.#resolveClosed = closed.resolve;
|
|
75
|
+
void this.#startResult.promise.catch(() => { });
|
|
76
|
+
}
|
|
77
|
+
get failure() {
|
|
78
|
+
return this.#failure;
|
|
79
|
+
}
|
|
80
|
+
facts() {
|
|
81
|
+
return Object.freeze({ ...this.#state });
|
|
82
|
+
}
|
|
83
|
+
#change(update = {}) {
|
|
84
|
+
this.#state = { ...this.#state, ...update };
|
|
85
|
+
this.emit("change", this.facts());
|
|
86
|
+
}
|
|
87
|
+
#recordFailure(code, message, cause) {
|
|
88
|
+
const error = new AgentError(code, message, undefined, { cause });
|
|
89
|
+
this.#failure ??= isAgentError(cause) ? cause : error;
|
|
90
|
+
this.#startResult.reject(this.#failure);
|
|
91
|
+
this.#change();
|
|
92
|
+
return error;
|
|
93
|
+
}
|
|
94
|
+
#send(message) {
|
|
95
|
+
const child = this.#helper;
|
|
96
|
+
requireCondition(child?.connected, "windows_helper_disconnected", "The managed Windows helper is disconnected.");
|
|
97
|
+
child.send(message, (error) => {
|
|
98
|
+
if (error && !this.#state.closed) {
|
|
99
|
+
this.#recordFailure("windows_helper_ipc_failed", "The managed Windows helper channel failed.", error);
|
|
100
|
+
this.#force();
|
|
101
|
+
}
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
async start(launch) {
|
|
105
|
+
requireCondition(!this.#started && !this.#state.closed, "process_already_started", "The process backend has already started or closed.");
|
|
106
|
+
this.#started = true;
|
|
107
|
+
try {
|
|
108
|
+
requireCondition(process.platform === "win32", "windows_process_unsupported", "The Windows process backend is available only on Windows.");
|
|
109
|
+
requireCondition(!/\.(?:cmd|bat)$/i.test(launch.file), "windows_batch_direct_unsupported", "Windows batch files require an explicit command shell.");
|
|
110
|
+
requireCondition(path.isAbsolute(launch.file) && path.isAbsolute(launch.cwd), "invalid_process_launch", "The executable and working directory must be absolute paths.");
|
|
111
|
+
this.#launch = launch;
|
|
112
|
+
this.#job = WindowsJob.create();
|
|
113
|
+
this.#helper = fork(helperUrl, [], {
|
|
114
|
+
execPath: trustedExecPath,
|
|
115
|
+
execArgv: [],
|
|
116
|
+
cwd: path.dirname(fileURLToPath(helperUrl)),
|
|
117
|
+
env: helperEnvironment(),
|
|
118
|
+
stdio: ["ignore", "pipe", "pipe", "ipc"],
|
|
119
|
+
serialization: "advanced",
|
|
120
|
+
windowsHide: true,
|
|
121
|
+
});
|
|
122
|
+
const child = this.#helper;
|
|
123
|
+
child.on("message", (message) => this.#message(message));
|
|
124
|
+
child.once("error", (error) => {
|
|
125
|
+
this.#recordFailure("windows_helper_spawn_failed", "The managed Windows helper could not start.", error);
|
|
126
|
+
this.#force();
|
|
127
|
+
});
|
|
128
|
+
child.once("exit", (exitCode) => {
|
|
129
|
+
if (this.#state.pid === null && !this.#failure)
|
|
130
|
+
this.#recordFailure("windows_helper_exited", "The Windows helper exited before the business process started.");
|
|
131
|
+
else if (!this.#state.forceRequested &&
|
|
132
|
+
(!this.#finishing || exitCode !== 0)) {
|
|
133
|
+
this.#outputFailed = true;
|
|
134
|
+
this.#recordFailure("windows_helper_unexpected_exit", "The Windows helper exited without completing the managed output shutdown.");
|
|
135
|
+
}
|
|
136
|
+
if (!this.#finishing)
|
|
137
|
+
this.#force();
|
|
138
|
+
});
|
|
139
|
+
child.once("close", () => {
|
|
140
|
+
this.#helperClosed = true;
|
|
141
|
+
this.#tick();
|
|
142
|
+
});
|
|
143
|
+
const output = Promise.all([
|
|
144
|
+
this.#read(child.stdout, launch.tty ? "terminal" : "stdout"),
|
|
145
|
+
this.#read(child.stderr, launch.tty ? "terminal" : "stderr"),
|
|
146
|
+
]);
|
|
147
|
+
void output.finally(() => {
|
|
148
|
+
this.#outputSettled = true;
|
|
149
|
+
this.#tick();
|
|
150
|
+
});
|
|
151
|
+
this.#poll = setInterval(() => this.#tick(), 20);
|
|
152
|
+
this.#startTimer = setTimeout(() => {
|
|
153
|
+
this.#recordFailure("windows_process_start_timeout", "The Windows business process start was not confirmed in time.");
|
|
154
|
+
this.#force();
|
|
155
|
+
}, 20000);
|
|
156
|
+
await this.#startResult.promise;
|
|
157
|
+
}
|
|
158
|
+
catch (error) {
|
|
159
|
+
this.#failure ??= error;
|
|
160
|
+
this.#startResult.reject(error);
|
|
161
|
+
if (this.#helper)
|
|
162
|
+
this.#force();
|
|
163
|
+
else {
|
|
164
|
+
this.#job?.close();
|
|
165
|
+
this.#change({ outputComplete: true, treeStopped: true, closed: true });
|
|
166
|
+
this.#resolveClosed();
|
|
167
|
+
}
|
|
168
|
+
throw error;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
#message(message) {
|
|
172
|
+
try {
|
|
173
|
+
if (message?.type === "ready") {
|
|
174
|
+
requireCondition(!this.#assigned && this.#job && this.#helper, "windows_helper_invalid_handshake", "The Windows helper handshake is invalid.");
|
|
175
|
+
this.#job.assignChild(this.#helper, message.birth);
|
|
176
|
+
this.#assigned = true;
|
|
177
|
+
if (this.#state.stopRequested)
|
|
178
|
+
this.#force();
|
|
179
|
+
else
|
|
180
|
+
this.#send({ type: "start", launch: this.#launch });
|
|
181
|
+
}
|
|
182
|
+
else if (message?.type === "started") {
|
|
183
|
+
requireCondition(this.#assigned && Number.isInteger(message.pid) && message.pid > 0, "windows_helper_invalid_start", "The Windows helper did not confirm a valid process start.");
|
|
184
|
+
clearTimeout(this.#startTimer);
|
|
185
|
+
this.#change({ pid: message.pid, startedAt: message.startedAt });
|
|
186
|
+
this.#startResult.resolve();
|
|
187
|
+
}
|
|
188
|
+
else if (message?.type === "root-exit") {
|
|
189
|
+
this.#change({ rootExited: true, exitCode: message.exitCode });
|
|
190
|
+
}
|
|
191
|
+
else if (message?.type === "terminal-closed") {
|
|
192
|
+
this.#terminalClosed = true;
|
|
193
|
+
this.#terminalComplete = message.complete;
|
|
194
|
+
if (!message.complete)
|
|
195
|
+
this.#recordFailure("windows_pty_output_incomplete", "The Windows terminal closed without a complete output EOF.");
|
|
196
|
+
}
|
|
197
|
+
else if (message?.type === "input-closed") {
|
|
198
|
+
this.#inputEof = true;
|
|
199
|
+
}
|
|
200
|
+
else if (message?.type === "failed") {
|
|
201
|
+
this.#recordFailure(message.code, "The managed Windows business process failed.", new AgentError(message.code, "The managed Windows business process failed.", message.systemCode === undefined
|
|
202
|
+
? undefined
|
|
203
|
+
: { systemCode: message.systemCode }));
|
|
204
|
+
this.#force();
|
|
205
|
+
}
|
|
206
|
+
else if (message?.type === "ack") {
|
|
207
|
+
const control = this.#controls.get(message.id);
|
|
208
|
+
if (control) {
|
|
209
|
+
this.#controls.delete(message.id);
|
|
210
|
+
clearTimeout(control.timer);
|
|
211
|
+
if (message.ok)
|
|
212
|
+
control.resolve();
|
|
213
|
+
else
|
|
214
|
+
control.reject(new AgentError(message.code ?? "windows_pty_control_failed", "The Windows terminal control operation failed."));
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
this.#tick();
|
|
218
|
+
}
|
|
219
|
+
catch (error) {
|
|
220
|
+
this.#recordFailure("windows_helper_protocol_failed", "The Windows helper handshake or control protocol failed.", error);
|
|
221
|
+
this.#force();
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
async #read(stream, kind) {
|
|
225
|
+
try {
|
|
226
|
+
for await (const chunk of stream) {
|
|
227
|
+
if (this.#outputFailed)
|
|
228
|
+
continue;
|
|
229
|
+
try {
|
|
230
|
+
await this.#options.onOutput(kind, Buffer.from(chunk));
|
|
231
|
+
}
|
|
232
|
+
catch (error) {
|
|
233
|
+
this.#outputFailed = true;
|
|
234
|
+
this.#recordFailure("process_output_failed", "The managed process output consumer failed.", error);
|
|
235
|
+
this.#force();
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
catch (error) {
|
|
240
|
+
this.#outputFailed = true;
|
|
241
|
+
this.#recordFailure("process_output_failed", "The managed process output stream failed.", error);
|
|
242
|
+
this.#force();
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
#force() {
|
|
246
|
+
if (this.#state.closed)
|
|
247
|
+
return;
|
|
248
|
+
this.#change({ forceRequested: true });
|
|
249
|
+
try {
|
|
250
|
+
if (this.#assigned)
|
|
251
|
+
this.#job.terminate(1);
|
|
252
|
+
else if (this.#helper &&
|
|
253
|
+
this.#helper.exitCode === null &&
|
|
254
|
+
this.#helper.signalCode === null)
|
|
255
|
+
this.#helper.kill(); // Only our privately retained, not-yet-assigned helper.
|
|
256
|
+
}
|
|
257
|
+
catch (error) {
|
|
258
|
+
this.#failure ??= isAgentError(error)
|
|
259
|
+
? error
|
|
260
|
+
: new AgentError("windows_process_stop_failed", "The Windows process tree stop could not be delivered.", undefined, { cause: error });
|
|
261
|
+
this.#change();
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
#tick() {
|
|
265
|
+
if (this.#state.closed || !this.#job)
|
|
266
|
+
return;
|
|
267
|
+
try {
|
|
268
|
+
const active = this.#job.queryAccounting().activeProcesses;
|
|
269
|
+
if (this.#assigned &&
|
|
270
|
+
this.#state.pid !== null &&
|
|
271
|
+
!this.#finishing &&
|
|
272
|
+
this.#state.rootExited &&
|
|
273
|
+
active === 1 &&
|
|
274
|
+
(!this.#launch.tty || this.#terminalClosed)) {
|
|
275
|
+
this.#finishing = true;
|
|
276
|
+
this.#send({ type: "finish" });
|
|
277
|
+
}
|
|
278
|
+
if (active === 0 && this.#helperClosed && !this.#state.treeStopped)
|
|
279
|
+
this.#change({
|
|
280
|
+
treeStopped: true,
|
|
281
|
+
rootExited: this.#state.pid !== null || this.#state.rootExited,
|
|
282
|
+
});
|
|
283
|
+
if (active !== 0 || !this.#helperClosed || !this.#outputSettled)
|
|
284
|
+
return;
|
|
285
|
+
if (this.#state.forceRequested &&
|
|
286
|
+
this.#launch?.tty &&
|
|
287
|
+
!this.#terminalComplete) {
|
|
288
|
+
// The Job and both helper streams have physically closed. Forced
|
|
289
|
+
// helper termination can lose the ConPTY tail: that is a known output
|
|
290
|
+
// failure, not an indefinitely unknown process lifetime or a fake EOF.
|
|
291
|
+
this.#outputFailed = true;
|
|
292
|
+
this.#failure ??= new AgentError("process_output_failed", "The forced Windows terminal shutdown could not retain a complete output tail.");
|
|
293
|
+
}
|
|
294
|
+
this.#job.close();
|
|
295
|
+
clearInterval(this.#poll);
|
|
296
|
+
clearTimeout(this.#startTimer);
|
|
297
|
+
for (const control of this.#controls.values()) {
|
|
298
|
+
clearTimeout(control.timer);
|
|
299
|
+
control.reject(new AgentError("process_closed", "The managed process has closed."));
|
|
300
|
+
}
|
|
301
|
+
this.#controls.clear();
|
|
302
|
+
this.#change({
|
|
303
|
+
rootExited: this.#state.pid !== null || this.#state.rootExited,
|
|
304
|
+
treeStopped: true,
|
|
305
|
+
outputComplete: !this.#outputFailed && (!this.#launch?.tty || this.#terminalComplete),
|
|
306
|
+
closed: true,
|
|
307
|
+
});
|
|
308
|
+
this.#startResult.reject(this.#failure ??
|
|
309
|
+
new AgentError("process_closed", "The managed process closed before start completed."));
|
|
310
|
+
this.#resolveClosed();
|
|
311
|
+
}
|
|
312
|
+
catch (error) {
|
|
313
|
+
this.#failure ??= isAgentError(error)
|
|
314
|
+
? error
|
|
315
|
+
: new AgentError("windows_job_query_failed", "The actual Windows Job state could not be confirmed.", undefined, { cause: error });
|
|
316
|
+
this.#change();
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
async write(data, eof, signal) {
|
|
320
|
+
signal.throwIfAborted();
|
|
321
|
+
requireCondition(!(this.#launch?.tty && eof), "pty_eof_unsupported", "A terminal does not support pipe EOF; use terminal input or stop.");
|
|
322
|
+
const bytes = Buffer.from(data);
|
|
323
|
+
const operation = this.#inputTail.then(async () => {
|
|
324
|
+
signal.throwIfAborted();
|
|
325
|
+
requireCondition(this.#state.pid !== null &&
|
|
326
|
+
!this.#state.rootExited &&
|
|
327
|
+
!this.#state.closed &&
|
|
328
|
+
!this.#inputEof, "process_input_closed", "The managed process input is unavailable or closed.");
|
|
329
|
+
// At most one 64KiB input frame awaits the actual business sink callback.
|
|
330
|
+
// An aborted caller stops waiting but does not release this internal queue
|
|
331
|
+
// until the already-sent frame settles, preventing unbounded IPC buildup.
|
|
332
|
+
for (let offset = 0; offset < bytes.length; offset += 64 * 1024) {
|
|
333
|
+
signal.throwIfAborted();
|
|
334
|
+
await this.#input(bytes.subarray(offset, offset + 64 * 1024), false);
|
|
335
|
+
}
|
|
336
|
+
if (eof) {
|
|
337
|
+
signal.throwIfAborted();
|
|
338
|
+
this.#inputEof = true;
|
|
339
|
+
await this.#input(Buffer.alloc(0), true);
|
|
340
|
+
}
|
|
341
|
+
});
|
|
342
|
+
this.#inputTail = operation.catch(() => { });
|
|
343
|
+
return this.#abortable(operation, signal);
|
|
344
|
+
}
|
|
345
|
+
#input(data, eof) {
|
|
346
|
+
const id = ++this.#controlId;
|
|
347
|
+
return new Promise((resolve, reject) => {
|
|
348
|
+
this.#controls.set(id, { resolve, reject });
|
|
349
|
+
try {
|
|
350
|
+
this.#send({ type: "input", id, data, eof });
|
|
351
|
+
}
|
|
352
|
+
catch (error) {
|
|
353
|
+
this.#controls.delete(id);
|
|
354
|
+
reject(error);
|
|
355
|
+
}
|
|
356
|
+
});
|
|
357
|
+
}
|
|
358
|
+
#abortable(operation, signal) {
|
|
359
|
+
return new Promise((resolve, reject) => {
|
|
360
|
+
const aborted = () => reject(signal.reason);
|
|
361
|
+
signal.addEventListener("abort", aborted, { once: true });
|
|
362
|
+
if (signal.aborted)
|
|
363
|
+
aborted();
|
|
364
|
+
void operation.then(() => {
|
|
365
|
+
signal.removeEventListener("abort", aborted);
|
|
366
|
+
resolve();
|
|
367
|
+
}, (error) => {
|
|
368
|
+
signal.removeEventListener("abort", aborted);
|
|
369
|
+
reject(error);
|
|
370
|
+
});
|
|
371
|
+
});
|
|
372
|
+
}
|
|
373
|
+
#control(action, cols, rows) {
|
|
374
|
+
requireCondition(this.#launch?.tty &&
|
|
375
|
+
this.#state.pid !== null &&
|
|
376
|
+
!this.#state.rootExited &&
|
|
377
|
+
!this.#state.closed, "process_terminal_unavailable", "A live managed terminal is required for this operation.");
|
|
378
|
+
const id = ++this.#controlId;
|
|
379
|
+
return new Promise((resolve, reject) => {
|
|
380
|
+
const timer = setTimeout(() => {
|
|
381
|
+
this.#controls.delete(id);
|
|
382
|
+
reject(new AgentError("windows_pty_control_timeout", "The terminal control operation was not confirmed in time."));
|
|
383
|
+
}, 5000);
|
|
384
|
+
this.#controls.set(id, { resolve, reject, timer });
|
|
385
|
+
try {
|
|
386
|
+
this.#send({
|
|
387
|
+
type: "control",
|
|
388
|
+
id,
|
|
389
|
+
action,
|
|
390
|
+
...(cols === undefined ? {} : { cols, rows }),
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
catch (error) {
|
|
394
|
+
clearTimeout(timer);
|
|
395
|
+
this.#controls.delete(id);
|
|
396
|
+
reject(error);
|
|
397
|
+
}
|
|
398
|
+
});
|
|
399
|
+
}
|
|
400
|
+
async resize(cols, rows) {
|
|
401
|
+
requireCondition(Number.isInteger(cols) &&
|
|
402
|
+
cols > 0 &&
|
|
403
|
+
cols <= 10000 &&
|
|
404
|
+
Number.isInteger(rows) &&
|
|
405
|
+
rows > 0 &&
|
|
406
|
+
rows <= 10000, "invalid_terminal_size", "Terminal columns and rows must be positive bounded integers.");
|
|
407
|
+
await this.#control("resize", cols, rows);
|
|
408
|
+
}
|
|
409
|
+
async signal(signal) {
|
|
410
|
+
requireCondition(this.#state.pid !== null && !this.#state.closed, "process_closed", "The managed process is unavailable or closed.");
|
|
411
|
+
if (signal === "SIGKILL") {
|
|
412
|
+
this.#job.terminate(1);
|
|
413
|
+
this.#change({ forceRequested: true });
|
|
414
|
+
return { requested: signal, delivered: true, mechanism: "job-object" };
|
|
415
|
+
}
|
|
416
|
+
if (signal === "SIGINT" && this.#launch?.tty) {
|
|
417
|
+
await this.#control("interrupt");
|
|
418
|
+
return {
|
|
419
|
+
requested: signal,
|
|
420
|
+
delivered: true,
|
|
421
|
+
mechanism: "terminal-input",
|
|
422
|
+
};
|
|
423
|
+
}
|
|
424
|
+
throw new AgentError("process_signal_unsupported", "This Windows signal cannot be delivered through the managed backend.");
|
|
425
|
+
}
|
|
426
|
+
async #waitClosed(timeoutMs) {
|
|
427
|
+
if (this.#state.closed)
|
|
428
|
+
return true;
|
|
429
|
+
const controller = new AbortController();
|
|
430
|
+
const timeout = delay(timeoutMs, false, { signal: controller.signal });
|
|
431
|
+
try {
|
|
432
|
+
return await Promise.race([this.closed.then(() => true), timeout]);
|
|
433
|
+
}
|
|
434
|
+
finally {
|
|
435
|
+
controller.abort();
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
async stop(options = {}) {
|
|
439
|
+
const graceMs = boundedTime(options.graceMs, 1000);
|
|
440
|
+
const forceMs = boundedTime(options.forceMs, 5000);
|
|
441
|
+
if (this.#state.closed)
|
|
442
|
+
return { confirmed: true, facts: this.facts() };
|
|
443
|
+
if (this.#stopResult)
|
|
444
|
+
return this.#stopResult;
|
|
445
|
+
this.#stopResult = (async () => {
|
|
446
|
+
this.#change({ stopRequested: true });
|
|
447
|
+
if (!this.#started) {
|
|
448
|
+
this.#change({ outputComplete: true, treeStopped: true, closed: true });
|
|
449
|
+
this.#resolveClosed();
|
|
450
|
+
return { confirmed: true, facts: this.facts() };
|
|
451
|
+
}
|
|
452
|
+
if (this.#state.pid !== null && !this.#state.rootExited && graceMs > 0) {
|
|
453
|
+
if (this.#launch?.tty) {
|
|
454
|
+
void this.#control("interrupt").catch(() => { });
|
|
455
|
+
}
|
|
456
|
+
else if (!this.#inputEof)
|
|
457
|
+
void this.write(Buffer.alloc(0), true, new AbortController().signal).catch(() => { });
|
|
458
|
+
}
|
|
459
|
+
if (!(await this.#waitClosed(graceMs)))
|
|
460
|
+
this.#force();
|
|
461
|
+
const confirmed = await this.#waitClosed(forceMs);
|
|
462
|
+
return { confirmed, facts: this.facts() };
|
|
463
|
+
})();
|
|
464
|
+
try {
|
|
465
|
+
return await this.#stopResult;
|
|
466
|
+
}
|
|
467
|
+
finally {
|
|
468
|
+
this.#stopResult = undefined;
|
|
469
|
+
}
|
|
470
|
+
}
|
|
471
|
+
async dispose() {
|
|
472
|
+
await this.stop();
|
|
473
|
+
}
|
|
474
|
+
}
|
|
475
|
+
//# sourceMappingURL=windows-pipes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"windows-pipes.js","sourceRoot":"","sources":["../../src/process/windows-pipes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import { Blob } from "node:buffer";
|
|
2
|
+
import { Readable } from "node:stream";
|
|
3
|
+
export interface ArtifactRecord {
|
|
4
|
+
readonly resourceId: string;
|
|
5
|
+
readonly agentId: string;
|
|
6
|
+
readonly uri: string;
|
|
7
|
+
readonly name: string;
|
|
8
|
+
readonly mimeType: string;
|
|
9
|
+
readonly size: number;
|
|
10
|
+
readonly sha256: string;
|
|
11
|
+
readonly originRunId: string | null;
|
|
12
|
+
readonly createdAt: string;
|
|
13
|
+
readonly expiresAt: string;
|
|
14
|
+
}
|
|
15
|
+
export interface ArtifactSource {
|
|
16
|
+
readonly path?: string;
|
|
17
|
+
readonly data?: ArrayBuffer | SharedArrayBuffer | ArrayBufferView | Blob;
|
|
18
|
+
readonly name?: string;
|
|
19
|
+
readonly mimeType?: string;
|
|
20
|
+
}
|
|
21
|
+
export interface ArtifactAccess {
|
|
22
|
+
readonly action: "register" | "read" | "list";
|
|
23
|
+
readonly uri?: string;
|
|
24
|
+
readonly path?: string;
|
|
25
|
+
readonly resource?: ArtifactRecord & {
|
|
26
|
+
readonly ownerKey: string;
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
export interface ArtifactScope {
|
|
30
|
+
readonly pwd: string;
|
|
31
|
+
readonly ownerKey: string;
|
|
32
|
+
readonly runId?: string;
|
|
33
|
+
readonly signal?: AbortSignal;
|
|
34
|
+
/** Trusted Core control-source verdict; never parsed from a script result. */
|
|
35
|
+
readonly controlStorage?: boolean;
|
|
36
|
+
assertCurrent(): void;
|
|
37
|
+
authorize(target: ArtifactAccess): void;
|
|
38
|
+
}
|
|
39
|
+
export interface ArtifactOptions {
|
|
40
|
+
readonly maxFileBytes?: number;
|
|
41
|
+
readonly maxReadBytes?: number;
|
|
42
|
+
readonly retentionMs?: number;
|
|
43
|
+
readonly now?: () => number;
|
|
44
|
+
/** Core retention facts, never a guest callback or a substitute for current read permission. */
|
|
45
|
+
readonly retentionUntil?: (resourceId: string, originRunId: string | null, originalExpiresAt: number) => number;
|
|
46
|
+
readonly reserve?: (bytes: number, options?: {
|
|
47
|
+
readonly control?: boolean;
|
|
48
|
+
}) => Promise<{
|
|
49
|
+
release(): void;
|
|
50
|
+
}>;
|
|
51
|
+
}
|
|
52
|
+
export interface ArtifactPage {
|
|
53
|
+
readonly resources: readonly ArtifactRecord[];
|
|
54
|
+
readonly nextCursor: string | null;
|
|
55
|
+
}
|
|
56
|
+
export type ArtifactInspector = (fixed: {
|
|
57
|
+
readonly path: string;
|
|
58
|
+
readonly size: number;
|
|
59
|
+
readonly name: string;
|
|
60
|
+
readonly mimeType: string;
|
|
61
|
+
}) => Promise<{
|
|
62
|
+
readonly mimeType?: string;
|
|
63
|
+
}>;
|
|
64
|
+
export interface BlobSnapshot {
|
|
65
|
+
readonly blob: Blob;
|
|
66
|
+
/** Node's declared length; every consumer must also count the actual stream. */
|
|
67
|
+
readonly size: number;
|
|
68
|
+
readonly mimeType: string;
|
|
69
|
+
readonly name?: string;
|
|
70
|
+
readonly lastModified?: number;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Node's public Blob getters inspect JS Symbol fields; they are not brand probes.
|
|
74
|
+
* This proves execution-safe native identity, not opaque queue byte length.
|
|
75
|
+
* Consumers must use bounded streams rather than size-then-arrayBuffer/text.
|
|
76
|
+
*/
|
|
77
|
+
export declare function snapshotBlob(value: unknown, maximum?: number): BlobSnapshot | null;
|
|
78
|
+
export declare function artifactUri(agentId: string, id: string): string;
|
|
79
|
+
export declare function parseArtifactUri(uri: string): {
|
|
80
|
+
agentId: string;
|
|
81
|
+
resourceId: string;
|
|
82
|
+
};
|
|
83
|
+
/** Fixed content and its directory catalog belong to one Agent/profile. */
|
|
84
|
+
export declare class ArtifactStore {
|
|
85
|
+
#private;
|
|
86
|
+
readonly root: string;
|
|
87
|
+
readonly agentId: string;
|
|
88
|
+
readonly directory: string;
|
|
89
|
+
readonly maxFileBytes: number;
|
|
90
|
+
readonly maxReadBytes: number;
|
|
91
|
+
readonly retentionMs: number;
|
|
92
|
+
constructor(root: string, agentId: string, options?: ArtifactOptions);
|
|
93
|
+
activeSnapshot(): {
|
|
94
|
+
readonly resourceIds: ReadonlySet<string>;
|
|
95
|
+
readonly pendingPaths: ReadonlySet<string>;
|
|
96
|
+
};
|
|
97
|
+
register(value: ArtifactSource, scope: ArtifactScope, inspect?: ArtifactInspector, options?: {
|
|
98
|
+
readonly maxBytes?: number;
|
|
99
|
+
}): Promise<ArtifactRecord>;
|
|
100
|
+
metadata(uri: string, scope: ArtifactScope): Promise<ArtifactRecord>;
|
|
101
|
+
list(scope: ArtifactScope, options?: {
|
|
102
|
+
limit?: number;
|
|
103
|
+
cursor?: string;
|
|
104
|
+
/** Trusted current page budget, counted before advancing its cursor. */
|
|
105
|
+
maxBytes?: number;
|
|
106
|
+
}): Promise<ArtifactPage>;
|
|
107
|
+
open(uri: string, scope: ArtifactScope): Promise<{
|
|
108
|
+
resource: ArtifactRecord;
|
|
109
|
+
stream: Readable;
|
|
110
|
+
closed: Promise<void>;
|
|
111
|
+
}>;
|
|
112
|
+
read(uri: string, scope: ArtifactScope, options: {
|
|
113
|
+
maxBytes: number;
|
|
114
|
+
}): Promise<{
|
|
115
|
+
resource: ArtifactRecord;
|
|
116
|
+
data: Buffer;
|
|
117
|
+
}>;
|
|
118
|
+
}
|