Sitelet https://github.com/hookdeck/hookdeck-cli/pull/348/commits/13030238034b0e19af43fbb75a8d11f954b7e467
Skip to content
Closed
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
76 commits
Select commit Hold shift + click to select a range
2d8f9d9
feat(outpost): add Outpost API client, schema cache and live tests
leggetter Aug 14, 2026
85ba39c
feat(outpost): add outpost command group and tenant commands
leggetter Aug 14, 2026
a38bfe8
feat(outpost): add destination commands
leggetter Aug 14, 2026
9fce42b
feat(outpost): add destination-type commands and per-type dynamic help
leggetter Aug 14, 2026
ea4ee42
feat(outpost): support dotted paths in --config and --credential
leggetter Aug 14, 2026
000cd7f
feat(outpost): add event, attempt, publish, topic, metrics, config an…
leggetter Aug 14, 2026
c235fd5
test(outpost): add acceptance suite and CI slice
leggetter Aug 14, 2026
1303023
docs(outpost): add REFERENCE.md and README sections
leggetter Aug 14, 2026
640b00f
test(outpost): cover event get, attempt get, tenant token and retry
leggetter Aug 14, 2026
b09cda9
Update package.json version to 2.6.0-beta.1
github-actions[bot] Aug 14, 2026
9445c8a
refactor(mcp): extract product-agnostic MCP server into pkg/mcpcore
leggetter Aug 14, 2026
536935d
feat(outpost): add an MCP server for AI agent access
leggetter Aug 14, 2026
2914526
refactor(mcp): keep login and projects on the hookdeck_ prefix in eve…
leggetter Aug 14, 2026
bf22092
Merge remote-tracking branch 'origin/main' into integrate/outpost-mcp
leggetter Aug 14, 2026
2b4ec87
Merge remote-tracking branch 'origin/main' into feat/outpost-api-client
leggetter Aug 14, 2026
e7cf41a
fix(mcp): resolve project names, and scope the publish credential
leggetter Aug 14, 2026
eb6ca42
docs: regenerate REFERENCE.md for the publish-api-key rename
leggetter Aug 14, 2026
1868d69
fix(outpost): stop publish silently going to the wrong project
leggetter Aug 14, 2026
3b48ac6
test(outpost): update MCP acceptance test for the platform tool prefix
leggetter Aug 17, 2026
f1e1923
Merge remote-tracking branch 'origin/integrate/outpost-mcp' into feat…
leggetter Aug 17, 2026
da683e3
Update package.json version to 2.6.0-beta.2
github-actions[bot] Aug 17, 2026
f16f1a0
refactor(mcp): lift the write-gating machinery into mcpcore
leggetter Aug 19, 2026
29ee04d
feat(gateway mcp): add write mode behind --allow-write, rename tools …
leggetter Aug 19, 2026
3a2b4a5
test(gateway mcp): cover the write-mode gate, and document it
leggetter Aug 19, 2026
0317f11
test(outpost): prove every MCP action with a successful call
leggetter Aug 19, 2026
ff7e3b2
feat(outpost): add --metadata to destination create and update
leggetter Aug 19, 2026
c065c77
fix(outpost): make API errors readable, and cover the portal and cust…
leggetter Aug 19, 2026
d2d0b91
ci(outpost): run the live smoke test nightly instead of never
leggetter Aug 19, 2026
db63434
fix(outpost): break the project-switch loop on the first-run path
leggetter Aug 19, 2026
0506c0c
test(outpost): keep the custom-domain test from colliding with a para…
leggetter Aug 19, 2026
e536308
fix(gateway mcp): treat transformations run as a read, not a write
leggetter Aug 19, 2026
c18a1d7
test(gateway mcp): call every tool action successfully at least once
leggetter Aug 19, 2026
38e12ee
test(outpost): stop the portal test assuming propagation is stable
leggetter Aug 19, 2026
a965637
Merge Gateway MCP write mode and the gateway_ tool rename into v3.0.0
leggetter Aug 19, 2026
0eb550b
Update package.json version to 3.0.0-pin-pre-tool-shape-review
github-actions[bot] Aug 19, 2026
cd58f8b
ci: pass the CLI key to acceptance runs so project tests stop skipping
leggetter Aug 19, 2026
e0f090d
feat(gateway mcp)!: split events and requests into plural search and …
leggetter Aug 19, 2026
1ef3e21
docs(mcp): document the events/requests plural-singular split
leggetter Aug 19, 2026
eda57f9
revert: restore the package.json version after an accidental release
leggetter Aug 20, 2026
2ca2cdb
feat(gateway): add the missing documented query filters to events and…
leggetter Aug 20, 2026
689d698
fix(mcp): stop numeric filters being dropped when sent as JSON numbers
leggetter Aug 20, 2026
f8c59a5
fix(api): reject identifiers that would retarget a request
leggetter Aug 20, 2026
26ffa5b
fix(cmd): stop --help printing the API key from the environment
leggetter Aug 20, 2026
9cdb193
fix(mcp): stop boolean and numeric filters being dropped when quoted
leggetter Aug 20, 2026
e78bdbf
fix(mcp): name the login tool and publish key that actually exist
leggetter Aug 20, 2026
731d38b
fix(outpost): allow partial destination updates
leggetter Aug 20, 2026
f34a8cd
fix(mcp): send topics when creating an Outpost destination
leggetter Aug 20, 2026
05003ee
fix(mcp): stop a tool offering pause claiming to be a pure read
leggetter Aug 20, 2026
f2de696
fix(mcp): do not sign the user out when a reauth is never completed
leggetter Aug 20, 2026
deabb51
test(listen): capture subprocess output so a failure says why
leggetter Aug 20, 2026
77fb794
test(listen): run a built binary instead of go run
leggetter Aug 20, 2026
f929ff5
refactor(mcp): remove the unused ToolSpec.DefaultAction field
leggetter Aug 20, 2026
68f773a
chore: set the package version to the 3.0.0 line
leggetter Aug 20, 2026
738e61d
docs(search): say that search_term matches a whole value, not a subst…
leggetter Aug 20, 2026
61ca177
fix(outpost): send the schema's declared defaults when creating a des…
leggetter Aug 20, 2026
6c16792
fix(events): report the status the API returned, not the one requested
leggetter Aug 20, 2026
94a4c08
fix(transformations): report a run that failed instead of an empty re…
leggetter Aug 20, 2026
0103488
fix(mcp): hide write-only prose and properties in read-only mode
leggetter Aug 20, 2026
dbd7948
docs(outpost): record why webhook secrets are readable and others are…
leggetter Aug 20, 2026
8176987
docs(filters): stop claiming count filters accept operator syntax
leggetter Aug 20, 2026
0fece55
fix(outpost): refuse to publish to a tenant the credential cannot see
leggetter Aug 20, 2026
dd15126
fix(mcp): reject arguments a tool does not have, and honour "id or name"
leggetter Aug 20, 2026
303996f
feat(mcp): make the plural/singular split recoverable when an agent g…
leggetter Aug 20, 2026
7afc68f
fix(help): stop pointing users at things that cannot help them
leggetter Aug 20, 2026
60c108a
test(events): stop asserting that a no-op reports success
leggetter Aug 20, 2026
f37253d
docs(mcp): say which test fails if a deliberate choice is "fixed"
leggetter Aug 21, 2026
dda6646
fix(mcp): close three read-only leaks found in review
leggetter Aug 21, 2026
14c0cb6
test(acceptance): stop the suite leaking sources and destinations
leggetter Aug 21, 2026
66168a0
fix: report the state the API returned, not the one that was asked for
leggetter Aug 21, 2026
a734bf4
docs: add a manual QA skill with a credential guard
leggetter Aug 21, 2026
ccfb191
fix: reject MCP argument values the tool cannot use
leggetter Aug 21, 2026
411b70c
docs: say that an upsert with no metadata clears it
leggetter Aug 21, 2026
9581891
test(acceptance): run the outpost slice locally and report each slice
leggetter Aug 21, 2026
78f7b7b
fix: stop update commands discarding the values they were given
leggetter Aug 21, 2026
7dae336
fix(mcp): stop write mode reopening the filter-that-does-not-filter hole
leggetter Aug 21, 2026
a81ce5b
fix: report what a request retry actually did, and what a dismiss cha…
leggetter Aug 21, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs(outpost): add REFERENCE.md and README sections
Adds the generated REFERENCE.md block for the outpost command tree, a README
section, and the publish key exception to AGENTS.md.

