Skip to content

Commit 9586102

Browse files
committed
fix(docs): unbreak the MDX build and read trigger config from the registry
The docs build has been failing on staging since the Smartlead merge: ./apps/docs/content/docs/en/integrations/smartlead.mdx Expected a closing tag for `<original>` before the end of `paragraph` Tool descriptions are emitted as prose, and that path escaped only braces -- every table-cell path already escaped angle brackets. MDX reads `<` as the start of a JSX tag, so a description like 'The copy is named "<original> - copy"' fails the build outright. escapeMdxProse handles the MDX-hostile characters and leaves pipes, parens and brackets alone, which are legal in prose and whose escaping would mangle markdown links. Trigger configuration now comes from the evaluated registry instead of regex over source. Static parsing silently dropped every field whose builder assembled its array imperatively or took a description as a parameter -- all ten Jira triggers lost `webhookSecret` and `jqlFilter` that way, and Monday lost its config too, so regenerating the docs was destructive. Reading real objects also deletes 232 lines of parsing. Note `required` may be a condition object rather than `true`; only an unconditional `true` renders as Required, matching the previous behavior. Tool headings now show the tool's name ("A2A Send Message") rather than its id (`a2a_send_message`), unformatted, across 241 generated pages. Names come from tools/generated/tool-metadata.ts, which CI keeps in sync. These headings feed each page's table of contents. a2a.mdx is hand-written, so its headings were updated directly. Also consolidates five hand-inlined copies of the escape chain into the escapeMdxCell that already existed, and drops 44 comments that restated the line below them. Generator: 4306 -> 4069 lines. Every refactor step was verified against a golden manifest of all 289 generated files -- proven deterministic across runs and proven to catch a one-character change -- so the only output differences are the intended ones. KNOWN GAP: extractTriggerOutputs still parses source and has the same blind spot; it already drops one Jira output section on main. Regenerating is now safe for trigger config but still lossy for trigger outputs.
1 parent a23f212 commit 9586102

243 files changed

Lines changed: 4235 additions & 4417 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

apps/docs/content/docs/en/integrations/a2a.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Use the A2A (Agent-to-Agent) protocol to call external AI agents over the latest
2828

2929
## Tools
3030

31-
### `a2a_send_message`
31+
### A2A Send Message
3232

3333
Send a message to an external A2A agent and return its response.
3434

@@ -54,7 +54,7 @@ Send a message to an external A2A agent and return its response.
5454
| `state` | string | Task lifecycle state: `submitted`, `working`, `input-required`, `auth-required`, `completed`, `failed`, `canceled`, or `rejected` |
5555
| `artifacts` | array | Structured task output artifacts |
5656

57-
### `a2a_get_task`
57+
### A2A Get Task
5858

5959
Retrieve the current state and result of an A2A task.
6060

@@ -77,7 +77,7 @@ Retrieve the current state and result of an A2A task.
7777
| `state` | string | Task lifecycle state |
7878
| `artifacts` | array | Structured task output artifacts |
7979

80-
### `a2a_cancel_task`
80+
### A2A Cancel Task
8181

8282
Request cancellation of an in-progress A2A task.
8383

@@ -97,7 +97,7 @@ Request cancellation of an in-progress A2A task.
9797
| `state` | string | Task lifecycle state after cancellation |
9898
| `canceled` | boolean | Whether the task reached the canceled state |
9999

100-
### `a2a_get_agent_card`
100+
### A2A Get Agent Card
101101

102102
Fetch the Agent Card (discovery document) for an external A2A agent.
103103

apps/docs/content/docs/en/integrations/agentmail.mdx

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Integrate AgentMail into your workflow. Create and manage email inboxes, send an
4343

4444
## Actions
4545

46-
### `agentmail_create_draft`
46+
### Create Draft
4747

4848
Create a new email draft in AgentMail
4949

@@ -82,7 +82,7 @@ Create a new email draft in AgentMail
8282
| `createdAt` | string | Creation timestamp |
8383
| `updatedAt` | string | Last updated timestamp |
8484

85-
### `agentmail_create_inbox`
85+
### Create Inbox
8686

8787
Create a new email inbox with AgentMail
8888

@@ -105,7 +105,7 @@ Create a new email inbox with AgentMail
105105
| `createdAt` | string | Creation timestamp |
106106
| `updatedAt` | string | Last updated timestamp |
107107

108-
### `agentmail_delete_draft`
108+
### Delete Draft
109109

110110
Delete an email draft in AgentMail
111111

@@ -123,7 +123,7 @@ Delete an email draft in AgentMail
123123
| --------- | ---- | ----------- |
124124
| `deleted` | boolean | Whether the draft was successfully deleted |
125125

126-
### `agentmail_delete_inbox`
126+
### Delete Inbox
127127

128128
Delete an email inbox in AgentMail
129129

@@ -140,7 +140,7 @@ Delete an email inbox in AgentMail
140140
| --------- | ---- | ----------- |
141141
| `deleted` | boolean | Whether the inbox was successfully deleted |
142142

143-
### `agentmail_delete_thread`
143+
### Delete Thread
144144

145145
Delete an email thread in AgentMail (moves to trash, or permanently deletes if already in trash)
146146

