summer-engine 3.6.0 → 3.8.0

package/registry/generated/index.json

@@ -148,7 +148,7 @@
       "id": "reference/mcp-tools-reference",
       "kind": "reference",
       "version": "1.4.1",
-      "content_hash": "87742ed2af1190af6d5bda79b4fe0cde1973fcd74c0cd4a5763e1bdcc23b4fb9",
+      "content_hash": "572d526eaf371d4790fa52e050fe8d779ef26bd86af5677775f9a1814a1ab372",
       "summary": "Canonical reference for which Summer MCP tool to call — skills should reference tool names exactly as written here.",
       "use_when": [
         "choosing between Summer MCP tools and host tools for an operation",
@@ -2828,7 +2828,7 @@
       "id": "skill/publish-your-game",
       "kind": "skill",
       "version": "1.0.0",
-      "content_hash": "0328c6d71f662059cc2514864e005c2e71cf90811553ef2a2ecabbbf9cb4305f",
+      "content_hash": "c2ed78b67c43fbcea5792ec31b97daff0ded3e0fe63e8d676ecdc8da7527de4d",
       "summary": "Publish a Summer game on Summer Games through MCP: store page, art, build upload, submit, and one approval link for the owner.",
       "use_when": [
         "the user says 'publish my game', 'put it on summer.games', 'launch it on the store' or 'submit it for review'",
@@ -3440,7 +3440,7 @@
       "id": "skill/sound-effect",
       "kind": "skill",
       "version": "1.1.0",
-      "content_hash": "4ea1cf55a48cf8e4670018c9a7b858e970acb3852b3e0023bade97e408c8eb08",
+      "content_hash": "a02073249416a329b4d40848af7d5ba7df9b294d9bf7e9a4d856a6af846f2aad",
       "summary": "Make SFX one-shots and timed sequences (swings, hits, whooshes, reloads, UI) - offer three model versions to pick from, then wire them as AudioStreamPlayers.",
       "use_when": [
         "generating short SFX one-shots — footsteps, weapon swings, UI clicks, hit impacts, environmental cues",
@@ -3686,6 +3686,83 @@
       "status": "preview",
       "recommended": false
     },
+    {
+      "id": "skill/summer-apps",
+      "kind": "skill",
+      "version": "0.1.0",
+      "content_hash": "9f6a38561db1bd8be5e63032d81de52dae805e19426f0027064a6eb6126b4177",
+      "summary": "Build a Summer App, a team tool inside Summer Studio (balance table, quest editor, tracker, pick grid): build loop, Layout vs code, data as API, agent tools.",
+      "use_when": [
+        "the person asks for a tool for their team (\"build us a loot balance tool\", \"a board to track creatures\")",
+        "the person needs a UI to decide, rate or edit something they will come back to",
+        "reading or changing the data of an existing Summer App",
+        "calling an app's agent tools or waiting for what an app sends"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui",
+          "agent-workflow"
+        ],
+        "modalities": [
+          "ui",
+          "docs"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps-design"
+        ],
+        "tools": [
+          "tool/app-guide",
+          "tool/app-create",
+          "tool/app-publish",
+          "tool/app-events",
+          "tool/app-data",
+          "tool/app-call",
+          "tool/app-dock"
+        ]
+      },
+      "status": "preview",
+      "recommended": true
+    },
+    {
+      "id": "skill/summer-apps-design",
+      "kind": "skill",
+      "version": "0.1.0",
+      "content_hash": "7176fc0bf683de75bf3231a873e240417ff91f1e864ca3c5670c54dc4c3d77c4",
+      "summary": "How a Summer App should look - page layout, Summer UI kit components, tables, charts, media, boards, states and a pre-ship checklist.",
+      "use_when": [
+        "building or changing the UI of a Summer App (agent-built team tool inside Summer Studio)",
+        "an app looks generic, cluttered or off-brand",
+        "choosing layout for a table, chart, board, pick grid or settings tool"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "ui",
+          "tools"
+        ],
+        "modalities": [
+          "docs"
+        ]
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "recommended": true
+    },
     {
       "id": "skill/summer-friends",
       "kind": "skill",
@@ -4298,7 +4375,7 @@
       "id": "skill/using-summer",
       "kind": "skill",
       "version": "1.0.5",
-      "content_hash": "8051cc6e1cc6135796ba91daf32d205ddbbef202a80fddabf8623a1dcbb1914e",
+      "content_hash": "414b8174a55788c3eb3588ef02017bcba4b9c01b6bd59e776e547dbb11e472ea",
       "summary": "Session bootstrap for Summer projects — establishes how to find and use Summer skills and the summer-engine MCP before any response.",
       "use_when": [
         "starting any conversation in a Summer Engine project",
@@ -5578,199 +5655,187 @@
       }
     },
     {
-      "id": "tool/attach-to-surface",
+      "id": "tool/app-call",
       "kind": "tool",
       "version": "1.0.0",
-      "content_hash": "e2207bbdab1a86f499382d89314fc48ea501080d814f15ffdfb9d06b47f047db",
-      "summary": "Mount a piece on a wall, ceiling or floor — turn its measured back into the surface found by a ray, keep it upright, seat it at a standoff. Saves the scene.",
+      "content_hash": "489fb7d31ffe77b2ec9e403b7c51f2c2f1e486274e7e488797490209bab57ab2",
+      "summary": "Run one of a Summer App's agent tools inside the person's open app.",
       "use_when": [
-        "mounting a downpipe, gutter, lamp, AC unit, sign or fire escape on a facade",
-        "turning a piece so its back faces a wall instead of guessing its rotation",
-        "seating a piece against a surface at an exact standoff"
+        "\"nerf the bow using the balance formula in our app\"",
+        "using logic that lives in an app (a balance formula, an export) while the app is open"
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "scenes",
-          "3d",
-          "world-building",
-          "level-design"
-        ],
-        "modalities": [
-          "scenes"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
       "related": {
-        "tools": [
-          "tool/raycast",
-          "tool/snap-to-surface",
-          "tool/inspect-asset",
-          "tool/starcast"
-        ],
         "skills": [
-          "skill/spatial-placement"
+          "skill/summer-apps"
         ]
       },
       "status": "preview",
-      "mcp_tool_name": "summer_attach_to_surface",
-      "remote": false,
+      "mcp_tool_name": "summer_app_call",
+      "remote": true,
       "authority": {
-        "filesystem": true,
-        "editor_mutation": true,
-        "network": false,
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/batch",
+      "id": "tool/app-create",
       "kind": "tool",
-      "version": "1.1.0",
-      "content_hash": "ec6fa446a214a15c5562061ba0f39072f698ea69243e4326e4931683bc62f286",
-      "summary": "Run engine ops in one call, verbatim; one undo step unless single-only ops split it. ReparentNode keeps and verifies its subtree; raw ConnectSignal is refused.",
+      "version": "1.0.0",
+      "content_hash": "a9ca4527c4397e449e88bc5b058353821b75dd3368a26e031ec2cc0b02736efb",
+      "summary": "Create a new scratch Summer App (a tool for the person's team inside Summer Studio) and open it in their Studio tab.",
       "use_when": [
-        "multi-node builds that should undo as one step (no single-only ops in the list)",
-        "reaching engine ops that have no dedicated tool",
-        "placing many kit pieces, one InstantiateScene op per piece with its position and rotation, read back with receipt summary"
+        "\"build me a tool for…\" / \"make an app that…\"",
+        "the person needs a UI to decide or edit something they will come back to"
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "scenes",
-          "editor"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
-      "mcp_tool_name": "summer_batch",
-      "remote": false,
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_create",
+      "remote": true,
       "authority": {
-        "filesystem": true,
-        "editor_mutation": true,
-        "network": false,
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/camera-bookmark",
+      "id": "tool/app-data",
       "kind": "tool",
       "version": "1.0.0",
-      "content_hash": "42c4dfe31c6634c1b583a8e831a040d3d4b5b6bbdfe97ed71a2d7810a5b39891",
-      "summary": "Save, list, or delete named camera viewpoints stored in the project, so before/after screenshots are taken from exactly the same pose.",
+      "content_hash": "4d2652bfdfa8d9f347ac91d0c4f7244a7babc62ad675e7b38125986c47d79509",
+      "summary": "Read or write a Summer App's shared data collections; works with no app open and the team sees writes live.",
       "use_when": [
-        "\"save this camera angle\" / \"remember this viewpoint\" so later screenshots line up with it",
-        "comparing a scene before and after a change from one fixed, repeatable camera pose",
-        "listing or removing the saved viewpoints of a project"
+        "\"nerf the bow in our balance sheet\"",
+        "seeding an app with data",
+        "reading what the team entered in an app"
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "verification",
-          "scenes"
-        ],
-        "modalities": [
-          "scenes"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
       "related": {
-        "tools": [
-          "tool/screenshot",
-          "tool/world-snapshot",
-          "tool/snapshot-diff"
-        ],
         "skills": [
-          "skill/verifying-scenes",
-          "skill/scene-scripting"
+          "skill/summer-apps"
         ]
       },
       "status": "preview",
-      "mcp_tool_name": "summer_camera_bookmark",
-      "remote": false,
+      "mcp_tool_name": "summer_app_data",
+      "remote": true,
       "authority": {
-        "filesystem": true,
+        "filesystem": false,
         "editor_mutation": false,
-        "network": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/capture-gameplay",
+      "id": "tool/app-dock",
       "kind": "tool",
       "version": "1.0.0",
-      "content_hash": "7195fee358600665d2b1e0ec40eeb68a7c517e775f5cc4a366259bceba07cd03",
-      "summary": "Capture real gameplay PNGs (HUD included) offscreen without a running editor; game flags and player steps (press, key, click) get past the title screen.",
+      "content_hash": "57cb8039759a799b9ef3c0019c620c5f072d78987d69bd7d089a29655893c676",
+      "summary": "Dock a Summer App as a panel in the running Summer Engine editor, close it, or list docked apps.",
       "use_when": [
-        "\"take gameplay screenshots for my store page\"",
-        "\"I need screenshots but the editor is not open\"",
-        "\"capture a 1920x1080 frame of my game\"",
-        "collecting real gameplay screenshots for summer_store_set_art desktop.screenshots or mobile.screenshots",
-        "every capture shows the title screen — pass the game's flags in args or steps like press Play"
+        "\"put the quest editor next to my scene\"",
+        "keeping a team tool open while editing"
       ],
       "facets": {
         "lifecycle": [
-          "launch",
           "build"
         ],
         "domains": [
-          "creator",
-          "headless"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
       "status": "preview",
-      "mcp_tool_name": "summer_capture_gameplay",
-      "remote": true,
+      "mcp_tool_name": "summer_app_dock",
+      "remote": false,
       "authority": {
-        "filesystem": true,
-        "editor_mutation": false,
+        "filesystem": false,
+        "editor_mutation": true,
         "network": false,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/check-job",
+      "id": "tool/app-events",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "a17e889099781c54902facf3abcbbdd8c10c0018333fdceb40d48f24dc01f183",
-      "summary": "Check the status of an async generation job by id.",
+      "version": "1.0.0",
+      "content_hash": "08baf882083352c40ab71d36b4f51aaa50754c72b9eb6386ab7993d62494f42a",
+      "summary": "Wait for what a Summer App sends to agents: summer.agent.send events, app errors, feedback and tool calls.",
       "use_when": [
-        "a generation ran without waiting, or timed out, and needs re-checking",
-        "\"is my 3D model / video done yet?\"",
-        "a generate_* call returned a job id instead of a finished asset"
+        "waiting for the person to act in an app you built",
+        "checking an app for errors after publishing"
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "generate",
-          "pipeline"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
-      "mcp_tool_name": "summer_check_job",
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_events",
       "remote": true,
       "authority": {
         "filesystem": false,
@@ -5781,130 +5846,564 @@
       }
     },
     {
-      "id": "tool/clear-console",
+      "id": "tool/app-get",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "5d96c1b758bcb0521a2ba2f291fc5b3929487df9222b735238eb97d7a645077c",
-      "summary": "Clear the editor's Output panel for a clean slate before running the game.",
+      "version": "1.0.0",
+      "content_hash": "1aea5d5dde2b779c32fd9525cfd349e8afaacd3366bc33f2d83b3b41ae40d49a",
+      "summary": "Read a Summer App's manifest, current files (or layout) and shared data summary.",
       "use_when": [
-        "before a play session whose console output you want isolated",
-        "\"the Output panel is full of old noise, wipe it\"",
-        "resetting before reproducing a bug so only the new messages show"
+        "before changing an existing app",
+        "\"what does our loot table app do\""
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "debug",
-          "editor"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
-      "mcp_tool_name": "summer_clear_console",
-      "remote": false,
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_get",
+      "remote": true,
       "authority": {
         "filesystem": false,
-        "editor_mutation": true,
-        "network": false,
+        "editor_mutation": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/connect-ports",
+      "id": "tool/app-guide",
       "kind": "tool",
       "version": "1.0.0",
-      "content_hash": "d3423ce431ff8bde3f0f288d5b4bf47788fca541694390168f0b31baff40a45a",
-      "summary": "Join one piece's port (a Marker3D, or an open pipe end id such as '+Y') to another's, facing it; refuses joins that tilt the piece. Saves the scene.",
+      "content_hash": "4648e830cef1a162e9df85ab0423dc4fbe099409682d375e325dde085521e5e3",
+      "summary": "Read the Summer Apps build guide: when to build an app, Layout vs code, build loop, manifest, SDK, UI kit, layout format, design rules and worked examples.",
       "use_when": [
-        "joining a pipe, duct or gutter section end to end with the previous one",
-        "fitting a bend, funnel or outlet onto a run",
-        "snapping any two pieces together by named Marker3D anchors"
+        "before building or changing a Summer App",
+        "\"build us a loot balance tool\"",
+        "\"make a tool for our team to track creatures\""
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "scenes",
-          "3d",
-          "world-building"
-        ],
-        "modalities": [
-          "scenes"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
       "related": {
-        "tools": [
-          "tool/inspect-asset",
-          "tool/attach-to-surface",
-          "tool/measure"
-        ],
         "skills": [
-          "skill/spatial-placement"
+          "skill/summer-apps"
         ]
       },
       "status": "preview",
-      "mcp_tool_name": "summer_connect_ports",
-      "remote": false,
+      "mcp_tool_name": "summer_app_guide",
+      "remote": true,
       "authority": {
-        "filesystem": true,
-        "editor_mutation": true,
-        "network": false,
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/connect-signal",
+      "id": "tool/app-list",
       "kind": "tool",
-      "version": "1.1.0",
-      "content_hash": "d37c9147743f97b9cd6f3acd1e287ef2af7df20b273c48dca05bb6cb427d236f",
-      "summary": "Connect a signal between two nodes so the saved scene keeps it (CONNECT_PERSIST, verified from the saved .tscn); the receiver should define the target method.",
+      "version": "1.0.0",
+      "content_hash": "b1d677c0301be54ee09b640007c519876449df7f2b2afd59373402633caca576",
+      "summary": "List the Summer Apps (team tools inside Summer Studio) in the person's workspaces.",
       "use_when": [
-        "wiring events like body_entered, pressed, or timeout",
-        "\"when the button is pressed, call my function\"",
-        "running code when the player enters an Area3D or a Timer finishes"
+        "\"which apps do we have\"",
+        "finding an app id to change or read"
       ],
       "facets": {
         "lifecycle": [
           "build"
         ],
         "domains": [
-          "scenes",
-          "editor"
+          "tools",
+          "ui"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
-      "mcp_tool_name": "summer_connect_signal",
-      "remote": false,
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_list",
+      "remote": true,
       "authority": {
-        "filesystem": true,
-        "editor_mutation": true,
-        "network": false,
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/create-debug-report",
+      "id": "tool/app-page",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "b950bca3f72f732d102142d9e233a4b27ffac33dd8a75515f0e71648742405a8",
-      "summary": "Create a support-ready Markdown debug report: doctor checks, engine health, diagnostics, console, and debugger output.",
+      "version": "1.0.0",
+      "content_hash": "4e3a2feb1c87ca57cebded9808fb7da24e46ca66c058b29ed1e3f2f15a07592e",
+      "summary": "Read or use the fields and buttons an open Summer App declared (fill values, press actions).",
+      "use_when": [
+        "\"set the budget to 60 in the balance app\"",
+        "reading what the person has selected in an open app"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_page",
+      "remote": true,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/app-publish",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "0c7f946c7d677a4f5aaaa7347583eff37371f0daf64b9c3ec36dd31d8b270ba7",
+      "summary": "Publish a new version of a Summer App from a local folder, files or a layout; the person's Studio tab boots it.",
+      "use_when": [
+        "after writing or changing an app's files",
+        "fixing an app after a publish error or an app error event"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_publish",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/app-report-gap",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "62863e862723f8694934067bf4f5e0d253af3ddc24f9bb6c34cbf7e3eb3dabb1",
+      "summary": "Report an SDK capability a Summer App needed and did not have, so Summer builds it.",
+      "use_when": [
+        "an app needed to reach a service or engine feature the SDK does not offer",
+        "an app needs something the Summer Apps SDK cannot do"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_report_gap",
+      "remote": true,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/app-screenshot",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "e2c089afcb531ea86b85ef8a3db5c99db23a7ada23a3056085f7d7e048df6fe6",
+      "summary": "See a Summer App without the person - a headless, read-only render (PNG) with its console, errors, refused calls and declared page.",
+      "use_when": [
+        "right after every summer_app_publish, to check the app renders with real data",
+        "\"does my app look right on a phone / in dark mode\"",
+        "finding why an app shows nothing (SDK not connected, script errors)"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps",
+          "skill/summer-apps-design"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_screenshot",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/app-tools",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "f9fda7b5271107ff4c1a057749fb2c213b50b187506b38f43a994794abb0d5a5",
+      "summary": "List the agent tools a Summer App declares.",
+      "use_when": [
+        "before calling app logic with summer_app_call",
+        "\"what can our balance app do for me\""
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_tools",
+      "remote": true,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/app-update",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "1233adcc99796051529958cddf35f0fd7f6716a1e9c1e09b7c8f7bfa732a1c4f",
+      "summary": "Rename a Summer App, move it to a folder, or keep, archive or restore it.",
+      "use_when": [
+        "archiving a scratch app you made that the person did not keep",
+        "\"rename the loot app to Drop tables\"",
+        "\"keep this app\" (status kept)"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "tools",
+          "ui"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_app_update",
+      "remote": true,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/attach-to-surface",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "e2207bbdab1a86f499382d89314fc48ea501080d814f15ffdfb9d06b47f047db",
+      "summary": "Mount a piece on a wall, ceiling or floor — turn its measured back into the surface found by a ray, keep it upright, seat it at a standoff. Saves the scene.",
+      "use_when": [
+        "mounting a downpipe, gutter, lamp, AC unit, sign or fire escape on a facade",
+        "turning a piece so its back faces a wall instead of guessing its rotation",
+        "seating a piece against a surface at an exact standoff"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "scenes",
+          "3d",
+          "world-building",
+          "level-design"
+        ],
+        "modalities": [
+          "scenes"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "tools": [
+          "tool/raycast",
+          "tool/snap-to-surface",
+          "tool/inspect-asset",
+          "tool/starcast"
+        ],
+        "skills": [
+          "skill/spatial-placement"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_attach_to_surface",
+      "remote": false,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": true,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/batch",
+      "kind": "tool",
+      "version": "1.1.0",
+      "content_hash": "ec6fa446a214a15c5562061ba0f39072f698ea69243e4326e4931683bc62f286",
+      "summary": "Run engine ops in one call, verbatim; one undo step unless single-only ops split it. ReparentNode keeps and verifies its subtree; raw ConnectSignal is refused.",
+      "use_when": [
+        "multi-node builds that should undo as one step (no single-only ops in the list)",
+        "reaching engine ops that have no dedicated tool",
+        "placing many kit pieces, one InstantiateScene op per piece with its position and rotation, read back with receipt summary"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "scenes",
+          "editor"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "stable",
+      "mcp_tool_name": "summer_batch",
+      "remote": false,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": true,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/camera-bookmark",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "42c4dfe31c6634c1b583a8e831a040d3d4b5b6bbdfe97ed71a2d7810a5b39891",
+      "summary": "Save, list, or delete named camera viewpoints stored in the project, so before/after screenshots are taken from exactly the same pose.",
+      "use_when": [
+        "\"save this camera angle\" / \"remember this viewpoint\" so later screenshots line up with it",
+        "comparing a scene before and after a change from one fixed, repeatable camera pose",
+        "listing or removing the saved viewpoints of a project"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "verification",
+          "scenes"
+        ],
+        "modalities": [
+          "scenes"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "tools": [
+          "tool/screenshot",
+          "tool/world-snapshot",
+          "tool/snapshot-diff"
+        ],
+        "skills": [
+          "skill/verifying-scenes",
+          "skill/scene-scripting"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_camera_bookmark",
+      "remote": false,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/capture-gameplay",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "7195fee358600665d2b1e0ec40eeb68a7c517e775f5cc4a366259bceba07cd03",
+      "summary": "Capture real gameplay PNGs (HUD included) offscreen without a running editor; game flags and player steps (press, key, click) get past the title screen.",
       "use_when": [
-        "the user wants to send Summer a bug report",
-        "handing a failing session to another agent as a portable artifact"
+        "\"take gameplay screenshots for my store page\"",
+        "\"I need screenshots but the editor is not open\"",
+        "\"capture a 1920x1080 frame of my game\"",
+        "collecting real gameplay screenshots for summer_store_set_art desktop.screenshots or mobile.screenshots",
+        "every capture shows the title screen — pass the game's flags in args or steps like press Play"
+      ],
+      "facets": {
+        "lifecycle": [
+          "launch",
+          "build"
+        ],
+        "domains": [
+          "creator",
+          "headless"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_capture_gameplay",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/check-job",
+      "kind": "tool",
+      "version": "1.0.2",
+      "content_hash": "a17e889099781c54902facf3abcbbdd8c10c0018333fdceb40d48f24dc01f183",
+      "summary": "Check the status of an async generation job by id.",
+      "use_when": [
+        "a generation ran without waiting, or timed out, and needs re-checking",
+        "\"is my 3D model / video done yet?\"",
+        "a generate_* call returned a job id instead of a finished asset"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "pipeline"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "stable",
+      "mcp_tool_name": "summer_check_job",
+      "remote": true,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/clear-console",
+      "kind": "tool",
+      "version": "1.0.2",
+      "content_hash": "5d96c1b758bcb0521a2ba2f291fc5b3929487df9222b735238eb97d7a645077c",
+      "summary": "Clear the editor's Output panel for a clean slate before running the game.",
+      "use_when": [
+        "before a play session whose console output you want isolated",
+        "\"the Output panel is full of old noise, wipe it\"",
+        "resetting before reproducing a bug so only the new messages show"
       ],
       "facets": {
         "lifecycle": [
@@ -5912,34 +6411,33 @@
         ],
         "domains": [
           "debug",
-          "feedback"
+          "editor"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
       "status": "stable",
-      "mcp_tool_name": "summer_create_debug_report",
+      "mcp_tool_name": "summer_clear_console",
       "remote": false,
-      "cli_command": "summer debug",
       "authority": {
-        "filesystem": true,
+        "filesystem": false,
         "editor_mutation": true,
-        "network": true,
+        "network": false,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/create-scene",
+      "id": "tool/connect-ports",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "cfb55fc92129fca8a2c50819242e2961f69542773822118aa04c0aa599f13dae",
-      "summary": "Create a new minimal .tscn on disk with a create-only guard and read-back verification; never touches the open scene.",
+      "version": "1.0.0",
+      "content_hash": "d3423ce431ff8bde3f0f288d5b4bf47788fca541694390168f0b31baff40a45a",
+      "summary": "Join one piece's port (a Marker3D, or an open pipe end id such as '+Y') to another's, facing it; refuses joins that tilt the piece. Saves the scene.",
       "use_when": [
-        "starting a new level, prefab, or UI scene file",
-        "\"make a new empty scene file for the enemy prefab\"",
-        "starting Level2.tscn from scratch as its own file"
+        "joining a pipe, duct or gutter section end to end with the previous one",
+        "fitting a bend, funnel or outlet onto a run",
+        "snapping any two pieces together by named Marker3D anchors"
       ],
       "facets": {
         "lifecycle": [
@@ -5947,122 +6445,135 @@
         ],
         "domains": [
           "scenes",
-          "project"
+          "3d",
+          "world-building"
+        ],
+        "modalities": [
+          "scenes"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
-      "mcp_tool_name": "summer_create_scene",
+      "related": {
+        "tools": [
+          "tool/inspect-asset",
+          "tool/attach-to-surface",
+          "tool/measure"
+        ],
+        "skills": [
+          "skill/spatial-placement"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_connect_ports",
       "remote": false,
       "authority": {
         "filesystem": true,
-        "editor_mutation": false,
+        "editor_mutation": true,
         "network": false,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/creator-config",
+      "id": "tool/connect-signal",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "1449083d5fef74d8bdb5fcfe88d5a8dc0ab80824c4fec51fa4dcb24c5c5bfef6",
-      "summary": "Read or update the shared non-secret Summer configuration; mutations require confirm, and tokens are never returned or accepted.",
+      "version": "1.1.0",
+      "content_hash": "d37c9147743f97b9cd6f3acd1e287ef2af7df20b273c48dca05bb6cb427d236f",
+      "summary": "Connect a signal between two nodes so the saved scene keeps it (CONNECT_PERSIST, verified from the saved .tscn); the receiver should define the target method.",
       "use_when": [
-        "inspecting or changing shared CLI and MCP configuration values",
-        "\"which creator project id / channel is this CLI pointed at?\"",
-        "switching the default publish channel"
+        "wiring events like body_entered, pressed, or timeout",
+        "\"when the button is pressed, call my function\"",
+        "running code when the player enters an Area3D or a Timer finishes"
       ],
       "facets": {
         "lifecycle": [
-          "launch"
+          "build"
         ],
         "domains": [
-          "creator",
-          "deployment"
+          "scenes",
+          "editor"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
       "status": "stable",
-      "mcp_tool_name": "summer_creator_config",
+      "mcp_tool_name": "summer_connect_signal",
       "remote": false,
-      "cli_command": "summer config",
       "authority": {
         "filesystem": true,
-        "editor_mutation": false,
+        "editor_mutation": true,
         "network": false,
         "credentials": false,
         "publish": false
       }
     },
     {
-      "id": "tool/creator-publish",
+      "id": "tool/create-debug-report",
       "kind": "tool",
-      "version": "1.1.0",
-      "content_hash": "48ee4dbe8810da6ae327ebf9e80b3e2a352daad18fe7e7061d53db17110a06fe",
-      "summary": "Deprecated: publishes a .pck to the legacy creator API. Use summer_export_game, then summer_publish_build, to upload to summer.games.",
+      "version": "1.0.2",
+      "content_hash": "b950bca3f72f732d102142d9e233a4b27ffac33dd8a75515f0e71648742405a8",
+      "summary": "Create a support-ready Markdown debug report: doctor checks, engine health, diagnostics, console, and debugger output.",
       "use_when": [
-        "an old project that still publishes a .pck to the legacy Summercraft creator channel with an sc_ creator token",
-        "a ~/.summer/config.json that names a legacy creator projectId and channel"
+        "the user wants to send Summer a bug report",
+        "handing a failing session to another agent as a portable artifact"
       ],
       "facets": {
         "lifecycle": [
-          "launch"
+          "build"
         ],
         "domains": [
-          "creator",
-          "deployment"
+          "debug",
+          "feedback"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "deprecated",
-      "mcp_tool_name": "summer_creator_publish",
+      "status": "stable",
+      "mcp_tool_name": "summer_create_debug_report",
       "remote": false,
-      "cli_command": "summer publish",
+      "cli_command": "summer debug",
       "authority": {
         "filesystem": true,
-        "editor_mutation": false,
+        "editor_mutation": true,
         "network": true,
         "credentials": false,
-        "publish": true
+        "publish": false
       }
     },
     {
-      "id": "tool/creator-releases",
+      "id": "tool/create-scene",
       "kind": "tool",
       "version": "1.0.2",
-      "content_hash": "8abe66c592d1d0f45db5106179f390a4d43cff8d72834c7029aefbaec57e628e",
-      "summary": "Deprecated: lists releases on the legacy creator API. For summer.games use summer_store_releases.",
+      "content_hash": "cfb55fc92129fca8a2c50819242e2961f69542773822118aa04c0aa599f13dae",
+      "summary": "Create a new minimal .tscn on disk with a create-only guard and read-back verification; never touches the open scene.",
       "use_when": [
-        "an old project that published a .pck to the legacy Summercraft creator channel with an sc_ creator token",
-        "paging legacy creator releases by projectId and cursor"
+        "starting a new level, prefab, or UI scene file",
+        "\"make a new empty scene file for the enemy prefab\"",
+        "starting Level2.tscn from scratch as its own file"
       ],
       "facets": {
         "lifecycle": [
-          "launch"
+          "build"
         ],
         "domains": [
-          "creator",
-          "deployment"
+          "scenes",
+          "project"
         ]
       },
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "deprecated",
-      "mcp_tool_name": "summer_creator_releases",
-      "remote": true,
-      "cli_command": "summer releases",
+      "status": "stable",
+      "mcp_tool_name": "summer_create_scene",
+      "remote": false,
       "authority": {
-        "filesystem": false,
+        "filesystem": true,
         "editor_mutation": false,
-        "network": true,
+        "network": false,
         "credentials": false,
         "publish": false
       }
@@ -6116,6 +6627,45 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/enable-plugin",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "e4785bfe2cf063958bc9c665873f0c38d4079a5127d46dd9310957ffcbfd20c4",
+      "summary": "Enable an editor plugin (res://addons/<name>/) and report the real load result, or that an older engine only queued it.",
+      "use_when": [
+        "an agent wrote or installed an editor plugin and needs it running",
+        "a Summer App's paired plugin must be enabled before the app can message it",
+        "\"turn on the quest_tools plugin\""
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "editor",
+          "tools"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/summer-apps"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_enable_plugin",
+      "remote": false,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": true,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
     {
       "id": "tool/export-game",
       "kind": "tool",
@@ -6650,8 +7200,8 @@
     {
       "id": "tool/generate-sfx-choices",
       "kind": "tool",
-      "version": "1.0.0",
-      "content_hash": "463a73530a24eb8a3379715b5c487cffa056bfca031c5ff3206971038b2df715",
+      "version": "1.0.1",
+      "content_hash": "cc583f4378e6fa60a864a5bbae0b7d3ddb5b30962a443432d5bc4a7581fd5fb3",
       "summary": "Make one sound effect with several models and show the versions in Summer Studio; the person approves one or more and that model becomes their default.",
       "use_when": [
         "the first sound effect in a chat, after the person said yes to three versions to pick from",