mocode-ai 0.4.7 → 0.4.9

package/dist/ui/spinner.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 等待动画:在 await 长操作(chat / 工具执行 / 压缩)时旋转,避免「卡死」错觉。
+ *
+ * 两种渲染模式:
+ *  - onFrame 回调(TUI 态):帧经回调刷状态行(layout.drawStatusBar),内容区保持静止、底栏转圈;
+ *    不在内容行用 \r\x1B[K 原地刷(那会擦内容、与滚动区域冲突)。
+ *  - 无回调(非 TTY / 旧路径):\r\x1B[K 原地刷 braille 帧;非 TTY 退化为启动时打印一行静态提示。
+ *
+ * stop() 仅在确实旋转过(有 timer)时清场,避免对从未 start 的实例误清状态行。
+ */
+export declare class Spinner {
+    private readonly onFrame?;
+    private timer;
+    private frame;
+    private msg;
+    constructor(onFrame?: ((msg: string, frame: string | null) => void) | undefined);
+    start(msg: string): void;
+    private render;
+    stop(): void;
+    /**
+     * 暂停当前活跃 spinner(供 ask_human 介入面板进入前停转,避免 onFrame 覆盖面板)。
+     * 未转则 no-op(stop 内 `!this.timer` 守护);停转时 onFrame(msg,null) 触发 clearLiveAtCursor 清续写位帧。
+     * 不 resume——ask_human 的活儿就是面板本身,退出后 agent 的 spinner.stop() 是 no-op,下一轮 start 自然重启。
+     */
+    static pauseCurrent(): void;
+}

package/dist/ui/theme.d.ts

@@ -0,0 +1,47 @@
+/** 可切换的颜色字段(属性 bold/dim/reverse/reset 跨主题不变,不在此)。 */
+export interface Palette {
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    gray: string;
+    brightCyan: string;
+    brightMagenta: string;
+    /** 用户消息满宽背景色(上滑时易辨认)。 */
+    userBg: string;
+    /** diff 新增行整行底色——浅深主题下都柔和可辨,跟绿字 fg 配对;SGR 自洽,每行 reset 闭合。 */
+    addBg: string;
+    /** diff 删除行整行底色——同 addBg,跟红字 fg 配对。 */
+    delBg: string;
+}
+export type ColorKey = keyof Palette;
+/**
+ * 切主题。name 未知则回退 default(不抛——启动时 config.theme 可能是用户填的任意值)。
+ * 仅当实际变更时自增 version(供缓存失效)。 */
+export declare function setTheme(name: string): void;
+export declare function getTheme(): string;
+export declare function listThemes(): string[];
+export declare function themeExists(name: string): boolean;
+/** 主题版本号,每次 setTheme 实际变更自增;供 markdown MEMO 等缓存按版本失效。 */
+export declare function getThemeVersion(): number;
+export declare const ui: {
+    isTTY: boolean;
+    reset: string;
+    bold: string;
+    dim: string;
+    reverse: string;
+    readonly red: string;
+    readonly green: string;
+    readonly yellow: string;
+    readonly blue: string;
+    readonly magenta: string;
+    readonly cyan: string;
+    readonly gray: string;
+    readonly brightCyan: string;
+    readonly brightMagenta: string;
+    readonly userBg: string;
+    readonly addBg: string;
+    readonly delBg: string;
+};

package/dist/updater/index.d.ts

@@ -0,0 +1,22 @@
+export interface UpdateCache {
+    lastCheck?: number;
+    latest?: string;
+    lastSpawn?: number;
+}
+/** 简易 semver 比较(只管 X.Y.Z 数字,无 pre-release):a>b 返正,a<b 返负,等返 0。 */
+export declare function compareSemver(a: string, b: string): number;
+export interface UpdateDecision {
+    notice: string | null;
+    spawn: boolean;
+    refresh: boolean;
+}
+/** 纯决策:据当前版本 / 缓存 / 时间,算是否提示 / spawn / 后台刷新。无副作用,可离线测。
+ *  notice 同时携带当前版本(`current`)与最新版本(`latest`),让 REPL 提示能向用户
+ *  清晰展示"你正在用的 mocode 是 X,最新是 Y",不只是单调的"有新版本"。 */
+export declare function evaluateUpdate(current: string, cache: UpdateCache, now: number): UpdateDecision;
+/**
+ * 启动时调(同步,零延迟):返一行纯文本更新提示或 null。
+ * 流程:dev 跳过 → 读当前版本 → 读缓存 → evaluateUpdate 决策 → 按需后台刷新 / spawn → 返提示。
+ * 提示由 repl 上色写入内容区开场段(进 INPUT 态前)。
+ */
+export declare function checkAndMaybeUpdate(): string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mocode-ai",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {