@within-7/minto 0.1.7 → 0.3.0

package/dist/core/tokenStatsManager.js

@@ -0,0 +1,331 @@
+import { EventEmitter } from "events";
+import { DEFAULT_ESTIMATION_CONFIG } from "./tokenStats.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();
+  }
+}
+const tokenStatsManager = TokenStatsManagerImpl.getInstance();
+function recordTokenUsage(usage, costUSD, model, context) {
+  tokenStatsManager.recordUsage(usage, costUSD, model, context);
+}
+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

@@ -0,0 +1,7 @@
+{
+  "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'\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  }\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 */\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\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

@@ -0,0 +1,143 @@
+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

@@ -0,0 +1,7 @@
+{
+  "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

@@ -0,0 +1,15 @@
+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

@@ -0,0 +1,7 @@
+{
+  "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": []
+}