indusagi-coding-agent 0.1.0 → 0.1.2

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

@@ -1,40 +1,40 @@
-/**
- * Context Files (AGENTS.md)
- *
- * Context files provide project-specific instructions loaded into the system prompt.
- */
-
-import { createAgentSession, DefaultResourceLoader, SessionManager } from "indusagi-coding-agent";
-
-// Disable context files entirely by returning an empty list in agentsFilesOverride.
-const loader = new DefaultResourceLoader({
-	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)`);
-}
-
-await createAgentSession({
-	resourceLoader: loader,
-	sessionManager: SessionManager.inMemory(),
-});
-
-console.log(`Session created with ${discovered.length + 1} context files`);
+/**
+ * Context Files (AGENTS.md)
+ *
+ * Context files provide project-specific instructions loaded into the system prompt.
+ */
+
+import { createAgentSession, DefaultResourceLoader, SessionManager } from "indusagi-coding-agent";
+
+// Disable context files entirely by returning an empty list in agentsFilesOverride.
+const loader = new DefaultResourceLoader({
+	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)`);
+}
+
+await createAgentSession({
+	resourceLoader: loader,
+	sessionManager: SessionManager.inMemory(),
+});
+
+console.log(`Session created with ${discovered.length + 1} context files`);

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

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

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

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

package/examples/sdk/10-settings.ts

@@ -1,38 +1,38 @@
-/**
- * Settings Configuration
- *
- * Override settings using SettingsManager.
- */
-
-import { createAgentSession, SessionManager, SettingsManager } from "indusagi-coding-agent";
-
-// Load current settings (merged global + project)
-const settingsManagerFromDisk = SettingsManager.create();
-console.log("Current settings:", JSON.stringify(settingsManagerFromDisk.getGlobalSettings(), null, 2));
-
-// Override specific settings
-const settingsManager = SettingsManager.create();
-settingsManager.applyOverrides({
-	compaction: { enabled: false },
-	retry: { enabled: true, maxRetries: 5, baseDelayMs: 1000 },
-});
-
-await createAgentSession({
-	settingsManager,
-	sessionManager: SessionManager.inMemory(),
-});
-
-console.log("Session created with custom settings");
-
-// For testing without file I/O:
-const inMemorySettings = SettingsManager.inMemory({
-	compaction: { enabled: false },
-	retry: { enabled: false },
-});
-
-await createAgentSession({
-	settingsManager: inMemorySettings,
-	sessionManager: SessionManager.inMemory(),
-});
-
-console.log("Test session created with in-memory settings");
+/**
+ * Settings Configuration
+ *
+ * Override settings using SettingsManager.
+ */
+
+import { createAgentSession, SessionManager, SettingsManager } from "indusagi-coding-agent";
+
+// Load current settings (merged global + project)
+const settingsManagerFromDisk = SettingsManager.create();
+console.log("Current settings:", JSON.stringify(settingsManagerFromDisk.getGlobalSettings(), null, 2));
+
+// Override specific settings
+const settingsManager = SettingsManager.create();
+settingsManager.applyOverrides({
+	compaction: { enabled: false },
+	retry: { enabled: true, maxRetries: 5, baseDelayMs: 1000 },
+});
+
+await createAgentSession({
+	settingsManager,
+	sessionManager: SessionManager.inMemory(),
+});
+
+console.log("Session created with custom settings");
+
+// For testing without file I/O:
+const inMemorySettings = SettingsManager.inMemory({
+	compaction: { enabled: false },
+	retry: { enabled: false },
+});
+
+await createAgentSession({
+	settingsManager: inMemorySettings,
+	sessionManager: SessionManager.inMemory(),
+});
+
+console.log("Test session created with in-memory settings");

package/examples/sdk/11-sessions.ts