The generator's table of contents is a hand-maintained list rather than being
derived from headings, so Outpost was added there — along with Metrics, which
had been missing since it was introduced.

Both docs lead with the two things that are genuinely surprising: config and
credential fields are key=value pairs because they belong to the Outpost
deployment rather than the CLI, and publish needs a Project API key because it
is the one command that does not accept the credentials `hookdeck login`
stores.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_01Wajsob136PyRh6nc92w5L3
  • Loading branch information
leggetter and claude committed Aug 14, 2026
commit 13030238034b0e19af43fbb75a8d11f954b7e467
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -579,6 +579,8 @@ Summary for code and docs work:
- **Guest** — `listen` without login may call `POST /cli/guest`; separate from `--cli-key` onboarding.
- **`project list`** — Requires a user-associated CLI client key (`hookdeck login` or `hookdeck login --cli-key`). CI keys from `hookdeck ci` and raw Project API keys cannot list or switch projects (acceptance: `HOOKDECK_CLI_TESTING_CLI_KEY`).

- **`outpost publish`** — The publish API requires a **Project API key** sent as a bearer token and does not accept the CLI client key stored by `hookdeck login`. It therefore has its own `--api-key` flag defaulting to `HOOKDECK_API_KEY`, in the same shape as `hookdeck ci --api-key`. Every other `hookdeck outpost` command uses the stored credentials normally. When the key is missing the command fails with its own guidance rather than a bare 401, which the generic handler would otherwise rewrite into "your API key is invalid or expired" — accurate but useless here, since the stored key is never valid for this endpoint.

