@selesai/code 0.10.2 → 0.11.0

package/examples/sdk/06-extensions.ts

@@ -1,99 +1,99 @@
-/**
- * Extensions Configuration
- *
- * Extensions intercept agent events and can register custom tools.
- * They provide a unified system for extensions, custom tools, commands, and more.
- *
- * By default, extension files are discovered from:
- * - ~/.pi/agent/extensions/
- * - <cwd>/.pi/extensions/
- * - Paths specified in settings.json "extensions" array
- *
- * An extension is a TypeScript file that exports a default function:
- *   export default function (pi: ExtensionAPI) { ... }
- */
-
-import {
-	createAgentSession,
-	DefaultResourceLoader,
-	getAgentDir,
-	SessionManager,
-} from "@earendil-works/pi-coding-agent";
-
-// Extensions are discovered automatically from standard locations.
-// You can also add paths via settings.json or DefaultResourceLoader options.
-
-const resourceLoader = new DefaultResourceLoader({
-	cwd: process.cwd(),
-	agentDir: getAgentDir(),
-	additionalExtensionPaths: ["./my-logging-extension.ts", "./my-safety-extension.ts"],
-	extensionFactories: [
-		(pi) => {
-			pi.on("agent_start", () => {
-				console.log("[Inline Extension] Agent starting");
-			});
-		},
-	],
-});
-await resourceLoader.reload();
-
-const { session } = await createAgentSession({
-	resourceLoader,
-	sessionManager: SessionManager.inMemory(),
-});
-
-try {
-	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();
-} finally {
-	session.dispose();
-}
-
-// Example extension file (./my-logging-extension.ts):
-/*
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-export default function (pi: ExtensionAPI) {
-	pi.on("agent_start", async () => {
-		console.log("[Extension] Agent starting");
-	});
-
-	pi.on("tool_call", async (event) => {
-		console.log(\`[Extension] Tool: \${event.toolName}\`);
-		// Return { block: true, reason: "..." } to block execution
-		return undefined;
-	});
-
-	pi.on("agent_end", async (event) => {
-		console.log(\`[Extension] Done, \${event.messages.length} messages\`);
-	});
-
-	// Register a custom tool
-	pi.registerTool({
-		name: "my_tool",
-		label: "My Tool",
-		description: "Does something useful",
-		parameters: Type.Object({
-			input: Type.String(),
-		}),
-		execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => ({
-			content: [{ type: "text", text: \`Processed: \${params.input}\` }],
-			details: {},
-		}),
-	});
-
-	// Register a command
-	pi.registerCommand("mycommand", {
-		description: "Do something",
-		handler: async (args, ctx) => {
-			ctx.ui.notify(\`Command executed with: \${args}\`);
-		},
-	});
-}
-*/
+/**
+ * Extensions Configuration
+ *
+ * Extensions intercept agent events and can register custom tools.
+ * They provide a unified system for extensions, custom tools, commands, and more.
+ *
+ * By default, extension files are discovered from:
+ * - ~/.pi/agent/extensions/
+ * - <cwd>/.pi/extensions/
+ * - Paths specified in settings.json "extensions" array
+ *
+ * An extension is a TypeScript file that exports a default function:
+ *   export default function (pi: ExtensionAPI) { ... }
+ */
+
+import {
+	createAgentSession,
+	DefaultResourceLoader,
+	getAgentDir,
+	SessionManager,
+} from "@earendil-works/pi-coding-agent";
+
+// Extensions are discovered automatically from standard locations.
+// You can also add paths via settings.json or DefaultResourceLoader options.
+
+const resourceLoader = new DefaultResourceLoader({
+	cwd: process.cwd(),
+	agentDir: getAgentDir(),
+	additionalExtensionPaths: ["./my-logging-extension.ts", "./my-safety-extension.ts"],
+	extensionFactories: [
+		(pi) => {
+			pi.on("agent_start", () => {
+				console.log("[Inline Extension] Agent starting");
+			});
+		},
+	],
+});
+await resourceLoader.reload();
+
+const { session } = await createAgentSession({
+	resourceLoader,
+	sessionManager: SessionManager.inMemory(),
+});
+
+try {
+	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();
+} finally {
+	session.dispose();
+}
+
+// Example extension file (./my-logging-extension.ts):
+/*
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.on("agent_start", async () => {
+		console.log("[Extension] Agent starting");
+	});
+
+	pi.on("tool_call", async (event) => {
+		console.log(\`[Extension] Tool: \${event.toolName}\`);
+		// Return { block: true, reason: "..." } to block execution
+		return undefined;
+	});
+
+	pi.on("agent_end", async (event) => {
+		console.log(\`[Extension] Done, \${event.messages.length} messages\`);
+	});
+
+	// Register a custom tool
+	pi.registerTool({
+		name: "my_tool",
+		label: "My Tool",
+		description: "Does something useful",
+		parameters: Type.Object({
+			input: Type.String(),
+		}),
+		execute: async (_toolCallId, params, _signal, _onUpdate, _ctx) => ({
+			content: [{ type: "text", text: \`Processed: \${params.input}\` }],
+			details: {},
+		}),
+	});
+
+	// Register a command
+	pi.registerCommand("mycommand", {
+		description: "Do something",
+		handler: async (args, ctx) => {
+			ctx.ui.notify(\`Command executed with: \${args}\`);
+		},
+	});
+}
+*/

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

