npm install @tpmjs/tools-coverage-tracker

import { coverageTrackerTool } from '@tpmjs/tools-coverage-tracker';
import { generateText } from 'ai';

const result = await generateText({
  model: yourModel,
  tools: {
    trackCoverage: coverageTrackerTool,
  },
  prompt: 'Track tool usage coverage...',
});

import { coverageTrackerTool } from '@tpmjs/tools-coverage-tracker';

const result = await coverageTrackerTool.execute({
  availableTools: ['searchWeb', 'fetchUrl', 'summarize', 'translateText', 'saveNote'],
  usedTools: ['searchWeb', 'fetchUrl', 'searchWeb', 'summarize'],
});

console.log(result);
// {
//   coverage: 0.6,
//   usedCount: 3,
//   totalCount: 5,
//   unusedTools: ['translateText', 'saveNote'],
//   usedTools: [
//     { name: 'searchWeb', used: true, usageCount: 2 },
//     { name: 'fetchUrl', used: true, usageCount: 1 },
//     { name: 'summarize', used: true, usageCount: 1 }
//   ],
//   coveragePercent: '60.0%',
//   summary: 'Coverage: 60.0% (3/5 tools) | Unused: translateText, saveNote'
// }

{
  availableTools: string[];  // All available tool names
  usedTools: string[];       // Tools that were actually used (can include duplicates)
}

{
  coverage: number;               // Coverage ratio (0-1)
  usedCount: number;              // Number of unique tools used
  totalCount: number;             // Total number of available tools
  unusedTools: string[];          // List of tools not used
  usedTools: Array<{              // List of used tools with stats
    name: string;                 // Tool name
    used: boolean;                // Always true for this array
    usageCount: number;           // How many times it was called
  }>;
  coveragePercent: string;        // Formatted percentage (e.g., "75.0%")
  summary: string;                // Human-readable summary
}

const availableTools = ['search', 'analyze', 'summarize', 'report'];
const usedTools = ['search', 'analyze', 'report'];

const coverage = await coverageTrackerTool.execute({
  availableTools,
  usedTools,
});

if (coverage.coverage < 0.75) {
  console.warn('Low tool coverage - workflow may be incomplete');
}

const result = await coverageTrackerTool.execute({
  availableTools: ['tool1', 'tool2', 'tool3', 'tool4'],
  usedTools: ['tool1', 'tool1', 'tool1', 'tool2', 'tool2', 'tool3'],
});

// result.usedTools sorted by usage:
// [
//   { name: 'tool1', usageCount: 3 },
//   { name: 'tool2', usageCount: 2 },
//   { name: 'tool3', usageCount: 1 },
// ]
// result.unusedTools: ['tool4']

const testRuns = [
  { name: 'Test 1', used: ['searchWeb', 'fetchUrl'] },
  { name: 'Test 2', used: ['searchWeb', 'summarize'] },
  { name: 'Test 3', used: ['translateText'] },
];

const allTools = ['searchWeb', 'fetchUrl', 'summarize', 'translateText'];

for (const run of testRuns) {
  const coverage = await coverageTrackerTool.execute({
    availableTools: allTools,
    usedTools: run.used,
  });
  console.log(`${run.name}: ${coverage.coveragePercent}`);
}

const coverage = await coverageTrackerTool.execute({
  availableTools: ['common', 'rare', 'legacy', 'deprecated'],
  usedTools: ['common', 'common', 'common', 'rare'],
});

// coverage.unusedTools: ['legacy', 'deprecated']
// Consider removing these tools

const result = await coverageTrackerTool.execute({
  availableTools: ['api1', 'api2'],
  usedTools: ['api1', 'api1', 'api1', 'api2'],
});

// result.usedTools[0] = { name: 'api1', usageCount: 3 }
// result.usedTools[1] = { name: 'api2', usageCount: 1 }

const result = await coverageTrackerTool.execute({
  availableTools: ['tool1', 'tool2'],
  usedTools: ['tool1', 'unknownTool'],
});

// result.summary: "... | Warning: 1 unknown tool(s) used"

const result = await coverageTrackerTool.execute({
  availableTools: ['a', 'b', 'c'],
  usedTools: ['a', 'b', 'c'],
});
// coverage.coverage = 1.0
// coverage.coveragePercent = "100.0%"
// coverage.unusedTools = []

const result = await coverageTrackerTool.execute({
  availableTools: ['search', 'fetch', 'save', 'analyze'],
  usedTools: ['search', 'fetch'],
});
// coverage.coverage = 0.5
// coverage.usedCount = 2
// coverage.unusedTools = ['save', 'analyze']

const result = await coverageTrackerTool.execute({
  availableTools: ['tool1', 'tool2'],
  usedTools: [],
});
// coverage.coverage = 0
// coverage.unusedTools = ['tool1', 'tool2']