Skip to content

Event Source Dry Run

Preview an event source without any side effects — fetch, diff against the last value, and evaluate the condition, but never publish, run an action, or advance the cursor. Returns the sampled value, whether it changed, the would-emit event, and whether the condition would pass. The preview the /wb-event-new authoring loop shows before activating.

MCP name: event_source_dry_run

Category: events

Parameters

Name Type Required Description
name str No The event source name (the .md file stem). Provide this to preview a saved source.
proposal dict No The structured event_source_create fields (name, source_type, interval, extract_*, condition, action, semantic, ...), to preview a not-yet-saved source — what /wb-event-new's dry-run step passes. Provide either name or proposal.
run_semantic bool No If true, actually evaluate the Tier-3 semantic gate (a real web search + local-model call). Default false — the semantic block is only reported (semantic_pending), keeping the preview cheap and side-effect-free.

Details

Run a single source poll with zero side effects: fetch the payload, extract the watched value, diff it against the stored cursor, and — if it changed — evaluate the source's CEL condition over the would-emit event. Nothing is published, no action runs, and the cursor is not advanced, so this is safe to call repeatedly while authoring. Returns {changed, current, prev, would_emit, condition_passed, would_fire} so the author can see exactly what would happen before activating the source.