chivgent 0.6.0

package/dist/tools/read-file.js

@@ -0,0 +1,150 @@
+import { WorkspaceError } from "../workspace.js";
+import { MAX_TOOL_OUTPUT_BYTES, truncateUtf8 } from "./output.js";
+const DEFAULT_START_LINE = 1;
+const DEFAULT_LINE_COUNT = 200;
+const MAX_LINE_COUNT = 500;
+const MAX_CONTENT_BUDGET_BYTES = 48 * 1024;
+const inputSchema = {
+    type: "object",
+    properties: {
+        path: {
+            type: "string",
+            description: "Path relative to the workspace root.",
+        },
+        start_line: {
+            type: "integer",
+            minimum: 1,
+            description: "First one-based line to read. Usually start with 1.",
+        },
+        line_count: {
+            type: "integer",
+            minimum: 1,
+            maximum: MAX_LINE_COUNT,
+            description: "Number of lines to read. Usually use 200.",
+        },
+    },
+    required: ["path", "start_line", "line_count"],
+    additionalProperties: false,
+};
+export class ReadFileTool {
+    name = "read_file";
+    description = "Read a bounded range from a UTF-8 text file inside the workspace. Use list_files or search_text first when the path is unknown.";
+    inputSchema = inputSchema;
+    async execute(argumentsValue, context) {
+        const argumentsObject = parseArguments(argumentsValue);
+        if (argumentsObject === undefined) {
+            return {
+                content: 'Invalid arguments. Expected {"path":"relative/file.ts","start_line":1,"line_count":200}; line_count must be from 1 to 500.',
+                isError: true,
+            };
+        }
+        try {
+            const slice = await context.workspace.readTextFile(argumentsObject.path, {
+                startLine: argumentsObject.startLine,
+                lineCount: argumentsObject.lineCount,
+            });
+            return {
+                content: formatSlice(argumentsObject.path, argumentsObject.lineCount, slice),
+                isError: false,
+            };
+        }
+        catch (error) {
+            if (error instanceof WorkspaceError || error instanceof TypeError) {
+                return { content: error.message, isError: true };
+            }
+            throw error;
+        }
+    }
+}
+function parseArguments(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const record = value;
+    const keys = Object.keys(record);
+    if (keys.some((key) => key !== "path" && key !== "start_line" && key !== "line_count")) {
+        return undefined;
+    }
+    const startLine = record.start_line ?? DEFAULT_START_LINE;
+    const lineCount = record.line_count ?? DEFAULT_LINE_COUNT;
+    if (typeof record.path !== "string" ||
+        record.path.length === 0 ||
+        typeof startLine !== "number" ||
+        !Number.isSafeInteger(startLine) ||
+        startLine < 1 ||
+        typeof lineCount !== "number" ||
+        !Number.isSafeInteger(lineCount) ||
+        lineCount < 1 ||
+        lineCount > MAX_LINE_COUNT) {
+        return undefined;
+    }
+    return { path: record.path, startLine, lineCount };
+}
+function formatSlice(path, requestedLineCount, slice) {
+    const provisionalHeader = `File: ${path} (lines ${slice.startLine}-${slice.endLine} of ${slice.totalLines})\n---`;
+    const provisionalFooter = [
+        `[line ${slice.endLine} truncated at the 64 KiB tool-output limit]`,
+        `[truncated: continue with ${JSON.stringify({
+            path,
+            start_line: slice.endLine + 1,
+            line_count: requestedLineCount,
+        })}]`,
+    ].join("\n");
+    const contentBudgetBytes = Math.max(0, Math.min(MAX_CONTENT_BUDGET_BYTES, MAX_TOOL_OUTPUT_BYTES -
+        Buffer.byteLength(provisionalHeader, "utf8") -
+        Buffer.byteLength(provisionalFooter, "utf8") -
+        2));
+    const segments = splitLinesPreservingEndings(slice.content);
+    const accepted = [];
+    let usedBytes = 0;
+    let outputTruncated = false;
+    let partialLine = false;
+    for (const segment of segments) {
+        const segmentBytes = Buffer.byteLength(segment, "utf8");
+        if (usedBytes + segmentBytes <= contentBudgetBytes) {
+            accepted.push(segment);
+            usedBytes += segmentBytes;
+            continue;
+        }
+        outputTruncated = true;
+        if (accepted.length === 0) {
+            accepted.push(truncateUtf8(segment, contentBudgetBytes));
+            partialLine = true;
+        }
+        break;
+    }
+    const consumedLines = accepted.length;
+    const actualEndLine = slice.totalLines === 0 ? 0 : slice.startLine + consumedLines - 1;
+    const header = `File: ${path} (lines ${slice.startLine}-${actualEndLine} of ${slice.totalLines})\n---`;
+    const body = accepted.join("");
+    const footer = [];
+    if (partialLine) {
+        footer.push(`[line ${actualEndLine} truncated at the 64 KiB tool-output limit]`);
+    }
+    if ((slice.truncated || outputTruncated) && actualEndLine < slice.totalLines) {
+        footer.push(`[truncated: continue with ${JSON.stringify({
+            path,
+            start_line: actualEndLine + 1,
+            line_count: requestedLineCount,
+        })}]`);
+    }
+    let output = `${header}${body.length === 0 ? "" : `\n${body}`}`;
+    if (footer.length > 0) {
+        if (!output.endsWith("\n")) {
+            output += "\n";
+        }
+        output += footer.join("\n");
+    }
+    return truncateUtf8(output, MAX_TOOL_OUTPUT_BYTES);
+}
+function splitLinesPreservingEndings(contents) {
+    if (contents.length === 0) {
+        return [];
+    }
+    const lines = contents.match(/[^\r\n]*(?:\r\n|\r|\n|$)/g) ?? [];
+    if (lines.at(-1) === "") {
+        lines.pop();
+    }
+    return lines;
+}
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

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

