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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.jsonindex 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.tsindex 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.tsindex 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): strinreturn 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 } = processconst 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.tsindex 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?: FinishReasonisAbort: boolean+ isDisconnect: booleanisError: 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.tsindex 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 = 240const 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 = 0let totalOutput = 0let totalCacheRead = 0let 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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 = falsediff --git a/src/app/document/io/read.ts b/src/app/document/io/read.tsindex 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.tsindex 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.tsindex 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.tsindex 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: stringheaders?: 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.tsindex 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.tsindex 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.tsindex 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 = 1const 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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 constdiff --git a/src/app/storage/idb/index.ts b/src/app/storage/idb/index.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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 = 1const 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.vueindex 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>+ <AppButtonv-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><ChatInputdiff --git a/src/components/CodePanel.vue b/src/components/CodePanel.vueindex 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+ <AppButtonv-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.vueindex 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/coimport 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_IDSconst popoverOpen = ref(false)@@ -79,7 +73,7 @@ onMounted(() => {<PopoverTriggerdata-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+ <AppButtontype="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+ <AppButtontype="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+ <AppButtontype="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+ <AppButtontype="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>+ <AppButtontype="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><pdiff --git a/src/components/assets-panel/AssetsPanel.vue b/src/components/assets-panel/AssetsPanel.vueindex 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><SegmentedControlv-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.vueindex 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, restoreRecoverySnapshotimport 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.vueindex 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>+<buttontype="button":class="navigationClass"@@ -123,6 +146,10 @@ const navigationClass =<ModelsPanel /></section>+ <UsageSettingsPanel v-else-if="settingsDialogSection === 'usage'" />++ <DiagnosticsSettingsPanel v-else-if="settingsDialogSection === 'diagnostics'" />+<sectionv-else-if="settingsDialogSection === 'mcp'"class="flex flex-col"diff --git a/src/components/settings/diagnostics/DiagnosticsSettingsPanel.vue b/src/components/settings/diagnostics/DiagnosticsSettingsPanel.vuenew file mode 100644index 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.vueindex 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.vueindex 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/ProviderSetimport 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.vueindex 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.vueindex 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.vuenew file mode 100644index 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.tsnew file mode 100644index 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.vuenew file mode 100644index 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.vuedeleted file mode 100644index 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.vuenew file mode 100644index 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.vuenew file mode 100644index 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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)+ })+})