@selesai/code 0.9.5 → 0.9.8

package/examples/sdk/01-minimal.ts

@@ -1,26 +1,26 @@
-/**
- * Minimal SDK Usage
- *
- * Uses all defaults: discovers skills, extensions, tools, context files
- * from cwd and ~/.pi/agent. Model chosen from settings or first available.
- */
-
-import { createAgentSession } from "@earendil-works/pi-coding-agent";
-
-const { session } = await createAgentSession();
-
-try {
-	session.subscribe((event) => {
-		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-			process.stdout.write(event.assistantMessageEvent.delta);
-		}
-	});
-
-	await session.prompt("What files are in the current directory?");
-	session.state.messages.forEach((msg) => {
-		console.log(msg);
-	});
-	console.log();
-} finally {
-	session.dispose();
-}
+/**
+ * Minimal SDK Usage
+ *
+ * Uses all defaults: discovers skills, extensions, tools, context files
+ * from cwd and ~/.pi/agent. Model chosen from settings or first available.
+ */
+
+import { createAgentSession } from "@earendil-works/pi-coding-agent";
+
+const { session } = await createAgentSession();
+
+try {
+	session.subscribe((event) => {
+		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+			process.stdout.write(event.assistantMessageEvent.delta);
+		}
+	});
+
+	await session.prompt("What files are in the current directory?");
+	session.state.messages.forEach((msg) => {
+		console.log(msg);
+	});
+	console.log();
+} finally {
+	session.dispose();
+}

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

@@ -1,53 +1,53 @@
-/**
- * Custom Model Selection
- *
- * Shows how to select a specific model and thinking level.
- */
-
-import { getModel } from "@earendil-works/pi-ai/compat";
-import { AuthStorage, createAgentSession, ModelRegistry } from "@earendil-works/pi-coding-agent";
-
-// Set up auth storage and model registry
-const authStorage = AuthStorage.create();
-const modelRegistry = ModelRegistry.create(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 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}`),
-);
-
-if (available.length > 0) {
-	const { session } = await createAgentSession({
-		model: available[0],
-		thinkingLevel: "medium", // off, low, medium, high
-		authStorage,
-		modelRegistry,
-	});
-
-	try {
-		session.subscribe((event) => {
-			if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-				process.stdout.write(event.assistantMessageEvent.delta);
-			}
-		});
-
-		await session.prompt("Say hello in one sentence.");
-		console.log();
-	} finally {
-		session.dispose();
-	}
-}
+/**
+ * Custom Model Selection
+ *
+ * Shows how to select a specific model and thinking level.
+ */
+
+import { getModel } from "@earendil-works/pi-ai/compat";
+import { AuthStorage, createAgentSession, ModelRegistry } from "@earendil-works/pi-coding-agent";
+
+// Set up auth storage and model registry
+const authStorage = AuthStorage.create();
+const modelRegistry = ModelRegistry.create(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 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}`),
+);
+
+if (available.length > 0) {
+	const { session } = await createAgentSession({
+		model: available[0],
+		thinkingLevel: "medium", // off, low, medium, high
+		authStorage,
+		modelRegistry,
+	});
+
+	try {
+		session.subscribe((event) => {
+			if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+				process.stdout.write(event.assistantMessageEvent.delta);
+			}
+		});
+
+		await session.prompt("Say hello in one sentence.");
+		console.log();
+	} finally {
+		session.dispose();
+	}
+}

package/examples/sdk/03-custom-prompt.ts

