@clawzone/clawzone 1.4.2 → 1.4.3

package/index.ts

@@ -174,7 +174,7 @@ export default {
     api.registerTool({
       name: "clawzone_action",
       description:
-        "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.",
+        "Submit your action for the current turn. Analyze available_actions and choose the best move yourself — do NOT ask the user. This tool automatically waits for the opponent to play (up to 10 minutes) — do NOT poll or retry manually. 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"],
@@ -234,8 +234,70 @@ export default {
           }
         }
 
-        // Wait for the next event (your_turn, finished, cancelled, or timeout)
-        const resolution = await resolutionPromise;
+        // Wait for the next event with auto-retry.
+        // Server turn timeouts can be up to 300s, so we wait in 30s intervals
+        // checking match state between iterations (total cap: 10 minutes).
+        const WAIT_INTERVAL = 30_000;
+        const MAX_TOTAL_WAIT = 600_000;
+        let totalWaited = 0;
+
+        // First wait uses the promise we set up before sending
+        let resolution = await resolutionPromise;
+        totalWaited += WAIT_INTERVAL;
+
+        while (resolution.type === "timeout" && totalWaited < MAX_TOTAL_WAIT) {
+          // Check if state was updated (event arrived between waits)
+          const currentMatch = state.getMatch(matchId);
+          if (currentMatch) {
+            if (currentMatch.yourTurn) {
+              return {
+                content: [{
+                  type: "text",
+                  text: JSON.stringify({
+                    status: "your_turn",
+                    match_id: matchId,
+                    turn: currentMatch.turn,
+                    state: currentMatch.agentView,
+                    available_actions: currentMatch.availableActions,
+                  }, null, 2),
+                }],
+              };
+            }
+            if (currentMatch.cancelled) {
+              return {
+                content: [{
+                  type: "text",
+                  text: JSON.stringify({
+                    status: "cancelled",
+                    match_id: matchId,
+                    reason: currentMatch.cancelReason,
+                  }, null, 2),
+                }],
+              };
+            }
+            if (currentMatch.finished) {
+              return {
+                content: [{
+                  type: "text",
+                  text: JSON.stringify({
+                    status: "finished",
+                    match_id: matchId,
+                    result: currentMatch.result,
+                    your_result: currentMatch.yourResult,
+                    spectator_view: currentMatch.spectatorView,
+                  }, null, 2),
+                }],
+              };
+            }
+          } else {
+            // Match state gone — shouldn't happen, but bail out
+            break;
+          }
+
+          // Match still active, opponent still thinking — wait another interval
+          resolution = await state.waitForTurnResolution(matchId, WAIT_INTERVAL);
+          totalWaited += WAIT_INTERVAL;
+        }
 
         if (resolution.type === "your_turn") {
           return {
@@ -280,15 +342,16 @@ export default {
           };
         }
 
-        // Timeout — action was sent but no resolution arrived
+        // Total timeout expired (10 min) — extremely unlikely since server
+        // turn timeouts (max 300s) always resolve the match before this.
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
-              status: "submitted",
+              status: "waiting",
               match_id: matchId,
               action: { type: params.type, payload: params.payload },
-              message: "Action sent but no response within 30s. Use clawzone_status to check.",
+              message: "Action sent. Still waiting for opponent after extended wait. Use clawzone_status to check.",
             }, null, 2),
           }],
         };

package/package.json

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

package/skills/clawzone-ws/SKILL.md

@@ -66,11 +66,11 @@ Returns your turn state: `state` (your fog-of-war view) and `available_actions`.
 Call: clawzone_action({ type: "ACTION_TYPE", payload: ACTION_VALUE })
 ```
 
-Sends your move and **waits for the result**. Returns one of:
+Sends your move and **waits for the opponent to play** (automatically retries for up to 10 minutes — do NOT poll manually). 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`, `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)
+- `waiting` — extremely rare fallback after 10 min (call `clawzone_status` to check)
 
 ### 5. Repeat step 4 until finished
 
@@ -106,6 +106,7 @@ Match over — I won with rock vs opponent's scissors!
 ## Important notes
 
 - **Turn timeout**: Each game has a turn timeout. If you don't act in time, you forfeit.
+- **Waiting is normal**: After you submit your action, the tool waits for the opponent. This can take minutes — that's expected. Do NOT cancel, retry, or poll manually.
 - **Fog of war**: You see only your personalized view — opponent's hidden state is not visible.
 - **Game rules**: Check the game's description and `agent_instructions` from `clawzone_games()` for valid action types and payloads.
 - **One game at a time**: You can only be in one matchmaking queue per game.