@within-7/minto 0.3.9 → 0.4.0

package/dist/services/sessionMemory.js

@@ -10,6 +10,7 @@ import {
 import { join, resolve } from "path";
 import { homedir } from "os";
 import crypto from "crypto";
+import { debug as debugLogger } from "../utils/debugLogger.js";
 class SessionMemoryManager {
   baseDir;
   projectHash;
@@ -150,12 +151,20 @@ class SessionMemoryManager {
             try {
               const content = readFileSync(metadataPath, "utf-8");
               sessions.push(JSON.parse(content));
-            } catch {
+            } catch (e) {
+              debugLogger.warn(
+                "SESSION_MEMORY",
+                `Skip invalid session metadata: ${e instanceof Error ? e.message : String(e)}`
+              );
             }
           }
         }
       }
-    } catch {
+    } catch (e) {
+      debugLogger.warn(
+        "SESSION_MEMORY",
+        `Cannot read session directory: ${e instanceof Error ? e.message : String(e)}`
+      );
     }
     return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
   }
@@ -200,7 +209,11 @@ class SessionMemoryManager {
           this.deleteDirectory(sessionDir);
           cleaned++;
         }
-      } catch {
+      } catch (e) {
+        debugLogger.warn(
+          "SESSION_MEMORY",
+          `Failed to clean session: ${e instanceof Error ? e.message : String(e)}`
+        );
       }
     }
     return cleaned;

