indusagi-coding-agent 0.1.0 → 0.1.2

package/examples/extensions/truncated-tool.ts

@@ -1,193 +1,193 @@
-/**
- * Truncated Tool Example - Demonstrates proper output truncation for custom tools
- *
- * Custom tools MUST truncate their output to avoid overwhelming the LLM context.
- * The built-in limit is 50KB (~10k tokens) and 2000 lines, whichever is hit first.
- *
- * This example shows how to:
- * 1. Use the built-in truncation utilities
- * 2. Write full output to a temp file when truncated
- * 3. Inform the LLM where to find the complete output
- * 4. Custom rendering of tool calls and results
- *
- * The `rg` tool here wraps ripgrep with proper truncation. Compare this to the
- * built-in `grep` tool in src/core/tools/grep.ts for a more complete implementation.
- */
-
-import type { ExtensionAPI } from "indusagi-coding-agent";
-import {
-	DEFAULT_MAX_BYTES,
-	DEFAULT_MAX_LINES,
-	formatSize,
-	type TruncationResult,
-	truncateHead,
-} from "indusagi-coding-agent";
-import { Text } from "indusagi/tui";
-import { Type } from "@sinclair/typebox";
-import { execSync } from "child_process";
-import { mkdtempSync, writeFileSync } from "fs";
-import { tmpdir } from "os";
-import { join } from "path";
-
-const RgParams = Type.Object({
-	pattern: Type.String({ description: "Search pattern (regex)" }),
-	path: Type.Optional(Type.String({ description: "Directory to search (default: current directory)" })),
-	glob: Type.Optional(Type.String({ description: "File glob pattern, e.g. '*.ts'" })),
-});
-
-interface RgDetails {
-	pattern: string;
-	path?: string;
-	glob?: string;
-	matchCount: number;
-	truncation?: TruncationResult;
-	fullOutputPath?: string;
-}
-
-export default function (indusagi: ExtensionAPI) {
-	indusagi.registerTool({
-		name: "rg",
-		label: "ripgrep",
-		// Document the truncation limits in the tool description so the LLM knows
-		description: `Search file contents using ripgrep. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(DEFAULT_MAX_BYTES)} (whichever is hit first). If truncated, full output is saved to a temp file.`,
-		parameters: RgParams,
-
-		async execute(_toolCallId, params, _onUpdate, ctx) {
-			const { pattern, path: searchPath, glob } = params;
-
-			// Build the ripgrep command
-			const args = ["rg", "--line-number", "--color=never"];
-			if (glob) args.push("--glob", glob);
-			args.push(pattern);
-			args.push(searchPath || ".");
-
-			let output: string;
-			try {
-				output = execSync(args.join(" "), {
-					cwd: ctx.cwd,
-					encoding: "utf-8",
-					maxBuffer: 100 * 1024 * 1024, // 100MB buffer to capture full output
-				});
-			} catch (err: any) {
-				// ripgrep exits with 1 when no matches found
-				if (err.status === 1) {
-					return {
-						content: [{ type: "text", text: "No matches found" }],
-						details: { pattern, path: searchPath, glob, matchCount: 0 } as RgDetails,
-					};
-				}
-				throw new Error(`ripgrep failed: ${err.message}`);
-			}
-
-			if (!output.trim()) {
-				return {
-					content: [{ type: "text", text: "No matches found" }],
-					details: { pattern, path: searchPath, glob, matchCount: 0 } as RgDetails,
-				};
-			}
-
-			// Apply truncation using built-in utilities
-			// truncateHead keeps the first N lines/bytes (good for search results)
-			// truncateTail keeps the last N lines/bytes (good for logs/command output)
-			const truncation = truncateHead(output, {
-				maxLines: DEFAULT_MAX_LINES,
-				maxBytes: DEFAULT_MAX_BYTES,
-			});
-
-			// Count matches (each non-empty line with a match)
-			const matchCount = output.split("\n").filter((line) => line.trim()).length;
-
-			const details: RgDetails = {
-				pattern,
-				path: searchPath,
-				glob,
-				matchCount,
-			};
-
-			let resultText = truncation.content;
-
-			if (truncation.truncated) {
-				// Save full output to a temp file so LLM can access it if needed
-				const tempDir = mkdtempSync(join(tmpdir(), "indusagi-rg-"));
-				const tempFile = join(tempDir, "output.txt");
-				writeFileSync(tempFile, output);
-
-				details.truncation = truncation;
-				details.fullOutputPath = tempFile;
-
-				// Add truncation notice - this helps the LLM understand the output is incomplete
-				const truncatedLines = truncation.totalLines - truncation.outputLines;
-				const truncatedBytes = truncation.totalBytes - truncation.outputBytes;
-
-				resultText += `\n\n[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`;
-				resultText += ` (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}).`;
-				resultText += ` ${truncatedLines} lines (${formatSize(truncatedBytes)}) omitted.`;
-				resultText += ` Full output saved to: ${tempFile}]`;
-			}
-
-			return {
-				content: [{ type: "text", text: resultText }],
-				details,
-			};
-		},
-
-		// Custom rendering of the tool call (shown before/during execution)
-		renderCall(args, theme) {
-			let text = theme.fg("toolTitle", theme.bold("rg "));
-			text += theme.fg("accent", `"${args.pattern}"`);
-			if (args.path) {
-				text += theme.fg("muted", ` in ${args.path}`);
-			}
-			if (args.glob) {
-				text += theme.fg("dim", ` --glob ${args.glob}`);
-			}
-			return new Text(text, 0, 0);
-		},
-
-		// Custom rendering of the tool result
-		renderResult(result, { expanded, isPartial }, theme) {
-			const details = result.details as RgDetails | undefined;
-
-			// Handle streaming/partial results
-			if (isPartial) {
-				return new Text(theme.fg("warning", "Searching..."), 0, 0);
-			}
-
-			// No matches
-			if (!details || details.matchCount === 0) {
-				return new Text(theme.fg("dim", "No matches found"), 0, 0);
-			}
-
-			// Build result display
-			let text = theme.fg("success", `${details.matchCount} matches`);
-
-			// Show truncation warning if applicable
-			if (details.truncation?.truncated) {
-				text += theme.fg("warning", " (truncated)");
-			}
-
-			// In expanded view, show the actual matches
-			if (expanded) {
-				const content = result.content[0];
-				if (content?.type === "text") {
-					// Show first 20 lines in expanded view, or all if fewer
-					const lines = content.text.split("\n").slice(0, 20);
-					for (const line of lines) {
-						text += `\n${theme.fg("dim", line)}`;
-					}
-					if (content.text.split("\n").length > 20) {
-						text += `\n${theme.fg("muted", "... (use read tool to see full output)")}`;
-					}
-				}
-
-				// Show temp file path if truncated
-				if (details.fullOutputPath) {
-					text += `\n${theme.fg("dim", `Full output: ${details.fullOutputPath}`)}`;
-				}
-			}
-
-			return new Text(text, 0, 0);
-		},
-	});
-}
-
+/**
+ * Truncated Tool Example - Demonstrates proper output truncation for custom tools
+ *
+ * Custom tools MUST truncate their output to avoid overwhelming the LLM context.
+ * The built-in limit is 50KB (~10k tokens) and 2000 lines, whichever is hit first.
+ *
+ * This example shows how to:
+ * 1. Use the built-in truncation utilities
+ * 2. Write full output to a temp file when truncated
+ * 3. Inform the LLM where to find the complete output
+ * 4. Custom rendering of tool calls and results
+ *
+ * The `rg` tool here wraps ripgrep with proper truncation. Compare this to the
+ * built-in `grep` tool in src/core/tools/grep.ts for a more complete implementation.
+ */
+
+import type { ExtensionAPI } from "indusagi-coding-agent";
+import {
+	DEFAULT_MAX_BYTES,
+	DEFAULT_MAX_LINES,
+	formatSize,
+	type TruncationResult,
+	truncateHead,
+} from "indusagi-coding-agent";
+import { Text } from "indusagi/tui";
+import { Type } from "@sinclair/typebox";
+import { execSync } from "child_process";
+import { mkdtempSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+
+const RgParams = Type.Object({
+	pattern: Type.String({ description: "Search pattern (regex)" }),
+	path: Type.Optional(Type.String({ description: "Directory to search (default: current directory)" })),
+	glob: Type.Optional(Type.String({ description: "File glob pattern, e.g. '*.ts'" })),
+});
+
+interface RgDetails {
+	pattern: string;
+	path?: string;
+	glob?: string;
+	matchCount: number;
+	truncation?: TruncationResult;
+	fullOutputPath?: string;
+}
+
+export default function (indusagi: ExtensionAPI) {
+	indusagi.registerTool({
+		name: "rg",
+		label: "ripgrep",
+		// Document the truncation limits in the tool description so the LLM knows
+		description: `Search file contents using ripgrep. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(DEFAULT_MAX_BYTES)} (whichever is hit first). If truncated, full output is saved to a temp file.`,
+		parameters: RgParams,
+
+		async execute(_toolCallId, params, _onUpdate, ctx) {
+			const { pattern, path: searchPath, glob } = params;
+
+			// Build the ripgrep command
+			const args = ["rg", "--line-number", "--color=never"];
+			if (glob) args.push("--glob", glob);
+			args.push(pattern);
+			args.push(searchPath || ".");
+
+			let output: string;
+			try {
+				output = execSync(args.join(" "), {
+					cwd: ctx.cwd,
+					encoding: "utf-8",
+					maxBuffer: 100 * 1024 * 1024, // 100MB buffer to capture full output
+				});
+			} catch (err: any) {
+				// ripgrep exits with 1 when no matches found
+				if (err.status === 1) {
+					return {
+						content: [{ type: "text", text: "No matches found" }],
+						details: { pattern, path: searchPath, glob, matchCount: 0 } as RgDetails,
+					};
+				}
+				throw new Error(`ripgrep failed: ${err.message}`);
+			}
+
+			if (!output.trim()) {
+				return {
+					content: [{ type: "text", text: "No matches found" }],
+					details: { pattern, path: searchPath, glob, matchCount: 0 } as RgDetails,
+				};
+			}
+
+			// Apply truncation using built-in utilities
+			// truncateHead keeps the first N lines/bytes (good for search results)
+			// truncateTail keeps the last N lines/bytes (good for logs/command output)
+			const truncation = truncateHead(output, {
+				maxLines: DEFAULT_MAX_LINES,
+				maxBytes: DEFAULT_MAX_BYTES,
+			});
+
+			// Count matches (each non-empty line with a match)
+			const matchCount = output.split("\n").filter((line) => line.trim()).length;
+
+			const details: RgDetails = {
+				pattern,
+				path: searchPath,
+				glob,
+				matchCount,
+			};
+
+			let resultText = truncation.content;
+
+			if (truncation.truncated) {
+				// Save full output to a temp file so LLM can access it if needed
+				const tempDir = mkdtempSync(join(tmpdir(), "indusagi-rg-"));
+				const tempFile = join(tempDir, "output.txt");
+				writeFileSync(tempFile, output);
+
+				details.truncation = truncation;
+				details.fullOutputPath = tempFile;
+
+				// Add truncation notice - this helps the LLM understand the output is incomplete
+				const truncatedLines = truncation.totalLines - truncation.outputLines;
+				const truncatedBytes = truncation.totalBytes - truncation.outputBytes;
+
+				resultText += `\n\n[Output truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`;
+				resultText += ` (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}).`;
+				resultText += ` ${truncatedLines} lines (${formatSize(truncatedBytes)}) omitted.`;
+				resultText += ` Full output saved to: ${tempFile}]`;
+			}
+
+			return {
+				content: [{ type: "text", text: resultText }],
+				details,
+			};
+		},
+
+		// Custom rendering of the tool call (shown before/during execution)
+		renderCall(args, theme) {
+			let text = theme.fg("toolTitle", theme.bold("rg "));
+			text += theme.fg("accent", `"${args.pattern}"`);
+			if (args.path) {
+				text += theme.fg("muted", ` in ${args.path}`);
+			}
+			if (args.glob) {
+				text += theme.fg("dim", ` --glob ${args.glob}`);
+			}
+			return new Text(text, 0, 0);
+		},
+
+		// Custom rendering of the tool result
+		renderResult(result, { expanded, isPartial }, theme) {
+			const details = result.details as RgDetails | undefined;
+
+			// Handle streaming/partial results
+			if (isPartial) {
+				return new Text(theme.fg("warning", "Searching..."), 0, 0);
+			}
+
+			// No matches
+			if (!details || details.matchCount === 0) {
+				return new Text(theme.fg("dim", "No matches found"), 0, 0);
+			}
+
+			// Build result display
+			let text = theme.fg("success", `${details.matchCount} matches`);
+
+			// Show truncation warning if applicable
+			if (details.truncation?.truncated) {
+				text += theme.fg("warning", " (truncated)");
+			}
+
+			// In expanded view, show the actual matches
+			if (expanded) {
+				const content = result.content[0];
+				if (content?.type === "text") {
+					// Show first 20 lines in expanded view, or all if fewer
+					const lines = content.text.split("\n").slice(0, 20);
+					for (const line of lines) {
+						text += `\n${theme.fg("dim", line)}`;
+					}
+					if (content.text.split("\n").length > 20) {
+						text += `\n${theme.fg("muted", "... (use read tool to see full output)")}`;
+					}
+				}
+
+				// Show temp file path if truncated
+				if (details.fullOutputPath) {
+					text += `\n${theme.fg("dim", `Full output: ${details.fullOutputPath}`)}`;
+				}
+			}
+
+			return new Text(text, 0, 0);
+		},
+	});
+}
+

package/examples/extensions/widget-placement.ts

@@ -1,17 +1,17 @@
-import type { ExtensionAPI, ExtensionContext } from "indusagi-coding-agent";
-
-const applyWidgets = (ctx: ExtensionContext) => {
-	if (!ctx.hasUI) return;
-	ctx.ui.setWidget("widget-above", ["Above editor widget"]);
-	ctx.ui.setWidget("widget-below", ["Below editor widget"], { placement: "belowEditor" });
-};
-
-export default function widgetPlacementExtension(indusagi: ExtensionAPI) {
-	indusagi.on("session_start", (_event, ctx) => {
-		applyWidgets(ctx);
-	});
-
-	indusagi.on("session_switch", (_event, ctx) => {
-		applyWidgets(ctx);
-	});
-}
+import type { ExtensionAPI, ExtensionContext } from "indusagi-coding-agent";
+
+const applyWidgets = (ctx: ExtensionContext) => {
+	if (!ctx.hasUI) return;
+	ctx.ui.setWidget("widget-above", ["Above editor widget"]);
+	ctx.ui.setWidget("widget-below", ["Below editor widget"], { placement: "belowEditor" });
+};
+
+export default function widgetPlacementExtension(indusagi: ExtensionAPI) {
+	indusagi.on("session_start", (_event, ctx) => {
+		applyWidgets(ctx);
+	});
+
+	indusagi.on("session_switch", (_event, ctx) => {
+		applyWidgets(ctx);
+	});
+}

package/examples/extensions/with-deps/index.ts

@@ -1,36 +1,36 @@
-/**
- * Example extension with its own npm dependencies.
- * Tests that jiti resolves modules from the extension's own node_modules.
- *
- * Requires: npm install in this directory
- */
-
-import type { ExtensionAPI } from "indusagi-coding-agent";
-import { Type } from "@sinclair/typebox";
-import ms from "ms";
-
-export default function (indusagi: ExtensionAPI) {
-	// Register a tool that uses ms
-	indusagi.registerTool({
-		name: "parse_duration",
-		label: "Parse Duration",
-		description: "Parse a human-readable duration string (e.g., '2 days', '1h', '5m') to milliseconds",
-		parameters: Type.Object({
-			duration: Type.String({ description: "Duration string like '2 days', '1h', '5m'" }),
-		}),
-		execute: async (_toolCallId, params) => {
-			const result = ms(params.duration as ms.StringValue);
-			if (result === undefined) {
-				return {
-					content: [{ type: "text", text: `Invalid duration: "${params.duration}"` }],
-					isError: true,
-					details: {},
-				};
-			}
-			return {
-				content: [{ type: "text", text: `${params.duration} = ${result} milliseconds` }],
-				details: {},
-			};
-		},
-	});
-}
+/**
+ * Example extension with its own npm dependencies.
+ * Tests that jiti resolves modules from the extension's own node_modules.
+ *
+ * Requires: npm install in this directory
+ */
+
+import type { ExtensionAPI } from "indusagi-coding-agent";
+import { Type } from "@sinclair/typebox";
+import ms from "ms";
+
+export default function (indusagi: ExtensionAPI) {
+	// Register a tool that uses ms
+	indusagi.registerTool({
+		name: "parse_duration",
+		label: "Parse Duration",
+		description: "Parse a human-readable duration string (e.g., '2 days', '1h', '5m') to milliseconds",
+		parameters: Type.Object({
+			duration: Type.String({ description: "Duration string like '2 days', '1h', '5m'" }),
+		}),
+		execute: async (_toolCallId, params) => {
+			const result = ms(params.duration as ms.StringValue);
+			if (result === undefined) {
+				return {
+					content: [{ type: "text", text: `Invalid duration: "${params.duration}"` }],
+					isError: true,
+					details: {},
+				};
+			}
+			return {
+				content: [{ type: "text", text: `${params.duration} = ${result} milliseconds` }],
+				details: {},
+			};
+		},
+	});
+}

package/examples/extensions/with-deps/package-lock.json

@@ -1,31 +1,31 @@
-{
-  "name": "indusagi-extension-with-deps",
-  "version": "1.14.0",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "indusagi-extension-with-deps",
-      "version": "1.14.0",
-      "dependencies": {
-        "ms": "^2.1.3"
-      },
-      "devDependencies": {
-        "@types/ms": "^2.1.0"
-      }
-    },
-    "node_modules/@types/ms": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
-      "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/ms": {
-      "version": "2.1.3",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
-      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
-      "license": "MIT"
-    }
-  }
-}
+{
+  "name": "indusagi-extension-with-deps",
+  "version": "1.14.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "indusagi-extension-with-deps",
+      "version": "1.14.0",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "devDependencies": {
+        "@types/ms": "^2.1.0"
+      }
+    },
+    "node_modules/@types/ms": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+      "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    }
+  }
+}

