summer-engine 3.7.0 → 4.0.0

package/library/skills/voice-line/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: voice-line
-description: "Generate TTS voice lines — NPC barks, narrator, dialogue — with voice-id sourcing, a character-to-voice decision tree, and multi-line dialogue support."
+description: "Generate voice lines (NPC barks, narrator, dialogue) with a character-to-voice choice and multi-line support."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: audio
 user-invocable: true
-allowed-tools: Read Grep Glob Write Edit summer_generate_audio summer_search_assets summer_import_from_url summer_add_node summer_set_prop summer_inspect_node
+allowed-tools: Read Grep Glob Write Edit summer_assets_generate_audio summer_assets_search summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_call
 paths: [".summer/**", "audio/voice/**", "scripts/**", "**/*.tscn"]
 ---
 
@@ -13,7 +13,7 @@ paths: [".summer/**", "audio/voice/**", "scripts/**", "**/*.tscn"]
 
 ## Overview
 
-The hardest part of TTS isn't the line — it's picking the right voice. ElevenLabs ships hundreds; pick wrong and a tough warlord NPC sounds like a podcast host. **There is no MCP tool that lists voices** — the only voice-related input Summer exposes is the `voiceId` string on `summer_generate_audio`. So the voice pick has to come from the user (or from the project's cast bible), and this skill's job is to get that pick made deliberately and then locked.
+The hardest part of TTS isn't the line — it's picking the right voice; pick wrong and a tough warlord NPC sounds like a podcast host. On the ElevenLabs models **only Summer's game cast may speak**: the `voiceId` of `assets.generate_audio` must be one of the cast voices below, and any other id is refused (`voice_not_allowed`). The fal speech models (`minimax-speech-2.8-hd`, `gemini-3.8-flash-tts`, ...) speak with their own prebuilt voices instead. So the pick comes from the cast (or the project's cast bible), and this skill's job is to make that pick deliberately and then lock it.
 
 Then it generates one line (or a multi-turn dialogue) with the right stability / style / similarity / speed for the delivery — flat for narration, expressive for a bark, fast for an excited shout.
 
@@ -48,17 +48,39 @@ If a character bible exists, the voice should match the character's age / gender
 
 Check the cast bible first (step 1). If the character already has a locked id, use it and skip to step 5.
 
-If not, you need a `voiceId` from the user. There is no catalog tool and no preview-URL endpoint on this surface — do not invent one, and do not claim you auditioned anything. Ask:
+If not, pick from Summer's game cast with the user. There is no preview-URL endpoint on this surface — do not claim you auditioned anything; the person listens to the generated line. The cast (name, role, id):
 
-> I need an ElevenLabs voice id for `<character>`. Two ways to get one:
-> - Browse and audition at `elevenlabs.io/app/voice-library` (or your Voices page) and paste me the voice id.
-> - Or say "use the default" and I'll generate with Summer's default voice so you can hear the line, then we swap the id later.
->
-> Describe the target if it helps me sanity-check the pick: gender, rough age, accent, and energy (calm / measured / excited / gruff).
+| Voice | Role | Id |
+|---|---|---|
+| George | Storyteller, warm | `JBFqnCBsd6RMkjVDRZzb` |
+| Charlie | Hero, deep, energetic | `IKne3meq5aSn9XLyUdCD` |
+| Jessica | Heroine, playful | `cgSgspJ2msm6clMCkdW9` |
+| Harry | Warrior, fierce | `SOYHLrjzK2X1ezoPC6cr` |
+| Callum | Trickster, husky | `N2lVS1w4EtoT3dr4eOWO` |
+| Brian | Narrator, deep | `nPczCjzI2devNBz1zQrb` |
+| Bill | Elder, wise | `pqHfZKP75CvOlQylNhV4` |
+| Sarah | Mentor, reassuring | `EXAVITQu4vr4xnSDxMaL` |
+| Adam | Villain, firm | `pNInz6obpgDQGcFmaJgB` |
+| Roger | Captain, laid back | `CwhRBWXzGAHq8TQ4Fs17` |
+| Lily | Actress, velvety | `pFZP5JQG7iQjIQuC4Bku` |
+| Liam | Streamer, energetic | `TX3LPaxmHKxFdv7VOQHJ` |
+| Matilda | Guide, knowledgeable | `XrExE9yKIg1WjnnlVkGX` |
+| Daniel | Broadcaster, steady | `onwK4e9ZLuTAKqWW03F9` |
+| River | Courier, relaxed | `SAz9YHcvj6GT2YYXdXww` |
+| Bella | Healer, bright | `hpp4J3VqNfWAUOO0d1Us` |
+| Laura | Sidekick, quirky | `FGY2WhTYpPnrIDTdsKH5` |
+| Alice | Oracle, clear | `Xb7hH8MSUJpSbSDYk0k2` |
+| Eric | Merchant, smooth | `cjVigY5qzO86Huf0OWal` |
+| Chris | Companion, charming | `iP95p4xoKVk53GoZ742B` |
+| Will | Adventurer, optimistic | `bIHbv24MWmeRgasZH58o` |
+
+Ask:
 
