@xopcai/xopc 0.0.117 → 0.0.119

package/dist/src/agent/lifecycle/handlers/compaction.js

@@ -3,21 +3,9 @@ import { init_logger } from "../../../utils/logger.js";
 //#region src/agent/lifecycle/handlers/compaction.ts
 init_logger();
 const logger = createLogger("Agent:LifecycleCompaction");
-const DEFAULT_CONFIG = {
-	minMessages: 20,
-	maxTokens: 8e3,
-	preserveReasoning: true,
-	accumulateUsage: true
-};
 var CompactionLifecycleHandler = class {
 	name = "CompactionLifecycleHandler";
-	config;
-	constructor(config) {
-		this.config = {
-			...DEFAULT_CONFIG,
-			...config
-		};
-	}
+	constructor(_config) {}
 	async handle(event, _context) {
 		const { sessionKey } = event;
 		logger.debug({
@@ -25,9 +13,6 @@ var CompactionLifecycleHandler = class {
 			messageCount: event.payload?.usage?.total
 		}, "Compaction lifecycle event received");
 	}
-	shouldCompact(messageCount) {
-		return messageCount >= this.config.minMessages;
-	}
 };
 //#endregion
 export { CompactionLifecycleHandler };

package/dist/src/agent/lifecycle/handlers/compaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.js","names":[],"sources":["../../../../../src/agent/lifecycle/handlers/compaction.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { AgentContext } from '../../service.types.js';\nimport type {\n  LifecycleHandler,\n  LifecycleEventData,\n  LLMResponsePayload,\n} from '../types.js';\n\nconst logger = createLogger('Agent:LifecycleCompaction');\n\nexport interface CompactionHandlerConfig {\n  minMessages: number;\n  maxTokens: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nconst DEFAULT_CONFIG: CompactionHandlerConfig = {\n  minMessages: 20,\n  maxTokens: 8000,\n  preserveReasoning: true,\n  accumulateUsage: true,\n};\n\nexport class CompactionLifecycleHandler\n  implements LifecycleHandler<LLMResponsePayload>\n{\n  readonly name = 'CompactionLifecycleHandler';\n  private config: CompactionHandlerConfig;\n\n  constructor(config?: Partial<CompactionHandlerConfig>) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  async handle(\n    event: LifecycleEventData<LLMResponsePayload>,\n    _context: AgentContext\n  ): Promise<void> {\n    const { sessionKey } = event;\n\n    // Compaction logic is handled by SessionStore, this handler just logs for now\n    logger.debug({ sessionKey, messageCount: event.payload?.usage?.total }, 'Compaction lifecycle event received');\n  }\n\n  private shouldCompact(messageCount: number): boolean {\n    return messageCount >= this.config.minMessages;\n  }\n}\n"],"mappings":";;;aAAwD;AAQxD,MAAM,SAAS,aAAa,4BAA4B;AASxD,MAAM,iBAA0C;CAC9C,aAAa;CACb,WAAW;CACX,mBAAmB;CACnB,iBAAiB;CAClB;AAED,IAAa,6BAAb,MAEA;CACE,OAAgB;CAChB;CAEA,YAAY,QAA2C;AACrD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;CAGhD,MAAM,OACJ,OACA,UACe;EACf,MAAM,EAAE,eAAe;AAGvB,SAAO,MAAM;GAAE;GAAY,cAAc,MAAM,SAAS,OAAO;GAAO,EAAE,sCAAsC;;CAGhH,cAAsB,cAA+B;AACnD,SAAO,gBAAgB,KAAK,OAAO"}
+{"version":3,"file":"compaction.js","names":[],"sources":["../../../../../src/agent/lifecycle/handlers/compaction.ts"],"sourcesContent":["import { createLogger } from '../../../utils/logger.js';\nimport type { AgentContext } from '../../service.types.js';\nimport type {\n  LifecycleHandler,\n  LifecycleEventData,\n  LLMResponsePayload,\n} from '../types.js';\n\nconst logger = createLogger('Agent:LifecycleCompaction');\n\nexport interface CompactionHandlerConfig {\n  minMessages: number;\n  maxTokens: number;\n  preserveReasoning: boolean;\n  accumulateUsage: boolean;\n}\n\nexport class CompactionLifecycleHandler\n  implements LifecycleHandler<LLMResponsePayload>\n{\n  readonly name = 'CompactionLifecycleHandler';\n\n  constructor(_config?: Partial<CompactionHandlerConfig>) {}\n\n  async handle(\n    event: LifecycleEventData<LLMResponsePayload>,\n    _context: AgentContext\n  ): Promise<void> {\n    const { sessionKey } = event;\n\n    // Compaction logic is handled by SessionStore, this handler just logs for now\n    logger.debug({ sessionKey, messageCount: event.payload?.usage?.total }, 'Compaction lifecycle event received');\n  }\n\n}\n"],"mappings":";;;aAAwD;AAQxD,MAAM,SAAS,aAAa,4BAA4B;AASxD,IAAa,6BAAb,MAEA;CACE,OAAgB;CAEhB,YAAY,SAA4C;CAExD,MAAM,OACJ,OACA,UACe;EACf,MAAM,EAAE,eAAe;AAGvB,SAAO,MAAM;GAAE;GAAY,cAAc,MAAM,SAAS,OAAO;GAAO,EAAE,sCAAsC"}

package/dist/src/agent/lifecycle/progress.d.ts

@@ -48,7 +48,6 @@ export declare class ProgressFeedbackManager {
     private currentStage;
     private currentTool;
     private taskStartTime;
-    private lastHeartbeatTime;
     private heartbeatTimer?;
     private streamActive;
     constructor(config?: Partial<ProgressFeedbackConfig>);

package/dist/src/agent/lifecycle/progress.js

@@ -86,7 +86,6 @@ var ProgressFeedbackManager = class {
 	currentStage = "idle";
 	currentTool = null;
 	taskStartTime = 0;
-	lastHeartbeatTime = 0;
 	heartbeatTimer;
 	streamActive = false;
 	constructor(config = {}) {
@@ -103,7 +102,6 @@ var ProgressFeedbackManager = class {
 	}
 	startTask() {
 		this.taskStartTime = Date.now();
-		this.lastHeartbeatTime = Date.now();
 		if (this.config.heartbeatEnabled) this.startHeartbeat();
 	}
 	endTask() {
@@ -117,10 +115,7 @@ var ProgressFeedbackManager = class {
 		this.stopHeartbeat();
 		this.heartbeatTimer = setInterval(() => {
 			const elapsed = Date.now() - this.taskStartTime;
-			if (elapsed >= this.config.longTaskThresholdMs) {
-				this.callbacks.onHeartbeat?.(elapsed, this.currentStage);
-				this.lastHeartbeatTime = Date.now();
-			}
+			if (elapsed >= this.config.longTaskThresholdMs) this.callbacks.onHeartbeat?.(elapsed, this.currentStage);
 		}, this.config.heartbeatIntervalMs);
 	}
 	stopHeartbeat() {

package/dist/src/agent/lifecycle/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","names":[],"sources":["../../../../src/agent/lifecycle/progress.ts"],"sourcesContent":["/**\n * Progress Feedback Manager\n * \n * Manages real-time progress feedback for long-running agent tasks.\n * Provides:\n * - Tool/end notifications execution start\n * - Thinking indicators\n * - Progress stage updates\n * - Stream integration for real-time display\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('ProgressFeedback');\n\n// Progress stages for different operations\nexport type ProgressStage = \n  | 'thinking'      // AI is thinking/reasoning\n  | 'searching'     // Web search\n  | 'reading'      // Reading files\n  | 'writing'       // Writing files  \n  | 'executing'     // Running shell commands\n  | 'analyzing'     // Analyzing data\n  | 'idle';         // No active operation\n\nexport interface ProgressUpdate {\n  stage: ProgressStage;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n  timestamp: number;\n}\n\nexport interface ProgressFeedbackConfig {\n  // Feedback level: minimal (errors only), normal (key events), verbose (all updates)\n  level: 'minimal' | 'normal' | 'verbose';\n  // Whether to show thinking indicators\n  showThinking: boolean;\n  // Whether to stream tool progress updates\n  streamToolProgress: boolean;\n  // Whether to send periodic heartbeats for long tasks\n  heartbeatEnabled: boolean;\n  // Heartbeat interval in ms\n  heartbeatIntervalMs: number;\n  // Threshold for long-running task in ms\n  longTaskThresholdMs: number;\n  // Enhanced feedback options\n  showErrorAccumulation: boolean;    // Show tool error accumulation (default: true)\n  showRequestLimitWarning: boolean;  // Show request limit warnings (default: true)\n}\n\nconst DEFAULT_CONFIG: ProgressFeedbackConfig = {\n  level: 'normal',\n  showThinking: true,\n  streamToolProgress: true,\n  heartbeatEnabled: true,\n  heartbeatIntervalMs: 20000, // 20 seconds\n  longTaskThresholdMs: 30000, // 30 seconds\n  showErrorAccumulation: true,\n  showRequestLimitWarning: true,\n};\n\n// Tool category mapping for better feedback\nconst TOOL_STAGE_MAP: Record<string, ProgressStage> = {\n  // Reading tools\n  'read': 'reading',\n  'read_file': 'reading',\n  'read_multiple': 'reading',\n  'glob': 'reading',\n  'find': 'reading',\n  'list_dir': 'reading',\n  'ls': 'reading',\n  'memory_get': 'reading',\n  'curated_memory': 'writing',\n\n  // Searching tools\n  'grep': 'searching',\n  'web_search': 'searching',\n  'search': 'searching',\n  'memory_search': 'searching',\n  'session_search': 'searching',\n  'find_files': 'searching',\n  \n  // Web fetching\n  'web_fetch': 'reading',\n  'fetch': 'reading',\n  'curl': 'reading',\n  'wget': 'reading',\n  \n  // Writing tools\n  'write': 'writing',\n  'write_file': 'writing',\n  'write_multiple': 'writing',\n  'edit': 'writing',\n  'patch': 'writing',\n  'create': 'writing',\n  'mkdir': 'writing',\n  'delete': 'writing',\n  'remove': 'writing',\n  \n  // Executing tools\n  'bash': 'executing',\n  'shell': 'executing',\n  'exec': 'executing',\n  'run': 'executing',\n  'command': 'executing',\n  'node': 'executing',\n  'python': 'executing',\n  'npm': 'executing',\n  'pnpm': 'executing',\n  'git': 'executing',\n  'docker': 'executing',\n  'kubectl': 'executing',\n  \n  // Message/communication\n  'message': 'idle',\n  'send': 'idle',\n  'reply': 'idle',\n  \n  // Analysis tools\n  'analyze': 'analyzing',\n  'compare': 'analyzing',\n  'diff': 'analyzing',\n  'summarize': 'analyzing',\n};\n\n// Emoji mapping for stages\nconst STAGE_EMOJI: Record<ProgressStage, string> = {\n  'thinking': '🤔',\n  'searching': '🔍',\n  'reading': '📖',\n  'writing': '✍️',\n  'executing': '⚙️',\n  'analyzing': '📊',\n  'idle': '💬',\n};\n\n// Stage labels in English\nconst STAGE_LABEL: Record<ProgressStage, string> = {\n  'thinking': 'Thinking',\n  'searching': 'Searching',\n  'reading': 'Reading',\n  'writing': 'Writing',\n  'executing': 'Executing',\n  'analyzing': 'Analyzing',\n  'idle': 'Ready',\n};\n\nexport interface ProgressMessage {\n  type: 'start' | 'update' | 'complete' | 'error' | 'warning' | 'thinking';\n  stage: ProgressStage;\n  message: string;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n}\n\nexport interface ProgressCallbacks {\n  onProgress?: (msg: ProgressMessage) => void;\n  onStreamStart?: (toolName: string, toolArgs: Record<string, unknown>) => void;\n  onStreamUpdate?: (toolName: string, partialResult: string) => void;\n  onStreamEnd?: (toolName: string, result: string, isError: boolean) => void;\n  onThinking?: (thinking: string) => void;\n  onHeartbeat?: (elapsedMs: number, currentStage: ProgressStage) => void;\n}\n\nexport class ProgressFeedbackManager {\n  private config: ProgressFeedbackConfig;\n  private callbacks: ProgressCallbacks = {};\n  private currentStage: ProgressStage = 'idle';\n  private currentTool: string | null = null;\n  private taskStartTime: number = 0;\n  private lastHeartbeatTime: number = 0;\n  private heartbeatTimer?: ReturnType<typeof setInterval>;\n  private streamActive: boolean = false;\n\n  constructor(config: Partial<ProgressFeedbackConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  setCallbacks(callbacks: ProgressCallbacks): void {\n    this.callbacks = { ...this.callbacks, ...callbacks };\n  }\n\n  startTask(): void {\n    this.taskStartTime = Date.now();\n    this.lastHeartbeatTime = Date.now();\n    \n    if (this.config.heartbeatEnabled) {\n      this.startHeartbeat();\n    }\n  }\n\n  endTask(): void {\n    this.stopHeartbeat();\n    this.currentStage = 'idle';\n    this.currentTool = null;\n    this.taskStartTime = 0;\n    this.streamActive = false;\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      const elapsed = Date.now() - this.taskStartTime;\n      if (elapsed >= this.config.longTaskThresholdMs) {\n        this.callbacks.onHeartbeat?.(elapsed, this.currentStage);\n        this.lastHeartbeatTime = Date.now();\n      }\n    }, this.config.heartbeatIntervalMs);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n\n  private mapToolToStage(toolName: string): ProgressStage {\n    const normalizedName = toolName.toLowerCase();\n    const normalizedNoUnderscore = normalizedName.replace(/_/g, '');\n    \n    // Try both versions: with and without underscores\n    const toCheck = [normalizedName, normalizedNoUnderscore];\n    \n    // Sort keys by length (longest first) to match more specific keys first\n    const sortedKeys = Object.keys(TOOL_STAGE_MAP).sort((a, b) => b.length - a.length);\n    \n    for (const name of toCheck) {\n      for (const key of sortedKeys) {\n        if (name.includes(key)) {\n          return TOOL_STAGE_MAP[key];\n        }\n      }\n    }\n    return 'executing';\n  }\n\n  private formatToolName(toolName: string): string {\n    // Convert snake_case to Title Case\n    return toolName\n      .replace(/_/g, ' ')\n      .replace(/\\b\\w/g, c => c.toUpperCase());\n  }\n\n  // Handle tool execution start\n  onToolStart(toolName: string, toolArgs: Record<string, unknown> = {}): void {\n    if (this.config.level === 'minimal') return;\n\n    this.currentTool = toolName;\n    this.currentStage = this.mapToolToStage(toolName);\n    this.streamActive = true;\n\n    const formattedName = this.formatToolName(toolName);\n    const emoji = STAGE_EMOJI[this.currentStage];\n    const label = STAGE_LABEL[this.currentStage];\n\n    // Build detail message\n    let detail = '';\n    if (toolArgs.path) {\n      detail = `📁 ${toolArgs.path}`;\n    } else if (toolArgs.query) {\n      detail = `🔎 ${toolArgs.query}`;\n    } else if (toolArgs.command) {\n      const cmd = String(toolArgs.command);\n      detail = `⚡ ${cmd.length > 50 ? cmd.slice(0, 50) + '...' : cmd}`;\n    }\n\n    const message: ProgressMessage = {\n      type: 'start',\n      stage: this.currentStage,\n      message: `${emoji} ${label}: ${formattedName}`,\n      detail: detail || undefined,\n      toolName,\n      toolArgs,\n    };\n\n    if (this.config.level === 'verbose' || this.config.streamToolProgress) {\n      this.callbacks.onProgress?.(message);\n    }\n    this.callbacks.onStreamStart?.(toolName, toolArgs);\n\n    log.debug({ toolName, stage: this.currentStage }, 'Tool execution started');\n  }\n\n  // Handle tool execution update (streaming)\n  onToolUpdate(toolName: string, partialResult: unknown): void {\n    if (this.config.level === 'minimal') return;\n    if (!this.streamActive || !this.config.streamToolProgress) return;\n\n    // Format partial result for display\n    let displayResult = '';\n    if (typeof partialResult === 'string') {\n      displayResult = partialResult.slice(0, 200); // Truncate for display\n    } else if (partialResult && typeof partialResult === 'object') {\n      const result = partialResult as Record<string, unknown>;\n      if (result.output) {\n        displayResult = String(result.output).slice(0, 200);\n      } else if (result.content) {\n        displayResult = String(result.content).slice(0, 200);\n      } else if (result.text) {\n        displayResult = String(result.text).slice(0, 200);\n      }\n    }\n\n    this.callbacks.onStreamUpdate?.(toolName, displayResult);\n  }\n\n  // Handle tool execution end\n  onToolEnd(toolName: string, result: unknown, isError: boolean = false): void {\n    if (this.config.level === 'minimal' && !isError) return;\n\n    const wasActive = this.streamActive;\n    this.streamActive = false;\n\n    // Extract result summary\n    let resultSummary = '';\n    if (result && typeof result === 'object') {\n      const res = result as Record<string, unknown>;\n      if (res.content && Array.isArray(res.content)) {\n        const textContent = res.content.find((c: unknown) => \n          typeof c === 'object' && c !== null && (c as Record<string, unknown>).type === 'text'\n        );\n        if (textContent) {\n          resultSummary = String((textContent as Record<string, unknown>).text || '').slice(0, 100);\n        }\n      }\n    }\n\n    const message: ProgressMessage = {\n      type: isError ? 'error' : 'complete',\n      stage: this.currentStage,\n      message: isError \n        ? `❌ Tool failed: ${this.formatToolName(toolName)}`\n        : `✅ Done: ${this.formatToolName(toolName)}`,\n      toolName,\n    };\n\n    if (wasActive) {\n      this.callbacks.onStreamEnd?.(toolName, resultSummary, isError);\n    }\n    \n    if (isError || this.config.level !== 'minimal') {\n      this.callbacks.onProgress?.(message);\n    }\n\n    // Reset current tool if it matches\n    if (this.currentTool === toolName) {\n      this.currentTool = null;\n      this.currentStage = 'idle';\n    }\n\n    log.debug({ toolName, isError }, 'Tool execution ended');\n  }\n\n  // Handle thinking/reasoning\n  onThinking(thinking: string): void {\n    if (!this.config.showThinking || this.config.level === 'minimal') return;\n\n    const displayThinking = thinking.length > 100 \n      ? thinking.slice(0, 100) + '...'\n      : thinking;\n\n    this.callbacks.onThinking?.(displayThinking);\n  }\n\n  // Handle turn start\n  onTurnStart(): void {\n    if (this.config.level === 'minimal') return;\n    \n    this.currentStage = 'thinking';\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled && !this.heartbeatTimer) {\n      this.startHeartbeat();\n    }\n  }\n\n  // Handle message/response start\n  onMessageStart(): void {\n    // Could be used to show \"AI is typing...\" indicator\n  }\n\n  // Handle message/response update (streaming tokens)\n  onMessageUpdate(_content: string): void {\n    // Could be used to show live response\n  }\n\n  // Handle agent end\n  onAgentEnd(): void {\n    this.endTask();\n  }\n\n  // Get current state\n  getCurrentState(): { stage: ProgressStage; tool: string | null; elapsedMs: number } {\n    return {\n      stage: this.currentStage,\n      tool: this.currentTool,\n      elapsedMs: this.taskStartTime ? Date.now() - this.taskStartTime : 0,\n    };\n  }\n\n  // Update config\n  setConfig(config: Partial<ProgressFeedbackConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  // Get stage emoji\n  getStageEmoji(stage: ProgressStage): string {\n    return STAGE_EMOJI[stage] || '💬';\n  }\n\n  // Get stage label\n  getStageLabel(stage: ProgressStage): string {\n    return STAGE_LABEL[stage] || 'Unknown';\n  }\n\n  /**\n   * Notify about accumulated tool errors\n   * Enhanced feedback for tool failures\n   */\n  onToolErrorAccumulated(\n    toolName: string,\n    failureCount: number,\n    maxFailures: number,\n    remainingAttempts?: number\n  ): void {\n    if (!this.config.showErrorAccumulation) return;\n    if (this.config.level === 'minimal') return;\n\n    const remaining = remainingAttempts ?? (maxFailures - failureCount);\n    const percentage = (failureCount / maxFailures) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = percentage >= 100 ? 'error' : 'warning';\n\n    if (percentage >= 100) {\n      message = `❌ ${this.formatToolName(toolName)} has reached maximum failures (${maxFailures}/${maxFailures})`;\n    } else if (percentage >= 50) {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount}/${maxFailures} times`;\n    } else {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount} time${failureCount > 1 ? 's' : ''}`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'executing',\n      message,\n      detail: remaining > 0 \n        ? `Remaining attempts: ${remaining}` \n        : 'Stopping tool execution',\n      toolName,\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const atCap = maxFailures > 0 && failureCount >= maxFailures;\n    const summary = atCap\n      ? `Tool \"${toolName}\" reached max failures (${failureCount}/${maxFailures})`\n      : `Tool \"${toolName}\" failures ${failureCount}/${maxFailures} (${remaining} attempt(s) left)`;\n    if (atCap) {\n      log.error({ toolName, failureCount, maxFailures, remaining }, summary);\n    } else {\n      log.warn({ toolName, failureCount, maxFailures, remaining }, summary);\n    }\n  }\n\n  /**\n   * Notify about request limit status\n   * Enhanced feedback for approaching/ reaching request limits\n   */\n  onRequestLimitStatus(\n    count: number,\n    limit: number,\n    remaining: number,\n    isWarning: boolean,\n    shouldStop: boolean\n  ): void {\n    if (!this.config.showRequestLimitWarning) return;\n    if (this.config.level === 'minimal') return;\n    if (!isWarning && !shouldStop) return;\n\n    const percentage = (count / limit) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = shouldStop ? 'error' : 'warning';\n\n    if (shouldStop) {\n      message = `❌ Request limit reached (${count}/${limit})`;\n    } else if (percentage >= 90) {\n      message = `⚠️ Request limit warning (${count}/${limit})`;\n    } else {\n      message = `⚠️ Approaching request limit (${count}/${limit})`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'thinking',\n      message,\n      detail: remaining > 0 \n        ? `Remaining requests: ${remaining}` \n        : 'Stopping execution',\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const summary = shouldStop\n      ? `LLM request limit reached (${count}/${limit}); stopping turn`\n      : `LLM request budget ${count}/${limit} (${remaining} left)`;\n    if (shouldStop) {\n      log.error({ count, limit, remaining, shouldStop }, summary);\n    } else {\n      log.warn({ count, limit, remaining, shouldStop }, summary);\n    }\n  }\n}\n\n// Singleton instance with default config\nexport const progressFeedbackManager = new ProgressFeedbackManager();\n\n// Utility function to format progress messages for Telegram\nexport function formatProgressMessage(msg: ProgressMessage, parseMode: 'Markdown' | 'HTML' = 'HTML'): string {\n  const emoji = STAGE_EMOJI[msg.stage];\n  \n  if (parseMode === 'HTML') {\n    let html = `<b>${emoji} ${msg.message}</b>`;\n    if (msg.detail) {\n      html += `\\n${msg.detail}`;\n    }\n    return html;\n  } else {\n    let md = `**${emoji} ${msg.message}**`;\n    if (msg.detail) {\n      md += `\\n${msg.detail}`;\n    }\n    return md;\n  }\n}\n\n// Utility function to format heartbeat message\nexport function formatHeartbeatMessage(elapsedMs: number, stage: ProgressStage, detail?: string): string {\n  const seconds = Math.floor(elapsedMs / 1000);\n  const emoji = STAGE_EMOJI[stage];\n  const label = STAGE_LABEL[stage];\n  \n  let message = `${emoji} Still ${label.toLowerCase()}...`;\n  if (detail) {\n    message += `\\n${detail}`;\n  }\n  message += `\\n⏱️ ${seconds}s elapsed`;\n  \n  return message;\n}\n"],"mappings":"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"}
+{"version":3,"file":"progress.js","names":[],"sources":["../../../../src/agent/lifecycle/progress.ts"],"sourcesContent":["/**\n * Progress Feedback Manager\n * \n * Manages real-time progress feedback for long-running agent tasks.\n * Provides:\n * - Tool/end notifications execution start\n * - Thinking indicators\n * - Progress stage updates\n * - Stream integration for real-time display\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('ProgressFeedback');\n\n// Progress stages for different operations\nexport type ProgressStage = \n  | 'thinking'      // AI is thinking/reasoning\n  | 'searching'     // Web search\n  | 'reading'      // Reading files\n  | 'writing'       // Writing files  \n  | 'executing'     // Running shell commands\n  | 'analyzing'     // Analyzing data\n  | 'idle';         // No active operation\n\nexport interface ProgressUpdate {\n  stage: ProgressStage;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n  timestamp: number;\n}\n\nexport interface ProgressFeedbackConfig {\n  // Feedback level: minimal (errors only), normal (key events), verbose (all updates)\n  level: 'minimal' | 'normal' | 'verbose';\n  // Whether to show thinking indicators\n  showThinking: boolean;\n  // Whether to stream tool progress updates\n  streamToolProgress: boolean;\n  // Whether to send periodic heartbeats for long tasks\n  heartbeatEnabled: boolean;\n  // Heartbeat interval in ms\n  heartbeatIntervalMs: number;\n  // Threshold for long-running task in ms\n  longTaskThresholdMs: number;\n  // Enhanced feedback options\n  showErrorAccumulation: boolean;    // Show tool error accumulation (default: true)\n  showRequestLimitWarning: boolean;  // Show request limit warnings (default: true)\n}\n\nconst DEFAULT_CONFIG: ProgressFeedbackConfig = {\n  level: 'normal',\n  showThinking: true,\n  streamToolProgress: true,\n  heartbeatEnabled: true,\n  heartbeatIntervalMs: 20000, // 20 seconds\n  longTaskThresholdMs: 30000, // 30 seconds\n  showErrorAccumulation: true,\n  showRequestLimitWarning: true,\n};\n\n// Tool category mapping for better feedback\nconst TOOL_STAGE_MAP: Record<string, ProgressStage> = {\n  // Reading tools\n  'read': 'reading',\n  'read_file': 'reading',\n  'read_multiple': 'reading',\n  'glob': 'reading',\n  'find': 'reading',\n  'list_dir': 'reading',\n  'ls': 'reading',\n  'memory_get': 'reading',\n  'curated_memory': 'writing',\n\n  // Searching tools\n  'grep': 'searching',\n  'web_search': 'searching',\n  'search': 'searching',\n  'memory_search': 'searching',\n  'session_search': 'searching',\n  'find_files': 'searching',\n  \n  // Web fetching\n  'web_fetch': 'reading',\n  'fetch': 'reading',\n  'curl': 'reading',\n  'wget': 'reading',\n  \n  // Writing tools\n  'write': 'writing',\n  'write_file': 'writing',\n  'write_multiple': 'writing',\n  'edit': 'writing',\n  'patch': 'writing',\n  'create': 'writing',\n  'mkdir': 'writing',\n  'delete': 'writing',\n  'remove': 'writing',\n  \n  // Executing tools\n  'bash': 'executing',\n  'shell': 'executing',\n  'exec': 'executing',\n  'run': 'executing',\n  'command': 'executing',\n  'node': 'executing',\n  'python': 'executing',\n  'npm': 'executing',\n  'pnpm': 'executing',\n  'git': 'executing',\n  'docker': 'executing',\n  'kubectl': 'executing',\n  \n  // Message/communication\n  'message': 'idle',\n  'send': 'idle',\n  'reply': 'idle',\n  \n  // Analysis tools\n  'analyze': 'analyzing',\n  'compare': 'analyzing',\n  'diff': 'analyzing',\n  'summarize': 'analyzing',\n};\n\n// Emoji mapping for stages\nconst STAGE_EMOJI: Record<ProgressStage, string> = {\n  'thinking': '🤔',\n  'searching': '🔍',\n  'reading': '📖',\n  'writing': '✍️',\n  'executing': '⚙️',\n  'analyzing': '📊',\n  'idle': '💬',\n};\n\n// Stage labels in English\nconst STAGE_LABEL: Record<ProgressStage, string> = {\n  'thinking': 'Thinking',\n  'searching': 'Searching',\n  'reading': 'Reading',\n  'writing': 'Writing',\n  'executing': 'Executing',\n  'analyzing': 'Analyzing',\n  'idle': 'Ready',\n};\n\nexport interface ProgressMessage {\n  type: 'start' | 'update' | 'complete' | 'error' | 'warning' | 'thinking';\n  stage: ProgressStage;\n  message: string;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n}\n\nexport interface ProgressCallbacks {\n  onProgress?: (msg: ProgressMessage) => void;\n  onStreamStart?: (toolName: string, toolArgs: Record<string, unknown>) => void;\n  onStreamUpdate?: (toolName: string, partialResult: string) => void;\n  onStreamEnd?: (toolName: string, result: string, isError: boolean) => void;\n  onThinking?: (thinking: string) => void;\n  onHeartbeat?: (elapsedMs: number, currentStage: ProgressStage) => void;\n}\n\nexport class ProgressFeedbackManager {\n  private config: ProgressFeedbackConfig;\n  private callbacks: ProgressCallbacks = {};\n  private currentStage: ProgressStage = 'idle';\n  private currentTool: string | null = null;\n  private taskStartTime: number = 0;\n  private heartbeatTimer?: ReturnType<typeof setInterval>;\n  private streamActive: boolean = false;\n\n  constructor(config: Partial<ProgressFeedbackConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  setCallbacks(callbacks: ProgressCallbacks): void {\n    this.callbacks = { ...this.callbacks, ...callbacks };\n  }\n\n  startTask(): void {\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled) {\n      this.startHeartbeat();\n    }\n  }\n\n  endTask(): void {\n    this.stopHeartbeat();\n    this.currentStage = 'idle';\n    this.currentTool = null;\n    this.taskStartTime = 0;\n    this.streamActive = false;\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      const elapsed = Date.now() - this.taskStartTime;\n      if (elapsed >= this.config.longTaskThresholdMs) {\n        this.callbacks.onHeartbeat?.(elapsed, this.currentStage);\n      }\n    }, this.config.heartbeatIntervalMs);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n\n  private mapToolToStage(toolName: string): ProgressStage {\n    const normalizedName = toolName.toLowerCase();\n    const normalizedNoUnderscore = normalizedName.replace(/_/g, '');\n    \n    // Try both versions: with and without underscores\n    const toCheck = [normalizedName, normalizedNoUnderscore];\n    \n    // Sort keys by length (longest first) to match more specific keys first\n    const sortedKeys = Object.keys(TOOL_STAGE_MAP).sort((a, b) => b.length - a.length);\n    \n    for (const name of toCheck) {\n      for (const key of sortedKeys) {\n        if (name.includes(key)) {\n          return TOOL_STAGE_MAP[key];\n        }\n      }\n    }\n    return 'executing';\n  }\n\n  private formatToolName(toolName: string): string {\n    // Convert snake_case to Title Case\n    return toolName\n      .replace(/_/g, ' ')\n      .replace(/\\b\\w/g, c => c.toUpperCase());\n  }\n\n  // Handle tool execution start\n  onToolStart(toolName: string, toolArgs: Record<string, unknown> = {}): void {\n    if (this.config.level === 'minimal') return;\n\n    this.currentTool = toolName;\n    this.currentStage = this.mapToolToStage(toolName);\n    this.streamActive = true;\n\n    const formattedName = this.formatToolName(toolName);\n    const emoji = STAGE_EMOJI[this.currentStage];\n    const label = STAGE_LABEL[this.currentStage];\n\n    // Build detail message\n    let detail = '';\n    if (toolArgs.path) {\n      detail = `📁 ${toolArgs.path}`;\n    } else if (toolArgs.query) {\n      detail = `🔎 ${toolArgs.query}`;\n    } else if (toolArgs.command) {\n      const cmd = String(toolArgs.command);\n      detail = `⚡ ${cmd.length > 50 ? cmd.slice(0, 50) + '...' : cmd}`;\n    }\n\n    const message: ProgressMessage = {\n      type: 'start',\n      stage: this.currentStage,\n      message: `${emoji} ${label}: ${formattedName}`,\n      detail: detail || undefined,\n      toolName,\n      toolArgs,\n    };\n\n    if (this.config.level === 'verbose' || this.config.streamToolProgress) {\n      this.callbacks.onProgress?.(message);\n    }\n    this.callbacks.onStreamStart?.(toolName, toolArgs);\n\n    log.debug({ toolName, stage: this.currentStage }, 'Tool execution started');\n  }\n\n  // Handle tool execution update (streaming)\n  onToolUpdate(toolName: string, partialResult: unknown): void {\n    if (this.config.level === 'minimal') return;\n    if (!this.streamActive || !this.config.streamToolProgress) return;\n\n    // Format partial result for display\n    let displayResult = '';\n    if (typeof partialResult === 'string') {\n      displayResult = partialResult.slice(0, 200); // Truncate for display\n    } else if (partialResult && typeof partialResult === 'object') {\n      const result = partialResult as Record<string, unknown>;\n      if (result.output) {\n        displayResult = String(result.output).slice(0, 200);\n      } else if (result.content) {\n        displayResult = String(result.content).slice(0, 200);\n      } else if (result.text) {\n        displayResult = String(result.text).slice(0, 200);\n      }\n    }\n\n    this.callbacks.onStreamUpdate?.(toolName, displayResult);\n  }\n\n  // Handle tool execution end\n  onToolEnd(toolName: string, result: unknown, isError: boolean = false): void {\n    if (this.config.level === 'minimal' && !isError) return;\n\n    const wasActive = this.streamActive;\n    this.streamActive = false;\n\n    // Extract result summary\n    let resultSummary = '';\n    if (result && typeof result === 'object') {\n      const res = result as Record<string, unknown>;\n      if (res.content && Array.isArray(res.content)) {\n        const textContent = res.content.find((c: unknown) => \n          typeof c === 'object' && c !== null && (c as Record<string, unknown>).type === 'text'\n        );\n        if (textContent) {\n          resultSummary = String((textContent as Record<string, unknown>).text || '').slice(0, 100);\n        }\n      }\n    }\n\n    const message: ProgressMessage = {\n      type: isError ? 'error' : 'complete',\n      stage: this.currentStage,\n      message: isError \n        ? `❌ Tool failed: ${this.formatToolName(toolName)}`\n        : `✅ Done: ${this.formatToolName(toolName)}`,\n      toolName,\n    };\n\n    if (wasActive) {\n      this.callbacks.onStreamEnd?.(toolName, resultSummary, isError);\n    }\n    \n    if (isError || this.config.level !== 'minimal') {\n      this.callbacks.onProgress?.(message);\n    }\n\n    // Reset current tool if it matches\n    if (this.currentTool === toolName) {\n      this.currentTool = null;\n      this.currentStage = 'idle';\n    }\n\n    log.debug({ toolName, isError }, 'Tool execution ended');\n  }\n\n  // Handle thinking/reasoning\n  onThinking(thinking: string): void {\n    if (!this.config.showThinking || this.config.level === 'minimal') return;\n\n    const displayThinking = thinking.length > 100 \n      ? thinking.slice(0, 100) + '...'\n      : thinking;\n\n    this.callbacks.onThinking?.(displayThinking);\n  }\n\n  // Handle turn start\n  onTurnStart(): void {\n    if (this.config.level === 'minimal') return;\n    \n    this.currentStage = 'thinking';\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled && !this.heartbeatTimer) {\n      this.startHeartbeat();\n    }\n  }\n\n  // Handle message/response start\n  onMessageStart(): void {\n    // Could be used to show \"AI is typing...\" indicator\n  }\n\n  // Handle message/response update (streaming tokens)\n  onMessageUpdate(_content: string): void {\n    // Could be used to show live response\n  }\n\n  // Handle agent end\n  onAgentEnd(): void {\n    this.endTask();\n  }\n\n  // Get current state\n  getCurrentState(): { stage: ProgressStage; tool: string | null; elapsedMs: number } {\n    return {\n      stage: this.currentStage,\n      tool: this.currentTool,\n      elapsedMs: this.taskStartTime ? Date.now() - this.taskStartTime : 0,\n    };\n  }\n\n  // Update config\n  setConfig(config: Partial<ProgressFeedbackConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  // Get stage emoji\n  getStageEmoji(stage: ProgressStage): string {\n    return STAGE_EMOJI[stage] || '💬';\n  }\n\n  // Get stage label\n  getStageLabel(stage: ProgressStage): string {\n    return STAGE_LABEL[stage] || 'Unknown';\n  }\n\n  /**\n   * Notify about accumulated tool errors\n   * Enhanced feedback for tool failures\n   */\n  onToolErrorAccumulated(\n    toolName: string,\n    failureCount: number,\n    maxFailures: number,\n    remainingAttempts?: number\n  ): void {\n    if (!this.config.showErrorAccumulation) return;\n    if (this.config.level === 'minimal') return;\n\n    const remaining = remainingAttempts ?? (maxFailures - failureCount);\n    const percentage = (failureCount / maxFailures) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = percentage >= 100 ? 'error' : 'warning';\n\n    if (percentage >= 100) {\n      message = `❌ ${this.formatToolName(toolName)} has reached maximum failures (${maxFailures}/${maxFailures})`;\n    } else if (percentage >= 50) {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount}/${maxFailures} times`;\n    } else {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount} time${failureCount > 1 ? 's' : ''}`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'executing',\n      message,\n      detail: remaining > 0 \n        ? `Remaining attempts: ${remaining}` \n        : 'Stopping tool execution',\n      toolName,\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const atCap = maxFailures > 0 && failureCount >= maxFailures;\n    const summary = atCap\n      ? `Tool \"${toolName}\" reached max failures (${failureCount}/${maxFailures})`\n      : `Tool \"${toolName}\" failures ${failureCount}/${maxFailures} (${remaining} attempt(s) left)`;\n    if (atCap) {\n      log.error({ toolName, failureCount, maxFailures, remaining }, summary);\n    } else {\n      log.warn({ toolName, failureCount, maxFailures, remaining }, summary);\n    }\n  }\n\n  /**\n   * Notify about request limit status\n   * Enhanced feedback for approaching/ reaching request limits\n   */\n  onRequestLimitStatus(\n    count: number,\n    limit: number,\n    remaining: number,\n    isWarning: boolean,\n    shouldStop: boolean\n  ): void {\n    if (!this.config.showRequestLimitWarning) return;\n    if (this.config.level === 'minimal') return;\n    if (!isWarning && !shouldStop) return;\n\n    const percentage = (count / limit) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = shouldStop ? 'error' : 'warning';\n\n    if (shouldStop) {\n      message = `❌ Request limit reached (${count}/${limit})`;\n    } else if (percentage >= 90) {\n      message = `⚠️ Request limit warning (${count}/${limit})`;\n    } else {\n      message = `⚠️ Approaching request limit (${count}/${limit})`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'thinking',\n      message,\n      detail: remaining > 0 \n        ? `Remaining requests: ${remaining}` \n        : 'Stopping execution',\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const summary = shouldStop\n      ? `LLM request limit reached (${count}/${limit}); stopping turn`\n      : `LLM request budget ${count}/${limit} (${remaining} left)`;\n    if (shouldStop) {\n      log.error({ count, limit, remaining, shouldStop }, summary);\n    } else {\n      log.warn({ count, limit, remaining, shouldStop }, summary);\n    }\n  }\n}\n\n// Singleton instance with default config\nexport const progressFeedbackManager = new ProgressFeedbackManager();\n\n// Utility function to format progress messages for Telegram\nexport function formatProgressMessage(msg: ProgressMessage, parseMode: 'Markdown' | 'HTML' = 'HTML'): string {\n  const emoji = STAGE_EMOJI[msg.stage];\n  \n  if (parseMode === 'HTML') {\n    let html = `<b>${emoji} ${msg.message}</b>`;\n    if (msg.detail) {\n      html += `\\n${msg.detail}`;\n    }\n    return html;\n  } else {\n    let md = `**${emoji} ${msg.message}**`;\n    if (msg.detail) {\n      md += `\\n${msg.detail}`;\n    }\n    return md;\n  }\n}\n\n// Utility function to format heartbeat message\nexport function formatHeartbeatMessage(elapsedMs: number, stage: ProgressStage, detail?: string): string {\n  const seconds = Math.floor(elapsedMs / 1000);\n  const emoji = STAGE_EMOJI[stage];\n  const label = STAGE_LABEL[stage];\n  \n  let message = `${emoji} Still ${label.toLowerCase()}...`;\n  if (detail) {\n    message += `\\n${detail}`;\n  }\n  message += `\\n⏱️ ${seconds}s elapsed`;\n  \n  return message;\n}\n"],"mappings":"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"}

package/dist/src/agent/lifecycle/timeout-wrapper.d.ts

@@ -67,9 +67,8 @@ export declare function withTimeout<T extends (...args: any[]) => Promise<any>>(
  * Timeout manager for tracking execution statistics
  */
 export declare class TimeoutManager {
-    private config;
     private executions;
-    constructor(config?: Partial<TimeoutConfig>);
+    constructor(_config?: Partial<TimeoutConfig>);
     /**
      * Execute with timeout and track statistics
      */

package/dist/src/agent/lifecycle/timeout-wrapper.js

@@ -157,14 +157,8 @@ function withTimeout(fn, config) {
 * Timeout manager for tracking execution statistics
 */
 var TimeoutManager = class {
-	config;
 	executions = [];
-	constructor(config = {}) {
-		this.config = {
-			...DEFAULT_CONFIG,
-			...config
-		};
-	}
+	constructor(_config = {}) {}
 	/**
 	* Execute with timeout and track statistics
 	*/

package/dist/src/agent/lifecycle/timeout-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeout-wrapper.js","names":[],"sources":["../../../../src/agent/lifecycle/timeout-wrapper.ts"],"sourcesContent":["/**\n * Timeout Wrapper - Protects tool execution from hanging\n *\n * Wraps tool execution with timeout protection to prevent:\n * - Infinite loops in shell commands\n * - Network requests hanging forever\n * - Resource exhaustion\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TimeoutWrapper');\n\nexport interface TimeoutConfig {\n  defaultTimeoutMs: number;      // Default timeout in ms (default: 300000 = 5 min)\n  shellTimeoutMs: number;        // Shell command timeout (default: 300000 = 5 min)\n  readTimeoutMs: number;         // File read timeout (default: 30000 = 30 sec)\n  writeTimeoutMs: number;        // File write timeout (default: 60000 = 1 min)\n  networkTimeoutMs: number;      // Network request timeout (default: 60000 = 1 min)\n  gracefulShutdownMs: number;    // Time to wait for graceful shutdown (default: 5000)\n}\n\nconst DEFAULT_CONFIG: TimeoutConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000,      // 5 minutes\n  shellTimeoutMs: 5 * 60 * 1000,        // 5 minutes\n  readTimeoutMs: 30 * 1000,             // 30 seconds\n  writeTimeoutMs: 60 * 1000,            // 1 minute\n  networkTimeoutMs: 60 * 1000,          // 1 minute\n  gracefulShutdownMs: 5000,             // 5 seconds\n};\n\nexport interface TimeoutResult<T> {\n  success: boolean;\n  result?: T;\n  error?: Error;\n  timedOut: boolean;\n  executionTimeMs: number;\n}\n\nexport interface ToolTimeoutConfig {\n  toolName: string;\n  timeoutMs?: number;\n  description?: string;\n}\n\n/**\n * Get timeout for specific tool type\n */\nfunction getTimeoutForTool(toolName: string, config: TimeoutConfig): number {\n  const toolLower = toolName.toLowerCase();\n\n  if (toolLower.includes('shell') || toolLower.includes('exec')) {\n    return config.shellTimeoutMs;\n  }\n  if (toolLower.includes('read') || toolLower.includes('view')) {\n    return config.readTimeoutMs;\n  }\n  if (toolLower.includes('write') || toolLower.includes('edit')) {\n    return config.writeTimeoutMs;\n  }\n  if (toolLower.includes('web') || toolLower.includes('http') || toolLower.includes('fetch')) {\n    return config.networkTimeoutMs;\n  }\n\n  return config.defaultTimeoutMs;\n}\n\n/**\n * Execute function with timeout protection\n *\n * @example\n * ```typescript\n * const result = await executeWithTimeout(\n *   () => shell.exec('long-running-command'),\n *   { toolName: 'shell', timeoutMs: 60000 }\n * );\n * ```\n */\nexport async function executeWithTimeout<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<T> {\n  const fullConfig = { ...DEFAULT_CONFIG };\n  const timeoutMs = config.timeoutMs || getTimeoutForTool(config.toolName, fullConfig);\n\n  const startTime = Date.now();\n  let timeoutId: NodeJS.Timeout | null = null;\n  let isSettled = false;\n\n  return new Promise((resolve, reject) => {\n    // Set up timeout\n    timeoutId = setTimeout(() => {\n      if (isSettled) return;\n      isSettled = true;\n      \n      const executionTime = Date.now() - startTime;\n      const desc = config.description ? ` (${config.description})` : '';\n      log.error(\n        {\n          toolName: config.toolName,\n          timeoutMs,\n          executionTimeMs: executionTime,\n          description: config.description,\n        },\n        `Tool \"${config.toolName}\" timed out after ${timeoutMs}ms (elapsed ${executionTime}ms)${desc}`,\n      );\n\n      reject(\n        new TimeoutError(\n          config.toolName,\n          timeoutMs,\n          config.description,\n          executionTime\n        )\n      );\n    }, timeoutMs);\n\n    // Execute operation\n    operation()\n      .then(result => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        const executionTime = Date.now() - startTime;\n\n        log.debug(\n          {\n            toolName: config.toolName,\n            executionTimeMs: executionTime,\n          },\n          'Tool execution completed within timeout'\n        );\n\n        resolve(result);\n      })\n      .catch(error => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        reject(error);\n      });\n  });\n}\n\n/**\n * Execute with timeout and return detailed result\n */\nexport async function executeWithTimeoutResult<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<TimeoutResult<T>> {\n  const startTime = Date.now();\n\n  try {\n    const result = await executeWithTimeout(operation, config);\n    return {\n      success: true,\n      result,\n      timedOut: false,\n      executionTimeMs: Date.now() - startTime,\n    };\n  } catch (error) {\n    const isTimeout = error instanceof TimeoutError;\n    return {\n      success: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n      timedOut: isTimeout,\n      executionTimeMs: Date.now() - startTime,\n    };\n  }\n}\n\n/**\n * Custom timeout error\n */\nexport class TimeoutError extends Error {\n  public readonly toolName: string;\n  public readonly timeoutMs: number;\n  public readonly executionTimeMs: number;\n  public readonly description?: string;\n\n  constructor(\n    toolName: string,\n    timeoutMs: number,\n    description?: string,\n    executionTimeMs: number = timeoutMs\n  ) {\n    const timeoutSec = Math.round(timeoutMs / 1000);\n    const message = description\n      ? `Tool '${toolName}' timed out after ${timeoutSec}s: ${description}`\n      : `Tool '${toolName}' timed out after ${timeoutSec}s. Consider breaking the operation into smaller steps.`;\n\n    super(message);\n    this.name = 'TimeoutError';\n    this.toolName = toolName;\n    this.timeoutMs = timeoutMs;\n    this.description = description;\n    this.executionTimeMs = executionTimeMs;\n\n    // Maintain proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TimeoutError);\n    }\n  }\n\n  /**\n   * Get user-friendly error message with suggestions\n   */\n  getUserMessage(): string {\n    const suggestions: string[] = [];\n\n    if (this.toolName.toLowerCase().includes('shell')) {\n      suggestions.push('Break the command into smaller steps');\n      suggestions.push('Add timeouts to individual commands');\n      suggestions.push('Check for infinite loops or waiting for input');\n    } else if (this.toolName.toLowerCase().includes('read')) {\n      suggestions.push('Read the file in smaller chunks');\n      suggestions.push('Use grep to find specific content first');\n    } else if (this.toolName.toLowerCase().includes('write')) {\n      suggestions.push('Write content in smaller batches');\n    } else if (this.toolName.toLowerCase().includes('web')) {\n      suggestions.push('Check network connectivity');\n      suggestions.push('Try again later');\n    }\n\n    let message = `⚠️ ${this.message}`;\n    if (suggestions.length > 0) {\n      message += '\\n\\nSuggestions:\\n' + suggestions.map(s => `• ${s}`).join('\\n');\n    }\n\n    return message;\n  }\n}\n\n/**\n * Wrap a function with timeout protection\n */\nexport function withTimeout<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  config: Omit<ToolTimeoutConfig, 'description'> & { description?: string | ((...args: Parameters<T>) => string) }\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async (...args: Parameters<T>): Promise<ReturnType<T>> => {\n    const description = typeof config.description === 'function'\n      ? config.description(...args)\n      : config.description;\n\n    return executeWithTimeout(() => fn(...args), {\n      toolName: config.toolName,\n      timeoutMs: config.timeoutMs,\n      description,\n    });\n  };\n}\n\n/**\n * Timeout manager for tracking execution statistics\n */\nexport class TimeoutManager {\n  private config: TimeoutConfig;\n  private executions: Array<{\n    toolName: string;\n    executionTimeMs: number;\n    timedOut: boolean;\n    timestamp: number;\n  }> = [];\n\n  constructor(config: Partial<TimeoutConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Execute with timeout and track statistics\n   */\n  async execute<T>(\n    operation: () => Promise<T>,\n    toolConfig: ToolTimeoutConfig\n  ): Promise<T> {\n    const startTime = Date.now();\n    let timedOut = false;\n\n    try {\n      const result = await executeWithTimeout(operation, toolConfig);\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut: false,\n        timestamp: Date.now(),\n      });\n      return result;\n    } catch (error) {\n      if (error instanceof TimeoutError) {\n        timedOut = true;\n      }\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut,\n        timestamp: Date.now(),\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get execution statistics\n   */\n  getStats(): {\n    totalExecutions: number;\n    timeoutCount: number;\n    timeoutRate: number;\n    averageExecutionTimeMs: number;\n    byTool: Record<string, {\n      count: number;\n      timeouts: number;\n      avgExecutionTimeMs: number;\n    }>;\n  } {\n    const byTool: Record<string, { count: number; timeouts: number; totalTime: number }> = {};\n\n    for (const exec of this.executions) {\n      if (!byTool[exec.toolName]) {\n        byTool[exec.toolName] = { count: 0, timeouts: 0, totalTime: 0 };\n      }\n      byTool[exec.toolName].count++;\n      if (exec.timedOut) {\n        byTool[exec.toolName].timeouts++;\n      }\n      byTool[exec.toolName].totalTime += exec.executionTimeMs;\n    }\n\n    const totalExecutions = this.executions.length;\n    const timeoutCount = this.executions.filter(e => e.timedOut).length;\n    const totalTime = this.executions.reduce((sum, e) => sum + e.executionTimeMs, 0);\n\n    return {\n      totalExecutions,\n      timeoutCount,\n      timeoutRate: totalExecutions > 0 ? timeoutCount / totalExecutions : 0,\n      averageExecutionTimeMs: totalExecutions > 0 ? totalTime / totalExecutions : 0,\n      byTool: Object.fromEntries(\n        Object.entries(byTool).map(([name, stats]) => [\n          name,\n          {\n            count: stats.count,\n            timeouts: stats.timeouts,\n            avgExecutionTimeMs: stats.count > 0 ? stats.totalTime / stats.count : 0,\n          },\n        ])\n      ),\n    };\n  }\n\n  /**\n   * Clean up old execution records\n   */\n  cleanup(maxAgeMs: number = 24 * 60 * 60 * 1000): void {\n    const cutoff = Date.now() - maxAgeMs;\n    this.executions = this.executions.filter(e => e.timestamp > cutoff);\n  }\n}\n\n// Convenience exports\nexport { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG };\n"],"mappings":"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"}
+{"version":3,"file":"timeout-wrapper.js","names":[],"sources":["../../../../src/agent/lifecycle/timeout-wrapper.ts"],"sourcesContent":["/**\n * Timeout Wrapper - Protects tool execution from hanging\n *\n * Wraps tool execution with timeout protection to prevent:\n * - Infinite loops in shell commands\n * - Network requests hanging forever\n * - Resource exhaustion\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TimeoutWrapper');\n\nexport interface TimeoutConfig {\n  defaultTimeoutMs: number;      // Default timeout in ms (default: 300000 = 5 min)\n  shellTimeoutMs: number;        // Shell command timeout (default: 300000 = 5 min)\n  readTimeoutMs: number;         // File read timeout (default: 30000 = 30 sec)\n  writeTimeoutMs: number;        // File write timeout (default: 60000 = 1 min)\n  networkTimeoutMs: number;      // Network request timeout (default: 60000 = 1 min)\n  gracefulShutdownMs: number;    // Time to wait for graceful shutdown (default: 5000)\n}\n\nconst DEFAULT_CONFIG: TimeoutConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000,      // 5 minutes\n  shellTimeoutMs: 5 * 60 * 1000,        // 5 minutes\n  readTimeoutMs: 30 * 1000,             // 30 seconds\n  writeTimeoutMs: 60 * 1000,            // 1 minute\n  networkTimeoutMs: 60 * 1000,          // 1 minute\n  gracefulShutdownMs: 5000,             // 5 seconds\n};\n\nexport interface TimeoutResult<T> {\n  success: boolean;\n  result?: T;\n  error?: Error;\n  timedOut: boolean;\n  executionTimeMs: number;\n}\n\nexport interface ToolTimeoutConfig {\n  toolName: string;\n  timeoutMs?: number;\n  description?: string;\n}\n\n/**\n * Get timeout for specific tool type\n */\nfunction getTimeoutForTool(toolName: string, config: TimeoutConfig): number {\n  const toolLower = toolName.toLowerCase();\n\n  if (toolLower.includes('shell') || toolLower.includes('exec')) {\n    return config.shellTimeoutMs;\n  }\n  if (toolLower.includes('read') || toolLower.includes('view')) {\n    return config.readTimeoutMs;\n  }\n  if (toolLower.includes('write') || toolLower.includes('edit')) {\n    return config.writeTimeoutMs;\n  }\n  if (toolLower.includes('web') || toolLower.includes('http') || toolLower.includes('fetch')) {\n    return config.networkTimeoutMs;\n  }\n\n  return config.defaultTimeoutMs;\n}\n\n/**\n * Execute function with timeout protection\n *\n * @example\n * ```typescript\n * const result = await executeWithTimeout(\n *   () => shell.exec('long-running-command'),\n *   { toolName: 'shell', timeoutMs: 60000 }\n * );\n * ```\n */\nexport async function executeWithTimeout<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<T> {\n  const fullConfig = { ...DEFAULT_CONFIG };\n  const timeoutMs = config.timeoutMs || getTimeoutForTool(config.toolName, fullConfig);\n\n  const startTime = Date.now();\n  let timeoutId: NodeJS.Timeout | null = null;\n  let isSettled = false;\n\n  return new Promise((resolve, reject) => {\n    // Set up timeout\n    timeoutId = setTimeout(() => {\n      if (isSettled) return;\n      isSettled = true;\n      \n      const executionTime = Date.now() - startTime;\n      const desc = config.description ? ` (${config.description})` : '';\n      log.error(\n        {\n          toolName: config.toolName,\n          timeoutMs,\n          executionTimeMs: executionTime,\n          description: config.description,\n        },\n        `Tool \"${config.toolName}\" timed out after ${timeoutMs}ms (elapsed ${executionTime}ms)${desc}`,\n      );\n\n      reject(\n        new TimeoutError(\n          config.toolName,\n          timeoutMs,\n          config.description,\n          executionTime\n        )\n      );\n    }, timeoutMs);\n\n    // Execute operation\n    operation()\n      .then(result => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        const executionTime = Date.now() - startTime;\n\n        log.debug(\n          {\n            toolName: config.toolName,\n            executionTimeMs: executionTime,\n          },\n          'Tool execution completed within timeout'\n        );\n\n        resolve(result);\n      })\n      .catch(error => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        reject(error);\n      });\n  });\n}\n\n/**\n * Execute with timeout and return detailed result\n */\nexport async function executeWithTimeoutResult<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<TimeoutResult<T>> {\n  const startTime = Date.now();\n\n  try {\n    const result = await executeWithTimeout(operation, config);\n    return {\n      success: true,\n      result,\n      timedOut: false,\n      executionTimeMs: Date.now() - startTime,\n    };\n  } catch (error) {\n    const isTimeout = error instanceof TimeoutError;\n    return {\n      success: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n      timedOut: isTimeout,\n      executionTimeMs: Date.now() - startTime,\n    };\n  }\n}\n\n/**\n * Custom timeout error\n */\nexport class TimeoutError extends Error {\n  public readonly toolName: string;\n  public readonly timeoutMs: number;\n  public readonly executionTimeMs: number;\n  public readonly description?: string;\n\n  constructor(\n    toolName: string,\n    timeoutMs: number,\n    description?: string,\n    executionTimeMs: number = timeoutMs\n  ) {\n    const timeoutSec = Math.round(timeoutMs / 1000);\n    const message = description\n      ? `Tool '${toolName}' timed out after ${timeoutSec}s: ${description}`\n      : `Tool '${toolName}' timed out after ${timeoutSec}s. Consider breaking the operation into smaller steps.`;\n\n    super(message);\n    this.name = 'TimeoutError';\n    this.toolName = toolName;\n    this.timeoutMs = timeoutMs;\n    this.description = description;\n    this.executionTimeMs = executionTimeMs;\n\n    // Maintain proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TimeoutError);\n    }\n  }\n\n  /**\n   * Get user-friendly error message with suggestions\n   */\n  getUserMessage(): string {\n    const suggestions: string[] = [];\n\n    if (this.toolName.toLowerCase().includes('shell')) {\n      suggestions.push('Break the command into smaller steps');\n      suggestions.push('Add timeouts to individual commands');\n      suggestions.push('Check for infinite loops or waiting for input');\n    } else if (this.toolName.toLowerCase().includes('read')) {\n      suggestions.push('Read the file in smaller chunks');\n      suggestions.push('Use grep to find specific content first');\n    } else if (this.toolName.toLowerCase().includes('write')) {\n      suggestions.push('Write content in smaller batches');\n    } else if (this.toolName.toLowerCase().includes('web')) {\n      suggestions.push('Check network connectivity');\n      suggestions.push('Try again later');\n    }\n\n    let message = `⚠️ ${this.message}`;\n    if (suggestions.length > 0) {\n      message += '\\n\\nSuggestions:\\n' + suggestions.map(s => `• ${s}`).join('\\n');\n    }\n\n    return message;\n  }\n}\n\n/**\n * Wrap a function with timeout protection\n */\nexport function withTimeout<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  config: Omit<ToolTimeoutConfig, 'description'> & { description?: string | ((...args: Parameters<T>) => string) }\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async (...args: Parameters<T>): Promise<ReturnType<T>> => {\n    const description = typeof config.description === 'function'\n      ? config.description(...args)\n      : config.description;\n\n    return executeWithTimeout(() => fn(...args), {\n      toolName: config.toolName,\n      timeoutMs: config.timeoutMs,\n      description,\n    });\n  };\n}\n\n/**\n * Timeout manager for tracking execution statistics\n */\nexport class TimeoutManager {\n  private executions: Array<{\n    toolName: string;\n    executionTimeMs: number;\n    timedOut: boolean;\n    timestamp: number;\n  }> = [];\n\n  constructor(_config: Partial<TimeoutConfig> = {}) {}\n\n  /**\n   * Execute with timeout and track statistics\n   */\n  async execute<T>(\n    operation: () => Promise<T>,\n    toolConfig: ToolTimeoutConfig\n  ): Promise<T> {\n    const startTime = Date.now();\n    let timedOut = false;\n\n    try {\n      const result = await executeWithTimeout(operation, toolConfig);\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut: false,\n        timestamp: Date.now(),\n      });\n      return result;\n    } catch (error) {\n      if (error instanceof TimeoutError) {\n        timedOut = true;\n      }\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut,\n        timestamp: Date.now(),\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get execution statistics\n   */\n  getStats(): {\n    totalExecutions: number;\n    timeoutCount: number;\n    timeoutRate: number;\n    averageExecutionTimeMs: number;\n    byTool: Record<string, {\n      count: number;\n      timeouts: number;\n      avgExecutionTimeMs: number;\n    }>;\n  } {\n    const byTool: Record<string, { count: number; timeouts: number; totalTime: number }> = {};\n\n    for (const exec of this.executions) {\n      if (!byTool[exec.toolName]) {\n        byTool[exec.toolName] = { count: 0, timeouts: 0, totalTime: 0 };\n      }\n      byTool[exec.toolName].count++;\n      if (exec.timedOut) {\n        byTool[exec.toolName].timeouts++;\n      }\n      byTool[exec.toolName].totalTime += exec.executionTimeMs;\n    }\n\n    const totalExecutions = this.executions.length;\n    const timeoutCount = this.executions.filter(e => e.timedOut).length;\n    const totalTime = this.executions.reduce((sum, e) => sum + e.executionTimeMs, 0);\n\n    return {\n      totalExecutions,\n      timeoutCount,\n      timeoutRate: totalExecutions > 0 ? timeoutCount / totalExecutions : 0,\n      averageExecutionTimeMs: totalExecutions > 0 ? totalTime / totalExecutions : 0,\n      byTool: Object.fromEntries(\n        Object.entries(byTool).map(([name, stats]) => [\n          name,\n          {\n            count: stats.count,\n            timeouts: stats.timeouts,\n            avgExecutionTimeMs: stats.count > 0 ? stats.totalTime / stats.count : 0,\n          },\n        ])\n      ),\n    };\n  }\n\n  /**\n   * Clean up old execution records\n   */\n  cleanup(maxAgeMs: number = 24 * 60 * 60 * 1000): void {\n    const cutoff = Date.now() - maxAgeMs;\n    this.executions = this.executions.filter(e => e.timestamp > cutoff);\n  }\n}\n\n// Convenience exports\nexport { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG };\n"],"mappings":"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"}

package/dist/src/agent/memory/builtin-memory-store.d.ts

@@ -1,5 +1,5 @@
 /**
- * Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.
+ * Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.
  * Snapshot for system prompt is captured at load time and not mutated until next load.
  */
 import type { MemorySnapshot, MemoryStoreConfig } from './types.js';
@@ -10,10 +10,12 @@ export declare class BuiltinMemoryStore {
     private userEntries;
     private snapshot;
     constructor(config: MemoryStoreConfig);
-    /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */
+    /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */
     isUserProfileEnabled(): boolean;
     /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */
     get memoriesDir(): string;
+    /** Global user memory file (`~/.xopc/user/MEMORY.md`). */
+    get userMemoryPath(): string;
     /** Workspace whose MEMORY.md and daily notes participate in local memory search. */
     get workspaceDir(): string;
     pathFor(target: 'memory' | 'user'): string;

package/dist/src/agent/memory/builtin-memory-store.js

@@ -1,10 +1,10 @@
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import lockfile from "proper-lockfile";
 //#region src/agent/memory/builtin-memory-store.ts
 /**
-* Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.
+* Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.
 * Snapshot for system prompt is captured at load time and not mutated until next load.
 */
 const MEMORY_ENTRY_DELIMITER = "\n§\n";
@@ -20,7 +20,7 @@ var BuiltinMemoryStore = class {
 	constructor(config) {
 		this.config = config;
 	}
-	/** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */
+	/** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */
 	isUserProfileEnabled() {
 		return this.config.userProfileEnabled !== false;
 	}
@@ -28,12 +28,16 @@ var BuiltinMemoryStore = class {
 	get memoriesDir() {
 		return this.config.memoriesDir;
 	}
+	/** Global user memory file (`~/.xopc/user/MEMORY.md`). */
+	get userMemoryPath() {
+		return this.config.userMemoryPath;
+	}
 	/** Workspace whose MEMORY.md and daily notes participate in local memory search. */
 	get workspaceDir() {
 		return this.config.workspaceDir;
 	}
 	pathFor(target) {
-		return join(this.memoriesDir, target === "memory" ? "MEMORY.md" : "USER.md");
+		return target === "memory" ? join(this.memoriesDir, "MEMORY.md") : this.userMemoryPath;
 	}
 	/**
 	* Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).
@@ -41,7 +45,7 @@ var BuiltinMemoryStore = class {
 	loadFromDiskSync() {
 		mkdirSync(this.memoriesDir, { recursive: true });
 		this.memoryEntries = this.parseFileContent(this.readPathSync(join(this.memoriesDir, "MEMORY.md")));
-		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(join(this.memoriesDir, "USER.md")));
+		this.userEntries = this.config.userProfileEnabled === false ? [] : this.parseFileContent(this.readPathSync(this.userMemoryPath));
 		this.memoryEntries = dedupePreserveOrder(this.memoryEntries);
 		this.userEntries = dedupePreserveOrder(this.userEntries);
 		this.snapshot = {
@@ -185,7 +189,7 @@ var BuiltinMemoryStore = class {
 	}
 	async withFileLock(target, fn) {
 		const filePath = this.pathFor(target);
-		await mkdir(this.memoriesDir, { recursive: true });
+		await mkdir(dirname(filePath), { recursive: true });
 		if (!existsSync(filePath)) await writeFile(filePath, "", "utf-8");
 		await lockfile.lock(filePath, {
 			retries: 3,
@@ -214,6 +218,7 @@ var BuiltinMemoryStore = class {
 		const filePath = this.pathFor(target);
 		const content = entries.join(MEMORY_ENTRY_DELIMITER);
 		const tmpPath = `${filePath}.tmp.${Date.now()}`;
+		await mkdir(dirname(filePath), { recursive: true });
 		await writeFile(tmpPath, content, "utf-8");
 		await rename(tmpPath, filePath);
 	}

package/dist/src/agent/memory/builtin-memory-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory: agent home `memories/MEMORY.md` + `USER.md`, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, USER.md is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */\n  get memoriesDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  /** Workspace whose MEMORY.md and daily notes participate in local memory search. */\n  get workspaceDir(): string {\n    return this.config.workspaceDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return join(this.memoriesDir, target === 'memory' ? 'MEMORY.md' : 'USER.md');\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memoriesDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memoriesDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(join(this.memoriesDir, 'USER.md')));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(this.memoriesDir, { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"builtin-memory-store.js","names":[],"sources":["../../../../src/agent/memory/builtin-memory-store.ts"],"sourcesContent":["/**\n * Bounded curated memory: agent home `memories/MEMORY.md` + global `user/MEMORY.md`, §-delimited entries.\n * Snapshot for system prompt is captured at load time and not mutated until next load.\n */\n\nimport { existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { mkdir, readFile, rename, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport lockfile from 'proper-lockfile';\n\nimport type { MemorySnapshot, MemoryStoreConfig } from './types.js';\n\nexport const MEMORY_ENTRY_DELIMITER = '\\n§\\n';\n\nconst DEFAULT_MEMORY_LIMIT = 2200;\nconst DEFAULT_USER_LIMIT = 1375;\n\nexport class BuiltinMemoryStore {\n  private memoryEntries: string[] = [];\n  private userEntries: string[] = [];\n  private snapshot: MemorySnapshot = { memory: '', user: '' };\n\n  constructor(private readonly config: MemoryStoreConfig) {}\n\n  /** When false, global user memory is omitted from the snapshot and should not be edited via `curated_memory`. */\n  isUserProfileEnabled(): boolean {\n    return this.config.userProfileEnabled !== false;\n  }\n\n  /** Agent-scoped curated memory directory (`~/.xopc/agents/<id>/memories/`). */\n  get memoriesDir(): string {\n    return this.config.memoriesDir;\n  }\n\n  /** Global user memory file (`~/.xopc/user/MEMORY.md`). */\n  get userMemoryPath(): string {\n    return this.config.userMemoryPath;\n  }\n\n  /** Workspace whose MEMORY.md and daily notes participate in local memory search. */\n  get workspaceDir(): string {\n    return this.config.workspaceDir;\n  }\n\n  pathFor(target: 'memory' | 'user'): string {\n    return target === 'memory' ? join(this.memoriesDir, 'MEMORY.md') : this.userMemoryPath;\n  }\n\n  /**\n   * Load from disk and freeze {@link getSnapshot}. Sync for agent creation (prefix cache stability).\n   */\n  loadFromDiskSync(): void {\n    mkdirSync(this.memoriesDir, { recursive: true });\n    this.memoryEntries = this.parseFileContent(\n      this.readPathSync(join(this.memoriesDir, 'MEMORY.md')),\n    );\n    this.userEntries =\n      this.config.userProfileEnabled === false\n        ? []\n        : this.parseFileContent(this.readPathSync(this.userMemoryPath));\n    this.memoryEntries = dedupePreserveOrder(this.memoryEntries);\n    this.userEntries = dedupePreserveOrder(this.userEntries);\n    this.snapshot = {\n      memory: this.renderBlock('memory', this.memoryEntries),\n      user: this.renderBlock('user', this.userEntries),\n    };\n  }\n\n  private readPathSync(path: string): string {\n    try {\n      if (!existsSync(path)) return '';\n      return readFileSync(path, { encoding: 'utf-8' });\n    } catch {\n      return '';\n    }\n  }\n\n  private parseFileContent(raw: string): string[] {\n    if (!raw.trim()) return [];\n    return raw\n      .split(MEMORY_ENTRY_DELIMITER)\n      .map((e) => e.trim())\n      .filter(Boolean);\n  }\n\n  getSnapshot(): MemorySnapshot {\n    return this.snapshot;\n  }\n\n  /**\n   * Live entries for read/debug (may differ from snapshot after mutations).\n   */\n  getLiveEntries(target: 'memory' | 'user'): string[] {\n    return target === 'memory' ? [...this.memoryEntries] : [...this.userEntries];\n  }\n\n  async add(\n    target: 'memory' | 'user',\n    content: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const trimmed = content.trim();\n    if (!trimmed) {\n      return { success: false, error: 'Content cannot be empty.' };\n    }\n    const scanError = scanForThreats(trimmed);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const limit = this.charLimit(target);\n\n      if (entries.includes(trimmed)) {\n        return { success: false, error: 'Entry already exists' };\n      }\n\n      const newTotal = calculateTotal([...entries, trimmed]);\n      if (newTotal > limit) {\n        return {\n          success: false,\n          error: `Memory at ${calculateTotal(entries)}/${limit} chars. Adding would exceed limit.`,\n        };\n      }\n\n      entries.push(trimmed);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry added.' };\n    });\n  }\n\n  async replace(\n    target: 'memory' | 'user',\n    oldText: string,\n    newContent: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    const nc = newContent.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n    if (!nc) {\n      return { success: false, error: 'new_content cannot be empty. Use remove to delete entries.' };\n    }\n    const scanError = scanForThreats(nc);\n    if (scanError) {\n      return { success: false, error: scanError };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: Array<{ index: number; entry: string }> = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push({ index: i, entry: entries[i] });\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((m) => m.entry));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((m) =>\n            m.entry.length > 80 ? `${m.entry.slice(0, 80)}...` : m.entry,\n          );\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      const idx = matches[0].index;\n      const limit = this.charLimit(target);\n      const testEntries = [...entries];\n      testEntries[idx] = nc;\n\n      if (calculateTotal(testEntries) > limit) {\n        return {\n          success: false,\n          error: `Replacement would put memory at ${calculateTotal(testEntries)}/${limit} chars.`,\n        };\n      }\n\n      entries[idx] = nc;\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry replaced.' };\n    });\n  }\n\n  async remove(\n    target: 'memory' | 'user',\n    oldText: string,\n  ): Promise<{ success: boolean; error?: string; message?: string }> {\n    const ot = oldText.trim();\n    if (!ot) {\n      return { success: false, error: 'old_text cannot be empty.' };\n    }\n\n    return this.withFileLock(target, async () => {\n      await this.reloadTargetFromDisk(target);\n      const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n      const matches: number[] = [];\n      for (let i = 0; i < entries.length; i++) {\n        if (entries[i].includes(ot)) {\n          matches.push(i);\n        }\n      }\n\n      if (matches.length === 0) {\n        return { success: false, error: `No entry matched '${ot}'.` };\n      }\n\n      if (matches.length > 1) {\n        const uniqueTexts = new Set(matches.map((i) => entries[i]));\n        if (uniqueTexts.size > 1) {\n          const previews = matches.map((i) => {\n            const e = entries[i];\n            return e.length > 80 ? `${e.slice(0, 80)}...` : e;\n          });\n          return {\n            success: false,\n            error: `Multiple entries matched '${ot}'. Be more specific. Previews: ${previews.join(' | ')}`,\n          };\n        }\n      }\n\n      entries.splice(matches[0], 1);\n      await this.flushTargetToDisk(target);\n      return { success: true, message: 'Entry removed.' };\n    });\n  }\n\n  private async withFileLock<T>(\n    target: 'memory' | 'user',\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const filePath = this.pathFor(target);\n    await mkdir(dirname(filePath), { recursive: true });\n    if (!existsSync(filePath)) {\n      await writeFile(filePath, '', 'utf-8');\n    }\n    await lockfile.lock(filePath, { retries: 3, stale: 10_000 });\n    try {\n      return await fn();\n    } finally {\n      await lockfile.unlock(filePath);\n    }\n  }\n\n  private async reloadTargetFromDisk(target: 'memory' | 'user'): Promise<void> {\n    const path = this.pathFor(target);\n    let raw = '';\n    try {\n      raw = await readFile(path, 'utf-8');\n    } catch {\n      raw = '';\n    }\n    const parsed = dedupePreserveOrder(this.parseFileContent(raw));\n    if (target === 'memory') {\n      this.memoryEntries = parsed;\n    } else {\n      this.userEntries = parsed;\n    }\n  }\n\n  private async flushTargetToDisk(target: 'memory' | 'user'): Promise<void> {\n    const entries = target === 'memory' ? this.memoryEntries : this.userEntries;\n    const filePath = this.pathFor(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const tmpPath = `${filePath}.tmp.${Date.now()}`;\n    await mkdir(dirname(filePath), { recursive: true });\n    await writeFile(tmpPath, content, 'utf-8');\n    await rename(tmpPath, filePath);\n  }\n\n  private charLimit(target: 'memory' | 'user'): number {\n    return target === 'memory'\n      ? (this.config.memoryCharLimit ?? DEFAULT_MEMORY_LIMIT)\n      : (this.config.userCharLimit ?? DEFAULT_USER_LIMIT);\n  }\n\n  private renderBlock(target: 'memory' | 'user', entries: string[]): string {\n    if (entries.length === 0) {\n      return '';\n    }\n\n    const limit = this.charLimit(target);\n    const content = entries.join(MEMORY_ENTRY_DELIMITER);\n    const current = content.length;\n    const pct = Math.min(100, Math.round((current / limit) * 100));\n\n    const header =\n      target === 'user'\n        ? `USER PROFILE (who the user is) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`\n        : `MEMORY (your personal notes) [${pct}% — ${current.toLocaleString()}/${limit.toLocaleString()} chars]`;\n\n    const separator = '═'.repeat(46);\n    return `${separator}\\n${header}\\n${separator}\\n${content}`;\n  }\n}\n\nfunction dedupePreserveOrder(entries: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const e of entries) {\n    if (seen.has(e)) {\n      continue;\n    }\n    seen.add(e);\n    out.push(e);\n  }\n  return out;\n}\n\nfunction calculateTotal(entries: string[]): number {\n  if (entries.length === 0) {\n    return 0;\n  }\n  return entries.join(MEMORY_ENTRY_DELIMITER).length;\n}\n\nexport function scanForThreats(content: string): string | null {\n  const patterns: Array<{ regex: RegExp; id: string }> = [\n    { regex: /ignore\\s+(previous|all|above|prior)\\s+instructions/i, id: 'prompt_injection' },\n    { regex: /you\\s+are\\s+now\\s+/i, id: 'role_hijack' },\n    { regex: /do\\s+not\\s+tell\\s+the\\s+user/i, id: 'deception_hide' },\n    { regex: /system\\s+prompt\\s+override/i, id: 'sys_prompt_override' },\n    {\n      regex: /disregard\\s+(your|all|any)\\s+(instructions|rules|guidelines)/i,\n      id: 'disregard_rules',\n    },\n    {\n      regex: /act\\s+as\\s+(if|though)\\s+you\\s+(have\\s+no|don't\\s+have)\\s+(restrictions|limits|rules)/i,\n      id: 'bypass_restrictions',\n    },\n    { regex: /curl\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_curl' },\n    { regex: /wget\\s+[^\\n]*\\$\\{?\\w*(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|API)/i, id: 'exfil_wget' },\n    {\n      regex: /cat\\s+[^\\n]*(\\.env|credentials|\\.netrc|\\.pgpass|\\.npmrc|\\.pypirc)/i,\n      id: 'read_secrets',\n    },\n    { regex: /authorized_keys/i, id: 'ssh_backdoor' },\n    { regex: /\\$HOME\\/\\.ssh|\\~\\/\\.ssh/i, id: 'ssh_access' },\n  ];\n\n  for (const { regex, id } of patterns) {\n    if (regex.test(content)) {\n      return `Blocked: content matches threat pattern '${id}'. Memory entries are injected into the system prompt and must not contain injection payloads.`;\n    }\n  }\n\n  const invisibleChars = [\n    '\\u200b',\n    '\\u200c',\n    '\\u200d',\n    '\\u2060',\n    '\\ufeff',\n    '\\u202a',\n    '\\u202b',\n    '\\u202c',\n    '\\u202d',\n    '\\u202e',\n  ];\n  for (const char of invisibleChars) {\n    if (content.includes(char)) {\n      const code = char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0');\n      return `Blocked: content contains invisible unicode character U+${code} (possible injection).`;\n    }\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/dist/src/agent/memory/builtin-provider.js

@@ -61,6 +61,7 @@ var BuiltinMemoryProvider = class {
 			maxResults: request.maxResults,
 			minScore: request.minScore,
 			memoriesDir: this.store.memoriesDir,
+			userMemoryPath: this.store.userMemoryPath,
 			agentId
 		})).map((entry) => {
 			const start = entry.lineNumbers[0] ?? 1;
@@ -100,7 +101,7 @@ var BuiltinMemoryProvider = class {
 			const existing = getMemoryRecord(request.id);
 			if (existing) return { record: existing };
 		}
-		const result = memoryGet(this.workspaceDir, request.path ?? request.id ?? "", request.from, request.lines, this.store.memoriesDir);
+		const result = memoryGet(this.workspaceDir, request.path ?? request.id ?? "", request.from, request.lines, this.store.memoriesDir, this.store.userMemoryPath);
 		if (!result) return null;
 		const path = request.path ?? request.id ?? "";
 		return {
@@ -148,12 +149,36 @@ var BuiltinMemoryProvider = class {
 			content,
 			source: {
 				provider: this.id,
-				path: target === "user" ? "USER.md" : "MEMORY.md"
+				path: sourcePathForTarget(target)
 			}
 		}));
 	}
 	async write(request) {
 		const target = request.target ?? (request.kind === "user_profile" ? "user" : "memory");
+		if (request.status === "candidate") return {
+			success: true,
+			message: "Memory candidate added to inbox",
+			record: upsertMemoryRecord({
+				providerId: this.id,
+				kind: target === "user" ? "user_profile" : request.kind,
+				agentId: request.scope?.agentId ?? this.agentId,
+				workspaceId: request.scope?.workspaceId ?? this.workspaceDir,
+				sessionKey: request.scope?.sessionKey,
+				content: request.content,
+				source: {
+					...request.source ?? {},
+					provider: this.id,
+					path: sourcePathForTarget(target)
+				},
+				confidence: request.confidence,
+				tags: request.tags,
+				status: "candidate",
+				sensitivity: request.sensitivity,
+				evidence: request.evidence,
+				reviewAfter: request.reviewAfter,
+				expiresAt: request.expiresAt
+			})
+		};
 		const result = await this.store.add(target, request.content);
 		if (!result.success) return {
 			success: false,
@@ -173,7 +198,7 @@ var BuiltinMemoryProvider = class {
 				source: {
 					...request.source ?? {},
 					provider: this.id,
-					path: target === "user" ? "USER.md" : "MEMORY.md"
+					path: sourcePathForTarget(target)
 				},
 				tags: request.tags
 			})
@@ -198,7 +223,7 @@ var BuiltinMemoryProvider = class {
 				content: request.content,
 				source: existing?.source ?? {
 					provider: this.id,
-					path: target === "user" ? "USER.md" : "MEMORY.md"
+					path: sourcePathForTarget(target)
 				},
 				tags: existing?.tags
 			});
@@ -262,14 +287,18 @@ var BuiltinMemoryProvider = class {
 	async shutdown() {}
 };
 function inferKindFromPath(path) {
-	if (path.endsWith("USER.md")) return "user_profile";
-	if (path.endsWith("MEMORY.md")) return "agent_note";
-	if (/^memory\/\d{4}-\d{2}-\d{2}\.md$/.test(path)) return "daily_note";
+	const normalized = path.replace(/\\/g, "/");
+	if (normalized === "user/MEMORY.md" || normalized.endsWith("/user/MEMORY.md")) return "user_profile";
+	if (/^memory\/\d{4}-\d{2}-\d{2}\.md$/.test(normalized)) return "daily_note";
+	if (normalized.endsWith("MEMORY.md")) return "agent_note";
 	return "workspace_fact";
 }
 function targetForKind(kind) {
 	return kind === "user_profile" ? "user" : "memory";
 }
+function sourcePathForTarget(target) {
+	return target === "user" ? "user/MEMORY.md" : "MEMORY.md";
+}
 function parseLineAddress(id) {
 	const match = /^(.*)#L(\d+)(?:-L(\d+))?$/.exec(id);
 	if (!match) return { path: id };