@nexum-hub/agent 0.0.0-stage → 0.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +133 -2
- package/contracts/v2/common.schema.json +262 -0
- package/contracts/v2/fixtures/inputs.json +244 -0
- package/contracts/v2/fixtures/wire.json +6493 -0
- package/contracts/v2/model/agent.close.input.schema.json +14 -0
- package/contracts/v2/model/agent.close.output.schema.json +101 -0
- package/contracts/v2/model/agent.list.input.schema.json +57 -0
- package/contracts/v2/model/agent.list.output.schema.json +220 -0
- package/contracts/v2/model/agent.open.input.schema.json +35 -0
- package/contracts/v2/model/agent.open.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.cancel.input.schema.json +18 -0
- package/contracts/v2/model/agent.run.cancel.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.get.input.schema.json +41 -0
- package/contracts/v2/model/agent.run.get.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.input.input.schema.json +30 -0
- package/contracts/v2/model/agent.run.input.output.schema.json +100 -0
- package/contracts/v2/model/agent.run.list.input.schema.json +47 -0
- package/contracts/v2/model/agent.run.list.output.schema.json +41 -0
- package/contracts/v2/model/agent.run.start.input.schema.json +73 -0
- package/contracts/v2/model/agent.run.start.output.schema.json +100 -0
- package/contracts/v2/wire/bodies.schema.json +383 -0
- package/contracts/v2/wire/envelope.schema.json +2280 -0
- package/contracts/v2/wire/events.schema.json +242 -0
- package/contracts/v2/wire/maintenance.schema.json +308 -0
- package/contracts/v2/wire/operations.schema.json +1791 -0
- package/contracts/v2/wire/stream.schema.json +74 -0
- package/contracts/v2/wire/types.schema.json +2616 -0
- package/dist/adapters/mcp-http.d.ts +22 -0
- package/dist/adapters/mcp-http.js +472 -0
- package/dist/adapters/mcp-http.js.map +1 -0
- package/dist/adapters/mcp-oauth.d.ts +29 -0
- package/dist/adapters/mcp-oauth.js +653 -0
- package/dist/adapters/mcp-oauth.js.map +1 -0
- package/dist/adapters/mcp-wire.d.ts +21 -0
- package/dist/adapters/mcp-wire.js +307 -0
- package/dist/adapters/mcp-wire.js.map +1 -0
- package/dist/adapters/mcp.d.ts +56 -0
- package/dist/adapters/mcp.js +1989 -0
- package/dist/adapters/mcp.js.map +1 -0
- package/dist/adapters/openapi-http.d.ts +29 -0
- package/dist/adapters/openapi-http.js +504 -0
- package/dist/adapters/openapi-http.js.map +1 -0
- package/dist/adapters/openapi-request.d.ts +26 -0
- package/dist/adapters/openapi-request.js +597 -0
- package/dist/adapters/openapi-request.js.map +1 -0
- package/dist/adapters/openapi-schema.d.ts +22 -0
- package/dist/adapters/openapi-schema.js +471 -0
- package/dist/adapters/openapi-schema.js.map +1 -0
- package/dist/adapters/openapi-typegen.d.ts +11 -0
- package/dist/adapters/openapi-typegen.js +185 -0
- package/dist/adapters/openapi-typegen.js.map +1 -0
- package/dist/adapters/openapi-types.d.ts +99 -0
- package/dist/adapters/openapi-types.js +2 -0
- package/dist/adapters/openapi-types.js.map +1 -0
- package/dist/adapters/openapi.d.ts +7 -0
- package/dist/adapters/openapi.js +768 -0
- package/dist/adapters/openapi.js.map +1 -0
- package/dist/application/activation.d.ts +28 -0
- package/dist/application/activation.js +289 -0
- package/dist/application/activation.js.map +1 -0
- package/dist/application/attachments.d.ts +24 -0
- package/dist/application/attachments.js +87 -0
- package/dist/application/attachments.js.map +1 -0
- package/dist/application/authority.d.ts +32 -0
- package/dist/application/authority.js +213 -0
- package/dist/application/authority.js.map +1 -0
- package/dist/application/catalog.d.ts +11 -0
- package/dist/application/catalog.js +177 -0
- package/dist/application/catalog.js.map +1 -0
- package/dist/application/config.d.ts +24 -0
- package/dist/application/config.js +140 -0
- package/dist/application/config.js.map +1 -0
- package/dist/application/connection.d.ts +35 -0
- package/dist/application/connection.js +465 -0
- package/dist/application/connection.js.map +1 -0
- package/dist/application/data-plane.d.ts +35 -0
- package/dist/application/data-plane.js +437 -0
- package/dist/application/data-plane.js.map +1 -0
- package/dist/application/diagnostics.d.ts +4 -0
- package/dist/application/diagnostics.js +65 -0
- package/dist/application/diagnostics.js.map +1 -0
- package/dist/application/dispatcher.d.ts +4 -0
- package/dist/application/dispatcher.js +16 -0
- package/dist/application/dispatcher.js.map +1 -0
- package/dist/application/main.d.ts +12 -0
- package/dist/application/main.js +167 -0
- package/dist/application/main.js.map +1 -0
- package/dist/application/maintenance.d.ts +27 -0
- package/dist/application/maintenance.js +244 -0
- package/dist/application/maintenance.js.map +1 -0
- package/dist/application/packages.d.ts +25 -0
- package/dist/application/packages.js +208 -0
- package/dist/application/packages.js.map +1 -0
- package/dist/application/processes.d.ts +49 -0
- package/dist/application/processes.js +180 -0
- package/dist/application/processes.js.map +1 -0
- package/dist/application/run-view.d.ts +17 -0
- package/dist/application/run-view.js +286 -0
- package/dist/application/run-view.js.map +1 -0
- package/dist/application/runtime.d.ts +78 -0
- package/dist/application/runtime.js +1747 -0
- package/dist/application/runtime.js.map +1 -0
- package/dist/application/tasks.d.ts +38 -0
- package/dist/application/tasks.js +23 -0
- package/dist/application/tasks.js.map +1 -0
- package/dist/application/user-state.d.ts +20 -0
- package/dist/application/user-state.js +52 -0
- package/dist/application/user-state.js.map +1 -0
- package/dist/application/work-git.d.ts +14 -0
- package/dist/application/work-git.js +67 -0
- package/dist/application/work-git.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +40 -0
- package/dist/cli.js.map +1 -0
- package/dist/contracts/caller.d.ts +51 -0
- package/dist/contracts/caller.js +95 -0
- package/dist/contracts/caller.js.map +1 -0
- package/dist/contracts/error-data.d.ts +6 -0
- package/dist/contracts/error-data.js +51 -0
- package/dist/contracts/error-data.js.map +1 -0
- package/dist/contracts/errors.d.ts +10 -0
- package/dist/contracts/errors.js +28 -0
- package/dist/contracts/errors.js.map +1 -0
- package/dist/contracts/json.d.ts +9 -0
- package/dist/contracts/json.js +104 -0
- package/dist/contracts/json.js.map +1 -0
- package/dist/contracts/types.d.ts +122 -0
- package/dist/contracts/types.js +19 -0
- package/dist/contracts/types.js.map +1 -0
- package/dist/contracts/validation.d.ts +4 -0
- package/dist/contracts/validation.js +157 -0
- package/dist/contracts/validation.js.map +1 -0
- package/dist/contracts/wire-validation.d.ts +9 -0
- package/dist/contracts/wire-validation.js +399 -0
- package/dist/contracts/wire-validation.js.map +1 -0
- package/dist/contracts/wire.d.ts +1083 -0
- package/dist/contracts/wire.js +62 -0
- package/dist/contracts/wire.js.map +1 -0
- package/dist/extension-api.d.ts +12 -0
- package/dist/extension-api.js +2 -0
- package/dist/extension-api.js.map +1 -0
- package/dist/extensions/api.d.ts +72 -0
- package/dist/extensions/api.js +2 -0
- package/dist/extensions/api.js.map +1 -0
- package/dist/extensions/host-requests.d.ts +23 -0
- package/dist/extensions/host-requests.js +60 -0
- package/dist/extensions/host-requests.js.map +1 -0
- package/dist/extensions/materials.d.ts +37 -0
- package/dist/extensions/materials.js +691 -0
- package/dist/extensions/materials.js.map +1 -0
- package/dist/extensions/package-loader.d.ts +28 -0
- package/dist/extensions/package-loader.js +177 -0
- package/dist/extensions/package-loader.js.map +1 -0
- package/dist/extensions/packages.d.ts +73 -0
- package/dist/extensions/packages.js +441 -0
- package/dist/extensions/packages.js.map +1 -0
- package/dist/extensions/registry.d.ts +92 -0
- package/dist/extensions/registry.js +1540 -0
- package/dist/extensions/registry.js.map +1 -0
- package/dist/extensions/resources.d.ts +105 -0
- package/dist/extensions/resources.js +595 -0
- package/dist/extensions/resources.js.map +1 -0
- package/dist/extensions/state.d.ts +25 -0
- package/dist/extensions/state.js +10 -0
- package/dist/extensions/state.js.map +1 -0
- package/dist/extensions/transfer.d.ts +81 -0
- package/dist/extensions/transfer.js +16 -0
- package/dist/extensions/transfer.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -0
- package/dist/maintenance/configuration.d.ts +79 -0
- package/dist/maintenance/configuration.js +1503 -0
- package/dist/maintenance/configuration.js.map +1 -0
- package/dist/maintenance/credentials.d.ts +23 -0
- package/dist/maintenance/credentials.js +177 -0
- package/dist/maintenance/credentials.js.map +1 -0
- package/dist/maintenance/files.d.ts +2 -0
- package/dist/maintenance/files.js +40 -0
- package/dist/maintenance/files.js.map +1 -0
- package/dist/maintenance/npm.d.ts +71 -0
- package/dist/maintenance/npm.js +1013 -0
- package/dist/maintenance/npm.js.map +1 -0
- package/dist/maintenance/oauth.d.ts +45 -0
- package/dist/maintenance/oauth.js +686 -0
- package/dist/maintenance/oauth.js.map +1 -0
- package/dist/maintenance/requests.d.ts +347 -0
- package/dist/maintenance/requests.js +959 -0
- package/dist/maintenance/requests.js.map +1 -0
- package/dist/maintenance/work-git.d.ts +29 -0
- package/dist/maintenance/work-git.js +776 -0
- package/dist/maintenance/work-git.js.map +1 -0
- package/dist/process/backend.d.ts +54 -0
- package/dist/process/backend.js +39 -0
- package/dist/process/backend.js.map +1 -0
- package/dist/process/environment-windows.d.ts +15 -0
- package/dist/process/environment-windows.js +151 -0
- package/dist/process/environment-windows.js.map +1 -0
- package/dist/process/environment.d.ts +28 -0
- package/dist/process/environment.js +410 -0
- package/dist/process/environment.js.map +1 -0
- package/dist/process/launch.d.ts +31 -0
- package/dist/process/launch.js +281 -0
- package/dist/process/launch.js.map +1 -0
- package/dist/process/managed.d.ts +36 -0
- package/dist/process/managed.js +459 -0
- package/dist/process/managed.js.map +1 -0
- package/dist/process/output-log.d.ts +50 -0
- package/dist/process/output-log.js +552 -0
- package/dist/process/output-log.js.map +1 -0
- package/dist/process/pipes.d.ts +16 -0
- package/dist/process/pipes.js +588 -0
- package/dist/process/pipes.js.map +1 -0
- package/dist/process/pty.d.ts +22 -0
- package/dist/process/pty.js +512 -0
- package/dist/process/pty.js.map +1 -0
- package/dist/process/windows-conout-worker.d.ts +1 -0
- package/dist/process/windows-conout-worker.js +90 -0
- package/dist/process/windows-conout-worker.js.map +1 -0
- package/dist/process/windows-conout.d.ts +46 -0
- package/dist/process/windows-conout.js +140 -0
- package/dist/process/windows-conout.js.map +1 -0
- package/dist/process/windows-helper.d.ts +43 -0
- package/dist/process/windows-helper.js +255 -0
- package/dist/process/windows-helper.js.map +1 -0
- package/dist/process/windows-job.d.ts +39 -0
- package/dist/process/windows-job.js +224 -0
- package/dist/process/windows-job.js.map +1 -0
- package/dist/process/windows-pipes.d.ts +16 -0
- package/dist/process/windows-pipes.js +475 -0
- package/dist/process/windows-pipes.js.map +1 -0
- package/dist/results/artifacts.d.ts +118 -0
- package/dist/results/artifacts.js +873 -0
- package/dist/results/artifacts.js.map +1 -0
- package/dist/results/encoder.d.ts +57 -0
- package/dist/results/encoder.js +1179 -0
- package/dist/results/encoder.js.map +1 -0
- package/dist/results/mcp.d.ts +95 -0
- package/dist/results/mcp.js +656 -0
- package/dist/results/mcp.js.map +1 -0
- package/dist/results/media.d.ts +19 -0
- package/dist/results/media.js +301 -0
- package/dist/results/media.js.map +1 -0
- package/dist/results/normalize.d.ts +29 -0
- package/dist/results/normalize.js +464 -0
- package/dist/results/normalize.js.map +1 -0
- package/dist/runtime/control-scripts.d.ts +23 -0
- package/dist/runtime/control-scripts.js +242 -0
- package/dist/runtime/control-scripts.js.map +1 -0
- package/dist/runtime/engine.d.ts +177 -0
- package/dist/runtime/engine.js +1159 -0
- package/dist/runtime/engine.js.map +1 -0
- package/dist/runtime/globals.d.ts +1 -0
- package/dist/runtime/globals.js +31 -0
- package/dist/runtime/globals.js.map +1 -0
- package/dist/runtime/material-retention.d.ts +34 -0
- package/dist/runtime/material-retention.js +671 -0
- package/dist/runtime/material-retention.js.map +1 -0
- package/dist/runtime/modules.d.ts +50 -0
- package/dist/runtime/modules.js +320 -0
- package/dist/runtime/modules.js.map +1 -0
- package/dist/runtime/names.d.ts +2 -0
- package/dist/runtime/names.js +22 -0
- package/dist/runtime/names.js.map +1 -0
- package/dist/runtime/operations.d.ts +20 -0
- package/dist/runtime/operations.js +137 -0
- package/dist/runtime/operations.js.map +1 -0
- package/dist/runtime/paths.d.ts +3 -0
- package/dist/runtime/paths.js +38 -0
- package/dist/runtime/paths.js.map +1 -0
- package/dist/runtime/promises.d.ts +9 -0
- package/dist/runtime/promises.js +78 -0
- package/dist/runtime/promises.js.map +1 -0
- package/dist/runtime/retention.d.ts +88 -0
- package/dist/runtime/retention.js +735 -0
- package/dist/runtime/retention.js.map +1 -0
- package/dist/runtime/run-log.d.ts +30 -0
- package/dist/runtime/run-log.js +207 -0
- package/dist/runtime/run-log.js.map +1 -0
- package/dist/runtime/scripts.d.ts +84 -0
- package/dist/runtime/scripts.js +387 -0
- package/dist/runtime/scripts.js.map +1 -0
- package/dist/runtime/tasks.d.ts +54 -0
- package/dist/runtime/tasks.js +290 -0
- package/dist/runtime/tasks.js.map +1 -0
- package/dist/sdk/maintenance.d.ts +3 -0
- package/dist/sdk/maintenance.js +80 -0
- package/dist/sdk/maintenance.js.map +1 -0
- package/dist/sdk/output-extension.d.ts +3 -0
- package/dist/sdk/output-extension.js +44 -0
- package/dist/sdk/output-extension.js.map +1 -0
- package/dist/sdk/output.d.ts +52 -0
- package/dist/sdk/output.js +350 -0
- package/dist/sdk/output.js.map +1 -0
- package/dist/sdk/runtime.d.ts +3 -0
- package/dist/sdk/runtime.js +26 -0
- package/dist/sdk/runtime.js.map +1 -0
- package/dist/sdk/sh.d.ts +3 -0
- package/dist/sdk/sh.js +384 -0
- package/dist/sdk/sh.js.map +1 -0
- package/dist/sdk/state.d.ts +2 -0
- package/dist/sdk/state.js +69 -0
- package/dist/sdk/state.js.map +1 -0
- package/dist/sdk/transfer.d.ts +3 -0
- package/dist/sdk/transfer.js +141 -0
- package/dist/sdk/transfer.js.map +1 -0
- package/dist/services/extensions.d.ts +19 -0
- package/dist/services/extensions.js +183 -0
- package/dist/services/extensions.js.map +1 -0
- package/dist/services/state.d.ts +37 -0
- package/dist/services/state.js +125 -0
- package/dist/services/state.js.map +1 -0
- package/dist/services/transfer.d.ts +86 -0
- package/dist/services/transfer.js +948 -0
- package/dist/services/transfer.js.map +1 -0
- package/dist/storage/schema.d.ts +8 -0
- package/dist/storage/schema.js +241 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/sqlite.d.ts +241 -0
- package/dist/storage/sqlite.js +1855 -0
- package/dist/storage/sqlite.js.map +1 -0
- package/dist/storage/transfers.d.ts +90 -0
- package/dist/storage/transfers.js +2 -0
- package/dist/storage/transfers.js.map +1 -0
- package/dist/transfer/io.d.ts +74 -0
- package/dist/transfer/io.js +425 -0
- package/dist/transfer/io.js.map +1 -0
- package/dist/transfer/offers.d.ts +72 -0
- package/dist/transfer/offers.js +380 -0
- package/dist/transfer/offers.js.map +1 -0
- package/dist/transfer/stream-slots.d.ts +12 -0
- package/dist/transfer/stream-slots.js +28 -0
- package/dist/transfer/stream-slots.js.map +1 -0
- package/dist/work/catalog.d.ts +43 -0
- package/dist/work/catalog.js +198 -0
- package/dist/work/catalog.js.map +1 -0
- package/dist/work/discovery.d.ts +70 -0
- package/dist/work/discovery.js +465 -0
- package/dist/work/discovery.js.map +1 -0
- package/dist/work/service.d.ts +83 -0
- package/dist/work/service.js +703 -0
- package/dist/work/service.js.map +1 -0
- package/package.json +66 -4
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
import { lstatSync, readFileSync, realpathSync, statSync } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { pathToFileURL } from "node:url";
|
|
4
|
+
import { createHash } from "node:crypto";
|
|
5
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
6
|
+
import { canonicalJson } from "../contracts/json.js";
|
|
7
|
+
import { atomicText, contains, privateDirectory } from "../runtime/paths.js";
|
|
8
|
+
import { boundedFile } from "./discovery.js";
|
|
9
|
+
const digest = (text) => createHash("sha256").update(text).digest("hex");
|
|
10
|
+
const missing = (error) => error.code === "ENOENT" ||
|
|
11
|
+
error.code === "ENOTDIR";
|
|
12
|
+
const label = (text) => text.replace(/[\r\n]+/g, " ").replace(/[\[\]`]/g, " ");
|
|
13
|
+
async function writeGenerated(work, filename, text, reserve, signal) {
|
|
14
|
+
signal?.throwIfAborted();
|
|
15
|
+
try {
|
|
16
|
+
const info = lstatSync(filename);
|
|
17
|
+
requireCondition(info.isFile() && !info.isSymbolicLink(), "material_path_escape", "A generated manual must be a regular file.");
|
|
18
|
+
if (info.size === Buffer.byteLength(text) &&
|
|
19
|
+
readFileSync(filename, "utf8") === text)
|
|
20
|
+
return;
|
|
21
|
+
}
|
|
22
|
+
catch (error) {
|
|
23
|
+
if (!missing(error))
|
|
24
|
+
throw error;
|
|
25
|
+
}
|
|
26
|
+
const reservation = await reserve?.(Buffer.byteLength(text));
|
|
27
|
+
try {
|
|
28
|
+
signal?.throwIfAborted();
|
|
29
|
+
// Admission may await cleanup; re-check directories before publishing bytes.
|
|
30
|
+
privateDirectory(work, ...path.relative(work, path.dirname(filename)).split(path.sep));
|
|
31
|
+
atomicText(filename, text);
|
|
32
|
+
}
|
|
33
|
+
finally {
|
|
34
|
+
reservation?.release();
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
export class DocumentCatalog {
|
|
38
|
+
options;
|
|
39
|
+
work;
|
|
40
|
+
scripts;
|
|
41
|
+
policy;
|
|
42
|
+
#activeDirectory;
|
|
43
|
+
constructor(work, scripts, policy, options = {}) {
|
|
44
|
+
this.options = options;
|
|
45
|
+
this.work = realpathSync.native(work);
|
|
46
|
+
this.scripts = scripts;
|
|
47
|
+
this.policy = policy;
|
|
48
|
+
requireCondition(this.work === scripts.work, "runtime_profile_mismatch", "The document catalog and script environment must use the same work directory.");
|
|
49
|
+
}
|
|
50
|
+
activeDirectories() {
|
|
51
|
+
return new Set(this.#activeDirectory ? [this.#activeDirectory] : []);
|
|
52
|
+
}
|
|
53
|
+
async refresh(links = [], signal, capturedScripts) {
|
|
54
|
+
signal?.throwIfAborted();
|
|
55
|
+
const scripts = capturedScripts ?? this.scripts.discover();
|
|
56
|
+
const scriptText = this.scripts.indexText(scripts);
|
|
57
|
+
const approved = new Map(this.policy.approvedPackages());
|
|
58
|
+
const builtinFamilies = [...this.policy.builtins()];
|
|
59
|
+
const docs = privateDirectory(this.work, "docs");
|
|
60
|
+
const packagesDirectory = privateDirectory(docs, "packages");
|
|
61
|
+
const packages = [];
|
|
62
|
+
let manifest = {};
|
|
63
|
+
try {
|
|
64
|
+
const filename = realpathSync.native(path.join(this.work, "package.json"));
|
|
65
|
+
requireCondition(contains(this.work, filename), "module_path_escape", "The work manifest must remain inside this profile.");
|
|
66
|
+
manifest = JSON.parse((await boundedFile(filename, 1024 * 1024, signal)).bytes.toString("utf8"));
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
if (!missing(error))
|
|
70
|
+
throw error;
|
|
71
|
+
}
|
|
72
|
+
const names = new Set();
|
|
73
|
+
for (const group of [
|
|
74
|
+
"dependencies",
|
|
75
|
+
"devDependencies",
|
|
76
|
+
"optionalDependencies",
|
|
77
|
+
])
|
|
78
|
+
for (const [name, value] of Object.entries(manifest[group] ?? {})) {
|
|
79
|
+
requireCondition(typeof value === "string" &&
|
|
80
|
+
/^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+$/.test(name), "invalid_package_manifest", "The AI environment contains an unsupported direct package declaration.");
|
|
81
|
+
names.add(name);
|
|
82
|
+
}
|
|
83
|
+
for (const name of [...names].sort()) {
|
|
84
|
+
signal?.throwIfAborted();
|
|
85
|
+
const info = {
|
|
86
|
+
name,
|
|
87
|
+
description: "",
|
|
88
|
+
version: null,
|
|
89
|
+
allowedVersion: approved.get(name) ?? null,
|
|
90
|
+
status: "missing",
|
|
91
|
+
types: null,
|
|
92
|
+
homepage: null,
|
|
93
|
+
};
|
|
94
|
+
try {
|
|
95
|
+
const modules = realpathSync.native(path.join(this.work, "node_modules"));
|
|
96
|
+
const root = realpathSync.native(path.join(modules, name));
|
|
97
|
+
const filename = realpathSync.native(path.join(root, "package.json"));
|
|
98
|
+
requireCondition(contains(this.work, modules) &&
|
|
99
|
+
contains(modules, root) &&
|
|
100
|
+
contains(root, filename), "module_path_escape", "The installed package escapes the AI environment.");
|
|
101
|
+
const data = JSON.parse((await boundedFile(filename, 1024 * 1024, signal)).bytes.toString("utf8"));
|
|
102
|
+
requireCondition(data.name === name && typeof data.version === "string", "invalid_package_manifest", "The installed package identity is invalid.");
|
|
103
|
+
info.version = data.version;
|
|
104
|
+
info.status =
|
|
105
|
+
info.allowedVersion === null
|
|
106
|
+
? "not_approved"
|
|
107
|
+
: info.version === info.allowedVersion
|
|
108
|
+
? "available"
|
|
109
|
+
: "changed";
|
|
110
|
+
if (typeof data.description === "string")
|
|
111
|
+
info.description = [...data.description].slice(0, 1024).join("");
|
|
112
|
+
const types = data.types ?? data.typings;
|
|
113
|
+
if (typeof types === "string") {
|
|
114
|
+
try {
|
|
115
|
+
const actual = realpathSync.native(path.resolve(root, types));
|
|
116
|
+
if (contains(root, actual) && statSync(actual).isFile())
|
|
117
|
+
info.types = actual;
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
if (!missing(error))
|
|
121
|
+
throw error;
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
if (typeof data.homepage === "string") {
|
|
125
|
+
try {
|
|
126
|
+
const url = new URL(data.homepage);
|
|
127
|
+
if (["https:", "http:"].includes(url.protocol) &&
|
|
128
|
+
!url.username &&
|
|
129
|
+
!url.password) {
|
|
130
|
+
url.search = "";
|
|
131
|
+
url.hash = "";
|
|
132
|
+
info.homepage = url.href;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
catch { }
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
catch (error) {
|
|
139
|
+
signal?.throwIfAborted();
|
|
140
|
+
if (!missing(error))
|
|
141
|
+
info.status = "unavailable";
|
|
142
|
+
}
|
|
143
|
+
packages.push(info);
|
|
144
|
+
}
|
|
145
|
+
const packageText = "# 已安装的 AI npm 包\n\n仅列出此 Agent work 的直接依赖;安装不等于已获准加载。详细用法由上游维护,类型声明可按需读取。\n\n" +
|
|
146
|
+
packages
|
|
147
|
+
.map((item) => `## ${label(item.name)}\n\n${label(item.description) || "未提供用途说明"}\n\n- 实际版本:${item.version ?? "未安装"}\n- 批准版本:${item.allowedVersion ?? "未批准"}\n- 状态:${item.status}\n- 类型入口:${item.types ?? "未声明可读取的入口"}\n- 上游:${item.homepage ?? "未提供"}`)
|
|
148
|
+
.join("\n\n") +
|
|
149
|
+
"\n";
|
|
150
|
+
await writeGenerated(this.work, path.join(docs, "scripts.md"), scriptText, this.options.reserve, signal);
|
|
151
|
+
signal?.throwIfAborted();
|
|
152
|
+
for (const link of links) {
|
|
153
|
+
const actual = realpathSync.native(link.path);
|
|
154
|
+
requireCondition(contains(docs, actual) &&
|
|
155
|
+
statSync(actual).isFile() &&
|
|
156
|
+
link.owner &&
|
|
157
|
+
link.version, "invalid_doc_source", "Registered manuals must use their published local reading copy and actual owner/version.");
|
|
158
|
+
}
|
|
159
|
+
function navigation(packageTarget, scriptTarget) {
|
|
160
|
+
return ("# Nexum Agent 使用手册\n\n此手册来自当前 Agent 的实际目录。通过脚本使用获准 Node/npm 读取文档,按行位置分段;读取续页时使用同一修订的入口。\n\n" +
|
|
161
|
+
`- [可复用脚本](${scriptTarget}):按公开 scriptName 查找流程、用途和完整输入 Schema。\n` +
|
|
162
|
+
`- [AI npm 包](${packageTarget}):已安装库、批准状态、上游与类型声明入口。\n` +
|
|
163
|
+
links
|
|
164
|
+
.map((link) => `- [${label(link.name)}](<${pathToFileURL(link.path).href}>):${label(link.description)}(${label(link.owner)} ${label(link.version)})`)
|
|
165
|
+
.join("\n") +
|
|
166
|
+
"\n\n## 基本工作方式\n\n打开 Agent 或项目后使用返回的 contextId 创建运行。script、scriptName、replayRunId 三者只选一个;新工作不继承旧脚本变量。\n\nNode 文件操作显式基于 context.pwd 或 context.paths 解析绝对路径;包环境始终来自该 Agent 的 work。普通本地文件操作使用 Node/npm。\n\n观察等待到期后按原 runId 查询或控制;取消和运行总期限由运行系统管理。历史重放会创建新运行,可能再次产生副作用。\n\n## 文档与资料\n\n入口指令已随打开结果交付。Skills 先提供选择元数据;选中后读取对应 SKILL.md,再按需读取其资源。文件 URL 可交给 Node URL/fileURLToPath 处理,它指向 Agent 本地文件。\n");
|
|
167
|
+
}
|
|
168
|
+
const immutableText = navigation("packages.md", "scripts.md");
|
|
169
|
+
const revision = digest(canonicalJson({ manual: immutableText, packages: packageText, scripts: scriptText }, 16 * 1024 * 1024));
|
|
170
|
+
const versioned = privateDirectory(docs, ".catalog", revision);
|
|
171
|
+
const hold = await this.options.materialRetention?.hold("catalog", versioned);
|
|
172
|
+
try {
|
|
173
|
+
await writeGenerated(this.work, path.join(versioned, "README.md"), immutableText, this.options.reserve, signal);
|
|
174
|
+
await writeGenerated(this.work, path.join(versioned, "packages.md"), packageText, this.options.reserve, signal);
|
|
175
|
+
await writeGenerated(this.work, path.join(versioned, "scripts.md"), scriptText, this.options.reserve, signal);
|
|
176
|
+
await writeGenerated(this.work, path.join(packagesDirectory, "README.md"), packageText, this.options.reserve, signal);
|
|
177
|
+
await writeGenerated(this.work, path.join(docs, "README.md"), navigation("packages/README.md", "scripts.md"), this.options.reserve, signal);
|
|
178
|
+
signal?.throwIfAborted();
|
|
179
|
+
this.options.materialRetention?.setPublished("catalog", versioned);
|
|
180
|
+
this.#activeDirectory = versioned;
|
|
181
|
+
}
|
|
182
|
+
finally {
|
|
183
|
+
hold?.release();
|
|
184
|
+
}
|
|
185
|
+
const lines = immutableText.split("\n");
|
|
186
|
+
return {
|
|
187
|
+
entry: path.join(versioned, "README.md"),
|
|
188
|
+
revision: "sha256:" + revision,
|
|
189
|
+
content: lines.slice(0, 40).join("\n"),
|
|
190
|
+
truncated: lines.length > 40,
|
|
191
|
+
nextLine: lines.length > 40 ? 41 : null,
|
|
192
|
+
packagesIndex: path.join(versioned, "packages.md"),
|
|
193
|
+
builtinFamilies,
|
|
194
|
+
packages,
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
//# sourceMappingURL=catalog.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/work/catalog.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import type { ContributionOrigin } from "../contracts/types.js";
|
|
2
|
+
export interface MaterialScope {
|
|
3
|
+
type: "personal" | "agent" | "project" | "directory";
|
|
4
|
+
root: string;
|
|
5
|
+
}
|
|
6
|
+
export interface Instruction {
|
|
7
|
+
instructionId: string;
|
|
8
|
+
kind: string;
|
|
9
|
+
path: string;
|
|
10
|
+
scope: MaterialScope;
|
|
11
|
+
origin: ContributionOrigin;
|
|
12
|
+
content?: string;
|
|
13
|
+
truncated: false;
|
|
14
|
+
disabled: boolean;
|
|
15
|
+
}
|
|
16
|
+
export interface SkillMetadata {
|
|
17
|
+
skillId: string;
|
|
18
|
+
name: string;
|
|
19
|
+
description: string;
|
|
20
|
+
compatibility?: string;
|
|
21
|
+
path: string;
|
|
22
|
+
skillFile: string;
|
|
23
|
+
scope: MaterialScope;
|
|
24
|
+
origin: ContributionOrigin;
|
|
25
|
+
disabled: boolean;
|
|
26
|
+
}
|
|
27
|
+
export interface MaterialWarning {
|
|
28
|
+
code: string;
|
|
29
|
+
path: string | null;
|
|
30
|
+
message: string;
|
|
31
|
+
}
|
|
32
|
+
export interface VisibilitySelector {
|
|
33
|
+
kind: "instruction" | "skill";
|
|
34
|
+
key: string;
|
|
35
|
+
}
|
|
36
|
+
export interface DiscoveredMaterials {
|
|
37
|
+
instructions: Instruction[];
|
|
38
|
+
nestedInstructions: Instruction[];
|
|
39
|
+
skills: SkillMetadata[];
|
|
40
|
+
warnings: MaterialWarning[];
|
|
41
|
+
nestedComplete: boolean;
|
|
42
|
+
skillsComplete: boolean;
|
|
43
|
+
}
|
|
44
|
+
export interface DiscoveryOptions {
|
|
45
|
+
agentId: string;
|
|
46
|
+
work: string;
|
|
47
|
+
home: string | null;
|
|
48
|
+
projectRoot?: string;
|
|
49
|
+
disabledItems?: readonly VisibilitySelector[];
|
|
50
|
+
signal?: AbortSignal;
|
|
51
|
+
maxDirectories?: number;
|
|
52
|
+
}
|
|
53
|
+
export declare const selectorKey: (kind: "instruction" | "skill", canonicalPath: string) => string;
|
|
54
|
+
export declare function boundedFile(filename: string, limit: number, signal?: AbortSignal): Promise<{
|
|
55
|
+
bytes: Buffer;
|
|
56
|
+
revision: string;
|
|
57
|
+
}>;
|
|
58
|
+
export declare function parseSkillFrontmatter(bytes: Buffer, directory: string): {
|
|
59
|
+
name: string;
|
|
60
|
+
description: string;
|
|
61
|
+
compatibility?: string;
|
|
62
|
+
};
|
|
63
|
+
export declare function discoverMaterials(options: DiscoveryOptions): Promise<DiscoveredMaterials>;
|
|
64
|
+
export declare function readProjectSummary(root: string, signal?: AbortSignal): Promise<{
|
|
65
|
+
description: string | null;
|
|
66
|
+
revision: string | null;
|
|
67
|
+
status: string;
|
|
68
|
+
reason?: string;
|
|
69
|
+
}>;
|
|
70
|
+
export declare function enabledMaterials(discovered: DiscoveredMaterials): DiscoveredMaterials;
|