@anthropic-field/core 0.1.0

package/dist/src/utils/generateContentResponseUtilities.js

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getResponseText } from './partUtils.js';
+import { supportsMultimodalFunctionResponse } from '../config/models.js';
+import { debugLogger } from './debugLogger.js';
+/**
+ * Formats tool output for a Gemini FunctionResponse.
+ */
+function createFunctionResponsePart(callId, toolName, output) {
+    return {
+        functionResponse: {
+            id: callId,
+            name: toolName,
+            response: { output },
+        },
+    };
+}
+function toParts(input) {
+    const parts = [];
+    for (const part of Array.isArray(input) ? input : [input]) {
+        if (typeof part === 'string') {
+            parts.push({ text: part });
+        }
+        else if (part) {
+            parts.push(part);
+        }
+    }
+    return parts;
+}
+export function convertToFunctionResponse(toolName, callId, llmContent, model) {
+    if (typeof llmContent === 'string') {
+        return [createFunctionResponsePart(callId, toolName, llmContent)];
+    }
+    const parts = toParts(llmContent);
+    // Separate text from binary types
+    const textParts = [];
+    const inlineDataParts = [];
+    const fileDataParts = [];
+    for (const part of parts) {
+        if (part.text !== undefined) {
+            textParts.push(part.text);
+        }
+        else if (part.inlineData) {
+            inlineDataParts.push(part);
+        }
+        else if (part.fileData) {
+            fileDataParts.push(part);
+        }
+        else if (part.functionResponse) {
+            if (parts.length > 1) {
+                debugLogger.warn('convertToFunctionResponse received multiple parts with a functionResponse. Only the functionResponse will be used, other parts will be ignored');
+            }
+            // Handle passthrough case
+            return [
+                {
+                    functionResponse: {
+                        id: callId,
+                        name: toolName,
+                        response: part.functionResponse.response,
+                    },
+                },
+            ];
+        }
+        // Ignore other part types
+    }
+    // Build the primary response part
+    const part = {
+        functionResponse: {
+            id: callId,
+            name: toolName,
+            response: textParts.length > 0 ? { output: textParts.join('\n') } : {},
+        },
+    };
+    const isMultimodalFRSupported = supportsMultimodalFunctionResponse(model);
+    const siblingParts = [...fileDataParts];
+    if (inlineDataParts.length > 0) {
+        if (isMultimodalFRSupported) {
+            // Nest inlineData if supported by the model
+            part.functionResponse.parts =
+                inlineDataParts;
+        }
+        else {
+            // Otherwise treat as siblings
+            siblingParts.push(...inlineDataParts);
+        }
+    }
+    // Add descriptive text if the response object is empty but we have binary content
+    if (textParts.length === 0 &&
+        (inlineDataParts.length > 0 || fileDataParts.length > 0)) {
+        const totalBinaryItems = inlineDataParts.length + fileDataParts.length;
+        part.functionResponse.response = {
+            output: `Binary content provided (${totalBinaryItems} item(s)).`,
+        };
+    }
+    if (siblingParts.length > 0) {
+        return [part, ...siblingParts];
+    }
+    return [part];
+}
+export function getResponseTextFromParts(parts) {
+    if (!parts) {
+        return undefined;
+    }
+    const textSegments = parts
+        .map((part) => part.text)
+        .filter((text) => typeof text === 'string');
+    if (textSegments.length === 0) {
+        return undefined;
+    }
+    return textSegments.join('');
+}
+export function getFunctionCalls(response) {
+    const parts = response.candidates?.[0]?.content?.parts;
+    if (!parts) {
+        return undefined;
+    }
+    const functionCallParts = parts
+        .filter((part) => !!part.functionCall)
+        .map((part) => part.functionCall);
+    return functionCallParts.length > 0 ? functionCallParts : undefined;
+}
+export function getFunctionCallsFromParts(parts) {
+    if (!parts) {
+        return undefined;
+    }
+    const functionCallParts = parts
+        .filter((part) => !!part.functionCall)
+        .map((part) => part.functionCall);
+    return functionCallParts.length > 0 ? functionCallParts : undefined;
+}
+export function getFunctionCallsAsJson(response) {
+    const functionCalls = getFunctionCalls(response);
+    if (!functionCalls) {
+        return undefined;
+    }
+    return JSON.stringify(functionCalls, null, 2);
+}
+export function getFunctionCallsFromPartsAsJson(parts) {
+    const functionCalls = getFunctionCallsFromParts(parts);
+    if (!functionCalls) {
+        return undefined;
+    }
+    return JSON.stringify(functionCalls, null, 2);
+}
+export function getStructuredResponse(response) {
+    const textContent = getResponseText(response);
+    const functionCallsJson = getFunctionCallsAsJson(response);
+    if (textContent && functionCallsJson) {
+        return `${textContent}\n${functionCallsJson}`;
+    }
+    if (textContent) {
+        return textContent;
+    }
+    if (functionCallsJson) {
+        return functionCallsJson;
+    }
+    return undefined;
+}
+export function getStructuredResponseFromParts(parts) {
+    const textContent = getResponseTextFromParts(parts);
+    const functionCallsJson = getFunctionCallsFromPartsAsJson(parts);
+    if (textContent && functionCallsJson) {
+        return `${textContent}\n${functionCallsJson}`;
+    }
+    if (textContent) {
+        return textContent;
+    }
+    if (functionCallsJson) {
+        return functionCallsJson;
+    }
+    return undefined;
+}
+export function getCitations(resp) {
+    return (resp.candidates?.[0]?.citationMetadata?.citations ?? [])
+        .filter((citation) => citation.uri !== undefined)
+        .map((citation) => {
+        if (citation.title) {
+            return `(${citation.title}) ${citation.uri}`;
+        }
+        return citation.uri;
+    });
+}
+//# sourceMappingURL=generateContentResponseUtilities.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import type { FileFilteringOptions } from '../config/constants.js';
+/** Options for customizing folder structure retrieval. */
+interface FolderStructureOptions {
+    /** Maximum number of files and folders combined to display. Defaults to 200. */
+    maxItems?: number;
+    /** Set of folder names to ignore completely. Case-sensitive. */
+    ignoredFolders?: Set<string>;
+    /** Optional regex to filter included files by name. */
+    fileIncludePattern?: RegExp;
+    /** For filtering files. */
+    fileService?: FileDiscoveryService;
+    /** File filtering ignore options. */
+    fileFilteringOptions?: FileFilteringOptions;
+}
+/**
+ * Generates a string representation of a directory's structure,
+ * limiting the number of items displayed. Ignored folders are shown
+ * followed by '...' instead of their contents.
+ *
+ * @param directory The absolute or relative path to the directory.
+ * @param options Optional configuration settings.
+ * @returns A promise resolving to the formatted folder structure string.
+ */
+export declare function getFolderStructure(directory: string, options?: FolderStructureOptions): Promise<string>;
+export {};

