summer-engine 3.4.1 → 3.5.0

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "_generated": "GENERATED from integrations/claude — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
@@ -71,6 +71,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -93,6 +94,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -110,6 +112,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
@@ -66,6 +66,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -88,6 +89,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -105,6 +107,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
@@ -78,6 +78,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -100,6 +101,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -117,6 +119,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/.factory-plugin/plugin.json

@@ -2,7 +2,7 @@
   "_generated": "GENERATED from integrations/factory — do not edit; npm run generate:registry",
   "name": "summer",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 105-tool MCP bridge to the local desktop app.",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -63,6 +63,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -85,6 +86,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -102,6 +104,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 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.5.0] - 2026-10-10
+
+Setup now connects Summer Games too, and agents that publish a game get further on their own. 3.4.2 was never published; its changes ship here.
+
+- **Summer Games in your agent.** `summer setup claude-code` and `summer setup codex` also add `summer-games`, the Summer Games MCP at `https://mcp.summer.games/mcp`. Your agent can then see your friends and who is online, start a party, invite friends to a game and send messages, as you. You sign in once through summer.games: run `/mcp` in Claude Code and choose `summer-games`, or `/mcp login summer-games` in Codex. Your browser opens summer.games; sign in and choose Allow. No key or password is written to your config.
+  - If you already added the same address under another name (for example `summer`), setup keeps yours and adds no second entry. Running setup again changes nothing.
+  - `--no-games` skips it. To remove it: `claude mcp remove summer-games -s user` or `codex mcp remove summer-games`.
+  - Cursor does not get it yet: Cursor's sign-in can use a `cursor://` return address that summer.games does not accept yet. A later release adds it.
+- `summer_publish_build` refused with `template_set_unavailable` no longer only says "update Summer Engine": with the newest engine, Summer Games may still be turning that Summer version on, so retry the same upload later (the same clientVersion works). It shows the store's own reason when there is one.
+- `summer_search_library` and `summer_read_library` now find `skill/publish-your-game`, `skill/store-listing`, `skill/store-art` and `skill/grow-analytics`. Before, they were only hosted MCP resources and a read returned not_found.
+- A read loads the current text from the hosted Summer Engine MCP with the store sign-in (`summer login --store`). Without the sign-in it shows a short summary, the reason, and how to load the rest. The entries also load by their `summer://skills/<slug>` URI.
+- `summer_capture_gameplay` gets past the title screen. `args` passes the game's own flags after `--` (for example `["--autostart"]`). `steps` play like a player before and between frames: press a button by its text, a key, an input action, a click, a drag, a wait, and a shot. The run always passes `--summer-offscreen`.
+- `summer_capture_gameplay` no longer stops at about half the requested time: the run is capped at 60 fps (`--max-fps 60`) because the engine's time limit counts frames, and it gets twice its planned time. The probe is fully typed, so projects that treat GDScript warnings as errors load it. The project is imported again when an asset is new or its content changed since the last import (a pull, or Git LFS files fetched later), and files that are still LFS pointers are named in a warning.
+- `summer_generate_image` sends no model unless you name one, so width 1920 with height 1080 gets a model that reaches it instead of `size_unreachable`. It waits up to 3 minutes for the larger models. The new `out` parameter (a folder or a .png/.jpg/.webp path) says where to save the image; without it, it goes to `<TMPDIR>/summer-gen/`.
+- `summer_export_game` exports the targets the installed engine can build: Android on 0.7.0 is left out with a warning (it needs 0.7.1), and the other targets still export. `skippedTargets` names what was left out.
+- `summer_publish_build` checks a game with a server's Build declaration before anything is uploaded: when `summer.build.json` declares other platforms than the export holds, the preview and the upload stop with `declaration_mismatch`, so no version is spent. `summer_export_game` warns about the same mismatch, and `alignDeclaration: true` sets `summer.build.json` targetPlatforms to the exported targets.
+
+### Added
+- Skill field `hosted_resource` in `resource.yaml`: the skill's body comes from that hosted MCP resource (#90).
+- `summer_capture_gameplay` `args` and `steps`; a step that cannot run (no such button, key or action) is a warning, not a failure.
+
 ## [3.4.1] - 2026-10-10
 
 Agents that publish a game find the right tools:

package/README.md

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

package/dist/cli/commands/setup.js

@@ -1,5 +1,5 @@
 import { Command, Option } from "commander";
-import { configureAgentMcp, resolveAgentSelection, resolveConfigScope, supportedAgents, } from "../../installer/agent-config.js";
+import { configureAgentMcp, configureSummerGamesMcp, resolveAgentSelection, resolveConfigScope, supportedAgents, } from "../../installer/agent-config.js";
 import { previewNote, setupSkills } from "../../installer/setup.js";
 import { printDoctorResult, runDoctor } from "../../core/capabilities/doctor.js";
 import { brandLine, c, sym, tildeify } from "../../core/format.js";
