mixdog 0.8.0 → 0.9.0

package/src/standalone/seeds.mjs

@@ -1,60 +1,7 @@
-import { copyFileSync, existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 
 const DEFAULT_DATA_FILES = [];
-const DEFAULT_MIXDOG_MD = `# Mixdog Instructions
-
-Use this file for Mixdog-specific user and project context.
-
-- Keep stable preferences, workflow notes, and project conventions here.
-- Mixdog loads this file as context for new sessions.
-- Edit or replace this content at any time.
-`;
-
-const DEFAULT_PROJECT_MIXDOG_MD = `# Mixdog Instructions
-
-Use this file for project-specific Mixdog context.
-
-- Add stable project conventions, commands, and workflow notes here.
-- Mixdog loads this file from the project root for new sessions.
-- Edit or replace this content at any time.
-`;
-
-function isDirectory(path) {
-  try {
-    return statSync(path).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-function hasProjectSentinel(dir) {
-  return existsSync(join(dir, '.git'))
-    || existsSync(join(dir, 'package.json'))
-    || existsSync(join(dir, 'pyproject.toml'))
-    || existsSync(join(dir, 'Cargo.toml'))
-    || existsSync(join(dir, 'go.mod'))
-    || existsSync(join(dir, 'mixdog.md'))
-    || existsSync(join(dir, 'Mixdog.md'))
-    || existsSync(join(dir, 'AGENTS.md'));
-}
-
-function resolveProjectRoot(cwd) {
-  if (!cwd || typeof cwd !== 'string') return null;
-  let cur;
-  try {
-    cur = resolve(cwd);
-  } catch {
-    return null;
-  }
-  if (!isDirectory(cur)) return null;
-  while (true) {
-    if (hasProjectSentinel(cur)) return cur;
-    const parent = dirname(cur);
-    if (parent === cur) return null;
-    cur = parent;
-  }
-}
 
 export function ensureStandaloneEnvironment({ rootDir, dataDir }) {
   if (!rootDir) throw new Error('standalone rootDir is required');
@@ -70,10 +17,6 @@ export function ensureStandaloneEnvironment({ rootDir, dataDir }) {
   process.env.MIXDOG_PATCH_NATIVE_PREWARM ??= '0';
 
   mkdirSync(dataDir, { recursive: true });
-  const mixdogMdPath = join(dataDir, 'mixdog.md');
-  if (!existsSync(mixdogMdPath)) {
-    writeFileSync(mixdogMdPath, DEFAULT_MIXDOG_MD, { encoding: 'utf8', mode: 0o600 });
-  }
   for (const file of DEFAULT_DATA_FILES) {
     const from = join(rootDir, 'defaults', file);
     const to = join(dataDir, file);
@@ -82,13 +25,3 @@ export function ensureStandaloneEnvironment({ rootDir, dataDir }) {
     copyFileSync(from, to);
   }
 }
-
-export function ensureProjectMixdogMd({ cwd } = {}) {
-  const projectRoot = resolveProjectRoot(cwd);
-  if (!projectRoot) return null;
-  const target = join(projectRoot, 'Mixdog.md');
-  if (!existsSync(target)) {
-    writeFileSync(target, DEFAULT_PROJECT_MIXDOG_MD, { encoding: 'utf8', mode: 0o600 });
-  }
-  return target;
-}

package/src/standalone/usage-dashboard.mjs

@@ -122,6 +122,23 @@ function snapshotUsage(snapshot) {
   };
 }
 
+function snapshotTokenUsage(snapshot) {
+  const value = snapshot?.tokenUsage;
+  if (!value || typeof value !== 'object') return null;
+  const inputTokens = num(value.inputTokens ?? value.input_tokens, 0);
+  const outputTokens = num(value.outputTokens ?? value.output_tokens, 0);
+  const cachedInputTokens = num(value.cachedInputTokens ?? value.cached_input_tokens, 0);
+  const requests = num(value.requests ?? value.numModelRequests ?? value.num_model_requests, 0);
+  if (!inputTokens && !outputTokens && !cachedInputTokens && !requests) return null;
+  return {
+    inputTokens,
+    outputTokens,
+    cachedInputTokens,
+    requests,
+    source: clean(value.source) || clean(snapshot?.source) || 'provider-api',
+  };
+}
+
 function displayWindow(w) {
   const label = String(w?.label || 'USE').toUpperCase();
   if (num(w?.remainingUsd, null) !== null) return `${label} ${money(w.remainingUsd)}`;
@@ -135,8 +152,8 @@ function displayWindow(w) {
 
 function providerDescription(id, group) {
   switch (String(id || '').toLowerCase()) {
-    case 'openai-oauth': return 'ChatGPT/Codex subscription quota';
-    case 'anthropic-oauth': return 'Claude Code subscription quota';
+    case 'openai-oauth': return 'OpenAI OAuth subscription quota';
+    case 'anthropic-oauth': return 'Anthropic OAuth subscription quota';
     case 'grok-oauth': return 'Grok Build subscription quota';
     case 'opencode-go': return 'OpenCode Go subscription quota';
     case 'openai': return 'OpenAI API billing';
@@ -150,6 +167,42 @@ function providerDescription(id, group) {
   }
 }
 
+function snapshotUnavailable(snapshot) {
+  const value = snapshot?.unavailable;
+  return value && typeof value === 'object' ? value : null;
+}
+
+function apiUnavailableDetail(id, snapshot) {
+  const providerId = String(id || '').toLowerCase();
+  const unavailable = snapshotUnavailable(snapshot);
+  const message = clean(unavailable?.message);
+  if (providerId === 'openai') {
+    if (/invalid|incorrect api key|unauthorized/i.test(message)) return `OpenAI usage probe failed: ${message}`;
+    if (/api\.usage\.read|insufficient permissions/i.test(message)) {
+      return 'OpenAI spend needs api.usage.read; remaining credit is web UI only';
+    }
+    if (message) return `OpenAI usage probe failed: ${message}; remaining credit is web UI only`;
+    return 'OpenAI API does not expose remaining credit; org spend needs api.usage.read';
+  }
+  if (providerId === 'anthropic') {
+    if (message) return `Anthropic cost probe: ${message}`;
+    return 'Anthropic balance is Console-only; usage needs ANTHROPIC_ADMIN_API_KEY';
+  }
+  if (providerId === 'gemini') return 'Gemini balance is AI Studio/Cloud Billing only; no key-scope probe';
+  if (providerId === 'xai') return message || 'xAI balance needs XAI_MANAGEMENT_API_KEY and XAI_TEAM_ID';
+  if (providerId === 'deepseek') return message ? `DeepSeek balance unavailable: ${message}` : 'DeepSeek balance unavailable';
+  return message || 'Usage not exposed';
+}
+
+function applyApiUnavailable(row, id, snapshot) {
+  row.status = 'hidden';
+  row.source = snapshotUnavailable(snapshot) ? 'provider-api-unavailable' : 'provider-hidden';
+  row.sourceLabel = 'unavailable';
+  row.primary = '';
+  row.detail = apiUnavailableDetail(id, snapshot);
+  return row;
+}
+
 function rowTone(row) {
   if (row.status === 'error') return 'error';
   if (row.status === 'missing') return 'missing';
@@ -263,6 +316,19 @@ function applyKnownUsage(row, known) {
   return row;
 }
 
+function applyTokenUsage(row, usage) {
+  if (!usage) return row;
+  const totalTokens = num(usage.inputTokens, 0) + num(usage.outputTokens, 0);
+  row.status = 'partial';
+  row.source = usage.source || 'provider-api';
+  row.sourceLabel = 'usage';
+  row.primary = `${compactNumber(totalTokens)} tokens`;
+  row.detail = `${compactNumber(usage.inputTokens)} in · ${compactNumber(usage.outputTokens)} out${usage.requests ? ` · ${compactNumber(usage.requests)} req` : ''}`;
+  row.includeInTotal = false;
+  row.totalBucket = null;
+  return row;
+}
+
 function applyWindowQuota(row, windows, { source = 'quota', detail = 'quota windows' } = {}) {
   const normalized = normaliseWindows(windows, source);
   if (!normalized.length) return false;
@@ -341,6 +407,7 @@ export async function createUsageDashboard(config = {}, options = {}) {
   const rows = [];
   const checkedAt = Date.now();
   const refresh = options.refresh === true;
+  const preview = options.preview === true;
   const emit = (checking = true) => emitUsageDashboard(
     options,
     usageDashboardSnapshot(rows, { checkedAt, refresh, checking }),
@@ -358,6 +425,10 @@ export async function createUsageDashboard(config = {}, options = {}) {
     rows.push(row);
     emit(true);
 
+    if (preview) {
+      return row;
+    }
+
     if (!row.authenticated) {
       row.status = 'missing';
       row.source = 'not-configured';
@@ -366,6 +437,7 @@ export async function createUsageDashboard(config = {}, options = {}) {
       row.detail = 'Configure auth';
     } else {
       let hasQuota = false;
+      let apiUsageSnapshot = null;
       if (item.id === 'opencode-go') {
         const usageStatus = openCodeGoUsageConfigStatus(config);
         try {
@@ -400,9 +472,12 @@ export async function createUsageDashboard(config = {}, options = {}) {
         }
       } else {
         const snapshot = await apiSnapshot(item.id, options);
+        apiUsageSnapshot = snapshot;
         const known = snapshotRemaining(snapshot);
         const usage = snapshotUsage(snapshot);
+        const tokenUsage = snapshotTokenUsage(snapshot);
         const windows = normaliseWindows(snapshot?.quotaWindows, clean(snapshot?.source) || 'provider-api');
+        const estimated = localBudget(providerCfg);
         row.updatedAt = num(snapshot?.cachedAt, null);
         if (known) {
           applyKnownRemaining(row, known, { estimated: false });
@@ -413,17 +488,26 @@ export async function createUsageDashboard(config = {}, options = {}) {
             source: clean(snapshot?.source) || 'provider-api',
             detail: 'provider quota',
           });
+        } else if (estimated) {
+          applyKnownRemaining(row, estimated, { estimated: true });
+          hasQuota = true;
         } else if (usage) {
           applyKnownUsage(row, usage);
           hasQuota = true;
+        } else if (tokenUsage) {
+          applyTokenUsage(row, tokenUsage);
+          hasQuota = true;
+        }
+      }
+      if (!row.includeInTotal && !hasQuota) {
+        const estimated = localBudget(providerCfg);
+        if (estimated) {
+          applyKnownRemaining(row, estimated, { estimated: true });
+          hasQuota = true;
         }
       }
       if (item.id !== 'opencode-go' && !row.includeInTotal && !hasQuota) {
-        row.status = 'hidden';
-        row.source = 'provider-hidden';
-        row.sourceLabel = 'hidden';
-        row.primary = '';
-        row.detail = 'Usage not exposed';
+        applyApiUnavailable(row, item.id, apiUsageSnapshot);
       }
     }
     row.tone = rowTone(row);
@@ -443,6 +527,10 @@ export async function createUsageDashboard(config = {}, options = {}) {
     rows.push(row);
     emit(true);
 
+    if (preview) {
+      return row;
+    }
+
     if (!row.authenticated) {
       row.status = 'missing';
       row.source = 'not-configured';
@@ -504,7 +592,7 @@ export async function createUsageDashboard(config = {}, options = {}) {
 
   await Promise.all([...apiTasks, ...oauthTasks]);
 
-  const dashboard = usageDashboardSnapshot(rows, { checkedAt, refresh, checking: false });
+  const dashboard = usageDashboardSnapshot(rows, { checkedAt, refresh, checking: preview });
   emitUsageDashboard(options, dashboard);
   return dashboard;
 }