sbox-mcp-server 1.20.0 → 2.1.0

package/dist/tools/templates.js

@@ -89,7 +89,7 @@ export function registerTemplateTools(server, bridge) {
         };
     });
     // ── create_game_manager ───────────────────────────────────────────
-    server.tool("create_game_manager", "Generate a game manager script with configurable game loop features: score tracking, round timer, player spawning, and game state machine", {
+    server.tool("create_game_manager", "Generate a minimal game-manager Component: a static Instance singleton, [Property] MaxPlayers / GameState, and a Component.INetworkListener OnActive hook that logs player connects. Writes <name>.cs and returns { created, path, className }. NOTE: the includeScore/includeTimer/includeSpawning params are not currently applied — the same minimal manager is always generated (for richer game-loop scaffolds see create_round_phase_machine / create_objective_system / create_economy_wallet). Follow with trigger_hotload, then get_compile_errors, then place via add_component_to_new_object", {
         name: z
             .string()
             .optional()
@@ -101,15 +101,15 @@ export function registerTemplateTools(server, bridge) {
         includeScore: z
             .boolean()
             .optional()
-            .describe("Include score tracking. Defaults to true"),
+            .describe("Include score tracking (currently not applied by the handler)"),
         includeTimer: z
             .boolean()
             .optional()
-            .describe("Include round timer with countdown. Defaults to false"),
+            .describe("Include round timer with countdown (currently not applied by the handler)"),
         includeSpawning: z
             .boolean()
             .optional()
-            .describe("Include player spawning from prefab at spawn point. Defaults to false"),
+            .describe("Include player spawning from prefab at spawn point (currently not applied by the handler)"),
     }, async (params) => {
         const res = await bridge.send("create_game_manager", params);
         if (!res.success) {
@@ -120,7 +120,7 @@ export function registerTemplateTools(server, bridge) {
         };
     });
     // ── create_trigger_zone ───────────────────────────────────────────
-    server.tool("create_trigger_zone", "Generate a trigger zone script that detects when GameObjects enter/exit a collider volume. Supports teleport, damage, spawn, and log actions", {
+    server.tool("create_trigger_zone", "Generate a trigger-zone Component (Component.ITriggerListener): auto-adds a trigger BoxCollider on start, filters entrants by a TriggerTag [Property] (default 'player'), and logs enter/exit via private OnPlayerEnter/OnPlayerExit extension points you fill in. Writes <name>.cs and returns { created, path, className }. NOTE: the action/filterTag params are not currently applied at generation time — the zone always logs; implement teleport/damage/spawn in the generated methods (edit_script). Follow with trigger_hotload, then get_compile_errors", {
         name: z
             .string()
             .optional()
@@ -132,11 +132,11 @@ export function registerTemplateTools(server, bridge) {
         action: z
             .enum(["log", "teleport", "damage", "spawn"])
             .optional()
-            .describe("What happens on trigger: 'log' (print message), 'teleport' (move to destination), 'damage' (apply damage), 'spawn' (create prefab). Defaults to 'log'"),
+            .describe("What happens on trigger (currently not applied by the handler — the generated zone always logs; implement the effect in OnPlayerEnter yourself)"),
         filterTag: z
             .string()
             .optional()
-            .describe("Only trigger for objects with this tag. Defaults to 'player'"),
+            .describe("Only trigger for objects with this tag (currently not applied at generation — the generated TriggerTag [Property] defaults to 'player'; change it per-instance with set_property)"),
     }, async (params) => {
         const res = await bridge.send("create_trigger_zone", params);
         if (!res.success) {

package/dist/tools/ui.js

@@ -5,7 +5,7 @@ import { z } from "zod";
  */
 export function registerUITools(server, bridge) {
     // ── create_razor_ui ───────────────────────────────────────────────
-    server.tool("create_razor_ui", "Create a Razor UI component file (.razor) with optional SCSS stylesheet. Generates boilerplate for HUD, menu, or basic panel types", {
+    server.tool("create_razor_ui", "Create a Razor UI component file (.razor). Returns { created, path, componentName }; errors if the file already exists. NOTE: the current handler generates one fixed basic panel (a root div + label bound to a Title [Property]) from name+directory only — panelType/content/styles/includeStyles are not applied and no .scss is written; for custom markup or a PanelComponent you can host via add_screen_panel, write the files with write_file and check them with razor_lint. Follow with trigger_hotload, then get_compile_errors", {
         name: z
             .string()
             .describe("Component name (e.g. 'GameHud', 'MainMenu')"),
@@ -43,11 +43,11 @@ export function registerUITools(server, bridge) {
         };
     });
     // ── add_screen_panel ──────────────────────────────────────────────
-    server.tool("add_screen_panel", "Create a new GameObject with a ScreenPanel component for full-screen UI overlay (HUD, menus, etc.)", {
+    server.tool("add_screen_panel", "Create a new GameObject with a ScreenPanel component for full-screen UI overlay (HUD, menus, etc.). Returns { created, gameObject:{ id, name, components, ... } }. NOTE: panelComponent is looked up in the TypeLibrary and SILENTLY skipped if the type isn't loaded (freshly generated panels need trigger_hotload first) — check gameObject.components to confirm it attached", {
         name: z
             .string()
             .optional()
-            .describe("Name for the UI GameObject. Defaults to 'Screen UI'"),
+            .describe("Name for the UI GameObject. Defaults to 'Screen Panel'"),
         zIndex: z
             .number()
             .optional()
@@ -70,11 +70,11 @@ export function registerUITools(server, bridge) {
         };
     });
     // ── add_world_panel ───────────────────────────────────────────────
-    server.tool("add_world_panel", "Create a new GameObject with a WorldPanel component for in-world 3D UI (health bars, signs, nameplates)", {
+    server.tool("add_world_panel", "Create a new GameObject with a WorldPanel component for in-world 3D UI (health bars, signs, nameplates). Returns { created, gameObject:{ id, name, components, ... } }. As with add_screen_panel, panelComponent is SILENTLY skipped if the type isn't in the TypeLibrary (trigger_hotload first, then verify via gameObject.components). For CLICKABLE world UI the scene also needs a Sandbox.WorldInput (see create_worldpanel_ui)", {
         name: z
             .string()
             .optional()
-            .describe("Name for the UI GameObject. Defaults to 'World UI'"),
+            .describe("Name for the UI GameObject. Defaults to 'World Panel'"),
         position: z
             .union([
             z.object({ x: z.number(), y: z.number(), z: z.number() }),

package/dist/tools/uifeedback.js

@@ -34,7 +34,7 @@ export function registerUiFeedbackTools(server, bridge) {
         return { content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }] };
     });
     // ── create_proxy_nametag ──────────────────────────────────────────
-    server.tool("create_proxy_nametag", "Generate a sealed Component that floats the OWNER'S display name above a networked player. TextRenderer-based (not WorldPanel): a nametag is one short string with a distance fade, so a TextRenderer on a managed child object is far simpler than a WorldPanel + Razor + WorldInput stack — no UI assets, no panel host, per-frame alpha is a one-liner (mirrors create_floating_combat_text). Reads GameObject.Network.Owner.DisplayName (Owner and OwnerConnection are the same Connection on this SDK; falls back to the object name offline). Visibility is the INVERSE of the usual proxy guard: it renders only when GameObject.Network.IsProxy is true — i.e. on OTHER clients' copies of the player — so you never see a tag over your own head (offline / no networking => IsProxy false everywhere => no tags, expected). Spawns a CHILD GameObject for the text so billboarding never rotates the player model; cleaned up on disable. [Property] MaxDistance fades the tag out with distance, HeightOffset floats it above the head, FontSize sizes it. Attach to the ROOT of your networked player object. Pairs with create_networked_player (add it to the generated player prefab so every remote player is labeled).", {
+    server.tool("create_proxy_nametag", "Generate a sealed Component that floats the OWNER'S display name above a networked player. TextRenderer-based (not WorldPanel): a nametag is one short string with a distance fade, so a TextRenderer on a managed child object is far simpler than a WorldPanel + Razor + WorldInput stack — no UI assets, no panel host, per-frame alpha is a one-liner (mirrors create_floating_combat_text). Reads GameObject.Network.Owner.DisplayName (Owner and OwnerConnection are the same Connection on this SDK; falls back to the object name offline). Visibility is the INVERSE of the usual proxy guard: it renders only when GameObject.Network.IsProxy is true — i.e. on OTHER clients' copies of the player — so you never see a tag over your own head (offline / no networking => IsProxy false everywhere => no tags, expected). Spawns a CHILD GameObject for the text so billboarding never rotates the player model; cleaned up on disable. [Property] MaxDistance fades the tag out with distance, HeightOffset floats it above the head, FontSize sizes it. Attach to the ROOT of your networked player object. Pairs with create_networked_player (add it to the generated player prefab so every remote player is labeled). Returns { created, path, className, maxDistance, heightOffset, note, nextSteps }. Follow with trigger_hotload, then get_compile_errors, then attach via add_component_with_properties (component=className).", {
         name: z
             .string()
             .optional()

package/dist/tools/vehicles.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Vehicle tools (Batch 54): create_vehicle_controller, create_seat_system,
+ * tune_vehicle, create_physics_grab_tool — the corpus vehicles theme.
+ */
+export declare function registerVehicleTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=vehicles.d.ts.map

package/dist/tools/vehicles.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+/**
+ * Vehicle tools (Batch 54): create_vehicle_controller, create_seat_system,
+ * tune_vehicle, create_physics_grab_tool — the corpus vehicles theme.
+ */
+export function registerVehicleTools(server, bridge) {
+    // ── create_vehicle_controller ────────────────────────────────────
+    server.tool("create_vehicle_controller", "Generate a drivable raycast-car component: 4-corner spring/damper suspension, mass-scaled engine force, speed-scaled yaw steering, lateral grip (lower = drift), and a BUILT-IN driver seat (press E to enter — the driver is hidden while driving so their controller can't fight the vehicle transform, the host assigns them ownership, and a chase camera follows the car — E to exit). Attach it plus a Rigidbody and collider to any prop and it drives. Returns { created, path, className, nextSteps } — follow with trigger_hotload + compile_status, then batch_add_component the parts. Apply handling presets with tune_vehicle. HONEST LIMIT: compiles + runs is verified; driving FEEL needs a human playtest — tune from the inspector while playing", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'VehicleController' -> Code/VehicleController.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+        engineForce: z
+            .number()
+            .optional()
+            .describe("Engine force (mass-scaled). Default 900"),
+        steerStrength: z
+            .number()
+            .optional()
+            .describe("Yaw rate in rad/s at full speed factor. Default 2.0"),
+        grip: z
+            .number()
+            .optional()
+            .describe("Lateral grip 0-1 — fraction of sideways velocity killed per tick; lower = drift. Default 0.85"),
+    }, async (params) => {
+        const res = await bridge.send("create_vehicle_controller", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_seat_system ───────────────────────────────────────────
+    server.tool("create_seat_system", "Generate a standalone networked one-occupant seat component: press E (use) to sit — claims route through the host so seats can't be shared — E to stand; the occupant parents to the seat with their controller input disabled and restored on exit, which tries each ExitOffsets entry and takes the first spot with clearance. Static OnOccupantChanged event for camera/UI. For chairs, benches, turret mounts; vehicles get a seat built into create_vehicle_controller. Returns { created, path, className, nextSteps } — trigger_hotload + compile_status, then attach to any prop", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'Seat' -> Code/Seat.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+    }, async (params) => {
+        const res = await bridge.send("create_seat_system", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── tune_vehicle ─────────────────────────────────────────────────
+    server.tool("tune_vehicle", "Apply a handling preset to a vehicle component on a GameObject: arcade (forgiving), drift (low grip, sharp steering), offroad (soft long-travel suspension), or race (fast, planted). Sets EngineForce/MaxSpeed/SteerStrength/GripFactor/SuspensionStrength/SuspensionDamping by name via reflection — targets create_vehicle_controller scaffolds out of the box, partially tunes anything exposing those property names. Returns { tuned, preset, component, applied, missing } — missing lists properties the component lacks. Auto-finds the first component with 'Vehicle' in its type name; pass component to target explicitly. Scene-mutating: refused during play mode (use set_property on runtime objects while playing)", {
+        id: z
+            .string()
+            .describe("GUID of the GameObject carrying the vehicle component (from find_objects)"),
+        preset: z
+            .enum(["arcade", "drift", "offroad", "race"])
+            .describe("Handling preset to apply"),
+        component: z
+            .string()
+            .optional()
+            .describe("Component type name to tune. Default: first component with 'Vehicle' in its name"),
+    }, async (params) => {
+        const res = await bridge.send("tune_vehicle", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_physics_grab_tool ─────────────────────────────────────
+    server.tool("create_physics_grab_tool", "Generate a physgun-lite player component: hold attack2 while looking at a Rigidbody prop within Range to grab it — it spring-follows a point in front of your view with physics LIVE (collides and swings, unlike the parented create_carry_system) — attack1 throws it, release lets go. Grab requests route through the host, which assigns the grabber network ownership. Returns { created, path, className, nextSteps } — trigger_hotload + compile_status, attach to the player object; ensure_input_action if attack1/attack2 aren't bound", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'PhysicsGrabTool' -> Code/PhysicsGrabTool.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+    }, async (params) => {
+        const res = await bridge.send("create_physics_grab_tool", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=vehicles.js.map

package/dist/tools/visuals.js

@@ -72,7 +72,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── set_fog ────────────────────────────────────────────────────────
-    server.tool("set_fog", "Add or update fog in the active scene. Types: 'gradient' (distance haze — great for mood/horror), 'cubemap' (sky-tinted distance fog), 'volumetric' (a localized fog volume). Re-running on the same target updates it rather than duplicating.", {
+    server.tool("set_fog", "Add or update fog in the active scene. Types: 'gradient' (distance haze — great for mood/horror), 'cubemap' (sky-tinted distance fog), 'volumetric' (a localized fog volume). Re-running with the same targetId updates it rather than duplicating; without targetId each call creates a new fog object. Returns { created, type, gameObject } — gameObject.id addresses the fog object for later set_property/delete_gameobject; screenshot to verify the look.", {
         type: z
             .enum(["gradient", "cubemap", "volumetric"])
             .optional()
@@ -127,7 +127,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── set_skybox ───────────────────────────────────────────────────────
-    server.tool("set_skybox", "Set the scene's 2D skybox tint / indirect lighting (re-uses an existing SkyBox2D or creates one). Darken the tint for night/dusk. Optionally point it at a .vmat sky material.", {
+    server.tool("set_skybox", "Set the scene's 2D skybox tint / indirect lighting (re-uses an existing SkyBox2D or creates one). Darken the tint for night/dusk. Optionally point it at a .vmat sky material (silently kept as-is if the material fails to load). Returns { created, gameObject } — gameObject.id is the sky object; screenshot to verify the change.", {
         tint: ColorSchema.optional().describe("Sky tint colour"),
         indirectLighting: z
             .boolean()
@@ -145,7 +145,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── apply_atmosphere (preset) ─────────────────────────────────────────
-    server.tool("apply_atmosphere", "One-call scene mood: composes ambient + directional light, gradient fog, and a camera post-fx stack (tonemap + colour grade + vignette) tuned for the chosen mood. Idempotent — re-runs update the same 'Atmosphere *' objects.", {
+    server.tool("apply_atmosphere", "One-call scene mood: composes ambient + directional light, gradient fog, and a camera post-fx stack (tonemap + colour grade + vignette) tuned for the chosen mood. Idempotent — re-runs update the same 'Atmosphere *' objects. Returns { applied, mood, components, postFxCamera } — the post-fx stack is only applied when a camera exists (postFxCamera is null otherwise; add a camera and re-run). Screenshot to verify.", {
         mood: z
             .enum(["horror-night", "foggy-dawn", "overcast", "warm-interior"])
             .describe("Atmosphere preset"),
@@ -159,7 +159,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── apply_post_fx_look (preset) ───────────────────────────────────────
-    server.tool("apply_post_fx_look", "Apply just a camera post-processing look (no lights/fog): cinematic (tonemap + bloom + soft vignette), filmic-horror (desaturated, high-contrast, heavy vignette, film grain), or clean (tonemap only).", {
+    server.tool("apply_post_fx_look", "Apply just a camera post-processing look (no lights/fog): cinematic (tonemap + bloom + soft vignette), filmic-horror (desaturated, high-contrast, heavy vignette, film grain), or clean (tonemap only). Errors if the scene has no CameraComponent. Returns { applied, look, components, camera } listing the effect components added to the main camera — tune them individually afterwards with add_post_process.", {
         look: z
             .enum(["cinematic", "filmic-horror", "clean"])
             .describe("Post-fx look preset"),
@@ -173,7 +173,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── add_envmap_probe ─────────────────────────────────────────────────
-    server.tool("add_envmap_probe", "Add an environment reflection/ambient probe (EnvmapProbe) at a position with a cubic influence volume — captures local reflections and indirect light for nearby surfaces.", {
+    server.tool("add_envmap_probe", "Add an environment reflection/ambient probe (EnvmapProbe) at a position with a cubic influence volume — captures local reflections and indirect light for nearby surfaces. IMPORTANT: a placed probe captures NOTHING until baked — follow with bake_reflections. Returns { created, gameObject } — gameObject.id is the probe object's GUID.", {
         name: z.string().optional().describe("GameObject name"),
         position: Vector3Schema.optional().describe("World position (centre of the probe)"),
         size: z.number().optional().describe("Cubic influence size in units (default 1024)"),
@@ -192,7 +192,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── spawn_particle (Batch 18: VFX) ───────────────────────────────────
-    server.tool("spawn_particle", "Spawn an additive particle effect (no texture asset needed): kind = fire (rising flame), embers (slow drifting glow), or sparks (a one-shot burst). Renders as tinted glowing dots — great for campfires, torches, and impacts. (smoke needs a soft sprite; not in v1.)", {
+    server.tool("spawn_particle", "EXPERIMENTAL — build an additive runtime ParticleEffect (no texture asset needed): kind = fire, embers, sparks, magic, dust, blood, or snow ('smoke' returns an error). Returns { created, kind, gameObject } — the component graph is created, but this runtime particle path has NOT been verified to render through the bridge; for particles you can actually see, prefer spawn_vpcf.", {
         kind: z
             .enum(["fire", "embers", "sparks", "magic", "dust", "blood", "snow"])
             .describe("Particle preset"),
@@ -226,7 +226,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── add_beam ─────────────────────────────────────────────────────────
-    server.tool("add_beam", "Create an energy/laser beam (BeamEffect) from a position to a target point — additive, tintable. Good for lasers, tracers, magic beams.", {
+    server.tool("add_beam", "EXPERIMENTAL — create an energy/laser beam (BeamEffect) from a position to a target point (default: 128u straight up) — additive, tintable. Returns { created, gameObject } — gameObject.id is the beam object's GUID. Like the other runtime particle tools, rendering through the bridge is unverified; use spawn_vpcf when you need a guaranteed-visible effect.", {
         position: Vector3Schema.optional().describe("Beam start (world position of the beam object)"),
         target: Vector3Schema.optional().describe("Beam end point in world space (default: 128u up)"),
         width: z.number().optional().describe("Beam width/scale (default 4)"),
@@ -286,7 +286,7 @@ export function registerVisualTools(server, bridge) {
         };
     });
     // ── bake_reflections ────────────────────────────────────────────────
-    server.tool("bake_reflections", "Bake all EnvmapProbe reflection probes in the scene (EnvmapProbe.BakeAll) so they actually capture their surroundings — placing a probe with add_envmap_probe does nothing visible until it's baked. This is a real editor compute step, not a component setter. Runs async; re-screenshot after a moment to see reflections appear on shiny surfaces.", {}, async (params) => {
+    server.tool("bake_reflections", "Bake all EnvmapProbe reflection probes in the scene (EnvmapProbe.BakeAll) so they actually capture their surroundings — placing a probe with add_envmap_probe does nothing visible until it's baked. This is a real editor compute step, not a component setter. Runs async — returns { baking, count, note, probes } immediately (each probe: id, name, mode, hasBaked), or { baked: false, count: 0 } when the scene has no probes; re-screenshot after a moment to see reflections appear.", {}, async (params) => {
         const res = await bridge.send("bake_reflections", params);
         if (!res.success) {
             return { content: [{ type: "text", text: `Error: ${res.error}` }] };

package/dist/tools/workflow.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeClient } from "../transport/bridge-client.js";
+/**
+ * Workflow tools (Batch 53): scene checkpoints (the agent-side undo safety net),
+ * describe_scene orientation, and the team-assigner / idle-income scaffolds.
+ */
+export declare function registerWorkflowTools(server: McpServer, bridge: BridgeClient): void;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/tools/workflow.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+/**
+ * Workflow tools (Batch 53): scene checkpoints (the agent-side undo safety net),
+ * describe_scene orientation, and the team-assigner / idle-income scaffolds.
+ */
+export function registerWorkflowTools(server, bridge) {
+    // ── checkpoint_scene ─────────────────────────────────────────────
+    server.tool("checkpoint_scene", "Snapshot the ENTIRE open scene (every root GameObject, full serialization) to temp storage OUTSIDE the project. The agent-side undo: checkpoint before risky batch edits or experimental changes, roll back with restore_checkpoint if they go wrong. Returns { checkpointed, id, label, scene, rootObjects, sizeBytes } — keep the id. Refused during play mode (runtime state would poison the snapshot). Snapshots survive editor restarts (temp dir, subject to OS cleanup); browse them with list_checkpoints", {
+        label: z
+            .string()
+            .optional()
+            .describe("Short label baked into the checkpoint id (e.g. 'before-batch-tint'). Defaults to 'checkpoint'"),
+    }, async (params) => {
+        const res = await bridge.send("checkpoint_scene", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── restore_checkpoint ───────────────────────────────────────────
+    server.tool("restore_checkpoint", "REPLACE the open scene's entire contents with a checkpoint_scene snapshot: destroys every current root object, then rebuilds the snapshot's tree (guids preserved, so internal references stay wired). DESTRUCTIVE — requires an explicit id (from checkpoint_scene or list_checkpoints), never guesses. Returns { restored, id, destroyedRoots, restoredRoots }. The scene FILE on disk is untouched until save_scene. Scene-mutating: refused during play mode", {
+        id: z
+            .string()
+            .describe("Checkpoint id to restore (e.g. 'cp_20260709_153000_before-batch-tint')"),
+    }, async (params) => {
+        const res = await bridge.send("restore_checkpoint", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── list_checkpoints ─────────────────────────────────────────────
+    server.tool("list_checkpoints", "List this project's scene checkpoints (newest first). Returns { total, checkpoints } — each { id, createdUtc, sizeBytes }. Pass an id to restore_checkpoint to roll the scene back, or create one first with checkpoint_scene. Read-only; no limit (checkpoints are few)", {}, async (params) => {
+        const res = await bridge.send("list_checkpoints", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── describe_scene ───────────────────────────────────────────────
+    server.tool("describe_scene", "One-call orientation for the OPEN scene (works in edit and play mode): total/root object counts, component histogram (top 20 types), every camera with position, light count, tag histogram (top 12), and the aggregate world bounds of renderable content. Returns a structured summary — orient here, then find_objects by component/tag, get_scene_hierarchy for structure, find_broken_references for health, screenshot_orbit to look at something. Complements describe_project (project-level). Read-only", {}, async (params) => {
+        const res = await bridge.send("describe_scene", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_team_assigner ─────────────────────────────────────────
+    server.tool("create_team_assigner", "Generate a host-authoritative balanced team assigner component (smallest-bucket draft): AssignSmallest(steamId) drops a joining player into the emptiest team, announces via [Rpc.Broadcast] so every client's roster agrees, and fires static OnTeamAssigned(steamId, index, name); plus Rebalance(), GetTeam, GetMembers. Writes a .cs file and returns { created, path, className, teams, nextSteps } — follow with trigger_hotload + compile_status, attach to your game manager, call AssignSmallest from your join hook (e.g. INetworkListener.OnActive)", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'TeamAssigner' -> Code/TeamAssigner.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+        teams: z
+            .array(z.string())
+            .optional()
+            .describe('Team names in index order. Default ["Red", "Blue"]'),
+    }, async (params) => {
+        const res = await bridge.send("create_team_assigner", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+    // ── create_idle_income ───────────────────────────────────────────
+    server.tool("create_idle_income", "Generate a host-authoritative passive income component: every tickSeconds the host grants incomePerTick × Multiplier, auto-wiring the first sibling component with an AddMoney(int) method (a create_economy_wallet scaffold plugs in with zero code) or an overridable Grant() seam; TotalEarned is [Sync(FromHost)] and static OnIncomeTick fires per grant. The idle-game kit: wallet (create_economy_wallet) + this + create_offline_progress. Writes a .cs file and returns { created, path, className, nextSteps } — follow with trigger_hotload + compile_status", {
+        name: z
+            .string()
+            .optional()
+            .describe("Class/file name (default 'IdleIncome' -> Code/IdleIncome.cs). Errors if the file exists"),
+        directory: z
+            .string()
+            .optional()
+            .describe("Directory for the .cs file. Default 'Code'"),
+        incomePerTick: z
+            .number()
+            .optional()
+            .describe("Amount granted per tick. Default 1"),
+        tickSeconds: z
+            .number()
+            .optional()
+            .describe("Seconds between grants. Default 1"),
+    }, async (params) => {
+        const res = await bridge.send("create_idle_income", params);
+        if (!res.success) {
+            return { content: [{ type: "text", text: `Error: ${res.error}` }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=workflow.js.map