@selesai/code 0.10.2 → 0.11.0

package/examples/extensions/dynamic-resources/index.ts

@@ -1,15 +1,15 @@
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-const baseDir = dirname(fileURLToPath(import.meta.url));
-
-export default function (pi: ExtensionAPI) {
-	pi.on("resources_discover", () => {
-		return {
-			skillPaths: [join(baseDir, "SKILL.md")],
-			promptPaths: [join(baseDir, "dynamic.md")],
-			themePaths: [join(baseDir, "dynamic.json")],
-		};
-	});
-}
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const baseDir = dirname(fileURLToPath(import.meta.url));
+
+export default function (pi: ExtensionAPI) {
+	pi.on("resources_discover", () => {
+		return {
+			skillPaths: [join(baseDir, "SKILL.md")],
+			promptPaths: [join(baseDir, "dynamic.md")],
+			themePaths: [join(baseDir, "dynamic.json")],
+		};
+	});
+}

package/examples/extensions/dynamic-tools.ts

@@ -1,74 +1,74 @@
-/**
- * Dynamic Tools Extension
- *
- * Demonstrates registering tools after session initialization.
- *
- * - Registers one tool during session_start
- * - Registers additional tools at runtime via /add-echo-tool <name>
- */
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { Type } from "typebox";
-
-const ECHO_PARAMS = Type.Object({
-	message: Type.String({ description: "Message to echo" }),
-});
-
-function normalizeToolName(input: string): string | undefined {
-	const trimmed = input.trim().toLowerCase();
-	if (!trimmed) return undefined;
-	if (!/^[a-z0-9_]+$/.test(trimmed)) return undefined;
-	return trimmed;
-}
-
-export default function dynamicToolsExtension(pi: ExtensionAPI) {
-	const registeredToolNames = new Set<string>();
-
-	const registerEchoTool = (name: string, label: string, prefix: string): boolean => {
-		if (registeredToolNames.has(name)) {
-			return false;
-		}
-
-		registeredToolNames.add(name);
-		pi.registerTool({
-			name,
-			label,
-			description: `Echo a message with prefix: ${prefix}`,
-			promptSnippet: `Echo back user-provided text with ${prefix.trim()} prefix`,
-			promptGuidelines: ["Use echo_session when the user asks for exact echo output."],
-			parameters: ECHO_PARAMS,
-			async execute(_toolCallId, params) {
-				return {
-					content: [{ type: "text", text: `${prefix}${params.message}` }],
-					details: { tool: name, prefix },
-				};
-			},
-		});
-
-		return true;
-	};
-
-	pi.on("session_start", (_event, ctx) => {
-		registerEchoTool("echo_session", "Echo Session", "[session] ");
-		ctx.ui.notify("Registered dynamic tool: echo_session", "info");
-	});
-
-	pi.registerCommand("add-echo-tool", {
-		description: "Register a new echo tool dynamically: /add-echo-tool <tool_name>",
-		handler: async (args, ctx) => {
-			const toolName = normalizeToolName(args);
-			if (!toolName) {
-				ctx.ui.notify("Usage: /add-echo-tool <tool_name> (lowercase, numbers, underscores)", "warning");
-				return;
-			}
-
-			const created = registerEchoTool(toolName, `Echo ${toolName}`, `[${toolName}] `);
-			if (!created) {
-				ctx.ui.notify(`Tool already registered: ${toolName}`, "warning");
-				return;
-			}
-
-			ctx.ui.notify(`Registered dynamic tool: ${toolName}`, "info");
-		},
-	});
-}
+/**
+ * Dynamic Tools Extension
+ *
+ * Demonstrates registering tools after session initialization.
+ *
+ * - Registers one tool during session_start
+ * - Registers additional tools at runtime via /add-echo-tool <name>
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+
+const ECHO_PARAMS = Type.Object({
+	message: Type.String({ description: "Message to echo" }),
+});
+
+function normalizeToolName(input: string): string | undefined {
+	const trimmed = input.trim().toLowerCase();
+	if (!trimmed) return undefined;
+	if (!/^[a-z0-9_]+$/.test(trimmed)) return undefined;
+	return trimmed;
+}
+
+export default function dynamicToolsExtension(pi: ExtensionAPI) {
+	const registeredToolNames = new Set<string>();
+
+	const registerEchoTool = (name: string, label: string, prefix: string): boolean => {
+		if (registeredToolNames.has(name)) {
+			return false;
+		}
+
+		registeredToolNames.add(name);
+		pi.registerTool({
+			name,
+			label,
+			description: `Echo a message with prefix: ${prefix}`,
+			promptSnippet: `Echo back user-provided text with ${prefix.trim()} prefix`,
+			promptGuidelines: ["Use echo_session when the user asks for exact echo output."],
+			parameters: ECHO_PARAMS,
+			async execute(_toolCallId, params) {
+				return {
+					content: [{ type: "text", text: `${prefix}${params.message}` }],
+					details: { tool: name, prefix },
+				};
+			},
+		});
+
+		return true;
+	};
+
+	pi.on("session_start", (_event, ctx) => {
+		registerEchoTool("echo_session", "Echo Session", "[session] ");
+		ctx.ui.notify("Registered dynamic tool: echo_session", "info");
+	});
+
+	pi.registerCommand("add-echo-tool", {
+		description: "Register a new echo tool dynamically: /add-echo-tool <tool_name>",
+		handler: async (args, ctx) => {
+			const toolName = normalizeToolName(args);
+			if (!toolName) {
+				ctx.ui.notify("Usage: /add-echo-tool <tool_name> (lowercase, numbers, underscores)", "warning");
+				return;
+			}
+
+			const created = registerEchoTool(toolName, `Echo ${toolName}`, `[${toolName}] `);
+			if (!created) {
+				ctx.ui.notify(`Tool already registered: ${toolName}`, "warning");
+				return;
+			}
+
+			ctx.ui.notify(`Registered dynamic tool: ${toolName}`, "info");
+		},
+	});
+}

package/examples/extensions/event-bus.ts

@@ -1,43 +1,43 @@
-/**
- * Inter-extension event bus example.
- *
- * Shows pi.events for communication between extensions. One extension
- * can emit events that other extensions listen to.
- *
- * Usage: /emit [event-name] [data] - emit an event on the bus
- */
-
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-export default function (pi: ExtensionAPI) {
-	// Store ctx for use in event handler
-	let currentCtx: ExtensionContext | undefined;
-
-	pi.on("session_start", async (_event, ctx) => {
-		currentCtx = ctx;
-	});
-
-	// Listen for events from other extensions
-	pi.events.on("my:notification", (data) => {
-		const { message, from } = data as { message: string; from: string };
-		currentCtx?.ui.notify(`Event from ${from}: ${message}`, "info");
-	});
-
-	// Command to emit events (emits "my:notification" which the listener above receives)
-	pi.registerCommand("emit", {
-		description: "Emit my:notification event (usage: /emit message)",
-		handler: async (args, _ctx) => {
-			const message = args.trim() || "hello";
-			pi.events.emit("my:notification", { message, from: "/emit command" });
-			// Listener above will show the notification
-		},
-	});
-
-	// Example: emit on session start
-	pi.on("session_start", async () => {
-		pi.events.emit("my:notification", {
-			message: "Session started",
-			from: "event-bus-example",
-		});
-	});
-}
+/**
+ * Inter-extension event bus example.
+ *
+ * Shows pi.events for communication between extensions. One extension
+ * can emit events that other extensions listen to.
+ *
+ * Usage: /emit [event-name] [data] - emit an event on the bus
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	// Store ctx for use in event handler
+	let currentCtx: ExtensionContext | undefined;
+
+	pi.on("session_start", async (_event, ctx) => {
+		currentCtx = ctx;
+	});
+
+	// Listen for events from other extensions
+	pi.events.on("my:notification", (data) => {
+		const { message, from } = data as { message: string; from: string };
+		currentCtx?.ui.notify(`Event from ${from}: ${message}`, "info");
+	});
+
+	// Command to emit events (emits "my:notification" which the listener above receives)
+	pi.registerCommand("emit", {
+		description: "Emit my:notification event (usage: /emit message)",
+		handler: async (args, _ctx) => {
+			const message = args.trim() || "hello";
+			pi.events.emit("my:notification", { message, from: "/emit command" });
+			// Listener above will show the notification
+		},
+	});
+
+	// Example: emit on session start
+	pi.on("session_start", async () => {
+		pi.events.emit("my:notification", {
+			message: "Session started",
+			from: "event-bus-example",
+		});
+	});
+}

package/examples/extensions/file-trigger.ts

@@ -1,41 +1,41 @@
-/**
- * File Trigger Extension
- *
- * Watches a trigger file and injects its contents into the conversation.
- * Useful for external systems to send messages to the agent.
- *
- * Usage:
- *   echo "Run the tests" > /tmp/agent-trigger.txt
- */
-
-import * as fs from "node:fs";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-export default function (pi: ExtensionAPI) {
-	pi.on("session_start", async (_event, ctx) => {
-		const triggerFile = "/tmp/agent-trigger.txt";
-
-		fs.watch(triggerFile, () => {
-			try {
-				const content = fs.readFileSync(triggerFile, "utf-8").trim();
-				if (content) {
-					pi.sendMessage(
-						{
-							customType: "file-trigger",
-							content: `External trigger: ${content}`,
-							display: true,
-						},
-						{ triggerTurn: true }, // triggerTurn - get LLM to respond
-					);
-					fs.writeFileSync(triggerFile, ""); // Clear after reading
-				}
-			} catch {
-				// File might not exist yet
-			}
-		});
-
-		if (ctx.hasUI) {
-			ctx.ui.notify(`Watching ${triggerFile}`, "info");
-		}
-	});
-}
+/**
+ * File Trigger Extension
+ *
+ * Watches a trigger file and injects its contents into the conversation.
+ * Useful for external systems to send messages to the agent.
+ *
+ * Usage:
+ *   echo "Run the tests" > /tmp/agent-trigger.txt
+ */
+
+import * as fs from "node:fs";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_start", async (_event, ctx) => {
+		const triggerFile = "/tmp/agent-trigger.txt";
+
+		fs.watch(triggerFile, () => {
+			try {
+				const content = fs.readFileSync(triggerFile, "utf-8").trim();
+				if (content) {
+					pi.sendMessage(
+						{
+							customType: "file-trigger",
+							content: `External trigger: ${content}`,
+							display: true,
+						},
+						{ triggerTurn: true }, // triggerTurn - get LLM to respond
+					);
+					fs.writeFileSync(triggerFile, ""); // Clear after reading
+				}
+			} catch {
+				// File might not exist yet
+			}
+		});
+
+		if (ctx.hasUI) {
+			ctx.ui.notify(`Watching ${triggerFile}`, "info");
+		}
+	});
+}

