Skip to content

Commit fd58363

Browse files
ouiliameclaude
andcommitted
fix(docs-gen): stop cleanup/writer filter mismatch from eating manual content
Comprehensive-review findings, all generator-consistency bugs: - cleanup used staging's isIntegrationBlock while the writer kept the legacy filter, so integrations/{knowledge,memory,table}.mdx were deleted then regenerated without their manual intros every run. Both now honor a shared NATIVE_RESOURCE_BLOCK_TYPES set; intros reseeded. - Trigger-only services (imap, circleback; category 'triggers') were likewise deleted each run; the canonical set now includes visible trigger-category blocks, the standalone writer preserves manual content, and their intros are reseeded. - Mapped jsm -> jira_service_management, so JSM triggers merge into the JSM integration page instead of an orphan jsm.mdx (removed). - Repointed lingering bare /tools links to /integrations; added missing pageType to integrations/index and building-agents/custom-tools. Double-regen is now churn-free (idempotent) with all manual content intact. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 64c68de commit fd58363

17 files changed

Lines changed: 449 additions & 349 deletions

File tree

apps/docs/content/docs/en/blocks/agent.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Files for the model to read: images for a vision-capable model, or documents for
3737

3838
### Tools
3939

40-
Capabilities the agent can call while it runs: search a knowledge base, send a Slack message, run a [Function](/blocks/function), or call any of the [integrations](/tools). The model decides which to call and when. Each tool has a usage control:
40+
Capabilities the agent can call while it runs: search a knowledge base, send a Slack message, run a [Function](/blocks/function), or call any of the [integrations](/integrations). The model decides which to call and when. Each tool has a usage control:
4141

4242
- **Auto.** The model calls it when the context warrants.
4343
- **Force.** The model must call it on every run.

apps/docs/content/docs/en/building-agents/choosing.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,13 @@ The running example is a workflow that scores inbound sales leads. It reads a ne
1717

1818
A **block** is a single step that runs at a fixed point on the path, with no model deciding whether to. It always runs when the workflow reaches it. Use one when the action must happen every time: an API call, a data transform, a branch.
1919

20-
In the lead scorer, a [Google Sheets](/tools) block always appends the scored lead to a tracking sheet, and a [Function](/blocks/function) block always reshapes the enrichment response into the fields the next step expects. There is no judgment call. The work is guaranteed.
20+
In the lead scorer, a [Google Sheets](/integrations) block always appends the scored lead to a tracking sheet, and a [Function](/blocks/function) block always reshapes the enrichment response into the fields the next step expects. There is no judgment call. The work is guaranteed.
2121

2222
Most steps in a workflow are blocks. Reach for the kinds below only when you want a model to decide, or you want to reuse something.
2323

2424
## Agent tool
2525

26-
An **agent tool** is an action you hand to an [Agent](/blocks/agent) block. The agent reads the task and decides whether and when to call it. The same catalog of [integrations](/tools) that exist as standalone blocks can also be attached to an agent as tools.
26+
An **agent tool** is an action you hand to an [Agent](/blocks/agent) block. The agent reads the task and decides whether and when to call it. The same catalog of [integrations](/integrations) that exist as standalone blocks can also be attached to an agent as tools.
2727

2828
In the lead scorer, the Agent has a Search tool and a Send Email tool. For a lead with a thin profile it runs Search to gather context; for a strong lead it calls Send Email. A thin, obvious lead might trigger neither. The agent chooses per run.
2929

apps/docs/content/docs/en/building-agents/custom-tools.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Custom Tools
33
description: Create your own tools with JavaScript code and use them in Agent blocks
4+
pageType: guide
45
---
56

67
import { Callout } from 'fumadocs-ui/components/callout'

apps/docs/content/docs/en/building-agents/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ To let an agent do something in the world, give it **tools**. A tool is an actio
3131

3232
Tools come from a few places:
3333

34-
- **[Integrations](/tools)** are the catalog of external services: Gmail, Slack, Airtable, Linear, and hundreds more.
34+
- **[Integrations](/integrations)** are the catalog of external services: Gmail, Slack, Airtable, Linear, and hundreds more.
3535
- **[Custom tools](/building-agents/custom-tools)** are tools you define once with a schema and a snippet of code, then reuse.
3636
- **[MCP tools](/mcp)** come from an external provider you connect through the Model Context Protocol.
3737
- **[Workflow-as-tool](/workflows)** makes another workflow callable, so the agent runs a whole procedure as one step.

apps/docs/content/docs/en/getting-started/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ Build, test, and refine workflows quickly with immediate feedback
173173
<Card title="Explore Blocks" href="/workflows#blocks">
174174
Discover API, Function, Condition, and other blocks
175175
</Card>
176-
<Card title="Browse Integrations" href="/tools">
176+
<Card title="Browse Integrations" href="/integrations">
177177
Connect 1,000+ services including Gmail, Slack, Notion, and more
178178
</Card>
179179
<Card title="Add Custom Logic" href="/blocks/function">
@@ -188,7 +188,7 @@ Build, test, and refine workflows quickly with immediate feedback
188188

