summer-engine 3.6.0 → 3.8.0

package/library/tools/app-screenshot/resource.yaml

@@ -0,0 +1,85 @@
+id: tool/app-screenshot
+kind: tool
+version: 1.0.0
+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)
+do_not_use_when:
+  - "testing writes, sends or paid calls: they are refused in screenshots; they work in Studio"
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+    - skill/summer-apps-design
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_screenshot
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_screenshot
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+    version:
+      type: integer
+      exclusiveMinimum: 0
+      description: "A published version. Default: the current one"
+    width:
+      type: integer
+      minimum: 320
+      maximum: 1920
+      default: 1280
+      description: "Viewport width in px: 390 for a phone"
+    height:
+      type: integer
+      minimum: 320
+      maximum: 1600
+      default: 800
+    theme:
+      type: string
+      enum:
+        - light
+        - dark
+      default: light
+    fullPage:
+      type: boolean
+      default: false
+      description: Capture the whole scroll height (up to 4000 px)
+    params:
+      type: object
+      additionalProperties:
+        type: string
+        maxLength: 500
+      description: Launch params, as in /studio/apps/<id>?key=value
+    out:
+      type: string
+      minLength: 1
+      description: Also save the PNG to this local path
+  required:
+    - appId
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

package/library/tools/app-tools/resource.yaml

@@ -0,0 +1,46 @@
+id: tool/app-tools
+kind: tool
+version: 1.0.0
+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
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_tools
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_tools
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+  required:
+    - appId
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

package/library/tools/app-update/resource.yaml

@@ -0,0 +1,68 @@
+id: tool/app-update
+kind: tool
+version: 1.0.0
+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
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_update
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_update
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+    name:
+      type: string
+      minLength: 1
+      maxLength: 80
+    purpose:
+      type: string
+      maxLength: 280
+    status:
+      type: string
+      enum:
+        - scratch
+        - kept
+        - archived
+      description: "kept: the team keeps it. archived: hidden from the app list (restore with scratch or kept)"
+    folder:
+      type:
+        - string
+        - "null"
+      minLength: 1
+      maxLength: 80
+      description: null takes it out of its folder
+  required:
+    - appId
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

package/library/tools/enable-plugin/resource.yaml

@@ -0,0 +1,53 @@
+id: tool/enable-plugin
+kind: tool
+version: 1.0.0
+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
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_enable_plugin
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_enable_plugin
+    remote: false
+input_schema:
+  type: object
+  properties:
+    plugin:
+      type: string
+      minLength: 1
+      maxLength: 200
+      description: The plugin folder under res://addons/ (e.g. 'quest_tools') or its 'res://addons/<name>/plugin.cfg'
+    timeoutMs:
+      type: integer
+      minimum: 1000
+      maximum: 120000
+      description: How long the engine waits for the plugin to load (default 30000)
+  required:
+    - plugin
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: true
+  network: false
+  credentials: false
+  publish: false

package/library/tools/generate-sfx-choices/resource.yaml

@@ -1,6 +1,6 @@
 id: tool/generate-sfx-choices
 kind: tool
-version: 1.0.0
+version: 1.0.1
 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
@@ -55,7 +55,7 @@ input_schema:
       description: "2-4 model ids to compare. Default: eleven_text_to_sound_v2, sonilo-sfx-1.1, stable-audio-3-sfx"
     open:
       type: boolean
-      description: "Show the choices page to the person (their open Studio tab, else the browser). false: only return the URL"
+      description: "Show the choices page in the browser when no open Studio tab took it. false: no browser, only return the URL"
   required:
     - text
   additionalProperties: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "3.6.0",
+  "version": "3.8.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

@@ -100,6 +100,20 @@
     "summer_add_node": "tool/add-node",
     "summer_align_distribute_3d": "tool/align-distribute-3d",
     "summer_api_docs": "tool/api-docs",
+    "summer_app_call": "tool/app-call",
+    "summer_app_create": "tool/app-create",
+    "summer_app_data": "tool/app-data",
+    "summer_app_dock": "tool/app-dock",
+    "summer_app_events": "tool/app-events",
+    "summer_app_get": "tool/app-get",
+    "summer_app_guide": "tool/app-guide",
+    "summer_app_list": "tool/app-list",
+    "summer_app_page": "tool/app-page",
+    "summer_app_publish": "tool/app-publish",
+    "summer_app_report_gap": "tool/app-report-gap",
+    "summer_app_screenshot": "tool/app-screenshot",
+    "summer_app_tools": "tool/app-tools",
+    "summer_app_update": "tool/app-update",
     "summer_attach_to_surface": "tool/attach-to-surface",
     "summer_batch": "tool/batch",
     "summer_camera_bookmark": "tool/camera-bookmark",
@@ -110,10 +124,8 @@
     "summer_connect_signal": "tool/connect-signal",
     "summer_create_debug_report": "tool/create-debug-report",
     "summer_create_scene": "tool/create-scene",
-    "summer_creator_config": "tool/creator-config",
-    "summer_creator_publish": "tool/creator-publish",
-    "summer_creator_releases": "tool/creator-releases",
     "summer_debug_views": "tool/debug-views",
+    "summer_enable_plugin": "tool/enable-plugin",
     "summer_export_game": "tool/export-game",
     "summer_export_templates": "tool/export-templates",
     "summer_fabricate_3d": "tool/fabricate-3d",

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 123,
+    "skill": 125,
     "template": 19,
-    "tool": 107
+    "tool": 119
   },
-  "total": 258
+  "total": 272
 }

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.6.0",
+  "version": "3.8.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": {
@@ -113,6 +113,8 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-apps/",
+    "./library/skills/summer-apps-design/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",