@@ -159,7 +159,7 @@ Delete an email thread in AgentMail (moves to trash, or permanently deletes if a
159159
| --------- | ---- | ----------- |
160160
| `deleted` | boolean | Whether the thread was successfully deleted |
161161

162-
### `agentmail_forward_message`
162+
### Forward Message
163163

164164
Forward an email message to new recipients in AgentMail
165165

@@ -184,7 +184,7 @@ Forward an email message to new recipients in AgentMail
184184
| `messageId` | string | ID of the forwarded message |
185185
| `threadId` | string | ID of the thread |
186186

187-
### `agentmail_get_draft`
187+
### Get Draft
188188

189189
Get details of a specific email draft in AgentMail
190190

@@ -216,7 +216,7 @@ Get details of a specific email draft in AgentMail
216216
| `createdAt` | string | Creation timestamp |
217217
| `updatedAt` | string | Last updated timestamp |
218218

219-
### `agentmail_get_inbox`
219+
### Get Inbox
220220

221221
Get details of a specific email inbox in AgentMail
222222

@@ -237,7 +237,7 @@ Get details of a specific email inbox in AgentMail
237237
| `createdAt` | string | Creation timestamp |
238238
| `updatedAt` | string | Last updated timestamp |
239239

240-
### `agentmail_get_message`
240+
### Get Message
241241

242242
Get details of a specific email message in AgentMail
243243

@@ -266,7 +266,7 @@ Get details of a specific email message in AgentMail
266266
| `timestamp` | string | Time the message was sent or drafted |
267267
| `createdAt` | string | Creation timestamp |
268268

269-
### `agentmail_get_thread`
269+
### Get Thread
270270

271271
Get details of a specific email thread including messages in AgentMail
272272

@@ -304,7 +304,7 @@ Get details of a specific email thread including messages in AgentMail
304304
|`timestamp` | string | Time the message was sent or drafted |
305305
|`createdAt` | string | Creation timestamp |
306306

307-
### `agentmail_list_drafts`
307+
### List Drafts
308308

309309
List email drafts in an inbox in AgentMail
310310

@@ -336,7 +336,7 @@ List email drafts in an inbox in AgentMail
336336
| `count` | number | Total number of drafts |
337337
| `nextPageToken` | string | Token for retrieving the next page |
338338

339-
### `agentmail_list_inboxes`
339+
### List Inboxes
340340

341341
List all email inboxes in AgentMail
342342

@@ -361,7 +361,7 @@ List all email inboxes in AgentMail
361361
| `count` | number | Total number of inboxes |
362362
| `nextPageToken` | string | Token for retrieving the next page |
363363

364-
### `agentmail_list_messages`
364+
### List Messages
365365

366366
List messages in an inbox in AgentMail
367367

@@ -389,7 +389,7 @@ List messages in an inbox in AgentMail
389389
| `count` | number | Total number of messages |
390390
| `nextPageToken` | string | Token for retrieving the next page |
391391

392-
### `agentmail_list_threads`
392+
### List Threads
393393

394394
List email threads in AgentMail
395395

@@ -421,7 +421,7 @@ List email threads in AgentMail
421421
| `count` | number | Total number of threads |
422422
| `nextPageToken` | string | Token for retrieving the next page |
423423

424-
### `agentmail_reply_message`
424+
### Reply to Message
425425

426426
Reply to an existing email message in AgentMail
427427

@@ -446,7 +446,7 @@ Reply to an existing email message in AgentMail
446446
| `messageId` | string | ID of the sent reply message |
447447
| `threadId` | string | ID of the thread |
448448

449-
### `agentmail_send_draft`
449+
### Send Draft
450450

451451
Send an existing email draft in AgentMail
452452

@@ -465,7 +465,7 @@ Send an existing email draft in AgentMail
465465
| `messageId` | string | ID of the sent message |
466466
| `threadId` | string | ID of the thread |
467467

468-
### `agentmail_send_message`
468+
### Send Message
469469

470470
Send an email message from an AgentMail inbox
471471

@@ -491,7 +491,7 @@ Send an email message from an AgentMail inbox
491491
| `subject` | string | Email subject line |
492492
| `to` | string | Recipient email address |
493493

494-
### `agentmail_update_draft`
494+
### Update Draft
495495

496496
Update an existing email draft in AgentMail
497497

@@ -530,7 +530,7 @@ Update an existing email draft in AgentMail
530530
| `createdAt` | string | Creation timestamp |
531531
| `updatedAt` | string | Last updated timestamp |
532532

533-
### `agentmail_update_inbox`
533+
### Update Inbox
534534

535535
Update the display name of an email inbox in AgentMail
536536

@@ -552,7 +552,7 @@ Update the display name of an email inbox in AgentMail
552552
| `createdAt` | string | Creation timestamp |
553553
| `updatedAt` | string | Last updated timestamp |
554554

555-
### `agentmail_update_message`
555+
### Update Message
556556

557557
Add or remove labels on an email message in AgentMail
558558

@@ -573,7 +573,7 @@ Add or remove labels on an email message in AgentMail
573573
| `messageId` | string | Unique identifier for the message |
574574
| `labels` | array | Current labels on the message |
575575

576-
### `agentmail_update_thread`
576+
### Update Thread Labels
577577

578578
Add or remove labels on an email thread in AgentMail
579579

0 commit comments

Comments
 (0)