תיעוד 7
# אירועים
#אירועים
| אירוע | מתי הוא נורה |
|---|---|
SessionStart, SessionEnd | סשן מתחיל או מסתיים |
UserPromptSubmit | שולחים הנחיה |
PreToolUse | כלי עומד לרוץ: זה האירוע החוסם היחיד |
PostToolUse, PostToolUseFailure | כלי מסתיים או נכשל |
PermissionDenied | מערכת ההרשאות דוחה קריאת כלי |
Stop, StopFailure | תור מסתיים, או מסתיים עם שגיאת API |
Notification | הסוכן שולח התראה |
SubagentStart, SubagentStop | סוכן משנה מתחיל או מסיים |
PreCompact, PostCompact | רצה דחיסת שיחה |
#חוזה הסקריפט
האירוע מגיע כ-JSON ב-stdin, כולל hookEventName, sessionId, cwd, workspaceRoot, ובאירועי כלים גם toolName ו-toolInput. כל תהליך הוק מקבל גם GROK_HOOK_EVENT, GROK_HOOK_NAME, GROK_SESSION_ID ו-GROK_WORKSPACE_ROOT במשתני הסביבה שלו.
הוק PreToolUse מחליט על ידי כתיבת JSON ל-stdout: