@townco/agent 0.1.130 → 0.1.132

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

@@ -1,135 +0,0 @@
-/**
- * Document extraction tool for extracting relevant information from large files
- *
- * Uses the document context extractor to intelligently extract relevant
- * information from large documents based on a query/requirements description.
- */
-import * as fs from "node:fs/promises";
-import { tool } from "langchain";
-import { z } from "zod";
-import { createLogger } from "../../../logger.js";
-import { countTokens } from "../../../utils/token-counter.js";
-import { extractDocumentContext } from "../../hooks/predefined/document-context-extractor/index.js";
-const logger = createLogger("document-extract-tool");
-// Minimum document size (in tokens) to use extraction
-// Smaller documents are returned as-is
-const MIN_EXTRACTION_THRESHOLD = 10000;
-// Default target size for extraction output
-const DEFAULT_TARGET_TOKENS = 20000;
-/**
- * Document extraction tool
- *
- * Reads a file and extracts relevant information based on the provided query.
- * For large documents, uses intelligent chunking and relevance scoring.
- * Small documents are returned as-is.
- */
-const documentExtract = tool(async ({ session_id, file_path, query, target_tokens, }) => {
-    try {
-        // Read the file content
-        const content = await fs.readFile(file_path, "utf-8");
-        // Try to parse as JSON, otherwise treat as plain text
-        let parsedContent;
-        try {
-            parsedContent = JSON.parse(content);
-        }
-        catch {
-            // Not JSON, wrap as text object
-            parsedContent = { content };
-        }
-        // Count tokens in the document
-        const documentTokens = await countTokens(content);
-        logger.info("Document extraction requested", {
-            filePath: file_path,
-            documentTokens,
-            query: query.substring(0, 100),
-            sessionId: session_id,
-        });
-        // If document is small enough, return as-is
-        if (documentTokens <= MIN_EXTRACTION_THRESHOLD) {
-            logger.info("Document below extraction threshold, returning as-is", {
-                documentTokens,
-                threshold: MIN_EXTRACTION_THRESHOLD,
-            });
-            return content;
-        }
-        // Use document context extractor for large documents
-        const targetSize = target_tokens ?? DEFAULT_TARGET_TOKENS;
-        const result = await extractDocumentContext(parsedContent, "document_extract", // toolName
-        `extract-${Date.now()}`, // toolCallId
-        { file_path, query }, // toolInput
-        query, // conversationContext (use query as context)
-        targetSize, session_id, undefined);
-        if (result.success && result.extractedData) {
-            logger.info("Document extraction successful", {
-                originalTokens: result.metadata.originalTokens,
-                extractedTokens: result.extractedTokens,
-                chunksProcessed: result.metadata.chunksProcessed,
-                chunksExtractedFrom: result.metadata.chunksExtractedFrom,
-            });
-            // Return extracted content as formatted string
-            return JSON.stringify(result.extractedData, null, 2);
-        }
-        // Extraction failed
-        logger.error("Document extraction failed", {
-            error: result.error,
-            phase: result.metadata.phase,
-        });
-        return `Error: Failed to extract from document: ${result.error}`;
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        logger.error("Document extract tool error", {
-            filePath: file_path,
-            error: errorMessage,
-        });
-        // Check for common errors
-        if (errorMessage.includes("ENOENT") ||
-            errorMessage.includes("no such file")) {
-            return `Error: File not found at path: ${file_path}`;
-        }
-        if (errorMessage.includes("EACCES")) {
-            return `Error: Permission denied reading file: ${file_path}`;
-        }
-        return `Error: ${errorMessage}`;
-    }
-}, {
-    name: "document_extract",
-    description: "Extract relevant information from a large document file based on a query. " +
-        "Use this tool when you need to find specific information in a large file " +
-        "(e.g., JSON data, logs, API responses) that would be too large to process directly. " +
-        "The tool intelligently identifies and extracts the most relevant portions of the document. " +
-        "For small files (under 10,000 tokens), returns the full content.",
-    schema: z.object({
-        session_id: z
-            .string()
-            .optional()
-            .describe("INTERNAL USE ONLY - Auto-injected by system"),
-        file_path: z
-            .string()
-            .describe("Absolute path to the file to extract from (e.g., '/tmp/data.json')"),
-        query: z
-            .string()
-            .describe("Description of what information to extract from the document. " +
-            "Be specific about what you're looking for."),
-        target_tokens: z
-            .number()
-            .optional()
-            .describe("Target size for extracted output in tokens (default: 20000). " +
-            "Use smaller values if you need a more concise summary."),
-    }),
-});
-// Add metadata for UI display
-documentExtract.prettyName =
-    "Extract from Document";
-documentExtract.icon = "FileSearch";
-documentExtract.verbiage = {
-    active: "Extracting relevant information from {file_path}",
-    past: "Extracted relevant information from {file_path}",
-    paramKey: "file_path",
-};
-/**
- * Factory function to create the document extract tool
- */
-export function makeDocumentExtractTool() {
-    return documentExtract;
-}

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

