codex-usage-tracking 0.3.0__py3-none-any.whl

codex_usage_tracker/plugin_data/dashboard/dashboard_data.js

@@ -0,0 +1,155 @@
+(() => {
+  const short = (value, fallback = 'Unknown') => value || fallback;
+
+  function payloadRows(nextPayload) {
+    return Array.isArray(nextPayload) ? nextPayload : Array.isArray(nextPayload.rows) ? nextPayload.rows : [];
+  }
+
+  function payloadLimit(nextPayload) {
+    if (!nextPayload || nextPayload.limit === null || nextPayload.limit === undefined) return null;
+    const parsed = Number(nextPayload.limit);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+  }
+
+  function limitValue(limit) {
+    return limit === null || limit === undefined ? 'all' : String(limit);
+  }
+
+  function optionValueExists(select, value) {
+    if (!value) return false;
+    return Array.from(select.options || []).some(option => option.value === value);
+  }
+
+  function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+  }
+
+  function usageCreditValue(row) {
+    return row.usage_credits === null || row.usage_credits === undefined ? null : Number(row.usage_credits || 0);
+  }
+
+  function usageCreditStatusText(row) {
+    if (usageCreditValue(row) === null) return 'No mapped Codex credit rate';
+    if (row.usage_credit_confidence === 'exact') return 'Official rate-card match';
+    if (row.usage_credit_confidence === 'estimated') return 'Inferred model mapping';
+    if (row.usage_credit_confidence === 'user_override') return 'User-provided credit rate';
+    return short(row.usage_credit_confidence, 'Configured rate');
+  }
+
+  function sumUsageCredits(rows) {
+    return rows.reduce((sum, row) => {
+      const value = usageCreditValue(row);
+      return value === null ? sum : sum + value;
+    }, 0);
+  }
+
+  function creditCoverageRatio(rows) {
+    const totalTokens = rows.reduce((sum, row) => sum + Number(row.total_tokens || 0), 0);
+    const ratedTokens = rows.reduce((sum, row) => sum + (usageCreditValue(row) === null ? 0 : Number(row.total_tokens || 0)), 0);
+    return totalTokens ? ratedTokens / totalTokens : 0;
+  }
+
+  function isAutoReview(row) {
+    return row.model === 'codex-auto-review' || row.subagent_type === 'guardian';
+  }
+
+  function isSubagent(row) {
+    return row.thread_source === 'subagent' || Boolean(row.subagent_type || row.parent_session_id);
+  }
+
+  function sourceLabel(row) {
+    if (isAutoReview(row)) return 'Auto-review';
+    if (row.subagent_type === 'thread_spawn') {
+      return row.agent_role ? `Subagent: ${row.agent_role}` : 'Subagent';
+    }
+    if (isSubagent(row)) return 'Subagent';
+    return 'User';
+  }
+
+  function resolvedParentThreadName(row) {
+    return row.resolved_parent_thread_name || row.parent_thread_name || '';
+  }
+
+  function resolvedParentSessionUpdatedAt(row) {
+    return row.resolved_parent_session_updated_at || row.parent_session_updated_at || '';
+  }
+
+  function resolveThreadAttachment(row) {
+    if (row.thread_attachment_key && row.thread_attachment_label) {
+      return {
+        key: row.thread_attachment_key,
+        label: row.thread_attachment_label,
+        relation: row.thread_attachment_relation || 'session',
+        parentSessionId: row.thread_attachment_parent_session_id || row.parent_session_id || null,
+      };
+    }
+    if (row.thread_name) {
+      return { key: `thread:${row.thread_name}`, label: row.thread_name, relation: 'direct' };
+    }
+    const parentThreadName = resolvedParentThreadName(row);
+    if (row.parent_session_id && parentThreadName) {
+      return {
+        key: `thread:${parentThreadName}`,
+        label: parentThreadName,
+        relation: 'explicit parent thread',
+        parentSessionId: row.parent_session_id,
+      };
+    }
+    if (row.parent_session_id) {
+      return {
+        key: `session:${row.parent_session_id}`,
+        label: `Parent ${row.parent_session_id}`,
+        relation: 'explicit parent',
+        parentSessionId: row.parent_session_id,
+      };
+    }
+    return {
+      key: `session:${row.session_id || 'unknown'}`,
+      label: row.session_id || 'Unknown thread',
+      relation: isSubagent(row) ? 'unmatched subagent' : 'session',
+    };
+  }
+
+  function chronological(a, b) {
+    const timeCompare = String(a.event_timestamp || '').localeCompare(String(b.event_timestamp || ''));
+    if (timeCompare !== 0) return timeCompare;
+    return Number(a.cumulative_total_tokens || 0) - Number(b.cumulative_total_tokens || 0);
+  }
+
+  function compactListSummary(values, fallback = 'Mixed') {
+    const unique = [...new Set(values.filter(Boolean))].sort();
+    if (!unique.length) return 'Unknown';
+    if (unique.length === 1) return unique[0];
+    return `${unique[0]} +${unique.length - 1} ${fallback.toLowerCase()}`;
+  }
+
+  function threadModelSummary(calls) {
+    const models = [...new Set(calls.map(row => row.model).filter(Boolean))].sort();
+    if (!models.length) return 'Unknown';
+    if (models.length === 1) return models[0];
+    const nonReviewModels = models.filter(model => model !== 'codex-auto-review');
+    const primary = nonReviewModels.length ? nonReviewModels[0] : models[0];
+    return `${primary} +${models.length - 1} models`;
+  }
+
+  window.CodexUsageDashboardData = Object.freeze({
+    payloadRows,
+    payloadLimit,
+    limitValue,
+    optionValueExists,
+    clamp,
+    usageCreditValue,
+    usageCreditStatusText,
+    sumUsageCredits,
+    creditCoverageRatio,
+    isAutoReview,
+    isSubagent,
+    sourceLabel,
+    resolvedParentThreadName,
+    resolvedParentSessionUpdatedAt,
+    resolveThreadAttachment,
+    chronological,
+    compactListSummary,
+    threadModelSummary,
+  });
+})();

