@cotal-ai/workspace 0.90.1 → 0.92.0
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/build/Release/win32-arm64/build.json +1 -1
- package/build/Release/win32-x64/build.json +2 -2
- package/build/Release/win32-x64/creation.node +0 -0
- package/dist/agent-secrets.d.ts +2 -2
- package/dist/agent-secrets.d.ts.map +1 -1
- package/dist/agent-secrets.js +2 -2
- package/dist/agent-secrets.js.map +1 -1
- package/dist/auth-paths.d.ts +8 -2
- package/dist/auth-paths.d.ts.map +1 -1
- package/dist/auth-paths.js +12 -5
- package/dist/auth-paths.js.map +1 -1
- package/dist/broker-display.d.ts +4 -0
- package/dist/broker-display.d.ts.map +1 -0
- package/dist/broker-display.js +29 -0
- package/dist/broker-display.js.map +1 -0
- package/dist/colors.d.ts +11 -4
- package/dist/colors.d.ts.map +1 -1
- package/dist/colors.js +36 -9
- package/dist/colors.js.map +1 -1
- package/dist/connect.d.ts +81 -10
- package/dist/connect.d.ts.map +1 -1
- package/dist/connect.js +195 -75
- package/dist/connect.js.map +1 -1
- package/dist/control-target.d.ts +2 -2
- package/dist/control-target.d.ts.map +1 -1
- package/dist/control-target.js +13 -5
- package/dist/control-target.js.map +1 -1
- package/dist/credential-actions.d.ts +91 -0
- package/dist/credential-actions.d.ts.map +1 -0
- package/dist/credential-actions.js +74 -0
- package/dist/credential-actions.js.map +1 -0
- package/dist/deprecated-daemon-entries.d.ts +30 -0
- package/dist/deprecated-daemon-entries.d.ts.map +1 -0
- package/dist/deprecated-daemon-entries.js +37 -0
- package/dist/deprecated-daemon-entries.js.map +1 -0
- package/dist/endpoint-actions.d.ts +31 -0
- package/dist/endpoint-actions.d.ts.map +1 -0
- package/dist/endpoint-actions.js +2 -0
- package/dist/endpoint-actions.js.map +1 -0
- package/dist/endpoint-caller.d.ts +74 -0
- package/dist/endpoint-caller.d.ts.map +1 -0
- package/dist/endpoint-caller.js +118 -0
- package/dist/endpoint-caller.js.map +1 -0
- package/dist/endpoint-contract.d.ts +32 -0
- package/dist/endpoint-contract.d.ts.map +1 -0
- package/dist/endpoint-contract.js +92 -0
- package/dist/endpoint-contract.js.map +1 -0
- package/dist/extension-mutation.d.ts.map +1 -1
- package/dist/extension-mutation.js +4 -1
- package/dist/extension-mutation.js.map +1 -1
- package/dist/extensions.d.ts +28 -8
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +20 -8
- package/dist/extensions.js.map +1 -1
- package/dist/flags.d.ts +8 -1
- package/dist/flags.d.ts.map +1 -1
- package/dist/flags.js +9 -7
- package/dist/flags.js.map +1 -1
- package/dist/index.d.ts +25 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +25 -0
- package/dist/index.js.map +1 -1
- package/dist/launch-persona.d.ts +10 -0
- package/dist/launch-persona.d.ts.map +1 -0
- package/dist/launch-persona.js +34 -0
- package/dist/launch-persona.js.map +1 -0
- package/dist/local-process.d.ts +60 -12
- package/dist/local-process.d.ts.map +1 -1
- package/dist/local-process.js +173 -4
- package/dist/local-process.js.map +1 -1
- package/dist/maintenance.d.ts +267 -4
- package/dist/maintenance.d.ts.map +1 -1
- package/dist/maintenance.js +666 -12
- package/dist/maintenance.js.map +1 -1
- package/dist/mesh-manifest-schema.d.ts +118 -0
- package/dist/mesh-manifest-schema.d.ts.map +1 -0
- package/dist/mesh-manifest-schema.js +96 -0
- package/dist/mesh-manifest-schema.js.map +1 -0
- package/dist/mesh-registry.d.ts +30 -0
- package/dist/mesh-registry.d.ts.map +1 -1
- package/dist/mesh-registry.js +74 -13
- package/dist/mesh-registry.js.map +1 -1
- package/dist/mesh-target.d.ts +15 -7
- package/dist/mesh-target.d.ts.map +1 -1
- package/dist/mesh-target.js +77 -26
- package/dist/mesh-target.js.map +1 -1
- package/dist/official-connectors.d.ts +13 -0
- package/dist/official-connectors.d.ts.map +1 -1
- package/dist/official-connectors.js +18 -2
- package/dist/official-connectors.js.map +1 -1
- package/dist/output.d.ts +147 -0
- package/dist/output.d.ts.map +1 -0
- package/dist/output.js +186 -0
- package/dist/output.js.map +1 -0
- package/dist/pid.d.ts +5 -3
- package/dist/pid.d.ts.map +1 -1
- package/dist/pid.js +25 -13
- package/dist/pid.js.map +1 -1
- package/dist/preferences.d.ts +93 -0
- package/dist/preferences.d.ts.map +1 -0
- package/dist/preferences.js +272 -0
- package/dist/preferences.js.map +1 -0
- package/dist/preflight.d.ts +3 -0
- package/dist/preflight.d.ts.map +1 -1
- package/dist/preflight.js +6 -3
- package/dist/preflight.js.map +1 -1
- package/dist/prepared-spaces.d.ts +27 -0
- package/dist/prepared-spaces.d.ts.map +1 -0
- package/dist/prepared-spaces.js +57 -0
- package/dist/prepared-spaces.js.map +1 -0
- package/dist/present.d.ts +108 -0
- package/dist/present.d.ts.map +1 -0
- package/dist/present.js +249 -0
- package/dist/present.js.map +1 -0
- package/dist/prompt-input.d.ts +12 -0
- package/dist/prompt-input.d.ts.map +1 -0
- package/dist/prompt-input.js +35 -0
- package/dist/prompt-input.js.map +1 -0
- package/dist/protected-records.d.ts +102 -0
- package/dist/protected-records.d.ts.map +1 -0
- package/dist/protected-records.js +465 -0
- package/dist/protected-records.js.map +1 -0
- package/dist/registration-policy.d.ts +4 -1
- package/dist/registration-policy.d.ts.map +1 -1
- package/dist/registration-policy.js +4 -3
- package/dist/registration-policy.js.map +1 -1
- package/dist/render.d.ts +8 -0
- package/dist/render.d.ts.map +1 -1
- package/dist/render.js +49 -32
- package/dist/render.js.map +1 -1
- package/dist/renewal-path.d.ts +5 -0
- package/dist/renewal-path.d.ts.map +1 -0
- package/dist/renewal-path.js +9 -0
- package/dist/renewal-path.js.map +1 -0
- package/dist/renewal.d.ts +6 -9
- package/dist/renewal.d.ts.map +1 -1
- package/dist/renewal.js +7 -12
- package/dist/renewal.js.map +1 -1
- package/dist/service-adapter.d.ts +201 -0
- package/dist/service-adapter.d.ts.map +1 -0
- package/dist/service-adapter.js +294 -0
- package/dist/service-adapter.js.map +1 -0
- package/dist/service-custody.d.ts +5 -0
- package/dist/service-custody.d.ts.map +1 -0
- package/dist/service-custody.js +41 -0
- package/dist/service-custody.js.map +1 -0
- package/dist/service-definition.d.ts +52 -0
- package/dist/service-definition.d.ts.map +1 -0
- package/dist/service-definition.js +85 -0
- package/dist/service-definition.js.map +1 -0
- package/dist/service-definition.schema.json +79 -0
- package/dist/service-extension-metadata.d.ts +11 -0
- package/dist/service-extension-metadata.d.ts.map +1 -0
- package/dist/service-extension-metadata.js +66 -0
- package/dist/service-extension-metadata.js.map +1 -0
- package/dist/service-identity.d.ts +51 -0
- package/dist/service-identity.d.ts.map +1 -0
- package/dist/service-identity.js +103 -0
- package/dist/service-identity.js.map +1 -0
- package/dist/service-observation.d.ts +32 -0
- package/dist/service-observation.d.ts.map +1 -0
- package/dist/service-observation.js +134 -0
- package/dist/service-observation.js.map +1 -0
- package/dist/service-preset.d.ts +12 -0
- package/dist/service-preset.d.ts.map +1 -0
- package/dist/service-preset.js +10 -0
- package/dist/service-preset.js.map +1 -0
- package/dist/service-startup.d.ts +23 -0
- package/dist/service-startup.d.ts.map +1 -0
- package/dist/service-startup.js +39 -0
- package/dist/service-startup.js.map +1 -0
- package/dist/service-stop.d.ts +47 -0
- package/dist/service-stop.d.ts.map +1 -0
- package/dist/service-stop.js +152 -0
- package/dist/service-stop.js.map +1 -0
- package/dist/service-target.d.ts +5 -0
- package/dist/service-target.d.ts.map +1 -0
- package/dist/service-target.js +19 -0
- package/dist/service-target.js.map +1 -0
- package/dist/signer-export.d.ts +31 -0
- package/dist/signer-export.d.ts.map +1 -0
- package/dist/signer-export.js +114 -0
- package/dist/signer-export.js.map +1 -0
- package/dist/space-segmentation.d.ts +21 -7
- package/dist/space-segmentation.d.ts.map +1 -1
- package/dist/space-segmentation.js +26 -9
- package/dist/space-segmentation.js.map +1 -1
- package/dist/space.d.ts +5 -5
- package/dist/space.d.ts.map +1 -1
- package/dist/space.js +8 -6
- package/dist/space.js.map +1 -1
- package/dist/system-rotation.d.ts +4 -3
- package/dist/system-rotation.d.ts.map +1 -1
- package/dist/system-rotation.js +16 -6
- package/dist/system-rotation.js.map +1 -1
- package/dist/web-session.d.ts +7 -0
- package/dist/web-session.d.ts.map +1 -1
- package/dist/web-session.js +9 -0
- package/dist/web-session.js.map +1 -1
- package/package.json +6 -2
|
@@ -0,0 +1,294 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { accessSync, constants, lstatSync } from "node:fs";
|
|
3
|
+
import { dirname, isAbsolute } from "node:path";
|
|
4
|
+
import { Ajv2020 } from "ajv/dist/2020.js";
|
|
5
|
+
import { endpointToken, token } from "@cotal-ai/core";
|
|
6
|
+
import { schemaErrorLocation } from "./service-definition.js";
|
|
7
|
+
import { CommandFailure } from "./output.js";
|
|
8
|
+
import { assertProtectedEntry, protectedCredentialReference, protectedLocalDirectory } from "./protected-records.js";
|
|
9
|
+
const invalid = (message) => { throw new CommandFailure("refused", "SCHEMA_INVALID", message); };
|
|
10
|
+
const plainObject = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value) && [Object.prototype, null].includes(Object.getPrototypeOf(value)));
|
|
11
|
+
const field = (name) => /^[A-Za-z][A-Za-z0-9_-]{0,127}$/.test(name) && !["constructor", "prototype", "__proto__"].includes(name);
|
|
12
|
+
/** Closed reader for a launch attempt, with the fields one adapter role may receive. Any other key
|
|
13
|
+
* refuses. Messages name fields, never values, because `resumeCommit` points at a secret file. */
|
|
14
|
+
export function serviceAdapterAttempt(input, allowed) {
|
|
15
|
+
if (!plainObject(input) || Object.keys(input).some((key) => !["kind", "attemptId", ...allowed].includes(key)) || input.kind !== "maintenance-resume")
|
|
16
|
+
return invalid("the launch attempt has an unsupported shape for this adapter");
|
|
17
|
+
if (typeof input.attemptId !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/.test(input.attemptId))
|
|
18
|
+
return invalid("the launch attempt id is not a safe attempt token");
|
|
19
|
+
if (input.serverName !== undefined && (typeof input.serverName !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/.test(input.serverName)))
|
|
20
|
+
return invalid("the launch attempt server name is invalid");
|
|
21
|
+
let resumeCommit;
|
|
22
|
+
if (input.resumeCommit !== undefined) {
|
|
23
|
+
const commit = input.resumeCommit;
|
|
24
|
+
if (!plainObject(commit) || Object.keys(commit).length !== 2 || typeof commit.path !== "string" || !isAbsolute(commit.path) || commit.path.length > 4096 || /[\u0000-\u001f\u007f]/u.test(commit.path) || typeof commit.sha256 !== "string" || !/^[0-9a-f]{64}$/.test(commit.sha256))
|
|
25
|
+
return invalid("the launch attempt resume-commit handoff is invalid");
|
|
26
|
+
resumeCommit = { path: commit.path, sha256: commit.sha256 };
|
|
27
|
+
}
|
|
28
|
+
return { kind: "maintenance-resume", attemptId: input.attemptId, ...(typeof input.serverName === "string" ? { serverName: input.serverName } : {}), ...(resumeCommit ? { resumeCommit } : {}) };
|
|
29
|
+
}
|
|
30
|
+
/** Finite JSON and sorted keys give cached declarations a stable fingerprint, not a signature. */
|
|
31
|
+
export function serviceMetadataDigest(value) {
|
|
32
|
+
let nodes = 0;
|
|
33
|
+
const canonical = (input, depth) => {
|
|
34
|
+
if (++nodes > 16384 || depth > 24)
|
|
35
|
+
return invalid("service metadata exceeds its structural bound");
|
|
36
|
+
if (input === null || typeof input === "string" || typeof input === "boolean" || typeof input === "number" && Number.isFinite(input))
|
|
37
|
+
return input;
|
|
38
|
+
if (Array.isArray(input))
|
|
39
|
+
return input.map((item) => canonical(item, depth + 1));
|
|
40
|
+
if (!plainObject(input))
|
|
41
|
+
return invalid("service metadata must contain only finite JSON values");
|
|
42
|
+
return Object.fromEntries(Object.keys(input).sort().map((key) => [key, canonical(input[key], depth + 1)]));
|
|
43
|
+
};
|
|
44
|
+
const text = JSON.stringify(canonical(value, 0));
|
|
45
|
+
if (Buffer.byteLength(text, "utf8") > 1024 * 1024)
|
|
46
|
+
return invalid("service metadata exceeds 1 MiB");
|
|
47
|
+
return createHash("sha256").update(text).digest("hex");
|
|
48
|
+
}
|
|
49
|
+
/** A deliberately closed, bounded JSON Schema subset. No references, regexes, formats, executable
|
|
50
|
+
* keywords, schema fetching, coercion, defaults or removal of unknown options are admitted. */
|
|
51
|
+
export function serviceAdapterDeclaration(input) {
|
|
52
|
+
if (!plainObject(input) || Object.keys(input).some((key) => !["abiVersion", "requiresCli", "optionsSchema", "paths", "capabilities", "readiness", "stop"].includes(key)) || input.abiVersion !== 1 || !["process", "endpoint", "listener"].includes(String(input.readiness)))
|
|
53
|
+
return invalid("the local service adapter declaration has an unsupported ABI or readiness policy");
|
|
54
|
+
if (input.stop !== undefined && input.stop !== "native" && input.stop !== "kernel-exit")
|
|
55
|
+
return invalid("an adapter stop policy must explicitly select native request-bound control or exact kernel-exit control");
|
|
56
|
+
if ((input.readiness === "listener") !== (input.stop === "kernel-exit"))
|
|
57
|
+
return invalid("listener readiness and kernel-exit stop are one closed broker policy; neither is accepted alone");
|
|
58
|
+
if (input.requiresCli !== undefined && input.requiresCli !== true)
|
|
59
|
+
return invalid("an adapter CLI requirement must be explicit");
|
|
60
|
+
const capabilities = input.capabilities;
|
|
61
|
+
if (!plainObject(capabilities) || Object.keys(capabilities).length !== 3 || !["multiInstance", "foreground", "logs"].every((key) => typeof capabilities[key] === "boolean"))
|
|
62
|
+
return invalid("the local service adapter must declare every supported lifecycle capability");
|
|
63
|
+
let count = 0;
|
|
64
|
+
const visit = (schema, depth) => {
|
|
65
|
+
if (++count > 2048 || depth > 16 || !plainObject(schema))
|
|
66
|
+
return invalid("the adapter option schema is not a bounded closed schema");
|
|
67
|
+
const common = ["type", "title", "description", "enum", "const"];
|
|
68
|
+
const type = schema.type;
|
|
69
|
+
const keywords = type === "object" ? ["properties", "required", "additionalProperties", "maxProperties"]
|
|
70
|
+
: type === "array" ? ["items", "minItems", "maxItems"]
|
|
71
|
+
: type === "string" ? ["minLength", "maxLength"]
|
|
72
|
+
: type === "number" || type === "integer" ? ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"] : [];
|
|
73
|
+
if (!["object", "array", "string", "number", "integer", "boolean", "null"].includes(String(type)) || Object.keys(schema).some((key) => !common.includes(key) && !keywords.includes(key)))
|
|
74
|
+
return invalid("the adapter option schema uses an unsupported keyword or type");
|
|
75
|
+
for (const key of ["title", "description"])
|
|
76
|
+
if (schema[key] !== undefined && (typeof schema[key] !== "string" || schema[key].length > 1000))
|
|
77
|
+
return invalid("adapter schema descriptions exceed their bounds");
|
|
78
|
+
if (type === "object") {
|
|
79
|
+
if (schema.additionalProperties !== false || !plainObject(schema.properties) || Object.keys(schema.properties).length > 128 || Object.keys(schema.properties).some((key) => !field(key)))
|
|
80
|
+
return invalid("adapter option objects must enumerate and close their declared fields");
|
|
81
|
+
if (schema.required !== undefined && (!Array.isArray(schema.required) || schema.required.length > 128 || new Set(schema.required).size !== schema.required.length || schema.required.some((key) => typeof key !== "string" || !Object.hasOwn(schema.properties, key))))
|
|
82
|
+
return invalid("adapter required options must name unique declared fields");
|
|
83
|
+
for (const child of Object.values(schema.properties))
|
|
84
|
+
visit(child, depth + 1);
|
|
85
|
+
}
|
|
86
|
+
else if (type === "array") {
|
|
87
|
+
if (!Number.isSafeInteger(schema.maxItems) || Number(schema.maxItems) < 0 || Number(schema.maxItems) > 256)
|
|
88
|
+
return invalid("adapter option arrays require a maximum of at most 256 items");
|
|
89
|
+
visit(schema.items, depth + 1);
|
|
90
|
+
}
|
|
91
|
+
for (const key of ["minLength", "maxLength", "minItems", "maxItems", "maxProperties"])
|
|
92
|
+
if (schema[key] !== undefined && (!Number.isSafeInteger(schema[key]) || Number(schema[key]) < 0 || Number(schema[key]) > 8192))
|
|
93
|
+
return invalid("an adapter schema bound is invalid");
|
|
94
|
+
for (const key of ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum"])
|
|
95
|
+
if (schema[key] !== undefined && (typeof schema[key] !== "number" || !Number.isFinite(schema[key])))
|
|
96
|
+
return invalid("an adapter numeric bound is invalid");
|
|
97
|
+
const scalar = (value) => value === null || typeof value === "string" && value.length <= 8192 || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value);
|
|
98
|
+
if (Object.hasOwn(schema, "const") && !scalar(schema.const) || schema.enum !== undefined && (!Array.isArray(schema.enum) || !schema.enum.length || schema.enum.length > 256 || !schema.enum.every(scalar)))
|
|
99
|
+
return invalid("adapter option alternatives must be bounded scalar values");
|
|
100
|
+
};
|
|
101
|
+
visit(input.optionsSchema, 0);
|
|
102
|
+
if (input.optionsSchema.type !== "object")
|
|
103
|
+
return invalid("adapter options require a closed object schema");
|
|
104
|
+
if (input.paths !== undefined) {
|
|
105
|
+
const properties = input.optionsSchema.properties;
|
|
106
|
+
if (!plainObject(input.paths) || Object.keys(input.paths).length > 128 || Object.entries(input.paths).some(([key, kind]) => !Object.hasOwn(properties, key) || properties[key]?.type !== "string" || !["file", "directory", "private-file"].includes(String(kind))))
|
|
107
|
+
return invalid("adapter path declarations must name declared top-level string options and supported protections");
|
|
108
|
+
}
|
|
109
|
+
serviceMetadataDigest(input);
|
|
110
|
+
try {
|
|
111
|
+
new Ajv2020({ strict: true, ownProperties: true, validateFormats: false }).compile(input.optionsSchema);
|
|
112
|
+
}
|
|
113
|
+
catch {
|
|
114
|
+
return invalid("the declared adapter option schema is invalid; schema values were not printed");
|
|
115
|
+
}
|
|
116
|
+
return input;
|
|
117
|
+
}
|
|
118
|
+
export function validateServiceAdapterOptions(declaration, options) {
|
|
119
|
+
serviceAdapterDeclaration(declaration);
|
|
120
|
+
let check, valid;
|
|
121
|
+
try {
|
|
122
|
+
check = new Ajv2020({ strict: true, ownProperties: true, validateFormats: false }).compile(declaration.optionsSchema);
|
|
123
|
+
valid = check(options) === true;
|
|
124
|
+
}
|
|
125
|
+
catch {
|
|
126
|
+
return invalid("the adapter options could not be validated against its closed declaration");
|
|
127
|
+
}
|
|
128
|
+
if (!valid)
|
|
129
|
+
return invalid(`the service options do not match the installed adapter's closed schema${schemaErrorLocation(check.errors)}; option values were not printed`);
|
|
130
|
+
}
|
|
131
|
+
/** Public readiness evidence is closed and bound to a creation-pinned process. The installed
|
|
132
|
+
* adapter must itself correlate the native instance/lifecycle using its supported authority. */
|
|
133
|
+
export function serviceAdapterReadiness(input) {
|
|
134
|
+
if (!plainObject(input) || !["pending", "ready"].includes(String(input.state)) || Object.keys(input).some((key) => !(input.state === "pending" ? ["state"] : ["state", "process", "observedAt", "native", "evidence", "listener"]).includes(key)))
|
|
135
|
+
return invalid("the adapter returned an invalid readiness observation");
|
|
136
|
+
if (input.native !== undefined && input.listener !== undefined)
|
|
137
|
+
return invalid("an adapter readiness names either a native endpoint or a reported listener, never both");
|
|
138
|
+
if (input.evidence !== undefined && (input.evidence !== "local-process-receipt" || input.native === undefined))
|
|
139
|
+
return invalid("an adapter readiness evidence kind is unsupported or names no native endpoint");
|
|
140
|
+
if (input.listener !== undefined) {
|
|
141
|
+
const listener = input.listener;
|
|
142
|
+
if (!plainObject(listener) || Object.keys(listener).length !== 2 || listener.kind !== "nats-ports-file" || !Array.isArray(listener.nats) || listener.nats.length < 1 || listener.nats.length > 16 || !listener.nats.every((url) => typeof url === "string" && url.length <= 300 && /^(nats|tls):\/\/[^\s/?#@]+$/.test(url)))
|
|
143
|
+
return invalid("the adapter readiness has an invalid reported listener");
|
|
144
|
+
}
|
|
145
|
+
if (input.state === "pending")
|
|
146
|
+
return { state: "pending" };
|
|
147
|
+
const identity = input.process;
|
|
148
|
+
if (!plainObject(identity) || Object.keys(identity).length !== 2 || !Number.isSafeInteger(identity.pid) || Number(identity.pid) <= 0 || typeof identity.token !== "string" || !/^[0-9]+$/.test(identity.token) || typeof input.observedAt !== "string" || input.observedAt.length > 100 || !Number.isFinite(Date.parse(input.observedAt)))
|
|
149
|
+
return invalid("the adapter readiness has no bounded process identity and observation time");
|
|
150
|
+
if (input.native !== undefined) {
|
|
151
|
+
const native = input.native;
|
|
152
|
+
if (!plainObject(native) || Object.keys(native).length !== 6 || typeof native.endpoint !== "string" || native.endpoint.length > 200 || !["instanceId", "owner", "actor", "lifecycleUid"].every((key) => typeof native[key] === "string" && native[key].length > 0 && native[key].length <= 200 && token(native[key]) === native[key]) || !Number.isSafeInteger(native.epoch) || Number(native.epoch) < 0)
|
|
153
|
+
return invalid("the adapter readiness has invalid native lifecycle coordinates");
|
|
154
|
+
try {
|
|
155
|
+
endpointToken(native.endpoint);
|
|
156
|
+
}
|
|
157
|
+
catch {
|
|
158
|
+
return invalid("the adapter readiness has an invalid native endpoint class");
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
return input;
|
|
162
|
+
}
|
|
163
|
+
/** What a path's own metadata shows, for a refusal to carry: its type, owner and permission bits.
|
|
164
|
+
* It is read for the message only; the checks that call it make the decision. */
|
|
165
|
+
function pathFacts(path) {
|
|
166
|
+
let entry;
|
|
167
|
+
try {
|
|
168
|
+
entry = lstatSync(path);
|
|
169
|
+
}
|
|
170
|
+
catch {
|
|
171
|
+
return `${path} is missing or cannot be read`;
|
|
172
|
+
}
|
|
173
|
+
const type = entry.isSymbolicLink() ? "a symlink" : entry.isDirectory() ? "a directory" : entry.isFile() ? "a file" : "a special file";
|
|
174
|
+
const writable = (entry.mode & 0o022) !== 0 ? ", so group or others can write it" : "";
|
|
175
|
+
return `${path} is ${type} owned by uid ${entry.uid} with mode ${(entry.mode & 0o7777).toString(8).padStart(4, "0")}${writable}`;
|
|
176
|
+
}
|
|
177
|
+
/** The shallowest directory on `path`'s chain that {@link protectedLocalDirectory} refuses. The rule
|
|
178
|
+
* is applied from the filesystem root down instead of restated here. */
|
|
179
|
+
function refusedAncestor(path) {
|
|
180
|
+
const chain = [];
|
|
181
|
+
for (let dir = path;; dir = dirname(dir)) {
|
|
182
|
+
chain.unshift(dir);
|
|
183
|
+
if (dirname(dir) === dir)
|
|
184
|
+
break;
|
|
185
|
+
}
|
|
186
|
+
for (const dir of chain) {
|
|
187
|
+
try {
|
|
188
|
+
protectedLocalDirectory(dir);
|
|
189
|
+
}
|
|
190
|
+
catch {
|
|
191
|
+
return dir;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
return path;
|
|
195
|
+
}
|
|
196
|
+
/** Reference protection is checked without reading file contents or importing provider code. A
|
|
197
|
+
* refusal names the option, the path that failed and what that path's metadata shows. */
|
|
198
|
+
export function validateServiceAdapterPaths(declaration, options) {
|
|
199
|
+
for (const [name, kind] of Object.entries(declaration.paths ?? {})) {
|
|
200
|
+
const path = options[name];
|
|
201
|
+
if (path === undefined)
|
|
202
|
+
continue;
|
|
203
|
+
if (typeof path !== "string" || !isAbsolute(path) || /[\u0000-\u001f\u007f]/u.test(path))
|
|
204
|
+
return invalid(`the ${name} option must be an absolute path with no terminal controls`);
|
|
205
|
+
if (kind === "private-file") {
|
|
206
|
+
protectedCredentialReference(path);
|
|
207
|
+
continue;
|
|
208
|
+
}
|
|
209
|
+
const unprotected = (refused) => {
|
|
210
|
+
throw new CommandFailure("refused", "PERMISSION_DENIED", `the declared adapter path ${name} is not protected against other local writers: ${pathFacts(refused)}`, { target: { option: name, path, refused } });
|
|
211
|
+
};
|
|
212
|
+
try {
|
|
213
|
+
const parent = kind === "directory" ? path : dirname(path);
|
|
214
|
+
try {
|
|
215
|
+
protectedLocalDirectory(parent, "the declared adapter path");
|
|
216
|
+
}
|
|
217
|
+
catch (error) {
|
|
218
|
+
if (error instanceof CommandFailure && error.code === "PERMISSION_DENIED")
|
|
219
|
+
unprotected(refusedAncestor(parent));
|
|
220
|
+
throw error;
|
|
221
|
+
}
|
|
222
|
+
const entry = lstatSync(path);
|
|
223
|
+
if (entry.isSymbolicLink() || (kind === "directory" ? !entry.isDirectory() : !entry.isFile()))
|
|
224
|
+
throw new Error();
|
|
225
|
+
try {
|
|
226
|
+
assertProtectedEntry("the declared adapter path", path, entry);
|
|
227
|
+
}
|
|
228
|
+
catch (error) {
|
|
229
|
+
if (error instanceof CommandFailure && error.code === "PERMISSION_DENIED")
|
|
230
|
+
unprotected(path);
|
|
231
|
+
throw error;
|
|
232
|
+
}
|
|
233
|
+
accessSync(path, constants.R_OK | (kind === "directory" ? constants.X_OK : 0));
|
|
234
|
+
}
|
|
235
|
+
catch (error) {
|
|
236
|
+
if (error instanceof CommandFailure)
|
|
237
|
+
throw error;
|
|
238
|
+
throw new CommandFailure("refused", "DEPENDENCY_UNAVAILABLE", `the declared adapter path ${name} is missing, unreadable or not a physical ${kind === "directory" ? "directory" : "file"}: ${pathFacts(path)}; no contents were printed`, { target: { option: name, path } });
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
/** Full controller-assigned IDs only. These are local operation coordinates, not wire grants. */
|
|
243
|
+
export function serviceOperationId(value) {
|
|
244
|
+
if (typeof value !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(value))
|
|
245
|
+
throw new CommandFailure("refused", "USAGE_INVALID", "use the full controller-assigned service UUID, not a prefix or ordinal");
|
|
246
|
+
return value;
|
|
247
|
+
}
|
|
248
|
+
/** Closed public stop preview. It is observation data, never a reservation or native grant. */
|
|
249
|
+
export function serviceAdapterStopPlan(input, process) {
|
|
250
|
+
const optional = (plainObject(input) && input.evidence !== undefined ? 1 : 0) + (plainObject(input) && input.preserved !== undefined ? 1 : 0);
|
|
251
|
+
if (!plainObject(input) || Object.keys(input).length !== 5 + optional || Object.keys(input).some((key) => !["scopeSha256", "observedAt", "withAgents", "native", "evidence", "subjects", "preserved"].includes(key)) || typeof input.scopeSha256 !== "string" || !/^[0-9a-f]{64}$/.test(input.scopeSha256) || typeof input.withAgents !== "boolean" || !Array.isArray(input.subjects) || input.subjects.length > 4096)
|
|
252
|
+
return invalid("the native stop preview has an unsupported shape or incomplete bounded scope");
|
|
253
|
+
if (input.preserved !== undefined) {
|
|
254
|
+
const preserved = input.preserved;
|
|
255
|
+
if (input.withAgents !== false || !plainObject(preserved) || Object.keys(preserved).length !== 2 || typeof preserved.attemptId !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/.test(preserved.attemptId) || !sha256Hex(preserved.inventorySha256))
|
|
256
|
+
return invalid("the preserved-exit stop preview binding is invalid or combined with an agent policy");
|
|
257
|
+
}
|
|
258
|
+
serviceAdapterReadiness({ state: "ready", process, observedAt: input.observedAt, native: input.native, ...(input.evidence === undefined ? {} : { evidence: input.evidence }) });
|
|
259
|
+
if (input.native === undefined)
|
|
260
|
+
return invalid("the native stop preview has no attributed lifecycle");
|
|
261
|
+
for (const row of input.subjects) {
|
|
262
|
+
if (!plainObject(row) || Object.keys(row).length !== 4 || Object.keys(row).some((key) => !["name", "id", "lifecycleUid", "action"].includes(key)) || !["name", "id", "lifecycleUid"].every((key) => typeof row[key] === "string" && row[key].length > 0 && row[key].length <= 200 && !/[\u0000-\u001f\u007f]/u.test(row[key])) || !["stop", "release-custody", "stop-retaining-state"].includes(String(row.action)))
|
|
263
|
+
return invalid("the native stop preview has an invalid affected subject; no row was silently omitted");
|
|
264
|
+
}
|
|
265
|
+
serviceMetadataDigest(input);
|
|
266
|
+
return input;
|
|
267
|
+
}
|
|
268
|
+
const sha256Hex = (value) => typeof value === "string" && /^[0-9a-f]{64}$/.test(value);
|
|
269
|
+
/** Closed kernel-exit preview. A broker binding carries no fabricated endpoint identity. */
|
|
270
|
+
export function serviceAdapterKernelStopPlan(input) {
|
|
271
|
+
if (!plainObject(input) || Object.keys(input).length !== 4 || input.kind !== "kernel-exit" || !sha256Hex(input.scopeSha256) || typeof input.observedAt !== "string" || input.observedAt.length > 100 || !Number.isFinite(Date.parse(input.observedAt)))
|
|
272
|
+
return invalid("the kernel-exit stop preview has an unsupported shape");
|
|
273
|
+
const binding = input.binding;
|
|
274
|
+
if (!plainObject(binding) || Object.keys(binding).length !== 5 || binding.kind !== "nats-broker" || !["root", "space", "server"].every((key) => typeof binding[key] === "string" && binding[key].length > 0 && binding[key].length <= 4096 && !/[\u0000-\u001f\u007f]/u.test(binding[key])) || !isAbsolute(binding.root) || !sha256Hex(binding.configSha256))
|
|
275
|
+
return invalid("the kernel-exit stop preview has an invalid broker binding");
|
|
276
|
+
serviceMetadataDigest(input);
|
|
277
|
+
return input;
|
|
278
|
+
}
|
|
279
|
+
/** Closed kernel-exit receipt: observed exact process exit, never a broker acknowledgement. */
|
|
280
|
+
export function serviceAdapterKernelStopResult(input) {
|
|
281
|
+
if (!plainObject(input) || Object.keys(input).length !== 8 || input.kind !== "kernel-exit" || !sha256Hex(input.scopeSha256) || input.observation !== "exact-process-exit" || !["ports-file-removed", "ports-file-retained"].includes(String(input.brokerShutdownTrace)) || input.cleanup !== "not-checked")
|
|
282
|
+
return invalid("the kernel-exit stop did not return its closed exact-exit receipt");
|
|
283
|
+
serviceOperationId(input.requestId);
|
|
284
|
+
serviceAdapterReadiness({ state: "ready", process: input.process, observedAt: input.observedAt });
|
|
285
|
+
return input;
|
|
286
|
+
}
|
|
287
|
+
export function serviceAdapterStopResult(input) {
|
|
288
|
+
if (!plainObject(input) || Object.keys(input).length !== 6 || Object.keys(input).some((key) => !["requestId", "scopeSha256", "process", "nativeStop", "cleanup", "observedAt"].includes(key)) || typeof input.scopeSha256 !== "string" || !/^[0-9a-f]{64}$/.test(input.scopeSha256) || !["returned", "preserved-exit-returned"].includes(String(input.nativeStop)) || input.cleanup !== "not-checked")
|
|
289
|
+
return invalid("the native stop did not return its request-bound terminal receipt");
|
|
290
|
+
serviceOperationId(input.requestId);
|
|
291
|
+
serviceAdapterReadiness({ state: "ready", process: input.process, observedAt: input.observedAt });
|
|
292
|
+
return input;
|
|
293
|
+
}
|
|
294
|
+
//# sourceMappingURL=service-adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-adapter.js","sourceRoot":"","sources":["../src/service-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,EAAyB,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAA+B,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AA0JrH,MAAM,OAAO,GAAG,CAAC,OAAe,EAAS,EAAE,GAAG,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAChH,MAAM,WAAW,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClN,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAEzI;mGACmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,OAAmD;IACvG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB;QAAE,OAAO,OAAO,CAAC,8DAA8D,CAAC,CAAC;IACrO,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC,mDAAmD,CAAC,CAAC;IAC3K,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,2CAA2C,CAAC,CAAC;IAC3M,IAAI,YAAmD,CAAC;IACxD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,OAAO,CAAC,qDAAqD,CAAC,CAAC;QAC5V,YAAY,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAClM,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,KAAa,EAAW,EAAE;QAC3D,IAAI,EAAE,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,EAAE;YAAE,OAAO,OAAO,CAAC,+CAA+C,CAAC,CAAC;QACnG,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnJ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,uDAAuD,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,OAAO,CAAC,gCAAgC,CAAC,CAAC;IACpG,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;gGACgG;AAChG,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,kFAAkF,CAAC,CAAC;IACjX,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC,yGAAyG,CAAC,CAAC;IACnN,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;QAAE,OAAO,OAAO,CAAC,iGAAiG,CAAC,CAAC;IAC3L,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,6CAA6C,CAAC,CAAC;IACjI,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC,6EAA6E,CAAC,CAAC;IAC3Q,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,KAAK,GAAG,CAAC,MAAe,EAAE,KAAa,EAAQ,EAAE;QACrD,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAAE,OAAO,OAAO,CAAC,0DAA0D,CAAC,CAAC;QACrI,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,eAAe,CAAC;YACtG,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC;gBACtD,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC;oBAChD,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClH,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC,+DAA+D,CAAC,CAAC;QAC1Q,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;YAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC;gBAAE,OAAO,OAAO,CAAC,iDAAiD,CAAC,CAAC;QAC/M,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC,uEAAuE,CAAC,CAAC;YAClR,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAoB,EAAE,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC,2DAA2D,CAAC,CAAC;YAC9V,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG;gBAAE,OAAO,OAAO,CAAC,8DAA8D,CAAC,CAAC;YAC3L,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,CAAC;YAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;gBAAE,OAAO,OAAO,CAAC,oCAAoC,CAAC,CAAC;QAC5Q,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,CAAC;YAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,OAAO,CAAC,qCAAqC,CAAC,CAAC;QAC7O,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5L,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC,2DAA2D,CAAC,CAAC;IAC1R,CAAC,CAAC;IACF,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IAC9B,IAAK,KAAK,CAAC,aAAyC,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,gDAAgD,CAAC,CAAC;IACzI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAI,KAAK,CAAC,aAAyE,CAAC,UAAU,CAAC;QAC/G,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC,iGAAiG,CAAC,CAAC;IACzX,CAAC;IACD,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC;QAAC,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAuB,CAAC,CAAC;IAAC,CAAC;IAC1H,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC,+EAA+E,CAAC,CAAC;IAAC,CAAC;IAC1G,OAAO,KAA6C,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,WAAsC,EAAE,OAA0C;IAC9H,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,KAAuB,EAAE,KAAc,CAAC;IAC5C,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,CAAC;IAC/J,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC,2EAA2E,CAAC,CAAC;IAAC,CAAC;IACtG,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,yEAAyE,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAC3K,CAAC;AAED;iGACiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,uDAAuD,CAAC,CAAC;IAC3T,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,wFAAwF,CAAC,CAAC;IACzK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,uBAAuB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC,+EAA+E,CAAC,CAAC;IAChN,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC,wDAAwD,CAAC,CAAC;IACxY,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,4EAA4E,CAAC,CAAC;IACxa,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,gEAAgE,CAAC,CAAC;QAC3d,IAAI,CAAC;YAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,OAAO,CAAC,4DAA4D,CAAC,CAAC;QAAC,CAAC;IACjI,CAAC;IACD,OAAO,KAA2C,CAAC;AACrD,CAAC;AAED;kFACkF;AAClF,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,KAAY,CAAC;IACjB,IAAI,CAAC;QAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,IAAI,+BAA+B,CAAC;IAAC,CAAC;IACzF,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC;IACvI,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,OAAO,GAAG,IAAI,OAAO,IAAI,iBAAiB,KAAK,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC;AACnI,CAAC;AAED;yEACyE;AACzE,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,GAAG,GAAG,IAAI,GAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG;YAAE,MAAM;IAClC,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC;YAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,GAAG,CAAC;QAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;0FAC0F;AAC1F,MAAM,UAAU,2BAA2B,CAAC,WAAsC,EAAE,OAA0C;IAC5H,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,IAAI,4DAA4D,CAAC,CAAC;QAClL,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,CAAC,OAAe,EAAS,EAAE;YAC7C,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,6BAA6B,IAAI,kDAAkD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACjN,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC;gBAAC,uBAAuB,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;YAAC,CAAC;YACrE,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB;oBAAE,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;gBAAC,MAAM,KAAK,CAAC;YAAC,CAAC;YAC/I,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,EAAE,CAAC;YACjH,IAAI,CAAC;gBAAC,oBAAoB,CAAC,2BAA2B,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;YACvE,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB;oBAAE,WAAW,CAAC,IAAI,CAAC,CAAC;gBAAC,MAAM,KAAK,CAAC;YAAC,CAAC;YAC5H,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,KAAK,CAAC;YACjD,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,wBAAwB,EAAE,6BAA6B,IAAI,6CAA6C,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/Q,CAAC;IACH,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,uEAAuE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,wEAAwE,CAAC,CAAC;IACtP,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,OAA8B;IACnF,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9I,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI;QAAE,OAAO,OAAO,CAAC,8EAA8E,CAAC,CAAC;IACtf,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,eAAe,CAAC;YAAE,OAAO,OAAO,CAAC,qFAAqF,CAAC,CAAC;IAChW,CAAC;IACD,uBAAuB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAChL,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,qDAAqD,CAAC,CAAC;IACtG,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAAE,OAAO,OAAO,CAAC,sFAAsF,CAAC,CAAC;IAC9f,CAAC;IACD,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAA0C,CAAC;AACpD,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAEjH,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,uDAAuD,CAAC,CAAC;IAChU,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAK,OAAO,CAAC,GAAG,CAAY,CAAC,MAAM,GAAG,CAAC,IAAK,OAAO,CAAC,GAAG,CAAY,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAc,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,OAAO,CAAC,4DAA4D,CAAC,CAAC;IACvd,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,KAAgD,CAAC;AAC1D,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,oBAAoB,IAAI,CAAC,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC,mEAAmE,CAAC,CAAC;IAChY,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,uBAAuB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAClG,OAAO,KAAkD,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC,mEAAmE,CAAC,CAAC;IAC3d,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,uBAAuB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAClG,OAAO,KAA4C,CAAC;AACtD,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import { type LocalProcessContext } from "./local-process.js";
|
|
2
|
+
/** Native child custody, not a launcher placeholder or adoption. Every existing slot refuses;
|
|
3
|
+
* this path never reclaims legacy records. Native initialization follows only after the claim. */
|
|
4
|
+
export declare function claimServicePid(context: LocalProcessContext, template: string): () => void;
|
|
5
|
+
//# sourceMappingURL=service-custody.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-custody.d.ts","sourceRoot":"","sources":["../src/service-custody.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKzF;mGACmG;AACnG,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,IAAI,CAsB1F"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { dirname } from "node:path";
|
|
2
|
+
import { writeSecretFileCreateOnly } from "@cotal-ai/core";
|
|
3
|
+
import { canonicalLocalProcessPath } from "./local-process.js";
|
|
4
|
+
import { CommandFailure } from "./output.js";
|
|
5
|
+
import { identityRecord, removePidPair, verifyIdentityPin, writePidPair } from "./pid.js";
|
|
6
|
+
import { protectedLocalDirectory, readLocalRecordSource } from "./protected-records.js";
|
|
7
|
+
/** Native child custody, not a launcher placeholder or adoption. Every existing slot refuses;
|
|
8
|
+
* this path never reclaims legacy records. Native initialization follows only after the claim. */
|
|
9
|
+
export function claimServicePid(context, template) {
|
|
10
|
+
const self = identityRecord(process.pid);
|
|
11
|
+
if (process.platform !== "linux" || !("token" in self))
|
|
12
|
+
throw new CommandFailure("refused", "UNSUPPORTED", "native service custody requires a Linux process creation identity; no PID-only record was published");
|
|
13
|
+
const path = canonicalLocalProcessPath(template, context);
|
|
14
|
+
protectedLocalDirectory(dirname(path));
|
|
15
|
+
try {
|
|
16
|
+
writeSecretFileCreateOnly(path, String(self.pid));
|
|
17
|
+
}
|
|
18
|
+
catch (error) {
|
|
19
|
+
if (error.code === "EEXIST")
|
|
20
|
+
throw new CommandFailure("refused", "LIFECYCLE_BLOCKED", "the native service PID slot is already held; no daemon or legacy record was adopted or reclaimed");
|
|
21
|
+
throw new CommandFailure("unknown", "OPERATION_UNKNOWN", "native service custody publication was not confirmed; any original claim was retained");
|
|
22
|
+
}
|
|
23
|
+
// Reuse the native pair publisher, which creates both records 0o600. An incomplete publication
|
|
24
|
+
// stays as custody evidence.
|
|
25
|
+
try {
|
|
26
|
+
writePidPair(path, self.pid);
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
throw new CommandFailure("unknown", "OPERATION_UNKNOWN", "native service PID/pin publication was not confirmed; its claim was retained, without native initialization");
|
|
30
|
+
}
|
|
31
|
+
return () => {
|
|
32
|
+
const bytes = readLocalRecordSource(path, 128, true);
|
|
33
|
+
if (bytes === undefined)
|
|
34
|
+
return;
|
|
35
|
+
const current = verifyIdentityPin(path);
|
|
36
|
+
if (current.kind !== "match" || current.record.pid !== self.pid || current.record.token !== self.token)
|
|
37
|
+
throw new CommandFailure("unknown", "OPERATION_UNKNOWN", "the native service PID custody changed; no successor record was removed");
|
|
38
|
+
removePidPair(path, String(self.pid));
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=service-custody.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-custody.js","sourceRoot":"","sources":["../src/service-custody.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAA4B,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAExF;mGACmG;AACnG,MAAM,UAAU,eAAe,CAAC,OAA4B,EAAE,QAAgB;IAC5E,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,qGAAqG,CAAC,CAAC;IAClN,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC;QAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAAC,CAAC;IAC1D,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,kGAAkG,CAAC,CAAC;QACrN,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,uFAAuF,CAAC,CAAC;IACpJ,CAAC;IACD,+FAA+F;IAC/F,6BAA6B;IAC7B,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,6GAA6G,CAAC,CAAC;IAAC,CAAC;IACpL,OAAO,GAAG,EAAE;QACV,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,mBAAmB,EAAE,yEAAyE,CAAC,CAAC;QAC5O,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/** The imported local definition, before files, references and an adapter are resolved. Parsing
|
|
2
|
+
* authorizes no launch and opens no referenced path. The controller must check those separately. */
|
|
3
|
+
export interface ServiceDefinitionInput {
|
|
4
|
+
readonly schemaVersion: 1;
|
|
5
|
+
readonly space: string;
|
|
6
|
+
readonly launch: {
|
|
7
|
+
readonly type: "process";
|
|
8
|
+
readonly executable: string;
|
|
9
|
+
readonly args: readonly string[];
|
|
10
|
+
readonly cwd: string;
|
|
11
|
+
} | {
|
|
12
|
+
readonly type: "adapter";
|
|
13
|
+
readonly adapter: string;
|
|
14
|
+
readonly options: Readonly<Record<string, unknown>>;
|
|
15
|
+
};
|
|
16
|
+
readonly readiness: {
|
|
17
|
+
readonly type: "process";
|
|
18
|
+
readonly timeoutMs: number;
|
|
19
|
+
} | {
|
|
20
|
+
readonly type: "http";
|
|
21
|
+
readonly url: string;
|
|
22
|
+
readonly expectedStatus: number;
|
|
23
|
+
readonly timeoutMs: number;
|
|
24
|
+
} | {
|
|
25
|
+
readonly type: "adapter";
|
|
26
|
+
readonly timeoutMs: number;
|
|
27
|
+
};
|
|
28
|
+
readonly envRefs?: Readonly<Record<string, string>>;
|
|
29
|
+
readonly credentialRef?: {
|
|
30
|
+
readonly kind: "file";
|
|
31
|
+
readonly path: string;
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
/** Byte cap applied to JSON content. A file reader must impose the same cap while reading, before
|
|
35
|
+
* handing this parser a string, and independently verify the opened file's identity and access. */
|
|
36
|
+
export declare const MAX_SERVICE_DEFINITION_BYTES: number;
|
|
37
|
+
/** Where a closed-schema validator stopped, from its last error, as ` at <field path>` and what is
|
|
38
|
+
* wrong there. Each segment is printed only when it is a plain identifier or an index, so an
|
|
39
|
+
* arbitrary user-controlled property name never reaches a message. Empty when it cannot say. */
|
|
40
|
+
export declare function schemaErrorLocation(errors: readonly {
|
|
41
|
+
keyword: string;
|
|
42
|
+
instancePath: string;
|
|
43
|
+
params: Record<string, unknown>;
|
|
44
|
+
}[] | null | undefined): string;
|
|
45
|
+
/** Check a case-sensitive definition name before deriving its case-safe storage key. */
|
|
46
|
+
export declare function serviceDefinitionName(value: string): string;
|
|
47
|
+
/** Parse capped version-1 JSON and check local syntax against the explicitly selected space.
|
|
48
|
+
* This does not validate reference ownership, path existence, installed adapter support/options
|
|
49
|
+
* or readiness identity. The service controller must resolve them before writing or importing
|
|
50
|
+
* provider code. No schema is fetched and no host environment value is read here. */
|
|
51
|
+
export declare function parseServiceDefinitionInput(raw: string, selectedSpace: string): ServiceDefinitionInput;
|
|
52
|
+
//# sourceMappingURL=service-definition.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-definition.d.ts","sourceRoot":"","sources":["../src/service-definition.ts"],"names":[],"mappings":"AAKA;qGACqG;AACrG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EACX;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GACjH;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;IAChH,QAAQ,CAAC,SAAS,EACd;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GACxD;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC5G;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E;AAED;oGACoG;AACpG,eAAO,MAAM,4BAA4B,QAAa,CAAC;AAcvD;;iGAEiG;AACjG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQ5J;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;sFAGsF;AACtF,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,sBAAsB,CA4BtG"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import { isAbsolute } from "node:path";
|
|
2
|
+
import { Ajv2020 } from "ajv/dist/2020.js";
|
|
3
|
+
import { token } from "@cotal-ai/core";
|
|
4
|
+
import schema from "./service-definition.schema.json" with { type: "json" };
|
|
5
|
+
/** Byte cap applied to JSON content. A file reader must impose the same cap while reading, before
|
|
6
|
+
* handing this parser a string, and independently verify the opened file's identity and access. */
|
|
7
|
+
export const MAX_SERVICE_DEFINITION_BYTES = 256 * 1024;
|
|
8
|
+
// This workstation input is not a wire contract. Its fixed local schema uses conditionals and
|
|
9
|
+
// protected-name expressions; do not broaden the core wire profile to compile it.
|
|
10
|
+
let validate;
|
|
11
|
+
function definitionValidator() {
|
|
12
|
+
return validate ??= new Ajv2020({
|
|
13
|
+
strict: false, allErrors: false, ownProperties: true, validateFormats: false,
|
|
14
|
+
}).compile(schema);
|
|
15
|
+
}
|
|
16
|
+
const refuse = (message) => { throw new Error(`service definition: ${message}`); };
|
|
17
|
+
const nativeString = (value) => !/[\u0000-\u001f\u007f]/u.test(value);
|
|
18
|
+
/** Where a closed-schema validator stopped, from its last error, as ` at <field path>` and what is
|
|
19
|
+
* wrong there. Each segment is printed only when it is a plain identifier or an index, so an
|
|
20
|
+
* arbitrary user-controlled property name never reaches a message. Empty when it cannot say. */
|
|
21
|
+
export function schemaErrorLocation(errors) {
|
|
22
|
+
const last = errors?.at(-1);
|
|
23
|
+
if (!last)
|
|
24
|
+
return "";
|
|
25
|
+
const field = last.keyword === "additionalProperties" ? last.params.additionalProperty : last.keyword === "required" ? last.params.missingProperty : undefined;
|
|
26
|
+
const parts = [...last.instancePath.split("/").filter(Boolean), ...(field === undefined ? [] : [String(field)])];
|
|
27
|
+
if (!parts.length || parts.some((part) => !/^(?:[A-Za-z_][A-Za-z0-9_-]{0,63}|[0-9]{1,4})$/.test(part)))
|
|
28
|
+
return "";
|
|
29
|
+
const at = parts.join(".");
|
|
30
|
+
return last.keyword === "additionalProperties" ? ` at ${at}, which the schema does not declare` : last.keyword === "required" ? ` at ${at}, which is required` : ` at ${at}`;
|
|
31
|
+
}
|
|
32
|
+
/** Check a case-sensitive definition name before deriving its case-safe storage key. */
|
|
33
|
+
export function serviceDefinitionName(value) {
|
|
34
|
+
if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(value))
|
|
35
|
+
return refuse("the name must be 1 to 64 letters, digits, underscores or hyphens, starting with a letter or digit");
|
|
36
|
+
return value;
|
|
37
|
+
}
|
|
38
|
+
/** Parse capped version-1 JSON and check local syntax against the explicitly selected space.
|
|
39
|
+
* This does not validate reference ownership, path existence, installed adapter support/options
|
|
40
|
+
* or readiness identity. The service controller must resolve them before writing or importing
|
|
41
|
+
* provider code. No schema is fetched and no host environment value is read here. */
|
|
42
|
+
export function parseServiceDefinitionInput(raw, selectedSpace) {
|
|
43
|
+
if (typeof raw !== "string" || Buffer.byteLength(raw, "utf8") > MAX_SERVICE_DEFINITION_BYTES)
|
|
44
|
+
return refuse("JSON content exceeds 256 KiB");
|
|
45
|
+
if (typeof selectedSpace !== "string" || !selectedSpace || selectedSpace.length > 200 || token(selectedSpace) !== selectedSpace)
|
|
46
|
+
return refuse("select a space whose name is a native routing token");
|
|
47
|
+
let input;
|
|
48
|
+
try {
|
|
49
|
+
input = JSON.parse(raw);
|
|
50
|
+
}
|
|
51
|
+
catch {
|
|
52
|
+
return refuse("input is not JSON");
|
|
53
|
+
}
|
|
54
|
+
// Validator details can contain user-controlled property names. Never publish the raw input or
|
|
55
|
+
// the validator's mutable error array as a diagnostic; only an identifier-shaped location.
|
|
56
|
+
const validator = definitionValidator();
|
|
57
|
+
if (!validator(input))
|
|
58
|
+
return refuse(`input does not match the version-1 definition schema${schemaErrorLocation(validator.errors)}`);
|
|
59
|
+
if (input.space !== selectedSpace)
|
|
60
|
+
return refuse(`the definition names ${token(input.space) === input.space ? `space "${input.space}"` : "another space"}, and the selected space is "${selectedSpace}"`);
|
|
61
|
+
if (input.launch.type === "process") {
|
|
62
|
+
if (!nativeString(input.launch.executable) || !nativeString(input.launch.cwd) || input.launch.args.some((arg) => arg.includes("\0")))
|
|
63
|
+
return refuse("process arguments or paths contain unsupported control characters");
|
|
64
|
+
if (!isAbsolute(input.launch.cwd))
|
|
65
|
+
return refuse("the process working directory must be absolute");
|
|
66
|
+
}
|
|
67
|
+
else if (!nativeString(input.launch.adapter)) {
|
|
68
|
+
return refuse("the adapter name contains unsupported control characters");
|
|
69
|
+
}
|
|
70
|
+
if (input.credentialRef && (!isAbsolute(input.credentialRef.path) || !nativeString(input.credentialRef.path)))
|
|
71
|
+
return refuse("the credential reference must name an absolute local path");
|
|
72
|
+
if (input.readiness.type === "http") {
|
|
73
|
+
let url;
|
|
74
|
+
try {
|
|
75
|
+
url = new URL(input.readiness.url);
|
|
76
|
+
}
|
|
77
|
+
catch {
|
|
78
|
+
return refuse("the HTTP readiness URL is invalid");
|
|
79
|
+
}
|
|
80
|
+
if (url.protocol !== "http:" || !["127.0.0.1", "[::1]"].includes(url.hostname) || url.username || url.password || url.port === "0")
|
|
81
|
+
return refuse("HTTP readiness requires a literal loopback HTTP URL and a valid nonzero port");
|
|
82
|
+
}
|
|
83
|
+
return input;
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=service-definition.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-definition.js","sourceRoot":"","sources":["../src/service-definition.ts"],"names":[],"mappings":"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"}
|