@@ -1,48 +1,48 @@
-/**
- * Session Management
- *
- * Control session persistence: in-memory, new file, continue, or open specific.
- */
-
-import { createAgentSession, SessionManager } from "indusagi-coding-agent";
-
-// In-memory (no persistence)
-const { session: inMemory } = await createAgentSession({
-	sessionManager: SessionManager.inMemory(),
-});
-console.log("In-memory session:", inMemory.sessionFile ?? "(none)");
-
-// New persistent session
-const { session: newSession } = await createAgentSession({
-	sessionManager: SessionManager.create(process.cwd()),
-});
-console.log("New session file:", newSession.sessionFile);
-
-// Continue most recent session (or create new if none)
-const { session: continued, modelFallbackMessage } = await createAgentSession({
-	sessionManager: SessionManager.continueRecent(process.cwd()),
-});
-if (modelFallbackMessage) console.log("Note:", modelFallbackMessage);
-console.log("Continued session:", continued.sessionFile);
-
-// List and open specific session
-const sessions = await SessionManager.list(process.cwd());
-console.log(`\nFound ${sessions.length} sessions:`);
-for (const info of sessions.slice(0, 3)) {
-	console.log(`  ${info.id.slice(0, 8)}... - "${info.firstMessage.slice(0, 30)}..."`);
-}
-
-if (sessions.length > 0) {
-	const { session: opened } = await createAgentSession({
-		sessionManager: SessionManager.open(sessions[0].path),
-	});
-	console.log(`\nOpened: ${opened.sessionId}`);
-}
-
-// Custom session directory (no cwd encoding)
-// const customDir = "/path/to/my-sessions";
-// const { session } = await createAgentSession({
-//   sessionManager: SessionManager.create(process.cwd(), customDir),
-// });
-// SessionManager.list(process.cwd(), customDir);
-// SessionManager.continueRecent(process.cwd(), customDir);
+/**
+ * Session Management
+ *
+ * Control session persistence: in-memory, new file, continue, or open specific.
+ */
+
+import { createAgentSession, SessionManager } from "indusagi-coding-agent";
+
+// In-memory (no persistence)
+const { session: inMemory } = await createAgentSession({
+	sessionManager: SessionManager.inMemory(),
+});
+console.log("In-memory session:", inMemory.sessionFile ?? "(none)");
+
+// New persistent session
+const { session: newSession } = await createAgentSession({
+	sessionManager: SessionManager.create(process.cwd()),
+});
+console.log("New session file:", newSession.sessionFile);
+
+// Continue most recent session (or create new if none)
+const { session: continued, modelFallbackMessage } = await createAgentSession({
+	sessionManager: SessionManager.continueRecent(process.cwd()),
+});
+if (modelFallbackMessage) console.log("Note:", modelFallbackMessage);
+console.log("Continued session:", continued.sessionFile);
+
+// List and open specific session
+const sessions = await SessionManager.list(process.cwd());
+console.log(`\nFound ${sessions.length} sessions:`);
+for (const info of sessions.slice(0, 3)) {
+	console.log(`  ${info.id.slice(0, 8)}... - "${info.firstMessage.slice(0, 30)}..."`);
+}
+
+if (sessions.length > 0) {
+	const { session: opened } = await createAgentSession({
+		sessionManager: SessionManager.open(sessions[0].path),
+	});
+	console.log(`\nOpened: ${opened.sessionId}`);
+}
+
+// Custom session directory (no cwd encoding)
+// const customDir = "/path/to/my-sessions";
+// const { session } = await createAgentSession({
+//   sessionManager: SessionManager.create(process.cwd(), customDir),
+// });
+// SessionManager.list(process.cwd(), customDir);
+// SessionManager.continueRecent(process.cwd(), customDir);

package/examples/sdk/12-full-control.ts

