@magnusekdahl/parallix 1.3.2 → 1.3.3

package/lib/agents/mistral-telemetry.js

@@ -1,40 +1,139 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MISTRAL_LOG_DIR = void 0;
+exports.parseMistralMeta = parseMistralMeta;
+exports.extractMistralTelemetry = extractMistralTelemetry;
+exports.getMistralProviderModel = getMistralProviderModel;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
 /**
- * Mistral (Vibe) Telemetry Stub
+ * Mistral (Vibe) Telemetry Parser
+ *
+ * Mistral Vibe writes structured token-usage data to per-session meta files:
+ *   ~/.vibe/logs/session/<session_id>/meta.json
  *
- * Mistral Vibe in programmatic mode does not output token-usage data to
- * stdout/stderr, and has no CLI endpoint for querying session usage.
- * This stub records honest zeros for all token columns so the stats CSV
- * never contains fabricated data.
+ * Each meta.json contains a `stats` object with token counts:
+ *   - session_prompt_tokens  → inputTokens
+ *   - session_completion_tokens → outputTokens
+ *   - session_total_llm_tokens → totalTokens
  *
- * Provider and model fields are set to "mistral" to indicate the agent family.
- * The actual model is determined at runtime via VIBE_ACTIVE_MODEL env var
- * but is not captured per-session, so model falls back to "mistral".
+ * This module scans that directory for the most recent meta.json, parses the
+ * stats block, and returns a telemetry object mirroring the shape used by
+ * codex-telemetry.ts.
  *
- * See task-1285 for the full telemetry credibility design. The blocked
- * verification is tracked as follow-up task-1288 ("Verify vibe/mistral
- * telemetry once usage-unblocked"), which names the missing evidence and the
- * reason it could not be collected in the task-1285 environment.
+ * See task-1288 for the discovery that confirmed the structured source.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractMistralTelemetry = extractMistralTelemetry;
-exports.getMistralProviderModel = getMistralProviderModel;
 /**
- * Attempt to extract telemetry from a mistral launcher result.
- * Since mistral/vibe provides no parseable usage data, always returns null.
+ * The default directory where Vibe writes its session meta files.
+ * Overridden by tests via extractMistralTelemetry(basePath).
+ */
+exports.DEFAULT_MISTRAL_LOG_DIR = node_path_1.default.join(node_os_1.default.homedir(), '.vibe', 'logs', 'session');
+/**
+ * Parse the `stats` block from a meta.json file into a telemetry object.
+ * Returns null when the content yields no usable signal (missing stats,
+ * empty object, or non-object stats).
+ */
+function parseMistralMeta(meta) {
+    if (!meta || typeof meta !== 'object') {
+        return null;
+    }
+    const stats = meta.stats;
+    if (!stats || typeof stats !== 'object') {
+        return null;
+    }
+    const s = stats;
+    const inputTokens = Number(s.session_prompt_tokens) || 0;
+    const outputTokens = Number(s.session_completion_tokens) || 0;
+    const totalTokens = Number(s.session_total_llm_tokens) || 0;
+    // Return null when there is no usable signal (all zeros).
+    // Mirrors the codex-telemetry pattern where honest zeros still indicate
+    // a parseable source was found but contained no actual usage.
+    if (!inputTokens && !outputTokens && !totalTokens) {
+        return null;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        contextTokens: Number(s.context_tokens) || 0,
+        toolCallsAgreed: Number(s.tool_calls_agreed) || 0,
+        toolCallsRejected: Number(s.tool_calls_rejected) || 0,
+        toolCallsFailed: Number(s.tool_calls_failed) || 0,
+        toolCallsSucceeded: Number(s.tool_calls_succeeded) || 0,
+        sessionCost: Number(s.session_cost) || 0,
+    };
+}
+/**
+ * Scan ~/.vibe/logs/session/ for the most recent session meta.json, parse its
+ * stats block, and return a telemetry object.
  *
- * @param {object} result - The launcher result object
- * @returns {null} Always null — mistral/vibe has no telemetry parser
+ * @param result - Legacy launcher result object (ignored; kept for API compat)
+ * @param basePath - Override the default session log directory. Used by tests.
  */
