svharness 0.8.0

package/dist/utils/logger.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setVerbose = setVerbose;
+const picocolors_1 = __importDefault(require("picocolors"));
+let verboseEnabled = false;
+function setVerbose(v) {
+    verboseEnabled = v;
+}
+exports.logger = {
+    info(msg) {
+        console.log(picocolors_1.default.cyan('[info] ') + msg);
+    },
+    success(msg) {
+        console.log(picocolors_1.default.green('[ok]   ') + msg);
+    },
+    warn(msg) {
+        console.warn(picocolors_1.default.yellow('[warn] ') + msg);
+    },
+    error(msg) {
+        console.error(picocolors_1.default.red('[err]  ') + msg);
+    },
+    debug(msg) {
+        if (verboseEnabled) {
+            console.log(picocolors_1.default.gray('[dbg]  ') + picocolors_1.default.gray(msg));
+        }
+    },
+    plain(msg) {
+        console.log(msg);
+    },
+    section(title) {
+        console.log('');
+        console.log(picocolors_1.default.bold(picocolors_1.default.white('>> ' + title)));
+    },
+    /**
+     * Print a styled configuration box (like Claude Code style)
+     */
+    configBox(title, items) {
+        // Calculate max label width for alignment
+        const maxLabelWidth = Math.max(...items.map(item => item.label.length));
+        const boxWidth = Math.max(60, maxLabelWidth + 40);
+        console.log('');
+        console.log(picocolors_1.default.bold(picocolors_1.default.cyan('╭─ ' + title + ' ' + '─'.repeat(Math.max(0, boxWidth - title.length - 3)))));
+        for (const item of items) {
+            const label = picocolors_1.default.bold(picocolors_1.default.white(item.label));
+            const paddedLabel = label + ' '.repeat(Math.max(0, maxLabelWidth - item.label.length));
+            const value = picocolors_1.default.cyan(item.value);
+            console.log(`│ ${paddedLabel}  ${value}`);
+        }
+        console.log(picocolors_1.default.bold(picocolors_1.default.cyan('╰' + '─'.repeat(boxWidth + 2))));
+        console.log('');
+    },
+};

package/dist/utils/validate-args.js

