@xopcai/xopc 0.0.118 → 0.0.119

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":";;;aAWqD;AAErD,MAAM,MAAM,aAAa,mBAAmB;AAsC5C,MAAM,iBAAyC;CAC7C,OAAO;CACP,cAAc;CACd,oBAAoB;CACpB,kBAAkB;CAClB,qBAAqB;CACrB,qBAAqB;CACrB,uBAAuB;CACvB,yBAAyB;CAC1B;AAGD,MAAM,iBAAgD;CAEpD,QAAQ;CACR,aAAa;CACb,iBAAiB;CACjB,QAAQ;CACR,QAAQ;CACR,YAAY;CACZ,MAAM;CACN,cAAc;CACd,kBAAkB;CAGlB,QAAQ;CACR,cAAc;CACd,UAAU;CACV,iBAAiB;CACjB,kBAAkB;CAClB,cAAc;CAGd,aAAa;CACb,SAAS;CACT,QAAQ;CACR,QAAQ;CAGR,SAAS;CACT,cAAc;CACd,kBAAkB;CAClB,QAAQ;CACR,SAAS;CACT,UAAU;CACV,SAAS;CACT,UAAU;CACV,UAAU;CAGV,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,OAAO;CACP,WAAW;CACX,QAAQ;CACR,UAAU;CACV,OAAO;CACP,QAAQ;CACR,OAAO;CACP,UAAU;CACV,WAAW;CAGX,WAAW;CACX,QAAQ;CACR,SAAS;CAGT,WAAW;CACX,WAAW;CACX,QAAQ;CACR,aAAa;CACd;AAGD,MAAM,cAA6C;CACjD,YAAY;CACZ,aAAa;CACb,WAAW;CACX,WAAW;CACX,aAAa;CACb,aAAa;CACb,QAAQ;CACT;AAGD,MAAM,cAA6C;CACjD,YAAY;CACZ,aAAa;CACb,WAAW;CACX,WAAW;CACX,aAAa;CACb,aAAa;CACb,QAAQ;CACT;AAoBD,IAAa,0BAAb,MAAqC;CACnC;CACA,YAAuC,EAAE;CACzC,eAAsC;CACtC,cAAqC;CACrC,gBAAgC;CAChC;CACA,eAAgC;CAEhC,YAAY,SAA0C,EAAE,EAAE;AACxD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;CAGhD,aAAa,WAAoC;AAC/C,OAAK,YAAY;GAAE,GAAG,KAAK;GAAW,GAAG;GAAW;;CAGtD,YAAkB;AAChB,OAAK,gBAAgB,KAAK,KAAK;AAE/B,MAAI,KAAK,OAAO,iBACd,MAAK,gBAAgB;;CAIzB,UAAgB;AACd,OAAK,eAAe;AACpB,OAAK,eAAe;AACpB,OAAK,cAAc;AACnB,OAAK,gBAAgB;AACrB,OAAK,eAAe;;CAGtB,iBAA+B;AAC7B,OAAK,eAAe;AACpB,OAAK,iBAAiB,kBAAkB;GACtC,MAAM,UAAU,KAAK,KAAK,GAAG,KAAK;AAClC,OAAI,WAAW,KAAK,OAAO,oBACzB,MAAK,UAAU,cAAc,SAAS,KAAK,aAAa;KAEzD,KAAK,OAAO,oBAAoB;;CAGrC,gBAA8B;AAC5B,MAAI,KAAK,gBAAgB;AACvB,iBAAc,KAAK,eAAe;AAClC,QAAK,iBAAiB,KAAA;;;CAI1B,eAAuB,UAAiC;EACtD,MAAM,iBAAiB,SAAS,aAAa;EAI7C,MAAM,UAAU,CAAC,gBAHc,eAAe,QAAQ,MAAM,GAGL,CAAC;EAGxD,MAAM,aAAa,OAAO,KAAK,eAAe,CAAC,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,OAAO;AAElF,OAAK,MAAM,QAAQ,QACjB,MAAK,MAAM,OAAO,WAChB,KAAI,KAAK,SAAS,IAAI,CACpB,QAAO,eAAe;AAI5B,SAAO;;CAGT,eAAuB,UAA0B;AAE/C,SAAO,SACJ,QAAQ,MAAM,IAAI,CAClB,QAAQ,UAAS,MAAK,EAAE,aAAa,CAAC;;CAI3C,YAAY,UAAkB,WAAoC,EAAE,EAAQ;AAC1E,MAAI,KAAK,OAAO,UAAU,UAAW;AAErC,OAAK,cAAc;AACnB,OAAK,eAAe,KAAK,eAAe,SAAS;AACjD,OAAK,eAAe;EAEpB,MAAM,gBAAgB,KAAK,eAAe,SAAS;EACnD,MAAM,QAAQ,YAAY,KAAK;EAC/B,MAAM,QAAQ,YAAY,KAAK;EAG/B,IAAI,SAAS;AACb,MAAI,SAAS,KACX,UAAS,MAAM,SAAS;WACf,SAAS,MAClB,UAAS,MAAM,SAAS;WACf,SAAS,SAAS;GAC3B,MAAM,MAAM,OAAO,SAAS,QAAQ;AACpC,YAAS,KAAK,IAAI,SAAS,KAAK,IAAI,MAAM,GAAG,GAAG,GAAG,QAAQ;;EAG7D,MAAM,UAA2B;GAC/B,MAAM;GACN,OAAO,KAAK;GACZ,SAAS,GAAG,MAAM,GAAG,MAAM,IAAI;GAC/B,QAAQ,UAAU,KAAA;GAClB;GACA;GACD;AAED,MAAI,KAAK,OAAO,UAAU,aAAa,KAAK,OAAO,mBACjD,MAAK,UAAU,aAAa,QAAQ;AAEtC,OAAK,UAAU,gBAAgB,UAAU,SAAS;AAElD,MAAI,MAAM;GAAE;GAAU,OAAO,KAAK;GAAc,EAAE,yBAAyB;;CAI7E,aAAa,UAAkB,eAA8B;AAC3D,MAAI,KAAK,OAAO,UAAU,UAAW;AACrC,MAAI,CAAC,KAAK,gBAAgB,CAAC,KAAK,OAAO,mBAAoB;EAG3D,IAAI,gBAAgB;AACpB,MAAI,OAAO,kBAAkB,SAC3B,iBAAgB,cAAc,MAAM,GAAG,IAAI;WAClC,iBAAiB,OAAO,kBAAkB,UAAU;GAC7D,MAAM,SAAS;AACf,OAAI,OAAO,OACT,iBAAgB,OAAO,OAAO,OAAO,CAAC,MAAM,GAAG,IAAI;YAC1C,OAAO,QAChB,iBAAgB,OAAO,OAAO,QAAQ,CAAC,MAAM,GAAG,IAAI;YAC3C,OAAO,KAChB,iBAAgB,OAAO,OAAO,KAAK,CAAC,MAAM,GAAG,IAAI;;AAIrD,OAAK,UAAU,iBAAiB,UAAU,cAAc;;CAI1D,UAAU,UAAkB,QAAiB,UAAmB,OAAa;AAC3E,MAAI,KAAK,OAAO,UAAU,aAAa,CAAC,QAAS;EAEjD,MAAM,YAAY,KAAK;AACvB,OAAK,eAAe;EAGpB,IAAI,gBAAgB;AACpB,MAAI,UAAU,OAAO,WAAW,UAAU;GACxC,MAAM,MAAM;AACZ,OAAI,IAAI,WAAW,MAAM,QAAQ,IAAI,QAAQ,EAAE;IAC7C,MAAM,cAAc,IAAI,QAAQ,MAAM,MACpC,OAAO,MAAM,YAAY,MAAM,QAAS,EAA8B,SAAS,OAChF;AACD,QAAI,YACF,iBAAgB,OAAQ,YAAwC,QAAQ,GAAG,CAAC,MAAM,GAAG,IAAI;;;EAK/F,MAAM,UAA2B;GAC/B,MAAM,UAAU,UAAU;GAC1B,OAAO,KAAK;GACZ,SAAS,UACL,kBAAkB,KAAK,eAAe,SAAS,KAC/C,WAAW,KAAK,eAAe,SAAS;GAC5C;GACD;AAED,MAAI,UACF,MAAK,UAAU,cAAc,UAAU,eAAe,QAAQ;AAGhE,MAAI,WAAW,KAAK,OAAO,UAAU,UACnC,MAAK,UAAU,aAAa,QAAQ;AAItC,MAAI,KAAK,gBAAgB,UAAU;AACjC,QAAK,cAAc;AACnB,QAAK,eAAe;;AAGtB,MAAI,MAAM;GAAE;GAAU;GAAS,EAAE,uBAAuB;;CAI1D,WAAW,UAAwB;AACjC,MAAI,CAAC,KAAK,OAAO,gBAAgB,KAAK,OAAO,UAAU,UAAW;EAElE,MAAM,kBAAkB,SAAS,SAAS,MACtC,SAAS,MAAM,GAAG,IAAI,GAAG,QACzB;AAEJ,OAAK,UAAU,aAAa,gBAAgB;;CAI9C,cAAoB;AAClB,MAAI,KAAK,OAAO,UAAU,UAAW;AAErC,OAAK,eAAe;AACpB,OAAK,gBAAgB,KAAK,KAAK;AAE/B,MAAI,KAAK,OAAO,oBAAoB,CAAC,KAAK,eACxC,MAAK,gBAAgB;;CAKzB,iBAAuB;CAKvB,gBAAgB,UAAwB;CAKxC,aAAmB;AACjB,OAAK,SAAS;;CAIhB,kBAAoF;AAClF,SAAO;GACL,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,WAAW,KAAK,gBAAgB,KAAK,KAAK,GAAG,KAAK,gBAAgB;GACnE;;CAIH,UAAU,QAA+C;AACvD,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;CAI7C,cAAc,OAA8B;AAC1C,SAAO,YAAY,UAAU;;CAI/B,cAAc,OAA8B;AAC1C,SAAO,YAAY,UAAU;;;;;;CAO/B,uBACE,UACA,cACA,aACA,mBACM;AACN,MAAI,CAAC,KAAK,OAAO,sBAAuB;AACxC,MAAI,KAAK,OAAO,UAAU,UAAW;EAErC,MAAM,YAAY,qBAAsB,cAAc;EACtD,MAAM,aAAc,eAAe,cAAe;EAElD,IAAI;EACJ,IAAI,OAA4B,cAAc,MAAM,UAAU;AAE9D,MAAI,cAAc,IAChB,WAAU,KAAK,KAAK,eAAe,SAAS,CAAC,iCAAiC,YAAY,GAAG,YAAY;WAChG,cAAc,GACvB,WAAU,MAAM,KAAK,eAAe,SAAS,CAAC,UAAU,aAAa,GAAG,YAAY;MAEpF,WAAU,MAAM,KAAK,eAAe,SAAS,CAAC,UAAU,aAAa,OAAO,eAAe,IAAI,MAAM;EAGvG,MAAM,cAA+B;GACnC;GACA,OAAO;GACP;GACA,QAAQ,YAAY,IAChB,uBAAuB,cACvB;GACJ;GACD;AAED,OAAK,UAAU,aAAa,YAAY;EAExC,MAAM,QAAQ,cAAc,KAAK,gBAAgB;EACjD,MAAM,UAAU,QACZ,SAAS,SAAS,0BAA0B,aAAa,GAAG,YAAY,KACxE,SAAS,SAAS,aAAa,aAAa,GAAG,YAAY,IAAI,UAAU;AAC7E,MAAI,MACF,KAAI,MAAM;GAAE;GAAU;GAAc;GAAa;GAAW,EAAE,QAAQ;MAEtE,KAAI,KAAK;GAAE;GAAU;GAAc;GAAa;GAAW,EAAE,QAAQ;;;;;;CAQzE,qBACE,OACA,OACA,WACA,WACA,YACM;AACN,MAAI,CAAC,KAAK,OAAO,wBAAyB;AAC1C,MAAI,KAAK,OAAO,UAAU,UAAW;AACrC,MAAI,CAAC,aAAa,CAAC,WAAY;EAE/B,MAAM,aAAc,QAAQ,QAAS;EAErC,IAAI;EACJ,IAAI,OAA4B,aAAa,UAAU;AAEvD,MAAI,WACF,WAAU,4BAA4B,MAAM,GAAG,MAAM;WAC5C,cAAc,GACvB,WAAU,6BAA6B,MAAM,GAAG,MAAM;MAEtD,WAAU,iCAAiC,MAAM,GAAG,MAAM;EAG5D,MAAM,cAA+B;GACnC;GACA,OAAO;GACP;GACA,QAAQ,YAAY,IAChB,uBAAuB,cACvB;GACL;AAED,OAAK,UAAU,aAAa,YAAY;EAExC,MAAM,UAAU,aACZ,8BAA8B,MAAM,GAAG,MAAM,oBAC7C,sBAAsB,MAAM,GAAG,MAAM,IAAI,UAAU;AACvD,MAAI,WACF,KAAI,MAAM;GAAE;GAAO;GAAO;GAAW;GAAY,EAAE,QAAQ;MAE3D,KAAI,KAAK;GAAE;GAAO;GAAO;GAAW;GAAY,EAAE,QAAQ;;;AAMhE,MAAa,0BAA0B,IAAI,yBAAyB;AAGpE,SAAgB,sBAAsB,KAAsB,YAAiC,QAAgB;CAC3G,MAAM,QAAQ,YAAY,IAAI;AAE9B,KAAI,cAAc,QAAQ;EACxB,IAAI,OAAO,MAAM,MAAM,GAAG,IAAI,QAAQ;AACtC,MAAI,IAAI,OACN,SAAQ,KAAK,IAAI;AAEnB,SAAO;QACF;EACL,IAAI,KAAK,KAAK,MAAM,GAAG,IAAI,QAAQ;AACnC,MAAI,IAAI,OACN,OAAM,KAAK,IAAI;AAEjB,SAAO;;;AAKX,SAAgB,uBAAuB,WAAmB,OAAsB,QAAyB;CACvG,MAAM,UAAU,KAAK,MAAM,YAAY,IAAK;CAI5C,IAAI,UAAU,GAHA,YAAY,OAGH,SAFT,YAAY,OAEY,aAAa,CAAC;AACpD,KAAI,OACF,YAAW,KAAK;AAElB,YAAW,QAAQ,QAAQ;AAE3B,QAAO"}

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/middleware/self-verify.d.ts

