indusagi-coding-agent 0.1.25 → 0.1.26

package/dist/core/tools/ls.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../../src/core/tools/ls.ts"],"names":[],"mappings":"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"}

package/dist/core/tools/path-utils.d.ts

@@ -1,8 +0,0 @@
-export declare function expandPath(filePath: string): string;
-/**
- * Resolve a path relative to the given cwd.
- * Handles ~ expansion and absolute paths.
- */
-export declare function resolveToCwd(filePath: string, cwd: string): string;
-export declare function resolveReadPath(filePath: string, cwd: string): string;
-//# sourceMappingURL=path-utils.d.ts.map

package/dist/core/tools/path-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tools/path-utils.ts"],"names":[],"mappings":"AAuBA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAarE"}

package/dist/core/tools/path-utils.js

@@ -1,53 +0,0 @@
-import { accessSync, constants } from "node:fs";
-import * as os from "node:os";
-import { isAbsolute, resolve as resolvePath } from "node:path";
-const UNICODE_SPACES = /[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g;
-const NARROW_NO_BREAK_SPACE = "\u202F";
-function normalizeUnicodeSpaces(str) {
-    return str.replace(UNICODE_SPACES, " ");
-}
-function tryMacOSScreenshotPath(filePath) {
-    return filePath.replace(/ (AM|PM)\./g, `${NARROW_NO_BREAK_SPACE}$1.`);
-}
-function fileExists(filePath) {
-    try {
-        accessSync(filePath, constants.F_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-export function expandPath(filePath) {
-    const normalized = normalizeUnicodeSpaces(filePath);
-    if (normalized === "~") {
-        return os.homedir();
-    }
-    if (normalized.startsWith("~/")) {
-        return os.homedir() + normalized.slice(1);
-    }
-    return normalized;
-}
-/**
- * Resolve a path relative to the given cwd.
- * Handles ~ expansion and absolute paths.
- */
-export function resolveToCwd(filePath, cwd) {
-    const expanded = expandPath(filePath);
-    if (isAbsolute(expanded)) {
-        return expanded;
-    }
-    return resolvePath(cwd, expanded);
-}
-export function resolveReadPath(filePath, cwd) {
-    const resolved = resolveToCwd(filePath, cwd);
-    if (fileExists(resolved)) {
-        return resolved;
-    }
-    const macOSVariant = tryMacOSScreenshotPath(resolved);
-    if (macOSVariant !== resolved && fileExists(macOSVariant)) {
-        return macOSVariant;
-    }
-    return resolved;
-}
-//# sourceMappingURL=path-utils.js.map

package/dist/core/tools/path-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../src/core/tools/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAClE,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AACvC,SAAS,sBAAsB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,qBAAqB,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IACnC,IAAI,CAAC;QACJ,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAW;IACzD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,MAAM,YAAY,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,YAAY,KAAK,QAAQ,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3D,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/core/tools/read.d.ts

@@ -1,338 +0,0 @@
-/**
- * Read Tool - Read file contents with automatic image handling
- *
- * @module core/tools/read
- * @description
- * Implements the read tool for the agent. Reads file contents with:
- * - Support for line-based offset/limit
- * - Automatic image detection and resizing
- * - Large file truncation handling
- * - Remote execution support (SSH, containers)
- *
- * Based on file reading tools from Anthropic's Claude API and common Unix utilities.
- * Refactored for agent multimodal content handling.
- * - Proper path resolution and validation
- *
- * ## Tool Interface
- *
- * **Input Parameters:**
- * - `path` (required): File path to read (relative or absolute)
- * - `offset` (optional): Starting line number (1-indexed)
- * - `limit` (optional): Maximum number of lines to read
- *
- * **Output:**
- * - Text files: Line content as text
- * - Image files: Image data with metadata
- * - Large files: Truncated with temp file path
- *
- * **Error Behavior:**
- * - File not found → Tool error "ENOENT: no such file"
- * - Permission denied → Tool error "EACCES: permission denied"
- * - Invalid path → Tool error "Path outside working directory"
- * - Large file not truncable → Tool error "File too large"
- *
- * ## Usage in Agent
- *
- * The agent uses this tool to:
- * - Read source code files for analysis
- * - Check configuration files
- * - Read documentation and READMEs
- * - View images and diagrams
- * - Inspect logs and build output
- *
- * ## Features
- *
- * **Line-based Access:**
- * - offset: Start reading from line N (1-indexed)
- * - limit: Read at most N lines
- * - Useful for large files
- *
- * **Image Handling:**
- * - Auto-detect image MIME type
- * - Resize large images (configurable)
- * - Include dimension information
- * - Provide helpful notes for vision models
- *
- * **Truncation:**
- * - Truncate large files at front (keeps last N bytes)
- * - Write full content to temp file if needed
- * - Return truncation info for reference
- *
- * **Path Safety:**
- * - Resolve relative paths relative to cwd
- * - Prevent path traversal attacks (no ../../../etc/passwd)
- * - Validate paths are accessible
- *
- * ## Security
- *
- * **Path validation:**
- * - All paths resolved relative to cwd
- * - No symlink following by default
- * - Directory traversal prevented
- *
- * **Permission checks:**
- * - File must be readable
- * - Working directory must exist
- * - Errors returned for permission denied
- *
- * **Data safety:**
- * - Large files truncated (not read into memory)
- * - Binary files handled gracefully
- * - No automatic execution of file contents
- *
- * ## Customization
- *
- * **Image Resizing:**
- * ```typescript
- * const tool = createReadTool(cwd, {
- *   autoResizeImages: true,
- *   imageMaxBytes: 500 * 1024, // 500KB limit
- * });
- * ```
- *
- * **Remote Execution (SSH):**
- * ```typescript
- * const sshTool = createReadTool(cwd, {
- *   operations: {
- *     readFile: (path) => sshExec(`cat ${path}`),
- *     access: (path) => sshExec(`test -r ${path}`),
- *   },
- * });
- * ```
- *
- * ## Examples
- *
- * ### Read a source file
- * ```typescript
- * // Agent calls: read {path: "src/main.ts"}
- * // Returns: Full file content or truncated with temp file path
- * ```
- *
- * ### Read specific lines
- * ```typescript
- * // Agent calls: read {path: "test.txt", offset: 10, limit: 5}
- * // Returns: Lines 10-14
- * ```
- *
- * ### Auto-resized image
- * ```typescript
- * // Agent calls: read {path: "diagram.png"}
- * // Returns: Image content, resized if > 2MB, with dimensions
- * ```
- *
- * ## Attribution
- *
- * Based on: indusagi-agent read tool
- * Modifications:
- * - Added image auto-detection and resizing
- * - Added line-based offset/limit support
- * - Added custom operations interface
- * - Improved truncation handling
- */
-import type { AgentTool } from "indusagi/agent";
-import { type TruncationResult } from "./truncate.js";
-/**
- * JSON Schema for read tool parameters
- * @internal
- */
-declare const readSchema: import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>;
-/**
- * Tool-specific details returned with read results
- */
-export interface ReadToolDetails {
-    /** Truncation information if file was too large */
-    truncation?: TruncationResult;
-}
-/**
- * Pluggable interface for file reading operations
- *
- * Allows custom implementations for:
- * - Remote file systems (SSH, cloud storage)
- * - Virtual file systems (in-memory, testing)
- * - Custom permission models
- * - Monitoring and logging
- *
- * Implementations must respect working directory boundaries.
- *
- * @example
- * ```typescript
- * const sshOps: ReadOperations = {
- *   readFile: (path) => sshExec(`cat ${path}`),
- *   access: (path) => sshExec(`test -r ${path}`),
- *   detectImageMimeType: (path) => sshExec(`file -b --mime-type ${path}`),
- * };
- *
- * const tool = createReadTool(cwd, { operations: sshOps });
- * ```
- */
-export interface ReadOperations {
-    /**
-     * Read file contents as a Buffer
-     *
-     * @param absolutePath - Full path to file (already validated)
-     * @returns Buffer with file contents
-     * @throws ENOENT if file not found
-     * @throws EACCES if not readable
-     */
-    readFile: (absolutePath: string) => Promise<Buffer>;
-    /**
-     * Check if file is readable
-     *
-     * @param absolutePath - Full path to file (already validated)
-     * @throws Error if not readable or doesn't exist
-     */
-    access: (absolutePath: string) => Promise<void>;
-    /**
-     * Detect if file is an image and return MIME type
-     *
-     * @param absolutePath - Full path to file
-     * @returns MIME type like "image/png", or null/undefined if not an image
-     */
-    detectImageMimeType?: (absolutePath: string) => Promise<string | null | undefined>;
-}
-/**
- * Configuration options for the read tool
- *
- * Allows customization of image handling and file reading backend.
- */
-export interface ReadToolOptions {
-    /**
-     * Whether to auto-resize images to 2000x2000 max
-     *
-     * When enabled, images larger than the max will be:
-     * - Resized to fit within 2000x2000 pixels
-     * - Preserved as JPEG for smaller file size
-     * - Included with dimension notes in output
-     *
-     * Default: true (auto-resize enabled)
-     *
-     * Set to false if:
-     * - Vision model needs full resolution
-     * - Bandwidth/latency is not a concern
-     * - Custom resizing is handled elsewhere
-     *
-     * @example
-     * ```typescript
-     * const tool = createReadTool(cwd, {
-     *   autoResizeImages: false, // Keep full resolution
-     * });
-     * ```
-     */
-    autoResizeImages?: boolean;
-    /**
-     * Custom operations for file reading
-     *
-     * Default: Local filesystem operations
-     * Custom: SSH, cloud storage, testing mocks
-     *
-     * @example
-     * ```typescript
-     * const tool = createReadTool(cwd, {
-     *   operations: {
-     *     readFile: (path) => sshExec(`cat ${path}`),
-     *     access: (path) => sshExec(`test -r ${path}`),
-     *   },
-     * });
-     * ```
-     */
-    operations?: ReadOperations;
-}
-/**
- * Create a read tool with custom configuration
- *
- * Creates an AgentTool that can read files with:
- * - Line-based offset and limit
- * - Automatic image detection and resizing
- * - Large file truncation
- * - Remote execution support
- * - Proper path resolution
- *
- * **Tool Behavior:**
- * - Resolves paths relative to working directory
- * - Prevents path traversal (no ../../../etc/passwd)
- * - Detects images and handles specially
- * - Truncates large files at head (keeps tail)
- * - Returns truncation info for reference
- *
- * **Tool Parameters:**
- * - `path` (required): File to read
- * - `offset` (optional): Starting line (1-indexed)
- * - `limit` (optional): Maximum lines to read
- *
- * **Tool Output:**
- * - Text files: File content (possibly truncated)
- * - Image files: Image data with metadata
- * - Details: Truncation info if file was too large
- *
- * **Error Handling:**
- * - File not found: Tool error "ENOENT: no such file"
- * - Permission denied: Tool error "EACCES: permission denied"
- * - Invalid path: Tool error "Path outside working directory"
- * - Other errors: Tool error with message
- *
- * @param cwd - Working directory for relative path resolution
- *   - All relative paths resolved from this directory
- *   - Prevents directory traversal attacks
- *   - Can be overridden per execution
- *
- * @param options - Optional configuration
- *   - autoResizeImages: Enable/disable image resizing (default: true)
- *   - operations: Custom file reading backend (default: filesystem)
- *
- * @returns AgentTool instance ready to use
- *
- * @example
- * ```typescript
- * // Basic tool
- * const tool = createReadTool(process.cwd());
- *
- * // With image resizing disabled
- * const noResizeTool = createReadTool(cwd, {
- *   autoResizeImages: false,
- * });
- *
- * // With remote backend (SSH)
- * const remoteTool = createReadTool(cwd, {
- *   operations: sshOperations,
- * });
- * ```
- *
- * @see ReadToolOptions for detailed configuration
- * @see ReadOperations for custom backend interface
- */
-export declare function createReadTool(cwd: string, options?: ReadToolOptions): AgentTool<typeof readSchema>;
-/** Default read tool using process.cwd() - for backwards compatibility */
-/**
- * Default read tool instance
- *
- * Pre-created read tool using current process working directory.
- * Supports line-based reading, image resizing, and truncation.
- *
- * Equivalent to:
- * ```typescript
- * const readTool = createReadTool(process.cwd(), {
- *   autoResizeImages: true,
- * });
- * ```
- *
- * For custom configuration or remote backends, use createReadTool() directly.
- *
- * @example
- * ```typescript
- * import { readTool } from "./tools/read.js";
- * const agent = new Agent({ tools: [readTool] });
- * ```
- *
- * @see createReadTool for custom configuration
- */
-export declare const readTool: AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any>;
-export {};
-//# sourceMappingURL=read.d.ts.map

package/dist/core/tools/read.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/core/tools/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQhD,OAAO,EAAoD,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAMtH;;;GAGG;AACH,QAAA,MAAM,UAAU;;;;EAId,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnF;AAYD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC5B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CA0KnG;AAED,0EAA0E;AAC1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ;;;;QAAgC,CAAC"}