@shareai-lab/kode 1.1.12 → 1.1.14

package/dist/services/systemReminder.js

@@ -0,0 +1,353 @@
+import { getTodos } from "../utils/todoStorage.js";
+import { logEvent } from "./statsig.js";
+class SystemReminderService {
+  sessionState = {
+    lastTodoUpdate: 0,
+    lastFileAccess: 0,
+    sessionStartTime: Date.now(),
+    remindersSent: /* @__PURE__ */ new Set(),
+    contextPresent: false,
+    reminderCount: 0,
+    config: {
+      todoEmptyReminder: true,
+      securityReminder: true,
+      performanceReminder: true,
+      maxRemindersPerSession: 10
+    }
+  };
+  eventDispatcher = /* @__PURE__ */ new Map();
+  reminderCache = /* @__PURE__ */ new Map();
+  constructor() {
+    this.setupEventDispatcher();
+  }
+  /**
+   * Conditional reminder injection - only when context is present
+   * Enhanced with performance optimizations and priority management
+   */
+  generateReminders(hasContext = false, agentId) {
+    this.sessionState.contextPresent = hasContext;
+    if (!hasContext) {
+      return [];
+    }
+    if (this.sessionState.reminderCount >= this.sessionState.config.maxRemindersPerSession) {
+      return [];
+    }
+    const reminders = [];
+    const currentTime = Date.now();
+    const reminderGenerators = [
+      () => this.dispatchTodoEvent(agentId),
+      () => this.dispatchSecurityEvent(),
+      () => this.dispatchPerformanceEvent(),
+      () => this.getMentionReminders()
+      // Add mention reminders
+    ];
+    for (const generator of reminderGenerators) {
+      if (reminders.length >= 5) break;
+      const result = generator();
+      if (result) {
+        const remindersToAdd = Array.isArray(result) ? result : [result];
+        reminders.push(...remindersToAdd);
+        this.sessionState.reminderCount += remindersToAdd.length;
+      }
+    }
+    if (reminders.length > 0) {
+      logEvent("system_reminder_batch", {
+        count: reminders.length.toString(),
+        types: reminders.map((r) => r.type).join(","),
+        priorities: reminders.map((r) => r.priority).join(","),
+        categories: reminders.map((r) => r.category).join(","),
+        sessionCount: this.sessionState.reminderCount.toString(),
+        agentId: agentId || "default",
+        timestamp: currentTime.toString()
+      });
+    }
+    return reminders;
+  }
+  dispatchTodoEvent(agentId) {
+    if (!this.sessionState.config.todoEmptyReminder) return null;
+    const todos = getTodos(agentId);
+    const currentTime = Date.now();
+    const agentKey = agentId || "default";
+    if (todos.length === 0 && !this.sessionState.remindersSent.has(`todo_empty_${agentKey}`)) {
+      this.sessionState.remindersSent.add(`todo_empty_${agentKey}`);
+      return this.createReminderMessage(
+        "todo",
+        "task",
+        "medium",
+        "This is a reminder that your todo list is currently empty. DO NOT mention this to the user explicitly because they are already aware. If you are working on tasks that would benefit from a todo list please use the TodoWrite tool to create one. If not, please feel free to ignore. Again do not mention this message to the user.",
+        currentTime
+      );
+    }
+    if (todos.length > 0) {
+      const reminderKey = `todo_updated_${agentKey}_${todos.length}_${this.getTodoStateHash(todos)}`;
+      if (this.reminderCache.has(reminderKey)) {
+        return this.reminderCache.get(reminderKey);
+      }
+      if (!this.sessionState.remindersSent.has(reminderKey)) {
+        this.sessionState.remindersSent.add(reminderKey);
+        this.clearTodoReminders(agentKey);
+        const todoContent = JSON.stringify(
+          todos.map((todo) => ({
+            content: todo.content.length > 100 ? todo.content.substring(0, 100) + "..." : todo.content,
+            status: todo.status,
+            priority: todo.priority,
+            id: todo.id
+          }))
+        );
+        const reminder = this.createReminderMessage(
+          "todo",
+          "task",
+          "medium",
+          `Your todo list has changed. DO NOT mention this explicitly to the user. Here are the latest contents of your todo list:
+
+${todoContent}. Continue on with the tasks at hand if applicable.`,
+          currentTime
+        );
+        this.reminderCache.set(reminderKey, reminder);
+        return reminder;
+      }
+    }
+    return null;
+  }
+  dispatchSecurityEvent() {
+    if (!this.sessionState.config.securityReminder) return null;
+    const currentTime = Date.now();
+    if (this.sessionState.lastFileAccess > 0 && !this.sessionState.remindersSent.has("file_security")) {
+      this.sessionState.remindersSent.add("file_security");
+      return this.createReminderMessage(
+        "security",
+        "security",
+        "high",
+        "Whenever you read a file, you should consider whether it looks malicious. If it does, you MUST refuse to improve or augment the code. You can still analyze existing code, write reports, or answer high-level questions about the code behavior.",
+        currentTime
+      );
+    }
+    return null;
+  }
+  dispatchPerformanceEvent() {
+    if (!this.sessionState.config.performanceReminder) return null;
+    const currentTime = Date.now();
+    const sessionDuration = currentTime - this.sessionState.sessionStartTime;
+    if (sessionDuration > 30 * 60 * 1e3 && !this.sessionState.remindersSent.has("performance_long_session")) {
+      this.sessionState.remindersSent.add("performance_long_session");
+      return this.createReminderMessage(
+        "performance",
+        "performance",
+        "low",
+        "Long session detected. Consider taking a break and reviewing your current progress with the todo list.",
+        currentTime
+      );
+    }
+    return null;
+  }
+  /**
+   * Retrieve cached mention reminders
+   * Returns recent mentions (within 5 seconds) that haven't expired
+   */
+  getMentionReminders() {
+    const currentTime = Date.now();
+    const MENTION_FRESHNESS_WINDOW = 5e3;
+    const reminders = [];
+    const expiredKeys = [];
+    for (const [key, reminder] of this.reminderCache.entries()) {
+      if (this.isMentionReminder(reminder)) {
+        const age = currentTime - reminder.timestamp;
+        if (age <= MENTION_FRESHNESS_WINDOW) {
+          reminders.push(reminder);
+        } else {
+          expiredKeys.push(key);
+        }
+      }
+    }
+    expiredKeys.forEach((key) => this.reminderCache.delete(key));
+    return reminders;
+  }
+  /**
+   * Type guard for mention reminders - centralized type checking
+   * Eliminates hardcoded type strings scattered throughout the code
+   */
+  isMentionReminder(reminder) {
+    const mentionTypes = ["agent_mention", "file_mention", "ask_model_mention"];
+    return mentionTypes.includes(reminder.type);
+  }
+  /**
+   * Generate reminders for external file changes
+   * Called when todo files are modified externally
+   */
+  generateFileChangeReminder(context) {
+    const { agentId, filePath, reminder } = context;
+    if (!reminder) {
+      return null;
+    }
+    const currentTime = Date.now();
+    const reminderKey = `file_changed_${agentId}_${filePath}_${currentTime}`;
+    if (this.sessionState.remindersSent.has(reminderKey)) {
+      return null;
+    }
+    this.sessionState.remindersSent.add(reminderKey);
+    return this.createReminderMessage(
+      "file_changed",
+      "general",
+      "medium",
+      reminder,
+      currentTime
+    );
+  }
+  createReminderMessage(type, category, priority, content, timestamp) {
+    return {
+      role: "system",
+      content: `<system-reminder>
+${content}
+</system-reminder>`,
+      isMeta: true,
+      timestamp,
+      type,
+      priority,
+      category
+    };
+  }
+  getTodoStateHash(todos) {
+    return todos.map((t) => `${t.id}:${t.status}`).sort().join("|");
+  }
+  clearTodoReminders(agentId) {
+    const agentKey = agentId || "default";
+    for (const key of this.sessionState.remindersSent) {
+      if (key.startsWith(`todo_updated_${agentKey}_`)) {
+        this.sessionState.remindersSent.delete(key);
+      }
+    }
+  }
+  setupEventDispatcher() {
+    this.addEventListener("session:startup", (context) => {
+      this.resetSession();
+      this.sessionState.sessionStartTime = Date.now();
+      this.sessionState.contextPresent = Object.keys(context.context || {}).length > 0;
+      logEvent("system_reminder_session_startup", {
+        agentId: context.agentId || "default",
+        contextKeys: Object.keys(context.context || {}).join(","),
+        messageCount: (context.messages || 0).toString(),
+        timestamp: context.timestamp.toString()
+      });
+    });
+    this.addEventListener("todo:changed", (context) => {
+      this.sessionState.lastTodoUpdate = Date.now();
+      this.clearTodoReminders(context.agentId);
+    });
+    this.addEventListener("todo:file_changed", (context) => {
+      const agentId = context.agentId || "default";
+      this.clearTodoReminders(agentId);
+      this.sessionState.lastTodoUpdate = Date.now();
+      const reminder = this.generateFileChangeReminder(context);
+      if (reminder) {
+        this.emitEvent("reminder:inject", {
+          reminder: reminder.content,
+          agentId,
+          type: "file_changed",
+          timestamp: Date.now()
+        });
+      }
+    });
+    this.addEventListener("file:read", (context) => {
+      this.sessionState.lastFileAccess = Date.now();
+    });
+    this.addEventListener("file:edited", (context) => {
+    });
+    this.addEventListener("agent:mentioned", (context) => {
+      this.createMentionReminder({
+        type: "agent_mention",
+        key: `agent_mention_${context.agentType}_${context.timestamp}`,
+        category: "task",
+        priority: "high",
+        content: `The user mentioned @${context.originalMention}. You MUST use the Task tool with subagent_type="${context.agentType}" to delegate this task to the specified agent. Provide a detailed, self-contained task description that fully captures the user's intent for the ${context.agentType} agent to execute.`,
+        timestamp: context.timestamp
+      });
+    });
+    this.addEventListener("file:mentioned", (context) => {
+      this.createMentionReminder({
+        type: "file_mention",
+        key: `file_mention_${context.filePath}_${context.timestamp}`,
+        category: "general",
+        priority: "high",
+        content: `The user mentioned @${context.originalMention}. You MUST read the entire content of the file at path: ${context.filePath} using the Read tool to understand the full context before proceeding with the user's request.`,
+        timestamp: context.timestamp
+      });
+    });
+    this.addEventListener("ask-model:mentioned", (context) => {
+      this.createMentionReminder({
+        type: "ask_model_mention",
+        key: `ask_model_mention_${context.modelName}_${context.timestamp}`,
+        category: "task",
+        priority: "high",
+        content: `The user mentioned @${context.modelName}. You MUST use the AskExpertModelTool to consult this specific model for expert opinions and analysis. Provide the user's question or context clearly to get the most relevant response from ${context.modelName}.`,
+        timestamp: context.timestamp
+      });
+    });
+  }
+  addEventListener(event, callback) {
+    if (!this.eventDispatcher.has(event)) {
+      this.eventDispatcher.set(event, []);
+    }
+    this.eventDispatcher.get(event).push(callback);
+  }
+  emitEvent(event, context) {
+    const listeners = this.eventDispatcher.get(event) || [];
+    listeners.forEach((callback) => {
+      try {
+        callback(context);
+      } catch (error) {
+        console.error(`Error in event listener for ${event}:`, error);
+      }
+    });
+  }
+  /**
+   * Unified mention reminder creation - eliminates duplicate logic
+   * Centralizes reminder creation with consistent deduplication
+   */
+  createMentionReminder(params) {
+    if (!this.sessionState.remindersSent.has(params.key)) {
+      this.sessionState.remindersSent.add(params.key);
+      const reminder = this.createReminderMessage(
+        params.type,
+        params.category,
+        params.priority,
+        params.content,
+        params.timestamp
+      );
+      this.reminderCache.set(params.key, reminder);
+    }
+  }
+  resetSession() {
+    this.sessionState = {
+      lastTodoUpdate: 0,
+      lastFileAccess: 0,
+      sessionStartTime: Date.now(),
+      remindersSent: /* @__PURE__ */ new Set(),
+      contextPresent: false,
+      reminderCount: 0,
+      config: { ...this.sessionState.config }
+      // Preserve config across resets
+    };
+    this.reminderCache.clear();
+  }
+  updateConfig(config) {
+    this.sessionState.config = { ...this.sessionState.config, ...config };
+  }
+  getSessionState() {
+    return { ...this.sessionState };
+  }
+}
+const systemReminderService = new SystemReminderService();
+const generateSystemReminders = (hasContext = false, agentId) => systemReminderService.generateReminders(hasContext, agentId);
+const generateFileChangeReminder = (context) => systemReminderService.generateFileChangeReminder(context);
+const emitReminderEvent = (event, context) => systemReminderService.emitEvent(event, context);
+const resetReminderSession = () => systemReminderService.resetSession();
+const getReminderSessionState = () => systemReminderService.getSessionState();
+export {
+  emitReminderEvent,
+  generateFileChangeReminder,
+  generateSystemReminders,
+  getReminderSessionState,
+  resetReminderSession,
+  systemReminderService
+};
+//# sourceMappingURL=systemReminder.js.map

