summer-engine 3.5.0 → 3.5.2

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "3.5.0",
+      "version": "3.5.2",
       "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
       "author": {
         "name": "Summer Engine",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$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.5.0",
+  "version": "3.5.2",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
@@ -96,6 +96,7 @@
     "./library/skills/psx-retro-rendering/",
     "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/release-readiness/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.5.0",
+  "version": "3.5.2",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
@@ -91,6 +91,7 @@
     "./library/skills/psx-retro-rendering/",
     "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/release-readiness/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",

package/.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.5.0",
+  "version": "3.5.2",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
@@ -103,6 +103,7 @@
     "./library/skills/psx-retro-rendering/",
     "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/release-readiness/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",

package/.factory-plugin/plugin.json

@@ -2,7 +2,7 @@
   "_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 105-tool MCP bridge to the local desktop app.",
-  "version": "3.5.0",
+  "version": "3.5.2",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -88,6 +88,7 @@
     "./library/skills/psx-retro-rendering/",
     "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/release-readiness/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",

package/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to summer-engine will be documented here. Following [Keep a
 
 ## [Unreleased]
 
+Hosted games: agents check that players can actually join before a release.
+
+- **`release-readiness` check 7: export with a released Summer, and prove the scripts compile on the runtime players get.** Players' apps run a bundle on the released Summer of the version its export stamp names. A development build that still stamps an older released version can use APIs that release lacks; its scripts then fail to compile on every player's device (`Parse Error: Static function "…" not found`, `Failed to load script`) and the game opens to an empty window, while every upload check passes. The check reads the stamp from `summer-bundle.json`, compares `engineSha` with the release's, and runs `client.pck` on that released Summer with `--headless --verbose --main-pack`, failing on `SCRIPT ERROR`, `Parse Error` or `Failed to load script`. `multiplayer-publish` adds the run as step 4e, and `export-and-ship` says to export summer.games bundles with the released editor only.
+
+- **New `release-readiness` skill.** Before a version reaches players, it runs six checks on the summer.games `.zip` you upload: the bundle's `server.pck`, started with no scene, loads the authority scene; a real online join with the released version reaches the game; online play is reachable by default; the server saves online progress through player data; players can get back to the title; and `Summer.initialize` passes no hard-coded Game ID. It reports pass, fail, not applicable or not run for each, and grows by one check after every release that fails in a way none of them caught. The same checklist is in the docs at `/publishing/release-readiness`.
+- **The multiplayer skills call `Summer.initialize()` with no Game ID.** The summer.games bundle leaves `gameId` out, so an ID in code (or a fallback when it is missing) fails on the hosted server with `game_identity_mismatch` and every online join ends in `world_start_timeout`.
+- `multiplayer-publish` explains why the server preset needs the `summer_authority` custom feature, adds a pre-upload step that runs the bundle's `server.pck` with no scene, a real online join after release, and what an empty server log does and doesn't mean. `multiplayer-testing` lists what Local Play can't catch; `make-game` plans online play reachable by default, server-saved progress and a way back to the title, and runs `release-readiness` before shipping.
+
+## [3.5.2] - 2026-10-10
+
+Summer works with Kimi Code and other agents whose model checks tool schemas strictly.
+
+- Kimi Code no longer fails every prompt with `400 tools.function.parameters is not a valid moonshot flavored json schema ... items must be an object` when Summer is connected. Ten tools (`summer_align_distribute_3d`, `summer_raycast`, `summer_instantiate_scene`, `summer_capture_gameplay`, `summer_test_placement`, `summer_snap_to_surface`, `summer_navigation_probe`, `summer_attach_to_surface`, `summer_repeat_along`, `summer_game_input`) described their `[x, y, z]` and `[x, y]` vectors in a form Moonshot rejects. Every tool now lists its parameters in the JSON Schema subset strict providers accept: a vector is an array of numbers with an exact length, and no schema points into another with `$ref`. The hosted store tools get the same treatment. The tools still reject a vector of the wrong length.
+- If you added Summer tools to Kimi's `disabledTools` to work around this, remove them after updating, then restart Kimi Code.
+
+## [3.5.1] - 2026-10-10
+
+Summer Games now connects from almost every agent setup supports, and large store uploads finish.
+
+- **Summer Games in more agents.** `summer setup` now adds `summer-games` (`https://mcp.summer.games/mcp`: friends, parties and messages as you) for Cursor, GitHub Copilot in VS Code, the Copilot CLI and Copilot in JetBrains, Zed, Cline and Cline CLI, Kilo Code, OpenCode, Devin Desktop (Windsurf), Antigravity, Kiro, Trae, Warp, Goose, Hermes, Crush, Amp, Factory Droid, Junie, Qwen Code, Kimi Code, Grok Build and Mistral Vibe, as well as Claude Code and Codex. Each gets the entry in its own format, and setup prints the one sign-in step for that agent. As in 3.5.0, setup adds no second entry when the same address is already listed under another name, and `--no-games` skips it.
+- Not included, because they cannot sign in to it from their config file: Claude Desktop (add Summer Games as a custom connector in its settings), Roo Code and Rovo Dev (no sign-in for remote servers), and Visual Studio, Qoder and LM Studio (sign-in not yet checked).
+- `summer_publish_build` and `summer_publish_download` no longer fail an upload of 3 or more parts with `store_sign_failed: The store did not sign part N` when the store signed every part. Each sign now asks for every part still to upload, a part counts as unsigned only when the store was asked for it and left it out, a signing error is retried like a failed part upload, and the first failure stops the other parts' uploads.
+
 ## [3.5.0] - 2026-10-10
 
 Setup now connects Summer Games too, and agents that publish a game get further on their own. 3.4.2 was never published; its changes ship here.

package/README.md

@@ -57,7 +57,7 @@ The first run will:
 4. Open your browser for one-click sign-in.
 5. Scaffold a starter project and open the engine.
 
-In Claude Code and Codex, setup also connects Summer Games (`summer-games`), so the agent can see your friends, start parties and send messages as you. You sign in once: Claude Code `/mcp`, choose `summer-games`; Codex `/mcp login summer-games`. A summer.games page opens in your browser; sign in and choose Allow.
+In most agents (Claude Code, Codex, Cursor, GitHub Copilot (VS Code, CLI, JetBrains), Zed, Cline, Kilo Code, OpenCode, Devin Desktop, Antigravity, Kiro, Trae, Warp, Goose, Hermes, Crush, Amp, Factory, Junie, Qwen Code, Kimi Code, Grok Build and Mistral Vibe), setup also connects Summer Games (`summer-games`), so the agent can see your friends, start parties and send messages as you. You sign in once; setup prints the step for your agent (Claude Code: `/mcp`, choose `summer-games`; Codex: `/mcp login summer-games`; Cursor: Connect next to `summer-games` in its MCP settings). A summer.games page opens in your browser; sign in and choose Allow.
 
 Then ask the agent to build something.
 
@@ -125,7 +125,7 @@ npx -y summer-engine@latest setup claude-code --yes --force
 
 Replace `claude-code` with the user's actual agent: `claude-desktop`, `codex`, `cursor`, `windsurf`, `antigravity`, `cline`, `cline-cli`, `kilo-code`, `github-copilot`, `vscode-copilot`, `visual-studio`, `copilot-jetbrains`, `opencode`, `zed`, `kiro`, `goose`, `hermes`, `trae`, `qwen-code`, `kimi-code`, `crush`, `amp`, `factory`, `junie`, `warp`, `rovo-dev`, `qoder`, `grok-build`, `mistral-vibe`, `lm-studio`. Use `github-copilot` for Copilot CLI, `vscode-copilot` for GitHub Copilot Chat/Agent in VS Code, `visual-studio` for Copilot in Visual Studio, and `copilot-jetbrains` for Copilot in JetBrains IDEs. Legacy targets `gemini` and `roo-code` still work; for Google's agent use `antigravity`. This installs **every skill in the library** to `~/.claude/skills/<slug>/SKILL.md` (or the agent's own skill directory), writes the MCP server config, runs doctor, and prints what it installed and where. Preview skills are included and labelled; `--stable-only` skips them. `--force` wipes stale skill copies first. Don't use `--recommended` from this playbook; it installs only a subset.
 
-**Summer Games:** for `claude-code` and `codex`, setup also adds the remote `summer-games` MCP (`https://mcp.summer.games/mcp`) and prints a `Sign in once:` line. Tell the user that line once, in plain words: in Claude Code, run `/mcp`, choose `summer-games` and sign in; in Codex, run `/mcp login summer-games`. Their browser opens summer.games; they sign in and choose Allow. Do not wait for it; continue the playbook. If the user already added the same URL under another name (for example `summer`), setup keeps theirs and adds no second entry.
+**Summer Games:** for every agent whose sign-in summer.games accepts (all targets except `claude-desktop`, `visual-studio`, `qoder`, `rovo-dev`, `lm-studio` and the legacy ones), setup also adds the remote `summer-games` MCP (`https://mcp.summer.games/mcp`) and prints a `Sign in once:` line. Tell the user that line once, in plain words. Their browser opens summer.games; they sign in and choose Allow. Do not wait for it; continue the playbook. If the user already added the same URL under another name (for example `summer`), setup keeps theirs and adds no second entry.
 
 **First-install detection:** if `~/.claude/skills/` didn't exist before this command, Claude Code wasn't watching it and won't auto-detect the new files this session. Tell the user **once**: "Skills installed - restart your agent so they load." On subsequent installs (directory already existed), skills auto-detect mid-session and no restart is needed. **You can detect first-install vs upgrade by checking if `~/.claude/skills/` existed before Step 1; record the result before running setup.**
 
@@ -374,7 +374,7 @@ matchmaking are not promised by this package.
 | `summer tool <name> --args '<json>'` | Run any Summer tool from the shell — the same implementation the MCP tool uses. `summer tool --list` prints them all. |
 | `summer mcp [--project <path> \| --instance <id>]` | Start MCP; normally auto-binds from the agent's project directory. |
 | `summer mcp setup <agent>` | Deprecated alias of `summer setup <agent>`. |
-| `summer setup <agent> [--yes] [--force] [--recommended] [--stable-only] [--no-games]` | One shot: MCP config + all skills, preview included (`--recommended` for the subset, `--stable-only` to skip preview) + doctor. Idempotent. For Claude Code and Codex it also adds `summer-games` (`https://mcp.summer.games/mcp`: friends, parties and messages as you) unless the same URL is already listed; you sign in once through summer.games. `--no-games` skips it. |
+| `summer setup <agent> [--yes] [--force] [--recommended] [--stable-only] [--no-games]` | One shot: MCP config + all skills, preview included (`--recommended` for the subset, `--stable-only` to skip preview) + doctor. Idempotent. For most agents (not Claude Desktop, Visual Studio, Qoder, Rovo Dev, LM Studio or the legacy targets) it also adds `summer-games` (`https://mcp.summer.games/mcp`: friends, parties and messages as you) unless the same URL is already listed; you sign in once through summer.games. `--no-games` skips it. |
 
 Agents: `claude-code`, `claude-desktop`, `codex`, `cursor`, `windsurf`, `antigravity`, `cline`, `cline-cli`, `kilo-code`, `github-copilot`, `vscode-copilot`, `visual-studio`, `copilot-jetbrains`, `opencode`, `zed`, `kiro`, `goose`, `hermes`, `trae`, `qwen-code`, `kimi-code`, `crush`, `amp`, `factory`, `junie`, `warp`, `rovo-dev`, `qoder`, `grok-build`, `mistral-vibe`, `lm-studio`. Legacy (still accepted, warn on use): `gemini`, `roo-code`. Aliases: `devin`/`devin-desktop` → `windsurf`, `agy` → `antigravity`, `droid` → `factory`, `copilot` → `github-copilot`, `vscode` → `vscode-copilot`, `kilo` → `kilo-code`, `qwen` → `qwen-code`, `kimi` → `kimi-code`. Scopes: `--scope user` (default), `--scope project`.
 

package/commands/summer.md

@@ -47,6 +47,7 @@ Skills are invoked by their bare slug, such as `brainstorm-game`. There is no `s
 | add an animation to [character] | `generate-motion` |
 | wire up a state machine for [character] | `animation-tree` |
 | the game feels mushy / add juice | `game-feel` |
+| is it ready to release / check before publishing / online joins fail with `world_start_timeout` | `release-readiness` |
 | ship a trailer | `trailer-shot` |
 | cutscene for [X] | `cinematic-cutscene` |
 | let me play it | `play` |

package/dist/cli/commands/setup.js

@@ -7,7 +7,7 @@ import { TOOLKIT_VERSION as cliVersion } from "../../core/version.js";
 import { resolveDefaultChannel } from "../../installer/version-check.js";
 import { agentLabel } from "../../installer/agent-table.js";
 export const setupCommand = new Command("setup")
-    .description("Configure Summer Engine for an AI agent and run diagnostics. For Claude Code and Codex it also adds Summer Games (summer-games).")
+    .description("Configure Summer Engine for an AI agent and run diagnostics. For agents that can sign in to it, it also adds Summer Games (summer-games).")
     .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
     .option("--agent <agent>", `Agent to configure: ${supportedAgents.join(", ")}`)
     .option("--scope <scope>", "Configuration scope: user or project", "user")
@@ -16,7 +16,7 @@ export const setupCommand = new Command("setup")
     .option("--local-dev", "Point the agent at this checkout's built CLI (node <repo>/dist/bin/summer.js mcp) instead of npx summer-engine@latest — for testing unpublished builds. SUMMER_DEV=1 does the same.")
     .option("--channel <dist-tag>", "npm dist-tag the agent's MCP entry runs: npx -y summer-engine@<dist-tag> mcp (default latest; use next while a release soaks on the next tag). SUMMER_CHANNEL does the same.")
     .option("--yes", "Apply practical setup steps without prompting")
-    .option("--no-games", "Do not add the Summer Games MCP (summer-games: friends, parties and messages as you, signed in through summer.games; Claude Code and Codex)")
+    .option("--no-games", "Do not add the Summer Games MCP (summer-games: friends, parties and messages as you, signed in through summer.games)")
     .option("--json", "Print setup result as JSON")
     .option("--force", "Overwrite existing skill content (passes --force through to skills install)")
     .option("--recommended", "Install only the recommended skill subset instead of the whole library")

package/dist/core/capabilities/publish-build.d.ts

@@ -51,6 +51,10 @@ export declare function readGrants(body: Record<string, any>): Grant[];
  * Upload the given parts: signed in batches, PUT from disk, re-signed when
  * refused or about to expire. `sign` asks the store for URLs (build
  * publications bind each to its part SHA-256; store versions to its length).
+ * Each sign asks for every part not yet uploaded, including the parts other
+ * workers hold, so one sign usually covers them all. A part fails to sign only
+ * when the store was asked for it and did not sign it; the first fatal error
+ * stops the other workers and aborts their uploads.
  */
 export declare function uploadParts(sign: (partNumbers: number[]) => Promise<Grant[]>, file: string, sizeBytes: number, plan: {
     partSizeBytes: number;

package/dist/core/capabilities/publish-build.js

@@ -185,19 +185,28 @@ async function readPart(path, partNumber, partSize, sizeBytes) {
  * Upload the given parts: signed in batches, PUT from disk, re-signed when
  * refused or about to expire. `sign` asks the store for URLs (build
  * publications bind each to its part SHA-256; store versions to its length).
+ * Each sign asks for every part not yet uploaded, including the parts other
+ * workers hold, so one sign usually covers them all. A part fails to sign only
+ * when the store was asked for it and did not sign it; the first fatal error
+ * stops the other workers and aborts their uploads.
  */
 export async function uploadParts(sign, file, sizeBytes, plan, deps, parts = Array.from({ length: plan.partCount }, (_, index) => index + 1)) {
     const queue = [...parts];
+    const unfinished = new Set(parts);
     const grants = new Map();
+    const stop = new AbortController();
+    let failure;
     let signing = null;
     const fresh = (grant) => grant !== undefined && grant.expiresAt - deps.now() > 60_000;
     const grantFor = async (partNumber) => {
-        for (let attempt = 0; attempt < 3; attempt++) {
-            if (fresh(grants.get(partNumber)))
-                return grants.get(partNumber);
+        for (;;) {
+            const grant = grants.get(partNumber);
+            if (fresh(grant))
+                return grant;
             if (!signing) {
-                const batch = [...new Set([partNumber, ...queue.filter((n) => !fresh(grants.get(n)))])].slice(0, MAX_SIGNED_PARTS);
-                signing = sign(batch)
+                const others = [...unfinished].filter((n) => n !== partNumber && !fresh(grants.get(n)));
+                const batch = [partNumber, ...others].slice(0, MAX_SIGNED_PARTS);
+                const done = sign(batch)
                     .then((signed) => {
                     for (const grant of signed)
                         grants.set(grant.partNumber, grant);
@@ -205,43 +214,67 @@ export async function uploadParts(sign, file, sizeBytes, plan, deps, parts = Arr
                     .finally(() => {
                     signing = null;
                 });
+                signing = { batch, done };
+            }
+            const { batch, done } = signing;
+            await done;
+            // The store was asked for this part and did not sign it (or signed it already expiring).
+            if (batch.includes(partNumber) && !fresh(grants.get(partNumber))) {
+                throw new BuildToolError("store_sign_failed", `The store did not sign part ${partNumber}.`, "Recovery: retry; a retry continues the same upload.");
             }
-            await signing;
         }
-        throw new BuildToolError("store_sign_failed", `The store did not sign part ${partNumber}.`, "Recovery: retry; a retry continues the same upload.");
     };
-    const worker = async () => {
-        for (let partNumber = queue.shift(); partNumber !== undefined; partNumber = queue.shift()) {
-            const body = await readPart(file, partNumber, plan.partSizeBytes, sizeBytes);
-            for (let attempt = 0;; attempt++) {
+    const upload = async (partNumber) => {
+        const body = await readPart(file, partNumber, plan.partSizeBytes, sizeBytes);
+        for (let attempt = 0;; attempt++) {
+            let status = null;
+            let error = null;
+            try {
                 const grant = await grantFor(partNumber);
-                let status = null;
-                try {
-                    const response = await deps.fetch(grant.url, {
-                        method: "PUT",
-                        headers: grant.headers,
-                        body,
-                        redirect: "error",
-                        signal: AbortSignal.timeout(600_000),
-                    });
-                    if (response.ok)
-                        break;
-                    status = response.status;
-                }
-                catch {
-                    status = null;
-                }
-                // An expired or refused signature gets a new URL on the next try.
-                if (status === 400 || status === 403)
-                    grants.delete(partNumber);
-                if (attempt >= PART_RETRIES) {
-                    throw new BuildToolError("store_part_upload_failed", `Part ${partNumber} of ${plan.partCount} did not upload${status ? ` (${status})` : ""}.`, "Recovery: retry with the same file and clientVersion; the upload continues where it stopped.");
-                }
-                await deps.sleep(500 * 2 ** attempt);
+                const response = await deps.fetch(grant.url, {
+                    method: "PUT",
+                    headers: grant.headers,
+                    body,
+                    redirect: "error",
+                    signal: AbortSignal.any([stop.signal, AbortSignal.timeout(600_000)]),
+                });
+                if (response.ok)
+                    return;
+                status = response.status;
+            }
+            catch (caught) {
+                error = caught;
+            }
+            if (stop.signal.aborted)
+                return;
+            // An expired or refused signature gets a new URL on the next try.
+            if (status === 400 || status === 403)
+                grants.delete(partNumber);
+            if (attempt >= PART_RETRIES) {
+                if (error instanceof BuildToolError)
+                    throw error;
+                throw new BuildToolError("store_part_upload_failed", `Part ${partNumber} of ${plan.partCount} did not upload${status ? ` (${status})` : ""}.`, "Recovery: retry with the same file and clientVersion; the upload continues where it stopped.");
+            }
+            await deps.sleep(500 * 2 ** attempt);
+            if (stop.signal.aborted)
+                return;
+        }
+    };
+    const worker = async () => {
+        for (let partNumber = queue.shift(); partNumber !== undefined && !stop.signal.aborted; partNumber = queue.shift()) {
+            try {
+                await upload(partNumber);
+                unfinished.delete(partNumber);
+            }
+            catch (error) {
+                failure ??= error;
+                stop.abort();
             }
         }
     };
     await Promise.all(Array.from({ length: Math.min(CONCURRENCY, queue.length) }, worker));
+    if (stop.signal.aborted)
+        throw failure;
 }
 export function normalizeClientVersion(value) {
     const raw = value?.trim() ?? "";

package/dist/core/capabilities/runtime-control.d.ts

@@ -186,8 +186,8 @@ export declare const runtimeAnimateArgsSchema: z.ZodObject<{
     value?: string | number | boolean | undefined;
     instance?: string | undefined;
     name?: string | undefined;
-    cmd?: "state" | "pause" | "play" | "stop" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     space?: "local" | "global" | "both" | undefined;
+    cmd?: "state" | "pause" | "play" | "stop" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     blend?: number | undefined;
     position?: number | undefined;
     speed?: number | undefined;
@@ -205,8 +205,8 @@ export declare const runtimeAnimateArgsSchema: z.ZodObject<{
     value?: string | number | boolean | undefined;
     instance?: string | undefined;
     name?: string | undefined;
-    cmd?: "state" | "pause" | "play" | "stop" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     space?: "local" | "global" | "both" | undefined;
+    cmd?: "state" | "pause" | "play" | "stop" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     blend?: number | undefined;
     position?: number | undefined;
     speed?: number | undefined;

package/dist/installer/agent-config.d.ts

@@ -64,10 +64,10 @@ export interface RemoteMcpResult {
     signIn: string;
 }
 /**
- * Adds the Summer Games MCP next to summer-engine in the same config file.
- * An entry that already points at the same URL, under any name, counts as
- * added and is left as it is. Returns null for agents without a remote-server
- * entry in agent-table.ts.
+ * Adds the Summer Games MCP next to summer-engine in the same config file, in
+ * the agent's own entry shape (remoteMcp in agent-table.ts). An entry that
+ * already points at the same URL, under any name, counts as added and is left
+ * as it is. Returns null for agents without remoteMcp.
  */
 export declare function configureSummerGamesMcp(options: Pick<AgentConfigOptions, "agent" | "scope" | "dryRun" | "cwd" | "env">): Promise<RemoteMcpResult | null>;
 export declare const DEFAULT_CHANNEL = "latest";
@@ -85,4 +85,4 @@ export declare function mcpEntry(format: McpFormat, server: StdioMcpServerConfig
 export declare function resolvePackageRoot(): string;
 /** Directory name Gemini expects the extension under; the manifest `name` must match it. */
 export declare const GEMINI_EXTENSION_DIR_NAME = "summer-engine";
-export declare function upsertTomlArrayBlock(content: string, block: string): string;
+export declare function upsertTomlArrayBlock(content: string, block: string, name?: string): string;

package/dist/installer/agent-config.js

@@ -79,10 +79,10 @@ export async function configureAgentMcp(options) {
 export const SUMMER_GAMES_MCP_SERVER_NAME = "summer-games";
 export const SUMMER_GAMES_MCP_URL = "https://mcp.summer.games/mcp";
 /**
- * Adds the Summer Games MCP next to summer-engine in the same config file.
- * An entry that already points at the same URL, under any name, counts as
- * added and is left as it is. Returns null for agents without a remote-server
- * entry in agent-table.ts.
+ * Adds the Summer Games MCP next to summer-engine in the same config file, in
+ * the agent's own entry shape (remoteMcp in agent-table.ts). An entry that
+ * already points at the same URL, under any name, counts as added and is left
+ * as it is. Returns null for agents without remoteMcp.
  */
 export async function configureSummerGamesMcp(options) {
     const spec = agentSpec(options.agent);
@@ -92,39 +92,68 @@ export async function configureSummerGamesMcp(options) {
     const target = resolveConfigTarget(spec, options.scope, resolve(options.cwd ?? process.cwd()), env);
     const write = !options.dryRun;
     const url = SUMMER_GAMES_MCP_URL;
+    const name = SUMMER_GAMES_MCP_SERVER_NAME;
+    const entry = spec.remoteMcp.entry(url);
+    const key = topLevelKey(spec.format);
     let existing;
     let changed = false;
-    if (spec.remoteMcp.format === "toml-url") {
-        const current = await readTextFileIfExists(target.path);
-        existing = findTomlServerByUrl(current, url);
-        if (!existing) {
-            const name = SUMMER_GAMES_MCP_SERVER_NAME;
-            const next = upsertTomlTable(current, `[mcp_servers.${name}]\nurl = ${tomlString(url)}\n`, name);
+    switch (spec.format) {
+        case "toml":
+        case "toml-array": {
+            const current = await readTextFileIfExists(target.path);
+            existing = spec.format === "toml" ? findTomlServerByUrl(current, url) : findTomlArrayServerByUrl(current, url);
+            if (existing)
+                break;
+            const next = spec.format === "toml"
+                ? upsertTomlTable(current, renderTomlTable(`[mcp_servers.${name}]`, entry), name)
+                : upsertTomlArrayBlock(current, renderTomlTable("[[mcp_servers]]", entry), name);
             changed = current !== next;
             if (write && changed)
                 await writeTextFile(target.path, next);
+            break;
         }
-    }
-    else {
-        const current = await readJsonConfig(target.path);
-        existing = findJsonServerByUrl(current, url);
-        if (!existing) {
+        case "yaml-goose":
+        case "yaml-hermes": {
+            const current = await readTextFileIfExists(target.path);
+            const parsed = current.trim() === "" ? {} : parseDocument(current).toJS();
+            existing = isJsonObject(parsed) ? findServerByUrl([parsed[key]], url) : undefined;
+            if (existing)
+                break;
+            ({ changed } = await upsertYamlConfig(target.path, [key, name], entry, write));
+            break;
+        }
+        case "json-gemini":
+            throw new Error("The Gemini extension manifest has no Summer Games entry.");
+        default: {
+            const current = await readJsonConfig(target.path);
+            const maps = [current[key]];
+            // Claude Code's ~/.claude.json also keeps per-project servers (`claude
+            // mcp add` without --scope user) under projects.<dir>.mcpServers.
+            if (isJsonObject(current.projects)) {
+                for (const project of Object.values(current.projects)) {
+                    if (isJsonObject(project))
+                        maps.push(project.mcpServers);
+                }
+            }
+            existing = findServerByUrl(maps, url);
+            if (existing)
+                break;
             const next = copyJsonObject(current);
-            next.mcpServers = mergeNamedObject(next.mcpServers, SUMMER_GAMES_MCP_SERVER_NAME, { type: "http", url }, "mcpServers");
+            next[key] = mergeNamedObject(next[key], name, entry, key);
             const nextRendered = renderJsonFile(next);
             changed = renderJsonFile(current) !== nextRendered;
             if (write && changed)
                 await writeTextFile(target.path, nextRendered);
         }
     }
-    const serverName = existing ?? SUMMER_GAMES_MCP_SERVER_NAME;
+    const serverName = existing ?? name;
     return {
         serverName,
         url,
         path: target.path,
         changed,
         wrote: write && changed,
-        ...(existing && existing !== SUMMER_GAMES_MCP_SERVER_NAME ? { existingName: existing } : {}),
+        ...(existing && existing !== name ? { existingName: existing } : {}),
         signIn: spec.remoteMcp.signIn(serverName),
     };
 }
