improvement: features, footer, tab modals

* fix(files): new file bun error

* update constant

* fix types

.claude/commands/add-block.md

@@ -20,6 +20,7 @@ When the user asks you to create a block:
 import { {ServiceName}Icon } from '@/components/icons'
 import type { BlockConfig } from '@/blocks/types'
 import { AuthMode } from '@/blocks/types'
+import { getScopesForService } from '@/lib/oauth/utils'
 
 export const {ServiceName}Block: BlockConfig = {
   type: '{service}',                    // snake_case identifier
@@ -115,12 +116,17 @@ export const {ServiceName}Block: BlockConfig = {
   id: 'credential',
   title: 'Account',
   type: 'oauth-input',
-  serviceId: '{service}',  // Must match OAuth provider
+  serviceId: '{service}',  // Must match OAuth provider service key
+  requiredScopes: getScopesForService('{service}'),  // Import from @/lib/oauth/utils
   placeholder: 'Select account',
   required: true,
 }
 ```
 
+**Scopes:** Always use `getScopesForService(serviceId)` from `@/lib/oauth/utils` for `requiredScopes`. Never hardcode scope arrays — the single source of truth is `OAUTH_PROVIDERS` in `lib/oauth/oauth.ts`.
+
+**Scope descriptions:** When adding a new OAuth provider, also add human-readable descriptions for all scopes in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts`.
+
 ### Selectors (with dynamic options)
 ```typescript
 // Channel selector (Slack, Discord, etc.)
@@ -454,6 +460,8 @@ Enables AI-assisted field generation.
 
 ## Tools Configuration
 
+**Important:** `tools.config.tool` runs during serialization before variable resolution. Put `Number()` and other type coercions in `tools.config.params` instead, which runs at execution time after variables are resolved.
+
 **Preferred:** Use tool names directly as dropdown option IDs to avoid switch cases:
 ```typescript
 // Dropdown options use tool IDs directly
@@ -530,6 +538,41 @@ outputs: {
 }
 ```
 
+### Typed JSON Outputs
+
+When using `type: 'json'` and you know the object shape in advance, **describe the inner fields in the description** so downstream blocks know what properties are available. For well-known, stable objects, use nested output definitions instead:
+
+```typescript
+outputs: {
+  // BAD: Opaque json with no info about what's inside
+  plan: { type: 'json', description: 'Zone plan information' },
+
+  // GOOD: Describe the known fields in the description
+  plan: {
+    type: 'json',
+    description: 'Zone plan information (id, name, price, currency, frequency, is_subscribed)',
+  },
+
+  // BEST: Use nested output definition when the shape is stable and well-known
+  plan: {
+    id: { type: 'string', description: 'Plan identifier' },
+    name: { type: 'string', description: 'Plan name' },
+    price: { type: 'number', description: 'Plan price' },
+    currency: { type: 'string', description: 'Price currency' },
+  },
+}
+```
+
+Use the nested pattern when:
+- The object has a small, stable set of fields (< 10)
+- Downstream blocks will commonly access specific properties
+- The API response shape is well-documented and unlikely to change
+
+Use `type: 'json'` with a descriptive string when:
+- The object has many fields or a dynamic shape
+- It represents a list/array of items
+- The shape varies by operation
+
 ## V2 Block Pattern
 
 When creating V2 blocks (alongside legacy V1):
@@ -587,6 +630,7 @@ export const registry: Record<string, BlockConfig> = {
 import { ServiceIcon } from '@/components/icons'
 import type { BlockConfig } from '@/blocks/types'
 import { AuthMode } from '@/blocks/types'
+import { getScopesForService } from '@/lib/oauth/utils'
 
 export const ServiceBlock: BlockConfig = {
   type: 'service',
@@ -617,6 +661,7 @@ export const ServiceBlock: BlockConfig = {
       title: 'Service Account',
       type: 'oauth-input',
       serviceId: 'service',
+      requiredScopes: getScopesForService('service'),
       placeholder: 'Select account',
       required: true,
     },
@@ -693,16 +738,88 @@ Please provide the SVG and I'll convert it to a React component.
 You can usually find this in the service's brand/press kit page, or copy it from their website.
 ```
 
+## Advanced Mode for Optional Fields
+
+Optional fields that are rarely used should be set to `mode: 'advanced'` so they don't clutter the basic UI. This includes:
+- Pagination tokens
+- Time range filters (start/end time)
+- Sort order options
+- Reply settings
+- Rarely used IDs (e.g., reply-to tweet ID, quote tweet ID)
+- Max results / limits
+
+```typescript
+{
+  id: 'startTime',
+  title: 'Start Time',
+  type: 'short-input',
+  placeholder: 'ISO 8601 timestamp',
+  condition: { field: 'operation', value: ['search', 'list'] },
+  mode: 'advanced',  // Rarely used, hide from basic view
+}
+```
+
+## WandConfig for Complex Inputs
+
+Use `wandConfig` for fields that are hard to fill out manually, such as timestamps, comma-separated lists, and complex query strings. This gives users an AI-assisted input experience.
+
+```typescript
+// Timestamps - use generationType: 'timestamp' to inject current date context
+{
+  id: 'startTime',
+  title: 'Start Time',
+  type: 'short-input',
+  mode: 'advanced',
+  wandConfig: {
+    enabled: true,
+    prompt: 'Generate an ISO 8601 timestamp based on the user description. Return ONLY the timestamp string.',
+    generationType: 'timestamp',
+  },
+}
+
+// Comma-separated lists - simple prompt without generationType
+{
+  id: 'mediaIds',
+  title: 'Media IDs',
+  type: 'short-input',
+  mode: 'advanced',
+  wandConfig: {
+    enabled: true,
+    prompt: 'Generate a comma-separated list of media IDs. Return ONLY the comma-separated values.',
+  },
+}
+```
+
+## Naming Convention
+
+All tool IDs referenced in `tools.access` and returned by `tools.config.tool` MUST use `snake_case` (e.g., `x_create_tweet`, `slack_send_message`). Never use camelCase or PascalCase.
+
 ## Checklist Before Finishing
 
 - [ ] All subBlocks have `id`, `title` (except switch), and `type`
 - [ ] Conditions use correct syntax (field, value, not, and)
 - [ ] DependsOn set for fields that need other values
 - [ ] Required fields marked correctly (boolean or condition)
-- [ ] OAuth inputs have correct `serviceId`
-- [ ] Tools.access lists all tool IDs
-- [ ] Tools.config.tool returns correct tool ID
+- [ ] OAuth inputs have correct `serviceId` and `requiredScopes: getScopesForService(serviceId)`
+- [ ] Scope descriptions added to `SCOPE_DESCRIPTIONS` in `lib/oauth/utils.ts` for any new scopes
+- [ ] Tools.access lists all tool IDs (snake_case)
+- [ ] Tools.config.tool returns correct tool ID (snake_case)
 - [ ] Outputs match tool outputs
 - [ ] Block registered in registry.ts
 - [ ] If icon missing: asked user to provide SVG
 - [ ] If triggers exist: `triggers` config set, trigger subBlocks spread
+- [ ] Optional/rarely-used fields set to `mode: 'advanced'`
+- [ ] Timestamps and complex inputs have `wandConfig` enabled
+
+## Final Validation (Required)
+
+After creating the block, you MUST validate it against every tool it references:
+
+1. **Read every tool definition** that appears in `tools.access` — do not skip any
+2. **For each tool, verify the block has correct:**
+   - SubBlock inputs that cover all required tool params (with correct `condition` to show for that operation)
+   - SubBlock input types that match the tool param types (e.g., dropdown for enums, short-input for strings)
+   - `tools.config.params` correctly maps subBlock IDs to tool param names (if they differ)
+   - Type coercions in `tools.config.params` for any params that need conversion (Number(), Boolean(), JSON.parse())
+3. **Verify block outputs** cover the key fields returned by all tools
+4. **Verify conditions** — each subBlock should only show for the operations that actually use it

.claude/commands/add-connector.md

@@ -0,0 +1,437 @@
+---
+description: Add a knowledge base connector for syncing documents from an external source
+argument-hint: <service-name> [api-docs-url]
+---
+
+# Add Connector Skill
+
+You are an expert at adding knowledge base connectors to Sim. A connector syncs documents from an external source (Confluence, Google Drive, Notion, etc.) into a knowledge base.
+
+## Your Task
+
+When the user asks you to create a connector:
+1. Use Context7 or WebFetch to read the service's API documentation
+2. Determine the auth mode: **OAuth** (if Sim already has an OAuth provider for the service) or **API key** (if the service uses API key / Bearer token auth)
+3. Create the connector directory and config
+4. Register it in the connector registry
+
+## Directory Structure
+
+Create files in `apps/sim/connectors/{service}/`:
+```
+connectors/{service}/
+├── index.ts          # Barrel export
+└── {service}.ts      # ConnectorConfig definition
+```
+
+## Authentication
+
+Connectors use a discriminated union for auth config (`ConnectorAuthConfig` in `connectors/types.ts`):
+
+```typescript
+type ConnectorAuthConfig =
+  | { mode: 'oauth'; provider: OAuthService; requiredScopes?: string[] }
+  | { mode: 'apiKey'; label?: string; placeholder?: string }
+```
+
+### OAuth mode
+For services with existing OAuth providers in `apps/sim/lib/oauth/types.ts`. The `provider` must match an `OAuthService`. The modal shows a credential picker and handles token refresh automatically.
+
+### API key mode
+For services that use API key / Bearer token auth. The modal shows a password input with the configured `label` and `placeholder`. The API key is encrypted at rest using AES-256-GCM and stored in a dedicated `encryptedApiKey` column on the connector record. The sync engine decrypts it automatically — connectors receive the raw access token in `listDocuments`, `getDocument`, and `validateConfig`.
+
+## ConnectorConfig Structure
+
+### OAuth connector example
+
+```typescript
+import { createLogger } from '@sim/logger'
+import { {Service}Icon } from '@/components/icons'
+import { fetchWithRetry } from '@/lib/knowledge/documents/utils'
+import type { ConnectorConfig, ExternalDocument, ExternalDocumentList } from '@/connectors/types'
+
+const logger = createLogger('{Service}Connector')
+
+export const {service}Connector: ConnectorConfig = {
+  id: '{service}',
+  name: '{Service}',
+  description: 'Sync documents from {Service} into your knowledge base',
+  version: '1.0.0',
+  icon: {Service}Icon,
+
+  auth: {
+    mode: 'oauth',
+    provider: '{service}',          // Must match OAuthService in lib/oauth/types.ts
+    requiredScopes: ['read:...'],
+  },
+
+  configFields: [
+    // Rendered dynamically by the add-connector modal UI
+    // Supports 'short-input' and 'dropdown' types
+  ],
+
+  listDocuments: async (accessToken, sourceConfig, cursor) => {
+    // Paginate via cursor, extract text, compute SHA-256 hash
+    // Return { documents: ExternalDocument[], nextCursor?, hasMore }
+  },
+
+  getDocument: async (accessToken, sourceConfig, externalId) => {
+    // Return ExternalDocument or null
+  },
+
+  validateConfig: async (accessToken, sourceConfig) => {
+    // Return { valid: true } or { valid: false, error: 'message' }
+  },
+
+  // Optional: map source metadata to semantic tag keys (translated to slots by sync engine)
+  mapTags: (metadata) => {
+    // Return Record<string, unknown> with keys matching tagDefinitions[].id
+  },
+}
+```
+
+### API key connector example
+
+```typescript
+export const {service}Connector: ConnectorConfig = {
+  id: '{service}',
+  name: '{Service}',
+  description: 'Sync documents from {Service} into your knowledge base',
+  version: '1.0.0',
+  icon: {Service}Icon,
+
+  auth: {
+    mode: 'apiKey',
+    label: 'API Key',                       // Shown above the input field
+    placeholder: 'Enter your {Service} API key',  // Input placeholder
+  },
+
+  configFields: [ /* ... */ ],
+  listDocuments: async (accessToken, sourceConfig, cursor) => { /* ... */ },
+  getDocument: async (accessToken, sourceConfig, externalId) => { /* ... */ },
+  validateConfig: async (accessToken, sourceConfig) => { /* ... */ },
+}
+```
+
+## ConfigField Types
+
+The add-connector modal renders these automatically — no custom UI needed.
+
+Three field types are supported: `short-input`, `dropdown`, and `selector`.
+
+```typescript
+// Text input
+{
+  id: 'domain',
+  title: 'Domain',
+  type: 'short-input',
+  placeholder: 'yoursite.example.com',
+  required: true,
+}
+
+// Dropdown (static options)
+{
+  id: 'contentType',
+  title: 'Content Type',
+  type: 'dropdown',
+  required: false,
+  options: [
+    { label: 'Pages only', id: 'page' },
+    { label: 'Blog posts only', id: 'blogpost' },
+    { label: 'All content', id: 'all' },
+  ],
+}
+```
+
+## Dynamic Selectors (Canonical Pairs)
+
+Use `type: 'selector'` to fetch options dynamically from the existing selector registry (`hooks/selectors/registry.ts`). Selectors are always paired with a manual fallback input using the **canonical pair** pattern — a `selector` field (basic mode) and a `short-input` field (advanced mode) linked by `canonicalParamId`.
+
+The user sees a toggle button (ArrowLeftRight) to switch between the selector dropdown and manual text input. On submit, the modal resolves each canonical pair to the active mode's value, keyed by `canonicalParamId`.
+
+### Rules
+
+1. **Every selector field MUST have a canonical pair** — a corresponding `short-input` (or `dropdown`) field with the same `canonicalParamId` and `mode: 'advanced'`.
+2. **`required` must be set identically on both fields** in a pair. If the selector is required, the manual input must also be required.
+3. **`canonicalParamId` must match the key the connector expects in `sourceConfig`** (e.g. `baseId`, `channel`, `teamId`). The advanced field's `id` should typically match `canonicalParamId`.
+4. **`dependsOn` references the selector field's `id`**, not the `canonicalParamId`. The modal propagates dependency clearing across canonical siblings automatically — changing either field in a parent pair clears dependent children.
+
+### Selector canonical pair example (Airtable base → table cascade)
+
+```typescript
+configFields: [
+  // Base: selector (basic) + manual (advanced)
+  {
+    id: 'baseSelector',
+    title: 'Base',
+    type: 'selector',
+    selectorKey: 'airtable.bases',     // Must exist in hooks/selectors/registry.ts
+    canonicalParamId: 'baseId',
+    mode: 'basic',
+    placeholder: 'Select a base',
+    required: true,
+  },
+  {
+    id: 'baseId',
+    title: 'Base ID',
+    type: 'short-input',
+    canonicalParamId: 'baseId',
+    mode: 'advanced',
+    placeholder: 'e.g. appXXXXXXXXXXXXXX',
+    required: true,
+  },
+  // Table: selector depends on base (basic) + manual (advanced)
+  {
+    id: 'tableSelector',
+    title: 'Table',
+    type: 'selector',
+    selectorKey: 'airtable.tables',
+    canonicalParamId: 'tableIdOrName',
+    mode: 'basic',
+    dependsOn: ['baseSelector'],       // References the selector field ID
+    placeholder: 'Select a table',
+    required: true,
+  },
+  {
+    id: 'tableIdOrName',
+    title: 'Table Name or ID',
+    type: 'short-input',
+    canonicalParamId: 'tableIdOrName',
+    mode: 'advanced',
+    placeholder: 'e.g. Tasks',
+    required: true,
+  },
+  // Non-selector fields stay as-is
+  { id: 'maxRecords', title: 'Max Records', type: 'short-input', ... },
+]
+```
+
+### Selector with domain dependency (Jira/Confluence pattern)
+
+When a selector depends on a plain `short-input` field (no canonical pair), `dependsOn` references that field's `id` directly. The `domain` field's value maps to `SelectorContext.domain` automatically via `SELECTOR_CONTEXT_FIELDS`.
+
+```typescript
+configFields: [
+  {
+    id: 'domain',
+    title: 'Jira Domain',
+    type: 'short-input',
+    placeholder: 'yoursite.atlassian.net',
+    required: true,
+  },
+  {
+    id: 'projectSelector',
+    title: 'Project',
+    type: 'selector',
+    selectorKey: 'jira.projects',
+    canonicalParamId: 'projectKey',
+    mode: 'basic',
+    dependsOn: ['domain'],
+    placeholder: 'Select a project',
+    required: true,
+  },
+  {
+    id: 'projectKey',
+    title: 'Project Key',
+    type: 'short-input',
+    canonicalParamId: 'projectKey',
+    mode: 'advanced',
+    placeholder: 'e.g. ENG, PROJ',
+    required: true,
+  },
+]
+```
+
+### How `dependsOn` maps to `SelectorContext`
+
+The connector selector field builds a `SelectorContext` from dependency values. For the mapping to work, each dependency's `canonicalParamId` (or field `id` for non-canonical fields) must exist in `SELECTOR_CONTEXT_FIELDS` (`lib/workflows/subblocks/context.ts`):
+
+```
+oauthCredential, domain, teamId, projectId, knowledgeBaseId, planId,
+siteId, collectionId, spreadsheetId, fileId, baseId, datasetId, serviceDeskId
+```
+
+### Available selector keys
+
+Check `hooks/selectors/types.ts` for the full `SelectorKey` union. Common ones for connectors:
+
+| SelectorKey | Context Deps | Returns |
+|-------------|-------------|---------|
+| `airtable.bases` | credential | Base ID + name |
+| `airtable.tables` | credential, `baseId` | Table ID + name |
+| `slack.channels` | credential | Channel ID + name |
+| `gmail.labels` | credential | Label ID + name |
+| `google.calendar` | credential | Calendar ID + name |
+| `linear.teams` | credential | Team ID + name |
+| `linear.projects` | credential, `teamId` | Project ID + name |
+| `jira.projects` | credential, `domain` | Project key + name |
+| `confluence.spaces` | credential, `domain` | Space key + name |
+| `notion.databases` | credential | Database ID + name |
+| `asana.workspaces` | credential | Workspace GID + name |
+| `microsoft.teams` | credential | Team ID + name |
+| `microsoft.channels` | credential, `teamId` | Channel ID + name |
+| `webflow.sites` | credential | Site ID + name |
+| `outlook.folders` | credential | Folder ID + name |
+
+## ExternalDocument Shape
+
+Every document returned from `listDocuments`/`getDocument` must include:
+
+```typescript
+{
+  externalId: string          // Source-specific unique ID
+  title: string               // Document title
+  content: string             // Extracted plain text
+  mimeType: 'text/plain'     // Always text/plain (content is extracted)
+  contentHash: string         // SHA-256 of content (change detection)
+  sourceUrl?: string          // Link back to original (stored on document record)
+  metadata?: Record<string, unknown>  // Source-specific data (fed to mapTags)
+}
+```
+
+## Content Hashing (Required)
+
+The sync engine uses content hashes for change detection:
+
+```typescript
+async function computeContentHash(content: string): Promise<string> {
+  const data = new TextEncoder().encode(content)
+  const hashBuffer = await crypto.subtle.digest('SHA-256', data)
+  return Array.from(new Uint8Array(hashBuffer)).map(b => b.toString(16).padStart(2, '0')).join('')
+}
+```
+
+## tagDefinitions — Declared Tag Definitions
+
+Declare which tags the connector populates using semantic IDs. Shown in the add-connector modal as opt-out checkboxes.
+On connector creation, slots are **dynamically assigned** via `getNextAvailableSlot` — connectors never hardcode slot names.
+
+```typescript
+tagDefinitions: [
+  { id: 'labels', displayName: 'Labels', fieldType: 'text' },
+  { id: 'version', displayName: 'Version', fieldType: 'number' },
+  { id: 'lastModified', displayName: 'Last Modified', fieldType: 'date' },
+],
+```
+
+Each entry has:
+- `id`: Semantic key matching a key returned by `mapTags` (e.g. `'labels'`, `'version'`)
+- `displayName`: Human-readable name shown in the UI (e.g. "Labels", "Last Modified")
+- `fieldType`: `'text'` | `'number'` | `'date'` | `'boolean'` — determines which slot pool to draw from
+
+Users can opt out of specific tags in the modal. Disabled IDs are stored in `sourceConfig.disabledTagIds`.
+The assigned mapping (`semantic id → slot`) is stored in `sourceConfig.tagSlotMapping`.
+
+## mapTags — Metadata to Semantic Keys
+
+Maps source metadata to semantic tag keys. Required if `tagDefinitions` is set.
+The sync engine calls this automatically and translates semantic keys to actual DB slots
+using the `tagSlotMapping` stored on the connector.
+
+Return keys must match the `id` values declared in `tagDefinitions`.
+
+```typescript
+mapTags: (metadata: Record<string, unknown>): Record<string, unknown> => {
+  const result: Record<string, unknown> = {}
+
+  // Validate arrays before casting — metadata may be malformed
+  const labels = Array.isArray(metadata.labels) ? (metadata.labels as string[]) : []
+  if (labels.length > 0) result.labels = labels.join(', ')
+
+  // Validate numbers — guard against NaN
+  if (metadata.version != null) {
+    const num = Number(metadata.version)
+    if (!Number.isNaN(num)) result.version = num
+  }
+
+  // Validate dates — guard against Invalid Date
+  if (typeof metadata.lastModified === 'string') {
+    const date = new Date(metadata.lastModified)
+    if (!Number.isNaN(date.getTime())) result.lastModified = date
+  }
+
+  return result
+}
+```
+
+## External API Calls — Use `fetchWithRetry`
+
+All external API calls must use `fetchWithRetry` from `@/lib/knowledge/documents/utils` instead of raw `fetch()`. This provides exponential backoff with retries on 429/502/503/504 errors. It returns a standard `Response` — all `.ok`, `.json()`, `.text()` checks work unchanged.
+
+For `validateConfig` (user-facing, called on save), pass `VALIDATE_RETRY_OPTIONS` to cap wait time at ~7s. Background operations (`listDocuments`, `getDocument`) use the built-in defaults (5 retries, ~31s max).
+
+```typescript
+import { VALIDATE_RETRY_OPTIONS, fetchWithRetry } from '@/lib/knowledge/documents/utils'
+
+// Background sync — use defaults
+const response = await fetchWithRetry(url, {
+  method: 'GET',
+  headers: { Authorization: `Bearer ${accessToken}` },
+})
+
+// validateConfig — tighter retry budget
+const response = await fetchWithRetry(url, { ... }, VALIDATE_RETRY_OPTIONS)
+```
+
+## sourceUrl
+
+If `ExternalDocument.sourceUrl` is set, the sync engine stores it on the document record. Always construct the full URL (not a relative path).
+
+## Sync Engine Behavior (Do Not Modify)
+
+The sync engine (`lib/knowledge/connectors/sync-engine.ts`) is connector-agnostic. It:
+1. Calls `listDocuments` with pagination until `hasMore` is false
+2. Compares `contentHash` to detect new/changed/unchanged documents
+3. Stores `sourceUrl` and calls `mapTags` on insert/update automatically
+4. Handles soft-delete of removed documents
+5. Resolves access tokens automatically — OAuth tokens are refreshed, API keys are decrypted from the `encryptedApiKey` column
+
+You never need to modify the sync engine when adding a connector.
+
+## Icon
+
+The `icon` field on `ConnectorConfig` is used throughout the UI — in the connector list, the add-connector modal, and as the document icon in the knowledge base table (replacing the generic file type icon for connector-sourced documents). The icon is read from `CONNECTOR_REGISTRY[connectorType].icon` at runtime — no separate icon map to maintain.
+
+If the service already has an icon in `apps/sim/components/icons.tsx` (from a tool integration), reuse it. Otherwise, ask the user to provide the SVG.
+
+## Registering
+
+Add one line to `apps/sim/connectors/registry.ts`:
+
+```typescript
+import { {service}Connector } from '@/connectors/{service}'
+
+export const CONNECTOR_REGISTRY: ConnectorRegistry = {
+  // ... existing connectors ...
+  {service}: {service}Connector,
+}
+```
+
+## Reference Implementations
+
+- **OAuth**: `apps/sim/connectors/confluence/confluence.ts` — multiple config field types, `mapTags`, label fetching
+- **API key**: `apps/sim/connectors/fireflies/fireflies.ts` — GraphQL API with Bearer token auth
+
+## Checklist
+
+- [ ] Created `connectors/{service}/{service}.ts` with full ConnectorConfig
+- [ ] Created `connectors/{service}/index.ts` barrel export
+- [ ] **Auth configured correctly:**
+  - OAuth: `auth.provider` matches an existing `OAuthService` in `lib/oauth/types.ts`
+  - API key: `auth.label` and `auth.placeholder` set appropriately
+- [ ] **Selector fields configured correctly (if applicable):**
+  - Every `type: 'selector'` field has a canonical pair (`short-input` or `dropdown` with same `canonicalParamId` and `mode: 'advanced'`)
+  - `required` is identical on both fields in each canonical pair
+  - `selectorKey` exists in `hooks/selectors/registry.ts`
+  - `dependsOn` references selector field IDs (not `canonicalParamId`)
+  - Dependency `canonicalParamId` values exist in `SELECTOR_CONTEXT_FIELDS`
+- [ ] `listDocuments` handles pagination and computes content hashes
+- [ ] `sourceUrl` set on each ExternalDocument (full URL, not relative)
+- [ ] `metadata` includes source-specific data for tag mapping
+- [ ] `tagDefinitions` declared for each semantic key returned by `mapTags`
+- [ ] `mapTags` implemented if source has useful metadata (labels, dates, versions)
+- [ ] `validateConfig` verifies the source is accessible
+- [ ] All external API calls use `fetchWithRetry` (not raw `fetch`)
+- [ ] All optional config fields validated in `validateConfig`
+- [ ] Icon exists in `components/icons.tsx` (or asked user to provide SVG)
+- [ ] Registered in `connectors/registry.ts`

.claude/commands/add-integration.md

@@ -102,6 +102,7 @@ export const {service}{Action}Tool: ToolConfig<Params, Response> = {
 - Always use `?? []` for optional array fields
 - Set `optional: true` for outputs that may not exist
 - Never output raw JSON dumps - extract meaningful fields
+- When using `type: 'json'` and you know the object shape, define `properties` with the inner fields so downstream consumers know the structure. Only use bare `type: 'json'` when the shape is truly dynamic
 
 ## Step 3: Create Block
 
@@ -113,6 +114,7 @@ export const {service}{Action}Tool: ToolConfig<Params, Response> = {
 import { {Service}Icon } from '@/components/icons'
 import type { BlockConfig } from '@/blocks/types'
 import { AuthMode } from '@/blocks/types'
+import { getScopesForService } from '@/lib/oauth/utils'
 
 export const {Service}Block: BlockConfig = {
   type: '{service}',
@@ -143,6 +145,7 @@ export const {Service}Block: BlockConfig = {
       title: '{Service} Account',
       type: 'oauth-input',
       serviceId: '{service}',
+      requiredScopes: getScopesForService('{service}'),
       required: true,
     },
     // Conditional fields per operation
@@ -408,7 +411,7 @@ If creating V2 versions (API-aligned outputs):
 ### Block
 - [ ] Created `blocks/blocks/{service}.ts`
 - [ ] Defined operation dropdown with all operations
-- [ ] Added credential field (oauth-input or short-input)
+- [ ] Added credential field with `requiredScopes: getScopesForService('{service}')`
 - [ ] Added conditional fields per operation
 - [ ] Set up dependsOn for cascading selectors
 - [ ] Configured tools.access with all tool IDs
@@ -418,6 +421,12 @@ If creating V2 versions (API-aligned outputs):
 - [ ] If triggers: set `triggers.enabled` and `triggers.available`
 - [ ] If triggers: spread trigger subBlocks with `getTrigger()`
 
+### OAuth Scopes (if OAuth service)
+- [ ] Defined scopes in `lib/oauth/oauth.ts` under `OAUTH_PROVIDERS`
+- [ ] Added scope descriptions in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts`
+- [ ] Used `getCanonicalScopesForProvider()` in `auth.ts` (never hardcode)
+- [ ] Used `getScopesForService()` in block `requiredScopes` (never hardcode)
+
 ### Icon
 - [ ] Asked user to provide SVG
 - [ ] Added icon to `components/icons.tsx`
@@ -436,6 +445,12 @@ If creating V2 versions (API-aligned outputs):
 - [ ] Ran `bun run scripts/generate-docs.ts`
 - [ ] Verified docs file created
 
+### Final Validation (Required)
+- [ ] Read every tool file and cross-referenced inputs/outputs against the API docs
+- [ ] Verified block subBlocks cover all required tool params with correct conditions
+- [ ] Verified block outputs match what the tools actually return
+- [ ] Verified `tools.config.params` correctly maps and coerces all param types
+
 ## Example Command
 
 When the user asks to add an integration:
@@ -685,13 +700,61 @@ return NextResponse.json({
 | `isUserFile` | `@/lib/core/utils/user-file` | Type guard for UserFile objects |
 | `FileInputSchema` | `@/lib/uploads/utils/file-schemas` | Zod schema for file validation |
 
+### Advanced Mode for Optional Fields
+
+Optional fields that are rarely used should be set to `mode: 'advanced'` so they don't clutter the basic UI. Examples: pagination tokens, time range filters, sort order, max results, reply settings.
+
+### WandConfig for Complex Inputs
+
+Use `wandConfig` for fields that are hard to fill out manually:
+- **Timestamps**: Use `generationType: 'timestamp'` to inject current date context into the AI prompt
+- **JSON arrays**: Use `generationType: 'json-object'` for structured data
+- **Complex queries**: Use a descriptive prompt explaining the expected format
+
+```typescript
+{
+  id: 'startTime',
+  title: 'Start Time',
+  type: 'short-input',
+  mode: 'advanced',
+  wandConfig: {
+    enabled: true,
+    prompt: 'Generate an ISO 8601 timestamp. Return ONLY the timestamp string.',
+    generationType: 'timestamp',
+  },
+}
+```
+
+### OAuth Scopes (Centralized System)
+
+Scopes are maintained in a single source of truth and reused everywhere:
+
+1. **Define scopes** in `lib/oauth/oauth.ts` under `OAUTH_PROVIDERS[provider].services[service].scopes`
+2. **Add descriptions** in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts` for the OAuth modal UI
+3. **Reference in auth.ts** using `getCanonicalScopesForProvider(providerId)` from `@/lib/oauth/utils`
+4. **Reference in blocks** using `getScopesForService(serviceId)` from `@/lib/oauth/utils`
+
+**Never hardcode scope arrays** in `auth.ts` or block `requiredScopes`. Always import from the centralized source.
+
+```typescript
+// In auth.ts (Better Auth config)
+scopes: getCanonicalScopesForProvider('{service}'),
+
+// In block credential sub-block
+requiredScopes: getScopesForService('{service}'),
+```
+
 ### Common Gotchas
 
 1. **OAuth serviceId must match** - The `serviceId` in oauth-input must match the OAuth provider configuration
-2. **Tool IDs are snake_case** - `stripe_create_payment`, not `stripeCreatePayment`
+2. **All tool IDs MUST be snake_case** - `stripe_create_payment`, not `stripeCreatePayment`. This applies to tool `id` fields, registry keys, `tools.access` arrays, and `tools.config.tool` return values
 3. **Block type is snake_case** - `type: 'stripe'`, not `type: 'Stripe'`
 4. **Alphabetical ordering** - Keep imports and registry entries alphabetically sorted
 5. **Required can be conditional** - Use `required: { field: 'op', value: 'create' }` instead of always true
 6. **DependsOn clears options** - When a dependency changes, selector options are refetched
 7. **Never pass Buffer directly to fetch** - Convert to `new Uint8Array(buffer)` for TypeScript compatibility
 8. **Always handle legacy file params** - Keep hidden `fileContent` params for backwards compatibility
+9. **Optional fields use advanced mode** - Set `mode: 'advanced'` on rarely-used optional fields
+10. **Complex inputs need wandConfig** - Timestamps, JSON arrays, and other hard-to-type values should have `wandConfig` enabled
+11. **Never hardcode scopes** - Use `getScopesForService()` in blocks and `getCanonicalScopesForProvider()` in auth.ts
+12. **Always add scope descriptions** - New scopes must have entries in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts`

.claude/commands/add-tools.md

@@ -147,9 +147,18 @@ closedAt: {
 },
 ```
 
-### Nested Properties
-For complex outputs, define nested structure:
+### Typed JSON Outputs
+
+When using `type: 'json'` and you know the object shape in advance, **always define the inner structure** using `properties` so downstream consumers know what fields are available:
+
 ```typescript
+// BAD: Opaque json with no info about what's inside
+metadata: {
+  type: 'json',
+  description: 'Response metadata',
+},
+
+// GOOD: Define the known properties
 metadata: {
   type: 'json',
   description: 'Response metadata',
@@ -159,7 +168,10 @@ metadata: {
     count: { type: 'number', description: 'Total count' },
   },
 },
+```
 
+For arrays of objects, define the item structure:
+```typescript
 items: {
   type: 'array',
   description: 'List of items',
@@ -173,6 +185,8 @@ items: {
 },
 ```
 
+Only use bare `type: 'json'` without `properties` when the shape is truly dynamic or unknown.
+
 ## Critical Rules for transformResponse
 
 ### Handle Nullable Fields
@@ -272,8 +286,13 @@ If creating V2 tools (API-aligned outputs), use `_v2` suffix:
 - Version: `'2.0.0'`
 - Outputs: Flat, API-aligned (no content/metadata wrapper)
 
+## Naming Convention
+
+All tool IDs MUST use `snake_case`: `{service}_{action}` (e.g., `x_create_tweet`, `slack_send_message`). Never use camelCase or PascalCase for tool IDs.
+
 ## Checklist Before Finishing
 
+- [ ] All tool IDs use snake_case
 - [ ] All params have explicit `required: true` or `required: false`
 - [ ] All params have appropriate `visibility`
 - [ ] All nullable response fields use `?? null`
@@ -281,4 +300,22 @@ If creating V2 tools (API-aligned outputs), use `_v2` suffix:
 - [ ] No raw JSON dumps in outputs
 - [ ] Types file has all interfaces
 - [ ] Index.ts exports all tools
-- [ ] Tool IDs use snake_case
+
+## Final Validation (Required)
+
+After creating all tools, you MUST validate every tool before finishing:
+
+1. **Read every tool file** you created — do not skip any
+2. **Cross-reference with the API docs** to verify:
+   - All required params are marked `required: true`
+   - All optional params are marked `required: false`
+   - Param types match the API (string, number, boolean, json)
+   - Request URL, method, headers, and body match the API spec
+   - `transformResponse` extracts the correct fields from the API response
+   - All output fields match what the API actually returns
+   - No fields are missing from outputs that the API provides
+   - No extra fields are defined in outputs that the API doesn't return
+3. **Verify consistency** across tools:
+   - Shared types in `types.ts` match all tools that use them
+   - Tool IDs in the barrel export match the tool file definitions
+   - Error handling is consistent (error checks, meaningful messages)

.claude/commands/validate-integration.md

@@ -0,0 +1,289 @@
+---
+description: Validate an existing Sim integration (tools, block, registry) against the service's API docs
+argument-hint: <service-name> [api-docs-url]
+---
+
+# Validate Integration Skill
+
+You are an expert auditor for Sim integrations. Your job is to thoroughly validate that an existing integration is correct, complete, and follows all conventions.
+
+## Your Task
+
+When the user asks you to validate an integration:
+1. Read the service's API documentation (via WebFetch or Context7)
+2. Read every tool, the block, and registry entries
+3. Cross-reference everything against the API docs and Sim conventions
+4. Report all issues found, grouped by severity (critical, warning, suggestion)
+5. Fix all issues after reporting them
+
+## Step 1: Gather All Files
+
+Read **every** file for the integration — do not skip any:
+
+```
+apps/sim/tools/{service}/          # All tool files, types.ts, index.ts
+apps/sim/blocks/blocks/{service}.ts # Block definition
+apps/sim/tools/registry.ts          # Tool registry entries for this service
+apps/sim/blocks/registry.ts         # Block registry entry for this service
+apps/sim/components/icons.tsx        # Icon definition
+apps/sim/lib/auth/auth.ts           # OAuth config — should use getCanonicalScopesForProvider()
+apps/sim/lib/oauth/oauth.ts         # OAuth provider config — single source of truth for scopes
+apps/sim/lib/oauth/utils.ts               # Scope utilities, SCOPE_DESCRIPTIONS for modal UI
+```
+
+## Step 2: Pull API Documentation
+
+Fetch the official API docs for the service. This is the **source of truth** for:
+- Endpoint URLs, HTTP methods, and auth headers
+- Required vs optional parameters
+- Parameter types and allowed values
+- Response shapes and field names
+- Pagination patterns (which param name, which response field)
+- Rate limits and error formats
+
+## Step 3: Validate Tools
+
+For **every** tool file, check:
+
+### Tool ID and Naming
+- [ ] Tool ID uses `snake_case`: `{service}_{action}` (e.g., `x_create_tweet`, `slack_send_message`)
+- [ ] Tool `name` is human-readable (e.g., `'X Create Tweet'`)
+- [ ] Tool `description` is a concise one-liner describing what it does
+- [ ] Tool `version` is set (`'1.0.0'` or `'2.0.0'` for V2)
+
+### Params
+- [ ] All required API params are marked `required: true`
+- [ ] All optional API params are marked `required: false`
+- [ ] Every param has explicit `required: true` or `required: false` — never omitted
+- [ ] Param types match the API (`'string'`, `'number'`, `'boolean'`, `'json'`)
+- [ ] Visibility is correct:
+  - `'hidden'` — ONLY for OAuth access tokens and system-injected params
+  - `'user-only'` — for API keys, credentials, and account-specific IDs the user must provide
+  - `'user-or-llm'` — for everything else (search queries, content, filters, IDs that could come from other blocks)
+- [ ] Every param has a `description` that explains what it does
+
+### Request
+- [ ] URL matches the API endpoint exactly (correct base URL, path segments, path params)
+- [ ] HTTP method matches the API spec (GET, POST, PUT, PATCH, DELETE)
+- [ ] Headers include correct auth pattern:
+  - OAuth: `Authorization: Bearer ${params.accessToken}`
+  - API Key: correct header name and format per the service's docs
+- [ ] `Content-Type` header is set for POST/PUT/PATCH requests
+- [ ] Body sends all required fields and only includes optional fields when provided
+- [ ] For GET requests with query params: URL is constructed correctly with query string
+- [ ] ID fields in URL paths are `.trim()`-ed to prevent copy-paste whitespace errors
+- [ ] Path params use template literals correctly: `` `https://api.service.com/v1/${params.id.trim()}` ``
+
+### Response / transformResponse
+- [ ] Correctly parses the API response (`await response.json()`)
+- [ ] Extracts the right fields from the response structure (e.g., `data.data` vs `data` vs `data.results`)
+- [ ] All nullable fields use `?? null`
+- [ ] All optional arrays use `?? []`
+- [ ] Error cases are handled: checks for missing/empty data and returns meaningful error
+- [ ] Does NOT do raw JSON dumps — extracts meaningful, individual fields
+
+### Outputs
+- [ ] All output fields match what the API actually returns
+- [ ] No fields are missing that the API provides and users would commonly need
+- [ ] No phantom fields defined that the API doesn't return
+- [ ] `optional: true` is set on fields that may not exist in all responses
+- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields
+- [ ] When using `type: 'array'`, `items` defines the item structure with `properties`
+- [ ] Field descriptions are accurate and helpful
+
+### Types (types.ts)
+- [ ] Has param interfaces for every tool (e.g., `XCreateTweetParams`)
+- [ ] Has response interfaces for every tool (extending `ToolResponse`)
+- [ ] Optional params use `?` in the interface (e.g., `replyTo?: string`)
+- [ ] Field names in types match actual API field names
+- [ ] Shared response types are properly reused (e.g., `XTweetResponse` shared across tweet tools)
+
+### Barrel Export (index.ts)
+- [ ] Every tool is exported
+- [ ] All types are re-exported (`export * from './types'`)
+- [ ] No orphaned exports (tools that don't exist)
+
+### Tool Registry (tools/registry.ts)
+- [ ] Every tool is imported and registered
+- [ ] Registry keys use snake_case and match tool IDs exactly
+- [ ] Entries are in alphabetical order within the file
+
+## Step 4: Validate Block
+
+### Block ↔ Tool Alignment (CRITICAL)
+
+This is the most important validation — the block must be perfectly aligned with every tool it references.
+
+For **each tool** in `tools.access`:
+- [ ] The operation dropdown has an option whose ID matches the tool ID (or the `tools.config.tool` function correctly maps to it)
+- [ ] Every **required** tool param (except `accessToken`) has a corresponding subBlock input that is:
+  - Shown when that operation is selected (correct `condition`)
+  - Marked as `required: true` (or conditionally required)
+- [ ] Every **optional** tool param has a corresponding subBlock input (or is intentionally omitted if truly never needed)
+- [ ] SubBlock `id` values are unique across the entire block — no duplicates even across different conditions
+- [ ] The `tools.config.tool` function returns the correct tool ID for every possible operation value
+- [ ] The `tools.config.params` function correctly maps subBlock IDs to tool param names when they differ
+
+### SubBlocks
+- [ ] Operation dropdown lists ALL tool operations available in `tools.access`
+- [ ] Dropdown option labels are human-readable and descriptive
+- [ ] Conditions use correct syntax:
+  - Single value: `{ field: 'operation', value: 'x_create_tweet' }`
+  - Multiple values (OR): `{ field: 'operation', value: ['x_create_tweet', 'x_delete_tweet'] }`
+  - Negation: `{ field: 'operation', value: 'delete', not: true }`
+  - Compound: `{ field: 'op', value: 'send', and: { field: 'type', value: 'dm' } }`
+- [ ] Condition arrays include ALL operations that use that field — none missing
+- [ ] `dependsOn` is set for fields that need other values (selectors depending on credential, cascading dropdowns)
+- [ ] SubBlock types match tool param types:
+  - Enum/fixed options → `dropdown`
+  - Free text → `short-input`
+  - Long text/content → `long-input`
+  - True/false → `dropdown` with Yes/No options (not `switch` unless purely UI toggle)
+  - Credentials → `oauth-input` with correct `serviceId`
+- [ ] Dropdown `value: () => 'default'` is set for dropdowns with a sensible default
+
+### Advanced Mode
+- [ ] Optional, rarely-used fields are set to `mode: 'advanced'`:
+  - Pagination tokens / next tokens
+  - Time range filters (start/end time)
+  - Sort order / direction options
+  - Max results / per page limits
+  - Reply settings / threading options
+  - Rarely used IDs (reply-to, quote-tweet, etc.)
+  - Exclude filters
+- [ ] **Required** fields are NEVER set to `mode: 'advanced'`
+- [ ] Fields that users fill in most of the time are NOT set to `mode: 'advanced'`
+
+### WandConfig
+- [ ] Timestamp fields have `wandConfig` with `generationType: 'timestamp'`
+- [ ] Comma-separated list fields have `wandConfig` with a descriptive prompt
+- [ ] Complex filter/query fields have `wandConfig` with format examples in the prompt
+- [ ] All `wandConfig` prompts end with "Return ONLY the [format] - no explanations, no extra text."
+- [ ] `wandConfig.placeholder` describes what to type in natural language
+
+### Tools Config
+- [ ] `tools.access` lists **every** tool ID the block can use — none missing
+- [ ] `tools.config.tool` returns the correct tool ID for each operation
+- [ ] Type coercions are in `tools.config.params` (runs at execution time), NOT in `tools.config.tool` (runs at serialization time before variable resolution)
+- [ ] `tools.config.params` handles:
+  - `Number()` conversion for numeric params that come as strings from inputs
+  - `Boolean` / string-to-boolean conversion for toggle params
+  - Empty string → `undefined` conversion for optional dropdown values
+  - Any subBlock ID → tool param name remapping
+- [ ] No `Number()`, `JSON.parse()`, or other coercions in `tools.config.tool` — these would destroy dynamic references like `<Block.output>`
+
+### Block Outputs
+- [ ] Outputs cover the key fields returned by ALL tools (not just one operation)
+- [ ] Output types are correct (`'string'`, `'number'`, `'boolean'`, `'json'`)
+- [ ] `type: 'json'` outputs either:
+  - Describe inner fields in the description string (GOOD): `'User profile (id, name, username, bio)'`
+  - Use nested output definitions (BEST): `{ id: { type: 'string' }, name: { type: 'string' } }`
+- [ ] No opaque `type: 'json'` with vague descriptions like `'Response data'`
+- [ ] Outputs that only appear for certain operations use `condition` if supported, or document which operations return them
+
+### Block Metadata
+- [ ] `type` is snake_case (e.g., `'x'`, `'cloudflare'`)
+- [ ] `name` is human-readable (e.g., `'X'`, `'Cloudflare'`)
+- [ ] `description` is a concise one-liner
+- [ ] `longDescription` provides detail for docs
+- [ ] `docsLink` points to `'https://docs.sim.ai/tools/{service}'`
+- [ ] `category` is `'tools'`
+- [ ] `bgColor` uses the service's brand color hex
+- [ ] `icon` references the correct icon component from `@/components/icons`
+- [ ] `authMode` is set correctly (`AuthMode.OAuth` or `AuthMode.ApiKey`)
+- [ ] Block is registered in `blocks/registry.ts` alphabetically
+
+### Block Inputs
+- [ ] `inputs` section lists all subBlock params that the block accepts
+- [ ] Input types match the subBlock types
+- [ ] When using `canonicalParamId`, inputs list the canonical ID (not the raw subBlock IDs)
+
+## Step 5: Validate OAuth Scopes (if OAuth service)
+
+Scopes are centralized — the single source of truth is `OAUTH_PROVIDERS` in `lib/oauth/oauth.ts`.
+
+- [ ] Scopes defined in `lib/oauth/oauth.ts` under `OAUTH_PROVIDERS[provider].services[service].scopes`
+- [ ] `auth.ts` uses `getCanonicalScopesForProvider(providerId)` — NOT a hardcoded array
+- [ ] Block `requiredScopes` uses `getScopesForService(serviceId)` — NOT a hardcoded array
+- [ ] No hardcoded scope arrays in `auth.ts` or block files (should all use utility functions)
+- [ ] Each scope has a human-readable description in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts`
+- [ ] No excess scopes that aren't needed by any tool
+
+## Step 6: Validate Pagination Consistency
+
+If any tools support pagination:
+- [ ] Pagination param names match the API docs (e.g., `pagination_token` vs `next_token` vs `cursor`)
+- [ ] Different API endpoints that use different pagination param names have separate subBlocks in the block
+- [ ] Pagination response fields (`nextToken`, `cursor`, etc.) are included in tool outputs
+- [ ] Pagination subBlocks are set to `mode: 'advanced'`
+
+## Step 7: Validate Error Handling
+
+- [ ] `transformResponse` checks for error conditions before accessing data
+- [ ] Error responses include meaningful messages (not just generic "failed")
+- [ ] HTTP error status codes are handled (check `response.ok` or status codes)
+
+## Step 8: Report and Fix
+
+### Report Format
+
+Group findings by severity:
+
+**Critical** (will cause runtime errors or incorrect behavior):
+- Wrong endpoint URL or HTTP method
+- Missing required params or wrong `required` flag
+- Incorrect response field mapping (accessing wrong path in response)
+- Missing error handling that would cause crashes
+- Tool ID mismatch between tool file, registry, and block `tools.access`
+- OAuth scopes missing in `auth.ts` that tools need
+- `tools.config.tool` returning wrong tool ID for an operation
+- Type coercions in `tools.config.tool` instead of `tools.config.params`
+
+**Warning** (follows conventions incorrectly or has usability issues):
+- Optional field not set to `mode: 'advanced'`
+- Missing `wandConfig` on timestamp/complex fields
+- Wrong `visibility` on params (e.g., `'hidden'` instead of `'user-or-llm'`)
+- Missing `optional: true` on nullable outputs
+- Opaque `type: 'json'` without property descriptions
+- Missing `.trim()` on ID fields in request URLs
+- Missing `?? null` on nullable response fields
+- Block condition array missing an operation that uses that field
+- Hardcoded scope arrays instead of using `getScopesForService()` / `getCanonicalScopesForProvider()`
+- Missing scope description in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts`
+
+**Suggestion** (minor improvements):
+- Better description text
+- Inconsistent naming across tools
+- Missing `longDescription` or `docsLink`
+- Pagination fields that could benefit from `wandConfig`
+
+### Fix All Issues
+
+After reporting, fix every **critical** and **warning** issue. Apply **suggestions** where they don't add unnecessary complexity.
+
+### Validation Output
+
+After fixing, confirm:
+1. `bun run lint` passes with no fixes needed
+2. TypeScript compiles clean (no type errors)
+3. Re-read all modified files to verify fixes are correct
+
+## Checklist Summary
+
+- [ ] Read ALL tool files, block, types, index, and registries
+- [ ] Pulled and read official API documentation
+- [ ] Validated every tool's ID, params, request, response, outputs, and types against API docs
+- [ ] Validated block ↔ tool alignment (every tool param has a subBlock, every condition is correct)
+- [ ] Validated advanced mode on optional/rarely-used fields
+- [ ] Validated wandConfig on timestamps and complex inputs
+- [ ] Validated tools.config mapping, tool selector, and type coercions
+- [ ] Validated block outputs match what tools return, with typed JSON where possible
+- [ ] Validated OAuth scopes use centralized utilities (getScopesForService, getCanonicalScopesForProvider) — no hardcoded arrays
+- [ ] Validated scope descriptions exist in `SCOPE_DESCRIPTIONS` within `lib/oauth/utils.ts` for all scopes
+- [ ] Validated pagination consistency across tools and block
+- [ ] Validated error handling (error checks, meaningful messages)
+- [ ] Validated registry entries (tools and block, alphabetical, correct imports)
+- [ ] Reported all issues grouped by severity
+- [ ] Fixed all critical and warning issues
+- [ ] Ran `bun run lint` after fixes
+- [ ] Verified TypeScript compiles clean

.claude/rules/sim-testing.md

@@ -8,51 +8,210 @@ paths:
 
 Use Vitest. Test files: `feature.ts` → `feature.test.ts`
 
+## Global Mocks (vitest.setup.ts)
+
+These modules are mocked globally — do NOT re-mock them in test files unless you need to override behavior:
+
+- `@sim/db` → `databaseMock`
+- `drizzle-orm` → `drizzleOrmMock`
+- `@sim/logger` → `loggerMock`
+- `@/stores/console/store`, `@/stores/terminal`, `@/stores/execution/store`
+- `@/blocks/registry`
+- `@trigger.dev/sdk`
+
 ## Structure
 
 ```typescript
 /**
  * @vitest-environment node
  */
-import { databaseMock, loggerMock } from '@sim/testing'
-import { describe, expect, it, vi } from 'vitest'
+import { createMockRequest } from '@sim/testing'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
-vi.mock('@sim/db', () => databaseMock)
-vi.mock('@sim/logger', () => loggerMock)
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
 
-import { myFunction } from '@/lib/feature'
+vi.mock('@/lib/auth', () => ({
+  auth: { api: { getSession: vi.fn() } },
+  getSession: mockGetSession,
+}))
 
-describe('myFunction', () => {
-  beforeEach(() => vi.clearAllMocks())
-  it.concurrent('isolated tests run in parallel', () => { ... })
+import { GET, POST } from '@/app/api/my-route/route'
+
+describe('my route', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    mockGetSession.mockResolvedValue({ user: { id: 'user-1' } })
+  })
+
+  it('returns data', async () => {
+    const req = createMockRequest('GET')
+    const res = await GET(req)
+    expect(res.status).toBe(200)
+  })
+})
+```
+
+## Performance Rules (Critical)
+
+### NEVER use `vi.resetModules()` + `vi.doMock()` + `await import()`
+
+This is the #1 cause of slow tests. It forces complete module re-evaluation per test.
+
+```typescript
+// BAD — forces module re-evaluation every test (~50-100ms each)
+beforeEach(() => {
+  vi.resetModules()
+  vi.doMock('@/lib/auth', () => ({ getSession: vi.fn() }))
+})
+it('test', async () => {
+  const { GET } = await import('./route')  // slow dynamic import
+})
+
+// GOOD — module loaded once, mocks reconfigured per test (~1ms each)
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
+vi.mock('@/lib/auth', () => ({ getSession: mockGetSession }))
+import { GET } from '@/app/api/my-route/route'
+
+beforeEach(() => { vi.clearAllMocks() })
+it('test', () => {
+  mockGetSession.mockResolvedValue({ user: { id: '1' } })
+})
+```
+
+**Only exception:** Singleton modules that cache state at module scope (e.g., Redis clients, connection pools). These genuinely need `vi.resetModules()` + dynamic import to get a fresh instance per test.
+
+### NEVER use `vi.importActual()`
+
+This defeats the purpose of mocking by loading the real module and all its dependencies.
+
+```typescript
+// BAD — loads real module + all transitive deps
+vi.mock('@/lib/workspaces/utils', async () => {
+  const actual = await vi.importActual('@/lib/workspaces/utils')
+  return { ...actual, myFn: vi.fn() }
+})
+
+// GOOD — mock everything, only implement what tests need
+vi.mock('@/lib/workspaces/utils', () => ({
+  myFn: vi.fn(),
+  otherFn: vi.fn(),
+}))
+```
+
+### NEVER use `mockAuth()`, `mockConsoleLogger()`, or `setupCommonApiMocks()` from `@sim/testing`
+
+These helpers internally use `vi.doMock()` which is slow. Use direct `vi.hoisted()` + `vi.mock()` instead.
+
+### Mock heavy transitive dependencies
+
+If a module under test imports `@/blocks` (200+ files), `@/tools/registry`, or other heavy modules, mock them:
+
+```typescript
+vi.mock('@/blocks', () => ({
+  getBlock: () => null,
+  getAllBlocks: () => ({}),
+  getAllBlockTypes: () => [],
+  registry: {},
+}))
+```
+
+### Use `@vitest-environment node` unless DOM is needed
+
+Only use `@vitest-environment jsdom` if the test uses `window`, `document`, `FormData`, or other browser APIs. Node environment is significantly faster.
+
+### Avoid real timers in tests
+
+```typescript
+// BAD
+await new Promise(r => setTimeout(r, 500))
+
+// GOOD — use minimal delays or fake timers
+await new Promise(r => setTimeout(r, 1))
+// or
+vi.useFakeTimers()
+```
+
+## Mock Pattern Reference
+
+### Auth mocking (API routes)
+
+```typescript
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
+
+vi.mock('@/lib/auth', () => ({
+  auth: { api: { getSession: vi.fn() } },
+  getSession: mockGetSession,
+}))
+
+// In tests:
+mockGetSession.mockResolvedValue({ user: { id: 'user-1', email: 'test@example.com' } })
+mockGetSession.mockResolvedValue(null) // unauthenticated
+```
+
+### Hybrid auth mocking
+
+```typescript
+const { mockCheckSessionOrInternalAuth } = vi.hoisted(() => ({
+  mockCheckSessionOrInternalAuth: vi.fn(),
+}))
+
+vi.mock('@/lib/auth/hybrid', () => ({
+  checkSessionOrInternalAuth: mockCheckSessionOrInternalAuth,
+}))
+
+// In tests:
+mockCheckSessionOrInternalAuth.mockResolvedValue({
+  success: true, userId: 'user-1', authType: 'session',
+})
+```
+
+### Database chain mocking
+
+```typescript
+const { mockSelect, mockFrom, mockWhere } = vi.hoisted(() => ({
+  mockSelect: vi.fn(),
+  mockFrom: vi.fn(),
+  mockWhere: vi.fn(),
+}))
+
+vi.mock('@sim/db', () => ({
+  db: { select: mockSelect },
+}))
+
+beforeEach(() => {
+  mockSelect.mockReturnValue({ from: mockFrom })
+  mockFrom.mockReturnValue({ where: mockWhere })
+  mockWhere.mockResolvedValue([{ id: '1', name: 'test' }])
 })
 ```
 
 ## @sim/testing Package
 
-Always prefer over local mocks.
+Always prefer over local test data.
 
 | Category | Utilities |
 |----------|-----------|
-| **Mocks** | `loggerMock`, `databaseMock`, `setupGlobalFetchMock()` |
-| **Factories** | `createSession()`, `createWorkflowRecord()`, `createBlock()`, `createExecutorContext()` |
+| **Mocks** | `loggerMock`, `databaseMock`, `drizzleOrmMock`, `setupGlobalFetchMock()` |
+| **Factories** | `createSession()`, `createWorkflowRecord()`, `createBlock()`, `createExecutionContext()` |
 | **Builders** | `WorkflowBuilder`, `ExecutionContextBuilder` |
 | **Assertions** | `expectWorkflowAccessGranted()`, `expectBlockExecuted()` |
+| **Requests** | `createMockRequest()`, `createEnvMock()` |
 
-## Rules
+## Rules Summary
 
-1. `@vitest-environment node` directive at file top
-2. `vi.mock()` calls before importing mocked modules
-3. `@sim/testing` utilities over local mocks
-4. `it.concurrent` for isolated tests (no shared mutable state)
-5. `beforeEach(() => vi.clearAllMocks())` to reset state
-
-## Hoisted Mocks
-
-For mutable mock references:
-
-```typescript
-const mockFn = vi.hoisted(() => vi.fn())
-vi.mock('@/lib/module', () => ({ myFunction: mockFn }))
-mockFn.mockResolvedValue({ data: 'test' })
-```
+1. `@vitest-environment node` unless DOM is required
+2. `vi.hoisted()` + `vi.mock()` + static imports — never `vi.resetModules()` + `vi.doMock()` + dynamic imports
+3. `vi.mock()` calls before importing mocked modules
+4. `@sim/testing` utilities over local mocks
+5. `beforeEach(() => vi.clearAllMocks())` to reset state — no redundant `afterEach`
+6. No `vi.importActual()` — mock everything explicitly
+7. No `mockAuth()`, `mockConsoleLogger()`, `setupCommonApiMocks()` — use direct mocks
+8. Mock heavy deps (`@/blocks`, `@/tools/registry`, `@/triggers`) in tests that don't need them
+9. Use absolute imports in test files
+10. Avoid real timers — use 1ms delays or `vi.useFakeTimers()`

.cursor/rules/landing-seo-geo.mdc

@@ -0,0 +1,26 @@
+---
+description: SEO and GEO guidelines for the landing page
+globs: ["apps/sim/app/(home)/**/*.tsx"]
+---
+
+# Landing Page — SEO / GEO
+
+## SEO
+
+- One `<h1>` per page, in Hero only — never add another.
+- Strict heading hierarchy: H1 (Hero) → H2 (section titles) → H3 (feature names).
+- Every section: `<section id="…" aria-labelledby="…-heading">`.
+- Decorative/animated elements: `aria-hidden="true"`.
+- All internal routes use Next.js `<Link>` (crawlable). External links get `rel="noopener noreferrer"`.
+- Navbar is a Server Component (no `'use client'`) for immediate crawlability. Logo `<Image>` has `priority` (LCP element).
+- Navbar `<nav>` carries `SiteNavigationElement` schema.org markup.
+- Feature lists must stay in sync with `WebApplication.featureList` in `structured-data.tsx`.
+
+## GEO (Generative Engine Optimisation)
+
+- **Answer-first pattern**: each section's H2 + subtitle should directly answer a user question (e.g. "What is Sim?", "How fast can I deploy?").
+- **Atomic answer blocks**: each feature / template card should be independently extractable by an AI summariser.
+- **Entity consistency**: always write "Sim" by name — never "the platform" or "our tool".
+- **Keyword density**: first 150 visible chars of Hero must name "Sim", "AI agents", "agentic workflows".
+- **sr-only summaries**: Hero and Templates each have a `<p className="sr-only">` (~50 words) as an atomic product/catalog summary for AI citation.
+- **Specific numbers**: prefer concrete figures ("1,000+ integrations", "15+ AI providers") over vague claims.

.cursor/rules/sim-queries.mdc

@@ -5,62 +5,122 @@ globs: ["apps/sim/hooks/queries/**/*.ts"]
 
 # React Query Patterns
 
-All React Query hooks live in `hooks/queries/`.
+All React Query hooks live in `hooks/queries/`. All server state must go through React Query — never use `useState` + `fetch` in components for data fetching or mutations.
 
 ## Query Key Factory
 
-Every query file defines a keys factory:
+Every query file defines a hierarchical keys factory with an `all` root key and intermediate plural keys for prefix-level invalidation:
 
 ```typescript
 export const entityKeys = {
   all: ['entity'] as const,
-  list: (workspaceId?: string) => [...entityKeys.all, 'list', workspaceId ?? ''] as const,
-  detail: (id?: string) => [...entityKeys.all, 'detail', id ?? ''] as const,
+  lists: () => [...entityKeys.all, 'list'] as const,
+  list: (workspaceId?: string) => [...entityKeys.lists(), workspaceId ?? ''] as const,
+  details: () => [...entityKeys.all, 'detail'] as const,
+  detail: (id?: string) => [...entityKeys.details(), id ?? ''] as const,
 }
 ```
 
+Never use inline query keys — always use the factory.
+
 ## File Structure
 
 ```typescript
 // 1. Query keys factory
 // 2. Types (if needed)
-// 3. Private fetch functions
+// 3. Private fetch functions (accept signal parameter)
 // 4. Exported hooks
 ```
 
 ## Query Hook
 
+- Every `queryFn` must destructure and forward `signal` for request cancellation
+- Every query must have an explicit `staleTime`
+- Use `keepPreviousData` only on variable-key queries (where params change), never on static keys
+
 ```typescript
+async function fetchEntities(workspaceId: string, signal?: AbortSignal) {
+  const response = await fetch(`/api/entities?workspaceId=${workspaceId}`, { signal })
+  if (!response.ok) throw new Error('Failed to fetch entities')
+  return response.json()
+}
+
 export function useEntityList(workspaceId?: string, options?: { enabled?: boolean }) {
   return useQuery({
     queryKey: entityKeys.list(workspaceId),
-    queryFn: () => fetchEntities(workspaceId as string),
+    queryFn: ({ signal }) => fetchEntities(workspaceId as string, signal),
     enabled: Boolean(workspaceId) && (options?.enabled ?? true),
     staleTime: 60 * 1000,
-    placeholderData: keepPreviousData,
+    placeholderData: keepPreviousData, // OK: workspaceId varies
   })
 }
 ```
 
 ## Mutation Hook
 
+- Use targeted invalidation (`entityKeys.lists()`) not broad (`entityKeys.all`) when possible
+- Invalidation must cover all affected query key prefixes (lists, details, related views)
+
 ```typescript
 export function useCreateEntity() {
   const queryClient = useQueryClient()
   return useMutation({
     mutationFn: async (variables) => { /* fetch POST */ },
-    onSuccess: () => queryClient.invalidateQueries({ queryKey: entityKeys.all }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: entityKeys.lists() })
+    },
   })
 }
 ```
 
 ## Optimistic Updates
 
+For optimistic mutations, use `onSettled` (not `onSuccess`) for cache reconciliation — `onSettled` fires on both success and error, ensuring the cache is always reconciled with the server.
+
+```typescript
+export function useUpdateEntity() {
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: async (variables) => { /* ... */ },
+    onMutate: async (variables) => {
+      await queryClient.cancelQueries({ queryKey: entityKeys.detail(variables.id) })
+      const previous = queryClient.getQueryData(entityKeys.detail(variables.id))
+      queryClient.setQueryData(entityKeys.detail(variables.id), /* optimistic value */)
+      return { previous }
+    },
+    onError: (_err, variables, context) => {
+      queryClient.setQueryData(entityKeys.detail(variables.id), context?.previous)
+    },
+    onSettled: (_data, _error, variables) => {
+      queryClient.invalidateQueries({ queryKey: entityKeys.lists() })
+      queryClient.invalidateQueries({ queryKey: entityKeys.detail(variables.id) })
+    },
+  })
+}
+```
+
 For optimistic mutations syncing with Zustand, use `createOptimisticMutationHandlers` from `@/hooks/queries/utils/optimistic-mutation`.
 
+## useCallback Dependencies
+
+Never include mutation objects (e.g., `createEntity`) in `useCallback` dependency arrays — the mutation object is not referentially stable and changes on every state update. The `.mutate()` and `.mutateAsync()` functions are stable in TanStack Query v5.
+
+```typescript
+// ✗ Bad — causes unnecessary recreations
+const handler = useCallback(() => {
+  createEntity.mutate(data)
+}, [createEntity]) // unstable reference
+
+// ✓ Good — omit from deps, mutate is stable
+const handler = useCallback(() => {
+  createEntity.mutate(data)
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+}, [data])
+```
+
 ## Naming
 
 - **Keys**: `entityKeys`
 - **Query hooks**: `useEntity`, `useEntityList`
-- **Mutation hooks**: `useCreateEntity`, `useUpdateEntity`
-- **Fetch functions**: `fetchEntity` (private)
+- **Mutation hooks**: `useCreateEntity`, `useUpdateEntity`, `useDeleteEntity`
+- **Fetch functions**: `fetchEntity`, `fetchEntities` (private)

.cursor/rules/sim-testing.mdc

@@ -7,51 +7,210 @@ globs: ["apps/sim/**/*.test.ts", "apps/sim/**/*.test.tsx"]
 
 Use Vitest. Test files: `feature.ts` → `feature.test.ts`
 
+## Global Mocks (vitest.setup.ts)
+
+These modules are mocked globally — do NOT re-mock them in test files unless you need to override behavior:
+
+- `@sim/db` → `databaseMock`
+- `drizzle-orm` → `drizzleOrmMock`
+- `@sim/logger` → `loggerMock`
+- `@/stores/console/store`, `@/stores/terminal`, `@/stores/execution/store`
+- `@/blocks/registry`
+- `@trigger.dev/sdk`
+
 ## Structure
 
 ```typescript
 /**
  * @vitest-environment node
  */
-import { databaseMock, loggerMock } from '@sim/testing'
-import { describe, expect, it, vi } from 'vitest'
+import { createMockRequest } from '@sim/testing'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
-vi.mock('@sim/db', () => databaseMock)
-vi.mock('@sim/logger', () => loggerMock)
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
 
-import { myFunction } from '@/lib/feature'
+vi.mock('@/lib/auth', () => ({
+  auth: { api: { getSession: vi.fn() } },
+  getSession: mockGetSession,
+}))
 
-describe('myFunction', () => {
-  beforeEach(() => vi.clearAllMocks())
-  it.concurrent('isolated tests run in parallel', () => { ... })
+import { GET, POST } from '@/app/api/my-route/route'
+
+describe('my route', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    mockGetSession.mockResolvedValue({ user: { id: 'user-1' } })
+  })
+
+  it('returns data', async () => {
+    const req = createMockRequest('GET')
+    const res = await GET(req)
+    expect(res.status).toBe(200)
+  })
+})
+```
+
+## Performance Rules (Critical)
+
+### NEVER use `vi.resetModules()` + `vi.doMock()` + `await import()`
+
+This is the #1 cause of slow tests. It forces complete module re-evaluation per test.
+
+```typescript
+// BAD — forces module re-evaluation every test (~50-100ms each)
+beforeEach(() => {
+  vi.resetModules()
+  vi.doMock('@/lib/auth', () => ({ getSession: vi.fn() }))
+})
+it('test', async () => {
+  const { GET } = await import('./route')  // slow dynamic import
+})
+
+// GOOD — module loaded once, mocks reconfigured per test (~1ms each)
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
+vi.mock('@/lib/auth', () => ({ getSession: mockGetSession }))
+import { GET } from '@/app/api/my-route/route'
+
+beforeEach(() => { vi.clearAllMocks() })
+it('test', () => {
+  mockGetSession.mockResolvedValue({ user: { id: '1' } })
+})
+```
+
+**Only exception:** Singleton modules that cache state at module scope (e.g., Redis clients, connection pools). These genuinely need `vi.resetModules()` + dynamic import to get a fresh instance per test.
+
+### NEVER use `vi.importActual()`
+
+This defeats the purpose of mocking by loading the real module and all its dependencies.
+
+```typescript
+// BAD — loads real module + all transitive deps
+vi.mock('@/lib/workspaces/utils', async () => {
+  const actual = await vi.importActual('@/lib/workspaces/utils')
+  return { ...actual, myFn: vi.fn() }
+})
+
+// GOOD — mock everything, only implement what tests need
+vi.mock('@/lib/workspaces/utils', () => ({
+  myFn: vi.fn(),
+  otherFn: vi.fn(),
+}))
+```
+
+### NEVER use `mockAuth()`, `mockConsoleLogger()`, or `setupCommonApiMocks()` from `@sim/testing`
+
+These helpers internally use `vi.doMock()` which is slow. Use direct `vi.hoisted()` + `vi.mock()` instead.
+
+### Mock heavy transitive dependencies
+
+If a module under test imports `@/blocks` (200+ files), `@/tools/registry`, or other heavy modules, mock them:
+
+```typescript
+vi.mock('@/blocks', () => ({
+  getBlock: () => null,
+  getAllBlocks: () => ({}),
+  getAllBlockTypes: () => [],
+  registry: {},
+}))
+```
+
+### Use `@vitest-environment node` unless DOM is needed
+
+Only use `@vitest-environment jsdom` if the test uses `window`, `document`, `FormData`, or other browser APIs. Node environment is significantly faster.
+
+### Avoid real timers in tests
+
+```typescript
+// BAD
+await new Promise(r => setTimeout(r, 500))
+
+// GOOD — use minimal delays or fake timers
+await new Promise(r => setTimeout(r, 1))
+// or
+vi.useFakeTimers()
+```
+
+## Mock Pattern Reference
+
+### Auth mocking (API routes)
+
+```typescript
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
+
+vi.mock('@/lib/auth', () => ({
+  auth: { api: { getSession: vi.fn() } },
+  getSession: mockGetSession,
+}))
+
+// In tests:
+mockGetSession.mockResolvedValue({ user: { id: 'user-1', email: 'test@example.com' } })
+mockGetSession.mockResolvedValue(null) // unauthenticated
+```
+
+### Hybrid auth mocking
+
+```typescript
+const { mockCheckSessionOrInternalAuth } = vi.hoisted(() => ({
+  mockCheckSessionOrInternalAuth: vi.fn(),
+}))
+
+vi.mock('@/lib/auth/hybrid', () => ({
+  checkSessionOrInternalAuth: mockCheckSessionOrInternalAuth,
+}))
+
+// In tests:
+mockCheckSessionOrInternalAuth.mockResolvedValue({
+  success: true, userId: 'user-1', authType: 'session',
+})
+```
+
+### Database chain mocking
+
+```typescript
+const { mockSelect, mockFrom, mockWhere } = vi.hoisted(() => ({
+  mockSelect: vi.fn(),
+  mockFrom: vi.fn(),
+  mockWhere: vi.fn(),
+}))
+
+vi.mock('@sim/db', () => ({
+  db: { select: mockSelect },
+}))
+
+beforeEach(() => {
+  mockSelect.mockReturnValue({ from: mockFrom })
+  mockFrom.mockReturnValue({ where: mockWhere })
+  mockWhere.mockResolvedValue([{ id: '1', name: 'test' }])
 })
 ```
 
 ## @sim/testing Package
 
-Always prefer over local mocks.
+Always prefer over local test data.
 
 | Category | Utilities |
 |----------|-----------|
-| **Mocks** | `loggerMock`, `databaseMock`, `setupGlobalFetchMock()` |
-| **Factories** | `createSession()`, `createWorkflowRecord()`, `createBlock()`, `createExecutorContext()` |
+| **Mocks** | `loggerMock`, `databaseMock`, `drizzleOrmMock`, `setupGlobalFetchMock()` |
+| **Factories** | `createSession()`, `createWorkflowRecord()`, `createBlock()`, `createExecutionContext()` |
 | **Builders** | `WorkflowBuilder`, `ExecutionContextBuilder` |
 | **Assertions** | `expectWorkflowAccessGranted()`, `expectBlockExecuted()` |
+| **Requests** | `createMockRequest()`, `createEnvMock()` |
 
-## Rules
+## Rules Summary
 
-1. `@vitest-environment node` directive at file top
-2. `vi.mock()` calls before importing mocked modules
-3. `@sim/testing` utilities over local mocks
-4. `it.concurrent` for isolated tests (no shared mutable state)
-5. `beforeEach(() => vi.clearAllMocks())` to reset state
-
-## Hoisted Mocks
-
-For mutable mock references:
-
-```typescript
-const mockFn = vi.hoisted(() => vi.fn())
-vi.mock('@/lib/module', () => ({ myFunction: mockFn }))
-mockFn.mockResolvedValue({ data: 'test' })
-```
+1. `@vitest-environment node` unless DOM is required
+2. `vi.hoisted()` + `vi.mock()` + static imports — never `vi.resetModules()` + `vi.doMock()` + dynamic imports
+3. `vi.mock()` calls before importing mocked modules
+4. `@sim/testing` utilities over local mocks
+5. `beforeEach(() => vi.clearAllMocks())` to reset state — no redundant `afterEach`
+6. No `vi.importActual()` — mock everything explicitly
+7. No `mockAuth()`, `mockConsoleLogger()`, `setupCommonApiMocks()` — use direct mocks
+8. Mock heavy deps (`@/blocks`, `@/tools/registry`, `@/triggers`) in tests that don't need them
+9. Use absolute imports in test files
+10. Avoid real timers — use 1ms delays or `vi.useFakeTimers()`

.cursor/skills/add-hosted-key/SKILL.md

@@ -0,0 +1,296 @@
+---
+name: add-hosted-key
+description: Add hosted API key support to a tool so Sim provides the key when users don't bring their own. Use when adding hosted keys, BYOK support, hideWhenHosted, or hosted key pricing to a tool or block.
+---
+
+# Adding Hosted Key Support to a Tool
+
+When a tool has hosted key support, Sim provides its own API key if the user hasn't configured one (via BYOK or env var). Usage is metered and billed to the workspace.
+
+## Overview
+
+| Step | What | Where |
+|------|------|-------|
+| 1 | Register BYOK provider ID | `tools/types.ts`, `app/api/workspaces/[id]/byok-keys/route.ts` |
+| 2 | Research the API's pricing and rate limits | API docs / pricing page (before writing any code) |
+| 3 | Add `hosting` config to the tool | `tools/{service}/{action}.ts` |
+| 4 | Hide API key field when hosted | `blocks/blocks/{service}.ts` |
+| 5 | Add to BYOK settings UI | BYOK settings component (`byok.tsx`) |
+| 6 | Summarize pricing and throttling comparison | Output to user (after all code changes) |
+
+## Step 1: Register the BYOK Provider ID
+
+Add the new provider to the `BYOKProviderId` union in `tools/types.ts`:
+
+```typescript
+export type BYOKProviderId =
+  | 'openai'
+  | 'anthropic'
+  // ...existing providers
+  | 'your_service'
+```
+
+Then add it to `VALID_PROVIDERS` in `app/api/workspaces/[id]/byok-keys/route.ts`:
+
+```typescript
+const VALID_PROVIDERS = ['openai', 'anthropic', 'google', 'mistral', 'your_service'] as const
+```
+
+## Step 2: Research the API's Pricing Model and Rate Limits
+
+**Before writing any `getCost` or `rateLimit` code**, look up the service's official documentation for both pricing and rate limits. You need to understand:
+
+### Pricing
+
+1. **How the API charges** — per request, per credit, per token, per step, per minute, etc.
+2. **Whether the API reports cost in its response** — look for fields like `creditsUsed`, `costDollars`, `tokensUsed`, or similar in the response body or headers
+3. **Whether cost varies by endpoint/options** — some APIs charge more for certain features (e.g., Firecrawl charges 1 credit/page base but +4 for JSON format, +4 for enhanced mode)
+4. **The dollar-per-unit rate** — what each credit/token/unit costs in dollars on our plan
+
+### Rate Limits
+
+1. **What rate limits the API enforces** — requests per minute/second, tokens per minute, concurrent requests, etc.
+2. **Whether limits vary by plan tier** — free vs paid vs enterprise often have different ceilings
+3. **Whether limits are per-key or per-account** — determines whether adding more hosted keys actually increases total throughput
+4. **What the API returns when rate limited** — HTTP 429, `Retry-After` header, error body format, etc.
+5. **Whether there are multiple dimensions** — some APIs limit both requests/min AND tokens/min independently
+
+Search the API's docs/pricing page (use WebSearch/WebFetch). Capture the pricing model as a comment in `getCost` so future maintainers know the source of truth.
+
+### Setting Our Rate Limits
+
+Our rate limiter (`lib/core/rate-limiter/hosted-key/`) uses a token-bucket algorithm applied **per billing actor** (workspace). It supports two modes:
+
+- **`per_request`** — simple; just `requestsPerMinute`. Good when the API charges flat per-request or cost doesn't vary much.
+- **`custom`** — `requestsPerMinute` plus additional `dimensions` (e.g., `tokens`, `search_units`). Each dimension has its own `limitPerMinute` and an `extractUsage` function that reads actual usage from the response. Use when the API charges on a variable metric (tokens, credits) and you want to cap that metric too.
+
+When choosing values for `requestsPerMinute` and any dimension limits:
+
+- **Stay well below the API's per-key limit** — our keys are shared across all workspaces. If the API allows 60 RPM per key and we have 3 keys, the global ceiling is ~180 RPM. Set the per-workspace limit low enough (e.g., 20-60 RPM) that many workspaces can coexist without collectively hitting the API's ceiling.
+- **Account for key pooling** — our round-robin distributes requests across `N` hosted keys, so the effective API-side rate per key is `(total requests) / N`. But per-workspace limits are enforced *before* key selection, so they apply regardless of key count.
+- **Prefer conservative defaults** — it's easy to raise limits later but hard to claw back after users depend on high throughput.
+
+## Step 3: Add `hosting` Config to the Tool
+
+Add a `hosting` object to the tool's `ToolConfig`. This tells the execution layer how to acquire hosted keys, calculate cost, and rate-limit.
+
+```typescript
+hosting: {
+  envKeyPrefix: 'YOUR_SERVICE_API_KEY',
+  apiKeyParam: 'apiKey',
+  byokProviderId: 'your_service',
+  pricing: {
+    type: 'custom',
+    getCost: (_params, output) => {
+      if (output.creditsUsed == null) {
+        throw new Error('Response missing creditsUsed field')
+      }
+      const creditsUsed = output.creditsUsed as number
+      const cost = creditsUsed * 0.001 // dollars per credit
+      return { cost, metadata: { creditsUsed } }
+    },
+  },
+  rateLimit: {
+    mode: 'per_request',
+    requestsPerMinute: 100,
+  },
+},
+```
+
+### Hosted Key Env Var Convention
+
+Keys use a numbered naming pattern driven by a count env var:
+
+```
+YOUR_SERVICE_API_KEY_COUNT=3
+YOUR_SERVICE_API_KEY_1=sk-...
+YOUR_SERVICE_API_KEY_2=sk-...
+YOUR_SERVICE_API_KEY_3=sk-...
+```
+
+The `envKeyPrefix` value (`YOUR_SERVICE_API_KEY`) determines which env vars are read at runtime. Adding more keys only requires bumping the count and adding the new env var.
+
+### Pricing: Prefer API-Reported Cost
+
+Always prefer using cost data returned by the API (e.g., `creditsUsed`, `costDollars`). This is the most accurate because it accounts for variable pricing tiers, feature modifiers, and plan-level discounts.
+
+**When the API reports cost** — use it directly and throw if missing:
+
+```typescript
+pricing: {
+  type: 'custom',
+  getCost: (params, output) => {
+    if (output.creditsUsed == null) {
+      throw new Error('Response missing creditsUsed field')
+    }
+    // $0.001 per credit — from https://example.com/pricing
+    const cost = (output.creditsUsed as number) * 0.001
+    return { cost, metadata: { creditsUsed: output.creditsUsed } }
+  },
+},
+```
+
+**When the API does NOT report cost** — compute it from params/output based on the pricing docs, but still validate the data you depend on:
+
+```typescript
+pricing: {
+  type: 'custom',
+  getCost: (params, output) => {
+    if (!Array.isArray(output.searchResults)) {
+      throw new Error('Response missing searchResults, cannot determine cost')
+    }
+    // Serper: 1 credit for <=10 results, 2 credits for >10 — from https://serper.dev/pricing
+    const credits = Number(params.num) > 10 ? 2 : 1
+    return { cost: credits * 0.001, metadata: { credits } }
+  },
+},
+```
+
+**`getCost` must always throw** if it cannot determine cost. Never silently fall back to a default — this would hide billing inaccuracies.
+
+### Capturing Cost Data from the API
+
+If the API returns cost info, capture it in `transformResponse` so `getCost` can read it from the output:
+
+```typescript
+transformResponse: async (response: Response) => {
+  const data = await response.json()
+  return {
+    success: true,
+    output: {
+      results: data.results,
+      creditsUsed: data.creditsUsed,  // pass through for getCost
+    },
+  }
+},
+```
+
+For async/polling tools, capture it in `postProcess` when the job completes:
+
+```typescript
+if (jobData.status === 'completed') {
+  result.output = {
+    data: jobData.data,
+    creditsUsed: jobData.creditsUsed,
+  }
+}
+```
+
+## Step 4: Hide the API Key Field When Hosted
+
+In the block config (`blocks/blocks/{service}.ts`), add `hideWhenHosted: true` to the API key subblock. This hides the field on hosted Sim since the platform provides the key:
+
+```typescript
+{
+  id: 'apiKey',
+  title: 'API Key',
+  type: 'short-input',
+  placeholder: 'Enter your API key',
+  password: true,
+  required: true,
+  hideWhenHosted: true,
+},
+```
+
+The visibility is controlled by `isSubBlockHiddenByHostedKey()` in `lib/workflows/subblocks/visibility.ts`, which checks the `isHosted` feature flag.
+
+### Excluding Specific Operations from Hosted Key Support
+
+When a block has multiple operations but some operations should **not** use a hosted key (e.g., the underlying API is deprecated, unsupported, or too expensive), use the **duplicate apiKey subblock** pattern. This is the same pattern Exa uses for its `research` operation:
+
+1. **Remove the `hosting` config** from the tool definition for that operation — it must not have a `hosting` object at all.
+2. **Duplicate the `apiKey` subblock** in the block config with opposing conditions:
+
+```typescript
+// API Key — hidden when hosted for operations with hosted key support
+{
+  id: 'apiKey',
+  title: 'API Key',
+  type: 'short-input',
+  placeholder: 'Enter your API key',
+  password: true,
+  required: true,
+  hideWhenHosted: true,
+  condition: { field: 'operation', value: 'unsupported_op', not: true },
+},
+// API Key — always visible for unsupported_op (no hosted key support)
+{
+  id: 'apiKey',
+  title: 'API Key',
+  type: 'short-input',
+  placeholder: 'Enter your API key',
+  password: true,
+  required: true,
+  condition: { field: 'operation', value: 'unsupported_op' },
+},
+```
+
+Both subblocks share the same `id: 'apiKey'`, so the same value flows to the tool. The conditions ensure only one is visible at a time. The first has `hideWhenHosted: true` and shows for all hosted operations; the second has no `hideWhenHosted` and shows only for the excluded operation — meaning users must always provide their own key for that operation.
+
+To exclude multiple operations, use an array: `{ field: 'operation', value: ['op_a', 'op_b'] }`.
+
+**Reference implementations:**
+- **Exa** (`blocks/blocks/exa.ts`): `research` operation excluded from hosting — lines 309-329
+- **Google Maps** (`blocks/blocks/google_maps.ts`): `speed_limits` operation excluded from hosting (deprecated Roads API)
+
+## Step 5: Add to the BYOK Settings UI
+
+Add an entry to the `PROVIDERS` array in the BYOK settings component so users can bring their own key. You need the service icon from `components/icons.tsx`:
+
+```typescript
+{
+  id: 'your_service',
+  name: 'Your Service',
+  icon: YourServiceIcon,
+  description: 'What this service does',
+  placeholder: 'Enter your API key',
+},
+```
+
+## Step 6: Summarize Pricing and Throttling Comparison
+
+After all code changes are complete, output a detailed summary to the user covering:
+
+### What to include
+
+1. **API's pricing model** — how the service charges (per token, per credit, per request, etc.), the specific rates found in docs, and whether the API reports cost in responses.
+2. **Our `getCost` approach** — how we calculate cost, what fields we depend on, and any assumptions or estimates (especially when the API doesn't report exact dollar cost).
+3. **API's rate limits** — the documented limits (RPM, TPM, concurrent, etc.), which plan tier they apply to, and whether they're per-key or per-account.
+4. **Our `rateLimit` config** — what we set for `requestsPerMinute` (and dimensions if custom mode), why we chose those values, and how they compare to the API's limits.
+5. **Key pooling impact** — how many hosted keys we expect, and how round-robin distribution affects the effective per-key rate at the API.
+6. **Gaps or risks** — anything the API charges for that we don't meter, rate limit dimensions we chose not to enforce, or pricing that may be inaccurate due to variable model/tier costs.
+
+### Format
+
+Present this as a structured summary with clear headings. Example:
+
+```
+### Pricing
+- **API charges**: $X per 1M tokens (input), $Y per 1M tokens (output) — varies by model
+- **Response reports cost?**: No — only token counts in `usage` field
+- **Our getCost**: Estimates cost at $Z per 1M total tokens based on median model pricing
+- **Risk**: Actual cost varies by model; our estimate may over/undercharge for cheap/expensive models
+
+### Throttling
+- **API limits**: 300 RPM per key (paid tier), 60 RPM (free tier)
+- **Per-key or per-account**: Per key — more keys = more throughput
+- **Our config**: 60 RPM per workspace (per_request mode)
+- **With N keys**: Effective per-key rate is (total RPM across workspaces) / N
+- **Headroom**: Comfortable — even 10 active workspaces at full rate = 600 RPM / 3 keys = 200 RPM per key, under the 300 RPM API limit
+```
+
+This summary helps reviewers verify that the pricing and rate limiting are well-calibrated and surfaces any risks that need monitoring.
+
+## Checklist
+
+- [ ] Provider added to `BYOKProviderId` in `tools/types.ts`
+- [ ] Provider added to `VALID_PROVIDERS` in the BYOK keys API route
+- [ ] API pricing docs researched — understand per-unit cost and whether the API reports cost in responses
+- [ ] API rate limits researched — understand RPM/TPM limits, per-key vs per-account, and plan tiers
+- [ ] `hosting` config added to the tool with `envKeyPrefix`, `apiKeyParam`, `byokProviderId`, `pricing`, and `rateLimit`
+- [ ] `getCost` throws if required cost data is missing from the response
+- [ ] Cost data captured in `transformResponse` or `postProcess` if API provides it
+- [ ] `hideWhenHosted: true` added to the API key subblock in the block config
+- [ ] Provider entry added to the BYOK settings UI with icon and description
+- [ ] Env vars documented: `{PREFIX}_COUNT` and `{PREFIX}_1..N`
+- [ ] Pricing and throttling summary provided to reviewer

.devcontainer/Dockerfile

@@ -1,4 +1,4 @@
-FROM oven/bun:1.3.3-alpine
+FROM oven/bun:1.3.10-alpine
 
 # Install necessary packages for development
 RUN apk add --no-cache \

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ on:
 
 concurrency:
   group: ci-${{ github.ref }}
-  cancel-in-progress: false
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 
 permissions:
   contents: read

.github/workflows/docs-embeddings.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Setup Node
         uses: actions/setup-node@v4

.github/workflows/i18n.yml

@@ -1,10 +1,7 @@
 name: 'Auto-translate Documentation'
 
 on:
-  schedule:
-    # Run every Sunday at midnight UTC
-    - cron: '0 0 * * 0'
-  workflow_dispatch: # Allow manual triggers
+  workflow_dispatch: # Manual trigger only (scheduled runs disabled)
 
 permissions:
   contents: write
@@ -26,7 +23,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Cache Bun dependencies
         uses: actions/cache@v4
@@ -125,7 +122,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Cache Bun dependencies
         uses: actions/cache@v4

.github/workflows/images.yml

@@ -146,7 +146,7 @@ jobs:
 
   create-ghcr-manifests:
     name: Create GHCR Manifests
-    runs-on: blacksmith-8vcpu-ubuntu-2404
+    runs-on: blacksmith-2vcpu-ubuntu-2404
     needs: [build-amd64, build-ghcr-arm64]
     if: github.ref == 'refs/heads/main'
     strategy:

.github/workflows/migrations.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Cache Bun dependencies
         uses: actions/cache@v4

.github/workflows/publish-cli.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Setup Node.js for npm publishing
         uses: actions/setup-node@v4

.github/workflows/publish-ts-sdk.yml

@@ -19,7 +19,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Setup Node.js for npm publishing
         uses: actions/setup-node@v4

.github/workflows/test-build.yml

@@ -10,7 +10,7 @@ permissions:
 jobs:
   test-build:
     name: Test and Build
-    runs-on: blacksmith-4vcpu-ubuntu-2404
+    runs-on: blacksmith-8vcpu-ubuntu-2404
 
     steps:
       - name: Checkout code
@@ -19,7 +19,7 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: 1.3.3
+          bun-version: 1.3.10
 
       - name: Setup Node
         uses: actions/setup-node@v4
@@ -38,6 +38,20 @@ jobs:
           key: ${{ github.repository }}-node-modules
           path: ./node_modules
 
+      - name: Mount Turbo cache (Sticky Disk)
+        uses: useblacksmith/stickydisk@v1
+        with:
+          key: ${{ github.repository }}-turbo-cache
+          path: ./.turbo
+
+      - name: Restore Next.js build cache
+        uses: actions/cache@v4
+        with:
+          path: ./apps/sim/.next/cache
+          key: ${{ runner.os }}-nextjs-${{ hashFiles('bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-nextjs-
+
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
@@ -76,6 +90,16 @@ jobs:
 
           echo "✅ All feature flags are properly configured"
 
+      - name: Check subblock ID stability
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            BASE_REF="origin/${{ github.base_ref }}"
+            git fetch --depth=1 origin "${{ github.base_ref }}" 2>/dev/null || true
+          else
+            BASE_REF="HEAD~1"
+          fi
+          bun run apps/sim/scripts/check-subblock-id-stability.ts "$BASE_REF"
+
       - name: Lint code
         run: bun run lint:check
 
@@ -85,6 +109,7 @@ jobs:
           NEXT_PUBLIC_APP_URL: 'https://www.sim.ai'
           DATABASE_URL: 'postgresql://postgres:postgres@localhost:5432/simstudio'
           ENCRYPTION_KEY: '7cf672e460e430c1fba707575c2b0e2ad5a99dddf9b7b7e3b5646e630861db1c' # dummy key for CI only
+          TURBO_CACHE_DIR: .turbo
         run: bun run test
 
       - name: Check schema and migrations are in sync
@@ -110,7 +135,8 @@ jobs:
           RESEND_API_KEY: 'dummy_key_for_ci_only'
           AWS_REGION: 'us-west-2'
           ENCRYPTION_KEY: '7cf672e460e430c1fba707575c2b0e2ad5a99dddf9b7b7e3b5646e630861db1c' # dummy key for CI only
-        run: bun run build
+          TURBO_CACHE_DIR: .turbo
+        run: bunx turbo run build --filter=sim
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v5

.gitignore

@@ -26,6 +26,9 @@ bun-debug.log*
 **/standalone/
 sim-standalone.tar.gz
 
+# redis
+dump.rdb
+
 # misc
 .DS_Store
 *.pem
@@ -73,3 +76,7 @@ start-collector.sh
 ## Helm Chart Tests
 helm/sim/test
 i18n.cache
+
+## Claude Code
+.claude/launch.json
+.claude/worktrees/

CLAUDE.md

@@ -134,21 +134,64 @@ Use `devtools` middleware. Use `persist` only when data should survive reload wi
 
 ## React Query
 
-All React Query hooks live in `hooks/queries/`.
+All React Query hooks live in `hooks/queries/`. All server state must go through React Query — never use `useState` + `fetch` in components for data fetching or mutations.
+
+### Query Key Factory
+
+Every file must have a hierarchical key factory with an `all` root key and intermediate plural keys for prefix invalidation:
 
 ```typescript
 export const entityKeys = {
   all: ['entity'] as const,
-  list: (workspaceId?: string) => [...entityKeys.all, 'list', workspaceId ?? ''] as const,
+  lists: () => [...entityKeys.all, 'list'] as const,
+  list: (workspaceId?: string) => [...entityKeys.lists(), workspaceId ?? ''] as const,
+  details: () => [...entityKeys.all, 'detail'] as const,
+  detail: (id?: string) => [...entityKeys.details(), id ?? ''] as const,
 }
+```
 
+### Query Hooks
+
+- Every `queryFn` must forward `signal` for request cancellation
+- Every query must have an explicit `staleTime`
+- Use `keepPreviousData` only on variable-key queries (where params change), never on static keys
+
+```typescript
 export function useEntityList(workspaceId?: string) {
   return useQuery({
     queryKey: entityKeys.list(workspaceId),
-    queryFn: () => fetchEntities(workspaceId as string),
+    queryFn: ({ signal }) => fetchEntities(workspaceId as string, signal),
     enabled: Boolean(workspaceId),
     staleTime: 60 * 1000,
-    placeholderData: keepPreviousData,
+    placeholderData: keepPreviousData, // OK: workspaceId varies
+  })
+}
+```
+
+### Mutation Hooks
+
+- Use targeted invalidation (`entityKeys.lists()`) not broad (`entityKeys.all`) when possible
+- For optimistic updates: use `onSettled` (not `onSuccess`) for cache reconciliation — `onSettled` fires on both success and error
+- Don't include mutation objects in `useCallback` deps — `.mutate()` is stable in TanStack Query v5
+
+```typescript
+export function useUpdateEntity() {
+  const queryClient = useQueryClient()
+  return useMutation({
+    mutationFn: async (variables) => { /* ... */ },
+    onMutate: async (variables) => {
+      await queryClient.cancelQueries({ queryKey: entityKeys.detail(variables.id) })
+      const previous = queryClient.getQueryData(entityKeys.detail(variables.id))
+      queryClient.setQueryData(entityKeys.detail(variables.id), /* optimistic */)
+      return { previous }
+    },
+    onError: (_err, variables, context) => {
+      queryClient.setQueryData(entityKeys.detail(variables.id), context?.previous)
+    },
+    onSettled: (_data, _error, variables) => {
+      queryClient.invalidateQueries({ queryKey: entityKeys.lists() })
+      queryClient.invalidateQueries({ queryKey: entityKeys.detail(variables.id) })
+    },
   })
 }
 ```
@@ -167,27 +210,51 @@ Import from `@/components/emcn`, never from subpaths (except CSS files). Use CVA
 
 ## Testing
 
-Use Vitest. Test files: `feature.ts` → `feature.test.ts`
+Use Vitest. Test files: `feature.ts` → `feature.test.ts`. See `.cursor/rules/sim-testing.mdc` for full details.
+
+### Global Mocks (vitest.setup.ts)
+
+`@sim/db`, `drizzle-orm`, `@sim/logger`, `@/blocks/registry`, `@trigger.dev/sdk`, and store mocks are provided globally. Do NOT re-mock them unless overriding behavior.
+
+### Standard Test Pattern
 
 ```typescript
 /**
  * @vitest-environment node
  */
-import { databaseMock, loggerMock } from '@sim/testing'
-import { describe, expect, it, vi } from 'vitest'
+import { createMockRequest } from '@sim/testing'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
-vi.mock('@sim/db', () => databaseMock)
-vi.mock('@sim/logger', () => loggerMock)
+const { mockGetSession } = vi.hoisted(() => ({
+  mockGetSession: vi.fn(),
+}))
 
-import { myFunction } from '@/lib/feature'
+vi.mock('@/lib/auth', () => ({
+  auth: { api: { getSession: vi.fn() } },
+  getSession: mockGetSession,
+}))
 
-describe('feature', () => {
-  beforeEach(() => vi.clearAllMocks())
-  it.concurrent('runs in parallel', () => { ... })
+import { GET } from '@/app/api/my-route/route'
+
+describe('my route', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    mockGetSession.mockResolvedValue({ user: { id: 'user-1' } })
+  })
+  it('returns data', async () => { ... })
 })
 ```
 
-Use `@sim/testing` mocks/factories over local test data. See `.cursor/rules/sim-testing.mdc` for details.
+### Performance Rules
+
+- **NEVER** use `vi.resetModules()` + `vi.doMock()` + `await import()` — use `vi.hoisted()` + `vi.mock()` + static imports
+- **NEVER** use `vi.importActual()` — mock everything explicitly
+- **NEVER** use `mockAuth()`, `mockConsoleLogger()`, `setupCommonApiMocks()` from `@sim/testing` — they use `vi.doMock()` internally
+- **Mock heavy deps** (`@/blocks`, `@/tools/registry`, `@/triggers`) in tests that don't need them
+- **Use `@vitest-environment node`** unless DOM APIs are needed (`window`, `document`, `FormData`)
+- **Avoid real timers** — use 1ms delays or `vi.useFakeTimers()`
+
+Use `@sim/testing` mocks/factories over local test data.
 
 ## Utils Rules
 
@@ -238,7 +305,7 @@ export const ServiceBlock: BlockConfig = {
   bgColor: '#hexcolor',
   icon: ServiceIcon,
   subBlocks: [ /* see SubBlock Properties */ ],
-  tools: { access: ['service_action'], config: { tool: (p) => `service_${p.operation}` } },
+  tools: { access: ['service_action'], config: { tool: (p) => `service_${p.operation}`, params: (p) => ({ /* type coercions here */ }) } },
   inputs: { /* ... */ },
   outputs: { /* ... */ },
 }
@@ -246,6 +313,8 @@ export const ServiceBlock: BlockConfig = {
 
 Register in `blocks/registry.ts` (alphabetically).
 
+**Important:** `tools.config.tool` runs during serialization (before variable resolution). Never do `Number()` or other type coercions there — dynamic references like `<Block.output>` will be destroyed. Use `tools.config.params` for type coercions (it runs during execution, after variables are resolved).
+
 **SubBlock Properties:**
 ```typescript
 {

README.md

@@ -4,7 +4,7 @@
   </a>
 </p>
 
-<p align="center">Build and deploy AI agent workflows in minutes.</p>
+<p align="center">The open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to orchestrate agentic workflows.</p>
 
 <p align="center">
   <a href="https://sim.ai" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/sim.ai-6F3DFA" alt="Sim.ai"></a>

apps/docs/app/[lang]/[[...slug]]/page.tsx

@@ -1,5 +1,8 @@
 import type React from 'react'
+import type { Root } from 'fumadocs-core/page-tree'
 import { findNeighbour } from 'fumadocs-core/page-tree'
+import type { ApiPageProps } from 'fumadocs-openapi/ui'
+import { createAPIPage } from 'fumadocs-openapi/ui'
 import { Pre } from 'fumadocs-ui/components/codeblock'
 import defaultMdxComponents from 'fumadocs-ui/mdx'
 import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page'
@@ -12,28 +15,75 @@ import { LLMCopyButton } from '@/components/page-actions'
 import { StructuredData } from '@/components/structured-data'
 import { CodeBlock } from '@/components/ui/code-block'
 import { Heading } from '@/components/ui/heading'
+import { ResponseSection } from '@/components/ui/response-section'
+import { i18n } from '@/lib/i18n'
+import { getApiSpecContent, openapi } from '@/lib/openapi'
 import { type PageData, source } from '@/lib/source'
 
+const SUPPORTED_LANGUAGES: Set<string> = new Set(i18n.languages)
+const BASE_URL = 'https://docs.sim.ai'
+
+function resolveLangAndSlug(params: { slug?: string[]; lang: string }) {
+  const isValidLang = SUPPORTED_LANGUAGES.has(params.lang)
+  const lang = isValidLang ? params.lang : 'en'
+  const slug = isValidLang ? params.slug : [params.lang, ...(params.slug ?? [])]
+  return { lang, slug }
+}
+
+const APIPage = createAPIPage(openapi, {
+  playground: { enabled: false },
+  content: {
+    renderOperationLayout: async (slots) => {
+      return (
+        <div className='flex @4xl:flex-row flex-col @4xl:items-start gap-x-6 gap-y-4'>
+          <div className='min-w-0 flex-1'>
+            {slots.header}
+            {slots.apiPlayground}
+            {slots.authSchemes && <div className='api-section-divider'>{slots.authSchemes}</div>}
+            {slots.paremeters}
+            {slots.body && <div className='api-section-divider'>{slots.body}</div>}
+            <ResponseSection>{slots.responses}</ResponseSection>
+            {slots.callbacks}
+          </div>
+          <div className='@4xl:sticky @4xl:top-[calc(var(--fd-docs-row-1,2rem)+1rem)] @4xl:w-[400px]'>
+            {slots.apiExample}
+          </div>
+        </div>
+      )
+    },
+  },
+})
+
 export default async function Page(props: { params: Promise<{ slug?: string[]; lang: string }> }) {
   const params = await props.params
-  const page = source.getPage(params.slug, params.lang)
+  const { lang, slug } = resolveLangAndSlug(params)
+  const page = source.getPage(slug, lang)
   if (!page) notFound()
 
-  const data = page.data as PageData
-  const MDX = data.body
-  const baseUrl = 'https://docs.sim.ai'
-  const markdownContent = await data.getText('processed')
+  const data = page.data as unknown as PageData & {
+    _openapi?: { method?: string }
+    getAPIPageProps?: () => ApiPageProps
+  }
+  const isOpenAPI = '_openapi' in data && data._openapi != null
+  const isApiReference = slug?.some((s) => s === 'api-reference') ?? false
 
-  const pageTreeRecord = source.pageTree as Record<string, any>
-  const pageTree =
-    pageTreeRecord[params.lang] ?? pageTreeRecord.en ?? Object.values(pageTreeRecord)[0]
-  const neighbours = pageTree ? findNeighbour(pageTree, page.url) : null
+  const pageTreeRecord = source.pageTree as Record<string, Root>
+  const pageTree = pageTreeRecord[lang] ?? pageTreeRecord.en ?? Object.values(pageTreeRecord)[0]
+  const rawNeighbours = pageTree ? findNeighbour(pageTree, page.url) : null
+  const neighbours = isApiReference
+    ? {
+        previous: rawNeighbours?.previous?.url.includes('/api-reference/')
+          ? rawNeighbours.previous
+          : undefined,
+        next: rawNeighbours?.next?.url.includes('/api-reference/') ? rawNeighbours.next : undefined,
+      }
+    : rawNeighbours
 
   const generateBreadcrumbs = () => {
     const breadcrumbs: Array<{ name: string; url: string }> = [
       {
         name: 'Home',
-        url: baseUrl,
+        url: BASE_URL,
       },
     ]
 
@@ -41,7 +91,7 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
     let currentPath = ''
 
     urlParts.forEach((part, index) => {
-      if (index === 0 && ['en', 'es', 'fr', 'de', 'ja', 'zh'].includes(part)) {
+      if (index === 0 && SUPPORTED_LANGUAGES.has(part)) {
         currentPath = `/${part}`
         return
       }
@@ -56,12 +106,12 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
       if (index === urlParts.length - 1) {
         breadcrumbs.push({
           name: data.title,
-          url: `${baseUrl}${page.url}`,
+          url: `${BASE_URL}${page.url}`,
         })
       } else {
         breadcrumbs.push({
           name: name,
-          url: `${baseUrl}${currentPath}`,
+          url: `${BASE_URL}${currentPath}`,
         })
       }
     })
@@ -73,7 +123,6 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
 
   const CustomFooter = () => (
     <div className='mt-12'>
-      {/* Navigation links */}
       <div className='flex items-center justify-between py-8'>
         {neighbours?.previous ? (
           <Link
@@ -100,10 +149,8 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
         )}
       </div>
 
-      {/* Divider line */}
       <div className='border-border border-t' />
 
-      {/* Social icons */}
       <div className='flex items-center gap-4 py-6'>
         <Link
           href='https://x.com/simdotai'
@@ -169,13 +216,70 @@ export default async function Page(props: { params: Promise<{ slug?: string[]; l
     </div>
   )
 
+  if (isOpenAPI && data.getAPIPageProps) {
+    const apiProps = data.getAPIPageProps()
+    const apiPageContent = getApiSpecContent(
+      data.title,
+      data.description,
+      apiProps.operations ?? []
+    )
+
+    return (
+      <>
+        <StructuredData
+          title={data.title}
+          description={data.description || ''}
+          url={`${BASE_URL}${page.url}`}
+          lang={lang}
+          breadcrumb={breadcrumbs}
+        />
+        <style>{`#nd-page { grid-column: main-start / toc-end !important; max-width: 1400px !important; }`}</style>
+        <DocsPage
+          toc={data.toc}
+          breadcrumb={{
+            enabled: false,
+          }}
+          tableOfContent={{
+            style: 'clerk',
+            enabled: false,
+          }}
+          tableOfContentPopover={{
+            style: 'clerk',
+            enabled: false,
+          }}
+          footer={{
+            enabled: true,
+            component: <CustomFooter />,
+          }}
+        >
+          <div className='api-page-header relative mt-6 sm:mt-0'>
+            <div className='absolute top-1 right-0 flex items-center gap-2'>
+              <div className='hidden sm:flex'>
+                <LLMCopyButton content={apiPageContent} />
+              </div>
+              <PageNavigationArrows previous={neighbours?.previous} next={neighbours?.next} />
+            </div>
+            <DocsTitle>{data.title}</DocsTitle>
+            <DocsDescription>{data.description}</DocsDescription>
+          </div>
+          <DocsBody>
+            <APIPage {...apiProps} />
+          </DocsBody>
+        </DocsPage>
+      </>
+    )
+  }
+
+  const MDX = data.body
+  const markdownContent = await data.getText('processed')
+
   return (
     <>
       <StructuredData
         title={data.title}
         description={data.description || ''}
-        url={`${baseUrl}${page.url}`}
-        lang={params.lang}
+        url={`${BASE_URL}${page.url}`}
+        lang={lang}
         breadcrumb={breadcrumbs}
       />
       <DocsPage
@@ -252,27 +356,29 @@ export async function generateMetadata(props: {
   params: Promise<{ slug?: string[]; lang: string }>
 }) {
   const params = await props.params
-  const page = source.getPage(params.slug, params.lang)
+  const { lang, slug } = resolveLangAndSlug(params)
+  const page = source.getPage(slug, lang)
   if (!page) notFound()
 
-  const data = page.data as PageData
-  const baseUrl = 'https://docs.sim.ai'
-  const fullUrl = `${baseUrl}${page.url}`
+  const data = page.data as unknown as PageData
+  const fullUrl = `${BASE_URL}${page.url}`
 
-  const ogImageUrl = `${baseUrl}/api/og?title=${encodeURIComponent(data.title)}`
+  const ogImageUrl = `${BASE_URL}/api/og?title=${encodeURIComponent(data.title)}`
 
   return {
     title: data.title,
     description:
-      data.description || 'Sim visual workflow builder for AI applications documentation',
+      data.description ||
+      'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce.',
     keywords: [
-      'AI workflow builder',
-      'visual workflow editor',
-      'AI automation',
-      'workflow automation',
       'AI agents',
-      'no-code AI',
-      'drag and drop workflows',
+      'agentic workforce',
+      'AI agent platform',
+      'agentic workflows',
+      'LLM orchestration',
+      'AI automation',
+      'knowledge base',
+      'AI integrations',
       data.title?.toLowerCase().split(' '),
     ]
       .flat()
@@ -282,14 +388,15 @@ export async function generateMetadata(props: {
     openGraph: {
       title: data.title,
       description:
-        data.description || 'Sim visual workflow builder for AI applications documentation',
+        data.description ||
+        'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce.',
       url: fullUrl,
       siteName: 'Sim Documentation',
       type: 'article',
-      locale: params.lang === 'en' ? 'en_US' : `${params.lang}_${params.lang.toUpperCase()}`,
+      locale: lang === 'en' ? 'en_US' : `${lang}_${lang.toUpperCase()}`,
       alternateLocale: ['en', 'es', 'fr', 'de', 'ja', 'zh']
-        .filter((lang) => lang !== params.lang)
-        .map((lang) => (lang === 'en' ? 'en_US' : `${lang}_${lang.toUpperCase()}`)),
+        .filter((l) => l !== lang)
+        .map((l) => (l === 'en' ? 'en_US' : `${l}_${l.toUpperCase()}`)),
       images: [
         {
           url: ogImageUrl,
@@ -303,7 +410,8 @@ export async function generateMetadata(props: {
       card: 'summary_large_image',
       title: data.title,
       description:
-        data.description || 'Sim visual workflow builder for AI applications documentation',
+        data.description ||
+        'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce.',
       images: [ogImageUrl],
       creator: '@simdotai',
       site: '@simdotai',
@@ -323,13 +431,13 @@ export async function generateMetadata(props: {
     alternates: {
       canonical: fullUrl,
       languages: {
-        'x-default': `${baseUrl}${page.url.replace(`/${params.lang}`, '')}`,
-        en: `${baseUrl}${page.url.replace(`/${params.lang}`, '')}`,
-        es: `${baseUrl}/es${page.url.replace(`/${params.lang}`, '')}`,
-        fr: `${baseUrl}/fr${page.url.replace(`/${params.lang}`, '')}`,
-        de: `${baseUrl}/de${page.url.replace(`/${params.lang}`, '')}`,
-        ja: `${baseUrl}/ja${page.url.replace(`/${params.lang}`, '')}`,
-        zh: `${baseUrl}/zh${page.url.replace(`/${params.lang}`, '')}`,
+        'x-default': `${BASE_URL}${page.url.replace(`/${lang}`, '')}`,
+        en: `${BASE_URL}${page.url.replace(`/${lang}`, '')}`,
+        es: `${BASE_URL}/es${page.url.replace(`/${lang}`, '')}`,
+        fr: `${BASE_URL}/fr${page.url.replace(`/${lang}`, '')}`,
+        de: `${BASE_URL}/de${page.url.replace(`/${lang}`, '')}`,
+        ja: `${BASE_URL}/ja${page.url.replace(`/${lang}`, '')}`,
+        zh: `${BASE_URL}/zh${page.url.replace(`/${lang}`, '')}`,
       },
     },
   }

apps/docs/app/[lang]/layout.tsx

@@ -10,6 +10,7 @@ import {
   SidebarSeparator,
 } from '@/components/docs-layout/sidebar-components'
 import { Navbar } from '@/components/navbar/navbar'
+import { AnimatedBlocks } from '@/components/ui/animated-blocks'
 import { SimLogoFull } from '@/components/ui/sim-logo'
 import { i18n } from '@/lib/i18n'
 import { source } from '@/lib/source'
@@ -55,15 +56,18 @@ type LayoutProps = {
   params: Promise<{ lang: string }>
 }
 
+const SUPPORTED_LANGUAGES: Set<string> = new Set(i18n.languages)
+
 export default async function Layout({ children, params }: LayoutProps) {
-  const { lang } = await params
+  const { lang: rawLang } = await params
+  const lang = SUPPORTED_LANGUAGES.has(rawLang) ? rawLang : 'en'
 
   const structuredData = {
     '@context': 'https://schema.org',
     '@type': 'WebSite',
     name: 'Sim Documentation',
     description:
-      'Comprehensive documentation for Sim - the visual workflow builder for AI Agent Workflows.',
+      'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows.',
     url: 'https://docs.sim.ai',
     publisher: {
       '@type': 'Organization',
@@ -99,6 +103,7 @@ export default async function Layout({ children, params }: LayoutProps) {
       </head>
       <body className='flex min-h-screen flex-col font-sans'>
         <Script src='https://assets.onedollarstats.com/stonks.js' strategy='lazyOnload' />
+        <AnimatedBlocks />
         <RootProvider i18n={provider(lang)}>
           <Navbar />
           <DocsLayout
@@ -107,6 +112,7 @@ export default async function Layout({ children, params }: LayoutProps) {
               title: <SimLogoFull className='h-7 w-auto' />,
             }}
             sidebar={{
+              tabs: false,
               defaultOpenLevel: 0,
               collapsible: false,
               footer: null,

apps/docs/app/global.css

@@ -1,6 +1,7 @@
 @import "tailwindcss";
 @import "fumadocs-ui/css/neutral.css";
 @import "fumadocs-ui/css/preset.css";
+@import "fumadocs-openapi/css/preset.css";
 
 /* Prevent overscroll bounce effect on the page */
 html,
@@ -8,19 +9,24 @@ body {
   overscroll-behavior: none;
 }
 
+/* Prevent modals/dialogs from shifting layout via scroll-lock compensation */
+html,
+body {
+  padding-right: 0 !important;
+  margin-right: 0 !important;
+}
+
 @theme {
-  --color-fd-primary: #33c482; /* Green from Sim logo */
-  --font-geist-sans: var(--font-geist-sans);
-  --font-geist-mono: var(--font-geist-mono);
-}
-
-/* Ensure primary color is set in both light and dark modes */
-:root {
-  --color-fd-primary: #33c482;
+  --color-fd-primary: var(--color-fd-foreground);
 }
 
+/* Match landing page dark background (#1b1b1b) */
 .dark {
-  --color-fd-primary: #33c482;
+  --color-fd-background: hsl(0, 0%, 10.6%) !important;
+  --color-fd-card: hsl(0, 0%, 13%) !important;
+  --color-fd-popover: hsl(0, 0%, 14%) !important;
+  --color-fd-secondary: hsl(0, 0%, 15.5%) !important;
+  --color-fd-muted: hsl(0, 0%, 18%) !important;
 }
 
 /* Font family utilities */
@@ -34,16 +40,10 @@ body {
     "Liberation Mono", "Courier New", monospace;
 }
 
-/* Target any potential border classes */
-* {
-  --fd-border-sidebar: transparent !important;
-}
-
-/* Override any CSS custom properties for borders */
 :root {
   --fd-border: transparent !important;
   --fd-border-sidebar: transparent !important;
-  --fd-nav-height: 65px; /* Custom navbar height (h-16 = 64px + 1px border) */
+  --fd-nav-height: 93px; /* Custom navbar height (52px top + 1px divider + 40px tabs) */
   /* Content container width used to center main content */
   --spacing-fd-container: 1400px;
   /* Edge gutter = leftover space on each side of centered container */
@@ -59,44 +59,31 @@ body {
   --content-gap: 1.75rem;
 }
 
-/* Remove custom layout variable overrides to fallback to fumadocs defaults */
-
-/* ============================================
-   Navbar Light Mode Styling
-   ============================================ */
-
-/* Light mode navbar and search styling */
+/* Light mode navbar background */
 :root:not(.dark) nav {
   background-color: hsla(0, 0%, 96%, 0.85) !important;
 }
 
-:root:not(.dark) nav button[type="button"] {
-  background-color: hsla(0, 0%, 93%, 0.85) !important;
+/* Dark mode navbar background */
+:root.dark nav {
+  background-color: hsla(0, 0%, 10.6%, 0.92) !important;
+}
+
+:root.dark nav button[type="button"] {
+  background-color: hsla(0, 0%, 15%, 0.85) !important;
   backdrop-filter: blur(33px) saturate(180%) !important;
   -webkit-backdrop-filter: blur(33px) saturate(180%) !important;
-  color: rgba(0, 0, 0, 0.6) !important;
+  color: rgba(255, 255, 255, 0.5) !important;
 }
 
-:root:not(.dark) nav button[type="button"] kbd {
-  color: rgba(0, 0, 0, 0.6) !important;
+:root.dark nav button[type="button"] kbd {
+  color: rgba(255, 255, 255, 0.4) !important;
 }
 
-/* Dark mode navbar and search styling */
-:root.dark nav {
-  background-color: hsla(0, 0%, 7.04%, 0.92) !important;
-  backdrop-filter: blur(25px) saturate(180%) brightness(0.6) !important;
-  -webkit-backdrop-filter: blur(25px) saturate(180%) brightness(0.6) !important;
-}
-
-/* ============================================
-   Custom Sidebar Styling (Turborepo-inspired)
-   ============================================ */
-
 /* Floating sidebar appearance - remove background */
 [data-sidebar-container],
 #nd-sidebar {
   background: transparent !important;
-  background-color: transparent !important;
   border: none !important;
   --color-fd-muted: transparent !important;
   --color-fd-card: transparent !important;
@@ -106,9 +93,7 @@ body {
 aside[data-sidebar],
 aside#nd-sidebar {
   background: transparent !important;
-  background-color: transparent !important;
   border: none !important;
-  border-right: none !important;
 }
 
 /* Fumadocs v16: Add sidebar placeholder styling for grid area */
@@ -121,7 +106,7 @@ aside#nd-sidebar {
   display: none !important;
 }
 
-/* Mobile only: Reduce gap between navbar and content */
+/* Mobile only: Reduce gap between navbar and content (custom navbar hidden on mobile) */
 @media (max-width: 1023px) {
   #nd-docs-layout {
     margin-top: -25px;
@@ -145,11 +130,11 @@ aside#nd-sidebar {
 /* On mobile, let fumadocs handle the layout natively */
 @media (min-width: 1024px) {
   :root {
-    --fd-banner-height: 65px !important; /* 64px navbar + 1px border */
+    --fd-banner-height: 93px !important; /* 52px top + 1px divider + 40px tabs */
   }
 
   #nd-docs-layout {
-    --fd-docs-height: calc(100dvh - 65px) !important; /* 64px navbar + 1px border */
+    --fd-docs-height: calc(100dvh - 93px) !important; /* 52px top + 1px divider + 40px tabs */
     --fd-sidebar-width: 300px !important;
     margin-left: var(--sidebar-offset) !important;
     margin-right: var(--toc-offset) !important;
@@ -167,7 +152,6 @@ aside#nd-sidebar {
 #nd-sidebar > div {
   padding: 0.5rem 12px 12px;
   background: transparent !important;
-  background-color: transparent !important;
 }
 
 /* Override sidebar item styling to match Raindrop */
@@ -444,10 +428,6 @@ aside[data-sidebar],
 #nd-sidebar,
 #nd-sidebar * {
   border: none !important;
-  border-right: none !important;
-  border-left: none !important;
-  border-top: none !important;
-  border-bottom: none !important;
 }
 
 /* Override fumadocs background colors for sidebar */
@@ -457,7 +437,6 @@ aside[data-sidebar],
   --color-fd-muted: transparent !important;
   --color-fd-secondary: transparent !important;
   background: transparent !important;
-  background-color: transparent !important;
 }
 
 /* Force normal text flow in sidebar */
@@ -468,10 +447,6 @@ aside[data-sidebar],
   writing-mode: horizontal-tb !important;
 }
 
-/* ============================================
-   Code Block Styling (Improved)
-   ============================================ */
-
 /* Apply Geist Mono to code elements */
 code,
 pre,
@@ -532,10 +507,6 @@ pre code .line {
   color: var(--color-fd-primary);
 }
 
-/* ============================================
-   TOC (Table of Contents) Styling
-   ============================================ */
-
 /* Remove the thin border-left on nested TOC items (keeps main indicator only) */
 #nd-toc a[style*="padding-inline-start"] {
   border-left: none !important;
@@ -554,10 +525,6 @@ main article,
   padding-bottom: 4rem;
 }
 
-/* ============================================
-   Center and Constrain Main Content Width
-   ============================================ */
-
 /* Main content area - center and constrain like turborepo/raindrop */
 /* Note: --sidebar-offset and --toc-offset are now applied at #nd-docs-layout level */
 main[data-main] {
@@ -586,16 +553,700 @@ main[data-main] {
   padding-top: 1.5rem !important;
 }
 
-/* Override Fumadocs default content padding */
-article[data-content],
-div[data-content] {
-  padding-top: 1.5rem !important;
-}
-
-/* Remove any unwanted borders/outlines from video elements */
+/* Remove any unwanted outlines from video elements */
 video {
   outline: none !important;
-  border-style: solid !important;
+}
+
+/* API Reference Pages — Mintlify-style overrides */
+
+/* OpenAPI pages: span main + TOC grid columns for wide two-column layout.
+   Use named grid lines from grid-template-areas so this works regardless
+   of whether the grid has 3 columns (production) or 5 columns (local dev). */
+#nd-page:has(.api-page-header) {
+  grid-column: main-start / toc-end !important;
+  max-width: 1400px !important;
+}
+
+/* Hide the empty TOC aside on OpenAPI pages so it doesn't overlay content */
+#nd-docs-layout:has(#nd-page:has(.api-page-header)) #nd-toc {
+  display: none;
+}
+
+/* Hide the default "Response Body" heading rendered by fumadocs-openapi */
+.response-section-wrapper > .response-section-content > h2,
+.response-section-wrapper > .response-section-content > h3 {
+  display: none !important;
+}
+
+/* Hide default accordion triggers (status code rows) — we show our own dropdown */
+.response-section-wrapper [data-orientation="vertical"] > [data-state] > h3 {
+  display: none !important;
+}
+
+/* Ensure API reference pages use the same font as the rest of the docs */
+#nd-page:has(.api-page-header),
+#nd-page:has(.api-page-header) h2,
+#nd-page:has(.api-page-header) h3,
+#nd-page:has(.api-page-header) h4,
+#nd-page:has(.api-page-header) p,
+#nd-page:has(.api-page-header) span,
+#nd-page:has(.api-page-header) div,
+#nd-page:has(.api-page-header) label,
+#nd-page:has(.api-page-header) button {
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+    "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+}
+
+/* Method badge pills — shared background colors (page + sidebar) */
+span.font-mono.font-medium[data-method="get"],
+span.font-mono.font-medium[data-method="head"],
+span.font-mono.font-medium[data-method="options"] {
+  background-color: rgb(220 252 231 / 0.85);
+}
+html.dark span.font-mono.font-medium[data-method="get"],
+html.dark span.font-mono.font-medium[data-method="head"],
+html.dark span.font-mono.font-medium[data-method="options"] {
+  background-color: rgb(34 197 94 / 0.15);
+}
+span.font-mono.font-medium[data-method="post"] {
+  background-color: rgb(219 234 254 / 0.85);
+}
+html.dark span.font-mono.font-medium[data-method="post"] {
+  background-color: rgb(59 130 246 / 0.15);
+}
+span.font-mono.font-medium[data-method="put"] {
+  background-color: rgb(254 249 195 / 0.85);
+}
+html.dark span.font-mono.font-medium[data-method="put"] {
+  background-color: rgb(234 179 8 / 0.15);
+}
+span.font-mono.font-medium[data-method="patch"] {
+  background-color: rgb(255 237 213 / 0.85);
+}
+html.dark span.font-mono.font-medium[data-method="patch"] {
+  background-color: rgb(249 115 22 / 0.15);
+}
+span.font-mono.font-medium[data-method="delete"] {
+  background-color: rgb(254 226 226 / 0.85);
+}
+html.dark span.font-mono.font-medium[data-method="delete"] {
+  background-color: rgb(239 68 68 / 0.15);
+}
+
+/* Sidebar links with method badges — flex for vertical centering */
+#nd-sidebar a:has(span.font-mono.font-medium) {
+  display: flex !important;
+  align-items: center !important;
+  gap: 0.375rem;
+}
+
+/* Sidebar method badges — fixed-width for right-aligned labels */
+#nd-sidebar a span.font-mono.font-medium {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2.625rem;
+  font-size: 0.625rem !important;
+  line-height: 1 !important;
+  padding: 0.15625rem 0.25rem;
+  border-radius: 0.1875rem;
+  flex-shrink: 0;
+}
+
+/* Footer navigation method badges — pill styling to match sidebar */
+#nd-page span.font-mono.font-medium[data-method] {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 0.625rem !important;
+  line-height: 1 !important;
+  padding: 0.15625rem 0.375rem;
+  border-radius: 0.1875rem;
+}
+
+/* Code block containers — match regular docs styling */
+#nd-page:has(.api-page-header) figure.shiki {
+  border-radius: 0.75rem !important;
+  background-color: var(--color-fd-card) !important;
+}
+
+/* Hide "Filter Properties" search bar everywhere — main page and popovers */
+input[placeholder="Filter Properties"] {
+  display: none !important;
+}
+div:has(> input[placeholder="Filter Properties"]) {
+  display: none !important;
+}
+/* Remove top border on first visible property after hidden Filter Properties */
+div:has(> input[placeholder="Filter Properties"]) + .text-sm.border-t {
+  border-top: none !important;
+}
+
+/* Hide "TypeScript Definitions" copy panel on API pages */
+#nd-page:has(.api-page-header) div.not-prose.rounded-xl.border.p-3.mb-4 {
+  display: none !important;
+}
+#nd-page:has(.api-page-header) div.not-prose.rounded-xl.border.p-3:has(> div > p.font-medium) {
+  display: none !important;
+}
+
+/* Hide info tags (Format, Default, etc.) everywhere — main page and popovers */
+div.flex.flex-row.gap-2.flex-wrap.not-prose:has(> div.bg-fd-secondary) {
+  display: none !important;
+}
+div.flex.flex-row.items-start.bg-fd-secondary.border.rounded-lg.text-xs {
+  display: none !important;
+}
+
+/* Method+path bar — cleaner, lighter styling like Gumloop.
+   Override bg-fd-card CSS variable directly for reliability. */
+#nd-page:has(.api-page-header) div.flex.flex-row.items-center.rounded-xl.border.not-prose {
+  --color-fd-card: rgb(249 250 251) !important;
+  background-color: rgb(249 250 251) !important;
+  border-color: rgb(229 231 235) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose {
+  --color-fd-card: rgb(24 24 27) !important;
+  background-color: rgb(24 24 27) !important;
+  border-color: rgb(63 63 70) !important;
+}
+/* Method badge inside path bar — cleaner sans-serif, softer colors */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium {
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif !important;
+  font-weight: 600 !important;
+  font-size: 0.6875rem !important;
+  letter-spacing: 0.025em;
+  text-transform: uppercase;
+  padding: 0.125rem 0.5rem !important;
+  border-radius: 0.375rem !important;
+}
+/* Path bar per-method colors (fumadocs renders these, so we match by class) */
+/* GET */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-green"] {
+  color: rgb(22 163 74) !important;
+  background-color: rgb(220 252 231 / 0.7) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-green"] {
+  color: rgb(74 222 128) !important;
+  background-color: rgb(34 197 94 / 0.15) !important;
+}
+/* POST */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-blue"] {
+  color: rgb(37 99 235) !important;
+  background-color: rgb(219 234 254 / 0.7) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-blue"] {
+  color: rgb(96 165 250) !important;
+  background-color: rgb(59 130 246 / 0.15) !important;
+}
+/* PUT */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-yellow"] {
+  color: rgb(161 98 7) !important;
+  background-color: rgb(254 249 195 / 0.7) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-yellow"] {
+  color: rgb(250 204 21) !important;
+  background-color: rgb(234 179 8 / 0.15) !important;
+}
+/* PATCH */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-orange"] {
+  color: rgb(194 65 12) !important;
+  background-color: rgb(255 237 213 / 0.7) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-orange"] {
+  color: rgb(251 146 60) !important;
+  background-color: rgb(249 115 22 / 0.15) !important;
+}
+/* DELETE */
+#nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-red"] {
+  color: rgb(185 28 28) !important;
+  background-color: rgb(254 226 226 / 0.7) !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  span.font-mono.font-medium[class*="text-red"] {
+  color: rgb(248 113 113) !important;
+  background-color: rgb(239 68 68 / 0.15) !important;
+}
+
+/* Path text inside method+path bar — monospace, bright like Gumloop */
+#nd-page:has(.api-page-header) div.flex.flex-row.items-center.rounded-xl.border.not-prose code {
+  color: rgb(55 65 81) !important;
+  background: none !important;
+  border: none !important;
+  padding: 0 !important;
+  font-size: 0.8125rem !important;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.flex.flex-row.items-center.rounded-xl.border.not-prose
+  code {
+  color: rgb(229 231 235) !important;
+}
+
+/* Inline code in API pages — neutral color instead of red.
+   Exclude code inside the method+path bar (handled above). */
+#nd-page:has(.api-page-header) .prose :not(pre) > code {
+  color: rgb(79 70 229) !important;
+}
+html.dark #nd-page:has(.api-page-header) .prose :not(pre) > code {
+  color: rgb(165 180 252) !important;
+}
+
+/* Response Section — custom dropdown-based rendering (Mintlify style) */
+
+/* Hide divider lines between accordion items */
+.response-section-wrapper [data-orientation="vertical"].divide-y > * {
+  border-top-width: 0 !important;
+  border-bottom-width: 0 !important;
+}
+.response-section-wrapper [data-orientation="vertical"].divide-y {
+  border-top: none !important;
+}
+
+/* Remove content type labels inside accordion items (we show one in the header) */
+.response-section-wrapper [data-orientation="vertical"] p.not-prose:has(code.text-xs) {
+  display: none !important;
+}
+
+/* Hide the top-level response description (e.g. "Execution was successfully cancelled.")
+   but NOT field descriptions inside Schema which also use prose-no-margin.
+   The response description is a direct child of AccordionContent (role=region) with mb-2. */
+.response-section-wrapper [data-orientation="vertical"] [role="region"] > .prose-no-margin.mb-2,
+.response-section-wrapper
+  [data-orientation="vertical"]
+  [role="region"]
+  > div
+  > .prose-no-margin.mb-2 {
+  display: none !important;
+}
+
+/* Remove left padding on accordion content so it aligns with Path Parameters */
+.response-section-wrapper [data-orientation="vertical"] [role="region"] {
+  padding-inline-start: 0 !important;
+}
+
+/* Response section header */
+.response-section-header {
+  display: flex;
+  align-items: center;
+  gap: 1rem;
+  margin-top: 1.75rem;
+  margin-bottom: 0.5rem;
+}
+
+.response-section-title {
+  font-size: 1.5rem;
+  font-weight: 600;
+  margin: 0;
+  color: var(--color-fd-foreground);
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, -apple-system, sans-serif;
+}
+
+.response-section-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-left: auto;
+}
+
+/* Status code dropdown */
+.response-section-dropdown-wrapper {
+  position: relative;
+}
+
+.response-section-dropdown-trigger {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.125rem 0.25rem;
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--color-fd-muted-foreground);
+  background: none;
+  border: none;
+  cursor: pointer;
+  border-radius: 0.25rem;
+  transition: color 0.15s;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+.response-section-dropdown-trigger:hover {
+  color: var(--color-fd-foreground);
+}
+
+.response-section-chevron {
+  width: 0.75rem;
+  height: 0.75rem;
+  transition: transform 0.15s;
+}
+.response-section-chevron-open {
+  transform: rotate(180deg);
+}
+
+.response-section-dropdown-menu {
+  position: absolute;
+  top: calc(100% + 0.25rem);
+  left: 0;
+  z-index: 50;
+  min-width: 5rem;
+  background-color: white;
+  border: 1px solid rgb(229 231 235);
+  border-radius: 0.5rem;
+  box-shadow:
+    0 4px 6px -1px rgb(0 0 0 / 0.1),
+    0 2px 4px -2px rgb(0 0 0 / 0.1);
+  padding: 0.25rem;
+  overflow: hidden;
+}
+html.dark .response-section-dropdown-menu {
+  background-color: rgb(24 24 27);
+  border-color: rgb(63 63 70);
+  box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.3);
+}
+
+.response-section-dropdown-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  width: 100%;
+  padding: 0.375rem 0.5rem;
+  font-size: 0.875rem;
+  color: var(--color-fd-muted-foreground);
+  background: none;
+  border: none;
+  cursor: pointer;
+  border-radius: 0.25rem;
+  transition:
+    background-color 0.1s,
+    color 0.1s;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+.response-section-dropdown-item:hover {
+  background-color: rgb(243 244 246);
+  color: var(--color-fd-foreground);
+}
+html.dark .response-section-dropdown-item:hover {
+  background-color: rgb(39 39 42);
+}
+.response-section-dropdown-item-selected {
+  color: var(--color-fd-foreground);
+}
+
+.response-section-check {
+  width: 0.875rem;
+  height: 0.875rem;
+}
+
+.response-section-content-type {
+  font-size: 0.875rem;
+  color: var(--color-fd-muted-foreground);
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+
+/* Response schema container — remove border to match Path Parameters style */
+.response-section-wrapper [data-orientation="vertical"] .border.px-3.py-2.rounded-lg {
+  border: none !important;
+  padding: 0 !important;
+  border-radius: 0 !important;
+  background-color: transparent;
+}
+
+/* Property row — reorder: name (1) → type badge (2) → required badge (3) */
+#nd-page:has(.api-page-header) .flex.flex-wrap.items-center.gap-3.not-prose {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+/* Name span — order 1 */
+#nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.font-medium.font-mono.text-fd-primary {
+  order: 1;
+}
+
+/* Type badge — order 2, grey pill */
+#nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.text-sm.font-mono.text-fd-muted-foreground {
+  order: 2;
+  background-color: rgb(241 245 249);
+  color: rgb(71 85 105);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.text-sm.font-mono.text-fd-muted-foreground {
+  background-color: rgb(51 51 56);
+  color: rgb(212 212 220);
+}
+
+/* Hide the "*" inside the name span — we'll add "required" as a ::after on the flex row */
+#nd-page:has(.api-page-header) span.font-medium.font-mono.text-fd-primary > span.text-red-400 {
+  display: none;
+}
+
+/* Required badge — order 3, red pill */
+#nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose:has(span.text-red-400)::after {
+  content: "required";
+  order: 3;
+  display: inline-flex;
+  align-items: center;
+  background-color: rgb(254 226 226);
+  color: rgb(185 28 28);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose:has(span.text-red-400)::after {
+  background-color: rgb(153 27 27 / 0.3);
+  color: rgb(252 165 165);
+}
+
+/* Optional "?" indicator — hide it */
+#nd-page:has(.api-page-header)
+  span.font-medium.font-mono.text-fd-primary
+  > span.text-fd-muted-foreground {
+  display: none;
+}
+
+/* Hide the auth scheme type label (e.g. "apiKey") next to Authorization heading */
+#nd-page:has(.api-page-header) .flex.items-start.justify-between.gap-2 > div.not-prose {
+  display: none !important;
+}
+
+/* Auth property — replace "<token>" with "string" badge, add "header" and "required" badges.
+   Auth properties use my-4 (vs py-4 for regular properties). */
+
+/* Auth property flex row — name: order 1, type: order 2, ::before "header": order 3, ::after "required": order 4 */
+#nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.font-medium.font-mono.text-fd-primary {
+  order: 1;
+}
+#nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.text-sm.font-mono.text-fd-muted-foreground {
+  order: 2;
+  font-size: 0;
+  padding: 0 !important;
+  background: none !important;
+  line-height: 0;
+}
+#nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.text-sm.font-mono.text-fd-muted-foreground::after {
+  content: "string";
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+  background-color: rgb(241 245 249);
+  color: rgb(71 85 105);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  display: inline-flex;
+  align-items: center;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose
+  > span.text-sm.font-mono.text-fd-muted-foreground::after {
+  background-color: rgb(51 51 56);
+  color: rgb(212 212 220);
+}
+
+/* "header" badge via ::before on the auth flex row */
+#nd-page:has(.api-page-header) div.my-4 > .flex.flex-wrap.items-center.gap-3.not-prose::before {
+  content: "header";
+  order: 3;
+  display: inline-flex;
+  align-items: center;
+  background-color: rgb(241 245 249);
+  color: rgb(71 85 105);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose::before {
+  background-color: rgb(51 51 56);
+  color: rgb(212 212 220);
+}
+
+/* "required" badge via ::after on the auth flex row — red pill */
+#nd-page:has(.api-page-header) div.my-4 > .flex.flex-wrap.items-center.gap-3.not-prose::after {
+  content: "required";
+  order: 4;
+  display: inline-flex;
+  align-items: center;
+  background-color: rgb(254 226 226);
+  color: rgb(185 28 28);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+html.dark
+  #nd-page:has(.api-page-header)
+  div.my-4
+  > .flex.flex-wrap.items-center.gap-3.not-prose::after {
+  background-color: rgb(153 27 27 / 0.3);
+  color: rgb(252 165 165);
+}
+
+/* Hide "In: header" text below auth property — redundant with the header badge */
+#nd-page:has(.api-page-header) div.my-4 .prose-no-margin p:has(> code) {
+  display: none !important;
+}
+
+/* Section dividers — bottom border after Authorization and Body sections. */
+.api-section-divider {
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid rgb(229 231 235 / 0.6);
+}
+html.dark .api-section-divider {
+  border-bottom-color: rgb(255 255 255 / 0.07);
+}
+
+/* Property rows — breathing room like Mintlify.
+   Regular properties use border-t py-4; auth properties use border-t my-4. */
+#nd-page:has(.api-page-header) .text-sm.border-t.py-4 {
+  padding-top: 1.25rem !important;
+  padding-bottom: 1.25rem !important;
+}
+#nd-page:has(.api-page-header) .text-sm.border-t.my-4 {
+  margin-top: 1.25rem !important;
+  margin-bottom: 1.25rem !important;
+  padding-top: 1.25rem;
+}
+
+/* Divider lines between fields — very subtle like Mintlify */
+#nd-page:has(.api-page-header) .text-sm.border-t {
+  border-color: rgb(229 231 235 / 0.6);
+}
+html.dark #nd-page:has(.api-page-header) .text-sm.border-t {
+  border-color: rgb(255 255 255 / 0.07);
+}
+
+/* Body/Callback section "application/json" label — remove inline code styling */
+#nd-page:has(.api-page-header) .flex.gap-2.items-center.justify-between p.not-prose code.text-xs,
+#nd-page:has(.api-page-header) .flex.justify-between.gap-2.items-end p.not-prose code.text-xs {
+  background: none !important;
+  border: none !important;
+  padding: 0 !important;
+  color: var(--color-fd-muted-foreground) !important;
+  font-size: 0.875rem !important;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif !important;
+}
+
+/* Object/array type triggers in property rows — order 2 + badge chip styling */
+#nd-page:has(.api-page-header) .flex.flex-wrap.items-center.gap-3.not-prose > button,
+#nd-page:has(.api-page-header) .flex.flex-wrap.items-center.gap-3.not-prose > span:has(> button) {
+  order: 2;
+  background-color: rgb(241 245 249);
+  color: rgb(71 85 105);
+  padding: 0.1875rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.6875rem;
+  line-height: 1.125rem;
+  font-weight: 500;
+  font-family: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif;
+}
+html.dark #nd-page:has(.api-page-header) .flex.flex-wrap.items-center.gap-3.not-prose > button,
+html.dark
+  #nd-page:has(.api-page-header)
+  .flex.flex-wrap.items-center.gap-3.not-prose
+  > span:has(> button) {
+  background-color: rgb(51 51 56);
+  color: rgb(212 212 220);
+}
+
+/* Section headings (Authorization, Path Parameters, etc.) — consistent top spacing */
+#nd-page:has(.api-page-header) .min-w-0.flex-1 h2 {
+  margin-top: 1.75rem !important;
+  margin-bottom: 0.25rem !important;
+}
+
+/* Code examples in right column — wrap long lines instead of horizontal scroll */
+#nd-page:has(.api-page-header) pre {
+  white-space: pre-wrap !important;
+  word-break: break-all !important;
+}
+#nd-page:has(.api-page-header) pre code {
+  width: 100% !important;
+  word-break: break-all !important;
+  overflow-wrap: break-word !important;
+}
+
+/* API page header — constrain title/copy-page to left content column, not full width.
+   Only applies on OpenAPI pages (which have the two-column layout). */
+@media (min-width: 1280px) {
+  .api-page-header {
+    max-width: calc(100% - 400px - 1.5rem);
+  }
+}
+
+/* Footer navigation — constrain to left content column on OpenAPI pages only.
+   Target pages that contain the two-column layout via :has() selector. */
+#nd-page:has(.api-page-header) > div:last-child {
+  max-width: calc(100% - 400px - 1.5rem);
+}
+@media (max-width: 1024px) {
+  #nd-page:has(.api-page-header) > div:last-child {
+    max-width: 100%;
+  }
 }
 
 /* Tailwind v4 content sources */

apps/docs/app/layout.config.tsx

@@ -1,21 +0,0 @@
-import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared'
-
-/**
- * Shared layout configurations
- *
- * you can customise layouts individually from:
- * Home Layout: app/(home)/layout.tsx
- * Docs Layout: app/docs/layout.tsx
- */
-export const baseOptions: BaseLayoutProps = {
-  nav: {
-    title: (
-      <>
-        <svg width='24' height='24' xmlns='http://www.w3.org/2000/svg' aria-label='Logo'>
-          <circle cx={12} cy={12} r={12} fill='currentColor' />
-        </svg>
-        My App
-      </>
-    ),
-  },
-}

apps/docs/app/layout.tsx

@@ -7,26 +7,27 @@ export default function RootLayout({ children }: { children: ReactNode }) {
 export const metadata = {
   metadataBase: new URL('https://docs.sim.ai'),
   title: {
-    default: 'Sim Documentation - Visual Workflow Builder for AI Applications',
+    default: 'Sim Documentation — Build AI Agents & Run Your Agentic Workforce',
     template: '%s',
   },
   description:
-    'Comprehensive documentation for Sim - the visual workflow builder for AI applications. Create powerful AI agents, automation workflows, and data processing pipelines by connecting blocks on a canvas—no coding required.',
+    'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows.',
   keywords: [
-    'AI workflow builder',
-    'visual workflow editor',
-    'AI automation',
-    'workflow automation',
     'AI agents',
-    'no-code AI',
-    'drag and drop workflows',
+    'agentic workforce',
+    'AI agent platform',
+    'open-source AI agents',
+    'agentic workflows',
+    'LLM orchestration',
     'AI integrations',
-    'workflow canvas',
-    'AI Agent Workflow Builder',
-    'workflow orchestration',
-    'agent builder',
-    'AI workflow automation',
-    'visual programming',
+    'knowledge base',
+    'AI automation',
+    'workflow builder',
+    'AI workflow orchestration',
+    'enterprise AI',
+    'AI agent deployment',
+    'intelligent automation',
+    'AI tools',
   ],
   authors: [{ name: 'Sim Team', url: 'https://sim.ai' }],
   creator: 'Sim',
@@ -53,9 +54,9 @@ export const metadata = {
     alternateLocale: ['es_ES', 'fr_FR', 'de_DE', 'ja_JP', 'zh_CN'],
     url: 'https://docs.sim.ai',
     siteName: 'Sim Documentation',
-    title: 'Sim Documentation - Visual Workflow Builder for AI Applications',
+    title: 'Sim Documentation — Build AI Agents & Run Your Agentic Workforce',
     description:
-      'Comprehensive documentation for Sim - the visual workflow builder for AI applications. Create powerful AI agents, automation workflows, and data processing pipelines.',
+      'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows.',
     images: [
       {
         url: 'https://docs.sim.ai/api/og?title=Sim%20Documentation',
@@ -67,9 +68,9 @@ export const metadata = {
   },
   twitter: {
     card: 'summary_large_image',
-    title: 'Sim Documentation - Visual Workflow Builder for AI Applications',
+    title: 'Sim Documentation — Build AI Agents & Run Your Agentic Workforce',
     description:
-      'Comprehensive documentation for Sim - the visual workflow builder for AI applications.',
+      'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows.',
     creator: '@simdotai',
     site: '@simdotai',
     images: ['https://docs.sim.ai/api/og?title=Sim%20Documentation'],

apps/docs/app/llms.txt/route.ts

@@ -37,9 +37,9 @@ export async function GET() {
 
     const manifest = `# Sim Documentation
 
-> Visual Workflow Builder for AI Applications
+> The open-source platform to build AI agents and run your agentic workforce.
 
-Sim is a visual workflow builder for AI applications that lets you build AI agent workflows visually. Create powerful AI agents, automation workflows, and data processing pipelines by connecting blocks on a canvas—no coding required.
+Sim is the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows. Create agents, workflows, knowledge bases, tables, and docs. Trusted by over 100,000 builders.
 
 ## Documentation Overview
 

apps/docs/components/docs-layout/sidebar-components.tsx

@@ -52,15 +52,26 @@ export function SidebarItem({ item }: { item: Item }) {
   )
 }
 
+function isApiReferenceFolder(node: Folder): boolean {
+  if (node.index?.url.includes('/api-reference/')) return true
+  for (const child of node.children) {
+    if (child.type === 'page' && child.url.includes('/api-reference/')) return true
+    if (child.type === 'folder' && isApiReferenceFolder(child)) return true
+  }
+  return false
+}
+
 export function SidebarFolder({ item, children }: { item: Folder; children: ReactNode }) {
   const pathname = usePathname()
   const hasActiveChild = checkHasActiveChild(item, pathname)
+  const isApiRef = isApiReferenceFolder(item)
+  const isOnApiRefPage = stripLangPrefix(pathname).startsWith('/api-reference')
   const hasChildren = item.children.length > 0
-  const [open, setOpen] = useState(hasActiveChild)
+  const [open, setOpen] = useState(hasActiveChild || (isApiRef && isOnApiRefPage))
 
   useEffect(() => {
-    setOpen(hasActiveChild)
-  }, [hasActiveChild])
+    setOpen(hasActiveChild || (isApiRef && isOnApiRefPage))
+  }, [hasActiveChild, isApiRef, isOnApiRefPage])
 
   const active = item.index ? isActive(item.index.url, pathname, false) : false
 
@@ -157,16 +168,18 @@ export function SidebarFolder({ item, children }: { item: Folder; children: Reac
       {hasChildren && (
         <div
           className={cn(
-            'overflow-hidden transition-all duration-200 ease-in-out',
-            open ? 'max-h-[10000px] opacity-100' : 'max-h-0 opacity-0'
+            'grid transition-[grid-template-rows,opacity] duration-200 ease-in-out',
+            open ? 'grid-rows-[1fr] opacity-100' : 'grid-rows-[0fr] opacity-0'
           )}
         >
-          {/* Mobile: simple indent */}
-          <div className='ml-4 flex flex-col gap-0.5 lg:hidden'>{children}</div>
-          {/* Desktop: styled with border */}
-          <ul className='mt-0.5 ml-2 hidden space-y-[0.0625rem] border-gray-200/60 border-l pl-2.5 lg:block dark:border-gray-700/60'>
-            {children}
-          </ul>
+          <div className='overflow-hidden'>
+            {/* Mobile: simple indent */}
+            <div className='ml-4 flex flex-col gap-0.5 lg:hidden'>{children}</div>
+            {/* Desktop: styled with border */}
+            <ul className='mt-0.5 ml-2 hidden space-y-[0.0625rem] border-gray-200/60 border-l pl-2.5 lg:block dark:border-gray-700/60'>
+              {children}
+            </ul>
+          </div>
         </div>
       )}
     </div>

apps/docs/components/docs-layout/toc-footer.tsx

@@ -1,38 +1,36 @@
 'use client'
 
-import { useState } from 'react'
 import { ArrowRight, ChevronRight } from 'lucide-react'
 import Link from 'next/link'
 
 export function TOCFooter() {
-  const [isHovered, setIsHovered] = useState(false)
-
   return (
     <div className='sticky bottom-0 mt-6'>
       <div className='flex flex-col gap-2 rounded-lg border border-border bg-secondary p-6 text-sm'>
         <div className='text-balance font-semibold text-base leading-tight'>
           Start building today
         </div>
-        <div className='text-muted-foreground'>Trusted by over 60,000 builders.</div>
+        <div className='text-muted-foreground'>Trusted by over 100,000 builders.</div>
         <div className='text-muted-foreground'>
-          Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
+          The open-source platform to build AI agents and run your agentic workforce.
         </div>
         <Link
           href='https://sim.ai/signup'
           target='_blank'
           rel='noopener noreferrer'
-          onMouseEnter={() => setIsHovered(true)}
-          onMouseLeave={() => setIsHovered(false)}
-          className='group mt-2 inline-flex h-8 w-fit items-center justify-center gap-1 whitespace-nowrap rounded-[10px] border border-[#2AAD6C] bg-gradient-to-b from-[#3ED990] to-[#2AAD6C] px-3 pr-[10px] pl-[12px] font-medium text-sm text-white shadow-[inset_0_2px_4px_0_#5EE8A8] outline-none transition-all hover:shadow-lg focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50'
+          className='group mt-2 inline-flex h-8 w-fit items-center justify-center gap-2 whitespace-nowrap rounded-[5px] border border-[#33C482] bg-[#33C482] px-[10px] font-medium text-black text-sm outline-none transition-[filter] hover:brightness-110 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50'
           aria-label='Get started with Sim - Sign up for free'
         >
           <span>Get started</span>
-          <span className='inline-flex transition-transform duration-200 group-hover:translate-x-0.5'>
-            {isHovered ? (
-              <ArrowRight className='h-4 w-4' aria-hidden='true' />
-            ) : (
-              <ChevronRight className='h-4 w-4' aria-hidden='true' />
-            )}
+          <span className='relative inline-flex h-4 w-4 transition-transform duration-200 group-hover:translate-x-0.5'>
+            <ChevronRight
+              className='absolute inset-0 h-4 w-4 transition-opacity duration-200 group-hover:opacity-0'
+              aria-hidden='true'
+            />
+            <ArrowRight
+              className='absolute inset-0 h-4 w-4 opacity-0 transition-opacity duration-200 group-hover:opacity-100'
+              aria-hidden='true'
+            />
           </span>
         </Link>
       </div>

apps/docs/components/navbar/navbar.tsx

@@ -1,53 +1,95 @@
 'use client'
 
 import Link from 'next/link'
+import { usePathname } from 'next/navigation'
 import { LanguageDropdown } from '@/components/ui/language-dropdown'
 import { SearchTrigger } from '@/components/ui/search-trigger'
 import { SimLogoFull } from '@/components/ui/sim-logo'
 import { ThemeToggle } from '@/components/ui/theme-toggle'
+import { cn } from '@/lib/utils'
+
+const NAV_TABS = [
+  {
+    label: 'Documentation',
+    href: '/introduction',
+    match: (p: string) => !p.includes('/api-reference'),
+    external: false,
+  },
+  {
+    label: 'API Reference',
+    href: '/api-reference/getting-started',
+    match: (p: string) => p.includes('/api-reference'),
+    external: false,
+  },
+  { label: 'Mothership', href: 'https://sim.ai', external: true },
+] as const
 
 export function Navbar() {
+  const pathname = usePathname()
+
   return (
-    <nav className='sticky top-0 z-50 border-border/50 border-b bg-background/80 backdrop-blur-md backdrop-saturate-150'>
-      {/* Desktop: Single row layout */}
-      <div className='hidden h-16 w-full items-center lg:flex'>
+    <nav className='sticky top-0 z-50 bg-background/80 backdrop-blur-md backdrop-saturate-150'>
+      <div className='hidden w-full flex-col lg:flex'>
+        {/* Top row: logo, search, controls */}
         <div
-          className='relative flex w-full items-center justify-between'
+          className='relative flex h-[52px] w-full items-center justify-between'
           style={{
             paddingLeft: 'calc(var(--sidebar-offset) + 32px)',
             paddingRight: 'calc(var(--toc-offset) + 60px)',
           }}
         >
-          {/* Left cluster: logo */}
-          <div className='flex items-center'>
-            <Link href='/' className='flex min-w-[100px] items-center'>
-              <SimLogoFull className='h-7 w-auto' />
-            </Link>
-          </div>
+          <Link href='/' className='flex min-w-[100px] items-center'>
+            <SimLogoFull className='h-7 w-auto' />
+          </Link>
 
-          {/* Center cluster: search - absolutely positioned to center */}
           <div className='-translate-x-1/2 absolute left-1/2 flex items-center justify-center'>
             <SearchTrigger />
           </div>
 
-          {/* Right cluster aligns with TOC edge */}
-          <div className='flex items-center gap-4'>
-            <Link
-              href='https://sim.ai'
-              target='_blank'
-              rel='noopener noreferrer'
-              className='rounded-xl px-3 py-2 font-normal text-[0.9375rem] text-foreground/60 leading-[1.4] transition-colors hover:bg-foreground/8 hover:text-foreground'
-              style={{
-                fontFamily:
-                  '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif',
-              }}
-            >
-              Platform
-            </Link>
+          <div className='flex items-center gap-1'>
             <LanguageDropdown />
             <ThemeToggle />
           </div>
         </div>
+
+        {/* Divider — only spans content width */}
+        <div
+          className='border-b'
+          style={{
+            marginLeft: 'calc(var(--sidebar-offset) + 32px)',
+            marginRight: 'calc(var(--toc-offset) + 60px)',
+            borderColor: 'rgba(128, 128, 128, 0.1)',
+          }}
+        />
+
+        {/* Bottom row: navigation tabs — border on row, tabs overlap it */}
+        <div
+          className='flex h-[40px] items-stretch gap-6 border-border/20 border-b'
+          style={{
+            paddingLeft: 'calc(var(--sidebar-offset) + 32px)',
+          }}
+        >
+          {NAV_TABS.map((tab) => {
+            const isActive = !tab.external && tab.match(pathname)
+            return (
+              <Link
+                key={tab.label}
+                href={tab.href}
+                {...(tab.external ? { target: '_blank', rel: 'noopener noreferrer' } : {})}
+                className={cn(
+                  '-mb-px relative flex items-center border-b text-[14px] tracking-[-0.01em] transition-colors',
+                  isActive
+                    ? 'border-neutral-400 font-[550] text-neutral-800 dark:border-neutral-500 dark:text-neutral-200'
+                    : 'border-transparent font-medium text-fd-muted-foreground hover:border-neutral-300 hover:text-neutral-600 dark:hover:border-neutral-600 dark:hover:text-neutral-400'
+                )}
+              >
+                {/* Invisible bold text reserves width to prevent layout shift */}
+                <span className='invisible font-[550]'>{tab.label}</span>
+                <span className='absolute'>{tab.label}</span>
+              </Link>
+            )
+          })}
+        </div>
       </div>
     </nav>
   )

apps/docs/components/structured-data.tsx

@@ -25,8 +25,8 @@ export function StructuredData({
     headline: title,
     description: description,
     url: url,
-    datePublished: dateModified || new Date().toISOString(),
-    dateModified: dateModified || new Date().toISOString(),
+    ...(dateModified && { datePublished: dateModified }),
+    ...(dateModified && { dateModified }),
     author: {
       '@type': 'Organization',
       name: 'Sim Team',
@@ -74,7 +74,7 @@ export function StructuredData({
     name: 'Sim Documentation',
     url: baseUrl,
     description:
-      'Comprehensive documentation for Sim visual workflow builder for AI applications. Create powerful AI agents, automation workflows, and data processing pipelines.',
+      'Documentation for Sim — the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows.',
     publisher: {
       '@type': 'Organization',
       name: 'Sim',
@@ -91,12 +91,6 @@ export function StructuredData({
     inLanguage: ['en', 'es', 'fr', 'de', 'ja', 'zh'],
   }
 
-  const faqStructuredData = title.toLowerCase().includes('faq') && {
-    '@context': 'https://schema.org',
-    '@type': 'FAQPage',
-    mainEntity: [],
-  }
-
   const softwareStructuredData = {
     '@context': 'https://schema.org',
     '@type': 'SoftwareApplication',
@@ -104,7 +98,7 @@ export function StructuredData({
     applicationCategory: 'DeveloperApplication',
     operatingSystem: 'Any',
     description:
-      'Visual workflow builder for AI applications. Create powerful AI agents, automation workflows, and data processing pipelines by connecting blocks on a canvas—no coding required.',
+      'Sim is the open-source platform to build AI agents and run your agentic workforce. Connect 1,000+ integrations and LLMs to deploy and orchestrate agentic workflows. Create agents, workflows, knowledge bases, tables, and docs.',
     url: baseUrl,
     author: {
       '@type': 'Organization',
@@ -115,12 +109,13 @@ export function StructuredData({
       category: 'Developer Tools',
     },
     featureList: [
-      'Visual workflow builder with drag-and-drop interface',
-      'AI agent creation and automation',
-      '80+ built-in integrations',
-      'Real-time team collaboration',
-      'Multiple deployment options',
-      'Custom integrations via MCP protocol',
+      'AI agent creation',
+      'Agentic workflow orchestration',
+      '1,000+ integrations',
+      'LLM orchestration (OpenAI, Anthropic, Google, xAI, Mistral, Perplexity)',
+      'Knowledge base creation',
+      'Table creation',
+      'Document creation',
     ],
   }
 
@@ -151,15 +146,6 @@ export function StructuredData({
           }}
         />
       )}
-      {faqStructuredData && (
-        <Script
-          id='faq-structured-data'
-          type='application/ld+json'
-          dangerouslySetInnerHTML={{
-            __html: JSON.stringify(faqStructuredData),
-          }}
-        />
-      )}
       {url === baseUrl && (
         <Script
           id='software-structured-data'

apps/docs/components/ui/animated-blocks.tsx

@@ -0,0 +1,195 @@
+import { memo } from 'react'
+
+const RX = '2.59574'
+
+interface BlockRect {
+  opacity: number
+  width: string
+  height: string
+  fill: string
+  x?: string
+  y?: string
+  transform?: string
+}
+
+const RECTS = {
+  topRight: [
+    { opacity: 1, x: '0', y: '0', width: '16.8626', height: '33.7252', fill: '#2ABBF8' },
+    { opacity: 0.6, x: '0', y: '0', width: '85.3433', height: '16.8626', fill: '#2ABBF8' },
+    { opacity: 1, x: '0', y: '0', width: '16.8626', height: '16.8626', fill: '#2ABBF8' },
+    { opacity: 0.6, x: '34.2403', y: '0', width: '34.2403', height: '33.7252', fill: '#2ABBF8' },
+    { opacity: 1, x: '34.2403', y: '0', width: '16.8626', height: '16.8626', fill: '#2ABBF8' },
+    {
+      opacity: 1,
+      x: '51.6188',
+      y: '16.8626',
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#2ABBF8',
+    },
+    { opacity: 1, x: '68.4812', y: '0', width: '54.6502', height: '16.8626', fill: '#00F701' },
+    { opacity: 0.6, x: '106.268', y: '0', width: '34.2403', height: '33.7252', fill: '#00F701' },
+    { opacity: 0.6, x: '106.268', y: '0', width: '51.103', height: '16.8626', fill: '#00F701' },
+    {
+      opacity: 1,
+      x: '123.6484',
+      y: '16.8626',
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#00F701',
+    },
+    { opacity: 0.6, x: '157.371', y: '0', width: '34.2403', height: '16.8626', fill: '#FFCC02' },
+    { opacity: 1, x: '157.371', y: '0', width: '16.8626', height: '16.8626', fill: '#FFCC02' },
+    { opacity: 0.6, x: '208.993', y: '0', width: '68.4805', height: '16.8626', fill: '#FA4EDF' },
+    { opacity: 0.6, x: '209.137', y: '0', width: '16.8626', height: '33.7252', fill: '#FA4EDF' },
+    { opacity: 0.6, x: '243.233', y: '0', width: '34.2403', height: '33.7252', fill: '#FA4EDF' },
+    { opacity: 1, x: '243.233', y: '0', width: '16.8626', height: '16.8626', fill: '#FA4EDF' },
+    { opacity: 0.6, x: '260.096', y: '0', width: '34.04', height: '16.8626', fill: '#FA4EDF' },
+    {
+      opacity: 1,
+      x: '260.611',
+      y: '16.8626',
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#FA4EDF',
+    },
+  ],
+  bottomLeft: [
+    { opacity: 1, x: '0', y: '0', width: '16.8626', height: '33.7252', fill: '#2ABBF8' },
+    { opacity: 0.6, x: '0', y: '0', width: '85.3433', height: '16.8626', fill: '#2ABBF8' },
+    { opacity: 1, x: '0', y: '0', width: '16.8626', height: '16.8626', fill: '#2ABBF8' },
+    { opacity: 0.6, x: '34.2403', y: '0', width: '34.2403', height: '33.7252', fill: '#2ABBF8' },
+    { opacity: 1, x: '34.2403', y: '0', width: '16.8626', height: '16.8626', fill: '#2ABBF8' },
+    {
+      opacity: 1,
+      x: '51.6188',
+      y: '16.8626',
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#2ABBF8',
+    },
+    { opacity: 1, x: '68.4812', y: '0', width: '54.6502', height: '16.8626', fill: '#00F701' },
+    { opacity: 0.6, x: '106.268', y: '0', width: '34.2403', height: '33.7252', fill: '#00F701' },
+    { opacity: 0.6, x: '106.268', y: '0', width: '51.103', height: '16.8626', fill: '#00F701' },
+    {
+      opacity: 1,
+      x: '123.6484',
+      y: '16.8626',
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#00F701',
+    },
+  ],
+  bottomRight: [
+    {
+      opacity: 0.6,
+      width: '16.8626',
+      height: '33.726',
+      fill: '#FA4EDF',
+      transform: 'matrix(0 1 1 0 0 0)',
+    },
+    {
+      opacity: 0.6,
+      width: '34.241',
+      height: '16.8626',
+      fill: '#FA4EDF',
+      transform: 'matrix(0 1 1 0 16.891 0)',
+    },
+    {
+      opacity: 0.6,
+      width: '16.8626',
+      height: '68.482',
+      fill: '#FA4EDF',
+      transform: 'matrix(-1 0 0 1 33.739 16.888)',
+    },
+    {
+      opacity: 0.6,
+      width: '16.8626',
+      height: '33.726',
+      fill: '#FA4EDF',
+      transform: 'matrix(0 1 1 0 0 33.776)',
+    },
+    {
+      opacity: 1,
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#FA4EDF',
+      transform: 'matrix(-1 0 0 1 33.739 34.272)',
+    },
+    {
+      opacity: 0.6,
+      width: '16.8626',
+      height: '34.24',
+      fill: '#2ABBF8',
+      transform: 'matrix(-1 0 0 1 33.787 68)',
+    },
+    {
+      opacity: 0.4,
+      width: '16.8626',
+      height: '16.8626',
+      fill: '#1A8FCC',
+      transform: 'matrix(-1 0 0 1 33.787 85)',
+    },
+  ],
+} as const satisfies Record<string, readonly BlockRect[]>
+
+const GLOBAL_OPACITY = 0.55
+
+const BlockGroup = memo(function BlockGroup({
+  width,
+  height,
+  viewBox,
+  rects,
+}: {
+  width: number
+  height: number
+  viewBox: string
+  rects: readonly BlockRect[]
+}) {
+  return (
+    <svg
+      width={width}
+      height={height}
+      viewBox={viewBox}
+      fill='none'
+      xmlns='http://www.w3.org/2000/svg'
+      className='h-auto w-full'
+      style={{ opacity: GLOBAL_OPACITY }}
+    >
+      {rects.map((r, i) => (
+        <rect
+          key={i}
+          x={r.x}
+          y={r.y}
+          width={r.width}
+          height={r.height}
+          rx={RX}
+          fill={r.fill}
+          transform={r.transform}
+          opacity={r.opacity}
+        />
+      ))}
+    </svg>
+  )
+})
+
+export function AnimatedBlocks() {
+  return (
+    <div
+      className='pointer-events-none fixed inset-0 z-0 hidden overflow-hidden lg:block'
+      aria-hidden='true'
+    >
+      <div className='absolute top-[93px] right-0 w-[calc(140px+10.76vw)] max-w-[295px]'>
+        <BlockGroup width={295} height={34} viewBox='0 0 295 34' rects={RECTS.topRight} />
+      </div>
+
+      <div className='-left-24 absolute bottom-0 w-[calc(140px+10.76vw)] max-w-[295px] rotate-180'>
+        <BlockGroup width={295} height={34} viewBox='0 0 295 34' rects={RECTS.bottomLeft} />
+      </div>
+
+      <div className='-bottom-2 absolute right-0 w-[calc(16px+1.25vw)] max-w-[34px]'>
+        <BlockGroup width={34} height={102} viewBox='0 0 34 102' rects={RECTS.bottomRight} />
+      </div>
+    </div>
+  )
+}

apps/docs/components/ui/dropdown-menu.tsx

@@ -0,0 +1,73 @@
+'use client'
+
+import * as React from 'react'
+import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu'
+import { Check } from 'lucide-react'
+import { cn } from '@/lib/utils'
+
+const DropdownMenu = DropdownMenuPrimitive.Root
+const DropdownMenuTrigger = DropdownMenuPrimitive.Trigger
+
+const DropdownMenuContent = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content>
+>(({ className, sideOffset = 4, ...props }, ref) => (
+  <DropdownMenuPrimitive.Portal>
+    <DropdownMenuPrimitive.Content
+      ref={ref}
+      sideOffset={sideOffset}
+      className={cn(
+        'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-[var(--radix-dropdown-menu-content-available-height)] min-w-[8rem] origin-[--radix-dropdown-menu-content-transform-origin] overflow-y-auto overflow-x-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md data-[state=closed]:animate-out data-[state=open]:animate-in',
+        className
+      )}
+      {...props}
+    />
+  </DropdownMenuPrimitive.Portal>
+))
+DropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName
+
+const DropdownMenuItem = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item>
+>(({ className, ...props }, ref) => (
+  <DropdownMenuPrimitive.Item
+    ref={ref}
+    className={cn(
+      'relative flex cursor-default select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none transition-colors focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50',
+      className
+    )}
+    {...props}
+  />
+))
+DropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName
+
+const DropdownMenuCheckboxItem = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.CheckboxItem>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.CheckboxItem>
+>(({ className, children, checked, ...props }, ref) => (
+  <DropdownMenuPrimitive.CheckboxItem
+    ref={ref}
+    className={cn(
+      'relative flex cursor-default select-none items-center rounded-sm py-1.5 pr-2 pl-8 text-sm outline-none transition-colors focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50',
+      className
+    )}
+    checked={checked}
+    {...props}
+  >
+    <span className='absolute left-2 flex h-3.5 w-3.5 items-center justify-center'>
+      <DropdownMenuPrimitive.ItemIndicator>
+        <Check className='h-4 w-4' />
+      </DropdownMenuPrimitive.ItemIndicator>
+    </span>
+    {children}
+  </DropdownMenuPrimitive.CheckboxItem>
+))
+DropdownMenuCheckboxItem.displayName = DropdownMenuPrimitive.CheckboxItem.displayName
+
+export {
+  DropdownMenu,
+  DropdownMenuTrigger,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuCheckboxItem,
+}

apps/docs/components/ui/faq.tsx

@@ -0,0 +1,47 @@
+'use client'
+
+import { useState } from 'react'
+import { ChevronRight } from 'lucide-react'
+
+interface FAQItem {
+  question: string
+  answer: string
+}
+
+interface FAQProps {
+  items: FAQItem[]
+  title?: string
+}
+
+export function FAQ({ items, title = 'Common Questions' }: FAQProps) {
+  const [openIndex, setOpenIndex] = useState<number | null>(null)
+
+  return (
+    <div className='mt-12'>
+      <h2 className='mb-4 font-bold text-xl'>{title}</h2>
+      <div className='rounded-xl border border-border'>
+        {items.map((item, index) => (
+          <div key={index} className={index !== items.length - 1 ? 'border-border border-b' : ''}>
+            <button
+              type='button'
+              onClick={() => setOpenIndex(openIndex === index ? null : index)}
+              className='flex w-full cursor-pointer items-center gap-3 px-5 py-4 text-left font-medium text-[0.9375rem]'
+            >
+              <ChevronRight
+                className={`h-4 w-4 shrink-0 text-fd-muted-foreground transition-transform duration-200 ${
+                  openIndex === index ? 'rotate-90' : ''
+                }`}
+              />
+              {item.question}
+            </button>
+            {openIndex === index && (
+              <div className='px-5 pb-4 pl-12 text-[0.9375rem] text-fd-muted-foreground leading-relaxed'>
+                {item.answer}
+              </div>
+            )}
+          </div>
+        ))}
+      </div>
+    </div>
+  )
+}

apps/docs/components/ui/icon-mapping.ts

@@ -8,49 +8,72 @@ import {
   AhrefsIcon,
   AirtableIcon,
   AirweaveIcon,
+  AlgoliaIcon,
+  AmplitudeIcon,
   ApifyIcon,
   ApolloIcon,
   ArxivIcon,
   AsanaIcon,
+  AshbyIcon,
+  AttioIcon,
   BrainIcon,
+  BrandfetchIcon,
   BrowserUseIcon,
   CalComIcon,
   CalendlyIcon,
   CirclebackIcon,
   ClayIcon,
   ClerkIcon,
+  CloudflareIcon,
   ConfluenceIcon,
   CursorIcon,
+  DatabricksIcon,
   DatadogIcon,
+  DevinIcon,
   DiscordIcon,
   DocumentIcon,
   DropboxIcon,
   DsPyIcon,
+  DubIcon,
   DuckDuckGoIcon,
   DynamoDBIcon,
   ElasticsearchIcon,
   ElevenLabsIcon,
   EnrichSoIcon,
+  EvernoteIcon,
   ExaAIIcon,
   EyeIcon,
+  FathomIcon,
   FirecrawlIcon,
   FirefliesIcon,
+  GammaIcon,
   GithubIcon,
   GitLabIcon,
   GmailIcon,
+  GongIcon,
+  GoogleAdsIcon,
+  GoogleBigQueryIcon,
+  GoogleBooksIcon,
   GoogleCalendarIcon,
+  GoogleContactsIcon,
   GoogleDocsIcon,
   GoogleDriveIcon,
   GoogleFormsIcon,
   GoogleGroupsIcon,
   GoogleIcon,
   GoogleMapsIcon,
+  GoogleMeetIcon,
+  GooglePagespeedIcon,
   GoogleSheetsIcon,
   GoogleSlidesIcon,
+  GoogleTasksIcon,
+  GoogleTranslateIcon,
   GoogleVaultIcon,
   GrafanaIcon,
   GrainIcon,
+  GreenhouseIcon,
   GreptileIcon,
+  HexIcon,
   HubspotIcon,
   HuggingFaceIcon,
   HunterIOIcon,
@@ -66,10 +89,13 @@ import {
   LinearIcon,
   LinkedInIcon,
   LinkupIcon,
+  LoopsIcon,
+  LumaIcon,
   MailchimpIcon,
   MailgunIcon,
   MailServerIcon,
   Mem0Icon,
+  MicrosoftDataverseIcon,
   MicrosoftExcelIcon,
   MicrosoftOneDriveIcon,
   MicrosoftPlannerIcon,
@@ -80,9 +106,12 @@ import {
   MySQLIcon,
   Neo4jIcon,
   NotionIcon,
+  ObsidianIcon,
+  OnePasswordIcon,
   OpenAIIcon,
   OutlookIcon,
   PackageSearchIcon,
+  PagerDutyIcon,
   ParallelIcon,
   PerplexityIcon,
   PineconeIcon,
@@ -94,8 +123,10 @@ import {
   QdrantIcon,
   RDSIcon,
   RedditIcon,
+  RedisIcon,
   ReductoIcon,
   ResendIcon,
+  RevenueCatIcon,
   S3Icon,
   SalesforceIcon,
   SearchIcon,
@@ -123,6 +154,8 @@ import {
   TTSIcon,
   TwilioIcon,
   TypeformIcon,
+  UpstashIcon,
+  VercelIcon,
   VideoIcon,
   WealthboxIcon,
   WebflowIcon,
@@ -143,47 +176,70 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   ahrefs: AhrefsIcon,
   airtable: AirtableIcon,
   airweave: AirweaveIcon,
+  algolia: AlgoliaIcon,
+  amplitude: AmplitudeIcon,
   apify: ApifyIcon,
   apollo: ApolloIcon,
   arxiv: ArxivIcon,
   asana: AsanaIcon,
+  ashby: AshbyIcon,
+  attio: AttioIcon,
+  brandfetch: BrandfetchIcon,
   browser_use: BrowserUseIcon,
   calcom: CalComIcon,
   calendly: CalendlyIcon,
   circleback: CirclebackIcon,
   clay: ClayIcon,
   clerk: ClerkIcon,
+  cloudflare: CloudflareIcon,
   confluence_v2: ConfluenceIcon,
   cursor_v2: CursorIcon,
+  databricks: DatabricksIcon,
   datadog: DatadogIcon,
+  devin: DevinIcon,
   discord: DiscordIcon,
   dropbox: DropboxIcon,
   dspy: DsPyIcon,
+  dub: DubIcon,
   duckduckgo: DuckDuckGoIcon,
   dynamodb: DynamoDBIcon,
   elasticsearch: ElasticsearchIcon,
   elevenlabs: ElevenLabsIcon,
   enrich: EnrichSoIcon,
+  evernote: EvernoteIcon,
   exa: ExaAIIcon,
+  fathom: FathomIcon,
   file_v3: DocumentIcon,
   firecrawl: FirecrawlIcon,
   fireflies_v2: FirefliesIcon,
+  gamma: GammaIcon,
   github_v2: GithubIcon,
   gitlab: GitLabIcon,
   gmail_v2: GmailIcon,
+  gong: GongIcon,
+  google_ads: GoogleAdsIcon,
+  google_bigquery: GoogleBigQueryIcon,
+  google_books: GoogleBooksIcon,
   google_calendar_v2: GoogleCalendarIcon,
+  google_contacts: GoogleContactsIcon,
   google_docs: GoogleDocsIcon,
   google_drive: GoogleDriveIcon,
   google_forms: GoogleFormsIcon,
   google_groups: GoogleGroupsIcon,
   google_maps: GoogleMapsIcon,
+  google_meet: GoogleMeetIcon,
+  google_pagespeed: GooglePagespeedIcon,
   google_search: GoogleIcon,
   google_sheets_v2: GoogleSheetsIcon,
   google_slides_v2: GoogleSlidesIcon,
+  google_tasks: GoogleTasksIcon,
+  google_translate: GoogleTranslateIcon,
   google_vault: GoogleVaultIcon,
   grafana: GrafanaIcon,
   grain: GrainIcon,
+  greenhouse: GreenhouseIcon,
   greptile: GreptileIcon,
+  hex: HexIcon,
   hubspot: HubspotIcon,
   huggingface: HuggingFaceIcon,
   hunter: HunterIOIcon,
@@ -201,10 +257,13 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   linear: LinearIcon,
   linkedin: LinkedInIcon,
   linkup: LinkupIcon,
+  loops: LoopsIcon,
+  luma: LumaIcon,
   mailchimp: MailchimpIcon,
   mailgun: MailgunIcon,
   mem0: Mem0Icon,
   memory: BrainIcon,
+  microsoft_dataverse: MicrosoftDataverseIcon,
   microsoft_excel_v2: MicrosoftExcelIcon,
   microsoft_planner: MicrosoftPlannerIcon,
   microsoft_teams: MicrosoftTeamsIcon,
@@ -213,9 +272,12 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   mysql: MySQLIcon,
   neo4j: Neo4jIcon,
   notion_v2: NotionIcon,
+  obsidian: ObsidianIcon,
   onedrive: MicrosoftOneDriveIcon,
+  onepassword: OnePasswordIcon,
   openai: OpenAIIcon,
   outlook: OutlookIcon,
+  pagerduty: PagerDutyIcon,
   parallel_ai: ParallelIcon,
   perplexity: PerplexityIcon,
   pinecone: PineconeIcon,
@@ -227,8 +289,10 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   qdrant: QdrantIcon,
   rds: RDSIcon,
   reddit: RedditIcon,
+  redis: RedisIcon,
   reducto_v2: ReductoIcon,
   resend: ResendIcon,
+  revenuecat: RevenueCatIcon,
   s3: S3Icon,
   salesforce: SalesforceIcon,
   search: SearchIcon,
@@ -258,6 +322,8 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   twilio_sms: TwilioIcon,
   twilio_voice: TwilioIcon,
   typeform: TypeformIcon,
+  upstash: UpstashIcon,
+  vercel: VercelIcon,
   video_generator_v2: VideoIcon,
   vision_v2: EyeIcon,
   wealthbox: WealthboxIcon,

apps/docs/components/ui/image.tsx

@@ -30,7 +30,7 @@ export function Image({
       <NextImage
         className={cn(
           'overflow-hidden rounded-xl border border-border object-cover shadow-sm',
-          enableLightbox && 'cursor-pointer transition-opacity hover:opacity-90',
+          enableLightbox && 'cursor-pointer transition-opacity hover:opacity-95',
           className
         )}
         alt={alt}

apps/docs/components/ui/lightbox.tsx

@@ -55,8 +55,9 @@ export function Lightbox({ isOpen, onClose, src, alt, type }: LightboxProps) {
           <img
             src={src}
             alt={alt}
-            className='max-h-[calc(100vh-6rem)] max-w-[calc(100vw-6rem)] rounded-xl object-contain'
+            className='max-h-[75vh] max-w-[75vw] cursor-pointer rounded-xl object-contain'
             loading='lazy'
+            onClick={onClose}
           />
         ) : (
           <video
@@ -65,7 +66,8 @@ export function Lightbox({ isOpen, onClose, src, alt, type }: LightboxProps) {
             loop
             muted
             playsInline
-            className='max-h-[calc(100vh-6rem)] max-w-[calc(100vw-6rem)] rounded-xl outline-none focus:outline-none'
+            className='max-h-[75vh] max-w-[75vw] cursor-pointer rounded-xl outline-none focus:outline-none'
+            onClick={onClose}
           />
         )}
       </div>

apps/docs/components/ui/response-section.tsx

@@ -0,0 +1,169 @@
+'use client'
+
+import { useEffect, useRef, useState } from 'react'
+import { ChevronDown } from 'lucide-react'
+import { cn } from '@/lib/utils'
+
+interface ResponseSectionProps {
+  children: React.ReactNode
+}
+
+export function ResponseSection({ children }: ResponseSectionProps) {
+  const containerRef = useRef<HTMLDivElement>(null)
+  const [statusCodes, setStatusCodes] = useState<string[]>([])
+  const [selectedCode, setSelectedCode] = useState<string>('')
+  const [isOpen, setIsOpen] = useState(false)
+  const dropdownRef = useRef<HTMLDivElement>(null)
+
+  function getAccordionItems() {
+    const root = containerRef.current?.querySelector('[data-orientation="vertical"]')
+    if (!root) return []
+    return Array.from(root.children).filter(
+      (el) => el.getAttribute('data-state') !== null
+    ) as HTMLElement[]
+  }
+
+  function showStatusCode(code: string) {
+    const items = getAccordionItems()
+    for (const item of items) {
+      const triggerBtn = item.querySelector('h3 button') as HTMLButtonElement | null
+      const text = triggerBtn?.textContent?.trim() ?? ''
+      const itemCode = text.match(/^\d{3}/)?.[0]
+
+      if (itemCode === code) {
+        item.style.display = ''
+        if (item.getAttribute('data-state') === 'closed' && triggerBtn) {
+          triggerBtn.click()
+        }
+      } else {
+        item.style.display = 'none'
+        if (item.getAttribute('data-state') === 'open' && triggerBtn) {
+          triggerBtn.click()
+        }
+      }
+    }
+  }
+
+  /**
+   * Detect when the fumadocs accordion children mount via MutationObserver,
+   * then extract status codes and show the first one.
+   * Replaces the previous approach that used `children` as a dependency
+   * (which triggered on every render since children is a new object each time).
+   */
+  useEffect(() => {
+    const container = containerRef.current
+    if (!container) return
+
+    const initialize = () => {
+      const items = getAccordionItems()
+      if (items.length === 0) return false
+
+      const codes: string[] = []
+      const seen = new Set<string>()
+
+      for (const item of items) {
+        const triggerBtn = item.querySelector('h3 button')
+        if (triggerBtn) {
+          const text = triggerBtn.textContent?.trim() ?? ''
+          const code = text.match(/^\d{3}/)?.[0]
+          if (code && !seen.has(code)) {
+            seen.add(code)
+            codes.push(code)
+          }
+        }
+      }
+
+      if (codes.length > 0) {
+        setStatusCodes(codes)
+        setSelectedCode(codes[0])
+        showStatusCode(codes[0])
+        return true
+      }
+      return false
+    }
+
+    if (initialize()) return
+
+    const observer = new MutationObserver(() => {
+      if (initialize()) {
+        observer.disconnect()
+      }
+    })
+    observer.observe(container, { childList: true, subtree: true })
+
+    return () => observer.disconnect()
+  }, []) // eslint-disable-line react-hooks/exhaustive-deps
+
+  function handleSelectCode(code: string) {
+    setSelectedCode(code)
+    setIsOpen(false)
+    showStatusCode(code)
+  }
+
+  useEffect(() => {
+    function handleClickOutside(event: MouseEvent) {
+      if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
+        setIsOpen(false)
+      }
+    }
+    document.addEventListener('mousedown', handleClickOutside)
+    return () => document.removeEventListener('mousedown', handleClickOutside)
+  }, [])
+
+  return (
+    <div ref={containerRef} className='response-section-wrapper'>
+      {statusCodes.length > 0 && (
+        <div className='response-section-header'>
+          <h2 className='response-section-title'>Response</h2>
+          <div className='response-section-meta'>
+            <div ref={dropdownRef} className='response-section-dropdown-wrapper'>
+              <button
+                type='button'
+                className='response-section-dropdown-trigger'
+                onClick={() => setIsOpen(!isOpen)}
+              >
+                <span>{selectedCode}</span>
+                <ChevronDown
+                  className={cn(
+                    'response-section-chevron',
+                    isOpen && 'response-section-chevron-open'
+                  )}
+                />
+              </button>
+              {isOpen && (
+                <div className='response-section-dropdown-menu'>
+                  {statusCodes.map((code) => (
+                    <button
+                      key={code}
+                      type='button'
+                      className={cn(
+                        'response-section-dropdown-item',
+                        code === selectedCode && 'response-section-dropdown-item-selected'
+                      )}
+                      onClick={() => handleSelectCode(code)}
+                    >
+                      <span>{code}</span>
+                      {code === selectedCode && (
+                        <svg
+                          className='response-section-check'
+                          viewBox='0 0 24 24'
+                          fill='none'
+                          stroke='currentColor'
+                          strokeWidth='2'
+                        >
+                          <polyline points='20 6 9 17 4 12' />
+                        </svg>
+                      )}
+                    </button>
+                  ))}
+                </div>
+              )}
+            </div>
+            <span className='response-section-content-type'>application/json</span>
+          </div>
+        </div>
+      )}
+      <div className='response-section-content'>{children}</div>
+    </div>
+  )
+}

apps/docs/components/ui/search-trigger.tsx

@@ -15,23 +15,14 @@ export function SearchTrigger() {
   return (
     <button
       type='button'
-      className='flex h-10 w-[460px] cursor-pointer items-center gap-2 rounded-xl border border-border/50 px-3 py-2 text-sm backdrop-blur-xl transition-colors hover:border-border'
-      style={{
-        backgroundColor: 'hsla(0, 0%, 5%, 0.85)',
-        backdropFilter: 'blur(33px) saturate(180%)',
-        WebkitBackdropFilter: 'blur(33px) saturate(180%)',
-        color: 'rgba(255, 255, 255, 0.6)',
-      }}
+      className='flex h-9 w-[360px] cursor-pointer items-center gap-2 rounded-lg border border-border/50 bg-fd-muted/50 px-3 text-[13px] text-fd-muted-foreground transition-colors hover:border-border hover:text-fd-foreground'
       onClick={handleClick}
     >
-      <Search className='h-4 w-4' />
+      <Search className='h-3.5 w-3.5' />
       <span>Search...</span>
-      <kbd
-        className='ml-auto flex items-center gap-0.5 font-medium'
-        style={{ color: 'rgba(255, 255, 255, 0.6)' }}
-      >
-        <span style={{ fontSize: '15px', lineHeight: '1' }}>⌘</span>
-        <span style={{ fontSize: '13px', lineHeight: '1' }}>K</span>
+      <kbd className='ml-auto flex items-center font-medium'>
+        <span className='text-[15px]'>⌘</span>
+        <span className='text-[12px]'>K</span>
       </kbd>
     </button>
   )

apps/docs/components/ui/video.tsx

@@ -38,7 +38,7 @@ export function Video({
         loop={loop}
         muted={muted}
         playsInline={playsInline}
-        className={`${className} ${enableLightbox ? 'cursor-pointer transition-opacity hover:opacity-90' : ''}`}
+        className={`${className} ${enableLightbox ? 'cursor-pointer transition-opacity hover:opacity-95' : ''}`}
         src={getAssetUrl(src)}
         onClick={handleVideoClick}
       />

apps/docs/content/docs/de/api-reference/authentication.mdx

@@ -0,0 +1,94 @@
+---
+title: Authentication
+description: API key types, generation, and how to authenticate requests
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+To access the Sim API, you need an API key. Sim supports two types of API keys — **personal keys** and **workspace keys** — each with different billing and access behaviors.
+
+## Key Types
+
+|  | **Personal Keys** | **Workspace Keys** |
+| --- | --- | --- |
+| **Billed to** | Your individual account | Workspace owner |
+| **Scope** | Across workspaces you have access to | Shared across the workspace |
+| **Managed by** | Each user individually | Workspace admins |
+| **Permissions** | Must be enabled at workspace level | Require admin permissions |
+
+<Callout type="info">
+  Workspace admins can disable personal API key usage for their workspace. If disabled, only workspace keys can be used.
+</Callout>
+
+## Generating API Keys
+
+To generate a key, open the Sim dashboard and navigate to **Settings**, then go to **Sim Keys** and click **Create**.
+
+<Callout type="warn">
+  API keys are only shown once when generated. Store your key securely — you will not be able to view it again.
+</Callout>
+
+## Using API Keys
+
+Pass your API key in the `X-API-Key` header with every request:
+
+<Tabs items={['curl', 'TypeScript', 'Python']}>
+  <Tab value="curl">
+    ```bash
+    curl -X POST https://www.sim.ai/api/workflows/{workflowId}/execute \
+      -H "Content-Type: application/json" \
+      -H "X-API-Key: YOUR_API_KEY" \
+      -d '{"inputs": {}}'
+    ```
+  </Tab>
+  <Tab value="TypeScript">
+    ```typescript
+    const response = await fetch(
+      'https://www.sim.ai/api/workflows/{workflowId}/execute',
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-API-Key': process.env.SIM_API_KEY!,
+        },
+        body: JSON.stringify({ inputs: {} }),
+      }
+    )
+    ```
+  </Tab>
+  <Tab value="Python">
+    ```python
+    import requests
+
+    response = requests.post(
+        "https://www.sim.ai/api/workflows/{workflowId}/execute",
+        headers={
+            "Content-Type": "application/json",
+            "X-API-Key": os.environ["SIM_API_KEY"],
+        },
+        json={"inputs": {}},
+    )
+    ```
+  </Tab>
+</Tabs>
+
+## Where Keys Are Used
+
+API keys authenticate access to:
+
+- **Workflow execution** — run deployed workflows via the API
+- **Logs API** — query workflow execution logs and metrics
+- **MCP servers** — authenticate connections to deployed MCP servers
+- **SDKs** — the [Python](/api-reference/python) and [TypeScript](/api-reference/typescript) SDKs use API keys for all operations
+
+## Security
+
+- Keys use the `sk-sim-` prefix and are encrypted at rest
+- Keys can be revoked at any time from the dashboard
+- Use environment variables to store keys — never hardcode them in source code
+- For browser-based applications, use a backend proxy to avoid exposing keys to the client
+
+<Callout type="warn">
+  Never expose your API key in client-side code. Use a server-side proxy to make authenticated requests on behalf of your frontend.
+</Callout>

apps/docs/content/docs/de/api-reference/getting-started.mdx

@@ -0,0 +1,210 @@
+---
+title: Getting Started
+description: Base URL, first API call, response format, error handling, and pagination
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+import { Step, Steps } from 'fumadocs-ui/components/steps'
+
+## Base URL
+
+All API requests are made to:
+
+```
+https://www.sim.ai
+```
+
+## Quick Start
+
+<Steps>
+
+<Step>
+### Get your API key
+
+Go to the Sim dashboard and navigate to **Settings → Sim Keys**, then click **Create**. See [Authentication](/api-reference/authentication) for details on key types.
+</Step>
+
+<Step>
+### Find your workflow ID
+
+Open a workflow in the Sim editor. The workflow ID is in the URL:
+
+```
+https://www.sim.ai/workspace/{workspaceId}/w/{workflowId}
+```
+
+You can also use the [List Workflows](/api-reference/workflows/listWorkflows) endpoint to get all workflow IDs in a workspace.
+</Step>
+
+<Step>
+### Deploy your workflow
+
+A workflow must be deployed before it can be executed via the API. Click the **Deploy** button in the editor toolbar.
+</Step>
+
+<Step>
+### Make your first request
+
+<Tabs items={['curl', 'TypeScript', 'Python']}>
+  <Tab value="curl">
+    ```bash
+    curl -X POST https://www.sim.ai/api/workflows/{workflowId}/execute \
+      -H "Content-Type: application/json" \
+      -H "X-API-Key: YOUR_API_KEY" \
+      -d '{"inputs": {}}'
+    ```
+  </Tab>
+  <Tab value="TypeScript">
+    ```typescript
+    const response = await fetch(
+      `https://www.sim.ai/api/workflows/${workflowId}/execute`,
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-API-Key': process.env.SIM_API_KEY!,
+        },
+        body: JSON.stringify({ inputs: {} }),
+      }
+    )
+
+    const data = await response.json()
+    console.log(data.output)
+    ```
+  </Tab>
+  <Tab value="Python">
+    ```python
+    import requests
+    import os
+
+    response = requests.post(
+        f"https://www.sim.ai/api/workflows/{workflow_id}/execute",
+        headers={
+            "Content-Type": "application/json",
+            "X-API-Key": os.environ["SIM_API_KEY"],
+        },
+        json={"inputs": {}},
+    )
+
+    data = response.json()
+    print(data["output"])
+    ```
+  </Tab>
+</Tabs>
+</Step>
+
+</Steps>
+
+## Sync vs Async Execution
+
+By default, workflow executions are **synchronous** — the API blocks until the workflow completes and returns the result directly.
+
+For long-running workflows, use **asynchronous execution** by passing `async: true`:
+
+```bash
+curl -X POST https://www.sim.ai/api/workflows/{workflowId}/execute \
+  -H "Content-Type: application/json" \
+  -H "X-API-Key: YOUR_API_KEY" \
+  -d '{"inputs": {}, "async": true}'
+```
+
+This returns immediately with a `taskId`:
+
+```json
+{
+  "success": true,
+  "taskId": "job_abc123",
+  "status": "queued"
+}
+```
+
+Poll the [Get Job Status](/api-reference/workflows/getJobStatus) endpoint until the status is `completed` or `failed`:
+
+```bash
+curl https://www.sim.ai/api/jobs/{taskId} \
+  -H "X-API-Key: YOUR_API_KEY"
+```
+
+<Callout type="info">
+  Job status transitions follow: `queued` → `processing` → `completed` or `failed`. The `output` field is only present when status is `completed`.
+</Callout>
+
+## Response Format
+
+Successful responses include an `output` object with your workflow results and a `limits` object with your current rate limit and usage status:
+
+```json
+{
+  "success": true,
+  "output": {
+    "result": "Hello, world!"
+  },
+  "limits": {
+    "workflowExecutionRateLimit": {
+      "sync": {
+        "requestsPerMinute": 60,
+        "maxBurst": 10,
+        "remaining": 59,
+        "resetAt": "2025-01-01T00:01:00Z"
+      },
+      "async": {
+        "requestsPerMinute": 30,
+        "maxBurst": 5,
+        "remaining": 30,
+        "resetAt": "2025-01-01T00:01:00Z"
+      }
+    },
+    "usage": {
+      "currentPeriodCost": 1.25,
+      "limit": 50.00,
+      "plan": "pro",
+      "isExceeded": false
+    }
+  }
+}
+```
+
+## Error Handling
+
+The API uses standard HTTP status codes. Error responses include a human-readable `error` message:
+
+```json
+{
+  "error": "Workflow not found"
+}
+```
+
+| Status | Meaning | What to do |
+| --- | --- | --- |
+| `400` | Invalid request parameters | Check the `details` array for specific field errors |
+| `401` | Missing or invalid API key | Verify your `X-API-Key` header |
+| `403` | Access denied | Check you have permission for this resource |
+| `404` | Resource not found | Verify the ID exists and belongs to your workspace |
+| `429` | Rate limit exceeded | Wait for the duration in the `Retry-After` header |
+
+<Callout type="info">
+  Use the [Get Usage Limits](/api-reference/usage/getUsageLimits) endpoint to check your current rate limit status and billing usage at any time.
+</Callout>
+
+## Rate Limits
+
+Rate limits depend on your subscription plan and apply separately to synchronous and asynchronous executions. Every execution response includes a `limits` object showing your current rate limit status.
+
+When rate limited, the API returns a `429` response with a `Retry-After` header indicating how many seconds to wait before retrying.
+
+## Pagination
+
+List endpoints (workflows, logs, audit logs) use **cursor-based pagination**:
+
+```bash
+# First page
+curl "https://www.sim.ai/api/v1/logs?limit=20" \
+  -H "X-API-Key: YOUR_API_KEY"
+
+# Next page — use the nextCursor from the previous response
+curl "https://www.sim.ai/api/v1/logs?limit=20&cursor=abc123" \
+  -H "X-API-Key: YOUR_API_KEY"
+```
+
+The response includes a `nextCursor` field. When `nextCursor` is absent or `null`, you have reached the last page.

apps/docs/content/docs/de/api-reference/meta.json

@@ -0,0 +1,18 @@
+{
+  "title": "API Reference",
+  "root": true,
+  "pages": [
+    "getting-started",
+    "authentication",
+    "---SDKs---",
+    "python",
+    "typescript",
+    "---Endpoints---",
+    "(generated)/workflows",
+    "(generated)/logs",
+    "(generated)/usage",
+    "(generated)/audit-logs",
+    "(generated)/tables",
+    "(generated)/files"
+  ]
+}

apps/docs/content/docs/de/api-reference/python.mdx

@@ -0,0 +1,766 @@
+---
+title: Python
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Card, Cards } from 'fumadocs-ui/components/card'
+import { Step, Steps } from 'fumadocs-ui/components/steps'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Das offizielle Python SDK für Sim ermöglicht es Ihnen, Workflows programmatisch aus Ihren Python-Anwendungen heraus mit dem offiziellen Python SDK auszuführen.
+
+<Callout type="info">
+  Das Python SDK unterstützt Python 3.8+ mit Unterstützung für asynchrone Ausführung, automatischer Ratenbegrenzung mit exponentiellem Backoff und Nutzungsverfolgung.
+</Callout>
+
+## Installation
+
+Installieren Sie das SDK mit pip:
+
+```bash
+pip install simstudio-sdk
+```
+
+## Schnellstart
+
+Hier ist ein einfaches Beispiel für den Einstieg:
+
+```python
+from simstudio import SimStudioClient
+
+# Initialize the client
+client = SimStudioClient(
+    api_key="your-api-key-here",
+    base_url="https://sim.ai"  # optional, defaults to https://sim.ai
+)
+
+# Execute a workflow
+try:
+    result = client.execute_workflow("workflow-id")
+    print("Workflow executed successfully:", result)
+except Exception as error:
+    print("Workflow execution failed:", error)
+```
+
+## API-Referenz
+
+### SimStudioClient
+
+#### Konstruktor
+
+```python
+SimStudioClient(api_key: str, base_url: str = "https://sim.ai")
+```
+
+**Parameter:**
+- `api_key` (str): Ihr Sim API-Schlüssel
+- `base_url` (str, optional): Basis-URL für die Sim API
+
+#### Methoden
+
+##### execute_workflow()
+
+Führt einen Workflow mit optionalen Eingabedaten aus.
+
+```python
+result = client.execute_workflow(
+    "workflow-id",
+    input_data={"message": "Hello, world!"},
+    timeout=30.0  # 30 seconds
+)
+```
+
+**Parameter:**
+- `workflow_id` (str): Die ID des auszuführenden Workflows
+- `input_data` (dict, optional): Eingabedaten, die an den Workflow übergeben werden
+- `timeout` (float, optional): Timeout in Sekunden (Standard: 30.0)
+- `stream` (bool, optional): Streaming-Antworten aktivieren (Standard: False)
+- `selected_outputs` (list[str], optional): Block-Ausgaben zum Streamen im Format `blockName.attribute` (z. B. `["agent1.content"]`)
+- `async_execution` (bool, optional): Asynchron ausführen (Standard: False)
+
+**Rückgabewert:** `WorkflowExecutionResult | AsyncExecutionResult`
+
+Wenn `async_execution=True`, wird sofort mit einer Task-ID zum Polling zurückgegeben. Andernfalls wird auf die Fertigstellung gewartet.
+
+##### get_workflow_status()
+
+Ruft den Status eines Workflows ab (Deployment-Status usw.).
+
+```python
+status = client.get_workflow_status("workflow-id")
+print("Is deployed:", status.is_deployed)
+```
+
+**Parameter:**
+- `workflow_id` (str): Die ID des Workflows
+
+**Rückgabe:** `WorkflowStatus`
+
+##### validate_workflow()
+
+Überprüft, ob ein Workflow zur Ausführung bereit ist.
+
+```python
+is_ready = client.validate_workflow("workflow-id")
+if is_ready:
+    # Workflow is deployed and ready
+    pass
+```
+
+**Parameter:**
+- `workflow_id` (str): Die ID des Workflows
+
+**Rückgabe:** `bool`
+
+##### get_job_status()
+
+Ruft den Status einer asynchronen Job-Ausführung ab.
+
+```python
+status = client.get_job_status("task-id-from-async-execution")
+print("Status:", status["status"])  # 'queued', 'processing', 'completed', 'failed'
+if status["status"] == "completed":
+    print("Output:", status["output"])
+```
+
+**Parameter:**
+- `task_id` (str): Die Task-ID, die von der asynchronen Ausführung zurückgegeben wurde
+
+**Rückgabe:** `Dict[str, Any]`
+
+**Antwortfelder:**
+- `success` (bool): Ob die Anfrage erfolgreich war
+- `taskId` (str): Die Task-ID
+- `status` (str): Einer von `'queued'`, `'processing'`, `'completed'`, `'failed'`, `'cancelled'`
+- `metadata` (dict): Enthält `startedAt`, `completedAt` und `duration`
+- `output` (any, optional): Die Workflow-Ausgabe (wenn abgeschlossen)
+- `error` (any, optional): Fehlerdetails (wenn fehlgeschlagen)
+- `estimatedDuration` (int, optional): Geschätzte Dauer in Millisekunden (wenn in Bearbeitung/in Warteschlange)
+
+##### execute_with_retry()
+
+Führt einen Workflow mit automatischer Wiederholung bei Rate-Limit-Fehlern unter Verwendung von exponentiellem Backoff aus.
+
+```python
+result = client.execute_with_retry(
+    "workflow-id",
+    input_data={"message": "Hello"},
+    timeout=30.0,
+    max_retries=3,           # Maximum number of retries
+    initial_delay=1.0,       # Initial delay in seconds
+    max_delay=30.0,          # Maximum delay in seconds
+    backoff_multiplier=2.0   # Exponential backoff multiplier
+)
+```
+
+**Parameter:**
+- `workflow_id` (str): Die ID des auszuführenden Workflows
+- `input_data` (dict, optional): Eingabedaten, die an den Workflow übergeben werden
+- `timeout` (float, optional): Timeout in Sekunden
+- `stream` (bool, optional): Streaming-Antworten aktivieren
+- `selected_outputs` (list, optional): Block-Ausgaben zum Streamen
+- `async_execution` (bool, optional): Asynchron ausführen
+- `max_retries` (int, optional): Maximale Anzahl von Wiederholungen (Standard: 3)
+- `initial_delay` (float, optional): Anfangsverzögerung in Sekunden (Standard: 1.0)
+- `max_delay` (float, optional): Maximale Verzögerung in Sekunden (Standard: 30.0)
+- `backoff_multiplier` (float, optional): Backoff-Multiplikator (Standard: 2.0)
+
+**Rückgabe:** `WorkflowExecutionResult | AsyncExecutionResult`
+
+Die Wiederholungslogik verwendet exponentielles Backoff (1s → 2s → 4s → 8s...) mit ±25% Jitter, um Thundering Herd zu verhindern. Wenn die API einen `retry-after`-Header bereitstellt, wird dieser stattdessen verwendet.
+
+##### get_rate_limit_info()
+
+Ruft die aktuellen Rate-Limit-Informationen aus der letzten API-Antwort ab.
+
+```python
+rate_limit_info = client.get_rate_limit_info()
+if rate_limit_info:
+    print("Limit:", rate_limit_info.limit)
+    print("Remaining:", rate_limit_info.remaining)
+    print("Reset:", datetime.fromtimestamp(rate_limit_info.reset))
+```
+
+**Rückgabewert:** `RateLimitInfo | None`
+
+##### get_usage_limits()
+
+Ruft aktuelle Nutzungslimits und Kontingentinformationen für Ihr Konto ab.
+
+```python
+limits = client.get_usage_limits()
+print("Sync requests remaining:", limits.rate_limit["sync"]["remaining"])
+print("Async requests remaining:", limits.rate_limit["async"]["remaining"])
+print("Current period cost:", limits.usage["currentPeriodCost"])
+print("Plan:", limits.usage["plan"])
+```
+
+**Rückgabewert:** `UsageLimits`
+
+**Antwortstruktur:**
+
+```python
+{
+    "success": bool,
+    "rateLimit": {
+        "sync": {
+            "isLimited": bool,
+            "limit": int,
+            "remaining": int,
+            "resetAt": str
+        },
+        "async": {
+            "isLimited": bool,
+            "limit": int,
+            "remaining": int,
+            "resetAt": str
+        },
+        "authType": str  # 'api' or 'manual'
+    },
+    "usage": {
+        "currentPeriodCost": float,
+        "limit": float,
+        "plan": str  # e.g., 'free', 'pro'
+    }
+}
+```
+
+##### set_api_key()
+
+Aktualisiert den API-Schlüssel.
+
+```python
+client.set_api_key("new-api-key")
+```
+
+##### set_base_url()
+
+Aktualisiert die Basis-URL.
+
+```python
+client.set_base_url("https://my-custom-domain.com")
+```
+
+##### close()
+
+Schließt die zugrunde liegende HTTP-Sitzung.
+
+```python
+client.close()
+```
+
+## Datenklassen
+
+### WorkflowExecutionResult
+
+```python
+@dataclass
+class WorkflowExecutionResult:
+    success: bool
+    output: Optional[Any] = None
+    error: Optional[str] = None
+    logs: Optional[List[Any]] = None
+    metadata: Optional[Dict[str, Any]] = None
+    trace_spans: Optional[List[Any]] = None
+    total_duration: Optional[float] = None
+```
+
+### AsyncExecutionResult
+
+```python
+@dataclass
+class AsyncExecutionResult:
+    success: bool
+    task_id: str
+    status: str  # 'queued'
+    created_at: str
+    links: Dict[str, str]  # e.g., {"status": "/api/jobs/{taskId}"}
+```
+
+### WorkflowStatus
+
+```python
+@dataclass
+class WorkflowStatus:
+    is_deployed: bool
+    deployed_at: Optional[str] = None
+    needs_redeployment: bool = False
+```
+
+### RateLimitInfo
+
+```python
+@dataclass
+class RateLimitInfo:
+    limit: int
+    remaining: int
+    reset: int
+    retry_after: Optional[int] = None
+```
+
+### UsageLimits
+
+```python
+@dataclass
+class UsageLimits:
+    success: bool
+    rate_limit: Dict[str, Any]
+    usage: Dict[str, Any]
+```
+
+### SimStudioError
+
+```python
+class SimStudioError(Exception):
+    def __init__(self, message: str, code: Optional[str] = None, status: Optional[int] = None):
+        super().__init__(message)
+        self.code = code
+        self.status = status
+```
+
+**Häufige Fehlercodes:**
+- `UNAUTHORIZED`: Ungültiger API-Schlüssel
+- `TIMEOUT`: Zeitüberschreitung der Anfrage
+- `RATE_LIMIT_EXCEEDED`: Ratenlimit überschritten
+- `USAGE_LIMIT_EXCEEDED`: Nutzungslimit überschritten
+- `EXECUTION_ERROR`: Workflow-Ausführung fehlgeschlagen
+
+## Beispiele
+
+### Grundlegende Workflow-Ausführung
+
+<Steps>
+  <Step title="Client initialisieren">
+    Richten Sie den SimStudioClient mit Ihrem API-Schlüssel ein.
+  </Step>
+  <Step title="Workflow validieren">
+    Prüfen Sie, ob der Workflow bereitgestellt und zur Ausführung bereit ist.
+  </Step>
+  <Step title="Workflow ausführen">
+    Führen Sie den Workflow mit Ihren Eingabedaten aus.
+  </Step>
+  <Step title="Ergebnis verarbeiten">
+    Verarbeiten Sie das Ausführungsergebnis und behandeln Sie eventuelle Fehler.
+  </Step>
+</Steps>
+
+```python
+import os
+from simstudio import SimStudioClient
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def run_workflow():
+    try:
+        # Check if workflow is ready
+        is_ready = client.validate_workflow("my-workflow-id")
+        if not is_ready:
+            raise Exception("Workflow is not deployed or ready")
+
+        # Execute the workflow
+        result = client.execute_workflow(
+            "my-workflow-id",
+            input_data={
+                "message": "Process this data",
+                "user_id": "12345"
+            }
+        )
+
+        if result.success:
+            print("Output:", result.output)
+            print("Duration:", result.metadata.get("duration") if result.metadata else None)
+        else:
+            print("Workflow failed:", result.error)
+            
+    except Exception as error:
+        print("Error:", error)
+
+run_workflow()
+```
+
+### Fehlerbehandlung
+
+Behandeln Sie verschiedene Fehlertypen, die während der Workflow-Ausführung auftreten können:
+
+```python
+from simstudio import SimStudioClient, SimStudioError
+import os
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def execute_with_error_handling():
+    try:
+        result = client.execute_workflow("workflow-id")
+        return result
+    except SimStudioError as error:
+        if error.code == "UNAUTHORIZED":
+            print("Invalid API key")
+        elif error.code == "TIMEOUT":
+            print("Workflow execution timed out")
+        elif error.code == "USAGE_LIMIT_EXCEEDED":
+            print("Usage limit exceeded")
+        elif error.code == "INVALID_JSON":
+            print("Invalid JSON in request body")
+        else:
+            print(f"Workflow error: {error}")
+        raise
+    except Exception as error:
+        print(f"Unexpected error: {error}")
+        raise
+```
+
+### Verwendung des Context-Managers
+
+Verwenden Sie den Client als Context-Manager, um die Ressourcenbereinigung automatisch zu handhaben:
+
+```python
+from simstudio import SimStudioClient
+import os
+
+# Using context manager to automatically close the session
+with SimStudioClient(api_key=os.getenv("SIM_API_KEY")) as client:
+    result = client.execute_workflow("workflow-id")
+    print("Result:", result)
+# Session is automatically closed here
+```
+
+### Batch-Workflow-Ausführung
+
+Führen Sie mehrere Workflows effizient aus:
+
+```python
+from simstudio import SimStudioClient
+import os
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))   
+
+def execute_workflows_batch(workflow_data_pairs):
+    """Execute multiple workflows with different input data."""
+    results = []
+    
+    for workflow_id, input_data in workflow_data_pairs:
+        try:
+            # Validate workflow before execution
+            if not client.validate_workflow(workflow_id):
+                print(f"Skipping {workflow_id}: not deployed")
+                continue
+                
+            result = client.execute_workflow(workflow_id, input_data)
+            results.append({
+                "workflow_id": workflow_id,
+                "success": result.success,
+                "output": result.output,
+                "error": result.error
+            })
+            
+        except Exception as error:
+            results.append({
+                "workflow_id": workflow_id,
+                "success": False,
+                "error": str(error)
+            })
+    
+    return results
+
+# Example usage
+workflows = [
+    ("workflow-1", {"type": "analysis", "data": "sample1"}),
+    ("workflow-2", {"type": "processing", "data": "sample2"}),
+]
+
+results = execute_workflows_batch(workflows)
+for result in results:
+    print(f"Workflow {result['workflow_id']}: {'Success' if result['success'] else 'Failed'}")
+```
+
+### Asynchrone Workflow-Ausführung
+
+Führen Sie Workflows asynchron für langwierige Aufgaben aus:
+
+```python
+import os
+import time
+from simstudio import SimStudioClient
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def execute_async():
+    try:
+        # Start async execution
+        result = client.execute_workflow(
+            "workflow-id",
+            input_data={"data": "large dataset"},
+            async_execution=True  # Execute asynchronously
+        )
+
+        # Check if result is an async execution
+        if hasattr(result, 'task_id'):
+            print(f"Task ID: {result.task_id}")
+            print(f"Status endpoint: {result.links['status']}")
+
+            # Poll for completion
+            status = client.get_job_status(result.task_id)
+
+            while status["status"] in ["queued", "processing"]:
+                print(f"Current status: {status['status']}")
+                time.sleep(2)  # Wait 2 seconds
+                status = client.get_job_status(result.task_id)
+
+            if status["status"] == "completed":
+                print("Workflow completed!")
+                print(f"Output: {status['output']}")
+                print(f"Duration: {status['metadata']['duration']}")
+            else:
+                print(f"Workflow failed: {status['error']}")
+
+    except Exception as error:
+        print(f"Error: {error}")
+
+execute_async()
+```
+
+### Ratenlimitierung und Wiederholung
+
+Behandeln Sie Ratenbegrenzungen automatisch mit exponentiellem Backoff:
+
+```python
+import os
+from simstudio import SimStudioClient, SimStudioError
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def execute_with_retry_handling():
+    try:
+        # Automatically retries on rate limit
+        result = client.execute_with_retry(
+            "workflow-id",
+            input_data={"message": "Process this"},
+            max_retries=5,
+            initial_delay=1.0,
+            max_delay=60.0,
+            backoff_multiplier=2.0
+        )
+
+        print(f"Success: {result}")
+    except SimStudioError as error:
+        if error.code == "RATE_LIMIT_EXCEEDED":
+            print("Rate limit exceeded after all retries")
+
+            # Check rate limit info
+            rate_limit_info = client.get_rate_limit_info()
+            if rate_limit_info:
+                from datetime import datetime
+                reset_time = datetime.fromtimestamp(rate_limit_info.reset)
+                print(f"Rate limit resets at: {reset_time}")
+
+execute_with_retry_handling()
+```
+
+### Nutzungsüberwachung
+
+Überwachen Sie die Nutzung und Limits Ihres Kontos:
+
+```python
+import os
+from simstudio import SimStudioClient
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def check_usage():
+    try:
+        limits = client.get_usage_limits()
+
+        print("=== Rate Limits ===")
+        print("Sync requests:")
+        print(f"  Limit: {limits.rate_limit['sync']['limit']}")
+        print(f"  Remaining: {limits.rate_limit['sync']['remaining']}")
+        print(f"  Resets at: {limits.rate_limit['sync']['resetAt']}")
+        print(f"  Is limited: {limits.rate_limit['sync']['isLimited']}")
+
+        print("\nAsync requests:")
+        print(f"  Limit: {limits.rate_limit['async']['limit']}")
+        print(f"  Remaining: {limits.rate_limit['async']['remaining']}")
+        print(f"  Resets at: {limits.rate_limit['async']['resetAt']}")
+        print(f"  Is limited: {limits.rate_limit['async']['isLimited']}")
+
+        print("\n=== Usage ===")
+        print(f"Current period cost: ${limits.usage['currentPeriodCost']:.2f}")
+        print(f"Limit: ${limits.usage['limit']:.2f}")
+        print(f"Plan: {limits.usage['plan']}")
+
+        percent_used = (limits.usage['currentPeriodCost'] / limits.usage['limit']) * 100
+        print(f"Usage: {percent_used:.1f}%")
+
+        if percent_used > 80:
+            print("⚠️  Warning: You are approaching your usage limit!")
+
+    except Exception as error:
+        print(f"Error checking usage: {error}")
+
+check_usage()
+```
+
+### Streaming-Workflow-Ausführung
+
+Führen Sie Workflows mit Echtzeit-Streaming-Antworten aus:
+
+```python
+from simstudio import SimStudioClient
+import os
+
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
+
+def execute_with_streaming():
+    """Execute workflow with streaming enabled."""
+    try:
+        # Enable streaming for specific block outputs
+        result = client.execute_workflow(
+            "workflow-id",
+            input_data={"message": "Count to five"},
+            stream=True,
+            selected_outputs=["agent1.content"]  # Use blockName.attribute format
+        )
+
+        print("Workflow result:", result)
+    except Exception as error:
+        print("Error:", error)
+
+execute_with_streaming()
+```
+
+Die Streaming-Antwort folgt dem Server-Sent-Events- (SSE-) Format:
+
+```
+data: {"blockId":"7b7735b9-19e5-4bd6-818b-46aae2596e9f","chunk":"One"}
+
+data: {"blockId":"7b7735b9-19e5-4bd6-818b-46aae2596e9f","chunk":", two"}
+
+data: {"event":"done","success":true,"output":{},"metadata":{"duration":610}}
+
+data: [DONE]
+```
+
+**Flask-Streaming-Beispiel:**
+
+```python
+from flask import Flask, Response, stream_with_context
+import requests
+import json
+import os
+
+app = Flask(__name__)
+
+@app.route('/stream-workflow')
+def stream_workflow():
+    """Stream workflow execution to the client."""
+
+    def generate():
+        response = requests.post(
+            'https://sim.ai/api/workflows/WORKFLOW_ID/execute',
+            headers={
+                'Content-Type': 'application/json',
+                'X-API-Key': os.getenv('SIM_API_KEY')
+            },
+            json={
+                'message': 'Generate a story',
+                'stream': True,
+                'selectedOutputs': ['agent1.content']
+            },
+            stream=True
+        )
+
+        for line in response.iter_lines():
+            if line:
+                decoded_line = line.decode('utf-8')
+                if decoded_line.startswith('data: '):
+                    data = decoded_line[6:]  # Remove 'data: ' prefix
+
+                    if data == '[DONE]':
+                        break
+
+                    try:
+                        parsed = json.loads(data)
+                        if 'chunk' in parsed:
+                            yield f"data: {json.dumps(parsed)}\n\n"
+                        elif parsed.get('event') == 'done':
+                            yield f"data: {json.dumps(parsed)}\n\n"
+                            print("Execution complete:", parsed.get('metadata'))
+                    except json.JSONDecodeError:
+                        pass
+
+    return Response(
+        stream_with_context(generate()),
+        mimetype='text/event-stream'
+    )
+
+if __name__ == '__main__':
+    app.run(debug=True)
+```
+
+### Umgebungs­konfiguration
+
+Konfigurieren Sie den Client mit Umgebungsvariablen:
+
+<Tabs items={['Development', 'Production']}>
+  <Tab value="Development">
+
+    ```python
+    import os
+    from simstudio import SimStudioClient
+
+    # Development configuration
+    client = SimStudioClient(
+        api_key=os.getenv("SIM_API_KEY")
+        base_url=os.getenv("SIM_BASE_URL", "https://sim.ai")
+    )
+    ```
+
+  </Tab>
+  <Tab value="Production">
+
+    ```python
+    import os
+    from simstudio import SimStudioClient
+
+    # Production configuration with error handling
+    api_key = os.getenv("SIM_API_KEY")
+    if not api_key:
+        raise ValueError("SIM_API_KEY environment variable is required")
+
+    client = SimStudioClient(
+        api_key=api_key,
+        base_url=os.getenv("SIM_BASE_URL", "https://sim.ai")
+    )
+    ```
+
+  </Tab>
+</Tabs>
+
+## Ihren API-Schlüssel erhalten
+
+<Steps>
+  <Step title="Bei Sim anmelden">
+    Navigieren Sie zu [Sim](https://sim.ai) und melden Sie sich in Ihrem Konto an.
+  </Step>
+  <Step title="Workflow öffnen">
+    Navigieren Sie zu dem Workflow, den Sie programmatisch ausführen möchten.
+  </Step>
+  <Step title="Workflow bereitstellen">
+    Klicken Sie auf "Bereitstellen", um Ihren Workflow bereitzustellen, falls dies noch nicht geschehen ist.
+  </Step>
+  <Step title="API-Schlüssel erstellen oder auswählen">
+    Wählen oder erstellen Sie während des Bereitstellungsprozesses einen API-Schlüssel.
+  </Step>
+  <Step title="API-Schlüssel kopieren">
+    Kopieren Sie den API-Schlüssel, um ihn in Ihrer Python-Anwendung zu verwenden.
+  </Step>
+</Steps>
+
+## Voraussetzungen
+
+- Python 3.8+
+- requests >= 2.25.0
+
+## Lizenz
+
+Apache-2.0

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

@@ -152,3 +152,9 @@ Input → Agent (Google Search, Notion) → Function (Compile Report)
 - **Sei spezifisch in System-Prompts**: Definiere die Rolle, den Ton und die Einschränkungen des Agenten klar. Je spezifischer deine Anweisungen sind, desto besser kann der Agent seinen vorgesehenen Zweck erfüllen.
 - **Wähle die richtige Temperatureinstellung**: Verwende niedrigere Temperatureinstellungen (0-0,3), wenn Genauigkeit wichtig ist, oder erhöhe die Temperatur (0,7-2,0) für kreativere oder vielfältigere Antworten
 - **Nutze Tools effektiv**: Integriere Tools, die den Zweck des Agenten ergänzen und seine Fähigkeiten erweitern. Sei selektiv bei der Auswahl der Tools, um den Agenten nicht zu überfordern. Für Aufgaben mit wenig Überschneidung verwende einen anderen Agent-Block für die besten Ergebnisse.
+
+## Best Practices
+
+- **Seien Sie spezifisch in System-Prompts**: Definieren Sie die Rolle, den Ton und die Grenzen des Agenten klar. Je spezifischer Ihre Anweisungen sind, desto besser kann der Agent seinen beabsichtigten Zweck erfüllen.
+- **Wählen Sie die richtige Temperatureinstellung**: Verwenden Sie niedrigere Temperatureinstellungen (0–0,3), wenn Genauigkeit wichtig ist, oder erhöhen Sie die Temperatur (0,7–2,0) für kreativere oder vielfältigere Antworten
+- **Nutzen Sie Tools effektiv**: Integrieren Sie Tools, die den Zweck des Agenten ergänzen und seine Fähigkeiten erweitern. Seien Sie selektiv bei der Auswahl der Tools, um den Agenten nicht zu überfordern. Verwenden Sie für Aufgaben mit geringer Überschneidung einen weiteren Agent-Block für die besten Ergebnisse.

apps/docs/content/docs/de/blocks/loop.mdx

@@ -190,13 +190,8 @@ console.log(`${processedItems} gültige Elemente verarbeitet`);
 
 ### Einschränkungen
 
-<Callout type="warning">
-  Container-Blöcke (Schleifen und Parallele) können nicht ineinander verschachtelt werden. Das bedeutet:
-  - Du kannst keinen Schleifenblock in einen anderen Schleifenblock platzieren
-  - Du kannst keinen Parallel-Block in einen Schleifenblock platzieren
-  - Du kannst keinen Container-Block in einen anderen Container-Block platzieren
-  
-  Wenn du mehrdimensionale Iterationen benötigst, erwäge eine Umstrukturierung deines Workflows, um sequentielle Schleifen zu verwenden oder Daten in Stufen zu verarbeiten.
+<Callout type="info">
+  Container-Blöcke (Schleifen und Parallele) unterstützen Verschachtelung. Du kannst Schleifen in Schleifen, Parallele in Schleifen und jede Kombination von Container-Blöcken platzieren, um komplexe mehrdimensionale Workflows zu erstellen.
 </Callout>
 
 <Callout type="info">
@@ -255,3 +250,57 @@ console.log(`${processedItems} gültige Elemente verarbeitet`);
 - **Setzen Sie vernünftige Grenzen**: Halten Sie die Anzahl der Iterationen in einem vernünftigen Rahmen, um lange Ausführungszeiten zu vermeiden
 - **Verwenden Sie ForEach für Sammlungen**: Verwenden Sie beim Verarbeiten von Arrays oder Objekten ForEach anstelle von For-Schleifen
 - **Behandeln Sie Fehler elegant**: Erwägen Sie, Fehlerbehandlung innerhalb von Schleifen hinzuzufügen, um robuste Workflows zu gewährleisten
+
+## Eingaben und Ausgaben
+
+<Tabs items={['Configuration', 'Variables', 'Results']}>
+  <Tab>
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>Schleifentyp</strong>: Wählen Sie zwischen 'for', 'forEach', 'while' oder 'doWhile'
+      </li>
+      <li>
+        <strong>Iterationen</strong>: Anzahl der Ausführungen (für for-Schleifen)
+      </li>
+      <li>
+        <strong>Sammlung</strong>: Array oder Objekt zum Durchlaufen (für forEach-Schleifen)
+      </li>
+      <li>
+        <strong>Bedingung</strong>: Boolescher Ausdruck zur Auswertung (für while/do-while-Schleifen)
+      </li>
+    </ul>
+  </Tab>
+  <Tab>
+    Verfügbar **innerhalb** der Schleife:
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>{"<loop.index>"}</strong>: Aktuelle Iterationsnummer (0-basiert)
+      </li>
+      <li>
+        <strong>{"<loop.currentItem>"}</strong>: Aktuell verarbeitetes Element (nur forEach)
+      </li>
+      <li>
+        <strong>{"<loop.items>"}</strong>: Vollständige Sammlung (nur forEach)
+      </li>
+    </ul>
+  </Tab>
+  <Tab>
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>{"<blockname.results>"}</strong>: Array aller Iterationsergebnisse (Zugriff über Blocknamen)
+      </li>
+      <li>
+        <strong>Struktur</strong>: Ergebnisse behalten die Iterationsreihenfolge bei
+      </li>
+      <li>
+        <strong>Zugriff</strong>: Verfügbar in Blöcken nach Abschluss der Schleife
+      </li>
+    </ul>
+  </Tab>
+</Tabs>
+
+## Best Practices
+
+- **Setzen Sie vernünftige Grenzen**: Halten Sie die Iterationsanzahl angemessen, um lange Ausführungszeiten zu vermeiden
+- **Verwenden Sie ForEach für Sammlungen**: Verwenden Sie beim Verarbeiten von Arrays oder Objekten ForEach anstelle von For-Schleifen
+- **Behandeln Sie Fehler elegant**: Erwägen Sie, Fehlerbehandlung innerhalb von Schleifen hinzuzufügen, um robuste Workflows zu gewährleisten

apps/docs/content/docs/de/blocks/parallel.mdx

@@ -142,11 +142,8 @@ Jede parallele Instanz läuft unabhängig:
 
 ### Einschränkungen
 
-<Callout type="warning">
-  Container-Blöcke (Schleifen und Parallele) können nicht ineinander verschachtelt werden. Das bedeutet:
-  - Sie können keinen Schleifenblock in einen Parallelblock platzieren
-  - Sie können keinen weiteren Parallelblock in einen Parallelblock platzieren
-  - Sie können keinen Container-Block in einen anderen Container-Block platzieren
+<Callout type="info">
+  Container-Blöcke (Schleifen und Parallele) unterstützen Verschachtelung. Sie können Parallele in Parallele, Schleifen in Parallele und jede Kombination von Container-Blöcken platzieren, um komplexe mehrdimensionale Workflows zu erstellen.
 </Callout>
 
 <Callout type="info">
@@ -214,3 +211,51 @@ Wann Sie welche Methode verwenden sollten:
 - **Nur unabhängige Operationen**: Stellen Sie sicher, dass Operationen nicht voneinander abhängen
 - **Ratenbegrenzungen berücksichtigen**: Fügen Sie Verzögerungen oder Drosselungen für API-intensive Workflows hinzu
 - **Fehlerbehandlung**: Jede Instanz sollte ihre eigenen Fehler angemessen behandeln
+
+## Eingaben und Ausgaben
+
+<Tabs items={['Konfiguration', 'Variablen', 'Ergebnisse']}>
+  <Tab>
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>Parallel-Typ</strong>: Wählen Sie zwischen „count" oder „collection"
+      </li>
+      <li>
+        <strong>Anzahl</strong>: Anzahl der auszuführenden Instanzen (anzahlbasiert)
+      </li>
+      <li>
+        <strong>Collection</strong>: Array oder Objekt zur Verteilung (sammlungsbasiert)
+      </li>
+    </ul>
+  </Tab>
+  <Tab>
+    Verfügbar **innerhalb** der Parallelverarbeitung:
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>{"<parallel.index>"}</strong>: Instanznummer (0-basiert)
+      </li>
+      <li>
+        <strong>{"<parallel.currentItem>"}</strong>: Element für diese Instanz (nur sammlungsbasiert)
+      </li>
+      <li>
+        <strong>{"<parallel.items>"}</strong>: Vollständige Sammlung (nur sammlungsbasiert)
+      </li>
+    </ul>
+  </Tab>
+  <Tab>
+    <ul className="list-disc space-y-2 pl-6">
+      <li>
+        <strong>{"<blockname.results>"}</strong>: Array aller Instanzergebnisse (Zugriff über Blockname)
+      </li>
+      <li>
+        <strong>Zugriff</strong>: Verfügbar in Blöcken nach Abschluss der Parallelverarbeitung
+      </li>
+    </ul>
+  </Tab>
+</Tabs>
+
+## Best Practices
+
+- **Nur unabhängige Operationen**: Stellen Sie sicher, dass Operationen nicht voneinander abhängen
+- **Rate Limits beachten**: Fügen Sie Verzögerungen oder Drosselung für API-intensive Workflows hinzu
+- **Fehlerbehandlung**: Jede Instanz sollte ihre eigenen Fehler ordnungsgemäß behandeln

apps/docs/content/docs/de/blocks/router.mdx

@@ -100,3 +100,18 @@ Input (Lead) → Router → Agent (Enterprise Sales) or Workflow (Self-serve)
 - **Mit verschiedenen Eingaben testen**: Stellen Sie sicher, dass der Router verschiedene Eingabetypen, Grenzfälle und unerwartete Inhalte verarbeiten kann
 - **Routing-Leistung überwachen**: Überprüfen Sie Routing-Entscheidungen regelmäßig und verfeinern Sie Kriterien basierend auf tatsächlichen Nutzungsmustern
 - **Geeignete Modelle auswählen**: Verwenden Sie Modelle mit starken Argumentationsfähigkeiten für komplexe Routing-Entscheidungen
+
+Wenn der Router keine geeignete Route für den gegebenen Kontext ermitteln kann, leitet er stattdessen zum **Fehlerpfad** weiter, anstatt willkürlich eine Route auszuwählen. Dies geschieht, wenn:
+
+- Der Kontext keiner der definierten Routenbeschreibungen eindeutig entspricht
+- Die KI feststellt, dass keine der verfügbaren Routen geeignet ist
+
+## Best Practices
+
+- **Klare Routenbeschreibungen verfassen**: Jede Routenbeschreibung sollte klar erklären, wann diese Route ausgewählt werden sollte. Seien Sie spezifisch bezüglich der Kriterien.
+- **Routen gegenseitig ausschließend gestalten**: Stellen Sie nach Möglichkeit sicher, dass sich Routenbeschreibungen nicht überschneiden, um mehrdeutige Routing-Entscheidungen zu vermeiden.
+- **Einen Fehlerpfad verbinden**: Behandeln Sie Fälle, in denen keine Route passt, indem Sie einen Fehlerbehandler für ein elegantes Fallback-Verhalten verbinden.
+- **Aussagekräftige Routentitel verwenden**: Routentitel erscheinen im Workflow-Canvas, machen Sie sie daher für bessere Lesbarkeit aussagekräftig.
+- **Mit verschiedenen Eingaben testen**: Stellen Sie sicher, dass der Router verschiedene Eingabetypen, Grenzfälle und unerwartete Inhalte verarbeitet.
+- **Routing-Performance überwachen**: Überprüfen Sie Routing-Entscheidungen regelmäßig und verfeinern Sie Routenbeschreibungen basierend auf tatsächlichen Nutzungsmustern.
+- **Geeignete Modelle wählen**: Verwenden Sie Modelle mit starken Reasoning-Fähigkeiten für komplexe Routing-Entscheidungen.

apps/docs/content/docs/de/copilot/index.mdx

@@ -169,3 +169,175 @@ copilotCost = (inputTokens × inputPrice + outputTokens × (outputPrice × 1.5))
 <Callout type="info">
   Modellpreise werden pro Million Tokens angegeben. Die Berechnung teilt durch 1.000.000, um die tatsächlichen Kosten zu ermitteln. Siehe <a href="/execution/costs">die Seite zur Kostenberechnung</a> für Hintergründe und Beispiele.
 </Callout>
+
+Fahre mit der Maus über eine deiner Nachrichten und klicke auf **Bearbeiten**, um sie zu ändern und erneut zu senden. Dies ist nützlich, um deine Eingaben zu verfeinern.
+
+### Nachrichtenwarteschlange
+
+Wenn du eine Nachricht sendest, während Copilot noch antwortet, wird sie in die Warteschlange gestellt. Du kannst:
+- Warteschlangennachrichten im erweiterbaren Warteschlangenpanel anzeigen
+- Eine Nachricht aus der Warteschlange sofort senden (bricht die aktuelle Antwort ab)
+- Nachrichten aus der Warteschlange entfernen
+
+## Dateianhänge
+
+Klicke auf das Anhang-Symbol, um Dateien mit deiner Nachricht hochzuladen. Unterstützte Dateitypen umfassen:
+- Bilder (Vorschau-Thumbnails werden angezeigt)
+- PDFs
+- Textdateien, JSON, XML
+- Andere Dokumentformate
+
+Dateien werden als anklickbare Thumbnails angezeigt, die in einem neuen Tab geöffnet werden.
+
+## Checkpoints & Änderungen
+
+Wenn Copilot Änderungen an deinem Workflow vornimmt, speichert es Checkpoints, damit du bei Bedarf zurückkehren kannst.
+
+### Checkpoints anzeigen
+
+Fahre mit der Maus über eine Copilot-Nachricht und klicke auf das Checkpoints-Symbol, um gespeicherte Workflow-Zustände für diese Nachricht anzuzeigen.
+
+### Änderungen rückgängig machen
+
+Klicke bei jedem Checkpoint auf **Rückgängig machen**, um deinen Workflow auf diesen Zustand zurückzusetzen. Ein Bestätigungsdialog warnt dich, dass diese Aktion nicht rückgängig gemacht werden kann.
+
+### Änderungen akzeptieren
+
+Wenn Copilot Änderungen vorschlägt, kannst du:
+- **Akzeptieren**: Die vorgeschlagenen Änderungen anwenden (`Mod+Shift+Enter`)
+- **Ablehnen**: Die Änderungen verwerfen und deinen aktuellen Workflow beibehalten
+
+## Denkblöcke
+
+Bei komplexen Anfragen kann Copilot seinen Denkprozess in erweiterbaren Denkblöcken anzeigen:
+
+- Blöcke werden automatisch erweitert, während Copilot denkt
+- Klicken zum manuellen Erweitern/Reduzieren
+- Zeigt die Dauer des Denkprozesses an
+- Hilft dir zu verstehen, wie Copilot zu seiner Lösung gekommen ist
+
+## Optionsauswahl
+
+Wenn Copilot mehrere Optionen präsentiert, kannst du auswählen mit:
+
+| Steuerung | Aktion |
+|---------|--------|
+| **1-9** | Option nach Nummer auswählen |
+| **Pfeiltaste auf/ab** | Zwischen Optionen navigieren |
+| **Eingabetaste** | Hervorgehobene Option auswählen |
+
+Ausgewählte Optionen sind hervorgehoben; nicht ausgewählte Optionen erscheinen durchgestrichen.
+
+## Tastenkombinationen
+
+| Tastenkombination | Aktion |
+|----------|--------|
+| `@` | Kontextmenü öffnen |
+| `/` | Slash-Befehle öffnen |
+| `Arrow Up/Down` | Menüelemente navigieren |
+| `Enter` | Menüelement auswählen |
+| `Esc` | Menüs schließen |
+| `Mod+Shift+Enter` | Copilot-Änderungen akzeptieren |
+
+## Nutzungslimits
+
+Die Copilot-Nutzung wird pro Token des zugrunde liegenden LLM abgerechnet. Wenn Sie Ihr Nutzungslimit erreichen, fordert Copilot Sie auf, Ihr Limit zu erhöhen. Sie können die Nutzung in Schritten (50 $, 100 $) von Ihrer aktuellen Basis aus hinzufügen.
+
+<Callout type="info">
+  Siehe die [Seite zur Kostenberechnung](/execution/costs) für Abrechnungsdetails.
+</Callout>
+## Copilot MCP
+
+Sie können Copilot als MCP-Server in Ihrem bevorzugten Editor oder AI-Client verwenden. Damit können Sie Sim-Workflows direkt aus Tools wie Cursor, Claude Code, Claude Desktop und VS Code erstellen, testen, bereitstellen und verwalten.
+
+### Generieren eines Copilot-API-Schlüssels
+
+Um sich mit dem Copilot-MCP-Server zu verbinden, benötigen Sie einen **Copilot-API-Schlüssel**:
+
+1. Gehen Sie zu [sim.ai](https://sim.ai) und melden Sie sich an
+2. Navigieren Sie zu **Einstellungen** → **Copilot**
+3. Klicken Sie auf **API-Schlüssel generieren**
+4. Kopieren Sie den Schlüssel – er wird nur einmal angezeigt
+
+Der Schlüssel sieht aus wie `sk-sim-copilot-...`. Sie werden ihn in der folgenden Konfiguration verwenden.
+
+### Cursor
+
+Fügen Sie Folgendes zu Ihrer `.cursor/mcp.json` (Projektebene) oder den globalen Cursor-MCP-Einstellungen hinzu:
+
+```json
+{
+  "mcpServers": {
+    "sim-copilot": {
+      "url": "https://www.sim.ai/api/mcp/copilot",
+      "headers": {
+        "X-API-Key": "YOUR_COPILOT_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Ersetzen Sie `YOUR_COPILOT_API_KEY` durch den oben generierten Schlüssel.
+
+### Claude Code
+
+Führen Sie den folgenden Befehl aus, um den Copilot MCP-Server hinzuzufügen:
+
+```bash
+claude mcp add sim-copilot \
+  --transport http \
+  https://www.sim.ai/api/mcp/copilot \
+  --header "X-API-Key: YOUR_COPILOT_API_KEY"
+```
+
+Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
+
+### Claude Desktop
+
+Claude Desktop benötigt [`mcp-remote`](https://www.npmjs.com/package/mcp-remote), um sich mit HTTP-basierten MCP-Servern zu verbinden. Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (`~/Library/Application Support/Claude/claude_desktop_config.json` unter macOS):
+
+```json
+{
+  "mcpServers": {
+    "sim-copilot": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote",
+        "https://www.sim.ai/api/mcp/copilot",
+        "--header",
+        "X-API-Key: YOUR_COPILOT_API_KEY"
+      ]
+    }
+  }
+}
+```
+
+Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
+
+### VS Code
+
+Fügen Sie Folgendes zu Ihrer VS Code `settings.json` oder Workspace `.vscode/settings.json` hinzu:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "sim-copilot": {
+        "type": "http",
+        "url": "https://www.sim.ai/api/mcp/copilot",
+        "headers": {
+          "X-API-Key": "YOUR_COPILOT_API_KEY"
+        }
+      }
+    }
+  }
+}
+```
+
+Ersetzen Sie `YOUR_COPILOT_API_KEY` durch Ihren Schlüssel.
+
+<Callout type="info">
+  Für selbst gehostete Deployments ersetzen Sie `https://www.sim.ai` durch Ihre selbst gehostete Sim-URL.
+</Callout>

apps/docs/content/docs/de/enterprise/index.mdx

@@ -75,3 +75,40 @@ Für selbst gehostete Bereitstellungen können Enterprise-Funktionen über Umgeb
 <Callout type="warn">
   BYOK ist nur im gehosteten Sim verfügbar. Selbst gehostete Deployments konfigurieren AI-Provider-Schlüssel direkt über Umgebungsvariablen.
 </Callout>
+
+Wenn die Abrechnung deaktiviert ist, verwenden Sie die Admin-API zur Verwaltung von Organisationen:
+
+```bash
+# Create an organization
+curl -X POST https://your-instance/api/v1/admin/organizations \
+  -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "My Organization", "ownerId": "user-id-here"}'
+
+# Add a member
+curl -X POST https://your-instance/api/v1/admin/organizations/{orgId}/members \
+  -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"userId": "user-id-here", "role": "admin"}'
+```
+
+### Workspace-Mitglieder
+
+Wenn Einladungen deaktiviert sind, verwenden Sie die Admin-API zur direkten Verwaltung von Workspace-Mitgliedschaften:
+
+```bash
+# Add a user to a workspace
+curl -X POST https://your-instance/api/v1/admin/workspaces/{workspaceId}/members \
+  -H "x-admin-key: YOUR_ADMIN_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"userId": "user-id-here", "permissions": "write"}'
+
+# Remove a user from a workspace
+curl -X DELETE "https://your-instance/api/v1/admin/workspaces/{workspaceId}/members?userId=user-id-here" \
+  -H "x-admin-key: YOUR_ADMIN_API_KEY"
+```
+
+### Hinweise
+
+- Die Aktivierung von `ACCESS_CONTROL_ENABLED` aktiviert automatisch Organisationen, da die Zugriffskontrolle eine Organisationsmitgliedschaft erfordert.
+- Wenn `DISABLE_INVITATIONS` gesetzt ist, können Benutzer keine Einladungen versenden. Verwenden Sie stattdessen die Admin-API zur Verwaltung von Workspace- und Organisationsmitgliedschaften.

apps/docs/content/docs/de/execution/costs.mdx

@@ -241,4 +241,45 @@ Dies verteilt große Mehrverbrauchsgebühren über den Monat, anstatt einer gro
 - Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
 - Erfahren Sie mehr über [Protokollierung](/execution/logging), um Ausführungsdetails zu verfolgen
 - Entdecken Sie die [externe API](/execution/api) für programmatische Kostenüberwachung
-- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren
+- Sehen Sie sich [Workflow-Optimierungstechniken](/blocks) an, um Kosten zu reduzieren
+
+**Pro-Tarif (20 $/Monat):**
+- Monatliches Abonnement beinhaltet 20 $ Nutzung
+- Nutzung unter 20 $ → Keine zusätzlichen Gebühren
+- Nutzung über 20 $ → Mehrverbrauch wird am Monatsende abgerechnet
+- Beispiel: 35 $ Nutzung = 20 $ (Abonnement) + 15 $ (Mehrverbrauch)
+
+**Team-Tarif (40 $/Platz/Monat):**
+- Gemeinsame Nutzung über alle Teammitglieder hinweg
+- Mehrverbrauch wird aus der gesamten Teamnutzung berechnet
+- Der Organisationsinhaber erhält eine Rechnung
+
+**Enterprise-Tarife:**
+- Fester Monatspreis, keine Mehrverbräuche
+- Individuelle Nutzungslimits gemäß Vereinbarung
+
+### Schwellenwertabrechnung
+
+Wenn der nicht abgerechnete Mehrverbrauch 50 $ erreicht, rechnet Sim automatisch den gesamten nicht abgerechneten Betrag ab.
+
+**Beispiel:**
+- Tag 10: 70 $ Mehrverbrauch → 70 $ sofort abrechnen
+- Tag 15: Weitere 35 $ Nutzung (105 $ gesamt) → Bereits abgerechnet, keine Aktion
+- Tag 20: Weitere 50 $ Nutzung (155 $ gesamt, 85 $ nicht abgerechnet) → 85 $ sofort abrechnen
+
+Dies verteilt hohe Mehrverbrauchsgebühren über den Monat hinweg, anstatt einer großen Rechnung am Periodenende.
+
+## Best Practices für das Kostenmanagement
+
+1. **Regelmäßig überwachen**: Überprüfen Sie Ihr Nutzungs-Dashboard häufig, um Überraschungen zu vermeiden
+2. **Budgets festlegen**: Nutzen Sie Tariflimits als Leitplanken für Ihre Ausgaben
+3. **Workflows optimieren**: Überprüfen Sie kostenintensive Ausführungen und optimieren Sie Prompts oder Modellauswahl
+4. **Passende Modelle verwenden**: Stimmen Sie die Modellkomplexität auf die Aufgabenanforderungen ab
+5. **Ähnliche Aufgaben bündeln**: Kombinieren Sie mehrere Anfragen, wenn möglich, um den Overhead zu reduzieren
+
+## Nächste Schritte
+
+- Überprüfen Sie Ihre aktuelle Nutzung unter [Einstellungen → Abonnement](https://sim.ai/settings/subscription)
+- Erfahren Sie mehr über [Protokollierung](/execution/logging), um Ausführungsdetails zu verfolgen
+- Erkunden Sie die [externe API](/execution/api) für programmatische Kostenüberwachung
+- Informieren Sie sich über [Workflow-Optimierungstechniken](/blocks), um Kosten zu reduzieren

apps/docs/content/docs/de/execution/files.mdx

@@ -0,0 +1,172 @@
+---
+title: Dateien übergeben
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Sim macht es einfach, mit Dateien in Ihren Workflows zu arbeiten. Blöcke können Dateien empfangen, verarbeiten und nahtlos an andere Blöcke weitergeben.
+
+## Dateiobjekte
+
+Wenn Blöcke Dateien ausgeben (wie Gmail-Anhänge, generierte Bilder oder geparste Dokumente), geben sie ein standardisiertes Dateiobjekt zurück:
+
+```json
+{
+  "name": "report.pdf",
+  "url": "https://...",
+  "base64": "JVBERi0xLjQK...",
+  "type": "application/pdf",
+  "size": 245678
+}
+```
+
+Sie können auf alle diese Eigenschaften zugreifen, wenn Sie auf Dateien aus vorherigen Blöcken verweisen.
+
+## Der Datei-Block
+
+Der **Datei-Block** ist der universelle Einstiegspunkt für Dateien in Ihren Workflows. Er akzeptiert Dateien aus jeder Quelle und gibt standardisierte Dateiobjekte aus, die mit allen Integrationen funktionieren.
+
+**Eingaben:**
+- **Hochgeladene Dateien** - Dateien direkt per Drag & Drop oder Auswahl hinzufügen
+- **Externe URLs** - Jede öffentlich zugängliche Datei-URL
+- **Dateien von anderen Blöcken** - Dateien von Gmail-Anhängen, Slack-Downloads usw. übergeben
+
+**Ausgaben:**
+- Eine Liste von `UserFile`-Objekten mit konsistenter Struktur (`name`, `url`, `base64`, `type`, `size`)
+- `combinedContent` - Extrahierter Textinhalt aus allen Dateien (für Dokumente)
+
+**Beispielverwendung:**
+
+```
+// Get all files from the File block
+<file.files>
+
+// Get the first file
+<file.files[0]>
+
+// Get combined text content from parsed documents
+<file.combinedContent>
+```
+
+Der Datei-Block führt automatisch folgende Aktionen aus:
+- Erkennt Dateitypen aus URLs und Erweiterungen
+- Extrahiert Text aus PDFs, CSVs und Dokumenten
+- Generiert Base64-Kodierung für Binärdateien
+- Erstellt vorsignierte URLs für sicheren Zugriff
+
+Verwenden Sie den Datei-Block, wenn Sie Dateien aus verschiedenen Quellen normalisieren müssen, bevor Sie sie an andere Blöcke wie Vision, STT oder E-Mail-Integrationen übergeben.
+
+## Dateien zwischen Blöcken übergeben
+
+Verweisen Sie auf Dateien aus vorherigen Blöcken über das Tag-Dropdown. Klicken Sie in ein beliebiges Dateieingabefeld und geben Sie `<` ein, um verfügbare Ausgaben anzuzeigen.
+
+**Häufige Muster:**
+
+```
+// Single file from a block
+<gmail.attachments[0]>
+
+// Pass the whole file object
+<file_parser.files[0]>
+
+// Access specific properties
+<gmail.attachments[0].name>
+<gmail.attachments[0].base64>
+```
+
+Die meisten Blöcke akzeptieren das vollständige Dateiobjekt und extrahieren automatisch, was sie benötigen. Sie müssen `base64` oder `url` in den meisten Fällen nicht manuell extrahieren.
+
+## Workflows mit Dateien auslösen
+
+Wenn Sie einen Workflow über die API aufrufen, der Dateieingaben erwartet, fügen Sie Dateien in Ihre Anfrage ein:
+
+<Tabs items={['Base64', 'URL']}>
+  <Tab value="Base64">
+
+    ```bash
+    curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+      -H "Content-Type: application/json" \
+      -H "x-api-key: YOUR_API_KEY" \
+      -d '{
+        "document": {
+          "name": "report.pdf",
+          "base64": "JVBERi0xLjQK...",
+          "type": "application/pdf"
+        }
+      }'
+    ```
+
+  </Tab>
+  <Tab value="URL">
+
+    ```bash
+    curl -X POST "https://sim.ai/api/workflows/YOUR_WORKFLOW_ID/execute" \
+      -H "Content-Type: application/json" \
+      -H "x-api-key: YOUR_API_KEY" \
+      -d '{
+        "document": {
+          "name": "report.pdf",
+          "url": "https://example.com/report.pdf",
+          "type": "application/pdf"
+        }
+      }'
+    ```
+
+  </Tab>
+</Tabs>
+
+Der Start-Block des Workflows sollte ein Eingabefeld haben, das für den Empfang des Dateiparameters konfiguriert ist.
+
+## Dateien in API-Antworten empfangen
+
+Wenn ein Workflow Dateien ausgibt, sind diese in der Antwort enthalten:
+
+```json
+{
+  "success": true,
+  "output": {
+    "generatedFile": {
+      "name": "output.png",
+      "url": "https://...",
+      "base64": "iVBORw0KGgo...",
+      "type": "image/png",
+      "size": 34567
+    }
+  }
+}
+```
+
+Verwenden Sie `url` für direkte Downloads oder `base64` für Inline-Verarbeitung.
+
+## Blöcke, die mit Dateien arbeiten
+
+**Dateieingaben:**
+- **File** - Dokumente, Bilder und Textdateien parsen
+- **Vision** - Bilder mit KI-Modellen analysieren
+- **Mistral Parser** - Text aus PDFs extrahieren
+
+**Dateiausgaben:**
+- **Gmail** - E-Mail-Anhänge
+- **Slack** - Heruntergeladene Dateien
+- **TTS** - Generierte Audiodateien
+- **Video Generator** - Generierte Videos
+- **Image Generator** - Generierte Bilder
+
+**Dateispeicherung:**
+- **Supabase** - Upload/Download aus dem Speicher
+- **S3** - AWS S3-Operationen
+- **Google Drive** - Drive-Dateioperationen
+- **Dropbox** - Dropbox-Dateioperationen
+
+<Callout type="info">
+  Dateien sind automatisch für nachgelagerte Blöcke verfügbar. Die Ausführungs-Engine übernimmt die gesamte Dateiübertragung und Formatkonvertierung.
+</Callout>
+
+## Best Practices
+
+1. **Dateiobjekte direkt verwenden** - Übergeben Sie das vollständige Dateiobjekt, anstatt einzelne Eigenschaften zu extrahieren. Blöcke übernehmen die Konvertierung automatisch.
+
+2. **Dateitypen prüfen** - Stellen Sie sicher, dass der Dateityp mit dem übereinstimmt, was der empfangende Block erwartet. Der Vision-Block benötigt Bilder, der File-Block verarbeitet Dokumente.
+
+3. **Dateigröße beachten** – Große Dateien erhöhen die Ausführungszeit. Bei sehr großen Dateien sollten Sie Storage-Blöcke (S3, Supabase) für die Zwischenspeicherung verwenden.

apps/docs/content/docs/de/execution/form.mdx

@@ -0,0 +1,142 @@
+---
+title: Formular-Bereitstellung
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
+
+Stellen Sie Ihren Workflow als einbettbares Formular bereit, das Benutzer auf Ihrer Website ausfüllen oder per Link teilen können. Formularübermittlungen lösen Ihren Workflow mit dem `form` Trigger-Typ aus.
+
+## Übersicht
+
+Die Formular-Bereitstellung verwandelt das Eingabeformat Ihres Workflows in ein responsives Formular, das:
+- Per Direktlink geteilt werden kann (z. B. `https://sim.ai/form/my-survey`)
+- Mit einem iframe in jede Website eingebettet werden kann
+
+Wenn ein Benutzer das Formular absendet, wird Ihr Workflow mit den Formulardaten ausgelöst.
+
+<Callout type="info">
+Formulare leiten ihre Felder vom Eingabeformat des Start-Blocks Ihres Workflows ab. Jedes Feld wird zu einer Formulareingabe mit dem entsprechenden Typ.
+</Callout>
+
+## Erstellen eines Formulars
+
+1. Öffnen Sie Ihren Workflow und klicken Sie auf **Bereitstellen**
+2. Wählen Sie den Tab **Formular**
+3. Konfigurieren Sie:
+   - **URL**: Eindeutige Kennung (z. B. `contact-form` → `sim.ai/form/contact-form`)
+   - **Titel**: Formularüberschrift
+   - **Beschreibung**: Optionaler Untertitel
+   - **Formularfelder**: Passen Sie Beschriftungen und Beschreibungen für jedes Feld an
+   - **Authentifizierung**: Öffentlich, passwortgeschützt oder E-Mail-Whitelist
+   - **Dankesnachricht**: Wird nach der Übermittlung angezeigt
+4. Klicken Sie auf **Starten**
+
+## Feldzuordnung
+
+| Eingabeformat-Typ | Formularfeld |
+|------------------|------------|
+| `string` | Texteingabe |
+| `number` | Zahleneingabe |
+| `boolean` | Umschalter |
+| `object` | JSON-Editor |
+| `array` | JSON-Array-Editor |
+| `files` | Datei-Upload |
+
+## Zugriffskontrolle
+
+| Modus | Beschreibung |
+|------|-------------|
+| **Öffentlich** | Jeder mit dem Link kann absenden |
+| **Passwort** | Benutzer müssen ein Passwort eingeben |
+| **E-Mail-Whitelist** | Nur angegebene E-Mails/Domains können absenden |
+
+Für E-Mail-Whitelist:
+- Exakt: `user@example.com`
+- Domain: `@example.com` (alle E-Mails von der Domain)
+
+## Einbettung
+
+### Direkter Link
+
+```
+https://sim.ai/form/your-identifier
+```
+
+### Iframe
+
+```html
+<iframe
+  src="https://sim.ai/form/your-identifier"
+  width="100%"
+  height="600"
+  frameborder="0"
+  title="Form"
+></iframe>
+```
+
+## API-Übermittlung
+
+Formulare programmatisch übermitteln:
+
+<Tabs items={['cURL', 'TypeScript']}>
+  <Tab value="cURL">
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+  -H "Content-Type: application/json" \
+  -d '{
+    "formData": {
+      "name": "John Doe",
+      "email": "john@example.com"
+    }
+  }'
+```
+
+  </Tab>
+  <Tab value="TypeScript">
+
+```typescript
+const response = await fetch('https://sim.ai/api/form/your-identifier', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    formData: {
+      name: 'John Doe',
+      email: 'john@example.com'
+    }
+  })
+});
+
+const result = await response.json();
+// { success: true, data: { executionId: '...' } }
+```
+
+  </Tab>
+</Tabs>
+
+### Geschützte Formulare
+
+Für passwortgeschützte Formulare:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+  -H "Content-Type: application/json" \
+  -d '{ "password": "secret", "formData": { "name": "John" } }'
+```
+
+Für E-Mail-geschützte Formulare:
+
+```bash
+curl -X POST https://sim.ai/api/form/your-identifier \
+  -H "Content-Type: application/json" \
+  -d '{ "email": "allowed@example.com", "formData": { "name": "John" } }'
+```
+
+## Fehlerbehebung
+
+**"Keine Eingabefelder konfiguriert"** - Fügen Sie Eingabeformat-Felder zu Ihrem Start-Block hinzu.
+
+**Formular lädt nicht im Iframe** - Überprüfen Sie, ob die CSP Ihrer Website Iframes von `sim.ai` erlaubt.
+
+**Übermittlungen schlagen fehl** - Überprüfen Sie, ob die Kennung korrekt ist und erforderliche Felder ausgefüllt sind.

apps/docs/content/docs/de/keyboard-shortcuts/index.mdx

@@ -41,9 +41,6 @@ Diese Tastenkombinationen wechseln zwischen den Panel-Tabs auf der rechten Seite
 
 | Tastenkombination | Aktion |
 |----------|--------|
-| `C` | Copilot-Tab fokussieren |
-| `T` | Toolbar-Tab fokussieren |
-| `E` | Editor-Tab fokussieren |
 | `Mod` + `F` | Toolbar-Suche fokussieren |
 
 ## Globale Navigation

apps/docs/content/docs/de/meta.json

@@ -0,0 +1,24 @@
+{
+  "title": "Sim Documentation",
+  "pages": [
+    "./introduction/index",
+    "./getting-started/index",
+    "./quick-reference/index",
+    "triggers",
+    "blocks",
+    "tools",
+    "connections",
+    "mcp",
+    "copilot",
+    "skills",
+    "knowledgebase",
+    "variables",
+    "credentials",
+    "execution",
+    "permissions",
+    "self-hosting",
+    "./enterprise/index",
+    "./keyboard-shortcuts/index"
+  ],
+  "defaultOpen": false
+}

apps/docs/content/docs/de/quick-reference/index.mdx

@@ -0,0 +1,394 @@
+---
+title: Kurzreferenz
+description: Wesentliche Aktionen zum Navigieren und Verwenden des Sim-Workflow-Editors
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+import { ActionImage, ActionVideo } from '@/components/ui/action-media'
+
+Eine schnelle Übersicht für alltägliche Aktionen im Sim-Workflow-Editor. Für Tastaturkürzel siehe [Tastaturkürzel](/keyboard-shortcuts).
+
+<Callout type="info">
+  **Mod** bezieht sich auf `Cmd` unter macOS und `Ctrl` unter Windows/Linux.
+</Callout>
+
+## Arbeitsbereiche
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Arbeitsbereich erstellen</td>
+      <td>Arbeitsbereich-Dropdown anklicken → **Neuer Arbeitsbereich**</td>
+      <td><ActionVideo src="quick-reference/create-workspace.mp4" alt="Arbeitsbereich erstellen" /></td>
+    </tr>
+    <tr>
+      <td>Arbeitsbereiche wechseln</td>
+      <td>Arbeitsbereich-Dropdown anklicken → Arbeitsbereich auswählen</td>
+      <td><ActionVideo src="quick-reference/switch-workspace.mp4" alt="Arbeitsbereiche wechseln" /></td>
+    </tr>
+    <tr>
+      <td>Teammitglieder einladen</td>
+      <td>Seitenleiste → **Einladen**</td>
+      <td><ActionVideo src="quick-reference/invite.mp4" alt="Teammitglieder einladen" /></td>
+    </tr>
+    <tr>
+      <td>Arbeitsbereich umbenennen</td>
+      <td>Rechtsklick auf Arbeitsbereich → **Umbenennen**</td>
+      <td rowSpan={4}><ActionImage src="/static/quick-reference/workspace-context-menu.png" alt="Arbeitsbereich-Kontextmenü" /></td>
+    </tr>
+    <tr>
+      <td>Arbeitsbereich duplizieren</td>
+      <td>Rechtsklick auf Arbeitsbereich → **Duplizieren**</td>
+    </tr>
+    <tr>
+      <td>Arbeitsbereich exportieren</td>
+      <td>Rechtsklick auf Arbeitsbereich → **Exportieren**</td>
+    </tr>
+    <tr>
+      <td>Arbeitsbereich löschen</td>
+      <td>Rechtsklick auf Arbeitsbereich → **Löschen**</td>
+    </tr>
+  </tbody>
+</table>
+
+## Workflows
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Workflow erstellen</td>
+      <td>**+**-Schaltfläche in der Seitenleiste anklicken</td>
+      <td><ActionImage src="/static/quick-reference/create-workflow.png" alt="Workflow erstellen" /></td>
+    </tr>
+    <tr>
+      <td>Workflows neu anordnen / verschieben</td>
+      <td>Workflow nach oben/unten oder auf einen Ordner ziehen</td>
+      <td><ActionVideo src="quick-reference/reordering.mp4" alt="Workflows neu anordnen" /></td>
+    </tr>
+    <tr>
+      <td>Workflow importieren</td>
+      <td>Import-Schaltfläche in der Seitenleiste anklicken → Datei auswählen</td>
+      <td><ActionImage src="/static/quick-reference/import-workflow.png" alt="Workflow importieren" /></td>
+    </tr>
+    <tr>
+      <td>Mehrere Workflows auswählen</td>
+      <td>`Mod+Click` oder `Shift+Click` Workflows in der Seitenleiste</td>
+      <td><ActionVideo src="quick-reference/multiselect.mp4" alt="Mehrere Workflows auswählen" /></td>
+    </tr>
+    <tr>
+      <td>In neuem Tab öffnen</td>
+      <td>Rechtsklick auf Workflow → **In neuem Tab öffnen**</td>
+      <td rowSpan={6}><ActionImage src="/static/quick-reference/workflow-context-menu.png" alt="Workflow-Kontextmenü" /></td>
+    </tr>
+    <tr>
+      <td>Workflow umbenennen</td>
+      <td>Rechtsklick auf Workflow → **Umbenennen**</td>
+    </tr>
+    <tr>
+      <td>Workflow-Farbe zuweisen</td>
+      <td>Rechtsklick auf Workflow → **Farbe ändern**</td>
+    </tr>
+    <tr>
+      <td>Workflow duplizieren</td>
+      <td>Rechtsklick auf Workflow → **Duplizieren**</td>
+    </tr>
+    <tr>
+      <td>Workflow exportieren</td>
+      <td>Rechtsklick auf Workflow → **Exportieren**</td>
+    </tr>
+    <tr>
+      <td>Workflow löschen</td>
+      <td>Rechtsklick auf Workflow → **Löschen**</td>
+    </tr>
+    <tr>
+      <td>Ordner umbenennen</td>
+      <td>Rechtsklick auf Ordner → **Umbenennen**</td>
+      <td rowSpan={6}><ActionImage src="/static/quick-reference/folder-context-menu.png" alt="Ordner-Kontextmenü" /></td>
+    </tr>
+    <tr>
+      <td>Workflow in Ordner erstellen</td>
+      <td>Rechtsklick auf Ordner → **Workflow erstellen**</td>
+    </tr>
+    <tr>
+      <td>Ordner in Ordner erstellen</td>
+      <td>Rechtsklick auf Ordner → **Ordner erstellen**</td>
+    </tr>
+    <tr>
+      <td>Ordner duplizieren</td>
+      <td>Rechtsklick auf Ordner → **Duplizieren**</td>
+    </tr>
+    <tr>
+      <td>Ordner exportieren</td>
+      <td>Rechtsklick auf Ordner → **Exportieren**</td>
+    </tr>
+    <tr>
+      <td>Ordner löschen</td>
+      <td>Rechtsklick auf Ordner → **Löschen**</td>
+    </tr>
+  </tbody>
+</table>
+
+## Blöcke
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Block hinzufügen</td>
+      <td>Aus Toolbar-Panel ziehen oder Rechtsklick auf Canvas → **Block hinzufügen**</td>
+      <td><ActionVideo src="quick-reference/add-block.mp4" alt="Block hinzufügen" /></td>
+    </tr>
+    <tr>
+      <td>Mehrere Blöcke auswählen</td>
+      <td>`Mod+Click` zusätzliche Blöcke oder Shift-Ziehen für Auswahlrahmen</td>
+      <td><ActionVideo src="quick-reference/multiselect-blocks.mp4" alt="Mehrere Blöcke auswählen" /></td>
+    </tr>
+    <tr>
+      <td>Blöcke kopieren</td>
+      <td>`Mod+C` mit ausgewählten Blöcken</td>
+      <td rowSpan={2}><ActionVideo src="quick-reference/copy-paste.mp4" alt="Blöcke kopieren und einfügen" /></td>
+    </tr>
+    <tr>
+      <td>Blöcke einfügen</td>
+      <td>`Mod+V` zum Einfügen kopierter Blöcke</td>
+    </tr>
+    <tr>
+      <td>Blöcke duplizieren</td>
+      <td>Rechtsklick → **Duplizieren**</td>
+      <td><ActionVideo src="quick-reference/duplicate-block.mp4" alt="Blöcke duplizieren" /></td>
+    </tr>
+    <tr>
+      <td>Blöcke löschen</td>
+      <td>`Delete` oder `Backspace` Taste oder Rechtsklick → **Löschen**</td>
+      <td><ActionImage src="/static/quick-reference/delete-block.png" alt="Block löschen" /></td>
+    </tr>
+    <tr>
+      <td>Block umbenennen</td>
+      <td>Auf Blocknamen im Header klicken oder im Editor-Panel bearbeiten</td>
+      <td><ActionVideo src="quick-reference/rename-block.mp4" alt="Block umbenennen" /></td>
+    </tr>
+    <tr>
+      <td>Block aktivieren/deaktivieren</td>
+      <td>Rechtsklick → **Aktivieren/Deaktivieren**</td>
+      <td><ActionImage src="/static/quick-reference/disable-block.png" alt="Block deaktivieren" /></td>
+    </tr>
+    <tr>
+      <td>Block sperren/entsperren</td>
+      <td>Über Block hovern → Auf Schloss-Symbol klicken (nur Admin)</td>
+      <td><ActionImage src="/static/quick-reference/lock-block.png" alt="Block sperren" /></td>
+    </tr>
+    <tr>
+      <td>Handle-Ausrichtung umschalten</td>
+      <td>Rechtsklick → **Handles umschalten**</td>
+      <td><ActionVideo src="quick-reference/toggle-handles.mp4" alt="Handle-Ausrichtung umschalten" /></td>
+    </tr>
+    <tr>
+      <td>Block konfigurieren</td>
+      <td>Block auswählen → Editor-Panel rechts verwenden</td>
+      <td><ActionVideo src="quick-reference/configure-block.mp4" alt="Block konfigurieren" /></td>
+    </tr>
+  </tbody>
+</table>
+
+## Verbindungen
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Verbindung erstellen</td>
+      <td>Vom Ausgangs-Handle zum Eingangs-Handle ziehen</td>
+      <td><ActionVideo src="quick-reference/connect-blocks.mp4" alt="Blöcke verbinden" /></td>
+    </tr>
+    <tr>
+      <td>Verbindung löschen</td>
+      <td>Auf Kante klicken zum Auswählen → `Delete` Taste</td>
+      <td><ActionVideo src="quick-reference/delete-connection.mp4" alt="Verbindung löschen" /></td>
+    </tr>
+    <tr>
+      <td>Ausgabe in anderem Block verwenden</td>
+      <td>Verbindungs-Tag in Eingabefeld ziehen</td>
+      <td><ActionVideo src="quick-reference/connection-tag.mp4" alt="Verbindungs-Tag verwenden" /></td>
+    </tr>
+  </tbody>
+</table>
+
+## Panels und Ansichten
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Symbolleiste durchsuchen</td>
+      <td>`Mod+F`</td>
+      <td><ActionVideo src="quick-reference/search-toolbar.mp4" alt="Symbolleiste durchsuchen" /></td>
+    </tr>
+    <tr>
+      <td>Alles durchsuchen</td>
+      <td>`Mod+K`</td>
+      <td><ActionImage src="/static/quick-reference/search-everything.png" alt="Alles durchsuchen" /></td>
+    </tr>
+    <tr>
+      <td>Manuellen Modus umschalten</td>
+      <td>Klicken Sie auf die Umschalt-Schaltfläche, um zwischen manuell und Selektor zu wechseln</td>
+      <td><ActionImage src="/static/quick-reference/toggle-manual-mode.png" alt="Manuellen Modus umschalten" /></td>
+    </tr>
+    <tr>
+      <td>Seitenleiste ein-/ausklappen</td>
+      <td>Klicken Sie auf die Einklappen-Schaltfläche in der Seitenleiste</td>
+      <td><ActionVideo src="quick-reference/collapse-sidebar.mp4" alt="Seitenleiste einklappen" /></td>
+    </tr>
+  </tbody>
+</table>
+
+## Ausführen und Testen
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Workflow ausführen</td>
+      <td>Klicken Sie auf die Schaltfläche Workflow ausführen oder `Mod+Enter`</td>
+      <td><ActionImage src="/static/quick-reference/run-workflow.png" alt="Workflow ausführen" /></td>
+    </tr>
+    <tr>
+      <td>Workflow stoppen</td>
+      <td>Klicken Sie auf die Stopp-Schaltfläche oder `Mod+Enter` während der Ausführung</td>
+      <td><ActionImage src="/static/quick-reference/stop-workflow.png" alt="Workflow stoppen" /></td>
+    </tr>
+    <tr>
+      <td>Mit Chat testen</td>
+      <td>Verwenden Sie das Chat-Panel auf der rechten Seite</td>
+      <td><ActionImage src="/static/quick-reference/test-chat.png" alt="Mit Chat testen" /></td>
+    </tr>
+    <tr>
+      <td>Ausgabe zum Anzeigen auswählen</td>
+      <td>Klicken Sie auf das Dropdown-Menü im Chat-Panel → Wählen Sie Block-Ausgabe aus</td>
+      <td><ActionImage src="/static/quick-reference/output-select.png" alt="Ausgabe zum Anzeigen auswählen" /></td>
+    </tr>
+    <tr>
+      <td>Chat-Verlauf löschen</td>
+      <td>Klicken Sie auf die Löschen-Schaltfläche im Chat-Panel</td>
+      <td><ActionImage src="/static/quick-reference/clear-chat.png" alt="Chat-Verlauf löschen" /></td>
+    </tr>
+    <tr>
+      <td>Ab Block ausführen</td>
+      <td>Bewegen Sie den Mauszeiger über den Block → Klicken Sie auf die Wiedergabe-Schaltfläche oder Rechtsklick → **Ab Block ausführen**</td>
+      <td><ActionImage src="/static/quick-reference/run-from-block.png" alt="Ab Block ausführen" /></td>
+    </tr>
+    <tr>
+      <td>Bis Block ausführen</td>
+      <td>Rechtsklick auf Block → **Bis Block ausführen**</td>
+      <td><ActionImage src="/static/quick-reference/run-until-block.png" alt="Bis Block ausführen" /></td>
+    </tr>
+    <tr>
+      <td>Ausführungsprotokolle anzeigen</td>
+      <td>Öffnen Sie das Terminal-Panel unten oder `Mod+L`</td>
+      <td><ActionImage src="/static/quick-reference/terminal.png" alt="Terminal für Ausführungsprotokolle" /></td>
+    </tr>
+    <tr>
+      <td>Protokolle filtern</td>
+      <td>Klicken Sie auf das Filter-Symbol im Terminal → Filtern Sie nach Block oder Status</td>
+      <td><ActionImage src="/static/quick-reference/filter-block.png" alt="Protokolle nach Block filtern" /></td>
+    </tr>
+    <tr>
+      <td>Protokolle durchsuchen</td>
+      <td>Verwenden Sie das Suchfeld im Terminal oder Rechtsklick auf Protokolleintrag → **Suchen**</td>
+      <td><ActionImage src="/static/quick-reference/terminal-search.png" alt="Protokolle durchsuchen" /></td>
+    </tr>
+    <tr>
+      <td>Protokolleintrag kopieren</td>
+      <td>Zwischenablage-Symbol oder Rechtsklick auf Protokolleintrag → **Kopieren**</td>
+      <td><ActionImage src="/static/quick-reference/copy-log.png" alt="Protokolleintrag kopieren" /></td>
+    </tr>
+    <tr>
+      <td>Terminal leeren</td>
+      <td>Papierkorb-Symbol oder `Mod+D`</td>
+      <td><ActionImage src="/static/quick-reference/clear-terminal.png" alt="Terminal leeren" /></td>
+    </tr>
+  </tbody>
+</table>
+
+## Bereitstellung
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Workflow bereitstellen</td>
+      <td>Klicken Sie auf die Schaltfläche **Bereitstellen** im Panel</td>
+      <td><ActionImage src="/static/quick-reference/deploy.png" alt="Workflow bereitstellen" /></td>
+    </tr>
+    <tr>
+      <td>Bereitstellung aktualisieren</td>
+      <td>Klicken Sie auf **Aktualisieren**, wenn Änderungen erkannt werden</td>
+      <td><ActionImage src="/static/quick-reference/update-deployment.png" alt="Bereitstellung aktualisieren" /></td>
+    </tr>
+    <tr>
+      <td>Bereitstellungsstatus anzeigen</td>
+      <td>Überprüfen Sie die Statusanzeige (Live/Aktualisieren/Bereitstellen) im Tab „Bereitstellen"</td>
+      <td><ActionImage src="/static/quick-reference/view-deployment.png" alt="Bereitstellungsstatus anzeigen" /></td>
+    </tr>
+    <tr>
+      <td>Bereitstellung zurücksetzen</td>
+      <td>Greifen Sie auf frühere Versionen im Tab „Bereitstellen" zu → **Zu Live befördern**</td>
+      <td><ActionImage src="/static/quick-reference/promote-deployment.png" alt="Bereitstellung zu Live befördern" /></td>
+    </tr>
+    <tr>
+      <td>Versionsbeschreibung hinzufügen</td>
+      <td>Tab „Bereitstellen" → Klicken Sie auf das Beschreibungssymbol → Beschreibung hinzufügen oder generieren</td>
+      <td><ActionVideo src="quick-reference/deployment-description.mp4" alt="Versionsbeschreibung für Bereitstellung hinzufügen" /></td>
+    </tr>
+    <tr>
+      <td>API-Endpunkt kopieren</td>
+      <td>Tab „Bereitstellen" → API → API-cURL kopieren</td>
+      <td><ActionImage src="/static/quick-reference/copy-api.png" alt="API-Endpunkt kopieren" /></td>
+    </tr>
+  </tbody>
+</table>
+
+## Variablen
+
+<table>
+  <thead>
+    <tr><th>Aktion</th><th>Wie</th><th>Vorschau</th></tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Workflow-Variable hinzufügen / bearbeiten / löschen</td>
+      <td>Panel → Variablen → **Variable hinzufügen**, zum Bearbeiten klicken oder Löschsymbol verwenden</td>
+      <td><ActionImage src="/static/quick-reference/variables.png" alt="Variablen-Panel" /></td>
+    </tr>
+    <tr>
+      <td>Umgebungsvariable hinzufügen</td>
+      <td>Einstellungen → **Umgebungsvariablen** → **Hinzufügen**</td>
+      <td><ActionImage src="/static/quick-reference/add-env-variable.png" alt="Umgebungsvariable hinzufügen" /></td>
+    </tr>
+    <tr>
+      <td>Auf Workflow-Variable verweisen</td>
+      <td>Verwenden Sie die Syntax `<blockName.itemName>` in Block-Eingaben</td>
+      <td><ActionImage src="/static/quick-reference/variable-reference.png" alt="Auf Workflow-Variable verweisen" /></td>
+    </tr>
+    <tr>
+      <td>Auf Umgebungsvariable verweisen</td>
+      <td>Verwenden Sie die Syntax `{{ENV_VAR}}` in Block-Eingaben</td>
+      <td><ActionImage src="/static/quick-reference/env-variable-reference.png" alt="Auf Umgebungsvariable verweisen" /></td>
+    </tr>
+  </tbody>
+</table>

apps/docs/content/docs/de/sdks/python.mdx

@@ -7,10 +7,10 @@ import { Card, Cards } from 'fumadocs-ui/components/card'
 import { Step, Steps } from 'fumadocs-ui/components/steps'
 import { Tab, Tabs } from 'fumadocs-ui/components/tabs'
 
-Das offizielle Python SDK für Sim ermöglicht es Ihnen, Workflows programmatisch aus Ihren Python-Anwendungen mithilfe des offiziellen Python SDKs auszuführen.
+Das offizielle Python SDK für Sim ermöglicht es Ihnen, Workflows programmatisch aus Ihren Python-Anwendungen heraus mit dem offiziellen Python SDK auszuführen.
 
 <Callout type="info">
-  Das Python SDK unterstützt Python 3.8+ mit asynchroner Ausführungsunterstützung, automatischer Ratenbegrenzung mit exponentiellem Backoff und Nutzungsverfolgung.
+  Das Python SDK unterstützt Python 3.8+ mit Unterstützung für asynchrone Ausführung, automatischer Ratenbegrenzung mit exponentiellem Backoff und Nutzungsverfolgung.
 </Callout>
 
 ## Installation
@@ -75,16 +75,16 @@ result = client.execute_workflow(
 - `input_data` (dict, optional): Eingabedaten, die an den Workflow übergeben werden
 - `timeout` (float, optional): Timeout in Sekunden (Standard: 30.0)
 - `stream` (bool, optional): Streaming-Antworten aktivieren (Standard: False)
-- `selected_outputs` (list[str], optional): Block-Ausgaben, die im `blockName.attribute`Format gestreamt werden sollen (z.B. `["agent1.content"]`)
+- `selected_outputs` (list[str], optional): Block-Ausgaben zum Streamen im Format `blockName.attribute` (z. B. `["agent1.content"]`)
 - `async_execution` (bool, optional): Asynchron ausführen (Standard: False)
 
-**Rückgabe:** `WorkflowExecutionResult | AsyncExecutionResult`
+**Rückgabewert:** `WorkflowExecutionResult | AsyncExecutionResult`
 
-Wenn `async_execution=True`, wird sofort mit einer Task-ID zum Abfragen zurückgegeben. Andernfalls wird auf den Abschluss gewartet.
+Wenn `async_execution=True`, wird sofort mit einer Task-ID zum Polling zurückgegeben. Andernfalls wird auf die Fertigstellung gewartet.
 
 ##### get_workflow_status()
 
-Den Status eines Workflows abrufen (Bereitstellungsstatus usw.).
+Ruft den Status eines Workflows ab (Deployment-Status usw.).
 
 ```python
 status = client.get_workflow_status("workflow-id")
@@ -98,7 +98,7 @@ print("Is deployed:", status.is_deployed)
 
 ##### validate_workflow()
 
-Überprüfen, ob ein Workflow für die Ausführung bereit ist.
+Überprüft, ob ein Workflow zur Ausführung bereit ist.
 
 ```python
 is_ready = client.validate_workflow("workflow-id")
@@ -114,7 +114,7 @@ if is_ready:
 
 ##### get_job_status()
 
-Den Status einer asynchronen Job-Ausführung abrufen.
+Ruft den Status einer asynchronen Job-Ausführung ab.
 
 ```python
 status = client.get_job_status("task-id-from-async-execution")
@@ -131,7 +131,7 @@ if status["status"] == "completed":
 **Antwortfelder:**
 - `success` (bool): Ob die Anfrage erfolgreich war
 - `taskId` (str): Die Task-ID
-- `status` (str): Einer der Werte `'queued'`, `'processing'`, `'completed'`, `'failed'`, `'cancelled'`
+- `status` (str): Einer von `'queued'`, `'processing'`, `'completed'`, `'failed'`, `'cancelled'`
 - `metadata` (dict): Enthält `startedAt`, `completedAt` und `duration`
 - `output` (any, optional): Die Workflow-Ausgabe (wenn abgeschlossen)
 - `error` (any, optional): Fehlerdetails (wenn fehlgeschlagen)
@@ -139,7 +139,7 @@ if status["status"] == "completed":
 
 ##### execute_with_retry()
 
-Einen Workflow mit automatischer Wiederholung bei Ratenbegrenzungsfehlern unter Verwendung von exponentiellem Backoff ausführen.
+Führt einen Workflow mit automatischer Wiederholung bei Rate-Limit-Fehlern unter Verwendung von exponentiellem Backoff aus.
 
 ```python
 result = client.execute_with_retry(
@@ -161,13 +161,13 @@ result = client.execute_with_retry(
 - `selected_outputs` (list, optional): Block-Ausgaben zum Streamen
 - `async_execution` (bool, optional): Asynchron ausführen
 - `max_retries` (int, optional): Maximale Anzahl von Wiederholungen (Standard: 3)
-- `initial_delay` (float, optional): Anfängliche Verzögerung in Sekunden (Standard: 1.0)
+- `initial_delay` (float, optional): Anfangsverzögerung in Sekunden (Standard: 1.0)
 - `max_delay` (float, optional): Maximale Verzögerung in Sekunden (Standard: 30.0)
 - `backoff_multiplier` (float, optional): Backoff-Multiplikator (Standard: 2.0)
 
-**Rückgabewert:** `WorkflowExecutionResult | AsyncExecutionResult`
+**Rückgabe:** `WorkflowExecutionResult | AsyncExecutionResult`
 
-Die Wiederholungslogik verwendet exponentielles Backoff (1s → 2s → 4s → 8s...) mit ±25% Jitter, um den Thundering-Herd-Effekt zu vermeiden. Wenn die API einen `retry-after` Header bereitstellt, wird dieser stattdessen verwendet.
+Die Wiederholungslogik verwendet exponentielles Backoff (1s → 2s → 4s → 8s...) mit ±25% Jitter, um Thundering Herd zu verhindern. Wenn die API einen `retry-after`-Header bereitstellt, wird dieser stattdessen verwendet.
 
 ##### get_rate_limit_info()
 
@@ -185,7 +185,7 @@ if rate_limit_info:
 
 ##### get_usage_limits()
 
-Ruft aktuelle Nutzungslimits und Kontingentinformationen für dein Konto ab.
+Ruft aktuelle Nutzungslimits und Kontingentinformationen für Ihr Konto ab.
 
 ```python
 limits = client.get_usage_limits()
@@ -320,9 +320,9 @@ class SimStudioError(Exception):
 
 **Häufige Fehlercodes:**
 - `UNAUTHORIZED`: Ungültiger API-Schlüssel
-- `TIMEOUT`: Zeitüberschreitung bei der Anfrage
-- `RATE_LIMIT_EXCEEDED`: Ratengrenze überschritten
-- `USAGE_LIMIT_EXCEEDED`: Nutzungsgrenze überschritten
+- `TIMEOUT`: Zeitüberschreitung der Anfrage
+- `RATE_LIMIT_EXCEEDED`: Ratenlimit überschritten
+- `USAGE_LIMIT_EXCEEDED`: Nutzungslimit überschritten
 - `EXECUTION_ERROR`: Workflow-Ausführung fehlgeschlagen
 
 ## Beispiele
@@ -334,7 +334,7 @@ class SimStudioError(Exception):
     Richten Sie den SimStudioClient mit Ihrem API-Schlüssel ein.
   </Step>
   <Step title="Workflow validieren">
-    Prüfen Sie, ob der Workflow bereitgestellt und für die Ausführung bereit ist.
+    Prüfen Sie, ob der Workflow bereitgestellt und zur Ausführung bereit ist.
   </Step>
   <Step title="Workflow ausführen">
     Führen Sie den Workflow mit Ihren Eingabedaten aus.
@@ -386,7 +386,7 @@ Behandeln Sie verschiedene Fehlertypen, die während der Workflow-Ausführung au
 from simstudio import SimStudioClient, SimStudioError
 import os
 
-client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))   
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
 
 def execute_with_error_handling():
     try:
@@ -409,11 +409,20 @@ def execute_with_error_handling():
         raise
 ```
 
-### Verwendung des Kontextmanagers
+### Verwendung des Context-Managers
 
-Verwenden Sie den Client als Kontextmanager, um die Ressourcenbereinigung automatisch zu handhaben:
+Verwenden Sie den Client als Context-Manager, um die Ressourcenbereinigung automatisch zu handhaben:
 
----CODE-PLACEHOLDER-ef99d3dd509e04865d5b6b0e0e03d3f8---
+```python
+from simstudio import SimStudioClient
+import os
+
+# Using context manager to automatically close the session
+with SimStudioClient(api_key=os.getenv("SIM_API_KEY")) as client:
+    result = client.execute_workflow("workflow-id")
+    print("Result:", result)
+# Session is automatically closed here
+```
 
 ### Batch-Workflow-Ausführung
 
@@ -466,7 +475,7 @@ for result in results:
 
 ### Asynchrone Workflow-Ausführung
 
-Führen Sie Workflows asynchron für lang laufende Aufgaben aus:
+Führen Sie Workflows asynchron für langwierige Aufgaben aus:
 
 ```python
 import os
@@ -510,9 +519,9 @@ def execute_async():
 execute_async()
 ```
 
-### Rate-Limiting und Wiederholungsversuche
+### Ratenlimitierung und Wiederholung
 
-Behandle Rate-Limits automatisch mit exponentiellem Backoff:
+Behandeln Sie Ratenbegrenzungen automatisch mit exponentiellem Backoff:
 
 ```python
 import os
@@ -549,7 +558,7 @@ execute_with_retry_handling()
 
 ### Nutzungsüberwachung
 
-Überwache deine Kontonutzung und -limits:
+Überwachen Sie die Nutzung und Limits Ihres Kontos:
 
 ```python
 import os
@@ -593,13 +602,13 @@ check_usage()
 
 ### Streaming-Workflow-Ausführung
 
-Führe Workflows mit Echtzeit-Streaming-Antworten aus:
+Führen Sie Workflows mit Echtzeit-Streaming-Antworten aus:
 
 ```python
 from simstudio import SimStudioClient
 import os
 
-client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))   
+client = SimStudioClient(api_key=os.getenv("SIM_API_KEY"))
 
 def execute_with_streaming():
     """Execute workflow with streaming enabled."""
@@ -619,7 +628,7 @@ def execute_with_streaming():
 execute_with_streaming()
 ```
 
-Die Streaming-Antwort folgt dem Server-Sent Events (SSE) Format:
+Die Streaming-Antwort folgt dem Server-Sent-Events- (SSE-) Format:
 
 ```
 data: {"blockId":"7b7735b9-19e5-4bd6-818b-46aae2596e9f","chunk":"One"}
@@ -688,9 +697,9 @@ if __name__ == '__main__':
     app.run(debug=True)
 ```
 
-### Umgebungskonfiguration
+### Umgebungs­konfiguration
 
-Konfiguriere den Client mit Umgebungsvariablen:
+Konfigurieren Sie den Client mit Umgebungsvariablen:
 
 <Tabs items={['Development', 'Production']}>
   <Tab value="Development">
@@ -727,27 +736,27 @@ Konfiguriere den Client mit Umgebungsvariablen:
   </Tab>
 </Tabs>
 
-## API-Schlüssel erhalten
+## Ihren API-Schlüssel erhalten
 
 <Steps>
   <Step title="Bei Sim anmelden">
-    Navigiere zu [Sim](https://sim.ai) und melde dich bei deinem Konto an.
+    Navigieren Sie zu [Sim](https://sim.ai) und melden Sie sich in Ihrem Konto an.
   </Step>
-  <Step title="Öffne deinen Workflow">
-    Navigiere zu dem Workflow, den du programmatisch ausführen möchtest.
+  <Step title="Workflow öffnen">
+    Navigieren Sie zu dem Workflow, den Sie programmatisch ausführen möchten.
   </Step>
-  <Step title="Deploye deinen Workflow">
-    Klicke auf "Deploy", um deinen Workflow zu deployen, falls dies noch nicht geschehen ist.
+  <Step title="Workflow bereitstellen">
+    Klicken Sie auf "Bereitstellen", um Ihren Workflow bereitzustellen, falls dies noch nicht geschehen ist.
   </Step>
-  <Step title="Erstelle oder wähle einen API-Schlüssel">
-    Wähle während des Deployment-Prozesses einen API-Schlüssel aus oder erstelle einen neuen.
+  <Step title="API-Schlüssel erstellen oder auswählen">
+    Wählen oder erstellen Sie während des Bereitstellungsprozesses einen API-Schlüssel.
   </Step>
-  <Step title="Kopiere den API-Schlüssel">
-    Kopiere den API-Schlüssel zur Verwendung in deiner Python-Anwendung.
+  <Step title="API-Schlüssel kopieren">
+    Kopieren Sie den API-Schlüssel, um ihn in Ihrer Python-Anwendung zu verwenden.
   </Step>
 </Steps>
 
-## Anforderungen
+## Voraussetzungen
 
 - Python 3.8+
 - requests >= 2.25.0

apps/docs/content/docs/de/self-hosting/index.mdx

@@ -56,3 +56,10 @@ docker compose -f docker-compose.prod.yml up -d
 | realtime | 3002 | WebSocket-Server |
 | db | 5432 | PostgreSQL mit pgvector |
 | migrations | - | Datenbank-Migrationen (werden einmal ausgeführt) |
+
+| Komponente | Port | Beschreibung |
+|-----------|------|-------------|
+| simstudio | 3000 | Hauptanwendung |
+| realtime | 3002 | WebSocket-Server |
+| db | 5432 | PostgreSQL mit pgvector |
+| migrations | - | Datenbankmigrationen (wird einmal ausgeführt) |

apps/docs/content/docs/de/skills/index.mdx

@@ -0,0 +1,134 @@
+---
+title: Agent-Fähigkeiten
+---
+
+import { Callout } from 'fumadocs-ui/components/callout'
+
+Agent-Fähigkeiten sind wiederverwendbare Anweisungspakete, die Ihren KI-Agenten spezialisierte Funktionen verleihen. Basierend auf dem offenen [Agent Skills](https://agentskills.io)-Format ermöglichen Fähigkeiten Ihnen, Fachwissen, Arbeitsabläufe und Best Practices zu erfassen, die Agenten bei Bedarf laden können.
+
+## Wie Fähigkeiten funktionieren
+
+Fähigkeiten nutzen **progressive Offenlegung**, um den Kontext des Agenten schlank zu halten:
+
+1. **Entdeckung** — Nur Fähigkeitsnamen und Beschreibungen werden in den System-Prompt des Agenten aufgenommen (~50-100 Token jeweils)
+2. **Aktivierung** — Wenn der Agent entscheidet, dass eine Fähigkeit relevant ist, ruft er das `load_skill`-Tool auf, um die vollständigen Anweisungen in den Kontext zu laden
+3. **Ausführung** — Der Agent folgt den geladenen Anweisungen, um die Aufgabe zu erledigen
+
+Das bedeutet, Sie können viele Fähigkeiten an einen Agenten anhängen, ohne dessen Kontextfenster aufzublähen. Der Agent lädt nur das, was er benötigt.
+
+## Fähigkeiten erstellen
+
+Gehen Sie zu **Einstellungen** und wählen Sie **Fähigkeiten** im Bereich Tools aus.
+
+![Manage Skills](/static/skills/manage-skills.png)
+
+Klicken Sie auf **Hinzufügen**, um eine neue Fähigkeit mit drei Feldern zu erstellen:
+
+| Feld | Beschreibung |
+|-------|-------------|
+| **Name** | Eine Kennung im Kebab-Case-Format (z. B. `sql-expert`, `code-reviewer`). Maximal 64 Zeichen. |
+| **Beschreibung** | Eine kurze Erklärung, was die Fähigkeit tut und wann sie verwendet werden soll. Dies liest der Agent, um zu entscheiden, ob er die Fähigkeit aktiviert. Maximal 1024 Zeichen. |
+| **Inhalt** | Die vollständigen Fähigkeitsanweisungen in Markdown. Diese werden geladen, wenn der Agent die Fähigkeit aktiviert. |
+
+<Callout type="info">
+  Die Beschreibung ist entscheidend — sie ist das Einzige, was der Agent sieht, bevor er entscheidet, eine Fähigkeit zu laden. Seien Sie spezifisch darüber, wann und warum die Fähigkeit verwendet werden sollte.
+</Callout>
+
+### Gute Skill-Inhalte schreiben
+
+Skill-Inhalte folgen denselben Konventionen wie [SKILL.md-Dateien](https://agentskills.io/specification):
+
+```markdown
+# SQL Expert
+
+## When to use this skill
+Use when the user asks you to write, optimize, or debug SQL queries.
+
+## Instructions
+1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
+2. Use CTEs over subqueries for readability
+3. Add index recommendations when relevant
+4. Explain query plans for optimization requests
+
+## Common Patterns
+...
+```
+
+**Empfohlene Struktur:**
+- **Wann verwenden** — Spezifische Auslöser und Szenarien
+- **Anweisungen** — Schritt-für-Schritt-Anleitung mit nummerierten Listen
+- **Beispiele** — Eingabe-/Ausgabe-Beispiele, die das erwartete Verhalten zeigen
+- **Häufige Muster** — Wiederverwendbare Ansätze für häufige Aufgaben
+- **Sonderfälle** — Fallstricke und besondere Überlegungen
+
+Halten Sie Skills fokussiert und unter 500 Zeilen. Wenn ein Skill zu groß wird, teilen Sie ihn in mehrere spezialisierte Skills auf.
+
+## Skills zu einem Agenten hinzufügen
+
+Öffnen Sie einen beliebigen **Agent**-Block und finden Sie das **Skills**-Dropdown unterhalb des Tool-Bereichs. Wählen Sie die Skills aus, auf die der Agent Zugriff haben soll.
+
+![Skill hinzufügen](/static/skills/add-skill.png)
+
+Ausgewählte Skills erscheinen als Karten, die Sie anklicken können, um sie zu bearbeiten oder zu entfernen.
+
+### Was zur Laufzeit passiert
+
+Wenn der Workflow ausgeführt wird:
+
+1. Der System-Prompt des Agenten enthält einen `<available_skills>`-Abschnitt, der Name und Beschreibung jedes Skills auflistet
+2. Ein `load_skill`-Tool wird automatisch zu den verfügbaren Tools des Agenten hinzugefügt
+3. Wenn der Agent feststellt, dass ein Skill für die aktuelle Aufgabe relevant ist, ruft er `load_skill` mit dem Skill-Namen auf
+4. Der vollständige Skill-Inhalt wird als Tool-Antwort zurückgegeben und gibt dem Agenten detaillierte Anweisungen
+
+Dies funktioniert über alle unterstützten LLM-Anbieter hinweg — das `load_skill`-Tool verwendet standardmäßiges Tool-Calling, sodass keine anbieterspezifische Konfiguration erforderlich ist.
+
+## Häufige Anwendungsfälle
+
+Skills sind besonders wertvoll, wenn Agenten spezialisiertes Wissen oder mehrstufige Workflows benötigen:
+
+**Domain-Expertise**
+- `api-integration-expert` — Best Practices für den Aufruf spezifischer APIs (Authentifizierung, Rate Limiting, Fehlerbehandlung)
+- `data-transformation` — ETL-Muster, Datenbereinigung und Validierungsregeln
+- `code-reviewer` — Code-Review-Richtlinien spezifisch für die Standards Ihres Teams
+
+**Workflow-Vorlagen**
+- `bug-investigation` — Schritt-für-Schritt-Debugging-Methodik (reproduzieren → isolieren → testen → beheben)
+- `feature-implementation` — Entwicklungs-Workflow von Anforderungen bis zur Bereitstellung
+- `document-generator` — Vorlagen und Formatierungsregeln für technische Dokumentation
+
+**Unternehmensspezifisches Wissen**
+- `our-architecture` — Systemarchitekturdiagramme, Service-Abhängigkeiten und Bereitstellungsprozesse
+- `style-guide` — Markenrichtlinien, Schreibstil, UI/UX-Muster
+- `customer-onboarding` — Standardverfahren und häufige Kundenfragen
+
+**Wann Skills vs. Agentenanweisungen verwendet werden sollten:**
+- Verwenden Sie **Skills** für Wissen, das über mehrere Workflows hinweg gilt oder sich häufig ändert
+- Verwenden Sie **Agentenanweisungen** für aufgabenspezifischen Kontext, der für einen einzelnen Agenten einzigartig ist
+
+## Best Practices
+
+**Effektive Beschreibungen schreiben**
+- **Seien Sie spezifisch und keyword-reich** — Statt "Hilft bei SQL", schreiben Sie "Optimierte SQL-Abfragen für PostgreSQL, MySQL und SQLite schreiben, einschließlich Index-Empfehlungen und Abfrageplan-Analyse"
+- **Aktivierungstrigger einbeziehen** — Erwähnen Sie spezifische Wörter oder Phrasen, die den Skill auslösen sollten (z. B. "Verwenden, wenn der Benutzer PDFs, Formulare oder Dokumentenextraktion erwähnt")
+- **Unter 200 Wörtern halten** — Agenten scannen Beschreibungen schnell; jedes Wort zählt
+
+**Skill-Umfang und Organisation**
+- **Ein Skill pro Domäne** — Ein fokussierter `sql-expert`-Skill funktioniert besser als ein breiter `database-everything`-Skill
+- **Auf 5-10 Skills pro Agent begrenzen** — Mehr Skills = mehr Entscheidungsaufwand; klein anfangen und bei Bedarf erweitern
+- **Große Skills aufteilen** — Wenn ein Skill 500 Zeilen überschreitet, in fokussierte Sub-Skills aufteilen
+
+**Inhaltsstruktur**
+- **Markdown-Formatierung verwenden** — Überschriften, Listen und Code-Blöcke helfen Agenten beim Parsen und Befolgen von Anweisungen
+- **Beispiele bereitstellen** — Input/Output-Paare zeigen, damit Agenten das erwartete Verhalten verstehen
+- **Explizit über Sonderfälle sein** — Gehen Sie nicht davon aus, dass Agenten spezielle Behandlung ableiten werden
+
+**Testen und Iteration**
+- **Aktivierung testen** — Führen Sie Ihren Workflow aus und überprüfen Sie, ob der Agent die Skill lädt, wenn erwartet
+- **Auf Fehlalarme prüfen** — Stellen Sie sicher, dass Skills nicht aktiviert werden, wenn sie es nicht sollten
+- **Beschreibungen verfeinern** — Wenn eine Skill nicht geladen wird, wenn sie benötigt wird, fügen Sie der Beschreibung weitere Schlüsselwörter hinzu
+
+## Mehr erfahren
+
+- [Agent Skills Spezifikation](https://agentskills.io) — Das offene Format für portable Agent-Skills
+- [Beispiel-Skills](https://github.com/anthropics/skills) — Community-Skill-Beispiele durchsuchen
+- [Best Practices](https://agentskills.io/what-are-skills) — Effektive Skills schreiben

apps/docs/content/docs/de/tools/a2a.mdx

@@ -0,0 +1,207 @@
+---
+title: A2A
+description: Interagiere mit externen A2A-kompatiblen Agenten
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="a2a"
+  color="#4151B5"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+Das A2A-Protokoll (Agent-to-Agent) ermöglicht es Sim, mit externen KI-Agenten und Systemen zu interagieren, die A2A-kompatible APIs implementieren. Mit A2A kannst du Sims Automatisierungen und Workflows mit Remote-Agenten verbinden – wie LLM-gestützten Bots, Microservices und anderen KI-basierten Tools – unter Verwendung eines standardisierten Nachrichtenformats.
+
+Mit den A2A-Tools in Sim kannst du:
+
+- **Nachrichten an externe Agenten senden**: Kommuniziere direkt mit Remote-Agenten und übermittle Prompts, Befehle oder Daten.
+- **Antworten empfangen und streamen**: Erhalte strukturierte Antworten, Artefakte oder Echtzeit-Updates vom Agenten, während die Aufgabe fortschreitet.
+- **Gespräche oder Aufgaben fortsetzen**: Führe mehrstufige Konversationen oder Workflows fort, indem du auf Aufgaben- und Kontext-IDs verweist.
+- **Drittanbieter-KI und Automatisierung integrieren**: Nutze externe A2A-kompatible Dienste als Teil deiner Sim-Workflows.
+
+Diese Funktionen ermöglichen es dir, fortgeschrittene Workflows zu erstellen, die Sims native Fähigkeiten mit der Intelligenz und Automatisierung externer KIs oder benutzerdefinierter Agenten kombinieren. Um A2A-Integrationen zu nutzen, benötigst du die Endpunkt-URL des externen Agenten und, falls erforderlich, einen API-Schlüssel oder Zugangsdaten.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanleitung
+
+Verwende das A2A-Protokoll (Agent-to-Agent), um mit externen KI-Agenten zu interagieren. 
+
+## Tools
+
+### `a2a_send_message`
+
+Sende eine Nachricht an einen externen A2A-kompatiblen Agenten.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agenten-Endpunkt-URL |
+| `message` | string | Ja | Nachricht, die an den Agenten gesendet werden soll |
+| `taskId` | string | Nein | Aufgaben-ID zum Fortsetzen einer bestehenden Aufgabe |
+| `contextId` | string | Nein | Kontext-ID für Gesprächskontinuität |
+| `data` | string | Nein | Strukturierte Daten, die mit der Nachricht einbezogen werden sollen \(JSON-String\) |
+| `files` | array | Nein | Dateien, die mit der Nachricht einbezogen werden sollen |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `content` | string | Textantwort-Inhalt vom Agenten |
+| `taskId` | string | Eindeutige Aufgabenkennung |
+| `contextId` | string | Gruppiert zusammenhängende Aufgaben/Nachrichten |
+| `state` | string | Aktueller Lebenszyklus-Status \(working, completed, failed, canceled, rejected, input_required, auth_required\) |
+| `artifacts` | array | Ausgabe-Artefakte der Aufgabe |
+| `history` | array | Gesprächsverlauf \(Message-Array\) |
+
+### `a2a_get_task`
+
+Abfrage des Status einer bestehenden A2A-Aufgabe.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agenten-Endpunkt-URL |
+| `taskId` | string | Ja | Abzufragende Aufgaben-ID |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung |
+| `historyLength` | number | Nein | Anzahl der einzubeziehenden Verlaufsnachrichten |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `taskId` | string | Eindeutige Aufgabenkennung |
+| `contextId` | string | Gruppiert zusammenhängende Aufgaben/Nachrichten |
+| `state` | string | Aktueller Lebenszyklus-Status \(working, completed, failed, canceled, rejected, input_required, auth_required\) |
+| `artifacts` | array | Ausgabe-Artefakte der Aufgabe |
+| `history` | array | Gesprächsverlauf \(Message-Array\) |
+
+### `a2a_cancel_task`
+
+Abbrechen einer laufenden A2A-Aufgabe.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agenten-Endpunkt-URL |
+| `taskId` | string | Ja | Abzubrechende Aufgaben-ID |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `cancelled` | boolean | Ob die Stornierung erfolgreich war |
+| `state` | string | Aktueller Lebenszyklus-Status \(working, completed, failed, canceled, rejected, input_required, auth_required\) |
+
+### `a2a_get_agent_card`
+
+Ruft die Agent Card (Discovery-Dokument) für einen A2A-Agenten ab.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die Endpunkt-URL des A2A-Agenten |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung \(falls erforderlich\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `name` | string | Anzeigename des Agenten |
+| `description` | string | Zweck/Fähigkeiten des Agenten |
+| `url` | string | Service-Endpunkt-URL |
+| `provider` | object | Details zur Ersteller-Organisation |
+| `capabilities` | object | Feature-Support-Matrix |
+| `skills` | array | Verfügbare Operationen |
+| `version` | string | Vom Agenten unterstützte A2A-Protokollversion |
+| `defaultInputModes` | array | Standard-Eingabe-Inhaltstypen, die vom Agenten akzeptiert werden |
+| `defaultOutputModes` | array | Standard-Ausgabe-Inhaltstypen, die vom Agenten produziert werden |
+
+### `a2a_resubscribe`
+
+Stellt die Verbindung zu einem laufenden A2A-Task-Stream nach einer Verbindungsunterbrechung wieder her.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die Endpunkt-URL des A2A-Agenten |
+| `taskId` | string | Ja | Task-ID, zu der erneut abonniert werden soll |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `taskId` | string | Eindeutige Aufgabenkennung |
+| `contextId` | string | Gruppiert zusammenhängende Aufgaben/Nachrichten |
+| `state` | string | Aktueller Lebenszyklusstatus \(working, completed, failed, canceled, rejected, input_required, auth_required\) |
+| `isRunning` | boolean | Ob die Aufgabe noch läuft |
+| `artifacts` | array | Ausgabeartefakte der Aufgabe |
+| `history` | array | Gesprächsverlauf \(Message-Array\) |
+
+### `a2a_set_push_notification`
+
+Konfigurieren Sie einen Webhook, um Benachrichtigungen über Aufgabenaktualisierungen zu erhalten.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agent-Endpunkt-URL |
+| `taskId` | string | Ja | Aufgaben-ID, für die Benachrichtigungen konfiguriert werden sollen |
+| `webhookUrl` | string | Ja | HTTPS-Webhook-URL zum Empfang von Benachrichtigungen |
+| `token` | string | Nein | Token zur Webhook-Validierung |
+| `apiKey` | string | Nein | API-Schlüssel zur Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `url` | string | HTTPS-Webhook-URL für Benachrichtigungen |
+| `token` | string | Authentifizierungstoken zur Webhook-Validierung |
+| `success` | boolean | Ob der Vorgang erfolgreich war |
+
+### `a2a_get_push_notification`
+
+Rufen Sie die Push-Benachrichtigungs-Webhook-Konfiguration für eine Aufgabe ab.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agent-Endpunkt-URL |
+| `taskId` | string | Ja | Aufgaben-ID, für die die Benachrichtigungskonfiguration abgerufen werden soll |
+| `apiKey` | string | Nein | API-Schlüssel zur Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `token` | string | Authentifizierungstoken für Webhook-Validierung |
+| `exists` | boolean | Ob die Ressource existiert |
+
+### `a2a_delete_push_notification`
+
+Löscht die Push-Benachrichtigungs-Webhook-Konfiguration für eine Aufgabe.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `agentUrl` | string | Ja | Die A2A-Agent-Endpunkt-URL |
+| `taskId` | string | Ja | Aufgaben-ID, für die die Benachrichtigungskonfiguration gelöscht werden soll |
+| `pushNotificationConfigId` | string | Nein | Push-Benachrichtigungskonfigurations-ID zum Löschen \(optional - Server kann aus taskId ableiten\) |
+| `apiKey` | string | Nein | API-Schlüssel für Authentifizierung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `success` | boolean | Ob die Operation erfolgreich war |

apps/docs/content/docs/de/tools/ahrefs.mdx

@@ -193,8 +193,3 @@ Erhalte eine Liste defekter Backlinks, die auf eine Zieldomäne oder URL verweis
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `brokenBacklinks` | array | Liste defekter Backlinks |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `ahrefs`

apps/docs/content/docs/de/tools/airtable.mdx

@@ -123,8 +123,3 @@ Mehrere vorhandene Datensätze in einer Airtable-Tabelle aktualisieren
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `records` | json | Array der aktualisierten Airtable-Datensätze |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `airtable`

apps/docs/content/docs/de/tools/airweave.mdx

@@ -0,0 +1,63 @@
+---
+title: Airweave
+description: Durchsuchen Sie Ihre synchronisierten Datensammlungen
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="airweave"
+  color="#6366F1"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Airweave](https://airweave.ai/) ist eine KI-gestützte semantische Suchplattform, die Ihnen hilft, Wissen über alle Ihre synchronisierten Datenquellen hinweg zu entdecken und abzurufen. Airweave wurde für moderne Teams entwickelt und ermöglicht schnelle, relevante Suchergebnisse mithilfe neuraler, hybrider oder schlüsselwortbasierter Strategien, die auf Ihre Bedürfnisse zugeschnitten sind.
+
+Mit Airweave können Sie:
+
+- **Intelligenter suchen**: Verwenden Sie natürlichsprachliche Abfragen, um Informationen aufzudecken, die in Ihren verbundenen Tools und Datenbanken gespeichert sind
+- **Ihre Daten vereinheitlichen**: Greifen Sie nahtlos auf Inhalte aus Quellen wie Code, Dokumenten, Chat, E-Mails, Cloud-Dateien und mehr zu
+- **Abruf anpassen**: Wählen Sie zwischen hybriden (semantisch + Schlüsselwort), neuralen oder Schlüsselwort-Suchstrategien für optimale Ergebnisse
+- **Recall steigern**: Erweitern Sie Suchanfragen mit KI, um umfassendere Antworten zu finden
+- **Ergebnisse mit KI neu ordnen**: Priorisieren Sie die relevantesten Antworten mit leistungsstarken Sprachmodellen
+- **Sofortige Antworten erhalten**: Generieren Sie klare, KI-gestützte Antworten, die aus Ihren Daten synthetisiert werden
+
+In Sim ermöglicht die Airweave-Integration Ihren Agenten, alle Daten Ihrer Organisation über ein einziges Tool zu durchsuchen, zusammenzufassen und Erkenntnisse zu extrahieren. Nutzen Sie Airweave, um umfassenden, kontextbezogenen Wissensabruf in Ihren Workflows zu ermöglichen – sei es beim Beantworten von Fragen, Erstellen von Zusammenfassungen oder Unterstützen dynamischer Entscheidungsfindung.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanweisungen
+
+Durchsuchen Sie Ihre synchronisierten Datenquellen mit Airweave. Unterstützt semantische Suche mit hybriden, neuralen oder schlüsselwortbasierten Abrufstrategien. Optional können KI-gestützte Antworten aus Suchergebnissen generiert werden.
+
+## Tools
+
+### `airweave_search`
+
+Durchsuchen Sie Ihre synchronisierten Datensammlungen mit Airweave. Unterstützt semantische Suche mit hybriden, neuralen oder schlüsselwortbasierten Abrufstrategien. Optional können KI-gestützte Antworten aus Suchergebnissen generiert werden.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Airweave API-Schlüssel für die Authentifizierung |
+| `collectionId` | string | Ja | Die lesbare ID der zu durchsuchenden Sammlung |
+| `query` | string | Ja | Der Suchanfragetext |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(Standard: 100\) |
+| `retrievalStrategy` | string | Nein | Abrufstrategie: hybrid \(Standard\), neural oder keyword |
+| `expandQuery` | boolean | Nein | Abfragevariationen generieren, um die Trefferquote zu verbessern |
+| `rerank` | boolean | Nein | Ergebnisse für verbesserte Relevanz mithilfe von LLM neu ordnen |
+| `generateAnswer` | boolean | Nein | Eine natürlichsprachliche Antwort auf die Abfrage generieren |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `results` | array | Suchergebnisse mit Inhalten, Scores und Metadaten aus Ihren synchronisierten Daten |
+|   ↳ `entity_id` | string | Eindeutige Kennung für die Suchergebnisentität |
+|   ↳ `source_name` | string | Name der Datenquelle \(z. B. "GitHub", "Slack"\) |
+|   ↳ `md_content` | string | Markdown-formatierter Inhalt des Ergebnisses |
+|   ↳ `score` | number | Relevanz-Score aus der Suche |
+|   ↳ `metadata` | object | Zusätzliche Metadaten, die mit dem Ergebnis verknüpft sind |
+|   ↳ `breadcrumbs` | array | Navigationspfad zum Ergebnis innerhalb seiner Quelle |
+|   ↳ `url` | string | URL zum Originalinhalt |
+| `completion` | string | KI-generierte Antwort auf die Abfrage \(wenn generateAnswer aktiviert ist\) |

apps/docs/content/docs/de/tools/apify.mdx

@@ -81,8 +81,3 @@ Führe einen APIFY-Aktor asynchron mit Polling für lang laufende Aufgaben aus
 | `status` | string | Laufstatus \(SUCCEEDED, FAILED, usw.\) |
 | `datasetId` | string | Dataset-ID mit Ergebnissen |
 | `items` | array | Dataset-Elemente \(falls abgeschlossen\) |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `apify`

apps/docs/content/docs/de/tools/apollo.mdx

@@ -567,8 +567,3 @@ Liste des Teams abrufen
 | --------- | ---- | ----------- |
 | `email_accounts` | json | Array von Team-E-Mail-Konten, die in Apollo verknüpft sind |
 | `metadata` | json | Metadaten einschließlich der Gesamtanzahl von E-Mail-Konten |
-
-## Notizen
-
-- Kategorie: `tools`
-- Typ: `apollo`

apps/docs/content/docs/de/tools/arxiv.mdx

@@ -82,8 +82,3 @@ Suche nach Artikeln eines bestimmten Autors auf ArXiv.
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `authorPapers` | json | Array von Publikationen, die vom angegebenen Autor verfasst wurden |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `arxiv`

apps/docs/content/docs/de/tools/asana.mdx

@@ -163,3 +163,16 @@ Einen Kommentar (Story) zu einer Asana-Aufgabe hinzufügen
 
 - Kategorie: `tools`
 - Typ: `asana`
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `success` | boolean | Erfolgsstatus der Operation |
+| `ts` | string | Zeitstempel der Antwort |
+| `gid` | string | Global eindeutige Kennung des Kommentars |
+| `text` | string | Textinhalt des Kommentars |
+| `created_at` | string | Erstellungszeitstempel des Kommentars |
+| `created_by` | object | Details zum Kommentarautor |
+|   ↳ `gid` | string | Autor-GID |
+|   ↳ `name` | string | Name des Autors |

apps/docs/content/docs/de/tools/browser_use.mdx

@@ -53,8 +53,3 @@ Führt eine Browser-Automatisierungsaufgabe mit BrowserUse aus
 | `success` | boolean | Status der Aufgabenfertigstellung |
 | `output` | json | Ausgabedaten der Aufgabe |
 | `steps` | json | Ausgeführte Schritte |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `browser_use`

apps/docs/content/docs/de/tools/calcom.mdx

@@ -0,0 +1,785 @@
+---
+title: Cal Com
+description: Verwalten Sie Cal.com-Buchungen, Veranstaltungstypen, Zeitpläne und
+  Verfügbarkeiten
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="calcom"
+  color="#FFFFFE"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Cal.com](https://cal.com/) ist eine flexible und quelloffene Planungsplattform, die es einfach macht, Termine, Buchungen, Veranstaltungstypen und Teamverfügbarkeiten zu verwalten.
+
+Mit Cal.com können Sie:
+
+- **Planung automatisieren**: Ermöglichen Sie Nutzern, Ihre verfügbaren Zeitfenster einzusehen und Meetings automatisch zu buchen, ohne E-Mail-Pingpong.
+- **Veranstaltungen verwalten**: Erstellen und passen Sie Veranstaltungstypen, Dauern und Regeln für Einzel- oder Gruppenmeetings an.
+- **Kalender integrieren**: Verbinden Sie sich nahtlos mit Google, Outlook, Apple oder anderen Kalenderanbietern, um Doppelbuchungen zu vermeiden.
+- **Teilnehmer und Gäste verwalten**: Erfassen Sie Teilnehmerinformationen, verwalten Sie Gäste und versenden Sie Einladungen oder Erinnerungen.
+- **Verfügbarkeit steuern**: Definieren Sie individuelle Arbeitszeiten, Pufferzeiten und Storno-/Umbuchungsregeln.
+- **Workflows automatisieren**: Lösen Sie benutzerdefinierte Aktionen über Webhooks aus, wenn eine Buchung erstellt, storniert oder umgebucht wird.
+
+In Sim ermöglicht die Cal.com-Integration Ihren Agenten, Meetings zu buchen, Verfügbarkeiten zu prüfen, Veranstaltungstypen zu verwalten und Planungsaufgaben programmatisch zu automatisieren. Dies hilft Agenten, Meetings zu koordinieren, Buchungen im Namen von Nutzern zu versenden, Zeitpläne zu prüfen oder auf Buchungsereignisse zu reagieren – alles ohne manuelle Eingriffe. Durch die Verbindung von Sim mit Cal.com erschließen Sie hochautomatisierte und intelligente Planungs-Workflows, die sich nahtlos in Ihre umfassenderen Automatisierungsanforderungen integrieren lassen.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanleitung
+
+Integrieren Sie Cal.com in Ihren Workflow. Erstellen und verwalten Sie Buchungen, Veranstaltungstypen, Zeitpläne und prüfen Sie Verfügbarkeitsfenster. Unterstützt das Erstellen, Auflisten, Umbuchen und Stornieren von Buchungen sowie die Verwaltung von Veranstaltungstypen und Zeitplänen. Kann auch Workflows basierend auf Cal.com-Webhook-Ereignissen auslösen (Buchung erstellt, storniert, umgebucht). Verbinden Sie Ihr Cal.com-Konto über OAuth.
+
+## Tools
+
+### `calcom_create_booking`
+
+Eine neue Buchung auf Cal.com erstellen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `eventTypeId` | number | Ja | Die ID des zu buchenden Ereignistyps |
+| `start` | string | Ja | Startzeit im UTC ISO 8601-Format \(z. B. 2024-01-15T09:00:00Z\) |
+| `attendee` | object | Ja | Teilnehmerinformationsobjekt mit Name, E-Mail, Zeitzone und optionaler Telefonnummer \(zusammengestellt aus einzelnen Teilnehmerfeldern\) |
+| `guests` | array | Nein | Array von Gast-E-Mail-Adressen |
+| `items` | string | Nein | Gast-E-Mail-Adresse |
+| `lengthInMinutes` | number | Nein | Dauer der Buchung in Minuten \(überschreibt die Standardeinstellung des Ereignistyps\) |
+| `metadata` | object | Nein | Benutzerdefinierte Metadaten, die an die Buchung angehängt werden |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details der erstellten Buchung |
+|   ↳ `eventType` | object | Details des Ereignistyps |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(z. B. akzeptiert, ausstehend, storniert\) |
+|   ↳ `start` | string | Startzeit im ISO 8601-Format |
+|   ↳ `end` | string | Endzeit im ISO 8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `meetingUrl` | string | URL zum Beitritt zum Meeting |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `absentHost` | boolean | Ob der Gastgeber abwesend war |
+|   ↳ `guests` | array | Gast-E-Mail-Adressen |
+|   ↳ `bookingFieldsResponses` | json | Benutzerdefinierte Buchungsfeldantworten \(dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration\) |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die an die Buchung angehängt sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `icsUid` | string | ICS-Kalender-UID |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+
+### `calcom_get_booking`
+
+Details einer bestimmten Buchung anhand ihrer UID abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `bookingUid` | string | Ja | Eindeutige Kennung \(UID\) der Buchung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Buchungsdetails |
+|   ↳ `eventType` | object | Details zum Ereignistyp |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `description` | string | Beschreibung der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(z. B. akzeptiert, ausstehend, storniert\) |
+|   ↳ `start` | string | Startzeit im ISO-8601-Format |
+|   ↳ `end` | string | Endzeit im ISO-8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `meetingUrl` | string | URL zum Beitritt zum Meeting |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `absentHost` | boolean | Ob der Gastgeber abwesend war |
+|   ↳ `guests` | array | E-Mail-Adressen der Gäste |
+|   ↳ `bookingFieldsResponses` | json | Benutzerdefinierte Buchungsfeld-Antworten \(dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration\) |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `rating` | number | Buchungsbewertung |
+|   ↳ `icsUid` | string | ICS-Kalender-UID |
+|   ↳ `cancellationReason` | string | Grund für die Stornierung, falls storniert |
+|   ↳ `reschedulingReason` | string | Grund für die Umbuchung, falls umgebucht |
+|   ↳ `rescheduledFromUid` | string | Ursprüngliche Buchungs-UID, falls diese Buchung umgebucht wurde |
+|   ↳ `rescheduledToUid` | string | Neue Buchungs-UID nach Umbuchung |
+|   ↳ `cancelledByEmail` | string | E-Mail der Person, die die Buchung storniert hat |
+|   ↳ `rescheduledByEmail` | string | E-Mail der Person, die die Buchung umgebucht hat |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `updatedAt` | string | Zeitpunkt der letzten Aktualisierung der Buchung |
+
+### `calcom_list_bookings`
+
+Alle Buchungen mit optionalem Statusfilter auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `status` | string | Nein | Buchungen nach Status filtern: upcoming, recurring, past, cancelled oder unconfirmed |
+| `take` | number | Nein | Anzahl der zurückzugebenden Buchungen \(Paginierungslimit\) |
+| `skip` | number | Nein | Anzahl der zu überspringenden Buchungen \(Paginierungsoffset\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | array | Array von Buchungen |
+|   ↳ `eventType` | object | Details zum Ereignistyp |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `description` | string | Beschreibung der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(z. B. accepted, pending, cancelled\) |
+|   ↳ `start` | string | Startzeit im ISO-8601-Format |
+|   ↳ `end` | string | Endzeit im ISO-8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `meetingUrl` | string | URL zum Beitritt zum Meeting |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `absentHost` | boolean | Ob der Gastgeber abwesend war |
+|   ↳ `guests` | array | E-Mail-Adressen der Gäste |
+|   ↳ `bookingFieldsResponses` | json | Antworten auf benutzerdefinierte Buchungsfelder \(dynamische Schlüssel basierend auf der Ereignistyp-Konfiguration\) |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die der Buchung zugeordnet sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `rating` | number | Buchungsbewertung |
+|   ↳ `icsUid` | string | ICS-Kalender-UID |
+|   ↳ `cancellationReason` | string | Grund für die Stornierung, falls storniert |
+|   ↳ `cancelledByEmail` | string | E-Mail der Person, die die Buchung storniert hat |
+|   ↳ `reschedulingReason` | string | Grund für die Umbuchung, falls umgebucht |
+|   ↳ `rescheduledByEmail` | string | E-Mail der Person, die die Buchung umgebucht hat |
+|   ↳ `rescheduledFromUid` | string | Ursprüngliche Buchungs-UID, falls diese Buchung umgebucht wurde |
+|   ↳ `rescheduledToUid` | string | Neue Buchungs-UID nach Umbuchung |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `updatedAt` | string | Zeitpunkt der letzten Aktualisierung der Buchung |
+| `pagination` | object | Paginierungs-Metadaten |
+|   ↳ `totalItems` | number | Gesamtanzahl der Elemente |
+|   ↳ `remainingItems` | number | Verbleibende Elemente nach der aktuellen Seite |
+|   ↳ `returnedItems` | number | Anzahl der in dieser Antwort zurückgegebenen Elemente |
+|   ↳ `itemsPerPage` | number | Elemente pro Seite |
+|   ↳ `currentPage` | number | Aktuelle Seitennummer |
+|   ↳ `totalPages` | number | Gesamtanzahl der Seiten |
+|   ↳ `hasNextPage` | boolean | Ob es eine nächste Seite gibt |
+|   ↳ `hasPreviousPage` | boolean | Ob es eine vorherige Seite gibt |
+
+### `calcom_cancel_booking`
+
+Eine bestehende Buchung stornieren
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `bookingUid` | string | Ja | Eindeutige Kennung \(UID\) der zu stornierenden Buchung |
+| `cancellationReason` | string | Nein | Grund für die Stornierung der Buchung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details der stornierten Buchung |
+|   ↳ `eventType` | object | Details des Ereignistyps |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `cancellationReason` | string | Grund für die Stornierung, falls storniert |
+|   ↳ `cancelledByEmail` | string | E-Mail der Person, die die Buchung storniert hat |
+|   ↳ `start` | string | Startzeit im ISO-8601-Format |
+|   ↳ `end` | string | Endzeit im ISO-8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die der Buchung zugeordnet sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(sollte storniert sein\) |
+
+### `calcom_reschedule_booking`
+
+Eine bestehende Buchung auf einen neuen Zeitpunkt verschieben
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `bookingUid` | string | Ja | Eindeutige Kennung \(UID\) der zu verschiebenden Buchung |
+| `start` | string | Ja | Neue Startzeit im UTC ISO 8601-Format \(z. B. 2024-01-15T09:00:00Z\) |
+| `reschedulingReason` | string | Nein | Grund für die Verschiebung der Buchung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details der verschobenen Buchung |
+|   ↳ `eventType` | object | Details des Ereignistyps |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(z. B. akzeptiert, ausstehend, storniert\) |
+|   ↳ `reschedulingReason` | string | Grund für die Verschiebung, falls verschoben |
+|   ↳ `rescheduledFromUid` | string | Ursprüngliche Buchungs-UID, falls diese Buchung verschoben wurde |
+|   ↳ `rescheduledByEmail` | string | E-Mail der Person, die die Buchung verschoben hat |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `meetingUrl` | string | URL zum Beitreten des Meetings |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `guests` | array | E-Mail-Adressen der Gäste |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die an die Buchung angehängt sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `icsUid` | string | ICS-Kalender-UID |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `uid` | string | Eindeutige Kennung für die neue Buchung |
+|   ↳ `start` | string | Neue Startzeit im ISO 8601-Format |
+|   ↳ `end` | string | Neue Endzeit im ISO 8601-Format |
+
+### `calcom_confirm_booking`
+
+Eine ausstehende Buchung bestätigen, die eine Bestätigung erfordert
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `bookingUid` | string | Ja | Eindeutige Kennung \(UID\) der zu bestätigenden Buchung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details der bestätigten Buchung |
+|   ↳ `eventType` | object | Details des Ereignistyps |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers \(IANA-Format\) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers \(ISO-Code\) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail \(kann von der tatsächlichen E-Mail abweichen\) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers \(IANA-Format\) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `start` | string | Startzeit im ISO-8601-Format |
+|   ↳ `end` | string | Endzeit im ISO-8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `meetingUrl` | string | URL zum Beitreten des Meetings |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `guests` | array | E-Mail-Adressen der Gäste |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind \(dynamische Schlüssel-Wert-Paare\) |
+|   ↳ `icsUid` | string | ICS-Kalender-UID |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `status` | string | Buchungsstatus \(sollte akzeptiert/bestätigt sein\) |
+
+### `calcom_decline_booking`
+
+Eine ausstehende Buchungsanfrage ablehnen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `bookingUid` | string | Ja | Eindeutige Kennung (UID) der abzulehnenden Buchung |
+| `reason` | string | Nein | Grund für die Ablehnung der Buchung |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details der abgelehnten Buchung |
+|   ↳ `eventType` | object | Details des Ereignistyps |
+|     ↳ `id` | number | Ereignistyp-ID |
+|     ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `attendees` | array | Liste der Teilnehmer |
+|     ↳ `name` | string | Name des Teilnehmers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Teilnehmers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
+|     ↳ `timeZone` | string | Zeitzone des Teilnehmers (IANA-Format) |
+|     ↳ `phoneNumber` | string | Telefonnummer des Teilnehmers |
+|     ↳ `language` | string | Sprachpräferenz des Teilnehmers (ISO-Code) |
+|     ↳ `absent` | boolean | Ob der Teilnehmer abwesend war |
+|   ↳ `hosts` | array | Liste der Gastgeber |
+|     ↳ `id` | number | Benutzer-ID des Gastgebers |
+|     ↳ `name` | string | Anzeigename des Gastgebers |
+|     ↳ `email` | string | Tatsächliche E-Mail-Adresse des Gastgebers |
+|     ↳ `displayEmail` | string | Öffentlich angezeigte E-Mail (kann von der tatsächlichen E-Mail abweichen) |
+|     ↳ `username` | string | Cal.com-Benutzername des Gastgebers |
+|     ↳ `timeZone` | string | Zeitzone des Gastgebers (IANA-Format) |
+|   ↳ `id` | number | Numerische Buchungs-ID |
+|   ↳ `uid` | string | Eindeutige Kennung für die Buchung |
+|   ↳ `title` | string | Titel der Buchung |
+|   ↳ `cancellationReason` | string | Grund für die Stornierung, falls storniert |
+|   ↳ `start` | string | Startzeit im ISO-8601-Format |
+|   ↳ `end` | string | Endzeit im ISO-8601-Format |
+|   ↳ `duration` | number | Dauer in Minuten |
+|   ↳ `eventTypeId` | number | Ereignistyp-ID |
+|   ↳ `location` | string | Ort der Buchung |
+|   ↳ `metadata` | json | Benutzerdefinierte Metadaten, die der Buchung angehängt sind (dynamische Schlüssel-Wert-Paare) |
+|   ↳ `createdAt` | string | Zeitpunkt der Erstellung der Buchung |
+|   ↳ `status` | string | Buchungsstatus (sollte storniert/abgelehnt sein) |
+
+### `calcom_create_event_type`
+
+Einen neuen Ereignistyp in Cal.com erstellen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `title` | string | Ja | Titel des Ereignistyps |
+| `slug` | string | Ja | Eindeutiger Slug für die Ereignistyp-URL |
+| `lengthInMinutes` | number | Ja | Dauer des Ereignisses in Minuten |
+| `description` | string | Nein | Beschreibung des Ereignistyps |
+| `slotInterval` | number | Nein | Intervall zwischen verfügbaren Buchungsslots in Minuten |
+| `minimumBookingNotice` | number | Nein | Erforderliche Mindestvorlaufzeit vor der Buchung in Minuten |
+| `beforeEventBuffer` | number | Nein | Pufferzeit vor dem Ereignis in Minuten |
+| `afterEventBuffer` | number | Nein | Pufferzeit nach dem Ereignis in Minuten |
+| `scheduleId` | number | Nein | ID des Zeitplans für die Verfügbarkeit |
+| `disableGuests` | boolean | Nein | Ob das Hinzufügen von Gästen zu Buchungen deaktiviert ist |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details des erstellten Ereignistyps |
+|   ↳ `id` | number | Ereignistyp-ID |
+|   ↳ `title` | string | Ereignistyp-Titel |
+|   ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `description` | string | Ereignistyp-Beschreibung |
+|   ↳ `lengthInMinutes` | number | Dauer in Minuten |
+|   ↳ `slotInterval` | number | Slot-Intervall in Minuten |
+|   ↳ `minimumBookingNotice` | number | Mindestvorlaufzeit für Buchung in Minuten |
+|   ↳ `beforeEventBuffer` | number | Puffer vor Ereignis in Minuten |
+|   ↳ `afterEventBuffer` | number | Puffer nach Ereignis in Minuten |
+|   ↳ `scheduleId` | number | Zeitplan-ID |
+|   ↳ `disableGuests` | boolean | Ob Gäste deaktiviert sind |
+|   ↳ `createdAt` | string | ISO-Zeitstempel der Erstellung |
+|   ↳ `updatedAt` | string | ISO-Zeitstempel der letzten Aktualisierung |
+
+### `calcom_get_event_type`
+
+Detaillierte Informationen über einen bestimmten Ereignistyp abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `eventTypeId` | number | Ja | Ereignistyp-ID zum Abrufen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details zum Ereignistyp |
+|   ↳ `id` | number | Ereignistyp-ID |
+|   ↳ `title` | string | Titel des Ereignistyps |
+|   ↳ `slug` | string | Slug des Ereignistyps |
+|   ↳ `description` | string | Beschreibung des Ereignistyps |
+|   ↳ `lengthInMinutes` | number | Dauer in Minuten |
+|   ↳ `slotInterval` | number | Zeitfensterintervall in Minuten |
+|   ↳ `minimumBookingNotice` | number | Mindestvorlaufzeit für Buchungen in Minuten |
+|   ↳ `beforeEventBuffer` | number | Puffer vor dem Ereignis in Minuten |
+|   ↳ `afterEventBuffer` | number | Puffer nach dem Ereignis in Minuten |
+|   ↳ `scheduleId` | number | Zeitplan-ID |
+|   ↳ `disableGuests` | boolean | Ob Gäste deaktiviert sind |
+|   ↳ `createdAt` | string | ISO-Zeitstempel der Erstellung |
+|   ↳ `updatedAt` | string | ISO-Zeitstempel der letzten Aktualisierung |
+
+### `calcom_list_event_types`
+
+Eine Liste aller Ereignistypen abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `sortCreatedAt` | string | Nein | Sortierung nach Erstellungsdatum: "asc" oder "desc" |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | array | Array von Ereignistypen |
+|   ↳ `id` | number | Ereignistyp-ID |
+|   ↳ `title` | string | Ereignistyp-Titel |
+|   ↳ `slug` | string | Ereignistyp-Slug |
+|   ↳ `description` | string | Ereignistyp-Beschreibung |
+|   ↳ `lengthInMinutes` | number | Dauer in Minuten |
+|   ↳ `slotInterval` | number | Zeitfensterintervall in Minuten |
+|   ↳ `minimumBookingNotice` | number | Mindestvorlaufzeit für Buchungen in Minuten |
+|   ↳ `beforeEventBuffer` | number | Pufferzeit vor dem Ereignis in Minuten |
+|   ↳ `afterEventBuffer` | number | Pufferzeit nach dem Ereignis in Minuten |
+|   ↳ `scheduleId` | number | Zeitplan-ID |
+|   ↳ `disableGuests` | boolean | Ob Gäste deaktiviert sind |
+|   ↳ `createdAt` | string | ISO-Zeitstempel der Erstellung |
+|   ↳ `updatedAt` | string | ISO-Zeitstempel der letzten Aktualisierung |
+
+### `calcom_update_event_type`
+
+Einen bestehenden Ereignistyp in Cal.com aktualisieren
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `eventTypeId` | number | Ja | Zu aktualisierende Ereignistyp-ID \(z. B. 12345\) |
+| `title` | string | Nein | Titel des Ereignistyps |
+| `slug` | string | Nein | Eindeutiger Slug für die Ereignistyp-URL |
+| `lengthInMinutes` | number | Nein | Dauer des Ereignisses in Minuten |
+| `description` | string | Nein | Beschreibung des Ereignistyps |
+| `slotInterval` | number | Nein | Intervall zwischen verfügbaren Buchungszeitfenstern in Minuten |
+| `minimumBookingNotice` | number | Nein | Erforderliche Mindestvorlaufzeit vor der Buchung in Minuten |
+| `beforeEventBuffer` | number | Nein | Pufferzeit vor dem Ereignis in Minuten |
+| `afterEventBuffer` | number | Nein | Pufferzeit nach dem Ereignis in Minuten |
+| `scheduleId` | number | Nein | ID des Zeitplans für die Verfügbarkeit |
+| `disableGuests` | boolean | Nein | Ob das Hinzufügen von Gästen zu Buchungen deaktiviert werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Aktualisierte Details des Ereignistyps |
+|   ↳ `id` | number | Ereignistyp-ID |
+|   ↳ `title` | string | Titel des Ereignistyps |
+|   ↳ `slug` | string | Slug des Ereignistyps |
+|   ↳ `description` | string | Beschreibung des Ereignistyps |
+|   ↳ `lengthInMinutes` | number | Dauer in Minuten |
+|   ↳ `slotInterval` | number | Zeitfensterintervall in Minuten |
+|   ↳ `minimumBookingNotice` | number | Mindestvorlaufzeit für Buchungen in Minuten |
+|   ↳ `beforeEventBuffer` | number | Puffer vor dem Ereignis in Minuten |
+|   ↳ `afterEventBuffer` | number | Puffer nach dem Ereignis in Minuten |
+|   ↳ `scheduleId` | number | Zeitplan-ID |
+|   ↳ `disableGuests` | boolean | Ob Gäste deaktiviert sind |
+|   ↳ `createdAt` | string | ISO-Zeitstempel der Erstellung |
+|   ↳ `updatedAt` | string | ISO-Zeitstempel der letzten Aktualisierung |
+
+### `calcom_delete_event_type`
+
+Einen Ereignistyp aus Cal.com löschen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `eventTypeId` | number | Ja | Zu löschende Ereignistyp-ID |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Details des gelöschten Ereignistyps |
+|   ↳ `id` | number | Ereignistyp-ID |
+|   ↳ `lengthInMinutes` | number | Dauer in Minuten |
+|   ↳ `title` | string | Titel des Ereignistyps |
+|   ↳ `slug` | string | Slug des Ereignistyps |
+
+### `calcom_create_schedule`
+
+Einen neuen Verfügbarkeitsplan in Cal.com erstellen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `name` | string | Ja | Name des Plans |
+| `timeZone` | string | Ja | Zeitzone für den Plan \(z. B. America/New_York\) |
+| `isDefault` | boolean | Ja | Ob dieser Plan als Standard festgelegt werden soll |
+| `availability` | array | Nein | Verfügbarkeitsintervalle für den Plan |
+| `items` | object | Nein | Verfügbarkeitsintervall |
+| `properties` | array | Nein | Wochentage \(Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag\) |
+| `days` | array | Nein | Wochentage \(Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag\) |
+| `startTime` | string | Nein | Startzeit im Format HH:MM |
+| `endTime` | string | Nein | Endzeit im Format HH:MM |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Erstellte Plandaten |
+|   ↳ `id` | number | Plan-ID |
+|   ↳ `ownerId` | number | Benutzer-ID des Eigentümers |
+|   ↳ `name` | string | Planname |
+|   ↳ `timeZone` | string | Zeitzone \(z. B. America/New_York\) |
+|   ↳ `isDefault` | boolean | Ob dies der Standardplan ist |
+|   ↳ `availability` | array | Verfügbarkeitsfenster |
+|     ↳ `days` | array | Wochentage \(Montag, Dienstag usw.\) |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+|   ↳ `overrides` | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
+|     ↳ `date` | string | Datum im Format JJJJ-MM-TT |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+
+### `calcom_get_schedule`
+
+Einen bestimmten Zeitplan anhand der ID von Cal.com abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `scheduleId` | string | Ja | ID des abzurufenden Zeitplans |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Zeitplandaten |
+|   ↳ `id` | number | Zeitplan-ID |
+|   ↳ `ownerId` | number | Benutzer-ID des Eigentümers |
+|   ↳ `name` | string | Zeitplanname |
+|   ↳ `timeZone` | string | Zeitzone \(z. B. America/New_York\) |
+|   ↳ `isDefault` | boolean | Ob dies der Standardzeitplan ist |
+|   ↳ `availability` | array | Verfügbarkeitsfenster |
+|     ↳ `days` | array | Wochentage \(Montag, Dienstag usw.\) |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+|   ↳ `overrides` | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
+|     ↳ `date` | string | Datum im Format JJJJ-MM-TT |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+
+### `calcom_list_schedules`
+
+Alle Verfügbarkeitszeitpläne von Cal.com auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | array | Array von Zeitplanobjekten |
+|   ↳ `id` | number | Zeitplan-ID |
+|   ↳ `ownerId` | number | Benutzer-ID des Eigentümers |
+|   ↳ `name` | string | Zeitplanname |
+|   ↳ `timeZone` | string | Zeitzone \(z. B. America/New_York\) |
+|   ↳ `isDefault` | boolean | Ob dies der Standardzeitplan ist |
+|   ↳ `availability` | array | Verfügbarkeitsfenster |
+|     ↳ `days` | array | Wochentage \(Montag, Dienstag usw.\) |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+|   ↳ `overrides` | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
+|     ↳ `date` | string | Datum im Format JJJJ-MM-TT |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+
+### `calcom_update_schedule`
+
+Einen bestehenden Zeitplan in Cal.com aktualisieren
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `scheduleId` | string | Ja | ID des zu aktualisierenden Zeitplans |
+| `name` | string | Nein | Neuer Name für den Zeitplan |
+| `timeZone` | string | Nein | Neue Zeitzone für den Zeitplan \(z. B. America/New_York\) |
+| `isDefault` | boolean | Nein | Ob dieser Zeitplan als Standard festgelegt werden soll |
+| `availability` | array | Nein | Neue Verfügbarkeitsintervalle für den Zeitplan |
+| `items` | object | Nein | Verfügbarkeitsintervall |
+| `properties` | array | Nein | Wochentage \(Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag\) |
+| `days` | array | Nein | Wochentage \(Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag\) |
+| `startTime` | string | Nein | Startzeit im Format HH:MM |
+| `endTime` | string | Nein | Endzeit im Format HH:MM |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Aktualisierte Zeitplandaten |
+|   ↳ `id` | number | Zeitplan-ID |
+|   ↳ `ownerId` | number | Benutzer-ID des Eigentümers |
+|   ↳ `name` | string | Zeitplanname |
+|   ↳ `timeZone` | string | Zeitzone \(z. B. America/New_York\) |
+|   ↳ `isDefault` | boolean | Ob dies der Standardzeitplan ist |
+|   ↳ `availability` | array | Verfügbarkeitsfenster |
+|     ↳ `days` | array | Wochentage \(Montag, Dienstag usw.\) |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+|   ↳ `overrides` | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
+|     ↳ `date` | string | Datum im Format JJJJ-MM-TT |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+
+### `calcom_delete_schedule`
+
+Einen Zeitplan aus Cal.com löschen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `scheduleId` | string | Ja | ID des zu löschenden Zeitplans |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus \(Erfolg oder Fehler\) |
+
+### `calcom_get_default_schedule`
+
+Den Standard-Verfügbarkeitszeitplan aus Cal.com abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | object | Standard-Zeitplandaten |
+|   ↳ `id` | number | Zeitplan-ID |
+|   ↳ `ownerId` | number | Benutzer-ID des Eigentümers |
+|   ↳ `name` | string | Zeitplanname |
+|   ↳ `timeZone` | string | Zeitzone \(z. B. America/New_York\) |
+|   ↳ `isDefault` | boolean | Ob dies der Standardzeitplan ist |
+|   ↳ `availability` | array | Verfügbarkeitsfenster |
+|     ↳ `days` | array | Wochentage \(Montag, Dienstag usw.\) |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+|   ↳ `overrides` | array | Datumsspezifische Verfügbarkeitsüberschreibungen |
+|     ↳ `date` | string | Datum im Format JJJJ-MM-TT |
+|     ↳ `startTime` | string | Startzeit im Format HH:MM |
+|     ↳ `endTime` | string | Endzeit im Format HH:MM |
+
+### `calcom_get_slots`
+
+Verfügbare Buchungsslots für einen Cal.com-Ereignistyp innerhalb eines Zeitraums abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `start` | string | Ja | Beginn des Zeitraums im UTC ISO 8601-Format \(z. B. 2024-01-15T00:00:00Z\) |
+| `end` | string | Ja | Ende des Zeitraums im UTC ISO 8601-Format \(z. B. 2024-01-22T00:00:00Z\) |
+| `eventTypeId` | number | Nein | Ereignistyp-ID für direkte Suche |
+| `eventTypeSlug` | string | Nein | Ereignistyp-Slug \(erfordert, dass der Benutzername gesetzt ist\) |
+| `username` | string | Nein | Benutzername für persönliche Ereignistypen \(erforderlich bei Verwendung von eventTypeSlug\) |
+| `timeZone` | string | Nein | Zeitzone für zurückgegebene Slots \(Standard ist UTC\) |
+| `duration` | number | Nein | Slot-Länge in Minuten |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `status` | string | Antwortstatus |
+| `data` | json | Verfügbare Zeitslots gruppiert nach Datum \(Schlüssel im Format JJJJ-MM-TT\). Jedes Datum ist einem Array von Slot-Objekten mit Startzeit, optionaler Endzeit und Informationen zu Sitzplatz-Events zugeordnet. |

apps/docs/content/docs/de/tools/calendly.mdx

@@ -165,8 +165,3 @@ Ein geplantes Ereignis stornieren
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `resource` | object | Stornierungsdetails |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `calendly`

apps/docs/content/docs/de/tools/circleback.mdx

@@ -52,8 +52,3 @@ Egal, ob Sie sofortige Zusammenfassungen verteilen, Aufgaben protokollieren oder
 ## Nutzungsanleitung
 
 Erhalten Sie Meeting-Notizen, Aufgaben, Transkripte und Aufzeichnungen, wenn Meetings verarbeitet werden. Circleback nutzt Webhooks, um Daten an Ihre Workflows zu übermitteln.
-
-## Hinweise
-
-- Kategorie: `triggers`
-- Typ: `circleback`

apps/docs/content/docs/de/tools/clay.mdx

@@ -53,13 +53,3 @@ Populate Clay with data from a JSON file. Enables direct communication and notif
 | `authToken` | string | Nein | Optionaler Auth-Token für die Clay-Webhook-Authentifizierung \(die meisten Webhooks benötigen dies nicht\) |
 
 #### Output
-
-| Parameter | Typ | Beschreibung |
-| --------- | ---- | ----------- |
-| `data` | json | Antwortdaten vom Clay-Webhook |
-| `metadata` | object | Webhook-Antwort-Metadaten |
-
-## Notes
-
-- Category: `tools`
-- Type: `clay`

apps/docs/content/docs/de/tools/clerk.mdx

@@ -0,0 +1,437 @@
+---
+title: Clerk
+description: Verwalten Sie Benutzer, Organisationen und Sitzungen in Clerk
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="clerk"
+  color="#131316"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Clerk](https://clerk.com/) ist eine umfassende Identitätsinfrastruktur-Plattform, die Ihnen hilft, Benutzer, Authentifizierung und Sitzungen für Ihre Anwendungen zu verwalten.
+
+In Sim ermöglicht die Clerk-Integration Ihren Agenten, die Benutzer- und Sitzungsverwaltung durch einfach zu bedienende API-basierte Tools zu automatisieren. Agenten können sicher Benutzer auflisten, Benutzerprofile aktualisieren, Organisationen verwalten, Sitzungen überwachen und den Zugriff direkt in Ihrem Workflow widerrufen.
+
+Mit Clerk können Sie:
+
+- **Benutzer authentifizieren und Sitzungen verwalten**: Steuern Sie nahtlos Anmeldung, Registrierung und den Sitzungslebenszyklus für Ihre Benutzer.
+- **Benutzer auflisten und aktualisieren**: Rufen Sie automatisch Benutzerlisten ab, aktualisieren Sie Benutzerattribute oder zeigen Sie Profildetails als Teil Ihrer Agentenaufgaben an.
+- **Organisationen und Mitgliedschaften verwalten**: Fügen Sie Organisationen hinzu oder aktualisieren Sie diese und verwalten Sie Benutzermitgliedschaften übersichtlich.
+- **Sitzungen überwachen und widerrufen**: Sehen Sie aktive oder vergangene Benutzersitzungen ein und widerrufen Sie bei Bedarf sofort den Zugriff aus Sicherheitsgründen.
+
+Die Integration ermöglicht eine Echtzeit- und nachvollziehbare Verwaltung Ihrer Benutzerbasis – alles innerhalb von Sim. Verbundene Agenten können das Onboarding automatisieren, Richtlinien durchsetzen, Verzeichnisse aktuell halten und auf Authentifizierungsereignisse oder organisatorische Änderungen reagieren, sodass Sie sichere und flexible Prozesse mit Clerk als Ihrer Identitäts-Engine betreiben können.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanweisungen
+
+Integrieren Sie Clerk-Authentifizierung und Benutzerverwaltung in Ihren Workflow. Erstellen, aktualisieren, löschen und listen Sie Benutzer auf. Verwalten Sie Organisationen und deren Mitgliedschaften. Überwachen und steuern Sie Benutzersitzungen.
+
+## Tools
+
+### `clerk_list_users`
+
+Listen Sie alle Benutzer in Ihrer Clerk-Anwendung mit optionaler Filterung und Paginierung auf
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(z. B. 10, 50, 100; Bereich: 1-500, Standard: 10\) |
+| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung \(z. B. 0, 10, 20\) |
+| `orderBy` | string | Nein | Sortierfeld mit optionalem +/- Präfix für die Richtung \(Standard: -created_at\) |
+| `emailAddress` | string | Nein | Filtern nach E-Mail-Adresse \(z. B. user@example.com oder user1@example.com,user2@example.com\) |
+| `phoneNumber` | string | Nein | Filtern nach Telefonnummer \(durch Komma getrennt für mehrere\) |
+| `externalId` | string | Nein | Filtern nach externer ID \(durch Komma getrennt für mehrere\) |
+| `username` | string | Nein | Filtern nach Benutzername \(durch Komma getrennt für mehrere\) |
+| `userId` | string | Nein | Filtern nach Benutzer-ID \(z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC oder durch Komma getrennt für mehrere\) |
+| `query` | string | Nein | Suchanfrage zur Übereinstimmung über E-Mail, Telefon, Benutzername und Namen \(z. B. john oder john@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `users` | array | Array von Clerk-Benutzerobjekten |
+|   ↳ `id` | string | Benutzer-ID |
+|   ↳ `username` | string | Benutzername |
+|   ↳ `firstName` | string | Vorname |
+|   ↳ `lastName` | string | Nachname |
+|   ↳ `imageUrl` | string | Profilbild-URL |
+|   ↳ `hasImage` | boolean | Ob Benutzer ein Profilbild hat |
+|   ↳ `primaryEmailAddressId` | string | Primäre E-Mail-Adressen-ID |
+|   ↳ `primaryPhoneNumberId` | string | Primäre Telefonnummer-ID |
+|   ↳ `emailAddresses` | array | E-Mail-Adressen des Benutzers |
+|     ↳ `id` | string | E-Mail-Adressen-ID |
+|     ↳ `emailAddress` | string | E-Mail-Adresse |
+|   ↳ `phoneNumbers` | array | Telefonnummern des Benutzers |
+|     ↳ `id` | string | Telefonnummer-ID |
+|     ↳ `phoneNumber` | string | Telefonnummer |
+|   ↳ `externalId` | string | Externe System-ID |
+|   ↳ `passwordEnabled` | boolean | Ob Passwort aktiviert ist |
+|   ↳ `twoFactorEnabled` | boolean | Ob 2FA aktiviert ist |
+|   ↳ `banned` | boolean | Ob Benutzer gesperrt ist |
+|   ↳ `locked` | boolean | Ob Benutzer blockiert ist |
+|   ↳ `lastSignInAt` | number | Zeitstempel der letzten Anmeldung |
+|   ↳ `lastActiveAt` | number | Zeitstempel der letzten Aktivität |
+|   ↳ `createdAt` | number | Erstellungszeitstempel |
+|   ↳ `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+|   ↳ `publicMetadata` | json | Öffentliche Metadaten |
+| `totalCount` | number | Gesamtanzahl der Benutzer, die der Abfrage entsprechen |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_get_user`
+
+Einen einzelnen Benutzer anhand seiner ID von Clerk abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `userId` | string | Ja | Die ID des abzurufenden Benutzers \(z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Benutzer-ID |
+| `username` | string | Benutzername |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `imageUrl` | string | Profilbild-URL |
+| `hasImage` | boolean | Ob der Benutzer ein Profilbild hat |
+| `primaryEmailAddressId` | string | Primäre E-Mail-Adressen-ID |
+| `primaryPhoneNumberId` | string | Primäre Telefonnummer-ID |
+| `primaryWeb3WalletId` | string | Primäre Web3-Wallet-ID |
+| `emailAddresses` | array | E-Mail-Adressen des Benutzers |
+|   ↳ `id` | string | E-Mail-Adressen-ID |
+|   ↳ `emailAddress` | string | E-Mail-Adresse |
+|   ↳ `verified` | boolean | Ob die E-Mail verifiziert ist |
+| `phoneNumbers` | array | Telefonnummern des Benutzers |
+|   ↳ `id` | string | Telefonnummer-ID |
+|   ↳ `phoneNumber` | string | Telefonnummer |
+|   ↳ `verified` | boolean | Ob die Telefonnummer verifiziert ist |
+| `externalId` | string | Externe System-ID |
+| `passwordEnabled` | boolean | Ob das Passwort aktiviert ist |
+| `twoFactorEnabled` | boolean | Ob 2FA aktiviert ist |
+| `totpEnabled` | boolean | Ob TOTP aktiviert ist |
+| `backupCodeEnabled` | boolean | Ob Backup-Codes aktiviert sind |
+| `banned` | boolean | Ob der Benutzer gesperrt ist |
+| `locked` | boolean | Ob der Benutzer blockiert ist |
+| `deleteSelfEnabled` | boolean | Ob der Benutzer sich selbst löschen kann |
+| `createOrganizationEnabled` | boolean | Ob der Benutzer Organisationen erstellen kann |
+| `lastSignInAt` | number | Zeitstempel der letzten Anmeldung |
+| `lastActiveAt` | number | Zeitstempel der letzten Aktivität |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `publicMetadata` | json | Öffentliche Metadaten \(vom Frontend lesbar\) |
+| `privateMetadata` | json | Private Metadaten \(nur Backend\) |
+| `unsafeMetadata` | json | Unsichere Metadaten \(vom Frontend änderbar\) |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_create_user`
+
+Erstellen Sie einen neuen Benutzer in Ihrer Clerk-Anwendung
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `emailAddress` | string | Nein | E-Mail-Adressen für den Benutzer \(durch Komma getrennt für mehrere\) |
+| `phoneNumber` | string | Nein | Telefonnummern für den Benutzer \(durch Komma getrennt für mehrere\) |
+| `username` | string | Nein | Benutzername für den Benutzer \(muss eindeutig sein\) |
+| `password` | string | Nein | Passwort für den Benutzer \(mindestens 8 Zeichen\) |
+| `firstName` | string | Nein | Vorname des Benutzers |
+| `lastName` | string | Nein | Nachname des Benutzers |
+| `externalId` | string | Nein | Externe System-ID \(muss eindeutig sein\) |
+| `publicMetadata` | json | Nein | Öffentliche Metadaten \(JSON-Objekt, lesbar vom Frontend\) |
+| `privateMetadata` | json | Nein | Private Metadaten \(JSON-Objekt, nur Backend\) |
+| `unsafeMetadata` | json | Nein | Unsichere Metadaten \(JSON-Objekt, änderbar vom Frontend\) |
+| `skipPasswordChecks` | boolean | Nein | Passwortvalidierungsprüfungen überspringen |
+| `skipPasswordRequirement` | boolean | Nein | Passwort optional machen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Erstellte Benutzer-ID |
+| `username` | string | Benutzername |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `imageUrl` | string | Profilbild-URL |
+| `primaryEmailAddressId` | string | Primäre E-Mail-Adressen-ID |
+| `primaryPhoneNumberId` | string | Primäre Telefonnummer-ID |
+| `emailAddresses` | array | E-Mail-Adressen des Benutzers |
+|   ↳ `id` | string | E-Mail-Adressen-ID |
+|   ↳ `emailAddress` | string | E-Mail-Adresse |
+|   ↳ `verified` | boolean | Ob die E-Mail verifiziert ist |
+| `phoneNumbers` | array | Telefonnummern des Benutzers |
+|   ↳ `id` | string | Telefonnummer-ID |
+|   ↳ `phoneNumber` | string | Telefonnummer |
+|   ↳ `verified` | boolean | Ob die Telefonnummer verifiziert ist |
+| `externalId` | string | Externe System-ID |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Letzter Aktualisierungszeitstempel |
+| `publicMetadata` | json | Öffentliche Metadaten |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_update_user`
+
+Aktualisieren Sie einen bestehenden Benutzer in Ihrer Clerk-Anwendung
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `userId` | string | Ja | Die ID des zu aktualisierenden Benutzers \(z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC\) |
+| `firstName` | string | Nein | Vorname des Benutzers |
+| `lastName` | string | Nein | Nachname des Benutzers |
+| `username` | string | Nein | Benutzername \(muss eindeutig sein\) |
+| `password` | string | Nein | Neues Passwort \(mindestens 8 Zeichen\) |
+| `externalId` | string | Nein | Externe System-ID |
+| `primaryEmailAddressId` | string | Nein | ID der verifizierten E-Mail, die als primär festgelegt werden soll |
+| `primaryPhoneNumberId` | string | Nein | ID der verifizierten Telefonnummer, die als primär festgelegt werden soll |
+| `publicMetadata` | json | Nein | Öffentliche Metadaten \(JSON-Objekt\) |
+| `privateMetadata` | json | Nein | Private Metadaten \(JSON-Objekt\) |
+| `unsafeMetadata` | json | Nein | Unsichere Metadaten \(JSON-Objekt\) |
+| `skipPasswordChecks` | boolean | Nein | Passwortvalidierungsprüfungen überspringen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Aktualisierte Benutzer-ID |
+| `username` | string | Benutzername |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `imageUrl` | string | Profilbild-URL |
+| `primaryEmailAddressId` | string | Primäre E-Mail-Adressen-ID |
+| `primaryPhoneNumberId` | string | Primäre Telefonnummer-ID |
+| `emailAddresses` | array | E-Mail-Adressen des Benutzers |
+|   ↳ `id` | string | E-Mail-Adressen-ID |
+|   ↳ `emailAddress` | string | E-Mail-Adresse |
+|   ↳ `verified` | boolean | Ob die E-Mail verifiziert ist |
+| `phoneNumbers` | array | Telefonnummern des Benutzers |
+|   ↳ `id` | string | Telefonnummer-ID |
+|   ↳ `phoneNumber` | string | Telefonnummer |
+|   ↳ `verified` | boolean | Ob die Telefonnummer verifiziert ist |
+| `externalId` | string | Externe System-ID |
+| `banned` | boolean | Ob der Benutzer gesperrt ist |
+| `locked` | boolean | Ob der Benutzer blockiert ist |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `publicMetadata` | json | Öffentliche Metadaten |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_delete_user`
+
+Einen Benutzer aus Ihrer Clerk-Anwendung löschen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `userId` | string | Ja | Die ID des zu löschenden Benutzers (z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | ID des gelöschten Benutzers |
+| `object` | string | Objekttyp (user) |
+| `deleted` | boolean | Ob der Benutzer gelöscht wurde |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_list_organizations`
+
+Alle Organisationen in Ihrer Clerk-Anwendung mit optionaler Filterung auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite (z. B. 10, 50, 100; Bereich: 1–500, Standard: 10) |
+| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung (z. B. 0, 10, 20) |
+| `includeMembersCount` | boolean | Nein | Mitgliederanzahl für jede Organisation einbeziehen |
+| `query` | string | Nein | Suche nach Organisations-ID, Name oder Slug (z. B. Acme Corp oder acme-corp) |
+| `orderBy` | string | Nein | Sortierfeld (name, created_at, members_count) mit +/- Präfix |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `organizations` | array | Array von Clerk-Organisationsobjekten |
+|   ↳ `id` | string | Organisations-ID |
+|   ↳ `name` | string | Organisationsname |
+|   ↳ `slug` | string | Organisations-Slug |
+|   ↳ `imageUrl` | string | URL des Organisationsbilds |
+|   ↳ `hasImage` | boolean | Ob die Organisation ein Bild hat |
+|   ↳ `membersCount` | number | Anzahl der Mitglieder |
+|   ↳ `pendingInvitationsCount` | number | Anzahl ausstehender Einladungen |
+|   ↳ `maxAllowedMemberships` | number | Maximal zulässige Mitgliedschaften |
+|   ↳ `adminDeleteEnabled` | boolean | Ob Admin-Löschung aktiviert ist |
+|   ↳ `createdBy` | string | Benutzer-ID des Erstellers |
+|   ↳ `createdAt` | number | Erstellungszeitstempel |
+|   ↳ `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+|   ↳ `publicMetadata` | json | Öffentliche Metadaten |
+| `totalCount` | number | Gesamtanzahl der Organisationen |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_get_organization`
+
+Abrufen einer einzelnen Organisation nach ID oder Slug von Clerk
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `organizationId` | string | Ja | Die ID oder der Slug der abzurufenden Organisation \(z. B. org_2NNEqL2nrIRdJ194ndJqAHwEfxC oder my-org-slug\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Organisations-ID |
+| `name` | string | Organisationsname |
+| `slug` | string | Organisations-Slug |
+| `imageUrl` | string | URL des Organisationsbilds |
+| `hasImage` | boolean | Ob die Organisation ein Bild hat |
+| `membersCount` | number | Anzahl der Mitglieder |
+| `pendingInvitationsCount` | number | Anzahl ausstehender Einladungen |
+| `maxAllowedMemberships` | number | Maximal zulässige Mitgliedschaften |
+| `adminDeleteEnabled` | boolean | Ob Admin-Löschung aktiviert ist |
+| `createdBy` | string | Benutzer-ID des Erstellers |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `publicMetadata` | json | Öffentliche Metadaten |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_create_organization`
+
+Erstellen Sie eine neue Organisation in Ihrer Clerk-Anwendung
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `name` | string | Ja | Name der Organisation |
+| `createdBy` | string | Ja | Benutzer-ID des Erstellers, der Administrator wird \(z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC\) |
+| `slug` | string | Nein | Slug-Identifikator für die Organisation |
+| `maxAllowedMemberships` | number | Nein | Maximale Mitgliederkapazität \(0 für unbegrenzt\) |
+| `publicMetadata` | json | Nein | Öffentliche Metadaten \(JSON-Objekt\) |
+| `privateMetadata` | json | Nein | Private Metadaten \(JSON-Objekt\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Erstellte Organisations-ID |
+| `name` | string | Organisationsname |
+| `slug` | string | Organisations-Slug |
+| `imageUrl` | string | URL des Organisationsbildes |
+| `hasImage` | boolean | Ob die Organisation ein Bild hat |
+| `membersCount` | number | Anzahl der Mitglieder |
+| `pendingInvitationsCount` | number | Anzahl ausstehender Einladungen |
+| `maxAllowedMemberships` | number | Maximal zulässige Mitgliedschaften |
+| `adminDeleteEnabled` | boolean | Ob das Löschen durch den Administrator aktiviert ist |
+| `createdBy` | string | Benutzer-ID des Erstellers |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `publicMetadata` | json | Öffentliche Metadaten |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_list_sessions`
+
+Sitzungen für einen Benutzer oder Client in Ihrer Clerk-Anwendung auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der Clerk Secret Key für die API-Authentifizierung |
+| `userId` | string | Nein | Benutzer-ID, für die Sitzungen aufgelistet werden sollen \(z. B. user_2NNEqL2nrIRdJ194ndJqAHwEfxC; erforderlich, wenn clientId nicht angegeben ist\) |
+| `clientId` | string | Nein | Client-ID, für die Sitzungen aufgelistet werden sollen \(erforderlich, wenn userId nicht angegeben ist\) |
+| `status` | string | Nein | Nach Sitzungsstatus filtern \(abandoned, active, ended, expired, pending, removed, replaced, revoked\) |
+| `limit` | number | Nein | Anzahl der Ergebnisse pro Seite \(z. B. 10, 50, 100; Bereich: 1-500, Standard: 10\) |
+| `offset` | number | Nein | Anzahl der zu überspringenden Ergebnisse für die Paginierung \(z. B. 0, 10, 20\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `sessions` | array | Array von Clerk-Sitzungsobjekten |
+|   ↳ `id` | string | Sitzungs-ID |
+|   ↳ `userId` | string | Benutzer-ID |
+|   ↳ `clientId` | string | Client-ID |
+|   ↳ `status` | string | Sitzungsstatus |
+|   ↳ `lastActiveAt` | number | Zeitstempel der letzten Aktivität |
+|   ↳ `lastActiveOrganizationId` | string | ID der zuletzt aktiven Organisation |
+|   ↳ `expireAt` | number | Ablaufzeitstempel |
+|   ↳ `abandonAt` | number | Abbruchzeitstempel |
+|   ↳ `createdAt` | number | Erstellungszeitstempel |
+|   ↳ `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `totalCount` | number | Gesamtanzahl der Sitzungen |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_get_session`
+
+Eine einzelne Sitzung anhand der ID von Clerk abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der geheime Clerk-Schlüssel für die API-Authentifizierung |
+| `sessionId` | string | Ja | Die ID der abzurufenden Sitzung \(z. B. sess_2NNEqL2nrIRdJ194ndJqAHwEfxC\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Sitzungs-ID |
+| `userId` | string | Benutzer-ID |
+| `clientId` | string | Client-ID |
+| `status` | string | Sitzungsstatus |
+| `lastActiveAt` | number | Zeitstempel der letzten Aktivität |
+| `lastActiveOrganizationId` | string | ID der zuletzt aktiven Organisation |
+| `expireAt` | number | Ablaufzeitstempel |
+| `abandonAt` | number | Zeitstempel für Abbruch |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `success` | boolean | Erfolgsstatus der Operation |
+
+### `clerk_revoke_session`
+
+Eine Sitzung widerrufen, um sie sofort ungültig zu machen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `secretKey` | string | Ja | Der geheime Clerk-Schlüssel für die API-Authentifizierung |
+| `sessionId` | string | Ja | Die ID der zu widerrufenden Sitzung \(z. B. sess_2NNEqL2nrIRdJ194ndJqAHwEfxC\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Sitzungs-ID |
+| `userId` | string | Benutzer-ID |
+| `clientId` | string | Client-ID |
+| `status` | string | Sitzungsstatus \(sollte widerrufen sein\) |
+| `lastActiveAt` | number | Zeitstempel der letzten Aktivität |
+| `lastActiveOrganizationId` | string | ID der zuletzt aktiven Organisation |
+| `expireAt` | number | Ablaufzeitstempel |
+| `abandonAt` | number | Zeitstempel für Abbruch |
+| `createdAt` | number | Erstellungszeitstempel |
+| `updatedAt` | number | Zeitstempel der letzten Aktualisierung |
+| `success` | boolean | Erfolgsstatus der Operation |

apps/docs/content/docs/de/tools/confluence.mdx

@@ -354,3 +354,512 @@ Listet alle Confluence-Spaces auf, auf die der Benutzer zugreifen kann.
 
 - Kategorie: `tools`
 - Typ: `confluence`
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z. B. ihrfirma.atlassian.net) |
+| `blogPostId` | string | Ja | Die ID des abzurufenden Blogbeitrags |
+| `bodyFormat` | string | Nein | Format für den Blogbeitrag-Body: storage, atlas_doc_format oder view |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `id` | string | Blogbeitrag-ID |
+| `title` | string | Blogbeitrag-Titel |
+| `status` | string | Blogbeitrag-Status |
+| `spaceId` | string | Space-ID |
+| `authorId` | string | Konto-ID des Autors |
+| `createdAt` | string | Erstellungszeitstempel |
+| `version` | object | Versionsinformationen |
+|   ↳ `number` | number | Versionsnummer |
+|   ↳ `message` | string | Versionsnachricht |
+|   ↳ `minorEdit` | boolean | Ob dies eine geringfügige Bearbeitung ist |
+|   ↳ `authorId` | string | Konto-ID des Versionsautors |
+|   ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+| `body` | object | Blogbeitrag-Body-Inhalt im angeforderten Format |
+|   ↳ `storage` | object | Body im Speicherformat (Confluence-Markup) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+|   ↳ `view` | object | Body im Ansichtsformat (gerendertes HTML) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+|   ↳ `atlas_doc_format` | object | Body im Atlassian Document Format (ADF) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+| `webUrl` | string | URL zum Anzeigen des Blogbeitrags |
+
+### `confluence_create_blogpost`
+
+Erstellen Sie einen neuen Blogbeitrag in einem Confluence-Space.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `spaceId` | string | Ja | Die ID des Spaces, in dem der Blogbeitrag erstellt werden soll |
+| `title` | string | Ja | Titel des Blogbeitrags |
+| `content` | string | Ja | Blogbeitrag-Inhalt im Confluence-Speicherformat (HTML) |
+| `status` | string | Nein | Blogbeitrag-Status: current (Standard) oder draft |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `id` | string | Erstellte Blogbeitrag-ID |
+| `title` | string | Blogbeitrag-Titel |
+| `status` | string | Blogbeitrag-Status |
+| `spaceId` | string | Space-ID |
+| `authorId` | string | Konto-ID des Autors |
+| `body` | object | Blogbeitrag-Inhalt |
+|   ↳ `storage` | object | Inhalt im Speicherformat (Confluence-Markup) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+|   ↳ `view` | object | Inhalt im Anzeigeformat (gerendertes HTML) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+|   ↳ `atlas_doc_format` | object | Inhalt im Atlassian Document Format (ADF) |
+|     ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|     ↳ `representation` | string | Inhaltsdarstellungstyp |
+| `version` | object | Versionsinformationen des Blogbeitrags |
+|   ↳ `number` | number | Versionsnummer |
+|   ↳ `message` | string | Versionsnachricht |
+|   ↳ `minorEdit` | boolean | Ob dies eine geringfügige Bearbeitung ist |
+|   ↳ `authorId` | string | Konto-ID des Versionsautors |
+|   ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+| `webUrl` | string | URL zum Anzeigen des Blogbeitrags |
+
+### `confluence_list_blogposts_in_space`
+
+Listet alle Blogbeiträge innerhalb eines bestimmten Confluence-Spaces auf.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `spaceId` | string | Ja | Die ID des Confluence-Spaces, aus dem Blogbeiträge aufgelistet werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Blogbeiträge (Standard: 25, max: 250) |
+| `status` | string | Nein | Filtern nach Status: current, archived, trashed oder draft |
+| `bodyFormat` | string | Nein | Format für den Blogbeitrags-Body: storage, atlas_doc_format oder view |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `blogPosts` | array | Array von Blogbeiträgen im Space |
+|   ↳ `id` | string | Blogbeitrags-ID |
+|   ↳ `title` | string | Blogbeitragstitel |
+|   ↳ `status` | string | Blogbeitragsstatus |
+|   ↳ `spaceId` | string | Space-ID |
+|   ↳ `authorId` | string | Konto-ID des Autors |
+|   ↳ `createdAt` | string | Erstellungszeitstempel |
+|   ↳ `version` | object | Versionsinformationen |
+|     ↳ `number` | number | Versionsnummer |
+|     ↳ `message` | string | Versionsnachricht |
+|     ↳ `minorEdit` | boolean | Ob dies eine geringfügige Bearbeitung ist |
+|     ↳ `authorId` | string | Konto-ID des Versionsautors |
+|     ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+|   ↳ `body` | object | Blogbeitrags-Body-Inhalt |
+|     ↳ `storage` | object | Body im Speicherformat (Confluence-Markup) |
+|       ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|       ↳ `representation` | string | Inhaltsdarstellungstyp |
+|     ↳ `view` | object | Body im Ansichtsformat (gerendertes HTML) |
+|       ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|       ↳ `representation` | string | Inhaltsdarstellungstyp |
+|     ↳ `atlas_doc_format` | object | Body im Atlassian Document Format (ADF) |
+|       ↳ `value` | string | Der Inhaltswert im angegebenen Format |
+|       ↳ `representation` | string | Inhaltsdarstellungstyp |
+|   ↳ `webUrl` | string | URL zum Anzeigen des Blogbeitrags |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_create_comment`
+
+Fügen Sie einen Kommentar zu einer Confluence-Seite hinzu.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, zu der ein Kommentar hinzugefügt werden soll |
+| `comment` | string | Ja | Kommentartext im Confluence-Speicherformat |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel der Erstellung |
+| `commentId` | string | Erstellte Kommentar-ID |
+| `pageId` | string | Seiten-ID |
+
+### `confluence_list_comments`
+
+Listen Sie alle Kommentare auf einer Confluence-Seite auf.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, von der Kommentare aufgelistet werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Kommentare (Standard: 25) |
+| `bodyFormat` | string | Nein | Format für den Kommentartext: storage, atlas_doc_format, view oder export_view (Standard: storage) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `comments` | array | Array von Confluence-Kommentaren |
+|   ↳ `id` | string | Eindeutige Kommentar-ID |
+|   ↳ `status` | string | Kommentarstatus (z. B. current) |
+|   ↳ `title` | string | Kommentartitel |
+|   ↳ `pageId` | string | ID der Seite, zu der der Kommentar gehört |
+|   ↳ `blogPostId` | string | ID des Blogposts, zu dem der Kommentar gehört |
+|   ↳ `parentCommentId` | string | ID des übergeordneten Kommentars |
+|   ↳ `body` | object | Kommentarinhalt |
+|     ↳ `value` | string | Kommentarinhalt |
+|     ↳ `representation` | string | Format der Inhaltsdarstellung (z. B. storage, view) |
+|   ↳ `createdAt` | string | ISO 8601-Zeitstempel der Kommentarerstellung |
+|   ↳ `authorId` | string | Account-ID des Kommentarautors |
+|   ↳ `version` | object | Versionsinformationen des Kommentars |
+|     ↳ `number` | number | Versionsnummer |
+|     ↳ `message` | string | Versionsnachricht |
+|     ↳ `minorEdit` | boolean | Ob es sich um eine geringfügige Bearbeitung handelt |
+|     ↳ `authorId` | string | Account-ID des Versionsautors |
+|     ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_update_comment`
+
+Aktualisiert einen vorhandenen Kommentar auf einer Confluence-Seite.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `commentId` | string | Ja | Confluence-Kommentar-ID zum Aktualisieren |
+| `comment` | string | Ja | Aktualisierter Kommentartext im Confluence-Speicherformat |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel der Aktualisierung |
+| `commentId` | string | Aktualisierte Kommentar-ID |
+| `updated` | boolean | Aktualisierungsstatus |
+
+### `confluence_delete_comment`
+
+Löscht einen Kommentar von einer Confluence-Seite.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `commentId` | string | Ja | Confluence-Kommentar-ID zum Löschen |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel der Löschung |
+| `commentId` | string | Gelöschte Kommentar-ID |
+| `deleted` | boolean | Löschstatus |
+
+### `confluence_upload_attachment`
+
+Laden Sie eine Datei als Anhang zu einer Confluence-Seite hoch.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z. B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, an die die Datei angehängt werden soll |
+| `file` | file | Ja | Die als Anhang hochzuladende Datei |
+| `fileName` | string | Nein | Optionaler benutzerdefinierter Dateiname für den Anhang |
+| `comment` | string | Nein | Optionaler Kommentar zum Anhang |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel des Uploads |
+| `attachmentId` | string | Hochgeladene Anhangs-ID |
+| `title` | string | Dateiname des Anhangs |
+| `fileSize` | number | Dateigröße in Bytes |
+| `mediaType` | string | MIME-Typ des Anhangs |
+| `downloadUrl` | string | Download-URL für den Anhang |
+| `pageId` | string | Seiten-ID, zu der der Anhang hinzugefügt wurde |
+
+### `confluence_list_attachments`
+
+Listen Sie alle Anhänge auf einer Confluence-Seite auf.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z. B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, von der Anhänge aufgelistet werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Anhänge (Standard: 50, max: 250) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `attachments` | array | Array von Confluence-Anhängen |
+|   ↳ `id` | string | Eindeutige Anhangs-ID (mit Präfix "att") |
+|   ↳ `title` | string | Dateiname des Anhangs |
+|   ↳ `status` | string | Anhangsstatus (z. B. current, archived, trashed) |
+|   ↳ `mediaType` | string | MIME-Typ des Anhangs |
+|   ↳ `fileSize` | number | Dateigröße in Bytes |
+|   ↳ `downloadUrl` | string | URL zum Herunterladen des Anhangs |
+|   ↳ `webuiUrl` | string | URL zum Anzeigen des Anhangs in der Confluence-Oberfläche |
+|   ↳ `pageId` | string | ID der Seite, zu der der Anhang gehört |
+|   ↳ `blogPostId` | string | ID des Blogbeitrags, zu dem der Anhang gehört |
+|   ↳ `comment` | string | Kommentar/Beschreibung des Anhangs |
+|   ↳ `version` | object | Versionsinformationen des Anhangs |
+|     ↳ `number` | number | Versionsnummer |
+|     ↳ `message` | string | Versionsnachricht |
+|     ↳ `minorEdit` | boolean | Ob es sich um eine geringfügige Bearbeitung handelt |
+|     ↳ `authorId` | string | Konto-ID des Versionsautors |
+|     ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_delete_attachment`
+
+Löschen eines Anhangs von einer Confluence-Seite (verschiebt ihn in den Papierkorb).
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `attachmentId` | string | Ja | Confluence-Anhangs-ID zum Löschen |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel der Löschung |
+| `attachmentId` | string | Gelöschte Anhangs-ID |
+| `deleted` | boolean | Löschstatus |
+
+### `confluence_list_labels`
+
+Alle Labels auf einer Confluence-Seite auflisten.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, von der Labels aufgelistet werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Labels (Standard: 25, max: 250) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | Zeitstempel des Abrufs |
+| `labels` | array | Array von Labels auf der Seite |
+|   ↳ `id` | string | Eindeutige Label-ID |
+|   ↳ `name` | string | Label-Name |
+|   ↳ `prefix` | string | Label-Präfix/Typ (z.B. global, my, team) |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_add_label`
+
+Fügen Sie einer Confluence-Seite ein Label zur Organisation und Kategorisierung hinzu.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, zu der das Label hinzugefügt werden soll |
+| `labelName` | string | Ja | Name des hinzuzufügenden Labels |
+| `prefix` | string | Nein | Label-Präfix: global (Standard), my, team oder system |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `pageId` | string | Seiten-ID, zu der das Label hinzugefügt wurde |
+| `labelName` | string | Name des hinzugefügten Labels |
+| `labelId` | string | ID des hinzugefügten Labels |
+
+### `confluence_delete_label`
+
+Entfernen Sie ein Label von einer Confluence-Seite.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `pageId` | string | Ja | Confluence-Seiten-ID, von der das Label entfernt werden soll |
+| `labelName` | string | Ja | Name des zu entfernenden Labels |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `pageId` | string | Seiten-ID, von der das Label entfernt wurde |
+| `labelName` | string | Name des entfernten Labels |
+| `deleted` | boolean | Löschstatus |
+
+### `confluence_get_pages_by_label`
+
+Ruft alle Seiten ab, auf die ein bestimmtes Label angewendet wurde.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z. B. ihrfirma.atlassian.net) |
+| `labelId` | string | Ja | Die ID des Labels, für das Seiten abgerufen werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Seiten (Standard: 50, max: 250) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `labelId` | string | ID des Labels |
+| `pages` | array | Array von Seiten mit diesem Label |
+|   ↳ `id` | string | Eindeutige Seitenkennung |
+|   ↳ `title` | string | Seitentitel |
+|   ↳ `status` | string | Seitenstatus (z. B. current, archived, trashed, draft) |
+|   ↳ `spaceId` | string | ID des Spaces, der die Seite enthält |
+|   ↳ `parentId` | string | ID der übergeordneten Seite (null bei oberster Ebene) |
+|   ↳ `authorId` | string | Account-ID des Seitenautors |
+|   ↳ `createdAt` | string | ISO 8601-Zeitstempel der Seitenerstellung |
+|   ↳ `version` | object | Seitenversionsinformationen |
+|     ↳ `number` | number | Versionsnummer |
+|     ↳ `message` | string | Versionsnachricht |
+|     ↳ `minorEdit` | boolean | Ob dies eine geringfügige Bearbeitung ist |
+|     ↳ `authorId` | string | Account-ID des Versionsautors |
+|     ↳ `createdAt` | string | ISO 8601-Zeitstempel der Versionserstellung |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_list_space_labels`
+
+Alle Labels auflisten, die mit einem Confluence-Space verknüpft sind.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `spaceId` | string | Ja | Die ID des Confluence-Space, von dem Labels aufgelistet werden sollen |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Labels (Standard: 25, max: 250) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `spaceId` | string | ID des Space |
+| `labels` | array | Array von Labels im Space |
+|   ↳ `id` | string | Eindeutige Label-ID |
+|   ↳ `name` | string | Label-Name |
+|   ↳ `prefix` | string | Label-Präfix/Typ (z.B. global, my, team) |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |
+
+### `confluence_get_space`
+
+Details zu einem bestimmten Confluence-Space abrufen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z.B. ihrfirma.atlassian.net) |
+| `spaceId` | string | Ja | Confluence-Space-ID zum Abrufen |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO 8601-Zeitstempel der Operation |
+| `spaceId` | string | Space-ID |
+| `name` | string | Space-Name |
+| `key` | string | Space-Schlüssel |
+| `type` | string | Space-Typ (global, personal) |
+| `status` | string | Space-Status (current, archived) |
+| `url` | string | URL zum Anzeigen des Space in Confluence |
+| `authorId` | string | Account-ID des Space-Erstellers |
+| `createdAt` | string | ISO 8601-Zeitstempel der Space-Erstellung |
+| `homepageId` | string | ID der Space-Startseite |
+| `description` | object | Space-Beschreibungsinhalt |
+|   ↳ `value` | string | Beschreibungstext |
+|   ↳ `representation` | string | Format der Inhaltsdarstellung (z. B. plain, view, storage) |
+
+### `confluence_list_spaces`
+
+Listet alle Confluence-Spaces auf, auf die der Benutzer zugreifen kann.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `domain` | string | Ja | Ihre Confluence-Domain (z. B. ihrfirma.atlassian.net) |
+| `limit` | number | Nein | Maximale Anzahl der zurückzugebenden Spaces (Standard: 25, max: 250) |
+| `cursor` | string | Nein | Paginierungs-Cursor aus vorheriger Antwort |
+| `cloudId` | string | Nein | Confluence Cloud-ID für die Instanz. Wenn nicht angegeben, wird sie über die Domain abgerufen. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `ts` | string | ISO-8601-Zeitstempel der Operation |
+| `spaces` | array | Array von Confluence-Spaces |
+|   ↳ `id` | string | Eindeutige Space-ID |
+|   ↳ `key` | string | Space-Schlüssel \(Kurzbezeichner für URLs\) |
+|   ↳ `name` | string | Space-Name |
+|   ↳ `type` | string | Space-Typ \(z. B. global, personal\) |
+|   ↳ `status` | string | Space-Status \(z. B. current, archived\) |
+|   ↳ `authorId` | string | Account-ID des Space-Erstellers |
+|   ↳ `createdAt` | string | ISO-8601-Zeitstempel der Space-Erstellung |
+|   ↳ `homepageId` | string | ID der Space-Startseite |
+|   ↳ `description` | object | Space-Beschreibung |
+|     ↳ `value` | string | Beschreibungstext |
+|     ↳ `representation` | string | Format der Inhaltsdarstellung \(z. B. plain, view, storage\) |
+| `nextCursor` | string | Cursor zum Abrufen der nächsten Ergebnisseite |

apps/docs/content/docs/de/tools/cursor.mdx

@@ -168,15 +168,3 @@ Löscht einen Cloud-Agenten dauerhaft. Diese Aktion kann nicht rückgängig gema
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Ja | Cursor API-Schlüssel |
 | `agentId` | string | Ja | Eindeutige Kennung für den Cloud-Agenten \(z.B. bc_abc123\) |
-
-#### Ausgabe
-
-| Parameter | Typ | Beschreibung |
-| --------- | ---- | ----------- |
-| `content` | string | Erfolgsmeldung |
-| `metadata` | object | Ergebnis-Metadaten |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `cursor`

apps/docs/content/docs/de/tools/datadog.mdx

@@ -295,8 +295,3 @@ Eine geplante Ausfallzeit abbrechen.
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `success` | boolean | Ob die Ausfallzeit erfolgreich abgebrochen wurde |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `datadog`

apps/docs/content/docs/de/tools/discord.mdx

@@ -730,8 +730,3 @@ Einen Discord-Webhook löschen
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `message` | string | Erfolgs- oder Fehlermeldung |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `discord`

apps/docs/content/docs/de/tools/dropbox.mdx

@@ -212,8 +212,3 @@ Suche nach Dateien und Ordnern in Dropbox
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `matches` | array | Suchergebnisse |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `dropbox`

apps/docs/content/docs/de/tools/dspy.mdx

@@ -0,0 +1,107 @@
+---
+title: DSPy
+description: Führen Sie Vorhersagen mit selbst gehosteten DSPy-Programmen aus
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="dspy"
+  color="#E0E0E0"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[DSPy](https://github.com/stanford-oval/dspy) ist ein Open-Source-Framework für die Programmierung – statt Prompting – von Sprachmodellen. DSPy ermöglicht es Ihnen, interpretierbare und modulare LLM-gestützte Agenten mithilfe von Python-Funktionen, strukturierten Modulen und deklarativen Signaturen zu erstellen, wodurch es einfach wird, Sprachmodellanwendungen zu komponieren, zu debuggen und zuverlässig bereitzustellen.
+
+Mit DSPy in Sim können Sie:
+
+- **Benutzerdefinierte Vorhersagen ausführen**: Verbinden Sie Ihren selbst gehosteten DSPy-Server und rufen Sie Vorhersage-Endpunkte für eine Vielzahl von natürlichsprachlichen Aufgaben auf.
+- **Chain of Thought und ReAct-Reasoning**: Nutzen Sie fortgeschrittene DSPy-Module für schrittweises Reasoning, mehrstufige Dialoge und Action-Observation-Schleifen.
+- **Integration in Ihre Workflows**: Automatisieren Sie LLM-Vorhersagen und Reasoning als Teil jeder Sim-Automatisierung oder Agentenroutine.
+- **Benutzerdefinierte Endpunkte und Kontext bereitstellen**: Rufen Sie flexibel Ihre eigenen DSPy-gestützten APIs mit benutzerdefinierter Authentifizierung, Endpunkten, Eingabefeldern und Kontext auf.
+
+Diese Funktionen ermöglichen es Ihren Sim-Agenten, auf modulare, interpretierbare LLM-basierte Programme für Aufgaben wie Fragebeantwortung, Dokumentenanalyse, Entscheidungsunterstützung und mehr zuzugreifen – wobei Sie die Kontrolle über das Modell, die Daten und die Logik behalten.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanweisungen
+
+Integrieren Sie sich mit Ihren selbst gehosteten DSPy-Programmen für LLM-gestützte Vorhersagen. Unterstützt Predict, Chain of Thought und ReAct-Agenten. DSPy ist das Framework für die Programmierung – nicht das Prompting – von Sprachmodellen.
+
+## Tools
+
+### `dspy_predict`
+
+Führen Sie eine Vorhersage mit einem selbst gehosteten DSPy-Programm-Endpunkt aus
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `baseUrl` | string | Ja | Basis-URL des DSPy-Servers \(z. B. https://your-dspy-server.com\) |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung \(falls von Ihrem Server erforderlich\) |
+| `endpoint` | string | Nein | API-Endpunkt-Pfad \(Standard ist /predict\) |
+| `input` | string | Ja | Der Eingabetext, der an das DSPy-Programm gesendet werden soll |
+| `inputField` | string | Nein | Name des Eingabefelds, das vom DSPy-Programm erwartet wird \(Standard ist "text"\) |
+| `context` | string | Nein | Zusätzlicher Kontext, der dem DSPy-Programm bereitgestellt werden soll |
+| `additionalInputs` | json | Nein | Zusätzliche Schlüssel-Wert-Paare, die in den Request-Body aufgenommen werden sollen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `answer` | string | Die Hauptausgabe/Antwort des DSPy-Programms |
+| `reasoning` | string | Die Begründung oder Erklärung hinter der Antwort \(falls verfügbar\) |
+| `status` | string | Antwortstatus vom DSPy-Server \(Erfolg oder Fehler\) |
+| `rawOutput` | json | Die vollständige Rohausgabe des DSPy-Programms \(result.toDict\(\)\) |
+
+### `dspy_chain_of_thought`
+
+Führen Sie eine Chain of Thought-Vorhersage mit einem selbst gehosteten DSPy ChainOfThought-Programm-Endpunkt aus
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `baseUrl` | string | Ja | Basis-URL des DSPy-Servers \(z. B. https://your-dspy-server.com\) |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung \(falls von Ihrem Server erforderlich\) |
+| `endpoint` | string | Nein | API-Endpunkt-Pfad \(Standard ist /predict\) |
+| `question` | string | Ja | Die Frage, die mithilfe von Chain of Thought-Reasoning beantwortet werden soll |
+| `context` | string | Nein | Zusätzlicher Kontext zur Beantwortung der Frage |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `answer` | string | Die durch Chain of Thought-Reasoning generierte Antwort |
+| `reasoning` | string | Die schrittweise Begründung, die zur Antwort geführt hat |
+| `status` | string | Antwortstatus vom DSPy-Server \(Erfolg oder Fehler\) |
+| `rawOutput` | json | Die vollständige Rohausgabe des DSPy-Programms \(result.toDict\(\)\) |
+
+### `dspy_react`
+
+Führen Sie einen ReAct-Agenten mit einem selbst gehosteten DSPy ReAct-Programm-Endpunkt für mehrstufiges Denken und Handeln aus
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `baseUrl` | string | Ja | Basis-URL des DSPy-Servers \(z. B. https://your-dspy-server.com\) |
+| `apiKey` | string | Nein | API-Schlüssel für die Authentifizierung \(falls von Ihrem Server erforderlich\) |
+| `endpoint` | string | Nein | API-Endpunkt-Pfad \(Standardwert: /predict\) |
+| `task` | string | Ja | Die Aufgabe oder Frage, an der der ReAct-Agent arbeiten soll |
+| `context` | string | Nein | Zusätzlicher Kontext für die Aufgabe |
+| `maxIterations` | number | Nein | Maximale Anzahl von Denkiterationen \(Standardwert: Servereinstellung\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `answer` | string | Die endgültige Antwort oder das Ergebnis des ReAct-Agenten |
+| `reasoning` | string | Die Gesamtzusammenfassung des Denkprozesses des Agenten |
+| `trajectory` | array | Der schrittweise Verlauf von Gedanken, Aktionen und Beobachtungen |
+|   ↳ `thought` | string | Der Denkprozess in diesem Schritt |
+|   ↳ `toolName` | string | Der Name des aufgerufenen Tools/der Aktion |
+|   ↳ `toolArgs` | json | An das Tool übergebene Argumente |
+|   ↳ `observation` | string | Die Beobachtung/das Ergebnis der Tool-Ausführung |
+| `status` | string | Antwortstatus vom DSPy-Server \(Erfolg oder Fehler\) |
+| `rawOutput` | json | Die vollständige Rohausgabe des DSPy-Programms \(result.toDict\(\)\) |

apps/docs/content/docs/de/tools/duckduckgo.mdx

@@ -56,8 +56,3 @@ Durchsuche das Web mit der DuckDuckGo Instant Answers API. Liefert sofortige Ant
 | `answerType` | string | Typ der Antwort \(z.B. calc, ip, usw.\) |
 | `type` | string | Antworttyp: A \(Artikel\), D \(Begriffsklärung\), C \(Kategorie\), N \(Name\), E \(Exklusiv\) |
 | `relatedTopics` | array | Array verwandter Themen mit URLs und Beschreibungen |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `duckduckgo`

apps/docs/content/docs/de/tools/dynamodb.mdx

@@ -186,3 +186,20 @@ Ein Element aus einer DynamoDB-Tabelle löschen
 
 - Kategorie: `tools`
 - Typ: `dynamodb`
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `region` | string | Ja | AWS-Region (z.B. us-east-1) |
+| `accessKeyId` | string | Ja | AWS-Zugriffsschlüssel-ID |
+| `secretAccessKey` | string | Ja | AWS-Geheimzugriffsschlüssel |
+| `tableName` | string | Nein | Optionaler Tabellenname, um ein detailliertes Schema zu erhalten (z.B. "Users", "Orders"). Wenn nicht angegeben, werden alle Tabellen aufgelistet. |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `message` | string | Statusmeldung der Operation |
+| `tables` | array | Liste der Tabellennamen in der Region |
+| `tableDetails` | object | Detaillierte Schemainformationen für eine bestimmte Tabelle |

apps/docs/content/docs/de/tools/elasticsearch.mdx

@@ -363,3 +363,22 @@ Erhalte umfassende Statistiken über den Elasticsearch-Cluster.
 
 - Kategorie: `tools`
 - Typ: `elasticsearch`
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `deploymentType` | string | Ja | Bereitstellungstyp: self_hosted oder cloud |
+| `host` | string | Nein | Elasticsearch-Host-URL \(für self-hosted\) |
+| `cloudId` | string | Nein | Elastic Cloud ID \(für Cloud-Bereitstellungen\) |
+| `authMethod` | string | Ja | Authentifizierungsmethode: api_key oder basic_auth |
+| `apiKey` | string | Nein | Elasticsearch API-Schlüssel |
+| `username` | string | Nein | Benutzername für Basic-Auth |
+| `password` | string | Nein | Passwort für Basic-Auth |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `message` | string | Zusammenfassende Nachricht über die Indizes |
+| `indices` | json | Array von Indexinformationsobjekten |

apps/docs/content/docs/de/tools/elevenlabs.mdx

@@ -49,8 +49,3 @@ TTS mit ElevenLabs-Stimmen konvertieren
 | --------- | ---- | ----------- |
 | `audioUrl` | string | Die URL der generierten Audiodatei |
 | `audioFile` | file | Die generierte Audiodatei |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `elevenlabs`

apps/docs/content/docs/de/tools/enrich.mdx

@@ -0,0 +1,925 @@
+---
+title: Enrich
+description: B2B-Datenanreicherung und LinkedIn-Intelligence mit Enrich.so
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="enrich"
+  color="#E5E5E6"
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Enrich.so](https://enrich.so/) liefert präzise B2B-Datenanreicherung und LinkedIn-Intelligence in Echtzeit. Die Plattform bietet dynamischen Zugriff auf öffentliche und strukturierte Unternehmens-, Kontakt- und berufliche Informationen und ermöglicht es Teams, umfassendere Profile zu erstellen, die Lead-Qualität zu verbessern und effektivere Kontaktaufnahmen durchzuführen.
+
+Mit Enrich.so können Sie:
+
+- **Kontakt- und Unternehmensprofile anreichern**: Entdecken Sie sofort wichtige Datenpunkte für Leads, Interessenten und Unternehmen – nur mit einer E-Mail-Adresse oder einem LinkedIn-Profil.
+- **E-Mail-Zustellbarkeit überprüfen**: Prüfen Sie, ob E-Mail-Adressen gültig, zustellbar und sicher zu kontaktieren sind, bevor Sie versenden.
+- **Geschäftliche und private E-Mails finden**: Identifizieren Sie fehlende geschäftliche E-Mails aus einem LinkedIn-Profil oder private E-Mails, um Ihre Reichweite zu erweitern.
+- **Telefonnummern und Social-Media-Profile aufdecken**: Erschließen Sie zusätzliche Kommunikationskanäle für Kontakte durch Anreicherungstools.
+- **LinkedIn-Beiträge und Engagement analysieren**: Extrahieren Sie Erkenntnisse über Reichweite, Reaktionen und Zielgruppe aus öffentlichen LinkedIn-Inhalten.
+- **Erweiterte Personen- und Unternehmenssuche durchführen**: Ermöglichen Sie Ihren Agenten, Unternehmen und Fachkräfte anhand detaillierter Filter und Echtzeit-Intelligence zu finden.
+
+Die Sim-Integration mit Enrich.so befähigt Ihre Agenten und Automatisierungen, B2B-Daten sofort abzufragen, anzureichern und zu validieren, wodurch die Produktivität in Workflows wie Vertriebsakquise, Recruiting, Marketing-Operations und mehr gesteigert wird. Die Kombination der Orchestrierungsfähigkeiten von Sim mit Enrich.so ermöglicht intelligentere, datengesteuerte Automatisierungsstrategien, die durch erstklassige B2B-Intelligence unterstützt werden.
+{/* MANUAL-CONTENT-END */}
+
+## Nutzungsanleitung
+
+Greifen Sie auf B2B-Daten-Intelligence in Echtzeit mit Enrich.so zu. Reichern Sie Profile aus E-Mail-Adressen an, finden Sie geschäftliche E-Mails aus LinkedIn, überprüfen Sie die E-Mail-Zustellbarkeit, suchen Sie nach Personen und Unternehmen und analysieren Sie das Engagement von LinkedIn-Beiträgen.
+
+## Tools
+
+### `enrich_check_credits`
+
+Überprüfen Sie Ihre Enrich API-Guthaben-Nutzung und Ihr verbleibendes Guthaben.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `totalCredits` | number | Dem Konto insgesamt zugewiesene Credits |
+| `creditsUsed` | number | Bisher verbrauchte Credits |
+| `creditsRemaining` | number | Verbleibende verfügbare Credits |
+
+### `enrich_email_to_profile`
+
+Rufen Sie detaillierte LinkedIn-Profilinformationen über eine E-Mail-Adresse ab, einschließlich Berufserfahrung, Ausbildung und Fähigkeiten.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `email` | string | Ja | E-Mail-Adresse für die Suche \(z. B. john.doe@company.com\) |
+| `inRealtime` | boolean | Nein | Auf true setzen, um aktuelle Daten abzurufen und zwischengespeicherte Informationen zu umgehen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `displayName` | string | Vollständiger Anzeigename |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `headline` | string | Berufliche Überschrift |
+| `occupation` | string | Aktuelle Tätigkeit |
+| `summary` | string | Profilzusammenfassung |
+| `location` | string | Standort |
+| `country` | string | Land |
+| `linkedInUrl` | string | LinkedIn-Profil-URL |
+| `photoUrl` | string | Profilfoto-URL |
+| `connectionCount` | number | Anzahl der Kontakte |
+| `isConnectionCountObfuscated` | boolean | Ob die Kontaktanzahl verschleiert ist \(500+\) |
+| `positionHistory` | array | Berufserfahrung |
+|   ↳ `title` | string | Berufsbezeichnung |
+|   ↳ `company` | string | Firmenname |
+|   ↳ `startDate` | string | Startdatum |
+|   ↳ `endDate` | string | Enddatum |
+|   ↳ `location` | string | Standort |
+| `education` | array | Ausbildungsverlauf |
+|   ↳ `school` | string | Schulname |
+|   ↳ `degree` | string | Abschluss |
+|   ↳ `fieldOfStudy` | string | Studienrichtung |
+|   ↳ `startDate` | string | Startdatum |
+|   ↳ `endDate` | string | Enddatum |
+| `certifications` | array | Berufliche Zertifizierungen |
+|   ↳ `name` | string | Zertifizierungsname |
+|   ↳ `authority` | string | Ausstellende Behörde |
+|   ↳ `url` | string | Zertifizierungs-URL |
+| `skills` | array | Liste der Fähigkeiten |
+| `languages` | array | Liste der Sprachen |
+| `locale` | string | Profil-Locale \(z. B. en_US\) |
+| `version` | number | Profilversionsnummer |
+
+### `enrich_email_to_person_lite`
+
+Rufen Sie grundlegende LinkedIn-Profilinformationen über eine E-Mail-Adresse ab. Eine schlankere Version mit nur den wichtigsten Daten.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `email` | string | Ja | E-Mail-Adresse für die Suche \(z. B. john.doe@company.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `name` | string | Vollständiger Name |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `email` | string | E-Mail-Adresse |
+| `title` | string | Berufsbezeichnung |
+| `location` | string | Standort |
+| `company` | string | Aktuelles Unternehmen |
+| `companyLocation` | string | Unternehmensstandort |
+| `companyLinkedIn` | string | LinkedIn-URL des Unternehmens |
+| `profileId` | string | LinkedIn-Profil-ID |
+| `schoolName` | string | Schulname |
+| `schoolUrl` | string | Schul-URL |
+| `linkedInUrl` | string | LinkedIn-Profil-URL |
+| `photoUrl` | string | Profilfoto-URL |
+| `followerCount` | number | Anzahl der Follower |
+| `connectionCount` | number | Anzahl der Kontakte |
+| `languages` | array | Gesprochene Sprachen |
+| `projects` | array | Projekte |
+| `certifications` | array | Zertifizierungen |
+| `volunteerExperience` | array | Ehrenamtliche Tätigkeiten |
+
+### `enrich_linkedin_profile`
+
+Reichern Sie eine LinkedIn-Profil-URL mit detaillierten Informationen an, einschließlich Positionen, Ausbildung und Social-Media-Kennzahlen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `url` | string | Ja | LinkedIn-Profil-URL \(z. B. linkedin.com/in/williamhgates\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `profileId` | string | LinkedIn-Profil-ID |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `subTitle` | string | Profil-Untertitel/Überschrift |
+| `profilePicture` | string | Profilbild-URL |
+| `backgroundImage` | string | Hintergrundbild-URL |
+| `industry` | string | Branche |
+| `location` | string | Standort |
+| `followersCount` | number | Anzahl der Follower |
+| `connectionsCount` | number | Anzahl der Kontakte |
+| `premium` | boolean | Ob das Konto Premium ist |
+| `influencer` | boolean | Ob das Konto ein Influencer ist |
+| `positions` | array | Berufspositionen |
+|   ↳ `title` | string | Berufsbezeichnung |
+|   ↳ `company` | string | Firmenname |
+|   ↳ `companyLogo` | string | Firmenlogo-URL |
+|   ↳ `startDate` | string | Startdatum |
+|   ↳ `endDate` | string | Enddatum |
+|   ↳ `location` | string | Standort |
+| `education` | array | Bildungshistorie |
+|   ↳ `school` | string | Schulname |
+|   ↳ `degree` | string | Abschluss |
+|   ↳ `fieldOfStudy` | string | Studienrichtung |
+|   ↳ `startDate` | string | Startdatum |
+|   ↳ `endDate` | string | Enddatum |
+| `websites` | array | Persönliche Websites |
+
+### `enrich_find_email`
+
+Person finden
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `fullName` | string | Ja | Vollständiger Name der Person \(z. B. Max Mustermann\) |
+| `companyDomain` | string | Ja | Unternehmens-Domain \(z. B. beispiel.de\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Gefundene E-Mail-Adresse |
+| `firstName` | string | Vorname |
+| `lastName` | string | Nachname |
+| `domain` | string | Unternehmens-Domain |
+| `found` | boolean | Ob eine E-Mail gefunden wurde |
+| `acceptAll` | boolean | Ob die Domain alle E-Mails akzeptiert |
+
+### `enrich_linkedin_to_work_email`
+
+Geschäftliche E-Mail-Adresse aus einer LinkedIn-Profil-URL finden.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `linkedinProfile` | string | Ja | LinkedIn-Profil-URL \(z. B. https://www.linkedin.com/in/williamhgates\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Gefundene geschäftliche E-Mail-Adresse |
+| `found` | boolean | Ob eine E-Mail gefunden wurde |
+| `status` | string | Anfragestatus \(in_progress oder completed\) |
+
+### `enrich_linkedin_to_personal_email`
+
+Private E-Mail-Adresse aus einer LinkedIn-Profil-URL finden.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `linkedinProfile` | string | Ja | LinkedIn-Profil-URL \(z. B. linkedin.com/in/benutzername\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Persönliche E-Mail-Adresse |
+| `found` | boolean | Ob eine E-Mail-Adresse gefunden wurde |
+| `status` | string | Anfragestatus |
+
+### `enrich_phone_finder`
+
+Finden Sie eine Telefonnummer anhand einer LinkedIn-Profil-URL.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `linkedinProfile` | string | Ja | LinkedIn-Profil-URL \(z. B. linkedin.com/in/williamhgates\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `profileUrl` | string | LinkedIn-Profil-URL |
+| `mobileNumber` | string | Gefundene Mobiltelefonnummer |
+| `found` | boolean | Ob eine Telefonnummer gefunden wurde |
+| `status` | string | Anfragestatus \(in_progress oder completed\) |
+
+### `enrich_email_to_phone`
+
+Finden Sie eine Telefonnummer, die mit einer E-Mail-Adresse verknüpft ist.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `email` | string | Ja | Zu suchende E-Mail-Adresse \(z. B. john.doe@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Nachgeschlagene E-Mail-Adresse |
+| `mobileNumber` | string | Gefundene Mobiltelefonnummer |
+| `found` | boolean | Ob eine Telefonnummer gefunden wurde |
+| `status` | string | Anfragestatus \(in_progress oder completed\) |
+
+### `enrich_verify_email`
+
+Überprüfen Sie eine E-Mail-Adresse auf Zustellbarkeit, einschließlich Catch-All-Erkennung und Anbieteridentifikation.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `email` | string | Ja | Zu überprüfende E-Mail-Adresse \(z. B. john.doe@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Überprüfte E-Mail-Adresse |
+| `status` | string | Überprüfungsstatus |
+| `result` | string | Zustellbarkeitsergebnis \(deliverable, undeliverable usw.\) |
+| `confidenceScore` | number | Konfidenzwert \(0-100\) |
+| `smtpProvider` | string | E-Mail-Dienstanbieter \(z. B. Google, Microsoft\) |
+| `mailDisposable` | boolean | Ob die E-Mail von einem Wegwerf-Anbieter stammt |
+| `mailAcceptAll` | boolean | Ob die Domain eine Catch-All-Domain ist |
+| `free` | boolean | Ob die E-Mail einen kostenlosen E-Mail-Dienst verwendet |
+
+### `enrich_disposable_email_check`
+
+Überprüfen Sie, ob eine E-Mail-Adresse von einem Wegwerf- oder temporären E-Mail-Anbieter stammt. Gibt einen Score und Validierungsdetails zurück.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `email` | string | Ja | Zu überprüfende E-Mail-Adresse \(z. B. john.doe@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Geprüfte E-Mail-Adresse |
+| `score` | number | Validierungsbewertung \(0-100\) |
+| `testsPassed` | string | Anzahl bestandener Tests \(z. B. "3/3"\) |
+| `passed` | boolean | Ob die E-Mail alle Validierungstests bestanden hat |
+| `reason` | string | Grund für Fehler, falls E-Mail nicht bestanden hat |
+| `mailServerIp` | string | IP-Adresse des Mailservers |
+| `mxRecords` | array | MX-Einträge für die Domain |
+|   ↳ `host` | string | MX-Eintrag-Host |
+|   ↳ `pref` | number | MX-Eintrag-Präferenz |
+
+### `enrich_email_to_ip`
+
+Ermitteln Sie eine IP-Adresse, die mit einer E-Mail-Adresse verknüpft ist.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `email` | string | Ja | Zu suchende E-Mail-Adresse \(z. B. john.doe@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Gesuchte E-Mail-Adresse |
+| `ip` | string | Zugehörige IP-Adresse |
+| `found` | boolean | Ob eine IP-Adresse gefunden wurde |
+
+### `enrich_ip_to_company`
+
+Identifizieren Sie ein Unternehmen anhand einer IP-Adresse mit detaillierten firmografischen Informationen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `ip` | string | Ja | Zu suchende IP-Adresse \(z. B. 86.92.60.221\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `name` | string | Firmenname |
+| `legalName` | string | Rechtlicher Firmenname |
+| `domain` | string | Primäre Domain |
+| `domainAliases` | array | Domain-Aliase |
+| `sector` | string | Geschäftsbereich |
+| `industry` | string | Branche |
+| `phone` | string | Telefonnummer |
+| `employees` | number | Anzahl der Mitarbeiter |
+| `revenue` | string | Geschätzter Umsatz |
+| `location` | json | Firmenstandort |
+|   ↳ `city` | string | Stadt |
+|   ↳ `state` | string | Bundesland |
+|   ↳ `country` | string | Land |
+|   ↳ `timezone` | string | Zeitzone |
+| `linkedInUrl` | string | LinkedIn-Unternehmens-URL |
+| `twitterUrl` | string | Twitter-URL |
+| `facebookUrl` | string | Facebook-URL |
+
+### `enrich_company_lookup`
+
+Umfassende Unternehmensinformationen nach Name oder Domain abrufen, einschließlich Finanzierung, Standort und Social-Media-Profile.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `name` | string | Nein | Firmenname \(z. B. Google\) |
+| `domain` | string | Nein | Firmendomain \(z. B. google.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `name` | string | Firmenname |
+| `universalName` | string | Universeller Firmenname |
+| `companyId` | string | Firmen-ID |
+| `description` | string | Firmenbeschreibung |
+| `phone` | string | Telefonnummer |
+| `linkedInUrl` | string | LinkedIn-Unternehmens-URL |
+| `websiteUrl` | string | Firmenwebsite |
+| `followers` | number | Anzahl der LinkedIn-Follower |
+| `staffCount` | number | Anzahl der Mitarbeiter |
+| `foundedDate` | string | Gründungsdatum |
+| `type` | string | Unternehmenstyp |
+| `industries` | array | Branchen |
+| `specialties` | array | Unternehmensspezialisierungen |
+| `headquarters` | json | Hauptsitz |
+|   ↳ `city` | string | Stadt |
+|   ↳ `country` | string | Land |
+|   ↳ `postalCode` | string | Postleitzahl |
+|   ↳ `line1` | string | Adresszeile 1 |
+| `logo` | string | Firmenlogo-URL |
+| `coverImage` | string | Titelbild-URL |
+| `fundingRounds` | array | Finanzierungshistorie |
+|   ↳ `roundType` | string | Finanzierungsrunde |
+|   ↳ `amount` | number | Eingeworbener Betrag |
+|   ↳ `currency` | string | Währung |
+|   ↳ `investors` | array | Investoren |
+
+### `enrich_company_funding`
+
+Rufen Sie die Finanzierungshistorie, Traffic-Metriken und Führungskräfteinformationen eines Unternehmens nach Domain ab.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `domain` | string | Ja | Unternehmens-Domain \(z. B. example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `legalName` | string | Rechtlicher Unternehmensname |
+| `employeeCount` | number | Anzahl der Mitarbeiter |
+| `headquarters` | string | Hauptsitz |
+| `industry` | string | Branche |
+| `totalFundingRaised` | number | Gesamte eingeworbene Finanzierung |
+| `fundingRounds` | array | Finanzierungsrunden |
+|   ↳ `roundType` | string | Rundentyp |
+|   ↳ `amount` | number | Eingeworbener Betrag |
+|   ↳ `date` | string | Datum |
+|   ↳ `investors` | array | Investoren |
+| `monthlyVisits` | number | Monatliche Website-Besuche |
+| `trafficChange` | number | Traffic-Veränderung in Prozent |
+| `itSpending` | number | Geschätzte IT-Ausgaben in USD |
+| `executives` | array | Führungsteam |
+|   ↳ `name` | string | Name |
+|   ↳ `title` | string | Titel |
+
+### `enrich_company_revenue`
+
+Rufen Sie Umsatzdaten, CEO-Informationen und Wettbewerbsanalysen eines Unternehmens nach Domain ab.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `domain` | string | Ja | Unternehmens-Domain \(z. B. clay.io\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `companyName` | string | Firmenname |
+| `shortDescription` | string | Kurze Firmenbeschreibung |
+| `fullSummary` | string | Vollständige Firmenzusammenfassung |
+| `revenue` | string | Firmenumsatz |
+| `revenueMin` | number | Minimale Umsatzschätzung |
+| `revenueMax` | number | Maximale Umsatzschätzung |
+| `employeeCount` | number | Anzahl der Mitarbeiter |
+| `founded` | string | Gründungsjahr |
+| `ownership` | string | Eigentumsform |
+| `status` | string | Firmenstatus \(z. B. Aktiv\) |
+| `website` | string | Firmenwebsite-URL |
+| `ceo` | json | CEO-Informationen |
+|   ↳ `name` | string | CEO-Name |
+|   ↳ `designation` | string | CEO-Bezeichnung/Titel |
+|   ↳ `rating` | number | CEO-Bewertung |
+| `socialLinks` | json | Social-Media-Links |
+|   ↳ `linkedIn` | string | LinkedIn-URL |
+|   ↳ `twitter` | string | Twitter-URL |
+|   ↳ `facebook` | string | Facebook-URL |
+| `totalFunding` | string | Gesamte eingeworbene Finanzierung |
+| `fundingRounds` | number | Anzahl der Finanzierungsrunden |
+| `competitors` | array | Wettbewerber |
+|   ↳ `name` | string | Name des Wettbewerbers |
+|   ↳ `revenue` | string | Umsatz |
+|   ↳ `employeeCount` | number | Mitarbeiterzahl |
+|   ↳ `headquarters` | string | Hauptsitz |
+
+### `enrich_search_people`
+
+Suche nach Fachkräften anhand verschiedener Kriterien wie Name, Titel, Fähigkeiten, Ausbildung und Unternehmen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `firstName` | string | Nein | Vorname |
+| `lastName` | string | Nein | Nachname |
+| `summary` | string | Nein | Schlüsselwörter für berufliche Zusammenfassung |
+| `subTitle` | string | Nein | Berufsbezeichnung/Untertitel |
+| `locationCountry` | string | Nein | Land |
+| `locationCity` | string | Nein | Stadt |
+| `locationState` | string | Nein | Bundesland/Provinz |
+| `influencer` | boolean | Nein | Nur nach Influencern filtern |
+| `premium` | boolean | Nein | Nur nach Premium-Konten filtern |
+| `language` | string | Nein | Hauptsprache |
+| `industry` | string | Nein | Branche |
+| `currentJobTitles` | json | Nein | Aktuelle Berufsbezeichnungen \(Array\) |
+| `pastJobTitles` | json | Nein | Frühere Berufsbezeichnungen \(Array\) |
+| `skills` | json | Nein | Zu suchende Fähigkeiten \(Array\) |
+| `schoolNames` | json | Nein | Schulnamen \(Array\) |
+| `certifications` | json | Nein | Zertifizierungen zum Filtern \(Array\) |
+| `degreeNames` | json | Nein | Abschlussnamen zum Filtern \(Array\) |
+| `studyFields` | json | Nein | Studienfächer zum Filtern \(Array\) |
+| `currentCompanies` | json | Nein | Aktuelle Unternehmens-IDs zum Filtern \(Array von Zahlen\) |
+| `pastCompanies` | json | Nein | Frühere Unternehmens-IDs zum Filtern \(Array von Zahlen\) |
+| `currentPage` | number | Nein | Seitennummer \(Standard: 1\) |
+| `pageSize` | number | Nein | Ergebnisse pro Seite \(Standard: 20\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `currentPage` | number | Aktuelle Seitennummer |
+| `totalPage` | number | Gesamtanzahl der Seiten |
+| `pageSize` | number | Ergebnisse pro Seite |
+| `profiles` | array | Suchergebnisse |
+|   ↳ `profileIdentifier` | string | Profil-ID |
+|   ↳ `givenName` | string | Vorname |
+|   ↳ `familyName` | string | Nachname |
+|   ↳ `currentPosition` | string | Aktuelle Berufsbezeichnung |
+|   ↳ `profileImage` | string | Profilbild-URL |
+|   ↳ `externalProfileUrl` | string | LinkedIn-URL |
+|   ↳ `city` | string | Stadt |
+|   ↳ `country` | string | Land |
+|   ↳ `expertSkills` | array | Fähigkeiten |
+
+### `enrich_search_company`
+
+Suche nach Unternehmen anhand verschiedener Kriterien wie Name, Branche, Standort und Größe.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `name` | string | Nein | Unternehmensname |
+| `website` | string | Nein | Unternehmenswebsite-URL |
+| `tagline` | string | Nein | Unternehmens-Slogan |
+| `type` | string | Nein | Unternehmenstyp \(z. B. Privat, Öffentlich\) |
+| `description` | string | Nein | Schlüsselwörter der Unternehmensbeschreibung |
+| `industries` | json | Nein | Branchen zum Filtern \(Array\) |
+| `locationCountry` | string | Nein | Land |
+| `locationCity` | string | Nein | Stadt |
+| `postalCode` | string | Nein | Postleitzahl |
+| `locationCountryList` | json | Nein | Mehrere Länder zum Filtern \(Array\) |
+| `locationCityList` | json | Nein | Mehrere Städte zum Filtern \(Array\) |
+| `specialities` | json | Nein | Unternehmensspezialisierungen \(Array\) |
+| `followers` | number | Nein | Mindestanzahl an Followern |
+| `staffCount` | number | Nein | Maximale Mitarbeiterzahl |
+| `staffCountMin` | number | Nein | Minimale Mitarbeiterzahl |
+| `staffCountMax` | number | Nein | Maximale Mitarbeiterzahl |
+| `currentPage` | number | Nein | Seitennummer \(Standard: 1\) |
+| `pageSize` | number | Nein | Ergebnisse pro Seite \(Standard: 20\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `currentPage` | number | Aktuelle Seitennummer |
+| `totalPage` | number | Gesamtanzahl der Seiten |
+| `pageSize` | number | Ergebnisse pro Seite |
+| `companies` | array | Suchergebnisse |
+|   ↳ `companyName` | string | Firmenname |
+|   ↳ `tagline` | string | Firmen-Slogan |
+|   ↳ `webAddress` | string | Website-URL |
+|   ↳ `industries` | array | Branchen |
+|   ↳ `teamSize` | number | Teamgröße |
+|   ↳ `linkedInProfile` | string | LinkedIn-URL |
+
+### `enrich_search_company_employees`
+
+Suche nach Mitarbeitern in bestimmten Unternehmen nach Standort und Berufsbezeichnung.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `companyIds` | json | Nein | Array von Firmen-IDs, in denen gesucht werden soll |
+| `country` | string | Nein | Länderfilter \(z. B. Vereinigte Staaten\) |
+| `city` | string | Nein | Stadtfilter \(z. B. San Francisco\) |
+| `state` | string | Nein | Bundesland-Filter \(z. B. Kalifornien\) |
+| `jobTitles` | json | Nein | Berufsbezeichnungen zum Filtern \(Array\) |
+| `page` | number | Nein | Seitennummer \(Standard: 1\) |
+| `pageSize` | number | Nein | Ergebnisse pro Seite \(Standard: 10\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `currentPage` | number | Aktuelle Seitennummer |
+| `totalPage` | number | Gesamtanzahl der Seiten |
+| `pageSize` | number | Anzahl der Ergebnisse pro Seite |
+| `profiles` | array | Mitarbeiterprofile |
+|   ↳ `profileIdentifier` | string | Profil-ID |
+|   ↳ `givenName` | string | Vorname |
+|   ↳ `familyName` | string | Nachname |
+|   ↳ `currentPosition` | string | Aktuelle Berufsbezeichnung |
+|   ↳ `profileImage` | string | Profilbild-URL |
+|   ↳ `externalProfileUrl` | string | LinkedIn-URL |
+|   ↳ `city` | string | Stadt |
+|   ↳ `country` | string | Land |
+|   ↳ `expertSkills` | array | Fähigkeiten |
+
+### `enrich_search_similar_companies`
+
+Finden Sie Unternehmen, die einem bestimmten Unternehmen ähnlich sind, anhand der LinkedIn-URL mit Filtern für Standort und Größe.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `url` | string | Ja | LinkedIn-Unternehmens-URL \(z. B. linkedin.com/company/google\) |
+| `accountLocation` | json | Nein | Nach Standorten filtern \(Array von Ländernamen\) |
+| `employeeSizeType` | string | Nein | Filtertyp für Mitarbeiterzahl \(z. B. RANGE\) |
+| `employeeSizeRange` | json | Nein | Bereiche der Mitarbeiterzahl \(Array von \{start, end\}-Objekten\) |
+| `page` | number | Nein | Seitennummer \(Standard: 1\) |
+| `num` | number | Nein | Anzahl der Ergebnisse pro Seite |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `companies` | array | Ähnliche Unternehmen |
+|   ↳ `url` | string | LinkedIn-URL |
+|   ↳ `name` | string | Unternehmensname |
+|   ↳ `universalName` | string | Universeller Name |
+|   ↳ `type` | string | Unternehmenstyp |
+|   ↳ `description` | string | Beschreibung |
+|   ↳ `phone` | string | Telefonnummer |
+|   ↳ `website` | string | Website-URL |
+|   ↳ `logo` | string | Logo-URL |
+|   ↳ `foundedYear` | number | Gründungsjahr |
+|   ↳ `staffTotal` | number | Gesamtzahl der Mitarbeiter |
+|   ↳ `industries` | array | Branchen |
+|   ↳ `relevancyScore` | number | Relevanzbewertung |
+|   ↳ `relevancyValue` | string | Relevanzwert |
+
+### `enrich_sales_pointer_people`
+
+Erweiterte Personensuche mit komplexen Filtern für Standort, Unternehmensgröße, Seniorität, Erfahrung und mehr.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `page` | number | Ja | Seitennummer \(beginnt bei 1\) |
+| `filters` | json | Ja | Array von Filterobjekten. Jeder Filter hat einen Typ \(z. B. POSTAL_CODE, COMPANY_HEADCOUNT\), Werte \(Array mit id, text, selectionType: INCLUDED/EXCLUDED\) und optional selectedSubFilter |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `data` | array | Personenergebnisse |
+|   ↳ `name` | string | Vollständiger Name |
+|   ↳ `summary` | string | Berufliche Zusammenfassung |
+|   ↳ `location` | string | Standort |
+|   ↳ `profilePicture` | string | Profilbild-URL |
+|   ↳ `linkedInUrn` | string | LinkedIn-URN |
+|   ↳ `positions` | array | Berufspositionen |
+|   ↳ `education` | array | Ausbildung |
+| `pagination` | json | Paginierungsinformationen |
+|   ↳ `totalCount` | number | Gesamtergebnisse |
+|   ↳ `returnedCount` | number | Zurückgegebene Anzahl |
+|   ↳ `start` | number | Startposition |
+|   ↳ `limit` | number | Limit |
+
+### `enrich_search_posts`
+
+Durchsuchen Sie LinkedIn-Beiträge nach Schlüsselwörtern mit Datumsfilterung.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `keywords` | string | Ja | Suchbegriffe \(z. B. "KI-Automatisierung"\) |
+| `datePosted` | string | Nein | Zeitfilter \(z. B. past_week, past_month\) |
+| `page` | number | Nein | Seitennummer \(Standard: 1\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `count` | number | Gesamtanzahl der Ergebnisse |
+| `posts` | array | Suchergebnisse |
+|   ↳ `url` | string | Beitrags-URL |
+|   ↳ `postId` | string | Beitrags-ID |
+|   ↳ `author` | object | Autoreninformationen |
+|     ↳ `name` | string | Autorenname |
+|     ↳ `headline` | string | Autoren-Headline |
+|     ↳ `linkedInUrl` | string | LinkedIn-URL des Autors |
+|     ↳ `profileImage` | string | Profilbild des Autors |
+|   ↳ `timestamp` | string | Zeitstempel des Beitrags |
+|   ↳ `textContent` | string | Textinhalt des Beitrags |
+|   ↳ `hashtags` | array | Hashtags |
+|   ↳ `mediaUrls` | array | Medien-URLs |
+|   ↳ `reactions` | number | Anzahl der Reaktionen |
+|   ↳ `commentsCount` | number | Anzahl der Kommentare |
+
+### `enrich_get_post_details`
+
+Detaillierte Informationen zu einem LinkedIn-Beitrag anhand der URL abrufen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `url` | string | Ja | LinkedIn-Beitrags-URL |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `postId` | string | Beitrags-ID |
+| `author` | json | Autoreninformationen |
+|   ↳ `name` | string | Autorenname |
+|   ↳ `headline` | string | Autoren-Headline |
+|   ↳ `linkedInUrl` | string | LinkedIn-URL des Autors |
+|   ↳ `profileImage` | string | Profilbild des Autors |
+| `timestamp` | string | Zeitstempel des Beitrags |
+| `textContent` | string | Textinhalt des Beitrags |
+| `hashtags` | array | Hashtags |
+| `mediaUrls` | array | Medien-URLs |
+| `reactions` | number | Anzahl der Reaktionen |
+| `commentsCount` | number | Anzahl der Kommentare |
+
+### `enrich_search_post_reactions`
+
+Reaktionen auf einen LinkedIn-Beitrag mit Filterung nach Reaktionstyp abrufen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `postUrn` | string | Ja | LinkedIn-Aktivitäts-URN \(z. B. urn:li:activity:7231931952839196672\) |
+| `reactionType` | string | Ja | Reaktionstyp-Filter: all, like, love, celebrate, insightful oder funny \(Standard: all\) |
+| `page` | number | Ja | Seitennummer \(beginnt bei 1\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `page` | number | Aktuelle Seitennummer |
+| `totalPage` | number | Gesamtanzahl der Seiten |
+| `count` | number | Anzahl der zurückgegebenen Reaktionen |
+| `reactions` | array | Reaktionen |
+|   ↳ `reactionType` | string | Art der Reaktion |
+|   ↳ `reactor` | object | Person, die reagiert hat |
+|     ↳ `name` | string | Name |
+|     ↳ `subTitle` | string | Berufsbezeichnung |
+|     ↳ `profileId` | string | Profil-ID |
+|     ↳ `profilePicture` | string | Profilbild-URL |
+|     ↳ `linkedInUrl` | string | LinkedIn-URL |
+
+### `enrich_search_post_comments`
+
+Kommentare zu einem LinkedIn-Beitrag abrufen.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `postUrn` | string | Ja | LinkedIn-Aktivitäts-URN \(z. B. urn:li:activity:7191163324208705536\) |
+| `page` | number | Nein | Seitennummer \(beginnt bei 1, Standard: 1\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `page` | number | Aktuelle Seitennummer |
+| `totalPage` | number | Gesamtanzahl der Seiten |
+| `count` | number | Anzahl der zurückgegebenen Kommentare |
+| `comments` | array | Kommentare |
+|   ↳ `activityId` | string | Kommentar-Aktivitäts-ID |
+|   ↳ `commentary` | string | Kommentartext |
+|   ↳ `linkedInUrl` | string | Link zum Kommentar |
+|   ↳ `commenter` | object | Informationen zum Kommentator |
+|     ↳ `profileId` | string | Profil-ID |
+|     ↳ `firstName` | string | Vorname |
+|     ↳ `lastName` | string | Nachname |
+|     ↳ `subTitle` | string | Untertitel/Überschrift |
+|     ↳ `profilePicture` | string | Profilbild-URL |
+|     ↳ `backgroundImage` | string | Hintergrundbild-URL |
+|     ↳ `entityUrn` | string | Entity-URN |
+|     ↳ `objectUrn` | string | Objekt-URN |
+|     ↳ `profileType` | string | Profiltyp |
+|   ↳ `reactionBreakdown` | object | Reaktionen auf den Kommentar |
+|     ↳ `likes` | number | Anzahl der Likes |
+|     ↳ `empathy` | number | Anzahl der Empathie-Reaktionen |
+|     ↳ `other` | number | Anzahl der sonstigen Reaktionen |
+
+### `enrich_search_people_activities`
+
+Person abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `profileId` | string | Ja | LinkedIn-Profil-ID |
+| `activityType` | string | Ja | Aktivitätstyp: posts, comments oder articles |
+| `paginationToken` | string | Nein | Paginierungs-Token für die nächste Ergebnisseite |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `paginationToken` | string | Token zum Abrufen der nächsten Seite |
+| `activityType` | string | Typ der zurückgegebenen Aktivitäten |
+| `activities` | array | Aktivitäten |
+|   ↳ `activityId` | string | Aktivitäts-ID |
+|   ↳ `commentary` | string | Textinhalt der Aktivität |
+|   ↳ `linkedInUrl` | string | Link zur Aktivität |
+|   ↳ `timeElapsed` | string | Verstrichene Zeit seit der Aktivität |
+|   ↳ `numReactions` | number | Gesamtanzahl der Reaktionen |
+|   ↳ `author` | object | Informationen zum Autor der Aktivität |
+|     ↳ `name` | string | Name des Autors |
+|     ↳ `profileId` | string | Profil-ID |
+|     ↳ `profilePicture` | string | URL des Profilbilds |
+|   ↳ `reactionBreakdown` | object | Reaktionen |
+|     ↳ `likes` | number | Likes |
+|     ↳ `empathy` | number | Empathie-Reaktionen |
+|     ↳ `other` | number | Sonstige Reaktionen |
+|   ↳ `attachments` | array | Anhang-URLs |
+
+### `enrich_search_company_activities`
+
+Unternehmen abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `companyId` | string | Ja | LinkedIn-Unternehmens-ID |
+| `activityType` | string | Ja | Aktivitätstyp: Posts, Kommentare oder Artikel |
+| `paginationToken` | string | Nein | Paginierungs-Token für die nächste Ergebnisseite |
+| `offset` | number | Nein | Anzahl der zu überspringenden Datensätze \(Standard: 0\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `paginationToken` | string | Token zum Abrufen der nächsten Seite |
+| `activityType` | string | Typ der zurückgegebenen Aktivitäten |
+| `activities` | array | Aktivitäten |
+|   ↳ `activityId` | string | Aktivitäts-ID |
+|   ↳ `commentary` | string | Textinhalt der Aktivität |
+|   ↳ `linkedInUrl` | string | Link zur Aktivität |
+|   ↳ `timeElapsed` | string | Verstrichene Zeit seit der Aktivität |
+|   ↳ `numReactions` | number | Gesamtanzahl der Reaktionen |
+|   ↳ `author` | object | Informationen zum Autor der Aktivität |
+|     ↳ `name` | string | Name des Autors |
+|     ↳ `profileId` | string | Profil-ID |
+|     ↳ `profilePicture` | string | URL des Profilbilds |
+|   ↳ `reactionBreakdown` | object | Reaktionen |
+|     ↳ `likes` | number | Likes |
+|     ↳ `empathy` | number | Empathie-Reaktionen |
+|     ↳ `other` | number | Sonstige Reaktionen |
+|   ↳ `attachments` | array | Anhänge |
+
+### `enrich_reverse_hash_lookup`
+
+Wandelt einen MD5-E-Mail-Hash zurück in die ursprüngliche E-Mail-Adresse und den Anzeigenamen um.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich-API-Schlüssel |
+| `hash` | string | Ja | MD5-Hash-Wert zum Nachschlagen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `hash` | string | MD5-Hash, der nachgeschlagen wurde |
+| `email` | string | Ursprüngliche E-Mail-Adresse |
+| `displayName` | string | Anzeigename, der mit der E-Mail verknüpft ist |
+| `found` | boolean | Ob eine E-Mail für den Hash gefunden wurde |
+
+### `enrich_search_logo`
+
+Ruft die URL eines Firmenlogos anhand der Domain ab.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Enrich API-Schlüssel |
+| `url` | string | Ja | Firmendomain \(z. B. google.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `logoUrl` | string | URL zum Abrufen des Firmenlogos |
+| `domain` | string | Domain, die nachgeschlagen wurde |

apps/docs/content/docs/de/tools/exa.mdx

@@ -143,8 +143,3 @@ Führe umfassende Recherchen mit KI durch, um detaillierte Berichte mit Quellena
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `research` | array | Umfassende Forschungsergebnisse mit Quellenangaben und Zusammenfassungen |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `exa`

apps/docs/content/docs/de/tools/file.mdx

@@ -47,8 +47,3 @@ Parsen einer oder mehrerer hochgeladener Dateien oder Dateien von URLs (Text, PD
 | --------- | ---- | ----------- |
 | `files` | array | Array der geparsten Dateien |
 | `combinedContent` | string | Kombinierter Inhalt aller geparsten Dateien |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `file`

apps/docs/content/docs/de/tools/firecrawl.mdx

@@ -171,8 +171,3 @@ Autonomer Web-Datenextraktions-Agent. Sucht und sammelt Informationen basierend
 | `creditsUsed` | number | Anzahl der von dieser Agent-Aufgabe verbrauchten Credits |
 | `expiresAt` | string | Zeitstempel, wann die Ergebnisse ablaufen \(24 Stunden\) |
 | `sources` | object | Array der vom Agent verwendeten Quell-URLs |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `firecrawl`

apps/docs/content/docs/de/tools/fireflies.mdx

@@ -226,8 +226,3 @@ Alle Kontakte aus Ihren Fireflies.ai-Meetings auflisten
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `contacts` | array | Liste der Kontakte aus Meetings |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `fireflies`

apps/docs/content/docs/de/tools/gitlab.mdx

@@ -422,8 +422,3 @@ Eine laufende GitLab-Pipeline abbrechen
 | Parameter | Typ | Beschreibung |
 | --------- | ---- | ----------- |
 | `pipeline` | object | Die abgebrochene GitLab-Pipeline |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `gitlab`

apps/docs/content/docs/de/tools/gmail.mdx

@@ -264,13 +264,3 @@ Label(s) von einer Gmail-Nachricht entfernen
 | `labelIds` | string | Ja | Durch Kommas getrennte Label-IDs zum Entfernen \(z.B. INBOX, Label_123\) |
 
 #### Ausgabe
-
-| Parameter | Typ | Beschreibung |
-| --------- | ---- | ----------- |
-| `content` | string | Erfolgsmeldung |
-| `metadata` | object | E-Mail-Metadaten |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `gmail`

apps/docs/content/docs/de/tools/google_books.mdx

@@ -0,0 +1,92 @@
+---
+title: Google Books
+description: Buchinformationen suchen und abrufen
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="google_books"
+  color="#FFFFFF"
+/>
+
+## Nutzungsanleitung
+
+Suchen Sie nach Büchern über die Google Books API. Finden Sie Bände nach Titel, Autor, ISBN oder Stichwörtern und rufen Sie detaillierte Informationen zu bestimmten Büchern ab, einschließlich Beschreibungen, Bewertungen und Veröffentlichungsdetails.
+
+## Tools
+
+### `google_books_volume_search`
+
+Suchen Sie nach Büchern über die Google Books API
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Google Books API-Schlüssel |
+| `query` | string | Ja | Suchanfrage. Unterstützt spezielle Schlüsselwörter: intitle:, inauthor:, inpublisher:, subject:, isbn: |
+| `filter` | string | Nein | Ergebnisse nach Verfügbarkeit filtern \(partial, full, free-ebooks, paid-ebooks, ebooks\) |
+| `printType` | string | Nein | Auf Drucktyp beschränken \(all, books, magazines\) |
+| `orderBy` | string | Nein | Sortierreihenfolge \(relevance, newest\) |
+| `startIndex` | number | Nein | Index des ersten zurückzugebenden Ergebnisses \(für Paginierung\) |
+| `maxResults` | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse \(1-40\) |
+| `langRestrict` | string | Nein | Ergebnisse auf eine bestimmte Sprache beschränken \(ISO 639-1-Code\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `totalItems` | number | Gesamtanzahl der übereinstimmenden Ergebnisse |
+| `volumes` | array | Liste der übereinstimmenden Bände |
+|   ↳ `id` | string | Band-ID |
+|   ↳ `title` | string | Buchtitel |
+|   ↳ `subtitle` | string | Buchuntertitel |
+|   ↳ `authors` | array | Liste der Autoren |
+|   ↳ `publisher` | string | Verlagsname |
+|   ↳ `publishedDate` | string | Veröffentlichungsdatum |
+|   ↳ `description` | string | Buchbeschreibung |
+|   ↳ `pageCount` | number | Anzahl der Seiten |
+|   ↳ `categories` | array | Buchkategorien |
+|   ↳ `averageRating` | number | Durchschnittliche Bewertung \(1-5\) |
+|   ↳ `ratingsCount` | number | Anzahl der Bewertungen |
+|   ↳ `language` | string | Sprachcode |
+|   ↳ `previewLink` | string | Link zur Vorschau auf Google Books |
+|   ↳ `infoLink` | string | Link zur Infoseite |
+|   ↳ `thumbnailUrl` | string | URL des Buchcover-Thumbnails |
+|   ↳ `isbn10` | string | ISBN-10-Kennung |
+|   ↳ `isbn13` | string | ISBN-13-Kennung |
+
+### `google_books_volume_details`
+
+Detaillierte Informationen über ein bestimmtes Buchvolumen abrufen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `apiKey` | string | Ja | Google Books API-Schlüssel |
+| `volumeId` | string | Ja | Die ID des abzurufenden Volumens |
+| `projection` | string | Nein | Projektionsebene \(full, lite\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Volumen-ID |
+| `title` | string | Buchtitel |
+| `subtitle` | string | Buchuntertitel |
+| `authors` | array | Liste der Autoren |
+| `publisher` | string | Verlagsname |
+| `publishedDate` | string | Veröffentlichungsdatum |
+| `description` | string | Buchbeschreibung |
+| `pageCount` | number | Anzahl der Seiten |
+| `categories` | array | Buchkategorien |
+| `averageRating` | number | Durchschnittliche Bewertung \(1-5\) |
+| `ratingsCount` | number | Anzahl der Bewertungen |
+| `language` | string | Sprachcode |
+| `previewLink` | string | Link zur Vorschau auf Google Books |
+| `infoLink` | string | Link zur Infoseite |
+| `thumbnailUrl` | string | URL des Buchcover-Thumbnails |
+| `isbn10` | string | ISBN-10-Kennung |
+| `isbn13` | string | ISBN-13-Kennung |

apps/docs/content/docs/de/tools/google_calendar.mdx

@@ -139,3 +139,145 @@ Teilnehmer zu einem bestehenden Google Kalender-Ereignis einladen
 
 - Kategorie: `tools`
 - Typ: `google_calendar`
+
+Ein Ereignis in einen anderen Kalender verschieben. Gibt nur API-konforme Felder zurück.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `calendarId` | string | Nein | Quell-Google-Kalender-ID (z. B. primary oder calendar@group.calendar.google.com) |
+| `eventId` | string | Ja | Google-Kalender-Ereignis-ID, die verschoben werden soll |
+| `destinationCalendarId` | string | Ja | Ziel-Google-Kalender-ID |
+| `sendUpdates` | string | Nein | Wie Updates an Teilnehmer gesendet werden: all, externalOnly oder none |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Ereignis-ID |
+| `htmlLink` | string | Ereignis-Link |
+| `status` | string | Ereignisstatus |
+| `summary` | string | Ereignistitel |
+| `description` | string | Ereignisbeschreibung |
+| `location` | string | Ereignisort |
+| `start` | json | Ereignisstart |
+| `end` | json | Ereignisende |
+| `attendees` | json | Ereignisteilnehmer |
+| `creator` | json | Ereignisersteller |
+| `organizer` | json | Ereignisorganisator |
+
+### `google_calendar_instances`
+
+Instanzen eines wiederkehrenden Ereignisses aus Google Kalender abrufen. Gibt nur API-konforme Felder zurück.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `calendarId` | string | Nein | Google-Kalender-ID (z. B. primary oder calendar@group.calendar.google.com) |
+| `eventId` | string | Ja | ID des wiederkehrenden Ereignisses, dessen Instanzen abgerufen werden sollen |
+| `timeMin` | string | Nein | Untere Grenze für Instanzen (RFC3339-Zeitstempel, z. B. 2025-06-03T00:00:00Z) |
+| `timeMax` | string | Nein | Obere Grenze für Instanzen (RFC3339-Zeitstempel, z. B. 2025-06-04T00:00:00Z) |
+| `maxResults` | number | Nein | Maximale Anzahl der zurückzugebenden Instanzen (Standard 250, max. 2500) |
+| `pageToken` | string | Nein | Token zum Abrufen nachfolgender Ergebnisseiten |
+| `showDeleted` | boolean | Nein | Gelöschte Instanzen einschließen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `nextPageToken` | string | Nächstes Seiten-Token |
+| `timeZone` | string | Kalender-Zeitzone |
+| `instances` | json | Liste der wiederkehrenden Ereignisinstanzen |
+
+### `google_calendar_list_calendars`
+
+Alle Kalender des Benutzers auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `minAccessRole` | string | Nein | Minimale Zugriffsrolle für zurückgegebene Kalender: freeBusyReader, reader, writer oder owner |
+| `maxResults` | number | Nein | Maximale Anzahl der zurückzugebenden Kalender (Standard 100, max. 250) |
+| `pageToken` | string | Nein | Token zum Abrufen nachfolgender Ergebnisseiten |
+| `showDeleted` | boolean | Nein | Gelöschte Kalender einschließen |
+| `showHidden` | boolean | Nein | Ausgeblendete Kalender einschließen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `nextPageToken` | string | Nächstes Seiten-Token |
+| `calendars` | array | Liste der Kalender |
+|   ↳ `id` | string | Kalender-ID |
+|   ↳ `summary` | string | Kalendertitel |
+|   ↳ `description` | string | Kalenderbeschreibung |
+|   ↳ `location` | string | Kalenderort |
+|   ↳ `timeZone` | string | Kalender-Zeitzone |
+|   ↳ `accessRole` | string | Zugriffsrolle für den Kalender |
+|   ↳ `backgroundColor` | string | Kalender-Hintergrundfarbe |
+|   ↳ `foregroundColor` | string | Kalender-Vordergrundfarbe |
+|   ↳ `primary` | boolean | Ob dies der Hauptkalender ist |
+|   ↳ `hidden` | boolean | Ob der Kalender ausgeblendet ist |
+|   ↳ `selected` | boolean | Ob der Kalender ausgewählt ist |
+
+### `google_calendar_quick_add`
+
+Ereignisse aus natürlichsprachlichem Text erstellen. Gibt nur API-konforme Felder zurück.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `calendarId` | string | Nein | Google Kalender-ID (z. B. primary oder calendar@group.calendar.google.com) |
+| `text` | string | Ja | Natürlichsprachlicher Text, der das Ereignis beschreibt (z. B. "Meeting mit John morgen um 15 Uhr") |
+| `attendees` | array | Nein | Array von E-Mail-Adressen der Teilnehmer (kommagetrennte Zeichenkette wird ebenfalls akzeptiert) |
+| `sendUpdates` | string | Nein | Wie Updates an Teilnehmer gesendet werden: all, externalOnly oder none |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Ereignis-ID |
+| `htmlLink` | string | Ereignis-Link |
+| `status` | string | Ereignisstatus |
+| `summary` | string | Ereignistitel |
+| `description` | string | Ereignisbeschreibung |
+| `location` | string | Ereignisort |
+| `start` | json | Ereignisstart |
+| `end` | json | Ereignisende |
+| `attendees` | json | Ereignisteilnehmer |
+| `creator` | json | Ereignisersteller |
+| `organizer` | json | Ereignisorganisator |
+
+### `google_calendar_invite`
+
+Teilnehmer zu einem bestehenden Google Kalender-Ereignis einladen. Gibt nur API-konforme Felder zurück.
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `calendarId` | string | Nein | Google Kalender-ID (z. B. primary oder calendar@group.calendar.google.com) |
+| `eventId` | string | Ja | Google Kalender-Ereignis-ID, zu der Teilnehmer eingeladen werden sollen |
+| `attendees` | array | Ja | Array von E-Mail-Adressen der einzuladenden Teilnehmer |
+| `sendUpdates` | string | Nein | Wie Updates an Teilnehmer gesendet werden: all, externalOnly oder none |
+| `replaceExisting` | boolean | Nein | Ob bestehende Teilnehmer ersetzt oder hinzugefügt werden sollen (Standard ist false) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Ereignis-ID |
+| `htmlLink` | string | Ereignis-Link |
+| `status` | string | Ereignisstatus |
+| `summary` | string | Ereignistitel |
+| `description` | string | Ereignisbeschreibung |
+| `location` | string | Ereignisort |
+| `start` | json | Ereignisbeginn |
+| `end` | json | Ereignisende |
+| `attendees` | json | Ereignisteilnehmer |
+| `creator` | json | Ereignisersteller |
+| `organizer` | json | Ereignisorganisator |

apps/docs/content/docs/de/tools/google_docs.mdx

@@ -102,27 +102,3 @@ Inhalte in einem Google Docs-Dokument schreiben oder aktualisieren
 | --------- | ---- | ----------- |
 | `updatedContent` | boolean | Gibt an, ob der Dokumentinhalt erfolgreich aktualisiert wurde |
 | `metadata` | json | Aktualisierte Dokument-Metadaten einschließlich ID, Titel und URL |
-
-### `google_docs_create`
-
-Ein neues Google Docs-Dokument erstellen
-
-#### Eingabe
-
-| Parameter | Typ | Erforderlich | Beschreibung |
-| --------- | ---- | -------- | ----------- |
-| `title` | string | Ja | Der Titel des zu erstellenden Dokuments |
-| `content` | string | Nein | Der Inhalt des zu erstellenden Dokuments |
-| `folderSelector` | string | Nein | Wählen Sie den Ordner aus, in dem das Dokument erstellt werden soll |
-| `folderId` | string | Nein | Die ID des Ordners, in dem das Dokument erstellt werden soll \(interne Verwendung\) |
-
-#### Ausgabe
-
-| Parameter | Typ | Beschreibung |
-| --------- | ---- | ----------- |
-| `metadata` | json | Metadaten des erstellten Dokuments einschließlich ID, Titel und URL |
-
-## Hinweise
-
-- Kategorie: `tools`
-- Typ: `google_docs`

apps/docs/content/docs/de/tools/google_drive.mdx

@@ -124,3 +124,270 @@ Dateien und Ordner in Google Drive auflisten
 
 - Kategorie: `tools`
 - Typ: `google_drive`
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `file` | file | Heruntergeladene Datei, gespeichert in Ausführungsdateien |
+| `metadata` | object | Vollständige Dateimetadaten von Google Drive |
+|   ↳ `id` | string | Google Drive-Datei-ID |
+|   ↳ `kind` | string | Ressourcentyp-Kennung |
+|   ↳ `name` | string | Dateiname |
+|   ↳ `mimeType` | string | MIME-Typ |
+|   ↳ `description` | string | Dateibeschreibung |
+|   ↳ `originalFilename` | string | Original hochgeladener Dateiname |
+|   ↳ `fullFileExtension` | string | Vollständige Dateierweiterung |
+|   ↳ `fileExtension` | string | Dateierweiterung |
+|   ↳ `owners` | json | Liste der Dateieigentümer |
+|   ↳ `permissions` | json | Dateiberechtigungen |
+|   ↳ `permissionIds` | json | Berechtigungs-IDs |
+|   ↳ `shared` | boolean | Ob Datei geteilt ist |
+|   ↳ `ownedByMe` | boolean | Ob im Besitz des aktuellen Benutzers |
+|   ↳ `writersCanShare` | boolean | Ob Autoren teilen können |
+|   ↳ `viewersCanCopyContent` | boolean | Ob Betrachter kopieren können |
+|   ↳ `copyRequiresWriterPermission` | boolean | Ob Kopieren Autorenberechtigung erfordert |
+|   ↳ `sharingUser` | json | Benutzer, der die Datei geteilt hat |
+|   ↳ `starred` | boolean | Ob Datei mit Stern markiert ist |
+|   ↳ `trashed` | boolean | Ob Datei im Papierkorb ist |
+|   ↳ `explicitlyTrashed` | boolean | Ob explizit in Papierkorb verschoben |
+|   ↳ `appProperties` | json | App-spezifische Eigenschaften |
+|   ↳ `createdTime` | string | Dateierstellungszeit |
+|   ↳ `modifiedTime` | string | Letzte Änderungszeit |
+|   ↳ `modifiedByMeTime` | string | Wann vom aktuellen Benutzer geändert |
+|   ↳ `viewedByMeTime` | string | Wann zuletzt vom aktuellen Benutzer angesehen |
+|   ↳ `sharedWithMeTime` | string | Wann mit aktuellem Benutzer geteilt |
+|   ↳ `lastModifyingUser` | json | Benutzer, der die Datei zuletzt geändert hat |
+|   ↳ `viewedByMe` | boolean | Ob vom aktuellen Benutzer angesehen |
+|   ↳ `modifiedByMe` | boolean | Ob vom aktuellen Benutzer geändert |
+|   ↳ `webViewLink` | string | URL zum Anzeigen im Browser |
+|   ↳ `webContentLink` | string | Direkte Download-URL |
+|   ↳ `iconLink` | string | URL zum Dateisymbol |
+|   ↳ `thumbnailLink` | string | URL zum Vorschaubild |
+|   ↳ `exportLinks` | json | Exportformat-Links |
+|   ↳ `size` | string | Dateigröße in Bytes |
+|   ↳ `quotaBytesUsed` | string | Verwendetes Speicherkontingent |
+|   ↳ `md5Checksum` | string | MD5-Hash |
+|   ↳ `sha1Checksum` | string | SHA-1-Hash |
+|   ↳ `sha256Checksum` | string | SHA-256-Hash |
+|   ↳ `parents` | json | Übergeordnete Ordner-IDs |
+|   ↳ `spaces` | json | Bereiche, die Datei enthalten |
+|   ↳ `driveId` | string | Geteilte Laufwerk-ID |
+|   ↳ `capabilities` | json | Benutzerfähigkeiten für Datei |
+|   ↳ `version` | string | Versionsnummer |
+|   ↳ `headRevisionId` | string | Hauptrevisions-ID |
+|   ↳ `hasThumbnail` | boolean | Ob Vorschaubild vorhanden |
+|   ↳ `thumbnailVersion` | string | Vorschaubild-Version |
+|   ↳ `imageMediaMetadata` | json | Bildspezifische Metadaten |
+|   ↳ `videoMediaMetadata` | json | Videospezifische Metadaten |
+|   ↳ `isAppAuthorized` | boolean | Ob von anfragender App erstellt |
+|   ↳ `contentRestrictions` | json | Inhaltsbeschränkungen |
+|   ↳ `linkShareMetadata` | json | Link-Freigabe-Metadaten |
+|   ↳ `revisions` | json | Dateirevisionshistorie \(nur erste 100 Revisionen\) |
+
+### `google_drive_copy`
+
+Erstellen Sie eine Kopie einer Datei in Google Drive
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der zu kopierenden Datei |
+| `newName` | string | Nein | Name für die kopierte Datei (Standard: "Kopie von [ursprünglicher Name]") |
+| `destinationFolderId` | string | Nein | ID des Ordners, in dem die Kopie abgelegt werden soll (Standard: gleicher Speicherort wie das Original) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `file` | json | Die Metadaten der kopierten Datei |
+|   ↳ `id` | string | Google Drive-Datei-ID der Kopie |
+|   ↳ `kind` | string | Ressourcentyp-Kennung |
+|   ↳ `name` | string | Dateiname |
+|   ↳ `mimeType` | string | MIME-Typ |
+|   ↳ `webViewLink` | string | URL zum Anzeigen im Browser |
+|   ↳ `parents` | json | IDs der übergeordneten Ordner |
+|   ↳ `createdTime` | string | Erstellungszeit der Datei |
+|   ↳ `modifiedTime` | string | Zeitpunkt der letzten Änderung |
+|   ↳ `owners` | json | Liste der Dateieigentümer |
+|   ↳ `size` | string | Dateigröße in Bytes |
+
+### `google_drive_update`
+
+Aktualisieren Sie Dateimetadaten in Google Drive (umbenennen, verschieben, mit Stern markieren, Beschreibung hinzufügen)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der zu aktualisierenden Datei |
+| `name` | string | Nein | Neuer Name für die Datei |
+| `description` | string | Nein | Neue Beschreibung für die Datei |
+| `addParents` | string | Nein | Durch Kommas getrennte Liste von IDs übergeordneter Ordner, die hinzugefügt werden sollen (verschiebt die Datei in diese Ordner) |
+| `removeParents` | string | Nein | Durch Kommas getrennte Liste von IDs übergeordneter Ordner, die entfernt werden sollen |
+| `starred` | boolean | Nein | Ob die Datei mit einem Stern markiert oder die Markierung entfernt werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `file` | json | Die aktualisierten Dateimetadaten |
+|   ↳ `id` | string | Google Drive-Datei-ID |
+|   ↳ `kind` | string | Ressourcentyp-Kennung |
+|   ↳ `name` | string | Dateiname |
+|   ↳ `mimeType` | string | MIME-Typ |
+|   ↳ `description` | string | Dateibeschreibung |
+|   ↳ `starred` | boolean | Ob die Datei mit Stern markiert ist |
+|   ↳ `webViewLink` | string | URL zum Anzeigen im Browser |
+|   ↳ `parents` | json | IDs der übergeordneten Ordner |
+|   ↳ `modifiedTime` | string | Zeitpunkt der letzten Änderung |
+
+### `google_drive_trash`
+
+Eine Datei in den Papierkorb von Google Drive verschieben (kann später wiederhergestellt werden)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der Datei, die in den Papierkorb verschoben werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `file` | json | Die Metadaten der gelöschten Datei |
+|   ↳ `id` | string | Google Drive-Datei-ID |
+|   ↳ `kind` | string | Ressourcentyp-Kennung |
+|   ↳ `name` | string | Dateiname |
+|   ↳ `mimeType` | string | MIME-Typ |
+|   ↳ `trashed` | boolean | Ob sich die Datei im Papierkorb befindet (sollte true sein) |
+|   ↳ `trashedTime` | string | Zeitpunkt, zu dem die Datei gelöscht wurde |
+|   ↳ `webViewLink` | string | URL zum Anzeigen im Browser |
+
+### `google_drive_delete`
+
+Eine Datei dauerhaft aus Google Drive löschen (umgeht den Papierkorb)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der Datei, die dauerhaft gelöscht werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `deleted` | boolean | Ob die Datei erfolgreich gelöscht wurde |
+| `fileId` | string | Die ID der gelöschten Datei |
+
+### `google_drive_share`
+
+Eine Datei mit einem Benutzer, einer Gruppe, einer Domain teilen oder öffentlich machen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der Datei, die geteilt werden soll |
+| `type` | string | Ja | Art des Empfängers: user, group, domain oder anyone |
+| `role` | string | Ja | Berechtigungsrolle: owner \(Eigentümerschaft übertragen\), organizer \(nur freigegebenes Laufwerk\), fileOrganizer \(nur freigegebenes Laufwerk\), writer \(bearbeiten\), commenter \(ansehen und kommentieren\), reader \(nur ansehen\) |
+| `email` | string | Nein | E-Mail-Adresse des Benutzers oder der Gruppe \(erforderlich für type=user oder type=group\) |
+| `domain` | string | Nein | Domain, mit der geteilt werden soll \(erforderlich für type=domain\) |
+| `transferOwnership` | boolean | Nein | Erforderlich, wenn die Rolle owner ist. Überträgt die Eigentümerschaft an den angegebenen Benutzer. |
+| `moveToNewOwnersRoot` | boolean | Nein | Beim Übertragen der Eigentümerschaft die Datei in den Stammordner von „Meine Ablage" des neuen Eigentümers verschieben. |
+| `sendNotification` | boolean | Nein | Ob eine E-Mail-Benachrichtigung gesendet werden soll \(Standard: true\) |
+| `emailMessage` | string | Nein | Benutzerdefinierte Nachricht, die in die Benachrichtigungs-E-Mail aufgenommen werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `permission` | json | Die Details der erstellten Berechtigung |
+|   ↳ `id` | string | Berechtigungs-ID |
+|   ↳ `type` | string | Empfängertyp \(user, group, domain, anyone\) |
+|   ↳ `role` | string | Berechtigungsrolle |
+|   ↳ `emailAddress` | string | E-Mail des Empfängers |
+|   ↳ `displayName` | string | Anzeigename des Empfängers |
+|   ↳ `domain` | string | Domain des Empfängers |
+|   ↳ `expirationTime` | string | Ablaufzeit |
+|   ↳ `deleted` | boolean | Ob der Empfänger gelöscht wurde |
+
+### `google_drive_unshare`
+
+Eine Berechtigung von einer Datei entfernen (Zugriff widerrufen)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der Datei, deren Berechtigungen geändert werden sollen |
+| `permissionId` | string | Ja | Die ID der zu entfernenden Berechtigung \(verwenden Sie list_permissions, um diese zu finden\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `removed` | boolean | Ob die Berechtigung erfolgreich entfernt wurde |
+| `fileId` | string | Die ID der Datei |
+| `permissionId` | string | Die ID der entfernten Berechtigung |
+
+### `google_drive_list_permissions`
+
+Alle Berechtigungen (wer hat Zugriff) für eine Datei in Google Drive auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `fileId` | string | Ja | Die ID der Datei, für die Berechtigungen aufgelistet werden sollen |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `permissions` | array | Liste der Berechtigungen für die Datei |
+|   ↳ `id` | string | Berechtigungs-ID \(zum Entfernen der Berechtigung verwenden\) |
+|   ↳ `type` | string | Empfängertyp \(user, group, domain, anyone\) |
+|   ↳ `role` | string | Berechtigungsrolle \(owner, organizer, fileOrganizer, writer, commenter, reader\) |
+|   ↳ `emailAddress` | string | E-Mail des Empfängers |
+|   ↳ `displayName` | string | Anzeigename des Empfängers |
+|   ↳ `photoLink` | string | Foto-URL des Empfängers |
+|   ↳ `domain` | string | Domain des Empfängers |
+|   ↳ `expirationTime` | string | Ablaufzeitpunkt der Berechtigung |
+|   ↳ `deleted` | boolean | Ob das Empfängerkonto gelöscht wurde |
+|   ↳ `allowFileDiscovery` | boolean | Ob die Datei vom Empfänger auffindbar ist |
+|   ↳ `pendingOwner` | boolean | Ob eine Eigentumsübertragung aussteht |
+|   ↳ `permissionDetails` | json | Details zu geerbten Berechtigungen |
+| `nextPageToken` | string | Token zum Abrufen der nächsten Seite von Berechtigungen |
+
+### `google_drive_get_about`
+
+Informationen über den Benutzer und sein Google Drive abrufen (Speicherkontingent, Funktionen)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `user` | json | Informationen über den authentifizierten Benutzer |
+|   ↳ `displayName` | string | Anzeigename des Benutzers |
+|   ↳ `emailAddress` | string | E-Mail-Adresse des Benutzers |
+|   ↳ `photoLink` | string | URL zum Profilfoto des Benutzers |
+|   ↳ `permissionId` | string | Berechtigungs-ID des Benutzers |
+|   ↳ `me` | boolean | Ob dies der authentifizierte Benutzer ist |
+| `storageQuota` | json | Informationen zum Speicherkontingent in Bytes |
+|   ↳ `limit` | string | Gesamtes Speicherlimit in Bytes \(null für unbegrenzt\) |
+|   ↳ `usage` | string | Insgesamt verwendeter Speicher in Bytes |
+|   ↳ `usageInDrive` | string | Von Drive-Dateien verwendeter Speicher in Bytes |
+|   ↳ `usageInDriveTrash` | string | Von gelöschten Dateien verwendeter Speicher in Bytes |
+| `canCreateDrives` | boolean | Ob der Benutzer geteilte Ablagen erstellen kann |
+| `importFormats` | json | Zuordnung von MIME-Typen, die importiert werden können, und ihren Zielformaten |
+| `exportFormats` | json | Zuordnung von Google Workspace-MIME-Typen und ihren exportierbaren Formaten |
+| `maxUploadSize` | string | Maximale Upload-Größe in Bytes |

apps/docs/content/docs/de/tools/google_forms.mdx

@@ -52,3 +52,193 @@ Integrieren Sie Google Forms in Ihren Workflow. Geben Sie eine Formular-ID an, u
 
 - Kategorie: `tools`
 - Typ: `google_forms`
+
+Ruft eine Formularstruktur einschließlich ihrer Elemente, Einstellungen und Metadaten ab
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Die ID des abzurufenden Google-Formulars |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `formId` | string | Die Formular-ID |
+| `title` | string | Der für Befragte sichtbare Formulartitel |
+| `description` | string | Die Formularbeschreibung |
+| `documentTitle` | string | Der in Drive sichtbare Dokumenttitel |
+| `responderUri` | string | Die URI zum Teilen mit Befragten |
+| `linkedSheetId` | string | Die ID der verknüpften Google-Tabelle |
+| `revisionId` | string | Die Revisions-ID des Formulars |
+| `items` | array | Die Formularelemente (Fragen, Abschnitte usw.) |
+|   ↳ `itemId` | string | Element-ID |
+|   ↳ `title` | string | Elementtitel |
+|   ↳ `description` | string | Elementbeschreibung |
+| `settings` | json | Formulareinstellungen |
+| `publishSettings` | json | Formularveröffentlichungseinstellungen |
+
+### `google_forms_create_form`
+
+Erstellt ein neues Google-Formular mit einem Titel
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `title` | string | Ja | Der für Befragte sichtbare Titel des Formulars |
+| `documentTitle` | string | Nein | Der in Drive sichtbare Dokumenttitel (standardmäßig der Formulartitel) |
+| `unpublished` | boolean | Nein | Falls true, wird ein unveröffentlichtes Formular erstellt, das keine Antworten akzeptiert |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `formId` | string | Die ID des erstellten Formulars |
+| `title` | string | Der Formulartitel |
+| `documentTitle` | string | Der Dokumenttitel in Drive |
+| `responderUri` | string | Die URI zum Teilen mit Befragten |
+| `revisionId` | string | Die Revisions-ID des Formulars |
+
+### `google_forms_batch_update`
+
+Mehrere Aktualisierungen auf ein Formular anwenden (Elemente hinzufügen, Informationen aktualisieren, Einstellungen ändern usw.)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID |
+| `requests` | json | Ja | Array von Aktualisierungsanfragen (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem) |
+| `includeFormInResponse` | boolean | Nein | Ob das aktualisierte Formular in der Antwort zurückgegeben werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `replies` | array | Die Antworten von jeder Aktualisierungsanfrage |
+| `writeControl` | object | Schreibsteuerungsinformationen mit Revisions-IDs |
+|   ↳ `requiredRevisionId` | string | Erforderliche Revisions-ID zur Konflikterkennung |
+|   ↳ `targetRevisionId` | string | Ziel-Revisions-ID |
+| `form` | object | Das aktualisierte Formular (falls includeFormInResponse true war) |
+|   ↳ `formId` | string | Die Formular-ID |
+|   ↳ `info` | object | Formularinformationen mit Titel und Beschreibung |
+|     ↳ `title` | string | Der für Befragte sichtbare Formulartitel |
+|     ↳ `description` | string | Die Formularbeschreibung |
+|     ↳ `documentTitle` | string | Der in Drive sichtbare Dokumenttitel |
+|   ↳ `settings` | object | Formulareinstellungen |
+|     ↳ `quizSettings` | object | Quiz-Einstellungen |
+|       ↳ `isQuiz` | boolean | Ob das Formular ein Quiz ist |
+|     ↳ `emailCollectionType` | string | E-Mail-Erfassungstyp |
+|   ↳ `revisionId` | string | Die Revisions-ID des Formulars |
+|   ↳ `responderUri` | string | Die URI zum Teilen mit Befragten |
+|   ↳ `linkedSheetId` | string | Die ID des verknüpften Google Sheets |
+|   ↳ `publishSettings` | object | Formularveröffentlichungseinstellungen |
+|     ↳ `publishState` | object | Aktueller Veröffentlichungsstatus |
+|       ↳ `isPublished` | boolean | Ob das Formular veröffentlicht ist |
+|       ↳ `isAcceptingResponses` | boolean | Ob das Formular Antworten akzeptiert |
+
+### `google_forms_set_publish_settings`
+
+Aktualisiert die Veröffentlichungseinstellungen eines Formulars (veröffentlichen/zurückziehen, Antworten akzeptieren)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID |
+| `isPublished` | boolean | Ja | Ob das Formular veröffentlicht und für andere sichtbar ist |
+| `isAcceptingResponses` | boolean | Nein | Ob das Formular Antworten akzeptiert \(wird auf false gesetzt, wenn isPublished false ist\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `formId` | string | Die Formular-ID |
+| `publishSettings` | json | Die aktualisierten Veröffentlichungseinstellungen |
+|   ↳ `publishState` | object | Der Veröffentlichungsstatus |
+|     ↳ `isPublished` | boolean | Ob das Formular veröffentlicht ist |
+|     ↳ `isAcceptingResponses` | boolean | Ob das Formular Antworten akzeptiert |
+
+### `google_forms_create_watch`
+
+Erstellt eine Benachrichtigungsüberwachung für Formularänderungen (Schemaänderungen oder neue Antworten)
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID zur Überwachung |
+| `eventType` | string | Ja | Zu überwachender Ereignistyp: SCHEMA \(Formularänderungen\) oder RESPONSES \(neue Einreichungen\) |
+| `topicName` | string | Ja | Der Cloud Pub/Sub Topic-Name \(Format: projects/\{project\}/topics/\{topic\}\) |
+| `watchId` | string | Nein | Benutzerdefinierte Watch-ID \(4-63 Zeichen, Kleinbuchstaben, Zahlen, Bindestriche\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Die Watch-ID |
+| `eventType` | string | Der überwachte Ereignistyp |
+| `topicName` | string | Das Cloud Pub/Sub-Thema |
+| `createTime` | string | Zeitpunkt der Erstellung der Watch |
+| `expireTime` | string | Ablaufzeitpunkt der Watch \(7 Tage nach Erstellung\) |
+| `state` | string | Der Watch-Status \(ACTIVE, SUSPENDED\) |
+
+### `google_forms_list_watches`
+
+Alle Benachrichtigungs-Watches für ein Formular auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `watches` | array | Liste der Watches für das Formular |
+|   ↳ `id` | string | Watch-ID |
+|   ↳ `eventType` | string | Ereignistyp \(SCHEMA oder RESPONSES\) |
+|   ↳ `createTime` | string | Zeitpunkt der Erstellung der Watch |
+|   ↳ `expireTime` | string | Ablaufzeitpunkt der Watch |
+|   ↳ `state` | string | Watch-Status |
+
+### `google_forms_delete_watch`
+
+Eine Benachrichtigungs-Watch von einem Formular löschen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID |
+| `watchId` | string | Ja | Zu löschende Watch-ID |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `deleted` | boolean | Ob die Überwachung erfolgreich gelöscht wurde |
+
+### `google_forms_renew_watch`
+
+Verlängert eine Benachrichtigungsüberwachung um weitere 7 Tage
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `formId` | string | Ja | Google Forms Formular-ID |
+| `watchId` | string | Ja | Zu verlängernde Überwachungs-ID |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Die Überwachungs-ID |
+| `eventType` | string | Der überwachte Ereignistyp |
+| `expireTime` | string | Die neue Ablaufzeit |
+| `state` | string | Der Überwachungsstatus |

apps/docs/content/docs/de/tools/google_groups.mdx

@@ -217,3 +217,201 @@ Prüfen, ob ein Benutzer Mitglied einer Google-Gruppe ist
 
 - Kategorie: `tools`
 - Typ: `google_groups`
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupKey` | string | Ja | Gruppenkennung. Kann die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) oder die eindeutige Gruppen-ID sein |
+| `memberKey` | string | Ja | Zu prüfende Mitgliederkennung. Kann die E-Mail-Adresse des Mitglieds \(z. B. user@example.com\) oder die eindeutige Mitglieds-ID sein |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `isMember` | boolean | Gibt an, ob der Benutzer ein Mitglied der Gruppe ist |
+
+### `google_groups_list_aliases`
+
+Alle E-Mail-Aliase für eine Google-Gruppe auflisten
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupKey` | string | Ja | Gruppenkennung. Kann die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) oder die eindeutige Gruppen-ID sein |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `aliases` | array | Liste der E-Mail-Aliase für die Gruppe |
+|   ↳ `id` | string | Eindeutige Gruppenkennung |
+|   ↳ `primaryEmail` | string | Primäre E-Mail-Adresse der Gruppe |
+|   ↳ `alias` | string | Alias-E-Mail-Adresse |
+|   ↳ `kind` | string | API-Ressourcentyp |
+|   ↳ `etag` | string | Ressourcenversionskennung |
+
+### `google_groups_add_alias`
+
+Einen E-Mail-Alias zu einer Google-Gruppe hinzufügen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupKey` | string | Ja | Gruppenkennung. Kann die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) oder die eindeutige Gruppen-ID sein |
+| `alias` | string | Ja | Der E-Mail-Alias, der zur Gruppe hinzugefügt werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `id` | string | Eindeutige Gruppenkennung |
+| `primaryEmail` | string | Primäre E-Mail-Adresse der Gruppe |
+| `alias` | string | Der hinzugefügte Alias |
+| `kind` | string | API-Ressourcentyp |
+| `etag` | string | Ressourcenversionskennung |
+
+### `google_groups_remove_alias`
+
+Einen E-Mail-Alias von einer Google-Gruppe entfernen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupKey` | string | Ja | Gruppenkennung. Kann die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) oder die eindeutige Gruppen-ID sein |
+| `alias` | string | Ja | Der E-Mail-Alias, der aus der Gruppe entfernt werden soll |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `deleted` | boolean | Gibt an, ob der Alias erfolgreich gelöscht wurde |
+
+### `google_groups_get_settings`
+
+Die Einstellungen für eine Google-Gruppe abrufen, einschließlich Zugriffsberechtigungen, Moderation und Veröffentlichungsoptionen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupEmail` | string | Ja | Die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Die E-Mail-Adresse der Gruppe |
+| `name` | string | Der Gruppenname \(max. 75 Zeichen\) |
+| `description` | string | Die Gruppenbeschreibung \(max. 4096 Zeichen\) |
+| `whoCanJoin` | string | Wer der Gruppe beitreten kann \(ANYONE_CAN_JOIN, ALL_IN_DOMAIN_CAN_JOIN, INVITED_CAN_JOIN, CAN_REQUEST_TO_JOIN\) |
+| `whoCanViewMembership` | string | Wer die Gruppenmitgliedschaft anzeigen kann |
+| `whoCanViewGroup` | string | Wer Gruppennachrichten anzeigen kann |
+| `whoCanPostMessage` | string | Wer Nachrichten in der Gruppe veröffentlichen kann |
+| `allowExternalMembers` | string | Ob externe Benutzer Mitglieder sein können |
+| `allowWebPosting` | string | Ob Web-Veröffentlichung erlaubt ist |
+| `primaryLanguage` | string | Die primäre Sprache der Gruppe |
+| `isArchived` | string | Ob Nachrichten archiviert werden |
+| `archiveOnly` | string | Ob die Gruppe nur archiviert ist \(inaktiv\) |
+| `messageModerationLevel` | string | Nachrichtenmoderationsebene |
+| `spamModerationLevel` | string | Spam-Behandlungsebene \(ALLOW, MODERATE, SILENTLY_MODERATE, REJECT\) |
+| `replyTo` | string | Standard-Antwortziel |
+| `customReplyTo` | string | Benutzerdefinierte E-Mail für Antworten |
+| `includeCustomFooter` | string | Ob eine benutzerdefinierte Fußzeile eingefügt werden soll |
+| `customFooterText` | string | Benutzerdefinierter Fußzeilentext \(max. 1000 Zeichen\) |
+| `sendMessageDenyNotification` | string | Ob Ablehnungsbenachrichtigungen gesendet werden sollen |
+| `defaultMessageDenyNotificationText` | string | Standard-Ablehnungsnachrichtentext |
+| `membersCanPostAsTheGroup` | string | Ob Mitglieder als Gruppe veröffentlichen können |
+| `includeInGlobalAddressList` | string | Ob in der globalen Adressliste enthalten |
+| `whoCanLeaveGroup` | string | Wer die Gruppe verlassen kann |
+| `whoCanContactOwner` | string | Wer den Gruppeninhaber kontaktieren kann |
+| `favoriteRepliesOnTop` | string | Ob bevorzugte Antworten oben erscheinen |
+| `whoCanApproveMembers` | string | Wer neue Mitglieder genehmigen kann |
+| `whoCanBanUsers` | string | Wer Benutzer sperren kann |
+| `whoCanModerateMembers` | string | Wer Mitglieder verwalten kann |
+| `whoCanModerateContent` | string | Wer Inhalte moderieren kann |
+| `whoCanAssistContent` | string | Wer bei Inhaltsmetadaten unterstützen kann |
+| `enableCollaborativeInbox` | string | Ob der kollaborative Posteingang aktiviert ist |
+| `whoCanDiscoverGroup` | string | Wer die Gruppe entdecken kann |
+| `defaultSender` | string | Standard-Absenderidentität \(DEFAULT_SELF oder GROUP\) |
+
+### `google_groups_update_settings`
+
+Aktualisieren Sie die Einstellungen für eine Google-Gruppe, einschließlich Zugriffsberechtigungen, Moderation und Veröffentlichungsoptionen
+
+#### Eingabe
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+| --------- | ---- | -------- | ----------- |
+| `groupEmail` | string | Ja | Die E-Mail-Adresse der Gruppe \(z. B. team@example.com\) |
+| `name` | string | Nein | Der Gruppenname \(max. 75 Zeichen\) |
+| `description` | string | Nein | Die Gruppenbeschreibung \(max. 4096 Zeichen\) |
+| `whoCanJoin` | string | Nein | Wer kann beitreten: ANYONE_CAN_JOIN, ALL_IN_DOMAIN_CAN_JOIN, INVITED_CAN_JOIN, CAN_REQUEST_TO_JOIN |
+| `whoCanViewMembership` | string | Nein | Wer kann Mitgliedschaft einsehen: ALL_IN_DOMAIN_CAN_VIEW, ALL_MEMBERS_CAN_VIEW, ALL_MANAGERS_CAN_VIEW |
+| `whoCanViewGroup` | string | Nein | Wer kann Gruppennachrichten einsehen: ANYONE_CAN_VIEW, ALL_IN_DOMAIN_CAN_VIEW, ALL_MEMBERS_CAN_VIEW, ALL_MANAGERS_CAN_VIEW |
+| `whoCanPostMessage` | string | Nein | Wer kann posten: NONE_CAN_POST, ALL_MANAGERS_CAN_POST, ALL_MEMBERS_CAN_POST, ALL_OWNERS_CAN_POST, ALL_IN_DOMAIN_CAN_POST, ANYONE_CAN_POST |
+| `allowExternalMembers` | string | Nein | Ob externe Benutzer Mitglieder sein können: true oder false |
+| `allowWebPosting` | string | Nein | Ob Web-Posting erlaubt ist: true oder false |
+| `primaryLanguage` | string | Nein | Die Hauptsprache der Gruppe \(z. B. de\) |
+| `isArchived` | string | Nein | Ob Nachrichten archiviert werden: true oder false |
+| `archiveOnly` | string | Nein | Ob die Gruppe nur archiviert \(inaktiv\) ist: true oder false |
+| `messageModerationLevel` | string | Nein | Nachrichtenmoderation: MODERATE_ALL_MESSAGES, MODERATE_NON_MEMBERS, MODERATE_NEW_MEMBERS, MODERATE_NONE |
+| `spamModerationLevel` | string | Nein | Spam-Behandlung: ALLOW, MODERATE, SILENTLY_MODERATE, REJECT |
+| `replyTo` | string | Nein | Standard-Antwort: REPLY_TO_CUSTOM, REPLY_TO_SENDER, REPLY_TO_LIST, REPLY_TO_OWNER, REPLY_TO_IGNORE, REPLY_TO_MANAGERS |
+| `customReplyTo` | string | Nein | Benutzerdefinierte E-Mail für Antworten \(wenn replyTo REPLY_TO_CUSTOM ist\) |
+| `includeCustomFooter` | string | Nein | Ob benutzerdefinierte Fußzeile eingefügt werden soll: true oder false |
+| `customFooterText` | string | Nein | Benutzerdefinierter Fußzeilentext \(max. 1000 Zeichen\) |
+| `sendMessageDenyNotification` | string | Nein | Ob Ablehnungsbenachrichtigungen gesendet werden sollen: true oder false |
+| `defaultMessageDenyNotificationText` | string | Nein | Standard-Ablehnungsnachrichtentext |
+| `membersCanPostAsTheGroup` | string | Nein | Ob Mitglieder als Gruppe posten können: true oder false |
+| `includeInGlobalAddressList` | string | Nein | Ob in der globalen Adressliste enthalten: true oder false |
+| `whoCanLeaveGroup` | string | Nein | Wer kann austreten: ALL_MANAGERS_CAN_LEAVE, ALL_MEMBERS_CAN_LEAVE, NONE_CAN_LEAVE |
+| `whoCanContactOwner` | string | Nein | Wer kann Inhaber kontaktieren: ALL_IN_DOMAIN_CAN_CONTACT, ALL_MANAGERS_CAN_CONTACT, ALL_MEMBERS_CAN_CONTACT, ANYONE_CAN_CONTACT |
+| `favoriteRepliesOnTop` | string | Nein | Ob bevorzugte Antworten oben erscheinen: true oder false |
+| `whoCanApproveMembers` | string | Nein | Wer kann Mitglieder genehmigen: ALL_OWNERS_CAN_APPROVE, ALL_MANAGERS_CAN_APPROVE, ALL_MEMBERS_CAN_APPROVE, NONE_CAN_APPROVE |
+| `whoCanBanUsers` | string | Nein | Wer kann Benutzer sperren: OWNERS_ONLY, OWNERS_AND_MANAGERS, NONE |
+| `whoCanModerateMembers` | string | Nein | Wer kann Mitglieder verwalten: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE |
+| `whoCanModerateContent` | string | Nein | Wer kann Inhalte moderieren: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE |
+| `whoCanAssistContent` | string | Nein | Wer kann bei Inhaltsmetadaten unterstützen: OWNERS_ONLY, OWNERS_AND_MANAGERS, ALL_MEMBERS, NONE |
+| `enableCollaborativeInbox` | string | Nein | Ob kollaborativer Posteingang aktiviert ist: true oder false |
+| `whoCanDiscoverGroup` | string | Nein | Wer kann entdecken: ANYONE_CAN_DISCOVER, ALL_IN_DOMAIN_CAN_DISCOVER, ALL_MEMBERS_CAN_DISCOVER |
+| `defaultSender` | string | Nein | Standard-Absender: DEFAULT_SELF oder GROUP |
+
+#### Ausgabe
+
+| Parameter | Typ | Beschreibung |
+| --------- | ---- | ----------- |
+| `email` | string | Die E-Mail-Adresse der Gruppe |
+| `name` | string | Der Gruppenname |
+| `description` | string | Die Gruppenbeschreibung |
+| `whoCanJoin` | string | Wer der Gruppe beitreten kann |
+| `whoCanViewMembership` | string | Wer die Gruppenmitgliedschaft einsehen kann |
+| `whoCanViewGroup` | string | Wer Gruppennachrichten einsehen kann |
+| `whoCanPostMessage` | string | Wer Nachrichten in der Gruppe posten kann |
+| `allowExternalMembers` | string | Ob externe Benutzer Mitglieder sein können |
+| `allowWebPosting` | string | Ob Web-Posting erlaubt ist |
+| `primaryLanguage` | string | Die Hauptsprache der Gruppe |
+| `isArchived` | string | Ob Nachrichten archiviert werden |
+| `archiveOnly` | string | Ob die Gruppe nur zum Archivieren dient |
+| `messageModerationLevel` | string | Moderationsstufe für Nachrichten |
+| `spamModerationLevel` | string | Spam-Behandlungsstufe |
+| `replyTo` | string | Standard-Antwortziel |
+| `customReplyTo` | string | Benutzerdefinierte E-Mail für Antworten |
+| `includeCustomFooter` | string | Ob eine benutzerdefinierte Fußzeile eingefügt werden soll |
+| `customFooterText` | string | Text der benutzerdefinierten Fußzeile |
+| `sendMessageDenyNotification` | string | Ob Ablehnungsbenachrichtigungen gesendet werden sollen |
+| `defaultMessageDenyNotificationText` | string | Text der Standard-Ablehnungsnachricht |
+| `membersCanPostAsTheGroup` | string | Ob Mitglieder als Gruppe posten können |
+| `includeInGlobalAddressList` | string | Ob in der globalen Adressliste enthalten |
+| `whoCanLeaveGroup` | string | Wer die Gruppe verlassen kann |
+| `whoCanContactOwner` | string | Wer den Gruppeninhaber kontaktieren kann |
+| `favoriteRepliesOnTop` | string | Ob bevorzugte Antworten oben erscheinen |
+| `whoCanApproveMembers` | string | Wer neue Mitglieder genehmigen kann |
+| `whoCanBanUsers` | string | Wer Benutzer sperren kann |
+| `whoCanModerateMembers` | string | Wer Mitglieder verwalten kann |
+| `whoCanModerateContent` | string | Wer Inhalte moderieren kann |
+| `whoCanAssistContent` | string | Wer bei Inhalts-Metadaten unterstützen kann |
+| `enableCollaborativeInbox` | string | Ob der gemeinsame Posteingang aktiviert ist |
+| `whoCanDiscoverGroup` | string | Wer die Gruppe entdecken kann |
+| `defaultSender` | string | Standard-Absenderidentität |