@cjhyy/code-shell 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/llm/model-pool.d.ts

@@ -24,6 +24,8 @@ export interface ModelEntry {
     baseUrl?: string;
     apiKey?: string;
     maxOutputTokens?: number;
+    /** Per-model context window size. Falls back to config.maxContextTokens → 200_000. */
+    maxContextTokens?: number;
 }
 export declare class ModelPool {
     private models;
@@ -35,6 +37,8 @@ export declare class ModelPool {
     constructor(entries?: ModelEntry[], defaultKey?: string);
     /** Register a model at runtime. */
     register(entry: ModelEntry): void;
+    /** Fill in known defaults (e.g. context window for DeepSeek V4) when the entry doesn't specify them. */
+    private withBuiltinDefaults;
     /** Switch the active model. Throws if key not found. */
     switch(key: string): ModelEntry;
     /** Get a model by key. No key = active model. Returns undefined if not found. */

package/dist/logging/logger.d.ts

@@ -1,19 +1,80 @@
 /**
- * Simple file logger for debug/runtime logs.
+ * Unified file logger for code-shell.
  *
- * Logs go to ~/.code-shell/logs/YYYY-MM-DD.log
+ * Single sink: ~/.code-shell/logs/YYYY-MM-DD.log (JSON Lines).
+ *
+ * Level defaults:
+ *   - Local dev (CODE_SHELL_DEV=1, or running from src/, or --debug)   → "debug"
+ *   - Otherwise                                                         → "info"
+ *   - CODE_SHELL_LOG_LEVEL overrides everything.
+ *
+ * Category filter (--debug=mcp,api or CODE_SHELL_DEBUG=mcp,api):
+ *   When set, only logs whose `cat` matches are written.
+ *
+ * Disable entirely: CODE_SHELL_LOG=0
  */
 export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setCurrentSid(sid: string): void;
+export declare function getCurrentSid(): string;
+export declare function getInMemoryErrors(): ReadonlyArray<{
+    msg: string;
+    t: string;
+    data?: unknown;
+}>;
+export type ErrorLogSink = {
+    logError: (error: Error) => void;
+    logMCPError: (serverName: string, error: unknown) => void;
+    logMCPDebug: (serverName: string, message: string) => void;
+    getErrorsPath: () => string;
+    getMCPLogsPath: (serverName: string) => string;
+};
+export declare function attachErrorLogSink(sink: ErrorLogSink): void;
+export interface LogContext {
+    cat?: string;
+    sid?: string;
+    [key: string]: unknown;
+}
 declare class Logger {
-    private logDir;
-    private minLevel;
-    private enabled;
-    constructor();
+    private readonly context;
+    private readonly enabled;
+    private readonly minLevel;
+    private readonly categoryFilter;
+    private readonly stderrEcho;
+    private dirReady;
+    constructor(context?: LogContext);
+    child(extra: LogContext): Logger;
+    /**
+     * Set the session id stamped on every subsequent log entry written by
+     * any logger in the process. Called by Engine once a run's
+     * authoritative session id is known.
+     */
+    setSid(sid: string): void;
+    getSid(): string;
     debug(msg: string, data?: Record<string, unknown>): void;
     info(msg: string, data?: Record<string, unknown>): void;
     warn(msg: string, data?: Record<string, unknown>): void;
-    error(msg: string, data?: Record<string, unknown>): void;
-    private log;
+    error(msgOrErr: string | Error | unknown, data?: Record<string, unknown> | Error): void;
+    private recordError;
+    private write;
+    getMinLevel(): LogLevel;
+    isCategoryActive(cat: string): boolean;
+    /**
+     * Open a span: writes a `<name>.begin` debug entry now and returns a handle
+     * whose `end()` writes `<name>.end` with `duration_ms` populated. Use for
+     * any "I want begin → end + how long" pattern (tool exec, LLM request,
+     * permission ask, etc.) so the begin/end pair is grouped under one cat
+     * and the duration is computed once instead of by hand from timestamps.
+     */
+    span(name: string, data?: Record<string, unknown>): LogSpan;
+}
+export interface LogSpan {
+    end(extra?: Record<string, unknown>): void;
+    fail(err: unknown, extra?: Record<string, unknown>): void;
 }
 export declare const logger: Logger;
+export declare function getLogsDir(): string;
+export declare function getRecentLogs(n?: number): string[];
+export declare function rotateLogs(): void;
+/** @internal — for tests */
+export declare function _resetLoggerStateForTesting(): void;
 export {};

package/dist/manager-FWLOVEEK.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkFV2ARONZcjs = require('./chunk-FV2ARONZ.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+exports.SettingsManager = _chunkFV2ARONZcjs.SettingsManager;

package/dist/manager-GEXJLOIS.js

@@ -0,0 +1,7 @@
+import {
+  SettingsManager
+} from "./chunk-75E4BBFC.js";
+import "./chunk-DI7RDLOS.js";
+export {
+  SettingsManager
+};

package/dist/{mcp-manager-OKXHHWYR.js → mcp-manager-37GQLFGX.js}

@@ -1,7 +1,7 @@
 import {
   MCPManager
-} from "./chunk-BE6IPRDM.js";
-import "./chunk-X4HAERTQ.js";
+} from "./chunk-2EUAE7AY.js";
+import "./chunk-ZRVPCXI7.js";
 import "./chunk-DI7RDLOS.js";
 export {
   MCPManager

package/dist/mcp-manager-U77NEXBY.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkC7C7ZZY4cjs = require('./chunk-C7C7ZZY4.cjs');
+require('./chunk-JHNCK7JP.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+exports.MCPManager = _chunkC7C7ZZY4cjs.MCPManager;

package/dist/memory-ADGOWADP.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkM2QI5X3Xcjs = require('./chunk-M2QI5X3X.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+
+exports.MemoryManager = _chunkM2QI5X3Xcjs.MemoryManager; exports.resolveMemoryBaseDir = _chunkM2QI5X3Xcjs.resolveMemoryBaseDir;

package/dist/memory-EPFDBPII.js

@@ -0,0 +1,9 @@
+import {
+  MemoryManager,
+  resolveMemoryBaseDir
+} from "./chunk-I57ZD5IQ.js";
+import "./chunk-DI7RDLOS.js";
+export {
+  MemoryManager,
+  resolveMemoryBaseDir
+};

package/dist/native-ts/yoga-layout/index.d.ts

@@ -1,10 +1,10 @@
 /**
  * Pure-TypeScript port of yoga-layout (Meta's flexbox engine).
  *
- * This matches the `yoga-layout/load` API surface used by src/ink/layout/yoga.ts.
+ * This matches the `yoga-layout/load` API surface used by src/render/layout/yoga.ts.
  * The upstream C++ source is ~2500 lines in CalculateLayout.cpp alone; this port
  * is a simplified single-pass flexbox implementation that covers the subset of
- * features Ink actually uses:
+ * features the render engine actually uses:
  *   - flex-direction (row/column + reverse)
  *   - flex-grow / flex-shrink / flex-basis
  *   - align-items / align-self (stretch, flex-start, center, flex-end)

package/dist/{openai-5HQGBL4L.js → openai-RXU5URYI.js}

@@ -1,8 +1,9 @@
 import {
   OpenAIClient
-} from "./chunk-VKGNCYRL.js";
-import "./chunk-O6F2EF2Z.js";
+} from "./chunk-LMEKCQX4.js";
+import "./chunk-SCDKLTN3.js";
 import "./chunk-FUOKLKR2.js";
+import "./chunk-ZRVPCXI7.js";
 import "./chunk-DI7RDLOS.js";
 export {
   OpenAIClient

package/dist/openai-SQW4H2K4.cjs

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYAFCN7ZWcjs = require('./chunk-YAFCN7ZW.cjs');
+require('./chunk-GZBD6QRS.cjs');
+require('./chunk-EL2RL5DG.cjs');
+require('./chunk-JHNCK7JP.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+exports.OpenAIClient = _chunkYAFCN7ZWcjs.OpenAIClient;

package/dist/openrouter-models-2FM3H4SQ.js

@@ -0,0 +1,15 @@
+import {
+  findOpenRouterModel,
+  getOpenRouterModels,
+  getOpenRouterSnapshot,
+  listOpenRouterModelsByVendor,
+  setOpenRouterSnapshot
+} from "./chunk-FPFTIKEJ.js";
+import "./chunk-DI7RDLOS.js";
+export {
+  findOpenRouterModel,
+  getOpenRouterModels,
+  getOpenRouterSnapshot,
+  listOpenRouterModelsByVendor,
+  setOpenRouterSnapshot
+};

package/dist/openrouter-models-PLCWZZYE.cjs

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkBF4LXLQVcjs = require('./chunk-BF4LXLQV.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+
+
+
+
+exports.findOpenRouterModel = _chunkBF4LXLQVcjs.findOpenRouterModel; exports.getOpenRouterModels = _chunkBF4LXLQVcjs.getOpenRouterModels; exports.getOpenRouterSnapshot = _chunkBF4LXLQVcjs.getOpenRouterSnapshot; exports.listOpenRouterModelsByVendor = _chunkBF4LXLQVcjs.listOpenRouterModelsByVendor; exports.setOpenRouterSnapshot = _chunkBF4LXLQVcjs.setOpenRouterSnapshot;

package/dist/openrouter-sync-K2WK3A2A.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkVIPLU4RYcjs = require('./chunk-VIPLU4RY.cjs');
+
+
+var _chunkBF4LXLQVcjs = require('./chunk-BF4LXLQV.cjs');
+require('./chunk-IJSHQGMP.cjs');
+
+
+
+exports.getOpenRouterSnapshot = _chunkBF4LXLQVcjs.getOpenRouterSnapshot; exports.syncOpenRouterCatalog = _chunkVIPLU4RYcjs.syncOpenRouterCatalog;

package/dist/openrouter-sync-SO3AWEAM.js

@@ -0,0 +1,11 @@
+import {
+  syncOpenRouterCatalog
+} from "./chunk-TDXBHD24.js";
+import {
+  getOpenRouterSnapshot
+} from "./chunk-FPFTIKEJ.js";
+import "./chunk-DI7RDLOS.js";
+export {
+  getOpenRouterSnapshot,
+  syncOpenRouterCatalog
+};

package/dist/product/index.cjs

@@ -1,23 +1,19 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkWYKNZ54Ecjs = require('../chunk-WYKNZ54E.cjs');
-require('../chunk-Q6BYFYGD.cjs');
+var _chunk3CAZIWUAcjs = require('../chunk-3CAZIWUA.cjs');
+require('../chunk-VWFET3MG.cjs');
+require('../chunk-KOGV6PDQ.cjs');
+require('../chunk-C7C7ZZY4.cjs');
+require('../chunk-YD7XTI7T.cjs');
+require('../chunk-M2QI5X3X.cjs');
+require('../chunk-OP57WUWQ.cjs');
+require('../chunk-FV2ARONZ.cjs');
 require('../chunk-3QR52LL5.cjs');
-require('../chunk-UK2SU23S.cjs');
-require('../chunk-FGZGCFJX.cjs');
-require('../chunk-JT2WSQSR.cjs');
-require('../chunk-BMH65OVB.cjs');
-require('../chunk-LRAY5IYC.cjs');
-require('../chunk-HD7MT5XU.cjs');
-require('../chunk-3EAEC566.cjs');
-require('../chunk-CSO5EOEP.cjs');
-require('../chunk-NG73UR3L.cjs');
-require('../chunk-3EUDE77E.cjs');
-require('../chunk-FVP7XJGS.cjs');
-require('../chunk-IMMTBZ33.cjs');
+require('../chunk-X2DNIMPC.cjs');
+require('../chunk-HOXQLX5R.cjs');
 require('../chunk-EL2RL5DG.cjs');
-require('../chunk-XHC2JMEC.cjs');
+require('../chunk-JHNCK7JP.cjs');
 require('../chunk-IJSHQGMP.cjs');
 
 
-exports.defineProduct = _chunkWYKNZ54Ecjs.defineProduct;
+exports.defineProduct = _chunk3CAZIWUAcjs.defineProduct;

package/dist/product/index.js

@@ -1,22 +1,18 @@
 import {
   defineProduct
-} from "../chunk-AP5F6VYE.js";
-import "../chunk-JUHRV2XF.js";
+} from "../chunk-REFCCVDM.js";
+import "../chunk-ID6EJUHP.js";
+import "../chunk-F5BS3GUC.js";
+import "../chunk-2EUAE7AY.js";
+import "../chunk-5C5HIOML.js";
+import "../chunk-I57ZD5IQ.js";
+import "../chunk-ZLPJJZUW.js";
+import "../chunk-75E4BBFC.js";
 import "../chunk-SK62UVS6.js";
-import "../chunk-KO2FPF7G.js";
-import "../chunk-6ZIROYXX.js";
-import "../chunk-OG4MIQJ6.js";
-import "../chunk-BE6IPRDM.js";
-import "../chunk-J5XW6UYL.js";
-import "../chunk-4RRUP4MM.js";
-import "../chunk-4PKZPFCD.js";
-import "../chunk-4SFPFHMG.js";
-import "../chunk-S74VVJBF.js";
-import "../chunk-ZXYDDJEJ.js";
-import "../chunk-SQZHPD3S.js";
-import "../chunk-X4HAERTQ.js";
+import "../chunk-OUC2DFA7.js";
+import "../chunk-Y7TSCDF6.js";
 import "../chunk-FUOKLKR2.js";
-import "../chunk-C7JBCO5V.js";
+import "../chunk-ZRVPCXI7.js";
 import "../chunk-DI7RDLOS.js";
 export {
   defineProduct

package/dist/protocol/types.d.ts

@@ -79,11 +79,11 @@ export interface ConfigureParams {
 }
 /** Query server state. */
 export interface QueryParams {
-    type: "sessions" | "tools" | "config" | "session_detail" | "compact" | "config_set" | "models";
+    type: "sessions" | "tools" | "config" | "session_detail" | "compact" | "config_set" | "config_get" | "permission_set" | "models" | "arena_status";
     sessionId?: string;
-    /** Used by config_set: dotted key path */
+    /** Used by config_set / permission_set: dotted key path or mode field */
     key?: string;
-    /** Used by config_set: new value */
+    /** Used by config_set / permission_set: new value */
     value?: unknown;
 }
 export interface QueryResult {
@@ -107,6 +107,14 @@ export interface ToolListResult {
         description: string;
     }>;
 }
+/** Shape of a model-pool entry returned by query("models"). */
+export interface ProtocolModelEntry {
+    key: string;
+    label: string;
+    model: string;
+    provider: string;
+    active: boolean;
+}
 export interface ConfigResult {
     permissionMode: PermissionMode;
     planMode: boolean;

package/dist/{ink → render}/hooks/use-input.d.ts

@@ -16,7 +16,7 @@ type Options = {
  * However, if user pastes text and it's more than one character, the callback will be called only once and the whole string will be passed as `input`.
  *
  * ```
- * import {useInput} from 'ink';
+ * import {useInput} from '@/render';
  *
  * const UserInput = () => {
  *   useInput((input, key) => {

package/dist/run/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkMOILS4WEcjs = require('../chunk-MOILS4WE.cjs');
+var _chunkJHXNOB5Gcjs = require('../chunk-JHXNOB5G.cjs');
 
 
 
@@ -15,22 +15,18 @@ var _chunkMOILS4WEcjs = require('../chunk-MOILS4WE.cjs');
 
 
 
-var _chunkQ6BYFYGDcjs = require('../chunk-Q6BYFYGD.cjs');
+var _chunkVWFET3MGcjs = require('../chunk-VWFET3MG.cjs');
+require('../chunk-KOGV6PDQ.cjs');
+require('../chunk-C7C7ZZY4.cjs');
+require('../chunk-YD7XTI7T.cjs');
+require('../chunk-M2QI5X3X.cjs');
+require('../chunk-OP57WUWQ.cjs');
+require('../chunk-FV2ARONZ.cjs');
 require('../chunk-3QR52LL5.cjs');
-require('../chunk-UK2SU23S.cjs');
-require('../chunk-FGZGCFJX.cjs');
-require('../chunk-JT2WSQSR.cjs');
-require('../chunk-BMH65OVB.cjs');
-require('../chunk-LRAY5IYC.cjs');
-require('../chunk-HD7MT5XU.cjs');
-require('../chunk-3EAEC566.cjs');
-require('../chunk-CSO5EOEP.cjs');
-require('../chunk-NG73UR3L.cjs');
-require('../chunk-3EUDE77E.cjs');
-require('../chunk-FVP7XJGS.cjs');
-require('../chunk-IMMTBZ33.cjs');
+require('../chunk-X2DNIMPC.cjs');
+require('../chunk-HOXQLX5R.cjs');
 require('../chunk-EL2RL5DG.cjs');
-require('../chunk-XHC2JMEC.cjs');
+require('../chunk-JHNCK7JP.cjs');
 require('../chunk-IJSHQGMP.cjs');
 
 
@@ -47,4 +43,4 @@ require('../chunk-IJSHQGMP.cjs');
 
 
 
-exports.ArtifactTracker = _chunkQ6BYFYGDcjs.ArtifactTracker; exports.CheckpointWriter = _chunkQ6BYFYGDcjs.CheckpointWriter; exports.CompositeEvaluator = _chunkQ6BYFYGDcjs.CompositeEvaluator; exports.EngineRunner = _chunkQ6BYFYGDcjs.EngineRunner; exports.FileRunStore = _chunkQ6BYFYGDcjs.FileRunStore; exports.Heartbeat = _chunkQ6BYFYGDcjs.Heartbeat; exports.NoopEvaluator = _chunkQ6BYFYGDcjs.NoopEvaluator; exports.RunApprovalBackend = _chunkQ6BYFYGDcjs.RunApprovalBackend; exports.RunLock = _chunkQ6BYFYGDcjs.RunLock; exports.RunManager = _chunkQ6BYFYGDcjs.RunManager; exports.RunQueue = _chunkQ6BYFYGDcjs.RunQueue; exports.VALID_TRANSITIONS = _chunkQ6BYFYGDcjs.VALID_TRANSITIONS; exports.createRunAskUserFn = _chunkQ6BYFYGDcjs.createRunAskUserFn; exports.createRunManager = _chunkMOILS4WEcjs.createRunManager;
+exports.ArtifactTracker = _chunkVWFET3MGcjs.ArtifactTracker; exports.CheckpointWriter = _chunkVWFET3MGcjs.CheckpointWriter; exports.CompositeEvaluator = _chunkVWFET3MGcjs.CompositeEvaluator; exports.EngineRunner = _chunkVWFET3MGcjs.EngineRunner; exports.FileRunStore = _chunkVWFET3MGcjs.FileRunStore; exports.Heartbeat = _chunkVWFET3MGcjs.Heartbeat; exports.NoopEvaluator = _chunkVWFET3MGcjs.NoopEvaluator; exports.RunApprovalBackend = _chunkVWFET3MGcjs.RunApprovalBackend; exports.RunLock = _chunkVWFET3MGcjs.RunLock; exports.RunManager = _chunkVWFET3MGcjs.RunManager; exports.RunQueue = _chunkVWFET3MGcjs.RunQueue; exports.VALID_TRANSITIONS = _chunkVWFET3MGcjs.VALID_TRANSITIONS; exports.createRunAskUserFn = _chunkVWFET3MGcjs.createRunAskUserFn; exports.createRunManager = _chunkJHXNOB5Gcjs.createRunManager;

package/dist/run/index.js

@@ -1,6 +1,6 @@
 import {
   createRunManager
-} from "../chunk-FECTK5KJ.js";
+} from "../chunk-SW3L7HIM.js";
 import {
   ArtifactTracker,
   CheckpointWriter,
@@ -15,22 +15,18 @@ import {
   RunQueue,
   VALID_TRANSITIONS,
   createRunAskUserFn
-} from "../chunk-JUHRV2XF.js";
+} from "../chunk-ID6EJUHP.js";
+import "../chunk-F5BS3GUC.js";
+import "../chunk-2EUAE7AY.js";
+import "../chunk-5C5HIOML.js";
+import "../chunk-I57ZD5IQ.js";
+import "../chunk-ZLPJJZUW.js";
+import "../chunk-75E4BBFC.js";
 import "../chunk-SK62UVS6.js";
-import "../chunk-KO2FPF7G.js";
-import "../chunk-6ZIROYXX.js";
-import "../chunk-OG4MIQJ6.js";
-import "../chunk-BE6IPRDM.js";
-import "../chunk-J5XW6UYL.js";
-import "../chunk-4RRUP4MM.js";
-import "../chunk-4PKZPFCD.js";
-import "../chunk-4SFPFHMG.js";
-import "../chunk-S74VVJBF.js";
-import "../chunk-ZXYDDJEJ.js";
-import "../chunk-SQZHPD3S.js";
-import "../chunk-X4HAERTQ.js";
+import "../chunk-OUC2DFA7.js";
+import "../chunk-Y7TSCDF6.js";
 import "../chunk-FUOKLKR2.js";
-import "../chunk-C7JBCO5V.js";
+import "../chunk-ZRVPCXI7.js";
 import "../chunk-DI7RDLOS.js";
 export {
   ArtifactTracker,

package/dist/session/memory.d.ts

@@ -1,7 +1,12 @@
 /**
  * Memory system — persistent cross-session memory.
  *
- * Stores structured memory entries in ~/.code-shell/memory/ as individual markdown files.
+ * Stores structured memory entries as individual markdown files under a base
+ * directory. Resolution order for the base directory:
+ *   1. explicit `baseDir` constructor arg
+ *   2. CODE_SHELL_HOME env var
+ *   3. ~/.code-shell
+ *
  * MEMORY.md is the index file.
  */
 export interface MemoryEntry {
@@ -11,10 +16,19 @@ export interface MemoryEntry {
     content: string;
     fileName: string;
 }
+export interface MemoryManagerOptions {
+    /** Project root path; when set, memories are scoped under projects/<hash>/memory. */
+    projectDir?: string;
+    /** Override the base directory (~/.code-shell by default). Takes precedence over env. */
+    baseDir?: string;
+}
+export declare function resolveMemoryBaseDir(override?: string): string;
 export declare class MemoryManager {
+    private readonly baseDir;
     private readonly memoryDir;
     private readonly indexPath;
-    constructor(projectDir?: string);
+    private indexCache;
+    constructor(options?: MemoryManagerOptions | string);
     getMemoryDir(): string;
     /**
      * Save a memory entry. Creates the file and updates the index.
@@ -40,6 +54,12 @@ export declare class MemoryManager {
      * Build a prompt-friendly summary of all memories.
      */
     buildMemoryContext(): string;
-    private updateIndex;
+    /**
+     * Lazy-build the in-memory index from disk on first use, then
+     * keep it in sync incrementally via save/delete. Avoids the
+     * O(N²) re-read of every memory file on every save.
+     */
+    private ensureIndexCache;
+    private writeIndex;
     private slugify;
 }

package/dist/session/session-manager.d.ts

@@ -19,5 +19,8 @@ export declare class SessionManager {
      * then diverges independently.
      */
     fork(sourceSessionId: string, forkAtTurn?: number): SessionBundle;
-    list(limit?: number): SessionState[];
+    list(limit?: number): SessionListEntry[];
 }
+export type SessionListEntry = SessionState & {
+    preview?: string;
+};

package/dist/{session-manager-UQKB564H.cjs → session-manager-HRSKENKB.cjs}

@@ -1,8 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkNG73UR3Lcjs = require('./chunk-NG73UR3L.cjs');
+var _chunkOP57WUWQcjs = require('./chunk-OP57WUWQ.cjs');
 require('./chunk-EL2RL5DG.cjs');
 require('./chunk-IJSHQGMP.cjs');
 
 
-exports.SessionManager = _chunkNG73UR3Lcjs.SessionManager;
+exports.SessionManager = _chunkOP57WUWQcjs.SessionManager;

package/dist/{session-manager-JIIBCFTC.js → session-manager-NEKFEHF3.js}

@@ -1,6 +1,6 @@
 import {
   SessionManager
-} from "./chunk-S74VVJBF.js";
+} from "./chunk-ZLPJJZUW.js";
 import "./chunk-FUOKLKR2.js";
 import "./chunk-DI7RDLOS.js";
 export {

package/dist/settings/manager.d.ts

@@ -22,6 +22,15 @@ export declare class SettingsManager {
      * Invalidate cached merge.
      */
     invalidate(): void;
+    /**
+     * Persist a single setting (dotted key path) to the user-level config file
+     * at ~/.code-shell/settings.json. Other sources (project / local /
+     * managed) are intentionally untouched: writing back to project/local
+     * would surprise version control, and managed is read-only.
+     *
+     * The merged cache is invalidated so the next get() picks up the change.
+     */
+    saveUserSetting(key: string, value: unknown): void;
     private loadJsonFile;
     private deepMerge;
 }