@anthropic-field/core 0.1.0

package/dist/src/services/chatRecordingService.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Config } from '../config/config.js';
+import { type Status } from '../core/coreToolScheduler.js';
+import { type ThoughtSummary } from '../utils/thoughtUtils.js';
+import type { PartListUnion, GenerateContentResponseUsageMetadata } from '@google/genai';
+import type { ToolResultDisplay } from '../tools/tools.js';
+export declare const SESSION_FILE_PREFIX = "session-";
+/**
+ * Token usage summary for a message or conversation.
+ */
+export interface TokensSummary {
+    input: number;
+    output: number;
+    cached: number;
+    thoughts?: number;
+    tool?: number;
+    total: number;
+}
+/**
+ * Base fields common to all messages.
+ */
+export interface BaseMessageRecord {
+    id: string;
+    timestamp: string;
+    content: PartListUnion;
+    displayContent?: PartListUnion;
+}
+/**
+ * Record of a tool call execution within a conversation.
+ */
+export interface ToolCallRecord {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    result?: PartListUnion | null;
+    status: Status;
+    timestamp: string;
+    displayName?: string;
+    description?: string;
+    resultDisplay?: ToolResultDisplay;
+    renderOutputAsMarkdown?: boolean;
+}
+/**
+ * Message type and message type-specific fields.
+ */
+export type ConversationRecordExtra = {
+    type: 'user' | 'info' | 'error' | 'warning';
+} | {
+    type: 'gemini';
+    toolCalls?: ToolCallRecord[];
+    thoughts?: Array<ThoughtSummary & {
+        timestamp: string;
+    }>;
+    tokens?: TokensSummary | null;
+    model?: string;
+};
+/**
+ * A single message record in a conversation.
+ */
+export type MessageRecord = BaseMessageRecord & ConversationRecordExtra;
+/**
+ * Complete conversation record stored in session files.
+ */
+export interface ConversationRecord {
+    sessionId: string;
+    projectHash: string;
+    startTime: string;
+    lastUpdated: string;
+    messages: MessageRecord[];
+    summary?: string;
+    /** Workspace directories added during the session via /dir add */
+    directories?: string[];
+}
+/**
+ * Data structure for resuming an existing session.
+ */
+export interface ResumedSessionData {
+    conversation: ConversationRecord;
+    filePath: string;
+}
+/**
+ * Service for automatically recording chat conversations to disk.
+ *
+ * This service provides comprehensive conversation recording that captures:
+ * - All user and assistant messages
+ * - Tool calls and their execution results
+ * - Token usage statistics
+ * - Assistant thoughts and reasoning
+ *
+ * Sessions are stored as JSON files in ~/.gemini/tmp/<project_hash>/chats/
+ */
+export declare class ChatRecordingService {
+    private conversationFile;
+    private cachedLastConvData;
+    private sessionId;
+    private projectHash;
+    private queuedThoughts;
+    private queuedTokens;
+    private config;
+    constructor(config: Config);
+    /**
+     * Initializes the chat recording service: creates a new conversation file and associates it with
+     * this service instance, or resumes from an existing session if resumedSessionData is provided.
+     */
+    initialize(resumedSessionData?: ResumedSessionData): void;
+    private getLastMessage;
+    private newMessage;
+    /**
+     * Records a message in the conversation.
+     */
+    recordMessage(message: {
+        model: string | undefined;
+        type: ConversationRecordExtra['type'];
+        content: PartListUnion;
+        displayContent?: PartListUnion;
+    }): void;
+    /**
+     * Records a thought from the assistant's reasoning process.
+     */
+    recordThought(thought: ThoughtSummary): void;
+    /**
+     * Updates the tokens for the last message in the conversation (which should be by Gemini).
+     */
+    recordMessageTokens(respUsageMetadata: GenerateContentResponseUsageMetadata): void;
+    /**
+     * Adds tool calls to the last message in the conversation (which should be by Gemini).
+     * This method enriches tool calls with metadata from the ToolRegistry.
+     */
+    recordToolCalls(model: string, toolCalls: ToolCallRecord[]): void;
+    /**
+     * Loads up the conversation record from disk.
+     */
+    private readConversation;
+    /**
+     * Saves the conversation record; overwrites the file.
+     */
+    private writeConversation;
+    /**
+     * Convenient helper for updating the conversation without file reading and writing and time
+     * updating boilerplate.
+     */
+    private updateConversation;
+    /**
+     * Saves a summary for the current session.
+     */
+    saveSummary(summary: string): void;
+    /**
+     * Records workspace directories to the session file.
+     * Called when directories are added via /dir add.
+     */
+    recordDirectories(directories: readonly string[]): void;
+    /**
+     * Gets the current conversation data (for summary generation).
+     */
+    getConversation(): ConversationRecord | null;
+    /**
+     * Gets the path to the current conversation file.
+     * Returns null if the service hasn't been initialized yet or recording is disabled.
+     */
+    getConversationFilePath(): string | null;
+    /**
+     * Deletes a session file by session ID.
+     */
+    deleteSession(sessionId: string): void;
+    /**
+     * Rewinds the conversation to the state just before the specified message ID.
+     * All messages from (and including) the specified ID onwards are removed.
+     */
+    rewindTo(messageId: string): ConversationRecord | null;
+}