@@ -7,7 +7,7 @@ import { TOOLKIT_VERSION as cliVersion } from "../../core/version.js";
 import { resolveDefaultChannel } from "../../installer/version-check.js";
 import { agentLabel } from "../../installer/agent-table.js";
 export const setupCommand = new Command("setup")
-    .description("Configure Summer Engine for an AI agent and run diagnostics")
+    .description("Configure Summer Engine for an AI agent and run diagnostics. For Claude Code and Codex it also adds Summer Games (summer-games).")
     .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
     .option("--agent <agent>", `Agent to configure: ${supportedAgents.join(", ")}`)
     .option("--scope <scope>", "Configuration scope: user or project", "user")
@@ -16,6 +16,7 @@ export const setupCommand = new Command("setup")
     .option("--local-dev", "Point the agent at this checkout's built CLI (node <repo>/dist/bin/summer.js mcp) instead of npx summer-engine@latest — for testing unpublished builds. SUMMER_DEV=1 does the same.")
     .option("--channel <dist-tag>", "npm dist-tag the agent's MCP entry runs: npx -y summer-engine@<dist-tag> mcp (default latest; use next while a release soaks on the next tag). SUMMER_CHANNEL does the same.")
     .option("--yes", "Apply practical setup steps without prompting")
+    .option("--no-games", "Do not add the Summer Games MCP (summer-games: friends, parties and messages as you, signed in through summer.games; Claude Code and Codex)")
     .option("--json", "Print setup result as JSON")
     .option("--force", "Overwrite existing skill content (passes --force through to skills install)")
     .option("--recommended", "Install only the recommended skill subset instead of the whole library")
@@ -34,6 +35,9 @@ export const setupCommand = new Command("setup")
         localDev: Boolean(opts.localDev) || process.env.SUMMER_DEV === "1",
         channel: opts.channel ?? process.env.SUMMER_CHANNEL ?? defaultChannel.channel,
     });
+    const games = opts.games === false || opts.print
+        ? null
+        : await configureSummerGamesMcp({ agent, scope, dryRun: opts.dryRun });
     if (!opts.channel && !process.env.SUMMER_CHANNEL && defaultChannel.note && !opts.print) {
         console.log(`  ${c.dim(defaultChannel.note)}`);
     }
@@ -50,18 +54,19 @@ export const setupCommand = new Command("setup")
         console.log(JSON.stringify({
             ok: doctor.ok && skills.status !== "failed",
             config,
+            games,
             skills,
             doctor,
         }, null, 2));
     }
     else {
-        printSetupResult(config, skills, doctor);
+        printSetupResult(config, games, skills, doctor);
     }
     if (!doctor.ok || skills.status === "failed") {
         process.exit(1);
     }
 });
