summer-engine 3.4.0 → 3.4.1

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

@@ -7,8 +7,7 @@ import { readZipEntries } from "../util/zip.js";
 import { BuildToolError } from "./summer-bundle.js";
 import { createStore, readGrants, uploadParts } from "./publish-build.js";
 /**
- * The store's second build path (summer-platform store versions,
- * internal/creatorstore): a web build (an HTML5 .zip played on summer.games)
+ * The store's second build path (store versions): a web build (an HTML5 .zip played on summer.games)
  * or a native download (macOS universal, Windows x64, Linux x64) that players
  * download. summer_export_game format "download" makes these files;
  * summer_publish_build uploads them here, through the same creator store
@@ -25,7 +24,7 @@ import { createStore, readGrants, uploadParts } from "./publish-build.js";
  * already live the store refuses an agent's :complete (the owner finishes it).
  */
 export const DOWNLOAD_PLATFORMS = ["web", "macos-universal", "windows-x64", "linux-x64"];
-/** summer-platform creatorstore limits (versions.go, webzip.go). */
+/** The store's upload limits for store versions and web zips. */
 const WEB_MAX_BYTES = 500 * 1024 * 1024;
 const WEB_MAX_FILES = 2000;
 const WEB_MAX_FILE_BYTES = 200 * 1024 * 1024;

package/dist/core/capabilities/replace-node.d.ts

@@ -3,9 +3,7 @@
  * (src/mcp/tools/scene-tools.ts and tool-dispatch.ts), built from ops whose
  * results persist, and verified against the SAVED scene file.
  *
- * Why not the engine's ReplaceNode op for scenes: SceneOps::replace_node
- * (engine modules/1summer_engine/editor/ops/scene_ops.cpp, scene branch and
- * the async _finish_replace_node) instantiates the new PackedScene and hands
+ * Why not the engine's ReplaceNode op for scenes: for a scene it instantiates the new PackedScene and hands
  * it to SceneTreeDock::replace_node — the editor's "Change Type" path — which
  * ends in Node::replace_by (scene/main/node.cpp). replace_by finishes with
  * `p_node->set_scene_file_path(get_scene_file_path())`: the new instance is

package/dist/core/capabilities/replace-node.js

@@ -3,9 +3,7 @@
  * (src/mcp/tools/scene-tools.ts and tool-dispatch.ts), built from ops whose
  * results persist, and verified against the SAVED scene file.
  *
- * Why not the engine's ReplaceNode op for scenes: SceneOps::replace_node
- * (engine modules/1summer_engine/editor/ops/scene_ops.cpp, scene branch and
- * the async _finish_replace_node) instantiates the new PackedScene and hands
+ * Why not the engine's ReplaceNode op for scenes: for a scene it instantiates the new PackedScene and hands
  * it to SceneTreeDock::replace_node — the editor's "Change Type" path — which
  * ends in Node::replace_by (scene/main/node.cpp). replace_by finishes with
  * `p_node->set_scene_file_path(get_scene_file_path())`: the new instance is

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

@@ -6,8 +6,7 @@
  * both faces validate the same inputs, send the same op and wait the same
  * budget.
  *
- * Engine contract (frozen): doc/SUMMER/SCENE_SCRIPTING_CONTRACTS.md "Wave I —
- * Runtime control & playtest ops" + editor/ops/runtime_ops.h. Every op except
+ * Engine contract (frozen): the runtime control and playtest ops. Every op except
  * ListGameInstances is SINGLE-ONLY and ASYNC (a debugger round-trip needs the
  * reply channel), requires a RUNNING game, accepts `instance?` (default
  * "main"), stamps the game frame it describes, rounds floats to 3dp and
@@ -499,9 +498,8 @@ export declare function playRequestsLocalPlay(args: PlayGameArgs): boolean;
 /**
  * Quiet is the default whenever an agent drives play — both faces of this tool
  * (MCP and `summer tool`) ARE agent faces, so the only way to a focus-stealing
- * launch is an explicit focus:true. Quiet travels as PlayGame `agent:true`
- * (debug_ops.cpp play_game -> GameView::set_agent_quiet_play), which the engine
- * has honoured since 0.5.45 (c7c490d84f3, 2026-07-02).
+ * launch is an explicit focus:true. Quiet travels as PlayGame `agent:true`,
+ * which the engine has honoured since 0.5.45.
  */
 export declare function playIsQuiet(args: PlayGameArgs): boolean;
 /** True when the call needs the PlayGame OP (instance-aware / determinism
@@ -529,8 +527,8 @@ export declare function withLocalPlayEcho(result: unknown, args: PlayGameArgs):
 export declare const PLAY_QUIET_NOT_SUPPORTED = "This Summer Engine build did not echo `agent_quiet` in its PlayGame result \u2014 it predates quiet play and has most likely switched the editor to the Game tab and taken focus. Update Summer Engine (restart it after updating) for launches that leave the user's screen alone.";
 /**
  * Quiet was requested: the engine echoes `agent_quiet` when it understood the
- * flag (debug_ops.cpp play_game — in the launch branch AND the already-running
- * branch on current engines). No echo at all means an engine that predates
+ * flag (in the launch branch AND the already-running branch on current
+ * engines). No echo at all means an engine that predates
  * the flag ignored it — say so instead of letting the model believe the user
  * was left alone. The field is the contract; the `note` text is never matched.
  */