189189
**Need detailed explanations?** Visit the [Blocks documentation](/workflows#blocks) for comprehensive guides on each component.
190190

191-
**Looking for integrations?** Explore the [Tools documentation](/tools) to see all 1,000+ available integrations.
191+
**Looking for integrations?** Explore the [Tools documentation](/integrations) to see all 1,000+ available integrations.
192192

193193
**Ready to go live?** Learn about [Execution and Deployment](/workflows) to make your workflows production-ready.
194194

apps/docs/content/docs/en/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Welcome to Sim, the open-source AI workspace where teams build, deploy, and mana
2020
<Card title="Blocks" href="/workflows#blocks">
2121
Learn about the building blocks
2222
</Card>
23-
<Card title="Tools & Integrations" href="/tools">
23+
<Card title="Tools & Integrations" href="/integrations">
2424
Explore 1,000+ integrations
2525
</Card>
2626
</Cards>

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

Lines changed: 40 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,53 @@
11
---
22
title: Circleback
3-
description: AI-powered meeting notes and action items
3+
description: Circleback triggers for automating workflows
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
77

8-
<BlockInfoCard
8+
<BlockInfoCard
99
type="circleback"
1010
color="linear-gradient(180deg, #E0F7FA 0%, #FFFFFF 100%)"
1111
/>
1212

13-
## Usage Instructions
14-
15-
Receive meeting notes, action items, transcripts, and recordings when meetings are processed. Circleback uses webhooks to push data to your workflows.
16-
17-
18-
13+
{/* MANUAL-CONTENT-START:intro */}
14+
[Circleback](https://circleback.ai/) is an AI-powered platform that automates meeting notes, action items, transcripts, and recordings for your team. When a meeting is completed, Circleback processes the conversation and provides detailed notes and action items, along with a transcript and a recording (when available). This helps teams efficiently capture insights, distribute action items, and ensure nothing is missed—all seamlessly integrated into your workflows.
15+
16+
With the Sim Circleback integration, you can:
17+
18+
- **Receive detailed meeting notes and action items**: Automatically collect well-formatted meeting summaries and track actionable tasks discussed during your calls.
19+
- **Access complete meeting recordings and transcripts**: Get the full conversation and the associated recording, making it easy to review key moments or share with colleagues.
20+
- **Capture attendee information and meeting context**: Attendee lists, meeting metadata, and tags help keep your data organized and actionable.
21+
- **Deliver insights directly into your workflows**: Trigger automations or send Circleback data to other systems the moment a meeting is done, using Sim’s powerful webhook triggers.
22+
23+
**How it works in Sim:**
24+
Circleback uses webhook triggers: whenever a meeting is processed, data is pushed automatically to your agent or automation. You can build further automations based on:
25+
26+
- Meeting completed (all processed data available)
27+
- New notes (notes ready even before full meeting is processed)
28+
- Raw webhook integration for advanced use cases
29+
30+
**The following information is available in the Circleback meeting webhook payload:**
31+
32+
| Field | Type | Description |
33+
|----------------|---------|----------------------------------------------------|
34+
| `id` | number | Circleback meeting ID |
35+
| `name` | string | Meeting title |
36+
| `url` | string | Virtual meeting URL (Zoom, Meet, Teams, etc.) |
37+
| `createdAt` | string | Meeting creation timestamp |
38+
| `duration` | number | Duration in seconds |
39+
| `recordingUrl` | string | Recording URL (valid 24 hours) |
40+
| `tags` | json | Array of tags |
41+
| `icalUid` | string | Calendar event ID |
42+
| `attendees` | json | Array of attendee objects |
43+
| `notes` | string | Meeting notes in Markdown |
44+
| `actionItems` | json | Array of action items |
45+
| `transcript` | json | Array of transcript segments |
46+
| `insights` | json | User-created insights |
47+
| `meeting` | json | Full meeting payload |
48+
49+
Whether you want to distribute instant summaries, log action items, or build custom workflows triggered by new meeting data, Circleback and Sim make it seamless to handle everything related to your meetings—automatically.
50+
{/* MANUAL-CONTENT-END */}
1951

2052

2153
## Triggers

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

Lines changed: 14 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,29 @@
11
---
2-
title: IMAP Email
3-
description: Trigger workflows when new emails arrive via IMAP (works with any email provider)
2+
title: IMAP
3+
description: IMAP triggers for automating workflows
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
77

8-
<BlockInfoCard
8+
<BlockInfoCard
99
type="imap"
1010
color="#6366F1"
1111
/>
1212

13-
## Usage Instructions
14-
15-
Connect to any email server via IMAP protocol to trigger workflows when new emails are received. Supports Gmail, Outlook, Yahoo, and any other IMAP-compatible email provider.
13+
{/* MANUAL-CONTENT-START:intro */}
14+
The IMAP Email trigger allows your Sim workflows to start automatically whenever a new email is received in any mailbox that supports the IMAP protocol. This works with Gmail, Outlook, Yahoo, and most other email providers.
1615

16+
With the IMAP trigger, you can:
1717

18+
- **Automate email processing**: Start workflows in real time when new messages arrive in your inbox.
19+
- **Filter by sender, subject, or folder**: Configure your trigger to react only to emails that match certain conditions.
20+
- **Extract and process attachments**: Automatically download and use file attachments in your automated flows.
21+
- **Parse and use email content**: Access the subject, sender, recipients, full body, and other metadata in downstream workflow steps.
22+
- **Integrate with any email provider**: Works with any service that provides standard IMAP access, without vendor lock-in.
23+
- **Trigger on unread, flagged, or custom criteria**: Set up advanced filters for the kinds of emails that start your workflows.
1824

25+
With Sim, the IMAP integration gives you the power to turn email into an actionable source of automation. Respond to customer inquiries, process notifications, kick off data pipelines, and more—directly from your email inbox, with no manual intervention.
26+
{/* MANUAL-CONTENT-END */}
1927

2028

2129
## Triggers

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: Integrations
33
description: Connect third-party services and OAuth accounts for your workflows
4+
pageType: guide
45
---
56

67
import { Callout } from 'fumadocs-ui/components/callout'

0 commit comments

Comments
 (0)