summer-engine 3.4.0 → 3.5.0

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,12 +1,20 @@
 /**
- * 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";
+/** The same platforms, in any order. */
+export declare function samePlatforms(a: readonly string[], b: readonly string[]): boolean;
+/**
+ * Why the store will refuse this hosted bundle's Build declaration, or null.
+ * The store requires summer.build.json's targetPlatforms to equal the
+ * platforms the client pack was exported for (declaration_mismatch), and the
+ * refusal spends the clientVersion, so this is checked before any upload.
+ */
+export declare function declarationMismatch(bundle: Pick<SummerBundle, "hostedBuild" | "targetPlatforms">): string | null;
 /** A failure with a stable code, a plain message and the next step. */
 export declare class BuildToolError extends Error {
     readonly code: string;

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

@@ -2,17 +2,35 @@ 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";
 const BUNDLE_CLIENT = "client.pck";
 const BUNDLE_SERVER = "server.pck";
 const BUNDLE_BUILD = "config/summer.build.json";
+/** The same platforms, in any order. */
+export function samePlatforms(a, b) {
+    return a.length === b.length && [...a].sort().join(",") === [...b].sort().join(",");
+}
+/**
+ * Why the store will refuse this hosted bundle's Build declaration, or null.
+ * The store requires summer.build.json's targetPlatforms to equal the
+ * platforms the client pack was exported for (declaration_mismatch), and the
+ * refusal spends the clientVersion, so this is checked before any upload.
+ */
+export function declarationMismatch(bundle) {
+    const declared = bundle.hostedBuild?.targetPlatforms;
+    if (!Array.isArray(declared))
+        return null;
+    const platforms = declared.map(String);
+    return samePlatforms(platforms, bundle.targetPlatforms)
+        ? null
+        : `the bundle targets ${[...bundle.targetPlatforms].sort().join(", ")} but its summer.build.json declares ${[...platforms].sort().join(", ")}`;
+}
 const SHA256 = /^sha256:[0-9a-f]{64}$/;
 const AS_EXPORTED = "Recovery: export the game again with the summer.games preset and use the .zip exactly as Summer Engine wrote it.";
 /** A failure with a stable code, a plain message and the next step. */

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

@@ -28,7 +28,7 @@ import { executeSceneMutation, occurrenceCount, readTextPayload, safeProjectPath
 import { extractOpError, withOldEngineHint } from "./engine-receipt.js";
 import { lookupApiDocs } from "./api-docs.js";
 import { BOARD_ENDPOINT, boardArgsSchema, boardQuery } from "./board.js";
-import { imageGenerationArgsSchema } from "./image-generation.js";
+import { IMAGE_GENERATION_TIMEOUT_MS, imageGenerationArgsSchema, saveGeneratedImage } from "./image-generation.js";
 import { buildMotionRequestBody, motionGenerationArgsSchema } from "./motion-generation.js";
 import { ImportHdriError, importHdriArgsSchema, importPolyHavenHdri } from "./hdri-import.js";
 import { FABRICATE_FALLBACK, buildFabricateMeshOp, fabricateArgsSchema } from "./fabricate-mesh.js";
@@ -618,6 +618,7 @@ export const TOOL_DISPATCH = [
         targets: Array.isArray(args.targets) ? args.targets.map(String) : undefined,
         format: optStr(args, "format"),
         debug: args.debug === true,
+        alignDeclaration: args.alignDeclaration === true,
         ...(typeof args.timeoutSeconds === "number" ? { timeoutMs: args.timeoutSeconds * 1000 } : {}),
     })),
     entry("summer_export_templates", "List or install Summer export templates from the CDN (web, macos, windows)", false, (args) => {
@@ -639,6 +640,8 @@ export const TOOL_DISPATCH = [
         waitSeconds: optNumberOrUndefined(args, "waitSeconds"),
         intervalSeconds: optNumberOrUndefined(args, "intervalSeconds"),
         out: optStr(args, "out"),
+        args: args.args,
+        steps: args.steps,
     })),
     entry("summer_publish_build", "Upload a summer.games export to your store game (confirm-gated)", false, (args) => publishBuild({
         gameId: optStr(args, "gameId"),
@@ -661,7 +664,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"),
@@ -896,7 +899,15 @@ export const TOOL_DISPATCH = [
         const parsed = parseToolArgs(boardArgsSchema, args, "get-board");
         return gatewayGet(BOARD_ENDPOINT, boardQuery({ ...parsed, pictures: parsed.pictures ?? false }), 45_000);
     }),
-    entry("summer_generate_image", "Generate or edit an image via Summer Studio", false, (args) => gatewayPost("/api/mcp/generate/image", parseToolArgs(imageGenerationArgsSchema, args, "generate-image"))),
+    entry("summer_generate_image", "Generate or edit an image via Summer Studio", false, async (args) => {
+        const { out, ...body } = parseToolArgs(imageGenerationArgsSchema, args, "generate-image");
+        const result = await gatewayPost("/api/mcp/generate/image", body, IMAGE_GENERATION_TIMEOUT_MS);
+        if (!out)
+            return result;
+        const asset = (result.asset ?? {});
+        const url = typeof asset.fileUrl === "string" ? asset.fileUrl : typeof asset.thumbnailUrl === "string" ? asset.thumbnailUrl : null;
+        return { ...result, localPath: url ? await saveGeneratedImage(url, out) : null };
+    }),
     entry("summer_slice_asset_sheet", "Detect and crop every asset from a generated sheet image", false, (args) => gatewayPost("/api/mcp/generate/slice-asset-sheet", { assetId: str(args, "assetId") }, 300_000)),
     entry("summer_generate_audio", "Generate speech, sound effects, music, or dialogue", false, (args) => {
         const body = { capability: str(args, "capability") };

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.d.ts

@@ -10,6 +10,8 @@ export declare const FOOTER_SUFFIX = "If this entry is wrong, stale, or you devi
 export declare const LINKED_FILE_EXTENSIONS: ReadonlySet<string>;
 /** A linked file larger than this is refused rather than dumped. */
 export declare const LINKED_FILE_MAX_BYTES: number;
+/** How long a hosted skill read waits for the hosted Summer Engine MCP. */
+export declare const HOSTED_READ_TIMEOUT_MS = 8000;
 export declare const readLibraryInputShape: {
     id: z.ZodString;
     part: z.ZodOptional<z.ZodEnum<["skill", "resource", "all"]>>;
@@ -29,6 +31,8 @@ export interface LibraryReadDeps extends LibrarySearchDeps {
     /** Root holding library/ (default: the installed package). */
     packageRoot?: string;
     templates?: readonly TemplateEntry[];
+    /** Reads a hosted skill's text by resource URI; throws when it cannot. */
+    readHostedResource?: (uri: string) => Promise<string>;
 }
 export interface LibraryReadOk {
     ok: true;
@@ -57,6 +61,9 @@ export interface LibraryReadOk {
         target: string;
         id: string | null;
     }>;
+    /** Hosted skills: the resource the body comes from, and why it did not load. */
+    hosted_resource?: string;
+    hosted_error?: string;
     /** Tool records: how to reach it. */
     mcp_tool_name?: string;
     cli_command?: string;