summer-engine 4.5.0 → 4.8.0

package/library/tools/view-set/resource.yaml

@@ -0,0 +1,78 @@
+id: tool/view-set
+kind: tool
+version: 1.0.0
+summary: "Show the person what you work on: the editor view (home, chat, 3D, 2D, script, game, Studio), the right rail, the focus and the nodes to frame."
+use_when:
+  - you start editing a scene and want the person to watch it change (3D view, Scene rail, the edited node framed)
+  - you edit a script and want it on screen (script view at that file)
+  - you play the game or review the result (game view; a frame_shot for a review)
+  - you finish and want to leave the person on the best view of the result
+do_not_use_when:
+  - selecting a node only to read it — summer_inspect_node; nothing needs to be on screen
+  - opening a Summer web page (billing, their games) — studio.open
+facets:
+  lifecycle:
+    - build
+  domains:
+    - editor
+    - navigation
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/navigate-summer
+  tools:
+    - tool/select-node
+    - tool/frame-shot
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_view_set
+implementation:
+  module: src/mcp/tools/scene-tools.ts
+  export: registerSceneTools
+surfaces:
+  mcp:
+    tool_name: summer_view_set
+    remote: false
+input_schema:
+  type: object
+  properties:
+    view:
+      type: string
+      enum:
+        - home
+        - chat
+        - 3d
+        - 2d
+        - script
+        - game
+        - studio
+      description: The view to show. 3d and 2d are the scene views, script the script editor, game the running game, chat the in-app chat, home the game list, studio the Studio tab.
+    rail:
+      type: string
+      enum:
+        - files
+        - scene
+        - inspector
+        - output
+        - none
+      description: The right rail beside a scene, script or game view. none hides it. Omit to keep it as it is.
+    focus:
+      type: string
+      description: What to focus. A res:// script or scene opens; a node path selects that node.
+    frame:
+      type: array
+      items:
+        type: string
+      description: Node paths to frame the camera on (the scene views).
+  required:
+    - view
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: true
+  network: false
+  credentials: false
+  publish: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "4.5.0",
+  "version": "4.8.0",
   "description": "MCP server, CLI and skills for Summer Engine, the game engine built for AI. Connect Claude Code, Cursor, Codex and other agents to build, test and publish full games to summer.games.",
   "mcpName": "io.github.SummerEngine/summer",
   "keywords": [
@@ -83,7 +83,7 @@
     "sync:catalog": "node scripts/sync-public-catalog.ts"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
@@ -93,7 +93,7 @@
     "zod": "^3.23.0"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@types/node": "^22.0.0",
     "typescript": "^5.5.0",
     "vitest": "^3.2.4"
   }

package/registry/generated/aliases.json

@@ -16,6 +16,7 @@
     "references/mcp-tools-reference.md": "reference/mcp-tools-reference",
     "references/public-surface-language.md": "reference/public-surface-language",
     "references/summer-folder.md": "reference/summer-folder",
+    "skill/ai-characters-in-games": "skill/summer-router",
     "skills/2d-assets/character-portrait": "skill/character-portrait",
     "skills/2d-assets/concept-art": "skill/concept-art",
     "skills/2d-assets/create-asset-sheet": "skill/create-asset-sheet",
@@ -99,7 +100,12 @@
     "smoke": "skill/vfx-smoke",
     "summer_add_node": "tool/add-node",
     "summer_align_distribute_3d": "tool/align-distribute-3d",
+    "summer_api_batch": "tool/api-batch",
     "summer_api_docs": "tool/api-docs",
+    "summer_api_estimate": "tool/api-estimate",
+    "summer_api_job": "tool/api-job",
+    "summer_api_models": "tool/api-models",
+    "summer_api_run": "tool/api-run",
     "summer_app_call": "tool/app-call",
     "summer_app_create": "tool/app-create",
     "summer_app_data": "tool/app-data",
@@ -218,6 +224,7 @@
     "summer_ui_activate": "tool/ui-activate",
     "summer_ui_screenshot": "tool/ui-screenshot",
     "summer_ui_tree": "tool/ui-tree",
+    "summer_view_set": "tool/view-set",
     "summer_wait_for_event": "tool/wait-for-event",
     "summer_world_snapshot": "tool/world-snapshot",
     "summer_write_file": "tool/write-file",

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 132,
+    "skill": 133,
     "template": 19,
-    "tool": 125
+    "tool": 131
   },
-  "total": 285
+  "total": 292
 }

package/registry/generated/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "4.5.0",
+  "version": "4.8.0",
   "description": "The game engine built for AI. Any agent makes a multiplayer game and publishes it. The Summer Engine MCP server, context primer and game-dev skills.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
