@ agent-inspect/index-sqlite (英语)

可选、可支配 本地 SQLite 索引 用于更快的询问 代理检查 JSONL的痕迹.

支助级别: 贝塔——见 支助。网络行为 : 网络-银行。 。 。 .

• 仅限本地 : 没有网络,没有默认上传.
• JSONL 保持真理的来源. 该索引是一个衍生缓存,总是可以安全删除.
• 从不突变跟踪文件.
• 跨平台的本土安装只有在经过测试的情况下才被索赔——见收养证据/包烟.

安装

npm install agent-inspect @agent-inspect/index-sqlite

agent-inspect 是同级依赖. better-sqlite3 捆绑为依赖(预建的二进制;节点 QQ 20).

使用量

import {
  buildIndex,
  queryRuns,
  indexStatus,
  cleanIndex,
  resolveIndexDbPath,
} from "@agent-inspect/index-sqlite";

// Build (or fully rebuild — idempotent) from a trace directory.
const result = await buildIndex({ traceDir: ".agent-inspect/runs" });
console.log(result.runs, result.steps, result.dbPath);

// Fast queries against the index (falls back to [] if missing/corrupt).
const failed = queryRuns(result.dbPath, { status: "error", limit: 20 });
const withTool = queryRuns(result.dbPath, { tool: "search", kind: "tool" });

// Status and cleanup.
console.log(indexStatus(result.dbPath));
await cleanIndex(resolveIndexDbPath(".agent-inspect/runs"));

行为

• 重建为一能: 用相同的输入值建出两次,结果内容相同.
• 腐败的恢复: 失踪或 integrity_check-fashing数据库被视为不存在;查询返回为空并重建重建.
• 断层: isIndexStale(dbPath, newestTraceMtimeMs) 当痕迹比索引更新时,报告.
• 可处理 : 删除数据库绝不影响痕迹 .

边界

• 没有 SQLite 依赖性 agent-inspect 核心或根——它只住在这里.
• 没有矢量/语义搜索,没有守护进程,没有远程服务.

版本

部分固定代理监取放行. 参见当前版本的npm徽章/包表.