package/dist/core/capabilities/runtime-control.js

@@ -6,8 +6,7 @@
  * both faces validate the same inputs, send the same op and wait the same
  * budget.
  *
- * Engine contract (frozen): doc/SUMMER/SCENE_SCRIPTING_CONTRACTS.md "Wave I —
- * Runtime control & playtest ops" + editor/ops/runtime_ops.h. Every op except
+ * Engine contract (frozen): the runtime control and playtest ops. Every op except
  * ListGameInstances is SINGLE-ONLY and ASYNC (a debugger round-trip needs the
  * reply channel), requires a RUNNING game, accepts `instance?` (default
  * "main"), stamps the game frame it describes, rounds floats to 3dp and
@@ -59,7 +58,7 @@ export const RUNTIME_CONTROL_OP_KINDS = [
     "ListGameInstances",
 ];
 // ---------------------------------------------------------------------------
-// Budgets — mirror the engine's watchdogs (runtime_ops.cpp) plus relay headroom.
+// Budgets — mirror the engine's runtime-op watchdogs plus relay headroom.
 // ---------------------------------------------------------------------------
 /** Default editor-side watchdog for a runtime op (_RT_DEFAULT_TIMEOUT_SEC). */
 export const RUNTIME_WATCHDOG_DEFAULT_SEC = 10;