package/dist/src/services/chatRecordingService.js

@@ -0,0 +1,427 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from '../config/config.js';
+import {} from '../core/coreToolScheduler.js';
+import {} from '../utils/thoughtUtils.js';
+import { getProjectHash } from '../utils/paths.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { debugLogger } from '../utils/debugLogger.js';
+export const SESSION_FILE_PREFIX = 'session-';
+/**
+ * Warning message shown when recording is disabled due to disk full.
+ */
+const ENOSPC_WARNING_MESSAGE = 'Chat recording disabled: No space left on device. ' +
+    'The conversation will continue but will not be saved to disk. ' +
+    'Free up disk space and restart to enable recording.';
+/**
+ * Service for automatically recording chat conversations to disk.
+ *
+ * This service provides comprehensive conversation recording that captures:
+ * - All user and assistant messages
+ * - Tool calls and their execution results
+ * - Token usage statistics
+ * - Assistant thoughts and reasoning
+ *
+ * Sessions are stored as JSON files in ~/.gemini/tmp/<project_hash>/chats/
+ */
+export class ChatRecordingService {
+    conversationFile = null;
+    cachedLastConvData = null;
+    sessionId;
+    projectHash;
+    queuedThoughts = [];
+    queuedTokens = null;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sessionId = config.getSessionId();
+        this.projectHash = getProjectHash(config.getProjectRoot());
+    }
+    /**
+     * Initializes the chat recording service: creates a new conversation file and associates it with
+     * this service instance, or resumes from an existing session if resumedSessionData is provided.
+     */
+    initialize(resumedSessionData) {
+        try {
+            if (resumedSessionData) {
+                // Resume from existing session
+                this.conversationFile = resumedSessionData.filePath;
+                this.sessionId = resumedSessionData.conversation.sessionId;
+                // Update the session ID in the existing file
+                this.updateConversation((conversation) => {
+                    conversation.sessionId = this.sessionId;
+                });
+                // Clear any cached data to force fresh reads
+                this.cachedLastConvData = null;
+            }
+            else {
+                // Create new session
+                const chatsDir = path.join(this.config.storage.getProjectTempDir(), 'chats');
+                fs.mkdirSync(chatsDir, { recursive: true });
+                const timestamp = new Date()
+                    .toISOString()
+                    .slice(0, 16)
+                    .replace(/:/g, '-');
+                const filename = `${SESSION_FILE_PREFIX}${timestamp}-${this.sessionId.slice(0, 8)}.json`;
+                this.conversationFile = path.join(chatsDir, filename);
+                this.writeConversation({
+                    sessionId: this.sessionId,
+                    projectHash: this.projectHash,
+                    startTime: new Date().toISOString(),
+                    lastUpdated: new Date().toISOString(),
+                    messages: [],
+                });
+            }
+            // Clear any queued data since this is a fresh start
+            this.queuedThoughts = [];
+            this.queuedTokens = null;
+        }
+        catch (error) {
+            // Handle disk full (ENOSPC) gracefully - disable recording but allow CLI to continue
+            if (error instanceof Error &&
+                'code' in error &&
+                error.code === 'ENOSPC') {
+                this.conversationFile = null;
+                debugLogger.warn(ENOSPC_WARNING_MESSAGE);
+                return; // Don't throw - allow the CLI to continue
+            }
+            debugLogger.error('Error initializing chat recording service:', error);
+            throw error;
+        }
+    }
+    getLastMessage(conversation) {
+        return conversation.messages.at(-1);
+    }
+    newMessage(type, content, displayContent) {
+        return {
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            type,
+            content,
+            displayContent,
+        };
+    }
+    /**
+     * Records a message in the conversation.
+     */
+    recordMessage(message) {
+        if (!this.conversationFile)
+            return;
+        try {
+            this.updateConversation((conversation) => {
+                const msg = this.newMessage(message.type, message.content, message.displayContent);
+                if (msg.type === 'gemini') {
+                    // If it's a new Gemini message then incorporate any queued thoughts.
+                    conversation.messages.push({
+                        ...msg,
+                        thoughts: this.queuedThoughts,
+                        tokens: this.queuedTokens,
+                        model: message.model,
+                    });
+                    this.queuedThoughts = [];
+                    this.queuedTokens = null;
+                }
+                else {
+                    // Or else just add it.
+                    conversation.messages.push(msg);
+                }
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error saving message to chat history.', error);
+            throw error;
+        }
+    }
+    /**
+     * Records a thought from the assistant's reasoning process.
+     */
+    recordThought(thought) {
+        if (!this.conversationFile)
+            return;
+        try {
+            this.queuedThoughts.push({
+                ...thought,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error saving thought to chat history.', error);
+            throw error;
+        }
+    }
+    /**
+     * Updates the tokens for the last message in the conversation (which should be by Gemini).
+     */
+    recordMessageTokens(respUsageMetadata) {
+        if (!this.conversationFile)
+            return;
+        try {
+            const tokens = {
+                input: respUsageMetadata.promptTokenCount ?? 0,
+                output: respUsageMetadata.candidatesTokenCount ?? 0,
+                cached: respUsageMetadata.cachedContentTokenCount ?? 0,
+                thoughts: respUsageMetadata.thoughtsTokenCount ?? 0,
+                tool: respUsageMetadata.toolUsePromptTokenCount ?? 0,
+                total: respUsageMetadata.totalTokenCount ?? 0,
+            };
+            this.updateConversation((conversation) => {
+                const lastMsg = this.getLastMessage(conversation);
+                // If the last message already has token info, it's because this new token info is for a
+                // new message that hasn't been recorded yet.
+                if (lastMsg && lastMsg.type === 'gemini' && !lastMsg.tokens) {
+                    lastMsg.tokens = tokens;
+                    this.queuedTokens = null;
+                }
+                else {
+                    this.queuedTokens = tokens;
+                }
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error updating message tokens in chat history.', error);
+            throw error;
+        }
+    }
+    /**
+     * Adds tool calls to the last message in the conversation (which should be by Gemini).
+     * This method enriches tool calls with metadata from the ToolRegistry.
+     */
+    recordToolCalls(model, toolCalls) {
+        if (!this.conversationFile)
+            return;
+        // Enrich tool calls with metadata from the ToolRegistry
+        const toolRegistry = this.config.getToolRegistry();
+        const enrichedToolCalls = toolCalls.map((toolCall) => {
+            const toolInstance = toolRegistry.getTool(toolCall.name);
+            return {
+                ...toolCall,
+                displayName: toolInstance?.displayName || toolCall.name,
+                description: toolInstance?.description || '',
+                renderOutputAsMarkdown: toolInstance?.isOutputMarkdown || false,
+            };
+        });
+        try {
+            this.updateConversation((conversation) => {
+                const lastMsg = this.getLastMessage(conversation);
+                // If a tool call was made, but the last message isn't from Gemini, it's because Gemini is
+                // calling tools without starting the message with text.  So the user submits a prompt, and
+                // Gemini immediately calls a tool (maybe with some thinking first).  In that case, create
+                // a new empty Gemini message.
+                // Also if there are any queued thoughts, it means this tool call(s) is from a new Gemini
+                // message--because it's thought some more since we last, if ever, created a new Gemini
+                // message from tool calls, when we dequeued the thoughts.
+                if (!lastMsg ||
+                    lastMsg.type !== 'gemini' ||
+                    this.queuedThoughts.length > 0) {
+                    const newMsg = {
+                        ...this.newMessage('gemini', ''),
+                        // This isn't strictly necessary, but TypeScript apparently can't
+                        // tell that the first parameter to newMessage() becomes the
+                        // resulting message's type, and so it thinks that toolCalls may
+                        // not be present.  Confirming the type here satisfies it.
+                        type: 'gemini',
+                        toolCalls: enrichedToolCalls,
+                        thoughts: this.queuedThoughts,
+                        model,
+                    };
+                    // If there are any queued thoughts join them to this message.
+                    if (this.queuedThoughts.length > 0) {
+                        newMsg.thoughts = this.queuedThoughts;
+                        this.queuedThoughts = [];
+                    }
+                    // If there's any queued tokens info join it to this message.
+                    if (this.queuedTokens) {
+                        newMsg.tokens = this.queuedTokens;
+                        this.queuedTokens = null;
+                    }
+                    conversation.messages.push(newMsg);
+                }
+                else {
+                    // The last message is an existing Gemini message that we need to update.
+                    // Update any existing tool call entries.
+                    if (!lastMsg.toolCalls) {
+                        lastMsg.toolCalls = [];
+                    }
+                    lastMsg.toolCalls = lastMsg.toolCalls.map((toolCall) => {
+                        // If there are multiple tool calls with the same ID, this will take the first one.
+                        const incomingToolCall = toolCalls.find((tc) => tc.id === toolCall.id);
+                        if (incomingToolCall) {
+                            // Merge in the new data to keep preserve thoughts, etc., that were assigned to older
+                            // versions of the tool call.
+                            return { ...toolCall, ...incomingToolCall };
+                        }
+                        else {
+                            return toolCall;
+                        }
+                    });
+                    // Add any new tools calls that aren't in the message yet.
+                    for (const toolCall of enrichedToolCalls) {
+                        const existingToolCall = lastMsg.toolCalls.find((tc) => tc.id === toolCall.id);
+                        if (!existingToolCall) {
+                            lastMsg.toolCalls.push(toolCall);
+                        }
+                    }
+                }
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error adding tool call to message in chat history.', error);
+            throw error;
+        }
+    }
+    /**
+     * Loads up the conversation record from disk.
+     */
+    readConversation() {
+        try {
+            this.cachedLastConvData = fs.readFileSync(this.conversationFile, 'utf8');
+            return JSON.parse(this.cachedLastConvData);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                debugLogger.error('Error reading conversation file.', error);
+                throw error;
+            }
+            // Placeholder empty conversation if file doesn't exist.
+            return {
+                sessionId: this.sessionId,
+                projectHash: this.projectHash,
+                startTime: new Date().toISOString(),
+                lastUpdated: new Date().toISOString(),
+                messages: [],
+            };
+        }
+    }
+    /**
+     * Saves the conversation record; overwrites the file.
+     */
+    writeConversation(conversation, { allowEmpty = false } = {}) {
+        try {
+            if (!this.conversationFile)
+                return;
+            // Don't write the file yet until there's at least one message.
+            if (conversation.messages.length === 0 && !allowEmpty)
+                return;
+            // Only write the file if this change would change the file.
+            if (this.cachedLastConvData !== JSON.stringify(conversation, null, 2)) {
+                conversation.lastUpdated = new Date().toISOString();
+                const newContent = JSON.stringify(conversation, null, 2);
+                this.cachedLastConvData = newContent;
+                fs.writeFileSync(this.conversationFile, newContent);
+            }
+        }
+        catch (error) {
+            // Handle disk full (ENOSPC) gracefully - disable recording but allow conversation to continue
+            if (error instanceof Error &&
+                'code' in error &&
+                error.code === 'ENOSPC') {
+                this.conversationFile = null;
+                debugLogger.warn(ENOSPC_WARNING_MESSAGE);
+                return; // Don't throw - allow the conversation to continue
+            }
+            debugLogger.error('Error writing conversation file.', error);
+            throw error;
+        }
+    }
+    /**
+     * Convenient helper for updating the conversation without file reading and writing and time
+     * updating boilerplate.
+     */
+    updateConversation(updateFn) {
+        const conversation = this.readConversation();
+        updateFn(conversation);
+        this.writeConversation(conversation);
+    }
+    /**
+     * Saves a summary for the current session.
+     */
+    saveSummary(summary) {
+        if (!this.conversationFile)
+            return;
+        try {
+            this.updateConversation((conversation) => {
+                conversation.summary = summary;
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error saving summary to chat history.', error);
+            // Don't throw - we want graceful degradation
+        }
+    }
+    /**
+     * Records workspace directories to the session file.
+     * Called when directories are added via /dir add.
+     */
+    recordDirectories(directories) {
+        if (!this.conversationFile)
+            return;
+        try {
+            this.updateConversation((conversation) => {
+                conversation.directories = [...directories];
+            });
+        }
+        catch (error) {
+            debugLogger.error('Error saving directories to chat history.', error);
+            // Don't throw - we want graceful degradation
+        }
+    }
+    /**
+     * Gets the current conversation data (for summary generation).
+     */
+    getConversation() {
+        if (!this.conversationFile)
+            return null;
+        try {
+            return this.readConversation();
+        }
+        catch (error) {
+            debugLogger.error('Error reading conversation for summary.', error);
+            return null;
+        }
+    }
+    /**
+     * Gets the path to the current conversation file.
+     * Returns null if the service hasn't been initialized yet or recording is disabled.
+     */
+    getConversationFilePath() {
+        return this.conversationFile;
+    }
+    /**
+     * Deletes a session file by session ID.
+     */
+    deleteSession(sessionId) {
+        try {
+            const chatsDir = path.join(this.config.storage.getProjectTempDir(), 'chats');
+            const sessionPath = path.join(chatsDir, `${sessionId}.json`);
+            fs.unlinkSync(sessionPath);
+        }
+        catch (error) {
+            debugLogger.error('Error deleting session file.', error);
+            throw error;
+        }
+    }
+    /**
+     * Rewinds the conversation to the state just before the specified message ID.
+     * All messages from (and including) the specified ID onwards are removed.
+     */
+    rewindTo(messageId) {
+        if (!this.conversationFile) {
+            return null;
+        }
+        const conversation = this.readConversation();
+        const messageIndex = conversation.messages.findIndex((m) => m.id === messageId);
+        if (messageIndex === -1) {
+            debugLogger.error('Message to rewind to not found in conversation history');
+            return conversation;
+        }
+        conversation.messages = conversation.messages.slice(0, messageIndex);
+        this.writeConversation(conversation, { allowEmpty: true });
+        return conversation;
+    }
+}
+//# sourceMappingURL=chatRecordingService.js.map

package/dist/src/services/chatRecordingService.js.map

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

package/dist/src/services/contextManager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+export declare class ContextManager {
+    private readonly loadedPaths;
+    private readonly config;
+    private globalMemory;
+    private environmentMemory;
+    constructor(config: Config);
+    /**
+     * Refreshes the memory by reloading global and environment memory.
+     */
+    refresh(): Promise<void>;
+    private loadGlobalMemory;
+    private loadEnvironmentMemory;
+    /**
+     * Discovers and loads context for a specific accessed path (Tier 3 - JIT).
+     * Traverses upwards from the accessed path to the project root.
+     */
+    discoverContext(accessedPath: string, trustedRoots: string[]): Promise<string>;
+    private emitMemoryChanged;
+    getGlobalMemory(): string;
+    getEnvironmentMemory(): string;
+    private markAsLoaded;
+    getLoadedPaths(): ReadonlySet<string>;
+}