package/dist/tools/search-text.d.ts

@@ -0,0 +1,28 @@
+import type { Tool, ToolContext, ToolOutput } from "./tool.js";
+export declare class SearchTextTool implements Tool {
+    readonly name = "search_text";
+    readonly description = "Search discoverable UTF-8 project files for case-sensitive literal text and return file paths, line numbers, and previews.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Case-sensitive literal text to find, from 1 to 256 characters without line breaks. Regular expressions are not supported.";
+            };
+            readonly path: {
+                readonly type: "string";
+                readonly description: 'File or directory relative to the workspace root. Use "." for the root.';
+            };
+            readonly max_results: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 200;
+                readonly description: "Maximum matches to return. Usually use 50.";
+            };
+        };
+        readonly required: readonly ["query", "path", "max_results"];
+        readonly additionalProperties: false;
+    };
+    execute(argumentsValue: unknown, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=search-text.d.ts.map

package/dist/tools/search-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-text.d.ts","sourceRoot":"","sources":["../../src/tools/search-text.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAsC/D,qBAAa,cAAe,YAAW,IAAI;IACzC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,gIAC2G;IAC/H,QAAQ,CAAC,WAAW;uBAjCd,QAAQ;;qBAEZ,KAAK;yBACH,IAAI,EAAE,QAAQ;yBACd,WAAW,EACT,2HAA2H;;qBAE/H,IAAI;yBACF,IAAI,EAAE,QAAQ;yBACd,WAAW,EACT,yEAAyE;;qBAE7E,WAAW;yBACT,IAAI,EAAE,SAAS;yBACf,OAAO,EAAE,CAAC;yBACV,OAAO;yBACP,WAAW,EAAE,4CAA4C;;;qCAGlD,OAAO,EAAE,MAAM,EAAE,aAAa;;MAcN;IAE7B,OAAO,CACX,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqCrB;CACF"}

package/dist/tools/search-text.js

@@ -0,0 +1,94 @@
+import { WorkspaceError } from "../workspace.js";
+import { formatBoundedLineOutput } from "./output.js";
+const DEFAULT_PATH = ".";
+const DEFAULT_MAX_RESULTS = 50;
+const MAX_RESULTS = 200;
+const MAX_QUERY_CHARACTERS = 256;
+const inputSchema = {
+    type: "object",
+    properties: {
+        query: {
+            type: "string",
+            description: "Case-sensitive literal text to find, from 1 to 256 characters without line breaks. Regular expressions are not supported.",
+        },
+        path: {
+            type: "string",
+            description: 'File or directory relative to the workspace root. Use "." for the root.',
+        },
+        max_results: {
+            type: "integer",
+            minimum: 1,
+            maximum: MAX_RESULTS,
+            description: "Maximum matches to return. Usually use 50.",
+        },
+    },
+    required: ["query", "path", "max_results"],
+    additionalProperties: false,
+};
+export class SearchTextTool {
+    name = "search_text";
+    description = "Search discoverable UTF-8 project files for case-sensitive literal text and return file paths, line numbers, and previews.";
+    inputSchema = inputSchema;
+    async execute(argumentsValue, context) {
+        const argumentsObject = parseArguments(argumentsValue);
+        if (argumentsObject === undefined) {
+            return {
+                content: 'Invalid arguments. Expected {"query":"literal text","path":".","max_results":50}; query must be one line and max_results must be from 1 to 200.',
+                isError: true,
+            };
+        }
+        try {
+            const result = await context.workspace.searchText({
+                query: argumentsObject.query,
+                path: argumentsObject.path,
+                maxResults: argumentsObject.maxResults,
+            });
+            return {
+                content: formatBoundedLineOutput(result.matches.map((match) => `${match.path}:${match.line}:${match.preview}`), {
+                    emptyMessage: "No matches found.",
+                    metadata: `[scanned: ${result.scannedFiles} files; skipped: ${result.skippedFiles}]`,
+                    truncated: result.truncated,
+                    truncationMessage: "[truncated: narrow path or use a more specific query]",
+                }),
+                isError: false,
+            };
+        }
+        catch (error) {
+            if (error instanceof WorkspaceError || error instanceof TypeError) {
+                return { content: error.message, isError: true };
+            }
+            throw error;
+        }
+    }
+}
+function parseArguments(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const keys = Object.keys(value);
+    if (keys.some((key) => key !== "query" && key !== "path" && key !== "max_results")) {
+        return undefined;
+    }
+    const query = value.query;
+    const path = value.path ?? DEFAULT_PATH;
+    const maxResults = value.max_results ?? DEFAULT_MAX_RESULTS;
+    if (typeof query !== "string" ||
+        query.length === 0 ||
+        [...query].length > MAX_QUERY_CHARACTERS ||
+        query.includes("\0") ||
+        query.includes("\r") ||
+        query.includes("\n") ||
+        typeof path !== "string" ||
+        path.length === 0 ||
+        typeof maxResults !== "number" ||
+        !Number.isSafeInteger(maxResults) ||
+        maxResults < 1 ||
+        maxResults > MAX_RESULTS) {
+        return undefined;
+    }
+    return { query, path, maxResults };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=search-text.js.map

package/dist/tools/search-text.js.map

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

package/dist/tools/tool.d.ts

@@ -0,0 +1,22 @@
+import type { Workspace } from "../workspace.js";
+export interface ToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Readonly<Record<string, unknown>>;
+}
+export interface ToolContext {
+    readonly workspace: Workspace;
+    /**
+     * Cancels long-running tool work. Read-only tools may ignore it; tools that
+     * spawn processes or walk large trees should honour it.
+     */
+    readonly signal?: AbortSignal;
+}
+export interface ToolOutput {
+    readonly content: string;
+    readonly isError: boolean;
+}
+export interface Tool extends ToolDefinition {
+    execute(argumentsValue: unknown, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/tools/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,IAAK,SAAQ,cAAc;IAC1C,OAAO,CACL,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/dist/tools/tool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/tools/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":""}

package/dist/workspace.d.ts

@@ -0,0 +1,72 @@
+export type WorkspaceErrorCode = "invalid_path" | "outside_workspace" | "forbidden_path" | "not_found" | "not_a_file" | "not_a_directory" | "too_large" | "binary_file" | "invalid_utf8" | "invalid_range";
+export declare class WorkspaceError extends Error {
+    readonly code: WorkspaceErrorCode;
+    constructor(code: WorkspaceErrorCode, message: string, options?: ErrorOptions);
+}
+export interface ReadTextFileOptions {
+    readonly startLine?: number;
+    readonly lineCount?: number;
+}
+export interface TextFileSlice {
+    readonly content: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly totalLines: number;
+    readonly truncated: boolean;
+}
+export interface ListFilesOptions {
+    readonly path?: string;
+    readonly maxDepth?: number;
+    readonly maxEntries?: number;
+}
+export interface WorkspaceEntry {
+    readonly path: string;
+    readonly type: "file" | "directory";
+}
+export interface ListFilesResult {
+    readonly entries: readonly WorkspaceEntry[];
+    readonly truncated: boolean;
+}
+export interface SearchTextOptions {
+    readonly query: string;
+    readonly path?: string;
+    readonly maxResults?: number;
+}
+export interface SearchMatch {
+    readonly path: string;
+    readonly line: number;
+    readonly preview: string;
+}
+export interface SearchTextResult {
+    readonly matches: readonly SearchMatch[];
+    readonly truncated: boolean;
+    readonly scannedFiles: number;
+    readonly skippedFiles: number;
+}
+export interface Workspace {
+    readonly root: string;
+    readTextFile(relativePath: string, options?: ReadTextFileOptions): Promise<TextFileSlice>;
+    listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
+    searchText(options: SearchTextOptions): Promise<SearchTextResult>;
+}
+export interface LocalWorkspaceOptions {
+    readonly maxFileBytes?: number;
+    readonly maxSearchFiles?: number;
+    readonly maxSearchBytes?: number;
+}
+export declare class LocalWorkspace implements Workspace {
+    readonly root: string;
+    private readonly maxFileBytes;
+    private readonly maxSearchFiles;
+    private readonly maxSearchBytes;
+    constructor(root: string, options?: LocalWorkspaceOptions);
+    readTextFile(relativePath: string, options?: ReadTextFileOptions): Promise<TextFileSlice>;
+    listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
+    searchText(options: SearchTextOptions): Promise<SearchTextResult>;
+    private readFullTextFile;
+    private resolveExistingPath;
+    private normalizeRelativePath;
+    private rejectExplicitDirectorySymlink;
+    private createIgnoreMatcher;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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