condition-based-waiting

What problem does it solve?

This Skill replaces unreliable arbitrary timeouts in tests with robust condition-based polling, eliminating flaky tests caused by race conditions and timing dependencies, ensuring consistent and reliable test results.

Core Features & Use Cases

• Reliable Async Waiting: Provides a generic waitFor function to poll for a condition to become true, preventing tests from failing due to timing guesses.
• Domain-Specific Helpers: Includes examples for waiting for specific events, event counts, or custom predicates, adaptable to various async scenarios.
• Flaky Test Prevention: Ensures tests wait for actual state changes, not just a guessed duration, making your test suite more robust.
• Use Case: When a test intermittently fails due to an await new Promise(r => setTimeout(r, 50)); line, use this skill to replace it with await waitFor(() => getResult() !== undefined);, making the test reliable across different environments and loads.

Quick Start

Generic polling function

async function waitFor(condition, description, timeoutMs = 5000) { const startTime = Date.now(); while (true) { const result = condition(); if (result) return result; if (Date.now() - startTime > timeoutMs) { throw new Error(Timeout waiting for ${description}); } await new Promise(r => setTimeout(r, 10)); # Poll every 10ms } }

Example: Wait for a specific event

await waitForEvent(threadManager, agentThreadId, 'TOOL_RESULT');