@@ -1,47 +1,47 @@
-/**
- * Context Files (AGENTS.md)
- *
- * Context files provide project-specific instructions loaded into the system prompt.
- */
-
-import {
-	createAgentSession,
-	DefaultResourceLoader,
-	getAgentDir,
-	SessionManager,
-} from "@earendil-works/pi-coding-agent";
-
-// Disable context files entirely by returning an empty list in agentsFilesOverride.
-const loader = new DefaultResourceLoader({
-	cwd: process.cwd(),
-	agentDir: getAgentDir(),
-	agentsFilesOverride: (current) => ({
-		agentsFiles: [
-			...current.agentsFiles,
-			{
-				path: "/virtual/AGENTS.md",
-				content: `# Project Guidelines
-
-## Code Style
-- Use TypeScript strict mode
-- No any types
-- Prefer const over let`,
-			},
-		],
-	}),
-});
-await loader.reload();
-
-// Discover AGENTS.md files walking up from cwd
-const discovered = loader.getAgentsFiles().agentsFiles;
-console.log("Discovered context files:");
-for (const file of discovered) {
-	console.log(`  - ${file.path} (${file.content.length} chars)`);
-}
-
-const { session } = await createAgentSession({
-	resourceLoader: loader,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log(`Session created with ${discovered.length + 1} context files`);
-session.dispose();
+/**
+ * Context Files (AGENTS.md)
+ *
+ * Context files provide project-specific instructions loaded into the system prompt.
+ */
+
+import {
+	createAgentSession,
+	DefaultResourceLoader,
+	getAgentDir,
+	SessionManager,
+} from "@earendil-works/pi-coding-agent";
+
+// Disable context files entirely by returning an empty list in agentsFilesOverride.
+const loader = new DefaultResourceLoader({
+	cwd: process.cwd(),
+	agentDir: getAgentDir(),
+	agentsFilesOverride: (current) => ({
+		agentsFiles: [
+			...current.agentsFiles,
+			{
+				path: "/virtual/AGENTS.md",
+				content: `# Project Guidelines
+
+## Code Style
+- Use TypeScript strict mode
+- No any types
+- Prefer const over let`,
+			},
+		],
+	}),
+});
+await loader.reload();
+
+// Discover AGENTS.md files walking up from cwd
+const discovered = loader.getAgentsFiles().agentsFiles;
+console.log("Discovered context files:");
+for (const file of discovered) {
+	console.log(`  - ${file.path} (${file.content.length} chars)`);
+}
+
+const { session } = await createAgentSession({
+	resourceLoader: loader,
+	sessionManager: SessionManager.inMemory(),
+});
+console.log(`Session created with ${discovered.length + 1} context files`);
+session.dispose();

package/examples/sdk/08-prompt-templates.ts

@@ -1,51 +1,51 @@
-/**
- * Prompt Templates
- *
- * File-based templates that inject content when invoked with /templatename.
- */
-
-import {
-	createAgentSession,
-	createSyntheticSourceInfo,
-	DefaultResourceLoader,
-	getAgentDir,
-	type PromptTemplate,
-	SessionManager,
-} from "@earendil-works/pi-coding-agent";
-
-// Define custom templates
-const deployTemplate: PromptTemplate = {
-	name: "deploy",
-	description: "Deploy the application",
-	filePath: "/virtual/prompts/deploy.md",
-	sourceInfo: createSyntheticSourceInfo("/virtual/prompts/deploy.md", { source: "sdk" }),
-	content: `# Deploy Instructions
-
-1. Build: npm run build
-2. Test: npm test
-3. Deploy: npm run deploy`,
-};
-
-const loader = new DefaultResourceLoader({
-	cwd: process.cwd(),
-	agentDir: getAgentDir(),
-	promptsOverride: (current) => ({
-		prompts: [...current.prompts, deployTemplate],
-		diagnostics: current.diagnostics,
-	}),
-});
-await loader.reload();
-
-// Discover templates from cwd/.pi/prompts/ and ~/.pi/agent/prompts/
-const discovered = loader.getPrompts().prompts;
-console.log("Discovered prompt templates:");
-for (const template of discovered) {
-	console.log(`  /${template.name}: ${template.description}`);
-}
-
-const { session } = await createAgentSession({
-	resourceLoader: loader,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log(`Session created with ${discovered.length + 1} prompt templates`);
-session.dispose();
+/**
+ * Prompt Templates
+ *
+ * File-based templates that inject content when invoked with /templatename.
+ */
+
+import {
+	createAgentSession,
+	createSyntheticSourceInfo,
+	DefaultResourceLoader,
+	getAgentDir,
+	type PromptTemplate,
+	SessionManager,
+} from "@earendil-works/pi-coding-agent";
+
+// Define custom templates
+const deployTemplate: PromptTemplate = {
+	name: "deploy",
+	description: "Deploy the application",
+	filePath: "/virtual/prompts/deploy.md",
+	sourceInfo: createSyntheticSourceInfo("/virtual/prompts/deploy.md", { source: "sdk" }),
+	content: `# Deploy Instructions
+
+1. Build: npm run build
+2. Test: npm test
+3. Deploy: npm run deploy`,
+};
+
+const loader = new DefaultResourceLoader({
+	cwd: process.cwd(),
+	agentDir: getAgentDir(),
+	promptsOverride: (current) => ({
+		prompts: [...current.prompts, deployTemplate],
+		diagnostics: current.diagnostics,
+	}),
+});
+await loader.reload();
+
+// Discover templates from cwd/.pi/prompts/ and ~/.pi/agent/prompts/
+const discovered = loader.getPrompts().prompts;
+console.log("Discovered prompt templates:");
+for (const template of discovered) {
+	console.log(`  /${template.name}: ${template.description}`);
+}
+
+const { session } = await createAgentSession({
+	resourceLoader: loader,
+	sessionManager: SessionManager.inMemory(),
+});
+console.log(`Session created with ${discovered.length + 1} prompt templates`);
+session.dispose();

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

@@ -1,52 +1,52 @@
-/**
- * API Keys and OAuth
- *
- * Configure API key resolution via AuthStorage and ModelRegistry.
- */
-
-import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@earendil-works/pi-coding-agent";
-
-// Default: AuthStorage uses ~/.pi/agent/auth.json
-// ModelRegistry loads built-in + custom models from ~/.pi/agent/models.json
-const authStorage = AuthStorage.create();
-const modelRegistry = ModelRegistry.create(authStorage);
-
-const { session: defaultAuthSession } = await createAgentSession({
-	sessionManager: SessionManager.inMemory(),
-	authStorage,
-	modelRegistry,
-});
-console.log("Session with default auth storage and model registry");
-defaultAuthSession.dispose();
-
-// Custom auth storage location
-const customAuthStorage = AuthStorage.create("/tmp/my-app/auth.json");
-const customModelRegistry = ModelRegistry.create(customAuthStorage, "/tmp/my-app/models.json");
-
-const { session: customAuthSession } = await createAgentSession({
-	sessionManager: SessionManager.inMemory(),
-	authStorage: customAuthStorage,
-	modelRegistry: customModelRegistry,
-});
-console.log("Session with custom auth storage location");
-customAuthSession.dispose();
-
-// Runtime API key override (not persisted to disk)
-authStorage.setRuntimeApiKey("anthropic", "sk-my-temp-key");
-const { session: runtimeKeySession } = await createAgentSession({
-	sessionManager: SessionManager.inMemory(),
-	authStorage,
-	modelRegistry,
-});
-console.log("Session with runtime API key override");
-runtimeKeySession.dispose();
-
-// No models.json - only built-in models
-const simpleRegistry = ModelRegistry.inMemory(authStorage);
-const { session: builtInModelsSession } = await createAgentSession({
-	sessionManager: SessionManager.inMemory(),
-	authStorage,
-	modelRegistry: simpleRegistry,
-});
-console.log("Session with only built-in models");
-builtInModelsSession.dispose();
+/**
+ * API Keys and OAuth
+ *
+ * Configure API key resolution via AuthStorage and ModelRegistry.
+ */
+
+import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@earendil-works/pi-coding-agent";
+
+// Default: AuthStorage uses ~/.pi/agent/auth.json
+// ModelRegistry loads built-in + custom models from ~/.pi/agent/models.json
+const authStorage = AuthStorage.create();
+const modelRegistry = ModelRegistry.create(authStorage);
+
+const { session: defaultAuthSession } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry,
+});
+console.log("Session with default auth storage and model registry");
+defaultAuthSession.dispose();
+
+// Custom auth storage location
+const customAuthStorage = AuthStorage.create("/tmp/my-app/auth.json");
+const customModelRegistry = ModelRegistry.create(customAuthStorage, "/tmp/my-app/models.json");
+
+const { session: customAuthSession } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage: customAuthStorage,
+	modelRegistry: customModelRegistry,
+});
+console.log("Session with custom auth storage location");
+customAuthSession.dispose();
+
+// Runtime API key override (not persisted to disk)
+authStorage.setRuntimeApiKey("anthropic", "sk-my-temp-key");
+const { session: runtimeKeySession } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry,
+});
+console.log("Session with runtime API key override");
+runtimeKeySession.dispose();
+
+// No models.json - only built-in models
+const simpleRegistry = ModelRegistry.inMemory(authStorage);
+const { session: builtInModelsSession } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+	authStorage,
+	modelRegistry: simpleRegistry,
+});
+console.log("Session with only built-in models");
+builtInModelsSession.dispose();

