summer-engine 3.5.2 → 3.7.0

package/.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
     {
       "name": "summer",
       "source": "./",
-      "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.",
+      "version": "3.7.0",
+      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
       "author": {
         "name": "Summer Engine",
         "email": "founders@summerengine.com"

package/.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.2",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
+  "version": "3.7.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",

package/.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.2",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge. Build games by talking.",
+  "version": "3.7.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -151,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 104-tool MCP bridge for guarded project files, scene editing, asset import, play mode, diagnostics, generation, and creator workflows. Git, shell, and grep stay with the host agent. Summer follows its upstream technical base continuously; version-sensitive work uses the bundled compatibility reference instead of a fixed onboarding version. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": [

package/.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.2",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
+  "version": "3.7.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com"

package/.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.2",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
+  "version": "3.7.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",

package/CHANGELOG.md

@@ -2,10 +2,24 @@
 
 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.7.0] - 2026-10-13
 
-Hosted games: agents check that players can actually join before a release.
+Sound-effect choices open in your Studio tab right away, agents act on Summer's review feedback, and the legacy creator path is gone.
 
+- `summer_generate_sfx_choices` no longer waits 20 s and then reports `studio_tab_timeout` before it opens the page. Summer now sends the choices page to your open Summer Studio tab as it makes the versions, and the tool reads that answer: when your tab took it, no browser opens; when no tab is open, it opens your browser as before. Signing in to the store is no longer needed for the tab to open.
+- **Removed the legacy Summercraft creator path.** The deprecated `summer_creator_publish`, `summer_creator_releases` and `summer_creator_config` MCP tools (and their `summer tool` slugs and library entries), the `summer publish` and `summer releases` commands, `summer login --creator` and the `creator.apiUrl`, `creator.projectId` and `creator.channel` config keys are gone. Publish to summer.games with `summer_export_game`, then `summer_publish_build`, then the hosted `summer_store_submit` and `summer_store_review`. `gateway.url` stays settable with `summer config`; `summer logout` still removes a `~/.summer/creator-token` an older CLI left behind.
+- **Agents read Summer's review feedback and resubmit.** When Summer staff ask for changes to a submitted game, or do not approve it, they can now write feedback for the creator. The hosted `summer_store_review` tool returns the decision, that feedback and the next step; `publish-your-game` and the MCP instructions tell the agent to fix what the feedback names and call `summer_store_submit` again, and never to call the game live before Summer approves it.
+
+## [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`.

package/README.md

@@ -322,7 +322,6 @@ We tell you before we touch your disk.
 | `summer-engine` npm package (CLI + MCP + library) | ~2 MB download, ~6 MB unpacked | first `npx -y summer-engine@latest ...` call | [npmjs.com/package/summer-engine](https://www.npmjs.com/package/summer-engine) |
 | Summer Engine app | ~1 GB (engine + bundled Git/runtime tools) | `npx -y summer-engine@latest install` | Summer's signed releases |
 | Auth token | ~1 KB | `npx -y summer-engine@latest login` | Browser to `~/.summer/auth-token` |
-| Creator token | ~50 bytes | only when you run `summer login --creator` and mint one | One-time browser value to `~/.summer/creator-token`; never replaces the auth token |
 | Store sign-in | ~2 KB | only when you run `summer login --store` | Browser OAuth (PKCE, loopback port 47615-47617) to `~/.summer/oauth-token` with its refresh token, plus this machine's public client id in `~/.summer/oauth-client`; never replaces the auth token |
 | Skill files | small, bundled | in the npm package | no extra network call |
 | Generated assets (3D / image / audio / video) | varies | only on explicit `summer_generate_*` calls when that provider route is enabled for the account | Summer Engine Studio |
@@ -352,11 +351,8 @@ matchmaking are not promised by this package.
 | `summer install [--yes]` | Download Summer Engine. Prints URL and size first; never replaces an installed engine without confirmation. |
 | `summer login` | Browser-based core Summer sign-in. |
 | `summer login --store` | Browser sign-in to the Summer store so agents can upload builds (`summer_publish_build`). |
-| `summer login --creator` | Deprecated: connect a creator token for the legacy `summer publish`. |
 | `summer logout` | Clear auth tokens. |
 | `summer config [get\|set\|unset]` | Read or update the shared non-secret `~/.summer/config.json`. |
-| `summer publish [project] --artifact <game.pck> --version <value> [--confirm]` | Deprecated: use `summer tool export-game`, then `summer tool publish-build`. |
-| `summer releases [--cursor <value>]` | List your creator release history. |
 | `summer status` | Engine state, port, auth. |
 | `summer doctor` | Diagnose Node, login, engine, project memory, MCP. |
 | `summer plan <goal>` | Route a game-building goal into skills, MCP tools, gates, and verification. |

package/dist/cli/commands/login.d.ts

@@ -1,15 +1,5 @@
 import { Command } from "commander";
 export declare const loginCommand: Command;
-export interface CreatorLoginDependencies {
-    openUrl: (url: string) => Promise<unknown>;
-    readSecret: (prompt: string) => Promise<string>;
-    log: (message: string) => void;
-}
-/**
- * The browser session mints the token; the token is pasted once into a hidden
- * prompt. This deliberately does not replace the core Summer login JWT.
- */
-export declare function runCreatorLogin(overrides?: Partial<CreatorLoginDependencies>): Promise<void>;
 export interface LoginDependencies {
     fetch: typeof fetch;
     openUrl: (url: string) => Promise<unknown>;

package/dist/cli/commands/login.js

@@ -1,8 +1,8 @@
 import { Command } from "commander";
 import { randomUUID } from "crypto";
 import open from "open";
-import { getAuthToken, getCreatorToken, saveCreatorToken, saveLoginSession, } from "../../core/auth.js";
-import { getCreatorApiUrl, resolveGatewayUrl } from "../../core/config.js";
+import { getAuthToken, saveLoginSession, } from "../../core/auth.js";
+import { resolveGatewayUrl } from "../../core/config.js";
 import { readStoredOAuthToken, runStoreLogin } from "../../core/oauth.js";
 const POLL_INTERVAL_MS = 2000;
 // One generous window on ONE session id. First-time users may need to create an
@@ -14,7 +14,6 @@ const POLL_TIMEOUT_MS = 900000;
 const HEARTBEAT_MS = 30000;
 export const loginCommand = new Command("login")
     .description("Sign in to Summer Engine via your browser")
-    .option("--creator", "Connect a separately scoped Summercraft creator token for publishing")
     .option("--store", "Sign in to the Summer store so agents can upload builds (summer_publish_build)")
     .option("--force", "Force re-authentication even if already logged in")
     .action(async (opts) => {
@@ -28,15 +27,6 @@ export const loginCommand = new Command("login")
         console.log("Signed in to the Summer store. Your core Summer login was not changed.");
         return;
     }
-    if (opts.creator) {
-        const existingCreator = await getCreatorToken();
-        if (existingCreator && !opts.force) {
-            console.log("A creator token is already connected. Use --creator --force to replace it.");
-            return;
-        }
-        await runCreatorLogin();
-        return;
-    }
     const existing = await getAuthToken();
     if (existing && !opts.force) {
         console.log("Already logged in. Use --force to re-authenticate.");
@@ -44,76 +34,6 @@ export const loginCommand = new Command("login")
     }
     await runLogin();
 });
-async function readHiddenLine(prompt) {
-    if (!process.stdin.isTTY || !process.stdout.isTTY) {
-        process.stdout.write(prompt);
-        let value = "";
-        for await (const chunk of process.stdin)
-            value += String(chunk);
-        return value.trim();
-    }
-    process.stdout.write(prompt);
-    const input = process.stdin;
-    const wasRaw = input.isRaw;
-    input.setRawMode(true);
-    input.resume();
-    return new Promise((resolve, reject) => {
-        let value = "";
-        const finish = (error) => {
-            input.off("data", onData);
-            input.setRawMode(Boolean(wasRaw));
-            input.pause();
-            process.stdout.write("\n");
-            if (error)
-                reject(error);
-            else
-                resolve(value.trim());
-        };
-        const onData = (chunk) => {
-            for (const char of String(chunk)) {
-                if (char === "\u0003") {
-                    finish(new Error("Creator token entry cancelled."));
-                    return;
-                }
-                if (char === "\r" || char === "\n" || char === "\u0004") {
-                    finish();
-                    return;
-                }
-                if (char === "\u007f" || char === "\b") {
-                    value = value.slice(0, -1);
-                }
-                else if (char >= " ") {
-                    value += char;
-                }
-            }
-        };
-        input.on("data", onData);
-    });
-}
-const defaultCreatorLoginDependencies = {
-    openUrl: open,
-    readSecret: readHiddenLine,
-    log: console.log,
-};
-/**
- * The browser session mints the token; the token is pasted once into a hidden
- * prompt. This deliberately does not replace the core Summer login JWT.
- */
-export async function runCreatorLogin(overrides = {}) {
-    const deps = { ...defaultCreatorLoginDependencies, ...overrides };
-    const settingsUrl = `${await getCreatorApiUrl()}/creator/settings/tokens`;
-    deps.log(`Opening creator token settings: ${settingsUrl}`);
-    deps.log('Mint a token with the exact "publish" scope, copy its one-time sc_ value, then return here.');
-    try {
-        await deps.openUrl(settingsUrl);
-    }
-    catch {
-        deps.log("Could not open the browser. Copy the URL above and open it manually.");
-    }
-    const token = await deps.readSecret("Creator token (input hidden): ");
-    await saveCreatorToken(token);
-    deps.log("Creator publishing connected. Your core Summer login token was not changed.");
-}
 /** The gateway answered with a terminal 4xx — retrying the same URL cannot help. */
 class LoginRejectedError extends Error {
 }

package/dist/cli/index.js

@@ -14,8 +14,6 @@ import { doctorCommand } from "./commands/doctor.js";
 import { planCommand } from "./commands/plan.js";
 import { debugCommand } from "./commands/debug.js";
 import { configCommand } from "./commands/config.js";
-import { publishCommand } from "./commands/publish.js";
-import { releasesCommand } from "./commands/releases.js";
 import { eventsCommand } from "./commands/events.js";
 import { toolCommand } from "./commands/tool.js";
 import { getBanner } from "./banner.js";
@@ -51,8 +49,6 @@ export function runCli(mcpCommand) {
     program.addCommand(debugCommand);
     program.addCommand(planCommand);
     program.addCommand(configCommand);
-    program.addCommand(publishCommand);
-    program.addCommand(releasesCommand);
     program.addCommand(eventsCommand);
     program.addCommand(toolCommand);
     program.parseAsync().catch((err) => {

package/dist/core/auth.d.ts

@@ -14,7 +14,6 @@ export interface CredentialMetadata {
 interface CredentialMetadataDocument {
     schemaVersion: 1;
     auth?: CredentialMetadata;
-    creator?: CredentialMetadata;
 }
 export interface LoginSession {
     token: string;
@@ -37,13 +36,6 @@ export declare function getAuthToken(): Promise<string | null>;
  */
 export declare function hasEnvAuthToken(): boolean;
 export declare function saveAuthToken(token: string, scopes?: string[]): Promise<void>;
-/**
- * Summercraft creator tokens are a separate credential audience from the
- * core-compatible Summer CLI JWT. Never store an sc_ token in auth-token:
- * the engine reads that file and expects the summer-cli JWT contract.
- */
-export declare function getCreatorToken(): Promise<string | null>;
-export declare function saveCreatorToken(token: string): Promise<void>;
 export declare function getUserInfo(): Promise<SummerUserInfo | null>;
 export declare function saveUserInfo(info: SummerUserInfo): Promise<void>;
 export declare function saveLoginSession(session: LoginSession): Promise<void>;

package/dist/core/auth.js

@@ -3,7 +3,8 @@ export { getSummerDir } from "./store.js";
 const AUTH_TOKEN_FILE = "auth-token";
 /** Written by v2 `summer login` for the removed Summer Cloud sync. Only ever removed now (logout). */
 const LEGACY_CLOUD_TOKEN_FILE = "cloud-token";
-const CREATOR_TOKEN_FILE = "creator-token";
+/** Written by the removed `summer login --creator` (Summercraft). Only ever removed now (logout). */
+const LEGACY_CREATOR_TOKEN_FILE = "creator-token";
 const USER_FILE = "user.json";
 const METADATA_FILE = "credential-metadata.json";
 /** The Summer store OAuth token (core/oauth.ts OAUTH_TOKEN_FILE). */
@@ -78,8 +79,8 @@ async function updateMetadata(kind, value, current) {
     };
     if (!next.auth)
         delete next.auth;
-    if (!next.creator)
-        delete next.creator;
+    // Drop the removed Summercraft creator entry left by older CLIs.
+    delete next.creator;
     await writeStoreJson(METADATA_FILE, next);
 }
 /**
@@ -115,27 +116,6 @@ export async function saveAuthToken(token, scopes = []) {
     await writeStoreText(AUTH_TOKEN_FILE, `${clean}\n`);
     await updateMetadata("auth", decodeJwtMetadata(clean, scopes), metadata);
 }
-/**
- * Summercraft creator tokens are a separate credential audience from the
- * core-compatible Summer CLI JWT. Never store an sc_ token in auth-token:
- * the engine reads that file and expects the summer-cli JWT contract.
- */
-export async function getCreatorToken() {
-    const token = await readStoreText(CREATOR_TOKEN_FILE);
-    return token?.trim() || null;
-}
-export async function saveCreatorToken(token) {
-    const clean = token.trim();
-    if (!/^sc_[A-Za-z0-9_-]{32,}$/.test(clean)) {
-        throw new Error('That is not a Summercraft creator API token. Recovery: open /creator/settings/tokens, mint a token with the "publish" scope, and paste the complete one-time sc_ value.');
-    }
-    await writeStoreText(CREATOR_TOKEN_FILE, `${clean}\n`);
-    await updateMetadata("creator", {
-        audience: ["summercraft-creator"],
-        scopes: ["publish"],
-        tokenType: "api",
-    });
-}
 export async function getUserInfo() {
     return readStoreJson(USER_FILE);
 }
@@ -173,21 +153,11 @@ export async function saveLoginSession(session) {
 export async function getCredentialMetadata() {
     const metadata = await readMetadata();
     const token = await getAuthToken();
-    const creatorToken = await getCreatorToken();
     return {
         schemaVersion: 1,
         ...(token
             ? { auth: metadata.auth ?? decodeJwtMetadata(token) }
             : {}),
-        ...(creatorToken
-            ? {
-                creator: metadata.creator ?? {
-                    audience: ["summercraft-creator"],
-                    scopes: [],
-                    tokenType: "api",
-                },
-            }
-            : {}),
     };
 }
 export async function clearAuthCredentials() {
@@ -195,7 +165,7 @@ export async function clearAuthCredentials() {
     for (const file of [
         AUTH_TOKEN_FILE,
         LEGACY_CLOUD_TOKEN_FILE,
-        CREATOR_TOKEN_FILE,
+        LEGACY_CREATOR_TOKEN_FILE,
         STORE_OAUTH_TOKEN_FILE,
         USER_FILE,
         METADATA_FILE,

package/dist/core/capabilities/seeing/args.d.ts

@@ -306,7 +306,7 @@ export declare const frameShotArgsSchema: z.ZodObject<{
     render: z.ZodOptional<z.ZodEnum<["sheet", "best", "none"]>>;
     max_size: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    shot: "detail" | "establishing" | "eye_level" | "low_angle" | "corridor";
+    shot: "establishing" | "eye_level" | "low_angle" | "detail" | "corridor";
     spawn?: string | undefined;
     scenePath?: string | undefined;
     fov?: number | undefined;
@@ -326,7 +326,7 @@ export declare const frameShotArgsSchema: z.ZodObject<{
     max_soft_fraction?: number | undefined;
     save_bookmark?: boolean | undefined;
 }, {
-    shot: "detail" | "establishing" | "eye_level" | "low_angle" | "corridor";
+    shot: "establishing" | "eye_level" | "low_angle" | "detail" | "corridor";
     spawn?: string | undefined;
     scenePath?: string | undefined;
     fov?: number | undefined;

package/dist/core/capabilities/seeing/seeing.d.ts

@@ -230,4 +230,4 @@ export interface CorridorScanFloor {
 }
 export declare function scanFloorText(floor: CorridorScanFloor, subject: Aabb): string;
 export declare function frameShot(client: SeeingClient, args: FrameShotArgs): Promise<SeeingResult>;
-export declare const SHOT_TYPE_DEFAULTS: Record<"detail" | "establishing" | "eye_level" | "low_angle" | "corridor", import("./candidates.js").ShotDefaults>;
+export declare const SHOT_TYPE_DEFAULTS: Record<"establishing" | "eye_level" | "low_angle" | "detail" | "corridor", import("./candidates.js").ShotDefaults>;

package/dist/core/capabilities/sfx-choices.d.ts

@@ -0,0 +1,78 @@
+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.
+ * The server queues the page for the person's open Studio tab itself
+ * (studioTab.queued); only when no tab took it does this open a browser.
+ * 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 interface SfxChoicesDeps {
+    post(endpoint: string, body: Record<string, unknown>, timeoutMs: number): Promise<GatewayReply>;
+    get(endpoint: string, params: URLSearchParams, timeoutMs: number): Promise<GatewayReply>;
+    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;
+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>>;