acdev 1.0.11 → 1.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acdev",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Local CLI + web UI for running AI agents on GitHub issues via git worktrees",
   "type": "module",
   "bin": {

package/public/app.js

@@ -255,6 +255,7 @@ const els = {
   reviewList: document.getElementById('review-list'),
   reviewEmptyDetail: document.getElementById('review-empty-detail'),
   reviewDetailContent: document.getElementById('review-detail-content'),
+  reviewAgentMeta: document.getElementById('review-agent-meta'),
   reviewActions: document.getElementById('review-actions'),
   reviewFeedbackSection: document.getElementById('review-feedback-section'),
   reviewGeneralComment: document.getElementById('review-general-comment'),
@@ -343,6 +344,7 @@ const els = {
   settingsOpenrouterKeyClear: document.getElementById('settings-openrouter-key-clear'),
   settingsOpenrouterKeyHint: document.getElementById('settings-openrouter-key-hint'),
   settingsLlmProvider: document.getElementById('settings-llm-provider'),
+  settingsLlmProviderHint: document.getElementById('settings-llm-provider-hint'),
   overviewLlmProvider: document.getElementById('overview-llm-provider'),
   sidebarAgentLabel: document.getElementById('sidebar-agent-label'),
   settingsTabs: document.getElementById('settings-tabs'),
@@ -936,10 +938,37 @@ function jobRepoLine(job) {
 
 function jobSubLine(job) {
   const meta = jobRepoLine(job);
-  if (meta.isJira) {
-    return `${meta.number}${meta.branch}`;
-  }
-  return `${meta.repo} #${meta.number}${meta.branch}`;
+  const agent = jobLlmLine(job);
+  const base = meta.isJira
+    ? `${meta.number}${meta.branch}`
+    : `${meta.repo} #${meta.number}${meta.branch}`;
+  return agent ? `${base} · ${agent}` : base;
+}
+
+/**
+ * @param {object | null | undefined} job
+ * @returns {'claude' | 'openrouter'}
+ */
+function jobLlmProvider(job) {
+  if (job?.llmProvider === 'openrouter') return 'openrouter';
+  if (job?.llmProvider === 'claude') return 'claude';
+  if (job?.usage?.provider === 'openrouter') return 'openrouter';
+  if (job?.usage?.provider === 'claude') return 'claude';
+  return String(job?.model || '').includes('/') ? 'openrouter' : 'claude';
+}
+
+function jobLlmLabel(job) {
+  return jobLlmProvider(job) === 'openrouter' ? 'OpenRouter' : 'Claude';
+}
+
+/** `OpenRouter · google/gemini-2.5-pro` */
+function jobLlmLine(job) {
+  if (!job) return '';
+  const label = jobLlmLabel(job);
+  const model = typeof job.model === 'string' ? job.model.trim() : '';
+  if (model && model !== '-') return `${label} · ${model}`;
+  if (job.llmProvider || job.model || job.usage?.provider) return label;
+  return '';
 }
 
 function issueBadge(job) {
@@ -1070,26 +1099,37 @@ function formatUsageDetail(usage) {
   return parts.length ? parts.join(' · ') : null;
 }
 
-/** Sum cost / tokens across jobs that have usage (this app's jobs only). */
+/** Sum cost / tokens across jobs that have usage, split by LLM provider. */
 function aggregateJobUsage(jobs) {
-  let totalCostUsd = 0;
-  let totalTokens = 0;
-  let withCost = 0;
-  let withTokens = 0;
+  const empty = () => ({
+    totalCostUsd: 0,
+    totalTokens: 0,
+    withCost: 0,
+    withTokens: 0,
+  });
+  const out = { claude: empty(), openrouter: empty() };
   for (const job of jobs) {
     const u = job.usage;
     if (!u) continue;
+    const bucket = out[jobLlmProvider(job)];
     if (typeof u.totalCostUsd === 'number' && Number.isFinite(u.totalCostUsd)) {
-      totalCostUsd += u.totalCostUsd;
-      withCost += 1;
+      bucket.totalCostUsd += u.totalCostUsd;
+      bucket.withCost += 1;
     }
     const tok = (u.inputTokens || 0) + (u.outputTokens || 0);
     if (tok > 0) {
-      totalTokens += tok;
-      withTokens += 1;
+      bucket.totalTokens += tok;
+      bucket.withTokens += 1;
     }
   }
-  return { totalCostUsd, totalTokens, withCost, withTokens };
+  return out;
+}
+
+function formatProviderUsageStat(agg) {
+  if (!agg.withCost && !agg.withTokens) return '—';
+  const cost = formatUsd(agg.withCost ? agg.totalCostUsd : null) || '—';
+  const tok = agg.withTokens ? formatTokenCount(agg.totalTokens) || '—' : '—';
+  return `${cost} · ${tok}`;
 }
 
 /** Five progress dots: sync → worktree → agent → review → PR */
@@ -1244,6 +1284,27 @@ function formatLogEvent(event) {
     return { kind: 'status', label: 'Status', text, raw };
   }
 
+  if (event.type === 'llm') {
+    const payload = event.payload && typeof event.payload === 'object' ? event.payload : {};
+    const provider =
+      payload.provider === 'openrouter' || payload.provider === 'OpenRouter'
+        ? 'OpenRouter'
+        : payload.provider === 'claude' || payload.provider === 'Claude'
+          ? 'Claude'
+          : payload.provider
+            ? String(payload.provider)
+            : 'Agent';
+    const model = typeof payload.model === 'string' && payload.model.trim()
+      ? payload.model.trim()
+      : '—';
+    return {
+      kind: 'status',
+      label: 'Agent',
+      text: `${provider} · ${model}`,
+      raw,
+    };
+  }
+
   if (event.type === 'error') {
     return {
       kind: 'error',
@@ -2039,8 +2100,6 @@ function renderStats(jobs) {
   const review = jobs.filter((j) => j.status === 'awaiting_review').length;
   const alerts = collectAlerts(jobs).length;
   const agg = aggregateJobUsage(jobs);
-  const costLabel = formatUsd(agg.withCost ? agg.totalCostUsd : null) || '—';
-  const tokLabel = agg.withTokens ? formatTokenCount(agg.totalTokens) || '—' : '—';
 
   const items = [
     { label: 'Queued', value: queued, color: 'var(--text-muted)', dot: false },
@@ -2048,18 +2107,18 @@ function renderStats(jobs) {
     { label: 'Ready for review', value: review, color: 'var(--primary)', dot: false },
     { label: 'Alerts', value: alerts, color: 'var(--accent)', dot: false },
     {
-      label: 'Job cost',
-      value: costLabel,
+      label: 'Claude',
+      value: formatProviderUsageStat(agg.claude),
       color: 'var(--primary)',
       dot: false,
-      hint: 'These jobs only',
+      hint: 'Cost · in+out tok',
     },
     {
-      label: 'Tokens',
-      value: tokLabel,
-      color: 'var(--text-muted)',
+      label: 'OpenRouter',
+      value: formatProviderUsageStat(agg.openrouter),
+      color: 'var(--primary)',
       dot: false,
-      hint: 'In + out',
+      hint: 'Cost · in+out tok',
     },
   ];
 
@@ -2255,9 +2314,16 @@ function renderRuns(jobs) {
 
     const usageLine = document.createElement('div');
     usageLine.className = 'run-usage mono';
+    const agentLine = jobLlmLine(job);
     const usageDetail = formatUsageDetail(job.usage);
-    usageLine.textContent = usageDetail || '—';
-    if (!usageDetail) usageLine.classList.add('muted');
+    if (agentLine && usageDetail) {
+      usageLine.textContent = `${agentLine} · ${usageDetail}`;
+    } else if (agentLine) {
+      usageLine.textContent = agentLine;
+    } else {
+      usageLine.textContent = usageDetail || '—';
+      if (!usageDetail) usageLine.classList.add('muted');
+    }
     card.appendChild(usageLine);
 
     const now = document.createElement('div');
@@ -2461,8 +2527,12 @@ function renderReview(jobs) {
       <div class="review-pick-sub"></div>
     `;
     btn.querySelector('.review-pick-title').textContent = jobTitle(job);
-    btn.querySelector('.review-pick-sub').textContent =
-      `${jobSubLine(job).replace(/ · .*$/, '')} · ${statusLabel(job.status)}`;
+    const meta = jobRepoLine(job);
+    const left = meta.isJira ? meta.number : `${meta.repo} #${meta.number}`;
+    const agent = jobLlmLine(job);
+    btn.querySelector('.review-pick-sub').textContent = [left, agent, statusLabel(job.status)]
+      .filter(Boolean)
+      .join(' · ');
     btn.addEventListener('click', () => selectReview(job.id));
     els.reviewList.appendChild(btn);
   }
@@ -2477,6 +2547,15 @@ function renderReview(jobs) {
   els.reviewEmptyDetail.classList.add('hidden');
   els.reviewDetailContent.classList.remove('hidden');
 
+  if (els.reviewAgentMeta) {
+    const agent = jobLlmLine(job);
+    const usage = formatUsageDetail(job.usage);
+    const parts = [agent, usage].filter(Boolean);
+    els.reviewAgentMeta.textContent = parts.length
+      ? parts.join(' · ')
+      : 'Agent not recorded for this job.';
+  }
+
   const editable = job.status === 'awaiting_review';
   const isOpened = job.status === 'pr_opened';
   const isTerminal = job.status === 'discarded' || job.status === 'failed';
@@ -2725,6 +2804,8 @@ function jobMatchesReviewSearch(job, q) {
     ref?.full,
     jiraKey,
     job.ticketSource,
+    job.llmProvider,
+    job.model,
   ]
     .filter(Boolean)
     .map((s) => String(s).toLowerCase());
@@ -3893,7 +3974,7 @@ function fillSettingsForm(cfg) {
   fillAuthSettings(cfg);
 
   updateTicketSourceUI(cfg.ticketSource === 'jira' ? 'jira' : 'github');
-  updateLlmProviderUI(cfg.llmProvider === 'openrouter' ? 'openrouter' : 'claude');
+  updateLlmProviderUI(cfg.llmProvider === 'openrouter' ? 'openrouter' : 'claude', cfg);
 
   if (els.settingsJiraBaseUrl) {
     els.settingsJiraBaseUrl.value = cfg.jiraBaseUrl || '';
@@ -4120,20 +4201,76 @@ function updateTicketSourceUI(source) {
   }
 }
 
+/**
+ * @param {'claude' | 'openrouter'} provider
+ * @param {typeof appConfig} [cfg]
+ */
+function llmProviderReady(provider, cfg = appConfig) {
+  if (cfg?.stubAgent) return true;
+  if (provider === 'openrouter') return cfg?.openrouterAuthOk === true;
+  return cfg?.claudeAuthOk === true;
+}
+
 /**
  * @param {'claude' | 'openrouter'} provider
  */
-function updateLlmProviderUI(provider) {
+function llmProviderUnavailableReason(provider) {
+  if (provider === 'openrouter') {
+    return 'OpenRouter is not configured. Add an API key in Settings → Authentication first.';
+  }
+  return 'Claude is not configured. Add an API key or OAuth token in Settings → Authentication, or run claude auth login.';
+}
+
+const LLM_PROVIDER_HINT_DEFAULT =
+  'Claude uses the Claude Agent SDK. OpenRouter uses <code>@openrouter/agent</code> with the same coding tools (any catalog model). A provider stays disabled until it is configured and authenticated.';
+
+/**
+ * @param {typeof appConfig} [cfg]
+ */
+function updateLlmProviderHint(cfg = appConfig) {
+  if (!els.settingsLlmProviderHint) return;
+  if (cfg?.stubAgent) {
+    els.settingsLlmProviderHint.innerHTML = LLM_PROVIDER_HINT_DEFAULT;
+    return;
+  }
+  const missing = [];
+  if (!llmProviderReady('claude', cfg)) {
+    missing.push('Claude (API key, OAuth token, or <code>claude auth login</code>)');
+  }
+  if (!llmProviderReady('openrouter', cfg)) {
+    missing.push('OpenRouter (API key in Authentication)');
+  }
+  if (!missing.length) {
+    els.settingsLlmProviderHint.innerHTML = LLM_PROVIDER_HINT_DEFAULT;
+    return;
+  }
+  els.settingsLlmProviderHint.innerHTML = `Cannot enable a provider until it is configured and authenticated. Missing: ${missing.join('; ')}.`;
+}
+
+/**
+ * @param {'claude' | 'openrouter'} provider
+ * @param {typeof appConfig} [cfg]
+ */
+function updateLlmProviderUI(provider, cfg = appConfig) {
   llmProvider = provider === 'openrouter' ? 'openrouter' : 'claude';
 
   for (const toggle of [els.settingsLlmProvider, els.overviewLlmProvider]) {
     if (!toggle) continue;
     toggle.querySelectorAll('.source-btn').forEach((btn) => {
-      const active = btn.dataset.provider === llmProvider;
+      const id = btn.dataset.provider === 'openrouter' ? 'openrouter' : 'claude';
+      const active = id === llmProvider;
+      const ready = llmProviderReady(id, cfg);
       btn.classList.toggle('active', active);
       btn.setAttribute('aria-pressed', active ? 'true' : 'false');
+      btn.disabled = !ready;
+      if (!ready) {
+        btn.title = llmProviderUnavailableReason(id);
+      } else {
+        btn.removeAttribute('title');
+      }
     });
   }
+  updateLlmProviderHint(cfg);
   updateModelLabel();
 }
 
@@ -4160,6 +4297,13 @@ async function saveTicketSource(next) {
 
 async function saveLlmProvider(next) {
   const provider = next === 'openrouter' ? 'openrouter' : 'claude';
+  if (!llmProviderReady(provider)) {
+    const msg = llmProviderUnavailableReason(provider);
+    setOverviewLlmFeedback(msg, 'error');
+    setSettingsFeedback(msg, 'error');
+    return;
+  }
+  const prev = llmProvider;
   updateLlmProviderUI(provider);
   clearAvailableModels();
   try {
@@ -4169,11 +4313,18 @@ async function saveLlmProvider(next) {
       body: JSON.stringify({ llmProvider: provider }),
     });
     const data = await readJson(res);
-    if (res.ok) {
-      applyConfigSnapshot({ ...appConfig, ...data });
+    if (!res.ok) {
+      updateLlmProviderUI(prev);
+      const msg = data.error || `Update failed (HTTP ${res.status})`;
+      setOverviewLlmFeedback(msg, 'error');
+      setSettingsFeedback(msg, 'error');
       await fetchModels({ refresh: true, reconcile: true });
+      return;
     }
+    applyConfigSnapshot({ ...appConfig, ...data });
+    await fetchModels({ refresh: true, reconcile: true });
   } catch {
+    updateLlmProviderUI(prev);
     void fetchModels({ refresh: true, reconcile: true });
   }
 }
@@ -4205,7 +4356,7 @@ function setOverviewLlmFeedback(message, kind = 'ok') {
  */
 function fillOverviewLlmControls(cfg) {
   if (!cfg) return;
-  updateLlmProviderUI(cfg.llmProvider === 'openrouter' ? 'openrouter' : 'claude');
+  updateLlmProviderUI(cfg.llmProvider === 'openrouter' ? 'openrouter' : 'claude', cfg);
   syncAllModelComboboxValues(currentModel);
 }
 
@@ -4253,7 +4404,10 @@ function applyConfigSnapshot(data) {
   updateModelLabel();
   fillOverviewLlmControls(data);
   updateTicketSourceUI(data?.ticketSource === 'jira' ? 'jira' : 'github');
-  updateLlmProviderUI(data?.llmProvider === 'openrouter' ? 'openrouter' : 'claude');
+  updateLlmProviderUI(
+    data?.llmProvider === 'openrouter' ? 'openrouter' : 'claude',
+    data || appConfig
+  );
   if (els.repoName) {
     els.repoName.textContent = data?.repoName || 'local repo';
   }
@@ -4650,6 +4804,12 @@ function handleLlmProviderToggleClick(e) {
   const next = btn.dataset.provider === 'openrouter' ? 'openrouter' : 'claude';
   if (next === llmProvider) return;
   e.stopPropagation();
+  if (btn.disabled || !llmProviderReady(next)) {
+    const msg = llmProviderUnavailableReason(next);
+    setOverviewLlmFeedback(msg, 'error');
+    setSettingsFeedback(msg, 'error');
+    return;
+  }
   void saveLlmProvider(next);
 }
 

package/public/index.html

@@ -286,6 +286,7 @@
             <div class="review-detail" id="review-detail">
               <div class="empty-dashed" id="review-empty-detail">Select a job to review</div>
               <div class="stack hidden" id="review-detail-content">
+                <p class="review-agent-meta" id="review-agent-meta"></p>
                 <div class="card" id="review-pr-meta-card">
                   <div class="field-label">PR title</div>
                   <input
@@ -668,7 +669,7 @@
                       <button type="button" class="source-btn active" data-provider="claude">Claude</button>
                       <button type="button" class="source-btn" data-provider="openrouter">OpenRouter</button>
                     </div>
-                    <p class="field-hint">Claude uses the Claude Agent SDK. OpenRouter uses <code>@openrouter/agent</code> with the same coding tools (any catalog model).</p>
+                    <p class="field-hint" id="settings-llm-provider-hint">Claude uses the Claude Agent SDK. OpenRouter uses <code>@openrouter/agent</code> with the same coding tools (any catalog model). A provider stays disabled until it is configured and authenticated.</p>
                   </div>
                   <div class="settings-grid">
                     <div class="settings-field">

package/public/styles.css

@@ -1064,6 +1064,13 @@ a { color: var(--primary); text-underline-offset: 3px; }
   color: var(--text-muted);
 }
 
+.review-agent-meta {
+  margin: 0 0 4px;
+  font-size: 13px;
+  color: var(--text-muted);
+  font-variant-numeric: tabular-nums;
+}
+
 .btn-remove {
   width: 26px;
   height: 26px;
@@ -2468,7 +2475,7 @@ body.diff-fs-open {
   letter-spacing: 0.02em;
 }
 
-.source-btn:hover:not(.active) {
+.source-btn:hover:not(.active):not(:disabled) {
   color: var(--text);
   background: color-mix(in srgb, var(--text) 4%, transparent);
 }
@@ -2480,6 +2487,16 @@ body.diff-fs-open {
   box-shadow: var(--shadow-sm);
 }
 
+.source-btn:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.source-btn.active:disabled {
+  opacity: 0.7;
+  cursor: default;
+}
+
 .enqueue-jira-hint {
   margin: 0;
   font-size: 12px;

package/src/config.js

@@ -91,6 +91,42 @@ export function normalizeLlmProvider(value) {
   return value === 'openrouter' ? 'openrouter' : 'claude';
 }
 
+/**
+ * Block enabling an LLM provider that is not authenticated.
+ * Stub-agent skips the check (UI-only testing without credentials).
+ * @param {unknown} nextProvider
+ * @param {{
+ *   stubAgent?: boolean,
+ *   claudeAuth?: import('./claude-auth.js').ClaudeAuthResult,
+ *   openrouterAuth?: import('./openrouter-auth.js').OpenRouterAuthResult,
+ * }} [opts]
+ * @returns {{ error: string, code: string } | null}
+ */
+export function llmProviderAuthGate(nextProvider, opts = {}) {
+  if (opts.stubAgent === true) return null;
+  const provider = normalizeLlmProvider(nextProvider);
+  if (provider === 'openrouter') {
+    const or = opts.openrouterAuth ?? checkOpenRouterAuth();
+    if (!or.ok) {
+      return {
+        error:
+          'OpenRouter is not authenticated. Add an API key in Settings → Authentication before enabling OpenRouter.',
+        code: 'openrouter_auth_required',
+      };
+    }
+    return null;
+  }
+  const claude = opts.claudeAuth ?? checkClaudeAuth();
+  if (!claude.ok) {
+    return {
+      error:
+        'Claude is not authenticated. Add an API key or OAuth token in Settings → Authentication, or run claude auth login, before enabling Claude.',
+      code: 'claude_auth_required',
+    };
+  }
+  return null;
+}
+
 /**
  * @param {unknown} raw
  * @returns {{ claude?: string, openrouter?: string }}

package/src/server.js

@@ -33,11 +33,16 @@ import {
   runAgentOnReviewFeedback,
   stripAiAttribution,
 } from './agent.js';
-import { publicConfig, updateConfig, normalizeLlmProvider } from './config.js';
+import {
+  publicConfig,
+  updateConfig,
+  normalizeLlmProvider,
+  llmProviderAuthGate,
+} from './config.js';
 import { upsertEnvVars } from './env.js';
 import { listModels } from './models.js';
 import { splitIssueUrls } from './urls.js';
-import { usageFromLogs, withJobUsage } from './usage.js';
+import { usageFromLogs, withJobUsage, snapshotJobLlm, tagUsageProvider } from './usage.js';
 import { checkGhAuth } from './gh-auth.js';
 import { checkClaudeAuth } from './claude-auth.js';
 import { checkOpenRouterAuth } from './openrouter-auth.js';
@@ -304,6 +309,25 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
     return store.updateJob(job.id, { logs });
   }
 
+  /**
+   * Persist current LLM provider/model on the job and emit a log line.
+   * @param {string} jobId
+   */
+  function stampJobLlm(jobId) {
+    const snap = snapshotJobLlm(config);
+    let job = store.getJob(jobId);
+    if (!job) return undefined;
+    job = store.updateJob(jobId, snap);
+    job = appendLog(job, 'llm', {
+      provider: snap.llmProvider,
+      model: snap.model,
+    });
+    if (job?.logs?.length) {
+      emitEvent(jobId, job.logs[job.logs.length - 1]);
+    }
+    return job;
+  }
+
   function setStatus(jobId, status, extra = {}) {
     if (!store.getJob(jobId)) return undefined;
     const job = store.updateJob(jobId, { status, ...extra });
@@ -330,6 +354,9 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
       return;
     }
 
+    job = stampJobLlm(jobId);
+    if (!job) return;
+
     try {
       job = setStatus(jobId, 'syncing');
       if (!job) return;
@@ -432,7 +459,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         prTitle: stripAiAttribution(prTitle),
         prBody: stripAiAttribution(prBody),
       };
-      if (usage) patch.usage = usage;
+      if (usage) patch.usage = tagUsageProvider(usage, config.llmProvider);
       setStatus(jobId, 'awaiting_review', patch);
     } catch (err) {
       const message = formatAgentJobError(err);
@@ -445,7 +472,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         status: 'failed',
         error: message,
       };
-      if (usage) failPatch.usage = usage;
+      if (usage) failPatch.usage = tagUsageProvider(usage, config.llmProvider);
       store.updateJob(jobId, failPatch);
       const updated = store.getJob(jobId);
       if (updated?.logs?.length) {
@@ -492,6 +519,9 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
       return;
     }
 
+    job = stampJobLlm(jobId);
+    if (!job) return;
+
     try {
       const onEvent = (message) => {
         const current = store.getJob(jobId);
@@ -533,7 +563,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         prBody: stripAiAttribution(prBody),
         pendingReviewFeedback: undefined,
       };
-      if (usage) patch.usage = usage;
+      if (usage) patch.usage = tagUsageProvider(usage, config.llmProvider);
       setStatus(jobId, 'awaiting_review', patch);
     } catch (err) {
       const message = formatAgentJobError(err);
@@ -547,7 +577,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         error: message,
         pendingReviewFeedback: undefined,
       };
-      if (usage) failPatch.usage = usage;
+      if (usage) failPatch.usage = tagUsageProvider(usage, config.llmProvider);
       store.updateJob(jobId, failPatch);
       const updated = store.getJob(jobId);
       if (updated?.logs?.length) {
@@ -657,6 +687,21 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         openrouterApiKey: _or,
         ...configPatch
       } = patch;
+
+      if (configPatch.llmProvider === 'claude' || configPatch.llmProvider === 'openrouter') {
+        const next = configPatch.llmProvider;
+        if (next !== normalizeLlmProvider(config.llmProvider)) {
+          const gate = llmProviderAuthGate(next, {
+            stubAgent: useStubAgent,
+            claudeAuth: doCheckClaudeAuth(),
+            openrouterAuth: checkOpenRouterAuth(),
+          });
+          if (gate) {
+            return res.status(400).json(gate);
+          }
+        }
+      }
+
       updateConfig(repoRoot, config, configPatch);
       res.json(publicConfigPayload());
     } catch (err) {
@@ -796,12 +841,15 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
           skipped.push(item.jiraKey || item.url);
           continue;
         }
+        const llm = snapshotJobLlm(config);
         const job = store.addJob({
           issueUrl: item.url,
           issueNumber: item.number,
           ticketSource: item.ticketSource,
           jiraKey: item.jiraKey,
           ...(preferredBranchName ? { preferredBranchName } : {}),
+          llmProvider: llm.llmProvider,
+          model: llm.model,
         });
         created.push(job);
       }
@@ -1135,6 +1183,7 @@ export function createServer({ repoRoot, config, store, useStubAgent = false, de
         usage: undefined,
         pendingReviewFeedback: undefined,
         latestReviewComments: undefined,
+        ...snapshotJobLlm(config),
       });
       updated = appendLog(updated, 'status', 'retry queued');
       res.json(updated);

package/src/store.js

@@ -53,21 +53,27 @@ export class Store {
    * @param {{
    *   issueUrl: string,
    *   issueNumber?: number,
-   *   ticketSource?: 'github' | 'jira',
-   *   jiraKey?: string,
-   *   preferredBranchName?: string,
-   * }} data
-   * @returns {Job}
-   */
+ *   ticketSource?: 'github' | 'jira',
+ *   jiraKey?: string,
+ *   preferredBranchName?: string,
+ *   llmProvider?: 'claude' | 'openrouter',
+ *   model?: string,
+ * }} data
+ * @returns {Job}
+ */
   addJob(data) {
     const now = new Date().toISOString();
     const ticketSource = data.ticketSource === 'jira' ? 'jira' : 'github';
+    const llmProvider = data.llmProvider === 'openrouter' ? 'openrouter' : 'claude';
+    const model = typeof data.model === 'string' ? data.model.trim() : '';
     /** @type {Job} */
     const job = {
       id: randomUUID(),
       issueUrl: data.issueUrl,
       issueNumber: data.issueNumber,
       ticketSource,
+      llmProvider,
+      ...(model ? { model } : {}),
       ...(data.jiraKey ? { jiraKey: data.jiraKey } : {}),
       ...(data.preferredBranchName ? { preferredBranchName: data.preferredBranchName } : {}),
       status: 'queued',

package/src/usage.js

@@ -11,6 +11,7 @@
  * @property {number} [cacheCreationInputTokens]
  * @property {number} [numTurns]
  * @property {number} [durationMs]
+ * @property {'claude' | 'openrouter'} [provider]
  * @property {Record<string, object>} [modelUsage]
  */
 
@@ -23,6 +24,73 @@ function asFiniteNumber(n) {
   return n;
 }
 
+/**
+ * @param {object | null | undefined} job
+ * @returns {'claude' | 'openrouter'}
+ */
+export function jobLlmProvider(job) {
+  if (job?.llmProvider === 'openrouter') return 'openrouter';
+  if (job?.llmProvider === 'claude') return 'claude';
+  if (job?.usage?.provider === 'openrouter') return 'openrouter';
+  if (job?.usage?.provider === 'claude') return 'claude';
+  const model = String(job?.model || '');
+  return model.includes('/') ? 'openrouter' : 'claude';
+}
+
+/**
+ * Snapshot of the LLM used for a job (enqueue / run start).
+ * @param {object | null | undefined} config
+ * @returns {{ llmProvider: 'claude' | 'openrouter', model: string }}
+ */
+export function snapshotJobLlm(config) {
+  const llmProvider = config?.llmProvider === 'openrouter' ? 'openrouter' : 'claude';
+  const model = typeof config?.model === 'string' ? config.model.trim() : '';
+  return { llmProvider, model: model || '-' };
+}
+
+/**
+ * @param {JobUsage | null | undefined} usage
+ * @param {'claude' | 'openrouter' | string | undefined} provider
+ * @returns {JobUsage | null | undefined}
+ */
+export function tagUsageProvider(usage, provider) {
+  if (!usage || typeof usage !== 'object') return usage;
+  const p = provider === 'openrouter' ? 'openrouter' : 'claude';
+  return { ...usage, provider: p };
+}
+
+/**
+ * @typedef {{ totalCostUsd: number, totalTokens: number, withCost: number, withTokens: number }} UsageAgg
+ * @param {object[]} jobs
+ * @returns {{ claude: UsageAgg, openrouter: UsageAgg }}
+ */
+export function aggregateUsageByProvider(jobs) {
+  const empty = () => ({
+    totalCostUsd: 0,
+    totalTokens: 0,
+    withCost: 0,
+    withTokens: 0,
+  });
+  /** @type {{ claude: UsageAgg, openrouter: UsageAgg }} */
+  const out = { claude: empty(), openrouter: empty() };
+  if (!Array.isArray(jobs)) return out;
+  for (const job of jobs) {
+    const u = job?.usage;
+    if (!u) continue;
+    const bucket = out[jobLlmProvider(job)];
+    if (typeof u.totalCostUsd === 'number' && Number.isFinite(u.totalCostUsd)) {
+      bucket.totalCostUsd += u.totalCostUsd;
+      bucket.withCost += 1;
+    }
+    const tok = (u.inputTokens || 0) + (u.outputTokens || 0);
+    if (tok > 0) {
+      bucket.totalTokens += tok;
+      bucket.withTokens += 1;
+    }
+  }
+  return out;
+}
+
 /**
  * Extract usage from an SDK `result` message (success or error subtypes).
  * @param {object | null | undefined} message