@@ -1,47 +0,0 @@
-import { z } from "zod";
-interface GenerateImageResult {
-    success: boolean;
-    filePath?: string | undefined;
-    fileName?: string | undefined;
-    imageUrl?: string | undefined;
-    textResponse?: string | undefined;
-    mimeType?: string | undefined;
-    error?: string | undefined;
-}
-/** Create generate image tool using direct GEMINI_API_KEY/GOOGLE_API_KEY */
-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";
-        "5:4": "5:4";
-        "9:16": "9:16";
-    }>>>;
-}, z.core.$strip>, {
-    prompt: string;
-    aspectRatio: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16";
-}, {
-    prompt: string;
-    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";
-        "5:4": "5:4";
-        "9:16": "9:16";
-    }>>>;
-}, z.core.$strip>, {
-    prompt: string;
-    aspectRatio: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16";
-}, {
-    prompt: string;
-    aspectRatio?: "16:9" | "1:1" | "3:4" | "4:3" | "5:4" | "9:16" | undefined;
-}, GenerateImageResult>;
-export {};

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

@@ -1,175 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { GoogleGenAI } from "@google/genai";
-import { getShedAuth } from "@townco/core/auth";
-import { tool } from "langchain";
-import { z } from "zod";
-import { getSessionContext, getToolOutputDir, hasSessionContext, } from "../../session-context";
-let _directGenaiClient = null;
-let _townGenaiClient = null;
-/** Get Google GenAI client using direct GEMINI_API_KEY/GOOGLE_API_KEY environment variable */
-function getDirectGenAIClient() {
-    if (_directGenaiClient) {
-        return _directGenaiClient;
-    }
-    const apiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
-    if (!apiKey) {
-        throw new Error("GEMINI_API_KEY or GOOGLE_API_KEY environment variable is required to use the generate_image tool. " +
-            "Please set one of them to your Google AI API key.");
-    }
-    _directGenaiClient = new GoogleGenAI({ apiKey });
-    return _directGenaiClient;
-}
-/** Get Google GenAI client using Town proxy with authenticated credentials */
-function getTownGenAIClient() {
-    if (_townGenaiClient) {
-        return _townGenaiClient;
-    }
-    const shedAuth = getShedAuth();
-    if (!shedAuth) {
-        throw new Error("Not logged in. Run 'town login' or set SHED_API_KEY to use the town_generate_image tool.");
-    }
-    // Configure the client to use shed as proxy
-    // The SDK will send requests to {shedUrl}/api/gemini/{apiVersion}/{path}
-    _townGenaiClient = new GoogleGenAI({
-        apiKey: shedAuth.accessToken,
-        httpOptions: {
-            baseUrl: `${shedAuth.shedUrl}/api/gemini/`,
-        },
-    });
-    return _townGenaiClient;
-}
-function makeGenerateImageToolInternal(getClient) {
-    const generateImage = tool(async ({ prompt, aspectRatio = "1:1" }) => {
-        try {
-            if (!hasSessionContext()) {
-                throw new Error("GenerateImage tool requires session context. Ensure the tool is called within a session.");
-            }
-            const { sessionId } = getSessionContext();
-            const toolOutputDir = getToolOutputDir("GenerateImage");
-            const client = getClient();
-            // Use Gemini 3 Pro Image for image generation
-            // Note: imageConfig is a valid API option but not yet in the TypeScript types
-            // biome-ignore lint/suspicious/noExplicitAny: imageConfig not yet typed in @google/genai
-            const config = {
-                responseModalities: ["TEXT", "IMAGE"],
-                imageConfig: {
-                    aspectRatio: aspectRatio,
-                },
-            };
-            const response = await client.models.generateContent({
-                model: "gemini-3-pro-image-preview",
-                contents: [{ text: prompt }],
-                config,
-            });
-            if (!response.candidates || response.candidates.length === 0) {
-                return {
-                    success: false,
-                    error: "No response from the model. The request may have been filtered.",
-                };
-            }
-            const candidate = response.candidates[0];
-            if (!candidate) {
-                return {
-                    success: false,
-                    error: "No candidate in the response.",
-                };
-            }
-            const parts = candidate.content?.parts;
-            if (!parts || parts.length === 0) {
-                return {
-                    success: false,
-                    error: "No content parts in the response.",
-                };
-            }
-            let imageData;
-            let textResponse;
-            let mimeType;
-            for (const part of parts) {
-                if (part.text) {
-                    textResponse = part.text;
-                }
-                else if (part.inlineData) {
-                    imageData = part.inlineData.data;
-                    mimeType = part.inlineData.mimeType || "image/png";
-                }
-            }
-            if (!imageData) {
-                return {
-                    success: false,
-                    error: "No image was generated in the response.",
-                    ...(textResponse ? { textResponse } : {}),
-                };
-            }
-            // Save image to session-scoped tool output directory
-            await mkdir(toolOutputDir, { recursive: true });
-            // Generate unique filename
-            const timestamp = Date.now();
-            const extension = mimeType === "image/jpeg" ? "jpg" : "png";
-            const fileName = `image-${timestamp}.${extension}`;
-            const filePath = join(toolOutputDir, fileName);
-            // Save image to file
-            const buffer = Buffer.from(imageData, "base64");
-            await writeFile(filePath, buffer);
-            // Create URL for the static file server
-            // The agent HTTP server serves static files from the agent directory
-            // Use AGENT_BASE_URL if set (for production), otherwise construct from BIND_HOST/PORT
-            const port = process.env.PORT || "3100";
-            const hostname = process.env.BIND_HOST || "localhost";
-            const baseUrl = process.env.AGENT_BASE_URL || `http://${hostname}:${port}`;
-            const imageUrl = `${baseUrl}/static/.sessions/${sessionId}/artifacts/tool-GenerateImage/${fileName}`;
-            return {
-                success: true,
-                filePath,
-                fileName,
-                imageUrl,
-                ...(mimeType ? { mimeType } : {}),
-                ...(textResponse ? { textResponse } : {}),
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
-            return {
-                success: false,
-                error: `Image generation failed: ${errorMessage}`,
-            };
-        }
-    }, {
-        name: "GenerateImage",
-        description: "Generate an image based on a text prompt using Google's Gemini image generation model. " +
-            "Returns an imageUrl that can be displayed to the user. After calling this tool, " +
-            "include the imageUrl in your response as a markdown image like ![Description](imageUrl) " +
-            "so the user can see the generated image.\n" +
-            "- Creates images from detailed text descriptions\n" +
-            "- Supports various aspect ratios for different use cases\n" +
-            "- Be specific in prompts about style, composition, colors, and subjects\n" +
-            "\n" +
-            "Usage notes:\n" +
-            "  - Provide detailed, specific prompts for best results\n" +
-            "  - The generated image is saved to the session directory and served via URL\n" +
-            "  - Always display the result using markdown: ![description](imageUrl)\n",
-        schema: z.object({
-            prompt: z
-                .string()
-                .describe("A detailed description of the image to generate. Be specific about style, composition, colors, and subjects."),
-            aspectRatio: z
-                .enum(["1:1", "3:4", "4:3", "9:16", "16:9", "5:4"])
-                .optional()
-                .default("1:1")
-                .describe("The aspect ratio of the generated image."),
-        }),
-    });
-    // biome-ignore lint/suspicious/noExplicitAny: Need to add custom properties to LangChain tool
-    generateImage.prettyName = "Generate Image";
-    // biome-ignore lint/suspicious/noExplicitAny: Need to add custom properties to LangChain tool
-    generateImage.icon = "Image";
-    return generateImage;
-}
-/** Create generate image tool using direct GEMINI_API_KEY/GOOGLE_API_KEY */
-export function makeGenerateImageTool() {
-    return makeGenerateImageToolInternal(getDirectGenAIClient);
-}
-/** Create generate image tool using Town proxy */
-export function makeTownGenerateImageTool() {
-    return makeGenerateImageToolInternal(getTownGenAIClient);
-}

package/dist/runner/langchain/tools/port-utils.d.ts

@@ -1,8 +0,0 @@
-/**
- * Check if a port is available
- */
-export declare function isPortAvailable(port: number): Promise<boolean>;
-/**
- * Find the next available port starting from the given port
- */
-export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;

package/dist/runner/langchain/tools/port-utils.js

@@ -1,35 +0,0 @@
-import { createServer } from "node:net";
-/**
- * Check if a port is available
- */
-export async function isPortAvailable(port) {
-    return new Promise((resolve) => {
-        const server = createServer();
-        server.once("error", (err) => {
-            if (err.code === "EADDRINUSE") {
-                resolve(false);
-            }
-            else {
-                resolve(false);
-            }
-        });
-        server.once("listening", () => {
-            server.close();
-            resolve(true);
-        });
-        server.listen(port);
-    });
-}
-/**
- * Find the next available port starting from the given port
- */
-export async function findAvailablePort(startPort, maxAttempts = 100) {
-    for (let i = 0; i < maxAttempts; i++) {
-        const port = startPort + i;
-        const available = await isPortAvailable(port);
-        if (available) {
-            return port;
-        }
-    }
-    throw new Error(`Could not find an available port between ${startPort} and ${startPort + maxAttempts - 1}`);
-}