ue-mcp 1.0.33 → 1.0.34

package/README.md

@@ -1,6 +1,6 @@
 # UE-MCP
 
-**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->525+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
+**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->543+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
 
 ```mermaid
 flowchart LR
@@ -57,7 +57,7 @@ If you prefer to configure manually, add to your MCP client config:
 
 - [Getting Started](https://db-lyon.github.io/ue-mcp/getting-started/) — Installation, configuration, first run
 - [Architecture](https://db-lyon.github.io/ue-mcp/architecture/) — How the pieces fit together
-- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->525+<!-- /count --> actions
+- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->543+<!-- /count --> actions
 - [Flows](https://db-lyon.github.io/ue-mcp/flows/) - YAML flow engine, custom tasks, rollback, hooks
 - [Configuration](https://db-lyon.github.io/ue-mcp/configuration/) — `.ue-mcp.json` and MCP client config
 - [Neon Shrine Demo](https://db-lyon.github.io/ue-mcp/neon-shrine-demo/) — Interactive guided demo

package/dist/pie/schema.d.ts

@@ -0,0 +1,671 @@
+import { z } from "zod";
+/**
+ * Zod schemas describing the PIE record/replay on-disk format. The C++
+ * recorder/replayer (plugin/.../Private/PIE/PIESequenceFormat.{h,cpp}) is the
+ * canonical writer; these schemas are the wire-shape contract used by tests
+ * and any future TS-side tooling. Keep in sync with PIESequenceFormat.h.
+ */
+export declare const PIE_FORMAT_VERSION: 1;
+export declare const ActionValueType: z.ZodEnum<["Boolean", "Axis1D", "Axis2D", "Axis3D"]>;
+export type ActionValueType = z.infer<typeof ActionValueType>;
+export declare const ActionSpec: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    value_type: z.ZodEnum<["Boolean", "Axis1D", "Axis2D", "Axis3D"]>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+}, {
+    path: string;
+    name: string;
+    value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+}>;
+export type ActionSpec = z.infer<typeof ActionSpec>;
+export declare const TrackedValueSpec: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: string;
+}, {
+    path: string;
+    type: string;
+}>;
+export type TrackedValueSpec = z.infer<typeof TrackedValueSpec>;
+export declare const Marker: z.ZodObject<{
+    frame: z.ZodNumber;
+    time: z.ZodNumber;
+    label: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    frame: number;
+    time: number;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    label: string;
+    frame: number;
+    time: number;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type Marker = z.infer<typeof Marker>;
+export declare const Manifest: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    started_at: z.ZodString;
+    ended_at: z.ZodString;
+    duration_seconds: z.ZodNumber;
+    total_frames: z.ZodNumber;
+    sample_hz: z.ZodNumber;
+    pin_max_fps: z.ZodNumber;
+    rng_seed: z.ZodNumber;
+    pie_world: z.ZodString;
+    pawn_class: z.ZodString;
+    axis_threshold: z.ZodNumber;
+    actions: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        value_type: z.ZodEnum<["Boolean", "Axis1D", "Axis2D", "Axis3D"]>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        name: string;
+        value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+    }, {
+        path: string;
+        name: string;
+        value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+    }>, "many">;
+    tracked_values: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: string;
+    }, {
+        path: string;
+        type: string;
+    }>, "many">;
+    markers: z.ZodArray<z.ZodObject<{
+        frame: z.ZodNumber;
+        time: z.ZodNumber;
+        label: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        frame: number;
+        time: number;
+        metadata?: Record<string, unknown> | undefined;
+    }, {
+        label: string;
+        frame: number;
+        time: number;
+        metadata?: Record<string, unknown> | undefined;
+    }>, "many">;
+    files: z.ZodObject<{
+        csv: z.ZodString;
+        sequence: z.ZodString;
+        drift: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        csv: string;
+        sequence: string;
+        drift?: string | undefined;
+    }, {
+        csv: string;
+        sequence: string;
+        drift?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    version: 1;
+    actions: {
+        path: string;
+        name: string;
+        value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+    }[];
+    axis_threshold: number;
+    sample_hz: number;
+    rng_seed: number;
+    started_at: string;
+    ended_at: string;
+    duration_seconds: number;
+    total_frames: number;
+    pin_max_fps: number;
+    pie_world: string;
+    pawn_class: string;
+    tracked_values: {
+        path: string;
+        type: string;
+    }[];
+    markers: {
+        label: string;
+        frame: number;
+        time: number;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    files: {
+        csv: string;
+        sequence: string;
+        drift?: string | undefined;
+    };
+}, {
+    id: string;
+    version: 1;
+    actions: {
+        path: string;
+        name: string;
+        value_type: "Boolean" | "Axis1D" | "Axis2D" | "Axis3D";
+    }[];
+    axis_threshold: number;
+    sample_hz: number;
+    rng_seed: number;
+    started_at: string;
+    ended_at: string;
+    duration_seconds: number;
+    total_frames: number;
+    pin_max_fps: number;
+    pie_world: string;
+    pawn_class: string;
+    tracked_values: {
+        path: string;
+        type: string;
+    }[];
+    markers: {
+        label: string;
+        frame: number;
+        time: number;
+        metadata?: Record<string, unknown> | undefined;
+    }[];
+    files: {
+        csv: string;
+        sequence: string;
+        drift?: string | undefined;
+    };
+}>;
+export type Manifest = z.infer<typeof Manifest>;
+export declare const TapeValue: z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>;
+export type TapeValue = z.infer<typeof TapeValue>;
+export declare const InputStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"input">;
+    action: z.ZodString;
+    value_x: z.ZodOptional<z.ZodNumber>;
+    value_y: z.ZodOptional<z.ZodNumber>;
+    value_z: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    action: string;
+    delay_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}, {
+    type: "input";
+    action: string;
+    delay_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}>;
+export declare const HoldStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"hold">;
+    action: z.ZodString;
+    value_x: z.ZodOptional<z.ZodNumber>;
+    value_y: z.ZodOptional<z.ZodNumber>;
+    value_z: z.ZodOptional<z.ZodNumber>;
+    duration_ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "hold";
+    action: string;
+    delay_ms: number;
+    duration_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}, {
+    type: "hold";
+    action: string;
+    delay_ms: number;
+    duration_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}>;
+export declare const CaptureStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"capture">;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "capture";
+    name: string;
+    delay_ms: number;
+}, {
+    type: "capture";
+    name: string;
+    delay_ms: number;
+}>;
+export declare const ConsoleStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"console">;
+    command: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "console";
+    command: string;
+    delay_ms: number;
+}, {
+    type: "console";
+    command: string;
+    delay_ms: number;
+}>;
+export declare const InputTapeStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"input_tape">;
+    action: z.ZodString;
+    values: z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "input_tape";
+    values: (number | [number, number] | [number, number, number])[];
+    action: string;
+    delay_ms: number;
+}, {
+    type: "input_tape";
+    values: (number | [number, number] | [number, number, number])[];
+    action: string;
+    delay_ms: number;
+}>;
+export declare const MarkStep: z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"mark">;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "mark";
+    label: string;
+    delay_ms: number;
+}, {
+    type: "mark";
+    label: string;
+    delay_ms: number;
+}>;
+export declare const Step: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"input">;
+    action: z.ZodString;
+    value_x: z.ZodOptional<z.ZodNumber>;
+    value_y: z.ZodOptional<z.ZodNumber>;
+    value_z: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "input";
+    action: string;
+    delay_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}, {
+    type: "input";
+    action: string;
+    delay_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}>, z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"hold">;
+    action: z.ZodString;
+    value_x: z.ZodOptional<z.ZodNumber>;
+    value_y: z.ZodOptional<z.ZodNumber>;
+    value_z: z.ZodOptional<z.ZodNumber>;
+    duration_ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "hold";
+    action: string;
+    delay_ms: number;
+    duration_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}, {
+    type: "hold";
+    action: string;
+    delay_ms: number;
+    duration_ms: number;
+    value_x?: number | undefined;
+    value_y?: number | undefined;
+    value_z?: number | undefined;
+}>, z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"capture">;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "capture";
+    name: string;
+    delay_ms: number;
+}, {
+    type: "capture";
+    name: string;
+    delay_ms: number;
+}>, z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"console">;
+    command: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "console";
+    command: string;
+    delay_ms: number;
+}, {
+    type: "console";
+    command: string;
+    delay_ms: number;
+}>, z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"input_tape">;
+    action: z.ZodString;
+    values: z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "input_tape";
+    values: (number | [number, number] | [number, number, number])[];
+    action: string;
+    delay_ms: number;
+}, {
+    type: "input_tape";
+    values: (number | [number, number] | [number, number, number])[];
+    action: string;
+    delay_ms: number;
+}>, z.ZodObject<{
+    delay_ms: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"mark">;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "mark";
+    label: string;
+    delay_ms: number;
+}, {
+    type: "mark";
+    label: string;
+    delay_ms: number;
+}>]>;
+export type Step = z.infer<typeof Step>;
+export declare const Sequence: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    source_recording_id: z.ZodOptional<z.ZodString>;
+    settle_ms: z.ZodNumber;
+    sample_hz: z.ZodNumber;
+    rng_seed: z.ZodNumber;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"input">;
+        action: z.ZodString;
+        value_x: z.ZodOptional<z.ZodNumber>;
+        value_y: z.ZodOptional<z.ZodNumber>;
+        value_z: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "input";
+        action: string;
+        delay_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    }, {
+        type: "input";
+        action: string;
+        delay_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    }>, z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"hold">;
+        action: z.ZodString;
+        value_x: z.ZodOptional<z.ZodNumber>;
+        value_y: z.ZodOptional<z.ZodNumber>;
+        value_z: z.ZodOptional<z.ZodNumber>;
+        duration_ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "hold";
+        action: string;
+        delay_ms: number;
+        duration_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    }, {
+        type: "hold";
+        action: string;
+        delay_ms: number;
+        duration_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    }>, z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"capture">;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "capture";
+        name: string;
+        delay_ms: number;
+    }, {
+        type: "capture";
+        name: string;
+        delay_ms: number;
+    }>, z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"console">;
+        command: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "console";
+        command: string;
+        delay_ms: number;
+    }, {
+        type: "console";
+        command: string;
+        delay_ms: number;
+    }>, z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"input_tape">;
+        action: z.ZodString;
+        values: z.ZodArray<z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "input_tape";
+        values: (number | [number, number] | [number, number, number])[];
+        action: string;
+        delay_ms: number;
+    }, {
+        type: "input_tape";
+        values: (number | [number, number] | [number, number, number])[];
+        action: string;
+        delay_ms: number;
+    }>, z.ZodObject<{
+        delay_ms: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"mark">;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "mark";
+        label: string;
+        delay_ms: number;
+    }, {
+        type: "mark";
+        label: string;
+        delay_ms: number;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    steps: ({
+        type: "input";
+        action: string;
+        delay_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    } | {
+        type: "hold";
+        action: string;
+        delay_ms: number;
+        duration_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    } | {
+        type: "capture";
+        name: string;
+        delay_ms: number;
+    } | {
+        type: "console";
+        command: string;
+        delay_ms: number;
+    } | {
+        type: "input_tape";
+        values: (number | [number, number] | [number, number, number])[];
+        action: string;
+        delay_ms: number;
+    } | {
+        type: "mark";
+        label: string;
+        delay_ms: number;
+    })[];
+    sample_hz: number;
+    rng_seed: number;
+    settle_ms: number;
+    source_recording_id?: string | undefined;
+}, {
+    version: 1;
+    steps: ({
+        type: "input";
+        action: string;
+        delay_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    } | {
+        type: "hold";
+        action: string;
+        delay_ms: number;
+        duration_ms: number;
+        value_x?: number | undefined;
+        value_y?: number | undefined;
+        value_z?: number | undefined;
+    } | {
+        type: "capture";
+        name: string;
+        delay_ms: number;
+    } | {
+        type: "console";
+        command: string;
+        delay_ms: number;
+    } | {
+        type: "input_tape";
+        values: (number | [number, number] | [number, number, number])[];
+        action: string;
+        delay_ms: number;
+    } | {
+        type: "mark";
+        label: string;
+        delay_ms: number;
+    })[];
+    sample_hz: number;
+    rng_seed: number;
+    settle_ms: number;
+    source_recording_id?: string | undefined;
+}>;
+export type Sequence = z.infer<typeof Sequence>;
+export declare const DriftFrameEntry: z.ZodObject<{
+    frame: z.ZodNumber;
+    position_delta_cm: z.ZodNumber;
+    velocity_delta_cms: z.ZodNumber;
+    rotation_delta_deg: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    frame: number;
+    position_delta_cm: number;
+    velocity_delta_cms: number;
+    rotation_delta_deg: number;
+}, {
+    frame: number;
+    position_delta_cm: number;
+    velocity_delta_cms: number;
+    rotation_delta_deg: number;
+}>;
+export type DriftFrameEntry = z.infer<typeof DriftFrameEntry>;
+export declare const DriftReport: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    source_recording_id: z.ZodString;
+    replay_started_at: z.ZodString;
+    frames_compared: z.ZodNumber;
+    frames_missing_in_replay: z.ZodNumber;
+    max_position_drift_cm: z.ZodNumber;
+    max_position_drift_frame: z.ZodNumber;
+    max_velocity_drift_cms: z.ZodNumber;
+    max_rotation_drift_deg: z.ZodNumber;
+    montage_section_mismatches: z.ZodNumber;
+    tracked_value_max_deltas: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    frames_over_threshold: z.ZodArray<z.ZodObject<{
+        frame: z.ZodNumber;
+        position_delta_cm: z.ZodNumber;
+        velocity_delta_cms: z.ZodNumber;
+        rotation_delta_deg: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        frame: number;
+        position_delta_cm: number;
+        velocity_delta_cms: number;
+        rotation_delta_deg: number;
+    }, {
+        frame: number;
+        position_delta_cm: number;
+        velocity_delta_cms: number;
+        rotation_delta_deg: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    source_recording_id: string;
+    replay_started_at: string;
+    frames_compared: number;
+    frames_missing_in_replay: number;
+    max_position_drift_cm: number;
+    max_position_drift_frame: number;
+    max_velocity_drift_cms: number;
+    max_rotation_drift_deg: number;
+    montage_section_mismatches: number;
+    tracked_value_max_deltas: Record<string, number>;
+    frames_over_threshold: {
+        frame: number;
+        position_delta_cm: number;
+        velocity_delta_cms: number;
+        rotation_delta_deg: number;
+    }[];
+}, {
+    version: 1;
+    source_recording_id: string;
+    replay_started_at: string;
+    frames_compared: number;
+    frames_missing_in_replay: number;
+    max_position_drift_cm: number;
+    max_position_drift_frame: number;
+    max_velocity_drift_cms: number;
+    max_rotation_drift_deg: number;
+    montage_section_mismatches: number;
+    tracked_value_max_deltas: Record<string, number>;
+    frames_over_threshold: {
+        frame: number;
+        position_delta_cm: number;
+        velocity_delta_cms: number;
+        rotation_delta_deg: number;
+    }[];
+}>;
+export type DriftReport = z.infer<typeof DriftReport>;