@clawzone/clawzone 1.4.10 → 1.4.12

package/index.ts

@@ -152,10 +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" — do a single short wait (10s) in case your_turn is about to arrive.
+        // Status is "waiting" — do a single short wait (5s) 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);
+        const resolution = await state.waitForTurnResolution(matchId, 5_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 }) }] };
@@ -168,12 +168,14 @@ export default {
         }
 
         // Still waiting after 10s — opponent hasn't moved yet. Use cron to poll.
+        // Include match context so the agent can build an enriched cron summary.
         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."`,
+          state: matchState.agentView,
+          message: "Opponent hasn't moved yet. Before creating the cron, write a brief summary of the match state and your strategy. Replace {AGENT_SUMMARY} in cron_hint with your summary.",
+          cron_hint: `openclaw cron add --name "clawzone-turn-${matchId}" --every "5s" --session main --wake now --system-event "CLAWZONE_TURN_POLL match_id=${matchId}\n\n## Match Context\n{AGENT_SUMMARY}\n\n## Instructions\nCall clawzone_status(). If your_turn: delete this cron (openclaw cron remove JOB_ID), play your move with clawzone_action. If finished/cancelled: delete cron, report result. If waiting: go idle."`,
         }) }] };
       },
     });
@@ -218,7 +220,7 @@ export default {
         }
 
         // Start waiting BEFORE sending so we don't miss fast responses
-        const resolutionPromise = state.waitForTurnResolution(matchId, 30_000);
+        const resolutionPromise = state.waitForTurnResolution(matchId, 15_000);
 
         // Send via WebSocket for lowest latency
         if (wsClient?.isConnected()) {
@@ -250,10 +252,10 @@ export default {
           }
         }
 
-        // Hybrid wait: try WebSocket for 60s (fast path), then bail to cron.
-        // Two 30s intervals with a race-condition check between them.
-        const WAIT_INTERVAL = 30_000;
-        const MAX_TOTAL_WAIT = 60_000;
+        // Hybrid wait: try WebSocket for 30s (fast path), then bail to cron.
+        // Two 15s intervals with a race-condition check between them.
+        const WAIT_INTERVAL = 15_000;
+        const MAX_TOTAL_WAIT = 30_000;
         let totalWaited = 0;
 
         // First wait uses the promise we set up before sending
@@ -356,14 +358,19 @@ export default {
           };
         }
 
-        // Opponent didn't respond within 60s — instruct agent to set up cron polling.
+        // Opponent didn't respond within 30s — instruct agent to set up cron polling.
+        // Return current state so the agent can write a summary for the cron.
+        const currentMatchForCron = state.getMatch(matchId);
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
               status: "waiting_for_opponent",
               match_id: matchId,
-              cron_hint: `openclaw cron add --name "clawzone-turn-${matchId}" --every "15s" --session main --wake now --system-event "CLAWZONE_TURN_POLL match_id=${matchId}"`,
+              turn: currentMatchForCron?.turn,
+              state: currentMatchForCron?.agentView,
+              message: "Opponent is slow. Before creating the cron, write a brief summary: what game, what turn, board/match state, and your strategy for the next move. Replace {AGENT_SUMMARY} in cron_hint.",
+              cron_hint: `openclaw cron add --name "clawzone-turn-${matchId}" --every "5s" --session main --wake now --system-event "CLAWZONE_TURN_POLL match_id=${matchId}\n\n## Match Context\n{AGENT_SUMMARY}\n\n## Instructions\nCall clawzone_status(). If your_turn: delete this cron (openclaw cron remove JOB_ID), play your move with 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.10",
+  "version": "1.4.12",
   "description": "OpenClaw plugin for ClawZone — real-time competitive AI gaming via WebSocket",
   "main": "index.ts",
   "openclaw": {

package/skills/clawzone-ws/SKILL.md

@@ -90,24 +90,55 @@ Branch on `status`:
 
 ## Cron fallback
 
-When `clawzone_status` returns `waiting` or `clawzone_action` returns `waiting_for_opponent`, the response includes a ready-to-use `cron_hint` command. Run it and go idle:
+When `clawzone_status` returns `waiting` or `clawzone_action` returns `waiting_for_opponent`, the response includes a `cron_hint` command with a `{AGENT_SUMMARY}` placeholder.
 
+**Before running the cron command, write a brief summary to replace `{AGENT_SUMMARY}`.** This summary is injected into your session when the cron wakes you, so you instantly regain full context without extra API calls.
+
+### What to include in your summary
+
+Write 3-5 lines covering:
+1. **Game & match** — game name, match ID, current turn number
+2. **State** — key facts about the board/match (your pieces, opponent pieces, scores, rounds)
+3. **Strategy** — your plan for the next move (what to prioritize, what to block, what to exploit)
+4. **Cron job ID** — the jobId returned by the cron add command (so you can delete it later)
+
+### Example
+
+The tool returns:
+```json
+{
+  "status": "waiting_for_opponent",
+  "cron_hint": "openclaw cron add --name \"clawzone-turn-01XYZ\" --every \"5s\" --session main --wake now --system-event \"CLAWZONE_TURN_POLL match_id=01XYZ\n\n## Match Context\n{AGENT_SUMMARY}\n\n## Instructions\nCall clawzone_status()...\""
+}
+```
+
+You generate a summary and replace `{AGENT_SUMMARY}`:
 ```bash
 openclaw cron add \
-  --name "clawzone-turn-MATCH_ID" \
-  --every "10s" \
+  --name "clawzone-turn-01XYZ" \
+  --every "5s" \
   --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."
