Agent skill · software engineering · jeremylongshore

mistral-webhooks-events

Implement Mistral Workflows event ingestion over SSE with checkpoints, deduplication, reconnect control, and reconciliation. Use when consuming workflow event streams. Trigger with "stream Mistral workflow events", "reconcile Mistral runs", or "replace Mistral webhooks".

Why this skill is useful

Adds executable scripts for Mistral AI async workflows and batch processing that are not publicly documented.

What it needs

Requires @mistralai/mistralai installed locally. Requires mistral account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

Mistral Workflows SSE Event Ingestion Overview Consume the current Workflows stream as an at-least-once boundary. Authenticate the outbound SSE connection, persist checkpoints/deduplication, and reconcile terminal run state after disconnects. Prerequisites An approved Workflows deployment scope and server-side consumer. A durable checkpoint store and bounded reconnect policy. A reconciliation query, tenant mapping, retention policy, and synthetic fixtures. Current Contract The Events API documents SSE at GET /v1/workflows/events/stream. This authenticated outbound stream is not evidence of a generic Mistral-to-application webhook callback contract. Authentication Open SSE from a trusted service with Bearer auth. Never put the key in query strings, browser EventSource URLs, logs, checkpoints, or event records. Instructions 1. Confirm workflow scope, event schema, filters, and current stability status. 2. Identify stable deduplication fields actually documented and treat events as repeatable observations. 3. Parse SSE incrementally, bound frames/idleness, and checkpoint only after durable handling. 4. Bind each idempotent transition to an authorized tenant and known run. 5. Reconnect with capped jitter; on gaps, query current run state and reconcile. 6. Test duplicates, ordering, malformed frames, auth expiry, disconnects, retention, and shutdown. Tool Discipline Use Read, Glob, and Grep to inspect code, locks, configuration, tests, and evidence. Use Write and Edit only for approved repository changes. Invocation alone does not authorize network calls, paid usage, uploads, stateful resources, admin mutations, deployments, or deletion. Approval Boundaries Workflow deployment, production stream access, identifier retention, replay, or application mutation require explicit approval. Keep fixture-based parser work local until those approvals exist. Error Handling Reconnect can replay observations; side effects must not repeat. Disconnect does not prove workflow failure. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/mistral-webhooks-events

View the source on GitHub

Browse the @skills marketplace