wave3d-agent-sdk 0.2.0

package/dist/sdk/README.md

@@ -0,0 +1,8 @@
+# WaveEngine SDK
+
+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.kOFA72bP4l9iaGUE47CDlVZgrEJjicSL
+bundleHash: kOFA72bP4l9iaGUE47CDlVZgrEJjicSL
+zip: wave-engine-sdk-2026-06-17.1.kOFA72bP4l9iaGUE47CDlVZgrEJjicSL.zip

package/dist/sdk/manifest.json

@@ -0,0 +1,156 @@
+{
+  "version": "2026-06-17.1.kOFA72bP4l9iaGUE47CDlVZgrEJjicSL",
+  "formatVersion": "2026-06-17.1",
+  "cacheKey": "2026-06-17.1.kOFA72bP4l9iaGUE47CDlVZgrEJjicSL",
+  "bundleFileName": "wave-engine-sdk-2026-06-17.1.kOFA72bP4l9iaGUE47CDlVZgrEJjicSL.zip",
+  "bundleHash": "kOFA72bP4l9iaGUE47CDlVZgrEJjicSL",
+  "generatedAt": "2026-06-06T00:00:00.000Z",
+  "sourceVersions": {
+    "onboarding": {
+      "promptVersion": "2026-06-15.2",
+      "promptHash": "iIWFKdZER_2NWh_UfqQn36mKsaQWNpOb"
+    },
+    "apiHandbook": {
+      "version": "1",
+      "contentHash": "ff608d6d66055f42"
+    },
+    "waveSkillCorpusHash": "zYNMifq0Tf_Ck95E1rgKD7pb7o0EJDIO",
+    "sdkLookupCorpusHash": "e5QApdlmxvX1DDO_Vl8pCuFBw5KZnpya"
+  },
+  "cacheContract": {
+    "llmContextCacheOnly": [
+      "role",
+      "compactGuardrails",
+      "studioSkillMap",
+      "authoringWorkflow",
+      "assetVfsHotReloadRules",
+      "promptVersion",
+      "promptHash"
+    ],
+    "localFilesystemCache": [
+      "waveSkillCorpus",
+      "waveApiHandbook",
+      "apiMethodGroups",
+      "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.0 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-kOFA72bP4l9iaGUE47CDlVZgrEJjicSL\""
+  },
+  "corpus": {
+    "skillCount": 65,
+    "apiEntryCount": 5000,
+    "apiMethodGroupCount": 1143
+  },
+  "files": [
+    {
+      "path": "cache-policy.json",
+      "mediaType": "application/json",
+      "role": "lookup-guide",
+      "bytes": 1288,
+      "hash": "4JuQoToB8RNni5-NxkwxrUoiZbp7X-kW"
+    },
+    {
+      "path": "skills/wave-skills.jsonl",
+      "mediaType": "application/jsonl",
+      "role": "skill-corpus",
+      "bytes": 472843,
+      "hash": "BHx1prKm-ggF4ggk9ZUfKusRGPCmobPd"
+    },
+    {
+      "path": "skills/foundations.jsonl",
+      "mediaType": "application/jsonl",
+      "role": "skill-corpus",
+      "bytes": 1201,
+      "hash": "UnjIH7zq7QhqtHISqEASXzTsbclM_9xw"
+    },
+    {
+      "path": "skills/families.json",
+      "mediaType": "application/json",
+      "role": "skill-corpus",
+      "bytes": 44401,
+      "hash": "MlM0qqK1BMGUsOv5Zgf3YbjGiIfU4IjM"
+    },
+    {
+      "path": "api/entries.jsonl",
+      "mediaType": "application/jsonl",
+      "role": "api-corpus",
+      "bytes": 4526446,
+      "hash": "qOT8R4_becmncqN1sAZzCwo18n2OHgbe"
+    },
+    {
+      "path": "api/method-groups.jsonl",
+      "mediaType": "application/jsonl",
+      "role": "api-corpus",
+      "bytes": 291474,
+      "hash": "l9LZ0aztqPb3yy_6VQU21pgrzTr7G21Z"
+    },
+    {
+      "path": "api/index-metadata.json",
+      "mediaType": "application/json",
+      "role": "api-corpus",
+      "bytes": 192,
+      "hash": "3RotzIDkoahE_90Fi1JQjv8lZKr6rhwH"
+    },
+    {
+      "path": "search/search-documents.jsonl",
+      "mediaType": "application/jsonl",
+      "role": "search-index",
+      "bytes": 4039188,
+      "hash": "zIGmnONrO849VVRDhUW4wa4W-UgkRLzz"
+    },
+    {
+      "path": "README.md",
+      "mediaType": "text/markdown",
+      "role": "lookup-guide",
+      "bytes": 1390,
+      "hash": "T0KEqSE9rfzKNDpVTcP5J3pbhzXISyDp"
+    }
+  ],
+  "recommendedLocalIndexes": [
+    {
+      "name": "SQLite FTS5",
+      "whenAvailable": "Best default for local filesystem agents that can create a small database.",
+      "strategy": [
+        "Load search/search-documents.jsonl into a documents table with familyId/source filters.",
+        "Create FTS over title and text.",
+        "Always filter skill search by chosen family ids before ranking.",
+        "Keep api/entries.jsonl in a symbol table keyed by id/name/shortName/member names."
+      ]
+    },
+    {
+      "name": "IndexedDB plus MiniSearch/FlexSearch",
+      "whenAvailable": "Best default for browser-hosted agents.",
+      "strategy": [
+        "Store manifest and raw JSONL records in IndexedDB object stores.",
+        "Build a lexical index from search/search-documents.jsonl.",
+        "Filter skill search by selected family ids before ranking.",
+        "Use exact symbol lookup before full-text search."
+      ]
+    },
+    {
+      "name": "Filesystem plus rg",
+      "whenAvailable": "Fallback for terminal agents without database setup.",
+      "strategy": [
+        "Unzip into a versioned cache directory.",
+        "Use skills/families.json first to choose family ids.",
+        "Use rg for exact symbol, skill id, and lexical search inside family-filtered files.",
+        "If results are stale, update/restart wave3d-agent-sdk or reinstall its bundled SDK cache."
+      ]
+    }
+  ],
+  "queryOrder": [
+    "after onboarding, use the package-bundled SDK manifest/cacheKey from wave3d-agent-sdk",
+    "choose wave.* family ids from skills/families.json",
+    "query skills only inside selected family ids",
+    "exact skillId/symbol/member lookup",
+    "optional semantic embedding search inside selected families",
+    "repair by updating/restarting wave3d-agent-sdk if SDK cache is absent or stale"
+  ]
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "wave3d-agent-sdk",
+  "version": "0.2.0",
+  "description": "WaveEngine Agent SDK for same-machine Wave Studio MCP plus bundled WaveEngine lookup.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "bin": {
+    "wave3d-agent-sdk": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "jszip": "^3.10.1",
+    "minisearch": "^7.2.0"
+  },
+  "scripts": {
+    "build": "node ../../node_modules/esbuild/bin/esbuild src/cli.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/cli.js --banner:js=\"#!/usr/bin/env node\" --external:jszip --external:minisearch && node ../../scripts/build-agent-sdk.mjs && node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
+    "typecheck": "npx tsc -p tsconfig.json --noEmit --pretty false",
+    "prepack": "npm run build",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}