indusagi-coding-agent 0.1.0 → 0.1.2

package/examples/extensions/auto-commit-on-exit.ts

@@ -1,49 +1,49 @@
-/**
- * Auto-Commit on Exit Extension
- *
- * Automatically commits changes when the agent exits.
- * Uses the last assistant message to generate a commit message.
- */
-
-import type { ExtensionAPI } from "indusagi-coding-agent";
-
-export default function (indusagi: ExtensionAPI) {
-	indusagi.on("session_shutdown", async (_event, ctx) => {
-		// Check for uncommitted changes
-		const { stdout: status, code } = await indusagi.exec("git", ["status", "--porcelain"]);
-
-		if (code !== 0 || status.trim().length === 0) {
-			// Not a git repo or no changes
-			return;
-		}
-
-		// Find the last assistant message for commit context
-		const entries = ctx.sessionManager.getEntries();
-		let lastAssistantText = "";
-		for (let i = entries.length - 1; i >= 0; i--) {
-			const entry = entries[i];
-			if (entry.type === "message" && entry.message.role === "assistant") {
-				const content = entry.message.content;
-				if (Array.isArray(content)) {
-					lastAssistantText = content
-						.filter((c): c is { type: "text"; text: string } => c.type === "text")
-						.map((c) => c.text)
-						.join("\n");
-				}
-				break;
-			}
-		}
-
-		// Generate a simple commit message
-		const firstLine = lastAssistantText.split("\n")[0] || "Work in progress";
-		const commitMessage = `[indusagi] ${firstLine.slice(0, 50)}${firstLine.length > 50 ? "..." : ""}`;
-
-		// Stage and commit
-		await indusagi.exec("git", ["add", "-A"]);
-		const { code: commitCode } = await indusagi.exec("git", ["commit", "-m", commitMessage]);
-
-		if (commitCode === 0 && ctx.hasUI) {
-			ctx.ui.notify(`Auto-committed: ${commitMessage}`, "info");
-		}
-	});
-}
+/**
+ * Auto-Commit on Exit Extension
+ *
+ * Automatically commits changes when the agent exits.
+ * Uses the last assistant message to generate a commit message.
+ */
+
+import type { ExtensionAPI } from "indusagi-coding-agent";
+
+export default function (indusagi: ExtensionAPI) {
+	indusagi.on("session_shutdown", async (_event, ctx) => {
+		// Check for uncommitted changes
+		const { stdout: status, code } = await indusagi.exec("git", ["status", "--porcelain"]);
+
+		if (code !== 0 || status.trim().length === 0) {
+			// Not a git repo or no changes
+			return;
+		}
+
+		// Find the last assistant message for commit context
+		const entries = ctx.sessionManager.getEntries();
+		let lastAssistantText = "";
+		for (let i = entries.length - 1; i >= 0; i--) {
+			const entry = entries[i];
+			if (entry.type === "message" && entry.message.role === "assistant") {
+				const content = entry.message.content;
+				if (Array.isArray(content)) {
+					lastAssistantText = content
+						.filter((c): c is { type: "text"; text: string } => c.type === "text")
+						.map((c) => c.text)
+						.join("\n");
+				}
+				break;
+			}
+		}
+
+		// Generate a simple commit message
+		const firstLine = lastAssistantText.split("\n")[0] || "Work in progress";
+		const commitMessage = `[indusagi] ${firstLine.slice(0, 50)}${firstLine.length > 50 ? "..." : ""}`;
+
+		// Stage and commit
+		await indusagi.exec("git", ["add", "-A"]);
+		const { code: commitCode } = await indusagi.exec("git", ["commit", "-m", commitMessage]);
+
+		if (commitCode === 0 && ctx.hasUI) {
+			ctx.ui.notify(`Auto-committed: ${commitMessage}`, "info");
+		}
+	});
+}

package/examples/extensions/bookmark.ts

