Skip to content

AI-native design editor. Open-source Figma alternative.

feat(diagnostics): add local usage and diagnostics foundation

Danila Poyarkov5f8a373b2b40
diff --git a/packages/vue/src/i18n/locales/de/dialogs.json b/packages/vue/src/i18n/locales/de/dialogs.json
index a5dc8988d..67e5ddbf3 100644
--- a/packages/vue/src/i18n/locales/de/dialogs.json
+++ b/packages/vue/src/i18n/locales/de/dialogs.json
@@ -354,5 +354,39 @@
"mcpStatus_starting": "Starting",
"mcpStatus_running": "Running",
"mcpStatus_stopped": "Stopped",
- "mcpStatus_error": "Error"
+ "mcpStatus_error": "Error",
+ "settingsUsage": "Nutzung",
+ "settingsDiagnostics": "Diagnose",
+ "usageDescription": "Lokale Nutzungszusammenfassungen aus aufgezeichneten AI-Anfragen.",
+ "usageRequests": "Anfragen",
+ "usageCompleted": "Abgeschlossen",
+ "usageInputTokens": "Eingabe-Tokens",
+ "usageOutputTokens": "Ausgabe-Tokens",
+ "usageByModel": "Nach Modell",
+ "usageNoData": "Keine Nutzungsdaten aufgezeichnet.",
+ "usageNotReported": "Nicht gemeldet",
+ "usageCacheNote": "Cache-Werte werden nur angezeigt, wenn der Anbieter sie meldet.",
+ "diagnosticsTitle": "Diagnose",
+ "diagnosticsModelStepCompleted": "KI-Modellschritt abgeschlossen",
+ "diagnosticsChatCompleted": "KI-Chat abgeschlossen",
+ "diagnosticsChatFailed": "KI-Chat fehlgeschlagen",
+ "diagnosticsStorageFailed": "Speichervorgang fehlgeschlagen",
+ "diagnosticsDocumentFailed": "Dokumentvorgang fehlgeschlagen",
+ "diagnosticsACPFailed": "ACP-Transport fehlgeschlagen",
+ "diagnosticsMCPFailed": "MCP-Verbindung fehlgeschlagen",
+ "diagnosticsTechnicalEvent": "Technisches Ereignis",
+ "diagnosticsRetention": "Aufbewahrungsdauer der Diagnose",
+ "diagnosticsRetentionDescription": "Bis zu dieser Anzahl aktueller Ereignisse lokal speichern.",
+ "diagnosticsDescription": "Technische Ereignisse lokal speichern, um OpenPencil zu unterstützen. Prompts, Designinhalte, Zugangsdaten und API-Schlüssel werden ausgeschlossen.",
+ "localDiagnostics": "Lokale Diagnose",
+ "localDiagnosticsDescription": "Letzte technische Ereignisse auf diesem Gerät speichern.",
+ "usageHistory": "Nutzungsverlauf",
+ "usageHistoryDescription": "Lokale Zusammenfassungen der AI-Nutzung speichern.",
+ "diagnosticsEventCount": "{count} Ereignisse · {size} KB",
+ "diagnosticsCopy": "Diagnosedaten kopieren",
+ "diagnosticsClear": "Löschen",
+ "diagnosticsClearDescription": "Dadurch werden lokal gespeicherte Diagnosedaten von diesem Gerät entfernt.",
+ "diagnosticsCleared": "Diagnosedaten gelöscht.",
+ "diagnosticsCopied": "Diagnosedaten in die Zwischenablage kopiert.",
+ "diagnosticsCopyFailed": "Diagnosedaten konnten nicht in die Zwischenablage kopiert werden."
}
diff --git a/packages/vue/src/i18n/locales/es/dialogs.json b/packages/vue/src/i18n/locales/es/dialogs.json
index 702387da4..359fabcad 100644
--- a/packages/vue/src/i18n/locales/es/dialogs.json
+++ b/packages/vue/src/i18n/locales/es/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "Recuperación",
"settingsRecoveryDescription": "Controla las copias locales de recuperación de documentos no guardados.",
"preserveUnsavedWork": "Conservar automáticamente el trabajo no guardado",
- "preserveUnsavedWorkDescription": "Guarda copias locales para restaurar documentos después de un cierre inesperado."
+ "preserveUnsavedWorkDescription": "Guarda copias locales para restaurar documentos después de un cierre inesperado.",
+ "settingsUsage": "Uso",
+ "settingsDiagnostics": "Diagnóstico",
+ "usageDescription": "Resúmenes locales de uso de solicitudes de AI registradas.",
+ "usageRequests": "Solicitudes",
+ "usageCompleted": "Completadas",
+ "usageInputTokens": "Tokens de entrada",
+ "usageOutputTokens": "Tokens de salida",
+ "usageByModel": "Por modelo",
+ "usageNoData": "No hay datos de uso registrados.",
+ "usageNotReported": "No informado",
+ "usageCacheNote": "Los valores de caché solo se muestran cuando el proveedor los informa.",
+ "diagnosticsTitle": "Diagnóstico",
+ "diagnosticsModelStepCompleted": "Paso del modelo de AI completado",
+ "diagnosticsChatCompleted": "Chat de AI completado",
+ "diagnosticsChatFailed": "Chat de AI fallido",
+ "diagnosticsStorageFailed": "Operación de almacenamiento fallida",
+ "diagnosticsDocumentFailed": "Operación de documento fallida",
+ "diagnosticsACPFailed": "Transporte ACP fallido",
+ "diagnosticsMCPFailed": "Conexión MCP fallida",
+ "diagnosticsTechnicalEvent": "Evento técnico",
+ "diagnosticsRetention": "Retención de diagnósticos",
+ "diagnosticsRetentionDescription": "Conserva localmente hasta este número de eventos recientes.",
+ "diagnosticsDescription": "Guarda eventos técnicos localmente para ayudar a solucionar problemas de OpenPencil. Se excluyen prompts, contenido de diseño, credenciales y claves API.",
+ "localDiagnostics": "Diagnóstico local",
+ "localDiagnosticsDescription": "Conserva eventos técnicos recientes en este dispositivo.",
+ "usageHistory": "Historial de uso",
+ "usageHistoryDescription": "Conserva resúmenes locales del uso de AI.",
+ "diagnosticsEventCount": "{count} eventos · {size} KB",
+ "diagnosticsCopy": "Copiar diagnóstico",
+ "diagnosticsClear": "Borrar",
+ "diagnosticsClearDescription": "Esto elimina del dispositivo los eventos de diagnóstico almacenados localmente.",
+ "diagnosticsCleared": "Diagnóstico borrado.",
+ "diagnosticsCopied": "Diagnóstico copiado al portapapeles.",
+ "diagnosticsCopyFailed": "No se pudo copiar el diagnóstico al portapapeles."
}
diff --git a/packages/vue/src/i18n/locales/fr/dialogs.json b/packages/vue/src/i18n/locales/fr/dialogs.json
index f3a319062..8670aca65 100644
--- a/packages/vue/src/i18n/locales/fr/dialogs.json
+++ b/packages/vue/src/i18n/locales/fr/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "Récupération",
"settingsRecoveryDescription": "Gérez les copies locales de récupération des documents non enregistrés.",
"preserveUnsavedWork": "Conserver automatiquement le travail non enregistré",
- "preserveUnsavedWorkDescription": "Stockez des copies locales afin de restaurer les documents après un arrêt inattendu."
+ "preserveUnsavedWorkDescription": "Stockez des copies locales afin de restaurer les documents après un arrêt inattendu.",
+ "settingsUsage": "Utilisation",
+ "settingsDiagnostics": "Diagnostics",
+ "usageDescription": "Résumé local des requêtes d’IA enregistrées.",
+ "usageRequests": "Requêtes",
+ "usageCompleted": "Terminées",
+ "usageInputTokens": "Tokens d’entrée",
+ "usageOutputTokens": "Tokens de sortie",
+ "usageByModel": "Par modèle",
+ "usageNoData": "Aucune donnée d’utilisation enregistrée.",
+ "usageNotReported": "Non communiqué",
+ "usageCacheNote": "Les valeurs de cache sont affichées uniquement lorsque le fournisseur les communique.",
+ "diagnosticsTitle": "Diagnostics",
+ "diagnosticsModelStepCompleted": "Étape du modèle IA terminée",
+ "diagnosticsChatCompleted": "Chat IA terminé",
+ "diagnosticsChatFailed": "Échec du chat IA",
+ "diagnosticsStorageFailed": "Échec de l’opération de stockage",
+ "diagnosticsDocumentFailed": "Échec de l’opération sur le document",
+ "diagnosticsACPFailed": "Échec du transport ACP",
+ "diagnosticsMCPFailed": "Échec de la connexion MCP",
+ "diagnosticsTechnicalEvent": "Événement technique",
+ "diagnosticsRetention": "Rétention des diagnostics",
+ "diagnosticsRetentionDescription": "Conservez localement jusqu’à ce nombre d’événements récents.",
+ "diagnosticsDescription": "Stockez localement les événements techniques pour faciliter le dépannage d’OpenPencil. Les prompts, contenus de conception, identifiants et clés API sont exclus.",
+ "localDiagnostics": "Diagnostics locaux",
+ "localDiagnosticsDescription": "Conserver les événements techniques récents sur cet appareil.",
+ "usageHistory": "Historique d’utilisation",
+ "usageHistoryDescription": "Conserver les résumés locaux de l’utilisation de l’IA.",
+ "diagnosticsEventCount": "{count} événements · {size} Ko",
+ "diagnosticsCopy": "Copier les diagnostics",
+ "diagnosticsClear": "Effacer",
+ "diagnosticsClearDescription": "Cette action supprime de cet appareil les événements de diagnostic stockés localement.",
+ "diagnosticsCleared": "Diagnostics effacés.",
+ "diagnosticsCopied": "Diagnostics copiés dans le presse-papiers.",
+ "diagnosticsCopyFailed": "Impossible de copier les diagnostics dans le presse-papiers."
}
diff --git a/packages/vue/src/i18n/locales/it/dialogs.json b/packages/vue/src/i18n/locales/it/dialogs.json
index e9d7a0f7d..5fd051a87 100644
--- a/packages/vue/src/i18n/locales/it/dialogs.json
+++ b/packages/vue/src/i18n/locales/it/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "Ripristino",
"settingsRecoveryDescription": "Gestisci le copie locali di ripristino dei documenti non salvati.",
"preserveUnsavedWork": "Conserva automaticamente il lavoro non salvato",
- "preserveUnsavedWorkDescription": "Salva copie locali per ripristinare i documenti dopo una chiusura imprevista."
+ "preserveUnsavedWorkDescription": "Salva copie locali per ripristinare i documenti dopo una chiusura imprevista.",
+ "settingsUsage": "Utilizzo",
+ "settingsDiagnostics": "Diagnostica",
+ "usageDescription": "Riepiloghi locali delle richieste AI registrate.",
+ "usageRequests": "Richieste",
+ "usageCompleted": "Completate",
+ "usageInputTokens": "Token di input",
+ "usageOutputTokens": "Token di output",
+ "usageByModel": "Per modello",
+ "usageNoData": "Nessun dato di utilizzo registrato.",
+ "usageNotReported": "Non segnalato",
+ "usageCacheNote": "I valori della cache vengono mostrati solo quando il provider li segnala.",
+ "diagnosticsTitle": "Diagnostica",
+ "diagnosticsModelStepCompleted": "Passaggio del modello AI completato",
+ "diagnosticsChatCompleted": "Chat AI completata",
+ "diagnosticsChatFailed": "Chat AI non riuscita",
+ "diagnosticsStorageFailed": "Operazione di archiviazione non riuscita",
+ "diagnosticsDocumentFailed": "Operazione sul documento non riuscita",
+ "diagnosticsACPFailed": "Trasporto ACP non riuscito",
+ "diagnosticsMCPFailed": "Connessione MCP non riuscita",
+ "diagnosticsTechnicalEvent": "Evento tecnico",
+ "diagnosticsRetention": "Conservazione diagnostica",
+ "diagnosticsRetentionDescription": "Conserva localmente fino a questo numero di eventi recenti.",
+ "diagnosticsDescription": "Conserva localmente gli eventi tecnici per aiutare a risolvere i problemi di OpenPencil. Prompt, contenuti di design, credenziali e chiavi API sono esclusi.",
+ "localDiagnostics": "Diagnostica locale",
+ "localDiagnosticsDescription": "Conserva gli eventi tecnici recenti su questo dispositivo.",
+ "usageHistory": "Cronologia utilizzo",
+ "usageHistoryDescription": "Conserva i riepiloghi locali dell’utilizzo dell’AI.",
+ "diagnosticsEventCount": "{count} eventi · {size} KB",
+ "diagnosticsCopy": "Copia diagnostica",
+ "diagnosticsClear": "Cancella",
+ "diagnosticsClearDescription": "Questa operazione rimuove da questo dispositivo gli eventi diagnostici archiviati localmente.",
+ "diagnosticsCleared": "Diagnostica cancellata.",
+ "diagnosticsCopied": "Diagnostica copiata negli appunti.",
+ "diagnosticsCopyFailed": "Impossibile copiare la diagnostica negli appunti."
}
diff --git a/packages/vue/src/i18n/locales/ja/dialogs.json b/packages/vue/src/i18n/locales/ja/dialogs.json
index a6122e85d..21e369931 100644
--- a/packages/vue/src/i18n/locales/ja/dialogs.json
+++ b/packages/vue/src/i18n/locales/ja/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "復元",
"settingsRecoveryDescription": "未保存ドキュメントのローカル復元コピーを管理します。",
"preserveUnsavedWork": "未保存の作業を自動的に保持",
- "preserveUnsavedWorkDescription": "予期しない終了後にドキュメントを復元できるよう、ローカルコピーを保存します。"
+ "preserveUnsavedWorkDescription": "予期しない終了後にドキュメントを復元できるよう、ローカルコピーを保存します。",
+ "settingsUsage": "使用状況",
+ "settingsDiagnostics": "診断",
+ "usageDescription": "記録されたAIリクエストのローカル使用状況概要。",
+ "usageRequests": "リクエスト",
+ "usageCompleted": "完了",
+ "usageInputTokens": "入力トークン",
+ "usageOutputTokens": "出力トークン",
+ "usageByModel": "モデル別",
+ "usageNoData": "使用状況データはありません。",
+ "usageNotReported": "未報告",
+ "usageCacheNote": "キャッシュ値はプロバイダーから報告された場合のみ表示されます。",
+ "diagnosticsTitle": "診断",
+ "diagnosticsModelStepCompleted": "AIモデルのステップ完了",
+ "diagnosticsChatCompleted": "AIチャット完了",
+ "diagnosticsChatFailed": "AIチャット失敗",
+ "diagnosticsStorageFailed": "ストレージ操作失敗",
+ "diagnosticsDocumentFailed": "ドキュメント操作失敗",
+ "diagnosticsACPFailed": "ACPトランスポート失敗",
+ "diagnosticsMCPFailed": "MCP接続失敗",
+ "diagnosticsTechnicalEvent": "技術イベント",
+ "diagnosticsRetention": "診断データの保持数",
+ "diagnosticsRetentionDescription": "この数までの最新イベントを端末に保存します。",
+ "diagnosticsDescription": "OpenPencilのトラブルシューティングに役立つ技術イベントを端末に保存します。プロンプト、デザイン内容、認証情報、APIキーは除外されます。",
+ "localDiagnostics": "ローカル診断",
+ "localDiagnosticsDescription": "最近の技術イベントをこの端末に保存します。",
+ "usageHistory": "使用履歴",
+ "usageHistoryDescription": "AIの使用状況の概要を端末に保存します。",
+ "diagnosticsEventCount": "{count} 件 · {size} KB",
+ "diagnosticsCopy": "診断データをコピー",
+ "diagnosticsClear": "消去",
+ "diagnosticsClearDescription": "このデバイスに保存されている診断イベントを削除します。",
+ "diagnosticsCleared": "診断データを消去しました。",
+ "diagnosticsCopied": "診断データをクリップボードにコピーしました。",
+ "diagnosticsCopyFailed": "診断データをクリップボードにコピーできませんでした。"
}
diff --git a/packages/vue/src/i18n/locales/pl/dialogs.json b/packages/vue/src/i18n/locales/pl/dialogs.json
index 978a458e8..d8d334d9e 100644
--- a/packages/vue/src/i18n/locales/pl/dialogs.json
+++ b/packages/vue/src/i18n/locales/pl/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "Odzyskiwanie",
"settingsRecoveryDescription": "Zarządzaj lokalnymi kopiami odzyskiwania niezapisanych dokumentów.",
"preserveUnsavedWork": "Automatycznie zachowuj niezapisaną pracę",
- "preserveUnsavedWorkDescription": "Przechowuj lokalne kopie, aby odtworzyć dokumenty po nieoczekiwanym zamknięciu."
+ "preserveUnsavedWorkDescription": "Przechowuj lokalne kopie, aby odtworzyć dokumenty po nieoczekiwanym zamknięciu.",
+ "settingsUsage": "Użycie",
+ "settingsDiagnostics": "Diagnostyka",
+ "usageDescription": "Lokalne podsumowania zarejestrowanych żądań AI.",
+ "usageRequests": "Żądania",
+ "usageCompleted": "Ukończone",
+ "usageInputTokens": "Tokeny wejściowe",
+ "usageOutputTokens": "Tokeny wyjściowe",
+ "usageByModel": "Według modelu",
+ "usageNoData": "Brak zarejestrowanych danych użycia.",
+ "usageNotReported": "Nie zgłoszono",
+ "usageCacheNote": "Wartości pamięci podręcznej są wyświetlane tylko wtedy, gdy zgłasza je dostawca.",
+ "diagnosticsTitle": "Diagnostyka",
+ "diagnosticsModelStepCompleted": "Ukończono krok modelu AI",
+ "diagnosticsChatCompleted": "Ukończono czat AI",
+ "diagnosticsChatFailed": "Czat AI nie powiódł się",
+ "diagnosticsStorageFailed": "Operacja przechowywania nie powiodła się",
+ "diagnosticsDocumentFailed": "Operacja dokumentu nie powiodła się",
+ "diagnosticsACPFailed": "Transport ACP nie powiódł się",
+ "diagnosticsMCPFailed": "Połączenie MCP nie powiodło się",
+ "diagnosticsTechnicalEvent": "Zdarzenie techniczne",
+ "diagnosticsRetention": "Retencja diagnostyki",
+ "diagnosticsRetentionDescription": "Zachowuj lokalnie do tej liczby ostatnich zdarzeń.",
+ "diagnosticsDescription": "Zapisuj lokalnie zdarzenia techniczne, aby ułatwić rozwiązywanie problemów z OpenPencil. Prompty, zawartość projektu, dane logowania i klucze API są wykluczone.",
+ "localDiagnostics": "Diagnostyka lokalna",
+ "localDiagnosticsDescription": "Zachowuj ostatnie zdarzenia techniczne na tym urządzeniu.",
+ "usageHistory": "Historia użycia",
+ "usageHistoryDescription": "Zachowuj lokalne podsumowania użycia AI.",
+ "diagnosticsEventCount": "{count} zdarzeń · {size} KB",
+ "diagnosticsCopy": "Kopiuj diagnostykę",
+ "diagnosticsClear": "Wyczyść",
+ "diagnosticsClearDescription": "Spowoduje to usunięcie lokalnie zapisanych zdarzeń diagnostycznych z tego urządzenia.",
+ "diagnosticsCleared": "Wyczyszczono dane diagnostyczne.",
+ "diagnosticsCopied": "Skopiowano dane diagnostyczne do schowka.",
+ "diagnosticsCopyFailed": "Nie można skopiować danych diagnostycznych do schowka."
}
diff --git a/packages/vue/src/i18n/locales/ru/dialogs.json b/packages/vue/src/i18n/locales/ru/dialogs.json
index a9d802f81..60cd9a1b1 100644
--- a/packages/vue/src/i18n/locales/ru/dialogs.json
+++ b/packages/vue/src/i18n/locales/ru/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "Восстановление",
"settingsRecoveryDescription": "Управляйте локальными резервными копиями несохранённых документов.",
"preserveUnsavedWork": "Автоматически сохранять несохранённую работу",
- "preserveUnsavedWorkDescription": "Храните локальные копии, чтобы восстановить документы после неожиданного завершения работы."
+ "preserveUnsavedWorkDescription": "Храните локальные копии, чтобы восстановить документы после неожиданного завершения работы.",
+ "settingsUsage": "Использование",
+ "settingsDiagnostics": "Диагностика",
+ "usageDescription": "Локальная сводка записанных AI-запросов.",
+ "usageRequests": "Запросы",
+ "usageCompleted": "Завершённые",
+ "usageInputTokens": "Входные токены",
+ "usageOutputTokens": "Выходные токены",
+ "usageByModel": "По модели",
+ "usageNoData": "Данных об использовании нет.",
+ "usageNotReported": "Не сообщается",
+ "usageCacheNote": "Значения кэша отображаются только если их сообщает провайдер.",
+ "diagnosticsTitle": "Диагностика",
+ "diagnosticsModelStepCompleted": "Шаг AI-модели завершён",
+ "diagnosticsChatCompleted": "AI-чат завершён",
+ "diagnosticsChatFailed": "Ошибка AI-чата",
+ "diagnosticsStorageFailed": "Ошибка операции хранения",
+ "diagnosticsDocumentFailed": "Ошибка операции с документом",
+ "diagnosticsACPFailed": "Ошибка транспорта ACP",
+ "diagnosticsMCPFailed": "Ошибка подключения MCP",
+ "diagnosticsTechnicalEvent": "Техническое событие",
+ "diagnosticsRetention": "Срок хранения диагностики",
+ "diagnosticsRetentionDescription": "Сохранять локально не более этого числа последних событий.",
+ "diagnosticsDescription": "Сохраняйте технические события локально для диагностики OpenPencil. Промпты, содержимое дизайна, учётные данные и API-ключи не сохраняются.",
+ "localDiagnostics": "Локальная диагностика",
+ "localDiagnosticsDescription": "Сохранять последние технические события на этом устройстве.",
+ "usageHistory": "История использования",
+ "usageHistoryDescription": "Сохранять локальные сводки использования AI.",
+ "diagnosticsEventCount": "События: {count} · {size} КБ",
+ "diagnosticsCopy": "Скопировать диагностику",
+ "diagnosticsClear": "Очистить",
+ "diagnosticsClearDescription": "Локально сохранённые диагностические события будут удалены с этого устройства.",
+ "diagnosticsCleared": "Диагностические данные очищены.",
+ "diagnosticsCopied": "Диагностические данные скопированы в буфер обмена.",
+ "diagnosticsCopyFailed": "Не удалось скопировать диагностические данные в буфер обмена."
}
diff --git a/packages/vue/src/i18n/locales/zh-cn/dialogs.json b/packages/vue/src/i18n/locales/zh-cn/dialogs.json
index 17aa2ca77..1c0b1c06b 100644
--- a/packages/vue/src/i18n/locales/zh-cn/dialogs.json
+++ b/packages/vue/src/i18n/locales/zh-cn/dialogs.json
@@ -354,5 +354,39 @@
"settingsRecovery": "恢复",
"settingsRecoveryDescription": "管理未保存文档的本地恢复副本。",
"preserveUnsavedWork": "自动保留未保存的工作",
- "preserveUnsavedWorkDescription": "存储本地恢复副本,以便在意外关闭后恢复文档。"
+ "preserveUnsavedWorkDescription": "存储本地恢复副本,以便在意外关闭后恢复文档。",
+ "settingsUsage": "使用情况",
+ "settingsDiagnostics": "诊断",
+ "usageDescription": "已记录 AI 请求的本地使用摘要。",
+ "usageRequests": "请求数",
+ "usageCompleted": "已完成",
+ "usageInputTokens": "输入令牌",
+ "usageOutputTokens": "输出令牌",
+ "usageByModel": "按模型",
+ "usageNoData": "暂无使用数据。",
+ "usageNotReported": "未报告",
+ "usageCacheNote": "仅当提供商报告缓存值时才会显示。",
+ "diagnosticsTitle": "诊断",
+ "diagnosticsModelStepCompleted": "AI 模型步骤已完成",
+ "diagnosticsChatCompleted": "AI 聊天已完成",
+ "diagnosticsChatFailed": "AI 聊天失败",
+ "diagnosticsStorageFailed": "存储操作失败",
+ "diagnosticsDocumentFailed": "文档操作失败",
+ "diagnosticsACPFailed": "ACP 传输失败",
+ "diagnosticsMCPFailed": "MCP 连接失败",
+ "diagnosticsTechnicalEvent": "技术事件",
+ "diagnosticsRetention": "诊断数据保留量",
+ "diagnosticsRetentionDescription": "在本地保留不超过此数量的最新事件。",
+ "diagnosticsDescription": "在本地保存技术事件,帮助排查 OpenPencil 问题。不保存提示词、设计内容、凭据和 API 密钥。",
+ "localDiagnostics": "本地诊断",
+ "localDiagnosticsDescription": "在此设备上保留最近的技术事件。",
+ "usageHistory": "使用历史",
+ "usageHistoryDescription": "保留本地 AI 使用摘要。",
+ "diagnosticsEventCount": "{count} 个事件 · {size} KB",
+ "diagnosticsCopy": "复制诊断数据",
+ "diagnosticsClear": "清除",
+ "diagnosticsClearDescription": "这会从此设备中删除本地保存的诊断事件。",
+ "diagnosticsCleared": "诊断数据已清除。",
+ "diagnosticsCopied": "诊断数据已复制到剪贴板。",
+ "diagnosticsCopyFailed": "无法将诊断数据复制到剪贴板。"
}
diff --git a/packages/vue/src/i18n/messages/dialogs.ts b/packages/vue/src/i18n/messages/dialogs.ts
index d22214e19..8ce70e35e 100644
--- a/packages/vue/src/i18n/messages/dialogs.ts
+++ b/packages/vue/src/i18n/messages/dialogs.ts
@@ -190,6 +190,41 @@ export const dialogMessageDefaults = {
'Align vector points, moved layers, and resized edges to whole pixels.',
snapTemporaryDisableHint: 'Hold Control while dragging to temporarily disable snapping.',
settingsAIAndAgents: 'AI & agents',
+ settingsUsage: 'Usage',
+ usageDescription: 'Local usage summaries from recorded AI requests.',
+ usageRequests: 'Requests',
+ usageCompleted: 'Completed',
+ usageInputTokens: 'Input tokens',
+ usageOutputTokens: 'Output tokens',
+ usageByModel: 'By model',
+ usageNoData: 'No usage data recorded.',
+ usageNotReported: 'Not reported',
+ usageCacheNote: 'Cache values are shown only when the provider reports them.',
+ settingsDiagnostics: 'Diagnostics',
+ diagnosticsTitle: 'Diagnostics',
+ diagnosticsModelStepCompleted: 'AI model step completed',
+ diagnosticsChatCompleted: 'AI chat completed',
+ diagnosticsChatFailed: 'AI chat failed',
+ diagnosticsStorageFailed: 'Storage operation failed',
+ diagnosticsDocumentFailed: 'Document operation failed',
+ diagnosticsACPFailed: 'ACP transport failed',
+ diagnosticsMCPFailed: 'MCP connection failed',
+ diagnosticsTechnicalEvent: 'Technical event',
+ diagnosticsRetention: 'Diagnostics retention',
+ diagnosticsRetentionDescription: 'Keep up to this many recent events locally.',
+ diagnosticsDescription:
+ 'Store technical events locally to help troubleshoot OpenPencil. Prompts, design content, credentials, and API keys are excluded.',
+ localDiagnostics: 'Local diagnostics',
+ localDiagnosticsDescription: 'Keep recent technical events on this device.',
+ usageHistory: 'Usage history',
+ usageHistoryDescription: 'Keep local AI usage summaries.',
+ diagnosticsEventCount: params('{count} events · {size} KB'),
+ diagnosticsCopy: 'Copy diagnostics',
+ diagnosticsClear: 'Clear',
+ diagnosticsClearDescription: 'This removes locally stored diagnostic events from this device.',
+ diagnosticsCleared: 'Diagnostics cleared.',
+ diagnosticsCopied: 'Diagnostics copied to clipboard.',
+ diagnosticsCopyFailed: 'Could not copy diagnostics to the clipboard.',
models: 'Models',
modelsDescription: 'Configure reusable models and their provider connections.',
mcpConnections: 'MCP connections',
diff --git a/src/app/ai/acp/transport.ts b/src/app/ai/acp/transport.ts
index a907288da..96045e89e 100644
--- a/src/app/ai/acp/transport.ts
+++ b/src/app/ai/acp/transport.ts
@@ -11,6 +11,7 @@ import type { ChatTransport, UIMessage, UIMessageChunk } from 'ai'
import type { ACPAgentDef } from '@open-pencil/core/constants'
import SYSTEM_PROMPT from '@/app/ai/chat/system-prompt.md?raw'
+import { describeDiagnosticError, recordACPTransportFailure } from '@/app/diagnostics'
import { buildACPMCPServers } from '@/app/integrations/mcp'
import { mapUpdate } from './map-update'
@@ -91,6 +92,11 @@ export function formatConnectionError(e: unknown, agentDef?: ACPAgentDef): strin
return msg
}
+function startupError(error: unknown, agentDef: ACPAgentDef): Error {
+ recordACPTransportFailure({ operation: 'start', ...describeDiagnosticError(error) })
+ return new Error(formatConnectionError(error, agentDef))
+}
+
export function buildCrashChunks(
destroying: boolean,
textId: string,
@@ -190,11 +196,11 @@ export class ACPChatTransport implements ChatTransport<UIMessage> {
sessionId,
prompt: [{ type: 'text', text: promptText }]
})
- .then((result) => {
- finish(result.stopReason === 'end_turn' ? 'stop' : 'other')
- return undefined
- })
.catch((e) => {
+ recordACPTransportFailure({
+ operation: 'message',
+ ...describeDiagnosticError(e)
+ })
finish('error', formatConnectionError(e, this.agentDef))
})
}
@@ -228,9 +234,9 @@ export class ACPChatTransport implements ChatTransport<UIMessage> {
}
})
} catch (e) {
+ recordACPTransportFailure({ operation: 'start', ...describeDiagnosticError(e) })
throw new Error(formatConnectionError(e, this.agentDef))
}
-
const { child, input, output } = process
const stream = ndJsonStream(input, output)
let onUpdate: ACPSession['onUpdate'] = null
@@ -255,7 +261,7 @@ export class ACPChatTransport implements ChatTransport<UIMessage> {
automationAuthToken = await getAutomationAuthToken()
} catch (e) {
await child.kill().catch(() => undefined)
- throw new Error(formatConnectionError(e, this.agentDef))
+ throw startupError(e, this.agentDef)
}
try {
@@ -265,7 +271,7 @@ export class ACPChatTransport implements ChatTransport<UIMessage> {
})
} catch (e) {
await child.kill().catch(() => undefined)
- throw new Error(formatConnectionError(e, this.agentDef))
+ throw startupError(e, this.agentDef)
}
let sessionResult
@@ -276,7 +282,7 @@ export class ACPChatTransport implements ChatTransport<UIMessage> {
})
} catch (e) {
await child.kill().catch(() => undefined)
- throw new Error(formatConnectionError(e, this.agentDef))
+ throw startupError(e, this.agentDef)
}
const session: ACPSession = {
diff --git a/src/app/ai/chat/transports.ts b/src/app/ai/chat/transports.ts
index 8d9d2b792..fd9b01b4d 100644
--- a/src/app/ai/chat/transports.ts
+++ b/src/app/ai/chat/transports.ts
@@ -7,16 +7,17 @@ import { ref } from 'vue'
import { ACP_AGENTS } from '@open-pencil/core/constants'
import type { ACPAgentID, AIProviderID } from '@open-pencil/core/constants'
-import {
- classifyAIChatError,
- classifyAIChatFinish,
- type AIChatFailure
-} from '@/app/ai/chat/failure'
+import { classifyAIChatError, type AIChatFailure } from '@/app/ai/chat/failure'
import { resolveLanguageModelID } from '@/app/ai/chat/model'
import { buildReasoningProviderOptions, type AIProviderOptions } from '@/app/ai/chat/reasoning'
import SYSTEM_PROMPT from '@/app/ai/chat/system-prompt.md?raw'
import { createAIModelRuntime, resolveModelConnectionAPIKey } from '@/app/ai/models'
-import { MAX_AGENT_STEPS, createAITools, recordStepUsage, resetRunSteps } from '@/app/ai/tools'
+import { MAX_AGENT_STEPS, createAITools, recordStep, resetRunSteps } from '@/app/ai/tools'
+import {
+ recordChatCompleted,
+ recordChatFailed,
+ recordModelStepCompleted
+} from '@/app/diagnostics/events'
import type { getActiveEditorStore } from '@/app/editor/active-store'
type EditorStore = ReturnType<typeof getActiveEditorStore>
@@ -102,16 +103,15 @@ export function createToolLoopTransport({
}
},
onStepFinish: ({ usage }) => {
- recordStepUsage(
- {
- inputTokens: usage.inputTokens ?? 0,
- outputTokens: usage.outputTokens ?? 0,
- cacheReadTokens: usage.inputTokenDetails.cacheReadTokens ?? 0,
- cacheWriteTokens: usage.inputTokenDetails.cacheWriteTokens ?? 0,
- timestamp: Date.now()
- },
- store
- )
+ recordStep(store)
+ recordModelStepCompleted({
+ provider: providerID,
+ model: effectiveModelID,
+ inputTokens: usage.inputTokens ?? null,
+ outputTokens: usage.outputTokens ?? null,
+ cacheReadTokens: usage.inputTokenDetails.cacheReadTokens ?? null,
+ cacheWriteTokens: usage.inputTokenDetails.cacheWriteTokens ?? null
+ })
}
})
@@ -138,13 +138,17 @@ export function createChatSessionManager({
function handleChatFinish({
finishReason,
isAbort,
+ isDisconnect,
isError
}: {
finishReason?: FinishReason
isAbort: boolean
+ isDisconnect: boolean
isError: boolean
}): void {
- if (!isAbort && !isError) failure.value = classifyAIChatFinish(finishReason)
+ if (!isAbort && !isDisconnect && !isError) {
+ recordChatCompleted({ finishReason: finishReason ?? null })
+ }
}
function clearFailure(): void {
@@ -248,6 +252,7 @@ export function createChatSessionManager({
messages,
onError: (error) => {
failure.value = classifyAIChatError(error)
+ recordChatFailed({ errorName: error instanceof Error ? error.name : 'unknown' })
},
onFinish: handleChatFinish
})
diff --git a/src/app/ai/debug/index.ts b/src/app/ai/debug/index.ts
index 971a68775..87a038665 100644
--- a/src/app/ai/debug/index.ts
+++ b/src/app/ai/debug/index.ts
@@ -5,7 +5,8 @@ import type { ToolDebugLog, ToolLogEntry } from '@open-pencil/core/tools'
import type { JSONObject } from '@open-pencil/scene-graph/primitives'
import type { AIChatFailure } from '@/app/ai/chat/failure'
-import { getStepUsages, getToolLogEntries } from '@/app/ai/tools'
+import { getToolLogEntries } from '@/app/ai/tools'
+import { diagnostics } from '@/app/diagnostics'
const MAX_FAILURE_DETAIL_LENGTH = 240
const SENSITIVE_DETAIL_PATTERN =
@@ -19,44 +20,31 @@ export function safeFailureDetail(detail: string): string {
}
export function formatTokenUsage(): string {
- const steps = getStepUsages()
- if (steps.length === 0) return ' (no usage data — provider may not report it)'
+ const events = diagnostics.recent().filter((event) => event.name === 'model.step.completed')
+ if (events.length === 0) return ' (no usage data — provider may not report it)'
let totalInput = 0
let totalOutput = 0
let totalCacheRead = 0
let totalCacheWrite = 0
-
- const lines: string[] = []
- for (let i = 0; i < steps.length; i++) {
- const s = steps[i]
- totalInput += s.inputTokens
- totalOutput += s.outputTokens
- totalCacheRead += s.cacheReadTokens
- totalCacheWrite += s.cacheWriteTokens
-
- let cacheInfo = ' NO CACHE'
- if (s.cacheReadTokens > 0) {
- cacheInfo = ` cache_read=${s.cacheReadTokens}`
- } else if (s.cacheWriteTokens > 0) {
- cacheInfo = ` cache_write=${s.cacheWriteTokens}`
- }
- lines.push(` Step ${i + 1}: in=${s.inputTokens} out=${s.outputTokens}${cacheInfo}`)
- }
-
+ const lines = events.map((event, index) => {
+ const input = event.attributes.inputTokens
+ const output = event.attributes.outputTokens
+ const cacheRead = event.attributes.cacheReadTokens
+ const cacheWrite = event.attributes.cacheWriteTokens
+ if (typeof input === 'number') totalInput += input
+ if (typeof output === 'number') totalOutput += output
+ if (typeof cacheRead === 'number') totalCacheRead += cacheRead
+ if (typeof cacheWrite === 'number') totalCacheWrite += cacheWrite
+ return ` Step ${events.length - index}: in=${input ?? 'not reported'} out=${output ?? 'not reported'} cache_read=${cacheRead ?? 'not reported'} cache_write=${cacheWrite ?? 'not reported'}`
+ })
const cacheHitRate = totalInput > 0 ? ((totalCacheRead / totalInput) * 100).toFixed(1) : '0.0'
- const savedTokens = totalCacheRead > 0 ? totalCacheRead - Math.round(totalCacheRead * 0.1) : 0
-
lines.unshift(
`Total: in=${totalInput} out=${totalOutput} cache_read=${totalCacheRead} cache_write=${totalCacheWrite}`,
- `Cache hit rate: ${cacheHitRate}% (saved ~${savedTokens} uncached input tokens, 90% cost reduction on cached)`,
- `Steps: ${steps.length}`,
- totalCacheRead === 0 && totalCacheWrite === 0
- ? '⚠ NO CACHING DETECTED — system prompt + tools are re-processed every step'
- : ''
+ `Cache hit rate: ${cacheHitRate}%`,
+ `Steps: ${events.length}`
)
-
- return lines.filter(Boolean).join('\n')
+ return lines.join('\n')
}
export function formatLogEntry(entry: ToolLogEntry, index: number): string {
diff --git a/src/app/ai/tools/index.ts b/src/app/ai/tools/index.ts
index 3c13e81fd..c0ab27f0c 100644
--- a/src/app/ai/tools/index.ts
+++ b/src/app/ai/tools/index.ts
@@ -20,24 +20,10 @@ import { useLibraryService } from '@/app/libraries'
export const MAX_AGENT_STEPS = 50
-export interface StepUsage {
- inputTokens: number
- outputTokens: number
- cacheReadTokens: number
- cacheWriteTokens: number
- timestamp: number
-}
-
class RunState {
toolLog: ToolLogEntry[] = []
- stepUsages: StepUsage[] = []
currentSteps = 0
- recordStep(usage: StepUsage): void {
- this.stepUsages.push(usage)
- this.currentSteps++
- }
-
resetSteps(): void {
this.currentSteps = 0
}
@@ -48,7 +34,6 @@ class RunState {
clear(): void {
this.toolLog = []
- this.stepUsages = []
this.currentSteps = 0
}
}
@@ -68,12 +53,8 @@ export function getToolLogEntries(store?: EditorStore): ToolLogEntry[] {
return getRunState(store).toolLog
}
-export function getStepUsages(store?: EditorStore): StepUsage[] {
- return getRunState(store).stepUsages
-}
-
-export function recordStepUsage(usage: StepUsage, store?: EditorStore): void {
- getRunState(store).recordStep(usage)
+export function recordStep(store?: EditorStore): void {
+ getRunState(store).currentSteps++
}
export function resetRunSteps(store?: EditorStore): void {
diff --git a/src/app/diagnostics/error.ts b/src/app/diagnostics/error.ts
new file mode 100644
index 000000000..5dc57d2e5
--- /dev/null
+++ b/src/app/diagnostics/error.ts
@@ -0,0 +1,22 @@
+export type DiagnosticErrorInfo = {
+ errorName: string
+ errorCode: string | null
+ retryable: boolean | null
+}
+
+function isRetryableError(error: unknown): boolean | null {
+ if (!(error instanceof Error)) return null
+ if (error.name === 'AbortError') return false
+ if ('status' in error && typeof error.status === 'number') {
+ return error.status === 408 || error.status === 429 || error.status >= 500
+ }
+ return null
+}
+
+export function describeDiagnosticError(error: unknown): DiagnosticErrorInfo {
+ if (!(error instanceof Error)) {
+ return { errorName: 'UnknownError', errorCode: null, retryable: null }
+ }
+ const code = 'code' in error && typeof error.code === 'string' ? error.code : null
+ return { errorName: error.name || 'Error', errorCode: code, retryable: isRetryableError(error) }
+}
diff --git a/src/app/diagnostics/events/ai.ts b/src/app/diagnostics/events/ai.ts
new file mode 100644
index 000000000..7212f5c38
--- /dev/null
+++ b/src/app/diagnostics/events/ai.ts
@@ -0,0 +1,49 @@
+import * as v from 'valibot'
+
+import { recordDiagnostic } from '../recorder'
+import { isUsageEnabled } from '../settings'
+import type { DiagnosticEvent, DiagnosticValue } from '../types'
+
+const modelStepSchema = v.object({
+ provider: v.string(),
+ model: v.string(),
+ inputTokens: v.nullable(v.number()),
+ outputTokens: v.nullable(v.number()),
+ cacheReadTokens: v.nullable(v.number()),
+ cacheWriteTokens: v.nullable(v.number())
+})
+
+const chatCompletedSchema = v.object({ finishReason: v.nullable(v.string()) })
+const chatFailedSchema = v.object({ errorName: v.string() })
+
+function recordAIEvent(
+ name: 'model.step.completed' | 'chat.completed' | 'chat.failed',
+ attributes: Record<string, DiagnosticValue>,
+ schema: v.GenericSchema
+): void {
+ const parsed = v.safeParse(schema, attributes)
+ if (!parsed.success) {
+ console.warn(`[Diagnostics] Invalid AI event: ${name}`)
+ return
+ }
+ if (name === 'model.step.completed' && !isUsageEnabled()) return
+ const output = parsed.output as Record<string, DiagnosticValue>
+ recordDiagnostic({
+ category: 'ai',
+ level: name === 'chat.failed' ? 'error' : 'info',
+ name,
+ attributes: output
+ } satisfies Omit<DiagnosticEvent, 'id' | 'timestamp'>)
+}
+
+export function recordModelStepCompleted(input: v.InferOutput<typeof modelStepSchema>): void {
+ recordAIEvent('model.step.completed', input, modelStepSchema)
+}
+
+export function recordChatCompleted(input: v.InferOutput<typeof chatCompletedSchema>): void {
+ recordAIEvent('chat.completed', input, chatCompletedSchema)
+}
+
+export function recordChatFailed(input: v.InferOutput<typeof chatFailedSchema>): void {
+ recordAIEvent('chat.failed', input, chatFailedSchema)
+}
diff --git a/src/app/diagnostics/events/document.ts b/src/app/diagnostics/events/document.ts
new file mode 100644
index 000000000..9ab8ce2ab
--- /dev/null
+++ b/src/app/diagnostics/events/document.ts
@@ -0,0 +1,23 @@
+import * as v from 'valibot'
+
+import { recordDiagnostic } from '../recorder'
+import type { DiagnosticEvent } from '../types'
+
+const documentFailureSchema = v.object({
+ operation: v.picklist(['open', 'save', 'import', 'export']),
+ format: v.picklist(['fig', 'pen', 'svg', 'dom-css', 'unknown']),
+ errorName: v.string(),
+ errorCode: v.nullable(v.string()),
+ retryable: v.nullable(v.boolean())
+})
+
+export function recordDocumentFailure(input: v.InferOutput<typeof documentFailureSchema>): void {
+ const parsed = v.safeParse(documentFailureSchema, input)
+ if (!parsed.success) return
+ recordDiagnostic({
+ category: 'document',
+ level: 'error',
+ name: 'document.operation.failed',
+ attributes: parsed.output
+ } satisfies Omit<DiagnosticEvent, 'id' | 'timestamp'>)
+}
diff --git a/src/app/diagnostics/events/index.ts b/src/app/diagnostics/events/index.ts
new file mode 100644
index 000000000..a071987f6
--- /dev/null
+++ b/src/app/diagnostics/events/index.ts
@@ -0,0 +1,5 @@
+export { recordChatCompleted, recordChatFailed, recordModelStepCompleted } from './ai'
+export { recordDocumentFailure } from './document'
+export { recordStorageFailure } from './storage'
+export { recordACPTransportFailure, recordMCPConnectionFailure } from './transport'
+export { storageOperationForJob } from './storage-operation'
diff --git a/src/app/diagnostics/events/storage-operation.ts b/src/app/diagnostics/events/storage-operation.ts
new file mode 100644
index 000000000..8cc3dc7be
--- /dev/null
+++ b/src/app/diagnostics/events/storage-operation.ts
@@ -0,0 +1,15 @@
+import type { OutboxJobType } from '@/app/storage/sync/types'
+
+export type StorageDiagnosticOperation = 'upload' | 'download' | 'delete' | 'list'
+
+export function storageOperationForJob(type: OutboxJobType): StorageDiagnosticOperation {
+ switch (type) {
+ case 'putCanvas':
+ case 'putThumb':
+ return 'upload'
+ case 'deleteCanvas':
+ return 'delete'
+ default:
+ throw new Error('Unsupported outbox job type')
+ }
+}
diff --git a/src/app/diagnostics/events/storage.ts b/src/app/diagnostics/events/storage.ts
new file mode 100644
index 000000000..179cbb394
--- /dev/null
+++ b/src/app/diagnostics/events/storage.ts
@@ -0,0 +1,22 @@
+import * as v from 'valibot'
+
+import { recordDiagnostic } from '../recorder'
+import type { DiagnosticEvent } from '../types'
+
+const storageFailureSchema = v.object({
+ operation: v.picklist(['upload', 'download', 'delete', 'list']),
+ errorName: v.string(),
+ errorCode: v.nullable(v.string()),
+ retryable: v.nullable(v.boolean())
+})
+
+export function recordStorageFailure(input: v.InferOutput<typeof storageFailureSchema>): void {
+ const parsed = v.safeParse(storageFailureSchema, input)
+ if (!parsed.success) return
+ recordDiagnostic({
+ category: 'storage',
+ level: 'error',
+ name: 'storage.operation.failed',
+ attributes: parsed.output
+ } satisfies Omit<DiagnosticEvent, 'id' | 'timestamp'>)
+}
diff --git a/src/app/diagnostics/events/transport-index.ts b/src/app/diagnostics/events/transport-index.ts
new file mode 100644
index 000000000..f397d1f4b
--- /dev/null
+++ b/src/app/diagnostics/events/transport-index.ts
@@ -0,0 +1 @@
+export { recordACPTransportFailure, recordMCPConnectionFailure } from './transport'
diff --git a/src/app/diagnostics/events/transport.ts b/src/app/diagnostics/events/transport.ts
new file mode 100644
index 000000000..d56507ea3
--- /dev/null
+++ b/src/app/diagnostics/events/transport.ts
@@ -0,0 +1,40 @@
+import * as v from 'valibot'
+
+import { recordDiagnostic } from '../recorder'
+import type { DiagnosticEvent } from '../types'
+
+const mcpFailureSchema = v.object({
+ operation: v.picklist(['connect', 'request', 'disconnect']),
+ errorName: v.string(),
+ errorCode: v.nullable(v.string()),
+ retryable: v.nullable(v.boolean())
+})
+
+const acpFailureSchema = v.object({
+ operation: v.picklist(['start', 'message', 'stop']),
+ errorName: v.string(),
+ errorCode: v.nullable(v.string()),
+ retryable: v.nullable(v.boolean())
+})
+
+export function recordMCPConnectionFailure(input: v.InferOutput<typeof mcpFailureSchema>): void {
+ const parsed = v.safeParse(mcpFailureSchema, input)
+ if (!parsed.success) return
+ recordDiagnostic({
+ category: 'mcp',
+ level: 'error',
+ name: 'mcp.connection.failed',
+ attributes: parsed.output
+ } satisfies Omit<DiagnosticEvent, 'id' | 'timestamp'>)
+}
+
+export function recordACPTransportFailure(input: v.InferOutput<typeof acpFailureSchema>): void {
+ const parsed = v.safeParse(acpFailureSchema, input)
+ if (!parsed.success) return
+ recordDiagnostic({
+ category: 'mcp',
+ level: 'error',
+ name: 'acp.transport.failed',
+ attributes: parsed.output
+ } satisfies Omit<DiagnosticEvent, 'id' | 'timestamp'>)
+}
diff --git a/src/app/diagnostics/idb.ts b/src/app/diagnostics/idb.ts
new file mode 100644
index 000000000..5019d16cb
--- /dev/null
+++ b/src/app/diagnostics/idb.ts
@@ -0,0 +1,68 @@
+import type { DBSchema } from 'idb'
+
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
+
+import { getDiagnosticsRetention, type DiagnosticsRetention } from './settings'
+import type { DiagnosticCategory, DiagnosticEvent } from './types'
+
+interface DiagnosticsDatabase extends DBSchema {
+ events: {
+ key: string
+ value: DiagnosticEvent
+ indexes: {
+ 'by-timestamp': number
+ 'by-category': DiagnosticCategory
+ }
+ }
+}
+
+const diagnosticsDatabase = defineAppDatabase<DiagnosticsDatabase>({
+ name: APP_DATABASE_NAMES.diagnostics,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (database.objectStoreNames.contains('events')) return
+ const events = database.createObjectStore('events', { keyPath: 'id' })
+ events.createIndex('by-timestamp', 'timestamp')
+ events.createIndex('by-category', 'category')
+ }
+ }
+})
+
+export type DiagnosticsStore = {
+ record(event: DiagnosticEvent): Promise<void>
+ list(): Promise<DiagnosticEvent[]>
+ prune(retention: DiagnosticsRetention): Promise<void>
+ clear(): Promise<void>
+}
+
+export function createIDBDiagnosticsStore(): DiagnosticsStore {
+ const database = openAppDatabase(diagnosticsDatabase)
+
+ async function prune(retention: DiagnosticsRetention): Promise<void> {
+ const db = await database
+ const transaction = db.transaction('events', 'readwrite')
+ const keys = await transaction.store.index('by-timestamp').getAllKeys()
+ for (const key of keys.slice(0, Math.max(0, keys.length - retention))) {
+ await transaction.store.delete(key)
+ }
+ await transaction.done
+ }
+
+ return {
+ async record(event) {
+ const db = await database
+ const transaction = db.transaction('events', 'readwrite')
+ await transaction.store.put(event)
+ await transaction.done
+ await prune(getDiagnosticsRetention())
+ },
+ async list() {
+ return (await (await database).getAllFromIndex('events', 'by-timestamp')).reverse()
+ },
+ prune,
+ async clear() {
+ await (await database).clear('events')
+ }
+ }
+}
diff --git a/src/app/diagnostics/index.ts b/src/app/diagnostics/index.ts
new file mode 100644
index 000000000..cda666825
--- /dev/null
+++ b/src/app/diagnostics/index.ts
@@ -0,0 +1,23 @@
+export {
+ recordACPTransportFailure,
+ recordChatCompleted,
+ recordChatFailed,
+ recordDocumentFailure,
+ recordMCPConnectionFailure,
+ recordModelStepCompleted,
+ recordStorageFailure,
+ storageOperationForJob
+} from './events'
+export { describeDiagnosticError } from './error'
+export { summarizeDiagnosticEvent } from './summary'
+export type { DiagnosticEventSummary } from './summary'
+export { diagnostics } from './recorder'
+export { useDiagnosticsSettings } from './settings'
+export type {
+ AIDiagnosticUsage,
+ DiagnosticCategory,
+ DiagnosticEvent,
+ DiagnosticEventInput,
+ DiagnosticLevel,
+ DiagnosticValue
+} from './types'
diff --git a/src/app/diagnostics/recorder.ts b/src/app/diagnostics/recorder.ts
new file mode 100644
index 000000000..5bc0a3675
--- /dev/null
+++ b/src/app/diagnostics/recorder.ts
@@ -0,0 +1,92 @@
+import { createIDBDiagnosticsStore, type DiagnosticsStore } from './idb'
+import {
+ getDiagnosticsRetention,
+ isDiagnosticsEnabled,
+ type DiagnosticsRetention
+} from './settings'
+import type { DiagnosticEvent, DiagnosticEventInput } from './types'
+
+const MAX_MEMORY_EVENTS = 1000
+let store: DiagnosticsStore | null = null
+let memoryEvents: DiagnosticEvent[] = []
+let pendingWrites = Promise.resolve()
+const subscribers = new Set<() => void>()
+
+const memoryStore: DiagnosticsStore = {
+ async record(_event) {
+ memoryEvents = memoryEvents.slice(-getDiagnosticsRetention())
+ },
+ async list() {
+ return [...memoryEvents].reverse()
+ },
+ async prune(retention) {
+ memoryEvents = memoryEvents.slice(-retention)
+ },
+ async clear() {
+ memoryEvents = []
+ }
+}
+
+function getStore(): DiagnosticsStore {
+ if (store) return store
+ if (typeof indexedDB === 'undefined') return (store = memoryStore)
+ try {
+ return (store = createIDBDiagnosticsStore())
+ } catch {
+ return (store = memoryStore)
+ }
+}
+
+function notify(): void {
+ for (const subscriber of subscribers) subscriber()
+}
+
+function makeEvent(input: DiagnosticEventInput): DiagnosticEvent {
+ return { ...input, id: crypto.randomUUID(), timestamp: input.timestamp ?? Date.now() }
+}
+
+function enqueue(operation: () => Promise<void>): void {
+ pendingWrites = pendingWrites.then(operation).catch((error: unknown) => {
+ console.warn('[Diagnostics] Failed to persist event; using memory fallback:', error)
+ store = memoryStore
+ })
+}
+
+export function recordDiagnostic(input: DiagnosticEventInput): void {
+ if (!isDiagnosticsEnabled()) return
+ const event = makeEvent(input)
+ memoryEvents = [...memoryEvents, event].slice(
+ -Math.min(getDiagnosticsRetention(), MAX_MEMORY_EVENTS)
+ )
+ enqueue(() => getStore().record(event))
+ notify()
+}
+
+export const diagnostics = {
+ recent(): DiagnosticEvent[] {
+ return [...memoryEvents].reverse()
+ },
+ subscribe(listener: () => void): () => void {
+ subscribers.add(listener)
+ return () => subscribers.delete(listener)
+ },
+ async list(): Promise<DiagnosticEvent[]> {
+ await pendingWrites
+ return store === memoryStore ? memoryStore.list() : getStore().list()
+ },
+ async export(): Promise<string> {
+ return JSON.stringify(await this.list(), null, 2)
+ },
+ async prune(retention: DiagnosticsRetention): Promise<void> {
+ memoryEvents = memoryEvents.slice(-retention)
+ enqueue(() => getStore().prune(retention))
+ await pendingWrites
+ notify()
+ },
+ async clear(): Promise<void> {
+ memoryEvents = []
+ enqueue(() => getStore().clear())
+ await pendingWrites
+ notify()
+ }
+}
diff --git a/src/app/diagnostics/settings.ts b/src/app/diagnostics/settings.ts
new file mode 100644
index 000000000..74f5b5fe7
--- /dev/null
+++ b/src/app/diagnostics/settings.ts
@@ -0,0 +1,54 @@
+import { useLocalStorage } from '@vueuse/core'
+import { computed, ref } from 'vue'
+
+export type DiagnosticsRetention = 100 | 500 | 1000
+
+const diagnosticsEnabled = useLocalStorage('open-pencil:diagnostics-enabled', true)
+const usageEnabled = useLocalStorage('open-pencil:usage-enabled', true)
+const diagnosticsRetention = useLocalStorage<DiagnosticsRetention>(
+ 'open-pencil:diagnostics-retention',
+ 500,
+ { serializer: { read: (value) => normalizeRetention(value), write: String } }
+)
+const diagnosticsCount = ref(0)
+const diagnosticsSize = ref(0)
+
+function normalizeRetention(value: string): DiagnosticsRetention {
+ const parsed = Number(value)
+ return parsed === 100 || parsed === 1000 ? parsed : 500
+}
+
+export function useDiagnosticsSettings() {
+ return {
+ diagnosticsEnabled,
+ usageEnabled,
+ diagnosticsRetention,
+ diagnosticsCount: computed(() => diagnosticsCount.value),
+ diagnosticsSize: computed(() => diagnosticsSize.value),
+ refreshDiagnosticsStats: async () => {
+ const { diagnostics } = await import('./recorder')
+ const events = await diagnostics.list()
+ diagnosticsCount.value = events.length
+ diagnosticsSize.value = JSON.stringify(events).length
+ }
+ }
+}
+
+export function isDiagnosticsEnabled(): boolean {
+ return diagnosticsEnabled.value
+}
+
+export function isUsageEnabled(): boolean {
+ return usageEnabled.value
+}
+
+export function getDiagnosticsRetention(): DiagnosticsRetention {
+ return diagnosticsRetention.value
+}
+
+export async function pruneDiagnostics(retention: DiagnosticsRetention): Promise<void> {
+ const { diagnostics } = await import('./recorder')
+ await diagnostics.prune(retention)
+}
+
+export const diagnosticsRetentionOptions = computed(() => [100, 500, 1000] as const)
diff --git a/src/app/diagnostics/summary.ts b/src/app/diagnostics/summary.ts
new file mode 100644
index 000000000..48c8d9e01
--- /dev/null
+++ b/src/app/diagnostics/summary.ts
@@ -0,0 +1,31 @@
+import type { DiagnosticEvent } from './types'
+
+export type DiagnosticEventSummary = {
+ category: string
+ label: string
+ level: DiagnosticEvent['level']
+ timestamp: number
+}
+
+const labelKeys: Record<string, string> = {
+ 'model.step.completed': 'diagnosticsModelStepCompleted',
+ 'chat.completed': 'diagnosticsChatCompleted',
+ 'chat.failed': 'diagnosticsChatFailed',
+ 'storage.operation.failed': 'diagnosticsStorageFailed',
+ 'document.operation.failed': 'diagnosticsDocumentFailed',
+ 'acp.transport.failed': 'diagnosticsACPFailed',
+ 'mcp.connection.failed': 'diagnosticsMCPFailed'
+}
+
+export function summarizeDiagnosticEvent(
+ event: DiagnosticEvent,
+ labels: Partial<Record<string, unknown>>
+): DiagnosticEventSummary {
+ const labelKey = labelKeys[event.name]
+ const localizedLabel = labelKey ? labels[labelKey] : undefined
+ const fallback = labels.diagnosticsTechnicalEvent
+ let label = 'Technical event'
+ if (typeof fallback === 'string') label = fallback
+ if (typeof localizedLabel === 'string') label = localizedLabel
+ return { category: event.category, label, level: event.level, timestamp: event.timestamp }
+}
diff --git a/src/app/diagnostics/types.ts b/src/app/diagnostics/types.ts
new file mode 100644
index 000000000..54ca02af7
--- /dev/null
+++ b/src/app/diagnostics/types.ts
@@ -0,0 +1,42 @@
+import type { AIProviderID } from '@open-pencil/core/constants'
+
+export type DiagnosticCategory =
+ | 'ai'
+ | 'document'
+ | 'renderer'
+ | 'storage'
+ | 'sync'
+ | 'mcp'
+ | 'recovery'
+ | 'performance'
+ | 'runtime'
+
+export type DiagnosticLevel = 'debug' | 'info' | 'warning' | 'error'
+export type DiagnosticValue = string | number | boolean | null
+export type DiagnosticAttributes = Readonly<Record<string, DiagnosticValue>>
+
+export type DiagnosticEvent = {
+ id: string
+ timestamp: number
+ category: DiagnosticCategory
+ level: DiagnosticLevel
+ name: string
+ sessionId?: string
+ runId?: string
+ durationMs?: number
+ attributes: DiagnosticAttributes
+}
+
+export type DiagnosticEventInput = Omit<DiagnosticEvent, 'id' | 'timestamp'> & {
+ timestamp?: number
+}
+
+export type AIDiagnosticUsage = {
+ providerID: AIProviderID
+ modelID: string
+ inputTokens?: number
+ outputTokens?: number
+ cacheReadTokens?: number
+ cacheWriteTokens?: number
+ finishReason?: string
+}
diff --git a/src/app/document/io/dom.ts b/src/app/document/io/dom.ts
index 73d0b8a56..9786c5342 100644
--- a/src/app/document/io/dom.ts
+++ b/src/app/document/io/dom.ts
@@ -1,6 +1,7 @@
import type { Editor, EditorState } from '@open-pencil/core/editor'
import { browserHTMLToSceneGraph } from '@open-pencil/dom-css/browser'
+import { describeDiagnosticError, recordDocumentFailure } from '@/app/diagnostics'
import { yieldToUI } from '@/app/document/io/browser'
import { applyImportedDocument } from '@/app/document/io/imported-document'
import { notificationMessages } from '@/app/i18n/notifications'
@@ -67,7 +68,12 @@ export function createDOMOpenActions({
setDocumentSource(`${pageName}.html`, 'html')
toast.info(notificationMessages.get().importedDOMCSS)
} catch (e) {
- console.error('Failed to import DOM/CSS:', e)
+ recordDocumentFailure({
+ operation: 'import',
+ format: 'dom-css',
+ ...describeDiagnosticError(e),
+ retryable: describeDiagnosticError(e).retryable
+ })
toast.error(notificationMessages.get().importDOMCSSFailed({ error: errorDetail(e) }))
throw e
} finally {
@@ -85,7 +91,12 @@ export function createDOMOpenActions({
})
setDocumentSource(file.name, 'html', options.handle, options.path)
} catch (e) {
- console.error('Failed to open DOM/CSS file:', e)
+ recordDocumentFailure({
+ operation: 'open',
+ format: 'dom-css',
+ ...describeDiagnosticError(e),
+ retryable: describeDiagnosticError(e).retryable
+ })
toast.error(notificationMessages.get().openDOMCSSFailed({ error: errorDetail(e) }))
} finally {
state.loading = false
diff --git a/src/app/document/io/read.ts b/src/app/document/io/read.ts
index 530a90d94..87e7bb5ad 100644
--- a/src/app/document/io/read.ts
+++ b/src/app/document/io/read.ts
@@ -1,6 +1,7 @@
import type { Editor, EditorState } from '@open-pencil/core/editor'
import { computeAllLayouts } from '@open-pencil/core/layout'
+import { describeDiagnosticError, recordDocumentFailure } from '@/app/diagnostics'
import { yieldToUI } from '@/app/document/io/browser'
import { readFigDocument } from '@/app/document/io/fig'
import { applyImportedDocument } from '@/app/document/io/imported-document'
@@ -54,7 +55,12 @@ export function createOpenActions({
await fitCurrentPageToViewport()
editor.requestRender()
} catch (e) {
- console.error('Failed to open .fig file:', e)
+ recordDocumentFailure({
+ operation: 'open',
+ format: 'fig',
+ ...describeDiagnosticError(e),
+ retryable: describeDiagnosticError(e).retryable
+ })
toast.error(
notificationMessages.get().openFileFailed({
name: file.name,
diff --git a/src/app/document/io/write.ts b/src/app/document/io/write.ts
index e80ad15cb..e1c4708f7 100644
--- a/src/app/document/io/write.ts
+++ b/src/app/document/io/write.ts
@@ -1,5 +1,6 @@
import type { EditorState } from '@open-pencil/core/editor'
+import { describeDiagnosticError, recordDocumentFailure } from '@/app/diagnostics'
import type { StorageDocumentBinding } from '@/app/integrations/storage/types'
import { persistStorageCanvasLocally } from '@/app/storage/sync/persist'
import { isTauri } from '@/app/tauri/env'
@@ -40,30 +41,40 @@ export function createDocumentWriter({
version = state.sceneVersion
): Promise<boolean> {
setLastWriteTime(Date.now())
- const storage = getStorageBinding()
- if (storage) {
- await persistStorageCanvasLocally({
- providerId: storage.providerId,
- canvasId: storage.documentId,
- name: state.documentName || 'Untitled',
- figBytes: data
- })
- return finishWrite(version)
- }
+ try {
+ const storage = getStorageBinding()
+ if (storage) {
+ await persistStorageCanvasLocally({
+ providerId: storage.providerId,
+ canvasId: storage.documentId,
+ name: state.documentName || 'Untitled',
+ figBytes: data
+ })
+ return await finishWrite(version)
+ }
- const filePath = getFilePath()
- const fileHandle = getFileHandle()
- if (filePath && isTauri()) {
- const { writeFile: tauriWrite } = await import('@tauri-apps/plugin-fs')
- await tauriWrite(filePath, data)
- return finishWrite(version)
- }
- if (fileHandle) {
- const writable = await fileHandle.createWritable()
- await writable.write(new Uint8Array(data))
- await writable.close()
- return finishWrite(version)
+ const filePath = getFilePath()
+ const fileHandle = getFileHandle()
+ if (filePath && isTauri()) {
+ const { writeFile: tauriWrite } = await import('@tauri-apps/plugin-fs')
+ await tauriWrite(filePath, data)
+ return await finishWrite(version)
+ }
+ if (fileHandle) {
+ const writable = await fileHandle.createWritable()
+ await writable.write(new Uint8Array(data))
+ await writable.close()
+ return await finishWrite(version)
+ }
+ return false
+ } catch (error) {
+ recordDocumentFailure({
+ operation: 'save',
+ format: 'fig',
+ ...describeDiagnosticError(error),
+ retryable: describeDiagnosticError(error).retryable
+ })
+ throw error
}
- return false
}
}
diff --git a/src/app/document/recovery/idb.ts b/src/app/document/recovery/idb.ts
index 831c2ab7d..cc5c27203 100644
--- a/src/app/document/recovery/idb.ts
+++ b/src/app/document/recovery/idb.ts
@@ -1,4 +1,4 @@
-import { openDB, type DBSchema } from 'idb'
+import type { DBSchema } from 'idb'
import type {
RecoverySnapshot,
@@ -6,9 +6,19 @@ import type {
RecoverySnapshotMeta,
RecoveryStore
} from '@/app/document/recovery/types'
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
-const DB_NAME = 'open-pencil-recovery'
-const DB_VERSION = 1
+const recoveryDatabase = defineAppDatabase<RecoveryDatabase>({
+ name: APP_DATABASE_NAMES.recovery,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (!database.objectStoreNames.contains('meta'))
+ database.createObjectStore('meta', { keyPath: 'id' })
+ if (!database.objectStoreNames.contains('fig')) database.createObjectStore('fig')
+ }
+ }
+})
interface RecoveryDatabase extends DBSchema {
meta: {
@@ -22,12 +32,7 @@ interface RecoveryDatabase extends DBSchema {
}
export function createIdbRecoveryStore(): RecoveryStore {
- const database = openDB<RecoveryDatabase>(DB_NAME, DB_VERSION, {
- upgrade(db) {
- if (!db.objectStoreNames.contains('meta')) db.createObjectStore('meta', { keyPath: 'id' })
- if (!db.objectStoreNames.contains('fig')) db.createObjectStore('fig')
- }
- })
+ const database = openAppDatabase(recoveryDatabase)
return {
async list() {
diff --git a/src/app/integrations/mcp/pi.ts b/src/app/integrations/mcp/pi.ts
index e2c6eb9e6..cffbaa21b 100644
--- a/src/app/integrations/mcp/pi.ts
+++ b/src/app/integrations/mcp/pi.ts
@@ -1,11 +1,11 @@
import { AUTOMATION_HTTP_PORT } from '@open-pencil/core/constants'
import { getAutomationAuthToken } from '@/app/automation/mcp/spawn'
+import { describeDiagnosticError, recordMCPConnectionFailure } from '@/app/diagnostics'
import { appCredentialServices } from '@/app/settings/credentials/app'
import { enabledMCPConnections } from './store'
import type { MCPConnection } from './types'
-
export type PiMCPServer = {
url: string
headers?: Record<string, string>
@@ -15,11 +15,16 @@ export type PiMCPServer = {
async function externalPiMCPServer(connection: MCPConnection): Promise<PiMCPServer> {
const headers: Record<string, string> = {}
if (connection.authentication.type === 'bearer') {
- const token = await appCredentialServices.resolver.resolve(
- connection.authentication.credentialRef
- )
- if (!token) throw new Error(`MCP connection "${connection.name}" needs a bearer token`)
- headers.Authorization = `Bearer ${token}`
+ try {
+ const token = await appCredentialServices.resolver.resolve(
+ connection.authentication.credentialRef
+ )
+ if (!token) throw new Error('MCP connection needs a bearer token')
+ headers.Authorization = `Bearer ${token}`
+ } catch (error) {
+ recordMCPConnectionFailure({ operation: 'connect', ...describeDiagnosticError(error) })
+ throw error
+ }
}
return {
url: connection.transport.url,
diff --git a/src/app/integrations/mcp/runtime.ts b/src/app/integrations/mcp/runtime.ts
index 5c75b6d1c..d2b9de96d 100644
--- a/src/app/integrations/mcp/runtime.ts
+++ b/src/app/integrations/mcp/runtime.ts
@@ -2,11 +2,11 @@ import type { McpServer } from '@agentclientprotocol/sdk'
import { AUTOMATION_HTTP_PORT } from '@open-pencil/core/constants'
+import { describeDiagnosticError, recordMCPConnectionFailure } from '@/app/diagnostics'
import { appCredentialServices } from '@/app/settings/credentials/app'
import { enabledMCPConnections } from './store'
import type { MCPConnection } from './types'
-
export type BuiltInMCPServerOptions = {
authorizationToken: string | null
}
@@ -25,11 +25,16 @@ export function builtInMCPServer(options: BuiltInMCPServerOptions): McpServer {
async function externalMCPServer(connection: MCPConnection): Promise<McpServer> {
const headers = []
if (connection.authentication.type === 'bearer') {
- const token = await appCredentialServices.resolver.resolve(
- connection.authentication.credentialRef
- )
- if (!token) throw new Error(`MCP connection "${connection.name}" needs a bearer token`)
- headers.push({ name: 'Authorization', value: `Bearer ${token}` })
+ try {
+ const token = await appCredentialServices.resolver.resolve(
+ connection.authentication.credentialRef
+ )
+ if (!token) throw new Error('MCP connection needs a bearer token')
+ headers.push({ name: 'Authorization', value: `Bearer ${token}` })
+ } catch (error) {
+ recordMCPConnectionFailure({ operation: 'connect', ...describeDiagnosticError(error) })
+ throw error
+ }
}
return {
type: 'http',
diff --git a/src/app/libraries/catalog/local.ts b/src/app/libraries/catalog/local.ts
index 31abcf914..76e78b642 100644
--- a/src/app/libraries/catalog/local.ts
+++ b/src/app/libraries/catalog/local.ts
@@ -1,4 +1,4 @@
-import { openDB, type DBSchema, type IDBPDatabase } from 'idb'
+import type { DBSchema, IDBPDatabase } from 'idb'
import type {
ComponentLibraryRevision,
@@ -13,8 +13,27 @@ import {
serializeLibraryRevision
} from '@open-pencil/core/library'
-const DATABASE_NAME = 'open-pencil-libraries'
-const DATABASE_VERSION = 1
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
+
+const DATABASE_NAME = APP_DATABASE_NAMES.libraries
+
+const libraryDatabase = defineAppDatabase<LocalLibraryDatabase>({
+ name: APP_DATABASE_NAMES.libraries,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (!database.objectStoreNames.contains('revisions')) {
+ const revisions = database.createObjectStore('revisions', {
+ keyPath: ['libraryId', 'revisionId']
+ })
+ revisions.createIndex('by-library', 'libraryId')
+ }
+ if (!database.objectStoreNames.contains('latest')) {
+ database.createObjectStore('latest')
+ }
+ }
+ }
+})
interface StoredLibraryRevision {
libraryId: string
@@ -38,19 +57,7 @@ export class LocalLibraryCatalog implements LibraryCatalog {
readonly #database: Promise<IDBPDatabase<LocalLibraryDatabase>>
constructor(databaseName = DATABASE_NAME) {
- this.#database = openDB<LocalLibraryDatabase>(databaseName, DATABASE_VERSION, {
- upgrade(database) {
- if (!database.objectStoreNames.contains('revisions')) {
- const revisions = database.createObjectStore('revisions', {
- keyPath: ['libraryId', 'revisionId']
- })
- revisions.createIndex('by-library', 'libraryId')
- }
- if (!database.objectStoreNames.contains('latest')) {
- database.createObjectStore('latest')
- }
- }
- })
+ this.#database = openAppDatabase({ ...libraryDatabase, name: databaseName })
}
async listLibraries(): Promise<LibrarySummary[]> {
diff --git a/src/app/settings/credentials/browser.ts b/src/app/settings/credentials/browser.ts
index c6ccd3968..bfc45f086 100644
--- a/src/app/settings/credentials/browser.ts
+++ b/src/app/settings/credentials/browser.ts
@@ -1,4 +1,4 @@
-import { openDB, type DBSchema, type IDBPDatabase } from 'idb'
+import type { DBSchema, IDBPDatabase } from 'idb'
import { credentialKey, validateCredentialValue } from '@/app/settings/credentials/reference'
import type {
@@ -8,9 +8,23 @@ import type {
CredentialStoreAvailability
} from '@/app/settings/credentials/types'
import { CredentialStoreError } from '@/app/settings/credentials/types'
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
+
+const credentialDatabase = defineAppDatabase<CredentialDatabase>({
+ name: APP_DATABASE_NAMES.credentials,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (!database.objectStoreNames.contains('credentials')) {
+ database.createObjectStore('credentials')
+ }
+ if (!database.objectStoreNames.contains('metadata')) {
+ database.createObjectStore('metadata')
+ }
+ }
+ }
+})
-const DATABASE_NAME = 'open-pencil-credentials'
-const DATABASE_VERSION = 1
const MASTER_KEY_ID = 'master-key'
const IV_LENGTH = 12
@@ -42,16 +56,7 @@ export class BrowserCredentialStore implements CredentialStore {
#masterKeyPromise?: Promise<CryptoKey>
constructor() {
- this.#database = openDB<CredentialDatabase>(DATABASE_NAME, DATABASE_VERSION, {
- upgrade(database) {
- if (!database.objectStoreNames.contains('credentials')) {
- database.createObjectStore('credentials')
- }
- if (!database.objectStoreNames.contains('metadata')) {
- database.createObjectStore('metadata')
- }
- }
- })
+ this.#database = openAppDatabase(credentialDatabase)
}
async availability(): Promise<CredentialStoreAvailability> {
diff --git a/src/app/settings/dialog.ts b/src/app/settings/dialog.ts
index 0d81677af..fff511b18 100644
--- a/src/app/settings/dialog.ts
+++ b/src/app/settings/dialog.ts
@@ -1,6 +1,13 @@
import { ref } from 'vue'
-export type SettingsSection = 'general' | 'ai' | 'mcp' | 'media' | 'storage'
+export type SettingsSection =
+ | 'general'
+ | 'ai'
+ | 'usage'
+ | 'diagnostics'
+ | 'mcp'
+ | 'media'
+ | 'storage'
export const settingsDialogOpen = ref(false)
export const settingsDialogSection = ref<SettingsSection>('general')
diff --git a/src/app/storage/idb/client.ts b/src/app/storage/idb/client.ts
new file mode 100644
index 000000000..d4a754aa6
--- /dev/null
+++ b/src/app/storage/idb/client.ts
@@ -0,0 +1,21 @@
+import { openDB, type DBSchema, type IDBPDatabase, type OpenDBCallbacks } from 'idb'
+
+export type AppDatabaseDefinition<Database extends DBSchema> = {
+ name: string
+ version: number
+ callbacks: OpenDBCallbacks<Database>
+}
+
+/** Keep database definitions explicit and colocated with their feature schema. */
+export function defineAppDatabase<Database extends DBSchema>(
+ definition: AppDatabaseDefinition<Database>
+): AppDatabaseDefinition<Database> {
+ return definition
+}
+
+/** Open a typed app database through the shared IndexedDB boundary. */
+export function openAppDatabase<Database extends DBSchema>(
+ definition: AppDatabaseDefinition<Database>
+): Promise<IDBPDatabase<Database>> {
+ return openDB(definition.name, definition.version, definition.callbacks)
+}
diff --git a/src/app/storage/idb/database-names.ts b/src/app/storage/idb/database-names.ts
new file mode 100644
index 000000000..72ed77280
--- /dev/null
+++ b/src/app/storage/idb/database-names.ts
@@ -0,0 +1,9 @@
+/** Stable names for the app's independent IndexedDB databases. */
+export const APP_DATABASE_NAMES = {
+ credentials: 'open-pencil-credentials',
+ libraries: 'open-pencil-libraries',
+ localCanvas: 'open-pencil-cloud-local',
+ outbox: 'open-pencil-cloud-outbox',
+ recovery: 'open-pencil-recovery',
+ diagnostics: 'open-pencil-diagnostics'
+} as const
diff --git a/src/app/storage/idb/index.ts b/src/app/storage/idb/index.ts
new file mode 100644
index 000000000..58e93ed53
--- /dev/null
+++ b/src/app/storage/idb/index.ts
@@ -0,0 +1,3 @@
+export { APP_DATABASE_NAMES } from './database-names'
+export { defineAppDatabase, openAppDatabase } from './client'
+export type { AppDatabaseDefinition } from './client'
diff --git a/src/app/storage/local-store/idb.ts b/src/app/storage/local-store/idb.ts
index 91e416d01..5e04e8b69 100644
--- a/src/app/storage/local-store/idb.ts
+++ b/src/app/storage/local-store/idb.ts
@@ -1,11 +1,23 @@
-import { openDB, type DBSchema, type IDBPDatabase } from 'idb'
+import type { DBSchema, IDBPDatabase } from 'idb'
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
import { buildIndexMeta, buildWriteMeta, sortAndFilterMetas } from '@/app/storage/local-store/meta'
import type { LocalCanvasStore } from '@/app/storage/local-store/store'
import type { LocalCanvasMeta, LocalCanvasWriteInput } from '@/app/storage/local-store/types'
-const DB_NAME = 'open-pencil-cloud-local'
-const DB_VERSION = 1
+const localCanvasDatabase = defineAppDatabase<LocalCanvasDatabase>({
+ name: APP_DATABASE_NAMES.localCanvas,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (!database.objectStoreNames.contains('meta')) {
+ database.createObjectStore('meta', { keyPath: 'id' })
+ }
+ if (!database.objectStoreNames.contains('fig')) database.createObjectStore('fig')
+ if (!database.objectStoreNames.contains('thumb')) database.createObjectStore('thumb')
+ }
+ }
+})
type StoredBinary = ArrayBuffer | Uint8Array | Blob
@@ -33,15 +45,7 @@ async function storedBinaryToBytes(row: StoredBinary | undefined): Promise<Uint8
}
function openDatabase(): Promise<IDBPDatabase<LocalCanvasDatabase>> {
- return openDB<LocalCanvasDatabase>(DB_NAME, DB_VERSION, {
- upgrade(database) {
- if (!database.objectStoreNames.contains('meta')) {
- database.createObjectStore('meta', { keyPath: 'id' })
- }
- if (!database.objectStoreNames.contains('fig')) database.createObjectStore('fig')
- if (!database.objectStoreNames.contains('thumb')) database.createObjectStore('thumb')
- }
- })
+ return openAppDatabase(localCanvasDatabase)
}
/** IndexedDB-backed local canvas store (meta + fig/thumb blobs). */
diff --git a/src/app/storage/sync/engine.ts b/src/app/storage/sync/engine.ts
index 78e46967e..2e8000d91 100644
--- a/src/app/storage/sync/engine.ts
+++ b/src/app/storage/sync/engine.ts
@@ -1,5 +1,10 @@
import { IS_BROWSER } from '@open-pencil/core/constants'
+import {
+ describeDiagnosticError,
+ recordStorageFailure,
+ storageOperationForJob
+} from '@/app/diagnostics'
import {
activeStorageProviderID,
createActiveStorageAdapter,
@@ -175,6 +180,13 @@ async function pumpOnce(): Promise<void> {
if (remaining.length === 0) setSyncUI('idle')
else scheduleWake(50)
} catch (error) {
+ const { errorName, errorCode, retryable } = describeDiagnosticError(error)
+ recordStorageFailure({
+ operation: storageOperationForJob(job.type),
+ errorName,
+ errorCode,
+ retryable
+ })
const message = error instanceof Error ? error.message : String(error)
if (error instanceof StorageSyncBlockedError) {
await outbox.update({
diff --git a/src/app/storage/sync/outbox.ts b/src/app/storage/sync/outbox.ts
index 5a31ff934..87623ba0f 100644
--- a/src/app/storage/sync/outbox.ts
+++ b/src/app/storage/sync/outbox.ts
@@ -1,11 +1,22 @@
-import { openDB, type DBSchema } from 'idb'
+import type { DBSchema } from 'idb'
+import { APP_DATABASE_NAMES, defineAppDatabase, openAppDatabase } from '@/app/storage/idb'
import { makeJobId, supersedePutCanvasJobs, type OutboxJob } from '@/app/storage/sync/types'
-const DB_NAME = 'open-pencil-cloud-outbox'
-const DB_VERSION = 1
const STORE = 'jobs'
+const outboxDatabase = defineAppDatabase<OutboxDatabase>({
+ name: APP_DATABASE_NAMES.outbox,
+ version: 1,
+ callbacks: {
+ upgrade(database) {
+ if (!database.objectStoreNames.contains(STORE)) {
+ database.createObjectStore(STORE, { keyPath: 'id' })
+ }
+ }
+ }
+})
+
interface OutboxDatabase extends DBSchema {
jobs: {
key: string
@@ -31,13 +42,7 @@ export type Outbox = {
}
function openDatabase() {
- return openDB<OutboxDatabase>(DB_NAME, DB_VERSION, {
- upgrade(database) {
- if (!database.objectStoreNames.contains(STORE)) {
- database.createObjectStore(STORE, { keyPath: 'id' })
- }
- }
- })
+ return openAppDatabase(outboxDatabase)
}
function buildJob(partial: OutboxEnqueueInput): OutboxJob {
diff --git a/src/app/usage/index.ts b/src/app/usage/index.ts
new file mode 100644
index 000000000..ee41ff69a
--- /dev/null
+++ b/src/app/usage/index.ts
@@ -0,0 +1,2 @@
+export { summarizeUsage } from './summarize'
+export type { UsageModelSummary, UsageSummary } from './summarize'
diff --git a/src/app/usage/summarize.ts b/src/app/usage/summarize.ts
new file mode 100644
index 000000000..2dd024c86
--- /dev/null
+++ b/src/app/usage/summarize.ts
@@ -0,0 +1,57 @@
+import type { DiagnosticEvent } from '@/app/diagnostics/types'
+
+export type UsageModelSummary = {
+ provider: string
+ model: string
+ requests: number
+}
+
+export type UsageSummary = {
+ requests: number
+ completedRequests: number
+ failedRequests: number
+ inputTokens: number | null
+ outputTokens: number | null
+ cacheReadTokens: number | null
+ cacheWriteTokens: number | null
+ unavailableCacheTelemetry: number
+ models: UsageModelSummary[]
+}
+
+function sumAttribute(events: DiagnosticEvent[], name: string): number | null {
+ const values = events
+ .map((event) => event.attributes[name])
+ .filter((value): value is number => typeof value === 'number')
+ return values.length === 0 ? null : values.reduce((sum, value) => sum + value, 0)
+}
+
+export function summarizeUsage(events: DiagnosticEvent[]): UsageSummary {
+ const steps = events.filter((event) => event.name === 'model.step.completed')
+ const completedRequests = events.filter((event) => event.name === 'chat.completed').length
+ const failedRequests = events.filter((event) => event.name === 'chat.failed').length
+ const modelCounts = new Map<string, UsageModelSummary>()
+
+ for (const step of steps) {
+ const provider = String(step.attributes.provider ?? 'unknown')
+ const model = String(step.attributes.model ?? 'unknown')
+ const key = `${provider}\u0000${model}`
+ const current = modelCounts.get(key)
+ if (current) current.requests++
+ else modelCounts.set(key, { provider, model, requests: 1 })
+ }
+
+ return {
+ requests: completedRequests + failedRequests,
+ completedRequests,
+ failedRequests,
+ inputTokens: sumAttribute(steps, 'inputTokens'),
+ outputTokens: sumAttribute(steps, 'outputTokens'),
+ cacheReadTokens: sumAttribute(steps, 'cacheReadTokens'),
+ cacheWriteTokens: sumAttribute(steps, 'cacheWriteTokens'),
+ unavailableCacheTelemetry: steps.filter(
+ (event) =>
+ event.attributes.cacheReadTokens === null && event.attributes.cacheWriteTokens === null
+ ).length,
+ models: [...modelCounts.values()].sort((left, right) => right.requests - left.requests)
+ }
+}
diff --git a/src/components/ChatPanel.vue b/src/components/ChatPanel.vue
index 87b601a29..f9c78d6a7 100644
--- a/src/components/ChatPanel.vue
+++ b/src/components/ChatPanel.vue
@@ -27,7 +27,7 @@ import ACPPermissionDialog from '@/components/chat/ACPPermissionDialog.vue'
import ChatInput from '@/components/chat/ChatInput.vue'
import ChatMessage from '@/components/chat/ChatMessage.vue'
import AppPlaceholder from '@/components/ui/AppPlaceholder.vue'
-import AppTextButton from '@/components/ui/AppTextButton.vue'
+import AppButton from '@/components/ui/AppButton.vue'
import ProviderSetup from '@/components/chat/ProviderSetup.vue'
import { useAIChat } from '@/app/ai/chat/use'
import { toast } from '@/app/shell/ui'
@@ -324,31 +324,26 @@ function handleClearChat() {
v-if="messages.length > 0"
class="flex shrink-0 items-center gap-1 border-t border-border px-3 py-1"
>
- <AppTextButton
- v-if="IS_DEV"
- :ui="{ base: 'flex items-center gap-1 rounded px-1.5 py-0.5 hover:bg-hover' }"
- @click="handleCopyDebug"
- >
+ <AppButton v-if="IS_DEV" color="neutral" variant="ghost" size="xs" @click="handleCopyDebug">
<icon-lucide-clipboard-copy v-if="!debugCopied" class="size-3" />
<icon-lucide-check v-else class="size-3 text-green-400" />
{{ debugCopied ? 'Copied' : 'Copy log' }}
- </AppTextButton>
- <AppTextButton
+ </AppButton>
+ <AppButton
v-if="IS_DEV && hasACPDebugEntries()"
- :ui="{ base: 'flex items-center gap-1 rounded px-1.5 py-0.5 hover:bg-hover' }"
+ color="neutral"
+ variant="ghost"
+ size="xs"
@click="handleCopyACPLog"
>
<icon-lucide-bug v-if="!acpLogCopied" class="size-3" />
<icon-lucide-check v-else class="size-3 text-green-400" />
{{ acpLogCopied ? 'Copied' : 'ACP log' }}
- </AppTextButton>
- <AppTextButton
- :ui="{ base: 'flex items-center gap-1 rounded px-1.5 py-0.5 hover:bg-hover' }"
- @click="handleClearChat"
- >
+ </AppButton>
+ <AppButton color="error" variant="ghost" size="xs" @click="handleClearChat">
<icon-lucide-trash-2 class="size-3" />
Clear
- </AppTextButton>
+ </AppButton>
</div>
<ChatInput
diff --git a/src/components/CodePanel.vue b/src/components/CodePanel.vue
index 7f33f0cf9..10b6bbe1b 100644
--- a/src/components/CodePanel.vue
+++ b/src/components/CodePanel.vue
@@ -23,7 +23,7 @@ import {
import { starterSourceFor, type CodeSource } from '@/app/code/templates'
import { useEditorStore } from '@/app/editor/active-store'
import AppSelect from '@/components/ui/AppSelect.vue'
-import AppTextButton from '@/components/ui/AppTextButton.vue'
+import AppButton from '@/components/ui/AppButton.vue'
import Tip from '@/components/ui/Tip.vue'
import statusTheme from '@/theme/status'
@@ -231,14 +231,17 @@ watch(
@update:model-value="changeSource"
/>
<Tip v-if="source !== 'html-css'" :label="dialogs.copyJSXReference">
- <AppTextButton
+ <AppButton
+ color="neutral"
+ variant="ghost"
+ size="xs"
+ shape="square"
data-test-id="code-panel-copy-ref"
- :ui="{ base: 'rounded p-1.5 text-[11px] hover:bg-hover' }"
@click="copyReference(JSX_REFERENCE)"
>
<icon-lucide-check v-if="copiedReference" class="size-3 text-[var(--color-success)]" />
<icon-lucide-book-open v-else class="size-3" />
- </AppTextButton>
+ </AppButton>
</Tip>
</header>
@@ -273,26 +276,28 @@ watch(
{{ readOnly ? dialogs.codeGeneratedReadOnly : statusText }}
</span>
<div class="flex items-center gap-1">
- <AppTextButton
+ <AppButton
v-if="dirty && !readOnly"
+ color="neutral"
+ variant="ghost"
+ size="xs"
data-test-id="code-panel-reset"
- :ui="{
- base: 'flex items-center gap-1 rounded px-2 py-1 text-[11px] hover:bg-hover'
- }"
@click="resetDraft"
>
<icon-lucide-rotate-ccw class="size-3" />
{{ dialogs.codeReset }}
- </AppTextButton>
- <AppTextButton
+ </AppButton>
+ <AppButton
+ color="neutral"
+ variant="ghost"
+ size="xs"
data-test-id="code-panel-copy"
- :ui="{ base: 'flex items-center gap-1 rounded px-2 py-1 text-[11px] hover:bg-hover' }"
@click="copy(draft)"
>
<icon-lucide-check v-if="copied" class="size-3 text-[var(--color-success)]" />
<icon-lucide-copy v-else class="size-3" />
{{ copied ? dialogs.copied : dialogs.copy }}
- </AppTextButton>
+ </AppButton>
</div>
</footer>
</div>
diff --git a/src/components/FontSettings/FontSettingsPopover.vue b/src/components/FontSettings/FontSettingsPopover.vue
index 6f5d71e4f..f955330d2 100644
--- a/src/components/FontSettings/FontSettingsPopover.vue
+++ b/src/components/FontSettings/FontSettingsPopover.vue
@@ -8,28 +8,22 @@ import { WEB_FONT_PROVIDER_IDS, WEB_FONT_PROVIDER_LABELS } from '@open-pencil/co
import type { WebFontProviderId } from '@open-pencil/core/text'
import { useI18n } from '@open-pencil/vue'
import Tip from '@/components/ui/Tip.vue'
-import { useButtonUI } from '@/components/ui/button'
+import AppButton from '@/components/ui/AppButton.vue'
import { usePopoverUI } from '@/components/ui/popover'
const { dialogs } = useI18n()
const cls = usePopoverUI({ content: 'isolate z-[51] w-80 p-3' })
-const trigger = useButtonUI({
- tone: 'ghost',
- size: 'iconSm',
- ui: { base: 'shrink-0' }
-})
-const secondaryButton = useButtonUI({
- tone: 'ghost',
- size: 'sm',
- ui: {
- base: 'w-full bg-input px-2 py-1.5 text-[10px] font-medium text-surface hover:bg-hover disabled:opacity-50'
- }
-})
-const primaryButton = useButtonUI({
- tone: 'accent',
- size: 'sm',
- ui: { base: 'w-full px-2 py-1.5 text-[10px] font-medium disabled:opacity-50' }
-})
+const trigger = 'shrink-0'
+const secondaryButton = {
+ color: 'neutral' as const,
+ variant: 'soft' as const,
+ size: 'xs' as const
+}
+const primaryButton = {
+ color: 'primary' as const,
+ variant: 'solid' as const,
+ size: 'xs' as const
+}
const showDownloadedFonts = isTauri()
const webFontProviderIds = WEB_FONT_PROVIDER_IDS
const popoverOpen = ref(false)
@@ -79,7 +73,7 @@ onMounted(() => {
<PopoverTrigger
data-test-id="font-settings-trigger"
:aria-label="dialogs.fontSettings"
- :class="trigger.base"
+ :class="trigger"
>
<icon-lucide-settings class="size-3.5" />
</PopoverTrigger>
@@ -147,15 +141,17 @@ onMounted(() => {
}}
</p>
</div>
- <button
+ <AppButton
type="button"
data-test-id="font-settings-request-access"
- :class="secondaryButton.base"
+ :color="secondaryButton.color"
+ :variant="secondaryButton.variant"
+ :size="secondaryButton.size"
:disabled="busyAction !== null || !canRequestLocalFonts"
@click="requestAccess"
>
{{ busyAction === 'access' ? dialogs.requesting : dialogs.allow }}
- </button>
+ </AppButton>
</div>
<div class="grid gap-2 rounded border border-border p-2">
@@ -168,15 +164,17 @@ onMounted(() => {
{{ dialogs.downloadMissingWebFonts }}
</p>
</div>
- <button
+ <AppButton
type="button"
data-test-id="font-settings-toggle-online-fonts"
- :class="secondaryButton.base"
+ :color="secondaryButton.color"
+ :variant="secondaryButton.variant"
+ :size="secondaryButton.size"
:disabled="busyAction !== null"
@click="setOnlineFontsEnabled(!onlineFontsEnabled)"
>
{{ onlineFontsEnabled ? dialogs.disable : dialogs.enable }}
- </button>
+ </AppButton>
</div>
<div class="grid gap-1 border-t border-border pt-2">
@@ -208,37 +206,43 @@ onMounted(() => {
{{ dialogs.downloadFallbackPacksDescription }}
</p>
</div>
- <button
+ <AppButton
type="button"
data-test-id="font-settings-download-fallbacks"
- :class="primaryButton.base"
+ :color="primaryButton.color"
+ :variant="primaryButton.variant"
+ :size="primaryButton.size"
:disabled="busyAction !== null"
@click="downloadFallbacks"
>
{{ busyAction === 'download' ? dialogs.downloading : dialogs.download }}
- </button>
+ </AppButton>
</div>
</div>
<div v-if="showDownloadedFonts" class="grid grid-cols-2 gap-1.5">
- <button
+ <AppButton
type="button"
data-test-id="font-settings-refresh-cache"
- :class="secondaryButton.base"
+ :color="secondaryButton.color"
+ :variant="secondaryButton.variant"
+ :size="secondaryButton.size"
:disabled="busyAction !== null"
@click="refreshSummary"
>
{{ dialogs.refresh }}
- </button>
- <button
+ </AppButton>
+ <AppButton
type="button"
data-test-id="font-settings-clear-cache"
- :class="secondaryButton.base"
+ :color="secondaryButton.color"
+ :variant="secondaryButton.variant"
+ :size="secondaryButton.size"
:disabled="busyAction !== null || cacheCount === 0"
@click="clearCache"
>
{{ dialogs.clearCache }}
- </button>
+ </AppButton>
</div>
<p
diff --git a/src/components/assets-panel/AssetsPanel.vue b/src/components/assets-panel/AssetsPanel.vue
index e26ffaf62..fde9757a7 100644
--- a/src/components/assets-panel/AssetsPanel.vue
+++ b/src/components/assets-panel/AssetsPanel.vue
@@ -25,7 +25,7 @@ import AssetThumbnail from '@/components/assets-panel/AssetThumbnail.vue'
import { findAssetPage } from '@/components/assets-panel/page'
import AppInput from '@/components/ui/AppInput.vue'
import AppPlaceholder from '@/components/ui/AppPlaceholder.vue'
-import { useButtonUI } from '@/components/ui/button'
+import AppButton from '@/components/ui/AppButton.vue'
import { AppDialogRoot, useDialogUI } from '@/components/ui/dialog'
import { useMenuUI } from '@/components/ui/menu'
import SegmentedControl from '@/components/ui/SegmentedControl.vue'
@@ -78,8 +78,13 @@ const previewURL = useObjectUrl(previewBlob)
const previewLoading = ref(false)
const insertingAssetId = ref<string | null>(null)
let previewRequestId = 0
-const insertButton = useButtonUI({ tone: 'ghost', size: 'iconSm' })
-const primaryButton = useButtonUI({ tone: 'accent', size: 'md' })
+const insertButton = {
+ color: 'neutral' as const,
+ variant: 'ghost' as const,
+ size: 'sm' as const,
+ shape: 'square' as const
+}
+const primaryButton = { color: 'primary' as const, variant: 'solid' as const, size: 'md' as const }
const dialog = useDialogUI()
const contextMenu = useMenuUI({ content: 'min-w-44' })
const viewOptions = computed(() => [
@@ -327,9 +332,8 @@ async function insertSelectedAsset() {
class="min-w-0 flex-1"
:placeholder="panels.searchLocalComponents"
/>
- <button
- type="button"
- :class="insertButton.base"
+ <AppButton
+ v-bind="insertButton"
class="relative"
:aria-label="libraryUpdateCount > 0 ? panels.reviewLibraryUpdates : panels.manageLibraries"
@click="openLibraries"
@@ -341,7 +345,7 @@ async function insertSelectedAsset() {
>
{{ libraryUpdateCount }}
</span>
- </button>
+ </AppButton>
<SegmentedControl
v-model="assetView"
data-test-id="assets-view-toggle"
@@ -435,27 +439,25 @@ async function insertSelectedAsset() {
</span>
<div v-if="assetView === 'list'" class="flex shrink-0 items-center">
<Tip v-if="asset.docsURL" :label="panels.openDocumentation">
- <button
- type="button"
- :class="insertButton.base"
+ <AppButton
+ v-bind="insertButton"
data-test-id="asset-docs"
@pointerdown.stop
@click.stop="asset.docsURL ? openExternalLink(asset.docsURL) : undefined"
>
<icon-lucide-book-open class="size-3" />
- </button>
+ </AppButton>
</Tip>
<Tip :label="commands.createInstance">
- <button
- type="button"
- :class="insertButton.base"
+ <AppButton
+ v-bind="insertButton"
data-test-id="asset-insert"
:disabled="insertingAssetId === asset.id"
@pointerdown.stop
@click.stop="insertAsset(asset)"
>
<icon-lucide-plus class="size-3" />
- </button>
+ </AppButton>
</Tip>
</div>
</div>
@@ -556,14 +558,14 @@ async function insertSelectedAsset() {
</p>
</div>
</div>
- <button
+ <AppButton
+ v-bind="primaryButton"
data-test-id="asset-details-insert"
- :class="primaryButton.base"
class="mt-3 w-full"
@click="insertSelectedAsset"
>
{{ panels.insertInstance }}
- </button>
+ </AppButton>
</div>
<div class="min-w-0 p-4">
@@ -589,14 +591,17 @@ async function insertSelectedAsset() {
<h3 class="text-[11px] font-medium tracking-wider text-muted uppercase">
{{ panels.documentation }}
</h3>
- <button
+ <AppButton
+ color="primary"
+ variant="link"
+ size="xs"
data-test-id="asset-details-docs"
- class="mt-1 inline-flex items-center gap-1 rounded px-1 py-0.5 text-xs text-component hover:bg-component/10"
+ class="mt-1"
@click="selectedAsset.docsURL ? openExternalLink(selectedAsset.docsURL) : undefined"
>
<icon-lucide-book-open class="size-3" />
{{ panels.openDocs }}
- </button>
+ </AppButton>
</section>
<section v-if="selectedAsset.variants.length > 0">
diff --git a/src/components/recovery/RecoveryDialog.vue b/src/components/recovery/RecoveryDialog.vue
index cb67c24f3..1011cfea3 100644
--- a/src/components/recovery/RecoveryDialog.vue
+++ b/src/components/recovery/RecoveryDialog.vue
@@ -1,8 +1,7 @@
<script setup lang="ts">
+import { AlertDialogCancel } from 'reka-ui'
import { onMounted, ref } from 'vue'
import { useRoute } from 'vue-router'
-import { AlertDialogCancel, AlertDialogDescription, AlertDialogTitle } from 'reka-ui'
-
import { useI18n } from '@open-pencil/vue'
import { recoveryEnabled } from '@/app/document/recovery/preferences'
import { useNotificationMessages } from '@/app/i18n/notifications'
@@ -10,7 +9,7 @@ import { discardRecoverySnapshot, listRecoverySnapshots, restoreRecoverySnapshot
import type { RecoverySnapshotMeta } from '@/app/document/recovery'
import { formatStorageBytes } from '@/app/storage/format-bytes'
import { toast } from '@/app/shell/ui'
-import { AppAlertDialogRoot, AppDialogBody, AppDialogFooter } from '@/components/ui/dialog'
+import AppButton from '@/components/ui/AppButton.vue'
const { dialogs } = useI18n()
const notifications = useNotificationMessages()
@@ -89,30 +88,30 @@ onMounted(async () => {
{{ updatedLabel(snapshot) }} · {{ formatStorageBytes(snapshot.byteLength) }}
</p>
</div>
- <button
- type="button"
- class="rounded px-2 py-1 text-xs text-danger hover:bg-danger/10 disabled:opacity-50"
+ <AppButton
+ color="error"
+ variant="ghost"
+ size="xs"
:disabled="busyId !== null"
@click="discard(snapshot)"
>
{{ dialogs.discard }}
- </button>
- <button
- type="button"
- class="rounded bg-accent px-2.5 py-1 text-xs text-white disabled:opacity-50"
+ </AppButton>
+ <AppButton
+ color="primary"
+ variant="solid"
+ size="xs"
:disabled="busyId !== null"
@click="restore(snapshot)"
>
{{ dialogs.restore }}
- </button>
+ </AppButton>
</div>
</div>
</AppDialogBody>
<AppDialogFooter>
<AlertDialogCancel as-child>
- <button class="rounded px-3 py-1.5 text-xs text-muted hover:bg-hover">
- {{ dialogs.close }}
- </button>
+ <AppButton color="neutral" variant="ghost">{{ dialogs.close }}</AppButton>
</AlertDialogCancel>
</AppDialogFooter>
</AppAlertDialogRoot>
diff --git a/src/components/settings/SettingsDialog.vue b/src/components/settings/SettingsDialog.vue
index 6ea75979d..22ef0b6bc 100644
--- a/src/components/settings/SettingsDialog.vue
+++ b/src/components/settings/SettingsDialog.vue
@@ -7,11 +7,13 @@ import { IS_TAURI } from '@open-pencil/core/constants'
import { useAIChat } from '@/app/ai/chat/use'
import { appCredentialServices } from '@/app/settings/credentials/app'
import { settingsDialogOpen, settingsDialogSection } from '@/app/settings/dialog'
+import DiagnosticsSettingsPanel from '@/components/settings/diagnostics/DiagnosticsSettingsPanel.vue'
import GeneralSettingsPanel from '@/components/settings/general/GeneralSettingsPanel.vue'
import MCPConnectionsSection from '@/components/settings/mcp/MCPConnectionsSection.vue'
import MCPSettingsPanel from '@/components/settings/mcp/MCPSettingsPanel.vue'
import ModelsPanel from '@/components/settings/models/ModelsPanel.vue'
import StockPhotoKeysSection from '@/components/settings/provider/StockPhotoKeysSection.vue'
+import UsageSettingsPanel from '@/components/settings/usage/UsageSettingsPanel.vue'
import StorageSettingsPanel from '@/components/settings/storage/StorageSettingsPanel.vue'
import VectorizeSettingsSection from '@/components/settings/vectorize/VectorizeSettingsSection.vue'
import AppSwitch from '@/components/ui/AppSwitch.vue'
@@ -80,6 +82,27 @@ const navigationClass =
<icon-lucide-sparkles class="size-3.5" />
{{ dialogs.settingsAIAndAgents }}
</button>
+ <button
+ type="button"
+ :class="navigationClass"
+ :data-state="settingsDialogSection === 'usage' ? 'active' : 'inactive'"
+ data-test-id="settings-section-usage"
+ @click="settingsDialogSection = 'usage'"
+ >
+ <icon-lucide-chart-no-axes-combined class="size-3.5" />
+ {{ dialogs.settingsUsage }}
+ </button>
+ <button
+ type="button"
+ :class="navigationClass"
+ :data-state="settingsDialogSection === 'diagnostics' ? 'active' : 'inactive'"
+ data-test-id="settings-section-diagnostics"
+ @click="settingsDialogSection = 'diagnostics'"
+ >
+ <icon-lucide-activity class="size-3.5" />
+ {{ dialogs.settingsDiagnostics }}
+ </button>
+
<button
type="button"
:class="navigationClass"
@@ -123,6 +146,10 @@ const navigationClass =
<ModelsPanel />
</section>
+ <UsageSettingsPanel v-else-if="settingsDialogSection === 'usage'" />
+
+ <DiagnosticsSettingsPanel v-else-if="settingsDialogSection === 'diagnostics'" />
+
<section
v-else-if="settingsDialogSection === 'mcp'"
class="flex flex-col"
diff --git a/src/components/settings/diagnostics/DiagnosticsSettingsPanel.vue b/src/components/settings/diagnostics/DiagnosticsSettingsPanel.vue
new file mode 100644
index 000000000..2d879d5bd
--- /dev/null
+++ b/src/components/settings/diagnostics/DiagnosticsSettingsPanel.vue
@@ -0,0 +1,180 @@
+<script setup lang="ts">
+import { useI18n, SegmentedControlItem, SegmentedControlRoot } from '@open-pencil/vue'
+import { computed, onUnmounted, ref } from 'vue'
+
+import {
+ diagnostics,
+ summarizeDiagnosticEvent,
+ type DiagnosticEventSummary
+} from '@/app/diagnostics'
+import {
+ diagnosticsRetentionOptions,
+ pruneDiagnostics,
+ useDiagnosticsSettings
+} from '@/app/diagnostics/settings'
+import { toast } from '@/app/shell/ui'
+import { AppConfirmationDialog } from '@/components/ui/dialog'
+import AppButton from '@/components/ui/AppButton.vue'
+import AppSwitch from '@/components/ui/AppSwitch.vue'
+
+const { dialogs } = useI18n()
+const recentEvents = ref<DiagnosticEventSummary[]>([])
+const clearOpen = ref(false)
+
+async function refreshEventSummaries() {
+ recentEvents.value = (await diagnostics.list())
+ .slice(0, 20)
+ .map((event) => summarizeDiagnosticEvent(event, dialogs.value))
+}
+
+void refreshEventSummaries()
+const unsubscribe = diagnostics.subscribe(() => {
+ void refreshEventSummaries()
+ void refreshDiagnosticsStats()
+})
+onUnmounted(unsubscribe)
+
+const {
+ diagnosticsEnabled,
+ usageEnabled,
+ diagnosticsCount,
+ diagnosticsSize,
+ diagnosticsRetention,
+ refreshDiagnosticsStats
+} = useDiagnosticsSettings()
+
+const retentionValue = computed<string>({
+ get: () => String(diagnosticsRetention.value),
+ set: (value) => {
+ const parsed = Number(value)
+ if (parsed === 100 || parsed === 500 || parsed === 1000) {
+ diagnosticsRetention.value = parsed
+ void pruneDiagnostics(parsed)
+ void refreshDiagnosticsStats()
+ }
+ }
+})
+
+async function clearDiagnostics() {
+ await diagnostics.clear()
+ await refreshDiagnosticsStats()
+ clearOpen.value = false
+ toast.info(dialogs.value.diagnosticsCleared)
+}
+
+async function exportDiagnostics() {
+ const text = await diagnostics.export()
+ try {
+ await navigator.clipboard.writeText(text)
+ toast.info(dialogs.value.diagnosticsCopied)
+ } catch {
+ toast.error(dialogs.value.diagnosticsCopyFailed)
+ }
+}
+</script>
+
+<template>
+ <section class="flex flex-col gap-4" data-test-id="settings-diagnostics-panel">
+ <div>
+ <h3 class="text-xs font-semibold text-surface">{{ dialogs.diagnosticsTitle }}</h3>
+ <p class="mt-1 text-[11px] text-muted">{{ dialogs.diagnosticsDescription }}</p>
+ </div>
+ <div class="flex flex-col divide-y divide-border rounded border border-border">
+ <label class="flex items-center justify-between gap-4 px-3 py-2.5">
+ <span
+ ><span class="block text-xs text-surface">{{ dialogs.localDiagnostics }}</span
+ ><span class="block text-[10px] text-muted">{{
+ dialogs.localDiagnosticsDescription
+ }}</span></span
+ >
+ <AppSwitch v-model="diagnosticsEnabled" :label="dialogs.localDiagnostics" />
+ </label>
+ <label class="flex items-center justify-between gap-4 px-3 py-2.5">
+ <span
+ ><span class="block text-xs text-surface">{{ dialogs.usageHistory }}</span
+ ><span v-if="usageEnabled" class="block text-[10px] text-muted">{{
+ dialogs.usageHistoryDescription
+ }}</span></span
+ >
+ <AppSwitch v-model="usageEnabled" :label="dialogs.usageHistory" />
+ </label>
+ <div class="flex items-center justify-between gap-4 px-3 py-2.5">
+ <span
+ ><span class="block text-xs text-surface">{{ dialogs.diagnosticsRetention }}</span
+ ><span class="block text-[10px] text-muted">{{
+ dialogs.diagnosticsRetentionDescription
+ }}</span></span
+ >
+ <SegmentedControlRoot
+ v-model="retentionValue"
+ required
+ class="flex rounded border border-border p-0.5"
+ :aria-label="dialogs.diagnosticsRetention"
+ >
+ <SegmentedControlItem
+ v-for="option in diagnosticsRetentionOptions"
+ :key="option"
+ :value="String(option)"
+ class="rounded px-2 py-1 text-[10px] text-muted data-[state=on]:bg-hover data-[state=on]:text-surface"
+ >{{ option }}</SegmentedControlItem
+ >
+ </SegmentedControlRoot>
+ </div>
+ </div>
+ <div
+ v-if="recentEvents.length"
+ class="flex max-h-64 flex-col overflow-y-auto divide-y divide-border rounded border border-border"
+ >
+ <div
+ v-for="event in recentEvents"
+ :key="`${event.timestamp}-${event.label}`"
+ class="flex items-center justify-between gap-3 px-3 py-2 text-[11px]"
+ >
+ <span class="flex min-w-0 items-center gap-2">
+ <icon-lucide-circle-alert
+ v-if="event.level === 'error'"
+ class="size-3.5 shrink-0 text-red-400"
+ />
+ <icon-lucide-info v-else class="size-3.5 shrink-0 text-muted" />
+ <span class="truncate text-surface">{{ event.label }}</span>
+ </span>
+ <span class="shrink-0 text-muted">{{
+ new Date(event.timestamp).toLocaleTimeString()
+ }}</span>
+ </div>
+ </div>
+ <div class="flex items-center justify-between text-[11px] text-muted">
+ <span>{{
+ dialogs.diagnosticsEventCount({
+ count: diagnosticsCount,
+ size: Math.ceil(diagnosticsSize / 1024)
+ })
+ }}</span>
+ <div class="flex items-center gap-1.5">
+ <AppButton size="xs" color="neutral" variant="ghost" @click="exportDiagnostics"
+ ><template #leading><icon-lucide-copy /></template
+ >{{ dialogs.diagnosticsCopy }}</AppButton
+ >
+ <AppButton
+ size="xs"
+ color="error"
+ variant="ghost"
+ :disabled="diagnosticsCount === 0"
+ @click="clearOpen = true"
+ ><template #leading><icon-lucide-trash-2 /></template
+ >{{ dialogs.diagnosticsClear }}</AppButton
+ >
+ </div>
+ </div>
+ </section>
+
+ <AppConfirmationDialog
+ v-model:open="clearOpen"
+ :heading="dialogs.diagnosticsClear"
+ :description="dialogs.diagnosticsClearDescription"
+ :cancel-label="dialogs.cancel"
+ :confirm-label="dialogs.diagnosticsClear"
+ tone="danger"
+ @confirm="clearDiagnostics"
+ />
+</template>
diff --git a/src/components/settings/mcp/MCPConnectionsSection.vue b/src/components/settings/mcp/MCPConnectionsSection.vue
index 88fb87841..5b7123d04 100644
--- a/src/components/settings/mcp/MCPConnectionsSection.vue
+++ b/src/components/settings/mcp/MCPConnectionsSection.vue
@@ -1,12 +1,6 @@
<script setup lang="ts">
-import { computed, onMounted, ref, watch } from 'vue'
-import {
- AlertDialogAction,
- AlertDialogCancel,
- AlertDialogDescription,
- AlertDialogTitle
-} from 'reka-ui'
import { useI18n } from '@open-pencil/vue'
+import { computed, onMounted, ref, watch } from 'vue'
import {
createMCPConnectionDraft,
@@ -21,7 +15,7 @@ import type { CredentialStatus } from '@/app/settings/credentials/types'
import ProviderSettingsKeyField from '@/components/settings/provider/ProviderSettingsKeyField.vue'
import AppInput from '@/components/ui/AppInput.vue'
import AppSwitch from '@/components/ui/AppSwitch.vue'
-import { AppAlertDialogRoot, AppDialogBody, AppDialogFooter } from '@/components/ui/dialog'
+import { AppConfirmationDialog } from '@/components/ui/dialog'
const { dialogs } = useI18n()
const editing = ref(false)
@@ -235,28 +229,13 @@ onMounted(() => {
</div>
</section>
- <AppAlertDialogRoot v-model:open="deleteOpen">
- <div class="border-b border-border px-4 py-3">
- <AlertDialogTitle class="text-sm font-semibold text-surface">
- {{ dialogs.deleteMCPConnection }}
- </AlertDialogTitle>
- </div>
- <AppDialogBody>
- <AlertDialogDescription class="text-xs text-muted">
- {{ dialogs.deleteMCPConnectionDescription }}
- </AlertDialogDescription>
- </AppDialogBody>
- <AppDialogFooter>
- <AlertDialogCancel as-child>
- <button class="rounded px-3 py-1.5 text-xs text-muted hover:bg-hover">
- {{ dialogs.cancel }}
- </button>
- </AlertDialogCancel>
- <AlertDialogAction as-child>
- <button class="rounded bg-danger px-3 py-1.5 text-xs text-white" @click="remove">
- {{ dialogs.deleteMCPConnection }}
- </button>
- </AlertDialogAction>
- </AppDialogFooter>
- </AppAlertDialogRoot>
+ <AppConfirmationDialog
+ v-model:open="deleteOpen"
+ :heading="dialogs.deleteMCPConnection"
+ :description="dialogs.deleteMCPConnectionDescription"
+ :cancel-label="dialogs.cancel"
+ :confirm-label="dialogs.deleteMCPConnection"
+ tone="danger"
+ @confirm="remove"
+ />
</template>
diff --git a/src/components/settings/models/ProfileEditor.vue b/src/components/settings/models/ProfileEditor.vue
index abae35afc..592317827 100644
--- a/src/components/settings/models/ProfileEditor.vue
+++ b/src/components/settings/models/ProfileEditor.vue
@@ -1,14 +1,6 @@
<script setup lang="ts">
import { computed, reactive, ref, watch } from 'vue'
-import {
- AlertDialogAction,
- AlertDialogCancel,
- AlertDialogDescription,
- AlertDialogTitle,
- CollapsibleContent,
- CollapsibleRoot,
- CollapsibleTrigger
-} from 'reka-ui'
+import { CollapsibleContent, CollapsibleRoot, CollapsibleTrigger } from 'reka-ui'
import { useI18n } from '@open-pencil/vue'
import { ACP_AGENTS, AI_PROVIDERS, type AIProviderID } from '@open-pencil/core/constants'
@@ -40,7 +32,7 @@ import ProviderSettingsKeyField from '@/components/settings/provider/ProviderSet
import AppInput from '@/components/ui/AppInput.vue'
import AppSelect from '@/components/ui/AppSelect.vue'
import AppSwitch from '@/components/ui/AppSwitch.vue'
-import { AppAlertDialogRoot, AppDialogBody, AppDialogFooter } from '@/components/ui/dialog'
+import { AppConfirmationDialog } from '@/components/ui/dialog'
const CUSTOM_MODEL_VALUE = '__custom__'
const DEFAULT_MAX_OUTPUT_TOKENS = 16_384
@@ -523,28 +515,14 @@ void refreshKeyStatus()
</div>
</div>
- <AppAlertDialogRoot v-model:open="deleteOpen" data-test-id="delete-model-dialog">
- <div class="border-b border-border px-4 py-3">
- <AlertDialogTitle class="text-sm font-semibold text-surface">
- {{ dialogs.deleteModel }}
- </AlertDialogTitle>
- </div>
- <AppDialogBody>
- <AlertDialogDescription class="text-xs text-muted">
- {{ dialogs.deleteModelDescription }}
- </AlertDialogDescription>
- </AppDialogBody>
- <AppDialogFooter>
- <AlertDialogCancel as-child>
- <button class="rounded px-3 py-1.5 text-xs text-muted hover:bg-hover">
- {{ dialogs.cancel }}
- </button>
- </AlertDialogCancel>
- <AlertDialogAction as-child>
- <button class="rounded bg-danger px-3 py-1.5 text-xs text-white" @click="remove">
- {{ dialogs.deleteModel }}
- </button>
- </AlertDialogAction>
- </AppDialogFooter>
- </AppAlertDialogRoot>
+ <AppConfirmationDialog
+ v-model:open="deleteOpen"
+ data-test-id="delete-model-dialog"
+ :heading="dialogs.deleteModel"
+ :description="dialogs.deleteModelDescription"
+ :cancel-label="dialogs.cancel"
+ :confirm-label="dialogs.deleteModel"
+ tone="danger"
+ @confirm="remove"
+ />
</template>
diff --git a/src/components/settings/provider/ProviderSettingsField.vue b/src/components/settings/provider/ProviderSettingsField.vue
index 21dd342da..3b5a1627f 100644
--- a/src/components/settings/provider/ProviderSettingsField.vue
+++ b/src/components/settings/provider/ProviderSettingsField.vue
@@ -1,5 +1,5 @@
<script setup lang="ts">
-import AppTextButton from '@/components/ui/AppTextButton.vue'
+import AppButton from '@/components/ui/AppButton.vue'
interface ProviderSettingsFieldProps {
label: string
@@ -18,9 +18,16 @@ const emit = defineEmits<{ clear: [] }>()
<div class="flex flex-col gap-1">
<div class="flex items-center justify-between">
<label :for="labelFor" class="text-[10px] text-muted">{{ label }}</label>
- <AppTextButton v-if="clearLabel" v-bind="$attrs" @click="emit('clear')">
+ <AppButton
+ v-if="clearLabel"
+ color="neutral"
+ variant="link"
+ size="xs"
+ v-bind="$attrs"
+ @click="emit('clear')"
+ >
{{ clearLabel }}
- </AppTextButton>
+ </AppButton>
</div>
<slot />
<slot name="hint" />
diff --git a/src/components/settings/provider/ProviderSettingsLink.vue b/src/components/settings/provider/ProviderSettingsLink.vue
index 682a616aa..2e036dea6 100644
--- a/src/components/settings/provider/ProviderSettingsLink.vue
+++ b/src/components/settings/provider/ProviderSettingsLink.vue
@@ -1,17 +1,18 @@
<script setup lang="ts">
import { openExternalLink } from '@/app/shell/ui'
-import AppTextButton from '@/components/ui/AppTextButton.vue'
+import AppButton from '@/components/ui/AppButton.vue'
const { href } = defineProps<{ href: string }>()
</script>
<template>
- <AppTextButton
- size="sm"
- underline
- :ui="{ base: 'self-start text-left text-[11px]' }"
+ <AppButton
+ color="primary"
+ variant="link"
+ size="xs"
+ class="self-start text-left"
@click="openExternalLink(href)"
>
<slot />
- </AppTextButton>
+ </AppButton>
</template>
diff --git a/src/components/settings/usage/UsageSettingsPanel.vue b/src/components/settings/usage/UsageSettingsPanel.vue
new file mode 100644
index 000000000..212911e67
--- /dev/null
+++ b/src/components/settings/usage/UsageSettingsPanel.vue
@@ -0,0 +1,80 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref } from 'vue'
+import { useI18n } from '@open-pencil/vue'
+
+import { diagnostics } from '@/app/diagnostics'
+import { isUsageEnabled } from '@/app/diagnostics/settings'
+import { summarizeUsage, type UsageSummary } from '@/app/usage'
+
+const { dialogs } = useI18n()
+const summary = ref<UsageSummary>(summarizeUsage([]))
+
+async function refresh() {
+ summary.value = summarizeUsage(await diagnostics.list())
+}
+
+onMounted(() => {
+ if (!isUsageEnabled()) return
+ void refresh()
+})
+
+const unsubscribe = diagnostics.subscribe(() => {
+ if (isUsageEnabled()) void refresh()
+ else summary.value = summarizeUsage([])
+})
+
+onUnmounted(unsubscribe)
+
+function formatTokenValue(value: number | null): string {
+ return value === null ? dialogs.value.usageNotReported : value.toLocaleString()
+}
+</script>
+
+<template>
+ <section class="flex flex-col gap-4" data-test-id="settings-usage-panel">
+ <div>
+ <h3 class="text-xs font-semibold text-surface">{{ dialogs.settingsUsage }}</h3>
+ <p class="mt-1 text-[11px] text-muted">{{ dialogs.usageDescription }}</p>
+ </div>
+
+ <div class="grid grid-cols-2 gap-2">
+ <div class="rounded border border-border p-3">
+ <div class="text-[10px] text-muted">{{ dialogs.usageRequests }}</div>
+ <div class="mt-1 text-sm font-semibold text-surface">{{ summary.requests }}</div>
+ </div>
+ <div class="rounded border border-border p-3">
+ <div class="text-[10px] text-muted">{{ dialogs.usageCompleted }}</div>
+ <div class="mt-1 text-sm font-semibold text-surface">{{ summary.completedRequests }}</div>
+ </div>
+ <div class="rounded border border-border p-3">
+ <div class="text-[10px] text-muted">{{ dialogs.usageInputTokens }}</div>
+ <div class="mt-1 text-sm font-semibold text-surface">
+ {{ formatTokenValue(summary.inputTokens) }}
+ </div>
+ </div>
+ <div class="rounded border border-border p-3">
+ <div class="text-[10px] text-muted">{{ dialogs.usageOutputTokens }}</div>
+ <div class="mt-1 text-sm font-semibold text-surface">
+ {{ formatTokenValue(summary.outputTokens) }}
+ </div>
+ </div>
+ </div>
+
+ <div class="flex flex-col gap-2">
+ <h4 class="text-xs font-semibold text-surface">{{ dialogs.usageByModel }}</h4>
+ <div v-if="summary.models.length === 0" class="text-[11px] text-muted">
+ {{ dialogs.usageNoData }}
+ </div>
+ <div
+ v-for="model in summary.models"
+ :key="`${model.provider}-${model.model}`"
+ class="flex justify-between text-[11px]"
+ >
+ <span class="text-muted">{{ model.provider }} · {{ model.model }}</span>
+ <span class="text-surface">{{ model.requests }}</span>
+ </div>
+ </div>
+
+ <p class="text-[10px] text-muted">{{ dialogs.usageCacheNote }}</p>
+ </section>
+</template>
diff --git a/src/components/ui/AppButton.stories.ts b/src/components/ui/AppButton.stories.ts
new file mode 100644
index 000000000..6918b0680
--- /dev/null
+++ b/src/components/ui/AppButton.stories.ts
@@ -0,0 +1,67 @@
+import type { Meta, StoryObj } from '@storybook/vue3-vite'
+
+import AppButton from './AppButton.vue'
+
+type AppButtonStoryArgs = {
+ color: 'neutral' | 'primary' | 'error'
+ variant: 'solid' | 'outline' | 'soft' | 'subtle' | 'ghost' | 'link'
+ size: 'xs' | 'sm' | 'md' | 'lg'
+ shape: 'square' | 'rounded' | 'pill'
+ disabled: boolean
+ loading: boolean
+}
+
+type Story = StoryObj<AppButtonStoryArgs>
+
+const meta = {
+ title: 'Design System/Button',
+ component: AppButton,
+ args: {
+ color: 'neutral',
+ variant: 'ghost',
+ size: 'sm',
+ shape: 'rounded',
+ disabled: false,
+ loading: false
+ },
+ render: (args) => ({
+ components: { AppButton },
+ setup: () => ({ args }),
+ template: `
+ <div class="flex min-h-40 flex-wrap items-center gap-3 bg-app p-6 text-surface">
+ <AppButton v-bind="args">
+ <template #leading><icon-lucide-copy /></template>
+ Copy diagnostics
+ </AppButton>
+ <AppButton v-bind="args" variant="solid" color="primary">Primary action</AppButton>
+ <AppButton v-bind="args" color="error">
+ <template #leading><icon-lucide-trash-2 /></template>
+ Clear
+ </AppButton>
+ </div>
+ `
+ })
+} satisfies Meta<AppButtonStoryArgs>
+
+export default meta
+
+export const Default: Story = {}
+export const Solid: Story = { args: { color: 'primary', variant: 'solid' } }
+export const Outline: Story = { args: { color: 'neutral', variant: 'outline' } }
+export const Error: Story = { args: { color: 'error', variant: 'ghost' } }
+export const Link: Story = { args: { color: 'primary', variant: 'link' } }
+export const Disabled: Story = { args: { disabled: true } }
+export const Loading: Story = { args: { loading: true } }
+export const Sizes: Story = {
+ render: () => ({
+ components: { AppButton },
+ template: `
+ <div class="flex items-center gap-3 bg-app p-6 text-surface">
+ <AppButton size="xs">Extra small</AppButton>
+ <AppButton size="sm">Small</AppButton>
+ <AppButton size="md">Medium</AppButton>
+ <AppButton size="lg">Large</AppButton>
+ </div>
+ `
+ })
+}
diff --git a/src/components/ui/AppButton.vue b/src/components/ui/AppButton.vue
new file mode 100644
index 000000000..82079d9e1
--- /dev/null
+++ b/src/components/ui/AppButton.vue
@@ -0,0 +1,59 @@
+<script setup lang="ts">
+import { computed, useAttrs } from 'vue'
+
+import {
+ useAppButtonUI,
+ type AppButtonColor,
+ type AppButtonShape,
+ type AppButtonSize,
+ type AppButtonVariant
+} from '@/theme/button'
+
+const {
+ color = 'neutral',
+ variant = 'ghost',
+ size = 'sm',
+ shape = 'rounded',
+ disabled = false,
+ loading = false,
+ type = 'button',
+ ui
+} = defineProps<{
+ color?: AppButtonColor
+ variant?: AppButtonVariant
+ size?: AppButtonSize
+ shape?: AppButtonShape
+ disabled?: boolean
+ loading?: boolean
+ type?: 'button' | 'submit' | 'reset'
+ ui?: { base?: string; icon?: string }
+}>()
+
+defineOptions({ inheritAttrs: false })
+const attrs = useAttrs()
+const styles = computed(() => useAppButtonUI({ color, variant, size, shape, ui }))
+const isDisabled = computed(() => disabled || loading)
+</script>
+
+<template>
+ <button
+ v-bind="attrs"
+ data-slot="button"
+ :type="type"
+ :disabled="isDisabled"
+ :aria-disabled="isDisabled ? 'true' : undefined"
+ :aria-busy="loading ? 'true' : undefined"
+ :class="styles.base"
+ >
+ <span v-if="loading" data-slot="loading-icon" :class="styles.icon">
+ <icon-lucide-loader-2 class="animate-spin" />
+ </span>
+ <span v-else-if="$slots.leading" data-slot="leading-icon" :class="styles.icon">
+ <slot name="leading" />
+ </span>
+ <slot />
+ <span v-if="$slots.trailing" data-slot="trailing-icon" :class="styles.icon">
+ <slot name="trailing" />
+ </span>
+ </button>
+</template>
diff --git a/src/components/ui/AppTextButton.vue b/src/components/ui/AppTextButton.vue
deleted file mode 100644
index ec3b8ba4c..000000000
--- a/src/components/ui/AppTextButton.vue
+++ /dev/null
@@ -1,30 +0,0 @@
-<script setup lang="ts">
-import { computed } from 'vue'
-import { twMerge } from 'tailwind-merge'
-interface AppTextButtonProps {
- ui?: {
- base?: string
- }
- size?: 'xs' | 'sm'
- underline?: boolean
-}
-
-const { ui, size = 'sm', underline = false } = defineProps<AppTextButtonProps>()
-
-const emit = defineEmits<{ click: [event: MouseEvent] }>()
-
-const cls = computed(() =>
- twMerge(
- 'cursor-pointer text-muted hover:text-surface',
- size === 'xs' ? 'text-[9px]' : 'text-[10px]',
- underline && 'underline',
- ui?.base
- )
-)
-</script>
-
-<template>
- <button type="button" :class="cls" @click="emit('click', $event)">
- <slot />
- </button>
-</template>
diff --git a/src/components/ui/dialog/AppConfirmationDialog.vue b/src/components/ui/dialog/AppConfirmationDialog.vue
new file mode 100644
index 000000000..1c239638e
--- /dev/null
+++ b/src/components/ui/dialog/AppConfirmationDialog.vue
@@ -0,0 +1,68 @@
+<script setup lang="ts">
+import {
+ AlertDialogAction,
+ AlertDialogCancel,
+ AlertDialogDescription,
+ AlertDialogTitle
+} from 'reka-ui'
+import { computed } from 'vue'
+
+import AppButton from '@/components/ui/AppButton.vue'
+import AppDialogBody from './AppDialogBody.vue'
+import AppDialogFooter from './AppDialogFooter.vue'
+import AppAlertDialogRoot from './AppAlertDialogRoot.vue'
+
+const {
+ heading,
+ description,
+ cancelLabel,
+ confirmLabel,
+ tone = 'primary',
+ confirmDisabled = false,
+ confirmLoading = false
+} = defineProps<{
+ heading: string
+ description?: string
+ cancelLabel: string
+ confirmLabel: string
+ tone?: 'neutral' | 'primary' | 'warning' | 'danger'
+ confirmDisabled?: boolean
+ confirmLoading?: boolean
+}>()
+
+const emit = defineEmits<{ confirm: []; cancel: [] }>()
+const open = defineModel<boolean>('open', { default: false })
+const confirmColor = computed(() => {
+ if (tone === 'danger') return 'error'
+ if (tone === 'neutral') return 'neutral'
+ return 'primary'
+})
+</script>
+
+<template>
+ <AppAlertDialogRoot v-model:open="open">
+ <div class="border-b border-border px-4 py-3">
+ <AlertDialogTitle class="text-sm font-semibold text-surface">{{ heading }}</AlertDialogTitle>
+ </div>
+ <AppDialogBody v-if="description">
+ <AlertDialogDescription class="text-xs text-muted">{{ description }}</AlertDialogDescription>
+ </AppDialogBody>
+ <AppDialogFooter>
+ <AlertDialogCancel as-child>
+ <AppButton color="neutral" variant="ghost" @click="emit('cancel')">{{
+ cancelLabel
+ }}</AppButton>
+ </AlertDialogCancel>
+ <AlertDialogAction as-child>
+ <AppButton
+ :color="confirmColor"
+ variant="solid"
+ :disabled="confirmDisabled"
+ :loading="confirmLoading"
+ @click="emit('confirm')"
+ >{{ confirmLabel }}</AppButton
+ >
+ </AlertDialogAction>
+ </AppDialogFooter>
+ </AppAlertDialogRoot>
+</template>
diff --git a/src/components/ui/dialog/AppDialog.vue b/src/components/ui/dialog/AppDialog.vue
new file mode 100644
index 000000000..183a58da0
--- /dev/null
+++ b/src/components/ui/dialog/AppDialog.vue
@@ -0,0 +1,56 @@
+<script setup lang="ts">
+import { computed, useAttrs, useSlots } from 'vue'
+
+import AppDialogBody from './AppDialogBody.vue'
+import AppDialogFooter from './AppDialogFooter.vue'
+import AppDialogHeader from './AppDialogHeader.vue'
+import AppDialogRoot from './AppDialogRoot.vue'
+import type { DialogUI, DialogVariants } from './ui'
+
+const {
+ heading,
+ description,
+ closeLabel,
+ showClose = true,
+ size = 'md',
+ height = 'auto',
+ ui
+} = defineProps<{
+ heading?: string
+ description?: string
+ closeLabel?: string
+ showClose?: boolean
+ size?: DialogVariants['size']
+ height?: DialogVariants['height']
+ ui?: DialogUI
+}>()
+
+defineOptions({ inheritAttrs: false })
+const attrs = useAttrs()
+const open = defineModel<boolean>('open', { default: false })
+const slots = useSlots()
+const hasHeader = computed(() =>
+ Boolean(heading || description || slots.header || slots.title || slots.description)
+)
+</script>
+
+<template>
+ <AppDialogRoot v-bind="attrs" v-model:open="open" :size="size" :height="height" :ui="ui">
+ <slot v-if="slots.header" name="header" />
+ <AppDialogHeader
+ v-else-if="hasHeader"
+ :heading="heading ?? ''"
+ :description="description"
+ :close-label="closeLabel"
+ :show-close="showClose"
+ :ui="ui"
+ >
+ <template #title><slot name="title" /></template>
+ <template #description><slot name="description" /></template>
+ <template #actions><slot name="header-actions" /></template>
+ <template #close-icon><slot name="close-icon" /></template>
+ </AppDialogHeader>
+ <AppDialogBody v-if="$slots.default" :ui="ui"><slot /></AppDialogBody>
+ <AppDialogFooter v-if="$slots.footer" :ui="ui"><slot name="footer" /></AppDialogFooter>
+ </AppDialogRoot>
+</template>
diff --git a/src/components/ui/dialog/Dialog.stories.ts b/src/components/ui/dialog/Dialog.stories.ts
index 4955398bb..95e5861cb 100644
--- a/src/components/ui/dialog/Dialog.stories.ts
+++ b/src/components/ui/dialog/Dialog.stories.ts
@@ -1,8 +1,11 @@
import type { Meta, StoryObj } from '@storybook/vue3-vite'
-import { DialogClose } from 'reka-ui'
import { expect, userEvent, within } from 'storybook/test'
import { ref } from 'vue'
+import AppButton from '@/components/ui/AppButton.vue'
+
+import AppConfirmationDialog from './AppConfirmationDialog.vue'
+import AppDialog from './AppDialog.vue'
import AppDialogBody from './AppDialogBody.vue'
import AppDialogFooter from './AppDialogFooter.vue'
import AppDialogHeader from './AppDialogHeader.vue'
@@ -19,33 +22,17 @@ type Story = StoryObj<typeof meta>
export const Standard: Story = {
render: () => ({
- components: {
- AppDialogBody,
- AppDialogFooter,
- AppDialogHeader,
- AppDialogRoot,
- DialogClose
- },
+ components: { AppDialogBody, AppDialogFooter, AppDialogHeader, AppDialogRoot, AppButton },
setup() {
const open = ref(false)
return { open }
},
template: `
- <button type="button" @click="open = true">Open dialog</button>
+ <AppButton @click="open = true">Open dialog</AppButton>
<AppDialogRoot v-model:open="open" size="sm">
- <AppDialogHeader
- heading="Integration settings"
- description="Configure a reusable provider."
- close-label="Close"
- />
- <AppDialogBody>
- <p class="text-xs text-surface">Dialog bodies scroll independently of their header and footer.</p>
- </AppDialogBody>
- <AppDialogFooter>
- <DialogClose as-child>
- <button type="button" class="rounded bg-accent px-3 py-1.5 text-xs text-white">Done</button>
- </DialogClose>
- </AppDialogFooter>
+ <AppDialogHeader heading="Integration settings" description="Configure a reusable provider." close-label="Close" />
+ <AppDialogBody><p class="text-xs text-surface">Dialog content.</p></AppDialogBody>
+ <AppDialogFooter><AppButton color="primary" @click="open = false">Done</AppButton></AppDialogFooter>
</AppDialogRoot>
`
}),
@@ -58,3 +45,45 @@ export const Standard: Story = {
await expect(body.queryByRole('dialog')).not.toBeInTheDocument()
}
}
+
+export const Confirmation: Story = {
+ render: () => ({
+ components: { AppButton, AppConfirmationDialog },
+ setup() {
+ const open = ref(false)
+ return { open }
+ },
+ template: `
+ <AppButton color="error" @click="open = true">Clear diagnostics</AppButton>
+ <AppConfirmationDialog v-model:open="open" heading="Clear diagnostics" description="Remove local diagnostics from this device?" cancel-label="Cancel" confirm-label="Clear" tone="danger" />
+ `
+ }),
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement)
+ await userEvent.click(canvas.getByRole('button', { name: 'Clear diagnostics' }))
+ const body = within(document.body)
+ await expect(body.getByRole('alertdialog')).toBeVisible()
+ await userEvent.click(body.getByRole('button', { name: 'Cancel' }))
+ await expect(body.queryByRole('alertdialog')).not.toBeInTheDocument()
+ }
+}
+
+export const SemanticWrapper: Story = {
+ render: () => ({
+ components: { AppButton, AppDialog },
+ setup() {
+ const open = ref(false)
+ return { open }
+ },
+ template: `
+ <AppButton @click="open = true">Open semantic dialog</AppButton>
+ <AppDialog v-model:open="open">
+ <template #header>
+ <AppDialogHeader heading="Semantic dialog" description="Composed with the shared wrapper." close-label="Close" />
+ </template>
+ <p class="text-xs text-surface">Content slot.</p>
+ <template #footer><AppButton color="primary" @click="open = false">Done</AppButton></template>
+ </AppDialog>
+ `
+ })
+}
diff --git a/src/components/ui/dialog/index.ts b/src/components/ui/dialog/index.ts
index 110de28fb..1ba07b2a8 100644
--- a/src/components/ui/dialog/index.ts
+++ b/src/components/ui/dialog/index.ts
@@ -1,6 +1,7 @@
export { default as AppAlertDialogRoot } from './AppAlertDialogRoot.vue'
+export { default as AppConfirmationDialog } from './AppConfirmationDialog.vue'
+export { default as AppDialog } from './AppDialog.vue'
export { default as AppDialogBody } from './AppDialogBody.vue'
-export { default as AppDialogClose } from './AppDialogClose.vue'
export { default as AppDialogFooter } from './AppDialogFooter.vue'
export { default as AppDialogHeader } from './AppDialogHeader.vue'
export { default as AppDialogRoot } from './AppDialogRoot.vue'
diff --git a/src/theme/button.ts b/src/theme/button.ts
new file mode 100644
index 000000000..3e87c7d70
--- /dev/null
+++ b/src/theme/button.ts
@@ -0,0 +1,126 @@
+import { tv } from 'tailwind-variants'
+
+const appButton = tv({
+ slots: {
+ base: [
+ 'inline-flex items-center justify-center gap-1.5 font-medium select-none transition-colors',
+ 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-accent/50',
+ 'disabled:cursor-not-allowed disabled:opacity-50'
+ ],
+ icon: 'size-3.5 shrink-0'
+ },
+ variants: {
+ color: {
+ neutral: {},
+ primary: {},
+ error: {}
+ },
+ variant: {
+ solid: {},
+ outline: {},
+ soft: {},
+ subtle: {},
+ ghost: {},
+ link: {}
+ },
+ size: {
+ xs: { base: 'h-6 px-1.5 text-[10px]', icon: 'size-3' },
+ sm: { base: 'h-7 px-2 text-xs' },
+ md: { base: 'h-8 px-3 text-xs' },
+ lg: { base: 'h-9 px-3.5 text-sm' }
+ },
+ shape: {
+ square: { base: 'rounded' },
+ rounded: { base: 'rounded-md' },
+ pill: { base: 'rounded-full' }
+ }
+ },
+ compoundVariants: [
+ {
+ color: 'neutral',
+ variant: 'solid',
+ class: { base: 'bg-surface text-panel hover:bg-surface/90' }
+ },
+ {
+ color: 'neutral',
+ variant: 'outline',
+ class: { base: 'border border-border text-surface hover:bg-hover' }
+ },
+ {
+ color: 'neutral',
+ variant: 'soft',
+ class: { base: 'bg-hover text-surface hover:bg-hover/80' }
+ },
+ {
+ color: 'neutral',
+ variant: 'subtle',
+ class: { base: 'border border-border/60 text-muted hover:bg-hover hover:text-surface' }
+ },
+ {
+ color: 'neutral',
+ variant: 'ghost',
+ class: { base: 'text-muted hover:bg-hover hover:text-surface' }
+ },
+ {
+ color: 'neutral',
+ variant: 'link',
+ class: { base: 'text-muted hover:text-surface hover:underline' }
+ },
+ {
+ color: 'primary',
+ variant: 'solid',
+ class: { base: 'bg-accent text-white hover:bg-accent/90' }
+ },
+ {
+ color: 'primary',
+ variant: 'outline',
+ class: { base: 'border border-accent/50 text-accent hover:bg-accent/10' }
+ },
+ {
+ color: 'primary',
+ variant: 'soft',
+ class: { base: 'bg-accent/15 text-accent hover:bg-accent/20' }
+ },
+ { color: 'primary', variant: 'subtle', class: { base: 'text-accent hover:bg-accent/10' } },
+ { color: 'primary', variant: 'ghost', class: { base: 'text-accent hover:bg-accent/10' } },
+ { color: 'primary', variant: 'link', class: { base: 'text-accent hover:underline' } },
+ {
+ color: 'error',
+ variant: 'solid',
+ class: { base: 'bg-red-500 text-white hover:bg-red-500/90' }
+ },
+ {
+ color: 'error',
+ variant: 'outline',
+ class: { base: 'border border-red-400/50 text-red-400 hover:bg-red-500/10' }
+ },
+ {
+ color: 'error',
+ variant: 'soft',
+ class: { base: 'bg-red-500/15 text-red-400 hover:bg-red-500/20' }
+ },
+ { color: 'error', variant: 'subtle', class: { base: 'text-red-400 hover:bg-red-500/10' } },
+ { color: 'error', variant: 'ghost', class: { base: 'text-red-400 hover:bg-red-500/10' } },
+ { color: 'error', variant: 'link', class: { base: 'text-red-400 hover:underline' } }
+ ],
+ defaultVariants: { color: 'neutral', variant: 'ghost', size: 'sm', shape: 'rounded' }
+})
+
+export type AppButtonColor = 'neutral' | 'primary' | 'error'
+export type AppButtonVariant = 'solid' | 'outline' | 'soft' | 'subtle' | 'ghost' | 'link'
+export type AppButtonSize = 'xs' | 'sm' | 'md' | 'lg'
+export type AppButtonShape = 'square' | 'rounded' | 'pill'
+
+export function useAppButtonUI(options?: {
+ color?: AppButtonColor
+ variant?: AppButtonVariant
+ size?: AppButtonSize
+ shape?: AppButtonShape
+ ui?: { base?: string; icon?: string }
+}) {
+ const styles = appButton(options)
+ return {
+ base: styles.base({ class: options?.ui?.base }),
+ icon: styles.icon({ class: options?.ui?.icon })
+ }
+}
diff --git a/tests/engine/app/diagnostics/events.test.ts b/tests/engine/app/diagnostics/events.test.ts
new file mode 100644
index 000000000..b921cd997
--- /dev/null
+++ b/tests/engine/app/diagnostics/events.test.ts
@@ -0,0 +1,37 @@
+import { describe, expect, test } from 'bun:test'
+
+import { describeDiagnosticError } from '@/app/diagnostics'
+import { storageOperationForJob } from '@/app/diagnostics/events'
+
+describe('diagnostic error metadata', () => {
+ test('keeps only safe error metadata', () => {
+ const error = Object.assign(new Error('secret message'), { code: 'E_NETWORK', status: 500 })
+ expect(describeDiagnosticError(error)).toEqual({
+ errorName: 'Error',
+ errorCode: 'E_NETWORK',
+ retryable: true
+ })
+ })
+
+ test('classifies aborts as non-retryable', () => {
+ expect(describeDiagnosticError(new DOMException('cancelled', 'AbortError')).retryable).toBe(
+ false
+ )
+ })
+
+ test('handles unknown thrown values', () => {
+ expect(describeDiagnosticError('failure')).toEqual({
+ errorName: 'UnknownError',
+ errorCode: null,
+ retryable: null
+ })
+ })
+})
+
+describe('storageOperationForJob', () => {
+ test('maps every outbox operation explicitly', () => {
+ expect(storageOperationForJob('putCanvas')).toBe('upload')
+ expect(storageOperationForJob('putThumb')).toBe('upload')
+ expect(storageOperationForJob('deleteCanvas')).toBe('delete')
+ })
+})
diff --git a/tests/engine/app/diagnostics/recorder.test.ts b/tests/engine/app/diagnostics/recorder.test.ts
new file mode 100644
index 000000000..3c1b8db09
--- /dev/null
+++ b/tests/engine/app/diagnostics/recorder.test.ts
@@ -0,0 +1,27 @@
+import { beforeEach, describe, expect, test } from 'bun:test'
+
+import { diagnostics, recordChatCompleted } from '@/app/diagnostics'
+import { isDiagnosticsEnabled } from '@/app/diagnostics/settings'
+
+void isDiagnosticsEnabled
+
+describe('diagnostics recorder', () => {
+ beforeEach(async () => {
+ await diagnostics.clear()
+ })
+
+ test('records structured events and exports them', async () => {
+ recordChatCompleted({ finishReason: 'stop' })
+
+ const events = await diagnostics.list()
+ expect(events).toHaveLength(1)
+ expect(events[0]?.name).toBe('chat.completed')
+ expect(await diagnostics.export()).toContain('chat.completed')
+ })
+
+ test('clears recorded events', async () => {
+ recordChatCompleted({ finishReason: 'stop' })
+ await diagnostics.clear()
+ expect(await diagnostics.list()).toHaveLength(0)
+ })
+})
diff --git a/tests/engine/app/diagnostics/subscriptions.test.ts b/tests/engine/app/diagnostics/subscriptions.test.ts
new file mode 100644
index 000000000..88d74df12
--- /dev/null
+++ b/tests/engine/app/diagnostics/subscriptions.test.ts
@@ -0,0 +1,22 @@
+import { describe, expect, test } from 'bun:test'
+
+import { diagnostics, recordChatCompleted } from '@/app/diagnostics'
+
+describe('diagnostic subscriptions', () => {
+ test('notifies on record and clear, then unsubscribes', async () => {
+ await diagnostics.clear()
+ let calls = 0
+ const unsubscribe = diagnostics.subscribe(() => {
+ calls++
+ })
+
+ recordChatCompleted({ finishReason: 'stop' })
+ await diagnostics.clear()
+ expect(calls).toBe(2)
+
+ unsubscribe()
+ recordChatCompleted({ finishReason: 'stop' })
+ expect(calls).toBe(2)
+ await diagnostics.clear()
+ })
+})
diff --git a/tests/engine/app/diagnostics/transport.test.ts b/tests/engine/app/diagnostics/transport.test.ts
new file mode 100644
index 000000000..58c0746e8
--- /dev/null
+++ b/tests/engine/app/diagnostics/transport.test.ts
@@ -0,0 +1,38 @@
+import { describe, expect, test } from 'bun:test'
+
+import {
+ diagnostics,
+ recordACPTransportFailure,
+ recordMCPConnectionFailure
+} from '@/app/diagnostics'
+
+describe('transport diagnostic events', () => {
+ test('records safe ACP failures', async () => {
+ await diagnostics.clear()
+ recordACPTransportFailure({
+ operation: 'message',
+ errorName: 'NetworkError',
+ errorCode: null,
+ retryable: true
+ })
+ const [event] = await diagnostics.list()
+ expect(event?.name).toBe('acp.transport.failed')
+ expect(event?.attributes).toEqual({
+ operation: 'message',
+ errorName: 'NetworkError',
+ errorCode: null,
+ retryable: true
+ })
+ })
+
+ test('rejects invalid MCP operations', async () => {
+ await diagnostics.clear()
+ recordMCPConnectionFailure({
+ operation: 'invalid' as 'connect',
+ errorName: 'Error',
+ errorCode: null,
+ retryable: null
+ })
+ expect(await diagnostics.list()).toHaveLength(0)
+ })
+})
diff --git a/tests/engine/app/usage/summarize.test.ts b/tests/engine/app/usage/summarize.test.ts
new file mode 100644
index 000000000..2f8efe0e3
--- /dev/null
+++ b/tests/engine/app/usage/summarize.test.ts
@@ -0,0 +1,44 @@
+import { describe, expect, test } from 'bun:test'
+
+import type { DiagnosticEvent } from '@/app/diagnostics'
+import { summarizeUsage } from '@/app/usage'
+
+function event(name: string, attributes: DiagnosticEvent['attributes']): DiagnosticEvent {
+ return { id: crypto.randomUUID(), timestamp: 0, category: 'ai', level: 'info', name, attributes }
+}
+
+describe('summarizeUsage', () => {
+ test('aggregates reported usage and model counts', () => {
+ const summary = summarizeUsage([
+ event('model.step.completed', {
+ provider: 'openai',
+ model: 'gpt-4o',
+ inputTokens: 100,
+ outputTokens: 20,
+ cacheReadTokens: 30,
+ cacheWriteTokens: 0
+ }),
+ event('chat.completed', { finishReason: 'stop' })
+ ])
+ expect(summary.requests).toBe(1)
+ expect(summary.inputTokens).toBe(100)
+ expect(summary.outputTokens).toBe(20)
+ expect(summary.cacheReadTokens).toBe(30)
+ expect(summary.models).toEqual([{ provider: 'openai', model: 'gpt-4o', requests: 1 }])
+ })
+
+ test('preserves unavailable telemetry as null', () => {
+ const summary = summarizeUsage([
+ event('model.step.completed', {
+ provider: 'openai',
+ model: 'compatible',
+ inputTokens: 10,
+ outputTokens: 2,
+ cacheReadTokens: null,
+ cacheWriteTokens: null
+ })
+ ])
+ expect(summary.cacheReadTokens).toBeNull()
+ expect(summary.unavailableCacheTelemetry).toBe(1)
+ })
+})