osagent 0.1.87 → 0.1.89

package/dist/src/i18n/index.js

@@ -0,0 +1,184 @@
+/**
+ * @license
+ * Copyright 2025 OSA
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { homedir } from 'node:os';
+// State
+let currentLanguage = 'en';
+let translations = {};
+const translationCache = {};
+const loadingPromises = {};
+// Path helpers
+const getBuiltinLocalesDir = () => {
+    const __filename = fileURLToPath(import.meta.url);
+    return path.join(path.dirname(__filename), 'locales');
+};
+const getUserLocalesDir = () => path.join(homedir(), '.OSA', 'locales');
+/**
+ * Get the path to the user's custom locales directory.
+ * Users can place custom language packs (e.g., es.js, fr.js) in this directory.
+ * @returns The path to ~/.OSA/locales
+ */
+export function getUserLocalesDirectory() {
+    return getUserLocalesDir();
+}
+const getLocalePath = (lang, useUserDir = false) => {
+    const baseDir = useUserDir ? getUserLocalesDir() : getBuiltinLocalesDir();
+    return path.join(baseDir, `${lang}.js`);
+};
+// Language detection
+export function detectSystemLanguage() {
+    const envLang = process.env['OSA_CODE_LANG'] || process.env['LANG'];
+    if (envLang?.startsWith('zh'))
+        return 'zh';
+    if (envLang?.startsWith('en'))
+        return 'en';
+    try {
+        const locale = Intl.DateTimeFormat().resolvedOptions().locale;
+        if (locale.startsWith('zh'))
+            return 'zh';
+    }
+    catch {
+        // Fallback to default
+    }
+    return 'en';
+}
+// Translation loading
+async function loadTranslationsAsync(lang) {
+    if (translationCache[lang]) {
+        return translationCache[lang];
+    }
+    const existingPromise = loadingPromises[lang];
+    if (existingPromise) {
+        return existingPromise;
+    }
+    const loadPromise = (async () => {
+        // Try user directory first (for custom language packs), then builtin directory
+        const searchDirs = [
+            { dir: getUserLocalesDir(), isUser: true },
+            { dir: getBuiltinLocalesDir(), isUser: false },
+        ];
+        for (const { dir, isUser } of searchDirs) {
+            // Ensure directory exists
+            if (!fs.existsSync(dir)) {
+                continue;
+            }
+            const jsPath = getLocalePath(lang, isUser);
+            if (!fs.existsSync(jsPath)) {
+                continue;
+            }
+            try {
+                // Convert file path to file:// URL for cross-platform compatibility
+                const fileUrl = pathToFileURL(jsPath).href;
+                try {
+                    const module = await import(fileUrl);
+                    const result = module.default || module;
+                    if (result &&
+                        typeof result === 'object' &&
+                        Object.keys(result).length > 0) {
+                        translationCache[lang] = result;
+                        return result;
+                    }
+                    else {
+                        throw new Error('Module loaded but result is empty or invalid');
+                    }
+                }
+                catch {
+                    // For builtin locales, try alternative import method (relative path)
+                    if (!isUser) {
+                        try {
+                            const module = await import(`./locales/${lang}.js`);
+                            const result = module.default || module;
+                            if (result &&
+                                typeof result === 'object' &&
+                                Object.keys(result).length > 0) {
+                                translationCache[lang] = result;
+                                return result;
+                            }
+                        }
+                        catch {
+                            // Continue to next directory
+                        }
+                    }
+                    // If import failed, continue to next directory
+                    continue;
+                }
+            }
+            catch (error) {
+                // Log warning but continue to next directory
+                if (isUser) {
+                    console.warn(`Failed to load translations from user directory for ${lang}:`, error);
+                }
+                else {
+                    console.warn(`Failed to load JS translations for ${lang}:`, error);
+                    if (error instanceof Error) {
+                        console.warn(`Error details: ${error.message}`);
+                        console.warn(`Stack: ${error.stack}`);
+                    }
+                }
+                // Continue to next directory
+                continue;
+            }
+        }
+        // Return empty object if both directories fail
+        // Cache it to avoid repeated failed attempts
+        translationCache[lang] = {};
+        return {};
+    })();
+    loadingPromises[lang] = loadPromise;
+    // Clean up promise after completion to allow retry on next call if needed
+    loadPromise.finally(() => {
+        delete loadingPromises[lang];
+    });
+    return loadPromise;
+}
+function loadTranslations(lang) {
+    // Only return from cache (JS files require async loading)
+    return translationCache[lang] || {};
+}
+// String interpolation
+function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => params[key] ?? match);
+}
+// Language setting helpers
+function resolveLanguage(lang) {
+    return lang === 'auto' ? detectSystemLanguage() : lang;
+}
+// Public API
+export function setLanguage(lang) {
+    const resolvedLang = resolveLanguage(lang);
+    currentLanguage = resolvedLang;
+    // Try to load translations synchronously (from cache only)
+    const loaded = loadTranslations(resolvedLang);
+    translations = loaded;
+    // Warn if translations are empty and JS file exists (requires async loading)
+    if (Object.keys(loaded).length === 0) {
+        const userJsPath = getLocalePath(resolvedLang, true);
+        const builtinJsPath = getLocalePath(resolvedLang, false);
+        if (fs.existsSync(userJsPath) || fs.existsSync(builtinJsPath)) {
+            console.warn(`Language file for ${resolvedLang} requires async loading. ` +
+                `Use setLanguageAsync() instead, or call initializeI18n() first.`);
+        }
+    }
+}
+export async function setLanguageAsync(lang) {
+    currentLanguage = resolveLanguage(lang);
+    translations = await loadTranslationsAsync(currentLanguage);
+}
+export function getCurrentLanguage() {
+    return currentLanguage;
+}
+export function t(key, params) {
+    const translation = translations[key] ?? key;
+    return interpolate(translation, params);
+}
+export async function initializeI18n(lang) {
+    await setLanguageAsync(lang ?? 'auto');
+}
+//# sourceMappingURL=index.js.map