@@ -27,7 +27,6 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
-    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -107,6 +106,7 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-api/",
     "./library/skills/summer-apps/",
     "./library/skills/summer-apps-design/",
     "./library/skills/summer-assets/",
@@ -117,6 +117,7 @@
     "./library/skills/summer-matchmaking/",
     "./library/skills/summer-parties/",
     "./library/skills/summer-player-data/",
+    "./library/skills/summer-router/",
     "./library/skills/summer-store/",
     "./library/skills/summer-world-chat/",
     "./library/skills/summer-world-saves/",

package/registry/generated/index.json

@@ -147,8 +147,8 @@
     {
       "id": "reference/mcp-tools-reference",
       "kind": "reference",
-      "version": "1.4.2",
-      "content_hash": "a96e7758787500aedfca23f720be8b7901ae88e8db18b4adffb93538851458c0",
+      "version": "1.4.3",
+      "content_hash": "0129465af088ad0c07bf5152c738656b8fcba50cf31e0b0a3ce32eccbc25c7b5",
       "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",
@@ -389,43 +389,6 @@
       "status": "preview",
       "recommended": true
     },
-    {
-      "id": "skill/ai-characters-in-games",
-      "kind": "skill",
-      "version": "0.3.0",
-      "content_hash": "57b0fba8a2e4eb383f75ab8d3d1063c1e1aca178031328dab09cb17764049d7d",
-      "summary": "Safe AI characters in published games: no keys in the build, Summer's player AI gateway, moderation, caps.",
-      "use_when": [
-        "a character, creature or object should answer free-form player text or speech in a published game (talking flowers, shopkeepers, companions)",
-        "about to put a model name, a provider SDK or a provider key into a game project",
-        "handling AI refusals (ai_disabled, age_policy, credits_exhausted, limit_exceeded) or adding the report button for AI replies",
-        "topping up Summer credits, setting AI limits or the kill switch for a game's AI characters"
-      ],
-      "facets": {
-        "lifecycle": [
-          "build"
-        ],
-        "domains": [
-          "ai",
-          "npc"
-        ],
-        "modalities": [
-          "scripts",
-          "scenes"
-        ]
-      },
-      "compatibility": {
-        "engine": ">=4.6"
-      },
-      "related": {
-        "skills": [
-          "skill/design-npc",
-          "skill/multiplayer-state"
-        ]
-      },
-      "status": "preview",
-      "recommended": false
-    },
     {
       "id": "skill/ambient-bed",
       "kind": "skill",
@@ -1469,8 +1432,8 @@
     {
       "id": "skill/design-npc",
       "kind": "skill",
-      "version": "1.0.2",
-      "content_hash": "feda92d30082eecf2bafc99fe9ed3f12a4d3c4641fd2790743bf93f9a01d3b57",
+      "version": "1.0.3",
+      "content_hash": "073069eb2348abb0b8b5652f79b2f4e90b7848485422232be86de98a9ec6f986",
       "summary": "Design enemy, NPC, boss or companion behavior: perception, state machine, telegraphs, script stub.",
       "use_when": [
         "designing an enemy, NPC, boss, companion, civilian, or wave-spawned mob's behavior — perception, intent, state machine, telegraphs, defeat handling",
@@ -1496,7 +1459,8 @@
         "skills": [
           "skill/game-feel",
           "skill/vfx-dissolve",
-          "skill/vfx-hit-spark"
+          "skill/vfx-hit-spark",
+          "skill/summer-router"
         ]
       },
       "status": "stable",
@@ -2284,7 +2248,7 @@
       "id": "skill/make-game",
       "kind": "skill",
       "version": "1.2.0",
-      "content_hash": "79eab1d1c84cdf321347a1952daaf4c4dd18e239f470adf775fba5e0f18116df",
+      "content_hash": "b6078a16547b4d8e14ccc75125b1f3be70543e30f3fb6bc2ab508f5ddae8e069",
       "summary": "Orchestrate 'make me a game': brainstorm, plan, scaffold, mechanics, art, audio, polish, verify, ship.",
       "use_when": [
         "the user says 'make me a game', 'build me a game', 'I want to make a [genre] game', or 'let's build something' — running the full game-dev pipeline",
@@ -2625,13 +2589,14 @@
     {
       "id": "skill/navigate-summer",
       "kind": "skill",
-      "version": "1.0.0",
-      "content_hash": "cf3fcb80dbae1479a7fdea6a8e21f08d696d1d40e58ac24bf4f98ad414b7b584",
-      "summary": "Open a Summer web page or editor surface for the user (billing, their games, a scene) with studio.open.",
+      "version": "1.0.1",
+      "content_hash": "5fb50f4ce2f00dd1d6db8a2373a539ed7027158e2ce6a99f4ea68d6959e0d5e8",
+      "summary": "Open a Summer page or editor view for the person: studio.open, and engine.view_set while you work.",
       "use_when": [
         "the user asks to see, check, or decide something — \"show me my billing\", \"where do I change my plan\", \"open my games\", \"let me look at the scene\", \"take me to the MCP guide for Cursor\"",
-        "deciding whether to open a surface for the user or to do the work through Summer tools",
-        "handing the user a link (headless, remote, or the user prefers a link) instead of launching a browser"
+        "deciding whether to open a surface (a page of the website) for the user or to do the work through Summer tools or an API",
+        "handing the user a link (headless, remote, or the user prefers a link) instead of launching a browser",
+        "you drive Summer Engine from outside (Claude Code, Codex, Cursor, the summer CLI) and the editor should show what you work on: the view, rail and focus for editing, scripting, playtesting, review and the end result"
       ],
       "facets": {
         "lifecycle": [
@@ -2653,7 +2618,8 @@
       },
       "related": {
         "tools": [
-          "tool/open"
+          "tool/open",
+          "tool/view-set"
         ],
         "references": [
           "reference/product-map"
@@ -3918,6 +3884,51 @@
       "status": "stable",
       "recommended": false
     },
+    {
+      "id": "skill/summer-api",
+      "kind": "skill",
+      "version": "1.0.0",
+      "content_hash": "03c2f63c8601e78bf2b2eb3e566ec166461b8f9b33be0b06e6dc9bb29bf1d948",
+      "summary": "Summer API game assets: models, estimate, one job or a batch, download the files.",
+      "use_when": [
+        "generating asset files (3D models, images, sounds, voice, music, video) from a script, a pipeline or a coding agent outside Summer Engine",
+        "making a set of assets in one go (a level's props, every UI icon, a sound pack) as one batch",
+        "choosing a generation model, pricing a job before it runs, or reading a job's state and files",
+        "a generation job answered no_credits, over_limit, not_signed_in or queued"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "assets",
+          "agent-workflow"
+        ],
+        "modalities": [
+          "3d-models",
+          "images",
+          "audio",
+          "video"
+        ]
+      },
+      "related": {
+        "tools": [
+          "tool/api-models",
+          "tool/api-estimate",
+          "tool/api-run",
+          "tool/api-batch",
+          "tool/api-job"
+        ],
+        "skills": [
+          "skill/summer-assets",
+          "skill/summer-cli",
+          "skill/asset-strategy",
+          "skill/summer-router"
+        ]
+      },
+      "status": "preview",
+      "recommended": false
+    },
     {
       "id": "skill/summer-apps",
       "kind": "skill",
@@ -3998,9 +4009,9 @@
     {
       "id": "skill/summer-assets",
       "kind": "skill",
-      "version": "1.0.1",
-      "content_hash": "2a52ea8260720b3aa81d30dc29439e285afd5ff41592334b957ab4ffbb1f1807",
-      "summary": "Make game assets with Summer, no Summer Engine: find, generate and download 3D models, images, audio and video for any engine or app.",
+      "version": "1.0.2",
+      "content_hash": "2545cd7ef9e516f29b8883f0738735bcb5f97895422e76064eccc0ea2a007a11",
+      "summary": "Game assets for any engine, no Summer Engine: find, generate and download them.",
       "use_when": [
         "starting a session that has the Summer assets profile (generation tools, no engine tools)",
         "the person wants assets for their own engine or web app, not a game built in Summer Engine",
@@ -4031,6 +4042,7 @@
         ],
         "skills": [
           "skill/asset-strategy",
+          "skill/summer-api",
           "skill/sound-effect",
           "skill/prop-model",
           "skill/concept-art"
@@ -4313,6 +4325,46 @@
       "status": "stable",
       "recommended": false
     },
+    {
+      "id": "skill/summer-router",
+      "kind": "skill",
+      "version": "1.0.0",
+      "content_hash": "dc25c719d31b25d53288780f53130389c34434a48ee5016d6adf9f5c24d22cd0",
+      "summary": "AI characters for games on Summer Games: Summer Router replies, tools, speech, images.",
+      "use_when": [
+        "a talking NPC (shopkeeper, guard, companion) players chat with, in a single-player or multiplayer game on Summer Games",
+        "a game should speak a line in a character's voice, or make an image, while people play",
+        "about to put a model name, a provider SDK or a provider key into a game project",
+        "choosing between Summer.client.router and Summer.authority.router in a single-player or multiplayer game",
+        "handling Summer Router refusals (limit_reached, credits_required, router_disabled, not_on_summer_games, unavailable) or changing its caps"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "ai",
+          "npc",
+          "multiplayer"
+        ],
+        "modalities": [
+          "scripts",
+          "scenes"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/design-npc",
+          "skill/multiplayer-state",
+          "skill/summer-api"
+        ]
+      },
+      "status": "preview",
+      "recommended": false
+    },
     {
       "id": "skill/summer-store",
       "kind": "skill",
@@ -5930,6 +5982,39 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/api-batch",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "8b30f8783781652a455ac3fff4191aece6e7f08b4e29444d999b520d5328589e",
+      "summary": "Run up to 500 Summer API jobs at once, all or none, with the Summer sign-in; follow every job and save the files.",
+      "use_when": [
+        "making many game assets through the Summer API in one go (a set of props, sounds or icons)",
+        "following or downloading a batch that summer_api_batch started"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "assets"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_api_batch",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": true,
+        "publish": false
+      }
+    },
     {
       "id": "tool/api-docs",
       "kind": "tool",
@@ -5976,6 +6061,142 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/api-estimate",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "c230c26f06934f118bfc3a582c1d7df38461478114e5ad21ad8126e6d6009dab",
+      "summary": "The exact USD price of one Summer API job before it runs, its breakdown and a quote id that holds the price for 15 minutes; charges nothing.",
+      "use_when": [
+        "before a Summer API run that spends the person's credits",
+        "the person asks what a generation will cost"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "assets"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_api_estimate",
+      "remote": true,
+      "cli_command": "summer api estimate",
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/api-job",
+      "kind": "tool",
+      "version": "1.0.1",
+      "content_hash": "1f1912adb84492c6602d636e90eb3fda450add3b15dda3e46d91a98f5d027677",
+      "summary": "Read a Summer API job (state, price, assets and file URLs); follow it until it finishes and save its files on this computer.",
+      "use_when": [
+        "a summer_api_run answered a running job",
+        "saving a finished Summer API job's files"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "assets"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_api_job",
+      "remote": true,
+      "cli_command": "summer api jobs",
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": true,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/api-models",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "73c3ac25cbe1a46f1e4584f081c9b0d06eee3f76f17cdf356b49d4b380e1638b",
+      "summary": "The Summer API's curated game-dev models with capability, input schema, output formats, typical time and USD price; no sign-in.",
+      "use_when": [
+        "choosing a model for an image, 3D, video, voice, sound or music asset through the Summer API",
+        "checking what a Summer API model costs or takes as input"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "assets"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_api_models",
+      "remote": true,
+      "cli_command": "summer api models",
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/api-run",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "f032bc0f2b3177f0897a3a3ca4a01ad5725b7f16ce648965cef2294aeeaa5d62",
+      "summary": "Run one Summer API job into the person's Summer assets with the Summer sign-in; spends paid credits within the app's limit, can wait and save the files.",
+      "use_when": [
+        "making a game asset through the Summer API after estimating it",
+        "a script or agent outside Summer Engine needs a generated model, image, sound or clip"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "generate",
+          "assets"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_api_run",
+      "remote": true,
+      "cli_command": "summer api run",
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": true,
+        "publish": false
+      }
+    },
     {
       "id": "tool/app-call",
       "kind": "tool",
@@ -10816,6 +11037,50 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/view-set",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "f8986edfdd42e5de7dc9d58f67ad4d67acc05b18db211cff935dbb27cf342a2f",
+      "summary": "Show the person what you work on: the editor view (home, chat, 3D, 2D, script, game, Studio), the right rail, the focus and the nodes to frame.",
+      "use_when": [
+        "you start editing a scene and want the person to watch it change (3D view, Scene rail, the edited node framed)",
+        "you edit a script and want it on screen (script view at that file)",
+        "you play the game or review the result (game view; a frame_shot for a review)",
+        "you finish and want to leave the person on the best view of the result"
+      ],
+      "facets": {
+        "lifecycle": [
+          "build"
+        ],
+        "domains": [
+          "editor",
+          "navigation"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "related": {
+        "skills": [
+          "skill/navigate-summer"
+        ],
+        "tools": [
+          "tool/select-node",
+          "tool/frame-shot"
+        ]
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_view_set",
+      "remote": false,
+      "authority": {
+        "filesystem": false,
+        "editor_mutation": true,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
     {
       "id": "tool/wait-for-event",
       "kind": "tool",

package/registry/generated/marketplace.claude.json

@@ -10,7 +10,7 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "4.5.0",
+      "version": "4.8.0",
       "description": "The game engine built for AI. Any agent makes a multiplayer game and publishes it. A first-run guide (/summer:start), game-dev skills, and two MCP servers: the bridge to the Summer Engine desktop app, and Summer's hosted cloud server for people without it.",
       "author": {
         "name": "Summer Engine",