@townco/agent 0.1.0 → 0.1.3

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

@@ -1,33 +1,49 @@
 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>;
+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,16 +1,18 @@
 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),
+	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.
+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
@@ -71,7 +73,8 @@ NOTE that you should not use this tool if there is only one trivial task to do.
      - 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),
-    }),
-});
+		schema: z.object({
+			todos: z.array(todoItemSchema),
+		}),
+	},
+);

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

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

package/dist/definition/tools/web_search.js

@@ -1,23 +1,26 @@
 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;
+	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/example.js

@@ -1,20 +1,19 @@
 #!/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"],
+	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);
+	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/index.js

@@ -1,20 +1,19 @@
 import { makeHttpTransport, makeStdioTransport } from "./acp-server";
+
 const exampleAgent = {
-    model: "claude-sonnet-4-5-20250929",
-    systemPrompt: "You are a helpful assistant.",
-    tools: ["todo_write", "get_weather", "web_search"],
-    mcps: [],
+	model: "claude-sonnet-4-5-20250929",
+	systemPrompt: "You are a helpful assistant.",
+	tools: ["todo_write", "get_weather", "web_search"],
+	mcps: [],
 };
 // 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 index.ts [stdio|http]");
-    process.exit(1);
+	makeHttpTransport(exampleAgent);
+} else if (transport === "stdio") {
+	makeStdioTransport(exampleAgent);
+} else {
+	console.error(`Invalid transport: ${transport}`);
+	console.error("Usage: bun run index.ts [stdio|http]");
+	process.exit(1);
 }

package/dist/runner/agent-runner.d.ts

@@ -13,6 +13,7 @@ export declare const zAgentRunnerParams: z.ZodObject<{
         name: z.ZodString;
         transport: z.ZodLiteral<"http">;
         url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>]>>>;
 }, z.core.$strip>;
 export type CreateAgentRunnerParams = z.infer<typeof zAgentRunnerParams>;

package/dist/runner/agent-runner.js

@@ -2,8 +2,8 @@ import { z } from "zod";
 import { McpConfigSchema } from "../definition";
 import { zToolType } from "./tools";
 export const zAgentRunnerParams = z.object({
-    systemPrompt: z.string().nullable(),
-    model: z.string(),
-    tools: z.array(zToolType).optional(),
-    mcps: z.array(McpConfigSchema).optional(),
+	systemPrompt: z.string().nullable(),
+	model: z.string(),
+	tools: z.array(zToolType).optional(),
+	mcps: z.array(McpConfigSchema).optional(),
 });

package/dist/runner/index.d.ts

@@ -1,4 +1,6 @@
 import type { AgentDefinition } from "../definition";
 import { type AgentRunner } from "./agent-runner";
 export type { AgentRunner };
-export declare const makeRunnerFromDefinition: (definition: AgentDefinition) => AgentRunner;
+export declare const makeRunnerFromDefinition: (
+	definition: AgentDefinition,
+) => AgentRunner;

package/dist/runner/index.js

@@ -1,18 +1,22 @@
 import { zAgentRunnerParams } from "./agent-runner";
 import { LangchainAgent } from "./langchain";
 export const makeRunnerFromDefinition = (definition) => {
-    const agentRunnerParams = zAgentRunnerParams.safeParse(definition);
-    if (!agentRunnerParams.success) {
-        throw new Error(`Invalid agent definition: ${agentRunnerParams.error.message}`);
-    }
-    switch (definition.harnessImplementation) {
-        case undefined:
-        case "langchain": {
-            return new LangchainAgent(agentRunnerParams.data);
-        }
-        default: {
-            const _exhaustiveCheck = definition.harnessImplementation;
-            throw new Error(`Unsupported harness implementation: ${definition.harnessImplementation}`);
-        }
-    }
+	const agentRunnerParams = zAgentRunnerParams.safeParse(definition);
+	if (!agentRunnerParams.success) {
+		throw new Error(
+			`Invalid agent definition: ${agentRunnerParams.error.message}`,
+		);
+	}
+	switch (definition.harnessImplementation) {
+		case undefined:
+		case "langchain": {
+			return new LangchainAgent(agentRunnerParams.data);
+		}
+		default: {
+			const _exhaustiveCheck = definition.harnessImplementation;
+			throw new Error(
+				`Unsupported harness implementation: ${definition.harnessImplementation}`,
+			);
+		}
+	}
 };

package/dist/runner/langchain/index.d.ts

@@ -1,15 +1,26 @@
-import type { PromptResponse, SessionNotification } from "@agentclientprotocol/sdk";
+import type {
+	PromptResponse,
+	SessionNotification,
+} from "@agentclientprotocol/sdk";
 import { type DynamicStructuredTool, type Tool } from "langchain";
-import type { AgentRunner, CreateAgentRunnerParams, InvokeRequest } from "../agent-runner";
+import type {
+	AgentRunner,
+	CreateAgentRunnerParams,
+	InvokeRequest,
+} from "../agent-runner";
 import type { ToolType } from "../tools";
 type LangchainTool = DynamicStructuredTool | Tool;
 /** Lazily-loaded langchain tools */
 type LazyLangchainTool = MakeLazy<LangchainTool>;
 type MakeLazy<T> = T extends LangchainTool ? () => T : never;
-export declare const TOOL_REGISTRY: Record<ToolType, LangchainTool | LazyLangchainTool>;
+export declare const TOOL_REGISTRY: Record<
+	ToolType,
+	LangchainTool | LazyLangchainTool
+>;
 export declare class LangchainAgent implements AgentRunner {
-    definition: CreateAgentRunnerParams;
-    constructor(params: CreateAgentRunnerParams);
-    invoke(req: InvokeRequest): AsyncGenerator<SessionNotification["update"], PromptResponse, undefined>;
+	definition: CreateAgentRunnerParams;
+	constructor(params: CreateAgentRunnerParams);
+	invoke(
+		req: InvokeRequest,
+	): AsyncGenerator<SessionNotification["update"], PromptResponse, undefined>;
 }
