@mariozechner/pi-coding-agent 0.27.9 → 0.28.0

package/examples/custom-tools/todo/index.ts

@@ -8,10 +8,10 @@
  * The onSession callback reconstructs state by scanning past tool results.
  */
 
-import { Type } from "@sinclair/typebox";
 import { StringEnum } from "@mariozechner/pi-ai";
-import { Text } from "@mariozechner/pi-tui";
 import type { CustomAgentTool, CustomToolFactory, ToolSessionEvent } from "@mariozechner/pi-coding-agent";
+import { Text } from "@mariozechner/pi-tui";
+import { Type } from "@sinclair/typebox";
 
 interface Todo {
 	id: number;
@@ -76,11 +76,18 @@ const factory: CustomToolFactory = (_pi) => {
 			switch (params.action) {
 				case "list":
 					return {
-						content: [{ type: "text", text: todos.length ? todos.map((t) => `[${t.done ? "x" : " "}] #${t.id}: ${t.text}`).join("\n") : "No todos" }],
+						content: [
+							{
+								type: "text",
+								text: todos.length
+									? todos.map((t) => `[${t.done ? "x" : " "}] #${t.id}: ${t.text}`).join("\n")
+									: "No todos",
+							},
+						],
 						details: { action: "list", todos: [...todos], nextId },
 					};
 
-				case "add":
+				case "add": {
 					if (!params.text) {
 						return {
 							content: [{ type: "text", text: "Error: text required for add" }],
@@ -93,8 +100,9 @@ const factory: CustomToolFactory = (_pi) => {
 						content: [{ type: "text", text: `Added todo #${newTodo.id}: ${newTodo.text}` }],
 						details: { action: "add", todos: [...todos], nextId },
 					};
+				}
 
-				case "toggle":
+				case "toggle": {
 					if (params.id === undefined) {
 						return {
 							content: [{ type: "text", text: "Error: id required for toggle" }],
@@ -113,8 +121,9 @@ const factory: CustomToolFactory = (_pi) => {
 						content: [{ type: "text", text: `Todo #${todo.id} ${todo.done ? "completed" : "uncompleted"}` }],
 						details: { action: "toggle", todos: [...todos], nextId },
 					};
+				}
 
-				case "clear":
+				case "clear": {
 					const count = todos.length;
 					todos = [];
 					nextId = 1;
@@ -122,6 +131,7 @@ const factory: CustomToolFactory = (_pi) => {
 						content: [{ type: "text", text: `Cleared ${count} todos` }],
 						details: { action: "clear", todos: [], nextId: 1 },
 					};
+				}
 
 				default:
 					return {
@@ -133,8 +143,8 @@ const factory: CustomToolFactory = (_pi) => {
 
 		renderCall(args, theme) {
 			let text = theme.fg("toolTitle", theme.bold("todo ")) + theme.fg("muted", args.action);
-			if (args.text) text += " " + theme.fg("dim", `"${args.text}"`);
-			if (args.id !== undefined) text += " " + theme.fg("accent", `#${args.id}`);
+			if (args.text) text += ` ${theme.fg("dim", `"${args.text}"`)}`;
+			if (args.id !== undefined) text += ` ${theme.fg("accent", `#${args.id}`)}`;
 			return new Text(text, 0, 0);
 		},
 
@@ -153,7 +163,7 @@ const factory: CustomToolFactory = (_pi) => {
 			const todoList = details.todos;
 
 			switch (details.action) {
-				case "list":
+				case "list": {
 					if (todoList.length === 0) {
 						return new Text(theme.fg("dim", "No todos"), 0, 0);
 					}
@@ -162,16 +172,24 @@ const factory: CustomToolFactory = (_pi) => {
 					for (const t of display) {
 						const check = t.done ? theme.fg("success", "✓") : theme.fg("dim", "○");
 						const itemText = t.done ? theme.fg("dim", t.text) : theme.fg("muted", t.text);
-						listText += "\n" + check + " " + theme.fg("accent", `#${t.id}`) + " " + itemText;
+						listText += `\n${check} ${theme.fg("accent", `#${t.id}`)} ${itemText}`;
 					}
 					if (!expanded && todoList.length > 5) {
-						listText += "\n" + theme.fg("dim", `... ${todoList.length - 5} more`);
+						listText += `\n${theme.fg("dim", `... ${todoList.length - 5} more`)}`;
 					}
 					return new Text(listText, 0, 0);
+				}
 
 				case "add": {
 					const added = todoList[todoList.length - 1];
-					return new Text(theme.fg("success", "✓ Added ") + theme.fg("accent", `#${added.id}`) + " " + theme.fg("muted", added.text), 0, 0);
+					return new Text(
+						theme.fg("success", "✓ Added ") +
+							theme.fg("accent", `#${added.id}`) +
+							" " +
+							theme.fg("muted", added.text),
+						0,
+						0,
+					);
 				}
 
 				case "toggle": {

package/examples/hooks/confirm-destructive.ts

@@ -28,9 +28,7 @@ export default function (pi: HookAPI) {
 			if (!ctx.hasUI) return;
 
 			// Check if there are unsaved changes (messages since last assistant response)
-			const hasUnsavedWork = event.entries.some(
-				(e) => e.type === "message" && e.message.role === "user",
-			);
+			const hasUnsavedWork = event.entries.some((e) => e.type === "message" && e.message.role === "user");
 
 			if (hasUnsavedWork) {
 				const confirmed = await ctx.ui.confirm(
@@ -48,10 +46,10 @@ export default function (pi: HookAPI) {
 		if (event.reason === "before_branch") {
 			if (!ctx.hasUI) return;
 
-			const choice = await ctx.ui.select(
-				`Branch from turn ${event.targetTurnIndex}?`,
-				["Yes, create branch", "No, stay in current session"],
-			);
+			const choice = await ctx.ui.select(`Branch from turn ${event.targetTurnIndex}?`, [
+				"Yes, create branch",
+				"No, stay in current session",
+			]);
 
 			if (choice !== "Yes, create branch") {
 				ctx.ui.notify("Branch cancelled", "info");

package/examples/hooks/custom-compaction.ts

@@ -13,8 +13,8 @@
  *   pi --hook examples/hooks/custom-compaction.ts
  */
 
-import { complete } from "@mariozechner/pi-ai";
-import { findModel, messageTransformer } from "@mariozechner/pi-coding-agent";
+import { complete, getModel } from "@mariozechner/pi-ai";
+import { messageTransformer } from "@mariozechner/pi-coding-agent";
 import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 
 export default function (pi: HookAPI) {
@@ -23,13 +23,13 @@ export default function (pi: HookAPI) {
 
 		ctx.ui.notify("Custom compaction hook triggered", "info");
 
-		const { messagesToSummarize, messagesToKeep, previousSummary, tokensBefore, resolveApiKey, entries, signal } = event;
+		const { messagesToSummarize, messagesToKeep, previousSummary, tokensBefore, resolveApiKey, entries, signal } =
+			event;
 
 		// Use Gemini Flash for summarization (cheaper/faster than most conversation models)
-		// findModel searches both built-in models and custom models from models.json
-		const { model, error } = findModel("google", "gemini-2.5-flash");
-		if (error || !model) {
-			ctx.ui.notify(`Could not find Gemini Flash model: ${error}, using default compaction`, "warning");
+		const model = getModel("google", "gemini-2.5-flash");
+		if (!model) {
+			ctx.ui.notify(`Could not find Gemini Flash model, using default compaction`, "warning");
 			return;
 		}
 

package/examples/hooks/dirty-repo-guard.ts

@@ -10,11 +10,7 @@ import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 export default function (pi: HookAPI) {
 	pi.on("session", async (event, ctx) => {
 		// Only guard destructive actions
-		if (
-			event.reason !== "before_clear" &&
-			event.reason !== "before_switch" &&
-			event.reason !== "before_branch"
-		) {
+		if (event.reason !== "before_clear" && event.reason !== "before_switch" && event.reason !== "before_branch") {
 			return;
 		}
 
@@ -46,10 +42,10 @@ export default function (pi: HookAPI) {
 					? "switch session"
 					: "branch";
 
-		const choice = await ctx.ui.select(
-			`You have ${changedFiles} uncommitted file(s). ${action} anyway?`,
-			["Yes, proceed anyway", "No, let me commit first"],
-		);
+		const choice = await ctx.ui.select(`You have ${changedFiles} uncommitted file(s). ${action} anyway?`, [
+			"Yes, proceed anyway",
+			"No, let me commit first",
+		]);
 
 		if (choice !== "Yes, proceed anyway") {
 			ctx.ui.notify("Commit your changes first", "warning");

package/examples/hooks/permission-gate.ts

@@ -8,11 +8,7 @@
 import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 
 export default function (pi: HookAPI) {
-	const dangerousPatterns = [
-		/\brm\s+(-rf?|--recursive)/i,
-		/\bsudo\b/i,
-		/\b(chmod|chown)\b.*777/i,
-	];
+	const dangerousPatterns = [/\brm\s+(-rf?|--recursive)/i, /\bsudo\b/i, /\b(chmod|chown)\b.*777/i];
 
 	pi.on("tool_call", async (event, ctx) => {
 		if (event.toolName !== "bash") return undefined;

package/examples/sdk/02-custom-model.ts

@@ -4,16 +4,27 @@
  * Shows how to select a specific model and thinking level.
  */
 
-import { createAgentSession, findModel, discoverAvailableModels } from "../../src/index.js";
+import { getModel } from "@mariozechner/pi-ai";
+import { createAgentSession, discoverAuthStorage, discoverModels } from "../../src/index.js";
 
-// Option 1: Find a specific model by provider/id
-const { model: sonnet } = findModel("anthropic", "claude-sonnet-4-20250514");
-if (sonnet) {
-	console.log(`Found model: ${sonnet.provider}/${sonnet.id}`);
+// Set up auth storage and model registry
+const authStorage = discoverAuthStorage();
+const modelRegistry = discoverModels(authStorage);
+
+// Option 1: Find a specific built-in model by provider/id
+const opus = getModel("anthropic", "claude-opus-4-5");
+if (opus) {
+	console.log(`Found model: ${opus.provider}/${opus.id}`);
+}
+
+// Option 2: Find model via registry (includes custom models from models.json)
+const customModel = modelRegistry.find("my-provider", "my-model");
+if (customModel) {
+	console.log(`Found custom model: ${customModel.provider}/${customModel.id}`);
 }
 
-// Option 2: Pick from available models (have valid API keys)
-const available = await discoverAvailableModels();
+// Option 3: Pick from available models (have valid API keys)
+const available = await modelRegistry.getAvailable();
 console.log(
 	"Available models:",
 	available.map((m) => `${m.provider}/${m.id}`),
@@ -23,6 +34,8 @@ if (available.length > 0) {
 	const { session } = await createAgentSession({
 		model: available[0],
 		thinkingLevel: "medium", // off, low, medium, high
+		authStorage,
+		modelRegistry,
 	});
 
 	session.subscribe((event) => {

package/examples/sdk/04-skills.ts

@@ -27,7 +27,7 @@ const customSkill: Skill = {
 };
 
 // Use filtered + custom skills
-const { session } = await createAgentSession({
+await createAgentSession({
 	skills: [...filteredSkills, customSkill],
 	sessionManager: SessionManager.inMemory(),
 });

package/examples/sdk/05-tools.ts

@@ -10,31 +10,28 @@
 
 import { Type } from "@sinclair/typebox";
 import {
+	bashTool, // read, bash, edit, write - uses process.cwd()
+	type CustomAgentTool,
 	createAgentSession,
-	discoverCustomTools,
-	SessionManager,
-	codingTools, // read, bash, edit, write - uses process.cwd()
-	readOnlyTools, // read, grep, find, ls - uses process.cwd()
-	createCodingTools, // Factory: creates tools for specific cwd
-	createReadOnlyTools, // Factory: creates tools for specific cwd
-	createReadTool,
 	createBashTool,
+	createCodingTools, // Factory: creates tools for specific cwd
 	createGrepTool,
-	readTool,
-	bashTool,
+	createReadTool,
 	grepTool,
-	type CustomAgentTool,
+	readOnlyTools, // read, grep, find, ls - uses process.cwd()
+	readTool,
+	SessionManager,
 } from "../../src/index.js";
 
 // Read-only mode (no edit/write) - uses process.cwd()
-const { session: readOnly } = await createAgentSession({
+await createAgentSession({
 	tools: readOnlyTools,
 	sessionManager: SessionManager.inMemory(),
 });
 console.log("Read-only session created");
 
 // Custom tool selection - uses process.cwd()
-const { session: custom } = await createAgentSession({
+await createAgentSession({
 	tools: [readTool, bashTool, grepTool],
 	sessionManager: SessionManager.inMemory(),
 });
@@ -42,7 +39,7 @@ console.log("Custom tools session created");
 
 // With custom cwd - MUST use factory functions!
 const customCwd = "/path/to/project";
-const { session: customCwdSession } = await createAgentSession({
+await createAgentSession({
 	cwd: customCwd,
 	tools: createCodingTools(customCwd), // Tools resolve paths relative to customCwd
 	sessionManager: SessionManager.inMemory(),
@@ -50,7 +47,7 @@ const { session: customCwdSession } = await createAgentSession({
 console.log("Custom cwd session created");
 
 // Or pick specific tools for custom cwd
-const { session: specificTools } = await createAgentSession({
+await createAgentSession({
 	cwd: customCwd,
 	tools: [createReadTool(customCwd), createBashTool(customCwd), createGrepTool(customCwd)],
 	sessionManager: SessionManager.inMemory(),

package/examples/sdk/06-hooks.ts

@@ -4,7 +4,7 @@
  * Hooks intercept agent events for logging, blocking, or modification.
  */
 
-import { createAgentSession, discoverHooks, SessionManager, type HookFactory } from "../../src/index.js";
+import { createAgentSession, type HookFactory, SessionManager } from "../../src/index.js";
 
 // Logging hook
 const loggingHook: HookFactory = (api) => {

package/examples/sdk/07-context-files.ts

@@ -14,7 +14,7 @@ for (const file of discovered) {
 }
 
 // Use custom context files
-const { session } = await createAgentSession({
+await createAgentSession({
 	contextFiles: [
 		...discovered,
 		{

package/examples/sdk/08-slash-commands.ts

@@ -4,7 +4,7 @@
  * File-based commands that inject content when invoked with /commandname.
  */
 
-import { createAgentSession, discoverSlashCommands, SessionManager, type FileSlashCommand } from "../../src/index.js";
+import { createAgentSession, discoverSlashCommands, type FileSlashCommand, SessionManager } from "../../src/index.js";
 
 // Discover commands from cwd/.pi/commands/ and ~/.pi/agent/commands/
 const discovered = discoverSlashCommands();
@@ -21,12 +21,12 @@ const deployCommand: FileSlashCommand = {
 	content: `# Deploy Instructions
 
 1. Build: npm run build
-2. Test: npm test  
+2. Test: npm test
 3. Deploy: npm run deploy`,
 };
 
 // Use discovered + custom commands
-const { session } = await createAgentSession({
+await createAgentSession({
 	slashCommands: [...discovered, deployCommand],
 	sessionManager: SessionManager.inMemory(),
 });

package/examples/sdk/09-api-keys-and-oauth.ts

@@ -1,45 +1,55 @@
 /**
  * API Keys and OAuth
  *
- * Configure API key resolution. Default checks: models.json, OAuth, env vars.
+ * Configure API key resolution via AuthStorage and ModelRegistry.
  */
 
 import {
+	AuthStorage,
 	createAgentSession,
-	configureOAuthStorage,
-	defaultGetApiKey,
+	discoverAuthStorage,
+	discoverModels,
+	ModelRegistry,
 	SessionManager,
 } from "../../src/index.js";
-import { getAgentDir } from "../../src/config.js";
 
-// Default: uses env vars (ANTHROPIC_API_KEY, etc.), OAuth, and models.json
-const { session: defaultSession } = await createAgentSession({
+// Default: discoverAuthStorage() uses ~/.pi/agent/auth.json
+// discoverModels() loads built-in + custom models from ~/.pi/agent/models.json
+const authStorage = discoverAuthStorage();
+const modelRegistry = discoverModels(authStorage);
+
+await createAgentSession({
 	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry,
 });
-console.log("Session with default API key resolution");
+console.log("Session with default auth storage and model registry");
+
+// Custom auth storage location
+const customAuthStorage = new AuthStorage("/tmp/my-app/auth.json");
+const customModelRegistry = new ModelRegistry(customAuthStorage, "/tmp/my-app/models.json");
 
-// Custom resolver
-const { session: customSession } = await createAgentSession({
-	getApiKey: async (model) => {
-		// Custom logic (secrets manager, database, etc.)
-		if (model.provider === "anthropic") {
-			return process.env.MY_ANTHROPIC_KEY;
-		}
-		// Fall back to default
-		return defaultGetApiKey()(model);
-	},
+await createAgentSession({
 	sessionManager: SessionManager.inMemory(),
+	authStorage: customAuthStorage,
+	modelRegistry: customModelRegistry,
 });
-console.log("Session with custom API key resolver");
+console.log("Session with custom auth storage location");
 
-// Use OAuth from ~/.pi/agent while customizing everything else
-configureOAuthStorage(getAgentDir()); // Must call before createAgentSession
+// Runtime API key override (not persisted to disk)
+authStorage.setRuntimeApiKey("anthropic", "sk-my-temp-key");
+await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry,
+});
+console.log("Session with runtime API key override");
 
-const { session: hybridSession } = await createAgentSession({
-	agentDir: "/tmp/custom-config", // Custom config location
-	// But OAuth tokens still come from ~/.pi/agent/oauth.json
-	systemPrompt: "You are helpful.",
-	skills: [],
+// No models.json - only built-in models
+const simpleRegistry = new ModelRegistry(authStorage); // null = no models.json
+await createAgentSession({
 	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry: simpleRegistry,
 });
-console.log("Session with OAuth from default location, custom config elsewhere");
+console.log("Session with only built-in models");

package/examples/sdk/10-settings.ts

@@ -17,7 +17,7 @@ settingsManager.applyOverrides({
 	retry: { enabled: true, maxRetries: 5, baseDelayMs: 1000 },
 });
 
-const { session } = await createAgentSession({
+await createAgentSession({
 	settingsManager,
 	sessionManager: SessionManager.inMemory(),
 });
@@ -30,7 +30,7 @@ const inMemorySettings = SettingsManager.inMemory({
 	retry: { enabled: false },
 });
 
-const { session: testSession } = await createAgentSession({
+await createAgentSession({
 	settingsManager: inMemorySettings,
 	sessionManager: SessionManager.inMemory(),
 });

package/examples/sdk/12-full-control.ts

@@ -2,38 +2,36 @@
  * Full Control
  *
  * Replace everything - no discovery, explicit configuration.
- * Still uses OAuth from ~/.pi/agent for convenience.
  *
  * IMPORTANT: When providing `tools` with a custom `cwd`, use the tool factory
  * functions (createReadTool, createBashTool, etc.) to ensure tools resolve
  * paths relative to your cwd.
  */
 
+import { getModel } from "@mariozechner/pi-ai";
 import { Type } from "@sinclair/typebox";
 import {
+	AuthStorage,
+	type CustomAgentTool,
 	createAgentSession,
-	configureOAuthStorage,
-	defaultGetApiKey,
-	findModel,
-	SessionManager,
-	SettingsManager,
-	createReadTool,
 	createBashTool,
+	createReadTool,
 	type HookFactory,
-	type CustomAgentTool,
+	ModelRegistry,
+	SessionManager,
+	SettingsManager,
 } from "../../src/index.js";
-import { getAgentDir } from "../../src/config.js";
 
-// Use OAuth from default location
-configureOAuthStorage(getAgentDir());
+// Custom auth storage location
+const authStorage = new AuthStorage("/tmp/my-agent/auth.json");
 
-// Custom API key with fallback
-const getApiKey = async (model: { provider: string }) => {
-	if (model.provider === "anthropic" && process.env.MY_ANTHROPIC_KEY) {
-		return process.env.MY_ANTHROPIC_KEY;
-	}
-	return defaultGetApiKey()(model as any);
-};
+// Runtime API key override (not persisted)
+if (process.env.MY_ANTHROPIC_KEY) {
+	authStorage.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
+}
+
+// Model registry with no custom models.json
+const modelRegistry = new ModelRegistry(authStorage);
 
 // Inline hook
 const auditHook: HookFactory = (api) => {
@@ -55,7 +53,7 @@ const statusTool: CustomAgentTool = {
 	}),
 };
 
-const { model } = findModel("anthropic", "claude-sonnet-4-20250514");
+const model = getModel("anthropic", "claude-opus-4-5");
 if (!model) throw new Error("Model not found");
 
 // In-memory settings with overrides
@@ -73,7 +71,8 @@ const { session } = await createAgentSession({
 
 	model,
 	thinkingLevel: "off",
-	getApiKey,
+	authStorage,
+	modelRegistry,
 
 	systemPrompt: `You are a minimal assistant.
 Available: read, bash, status. Be concise.`,

package/examples/sdk/README.md

@@ -29,50 +29,63 @@ npx tsx examples/sdk/01-minimal.ts
 ## Quick Reference
 
 ```typescript
+import { getModel } from "@mariozechner/pi-ai";
 import {
+  AuthStorage,
   createAgentSession,
-  configureOAuthStorage,
+  discoverAuthStorage,
+  discoverModels,
   discoverSkills,
   discoverHooks,
   discoverCustomTools,
   discoverContextFiles,
   discoverSlashCommands,
-  discoverAvailableModels,
-  findModel,
-  defaultGetApiKey,
   loadSettings,
   buildSystemPrompt,
+  ModelRegistry,
   SessionManager,
   codingTools,
   readOnlyTools,
   readTool, bashTool, editTool, writeTool,
 } from "@mariozechner/pi-coding-agent";
 
+// Auth and models setup
+const authStorage = discoverAuthStorage();
+const modelRegistry = discoverModels(authStorage);
+
 // Minimal
-const { session } = await createAgentSession();
+const { session } = await createAgentSession({ authStorage, modelRegistry });
 
 // Custom model
-const { model } = findModel("anthropic", "claude-sonnet-4-20250514");
-const { session } = await createAgentSession({ model, thinkingLevel: "high" });
+const model = getModel("anthropic", "claude-opus-4-5");
+const { session } = await createAgentSession({ model, thinkingLevel: "high", authStorage, modelRegistry });
 
 // Modify prompt
 const { session } = await createAgentSession({
   systemPrompt: (defaultPrompt) => defaultPrompt + "\n\nBe concise.",
+  authStorage,
+  modelRegistry,
 });
 
 // Read-only
-const { session } = await createAgentSession({ tools: readOnlyTools });
+const { session } = await createAgentSession({ tools: readOnlyTools, authStorage, modelRegistry });
 
 // In-memory
 const { session } = await createAgentSession({
   sessionManager: SessionManager.inMemory(),
+  authStorage,
+  modelRegistry,
 });
 
 // Full control
-configureOAuthStorage(); // Use OAuth from ~/.pi/agent
+const customAuth = new AuthStorage("/my/app/auth.json");
+customAuth.setRuntimeApiKey("anthropic", process.env.MY_KEY!);
+const customRegistry = new ModelRegistry(customAuth);
+
 const { session } = await createAgentSession({
   model,
-  getApiKey: async (m) => process.env.MY_KEY,
+  authStorage: customAuth,
+  modelRegistry: customRegistry,
   systemPrompt: "You are helpful.",
   tools: [readTool, bashTool],
   customTools: [{ tool: myTool }],
@@ -81,7 +94,6 @@ const { session } = await createAgentSession({
   contextFiles: [],
   slashCommands: [],
   sessionManager: SessionManager.inMemory(),
-  settings: { compaction: { enabled: false } },
 });
 
 // Run prompts
@@ -97,11 +109,12 @@ await session.prompt("Hello");
 
 | Option | Default | Description |
 |--------|---------|-------------|
+| `authStorage` | `discoverAuthStorage()` | Credential storage |
+| `modelRegistry` | `discoverModels(authStorage)` | Model registry |
 | `cwd` | `process.cwd()` | Working directory |
 | `agentDir` | `~/.pi/agent` | Config directory |
 | `model` | From settings/first available | Model to use |
 | `thinkingLevel` | From settings/"off" | off, low, medium, high |
-| `getApiKey` | Built-in resolver | API key function |
 | `systemPrompt` | Discovered | String or `(default) => modified` |
 | `tools` | `codingTools` | Built-in tools |
 | `customTools` | Discovered | Replaces discovery |
@@ -112,7 +125,7 @@ await session.prompt("Hello");
 | `contextFiles` | Discovered | AGENTS.md files |
 | `slashCommands` | Discovered | File commands |
 | `sessionManager` | `SessionManager.create(cwd)` | Persistence |
-| `settings` | From agentDir | Overrides |
+| `settingsManager` | From agentDir | Settings overrides |
 
 ## Events