codex_usage_tracker/plugin_data/dashboard/dashboard_format.js

@@ -0,0 +1,132 @@
+(() => {
+  const number = new Intl.NumberFormat();
+  const tableDateFormat = new Intl.DateTimeFormat([], {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+  });
+  const tableTimeFormat = new Intl.DateTimeFormat([], {
+    hour: 'numeric',
+    minute: '2-digit',
+    second: '2-digit',
+  });
+  const detailDateTimeFormat = new Intl.DateTimeFormat([], {
+    month: 'short',
+    day: 'numeric',
+    year: 'numeric',
+    hour: 'numeric',
+    minute: '2-digit',
+    second: '2-digit',
+    timeZoneName: 'short',
+  });
+
+  const money = (value, missingLabel = 'No price') => {
+    if (value === null || value === undefined) return missingLabel;
+    const amount = Number(value) || 0;
+    if (amount > 0 && amount < 0.01) return `$${amount.toFixed(4)}`;
+    return `$${amount.toFixed(2)}`;
+  };
+
+  const credits = (value, missingLabel = 'No rate') => {
+    if (value === null || value === undefined) return missingLabel;
+    const amount = Number(value) || 0;
+    if (amount > 0 && amount < 1) return amount.toFixed(2);
+    if (amount < 100) return amount.toFixed(1);
+    return number.format(Math.round(amount));
+  };
+
+  const pct = value => `${((Number(value) || 0) * 100).toFixed(1)}%`;
+  const short = (value, fallback = 'Unknown') => value || fallback;
+  const escapeHtml = value => String(value).replace(/[&<>"']/g, char => ({
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+  }[char]));
+  const truncate = (value, size = 54) => {
+    const text = short(value, '');
+    return text.length > size ? `${text.slice(0, size - 1)}...` : text;
+  };
+
+  function parsedTimestamp(value) {
+    if (!value) return null;
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? null : date;
+  }
+
+  function formatTimestamp(value, fallback = 'Unknown') {
+    const date = parsedTimestamp(value);
+    return date ? detailDateTimeFormat.format(date) : short(value, fallback);
+  }
+
+  function formatTimestampTitle(value) {
+    const formatted = formatTimestamp(value, '');
+    return [formatted, value].filter(Boolean).join(' - ');
+  }
+
+  function renderTimeCell(value) {
+    const date = parsedTimestamp(value);
+    if (!date) return escapeHtml(truncate(value, 20));
+    return `
+      <span class="time-cell" title="${escapeHtml(formatTimestampTitle(value))}">
+        <span class="time-date">${escapeHtml(tableDateFormat.format(date))}</span>
+        <span class="time-clock">${escapeHtml(tableTimeFormat.format(date))}</span>
+      </span>
+    `;
+  }
+
+  function defaultSortDirection(key) {
+    return {
+      cache: 'asc',
+      effort: 'asc',
+      model: 'asc',
+      thread: 'asc',
+    }[key] || 'desc';
+  }
+
+  function textValue(value) {
+    return short(value, '').toLowerCase();
+  }
+
+  function compareValues(left, right) {
+    if (typeof left === 'number' || typeof right === 'number') {
+      return (Number(left) || 0) - (Number(right) || 0);
+    }
+    return String(left || '').localeCompare(String(right || ''));
+  }
+
+  function sortLabel(key) {
+    return {
+      attention: 'Needs attention',
+      cache: 'Cache',
+      context: 'Context use',
+      cost: 'Cost',
+      effort: 'Effort',
+      model: 'Model',
+      signals: 'Signals',
+      thread: 'Thread',
+      time: 'Time',
+      total: 'Tokens',
+      usage: 'Codex credits',
+    }[key] || 'Sort';
+  }
+
+  window.CodexUsageDashboardFormat = Object.freeze({
+    number,
+    money,
+    credits,
+    pct,
+    short,
+    escapeHtml,
+    truncate,
+    parsedTimestamp,
+    formatTimestamp,
+    formatTimestampTitle,
+    renderTimeCell,
+    defaultSortDirection,
+    textValue,
+    compareValues,
+    sortLabel,
+  });
+})();