-Omitting `voiceId` entirely is valid — `summer_generate_audio` falls back to a single default voice (`JBFqnCBsd6RMkjVDRZzb`). That is fine for a throwaway read-through, never for a shipped cast.
+> For `<character>` I suggest `<voice>` (<role>). OK, or another cast voice?
 
-Voice is the highest-stakes audio decision in the project. Do not pick an id for the user and do not guess ids — a wrong id is a hard provider error, not a different-sounding voice.
+Omitting `voiceId` entirely is valid — `assets.generate_audio` falls back to the default voice (George, `JBFqnCBsd6RMkjVDRZzb`). That is fine for a throwaway read-through, never for a shipped cast.
+
+Voice is the highest-stakes audio decision in the project. Do not guess ids — an id outside the cast is refused, not a different-sounding voice.
 
 ### 3. Character-to-voice decision tree (when the user wants a recommendation)
 
@@ -81,7 +103,7 @@ If the user says "you pick", lean on this tree:
 
 After the pick:
 
-> Locked voice: `Hodge` (id `21m00Tcm4TlvDq8ikWAM`). I'll use this for all `<character>` lines unless you say otherwise.
+> Locked voice: `Roger` (id `CwhRBWXzGAHq8TQ4Fs17`). I'll use this for all `<character>` lines unless you say otherwise.
 
 Ask before writing:
 
@@ -104,8 +126,8 @@ providers:
 
 | Character | Voice name | Voice id | Notes |
 |---|---|---|---|
-| Captain Hodge | Hodge | 21m00Tcm4TlvDq8ikWAM | Calm, weathered, low-mid |
-| Bram the Smith | Brogan | <id> | Gruff Scottish, mid energy |
+| Captain Hodge | Roger | CwhRBWXzGAHq8TQ4Fs17 | Calm, weathered, low-mid |
+| Bram the Smith | Harry | SOYHLrjzK2X1ezoPC6cr | Gruff, mid energy |
 ```
 
 This is the cast bible. Every future voice line uses these ids — consistency is the point.
@@ -114,7 +136,7 @@ If legacy `.summer/voice-cast.md` already exists, read it first and either keep
 
 ### 5. Tune stability / similarity / style / speed for delivery
 
-These are **not** top-level tool arguments. They go inside `options.voiceSettings`, in camelCase, exactly as the ElevenLabs SDK's `VoiceSettings` type spells them — `stability`, `similarityBoost`, `style`, `speed`, `useSpeakerBoost`. `options` is spread straight into the SDK call, so a flat `similarity_boost` at the top of `options` is silently dropped.
+These go in the `voiceSettings` object of `assets.generate_audio`, in camelCase — `stability`, `similarityBoost`, `style`, `speed`, `useSpeakerBoost`. A snake_case key such as `similarity_boost` is not one of its fields and does nothing.
 
 | Param | Range | Effect |
 |---|---|---|
@@ -163,18 +185,18 @@ Example lines:
 ### 7. Confirm and call
 
 ```