-export {};

package/dist/runner/langchain/index.js

@@ -198,6 +198,7 @@ const makeMcpToolsClient = (mcpConfigs) => {
                 config.name,
                 {
                     url: config.url,
+                    headers: config.headers,
                 },
             ];
         }
@@ -206,7 +207,7 @@ const makeMcpToolsClient = (mcpConfigs) => {
             {
                 transport: "stdio",
                 command: config.command,
-                args: config.args,
+                args: config.args ?? [],
             },
         ];
     });

package/dist/runner/langchain/tools/todo.d.ts

@@ -1,33 +1,49 @@
 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>;
+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/runner/langchain/tools/todo.js

@@ -1,16 +1,18 @@
 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),
+	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.
+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
@@ -71,7 +73,8 @@ NOTE that you should not use this tool if there is only one trivial task to do.
      - 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),
-    }),
-});
+		schema: z.object({
+			todos: z.array(todoItemSchema),
+		}),
+	},
+);

package/dist/runner/langchain/tools/web_search.d.ts

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

package/dist/runner/langchain/tools/web_search.js

@@ -1,23 +1,26 @@
 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;
+	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/runner/tools.d.ts

@@ -1,3 +1,9 @@
 import { z } from "zod";
-export declare const zToolType: z.ZodUnion<readonly [z.ZodLiteral<"todo_write">, z.ZodLiteral<"get_weather">, z.ZodLiteral<"web_search">]>;
+export declare const zToolType: z.ZodUnion<
+	readonly [
+		z.ZodLiteral<"todo_write">,
+		z.ZodLiteral<"get_weather">,
+		z.ZodLiteral<"web_search">,
+	]
+>;
 export type ToolType = z.infer<typeof zToolType>;

package/dist/runner/tools.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export const zToolType = z.union([
-    z.literal("todo_write"),
-    z.literal("get_weather"),
-    z.literal("web_search"),
+	z.literal("todo_write"),
+	z.literal("get_weather"),
+	z.literal("web_search"),
 ]);

package/dist/scaffold/bundle.d.ts

@@ -1,4 +1,4 @@
 /**
- * Copy necessary files from @townco/agent to the agent directory
+ * Copy necessary files from @town/agent to the agent directory
  */
 export declare function bundleAgentDependencies(agentPath: string): Promise<void>;

package/dist/scaffold/bundle.js

@@ -10,7 +10,7 @@ function getAgentPackageDir() {
     return join(dirname(currentFile), "..");
 }
 /**
- * Copy necessary files from @townco/agent to the agent directory
+ * Copy necessary files from @town/agent to the agent directory
  */
 export async function bundleAgentDependencies(agentPath) {
     const sourceDir = getAgentPackageDir();

package/dist/scaffold/copy-gui.js

@@ -6,18 +6,16 @@ import { fileURLToPath } from "node:url";
  */
 function getGuiSourceDir() {
     const currentFile = fileURLToPath(import.meta.url);
-    // When running from compiled dist:
-    // dist/scaffold/copy-gui.js -> dist/scaffold -> dist -> packages/agent -> packages -> root -> apps/gui
-    return join(dirname(currentFile), "..", "..", "..", "..", "apps", "gui");
+    // scaffold/copy-gui.ts -> scaffold -> packages/agent -> packages -> root -> apps/gui
+    return join(dirname(currentFile), "..", "..", "..", "apps", "gui");
 }
 /**
  * Get the source packages/ui directory
  */
 function getUiSourceDir() {
     const currentFile = fileURLToPath(import.meta.url);
-    // When running from compiled dist:
-    // dist/scaffold/copy-gui.js -> dist/scaffold -> dist -> packages/agent -> packages -> ui
-    return join(dirname(currentFile), "..", "..", "..", "ui");
+    // scaffold/copy-gui.ts -> scaffold -> packages/agent -> packages -> ui
+    return join(dirname(currentFile), "..", "..", "ui");
 }
 /**
  * Copy GUI app to the agent directory
@@ -85,7 +83,7 @@ export default defineConfig({
 	plugins: [react()],
 	resolve: {
 		alias: {
-			"@townco/ui": resolve(__dirname, "./ui/src"),
+			"@town/ui": resolve(__dirname, "./ui/src"),
 			// Exclude Node.js-only modules from browser bundle
 			"node:child_process": resolve(__dirname, "./polyfills/child_process.js"),
 			"node:stream": resolve(__dirname, "./polyfills/stream.js"),

package/dist/scaffold/index.d.ts

@@ -1,16 +1,18 @@
 import type { AgentDefinition } from "../definition";
 export interface ScaffoldOptions {
-    name: string;
-    definition: AgentDefinition;
-    overwrite?: boolean;
-    includeGui?: boolean;
+	name: string;
+	definition: AgentDefinition;
+	overwrite?: boolean;
+	includeGui?: boolean;
 }
 export interface ScaffoldResult {
-    success: boolean;
-    path: string;
-    error?: string;
+	success: boolean;
+	path: string;
+	error?: string;
 }
 /**
  * Scaffold a new agent package
  */
-export declare function scaffoldAgent(options: ScaffoldOptions): Promise<ScaffoldResult>;
+export declare function scaffoldAgent(
+	options: ScaffoldOptions,
+): Promise<ScaffoldResult>;