wave3d-agent-sdk 0.2.11 → 0.2.13

package/README.md

@@ -21,19 +21,19 @@ Vocabulary:
 - Project: user workspace content. Reading a project is not opening/replacing live workspace.
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.11 start
+npx -y wave3d-agent-sdk@0.2.13 start
 ```
 
 After Copy to Agent, run the exact start command with MCP_TOKEN preserved as the local pairing secret. Keep it hidden:
 
 ```bash
-WAVE3D_MCP_TOKEN="$MCP_TOKEN" npx -y wave3d-agent-sdk@0.2.11 start
+WAVE3D_MCP_TOKEN="$MCP_TOKEN" npx -y wave3d-agent-sdk@0.2.13 start
 ```
 
 Check SDK build before trusting a running SDK process:
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.11 --version
+npx -y wave3d-agent-sdk@0.2.13 --version
 ```
 
 The package bundles the WaveEngine SDK lookup corpus. No normal session needs a separate protected zip download.
@@ -43,7 +43,7 @@ The package bundles the WaveEngine SDK lookup corpus. No normal session needs a
 Wave Studio Copy to Agent defaults same-machine live MCP transport to this SDK:
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.11 start
+npx -y wave3d-agent-sdk@0.2.13 start
 ```
 
 Agents choose topology first:
@@ -58,13 +58,13 @@ Use `MCP_HTTP_GATEWAY_FALLBACK_URL` only for topology mismatch, remote/sandboxed
 For unfamiliar authoring, use the local SDK tools:
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.11 cache search "continuous left rotation"
+npx -y wave3d-agent-sdk@0.2.13 cache search "continuous left rotation"
 ```
 
 `cache refresh` without MCP arguments reinstalls the bundled SDK into `~/.wave3d/agent-cache`:
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.11 cache refresh
+npx -y wave3d-agent-sdk@0.2.13 cache refresh
 ```
 
 Old `cache refresh --mcp-url <url> --token <token>` arguments are ignored. Normal users update the npm package; no separate zip download exists.

package/dist/cli.js

@@ -264,6 +264,8 @@ var AssetType;
   AssetType2["CubeMap"] = "CubeMap";
   AssetType2["Font"] = "Font";
   AssetType2["SerializedData"] = "SerializedData";
+  AssetType2["Pose"] = "Pose";
+  AssetType2["Animation"] = "Animation";
   AssetType2["Video"] = "Video";
   AssetType2["FxSystem"] = "FxSystem";
   AssetType2["VertexAnimation"] = "VertexAnimation";
@@ -453,15 +455,17 @@ var PROJECT_ASSET_KIND_SPECS = {
   },
   animation: {
     sourceTypes: ["raw", "project"],
-    inlineDefinitionSupport: "none"
+    inlineDefinitionSupport: "none",
+    runtimeAssetType: AssetType.Animation
   },
   rig: {
     sourceTypes: ["raw", "project"],
     inlineDefinitionSupport: "none"
   },
   pose: {
-    sourceTypes: ["project"],
-    inlineDefinitionSupport: "none"
+    sourceTypes: ["raw", "project"],
+    inlineDefinitionSupport: "none",
+    runtimeAssetType: AssetType.Pose
   },
   vertexAnimation: {
     sourceTypes: ["raw", "project"],
@@ -527,6 +531,7 @@ var PROJECT_ASSET_ACCESSOR_BUCKETS = [
   "materials",
   "textures",
   "animations",
+  "poses",
   "audios",
   "instruments",
   "videos",
@@ -41604,7 +41609,7 @@ var DEFAULT_PHYSICS = {
 };
 
 // ../../src/lib/waveStudio/assets/contracts/waveStudioEngineAssetContracts.ts
-var WAVE_STUDIO_ENGINE_ACCESSOR_BUCKET_EXTENSIONS = ["cubeMaps"];
+var WAVE_STUDIO_ENGINE_ACCESSOR_BUCKET_EXTENSIONS = ["cubeMaps", "poses"];
 function withAccessorBucketExtensions(buckets) {
   const existingBuckets = new Set(buckets);
   return Object.freeze([
@@ -41697,6 +41702,8 @@ var WAVE_STUDIO_ACCEPTED_USER_UPLOAD_EXTENSIONS = [
   "zip",
   "wmat",
   "vat.json",
+  "anim.json",
+  "pose.json",
   "splat",
   "ply",
   "spz",
@@ -41761,6 +41768,8 @@ var WAVE_STUDIO_USER_ASSET_MIME_TYPE_BY_EXTENSION = Object.freeze({
   zip: "application/zip",
   wmat: "application/vnd.wave.material+deflate",
   "vat.json": "application/json",
+  "anim.json": "application/json",
+  "pose.json": "application/json",
   splat: "application/octet-stream",
   ply: "application/octet-stream",
   spz: "application/octet-stream",
@@ -41771,9 +41780,10 @@ var WAVE_STUDIO_BRIDGE_ASSET_UPLOAD_EXTENSIONS_BY_KIND = Object.freeze({
   model: ["glb", "gltf", "obj", "stl"],
   fbx_model: ["fbx"],
   gaussianSplat: ["splat", "ply", "spz", "sog", "sog.json"],
-  animation: ["glb", "gltf", "obj"],
+  animation: ["glb", "gltf", "obj", "anim.json"],
   fbx_animation: ["fbx"],
   vertexAnimation: ["vat.json"],
+  pose: ["pose.json"],
   texture: ["jpg", "jpeg", "png", "webp", "gif", "bmp", "tiff", "ktx", "ktx2"],
   hdrEnvironment: ["hdr"],
   cubeMap: ["env", "dds"],
@@ -41818,6 +41828,7 @@ var WAVE_STUDIO_BRIDGE_ASSET_UPLOAD_KIND_ALIASES = Object.freeze({
   splat: "gaussianSplat",
   spz: "gaussianSplat",
   anim: "animation",
+  animjson: "animation",
   animationclip: "animation",
   fbxanim: "fbx_animation",
   fbxanimation: "fbx_animation",
@@ -41826,6 +41837,9 @@ var WAVE_STUDIO_BRIDGE_ASSET_UPLOAD_KIND_ALIASES = Object.freeze({
   vatjson: "vertexAnimation",
   vertexanimation: "vertexAnimation",
   vertex_animation: "vertexAnimation",
+  pose: "pose",
+  posejson: "pose",
+  poses: "pose",
   hdri: "hdrEnvironment",
   hdrenvironment: "hdrEnvironment",
   hdr: "hdrEnvironment",
@@ -41879,6 +41893,8 @@ function getWaveStudioBridgeAssetUploadKindHelpText() {
 function getWaveStudioUserAssetUploadExtension(filename) {
   const normalizedFilename = String(filename || "").trim().toLowerCase();
   if (normalizedFilename.endsWith(".vat.json")) return "vat.json";
+  if (normalizedFilename.endsWith(".anim.json")) return "anim.json";
+  if (normalizedFilename.endsWith(".pose.json")) return "pose.json";
   if (normalizedFilename.endsWith(".sog.json")) return "sog.json";
   return normalizedFilename.split(".").pop() || "";
 }
@@ -41983,7 +41999,7 @@ var WAVE_STUDIO_PRIMARY_ASSET_BUCKET_SPECS = Object.freeze([
     assetTypes: ["animation", "vertexAnimation"],
     label: "Animation",
     pluralLabel: "Animations",
-    defaultExtension: ".glb",
+    defaultExtension: ".anim.json",
     baseCategoryAliases: [
       "animations",
       "animation",
@@ -41994,10 +42010,22 @@ var WAVE_STUDIO_PRIMARY_ASSET_BUCKET_SPECS = Object.freeze([
       "vat"
     ],
     pathFolderAliases: ["animations"],
-    pathExtensions: ["vat.json"],
+    pathExtensions: ["anim.json", "vat.json", "glb", "gltf", "fbx"],
     assetManagerAlias: "animationNames",
     monaco: { interfaceName: "AnimationNames", propertyName: "animationNames" }
   },
+  {
+    bucket: "poses",
+    assetTypes: ["pose"],
+    label: "Pose",
+    pluralLabel: "Poses",
+    defaultExtension: ".pose.json",
+    baseCategoryAliases: ["poses", "pose"],
+    pathFolderAliases: ["poses"],
+    pathExtensions: ["pose.json"],
+    assetManagerAlias: "poseNames",
+    monaco: { interfaceName: "PoseNames", propertyName: "poseNames" }
+  },
   {
     bucket: "audios",
     assetTypes: ["audio"],
@@ -42233,6 +42261,7 @@ var WAVE_STUDIO_USER_ASSET_UPLOAD_KIND_TO_TYPE = Object.freeze({
   animation: "animation",
   fbx_animation: "animation",
   vertexAnimation: "vertexAnimation",
+  pose: "pose",
   texture: "texture",
   hdrEnvironment: "hdrEnvironment",
   cubeMap: "cubeMap",
@@ -42267,6 +42296,9 @@ var WAVE_STUDIO_ASSET_TYPE_ALIASES = Object.freeze({
   material_zip: "material",
   fbxanimation: "animation",
   fbx_animation: "animation",
+  animjson: "animation",
+  posejson: "pose",
+  poses: "pose",
   vat: "vertexAnimation",
   vatjson: "vertexAnimation",
   vertexanimation: "vertexAnimation",
@@ -42488,8 +42520,8 @@ function normalizeWaveGenieAssetUploadRequest(request) {
 
 // ../../src/lib/waveStudio/aiAssist/bridge/localAgentSdkContract.ts
 var WAVE3D_AGENT_SDK_PACKAGE_NAME = "wave3d-agent-sdk";
-var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.11";
-var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260622.1";
+var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.13";
+var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260625.1";
 var WAVE3D_AGENT_SDK_PACKAGE_SPEC = `${WAVE3D_AGENT_SDK_PACKAGE_NAME}@${WAVE3D_AGENT_SDK_REQUIRED_VERSION}`;
 var WAVE3D_AGENT_SDK_START_COMMAND = `npx -y ${WAVE3D_AGENT_SDK_PACKAGE_SPEC} start`;
 var WAVE3D_AGENT_SDK_TOKEN_ENV_VAR = "WAVE3D_MCP_TOKEN";
@@ -44118,7 +44150,7 @@ var WAVE_AUTHORING_CORE_RULES = {
   terrainGroundRouting: "`myScene.terrain` is the terrain controller/recipe surface for world terrain state: heightfield sculpting, mountains, rivers, terrain-wide materials, splat paint, water, queries, and world/streaming persistence. `myScene.ground` is the live `waveTerrainTile` under the primary render camera: use it only for tile-local entity behavior, visual overlays, transform/tooling, sensing/interactable callbacks, and local inspection. Tile-local visual material/color edits are overlays and should win over terrain-wide material stamping for that tile; terrain-wide material remains the base for tiles with no local overlay.",
   argumentAssembly: "Assemble arguments deliberately: asset refs, bare globals, option objects, callbacks, units, and terminal verbs.",
   assetResolution: "When passing an existing asset as an argument, resolve the exact typed asset ref from current code or the asset catalog before writing it; never invent asset map keys. When creating/configuring an asset handle, choose the intent-owned Wave facade first.",
-  sourceOwnership: "For modular Studio projects, make each hot-reloadable file own the objects, callbacks, promoted parts, and visual mutations it wants to iterate on. Keep helpers pure or parameterized. For intentional live entity reuse across source-root modules, use `waveStudio.exportEntity(name, entity)` in the owner and `waveStudio.importEntity<T>(name)` in importers. Studio builds a dependency graph across runnable source roots plus `main.ts`: exporters run before importers; if `main.ts` imports an exported entity, that owner source runs before `main.ts`; importer overlay files run after the exporter/main baseline. Names must be static string literals, unique, and acyclic or run/hot reload stops before execution.",
+  sourceOwnership: "For modular Studio projects, make each hot-reloadable file own the objects, callbacks, promoted/adopted parts, and visual mutations it wants to iterate on. Keep helpers pure or parameterized. For intentional live entity reuse across source-root modules, use `waveStudio.exportEntity(name, entity)` in the owner and `waveStudio.importEntity<T>(name)` in importers. Studio builds a dependency graph across runnable source roots plus `main.ts`: exporters run before importers; if `main.ts` imports an exported entity, that owner source runs before `main.ts`; importer overlay files run after the exporter/main baseline. Names must be static string literals, unique, and acyclic or run/hot reload stops before execution.",
   typeScriptGlue: "Use concise TypeScript glue around WaveEngine calls, but avoid manual runtime loops, large state machines, or engine-internal plumbing when public authoring APIs express the intent.",
   syncUserCode: "Keep authored scene code synchronous by default. Do not use async/await, Promises, async callbacks, or top-level asynchronous user code unless the user explicitly and strongly asks for asynchronous/network/permission/worker behavior and understands the Wave Studio online coding environment; prefer WaveEngine synchronous facades and Studio/bootstrap-managed loading.",
   hotReloadCallbackSafety: "Hot-reload safety is a hard authoring rule. Do not write raw unmanaged callback roots in authored Studio code: no setInterval/setTimeout/setImmediate/requestAnimationFrame/requestIdleCallback/queueMicrotask, addEventListener/removeEventListener/requestVideoFrameCallback/watchPosition, Promise callback chains (.then/.catch/.finally) or new Promise(...), raw observers/workers/sockets/channels, eventBus/myScene raw subscriptions, or raw event-handler property assignments such as .onclick = or .onmessage =. Use Wave-owned callbacks, Animate DSL, entity lifecycle/tick/state APIs, contact/input/Director APIs, or other scoped Wave APIs so hot reload can unregister old closures."
@@ -44485,7 +44517,7 @@ var WAVE_MCP_CODING_GUARDRAIL = [
   "7a. Use `list_wave_explorer_assets` when you need uploaded asset explorer metadata such as path, URL, size, or display/ref name for rename/delete/library work. It is not a fallback for built-in/public code refs and may be empty while `find_wave_assets_by_category` has many usable refs.",
   '8. Wave Studio automations: `project.assetrefs.ts`, `project.scene.ts`, `project.scenes.ts`, and `project.execution.ts` are automatically managed by Wave Studio and are MCP read-only for agents. `bootstrap.ts` / scene `*/bootstrap.ts` is normally managed too. Edit bootstrap only when you can confidently pass `managedFileEditReason` as one of: `world_streaming_or_terrain_provider` (including Google Maps 3D tiles), `render_profile_or_runtime_backend`, `media_consent_or_capture_plan`, `external_ai_or_tts_backend`, `scene_envelope_or_template_baseline`, `baseline_setup_before_user_main`, or `stale_api_update_to_latest`. Never edit bootstrap for `asset_manifest_or_loader`, `instrument_registry`, `scene_registry`, or `execution_manifest`; Studio owns those. Do not edit managed files to register/preload assets, wire scenes, execution order, or force bootstrap sync; write user-authored scene code in `main.ts` or feature modules with bare refs like `models.Robot` or `textures.Grass`, then let Studio sync bootstrap/asset/scene/execution wiring. Hot reload is the normal way to see code changes. Static VFS/package/asset-surface changes can be detected from file/package diffs, so Studio may upgrade the reload tier internally (`patchMain`, `preserveScene`, or hard `rebuildScene`). Runtime-authored UI state changes cannot be inferred from files; when UI changes bootstrap/world-provider/runtime-envelope state, call `waveStudio.reloadPreview({ reason, invalidates: ["world-provider"] })` with the narrowest valid invalidation: `bootstrap`, `world-provider`, or `runtime-envelope`. Only the hard rebuild tier performs a full bundled scene run.',
   "9. Use `waveStudio.*` only for Studio host services. Check `waveStudio.capabilities.assetSave` before save/bake calls.",
-  '10. Make deterministic file edits through the simplest fitting tool. Default to forgiving `edit_wave_file`: oldText infers exact replace, startLine/endLine infers line replace, `edits:[{startLine,endLine,text}]` or `edits:[{rangeOffset,rangeLength,text}]` performs one-file multi-edit, and path+text/content with no oldText infers whole-file replace. It is the primary simple edit tool and can omit `baseHash`; Studio resolves the latest hosted VFS mirror contentHash and still applies browser-side stale-write checks. Prefer canonical fields: `path` for file path, `text` for line/whole-file content, and `newText` for text replacement; `filePath`, `replacement`, and `content` are accepted as aliases where useful. Use `apply_wave_patch({ operations: [...] })` for multi-file edits, grouped cross-file edits, unified diffs, or full rewrites; a single bare operation is tolerated for mistake recovery but operations:[...] is preferred. Use `create_wave_file`, `rename_wave_file`, and `delete_wave_file` to split projects into `.ts` modules such as `/actors/player.ts`, `/systems/obstacles.ts`, and `/levels/obby.ts` instead of growing one giant `main.ts`; newly created `.ts/.tsx` files are standalone runnable source roots by default, so top-level scene code in them runs on Run/hot reload. Pass `runnable:false` only for pure helper modules that should not execute on their own. These same VFS tools also create `.html` sketch files for diagrams/charts/docs, with Mermaid rendered from `<div class="mermaid">...</div>` when the HTML file is active in the editor/coding pane; HTML sketches must never replace the live engine preview iframe. Scene-root modules and their owned helpers run inside the Studio authoring context, but helpers should stay pure or parameterized. Studio hot reload targets the active/open edited file when safe: `/main.ts` reloads the whole main graph, scene-root modules reload that root, and bootstrap/scene registry/assets/network/ambiguous helper surfaces escalate. Standalone `hot_reload_wave_preview` has no target path and follows the currently open/active Studio editor file in multi-file projects. A feature file should own the objects, callbacks, promoted GLB parts, and appearance mutations it wants to iterate on. For intentional live entity reuse across modules, the owner calls `waveStudio.exportEntity("Name", entity)` and importers call `waveStudio.importEntity<T>("Name")`; do not pass live entities through shared helper exports. Use exact VFS paths from `list_wave_files`; read target file before writing. `contentHash` is a cooperative stale-write fingerprint, not a security boundary. For advanced compact `apply_wave_patch` operations, pass the latest full-file `contentHash` as `baseHash`: one `lineEdits`, one `textEdits`, one strict `searchReplace`, or one `unifiedDiff`. Do not send multiple compact ops for the same file with the same baseHash; the first edit changes the file hash and later compact ops skip as stale. Scoped `read_wave_file` line ranges do not change the `textEdits` offset base; they do pair naturally with line-based edits. Existing-file `writeFile` requires `baseHash` unless `forceOverwrite: true`; force overwrite is only for intentional stale overwrites.',
+  '10. Make deterministic file edits through the simplest fitting tool. Default to forgiving `edit_wave_file`: oldText infers exact replace, startLine/endLine infers line replace, `edits:[{startLine,endLine,text}]` or `edits:[{rangeOffset,rangeLength,text}]` performs one-file multi-edit, and path+text/content with no oldText infers whole-file replace. It is the primary simple edit tool and can omit `baseHash`; Studio resolves the latest hosted VFS mirror contentHash and still applies browser-side stale-write checks. Prefer canonical fields: `path` for file path, `text` for line/whole-file content, and `newText` for text replacement; `filePath`, `replacement`, and `content` are accepted as aliases where useful. Use `apply_wave_patch({ operations: [...] })` for multi-file edits, grouped cross-file edits, unified diffs, or full rewrites; a single bare operation is tolerated for mistake recovery but operations:[...] is preferred. Use `create_wave_file`, `rename_wave_file`, and `delete_wave_file` to split projects into `.ts` modules such as `/actors/player.ts`, `/systems/obstacles.ts`, and `/levels/obby.ts` instead of growing one giant `main.ts`; newly created `.ts/.tsx` files are standalone runnable source roots by default, so top-level scene code in them runs on Run/hot reload. Pass `runnable:false` only for pure helper modules that should not execute on their own. These same VFS tools also create `.html` sketch files for diagrams/charts/docs, with Mermaid rendered from `<div class="mermaid">...</div>` when the HTML file is active in the editor/coding pane; HTML sketches must never replace the live engine preview iframe. Scene-root modules and their owned helpers run inside the Studio authoring context, but helpers should stay pure or parameterized. Studio hot reload targets the active/open edited file when safe: `/main.ts` reloads the whole main graph, scene-root modules reload that root, and bootstrap/scene registry/assets/network/ambiguous helper surfaces escalate. Standalone `hot_reload_wave_preview` has no target path and follows the currently open/active Studio editor file in multi-file projects. A feature file should own the objects, callbacks, promoted/adopted GLB parts, and appearance mutations it wants to iterate on. For intentional live entity reuse across modules, the owner calls `waveStudio.exportEntity("Name", entity)` and importers call `waveStudio.importEntity<T>("Name")`; do not pass live entities through shared helper exports. Use exact VFS paths from `list_wave_files`; read target file before writing. `contentHash` is a cooperative stale-write fingerprint, not a security boundary. For advanced compact `apply_wave_patch` operations, pass the latest full-file `contentHash` as `baseHash`: one `lineEdits`, one `textEdits`, one strict `searchReplace`, or one `unifiedDiff`. Do not send multiple compact ops for the same file with the same baseHash; the first edit changes the file hash and later compact ops skip as stale. Scoped `read_wave_file` line ranges do not change the `textEdits` offset base; they do pair naturally with line-based edits. Existing-file `writeFile` requires `baseHash` unless `forceOverwrite: true`; force overwrite is only for intentional stale overwrites.',
   "10a. Always inspect `changedFiles`, `changedPaths`, `partial`, `skippedOperations`, `hotReloadRequested`, `hotReloadSkippedReason`, and `runtimeVerification`; treat skipped operations, no-content-change skips, unscheduled hot reloads, runtime verification errors, and `runtimeVerification.diagnostics.editorErrorCount > 0` as work still needing attention.",
   '11. After the final code edit, default to hot reload. Prefer `awaitHotReload: true` on the edit tool when you want one MCP response with edit result + hot reload + bounded diagnostics. `requestHotReload:true` also waits for diagnostics by default unless paired with `awaitHotReload:false`. Standalone `run_wave_preview` / `hot_reload_wave_preview` also wait by default and return `runtimeVerification`; set `awaitRuntimeResult:false` only for intentional fire-and-poll. Caveat: standalone `hot_reload_wave_preview` mirrors the toolbar button and reloads the currently open/active TypeScript file in multi-file projects; it does not take a target path or reload every user-created .ts module. That hot-reload request may internally upgrade from `patchMain` to `preserveScene` or hard `rebuildScene` when assets/bootstrap/scene surface changed; do not manually force bootstrap sync. Runtime-authored UI that changes bootstrap/world-provider/runtime-envelope state must call `waveStudio.reloadPreview({ reason, invalidates: ["world-provider"] })` because Studio cannot infer that from static file diffs. Use `run_wave_preview` only when diagnostics show no successful preview yet (`hasRunSucceeded: false`), the user explicitly asks for a full run/restart, or hot reload/polling fails and a full restart is the last resort. `pause_wave_preview` and `resume_wave_preview` are direct preview controls mirroring the toolbar pause/resume buttons.',
   '12. After run/hot reload, use returned `runtimeVerification` when present; otherwise call `get_wave_runtime_diagnostics` repeatedly until `runtimeBusy` is false and `lastRuntimeOutcome` is `success` or `error`. Use `previewExecutionPhase` to distinguish Studio preparing work from the preview iframe executing it. `isRunning` is only the Studio scheduling flag, not the final runtime completion gate. If the edit/runtime tool returned `requestedAt` or `runtimeActionRequestedAt`, ignore diagnostics whose `lastRuntimeOutcomeAt` is older than that timestamp. Treat `latestError` as current only when `lastRuntimeOutcome` is `error`; older error lines can remain in returned logs as history. Treat `editorErrorCount > 0` as blocking Monaco/linter/compile failure and read `editorDiagnostics` before claiming success, even when `lastRuntimeOutcome` is `success`. If `lastRuntimeOutcome` is `success` and `editorErrorCount` is 0, verify visually with `capture_wave_screenshot({ resolution: "L" })` or structurally with `get_wave_runtime_entity_snapshot({ variableName, filePath? })` instead of declaring failure from old log text. Same-machine screenshots usually return `localPath`; hosted screenshots return exact field `dataBase64`, not `imageBase64`.',
@@ -44596,7 +44628,7 @@ var WAVE_MCP_FILE_CONTEXT_GUIDE = [
   "- Use `share_wave_project()` to create a 30-day share link for the current live project through the same Share Project menu pipeline, then return the `url` to the user.",
   "- Use `list_wave_explorer_assets` to inspect the uploaded asset explorer library with paths, URLs, display names, and ref keys. `rename_wave_asset` changes the display/ref name only; it does not move the stored blob path.",
   "- `bootstrap.ts` / scene `*/bootstrap.ts`: Studio-managed boot/config code that creates or loads the scene. Agents may read it for context. Agents may edit it only with a valid `managedFileEditReason` for world streaming/terrain provider (including Google Maps 3D tiles), render/runtime backend, media consent/capture, external AI/TTS backend, scene-envelope/template baseline, baseline setup before main.ts, or stale bootstrap API update to latest. Asset reference parsing accepts both `ASSET_WAREHOUSE.models.X` and bare `models.X`; prefer bare aliases in user-authored main/module code and never edit bootstrap to register assets.",
-  "- Scene-root modules and their owned helpers run inside the Studio authoring context. Keep shared helpers pure or parameterized; put live object ownership, callbacks, promoted parts, and appearance mutations in the feature file expected to hot reload. For intentional live entity reuse across scene-root modules, use `waveStudio.exportEntity(name, entity)` and `waveStudio.importEntity<T>(name)`. Studio builds a deterministic source-root graph: exporters run before importers, exporter roots run before `main.ts` when main imports them, importer overlays run after the exporter/main baseline, and duplicate/dynamic/cyclic names stop run/hot reload before execution."
+  "- Scene-root modules and their owned helpers run inside the Studio authoring context. Keep shared helpers pure or parameterized; put live object ownership, callbacks, promoted/adopted parts, and appearance mutations in the feature file expected to hot reload. For intentional live entity reuse across scene-root modules, use `waveStudio.exportEntity(name, entity)` and `waveStudio.importEntity<T>(name)`. Studio builds a deterministic source-root graph: exporters run before importers, exporter roots run before `main.ts` when main imports them, importer overlays run after the exporter/main baseline, and duplicate/dynamic/cyclic names stop run/hot reload before execution."
 ].join("\n");
 
 // ../../src/lib/waveStudio/aiAssist/bridge/hosted/mcpResources/studioSkillMap.ts
@@ -44668,7 +44700,7 @@ var WAVE_MCP_STUDIO_TOOL_GUIDE = [
   "- `waveStudio.exportEntity(name, entity)`: declare a live entity owned by the current source module for intentional modular reuse. `name` must be a static string literal and unique across runnable roots.",
   "- `waveStudio.importEntity<T>(name)`: import an exported live entity into the current source module; Studio restores the exporter baseline and prunes/replays importer callbacks/overlays during source hot reload. Studio orders source roots by export/import dependencies: exporter before importer; exporter before `main.ts` if main imports it; overlay importers after exporter/main baseline. Missing, duplicate, dynamic, or cyclic entity names stop run/hot reload before execution.",
   '- MCP command result rule: poll `get_wave_command_result({ requestId })` only when the previous tool response includes `status:"pending"` plus `requestId`. HTTP Gateway browser-backed tools may return pending and need that poll. WaveEngine Agent SDK browser-backed tools wait directly and return final results; its `get_wave_command_result` is a catalog-parity no-op unless a pending result was explicitly returned.',
-  "- MCP preview tools: `hot_reload_wave_preview` (alias `hotreload_wave_preview`) is the default standalone way to view code changes in an already-running preview; `run_wave_preview` (alias `run_project`) is for first start when diagnostics show `hasRunSucceeded: false`, explicit full restart requests, or last-resort recovery after hot reload/polling fails; `pause_wave_preview` / `resume_wave_preview` mirror the toolbar pause/resume buttons. All require write pairing because they mutate live Studio runtime state. Runtime-triggering tools wait by default and return same-call `runtimeVerification`; set `awaitRuntimeResult:false` only when intentionally fire-and-polling. `hot_reload_wave_preview` mirrors the Wave Studio toolbar button and has no path argument: in multi-file VFS projects it reloads the currently open/active TypeScript file when safe, not every user-created .ts module. For a specific module, make that file active in Studio before calling the standalone hot-reload tool, or use the edit tool `awaitHotReload:true` immediately after the final edit. Main entries reload the main graph, source-root modules reload that root, and bootstrap/scene registry/assets/network/ambiguous helper surfaces escalate. Agents should organize feature-owned objects, callbacks, promoted parts, and appearance mutations into the file they expect to hot reload; use `waveStudio.exportEntity`/`waveStudio.importEntity` only when a live entity intentionally crosses module boundaries. Hot reload may internally choose `patchSource`, `patchMain`, `preserveScene`, or hard `rebuildScene`; agents should inspect returned `runtimeVerification` or poll diagnostics instead of manually guessing the tier. Poll `get_wave_runtime_diagnostics` only when `runtimeVerification` is absent, timed out, or ambiguous; require `editorErrorCount === 0`, then choose one relevant proof tool if needed: screenshot, runtime entity snapshot, markers, or performance snapshot."
+  "- MCP preview tools: `hot_reload_wave_preview` (alias `hotreload_wave_preview`) is the default standalone way to view code changes in an already-running preview; `run_wave_preview` (alias `run_project`) is for first start when diagnostics show `hasRunSucceeded: false`, explicit full restart requests, or last-resort recovery after hot reload/polling fails; `pause_wave_preview` / `resume_wave_preview` mirror the toolbar pause/resume buttons. All require write pairing because they mutate live Studio runtime state. Runtime-triggering tools wait by default and return same-call `runtimeVerification`; set `awaitRuntimeResult:false` only when intentionally fire-and-polling. `hot_reload_wave_preview` mirrors the Wave Studio toolbar button and has no path argument: in multi-file VFS projects it reloads the currently open/active TypeScript file when safe, not every user-created .ts module. For a specific module, make that file active in Studio before calling the standalone hot-reload tool, or use the edit tool `awaitHotReload:true` immediately after the final edit. Main entries reload the main graph, source-root modules reload that root, and bootstrap/scene registry/assets/network/ambiguous helper surfaces escalate. Agents should organize feature-owned objects, callbacks, promoted/adopted parts, and appearance mutations into the file they expect to hot reload; use `waveStudio.exportEntity`/`waveStudio.importEntity` only when a live entity intentionally crosses module boundaries. Hot reload may internally choose `patchSource`, `patchMain`, `preserveScene`, or hard `rebuildScene`; agents should inspect returned `runtimeVerification` or poll diagnostics instead of manually guessing the tier. Poll `get_wave_runtime_diagnostics` only when `runtimeVerification` is absent, timed out, or ambiguous; require `editorErrorCount === 0`, then choose one relevant proof tool if needed: screenshot, runtime entity snapshot, markers, or performance snapshot."
 ].join("\n");
 
 // ../../src/lib/waveStudio/aiAssist/bridge/hosted/mcpResources/toolCatalog.ts

package/dist/sdk/README.md

@@ -3,6 +3,6 @@
 Bundled public-safe WaveEngine SDK lookup cache for wave3d-agent-sdk.
 Generated from sanitized public API/skill corpus during package build.
 
-cacheKey: 2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE
-bundleHash: X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE
-zip: wave-engine-sdk-2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE.zip
+cacheKey: 2026-06-24.4.TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt
+bundleHash: TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt
+zip: wave-engine-sdk-2026-06-24.4.TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt.zip

package/dist/sdk/manifest.json

@@ -1,21 +1,21 @@
 {
-  "version": "2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
-  "formatVersion": "2026-06-22.1",
-  "cacheKey": "2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
-  "bundleFileName": "wave-engine-sdk-2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE.zip",
-  "bundleHash": "X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
+  "version": "2026-06-24.4.TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt",
+  "formatVersion": "2026-06-24.4",
+  "cacheKey": "2026-06-24.4.TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt",
+  "bundleFileName": "wave-engine-sdk-2026-06-24.4.TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt.zip",
+  "bundleHash": "TfG1gvbOLSyom3MfrRMlDZCm3Rji9aGt",
   "generatedAt": "2026-06-06T00:00:00.000Z",
   "sourceVersions": {
     "onboarding": {
       "promptVersion": "2026-06-22.1",
-      "promptHash": "auIbrVF6qMlzkzY_hqUZcSic2zefX74_"
+      "promptHash": "E4XHCk4k3hMfpiXt08lgwPS-eGhFPAO5"
     },
     "apiHandbook": {
       "version": "1",
-      "contentHash": "84c2e6d2792f159c"
+      "contentHash": "dbf93ea87d2c3219"
     },
-    "waveSkillCorpusHash": "COqfxbebzaCbjainu_umCA4CRE47_fHt",
-    "sdkLookupCorpusHash": "jdg3gw4_rBQiSt-EHDrgCpT3b54hbA7y"
+    "waveSkillCorpusHash": "MzMqj1iHZduYT7888Dn-2GeklAp3LCp5",
+    "sdkLookupCorpusHash": "L0OTq_j_oYHTpZLJj10LkheltWHlRAtT"
   },
   "cacheContract": {
     "llmContextCacheOnly": [
@@ -35,15 +35,15 @@
       "searchDocuments"
     ],
     "rule": "Priority 1 always-on sections must stay in LLM chat/system context. The WaveEngine SDK local cache is public-safe retrieval data, never the only memory for core policy.",
-    "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.11 cache refresh",
+    "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.13 cache refresh",
     "refreshRule": "When using WaveEngine SDK local cache, compare cacheKey, bundleHash, and sourceVersions before trusting local lookup. If any value differs, update the SDK package or reinstall its bundled SDK cache and rebuild local indexes. Do not fetch a remote SDK zip.",
     "onlineFallback": "HTTP Gateway does not provide cloud API lookup. If local Node/npm or cache is refused/unavailable, use only concrete Studio operations and already-known code; repair the local WaveEngine SDK before unfamiliar API authoring."
   },
   "corpus": {
     "skillCount": 67,
-    "apiEntryCount": 4201,
-    "apiMethodGroupCount": 4483,
-    "apiInheritanceCount": 735
+    "apiEntryCount": 4213,
+    "apiMethodGroupCount": 4484,
+    "apiInheritanceCount": 737
   },
   "files": [
     {
@@ -51,14 +51,14 @@
       "mediaType": "application/json",
       "role": "lookup-guide",
       "bytes": 1311,
-      "hash": "9l-7lHnsaVNcHqKl3Y1i_OrYra869ijF"
+      "hash": "L0qhzeSHHbkMCpjcrhyTKMgFQkaiYnHQ"
     },
     {
       "path": "skills/wave-skills.jsonl",
       "mediaType": "application/jsonl",
       "role": "skill-corpus",
-      "bytes": 537625,
-      "hash": "BmIN7llcGe9jL3M7okesN7G7gzPmlbs_"
+      "bytes": 557391,
+      "hash": "pyZjnxdHIaDi-qU_rIYiZFuLVmm3HiNw"
     },
     {
       "path": "skills/foundations.jsonl",
@@ -71,43 +71,43 @@
       "path": "skills/families.json",
       "mediaType": "application/json",
       "role": "skill-corpus",
-      "bytes": 47269,
-      "hash": "zBdxYL9IvwI0GZ3UETEASd2FxcryfvYS"
+      "bytes": 48608,
+      "hash": "SK3ema2SjiiywXu4qS7F4xTICmVM5Qxs"
     },
     {
       "path": "api/entries.jsonl",
       "mediaType": "application/jsonl",
       "role": "api-corpus",
-      "bytes": 4170742,
-      "hash": "0xJxPVL6Bc4iDpNeR4rU8NEzyAP7NL42"
+      "bytes": 4189408,
+      "hash": "naVWkuJnhTuU7Jj8IEnmzjYww_mkITuH"
     },
     {
       "path": "api/method-groups.jsonl",
       "mediaType": "application/jsonl",
       "role": "api-corpus",
-      "bytes": 1400900,
-      "hash": "vC1zn6JbYLyjXj7T8u0JhXjidr6TCE5-"
+      "bytes": 1403019,
+      "hash": "EUzMqkNgQi1OBZaExr6AVkiM76ziJ_b1"
     },
     {
       "path": "api/inheritance.jsonl",
       "mediaType": "application/jsonl",
       "role": "api-corpus",
-      "bytes": 76701,
-      "hash": "0F5GYp7YBA41jrmjazV4BkYld7eAImnE"
+      "bytes": 76921,
+      "hash": "jpqGmCvDfkvtKH5ZqVpXxtoYCUiKIXeb"
     },
     {
       "path": "api/index-metadata.json",
       "mediaType": "application/json",
       "role": "api-corpus",
       "bytes": 219,
-      "hash": "SVmD8KOnyXtsKQOWwu_soG0Es3XaetTe"
+      "hash": "RXyWtU18gn0noeJ51_y5QB4-YQpWto4S"
     },
     {
       "path": "search/search-documents.jsonl",
       "mediaType": "application/jsonl",
       "role": "search-index",
-      "bytes": 3923196,
-      "hash": "5gQ98L5DJWgPxShey6YsUTQ9nQRRJPX8"
+      "bytes": 3946756,
+      "hash": "q3DhrkSRPPEb9VRKosy0Fg-fsZ4tXr9E"
     },
     {
       "path": "README.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave3d-agent-sdk",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "WaveEngine Agent SDK for same-machine Wave Studio MCP plus bundled WaveEngine lookup.",
   "type": "module",
   "license": "UNLICENSED",