@townco/agent 0.1.22 → 0.1.23

package/dist/utils/index.d.ts

@@ -1 +1,2 @@
 export * from "./logger.js";
+export * from "./tool.js";

package/dist/utils/index.js

@@ -1 +1,2 @@
 export * from "./logger.js";
+export * from "./tool.js";

package/dist/utils/tool.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { CustomToolModule } from "../runner/tool-loader";
+/**
+ * Direct tool type that can be passed to AgentDefinition.
+ * This is the resolved form of a custom tool that can be used directly
+ * in the tools array without requiring file path resolution.
+ */
+export type DirectTool = {
+    type: "direct";
+    name: string;
+    description: string;
+    fn: (input: unknown) => unknown | Promise<unknown>;
+    schema: z.ZodTypeAny;
+};
+/**
+ * Transforms an imported custom tool module into a DirectTool that can be
+ * used in AgentDefinition.tools.
+ *
+ * @example
+ * ```typescript
+ * import * as addTwoNumbers from "./tools/add-two-numbers";
+ * import { createTool } from "@townco/agent/utils";
+ *
+ * const agent: AgentDefinition = {
+ *   model: "claude-sonnet-4-5-20250929",
+ *   systemPrompt: "You are a helpful assistant.",
+ *   tools: [
+ *     createTool(addTwoNumbers)
+ *   ]
+ * };
+ * ```
+ *
+ * @param module - A custom tool module with default export (function), schema, name, and description
+ * @returns A DirectTool object ready to be used in AgentDefinition.tools
+ */
+export declare function createTool(module: CustomToolModule): DirectTool;

package/dist/utils/tool.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/**
+ * Transforms an imported custom tool module into a DirectTool that can be
+ * used in AgentDefinition.tools.
+ *
+ * @example
+ * ```typescript
+ * import * as addTwoNumbers from "./tools/add-two-numbers";
+ * import { createTool } from "@townco/agent/utils";
+ *
+ * const agent: AgentDefinition = {
+ *   model: "claude-sonnet-4-5-20250929",
+ *   systemPrompt: "You are a helpful assistant.",
+ *   tools: [
+ *     createTool(addTwoNumbers)
+ *   ]
+ * };
+ * ```
+ *
+ * @param module - A custom tool module with default export (function), schema, name, and description
+ * @returns A DirectTool object ready to be used in AgentDefinition.tools
+ */
+export function createTool(module) {
+    // Resolve schema: if it's a function, call it with z injected
+    const schema = typeof module.schema === "function" ? module.schema(z) : module.schema;
+    return {
+        type: "direct",
+        name: module.name,
+        description: module.description,
+        fn: module.default,
+        schema,
+    };
+}

package/index.ts

@@ -1,13 +1,17 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
 import { makeHttpTransport, makeStdioTransport } from "./acp-server";
 import type { AgentDefinition } from "./definition";
 
-// Load agent definition from shared JSON file at repo root
-const configPath = join(import.meta.dir, "../../agent.json");
-const exampleAgent: AgentDefinition = JSON.parse(
-  readFileSync(configPath, "utf-8"),
-);
+const exampleAgent: AgentDefinition = {
+  model: "claude-sonnet-4-5-20250929",
+  systemPrompt: "You are a helpful assistant.",
+  tools: [
+    "todo_write",
+    "get_weather",
+    "web_search",
+    { type: "filesystem", working_directory: "/Users/michael/code/town" },
+  ],
+  mcps: [],
+};
 
 // Parse transport type from command line argument
 const transport = process.argv[2] || "stdio";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@townco/agent",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "type": "module",
   "module": "index.ts",
   "files": [
@@ -57,13 +57,14 @@
     "@langchain/core": "^1.0.3",
     "@langchain/exa": "^0.1.0",
     "@langchain/mcp-adapters": "^1.0.0",
-    "@townco/gui-template": "0.1.14",
-    "@townco/tui-template": "0.1.14",
-    "@townco/tsconfig": "0.1.14",
-    "@townco/ui": "0.1.17",
+    "@townco/gui-template": "0.1.15",
+    "@townco/tsconfig": "0.1.15",
+    "@townco/tui-template": "0.1.15",
+    "@townco/ui": "0.1.18",
     "exa-js": "^2.0.0",
     "hono": "^4.10.4",
     "langchain": "^1.0.3",
+    "prettier": "^3.6.2",
     "zod": "^4.1.12"
   },
   "devDependencies": {

package/templates/index.ts

@@ -1,3 +1,4 @@
+import * as prettier from "prettier";
 import type { AgentDefinition } from "../definition";
 
 export interface TemplateVars {
@@ -7,6 +8,14 @@ export interface TemplateVars {
     | string
     | { type: "custom"; modulePath: string }
     | { type: "filesystem"; working_directory?: string | undefined }
+    | {
+        type: "direct";
+        name: string;
+        description: string;
+        // biome-ignore lint/suspicious/noExplicitAny: fn type is complex (Zod inferred)
+        fn: any;
+        schema: unknown;
+      }
   >;
   systemPrompt: string | null;
   hasWebSearch: boolean;
@@ -65,15 +74,18 @@ export function generatePackageJson(vars: TemplateVars): string {
   return JSON.stringify(pkg, null, 2);
 }
 
-export function generateIndexTs(): string {
-  return `import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { makeHttpTransport, makeStdioTransport } from "@townco/agent/acp-server";
+export async function generateIndexTs(vars: TemplateVars): Promise<string> {
+  const agentDef = {
+    model: vars.model,
+    systemPrompt: vars.systemPrompt,
+    tools: vars.tools,
+  };
+  return prettier.format(
+    `import { makeHttpTransport, makeStdioTransport } from "@townco/agent/acp-server";
 import type { AgentDefinition } from "@townco/agent/definition";
 
 // Load agent definition from JSON file
-const configPath = join(import.meta.dir, "agent.json");
-const agent: AgentDefinition = JSON.parse(readFileSync(configPath, "utf-8"));
+const agent: AgentDefinition = ${JSON.stringify(agentDef)};
 
 const transport = process.argv[2] || "stdio";
 
@@ -85,22 +97,14 @@ if (transport === "http") {
 	console.error(\`Invalid transport: \${transport}\`);
 	process.exit(1);
 }
-`;
-}
-
-export function generateAgentJson(vars: TemplateVars): string {
-  const agentDef = {
-    model: vars.model,
-    systemPrompt: vars.systemPrompt,
-    tools: vars.tools,
-  };
-
-  return JSON.stringify(agentDef, null, 2);
+`,
+    { parser: "typescript" },
+  );
 }
 
 export function generateBinTs(): string {
   return `#!/usr/bin/env bun
-import "./index.js";
+import "./index.ts";
 `;
 }
 
@@ -142,6 +146,7 @@ export function generateReadme(vars: TemplateVars): string {
             if (tool.type === "custom") return tool.modulePath;
             if (tool.type === "filesystem")
               return `filesystem${tool.working_directory ? ` (${tool.working_directory})` : ""}`;
+            if (tool.type === "direct") return tool.name;
             return "";
           })
           .join(", ")

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);
-}