tpmjs

✨ TPMJS：AI 工具的 npm 一站式注册表 ✨

TPMJS (Tool Package Manager for JavaScript) 是一个专为 AI SDK 工具设计的开放注册表。它致力于简化 AI 工具的发布、发现和使用流程，让开发者和智能代理能够更高效地协作。

💡 核心理念：将 AI 工具注册到 npm，TPMJS 自动索引，让你的工具被更多人发现和使用。

---

🚀 为开发者：轻松发布，即刻可见

想要让你的 AI 工具拥有更广阔的舞台？TPMJS 提供了一个极其便捷的发布方式：

• 只需在 package.json 中添加 tpmjs-tool 关键词。
• 提供最少的元数据（如类别 category），TPMJS 会自动提取工具定义。
• 发布到 npm 后，你的工具将在 2-15 分钟内自动被索引，并出现在 tpmjs.com 上。

这不仅节省了手动录入的繁琐，更让你的工具在 AI 社区中瞬间可见，被 Vercel AI SDK、LangChain 等主流框架轻松集成。

---

🤖 为 AI 代理：智能发现，安全执行

TPMJS 赋予智能代理强大的“搜索”和“执行”能力，无需手动导入，即可直接访问海量工具库：

• 动态发现：代理能够根据任务需求，智能搜索并发现 TPMJS 注册表中的相关工具。
• 安全沙盒执行：所有工具都在隔离的 Deno 运行时中执行，确保安全，不干预本地文件系统或环境。API 密钥按请求传递，永不存储。
• 无缝集成：与 Vercel AI SDK、LangChain、LlamaIndex 等框架 natively 兼容，让工具能力触手可及。

---

🎯 我们的独特优势

• 🔍 自动发现机制：
  • 实时监控 npm 变更流，结合关键词搜索和人工精选。
  • 工具发布 npm 后，2-15 分钟内自动索引。
• 🛡️ 严格验证与 Schema 提取：
  • 自动验证包的有效性，并从工具代码中提取输入 Schema。
  • 支持从 Zod schema 自动提取参数，无需手动文档。
• 💯 质量评分体系：
  • 根据元数据完整性、npm 下载量和 GitHub Star 数对工具进行评分。
  • 高分工具在搜索结果中拥有更高可见度。
• 💚 健康监测：
  • 持续检查工具的导入和执行状态，确保其可用性。
  • 标记并过滤掉损坏的工具。
• ⚡ 零配置动态加载：
  • 结合 BM25 搜索和上下文感知，智能识别最相关工具。
  • 按需从 esm.sh 加载工具，并在沙盒环境中即时执行。

---

🛠️ 快速上手指南 (适用于 AI 代理)

1. 安装 SDK 包：

   npm install @tpmjs/registry-search @tpmjs/registry-execute

2. 集成到您的代理：

   import { streamText } from 'ai';
   import { anthropic } from '@ai-sdk/anthropic';
   import { registrySearchTool } from '@tpmjs/registry-search';
   import { registryExecuteTool } from '@tpmjs/registry-execute';
   
   const result = await streamText({
     model: anthropic('claude-sonnet-4-20250514'),
     tools: {
       registrySearch: registrySearchTool,
       registryExecute: registryExecuteTool,
     },
     system: `You have access to thousands of tools via the TPMJS registry.
   Use registrySearch to find tools, then registryExecute to run them.`,
     prompt: 'Search for web scraping tools and scrape example.com',
   });

3. 完成！✨ 您的代理现在可以发现并执行 TPMJS 注册表中的任何工具。