@@ -142,27 +171,62 @@ function sameMcpUrl(a, b) {
     };
     return normalize(a) === normalize(b);
 }
-/** The name of a server with this URL in mcpServers. Claude Code's
- *  ~/.claude.json also keeps per-project servers (`claude mcp add` without
- *  --scope user) under projects.<dir>.mcpServers; those count too. */
-function findJsonServerByUrl(config, url) {
-    const maps = [config.mcpServers];
-    if (isJsonObject(config.projects)) {
-        for (const project of Object.values(config.projects)) {
-            if (isJsonObject(project))
-                maps.push(project.mcpServers);
-        }
-    }
+/** Agents name a remote server's address url, serverUrl (Windsurf,
+ *  Antigravity), httpUrl (Qwen Code) or uri (Goose). */
+const REMOTE_URL_FIELDS = ["url", "serverUrl", "httpUrl", "uri"];
+/** The name of a server with this URL in any of these name -> entry maps. */
+function findServerByUrl(maps, url) {
     for (const map of maps) {
         if (!isJsonObject(map))
             continue;
         for (const [name, entry] of Object.entries(map)) {
-            if (isJsonObject(entry) && sameMcpUrl(entry.url, url))
+            if (isJsonObject(entry) && REMOTE_URL_FIELDS.some((field) => sameMcpUrl(entry[field], url)))
                 return name;
         }
     }
     return undefined;
 }
+/** The name of a [[mcp_servers]] block (Mistral Vibe) whose url is this URL. */
+function findTomlArrayServerByUrl(content, url) {
+    let block;
+    const done = () => (block?.matches ? block.name : undefined);
+    for (const line of content.split(/\r?\n/)) {
+        if (/^\s*\[/.test(line)) {
+            if (done())
+                return done();
+            block = /^\s*\[\[mcp_servers\]\]\s*(?:#.*)?$/.test(line) ? { matches: false } : undefined;
+            continue;
+        }
+        if (!block)
+            continue;
+        const field = /^\s*(name|url)\s*=\s*(?:"([^"]*)"|'([^']*)')/.exec(line);
+        if (!field)
+            continue;
+        const value = field[2] ?? field[3];
+        if (field[1] === "name")
+            block.name = value;
+        else if (sameMcpUrl(value, url))
+            block.matches = true;
+    }
+    return done();
+}
+/** A TOML table: the header line, then key = value for each entry field. */
+function renderTomlTable(header, entry) {
+    return `${[header, ...Object.entries(entry).map(([field, value]) => `${field} = ${tomlValue(value)}`)].join("\n")}\n`;
+}
+function tomlValue(value) {
+    if (typeof value === "string")
+        return tomlString(value);
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (Array.isArray(value))
+        return `[${value.map(tomlValue).join(", ")}]`;
+    if (isJsonObject(value)) {
+        const fields = Object.entries(value).map(([field, inner]) => `${field} = ${tomlValue(inner)}`);
+        return fields.length === 0 ? "{}" : `{ ${fields.join(", ")} }`;
+    }
+    throw new Error(`Cannot write ${JSON.stringify(value)} as TOML.`);
+}
 /** The name of a [mcp_servers.<name>] table whose url is this URL. */
 function findTomlServerByUrl(content, url) {
     let table;
@@ -430,10 +494,10 @@ async function upsertTomlArrayConfig(path, server, write) {
     }
     return { changed };
 }
-export function upsertTomlArrayBlock(content, block) {
+export function upsertTomlArrayBlock(content, block, name = SUMMER_MCP_SERVER_NAME) {
     const lines = content.split(/\r?\n/);
     const header = /^\s*\[\[mcp_servers\]\]\s*(?:#.*)?$/;
-    const nameLine = new RegExp(`^\\s*name\\s*=\\s*"${SUMMER_MCP_SERVER_NAME}"\\s*(?:#.*)?$`);
+    const nameLine = new RegExp(`^\\s*name\\s*=\\s*"${name}"\\s*(?:#.*)?$`);
     let start = -1;
     let end = lines.length;
     for (let index = 0; index < lines.length; index += 1) {

package/dist/installer/agent-table.d.ts

@@ -22,7 +22,6 @@ export type ConfigScope = "user" | "project";
  *  json-gemini   the Gemini extension manifest (legacy)
  */
 export type McpFormat = "json" | "json-stdio" | "json-vscode" | "json-copilot" | "json-opencode" | "json-servers" | "json-zed" | "json-amp" | "json-crush" | "json-transport" | "toml" | "toml-array" | "yaml-goose" | "yaml-hermes" | "json-gemini";
-export type RemoteMcpFormat = "json-http" | "toml-url";
 export type SkillLocationKind = "skill-dir" | "cursor-rule-dir" | "windsurf-rule-file" | "cline-rule-dir" | "opencode-skill-dir";
 export interface PathContext {
     home: string;
@@ -72,14 +71,16 @@ export interface AgentSpec {
     envOverride: string;
     format: McpFormat;
     /**
-     * How this agent lists a remote MCP server that signs in with OAuth on its
-     * own (the Summer Games player MCP). Absent: setup links the engine only.
-     *  json-http { mcpServers: { <name>: { type: "http", url } } }   (Claude Code)
-     *  toml-url  [mcp_servers.<name>] url                            (Codex)
+     * The Summer Games player MCP (a remote server that signs in with OAuth on
+     * its own) in this agent's file, under the same key as summer-engine.
+     * entry is the server's value; for TOML it is written as key = value lines.
      * signIn tells the person how to sign in once, for the entry's name.
+     * Absent: setup links the engine only (no OAuth sign-in for remote servers,
+     * no file entry for them, or a sign-in api.summer.games has not been checked
+     * to accept).
      */
     remoteMcp?: {
-        format: RemoteMcpFormat;
+        entry: (url: string) => Record<string, unknown>;
         signIn: (name: string) => string;
     };
     mcp: {