package/dist/services/sessionMemory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/services/sessionMemory.ts"],
-  "sourcesContent": ["/**\n * Session Memory Service\n *\n * Provides persistent session memory for context compression.\n * Stores compressed contexts, decisions, and session metadata.\n *\n * Storage structure:\n * ~/.minto/projects/\n *   <project-hash>/\n *     session-<uuid>/\n *       session_memory.json    # Compressed context\n *       conversation.json      # Full conversation (optional)\n *       decisions.json         # Key decisions\n *       metadata.json          # Session metadata\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n  readdirSync,\n  unlinkSync,\n  rmdirSync,\n} from 'fs'\nimport { join, resolve } from 'path'\nimport { homedir } from 'os'\nimport crypto from 'crypto'\nimport type { Message } from '@query'\nimport type {\n  ExtractedDecision,\n  ExtractedCodeChange,\n} from './intelligentCompactor'\n\n/**\n * Session metadata\n */\nexport interface SessionMetadata {\n  sessionId: string\n  projectPath: string\n  projectHash: string\n  createdAt: number\n  updatedAt: number\n  messageCount: number\n  compressedAt?: number\n  compressionRatio?: number\n  focusArea?: string\n}\n\n/**\n * Session memory data\n */\nexport interface SessionMemoryData {\n  summary: string\n  decisions: ExtractedDecision[]\n  codeChanges: ExtractedCodeChange[]\n  toolUsageSummary: Record<string, number>\n  focusAreas: string[]\n  preservedContext: string[]\n}\n\n/**\n * Full session record\n */\nexport interface SessionRecord {\n  metadata: SessionMetadata\n  memory: SessionMemoryData\n  messages?: Message[]\n}\n\n/**\n * Session Memory Manager\n */\nexport class SessionMemoryManager {\n  private baseDir: string\n  private projectHash: string\n  private sessionId: string\n\n  constructor(projectPath: string, sessionId?: string) {\n    this.baseDir = join(homedir(), '.minto', 'projects')\n    this.projectHash = this.hashPath(projectPath)\n    this.sessionId = sessionId || crypto.randomUUID()\n    this.ensureDirectories()\n  }\n\n  /**\n   * Get the session ID\n   */\n  getSessionId(): string {\n    return this.sessionId\n  }\n\n  /**\n   * Get the project hash\n   */\n  getProjectHash(): string {\n    return this.projectHash\n  }\n\n  /**\n   * Save session memory\n   */\n  saveMemory(\n    memory: SessionMemoryData,\n    metadata?: Partial<SessionMetadata>,\n  ): void {\n    const sessionDir = this.getSessionDir()\n\n    const fullMetadata: SessionMetadata = {\n      sessionId: this.sessionId,\n      projectPath: '', // Will be set by caller\n      projectHash: this.projectHash,\n      createdAt: Date.now(),\n      updatedAt: Date.now(),\n      messageCount: 0,\n      ...this.loadMetadata(),\n      ...metadata,\n    }\n\n    // Save memory\n    writeFileSync(\n      join(sessionDir, 'session_memory.json'),\n      JSON.stringify(memory, null, 2),\n    )\n\n    // Save metadata\n    writeFileSync(\n      join(sessionDir, 'metadata.json'),\n      JSON.stringify(fullMetadata, null, 2),\n    )\n\n    // Save decisions separately for quick access\n    if (memory.decisions.length > 0) {\n      writeFileSync(\n        join(sessionDir, 'decisions.json'),\n        JSON.stringify(memory.decisions, null, 2),\n      )\n    }\n  }\n\n  /**\n   * Save full conversation (optional, for debugging/recovery)\n   */\n  saveConversation(messages: Message[]): void {\n    const sessionDir = this.getSessionDir()\n    writeFileSync(\n      join(sessionDir, 'conversation.json'),\n      JSON.stringify(messages, null, 2),\n    )\n\n    // Update metadata\n    const metadata = this.loadMetadata()\n    if (metadata) {\n      metadata.messageCount = messages.length\n      metadata.updatedAt = Date.now()\n      writeFileSync(\n        join(sessionDir, 'metadata.json'),\n        JSON.stringify(metadata, null, 2),\n      )\n    }\n  }\n\n  /**\n   * Load session memory\n   */\n  loadMemory(): SessionMemoryData | null {\n    const memoryPath = join(this.getSessionDir(), 'session_memory.json')\n    if (!existsSync(memoryPath)) return null\n\n    try {\n      const content = readFileSync(memoryPath, 'utf-8')\n      return JSON.parse(content) as SessionMemoryData\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load session metadata\n   */\n  loadMetadata(): SessionMetadata | null {\n    const metadataPath = join(this.getSessionDir(), 'metadata.json')\n    if (!existsSync(metadataPath)) return null\n\n    try {\n      const content = readFileSync(metadataPath, 'utf-8')\n      return JSON.parse(content) as SessionMetadata\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load conversation history\n   */\n  loadConversation(): Message[] | null {\n    const convoPath = join(this.getSessionDir(), 'conversation.json')\n    if (!existsSync(convoPath)) return null\n\n    try {\n      const content = readFileSync(convoPath, 'utf-8')\n      return JSON.parse(content) as Message[]\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load decisions from current or previous session\n   */\n  loadDecisions(): ExtractedDecision[] {\n    const decisionsPath = join(this.getSessionDir(), 'decisions.json')\n    if (!existsSync(decisionsPath)) return []\n\n    try {\n      const content = readFileSync(decisionsPath, 'utf-8')\n      return JSON.parse(content) as ExtractedDecision[]\n    } catch {\n      return []\n    }\n  }\n\n  /**\n   * List all sessions for current project\n   */\n  listSessions(): SessionMetadata[] {\n    const projectDir = this.getProjectDir()\n    if (!existsSync(projectDir)) return []\n\n    const sessions: SessionMetadata[] = []\n\n    try {\n      const entries = readdirSync(projectDir, { withFileTypes: true })\n      for (const entry of entries) {\n        if (entry.isDirectory() && entry.name.startsWith('session-')) {\n          const metadataPath = join(projectDir, entry.name, 'metadata.json')\n          if (existsSync(metadataPath)) {\n            try {\n              const content = readFileSync(metadataPath, 'utf-8')\n              sessions.push(JSON.parse(content) as SessionMetadata)\n            } catch {\n              // Skip invalid session\n            }\n          }\n        }\n      }\n    } catch {\n      // Return empty if directory cannot be read\n    }\n\n    return sessions.sort((a, b) => b.updatedAt - a.updatedAt)\n  }\n\n  /**\n   * Get the most recent session for current project\n   */\n  getMostRecentSession(): SessionRecord | null {\n    const sessions = this.listSessions()\n    if (sessions.length === 0) return null\n\n    const mostRecent = sessions[0]\n    if (!mostRecent) return null\n\n    const tempManager = new SessionMemoryManager('', mostRecent.sessionId)\n    // Hack to use the same project dir\n    Object.assign(tempManager, { projectHash: this.projectHash })\n\n    return {\n      metadata: mostRecent,\n      memory: tempManager.loadMemory() || {\n        summary: '',\n        decisions: [],\n        codeChanges: [],\n        toolUsageSummary: {},\n        focusAreas: [],\n        preservedContext: [],\n      },\n      messages: tempManager.loadConversation() || undefined,\n    }\n  }\n\n  /**\n   * Clean up old sessions (keep only N most recent)\n   */\n  cleanupOldSessions(keepCount: number = 5): number {\n    const sessions = this.listSessions()\n    let cleaned = 0\n\n    if (sessions.length <= keepCount) return 0\n\n    const toDelete = sessions.slice(keepCount)\n    for (const session of toDelete) {\n      try {\n        const sessionDir = join(\n          this.getProjectDir(),\n          'session-' + session.sessionId,\n        )\n        if (existsSync(sessionDir)) {\n          // Simple recursive delete using fs\n          this.deleteDirectory(sessionDir)\n          cleaned++\n        }\n      } catch {\n        // Continue with other sessions\n      }\n    }\n\n    return cleaned\n  }\n\n  /**\n   * Check if a session exists\n   */\n  sessionExists(): boolean {\n    return existsSync(this.getSessionDir())\n  }\n\n  /**\n   * Get session directory path\n   */\n  private getSessionDir(): string {\n    return join(this.getProjectDir(), 'session-' + this.sessionId)\n  }\n\n  /**\n   * Get project directory path\n   */\n  private getProjectDir(): string {\n    return join(this.baseDir, this.projectHash)\n  }\n\n  /**\n   * Ensure required directories exist\n   */\n  private ensureDirectories(): void {\n    const sessionDir = this.getSessionDir()\n    if (!existsSync(sessionDir)) {\n      mkdirSync(sessionDir, { recursive: true })\n    }\n  }\n\n  /**\n   * Hash a path to create a safe directory name\n   */\n  private hashPath(path: string): string {\n    const normalized = resolve(path).toLowerCase()\n    return crypto\n      .createHash('sha256')\n      .update(normalized)\n      .digest('hex')\n      .slice(0, 16)\n  }\n\n  /**\n   * Recursively delete a directory\n   */\n  private deleteDirectory(dirPath: string): void {\n    if (!existsSync(dirPath)) return\n\n    const entries = readdirSync(dirPath, { withFileTypes: true })\n    for (const entry of entries) {\n      const fullPath = join(dirPath, entry.name)\n      if (entry.isDirectory()) {\n        this.deleteDirectory(fullPath)\n      } else {\n        unlinkSync(fullPath)\n      }\n    }\n    rmdirSync(dirPath)\n  }\n}\n\n/**\n * Create a session memory manager for the current project\n */\nexport function createSessionMemory(\n  projectPath: string,\n  sessionId?: string,\n): SessionMemoryManager {\n  return new SessionMemoryManager(projectPath, sessionId)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Session Memory Service\n *\n * Provides persistent session memory for context compression.\n * Stores compressed contexts, decisions, and session metadata.\n *\n * Storage structure:\n * ~/.minto/projects/\n *   <project-hash>/\n *     session-<uuid>/\n *       session_memory.json    # Compressed context\n *       conversation.json      # Full conversation (optional)\n *       decisions.json         # Key decisions\n *       metadata.json          # Session metadata\n */\n\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n  readdirSync,\n  unlinkSync,\n  rmdirSync,\n} from 'fs'\nimport { join, resolve } from 'path'\nimport { homedir } from 'os'\nimport crypto from 'crypto'\nimport { debug as debugLogger } from '@utils/debugLogger'\nimport type { Message } from '@query'\nimport type {\n  ExtractedDecision,\n  ExtractedCodeChange,\n} from './intelligentCompactor'\n\n/**\n * Session metadata\n */\nexport interface SessionMetadata {\n  sessionId: string\n  projectPath: string\n  projectHash: string\n  createdAt: number\n  updatedAt: number\n  messageCount: number\n  compressedAt?: number\n  compressionRatio?: number\n  focusArea?: string\n}\n\n/**\n * Session memory data\n */\nexport interface SessionMemoryData {\n  summary: string\n  decisions: ExtractedDecision[]\n  codeChanges: ExtractedCodeChange[]\n  toolUsageSummary: Record<string, number>\n  focusAreas: string[]\n  preservedContext: string[]\n}\n\n/**\n * Full session record\n */\nexport interface SessionRecord {\n  metadata: SessionMetadata\n  memory: SessionMemoryData\n  messages?: Message[]\n}\n\n/**\n * Session Memory Manager\n */\nexport class SessionMemoryManager {\n  private baseDir: string\n  private projectHash: string\n  private sessionId: string\n\n  constructor(projectPath: string, sessionId?: string) {\n    this.baseDir = join(homedir(), '.minto', 'projects')\n    this.projectHash = this.hashPath(projectPath)\n    this.sessionId = sessionId || crypto.randomUUID()\n    this.ensureDirectories()\n  }\n\n  /**\n   * Get the session ID\n   */\n  getSessionId(): string {\n    return this.sessionId\n  }\n\n  /**\n   * Get the project hash\n   */\n  getProjectHash(): string {\n    return this.projectHash\n  }\n\n  /**\n   * Save session memory\n   */\n  saveMemory(\n    memory: SessionMemoryData,\n    metadata?: Partial<SessionMetadata>,\n  ): void {\n    const sessionDir = this.getSessionDir()\n\n    const fullMetadata: SessionMetadata = {\n      sessionId: this.sessionId,\n      projectPath: '', // Will be set by caller\n      projectHash: this.projectHash,\n      createdAt: Date.now(),\n      updatedAt: Date.now(),\n      messageCount: 0,\n      ...this.loadMetadata(),\n      ...metadata,\n    }\n\n    // Save memory\n    writeFileSync(\n      join(sessionDir, 'session_memory.json'),\n      JSON.stringify(memory, null, 2),\n    )\n\n    // Save metadata\n    writeFileSync(\n      join(sessionDir, 'metadata.json'),\n      JSON.stringify(fullMetadata, null, 2),\n    )\n\n    // Save decisions separately for quick access\n    if (memory.decisions.length > 0) {\n      writeFileSync(\n        join(sessionDir, 'decisions.json'),\n        JSON.stringify(memory.decisions, null, 2),\n      )\n    }\n  }\n\n  /**\n   * Save full conversation (optional, for debugging/recovery)\n   */\n  saveConversation(messages: Message[]): void {\n    const sessionDir = this.getSessionDir()\n    writeFileSync(\n      join(sessionDir, 'conversation.json'),\n      JSON.stringify(messages, null, 2),\n    )\n\n    // Update metadata\n    const metadata = this.loadMetadata()\n    if (metadata) {\n      metadata.messageCount = messages.length\n      metadata.updatedAt = Date.now()\n      writeFileSync(\n        join(sessionDir, 'metadata.json'),\n        JSON.stringify(metadata, null, 2),\n      )\n    }\n  }\n\n  /**\n   * Load session memory\n   */\n  loadMemory(): SessionMemoryData | null {\n    const memoryPath = join(this.getSessionDir(), 'session_memory.json')\n    if (!existsSync(memoryPath)) return null\n\n    try {\n      const content = readFileSync(memoryPath, 'utf-8')\n      return JSON.parse(content) as SessionMemoryData\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load session metadata\n   */\n  loadMetadata(): SessionMetadata | null {\n    const metadataPath = join(this.getSessionDir(), 'metadata.json')\n    if (!existsSync(metadataPath)) return null\n\n    try {\n      const content = readFileSync(metadataPath, 'utf-8')\n      return JSON.parse(content) as SessionMetadata\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load conversation history\n   */\n  loadConversation(): Message[] | null {\n    const convoPath = join(this.getSessionDir(), 'conversation.json')\n    if (!existsSync(convoPath)) return null\n\n    try {\n      const content = readFileSync(convoPath, 'utf-8')\n      return JSON.parse(content) as Message[]\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Load decisions from current or previous session\n   */\n  loadDecisions(): ExtractedDecision[] {\n    const decisionsPath = join(this.getSessionDir(), 'decisions.json')\n    if (!existsSync(decisionsPath)) return []\n\n    try {\n      const content = readFileSync(decisionsPath, 'utf-8')\n      return JSON.parse(content) as ExtractedDecision[]\n    } catch {\n      return []\n    }\n  }\n\n  /**\n   * List all sessions for current project\n   */\n  listSessions(): SessionMetadata[] {\n    const projectDir = this.getProjectDir()\n    if (!existsSync(projectDir)) return []\n\n    const sessions: SessionMetadata[] = []\n\n    try {\n      const entries = readdirSync(projectDir, { withFileTypes: true })\n      for (const entry of entries) {\n        if (entry.isDirectory() && entry.name.startsWith('session-')) {\n          const metadataPath = join(projectDir, entry.name, 'metadata.json')\n          if (existsSync(metadataPath)) {\n            try {\n              const content = readFileSync(metadataPath, 'utf-8')\n              sessions.push(JSON.parse(content) as SessionMetadata)\n            } catch (e) {\n              debugLogger.warn(\n                'SESSION_MEMORY',\n                `Skip invalid session metadata: ${e instanceof Error ? e.message : String(e)}`,\n              )\n            }\n          }\n        }\n      }\n    } catch (e) {\n      debugLogger.warn(\n        'SESSION_MEMORY',\n        `Cannot read session directory: ${e instanceof Error ? e.message : String(e)}`,\n      )\n    }\n\n    return sessions.sort((a, b) => b.updatedAt - a.updatedAt)\n  }\n\n  /**\n   * Get the most recent session for current project\n   */\n  getMostRecentSession(): SessionRecord | null {\n    const sessions = this.listSessions()\n    if (sessions.length === 0) return null\n\n    const mostRecent = sessions[0]\n    if (!mostRecent) return null\n\n    const tempManager = new SessionMemoryManager('', mostRecent.sessionId)\n    // Hack to use the same project dir\n    Object.assign(tempManager, { projectHash: this.projectHash })\n\n    return {\n      metadata: mostRecent,\n      memory: tempManager.loadMemory() || {\n        summary: '',\n        decisions: [],\n        codeChanges: [],\n        toolUsageSummary: {},\n        focusAreas: [],\n        preservedContext: [],\n      },\n      messages: tempManager.loadConversation() || undefined,\n    }\n  }\n\n  /**\n   * Clean up old sessions (keep only N most recent)\n   */\n  cleanupOldSessions(keepCount: number = 5): number {\n    const sessions = this.listSessions()\n    let cleaned = 0\n\n    if (sessions.length <= keepCount) return 0\n\n    const toDelete = sessions.slice(keepCount)\n    for (const session of toDelete) {\n      try {\n        const sessionDir = join(\n          this.getProjectDir(),\n          'session-' + session.sessionId,\n        )\n        if (existsSync(sessionDir)) {\n          // Simple recursive delete using fs\n          this.deleteDirectory(sessionDir)\n          cleaned++\n        }\n      } catch (e) {\n        debugLogger.warn(\n          'SESSION_MEMORY',\n          `Failed to clean session: ${e instanceof Error ? e.message : String(e)}`,\n        )\n      }\n    }\n\n    return cleaned\n  }\n\n  /**\n   * Check if a session exists\n   */\n  sessionExists(): boolean {\n    return existsSync(this.getSessionDir())\n  }\n\n  /**\n   * Get session directory path\n   */\n  private getSessionDir(): string {\n    return join(this.getProjectDir(), 'session-' + this.sessionId)\n  }\n\n  /**\n   * Get project directory path\n   */\n  private getProjectDir(): string {\n    return join(this.baseDir, this.projectHash)\n  }\n\n  /**\n   * Ensure required directories exist\n   */\n  private ensureDirectories(): void {\n    const sessionDir = this.getSessionDir()\n    if (!existsSync(sessionDir)) {\n      mkdirSync(sessionDir, { recursive: true })\n    }\n  }\n\n  /**\n   * Hash a path to create a safe directory name\n   */\n  private hashPath(path: string): string {\n    const normalized = resolve(path).toLowerCase()\n    return crypto\n      .createHash('sha256')\n      .update(normalized)\n      .digest('hex')\n      .slice(0, 16)\n  }\n\n  /**\n   * Recursively delete a directory\n   */\n  private deleteDirectory(dirPath: string): void {\n    if (!existsSync(dirPath)) return\n\n    const entries = readdirSync(dirPath, { withFileTypes: true })\n    for (const entry of entries) {\n      const fullPath = join(dirPath, entry.name)\n      if (entry.isDirectory()) {\n        this.deleteDirectory(fullPath)\n      } else {\n        unlinkSync(fullPath)\n      }\n    }\n    rmdirSync(dirPath)\n  }\n}\n\n/**\n * Create a session memory manager for the current project\n */\nexport function createSessionMemory(\n  projectPath: string,\n  sessionId?: string,\n): SessionMemoryManager {\n  return new SessionMemoryManager(projectPath, sessionId)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/services/systemReminder.js

@@ -35,13 +35,14 @@ class SystemReminderService {
     const currentTime = Date.now();
     const reminderGenerators = [
       () => this.dispatchTodoEvent(agentId),
+      () => this.dispatchTaskToolsReminder(),
       () => this.dispatchSecurityEvent(),
       () => this.dispatchPerformanceEvent(),
-      () => this.getMentionReminders()
-      // Add mention reminders
+      () => this.getMentionReminders(),
+      () => this.getEventReminders()
     ];
     for (const generator of reminderGenerators) {
-      if (reminders.length >= 5) break;
+      if (reminders.length >= 8) break;
       const result = generator();
       if (result) {
         const remindersToAdd = Array.isArray(result) ? result : [result];
@@ -97,6 +98,18 @@ ${todoContent}. Continue on with the tasks at hand if applicable.`,
     }
     return null;
   }
+  dispatchTaskToolsReminder() {
+    const key = "task_tools_reminder";
+    if (this.sessionState.remindersSent.has(key)) return null;
+    const sessionDuration = Date.now() - this.sessionState.sessionStartTime;
+    if (sessionDuration < 5 * 60 * 1e3) return null;
+    const hasTaskActivity = Array.from(
+      this.sessionState.remindersSent
+    ).some((k) => k.startsWith("task_"));
+    if (hasTaskActivity) return null;
+    this.emitEvent("task:tools_reminder", {});
+    return null;
+  }
   dispatchSecurityEvent() {
     if (!this.sessionState.config.securityReminder) return null;
     const currentTime = Date.now();
@@ -158,6 +171,59 @@ ${todoContent}. Continue on with the tasks at hand if applicable.`,
     const mentionTypes = ["agent_mention", "file_mention", "ask_model_mention"];
     return mentionTypes.includes(reminder.type);
   }
+  /**
+   * Event-based reminder types for hook results, file status, task status
+   */
+  static EVENT_REMINDER_TYPES = /* @__PURE__ */ new Set([
+    // Batch A
+    "hook_additional_context",
+    "hook_blocking_error",
+    "hook_stopped_continuation",
+    "file_empty",
+    "file_truncated",
+    "task_status",
+    "task_tools_reminder",
+    // Batch B
+    "output_style_active",
+    "plan_file_reference",
+    "plan_mode_reentry",
+    "plan_exited",
+    "skill_invoked",
+    "mcp_resource_no_content",
+    "compact_file_reference",
+    // Batch C
+    "token_usage",
+    "budget_usd",
+    "team_coordination",
+    "team_shutdown",
+    "diagnostics_new",
+    "session_continuation"
+  ]);
+  isEventReminder(reminder) {
+    return SystemReminderService.EVENT_REMINDER_TYPES.has(reminder.type);
+  }
+  /**
+   * Retrieve cached event-based reminders (hook results, file status, task status)
+   * Returns recent event reminders within freshness window
+   */
+  getEventReminders() {
+    const currentTime = Date.now();
+    const EVENT_FRESHNESS_WINDOW = 1e4;
+    const reminders = [];
+    const expiredKeys = [];
+    for (const [key, reminder] of this.reminderCache.entries()) {
+      if (this.isEventReminder(reminder)) {
+        const age = currentTime - reminder.timestamp;
+        if (age <= EVENT_FRESHNESS_WINDOW) {
+          reminders.push(reminder);
+        } else {
+          expiredKeys.push(key);
+        }
+      }
+    }
+    expiredKeys.forEach((key) => this.reminderCache.delete(key));
+    return reminders;
+  }
   /**
    * Generate reminders for external file changes
    * Called when todo files are modified externally
@@ -221,12 +287,23 @@ ${content}
       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()
-        });
+        const cacheKey = `file_changed_${agentId}_${Date.now()}`;
+        this.reminderCache.set(cacheKey, reminder);
+      }
+    });
+    this.addEventListener("file:conflict", (context) => {
+      const filePath = context.filePath || context.path || "unknown";
+      const cacheKey = `file_conflict_${filePath}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(cacheKey)) {
+        this.sessionState.remindersSent.add(cacheKey);
+        const reminder = this.createReminderMessage(
+          "file_conflict",
+          "general",
+          "high",
+          `File ${filePath} was modified externally since last read. Re-read the file before editing to avoid overwriting changes.`,
+          Date.now()
+        );
+        this.reminderCache.set(cacheKey, reminder);
       }
     });
     this.addEventListener("file:read", (context) => {
@@ -264,6 +341,287 @@ ${content}
         timestamp: context.timestamp
       });
     });
+    this.addEventListener("hook:additional_context", (context) => {
+      const key = `hook_ctx_${context.hookName}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "hook_additional_context",
+          "general",
+          "medium",
+          `Additional context from hook "${context.hookName}": ${context.content}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("hook:blocking_error", (context) => {
+      const key = `hook_block_${context.hookName}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "hook_blocking_error",
+          "general",
+          "high",
+          `A hook blocked the action: ${context.reason}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("hook:stopped_continuation", (context) => {
+      const key = `hook_stop_${context.hookName}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "hook_stopped_continuation",
+          "general",
+          "high",
+          `A hook stopped continuation: ${context.reason}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("file:empty", (context) => {
+      const key = `file_empty_${context.filePath}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "file_empty",
+          "general",
+          "low",
+          `File exists but is empty: ${context.filePath}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("file:truncated", (context) => {
+      const key = `file_truncated_${context.filePath}_${context.limit}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "file_truncated",
+          "general",
+          "low",
+          `File content was truncated at ${context.limit} lines. Total lines: ${context.totalLines}. Use offset and limit to read more.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("task:status", (context) => {
+      const key = `task_status_${context.taskId}_${context.status}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "task_status",
+          "task",
+          "medium",
+          `Task ${context.taskId} (${context.description || "unnamed"}): status changed to ${context.status}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("task:tools_reminder", (context) => {
+      const key = "task_tools_reminder";
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "task_tools_reminder",
+          "task",
+          "low",
+          "The task tools haven't been used recently. If you're working on tasks that would benefit from tracking progress, consider using TaskCreate to add new tasks and TaskUpdate to update task status (set to in_progress when starting, completed when done). Also consider cleaning up the task list if it has become stale. Only use these if relevant to the current work. This is just a gentle reminder - ignore if not applicable. Make sure that you NEVER mention this reminder to the user",
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("output_style:active", (context) => {
+      const key = `output_style_active_${context.styleName}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "output_style_active",
+          "general",
+          "low",
+          `Output style "${context.styleName}" is active. Follow its formatting instructions for your responses.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("plan:file_reference", (context) => {
+      const key = `plan_file_ref_${context.planPath}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "plan_file_reference",
+          "general",
+          "medium",
+          `A plan file exists at: ${context.planPath}. Review it before making implementation decisions.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("plan:mode_reentry", (context) => {
+      const key = `plan_reentry_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "plan_mode_reentry",
+          "general",
+          "medium",
+          "Re-entering plan mode. Review the existing plan and update as needed before implementation.",
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("plan:exited", (context) => {
+      const key = `plan_exited_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "plan_exited",
+          "general",
+          "medium",
+          "Exited plan mode. Proceed with implementation following the approved plan.",
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("skill:invoked", (context) => {
+      const key = `skill_invoked_${context.skillName}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "skill_invoked",
+          "general",
+          "low",
+          `Skill "${context.skillName}" was invoked. Follow the skill's instructions in the expanded prompt.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("mcp:resource_no_content", (context) => {
+      const key = `mcp_no_content_${context.resourceUri}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "mcp_resource_no_content",
+          "general",
+          "low",
+          `MCP resource "${context.resourceUri}" returned no content. It may be unavailable or empty.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("compact:file_reference", (context) => {
+      const key = `compact_file_ref_${context.filePath}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "compact_file_reference",
+          "general",
+          "low",
+          `Note: ${context.filePath} was read before the last conversation was summarized, but the contents are too large to include. Use Read tool if you need to access it.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("token:usage", (context) => {
+      const key = `token_usage_${context.threshold}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "token_usage",
+          "performance",
+          "low",
+          `Token usage has reached ${context.percentage}% of context limit (${context.used}/${context.total} tokens).`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("budget:usd", (context) => {
+      const key = `budget_usd_${context.threshold}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "budget_usd",
+          "performance",
+          "medium",
+          `USD budget usage: $${context.used.toFixed(2)} of $${context.limit.toFixed(2)} (${context.percentage}%).`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("team:coordination", (context) => {
+      const key = `team_coord_${context.teamId}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "team_coordination",
+          "task",
+          "medium",
+          `Team coordination: ${context.message}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("team:shutdown", (context) => {
+      const key = `team_shutdown_${context.teamId}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "team_shutdown",
+          "task",
+          "high",
+          `Team "${context.teamId}" is shutting down. Reason: ${context.reason || "completed"}`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("diagnostics:new", (context) => {
+      const key = `diagnostics_${context.source}_${Date.now()}`;
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const count = context.count || 1;
+        const reminder = this.createReminderMessage(
+          "diagnostics_new",
+          "general",
+          "low",
+          `${count} new diagnostic${count > 1 ? "s" : ""} detected from ${context.source}. Review before proceeding.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
+    this.addEventListener("session:continuation", (context) => {
+      const key = "session_continuation";
+      if (!this.sessionState.remindersSent.has(key)) {
+        this.sessionState.remindersSent.add(key);
+        const reminder = this.createReminderMessage(
+          "session_continuation",
+          "general",
+          "medium",
+          `This session is a continuation of a previous conversation. Key context has been preserved.`,
+          Date.now()
+        );
+        this.reminderCache.set(key, reminder);
+      }
+    });
   }
   addEventListener(event, callback) {
     if (!this.eventDispatcher.has(event)) {