@godot-mcp/protocol 0.0.0 → 0.1.0

package/dist/runtimeDebug.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { RuntimeHandleSchema } from "./runtimeShared.js";
+const opaqueToken = (prefix) => z.string().regex(new RegExp(`^${prefix}_[A-Za-z0-9_-]{43}$`));
+export const DebugFrameTokenSchema = opaqueToken("dft");
+export const DebugVariableTokenSchema = opaqueToken("dvt");
+export const DebugStopResultSchema = z
+    .object({
+    sequence: z.number().int().min(1),
+    reason: z.enum(["breakpoint", "exception", "step", "pause", "unknown"]),
+})
+    .strict();
+const DebugSourcePathSchema = z
+    .string()
+    .min(9)
+    .max(512)
+    .startsWith("res://")
+    .endsWith(".gd")
+    .refine((value) => {
+    if (value.includes("\0") || value.includes("\\"))
+        return false;
+    const segments = value.slice(6).split("/");
+    if (segments.some((segment) => segment.length === 0 || segment === "." || segment === ".."))
+        return false;
+    return !value.toLowerCase().startsWith("res://addons/godot_mcp/");
+}, { message: "Debugger source must be a canonical project-local GDScript outside the Godot MCP addon" });
+const RuntimeBreakpointSchema = z
+    .object({
+    sourcePath: DebugSourcePathSchema,
+    line: z.number().int().min(1).max(1_000_000),
+})
+    .strict();
+const BreakpointsSetSchema = z
+    .object({
+    operation: z.literal("debug_breakpoints_set"),
+    handle: RuntimeHandleSchema,
+    breakpoints: z.array(RuntimeBreakpointSchema).max(64),
+})
+    .strict()
+    .refine((input) => new Set(input.breakpoints.map((entry) => entry.sourcePath)).size <= 16, {
+    message: "Debugger requests may target at most 16 source files",
+})
+    .refine((input) => {
+    const identities = input.breakpoints.map((entry) => `${entry.sourcePath}:${entry.line}`);
+    return new Set(identities).size === identities.length;
+}, { message: "Debugger breakpoints must be unique" });
+const DebugHandleOperationSchema = (operation) => z.object({ operation: z.literal(operation), handle: RuntimeHandleSchema }).strict();
+const PageSchema = {
+    offset: z.number().int().min(0).max(2_048).default(0),
+    limit: z.number().int().min(1).max(256).default(100),
+};
+const DebugWatchSegmentSchema = z.union([
+    z.string().min(1).max(128).refine((value) => !value.includes("\0")),
+    z.number().int().min(0).max(1_000_000),
+]);
+const DebugWatchSelectorSchema = z
+    .object({
+    scope: z.enum(["locals", "members", "globals"]),
+    path: z.array(DebugWatchSegmentSchema).min(1).max(8),
+})
+    .strict();
+export const RuntimeDebugOperationInputSchema = z.discriminatedUnion("operation", [
+    BreakpointsSetSchema,
+    DebugHandleOperationSchema("debug_status"),
+    z
+        .object({
+        operation: z.literal("debug_wait"),
+        handle: RuntimeHandleSchema,
+        afterSequence: z.number().int().min(0).default(0),
+        timeoutMs: z.number().int().min(1).max(30_000).default(10_000),
+    })
+        .strict(),
+    DebugHandleOperationSchema("debug_pause"),
+    DebugHandleOperationSchema("debug_continue"),
+    DebugHandleOperationSchema("debug_step_over"),
+    DebugHandleOperationSchema("debug_step_into"),
+    z
+        .object({
+        operation: z.literal("debug_stack"),
+        handle: RuntimeHandleSchema,
+        offset: z.number().int().min(0).max(64).default(0),
+        limit: z.number().int().min(1).max(64).default(64),
+    })
+        .strict(),
+    z
+        .object({
+        operation: z.literal("debug_variables"),
+        handle: RuntimeHandleSchema,
+        ["frameToken"]: DebugFrameTokenSchema,
+        scope: z.enum(["locals", "members", "globals"]),
+        ...PageSchema,
+    })
+        .strict(),
+    z
+        .object({
+        operation: z.literal("debug_children"),
+        handle: RuntimeHandleSchema,
+        ["variableToken"]: DebugVariableTokenSchema,
+        ...PageSchema,
+    })
+        .strict(),
+    z
+        .object({
+        operation: z.literal("debug_watch"),
+        handle: RuntimeHandleSchema,
+        ["frameToken"]: DebugFrameTokenSchema,
+        selectors: z.array(DebugWatchSelectorSchema).min(1).max(32),
+    })
+        .strict(),
+]);
+export const RUNTIME_DEBUG_OPERATIONS = [
+    "debug_breakpoints_set",
+    "debug_status",
+    "debug_wait",
+    "debug_pause",
+    "debug_continue",
+    "debug_step_over",
+    "debug_step_into",
+    "debug_stack",
+    "debug_variables",
+    "debug_children",
+    "debug_watch",
+];
+//# sourceMappingURL=runtimeDebug.js.map

