thatgfsj-code 0.3.0 → 0.3.1

package/dist/repl/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * REPL Module
+ * Interactive input/output handling
+ */
+export { REPLInput } from './input.js';
+export { REPLOutput } from './output.js';
+export { REPLLoop } from './loop.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repl/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/repl/index.js

@@ -0,0 +1,8 @@
+/**
+ * REPL Module
+ * Interactive input/output handling
+ */
+export { REPLInput } from './input.js';
+export { REPLOutput } from './output.js';
+export { REPLLoop } from './loop.js';
+//# sourceMappingURL=index.js.map

package/dist/repl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repl/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/repl/input.d.ts

@@ -0,0 +1,69 @@
+/**
+ * REPL Input Handler
+ *
+ * 基于 @inquirer/input 实现，支持：
+ *   - 方向键（含数字小键盘方向键）行内移动 / 跳转词首尾
+ *   - Home / End / Backspace / Delete 行内编辑
+ *   - Ctrl+A / Ctrl+E 跳到行首/行尾（emacs 风格）
+ *   - Ctrl+C 中断当前输入（不清空整个会话），连续按两次空输入退出
+ *   - 命令历史：本地维护 history 数组，通过 default 预填上一条
+ *
+ * 不再使用 Node 内置 readline 的 rl.question()——它在 Windows 终端下
+ * 对小键盘方向键的 ANSI 转义序列不友好，会导致光标无法移动 (Bug #1)。
+ */
+export type PromptResult = {
+    kind: 'value';
+    value: string;
+} | {
+    kind: 'cancelled';
+};
+export declare class REPLInput {
+    private history;
+    private historyIndex;
+    private currentDraft;
+    private defaultPrefix;
+    private consecutiveCancels;
+    /**
+     * Ask the user for input. Returns either a value or 'cancelled'.
+     * Loop decides what to do with cancellation (usually: continue session,
+     * unless user has cancelled an already-empty input twice in a row).
+     */
+    prompt(prefix?: string, abortSignal?: AbortSignal): Promise<PromptResult>;
+    /**
+     * Should we ask the loop to exit? Two consecutive Ctrl+C on empty input => exit.
+     */
+    shouldExitOnCancel(): boolean;
+    /**
+     * Programmatic cancel trigger (used by the global SIGINT handler in REPLLoop).
+     * Increments the cancel counter as if a Ctrl+C had been seen, and returns
+     * whether the loop should now exit. Idempotent across the prompt() flow:
+     * if the user has already entered a non-empty prompt this is a no-op for exit
+     * (the loop keeps running) — but for an empty REPL it eventually returns true.
+     */
+    requestCancel(): boolean;
+    /**
+     * Reset consecutive-cancel counter when the loop has decided to keep running.
+     */
+    resetCancelCounter(): void;
+    /**
+     * Decide what to prefill. Two modes:
+     *   - 'history': when user is navigating up/down with arrows
+     *   - 'draft':   when user has cleared the input — preserve their draft
+     */
+    private computePrefill;
+    /**
+     * Save the user's in-progress draft so ↑↓ preserves their unsent typing.
+     */
+    saveDraft(text: string): void;
+    /**
+     * Navigate up in history (called from a global key listener, if needed).
+     */
+    historyUp(): string;
+    /**
+     * Navigate down in history.
+     */
+    historyDown(): string;
+    getHistory(): readonly string[];
+    clearHistory(): void;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/repl/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/repl/input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,kBAAkB,CAAa;IAEvC;;;;OAIG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqC/E;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;;;;;OAMG;IACH,aAAa,IAAI,OAAO;IAMxB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;OAEG;IACH,WAAW,IAAI,MAAM;IAWrB,UAAU,IAAI,SAAS,MAAM,EAAE;IAI/B,YAAY,IAAI,IAAI;CAIrB"}

package/dist/repl/input.js

@@ -0,0 +1,139 @@
+/**
+ * REPL Input Handler
+ *
+ * 基于 @inquirer/input 实现，支持：
+ *   - 方向键（含数字小键盘方向键）行内移动 / 跳转词首尾
+ *   - Home / End / Backspace / Delete 行内编辑
+ *   - Ctrl+A / Ctrl+E 跳到行首/行尾（emacs 风格）
+ *   - Ctrl+C 中断当前输入（不清空整个会话），连续按两次空输入退出
+ *   - 命令历史：本地维护 history 数组，通过 default 预填上一条
+ *
+ * 不再使用 Node 内置 readline 的 rl.question()——它在 Windows 终端下
+ * 对小键盘方向键的 ANSI 转义序列不友好，会导致光标无法移动 (Bug #1)。
+ */
+import input from '@inquirer/input';
+import chalk from 'chalk';
+const MAX_HISTORY = 200;
+export class REPLInput {
+    history = [];
+    historyIndex = -1; // -1 表示"未在历史中浏览"
+    currentDraft = ''; // 离开历史时保留用户原始草稿
+    defaultPrefix = chalk.green('\n> ');
+    consecutiveCancels = 0; // 连续空输入 + Ctrl+C 计数,达到阈值退出
+    /**
+     * Ask the user for input. Returns either a value or 'cancelled'.
+     * Loop decides what to do with cancellation (usually: continue session,
+     * unless user has cancelled an already-empty input twice in a row).
+     */
+    async prompt(prefix, abortSignal) {
+        const prefill = this.computePrefill();
+        const previousDraft = prefill.kind === 'history' ? prefill.value : '';
+        // 用 abortSignal 绑到 inquirer:外面 Ctrl+C / 主进程事件可以取消
+        const value = await input({
+            message: prefix ?? this.defaultPrefix,
+            prefill: 'editable', // 关键:启用方向键 + 行内编辑,包括小键盘
+            default: previousDraft, // 历史预填
+            // Ctrl+C 由 @inquirer/input 抛出一个 symbol-like 错误,我们捕获为 cancelled
+            validate: () => true,
+        }, abortSignal ? { signal: abortSignal } : undefined).catch((err) => {
+            // 区分真实错误与用户取消;inquirer 用 ExitPromptError (name: 'ExitPromptError')
+            if (err && (err.name === 'ExitPromptError' || err.message?.includes('User force closed'))) {
+                return null;
+            }
+            throw err;
+        });
+        if (value === null || value === undefined) {
+            this.consecutiveCancels++;
+            return { kind: 'cancelled' };
+        }
+        const trimmed = value.trim();
+        if (trimmed.length > 0) {
+            // 避免把连续重复的内容都压入历史
+            if (this.history[this.history.length - 1] !== trimmed) {
+                this.history.push(trimmed);
+                if (this.history.length > MAX_HISTORY)
+                    this.history.shift();
+            }
+        }
+        this.consecutiveCancels = 0;
+        return { kind: 'value', value: trimmed };
+    }
+    /**
+     * Should we ask the loop to exit? Two consecutive Ctrl+C on empty input => exit.
+     */
+    shouldExitOnCancel() {
+        return this.consecutiveCancels >= 2;
+    }
+    /**
+     * Programmatic cancel trigger (used by the global SIGINT handler in REPLLoop).
+     * Increments the cancel counter as if a Ctrl+C had been seen, and returns
+     * whether the loop should now exit. Idempotent across the prompt() flow:
+     * if the user has already entered a non-empty prompt this is a no-op for exit
+     * (the loop keeps running) — but for an empty REPL it eventually returns true.
+     */
+    requestCancel() {
+        // 模拟一次空输入 cancel:计为 1,下一次 SIGINT 累计到 2 即退出
+        this.consecutiveCancels++;
+        return this.shouldExitOnCancel();
+    }
+    /**
+     * Reset consecutive-cancel counter when the loop has decided to keep running.
+     */
+    resetCancelCounter() {
+        this.consecutiveCancels = 0;
+    }
+    /**
+     * Decide what to prefill. Two modes:
+     *   - 'history': when user is navigating up/down with arrows
+     *   - 'draft':   when user has cleared the input — preserve their draft
+     */
+    computePrefill() {
+        if (this.historyIndex >= 0 && this.historyIndex < this.history.length) {
+            return { kind: 'history', value: this.history[this.historyIndex] };
+        }
+        if (this.currentDraft)
+            return { kind: 'draft', value: this.currentDraft };
+        return { kind: 'none', value: '' };
+    }
+    /**
+     * Save the user's in-progress draft so ↑↓ preserves their unsent typing.
+     */
+    saveDraft(text) {
+        this.currentDraft = text;
+    }
+    /**
+     * Navigate up in history (called from a global key listener, if needed).
+     */
+    historyUp() {
+        if (this.history.length === 0)
+            return this.currentDraft;
+        if (this.historyIndex < 0)
+            this.historyIndex = this.history.length;
+        if (this.historyIndex > 0)
+            this.historyIndex--;
+        return this.history[this.historyIndex] ?? '';
+    }
+    /**
+     * Navigate down in history.
+     */
+    historyDown() {
+        if (this.history.length === 0)
+            return this.currentDraft;
+        if (this.historyIndex >= this.history.length)
+            return this.currentDraft;
+        this.historyIndex++;
+        if (this.historyIndex >= this.history.length) {
+            this.historyIndex = this.history.length;
+            return this.currentDraft;
+        }
+        return this.history[this.historyIndex] ?? '';
+    }
+    getHistory() {
+        return this.history;
+    }
+    clearHistory() {
+        this.history = [];
+        this.historyIndex = -1;
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/repl/input.js.map

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

package/dist/repl/loop.d.ts

@@ -0,0 +1,184 @@
+/**
+ * REPL Loop
+ * Main interactive loop with streaming support
+ *
+ * S07-fix:
+ *   - 输入端换用 REPLInput (基于 @inquirer/input),支持方向键/小键盘
+ *   - 流式输出保留完整内容(用户可滚动终端查看历史),不跳顶不刷屏
+ *   - Ctrl+C 行为:有未提交内容=>清空当前输入;空输入两次=>退出
+ */
+/**
+ * One entry in ~/.thatgfsj/models.json (added in 0.3.0).
+ */
+export interface SavedModel {
+    /** Model id used in API requests, e.g. `Qwen3-32B` or `claude-sonnet-4-5`. */
+    id: string;
+    /** Unix ms timestamp when this entry was last written. Defaults to 0
+     *  on legacy entries; `appendSavedModel` always overwrites it with
+     *  `Date.now()` at write time. */
+    addedAt?: number;
+    /** Optional context-window length in MiB (the `ctx` field). */
+    ctx?: number;
+    /** Optional thinking-effort hint: 'none' | 'low' | 'medium' | 'high' | 'max'. */
+    thinking?: 'none' | 'low' | 'medium' | 'high' | 'max';
+    /** Optional free-form note (e.g. "Q4 quantized via openrouter"). */
+    note?: string;
+}
+export declare class REPLLoop {
+    private input;
+    private output;
+    private ai;
+    private session;
+    private running;
+    private streamAbort;
+    constructor();
+    /**
+     * Initialize the REPL
+     * S04: Use SystemPromptBuilder for dynamic prompt construction
+     */
+    init(): Promise<void>;
+    /**
+     * Start the REPL loop
+     */
+    start(): Promise<void>;
+    /**
+     * Handle built-in commands
+     *
+     * Accepts bare words, slash-prefixed forms (`/model`), AND Chinese aliases
+     * (`/模型`, `/提供商`, `/帮助`, `/清除`, `/退出`, `/历史`, `/工具`).
+     * The Chinese forms mirror thatgfsj-code@1.0.4 behaviour.
+     */
+    private handleCommand;
+    /**
+     * Process user input with AI (S01: streaming, no prompt reset)
+     *
+     * 关键修复:
+     *   - 不再调用 rl.question,所以不会 reset 终端
+     *   - chunk 直接 process.stdout.write,完整保留所有输出,用户可滚动查看
+     *   - spinner 在第一个 chunk 到达时停止,然后正常流式
+     */
+    private processInput;
+    private showContext;
+    private showHistory;
+    private showTools;
+    private showProviders;
+    /**
+     * /model — main entry point for model management.
+     *
+     * 0.3.0 UX (per user feedback):
+     *   - 先看到的是**已经保存的模型** (从 ~/.thatgfsj/models.json 读)，
+     *     而不是内置 provider 列表。
+     *   - 列表末尾是 `+ 添加新模型` 选项 → 触发完整向导
+     *     (provider → api_key → baseUrl(可选,用于中转站) → model_name →
+     *      context length (M) → thinking effort)。
+     *   - 顶部有 `edit` 模式,可以重新修改任意已保存模型。
+     *   - 选某条 saved model 后立即切换并退出；按 Enter 不变。
+     *   - 兼容 0.2.x / 1.0.4 老 history:
+     *     - 字符串数组会透明迁移成 {id,...} 形式。
+     *     - 内置模型 (`Qwen3-32B` 之类) 也可选择,作为「saved + builtin」展示。
+     */
+    private handleModelSwitch;
+    /**
+     * Add-model wizard (0.3.0+):
+     *   Step 1: Provider (内置 / custom_openai / custom_anthropic)
+     *   Step 2: API Key (内置:给注册链接;custom:无)
+     *   Step 3: Base URL (仅 custom_*;内置跳过)
+     *   Step 4: 模型名称 (自由输入)
+     *   Step 5: 上下文长度 (MiB,数字,默认 8)
+     *   Step 6: 思考强度 (none / low / medium / high / max,默认 none)
+     *
+     * 完成后:写入 ~/.thatgfsj/models.json,顺便把新模型切到当前,
+     * 更新 AIEngine + 写入 ~/.thatgfsj/config.json model 字段。
+     */
+    private runAddModelWizard;
+    /**
+     * Edit-model wizard (0.3.0+): pick a saved model and update ctx /
+     * thinking / note without leaving the REPL.
+     */
+    private runEditModelWizard;
+    /**
+     * Persist a provider choice + custom baseUrl + apiKey into
+     * ~/.thatgfsj/config.json and reload AIEngine config. Differs from
+     * applyProviderSwitch in that this also writes a custom baseUrl.
+     */
+    private applyProviderSwitchInternal;
+    /**
+     * Read ~/.thatgfsj/models.json — a list of saved models the user has
+     * previously switched to or added. Starting from 0.3.0 each entry is
+     * `{ id, addedAt, ctx?, thinking?, note? }`. Older releases stored a
+     * flat array of strings; we transparently migrate that on read.
+     */
+    private loadModelHistory;
+    /**
+     * Read ~/.thatgfsj/models.json as a list of SavedModel entries.
+     * Migrates v0.2.x's `["id1","id2"]` shape into 0.3.0's `{id,...}` shape
+     * on the fly, leaving the on-disk file untouched until a write happens.
+     */
+    private loadSavedModels;
+    /**
+     * Legacy helper: append a model id to ~/.thatgfsj/models.json.
+     * New callers should prefer `appendSavedModel` so we don't lose
+     * ctx / thinking metadata.
+     */
+    private appendModelHistory;
+    /**
+     * Persist a SavedModel into ~/.thatgfsj/models.json, replacing any
+     * existing entry with the same id (case-insensitive). The original
+     * casing of the entry is preserved — i.e. if the user already has
+     * `Qwen3-32B` saved and types `qwen3-32b`, the canonical `Qwen3-32B`
+     * casing is kept. Newest entries go at the tail of the file.
+     */
+    private appendSavedModel;
+    /** Replace an existing saved model entry (matched by id). */
+    private replaceSavedModel;
+    /**
+     * /provider — interactive provider picker. After provider selection,
+     * delegates to /model so the user can also pick a new model for the new provider.
+     */
+    private handleProviderSwitch;
+    /**
+     * /edit [n] — short-hand for the edit wizard.
+     *   `/edit`           → list saved models, ask which to edit.
+     *   `/edit 1`         → jump to wizard for saved model #1.
+     *   `/edit Qwen3-32B` → jump to wizard for the model whose id matches.
+     */
+    private runEditShortcut;
+    /**
+     * Persist a model choice and update the running AIEngine.
+     */
+    private applyModelSwitch;
+    /**
+     * Persist a provider choice (with the corresponding baseUrl from PROVIDERS
+     * map) and update the running AIEngine.
+     */
+    private applyProviderSwitch;
+    /**
+     * Read the on-disk config; if no file exists, derive a starting config
+     * from the current AIEngine state.
+     */
+    private readPersistedConfig;
+    private persistConfig;
+    /**
+     * Resolve either a numeric index or a model id to a model entry.
+     */
+    private resolveModelChoice;
+    /**
+     * Wrap readline in a one-shot prompt. Returns the trimmed answer, or
+     * `null` if the user pressed Ctrl+C (does not throw).
+     */
+    private askOnce;
+    /**
+     * Validate-and-collect a numeric choice within `[min..max]`. Accepts
+     * empty input as `defaultValue`. Returns `null` on Ctrl+C.
+     */
+    private askChoice;
+    /**
+     * Stop the REPL
+     */
+    stop(): void;
+    /**
+     * Handle interrupt (Ctrl+C) while streaming
+     */
+    interrupt(): void;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/repl/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/repl/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX;;sCAEkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACtD,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO,CAAC,WAAW,CAAgC;;IAOnD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C5B;;;;;;OAMG;YACW,aAAa;IA8E3B;;;;;;;OAOG;YACW,YAAY;IAsD1B,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,aAAa;IAarB;;;;;;;;;;;;;;OAcG;YACW,iBAAiB;IA6H/B;;;;;;;;;;;OAWG;YACW,iBAAiB;IA0G/B;;;OAGG;YACW,kBAAkB;IA2ChC;;;;OAIG;YACW,2BAA2B;IAezC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAqBxB,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;YACW,oBAAoB;IAgGlC;;;;;OAKG;YACW,eAAe;IAgC7B;;OAEG;YACW,gBAAgB;IAS9B;;;OAGG;YACW,mBAAmB;IASjC;;;OAGG;YACW,mBAAmB;YA2BnB,aAAa;IAM3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACH,OAAO,CAAC,OAAO;IAoBf;;;OAGG;YACW,SAAS;IAWvB;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,SAAS,IAAI,IAAI;CAOlB"}