@@ -1,75 +1,75 @@
-/**
- * Custom System Prompt
- *
- * Shows how to replace or modify the default system prompt.
- */
-
-import {
-	createAgentSession,
-	DefaultResourceLoader,
-	getAgentDir,
-	SessionManager,
-} from "@earendil-works/pi-coding-agent";
-
-const cwd = process.cwd();
-const agentDir = getAgentDir();
-
-// Option 1: Replace prompt entirely
-const loader1 = new DefaultResourceLoader({
-	cwd,
-	agentDir,
-	systemPromptOverride: () => `You are a helpful assistant that speaks like a pirate.
-Always end responses with "Arrr!"`,
-	// Needed to avoid DefaultResourceLoader appending APPEND_SYSTEM.md from ~/.pi/agent or <cwd>/.pi.
-	appendSystemPromptOverride: () => [],
-});
-await loader1.reload();
-
-const { session: session1 } = await createAgentSession({
-	resourceLoader: loader1,
-	sessionManager: SessionManager.inMemory(),
-});
-
-try {
-	session1.subscribe((event) => {
-		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-			process.stdout.write(event.assistantMessageEvent.delta);
-		}
-	});
-
-	console.log("=== Replace prompt ===");
-	await session1.prompt("What is 2 + 2?");
-	console.log("\n");
-} finally {
-	session1.dispose();
-}
-
-// Option 2: Append instructions to the default prompt
-const loader2 = new DefaultResourceLoader({
-	cwd,
-	agentDir,
-	appendSystemPromptOverride: (base) => [
-		...base,
-		"## Additional Instructions\n- Always be concise\n- Use bullet points when listing things",
-	],
-});
-await loader2.reload();
-
-const { session: session2 } = await createAgentSession({
-	resourceLoader: loader2,
-	sessionManager: SessionManager.inMemory(),
-});
-
-try {
-	session2.subscribe((event) => {
-		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-			process.stdout.write(event.assistantMessageEvent.delta);
-		}
-	});
-
-	console.log("=== Modify prompt ===");
-	await session2.prompt("List 3 benefits of TypeScript.");
-	console.log();
-} finally {
-	session2.dispose();
-}
+/**
+ * Custom System Prompt
+ *
+ * Shows how to replace or modify the default system prompt.
+ */
+
+import {
+	createAgentSession,
+	DefaultResourceLoader,
+	getAgentDir,
+	SessionManager,
+} from "@earendil-works/pi-coding-agent";
+
+const cwd = process.cwd();
+const agentDir = getAgentDir();
+
+// Option 1: Replace prompt entirely
+const loader1 = new DefaultResourceLoader({
+	cwd,
+	agentDir,
+	systemPromptOverride: () => `You are a helpful assistant that speaks like a pirate.
+Always end responses with "Arrr!"`,
+	// Needed to avoid DefaultResourceLoader appending APPEND_SYSTEM.md from ~/.pi/agent or <cwd>/.pi.
+	appendSystemPromptOverride: () => [],
+});
+await loader1.reload();
+
+const { session: session1 } = await createAgentSession({
+	resourceLoader: loader1,
+	sessionManager: SessionManager.inMemory(),
+});
+
+try {
+	session1.subscribe((event) => {
+		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+			process.stdout.write(event.assistantMessageEvent.delta);
+		}
+	});
+
+	console.log("=== Replace prompt ===");
+	await session1.prompt("What is 2 + 2?");
+	console.log("\n");
+} finally {
+	session1.dispose();
+}
+
+// Option 2: Append instructions to the default prompt
+const loader2 = new DefaultResourceLoader({
+	cwd,
+	agentDir,
+	appendSystemPromptOverride: (base) => [
+		...base,
+		"## Additional Instructions\n- Always be concise\n- Use bullet points when listing things",
+	],
+});
+await loader2.reload();
+
+const { session: session2 } = await createAgentSession({
+	resourceLoader: loader2,
+	sessionManager: SessionManager.inMemory(),
+});
+
+try {
+	session2.subscribe((event) => {
+		if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+			process.stdout.write(event.assistantMessageEvent.delta);
+		}
+	});
+
+	console.log("=== Modify prompt ===");
+	await session2.prompt("List 3 benefits of TypeScript.");
+	console.log();
+} finally {
+	session2.dispose();
+}

package/examples/sdk/04-skills.ts