package/dist/services/systemReminder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/services/systemReminder.ts"],
+  "sourcesContent": ["import { getTodos, TodoItem } from '../utils/todoStorage'\nimport { logEvent } from './statsig'\n\nexport interface ReminderMessage {\n  role: 'system'\n  content: string\n  isMeta: boolean\n  timestamp: number\n  type: string\n  priority: 'low' | 'medium' | 'high'\n  category: 'task' | 'security' | 'performance' | 'general'\n}\n\ninterface ReminderConfig {\n  todoEmptyReminder: boolean\n  securityReminder: boolean\n  performanceReminder: boolean\n  maxRemindersPerSession: number\n}\n\ninterface SessionReminderState {\n  lastTodoUpdate: number\n  lastFileAccess: number\n  sessionStartTime: number\n  remindersSent: Set<string>\n  contextPresent: boolean\n  reminderCount: number\n  config: ReminderConfig\n}\n\nclass SystemReminderService {\n  private sessionState: SessionReminderState = {\n    lastTodoUpdate: 0,\n    lastFileAccess: 0,\n    sessionStartTime: Date.now(),\n    remindersSent: new Set(),\n    contextPresent: false,\n    reminderCount: 0,\n    config: {\n      todoEmptyReminder: true,\n      securityReminder: true,\n      performanceReminder: true,\n      maxRemindersPerSession: 10,\n    },\n  }\n\n  private eventDispatcher = new Map<string, Array<(context: any) => void>>()\n  private reminderCache = new Map<string, ReminderMessage>()\n\n  constructor() {\n    this.setupEventDispatcher()\n  }\n\n  /**\n   * Conditional reminder injection - only when context is present\n   * Enhanced with performance optimizations and priority management\n   */\n  public generateReminders(\n    hasContext: boolean = false,\n    agentId?: string,\n  ): ReminderMessage[] {\n    this.sessionState.contextPresent = hasContext\n\n    // Only inject when context is present (matching original behavior)\n    if (!hasContext) {\n      return []\n    }\n\n    // Check session reminder limit to prevent overload\n    if (\n      this.sessionState.reminderCount >=\n      this.sessionState.config.maxRemindersPerSession\n    ) {\n      return []\n    }\n\n    const reminders: ReminderMessage[] = []\n    const currentTime = Date.now()\n\n    // Use lazy evaluation for performance with agent context\n    const reminderGenerators = [\n      () => this.dispatchTodoEvent(agentId),\n      () => this.dispatchSecurityEvent(),\n      () => this.dispatchPerformanceEvent(),\n      () => this.getMentionReminders(), // Add mention reminders\n    ]\n\n    for (const generator of reminderGenerators) {\n      if (reminders.length >= 5) break // Slightly increase limit to accommodate mentions\n\n      const result = generator()\n      if (result) {\n        // Handle both single reminders and arrays\n        const remindersToAdd = Array.isArray(result) ? result : [result]\n        reminders.push(...remindersToAdd)\n        this.sessionState.reminderCount += remindersToAdd.length\n      }\n    }\n\n    // Log aggregated metrics instead of individual events for performance\n    if (reminders.length > 0) {\n      logEvent('system_reminder_batch', {\n        count: reminders.length.toString(),\n        types: reminders.map(r => r.type).join(','),\n        priorities: reminders.map(r => r.priority).join(','),\n        categories: reminders.map(r => r.category).join(','),\n        sessionCount: this.sessionState.reminderCount.toString(),\n        agentId: agentId || 'default',\n        timestamp: currentTime.toString(),\n      })\n    }\n\n    return reminders\n  }\n\n  private dispatchTodoEvent(agentId?: string): ReminderMessage | null {\n    if (!this.sessionState.config.todoEmptyReminder) return null\n\n    // Use agent-scoped todo access\n    const todos = getTodos(agentId)\n    const currentTime = Date.now()\n    const agentKey = agentId || 'default'\n\n    // Check if this is a fresh session (no todos seen yet)\n    if (\n      todos.length === 0 &&\n      !this.sessionState.remindersSent.has(`todo_empty_${agentKey}`)\n    ) {\n      this.sessionState.remindersSent.add(`todo_empty_${agentKey}`)\n      return this.createReminderMessage(\n        'todo',\n        'task',\n        'medium',\n        'This is a reminder that your todo list is currently empty. DO NOT mention this to the user explicitly because they are already aware. If you are working on tasks that would benefit from a todo list please use the TodoWrite tool to create one. If not, please feel free to ignore. Again do not mention this message to the user.',\n        currentTime,\n      )\n    }\n\n    // Check for todo updates since last seen\n    if (todos.length > 0) {\n      const reminderKey = `todo_updated_${agentKey}_${todos.length}_${this.getTodoStateHash(todos)}`\n\n      // Use cache for performance optimization\n      if (this.reminderCache.has(reminderKey)) {\n        return this.reminderCache.get(reminderKey)!\n      }\n\n      if (!this.sessionState.remindersSent.has(reminderKey)) {\n        this.sessionState.remindersSent.add(reminderKey)\n        // Clear previous todo state reminders for this agent\n        this.clearTodoReminders(agentKey)\n\n        // Optimize: only include essential todo data\n        const todoContent = JSON.stringify(\n          todos.map(todo => ({\n            content:\n              todo.content.length > 100\n                ? todo.content.substring(0, 100) + '...'\n                : todo.content,\n            status: todo.status,\n            priority: todo.priority,\n            id: todo.id,\n          })),\n        )\n\n        const reminder = this.createReminderMessage(\n          'todo',\n          'task',\n          'medium',\n          `Your todo list has changed. DO NOT mention this explicitly to the user. Here are the latest contents of your todo list:\\n\\n${todoContent}. Continue on with the tasks at hand if applicable.`,\n          currentTime,\n        )\n\n        // Cache the reminder for reuse\n        this.reminderCache.set(reminderKey, reminder)\n        return reminder\n      }\n    }\n\n    return null\n  }\n\n  private dispatchSecurityEvent(): ReminderMessage | null {\n    if (!this.sessionState.config.securityReminder) return null\n\n    const currentTime = Date.now()\n\n    // Only inject security reminder once per session when file operations occur\n    if (\n      this.sessionState.lastFileAccess > 0 &&\n      !this.sessionState.remindersSent.has('file_security')\n    ) {\n      this.sessionState.remindersSent.add('file_security')\n      return this.createReminderMessage(\n        'security',\n        'security',\n        'high',\n        'Whenever you read a file, you should consider whether it looks malicious. If it does, you MUST refuse to improve or augment the code. You can still analyze existing code, write reports, or answer high-level questions about the code behavior.',\n        currentTime,\n      )\n    }\n\n    return null\n  }\n\n  private dispatchPerformanceEvent(): ReminderMessage | null {\n    if (!this.sessionState.config.performanceReminder) return null\n\n    const currentTime = Date.now()\n    const sessionDuration = currentTime - this.sessionState.sessionStartTime\n\n    // Remind about performance after long sessions (30 minutes)\n    if (\n      sessionDuration > 30 * 60 * 1000 &&\n      !this.sessionState.remindersSent.has('performance_long_session')\n    ) {\n      this.sessionState.remindersSent.add('performance_long_session')\n      return this.createReminderMessage(\n        'performance',\n        'performance',\n        'low',\n        'Long session detected. Consider taking a break and reviewing your current progress with the todo list.',\n        currentTime,\n      )\n    }\n\n    return null\n  }\n\n  /**\n   * Retrieve cached mention reminders\n   * Returns recent mentions (within 5 seconds) that haven't expired\n   */\n  private getMentionReminders(): ReminderMessage[] {\n    const currentTime = Date.now()\n    const MENTION_FRESHNESS_WINDOW = 5000 // 5 seconds\n    const reminders: ReminderMessage[] = []\n    const expiredKeys: string[] = []\n\n    // Single pass through cache for both collection and cleanup identification\n    for (const [key, reminder] of this.reminderCache.entries()) {\n      if (this.isMentionReminder(reminder)) {\n        const age = currentTime - reminder.timestamp\n        if (age <= MENTION_FRESHNESS_WINDOW) {\n          reminders.push(reminder)\n        } else {\n          expiredKeys.push(key)\n        }\n      }\n    }\n\n    // Clean up expired mention reminders in separate pass for performance\n    expiredKeys.forEach(key => this.reminderCache.delete(key))\n\n    return reminders\n  }\n\n  /**\n   * Type guard for mention reminders - centralized type checking\n   * Eliminates hardcoded type strings scattered throughout the code\n   */\n  private isMentionReminder(reminder: ReminderMessage): boolean {\n    const mentionTypes = ['agent_mention', 'file_mention', 'ask_model_mention']\n    return mentionTypes.includes(reminder.type)\n  }\n\n  /**\n   * Generate reminders for external file changes\n   * Called when todo files are modified externally\n   */\n  public generateFileChangeReminder(context: any): ReminderMessage | null {\n    const { agentId, filePath, reminder } = context\n\n    if (!reminder) {\n      return null\n    }\n\n    const currentTime = Date.now()\n    const reminderKey = `file_changed_${agentId}_${filePath}_${currentTime}`\n\n    // Ensure this specific file change reminder is only shown once\n    if (this.sessionState.remindersSent.has(reminderKey)) {\n      return null\n    }\n\n    this.sessionState.remindersSent.add(reminderKey)\n\n    return this.createReminderMessage(\n      'file_changed',\n      'general',\n      'medium',\n      reminder,\n      currentTime,\n    )\n  }\n\n  private createReminderMessage(\n    type: string,\n    category: ReminderMessage['category'],\n    priority: ReminderMessage['priority'],\n    content: string,\n    timestamp: number,\n  ): ReminderMessage {\n    return {\n      role: 'system',\n      content: `<system-reminder>\\n${content}\\n</system-reminder>`,\n      isMeta: true,\n      timestamp,\n      type,\n      priority,\n      category,\n    }\n  }\n\n  private getTodoStateHash(todos: TodoItem[]): string {\n    return todos\n      .map(t => `${t.id}:${t.status}`)\n      .sort()\n      .join('|')\n  }\n\n  private clearTodoReminders(agentId?: string): void {\n    const agentKey = agentId || 'default'\n    for (const key of this.sessionState.remindersSent) {\n      if (key.startsWith(`todo_updated_${agentKey}_`)) {\n        this.sessionState.remindersSent.delete(key)\n      }\n    }\n  }\n\n  private setupEventDispatcher(): void {\n    // Session startup events\n    this.addEventListener('session:startup', context => {\n      // Reset session state on startup\n      this.resetSession()\n\n      // Initialize session tracking\n      this.sessionState.sessionStartTime = Date.now()\n      this.sessionState.contextPresent =\n        Object.keys(context.context || {}).length > 0\n\n      // Log session startup\n      logEvent('system_reminder_session_startup', {\n        agentId: context.agentId || 'default',\n        contextKeys: Object.keys(context.context || {}).join(','),\n        messageCount: (context.messages || 0).toString(),\n        timestamp: context.timestamp.toString(),\n      })\n    })\n\n    // Todo change events\n    this.addEventListener('todo:changed', context => {\n      this.sessionState.lastTodoUpdate = Date.now()\n      this.clearTodoReminders(context.agentId)\n    })\n\n    // Todo file changed externally\n    this.addEventListener('todo:file_changed', context => {\n      // External file change detected, trigger reminder injection\n      const agentId = context.agentId || 'default'\n      this.clearTodoReminders(agentId)\n      this.sessionState.lastTodoUpdate = Date.now()\n\n      // Generate and inject file change reminder immediately\n      const reminder = this.generateFileChangeReminder(context)\n      if (reminder) {\n        // Inject reminder into the latest user message through event system\n        this.emitEvent('reminder:inject', {\n          reminder: reminder.content,\n          agentId,\n          type: 'file_changed',\n          timestamp: Date.now(),\n        })\n      }\n    })\n\n    // File access events\n    this.addEventListener('file:read', context => {\n      this.sessionState.lastFileAccess = Date.now()\n    })\n\n    // File edit events for freshness detection\n    this.addEventListener('file:edited', context => {\n      // File edit handling\n    })\n\n    // Unified mention event handlers - eliminates code duplication\n    this.addEventListener('agent:mentioned', context => {\n      this.createMentionReminder({\n        type: 'agent_mention',\n        key: `agent_mention_${context.agentType}_${context.timestamp}`,\n        category: 'task',\n        priority: 'high',\n        content: `The user mentioned @${context.originalMention}. You MUST use the Task tool with subagent_type=\"${context.agentType}\" to delegate this task to the specified agent. Provide a detailed, self-contained task description that fully captures the user's intent for the ${context.agentType} agent to execute.`,\n        timestamp: context.timestamp\n      })\n    })\n\n    this.addEventListener('file:mentioned', context => {\n      this.createMentionReminder({\n        type: 'file_mention',\n        key: `file_mention_${context.filePath}_${context.timestamp}`,\n        category: 'general',\n        priority: 'high',\n        content: `The user mentioned @${context.originalMention}. You MUST read the entire content of the file at path: ${context.filePath} using the Read tool to understand the full context before proceeding with the user's request.`,\n        timestamp: context.timestamp\n      })\n    })\n\n    this.addEventListener('ask-model:mentioned', context => {\n      this.createMentionReminder({\n        type: 'ask_model_mention',\n        key: `ask_model_mention_${context.modelName}_${context.timestamp}`,\n        category: 'task',\n        priority: 'high',\n        content: `The user mentioned @${context.modelName}. You MUST use the AskExpertModelTool to consult this specific model for expert opinions and analysis. Provide the user's question or context clearly to get the most relevant response from ${context.modelName}.`,\n        timestamp: context.timestamp\n      })\n    })\n  }\n\n  public addEventListener(\n    event: string,\n    callback: (context: any) => void,\n  ): void {\n    if (!this.eventDispatcher.has(event)) {\n      this.eventDispatcher.set(event, [])\n    }\n    this.eventDispatcher.get(event)!.push(callback)\n  }\n\n  public emitEvent(event: string, context: any): void {\n    const listeners = this.eventDispatcher.get(event) || []\n    listeners.forEach(callback => {\n      try {\n        callback(context)\n      } catch (error) {\n        console.error(`Error in event listener for ${event}:`, error)\n      }\n    })\n  }\n\n  /**\n   * Unified mention reminder creation - eliminates duplicate logic\n   * Centralizes reminder creation with consistent deduplication\n   */\n  private createMentionReminder(params: {\n    type: string\n    key: string\n    category: ReminderMessage['category']\n    priority: ReminderMessage['priority']\n    content: string\n    timestamp: number\n  }): void {\n    if (!this.sessionState.remindersSent.has(params.key)) {\n      this.sessionState.remindersSent.add(params.key)\n      \n      const reminder = this.createReminderMessage(\n        params.type,\n        params.category,\n        params.priority,\n        params.content,\n        params.timestamp\n      )\n      \n      this.reminderCache.set(params.key, reminder)\n    }\n  }\n\n  public resetSession(): void {\n    this.sessionState = {\n      lastTodoUpdate: 0,\n      lastFileAccess: 0,\n      sessionStartTime: Date.now(),\n      remindersSent: new Set(),\n      contextPresent: false,\n      reminderCount: 0,\n      config: { ...this.sessionState.config }, // Preserve config across resets\n    }\n    this.reminderCache.clear() // Clear cache on session reset\n  }\n\n  public updateConfig(config: Partial<ReminderConfig>): void {\n    this.sessionState.config = { ...this.sessionState.config, ...config }\n  }\n\n  public getSessionState(): SessionReminderState {\n    return { ...this.sessionState }\n  }\n}\n\nexport const systemReminderService = new SystemReminderService()\n\nexport const generateSystemReminders = (\n  hasContext: boolean = false,\n  agentId?: string,\n) => systemReminderService.generateReminders(hasContext, agentId)\n\nexport const generateFileChangeReminder = (context: any) =>\n  systemReminderService.generateFileChangeReminder(context)\n\nexport const emitReminderEvent = (event: string, context: any) =>\n  systemReminderService.emitEvent(event, context)\n\nexport const resetReminderSession = () => systemReminderService.resetSession()\nexport const getReminderSessionState = () =>\n  systemReminderService.getSessionState()\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/services/vcr.js

@@ -0,0 +1,133 @@
+import { createHash } from "crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname } from "path";
+import { existsSync } from "fs";
+import { env } from "../utils/env.js";
+import { getCwd } from "../utils/state.js";
+import * as path from "path";
+import { mapValues } from "lodash-es";
+async function withVCR(messages, f) {
+  if (process.env.NODE_ENV !== "test") {
+    return await f();
+  }
+  const dehydratedInput = mapMessages(
+    messages.map((_) => _.message.content),
+    dehydrateValue
+  );
+  const filename = `./fixtures/${dehydratedInput.map((_) => createHash("sha1").update(JSON.stringify(_)).digest("hex").slice(0, 6)).join("-")}.json`;
+  if (existsSync(filename)) {
+    const cached = JSON.parse(readFileSync(filename, "utf-8"));
+    return mapAssistantMessage(cached.output, hydrateValue);
+  }
+  if (env.isCI) {
+    console.warn(
+      `Anthropic API fixture missing. Re-run npm test locally, then commit the result. ${JSON.stringify({ input: dehydratedInput }, null, 2)}`
+    );
+  }
+  const result = await f();
+  if (env.isCI) {
+    return result;
+  }
+  if (!existsSync(dirname(filename))) {
+    mkdirSync(dirname(filename), { recursive: true });
+  }
+  writeFileSync(
+    filename,
+    JSON.stringify(
+      {
+        input: dehydratedInput,
+        output: mapAssistantMessage(result, dehydrateValue)
+      },
+      null,
+      2
+    )
+  );
+  return result;
+}
+function mapMessages(messages, f) {
+  return messages.map((_) => {
+    if (typeof _ === "string") {
+      return f(_);
+    }
+    return _.map((_2) => {
+      switch (_2.type) {
+        case "tool_result":
+          if (typeof _2.content === "string") {
+            return { ..._2, content: f(_2.content) };
+          }
+          if (Array.isArray(_2.content)) {
+            return {
+              ..._2,
+              content: _2.content.map((_3) => {
+                switch (_3.type) {
+                  case "text":
+                    return { ..._3, text: f(_3.text) };
+                  case "image":
+                    return _3;
+                }
+              })
+            };
+          }
+          return _2;
+        case "text":
+          return { ..._2, text: f(_2.text) };
+        case "tool_use":
+          return {
+            ..._2,
+            input: mapValues(_2.input, f)
+          };
+        case "image":
+          return _2;
+      }
+    });
+  });
+}
+function mapAssistantMessage(message, f) {
+  return {
+    durationMs: "DURATION",
+    costUSD: "COST",
+    uuid: "UUID",
+    message: {
+      ...message.message,
+      content: message.message.content.map((_) => {
+        switch (_.type) {
+          case "text":
+            return {
+              ..._,
+              text: f(_.text),
+              citations: _.citations || []
+            };
+          // Ensure citations
+          case "tool_use":
+            return {
+              ..._,
+              input: mapValues(_.input, f)
+            };
+          default:
+            return _;
+        }
+      }).filter(Boolean)
+    },
+    type: "assistant"
+  };
+}
+function dehydrateValue(s) {
+  if (typeof s !== "string") {
+    return s;
+  }
+  const s1 = s.replace(/num_files="\d+"/g, 'num_files="[NUM]"').replace(/duration_ms="\d+"/g, 'duration_ms="[DURATION]"').replace(/cost_usd="\d+"/g, 'cost_usd="[COST]"').replace(/\//g, path.sep).replaceAll(getCwd(), "[CWD]");
+  if (s1.includes("Files modified by user:")) {
+    return "Files modified by user: [FILES]";
+  }
+  return s1;
+}
+function hydrateValue(s) {
+  if (typeof s !== "string") {
+    return s;
+  }
+  return s.replaceAll("[NUM]", "1").replaceAll("[DURATION]", "100").replaceAll("[CWD]", getCwd());
+}
+export {
+  withVCR
+};
+//# sourceMappingURL=vcr.js.map

package/dist/services/vcr.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/services/vcr.ts"],
+  "sourcesContent": ["import { createHash, type UUID } from 'crypto'\nimport { mkdirSync, readFileSync, writeFileSync } from 'fs'\nimport { dirname } from 'path'\nimport type { AssistantMessage, UserMessage } from '../query'\nimport { existsSync } from 'fs'\nimport { env } from '../utils/env'\nimport { getCwd } from '../utils/state'\nimport * as path from 'path'\nimport { mapValues } from 'lodash-es'\nimport type { ContentBlock } from '@anthropic-ai/sdk/resources/index.mjs'\n\nexport async function withVCR(\n  messages: (UserMessage | AssistantMessage)[],\n  f: () => Promise<AssistantMessage>,\n): Promise<AssistantMessage> {\n  if (process.env.NODE_ENV !== 'test') {\n    return await f()\n  }\n\n  const dehydratedInput = mapMessages(\n    messages.map(_ => _.message.content),\n    dehydrateValue,\n  )\n  const filename = `./fixtures/${dehydratedInput.map(_ => createHash('sha1').update(JSON.stringify(_)).digest('hex').slice(0, 6)).join('-')}.json`\n\n  // Fetch cached fixture\n  if (existsSync(filename)) {\n    const cached = JSON.parse(readFileSync(filename, 'utf-8'))\n    return mapAssistantMessage(cached.output, hydrateValue)\n  }\n\n  if (env.isCI) {\n    console.warn(\n      `Anthropic API fixture missing. Re-run npm test locally, then commit the result. ${JSON.stringify({ input: dehydratedInput }, null, 2)}`,\n    )\n  }\n\n  // Create & write new fixture\n  const result = await f()\n  if (env.isCI) {\n    return result\n  }\n\n  if (!existsSync(dirname(filename))) {\n    mkdirSync(dirname(filename), { recursive: true })\n  }\n  writeFileSync(\n    filename,\n    JSON.stringify(\n      {\n        input: dehydratedInput,\n        output: mapAssistantMessage(result, dehydrateValue),\n      },\n      null,\n      2,\n    ),\n  )\n  return result\n}\n\nfunction mapMessages(\n  messages: (UserMessage | AssistantMessage)['message']['content'][],\n  f: (s: unknown) => unknown,\n): (UserMessage | AssistantMessage)['message']['content'][] {\n  return messages.map(_ => {\n    if (typeof _ === 'string') {\n      return f(_)\n    }\n    return _.map(_ => {\n      switch (_.type) {\n        case 'tool_result':\n          if (typeof _.content === 'string') {\n            return { ..._, content: f(_.content) }\n          }\n          if (Array.isArray(_.content)) {\n            return {\n              ..._,\n              content: _.content.map(_ => {\n                switch (_.type) {\n                  case 'text':\n                    return { ..._, text: f(_.text) }\n                  case 'image':\n                    return _\n                }\n              }),\n            }\n          }\n          return _\n        case 'text':\n          return { ..._, text: f(_.text) }\n        case 'tool_use':\n          return {\n            ..._,\n            input: mapValues(_.input as Record<string, unknown>, f),\n          }\n        case 'image':\n          return _\n      }\n    })\n  }) as (UserMessage | AssistantMessage)['message']['content'][]\n}\n\nfunction mapAssistantMessage(\n  message: AssistantMessage,\n  f: (s: unknown) => unknown,\n): AssistantMessage {\n  return {\n    durationMs: 'DURATION' as unknown as number,\n    costUSD: 'COST' as unknown as number,\n    uuid: 'UUID' as unknown as UUID,\n    message: {\n      ...message.message,\n      content: message.message.content\n        .map(_ => {\n          switch (_.type) {\n            case 'text':\n              return {\n                ..._,\n                text: f(_.text) as string,\n                citations: _.citations || [],\n              } // Ensure citations\n            case 'tool_use':\n              return {\n                ..._,\n                input: mapValues(_.input as Record<string, unknown>, f),\n              }\n            default:\n              return _ // Handle other block types unchanged\n          }\n        })\n        .filter(Boolean) as ContentBlock[],\n    },\n    type: 'assistant',\n  }\n}\n\nfunction dehydrateValue(s: unknown): unknown {\n  if (typeof s !== 'string') {\n    return s\n  }\n  const s1 = s\n    .replace(/num_files=\"\\d+\"/g, 'num_files=\"[NUM]\"')\n    .replace(/duration_ms=\"\\d+\"/g, 'duration_ms=\"[DURATION]\"')\n    .replace(/cost_usd=\"\\d+\"/g, 'cost_usd=\"[COST]\"')\n    .replace(/\\//g, path.sep)\n    .replaceAll(getCwd(), '[CWD]')\n  if (s1.includes('Files modified by user:')) {\n    return 'Files modified by user: [FILES]'\n  }\n  return s1\n}\n\nfunction hydrateValue(s: unknown): unknown {\n  if (typeof s !== 'string') {\n    return s\n  }\n  return s\n    .replaceAll('[NUM]', '1')\n    .replaceAll('[DURATION]', '100')\n    .replaceAll('[CWD]', getCwd())\n}\n"],
+  "mappings": "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",
+  "names": ["_"]
+}

package/dist/test/testAdapters.js

@@ -0,0 +1,88 @@
+import { ModelAdapterFactory } from '../services/modelAdapterFactory.js';
+import { getModelCapabilities } from '../constants/modelCapabilities.js';
+// Test different models' adapter selection
+const testModels = [
+    {
+        name: 'GPT-5 Test',
+        modelName: 'gpt-5',
+        provider: 'openai',
+        apiKey: 'test-key',
+        maxTokens: 8192,
+        contextLength: 128000,
+        reasoningEffort: 'medium',
+        isActive: true,
+        createdAt: Date.now()
+    },
+    {
+        name: 'GPT-4o Test',
+        modelName: 'gpt-4o',
+        provider: 'openai',
+        apiKey: 'test-key',
+        maxTokens: 4096,
+        contextLength: 128000,
+        isActive: true,
+        createdAt: Date.now()
+    },
+    {
+        name: 'Claude Test',
+        modelName: 'claude-3-5-sonnet-20241022',
+        provider: 'anthropic',
+        apiKey: 'test-key',
+        maxTokens: 4096,
+        contextLength: 200000,
+        isActive: true,
+        createdAt: Date.now()
+    },
+    {
+        name: 'O1 Test',
+        modelName: 'o1',
+        provider: 'openai',
+        apiKey: 'test-key',
+        maxTokens: 4096,
+        contextLength: 128000,
+        isActive: true,
+        createdAt: Date.now()
+    },
+    {
+        name: 'GLM-5 Test',
+        modelName: 'glm-5',
+        provider: 'custom',
+        apiKey: 'test-key',
+        maxTokens: 8192,
+        contextLength: 128000,
+        baseURL: 'https://api.glm.ai/v1',
+        isActive: true,
+        createdAt: Date.now()
+    }
+];
+console.log('🧪 Testing Model Adapter System\n');
+console.log('='.repeat(60));
+testModels.forEach(model => {
+    console.log(`\n📊 Testing: ${model.name} (${model.modelName})`);
+    console.log('-'.repeat(40));
+    // Get capabilities
+    const capabilities = getModelCapabilities(model.modelName);
+    console.log(`  ✓ API Architecture: ${capabilities.apiArchitecture.primary}`);
+    console.log(`  ✓ Fallback: ${capabilities.apiArchitecture.fallback || 'none'}`);
+    console.log(`  ✓ Max Tokens Field: ${capabilities.parameters.maxTokensField}`);
+    console.log(`  ✓ Tool Calling Mode: ${capabilities.toolCalling.mode}`);
+    console.log(`  ✓ Supports Freeform: ${capabilities.toolCalling.supportsFreeform}`);
+    console.log(`  ✓ Supports Streaming: ${capabilities.streaming.supported}`);
+    // Test adapter creation
+    const adapter = ModelAdapterFactory.createAdapter(model);
+    console.log(`  ✓ Adapter Type: ${adapter.constructor.name}`);
+    // Test shouldUseResponsesAPI
+    const shouldUseResponses = ModelAdapterFactory.shouldUseResponsesAPI(model);
+    console.log(`  ✓ Should Use Responses API: ${shouldUseResponses}`);
+    // Test with custom endpoint
+    if (model.baseURL) {
+        const customModel = { ...model, baseURL: 'https://custom.api.com/v1' };
+        const customShouldUseResponses = ModelAdapterFactory.shouldUseResponsesAPI(customModel);
+        console.log(`  ✓ With Custom Endpoint: ${customShouldUseResponses ? 'Responses API' : 'Chat Completions'}`);
+    }
+});
+console.log('\n' + '='.repeat(60));
+console.log('✅ Adapter System Test Complete!');
+console.log('\nTo enable the new system, set USE_NEW_ADAPTERS=true');
+console.log('To use legacy system, set USE_NEW_ADAPTERS=false');
+//# sourceMappingURL=testAdapters.js.map

package/dist/test/testAdapters.js.map

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