@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,290 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { constants, closeSync, fstatSync, lstatSync, openSync, readFileSync, realpathSync, rmSync, } from "node:fs";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import { AgentError, requireCondition } from "../contracts/errors.js";
|
|
5
|
+
import { callerKey, fixedCaller } from "../contracts/caller.js";
|
|
6
|
+
import { canonicalJson, isPlainRecord, newId } from "../contracts/json.js";
|
|
7
|
+
import { terminalStatuses } from "../contracts/types.js";
|
|
8
|
+
import { parseArtifactUri } from "../results/artifacts.js";
|
|
9
|
+
import { atomicText, contains, privateDirectory } from "./paths.js";
|
|
10
|
+
const snapshotLimit = 96 * 1024 * 1024;
|
|
11
|
+
export const DEFAULT_TASK_TTL_MS = 24 * 60 * 60 * 1000;
|
|
12
|
+
export function taskAgentId(taskId) {
|
|
13
|
+
requireCondition(typeof taskId === "string" &&
|
|
14
|
+
/^nx_task_[A-Za-z0-9_-]{1,1016}$/.test(taskId), "invalid_task", "The Task identity is invalid.");
|
|
15
|
+
try {
|
|
16
|
+
const encoded = taskId.slice(8), bytes = Buffer.from(encoded, "base64url");
|
|
17
|
+
requireCondition(bytes.toString("base64url") === encoded, "invalid_task", "The Task identity is invalid.");
|
|
18
|
+
const route = JSON.parse(bytes.toString("utf8"));
|
|
19
|
+
requireCondition(Array.isArray(route) &&
|
|
20
|
+
route.length === 2 &&
|
|
21
|
+
typeof route[0] === "string" &&
|
|
22
|
+
route[0].length > 0 &&
|
|
23
|
+
route[0].length <= 256 &&
|
|
24
|
+
typeof route[1] === "string" &&
|
|
25
|
+
/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(route[1]), "invalid_task", "The Task route is invalid.");
|
|
26
|
+
return route[0];
|
|
27
|
+
}
|
|
28
|
+
catch (cause) {
|
|
29
|
+
if (cause instanceof AgentError)
|
|
30
|
+
throw cause;
|
|
31
|
+
throw new AgentError("invalid_task", "The Task route is invalid.");
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
/** Already normalized Core data only. Never follows a URL or interprets a guest object. */
|
|
35
|
+
export function localTaskArtifactIds(value, agentId, promisedAt = 0, retentionUntil) {
|
|
36
|
+
const ids = new Set();
|
|
37
|
+
const resource = (item) => {
|
|
38
|
+
if (!item ||
|
|
39
|
+
Array.isArray(item) ||
|
|
40
|
+
typeof item !== "object" ||
|
|
41
|
+
typeof item.uri !== "string")
|
|
42
|
+
return;
|
|
43
|
+
try {
|
|
44
|
+
const target = parseArtifactUri(item.uri);
|
|
45
|
+
if (target.agentId === agentId &&
|
|
46
|
+
item.resourceId === target.resourceId &&
|
|
47
|
+
typeof item.expiresAt === "string" &&
|
|
48
|
+
(Date.parse(item.expiresAt) > promisedAt ||
|
|
49
|
+
(retentionUntil?.(target.resourceId, typeof item.originRunId === "string" ? item.originRunId : null, Date.parse(item.expiresAt)) ?? 0) > promisedAt))
|
|
50
|
+
ids.add(target.resourceId);
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
/* Remote links are not fixed local artifacts. */
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
// Only encoder-owned artifact coordinates carry retention authority. A business
|
|
57
|
+
// string/object that happens to contain a URI must never revive old content.
|
|
58
|
+
if (value && !Array.isArray(value) && typeof value === "object") {
|
|
59
|
+
if (Array.isArray(value.content))
|
|
60
|
+
for (const block of value.content)
|
|
61
|
+
if (block && !Array.isArray(block) && typeof block === "object")
|
|
62
|
+
resource(block.resource);
|
|
63
|
+
const delivery = value.delivery;
|
|
64
|
+
if (delivery && !Array.isArray(delivery) && typeof delivery === "object") {
|
|
65
|
+
resource(delivery.dataResource);
|
|
66
|
+
resource(delivery.textResource);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
requireCondition(ids.size <= 16384, "task_result_too_large", "The Task result has too many artifact references.");
|
|
70
|
+
return Object.freeze([...ids]);
|
|
71
|
+
}
|
|
72
|
+
/** Durable association and result retention over the existing engine, never an executor. */
|
|
73
|
+
export class RuntimeTasks {
|
|
74
|
+
store;
|
|
75
|
+
engine;
|
|
76
|
+
#now;
|
|
77
|
+
#reserve;
|
|
78
|
+
constructor(store, engine, options = {}) {
|
|
79
|
+
requireCondition(engine.store === store, "runtime_profile_mismatch", "Tasks must use the original profile RunEngine.");
|
|
80
|
+
this.store = store;
|
|
81
|
+
this.engine = engine;
|
|
82
|
+
this.#now = options.now ?? Date.now;
|
|
83
|
+
this.#reserve = options.reserve;
|
|
84
|
+
}
|
|
85
|
+
#binding(task) {
|
|
86
|
+
return Object.freeze({
|
|
87
|
+
taskId: task.taskId,
|
|
88
|
+
agentId: this.store.binding.agentId,
|
|
89
|
+
runId: task.runId,
|
|
90
|
+
status: task.status,
|
|
91
|
+
createdAt: new Date(task.createdAt).toISOString(),
|
|
92
|
+
lastUpdatedAt: new Date(task.updatedAt).toISOString(),
|
|
93
|
+
expiresAt: new Date(task.expiresAt).toISOString(),
|
|
94
|
+
ttlMs: task.expiresAt - task.createdAt,
|
|
95
|
+
...(task.error ? { error: task.error } : {}),
|
|
96
|
+
});
|
|
97
|
+
}
|
|
98
|
+
#task(caller, taskId) {
|
|
99
|
+
requireCondition(taskAgentId(taskId) === this.store.binding.agentId, "agent_mismatch", "The Task targets another Agent.");
|
|
100
|
+
return this.store.getTask(taskId, callerKey(caller), this.#now());
|
|
101
|
+
}
|
|
102
|
+
pinResult(runId, result) {
|
|
103
|
+
this.store.pinTaskRunArtifacts(runId, localTaskArtifactIds(result, this.store.binding.agentId), this.#now());
|
|
104
|
+
}
|
|
105
|
+
async create(caller, input, signal) {
|
|
106
|
+
caller = fixedCaller(caller);
|
|
107
|
+
let view = await this.engine.observe(caller, input.runId, 0, signal);
|
|
108
|
+
signal?.throwIfAborted();
|
|
109
|
+
const previous = this.store.taskForRun(view.run.runId, callerKey(caller), this.#now());
|
|
110
|
+
if (previous)
|
|
111
|
+
return (await this.#capture(caller, previous, view)).task;
|
|
112
|
+
const taskId = "nx_task_" +
|
|
113
|
+
Buffer.from(JSON.stringify([this.store.binding.agentId, randomUUID()])).toString("base64url");
|
|
114
|
+
let admission;
|
|
115
|
+
try {
|
|
116
|
+
admission = await this.#reserve?.(65536);
|
|
117
|
+
}
|
|
118
|
+
catch (cause) {
|
|
119
|
+
const concurrent = this.store.taskForRun(view.run.runId, callerKey(caller), this.#now());
|
|
120
|
+
if (!concurrent)
|
|
121
|
+
throw cause;
|
|
122
|
+
return (await this.#capture(caller, concurrent, view)).task;
|
|
123
|
+
}
|
|
124
|
+
let task;
|
|
125
|
+
try {
|
|
126
|
+
view = await this.engine.observe(caller, input.runId, 0, signal);
|
|
127
|
+
task = this.store.createTask({
|
|
128
|
+
taskId,
|
|
129
|
+
callerKey: callerKey(caller),
|
|
130
|
+
runId: view.run.runId,
|
|
131
|
+
ttlMs: input.ttlMs ?? DEFAULT_TASK_TTL_MS,
|
|
132
|
+
}, this.#now());
|
|
133
|
+
}
|
|
134
|
+
finally {
|
|
135
|
+
admission?.release();
|
|
136
|
+
}
|
|
137
|
+
return (await this.#capture(caller, task, view)).task;
|
|
138
|
+
}
|
|
139
|
+
async get(caller, taskId, signal) {
|
|
140
|
+
caller = fixedCaller(caller);
|
|
141
|
+
const task = this.#task(caller, taskId);
|
|
142
|
+
// IDs and retained metadata never stand in for today's Grant or run authority.
|
|
143
|
+
const current = await this.engine.observe(caller, task.runId, 0, signal);
|
|
144
|
+
signal?.throwIfAborted();
|
|
145
|
+
return await this.#capture(caller, task, current);
|
|
146
|
+
}
|
|
147
|
+
async update(caller, input, signal, beforeInput) {
|
|
148
|
+
caller = fixedCaller(caller);
|
|
149
|
+
const task = this.#task(caller, input.taskId);
|
|
150
|
+
requireCondition(!["completed", "cancelled", "failed"].includes(task.status), "task_closed", "The Task is already terminal.");
|
|
151
|
+
await beforeInput?.(task.runId);
|
|
152
|
+
signal?.throwIfAborted();
|
|
153
|
+
const view = await this.engine.input(caller, {
|
|
154
|
+
agentId: this.store.binding.agentId,
|
|
155
|
+
runId: task.runId,
|
|
156
|
+
waitId: input.waitId,
|
|
157
|
+
input: input.input,
|
|
158
|
+
...(input.attachments ? { attachments: input.attachments } : {}),
|
|
159
|
+
waitMs: 0,
|
|
160
|
+
}, signal);
|
|
161
|
+
return await this.#capture(caller, task, view);
|
|
162
|
+
}
|
|
163
|
+
async cancel(caller, taskId, signal) {
|
|
164
|
+
caller = fixedCaller(caller);
|
|
165
|
+
const task = this.#task(caller, taskId);
|
|
166
|
+
signal?.throwIfAborted();
|
|
167
|
+
if (["completed", "cancelled", "failed"].includes(task.status))
|
|
168
|
+
return { ...(await this.get(caller, taskId, signal)), accepted: false };
|
|
169
|
+
const view = this.engine.cancel(caller, task.runId);
|
|
170
|
+
return {
|
|
171
|
+
...(await this.#capture(caller, task, view)),
|
|
172
|
+
accepted: view.accepted,
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
/** Trusted JSON-RPC method failure, distinct from an ordinary isError tool result. */
|
|
176
|
+
async fail(caller, taskId, error, signal) {
|
|
177
|
+
caller = fixedCaller(caller);
|
|
178
|
+
const task = this.#task(caller, taskId), view = await this.engine.observe(caller, task.runId, 0, signal);
|
|
179
|
+
return await this.#capture(caller, task, view, error);
|
|
180
|
+
}
|
|
181
|
+
#read(task, current) {
|
|
182
|
+
requireCondition(task.resultRef, "task_result_unavailable", "The terminal Task result is unavailable.");
|
|
183
|
+
const expected = `state/tasks/${createHash("sha256").update(task.taskId).digest("hex")}/`;
|
|
184
|
+
let fd;
|
|
185
|
+
try {
|
|
186
|
+
requireCondition(task.resultRef.startsWith(expected) &&
|
|
187
|
+
/^result_[0-9a-f]{32}\.json$/.test(task.resultRef.slice(expected.length)), "task_result_unavailable", "The Task result reference is invalid.");
|
|
188
|
+
const filename = path.join(this.store.root, task.resultRef);
|
|
189
|
+
const directory = path.dirname(filename);
|
|
190
|
+
requireCondition(realpathSync.native(this.store.root) === this.store.root &&
|
|
191
|
+
realpathSync.native(directory) === directory &&
|
|
192
|
+
contains(this.store.root, directory) &&
|
|
193
|
+
lstatSync(filename).isFile(), "task_result_unavailable", "The retained Task result was redirected.");
|
|
194
|
+
fd = openSync(filename, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
|
|
195
|
+
requireCondition(fstatSync(fd).isFile() && fstatSync(fd).size <= snapshotLimit, "task_result_unavailable", "The retained Task result exceeds its original budget.");
|
|
196
|
+
const value = JSON.parse(readFileSync(fd, "utf8"));
|
|
197
|
+
requireCondition(isPlainRecord(value) &&
|
|
198
|
+
isPlainRecord(value.run) &&
|
|
199
|
+
value.run.runId === task.runId &&
|
|
200
|
+
value.run.callerKey === task.callerKey, "task_result_unavailable", "The retained Task result belongs to another run.");
|
|
201
|
+
const { taskSnapshotVersion, retainedResult, retainedResultHash, retainedArtifacts: _artifacts, ...saved } = value;
|
|
202
|
+
if (taskSnapshotVersion === 1 && retainedResult === true) {
|
|
203
|
+
requireCondition(isPlainRecord(saved.run) &&
|
|
204
|
+
saved.run.resultRef === current.run.resultRef, "task_result_unavailable", "The original Task result reference changed.");
|
|
205
|
+
if (current.result)
|
|
206
|
+
requireCondition(typeof retainedResultHash === "string" &&
|
|
207
|
+
createHash("sha256")
|
|
208
|
+
.update(canonicalJson(current.result, snapshotLimit))
|
|
209
|
+
.digest("hex") === retainedResultHash, "task_result_unavailable", "The original Task result content changed.");
|
|
210
|
+
return {
|
|
211
|
+
...saved,
|
|
212
|
+
result: current.result,
|
|
213
|
+
...(current.unavailable ? { unavailable: current.unavailable } : {}),
|
|
214
|
+
};
|
|
215
|
+
}
|
|
216
|
+
return saved;
|
|
217
|
+
}
|
|
218
|
+
catch (cause) {
|
|
219
|
+
throw new AgentError("task_result_unavailable", "The original terminal Task result is unavailable; it will not be regenerated.", undefined, { cause });
|
|
220
|
+
}
|
|
221
|
+
finally {
|
|
222
|
+
if (fd !== undefined)
|
|
223
|
+
closeSync(fd);
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
async #capture(caller, task, view, rpcError) {
|
|
227
|
+
// Another simultaneous query can have settled the same Task while we observed.
|
|
228
|
+
task = this.store.getTask(task.taskId, task.callerKey, this.#now());
|
|
229
|
+
if (["completed", "cancelled", "failed"].includes(task.status))
|
|
230
|
+
return { task: this.#binding(task), view: this.#read(task, view) };
|
|
231
|
+
const status = rpcError
|
|
232
|
+
? "failed"
|
|
233
|
+
: view.run.status === "cancelled"
|
|
234
|
+
? "cancelled"
|
|
235
|
+
: terminalStatuses.has(view.run.status)
|
|
236
|
+
? "completed"
|
|
237
|
+
: view.wait && ["none", "failed"].includes(view.wait.deliveryState)
|
|
238
|
+
? "input_required"
|
|
239
|
+
: "working";
|
|
240
|
+
if (status === "working" || status === "input_required") {
|
|
241
|
+
task = this.store.updateTask(task.taskId, task.callerKey, { status }, this.#now());
|
|
242
|
+
return { task: this.#binding(task), view };
|
|
243
|
+
}
|
|
244
|
+
if (view.result)
|
|
245
|
+
this.store.pinTaskRunArtifacts(view.run.runId, localTaskArtifactIds(view.result, this.store.binding.agentId, task.createdAt, (id, originRunId, expiresAt) => this.store.taskArtifactRetentionUntil(id, originRunId, this.#now(), expiresAt)), this.#now());
|
|
246
|
+
const serialized = canonicalJson({
|
|
247
|
+
...view,
|
|
248
|
+
result: null,
|
|
249
|
+
taskSnapshotVersion: 1,
|
|
250
|
+
retainedResult: view.result !== null,
|
|
251
|
+
retainedResultHash: view.result
|
|
252
|
+
? createHash("sha256")
|
|
253
|
+
.update(canonicalJson(view.result, snapshotLimit))
|
|
254
|
+
.digest("hex")
|
|
255
|
+
: null,
|
|
256
|
+
retainedArtifacts: view.result
|
|
257
|
+
? localTaskArtifactIds(view.result, this.store.binding.agentId).map((resourceId) => ({ resourceId }))
|
|
258
|
+
: [],
|
|
259
|
+
}, snapshotLimit), reservation = await this.#reserve?.(Buffer.byteLength(serialized) + 1024, { control: true });
|
|
260
|
+
let filename;
|
|
261
|
+
try {
|
|
262
|
+
// A quota scan can yield: the current caller must still be authorized before publication.
|
|
263
|
+
await this.engine.observe(caller, task.runId, 0);
|
|
264
|
+
const directory = privateDirectory(this.store.root, "state", "tasks", createHash("sha256").update(task.taskId).digest("hex"));
|
|
265
|
+
filename = path.join(directory, newId("result") + ".json");
|
|
266
|
+
const ref = path
|
|
267
|
+
.relative(this.store.root, filename)
|
|
268
|
+
.split(path.sep)
|
|
269
|
+
.join("/");
|
|
270
|
+
// Persist only the engine's normalized original result, never a fresh wire stream or delivery URL.
|
|
271
|
+
atomicText(filename, serialized);
|
|
272
|
+
task = this.store.updateTask(task.taskId, task.callerKey, { status, resultRef: ref, ...(rpcError ? { error: rpcError } : {}) }, this.#now());
|
|
273
|
+
if (task.resultRef !== ref)
|
|
274
|
+
rmSync(filename, { force: true });
|
|
275
|
+
return {
|
|
276
|
+
task: this.#binding(task),
|
|
277
|
+
view: task.resultRef === ref ? view : this.#read(task, view),
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
catch (cause) {
|
|
281
|
+
if (filename)
|
|
282
|
+
rmSync(filename, { force: true });
|
|
283
|
+
throw cause;
|
|
284
|
+
}
|
|
285
|
+
finally {
|
|
286
|
+
reservation?.release();
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
//# sourceMappingURL=tasks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/runtime/tasks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
2
|
+
import { maintenanceMethods } from "../maintenance/requests.js";
|
|
3
|
+
/** Public call-bound facade, identical for built-in and external extensions. */
|
|
4
|
+
export const maintenanceExtension = () => {
|
|
5
|
+
const methods = {};
|
|
6
|
+
const text = { type: "string", minLength: 1, maxLength: 8192 };
|
|
7
|
+
for (const name of [
|
|
8
|
+
...maintenanceMethods,
|
|
9
|
+
"get",
|
|
10
|
+
"list",
|
|
11
|
+
"cancel",
|
|
12
|
+
]) {
|
|
13
|
+
const parts = name.split("."), group = parts.length === 2 ? parts[0] : null, action = parts.at(-1);
|
|
14
|
+
const properties = group
|
|
15
|
+
? { name: { type: "string", minLength: 1, maxLength: 214 } }
|
|
16
|
+
: name === "list"
|
|
17
|
+
? {
|
|
18
|
+
target: { enum: ["package", "extension", "mcp", "api"] },
|
|
19
|
+
name: text,
|
|
20
|
+
status: {
|
|
21
|
+
enum: ["pending", "approved", "denied", "cancelled", "expired"],
|
|
22
|
+
},
|
|
23
|
+
limit: { type: "integer", minimum: 1, maximum: 100 },
|
|
24
|
+
cursor: text,
|
|
25
|
+
}
|
|
26
|
+
: { requestId: text };
|
|
27
|
+
const required = group
|
|
28
|
+
? ["name"]
|
|
29
|
+
: name === "list"
|
|
30
|
+
? []
|
|
31
|
+
: ["requestId"];
|
|
32
|
+
if (group === "packages" && action !== "remove")
|
|
33
|
+
properties.version = { type: "string", minLength: 1, maxLength: 256 };
|
|
34
|
+
if (group === "mcp" && action !== "remove") {
|
|
35
|
+
properties.config = { type: "object" };
|
|
36
|
+
required.push("config");
|
|
37
|
+
}
|
|
38
|
+
if (group === "api" && action !== "remove")
|
|
39
|
+
Object.assign(properties, {
|
|
40
|
+
url: text,
|
|
41
|
+
path: text,
|
|
42
|
+
config: { type: "object" },
|
|
43
|
+
});
|
|
44
|
+
methods[name] = {
|
|
45
|
+
description: group
|
|
46
|
+
? `申请 ${name};用户确认最终修订后才实际执行。`
|
|
47
|
+
: `${name === "get" ? "读取" : name === "list" ? "筛选" : "撤销尚未执行的"}维护申请;不批准或重签。`,
|
|
48
|
+
permissions: [`maintenance.${name}`],
|
|
49
|
+
path: parts,
|
|
50
|
+
normalize(args) {
|
|
51
|
+
requireCondition(name === "list" ? args.length <= 1 : args.length === 1, "invalid_arguments", "Use this maintenance method's declared arguments.");
|
|
52
|
+
return group
|
|
53
|
+
? args[0]
|
|
54
|
+
: name === "list"
|
|
55
|
+
? (args[0] ?? {})
|
|
56
|
+
: { requestId: args[0] };
|
|
57
|
+
},
|
|
58
|
+
inputSchema: {
|
|
59
|
+
$schema: "https://json-schema.org/draft/2020-12/schema",
|
|
60
|
+
type: "object",
|
|
61
|
+
additionalProperties: false,
|
|
62
|
+
properties,
|
|
63
|
+
required,
|
|
64
|
+
},
|
|
65
|
+
handle(input, call) {
|
|
66
|
+
if (group) {
|
|
67
|
+
const service = call.maintenance[group];
|
|
68
|
+
return service[action](input);
|
|
69
|
+
}
|
|
70
|
+
if (name === "get")
|
|
71
|
+
return call.maintenance.get(input.requestId);
|
|
72
|
+
if (name === "cancel")
|
|
73
|
+
return call.maintenance.cancel(input.requestId);
|
|
74
|
+
return call.maintenance.list(input);
|
|
75
|
+
},
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
return { methods };
|
|
79
|
+
};
|
|
80
|
+
//# sourceMappingURL=maintenance.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../src/sdk/maintenance.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { requireCondition } from "../contracts/errors.js";
|
|
2
|
+
const descriptions = {
|
|
3
|
+
text: "返回文本内容。",
|
|
4
|
+
json: "明确返回结构化业务数据,不将同形对象转换为媒体。",
|
|
5
|
+
image: "预览一张真实图片。",
|
|
6
|
+
images: "按顺序预览多张真实图片。",
|
|
7
|
+
audio: "返回音频内容。",
|
|
8
|
+
resourceLink: "固定本地文件并返回可通过 MCP Resources 获取的资源引用。",
|
|
9
|
+
file: "返回文件资源引用,是 resourceLink 的简写。",
|
|
10
|
+
embeddedResource: "在结果中嵌入受限大小的资源正文。",
|
|
11
|
+
resource: "嵌入资源正文,是 embeddedResource 的简写。",
|
|
12
|
+
result: "组合内容块、结构化业务数据和业务错误标记。",
|
|
13
|
+
error: "返回业务错误,不设置运行终态。",
|
|
14
|
+
};
|
|
15
|
+
/** The script facade is registered by the same factory protocol as any npm extension. */
|
|
16
|
+
export const outputExtension = () => {
|
|
17
|
+
const methods = {};
|
|
18
|
+
for (const name of Object.keys(descriptions)) {
|
|
19
|
+
const one = name === "json" || name === "result";
|
|
20
|
+
methods[name] = {
|
|
21
|
+
description: descriptions[name],
|
|
22
|
+
permissions: ["output"],
|
|
23
|
+
normalize(args) {
|
|
24
|
+
requireCondition(args.length >= 1 && args.length <= (one ? 1 : 2), "invalid_arguments", "The output helper requires its declared value and optional metadata.");
|
|
25
|
+
return {
|
|
26
|
+
value: args[0],
|
|
27
|
+
...(args.length === 2 ? { options: args[1] } : {}),
|
|
28
|
+
};
|
|
29
|
+
},
|
|
30
|
+
inputSchema: {
|
|
31
|
+
$schema: "https://json-schema.org/draft/2020-12/schema",
|
|
32
|
+
type: "object",
|
|
33
|
+
additionalProperties: false,
|
|
34
|
+
properties: { value: {}, ...(one ? {} : { options: {} }) },
|
|
35
|
+
required: ["value"],
|
|
36
|
+
},
|
|
37
|
+
handle(input, call) {
|
|
38
|
+
return Reflect.apply(call.output[name], undefined, one ? [input.value] : [input.value, input.options]);
|
|
39
|
+
},
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
return { methods };
|
|
43
|
+
};
|
|
44
|
+
//# sourceMappingURL=output-extension.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"output-extension.js","sourceRoot":"","sources":["../../src/sdk/output-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ1D,MAAM,YAAY,GAAuC;IACvD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,0BAA0B;IAChC,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,qCAAqC;IACnD,IAAI,EAAE,8BAA8B;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,QAAQ,EAAE,gCAAgC;IAC1C,MAAM,EAAE,uBAAuB;IAC/B,KAAK,EAAE,iBAAiB;CACzB,CAAC;AAEF,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAqB,GAAG,EAAE;IACpD,MAAM,OAAO,GAAqC,EAAE,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAyB,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,GAAG;YACd,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC;YAC/B,WAAW,EAAE,CAAC,QAAQ,CAAC;YACvB,SAAS,CAAC,IAAI;gBACZ,gBAAgB,CACd,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAChD,mBAAmB,EACnB,sEAAsE,CACvE,CAAC;gBACF,OAAO;oBACL,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;oBACd,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnD,CAAC;YACJ,CAAC;YACD,WAAW,EAAE;gBACX,OAAO,EAAE,8CAA8C;gBACvD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE;gBAC1D,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,MAAM,CAAC,KAAK,EAAE,IAAI;gBAChB,OAAO,OAAO,CAAC,KAAK,CAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EACjB,SAAS,EACT,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CACnD,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC,CAAC"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { Blob } from "node:buffer";
|
|
2
|
+
import { type McpOutputBinding, type McpResultOptions } from "../results/mcp.js";
|
|
3
|
+
import type { JsonObject } from "../contracts/types.js";
|
|
4
|
+
export interface OutputSource {
|
|
5
|
+
path?: string;
|
|
6
|
+
uri?: string;
|
|
7
|
+
data?: ArrayBufferView | ArrayBuffer | SharedArrayBuffer | Blob;
|
|
8
|
+
mimeType?: string;
|
|
9
|
+
name?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface OutputOptions {
|
|
12
|
+
name?: string;
|
|
13
|
+
description?: string;
|
|
14
|
+
mimeType?: string;
|
|
15
|
+
annotations?: {
|
|
16
|
+
audience?: ("user" | "assistant")[];
|
|
17
|
+
priority?: number;
|
|
18
|
+
lastModified?: string;
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
export interface OutputIntent {
|
|
22
|
+
readonly kind: "text" | "json" | "image" | "audio" | "resource_link" | "resource" | "collection" | "result";
|
|
23
|
+
readonly value: unknown;
|
|
24
|
+
readonly options: Readonly<OutputOptions>;
|
|
25
|
+
}
|
|
26
|
+
export interface OutputResult {
|
|
27
|
+
content: readonly unknown[];
|
|
28
|
+
structuredContent?: unknown;
|
|
29
|
+
isError?: boolean;
|
|
30
|
+
}
|
|
31
|
+
export interface OutputAPI {
|
|
32
|
+
mcpResult(value: unknown, options: McpResultOptions): JsonObject;
|
|
33
|
+
mcpResourceResult(value: unknown, options: Omit<McpResultOptions, "method">): JsonObject;
|
|
34
|
+
text(value: string, options?: OutputOptions): OutputIntent;
|
|
35
|
+
json(value: unknown): OutputIntent;
|
|
36
|
+
image(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
37
|
+
images(sources: readonly (string | OutputSource)[], options?: OutputOptions): OutputIntent;
|
|
38
|
+
audio(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
39
|
+
resourceLink(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
40
|
+
file(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
41
|
+
embeddedResource(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
42
|
+
resource(source: string | OutputSource, options?: OutputOptions): OutputIntent;
|
|
43
|
+
result(value: OutputResult): OutputIntent;
|
|
44
|
+
error(message: string, options?: {
|
|
45
|
+
content?: readonly unknown[];
|
|
46
|
+
structuredContent?: unknown;
|
|
47
|
+
}): OutputIntent;
|
|
48
|
+
}
|
|
49
|
+
export declare function outputIntent(value: unknown): OutputIntent | null;
|
|
50
|
+
/** Core-only: preserve an issued intent's brand after its data graph is snapshotted. */
|
|
51
|
+
export declare function rebuildOutputIntent(original: OutputIntent, value: unknown, options: Readonly<OutputOptions>): OutputIntent;
|
|
52
|
+
export declare function createOutput(pwd: string, current: () => void, mcpBinding?: McpOutputBinding): OutputAPI;
|