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

package/dist/tools/catalog/capabilities/records/control-actor/transform-records.js

@@ -0,0 +1,211 @@
+import { buildCoreRecord } from '../core/builder.js';
+import { actorAlias, CANONICAL_NR, DOMAIN, P } from './properties.js';
+const FAMILY_TRANSFORM = 'transform';
+const FAMILY_PHYSICS = 'physics';
+const TRANSFORM_INPUT = {
+    actorName: P.actorName,
+    location: P.location,
+    rotation: P.rotation,
+    scale: P.scale,
+};
+const TRANSFORM_OUTPUT = {
+    success: true,
+    message: 'Actor transform updated',
+    actorName: 'Cube1',
+    location: [10, 20, 30],
+    rotation: [0, 90, 0],
+    scale: [1, 1, 1],
+};
+const TRANSFORM_OUTPUT_PROPS = {
+    actorName: { type: 'string', description: 'Label of the actor whose transform was written.' },
+    location: {
+        type: 'array', items: { type: 'number' },
+        description: 'World location [x, y, z] read back off the actor after the write.',
+    },
+    rotation: {
+        type: 'array', items: { type: 'number' },
+        description: 'World rotation [pitch, yaw, roll] read back off the actor after the write.',
+    },
+    scale: {
+        type: 'array', items: { type: 'number' },
+        description: 'World scale [x, y, z] read back off the actor after the write.',
+    },
+};
+export const TRANSFORM_RECORDS = [
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'set_transform',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        topics: ['move actor', 'set actor location', 'set position', 'rotate actor', 'set rotation', 'scale actor', 'teleport actor', 'translate'],
+        aliases: ['control_actor.move', 'control_actor.move_actor'],
+        summary: 'Move, rotate or scale an actor by setting its world transform (location, rotation, scale).',
+        whenToUse: ['An actor must be moved, rotated, or rescaled in one call.'],
+        whenNotToUse: ['Only the transform needs to be read (use get_transform).'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: CANONICAL_NR,
+        exampleInput: { action: 'set_transform', actorName: 'Cube1', location: [10, 20, 30], rotation: [0, 90, 0], scale: [1, 1, 1] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'teleport_actor',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of set_transform; normalizeActorAction maps teleport_actor to set_transform.',
+        whenToUse: ['Preferred when callers use the teleport_actor verb.'],
+        whenNotToUse: ['Use set_transform to avoid alias normalization.'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('set_transform'),
+        exampleInput: { action: 'teleport_actor', actorName: 'Cube1', location: [5, 5, 5] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'set_actor_location',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of set_transform (location-only intent); normalizes to set_transform.',
+        whenToUse: ['An actor must be moved to a new location.'],
+        whenNotToUse: ['Use set_transform for the full transform verb.'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('set_transform'),
+        exampleInput: { action: 'set_actor_location', actorName: 'Cube1', location: [100, 0, 0] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'set_actor_rotation',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of set_transform (rotation-only intent); normalizes to set_transform.',
+        whenToUse: ['An actor must be rotated.'],
+        whenNotToUse: ['Use set_transform for the full transform verb.'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('set_transform'),
+        exampleInput: { action: 'set_actor_rotation', actorName: 'Cube1', rotation: [0, 45, 0] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'set_actor_scale',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of set_transform (scale-only intent); normalizes to set_transform.',
+        whenToUse: ['An actor must be rescaled.'],
+        whenNotToUse: ['Use set_transform for the full transform verb.'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('set_transform'),
+        exampleInput: { action: 'set_actor_scale', actorName: 'Cube1', scale: [2, 2, 2] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'set_actor_transform',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of set_transform; normalizeActorAction maps set_actor_transform to set_transform.',
+        whenToUse: ['Preferred when callers use the explicit set_actor_transform verb.'],
+        whenNotToUse: ['Use set_transform to avoid alias normalization.'],
+        inputProps: TRANSFORM_INPUT,
+        required: ['actorName'],
+        effect: 'write',
+        behavior: { idempotency: 'idempotent' },
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('set_transform'),
+        exampleInput: { action: 'set_actor_transform', actorName: 'Cube1', location: [1, 2, 3] },
+        outputProps: TRANSFORM_OUTPUT_PROPS,
+        exampleOutput: TRANSFORM_OUTPUT,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'get_transform',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        topics: ['actor location', 'actor position', 'actor rotation', 'where is the actor'],
+        summary: 'Read the world transform (location, rotation, scale) of an actor.',
+        whenToUse: ['The current transform of an actor must be inspected.'],
+        whenNotToUse: ['The transform should be changed (use set_transform).'],
+        inputProps: { actorName: P.actorName },
+        required: ['actorName'],
+        outputProps: { location: P.location, rotation: P.rotation, scale: P.scale },
+        outputRequired: [],
+        effect: 'read',
+        costLatency: 'instant',
+        costResources: 'low',
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: CANONICAL_NR,
+        exampleInput: { action: 'get_transform', actorName: 'Cube1' },
+        exampleOutput: { success: true, message: 'Transform for Cube1', location: [0, 0, 0], rotation: [0, 0, 0], scale: [1, 1, 1] },
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'get_actor_transform',
+        domain: DOMAIN,
+        family: FAMILY_TRANSFORM,
+        summary: 'Alias of get_transform; normalizeActorAction maps get_actor_transform to get_transform.',
+        whenToUse: ['Preferred when callers use the explicit get_actor_transform verb.'],
+        whenNotToUse: ['Use get_transform to avoid alias normalization.'],
+        inputProps: { actorName: P.actorName },
+        required: ['actorName'],
+        outputProps: { location: P.location, rotation: P.rotation, scale: P.scale },
+        outputRequired: [],
+        effect: 'read',
+        costLatency: 'instant',
+        costResources: 'low',
+        ...actorAlias('get_transform'),
+        exampleInput: { action: 'get_actor_transform', actorName: 'Cube1' },
+        exampleOutput: { success: true, message: 'Transform for Cube1', location: [0, 0, 0], rotation: [0, 0, 0], scale: [1, 1, 1] },
+    }),
+    buildCoreRecord({
+        parentTool: 'control_actor',
+        action: 'apply_force',
+        domain: DOMAIN,
+        family: FAMILY_PHYSICS,
+        summary: 'Apply a physics force vector to an actor, auto-enabling simulation on failure.',
+        whenToUse: ['A physical impulse must be applied to a simulated actor.'],
+        whenNotToUse: ['The actor is not physics-enabled and physics cannot be auto-enabled.'],
+        inputProps: { actorName: P.actorName, force: P.force },
+        required: ['actorName', 'force'],
+        effect: 'write',
+        costLatency: 'interactive',
+        costResources: 'low',
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: CANONICAL_NR,
+        exampleInput: { action: 'apply_force', actorName: 'Cube1', force: [0, 0, 500] },
+        exampleOutput: { success: true, message: 'Force applied to Cube1' },
+    }),
+];
+//# sourceMappingURL=transform-records.js.map

package/dist/tools/catalog/capabilities/records/control-actor/transform-records.js.map

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

package/dist/tools/catalog/capabilities/records/control-editor/asset.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityRecordSource } from '../../index.js';
+export declare const ASSET_RECORDS: readonly CapabilityRecordSource[];
+//# sourceMappingURL=asset.d.ts.map

package/dist/tools/catalog/capabilities/records/control-editor/asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/asset.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAc,MAAM,gBAAgB,CAAC;AA+DzE,eAAO,MAAM,aAAa,EAAE,SAAS,sBAAsB,EAsF1D,CAAC"}

package/dist/tools/catalog/capabilities/records/control-editor/asset.js

@@ -0,0 +1,139 @@
+import { buildCoreRecord } from '../core/builder.js';
+import { P } from './properties.js';
+const F = 'asset';
+const D = 'editor';
+const NR = 'Distinct control_editor asset or level navigation operation with unique target semantics.';
+const COMPENSATION_STEP = {
+    type: 'object',
+    description: 'One step of the non-atomic save, naming what landed or why it did not.',
+    properties: {
+        step: { type: 'string', description: 'Machine-readable step id, e.g. save:/Game/Maps/Main.' },
+        detail: { type: 'string', description: 'What landed on disk, or the reason nothing did.' },
+    },
+    required: ['step', 'detail'],
+    additionalProperties: false,
+};
+const COMPENSATION = {
+    type: 'object',
+    description: 'Compensating-cleanup receipt. Present on every outcome including the all-succeeded one, because '
+        + 'each package lands independently and a completed save is already durable: non-atomic is a property '
+        + 'of the operation, not of one result.',
+    properties: {
+        operation: { type: 'string', description: 'Canonical capability this receipt describes.' },
+        atomic: {
+            type: 'boolean',
+            enum: [false],
+            description: 'Always false. Packages land one at a time and the ones that landed stay landed.',
+        },
+        rollback: {
+            type: 'string',
+            enum: ['unavailable'],
+            description: 'Always "unavailable". No editor transaction can reach a finished save, so this call was not and cannot be undone.',
+        },
+        rollbackReason: { type: 'string', description: 'Why no rollback exists for this class of work.' },
+        state: {
+            type: 'string',
+            enum: ['completed', 'partial', 'failed', 'noop'],
+            description: 'Outcome across all steps: everything landed, some did, none did, or there was nothing to do.',
+        },
+        completed: { type: 'array', items: COMPENSATION_STEP, description: 'Steps whose effect is now durable on disk.' },
+        notCompleted: { type: 'array', items: COMPENSATION_STEP, description: 'Steps that did not complete, each with its reason.' },
+        skipped: { type: 'array', items: COMPENSATION_STEP, description: 'Steps deliberately not attempted, such as transient packages.' },
+        compensatingCapabilities: {
+            type: 'array',
+            items: { type: 'string', description: 'Canonical capability id that reverses a durable effect.' },
+            description: 'Separate calls the caller may make to reverse a durable effect. Never a rollback of this call.',
+        },
+        callerAction: { type: 'string', description: 'Exact instruction for reaching a clean state; empty when nothing is outstanding.' },
+    },
+    required: ['atomic', 'rollback', 'state'],
+    additionalProperties: false,
+};
+export const ASSET_RECORDS = [
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'open_asset', domain: D, family: F,
+        summary: 'Open an asset in the appropriate editor by asset path.',
+        whenToUse: ['An asset must be opened for editing or inspection.'],
+        whenNotToUse: ['The asset is already open.'],
+        inputProps: { assetPath: P.assetPath, path: P.path },
+        required: ['assetPath'],
+        effect: 'read',
+        costLatency: 'interactive', costResources: 'low',
+        exampleInput: { action: 'open_asset', assetPath: '/Game/Materials/M_Base' },
+        exampleOutput: { success: true, message: 'Asset opened' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'close_asset', domain: D, family: F,
+        summary: 'Close an open asset editor by asset path.',
+        whenToUse: ['An open asset editor must be closed.'],
+        whenNotToUse: ['The asset is not open.'],
+        inputProps: { assetPath: P.assetPath, path: P.path },
+        required: ['assetPath'],
+        effect: 'write',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'close_asset', assetPath: '/Game/Materials/M_Base' },
+        exampleOutput: { success: true, message: 'Asset closed' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'open_level', domain: D, family: F,
+        topics: ['open map', 'open level asset'],
+        summary: 'Open a level by asset path, loading it as the current level.',
+        whenToUse: ['A different level must be loaded into the editor.'],
+        whenNotToUse: ['The level is already loaded.'],
+        inputProps: { levelPath: P.levelPath, path: P.path, assetPath: P.assetPath },
+        required: ['levelPath'],
+        effect: 'write',
+        costLatency: 'interactive', costResources: 'medium',
+        exampleInput: { action: 'open_level', levelPath: '/Game/Maps/EntryMap' },
+        exampleOutput: { success: true, message: 'Level loaded' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'focus_actor', domain: D, family: F,
+        aliases: ['control_editor.move_camera_to_actor'],
+        summary: 'Focus the viewport camera on a specific actor by name.',
+        whenToUse: ['The viewport must frame a specific actor.'],
+        whenNotToUse: ['The actor does not exist in the current level.'],
+        inputProps: { actorName: P.actorName, name: P.name },
+        required: ['actorName'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'focus_actor', actorName: 'BP_PlayerStart' },
+        exampleOutput: { success: true, message: 'Focused on BP_PlayerStart' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: 'TS normalizes focus_actor to focus for handler routing; bridge dispatches focus_actor. Distinct viewport navigation verb.',
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'save_all', domain: D, family: F,
+        topics: ['save all', 'save everything', 'save dirty packages', 'save project', 'save assets'],
+        summary: 'Save all dirty assets and levels in the editor.',
+        whenToUse: ['All unsaved changes must be persisted.'],
+        whenNotToUse: ['Specific assets should be saved individually.'],
+        inputProps: {},
+        required: [],
+        outputProps: { compensation: COMPENSATION },
+        effect: 'write',
+        costLatency: 'interactive', costResources: 'medium',
+        exampleInput: { action: 'save_all' },
+        exampleOutput: {
+            success: true,
+            message: 'All assets saved',
+            compensation: {
+                operation: 'control_editor.save_all',
+                atomic: false,
+                rollback: 'unavailable',
+                rollbackReason: 'Completed steps are already durable on disk. No editor transaction can reach a finished save, build or render, so nothing here was or can be undone.',
+                state: 'completed',
+                completed: [{ step: 'save:/Game/Maps/EntryMap', detail: 'level package written to disk' }],
+                notCompleted: [],
+                skipped: [],
+                compensatingCapabilities: [],
+                callerAction: '',
+            },
+        },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+];
+//# sourceMappingURL=asset.js.map

package/dist/tools/catalog/capabilities/records/control-editor/asset.js.map

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

package/dist/tools/catalog/capabilities/records/control-editor/bookmark.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityRecordSource } from '../../index.js';
+export declare const BOOKMARK_RECORDS: readonly CapabilityRecordSource[];
+//# sourceMappingURL=bookmark.d.ts.map

package/dist/tools/catalog/capabilities/records/control-editor/bookmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/bookmark.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,sBAAsB,EA2B7D,CAAC"}

package/dist/tools/catalog/capabilities/records/control-editor/bookmark.js

@@ -0,0 +1,34 @@
+import { buildCoreRecord } from '../core/builder.js';
+import { P } from './properties.js';
+const F = 'bookmark';
+const D = 'editor';
+const NR = 'Distinct control_editor bookmark operation with unique viewport navigation semantics.';
+export const BOOKMARK_RECORDS = [
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'create_bookmark', domain: D, family: F,
+        summary: 'Create a viewport bookmark at the current camera position.',
+        whenToUse: ['The current viewport camera state must be saved for later recall.'],
+        whenNotToUse: ['A bookmark already exists at the desired index.'],
+        inputProps: { id: P.id, description: P.description, bookmarkName: P.bookmarkName },
+        required: [],
+        effect: 'write',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'create_bookmark', bookmarkName: 'Overview' },
+        exampleOutput: { success: true, message: 'Bookmark created' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'jump_to_bookmark', domain: D, family: F,
+        summary: 'Jump the viewport camera to a previously created bookmark.',
+        whenToUse: ['The viewport must navigate to a saved bookmark position.'],
+        whenNotToUse: ['The bookmark does not exist.'],
+        inputProps: { id: P.id, bookmarkName: P.bookmarkName },
+        required: [],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'jump_to_bookmark', bookmarkName: 'Overview' },
+        exampleOutput: { success: true, message: 'Jumped to bookmark' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+];
+//# sourceMappingURL=bookmark.js.map

package/dist/tools/catalog/capabilities/records/control-editor/bookmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark.js","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/bookmark.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEpC,MAAM,CAAC,GAAG,UAAU,CAAC;AACrB,MAAM,CAAC,GAAG,QAAQ,CAAC;AACnB,MAAM,EAAE,GAAG,uFAAuF,CAAC;AAEnG,MAAM,CAAC,MAAM,gBAAgB,GAAsC;IACjE,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7E,OAAO,EAAE,4DAA4D;QACrE,SAAS,EAAE,CAAC,mEAAmE,CAAC;QAChF,YAAY,EAAE,CAAC,iDAAiD,CAAC;QACjE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE;QAClF,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE;QACrE,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE;QAC7D,kBAAkB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,EAAE;KAC/E,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9E,OAAO,EAAE,4DAA4D;QACrE,SAAS,EAAE,CAAC,0DAA0D,CAAC;QACvE,YAAY,EAAE,CAAC,8BAA8B,CAAC;QAC9C,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE;QACtD,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE;QACtE,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE;QAC/D,kBAAkB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,EAAE;KAC/E,CAAC;CACH,CAAC"}

package/dist/tools/catalog/capabilities/records/control-editor/camera.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityRecordSource } from '../../index.js';
+export declare const CAMERA_RECORDS: readonly CapabilityRecordSource[];
+//# sourceMappingURL=camera.d.ts.map

package/dist/tools/catalog/capabilities/records/control-editor/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/camera.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EAsF3D,CAAC"}

package/dist/tools/catalog/capabilities/records/control-editor/camera.js

@@ -0,0 +1,93 @@
+import { buildCoreRecord } from '../core/builder.js';
+import { P } from './properties.js';
+const F = 'camera';
+const D = 'editor';
+const NR = 'Distinct control_editor viewport camera operation with unique view semantics.';
+export const CAMERA_RECORDS = [
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_view_target', domain: D, family: F,
+        summary: 'Set the PIE view target to a specific actor by name.',
+        whenToUse: ['The camera must follow or focus on a specific actor in PIE.'],
+        whenNotToUse: ['A fixed camera position is preferred (use set_camera).'],
+        inputProps: { actorName: P.actorName, name: P.name, objectPath: P.objectPath, location: P.location, rotation: P.rotation, blendTime: P.blendTime },
+        required: ['actorName'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_view_target', actorName: 'BP_CameraTarget' },
+        exampleOutput: { success: true, message: 'View target set' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_game_view_target', dispatchAction: 'set_view_target',
+        domain: D, family: F,
+        summary: 'Set the PIE view target (alias for set_view_target).',
+        whenToUse: ['The camera view target must be set using the set_game_view_target alias.'],
+        whenNotToUse: ['A fixed camera position is preferred (use set_camera).'],
+        inputProps: { actorName: P.actorName, name: P.name, objectPath: P.objectPath, location: P.location, rotation: P.rotation, blendTime: P.blendTime },
+        required: ['actorName'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_game_view_target', actorName: 'BP_CameraTarget' },
+        exampleOutput: { success: true, message: 'View target set' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: 'TS normalizes set_game_view_target to set_view_target for handler routing; bridge dispatches set_view_target.',
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_camera', domain: D, family: F,
+        summary: 'Set the editor viewport camera position and rotation.',
+        whenToUse: ['The viewport camera must be moved to a specific position and orientation.'],
+        whenNotToUse: ['The camera should follow an actor (use set_view_target).'],
+        inputProps: { location: P.location, rotation: P.rotation, actorName: P.actorName },
+        required: ['location', 'rotation'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_camera', location: { x: 0, y: 0, z: 500 }, rotation: { pitch: -45, yaw: 0, roll: 0 } },
+        exampleOutput: { success: true, message: 'Camera set' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_camera_position', dispatchAction: 'set_camera',
+        domain: D, family: F,
+        summary: 'Set the editor viewport camera (alias for set_camera).',
+        whenToUse: ['The viewport camera must be moved using the set_camera_position alias.'],
+        whenNotToUse: ['The camera should follow an actor (use set_view_target).'],
+        inputProps: { location: P.location, rotation: P.rotation, actorName: P.actorName },
+        required: ['location', 'rotation'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_camera_position', location: { x: 100, y: 200, z: 300 }, rotation: { pitch: 0, yaw: 90, roll: 0 } },
+        exampleOutput: { success: true, message: 'Camera set' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: 'TS normalizes set_camera_position to set_camera for handler routing; bridge dispatches set_camera.',
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_viewport_camera', dispatchAction: 'set_camera',
+        domain: D, family: F,
+        topics: ['viewport camera', 'move camera', 'camera position', 'look at', 'editor camera', 'focus camera on'],
+        summary: 'Set the editor viewport camera (alias for set_camera).',
+        whenToUse: ['The viewport camera must be moved using the set_viewport_camera alias.'],
+        whenNotToUse: ['The camera should follow an actor (use set_view_target).'],
+        inputProps: { location: P.location, rotation: P.rotation, actorName: P.actorName },
+        required: ['location', 'rotation'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_viewport_camera', location: { x: 0, y: 0, z: 100 }, rotation: { pitch: -90, yaw: 0, roll: 0 } },
+        exampleOutput: { success: true, message: 'Camera set' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET',
+        normalizationRationale: 'TS normalizes set_viewport_camera to set_camera for handler routing; bridge dispatches set_camera.',
+    }),
+    buildCoreRecord({
+        parentTool: 'control_editor', action: 'set_camera_fov', domain: D, family: F,
+        summary: 'Set the editor viewport camera field of view.',
+        whenToUse: ['The camera FOV must be adjusted for the viewport.'],
+        whenNotToUse: ['The default FOV is acceptable.'],
+        inputProps: { fov: P.fov },
+        required: ['fov'],
+        effect: 'read',
+        costLatency: 'instant', costResources: 'low',
+        exampleInput: { action: 'set_camera_fov', fov: 90 },
+        exampleOutput: { success: true, message: 'FOV set to 90' },
+        normalizationClass: 'C_SAME_VERB_DIFFERENT_TARGET', normalizationRationale: NR,
+    }),
+];
+//# sourceMappingURL=camera.js.map

package/dist/tools/catalog/capabilities/records/control-editor/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/camera.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEpC,MAAM,CAAC,GAAG,QAAQ,CAAC;AACnB,MAAM,CAAC,GAAG,QAAQ,CAAC;AACnB,MAAM,EAAE,GAAG,+EAA+E,CAAC;AAE3F,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC/D,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7E,OAAO,EAAE,sDAAsD;QAC/D,SAAS,EAAE,CAAC,6DAA6D,CAAC;QAC1E,YAAY,EAAE,CAAC,wDAAwD,CAAC;QACxE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;QAClJ,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE;QACzE,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC5D,kBAAkB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,EAAE;KAC/E,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,sBAAsB,EAAE,cAAc,EAAE,iBAAiB;QAC/F,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,sDAAsD;QAC/D,SAAS,EAAE,CAAC,0EAA0E,CAAC;QACvF,YAAY,EAAE,CAAC,wDAAwD,CAAC;QACxE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;QAClJ,QAAQ,EAAE,CAAC,WAAW,CAAC;QACvB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,iBAAiB,EAAE;QAC9E,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC5D,kBAAkB,EAAE,8BAA8B;QAClD,sBAAsB,EAAE,+GAA+G;KACxI,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACxE,OAAO,EAAE,uDAAuD;QAChE,SAAS,EAAE,CAAC,2EAA2E,CAAC;QACxF,YAAY,EAAE,CAAC,0DAA0D,CAAC;QAC1E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;QAClF,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QAClC,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACnH,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;QACvD,kBAAkB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,EAAE;KAC/E,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY;QACzF,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,wDAAwD;QACjE,SAAS,EAAE,CAAC,wEAAwE,CAAC;QACrF,YAAY,EAAE,CAAC,0DAA0D,CAAC;QAC1E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;QAClF,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QAClC,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QAC/H,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;QACvD,kBAAkB,EAAE,8BAA8B;QAClD,sBAAsB,EAAE,oGAAoG;KAC7H,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY;QACzF,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,CAAC;QAC5G,OAAO,EAAE,wDAAwD;QACjE,SAAS,EAAE,CAAC,wEAAwE,CAAC;QACrF,YAAY,EAAE,CAAC,0DAA0D,CAAC;QAC1E,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE;QAClF,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;QAClC,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5H,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;QACvD,kBAAkB,EAAE,8BAA8B;QAClD,sBAAsB,EAAE,oGAAoG;KAC7H,CAAC;IACF,eAAe,CAAC;QACd,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QAC5E,OAAO,EAAE,+CAA+C;QACxD,SAAS,EAAE,CAAC,mDAAmD,CAAC;QAChE,YAAY,EAAE,CAAC,gCAAgC,CAAC;QAChD,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;QAC1B,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK;QAC5C,YAAY,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE;QACnD,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE;QAC1D,kBAAkB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,EAAE;KAC/E,CAAC;CACH,CAAC"}

package/dist/tools/catalog/capabilities/records/control-editor/command.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityRecordSource } from '../../index.js';
+export declare const COMMAND_RECORDS: readonly CapabilityRecordSource[];
+//# sourceMappingURL=command.d.ts.map

package/dist/tools/catalog/capabilities/records/control-editor/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/catalog/capabilities/records/control-editor/command.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAO7D,eAAO,MAAM,eAAe,EAAE,SAAS,sBAAsB,EAoK5D,CAAC"}