wave3d-agent-sdk 0.2.16 → 0.2.17

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.16";
-var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260627.2";
+var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.17";
+var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260627.3";
 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";
@@ -48260,7 +48260,7 @@ function buildHostedWaveStudioMcpToolDefinitions() {
     },
     {
       name: "recover_wave_connection",
-      description: "[studio.mcp] Direct Observe recovery tool. Call this after disconnect, timeout, command_timeout, command_lease_expired, session_not_found, agent_onboarding_required, workspace_mirror_not_ready, hosted_mcp_proxy_failed, local SDK confusion, or any unclear MCP state. It returns one explicit next action: re-onboard, call get_wave_session/list_wave_files, wake/reopen Wave Studio tab, update/restart WaveEngine Agent SDK, wait for VFS mirror, use HTTP Gateway fallback, retry command, or ask user for fresh Copy to Agent. No start_wave_task needed. If local HTTP returns 401 but HTTP Gateway accepts the same token, treat WaveEngine Agent SDK as stale/not adopted: update/restart SDK first. If every endpoint returns 401/bridge_auth_invalid before this tool can run, token is dead: ask user for fresh Copy to Agent.",
+      description: "[studio.mcp] Direct Observe recovery tool. Call this after disconnect, timeout, command_timeout, command_lease_expired, session_not_found, agent_onboarding_required, workspace_mirror_not_ready, hosted_mcp_proxy_failed, local SDK confusion, or any unclear MCP state. It returns one explicit next action: re-onboard, call get_wave_session/list_wave_files, keep/focus Wave Studio while it silently re-registers local tokens, update/restart WaveEngine Agent SDK, wait for VFS mirror, use HTTP Gateway fallback, retry command, or ask user for fresh Copy to Agent. No start_wave_task needed. If local HTTP returns 401 but HTTP Gateway accepts the same token, treat WaveEngine Agent SDK as stale/not adopted: update/restart SDK first. If every endpoint returns 401/bridge_auth_invalid before this tool can run, token is dead: ask user for fresh Copy to Agent.",
       inputSchema: {
         type: "object",
         properties: {
@@ -50459,7 +50459,7 @@ function localConnectionRecoveryResult(args, context) {
     steps.push("Do not ask user for new Copy to Agent unless local HTTP auth fails.");
   } else if (sessions.length === 0 || lastErrorCode === "session_not_found") {
     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. Ask user to wake/reopen Wave Studio, open Room -> MCP, and let it adopt this same local session secret; then call get_wave_session again.";
+    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;
     steps.push("Do not switch to SDK cache or query tools as a transport fix.");
@@ -50529,7 +50529,7 @@ function localConnectionRecoveryResult(args, context) {
     hardStopRules: [
       "Local HTTP refused/unreachable before MCP response: start WaveEngine Agent SDK, retry localhost for up to 10 seconds.",
       "Local HTTP 401/bridge_auth_invalid: if HTTP Gateway accepts the same MCP_TOKEN, SDK is stale/not adopted: run the exact token-preserving WaveEngine Agent SDK command so it adopts MCP_TOKEN as the local pairing secret, then retry local. If every endpoint rejects MCP_TOKEN, ask user for fresh Copy to Agent.",
-      "No paired session or stale command poll: wake/reopen Wave Studio tab; keep same local endpoint and MCP_TOKEN pairing secret first.",
+      "No paired session or stale command poll: keep Wave Studio tab open/focused and retry; Studio silently re-registers copied local tokens after SDK restart. Reopen/start MCP only if disabled or tab is gone.",
       "WaveEngine SDK Cache failure is not live transport failure."
     ]
   });
@@ -52921,7 +52921,8 @@ function readLocalSdkPeerHealth(value) {
     protocolVersion,
     buildHash: readStringProperty(data, "buildHash"),
     processId: readNumberProperty(data, "processId"),
-    tokenFingerprint: readStringProperty(data, "tokenFingerprint")
+    tokenFingerprint: readStringProperty(data, "tokenFingerprint"),
+    sessionCount: readNumberProperty(data, "sessionCount") ?? 0
   };
 }
 function parseProcessIds(output) {
@@ -53088,7 +53089,8 @@ function shouldReplaceCurrentSdkPeer(health, token) {
   if (!isCurrentSdkPeer(health)) return true;
   if (!token) return false;
   const expectedFingerprint = createWaveGenieBridgeTokenFingerprint(token);
-  return health.tokenFingerprint !== expectedFingerprint;
+  if (health.tokenFingerprint === expectedFingerprint) return false;
+  return (health.sessionCount ?? 0) === 0;
 }
 async function waitForSdkPeerExit(pids, deadlineMs) {
   const deadline = Date.now() + deadlineMs;
@@ -53157,7 +53159,7 @@ async function prepareLocalSdkPeerForStart(input) {
   }
   if (!shouldReplaceCurrentSdkPeer(probe.health, input.token)) {
     console.log(`[WaveEngine Agent SDK] Existing SDK on ${formatLoopbackHttpUrl(input.host, input.port, "")} is current; reusing it.`);
-    console.log("[WaveEngine Agent SDK] If a new Copy-to-Agent token fails later, restart with WAVE3D_MCP_TOKEN from that copy.");
+    console.log("[WaveEngine Agent SDK] If a copied token is not accepted yet, keep Wave Studio open; Studio will silently re-adopt it into this live SDK.");
     return true;
   }
   const reason = isCurrentSdkPeer(probe.health) ? "local pairing secret does not match this start request" : `stale version/build (${probe.health.packageVersion ?? "unknown"} ${probe.health.buildHash ?? "unknown"})`;

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.63mahXl1wJFsVypHTa3YZmbYXIrToIkG
-bundleHash: 63mahXl1wJFsVypHTa3YZmbYXIrToIkG
-zip: wave-engine-sdk-2026-06-24.4.63mahXl1wJFsVypHTa3YZmbYXIrToIkG.zip
+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

package/dist/sdk/manifest.json

@@ -1,21 +1,21 @@
 {
-  "version": "2026-06-24.4.63mahXl1wJFsVypHTa3YZmbYXIrToIkG",
+  "version": "2026-06-24.4.Caxh_cF-78aBZP6RFsiBS_gQxZlDGO0D",
   "formatVersion": "2026-06-24.4",
-  "cacheKey": "2026-06-24.4.63mahXl1wJFsVypHTa3YZmbYXIrToIkG",
-  "bundleFileName": "wave-engine-sdk-2026-06-24.4.63mahXl1wJFsVypHTa3YZmbYXIrToIkG.zip",
-  "bundleHash": "63mahXl1wJFsVypHTa3YZmbYXIrToIkG",
+  "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",
   "generatedAt": "2026-06-06T00:00:00.000Z",
   "sourceVersions": {
     "onboarding": {
       "promptVersion": "2026-06-22.1",
-      "promptHash": "jvKiC2UCRvVbpVc7IGen5RvQk3V9vRA-"
+      "promptHash": "0DLryCmrd1QIYP-32CEyNd5Heiev6_Lr"
     },
     "apiHandbook": {
       "version": "1",
       "contentHash": "58fdedcd747f52b9"
     },
     "waveSkillCorpusHash": "ol6UwQmeF1EZGOW3uz8NWVzESWOrkc7P",
-    "sdkLookupCorpusHash": "ZJvWnfNdCRcoLSwB6tz3ehkJzGGYeTVd"
+    "sdkLookupCorpusHash": "OFDTR_fo2zM-8iXgejSBgj0rQK12V5to"
   },
   "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.16 cache refresh",
+    "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.17 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": "YeAaiCkYLuKoMCDXE2XQneoonBtuzAjQ"
+      "hash": "FDpb8-vDxfyK6mu1ke6-auN2h64806k1"
     },
     {
       "path": "skills/wave-skills.jsonl",

package/package.json

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