@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,137 @@
|
|
|
1
|
+
import { types } from "node:util";
|
|
2
|
+
import { AgentError } from "../contracts/errors.js";
|
|
3
|
+
import { safeErrorData } from "../contracts/error-data.js";
|
|
4
|
+
import { NativePromiseAudit } from "./promises.js";
|
|
5
|
+
export class RunOperations {
|
|
6
|
+
store;
|
|
7
|
+
runId;
|
|
8
|
+
current;
|
|
9
|
+
fatal;
|
|
10
|
+
changed;
|
|
11
|
+
audit = new NativePromiseAudit();
|
|
12
|
+
#pending = new Set();
|
|
13
|
+
constructor(store, runId, current, fatal, changed) {
|
|
14
|
+
this.store = store;
|
|
15
|
+
this.runId = runId;
|
|
16
|
+
this.current = current;
|
|
17
|
+
this.fatal = fatal;
|
|
18
|
+
this.changed = changed;
|
|
19
|
+
}
|
|
20
|
+
start(origin, method, action, hooks = {}) {
|
|
21
|
+
this.current();
|
|
22
|
+
const record = this.store.startOperation(this.runId, origin, method);
|
|
23
|
+
this.changed();
|
|
24
|
+
let value;
|
|
25
|
+
try {
|
|
26
|
+
this.current();
|
|
27
|
+
value = this.audit.run(() => action(record.operationId));
|
|
28
|
+
}
|
|
29
|
+
catch (cause) {
|
|
30
|
+
const error = this.#failure(cause, hooks);
|
|
31
|
+
try {
|
|
32
|
+
this.#finish(record.operationId, "failed", error);
|
|
33
|
+
}
|
|
34
|
+
finally {
|
|
35
|
+
hooks.settled?.();
|
|
36
|
+
}
|
|
37
|
+
throw error;
|
|
38
|
+
}
|
|
39
|
+
let asynchronous;
|
|
40
|
+
try {
|
|
41
|
+
asynchronous =
|
|
42
|
+
types.isPromise(value) ||
|
|
43
|
+
(value !== null &&
|
|
44
|
+
(typeof value === "object" || typeof value === "function") &&
|
|
45
|
+
typeof value.then === "function");
|
|
46
|
+
}
|
|
47
|
+
catch (error) {
|
|
48
|
+
this.fatal(error);
|
|
49
|
+
throw new AgentError("operation_observation_failed", "The operation returned a value whose completion could not be observed.");
|
|
50
|
+
}
|
|
51
|
+
if (!asynchronous) {
|
|
52
|
+
return this.#succeed(record.operationId, value, hooks);
|
|
53
|
+
}
|
|
54
|
+
let persisted;
|
|
55
|
+
try {
|
|
56
|
+
persisted = this.audit.run(() => Promise.resolve(value).then((result) => {
|
|
57
|
+
return this.#succeed(record.operationId, result, hooks);
|
|
58
|
+
}, (cause) => {
|
|
59
|
+
const error = this.#failure(cause, hooks);
|
|
60
|
+
try {
|
|
61
|
+
this.#finish(record.operationId, "failed", error);
|
|
62
|
+
}
|
|
63
|
+
finally {
|
|
64
|
+
hooks.settled?.();
|
|
65
|
+
}
|
|
66
|
+
throw error;
|
|
67
|
+
}));
|
|
68
|
+
}
|
|
69
|
+
catch (error) {
|
|
70
|
+
// An inability to observe the real Promise does not prove its underlying work stopped.
|
|
71
|
+
this.fatal(error);
|
|
72
|
+
throw new AgentError("operation_observation_failed", "The operation could not attach its native completion observer.");
|
|
73
|
+
}
|
|
74
|
+
// The internal observer waits for real settlement and persistence. It does
|
|
75
|
+
// not mark the separately returned public Promise as handled by the script.
|
|
76
|
+
const settled = persisted.then(() => { }, () => { });
|
|
77
|
+
this.#pending.add(settled);
|
|
78
|
+
void settled.then(() => {
|
|
79
|
+
this.#pending.delete(settled);
|
|
80
|
+
});
|
|
81
|
+
return this.audit.run(() => persisted.then((value) => value));
|
|
82
|
+
}
|
|
83
|
+
#failure(cause, hooks) {
|
|
84
|
+
try {
|
|
85
|
+
return hooks.failure ? hooks.failure(cause) : cause;
|
|
86
|
+
}
|
|
87
|
+
catch (replacement) {
|
|
88
|
+
return replacement;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
#succeed(id, value, hooks) {
|
|
92
|
+
let result;
|
|
93
|
+
try {
|
|
94
|
+
result = hooks.complete ? hooks.complete(value) : value;
|
|
95
|
+
}
|
|
96
|
+
catch (cause) {
|
|
97
|
+
const error = this.#failure(cause, hooks);
|
|
98
|
+
try {
|
|
99
|
+
this.#finish(id, "failed", error);
|
|
100
|
+
}
|
|
101
|
+
finally {
|
|
102
|
+
hooks.settled?.();
|
|
103
|
+
}
|
|
104
|
+
throw error;
|
|
105
|
+
}
|
|
106
|
+
try {
|
|
107
|
+
this.#finish(id, "succeeded");
|
|
108
|
+
return result;
|
|
109
|
+
}
|
|
110
|
+
finally {
|
|
111
|
+
hooks.settled?.();
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
#finish(id, status, cause) {
|
|
115
|
+
try {
|
|
116
|
+
const error = status === "succeeded"
|
|
117
|
+
? undefined
|
|
118
|
+
: safeErrorData(cause, {
|
|
119
|
+
code: "sdk_operation_failed",
|
|
120
|
+
message: "The SDK operation failed; its source and run are retained locally.",
|
|
121
|
+
});
|
|
122
|
+
this.store.finishOperation(id, status, error);
|
|
123
|
+
this.changed();
|
|
124
|
+
}
|
|
125
|
+
catch (error) {
|
|
126
|
+
this.fatal(error);
|
|
127
|
+
throw new AgentError("operation_persistence_failed", "The operation could not save its completion; do not retry it automatically.", { operationId: id });
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
async settle() {
|
|
131
|
+
// Handlers can register nested managed operations before they settle.
|
|
132
|
+
while (this.#pending.size)
|
|
133
|
+
await Promise.allSettled([...this.#pending]);
|
|
134
|
+
await this.audit.checkpoint();
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
//# sourceMappingURL=operations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/runtime/operations.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { lstatSync, mkdirSync, realpathSync, renameSync, rmSync, writeFileSync, } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { newId } from "../contracts/json.js";
|
|
4
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
5
|
+
export function contains(root, candidate) {
|
|
6
|
+
const relative = path.relative(root, candidate);
|
|
7
|
+
return (relative !== ".." &&
|
|
8
|
+
!relative.startsWith(".." + path.sep) &&
|
|
9
|
+
!path.isAbsolute(relative));
|
|
10
|
+
}
|
|
11
|
+
// Internal persistence helpers, not a public filesystem SDK.
|
|
12
|
+
export function privateDirectory(root, ...parts) {
|
|
13
|
+
const boundary = realpathSync.native(root);
|
|
14
|
+
requireCondition(boundary === root, "storage_path_escape", "The established internal root must not redirect to another location.");
|
|
15
|
+
let current = boundary;
|
|
16
|
+
for (const part of parts) {
|
|
17
|
+
requireCondition(part !== "." && part !== ".." && /^[A-Za-z0-9_.-]+$/.test(part), "invalid_path", "Invalid internal directory component.");
|
|
18
|
+
const next = path.join(current, part);
|
|
19
|
+
const existing = lstatSync(next, { throwIfNoEntry: false });
|
|
20
|
+
requireCondition(!existing || existing.isDirectory(), "storage_path_escape", "An internal directory must be a directory and must not redirect to another location.");
|
|
21
|
+
if (!existing)
|
|
22
|
+
mkdirSync(next, { recursive: false, mode: 0o700 });
|
|
23
|
+
current = realpathSync.native(next);
|
|
24
|
+
requireCondition(contains(boundary, current), "storage_path_escape", "An internal directory escapes its profile.");
|
|
25
|
+
}
|
|
26
|
+
return current;
|
|
27
|
+
}
|
|
28
|
+
export function atomicText(filename, text) {
|
|
29
|
+
const temporary = path.join(path.dirname(filename), "." + newId("write"));
|
|
30
|
+
try {
|
|
31
|
+
writeFileSync(temporary, text, { flag: "wx", mode: 0o600 });
|
|
32
|
+
renameSync(temporary, filename);
|
|
33
|
+
}
|
|
34
|
+
finally {
|
|
35
|
+
rmSync(temporary, { force: true });
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,UAAU,EACV,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,CACL,QAAQ,KAAK,IAAI;QACjB,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;QACrC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,GAAG,KAAe;IAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,gBAAgB,CACd,QAAQ,KAAK,IAAI,EACjB,qBAAqB,EACrB,sEAAsE,CACvE,CAAC;IACF,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,gBAAgB,CACd,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAC/D,cAAc,EACd,uCAAuC,CACxC,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,gBAAgB,CACd,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,EAAE,EACnC,qBAAqB,EACrB,sFAAsF,CACvF,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,gBAAgB,CACd,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAC3B,qBAAqB,EACrB,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAY;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
|
+
import { promiseHooks } from "node:v8";
|
|
3
|
+
import { setImmediate } from "node:timers/promises";
|
|
4
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
5
|
+
// Observe Node's own Promise lifecycle. No Promise subclass, patched then(),
|
|
6
|
+
// thenable executor, or substitute cancellation protocol is introduced.
|
|
7
|
+
const current = new AsyncLocalStorage();
|
|
8
|
+
const owners = new WeakMap();
|
|
9
|
+
const active = new Set();
|
|
10
|
+
let stop;
|
|
11
|
+
function unhandled(reason, promise) {
|
|
12
|
+
const owner = owners.get(promise);
|
|
13
|
+
if (owner && active.has(owner)) {
|
|
14
|
+
owner.rejected(promise);
|
|
15
|
+
return;
|
|
16
|
+
}
|
|
17
|
+
// A runtime listener must not quietly swallow unrelated Agent failures.
|
|
18
|
+
// Existing process listeners retain their normal responsibility when present.
|
|
19
|
+
if (process.listenerCount("unhandledRejection") === 1)
|
|
20
|
+
queueMicrotask(() => {
|
|
21
|
+
throw reason instanceof Error
|
|
22
|
+
? reason
|
|
23
|
+
: new Error("An unowned asynchronous operation failed.");
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
function handled(promise) {
|
|
27
|
+
owners.get(promise)?.handled(promise);
|
|
28
|
+
}
|
|
29
|
+
function monitor() {
|
|
30
|
+
if (stop)
|
|
31
|
+
return;
|
|
32
|
+
const close = promiseHooks.onInit((promise, parent) => {
|
|
33
|
+
const owner = current.getStore() ?? (parent && owners.get(parent));
|
|
34
|
+
if (owner)
|
|
35
|
+
owners.set(promise, owner);
|
|
36
|
+
});
|
|
37
|
+
stop = () => close();
|
|
38
|
+
process.on("unhandledRejection", unhandled);
|
|
39
|
+
process.on("rejectionHandled", handled);
|
|
40
|
+
}
|
|
41
|
+
export class NativePromiseAudit {
|
|
42
|
+
#unhandled = new WeakSet();
|
|
43
|
+
#count = 0;
|
|
44
|
+
constructor() {
|
|
45
|
+
active.add(this);
|
|
46
|
+
monitor();
|
|
47
|
+
}
|
|
48
|
+
run(action) {
|
|
49
|
+
requireCondition(active.has(this), "run_closed", "The originating asynchronous scope is closed.");
|
|
50
|
+
return current.run(this, action);
|
|
51
|
+
}
|
|
52
|
+
rejected(promise) {
|
|
53
|
+
if (!this.#unhandled.has(promise)) {
|
|
54
|
+
this.#unhandled.add(promise);
|
|
55
|
+
this.#count++;
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
handled(promise) {
|
|
59
|
+
if (this.#unhandled.delete(promise))
|
|
60
|
+
this.#count--;
|
|
61
|
+
}
|
|
62
|
+
async checkpoint() {
|
|
63
|
+
// Node emits rejection/handled events across a turn. Caught SDK errors are
|
|
64
|
+
// business outcomes, while an ignored or propagated rejection remains an error.
|
|
65
|
+
await setImmediate();
|
|
66
|
+
requireCondition(this.#count === 0, "unhandled_async_error", "The run has asynchronous failures that were not handled.", { count: this.#count });
|
|
67
|
+
}
|
|
68
|
+
close() {
|
|
69
|
+
active.delete(this);
|
|
70
|
+
if (active.size === 0 && stop) {
|
|
71
|
+
stop();
|
|
72
|
+
stop = undefined;
|
|
73
|
+
process.off("unhandledRejection", unhandled);
|
|
74
|
+
process.off("rejectionHandled", handled);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=promises.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"promises.js","sourceRoot":"","sources":["../../src/runtime/promises.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { MaterialRetention } from "./material-retention.js";
|
|
2
|
+
export interface RetentionFile {
|
|
3
|
+
readonly kind: "run" | "log" | "task" | "process_log" | "inputs";
|
|
4
|
+
readonly ref: string;
|
|
5
|
+
}
|
|
6
|
+
export interface RetentionStore {
|
|
7
|
+
readonly root: string;
|
|
8
|
+
readonly binding: {
|
|
9
|
+
readonly agentId: string;
|
|
10
|
+
};
|
|
11
|
+
cleanupBatch(input: {
|
|
12
|
+
now?: number;
|
|
13
|
+
limit?: number;
|
|
14
|
+
}): {
|
|
15
|
+
processed: number;
|
|
16
|
+
deleted: Record<string, number>;
|
|
17
|
+
files: readonly RetentionFile[];
|
|
18
|
+
};
|
|
19
|
+
activeRunIds(): ReadonlySet<string>;
|
|
20
|
+
completeInputsCleanup(runId: string, now?: number): void;
|
|
21
|
+
protectedArtifactIds(now: number): ReadonlySet<string>;
|
|
22
|
+
taskArtifactRetentionUntil(id: string, originRunId: string | null, now: number): number | null;
|
|
23
|
+
}
|
|
24
|
+
export interface RetentionArtifacts {
|
|
25
|
+
readonly root: string;
|
|
26
|
+
readonly directory: string;
|
|
27
|
+
activeSnapshot(): {
|
|
28
|
+
readonly resourceIds: ReadonlySet<string>;
|
|
29
|
+
readonly pendingPaths: ReadonlySet<string>;
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
export interface ManagedUsage {
|
|
33
|
+
readonly bytes: number;
|
|
34
|
+
readonly files: number;
|
|
35
|
+
readonly directories: number;
|
|
36
|
+
readonly symlinks: number;
|
|
37
|
+
readonly observedAt: number;
|
|
38
|
+
readonly complete: boolean;
|
|
39
|
+
}
|
|
40
|
+
export interface RetentionSweep {
|
|
41
|
+
readonly processed: number;
|
|
42
|
+
readonly deleted: Readonly<Record<string, number>>;
|
|
43
|
+
readonly removedFiles: number;
|
|
44
|
+
readonly removedArtifacts: number;
|
|
45
|
+
readonly removedMaterials: number;
|
|
46
|
+
readonly protectedArtifacts: number;
|
|
47
|
+
readonly pendingInputDirectories: number;
|
|
48
|
+
readonly errors: readonly {
|
|
49
|
+
readonly code: string;
|
|
50
|
+
readonly ref: string;
|
|
51
|
+
}[];
|
|
52
|
+
}
|
|
53
|
+
export interface SpaceReservation {
|
|
54
|
+
release(): void;
|
|
55
|
+
}
|
|
56
|
+
export interface RetentionOptions {
|
|
57
|
+
readonly now?: () => number;
|
|
58
|
+
readonly intervalMs?: number;
|
|
59
|
+
readonly maxManagedBytes?: number;
|
|
60
|
+
readonly controlHeadroomBytes?: number;
|
|
61
|
+
readonly materialRetention?: MaterialRetention;
|
|
62
|
+
readonly onError?: (error: unknown) => void;
|
|
63
|
+
}
|
|
64
|
+
/** Cold, profile-bound cleanup and admission. Raw Node/npm/project writes are not intercepted.
|
|
65
|
+
* Callers reserve before real managed allocation and release only after its I/O settles.
|
|
66
|
+
* Pending reservations are counted conservatively even while their writes become visible.
|
|
67
|
+
*/
|
|
68
|
+
export declare class ProfileRetention {
|
|
69
|
+
#private;
|
|
70
|
+
readonly store: RetentionStore;
|
|
71
|
+
readonly artifacts: RetentionArtifacts;
|
|
72
|
+
readonly options: RetentionOptions;
|
|
73
|
+
readonly maxManagedBytes: number;
|
|
74
|
+
readonly intervalMs: number;
|
|
75
|
+
readonly controlHeadroomBytes: number;
|
|
76
|
+
readonly root: string;
|
|
77
|
+
lastError: unknown;
|
|
78
|
+
constructor(store: RetentionStore, artifacts: RetentionArtifacts, options?: RetentionOptions);
|
|
79
|
+
get reservedBytes(): number;
|
|
80
|
+
open(): Promise<void>;
|
|
81
|
+
start(): Promise<void>;
|
|
82
|
+
stop(): Promise<void>;
|
|
83
|
+
measure(): Promise<ManagedUsage>;
|
|
84
|
+
reserve(bytes: number, options?: {
|
|
85
|
+
readonly control?: boolean;
|
|
86
|
+
}): Promise<SpaceReservation>;
|
|
87
|
+
sweep(): Promise<RetentionSweep>;
|
|
88
|
+
}
|