@@ -1,50 +1,50 @@
-/**
- * Entry bookmarking example.
- *
- * Shows setLabel to mark entries with labels for easy navigation in /tree.
- * Labels appear in the tree view and help you find important points.
- *
- * Usage: /bookmark [label] - bookmark the last assistant message
- */
-
-import type { ExtensionAPI } from "indusagi-coding-agent";
-
-export default function (indusagi: ExtensionAPI) {
-	indusagi.registerCommand("bookmark", {
-		description: "Bookmark last message (usage: /bookmark [label])",
-		handler: async (args, ctx) => {
-			const label = args.trim() || `bookmark-${Date.now()}`;
-
-			// Find the last assistant message entry
-			const entries = ctx.sessionManager.getEntries();
-			for (let i = entries.length - 1; i >= 0; i--) {
-				const entry = entries[i];
-				if (entry.type === "message" && entry.message.role === "assistant") {
-					indusagi.setLabel(entry.id, label);
-					ctx.ui.notify(`Bookmarked as: ${label}`, "info");
-					return;
-				}
-			}
-
-			ctx.ui.notify("No assistant message to bookmark", "warning");
-		},
-	});
-
-	// Remove bookmark
-	indusagi.registerCommand("unbookmark", {
-		description: "Remove bookmark from last labeled entry",
-		handler: async (_args, ctx) => {
-			const entries = ctx.sessionManager.getEntries();
-			for (let i = entries.length - 1; i >= 0; i--) {
-				const entry = entries[i];
-				const label = ctx.sessionManager.getLabel(entry.id);
-				if (label) {
-					indusagi.setLabel(entry.id, undefined);
-					ctx.ui.notify(`Removed bookmark: ${label}`, "info");
-					return;
-				}
-			}
-			ctx.ui.notify("No bookmarked entry found", "warning");
-		},
-	});
-}
+/**
+ * Entry bookmarking example.
+ *
+ * Shows setLabel to mark entries with labels for easy navigation in /tree.
+ * Labels appear in the tree view and help you find important points.
+ *
+ * Usage: /bookmark [label] - bookmark the last assistant message
+ */
+
+import type { ExtensionAPI } from "indusagi-coding-agent";
+
+export default function (indusagi: ExtensionAPI) {
+	indusagi.registerCommand("bookmark", {
+		description: "Bookmark last message (usage: /bookmark [label])",
+		handler: async (args, ctx) => {
+			const label = args.trim() || `bookmark-${Date.now()}`;
+
+			// Find the last assistant message entry
+			const entries = ctx.sessionManager.getEntries();
+			for (let i = entries.length - 1; i >= 0; i--) {
+				const entry = entries[i];
+				if (entry.type === "message" && entry.message.role === "assistant") {
+					indusagi.setLabel(entry.id, label);
+					ctx.ui.notify(`Bookmarked as: ${label}`, "info");
+					return;
+				}
+			}
+
+			ctx.ui.notify("No assistant message to bookmark", "warning");
+		},
+	});
+
+	// Remove bookmark
+	indusagi.registerCommand("unbookmark", {
+		description: "Remove bookmark from last labeled entry",
+		handler: async (_args, ctx) => {
+			const entries = ctx.sessionManager.getEntries();
+			for (let i = entries.length - 1; i >= 0; i--) {
+				const entry = entries[i];
+				const label = ctx.sessionManager.getLabel(entry.id);
+				if (label) {
+					indusagi.setLabel(entry.id, undefined);
+					ctx.ui.notify(`Removed bookmark: ${label}`, "info");
+					return;
+				}
+			}
+			ctx.ui.notify("No bookmarked entry found", "warning");
+		},
+	});
+}

package/examples/extensions/claude-rules.ts

