@within-7/minto 0.4.1 → 0.4.3

package/dist/core/tokenStatsManager.js

@@ -1,354 +0,0 @@
-import { EventEmitter } from "events";
-import { DEFAULT_ESTIMATION_CONFIG } from "./tokenStats.js";
-import { emitReminderEvent } from "../services/systemReminder.js";
-class TokenStatsManagerImpl extends EventEmitter {
-  static instance = null;
-  // Global aggregated stats
-  globalStats = this.createEmptyStats();
-  // Per-agent stats (agentId → stats)
-  agentStats = /* @__PURE__ */ new Map();
-  // Per-request records (requestId → record) - for debugging, with LRU eviction
-  requestRecords = /* @__PURE__ */ new Map();
-  // Configuration
-  static MAX_REQUEST_RECORDS = 1e3;
-  constructor() {
-    super();
-    this.setMaxListeners(100);
-  }
-  /**
-   * Get the singleton instance
-   */
-  static getInstance() {
-    if (!TokenStatsManagerImpl.instance) {
-      TokenStatsManagerImpl.instance = new TokenStatsManagerImpl();
-    }
-    return TokenStatsManagerImpl.instance;
-  }
-  /**
-   * Record token usage from an API response
-   *
-   * This is the PRIMARY entry point - called from claude.ts
-   * after every API response.
-   *
-   * @param usage - Raw token usage from API
-   * @param costUSD - Calculated cost in USD
-   * @param model - Model name used
-   * @param context - Optional tracking context (agentId, toolUseId)
-   */
-  recordUsage(usage, costUSD, model, context) {
-    const record = {
-      inputTokens: usage.inputTokens,
-      outputTokens: usage.outputTokens,
-      cacheCreationTokens: usage.cacheCreationTokens ?? 0,
-      cacheReadTokens: usage.cacheReadTokens ?? 0,
-      totalTokens: usage.inputTokens + usage.outputTokens,
-      estimatedCostUSD: costUSD,
-      source: "api",
-      timestamp: Date.now(),
-      model
-    };
-    this.aggregateInto(this.globalStats, record);
-    if (context?.agentId) {
-      let stats = this.agentStats.get(context.agentId);
-      if (!stats) {
-        stats = this.createEmptyStats();
-        this.agentStats.set(context.agentId, stats);
-      }
-      this.aggregateInto(stats, record);
-    }
-    const requestId = context?.toolUseId ?? `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    this.requestRecords.set(requestId, record);
-    if (this.requestRecords.size > TokenStatsManagerImpl.MAX_REQUEST_RECORDS) {
-      const oldestKey = this.requestRecords.keys().next().value;
-      if (oldestKey) this.requestRecords.delete(oldestKey);
-    }
-    const scope = context?.agentId ? { type: "agent", agentId: context.agentId } : { type: "global" };
-    this.emitEvent({
-      eventType: "usage_recorded",
-      scope,
-      usage: record,
-      aggregated: context?.agentId ? this.agentStats.get(context.agentId) : this.globalStats,
-      globalStats: this.globalStats
-    });
-  }
-  /**
-   * Estimate token count from text
-   *
-   * Uses a simple character-based estimation. This is a fallback
-   * when the API doesn't return token counts.
-   *
-   * @param text - Text to estimate tokens for
-   * @returns Estimated token count
-   */
-  estimateTokens(text) {
-    return Math.ceil(text.length / DEFAULT_ESTIMATION_CONFIG.charsPerToken);
-  }
-  /**
-   * Record estimated usage when API doesn't return token counts
-   *
-   * This is used as a fallback for APIs that don't return usage data.
-   *
-   * @param inputText - Input text (prompt)
-   * @param outputText - Output text (completion)
-   * @param model - Model name
-   * @param context - Optional tracking context
-   */
-  recordEstimatedUsage(inputText, outputText, model, context) {
-    const inputTokens = this.estimateTokens(inputText);
-    const outputTokens = this.estimateTokens(outputText);
-    const costUSD = inputTokens / 1e6 * DEFAULT_ESTIMATION_CONFIG.defaultInputCostPerMillion + outputTokens / 1e6 * DEFAULT_ESTIMATION_CONFIG.defaultOutputCostPerMillion;
-    const record = {
-      inputTokens,
-      outputTokens,
-      cacheCreationTokens: 0,
-      cacheReadTokens: 0,
-      totalTokens: inputTokens + outputTokens,
-      estimatedCostUSD: costUSD,
-      source: "estimated",
-      timestamp: Date.now(),
-      model
-    };
-    this.aggregateInto(this.globalStats, record);
-    if (context?.agentId) {
-      let stats = this.agentStats.get(context.agentId);
-      if (!stats) {
-        stats = this.createEmptyStats();
-        this.agentStats.set(context.agentId, stats);
-      }
-      this.aggregateInto(stats, record);
-    }
-    this.emitEvent({
-      eventType: "usage_recorded",
-      scope: { type: "global" },
-      usage: record,
-      aggregated: this.globalStats,
-      globalStats: this.globalStats
-    });
-  }
-  // ===== Getters =====
-  /**
-   * Get global aggregated statistics
-   */
-  getGlobalStats() {
-    return this.cloneStats(this.globalStats);
-  }
-  /**
-   * Get statistics for a specific agent
-   *
-   * @param agentId - Agent ID to get stats for
-   * @returns Agent stats or null if not found
-   */
-  getAgentStats(agentId) {
-    const stats = this.agentStats.get(agentId);
-    return stats ? this.cloneStats(stats) : null;
-  }
-  /**
-   * Get all agent statistics
-   */
-  getAllAgentStats() {
-    const result = /* @__PURE__ */ new Map();
-    for (const [agentId, stats] of this.agentStats) {
-      result.set(agentId, this.cloneStats(stats));
-    }
-    return result;
-  }
-  /**
-   * Get a specific request record
-   */
-  getRequestRecord(requestId) {
-    return this.requestRecords.get(requestId) ?? null;
-  }
-  // ===== Backward Compatibility Layer =====
-  /**
-   * Get total tokens (for costTracker.getTokenCounts compatibility)
-   *
-   * This method provides backward compatibility with the existing
-   * costTracker.getTokenCounts() interface.
-   */
-  getTokenCounts() {
-    return {
-      input: this.globalStats.totalInputTokens,
-      output: this.globalStats.totalOutputTokens,
-      cacheCreation: this.globalStats.totalCacheCreationTokens,
-      cacheRead: this.globalStats.totalCacheReadTokens,
-      total: this.globalStats.grandTotalTokens
-    };
-  }
-  // ===== Event Subscription =====
-  /**
-   * Subscribe to all stats updates
-   *
-   * @param callback - Called when any stats change
-   * @returns Unsubscribe function
-   */
-  onStatsUpdate(callback) {
-    this.on("stats_update", callback);
-    return () => this.off("stats_update", callback);
-  }
-  /**
-   * Subscribe to updates for a specific agent
-   *
-   * @param agentId - Agent ID to subscribe to
-   * @param callback - Called when agent stats change
-   * @returns Unsubscribe function
-   */
-  onAgentStatsUpdate(agentId, callback) {
-    const handler = (event) => {
-      if (event.scope.type === "agent" && event.scope.agentId === agentId) {
-        callback(event.aggregated);
-      }
-    };
-    this.on("stats_update", handler);
-    return () => this.off("stats_update", handler);
-  }
-  /**
-   * Subscribe to global stats updates only
-   *
-   * @param callback - Called when global stats change
-   * @returns Unsubscribe function
-   */
-  onGlobalStatsUpdate(callback) {
-    const handler = (event) => {
-      callback(event.globalStats);
-    };
-    this.on("stats_update", handler);
-    return () => this.off("stats_update", handler);
-  }
-  // ===== Agent Lifecycle =====
-  /**
-   * Mark an agent's scope as completed
-   *
-   * This emits a scope_completed event and optionally
-   * cleans up the agent's stats from memory.
-   *
-   * @param agentId - Agent ID to complete
-   * @param cleanup - Whether to remove from memory (default: false)
-   */
-  completeAgentScope(agentId, cleanup = false) {
-    const stats = this.agentStats.get(agentId);
-    if (!stats) return;
-    this.emitEvent({
-      eventType: "scope_completed",
-      scope: { type: "agent", agentId },
-      aggregated: stats,
-      globalStats: this.globalStats
-    });
-    if (cleanup) {
-      this.agentStats.delete(agentId);
-    }
-  }
-  // ===== Internal Methods =====
-  createEmptyStats() {
-    return {
-      totalInputTokens: 0,
-      totalOutputTokens: 0,
-      totalCacheCreationTokens: 0,
-      totalCacheReadTokens: 0,
-      grandTotalTokens: 0,
-      totalCostUSD: 0,
-      requestCount: 0,
-      byModel: /* @__PURE__ */ new Map()
-    };
-  }
-  aggregateInto(stats, record) {
-    stats.totalInputTokens += record.inputTokens;
-    stats.totalOutputTokens += record.outputTokens;
-    stats.totalCacheCreationTokens += record.cacheCreationTokens;
-    stats.totalCacheReadTokens += record.cacheReadTokens;
-    stats.grandTotalTokens += record.totalTokens;
-    stats.totalCostUSD += record.estimatedCostUSD;
-    stats.requestCount += 1;
-    if (!stats.firstRequestTime) {
-      stats.firstRequestTime = record.timestamp;
-    }
-    stats.lastRequestTime = record.timestamp;
-    const modelStats = stats.byModel.get(record.model);
-    if (modelStats) {
-      modelStats.inputTokens += record.inputTokens;
-      modelStats.outputTokens += record.outputTokens;
-      modelStats.totalTokens += record.totalTokens;
-      modelStats.estimatedCostUSD += record.estimatedCostUSD;
-      modelStats.requestCount += 1;
-    } else {
-      stats.byModel.set(record.model, {
-        model: record.model,
-        inputTokens: record.inputTokens,
-        outputTokens: record.outputTokens,
-        totalTokens: record.totalTokens,
-        estimatedCostUSD: record.estimatedCostUSD,
-        requestCount: 1
-      });
-    }
-  }
-  cloneStats(stats) {
-    return {
-      ...stats,
-      byModel: new Map(stats.byModel)
-    };
-  }
-  emitEvent(event) {
-    this.emit("stats_update", event);
-  }
-  /**
-   * Reset all stats (for testing only)
-   */
-  resetForTests() {
-    if (process.env.NODE_ENV !== "test") {
-      throw new Error("resetForTests can only be called in tests");
-    }
-    this.reset();
-  }
-  /**
-   * Reset all statistics
-   *
-   * Called by costTracker.resetStateForTests() for backward compatibility.
-   */
-  reset() {
-    this.globalStats = this.createEmptyStats();
-    this.agentStats.clear();
-    this.requestRecords.clear();
-    emittedTokenThresholds.clear();
-  }
-}
-const tokenStatsManager = TokenStatsManagerImpl.getInstance();
-const TOKEN_THRESHOLDS = [50, 75, 90];
-const emittedTokenThresholds = /* @__PURE__ */ new Set();
-const DEFAULT_CONTEXT_LIMIT = 2e5;
-function recordTokenUsage(usage, costUSD, model, context) {
-  tokenStatsManager.recordUsage(usage, costUSD, model, context);
-  const globalStats = tokenStatsManager.getGlobalStats();
-  const total = globalStats.grandTotalTokens;
-  const percentage = Math.round(total / DEFAULT_CONTEXT_LIMIT * 100);
-  for (const threshold of TOKEN_THRESHOLDS) {
-    if (percentage >= threshold && !emittedTokenThresholds.has(threshold)) {
-      emittedTokenThresholds.add(threshold);
-      emitReminderEvent("token:usage", {
-        used: total,
-        total: DEFAULT_CONTEXT_LIMIT,
-        percentage,
-        threshold
-      });
-    }
-  }
-  import("../utils/stats.js").then(({ recordMessage }) => {
-    recordMessage(model, usage.inputTokens, usage.outputTokens, costUSD);
-  }).catch(() => {
-  });
-}
-function getGlobalTokenStats() {
-  return tokenStatsManager.getGlobalStats();
-}
-function getAgentTokenStats(agentId) {
-  return tokenStatsManager.getAgentStats(agentId);
-}
-function estimateTokenCount(text) {
-  return tokenStatsManager.estimateTokens(text);
-}
-export {
-  estimateTokenCount,
-  getAgentTokenStats,
-  getGlobalTokenStats,
-  recordTokenUsage,
-  tokenStatsManager
-};
-//# sourceMappingURL=tokenStatsManager.js.map

package/dist/core/tokenStatsManager.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/core/tokenStatsManager.ts"],
-  "sourcesContent": ["/**\n * Token Statistics Manager\n *\n * Centralized token statistics tracking for the entire application.\n * This is the single source of truth for all token usage data.\n *\n * Architecture:\n * - Singleton pattern for global access\n * - Event-driven updates for real-time UI\n * - Hierarchical aggregation (global \u2192 agent \u2192 request)\n * - Backward compatible with existing costTracker\n *\n * Usage:\n * ```typescript\n * import { tokenStatsManager, recordTokenUsage } from '@core/tokenStatsManager'\n *\n * // Record usage from API response\n * recordTokenUsage(\n *   { inputTokens: 100, outputTokens: 50 },\n *   0.0015,\n *   'gpt-4',\n *   { agentId: 'agent-123' }\n * )\n *\n * // Get global stats\n * const stats = tokenStatsManager.getGlobalStats()\n *\n * // Subscribe to updates\n * const unsubscribe = tokenStatsManager.onStatsUpdate((event) => {\n *   console.log('Stats updated:', event)\n * })\n * ```\n */\n\nimport { EventEmitter } from 'events'\nimport type {\n  TokenUsageRecord,\n  AggregatedTokenStats,\n  TokenStatsScope,\n  TokenStatsEvent,\n  TokenTrackingContext,\n  RawTokenUsage,\n  ModelTokenStats,\n} from './tokenStats'\nimport { DEFAULT_ESTIMATION_CONFIG } from './tokenStats'\nimport { emitReminderEvent } from '../services/systemReminder'\n\n/**\n * TokenStatsManager - Centralized token statistics tracking\n */\nclass TokenStatsManagerImpl extends EventEmitter {\n  private static instance: TokenStatsManagerImpl | null = null\n\n  // Global aggregated stats\n  private globalStats: AggregatedTokenStats = this.createEmptyStats()\n\n  // Per-agent stats (agentId \u2192 stats)\n  private agentStats: Map<string, AggregatedTokenStats> = new Map()\n\n  // Per-request records (requestId \u2192 record) - for debugging, with LRU eviction\n  private requestRecords: Map<string, TokenUsageRecord> = new Map()\n\n  // Configuration\n  private static readonly MAX_REQUEST_RECORDS = 1000\n\n  private constructor() {\n    super()\n    this.setMaxListeners(100)\n  }\n\n  /**\n   * Get the singleton instance\n   */\n  static getInstance(): TokenStatsManagerImpl {\n    if (!TokenStatsManagerImpl.instance) {\n      TokenStatsManagerImpl.instance = new TokenStatsManagerImpl()\n    }\n    return TokenStatsManagerImpl.instance\n  }\n\n  /**\n   * Record token usage from an API response\n   *\n   * This is the PRIMARY entry point - called from claude.ts\n   * after every API response.\n   *\n   * @param usage - Raw token usage from API\n   * @param costUSD - Calculated cost in USD\n   * @param model - Model name used\n   * @param context - Optional tracking context (agentId, toolUseId)\n   */\n  recordUsage(\n    usage: RawTokenUsage,\n    costUSD: number,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const record: TokenUsageRecord = {\n      inputTokens: usage.inputTokens,\n      outputTokens: usage.outputTokens,\n      cacheCreationTokens: usage.cacheCreationTokens ?? 0,\n      cacheReadTokens: usage.cacheReadTokens ?? 0,\n      totalTokens: usage.inputTokens + usage.outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'api',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in agent context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Store request record (with LRU eviction)\n    const requestId =\n      context?.toolUseId ??\n      `req-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n    this.requestRecords.set(requestId, record)\n    if (this.requestRecords.size > TokenStatsManagerImpl.MAX_REQUEST_RECORDS) {\n      const oldestKey = this.requestRecords.keys().next().value\n      if (oldestKey) this.requestRecords.delete(oldestKey)\n    }\n\n    // Emit event for UI updates\n    const scope: TokenStatsScope = context?.agentId\n      ? { type: 'agent', agentId: context.agentId }\n      : { type: 'global' }\n\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope,\n      usage: record,\n      aggregated: context?.agentId\n        ? this.agentStats.get(context.agentId)!\n        : this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  /**\n   * Estimate token count from text\n   *\n   * Uses a simple character-based estimation. This is a fallback\n   * when the API doesn't return token counts.\n   *\n   * @param text - Text to estimate tokens for\n   * @returns Estimated token count\n   */\n  estimateTokens(text: string): number {\n    return Math.ceil(text.length / DEFAULT_ESTIMATION_CONFIG.charsPerToken)\n  }\n\n  /**\n   * Record estimated usage when API doesn't return token counts\n   *\n   * This is used as a fallback for APIs that don't return usage data.\n   *\n   * @param inputText - Input text (prompt)\n   * @param outputText - Output text (completion)\n   * @param model - Model name\n   * @param context - Optional tracking context\n   */\n  recordEstimatedUsage(\n    inputText: string,\n    outputText: string,\n    model: string,\n    context?: TokenTrackingContext,\n  ): void {\n    const inputTokens = this.estimateTokens(inputText)\n    const outputTokens = this.estimateTokens(outputText)\n\n    const costUSD =\n      (inputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultInputCostPerMillion +\n      (outputTokens / 1_000_000) *\n        DEFAULT_ESTIMATION_CONFIG.defaultOutputCostPerMillion\n\n    const record: TokenUsageRecord = {\n      inputTokens,\n      outputTokens,\n      cacheCreationTokens: 0,\n      cacheReadTokens: 0,\n      totalTokens: inputTokens + outputTokens,\n      estimatedCostUSD: costUSD,\n      source: 'estimated',\n      timestamp: Date.now(),\n      model,\n    }\n\n    // Update global stats\n    this.aggregateInto(this.globalStats, record)\n\n    // Update agent stats if in context\n    if (context?.agentId) {\n      let stats = this.agentStats.get(context.agentId)\n      if (!stats) {\n        stats = this.createEmptyStats()\n        this.agentStats.set(context.agentId, stats)\n      }\n      this.aggregateInto(stats, record)\n    }\n\n    // Emit event\n    this.emitEvent({\n      eventType: 'usage_recorded',\n      scope: { type: 'global' },\n      usage: record,\n      aggregated: this.globalStats,\n      globalStats: this.globalStats,\n    })\n  }\n\n  // ===== Getters =====\n\n  /**\n   * Get global aggregated statistics\n   */\n  getGlobalStats(): AggregatedTokenStats {\n    return this.cloneStats(this.globalStats)\n  }\n\n  /**\n   * Get statistics for a specific agent\n   *\n   * @param agentId - Agent ID to get stats for\n   * @returns Agent stats or null if not found\n   */\n  getAgentStats(agentId: string): AggregatedTokenStats | null {\n    const stats = this.agentStats.get(agentId)\n    return stats ? this.cloneStats(stats) : null\n  }\n\n  /**\n   * Get all agent statistics\n   */\n  getAllAgentStats(): Map<string, AggregatedTokenStats> {\n    const result = new Map<string, AggregatedTokenStats>()\n    for (const [agentId, stats] of this.agentStats) {\n      result.set(agentId, this.cloneStats(stats))\n    }\n    return result\n  }\n\n  /**\n   * Get a specific request record\n   */\n  getRequestRecord(requestId: string): TokenUsageRecord | null {\n    return this.requestRecords.get(requestId) ?? null\n  }\n\n  // ===== Backward Compatibility Layer =====\n\n  /**\n   * Get total tokens (for costTracker.getTokenCounts compatibility)\n   *\n   * This method provides backward compatibility with the existing\n   * costTracker.getTokenCounts() interface.\n   */\n  getTokenCounts(): {\n    input: number\n    output: number\n    cacheCreation: number\n    cacheRead: number\n    total: number\n  } {\n    return {\n      input: this.globalStats.totalInputTokens,\n      output: this.globalStats.totalOutputTokens,\n      cacheCreation: this.globalStats.totalCacheCreationTokens,\n      cacheRead: this.globalStats.totalCacheReadTokens,\n      total: this.globalStats.grandTotalTokens,\n    }\n  }\n\n  // ===== Event Subscription =====\n\n  /**\n   * Subscribe to all stats updates\n   *\n   * @param callback - Called when any stats change\n   * @returns Unsubscribe function\n   */\n  onStatsUpdate(callback: (event: TokenStatsEvent) => void): () => void {\n    this.on('stats_update', callback)\n    return () => this.off('stats_update', callback)\n  }\n\n  /**\n   * Subscribe to updates for a specific agent\n   *\n   * @param agentId - Agent ID to subscribe to\n   * @param callback - Called when agent stats change\n   * @returns Unsubscribe function\n   */\n  onAgentStatsUpdate(\n    agentId: string,\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      if (event.scope.type === 'agent' && event.scope.agentId === agentId) {\n        callback(event.aggregated)\n      }\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  /**\n   * Subscribe to global stats updates only\n   *\n   * @param callback - Called when global stats change\n   * @returns Unsubscribe function\n   */\n  onGlobalStatsUpdate(\n    callback: (stats: AggregatedTokenStats) => void,\n  ): () => void {\n    const handler = (event: TokenStatsEvent) => {\n      callback(event.globalStats)\n    }\n    this.on('stats_update', handler)\n    return () => this.off('stats_update', handler)\n  }\n\n  // ===== Agent Lifecycle =====\n\n  /**\n   * Mark an agent's scope as completed\n   *\n   * This emits a scope_completed event and optionally\n   * cleans up the agent's stats from memory.\n   *\n   * @param agentId - Agent ID to complete\n   * @param cleanup - Whether to remove from memory (default: false)\n   */\n  completeAgentScope(agentId: string, cleanup: boolean = false): void {\n    const stats = this.agentStats.get(agentId)\n    if (!stats) return\n\n    this.emitEvent({\n      eventType: 'scope_completed',\n      scope: { type: 'agent', agentId },\n      aggregated: stats,\n      globalStats: this.globalStats,\n    })\n\n    if (cleanup) {\n      this.agentStats.delete(agentId)\n    }\n  }\n\n  // ===== Internal Methods =====\n\n  private createEmptyStats(): AggregatedTokenStats {\n    return {\n      totalInputTokens: 0,\n      totalOutputTokens: 0,\n      totalCacheCreationTokens: 0,\n      totalCacheReadTokens: 0,\n      grandTotalTokens: 0,\n      totalCostUSD: 0,\n      requestCount: 0,\n      byModel: new Map(),\n    }\n  }\n\n  private aggregateInto(\n    stats: AggregatedTokenStats,\n    record: TokenUsageRecord,\n  ): void {\n    stats.totalInputTokens += record.inputTokens\n    stats.totalOutputTokens += record.outputTokens\n    stats.totalCacheCreationTokens += record.cacheCreationTokens\n    stats.totalCacheReadTokens += record.cacheReadTokens\n    stats.grandTotalTokens += record.totalTokens\n    stats.totalCostUSD += record.estimatedCostUSD\n    stats.requestCount += 1\n\n    if (!stats.firstRequestTime) {\n      stats.firstRequestTime = record.timestamp\n    }\n    stats.lastRequestTime = record.timestamp\n\n    // Update per-model breakdown\n    const modelStats = stats.byModel.get(record.model)\n    if (modelStats) {\n      modelStats.inputTokens += record.inputTokens\n      modelStats.outputTokens += record.outputTokens\n      modelStats.totalTokens += record.totalTokens\n      modelStats.estimatedCostUSD += record.estimatedCostUSD\n      modelStats.requestCount += 1\n    } else {\n      stats.byModel.set(record.model, {\n        model: record.model,\n        inputTokens: record.inputTokens,\n        outputTokens: record.outputTokens,\n        totalTokens: record.totalTokens,\n        estimatedCostUSD: record.estimatedCostUSD,\n        requestCount: 1,\n      })\n    }\n  }\n\n  private cloneStats(stats: AggregatedTokenStats): AggregatedTokenStats {\n    return {\n      ...stats,\n      byModel: new Map(stats.byModel),\n    }\n  }\n\n  private emitEvent(event: TokenStatsEvent): void {\n    this.emit('stats_update', event)\n  }\n\n  /**\n   * Reset all stats (for testing only)\n   */\n  resetForTests(): void {\n    if (process.env.NODE_ENV !== 'test') {\n      throw new Error('resetForTests can only be called in tests')\n    }\n    this.reset()\n  }\n\n  /**\n   * Reset all statistics\n   *\n   * Called by costTracker.resetStateForTests() for backward compatibility.\n   */\n  reset(): void {\n    this.globalStats = this.createEmptyStats()\n    this.agentStats.clear()\n    this.requestRecords.clear()\n    emittedTokenThresholds.clear()\n  }\n}\n\n// Export singleton instance\nexport const tokenStatsManager = TokenStatsManagerImpl.getInstance()\n\n// ===== Convenience Functions =====\n\n/**\n * Record token usage from an API response\n *\n * This is the main function to call from claude.ts after each API response.\n * Also updates the persistent stats manager for cross-session tracking.\n */\n// Token usage thresholds (percentage of context limit)\nconst TOKEN_THRESHOLDS = [50, 75, 90] as const\nconst emittedTokenThresholds = new Set<number>()\nconst DEFAULT_CONTEXT_LIMIT = 200_000\n\nexport function recordTokenUsage(\n  usage: RawTokenUsage,\n  costUSD: number,\n  model: string,\n  context?: TokenTrackingContext,\n): void {\n  tokenStatsManager.recordUsage(usage, costUSD, model, context)\n\n  // Emit token:usage at threshold crossings\n  const globalStats = tokenStatsManager.getGlobalStats()\n  const total = globalStats.grandTotalTokens\n  const percentage = Math.round((total / DEFAULT_CONTEXT_LIMIT) * 100)\n  for (const threshold of TOKEN_THRESHOLDS) {\n    if (percentage >= threshold && !emittedTokenThresholds.has(threshold)) {\n      emittedTokenThresholds.add(threshold)\n      emitReminderEvent('token:usage', {\n        used: total,\n        total: DEFAULT_CONTEXT_LIMIT,\n        percentage,\n        threshold,\n      })\n    }\n  }\n\n  // Also record to persistent stats manager (fire-and-forget)\n  import('@utils/stats')\n    .then(({ recordMessage }) => {\n      recordMessage(model, usage.inputTokens, usage.outputTokens, costUSD)\n    })\n    .catch(() => {\n      // Stats manager not available, ignore\n    })\n}\n\n/**\n * Get global token statistics\n */\nexport function getGlobalTokenStats(): AggregatedTokenStats {\n  return tokenStatsManager.getGlobalStats()\n}\n\n/**\n * Get token statistics for a specific agent\n */\nexport function getAgentTokenStats(\n  agentId: string,\n): AggregatedTokenStats | null {\n  return tokenStatsManager.getAgentStats(agentId)\n}\n\n/**\n * Estimate token count from text\n */\nexport function estimateTokenCount(text: string): number {\n  return tokenStatsManager.estimateTokens(text)\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/core/tools/executor.js

@@ -1,143 +0,0 @@
-class ToolExecutor {
-  permissionEngine;
-  constructor(permissionEngine) {
-    this.permissionEngine = permissionEngine;
-  }
-  /**
-   * Set the permission engine
-   */
-  setPermissionEngine(engine) {
-    this.permissionEngine = engine;
-  }
-  /**
-   * Execute a tool
-   */
-  async *execute(tool, input, context, options = {}) {
-    const startTime = Date.now();
-    try {
-      if (!options.skipValidation) {
-        const validationResult = this.validateInput(tool, input, context);
-        if (!validationResult.result) {
-          yield {
-            type: "error",
-            error: new Error(
-              validationResult.message || "Input validation failed"
-            )
-          };
-          return;
-        }
-      }
-      if (!options.skipPermissionCheck && this.permissionEngine) {
-        const permissionResult = await this.checkPermission(
-          tool,
-          input,
-          context,
-          options.permissionContext
-        );
-        if (!permissionResult.allowed) {
-          yield {
-            type: "error",
-            error: new Error(permissionResult.reason || "Permission denied")
-          };
-          return;
-        }
-        if (permissionResult.promptUser) {
-          yield {
-            type: "result",
-            resultForAssistant: permissionResult.message || "Permission required"
-          };
-          return;
-        }
-      }
-      const generator = tool.call(input, context);
-      if (options.timeout) {
-        const timeoutPromise = new Promise((_, reject) => {
-          setTimeout(
-            () => reject(
-              new Error(
-                `Tool execution timed out after ${options.timeout}ms`
-              )
-            ),
-            options.timeout
-          );
-        });
-        for await (const result of generator) {
-          if (Date.now() - startTime > options.timeout) {
-            yield {
-              type: "error",
-              error: new Error(
-                `Tool execution timed out after ${options.timeout}ms`
-              )
-            };
-            return;
-          }
-          yield result;
-        }
-      } else {
-        for await (const result of generator) {
-          yield result;
-        }
-      }
-    } catch (error) {
-      yield {
-        type: "error",
-        error: error instanceof Error ? error : new Error(String(error))
-      };
-    }
-  }
-  /**
-   * Validate tool input
-   */
-  validateInput(tool, input, context) {
-    const schemaResult = tool.inputSchema.safeParse(input);
-    if (!schemaResult.success) {
-      return {
-        result: false,
-        message: `Input validation failed: ${schemaResult.error.message}`
-      };
-    }
-    if (tool.validateInput) {
-      const customResult = tool.validateInput(input, context);
-      if (customResult instanceof Promise) {
-        return { result: true };
-      }
-      return customResult;
-    }
-    return { result: true };
-  }
-  /**
-   * Check tool permissions
-   */
-  async checkPermission(tool, input, context, extra) {
-    if (!this.permissionEngine) {
-      return { allowed: true };
-    }
-    const permissionContext = {
-      tool,
-      input,
-      toolUseContext: context,
-      allowedTools: context.options?.allowedTools || [],
-      safeMode: context.options?.safeMode,
-      planMode: context.options?.planMode,
-      agentId: context.options?.agentId,
-      ...extra
-    };
-    return this.permissionEngine.checkPermission(permissionContext);
-  }
-}
-let globalExecutor = null;
-function getToolExecutor() {
-  if (!globalExecutor) {
-    globalExecutor = new ToolExecutor();
-  }
-  return globalExecutor;
-}
-function resetToolExecutor() {
-  globalExecutor = null;
-}
-export {
-  ToolExecutor,
-  getToolExecutor,
-  resetToolExecutor
-};
-//# sourceMappingURL=executor.js.map

package/dist/core/tools/executor.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/core/tools/executor.ts"],
-  "sourcesContent": ["/**\n * Tool Executor\n *\n * Handles tool execution with validation, permission checking, and error handling.\n */\n\nimport type {\n  RegisterableTool,\n  ToolExecutionContext,\n  ToolExecutionResult,\n} from './types'\nimport type { PermissionEngine } from '../permissions/engine/permissionEngine'\nimport type { PermissionContext } from '../permissions/engine/types'\n\n/**\n * Execution options\n */\nexport interface ExecutionOptions {\n  /** Skip permission check */\n  skipPermissionCheck?: boolean\n\n  /** Skip input validation */\n  skipValidation?: boolean\n\n  /** Timeout in milliseconds */\n  timeout?: number\n\n  /** Custom permission context data */\n  permissionContext?: Partial<PermissionContext>\n}\n\n/**\n * Tool Executor\n *\n * Executes tools with proper validation and permission checking.\n */\nexport class ToolExecutor {\n  private permissionEngine?: PermissionEngine\n\n  constructor(permissionEngine?: PermissionEngine) {\n    this.permissionEngine = permissionEngine\n  }\n\n  /**\n   * Set the permission engine\n   */\n  setPermissionEngine(engine: PermissionEngine): void {\n    this.permissionEngine = engine\n  }\n\n  /**\n   * Execute a tool\n   */\n  async *execute<TInput, TOutput>(\n    tool: RegisterableTool<TInput, TOutput>,\n    input: TInput,\n    context: ToolExecutionContext,\n    options: ExecutionOptions = {},\n  ): AsyncGenerator<ToolExecutionResult<TOutput>> {\n    const startTime = Date.now()\n\n    try {\n      // Step 1: Validate input\n      if (!options.skipValidation) {\n        const validationResult = this.validateInput(tool, input, context)\n        if (!validationResult.result) {\n          yield {\n            type: 'error',\n            error: new Error(\n              validationResult.message || 'Input validation failed',\n            ),\n          }\n          return\n        }\n      }\n\n      // Step 2: Check permissions\n      if (!options.skipPermissionCheck && this.permissionEngine) {\n        const permissionResult = await this.checkPermission(\n          tool,\n          input as Record<string, unknown>,\n          context,\n          options.permissionContext,\n        )\n\n        if (!permissionResult.allowed) {\n          yield {\n            type: 'error',\n            error: new Error(permissionResult.reason || 'Permission denied'),\n          }\n          return\n        }\n\n        // Handle prompting user case\n        if (permissionResult.promptUser) {\n          yield {\n            type: 'result',\n            resultForAssistant:\n              permissionResult.message || 'Permission required',\n          }\n          return\n        }\n      }\n\n      // Step 3: Execute tool\n      const generator = tool.call(input, context)\n\n      // Step 4: Handle timeout if specified\n      if (options.timeout) {\n        const timeoutPromise = new Promise<never>((_, reject) => {\n          setTimeout(\n            () =>\n              reject(\n                new Error(\n                  `Tool execution timed out after ${options.timeout}ms`,\n                ),\n              ),\n            options.timeout,\n          )\n        })\n\n        // Yield results with timeout checking\n        for await (const result of generator) {\n          // Check if we've exceeded timeout\n          if (Date.now() - startTime > options.timeout) {\n            yield {\n              type: 'error',\n              error: new Error(\n                `Tool execution timed out after ${options.timeout}ms`,\n              ),\n            }\n            return\n          }\n          yield result\n        }\n      } else {\n        // No timeout, just yield results\n        for await (const result of generator) {\n          yield result\n        }\n      }\n    } catch (error) {\n      yield {\n        type: 'error',\n        error: error instanceof Error ? error : new Error(String(error)),\n      }\n    }\n  }\n\n  /**\n   * Validate tool input\n   */\n  private validateInput<TInput>(\n    tool: RegisterableTool<TInput>,\n    input: TInput,\n    context: ToolExecutionContext,\n  ): { result: boolean; message?: string } {\n    // Schema validation\n    const schemaResult = tool.inputSchema.safeParse(input)\n    if (!schemaResult.success) {\n      return {\n        result: false,\n        message: `Input validation failed: ${schemaResult.error.message}`,\n      }\n    }\n\n    // Custom validation\n    if (tool.validateInput) {\n      const customResult = tool.validateInput(input, context)\n      if (customResult instanceof Promise) {\n        // For sync executor, we can't await here\n        // This should be handled by execute() method\n        return { result: true }\n      }\n      return customResult\n    }\n\n    return { result: true }\n  }\n\n  /**\n   * Check tool permissions\n   */\n  private async checkPermission(\n    tool: RegisterableTool,\n    input: Record<string, unknown>,\n    context: ToolExecutionContext,\n    extra?: Partial<PermissionContext>,\n  ): Promise<{\n    allowed: boolean\n    reason?: string\n    message?: string\n    promptUser?: boolean\n  }> {\n    if (!this.permissionEngine) {\n      return { allowed: true }\n    }\n\n    const permissionContext: PermissionContext = {\n      tool: tool as any,\n      input,\n      toolUseContext: context as any,\n      allowedTools: (context.options?.allowedTools as string[]) || [],\n      safeMode: context.options?.safeMode,\n      planMode: context.options?.planMode,\n      agentId: context.options?.agentId,\n      ...extra,\n    }\n\n    return this.permissionEngine.checkPermission(permissionContext)\n  }\n}\n\n// Global singleton instance\nlet globalExecutor: ToolExecutor | null = null\n\n/**\n * Get the global tool executor instance\n */\nexport function getToolExecutor(): ToolExecutor {\n  if (!globalExecutor) {\n    globalExecutor = new ToolExecutor()\n  }\n  return globalExecutor\n}\n\n/**\n * Reset the global tool executor (for testing)\n */\nexport function resetToolExecutor(): void {\n  globalExecutor = null\n}\n"],
-  "mappings": "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",
-  "names": []
-}

package/dist/core/tools/index.js

@@ -1,15 +0,0 @@
-import { ToolRegistry, getToolRegistry, resetToolRegistry } from "./registry.js";
-import {
-  ToolExecutor,
-  getToolExecutor,
-  resetToolExecutor
-} from "./executor.js";
-export {
-  ToolExecutor,
-  ToolRegistry,
-  getToolExecutor,
-  getToolRegistry,
-  resetToolExecutor,
-  resetToolRegistry
-};
-//# sourceMappingURL=index.js.map

package/dist/core/tools/index.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/core/tools/index.ts"],
-  "sourcesContent": ["/**\n * Core Tools Module\n *\n * Tool registry, executor, and type definitions.\n */\n\n// Types\nexport type {\n  ToolCategory,\n  ToolMetadata,\n  ToolExecutionContext,\n  ToolExecutionResult,\n  RegisterableTool,\n} from './types'\n\n// Registry\nexport { ToolRegistry, getToolRegistry, resetToolRegistry } from './registry'\n\n// Executor\nexport {\n  ToolExecutor,\n  getToolExecutor,\n  resetToolExecutor,\n  type ExecutionOptions,\n} from './executor'\n"],
-  "mappings": "AAgBA,SAAS,cAAc,iBAAiB,yBAAyB;AAGjE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
-  "names": []
-}