@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/logger/elog4js.js.map

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

package/dist/logger/logger.d.ts

@@ -0,0 +1,37 @@
+import { type LevelWithSilent, type Logger, type LoggerOptions } from "pino";
+import type { AppSetting } from "../config/types.js";
+import { type ResolvedPaths } from "../platform/path.js";
+export declare const LOG_FILE_NAME = "app.log";
+/** 直接创建 logger，不读取配置、不写全局单例 */
+export interface CreateLoggerOptions {
+    readonly level?: LevelWithSilent;
+    /** 日志文件路径；false 表示只写 stdout */
+    readonly file?: string | false;
+    /** 是否写 stdout，默认 false */
+    readonly stdout?: boolean;
+    /** 是否写 stderr，默认 false；--json 模式下开启 */
+    readonly stderr?: boolean;
+    /** 是否把插件日志镜像到 elog4js，默认 false */
+    readonly mirrorPlugin?: boolean;
+    readonly redact?: LoggerOptions["redact"];
+}
+/** 初始化全局 logger 的参数 */
+export interface InitLoggerOptions extends Omit<CreateLoggerOptions, "file"> {
+    /** 直接指定配置，跳过读取配置文件 */
+    readonly settings?: AppSetting;
+    readonly configFile?: string;
+    /** 覆盖目录解析结果，测试用 */
+    readonly paths?: ResolvedPaths;
+    /** 覆盖日志文件路径；false 表示只写 stdout */
+    readonly file?: string | false;
+    /** --json 模式：Pino 额外写 stderr，插件日志不镜像到终端 */
+    readonly json?: boolean;
+}
+/** 创建 logger。file 默认落在 logDir/app.log */
+export declare function createLogger(options?: CreateLoggerOptions): Logger;
+/** 取全局 logger，未初始化时抛错 */
+export declare function getLogger(): Logger;
+/** 初始化全局 logger。重复调用返回已有实例 */
+export declare function initLogger(options?: InitLoggerOptions): Promise<Logger>;
+/** 关闭全局 logger。等待文件目标刷新并关闭，stdout 保持打开 */
+export declare function closeLogger(): Promise<void>;

package/dist/logger/logger.js

