@forgeax/game 0.3.5 → 0.3.7

package/docs/asset3d.md

@@ -137,6 +137,14 @@ has its path, byte count, and digest in the ownership manifest.
 
 ## Transaction protocol
 
+For native Packs, first call `list_asset_candidates` with English queries and
+choose a suitable returned `assetId` by name and format. This does not download
+assets or call an auxiliary LLM. Keep the same query text in `asset3d begin`, then
+call `search_asset` with `queries: [{content: "<query>", assetId: "<selected ID>"}]`
+and `output_format: "asset"`. The Provider checks that the ID still belongs to the
+live query results; an invented or stale ID fails instead of selecting another
+asset. A GLB result does not prove native Pack support.
+
 1. `asset3d begin` records a private journal with a new execution UUID, query digest,
    provider identity, exact Engine identity, requested count, and the only allowed
    quarantine root.
@@ -154,7 +162,8 @@ has its path, byte count, and digest in the ownership manifest.
 6. A 30-second per-asset lock serializes publication at
    `assets/3d/ea-3d/<safeAssetId>`. The complete prior directory is preserved as the
    refresh/rollback snapshot.
-7. With the game root as `cwd`, Game Plugin runs the exact released Engine CLI:
+7. With the game root as `cwd`, Game Plugin runs the exact released Engine CLI.
+   For GLB imports:
 
    ```text
    asset add assets/3d/ea-3d/<safeAssetId> --reimport-policy semantic-only --json
@@ -166,6 +175,9 @@ has its path, byte count, and digest in the ownership manifest.
    Each command must produce exactly one newline-terminated, at-most-1-MiB
    `CommandEnvelope@1.0.0`. Game Plugin does not filter diagnostic stdout into a
    synthetic success.
+   Native Pack sources instead use the Engine build and verified build catalog;
+   the plugin preserves the complete source closure and reads cooked scene/mesh
+   GUIDs back. It does not run `asset add` on `.pack.ts` or `.pack.json`.
 8. Only after Engine readback succeeds does `.forgeax-asset.json` publish the provider
    commit, origin-set digest, exact Engine version/commit, per-file role/digest/bytes,
    Engine rows, and catalog readback. An Engine failure restores the whole previous

package/package.json

@@ -1,7 +1,7 @@
 {
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.0",
   "name": "@forgeax/game",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "private": false,
   "type": "module",
   "description": "@forgeax/game — an MCP/CLI connector for exact released ForgeaX Engine games and Engine-owned Preview.",