claude-code - 💡(How to fix) Fix Agent hook type fails: Messages are required for agent hooks [1 comments, 2 participants]

PostToolUse hook with type agent fails with error: Failed to run: Messages are required for agent hooks. Config uses prompt field as required by schema. Runtime rejects it anyway.

TL;DR

The PostToolUse hook with type agent may require a messages field instead of or in addition to the prompt field to resolve the error.

Guidance

• Verify the schema requirements for the PostToolUse hook with type agent to confirm if both prompt and messages fields are necessary.
• Check the runtime configuration to ensure it aligns with the schema and that the messages field is properly formatted and included.
• Consider adding a messages field to the hook configuration, even if the schema suggests prompt is sufficient, to see if this resolves the runtime error.
• Review any recent changes to the schema or runtime environment that might have introduced this discrepancy.

Example

No code snippet can be provided without more context on the schema and configuration format.

Notes

The issue seems to stem from a mismatch between the schema requirements and the runtime expectations. Without more details on the schema and configuration, it's challenging to provide a definitive fix.

Recommendation

Apply workaround: Add a messages field to the PostToolUse hook configuration to align with the runtime's apparent requirements, as this seems to be the most direct path to resolving the error.