wave3d-agent-sdk 0.2.10 → 0.2.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -21,19 +21,19 @@ Vocabulary:
21
21
  - Project: user workspace content. Reading a project is not opening/replacing live workspace.
22
22
 
23
23
  ```bash
24
- npx -y wave3d-agent-sdk@0.2.10 start
24
+ npx -y wave3d-agent-sdk@0.2.11 start
25
25
  ```
26
26
 
27
27
  After Copy to Agent, run the exact start command with MCP_TOKEN preserved as the local pairing secret. Keep it hidden:
28
28
 
29
29
  ```bash
30
- WAVE3D_MCP_TOKEN="$MCP_TOKEN" npx -y wave3d-agent-sdk@0.2.10 start
30
+ WAVE3D_MCP_TOKEN="$MCP_TOKEN" npx -y wave3d-agent-sdk@0.2.11 start
31
31
  ```
32
32
 
33
33
  Check SDK build before trusting a running SDK process:
34
34
 
35
35
  ```bash
36
- npx -y wave3d-agent-sdk@0.2.10 --version
36
+ npx -y wave3d-agent-sdk@0.2.11 --version
37
37
  ```
38
38
 
39
39
  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
43
43
  Wave Studio Copy to Agent defaults same-machine live MCP transport to this SDK:
44
44
 
45
45
  ```bash
46
- npx -y wave3d-agent-sdk@0.2.10 start
46
+ npx -y wave3d-agent-sdk@0.2.11 start
47
47
  ```
48
48
 
49
49
  Agents choose topology first:
@@ -58,18 +58,18 @@ Use `MCP_HTTP_GATEWAY_FALLBACK_URL` only for topology mismatch, remote/sandboxed
58
58
  For unfamiliar authoring, use the local SDK tools:
59
59
 
60
60
  ```bash
61
- npx -y wave3d-agent-sdk@0.2.10 cache search "continuous left rotation"
61
+ npx -y wave3d-agent-sdk@0.2.11 cache search "continuous left rotation"
62
62
  ```
63
63
 
64
64
  `cache refresh` without MCP arguments reinstalls the bundled SDK into `~/.wave3d/agent-cache`:
65
65
 
66
66
  ```bash
67
- npx -y wave3d-agent-sdk@0.2.10 cache refresh
67
+ npx -y wave3d-agent-sdk@0.2.11 cache refresh
68
68
  ```
69
69
 
70
70
  Old `cache refresh --mcp-url <url> --token <token>` arguments are ignored. Normal users update the npm package; no separate zip download exists.
71
71
 
72
- Wave Studio MCP uses an Agent Behavior Harness. Assessment tools stay open so agents can inspect session/files/assets/skills/diagnostics when needed, but clear user requests should start a route early with `start_wave_task`. Exact API lookup and mutating tools require `start_wave_task`, a `taskRouteId`, and `advance_wave_task` when moving into lookup, execute, or verify phases. For exact power-user commands, classify `code.direct_edit`; for obvious current-code pattern changes, classify `code.semantic_guess_edit`. These fast lanes skip broad skill/API lookup, not taskRouteId, deterministic edits, hot reload, or verification.
72
+ Wave Studio MCP uses a MECE Agent Behavior Harness. Observe reads run directly: session, files, assets, diagnostics, screenshots, performance, entity snapshots, and markers. Operate commands run directly when the user asks for an exact Studio action: run preview, hot reload, save/share/open/new project, rename/delete exact projects/files/assets, upload assets, and create/delete exact VFS files. Author and Diagnose code work use `start_wave_task`; `query_wave_api`, `edit_wave_file`, `apply_wave_patch`, and semantic/direct code edits stay route-bound. For exact power-user code commands, classify `code.direct_edit`; for visible current-code argument/literal/value changes, classify `code.semantic_guess_edit`. These fast lanes skip broad lookup, not file safety, hot reload, or verification.
73
73
 
74
74
  ## Commands
75
75
 
