القائمة
Run an EventQL query against an EventSourcingDB instance. Use when the user wants to query, filter, aggregate, or analyze events using the EventQL query language.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Read details about a single event type from an EventSourcingDB instance. Use when the user wants to inspect a specific event type, check if it has a schema, or see its details.
Read all event types from an EventSourcingDB instance. Use when the user wants to list or discover all event types that exist in the event store.
Register a JSON Schema for an event type on an EventSourcingDB instance. Use when the user wants to add validation, define a schema, or enforce structure for an event type.
Write events to an EventSourcingDB instance. Use when the user wants to store, append, or publish events, optionally with preconditions such as optimistic locking or subject constraints.
Observe events in real time from an EventSourcingDB instance. Use when the user wants to watch, monitor, or stream live events as they are written.
Ping an EventSourcingDB instance to check if it is reachable. Use when the user wants to verify connectivity or check if EventSourcingDB is running.
استنادا إلى تصنيف SOC المهني
| name | run-eventql-query |
| description | Run an EventQL query against an EventSourcingDB instance. Use when the user wants to query, filter, aggregate, or analyze events using the EventQL query language. |
| allowed-tools | Bash, Read, AskUserQuestion |
Run an EventQL query against an EventSourcingDB instance.
First read ${CLAUDE_PLUGIN_ROOT}/shared/common.md. It explains how to determine the base URL and API token, how to handle NDJSON responses, and which conventions apply. Follow it throughout this skill.
Also read ${CLAUDE_PLUGIN_ROOT}/shared/cloudevents.md when query results contain full events. It explains how events are structured, including the EventSourcingDB-specific metadata fields.
This endpoint returns NDJSON:
curl -s --no-buffer -X POST \
-H "authorization: Bearer ${ESDB_API_TOKEN}" \
-H "content-type: application/json" \
-d '<REQUEST_BODY>' \
"${ESDB_URL:-http://localhost:3000}/api/v1/run-eventql-query" \
| grep -v '"type":"heartbeat"'
{
"query": "<EventQL query>"
}
curl -s --no-buffer -X POST \
-H "authorization: Bearer ${ESDB_API_TOKEN}" \
-H "content-type: application/json" \
-d "{\"query\": \"FROM e IN events PROJECT INTO e\"}" \
"${ESDB_URL:-http://localhost:3000}/api/v1/run-eventql-query" \
| grep -v '"type":"heartbeat"'
FROM e IN events PROJECT INTO eFROM e IN events WHERE e.type == "io.eventsourcingdb.library.book-acquired" PROJECT INTO eFROM e IN events WHERE e.subject == "/books/42" PROJECT INTO eFROM e IN events WHERE e.type == "io.eventsourcingdb.library.book-borrowed" PROJECT INTO { total: COUNT() }FROM e IN events GROUP BY e.type PROJECT INTO { type: UNIQUE(e.type), count: COUNT() }FROM e IN events ORDER BY e.time DESC TOP 10 PROJECT INTO eNDJSON stream with one line per result row:
{"type":"row","payload":{...}}