@anthropic-field/core 0.1.0

package/dist/src/utils/partUtils.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Converts a PartListUnion into a string.
+ * If verbose is true, includes summary representations of non-text parts.
+ */
+export function partToString(value, options) {
+    if (!value) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((part) => partToString(part, options)).join('');
+    }
+    // Cast to Part, assuming it might contain project-specific fields
+    const part = value;
+    if (options?.verbose) {
+        if (part.videoMetadata !== undefined) {
+            return `[Video Metadata]`;
+        }
+        if (part.thought !== undefined) {
+            return `[Thought: ${part.thought}]`;
+        }
+        if (part.codeExecutionResult !== undefined) {
+            return `[Code Execution Result]`;
+        }
+        if (part.executableCode !== undefined) {
+            return `[Executable Code]`;
+        }
+        // Standard Part fields
+        if (part.fileData !== undefined) {
+            return `[File Data]`;
+        }
+        if (part.functionCall !== undefined) {
+            return `[Function Call: ${part.functionCall.name}]`;
+        }
+        if (part.functionResponse !== undefined) {
+            return `[Function Response: ${part.functionResponse.name}]`;
+        }
+        if (part.inlineData !== undefined) {
+            return `<${part.inlineData.mimeType}>`;
+        }
+    }
+    return part.text ?? '';
+}
+export function getResponseText(response) {
+    if (response.candidates && response.candidates.length > 0) {
+        const candidate = response.candidates[0];
+        if (candidate.content &&
+            candidate.content.parts &&
+            candidate.content.parts.length > 0) {
+            return candidate.content.parts
+                .filter((part) => part.text && !part.thought)
+                .map((part) => part.text)
+                .join('');
+        }
+    }
+    return null;
+}
+/**
+ * Asynchronously maps over a PartListUnion, applying a transformation function
+ * to the text content of each text-based part.
+ *
+ * @param parts The PartListUnion to process.
+ * @param transform A function that takes a string of text and returns a Promise
+ *   resolving to an array of new PartUnions.
+ * @returns A Promise that resolves to a new array of PartUnions with the
+ *   transformations applied.
+ */
+export async function flatMapTextParts(parts, transform) {
+    const result = [];
+    const partArray = Array.isArray(parts)
+        ? parts
+        : typeof parts === 'string'
+            ? [{ text: parts }]
+            : [parts];
+    for (const part of partArray) {
+        let textToProcess;
+        if (typeof part === 'string') {
+            textToProcess = part;
+        }
+        else if ('text' in part) {
+            textToProcess = part.text;
+        }
+        if (textToProcess !== undefined) {
+            const transformedParts = await transform(textToProcess);
+            result.push(...transformedParts);
+        }
+        else {
+            // Pass through non-text parts unmodified.
+            result.push(part);
+        }
+    }
+    return result;
+}
+/**
+ * Appends a string of text to the last text part of a prompt, or adds a new
+ * text part if the last part is not a text part.
+ *
+ * @param prompt The prompt to modify.
+ * @param textToAppend The text to append to the prompt.
+ * @param separator The separator to add between existing text and the new text.
+ * @returns The modified prompt.
+ */
+export function appendToLastTextPart(prompt, textToAppend, separator = '\n\n') {
+    if (!textToAppend) {
+        return prompt;
+    }
+    if (prompt.length === 0) {
+        return [{ text: textToAppend }];
+    }
+    const newPrompt = [...prompt];
+    const lastPart = newPrompt.at(-1);
+    if (typeof lastPart === 'string') {
+        newPrompt[newPrompt.length - 1] = `${lastPart}${separator}${textToAppend}`;
+    }
+    else if (lastPart && 'text' in lastPart) {
+        newPrompt[newPrompt.length - 1] = {
+            ...lastPart,
+            text: `${lastPart.text}${separator}${textToAppend}`,
+        };
+    }
+    else {
+        newPrompt.push({ text: `${separator}${textToAppend}` });
+    }
+    return newPrompt;
+}
+//# sourceMappingURL=partUtils.js.map

package/dist/src/utils/partUtils.js.map

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

package/dist/src/utils/pathCorrector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+type SuccessfulPathCorrection = {
+    success: true;
+    correctedPath: string;
+};
+type FailedPathCorrection = {
+    success: false;
+    error: string;
+};
+/**
+ * Attempts to correct a relative or ambiguous file path to a single, absolute path
+ * within the workspace.
+ *
+ * @param filePath The file path to correct.
+ * @param config The application configuration.
+ * @returns A `PathCorrectionResult` object with either a `correctedPath` or an `error`.
+ */
+export type PathCorrectionResult = SuccessfulPathCorrection | FailedPathCorrection;
+export declare function correctPath(filePath: string, config: Config): PathCorrectionResult;
+export {};