@@ -1,86 +1,86 @@
-/**
- * Claude Rules Extension
- *
- * Scans the project's .claude/rules/ folder for rule files and lists them
- * in the system prompt. The agent can then use the read tool to load
- * specific rules when needed.
- *
- * Best practices for .claude/rules/:
- * - Keep rules focused: Each file should cover one topic (e.g., testing.md, api-design.md)
- * - Use descriptive filenames: The filename should indicate what the rules cover
- * - Use conditional rules sparingly: Only add paths frontmatter when rules truly apply to specific file types
- * - Organize with subdirectories: Group related rules (e.g., frontend/, backend/)
- *
- * Usage:
- * 1. Copy this file to ~/.indusagi/agent/extensions/ or your project's .indusagi/extensions/
- * 2. Create .claude/rules/ folder in your project root
- * 3. Add .md files with your rules
- */
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ExtensionAPI } from "indusagi-coding-agent";
-
-/**
- * Recursively find all .md files in a directory
- */
-function findMarkdownFiles(dir: string, basePath: string = ""): string[] {
-	const results: string[] = [];
-
-	if (!fs.existsSync(dir)) {
-		return results;
-	}
-
-	const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-	for (const entry of entries) {
-		const relativePath = basePath ? `${basePath}/${entry.name}` : entry.name;
-
-		if (entry.isDirectory()) {
-			results.push(...findMarkdownFiles(path.join(dir, entry.name), relativePath));
-		} else if (entry.isFile() && entry.name.endsWith(".md")) {
-			results.push(relativePath);
-		}
-	}
-
-	return results;
-}
-
-export default function claudeRulesExtension(indusagi: ExtensionAPI) {
-	let ruleFiles: string[] = [];
-	let rulesDir: string = "";
-
-	// Scan for rules on session start
-	indusagi.on("session_start", async (_event, ctx) => {
-		rulesDir = path.join(ctx.cwd, ".claude", "rules");
-		ruleFiles = findMarkdownFiles(rulesDir);
-
-		if (ruleFiles.length > 0) {
-			ctx.ui.notify(`Found ${ruleFiles.length} rule(s) in .claude/rules/`, "info");
-		}
-	});
-
-	// Append available rules to system prompt
-	indusagi.on("before_agent_start", async (event) => {
-		if (ruleFiles.length === 0) {
-			return;
-		}
-
-		const rulesList = ruleFiles.map((f) => `- .claude/rules/${f}`).join("\n");
-
-		return {
-			systemPrompt:
-				event.systemPrompt +
-				`
-
-## Project Rules
-
-The following project rules are available in .claude/rules/:
-
-${rulesList}
-
-When working on tasks related to these rules, use the read tool to load the relevant rule files for guidance.
-`,
-		};
-	});
-}
+/**
+ * Claude Rules Extension
+ *
+ * Scans the project's .claude/rules/ folder for rule files and lists them
+ * in the system prompt. The agent can then use the read tool to load
+ * specific rules when needed.
+ *
+ * Best practices for .claude/rules/:
+ * - Keep rules focused: Each file should cover one topic (e.g., testing.md, api-design.md)
+ * - Use descriptive filenames: The filename should indicate what the rules cover
+ * - Use conditional rules sparingly: Only add paths frontmatter when rules truly apply to specific file types
+ * - Organize with subdirectories: Group related rules (e.g., frontend/, backend/)
+ *
+ * Usage:
+ * 1. Copy this file to ~/.indusagi/agent/extensions/ or your project's .indusagi/extensions/
+ * 2. Create .claude/rules/ folder in your project root
+ * 3. Add .md files with your rules
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { ExtensionAPI } from "indusagi-coding-agent";
+
+/**
+ * Recursively find all .md files in a directory
+ */
+function findMarkdownFiles(dir: string, basePath: string = ""): string[] {
+	const results: string[] = [];
+
+	if (!fs.existsSync(dir)) {
+		return results;
+	}
+
+	const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+	for (const entry of entries) {
+		const relativePath = basePath ? `${basePath}/${entry.name}` : entry.name;
+
+		if (entry.isDirectory()) {
+			results.push(...findMarkdownFiles(path.join(dir, entry.name), relativePath));
+		} else if (entry.isFile() && entry.name.endsWith(".md")) {
+			results.push(relativePath);
+		}
+	}
+
+	return results;
+}
+
+export default function claudeRulesExtension(indusagi: ExtensionAPI) {
+	let ruleFiles: string[] = [];
+	let rulesDir: string = "";
+
+	// Scan for rules on session start
+	indusagi.on("session_start", async (_event, ctx) => {
+		rulesDir = path.join(ctx.cwd, ".claude", "rules");
+		ruleFiles = findMarkdownFiles(rulesDir);
+
+		if (ruleFiles.length > 0) {
+			ctx.ui.notify(`Found ${ruleFiles.length} rule(s) in .claude/rules/`, "info");
+		}
+	});
+
+	// Append available rules to system prompt
+	indusagi.on("before_agent_start", async (event) => {
+		if (ruleFiles.length === 0) {
+			return;
+		}
+
+		const rulesList = ruleFiles.map((f) => `- .claude/rules/${f}`).join("\n");
+
+		return {
+			systemPrompt:
+				event.systemPrompt +
+				`
+
+## Project Rules
+
+The following project rules are available in .claude/rules/:
+
+${rulesList}
+
+When working on tasks related to these rules, use the read tool to load the relevant rule files for guidance.
+`,
+		};
+	});
+}

