@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,242 @@
|
|
|
1
|
+
import { lstatSync, readFileSync, realpathSync } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { createHash } from "node:crypto";
|
|
4
|
+
import { types } from "node:util";
|
|
5
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
6
|
+
import { atomicText, privateDirectory } from "./paths.js";
|
|
7
|
+
// Installed Agent metadata is trusted program input. Importing this module only
|
|
8
|
+
// reads it; platform files are written solely by explicit initialization below.
|
|
9
|
+
const installed = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
|
|
10
|
+
requireCondition(typeof installed.name === "string" &&
|
|
11
|
+
installed.name.length > 0 &&
|
|
12
|
+
installed.name.length <= 256 &&
|
|
13
|
+
typeof installed.version === "string" &&
|
|
14
|
+
/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(installed.version), "invalid_control_package", "Fixed platform scripts require the actual installed Agent name and version.");
|
|
15
|
+
export const CONTROL_OWNER = installed.name;
|
|
16
|
+
export const CONTROL_VERSION = installed.version;
|
|
17
|
+
export { DEFAULT_CONTROL_CAPACITY } from "../contracts/types.js";
|
|
18
|
+
const id = { type: "string", minLength: 1, maxLength: 256 };
|
|
19
|
+
const cursor = { type: "string", minLength: 1, maxLength: 8192 };
|
|
20
|
+
const wait = { type: "integer", minimum: 0, maximum: 30000 };
|
|
21
|
+
const limit = { type: "integer", minimum: 1, maximum: 100 };
|
|
22
|
+
function schema(properties, required = [], extra = {}) {
|
|
23
|
+
return {
|
|
24
|
+
type: "object",
|
|
25
|
+
properties,
|
|
26
|
+
required,
|
|
27
|
+
additionalProperties: false,
|
|
28
|
+
...extra,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
function immutable(value) {
|
|
32
|
+
if (value && typeof value === "object") {
|
|
33
|
+
for (const child of Object.values(value))
|
|
34
|
+
immutable(child);
|
|
35
|
+
Object.freeze(value);
|
|
36
|
+
}
|
|
37
|
+
return value;
|
|
38
|
+
}
|
|
39
|
+
function define(namespace, method, description, when, input, body) {
|
|
40
|
+
const filename = `${method}.js`;
|
|
41
|
+
const metadata = {
|
|
42
|
+
scriptName: filename,
|
|
43
|
+
scriptDesc: description,
|
|
44
|
+
scriptWhenUse: when,
|
|
45
|
+
scriptInputSchema: input,
|
|
46
|
+
scriptOpenDefault: true,
|
|
47
|
+
};
|
|
48
|
+
const code = `/**\n${JSON.stringify(metadata, null, 2)}\n*/\n${body ?? `return await ${namespace}.${method}(context.input);`}\n`;
|
|
49
|
+
return immutable({
|
|
50
|
+
name: `${namespace}/${filename}`,
|
|
51
|
+
namespace,
|
|
52
|
+
filename,
|
|
53
|
+
code,
|
|
54
|
+
revision: createHash("sha256").update(code).digest("hex"),
|
|
55
|
+
metadata,
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
// This closed set is program code, never an allowlist accepted from an SDK,
|
|
59
|
+
// script header, MCP input, local contribution or extension configuration.
|
|
60
|
+
export const FIXED_CONTROL_SCRIPTS = immutable([
|
|
61
|
+
define("sh", "get", "读取托管进程的当前状态和增量输出", "普通运行已满时查询原进程;不启动新命令", schema({
|
|
62
|
+
processId: id,
|
|
63
|
+
cursor,
|
|
64
|
+
maxBytes: { type: "integer", minimum: 1, maximum: 1048576 },
|
|
65
|
+
waitMs: wait,
|
|
66
|
+
encoding: {
|
|
67
|
+
anyOf: [
|
|
68
|
+
{
|
|
69
|
+
type: "string",
|
|
70
|
+
enum: [
|
|
71
|
+
"ascii",
|
|
72
|
+
"utf8",
|
|
73
|
+
"utf-8",
|
|
74
|
+
"utf16le",
|
|
75
|
+
"utf-16le",
|
|
76
|
+
"ucs2",
|
|
77
|
+
"ucs-2",
|
|
78
|
+
"base64",
|
|
79
|
+
"base64url",
|
|
80
|
+
"latin1",
|
|
81
|
+
"binary",
|
|
82
|
+
"hex",
|
|
83
|
+
],
|
|
84
|
+
},
|
|
85
|
+
{ type: "null" },
|
|
86
|
+
],
|
|
87
|
+
},
|
|
88
|
+
}, ["processId"])),
|
|
89
|
+
define("sh", "list", "按当前授权查询托管进程历史和活动记录", "寻找可继续读取或控制的原进程身份", schema({
|
|
90
|
+
status: { type: "string", minLength: 1, maxLength: 128 },
|
|
91
|
+
state: { type: "string", minLength: 1, maxLength: 128 },
|
|
92
|
+
runId: id,
|
|
93
|
+
contextId: id,
|
|
94
|
+
limit,
|
|
95
|
+
cursor,
|
|
96
|
+
})),
|
|
97
|
+
define("sh", "write", "向托管进程写入文本或结束普通 stdin", "向现有交互进程提交输入;不创建进程", schema({
|
|
98
|
+
processId: id,
|
|
99
|
+
data: {
|
|
100
|
+
type: "string",
|
|
101
|
+
maxLength: 1048576,
|
|
102
|
+
description: "UTF-8 实际字节上限仍由 sh SDK 检查",
|
|
103
|
+
},
|
|
104
|
+
eof: { type: "boolean" },
|
|
105
|
+
}, ["processId"], {
|
|
106
|
+
anyOf: [
|
|
107
|
+
{ required: ["data"], properties: { data: {} } },
|
|
108
|
+
{ required: ["eof"], properties: { eof: { const: true } } },
|
|
109
|
+
],
|
|
110
|
+
})),
|
|
111
|
+
define("sh", "resize", "调整托管 PTY 的列数和行数", "调整现有终端尺寸,非 PTY 会明确报错", schema({
|
|
112
|
+
processId: id,
|
|
113
|
+
cols: { type: "integer", minimum: 1, maximum: 1000 },
|
|
114
|
+
rows: { type: "integer", minimum: 1, maximum: 1000 },
|
|
115
|
+
}, ["processId", "cols", "rows"])),
|
|
116
|
+
define("sh", "signal", "向托管进程投递平台支持的信号", "请求现有进程中断;投递不等于已退出", schema({
|
|
117
|
+
processId: id,
|
|
118
|
+
signal: { type: "string", pattern: "^SIG[A-Z0-9]+$", maxLength: 32 },
|
|
119
|
+
}, ["processId", "signal"])),
|
|
120
|
+
define("sh", "stop", "停止托管进程及受管后代并报告实际收尾", "普通运行已满时停止原进程或后台服务", schema({
|
|
121
|
+
processId: id,
|
|
122
|
+
graceMs: wait,
|
|
123
|
+
forceMs: wait,
|
|
124
|
+
}, ["processId"])),
|
|
125
|
+
define("transfer", "get", "查询传输状态并可短暂等待", "继续跟踪已登记的上传或下载,不新建通道", schema({
|
|
126
|
+
transferId: id,
|
|
127
|
+
waitMs: wait,
|
|
128
|
+
}, ["transferId"]), "const { transferId, ...options } = context.input;\nreturn await transfer.get(transferId, options);"),
|
|
129
|
+
define("transfer", "list", "按当前授权查询传输记录", "寻找原传输身份,不创建或重复执行传输", schema({
|
|
130
|
+
direction: { type: "string", enum: ["upload", "download"] },
|
|
131
|
+
status: {
|
|
132
|
+
type: "string",
|
|
133
|
+
enum: [
|
|
134
|
+
"preparing",
|
|
135
|
+
"pending",
|
|
136
|
+
"transferring",
|
|
137
|
+
"cancelling",
|
|
138
|
+
"succeeded",
|
|
139
|
+
"failed",
|
|
140
|
+
"cancelled",
|
|
141
|
+
"expired",
|
|
142
|
+
"interrupted",
|
|
143
|
+
],
|
|
144
|
+
},
|
|
145
|
+
runId: id,
|
|
146
|
+
limit,
|
|
147
|
+
cursor,
|
|
148
|
+
})),
|
|
149
|
+
define("transfer", "cancel", "请求取消已登记传输", "停止原上传或下载,结果以实际传输状态为准", schema({ transferId: id }, ["transferId"]), "return await transfer.cancel(context.input.transferId);"),
|
|
150
|
+
]);
|
|
151
|
+
const definitions = new Map(FIXED_CONTROL_SCRIPTS.map((script) => [script.name, script]));
|
|
152
|
+
/** Explicit installation/initialization; this source is isolated from local bare-name scripts. */
|
|
153
|
+
export function materializeControlScripts(work) {
|
|
154
|
+
requireCondition(path.isAbsolute(work) && realpathSync.native(work) === work, "storage_path_escape", "Platform control sources require the established profile work directory.");
|
|
155
|
+
const root = privateDirectory(work, ".platform-controls", CONTROL_VERSION);
|
|
156
|
+
const sources = [];
|
|
157
|
+
for (const namespace of ["sh", "transfer"]) {
|
|
158
|
+
const directory = privateDirectory(root, namespace);
|
|
159
|
+
for (const script of FIXED_CONTROL_SCRIPTS.filter((value) => value.namespace === namespace)) {
|
|
160
|
+
const filename = path.join(directory, script.filename);
|
|
161
|
+
const existing = lstatSync(filename, { throwIfNoEntry: false });
|
|
162
|
+
requireCondition(!existing || existing.isFile(), "storage_path_escape", "A platform control file cannot redirect to another location.");
|
|
163
|
+
atomicText(filename, script.code);
|
|
164
|
+
}
|
|
165
|
+
sources.push(Object.freeze({
|
|
166
|
+
type: "platform",
|
|
167
|
+
owner: CONTROL_OWNER,
|
|
168
|
+
namespace,
|
|
169
|
+
version: CONTROL_VERSION,
|
|
170
|
+
directory,
|
|
171
|
+
}));
|
|
172
|
+
}
|
|
173
|
+
return Object.freeze(sources);
|
|
174
|
+
}
|
|
175
|
+
/** Fixed lifecycle sources may use the Core's reserved control headroom. */
|
|
176
|
+
export async function materializeManagedControlScripts(work, reserve) {
|
|
177
|
+
const bytes = FIXED_CONTROL_SCRIPTS.reduce((total, script) => total + Buffer.byteLength(script.code) + 1024, 0);
|
|
178
|
+
const ticket = await reserve(bytes, { control: true });
|
|
179
|
+
try {
|
|
180
|
+
return materializeControlScripts(work);
|
|
181
|
+
}
|
|
182
|
+
finally {
|
|
183
|
+
ticket.release();
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
const changedSource = new Set([
|
|
187
|
+
"script_not_found",
|
|
188
|
+
"script_name_conflict",
|
|
189
|
+
"script_path_escape",
|
|
190
|
+
"script_too_large",
|
|
191
|
+
"invalid_script_header",
|
|
192
|
+
"script_header_mismatch",
|
|
193
|
+
"invalid_script_name",
|
|
194
|
+
"invalid_input_schema",
|
|
195
|
+
]);
|
|
196
|
+
const unreadable = new Set(["ENOENT", "ENOTDIR", "EACCES", "EPERM", "ELOOP"]);
|
|
197
|
+
/** A source mismatch is ordinary work, not a request to elevate arbitrary code. */
|
|
198
|
+
export function qualifyControlScript(catalog, name) {
|
|
199
|
+
const fixed = definitions.get(name);
|
|
200
|
+
if (!fixed)
|
|
201
|
+
return undefined;
|
|
202
|
+
let current;
|
|
203
|
+
try {
|
|
204
|
+
current = catalog.resolve(name);
|
|
205
|
+
}
|
|
206
|
+
catch (cause) {
|
|
207
|
+
if (types.isProxy(cause))
|
|
208
|
+
throw cause;
|
|
209
|
+
if (cause instanceof AgentError && changedSource.has(cause.code))
|
|
210
|
+
return undefined;
|
|
211
|
+
const code = cause && typeof cause === "object"
|
|
212
|
+
? Object.getOwnPropertyDescriptor(cause, "code")
|
|
213
|
+
: undefined;
|
|
214
|
+
if (code && "value" in code && unreadable.has(code.value))
|
|
215
|
+
return undefined;
|
|
216
|
+
// Unknown policy/configuration failures must not be treated as permission.
|
|
217
|
+
throw cause;
|
|
218
|
+
}
|
|
219
|
+
if (current.name !== fixed.name ||
|
|
220
|
+
current.code !== fixed.code ||
|
|
221
|
+
current.origin.type !== "platform" ||
|
|
222
|
+
current.origin.owner !== CONTROL_OWNER ||
|
|
223
|
+
current.origin.namespace !== fixed.namespace ||
|
|
224
|
+
current.origin.version !== CONTROL_VERSION ||
|
|
225
|
+
current.origin.revision !== fixed.revision ||
|
|
226
|
+
createHash("sha256").update(current.code).digest("hex") !== fixed.revision)
|
|
227
|
+
return undefined;
|
|
228
|
+
return immutable({
|
|
229
|
+
name: fixed.name,
|
|
230
|
+
code: fixed.code,
|
|
231
|
+
metadata: { ...fixed.metadata },
|
|
232
|
+
path: current.path,
|
|
233
|
+
origin: {
|
|
234
|
+
type: "platform",
|
|
235
|
+
owner: CONTROL_OWNER,
|
|
236
|
+
namespace: fixed.namespace,
|
|
237
|
+
version: CONTROL_VERSION,
|
|
238
|
+
revision: fixed.revision,
|
|
239
|
+
},
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
//# sourceMappingURL=control-scripts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"control-scripts.js","sourceRoot":"","sources":["../../src/runtime/control-scripts.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
import { EventEmitter } from "node:events";
|
|
2
|
+
import type { JsonObject, JsonValue, ContributionOrigin, RunRecord, RunStatus, WaitRecord, WorkRecord } from "../contracts/types.js";
|
|
3
|
+
import { SqliteStore } from "../storage/sqlite.js";
|
|
4
|
+
import { ModuleLoader } from "./modules.js";
|
|
5
|
+
import { ScriptCatalog, type ScriptSnapshot } from "./scripts.js";
|
|
6
|
+
import type { ResourceManager } from "../extensions/resources.js";
|
|
7
|
+
import { type OperationHooks } from "./operations.js";
|
|
8
|
+
import { type Caller } from "../contracts/caller.js";
|
|
9
|
+
export { callerKey, type Caller } from "../contracts/caller.js";
|
|
10
|
+
export interface StartInput {
|
|
11
|
+
contextId: string;
|
|
12
|
+
script?: string;
|
|
13
|
+
scriptName?: string;
|
|
14
|
+
replayRunId?: string;
|
|
15
|
+
input?: JsonValue;
|
|
16
|
+
attachments?: JsonObject[];
|
|
17
|
+
requestId?: string;
|
|
18
|
+
pwd?: string;
|
|
19
|
+
timeoutMs?: number;
|
|
20
|
+
waitMs?: number;
|
|
21
|
+
}
|
|
22
|
+
export interface GetInput {
|
|
23
|
+
agentId: string;
|
|
24
|
+
runId?: string;
|
|
25
|
+
requestId?: string;
|
|
26
|
+
waitMs?: number;
|
|
27
|
+
}
|
|
28
|
+
export interface ListInput {
|
|
29
|
+
agentId: string;
|
|
30
|
+
status?: RunStatus;
|
|
31
|
+
scriptName?: string;
|
|
32
|
+
source?: "inline" | "named" | "history";
|
|
33
|
+
projectId?: string;
|
|
34
|
+
contextId?: string;
|
|
35
|
+
from?: string;
|
|
36
|
+
to?: string;
|
|
37
|
+
limit?: number;
|
|
38
|
+
cursor?: string;
|
|
39
|
+
}
|
|
40
|
+
export interface RetainedSnapshot {
|
|
41
|
+
readonly ref: string | null;
|
|
42
|
+
readonly status: "available" | "unavailable" | "not_recorded" | "too_large";
|
|
43
|
+
readonly bytes: number | null;
|
|
44
|
+
readonly value?: JsonValue;
|
|
45
|
+
readonly truncated?: true;
|
|
46
|
+
readonly nextOffset?: number;
|
|
47
|
+
readonly startOffset?: number;
|
|
48
|
+
readonly endOffset?: number;
|
|
49
|
+
readonly dataOffset?: number;
|
|
50
|
+
}
|
|
51
|
+
export interface CancelView extends RunView {
|
|
52
|
+
/** This invocation actually recorded the first stop request; it does not confirm shutdown. */
|
|
53
|
+
readonly accepted: boolean;
|
|
54
|
+
}
|
|
55
|
+
/** Internal retained detail; the Cloud adapter must project results and move media before model delivery. */
|
|
56
|
+
export interface RunDetails extends RunView {
|
|
57
|
+
readonly snapshots: {
|
|
58
|
+
readonly code: RetainedSnapshot;
|
|
59
|
+
readonly input: RetainedSnapshot;
|
|
60
|
+
readonly logs: RetainedSnapshot;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
export interface RunSummary extends JsonObject {
|
|
64
|
+
runId: string;
|
|
65
|
+
scriptName: string | null;
|
|
66
|
+
scriptDesc: string | null;
|
|
67
|
+
source: "inline" | "named" | "history";
|
|
68
|
+
origin: JsonObject | null;
|
|
69
|
+
projectId: string | null;
|
|
70
|
+
contextId: string;
|
|
71
|
+
status: RunStatus;
|
|
72
|
+
acceptedAt: string;
|
|
73
|
+
startedAt: string | null;
|
|
74
|
+
endedAt: string | null;
|
|
75
|
+
replayOfRunId: string | null;
|
|
76
|
+
availability: JsonObject;
|
|
77
|
+
}
|
|
78
|
+
export interface InputRequest {
|
|
79
|
+
message: string;
|
|
80
|
+
inputSchema: JsonValue;
|
|
81
|
+
timeoutMs?: number;
|
|
82
|
+
}
|
|
83
|
+
export interface RunServices {
|
|
84
|
+
readonly runId: string;
|
|
85
|
+
readonly signal: AbortSignal;
|
|
86
|
+
readonly context: JsonObject;
|
|
87
|
+
/** Fixed Core verdict; not script context or an extension-provided permission. */
|
|
88
|
+
readonly controlStorage?: boolean;
|
|
89
|
+
readonly deadlineAt: number;
|
|
90
|
+
assertActive(): void;
|
|
91
|
+
/** Existing operations keep current authority while root admission is closed. */
|
|
92
|
+
assertCurrent(): void;
|
|
93
|
+
/** Trusted wrappers check script admission, normalize/validate and authorize before this core service. */
|
|
94
|
+
operation<T>(origin: ContributionOrigin, method: string, action: (operationId: string) => T | Promise<T>, hooks?: OperationHooks<T>): T | Promise<T>;
|
|
95
|
+
requestInput(request: InputRequest): Promise<JsonObject>;
|
|
96
|
+
}
|
|
97
|
+
export interface EngineOptions {
|
|
98
|
+
authorize(caller: Caller, target: {
|
|
99
|
+
action: string;
|
|
100
|
+
run?: RunRecord;
|
|
101
|
+
work?: WorkRecord;
|
|
102
|
+
path?: string;
|
|
103
|
+
origin?: ScriptSnapshot["origin"];
|
|
104
|
+
}): void;
|
|
105
|
+
loadWork(work: WorkRecord): JsonObject | Promise<JsonObject>;
|
|
106
|
+
encodeResult(value: unknown, services: RunServices): Promise<JsonObject>;
|
|
107
|
+
bindings(services: RunServices): Readonly<Record<string, unknown>>;
|
|
108
|
+
prepareAttachments?(references: readonly JsonObject[], directory: string, services: RunServices): Promise<JsonObject[]>;
|
|
109
|
+
capacity?: number;
|
|
110
|
+
controlCapacity?: number;
|
|
111
|
+
resources?: ResourceManager;
|
|
112
|
+
leaseScript?(origin: ContributionOrigin): () => void;
|
|
113
|
+
reserve?(bytes: number, options?: {
|
|
114
|
+
readonly control?: boolean;
|
|
115
|
+
}): Promise<{
|
|
116
|
+
release(): void;
|
|
117
|
+
}>;
|
|
118
|
+
}
|
|
119
|
+
export interface RunView {
|
|
120
|
+
run: RunRecord;
|
|
121
|
+
wait: WaitRecord | null;
|
|
122
|
+
result: JsonObject | null;
|
|
123
|
+
unavailable?: JsonObject;
|
|
124
|
+
operations: {
|
|
125
|
+
items: JsonObject[];
|
|
126
|
+
complete: boolean;
|
|
127
|
+
};
|
|
128
|
+
resources: {
|
|
129
|
+
items: JsonObject[];
|
|
130
|
+
complete: boolean;
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
export declare class RunEngine extends EventEmitter {
|
|
134
|
+
#private;
|
|
135
|
+
readonly store: SqliteStore;
|
|
136
|
+
readonly loader: ModuleLoader;
|
|
137
|
+
readonly scripts: ScriptCatalog;
|
|
138
|
+
constructor(store: SqliteStore, loader: ModuleLoader, scripts: ScriptCatalog, options: EngineOptions);
|
|
139
|
+
activeSnapshotRefs(): ReadonlySet<string>;
|
|
140
|
+
get(caller: Caller, input: GetInput, signal?: AbortSignal): Promise<RunDetails>;
|
|
141
|
+
list(caller: Caller, input: ListInput): {
|
|
142
|
+
runs: RunSummary[];
|
|
143
|
+
nextCursor: string | null;
|
|
144
|
+
};
|
|
145
|
+
start(caller: Caller, input: StartInput, observationSignal?: AbortSignal): Promise<RunView>;
|
|
146
|
+
input(caller: Caller, input: {
|
|
147
|
+
agentId: string;
|
|
148
|
+
runId: string;
|
|
149
|
+
waitId: string;
|
|
150
|
+
input: JsonValue;
|
|
151
|
+
attachments?: JsonObject[];
|
|
152
|
+
waitMs?: number;
|
|
153
|
+
}, signal?: AbortSignal): Promise<{
|
|
154
|
+
submission: WaitRecord;
|
|
155
|
+
run: RunRecord;
|
|
156
|
+
wait: WaitRecord | null;
|
|
157
|
+
result: JsonObject | null;
|
|
158
|
+
unavailable?: JsonObject;
|
|
159
|
+
operations: {
|
|
160
|
+
items: JsonObject[];
|
|
161
|
+
complete: boolean;
|
|
162
|
+
};
|
|
163
|
+
resources: {
|
|
164
|
+
items: JsonObject[];
|
|
165
|
+
complete: boolean;
|
|
166
|
+
};
|
|
167
|
+
}>;
|
|
168
|
+
/** Trusted Core authority revocation, never a script/transport parameter entry. */
|
|
169
|
+
stopAcceptedRun(runId: string, reason: {
|
|
170
|
+
readonly code: string;
|
|
171
|
+
}): {
|
|
172
|
+
accepted: boolean;
|
|
173
|
+
run: RunRecord;
|
|
174
|
+
};
|
|
175
|
+
cancel(caller: Caller, runId: string): CancelView;
|
|
176
|
+
observe(caller: Caller, runId: string, waitMs?: number, signal?: AbortSignal, afterInput?: boolean): Promise<RunView>;
|
|
177
|
+
}
|