codex_usage_tracker/plugin_data/dashboard/dashboard_state.js

@@ -0,0 +1,157 @@
+(function () {
+  const ALLOWED_VIEWS = new Set(['insights', 'calls', 'threads']);
+  const ALLOWED_DIRECTIONS = new Set(['asc', 'desc']);
+  const STATE_KEYS = [
+    'view',
+    'q',
+    'model',
+    'effort',
+    'confidence',
+    'pricing',
+    'date',
+    'from',
+    'to',
+    'history',
+    'sort',
+    'direction',
+    'preset',
+    'page',
+    'record',
+    'thread',
+    'expand',
+    'threads',
+  ];
+
+  function clean(value) {
+    return typeof value === 'string' ? value.trim() : '';
+  }
+
+  function read(params = new URLSearchParams(window.location.search)) {
+    const page = Number(params.get('page') || 1);
+    return {
+      view: ALLOWED_VIEWS.has(params.get('view')) ? params.get('view') : '',
+      search: clean(params.get('q')),
+      model: clean(params.get('model')),
+      effort: clean(params.get('effort')),
+      confidence: clean(params.get('confidence') || params.get('pricing')),
+      datePreset: clean(params.get('date')),
+      dateStart: clean(params.get('from')),
+      dateEnd: clean(params.get('to')),
+      historyScope: params.get('history') === 'all' ? 'all' : '',
+      sort: clean(params.get('sort')),
+      direction: ALLOWED_DIRECTIONS.has(params.get('direction')) ? params.get('direction') : '',
+      preset: clean(params.get('preset')),
+      page: Number.isFinite(page) && page > 0 ? Math.floor(page) : 1,
+      record: clean(params.get('record')),
+      thread: clean(params.get('thread')),
+      expand: clean(params.get('expand')),
+      expandedThreads: clean(params.get('threads')).split(',').filter(Boolean).slice(0, 30).map(decodePart),
+    };
+  }
+
+  function serialize(state) {
+    const params = new URLSearchParams(window.location.search);
+    STATE_KEYS.forEach(key => params.delete(key));
+    set(params, 'view', ALLOWED_VIEWS.has(state.view) && state.view !== 'insights' ? state.view : '');
+    set(params, 'q', state.search);
+    set(params, 'model', state.model);
+    set(params, 'effort', state.effort);
+    set(params, 'confidence', state.confidence);
+    set(params, 'date', state.datePreset && state.datePreset !== 'all' ? state.datePreset : '');
+    set(params, 'from', state.dateStart);
+    set(params, 'to', state.dateEnd);
+    set(params, 'history', state.historyScope === 'all' ? 'all' : '');
+    set(params, 'sort', state.sort && state.sort !== 'attention' ? state.sort : '');
+    set(params, 'direction', ALLOWED_DIRECTIONS.has(state.direction) ? state.direction : '');
+    set(params, 'preset', state.preset);
+    set(params, 'page', state.page && Number(state.page) > 1 ? String(Math.floor(Number(state.page))) : '');
+    set(params, 'record', state.record);
+    set(params, 'thread', state.thread);
+    set(params, 'expand', state.expand);
+    set(params, 'threads', Array.isArray(state.expandedThreads) ? state.expandedThreads.slice(0, 30).map(encodeURIComponent).join(',') : '');
+    return params;
+  }
+
+  function set(params, key, value) {
+    const text = clean(value);
+    if (text) params.set(key, text);
+  }
+
+  function urlFor(state) {
+    const params = serialize(state);
+    const query = params.toString();
+    const base = window.location.href.split('#')[0].split('?')[0];
+    return `${base}${query ? `?${query}` : ''}${window.location.hash || ''}`;
+  }
+
+  function replace(state) {
+    if (!window.history || !window.history.replaceState) return;
+    const nextUrl = urlFor(state);
+    if (nextUrl !== window.location.href) {
+      window.history.replaceState(null, '', nextUrl);
+    }
+  }
+
+  async function copyText(text) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      await navigator.clipboard.writeText(text);
+      return true;
+    }
+    const textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.setAttribute('readonly', 'readonly');
+    textarea.style.position = 'fixed';
+    textarea.style.left = '-9999px';
+    document.body.appendChild(textarea);
+    textarea.select();
+    const copied = document.execCommand('copy');
+    textarea.remove();
+    return copied;
+  }
+
+  function downloadText(filename, text, type = 'text/plain;charset=utf-8') {
+    const blob = new Blob([text], { type });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = url;
+    anchor.download = filename;
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    URL.revokeObjectURL(url);
+  }
+
+  function toCsv(rows, columns) {
+    const header = columns.map(column => csvCell(column.label)).join(',');
+    const body = rows.map(row => columns.map(column => csvCell(resolveValue(row, column.field))).join(','));
+    return [header, ...body].join('\n') + '\n';
+  }
+
+  function resolveValue(row, field) {
+    if (typeof field === 'function') return field(row);
+    return row && Object.prototype.hasOwnProperty.call(row, field) ? row[field] : '';
+  }
+
+  function csvCell(value) {
+    if (value === null || value === undefined) return '';
+    const text = Array.isArray(value) ? value.join('; ') : String(value);
+    return /[",\n\r]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+  }
+
+  function decodePart(value) {
+    try {
+      return decodeURIComponent(value);
+    } catch (error) {
+      return value;
+    }
+  }
+
+  window.CodexUsageDashboardState = {
+    read,
+    replace,
+    urlFor,
+    copyText,
+    downloadText,
+    toCsv,
+  };
+}());

