Inject scoped context at session start

Goal

Explicitly inject application-generated task context instead of relying on implicit global state.

Steps

1. Create a callback returning hookSpecificOutput with hookEventName="SessionStart" and minimal additionalContext. [hooks]
2. Register it through ClaudeAgentOptions(hooks={"SessionStart":[...]}); never inject credentials or unnecessary user data. [hooks]
3. Use a test task to verify the context after initialization and check both new and resumed sessions. [hooks]

How to verify

The agent sees the intended context after init; logs record a context version, not sensitive content.

Troubleshooting

If context is absent, check the hook key and event name; if resumed sessions retain old content, account for session snapshot behavior.