@anthropic-field/core 0.1.0

package/dist/src/utils/memoryImportProcessor.js

@@ -0,0 +1,273 @@
+/**
+ * @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 { isSubpath } from './paths.js';
+import { debugLogger } from './debugLogger.js';
+// Simple console logger for import processing
+const logger = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug: (...args) => debugLogger.debug('[DEBUG] [ImportProcessor]', ...args),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn: (...args) => debugLogger.warn('[WARN] [ImportProcessor]', ...args),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error: (...args) => debugLogger.error('[ERROR] [ImportProcessor]', ...args),
+};
+// Helper to find the project root (looks for .git directory)
+async function findProjectRoot(startDir) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        const gitPath = path.join(currentDir, '.git');
+        try {
+            const stats = await fs.lstat(gitPath);
+            if (stats.isDirectory()) {
+                return currentDir;
+            }
+        }
+        catch {
+            // .git not found, continue to parent
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            // Reached filesystem root
+            break;
+        }
+        currentDir = parentDir;
+    }
+    // Fallback to startDir if .git not found
+    return path.resolve(startDir);
+}
+// Add a type guard for error objects
+function hasMessage(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        'message' in err &&
+        typeof err.message === 'string');
+}
+// Helper to find all code block and inline code regions using regex
+/**
+ * Finds all import statements in content without using regex
+ * @returns Array of {start, _end, path} objects for each import found
+ */
+function findImports(content) {
+    const imports = [];
+    let i = 0;
+    const len = content.length;
+    while (i < len) {
+        // Find next @ symbol
+        i = content.indexOf('@', i);
+        if (i === -1)
+            break;
+        // Check if it's a word boundary (not part of another word)
+        if (i > 0 && !isWhitespace(content[i - 1])) {
+            i++;
+            continue;
+        }
+        // Find the end of the import path (whitespace or newline)
+        let j = i + 1;
+        while (j < len &&
+            !isWhitespace(content[j]) &&
+            content[j] !== '\n' &&
+            content[j] !== '\r') {
+            j++;
+        }
+        // Extract the path (everything after @)
+        const importPath = content.slice(i + 1, j);
+        // Basic validation (starts with ./ or / or letter)
+        if (importPath.length > 0 &&
+            (importPath[0] === '.' ||
+                importPath[0] === '/' ||
+                isLetter(importPath[0]))) {
+            imports.push({
+                start: i,
+                _end: j,
+                path: importPath,
+            });
+        }
+        i = j + 1;
+    }
+    return imports;
+}
+function isWhitespace(char) {
+    return char === ' ' || char === '\t' || char === '\n' || char === '\r';
+}
+function isLetter(char) {
+    const code = char.charCodeAt(0);
+    return ((code >= 65 && code <= 90) || // A-Z
+        (code >= 97 && code <= 122)); // a-z
+}
+function findCodeRegions(content) {
+    const regions = [];
+    // Regex to match code blocks (inline and multiline)
+    // Matches one or more backticks, content (lazy), and same number of backticks
+    const regex = /(`+)([\s\S]*?)\1/g;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        regions.push([match.index, match.index + match[0].length]);
+    }
+    return regions;
+}
+/**
+ * Processes import statements in GEMINI.md content
+ * Supports @path/to/file syntax for importing content from other files
+ * @param content - The content to process for imports
+ * @param basePath - The directory path where the current file is located
+ * @param debugMode - Whether to enable debug logging
+ * @param importState - State tracking for circular import prevention
+ * @param projectRoot - The project root directory for allowed directories
+ * @param importFormat - The format of the import tree
+ * @returns Processed content with imports resolved and import tree
+ */
+export async function processImports(content, basePath, debugMode = false, importState = {
+    processedFiles: new Set(),
+    maxDepth: 5,
+    currentDepth: 0,
+}, projectRoot, importFormat = 'tree') {
+    if (!projectRoot) {
+        projectRoot = await findProjectRoot(basePath);
+    }
+    if (importState.currentDepth >= importState.maxDepth) {
+        if (debugMode) {
+            logger.warn(`Maximum import depth (${importState.maxDepth}) reached. Stopping import processing.`);
+        }
+        return {
+            content,
+            importTree: { path: importState.currentFile || 'unknown' },
+        };
+    }
+    // --- FLAT FORMAT LOGIC ---
+    if (importFormat === 'flat') {
+        // Use a queue to process files in order of first encounter, and a set to avoid duplicates
+        const flatFiles = [];
+        // Track processed files across the entire operation
+        const processedFiles = new Set();
+        // Helper to recursively process imports
+        async function processFlat(fileContent, fileBasePath, filePath, depth) {
+            // Normalize the file path to ensure consistent comparison
+            const normalizedPath = path.normalize(filePath);
+            // Skip if already processed
+            if (processedFiles.has(normalizedPath))
+                return;
+            // Mark as processed before processing to prevent infinite recursion
+            processedFiles.add(normalizedPath);
+            // Add this file to the flat list
+            flatFiles.push({ path: normalizedPath, content: fileContent });
+            // Find imports in this file
+            const codeRegions = findCodeRegions(fileContent);
+            const imports = findImports(fileContent);
+            // Process imports in reverse order to handle indices correctly
+            for (let i = imports.length - 1; i >= 0; i--) {
+                const { start, path: importPath } = imports[i];
+                // Skip if inside a code region
+                if (codeRegions.some(([regionStart, regionEnd]) => start >= regionStart && start < regionEnd)) {
+                    continue;
+                }
+                // Validate import path
+                if (!validateImportPath(importPath, fileBasePath, [projectRoot || ''])) {
+                    continue;
+                }
+                const fullPath = path.resolve(fileBasePath, importPath);
+                const normalizedFullPath = path.normalize(fullPath);
+                // Skip if already processed
+                if (processedFiles.has(normalizedFullPath))
+                    continue;
+                try {
+                    await fs.access(fullPath);
+                    const importedContent = await fs.readFile(fullPath, 'utf-8');
+                    // Process the imported file
+                    await processFlat(importedContent, path.dirname(fullPath), normalizedFullPath, depth + 1);
+                }
+                catch (error) {
+                    if (debugMode) {
+                        logger.warn(`Failed to import ${fullPath}: ${hasMessage(error) ? error.message : 'Unknown error'}`);
+                    }
+                    // Continue with other imports even if one fails
+                }
+            }
+        }
+        // Start with the root file (current file)
+        const rootPath = path.normalize(importState.currentFile || path.resolve(basePath));
+        await processFlat(content, basePath, rootPath, 0);
+        // Concatenate all unique files in order, Claude-style
+        const flatContent = flatFiles
+            .map((f) => `--- File: ${f.path} ---\n${f.content.trim()}\n--- End of File: ${f.path} ---`)
+            .join('\n\n');
+        return {
+            content: flatContent,
+            importTree: { path: rootPath }, // Tree not meaningful in flat mode
+        };
+    }
+    // --- TREE FORMAT LOGIC (existing) ---
+    const codeRegions = findCodeRegions(content);
+    let result = '';
+    let lastIndex = 0;
+    const imports = [];
+    const importsList = findImports(content);
+    for (const { start, _end, path: importPath } of importsList) {
+        // Add content before this import
+        result += content.substring(lastIndex, start);
+        lastIndex = _end;
+        // Skip if inside a code region
+        if (codeRegions.some(([s, e]) => start >= s && start < e)) {
+            result += `@${importPath}`;
+            continue;
+        }
+        // Validate import path to prevent path traversal attacks
+        if (!validateImportPath(importPath, basePath, [projectRoot || ''])) {
+            result += `<!-- Import failed: ${importPath} - Path traversal attempt -->`;
+            continue;
+        }
+        const fullPath = path.resolve(basePath, importPath);
+        if (importState.processedFiles.has(fullPath)) {
+            result += `<!-- File already processed: ${importPath} -->`;
+            continue;
+        }
+        try {
+            await fs.access(fullPath);
+            const fileContent = await fs.readFile(fullPath, 'utf-8');
+            // Mark this file as processed for this import chain
+            const newImportState = {
+                ...importState,
+                processedFiles: new Set(importState.processedFiles),
+                currentDepth: importState.currentDepth + 1,
+                currentFile: fullPath,
+            };
+            newImportState.processedFiles.add(fullPath);
+            const imported = await processImports(fileContent, path.dirname(fullPath), debugMode, newImportState, projectRoot, importFormat);
+            result += `<!-- Imported from: ${importPath} -->\n${imported.content}\n<!-- End of import from: ${importPath} -->`;
+            imports.push(imported.importTree);
+        }
+        catch (err) {
+            let message = 'Unknown error';
+            if (hasMessage(err)) {
+                message = err.message;
+            }
+            else if (typeof err === 'string') {
+                message = err;
+            }
+            logger.error(`Failed to import ${importPath}: ${message}`);
+            result += `<!-- Import failed: ${importPath} - ${message} -->`;
+        }
+    }
+    // Add any remaining content after the last match
+    result += content.substring(lastIndex);
+    return {
+        content: result,
+        importTree: {
+            path: importState.currentFile || 'unknown',
+            imports: imports.length > 0 ? imports : undefined,
+        },
+    };
+}
+export function validateImportPath(importPath, basePath, allowedDirectories) {
+    // Reject URLs
+    if (/^(file|https?):\/\//.test(importPath)) {
+        return false;
+    }
+    const resolvedPath = path.resolve(basePath, importPath);
+    return allowedDirectories.some((allowedDir) => isSubpath(allowedDir, resolvedPath));
+}
+//# sourceMappingURL=memoryImportProcessor.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content } from '@google/genai';
+export declare function isFunctionResponse(content: Content): boolean;
+export declare function isFunctionCall(content: Content): boolean;

package/dist/src/utils/messageInspectors.js

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isFunctionResponse(content) {
+    return (content.role === 'user' &&
+        !!content.parts &&
+        content.parts.every((part) => !!part.functionResponse));
+}
+export function isFunctionCall(content) {
+    return (content.role === 'model' &&
+        !!content.parts &&
+        content.parts.every((part) => !!part.functionCall));
+}
+//# sourceMappingURL=messageInspectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messageInspectors.js","sourceRoot":"","sources":["../../../src/utils/messageInspectors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,MAAM;QACvB,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,OAAO;QACxB,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CACnD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BaseLlmClient } from '../core/baseLlmClient.js';
+import type { GeminiChat } from '../core/geminiChat.js';
+export interface NextSpeakerResponse {
+    reasoning: string;
+    next_speaker: 'user' | 'model';
+}
+export declare function checkNextSpeaker(chat: GeminiChat, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal, promptId: string): Promise<NextSpeakerResponse | null>;

package/dist/src/utils/nextSpeakerChecker.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isFunctionResponse } from './messageInspectors.js';
+import { debugLogger } from './debugLogger.js';
+const CHECK_PROMPT = `Analyze *only* the content and structure of your immediately preceding response (your last turn in the conversation history). Based *strictly* on that response, determine who should logically speak next: the 'user' or the 'model' (you).
+**Decision Rules (apply in order):**
+1.  **Model Continues:** If your last response explicitly states an immediate next action *you* intend to take (e.g., "Next, I will...", "Now I'll process...", "Moving on to analyze...", indicates an intended tool call that didn't execute), OR if the response seems clearly incomplete (cut off mid-thought without a natural conclusion), then the **'model'** should speak next.
+2.  **Question to User:** If your last response ends with a direct question specifically addressed *to the user*, then the **'user'** should speak next.
+3.  **Waiting for User:** If your last response completed a thought, statement, or task *and* does not meet the criteria for Rule 1 (Model Continues) or Rule 2 (Question to User), it implies a pause expecting user input or reaction. In this case, the **'user'** should speak next.`;
+const RESPONSE_SCHEMA = {
+    type: 'object',
+    properties: {
+        reasoning: {
+            type: 'string',
+            description: "Brief explanation justifying the 'next_speaker' choice based *strictly* on the applicable rule and the content/structure of the preceding turn.",
+        },
+        next_speaker: {
+            type: 'string',
+            enum: ['user', 'model'],
+            description: 'Who should speak next based *only* on the preceding turn and the decision rules',
+        },
+    },
+    required: ['reasoning', 'next_speaker'],
+};
+export async function checkNextSpeaker(chat, baseLlmClient, abortSignal, promptId) {
+    // We need to capture the curated history because there are many moments when the model will return invalid turns
+    // that when passed back up to the endpoint will break subsequent calls. An example of this is when the model decides
+    // to respond with an empty part collection if you were to send that message back to the server it will respond with
+    // a 400 indicating that model part collections MUST have content.
+    const curatedHistory = chat.getHistory(/* curated */ true);
+    // Ensure there's a model response to analyze
+    if (curatedHistory.length === 0) {
+        // Cannot determine next speaker if history is empty.
+        return null;
+    }
+    const comprehensiveHistory = chat.getHistory();
+    // If comprehensiveHistory is empty, there is no last message to check.
+    // This case should ideally be caught by the curatedHistory.length check earlier,
+    // but as a safeguard:
+    if (comprehensiveHistory.length === 0) {
+        return null;
+    }
+    const lastComprehensiveMessage = comprehensiveHistory[comprehensiveHistory.length - 1];
+    // If the last message is a user message containing only function_responses,
+    // then the model should speak next.
+    if (lastComprehensiveMessage &&
+        isFunctionResponse(lastComprehensiveMessage)) {
+        return {
+            reasoning: 'The last message was a function response, so the model should speak next.',
+            next_speaker: 'model',
+        };
+    }
+    if (lastComprehensiveMessage &&
+        lastComprehensiveMessage.role === 'model' &&
+        lastComprehensiveMessage.parts &&
+        lastComprehensiveMessage.parts.length === 0) {
+        lastComprehensiveMessage.parts.push({ text: '' });
+        return {
+            reasoning: 'The last message was a filler model message with no content (nothing for user to act on), model should speak next.',
+            next_speaker: 'model',
+        };
+    }
+    // Things checked out. Let's proceed to potentially making an LLM request.
+    const lastMessage = curatedHistory[curatedHistory.length - 1];
+    if (!lastMessage || lastMessage.role !== 'model') {
+        // Cannot determine next speaker if the last turn wasn't from the model
+        // or if history is empty.
+        return null;
+    }
+    const contents = [
+        ...curatedHistory,
+        { role: 'user', parts: [{ text: CHECK_PROMPT }] },
+    ];
+    try {
+        const parsedResponse = (await baseLlmClient.generateJson({
+            modelConfigKey: { model: 'next-speaker-checker' },
+            contents,
+            schema: RESPONSE_SCHEMA,
+            abortSignal,
+            promptId,
+        }));
+        if (parsedResponse &&
+            parsedResponse.next_speaker &&
+            ['user', 'model'].includes(parsedResponse.next_speaker)) {
+            return parsedResponse;
+        }
+        return null;
+    }
+    catch (error) {
+        debugLogger.warn('Failed to talk to Gemini endpoint when seeing if conversation should continue.', error);
+        return null;
+    }
+}
+//# sourceMappingURL=nextSpeakerChecker.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type PackageJson as BasePackageJson } from 'read-package-up';
+export type PackageJson = BasePackageJson & {
+    config?: {
+        sandboxImageUri?: string;
+    };
+};
+/**
+ * Reads package.json from the current directory or any parent directory.
+ *
+ * @param cwd - The directory to start searching from (searches upward to filesystem root)
+ * @returns The package.json object if found, or `undefined` if no package.json exists
+ *          in the directory hierarchy. This is expected behavior when called from
+ *          directories outside of a Node.js project.
+ *
+ * @example
+ * ```ts
+ * const pkg = await getPackageJson(__dirname);
+ * const version = pkg?.version ?? 'unknown';
+ * ```
+ */
+export declare function getPackageJson(cwd: string): Promise<PackageJson | undefined>;

package/dist/src/utils/package.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { readPackageUp, } from 'read-package-up';
+import { debugLogger } from './debugLogger.js';
+/**
+ * Reads package.json from the current directory or any parent directory.
+ *
+ * @param cwd - The directory to start searching from (searches upward to filesystem root)
+ * @returns The package.json object if found, or `undefined` if no package.json exists
+ *          in the directory hierarchy. This is expected behavior when called from
+ *          directories outside of a Node.js project.
+ *
+ * @example
+ * ```ts
+ * const pkg = await getPackageJson(__dirname);
+ * const version = pkg?.version ?? 'unknown';
+ * ```
+ */
+export async function getPackageJson(cwd) {
+    try {
+        const result = await readPackageUp({ cwd, normalize: false });
+        if (!result) {
+            return undefined;
+        }
+        return result.packageJson;
+    }
+    catch (error) {
+        debugLogger.error('Error occurred while reading package.json', error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=package.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,GAEd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, PartListUnion, PartUnion } from '@google/genai';
+/**
+ * Converts a PartListUnion into a string.
+ * If verbose is true, includes summary representations of non-text parts.
+ */
+export declare function partToString(value: PartListUnion, options?: {
+    verbose?: boolean;
+}): string;
+export declare function getResponseText(response: GenerateContentResponse): string | 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 declare function flatMapTextParts(parts: PartListUnion, transform: (text: string) => Promise<PartUnion[]>): Promise<PartUnion[]>;
+/**
+ * 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 declare function appendToLastTextPart(prompt: PartUnion[], textToAppend: string, separator?: string): PartUnion[];