@@ -882,9 +881,8 @@ export function playRequestsLocalPlay(args) {
 /**
  * Quiet is the default whenever an agent drives play — both faces of this tool
  * (MCP and `summer tool`) ARE agent faces, so the only way to a focus-stealing
- * launch is an explicit focus:true. Quiet travels as PlayGame `agent:true`
- * (debug_ops.cpp play_game -> GameView::set_agent_quiet_play), which the engine
- * has honoured since 0.5.45 (c7c490d84f3, 2026-07-02).
+ * launch is an explicit focus:true. Quiet travels as PlayGame `agent:true`,
+ * which the engine has honoured since 0.5.45.
  */
 export function playIsQuiet(args) {
     return args.focus !== true;
@@ -894,7 +892,7 @@ export function playIsQuiet(args) {
 export function playNeedsOp(args) {
     return (
     // The /api/play rung builds a PlayGame op with ONLY `scene`
-    // (local_api_server.cpp play branch), so `agent:true` has to ride the op.
+    // (the engine's /api/play handler), so `agent:true` has to ride the op.
     playIsQuiet(args) ||
         (typeof args.instance === "string" && args.instance.trim().length > 0) ||
         args.mode !== undefined ||
@@ -1031,8 +1029,8 @@ export function withLocalPlayEcho(result, args) {
 export const PLAY_QUIET_NOT_SUPPORTED = "This Summer Engine build did not echo `agent_quiet` in its PlayGame result — it predates quiet play and has most likely switched the editor to the Game tab and taken focus. Update Summer Engine (restart it after updating) for launches that leave the user's screen alone.";
 /**
  * Quiet was requested: the engine echoes `agent_quiet` when it understood the
- * flag (debug_ops.cpp play_game — in the launch branch AND the already-running
- * branch on current engines). No echo at all means an engine that predates
+ * flag (in the launch branch AND the already-running branch on current
+ * engines). No echo at all means an engine that predates
  * the flag ignored it — say so instead of letting the model believe the user
  * was left alone. The field is the contract; the `note` text is never matched.
  */

package/dist/core/capabilities/scene-batch.d.ts

@@ -4,7 +4,7 @@
  * re-owning step every MCP path that sends ReparentNode shares.
  *
  * Two engine ops answer ok for changes SaveScene then leaves out of the file
- * (engine modules/1summer_engine/editor/ops/scene_ops.cpp, engine 0.6.0):
+ * (engine 0.6.0):
  *
  *  - ReparentNode (SceneOps::reparent_node) re-owns only the node it moves
  *    (`add_do_method(node, "set_owner", root)`). The remove_child before it

package/dist/core/capabilities/scene-batch.js

@@ -4,7 +4,7 @@
  * re-owning step every MCP path that sends ReparentNode shares.
  *
  * Two engine ops answer ok for changes SaveScene then leaves out of the file
- * (engine modules/1summer_engine/editor/ops/scene_ops.cpp, engine 0.6.0):
+ * (engine 0.6.0):
  *
  *  - ReparentNode (SceneOps::reparent_node) re-owns only the node it moves
  *    (`add_do_method(node, "set_owner", root)`). The remove_child before it

package/dist/core/capabilities/scene-kind.js

@@ -1,6 +1,6 @@
 /**
  * Is a scene 2D or 3D? Decided from a scene-tree read, the way the engine's
- * ScenePreview decides it (preview_ops.cpp `_scene_has_3d` / `_scene_has_2d`):
+ * ScenePreview decides it:
  * any Node3D anywhere in the tree makes the scene 3D; otherwise any CanvasItem
  * makes it 2D; a tree of plain Nodes is neither.
  *

package/dist/core/capabilities/scene-readback.d.ts

@@ -4,10 +4,9 @@
  * trusting the engine receipt (summer_replace_node, summer_batch with
  * ReparentNode, summer_connect_signal).
  *
- * The engine's `scenePersistence.persisted` only says SaveScene returned OK
- * (ops_executor.cpp: scene_persistence["persisted"] =
- * explicit_scene_save_succeeded); what the file holds is only known by reading
- * it. The client renames that flag to `saved` (engine-receipt.ts
+ * The engine's `scenePersistence.persisted` only says SaveScene returned OK;
+ * what the file holds is only known by reading it. The client renames that
+ * flag to `saved` (engine-receipt.ts
  * honestSceneReceipt); `verified` is set only by tools that read back here.
  */
 import { type JsonRecord } from "../util/json.js";

package/dist/core/capabilities/scene-readback.js

@@ -4,10 +4,9 @@
  * trusting the engine receipt (summer_replace_node, summer_batch with
  * ReparentNode, summer_connect_signal).
  *
- * The engine's `scenePersistence.persisted` only says SaveScene returned OK
- * (ops_executor.cpp: scene_persistence["persisted"] =
- * explicit_scene_save_succeeded); what the file holds is only known by reading
- * it. The client renames that flag to `saved` (engine-receipt.ts
+ * The engine's `scenePersistence.persisted` only says SaveScene returned OK;
+ * what the file holds is only known by reading it. The client renames that
+ * flag to `saved` (engine-receipt.ts
  * honestSceneReceipt); `verified` is set only by tools that read back here.
  */
 import { asRecord } from "../util/json.js";

package/dist/core/capabilities/scene-script.d.ts

@@ -5,8 +5,8 @@
  *
  * Server-side clamps: RunSceneScript blocks between frames of the LIVE editor,
  * so its ceiling is deliberately low; RunEditorScript boots a whole headless
- * child editor, so its floor covers the boot cost (editor_script_ops.cpp:
- * 15..600 default 120).
+ * child editor, so its floor covers the boot cost (engine clamp: 15..600,
+ * default 120).
  */
 export declare const SCENE_SCRIPT_MIN_SECONDS = 5;
 export declare const SCENE_SCRIPT_MAX_SECONDS = 120;

package/dist/core/capabilities/scene-script.js

@@ -5,8 +5,8 @@
  *
  * Server-side clamps: RunSceneScript blocks between frames of the LIVE editor,
  * so its ceiling is deliberately low; RunEditorScript boots a whole headless
- * child editor, so its floor covers the boot cost (editor_script_ops.cpp:
- * 15..600 default 120).
+ * child editor, so its floor covers the boot cost (engine clamp: 15..600,
+ * default 120).
  */
 export const SCENE_SCRIPT_MIN_SECONDS = 5;
 export const SCENE_SCRIPT_MAX_SECONDS = 120;

package/dist/core/capabilities/seeing/shot-store.d.ts

@@ -2,7 +2,7 @@ export declare const SHOTS_DIR: string;
 export declare const SAVED_SUBDIR = "saved";
 export declare const SHOT_MAX_EDGE = 1024;
 export declare const SHOTS_MAX_TOTAL_BYTES: number;
-/** Same grammar as camera bookmark names (preview_ops.cpp). */
+/** Same grammar as camera bookmark names. */
 export declare const SHOT_NAME_PATTERN: RegExp;
 export declare class ShotStoreError extends Error {
     readonly reason: "bad_name" | "not_jpeg" | "too_large" | "over_cap" | "unsafe_path" | "no_project";

package/dist/core/capabilities/seeing/shot-store.js

@@ -22,7 +22,7 @@ export const SHOTS_DIR = join(".summer", "shots");
 export const SAVED_SUBDIR = "saved";
 export const SHOT_MAX_EDGE = 1024;
 export const SHOTS_MAX_TOTAL_BYTES = 20 * 1024 * 1024;
-/** Same grammar as camera bookmark names (preview_ops.cpp). */
+/** Same grammar as camera bookmark names. */
 export const SHOT_NAME_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
 export class ShotStoreError extends Error {
     reason;

package/dist/core/capabilities/summer-bundle.d.ts

@@ -1,9 +1,8 @@
 /**
- * The summer.games export (summer-platform ADR 0033): one .zip with
+ * The summer.games export: one .zip with
  * summer-bundle.json, client.pck, and for a game with a host server.pck plus
  * config/. This reads what the build upload declares; the Platform verifies
- * the uploaded bytes again. Same rules as Studio's browser check
- * (publicsummerengine src/lib/creator-store/pck-check.ts, checkBundle).
+ * the uploaded bytes again. Same rules as Studio's browser check.
  */
 export declare const BUNDLE_SCHEMA = "summer.bundle.v1";
 export declare const BUNDLE_MANIFEST = "summer-bundle.json";

package/dist/core/capabilities/summer-bundle.js

@@ -2,11 +2,10 @@ import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { readZipEntries, readZipEntry, ZipReadError } from "../util/zip.js";
 /**
- * The summer.games export (summer-platform ADR 0033): one .zip with
+ * The summer.games export: one .zip with
  * summer-bundle.json, client.pck, and for a game with a host server.pck plus
  * config/. This reads what the build upload declares; the Platform verifies
- * the uploaded bytes again. Same rules as Studio's browser check
- * (publicsummerengine src/lib/creator-store/pck-check.ts, checkBundle).
+ * the uploaded bytes again. Same rules as Studio's browser check.
  */
 export const BUNDLE_SCHEMA = "summer.bundle.v1";
 export const BUNDLE_MANIFEST = "summer-bundle.json";

package/dist/core/capabilities/surface-snap.d.ts

@@ -1,7 +1,7 @@
 /**
  * surface-snap — ONE implementation of `summer_snap_to_surface` for both faces
  * (src/mcp/tools/spatial-tools.ts and tool-dispatch.ts), around the engine's
- * SnapToSurface op (modules/1summer_engine/editor/ops/surface_snap_ops.cpp).
+ * SnapToSurface op.
  *
  * Two gaps in the engine op, closed here with ops main already ships:
  *

package/dist/core/capabilities/surface-snap.js

@@ -1,7 +1,7 @@
 /**
  * surface-snap — ONE implementation of `summer_snap_to_surface` for both faces
  * (src/mcp/tools/spatial-tools.ts and tool-dispatch.ts), around the engine's
- * SnapToSurface op (modules/1summer_engine/editor/ops/surface_snap_ops.cpp).
+ * SnapToSurface op.
  *
  * Two gaps in the engine op, closed here with ops main already ships:
  *

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

@@ -661,7 +661,7 @@ export const TOOL_DISPATCH = [
         confirm: args.confirm === true,
         face: "cli",
     })),
-    entry("summer_creator_releases", "List creator-owned releases", false, (args) => listCreatorReleases({
+    entry("summer_creator_releases", "Deprecated: list releases on the legacy creator API; use summer_store_releases", false, (args) => listCreatorReleases({
         projectId: optStr(args, "projectId"),
         limit: typeof args.limit === "number" ? args.limit : 20,
         cursor: optStr(args, "cursor"),

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

@@ -4,8 +4,7 @@
  * both faces validate the same arguments, send the same op, and render the
  * engine's failure taxonomy the same way.
  *
- * Seven engine ops (modules/1summer_engine/editor/ops/ui_ops.cpp, frozen in
- * doc/SUMMER/SCENE_SCRIPTING_CONTRACTS.md "Wave L") behind four tools:
+ * Seven engine ops (a frozen engine contract) behind four tools:
  *
  *   summer_ui_actions     mode:"list"   -> UiListActions   (read)
  *                         mode:"invoke" -> UiInvoke        (mutates)

package/dist/core/capabilities/ui-control.js

@@ -4,8 +4,7 @@
  * both faces validate the same arguments, send the same op, and render the
  * engine's failure taxonomy the same way.
  *
- * Seven engine ops (modules/1summer_engine/editor/ops/ui_ops.cpp, frozen in
- * doc/SUMMER/SCENE_SCRIPTING_CONTRACTS.md "Wave L") behind four tools:
+ * Seven engine ops (a frozen engine contract) behind four tools:
  *
  *   summer_ui_actions     mode:"list"   -> UiListActions   (read)
  *                         mode:"invoke" -> UiInvoke        (mutates)

package/dist/core/capabilities/world-snapshot.d.ts

@@ -3,7 +3,7 @@
  * `summer_world_snapshot` (src/mcp/tools/perception-tools.ts and
  * tool-dispatch.ts).
  *
- * The engine's GetWorldSnapshot (world_snapshot_ops.cpp) takes only
+ * The engine's GetWorldSnapshot op takes only
  * scene_path / max_nodes / max_lights / include_2d and returns every node it
  * walked, about 250 bytes each: a scene of a few thousand nodes is far too
  * big to read.

package/dist/core/capabilities/world-snapshot.js

@@ -3,7 +3,7 @@
  * `summer_world_snapshot` (src/mcp/tools/perception-tools.ts and
  * tool-dispatch.ts).
  *
- * The engine's GetWorldSnapshot (world_snapshot_ops.cpp) takes only
+ * The engine's GetWorldSnapshot op takes only
  * scene_path / max_nodes / max_lights / include_2d and returns every node it
  * walked, about 250 bytes each: a scene of a few thousand nodes is far too
  * big to read.

package/dist/core/capability-skew.d.ts

@@ -77,7 +77,7 @@ export interface EngineCapabilities {
      *  `summer` capture ships, and the offscreen instance cap. Absent = engine
      *  predates runtime control (or advertises the kinds only in opKinds). */
     runtimeControl?: EngineRuntimeControlCapabilities;
-    /** Editor navigation advert (engine `Navigate` op, navigate_ops.cpp): the
+    /** Editor navigation advert (engine `Navigate` op): the
      *  destination ids this build can open. Absent = engine predates the op;
      *  summer_open then falls back to the legacy per-surface ops it can map. */
     navigation?: EngineNavigationCapabilities;
@@ -174,8 +174,7 @@ export declare function missingEngineEventsResult(client: CapabilityAdvertisingC
 export declare function buildCapabilitySkewWarning(health: unknown): string | null;
 /**
  * Engine ops that MUST be dispatched as their own single-op request. Mirrors
- * _summer_requires_single_async_dispatch (local_api_server.cpp, engine
- * 0.5.60+): the engine rejects any multi-op batch containing one of these
+ * the engine's single-async-op list (engine 0.5.60+): the engine rejects any multi-op batch containing one of these
  * WHOLESALE — nothing in the batch executes, and the batch fails with per-op
  * failure_reason "unsupported_transport"/"skipped". Git ops are covered by a
  * prefix check in the dispatchers.

package/dist/core/capability-skew.js

@@ -46,7 +46,7 @@ export const CLI_KNOWN_OP_NEEDS = [
     // summer_grep (core/capabilities/grep.ts)
     "Grep",
     // Navigation (summer_open: core/capabilities/navigation/) — Navigate is the
-    // one-table op (engine navigate_ops.cpp); the other three are the legacy
+    // engine's one-table op; the other three are the legacy
     // fallbacks on engines that predate it.
     "Navigate", "OpenResource", "FocusDock", "RevealInFileSystem",
     // Project + input
@@ -334,8 +334,7 @@ export function buildCapabilitySkewWarning(health) {
 // ---------------------------------------------------------------------------
 /**
  * Engine ops that MUST be dispatched as their own single-op request. Mirrors
- * _summer_requires_single_async_dispatch (local_api_server.cpp, engine
- * 0.5.60+): the engine rejects any multi-op batch containing one of these
+ * the engine's single-async-op list (engine 0.5.60+): the engine rejects any multi-op batch containing one of these
  * WHOLESALE — nothing in the batch executes, and the batch fails with per-op
  * failure_reason "unsupported_transport"/"skipped". Git ops are covered by a
  * prefix check in the dispatchers.
@@ -353,12 +352,12 @@ export const FALLBACK_SINGLE_ONLY_OPS = new Set([
     "RunCommand", "RunVerification", "RunEditorScript", "RunSceneScript",
     "ImportFromUrl", "ImportFromUrlBatch", "ExtractZipFromUrl",
     // Mesh fabrication: a headless Blender child on the same async single-op lane as
-    // RunEditorScript (local_api_server.cpp SUMMER_SINGLE_ASYNC_OPS).
+    // RunEditorScript.
     "FabricateMesh",
     // runtime control (RuntimeOps::async_op_kinds): every op below rides
     // the `summer` debugger capture, so like GameSnapshot each needs the async
     // single-op reply channel. ListGameInstances is deliberately NOT here — it
-    // is a cheap synchronous editor read that batches fine (runtime_ops.h).
+    // is a cheap synchronous editor read that batches fine.
     "SetRuntimeProp", "CallRuntimeMethod", "SpawnRuntimeScene", "FreeRuntimeNode",
     "RuntimeAnimation", "RuntimeAnimationTree", "GetRuntimeBones",
     "GamePause", "GameSpeed", "GameStep",

package/dist/core/feedback/client.js

@@ -7,7 +7,7 @@
  * silent failure, never throws, never retries, never blocks the agent
  * for more than the timeout.
  *
- * Consent (SELF_IMPROVING_LIBRARY.md §3.4):
+ * Consent:
  * - SUMMER_NO_TELEMETRY=1 or DO_NOT_TRACK=1 → nothing is ever sent.
  * - First-run notice BEFORE the first event (CONTRACT §10): the first call
  *   ever made on a machine sends NOTHING and returns a one-paragraph notice

package/dist/core/launch-posture.d.ts

@@ -11,8 +11,8 @@
  *               or takes focus until the user clicks it.
  *   offscreen   `--summer-offscreen` (also `--summer-verify`) — never
  *               activates, never frontmost; on shipped engines an unfocusable
- *               window pushed off-screen where a sliver may stay visible
- *               (main.cpp says so), on the background-posture engine a
+ *               window pushed off-screen where a sliver may stay visible;
+ *               on the background-posture engine a
  *               no-Dock-icon accessory process. Used by RunVerification /
  *               offscreen play instances, never by `summer run`.
  *
@@ -139,7 +139,7 @@ export interface DetectBackgroundSupportOptions {
 export declare function detectBackgroundLaunchSupport(binary: string, options?: DetectBackgroundSupportOptions): Promise<BackgroundLaunchSupport>;
 /**
  * The running engine's own word, once it is up: /api/health
- * `capabilities.launchPostures` (engine tool_net_thread.cpp, newer builds;
+ * `capabilities.launchPostures` (newer engine builds;
  * "focus" always, "background" / "offscreen" only where enforced). true /
  * false when advertised, null when the engine predates the advert.
  */

package/dist/core/launch-posture.js

@@ -11,8 +11,8 @@
  *               or takes focus until the user clicks it.
  *   offscreen   `--summer-offscreen` (also `--summer-verify`) — never
  *               activates, never frontmost; on shipped engines an unfocusable
- *               window pushed off-screen where a sliver may stay visible
- *               (main.cpp says so), on the background-posture engine a
+ *               window pushed off-screen where a sliver may stay visible;
+ *               on the background-posture engine a
  *               no-Dock-icon accessory process. Used by RunVerification /
  *               offscreen play instances, never by `summer run`.
  *
@@ -241,7 +241,7 @@ export async function detectBackgroundLaunchSupport(binary, options = {}) {
 }
 /**
  * The running engine's own word, once it is up: /api/health
- * `capabilities.launchPostures` (engine tool_net_thread.cpp, newer builds;
+ * `capabilities.launchPostures` (newer engine builds;
  * "focus" always, "background" / "offscreen" only where enforced). true /
  * false when advertised, null when the engine predates the advert.
  */

package/dist/core/library-read.js

@@ -13,8 +13,7 @@
  *   reference  the markdown body
  *   example / collection   README.md / collection.yaml when present
  *
- * The LAST line of every load is the feedback footer
- * (SELF_IMPROVING_LIBRARY.md §3.1 "trigger placement"):
+ * The LAST line of every load is the feedback footer:
  *   — entry_id: <id>@<content_hash first 12>. If this entry is wrong, stale,
  *   or you deviate from it, report via summer_library_feedback.
  * The agent copies that entry_id verbatim into summer_library_feedback, so

package/dist/core/templates.d.ts

@@ -53,8 +53,7 @@ export declare function getTemplateRegistry(): readonly TemplateEntry[];
  */
 export declare function resolveTemplate(query: string, entries: readonly TemplateEntry[]): TemplateResolution;
 /** Seconds a network git call (`fetch`) may take before it is killed.
- *  `summer create` once hung 42 minutes inside a fetch
- *  (docs/design/archive/TK-VS-FOLD-2026-09-07.md, gap 4). */
+ *  `summer create` once hung 42 minutes inside a fetch. */
 export declare const FETCH_TIMEOUT_ENV = "SUMMER_FETCH_TIMEOUT_S";
 export declare const DEFAULT_FETCH_TIMEOUT_S = 120;
 /** The bound in force: FETCH_TIMEOUT_ENV when it is a positive number of

package/dist/core/templates.js

@@ -109,8 +109,7 @@ export function resolveTemplate(query, entries) {
 }
 // ---------- git ----------
 /** Seconds a network git call (`fetch`) may take before it is killed.
- *  `summer create` once hung 42 minutes inside a fetch
- *  (docs/design/archive/TK-VS-FOLD-2026-09-07.md, gap 4). */
+ *  `summer create` once hung 42 minutes inside a fetch. */
 export const FETCH_TIMEOUT_ENV = "SUMMER_FETCH_TIMEOUT_S";
 export const DEFAULT_FETCH_TIMEOUT_S = 120;
 /** The bound in force: FETCH_TIMEOUT_ENV when it is a positive number of

package/dist/mcp/server.d.ts

@@ -6,8 +6,8 @@ export declare const getCachedBootDriftNotice: typeof getCachedNotice;
 /**
  * Server `instructions` in the MCP initialize response (SDK ServerOptions,
  * @modelcontextprotocol/sdk >= 1.x). Hosts hand this to the model once per
- * session, before any tool call — the place for the five habits the E2E run
- * (docs/design/archive/E2E-2026-09-03.md, F-17) showed an agent needs on the first
+ * session, before any tool call — the place for the five habits an end-to-end run
+ * showed an agent needs on the first
  * turn and would otherwise learn the hard way. Kept under 600 characters so
  * it costs a few hundred tokens once; the full operating guide stays in the
  * summer_agent_playbook prompt / summer_get_agent_playbook tool. The last

package/dist/mcp/server.js

@@ -34,8 +34,8 @@ export const getCachedBootDriftNotice = getCachedNotice;
 /**
  * Server `instructions` in the MCP initialize response (SDK ServerOptions,
  * @modelcontextprotocol/sdk >= 1.x). Hosts hand this to the model once per
- * session, before any tool call — the place for the five habits the E2E run
- * (docs/design/archive/E2E-2026-09-03.md, F-17) showed an agent needs on the first
+ * session, before any tool call — the place for the five habits an end-to-end run
+ * showed an agent needs on the first
  * turn and would otherwise learn the hard way. Kept under 600 characters so
  * it costs a few hundred tokens once; the full operating guide stays in the
  * summer_agent_playbook prompt / summer_get_agent_playbook tool. The last

package/dist/mcp/tools/creator-tools.js

@@ -100,7 +100,7 @@ export function registerCreatorTools(server) {
         ...args,
         face: "mcp",
     })));
-    server.tool("summer_creator_releases", "List real creator-owned releases from the versioned Summer Platform creator API. The server independently verifies the exact publish scope and project ownership.", {
+    server.tool("summer_creator_releases", "Deprecated: lists releases on the legacy Summercraft creator API (separate sc_ token), not summer.games. For what players get on summer.games, and which upload can be released, use summer_store_releases.", {
         projectId: z.string().optional().describe("Creator project ID. Defaults to ~/.summer/config.json."),
         limit: z.number().int().min(1).max(100).default(20),
         cursor: z.string().optional().describe("Opaque nextCursor from the previous page."),

package/dist/mcp/tools/debug-tools.js

@@ -178,7 +178,7 @@ Use this when summer_get_diagnostics shows a non-zero \`debugger.warnings\` coun
     }, async ({ max_warnings, include_stack, raw }) => withEngine(async (client) => {
         // Reuses the existing GetDebuggerErrors op with type: "warning" filter.
         // Engine-side change: ScriptEditorDebugger::get_errors_data() supports
-        // include_warnings; debug_ops::get_debugger_errors honours `type` to
+        // include_warnings; the engine's GetDebuggerErrors honours `type` to
         // return warnings only. Diagnostics also exposes `warnings_data`.
         const op = {
             op: "GetDebuggerErrors",

package/dist/mcp/tools/generate-tools.js

@@ -467,7 +467,7 @@ Optional rig pass (image-to-3d only):
   Set options.rig = true to add an auto-rig pass via Meshy v6. The result
   job (poll via summer_check_job) will include rigAssetId — the asset ID
   of the rigged glb. Use that rigAssetId with summer_generate_motion to
-  add animation clips. Adds ~$0.30 and ~60s to the job.
+  add animation clips. Adds ~60s to the job.
 
 Example:
   summer_generate_3d({
@@ -593,11 +593,11 @@ Requires authentication: run 'npx -y summer-engine@latest login' first.`, {
     server.tool("summer_generate_video", `Generate a video using AI models via Summer Engine Studio.
 
 Known models (text-to-video):
-  - "ltx" (default) — LTX Video, fast (~$0.10)
-  - "kling" — Kling 2 Master, high quality (~$0.50)
-  - "kling-turbo" — Kling 2.5 Turbo Pro (~$0.30)
-  - "minimax" — MiniMax (~$0.25)
-  - "veo3" — Google Veo 3, premium (~$1.00)
+  - "ltx" (default) — LTX Video, fast
+  - "kling" — Kling 2 Master, high quality
+  - "kling-turbo" — Kling 2.5 Turbo Pro
+  - "minimax" — MiniMax
+  - "veo3" — Google Veo 3, premium
 
 Known models (image-to-video, when imageUrl provided):
   - "ltx" (default), "kling", "minimax"
@@ -698,7 +698,7 @@ Requires authentication: run 'npx -y summer-engine@latest login' first.`, {
 Backends (pick one):
   - "meshy-library" (default) — a curated mocap clip by motionName on a
     Summer-rigged humanoid (rigAssetId from summer_generate_3d with
-    options.rig=true). Fast (~30s), cheap (~$0.10), real mocap quality.
+    options.rig=true). Fast (~30s), real mocap quality.
     Names that always work: idle, walk, run, jump, attack; anything else must
     be an exact library name.
   - "text-to-motion" — custom 2-second clips (60 frames) from text prompts on

package/dist/mcp/tools/navigation-tools.d.ts

@@ -2,6 +2,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
  * summer_open — the MCP face of `summer open`. Same behavior as the CLI
  * (src/core/capabilities/navigation/open.ts runOpen); this file only supplies
- * the engine client and the browser launcher. Design: docs/design/NAVIGATION-DESIGN.md §3.
+ * the engine client and the browser launcher.
  */
 export declare function registerNavigationTools(server: McpServer): void;

package/dist/mcp/tools/navigation-tools.js

@@ -6,7 +6,7 @@ import { openArgsShape, runOpen } from "../../core/capabilities/navigation/open.
 /**
  * summer_open — the MCP face of `summer open`. Same behavior as the CLI
  * (src/core/capabilities/navigation/open.ts runOpen); this file only supplies
- * the engine client and the browser launcher. Design: docs/design/NAVIGATION-DESIGN.md §3.
+ * the engine client and the browser launcher.
  */
 export function registerNavigationTools(server) {
     server.tool("summer_open", `Open the exact summerengine.com page or Summer Engine editor surface the user wants to LOOK at, by intent name — or, with open:false, return the URL / engine op without opening anything. The result ALWAYS carries the resolved url or op, also after opening, so you can tell the user where they landed.

package/dist/mcp/tools/spatial-tools.js

@@ -16,7 +16,7 @@ const NODE_PATH_LIMIT_BYTES = 256;
 const MIN_PLACEMENT_FLOOR_DISTANCE = 0.001;
 /** Mirrors the engine's SnapToSurface direction guard (length² > 1e-5). */
 const MIN_SNAP_DIRECTION_LENGTH_SQUARED = 0.00001;
-/** Starcast's own ceilings (engine spatial_ops.cpp starcast_3d): the engine
+/** Starcast's own ceilings in the engine: the engine
  *  measures the compact receipt as UTF-8 JSON, downgrades full -> summary
  *  above 12 KiB, and strips secondary paths above 5 KiB, so a receipt past the
  *  ceiling for its returnedDetail is one this CLI does not understand. Unlike

package/dist/mcp/tools/visual-tools.js

@@ -353,8 +353,8 @@ Static frame only — one moment, not motion. For a SEQUENCE of frames over time
                     if (snap.sceneHadLight === false) {
                         warnings.push("WARNING: this scene has no light — lit materials may appear black when played.");
                     }
-                    // The engine ALWAYS synthesizes the preview camera (preview_ops.cpp
-                    // sets used_synthetic_camera unconditionally) — the flag says nothing
+                    // The engine ALWAYS synthesizes the preview camera (it sets
+                    // used_synthetic_camera unconditionally) — the flag says nothing
                     // about the scene's own cameras. sceneHasCamera above is the
                     // authoritative "does this scene have a camera" answer.
                     if (snap.usedSyntheticCamera) {

package/dist/mcp/tools/with-engine.d.ts

@@ -41,8 +41,7 @@ export interface WithEngineOptions<T> {
 }
 /**
  * An auth failure is the ONE class of thrown error that is provably pre-apply:
- * the engine rejects on the Bearer-token check (tool_net_thread.cpp::_validate_auth)
- * BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
+ * the engine rejects on the Bearer-token check BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
  * retrying cannot double-apply a mutation. This is exactly the stale-token case
  * after the engine rotates its api-token on relaunch.
  *