ak_hook_fire
Fire a single UMSF event for real-time knowledge capture, wrapping it in a one-event document and dispatching through the hook system. For multi-event submissions, use ak_ingest_umsf.
Instructions
Fire a single UMSF event for real-time knowledge capture. The event is wrapped in a one-event UMSFDocument and dispatched through the hook system. For multi-event submissions, use ak_ingest_umsf.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | For 'tool_use' events: structured tool arguments. | |
| name | No | For 'tool_use' events: tool name. For 'error' events: failing tool. | |
| path | No | For 'file_change' events: filesystem path. | |
| role | No | For 'message' events: user / assistant / system / tool. | |
| type | Yes | UMSF event type: message, tool_use, tool_result, decision, file_change, error, session_start, session_end. | |
| agent | No | Agent identifier (claude-code / codex / hermes / external). | external |
| error | No | For 'error' events: error message. | |
| result | No | For 'tool_result' events: stringified tool output. | |
| content | No | Message body / decision text / error description. | |
| metadata | No | Free-form metadata (e.g. session_end events may pass {messages: [...]}). | |
| session_id | No | Session identifier (optional). |