docs(llms): include the subscribe/dispatch guides in the agent bundle#44
Open
ucekmez wants to merge 1 commit into
Open
docs(llms): include the subscribe/dispatch guides in the agent bundle#44ucekmez wants to merge 1 commit into
ucekmez wants to merge 1 commit into
Conversation
…st in the bundle llms-full.txt inlined the setup/integrate/testing guides but omitted how-to-subscribe.md and how-to-dispatch.md — the two core actions an agent performs against an EEP entity — and the package inventory in llms.txt was missing agent-adopt and discovery. Add both guides to the generator's include list and to the llms.txt guide index, complete the package list, and regenerate llms.txt and llms-full.txt. Surfaced by the EEP protocol audit (finding DX-1). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Ugur Cekmez <ucekmez@gmail.com>
There was a problem hiding this comment.
Pull request overview
Updates the repository’s agent knowledge bundles (llms.txt and llms-full.txt) to include the two core action guides (subscribe/dispatch) and to align the package inventory with the current @eep-dev/* workspace, ensuring agents have direct access to the canonical workflows they’re expected to perform.
Changes:
- Extend
scripts/generate-llms-docs.pyto includehow-to-subscribe.mdandhow-to-dispatch.mdin both the concise index (llms.txt) and the full concatenation (llms-full.txt). - Update the TypeScript package inventory list to include
@eep-dev/discoveryand@eep-dev/agent-adopt. - Regenerate
llms.txtandllms-full.txtoutputs.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| scripts/generate-llms-docs.py | Adds the missing subscribe/dispatch guides to the generation inputs and updates the TS package inventory line. |
| llms.txt | Regenerated concise agent bundle reflecting the updated inventory and guide index. |
| llms-full.txt | Regenerated comprehensive bundle now including the subscribe/dispatch guides (and updated embedded README/spec snapshots). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ## What is EEP? | ||
|
|
||
| The Entity Engagement Protocol (EEP) describes how digital entities (people, organizations, products, agents) **publish state changes** and how **authorized subscribers** receive them **as events**, with optional **access gates** (identity, credentials, payment, agreements) and **signatures** so subscribers can tell real traffic from forgery. | ||
| The Entity Engagement Protocol (EEP) describes how digital entities (people organizations, products, agents) **publish state changes** and how **authorized subscribers** receive them **as events**, with optional **access gates** (identity, credentials, payment, agreements) and **signatures** so subscribers can tell real traffic from forgery. |
Comment on lines
+2516
to
+2522
| // Verify signature | ||
| const signedContent = `${webhookId}.${timestamp}.${rawBody}`; | ||
| const expected = createHmac('sha256', secret).update(signedContent).digest('base64'); | ||
| const incoming = signature.replace('v1,', ''); | ||
|
|
||
| if (!timingSafeEqual(Buffer.from(expected), Buffer.from(incoming))) { | ||
| return res.status(401).json({ error: 'Invalid signature' }); |
Comment on lines
+2951
to
+2956
| // WebSocket backpressure enforcement | ||
| ws.on('drain', () => { | ||
| const queuedBytes = ws.bufferedAmount; | ||
| if (queuedBytes > MAX_BUFFER_BYTES) { | ||
| ws.close(WsCloseCode.BACKPRESSURE, 'Backpressure: subscriber too slow'); | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
llms.txt/llms-full.txtare the agent knowledge bundle, butllms-full.txtinlined the setup/integrate/testing guides while omittinghow-to-subscribe.mdandhow-to-dispatch.md— the two canonical actions an agent performs. Thellms.txtpackage inventory was also missingagent-adoptanddiscovery.Fix
generate-llms-docs.py(thellms-full.txtconcatenation and thellms.txtguide index).+ discovery, + agent-adopt).llms.txtandllms-full.txt;verify-llms-docs.pypasses.Surfaced by the EEP protocol audit (finding DX-1).
🤖 Generated with Claude Code