codex_usage_tracker/plugin_data/dashboard/dashboard_template.html

@@ -0,0 +1,141 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="icon" href="data:,">
+  <title>__TITLE__</title>
+  <link rel="stylesheet" href="__STYLESHEET_HREF__">
+</head>
+<body>
+  <header>
+    <div class="header-main">
+      <div>
+        <p class="eyebrow">Local Codex analytics</p>
+        <h1>Usage Dashboard</h1>
+      </div>
+      <div class="live-bar" aria-label="Dashboard refresh controls">
+        <button id="refreshDashboard" class="refresh-button" type="button">Refresh</button>
+        <label class="live-toggle"><input id="autoRefresh" type="checkbox" checked> Live</label>
+        <label class="load-control">Load
+          <select id="loadLimit">
+            <option value="5000">5,000 calls</option>
+            <option value="10000">10,000 calls</option>
+            <option value="20000">20,000 calls</option>
+            <option value="all">All calls</option>
+          </select>
+        </label>
+        <label class="history-control" title="Active sessions only is the default. All history scans archived session logs during live refresh.">History
+          <select id="historyScope">
+            <option value="active" selected>Active sessions only</option>
+            <option value="all">All history</option>
+          </select>
+        </label>
+      </div>
+    </div>
+    <div class="header-meta">
+      <div class="meta-chips" aria-label="Dashboard status">
+        <span class="disclaimer-chip" title="Codex Usage Tracker is independent and is not made by, affiliated with, endorsed by, sponsored by, or supported by OpenAI. OpenAI and Codex are trademarks of OpenAI.">Unofficial project</span>
+        <span id="liveStatus" class="live-status">Static</span>
+        <span id="pricingSource" class="source-line"></span>
+        <span id="allowanceSource" class="source-line"></span>
+        <span id="privacyMode" class="source-line"></span>
+        <span id="parserDiagnostics" class="source-line" hidden></span>
+      </div>
+      __GUIDE_LINK__
+    </div>
+  </header>
+  <main>
+    <div class="filters">
+      <label>Search<input id="search" type="search" placeholder="Thread, cwd, model"></label>
+      <label>Model<select id="model"><option value="">All models</option></select></label>
+      <label>Reasoning<select id="effort"><option value="">All efforts</option></select></label>
+      <label>Confidence<select id="pricingStatus"><option value="">All confidence</option><option value="official">Exact cost</option><option value="estimated">Estimated cost</option><option value="unpriced">Unpriced cost</option><option value="credit-exact">Exact credit rate</option><option value="credit-estimated">Estimated credit mapping</option><option value="credit-override">User credit override</option><option value="credit-missing">Missing credit rate</option></select></label>
+      <label>Time<select id="datePreset"><option value="all" selected>All time</option><option value="today">Today</option><option value="this-week">This week</option><option value="last-7-days">Last 7 days</option><option value="this-month">This month</option><option value="custom">Custom range</option></select><span id="dateRangeStatus" class="filter-status" aria-live="polite" hidden></span></label>
+      <label>Start<input id="dateStart" type="date"></label>
+      <label>End<input id="dateEnd" type="date"></label>
+      <label>Sort<select id="sort"><option value="attention" selected>Needs attention</option><option value="time">Newest calls</option><option value="thread">Thread name</option><option value="model">Model</option><option value="effort">Reasoning</option><option value="total">Most tokens</option><option value="cost">Highest estimated cost</option><option value="usage">Highest Codex credits</option><option value="cache">Lowest cache ratio</option><option value="signals">Most signals</option><option value="context">Highest context use</option></select></label>
+    </div>
+    <div class="cards">
+      <div class="card"><span>Visible Calls</span><strong id="visibleCalls">0</strong></div>
+      <div class="card"><span>Total Tokens</span><strong id="totalTokens">0</strong></div>
+      <div class="card"><span>Cached Input</span><strong id="cachedTokens">0</strong></div>
+      <div class="card"><span>Uncached Input</span><strong id="uncachedTokens">0</strong></div>
+      <div class="card"><span>Reasoning Output</span><strong id="reasoningTokens">0</strong></div>
+      <div class="card"><span>Estimated Cost</span><strong id="estimatedCost">$0.00</strong></div>
+      <div class="card"><span>Codex Credits</span><strong id="usageCredits">0</strong></div>
+      <div class="card"><span>Usage Remaining</span><strong id="allowanceImpact">Set limits</strong></div>
+    </div>
+    <section id="insightsPanel" class="insights-panel" aria-labelledby="insightsTitle">
+      <div class="insights-layout">
+        <div>
+          <div class="section-heading">
+            <h2 id="insightsTitle">Needs Attention</h2>
+            <p id="insightsCaption">Ranked by cost, usage credits, cache reuse, context pressure, and pricing confidence.</p>
+          </div>
+          <div id="insightCards" class="insight-cards" aria-live="polite"></div>
+        </div>
+        <aside class="preset-panel" aria-labelledby="presetsTitle">
+          <div class="preset-heading">
+            <div>
+              <h2 id="presetsTitle">Investigation Presets</h2>
+              <p>One-click starting points for common usage questions.</p>
+            </div>
+            <button id="clearPreset" class="preset-clear" type="button" hidden>Clear</button>
+          </div>
+          <div id="presetStatus" class="preset-status">No preset applied.</div>
+          <div id="presetList" class="preset-list"></div>
+        </aside>
+      </div>
+    </section>
+    <div class="grid">
+      <section>
+        <h2 id="tableTitle">Model Calls</h2>
+        <div class="table-tools">
+          <div class="segmented" role="group" aria-label="Dashboard view">
+            <button id="insightsView" type="button" aria-pressed="true">Insights</button>
+            <button id="callsView" type="button" aria-pressed="false">Calls</button>
+            <button id="threadsView" type="button" aria-pressed="false">Threads</button>
+          </div>
+          <div id="tableCaption" class="table-caption">Showing individual model calls.</div>
+          <div class="table-actions" aria-label="Current view actions">
+            <button id="copyViewLink" class="toolbar-button" type="button">Copy link</button>
+            <button id="exportVisible" class="toolbar-button" type="button">Export CSV</button>
+            <span id="actionStatus" class="action-status" aria-live="polite"></span>
+          </div>
+          <div id="pager" class="pager" aria-label="Table pages">
+            <button id="prevPage" class="pager-button" type="button">Previous</button>
+            <span id="pageStatus">Page 1</span>
+            <button id="nextPage" class="pager-button" type="button">Next</button>
+          </div>
+        </div>
+        <table>
+          <thead>
+            <tr>
+              <th data-sort-header="time"><button class="sort-header" type="button" data-sort-key="time">Time <span class="sort-indicator" data-sort-indicator="time"></span></button></th>
+              <th data-sort-header="thread"><button class="sort-header" type="button" data-sort-key="thread">Thread <span class="sort-indicator" data-sort-indicator="thread"></span></button></th>
+              <th data-sort-header="model"><button class="sort-header" type="button" data-sort-key="model">Model <span class="sort-indicator" data-sort-indicator="model"></span></button></th>
+              <th data-sort-header="effort"><button class="sort-header" type="button" data-sort-key="effort">Effort <span class="sort-indicator" data-sort-indicator="effort"></span></button></th>
+              <th class="num" data-sort-header="total"><button class="sort-header" type="button" data-sort-key="total">Tokens <span class="sort-indicator" data-sort-indicator="total"></span></button></th>
+              <th class="num" data-sort-header="cost"><button class="sort-header" type="button" data-sort-key="cost">Cost <span class="sort-indicator" data-sort-indicator="cost"></span></button></th>
+              <th class="num" data-sort-header="cache"><button class="sort-header" type="button" data-sort-key="cache">Cache <span class="sort-indicator" data-sort-indicator="cache"></span></button></th>
+              <th class="num" data-sort-header="signals"><button class="sort-header" type="button" data-sort-key="signals">Signals <span class="sort-indicator" data-sort-indicator="signals"></span></button></th>
+            </tr>
+          </thead>
+          <tbody id="rows"></tbody>
+        </table>
+      </section>
+      <section class="detail-section">
+        <h2>Call Details</h2>
+        <div id="detail" class="detail">Hover or click a row to inspect aggregate usage fields.</div>
+      </section>
+    </div>
+  </main>
+  <button id="toTop" class="to-top" type="button" aria-label="Back to top">Top</button>
+  <script id="usage-data" type="application/json">__PAYLOAD__</script>
+  <script src="__FORMAT_SCRIPT_SRC__"></script>
+  <script src="__DATA_SCRIPT_SRC__"></script>
+  <script src="__STATE_SCRIPT_SRC__"></script>
+  <script src="__SCRIPT_SRC__"></script>
+</body>
+</html>