@@ -0,0 +1,132 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectBaselineMode = detectBaselineMode;
+exports.validateArgs = validateArgs;
+exports.listSupportedArches = listSupportedArches;
+exports.listSupportedAgents = listSupportedAgents;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const SUPPORTED_ARCHES = [
+    'android-compose',
+    'android-xml',
+    'cpp',
+    'web-react',
+    'python',
+];
+const SUPPORTED_AGENTS = [
+    'codechat',
+    'qoder',
+    'cursor',
+    'claude-code',
+    'generic',
+];
+const NAME_RE = /^[a-z][a-z0-9-]{1,39}$/;
+const DEFAULT_BASELINE_MAX_FILE_KB = 1024;
+/**
+ * Decide whether the `--baseline` value looks like a git remote or a local path.
+ * Heuristics (ordered):
+ *   - ssh-style:   git@host:path
+ *   - ssh scheme:  ssh://...
+ *   - http(s) ending with .git
+ *   - ends with .git
+ *   - http(s) URL whose host matches a known git hosting provider
+ * Otherwise treated as a local path.
+ */
+function detectBaselineMode(input) {
+    const v = input.trim();
+    if (/^git@[^:]+:.+/i.test(v))
+        return 'git';
+    if (/^ssh:\/\//i.test(v))
+        return 'git';
+    if (/^git:\/\//i.test(v))
+        return 'git';
+    if (/^https?:\/\/.+\.git$/i.test(v))
+        return 'git';
+    if (/\.git$/i.test(v) && /^(https?|ssh|git):\/\//i.test(v))
+        return 'git';
+    if (/^https?:\/\//i.test(v) &&
+        /(github\.com|gitlab\.com|gitee\.com|bitbucket\.org|codehub\.|coding\.net|dev\.azure\.com)/i.test(v)) {
+        return 'git';
+    }
+    return 'local';
+}
+function validateArgs(input) {
+    const errors = [];
+    // name
+    if (!input.name) {
+        errors.push('--name is required');
+    }
+    else if (!NAME_RE.test(input.name)) {
+        errors.push(`--name "${input.name}" is invalid. Allowed: lowercase letters, digits, hyphen; start with letter; length 2-40.`);
+    }
+    // arch
+    if (!input.arch) {
+        errors.push('--arch is required');
+    }
+    else if (!SUPPORTED_ARCHES.includes(input.arch)) {
+        errors.push(`--arch "${input.arch}" is not supported. Allowed: ${SUPPORTED_ARCHES.join(', ')}`);
+    }
+    // agent
+    if (!input.agent) {
+        errors.push('--agent is required');
+    }
+    else if (!SUPPORTED_AGENTS.includes(input.agent)) {
+        errors.push(`--agent "${input.agent}" is not supported. Allowed: ${SUPPORTED_AGENTS.join(', ')}`);
+    }
+    // baseline (optional) + mode detection
+    let baselineValue;
+    let baselineMode;
+    if (input.baseline) {
+        baselineMode = detectBaselineMode(input.baseline);
+        if (baselineMode === 'local') {
+            const abs = node_path_1.default.resolve(input.baseline);
+            if (!fs_extra_1.default.existsSync(abs)) {
+                errors.push(`--baseline path does not exist: ${abs}`);
+            }
+            else if (!fs_extra_1.default.statSync(abs).isDirectory()) {
+                errors.push(`--baseline must be a directory: ${abs}`);
+            }
+            baselineValue = abs;
+        }
+        else {
+            // git mode: keep raw URL
+            baselineValue = input.baseline.trim();
+        }
+    }
+    // baseline-branch only meaningful in git mode; silently accepted otherwise
+    // (caller will warn if user passed it in local mode)
+    const baselineBranch = baselineMode === 'git' && input.baselineBranch
+        ? input.baselineBranch.trim() || undefined
+        : undefined;
+    // baseline-max-file-kb
+    let maxSize = DEFAULT_BASELINE_MAX_FILE_KB;
+    if (typeof input.baselineMaxFileKB === 'number' && Number.isFinite(input.baselineMaxFileKB)) {
+        if (input.baselineMaxFileKB <= 0) {
+            errors.push('--baseline-max-file-kb must be a positive number (KB)');
+        }
+        else {
+            maxSize = Math.floor(input.baselineMaxFileKB);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error('Argument validation failed:\n  - ' + errors.join('\n  - '));
+    }
+    return {
+        name: input.name,
+        arch: input.arch,
+        agent: input.agent,
+        baseline: baselineValue,
+        baselineMode,
+        baselineBranch,
+        baselineMaxFileKB: maxSize,
+    };
+}
+function listSupportedArches() {
+    return SUPPORTED_ARCHES;
+}
+function listSupportedAgents() {
+    return SUPPORTED_AGENTS;
+}

package/dist/utils/version.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCliVersion = getCliVersion;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+let cachedVersion = null;
+function getCliVersion() {
+    if (cachedVersion)
+        return cachedVersion;
+    // __dirname at runtime is dist/utils, so package.json lives two levels up.
+    const pkgPath = node_path_1.default.resolve(__dirname, '..', '..', 'package.json');
+    try {
+        const pkg = fs_extra_1.default.readJsonSync(pkgPath);
+        cachedVersion = String(pkg.version || '0.0.0');
+    }
+    catch {
+        cachedVersion = '0.0.0';
+    }
+    return cachedVersion;
+}

package/dist/wiki/abort.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * AbortSignal-based cancellation helpers for the wiki core.
+ * Replaces VS Code's `CancellationToken` / `CancellationError` so the core can
+ * run in plain Node (CLI / CI) without an IDE host.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WikiAbortError = exports.WIKI_ABORT_ERROR_NAME = void 0;
+exports.assertNotAborted = assertNotAborted;
+exports.isAbortError = isAbortError;
+exports.WIKI_ABORT_ERROR_NAME = "AbortError";
+/** Thrown when a wiki run is aborted by the caller (e.g. SIGINT / Ctrl+C). */
+class WikiAbortError extends Error {
+    constructor(message = "Aborted") {
+        super(message);
+        this.name = exports.WIKI_ABORT_ERROR_NAME;
+    }
+}
+exports.WikiAbortError = WikiAbortError;
+function assertNotAborted(signal) {
+    if (signal.aborted)
+        throw new WikiAbortError();
+}
+/** True when an error (or its cause) represents an abort, including fetch's DOMException. */
+function isAbortError(e) {
+    if (!e || typeof e !== "object")
+        return false;
+    const name = e.name;
+    return name === exports.WIKI_ABORT_ERROR_NAME;
+}

package/dist/wiki/config.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWikiRunConfig = resolveWikiRunConfig;
+exports.loadRepowikiMetadata = loadRepowikiMetadata;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const envLoader_1 = require("./envLoader");
+const defaults_1 = require("./defaults");
+/**
+ * Priority: CLI flag > process.env (`OPENAI_API_KEY` / `OPENAI_BASE_URL` /
+ * `DEEPWIKI_OPENAI_CHAT_MODEL`) > cwd `.env` > bundled defaults.
+ */
+async function resolveWikiRunConfig(input) {
+    const dot = await (0, envLoader_1.findWorkspaceDotEnv)(input.cwd);
+    const apiKey = (input.apiKey ?? "").trim() ||
+        (process.env.OPENAI_API_KEY ?? "").trim() ||
+        (dot.OPENAI_API_KEY ?? "").trim() ||
+        defaults_1.DEFAULT_OPENAI_API_KEY;
+    const baseUrl = (input.baseUrl ?? "").trim() ||
+        (process.env.OPENAI_BASE_URL ?? "").trim() ||
+        (dot.OPENAI_BASE_URL ?? "").trim() ||
+        defaults_1.DEFAULT_OPENAI_BASE_URL;
+    const model = (input.model ?? "").trim() ||
+        (process.env.DEEPWIKI_OPENAI_CHAT_MODEL ?? "").trim() ||
+        (dot.DEEPWIKI_OPENAI_CHAT_MODEL ?? "").trim() ||
+        defaults_1.DEFAULT_OPENAI_CHAT_MODEL;
+    return { baseUrl, apiKey, model };
+}
+/**
+ * Lightweight reader for `<wikiBase>/metadata.json`. Kept separate from the
+ * config resolver so it stays tree-shakable for non-CLI consumers.
+ */
+async function loadRepowikiMetadata(wikiBaseFs) {
+    try {
+        const raw = await fs.readFile(path.join(wikiBaseFs, "metadata.json"), "utf8");
+        const j = JSON.parse(raw);
+        return {
+            indexedCommit: j.indexedCommit ?? null,
+            sourceRootFs: j.sourceRootFs,
+            files: j.files && typeof j.files === "object" ? j.files : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/wiki/defaults.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Embedded OpenAI-compatible defaults for the wiki core (gateway + chat model).
+ * CLI flags / env / .env override these when non-empty.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_OPENAI_CHAT_MODEL = exports.DEFAULT_OPENAI_API_KEY = exports.DEFAULT_OPENAI_BASE_URL = void 0;
+// export const DEFAULT_OPENAI_BASE_URL = "http://model-api.desaysv.com/v1";
+// export const DEFAULT_OPENAI_API_KEY =
+//   "sk-3v4T1keyvRQNSDewOcqq8gJeIS6NZ1Ez8Yo7XoIzUCMgFy9P";
+//   //Qwen3.6-27B|deepseek-v4-pro|mimo-v2-pro|glm-5.1
+// export const DEFAULT_OPENAI_CHAT_MODEL = "Qwen3.6-27B";
+exports.DEFAULT_OPENAI_BASE_URL = "https://api.laozhang.ai/v1";
+exports.DEFAULT_OPENAI_API_KEY = "sk-7C1tRtidwPLpDEwY84CbD4E7Ba3f4c36AaF69e9b017aB8F4";
+//claude-haiku-4-5-20251001|deepseek-v4-flash
+exports.DEFAULT_OPENAI_CHAT_MODEL = "deepseek-v4-flash";

package/dist/wiki/envLoader.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDotEnvFile = loadDotEnvFile;
+exports.findWorkspaceDotEnv = findWorkspaceDotEnv;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/** Minimal .env parsing (KEY=VALUE, no multiline values). */
+async function loadDotEnvFile(envPath) {
+    const raw = await fs.readFile(envPath, "utf8").catch(() => "");
+    const out = {};
+    for (const line of raw.split(/\r?\n/)) {
+        const t = line.trim();
+        if (!t || t.startsWith("#"))
+            continue;
+        const eq = t.indexOf("=");
+        if (eq < 1)
+            continue;
+        const k = t.slice(0, eq).trim();
+        let v = t.slice(eq + 1).trim();
+        if ((v.startsWith('"') && v.endsWith('"')) ||
+            (v.startsWith("'") && v.endsWith("'"))) {
+            v = v.slice(1, -1);
+        }
+        out[k] = v;
+    }
+    return out;
+}
+/** Search the given directory and up to two parent levels for a `.env` file. */
+async function findWorkspaceDotEnv(workspaceRootFs) {
+    const candidates = [
+        path.join(workspaceRootFs, ".env"),
+        path.join(workspaceRootFs, "..", ".env"),
+        path.join(workspaceRootFs, "..", "..", ".env"),
+    ];
+    for (const p of candidates) {
+        try {
+            await fs.access(p);
+            return await loadDotEnvFile(p);
+        }
+        catch {
+            continue;
+        }
+    }
+    return {};
+}

package/dist/wiki/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * svharnessbuild wiki generator — platform-agnostic port of repowiki core.
+ *
+ * Public entry points:
+ *  - `runRepowikiIndex(opts)` — generate wiki under `<wikiOutputRootFs>/<wikiRelPath>/`.
+ *  - `resolveWikiRunConfig(input)` — resolve baseUrl/apiKey/model from CLI > env > .env > defaults.
+ *  - `WikiAbortError` — thrown when an AbortSignal cancels the run.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_OPENAI_CHAT_MODEL = exports.DEFAULT_OPENAI_BASE_URL = exports.isAbortError = exports.assertNotAborted = exports.WikiAbortError = exports.loadRepowikiMetadata = exports.resolveWikiRunConfig = exports.writeWikiTasks = exports.langRunForRepowikiTarget = exports.REPOWIKI_LANG_ZH = exports.REPOWIKI_LANG_EN = exports.runRepowikiOutlineOnly = exports.runRepowikiIndex = void 0;
+var repowikiIndexer_1 = require("./repowikiIndexer");
+Object.defineProperty(exports, "runRepowikiIndex", { enumerable: true, get: function () { return repowikiIndexer_1.runRepowikiIndex; } });
+Object.defineProperty(exports, "runRepowikiOutlineOnly", { enumerable: true, get: function () { return repowikiIndexer_1.runRepowikiOutlineOnly; } });
+Object.defineProperty(exports, "REPOWIKI_LANG_EN", { enumerable: true, get: function () { return repowikiIndexer_1.REPOWIKI_LANG_EN; } });
+Object.defineProperty(exports, "REPOWIKI_LANG_ZH", { enumerable: true, get: function () { return repowikiIndexer_1.REPOWIKI_LANG_ZH; } });
+Object.defineProperty(exports, "langRunForRepowikiTarget", { enumerable: true, get: function () { return repowikiIndexer_1.langRunForRepowikiTarget; } });
+var wikiTasksWriter_1 = require("./wikiTasksWriter");
+Object.defineProperty(exports, "writeWikiTasks", { enumerable: true, get: function () { return wikiTasksWriter_1.writeWikiTasks; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "resolveWikiRunConfig", { enumerable: true, get: function () { return config_1.resolveWikiRunConfig; } });
+Object.defineProperty(exports, "loadRepowikiMetadata", { enumerable: true, get: function () { return config_1.loadRepowikiMetadata; } });
+var abort_1 = require("./abort");
+Object.defineProperty(exports, "WikiAbortError", { enumerable: true, get: function () { return abort_1.WikiAbortError; } });
+Object.defineProperty(exports, "assertNotAborted", { enumerable: true, get: function () { return abort_1.assertNotAborted; } });
+Object.defineProperty(exports, "isAbortError", { enumerable: true, get: function () { return abort_1.isAbortError; } });
+var defaults_1 = require("./defaults");
+Object.defineProperty(exports, "DEFAULT_OPENAI_BASE_URL", { enumerable: true, get: function () { return defaults_1.DEFAULT_OPENAI_BASE_URL; } });
+Object.defineProperty(exports, "DEFAULT_OPENAI_CHAT_MODEL", { enumerable: true, get: function () { return defaults_1.DEFAULT_OPENAI_CHAT_MODEL; } });

package/dist/wiki/openaiCompat.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completionTextFromResponse = completionTextFromResponse;
+exports.isFetchAbortError = isFetchAbortError;
+exports.isLikelyNetworkFetchFailure = isLikelyNetworkFetchFailure;
+exports.errorLogTextWithCauseChain = errorLogTextWithCauseChain;
+exports.chatCompletionText = chatCompletionText;
+const NON_JSON_HINT = "Server returned non-JSON or SSE — check OPENAI_BASE_URL supports JSON completions";
+function parseCompletionJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(NON_JSON_HINT);
+    }
+}
+function completionTextFromJson(j) {
+    if (j.error?.message) {
+        throw new Error(j.error.message);
+    }
+    const c0 = j.choices?.[0];
+    return c0?.message?.content ?? "";
+}
+/** Aggregate `data:` JSON chunks from an SSE (or SSE-shaped) body. */
+function parseSseChatCompletionBody(body) {
+    let aggregated = "";
+    for (const line of body.split(/\r?\n/)) {
+        const trimmed = line.trimStart();
+        if (!trimmed.startsWith("data:")) {
+            continue;
+        }
+        const payload = trimmed.slice(5).trimStart();
+        if (payload === "" || payload === "[DONE]") {
+            continue;
+        }
+        let j;
+        try {
+            j = JSON.parse(payload);
+        }
+        catch {
+            throw new Error(NON_JSON_HINT);
+        }
+        if (j.error?.message) {
+            throw new Error(j.error.message);
+        }
+        const c0 = j.choices?.[0];
+        const piece = c0?.message?.content ?? c0?.delta?.content ?? "";
+        aggregated += piece;
+    }
+    return aggregated;
+}
+function responseLooksLikeSse(res, rawBody) {
+    const ct = (res.headers.get("content-type") ?? "").toLowerCase();
+    if (ct.includes("text/event-stream")) {
+        return true;
+    }
+    return rawBody.trimStart().startsWith("data:");
+}
+async function completionTextFromResponse(res) {
+    let raw;
+    try {
+        raw = await res.text();
+    }
+    catch (e) {
+        throw new Error(`${NON_JSON_HINT} (${String(e)})`);
+    }
+    const text = responseLooksLikeSse(res, raw)
+        ? parseSseChatCompletionBody(raw)
+        : completionTextFromJson(parseCompletionJson(raw));
+    if (!text.trim()) {
+        throw new Error("Empty completion from chat API");
+    }
+    return text;
+}
+/** True when `fetch` rejected because the request was aborted (user cancel / AbortSignal). */
+function isFetchAbortError(e) {
+    if (!e || typeof e !== "object")
+        return false;
+    const name = e.name;
+    return name === "AbortError";
+}
+const MSG_OPENAI_NETWORK_ZH = "无法连接到 API 服务器。请检查网络、VPN、防火墙或公司代理；并确认设置里的 OpenAI 兼容地址（--wiki-base-url / OPENAI_BASE_URL）正确且服务已启动。";
+const MSG_OPENAI_FETCH_OTHER_ZH = "OpenAI 兼容接口请求未成功。请检查 API 地址、密钥与网络环境；技术详情已写入日志。";
+function errnoCodesInCauseChain(e) {
+    const codes = [];
+    let cur = e;
+    let depth = 0;
+    while (cur && depth < 10) {
+        if (typeof cur === "object" && cur !== null && "code" in cur) {
+            const c = cur.code;
+            if (typeof c === "string")
+                codes.push(c);
+        }
+        cur = cur instanceof Error ? cur.cause : undefined;
+        depth++;
+    }
+    return codes;
+}
+function causeChainMessagesLower(e) {
+    const parts = [];
+    let cur = e;
+    let depth = 0;
+    while (cur && depth < 10) {
+        if (cur instanceof Error) {
+            parts.push(cur.message);
+            cur = cur.cause;
+        }
+        else {
+            parts.push(String(cur));
+            break;
+        }
+        depth++;
+    }
+    return parts.join(" ").toLowerCase();
+}
+/** True when `fetch` likely failed due to DNS, TCP, TLS, timeout, or proxy (not HTTP 4xx/5xx). */
+function isLikelyNetworkFetchFailure(e) {
+    const blob = causeChainMessagesLower(e);
+    if (blob.includes("fetch failed"))
+        return true;
+    if (blob.includes("network error when attempting to fetch resource"))
+        return true;
+    const netCodes = new Set([
+        "ECONNREFUSED",
+        "ENOTFOUND",
+        "ETIMEDOUT",
+        "EAI_AGAIN",
+        "ECONNRESET",
+        "ECONNABORTED",
+        "ENETUNREACH",
+        "EHOSTUNREACH",
+        "CERT_HAS_EXPIRED",
+        "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+        "DEPTH_ZERO_SELF_SIGNED_CERT",
+        "SELF_SIGNED_CERT_IN_CHAIN",
+        "EPROTO",
+    ]);
+    for (const code of errnoCodesInCauseChain(e)) {
+        if (netCodes.has(code))
+            return true;
+        if (code.startsWith("UND_ERR_"))
+            return true;
+    }
+    return false;
+}
+function httpFailureUserMessage(status, statusText) {
+    return `API 返回错误（HTTP ${status}${statusText ? ` ${statusText}` : ""}）。请确认服务可用、模型名称与 API 密钥是否正确。`;
+}
+/** Full text for logs, including `error.cause` chain (errno codes when present). */
+function errorLogTextWithCauseChain(e) {
+    if (!(e instanceof Error))
+        return String(e);
+    const lines = [e.message];
+    let cur = e.cause;
+    let depth = 0;
+    while (cur != null && depth < 12) {
+        if (cur instanceof Error) {
+            let line = cur.message;
+            const code = cur.code;
+            if (typeof code === "string")
+                line += ` [${code}]`;
+            lines.push(line);
+            cur = cur.cause;
+        }
+        else {
+            lines.push(String(cur));
+            break;
+        }
+        depth++;
+    }
+    return lines.join("\n");
+}
+async function chatCompletionText(params) {
+    const base = params.baseUrl.replace(/\/+$/, "");
+    const url = `${base}/chat/completions`;
+    const headers = {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        Authorization: `Bearer ${params.apiKey}`,
+    };
+    const body = JSON.stringify({
+        model: params.model,
+        messages: params.messages,
+        temperature: params.temperature ?? 0.3,
+        stream: false,
+    });
+    let res;
+    try {
+        res = await fetch(url, { method: "POST", headers, body, signal: params.signal });
+    }
+    catch (e) {
+        if (params.signal?.aborted || isFetchAbortError(e)) {
+            throw e;
+        }
+        const chain = e instanceof Error ? errorLogTextWithCauseChain(e) : String(e);
+        const technical = `POST ${url}\n${chain}`;
+        if (isLikelyNetworkFetchFailure(e)) {
+            throw new Error(MSG_OPENAI_NETWORK_ZH, { cause: technical });
+        }
+        throw new Error(MSG_OPENAI_FETCH_OTHER_ZH, { cause: technical });
+    }
+    if (params.signal?.aborted) {
+        const err = new Error("Aborted");
+        err.name = "AbortError";
+        throw err;
+    }
+    if (!res.ok) {
+        const t = await res.text().catch(() => "");
+        const technical = `OpenAI-compat ${res.status} ${res.statusText}: ${t.slice(0, 600)}`;
+        throw new Error(httpFailureUserMessage(res.status, res.statusText), { cause: technical });
+    }
+    const text = await completionTextFromResponse(res);
+    if (params.signal?.aborted) {
+        const err = new Error("Aborted");
+        err.name = "AbortError";
+        throw err;
+    }
+    return text;
+}