Add SDK usage examples

12 examples showing increasing levels of customization:
- 01-minimal: all defaults
- 02-custom-model: model and thinking level
- 03-custom-prompt: replace or modify prompt
- 04-skills: discover, filter, merge skills
- 05-tools: built-in tools, custom tools
- 06-hooks: logging, blocking, result modification
- 07-context-files: AGENTS.md files
- 08-slash-commands: file-based commands
- 09-api-keys-and-oauth: API key resolution, OAuth config
- 10-settings: compaction, retry, terminal settings
- 11-sessions: persistence options
- 12-full-control: replace everything

Also exports FileSlashCommand type from index.ts

packages/coding-agent/examples/sdk/06-hooks.ts

@@ -0,0 +1,61 @@
+/**
+ * Hooks Configuration
+ *
+ * Hooks intercept agent events for logging, blocking, or modification.
+ */
+
+import { createAgentSession, discoverHooks, SessionManager, type HookFactory } from "../../src/index.js";
+
+// Logging hook
+const loggingHook: HookFactory = (api) => {
+	api.on("agent_start", async () => {
+		console.log("[Hook] Agent starting");
+	});
+
+	api.on("tool_call", async (event) => {
+		console.log(`[Hook] Tool: ${event.toolName}`);
+		return undefined; // Don't block
+	});
+
+	api.on("agent_end", async (event) => {
+		console.log(`[Hook] Done, ${event.messages.length} messages`);
+	});
+};
+
+// Blocking hook (returns { block: true, reason: "..." })
+const safetyHook: HookFactory = (api) => {
+	api.on("tool_call", async (event) => {
+		if (event.toolName === "bash") {
+			const cmd = (event.input as { command?: string }).command ?? "";
+			if (cmd.includes("rm -rf")) {
+				return { block: true, reason: "Dangerous command blocked" };
+			}
+		}
+		return undefined;
+	});
+};
+
+// Use inline hooks
+const { session } = await createAgentSession({
+	hooks: [{ factory: loggingHook }, { factory: safetyHook }],
+	sessionManager: SessionManager.inMemory(),
+});
+
+session.subscribe((event) => {
+	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+		process.stdout.write(event.assistantMessageEvent.delta);
+	}
+});
+
+await session.prompt("List files in the current directory.");
+console.log();
+
+// Disable all hooks:
+// hooks: []
+
+// Merge with discovered hooks:
+// const discovered = await discoverHooks();
+// hooks: [...discovered, { factory: myHook }]
+
+// Add paths without replacing discovery:
+// additionalHookPaths: ["/extra/hooks"]