summer-engine 3.7.0 → 3.8.0

package/.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
     {
       "name": "summer",
       "source": "./",
-      "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.",
+      "version": "3.8.0",
+      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 119-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.7.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
+  "version": "3.8.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 119-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -116,6 +116,8 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-apps/",
+    "./library/skills/summer-apps-design/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",

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.7.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge. Build games by talking.",
+  "version": "3.8.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 119-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -111,6 +111,8 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-apps/",
+    "./library/skills/summer-apps-design/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",
@@ -151,7 +153,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 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.",
+    "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 119-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.7.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 104-tool MCP bridge to the local desktop app.",
+  "version": "3.8.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 119-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com"
@@ -123,6 +123,8 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-apps/",
+    "./library/skills/summer-apps-design/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",

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 104-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 119-tool MCP bridge to the local desktop app.",
+  "version": "3.8.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -108,6 +108,8 @@
     "./library/skills/store-art/",
     "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
+    "./library/skills/summer-apps/",
+    "./library/skills/summer-apps-design/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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/).
 
+## [3.8.0] - 2026-10-13
+
+Agents build Summer Apps, team tools inside Summer Studio, and asset-only requests skip the engine.
+
+- **Summer Apps tools.** A Summer App is a tool your team uses inside Summer Studio: a balance table, a quest editor, an asset tracker, a pick-one grid. Your agent builds it and it works on the team's data. New tools: `summer_app_guide` (the build guide), `summer_app_list`, `summer_app_create`, `summer_app_publish` (from a local folder, files or a layout), `summer_app_get`, `summer_app_events` (what the app sends to agents), `summer_app_page` (fill the app's fields and press its buttons), `summer_app_data` (read and write the app's shared data; `as: "seed"` for starter data), `summer_app_tools` and `summer_app_call` (the agent tools an app declares), `summer_app_dock` (dock an app as a panel in the editor) and `summer_app_report_gap` (tell Summer what the app needed and did not have). All but `summer_app_dock` work without the engine; they need `summer login`. If Summer Apps is not open for your account yet, they answer `not_found`.
+- **Two new skills: `summer-apps` and `summer-apps-design`.** `summer-apps` is the build loop, Layout or code, the manifest, the SDK, data and agent tools, with a complete working app. `summer-apps-design` is how an app should look: page layout, the Summer UI kit components, tables, charts, states, and a check before you publish.
+- **`summer_app_screenshot`: see your Summer App without opening Studio.** Summer renders the app's published version with your data and returns the picture plus what to fix: console lines, uncaught errors, calls it refused, whether the SDK connected, and the fields and buttons the app declared. It is read-only: writes, sends and paid calls are refused, so nothing changes. `width: 390` shows the phone layout, `theme: "dark"` the dark theme, `fullPage` the whole scroll; `out` also saves the PNG (`summer tool app-screenshot` saves it to `./summer-app-screenshot.png`). The `summer-apps` skill now looks at every publish this way.
+- `summer_app_create` without `workspaceId` puts the app in the person's team: the one their Studio tab is on, else their latest team, else their personal workspace. The result says which.
+- `summer_app_events` waits up to `timeoutSeconds`, the same argument name as the hosted tool.
+- `summer_app_guide` has section `types`: the SDK's exact TypeScript types. Keep that file one folder above the app; a `dir` publish also skips `.d.ts` files.
+- **`summer_app_update`** renames a Summer App or sets it kept, archived or back to scratch, so agents archive the throwaway apps they made.
+- **`summer_enable_plugin` enables an editor plugin (`res://addons/<name>/`) and reports what really happened.** On engines that wait for the plugin, it answers `enabled` with the plugin's autoloads, or the failure code with a hint. Older engines only queue the enable; the tool then answers `queued: true` and `enabled: null` with a note, and does not claim success.
+- Hosted tools such as `summer_studio_page` no longer fail with "Tool not found" when an agent calls them right after it connects, before it lists the tools. The call now waits for the hosted tools to finish loading, then runs.
+- **Assets only: no engine, no brainstorm, one sign-in.** If you only want assets (a sound, an image, a model), the README has a prompt to paste that skips the engine download and the starter project, and runs setup with `--no-games` so you sign in once. `/summer` sends an asset request such as "make me a sword clash sound" straight to its asset skill instead of a game brainstorm, and `sound-effect` stops after you approve the clips when there is no project to import into.
+- Out of credits, a generation tool now gives one link: the Add credits step in Summer Studio (`https://summerengine.com/studio/credits`). Pick an amount and pay once; no plan needed.
+
 ## [3.7.0] - 2026-10-13
 
 Sound-effect choices open in your Studio tab right away, agents act on Summer's review feedback, and the legacy creator path is gone.

package/README.md

@@ -61,12 +61,22 @@ In most agents (Claude Code, Codex, Cursor, GitHub Copilot (VS Code, CLI, JetBra
 
 Then ask the agent to build something.
 
+### Only want assets?
+
+Sound effects, music, voices, images, 3D models and video are made on Summer's servers, so you do not need the Summer Engine app for them. Paste this instead:
+
+> Connect Summer to this agent so I can make game assets. Read github.com/summerengine/summer, connect yourself to Summer and log me in. Skip the Summer Engine app and the starter project, I only want assets.
+
+The agent installs the skills and the MCP config and signs you in. It does not download the engine. Each asset lands in your Summer library, so a game project (in Summer Engine or anywhere else) can use it later.
+
 ---
 
 ## AGENTS READING THIS: install playbook
 
 You are an AI coding agent. The user told you to install Summer Engine. **Run this playbook via your shell**: Bash on macOS/Linux or PowerShell on Windows. Detection first, then only install what's missing. (Once installed, your working guide is [`AGENTS.md`](AGENTS.md).)
 
+**Assets only.** If the user only wants assets (sound effects, music, voices, images, 3D models, video), not a game built in Summer Engine, or tells you to skip the engine: run Step -1, Step 0, Step 1 with `--no-games` added (Summer Games is for playing with friends, and leaving it out saves a second sign-in), and Step 3, then stop installing. Skip Step 2 (the engine download), Step 5 and Step 6. On this path the doctor warnings for `engine-install` and `local-api` are expected; leave them. The asset tools (`summer_generate_audio`, `summer_generate_sfx_choices`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_video`, `summer_search_assets`) run on Summer's servers and need only the login. Most agents load a new MCP server only after a restart. Until then, call the same tool from the shell: `npx -y summer-engine@latest tool <slug> --args '<json>'` (`summer tool --list` prints the slugs). For example, three versions of one sound for the user to pick from: `npx -y summer-engine@latest tool generate-sfx-choices --args '{"text":"sword clash"}'`. Each asset lands in the user's Summer library.
+
 **Windows PowerShell: type `npx.cmd` wherever this playbook says `npx`.** Plain `npx` in PowerShell runs `npx.ps1`, which Windows blocks by default ("running scripts is disabled on this system"). `npx.cmd` is the same command without that block. Never change the execution policy or turn off Windows Defender to work around it. Bash (including Git Bash on Windows) can use plain `npx`.
 
 ### Step -1: Verify Node.js is on PATH
@@ -207,7 +217,7 @@ Only skip brainstorm if the user explicitly said "skip brainstorm" or "just buil
 - **Don't run `npm install -g summer-engine`.** Use `npx -y summer-engine@latest ...` instead. `-g` requires `sudo` on most Mac/Linux setups, so the user will get permission errors and you'll get stuck. `npx` works without root and the MCP config we ship already points at `npx summer-engine mcp`.
 - **Don't install Node.js without asking, and don't use anything but winget for it.** On Windows, Step -1 installs Node LTS with winget after the user says yes. On macOS/Linux, point them at https://nodejs.org and stop.
 - **Don't run plain `npx` in Windows PowerShell, and don't change the execution policy or Defender to make it work.** Use `npx.cmd`.
-- **Don't ask the user "do you want the engine too?" or "do you also want the CLI?"** This playbook installs all of it.
+- **Don't ask the user "do you want the engine too?" or "do you also want the CLI?"** This playbook installs all of it. The one exception is an assets-only request (see **Assets only** at the top of this playbook).
 - **Don't double-download.** Always run `npx -y summer-engine@latest doctor --json` first and skip the engine download and the browser login when their checks are `status: "ok"`. Step 1 (`setup`) is the exception: run it every time — it is idempotent, and doctor's top-level `ok` cannot tell you whether skills or the MCP config are installed.
 - **Don't run `summer install` or `summer login` in the background.** They print user-facing output (engine download progress, browser-opening notice). Run them in the foreground so the user sees what's happening.
 - **Don't skip the `--json` flag on `summer doctor`.** Text output is fragile to parse and changes per version.

package/commands/summer.md

@@ -25,7 +25,7 @@ You speak game-dev shorthand (PCs, NPCs, juice, hit-stop, root motion, blendspac
 ## What to do
 
 1. Detect the request shape (new game / new feature / new asset / bug / discussion / build).
-2. Confirm Summer Engine context. Call `summer_get_project_context` if available. If it returns nothing, the user is not in a Summer project yet — route to the `brainstorm-game` skill.
+2. Confirm Summer Engine context. Call `summer_get_project_context` if available. If it returns nothing and the user wants a game, they are not in a Summer project yet — route to the `brainstorm-game` skill. An asset-only request (a sound, music, a voice line, an image, a model) needs no project, no engine and no brainstorm: go straight to its asset skill. The asset tools run on Summer's servers.
 3. Invoke the right Summer skill with the `Skill` tool. Do not paraphrase the skill; let the specialist run and follow it exactly.
 4. Before any generation call, say what you will generate and roughly how long it takes, and wait for an OK.
 
@@ -40,6 +40,7 @@ Skills are invoked by their bare slug, such as `brainstorm-game`. There is no `s
 | make me a game from scratch | `make-game` |
 | add a [character / enemy / NPC / prop / vehicle] | `asset-strategy` |
 | add a sound for [event] | `sound-effect` |
+| make me a [sound / track / voice line / image / model], no game yet | `sound-effect`, `music-track`, `voice-line`, `concept-art`, `prop-model` (no project needed) |
 | add ambient music | `music-track` |
 | make me fire / smoke / lightning / muzzle flash / magic glow / hit spark / dissolve / water ripple | `vfx-fire`, `vfx-smoke`, `vfx-lightning`, `vfx-muzzle-flash`, `vfx-magic-glow`, `vfx-hit-spark`, `vfx-dissolve`, `vfx-water-ripple` |
 | build the FPS controller | `fps-controller` |

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

@@ -0,0 +1,318 @@
+import { z } from "zod";
+/**
+ * Summer Apps (summer_app_*): tools a game team uses inside Summer Studio,
+ * built by agents. Every cloud tool here calls the Summer web API under
+ * /api/mcp/apps with the signed-in Summer account; summer_app_dock asks the
+ * running editor to dock an app (engine ops OpenAppDock / CloseAppDock /
+ * ListAppDocks).
+ *
+ * One implementation for both faces: the MCP tools (src/mcp/tools/app-tools.ts)
+ * and `summer tool app-*` (tool-dispatch.ts) share the schemas and functions
+ * here and pass their own client surface.
+ */
+export declare const APPS_ENDPOINT = "/api/mcp/apps";
+/** The server's long-poll ceiling for summer_app_events. */
+export declare const MAX_APP_EVENTS_WAIT_SECONDS = 50;
+export declare const APP_GUIDE_SECTIONS: readonly ["all", "overview", "manifest", "sdk", "kit", "layout", "design", "examples", "types"];
+export declare const APP_DOCK_SLOTS: readonly ["left", "right", "bottom"];
+export declare const appGuideArgsSchema: z.ZodObject<{
+    section: z.ZodDefault<z.ZodEnum<["all", "overview", "manifest", "sdk", "kit", "layout", "design", "examples", "types"]>>;
+}, "strip", z.ZodTypeAny, {
+    section: "all" | "kit" | "layout" | "examples" | "manifest" | "overview" | "sdk" | "design" | "types";
+}, {
+    section?: "all" | "kit" | "layout" | "examples" | "manifest" | "overview" | "sdk" | "design" | "types" | undefined;
+}>;
+export declare const appListArgsSchema: z.ZodObject<{
+    workspaceId: z.ZodOptional<z.ZodString>;
+    q: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    workspaceId?: string | undefined;
+    q?: string | undefined;
+}, {
+    workspaceId?: string | undefined;
+    q?: string | undefined;
+}>;
+export declare const appCreateArgsSchema: z.ZodObject<{
+    name: z.ZodString;
+    purpose: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["code", "layout"]>>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    folder: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    format: "code" | "layout";
+    folder?: string | undefined;
+    workspaceId?: string | undefined;
+    purpose?: string | undefined;
+}, {
+    name: string;
+    format?: "code" | "layout" | undefined;
+    folder?: string | undefined;
+    workspaceId?: string | undefined;
+    purpose?: string | undefined;
+}>;
+export declare const appPublishArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    dir: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+        encoding: z.ZodDefault<z.ZodEnum<["utf8", "base64"]>>;
+    }, "strip", z.ZodTypeAny, {
+        encoding: "utf8" | "base64";
+        path: string;
+        content: string;
+    }, {
+        path: string;
+        content: string;
+        encoding?: "utf8" | "base64" | undefined;
+    }>, "many">>;
+    layout: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    manifest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    note: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    manifest: Record<string, unknown>;
+    appId: string;
+    note?: string | undefined;
+    files?: {
+        encoding: "utf8" | "base64";
+        path: string;
+        content: string;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+    dir?: string | undefined;
+    layout?: Record<string, unknown> | undefined;
+}, {
+    manifest: Record<string, unknown>;
+    appId: string;
+    note?: string | undefined;
+    files?: {
+        path: string;
+        content: string;
+        encoding?: "utf8" | "base64" | undefined;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+    dir?: string | undefined;
+    layout?: Record<string, unknown> | undefined;
+}>;
+export declare const appGetArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+}, {
+    appId: string;
+}>;
+export declare const appEventsArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    after: z.ZodDefault<z.ZodNumber>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["agent", "error", "feedback", "tool"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    timeoutSeconds: number;
+    after: number;
+    appId: string;
+    kinds?: ("error" | "agent" | "tool" | "feedback")[] | undefined;
+}, {
+    appId: string;
+    kinds?: ("error" | "agent" | "tool" | "feedback")[] | undefined;
+    timeoutSeconds?: number | undefined;
+    after?: number | undefined;
+}>;
+export declare const appPageArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    fill: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    }, "strip", z.ZodTypeAny, {
+        value: string | number | boolean;
+        field: string;
+    }, {
+        value: string | number | boolean;
+        field: string;
+    }>, "many">>;
+    press: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+    fill?: {
+        value: string | number | boolean;
+        field: string;
+    }[] | undefined;
+    press?: string | undefined;
+}, {
+    appId: string;
+    fill?: {
+        value: string | number | boolean;
+        field: string;
+    }[] | undefined;
+    press?: string | undefined;
+}>;
+export declare const appUpdateArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    purpose: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["scratch", "kept", "archived"]>>;
+    folder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+    status?: "scratch" | "kept" | "archived" | undefined;
+    name?: string | undefined;
+    folder?: string | null | undefined;
+    purpose?: string | undefined;
+}, {
+    appId: string;
+    status?: "scratch" | "kept" | "archived" | undefined;
+    name?: string | undefined;
+    folder?: string | null | undefined;
+    purpose?: string | undefined;
+}>;
+export declare const appScreenshotArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    version: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    theme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    fullPage: z.ZodDefault<z.ZodBoolean>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    out: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+    theme: "light" | "dark";
+    appId: string;
+    fullPage: boolean;
+    version?: number | undefined;
+    params?: Record<string, string> | undefined;
+    out?: string | undefined;
+}, {
+    appId: string;
+    version?: number | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    params?: Record<string, string> | undefined;
+    out?: string | undefined;
+    theme?: "light" | "dark" | undefined;
+    fullPage?: boolean | undefined;
+}>;
+export declare const appDataArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    collection: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    ops: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
+    as: z.ZodOptional<z.ZodEnum<["agent", "seed"]>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    appId: string;
+    ops?: Record<string, unknown>[] | undefined;
+    after?: string | undefined;
+    as?: "seed" | "agent" | undefined;
+    collection?: string | undefined;
+}, {
+    appId: string;
+    ops?: Record<string, unknown>[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    as?: "seed" | "agent" | undefined;
+    collection?: string | undefined;
+}>;
+export declare const appToolsArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+}, {
+    appId: string;
+}>;
+export declare const appCallArgsSchema: z.ZodObject<{
+    appId: z.ZodString;
+    tool: z.ZodString;
+    input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    input: Record<string, unknown>;
+    tool: string;
+    appId: string;
+}, {
+    tool: string;
+    appId: string;
+    input?: Record<string, unknown> | undefined;
+}>;
+export declare const appReportGapArgsSchema: z.ZodObject<{
+    capability: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodString>;
+    appId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    capability: string;
+    method?: string | undefined;
+    detail?: string | undefined;
+    appId?: string | undefined;
+}, {
+    capability: string;
+    method?: string | undefined;
+    detail?: string | undefined;
+    appId?: string | undefined;
+}>;
+export declare const appDockArgsSchema: z.ZodObject<{
+    action: z.ZodDefault<z.ZodEnum<["open", "close", "list"]>>;
+    appId: z.ZodOptional<z.ZodString>;
+    slot: z.ZodDefault<z.ZodEnum<["left", "right", "bottom"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "close" | "open" | "list";
+    slot: "left" | "right" | "bottom";
+    appId?: string | undefined;
+}, {
+    action?: "close" | "open" | "list" | undefined;
+    appId?: string | undefined;
+    slot?: "left" | "right" | "bottom" | undefined;
+}>;
+export interface AppsReply {
+    ok: boolean;
+    status: number;
+    data: Record<string, unknown>;
+}
+export interface AppsDeps {
+    request(method: "GET" | "POST", endpoint: string, init: {
+        query?: URLSearchParams;
+        body?: unknown;
+        timeoutMs: number;
+    }): Promise<AppsReply>;
+    readDir?: (dir: string) => Promise<Array<{
+        path: string;
+        content: string;
+        encoding: "utf8" | "base64";
+    }>>;
+}
+/** Fetch with the Summer account token; errors come back as replies, never throws. */
+export declare function appsGateway(surface: "mcp" | "cli", tool: string): AppsDeps["request"];
+export declare function appGuide(args: z.output<typeof appGuideArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appList(args: z.output<typeof appListArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appCreate(args: z.output<typeof appCreateArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+/** Every file under dir (dotfiles, node_modules and .d.ts type files skipped), as publish files. */
+export declare function readAppDir(dir: string): Promise<Array<{
+    path: string;
+    content: string;
+    encoding: "utf8" | "base64";
+}>>;
+export declare function appPublish(args: z.output<typeof appPublishArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appGet(args: z.output<typeof appGetArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appEvents(args: z.output<typeof appEventsArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appPage(args: z.output<typeof appPageArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appUpdate(args: z.output<typeof appUpdateArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+/**
+ * summer_app_screenshot: the server renders the app headless and read-only as the
+ * person and answers the PNG (base64) with its console, errors and declared page.
+ * The image moves to `image`; `out` also writes it to disk.
+ */
+export declare function appScreenshot(args: z.output<typeof appScreenshotArgsSchema>, deps: AppsDeps & {
+    writeFile?: (file: string, data: Buffer) => Promise<void>;
+}): Promise<Record<string, unknown>>;
+export declare function appData(args: z.output<typeof appDataArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appTools(args: z.output<typeof appToolsArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appCall(args: z.output<typeof appCallArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare function appReportGap(args: z.output<typeof appReportGapArgsSchema>, deps: AppsDeps): Promise<Record<string, unknown>>;
+export declare const APP_DOCK_FALLBACK = "This engine build cannot dock apps yet. Open the app in the Summer Studio tab instead (summer_studio_open with /studio/apps/<appId>), or update Summer Engine.";
+/** The engine op for one dock action. */
+export declare function appDockOp(args: z.output<typeof appDockArgsSchema>): {
+    op: string;
+    [key: string]: unknown;
+};