unreal-engine-mcp-server 0.5.21 → 0.6.0-a

package/dist/tools/catalog/capabilities/semantic/errors.js

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+import { CapabilityIdSchema } from '../identifiers.js';
+import { CorrelationIdSchema } from './ids.js';
+import { JsonValueSchema } from './property-assignment.js';
+export const SemanticErrorSchema = z.discriminatedUnion('kind', [
+    z
+        .strictObject({
+        kind: z.literal('validation'),
+        code: z.literal('VALIDATION_ERROR'),
+        message: z.string(),
+        pointer: z.string().optional(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('path'),
+        code: z.literal('INVALID_PATH_ROOT').or(z.literal('PATH_TRAVERSAL')),
+        message: z.string(),
+        input: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('option'),
+        code: z.literal('UNSUPPORTED_OPTION'),
+        option: z.string(),
+        supported: z.array(z.string()).readonly(),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('handle'),
+        code: z.literal('HANDLE_KIND_MISMATCH'),
+        expected: z.string(),
+        received: z.string(),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('range'),
+        code: z.literal('OUT_OF_RANGE').or(z.literal('WRONG_UNIT')),
+        field: z.string(),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('timeout'),
+        code: z.literal('TIMEOUT_EXCEEDED'),
+        message: z.string(),
+        boundMs: z.number(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('execution'),
+        code: z
+            .literal('EXECUTION_ERROR')
+            .or(z.literal('CONNECTION_ERROR'))
+            .or(z.literal('UNREAL_ENGINE_ERROR')),
+        message: z.string(),
+        retryable: z.boolean(),
+        handlerCode: z.string().regex(/^[A-Z][A-Z0-9_]{0,63}$/).optional(),
+        correlationId: CorrelationIdSchema.optional(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('capability'),
+        code: z.literal('CAPABILITY_DISABLED').or(z.literal('CAPABILITY_UNAVAILABLE')),
+        message: z.string(),
+        retryable: z.boolean(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('consent'),
+        code: z.literal('CONSENT_REQUIRED'),
+        message: z.string(),
+        scope: z.string().min(1).max(64),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('staleState'),
+        code: z.literal('STALE_STATE'),
+        message: z.string(),
+        currentRevision: z.string().min(1).max(128),
+        expectedRevision: z.string().min(1).max(128),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('conflict'),
+        code: z.literal('STATE_CONFLICT').or(z.literal('IDEMPOTENCY_CONFLICT')),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('cancellation'),
+        code: z.literal('OPERATION_CANCELLED'),
+        message: z.string()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('dispatch'),
+        code: z.literal('NOT_CONNECTED').or(z.literal('DISPATCH_ERROR')),
+        message: z.string(),
+        retryable: z.boolean(),
+        correlationId: CorrelationIdSchema.optional(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('output'),
+        code: z.literal('OUTPUT_SCHEMA_VIOLATION').or(z.literal('RESULT_TOO_LARGE')),
+        message: z.string(),
+        pointer: z.string().optional(),
+        resultChars: z.number().optional(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('authorization'),
+        code: z.literal('SCOPE_NOT_GRANTED'),
+        message: z.string(),
+        requiredScope: z.string().min(1).max(32),
+        grantedScopes: z.array(z.string()).readonly(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('project'),
+        code: z.literal('PROJECT_NOT_PERMITTED'),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('pathPolicy'),
+        code: z.literal('PATH_NOT_PERMITTED'),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('quota'),
+        code: z.literal('QUOTA_EXCEEDED'),
+        message: z.string(),
+        retryable: z.boolean(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('command'),
+        code: z.literal('COMMAND_BLOCKED'),
+        message: z.string(),
+        suggestions: z.array(z.string()).readonly().optional()
+    })
+        .readonly(),
+    z
+        .strictObject({
+        kind: z.literal('unknown'),
+        code: z.literal('UNKNOWN_ERROR'),
+        message: z.string()
+    })
+        .readonly()
+]);
+export class SemanticBoundaryError extends Error {
+    semanticError;
+    constructor(semanticError) {
+        super(semanticError.message);
+        this.name = 'SemanticBoundaryError';
+        this.semanticError = semanticError;
+    }
+}
+export function assertNever(x) {
+    throw new Error(`Unexpected semantic value: ${JSON.stringify(x)}`);
+}
+export const TaskStatusSchema = z
+    .strictObject({
+    taskId: z.string().min(1),
+    state: z.enum(['queued', 'running', 'completed', 'failed', 'cancelled']),
+    progress: z.number().min(0).max(1).optional()
+})
+    .readonly();
+export const NextCallSchema = z
+    .strictObject({
+    operation: z.enum(['search', 'describe', 'execute', 'configure']),
+    capability: CapabilityIdSchema.optional(),
+    params: JsonValueSchema.optional()
+})
+    .readonly();
+//# sourceMappingURL=errors.js.map

package/dist/tools/catalog/capabilities/semantic/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/errors.ts"],"names":[],"mappings":"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"}

package/dist/tools/catalog/capabilities/semantic/execution-options.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export declare const EXECUTION_OPTION_KEYS: readonly ["idempotencyKey", "expectedCatalogRevision", "expectedRevisions", "preview", "savePolicy", "timeoutMs", "validationLevel", "taskPreference"];
+export type ExecutionOptionKey = (typeof EXECUTION_OPTION_KEYS)[number];
+export declare const ValidationLevelSchema: z.ZodEnum<{
+    none: "none";
+    strict: "strict";
+    lenient: "lenient";
+}>;
+export declare const TaskPreferenceSchema: z.ZodEnum<{
+    queued: "queued";
+    foreground: "foreground";
+    background: "background";
+}>;
+export declare const LIVE_STATE_REVISION_KEYS: readonly ["selection", "level", "assetRegistry", "package"];
+export declare const ExpectedRevisionsSchema: z.ZodReadonly<z.ZodObject<{
+    selection: z.ZodOptional<z.ZodNumber>;
+    level: z.ZodOptional<z.ZodNumber>;
+    assetRegistry: z.ZodOptional<z.ZodNumber>;
+    package: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>;
+export type ExpectedRevisions = z.infer<typeof ExpectedRevisionsSchema>;
+export declare const ExecutionOptionsSchema: z.ZodReadonly<z.ZodObject<{
+    idempotencyKey: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "IdempotencyKey", "out">>;
+    expectedCatalogRevision: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "CatalogRevision", "out">>;
+    expectedRevisions: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        selection: z.ZodOptional<z.ZodNumber>;
+        level: z.ZodOptional<z.ZodNumber>;
+        assetRegistry: z.ZodOptional<z.ZodNumber>;
+        package: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    preview: z.ZodOptional<z.ZodBoolean>;
+    savePolicy: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        immediate: "immediate";
+        deferred: "deferred";
+        user_prompt: "user_prompt";
+    }>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    validationLevel: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        strict: "strict";
+        lenient: "lenient";
+    }>>;
+    taskPreference: z.ZodOptional<z.ZodEnum<{
+        queued: "queued";
+        foreground: "foreground";
+        background: "background";
+    }>>;
+}, z.core.$strict>>;
+export type ExecutionOptions = z.infer<typeof ExecutionOptionsSchema>;
+export declare function parseExecutionOptions(raw: unknown, supported: readonly ExecutionOptionKey[]): ExecutionOptions;
+export declare function rejectGatewayControlsInParams(params: Record<string, unknown>, controlKeys: readonly string[]): void;
+//# sourceMappingURL=execution-options.d.ts.map

package/dist/tools/catalog/capabilities/semantic/execution-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-options.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/execution-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,qBAAqB,wJASxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;EAAwC,CAAC;AAE3E,eAAO,MAAM,oBAAoB;;;;EAAiD,CAAC;AAOnF,eAAO,MAAM,wBAAwB,6DAK3B,CAAC;AAKX,eAAO,MAAM,uBAAuB;;;;;mBAKvB,CAAC;AAEd,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAaxE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAAmD,CAAC;AACvF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,kBAAkB,EAAE,GACvC,gBAAgB,CAuBlB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,IAAI,CAaN"}

package/dist/tools/catalog/capabilities/semantic/execution-options.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { isRecord } from '../../../../utils/validation/type-guards.js';
+import { SemanticBoundaryError } from './errors.js';
+import { CatalogRevisionSchema, IdempotencyKeySchema } from './ids.js';
+import { SavePolicySchema } from './save-policy.js';
+export const EXECUTION_OPTION_KEYS = [
+    'idempotencyKey',
+    'expectedCatalogRevision',
+    'expectedRevisions',
+    'preview',
+    'savePolicy',
+    'timeoutMs',
+    'validationLevel',
+    'taskPreference'
+];
+export const ValidationLevelSchema = z.enum(['strict', 'lenient', 'none']);
+export const TaskPreferenceSchema = z.enum(['foreground', 'background', 'queued']);
+const MAX_TIMEOUT_MS = 600_000;
+export const LIVE_STATE_REVISION_KEYS = [
+    'selection',
+    'level',
+    'assetRegistry',
+    'package'
+];
+export const ExpectedRevisionsSchema = z.strictObject({
+    selection: z.number().int().min(1).optional(),
+    level: z.number().int().min(1).optional(),
+    assetRegistry: z.number().int().min(1).optional(),
+    package: z.number().int().min(1).optional()
+}).readonly();
+const ExecutionOptionsShape = {
+    idempotencyKey: IdempotencyKeySchema.optional(),
+    expectedCatalogRevision: CatalogRevisionSchema.optional(),
+    expectedRevisions: ExpectedRevisionsSchema.optional(),
+    preview: z.boolean().optional(),
+    savePolicy: SavePolicySchema.optional(),
+    timeoutMs: z.number().int().positive().max(MAX_TIMEOUT_MS).optional(),
+    validationLevel: ValidationLevelSchema.optional(),
+    taskPreference: TaskPreferenceSchema.optional()
+};
+export const ExecutionOptionsSchema = z.strictObject(ExecutionOptionsShape).readonly();
+export function parseExecutionOptions(raw, supported) {
+    if (raw === undefined || raw === null)
+        return {};
+    if (!isRecord(raw)) {
+        throw new SemanticBoundaryError({
+            kind: 'validation',
+            code: 'VALIDATION_ERROR',
+            message: 'Execution options must be an object'
+        });
+    }
+    const supportedSet = new Set(supported);
+    for (const key of Object.keys(raw)) {
+        if (!supportedSet.has(key)) {
+            const semanticError = {
+                kind: 'option',
+                code: 'UNSUPPORTED_OPTION',
+                option: key,
+                supported: [...supported],
+                message: `Unsupported execution option '${key}'. Supported: [${supported.join(', ')}]`
+            };
+            throw new SemanticBoundaryError(semanticError);
+        }
+    }
+    return ExecutionOptionsSchema.parse(raw);
+}
+export function rejectGatewayControlsInParams(params, controlKeys) {
+    const controlSet = new Set(controlKeys);
+    for (const key of Object.keys(params)) {
+        if (controlSet.has(key)) {
+            throw new SemanticBoundaryError({
+                kind: 'option',
+                code: 'UNSUPPORTED_OPTION',
+                option: key,
+                supported: [],
+                message: `Gateway control '${key}' must not appear in action params`
+            });
+        }
+    }
+}
+//# sourceMappingURL=execution-options.js.map

package/dist/tools/catalog/capabilities/semantic/execution-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-options.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/execution-options.ts"],"names":[],"mappings":"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"}

package/dist/tools/catalog/capabilities/semantic/handles.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export declare const ActorRefSchema: z.core.$ZodBranded<z.ZodString, "ActorRef", "out">;
+export type ActorRef = z.infer<typeof ActorRefSchema>;
+export declare const ComponentRefSchema: z.core.$ZodBranded<z.ZodString, "ComponentRef", "out">;
+export type ComponentRef = z.infer<typeof ComponentRefSchema>;
+export declare const NodeRefSchema: z.core.$ZodBranded<z.ZodString, "NodeRef", "out">;
+export type NodeRef = z.infer<typeof NodeRefSchema>;
+export declare const TypedHandleSchema: z.ZodDiscriminatedUnion<[z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"actor">;
+    ref: z.core.$ZodBranded<z.ZodString, "ActorRef", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"component">;
+    ref: z.core.$ZodBranded<z.ZodString, "ComponentRef", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"node">;
+    ref: z.core.$ZodBranded<z.ZodString, "NodeRef", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"object">;
+    path: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "ObjectPath", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"asset">;
+    path: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "AssetPath", "out">;
+}, z.core.$strict>>, z.ZodReadonly<z.ZodObject<{
+    kind: z.ZodLiteral<"class">;
+    path: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "ClassPath", "out">;
+}, z.core.$strict>>], "kind">;
+export type TypedHandle = Readonly<z.infer<typeof TypedHandleSchema>>;
+export type HandleKind = z.infer<typeof TypedHandleSchema>['kind'];
+export declare function parseActorRef(input: unknown): ActorRef;
+export declare function parseComponentRef(input: unknown): ComponentRef;
+export declare function parseNodeRef(input: unknown): NodeRef;
+export declare function expectHandleKind<K extends HandleKind>(handle: TypedHandle, expected: K): Extract<TypedHandle, {
+    kind: K;
+}>;
+export declare function expectHandleKind(handle: TypedHandle, expected: HandleKind): TypedHandle;
+//# sourceMappingURL=handles.d.ts.map

package/dist/tools/catalog/capabilities/semantic/handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,cAAc,oDAAiD,CAAC;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,kBAAkB,wDAAqD,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa,mDAAgD,CAAC;AAC3E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAQpD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;6BAO5B,CAAC;AAKH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAQD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EACnD,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AACrC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC"}

package/dist/tools/catalog/capabilities/semantic/handles.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { SemanticBoundaryError } from './errors.js';
+import { AssetPathSchema, ClassPathSchema, ObjectPathSchema } from './paths.js';
+export const ActorRefSchema = z.string().min(1).max(512).brand();
+export const ComponentRefSchema = z.string().min(1).max(512).brand();
+export const NodeRefSchema = z.string().min(1).max(512).brand();
+export const TypedHandleSchema = z.discriminatedUnion('kind', [
+    z.strictObject({ kind: z.literal('actor'), ref: ActorRefSchema }).readonly(),
+    z.strictObject({ kind: z.literal('component'), ref: ComponentRefSchema }).readonly(),
+    z.strictObject({ kind: z.literal('node'), ref: NodeRefSchema }).readonly(),
+    z.strictObject({ kind: z.literal('object'), path: ObjectPathSchema }).readonly(),
+    z.strictObject({ kind: z.literal('asset'), path: AssetPathSchema }).readonly(),
+    z.strictObject({ kind: z.literal('class'), path: ClassPathSchema }).readonly()
+]);
+export function parseActorRef(input) {
+    return ActorRefSchema.parse(input);
+}
+export function parseComponentRef(input) {
+    return ComponentRefSchema.parse(input);
+}
+export function parseNodeRef(input) {
+    return NodeRefSchema.parse(input);
+}
+export function expectHandleKind(handle, expected) {
+    if (handle.kind !== expected) {
+        const semanticError = {
+            kind: 'handle',
+            code: 'HANDLE_KIND_MISMATCH',
+            expected,
+            received: handle.kind,
+            message: `Expected handle kind '${expected}' but received '${handle.kind}'`
+        };
+        throw new SemanticBoundaryError(semanticError);
+    }
+    return handle;
+}
+//# sourceMappingURL=handles.js.map

package/dist/tools/catalog/capabilities/semantic/handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/handles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAsB,MAAM,aAAa,CAAC;AAExE,OAAO,EACL,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAc,CAAC;AAG7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAkB,CAAC;AAGrF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAa,CAAC;AAS3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC5D,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5E,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpF,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1E,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChF,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9E,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/E,CAAC,CAAC;AAQH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAaD,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,QAAoB;IACxE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAkB;YACnC,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,sBAAsB;YAC5B,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,IAAI;YACrB,OAAO,EAAE,yBAAyB,QAAQ,mBAAmB,MAAM,CAAC,IAAI,GAAG;SAC5E,CAAC;QACF,MAAM,IAAI,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/catalog/capabilities/semantic/ids.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const IdempotencyKeySchema: z.core.$ZodBranded<z.ZodString, "IdempotencyKey", "out">;
+export type IdempotencyKey = z.infer<typeof IdempotencyKeySchema>;
+export declare const CorrelationIdSchema: z.core.$ZodBranded<z.ZodString, "CorrelationId", "out">;
+export type CorrelationId = z.infer<typeof CorrelationIdSchema>;
+export declare const CatalogRevisionSchema: z.core.$ZodBranded<z.ZodString, "CatalogRevision", "out">;
+export type CatalogRevision = z.infer<typeof CatalogRevisionSchema>;
+export declare const CapabilityRevisionSchema: z.core.$ZodBranded<z.ZodString, "CapabilityRevision", "out">;
+export type CapabilityRevision = z.infer<typeof CapabilityRevisionSchema>;
+export declare const SchemaRevisionSchema: z.core.$ZodBranded<z.ZodString, "SchemaRevision", "out">;
+export type SchemaRevision = z.infer<typeof SchemaRevisionSchema>;
+export declare const RequestIdSchema: z.core.$ZodBranded<z.ZodString, "RequestId", "out">;
+export type RequestId = z.infer<typeof RequestIdSchema>;
+//# sourceMappingURL=ids.d.ts.map

package/dist/tools/catalog/capabilities/semantic/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB,0DAIL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,mBAAmB,yDAIL,CAAC;AAC5B,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAUhE,eAAO,MAAM,qBAAqB,2DAKL,CAAC;AAC9B,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,wBAAwB,8DAKL,CAAC;AACjC,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,oBAAoB,0DAKL,CAAC;AAC7B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,eAAe,qDAIL,CAAC;AACxB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/tools/catalog/capabilities/semantic/ids.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export const IdempotencyKeySchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .brand();
+export const CorrelationIdSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .brand();
+const HEX_REVISION = /^[0-9a-f]{1,64}$/;
+export const CatalogRevisionSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(HEX_REVISION)
+    .brand();
+export const CapabilityRevisionSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(HEX_REVISION)
+    .brand();
+export const SchemaRevisionSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(HEX_REVISION)
+    .brand();
+export const RequestIdSchema = z
+    .string()
+    .min(1)
+    .max(256)
+    .brand();
+//# sourceMappingURL=ids.js.map

package/dist/tools/catalog/capabilities/semantic/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,EAAoB,CAAC;AAG7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,EAAmB,CAAC;AAS5B,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,YAAY,CAAC;KACnB,KAAK,EAAqB,CAAC;AAG9B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,YAAY,CAAC;KACnB,KAAK,EAAwB,CAAC;AAGjC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,YAAY,CAAC;KACnB,KAAK,EAAoB,CAAC;AAO7B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,EAAe,CAAC"}

package/dist/tools/catalog/capabilities/semantic/index.d.ts

@@ -0,0 +1,10 @@
+export * from './authorization.js';
+export * from './envelope.js';
+export * from './errors.js';
+export * from './execution-options.js';
+export * from './handles.js';
+export * from './ids.js';
+export * from './paths.js';
+export * from './property-assignment.js';
+export * from './save-policy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/catalog/capabilities/semantic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/dist/tools/catalog/capabilities/semantic/index.js

@@ -0,0 +1,10 @@
+export * from './authorization.js';
+export * from './envelope.js';
+export * from './errors.js';
+export * from './execution-options.js';
+export * from './handles.js';
+export * from './ids.js';
+export * from './paths.js';
+export * from './property-assignment.js';
+export * from './save-policy.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/catalog/capabilities/semantic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/dist/tools/catalog/capabilities/semantic/live-state-revisions.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const LiveStateRevisionsSchema: z.ZodReadonly<z.ZodObject<{
+    selection: z.ZodNumber;
+    level: z.ZodNumber;
+    assetRegistry: z.ZodNumber;
+    package: z.ZodNumber;
+    serverInstanceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export type LiveStateRevisions = z.infer<typeof LiveStateRevisionsSchema>;
+export declare function liveStateRevisionsFromEnvelope(value: unknown): LiveStateRevisions | undefined;
+//# sourceMappingURL=live-state-revisions.d.ts.map

package/dist/tools/catalog/capabilities/semantic/live-state-revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-state-revisions.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/live-state-revisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;;;mBASxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAI7F"}

package/dist/tools/catalog/capabilities/semantic/live-state-revisions.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const RevisionCounterSchema = z.number().int().min(1);
+export const LiveStateRevisionsSchema = z
+    .strictObject({
+    selection: RevisionCounterSchema,
+    level: RevisionCounterSchema,
+    assetRegistry: RevisionCounterSchema,
+    package: RevisionCounterSchema,
+    serverInstanceId: z.string().min(1).optional()
+})
+    .readonly();
+export function liveStateRevisionsFromEnvelope(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return undefined;
+    const parsed = LiveStateRevisionsSchema.safeParse(Reflect.get(value, 'liveRevisions'));
+    return parsed.success ? parsed.data : undefined;
+}
+//# sourceMappingURL=live-state-revisions.js.map

package/dist/tools/catalog/capabilities/semantic/live-state-revisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-state-revisions.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/live-state-revisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,YAAY,CAAC;IACZ,SAAS,EAAE,qBAAqB;IAChC,KAAK,EAAE,qBAAqB;IAC5B,aAAa,EAAE,qBAAqB;IACpC,OAAO,EAAE,qBAAqB;IAE9B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;KACD,QAAQ,EAAE,CAAC;AAId,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/tools/catalog/capabilities/semantic/paths.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const AssetPathSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "AssetPath", "out">;
+export type AssetPath = z.infer<typeof AssetPathSchema>;
+export declare const ObjectPathSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "ObjectPath", "out">;
+export type ObjectPath = z.infer<typeof ObjectPathSchema>;
+export declare const ClassPathSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "ClassPath", "out">;
+export type ClassPath = z.infer<typeof ClassPathSchema>;
+export declare function parseAssetPath(input: unknown): AssetPath;
+export declare function parseObjectPath(input: unknown): ObjectPath;
+export declare function parseClassPath(input: unknown): ClassPath;
+//# sourceMappingURL=paths.d.ts.map

package/dist/tools/catalog/capabilities/semantic/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/semantic/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuMxB,eAAO,MAAM,eAAe,gGAUL,CAAC;AACxB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB,iGAUL,CAAC;AACzB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe,gGAUL,CAAC;AACxB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAGxD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAG1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAGxD"}