@synap-core/workspace-templates 0.12.0 → 0.23.0

package/capabilities/datagouv.capability.json

@@ -0,0 +1,315 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "datagouv",
+    "name": "data.gouv.fr — French Open Data",
+    "description": "Search, preview and save datasets from data.gouv.fr, France's official open-data platform: companies (SIRENE), property sales (DVF), addresses, public procurement and more. Read-only. No API key needed.",
+    "tags": [
+      "capability",
+      "france",
+      "opendata",
+      "mcp",
+      "opt-in"
+    ],
+    "isPublic": true,
+    "syncByDefault": false
+  },
+  "spec": {
+    "key": "datagouv",
+    "name": "data.gouv.fr — French Open Data",
+    "description": "Official French open-data platform (data.gouv.fr) as a first-class Synap capability. Registers the public DINUM MCP server (https://mcp.data.gouv.fr/mcp — no API key, read-only) so agents get live tools, plus curated verbs for search/preview/capture and a teaching skill that maps the full MCP + REST surface so an AI can crystallize useful MCP workflows into new callable caps, automations, and skills. Coverage: ~75k datasets, ~1k dataservices (APIs catalogued on the platform), orgs (INSEE, DGFiP, collectivités…), Tabular row preview (CSV≤100MB / XLSX≤12.5MB). High-value domains: SIRENE (companies), DVF (real-estate transactions), BAN (addresses), cadastre, IRVE (EV chargers), population, marchés publics. Licence Ouverte / Etalab for most data. PRECONDITION: none for the hosted MCP. Optional: self-host URL via mcpUrl param. Install is opt-in (not default-synced to every pod).",
+    "params": [
+      {
+        "name": "mcpUrl",
+        "label": "MCP server URL",
+        "type": "text",
+        "required": false,
+        "default": "https://mcp.data.gouv.fr/mcp",
+        "description": "Streamable-HTTP MCP endpoint. Default is the official public instance (no auth). Override only if you self-host datagouv-mcp."
+      }
+    ],
+    "vault": [],
+    "mcpServers": [
+      {
+        "slug": "datagouv",
+        "name": "data.gouv.fr",
+        "description": "Official French open-data MCP (DINUM). Search datasets, list resources, query tabular rows, discover third-party APIs (dataservices).",
+        "transport": "http",
+        "url": "{{mcpUrl}}",
+        "enabled": true,
+        "toolPolicy": {
+          "default": "inline"
+        },
+        "metadata": {
+          "provider": "datagouv",
+          "docs": "https://github.com/datagouv/datagouv-mcp",
+          "license": "MIT",
+          "auth": "none"
+        }
+      }
+    ],
+    "tools": [
+      {
+        "name": "datagouv_mcp",
+        "kind": "mcp",
+        "description": "Gateway to the data.gouv.fr MCP server. callProvider('datagouv_mcp', 'POST', '<mcp_tool_name>', args) runs any registered MCP tool (search_datasets, get_dataset_info, list_dataset_resources, get_resource_info, query_resource_data, search_organizations, search_dataservices, get_dataservice_info, get_dataservice_openapi_spec, get_metrics). Path = MCP tool name; body = tool arguments. No vault secret — credentialRef is the mcp:// server slug.",
+        "credentialRef": "mcp://datagouv",
+        "executor": "is-agent",
+        "config": {
+          "serverSlug": "datagouv"
+        },
+        "metadata": {
+          "provider": "datagouv",
+          "mcpTools": [
+            "search_datasets",
+            "search_organizations",
+            "get_dataset_info",
+            "list_dataset_resources",
+            "get_resource_info",
+            "query_resource_data",
+            "search_dataservices",
+            "get_dataservice_info",
+            "get_dataservice_openapi_spec",
+            "get_metrics"
+          ]
+        }
+      }
+    ],
+    "skills": [
+      {
+        "name": "datagouv-open-data-advisor",
+        "kind": "instruction",
+        "scope": "pod",
+        "description": "Expert playbook for French open data via data.gouv.fr. Load when the user asks about French public data, SIRENE/companies, DVF/real estate, BAN/addresses, IRVE, INSEE stats, marchés publics, or when crystallizing an MCP workflow into a reusable capability/automation. Contains the full MCP tool map, REST API map, high-value dataset guide, entity mapping rules, and the MCP→cap crystallization protocol.",
+        "code": "# data.gouv.fr Open Data Advisor\n\nYou are the French open-data specialist for this Synap pod. You help discover, preview, and **structure** public data from [data.gouv.fr](https://www.data.gouv.fr) — and you turn useful ad-hoc MCP workflows into durable, callable capabilities.\n\n## Mental model (three layers)\n\n1. **Live MCP tools** — injected from the `datagouv` MCP server (and/or via `callProvider('datagouv_mcp', …)` / curated verbs below). Best for exploration and one-shot answers.\n2. **Curated capability verbs** — first-class skills (`datagouv_search_datasets`, `datagouv_query_resource`, …). Best for automations and other agents that need stable contracts.\n3. **Crystallized caps** — new skills/automations YOU propose after a workflow proves useful. This is the product loop: *MCP explore → useful workflow → real cap*.\n\nNever invent dataset IDs. Always search first, then drill into resources.\n\n## MCP tool map (path = tool name for `datagouv_mcp`)\n\n| Tool | Args | Use |\n|---|---|---|\n| `search_datasets` | `query` (req), `page?`, `page_size?` (max 100) | Find datasets by keywords |\n| `search_organizations` | `query?`, `page?`, `page_size?`, `sort?`, `badge?` (`public-service`\\|`certified`\\|`local-authority`\\|…) | Find publishers |\n| `get_dataset_info` | `dataset_id` | Full metadata, license, tags, org |\n| `list_dataset_resources` | `dataset_id` | Files (format, size, URL) |\n| `get_resource_info` | `resource_id` | MIME, Tabular availability, download URL |\n| `query_resource_data` | `resource_id`, `page?`, `page_size?` (max 200) | Preview CSV/XLS rows via Tabular API |\n| `search_dataservices` | `query`, `page?`, `page_size?` | Find live third-party APIs catalogued on the platform |\n| `get_dataservice_info` | `dataservice_id` | Base API URL, OpenAPI URL, license |\n| `get_dataservice_openapi_spec` | `dataservice_id` | Endpoint summary |\n| `get_metrics` | `dataset_id?` and/or `resource_id?`, `limit?` | Visits / downloads (prod only) |\n\n**Recommended MCP workflow:** `search_datasets` → `list_dataset_resources` → `query_resource_data` (page_size 20) to learn schema → for small sets paginate; for large sets use the raw file URL from `get_resource_info` (do not try to pull multi-GB dumps through MCP).\n\n**Tabular limits:** CSV ≤ 100 MB, XLSX ≤ 12.5 MB.\n\n**Dataservices note:** MCP *discovers* APIs (Adresse, Sirene live, etc.) and returns OpenAPI — it does **not** call those third-party APIs for you. After OpenAPI, either call them out-of-band or crystallize a new `kind:\"api\"` tool + verbs.\n\n## REST API (data.gouv catalog — no key for reads)\n\nBase: `https://www.data.gouv.fr/api/1`\n\n| Path | Notes |\n|---|---|\n| `GET /datasets/?q=` | Search (same catalog as MCP) |\n| `GET /datasets/{id}/` | Dataset detail |\n| `GET /datasets/{id}/resources/` | Resources |\n| `GET /organizations/?q=` | Orgs |\n| `GET /dataservices/?q=` | Third-party APIs |\n| Tabular | Via MCP `query_resource_data` or resource-specific tabular endpoints |\n\n`X-API-KEY` is only required for **writes** (publishing). This capability is read-only consumption.\n\n## High-value datasets (start here)\n\n| Need | Search terms / known anchors |\n|---|---|\n| French companies (SIREN/SIRET, NAF, siège) | `Base Sirene`, `SIRENE` (INSEE) |\n| Real-estate sale prices | `Demandes de valeurs foncières`, `DVF`, `DVF+` |\n| Official addresses + coords | `Base Adresse Nationale`, `BAN` |\n| Cadastre / parcels | `cadastre`, plan cadastral |\n| EV charging stations | `IRVE` |\n| Population / admin geo | INSEE population, COG, communes |\n| Public procurement | `marchés publics`, BOAMP-linked dumps |\n\nLicence is usually **Licence Ouverte / Etalab** — free reuse including commercial, with attribution. Always record `provider: 'data.gouv.fr'`, `dataset_id`, `resource_id`, `retrieved_at` on any entity you create.\n\n## Mapping into the pod (do not invent kinds)\n\n| Open data | Prefer entity / property |\n|---|---|\n| Company (SIREN) | `company` — attach role facets (client/partner/…) as needed; never create a second entity for a hat |\n| Address / place | existing place/geo fields or a note with structured properties |\n| Dataset discovery | `research` or `bookmark` with provenance URL |\n| Fact / lesson | `knowledge` / capture with claim + source |\n\nIdentity-first: match on SIREN/SIRET/email/url before creating a company.\n\n## Crystallization protocol (MCP → real capability)\n\nWhen a multi-step MCP workflow is **repeatable and valuable**, promote it — do not leave it as chat-only knowledge.\n\n### When to crystallize\n- Used ≥2 times with stable inputs/outputs\n- Would be useful to another agent or a cron/automation\n- Clear success criteria (e.g. \"lookup company by SIREN → propose company entity\")\n\n### What to produce (proposal-gated)\n1. **A skill verb** (`kind: code` or `declarative`) with:\n   - stable `name` (snake_case, prefixed `datagouv_` or domain-specific)\n   - `requires: [\"datagouv_mcp\"]` (or a new `kind:api` tool if calling a third-party dataservice)\n   - typed `parameters` (`string?` for optional)\n   - short description (agent-facing contract)\n2. Optionally an **automation** (cron/event) that calls that verb\n3. Optionally a **playbook stage grant** if it belongs to a session template\n\n### How to propose\n- Prefer the pod's capability/skill proposal paths (`propose` tools / capability apply definition) over free-text-only advice.\n- Capture a short `knowledge` lesson: *workflow*, *inputs*, *outputs*, *gotchas* (Tabular size, ID types, license).\n- If the workflow needs a **third-party API** (BAN geocode, live Sirene): use `search_dataservices` + OpenAPI, then propose a NEW capability tool `kind:\"api\"` with its own baseUrl — do not pretend MCP will call it.\n\n### Do NOT crystallize\n- One-off research answers\n- Full bulk dumps (SIRENE national file, multi-year DVF) — those need ETL/jobs, not MCP page loops\n- Restricted admin APIs (API Entreprise / Particulier — Datapass) without habilitation\n\n## Curated verbs already installed\n\n| Verb | Purpose |\n|---|---|\n| `datagouv_search_datasets` | Keyword search |\n| `datagouv_get_dataset` | Dataset metadata by id |\n| `datagouv_list_resources` | Files for a dataset |\n| `datagouv_query_resource` | Tabular row preview |\n| `datagouv_search_dataservices` | Discover live APIs |\n| `datagouv_get_dataservice` | One API's metadata + OpenAPI summary path |\n| `datagouv_capture_dataset` | Propose a research/bookmark entity with provenance |\n\nUse these first; invent new verbs only when the contract is different.\n\n## Safety & quality\n- Read-only: never claim you can publish to data.gouv without a user API key + write capability.\n- Cite dataset title + URL when answering humans.\n- Prefer French queries for French catalog relevance (`immobilier Paris`, `entreprises SIRENE`).\n- If MCP is down, say so; do not fabricate rows.\n"
+      },
+      {
+        "name": "datagouv_search_datasets",
+        "intent": "search_external",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Search data.gouv.fr datasets by keywords (French open data catalog). Read-only. Args: { query: string, page?: number (default 1), page_size?: number (default 20, max 100) }. Returns search hits with title, id, organization, tags, resource count.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 45,
+        "parameters": {
+          "query": "string",
+          "page": "number?",
+          "page_size": "number?"
+        },
+        "code": "const query = String(args?.query ?? '').trim();\nif (!query) throw new Error('datagouv_search_datasets: query is required');\nconst page = Number.isFinite(Number(args?.page)) ? Math.max(1, Math.trunc(Number(args.page))) : 1;\nconst ps = Number.isFinite(Number(args?.page_size)) ? Math.trunc(Number(args.page_size)) : 20;\nconst page_size = Math.max(1, Math.min(100, ps));\nconst res = await callProvider('datagouv_mcp', 'POST', 'search_datasets', { query, page, page_size });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP search_datasets failed'));\nconst payload = res?.body !== undefined ? res.body : res;\nreturn { query, page, page_size, result: payload };"
+      },
+      {
+        "name": "datagouv_get_dataset",
+        "intent": "fetch_record",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Get detailed metadata for one data.gouv.fr dataset (title, description, organization, tags, license, dates). Read-only. Args: { dataset_id: string }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 45,
+        "parameters": {
+          "dataset_id": "string"
+        },
+        "code": "const dataset_id = String(args?.dataset_id ?? '').trim();\nif (!dataset_id) throw new Error('datagouv_get_dataset: dataset_id is required');\nconst res = await callProvider('datagouv_mcp', 'POST', 'get_dataset_info', { dataset_id });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP get_dataset_info failed'));\nconst payload = res?.body !== undefined ? res.body : res;\nreturn { dataset_id, result: payload };"
+      },
+      {
+        "name": "datagouv_list_resources",
+        "intent": "list_records",
+        "kind": "code",
+        "scope": "pod",
+        "description": "List files (resources) in a data.gouv.fr dataset — format, size, type, URL. Read-only. Args: { dataset_id: string }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 45,
+        "parameters": {
+          "dataset_id": "string"
+        },
+        "code": "const dataset_id = String(args?.dataset_id ?? '').trim();\nif (!dataset_id) throw new Error('datagouv_list_resources: dataset_id is required');\nconst res = await callProvider('datagouv_mcp', 'POST', 'list_dataset_resources', { dataset_id });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP list_dataset_resources failed'));\nconst payload = res?.body !== undefined ? res.body : res;\nreturn { dataset_id, result: payload };"
+      },
+      {
+        "name": "datagouv_query_resource",
+        "intent": "list_records",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Preview rows from a CSV/XLS resource via data.gouv Tabular API. Use after list_resources to learn schema. Not for multi-GB dumps (CSV≤100MB, XLSX≤12.5MB). Read-only. Args: { resource_id: string, page?: number (default 1), page_size?: number (default 20, max 200) }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "resource_id": "string",
+          "page": "number?",
+          "page_size": "number?"
+        },
+        "code": "const resource_id = String(args?.resource_id ?? '').trim();\nif (!resource_id) throw new Error('datagouv_query_resource: resource_id is required');\nconst page = Number.isFinite(Number(args?.page)) ? Math.max(1, Math.trunc(Number(args.page))) : 1;\nconst ps = Number.isFinite(Number(args?.page_size)) ? Math.trunc(Number(args.page_size)) : 20;\nconst page_size = Math.max(1, Math.min(200, ps));\nconst res = await callProvider('datagouv_mcp', 'POST', 'query_resource_data', { resource_id, page, page_size });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP query_resource_data failed'));\nconst payload = res?.body !== undefined ? res.body : res;\nreturn { resource_id, page, page_size, result: payload };"
+      },
+      {
+        "name": "datagouv_search_dataservices",
+        "intent": "search_external",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Search third-party APIs catalogued on data.gouv.fr (Adresse, Sirene, local APIs…). Returns metadata + base API URL; does NOT call the third-party API. Read-only. Args: { query: string, page?: number, page_size?: number }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 45,
+        "parameters": {
+          "query": "string",
+          "page": "number?",
+          "page_size": "number?"
+        },
+        "code": "const query = String(args?.query ?? '').trim();\nif (!query) throw new Error('datagouv_search_dataservices: query is required');\nconst page = Number.isFinite(Number(args?.page)) ? Math.max(1, Math.trunc(Number(args.page))) : 1;\nconst ps = Number.isFinite(Number(args?.page_size)) ? Math.trunc(Number(args.page_size)) : 20;\nconst page_size = Math.max(1, Math.min(100, ps));\nconst res = await callProvider('datagouv_mcp', 'POST', 'search_dataservices', { query, page, page_size });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP search_dataservices failed'));\nconst payload = res?.body !== undefined ? res.body : res;\nreturn { query, page, page_size, result: payload };"
+      },
+      {
+        "name": "datagouv_get_dataservice",
+        "intent": "fetch_record",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Get one dataservice's metadata and OpenAPI summary (endpoints/params). Use before crystallizing a dedicated API capability for a third-party service. Read-only. Args: { dataservice_id: string }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "sync",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "dataservice_id": "string"
+        },
+        "code": "const dataservice_id = String(args?.dataservice_id ?? '').trim();\nif (!dataservice_id) throw new Error('datagouv_get_dataservice: dataservice_id is required');\nconst infoRes = await callProvider('datagouv_mcp', 'POST', 'get_dataservice_info', { dataservice_id });\nif (infoRes?.success === false) throw new Error(String(infoRes?.error || 'datagouv MCP get_dataservice_info failed'));\nconst info = infoRes?.body !== undefined ? infoRes.body : infoRes;\nlet openapi = null;\ntry {\n  const specRes = await callProvider('datagouv_mcp', 'POST', 'get_dataservice_openapi_spec', { dataservice_id });\n  if (specRes?.success !== false) openapi = specRes?.body !== undefined ? specRes.body : specRes;\n} catch (_) { openapi = null; }\nreturn { dataservice_id, info, openapi };"
+      },
+      {
+        "name": "datagouv_capture_dataset",
+        "intent": "capture_into_pod",
+        "kind": "code",
+        "scope": "pod",
+        "description": "Fetches dataset metadata from data.gouv.fr and proposes a research entity with provenance (title, dataset_id, organization, license, URL, retrieved_at). Proposal-gated write. Args: { dataset_id: string, notes?: string }.",
+        "requires": [
+          "datagouv_mcp"
+        ],
+        "executionMode": "async",
+        "timeoutSeconds": 60,
+        "parameters": {
+          "dataset_id": "string",
+          "notes": "string?"
+        },
+        "code": "const dataset_id = String(args?.dataset_id ?? '').trim();\nif (!dataset_id) throw new Error('datagouv_capture_dataset: dataset_id is required');\nconst notes = typeof args?.notes === 'string' ? args.notes.trim() : '';\nconst res = await callProvider('datagouv_mcp', 'POST', 'get_dataset_info', { dataset_id });\nif (res?.success === false) throw new Error(String(res?.error || 'datagouv MCP get_dataset_info failed'));\nconst raw = res?.body !== undefined ? res.body : res;\n// MCP content may be text/JSON-wrapped — prefer object fields when present.\nconst info = (raw && typeof raw === 'object' && !Array.isArray(raw)) ? raw : { raw };\nconst title = String(info.title || info.name || `data.gouv dataset ${dataset_id}`);\nconst pageUrl = String(info.page || info.url || `https://www.data.gouv.fr/datasets/${dataset_id}/`);\nconst organization = info.organization?.name || info.organization || null;\nconst license = info.license || info.license_id || null;\nconst proposed = await propose.entity({\n  profileSlug: 'research',\n  title: title,\n  properties: {\n    provenance: 'connector', provider: 'data.gouv.fr',\n    dataset_id: dataset_id,\n    organization: organization,\n    license: license,\n    url: pageUrl,\n    retrieved_at: new Date().toISOString(),\n    notes: notes || null,\n    tags: Array.isArray(info.tags) ? info.tags : null\n  },\n  reasoning: `Captured data.gouv.fr dataset ${dataset_id} for research with full provenance.`\n});\nreturn { success: true, dataset_id, title, pageUrl, proposed };"
+      }
+    ],
+    "provides": [
+      "search_external",
+      "fetch_record",
+      "list_records",
+      "capture_into_pod"
+    ],
+    "playbooks": [
+      {
+        "name": "French Open Data Research",
+        "description": "Guided session to find, preview, and capture French public datasets for a research question — then crystallize any repeatable lookup into a capability verb.",
+        "goalTemplate": "Answer the open-data research question using data.gouv.fr: discover datasets, preview resources, capture provenance, and propose a crystallized verb if the workflow is reusable.",
+        "params": [
+          {
+            "name": "question",
+            "label": "Research question",
+            "type": "text",
+            "required": true,
+            "description": "What French public data question are we answering? e.g. 'median apartment prices Lyon 6' or 'SIRENE lookup pattern for CRM'."
+          }
+        ],
+        "channelSpec": {
+          "type": "THREAD",
+          "aiReactionMode": "only_mentioned"
+        },
+        "executor": "is-agent",
+        "status": "draft",
+        "stages": [
+          {
+            "key": "discover",
+            "name": "Discover",
+            "category": "started",
+            "description": "Search datasets and organizations relevant to the question. Use datagouv_search_datasets and the open-data advisor skill.",
+            "goal": "Shortlist 1–3 datasets with clear titles, orgs, and why they fit.",
+            "grants": [
+              {
+                "kind": "skill",
+                "id": "datagouv-open-data-advisor"
+              },
+              {
+                "kind": "skill",
+                "id": "datagouv_search_datasets"
+              }
+            ],
+            "suggestedTasks": [
+              "Search catalog in French and English keywords",
+              "Note dataset_ids and licenses"
+            ]
+          },
+          {
+            "key": "preview",
+            "name": "Preview",
+            "category": "started",
+            "description": "List resources and query a small Tabular sample to learn schema.",
+            "goal": "Document resource_ids, columns, and row sample limits.",
+            "grants": [
+              {
+                "kind": "skill",
+                "id": "datagouv_list_resources"
+              },
+              {
+                "kind": "skill",
+                "id": "datagouv_query_resource"
+              },
+              {
+                "kind": "skill",
+                "id": "datagouv_get_dataset"
+              }
+            ]
+          },
+          {
+            "key": "capture",
+            "name": "Capture",
+            "category": "started",
+            "description": "Write research entities with provenance; answer the question from samples (not bulk dumps).",
+            "goal": "Captured research notes + human-readable answer with citations.",
+            "grants": [
+              {
+                "kind": "skill",
+                "id": "datagouv_capture_dataset"
+              }
+            ]
+          },
+          {
+            "key": "crystallize",
+            "name": "Crystallize",
+            "category": "started",
+            "description": "If the workflow is repeatable, propose a new capability verb (and optional automation) following the advisor crystallization protocol.",
+            "goal": "Either a proposed skill definition or an explicit 'not worth crystallizing' decision with reason.",
+            "grants": [
+              {
+                "kind": "skill",
+                "id": "datagouv-open-data-advisor"
+              },
+              {
+                "kind": "skill",
+                "id": "datagouv_search_dataservices"
+              },
+              {
+                "kind": "skill",
+                "id": "datagouv_get_dataservice"
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  "dependencies": []
+}

package/capabilities/discord-bot.capability.json

@@ -0,0 +1,157 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "capability",
+  "meta": {
+    "slug": "discord-bot",
+    "name": "Discord Bot",
+    "description": "Connects your Discord bot to Synap: links channels to CRM records, brings messages into your workspace and posts agent updates back. Includes Client Onboarding and Lead Outreach playbooks. Needs a Discord bot token.",
+    "tags": [
+      "capability"
+    ],
+    "isPublic": true,
+    "syncByDefault": true
+  },
+  "spec": {
+    "_generated": "from telegram-discord-bridge/src/synapCapabilities.js — do not hand-edit; run `pnpm sync:discord-cap` in synap-control-plane-api",
+    "key": "discord-bot",
+    "name": "Discord Bot",
+    "description": "The bot is the agent's Discord presence — links channels to CRM entities, ingests messages into the productivity pipeline, and posts agent feedback. It owns the Discord bot token as a vault credential.",
+    "metadata": {
+      "mode": "standing"
+    },
+    "vault": [
+      {
+        "ref": "discord-bot-token",
+        "name": "Discord Bot Token",
+        "value": "{{botToken}}",
+        "type": "api_key",
+        "service": "discord",
+        "description": "Bot token used to authenticate the Discord gateway + outbound sends."
+      }
+    ],
+    "tools": [
+      {
+        "name": "discord",
+        "kind": "external",
+        "description": "Discord channel source + outbound bot.",
+        "credentialRef": "discord-bot-token",
+        "metadata": {
+          "discord": {
+            "categoryMap": {},
+            "categoryRules": {},
+            "reactCapture": false,
+            "feedbackRouting": "team",
+            "feedbackChannel": "",
+            "teamForum": "",
+            "captureChannel": "",
+            "captureFlows": [],
+            "mailFeed": {
+              "enabled": false,
+              "channelId": "",
+              "gmailQuery": "",
+              "senderAllow": [],
+              "senderDeny": [],
+              "mutedCategories": [],
+              "connectionId": ""
+            },
+            "eventSync": {
+              "enabled": false,
+              "sources": [
+                "event",
+                "calendar",
+                "deadline"
+              ],
+              "windowDays": 60,
+              "announceChannelId": "",
+              "connectionId": ""
+            },
+            "configSchema": [
+              {
+                "key": "reactCapture",
+                "label": "Capture on ✅ react",
+                "valueType": "boolean"
+              },
+              {
+                "key": "feedbackRouting",
+                "label": "Bot feedback routing",
+                "valueType": "string",
+                "inputType": "select",
+                "enumValues": [
+                  "team",
+                  "off"
+                ]
+              },
+              {
+                "key": "feedbackChannel",
+                "label": "Bot feedback channel (Discord channel id)",
+                "valueType": "string"
+              },
+              {
+                "key": "teamForum",
+                "label": "Team forum (Discord forum id for auto-created team threads)",
+                "valueType": "string"
+              },
+              {
+                "key": "captureChannel",
+                "label": "Capture channel (Discord channel id for ambient AI capture)",
+                "valueType": "string"
+              },
+              {
+                "key": "captureFlows",
+                "label": "Capture flows ([{channelId, focus, instructions}] — per-channel capture focus)",
+                "valueType": "json"
+              },
+              {
+                "key": "categoryRules",
+                "label": "Section rules (category → entity type + optional partner link)",
+                "valueType": "json"
+              },
+              {
+                "key": "mailFeed",
+                "label": "Mail feed ({enabled, channelId, gmailQuery, senderAllow, senderDeny, mutedCategories})",
+                "valueType": "json"
+              },
+              {
+                "key": "eventSync",
+                "label": "Event sync ({enabled, sources, windowDays, announceChannelId})",
+                "valueType": "json"
+              }
+            ]
+          }
+        }
+      }
+    ],
+    "playbooks": [
+      {
+        "name": "Client Onboarding",
+        "description": "Stand up a new client: ensure their CRM entity, room, and threads exist so the team has one place to work from.",
+        "goalTemplate": "Onboard the client \"{clientName}\". Ensure a `client` entity exists for them (create it if missing), set up their dedicated room/channel for collaboration, and post a short welcome summary of next steps. Surface anything still missing for kickoff.",
+        "params": [
+          {
+            "name": "clientName",
+            "label": "Client name",
+            "type": "text",
+            "required": true
+          }
+        ],
+        "status": "active"
+      },
+      {
+        "name": "Lead Outreach",
+        "description": "Per lead: draft a personalized first-touch message and propose sending it (proposal-gated — nothing goes out without approval).",
+        "goalTemplate": "Reach out to the lead \"{leadName}\". Review what we know about them, draft a short, personalized first-touch message tailored to their context, and PROPOSE sending it (connect + message). Do not send anything without explicit approval.",
+        "params": [
+          {
+            "name": "leadName",
+            "label": "Lead name",
+            "type": "text",
+            "required": true
+          }
+        ],
+        "status": "active"
+      }
+    ],
+    "provides": []
+  },
+  "dependencies": []
+}