summer-engine 3.2.1 → 3.4.0

package/library/tools/capture-gameplay/resource.yaml

@@ -0,0 +1,73 @@
+id: tool/capture-gameplay
+kind: tool
+version: 1.0.0
+summary: Capture real gameplay frames (PNG, HUD included) in Summer Engine's offscreen verify instance, without a running editor, e.g. store screenshots.
+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
+do_not_use_when:
+  - the editor is open and the game is running — tool/screenshot with target game shows the live game
+  - key art, covers or icons — those are generated art, not gameplay frames
+  - checking an interaction with inputs and assertions — RunVerification through tool/batch
+facets:
+  lifecycle:
+    - launch
+    - build
+  domains:
+    - creator
+    - headless
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_capture_gameplay
+implementation:
+  module: src/core/capabilities/capture-gameplay.ts
+  export: captureGameplay
+surfaces:
+  mcp:
+    tool_name: summer_capture_gameplay
+    remote: true
+input_schema:
+  type: object
+  properties:
+    project:
+      type: string
+      description: Project folder with project.godot. Defaults to the MCP's bound project, then the working directory.
+    scene:
+      type: string
+      description: Scene to start (res://... or uid://...). Default is the project's main scene, often a title menu; pass the gameplay scene for gameplay frames.
+    resolution:
+      type: string
+      description: Window size WIDTHxHEIGHT (default 1920x1080; 1080x1920 for portrait).
+    frames:
+      type: integer
+      minimum: 1
+      maximum: 10
+      description: Frames to save (default 1).
+    waitSeconds:
+      type: number
+      minimum: 0
+      maximum: 120
+      description: Seconds the game runs before the first frame (default 3).
+    intervalSeconds:
+      type: number
+      minimum: 0.1
+      maximum: 60
+      description: Seconds between frames (default 1).
+    out:
+      type: string
+      description: Output folder. Defaults to <project>/.summer/captures/<time>/ (ignored by git).
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: false
+  credentials: false
+  publish: false
+evidence_checks:
+  - none

package/library/tools/creator-publish/resource.yaml

@@ -1,12 +1,13 @@
 id: tool/creator-publish
 kind: tool
-version: 1.0.2
-summary: Publish an exported Summer .pck through the versioned Summercraft creator API, with an explicit confirm step before upload.
+version: 1.1.0
+summary: "Deprecated: publishes a .pck to the legacy Summercraft API. Use summer_export_game, then summer_publish_build, to upload to summer.games."
 use_when:
   - releasing a user-approved build to a Summercraft channel
   - '"ship this exported build to the live channel"'
   - '"release version 1.2.0 of my game"'
 do_not_use_when:
+  - uploading to summer.games — summer_export_game, then summer_publish_build
   - the user has not approved the exact version, digest, and channel
   - the game is not exported yet — export the .pck first (skill/export-and-ship)
 facets:
@@ -19,7 +20,7 @@ compatibility:
   engine: ">=4.6"
 source: official
 license: MIT
-status: stable
+status: deprecated
 aliases:
   - summer_creator_publish
 implementation:

package/library/tools/creator-releases/resource.yaml

@@ -7,7 +7,7 @@ use_when:
   - '"what version is live right now?"'
   - '"did the publish go through?" — confirming a release landed'
 do_not_use_when:
-  - publishing a new release — summer_creator_publish
+  - publishing a new release — summer_publish_build
 facets:
   lifecycle:
     - launch

package/library/tools/export-game/resource.yaml

@@ -0,0 +1,72 @@
+id: tool/export-game
+kind: tool
+version: 1.0.0
+summary: Export the game in the exact file the Summer Games store takes per platform (iPhone, Android, macOS, Windows bundle; web build; desktop download), headless.
+use_when:
+  - '"export my game for summer.games"'
+  - '"make a build I can upload to my store page"'
+  - '"export my game for iPhone and Android on Summer Games"'
+  - '"make a web build of my game for summer.games"'
+  - '"export a Mac or Windows download for my store page"'
+  - preparing the bundle that summer_publish_build uploads
+do_not_use_when:
+  - exporting for Steam, itch.io, the App Store, Google Play or other stores — skill/export-and-ship
+  - the game is still being built; export when the user wants a Build
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - deployment
+    - headless
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_export_game
+implementation:
+  module: src/core/capabilities/export-game.ts
+  export: exportGame
+surfaces:
+  mcp:
+    tool_name: summer_export_game
+    remote: true
+input_schema:
+  type: object
+  properties:
+    project:
+      type: string
+      description: Project folder with project.godot. Defaults to the MCP's bound project, then the working directory.
+    out:
+      type: string
+      description: Output .zip path. Defaults to <project>/.summer/exports/.
+    targets:
+      type: array
+      items:
+        type: string
+        enum: [macos, windows, ios, android, web]
+      description: "Store platforms. Bundle: any of macos, windows, ios, android (omit to use every platform the project declares). Download: exactly one of web, macos, windows."
+    format:
+      type: string
+      enum: [bundle, download]
+      description: 'bundle (default): the summer.games store build. download: a web build or native download; the default when targets is ["web"].'
+    debug:
+      type: boolean
+      default: false
+      description: Export a debug build (--export-debug).
+    timeoutSeconds:
+      type: integer
+      minimum: 10
+      maximum: 7200
+      description: Stop the engine after this many seconds (default 900; a first export imports every asset).
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: false
+  credentials: false
+  publish: false
+evidence_checks:
+  - none

package/library/tools/export-templates/resource.yaml

@@ -0,0 +1,63 @@
+id: tool/export-templates
+kind: tool
+version: 1.0.0
+summary: List and install Summer Engine export templates (Summer's WebGPU Forward+ web template, macOS, Windows) from Summer's CDN, sha256-checked.
+use_when:
+  - '"install the web export template"'
+  - '"summer_export_game says an export template is missing"'
+  - '"which export templates do I have"'
+  - before a web build or a macOS/Windows download export on a machine whose Summer Engine does not bundle that template
+do_not_use_when:
+  - exporting the summer.games store bundle (iPhone, Android, macOS, Windows apps) — it needs no template, tool/export-game
+  - exporting for Steam, itch.io or other stores — skill/export-and-ship
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - deployment
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_export_templates
+implementation:
+  module: src/core/capabilities/export-templates.ts
+  export: exportTemplates
+surfaces:
+  mcp:
+    tool_name: summer_export_templates
+    remote: true
+input_schema:
+  type: object
+  properties:
+    action:
+      type: string
+      enum: [list, install]
+      description: "list: installed and published templates. install: download and install."
+    platforms:
+      type: array
+      items:
+        type: string
+        enum: [web, macos, windows, linux, ios, android]
+      description: Template platforms to install (default ["web"]).
+    includeDebug:
+      type: boolean
+      default: false
+      description: Also install the debug templates (for exports with debug true).
+    summerVersion:
+      type: string
+      description: The installed Summer Engine version (Help > About, e.g. 0.7.1). Read automatically on macOS; needed on Windows and Linux.
+  required:
+    - action
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false
+evidence_checks:
+  - none

package/library/tools/generate-image/resource.yaml

@@ -45,10 +45,24 @@ input_schema:
     removeBackground:
       type: boolean
       description: Remove the background server-side and return an alpha PNG for sprites, icons, or isolated objects.
+    aspectRatio:
+      type: string
+      enum: ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9"]
+      description: Aspect ratio of the output (default 1:1). The result reports the real width and height.
+    width:
+      type: integer
+      minimum: 64
+      maximum: 4096
+      description: Smallest output width in pixels; pass with height. 1920 with height 1080 for store key art, 1080 with 1920 for a tall cover.
+    height:
+      type: integer
+      minimum: 64
+      maximum: 4096
+      description: Smallest output height in pixels; pass with width.
     options:
       type: object
       additionalProperties: {}
-      description: Provider-specific params (guidance_scale, seed, image_size, negative_prompt, etc.)
+      description: Extra model params (seed, negative_prompt, ...). The result lists any it did not use in ignoredOptions.
   required:
     - prompt
   additionalProperties: false

package/library/tools/open/resource.yaml

@@ -9,7 +9,7 @@ use_when:
   - 'handing the user a link instead of opening a browser (open: false), or checking which destination an intent maps to'
   - resolving where a user intent lives ("where do I change my plan?") before acting
 do_not_use_when:
-  - the user wants a result, not a view — add the node, set the property, publish; use the mutation tools (summer_add_node, summer_set_prop, summer_creator_publish)
+  - the user wants a result, not a view — add the node, set the property, publish; use the mutation tools (summer_add_node, summer_set_prop, summer_publish_build)
   - opening a project directory in the engine — that is the CLI's `summer open <path>` / `summer run <path>` project launcher, not a navigation target
   - the destination is not on summerengine.com or docs.summerengine.com — the tool refuses other origins
 facets:

package/library/tools/publish-build/resource.yaml

@@ -0,0 +1,78 @@
+id: tool/publish-build
+kind: tool
+version: 1.0.0
+summary: Upload an export from summer_export_game to the creator's store game, confirm-gated - a store bundle as a Build, or a web or native download as a store version.
+use_when:
+  - '"upload my game to summer.games"'
+  - '"publish this build to my store page"'
+  - '"put my game online so my friends can play it"'
+  - uploading the .zip from summer_export_game as a new Build
+  - uploading a web build or a macOS or Windows download from summer_export_game format download
+do_not_use_when:
+  - the user has not approved the exact game, file, digest, version and publish choice
+  - the game is not exported yet — summer_export_game first
+  - store page text, images or price — those are edited in Studio
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - deployment
+compatibility:
+  engine: ">=4.6"
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_publish_build
+implementation:
+  module: src/core/capabilities/publish-build.ts
+  export: publishBuild
+surfaces:
+  mcp:
+    tool_name: summer_publish_build
+    remote: true
+input_schema:
+  type: object
+  properties:
+    gameId:
+      type: string
+      description: The store game id (from summer_store_list_games, or the Studio store page URL). Without it the call fails with game_required and lists your store games, or says why the store did not list them.
+    file:
+      type: string
+      description: Exported .zip. Defaults to the last summer_export_game result.
+    clientVersion:
+      type: string
+      description: Build version, vMAJOR.MINOR.PATCH (e.g. v1.0.0); a new upload needs a new version.
+    publish:
+      type: boolean
+      default: false
+      description: "Bundles only: also approve the Build for players. A game that has not passed review keeps it as a preview; an agent needs the owner's approval."
+    platform:
+      type: string
+      enum:
+        - web
+        - macos-universal
+        - windows-x64
+        - linux-x64
+      description: "Web builds and native downloads: the store platform. Defaults to the last export's platform; omit for a store bundle."
+    confirm:
+      type: boolean
+      default: false
+      description: Set true only after the user approves the exact upload.
+    waitSeconds:
+      type: integer
+      minimum: 0
+      maximum: 1800
+      description: How long to wait for Summer to make the Build (default 600). On timeout, call again to keep waiting.
+  required:
+    - clientVersion
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: true
+evidence_checks:
+  - none

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "3.2.1",
+  "version": "3.4.0",
   "description": "Local Summer CLI and MCP server for Summer Engine. Install and run the engine, connect Claude Code, Cursor, Codex, Gemini, and other agents, and build real games with bundled skills, hooks, and plugins.",
   "keywords": [
     "summer-engine",

package/registry/generated/aliases.json

@@ -103,6 +103,7 @@
     "summer_attach_to_surface": "tool/attach-to-surface",
     "summer_batch": "tool/batch",
     "summer_camera_bookmark": "tool/camera-bookmark",
+    "summer_capture_gameplay": "tool/capture-gameplay",
     "summer_check_job": "tool/check-job",
     "summer_clear_console": "tool/clear-console",
     "summer_connect_ports": "tool/connect-ports",
@@ -113,6 +114,8 @@
     "summer_creator_publish": "tool/creator-publish",
     "summer_creator_releases": "tool/creator-releases",
     "summer_debug_views": "tool/debug-views",
+    "summer_export_game": "tool/export-game",
+    "summer_export_templates": "tool/export-templates",
     "summer_fabricate_3d": "tool/fabricate-3d",
     "summer_frame_nodes": "tool/frame-nodes",
     "summer_frame_shot": "tool/frame-shot",
@@ -160,6 +163,7 @@
     "summer_place_adjacent": "tool/place-adjacent",
     "summer_play": "tool/play",
     "summer_project_setting": "tool/project-setting",
+    "summer_publish_build": "tool/publish-build",
     "summer_raycast": "tool/raycast",
     "summer_read_file": "tool/read-file",
     "summer_read_library": "tool/read-library",

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 116,
+    "skill": 118,
     "template": 19,
-    "tool": 101
+    "tool": 105
   },
-  "total": 245
+  "total": 251
 }

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": "3.2.1",
+  "version": "3.4.0",
   "description": "Agent tooling for Summer Engine: MCP bridge, context primer, and game-dev skills. Use with the npm CLI for skill files on disk.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
@@ -35,6 +35,7 @@
     "./library/skills/asset-strategy/",
     "./library/skills/audio-direction/",
     "./library/skills/auto-fire-targeting/",
+    "./library/skills/bounded-engine-runs/",
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
@@ -46,6 +47,7 @@
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
     "./library/skills/combat-basics/",
+    "./library/skills/compatibility-renderer-traps/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",