-function extractMistralTelemetry() {
-    // Mistral Vibe does not emit token usage data. Honest zero.
+function extractMistralTelemetry(result, basePath) {
+    void result; // legacy param, ignored — telemetry comes from on-disk meta.json
+    const scanDir = basePath || exports.DEFAULT_MISTRAL_LOG_DIR;
+    // Scan session subdirectories for the newest meta.json.
+    // Basenames are session_<YYYYMMDD>_<HHMMSS>_<id>, so alphabetical sort = chronological.
+    let sessionDirs;
+    try {
+        sessionDirs = node_fs_1.default.readdirSync(scanDir);
+    }
+    catch (_) {
+        return null;
+    }
+    const dirs = sessionDirs
+        .filter((d) => {
+        if (!d.startsWith('session_')) {
+            return false;
+        }
+        const full = node_path_1.default.join(scanDir, d);
+        try {
+            return node_fs_1.default.statSync(full).isDirectory();
+        }
+        catch (_) {
+            return false;
+        }
+    })
+        .sort();
+    if (dirs.length === 0) {
+        return null;
+    }
+    // Walk newest-first; return the first session that has a parseable meta.json.
+    for (let i = dirs.length - 1; i >= 0; i--) {
+        const metaPath = node_path_1.default.join(scanDir, dirs[i], 'meta.json');
+        if (!node_fs_1.default.existsSync(metaPath)) {
+            continue;
+        }
+        let content;
+        try {
+            content = node_fs_1.default.readFileSync(metaPath, 'utf8');
+        }
+        catch (_) {
+            continue;
+        }
+        let meta;
+        try {
+            meta = JSON.parse(content);
+        }
+        catch (_) {
+            continue;
+        }
+        const telemetry = parseMistralMeta(meta);
+        if (!telemetry) {
+            continue;
+        }
+        return { ...telemetry, path: metaPath };
+    }
     return null;
 }
 /**
  * Return the provider/model pair for mistral tasks.
  * Used as fallback when telemetry is null.
- *
- * @returns {{provider: string, model: string}}
  */
 function getMistralProviderModel() {
     return { provider: 'mistral', model: 'mistral' };

package/lib/agents/mistral-telemetry.ts

@@ -1,44 +1,159 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
 /**
- * Mistral (Vibe) Telemetry Stub
+ * Mistral (Vibe) Telemetry Parser
+ *
+ * Mistral Vibe writes structured token-usage data to per-session meta files:
+ *   ~/.vibe/logs/session/<session_id>/meta.json
  *
- * Mistral Vibe in programmatic mode does not output token-usage data to
- * stdout/stderr, and has no CLI endpoint for querying session usage.
- * This stub records honest zeros for all token columns so the stats CSV
- * never contains fabricated data.
+ * Each meta.json contains a `stats` object with token counts:
+ *   - session_prompt_tokens  → inputTokens
+ *   - session_completion_tokens → outputTokens
+ *   - session_total_llm_tokens → totalTokens
  *
- * Provider and model fields are set to "mistral" to indicate the agent family.
- * The actual model is determined at runtime via VIBE_ACTIVE_MODEL env var
- * but is not captured per-session, so model falls back to "mistral".
+ * This module scans that directory for the most recent meta.json, parses the
+ * stats block, and returns a telemetry object mirroring the shape used by
+ * codex-telemetry.ts.
  *
- * See task-1285 for the full telemetry credibility design. The blocked
- * verification is tracked as follow-up task-1288 ("Verify vibe/mistral
- * telemetry once usage-unblocked"), which names the missing evidence and the
- * reason it could not be collected in the task-1285 environment.
+ * See task-1288 for the discovery that confirmed the structured source.
+ */
+
+/**
+ * The default directory where Vibe writes its session meta files.
+ * Overridden by tests via extractMistralTelemetry(basePath).
  */
+export const DEFAULT_MISTRAL_LOG_DIR = path.join(os.homedir(), '.vibe', 'logs', 'session');
+
+interface TelemetryResult {
+  inputTokens: number;
+  outputTokens: number;
+  totalTokens: number;
+  contextTokens: number;
+  toolCallsAgreed: number;
+  toolCallsRejected: number;
+  toolCallsFailed: number;
+  toolCallsSucceeded: number;
+  sessionCost: number;
+  path?: string;
+}
+
+interface ParseableMeta {
+  stats?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+
+interface StatsBlock {
+  session_prompt_tokens?: unknown;
+  session_completion_tokens?: unknown;
+  session_total_llm_tokens?: unknown;
+  context_tokens?: unknown;
+  tool_calls_agreed?: unknown;
+  tool_calls_rejected?: unknown;
+  tool_calls_failed?: unknown;
+  tool_calls_succeeded?: unknown;
+  session_cost?: unknown;
+  [key: string]: unknown;
+}
 
 /**
- * Attempt to extract telemetry from a mistral launcher result.
- * Since mistral/vibe provides no parseable usage data, always returns null.
+ * Parse the `stats` block from a meta.json file into a telemetry object.
+ * Returns null when the content yields no usable signal (missing stats,
+ * empty object, or non-object stats).
+ */
+export function parseMistralMeta(meta: ParseableMeta | null | undefined): TelemetryResult | null {
+  if (!meta || typeof meta !== 'object') {return null;}
+
+  const stats = meta.stats;
+  if (!stats || typeof stats !== 'object') {return null;}
+
+  const s = stats as StatsBlock;
+  const inputTokens = Number(s.session_prompt_tokens) || 0;
+  const outputTokens = Number(s.session_completion_tokens) || 0;
+  const totalTokens = Number(s.session_total_llm_tokens) || 0;
+
+  // Return null when there is no usable signal (all zeros).
+  // Mirrors the codex-telemetry pattern where honest zeros still indicate
+  // a parseable source was found but contained no actual usage.
+  if (!inputTokens && !outputTokens && !totalTokens) {return null;}
+
+  return {
+    inputTokens,
+    outputTokens,
+    totalTokens,
+    contextTokens: Number(s.context_tokens) || 0,
+    toolCallsAgreed: Number(s.tool_calls_agreed) || 0,
+    toolCallsRejected: Number(s.tool_calls_rejected) || 0,
+    toolCallsFailed: Number(s.tool_calls_failed) || 0,
+    toolCallsSucceeded: Number(s.tool_calls_succeeded) || 0,
+    sessionCost: Number(s.session_cost) || 0,
+  };
+}
+
+/**
+ * Scan ~/.vibe/logs/session/ for the most recent session meta.json, parse its
+ * stats block, and return a telemetry object.
  *
- * @param {object} result - The launcher result object
- * @returns {null} Always null — mistral/vibe has no telemetry parser
+ * @param result - Legacy launcher result object (ignored; kept for API compat)
+ * @param basePath - Override the default session log directory. Used by tests.
  */
-function extractMistralTelemetry() {
-  // Mistral Vibe does not emit token usage data. Honest zero.
+export function extractMistralTelemetry(result: unknown, basePath?: string): TelemetryResult | null {
+  void result; // legacy param, ignored — telemetry comes from on-disk meta.json
+
+  const scanDir = basePath || DEFAULT_MISTRAL_LOG_DIR;
+
+  // Scan session subdirectories for the newest meta.json.
+  // Basenames are session_<YYYYMMDD>_<HHMMSS>_<id>, so alphabetical sort = chronological.
+  let sessionDirs: string[];
+  try {
+    sessionDirs = fs.readdirSync(scanDir);
+  } catch (_) {
+    return null;
+  }
+
+  const dirs = sessionDirs
+    .filter((d: string) => {
+      if (!d.startsWith('session_')) {return false;}
+      const full = path.join(scanDir, d);
+      try { return fs.statSync(full).isDirectory(); } catch (_) { return false; }
+    })
+    .sort();
+
+  if (dirs.length === 0) {return null;}
+
+  // Walk newest-first; return the first session that has a parseable meta.json.
+  for (let i = dirs.length - 1; i >= 0; i--) {
+    const metaPath = path.join(scanDir, dirs[i], 'meta.json');
+    if (!fs.existsSync(metaPath)) {continue;}
+
+    let content: string;
+    try {
+      content = fs.readFileSync(metaPath, 'utf8');
+    } catch (_) {
+      continue;
+    }
+
+    let meta: ParseableMeta;
+    try {
+      meta = JSON.parse(content);
+    } catch (_) {
+      continue;
+    }
+
+    const telemetry = parseMistralMeta(meta);
+    if (!telemetry) {continue;}
+
+    return { ...telemetry, path: metaPath };
+  }
+
   return null;
 }
 
 /**
  * Return the provider/model pair for mistral tasks.
  * Used as fallback when telemetry is null.
- *
- * @returns {{provider: string, model: string}}
  */
-function getMistralProviderModel() {
+export function getMistralProviderModel(): { provider: string; model: string } {
   return { provider: 'mistral', model: 'mistral' };
 }
-
-export {
-  extractMistralTelemetry,
-  getMistralProviderModel,
-};

package/lib/agents/mistral.js

@@ -14,7 +14,7 @@ const spawn_tee_js_1 = require("../core/spawn-tee.js");
 // Current session ID format in meta.json: UUID like "a3dd3d4d-f97d-d57d-4942-a1f694e3a922"
 // Directory naming uses first 8 chars: session_20260521_162703_a3dd3d4d
 // No stdout marker detected in testing, so we leave this as null.
-// Telemetry: mistral/vibe does not expose token-usage data. See mistral-telemetry.js
+// Telemetry: mistral/vibe does not expose token-usage data. See mistral-telemetry.ts
 // for the honest-zero stub. Stats hooks in active.js and review-loop.js call
 // recordStageStats which defaults to '0' for tokens when telemetry is null.
 function extractMistralSessionId(stdout) {

package/lib/agents/mistral.ts

@@ -22,7 +22,7 @@ interface StartMistralAgentOptions extends MistralInvocationOptions {
 // Current session ID format in meta.json: UUID like "a3dd3d4d-f97d-d57d-4942-a1f694e3a922"
 // Directory naming uses first 8 chars: session_20260521_162703_a3dd3d4d
 // No stdout marker detected in testing, so we leave this as null.
-// Telemetry: mistral/vibe does not expose token-usage data. See mistral-telemetry.js
+// Telemetry: mistral/vibe does not expose token-usage data. See mistral-telemetry.ts
 // for the honest-zero stub. Stats hooks in active.js and review-loop.js call
 // recordStageStats which defaults to '0' for tokens when telemetry is null.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magnusekdahl/parallix",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "AI mission workflow toolkit with a px CLI — local-first, human-in-the-loop multi-agent development",
   "license": "AGPL-3.0-or-later",
   "private": false,

package/px.js

@@ -51,10 +51,11 @@ function resolveRuntimePath() {
     if (typeof __filename === 'string' && __filename) {
         return __filename;
     }
-    if (typeof process.argv[1] === 'string' && node_path_1.default.isAbsolute(process.argv[1])) {
-        return process.argv[1];
+    const arg1 = typeof process.argv[1] === 'string' ? process.argv[1] : '';
+    if (arg1.endsWith('/px.ts') || arg1.endsWith('/px.js')) {
+        return arg1;
     }
-    return node_path_1.default.resolve(process.cwd(), 'px.js');
+    return node_path_1.default.resolve(process.cwd(), 'px.ts');
 }
 const runtimePath = resolveRuntimePath();
 const _require = (0, node_module_1.createRequire)(runtimePath);
@@ -259,6 +260,9 @@ async function run(argv = process.argv.slice(2), options = {}) {
         process.chdir(previousCwd);
     }
 }
-if (typeof require === 'undefined' || require.main === module) {
+const _cjsMain = typeof require !== 'undefined' && require.main === module;
+const _arg1 = typeof process.argv[1] === 'string' && process.argv[1] ? process.argv[1] : undefined;
+const _esmMain = _arg1 && _arg1.endsWith('/px.ts');
+if (_esmMain || _cjsMain) {
     run().then(code => { process.exitCode = code; });
 }