package/dist/src/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,QAAQ;AACR,IAAI,eAAe,GAAsB,IAAI,CAAC;AAC9C,IAAI,YAAY,GAA2B,EAAE,CAAC;AAI9C,MAAM,gBAAgB,GAAoC,EAAE,CAAC;AAC7D,MAAM,eAAe,GAA6C,EAAE,CAAC;AAErE,eAAe;AACf,MAAM,oBAAoB,GAAG,GAAW,EAAE;IACxC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,GAAW,EAAE,CACrC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,aAAa,GAAG,CACpB,IAAuB,EACvB,aAAsB,KAAK,EACnB,EAAE;IACV,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,qBAAqB;AACrB,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;QAC9D,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sBAAsB;AACtB,KAAK,UAAU,qBAAqB,CAClC,IAAuB;IAEvB,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;QAC9B,+EAA+E;QAC/E,MAAM,UAAU,GAAG;YACjB,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1C,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;SAC/C,CAAC;QAEF,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YACzC,0BAA0B;YAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,oEAAoE;gBACpE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;oBACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;oBACxC,IACE,MAAM;wBACN,OAAO,MAAM,KAAK,QAAQ;wBAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAC9B,CAAC;wBACD,gBAAgB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;wBAChC,OAAO,MAAM,CAAC;oBAChB,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,qEAAqE;oBACrE,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,IAAI,CAAC;4BACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC,CAAC;4BACpD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;4BACxC,IACE,MAAM;gCACN,OAAO,MAAM,KAAK,QAAQ;gCAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAC9B,CAAC;gCACD,gBAAgB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;gCAChC,OAAO,MAAM,CAAC;4BAChB,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC;4BACP,6BAA6B;wBAC/B,CAAC;oBACH,CAAC;oBACD,+CAA+C;oBAC/C,SAAS;gBACX,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,6CAA6C;gBAC7C,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CACV,uDAAuD,IAAI,GAAG,EAC9D,KAAK,CACN,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,sCAAsC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;oBACnE,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;wBAC3B,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;wBAChD,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;gBACD,6BAA6B;gBAC7B,SAAS;YACX,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,6CAA6C;QAC7C,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,EAAE,CAAC;IAEL,eAAe,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IAEpC,0EAA0E;IAC1E,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,0DAA0D;IAC1D,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,uBAAuB;AACvB,SAAS,WAAW,CAClB,QAAgB,EAChB,MAA+B;IAE/B,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,OAAO,QAAQ,CAAC,OAAO,CACrB,gBAAgB,EAChB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CACrC,CAAC;AACJ,CAAC;AAED,2BAA2B;AAC3B,SAAS,eAAe,CAAC,IAAgC;IACvD,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,aAAa;AACb,MAAM,UAAU,WAAW,CAAC,IAAgC;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC3C,eAAe,GAAG,YAAY,CAAC;IAE/B,2DAA2D;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC9C,YAAY,GAAG,MAAM,CAAC;IAEtB,6EAA6E;IAC7E,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACzD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CACV,qBAAqB,YAAY,2BAA2B;gBAC1D,iEAAiE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAgC;IAEhC,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACxC,YAAY,GAAG,MAAM,qBAAqB,CAAC,eAAe,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,CAAC,CAAC,GAAW,EAAE,MAA+B;IAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAC7C,OAAO,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAiC;IAEjC,MAAM,gBAAgB,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/{locales → dist/src/i18n/locales}/en.js

