@townco/agent 0.1.85 → 0.1.88

package/dist/acp-server/adapter.d.ts

@@ -43,10 +43,6 @@ export declare class AgentAcpAdapter implements acp.Agent {
      * This provides info about subagents configured via makeSubagentsTool.
      */
     private getSubagentsMetadata;
-    /**
-     * Helper to save session to disk
-     * Call this after any modification to session.messages or session.context
-     */
     private saveSessionToDisk;
     initialize(_params: acp.InitializeRequest): Promise<acp.InitializeResponse>;
     newSession(params: acp.NewSessionRequest): Promise<acp.NewSessionResponse>;
@@ -60,10 +56,6 @@ export declare class AgentAcpAdapter implements acp.Agent {
     setSessionMode(_params: acp.SetSessionModeRequest): Promise<acp.SetSessionModeResponse>;
     prompt(params: acp.PromptRequest): Promise<acp.PromptResponse>;
     private _promptImpl;
-    /**
-     * Execute hooks if configured for this agent
-     * Returns new context entries that should be appended to session.context
-     */
     private executeHooksIfConfigured;
     private _executeHooksImpl;
     cancel(params: acp.CancelNotification): Promise<void>;

package/dist/runner/hooks/executor.d.ts

@@ -27,9 +27,6 @@ export declare class HookExecutor {
         newContextEntries: ContextEntry[];
         notifications: HookNotification[];
     }>;
-    /**
-     * Execute a context_size hook
-     */
     private executeContextSizeHook;
     /**
      * Execute tool_response hooks when a tool returns output
@@ -46,8 +43,5 @@ export declare class HookExecutor {
         metadata?: Record<string, unknown>;
         notifications: HookNotification[];
     }>;
-    /**
-     * Execute a single tool_response hook
-     */
     private executeToolResponseHook;
 }

package/dist/runner/index.d.ts

@@ -1,4 +1,53 @@
-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: {
+    displayName?: string | undefined;
+    version?: string | undefined;
+    description?: string | undefined;
+    suggestedPrompts?: string[] | undefined;
+    systemPrompt: string | null;
+    model: string;
+    tools?: (string | {
+        type: "custom";
+        modulePath: string;
+    } | {
+        type: "filesystem";
+        working_directory?: string | undefined;
+    } | {
+        type: "direct";
+        name: string;
+        description: string;
+        fn: import("zod/v4/core").$InferOuterFunctionType<import("zod/v4/core").$ZodFunctionArgs, import("zod/v4/core").$ZodFunctionOut>;
+        schema: any;
+        prettyName?: string | undefined;
+        icon?: string | undefined;
+    })[] | undefined;
+    mcps?: (string | {
+        name: string;
+        transport: "stdio";
+        command: string;
+        args?: string[] | undefined;
+    } | {
+        name: string;
+        transport: "http";
+        url: string;
+        headers?: Record<string, string> | undefined;
+    })[] | undefined;
+    harnessImplementation?: "langchain" | undefined;
+    hooks?: {
+        type: "context_size" | "tool_response";
+        setting?: {
+            threshold: number;
+        } | {
+            maxTokensSize?: number | undefined;
+        } | undefined;
+        callback: string;
+    }[] | undefined;
+    initialMessage?: {
+        enabled: boolean;
+        content: string;
+    } | undefined;
+    uiConfig?: {
+        hideTopBar?: boolean | undefined;
+    } | undefined;
+}) => AgentRunner;

package/dist/runner/langchain/index.js