package/examples/extensions/with-deps/package.json

@@ -1,22 +1,22 @@
-{
-  "name": "indusagi-extension-with-deps",
-  "private": true,
-  "version": "1.14.0",
-  "type": "module",
-  "scripts": {
-    "clean": "echo 'nothing to clean'",
-    "build": "echo 'nothing to build'",
-    "check": "echo 'nothing to check'"
-  },
-  "indusagi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "dependencies": {
-    "ms": "^2.1.3"
-  },
-  "devDependencies": {
-    "@types/ms": "^2.1.0"
-  }
-}
+{
+  "name": "indusagi-extension-with-deps",
+  "private": true,
+  "version": "1.14.0",
+  "type": "module",
+  "scripts": {
+    "clean": "echo 'nothing to clean'",
+    "build": "echo 'nothing to build'",
+    "check": "echo 'nothing to check'"
+  },
+  "indusagi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "dependencies": {
+    "ms": "^2.1.3"
+  },
+  "devDependencies": {
+    "@types/ms": "^2.1.0"
+  }
+}

package/examples/sdk/01-minimal.ts

@@ -1,22 +1,22 @@
-/**
- * Minimal SDK Usage
- *
- * Uses all defaults: discovers skills, extensions, tools, context files
- * from cwd and ~/.indusagi/agent. Model chosen from settings or first available.
- */
-
-import { createAgentSession } from "indusagi-coding-agent";
-
-const { session } = await createAgentSession();
-
-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();
+/**
+ * Minimal SDK Usage
+ *
+ * Uses all defaults: discovers skills, extensions, tools, context files
+ * from cwd and ~/.indusagi/agent. Model chosen from settings or first available.
+ */
+
+import { createAgentSession } from "indusagi-coding-agent";
+
+const { session } = await createAgentSession();
+
+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();