package/dist/src/utils/pathCorrector.js

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { bfsFileSearchSync } from './bfsFileSearch.js';
+export function correctPath(filePath, config) {
+    // Check for direct path relative to the primary target directory.
+    const directPath = path.join(config.getTargetDir(), filePath);
+    if (fs.existsSync(directPath)) {
+        return { success: true, correctedPath: directPath };
+    }
+    // If not found directly, search across all workspace directories for ambiguous matches.
+    const workspaceContext = config.getWorkspaceContext();
+    const searchPaths = workspaceContext.getDirectories();
+    const basename = path.basename(filePath);
+    const normalizedTarget = filePath.replace(/\\/g, '/');
+    // Normalize path for matching and check if it ends with the provided relative path
+    const foundFiles = searchPaths
+        .flatMap((searchPath) => bfsFileSearchSync(searchPath, {
+        fileName: basename,
+        maxDirs: 50, // Capped to avoid deep hangs
+        fileService: config.getFileService(),
+        fileFilteringOptions: config.getFileFilteringOptions(),
+    }))
+        .filter((f) => f.replace(/\\/g, '/').endsWith(normalizedTarget));
+    if (foundFiles.length === 0) {
+        return {
+            success: false,
+            error: `File not found for '${filePath}' and path is not absolute.`,
+        };
+    }
+    if (foundFiles.length > 1) {
+        return {
+            success: false,
+            error: `The file path '${filePath}' is ambiguous and matches multiple files. Please provide a more specific path. Matches: ${foundFiles.join(', ')}`,
+        };
+    }
+    return { success: true, correctedPath: foundFiles[0] };
+}
+//# sourceMappingURL=pathCorrector.js.map

package/dist/src/utils/pathCorrector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathCorrector.js","sourceRoot":"","sources":["../../../src/utils/pathCorrector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuBvD,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAc;IAEd,kEAAkE;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;IACtD,CAAC;IAED,wFAAwF;IACxF,MAAM,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACtD,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,EAAE,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtD,mFAAmF;IACnF,MAAM,UAAU,GAAG,WAAW;SAC3B,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CACtB,iBAAiB,CAAC,UAAU,EAAE;QAC5B,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,EAAE,EAAE,6BAA6B;QAC1C,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE;QACpC,oBAAoB,EAAE,MAAM,CAAC,uBAAuB,EAAE;KACvD,CAAC,CACH;SACA,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEnE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,uBAAuB,QAAQ,6BAA6B;SACpE,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,kBAAkB,QAAQ,4FAA4F,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACrJ,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC"}

package/dist/src/utils/pathReader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { PartUnion } from '@google/genai';
+import type { Config } from '../config/config.js';
+/**
+ * Reads the content of a file or recursively expands a directory from
+ * within the workspace, returning content suitable for LLM input.
+ *
+ * @param pathStr The path to read (can be absolute or relative).
+ * @param config The application configuration, providing workspace context and services.
+ * @returns A promise that resolves to an array of PartUnion (string | Part).
+ * @throws An error if the path is not found or is outside the workspace.
+ */
+export declare function readPathFromWorkspace(pathStr: string, config: Config): Promise<PartUnion[]>;

package/dist/src/utils/pathReader.js

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { glob } from 'glob';
+import { processSingleFileContent } from './fileUtils.js';
+/**
+ * Reads the content of a file or recursively expands a directory from
+ * within the workspace, returning content suitable for LLM input.
+ *
+ * @param pathStr The path to read (can be absolute or relative).
+ * @param config The application configuration, providing workspace context and services.
+ * @returns A promise that resolves to an array of PartUnion (string | Part).
+ * @throws An error if the path is not found or is outside the workspace.
+ */
+export async function readPathFromWorkspace(pathStr, config) {
+    const workspace = config.getWorkspaceContext();
+    const fileService = config.getFileService();
+    let absolutePath = null;
+    if (path.isAbsolute(pathStr)) {
+        if (!workspace.isPathWithinWorkspace(pathStr)) {
+            throw new Error(`Absolute path is outside of the allowed workspace: ${pathStr}`);
+        }
+        absolutePath = pathStr;
+    }
+    else {
+        // Prioritized search for relative paths.
+        const searchDirs = workspace.getDirectories();
+        for (const dir of searchDirs) {
+            const potentialPath = path.resolve(dir, pathStr);
+            try {
+                await fs.access(potentialPath);
+                absolutePath = potentialPath;
+                break; // Found the first match.
+            }
+            catch {
+                // Not found, continue to the next directory.
+            }
+        }
+    }
+    if (!absolutePath) {
+        throw new Error(`Path not found in workspace: ${pathStr}`);
+    }
+    const stats = await fs.stat(absolutePath);
+    if (stats.isDirectory()) {
+        const allParts = [];
+        allParts.push({
+            text: `--- Start of content for directory: ${pathStr} ---\n`,
+        });
+        // Use glob to recursively find all files within the directory.
+        const files = await glob('**/*', {
+            cwd: absolutePath,
+            nodir: true, // We only want files
+            dot: true, // Include dotfiles
+            absolute: true,
+        });
+        const relativeFiles = files.map((p) => path.relative(config.getTargetDir(), p));
+        const filteredFiles = fileService.filterFiles(relativeFiles, {
+            respectGitIgnore: config.getFileFilteringRespectGitIgnore(),
+            respectGeminiIgnore: config.getFileFilteringRespectGeminiIgnore(),
+        });
+        const finalFiles = filteredFiles.map((p) => path.resolve(config.getTargetDir(), p));
+        for (const filePath of finalFiles) {
+            const relativePathForDisplay = path.relative(absolutePath, filePath);
+            allParts.push({ text: `--- ${relativePathForDisplay} ---\n` });
+            const result = await processSingleFileContent(filePath, config.getTargetDir(), config.getFileSystemService());
+            allParts.push(result.llmContent);
+            allParts.push({ text: '\n' }); // Add a newline for separation
+        }
+        allParts.push({ text: `--- End of content for directory: ${pathStr} ---` });
+        return allParts;
+    }
+    else {
+        // It's a single file, check if it's ignored.
+        const relativePath = path.relative(config.getTargetDir(), absolutePath);
+        const filtered = fileService.filterFiles([relativePath], {
+            respectGitIgnore: config.getFileFilteringRespectGitIgnore(),
+            respectGeminiIgnore: config.getFileFilteringRespectGeminiIgnore(),
+        });
+        if (filtered.length === 0) {
+            // File is ignored, return empty array to silently skip.
+            return [];
+        }
+        // It's a single file, process it directly.
+        const result = await processSingleFileContent(absolutePath, config.getTargetDir(), config.getFileSystemService());
+        return [result.llmContent];
+    }
+}
+//# sourceMappingURL=pathReader.js.map