@@ -532,6 +532,14 @@ export class LangchainAgent {
             if (hasTodoWrite) {
                 agentConfig.systemPrompt = `${agentConfig.systemPrompt ?? ""}\n\n${TODO_WRITE_INSTRUCTIONS}`;
             }
+            // Process template variables in system prompt and inject current date/time
+            if (agentConfig.systemPrompt) {
+                const currentDateTime = getCurrentDateTimeString();
+                // Replace {{.CurrentDate}} template variable
+                agentConfig.systemPrompt = agentConfig.systemPrompt.replace(/\{\{\.CurrentDate\}\}/g, currentDateTime);
+                // Replace {{.CurrentDateTime}} template variable (alias)
+                agentConfig.systemPrompt = agentConfig.systemPrompt.replace(/\{\{\.CurrentDateTime\}\}/g, currentDateTime);
+            }
             const agent = createAgent(agentConfig);
             // Build messages from context history if available, otherwise use just the prompt
             // Type includes tool messages for sending tool results
@@ -1272,6 +1280,23 @@ I've found some existing telemetry code. Let me mark the first todo as in_progre
 [Assistant continues implementing the feature step by step, marking todos as in_progress and completed as they go]
 </example>
 `.trim();
+/**
+ * Returns a human-readable string of the current date and time.
+ * Example: "Monday, December 9, 2024 at 2:30 PM PST"
+ */
+const getCurrentDateTimeString = () => {
+    const now = new Date();
+    const options = {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        hour: "numeric",
+        minute: "2-digit",
+        timeZoneName: "short",
+    };
+    return now.toLocaleString("en-US", options);
+};
 // Re-export subagent tool utility
 export { makeSubagentsTool } from "./tools/subagent.js";
 /**

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

@@ -19,19 +19,19 @@ export declare function makeArtifactsTools(): (import("langchain").DynamicStruct
     source: z.ZodString;
     destination: z.ZodString;
     direction: z.ZodEnum<{
-        upload: "upload";
         download: "download";
+        upload: "upload";
     }>;
 }, z.core.$strip>, {
     session_id: string;
     source: string;
     destination: string;
-    direction: "upload" | "download";
+    direction: "download" | "upload";
 }, {
+    session_id?: string | undefined;
     source: string;
     destination: string;
-    direction: "upload" | "download";
-    session_id?: string | undefined;
+    direction: "download" | "upload";
 }, string> | import("langchain").DynamicStructuredTool<z.ZodObject<{
     session_id: z.ZodOptional<z.ZodString>;
     path: z.ZodString;
@@ -39,8 +39,8 @@ export declare function makeArtifactsTools(): (import("langchain").DynamicStruct
     session_id: string;
     path: string;
 }, {
-    path: string;
     session_id?: string | undefined;
+    path: string;
 }, string> | import("langchain").DynamicStructuredTool<z.ZodObject<{
     session_id: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
@@ -62,7 +62,7 @@ export declare function makeArtifactsTools(): (import("langchain").DynamicStruct
     path: string;
     expires_in?: number;
 }, {
-    path: string;
     session_id?: string | undefined;
+    path: string;
     expires_in?: number | undefined;
 }, string>)[];

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

@@ -11,19 +11,11 @@
  */
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { createSecretKeyClient } from "@townco/supabase/server";
+import { createClient } from "@townco/apiclient";
+import { getShedAuth } from "@townco/core/auth";
 import { tool } from "langchain";
 import { z } from "zod";
 // ============================================================================
-// Supabase Client and Bucket Configuration
-// ============================================================================
-function getSupabaseClient() {
-    return createSecretKeyClient();
-}
-function getBucketName() {
-    return "town-builder-artifacts";
-}
-// ============================================================================
 // Storage Key Prefix Logic
 // ============================================================================
 /**
@@ -99,21 +91,26 @@ function validateStoragePath(path) {
         throw new Error("Storage path cannot be empty");
     }
 }
-function validateExpiration(expiresIn) {
-    // Supabase supports up to 365 days (31536000 seconds)
-    if (expiresIn < 1 || expiresIn > 31536000) {
-        throw new Error(`URL expiration must be between 1 and 31536000 seconds (365 days). Got: ${expiresIn}`);
-    }
-}
 // ============================================================================
 // Supabase Storage Operation Helpers
 // ============================================================================
 /**
- * Upload a file to Supabase Storage
+ * Upload a file to Supabase Storage using signed URL
  */
 async function uploadToSupabase(storageKey, localPath) {
-    const supabase = getSupabaseClient();
-    const bucket = getBucketName();
+    const auth = getShedAuth();
+    if (auth === null)
+        throw new Error(`agent/artifacts: could not fetch shed auth`);
+    const { shedUrl, accessToken } = auth;
+    // Get signed upload URL from server
+    const signedUrl = await createClient({
+        shedUrl,
+        accessToken,
+    }).getArtifactUrl.query({
+        kind: "user",
+        key: storageKey,
+        upload: true,
+    });
     // Read file content
     const fileContent = await fs.readFile(localPath);
     // Determine content type based on file extension
@@ -133,91 +130,92 @@ async function uploadToSupabase(storageKey, localPath) {
         ".zip": "application/zip",
     };
     const contentType = contentTypeMap[ext] || "application/octet-stream";
-    const { error } = await supabase.storage
-        .from(bucket)
-        .upload(storageKey, fileContent, {
-        contentType,
-        upsert: true, // Allow overwriting
+    // Upload using signed URL
+    const response = await fetch(signedUrl, {
+        method: "PUT",
+        body: fileContent,
+        headers: {
+            "Content-Type": contentType,
+        },
     });
-    if (error) {
-        throw new Error(`Failed to upload to Supabase Storage: ${error.message}`);
+    if (!response.ok) {
+        throw new Error(`Failed to upload to Supabase Storage: ${response.status} ${response.statusText}`);
     }
 }
 /**
- * Download a file from Supabase Storage
+ * Download a file from Supabase Storage using signed URL
  */
 async function downloadFromSupabase(storageKey, localPath) {
-    const supabase = getSupabaseClient();
-    const bucket = getBucketName();
-    const { data, error } = await supabase.storage
-        .from(bucket)
-        .download(storageKey);
-    if (error) {
-        throw new Error(`Failed to download from Supabase Storage: ${error.message}`);
+    const auth = getShedAuth();
+    if (auth === null)
+        throw new Error(`agent/artifacts: could not fetch shed auth`);
+    const { shedUrl, accessToken } = auth;
+    // Get signed download URL from server
+    const signedUrl = await createClient({
+        shedUrl,
+        accessToken,
+    }).getArtifactUrl.query({
+        kind: "user",
+        key: storageKey,
+        upload: false,
+    });
+    // Download file using signed URL
+    const response = await fetch(signedUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to download from Supabase Storage: ${response.status} ${response.statusText}`);
     }
