wave3d-agent-sdk 0.2.17 → 0.2.18

package/dist/cli.js

@@ -42532,8 +42532,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.17";
-var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260627.3";
+var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.18";
+var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260627.4";
 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";
@@ -44738,7 +44738,7 @@ var WAVE_MCP_TOOL_CATALOG_GUIDE = [
   '- `get_wave_mcp_health` (aliases `mcp_health`, `mcp_status`): read-only self diagnostic for endpoint kind, SDK version/build, tool catalog hash/count, onboarding, session/VFS, and WaveEngine SDK Cache state. Use when the agent asks "am I local/cloud/current/cached?" or any MCP state is unclear.',
   "- `get_wave_tool_map`: stable complete concrete MCP tool menu grouped by family plus policy flags. Use only when `tools/list` feels truncated or unclear.",
   `- Transport topology rule: same-machine agents should run \`${WAVE3D_AGENT_SDK_START_COMMAND}\`, check /health, and update/restart SDK if version is stale, tools are missing, or SDK prints secrets; after Copy-to-Agent, restart with \`${WAVE3D_AGENT_SDK_TOKEN_PRESERVING_START_COMMAND}\` using the current MCP_TOKEN value without printing it so the copied local pairing secret still works. Current SDK start self-heals localhost SDK peers: reuse current same-token, replace verified stale/different-token SDK, refuse non-SDK port owners. After restart recheck /health and tools/list. Same-machine stale/missing tools/401-with-Gateway-success means repair local SDK first, not HTTP Gateway first. Same-machine HTTP Gateway is degraded fallback only after SDK cannot run, update, or adopt; never use it because it is familiar, already authenticated, or avoids SDK repair. Different-machine/cloud/sandbox agents should use \`MCP_HTTP_GATEWAY_FALLBACK_URL\` directly. Stale SDK/cache are local setup issues, not fallback triggers; wrong-machine localhost is a topology mismatch.`,
-  "- `recover_wave_connection`: direct Observe recovery tool. Call after onboarding required, session missing, command timeout/lease expired, mirror not ready, hosted proxy/cache failure, local/HTTP Gateway confusion, or sleeping-tab symptoms. It returns exact next action: re-onboard, get session, wake tab, update/restart SDK, wait mirror, retry, use HTTP Gateway fallback, or ask fresh Copy to Agent.",
+  "- `recover_wave_connection`: direct Observe recovery tool. Call after onboarding required, session missing, command timeout/lease expired, mirror not ready, hosted proxy/cache failure, local/HTTP Gateway confusion, or sleeping-tab symptoms. It returns exact next action: re-onboard, get session, focus Studio tab, update/restart SDK, wait mirror, retry, use HTTP Gateway fallback, or ask fresh Copy to Agent.",
   '- WaveEngine SDK Cache: normal skill/API lookup lives inside the local `wave3d-agent-sdk` SDK package. Update/restart SDK when SDK is stale or missing. HTTP Gateway is Studio-ops-only and does not provide cloud skill/API lookup. If local SDK cannot work because sandbox/no filesystem/no Node/npm/user refusal/refresh failure, explicitly accept degraded fallback with `waveEngineSdkFallbackMode:"studio_ops_only"`, a valid `waveEngineSdkUnavailableReason`, and `studioOpsOnlyFallbackAccepted:true`; warn user skill/API lookup requires local SDK repair. This is retrieval cache, not WaveEngine Agent SDK transport. Never treat SDK cache failure as local transport failure. Keep Priority 1 role, guardrails, workflow, assets/VFS/hot-reload rules, prompt version, and prompt hash in active LLM context.',
   "- Work-mode rule: Observe reads directly; Operate direct Studio commands directly; Author/Diagnose routes through `start_wave_task`; General avoids Wave tools. Operate tools include run/hot reload, save/share, VFS create/rename/delete exact files, asset upload/rename/delete exact assets, new project, project rename, and open project by exact projectId.",
   "- `start_wave_task`: begin one Author/Diagnose route for code behavior/content changes, debugging, local SDK skill/API lookup, semantic/direct code edits, and multi-step investigations. Use `code.direct_edit` for exact power-user receiver/method/action commands; use `code.semantic_guess_edit` only when changing an existing API call/argument/literal/value already visible in code; use `code.author` for normal/uncertain authoring and any new code/API/pattern choice. If the user request is irrelevant/too broad, use `agent.general` and guide the user toward one concrete Wave milestone.",
@@ -44858,7 +44858,7 @@ var LOCAL_HOSTED_TOKEN_PREFIX = "wgbt.";
 var CORPUS_CACHE_DIR_ENV = "WAVE3D_AGENT_CACHE_DIR";
 var MAX_CORPUS_ZIP_BYTES = 50 * 1024 * 1024;
 var MAX_CORPUS_EXTRACTED_BYTES = 100 * 1024 * 1024;
-var LOCAL_SESSION_NOT_FOUND_MESSAGE = "WaveEngine Agent SDK HTTP is alive, but no Wave Studio browser tab is paired with this MCP_TOKEN local secret. Live Studio tools need the Wave Studio tab open with Room -> MCP started/adopted. Refresh/reopen Wave Studio or restart MCP in the tab, then retry this same local endpoint and pairing secret. Do not treat this as WaveEngine SDK Cache failure.";
+var LOCAL_SESSION_NOT_FOUND_MESSAGE = "WaveEngine Agent SDK HTTP is alive, but no Wave Studio browser tab is paired with this MCP_TOKEN local secret yet. Keep Wave Studio open/focused and retry this same localhost endpoint once; Studio silently re-registers copied local tokens after SDK restart. If it still has no paired tab, call recover_wave_connection before asking the user to reopen/start MCP. Do not treat this as WaveEngine SDK Cache failure.";
 var HOSTED_BROWSER_COMMAND_PENDING_NOTE = ' If this browser-backed command returns `status: "pending"` with `requestId`, poll `get_wave_command_result`; otherwise do not poll command results.';
 var LOCAL_BROWSER_COMMAND_PENDING_NOTE = " Local browser-backed commands wait for the Studio browser result directly on this transport.";
 
@@ -46536,8 +46536,8 @@ async function enqueueBrowserCommand(input) {
       {
         likelyCause: "WaveEngine Agent SDK HTTP is alive, but the Wave Studio browser tab is asleep, closed, not polling commands, or has not adopted this token.",
         recovery: [
-          "Wake/refresh the Wave Studio tab.",
-          "Open Room -> MCP and verify the session is live.",
+          "Focus or refresh the Wave Studio tab.",
+          "Verify the MCP orb/session is live in Wave Studio.",
           "If using same-machine local transport, keep WaveEngine Agent SDK running and retry the same MCP_URL/token.",
           "If the browser was hibernated for a long time, stop/start MCP in Studio and copy a fresh agent message."
         ]
@@ -50461,8 +50461,9 @@ function localConnectionRecoveryResult(args, context) {
     state = "no_paired_studio_tab";
     nextAction = "WaveEngine Agent SDK HTTP is alive, but no Wave Studio tab is paired with this MCP_TOKEN local secret yet. Keep Wave Studio open and focused briefly; Studio silently re-registers copied local tokens after SDK restart. Then call get_wave_session again. Ask user to reopen/start MCP only if the Studio tab is closed, sleeping, or MCP is disabled.";
     nextTool = "get_wave_session";
-    requiresUserAction = true;
+    requiresUserAction = false;
     steps.push("Do not switch to SDK cache or query tools as a transport fix.");
+    steps.push("Retry get_wave_session on the same localhost endpoint before asking user for action; silent re-registration may complete without visible UI work.");
   } else if (lastErrorCode === "command_timeout" || lastErrorCode === "command_lease_expired" || symptom.toLowerCase().includes("hang") || symptom.toLowerCase().includes("timeout") || !selectedSessionReady) {
     state = "browser_tab_not_polling";
     nextAction = "Wave Studio tab is paired but not actively polling commands, or browser-backed command timed out. Ask user to focus/wake the tab and verify MCP is live; retry the same tool once on the same local endpoint and MCP_TOKEN pairing secret.";
@@ -51113,7 +51114,7 @@ async function callReadTool(name, args, context) {
         taskRouteId: activeRoute.taskRouteId,
         phase: activeRoute.phase
       } : null,
-      nextAction: !onboardingAccepted ? "Call get_wave_agent_onboarding, accept_wave_agent_onboarding, tools/list, get_wave_session, then list_wave_files." : sessions.length === 0 ? "No paired Studio tab visible. Keep Wave Studio open, restart MCP in the tab if needed, then call recover_wave_connection." : waveEngineSdkCache.ready === false ? "Live Studio tools can still work. If unfamiliar authoring needs skill/API lookup, update/restart SDK or run the bundled SDK repair command; otherwise accept Studio-ops-only fallback." : "MCP looks healthy. Continue with get_wave_session/list_wave_files or the user task."
+      nextAction: !onboardingAccepted ? "Call get_wave_agent_onboarding, accept_wave_agent_onboarding, tools/list, get_wave_session, then list_wave_files." : sessions.length === 0 ? "No paired Studio tab visible yet. Keep Wave Studio open/focused and retry get_wave_session once; Studio silently re-registers copied local tokens after SDK restart. If still empty, call recover_wave_connection before asking user to reopen/start MCP." : waveEngineSdkCache.ready === false ? "Live Studio tools can still work. If unfamiliar authoring needs skill/API lookup, update/restart SDK or run the bundled SDK repair command; otherwise accept Studio-ops-only fallback." : "MCP looks healthy. Continue with get_wave_session/list_wave_files or the user task."
     });
   }
   if (name === "get_wave_tool_map") {

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-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D
-bundleHash: Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D
-zip: wave-engine-sdk-2026-06-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D.zip
+cacheKey: 2026-06-24.4.XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU
+bundleHash: XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU
+zip: wave-engine-sdk-2026-06-24.4.XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU.zip

package/dist/sdk/manifest.json

@@ -1,21 +1,21 @@
 {
-  "version": "2026-06-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D",
+  "version": "2026-06-24.4.XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU",
   "formatVersion": "2026-06-24.4",
-  "cacheKey": "2026-06-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D",
-  "bundleFileName": "wave-engine-sdk-2026-06-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D.zip",
-  "bundleHash": "Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D",
+  "cacheKey": "2026-06-24.4.XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU",
+  "bundleFileName": "wave-engine-sdk-2026-06-24.4.XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU.zip",
+  "bundleHash": "XzX9B1TKZxfBe83hiiEtaBe9NhBhsosU",
   "generatedAt": "2026-06-06T00:00:00.000Z",
   "sourceVersions": {
     "onboarding": {
       "promptVersion": "2026-06-22.1",
-      "promptHash": "0DLryCmrd1QIYP-32CEyNd5Heiev6_Lr"
+      "promptHash": "mjWFpEG4f9pRdka8SVaMIxQRrlQW4On5"
     },
     "apiHandbook": {
       "version": "1",
       "contentHash": "58fdedcd747f52b9"
     },
     "waveSkillCorpusHash": "ol6UwQmeF1EZGOW3uz8NWVzESWOrkc7P",
-    "sdkLookupCorpusHash": "OFDTR_fo2zM-8iXgejSBgj0rQK12V5to"
+    "sdkLookupCorpusHash": "HTDNf3sAzkonZ_y9F5FndOVOHf22tyRf"
   },
   "cacheContract": {
     "llmContextCacheOnly": [
@@ -35,7 +35,7 @@
       "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.17 cache refresh",
+    "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.18 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."
   },
@@ -51,7 +51,7 @@
       "mediaType": "application/json",
       "role": "lookup-guide",
       "bytes": 1311,
-      "hash": "FDpb8-vDxfyK6mu1ke6-auN2h64806k1"
+      "hash": "WAfMaXKRj0GfMFAgCUBcQ6gBqrcqD8TP"
     },
     {
       "path": "skills/wave-skills.jsonl",

package/package.json

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