package/dist/cli.js CHANGED
@@ -42488,8 +42488,8 @@ function normalizeWaveGenieAssetUploadRequest(request) {
42488
42488
 
42489
42489
  // ../../src/lib/waveStudio/aiAssist/bridge/localAgentSdkContract.ts
42490
42490
  var WAVE3D_AGENT_SDK_PACKAGE_NAME = "wave3d-agent-sdk";
42491
- var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.10";
42492
- var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260621.1";
42491
+ var WAVE3D_AGENT_SDK_REQUIRED_VERSION = "0.2.11";
42492
+ var WAVE3D_AGENT_SDK_REQUIRED_BUILD = "agent-sdk-20260622.1";
42493
42493
  var WAVE3D_AGENT_SDK_PACKAGE_SPEC = `${WAVE3D_AGENT_SDK_PACKAGE_NAME}@${WAVE3D_AGENT_SDK_REQUIRED_VERSION}`;
42494
42494
  var WAVE3D_AGENT_SDK_START_COMMAND = `npx -y ${WAVE3D_AGENT_SDK_PACKAGE_SPEC} start`;
42495
42495
  var WAVE3D_AGENT_SDK_TOKEN_ENV_VAR = "WAVE3D_MCP_TOKEN";
@@ -44808,8 +44808,8 @@ var HOSTED_BROWSER_COMMAND_PENDING_NOTE = ' If this browser-backed command retur
44808
44808
  var LOCAL_BROWSER_COMMAND_PENDING_NOTE = " Local browser-backed commands wait for the Studio browser result directly on this transport.";
44809
44809
 
44810
44810
  // ../../scripts/wavegenie-sdk/mcp/onboarding.ts
44811
- var LOCAL_MCP_AGENT_ONBOARDING_VERSION = "local-2026-06-15.4";
44812
- var LOCAL_MCP_AGENT_ONBOARDING_PROMPT_HASH = "local_mcp_onboarding_20260615_4";
44811
+ var LOCAL_MCP_AGENT_ONBOARDING_VERSION = "local-2026-06-22.1";
44812
+ var LOCAL_MCP_AGENT_ONBOARDING_PROMPT_HASH = "local_mcp_onboarding_20260622_1";
44813
44813
  var LOCAL_MCP_AGENT_READY_SUMMARY = {
44814
44814
  role: "You are the Wave Studio authoring agent for this live browser session. Treat onboarding as system-prompt-like rules until session ends.",
44815
44815
  mustKeepInActiveContext: [
@@ -3,6 +3,6 @@
3
3
  Bundled public-safe WaveEngine SDK lookup cache for wave3d-agent-sdk.
4
4
  Generated from sanitized public API/skill corpus during package build.
5
5
 
6
- cacheKey: 2026-06-17.1.fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf
7
- bundleHash: fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf
8
- zip: wave-engine-sdk-2026-06-17.1.fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf.zip
6
+ cacheKey: 2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE
7
+ bundleHash: X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE
8
+ zip: wave-engine-sdk-2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE.zip
@@ -1,21 +1,21 @@
1
1
  {
2
- "version": "2026-06-17.1.fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf",
3
- "formatVersion": "2026-06-17.1",
4
- "cacheKey": "2026-06-17.1.fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf",
5
- "bundleFileName": "wave-engine-sdk-2026-06-17.1.fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf.zip",
6
- "bundleHash": "fz3T9rwUI7jgxk1aZBl-4dloSaAXWjEf",
2
+ "version": "2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
3
+ "formatVersion": "2026-06-22.1",
4
+ "cacheKey": "2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
5
+ "bundleFileName": "wave-engine-sdk-2026-06-22.1.X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE.zip",
6
+ "bundleHash": "X6HpjYvUWi7f4c6r-zxQKnKkNT9dyiYE",
7
7
  "generatedAt": "2026-06-06T00:00:00.000Z",
8
8
  "sourceVersions": {
9
9
  "onboarding": {
10
- "promptVersion": "2026-06-15.2",
11
- "promptHash": "XmQbudg8ys8LmiXVENo3zVyngwfWfTD7"
10
+ "promptVersion": "2026-06-22.1",
11
+ "promptHash": "auIbrVF6qMlzkzY_hqUZcSic2zefX74_"
12
12
  },
13
13
  "apiHandbook": {
14
14
  "version": "1",
15
- "contentHash": "edf117cbd2b09857"
15
+ "contentHash": "84c2e6d2792f159c"
16
16
  },
17
- "waveSkillCorpusHash": "nhg-WfsotIdN1pRO41g97bff6RrKujrN",
18
- "sdkLookupCorpusHash": "cIY-jnbSR_-b2nlQgJwVDT7ffQyZ372l"
17
+ "waveSkillCorpusHash": "COqfxbebzaCbjainu_umCA4CRE47_fHt",
18
+ "sdkLookupCorpusHash": "jdg3gw4_rBQiSt-EHDrgCpT3b54hbA7y"
19
19
  },
20
20
  "cacheContract": {
21
21
  "llmContextCacheOnly": [
@@ -35,14 +35,14 @@
35
35
  "searchDocuments"
36
36
  ],
37
37
  "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.",
38
- "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.10 cache refresh",
38
+ "defaultRefreshCommand": "npx -y wave3d-agent-sdk@0.2.11 cache refresh",
39
39
  "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.",
40
40
  "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."
41
41
  },
42
42
  "corpus": {
43
43
  "skillCount": 67,
44
44
  "apiEntryCount": 4201,
45
- "apiMethodGroupCount": 4480,
45
+ "apiMethodGroupCount": 4483,
46
46
  "apiInheritanceCount": 735
47
47
  },
48
48
  "files": [
@@ -51,14 +51,14 @@
51
51
  "mediaType": "application/json",
52
52
  "role": "lookup-guide",
53
53
  "bytes": 1311,
54
- "hash": "cKZ5cpwWvIcymqtgXmCcrFyPK5pMUCKm"
54
+ "hash": "9l-7lHnsaVNcHqKl3Y1i_OrYra869ijF"
55
55
  },
56
56
  {
57
57
  "path": "skills/wave-skills.jsonl",
58
58
  "mediaType": "application/jsonl",
59
59
  "role": "skill-corpus",
60
- "bytes": 524460,
61
- "hash": "qG_b5qdpaGGiG_hiORYyQUzGkDHnZcpz"
60
+ "bytes": 537625,
61
+ "hash": "BmIN7llcGe9jL3M7okesN7G7gzPmlbs_"
62
62
  },
63
63
  {
64
64
  "path": "skills/foundations.jsonl",
@@ -71,22 +71,22 @@
71
71
  "path": "skills/families.json",
72
72
  "mediaType": "application/json",
73
73
  "role": "skill-corpus",
74
- "bytes": 46886,
75
- "hash": "LUhQ4144N2QMoxkKBPabXJHYCmi4wqhs"
74
+ "bytes": 47269,
75
+ "hash": "zBdxYL9IvwI0GZ3UETEASd2FxcryfvYS"
76
76
  },
77
77
  {
78
78
  "path": "api/entries.jsonl",
79
79
  "mediaType": "application/jsonl",
80
80
  "role": "api-corpus",
81
- "bytes": 4169568,
82
- "hash": "jyGCEHeyJe5VSmLHEBzGc-ehK02T4Im_"
81
+ "bytes": 4170742,
82
+ "hash": "0xJxPVL6Bc4iDpNeR4rU8NEzyAP7NL42"
83
83
  },
84
84
  {
85
85
  "path": "api/method-groups.jsonl",
86
86
  "mediaType": "application/jsonl",
87
87
  "role": "api-corpus",
88
- "bytes": 1400372,
89
- "hash": "ddN0Bqv0ue3BIPuzp4fh3zBtTlUzSfjJ"
88
+ "bytes": 1400900,
89
+ "hash": "vC1zn6JbYLyjXj7T8u0JhXjidr6TCE5-"
90
90
  },
91
91
  {
92
92
  "path": "api/inheritance.jsonl",
@@ -100,14 +100,14 @@
100
100
  "mediaType": "application/json",
101
101
  "role": "api-corpus",
102
102
  "bytes": 219,
103
- "hash": "63XcQbDuL3ZswbTi4kAzD_Jt04FXIONX"
103
+ "hash": "SVmD8KOnyXtsKQOWwu_soG0Es3XaetTe"
104
104
  },
105
105
  {
106
106
  "path": "search/search-documents.jsonl",
107
107
  "mediaType": "application/jsonl",
108
108
  "role": "search-index",
109
- "bytes": 3917846,
110
- "hash": "AnlOOjUCNs-BOUdLrYzW5ugcAEnTA7JF"
109
+ "bytes": 3923196,
110
+ "hash": "5gQ98L5DJWgPxShey6YsUTQ9nQRRJPX8"
111
111
  },
112
112
  {
113
113
  "path": "README.md",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wave3d-agent-sdk",
3
- "version": "0.2.10",
3
+ "version": "0.2.11",
4
4
  "description": "WaveEngine Agent SDK for same-machine Wave Studio MCP plus bundled WaveEngine lookup.",
5
5
  "type": "module",
6
6
  "license": "UNLICENSED",