+    const data = await response.arrayBuffer();
     if (!data) {
         throw new Error("Supabase Storage response body is empty");
     }
     // Ensure parent directory exists
     const dir = path.dirname(localPath);
     await fs.mkdir(dir, { recursive: true });
-    // Convert Blob to Buffer and write
-    const arrayBuffer = await data.arrayBuffer();
-    const buffer = Buffer.from(arrayBuffer);
+    // Convert ArrayBuffer to Buffer and write
+    const buffer = Buffer.from(data);
     await fs.writeFile(localPath, buffer);
 }
 /**
  * Delete a file from Supabase Storage
  */
 async function deleteFromSupabase(storageKey) {
-    const supabase = getSupabaseClient();
-    const bucket = getBucketName();
-    const { error } = await supabase.storage.from(bucket).remove([storageKey]);
-    if (error) {
-        throw new Error(`Failed to delete from Supabase Storage: ${error.message}`);
-    }
+    const auth = getShedAuth();
+    if (auth === null)
+        throw new Error(`agent/artifacts: could not fetch shed auth`);
+    const { shedUrl, accessToken } = auth;
+    // Call the delete API endpoint
+    await createClient({ shedUrl, accessToken }).deleteArtifact.mutate({
+        kind: "user",
+        key: storageKey,
+    });
 }
+/**
+ * List files in Supabase Storage with optional prefix and recursion
+ */
 async function listFilesInSupabase(sessionId, relativePath, recursive = false) {
-    const supabase = getSupabaseClient();
-    const bucket = getBucketName();
-    // Build the prefix for listing
-    const basePath = relativePath
-        ? buildStorageKey(sessionId, relativePath)
-        : buildStorageKey(sessionId, "");
-    // For Supabase, we list at the base path
-    // If recursive, we'll need to handle it differently
-    const options = recursive
-        ? undefined
-        : {
-            limit: 100,
-            offset: 0,
-            sortBy: { column: "name", order: "asc" },
-        };
-    const { data, error } = await supabase.storage
-        .from(bucket)
-        .list(basePath, options);
-    if (error) {
-        throw new Error(`Failed to list files in Supabase Storage: ${error.message}`);
-    }
-    return data || [];
+    const auth = getShedAuth();
+    if (auth === null)
+        throw new Error(`agent/artifacts: could not fetch shed auth`);
+    const { shedUrl, accessToken } = auth;
+    return await createClient({ shedUrl, accessToken }).listArtifacts.query({
+        kind: "user",
+        key: buildStorageKey(sessionId, relativePath ?? ""),
+        recursive,
+    });
 }
 /**
  * Generate a signed URL for a Supabase Storage object
  */