package/dist/runtimeDebug.js.map

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

package/dist/runtimePerformance.d.ts

@@ -0,0 +1,262 @@
+import { z } from "zod";
+export declare const ProfileJobTokenSchema: z.ZodString;
+export declare const MonitorGroupSchema: z.ZodEnum<{
+    custom: "custom";
+    frame: "frame";
+    memory: "memory";
+    objects: "objects";
+    rendering: "rendering";
+    physics: "physics";
+    audio: "audio";
+    navigation: "navigation";
+    pipeline: "pipeline";
+}>;
+export declare const RuntimePerformanceOperationInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operation: z.ZodLiteral<"monitor_snapshot">;
+    handle: z.ZodObject<{
+        runId: z.ZodUUID;
+        generation: z.ZodNumber;
+    }, z.core.$strict>;
+    groups: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        custom: "custom";
+        frame: "frame";
+        memory: "memory";
+        objects: "objects";
+        rendering: "rendering";
+        physics: "physics";
+        audio: "audio";
+        navigation: "navigation";
+        pipeline: "pipeline";
+    }>>>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"profile_start">;
+    handle: z.ZodObject<{
+        runId: z.ZodUUID;
+        generation: z.ZodNumber;
+    }, z.core.$strict>;
+    durationMs: z.ZodNumber;
+    intervalFrames: z.ZodNumber;
+    groups: z.ZodArray<z.ZodEnum<{
+        custom: "custom";
+        frame: "frame";
+        memory: "memory";
+        objects: "objects";
+        rendering: "rendering";
+        physics: "physics";
+        audio: "audio";
+        navigation: "navigation";
+        pipeline: "pipeline";
+    }>>;
+    retainRaw: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"profile_status">;
+    handle: z.ZodObject<{
+        runId: z.ZodUUID;
+        generation: z.ZodNumber;
+    }, z.core.$strict>;
+    jobToken: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"profile_cancel">;
+    handle: z.ZodObject<{
+        runId: z.ZodUUID;
+        generation: z.ZodNumber;
+    }, z.core.$strict>;
+    jobToken: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"profile_result">;
+    handle: z.ZodObject<{
+        runId: z.ZodUUID;
+        generation: z.ZodNumber;
+    }, z.core.$strict>;
+    jobToken: z.ZodString;
+}, z.core.$strict>], "operation">;
+export declare const MonitorSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    frame: z.ZodNumber;
+    monotonicUsec: z.ZodNumber;
+    engine: z.ZodObject<{
+        version: z.ZodString;
+        renderer: z.ZodString;
+        renderingMethod: z.ZodString;
+        graphicsApi: z.ZodString;
+    }, z.core.$strict>;
+    groups: z.ZodRecord<z.ZodEnum<{
+        custom: "custom";
+        frame: "frame";
+        memory: "memory";
+        objects: "objects";
+        rendering: "rendering";
+        physics: "physics";
+        audio: "audio";
+        navigation: "navigation";
+        pipeline: "pipeline";
+    }> & z.core.$partial, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    unavailable: z.ZodArray<z.ZodString>;
+    gpuTimestamps: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        supported: z.ZodLiteral<false>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        supported: z.ZodLiteral<true>;
+        deltasUsec: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strict>], "supported">;
+}, z.core.$strict>;
+export declare const ProfileEvidenceSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    jobToken: z.ZodString;
+    state: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    complete: z.ZodBoolean;
+    startedMonotonicUsec: z.ZodNumber;
+    finishedMonotonicUsec: z.ZodNumber;
+    startFrame: z.ZodNumber;
+    endFrame: z.ZodNumber;
+    requestedDurationMs: z.ZodNumber;
+    intervalFrames: z.ZodNumber;
+    observedSamples: z.ZodNumber;
+    retainedSamples: z.ZodNumber;
+    invalidSamples: z.ZodNumber;
+    droppedSamples: z.ZodNumber;
+    metricTruncation: z.ZodObject<{
+        truncated: z.ZodBoolean;
+        affectedSamples: z.ZodNumber;
+        maxDroppedMetricsPerSample: z.ZodNumber;
+        droppedGroups: z.ZodArray<z.ZodEnum<{
+            custom: "custom";
+            frame: "frame";
+            memory: "memory";
+            objects: "objects";
+            rendering: "rendering";
+            physics: "physics";
+            audio: "audio";
+            navigation: "navigation";
+            pipeline: "pipeline";
+            profiler: "profiler";
+        }>>;
+    }, z.core.$strict>;
+    aggregates: z.ZodRecord<z.ZodString, z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        mean: z.ZodNumber;
+        p50: z.ZodNumber;
+        p95: z.ZodNumber;
+        p99: z.ZodNumber;
+    }, z.core.$strict>>;
+    rawSamples: z.ZodArray<z.ZodObject<{
+        frame: z.ZodNumber;
+        monotonicUsec: z.ZodNumber;
+        values: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strict>>;
+    engine: z.ZodObject<{
+        version: z.ZodString;
+        renderer: z.ZodString;
+        renderingMethod: z.ZodString;
+        graphicsApi: z.ZodString;
+    }, z.core.$strict>;
+    gpuTimestamps: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        supported: z.ZodLiteral<false>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        supported: z.ZodLiteral<true>;
+        deltasUsec: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strict>], "supported">;
+    terminalReason: z.ZodOptional<z.ZodString>;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+export declare const ProfileJobReceiptSchema: z.ZodObject<{
+    jobToken: z.ZodString;
+    state: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    progress: z.ZodNumber;
+    observedSamples: z.ZodNumber;
+    retainedSamples: z.ZodNumber;
+    terminalReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const ProfileResultSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        cancelled: "cancelled";
+    }>;
+    evidence: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        jobToken: z.ZodString;
+        state: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        complete: z.ZodBoolean;
+        startedMonotonicUsec: z.ZodNumber;
+        finishedMonotonicUsec: z.ZodNumber;
+        startFrame: z.ZodNumber;
+        endFrame: z.ZodNumber;
+        requestedDurationMs: z.ZodNumber;
+        intervalFrames: z.ZodNumber;
+        observedSamples: z.ZodNumber;
+        retainedSamples: z.ZodNumber;
+        invalidSamples: z.ZodNumber;
+        droppedSamples: z.ZodNumber;
+        metricTruncation: z.ZodObject<{
+            truncated: z.ZodBoolean;
+            affectedSamples: z.ZodNumber;
+            maxDroppedMetricsPerSample: z.ZodNumber;
+            droppedGroups: z.ZodArray<z.ZodEnum<{
+                custom: "custom";
+                frame: "frame";
+                memory: "memory";
+                objects: "objects";
+                rendering: "rendering";
+                physics: "physics";
+                audio: "audio";
+                navigation: "navigation";
+                pipeline: "pipeline";
+                profiler: "profiler";
+            }>>;
+        }, z.core.$strict>;
+        aggregates: z.ZodRecord<z.ZodString, z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            mean: z.ZodNumber;
+            p50: z.ZodNumber;
+            p95: z.ZodNumber;
+            p99: z.ZodNumber;
+        }, z.core.$strict>>;
+        rawSamples: z.ZodArray<z.ZodObject<{
+            frame: z.ZodNumber;
+            monotonicUsec: z.ZodNumber;
+            values: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, z.core.$strict>>;
+        engine: z.ZodObject<{
+            version: z.ZodString;
+            renderer: z.ZodString;
+            renderingMethod: z.ZodString;
+            graphicsApi: z.ZodString;
+        }, z.core.$strict>;
+        gpuTimestamps: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            supported: z.ZodLiteral<false>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            supported: z.ZodLiteral<true>;
+            deltasUsec: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strict>], "supported">;
+        terminalReason: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const RUNTIME_PERFORMANCE_OPERATIONS: readonly ["monitor_snapshot", "profile_start", "profile_status", "profile_cancel", "profile_result"];
+export type MonitorGroup = z.infer<typeof MonitorGroupSchema>;
+export type MonitorSnapshot = z.infer<typeof MonitorSnapshotSchema>;
+export type ProfileEvidence = z.infer<typeof ProfileEvidenceSchema>;
+export type ProfileJobReceipt = z.infer<typeof ProfileJobReceiptSchema>;
+export type ProfileResult = z.infer<typeof ProfileResultSchema>;
+type OpaqueProfileJob = z.infer<typeof ProfileJobTokenSchema>;
+export { type OpaqueProfileJob as ProfileJobToken };
+export type RuntimePerformanceOperationInput = z.infer<typeof RuntimePerformanceOperationInputSchema>;
+//# sourceMappingURL=runtimePerformance.d.ts.map