package/examples/extensions/git-checkpoint.ts

@@ -1,53 +1,53 @@
-/**
- * Git Checkpoint Extension
- *
- * Creates git stash checkpoints at each turn so /fork can restore code state.
- * When forking, offers to restore code to that point in history.
- */
-
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-
-export default function (pi: ExtensionAPI) {
-	const checkpoints = new Map<string, string>();
-	let currentEntryId: string | undefined;
-
-	// Track the current entry ID when user messages are saved
-	pi.on("tool_result", async (_event, ctx) => {
-		const leaf = ctx.sessionManager.getLeafEntry();
-		if (leaf) currentEntryId = leaf.id;
-	});
-
-	pi.on("turn_start", async () => {
-		// Create a git stash entry before LLM makes changes
-		const { stdout } = await pi.exec("git", ["stash", "create"]);
-		const ref = stdout.trim();
-		if (ref && currentEntryId) {
-			checkpoints.set(currentEntryId, ref);
-		}
-	});
-
-	pi.on("session_before_fork", async (event, ctx) => {
-		const ref = checkpoints.get(event.entryId);
-		if (!ref) return;
-
-		if (!ctx.hasUI) {
-			// In non-interactive mode, don't restore automatically
-			return;
-		}
-
-		const choice = await ctx.ui.select("Restore code state?", [
-			"Yes, restore code to that point",
-			"No, keep current code",
-		]);
-
-		if (choice?.startsWith("Yes")) {
-			await pi.exec("git", ["stash", "apply", ref]);
-			ctx.ui.notify("Code restored to checkpoint", "info");
-		}
-	});
-
-	pi.on("agent_end", async () => {
-		// Clear checkpoints after agent completes
-		checkpoints.clear();
-	});
-}
+/**
+ * Git Checkpoint Extension
+ *
+ * Creates git stash checkpoints at each turn so /fork can restore code state.
+ * When forking, offers to restore code to that point in history.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	const checkpoints = new Map<string, string>();
+	let currentEntryId: string | undefined;
+
+	// Track the current entry ID when user messages are saved
+	pi.on("tool_result", async (_event, ctx) => {
+		const leaf = ctx.sessionManager.getLeafEntry();
+		if (leaf) currentEntryId = leaf.id;
+	});
+
+	pi.on("turn_start", async () => {
+		// Create a git stash entry before LLM makes changes
+		const { stdout } = await pi.exec("git", ["stash", "create"]);
+		const ref = stdout.trim();
+		if (ref && currentEntryId) {
+			checkpoints.set(currentEntryId, ref);
+		}
+	});
+
+	pi.on("session_before_fork", async (event, ctx) => {
+		const ref = checkpoints.get(event.entryId);
+		if (!ref) return;
+
+		if (!ctx.hasUI) {
+			// In non-interactive mode, don't restore automatically
+			return;
+		}
+
+		const choice = await ctx.ui.select("Restore code state?", [
+			"Yes, restore code to that point",
+			"No, keep current code",
+		]);
+
+		if (choice?.startsWith("Yes")) {
+			await pi.exec("git", ["stash", "apply", ref]);
+			ctx.ui.notify("Code restored to checkpoint", "info");
+		}
+	});
+
+	pi.on("agent_end", async () => {
+		// Clear checkpoints after agent completes
+		checkpoints.clear();
+	});
+}