summer-engine 4.6.0 → 4.8.0

package/library/tools/api-estimate/resource.yaml

@@ -0,0 +1,52 @@
+id: tool/api-estimate
+kind: tool
+version: 1.0.0
+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
+do_not_use_when:
+  - an estimate inside Studio or the asset tools (their dryRun)
+facets:
+  lifecycle:
+    - build
+  domains:
+    - generate
+    - assets
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_api_estimate
+implementation:
+  module: src/mcp/tools/api-tools.ts
+  export: registerApiTools
+surfaces:
+  mcp:
+    tool_name: summer_api_estimate
+    remote: true
+  cli:
+    command: summer api estimate
+input_schema:
+  type: object
+  properties:
+    model:
+      type: string
+      minLength: 1
+      maxLength: 120
+      description: A Summer API model id or alias from summer_api_models, e.g. 3d/default.
+    input:
+      type: object
+      additionalProperties: {}
+      description: The model's input, matching its inputSchema from summer_api_models.
+  required:
+    - model
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

package/library/tools/api-job/resource.yaml

@@ -0,0 +1,58 @@
+id: tool/api-job
+kind: tool
+version: 1.0.1
+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
+do_not_use_when:
+  - a job from the Summer Engine asset tools (jobs.wait)
+facets:
+  lifecycle:
+    - build
+  domains:
+    - generate
+    - assets
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_api_job
+implementation:
+  module: src/mcp/tools/api-tools.ts
+  export: registerApiTools
+surfaces:
+  mcp:
+    tool_name: summer_api_job
+    remote: true
+  cli:
+    command: summer api jobs
+input_schema:
+  type: object
+  properties:
+    jobId:
+      type: string
+      minLength: 1
+      maxLength: 200
+      description: The job id summer_api_run answered.
+    wait:
+      type: boolean
+      description: Follow the job until it finishes (up to about a minute in this call).
+    out:
+      type: string
+      minLength: 1
+      description: "A folder on this computer: save the finished job's files there (implies wait)."
+    cancel:
+      type: boolean
+      description: "Ask to stop the job instead. Summer API jobs, queued or running, run to the end: the answer is unsupported."
+  required:
+    - jobId
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: true
+  credentials: true
+  publish: false

package/library/tools/api-models/resource.yaml

@@ -0,0 +1,57 @@
+id: tool/api-models
+kind: tool
+version: 1.0.0
+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
+do_not_use_when:
+  - generating inside a running Summer Engine project with the asset tools
+facets:
+  lifecycle:
+    - build
+  domains:
+    - generate
+    - assets
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_api_models
+implementation:
+  module: src/mcp/tools/api-tools.ts
+  export: registerApiTools
+surfaces:
+  mcp:
+    tool_name: summer_api_models
+    remote: true
+  cli:
+    command: summer api models
+input_schema:
+  type: object
+  properties:
+    model:
+      type: string
+      minLength: 1
+      maxLength: 120
+      description: One model id or alias; without it, every model.
+    capability:
+      type: string
+      enum:
+        - image
+        - 3d
+        - video
+        - voice
+        - dialogue
+        - sound
+        - music
+      description: Only this kind.
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

package/library/tools/api-run/resource.yaml

@@ -0,0 +1,70 @@
+id: tool/api-run
+kind: tool
+version: 1.0.0
+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
+do_not_use_when:
+  - this computer is not signed in yet (the person runs summer login first)
+  - the person has not agreed to spend credits
+facets:
+  lifecycle:
+    - build
+  domains:
+    - generate
+    - assets
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_api_run
+implementation:
+  module: src/mcp/tools/api-tools.ts
+  export: registerApiTools
+surfaces:
+  mcp:
+    tool_name: summer_api_run
+    remote: true
+  cli:
+    command: summer api run
+input_schema:
+  type: object
+  properties:
+    model:
+      type: string
+      minLength: 1
+      maxLength: 120
+      description: A Summer API model id or alias from summer_api_models, e.g. 3d/default.
+    input:
+      type: object
+      additionalProperties: {}
+      description: The model's input, matching its inputSchema from summer_api_models.
+    quoteId:
+      type: string
+      minLength: 1
+      maxLength: 600
+      description: "From summer_api_estimate: refuse to charge more than it quoted."
+    idempotencyKey:
+      type: string
+      minLength: 1
+      maxLength: 200
+      description: Reuse to retry the same run without running it twice.
+    wait:
+      type: boolean
+      description: Follow the job until it finishes (up to about a minute in this call).
+    out:
+      type: string
+      minLength: 1
+      description: "A folder on this computer: save the finished job's files there (implies wait)."
+  required:
+    - model
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: true
+  credentials: true
+  publish: false

package/library/tools/view-set/GUIDE.md

@@ -0,0 +1,3 @@
+# summer_view_set
+
+Show the person what you are working on: the editor's view (home, chat, 3d, 2d, script, game, studio), its right rail (files, scene, inspector, output, none), what to focus (a res:// script or scene, or a node path) and the nodes to frame the camera on. Changes only what is on screen. The navigate-summer skill says which view fits which moment.

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.6.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.6.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/",