-async function generateSignedUrl(storageKey, expiresIn) {
-    const supabase = getSupabaseClient();
-    const bucket = getBucketName();
-    const { data, error } = await supabase.storage
-        .from(bucket)
-        .createSignedUrl(storageKey, expiresIn);
-    if (error) {
-        throw new Error(`Failed to generate signed URL: ${error.message}`);
-    }
-    if (!data?.signedUrl) {
-        throw new Error("Signed URL not returned from Supabase Storage");
-    }
-    return data.signedUrl;
-}
+const generateSignedUrl = async (storageKey) => {
+    const shedAuth = getShedAuth();
+    if (shedAuth === null)
+        throw new Error("agent/artifacts: could not fetch shed auth");
+    const { accessToken, shedUrl } = shedAuth;
+    return await createClient({ shedUrl, accessToken }).getArtifactUrl.query({
+        kind: "user",
+        key: storageKey,
+    });
+};
 // ============================================================================
 // Error Handling Helpers
 // ============================================================================
@@ -391,17 +389,12 @@ const artifactsLs = tool(async ({ session_id, path, recursive = false, }) => {
 /**
  * Tool 4: artifacts_url - Generate signed URL
  */
-const artifactsUrl = tool(async ({ session_id, path, expires_in = 3600, }) => {
+const artifactsUrl = tool(async ({ session_id, path, }) => {
     try {
         validateStoragePath(path);
-        validateExpiration(expires_in);
         const storageKey = buildStorageKey(session_id, path);
-        const url = await generateSignedUrl(storageKey, expires_in);
-        const expiryHours = expires_in / 3600;
-        const expiryStr = expiryHours >= 1
-            ? `${expiryHours.toFixed(1)} hour(s)`
-            : `${expires_in} second(s)`;
-        return `Signed URL for ${path} (expires in ${expiryStr}):\n${url}`;
+        const _url = await generateSignedUrl(storageKey);
+        return `Signed URL for ${path}`;
     }
     catch (error) {
         return handleStorageError(error, `Failed to generate URL for ${path}`);
@@ -423,32 +416,44 @@ const artifactsUrl = tool(async ({ session_id, path, expires_in = 3600, }) => {
             .describe("Expiration time in seconds (1-31536000). Default: 3600 (1 hour)"),
     }),
 });
+// ============================================================================
+// Tool Metadata
+// ============================================================================
 // Add metadata for UI display
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsCp.prettyName = "Copy Artifact";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsCp.icon = "Upload";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsCp.verbiage = {
     active: "Copying artifact to {destination}",
     past: "Copied artifact to {destination}",
     paramKey: "destination",
 };
-artifactsDel.prettyName =
-    "Delete Artifact";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
+artifactsDel.prettyName = "Delete Artifact";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsDel.icon = "Trash";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsDel.verbiage = {
     active: "Deleting artifact {path}",
     past: "Deleted artifact {path}",
     paramKey: "path",
 };
-artifactsLs.prettyName =
-    "List Artifacts";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
+artifactsLs.prettyName = "List Artifacts";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsLs.icon = "List";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsLs.verbiage = {
     active: "Listing artifacts",
     past: "Listed artifacts",
 };
-artifactsUrl.prettyName =
-    "Generate Artifact URL";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
+artifactsUrl.prettyName = "Generate Artifact URL";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsUrl.icon = "Link";
+// biome-ignore lint/suspicious/noExplicitAny: Dynamic metadata assignment to tool objects
 artifactsUrl.verbiage = {
     active: "Generating URL for {path}",
     past: "Generated URL for {path}",

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

@@ -40,16 +40,16 @@ interface BrowserCloseResult {
 export declare function makeBrowserTools(): readonly [import("langchain").DynamicStructuredTool<z.ZodObject<{
     url: z.ZodString;
     waitUntil: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        load: "load";
         domcontentloaded: "domcontentloaded";
+        load: "load";
         networkidle: "networkidle";
     }>>>;
 }, z.core.$strip>, {
     url: string;
-    waitUntil: "load" | "domcontentloaded" | "networkidle";
+    waitUntil: "domcontentloaded" | "load" | "networkidle";
 }, {
     url: string;
-    waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    waitUntil?: "domcontentloaded" | "load" | "networkidle" | undefined;
 }, BrowserNavigateResult>, import("langchain").DynamicStructuredTool<z.ZodObject<{
     fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     selector: z.ZodOptional<z.ZodString>;
@@ -62,28 +62,28 @@ export declare function makeBrowserTools(): readonly [import("langchain").Dynami
 }, BrowserScreenshotResult>, import("langchain").DynamicStructuredTool<z.ZodObject<{
     selector: z.ZodOptional<z.ZodString>;
     extractType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        text: "text";
         html: "html";
+        text: "text";
     }>>>;
 }, z.core.$strip>, {
-    extractType: "text" | "html";
     selector?: string | undefined;
+    extractType: "html" | "text";
 }, {
     selector?: string | undefined;
-    extractType?: "text" | "html" | undefined;
+    extractType?: "html" | "text" | undefined;
 }, BrowserExtractResult>, import("langchain").DynamicStructuredTool<z.ZodObject<{
     selector: z.ZodString;
     button: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         left: "left";
-        right: "right";
         middle: "middle";
+        right: "right";
     }>>>;
 }, z.core.$strip>, {
     selector: string;
-    button: "left" | "right" | "middle";
+    button: "left" | "middle" | "right";
 }, {
     selector: string;
-    button?: "left" | "right" | "middle" | undefined;
+    button?: "left" | "middle" | "right" | undefined;
 }, BrowserClickResult>, import("langchain").DynamicStructuredTool<z.ZodObject<{
     selector: z.ZodString;
     text: z.ZodString;

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

@@ -19,8 +19,8 @@ export declare function makeDocumentExtractTool(): import("langchain").DynamicSt
     query: string;
     target_tokens?: number;
 }, {
+    session_id?: string | undefined;
     file_path: string;
     query: string;
-    session_id?: string | undefined;
     target_tokens?: number | undefined;
 }, string>;

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

@@ -9,8 +9,8 @@ export declare function makeFilesystemTools(): readonly [import("langchain").Dyn
     glob: z.ZodOptional<z.ZodString>;
     output_mode: z.ZodOptional<z.ZodEnum<{
         content: "content";
-        files_with_matches: "files_with_matches";
         count: "count";
+        files_with_matches: "files_with_matches";
     }>>;
     "-B": z.ZodOptional<z.ZodNumber>;
     "-A": z.ZodOptional<z.ZodNumber>;
@@ -24,7 +24,7 @@ export declare function makeFilesystemTools(): readonly [import("langchain").Dyn
     pattern: string;
     path?: string | undefined;
     glob?: string | undefined;
-    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    output_mode?: "content" | "count" | "files_with_matches" | undefined;
     "-B"?: number | undefined;
     "-A"?: number | undefined;
     "-C"?: number | undefined;
@@ -37,7 +37,7 @@ export declare function makeFilesystemTools(): readonly [import("langchain").Dyn
     pattern: string;
     path?: string | undefined;
     glob?: string | undefined;
-    output_mode?: "content" | "files_with_matches" | "count" | undefined;
+    output_mode?: "content" | "count" | "files_with_matches" | undefined;
     "-B"?: number | undefined;
     "-A"?: number | undefined;
     "-C"?: number | undefined;

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

@@ -12,36 +12,36 @@ interface GenerateImageResult {
 export declare function makeGenerateImageTool(): import("langchain").DynamicStructuredTool<z.ZodObject<{
     prompt: z.ZodString;
     aspectRatio: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        "16:9": "16:9";
         "1:1": "1:1";
         "3:4": "3:4";
         "4:3": "4:3";
-        "9:16": "9:16";
-        "16:9": "16:9";
         "5:4": "5:4";
+        "9:16": "9:16";
     }>>>;
 }, z.core.$strip>, {
     prompt: string;
-    aspectRatio: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "5:4";
+    aspectRatio: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16";
 }, {
     prompt: string;
-    aspectRatio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "5:4" | undefined;
+    aspectRatio?: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16" | undefined;
 }, GenerateImageResult>;
 /** Create generate image tool using Town proxy */
 export declare function makeTownGenerateImageTool(): import("langchain").DynamicStructuredTool<z.ZodObject<{
     prompt: z.ZodString;
     aspectRatio: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        "16:9": "16:9";
         "1:1": "1:1";
         "3:4": "3:4";
         "4:3": "4:3";
-        "9:16": "9:16";
-        "16:9": "16:9";
         "5:4": "5:4";
+        "9:16": "9:16";
     }>>>;
 }, z.core.$strip>, {
     prompt: string;
-    aspectRatio: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "5:4";
+    aspectRatio: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16";
 }, {
     prompt: string;
-    aspectRatio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9" | "5:4" | undefined;
+    aspectRatio?: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16" | undefined;
 }, GenerateImageResult>;
 export {};