DSH familySearch GitHub

Seam

tools/pre-execute

8 hook, and every one of them rewrites what passes here or advises on it.

Harness

The harness dispatches this seam as a waterfall, and it already has listeners here. The family adds its hooks beside them.

It carries the tool call the model asked for.

Payload
the call, with allow, deny, or ask
Power
A listener may replace what it passes on.
Declared
packages/core/tools/src/events.ts:18
  • auto-review
  • hooks-claude-code
  • hooks-codex
  • liveshare
  • tool-jobs
  • workspace-changes

A waterfall listener receives the payload and may return a changed one, so a hook here can rewrite what the model reads next.

Fan

One event, many hands. The same listener list the table below details, drawn as the dispatch it is.

Hook

One row per hook that declares this seam, with the effect it has and the knobs it documents.

Every hook declared on the tools/pre-execute seam
HookEffectWhat it doesConfiguration
hook-dsh-live-containersrewrite armKeeps live, editable blocks in the system prompt28 knob
hook-dsh-tool-coachadvise armTeaches the model to stop reading files through the terminal17 knob
hook-dsh-workspace-governrewriteGates workspace changes before they happen10 knob
hook-dsh-workspace-operateadviseTurns intent into typed proposals: rename, connect, replace8 knob
ets-hook-dsh-live-containersrewrite armKeeps live, editable blocks in the system prompt28 knob
ets-hook-dsh-tool-coachadvise armTeaches the model to stop reading files through the terminal17 knob
ets-hook-dsh-workspace-governrewriteGates workspace changes before they happen10 knob
ets-hook-dsh-workspace-operateadviseTurns intent into typed proposals: rename, connect, replace8 knob

Read

A seam is the harness event a hook listens on, named area/event. This page lists the hooks the repository declares at this seam, one row per hook, with the effect it has and the configuration it documents. A row marked as an arm is a listener the package's source registers here without documenting it in its README.