summer-engine 3.5.1 → 3.6.0

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.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.5.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
+  "version": "3.6.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 107-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -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,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.5.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge. Build games by talking.",
+  "version": "3.6.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 107-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -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/",
@@ -150,7 +151,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 105-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 107-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/.cursor-plugin/plugin.json

@@ -3,8 +3,8 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.5.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
+  "version": "3.6.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 107-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com"
@@ -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

@@ -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 105-tool MCP bridge to the local desktop app.",
-  "version": "3.5.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 107-tool MCP bridge to the local desktop app.",
+  "version": "3.6.0",
   "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

@@ -2,7 +2,28 @@
 
 All notable changes to summer-engine will be documented here. Following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
 
-## [Unreleased]
+## [3.6.0] - 2026-10-12
+
+Pick your sound effects by ear, and hosted games: agents check that players can actually join before a release.
+
+- **Three versions of a sound effect, picked in Summer Studio.** The best sound-effect model changes a lot from one sound to the next. The first time you ask for a sound effect in a chat, the `sound-effect` skill now asks whether you want three versions from three models. If you say yes, the new `summer_generate_sfx_choices` makes them and shows them on a Summer Studio page: in your open Studio tab when you are signed in to the store, else in your browser, else as a link. You listen and approve one or more; `summer_get_choices` tells the agent which ones, and it imports and wires them. The model you approve becomes your default for later sound effects.
+- `summer_generate_audio` sound effects take `modelId` (`eleven_text_to_sound_v2`, `sonilo-sfx-1.1`, `stable-audio-3-sfx`; left out, your approved default runs, else ElevenLabs) and `loop` for seamless loops (ElevenLabs only). Existing calls work as before.
+- The `sound-effect` skill has prompt shapes that held up in testing: a Foley one-shot with the materials, the attack and the tail; exact event times for sequences such as a rifle reload; "air movement only" for whooshes; and the minimum length of each model. `ambient-bed` names the looping model, and `audio-direction` makes its first sounds through `sound-effect`.
+
+- **`release-readiness` check 10: a signed-in player keeps playing for three minutes.** A released game closed for every player about a minute in, with "That link can't be opened", and left them signed out: a Summer service refused the player's sign-in and the app ended play. The fault was Summer's, and no check on the game's files could see it. The check asks the user to play the released version for 3 minutes in each Summer Games app, through an analytics event, and to report a close or sign-out to Summer with the time. `multiplayer-publish` step 6 points to it.
+- **`release-readiness` checks 8 and 9: every file the game reads is in the pack, and the export is on the apps' Summer version line.** A release's uploaded pack left out a font file the game read with `FileAccess`; it fell back to `SystemFont`, which draws every glyph as a box on iPhone, while desktop looked right. Check 8 traces every by-path read, checks the summer.games preset's non-resource filter, lists `client.pck` with a short `--script` probe, bans `SystemFont` for phone text and asks for a look at the text on an iPhone. Another release was a 0.6 export, and a Summer Games phone app that carries 0.7 refused it with "The game could not start" while desktop ran it. Check 9 compares the export's MAJOR.MINOR with the current Summer release. `export-and-ship`, `ui-basics` and `multiplayer-publish` point to both.
+- **`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
 

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/core/capabilities/sfx-choices.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+/**
+ * Sound-effect choices (summer_generate_sfx_choices + summer_get_choices).
+ *
+ * Sound-effect models differ a lot from one sound to the next, so the agent
+ * can make one sound with several models and let the person pick by ear:
+ * POST /api/mcp/generate/audio/choices makes the versions and a choice set,
+ * the person listens and approves one or more on the Studio page
+ * /studio/choices/<id>, and GET /api/mcp/choices/<id> reads the decision.
+ * An approval makes that model the person's default for later
+ * summer_generate_audio sound_effects calls without a modelId.
+ *
+ * One implementation for both faces: the MCP tools (generate-tools.ts) and
+ * `summer tool generate-sfx-choices` / `get-choices` (tool-dispatch.ts) pass
+ * their own gateway request functions and share everything else here.
+ */
+export declare const SFX_MODEL_IDS: readonly ["eleven_text_to_sound_v2", "sonilo-sfx-1.1", "stable-audio-3-sfx"];
+export type SfxModelId = (typeof SFX_MODEL_IDS)[number];
+export declare const SFX_CHOICES_ENDPOINT = "/api/mcp/generate/audio/choices";
+export declare const CHOICES_ENDPOINT_PREFIX = "/api/mcp/choices/";
+/** Three models run in parallel on the server; the slowest decides. */
+export declare const SFX_CHOICES_TIMEOUT_MS = 240000;
+export declare const MAX_CHOICES_WAIT_SECONDS = 50;
+export declare const sfxChoicesArgsSchema: z.ZodObject<{
+    text: z.ZodString;
+    durationSeconds: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    models: z.ZodOptional<z.ZodArray<z.ZodEnum<["eleven_text_to_sound_v2", "sonilo-sfx-1.1", "stable-audio-3-sfx"]>, "many">>;
+    open: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    open: boolean;
+    durationSeconds?: number | undefined;
+    loop?: boolean | undefined;
+    models?: ("eleven_text_to_sound_v2" | "sonilo-sfx-1.1" | "stable-audio-3-sfx")[] | undefined;
+}, {
+    text: string;
+    open?: boolean | undefined;
+    durationSeconds?: number | undefined;
+    loop?: boolean | undefined;
+    models?: ("eleven_text_to_sound_v2" | "sonilo-sfx-1.1" | "stable-audio-3-sfx")[] | undefined;
+}>;
+export type SfxChoicesArgs = z.input<typeof sfxChoicesArgsSchema>;
+export declare const getChoicesArgsSchema: z.ZodObject<{
+    choiceSetId: z.ZodString;
+    waitSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    choiceSetId: string;
+    waitSeconds?: number | undefined;
+}, {
+    choiceSetId: string;
+    waitSeconds?: number | undefined;
+}>;
+export type GetChoicesArgs = z.input<typeof getChoicesArgsSchema>;
+/** A gateway reply as both faces' request helpers produce it. */
+export interface GatewayReply {
+    data?: any;
+    error?: string;
+    status: number;
+}
+export type StudioOpenOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface SfxChoicesDeps {
+    post(endpoint: string, body: Record<string, unknown>, timeoutMs: number): Promise<GatewayReply>;
+    get(endpoint: string, params: URLSearchParams, timeoutMs: number): Promise<GatewayReply>;
+    /** Move the person's open Studio tab to a /studio path (reviewUrl: the same page as a full URL). */
+    studioOpen(path: string, reviewUrl: string): Promise<StudioOpenOutcome>;
+    openUrl(url: string): Promise<unknown>;
+    canOpenBrowser(): boolean;
+}
+export type ShownIn = "studio_tab" | "browser" | "not_opened";
+/** Same rule as summer_open: a browser only ever opens summerengine.com, its subdomains, or loopback. */
+export declare function canOpenReviewUrl(url: string): boolean;
+/** False where a browser launch cannot reach the person: CI, or Linux with no display. */
+export declare function defaultCanOpenBrowser(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+/**
+ * Move the person's open Studio tab through the hosted Summer Engine MCP's
+ * summer_studio_open (needs the store sign-in). Only for the production site:
+ * the hosted MCP moves tabs on summerengine.com, so a review page on another
+ * origin (a preview deploy, local web dev) is opened in the browser instead.
+ */
+export declare function openInStudioTab(path: string, reviewUrl: string): Promise<StudioOpenOutcome>;
+export declare function sfxChoicesRequestBody(args: z.output<typeof sfxChoicesArgsSchema>): Record<string, unknown>;
+export declare function generateSfxChoices(args: z.output<typeof sfxChoicesArgsSchema>, deps: SfxChoicesDeps): Promise<Record<string, unknown>>;
+export declare function choicesEndpoint(choiceSetId: string): string;
+export declare function choicesTimeoutMs(waitSeconds: number | undefined): number;
+export declare function getChoices(args: z.output<typeof getChoicesArgsSchema>, deps: Pick<SfxChoicesDeps, "get">): Promise<Record<string, unknown>>;

package/dist/core/capabilities/sfx-choices.js

@@ -0,0 +1,291 @@
+import { z } from "zod";
+import { hasStoreSignIn, hostedResultPayload, withHostedMcp } from "../hosted-mcp.js";
+import { resolveMcpResourceUrl } from "../oauth.js";
+/**
+ * Sound-effect choices (summer_generate_sfx_choices + summer_get_choices).
+ *
+ * Sound-effect models differ a lot from one sound to the next, so the agent
+ * can make one sound with several models and let the person pick by ear:
+ * POST /api/mcp/generate/audio/choices makes the versions and a choice set,
+ * the person listens and approves one or more on the Studio page
+ * /studio/choices/<id>, and GET /api/mcp/choices/<id> reads the decision.
+ * An approval makes that model the person's default for later
+ * summer_generate_audio sound_effects calls without a modelId.
+ *
+ * One implementation for both faces: the MCP tools (generate-tools.ts) and
+ * `summer tool generate-sfx-choices` / `get-choices` (tool-dispatch.ts) pass
+ * their own gateway request functions and share everything else here.
+ */
+export const SFX_MODEL_IDS = ["eleven_text_to_sound_v2", "sonilo-sfx-1.1", "stable-audio-3-sfx"];
+export const SFX_CHOICES_ENDPOINT = "/api/mcp/generate/audio/choices";
+export const CHOICES_ENDPOINT_PREFIX = "/api/mcp/choices/";
+/** Three models run in parallel on the server; the slowest decides. */
+export const SFX_CHOICES_TIMEOUT_MS = 240_000;
+export const MAX_CHOICES_WAIT_SECONDS = 50;
+const STUDIO_OPEN_TIMEOUT_MS = 20_000;
+export const sfxChoicesArgsSchema = z.object({
+    text: z
+        .string()
+        .min(1)
+        .max(1000)
+        .describe("The sound to make, written as a Foley description (what hits what, the attack and the tail, close-mic, dry)"),
+    durationSeconds: z
+        .number()
+        .positive()
+        .max(30)
+        .optional()
+        .describe("Exact length in seconds. One-shots 0.5-2; animation-synced sounds match the animation. stable-audio-3-sfx needs >= 1, sonilo-sfx-1.1 >= 0.5"),
+    loop: z
+        .boolean()
+        .optional()
+        .describe("Ask for a seamless loop (eleven_text_to_sound_v2 only; say 'seamless loop' in text too)"),
+    models: z
+        .array(z.enum(SFX_MODEL_IDS))
+        .min(2)
+        .max(4)
+        .optional()
+        .describe("2-4 model ids to compare. Default: eleven_text_to_sound_v2, sonilo-sfx-1.1, stable-audio-3-sfx"),
+    open: z
+        .boolean()
+        .default(true)
+        .describe("Show the choices page to the person (their open Studio tab, else the browser). false: only return the URL"),
+});
+export const getChoicesArgsSchema = z.object({
+    choiceSetId: z.string().min(1).max(200).describe("The choiceSetId from summer_generate_sfx_choices"),
+    waitSeconds: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_CHOICES_WAIT_SECONDS)
+        .optional()
+        .describe("Wait up to this many seconds (max 50) for the person to decide before answering. 0 or omitted: answer now"),
+});
+// ---------------------------------------------------------------------------
+// Showing the page
+// ---------------------------------------------------------------------------
+function hostOf(url) {
+    try {
+        return new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+function isSummerHost(host) {
+    return host === "summerengine.com" || (host?.endsWith(".summerengine.com") ?? false);
+}
+function isLoopback(host) {
+    return host === "localhost" || host === "127.0.0.1" || host === "[::1]" || host === "::1";
+}
+/** Same rule as summer_open: a browser only ever opens summerengine.com, its subdomains, or loopback. */
+export function canOpenReviewUrl(url) {
+    const host = hostOf(url);
+    return isSummerHost(host) || isLoopback(host);
+}
+/** False where a browser launch cannot reach the person: CI, or Linux with no display. */
+export function defaultCanOpenBrowser(env = process.env, platform = process.platform) {
+    if (env.CI)
+        return false;
+    if (platform === "linux" && !env.DISPLAY && !env.WAYLAND_DISPLAY)
+        return false;
+    return true;
+}
+/**
+ * Move the person's open Studio tab through the hosted Summer Engine MCP's
+ * summer_studio_open (needs the store sign-in). Only for the production site:
+ * the hosted MCP moves tabs on summerengine.com, so a review page on another
+ * origin (a preview deploy, local web dev) is opened in the browser instead.
+ */
+export async function openInStudioTab(path, reviewUrl) {
+    if (!isSummerHost(hostOf(reviewUrl)))
+        return { ok: false, reason: "review_page_not_on_summerengine_com" };
+    let resource;
+    try {
+        resource = resolveMcpResourceUrl();
+    }
+    catch {
+        return { ok: false, reason: "hosted_mcp_url_invalid" };
+    }
+    if (!isSummerHost(hostOf(resource)))
+        return { ok: false, reason: "hosted_mcp_not_summerengine_com" };
+    if (!(await hasStoreSignIn()))
+        return { ok: false, reason: "no_store_sign_in" };
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve({ ok: false, reason: "studio_tab_timeout" }), STUDIO_OPEN_TIMEOUT_MS);
+        timer.unref?.();
+    });
+    const attempt = (async () => {
+        try {
+            const result = await withHostedMcp((client) => client.callTool({ name: "summer_studio_open", arguments: { path } }));
+            const payload = hostedResultPayload(result);
+            if (payload.isError || payload.json?.ok === false) {
+                const code = typeof payload.json?.error === "string" ? payload.json.error : "studio_open_failed";
+                return { ok: false, reason: code };
+            }
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+        }
+    })();
+    try {
+        return await Promise.race([attempt, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function showChoicesPage(reviewUrl, studioPath, deps) {
+    let studioTab;
+    if (studioPath) {
+        const moved = await deps.studioOpen(studioPath, reviewUrl);
+        if (moved.ok)
+            return { shown: "studio_tab" };
+        studioTab = moved.reason;
+    }
+    if (!canOpenReviewUrl(reviewUrl))
+        return { shown: "not_opened", studioTab, browser: "not_a_summer_url" };
+    if (!deps.canOpenBrowser())
+        return { shown: "not_opened", studioTab, browser: "no_browser_here" };
+    try {
+        await deps.openUrl(reviewUrl);
+        return { shown: "browser", studioTab };
+    }
+    catch (error) {
+        return { shown: "not_opened", studioTab, browser: error instanceof Error ? error.message : String(error) };
+    }
+}
+// ---------------------------------------------------------------------------
+// summer_generate_sfx_choices
+// ---------------------------------------------------------------------------
+export function sfxChoicesRequestBody(args) {
+    const body = { capability: "sound_effects", text: args.text };
+    if (args.durationSeconds !== undefined)
+        body.durationSeconds = args.durationSeconds;
+    if (args.loop !== undefined)
+        body.loop = args.loop;
+    if (args.models)
+        body.models = args.models;
+    return body;
+}
+function clipSummary(clip) {
+    return {
+        clipId: clip.clipId,
+        modelId: clip.modelId,
+        modelName: clip.modelName,
+        audioUrl: clip.audioUrl,
+        assetId: clip.assetId,
+        durationSeconds: clip.durationSeconds,
+    };
+}
+export async function generateSfxChoices(args, deps) {
+    const reply = await deps.post(SFX_CHOICES_ENDPOINT, sfxChoicesRequestBody(args), SFX_CHOICES_TIMEOUT_MS);
+    if (reply.error) {
+        return { ok: false, error: reply.error, ...(reply.data ? { details: reply.data } : {}) };
+    }
+    const data = reply.data ?? {};
+    const clips = Array.isArray(data.clips) ? data.clips : [];
+    const failed = Array.isArray(data.failed) ? data.failed : [];
+    const choiceSetId = typeof data.choiceSetId === "string" ? data.choiceSetId : null;
+    const reviewUrl = typeof data.reviewUrl === "string" ? data.reviewUrl : null;
+    const studioPath = typeof data.studioPath === "string" ? data.studioPath : undefined;
+    if (!choiceSetId || !reviewUrl || clips.length === 0) {
+        return {
+            ok: false,
+            error: clips.length === 0 ? "No model made a version of this sound." : "The server did not return a choice set.",
+            failed,
+            hint: "Read failed[] for each model's error. Fix the request (a longer durationSeconds, a plainer description) or call summer_generate_audio with one modelId.",
+        };
+    }
+    const shown = args.open
+        ? await showChoicesPage(reviewUrl, studioPath, deps)
+        : { shown: "not_opened", browser: "open_false" };
+    const count = clips.length;
+    const where = shown.shown === "studio_tab"
+        ? "I opened them in your Summer Studio tab"
+        : shown.shown === "browser"
+            ? "I opened them in your browser"
+            : `Open ${reviewUrl} to hear them`;
+    const say = `I made ${count} versions of this sound with ${count} different models. ${where}. Listen, approve the ones you like (one or more), then tell me. The model you approve becomes your default for sound effects.`;
+    return {
+        ok: true,
+        choiceSetId,
+        prompt: typeof data.prompt === "string" ? data.prompt : args.text,
+        reviewUrl,
+        ...(studioPath ? { studioPath } : {}),
+        shown: shown.shown,
+        ...(shown.studioTab || shown.browser
+            ? { notShownBecause: { ...(shown.studioTab ? { studioTab: shown.studioTab } : {}), ...(shown.browser ? { browser: shown.browser } : {}) } }
+            : {}),
+        clips: clips.map(clipSummary),
+        failed,
+        say,
+        next: `Tell the person the "say" text (include reviewUrl when shown is "not_opened"). Do not pick for them. Then call summer_get_choices with choiceSetId "${choiceSetId}" and waitSeconds ${MAX_CHOICES_WAIT_SECONDS}; call it again while status is "pending".`,
+    };
+}
+// ---------------------------------------------------------------------------
+// summer_get_choices
+// ---------------------------------------------------------------------------
+function fileExtension(url) {
+    if (!url)
+        return "wav";
+    try {
+        const match = /\.(wav|mp3|ogg)$/i.exec(new URL(url).pathname);
+        return match ? match[1].toLowerCase() : "wav";
+    }
+    catch {
+        return "wav";
+    }
+}
+export function choicesEndpoint(choiceSetId) {
+    return `${CHOICES_ENDPOINT_PREFIX}${encodeURIComponent(choiceSetId)}`;
+}
+export function choicesTimeoutMs(waitSeconds) {
+    return ((waitSeconds ?? 0) + 20) * 1000;
+}
+export async function getChoices(args, deps) {
+    const params = new URLSearchParams();
+    if (args.waitSeconds)
+        params.set("waitSeconds", String(args.waitSeconds));
+    const reply = await deps.get(choicesEndpoint(args.choiceSetId), params, choicesTimeoutMs(args.waitSeconds));
+    if (reply.error) {
+        return { ok: false, error: reply.error, ...(reply.data ? { details: reply.data } : {}) };
+    }
+    const data = reply.data ?? {};
+    const clips = Array.isArray(data.clips) ? data.clips : [];
+    const status = data.status === "decided" ? "decided" : "pending";
+    const approved = clips
+        .filter((clip) => clip.approved === true)
+        .map((clip) => ({
+        ...clipSummary(clip),
+        ...(clip.note ? { note: clip.note } : {}),
+        fileExtension: fileExtension(clip.audioUrl),
+    }));
+    let next;
+    if (status === "pending") {
+        next = `The person has not decided yet. Call summer_get_choices again with waitSeconds ${MAX_CHOICES_WAIT_SECONDS}, or wait until they say they picked. Do not pick for them.`;
+    }
+    else if (approved.length === 0) {
+        next = "They approved none. Ask what to change (the description, the length, the models) and run summer_generate_sfx_choices again.";
+    }
+    else {
+        next =
+            "Import each approved clip into the project: summer_import_from_url({ url: audioUrl, path: \"res://audio/sfx/<name>.<fileExtension>\" }) " +
+                "or summer_import_asset_by_id({ assetId, path }). Read each clip's note. Then wire it (sound-effect skill, step Wire). " +
+                (typeof data.preferredModelId === "string"
+                    ? `Their default sound-effect model is now ${data.preferredModelId}: later summer_generate_audio sound_effects calls without modelId use it.`
+                    : "");
+    }
+    return {
+        ok: true,
+        choiceSetId: typeof data.choiceSetId === "string" ? data.choiceSetId : args.choiceSetId,
+        kind: data.kind,
+        prompt: data.prompt,
+        status,
+        preferredModelId: data.preferredModelId ?? null,
+        approved,
+        clips: clips.map((clip) => ({ ...clipSummary(clip), approved: clip.approved === true, ...(clip.note ? { note: clip.note } : {}) })),
+        next: next.trim(),
+    };
+}

package/dist/core/capabilities/tool-dispatch.js

@@ -30,6 +30,7 @@ import { lookupApiDocs } from "./api-docs.js";
 import { BOARD_ENDPOINT, boardArgsSchema, boardQuery } from "./board.js";
 import { IMAGE_GENERATION_TIMEOUT_MS, imageGenerationArgsSchema, saveGeneratedImage } from "./image-generation.js";
 import { buildMotionRequestBody, motionGenerationArgsSchema } from "./motion-generation.js";
+import { defaultCanOpenBrowser, generateSfxChoices, getChoices, getChoicesArgsSchema, openInStudioTab, sfxChoicesArgsSchema, } from "./sfx-choices.js";
 import { ImportHdriError, importHdriArgsSchema, importPolyHavenHdri } from "./hdri-import.js";
 import { FABRICATE_FALLBACK, buildFabricateMeshOp, fabricateArgsSchema } from "./fabricate-mesh.js";
 import { buildUiActionsOp, buildUiActivateOp, buildUiScreenshotOp, buildUiTreeOp, executeUiOp, uiActionsArgsSchema, uiActivateArgsSchema, uiScreenshotArgsSchema, uiScreenshotCaption, uiScreenshotImage, uiTreeArgsSchema, withUiFailureDetails, } from "./ui-control.js";
@@ -393,6 +394,26 @@ function optStr(args, key) {
 }
 /** Validate CLI args against the SAME zod schema the MCP face uses, so the
  *  two surfaces reject the same inputs with a readable message. */
+/** The gateway helpers as the shared sfx-choices module expects them: a reply, never a throw. */
+async function gatewayReply(call) {
+    try {
+        return { data: await call(), status: 200 };
+    }
+    catch (error) {
+        if (!(error instanceof ToolDispatchError))
+            throw error;
+        return { error: error.message, status: 0 };
+    }
+}
+function sfxChoicesDeps() {
+    return {
+        post: (endpoint, body, timeoutMs) => gatewayReply(() => gatewayPost(endpoint, body, timeoutMs)),
+        get: (endpoint, params, timeoutMs) => gatewayReply(() => gatewayGet(endpoint, params, timeoutMs)),
+        studioOpen: (path, reviewUrl) => openInStudioTab(path, reviewUrl),
+        openUrl: (url) => open(url),
+        canOpenBrowser: () => defaultCanOpenBrowser(),
+    };
+}
 function parseToolArgs(schema, args, tool) {
     const parsed = schema.safeParse(args);
     if (parsed.success)
@@ -917,12 +938,26 @@ export const TOOL_DISPATCH = [
         }
         if (typeof args.durationSeconds === "number")
             body.durationSeconds = args.durationSeconds;
+        if (typeof args.loop === "boolean")
+            body.loop = args.loop;
         if (Array.isArray(args.inputs))
             body.inputs = args.inputs;
         if (args.options)
             body.options = args.options;
         return gatewayPost("/api/mcp/generate/audio", body);
     }),
+    entry("summer_generate_sfx_choices", "Make one sound effect with several models and show them for the person to pick", false, async (args) => {
+        const result = await generateSfxChoices(parseToolArgs(sfxChoicesArgsSchema, args, "generate-sfx-choices"), sfxChoicesDeps());
+        if (result.ok !== true)
+            throw new ToolResultError(result, String(result.error));
+        return result;
+    }),
+    entry("summer_get_choices", "Read which sound-effect versions the person approved", false, async (args) => {
+        const result = await getChoices(parseToolArgs(getChoicesArgsSchema, args, "get-choices"), sfxChoicesDeps());
+        if (result.ok !== true)
+            throw new ToolResultError(result, String(result.error));
+        return result;
+    }),
     entry("summer_generate_3d", "Generate a 3D model (optional auto-rig + animations)", false, async (args) => {
         const options = {
             ...(args.options ?? {}),

package/dist/mcp/hosted-mount.js

@@ -3,6 +3,7 @@ import { z } from "zod";
 import { connectHostedMcp } from "../core/hosted-mcp.js";
 import { getStoreAccessToken, OAuthError, resolveMcpResourceUrl } from "../core/oauth.js";
 import { appendMcpLogEvent } from "../core/mcp-log.js";
+import { providerSafeSchema } from "./provider-safe-schema.js";
 /**
  * One Summer Engine MCP. The cloud tools a creator's agent needs to publish
  * (projects, store page, build upload, submit for the owner's approval, the
@@ -73,7 +74,7 @@ export function prepareHostedMount(server, deps = defaultHostedMountDependencies
                 ...result,
                 tools: result.tools.map((tool) => {
                     const hosted = schemas.get(tool.name);
-                    return hosted ? { ...tool, inputSchema: hosted.inputSchema, ...(hosted.annotations ? { annotations: hosted.annotations } : {}), ...(hosted.title ? { title: hosted.title } : {}) } : tool;
+                    return hosted ? { ...tool, inputSchema: providerSafeSchema(hosted.inputSchema), ...(hosted.annotations ? { annotations: hosted.annotations } : {}), ...(hosted.title ? { title: hosted.title } : {}) } : tool;
                 }),
             };
         });

package/dist/mcp/provider-safe-schema.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** String formats OpenAI strict mode accepts; other providers accept no more. */
+export declare const STRICT_PROVIDER_FORMATS: Set<string>;
+export declare function providerSafeSchema<T>(schema: T): T;
+/**
+ * Wrap the SDK's tools/list so every tool's inputSchema leaves the server in
+ * the provider-safe form. Call after the first registerTool (the SDK installs
+ * its tools/list handler then).
+ */
+export declare function serveProviderSafeToolSchemas(server: McpServer): void;