package/examples/sdk/10-settings.ts

@@ -1,53 +1,53 @@
-/**
- * Settings Configuration
- *
- * Override settings using SettingsManager.
- */
-
-import { createAgentSession, SessionManager, SettingsManager } from "@earendil-works/pi-coding-agent";
-
-const cwd = process.cwd();
-
-// Load current settings (merged global + project)
-const settingsManagerFromDisk = SettingsManager.create(cwd);
-console.log("Current settings:", JSON.stringify(settingsManagerFromDisk.getGlobalSettings(), null, 2));
-
-// Override specific settings
-const settingsManager = SettingsManager.create(cwd);
-settingsManager.applyOverrides({
-	compaction: { enabled: false },
-	retry: { enabled: true, maxRetries: 5, baseDelayMs: 1000 },
-});
-
-const { session: customSettingsSession } = await createAgentSession({
-	settingsManager,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Session created with custom settings");
-customSettingsSession.dispose();
-
-// Setters update memory immediately and queue persistence writes.
-// Call flush() when you need a durability boundary.
-settingsManager.setDefaultThinkingLevel("low");
-await settingsManager.flush();
-
-// Surface settings I/O errors at the app layer.
-const settingsErrors = settingsManager.drainErrors();
-if (settingsErrors.length > 0) {
-	for (const { scope, error } of settingsErrors) {
-		console.warn(`Warning (${scope} settings): ${error.message}`);
-	}
-}
-
-// For testing without file I/O:
-const inMemorySettings = SettingsManager.inMemory({
-	compaction: { enabled: false },
-	retry: { enabled: false },
-});
-
-const { session: testSession } = await createAgentSession({
-	settingsManager: inMemorySettings,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Test session created with in-memory settings");
-testSession.dispose();
+/**
+ * Settings Configuration
+ *
+ * Override settings using SettingsManager.
+ */
+
+import { createAgentSession, SessionManager, SettingsManager } from "@earendil-works/pi-coding-agent";
+
+const cwd = process.cwd();
+
+// Load current settings (merged global + project)
+const settingsManagerFromDisk = SettingsManager.create(cwd);
+console.log("Current settings:", JSON.stringify(settingsManagerFromDisk.getGlobalSettings(), null, 2));
+
+// Override specific settings
+const settingsManager = SettingsManager.create(cwd);
+settingsManager.applyOverrides({
+	compaction: { enabled: false },
+	retry: { enabled: true, maxRetries: 5, baseDelayMs: 1000 },
+});
+
+const { session: customSettingsSession } = await createAgentSession({
+	settingsManager,
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("Session created with custom settings");
+customSettingsSession.dispose();
+
+// Setters update memory immediately and queue persistence writes.
+// Call flush() when you need a durability boundary.
+settingsManager.setDefaultThinkingLevel("low");
+await settingsManager.flush();
+
+// Surface settings I/O errors at the app layer.
+const settingsErrors = settingsManager.drainErrors();
+if (settingsErrors.length > 0) {
+	for (const { scope, error } of settingsErrors) {
+		console.warn(`Warning (${scope} settings): ${error.message}`);
+	}
+}
+
+// For testing without file I/O:
+const inMemorySettings = SettingsManager.inMemory({
+	compaction: { enabled: false },
+	retry: { enabled: false },
+});
+
+const { session: testSession } = await createAgentSession({
+	settingsManager: inMemorySettings,
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("Test session created with in-memory settings");
+testSession.dispose();