package/dist/runtimePerformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePerformance.d.ts","sourceRoot":"","sources":["../src/runtimePerformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB,aAA8C,CAAC;AAEjF,eAAO,MAAM,kBAAkB;;;;;;;;;;EAU7B,CAAC;AAiBH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAqBjD,CAAC;AAoBH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUvB,CAAC;AA0CZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiC9B,CAAC;AAEL,eAAO,MAAM,uBAAuB;;;;;;;;;;;;kBASzB,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM0F,CAAC;AAE3H,eAAO,MAAM,8BAA8B,sGAMjC,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC9D,OAAO,EAAE,KAAK,gBAAgB,IAAI,eAAe,EAAE,CAAC;AACpD,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC"}

package/dist/runtimePerformance.js

@@ -0,0 +1,165 @@
+import { z } from "zod";
+import { RuntimeHandleSchema } from "./runtimeShared.js";
+export const ProfileJobTokenSchema = z.string().regex(/^pjt_[A-Za-z0-9_-]{43}$/);
+export const MonitorGroupSchema = z.enum([
+    "frame",
+    "memory",
+    "objects",
+    "rendering",
+    "physics",
+    "audio",
+    "navigation",
+    "pipeline",
+    "custom",
+]);
+const ALL_MONITOR_GROUPS = MonitorGroupSchema.options;
+const MonitorGroupsSchema = z
+    .array(MonitorGroupSchema)
+    .min(1)
+    .max(9)
+    .refine((groups) => new Set(groups).size === groups.length, { message: "Monitor groups must be unique" });
+const ProfileGroupsSchema = z
+    .array(MonitorGroupSchema)
+    .min(1)
+    .max(8)
+    .refine((groups) => new Set(groups).size === groups.length, { message: "Monitor groups must be unique" });
+const ProfileJobOperationSchema = (operation) => z.object({ operation: z.literal(operation), handle: RuntimeHandleSchema, ["jobToken"]: ProfileJobTokenSchema }).strict();
+export const RuntimePerformanceOperationInputSchema = z.discriminatedUnion("operation", [
+    z
+        .object({
+        operation: z.literal("monitor_snapshot"),
+        handle: RuntimeHandleSchema,
+        groups: MonitorGroupsSchema.default(ALL_MONITOR_GROUPS),
+    })
+        .strict(),
+    z
+        .object({
+        operation: z.literal("profile_start"),
+        handle: RuntimeHandleSchema,
+        durationMs: z.number().int().min(100).max(30_000),
+        intervalFrames: z.number().int().min(1).max(120),
+        groups: ProfileGroupsSchema,
+        retainRaw: z.boolean().default(false),
+    })
+        .strict(),
+    ProfileJobOperationSchema("profile_status"),
+    ProfileJobOperationSchema("profile_cancel"),
+    ProfileJobOperationSchema("profile_result"),
+]);
+const EngineMetadataSchema = z
+    .object({
+    version: z.string().min(1).max(128),
+    renderer: z.string().min(1).max(128),
+    renderingMethod: z.string().min(1).max(128),
+    graphicsApi: z.string().min(1).max(128),
+})
+    .strict();
+const GpuTimestampsSchema = z.discriminatedUnion("supported", [
+    z.object({ supported: z.literal(false), reason: z.string().min(1).max(256).optional() }).strict(),
+    z.object({ supported: z.literal(true), deltasUsec: z.array(z.number().finite().min(0)).max(2_048) }).strict(),
+]);
+const MonitorValuesSchema = z
+    .record(z.string().min(1).max(128), z.number().finite())
+    .refine((values) => Object.keys(values).length <= 128, { message: "A monitor group may contain at most 128 values" });
+export const MonitorSnapshotSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    frame: z.number().int().min(0),
+    monotonicUsec: z.number().int().min(0),
+    engine: EngineMetadataSchema,
+    groups: z.partialRecord(MonitorGroupSchema, MonitorValuesSchema),
+    unavailable: z.array(z.string().min(1).max(256)).max(128),
+    gpuTimestamps: GpuTimestampsSchema,
+})
+    .strict();
+const ProfileAggregateSchema = z
+    .object({
+    min: z.number().finite(),
+    max: z.number().finite(),
+    mean: z.number().finite(),
+    p50: z.number().finite(),
+    p95: z.number().finite(),
+    p99: z.number().finite(),
+})
+    .strict();
+const FlattenedMetricNameSchema = z.string().min(1).max(139);
+const ProfileSampleSchema = z
+    .object({
+    frame: z.number().int().min(0),
+    monotonicUsec: z.number().int().min(0),
+    values: z.record(FlattenedMetricNameSchema, z.number().finite()),
+})
+    .strict();
+const ProfileMetricTruncationSchema = z
+    .object({
+    truncated: z.boolean(),
+    affectedSamples: z.number().int().min(0),
+    maxDroppedMetricsPerSample: z.number().int().min(0),
+    droppedGroups: z
+        .array(z.enum([...MonitorGroupSchema.options, "profiler"]))
+        .max(10)
+        .refine((groups) => new Set(groups).size === groups.length, { message: "Dropped metric groups must be unique" }),
+})
+    .strict()
+    .refine((value) => value.truncated
+    ? value.affectedSamples > 0 && value.maxDroppedMetricsPerSample > 0 && value.droppedGroups.length > 0
+    : value.affectedSamples === 0 && value.maxDroppedMetricsPerSample === 0 && value.droppedGroups.length === 0, { message: "Metric truncation metadata must match its truncation state" });
+export const ProfileEvidenceSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    ["jobToken"]: ProfileJobTokenSchema,
+    state: z.enum(["completed", "cancelled", "failed"]),
+    complete: z.boolean(),
+    startedMonotonicUsec: z.number().int().min(0),
+    finishedMonotonicUsec: z.number().int().min(0),
+    startFrame: z.number().int().min(0),
+    endFrame: z.number().int().min(0),
+    requestedDurationMs: z.number().int().min(100).max(30_000),
+    intervalFrames: z.number().int().min(1).max(120),
+    observedSamples: z.number().int().min(0),
+    retainedSamples: z.number().int().min(0).max(2_048),
+    invalidSamples: z.number().int().min(0),
+    droppedSamples: z.number().int().min(0),
+    metricTruncation: ProfileMetricTruncationSchema,
+    aggregates: z.record(FlattenedMetricNameSchema, ProfileAggregateSchema),
+    rawSamples: z.array(ProfileSampleSchema).max(2_048),
+    engine: EngineMetadataSchema,
+    gpuTimestamps: GpuTimestampsSchema,
+    terminalReason: z.string().min(1).max(256).optional(),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+})
+    .strict()
+    .refine((evidence) => evidence.finishedMonotonicUsec >= evidence.startedMonotonicUsec && evidence.endFrame >= evidence.startFrame, {
+    message: "Profile evidence must have monotonic time and frame bounds",
+})
+    .refine((evidence) => evidence.retainedSamples === evidence.rawSamples.length || evidence.rawSamples.length === 0, {
+    message: "Retained sample metadata must match included raw samples",
+})
+    .refine((evidence) => evidence.metricTruncation.affectedSamples <= evidence.observedSamples, {
+    message: "Metric truncation cannot affect more samples than were observed",
+});
+export const ProfileJobReceiptSchema = z
+    .object({
+    ["jobToken"]: ProfileJobTokenSchema,
+    state: z.enum(["running", "completed", "cancelled", "failed"]),
+    progress: z.number().finite().min(0).max(1),
+    observedSamples: z.number().int().min(0),
+    retainedSamples: z.number().int().min(0).max(2_048),
+    terminalReason: z.string().min(1).max(256).optional(),
+})
+    .strict();
+export const ProfileResultSchema = z
+    .object({
+    state: z.enum(["completed", "cancelled", "failed"]),
+    evidence: ProfileEvidenceSchema,
+})
+    .strict()
+    .refine((result) => result.state === result.evidence.state, { message: "Profile result state must match its evidence" });
+export const RUNTIME_PERFORMANCE_OPERATIONS = [
+    "monitor_snapshot",
+    "profile_start",
+    "profile_status",
+    "profile_cancel",
+    "profile_result",
+];
+//# sourceMappingURL=runtimePerformance.js.map

