{"files":{"SKILL.md":"---\nname: the-mercure-protocol\ndescription: \"The Mercure protocol API skill. Use when working with The Mercure protocol for .well-known. Covers 5 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# The Mercure protocol\nAPI version: 0.3.2\n\n## Auth\nBearer bearer | ApiKey mercureAuthorization in cookie\n\n## Base URL\nNot specified.\n\n## Setup\n1. Set Authorization header with Bearer token\n2. GET /.well-known/mercure -- subscribe to updates\n3. POST /.well-known/mercure -- create first mercure\n\n## Endpoints\n5 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### .well-known\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /.well-known/mercure | Subscribe to updates |\n| POST | /.well-known/mercure | Publish an update |\n| GET | /.well-known/mercure/subscriptions | Active subscriptions |\n| GET | /.well-known/mercure/subscriptions/{topic} | Active subscriptions for the given topic |\n| GET | /.well-known/mercure/subscriptions/{topic}/{subscriber} | Active subscription for the given topic and subscriber |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all mercure?\" -> GET /.well-known/mercure\n- \"Create a mercure?\" -> POST /.well-known/mercure\n- \"List all subscriptions?\" -> GET /.well-known/mercure/subscriptions\n- \"Get subscription details?\" -> GET /.well-known/mercure/subscriptions/{topic}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api The Mercure protocol\n@version 0.3.2\n@auth Bearer bearer | ApiKey mercureAuthorization in cookie\n@endpoints 5\n@toc .well-known(5)\n\n@endpoint GET /.well-known/mercure\n@desc Subscribe to updates\n@required {topic: [str] # The topic to get updates from, can be a URI template (RFC6570).}\n@optional {Last-Event-ID: str # The last received event id, to retrieve missed events., Last-Event-ID: str # The last received event id, to retrieve missed events, takes precedence over the query parameter.}\n@returns(200) Event stream opened.\n@errors {400: Missing topic parameter or invalid URI template., 401: Not authorized (missing or invalid JWT).}\n\n@endpoint POST /.well-known/mercure\n@desc Publish an update\n@returns(200) The id of this update\n@errors {400: Invalid request, 401: Not authorized (missing or invalid JWT).}\n\n@endpoint GET /.well-known/mercure/subscriptions\n@desc Active subscriptions\n@returns(200) The list of active subscriptions\n@errors {401: Not authorized (missing or invalid JWT).}\n\n@endpoint GET /.well-known/mercure/subscriptions/{topic}\n@desc Active subscriptions for the given topic\n@required {topic: str}\n@returns(200) The list of active subscriptions\n@errors {401: Not authorized (missing or invalid JWT).}\n\n@endpoint GET /.well-known/mercure/subscriptions/{topic}/{subscriber}\n@desc Active subscription for the given topic and subscriber\n@required {topic: str, subscriber: str}\n@returns(200) The list of active subscriptions\n@errors {401: Not authorized (missing or invalid JWT).}\n\n@end\n"}}