@@ -32,7 +32,6 @@ export declare class SelfVerifyMiddleware {
     private config;
     private turnCount;
     private verificationRequested;
-    private lastVerificationPrompt;
     constructor(config?: Partial<SelfVerifyConfig>);
     /**
      * Record a file edit operation

package/dist/src/agent/middleware/self-verify.js

@@ -17,7 +17,6 @@ var SelfVerifyMiddleware = class {
 	config;
 	turnCount = 0;
 	verificationRequested = false;
-	lastVerificationPrompt = "";
 	constructor(config = {}) {
 		this.config = {
 			...DEFAULT_CONFIG,
@@ -76,7 +75,6 @@ var SelfVerifyMiddleware = class {
 		this.fileEdits.clear();
 		this.turnCount = 0;
 		this.verificationRequested = false;
-		this.lastVerificationPrompt = "";
 		log.debug("Self-verify middleware reset");
 	}
 	/**

package/dist/src/agent/middleware/self-verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n  private lastVerificationPrompt = '';\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    this.lastVerificationPrompt = '';\n    log.debug('Self-verify middleware reset');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"self-verify.js","names":[],"sources":["../../../../src/agent/middleware/self-verify.ts"],"sourcesContent":["/**\n * Self-Verification Middleware\n *\n * Implements the \"Build & Self-Verify\" pattern from harness engineering:\n * - Intercepts agent before completion to remind verification\n * - Tracks file edits to detect potential issues\n * - Injects verification reminders into context\n *\n * Inspired by: https://blog.langchain.com/improving-deep-agents-with-harness-engineering/\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SelfVerifyMiddleware');\n\nexport interface FileEditRecord {\n  path: string;\n  editCount: number;\n  lastEditTime: number;\n  operations: string[]; // 'write', 'edit', 'shell' (for build commands)\n}\n\nexport interface SelfVerifyConfig {\n  /** Max edits to same file before warning (default: 5) */\n  maxEditsPerFile: number;\n  /** Enable pre-completion verification check (default: true) */\n  enablePreCompletionCheck: boolean;\n  /** Min turns before triggering verification reminder (default: 3) */\n  minTurnsForVerification: number;\n  /** Reset counters on successful verification (default: true) */\n  resetOnVerification: boolean;\n}\n\nconst DEFAULT_CONFIG: SelfVerifyConfig = {\n  maxEditsPerFile: 5,\n  enablePreCompletionCheck: true,\n  minTurnsForVerification: 3,\n  resetOnVerification: true,\n};\n\n/**\n * Tracks file modifications and provides verification guidance\n */\nexport class SelfVerifyMiddleware {\n  private fileEdits: Map<string, FileEditRecord> = new Map();\n  private config: SelfVerifyConfig;\n  private turnCount = 0;\n  private verificationRequested = false;\n\n  constructor(config: Partial<SelfVerifyConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  /**\n   * Record a file edit operation\n   */\n  recordEdit(filePath: string, operation: 'write' | 'edit' | 'shell'): void {\n    const now = Date.now();\n    const existing = this.fileEdits.get(filePath);\n\n    if (existing) {\n      existing.editCount++;\n      existing.lastEditTime = now;\n      if (!existing.operations.includes(operation)) {\n        existing.operations.push(operation);\n      }\n    } else {\n      this.fileEdits.set(filePath, {\n        path: filePath,\n        editCount: 1,\n        lastEditTime: now,\n        operations: [operation],\n      });\n    }\n\n    log.debug({ filePath, editCount: this.getEditCount(filePath), operation }, 'File edit recorded');\n  }\n\n  /**\n   * Get edit count for a specific file\n   */\n  getEditCount(filePath: string): number {\n    return this.fileEdits.get(filePath)?.editCount || 0;\n  }\n\n  /**\n   * Check if any file has excessive edits (potential doom loop)\n   */\n  hasExcessiveEdits(): { file: string; count: number } | null {\n    for (const [path, record] of this.fileEdits.entries()) {\n      if (record.editCount >= this.config.maxEditsPerFile) {\n        return { file: path, count: record.editCount };\n      }\n    }\n    return null;\n  }\n\n  /**\n   * Increment turn counter\n   */\n  onTurnStart(): void {\n    this.turnCount++;\n    this.verificationRequested = false;\n  }\n\n  /**\n   * Reset all tracking (e.g., after successful task completion)\n   */\n  reset(): void {\n    this.fileEdits.clear();\n    this.turnCount = 0;\n    this.verificationRequested = false;\n    log.debug('Self-verify middleware reset');\n  }\n\n  /**\n   * Get context injection for system prompt\n   * Adds verification guidance based on current state\n   */\n  getContextInjection(): string {\n    const sections: string[] = [];\n\n    // Add workflow guidance\n    sections.push(this.buildWorkflowGuidance());\n\n    // Add excessive edit warning if needed\n    const excessive = this.hasExcessiveEdits();\n    if (excessive) {\n      sections.push(this.buildExcessiveEditWarning(excessive.file, excessive.count));\n    }\n\n    // Add pre-completion check reminder for long sessions\n    if (this.shouldPromptForVerification()) {\n      sections.push(this.buildPreCompletionReminder());\n    }\n\n    return sections.filter(Boolean).join('\\n\\n');\n  }\n\n  /**\n   * Check if we should inject verification reminder\n   */\n  private shouldPromptForVerification(): boolean {\n    if (!this.config.enablePreCompletionCheck) return false;\n    if (this.turnCount < this.config.minTurnsForVerification) return false;\n    if (this.verificationRequested) return false;\n    return true;\n  }\n\n  /**\n   * Mark verification as requested (to avoid spam)\n   */\n  markVerificationRequested(): void {\n    this.verificationRequested = true;\n  }\n\n  /**\n   * Build workflow guidance section\n   */\n  private buildWorkflowGuidance(): string {\n    return `## Problem Solving Workflow\n\nFollow this iterative process for all tasks:\n\n1. **Plan**: Understand the task, read relevant files, and create a plan\n2. **Build**: Implement your solution with verification in mind\n3. **Verify**: Test your work, run checks, compare against requirements\n4. **Fix**: If issues found, analyze and fix them\n\n**Important**: Before declaring a task complete:\n- Re-read the original requirements\n- Verify your solution meets ALL requirements\n- Run any available tests or validation\n- Check for edge cases\n\nDo not skip verification. Incomplete verification leads to incorrect solutions.`;\n  }\n\n  /**\n   * Build warning for excessive file edits (doom loop detection)\n   */\n  private buildExcessiveEditWarning(filePath: string, count: number): string {\n    return `⚠️ **Pattern Alert**: You have edited \"${filePath}\" ${count} times.\n\nThis may indicate:\n- You're fixing symptoms rather than root causes\n- The approach needs reconsideration\n- Requirements may be unclear\n\n**Recommendation**: \n- Step back and re-read the original task\n- Consider if there's a better approach\n- Verify you understand the requirements correctly`;\n  }\n\n  /**\n   * Build pre-completion verification reminder\n   */\n  private buildPreCompletionReminder(): string {\n    this.markVerificationRequested();\n    return `⏳ **Verification Check**: You've made ${this.turnCount} turns on this task.\n\nBefore completing:\n1. ✅ Verify your solution matches the original requirements\n2. ✅ Run tests or validation if available\n3. ✅ Check edge cases and error handling\n4. ✅ Review your changes one final time\n\nIf you're confident, proceed. If unsure, continue refining.`;\n  }\n\n  /**\n   * Get summary of file edits for debugging\n   */\n  getEditSummary(): { totalFiles: number; totalEdits: number; topFiles: Array<{ path: string; count: number }> } {\n    const entries = Array.from(this.fileEdits.entries());\n    const totalEdits = entries.reduce((sum, [, record]) => sum + record.editCount, 0);\n    const topFiles = entries\n      .sort((a, b) => b[1].editCount - a[1].editCount)\n      .slice(0, 5)\n      .map(([path, record]) => ({ path, count: record.editCount }));\n\n    return {\n      totalFiles: entries.length,\n      totalEdits,\n      topFiles,\n    };\n  }\n\n  /**\n   * Update configuration\n   */\n  setConfig(config: Partial<SelfVerifyConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): SelfVerifyConfig {\n    return { ...this.config };\n  }\n}\n"],"mappings":";;;aAWqD;AAErD,MAAM,MAAM,aAAa,uBAAuB;AAoBhD,MAAM,iBAAmC;CACvC,iBAAiB;CACjB,0BAA0B;CAC1B,yBAAyB;CACzB,qBAAqB;CACtB;;;;AAKD,IAAa,uBAAb,MAAkC;CAChC,4BAAiD,IAAI,KAAK;CAC1D;CACA,YAAoB;CACpB,wBAAgC;CAEhC,YAAY,SAAoC,EAAE,EAAE;AAClD,OAAK,SAAS;GAAE,GAAG;GAAgB,GAAG;GAAQ;;;;;CAMhD,WAAW,UAAkB,WAA6C;EACxE,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,WAAW,KAAK,UAAU,IAAI,SAAS;AAE7C,MAAI,UAAU;AACZ,YAAS;AACT,YAAS,eAAe;AACxB,OAAI,CAAC,SAAS,WAAW,SAAS,UAAU,CAC1C,UAAS,WAAW,KAAK,UAAU;QAGrC,MAAK,UAAU,IAAI,UAAU;GAC3B,MAAM;GACN,WAAW;GACX,cAAc;GACd,YAAY,CAAC,UAAU;GACxB,CAAC;AAGJ,MAAI,MAAM;GAAE;GAAU,WAAW,KAAK,aAAa,SAAS;GAAE;GAAW,EAAE,qBAAqB;;;;;CAMlG,aAAa,UAA0B;AACrC,SAAO,KAAK,UAAU,IAAI,SAAS,EAAE,aAAa;;;;;CAMpD,oBAA4D;AAC1D,OAAK,MAAM,CAAC,MAAM,WAAW,KAAK,UAAU,SAAS,CACnD,KAAI,OAAO,aAAa,KAAK,OAAO,gBAClC,QAAO;GAAE,MAAM;GAAM,OAAO,OAAO;GAAW;AAGlD,SAAO;;;;;CAMT,cAAoB;AAClB,OAAK;AACL,OAAK,wBAAwB;;;;;CAM/B,QAAc;AACZ,OAAK,UAAU,OAAO;AACtB,OAAK,YAAY;AACjB,OAAK,wBAAwB;AAC7B,MAAI,MAAM,+BAA+B;;;;;;CAO3C,sBAA8B;EAC5B,MAAM,WAAqB,EAAE;AAG7B,WAAS,KAAK,KAAK,uBAAuB,CAAC;EAG3C,MAAM,YAAY,KAAK,mBAAmB;AAC1C,MAAI,UACF,UAAS,KAAK,KAAK,0BAA0B,UAAU,MAAM,UAAU,MAAM,CAAC;AAIhF,MAAI,KAAK,6BAA6B,CACpC,UAAS,KAAK,KAAK,4BAA4B,CAAC;AAGlD,SAAO,SAAS,OAAO,QAAQ,CAAC,KAAK,OAAO;;;;;CAM9C,8BAA+C;AAC7C,MAAI,CAAC,KAAK,OAAO,yBAA0B,QAAO;AAClD,MAAI,KAAK,YAAY,KAAK,OAAO,wBAAyB,QAAO;AACjE,MAAI,KAAK,sBAAuB,QAAO;AACvC,SAAO;;;;;CAMT,4BAAkC;AAChC,OAAK,wBAAwB;;;;;CAM/B,wBAAwC;AACtC,SAAO;;;;;;;;;;;;;;;;;;;;CAqBT,0BAAkC,UAAkB,OAAuB;AACzE,SAAO,0CAA0C,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;CAgBtE,6BAA6C;AAC3C,OAAK,2BAA2B;AAChC,SAAO,yCAAyC,KAAK,UAAU;;;;;;;;;;;;;CAcjE,iBAA+G;EAC7G,MAAM,UAAU,MAAM,KAAK,KAAK,UAAU,SAAS,CAAC;EACpD,MAAM,aAAa,QAAQ,QAAQ,KAAK,GAAG,YAAY,MAAM,OAAO,WAAW,EAAE;EACjF,MAAM,WAAW,QACd,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,GAAG,UAAU,CAC/C,MAAM,GAAG,EAAE,CACX,KAAK,CAAC,MAAM,aAAa;GAAE;GAAM,OAAO,OAAO;GAAW,EAAE;AAE/D,SAAO;GACL,YAAY,QAAQ;GACpB;GACA;GACD;;;;;CAMH,UAAU,QAAyC;AACjD,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;;;;CAM7C,YAA8B;AAC5B,SAAO,EAAE,GAAG,KAAK,QAAQ"}

package/dist/src/agent/models/index.d.ts

@@ -3,4 +3,4 @@
  *
  * Model management and selection.
  */
-export { ModelManager, type ModelManagerConfig, type RunResult } from './manager.js';
+export { ModelManager, type ModelManagerConfig } from './manager.js';

package/dist/src/agent/models/manager.d.ts

@@ -4,22 +4,14 @@
  * Handles model selection, switching, and automatic fallback
  * when a provider fails.
  */
-import { Agent, type AgentMessage } from '@earendil-works/pi-agent-core';
+import { Agent } from '@earendil-works/pi-agent-core';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import { type Config } from '../../config/schema.js';
-import { type ModelCandidate } from '../fallback/index.js';
+import { type ModelCandidate } from '../fallback/candidates.js';
 export interface ModelManagerConfig {
     defaultModel?: string;
     config?: Config;
 }
-export interface RunResult {
-    content: string | null;
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-}
 export declare class ModelManager {
     private defaultModel;
     private config?;
@@ -28,12 +20,8 @@ export declare class ModelManager {
     private sessionModels;
     /** Baseline model from `agents.list` / defaults merge when the session agent is created. */
     private sessionProfileDefaults;
-    private channelManager?;
+    private sessionProfileFallbacks;
     constructor(config?: ModelManagerConfig);
-    /**
-     * Set channel manager reference for accessing session-specific settings
-     */
-    setChannelManager(channelManager: any): void;
     /**
      * Apply updated config so default model and failover metadata match disk/runtime config.
      */
@@ -42,7 +30,7 @@ export declare class ModelManager {
      * Set the config-derived default model for a session (from effective agent profile).
      * Cleared by {@link updateFromConfig} or {@link clearSessionProfileDefault}.
      */
-    setSessionProfileDefault(sessionKey: string, modelRef: string): void;
+    setSessionProfileDefault(sessionKey: string, modelRef: string, fallbacks?: string[]): void;
     clearSessionProfileDefault(sessionKey: string): void;
     /**
      * Get current model name
@@ -78,10 +66,6 @@ export declare class ModelManager {
      * Apply a resolved pi-ai model and sync {@link currentModelName} / {@link currentProvider}.
      */
     applyResolvedModel(agent: Agent, model: Model<Api>, modelRef: string): void;
-    /**
-     * Run the agent with automatic model fallback on failure.
-     */
-    runWithFallback(agent: Agent, sessionKey: string, userMessage: AgentMessage, provider: string, model: string): Promise<RunResult>;
     /**
      * Find model by reference (provider/modelId)
      */

package/dist/src/agent/models/manager.js

@@ -2,28 +2,13 @@ import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { getAllModels, getDefaultModelSync, init_providers, resolveModel } from "../../providers/index.js";
-import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
-import { isAssistantTurnAborted, isAssistantTurnFailed, maybeRetryTurnAfterTransientLlmFailure } from "../orchestration/llm-turn-retry.js";
-import { describeFailoverError, isFailoverError } from "../fallback/error.js";
 import { parseModelRef } from "./selection.js";
 import { resolveFallbackCandidates } from "../fallback/candidates.js";
-import "../fallback/index.js";
 //#region src/agent/models/manager.ts
 init_schema();
 init_logger();
 init_providers();
 const log = createLogger("ModelManager");
-/**
-* Get the last assistant content from agent messages
-*/
-function getLastAssistantContent(agent) {
-	const messages = agent.state.messages;
-	for (let i = messages.length - 1; i >= 0; i--) {
-		const msg = messages[i];
-		if (msg.role === "assistant") return msg.content.filter((c) => c.type === "text").map((c) => c.text || "").join("");
-	}
-	return null;
-}
 var ModelManager = class {
 	defaultModel;
 	config;
@@ -32,7 +17,7 @@ var ModelManager = class {
 	sessionModels = /* @__PURE__ */ new Map();
 	/** Baseline model from `agents.list` / defaults merge when the session agent is created. */
 	sessionProfileDefaults = /* @__PURE__ */ new Map();
-	channelManager;
+	sessionProfileFallbacks = /* @__PURE__ */ new Map();
 	constructor(config = {}) {
 		this.config = config.config;
 		this.defaultModel = config.defaultModel || getDefaultModelSync(config.config);
@@ -40,12 +25,6 @@ var ModelManager = class {
 		this.currentProvider = this.defaultModel.split("/")[0] || "anthropic";
 	}
 	/**
-	* Set channel manager reference for accessing session-specific settings
-	*/
-	setChannelManager(channelManager) {
-		this.channelManager = channelManager;
-	}
-	/**
 	* Apply updated config so default model and failover metadata match disk/runtime config.
 	*/
 	updateFromConfig(config) {
@@ -53,16 +32,21 @@ var ModelManager = class {
 		const ref = getAgentDefaultModelRef(config);
 		this.defaultModel = ref ? ref : getDefaultModelSync(config);
 		this.sessionProfileDefaults.clear();
+		this.sessionProfileFallbacks.clear();
 	}
 	/**
 	* Set the config-derived default model for a session (from effective agent profile).
 	* Cleared by {@link updateFromConfig} or {@link clearSessionProfileDefault}.
 	*/
-	setSessionProfileDefault(sessionKey, modelRef) {
+	setSessionProfileDefault(sessionKey, modelRef, fallbacks = []) {
 		this.sessionProfileDefaults.set(sessionKey, modelRef);
+		const cleanFallbacks = fallbacks.map((ref) => ref.trim()).filter(Boolean);
+		if (cleanFallbacks.length > 0) this.sessionProfileFallbacks.set(sessionKey, cleanFallbacks);
+		else this.sessionProfileFallbacks.delete(sessionKey);
 	}
 	clearSessionProfileDefault(sessionKey) {
 		this.sessionProfileDefaults.delete(sessionKey);
+		this.sessionProfileFallbacks.delete(sessionKey);
 	}
 	/**
 	* Get current model name
@@ -156,7 +140,8 @@ var ModelManager = class {
 		return resolveFallbackCandidates({
 			cfg: this.config,
 			provider: parsed.provider,
-			model: parsed.model
+			model: parsed.model,
+			fallbacksOverride: this.sessionModels.has(sessionKey) ? void 0 : this.sessionProfileFallbacks.get(sessionKey)
 		});
 	}
 	/**
@@ -168,108 +153,6 @@ var ModelManager = class {
 		this.currentProvider = model.provider || "unknown";
 	}
 	/**
-	* Run the agent with automatic model fallback on failure.
-	*/
-	async runWithFallback(agent, sessionKey, userMessage, provider, model) {
-		const candidates = resolveFallbackCandidates({
-			cfg: this.config ?? void 0,
-			provider,
-			model
-		});
-		let lastError;
-		for (let i = 0; i < candidates.length; i++) {
-			const candidate = candidates[i];
-			const modelRef = `${candidate.provider}/${candidate.model}`;
-			let candidateModel;
-			try {
-				candidateModel = resolveModel(modelRef);
-			} catch {
-				log.warn({
-					provider: candidate.provider,
-					model: candidate.model
-				}, "Fallback model not found");
-				continue;
-			}
-			log.info({
-				attempt: i + 1,
-				total: candidates.length,
-				provider: candidate.provider,
-				model: candidate.model
-			}, "Attempting model");
-			const beforeLen = agent.state.messages.length;
-			try {
-				this.applyResolvedModel(agent, candidateModel, modelRef);
-				const runTurn = async () => {
-					await agent.prompt(userMessage);
-					await agent.waitForIdle();
-					await maybeRetryTurnAfterTransientLlmFailure(agent, {
-						sessionKey,
-						log
-					});
-				};
-				await runAgentTurnWithTimeout(agent, runTurn, resolveAgentTurnTimeoutMs(this.config));
-				if (isAssistantTurnAborted(agent)) {
-					const usage = agent.state.lastUsage;
-					return {
-						content: getLastAssistantContent(agent),
-						usage
-					};
-				}
-				if (!isAssistantTurnFailed(agent)) {
-					const usage = agent.state.lastUsage;
-					log.info({
-						provider: candidate.provider,
-						model: candidate.model,
-						success: true
-					}, "Model call completed");
-					return {
-						content: getLastAssistantContent(agent),
-						usage
-					};
-				}
-				lastError = /* @__PURE__ */ new Error(`Assistant turn failed: ${modelRef}`);
-				log.warn({
-					attempt: i + 1,
-					sessionKey,
-					modelRef
-				}, "Model turn failed after retries, trying fallback");
-			} catch (err) {
-				lastError = err;
-				if (err instanceof DOMException && err.name === "AbortError") {
-					log.info({ sessionKey }, "User aborted model call");
-					throw err;
-				}
-				const errorDetails = {
-					attempt: i + 1,
-					provider: candidate.provider,
-					model: candidate.model,
-					errorMessage: err instanceof Error ? err.message : String(err)
-				};
-				if (isFailoverError(err)) {
-					const described = describeFailoverError(err);
-					log.warn({
-						...errorDetails,
-						...described
-					}, "Model call failed, trying fallback");
-				} else log.warn(errorDetails, "Model call failed, trying fallback");
-			}
-			agent.state.messages = agent.state.messages.slice(0, beforeLen);
-		}
-		if (lastError) {
-			const em = lastError instanceof Error ? lastError.message : String(lastError);
-			const attemptedModelRefs = candidates.map((c) => `${c.provider}/${c.model}`);
-			log.error({
-				err: lastError instanceof Error ? lastError : void 0,
-				errorMessage: em,
-				attemptedCandidates: candidates.length,
-				attemptedModelRefs,
-				sessionKey
-			}, `All model candidates failed (${candidates.length} refs): ${em}`);
-			throw lastError instanceof Error ? lastError : new Error(String(lastError));
-		}
-		return { content: null };
-	}
-	/**
 	* Find model by reference (provider/modelId)
 	*/
 	findByRef(ref) {