@@ -0,0 +1,196 @@
+/*
+ * Pino 日志。
+ * 输出到 log 根目录下的 app.log；human 模式只写文件，插件日志镜像到 elog4js。
+ * --json 模式额外写 stderr（JSONL），stdout 留给 Result envelope。
+ */
+import { join } from "node:path";
+import { Writable } from "node:stream";
+import pino, {} from "pino";
+import { DEFAULT_SETTINGS } from "../config/defaults.js";
+import { loadSettings, SETTING_FILE_NAME } from "../config/loader.js";
+import { assertWritableFile, ensureDirs } from "../platform/file.js";
+import { getPaths } from "../platform/path.js";
+import { getElog } from "./elog4js.js";
+export const LOG_FILE_NAME = "app.log";
+const APP_NAME = "wellspring";
+/** 记录每个 logger 对应的文件目标，关闭时只刷新文件，不碰 stdout */
+const fileDestinations = new WeakMap();
+let current = null;
+const LEVEL_NAMES = {
+    10: "trace",
+    20: "debug",
+    30: "info",
+    40: "warn",
+    50: "error",
+    60: "fatal",
+};
+/** 把带 plugin 字段的 Pino JSON 行镜像到 elog4js */
+class ElogMirrorStream extends Writable {
+    _write(chunk, _encoding, callback) {
+        try {
+            const line = JSON.parse(chunk.toString());
+            if (typeof line.plugin === "string" && typeof line.msg === "string") {
+                const level = LEVEL_NAMES[Number(line.level)] ?? "info";
+                const elog = getElog();
+                if (line.msg.startsWith("插件 ")) {
+                    // 拦截消息本身已含插件名，不再重复前缀
+                    elog.tag(level, line.msg);
+                }
+                else if (line.msg.startsWith(`${line.plugin} `)) {
+                    elog.plugin(level, line.plugin, line.msg.slice(line.plugin.length + 1));
+                }
+                else {
+                    elog.plugin(level, line.plugin, line.msg);
+                }
+            }
+        }
+        catch {
+            // 非 JSON 行忽略
+        }
+        callback();
+    }
+}
+/** 创建 logger。file 默认落在 logDir/app.log */
+export function createLogger(options = {}) {
+    const level = options.level ?? DEFAULT_SETTINGS.logger.level;
+    const streams = [];
+    let destination = null;
+    if (options.file !== false) {
+        const file = options.file ?? join(getPaths().logDir, LOG_FILE_NAME);
+        try {
+            // SonicBoom 的文件打开是异步的，坏路径不会在构造时抛错，先同步确认可写
+            assertWritableFile(file);
+            destination = pino.destination({
+                dest: file,
+                mkdir: true,
+                sync: false,
+                mode: 0o600,
+            });
+        }
+        catch (error) {
+            throw new Error(`日志文件不可写：${file}`, { cause: error });
+        }
+        // 运行期写入失败（磁盘满、文件被删除）时不再抛出未处理错误
+        destination.on("error", (error) => {
+            process.stderr.write(`日志写入失败：${file}：${error.message}\n`);
+        });
+        streams.push({ level: "trace", stream: destination });
+    }
+    if (options.stdout === true) {
+        streams.push({ level: "trace", stream: process.stdout });
+    }
+    if (options.stderr === true) {
+        streams.push({ level: "trace", stream: process.stderr });
+    }
+    if (options.mirrorPlugin === true) {
+        streams.push({ level: "trace", stream: new ElogMirrorStream() });
+    }
+    if (streams.length === 0) {
+        throw new Error("日志输出未启用");
+    }
+    const logger = pino({
+        name: APP_NAME,
+        level,
+        timestamp: pino.stdTimeFunctions.isoTime,
+        ...(options.redact === undefined ? {} : { redact: options.redact }),
+    }, streams.length === 1 ? streams[0]?.stream : pino.multistream(streams));
+    if (destination !== null) {
+        fileDestinations.set(logger, destination);
+    }
+    return logger;
+}
+/** 取全局 logger，未初始化时抛错 */
+export function getLogger() {
+    if (current === null) {
+        throw new Error("logger 尚未初始化：先调用 initLogger()");
+    }
+    return current;
+}
+/** 初始化全局 logger。重复调用返回已有实例 */
+export async function initLogger(options = {}) {
+    if (current !== null) {
+        return current;
+    }
+    const paths = options.paths ?? getPaths();
+    let settings = options.settings;
+    let configCode = null;
+    if (settings === undefined && options.level === undefined) {
+        const file = options.configFile ?? join(paths.configDir, SETTING_FILE_NAME);
+        const result = await loadSettings(file);
+        settings = result.getData() ?? DEFAULT_SETTINGS;
+        if (!result.isSuccess()) {
+            configCode = result.getCode();
+        }
+    }
+    const level = options.level ?? settings?.logger.level ?? DEFAULT_SETTINGS.logger.level;
+    const file = options.file ?? join(paths.logDir, LOG_FILE_NAME);
+    let logger;
+    try {
+        if (file !== false) {
+            await ensureDirs(paths);
+        }
+        logger = createLogger({
+            level,
+            file,
+            stdout: options.stdout ?? false,
+            stderr: options.stderr ?? options.json === true,
+            mirrorPlugin: options.mirrorPlugin ?? options.json !== true,
+            redact: options.redact,
+        });
+    }
+    catch (error) {
+        logger = createLogger({
+            level,
+            file: false,
+            stdout: true,
+            stderr: options.stderr ?? options.json === true,
+            mirrorPlugin: options.mirrorPlugin ?? options.json !== true,
+            redact: options.redact,
+        });
+        const reason = error instanceof Error ? error.message : String(error);
+        logger.warn({ file, reason }, "日志文件不可写，输出到 stdout");
+    }
+    current = logger;
+    if (configCode !== null) {
+        logger.warn({ code: configCode }, "配置加载失败，使用默认配置");
+    }
+    return logger;
+}
+/** 关闭全局 logger。等待文件目标刷新并关闭，stdout 保持打开 */
+export function closeLogger() {
+    const logger = current;
+    if (logger === null) {
+        return Promise.resolve();
+    }
+    current = null;
+    const destination = fileDestinations.get(logger);
+    if (destination === undefined) {
+        return Promise.resolve();
+    }
+    fileDestinations.delete(logger);
+    return new Promise((resolve) => {
+        let settled = false;
+        let timer;
+        const done = () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            resolve();
+        };
+        destination.once("close", done);
+        destination.once("error", done);
+        // 打开失败或目标始终未就绪时，end 不会再触发 close
+        timer = setTimeout(done, 2_000);
+        try {
+            destination.end();
+        }
+        catch {
+            done();
+        }
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger/logger.js.map

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

package/dist/network/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./openai.js";
+export * from "./proxy.js";

package/dist/network/index.js

@@ -0,0 +1,6 @@
+/*
+ * 网络层入口。
+ */
+export * from "./openai.js";
+export * from "./proxy.js";
+//# sourceMappingURL=index.js.map

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/network/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/network/openai.d.ts

@@ -0,0 +1,117 @@
+import { type ClientOptions } from "openai";
+import type { ChatCompletionMessageParam, ChatCompletionTool } from "openai/resources/chat/completions";
+import type { Logger } from "pino";
+import { Result } from "../api/result/result.js";
+import type { OpenAISetting } from "../config/types.js";
+/** OpenAI 调用错误码 */
+export declare const OPENAI_CODES: {
+    readonly missingApiKey: "openai.missing-api-key";
+    readonly clientInitFailed: "openai.client-init-failed";
+    readonly emptyOutput: "openai.empty-output";
+    readonly timeout: "openai.timeout";
+    readonly connectionFailed: "openai.connection-failed";
+    readonly aborted: "openai.aborted";
+    readonly unauthorized: "openai.unauthorized";
+    readonly forbidden: "openai.forbidden";
+    readonly notFound: "openai.not-found";
+    readonly rateLimited: "openai.rate-limited";
+    readonly badRequest: "openai.bad-request";
+    readonly serverError: "openai.server-error";
+    readonly apiError: "openai.api-error";
+    readonly requestFailed: "openai.request-failed";
+};
+export interface OpenAIReply {
+    readonly text: string;
+    readonly model: string;
+    readonly id: string;
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    /** 缓存命中 / 写入的 prompt tokens；供应商没报告时缺省 */
+    readonly cacheReadTokens?: number | null;
+    readonly cacheWriteTokens?: number | null;
+    /** 输出里的推理 token；供应商没报告时缺省 */
+    readonly reasoningTokens?: number | null;
+}
+export interface RespondOptions {
+    readonly model?: string;
+    readonly instructions?: string;
+    readonly maxOutputTokens?: number;
+}
+export interface ChatOptions {
+    readonly model?: string;
+    readonly temperature?: number;
+    readonly maxTokens?: number;
+    /** 推理强度；off 表示不发送 reasoning 参数 */
+    readonly reasoning?: string;
+}
+/** 规范化后的流式片段，直接落进会话事件 */
+export interface OpenAISessionChunk {
+    readonly type: "chunk";
+    readonly time: number;
+    readonly chunk: Record<string, unknown>;
+}
+export interface ToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+}
+export interface StreamReply {
+    /** 这次流被 signal 中断（用户停止）；reply 里是已经收到的部分 */
+    readonly interrupted?: boolean;
+    readonly reply: OpenAIReply;
+    readonly chunks: readonly OpenAISessionChunk[];
+    readonly toolCalls: readonly ToolCall[];
+    /** 模型返回的思考内容（DeepSeek 等推理模型的 reasoning_content）；没有时为空串 */
+    readonly reasoning: string;
+}
+export interface ChatStreamOptions extends ChatOptions {
+    /**
+     * 中断信号：用户停止时立刻断开这次请求
+     *
+     * 已经收到的增量照常返回（`interrupted: true`），调用方按「用户停止」收尾，
+     * 不会因为打断丢掉半截回复。
+     */
+    readonly signal?: AbortSignal;
+    readonly onText?: (text: string) => void;
+    /** 思考内容增量回调；只在模型返回 reasoning_content 时触发 */
+    readonly onReasoning?: (text: string) => void;
+    readonly tools?: readonly ChatCompletionTool[];
+    readonly toolChoice?: "auto" | "none" | "required";
+}
+export interface CreateOpenAIClientOptions {
+    readonly settings?: OpenAISetting;
+    /** 覆盖 OPENAI_API_KEY 与本地凭据 */
+    readonly apiKey?: string;
+    /** 本地凭据文件路径；不传用当前 configDir 下的 credentials.json */
+    readonly credentialsFile?: string;
+    readonly logger?: Logger;
+    /** 注入 fetch，测试用 */
+    readonly fetch?: ClientOptions["fetch"];
+}
+/** 把 SDK 异常归一化为错误码 */
+export declare function mapOpenAIError(error: unknown): string;
+export declare class OpenAIClient {
+    #private;
+    private constructor();
+    /** 创建客户端。缺少 API key 或 SDK 初始化失败时返回错误码 */
+    static create(options?: CreateOpenAIClientOptions): Result<OpenAIClient>;
+    /** 单轮文本生成，走 Responses API */
+    respond(input: string, options?: RespondOptions): Promise<Result<OpenAIReply>>;
+    /** 多轮对话，走 Chat Completions API */
+    chat(messages: readonly ChatCompletionMessageParam[], options?: ChatOptions): Promise<Result<OpenAIReply>>;
+    /** 流式 Chat Completions；始终请求流式，便于完整记录 chunk */
+    chatStream(messages: readonly ChatCompletionMessageParam[], options?: ChatStreamOptions): Promise<Result<StreamReply>>;
+    /** 拉取供应商的模型 id 列表（用于自定义供应商的“拉取模型”） */
+    listModels(): Promise<Result<readonly string[]>>;
+    /** 轻量连通性测试：拉模型列表，不产生对话费用 */
+    testConnection(): Promise<Result<{
+        readonly models: number;
+    }>>;
+    private failure;
+}
+/** 初始化全局客户端，已初始化时直接返回 */
+export declare function initOpenAIClient(options?: CreateOpenAIClientOptions): Result<OpenAIClient>;
+/** 取全局客户端，未初始化时抛错 */
+export declare function getOpenAIClient(): OpenAIClient;
+/** 清空全局客户端，供测试与关停使用 */
+export declare function resetOpenAIClient(): void;