### Diagnosing a key before you debug anything else

The config file cannot tell you which credential you hold — `api_key` is the field name for every CLI client key regardless of origin. When a command fails with a permission or project error, establish the key's scope first:
Expand Down
58 changes: 58 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ For a complete reference of all commands and flags, see [REFERENCE.md](REFERENCE
- [Running in CI](#running-in-ci)
- [Event Gateway](#event-gateway)
- [Event Gateway MCP](#event-gateway-mcp)
- [Outpost](#outpost)
- [Manage connections](#manage-connections)
- [Transformations](#transformations)
- [Requests, events, and attempts](#requests-events-and-attempts)
Expand Down Expand Up @@ -663,6 +664,63 @@ Once the MCP server is configured, you can ask your agent questions like:
→ Agent uses hookdeck_events list with status FAILED and last_attempt_after set to yesterday's ISO datetime.
```

### Outpost

Manage [Hookdeck Outpost](https://hookdeck.com/docs/outpost) — your users (tenants), the destinations they own, and the events delivered to them.

These commands require an Outpost project. Switch with `hookdeck project use`; pointing them at an Event Gateway project reports which type the project is rather than failing obscurely.

```sh
hookdeck outpost [command]

# Available commands
hookdeck outpost tenant # Manage tenants
hookdeck outpost destination # Manage a tenant's destinations
hookdeck outpost destination-type # Inspect available destination types and their fields
hookdeck outpost event # Inspect published events, and retry delivery
hookdeck outpost attempt # Inspect delivery attempts
hookdeck outpost publish # Publish an event
hookdeck outpost topic # Inspect available topics
hookdeck outpost metrics # Query aggregate metrics
hookdeck outpost config # Manage project configuration and the portal domain
hookdeck outpost status # Show the deployment status
```

#### Destination config

Config and credential fields differ per destination type, and are defined by the Outpost deployment rather than the CLI, so they are passed as repeatable `key=value` pairs:

```sh
hookdeck outpost tenant upsert acme

hookdeck outpost destination create --tenant-id acme --type webhook \
--config url=https://example.com/hooks --topics user.created
```

To find out what a type accepts, either ask for it directly or add `--type` to `--help`:

```sh
hookdeck outpost destination-type get kafka
hookdeck outpost destination create --type kafka --help
```

Both list every field with whether it is required, whether it is sensitive, and any values or format it is constrained to. `--config-file` accepts a JSON object, and nested values — should a type ever need them — use dotted paths (`--config a.b=c`).

#### Publishing

`hookdeck outpost publish` is the one command that does **not** use the credentials stored by `hookdeck login`. The publish API requires a Hookdeck **Project API key**, so pass `--api-key` or set `HOOKDECK_API_KEY`:

```sh
hookdeck outpost publish --tenant-id acme --topic user.created \
--data '{"user_id":"123"}' --api-key $HOOKDECK_API_KEY
```

Create a Project API key in the Hookdeck dashboard under your project's settings. See [CLI authentication keys](#cli-authentication-keys) for how the key types differ.

Publishing is asynchronous: a successful response means the event was accepted, not delivered. Use `hookdeck outpost attempt list` to see the outcome.

For complete command and flag reference, see [REFERENCE.md](REFERENCE.md).

### Manage connections

Create and manage webhook connections between sources and destinations with inline resource creation, authentication, processing rules, and lifecycle management. Use `hookdeck gateway connection` (or the backward-compatible alias `hookdeck connection`). For detailed examples with authentication, filters, retry rules, and rate limiting, see the complete [connection management](#manage-connections) section below.
Expand Down
Loading
Loading