Update to Chili Piper

{
  "description": "Creates, reads, updates, and deletes Chili Piper Concierge routers — the web-form routing configs that decide which rep a form submission books with. Always-live writes with dry-run diffs and representability checks; the write complement to concierge-debugger/routing-audit.",
  "included_files": [
    {
      "relative_path": "references/api-reference.md",
      "size_in_bytes": 15806
    },
    {
      "relative_path": "references/output-format.md",
      "size_in_bytes": 3162
    },
    {
      "relative_path": "references/write-procedures.md",
      "size_in_bytes": 7540
    }
  ],
  "name": "concierge-router-configuration",
  "skill_md_contents": "---\nname: concierge-router-configuration\ndescription: Creates, reads, updates, and deletes Chili Piper Concierge routers — the web-form routing configs that decide which rep a form submission books with. Always-live writes with dry-run diffs and representability checks; the write complement to concierge-debugger/routing-audit.\nversion: 0.2.5\nreferences:\n  - api-reference\n  - write-procedures\n  - output-format\ninputs:\n  - name: workspace\n    type: string\n    description: \"Workspace name or ID containing the router.\"\n    required: true\n  - name: action\n    type: string\n    description: \"One of: list, get, create, update, delete.\"\n    required: true\n  - name: router\n    type: string\n    description: \"Router name (substring), slug, or router ID. Required for get/update/delete.\"\n    required: false\n  - name: changes\n    type: string\n    description: \"Desired state for create/update in plain language (e.g. 'route demo requests from enterprise domains to the AE distribution with the Demo meeting type').\"\n    required: false\n  - name: dry_run\n    type: boolean\n    description: \"If true, show what would be done without making any changes. Always recommended before first run.\"\n    required: false\n    default: true\noutputs:\n  - name: plan\n    description: Dry-run diff — routing rows rendered as rule → assignment + meeting type, plus any form/branding changes, and every object that would change\n  - name: result\n    description: Applied changes with post-write verification (only when dry_run=false)\n  - name: audit_trail\n    description: Which tool calls were made, on which IDs, with before/after values\ntools_required: [chili-piper-mcp]\nhuman_decision_point: \"Review the dry-run plan before any write — Concierge routers are ALWAYS-LIVE: create and update publish immediately to the router's public form URL, so the plan is the only preview. Confirm delete separately; it is irreversible and kills the form link.\"\nwrites_to: \"Chili Piper Concierge router configuration (create/update/delete — publishes live immediately)\"\napi_note: \"2026-07-22: form/trigger writes must only REFERENCE existing data fields (standard defaults like PersonEmail always valid; custom fields by their UUID — an unknown dataField fails the write with 400 → references/api-reference.md § Data fields). 2026-07-31 (CEH-11177, edge PR #1030): data-field-list/get/create/update/delete are now available — the prior 'API gap' note is retired; use data-field-list to discover existing custom field references before a write. 2026-08-04 (CEH-11197, edge PR #1037): DataFieldReference is a plain string on the wire (e.g. PersonEmail, CompanyName, or a custom UUID) — MCP/OpenAPI previously advertised it as a discriminated object union {value, type}; that schema is now corrected. data-field-delete returns 204 No Content. 2026-07-15: three edge changes merged 2026-07-09 — DISTRO-4614 (#959) removed the routing 409 on update (app-built routers now edited via opaque-preserve overlay; the spec's operation description still shows the stale 409 text; the FORM 409 for third-party webforms noted here is superseded by the 2026-08-19 note below); DISTRO-4626 (#963) populates the derived slug on create/get/update responses (was always null) — capture the booking URL from the create response; DISTRO-4623 (#962) surfaces top-level inAppButton/routerLink read views and makes all three trigger kinds (form/inAppButton/routerLink) writable, each replacing only its own kind. No activate/deactivate and no status field — every write is live on success. Renaming re-derives the slug (public URL changes). Field truth → references/api-reference.md.; 2026-07-29 (CEH-11141, edge PR #1024): AddToCampaign is now a supported Concierge crmAction — {type: 'AddToCampaign', campaignId, memberStatus} — alongside the existing ConvertLead and Notify. Updated in references/api-reference.md § Write shapes (crmActions grammar).; 2026-07-30 (verified on a live tenant): ConvertLead written via the API is INVISIBLE in the Concierge Flow Builder — the API accepts and publishes it (node is real in the draft+published trees and fires post-booking), but the canvas renders no node and the SCHEDULED-branch ACTION menu offers no Convert Lead, so admins cannot see, edit, or remove it in the UI; inspect/remove only via concierge-router-get/-update. Whenever a write includes ConvertLead, call it out to the admin explicitly in the plan and the result. AddToCampaign UI rendering not yet verified. 2026-08-03 (CEH-10905, edge PR #1031): concierge-list-routers and concierge-router-get now include formFields on each router — a list of ConciergeFormField objects (reference, label, requirement, fieldType with pick-list options, description, placeholder, order); always empty for third-party webform routers. 2026-08-13 (CEH-11300/CEH-11302, edge PR #1069): Four Concierge write-model changes — (1) catchAll is now OPTIONAL on concierge-router-update: omitting it preserves the router's existing catch-all (still REQUIRED on create at that time). (2) New crmActions: SalesforceUpdateFields / HubspotUpdateFields (Update Record) and SalesforceUpsertRecord / HubspotUpsertRecord (Create/Upsert Record, Concierge only — not Handoff); field shapes in references/api-reference.md. (3) campaign-list and campaign-search are now available to look up Salesforce campaignIds for AddToCampaign actions. 2026-08-13 (CEH-11303, edge PR #1072): SalesforceUpdateOwnership / HubspotUpdateOwnership added — {type: 'SalesforceUpdateOwnership', contact: [{object, field}], lead: [{field}]} and {type: 'HubspotUpdateOwnership', contact: [{object, field}]} — always assigns the CRM record owner to the booked host; also supported on Handoff. 2026-08-13 (CEH-11313, edge PR #1073): EdgeUpdateFieldValue timeZone field widened from ZoneOffset to ZoneId — named timezones (e.g. America/New_York) are now valid in Update Record CRM action field values; RelativeQuarter subtype added (previously only RelativeDay/RelativeWeek/RelativeMonth). 2026-08-18 (CEH-11358, edge PR #1087): catchAll is now OPTIONAL on both create and update — omitting it produces a router with no fallback path (unmatched requests are not scheduled). The 'required on create' constraint is lifted. 2026-08-19 (CEH-11363, edge PR #1088): thirdPartyForm trigger mapping is now writable on create and update — {thirdPartyForm: [{formFieldName, dataField, label?}]}, mutually exclusive with form. The RouterFormNotRepresentable 409 is retired — third-party webform routers no longer reject writes via this path. Writing thirdPartyForm on a Chili-webform router converts it to a third-party router, and vice versa. Per-field enrichment (waterfallId, automapped url) is preserved across updates but not exposed or settable via the API.; 2026-09-03 (CEH-11590/CEH-11591, edge PR #1151): Two changes. (1) SalesforceCreateEvent and HubspotCreateEngagement added as new Concierge crmActions (Create Event — post-booking calendar event in CRM). Settings: relatedTo (optional; Concierge supports the full relation set unlike Handoff), meetingCancellationBehavior (default DoNothing), guestsBehavior (default DoNothing), owner (default Assignee). Full field shapes in references/api-reference.md. (2) concierge-router-get and concierge-list-routers now return the COMPLETE crmActions chain — previously unmodellable nodes collapsed the whole array to null; now they become an Other{kind} read-only placeholder and the walk continues so representable siblings are preserved. Other is read-only and REJECTED on write; representable becomes false when any placeholder was emitted. 2026-09-04 (CEH-11538, edge PR #1148): pre-routing steps are now readable AND authorable — routingSteps is a top-level sibling of routing on read (get/list) and an optional field on create/update. Step union: {type: 'Enrichment', waterfalls: [{dataField, waterfallId}], timeoutSeconds?} (waterfalls non-empty; timeoutSeconds whole seconds), {type: 'SpamCheck', writeSpamScoreToDataField} (no spam-path outcome by design — superseded by CEH-11610 note below), {type: 'Unrepresentable', kind} (read-only marker). Update semantics: omit routingSteps to preserve, supply to FULL-REPLACE the steps dimension ([] clears). A router whose steps contain Unrepresentable reads representable=false, and an update SUPPLYING routingSteps on it is rejected 409 RouterRoutingNotRepresentable (a rows-only routing edit still works and preserves steps verbatim) — the 'routing 409 retired since DISTRO-4614' claim is now qualified by this one case. waterfallId is an opaque string — resolve via the new enrichment-waterfall-list tool (CEH-11541, edge PR #1155): {workspaceId*, pagination?} → {results: [{id, name, isCustom, isTemplate, fields, tiedToDataField?, exclusivelyFor?, metadata}], total, page, pageSize}; never invent it, a stale id only surfaces at publish time. 2026-09-04 (CEH-11599, edge PR #1154): the ContactOptions read outcome now exposes its meeting/callSuccess/callMissed CRM-action chains (each an ordered list of the same crmAction union incl. Other; null = branch absent, [] = present with no actions) — still read-only/unwritable, representable stays false. 2026-09-04 (CEH-11610, edge PR #1158): SpamCheck pre-routing steps now require an onSpam spam-path outcome on write — the '(no spam-path outcome by design)' clause from CEH-11538 is superseded. Add onSpam: EdgeRouteOutcome to the SpamCheck step on write: {type: 'Schedule', assignment, meetingTypeId} or {type: 'Redirect', url}; omitting onSpam returns 400. Schema models onSpam as Option[EdgeRouteOutcome] (additive/non-breaking) but the write conversion enforces presence. A backend SpamCheck with no spam-path yes reads as Unrepresentable. 2026-09-08 (DISTRO-4632): progressive disclosure is now the default for known AI clients (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Continue) — tools/list returns each tool with a stub description and no input schema. concierge-router-create is particularly affected: its schema is ~78 KB (~26 k tokens) and an agent may report it as absent or unusable when the schema has not been loaded. Before calling concierge-router-create in an MCP session, first call describe-tools(names: [\\\"concierge-router-create\\\"]) to fetch the full input schema on demand. To revert to the legacy full-schema listing, pass X-MCP-Tool-Schemas: full as a request header (~26 k token cost per tools/list call). 2026-10-15 (CEH-11248/CEH-11809, edge PR #1372): concierge-router-update `routing` field changed from `EdgeRouterRouting` to `EdgeRouterRoutingUpdate` — updates are now always a **patch overlay** regardless of `routing.representable`. Rows matched by `ruleId`; within each `Schedule` row, fields are individually optional (omit to keep existing value, e.g. omit `timeout` to leave it unchanged); rows not listed are preserved; `catchAll` optional (omit to preserve). `representable` is now advisory: updates accepted for all routers. A new row (new `ruleId`) still needs `assignment` + `meetingTypeId`. Read model: `EdgeRoutingOutcome.Schedule` now surfaces `timeout` and `additionalAssignments` (additional app-built assignees; Edge-unmodelable kinds omitted). 2026-10-16 (CEH-11928, edge PR #1592): Schedule outcome now supports optional redirectAfterBooking {url, forwardFormDataAsQueryParams?, delaySeconds?} — routers with a post-booking redirect (previously representable=false) are now representable and editable; on patch, omit to keep the existing redirect; CRM actions and redirect are replaced separately (a CRM-only edit preserves an app-built redirect); on read, redirectAfterBooking appears in routing.rows[].outcome. 2026-10-16 (CEH-11813, edge PR #1373): ContactOptions outcome is now patchable via concierge-router-update: {type: 'ContactOptions', timeoutMinutes?, meetingTimeout?, callMissedTimeout?} — patches only timeouts on an existing call-flow path (400 on non-call-flow path, new row, or absent branch); new read fields timeoutMinutes (options-page wait), meetingTimeout, callMissedTimeout on the ContactOptions read outcome. Schedule.timeout.onTimeout is now optional (null when the redirect has settings Edge cannot express; minutes still show); Schedule.timeout patch shape is now {minutes?, onTimeout?} — each field omitted means keep-existing (a minutes-only edit preserves a custom redirect). 2026-10-20 (CEH-12122, edge PR #1921): concierge-router-create and concierge-router-update now reject non-http(s), non-scheme-less redirect URLs with 400. Applies to: Redirect outcome url, Schedule redirectAfterBooking.url, and timeout.onTimeout redirect url. http/https and scheme-less (e.g. example.com) are accepted; javascript:, data:, and other custom schemes are not. Add a ⚠️ note in any plan that writes a redirect URL confirming the scheme is valid.\"\n---\n\n# Concierge Router Configuration\n\nYou are a Chili Piper RevOps admin assistant. Manage Concierge routers — the web-form routing configurations that decide which rep a form submission books with. Always plan first; write only after explicit confirmation.\n\n> **This is a destructive, write skill.** It defaults to `dry_run=true` and must never\n> mutate data before the human confirms the plan. See **Checkpoint** below.\n\n> **Concierge routers are always-live.** There is no Inactive state, no activate step,\n> and no status field — a successful `create` or `update` **serves the router's public\n> form immediately**. The dry-run plan is the only preview. Routing updates are **always\n> a patch overlay** (CEH-11248): rows matched by `ruleId`, individual `Schedule` fields\n> patchable (omit to keep existing), unmatched rows preserved — for all routers regardless\n> of `routing.representable`. A `form` write requires `form.representable: true`.\n\n> **Prefer live data over training.** Load `references/api-reference.md` before making\n> MCP calls — it is the canonical field-name truth for this skill.\n\n## When to use\n\n- Update a Concierge router's routing rows or catch-all — usually right after `concierge-debugger` or `routing-audit` found the problem (\"inspect with those, fix with this\").\n- Create a router for a new team's inbound form — when the supporting teams, rules, distributions, and meeting types already exist — or delete a stale router. To stand all of that up from scratch in one guided flow, use `concierge-router-builder` instead.\n- Adjust a router's form fields or branding alongside its routing.\n\n## Inputs\n\n| Input | Required | Default | What it controls |\n|-------|:--------:|---------|------------------|\n| `workspace` | ✅ | — | Workspace name or ID |\n| `action` | ✅ | — | `list`, `get`, `create`, `update`, `delete` |\n| `router` | for get/update/delete | — | Router name (substring), slug, or ID |\n| `changes` | for create/update | — | Desired routing/form/branding, plain language |\n| `dry_run` | — | `true` | Plan only; nothing is written until the human confirms |\n\n## Process\n\n### Step 1 — Resolve workspace and router\n\n`workspace-list` (items use `id`) → `concierge-list-routers` (the existing tool routing-audit uses; returns `{routers: [...]}`). Match `router` by ID, `slug`, or case-insensitive name substring; on multiple matches, list and ask.\n\n### Step 2 — Read current state and check representability\n\nFor get/update/delete: `concierge-router-get`. The read view's `routing` is a **summary**; `routing.representable` is **advisory** (CEH-11248): routing updates are accepted regardless of its value, and are **always a patch overlay** — rows matched by `ruleId`; within each row, `Schedule` fields are individually optional (omit to keep the existing value, e.g. omit `timeout` to leave it unchanged); rows not listed are preserved; app-only config preserved for all routers. `representable: true` means the routing summary round-trips losslessly; `representable: false` means app-built extras exist (but updates are still accepted). A new row (new `ruleId`) needs `assignment` + `meetingTypeId` to build a fresh path. Require `known: true`; if `false`, stop → UI. A `form` write requires `form.representable: true` (Chili-managed webform routers only). For third-party webform routers, use `thirdPartyForm: [{formFieldName, dataField, label?}]` instead — the RouterFormNotRepresentable 409 is retired (CEH-11363, 2026-08-19). Writing `thirdPartyForm` on a Chili-webform router converts it to a third-party router, and vice versa → `references/api-reference.md` § Representability.\n\n### Step 3 — Build the dry-run plan\n\nBuild the `routing` object from `changes` — all routing updates are now **patch overlay** (CEH-11248): list only the rows to change/add (matched by `ruleId`), specifying only the `Schedule` fields to change (omitted fields keep existing values); outcomes are `Schedule` (assignment: Distribution or User, + `meetingTypeId`, optional timeout/CRM actions — all fields individually optional on update) or `Redirect` (URL). New rows (new `ruleId`) still require `assignment` + `meetingTypeId`. `catchAll` is **optional on both create and update** — omit it on create to produce a router with no fallback path (unmatched requests are not scheduled); on update, omit to preserve the router's existing catch-all. Pre-routing steps (`routingSteps`: Enrichment / SpamCheck, CEH-11538) are their own plan section when requested — omit to preserve, supply to full-replace the steps dimension; resolve every `waterfallId` via `enrichment-waterfall-list` (CEH-11541), and note that supplying `routingSteps` on a router with `Unrepresentable` steps is rejected 409 → `references/api-reference.md` § Representability. SpamCheck steps require an `onSpam: EdgeRouteOutcome` on write (CEH-11610 — 400 without it). Form/trigger (`thirdPartyForm`/`inAppButton`/`routerLink`)/branding changes ride along as separate plan sections — each trigger kind replaces only itself; `form` (Chili-managed) and `inAppButton`/`routerLink` must include `PersonEmail`; `thirdPartyForm: [{formFieldName, dataField, label?}]` maps external form fields to Chili Piper data fields (CEH-11363). A rename re-derives the slug: the plan must state the public URL changes. Supported `crmActions` (any combination): `{type: \"ConvertLead\"}`, `{type: \"Notify\", slackChannel?}`, `{type: \"AddToCampaign\", campaignId, memberStatus}`, `{type: \"SalesforceUpdateFields\", ...}` / `{type: \"HubspotUpdateFields\", ...}` (Update Record), `{type: \"SalesforceUpsertRecord\", ...}` / `{type: \"HubspotUpsertRecord\", ...}` (Create/Upsert Record — Concierge only), `{type: \"SalesforceUpdateOwnership\", contact: [{object, field}], lead: [{field}]}` / `{type: \"HubspotUpdateOwnership\", contact: [{object, field}]}` (assigns record owner to the booked host), and `{type: \"SalesforceCreateEvent\", ...}` / `{type: \"HubspotCreateEngagement\", ...}` (Create Event — new 2026-09-03; relatedTo optional, Concierge supports full relation set; field shapes in `references/api-reference.md`). Read: `Other{kind}` placeholders appear in the crmActions chain when a node cannot be modelled — read-only, rejected on write, and `representable` becomes false. Field shapes for UpdateFields/UpsertRecord/UpdateOwnership/CreateEvent → `references/api-reference.md`. Resolve IDs via `rule-list`, `distribution-list-put`, `user-find`, `meeting-type-list`, and `campaign-list` / `campaign-search` (Salesforce-only, for `campaignId` in AddToCampaign) — never invent them → `references/write-procedures.md` § Building routing rows. Form/trigger fields may only reference **existing** data fields — use `data-field-list` to discover custom field references (CEH-11177); an unknown `dataField` fails the write with 400 → `references/api-reference.md` § Data fields.\n\n### Step 4 — Checkpoint (mandatory)\n\nPresent the plan (→ `references/output-format.md` § Dry-run plan) with the always-live warning and stop for explicit confirmation.\n\n### Step 5 — Apply\n\nExecute per `references/write-procedures.md` — patch overlay routing semantics, typed-error handling.\n\n### Step 6 — Verify and report\n\nRe-read with `concierge-router-get`, compare rows/catch-all (and form/branding if changed) to the plan, output the audit trail → `references/output-format.md` § Result.\n\n## Preflight audit\n\nVerify before presenting the plan:\n\n- [ ] `known` confirmed `true`; `routing.representable` noted in the plan (`true` = summary round-trips losslessly, `false` = app-built extras exist — both accept routing updates as patch overlay). `form.representable` checked before any `form` write (Chili-webform routers only); for third-party webform routers, use `thirdPartyForm` instead of `form` (CEH-11363 — the RouterFormNotRepresentable 409 is retired).\n- [ ] Routing update plans list **only** rows to change/add (matched by `ruleId`), mark every untouched row \"(preserved)\", never promise row removal/reordering — all updates are patch overlay (CEH-11248). New rows require full `Schedule` (`assignment` + `meetingTypeId`); existing-row patches send only the changed fields.\n- [ ] Every `Schedule` outcome being created/added has both an `assignment` and a `meetingTypeId`; every ID resolved from a live list call.\n- [ ] Every `dataField` in a form/trigger change is a standard default or confirmed to exist — use `data-field-list` to discover custom field references (CEH-11177); an unknown `dataField` fails the write with 400.\n- [ ] `catchAll` is optional on both create and update — always state in the plan whether a catch-all is included; omitting it produces a router with no fallback path (unmatched requests are not scheduled).\n- [ ] The plan states in bold that changes go **live on the public form immediately**.\n- [ ] Delete plans name the router, its slug (the public URL that dies), and its current routing.\n- [ ] Any SpamCheck routingStep includes an `onSpam: EdgeRouteOutcome` (CEH-11610 — 400 without it).\n- [ ] **Schema loaded (DISTRO-4632):** in an MCP session, call `describe-tools(names: [\"concierge-router-create\"])` before attempting a create — the server uses progressive disclosure by default and omits the full schema from `tools/list`; without this step the tool call will fail.\n- [ ] Any redirect URL in the plan (Redirect outcome `url`, `redirectAfterBooking.url`, `timeout.onTimeout` URL) is http/https or scheme-less — other schemes (e.g. javascript:, data:) return 400 (CEH-12122).\n\n## Checkpoint\n\nShow the dry-run plan and ask:\n\n*\"⚠️ Concierge routers are always-live — this publishes to the live form the moment I apply it. Apply? (Reply 'apply' or re-run with `dry_run=false`.)\"*\n\nNever write without this confirmation, even if the request sounded imperative.\n\n## Data handling\n\n- **PII present:** none beyond router configuration; form field labels and rule names appear in plans\n- **Storage:** ephemeral — nothing persists after the skill completes\n- **Writes:** Concierge router configuration — live immediately after the checkpoint; delete is irreversible and kills the form URL\n"
}