catui-agent 1.0.0-beta.0

package/dist/core/platform/config/settings-manager.d.ts

@@ -0,0 +1,314 @@
+/**
+ * [WHO]: SettingsManager class, two-tier settings (global + project-local), agent loop defaults
+ * [FROM]: Depends on ai, node:fs, proper-lockfile, config.ts
+ * [TO]: Consumed by index.ts, main.ts, core/runtime/sdk.ts, cli/config-selector.ts, extensions/builtin/team/index.ts, modes/interactive/components/model-selector.ts, modes/interactive/components/config-selector.ts, and test files
+ * [HERE]: core/platform/config/settings-manager.ts - user preferences aggregation
+ */
+import type { Transport } from "@catui/ai/types";
+import { type AgentDirContext } from "../../agent-dir/agent-dir-context.js";
+export interface CompactionSettings {
+    enabled?: boolean;
+    reserveTokens?: number;
+    keepRecentTokens?: number;
+}
+export interface BranchSummarySettings {
+    reserveTokens?: number;
+}
+export interface RetrySettings {
+    enabled?: boolean;
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+export interface AgentLoopSettings {
+    maxToolResultBatchSizeChars?: number;
+}
+export interface TerminalSettings {
+    showImages?: boolean;
+    clearOnShrink?: boolean;
+    showTokenStats?: boolean;
+    showWorkingTrace?: boolean;
+    showMemoryTrace?: boolean;
+    buddyEnabled?: boolean;
+    buddySpecies?: number;
+}
+export interface ImageSettings {
+    autoResize?: boolean;
+    blockImages?: boolean;
+}
+export interface ThinkingBudgetsSettings {
+    minimal?: number;
+    low?: number;
+    medium?: number;
+    high?: number;
+}
+export interface MarkdownSettings {
+    codeBlockIndent?: string;
+}
+export type TransportSetting = Transport;
+export type AgentLoopFrameworkSetting = "standard" | "weak-model-compatible";
+export type AgentLoopFrameworkSettingInput = AgentLoopFrameworkSetting | "high-intelligence" | "low-intelligence" | "structured-adaptive";
+export declare function normalizeAgentLoopFrameworkSetting(value: AgentLoopFrameworkSettingInput | undefined): AgentLoopFrameworkSetting | undefined;
+/**
+ * Package source for npm/git packages.
+ * - String form: load all resources from the package
+ * - Object form: filter which resources to load
+ */
+export type PackageSource = string | {
+    source: string;
+    extensions?: string[];
+    skills?: string[];
+    prompts?: string[];
+    themes?: string[];
+};
+export interface Settings {
+    locale?: "en" | "zh";
+    lastChangelogVersion?: string;
+    defaultProvider?: string;
+    defaultModel?: string;
+    defaultThinkingLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    agentLoopFramework?: AgentLoopFrameworkSettingInput;
+    agentLoop?: AgentLoopSettings;
+    transport?: TransportSetting;
+    steeringMode?: "all" | "one-at-a-time";
+    followUpMode?: "all" | "one-at-a-time";
+    theme?: string;
+    compaction?: CompactionSettings;
+    branchSummary?: BranchSummarySettings;
+    retry?: RetrySettings;
+    hideThinkingBlock?: boolean;
+    shellPath?: string;
+    quietStartup?: boolean;
+    shellCommandPrefix?: string;
+    collapseChangelog?: boolean;
+    packages?: PackageSource[];
+    extensions?: string[];
+    skills?: string[];
+    prompts?: string[];
+    themes?: string[];
+    enableSkillCommands?: boolean;
+    terminal?: TerminalSettings;
+    images?: ImageSettings;
+    enabledModels?: string[];
+    doubleEscapeAction?: "fork" | "tree" | "none";
+    thinkingBudgets?: ThinkingBudgetsSettings;
+    editorPaddingX?: number;
+    autocompleteMaxVisible?: number;
+    showHardwareCursor?: boolean;
+    markdown?: MarkdownSettings;
+    /** Directory for plan mode files. Relative paths must stay inside the project root. */
+    plansDirectory?: string;
+    /** NanoMem / Dream settings */
+    nanomem?: {
+        autoDream?: {
+            enabled?: boolean;
+            minHours?: number;
+            minSessions?: number;
+            scanIntervalMinutes?: number;
+        };
+        dream?: {
+            lockStaleMinutes?: number;
+        };
+    };
+    /** Presence extension settings - AI greeting and idle messages */
+    presence?: {
+        enabled?: boolean;
+    };
+    /** IdleThink extension settings - background code exploration during idle */
+    idleThink?: {
+        enabled?: boolean;
+        idleMinutes?: number;
+        dailyBudget?: number;
+        maxDurationMinutes?: number;
+    };
+    /** Auto-update setting: 'always' = auto-update on startup, 'prompt' = ask user (default), 'never' = never check */
+    autoUpdate?: "always" | "prompt" | "never";
+    /** Last skipped version for update prompts */
+    skippedVersion?: string;
+}
+export type SettingsScope = "global" | "project";
+export interface SettingsStorage {
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+    withLockAsync(scope: SettingsScope, fn: (current: string | undefined) => Promise<string | undefined>): Promise<void>;
+    readStorageAsync(scope: SettingsScope): Promise<string | undefined>;
+}
+export interface SettingsError {
+    scope: SettingsScope;
+    error: Error;
+}
+export declare class FileSettingsStorage implements SettingsStorage {
+    private globalSettingsPath;
+    private projectSettingsPath;
+    constructor(cwd?: string, ctx?: AgentDirContext);
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+    withLockAsync(scope: SettingsScope, fn: (current: string | undefined) => Promise<string | undefined>): Promise<void>;
+    readStorageAsync(scope: SettingsScope): Promise<string | undefined>;
+}
+export declare class InMemorySettingsStorage implements SettingsStorage {
+    private global;
+    private project;
+    withLock(scope: SettingsScope, fn: (current: string | undefined) => string | undefined): void;
+    withLockAsync(scope: SettingsScope, fn: (current: string | undefined) => Promise<string | undefined>): Promise<void>;
+    readStorageAsync(scope: SettingsScope): Promise<string | undefined>;
+}
+export declare class SettingsManager {
+    private storage;
+    private globalSettings;
+    private projectSettings;
+    private settings;
+    private modifiedFields;
+    private modifiedNestedFields;
+    private modifiedProjectFields;
+    private modifiedProjectNestedFields;
+    private globalSettingsLoadError;
+    private projectSettingsLoadError;
+    private writeQueue;
+    private errors;
+    private constructor();
+    /** Create a SettingsManager that loads from files */
+    static create(cwd?: string, ctxOrPath?: string | AgentDirContext): SettingsManager;
+    /** Create a SettingsManager that loads from files async */
+    static createAsync(cwd?: string, ctxOrPath?: string | AgentDirContext): Promise<SettingsManager>;
+    /** Create a SettingsManager from an arbitrary storage backend */
+    static fromStorage(storage: SettingsStorage): SettingsManager;
+    /** Create a SettingsManager from an arbitrary storage backend async */
+    static fromStorageAsync(storage: SettingsStorage): Promise<SettingsManager>;
+    /** Create an in-memory SettingsManager (no file I/O) */
+    static inMemory(settings?: Partial<Settings>): SettingsManager;
+    private static loadFromStorage;
+    private static loadFromStorageAsync;
+    private static tryLoadFromStorage;
+    private static tryLoadFromStorageAsync;
+    /** Migrate old settings format to new format */
+    private static migrateSettings;
+    getGlobalSettings(): Settings;
+    getProjectSettings(): Settings;
+    /** Get merged effective settings (project overrides global). */
+    getSettings(): Settings;
+    reload(): void;
+    reloadAsync(): Promise<void>;
+    /** Apply additional overrides on top of current settings */
+    applyOverrides(overrides: Partial<Settings>): void;
+    /** Mark a global field as modified during this session */
+    private markModified;
+    /** Mark a project field as modified during this session */
+    private markProjectModified;
+    private recordError;
+    private clearModifiedScope;
+    private enqueueWrite;
+    private enqueueWriteAsync;
+    private cloneModifiedNestedFields;
+    private persistScopedSettings;
+    private persistScopedSettingsAsync;
+    private save;
+    private saveAsync;
+    private saveProjectSettings;
+    private saveProjectSettingsAsync;
+    flush(): Promise<void>;
+    drainErrors(): SettingsError[];
+    getLastChangelogVersion(): string | undefined;
+    setLastChangelogVersion(version: string): void;
+    getDefaultProvider(): string | undefined;
+    getDefaultModel(): string | undefined;
+    setDefaultProvider(provider: string): void;
+    setDefaultModel(modelId: string): void;
+    setDefaultModelAndProvider(provider: string, modelId: string): void;
+    getSteeringMode(): "all" | "one-at-a-time";
+    setSteeringMode(mode: "all" | "one-at-a-time"): void;
+    getFollowUpMode(): "all" | "one-at-a-time";
+    setFollowUpMode(mode: "all" | "one-at-a-time"): void;
+    getTheme(): string | undefined;
+    setTheme(theme: string): void;
+    getDefaultThinkingLevel(): "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
+    setDefaultThinkingLevel(level: "off" | "minimal" | "low" | "medium" | "high" | "xhigh"): void;
+    getAgentLoopFramework(): AgentLoopFrameworkSetting | undefined;
+    getAgentLoopSettings(): {
+        maxToolResultBatchSizeChars: number;
+    };
+    setAgentLoopFramework(framework: AgentLoopFrameworkSettingInput | undefined): void;
+    getTransport(): TransportSetting;
+    setTransport(transport: TransportSetting): void;
+    getCompactionEnabled(): boolean;
+    setCompactionEnabled(enabled: boolean): void;
+    getCompactionReserveTokens(): number;
+    getCompactionKeepRecentTokens(): number;
+    getCompactionSettings(): {
+        enabled: boolean;
+        reserveTokens: number;
+        keepRecentTokens: number;
+    };
+    getBranchSummarySettings(): {
+        reserveTokens: number;
+    };
+    getRetryEnabled(): boolean;
+    setRetryEnabled(enabled: boolean): void;
+    getRetrySettings(): {
+        enabled: boolean;
+        maxRetries: number;
+        baseDelayMs: number;
+        maxDelayMs: number;
+    };
+    getHideThinkingBlock(): boolean;
+    setHideThinkingBlock(hide: boolean): void;
+    getShellPath(): string | undefined;
+    setShellPath(path: string | undefined): void;
+    getQuietStartup(): boolean;
+    setQuietStartup(quiet: boolean): void;
+    getShellCommandPrefix(): string | undefined;
+    setShellCommandPrefix(prefix: string | undefined): void;
+    getCollapseChangelog(): boolean;
+    setCollapseChangelog(collapse: boolean): void;
+    getPackages(): PackageSource[];
+    setPackages(packages: PackageSource[]): void;
+    setProjectPackages(packages: PackageSource[]): void;
+    getExtensionPaths(): string[];
+    setExtensionPaths(paths: string[]): void;
+    setProjectExtensionPaths(paths: string[]): void;
+    getSkillPaths(): string[];
+    setSkillPaths(paths: string[]): void;
+    setProjectSkillPaths(paths: string[]): void;
+    getPromptTemplatePaths(): string[];
+    setPromptTemplatePaths(paths: string[]): void;
+    setProjectPromptTemplatePaths(paths: string[]): void;
+    getThemePaths(): string[];
+    setThemePaths(paths: string[]): void;
+    setProjectThemePaths(paths: string[]): void;
+    getEnableSkillCommands(): boolean;
+    setEnableSkillCommands(enabled: boolean): void;
+    getThinkingBudgets(): ThinkingBudgetsSettings | undefined;
+    getShowImages(): boolean;
+    setShowImages(show: boolean): void;
+    getBuddyEnabled(): boolean;
+    setBuddyEnabled(enabled: boolean): void;
+    getBuddySpecies(): number;
+    setBuddySpecies(species: number): void;
+    getClearOnShrink(): boolean;
+    setClearOnShrink(enabled: boolean): void;
+    getShowTokenStats(): boolean;
+    setShowTokenStats(enabled: boolean): void;
+    getShowWorkingTrace(): boolean;
+    setShowWorkingTrace(enabled: boolean): void;
+    getShowMemoryTrace(): boolean;
+    setShowMemoryTrace(enabled: boolean): void;
+    getPresenceEnabled(): boolean;
+    setPresenceEnabled(enabled: boolean): void;
+    getImageAutoResize(): boolean;
+    setImageAutoResize(enabled: boolean): void;
+    getBlockImages(): boolean;
+    setBlockImages(blocked: boolean): void;
+    getEnabledModels(): string[] | undefined;
+    setEnabledModels(patterns: string[] | undefined): void;
+    getDoubleEscapeAction(): "fork" | "tree" | "none";
+    setDoubleEscapeAction(action: "fork" | "tree" | "none"): void;
+    getShowHardwareCursor(): boolean;
+    setShowHardwareCursor(enabled: boolean): void;
+    getEditorPaddingX(): number;
+    setEditorPaddingX(padding: number): void;
+    getAutocompleteMaxVisible(): number;
+    setAutocompleteMaxVisible(maxVisible: number): void;
+    getCodeBlockIndent(): string;
+    getAutoUpdate(): "always" | "prompt" | "never";
+    setAutoUpdate(mode: "always" | "prompt" | "never"): void;
+    getSkippedVersion(): string | undefined;
+    setSkippedVersion(version: string | undefined): void;
+}

package/dist/core/platform/config/settings-manager.js

@@ -0,0 +1 @@
+var E=Object.defineProperty;var c=(l,e)=>E(l,"name",{value:e,configurable:!0});import{existsSync as S,mkdirSync as C,readFileSync as L,writeFileSync as A}from"fs";import{dirname as j,join as w}from"path";import f from"proper-lockfile";import{APP_NAME as M,CONFIG_DIR_NAME as T}from"../../../config.js";import{defaultAgentDirContext as y}from"../../agent-dir/agent-dir-context.js";import{readFile as P,writeFile as N,mkdir as x}from"node:fs/promises";const R=2e5;function v(l){return l==="high-intelligence"?"standard":l==="low-intelligence"||l==="structured-adaptive"?"weak-model-compatible":l}c(v,"normalizeAgentLoopFrameworkSetting");function h(l,e){const t={...l};for(const s of Object.keys(e)){const i=e[s],r=l[s];i!==void 0&&(typeof i=="object"&&i!==null&&!Array.isArray(i)&&typeof r=="object"&&r!==null&&!Array.isArray(r)?t[s]={...r,...i}:t[s]=i)}return t}c(h,"deepMergeSettings");class F{static{c(this,"FileSettingsStorage")}globalSettingsPath;projectSettingsPath;constructor(e=process.cwd(),t=y()){this.globalSettingsPath=w(t.path,"settings.json"),this.projectSettingsPath=w(e,T,"settings.json")}withLock(e,t){const s=e==="global"?this.globalSettingsPath:this.projectSettingsPath,i=j(s);let r;try{const a=S(s);a&&(r=f.lockSync(s,{realpath:!1}));const d=a?L(s,"utf-8"):void 0,n=t(d);n!==void 0&&(S(i)||C(i,{recursive:!0}),r||(r=f.lockSync(s,{realpath:!1})),A(s,n,"utf-8"))}finally{r&&r()}}async withLockAsync(e,t){const s=e==="global"?this.globalSettingsPath:this.projectSettingsPath,i=j(s);let r;try{const a=S(s);a&&(r=f.lockSync(s,{realpath:!1}));const d=a?await P(s,"utf-8"):void 0,n=await t(d);n!==void 0&&(S(i)||await x(i,{recursive:!0}),r||(r=f.lockSync(s,{realpath:!1})),await N(s,n,"utf-8"))}finally{r&&r()}}async readStorageAsync(e){const t=e==="global"?this.globalSettingsPath:this.projectSettingsPath;if(S(t))return P(t,"utf-8")}}class I{static{c(this,"InMemorySettingsStorage")}global;project;withLock(e,t){const s=e==="global"?this.global:this.project,i=t(s);i!==void 0&&(e==="global"?this.global=i:this.project=i)}async withLockAsync(e,t){const s=e==="global"?this.global:this.project,i=await t(s);i!==void 0&&(e==="global"?this.global=i:this.project=i)}async readStorageAsync(e){return e==="global"?this.global:this.project}}class o{static{c(this,"SettingsManager")}storage;globalSettings;projectSettings;settings;modifiedFields=new Set;modifiedNestedFields=new Map;modifiedProjectFields=new Set;modifiedProjectNestedFields=new Map;globalSettingsLoadError=null;projectSettingsLoadError=null;writeQueue=Promise.resolve();errors;constructor(e,t,s,i=null,r=null,a=[]){this.storage=e,this.globalSettings=t,this.projectSettings=s,this.globalSettingsLoadError=i,this.projectSettingsLoadError=r,this.errors=[...a],this.settings=h(this.globalSettings,this.projectSettings)}static create(e=process.cwd(),t=y()){const s=typeof t=="string"?{id:"legacy",path:t}:t,i=new F(e,s);return o.fromStorage(i)}static async createAsync(e=process.cwd(),t=y()){const s=typeof t=="string"?{id:"legacy",path:t}:t,i=new F(e,s);return o.fromStorageAsync(i)}static fromStorage(e){const t=o.tryLoadFromStorage(e,"global"),s=o.tryLoadFromStorage(e,"project"),i=[];return t.error&&i.push({scope:"global",error:t.error}),s.error&&i.push({scope:"project",error:s.error}),new o(e,t.settings,s.settings,t.error,s.error,i)}static async fromStorageAsync(e){const[t,s]=await Promise.all([o.tryLoadFromStorageAsync(e,"global"),o.tryLoadFromStorageAsync(e,"project")]),i=[];return t.error&&i.push({scope:"global",error:t.error}),s.error&&i.push({scope:"project",error:s.error}),new o(e,t.settings,s.settings,t.error,s.error,i)}static inMemory(e={}){const t=new I;return new o(t,e,{})}static loadFromStorage(e,t){let s;if(e.withLock(t,r=>{s=r}),!s)return{};const i=JSON.parse(s);return o.migrateSettings(i)}static async loadFromStorageAsync(e,t){const s=await e.readStorageAsync(t);if(!s)return{};const i=JSON.parse(s);return o.migrateSettings(i)}static tryLoadFromStorage(e,t){try{return{settings:o.loadFromStorage(e,t),error:null}}catch(s){return{settings:{},error:s}}}static async tryLoadFromStorageAsync(e,t){try{return{settings:await o.loadFromStorageAsync(e,t),error:null}}catch(s){return{settings:{},error:s}}}static migrateSettings(e){if("queueMode"in e&&!("steeringMode"in e)&&(e.steeringMode=e.queueMode,delete e.queueMode),!("transport"in e)&&typeof e.websockets=="boolean"&&(e.transport=e.websockets?"websocket":"sse",delete e.websockets),"skills"in e&&typeof e.skills=="object"&&e.skills!==null&&!Array.isArray(e.skills)){const t=e.skills;t.enableSkillCommands!==void 0&&e.enableSkillCommands===void 0&&(e.enableSkillCommands=t.enableSkillCommands),Array.isArray(t.customDirectories)&&t.customDirectories.length>0?e.skills=t.customDirectories:delete e.skills}return e}getGlobalSettings(){return structuredClone(this.globalSettings)}getProjectSettings(){return structuredClone(this.projectSettings)}getSettings(){return structuredClone(this.settings)}reload(){const e=o.tryLoadFromStorage(this.storage,"global");e.error?(this.globalSettingsLoadError=e.error,this.recordError("global",e.error)):(this.globalSettings=e.settings,this.globalSettingsLoadError=null),this.modifiedFields.clear(),this.modifiedNestedFields.clear(),this.modifiedProjectFields.clear(),this.modifiedProjectNestedFields.clear();const t=o.tryLoadFromStorage(this.storage,"project");t.error?(this.projectSettingsLoadError=t.error,this.recordError("project",t.error)):(this.projectSettings=t.settings,this.projectSettingsLoadError=null),this.settings=h(this.globalSettings,this.projectSettings)}async reloadAsync(){const[e,t]=await Promise.all([o.tryLoadFromStorageAsync(this.storage,"global"),o.tryLoadFromStorageAsync(this.storage,"project")]);e.error?(this.globalSettingsLoadError=e.error,this.recordError("global",e.error)):(this.globalSettings=e.settings,this.globalSettingsLoadError=null),this.modifiedFields.clear(),this.modifiedNestedFields.clear(),this.modifiedProjectFields.clear(),this.modifiedProjectNestedFields.clear(),t.error?(this.projectSettingsLoadError=t.error,this.recordError("project",t.error)):(this.projectSettings=t.settings,this.projectSettingsLoadError=null),this.settings=h(this.globalSettings,this.projectSettings)}applyOverrides(e){this.settings=h(this.settings,e)}markModified(e,t){this.modifiedFields.add(e),t&&(this.modifiedNestedFields.has(e)||this.modifiedNestedFields.set(e,new Set),this.modifiedNestedFields.get(e).add(t))}markProjectModified(e,t){this.modifiedProjectFields.add(e),t&&(this.modifiedProjectNestedFields.has(e)||this.modifiedProjectNestedFields.set(e,new Set),this.modifiedProjectNestedFields.get(e).add(t))}recordError(e,t){const s=t instanceof Error?t:new Error(String(t));this.errors.push({scope:e,error:s})}clearModifiedScope(e){if(e==="global"){this.modifiedFields.clear(),this.modifiedNestedFields.clear();return}this.modifiedProjectFields.clear(),this.modifiedProjectNestedFields.clear()}enqueueWrite(e,t){this.writeQueue=this.writeQueue.then(()=>{t(),this.clearModifiedScope(e)}).catch(s=>{this.recordError(e,s)})}enqueueWriteAsync(e,t){return this.writeQueue=this.writeQueue.then(async()=>{await t(),this.clearModifiedScope(e)}).catch(s=>{this.recordError(e,s)}),this.writeQueue}cloneModifiedNestedFields(e){const t=new Map;for(const[s,i]of e.entries())t.set(s,new Set(i));return t}persistScopedSettings(e,t,s,i){this.storage.withLock(e,r=>{const a=r?o.migrateSettings(JSON.parse(r)):{},d={...a};for(const n of s){const g=t[n];if(i.has(n)&&typeof g=="object"&&g!==null){const p=i.get(n),b=a[n]??{},k=g,m={...b};for(const u of p)m[u]=k[u];d[n]=m}else d[n]=g}return JSON.stringify(d,null,2)})}async persistScopedSettingsAsync(e,t,s,i){await this.storage.withLockAsync(e,async r=>{const a=r?o.migrateSettings(JSON.parse(r)):{},d={...a};for(const n of s){const g=t[n];if(i.has(n)&&typeof g=="object"&&g!==null){const p=i.get(n),b=a[n]??{},k=g,m={...b};for(const u of p)m[u]=k[u];d[n]=m}else d[n]=g}return JSON.stringify(d,null,2)})}save(){if(this.settings=h(this.globalSettings,this.projectSettings),this.globalSettingsLoadError)return;const e=structuredClone(this.globalSettings),t=new Set(this.modifiedFields),s=this.cloneModifiedNestedFields(this.modifiedNestedFields);this.enqueueWrite("global",()=>{this.persistScopedSettings("global",e,t,s)})}async saveAsync(){if(this.settings=h(this.globalSettings,this.projectSettings),this.globalSettingsLoadError)return;const e=structuredClone(this.globalSettings),t=new Set(this.modifiedFields),s=this.cloneModifiedNestedFields(this.modifiedNestedFields);await this.enqueueWriteAsync("global",async()=>{await this.persistScopedSettingsAsync("global",e,t,s)})}saveProjectSettings(e){if(this.projectSettings=structuredClone(e),this.settings=h(this.globalSettings,this.projectSettings),this.projectSettingsLoadError)return;const t=structuredClone(this.projectSettings),s=new Set(this.modifiedProjectFields),i=this.cloneModifiedNestedFields(this.modifiedProjectNestedFields);this.enqueueWrite("project",()=>{this.persistScopedSettings("project",t,s,i)})}async saveProjectSettingsAsync(e){if(this.projectSettings=structuredClone(e),this.settings=h(this.globalSettings,this.projectSettings),this.projectSettingsLoadError)return;const t=structuredClone(this.projectSettings),s=new Set(this.modifiedProjectFields),i=this.cloneModifiedNestedFields(this.modifiedProjectNestedFields);await this.enqueueWriteAsync("project",async()=>{await this.persistScopedSettingsAsync("project",t,s,i)})}async flush(){await this.writeQueue}drainErrors(){const e=[...this.errors];return this.errors=[],e}getLastChangelogVersion(){return this.settings.lastChangelogVersion}setLastChangelogVersion(e){this.globalSettings.lastChangelogVersion=e,this.markModified("lastChangelogVersion"),this.save()}getDefaultProvider(){return this.settings.defaultProvider}getDefaultModel(){return this.settings.defaultModel}setDefaultProvider(e){this.globalSettings.defaultProvider=e,this.markModified("defaultProvider"),this.save()}setDefaultModel(e){this.globalSettings.defaultModel=e,this.markModified("defaultModel"),this.save()}setDefaultModelAndProvider(e,t){this.globalSettings.defaultProvider=e,this.globalSettings.defaultModel=t,this.markModified("defaultProvider"),this.markModified("defaultModel"),this.save()}getSteeringMode(){return this.settings.steeringMode||"one-at-a-time"}setSteeringMode(e){this.globalSettings.steeringMode=e,this.markModified("steeringMode"),this.save()}getFollowUpMode(){return this.settings.followUpMode||"one-at-a-time"}setFollowUpMode(e){this.globalSettings.followUpMode=e,this.markModified("followUpMode"),this.save()}getTheme(){return this.settings.theme}setTheme(e){this.globalSettings.theme=e,this.markModified("theme"),this.save()}getDefaultThinkingLevel(){return this.settings.defaultThinkingLevel}setDefaultThinkingLevel(e){this.globalSettings.defaultThinkingLevel=e,this.markModified("defaultThinkingLevel"),this.save()}getAgentLoopFramework(){return v(this.settings.agentLoopFramework)}getAgentLoopSettings(){const e=this.settings.agentLoop?.maxToolResultBatchSizeChars;return{maxToolResultBatchSizeChars:typeof e=="number"&&Number.isFinite(e)&&e>0?Math.floor(e):R}}setAgentLoopFramework(e){const t=v(e);t===void 0?delete this.globalSettings.agentLoopFramework:this.globalSettings.agentLoopFramework=t,this.markModified("agentLoopFramework"),this.save()}getTransport(){return this.settings.transport??"sse"}setTransport(e){this.globalSettings.transport=e,this.markModified("transport"),this.save()}getCompactionEnabled(){return this.settings.compaction?.enabled??!0}setCompactionEnabled(e){this.globalSettings.compaction||(this.globalSettings.compaction={}),this.globalSettings.compaction.enabled=e,this.markModified("compaction","enabled"),this.save()}getCompactionReserveTokens(){return this.settings.compaction?.reserveTokens??16384}getCompactionKeepRecentTokens(){return this.settings.compaction?.keepRecentTokens??2e4}getCompactionSettings(){return{enabled:this.getCompactionEnabled(),reserveTokens:this.getCompactionReserveTokens(),keepRecentTokens:this.getCompactionKeepRecentTokens()}}getBranchSummarySettings(){return{reserveTokens:this.settings.branchSummary?.reserveTokens??16384}}getRetryEnabled(){return this.settings.retry?.enabled??!0}setRetryEnabled(e){this.globalSettings.retry||(this.globalSettings.retry={}),this.globalSettings.retry.enabled=e,this.markModified("retry","enabled"),this.save()}getRetrySettings(){return{enabled:this.getRetryEnabled(),maxRetries:this.settings.retry?.maxRetries??3,baseDelayMs:this.settings.retry?.baseDelayMs??2e3,maxDelayMs:this.settings.retry?.maxDelayMs??6e4}}getHideThinkingBlock(){return this.settings.hideThinkingBlock??!1}setHideThinkingBlock(e){this.globalSettings.hideThinkingBlock=e,this.markModified("hideThinkingBlock"),this.save()}getShellPath(){return this.settings.shellPath}setShellPath(e){this.globalSettings.shellPath=e,this.markModified("shellPath"),this.save()}getQuietStartup(){const e=this.settings.quietStartup;return e!==void 0?e:M==="catui"||M==="catui"}setQuietStartup(e){this.globalSettings.quietStartup=e,this.markModified("quietStartup"),this.save()}getShellCommandPrefix(){return this.settings.shellCommandPrefix}setShellCommandPrefix(e){this.globalSettings.shellCommandPrefix=e,this.markModified("shellCommandPrefix"),this.save()}getCollapseChangelog(){return this.settings.collapseChangelog??!1}setCollapseChangelog(e){this.globalSettings.collapseChangelog=e,this.markModified("collapseChangelog"),this.save()}getPackages(){return[...this.settings.packages??[]]}setPackages(e){this.globalSettings.packages=e,this.markModified("packages"),this.save()}setProjectPackages(e){const t=structuredClone(this.projectSettings);t.packages=e,this.markProjectModified("packages"),this.saveProjectSettings(t)}getExtensionPaths(){return[...this.settings.extensions??[]]}setExtensionPaths(e){this.globalSettings.extensions=e,this.markModified("extensions"),this.save()}setProjectExtensionPaths(e){const t=structuredClone(this.projectSettings);t.extensions=e,this.markProjectModified("extensions"),this.saveProjectSettings(t)}getSkillPaths(){return[...this.settings.skills??[]]}setSkillPaths(e){this.globalSettings.skills=e,this.markModified("skills"),this.save()}setProjectSkillPaths(e){const t=structuredClone(this.projectSettings);t.skills=e,this.markProjectModified("skills"),this.saveProjectSettings(t)}getPromptTemplatePaths(){return[...this.settings.prompts??[]]}setPromptTemplatePaths(e){this.globalSettings.prompts=e,this.markModified("prompts"),this.save()}setProjectPromptTemplatePaths(e){const t=structuredClone(this.projectSettings);t.prompts=e,this.markProjectModified("prompts"),this.saveProjectSettings(t)}getThemePaths(){return[...this.settings.themes??[]]}setThemePaths(e){this.globalSettings.themes=e,this.markModified("themes"),this.save()}setProjectThemePaths(e){const t=structuredClone(this.projectSettings);t.themes=e,this.markProjectModified("themes"),this.saveProjectSettings(t)}getEnableSkillCommands(){return this.settings.enableSkillCommands??!0}setEnableSkillCommands(e){this.globalSettings.enableSkillCommands=e,this.markModified("enableSkillCommands"),this.save()}getThinkingBudgets(){return this.settings.thinkingBudgets}getShowImages(){return this.settings.terminal?.showImages??!0}setShowImages(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.showImages=e,this.markModified("terminal","showImages"),this.save()}getBuddyEnabled(){return this.settings.terminal?.buddyEnabled??!1}setBuddyEnabled(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.buddyEnabled=e,this.markModified("terminal","buddyEnabled"),this.save()}getBuddySpecies(){return this.settings.terminal?.buddySpecies??0}setBuddySpecies(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.buddySpecies=e,this.markModified("terminal","buddySpecies"),this.save()}getClearOnShrink(){return this.settings.terminal?.clearOnShrink!==void 0?this.settings.terminal.clearOnShrink:process.env.PI_CLEAR_ON_SHRINK==="1"}setClearOnShrink(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.clearOnShrink=e,this.markModified("terminal","clearOnShrink"),this.save()}getShowTokenStats(){return this.settings.terminal?.showTokenStats??!0}setShowTokenStats(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.showTokenStats=e,this.markModified("terminal","showTokenStats"),this.save()}getShowWorkingTrace(){return this.settings.terminal?.showWorkingTrace??!1}setShowWorkingTrace(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.showWorkingTrace=e,this.markModified("terminal","showWorkingTrace"),this.save()}getShowMemoryTrace(){return this.settings.terminal?.showMemoryTrace??!1}setShowMemoryTrace(e){this.globalSettings.terminal||(this.globalSettings.terminal={}),this.globalSettings.terminal.showMemoryTrace=e,this.markModified("terminal","showMemoryTrace"),this.save()}getPresenceEnabled(){return this.settings.presence?.enabled??!0}setPresenceEnabled(e){this.globalSettings.presence||(this.globalSettings.presence={}),this.globalSettings.presence.enabled=e,this.markModified("presence","enabled"),this.save()}getImageAutoResize(){return this.settings.images?.autoResize??!0}setImageAutoResize(e){this.globalSettings.images||(this.globalSettings.images={}),this.globalSettings.images.autoResize=e,this.markModified("images","autoResize"),this.save()}getBlockImages(){return this.settings.images?.blockImages??!1}setBlockImages(e){this.globalSettings.images||(this.globalSettings.images={}),this.globalSettings.images.blockImages=e,this.markModified("images","blockImages"),this.save()}getEnabledModels(){return this.settings.enabledModels}setEnabledModels(e){this.globalSettings.enabledModels=e,this.markModified("enabledModels"),this.save()}getDoubleEscapeAction(){return this.settings.doubleEscapeAction??"tree"}setDoubleEscapeAction(e){this.globalSettings.doubleEscapeAction=e,this.markModified("doubleEscapeAction"),this.save()}getShowHardwareCursor(){return this.settings.showHardwareCursor??process.env.PI_HARDWARE_CURSOR==="1"}setShowHardwareCursor(e){this.globalSettings.showHardwareCursor=e,this.markModified("showHardwareCursor"),this.save()}getEditorPaddingX(){return this.settings.editorPaddingX??0}setEditorPaddingX(e){this.globalSettings.editorPaddingX=Math.max(0,Math.min(3,Math.floor(e))),this.markModified("editorPaddingX"),this.save()}getAutocompleteMaxVisible(){return this.settings.autocompleteMaxVisible??5}setAutocompleteMaxVisible(e){this.globalSettings.autocompleteMaxVisible=Math.max(3,Math.min(20,Math.floor(e))),this.markModified("autocompleteMaxVisible"),this.save()}getCodeBlockIndent(){return this.settings.markdown?.codeBlockIndent??"  "}getAutoUpdate(){return this.settings.autoUpdate??"prompt"}setAutoUpdate(e){this.globalSettings.autoUpdate=e,this.markModified("autoUpdate"),this.save()}getSkippedVersion(){return this.settings.skippedVersion}setSkippedVersion(e){this.globalSettings.skippedVersion=e,this.markModified("skippedVersion"),this.save()}}export{F as FileSettingsStorage,I as InMemorySettingsStorage,o as SettingsManager,v as normalizeAgentLoopFrameworkSetting};

package/dist/core/platform/exec/bash-executor.d.ts

@@ -0,0 +1,41 @@
+import type { BashOperations } from "../../tools/bash.js";
+export interface BashExecutorOptions {
+    /** Callback for streaming output chunks (already sanitized) */
+    onChunk?: (chunk: string) => void;
+    /** AbortSignal for cancellation */
+    signal?: AbortSignal;
+    /** Working directory for the command. Defaults to process cwd. */
+    cwd?: string;
+}
+export interface BashResult {
+    /** Combined stdout + stderr output (sanitized, possibly truncated) */
+    output: string;
+    /** Process exit code (undefined if killed/cancelled) */
+    exitCode: number | undefined;
+    /** Whether the command was cancelled via signal */
+    cancelled: boolean;
+    /** Whether the output was truncated */
+    truncated: boolean;
+    /** Path to temp file containing full output (if output exceeded truncation threshold) */
+    fullOutputPath?: string;
+}
+/**
+ * Execute a bash command with optional streaming and cancellation support.
+ *
+ * Features:
+ * - Streams sanitized output via onChunk callback
+ * - Writes large output to temp file for later retrieval
+ * - Supports cancellation via AbortSignal
+ * - Sanitizes output (strips ANSI, removes binary garbage, normalizes newlines)
+ * - Truncates output if it exceeds the default max bytes
+ *
+ * @param command - The bash command to execute
+ * @param options - Optional streaming callback and abort signal
+ * @returns Promise resolving to execution result
+ */
+export declare function executeBash(command: string, options?: BashExecutorOptions): Promise<BashResult>;
+/**
+ * Execute a bash command using custom BashOperations.
+ * Used for remote execution (SSH, containers, etc.).
+ */
+export declare function executeBashWithOperations(command: string, cwd: string, operations: BashOperations, options?: BashExecutorOptions): Promise<BashResult>;

package/dist/core/platform/exec/bash-executor.js

@@ -0,0 +1 @@
+var T=Object.defineProperty;var p=(g,t)=>T(g,"name",{value:t,configurable:!0});import{randomBytes as O}from"node:crypto";import{createWriteStream as b}from"node:fs";import{tmpdir as v}from"node:os";import{join as S}from"node:path";import{spawn as D}from"child_process";import P from"strip-ansi";import{getShellConfig as F,getShellEnv as j,killProcessTree as L,sanitizeBinaryOutput as E}from"../utils/shell.js";import{DEFAULT_MAX_BYTES as k,truncateTail as y}from"../../tools/truncate.js";function X(g,t){return new Promise((w,c)=>{const{shell:a,args:x}=F(),i=D(a,[...x,g],{cwd:t?.cwd,detached:!0,env:j(),stdio:["ignore","pipe","pipe"]}),o=[];let r=0;const C=k*2;let m,u,l=0;const e=p(()=>{i.pid&&L(i.pid)},"abortHandler");if(t?.signal){if(t.signal.aborted){i.kill(),w({output:"",exitCode:void 0,cancelled:!0,truncated:!1});return}t.signal.addEventListener("abort",e,{once:!0})}const n=new TextDecoder,s=p(d=>{l+=d.length;const f=E(P(n.decode(d,{stream:!0}))).replace(/\r/g,"");if(l>k&&!m){const h=O(8).toString("hex");m=S(v(),`catui-bash-${h}.log`),u=b(m);for(const B of o)u.write(B)}for(u&&u.write(f),o.push(f),r+=f.length;r>C&&o.length>1;){const h=o.shift();r-=h.length}t?.onChunk&&t.onChunk(f)},"handleData");i.stdout?.on("data",s),i.stderr?.on("data",s),i.on("close",d=>{t?.signal&&t.signal.removeEventListener("abort",e),u&&u.end();const f=o.join(""),h=y(f),B=d===null;w({output:h.truncated?h.content:f,exitCode:B?void 0:d,cancelled:B,truncated:h.truncated,fullOutputPath:m})}),i.on("error",d=>{t?.signal&&t.signal.removeEventListener("abort",e),u&&u.end(),c(d)})})}p(X,"executeBash");async function Y(g,t,w,c){const a=[];let x=0;const i=k*2;let o,r,C=0;const m=new TextDecoder,u=p(l=>{C+=l.length;const e=E(P(m.decode(l,{stream:!0}))).replace(/\r/g,"");if(C>k&&!o){const n=O(8).toString("hex");o=S(v(),`catui-bash-${n}.log`),r=b(o);for(const s of a)r.write(s)}for(r&&r.write(e),a.push(e),x+=e.length;x>i&&a.length>1;){const n=a.shift();x-=n.length}c?.onChunk&&c.onChunk(e)},"onData");try{const l=await w.exec(g,t,{onData:u,signal:c?.signal});r&&r.end();const e=a.join(""),n=y(e),s=c?.signal?.aborted??!1;return{output:n.truncated?n.content:e,exitCode:s?void 0:l.exitCode??void 0,cancelled:s,truncated:n.truncated,fullOutputPath:o}}catch(l){if(r&&r.end(),c?.signal?.aborted){const e=a.join(""),n=y(e);return{output:n.truncated?n.content:e,exitCode:void 0,cancelled:!0,truncated:n.truncated,fullOutputPath:o}}throw l}}p(Y,"executeBashWithOperations");export{X as executeBash,Y as executeBashWithOperations};

package/dist/core/platform/exec/exec.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Options for executing shell commands.
+ */
+export interface ExecOptions {
+    /** AbortSignal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Result of executing a shell command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export declare function execCommand(command: string, args: string[], cwd: string, options?: ExecOptions): Promise<ExecResult>;

package/dist/core/platform/exec/exec.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var m=(n,o)=>f(n,"name",{value:o,configurable:!0});import{spawn as g}from"node:child_process";async function T(n,o,c,e){return new Promise(u=>{const t=g(n,o,{cwd:c,shell:!1,stdio:["ignore","pipe","pipe"]});let s="",d="",a=!1,r;const l=m(()=>{a||(a=!0,t.kill("SIGTERM"),setTimeout(()=>{t.killed||t.kill("SIGKILL")},5e3))},"killProcess");e?.signal&&(e.signal.aborted?l():e.signal.addEventListener("abort",l,{once:!0})),e?.timeout&&e.timeout>0&&(r=setTimeout(()=>{l()},e.timeout)),t.stdout?.on("data",i=>{s+=i.toString()}),t.stderr?.on("data",i=>{d+=i.toString()}),t.on("close",i=>{r&&clearTimeout(r),e?.signal&&e.signal.removeEventListener("abort",l),u({stdout:s,stderr:d,code:i??0,killed:a})}),t.on("error",i=>{r&&clearTimeout(r),e?.signal&&e.signal.removeEventListener("abort",l),u({stdout:s,stderr:d,code:1,killed:a})})})}m(T,"execCommand");export{T as execCommand};

package/dist/core/platform/i18n/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * [WHO]: i18n, t(), setLocale(), getLocale(), AVAILABLE_LOCALES, type Locale
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by modes/interactive/interactive-mode.ts, core/runtime/agent-session.ts, core/slash-commands.ts
+ * [HERE]: core/platform/i18n/index.ts - internationalization core
+ */
+export type Locale = "en" | "zh";
+export declare const AVAILABLE_LOCALES: Locale[];
+export declare const LOCALE_NAMES: Record<Locale, string>;
+export declare function getLocale(): Locale;
+export declare function setLocale(locale: Locale): void;
+import { slashCommands as slashCommandsEn } from "./slash-commands.js";
+import { messages as messagesEn } from "./messages.js";
+import { themes as themesEn } from "./themes.js";
+import { slashCommands as slashCommandsZh } from "./slash-commands.zh.js";
+export type SlashCommands = typeof slashCommandsEn;
+export type Messages = typeof messagesEn;
+export type Themes = typeof themesEn;
+export interface TranslationPaths {
+    slashCommands: string[];
+    messages: string[];
+    themes: string[];
+}
+export declare function tValue<T = unknown>(path: string): T | undefined;
+export declare function t(path: string): string;
+export { slashCommandsEn, slashCommandsZh };

package/dist/core/platform/i18n/index.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var n=(e,s)=>l(e,"name",{value:s,configurable:!0});const f=["en","zh"],L={en:"English",zh:"\u4E2D\u6587"};let o="en";function E(){return o}n(E,"getLocale");function x(e){f.includes(e)&&(o=e)}n(x,"setLocale");import{slashCommands as a}from"./slash-commands.js";import{messages as h}from"./messages.js";import{themes as c}from"./themes.js";import{slashCommands as i}from"./slash-commands.zh.js";import{messages as u}from"./messages.zh.js";import{themes as p}from"./themes.zh.js";const d={en:{slashCommands:a,messages:h,themes:c},zh:{slashCommands:i,messages:u,themes:p}};function g(e){const s=e.split("."),t=d[o];if(s[0]==="slash")return m(t.slashCommands,s.slice(1));if(s[0]==="msg")return m(t.messages,s.slice(1));if(s[0]==="theme")return m(t.themes,s.slice(1))}n(g,"tValue");function O(e){const s=g(e);return typeof s=="string"?s:e}n(O,"t");function m(e,s){let t=e;for(const r of s)if(t&&typeof t=="object"&&r in t)t=t[r];else return;return t}n(m,"getNestedValue");export{f as AVAILABLE_LOCALES,L as LOCALE_NAMES,E as getLocale,x as setLocale,a as slashCommandsEn,i as slashCommandsZh,O as t,g as tValue};

package/dist/core/platform/i18n/messages.d.ts

@@ -0,0 +1,56 @@
+/**
+ * [WHO]: messages - English translations for user-facing messages
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/platform/i18n/index.ts
+ * [HERE]: core/platform/i18n/messages.ts - English message translations
+ */
+export declare const messages: {
+    error: string;
+    warning: string;
+    info: string;
+    success: string;
+    confirm: string;
+    cancel: string;
+    yes: string;
+    no: string;
+    ok: string;
+    save: string;
+    close: string;
+    retry: string;
+    loading: string;
+    newSession: string;
+    continueSession: string;
+    sessionSaved: string;
+    sessionLoaded: string;
+    noSessions: string;
+    settings: string;
+    language: string;
+    theme: string;
+    model: string;
+    thinkingLevel: string;
+    selectModel: string;
+    modelChanged: string;
+    noModelsAvailable: string;
+    apiKeyRequired: string;
+    enterApiKey: string;
+    apiKeySaved: string;
+    apiKeyInvalid: string;
+    extensions: string;
+    extensionEnabled: string;
+    extensionDisabled: string;
+    extensionError: string;
+    memory: string;
+    memoryUpdated: string;
+    memoryCleared: string;
+    errorOccurred: string;
+    tryAgain: string;
+    networkError: string;
+    timeoutError: string;
+    confirmQuit: string;
+    confirmNewSession: string;
+    confirmDelete: string;
+    presence: {
+        opening: string[];
+        idle: string[];
+    };
+};

package/dist/core/platform/i18n/messages.js

@@ -0,0 +1 @@
+const e={error:"Error",warning:"Warning",info:"Info",success:"Success",confirm:"Confirm",cancel:"Cancel",yes:"Yes",no:"No",ok:"OK",save:"Save",close:"Close",retry:"Retry",loading:"Loading...",newSession:"New session",continueSession:"Continue session",sessionSaved:"Session saved",sessionLoaded:"Session loaded",noSessions:"No sessions found",settings:"Settings",language:"Language",theme:"Theme",model:"Model",thinkingLevel:"Thinking Level",selectModel:"Select Model",modelChanged:"Model changed to",noModelsAvailable:"No models available",apiKeyRequired:"API key required",enterApiKey:"Enter your API key",apiKeySaved:"API key saved",apiKeyInvalid:"Invalid API key",extensions:"Extensions",extensionEnabled:"Extension enabled",extensionDisabled:"Extension disabled",extensionError:"Extension error",memory:"Memory",memoryUpdated:"Memory updated",memoryCleared:"Memory cleared",errorOccurred:"An error occurred",tryAgain:"Please try again",networkError:"Network error",timeoutError:"Request timeout",confirmQuit:"Are you sure you want to quit?",confirmNewSession:"Start a new session? Current session will be saved.",confirmDelete:"Are you sure you want to delete?",presence:{opening:["Hey, what's up?","Ready when you are.","What do you want to work on?","Any ideas?","Let's do this."],idle:["Still here when you need me.","No rush, take your time.","Ready when you are.","I'll be here.","Whenever you're ready."]}};export{e as messages};

package/dist/core/platform/i18n/messages.zh.d.ts

@@ -0,0 +1,56 @@
+/**
+ * [WHO]: messages - Chinese translations for user-facing messages
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/platform/i18n/index.ts
+ * [HERE]: core/platform/i18n/messages.zh.ts - Chinese message translations
+ */
+export declare const messages: {
+    error: string;
+    warning: string;
+    info: string;
+    success: string;
+    confirm: string;
+    cancel: string;
+    yes: string;
+    no: string;
+    ok: string;
+    save: string;
+    close: string;
+    retry: string;
+    loading: string;
+    newSession: string;
+    continueSession: string;
+    sessionSaved: string;
+    sessionLoaded: string;
+    noSessions: string;
+    settings: string;
+    language: string;
+    theme: string;
+    model: string;
+    thinkingLevel: string;
+    selectModel: string;
+    modelChanged: string;
+    noModelsAvailable: string;
+    apiKeyRequired: string;
+    enterApiKey: string;
+    apiKeySaved: string;
+    apiKeyInvalid: string;
+    extensions: string;
+    extensionEnabled: string;
+    extensionDisabled: string;
+    extensionError: string;
+    memory: string;
+    memoryUpdated: string;
+    memoryCleared: string;
+    errorOccurred: string;
+    tryAgain: string;
+    networkError: string;
+    timeoutError: string;
+    confirmQuit: string;
+    confirmNewSession: string;
+    confirmDelete: string;
+    presence: {
+        opening: string[];
+        idle: string[];
+    };
+};

package/dist/core/platform/i18n/messages.zh.js

@@ -0,0 +1 @@
+const e={error:"\u9519\u8BEF",warning:"\u8B66\u544A",info:"\u63D0\u793A",success:"\u6210\u529F",confirm:"\u786E\u8BA4",cancel:"\u53D6\u6D88",yes:"\u662F",no:"\u5426",ok:"\u786E\u5B9A",save:"\u4FDD\u5B58",close:"\u5173\u95ED",retry:"\u91CD\u8BD5",loading:"\u52A0\u8F7D\u4E2D...",newSession:"\u65B0\u4F1A\u8BDD",continueSession:"\u7EE7\u7EED\u4F1A\u8BDD",sessionSaved:"\u4F1A\u8BDD\u5DF2\u4FDD\u5B58",sessionLoaded:"\u4F1A\u8BDD\u5DF2\u52A0\u8F7D",noSessions:"\u672A\u627E\u5230\u4F1A\u8BDD",settings:"\u8BBE\u7F6E",language:"\u8BED\u8A00",theme:"\u4E3B\u9898",model:"\u6A21\u578B",thinkingLevel:"\u601D\u8003\u7EA7\u522B",selectModel:"\u9009\u62E9\u6A21\u578B",modelChanged:"\u6A21\u578B\u5DF2\u5207\u6362\u4E3A",noModelsAvailable:"\u6CA1\u6709\u53EF\u7528\u6A21\u578B",apiKeyRequired:"\u9700\u8981 API \u5BC6\u94A5",enterApiKey:"\u8BF7\u8F93\u5165\u60A8\u7684 API \u5BC6\u94A5",apiKeySaved:"API \u5BC6\u94A5\u5DF2\u4FDD\u5B58",apiKeyInvalid:"\u65E0\u6548\u7684 API \u5BC6\u94A5",extensions:"\u6269\u5C55",extensionEnabled:"\u6269\u5C55\u5DF2\u542F\u7528",extensionDisabled:"\u6269\u5C55\u5DF2\u7981\u7528",extensionError:"\u6269\u5C55\u9519\u8BEF",memory:"\u8BB0\u5FC6",memoryUpdated:"\u8BB0\u5FC6\u5DF2\u66F4\u65B0",memoryCleared:"\u8BB0\u5FC6\u5DF2\u6E05\u9664",errorOccurred:"\u53D1\u751F\u9519\u8BEF",tryAgain:"\u8BF7\u91CD\u8BD5",networkError:"\u7F51\u7EDC\u9519\u8BEF",timeoutError:"\u8BF7\u6C42\u8D85\u65F6",confirmQuit:"\u786E\u5B9A\u8981\u9000\u51FA\u5417\uFF1F",confirmNewSession:"\u5F00\u59CB\u65B0\u4F1A\u8BDD\uFF1F\u5F53\u524D\u4F1A\u8BDD\u5C06\u88AB\u4FDD\u5B58\u3002",confirmDelete:"\u786E\u5B9A\u8981\u5220\u9664\u5417\uFF1F",presence:{opening:["\u6765\u4E86\u554A\u3002","\u563F\uFF0C\u6709\u4EC0\u4E48\u60F3\u505A\u7684\u5417\uFF1F","\u51C6\u5907\u5F00\u59CB\u5427\u3002","\u968F\u65F6\u53EF\u4EE5\u5F00\u59CB\u3002","\u6709\u4EC0\u4E48\u8981\u804A\u804A\u7684\u5417\uFF1F"],idle:["\u8FD8\u5728\uFF0C\u6709\u9700\u8981\u968F\u65F6\u8BF4\u3002","\u4E0D\u6025\uFF0C\u6162\u6162\u6765\u3002","\u6211\u5728\uFF0C\u968F\u65F6\u7EE7\u7EED\u3002","\u6709\u7A7A\u4E86\u5C31\u7EE7\u7EED\u5427\u3002","\u6CA1\u5173\u7CFB\u7684\uFF0C\u60F3\u4EC0\u4E48\u65F6\u5019\u7EE7\u7EED\u90FD\u884C\u3002"]}};export{e as messages};

package/dist/core/platform/i18n/slash-commands.d.ts

@@ -0,0 +1,53 @@
+/**
+ * [WHO]: slashCommands - English translations for slash command descriptions
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/platform/i18n/index.ts
+ * [HERE]: core/platform/i18n/slash-commands.ts - English slash command translations
+ */
+export declare const slashCommands: {
+    categories: {
+        core: string;
+        model: string;
+        memory: string;
+        session: string;
+        workflow: string;
+        agents: string;
+        tools: string;
+        admin: string;
+    };
+    settings: string;
+    model: string;
+    thinking: string;
+    "agent-loop": string;
+    "scoped-models": string;
+    apikey: string;
+    mcp: string;
+    soul: string;
+    persona: string;
+    memory: string;
+    dream: string;
+    browser: string;
+    export: string;
+    share: string;
+    copy: string;
+    name: string;
+    session: string;
+    status: string;
+    usage: string;
+    changelog: string;
+    hotkeys: string;
+    resources: string;
+    fork: string;
+    tree: string;
+    login: string;
+    logout: string;
+    new: string;
+    update: string;
+    reinstall: string;
+    compact: string;
+    resume: string;
+    reload: string;
+    "link-world": string;
+    quit: string;
+    language: string;
+};

package/dist/core/platform/i18n/slash-commands.js

@@ -0,0 +1 @@
+const e={categories:{core:"Core",model:"Models",memory:"Memory",session:"Sessions",workflow:"Workflows",agents:"Agents",tools:"Tools",admin:"Admin"},settings:"Open settings menu",model:"Select model (opens selector UI)",thinking:"Choose reasoning depth for the current model","agent-loop":"Choose how the agent keeps working through a task","scoped-models":"Choose which models appear in quick switching",apikey:"Update API key for current provider",mcp:"Manage MCP servers (list, enable, disable)",soul:"Show AI personality and stats (Soul)",persona:"Switch AI persona/personality pack",memory:"Show project memory and knowledge (NanoMem)",dream:"Refresh long-term project memory (NanoMem)",browser:"Enable or inspect browser automation tools",export:"Export session to HTML file",share:"Share session as a secret GitHub gist",copy:"Copy last agent message to clipboard",name:"Set session display name",session:"Show session info and stats",status:"Show agent status card (model, directory, session, usage)",usage:"Show token usage and cost stats",changelog:"Show changelog entries",hotkeys:"Show all keyboard shortcuts",resources:"Show loaded extensions, prompts, skills, and themes",fork:"Create a new fork from a previous message",tree:"Navigate session tree (switch branches)",login:"Login with OAuth provider",logout:"Logout from OAuth provider",new:"Start a new session",update:"Check for Catui updates",reinstall:"Force reinstall Catui (clean install)",compact:"Manually compact the session context",resume:"Resume a different session",reload:"Reload extensions, skills, prompts, and themes","link-world":"Set up internet access tools",quit:"Quit Catui",language:"Switch language (English/Chinese)"};export{e as slashCommands};