package/examples/extensions/confirm-destructive.ts

@@ -1,59 +1,59 @@
-/**
- * Confirm Destructive Actions Extension
- *
- * Prompts for confirmation before destructive session actions (clear, switch, branch).
- * Demonstrates how to cancel session events using the before_* events.
- */
-
-import type { ExtensionAPI, SessionBeforeSwitchEvent, SessionMessageEntry } from "indusagi-coding-agent";
-
-export default function (indusagi: ExtensionAPI) {
-	indusagi.on("session_before_switch", async (event: SessionBeforeSwitchEvent, ctx) => {
-		if (!ctx.hasUI) return;
-
-		if (event.reason === "new") {
-			const confirmed = await ctx.ui.confirm(
-				"Clear session?",
-				"This will delete all messages in the current session.",
-			);
-
-			if (!confirmed) {
-				ctx.ui.notify("Clear cancelled", "info");
-				return { cancel: true };
-			}
-			return;
-		}
-
-		// reason === "resume" - check if there are unsaved changes (messages since last assistant response)
-		const entries = ctx.sessionManager.getEntries();
-		const hasUnsavedWork = entries.some(
-			(e): e is SessionMessageEntry => e.type === "message" && e.message.role === "user",
-		);
-
-		if (hasUnsavedWork) {
-			const confirmed = await ctx.ui.confirm(
-				"Switch session?",
-				"You have messages in the current session. Switch anyway?",
-			);
-
-			if (!confirmed) {
-				ctx.ui.notify("Switch cancelled", "info");
-				return { cancel: true };
-			}
-		}
-	});
-
-	indusagi.on("session_before_fork", async (event, ctx) => {
-		if (!ctx.hasUI) return;
-
-		const choice = await ctx.ui.select(`Fork from entry ${event.entryId.slice(0, 8)}?`, [
-			"Yes, create fork",
-			"No, stay in current session",
-		]);
-
-		if (choice !== "Yes, create fork") {
-			ctx.ui.notify("Fork cancelled", "info");
-			return { cancel: true };
-		}
-	});
-}
+/**
+ * Confirm Destructive Actions Extension
+ *
+ * Prompts for confirmation before destructive session actions (clear, switch, branch).
+ * Demonstrates how to cancel session events using the before_* events.
+ */
+
+import type { ExtensionAPI, SessionBeforeSwitchEvent, SessionMessageEntry } from "indusagi-coding-agent";
+
+export default function (indusagi: ExtensionAPI) {
+	indusagi.on("session_before_switch", async (event: SessionBeforeSwitchEvent, ctx) => {
+		if (!ctx.hasUI) return;
+
+		if (event.reason === "new") {
+			const confirmed = await ctx.ui.confirm(
+				"Clear session?",
+				"This will delete all messages in the current session.",
+			);
+
+			if (!confirmed) {
+				ctx.ui.notify("Clear cancelled", "info");
+				return { cancel: true };
+			}
+			return;
+		}
+
+		// reason === "resume" - check if there are unsaved changes (messages since last assistant response)
+		const entries = ctx.sessionManager.getEntries();
+		const hasUnsavedWork = entries.some(
+			(e): e is SessionMessageEntry => e.type === "message" && e.message.role === "user",
+		);
+
+		if (hasUnsavedWork) {
+			const confirmed = await ctx.ui.confirm(
+				"Switch session?",
+				"You have messages in the current session. Switch anyway?",
+			);
+
+			if (!confirmed) {
+				ctx.ui.notify("Switch cancelled", "info");
+				return { cancel: true };
+			}
+		}
+	});
+
+	indusagi.on("session_before_fork", async (event, ctx) => {
+		if (!ctx.hasUI) return;
+
+		const choice = await ctx.ui.select(`Fork from entry ${event.entryId.slice(0, 8)}?`, [
+			"Yes, create fork",
+			"No, stay in current session",
+		]);
+
+		if (choice !== "Yes, create fork") {
+			ctx.ui.notify("Fork cancelled", "info");
+			return { cancel: true };
+		}
+	});
+}