summer-engine 3.2.1 → 3.3.0

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/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 (Studio store page URL). Omit to get the list of your games.
+    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.3.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

@@ -113,6 +113,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 +162,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

@@ -6,7 +6,7 @@
     "reference": 9,
     "skill": 116,
     "template": 19,
-    "tool": 101
+    "tool": 104
   },
-  "total": 245
+  "total": 248
 }

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.3.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": {

package/registry/generated/index.json

@@ -148,7 +148,7 @@
       "id": "reference/mcp-tools-reference",
       "kind": "reference",
       "version": "1.4.0",
-      "content_hash": "09d9e3a92558c4b28e14105a5b26fffdd47587144debc30e44f6e26b88d3baf1",
+      "content_hash": "d0fc28b8ca01a46e50a1053393760594ac0323643aa2e00aa7d68c0d1bd5732d",
       "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",
@@ -1524,7 +1524,7 @@
       "id": "skill/export-and-ship",
       "kind": "skill",
       "version": "1.0.3",
-      "content_hash": "459ad769af5e734676659117ce4fbb3226668b5e41211afc3373b45a52ed8bba",
+      "content_hash": "371cc6ecc30a066a5f4906a9fb29a29d85ff4f6747f8656ce9f89671a87c6193",
       "summary": "Assess and prepare a game export: inventory installed templates and targets, validate release assets and config, produce supported builds after approval.",
       "use_when": [
         "the user wants to assess or prepare a Summer game export — Steam, itch, HTML5, iOS, Android targets as available in the installed build",
@@ -2209,7 +2209,7 @@
       "id": "skill/multiplayer-publish",
       "kind": "skill",
       "version": "1.0.0",
-      "content_hash": "7d7f025367beb0f71efa96519a4325e9f3b97705c99ea597ea73aaf9da2052eb",
+      "content_hash": "52117117e661cbd898d4faece8f72ef2304118999c80bce55a709619e8cec289",
       "summary": "Ship a hosted Summer multiplayer game: the summer.games bundle, server preset, pre-upload checks, and a new Build.",
       "use_when": [
         "publishing a hosted Summer multiplayer game online so other players can join it",
@@ -2373,7 +2373,7 @@
       "id": "skill/navigate-summer",
       "kind": "skill",
       "version": "1.0.0",
-      "content_hash": "8fdf4a979ef8e40412fa23974097251937dbd5a553490be8b09842e5c7868b6f",
+      "content_hash": "261e7a6fc82faab880e61723cf39459596a7edaeabb90059c43c1d97c2fca079",
       "summary": "When to open a Summer web page or editor surface FOR the user (billing, their games, the scene just built) versus acting through the API, using summer_open.",
       "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\"",
@@ -5684,9 +5684,9 @@
     {
       "id": "tool/creator-publish",
       "kind": "tool",
-      "version": "1.0.2",
-      "content_hash": "5ced82fe5442354df55ef381c4284029142441fd462bc7a695c2e5853c3817f3",
-      "summary": "Publish an exported Summer .pck through the versioned Summercraft creator API, with an explicit confirm step before upload.",
+      "version": "1.1.0",
+      "content_hash": "0f62b7444688a0b5724b1d992a7f8aa20dbd138503aaeac02bc5fec242e899a4",
+      "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\"",
@@ -5704,7 +5704,7 @@
       "compatibility": {
         "engine": ">=4.6"
       },
-      "status": "stable",
+      "status": "deprecated",
       "mcp_tool_name": "summer_creator_publish",
       "remote": false,
       "cli_command": "summer publish",
@@ -5720,7 +5720,7 @@
       "id": "tool/creator-releases",
       "kind": "tool",
       "version": "1.0.2",
-      "content_hash": "75e19a8b5e872d42d9b52ae255cf55b24f7d455323d028cfa0856abf955cb0b5",
+      "content_hash": "7f807ae2bc66110570ee19351d3493e71f7f9e2bd327fb83b2eac53c1bfc8789",
       "summary": "List creator-owned releases from the Summercraft creator API with server-verified scope and ownership.",
       "use_when": [
         "reviewing which versions of a project are live per channel",
@@ -5800,6 +5800,79 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/export-game",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "211be00e329de60498da0ae132721202b0efac9617d3a9bc440f44a1fdd51382",
+      "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"
+      ],
+      "facets": {
+        "lifecycle": [
+          "launch"
+        ],
+        "domains": [
+          "creator",
+          "deployment",
+          "headless"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_export_game",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": false,
+        "credentials": false,
+        "publish": false
+      }
+    },
+    {
+      "id": "tool/export-templates",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "df384233563daadc6ed0c1edef6169f63fc7aea0307f53df4b3ae75aaef1c2ea",
+      "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"
+      ],
+      "facets": {
+        "lifecycle": [
+          "launch"
+        ],
+        "domains": [
+          "creator",
+          "deployment"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_export_templates",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": false
+      }
+    },
     {
       "id": "tool/fabricate-3d",
       "kind": "tool",
@@ -7408,7 +7481,7 @@
       "id": "tool/open",
       "kind": "tool",
       "version": "1.0.1",
-      "content_hash": "d32902fb14881139928d72eafaa2f0a54e1c59bbcfe0055884cac561cce72b86",
+      "content_hash": "c1087ddd07caf7bca466f5545aa8f15c3e28dd6d4cedd41eddb28f466025ff02",
       "summary": "Open the exact summerengine.com page or editor surface by intent name — billing, my games, an MCP guide, a scene, a node, a dock — or print the URL/op.",
       "use_when": [
         "the user wants to SEE or DECIDE something on the website — \"open my billing page\", \"show me my published games\", \"take me to pricing\", \"open the MCP setup guide for Cursor\"",
@@ -7664,6 +7737,42 @@
         "publish": false
       }
     },
+    {
+      "id": "tool/publish-build",
+      "kind": "tool",
+      "version": "1.0.0",
+      "content_hash": "a70684f394a5cea3125f3df03a581b9a5a3cac50ae6245ece26d80f6d4c4ddde",
+      "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"
+      ],
+      "facets": {
+        "lifecycle": [
+          "launch"
+        ],
+        "domains": [
+          "creator",
+          "deployment"
+        ]
+      },
+      "compatibility": {
+        "engine": ">=4.6"
+      },
+      "status": "preview",
+      "mcp_tool_name": "summer_publish_build",
+      "remote": true,
+      "authority": {
+        "filesystem": true,
+        "editor_mutation": false,
+        "network": true,
+        "credentials": false,
+        "publish": true
+      }
+    },
     {
       "id": "tool/raycast",
       "kind": "tool",

package/registry/generated/marketplace.claude.json

@@ -11,8 +11,8 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "3.2.1",
-      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
+      "version": "3.3.0",
+      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
       "author": {
         "name": "Summer Engine",
         "email": "founders@summerengine.com"

package/registry/generated/plugin.claude.json

@@ -2,8 +2,8 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "_generated": "GENERATED from integrations/claude — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.2.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
+  "version": "3.3.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",

package/registry/generated/plugin.codex.json

@@ -1,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.2.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge. Build games by talking.",
+  "version": "3.3.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -144,7 +144,7 @@
   "interface": {
     "displayName": "Summer",
     "shortDescription": "Superpowers for AI game dev. Build games by talking.",
-    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine. Users make Summer games with the Summer SDK and GDScript. The plugin adds game-dev skills, lifecycle hooks, and a 101-tool MCP bridge for guarded project files, scene editing, asset import, play mode, diagnostics, generation, and creator workflows. Git, shell, and grep stay with the host agent. Summer follows its upstream technical base continuously; version-sensitive work uses the bundled compatibility reference instead of a fixed onboarding version. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
+    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine. Users make Summer games with the Summer SDK and GDScript. The plugin adds game-dev skills, lifecycle hooks, and a 104-tool MCP bridge for guarded project files, scene editing, asset import, play mode, diagnostics, generation, and creator workflows. Git, shell, and grep stay with the host agent. Summer follows its upstream technical base continuously; version-sensitive work uses the bundled compatibility reference instead of a fixed onboarding version. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": [

package/registry/generated/plugin.cursor.json

@@ -3,8 +3,8 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.2.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
+  "version": "3.3.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com"

package/registry/generated/plugin.factory.json

@@ -1,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/factory — do not edit; npm run generate:registry",
   "name": "summer",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
-  "version": "3.2.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
+  "version": "3.3.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",