package/dist/runtimePerformance.js.map

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

package/dist/runtimeShared.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const RuntimeHandleSchema: z.ZodObject<{
+    runId: z.ZodUUID;
+    generation: z.ZodNumber;
+}, z.core.$strict>;
+export declare const RuntimeLaunchPinsSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    renderer: z.ZodEnum<{
+        gl_compatibility: "gl_compatibility";
+        mobile: "mobile";
+    }>;
+    locale: z.ZodString;
+    seed: z.ZodNumber;
+    fixedFps: z.ZodUnion<readonly [z.ZodLiteral<30>, z.ZodLiteral<60>, z.ZodLiteral<120>]>;
+}, z.core.$strict>;
+export type RuntimeHandle = z.infer<typeof RuntimeHandleSchema>;
+export type RuntimeLaunchPins = z.infer<typeof RuntimeLaunchPinsSchema>;
+//# sourceMappingURL=runtimeShared.d.ts.map

package/dist/runtimeShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShared.d.ts","sourceRoot":"","sources":["../src/runtimeShared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;kBAKrB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;;;;;kBASzB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/runtimeShared.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const RuntimeHandleSchema = z
+    .object({
+    runId: z.uuid(),
+    generation: z.number().int().min(1),
+})
+    .strict();
+export const RuntimeLaunchPinsSchema = z
+    .object({
+    width: z.number().int().min(1).max(2048),
+    height: z.number().int().min(1).max(2048),
+    renderer: z.enum(["gl_compatibility", "mobile"]),
+    locale: z.string().regex(/^[A-Za-z]{2,3}(?:_[A-Za-z]{2})?$/),
+    seed: z.number().int().min(-2_147_483_648).max(2_147_483_647),
+    fixedFps: z.union([z.literal(30), z.literal(60), z.literal(120)]),
+})
+    .strict();
+//# sourceMappingURL=runtimeShared.js.map

package/dist/runtimeShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeShared.js","sourceRoot":"","sources":["../src/runtimeShared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;CAClE,CAAC;KACD,MAAM,EAAE,CAAC"}