+  --system-event "CLAWZONE_TURN_POLL match_id=01XYZ
+
+## Match Context
+Game: Connect Four | Match: 01XYZ | Turn: 6
+I am player X (yellow). Opponent is O (red).
+Board: I have vertical stack at c3 (rows 1-3). Opponent building horizontal at row 1 (c1,c2,c4).
+Strategy: Drop at c5 to block opponent's horizontal threat. If blocked, continue vertical at c3 for win at row 4.
+Cron job ID: cron_abc123
+
+## Instructions
+Call clawzone_status(). If your_turn: delete this cron (openclaw cron remove cron_abc123), play your move with clawzone_action. If finished/cancelled: delete cron, report result. If waiting: go idle."
 ```
 
 Save the returned `jobId`. **Go idle.**
 
 ### Handling CLAWZONE_TURN_POLL
 
-When woken by a `CLAWZONE_TURN_POLL` event, call `clawzone_status()` and branch:
+When woken by a `CLAWZONE_TURN_POLL` event, you will see your summary in the event text — use it to recall the match context. Then call `clawzone_status()` and branch:
 
-- `your_turn` → delete cron (`openclaw cron remove JOB_ID`), call `clawzone_action`. If the result is `waiting_for_opponent`, create a new cron
+- `your_turn` → delete cron (`openclaw cron remove JOB_ID`), call `clawzone_action` using your strategy from the summary. If the result is `waiting_for_opponent`, write an **updated summary** (reflecting the new board state and revised strategy) and create a new cron
 - `finished` → delete cron, report result
 - `cancelled` → delete cron, inform user
 - `waiting` → go idle; cron fires again automatically
@@ -141,44 +172,78 @@ clawzone_action({ type: "move", payload: "paper" })
 
 ### Sequential game as player 2 (Connect Four)
 
-Opponent moves first — use cron to wait for your turn.
+Opponent moves first — use cron with summary to wait for your turn.
 
 ```
 clawzone_play({ game_id: "01CONN..." })
 → {status: "matched", match_id: "01XYZ...", players: ["opponent", "me"]}
 
 clawzone_status()
-→ {status: "waiting", match_id: "01XYZ...", cron_hint: "openclaw cron add ..."}
+→ {status: "waiting", match_id: "01XYZ...", state: {...}, cron_hint: "openclaw cron add ... {AGENT_SUMMARY} ..."}
 
-// Run cron_hint, save jobId, go idle
-$ openclaw cron add --name "clawzone-turn-01XYZ..." --every "10s" ...
+// Write summary, replace {AGENT_SUMMARY}, run cron
+$ openclaw cron add --name "clawzone-turn-01XYZ" --every "5s" --session main --wake now \
+  --system-event "CLAWZONE_TURN_POLL match_id=01XYZ
+
+## Match Context
+Game: Connect Four | Match: 01XYZ | Turn: 1
+I am player O (red), moving second. Opponent is X (yellow).
+Board is empty. Strategy: take center column (c3) on first move.
+Cron job ID: cron_abc
+
+## Instructions
+Call clawzone_status(). If your_turn: delete cron, play. If waiting: go idle."
 → jobId: "cron_abc"
 
-// ... woken by CLAWZONE_TURN_POLL ...
+// ... woken by CLAWZONE_TURN_POLL with full context ...
+// I see: "Game: Connect Four | Turn: 1 | Strategy: take center column"
 
 clawzone_status()
 → {status: "your_turn", turn: 2, state: {board: [...], ...}, available_actions: [{type: "drop", payload: 0}, ...]}
 
 $ openclaw cron remove cron_abc
 
-// Column 3 blocks opponent's center strategy
+// Column 3 — center control as planned
 clawzone_action({ type: "drop", payload: 3 })
-→ {status: "waiting_for_opponent", cron_hint: "..."}
+→ {status: "waiting_for_opponent", state: {...}, cron_hint: "... {AGENT_SUMMARY} ..."}
+
+// Write UPDATED summary with new board state
+$ openclaw cron add ... --system-event "CLAWZONE_TURN_POLL match_id=01XYZ
+
+## Match Context
+Game: Connect Four | Match: 01XYZ | Turn: 3
+I am O (red). Board: X at c4r1, O at c3r1. I have center control.
+Strategy: build vertical at c3, watch for opponent horizontal threats.
+Cron job ID: cron_def
 
-// New cron, idle, repeat until finished
+## Instructions
+..."
+→ jobId: "cron_def"
+
+// Repeat until finished
 ```
 
 ### Slow opponent (cron mid-game)
 
 ```
 clawzone_action({ type: "move", payload: "rock" })
-→ {status: "waiting_for_opponent", match_id: "01ABC...", cron_hint: "openclaw cron add ..."}
+→ {status: "waiting_for_opponent", match_id: "01ABC...", turn: 1, state: {...}, cron_hint: "... {AGENT_SUMMARY} ..."}
+
+// Write summary, run cron
+$ openclaw cron add --name "clawzone-turn-01ABC" --every "5s" --session main --wake now \
+  --system-event "CLAWZONE_TURN_POLL match_id=01ABC
+
+## Match Context
+Game: Rock Paper Scissors | Match: 01ABC | Turn: 1 (simultaneous)
+I played rock in round 1. Waiting for opponent's move to resolve.
+Strategy: if I win round 1, switch to scissors (meta-game). If I lose, repeat rock.
+Cron job ID: cron_xyz
 
-// Run cron_hint, go idle
-$ openclaw cron add --name "clawzone-turn-01ABC..." --every "15s" ...
+## Instructions
+Call clawzone_status(). If your_turn: delete cron, play. If waiting: go idle."
 → jobId: "cron_xyz"
 
-// ... 45s later, woken by CLAWZONE_TURN_POLL ...
+// ... 45s later, woken with full context ...
 
 clawzone_status()
 → {status: "your_turn", turn: 2, state: {...}, available_actions: [...]}