package/dist/src/utils/getFolderStructure.js

@@ -0,0 +1,243 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getErrorMessage, isNodeError } from './errors.js';
+import { DEFAULT_FILE_FILTERING_OPTIONS } from '../config/constants.js';
+import { debugLogger } from './debugLogger.js';
+const MAX_ITEMS = 200;
+const TRUNCATION_INDICATOR = '...';
+const DEFAULT_IGNORED_FOLDERS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    '__pycache__',
+]);
+// --- Interfaces ---
+// --- Helper Functions ---
+async function readFullStructure(rootPath, options) {
+    const rootName = path.basename(rootPath);
+    const rootNode = {
+        name: rootName,
+        path: rootPath,
+        files: [],
+        subFolders: [],
+        totalChildren: 0,
+        totalFiles: 0,
+    };
+    const queue = [
+        { folderInfo: rootNode, currentPath: rootPath },
+    ];
+    let currentItemCount = 0;
+    // Count the root node itself as one item if we are not just listing its content
+    const processedPaths = new Set(); // To avoid processing same path if symlinks create loops
+    while (queue.length > 0) {
+        const { folderInfo, currentPath } = queue.shift();
+        if (processedPaths.has(currentPath)) {
+            continue;
+        }
+        processedPaths.add(currentPath);
+        if (currentItemCount >= options.maxItems) {
+            // If the root itself caused us to exceed, we can't really show anything.
+            // Otherwise, this folder won't be processed further.
+            // The parent that queued this would have set its own hasMoreSubfolders flag.
+            continue;
+        }
+        let entries;
+        try {
+            const rawEntries = await fs.readdir(currentPath, { withFileTypes: true });
+            // Sort entries alphabetically by name for consistent processing order
+            entries = rawEntries.sort((a, b) => a.name.localeCompare(b.name));
+        }
+        catch (error) {
+            if (isNodeError(error) &&
+                (error.code === 'EACCES' || error.code === 'ENOENT')) {
+                debugLogger.warn(`Warning: Could not read directory ${currentPath}: ${error.message}`);
+                if (currentPath === rootPath && error.code === 'ENOENT') {
+                    return null; // Root directory itself not found
+                }
+                // For other EACCES/ENOENT on subdirectories, just skip them.
+                continue;
+            }
+            throw error;
+        }
+        const filesInCurrentDir = [];
+        const subFoldersInCurrentDir = [];
+        const filterFileOptions = {
+            respectGitIgnore: options.fileFilteringOptions?.respectGitIgnore,
+            respectGeminiIgnore: options.fileFilteringOptions?.respectGeminiIgnore,
+        };
+        // Process files first in the current directory
+        for (const entry of entries) {
+            if (entry.isFile()) {
+                if (currentItemCount >= options.maxItems) {
+                    folderInfo.hasMoreFiles = true;
+                    break;
+                }
+                const fileName = entry.name;
+                const filePath = path.join(currentPath, fileName);
+                if (options.fileService?.shouldIgnoreFile(filePath, filterFileOptions)) {
+                    continue;
+                }
+                if (!options.fileIncludePattern ||
+                    options.fileIncludePattern.test(fileName)) {
+                    filesInCurrentDir.push(fileName);
+                    currentItemCount++;
+                    folderInfo.totalFiles++;
+                    folderInfo.totalChildren++;
+                }
+            }
+        }
+        folderInfo.files = filesInCurrentDir;
+        // Then process directories and queue them
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                // Check if adding this directory ITSELF would meet or exceed maxItems
+                // (currentItemCount refers to items *already* added before this one)
+                if (currentItemCount >= options.maxItems) {
+                    folderInfo.hasMoreSubfolders = true;
+                    break; // Already at limit, cannot add this folder or any more
+                }
+                // If adding THIS folder makes us hit the limit exactly, and it might have children,
+                // it's better to show '...' for the parent, unless this is the very last item slot.
+                // This logic is tricky. Let's try a simpler: if we can't add this item, mark and break.
+                const subFolderName = entry.name;
+                const subFolderPath = path.join(currentPath, subFolderName);
+                const isIgnored = options.fileService?.shouldIgnoreFile(subFolderPath, filterFileOptions) ?? false;
+                if (options.ignoredFolders.has(subFolderName) || isIgnored) {
+                    const ignoredSubFolder = {
+                        name: subFolderName,
+                        path: subFolderPath,
+                        files: [],
+                        subFolders: [],
+                        totalChildren: 0,
+                        totalFiles: 0,
+                        isIgnored: true,
+                    };
+                    subFoldersInCurrentDir.push(ignoredSubFolder);
+                    currentItemCount++; // Count the ignored folder itself
+                    folderInfo.totalChildren++; // Also counts towards parent's children
+                    continue;
+                }
+                const subFolderNode = {
+                    name: subFolderName,
+                    path: subFolderPath,
+                    files: [],
+                    subFolders: [],
+                    totalChildren: 0,
+                    totalFiles: 0,
+                };
+                subFoldersInCurrentDir.push(subFolderNode);
+                currentItemCount++;
+                folderInfo.totalChildren++; // Counts towards parent's children
+                // Add to queue for processing its children later
+                queue.push({ folderInfo: subFolderNode, currentPath: subFolderPath });
+            }
+        }
+        folderInfo.subFolders = subFoldersInCurrentDir;
+    }
+    return rootNode;
+}
+/**
+ * Reads the directory structure using BFS, respecting maxItems.
+ * @param node The current node in the reduced structure.
+ * @param indent The current indentation string.
+ * @param isLast Sibling indicator.
+ * @param builder Array to build the string lines.
+ */
+function formatStructure(node, currentIndent, isLastChildOfParent, isProcessingRootNode, builder) {
+    const connector = isLastChildOfParent ? '└───' : '├───';
+    // The root node of the structure (the one passed initially to getFolderStructure)
+    // is not printed with a connector line itself, only its name as a header.
+    // Its children are printed relative to that conceptual root.
+    // Ignored root nodes ARE printed with a connector.
+    if (!isProcessingRootNode || node.isIgnored) {
+        builder.push(`${currentIndent}${connector}${node.name}${path.sep}${node.isIgnored ? TRUNCATION_INDICATOR : ''}`);
+    }
+    // Determine the indent for the children of *this* node.
+    // If *this* node was the root of the whole structure, its children start with no indent before their connectors.
+    // Otherwise, children's indent extends from the current node's indent.
+    const indentForChildren = isProcessingRootNode
+        ? ''
+        : currentIndent + (isLastChildOfParent ? '    ' : '│   ');
+    // Render files of the current node
+    const fileCount = node.files.length;
+    for (let i = 0; i < fileCount; i++) {
+        const isLastFileAmongSiblings = i === fileCount - 1 &&
+            node.subFolders.length === 0 &&
+            !node.hasMoreSubfolders;
+        const fileConnector = isLastFileAmongSiblings ? '└───' : '├───';
+        builder.push(`${indentForChildren}${fileConnector}${node.files[i]}`);
+    }
+    if (node.hasMoreFiles) {
+        const isLastIndicatorAmongSiblings = node.subFolders.length === 0 && !node.hasMoreSubfolders;
+        const fileConnector = isLastIndicatorAmongSiblings ? '└───' : '├───';
+        builder.push(`${indentForChildren}${fileConnector}${TRUNCATION_INDICATOR}`);
+    }
+    // Render subfolders of the current node
+    const subFolderCount = node.subFolders.length;
+    for (let i = 0; i < subFolderCount; i++) {
+        const isLastSubfolderAmongSiblings = i === subFolderCount - 1 && !node.hasMoreSubfolders;
+        // Children are never the root node being processed initially.
+        formatStructure(node.subFolders[i], indentForChildren, isLastSubfolderAmongSiblings, false, builder);
+    }
+    if (node.hasMoreSubfolders) {
+        builder.push(`${indentForChildren}└───${TRUNCATION_INDICATOR}`);
+    }
+}
+// --- Main Exported Function ---
+/**
+ * Generates a string representation of a directory's structure,
+ * limiting the number of items displayed. Ignored folders are shown
+ * followed by '...' instead of their contents.
+ *
+ * @param directory The absolute or relative path to the directory.
+ * @param options Optional configuration settings.
+ * @returns A promise resolving to the formatted folder structure string.
+ */
+export async function getFolderStructure(directory, options) {
+    const resolvedPath = path.resolve(directory);
+    const mergedOptions = {
+        maxItems: options?.maxItems ?? MAX_ITEMS,
+        ignoredFolders: options?.ignoredFolders ?? DEFAULT_IGNORED_FOLDERS,
+        fileIncludePattern: options?.fileIncludePattern,
+        fileService: options?.fileService,
+        fileFilteringOptions: options?.fileFilteringOptions ?? DEFAULT_FILE_FILTERING_OPTIONS,
+    };
+    try {
+        // 1. Read the structure using BFS, respecting maxItems
+        const structureRoot = await readFullStructure(resolvedPath, mergedOptions);
+        if (!structureRoot) {
+            return `Error: Could not read directory "${resolvedPath}". Check path and permissions.`;
+        }
+        // 2. Format the structure into a string
+        const structureLines = [];
+        // Pass true for isRoot for the initial call
+        formatStructure(structureRoot, '', true, true, structureLines);
+        // 3. Build the final output string
+        function isTruncated(node) {
+            if (node.hasMoreFiles || node.hasMoreSubfolders || node.isIgnored) {
+                return true;
+            }
+            for (const sub of node.subFolders) {
+                if (isTruncated(sub)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        let summary = `Showing up to ${mergedOptions.maxItems} items (files + folders).`;
+        if (isTruncated(structureRoot)) {
+            summary += ` Folders or files indicated with ${TRUNCATION_INDICATOR} contain more items not shown, were ignored, or the display limit (${mergedOptions.maxItems} items) was reached.`;
+        }
+        return `${summary}\n\n${resolvedPath}${path.sep}\n${structureLines.join('\n')}`;
+    }
+    catch (error) {
+        debugLogger.warn(`Error getting folder structure for ${resolvedPath}:`, error);
+        return `Error processing directory "${resolvedPath}": ${getErrorMessage(error)}`;
+    }
+}
+//# sourceMappingURL=getFolderStructure.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type PtyImplementation = {
+    module: any;
+    name: 'lydell-node-pty' | 'node-pty';
+} | null;
+export interface PtyProcess {
+    readonly pid: number;
+    onData(callback: (data: string) => void): void;
+    onExit(callback: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    kill(signal?: string): void;
+}
+export declare const getPty: () => Promise<PtyImplementation>;

package/dist/src/utils/getPty.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const getPty = async () => {
+    try {
+        const lydell = '@lydell/node-pty';
+        const module = await import(lydell);
+        return { module, name: 'lydell-node-pty' };
+    }
+    catch (_e) {
+        try {
+            const nodePty = 'node-pty';
+            const module = await import(nodePty);
+            return { module, name: 'node-pty' };
+        }
+        catch (_e2) {
+            return null;
+        }
+    }
+};
+//# sourceMappingURL=getPty.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPty.js","sourceRoot":"","sources":["../../../src/utils/getPty.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,IAAgC,EAAE;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface GitIgnoreFilter {
+    isIgnored(filePath: string): boolean;
+}
+export declare class GitIgnoreParser implements GitIgnoreFilter {
+    private readonly extraPatterns?;
+    private projectRoot;
+    private cache;
+    private globalPatterns;
+    private processedExtraPatterns;
+    constructor(projectRoot: string, extraPatterns?: string[] | undefined);
+    private loadPatternsForFile;
+    private processPatterns;
+    isIgnored(filePath: string): boolean;
+}