package/dist/src/utils/pathReader.js.map

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

package/dist/src/utils/paths.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const GEMINI_DIR = ".gemini";
+export declare const GOOGLE_ACCOUNTS_FILENAME = "google_accounts.json";
+/**
+ * Special characters that need to be escaped in file paths for shell compatibility.
+ * Includes: spaces, parentheses, brackets, braces, semicolons, ampersands, pipes,
+ * asterisks, question marks, dollar signs, backticks, quotes, hash, and other shell metacharacters.
+ */
+export declare const SHELL_SPECIAL_CHARS: RegExp;
+/**
+ * Returns the home directory.
+ * If GEMINI_CLI_HOME environment variable is set, it returns its value.
+ * Otherwise, it returns the user's home directory.
+ */
+export declare function homedir(): string;
+/**
+ * Returns the operating system's default directory for temporary files.
+ */
+export declare function tmpdir(): string;
+/**
+ * Replaces the home directory with a tilde.
+ * @param path - The path to tildeify.
+ * @returns The tildeified path.
+ */
+export declare function tildeifyPath(path: string): string;
+/**
+ * Shortens a path string if it exceeds maxLen, prioritizing the start and end segments.
+ * Example: /path/to/a/very/long/file.txt -> /path/.../long/file.txt
+ */
+export declare function shortenPath(filePath: string, maxLen?: number): string;
+/**
+ * Calculates the relative path from a root directory to a target path.
+ * If targetPath is relative, it is returned as-is.
+ * Returns '.' if the target path is the same as the root directory.
+ *
+ * @param targetPath The absolute or relative path to make relative.
+ * @param rootDirectory The absolute path of the directory to make the target path relative to.
+ * @returns The relative path from rootDirectory to targetPath.
+ */
+export declare function makeRelative(targetPath: string, rootDirectory: string): string;
+/**
+ * Escapes special characters in a file path like macOS terminal does.
+ * Escapes: spaces, parentheses, brackets, braces, semicolons, ampersands, pipes,
+ * asterisks, question marks, dollar signs, backticks, quotes, hash, and other shell metacharacters.
+ */
+export declare function escapePath(filePath: string): string;
+/**
+ * Unescapes special characters in a file path.
+ * Removes backslash escaping from shell metacharacters.
+ */
+export declare function unescapePath(filePath: string): string;
+/**
+ * Generates a unique hash for a project based on its root path.
+ * @param projectRoot The absolute path to the project's root directory.
+ * @returns A SHA256 hash of the project root path.
+ */
+export declare function getProjectHash(projectRoot: string): string;
+/**
+ * Checks if a path is a subpath of another path.
+ * @param parentPath The parent path.
+ * @param childPath The child path.
+ * @returns True if childPath is a subpath of parentPath, false otherwise.
+ */
+export declare function isSubpath(parentPath: string, childPath: string): boolean;
+/**
+ * Resolves a path to its real path, sanitizing it first.
+ * - Removes 'file://' protocol if present.
+ * - Decodes URI components (e.g. %20 -> space).
+ * - Resolves symbolic links using fs.realpathSync.
+ *
+ * @param pathStr The path string to resolve.
+ * @returns The resolved real path.
+ */
+export declare function resolveToRealPath(path: string): string;