deepseek-harness/packages/webhook/README.md

description, kind

description	kind
Package map for verified external events, programmatic rules, and fire-and-forget DSH Session creation.	package-group

webhook/ — verified external events to DSH Sessions

English | 中文

Summary

The Webhook family receives authenticated provider events and runs trusted programmatic rules. A rule can create an ordinary root Session inside a Web Workspace. Dispatch is process-local and fire-and-forget, with no delivery database, queue, retry, deduplication, or Agent-completion state.

Table of Contents

• Packages
• Related documentation
• Dev Note

---

Packages

Package	Role	ctx key
webhook/	Rule registry, callback lifecycle, and Workspace-backed Session creation	ctx.webhookRuntime
webhook-github/	Signed GitHub HTTP adapter	consumes ctx.webhookRuntime and ctx.webServer

Related documentation

Provider adapters authenticate and normalize deliveries. Rules own arbitrary conditions and external calls, then return null or one Session request. The Webhook subsystem reference owns the shared types and timing guarantees.

Dev Note

None.