-function printSetupResult(config, skills, doctor) {
+function printSetupResult(config, games, skills, doctor) {
     if (config.print) {
         console.log(config.snippet.trimEnd());
         return;
@@ -85,6 +90,21 @@ function printSetupResult(config, skills, doctor) {
     else if (config.channel !== "latest") {
         console.log(`  ${c.dim(`(channel ${config.channel})`)}  MCP server command: ${c.dim(`${config.server.command} ${config.server.args.join(" ")}`)}`);
     }
+    if (games) {
+        const name = c.bold("Summer Games");
+        const url = c.dim(games.url);
+        if (games.existingName) {
+            console.log(`  ${sym.ok()}  ${name} already added as ${c.bold(games.existingName)}  ${url}`);
+        }
+        else if (config.dryRun) {
+            console.log(`  ${c.dim("(dry run)")}  ${games.changed ? "Would add" : "Already added"} ${name}  ${url}`);
+        }
+        else {
+            console.log(`  ${sym.ok()}  ${games.wrote ? "Added" : "Already added"} ${name}  ${url}`);
+        }
+        if (!config.dryRun)
+            console.log(`     ${c.dim(`Sign in once: ${games.signIn}`)}`);
+    }
     if (skills.status === "installed") {
         const installed = parseInstalledSkills(skills.stdout);
         if (installed.length > 0) {

package/dist/core/capabilities/capture-gameplay.d.ts

@@ -7,12 +7,15 @@ import { type EngineRun } from "./engine-run.js";
  * focus, so it never shows on screen, unlike --headless, which has no pixels.
  *
  *   <engine> --disable-crash-handler --summer-no-api --path <project> --resolution WxH
- *            [--scene res://...] --summer-verify <probe.gd>
- *            --summer-verify-out <dir> --summer-verify-max <s>
+ *            [--scene res://...] --summer-offscreen --summer-verify <probe.gd>
+ *            --summer-verify-out <dir> --summer-verify-max <s> [-- <args>]
  *
- * The stock probe waits for the scene to draw and settle, saves PNG frames of
- * the game viewport, and writes results.json. The frames are what the game
- * really draws, HUD included: use them as store screenshots.
+ * The stock probe waits for the scene to draw and settle, runs the steps (press
+ * a button, a key or an input action, click, drag, wait, shot) from inside the
+ * game, saves PNG frames of the game viewport, and writes results.json. The
+ * frames are what the game really draws, HUD included: use them as store
+ * screenshots. `args` reach the game as OS.get_cmdline_user_args(), so a game
+ * that skips its title screen on a flag starts in play.
  */
 export interface CaptureGameplayInput {
     /** Project root (has project.godot). Defaults to the MCP's --project, then the working directory. */
@@ -29,6 +32,49 @@ export interface CaptureGameplayInput {
     intervalSeconds?: number;
     /** Output folder. Default <project>/.summer/captures/<time>/. */
     out?: string;
+    /** The game's own command-line args, passed after "--" (OS.get_cmdline_user_args()). */
+    args?: string[];
+    /** What to do after waitSeconds, in order. With a shot step, only shot steps save frames. */
+    steps?: CaptureStep[];
+}
+/**
+ * One capture step, run from inside the game. Coordinates are frame pixels
+ * (the saved PNG's space). press finds a visible, enabled button by its text,
+ * then its node name, then a partial match, waiting up to timeoutSeconds for
+ * it to appear; it clicks the button's centre, and emits pressed when the
+ * click did not reach it. key takes Godot key names (Space, Enter, Escape, A).
+ */
+export type CaptureStep = {
+    press: string;
+    timeoutSeconds?: number;
+} | {
+    key: string;
+    holdMs?: number;
+} | {
+    action: string;
+    holdMs?: number;
+} | {
+    click: [number, number];
+} | {
+    drag: {
+        from: [number, number];
+        to: [number, number];
+        ms?: number;
+    };
+} | {
+    wait: number;
+} | {
+    shot: true;
+};
+/** A step as the probe reads it (one shape, all fields named). */
+export interface ProbeStep {
+    type: "press" | "key" | "action" | "click" | "drag" | "wait" | "shot";
+    text?: string;
+    timeout?: number;
+    hold_ms?: number;
+    at?: [number, number];
+    to?: [number, number];
+    ms?: number;
 }
 export interface CapturedFrame {
     path: string;
@@ -44,6 +90,8 @@ export interface CaptureGameplayResult {
     out: string;
     engine: string;
     imported: boolean;
+    /** Why the project was imported before the capture. */
+    importReason?: string;
     durationMs: number;
     warnings?: string[];
     next: string;
@@ -53,6 +101,20 @@ export interface CaptureGameplayDependencies {
     run: (binary: string, args: string[], timeoutMs: number) => Promise<EngineRun>;
     now: () => Date;
 }
+/** Validate the steps and turn them into the probe's one shape. */
+export declare function probeSteps(steps: unknown): ProbeStep[];
+/**
+ * Whether the project's import caches are stale: an imported file (texture,
+ * model, sound, font) that has no .import sidecar or cache yet, or whose
+ * content changed since it was imported (a pull, or LFS files fetched after
+ * the first import). Also names files that are still Git LFS pointers, which no
+ * import can fix.
+ */
+export declare function importState(project: string): {
+    needed: boolean;
+    reason?: string;
+    lfsPointers: string[];
+};
 /** Width and height from a PNG's IHDR chunk, or null when the file is not a PNG. */
 export declare function pngSize(bytes: Buffer): {
     width: number;
@@ -63,7 +125,10 @@ export declare function pngSize(bytes: Buffer): {
  * project); follows the verify-instance contract of assets/autopilot/probe_base.gd:
  * the engine sets summer_out_dir and summer_max_seconds before _ready(), the
  * first frames are empty until the scene has drawn twice, results.json is
- * always written.
+ * always written. The steps are generated as typed calls, and nothing reads a
+ * Variant, so projects that treat every GDScript warning as an error
+ * (untyped_declaration, unsafe_call_argument, unsafe_cast, integer_division)
+ * still load it.
  */
-export declare function captureProbeSource(frames: number, waitSeconds: number, intervalSeconds: number): string;
+export declare function captureProbeSource(frames: number, waitSeconds: number, intervalSeconds: number, steps?: ProbeStep[]): string;
 export declare function captureGameplay(input: CaptureGameplayInput, overrides?: Partial<CaptureGameplayDependencies>): Promise<CaptureGameplayResult>;