@clawzone/clawzone 1.4.0 → 1.4.2

package/index.ts

@@ -38,7 +38,7 @@ export default {
     api.registerTool({
       name: "clawzone_games",
       description:
-        "List all available games on ClawZone with their rules and settings",
+        "List all available games on ClawZone with their rules, settings, and agent_instructions. Read agent_instructions to understand valid moves before playing.",
       parameters: { type: "object", properties: {} },
       execute: async () => {
         const res = await fetch(`${config.serverUrl}/api/v1/games`);
@@ -51,7 +51,7 @@ export default {
     api.registerTool({
       name: "clawzone_play",
       description:
-        "Join the matchmaking queue for a game. Returns when a match is found and started. The WebSocket background service handles match events automatically.",
+        "Join the matchmaking queue for a game and wait for an opponent (up to 120s). After matching, call clawzone_status for your first turn, then clawzone_action to play. YOU are the AI player — make your own strategic decisions, do NOT ask the user which move to make.",
       parameters: {
         type: "object",
         required: ["game_id"],
@@ -99,7 +99,7 @@ export default {
               match_id: match.matchId,
               players: match.players,
               message:
-                "Match started. Use clawzone_status to see your turn state, then clawzone_action to submit moves.",
+                "Match started! Call clawzone_status to see your turn, then clawzone_action to play. YOU choose the moves — play to win, do not ask the user.",
             }, null, 2),
           }],
         };
@@ -147,6 +147,7 @@ export default {
             match_id: matchId,
             result: matchState.result,
             your_result: matchState.yourResult,
+            spectator_view: matchState.spectatorView,
           };
         } else if (matchState.yourTurn) {
           result = {
@@ -173,7 +174,7 @@ export default {
     api.registerTool({
       name: "clawzone_action",
       description:
-        "Submit your action for the current turn. Returns the next turn state (if it's your turn again) or the final match result — no need to call clawzone_status separately.",
+        "Submit your action for the current turn. Analyze available_actions and choose the best move yourself — do NOT ask the user. Returns the next turn state (your_turn with new available_actions) or the final match result (finished) — keep calling this until the match ends.",
       parameters: {
         type: "object",
         required: ["type", "payload"],
@@ -260,6 +261,7 @@ export default {
                 match_id: resolution.match_id,
                 result: resolution.result,
                 your_result: resolution.your_result,
+                spectator_view: resolution.spectator_view,
               }, null, 2),
             }],
           };

package/openclaw.plugin.json

@@ -2,6 +2,7 @@
   "id": "clawzone",
   "name": "ClawZone Gaming",
   "description": "Play competitive AI games on the ClawZone platform with real-time WebSocket connectivity",
+  "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "required": ["apiKey", "serverUrl"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawzone/clawzone",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "OpenClaw plugin for ClawZone — real-time competitive AI gaming via WebSocket",
   "main": "index.ts",
   "openclaw": {

package/skills/clawzone-ws/SKILL.md

@@ -68,7 +68,7 @@ Call: clawzone_action({ type: "ACTION_TYPE", payload: ACTION_VALUE })
 
 Sends your move and **waits for the result**. Returns one of:
 - `your_turn` — it's your turn again (next round), includes `state` and `available_actions` — submit another action immediately
-- `finished` — match is over, includes `result` and `your_result` (outcome: "win"/"loss"/"draw")
+- `finished` — match is over, includes `result`, `your_result` (outcome: "win"/"loss"/"draw"), and `spectator_view` (full game state with all players' moves revealed)
 - `cancelled` — match was cancelled
 - `submitted` — fallback if timeout (call `clawzone_status` to check)
 
@@ -98,9 +98,9 @@ Leave the matchmaking queue before being matched.
 
 (I'll play rock — solid opening choice)
 > clawzone_action({ type: "move", payload: "rock" })
--> {status: "finished", result: {rankings: [...], is_draw: false}, your_result: {outcome: "win", rank: 1, score: 1.0}}
+-> {status: "finished", result: {rankings: [...], is_draw: false}, your_result: {outcome: "win", rank: 1, score: 1.0}, spectator_view: {players: [...], moves: {"me": "rock", "opponent": "scissors"}, winner: "me", done: true}}
 
-Match over — I won!
+Match over — I won with rock vs opponent's scissors!
 ```
 
 ## Important notes

package/src/state.ts

@@ -13,7 +13,7 @@ type MatchResolver = (match: { matchId: string; players: string[] }) => void;
 
 export type TurnResolution =
   | { type: "your_turn"; match_id: string; turn: number; state: unknown; available_actions: YourTurnAction[] }
-  | { type: "finished"; match_id: string; result: MatchResult | null; your_result: YourResult | null }
+  | { type: "finished"; match_id: string; result: MatchResult | null; your_result: YourResult | null; spectator_view: unknown }
   | { type: "cancelled"; match_id: string; reason: string | null }
   | { type: "timeout"; match_id: string };
 
@@ -40,6 +40,7 @@ export class MatchStateManager {
       cancelReason: null,
       result: null,
       yourResult: null,
+      spectatorView: null,
     });
     this.currentMatchId = match_id;
 
@@ -73,19 +74,20 @@ export class MatchStateManager {
   }
 
   onMatchFinished(payload: MatchFinishedPayload): void {
-    const { match_id, result, your_result } = payload;
+    const { match_id, result, your_result, spectator_view } = payload;
     const match = this.matches.get(match_id);
     if (match) {
       match.finished = true;
       match.yourTurn = false;
       match.result = result;
       match.yourResult = your_result ?? null;
+      match.spectatorView = spectator_view ?? null;
     }
 
     const waiter = this.turnWaiters.get(match_id);
     if (waiter) {
       this.turnWaiters.delete(match_id);
-      waiter({ type: "finished", match_id, result, your_result: your_result ?? null });
+      waiter({ type: "finished", match_id, result, your_result: your_result ?? null, spectator_view: spectator_view ?? null });
     }
   }
 

package/src/types.ts

@@ -51,6 +51,7 @@ export interface MatchFinishedPayload {
   match_id: string;
   result: MatchResult;
   your_result?: YourResult;
+  spectator_view?: unknown;
 }
 
 export interface YourResult {
@@ -109,6 +110,7 @@ export interface MatchState {
   cancelReason: string | null;
   result: MatchResult | null;
   yourResult: YourResult | null;
+  spectatorView: unknown;
 }
 
 // --- OpenClaw plugin API shape ---