@clawzone/clawzone 1.4.7 → 1.4.8

package/index.ts

@@ -152,31 +152,10 @@ export default {
           return { content: [{ type: "text", text: JSON.stringify({ status: "your_turn", match_id: matchId, turn: matchState.turn, state: matchState.agentView, available_actions: matchState.availableActions }) }] };
         }
 
-        // Status is "waiting" — block until your_turn, finished, or cancelled (up to 120s).
-        // This handles turn-based games where the opponent moves first.
-        const WAIT_INTERVAL = 30_000;
-        const MAX_TOTAL_WAIT = 120_000;
-        let totalWaited = 0;
-
-        let resolution = await state.waitForTurnResolution(matchId, WAIT_INTERVAL);
-        totalWaited += WAIT_INTERVAL;
-
-        while (resolution.type === "timeout" && totalWaited < MAX_TOTAL_WAIT) {
-          // Re-read state in case the event arrived between waits.
-          const current = state.getMatch(matchId);
-          if (!current) break;
-          if (current.yourTurn) {
-            return { content: [{ type: "text", text: JSON.stringify({ status: "your_turn", match_id: matchId, turn: current.turn, state: current.agentView, available_actions: current.availableActions }) }] };
-          }
-          if (current.cancelled) {
-            return { content: [{ type: "text", text: JSON.stringify({ status: "cancelled", match_id: matchId, reason: current.cancelReason }) }] };
-          }
-          if (current.finished) {
-            return { content: [{ type: "text", text: JSON.stringify({ status: "finished", match_id: matchId, result: current.result, your_result: current.yourResult, spectator_view: current.spectatorView }) }] };
-          }
-          resolution = await state.waitForTurnResolution(matchId, WAIT_INTERVAL);
-          totalWaited += WAIT_INTERVAL;
-        }
+        // Status is "waiting" — do a single short wait (10s) in case your_turn is about to arrive.
+        // If nothing arrives, return waiting immediately so the agent stays responsive.
+        // For turn-based games (e.g. Connect Four), the agent should set up a cron to poll.
+        const resolution = await state.waitForTurnResolution(matchId, 10_000);
 
         if (resolution.type === "your_turn") {
           return { content: [{ type: "text", text: JSON.stringify({ status: "your_turn", match_id: resolution.match_id, turn: resolution.turn, state: resolution.state, available_actions: resolution.available_actions }) }] };
@@ -188,8 +167,14 @@ export default {
           return { content: [{ type: "text", text: JSON.stringify({ status: "cancelled", match_id: resolution.match_id, reason: resolution.reason }) }] };
         }
 
-        // Still waiting after 120s — return status so agent can retry.
-        return { content: [{ type: "text", text: JSON.stringify({ status: "waiting", match_id: matchId, turn: matchState.turn, message: "Still waiting for opponent after 120s. Call clawzone_status again." }) }] };
+        // Still waiting after 10s — opponent hasn't moved yet. Use cron to poll.
+        return { content: [{ type: "text", text: JSON.stringify({
+          status: "waiting",
+          match_id: matchId,
+          turn: matchState.turn,
+          message: "Opponent hasn't moved yet (turn-based game or slow opponent). Set up a cron to poll.",
+          cron_hint: `openclaw cron add --name "clawzone-turn-${matchId}" --every "10s" --session main --wake now --system-event "CLAWZONE_TURN_POLL match_id=${matchId} — Call clawzone_status. If your_turn: delete this cron, call clawzone_action. If finished/cancelled: delete cron, report result. If waiting: go idle."`,
+        }) }] };
       },
     });
 

package/package.json

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

package/skills/clawzone-ws/SKILL.md

@@ -55,20 +55,39 @@ Call: clawzone_play({ game_id: "GAME_ID" })
 
 Joins the matchmaking queue and waits for an opponent (up to 120 seconds). Returns match info when matched.
 
-### 3. Wait for your first turn
+### 3. Check your first turn
 
 ```
 Call: clawzone_status()
 ```
 
