Merge staging and preserve canonical documentation schemas

Author: Bill Leoutsakos

.agents/skills/add-block/SKILL.md

@@ -562,6 +562,11 @@ Use `wandConfig` on fields that are hard to fill by hand — timestamps (`genera
 
 ## Tools Configuration
 
+**Write operation ids and tool ids as string literals** in the `operation` dropdown `options` and
+`tools.access`, never through constants (`id: SEARCH`, `access: [SEARCH]`). `scripts/generate-docs.ts`
+reads them from source with regexes, so a constant parses as empty: the docs page loses its whole
+Actions section and the integration catalog ships blank operation descriptions, with no check failing.
+
 **Preferred:** Use tool names directly as dropdown option IDs to avoid switch cases:
 ```typescript
 // Dropdown options use tool IDs directly

apps/docs/content/docs/integrations/ashby.mdx

@@ -1458,6 +1458,15 @@ Lists interview schedules in Ashby, optionally filtered by application or interv
 |   ↳ `status` | string | Schedule status \(NeedsScheduling, WaitingOnCandidateBooking, Scheduled, Complete, Cancelled, OnHold, etc.\) |
 |   ↳ `applicationId` | string | Associated application UUID |
 |   ↳ `interviewStageId` | string | Interview stage UUID |
+|   ↳ `scheduledBy` | object | User summary |
+|     ↳ `id` | string | User UUID |
+|     ↳ `firstName` | string | First name |
+|     ↳ `lastName` | string | Last name |
+|     ↳ `email` | string | Email |
+|     ↳ `globalRole` | string | Role |
+|     ↳ `isEnabled` | boolean | Whether enabled |
+|     ↳ `updatedAt` | string | Last update timestamp |
+|     ↳ `managerId` | string | User ID of the user's manager |
 |   ↳ `createdAt` | string | ISO 8601 creation timestamp |
 |   ↳ `updatedAt` | string | ISO 8601 last update timestamp |
 |   ↳ `interviewEvents` | array | Scheduled interview events on this schedule |
@@ -2004,12 +2013,7 @@ Sets several custom field values on one Ashby Application, Candidate, Job, or Op
 
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
-| `customFields` | array | The custom fields as stored on the object after the write |
-|   ↳ `id` | string | Custom field UUID |
-|   ↳ `title` | string | Field title |
-|   ↳ `isPrivate` | boolean | Whether the field is private |
-|   ↳ `valueLabel` | json | Human-readable value label, present only for ValueSelect and MultiValueSelect fields. A string for ValueSelect, an array of strings for MultiValueSelect. |
-|   ↳ `value` | string | Raw field value \(type depends on fieldType\) |
+| `customFields` | array | Custom field values |
 
 ### Ashby Update Candidate
 

apps/docs/content/docs/integrations/coda.mdx

@@ -409,6 +409,10 @@ Get the type and current value of a control in a Coda doc
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
 | `control` | object | Control details |
+|   ↳ `id` | string | ID |
+|   ↳ `name` | string | Name |
+|   ↳ `href` | string | API link |
+|   ↳ `parent` | object (nullable) | Page containing the item |
 |   ↳ `controlType` | string (nullable) | Control type \(aiBlock, button, checkbox, datePicker, dateRangePicker, dateTimePicker, lookup, multiselect, select, scale, slider, reaction, textbox, timePicker\) |
 |   ↳ `value` | json (nullable) | Current value \(string, number, boolean, or array of these\) |
 
@@ -496,6 +500,10 @@ Get the current computed value of a named formula in a Coda doc
 | Parameter | Type | Description |
 | --------- | ---- | ----------- |
 | `formula` | object | Formula details |
+|   ↳ `id` | string | ID |
+|   ↳ `name` | string | Name |
+|   ↳ `href` | string | API link |
+|   ↳ `parent` | object (nullable) | Page containing the item |
 |   ↳ `value` | json (nullable) | Computed value \(string, number, boolean, or array of these\) |
 
 ### Coda Get Mutation Status
@@ -738,6 +746,13 @@ Get per-day or cumulative analytics (views, copies, likes, sessions by device, A
 | --------- | ---- | ----------- |
 | `items` | array | Analytics per doc |
 |   ↳ `doc` | object | Doc the metrics belong to |
+|     ↳ `id` | string | Doc ID |
+|     ↳ `title` | string | Doc title |
+|     ↳ `href` | string | API link to the doc |
+|     ↳ `browserLink` | string | Browser link to the doc |
+|     ↳ `icon` | object (nullable) | Doc icon |
+|     ↳ `createdAt` | string (nullable) | Doc creation time |
+|     ↳ `publishedAt` | string (nullable) | Doc publish time |
 |   ↳ `metrics` | array | Metrics per date |
 |     ↳ `date` | string (nullable) | Date of the data \(YYYY-MM-DD\) |
 |     ↳ `views` | number (nullable) | Doc views |
@@ -856,6 +871,9 @@ Get daily analytics (views, sessions, users, time viewed) for each page of a Cod
 | --------- | ---- | ----------- |
 | `items` | array | Analytics per page |
 |   ↳ `page` | object | Page the metrics belong to |
+|     ↳ `id` | string | Page ID |
+|     ↳ `name` | string | Page name |
+|     ↳ `icon` | object (nullable) | Page icon |
 |   ↳ `metrics` | array | Metrics per date |
 |     ↳ `date` | string (nullable) | Date of the data \(YYYY-MM-DD\) |
 |     ↳ `views` | number (nullable) | Page views that day |

apps/docs/content/docs/integrations/confluence.mdx

@@ -49,8 +49,9 @@ Retrieve content from Confluence pages using the Confluence API.
 | `createdAt` | string | ISO 8601 timestamp when the page was created |
 | `url` | string | URL to view the page in Confluence |
 | `body` | object | Raw page body content in storage format |
-|   ↳ `value` | string | The content value in the specified format |
-|   ↳ `representation` | string | Content representation type |
+|   ↳ `storage` | object | Body in storage format \(Confluence markup\) |
+|     ↳ `value` | string | The content value in the specified format |
+|     ↳ `representation` | string | Content representation type |
 | `version` | object | Page version information |
 |   ↳ `number` | number | Version number |
 |   ↳ `message` | string | Version message |
@@ -319,8 +320,9 @@ Get details about a specific version of a Confluence page.
 |   ↳ `prevVersion` | number | Previous version number |
 |   ↳ `nextVersion` | number | Next version number |
 | `body` | object | Raw page body content in storage format at this version |
-|   ↳ `value` | string | The content value in the specified format |
-|   ↳ `representation` | string | Content representation type |
+|   ↳ `storage` | object | Body in storage format \(Confluence markup\) |
+|     ↳ `value` | string | The content value in the specified format |
+|     ↳ `representation` | string | Content representation type |
 
 ### Confluence List Page Properties
 

apps/docs/content/docs/integrations/context_dev.mdx

@@ -56,6 +56,8 @@ Scrape any URL and return clean, LLM-ready markdown content.
 | --------- | ---- | ----------- |
 | `markdown` | string | Page content as clean markdown |
 | `url` | string | The scraped URL |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Scrape HTML
 
@@ -80,6 +82,8 @@ Scrape any URL and return the raw HTML content of the page.
 | `html` | string | Raw HTML content of the page |
 | `url` | string | The scraped URL |
 | `type` | string | Detected content type \(html, xml, json, text, csv, markdown, svg, pdf, doc, docx\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Scrape Images
 
@@ -110,6 +114,8 @@ Discover every image asset on a page, with optional dimension and type enrichmen
 |   ↳ `alt` | string | Alt text |
 |   ↳ `enrichment` | json | Optional enrichment \(width, height, mimetype, url, type\) when requested |
 | `url` | string | The scraped URL |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Screenshot
 
@@ -139,6 +145,8 @@ Capture a screenshot of any web page and store it as a downloadable image file.
 | `domain` | string | Domain that was captured |
 | `width` | number | Screenshot width in pixels |
 | `height` | number | Screenshot height in pixels |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Crawl
 
@@ -170,6 +178,8 @@ Crawl an entire website and return each discovered page as clean markdown.
 |   ↳ `markdown` | string | Page content as markdown |
 |   ↳ `metadata` | json | Page metadata \(url, title, crawlDepth, statusCode\) |
 | `metadata` | object | Crawl summary \(numUrls, maxCrawlDepth, numSucceeded, numFailed, numSkipped\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Map
 
@@ -192,6 +202,8 @@ Build a sitemap of a domain and return every discovered page URL.
 | `domain` | string | The domain that was mapped |
 | `urls` | array | All page URLs discovered from the sitemap |
 | `meta` | object | Sitemap discovery stats \(sitemapsDiscovered, sitemapsFetched, sitemapsSkipped, errors\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Search
 
@@ -223,6 +235,8 @@ Search the web with natural language and optionally scrape results to markdown.
 |   ↳ `relevance` | string | Relevance rating \(high, medium, low\) |
 |   ↳ `markdown` | json | Scraped markdown for the result \(when markdown scraping is enabled\) |
 | `query` | string | The query that was searched |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Extract
 
@@ -253,6 +267,8 @@ Crawl a website and extract structured data matching a provided JSON schema.
 | `urlsAnalyzed` | array | URLs that were analyzed during extraction |
 | `data` | json | Structured data matching the requested schema |
 | `metadata` | object | Crawl summary \(numUrls, maxCrawlDepth, numSucceeded, numFailed, numSkipped\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Extract Product
 
@@ -288,6 +304,8 @@ Detect and extract structured product details from a single product page URL.
 |   ↳ `image_url` | string | Primary product image URL |
 |   ↳ `images` | json | Product image URLs |
 |   ↳ `sku` | string | Product SKU |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Extract Products
 
@@ -322,6 +340,8 @@ Extract the product catalog from a brand's website by domain (beta).
 |   ↳ `image_url` | string | Primary product image URL |
 |   ↳ `images` | json | Product image URLs |
 |   ↳ `sku` | string | Product SKU |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Scrape Fonts
 
@@ -351,6 +371,8 @@ Extract the font families, usage stats, and font files used by a domain.
 |   ↳ `percent_words` | number | Percent of words using the font |
 |   ↳ `percent_elements` | number | Percent of elements using the font |
 | `fontLinks` | json | Font family download links keyed by font name \(type, files, category\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Scrape Styleguide
 
@@ -372,6 +394,8 @@ Extract a domain's design system: colors, typography, spacing, shadows, and UI c
 | `status` | string | Extraction status |
 | `domain` | string | The domain that was analyzed |
 | `styleguide` | json | Design system: mode, colors, typography, elementSpacing, shadows, fontLinks, components |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Classify NAICS
 
@@ -398,6 +422,8 @@ Classify a brand into NAICS industry codes from its domain or company name.
 |   ↳ `code` | string | Industry code |
 |   ↳ `name` | string | Industry name |
 |   ↳ `confidence` | string | Match confidence \(high, medium, low\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Classify SIC
 
@@ -429,6 +455,8 @@ Classify a brand into SIC industry codes from its domain or company name.
 |   ↳ `majorGroup` | string | Major group code \(original_sic only\) |
 |   ↳ `majorGroupName` | string | Major group name \(original_sic only\) |
 |   ↳ `office` | string | SEC office \(latest_sec only\) |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Get Brand
 
@@ -467,6 +495,8 @@ Retrieve brand data for a domain: logos, colors, backdrops, socials, address, an
 |   ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
 |   ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
 |   ↳ `primary_language` | string | Primary language of the brand site |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Get Brand by Name
 
@@ -506,6 +536,8 @@ Retrieve brand data by company name: logos, colors, socials, address, and indust
 |   ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
 |   ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
 |   ↳ `primary_language` | string | Primary language of the brand site |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Get Brand by Email
 
@@ -544,6 +576,8 @@ Retrieve brand data from a work email address. Free/disposable emails are reject
 |   ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
 |   ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
 |   ↳ `primary_language` | string | Primary language of the brand site |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Get Brand by Ticker
 
@@ -583,6 +617,8 @@ Retrieve brand data for a public company by its stock ticker symbol.
 |   ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
 |   ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
 |   ↳ `primary_language` | string | Primary language of the brand site |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |
 
 ### Context.dev Identify Transaction
 
@@ -625,3 +661,5 @@ Identify the brand behind a raw bank/card transaction descriptor and return its
 |   ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
 |   ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
 |   ↳ `primary_language` | string | Primary language of the brand site |
+| `creditsConsumed` | number | Credits consumed by this request |
+| `creditsRemaining` | number | Credits remaining on the API key |