Claude Agent SDK adds action blocking for configured hook failures

By OpenTools Team

The matcher setting can stop an action; a stream warning reports that a callback failed.

Choose whether hook failure stops work

Version 0.3.317, released November 2 Toronto time, adds onFailure to hook matchers. With "block", a callback that throws or supplies invalid output stops the action.

Hosts can make callback failure prevent the pending action, instead of treating failure only as something to report. The notes do not specify the default.

Warnings answer a separate question

The same release adds a stream warning when a hook callback fails. The warning reports failure; the matcher setting determines the blocking behavior. Receiving a notice does not itself establish that an action was stopped.

For broader design questions, OpenTools’ systems reference covers authority and observability. It does not document this SDK option.

Coding workstation, March 2012; archive context, not a Claude Agent SDK session or execution test. Photo: @matylda / hackNY / Wikimedia Commons, CC BY‑SA 2.0. Resized and cropped under the same licence.

Sources

1.Wikimedia Commons (commons.wikimedia.org)
2.CC BY-SA 2.0 (creativecommons.org)
3.github.com (github.com)

Claude Agent SDK adds action blocking for configured hook failures

By OpenTools Team

The matcher setting can stop an action; a stream warning reports that a callback failed.

Choose whether hook failure stops work

Version 0.3.317, released November 2 Toronto time, adds onFailure to hook matchers. With "block", a callback that throws or supplies invalid output stops the action.

Hosts can make callback failure prevent the pending action, instead of treating failure only as something to report. The notes do not specify the default.

Warnings answer a separate question

The same release adds a stream warning when a hook callback fails. The warning reports failure; the matcher setting determines the blocking behavior. Receiving a notice does not itself establish that an action was stopped.

For broader design questions, OpenTools’ systems reference covers authority and observability. It does not document this SDK option.

Coding workstation, March 2012; archive context, not a Claude Agent SDK session or execution test. Photo: @matylda / hackNY / Wikimedia Commons, CC BY‑SA 2.0. Resized and cropped under the same licence.

Sources

1.Wikimedia Commons (commons.wikimedia.org)
2.CC BY-SA 2.0 (creativecommons.org)
3.github.com (github.com)

Share this article

Claude Agent SDK adds action blocking for configured hook failures

Choose whether hook failure stops work

Warnings answer a separate question

Sources

Tags

Claude Agent SDK adds action blocking for configured hook failures

Choose whether hook failure stops work

Warnings answer a separate question

Sources

Tags