-summer_generate_audio(
-  capability="text_to_speech",
-  text="Hold the line. They're coming through the south gate. Ready arrows.",
-  voiceId="21m00Tcm4TlvDq8ikWAM",
-  modelId="eleven_multilingual_v2",
-  options={ voiceSettings: { stability: 0.6, similarityBoost: 0.75, style: 0.2, speed: 1.0 } }
-)
+assets.generate_audio({
+  capability: "text_to_speech",
+  text: "Hold the line. They're coming through the south gate. Ready arrows.",
+  voiceId: "CwhRBWXzGAHq8TQ4Fs17",
+  modelId: "eleven_multilingual_v2",
+  voiceSettings: { stability: 0.6, similarityBoost: 0.75, style: 0.2, speed: 1.0 }
+})
 ```
 
-`modelId` defaults to `eleven_multilingual_v2`. For very short / latency-sensitive in-game barks, `eleven_turbo_v2_5` is faster; for highest fidelity, `eleven_multilingual_v2` is the default.
+`modelId` defaults to `eleven_multilingual_v2`. For very short / latency-sensitive in-game barks, `eleven_flash_v2_5` is faster; for highest fidelity, `eleven_multilingual_v2` is the default. A line spends the person's credits; `dryRun: true` returns its `estimate` first.
 
-There is no `outputPath` — the tool returns a hosted asset (MP3, `audio/mpeg`). Land it in the project explicitly:
+There is no `outputPath` — the answer is a hosted asset, `asset` (`assetId`, `fileUrl`, `durationSeconds`; MP3, `audio/mpeg`). Land it in the project explicitly:
 
 ```
 summer_import_from_url(url="<fileUrl>", path="res://audio/voice/hodge_hold_the_line.mp3")
