feat: hooks for Deep Agents Code - #4956
Merged
Johannes du Plessis (johannes117) merged 9 commits intoAug 4, 2026
Merged
Conversation
Document the planned hooks redesign (MVP events, matchers, I/O contract, architecture) while preserving the current fire-and-forget behavior as a clearly labeled interim section. Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions
Bot
added
internal
deepagents
Johannes du Plessis (johannes117)
changed the title
Johannes du Plessis (johannes117)
changed the title
…e-compatible' into docs/deepagents-code-hooks-claude-compatible
Adds the parts of Hooks v2 the draft did not cover: plugin hook consent and path variables, project trust outcomes, the sanitized handler environment, transcript projections, matcher-field constraints, and where hook feedback appears in a session. Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Contributor
|
Pushed the Hooks v2 details the draft did not cover, checked against
One thing to drop when the flag goes away: I added a |
The flag is removed before hooks go live, so the note would ship stale. Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Johannes du Plessis (johannes117)
marked this pull request as ready for review
August 4, 2026 16:45
Contributor
|
Thanks for opening a docs PR, Johannes du Plessis (@johannes117)! When it's ready for review, please add the relevant reviewers:
|
Contributor
|
Mintlify preview branch generated: Site preview: https://langchain-5e9cc07a-preview-docsde-1785862016-990fd26.mintlify.site Important Preview links may take a few minutes to start working while the deployment finishes. Changed documentation pages (preview deep links): |
Alexander Olsen (aolsenjazz)
self-requested a review
August 4, 2026 17:31
Alexander Olsen (aolsenjazz)
approved these changes
Aug 4, 2026
Johannes du Plessis (johannes117)
deleted the
docs/deepagents-code-hooks-claude-compatible
branch
August 4, 2026 19:00
|
|
||
| <ResponseField name="command" type="list[str]" required> | ||
| Command and arguments to run. No shell expansion: use `["bash", "-c", "..."]` if needed. | ||
| Quote these variables in a `command` handler, because installation paths can contain spaces: `"command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/format.sh\""`. An `argv` handler resolves them before launch, which avoids shell quoting entirely. |
Contributor
There was a problem hiding this comment.
this is a bit odd, will update in a separate PR
| <ResponseField name="thread_id" type="string" required> | ||
| The session thread identifier. | ||
| </ResponseField> | ||
| The following compatibility fields are recognized but not applied. Deep Agents Code emits a diagnostic and falls back to the behavior shown: |
Contributor
There was a problem hiding this comment.
what's the behavior shown?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents Hooks v2 as implemented, including lifecycle events, command I/O, project trust, reload behavior, legacy migration, and plugin-contributed hooks.
Updates the Hooks reference and Plugins page to match Deep Agents Code.
Test plan
valeon both changed pagesgit diff --check