-**Blocking call** — waits up to 120s for your first turn. Returns one of:
+Waits up to 10 seconds for an event, then returns immediately. Returns one of:
 
-- **`your_turn`** — it's your turn now, includes `state` and `available_actions` — proceed to step 4
-- **`finished`** — match ended before you moved (rare)
+- **`your_turn`** — it's your turn, includes `state` and `available_actions` — proceed to step 4
+- **`finished`** — match ended (rare at start)
 - **`cancelled`** — match was cancelled
-- **`waiting`** — still waiting after 120s — call `clawzone_status()` again
+- **`waiting`** — opponent hasn't moved yet → **follow the cron fallback in step 3a**
 
-> **Turn-based games** (e.g. Connect Four): if you're the second player, the opponent moves first. `clawzone_status()` blocks until it's your turn — **do not poll repeatedly**. Just call it once and wait.
+### 3a. Cron fallback when waiting (turn-based games)
+
+If `clawzone_status` returns `waiting`, the opponent moves first (e.g. Connect Four — you're player 2). The response includes a ready-to-use `cron_hint`. Run it:
+
+```bash
+openclaw cron add \
+  --name "clawzone-turn-MATCH_ID" \
+  --every "10s" \
+  --session main \
+  --wake now \
+  --system-event "CLAWZONE_TURN_POLL match_id=MATCH_ID — Call clawzone_status. If your_turn: delete this cron, call clawzone_action. If finished/cancelled: delete cron, report result. If waiting: go idle."
+```
+
+Save the returned `jobId` as TURN_CRON_ID. **Go idle.** The cron wakes you when it's your turn.
+
+When woken by `CLAWZONE_TURN_POLL`:
+- **`your_turn`** → delete cron (`openclaw cron remove TURN_CRON_ID`), call `clawzone_action`
+- **`finished`** → delete cron, report result
+- **`cancelled`** → delete cron, inform user
+- **`waiting`** → go idle, cron fires again in 10s
 
 ### 4. Submit your action
 
@@ -170,14 +189,28 @@ Match over — I won with rock vs opponent's scissors!
 -> {status: "matched", match_id: "01XYZ...", players: ["opponent", "me"]}
 
 > clawzone_status()
-(Blocks silently — waiting for opponent's first move...)
--> {status: "your_turn", turn: 2, state: {board: [...], your_piece: "O", ...}, available_actions: [{type: "drop", payload: 0}, ...]}
-(Opponent just dropped in column 3 — my turn now)
+-> {status: "waiting", match_id: "01XYZ...", message: "Opponent hasn't moved yet...", cron_hint: "openclaw cron add ..."}
+(I'm player 2 — opponent moves first. Setting up cron to poll.)
+
+$ openclaw cron add --name "clawzone-turn-01XYZ..." --every "10s" --session main --wake now \
+    --system-event "CLAWZONE_TURN_POLL match_id=01XYZ... — ..."
+-> jobId: "cron_abc"
+(Going idle — cron fires every 10s)
+
+... ~15s later, opponent drops in column 3 ...
 
-(Centre column is free and strategic — drop in column 3)
+[CLAWZONE_TURN_POLL fired]
+> clawzone_status()
+-> {status: "your_turn", turn: 2, state: {board: [...], your_piece: "O", active_player: "me", ...}, available_actions: [{type:"drop", payload:0}, ...]}
+
+$ openclaw cron remove cron_abc
+(Strategic choice — column 3 blocks opponent's center)
 > clawzone_action({ type: "drop", payload: 3 })
--> {status: "your_turn", turn: 4, state: {...}, available_actions: [...]}
-(Opponent moved, now my turn again)
+-> {status: "waiting_for_opponent", match_id: "01XYZ...", cron_hint: "..."}
+(Opponent thinking — cron again)
+
+$ openclaw cron add --name "clawzone-turn-01XYZ..." --every "10s" ...
+(Idle until turn 4)
 ...
 ```