@@ -182,33 +204,38 @@ summer_import_from_url(url="<fileUrl>", path="res://audio/voice/hodge_hold_the_l
 
 ### 8. Multi-line dialogue (two or more speakers)
 
-Use `summer_generate_audio` with `capability: "text_to_dialogue"`:
+Use `assets.generate_audio` with `capability: "text_to_dialogue"`:
 
 There is no `speakers` roster and no `script` array. The whole conversation is one flat `inputs` array of `{ text, voiceId }` objects, in turn order — the voice id is repeated on every line:
 
 ```
-summer_generate_audio(
-  capability="text_to_dialogue",
-  inputs=[
-    { text: "They're at the gate.",   voiceId: "21m00Tcm4TlvDq8ikWAM" },
-    { text: "Aye. Let 'em come.",     voiceId: "<brogan-id>" },
-    { text: "Steady. On my mark.",    voiceId: "21m00Tcm4TlvDq8ikWAM" }
+assets.generate_audio({
+  capability: "text_to_dialogue",
+  inputs: [
+    { text: "They're at the gate.",   voiceId: "CwhRBWXzGAHq8TQ4Fs17" },
+    { text: "Aye. Let 'em come.",     voiceId: "SOYHLrjzK2X1ezoPC6cr" },
+    { text: "Steady. On my mark.",    voiceId: "CwhRBWXzGAHq8TQ4Fs17" }
   ]
-)
+})
 ```
 
-`inputs` is required for this capability; omitting it is a 400 `inputs_required`. `modelId` defaults to `eleven_v3` here, not `eleven_multilingual_v2`. The result is a single MP3 with both voices and dialogue-aware pacing the model handles internally — import it with `summer_import_from_url` like any other clip. For very long scripts, split into chunks of ~6 turns and concatenate.
+`inputs` is required for this capability; omitting it is refused as invalid input (`inputs_required`). `modelId` defaults to `eleven_v3` here, not `eleven_multilingual_v2`. The result is a single MP3 with both voices and dialogue-aware pacing the model handles internally — import it with `summer_import_from_url` like any other clip. For very long scripts, split into chunks of ~6 turns and concatenate.
 
 ### 9. Wire the line as `AudioStreamPlayer` on the Voice bus
 
-Every scene-mutating tool takes an explicit `scenePath`, node paths are relative to the scene root (`./`), and the property argument is named `key`, not `property`:
+One script adds the player with its settings; `scenePath` is the exact scene to change:
 
 ```
-summer_add_node(scenePath="res://main.tscn", parent="./NPC", type="AudioStreamPlayer", name="VoiceLine")
-summer_set_prop(scenePath="res://main.tscn", path="./NPC/VoiceLine", key="stream", value="res://audio/voice/hodge_hold_the_line.mp3")
-summer_set_prop(scenePath="res://main.tscn", path="./NPC/VoiceLine", key="bus", value="Voice")
-summer_set_prop(scenePath="res://main.tscn", path="./NPC/VoiceLine", key="volume_db", value=0.0)
-summer_set_prop(scenePath="res://main.tscn", path="./NPC/VoiceLine", key="autoplay", value=false)
+summer_run_script(scenePath="res://main.tscn", source="""
+func run(ctx):
+    ctx.add_node("AudioStreamPlayer", "VoiceLine", ctx.find("NPC"), {
+        "stream": load("res://audio/voice/hodge_hold_the_line.mp3"),
+        "bus": "Voice",
+        "volume_db": 0.0,
+        "autoplay": false,
+    })
+    ctx.save_scene()
+""")
 ```
 
 For positional NPCs, `AudioStreamPlayer3D` with `max_distance=15.0` so distant NPCs aren't audible.
@@ -238,7 +265,7 @@ Narrator intimate:        warmer mid pitch, lower stability for breath
 
 ## Anti-patterns
 
-- **Inventing a voice catalog.** There is no `summer_list_models`, no voice-listing tool, and no preview URLs on this surface. Ask the user for the id.
+- **Inventing voices.** On the ElevenLabs models only the cast in step 2 may speak, and there are no preview URLs on this surface. Pick from the cast with the user.
 - **Guessing a voice id.** A wrong id is a provider error, not a different voice.
 - **Reusing a voice id across two characters.** Players notice instantly. Lock the cast.
 - **Changing a locked voice without approval.** A cast voice is project memory, not a throwaway generation option.
@@ -257,6 +284,10 @@ Narrator intimate:        warmer mid pitch, lower stability for breath
 - **User wants the line shorter on regen.** Edit the text first; don't try to compress with `speed` past 1.15 (artifacts).
 - **NPC bark variants.** Generate 3–5 variants of the same intent (`"They're at the gate!"`, `"Enemy approaching!"`, `"Look out!"`) and pick at random in code so the bark doesn't repeat.
 
+## Without Summer Engine
+
+In a session without Summer Engine tools (the assets profile; the `summer-assets` skill has the whole loop), do steps 1-8 and skip step 9 (`AudioStreamPlayer`). Step 10 still applies when the project has a `.summer/` folder; otherwise give the person the voice id with the files. Save the file where the person asked with `out` (the `summer-assets` skill says how), and tell them the path and format.
+
 ## Fallback (no MCP)
 
 Print the call (text, voice id, params, target path). User runs via the Summer dashboard, then `summer_import_from_url` the result.

package/library/skills/voice-line/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/voice-line
 kind: skill
 version: 1.0.2
-summary: Generate TTS voice lines — NPC barks, narrator, dialogue — with voice-id sourcing, a character-to-voice decision tree, and multi-line dialogue support.
+summary: "Generate voice lines (NPC barks, narrator, dialogue) with a character-to-voice choice and multi-line support."
 use_when:
   - '"the NPC needs a greeting / a bark / a narrator intro read aloud"'
   - giving a character a voice that fits their personality (gruff, cheerful, robotic)

package/library/skills/web-and-touch-input/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-and-touch-input
-description: "Input for the browser and phones: the first-click rule for sound and mouse capture, focus, and touch buttons or a virtual stick on the same actions."
+description: "Browser and phone input: the first-click rule for sound and mouse capture, focus, touch buttons, a stick."
 license: MIT
 compatibility: [Cursor, Claude Code, Codex, Windsurf, Gemini, OpenCode]
 category: scene-and-project

package/library/skills/web-and-touch-input/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/web-and-touch-input
 kind: skill
 version: 1.0.0
-summary: "Input for the browser and phones: the first-click rule for sound and mouse capture, focus, and touch buttons or a virtual stick on the same actions."
+summary: "Browser and phone input: the first-click rule for sound and mouse capture, focus, touch buttons, a stick."
 use_when:
   - the game plays in the browser and sound, mouse capture or keys do not work until something is clicked
   - the game should be playable on a phone or tablet with touch controls

package/library/skills/web-compatibility-look/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: web-compatibility-look
-description: "Make a web or browser game look high-end in the Compatibility renderer (WebGL 2): what works, what to avoid, 2D and 3D recipes, web performance."
+description: "Make a browser game look high-end in the Compatibility renderer (WebGL 2): what works, recipes, speed."
 license: MIT
 compatibility: [Cursor, Claude Code, Codex, Windsurf, Gemini, OpenCode]
 category: rendering-and-lighting

package/library/skills/web-compatibility-look/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/web-compatibility-look
 kind: skill
 version: 1.0.0
-summary: "Make a web or browser game look high-end in the Compatibility renderer (WebGL 2): what works, what to avoid, 2D and 3D recipes, web performance."
+summary: "Make a browser game look high-end in the Compatibility renderer (WebGL 2): what works, recipes, speed."
 use_when:
   - the game plays in the browser or is exported for the web and must look finished
   - the look is flat, grey or default in the web preview, or a Forward+ feature does nothing there

package/library/skills/world-building-3d/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: world-building-3d
-description: "Compose, ground, space, and validate 3D scenes with Summer's four bounded spatial tools — exact paths, one geometric decision at a time, verified."
+description: "Compose, ground and space 3D scenes with Summer's four spatial tools, one geometric decision at a time."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: scene-and-project

package/library/skills/world-building-3d/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/world-building-3d
 kind: skill
 version: 1.1.1
-summary: Compose, ground, space, and validate 3D scenes with Summer's four bounded spatial tools — exact paths, one geometric decision at a time, verified.
+summary: "Compose, ground and space 3D scenes with Summer's four spatial tools, one geometric decision at a time."
 use_when:
   - placing or grounding props on floors, shelves, ramps, or tables without hand-tuning transforms
   - aligning or evenly spacing a group of 3D objects along one world axis

package/library/skills/writing-skills/resource.yaml

@@ -22,6 +22,7 @@ source: official
 license: MIT
 status: stable
 recommended: false
+bundled: false
 aliases:
   - skills/workflow/writing-skills
 lint_exceptions:

package/library/tools/add-node/GUIDE.md

@@ -0,0 +1,14 @@
+# summer_add_node
+
+Add a new node to the scene tree.
+
+Pass the exact res:// scenePath to mutate. The scene does not need to be the
+active editor tab.
+
+Common node types:
+- 3D: Node3D, MeshInstance3D, CharacterBody3D, RigidBody3D, StaticBody3D, Camera3D, DirectionalLight3D, OmniLight3D, SpotLight3D, WorldEnvironment, CollisionShape3D, Area3D
+- 2D: Node2D, Sprite2D, CharacterBody2D, RigidBody2D, StaticBody2D, Camera2D, CollisionShape2D, Area2D, TileMapLayer
+- UI: Control, Label, Button, TextEdit, Panel, VBoxContainer, HBoxContainer, MarginContainer
+- Audio: AudioStreamPlayer, AudioStreamPlayer3D
+
+The parent path uses "./" prefix for relative paths from scene root. E.g., "./World" means the "World" child of the root node.

package/library/tools/align-distribute-3d/GUIDE.md

@@ -0,0 +1,7 @@
+# summer_align_distribute_3d
+
+Align or equal-space an explicit ordered list of 3D subjects along one world-space axis, then save the exact target scene.
+
+Every anchor and extent comes from visible descendant GeometryInstance3D world AABBs (evidence: visual_aabb). The tool never uses editor selection and fails instead of fabricating bounds. It preserves each subject's authored basis and scale, translates only along the normalized axis, and records all changed transforms in one undoable editor operation.
+
+Alignment modes use the first ordered subject's minimum, center, or maximum projected anchor. Distribution modes keep the first and last subjects fixed and honor caller order. distribute_gaps accounts for each subject's projected half-extent and fails if the endpoint span cannot fit non-overlapping equal gaps. The compact result returns ordered before/after origins, resolved spacing, and numeric residuals under 5 KB. On an engine build that predates AlignDistribute3D the result is a structured engine_lacks_op failure naming the fallback.

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

@@ -0,0 +1,59 @@
+id: tool/app-call
+kind: tool
+version: 1.0.0
+summary: Run one of a Summer App's agent tools inside the person's open app.
+use_when:
+  - '"nerf the bow using the balance formula in our app"'
+  - using logic that lives in an app (a balance formula, an export) while the app is open
+do_not_use_when:
+  - "plain reads and edits of app data: apps.read_data, apps.write_data"
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_call
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_call
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+    tool:
+      type: string
+      minLength: 1
+      maxLength: 64
+      description: The agent tool name from summer_app_tools
+    input:
+      type: object
+      additionalProperties: {}
+      default: {}
+      description: Input matching the tool's input schema
+  required:
+    - appId
+    - tool
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

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

@@ -0,0 +1,67 @@
+id: tool/app-create
+kind: tool
+version: 1.0.0
+summary: Create a new scratch Summer App (a tool for the person's team inside Summer Studio) and open it in their Studio tab.
+use_when:
+  - '"build me a tool for…" / "make an app that…"'
+  - the person needs a UI to decide or edit something they will come back to
+do_not_use_when:
+  - "a one-off answer: reply in chat"
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_create
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_create
+    remote: true
+input_schema:
+  type: object
+  properties:
+    name:
+      type: string
+      minLength: 1
+      maxLength: 80
+    purpose:
+      type: string
+      maxLength: 280
+      description: "One line: what the tool does and where its data goes"
+    format:
+      type: string
+      enum:
+        - code
+        - layout
+      default: code
+      description: "code: index.html + JS/CSS (default). layout: a JSON layout of kit nodes, for quick decision UIs"
+    workspaceId:
+      type: string
+      format: uuid
+      description: "A workspace id. Default: the person's team (the one their Studio tab is on, else their latest team, else personal); the result's workspace says which"
+    folder:
+      type: string
+      minLength: 1
+      maxLength: 80
+  required:
+    - name
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

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

@@ -0,0 +1,74 @@
+id: tool/app-data
+kind: tool
+version: 1.0.0
+summary: Read or write a Summer App's shared data collections; works with no app open and the team sees writes live.
+use_when:
+  - '"nerf the bow in our balance sheet"'
+  - seeding an app with data
+  - reading what the team entered in an app
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_data
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_data
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+    collection:
+      type: string
+      maxLength: 48
+      description: "Read: one collection. Default: all"
+    after:
+      type: string
+      maxLength: 200
+      description: "Read: the next cursor from the previous page"
+    limit:
+      type: integer
+      minimum: 1
+      maximum: 500
+      default: 200
+    ops:
+      type: array
+      items:
+        type: object
+        additionalProperties: {}
+      minItems: 1
+      maxItems: 100
+      description: "Write: [{op: put, collection, recordId, data}, {op: patch, collection, recordId, patch}, {op: remove, collection, recordId}]; ifRevision on an op applies it only at that record revision (0: must not exist)"
+    as:
+      type: string
+      enum:
+        - agent
+        - seed
+      description: "Write: seed for starter data that belongs to the team (no author). Default: agent"
+  required:
+    - appId
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false

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

@@ -0,0 +1,59 @@
+id: tool/app-dock
+kind: tool
+version: 1.0.0
+summary: Dock a Summer App as a panel in the running Summer Engine editor, close it, or list docked apps.
+use_when:
+  - '"put the quest editor next to my scene"'
+  - keeping a team tool open while editing
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_dock
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_dock
+    remote: false
+input_schema:
+  type: object
+  properties:
+    action:
+      type: string
+      enum:
+        - open
+        - close
+        - list
+      default: open
+    appId:
+      type: string
+      format: uuid
+      description: "open, close: the app"
+    slot:
+      type: string
+      enum:
+        - left
+        - right
+        - bottom
+      default: right
+      description: "open: left, right or bottom"
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: true
+  network: false
+  credentials: false
+  publish: false

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

@@ -0,0 +1,68 @@
+id: tool/app-events
+kind: tool
+version: 1.0.0
+summary: "Wait for what a Summer App sends to agents: summer.agent.send events, app errors, feedback and tool calls."
+use_when:
+  - waiting for the person to act in an app you built
+  - checking an app for errors after publishing
+facets:
+  lifecycle:
+    - build
+  domains:
+    - tools
+    - ui
+compatibility:
+  engine: ">=4.6"
+related:
+  skills:
+    - skill/summer-apps
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_app_events
+implementation:
+  module: src/mcp/tools/app-tools.ts
+  export: registerAppTools
+surfaces:
+  mcp:
+    tool_name: summer_app_events
+    remote: true
+input_schema:
+  type: object
+  properties:
+    appId:
+      type: string
+      format: uuid
+      description: The app id from summer_app_create or summer_app_list
+    after:
+      type: integer
+      minimum: 0
+      default: 0
+      description: "Return events after this cursor (0: from the start). Pass the returned cursor next time"
+    timeoutSeconds:
+      type: integer
+      minimum: 0
+      maximum: 50
+      default: 25
+      description: Wait up to this long (max 50) for the first new event
+    kinds:
+      type: array
+      items:
+        type: string
+        enum:
+          - agent
+          - error
+          - feedback
+          - tool
+      maxItems: 4
+      description: "Default: agent, error, feedback"
+  required:
+    - appId
+  additionalProperties: false
+authority:
+  filesystem: false
+  editor_mutation: false
+  network: true
+  credentials: false
+  publish: false