@blazium-games/skills 0.1.7 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazium-games/skills",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Agent skills for the Blazium Games platform.",
   "repository": "https://github.com/blazium-games/games_skill",
   "license": "MIT",

package/skills/blazium-games-analytics/SKILL.md

@@ -21,7 +21,7 @@ Summarize store page traffic for one game.
 ## 1. Fetch
 
 1. Resolve the game with `list_games` if the user did not give a `uid`.
-2. Call `get_game_analytics` with `uid` (or read `blazium-games://games/{uid}/analytics`).
+2. Call `get_game_analytics` with `uid` and, when the user names a build, `build` (or read `blazium-games://games/{uid}/analytics`).
 
 ## 2. Interpret
 
@@ -37,6 +37,7 @@ Summarize store page traffic for one game.
 | `downloads.by_source[]` | `website`, `asset_library` (Godot or Blazium editor), `api`, `mcp_player`, `mcp_dev` |
 | `downloads.by_access[]` | `anonymous`, `owner`, `free`, `purchase`, `grant`, `key`, `bundle` |
 | `downloads.by_outcome[]` | Every attempt, including refusals such as `sign_in_required` and `payment_required` |
+| `events[]` | Registered funnel events: `name`, `count`, `unique_devices`, and `daily`. This is not visitor or download analytics |
 
 Analytics are aggregate. Individual visitors are not identifiable through the MCP.
 

package/skills/blazium-games-crash-reporting/SKILL.md

@@ -98,16 +98,7 @@ Ask before adding them if the game has no privacy policy or the user needs playe
 
 ## 4. Custom events (optional)
 
-```http
-POST https://api.blazium.online/api/v1/public/events
-X-App-Id: <game uid>
-X-Build-Id: <build_id>
-Content-Type: application/json
-
-{ "events": [ { "event": "level_complete", "anonymous": true, "device_uid": "<random per install>" } ] }
-```
-
-Up to 100 events per request (more returns `4130`); the response is `202`. Use a random per-install id, not hardware identifiers.
+Register the name first with `set_funnels`. Then record it from the signed-in client, a game server key, or a scripted lobby. Unknown names are refused. See https://docs.blazium.games/docs/progress. The six standard events stay on the public route above.
 
 ## 5. Symbols
 

package/skills/blazium-games-deploy/SKILL.md

@@ -50,7 +50,7 @@ Tell the user to store them as CI secrets (for example GitHub Actions secrets `B
 chauffeur reads `BLAZIUM_ACCESS_TOKEN` and `BLAZIUM_SECRET_KEY` from the environment (or `--access` and `--secret-stdin`). `chauffeur info` confirms which game the key belongs to.
 
 1. Generate `build.yml` once: `chauffeur genbuild --version 1.0.0`
-2. Optionally add changelog entries: `chauffeur addchangelog --title "..." --description "..."`
+2. Optionally add changelog entries: `chauffeur addchangelog --title "..." --description "..."`. A new or changed changelog on a stable build emails the owner and accepted admins. The store page shows it, and a game pulls it from `GET /api/v1/games/{game_uid}/patch/notices` until the player acknowledges it.
 3. Register the build: `chauffeur build --asset build.yml --os windows --arch x86_64`. It prints `BLAZIUM_GAMES_APP_ID` and `BLAZIUM_GAMES_BUILD_ID`
 4. Generate `addfiles.yml`: `chauffeur setfiles --version 1.0.0 --os windows --arch x86_64 --files ./export/windows`
 5. Upload the files, and symbols if the user has them: `chauffeur addfiles --asset addfiles.yml --symbols ./symbols`

package/skills/blazium-games-get-started/SKILL.md

@@ -84,6 +84,7 @@ If OAuth is not possible (headless CI, remote agents), use an API key instead. S
 | Add crash reporting to a game | `blazium-games-crash-reporting` |
 | Investigate a crash | `blazium-games-debug-crash` |
 | Read visitor analytics | `blazium-games-analytics` |
+| Set achievements, stats, funnels, or presence writers | `get_achievements`, `set_achievements`, `get_stats`, `set_stats`, `get_funnels`, `set_funnels`, `get_presence_writers`, `set_presence_writers` ([tools](./references/tools.md)). A game reads unlocks and stats with `progress()` and sets a client status with `set_presence` when `client` is a writer. |
 | Rotate MCP or deploy keys | `blazium-games-keys` |
 | Moderate a game's chat channel (guests, bans, mutes) | `get_game_chat`, then `set_chat_guests`, `ban_chat_user`, or `suspend_chat_user` only when the human asks ([tools](./references/tools.md)) |
 | Find, review, or play games as a player, or get a chat token | `blazium-games-player` |

package/skills/blazium-games-lobby-pack/SKILL.md

@@ -6,3 +6,10 @@ description: Publish a Luau lobby pack with chauffeur and check it on the Script
 # Lobby packs
 
 `chauffeur lobby publish --dir <path>` packs `.lua` files, refuses any other script, and uploads through the uploader. `chauffeur lobby list` and `chauffeur lobby status` show the stored packs and the checksum the next lobby loads. The game editor Scripted lobby tab shows the same history. The page does not upload the pack.
+
+A seated pack can call these on `lobby`. The host performs them. The pack never sees the host token.
+
+- `unlock_achievement(user, slug)` and `set_stat(user, slug, value)` write progress when that definition lists `scripted_lobby`.
+- `record_event(user, name, fields)` stores one registered funnel event. Slug, event, and status strings that are too long are refused before the call. `fields` is at most 4 KiB.
+- `analytics(name)` reads count, unique devices, and the daily totals for one event that lists `scripted_lobby`. An optional build filter uses the same shape. It does not return visitor or download numbers.
+- `set_presence(user, status)` only notifies that player's lobby connection. The host signs the notice. The launcher applies it.