@@ -55,10 +55,10 @@ export default {
   'For a full list of shortcuts, see {{docPath}}':
     'For a full list of shortcuts, see {{docPath}}',
   'docs/keyboard-shortcuts.md': 'docs/keyboard-shortcuts.md',
-  'for help on OS Agent': 'for help on OS Agent',
+  'for help on osagent': 'for help on osagent',
   'show version info': 'show version info',
   'submit a bug report': 'submit a bug report',
-  'About OS Agent': 'About OS Agent',
+  'About osagent': 'About osagent',
 
   // ============================================================================
   // System Information Fields
@@ -83,9 +83,9 @@ export default {
   // ============================================================================
   'Analyzes the project and creates a tailored OSAGENT.md file.':
     'Analyzes the project and creates a tailored OSAGENT.md file.',
-  'list available OS Agent tools. Usage: /tools [desc]':
-    'list available OS Agent tools. Usage: /tools [desc]',
-  'Available OS Agent CLI tools:': 'Available OS Agent CLI tools:',
+  'list available osagent tools. Usage: /tools [desc]':
+    'list available osagent tools. Usage: /tools [desc]',
+  'Available osagent CLI tools:': 'Available osagent CLI tools:',
   'No tools available': 'No tools available',
   'View or change the approval mode for tool usage':
     'View or change the approval mode for tool usage',
@@ -106,8 +106,8 @@ export default {
     'clear the screen and conversation history',
   'Compresses the context by replacing it with a summary.':
     'Compresses the context by replacing it with a summary.',
-  'open full OS Agent documentation in your browser':
-    'open full OS Agent documentation in your browser',
+  'open full osagent documentation in your browser':
+    'open full osagent documentation in your browser',
   'Configuration not available.': 'Configuration not available.',
   'change the auth method': 'change the auth method',
   'Show quit confirmation dialog': 'Show quit confirmation dialog',
@@ -193,8 +193,8 @@ export default {
   'Step {{n}}: Choose Location': 'Step {{n}}: Choose Location',
   'Step {{n}}: Choose Generation Method':
     'Step {{n}}: Choose Generation Method',
-  'Generate with OS Agent (Recommended)':
-    'Generate with OS Agent (Recommended)',
+  'Generate with osagent (Recommended)':
+    'Generate with osagent (Recommended)',
   'Manual Creation': 'Manual Creation',
   'Describe what this subagent should do and when it should be used. (Be comprehensive for best results)':
     'Describe what this subagent should do and when it should be used. (Be comprehensive for best results)',
@@ -253,12 +253,12 @@ export default {
   // ============================================================================
   // Commands - General (continued)
   // ============================================================================
-  'View and edit OS Agent settings': 'View and edit OS Agent settings',
+  'View and edit osagent settings': 'View and edit osagent settings',
   Settings: 'Settings',
   '(Use Enter to select{{tabText}})': '(Use Enter to select{{tabText}})',
   ', Tab to change focus': ', Tab to change focus',
-  'To see changes, OS Agent must be restarted. Press r to exit and apply changes now.':
-    'To see changes, OS Agent must be restarted. Press r to exit and apply changes now.',
+  'To see changes, osagent must be restarted. Press r to exit and apply changes now.':
+    'To see changes, osagent must be restarted. Press r to exit and apply changes now.',
   // ============================================================================
   // Settings Labels
   // ============================================================================
@@ -345,8 +345,8 @@ export default {
     'install required IDE companion for {{ideName}}',
   'enable IDE integration': 'enable IDE integration',
   'disable IDE integration': 'disable IDE integration',
-  'IDE integration is not supported in your current environment. To use this feature, run OS Agent in one of these supported IDEs: VS Code or VS Code forks.':
-    'IDE integration is not supported in your current environment. To use this feature, run OS Agent in one of these supported IDEs: VS Code or VS Code forks.',
+  'IDE integration is not supported in your current environment. To use this feature, run osagent in one of these supported IDEs: VS Code or VS Code forks.':
+    'IDE integration is not supported in your current environment. To use this feature, run osagent in one of these supported IDEs: VS Code or VS Code forks.',
   'Set up GitHub Actions': 'Set up GitHub Actions',
   'Configure terminal keybindings for multiline input (VS Code, Cursor, Windsurf, Trae)':
     'Configure terminal keybindings for multiline input (VS Code, Cursor, Windsurf, Trae)',
@@ -739,8 +739,8 @@ export default {
   'You must select an auth method to proceed. Press Ctrl+C again to exit.':
     'You must select an auth method to proceed. Press Ctrl+C again to exit.',
   '(Use Enter to Set Auth)': '(Use Enter to Set Auth)',
-  'OS Agent - AI Coding Assistant':
-    'OS Agent - AI Coding Assistant',
+  'osagent - AI Coding Assistant':
+    'osagent - AI Coding Assistant',
   'Ollama Cloud': 'Ollama Cloud',
   Groq: 'Groq',
   'Failed to login. Message: {{message}}':
@@ -872,8 +872,8 @@ export default {
     '1. Ask questions, edit files, or run commands.',
   '2. Be specific for the best results.':
     '2. Be specific for the best results.',
-  'files to customize your interactions with OS Agent.':
-    'files to customize your interactions with OS Agent.',
+  'files to customize your interactions with osagent.':
+    'files to customize your interactions with osagent.',
   'for more information.': 'for more information.',
 
   // ============================================================================

package/{locales → dist/src/i18n/locales}/zh.js

@@ -54,10 +54,10 @@ export default {
   'For a full list of shortcuts, see {{docPath}}':
     '完整快捷键列表，请参阅 {{docPath}}',
   'docs/keyboard-shortcuts.md': 'docs/keyboard-shortcuts.md',
-  'for help on OSA Code': '获取 OSA Code 帮助',
+  'for help on osagent': '获取 osagent 帮助',
   'show version info': '显示版本信息',
   'submit a bug report': '提交错误报告',
-  'About OSA Code': '关于 OSA Code',
+  'About osagent': '关于 osagent',
 
   // ============================================================================
   // System Information Fields
@@ -82,9 +82,9 @@ export default {
   // ============================================================================
   'Analyzes the project and creates a tailored OSA.md file.':
     '分析项目并创建定制的 OSA.md 文件',
-  'list available OSA Code tools. Usage: /tools [desc]':
-    '列出可用的 OSA Code 工具。用法：/tools [desc]',
-  'Available OSA Code CLI tools:': '可用的 OSA Code CLI 工具：',
+  'list available osagent tools. Usage: /tools [desc]':
+    '列出可用的 osagent 工具。用法：/tools [desc]',
+  'Available osagent CLI tools:': '可用的 osagent CLI 工具：',
   'No tools available': '没有可用工具',
   'View or change the approval mode for tool usage':
     '查看或更改工具使用的审批模式',
@@ -104,8 +104,8 @@ export default {
   'clear the screen and conversation history': '清屏并清除对话历史',
   'Compresses the context by replacing it with a summary.':
     '通过用摘要替换来压缩上下文',
-  'open full OSA Code documentation in your browser':
-    '在浏览器中打开完整的 OSA Code 文档',
+  'open full osagent documentation in your browser':
+    '在浏览器中打开完整的 osagent 文档',
   'Configuration not available.': '配置不可用',
   'change the auth method': '更改认证方法',
   'Show quit confirmation dialog': '显示退出确认对话框',
@@ -167,8 +167,8 @@ export default {
   // ============================================================================
   // Agents - Creation Wizard
   // ============================================================================
-  'Project Level (.OSA/agents/)': '项目级 (.OSA/agents/)',
-  'User Level (~/.OSA/agents/)': '用户级 (~/.OSA/agents/)',
+  'Project Level (.osagent/agents/)': '项目级 (.osagent/agents/)',
+  'User Level (~/.osagent/agents/)': '用户级 (~/.osagent/agents/)',
   '✅ Subagent Created Successfully!': '✅ 子代理创建成功！',
   'Subagent "{{name}}" has been saved to {{level}} level.':
     '子代理 "{{name}}" 已保存到 {{level}} 级别。',
@@ -188,7 +188,7 @@ export default {
   // Agents - Creation Wizard Steps
   'Step {{n}}: Choose Location': '步骤 {{n}}: 选择位置',
   'Step {{n}}: Choose Generation Method': '步骤 {{n}}: 选择生成方式',
-  'Generate with OSA Code (Recommended)': '使用 OSA Code 生成（推荐）',
+  'Generate with osagent (Recommended)': '使用 osagent 生成（推荐）',
   'Manual Creation': '手动创建',
   'Describe what this subagent should do and when it should be used. (Be comprehensive for best results)':
     '描述此子代理应该做什么以及何时使用它。（为了获得最佳效果，请全面描述）',
@@ -244,12 +244,12 @@ export default {
   // ============================================================================
   // Commands - General (continued)
   // ============================================================================
-  'View and edit OSA Code settings': '查看和编辑 OSA Code 设置',
+  'View and edit osagent settings': '查看和编辑 osagent 设置',
   Settings: '设置',
   '(Use Enter to select{{tabText}})': '（使用 Enter 选择{{tabText}}）',
   ', Tab to change focus': '，Tab 切换焦点',
-  'To see changes, OSA Code must be restarted. Press r to exit and apply changes now.':
-    '要查看更改，必须重启 OSA Code。按 r 退出并立即应用更改。',
+  'To see changes, osagent must be restarted. Press r to exit and apply changes now.':
+    '要查看更改，必须重启 osagent。按 r 退出并立即应用更改。',
   // ============================================================================
   // Settings Labels
   // ============================================================================
@@ -288,7 +288,7 @@ export default {
   'Memory Discovery Max Dirs': '内存发现最大目录数',
   'Load Memory From Include Directories': '从包含目录加载内存',
   'Respect .gitignore': '遵守 .gitignore',
-  'Respect .OSAignore': '遵守 .OSAignore',
+  'Respect .osagentignore': '遵守 .osagentignore',
   'Enable Recursive File Search': '启用递归文件搜索',
   'Disable Fuzzy Search': '禁用模糊搜索',
   'Enable Interactive Shell': '启用交互式 Shell',
@@ -332,8 +332,8 @@ export default {
     '安装 {{ideName}} 所需的 IDE 配套工具',
   'enable IDE integration': '启用 IDE 集成',
   'disable IDE integration': '禁用 IDE 集成',
-  'IDE integration is not supported in your current environment. To use this feature, run OSA Code in one of these supported IDEs: VS Code or VS Code forks.':
-    '您当前环境不支持 IDE 集成。要使用此功能，请在以下支持的 IDE 之一中运行 OSA Code：VS Code 或 VS Code 分支版本。',
+  'IDE integration is not supported in your current environment. To use this feature, run osagent in one of these supported IDEs: VS Code or VS Code forks.':
+    '您当前环境不支持 IDE 集成。要使用此功能，请在以下支持的 IDE 之一中运行 osagent：VS Code 或 VS Code 分支版本。',
   'Set up GitHub Actions': '设置 GitHub Actions',
   'Configure terminal keybindings for multiline input (VS Code, Cursor, Windsurf, Trae)':
     '配置终端按键绑定以支持多行输入（VS Code、Cursor、Windsurf、Trae）',
@@ -551,8 +551,8 @@ export default {
   // ============================================================================
   // Commands - Summary
   // ============================================================================
-  'Generate a project summary and save it to .OSA/PROJECT_SUMMARY.md':
-    '生成项目摘要并保存到 .OSA/PROJECT_SUMMARY.md',
+  'Generate a project summary and save it to .osagent/PROJECT_SUMMARY.md':
+    '生成项目摘要并保存到 .osagent/PROJECT_SUMMARY.md',
   'No chat client available to generate summary.':
     '没有可用的聊天客户端来生成摘要',
   'Already generating summary, wait for previous request to complete':
@@ -822,14 +822,14 @@ export default {
   '1. Ask questions, edit files, or run commands.':
     '1. 提问、编辑文件或运行命令',
   '2. Be specific for the best results.': '2. 具体描述以获得最佳结果',
-  'files to customize your interactions with OSA Code.':
-    '文件以自定义您与 OSA Code 的交互',
+  'files to customize your interactions with osagent.':
+    '文件以自定义您与 osagent 的交互',
   'for more information.': '获取更多信息',
 
   // ============================================================================
   // Exit Screen / Stats
   // ============================================================================
-  'Agent powering down. Goodbye!': 'OSA Code 正在关闭，再见！',
+  'Agent powering down. Goodbye!': 'osagent 正在关闭，再见！',
   'Interaction Summary': '交互摘要',
   'Session ID:': '会话 ID：',
   'Tool Calls:': '工具调用：',

package/dist/src/nonInteractive/control/ControlContext.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2025 OSA Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Control Context
+ *
+ * Layer 1 of the control plane architecture. Provides shared, session-scoped
+ * state for all controllers and services, eliminating the need for prop
+ * drilling. Mutable fields are intentionally exposed so controllers can track
+ * runtime state (e.g. permission mode, active MCP clients).
+ */
+import type { Config, MCPServerConfig } from 'osagent-core';
+import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { StreamJsonOutputAdapter } from '../io/StreamJsonOutputAdapter.js';
+import type { PermissionMode } from '../types.js';
+/**
+ * Control Context interface
+ *
+ * Provides shared access to session-scoped resources and mutable state
+ * for all controllers across both ControlDispatcher (protocol routing) and
+ * ControlService (programmatic API).
+ */
+export interface IControlContext {
+    readonly config: Config;
+    readonly streamJson: StreamJsonOutputAdapter;
+    readonly sessionId: string;
+    readonly abortSignal: AbortSignal;
+    readonly debugMode: boolean;
+    permissionMode: PermissionMode;
+    sdkMcpServers: Set<string>;
+    mcpClients: Map<string, {
+        client: Client;
+        config: MCPServerConfig;
+    }>;
+    onInterrupt?: () => void;
+}
+/**
+ * Control Context implementation
+ */
+export declare class ControlContext implements IControlContext {
+    readonly config: Config;
+    readonly streamJson: StreamJsonOutputAdapter;
+    readonly sessionId: string;
+    readonly abortSignal: AbortSignal;
+    readonly debugMode: boolean;
+    permissionMode: PermissionMode;
+    sdkMcpServers: Set<string>;
+    mcpClients: Map<string, {
+        client: Client;
+        config: MCPServerConfig;
+    }>;
+    onInterrupt?: () => void;
+    constructor(options: {
+        config: Config;
+        streamJson: StreamJsonOutputAdapter;
+        sessionId: string;
+        abortSignal: AbortSignal;
+        permissionMode?: PermissionMode;
+        onInterrupt?: () => void;
+    });
+}

package/dist/src/nonInteractive/control/ControlContext.js

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 OSA Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Control Context implementation
+ */
+export class ControlContext {
+    config;
+    streamJson;
+    sessionId;
+    abortSignal;
+    debugMode;
+    permissionMode;
+    sdkMcpServers;
+    mcpClients;
+    onInterrupt;
+    constructor(options) {
+        this.config = options.config;
+        this.streamJson = options.streamJson;
+        this.sessionId = options.sessionId;
+        this.abortSignal = options.abortSignal;
+        this.debugMode = options.config.getDebugMode();
+        this.permissionMode = options.permissionMode || 'default';
+        this.sdkMcpServers = new Set();
+        this.mcpClients = new Map();
+        this.onInterrupt = options.onInterrupt;
+    }
+}
+//# sourceMappingURL=ControlContext.js.map

package/dist/src/nonInteractive/control/ControlContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlContext.js","sourceRoot":"","sources":["../../../../src/nonInteractive/control/ControlContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH;;GAEG;AACH,MAAM,OAAO,cAAc;IAChB,MAAM,CAAS;IACf,UAAU,CAA0B;IACpC,SAAS,CAAS;IAClB,WAAW,CAAc;IACzB,SAAS,CAAU;IAE5B,cAAc,CAAiB;IAC/B,aAAa,CAAc;IAC3B,UAAU,CAA2D;IAErE,WAAW,CAAc;IAEzB,YAAY,OAOX;QACC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC;QAC1D,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;CACF"}

package/dist/src/nonInteractive/control/ControlDispatcher.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 OSA Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Control Dispatcher
+ *
+ * Layer 2 of the control plane architecture. Routes control requests between
+ * SDK and CLI to appropriate controllers, manages pending request registries,
+ * and handles cancellation/cleanup. Application code MUST NOT depend on
+ * controller instances exposed by this class; instead, use ControlService,
+ * which wraps these controllers with a stable programmatic API.
+ *
+ * Controllers:
+ * - SystemController: initialize, interrupt, set_model, supported_commands
+ * - PermissionController: can_use_tool, set_permission_mode
+ * - MCPController: mcp_message, mcp_server_status
+ * - HookController: hook_callback
+ *
+ * Note: Control request types are centrally defined in the ControlRequestType
+ * enum in packages/sdk/typescript/src/types/controlRequests.ts
+ */
+import type { IControlContext } from './ControlContext.js';
+import type { IPendingRequestRegistry } from './controllers/baseController.js';
+import { SystemController } from './controllers/systemController.js';
+import type { CLIControlRequest, CLIControlResponse, ControlResponse, ControlRequestPayload } from '../types.js';
+/**
+ * Central coordinator for control plane communication.
+ * Routes requests to controllers and manages request lifecycle.
+ */
+export declare class ControlDispatcher implements IPendingRequestRegistry {
+    private context;
+    readonly systemController: SystemController;
+    private pendingIncomingRequests;
+    private pendingOutgoingRequests;
+    constructor(context: IControlContext);
+    /**
+     * Routes an incoming request to the appropriate controller and sends response
+     */
+    dispatch(request: CLIControlRequest): Promise<void>;
+    /**
+     * Processes response from SDK for an outgoing request
+     */
+    handleControlResponse(response: CLIControlResponse): void;
+    /**
+     * Sends a control request to SDK and waits for response
+     */
+    sendControlRequest(payload: ControlRequestPayload, timeoutMs?: number): Promise<ControlResponse>;
+    /**
+     * Cancels a specific request or all pending requests
+     */
+    handleCancel(requestId?: string): void;
+    /**
+     * Stops all pending requests and cleans up all controllers
+     */
+    shutdown(): void;
+    /**
+     * Registers an incoming request in the pending registry
+     */
+    registerIncomingRequest(requestId: string, controller: string, abortController: AbortController, timeoutId: NodeJS.Timeout): void;
+    /**
+     * Removes an incoming request from the pending registry
+     */
+    deregisterIncomingRequest(requestId: string): void;
+    /**
+     * Registers an outgoing request in the pending registry
+     */
+    registerOutgoingRequest(requestId: string, controller: string, resolve: (response: ControlResponse) => void, reject: (error: Error) => void, timeoutId: NodeJS.Timeout): void;
+    /**
+     * Removes an outgoing request from the pending registry
+     */
+    deregisterOutgoingRequest(requestId: string): void;
+    /**
+     * Returns the controller that handles the given request subtype
+     */
+    private getControllerForRequest;
+    /**
+     * Sends a success response back to SDK
+     */
+    private sendSuccessResponse;
+    /**
+     * Sends an error response back to SDK
+     */
+    private sendErrorResponse;
+}