@@ -1,82 +1,82 @@
-/**
- * Full Control
- *
- * Replace everything - no discovery, explicit configuration.
- *
- * IMPORTANT: When providing `tools` with a custom `cwd`, use the tool factory
- * functions (createReadTool, createBashTool, etc.) to ensure tools resolve
- * paths relative to your cwd.
- */
-
-import { getModel } from "indusagi/ai";
-import {
-	AuthStorage,
-	createAgentSession,
-	createBashTool,
-	createExtensionRuntime,
-	createReadTool,
-	ModelRegistry,
-	type ResourceLoader,
-	SessionManager,
-	SettingsManager,
-} from "indusagi-coding-agent";
-
-// Custom auth storage location
-const authStorage = new AuthStorage("/tmp/my-agent/auth.json");
-
-// Runtime API key override (not persisted)
-if (process.env.MY_ANTHROPIC_KEY) {
-	authStorage.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
-}
-
-// Model registry with no custom models.json
-const modelRegistry = new ModelRegistry(authStorage);
-
-const model = getModel("anthropic", "claude-sonnet-4-20250514");
-if (!model) throw new Error("Model not found");
-
-// In-memory settings with overrides
-const settingsManager = SettingsManager.inMemory({
-	compaction: { enabled: false },
-	retry: { enabled: true, maxRetries: 2 },
-});
-
-// When using a custom cwd with explicit tools, use the factory functions
-const cwd = process.cwd();
-
-const resourceLoader: ResourceLoader = {
-	getExtensions: () => ({ extensions: [], errors: [], runtime: createExtensionRuntime() }),
-	getSkills: () => ({ skills: [], diagnostics: [] }),
-	getPrompts: () => ({ prompts: [], diagnostics: [] }),
-	getThemes: () => ({ themes: [], diagnostics: [] }),
-	getAgentsFiles: () => ({ agentsFiles: [] }),
-	getSystemPrompt: () => `You are a minimal assistant.
-Available: read, bash. Be concise.`,
-	getAppendSystemPrompt: () => [],
-	getPathMetadata: () => new Map(),
-	reload: async () => {},
-};
-
-const { session } = await createAgentSession({
-	cwd,
-	agentDir: "/tmp/my-agent",
-	model,
-	thinkingLevel: "off",
-	authStorage,
-	modelRegistry,
-	resourceLoader,
-	// Use factory functions with the same cwd to ensure path resolution works correctly
-	tools: [createReadTool(cwd), createBashTool(cwd)],
-	sessionManager: SessionManager.inMemory(),
-	settingsManager,
-});
-
-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();
-
+/**
+ * Full Control
+ *
+ * Replace everything - no discovery, explicit configuration.
+ *
+ * IMPORTANT: When providing `tools` with a custom `cwd`, use the tool factory
+ * functions (createReadTool, createBashTool, etc.) to ensure tools resolve
+ * paths relative to your cwd.
+ */
+
+import { getModel } from "indusagi/ai";
+import {
+	AuthStorage,
+	createAgentSession,
+	createBashTool,
+	createExtensionRuntime,
+	createReadTool,
+	ModelRegistry,
+	type ResourceLoader,
+	SessionManager,
+	SettingsManager,
+} from "indusagi-coding-agent";
+
+// Custom auth storage location
+const authStorage = new AuthStorage("/tmp/my-agent/auth.json");
+
+// Runtime API key override (not persisted)
+if (process.env.MY_ANTHROPIC_KEY) {
+	authStorage.setRuntimeApiKey("anthropic", process.env.MY_ANTHROPIC_KEY);
+}
+
+// Model registry with no custom models.json
+const modelRegistry = new ModelRegistry(authStorage);
+
+const model = getModel("anthropic", "claude-sonnet-4-20250514");
+if (!model) throw new Error("Model not found");
+
+// In-memory settings with overrides
+const settingsManager = SettingsManager.inMemory({
+	compaction: { enabled: false },
+	retry: { enabled: true, maxRetries: 2 },
+});
+
+// When using a custom cwd with explicit tools, use the factory functions
+const cwd = process.cwd();
+
+const resourceLoader: ResourceLoader = {
+	getExtensions: () => ({ extensions: [], errors: [], runtime: createExtensionRuntime() }),
+	getSkills: () => ({ skills: [], diagnostics: [] }),
+	getPrompts: () => ({ prompts: [], diagnostics: [] }),
+	getThemes: () => ({ themes: [], diagnostics: [] }),
+	getAgentsFiles: () => ({ agentsFiles: [] }),
+	getSystemPrompt: () => `You are a minimal assistant.
+Available: read, bash. Be concise.`,
+	getAppendSystemPrompt: () => [],
+	getPathMetadata: () => new Map(),
+	reload: async () => {},
+};
+
+const { session } = await createAgentSession({
+	cwd,
+	agentDir: "/tmp/my-agent",
+	model,
+	thinkingLevel: "off",
+	authStorage,
+	modelRegistry,
+	resourceLoader,
+	// Use factory functions with the same cwd to ensure path resolution works correctly
+	tools: [createReadTool(cwd), createBashTool(cwd)],
+	sessionManager: SessionManager.inMemory(),
+	settingsManager,
+});
+
+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();
+