Skip to content

deck: add 42 doc-sourced samples - #65

Merged
garethx merged 1 commit into
mainfrom
samples-deck
Oct 16, 2026
Merged

garethx merged 1 commit into
mainfrom
samples-deck

Conversation

@garethx

@garethx garethx commented Oct 16, 2026

Copy link
Copy Markdown
Contributor

New provider: Deck (deck.co, the computer-use agents API). This is the last stage of the add-a-source pipeline. Before it came the core source type (hookdeck/core#5896, still open), the skill (hookdeck/webhook-skills#221), the registry row (hookdeck/webhook-registry#91, with a quote fix in #92), the check record (hookdeck/webhook-registry-checks#19) and the platform guide (hookdeck/website#869).

  • Bodies: 42 complete example deliveries, verbatim from docs.deck.co/events/events-reference, read from the page's Mintlify .md mirror. That page is Deck's only event catalog, and it publishes one complete envelope per event type. None are elided, so all 42 catalog types are covered.
  • Not included: test.ping. It's documented as falling outside the catalog, but Deck publishes only its data ({"ok": true}), never a full envelope. Wrapping that data in an envelope myself would ship a body Deck never published.
  • Topic names: the body's own top-level type, in object.action form (task_run.completed, credential.verified). The harvester refuses any example whose body type disagrees with the event it's documented under, so every file name matches its body.
  • topic_identifier: type. That's a flat body key, so requestReceiver.ts resolves it as-is for future captures. It matches the registry's discriminator_path_lookup.
  • Headers: I synthesized only content-type: application/json. webhook-id, webhook-timestamp and webhook-signature are per-delivery Standard Webhooks values, and the signature is keyed with a secret the customer chooses, so documentation can't supply them.
  • Version: latest. Deck has no webhook version scheme: no version header and no version field in the envelope. The REST API's /v2 versions the endpoint paths, not the payloads.
  • Provenance: latest is sourced_via: docs, sourced_on: 2026-10-16. Each file carries source.type: vendor-documentation and the page URL.

Checklist (SAMPLE-PUBLISHING.md):

  • No displaced captures: there's no existing providers/deck and no scripts/deck harness. Existing files changed: 0.
  • Version directory: latest/, by rule 2. No version scheme exists.
  • topic_identifier: a body path, so header casing doesn't apply. It equals the registry's lookup key.
  • Byte-identical regeneration: I regenerated harvest_deck.py from webhook-registry main (e9501d0) into a scratch tree, and the result is byte-identical to the committed samples-doc/providers/deck and to these files.
  • Compile and tests: yarn compile passes. Providers go from 152 to 153, with 42 deck topics and no collisions. yarn test: 14/14 passed.
  • Registry verify: verify.py on registry main reports FAIL (0).

Evidence and non-assertions are in hookdeck/webhook-registry#91.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
webhook-samples Ready Ready Preview Oct 16, 2026 4:56pm UTC

Request Review

@garethx
garethx merged commit db071d7 into main Oct 16, 2026
3 checks passed
@garethx
garethx deleted the samples-deck branch October 16, 2026 17:01

This branch was successfully deployed

1 active deployment
Preview — 560500d1 Deployed Oct 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant