@townco/agent 0.1.37 → 0.1.39

package/index.ts

@@ -25,8 +25,15 @@ const exampleAgent: AgentDefinition = {
   mcps: [],
 };
 
-// Parse transport type from command line argument
-const transport = process.argv[2] || "stdio";
+// Parse transport type and flags from command line arguments
+const args = process.argv.slice(2);
+const transport = args.find((arg) => !arg.startsWith("--")) || "stdio";
+const noSession = args.includes("--no-session");
+
+// Set TOWN_NO_SESSION environment variable if flag is present
+if (noSession) {
+  process.env.TOWN_NO_SESSION = "true";
+}
 
 // Get agent directory and name for session storage
 const agentDir = process.cwd();
@@ -38,6 +45,6 @@ if (transport === "http") {
   makeStdioTransport(exampleAgent);
 } else {
   console.error(`Invalid transport: ${transport}`);
-  console.error("Usage: bun run index.ts [stdio|http]");
+  console.error("Usage: bun run index.ts [stdio|http] [--no-session]");
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@townco/agent",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "type": "module",
   "module": "index.ts",
   "files": [
@@ -56,11 +56,11 @@
     "@langchain/google-genai": "^1.0.3",
     "@langchain/google-vertexai": "^1.0.3",
     "@langchain/mcp-adapters": "^1.0.0",
-    "@townco/core": "0.0.10",
-    "@townco/gui-template": "0.1.29",
-    "@townco/tsconfig": "0.1.29",
-    "@townco/tui-template": "0.1.29",
-    "@townco/ui": "0.1.32",
+    "@townco/core": "0.0.12",
+    "@townco/gui-template": "0.1.31",
+    "@townco/tsconfig": "0.1.31",
+    "@townco/tui-template": "0.1.31",
+    "@townco/ui": "0.1.34",
     "exa-js": "^2.0.0",
     "hono": "^4.10.4",
     "langchain": "^1.0.3",

package/dist/definition/tools/todo.d.ts

@@ -1,49 +0,0 @@
-import { z } from "zod";
-export declare const todoItemSchema: z.ZodObject<
-	{
-		content: z.ZodString;
-		status: z.ZodEnum<{
-			pending: "pending";
-			in_progress: "in_progress";
-			completed: "completed";
-		}>;
-		activeForm: z.ZodString;
-	},
-	z.core.$strip
->;
-export declare const todoWrite: import("langchain").DynamicStructuredTool<
-	z.ZodObject<
-		{
-			todos: z.ZodArray<
-				z.ZodObject<
-					{
-						content: z.ZodString;
-						status: z.ZodEnum<{
-							pending: "pending";
-							in_progress: "in_progress";
-							completed: "completed";
-						}>;
-						activeForm: z.ZodString;
-					},
-					z.core.$strip
-				>
-			>;
-		},
-		z.core.$strip
-	>,
-	{
-		todos: {
-			content: string;
-			status: "pending" | "in_progress" | "completed";
-			activeForm: string;
-		}[];
-	},
-	{
-		todos: {
-			content: string;
-			status: "pending" | "in_progress" | "completed";
-			activeForm: string;
-		}[];
-	},
-	string
->;

package/dist/definition/tools/todo.js

@@ -1,80 +0,0 @@
-import { tool } from "langchain";
-import { z } from "zod";
-export const todoItemSchema = z.object({
-	content: z.string().min(1),
-	status: z.enum(["pending", "in_progress", "completed"]),
-	activeForm: z.string().min(1),
-});
-export const todoWrite = tool(
-	({ todos }) => {
-		// Simple implementation that confirms the todos were written
-		return `Successfully updated todo list with ${todos.length} items`;
-	},
-	{
-		name: "todo_write",
-		description: `Use this tool to create and manage a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
-
-## When to Use This Tool
-Use this tool proactively in these scenarios:
-
-1. Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-2. Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-3. User explicitly requests todo list - When the user directly asks you to use the todo list
-4. User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-5. After receiving new instructions - Immediately capture user requirements as todos
-6. When you start working on a task - Mark it as in_progress BEFORE beginning work. Ideally you should only have one todo as in_progress at a time
-7. After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
-
-## When NOT to Use This Tool
-
-Skip using this tool when:
-1. There is only a single, straightforward task
-2. The task is trivial and tracking it provides no organizational benefit
-3. The task can be completed in less than 3 trivial steps
-4. The task is purely conversational or informational
-
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
-
-## Task States and Management
-
-1. **Task States**: Use these states to track progress:
-   - pending: Task not yet started
-   - in_progress: Currently working on (limit to ONE task at a time)
-   - completed: Task finished successfully
-
-   **IMPORTANT**: Task descriptions must have two forms:
-   - content: The imperative form describing what needs to be done (e.g., "Run tests", "Build the project")
-   - activeForm: The present continuous form shown during execution (e.g., "Running tests", "Building the project")
-
-2. **Task Management**:
-   - Update task status in real-time as you work
-   - Mark tasks complete IMMEDIATELY after finishing (don't batch completions)
-   - Exactly ONE task must be in_progress at any time (not less, not more)
-   - Complete current tasks before starting new ones
-   - Remove tasks that are no longer relevant from the list entirely
-
-3. **Task Completion Requirements**:
-   - ONLY mark a task as completed when you have FULLY accomplished it
-   - If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-   - When blocked, create a new task describing what needs to be resolved
-   - Never mark a task as completed if:
-     - Tests are failing
-     - Implementation is partial
-     - You encountered unresolved errors
-     - You couldn't find necessary files or dependencies
-
-4. **Task Breakdown**:
-   - Create specific, actionable items
-   - Break complex tasks into smaller, manageable steps
-   - Use clear, descriptive task names
-   - Always provide both forms:
-     - content: "Fix authentication bug"
-     - activeForm: "Fixing authentication bug"
-
-When in doubt, use this tool. Being proactive with task management demonstrates attentiveness and ensures you complete all requirements successfully.`,
-		schema: z.object({
-			todos: z.array(todoItemSchema),
-		}),
-	},
-);

package/dist/definition/tools/web_search.d.ts

@@ -1,4 +0,0 @@
-import { ExaSearchResults } from "@langchain/exa";
-export declare function makeWebSearchTool(): ExaSearchResults<{
-	text: true;
-}>;

package/dist/definition/tools/web_search.js

@@ -1,26 +0,0 @@
-import { ExaSearchResults } from "@langchain/exa";
-import Exa from "exa-js";
-
-let _webSearchInstance = null;
-export function makeWebSearchTool() {
-	if (_webSearchInstance) {
-		return _webSearchInstance;
-	}
-	const apiKey = process.env.EXA_API_KEY;
-	if (!apiKey) {
-		throw new Error(
-			"EXA_API_KEY environment variable is required to use the web_search tool. " +
-				"Please set it to your Exa API key from https://exa.ai",
-		);
-	}
-	const client = new Exa(apiKey);
-	_webSearchInstance = new ExaSearchResults({
-		client,
-		searchArgs: {
-			numResults: 5,
-			type: "auto",
-			text: true,
-		},
-	});
-	return _webSearchInstance;
-}

package/dist/dev-agent/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-export {};

package/dist/dev-agent/index.js

@@ -1,18 +0,0 @@
-#!/usr/bin/env bun
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { makeHttpTransport, makeStdioTransport } from "../acp-server/index";
-// Load agent definition from JSON file
-const configPath = join(import.meta.dir, "agent.json");
-const agent = JSON.parse(readFileSync(configPath, "utf-8"));
-const transport = process.argv[2] || "stdio";
-if (transport === "http") {
-    makeHttpTransport(agent);
-}
-else if (transport === "stdio") {
-    makeStdioTransport(agent);
-}
-else {
-    console.error(`Invalid transport: ${transport}`);
-    process.exit(1);
-}

package/dist/example.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-export {};

package/dist/example.js

@@ -1,19 +0,0 @@
-#!/usr/bin/env bun
-import { makeHttpTransport, makeStdioTransport } from "./acp-server/index.js";
-
-const exampleAgent = {
-	model: "claude-sonnet-4-5-20250929",
-	systemPrompt: "You are a helpful assistant.",
-	tools: ["todo_write", "get_weather", "web_search"],
-};
-// Parse transport type from command line argument
-const transport = process.argv[2] || "stdio";
-if (transport === "http") {
-	makeHttpTransport(exampleAgent);
-} else if (transport === "stdio") {
-	makeStdioTransport(exampleAgent);
-} else {
-	console.error(`Invalid transport: ${transport}`);
-	console.error("Usage: bun run example.ts [stdio|http]");
-	process.exit(1);
-}

package/dist/utils/logger.d.ts

@@ -1,39 +0,0 @@
-/**
- * Node.js logger with file rotation support
- * Outputs to both stdout and .logs/<service>.log files
- */
-export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
-export declare class Logger {
-    private service;
-    private minLevel;
-    private logFilePath;
-    private logsDir;
-    private writeQueue;
-    private isWriting;
-    private silent;
-    constructor(service: string, minLevel?: LogLevel, options?: {
-        silent?: boolean;
-        logsDir?: string;
-    });
-    private ensureLogsDirectory;
-    private shouldLog;
-    private rotateLogFile;
-    private writeToFile;
-    private log;
-    trace(message: string, metadata?: Record<string, unknown>): void;
-    debug(message: string, metadata?: Record<string, unknown>): void;
-    info(message: string, metadata?: Record<string, unknown>): void;
-    warn(message: string, metadata?: Record<string, unknown>): void;
-    error(message: string, metadata?: Record<string, unknown>): void;
-    fatal(message: string, metadata?: Record<string, unknown>): void;
-}
-/**
- * Create a logger instance for a service
- * @param service - Service name (e.g., "gui", "http-agent", "tui")
- * @param minLevel - Minimum log level to display (default: "debug")
- * @param options - Logger options (silent mode, custom logs directory, etc.)
- */
-export declare function createLogger(service: string, minLevel?: LogLevel, options?: {
-    silent?: boolean;
-    logsDir?: string;
-}): Logger;

package/dist/utils/logger.js

@@ -1,175 +0,0 @@
-/**
- * Node.js logger with file rotation support
- * Outputs to both stdout and .logs/<service>.log files
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-const LOG_LEVELS = {
-    trace: 0,
-    debug: 1,
-    info: 2,
-    warn: 3,
-    error: 4,
-    fatal: 5,
-};
-// ANSI color codes for terminal output
-const LOG_COLORS = {
-    trace: "\x1b[90m", // gray
-    debug: "\x1b[34m", // blue
-    info: "\x1b[32m", // green
-    warn: "\x1b[33m", // yellow
-    error: "\x1b[31m", // red
-    fatal: "\x1b[41m\x1b[37m", // white on red background
-};
-const RESET = "\x1b[0m";
-const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10MB
-const MAX_ROTATED_FILES = 5;
-export class Logger {
-    service;
-    minLevel;
-    logFilePath;
-    logsDir;
-    writeQueue = [];
-    isWriting = false;
-    silent;
-    constructor(service, minLevel = "debug", options) {
-        this.service = service;
-        this.minLevel = minLevel;
-        this.silent = options?.silent ?? false;
-        // Setup log file path - use custom logsDir if provided, otherwise use process.cwd()
-        const baseDir = options?.logsDir ?? process.cwd();
-        this.logsDir = path.join(baseDir, ".logs");
-        this.logFilePath = path.join(this.logsDir, `${service}.log`);
-        // Create logs directory if it doesn't exist
-        this.ensureLogsDirectory();
-    }
-    ensureLogsDirectory() {
-        try {
-            if (!fs.existsSync(this.logsDir)) {
-                fs.mkdirSync(this.logsDir, { recursive: true });
-            }
-        }
-        catch (error) {
-            console.error("Failed to create logs directory:", error);
-        }
-    }
-    shouldLog(level) {
-        return LOG_LEVELS[level] >= LOG_LEVELS[this.minLevel];
-    }
-    rotateLogFile() {
-        try {
-            // Check if rotation is needed
-            if (!fs.existsSync(this.logFilePath)) {
-                return;
-            }
-            const stats = fs.statSync(this.logFilePath);
-            if (stats.size < MAX_LOG_SIZE) {
-                return;
-            }
-            // Remove oldest rotated file if it exists
-            const oldestFile = `${this.logFilePath}.${MAX_ROTATED_FILES}`;
-            if (fs.existsSync(oldestFile)) {
-                fs.unlinkSync(oldestFile);
-            }
-            // Rotate existing files
-            for (let i = MAX_ROTATED_FILES - 1; i >= 1; i--) {
-                const oldFile = `${this.logFilePath}.${i}`;
-                const newFile = `${this.logFilePath}.${i + 1}`;
-                if (fs.existsSync(oldFile)) {
-                    fs.renameSync(oldFile, newFile);
-                }
-            }
-            // Rotate current log file
-            fs.renameSync(this.logFilePath, `${this.logFilePath}.1`);
-        }
-        catch (error) {
-            console.error("Failed to rotate log file:", error);
-        }
-    }
-    async writeToFile(content) {
-        this.writeQueue.push(content);
-        if (this.isWriting) {
-            return;
-        }
-        this.isWriting = true;
-        while (this.writeQueue.length > 0) {
-            const batch = this.writeQueue.splice(0, this.writeQueue.length);
-            const data = `${batch.join("\n")}\n`;
-            try {
-                // Check if rotation is needed before writing
-                this.rotateLogFile();
-                // Append to log file
-                await fs.promises.appendFile(this.logFilePath, data, "utf-8");
-            }
-            catch (error) {
-                console.error("Failed to write to log file:", error);
-            }
-        }
-        this.isWriting = false;
-    }
-    log(level, message, metadata) {
-        if (!this.shouldLog(level)) {
-            return;
-        }
-        const entry = {
-            timestamp: new Date().toISOString(),
-            level,
-            service: this.service,
-            message,
-            ...(metadata && { metadata }),
-        };
-        // Console output with color-coding
-        const color = LOG_COLORS[level];
-        const levelUpper = level.toUpperCase().padEnd(5);
-        const prefix = `${color}[${entry.timestamp}] [${this.service}] [${levelUpper}]${RESET}`;
-        const formattedMessage = metadata
-            ? `${message} ${JSON.stringify(metadata)}`
-            : message;
-        // Output to stdout/stderr (unless silent)
-        if (!this.silent) {
-            if (level === "error" || level === "fatal") {
-                console.error(`${prefix} ${formattedMessage}`);
-            }
-            else if (level === "warn") {
-                console.warn(`${prefix} ${formattedMessage}`);
-            }
-            else {
-                console.log(`${prefix} ${formattedMessage}`);
-            }
-        }
-        // Write to file (JSON format)
-        const jsonLine = JSON.stringify(entry);
-        this.writeToFile(jsonLine).catch((error) => {
-            if (!this.silent) {
-                console.error("Failed to queue log write:", error);
-            }
-        });
-    }
-    trace(message, metadata) {
-        this.log("trace", message, metadata);
-    }
-    debug(message, metadata) {
-        this.log("debug", message, metadata);
-    }
-    info(message, metadata) {
-        this.log("info", message, metadata);
-    }
-    warn(message, metadata) {
-        this.log("warn", message, metadata);
-    }
-    error(message, metadata) {
-        this.log("error", message, metadata);
-    }
-    fatal(message, metadata) {
-        this.log("fatal", message, metadata);
-    }
-}
-/**
- * Create a logger instance for a service
- * @param service - Service name (e.g., "gui", "http-agent", "tui")
- * @param minLevel - Minimum log level to display (default: "debug")
- * @param options - Logger options (silent mode, custom logs directory, etc.)
- */
-export function createLogger(service, minLevel = "debug", options) {
-    return new Logger(service, minLevel, options);
-}