@metamask-previews/tooling-insight 1.0.1-preview-898fae5

package/dist/lib/allowlist.mjs

@@ -0,0 +1,155 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const ENV_METAMASK_SKILLS_DIR = 'METAMASK_SKILLS_DIR';
+const ENV_CONSENSYS_SKILLS_DIR = 'CONSENSYS_SKILLS_DIR';
+/**
+ * Thin wrapper around `execFileSync` used as the default git executor.
+ *
+ * @param file - The git executable path.
+ * @param args - Arguments to pass to git.
+ * @param options - Execution options including cwd and encoding.
+ * @param options.cwd - Optional working directory for the git command.
+ * @param options.encoding - Output encoding; must be `'utf8'`.
+ * @returns The stdout of the git command as a UTF-8 string.
+ */
+function defaultExecGit(file, args, options) {
+    return execFileSync(file, args, options);
+}
+/**
+ * Walk up from `startDir` until a directory containing `package.json` is found.
+ *
+ * @param startDir - Directory to start the search from.
+ * @returns The repo root directory, or `startDir` if no `package.json` is found.
+ */
+export function findRepoRoot(startDir) {
+    let current = startDir;
+    while (true) {
+        if (existsSync(join(current, 'package.json'))) {
+            return current;
+        }
+        const parent = join(current, '..');
+        if (parent === current) {
+            return startDir;
+        }
+        current = parent;
+    }
+}
+/**
+ * Parse the `.skills.local` key-value override file in the repo root.
+ *
+ * @param repoRoot - Absolute path to the repo root containing `.skills.local`.
+ * @returns A map of key-value pairs from the local skills override file.
+ */
+function parseSkillsLocal(repoRoot) {
+    const path = join(repoRoot, '.skills.local');
+    if (!existsSync(path)) {
+        return {};
+    }
+    const entries = {};
+    for (const line of readFileSync(path, 'utf8').split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const eq = trimmed.indexOf('=');
+        if (eq === -1) {
+            continue;
+        }
+        entries[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();
+    }
+    return entries;
+}
+/**
+ * Resolve the absolute path for a skills directory from multiple sources in priority order:
+ * environment variable → `.skills.local` key → cached directory.
+ *
+ * @param envKey - Environment variable name to check first.
+ * @param skillsLocalKey - Key to look up in `.skills.local`.
+ * @param repoRoot - Repo root for `.skills.local` and fallback resolution.
+ * @param defaultRelative - Optional relative path to a cached skills directory under the repo root.
+ * @returns Absolute path to the skills directory, or `null` if unresolvable.
+ */
+function resolveSkillsDir(envKey, skillsLocalKey, repoRoot, defaultRelative) {
+    if (process.env[envKey]) {
+        return process.env[envKey];
+    }
+    const local = parseSkillsLocal(repoRoot)[skillsLocalKey];
+    if (local) {
+        return local;
+    }
+    if (defaultRelative) {
+        const cached = join(repoRoot, defaultRelative);
+        if (existsSync(cached)) {
+            return cached;
+        }
+    }
+    return null;
+}
+/**
+ * Extract skill names from `git ls-tree` output by matching the `skill.md` path pattern.
+ *
+ * @param gitOutput - Raw `ls-tree` output from git.
+ * @returns An array of skill names prefixed with `mms-`.
+ */
+function extractSkillNames(gitOutput) {
+    const names = [];
+    for (const line of gitOutput.split('\n')) {
+        const match = line.match(/^domains\/[^/]+\/skills\/([^/]+)\/skill\.md$/u);
+        if (match) {
+            names.push(`mms-${match[1]}`);
+        }
+    }
+    return names;
+}
+/**
+ * List skill names by running `git ls-tree` against the skills git repository.
+ *
+ * @param dir - Absolute path to the skills git repository.
+ * @param execGit - Git executor function.
+ * @returns An array of skill names found in the skills repository.
+ */
+function readSkillsFromDir(dir, execGit) {
+    const output = execGit('git', ['-C', dir, 'ls-tree', '-r', '--name-only', 'main', '--', 'domains'], { encoding: 'utf8' });
+    return extractSkillNames(output);
+}
+/**
+ * Read yarn script names from the consuming repo's `main` branch `package.json`.
+ *
+ * @param repoRoot - Absolute path to the consuming repo root.
+ * @param execGit - Git executor function.
+ * @returns An array of yarn script names from the consuming repo's main branch.
+ */
+function readYarnScripts(repoRoot, execGit) {
+    const output = execGit('git', ['show', 'main:package.json'], {
+        cwd: repoRoot,
+        encoding: 'utf8',
+    });
+    const parsed = JSON.parse(output);
+    return Object.keys(parsed.scripts ?? {});
+}
+/**
+ * Read skill and yarn-script allowlists from local git refs.
+ * Private skills repo is optional; public skills + package.json scripts are required.
+ *
+ * @param options - Optional overrides for repo root and git executor.
+ * @returns The combined allowlist of skill names and yarn script names.
+ */
+export function readAllowlist(options = {}) {
+    const repoRoot = options.repoRoot ?? findRepoRoot(process.cwd());
+    const execGit = options.execGit ?? defaultExecGit;
+    const publicDir = resolveSkillsDir(ENV_METAMASK_SKILLS_DIR, 'METAMASK_SKILLS_DIR', repoRoot, '.skills-cache/metamask-skills');
+    if (!publicDir) {
+        throw new Error('MetaMask skills source directory could not be resolved');
+    }
+    const privateDir = resolveSkillsDir(ENV_CONSENSYS_SKILLS_DIR, 'CONSENSYS_SKILLS_DIR', repoRoot);
+    const skills = new Set(readSkillsFromDir(publicDir, execGit));
+    if (privateDir) {
+        for (const name of readSkillsFromDir(privateDir, execGit)) {
+            skills.add(name);
+        }
+    }
+    const scripts = new Set(readYarnScripts(repoRoot, execGit));
+    return { skills, scripts };
+}
+//# sourceMappingURL=allowlist.mjs.map

package/dist/lib/allowlist.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.mjs","sourceRoot":"","sources":["../../src/lib/allowlist.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFileSync } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport type { Allowlist } from './types';\n\nconst ENV_METAMASK_SKILLS_DIR = 'METAMASK_SKILLS_DIR';\nconst ENV_CONSENSYS_SKILLS_DIR = 'CONSENSYS_SKILLS_DIR';\n\n/** Signature of the git executor passed to allowlist readers, matching `execFileSync`. */\nexport type ExecGit = (\n  file: string,\n  args: readonly string[],\n  options: {\n    /** Optional working directory for the git command. */\n    cwd?: string;\n    /** Output encoding; must be `'utf8'`. */\n    encoding: 'utf8';\n  },\n) => string;\n\n/** Options for `readAllowlist`. */\nexport type AllowlistOptions = {\n  /** Absolute path to the repo root; defaults to `findRepoRoot(process.cwd())`. */\n  repoRoot?: string;\n  /** Git executor; defaults to the real `execFileSync` wrapper. */\n  execGit?: ExecGit;\n};\n\n/**\n * Thin wrapper around `execFileSync` used as the default git executor.\n *\n * @param file - The git executable path.\n * @param args - Arguments to pass to git.\n * @param options - Execution options including cwd and encoding.\n * @param options.cwd - Optional working directory for the git command.\n * @param options.encoding - Output encoding; must be `'utf8'`.\n * @returns The stdout of the git command as a UTF-8 string.\n */\nfunction defaultExecGit(\n  file: string,\n  args: readonly string[],\n  options: {\n    /** Optional working directory for the git command. */\n    cwd?: string;\n    /** Output encoding; must be `'utf8'`. */\n    encoding: 'utf8';\n  },\n): string {\n  return execFileSync(file, args, options);\n}\n\n/**\n * Walk up from `startDir` until a directory containing `package.json` is found.\n *\n * @param startDir - Directory to start the search from.\n * @returns The repo root directory, or `startDir` if no `package.json` is found.\n */\nexport function findRepoRoot(startDir: string): string {\n  let current = startDir;\n  while (true) {\n    if (existsSync(join(current, 'package.json'))) {\n      return current;\n    }\n    const parent = join(current, '..');\n    if (parent === current) {\n      return startDir;\n    }\n    current = parent;\n  }\n}\n\n/**\n * Parse the `.skills.local` key-value override file in the repo root.\n *\n * @param repoRoot - Absolute path to the repo root containing `.skills.local`.\n * @returns A map of key-value pairs from the local skills override file.\n */\nfunction parseSkillsLocal(repoRoot: string): Record<string, string> {\n  const path = join(repoRoot, '.skills.local');\n  if (!existsSync(path)) {\n    return {};\n  }\n  const entries: Record<string, string> = {};\n  for (const line of readFileSync(path, 'utf8').split('\\n')) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) {\n      continue;\n    }\n    const eq = trimmed.indexOf('=');\n    if (eq === -1) {\n      continue;\n    }\n    entries[trimmed.slice(0, eq).trim()] = trimmed.slice(eq + 1).trim();\n  }\n  return entries;\n}\n\n/**\n * Resolve the absolute path for a skills directory from multiple sources in priority order:\n * environment variable → `.skills.local` key → cached directory.\n *\n * @param envKey - Environment variable name to check first.\n * @param skillsLocalKey - Key to look up in `.skills.local`.\n * @param repoRoot - Repo root for `.skills.local` and fallback resolution.\n * @param defaultRelative - Optional relative path to a cached skills directory under the repo root.\n * @returns Absolute path to the skills directory, or `null` if unresolvable.\n */\nfunction resolveSkillsDir(\n  envKey: string,\n  skillsLocalKey: string,\n  repoRoot: string,\n  defaultRelative?: string,\n): string | null {\n  if (process.env[envKey]) {\n    return process.env[envKey];\n  }\n  const local = parseSkillsLocal(repoRoot)[skillsLocalKey];\n  if (local) {\n    return local;\n  }\n  if (defaultRelative) {\n    const cached = join(repoRoot, defaultRelative);\n    if (existsSync(cached)) {\n      return cached;\n    }\n  }\n  return null;\n}\n\n/**\n * Extract skill names from `git ls-tree` output by matching the `skill.md` path pattern.\n *\n * @param gitOutput - Raw `ls-tree` output from git.\n * @returns An array of skill names prefixed with `mms-`.\n */\nfunction extractSkillNames(gitOutput: string): string[] {\n  const names: string[] = [];\n  for (const line of gitOutput.split('\\n')) {\n    const match = line.match(/^domains\\/[^/]+\\/skills\\/([^/]+)\\/skill\\.md$/u);\n    if (match) {\n      names.push(`mms-${match[1]}`);\n    }\n  }\n  return names;\n}\n\n/**\n * List skill names by running `git ls-tree` against the skills git repository.\n *\n * @param dir - Absolute path to the skills git repository.\n * @param execGit - Git executor function.\n * @returns An array of skill names found in the skills repository.\n */\nfunction readSkillsFromDir(dir: string, execGit: ExecGit): string[] {\n  const output = execGit(\n    'git',\n    ['-C', dir, 'ls-tree', '-r', '--name-only', 'main', '--', 'domains'],\n    { encoding: 'utf8' },\n  );\n  return extractSkillNames(output);\n}\n\n/**\n * Read yarn script names from the consuming repo's `main` branch `package.json`.\n *\n * @param repoRoot - Absolute path to the consuming repo root.\n * @param execGit - Git executor function.\n * @returns An array of yarn script names from the consuming repo's main branch.\n */\nfunction readYarnScripts(repoRoot: string, execGit: ExecGit): string[] {\n  const output = execGit('git', ['show', 'main:package.json'], {\n    cwd: repoRoot,\n    encoding: 'utf8',\n  });\n  const parsed = JSON.parse(output) as {\n    /** Map of yarn script names to their shell commands. */\n    scripts?: Record<string, string>;\n  };\n  return Object.keys(parsed.scripts ?? {});\n}\n\n/**\n * Read skill and yarn-script allowlists from local git refs.\n * Private skills repo is optional; public skills + package.json scripts are required.\n *\n * @param options - Optional overrides for repo root and git executor.\n * @returns The combined allowlist of skill names and yarn script names.\n */\nexport function readAllowlist(options: AllowlistOptions = {}): Allowlist {\n  const repoRoot = options.repoRoot ?? findRepoRoot(process.cwd());\n  const execGit = options.execGit ?? defaultExecGit;\n\n  const publicDir = resolveSkillsDir(\n    ENV_METAMASK_SKILLS_DIR,\n    'METAMASK_SKILLS_DIR',\n    repoRoot,\n    '.skills-cache/metamask-skills',\n  );\n  if (!publicDir) {\n    throw new Error('MetaMask skills source directory could not be resolved');\n  }\n\n  const privateDir = resolveSkillsDir(\n    ENV_CONSENSYS_SKILLS_DIR,\n    'CONSENSYS_SKILLS_DIR',\n    repoRoot,\n  );\n\n  const skills = new Set<string>(readSkillsFromDir(publicDir, execGit));\n  if (privateDir) {\n    for (const name of readSkillsFromDir(privateDir, execGit)) {\n      skills.add(name);\n    }\n  }\n\n  const scripts = new Set<string>(readYarnScripts(repoRoot, execGit));\n\n  return { skills, scripts };\n}\n"]}