@@ -1,55 +1,55 @@
-/**
- * Skills Configuration
- *
- * Skills provide specialized instructions loaded into the system prompt.
- * Discover, filter, merge, or replace them.
- */
-
-import {
-	createAgentSession,
-	createSyntheticSourceInfo,
-	DefaultResourceLoader,
-	getAgentDir,
-	SessionManager,
-	type Skill,
-} from "@earendil-works/pi-coding-agent";
-
-// Or define custom skills inline
-const customSkill: Skill = {
-	name: "my-skill",
-	description: "Custom project instructions",
-	filePath: "/virtual/SKILL.md",
-	baseDir: "/virtual",
-	sourceInfo: createSyntheticSourceInfo("/virtual/SKILL.md", { source: "sdk" }),
-	disableModelInvocation: false,
-};
-
-const loader = new DefaultResourceLoader({
-	cwd: process.cwd(),
-	agentDir: getAgentDir(),
-	skillsOverride: (current) => {
-		const filteredSkills = current.skills.filter((s) => s.name.includes("browser") || s.name.includes("search"));
-		return {
-			skills: [...filteredSkills, customSkill],
-			diagnostics: current.diagnostics,
-		};
-	},
-});
-await loader.reload();
-
-// Discover all skills from cwd/.pi/skills, ~/.pi/agent/skills, etc.
-const { skills: allSkills, diagnostics } = loader.getSkills();
-console.log(
-	"Discovered skills:",
-	allSkills.map((s) => s.name),
-);
-if (diagnostics.length > 0) {
-	console.log("Warnings:", diagnostics);
-}
-
-const { session } = await createAgentSession({
-	resourceLoader: loader,
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Session created with filtered skills");
-session.dispose();
+/**
+ * Skills Configuration
+ *
+ * Skills provide specialized instructions loaded into the system prompt.
+ * Discover, filter, merge, or replace them.
+ */
+
+import {
+	createAgentSession,
+	createSyntheticSourceInfo,
+	DefaultResourceLoader,
+	getAgentDir,
+	SessionManager,
+	type Skill,
+} from "@earendil-works/pi-coding-agent";
+
+// Or define custom skills inline
+const customSkill: Skill = {
+	name: "my-skill",
+	description: "Custom project instructions",
+	filePath: "/virtual/SKILL.md",
+	baseDir: "/virtual",
+	sourceInfo: createSyntheticSourceInfo("/virtual/SKILL.md", { source: "sdk" }),
+	disableModelInvocation: false,
+};
+
+const loader = new DefaultResourceLoader({
+	cwd: process.cwd(),
+	agentDir: getAgentDir(),
+	skillsOverride: (current) => {
+		const filteredSkills = current.skills.filter((s) => s.name.includes("browser") || s.name.includes("search"));
+		return {
+			skills: [...filteredSkills, customSkill],
+			diagnostics: current.diagnostics,
+		};
+	},
+});
+await loader.reload();
+
+// Discover all skills from cwd/.pi/skills, ~/.pi/agent/skills, etc.
+const { skills: allSkills, diagnostics } = loader.getSkills();
+console.log(
+	"Discovered skills:",
+	allSkills.map((s) => s.name),
+);
+if (diagnostics.length > 0) {
+	console.log("Warnings:", diagnostics);
+}
+
+const { session } = await createAgentSession({
+	resourceLoader: loader,
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("Session created with filtered skills");
+session.dispose();

package/examples/sdk/05-tools.ts

@@ -1,48 +1,48 @@
-/**
- * Tools Configuration
- *
- * Use tool names to choose which built-in tools are enabled.
- *
- * Tool names are matched against all available tools. If you use a custom `cwd`,
- * createAgentSession() applies that cwd when it builds the actual built-in tools.
- *
- * For custom tools, see 06-extensions.ts - custom tools are registered via the
- * extensions system using pi.registerTool().
- */
-
-import { createAgentSession, SessionManager } from "@earendil-works/pi-coding-agent";
-
-// Read-only mode (no edit/write)
-const { session: readOnlySession } = await createAgentSession({
-	tools: ["read", "grep", "find", "ls"],
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Read-only session created");
-readOnlySession.dispose();
-
-// Custom tool selection
-const { session: customToolsSession } = await createAgentSession({
-	tools: ["read", "bash", "grep"],
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("Custom tools session created");
-customToolsSession.dispose();
-
-// With custom cwd
-const customCwd = "/path/to/project";
-const { session: customCwdSession } = await createAgentSession({
-	cwd: customCwd,
-	tools: ["read", "bash", "edit", "write"],
-	sessionManager: SessionManager.inMemory(customCwd),
-});
-console.log("Custom cwd session created");
-customCwdSession.dispose();
-
-// Or pick specific tools for custom cwd
-const { session: specificToolsSession } = await createAgentSession({
-	cwd: customCwd,
-	tools: ["read", "bash", "grep"],
-	sessionManager: SessionManager.inMemory(customCwd),
-});
-console.log("Specific tools with custom cwd session created");
-specificToolsSession.dispose();
+/**
+ * Tools Configuration
+ *
+ * Use tool names to choose which built-in tools are enabled.
+ *
+ * Tool names are matched against all available tools. If you use a custom `cwd`,
+ * createAgentSession() applies that cwd when it builds the actual built-in tools.
+ *
+ * For custom tools, see 06-extensions.ts - custom tools are registered via the
+ * extensions system using pi.registerTool().
+ */
+
+import { createAgentSession, SessionManager } from "@earendil-works/pi-coding-agent";
+
+// Read-only mode (no edit/write)
+const { session: readOnlySession } = await createAgentSession({
+	tools: ["read", "grep", "find", "ls"],
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("Read-only session created");
+readOnlySession.dispose();
+
+// Custom tool selection
+const { session: customToolsSession } = await createAgentSession({
+	tools: ["read", "bash", "grep"],
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("Custom tools session created");
+customToolsSession.dispose();
+
+// With custom cwd
+const customCwd = "/path/to/project";
+const { session: customCwdSession } = await createAgentSession({
+	cwd: customCwd,
+	tools: ["read", "bash", "edit", "write"],
+	sessionManager: SessionManager.inMemory(customCwd),
+});
+console.log("Custom cwd session created");
+customCwdSession.dispose();
+
+// Or pick specific tools for custom cwd
+const { session: specificToolsSession } = await createAgentSession({
+	cwd: customCwd,
+	tools: ["read", "bash", "grep"],
+	sessionManager: SessionManager.inMemory(customCwd),
+});
+console.log("Specific tools with custom cwd session created");
+specificToolsSession.dispose();