@project-ava-supernova/core 0.2.71

package/dist/history/storage.js

@@ -0,0 +1,133 @@
+import { readFile, writeFile, rename, readdir, mkdir, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { HISTORY_DIR } from '../core/constants.js';
+import { deriveConversationTitle, isJunkTitle, deriveConversationSurface } from './conversation-title.js';
+/** Default max conversations to keep before pruning oldest. */
+const MAX_HISTORY = 100;
+export class HistoryStorage {
+    /**
+     * Directory holding the `{id}.json` transcripts. Defaults to the global
+     * `~/.ava/history` (CLI, anonymous local). The extension passes an
+     * account-scoped dir (`~/.ava/users/<id>/history`) so signed-in users'
+     * conversations are isolated AND land where the scoped export reads them.
+     */
+    dir;
+    constructor(historyDir = HISTORY_DIR) {
+        this.dir = historyDir;
+    }
+    async init() {
+        await mkdir(this.dir, { recursive: true });
+        // Clean up orphaned temp files from interrupted writes
+        try {
+            const files = await readdir(this.dir);
+            for (const file of files) {
+                if (file.endsWith('.tmp')) {
+                    await unlink(join(this.dir, file)).catch(() => { });
+                }
+            }
+        }
+        catch { /* directory might not exist yet */ }
+    }
+    async save(record) {
+        const path = join(this.dir, `${record.id}.json`);
+        const tmpPath = join(this.dir, `.${record.id}.tmp`);
+        const data = JSON.stringify(record, null, 2);
+        // Atomic write with lock — prevents concurrent corruption
+        const { withLock } = await import('../core/file-lock.js');
+        await withLock(path, async () => {
+            await writeFile(tmpPath, data, 'utf-8');
+            try {
+                await rename(tmpPath, path);
+            }
+            catch (err) {
+                await unlink(tmpPath).catch(() => { });
+                throw err;
+            }
+        });
+    }
+    /** Validate that parsed JSON has the required ConversationRecord shape. */
+    isValidRecord(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            typeof value.id === 'string' &&
+            Array.isArray(value.messages));
+    }
+    async load(id) {
+        const path = join(this.dir, `${id}.json`);
+        try {
+            const raw = await readFile(path, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (!this.isValidRecord(parsed))
+                return null;
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    async list() {
+        await this.init();
+        const files = await readdir(this.dir);
+        const summaries = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const raw = await readFile(join(this.dir, file), 'utf-8');
+                const record = JSON.parse(raw);
+                if (!this.isValidRecord(record))
+                    continue;
+                summaries.push({
+                    id: record.id,
+                    // Repair junk titles on READ. Records written before the title
+                    // derivation was fixed are named after host machinery — a mode/room
+                    // preamble or an internal primer — and a conversation you never reopen
+                    // would keep that name forever. We already have the full record parsed
+                    // here, so re-deriving costs nothing. A genuine title (including a
+                    // manual rename) is left exactly as it is.
+                    title: isJunkTitle(record.title)
+                        ? deriveConversationTitle(record.messages)
+                        : record.title,
+                    updatedAt: record.updatedAt,
+                    pinned: record.pinned,
+                    projectPath: record.projectPath,
+                    // Which room this came from. Derived from the scaffold tag already in
+                    // the transcript, so it needs no schema change and works on every
+                    // conversation ever saved — the record itself is untouched.
+                    surface: deriveConversationSurface(record.messages),
+                });
+            }
+            catch {
+                // skip corrupt files
+            }
+        }
+        return summaries.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+    async delete(id) {
+        const path = join(this.dir, `${id}.json`);
+        try {
+            await unlink(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Remove oldest unpinned conversations when count exceeds maxHistory. */
+    async prune(maxHistory = MAX_HISTORY) {
+        const all = await this.list();
+        // Never prune pinned conversations
+        const unpinned = all.filter((entry) => !entry.pinned);
+        if (unpinned.length <= maxHistory)
+            return 0;
+        // list() is sorted newest-first, so slice from maxHistory onwards
+        const toDelete = unpinned.slice(maxHistory);
+        let deleted = 0;
+        for (const entry of toDelete) {
+            if (await this.delete(entry.id))
+                deleted++;
+        }
+        return deleted;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/history/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/history/storage.ts"],"names":[],"mappings":"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"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Set the active locale and auto-load its translation strings.
+ * Falls back to 'en' if the locale is unsupported.
+ */
+export declare function setLocale(locale: string): Promise<void>;
+/**
+ * Set the active locale synchronously (without loading translations).
+ * Use when translations have already been loaded via loadLocaleStrings().
+ */
+export declare function setLocaleSync(locale: string): void;
+/**
+ * Register a set of translated strings for a locale.
+ * Call this before `setLocale()` for non-English locales.
+ */
+export declare function loadLocaleStrings(locale: string, strings: Record<string, string>): void;
+/** Get the current active locale code. */
+export declare function getLocale(): string;
+/** Get the list of supported locale codes. */
+export declare function getSupportedLocales(): readonly string[];
+/** Get the native language name for a locale code. */
+export declare function getLanguageName(locale: string): string;
+/**
+ * Detect language from common greetings/phrases in user input.
+ * Returns the native language name or null if no match.
+ */
+export declare function detectLanguageFromGreeting(input: string): string | null;
+/**
+ * Translate a key with optional interpolation.
+ *
+ * @example
+ * t('error.msg.auth', { provider: 'DeepSeek' })
+ * // → "Invalid API key for DeepSeek. Check your key in ~/.ava/config.json"
+ */
+export declare function t(key: string, params?: Record<string, string | number>): string;
+/**
+ * Resolve a locale string to a supported locale code.
+ * Handles 'auto' detection, partial matches (e.g. 'zh' → 'zh-CN'),
+ * and falls back to 'en'.
+ */
+export declare function resolveLocale(locale: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEvF;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAiDD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvE;AAED;;;;;;GAMG;AACH,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAS/E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBpD"}

package/dist/i18n/index.js

@@ -0,0 +1,188 @@
+import { SUPPORTED_LOCALES, LANGUAGE_NAMES } from './types.js';
+import { enStrings } from './locales/en.js';
+let currentLocale = 'en';
+const translations = {
+    en: enStrings,
+};
+/**
+ * Set the active locale and auto-load its translation strings.
+ * Falls back to 'en' if the locale is unsupported.
+ */
+export async function setLocale(locale) {
+    const resolved = resolveLocale(locale);
+    currentLocale = resolved;
+    // Auto-load translation strings if not already loaded
+    if (resolved !== 'en' && !translations[resolved]) {
+        try {
+            const mod = await import(`./locales/${resolved}.js`);
+            // Convention: export name is `{camelCase}Strings`
+            const exportName = Object.keys(mod).find((k) => k.endsWith('Strings'));
+            if (exportName && mod[exportName]) {
+                translations[resolved] = mod[exportName];
+            }
+        }
+        catch {
+            // Locale file not found — will fall back to English
+        }
+    }
+}
+/**
+ * Set the active locale synchronously (without loading translations).
+ * Use when translations have already been loaded via loadLocaleStrings().
+ */
+export function setLocaleSync(locale) {
+    currentLocale = resolveLocale(locale);
+}
+/**
+ * Register a set of translated strings for a locale.
+ * Call this before `setLocale()` for non-English locales.
+ */
+export function loadLocaleStrings(locale, strings) {
+    translations[resolveLocale(locale)] = strings;
+}
+/** Get the current active locale code. */
+export function getLocale() {
+    return currentLocale;
+}
+/** Get the list of supported locale codes. */
+export function getSupportedLocales() {
+    return SUPPORTED_LOCALES;
+}
+/** Get the native language name for a locale code. */
+export function getLanguageName(locale) {
+    return LANGUAGE_NAMES[locale] ?? locale;
+}
+/**
+ * Common greetings/phrases mapped to language names.
+ * Used for auto-detection when the user writes in another language.
+ */
+const GREETING_MAP = {
+    // Chinese (Simplified)
+    '你好': '中文（简体）', '您好': '中文（简体）', '早上好': '中文（简体）', '晚上好': '中文（简体）',
+    // Chinese (Traditional)
+    '早安': '中文（繁體）',
+    // Japanese
+    'こんにちは': '日本語', 'おはよう': '日本語', 'こんばんは': '日本語', 'おはようございます': '日本語',
+    // Korean
+    '안녕하세요': '한국어', '안녕': '한국어',
+    // Spanish
+    'hola': 'Español', 'buenos días': 'Español', 'buenas tardes': 'Español', 'buenas noches': 'Español',
+    // Portuguese
+    'olá': 'Português', 'oi': 'Português', 'bom dia': 'Português', 'boa tarde': 'Português', 'boa noite': 'Português',
+    // French
+    'bonjour': 'Français', 'bonsoir': 'Français', 'salut': 'Français',
+    // German
+    'hallo': 'Deutsch', 'guten morgen': 'Deutsch', 'guten tag': 'Deutsch', 'guten abend': 'Deutsch',
+    // Russian
+    'привет': 'Русский', 'здравствуйте': 'Русский', 'добрый день': 'Русский',
+    // Arabic
+    'مرحبا': 'العربية', 'السلام عليكم': 'العربية', 'أهلا': 'العربية',
+    // Hindi
+    'नमस्ते': 'हिन्दी', 'नमस्कार': 'हिन्दी',
+    // Nepali (responds in Hindi — closest supported)
+    'namaste': 'हिन्दी',
+    // Vietnamese
+    'xin chào': 'Tiếng Việt', 'chào': 'Tiếng Việt',
+    // Thai
+    'สวัสดี': 'ไทย', 'สวัสดีครับ': 'ไทย', 'สวัสดีค่ะ': 'ไทย',
+    // Turkish
+    'merhaba': 'Türkçe', 'selam': 'Türkçe', 'günaydın': 'Türkçe',
+    // Italian
+    'ciao': 'Italiano', 'buongiorno': 'Italiano', 'buonasera': 'Italiano',
+    // Polish
+    'cześć': 'Polski', 'dzień dobry': 'Polski',
+    // Ukrainian
+    'привіт': 'Українська', 'добрий день': 'Українська',
+    // Dutch
+    'hoi': 'Nederlands', 'goedemorgen': 'Nederlands', 'goedendag': 'Nederlands',
+    // Indonesian
+    'halo': 'Bahasa Indonesia', 'selamat pagi': 'Bahasa Indonesia', 'selamat siang': 'Bahasa Indonesia',
+};
+/**
+ * Detect language from common greetings/phrases in user input.
+ * Returns the native language name or null if no match.
+ */
+export function detectLanguageFromGreeting(input) {
+    const trimmed = input.trim().toLowerCase();
+    // Check exact match first, then check if input starts with a greeting
+    for (const [greeting, lang] of Object.entries(GREETING_MAP)) {
+        if (trimmed === greeting.toLowerCase() || trimmed.startsWith(greeting.toLowerCase() + ' ')) {
+            return lang;
+        }
+    }
+    return null;
+}
+/**
+ * Translate a key with optional interpolation.
+ *
+ * @example
+ * t('error.msg.auth', { provider: 'DeepSeek' })
+ * // → "Invalid API key for DeepSeek. Check your key in ~/.ava/config.json"
+ */
+export function t(key, params) {
+    const str = translations[currentLocale]?.[key]
+        ?? translations['en']?.[key]
+        ?? key;
+    if (!params)
+        return str;
+    return str.replace(/\{(\w+)\}/g, (_, k) => {
+        const val = params[k];
+        return val !== undefined ? String(val) : `{${k}}`;
+    });
+}
+/**
+ * Resolve a locale string to a supported locale code.
+ * Handles 'auto' detection, partial matches (e.g. 'zh' → 'zh-CN'),
+ * and falls back to 'en'.
+ */
+export function resolveLocale(locale) {
+    if (!locale || locale === 'auto') {
+        return detectSystemLocale();
+    }
+    // Exact match
+    if (SUPPORTED_LOCALES.includes(locale)) {
+        return locale;
+    }
+    // Partial match: 'zh' → 'zh-CN', 'pt-BR' → 'pt'
+    const prefix = locale.split('-')[0].toLowerCase();
+    for (const supported of SUPPORTED_LOCALES) {
+        if (supported.toLowerCase().startsWith(prefix)) {
+            return supported;
+        }
+    }
+    return 'en';
+}
+function detectSystemLocale() {
+    // Node.js environment
+    if (typeof process !== 'undefined' && process.env) {
+        const envLang = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || '';
+        if (envLang) {
+            const code = envLang.split('.')[0].replace('_', '-');
+            return resolveLocaleCode(code);
+        }
+    }
+    // Browser / webview environment
+    if (typeof navigator !== 'undefined' && navigator.language) {
+        return resolveLocaleCode(navigator.language);
+    }
+    return 'en';
+}
+function resolveLocaleCode(code) {
+    if (SUPPORTED_LOCALES.includes(code)) {
+        return code;
+    }
+    const lower = code.toLowerCase();
+    for (const supported of SUPPORTED_LOCALES) {
+        if (supported.toLowerCase() === lower) {
+            return supported;
+        }
+    }
+    const prefix = code.split('-')[0].toLowerCase();
+    for (const supported of SUPPORTED_LOCALES) {
+        if (supported.toLowerCase().startsWith(prefix)) {
+            return supported;
+        }
+    }
+    return 'en';
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"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"}

package/dist/i18n/keep-english.d.ts

@@ -0,0 +1,12 @@
+import type { StringKey } from './locales/en.js';
+/**
+ * Keys whose English value is intentionally preserved across all locales.
+ *
+ * Only add a key here if there is a clear reason the English form is correct
+ * everywhere (brand names, universally-recognised technical tokens, strings
+ * that are purely placeholders). Everything else must be translated.
+ *
+ * Used by `scripts/i18n-check.mjs` to skip English-leak warnings on these keys.
+ */
+export declare const KEEP_ENGLISH: ReadonlySet<StringKey>;
+//# sourceMappingURL=keep-english.d.ts.map

package/dist/i18n/keep-english.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-english.d.ts","sourceRoot":"","sources":["../../src/i18n/keep-english.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,SAAS,CA8V/B,CAAC"}