package/dist/lib/csv.cjs

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readAllEvents = readAllEvents;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const paths_1 = require("./paths.cjs");
+const CSV_HEADER = 'tool_name,tool_type,event_type,agent_vendor,session_id,success,duration_ms,created_at';
+/**
+ * Strip the `-events.log` suffix from an event log filename to derive the repo name.
+ *
+ * @param filename - Event log filename (e.g. `metamask-mobile-events.log`).
+ * @returns The repo name portion (filename without the `-events.log` suffix).
+ */
+function repoFromFilename(filename) {
+    return filename.replace(/-events\.log$/u, '');
+}
+/**
+ * Parse the raw `success` CSV column into a boolean or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns `true`, `false`, or `null` when the value is unrecognised or empty.
+ */
+function parseSuccess(raw) {
+    if (raw === '') {
+        return null;
+    }
+    if (raw === 'true') {
+        return true;
+    }
+    if (raw === 'false') {
+        return false;
+    }
+    return null;
+}
+/**
+ * Parse the raw `duration_ms` CSV column into a number or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns A finite numeric duration, or `null` when the value is empty or non-numeric.
+ */
+function parseDuration(raw) {
+    if (raw === '') {
+        return null;
+    }
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+/**
+ * Parse the raw `tool_type` CSV column into a `ToolType` or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns The parsed `ToolType`, or `null` for unrecognised values.
+ */
+function parseToolType(raw) {
+    if (raw === 'skill' || raw === 'yarn_script') {
+        return raw;
+    }
+    return null;
+}
+/**
+ * Parse the raw `event_type` CSV column into a `CsvEventType` or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns The parsed `CsvEventType`, or `null` for unrecognised values.
+ */
+function parseEventType(raw) {
+    if (raw === 'start' || raw === 'end' || raw === 'interrupted') {
+        return raw;
+    }
+    return null;
+}
+/**
+ * Parse a single CSV row into a `ToolEvent`, or null for invalid rows.
+ *
+ * @param line - A raw CSV row string.
+ * @param repo - The repo name derived from the log filename.
+ * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.
+ * @returns The parsed `ToolEvent`, or `null` for header, malformed, or filtered rows.
+ */
+function parseRow(line, repo, onMalformedRow) {
+    // The collector writes a fixed, controlled schema with no quoted/escaped
+    // fields, so a naive comma split is sufficient (and intentional).
+    const rawParts = line.split(',');
+    if (rawParts.length < 8) {
+        onMalformedRow?.(line, 'expected 8 columns');
+        return null;
+    }
+    // Safe to assert: we checked length >= 8 above, but TypeScript can't narrow
+    // array destructuring based on a length guard.
+    const parts = rawParts;
+    const [tool_name, tool_typeRaw, event_typeRaw, agent_vendor, session_id, successRaw, durationRaw, created_at,] = parts;
+    const tool_type = parseToolType(tool_typeRaw);
+    const event_type = parseEventType(event_typeRaw);
+    if (!tool_name || !tool_type || !event_type || !created_at) {
+        onMalformedRow?.(line, 'missing required fields');
+        return null;
+    }
+    return {
+        repo,
+        tool_name,
+        tool_type,
+        event_type,
+        agent_vendor,
+        session_id,
+        success: parseSuccess(successRaw),
+        duration_ms: parseDuration(durationRaw),
+        created_at,
+    };
+}
+/**
+ * Read and parse all events from a single `*-events.log` file.
+ *
+ * @param filePath - Absolute path to the events log file.
+ * @param repo - The repo name associated with this file.
+ * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.
+ * @returns An array of parsed `ToolEvent` objects from the file.
+ */
+function readEventsFile(filePath, repo, onMalformedRow) {
+    const content = (0, node_fs_1.readFileSync)(filePath, 'utf8');
+    const lines = content.split('\n').filter((line) => line.trim() !== '');
+    const events = [];
+    for (const line of lines) {
+        if (line === CSV_HEADER || line.startsWith('tool_name,')) {
+            continue;
+        }
+        const event = parseRow(line, repo, onMalformedRow);
+        if (event) {
+            events.push(event);
+        }
+    }
+    return events;
+}
+/**
+ * Read all `*-events.log` files from the configured collection directory.
+ *
+ * @param options - Optional directory override and malformed-row callback.
+ * @returns All parsed `ToolEvent` objects from all log files in the directory.
+ */
+function readAllEvents(options = {}) {
+    const dir = options.logDir ?? (0, paths_1.getEventsLogDir)();
+    if (!(0, node_fs_1.existsSync)(dir)) {
+        return [];
+    }
+    const files = (0, node_fs_1.readdirSync)(dir).filter((name) => name.endsWith('-events.log'));
+    const events = [];
+    for (const filename of files.sort()) {
+        const repo = repoFromFilename(filename);
+        events.push(...readEventsFile((0, node_path_1.join)(dir, filename), repo, options.onMalformedRow));
+    }
+    return events;
+}
+//# sourceMappingURL=csv.cjs.map

package/dist/lib/csv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.cjs","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { getEventsLogDir } from './paths';\nimport type { CsvEventType, ToolEvent, ToolType } from './types';\n\nconst CSV_HEADER =\n  'tool_name,tool_type,event_type,agent_vendor,session_id,success,duration_ms,created_at';\n\n/** Options for `readAllEvents`. */\nexport type ReadAllEventsOptions = {\n  /** Override for the directory to scan; defaults to `getEventsLogDir()`. */\n  logDir?: string;\n  /** Called for each row that cannot be parsed into a `ToolEvent`. */\n  onMalformedRow?: (line: string, reason: string) => void;\n};\n\n/**\n * Strip the `-events.log` suffix from an event log filename to derive the repo name.\n *\n * @param filename - Event log filename (e.g. `metamask-mobile-events.log`).\n * @returns The repo name portion (filename without the `-events.log` suffix).\n */\nfunction repoFromFilename(filename: string): string {\n  return filename.replace(/-events\\.log$/u, '');\n}\n\n/**\n * Parse the raw `success` CSV column into a boolean or null.\n *\n * @param raw - Raw CSV column value.\n * @returns `true`, `false`, or `null` when the value is unrecognised or empty.\n */\nfunction parseSuccess(raw: string): boolean | null {\n  if (raw === '') {\n    return null;\n  }\n  if (raw === 'true') {\n    return true;\n  }\n  if (raw === 'false') {\n    return false;\n  }\n  return null;\n}\n\n/**\n * Parse the raw `duration_ms` CSV column into a number or null.\n *\n * @param raw - Raw CSV column value.\n * @returns A finite numeric duration, or `null` when the value is empty or non-numeric.\n */\nfunction parseDuration(raw: string): number | null {\n  if (raw === '') {\n    return null;\n  }\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Parse the raw `tool_type` CSV column into a `ToolType` or null.\n *\n * @param raw - Raw CSV column value.\n * @returns The parsed `ToolType`, or `null` for unrecognised values.\n */\nfunction parseToolType(raw: string): ToolType | null {\n  if (raw === 'skill' || raw === 'yarn_script') {\n    return raw;\n  }\n  return null;\n}\n\n/**\n * Parse the raw `event_type` CSV column into a `CsvEventType` or null.\n *\n * @param raw - Raw CSV column value.\n * @returns The parsed `CsvEventType`, or `null` for unrecognised values.\n */\nfunction parseEventType(raw: string): CsvEventType | null {\n  if (raw === 'start' || raw === 'end' || raw === 'interrupted') {\n    return raw;\n  }\n  return null;\n}\n\n/**\n * Parse a single CSV row into a `ToolEvent`, or null for invalid rows.\n *\n * @param line - A raw CSV row string.\n * @param repo - The repo name derived from the log filename.\n * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.\n * @returns The parsed `ToolEvent`, or `null` for header, malformed, or filtered rows.\n */\nfunction parseRow(\n  line: string,\n  repo: string,\n  onMalformedRow?: (line: string, reason: string) => void,\n): ToolEvent | null {\n  // The collector writes a fixed, controlled schema with no quoted/escaped\n  // fields, so a naive comma split is sufficient (and intentional).\n  const rawParts = line.split(',');\n  if (rawParts.length < 8) {\n    onMalformedRow?.(line, 'expected 8 columns');\n    return null;\n  }\n  // Safe to assert: we checked length >= 8 above, but TypeScript can't narrow\n  // array destructuring based on a length guard.\n  const parts = rawParts as [\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    ...string[],\n  ];\n\n  const [\n    tool_name,\n    tool_typeRaw,\n    event_typeRaw,\n    agent_vendor,\n    session_id,\n    successRaw,\n    durationRaw,\n    created_at,\n  ] = parts;\n\n  const tool_type = parseToolType(tool_typeRaw);\n  const event_type = parseEventType(event_typeRaw);\n\n  if (!tool_name || !tool_type || !event_type || !created_at) {\n    onMalformedRow?.(line, 'missing required fields');\n    return null;\n  }\n\n  return {\n    repo,\n    tool_name,\n    tool_type,\n    event_type,\n    agent_vendor,\n    session_id,\n    success: parseSuccess(successRaw),\n    duration_ms: parseDuration(durationRaw),\n    created_at,\n  };\n}\n\n/**\n * Read and parse all events from a single `*-events.log` file.\n *\n * @param filePath - Absolute path to the events log file.\n * @param repo - The repo name associated with this file.\n * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.\n * @returns An array of parsed `ToolEvent` objects from the file.\n */\nfunction readEventsFile(\n  filePath: string,\n  repo: string,\n  onMalformedRow?: (line: string, reason: string) => void,\n): ToolEvent[] {\n  const content = readFileSync(filePath, 'utf8');\n  const lines = content.split('\\n').filter((line) => line.trim() !== '');\n  const events: ToolEvent[] = [];\n\n  for (const line of lines) {\n    if (line === CSV_HEADER || line.startsWith('tool_name,')) {\n      continue;\n    }\n    const event = parseRow(line, repo, onMalformedRow);\n    if (event) {\n      events.push(event);\n    }\n  }\n\n  return events;\n}\n\n/**\n * Read all `*-events.log` files from the configured collection directory.\n *\n * @param options - Optional directory override and malformed-row callback.\n * @returns All parsed `ToolEvent` objects from all log files in the directory.\n */\nexport function readAllEvents(options: ReadAllEventsOptions = {}): ToolEvent[] {\n  const dir = options.logDir ?? getEventsLogDir();\n  if (!existsSync(dir)) {\n    return [];\n  }\n\n  const files = readdirSync(dir).filter((name) => name.endsWith('-events.log'));\n  const events: ToolEvent[] = [];\n\n  for (const filename of files.sort()) {\n    const repo = repoFromFilename(filename);\n    events.push(\n      ...readEventsFile(join(dir, filename), repo, options.onMalformedRow),\n    );\n  }\n\n  return events;\n}\n"]}

package/dist/lib/csv.d.cts

@@ -0,0 +1,16 @@
+import type { ToolEvent } from "./types.cjs";
+/** Options for `readAllEvents`. */
+export type ReadAllEventsOptions = {
+    /** Override for the directory to scan; defaults to `getEventsLogDir()`. */
+    logDir?: string;
+    /** Called for each row that cannot be parsed into a `ToolEvent`. */
+    onMalformedRow?: (line: string, reason: string) => void;
+};
+/**
+ * Read all `*-events.log` files from the configured collection directory.
+ *
+ * @param options - Optional directory override and malformed-row callback.
+ * @returns All parsed `ToolEvent` objects from all log files in the directory.
+ */
+export declare function readAllEvents(options?: ReadAllEventsOptions): ToolEvent[];
+//# sourceMappingURL=csv.d.cts.map

package/dist/lib/csv.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.cts","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,SAAS,EAAY,oBAAgB;AAKjE,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG;IACjC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD,CAAC;AAuKF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,EAAE,CAiB7E"}

package/dist/lib/csv.d.mts

@@ -0,0 +1,16 @@
+import type { ToolEvent } from "./types.mjs";
+/** Options for `readAllEvents`. */
+export type ReadAllEventsOptions = {
+    /** Override for the directory to scan; defaults to `getEventsLogDir()`. */
+    logDir?: string;
+    /** Called for each row that cannot be parsed into a `ToolEvent`. */
+    onMalformedRow?: (line: string, reason: string) => void;
+};
+/**
+ * Read all `*-events.log` files from the configured collection directory.
+ *
+ * @param options - Optional directory override and malformed-row callback.
+ * @returns All parsed `ToolEvent` objects from all log files in the directory.
+ */
+export declare function readAllEvents(options?: ReadAllEventsOptions): ToolEvent[];
+//# sourceMappingURL=csv.d.mts.map

package/dist/lib/csv.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.mts","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,SAAS,EAAY,oBAAgB;AAKjE,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG;IACjC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD,CAAC;AAuKF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,EAAE,CAiB7E"}

package/dist/lib/csv.mjs

@@ -0,0 +1,149 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { getEventsLogDir } from "./paths.mjs";
+const CSV_HEADER = 'tool_name,tool_type,event_type,agent_vendor,session_id,success,duration_ms,created_at';
+/**
+ * Strip the `-events.log` suffix from an event log filename to derive the repo name.
+ *
+ * @param filename - Event log filename (e.g. `metamask-mobile-events.log`).
+ * @returns The repo name portion (filename without the `-events.log` suffix).
+ */
+function repoFromFilename(filename) {
+    return filename.replace(/-events\.log$/u, '');
+}
+/**
+ * Parse the raw `success` CSV column into a boolean or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns `true`, `false`, or `null` when the value is unrecognised or empty.
+ */
+function parseSuccess(raw) {
+    if (raw === '') {
+        return null;
+    }
+    if (raw === 'true') {
+        return true;
+    }
+    if (raw === 'false') {
+        return false;
+    }
+    return null;
+}
+/**
+ * Parse the raw `duration_ms` CSV column into a number or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns A finite numeric duration, or `null` when the value is empty or non-numeric.
+ */
+function parseDuration(raw) {
+    if (raw === '') {
+        return null;
+    }
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+/**
+ * Parse the raw `tool_type` CSV column into a `ToolType` or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns The parsed `ToolType`, or `null` for unrecognised values.
+ */
+function parseToolType(raw) {
+    if (raw === 'skill' || raw === 'yarn_script') {
+        return raw;
+    }
+    return null;
+}
+/**
+ * Parse the raw `event_type` CSV column into a `CsvEventType` or null.
+ *
+ * @param raw - Raw CSV column value.
+ * @returns The parsed `CsvEventType`, or `null` for unrecognised values.
+ */
+function parseEventType(raw) {
+    if (raw === 'start' || raw === 'end' || raw === 'interrupted') {
+        return raw;
+    }
+    return null;
+}
+/**
+ * Parse a single CSV row into a `ToolEvent`, or null for invalid rows.
+ *
+ * @param line - A raw CSV row string.
+ * @param repo - The repo name derived from the log filename.
+ * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.
+ * @returns The parsed `ToolEvent`, or `null` for header, malformed, or filtered rows.
+ */
+function parseRow(line, repo, onMalformedRow) {
+    // The collector writes a fixed, controlled schema with no quoted/escaped
+    // fields, so a naive comma split is sufficient (and intentional).
+    const rawParts = line.split(',');
+    if (rawParts.length < 8) {
+        onMalformedRow?.(line, 'expected 8 columns');
+        return null;
+    }
+    // Safe to assert: we checked length >= 8 above, but TypeScript can't narrow
+    // array destructuring based on a length guard.
+    const parts = rawParts;
+    const [tool_name, tool_typeRaw, event_typeRaw, agent_vendor, session_id, successRaw, durationRaw, created_at,] = parts;
+    const tool_type = parseToolType(tool_typeRaw);
+    const event_type = parseEventType(event_typeRaw);
+    if (!tool_name || !tool_type || !event_type || !created_at) {
+        onMalformedRow?.(line, 'missing required fields');
+        return null;
+    }
+    return {
+        repo,
+        tool_name,
+        tool_type,
+        event_type,
+        agent_vendor,
+        session_id,
+        success: parseSuccess(successRaw),
+        duration_ms: parseDuration(durationRaw),
+        created_at,
+    };
+}
+/**
+ * Read and parse all events from a single `*-events.log` file.
+ *
+ * @param filePath - Absolute path to the events log file.
+ * @param repo - The repo name associated with this file.
+ * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.
+ * @returns An array of parsed `ToolEvent` objects from the file.
+ */
+function readEventsFile(filePath, repo, onMalformedRow) {
+    const content = readFileSync(filePath, 'utf8');
+    const lines = content.split('\n').filter((line) => line.trim() !== '');
+    const events = [];
+    for (const line of lines) {
+        if (line === CSV_HEADER || line.startsWith('tool_name,')) {
+            continue;
+        }
+        const event = parseRow(line, repo, onMalformedRow);
+        if (event) {
+            events.push(event);
+        }
+    }
+    return events;
+}
+/**
+ * Read all `*-events.log` files from the configured collection directory.
+ *
+ * @param options - Optional directory override and malformed-row callback.
+ * @returns All parsed `ToolEvent` objects from all log files in the directory.
+ */
+export function readAllEvents(options = {}) {
+    const dir = options.logDir ?? getEventsLogDir();
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const files = readdirSync(dir).filter((name) => name.endsWith('-events.log'));
+    const events = [];
+    for (const filename of files.sort()) {
+        const repo = repoFromFilename(filename);
+        events.push(...readEventsFile(join(dir, filename), repo, options.onMalformedRow));
+    }
+    return events;
+}
+//# sourceMappingURL=csv.mjs.map

package/dist/lib/csv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.mjs","sourceRoot":"","sources":["../../src/lib/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB;AAChE,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAEjC,OAAO,EAAE,eAAe,EAAE,oBAAgB;AAG1C,MAAM,UAAU,GACd,uFAAuF,CAAC;AAU1F;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,QAAQ,CACf,IAAY,EACZ,IAAY,EACZ,cAAuD;IAEvD,yEAAyE;IACzE,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,cAAc,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAM,KAAK,GAAG,QAUb,CAAC;IAEF,MAAM,CACJ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACX,GAAG,KAAK,CAAC;IAEV,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAEjD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3D,cAAc,EAAE,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI;QACJ,SAAS;QACT,SAAS;QACT,UAAU;QACV,YAAY;QACZ,UAAU;QACV,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC;QACjC,WAAW,EAAE,aAAa,CAAC,WAAW,CAAC;QACvC,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CACrB,QAAgB,EAChB,IAAY,EACZ,cAAuD;IAEvD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CACT,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { getEventsLogDir } from './paths';\nimport type { CsvEventType, ToolEvent, ToolType } from './types';\n\nconst CSV_HEADER =\n  'tool_name,tool_type,event_type,agent_vendor,session_id,success,duration_ms,created_at';\n\n/** Options for `readAllEvents`. */\nexport type ReadAllEventsOptions = {\n  /** Override for the directory to scan; defaults to `getEventsLogDir()`. */\n  logDir?: string;\n  /** Called for each row that cannot be parsed into a `ToolEvent`. */\n  onMalformedRow?: (line: string, reason: string) => void;\n};\n\n/**\n * Strip the `-events.log` suffix from an event log filename to derive the repo name.\n *\n * @param filename - Event log filename (e.g. `metamask-mobile-events.log`).\n * @returns The repo name portion (filename without the `-events.log` suffix).\n */\nfunction repoFromFilename(filename: string): string {\n  return filename.replace(/-events\\.log$/u, '');\n}\n\n/**\n * Parse the raw `success` CSV column into a boolean or null.\n *\n * @param raw - Raw CSV column value.\n * @returns `true`, `false`, or `null` when the value is unrecognised or empty.\n */\nfunction parseSuccess(raw: string): boolean | null {\n  if (raw === '') {\n    return null;\n  }\n  if (raw === 'true') {\n    return true;\n  }\n  if (raw === 'false') {\n    return false;\n  }\n  return null;\n}\n\n/**\n * Parse the raw `duration_ms` CSV column into a number or null.\n *\n * @param raw - Raw CSV column value.\n * @returns A finite numeric duration, or `null` when the value is empty or non-numeric.\n */\nfunction parseDuration(raw: string): number | null {\n  if (raw === '') {\n    return null;\n  }\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Parse the raw `tool_type` CSV column into a `ToolType` or null.\n *\n * @param raw - Raw CSV column value.\n * @returns The parsed `ToolType`, or `null` for unrecognised values.\n */\nfunction parseToolType(raw: string): ToolType | null {\n  if (raw === 'skill' || raw === 'yarn_script') {\n    return raw;\n  }\n  return null;\n}\n\n/**\n * Parse the raw `event_type` CSV column into a `CsvEventType` or null.\n *\n * @param raw - Raw CSV column value.\n * @returns The parsed `CsvEventType`, or `null` for unrecognised values.\n */\nfunction parseEventType(raw: string): CsvEventType | null {\n  if (raw === 'start' || raw === 'end' || raw === 'interrupted') {\n    return raw;\n  }\n  return null;\n}\n\n/**\n * Parse a single CSV row into a `ToolEvent`, or null for invalid rows.\n *\n * @param line - A raw CSV row string.\n * @param repo - The repo name derived from the log filename.\n * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.\n * @returns The parsed `ToolEvent`, or `null` for header, malformed, or filtered rows.\n */\nfunction parseRow(\n  line: string,\n  repo: string,\n  onMalformedRow?: (line: string, reason: string) => void,\n): ToolEvent | null {\n  // The collector writes a fixed, controlled schema with no quoted/escaped\n  // fields, so a naive comma split is sufficient (and intentional).\n  const rawParts = line.split(',');\n  if (rawParts.length < 8) {\n    onMalformedRow?.(line, 'expected 8 columns');\n    return null;\n  }\n  // Safe to assert: we checked length >= 8 above, but TypeScript can't narrow\n  // array destructuring based on a length guard.\n  const parts = rawParts as [\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    ...string[],\n  ];\n\n  const [\n    tool_name,\n    tool_typeRaw,\n    event_typeRaw,\n    agent_vendor,\n    session_id,\n    successRaw,\n    durationRaw,\n    created_at,\n  ] = parts;\n\n  const tool_type = parseToolType(tool_typeRaw);\n  const event_type = parseEventType(event_typeRaw);\n\n  if (!tool_name || !tool_type || !event_type || !created_at) {\n    onMalformedRow?.(line, 'missing required fields');\n    return null;\n  }\n\n  return {\n    repo,\n    tool_name,\n    tool_type,\n    event_type,\n    agent_vendor,\n    session_id,\n    success: parseSuccess(successRaw),\n    duration_ms: parseDuration(durationRaw),\n    created_at,\n  };\n}\n\n/**\n * Read and parse all events from a single `*-events.log` file.\n *\n * @param filePath - Absolute path to the events log file.\n * @param repo - The repo name associated with this file.\n * @param onMalformedRow - Optional callback invoked for rows that cannot be parsed.\n * @returns An array of parsed `ToolEvent` objects from the file.\n */\nfunction readEventsFile(\n  filePath: string,\n  repo: string,\n  onMalformedRow?: (line: string, reason: string) => void,\n): ToolEvent[] {\n  const content = readFileSync(filePath, 'utf8');\n  const lines = content.split('\\n').filter((line) => line.trim() !== '');\n  const events: ToolEvent[] = [];\n\n  for (const line of lines) {\n    if (line === CSV_HEADER || line.startsWith('tool_name,')) {\n      continue;\n    }\n    const event = parseRow(line, repo, onMalformedRow);\n    if (event) {\n      events.push(event);\n    }\n  }\n\n  return events;\n}\n\n/**\n * Read all `*-events.log` files from the configured collection directory.\n *\n * @param options - Optional directory override and malformed-row callback.\n * @returns All parsed `ToolEvent` objects from all log files in the directory.\n */\nexport function readAllEvents(options: ReadAllEventsOptions = {}): ToolEvent[] {\n  const dir = options.logDir ?? getEventsLogDir();\n  if (!existsSync(dir)) {\n    return [];\n  }\n\n  const files = readdirSync(dir).filter((name) => name.endsWith('-events.log'));\n  const events: ToolEvent[] = [];\n\n  for (const filename of files.sort()) {\n    const repo = repoFromFilename(filename);\n    events.push(\n      ...readEventsFile(join(dir, filename), repo, options.onMalformedRow),\n    );\n  }\n\n  return events;\n}\n"]}