wave3d-agent-sdk 0.2.1 → 0.2.3

package/README.md

@@ -19,13 +19,13 @@ Vocabulary:
 - Project: user workspace content. Reading a project is not opening/replacing live workspace.
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.0 start
+npx -y wave3d-agent-sdk@0.2.3 start
 ```
 
 Check SDK build before trusting a running SDK process:
 
 ```bash
-npx -y wave3d-agent-sdk@0.2.0 --version
+npx -y wave3d-agent-sdk@0.2.3 --version
 ```
 
 The package bundles the WaveEngine SDK lookup corpus. No normal session needs a separate protected zip download.
@@ -35,12 +35,12 @@ 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.0 start
+npx -y wave3d-agent-sdk@0.2.3 start
 ```
 
 Agents choose topology first:
 
-- Same computer as Wave Studio browser: try copied localhost `MCP_URL`, call `self_check_wave_mcp` with copied `expectedVersion` and `expectedBuildHash`, and restart exact SDK command from Copy to Agent if SDK is stale, missing tools, or prints bearer tokens before fallback.
+- Same computer as Wave Studio browser: try copied localhost `MCP_URL`, call `self_check_wave_mcp` with copied `expectedVersion` and `expectedBuildHash`, and restart exact SDK command from Copy to Agent if `self_check_wave_mcp` is missing, SDK is stale, tools are missing, or the SDK prints bearer tokens before fallback.
 - Different machine, remote container, cloud agent, sandbox without shell/Node/npm, or localhost points to agent machine instead of user browser machine: use `MCP_HTTP_GATEWAY_FALLBACK_URL` directly. Do not start WaveEngine Agent SDK on wrong machine.
 
 Call `get_wave_mcp_health` (aliases: `mcp_health`, `mcp_status`) whenever transport, SDK, or session status is unclear. It reports endpoint kind, SDK version/build, tool catalog hash/count, paired sessions, and WaveEngine SDK Cache state.
@@ -50,13 +50,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.0 cache search "continuous left rotation"
+npx -y wave3d-agent-sdk@0.2.3 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.0 cache refresh
+npx -y wave3d-agent-sdk@0.2.3 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

@@ -42533,8 +42533,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.1";
-var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260617.2";
+var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.3";
+var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260617.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_CACHE_REFRESH_COMMAND_TEMPLATE = `npx -y ${WAVE3D_AGENT_SDK_PACKAGE_SPEC} cache refresh`;

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-17.1.VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB
-bundleHash: VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB
-zip: wave-engine-sdk-2026-06-17.1.VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB.zip
+cacheKey: 2026-06-17.1.qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W
+bundleHash: qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W
+zip: wave-engine-sdk-2026-06-17.1.qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W.zip

package/dist/sdk/manifest.json

@@ -1,21 +1,21 @@
 {
-  "version": "2026-06-17.1.VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB",
+  "version": "2026-06-17.1.qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W",
   "formatVersion": "2026-06-17.1",
-  "cacheKey": "2026-06-17.1.VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB",
-  "bundleFileName": "wave-engine-sdk-2026-06-17.1.VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB.zip",
-  "bundleHash": "VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB",
+  "cacheKey": "2026-06-17.1.qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W",
+  "bundleFileName": "wave-engine-sdk-2026-06-17.1.qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W.zip",
+  "bundleHash": "qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W",
   "generatedAt": "2026-06-06T00:00:00.000Z",
   "sourceVersions": {
     "onboarding": {
       "promptVersion": "2026-06-15.2",
-      "promptHash": "L-TBWHOTLGyUlCBCpm0Z6Zgqfjtc5O0m"
+      "promptHash": "iK3pRMEOo0DHWhoh-mf2tMPA2Q6WFXIr"
     },
     "apiHandbook": {
       "version": "1",
       "contentHash": "ff608d6d66055f42"
     },
     "waveSkillCorpusHash": "zYNMifq0Tf_Ck95E1rgKD7pb7o0EJDIO",
-    "sdkLookupCorpusHash": "x8mDefCjMm5J7uQzZyFbK_xrFchN8RVy"
+    "sdkLookupCorpusHash": "FmrK-8n-nsi1iRbkQolqhXdQ4rFhiE5o"
   },
   "cacheContract": {
     "llmContextCacheOnly": [
@@ -34,14 +34,14 @@
       "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.1 cache refresh",
+    "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.3 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."
   },
   "download": {
     "sameOriginPath": "/api/waveStudio/bridge/mcp/corpus",
     "cacheBustingQuery": "",
-    "etag": "\"wave-engine-sdk-VgVSM-q0EypwJVocJkbDFNDSHZG2gkVB\""
+    "etag": "\"wave-engine-sdk-qWjJM6rOkct8YGTZNQGI1BLpjLQ56w7W\""
   },
   "corpus": {
     "skillCount": 65,
@@ -54,7 +54,7 @@
       "mediaType": "application/json",
       "role": "lookup-guide",
       "bytes": 1288,
-      "hash": "JGxyW9TrDAIy0aWTROTHBWVtMTMSdIJS"
+      "hash": "547CKidKl5HZAfrPg_R0-tO0MNNFf1Ew"
     },
     {
       "path": "skills/wave-skills.jsonl",

package/package.json

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