@lingxiao-office/sdk 1.0.0

package/dist/plugins/hooks/ChatTransformHook.js

@@ -0,0 +1,59 @@
+/**
+ * Chat message transform hooks.
+ *
+ * Provides a pipeline that runs before messages are sent to the LLM.
+ * Each hook in the pipeline receives the output of the previous hook,
+ * allowing progressive filtering, modification, or augmentation of messages.
+ */
+/**
+ * Runs chat transform hooks as a sequential pipeline.
+ *
+ * Each hook receives the messages output by the previous hook.
+ * The first hook receives the original messages array.
+ */
+export class ChatTransformRunner {
+    hooks = [];
+    /**
+     * Register a transform hook (appended to the end of the pipeline).
+     */
+    register(hook) {
+        this.hooks.push(hook);
+    }
+    /**
+     * Remove a transform hook by name.
+     */
+    unregister(name) {
+        const index = this.hooks.findIndex((h) => h.name === name);
+        if (index === -1)
+            return false;
+        this.hooks.splice(index, 1);
+        return true;
+    }
+    /**
+     * Run all transform hooks in registration order as a pipeline.
+     * Returns the final transformed messages array.
+     */
+    async run(input) {
+        let currentMessages = input.messages;
+        for (const hook of this.hooks) {
+            currentMessages = await hook.transform({
+                ...input,
+                messages: currentMessages,
+            });
+        }
+        return currentMessages;
+    }
+    /**
+     * Get the count of registered hooks.
+     */
+    get count() {
+        return this.hooks.length;
+    }
+    /**
+     * Clear all registered hooks.
+     */
+    clear() {
+        this.hooks = [];
+    }
+}
+//# sourceMappingURL=ChatTransformHook.js.map

package/dist/plugins/hooks/ChatTransformHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatTransformHook.js","sourceRoot":"","sources":["../../../src/plugins/hooks/ChatTransformHook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAwB,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,IAAuB;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC3D,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,KAAyB;QACjC,IAAI,eAAe,GAAG,KAAK,CAAC,QAAQ,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,eAAe,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC;gBACrC,GAAG,KAAK;gBACR,QAAQ,EAAE,eAAe;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/plugins/hooks/ToolHooks.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Tool execution hooks.
+ *
+ * Provides before/after interception points for tool execution.
+ * Plugins register hooks to modify arguments, deny execution, or transform results.
+ */
+/**
+ * Input provided to a tool.execute.before hook handler.
+ */
+export interface ToolBeforeHookInput {
+    toolName: string;
+    args: Record<string, unknown>;
+    sessionId: string;
+}
+/**
+ * Output from a tool.execute.before hook handler.
+ * - If `deny` is true, tool execution is blocked with the given `reason`.
+ * - If `args` is provided, it replaces the tool arguments for execution.
+ */
+export interface ToolBeforeHookOutput {
+    args?: Record<string, unknown>;
+    deny?: boolean;
+    reason?: string;
+}
+/**
+ * Input provided to a tool.execute.after hook handler.
+ */
+export interface ToolAfterHookInput {
+    toolName: string;
+    args: Record<string, unknown>;
+    result: {
+        success: boolean;
+        output: unknown;
+        error?: string;
+    };
+    sessionId: string;
+}
+/**
+ * Output from a tool.execute.after hook handler.
+ * - If `output` is provided, it replaces the tool result output.
+ */
+export interface ToolAfterHookOutput {
+    output?: unknown;
+}
+/**
+ * A registered before-execution hook.
+ */
+export interface ToolBeforeHook {
+    name: string;
+    handler(input: ToolBeforeHookInput): Promise<ToolBeforeHookOutput>;
+}
+/**
+ * A registered after-execution hook.
+ */
+export interface ToolAfterHook {
+    name: string;
+    handler(input: ToolAfterHookInput): Promise<ToolAfterHookOutput>;
+}
+/**
+ * Result of running the before-hook pipeline.
+ */
+export interface ToolBeforeResult {
+    denied: boolean;
+    reason?: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Result of running the after-hook pipeline.
+ */
+export interface ToolAfterResult {
+    output: unknown;
+}
+/**
+ * Executes tool hooks in registration order.
+ *
+ * Before hooks:
+ *   - Run sequentially in registration order.
+ *   - Each hook can modify args (subsequent hooks see modified args).
+ *   - If any hook returns deny:true, execution stops and the denial is returned.
+ *
+ * After hooks:
+ *   - Run sequentially in registration order.
+ *   - Each hook can replace the output (subsequent hooks see the replaced output).
+ */
+export declare class ToolHookRunner {
+    private beforeHooks;
+    private afterHooks;
+    /**
+     * Register a before-execution hook.
+     */
+    registerBefore(hook: ToolBeforeHook): void;
+    /**
+     * Register an after-execution hook.
+     */
+    registerAfter(hook: ToolAfterHook): void;
+    /**
+     * Remove a before-execution hook by name.
+     */
+    unregisterBefore(name: string): boolean;
+    /**
+     * Remove an after-execution hook by name.
+     */
+    unregisterAfter(name: string): boolean;
+    /**
+     * Run all before hooks in registration order.
+     */
+    runBefore(input: ToolBeforeHookInput): Promise<ToolBeforeResult>;
+    /**
+     * Run all after hooks in registration order.
+     */
+    runAfter(input: ToolAfterHookInput): Promise<ToolAfterResult>;
+    /**
+     * Get the count of registered before hooks.
+     */
+    get beforeCount(): number;
+    /**
+     * Get the count of registered after hooks.
+     */
+    get afterCount(): number;
+    /**
+     * Clear all registered hooks.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ToolHooks.d.ts.map

package/dist/plugins/hooks/ToolHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHooks.d.ts","sourceRoot":"","sources":["../../../src/plugins/hooks/ToolHooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,UAAU,CAAuB;IAEzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOvC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOtC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBtE;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBnE;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/plugins/hooks/ToolHooks.js

@@ -0,0 +1,106 @@
+/**
+ * Tool execution hooks.
+ *
+ * Provides before/after interception points for tool execution.
+ * Plugins register hooks to modify arguments, deny execution, or transform results.
+ */
+/**
+ * Executes tool hooks in registration order.
+ *
+ * Before hooks:
+ *   - Run sequentially in registration order.
+ *   - Each hook can modify args (subsequent hooks see modified args).
+ *   - If any hook returns deny:true, execution stops and the denial is returned.
+ *
+ * After hooks:
+ *   - Run sequentially in registration order.
+ *   - Each hook can replace the output (subsequent hooks see the replaced output).
+ */
+export class ToolHookRunner {
+    beforeHooks = [];
+    afterHooks = [];
+    /**
+     * Register a before-execution hook.
+     */
+    registerBefore(hook) {
+        this.beforeHooks.push(hook);
+    }
+    /**
+     * Register an after-execution hook.
+     */
+    registerAfter(hook) {
+        this.afterHooks.push(hook);
+    }
+    /**
+     * Remove a before-execution hook by name.
+     */
+    unregisterBefore(name) {
+        const index = this.beforeHooks.findIndex((h) => h.name === name);
+        if (index === -1)
+            return false;
+        this.beforeHooks.splice(index, 1);
+        return true;
+    }
+    /**
+     * Remove an after-execution hook by name.
+     */
+    unregisterAfter(name) {
+        const index = this.afterHooks.findIndex((h) => h.name === name);
+        if (index === -1)
+            return false;
+        this.afterHooks.splice(index, 1);
+        return true;
+    }
+    /**
+     * Run all before hooks in registration order.
+     */
+    async runBefore(input) {
+        let currentArgs = { ...input.args };
+        for (const hook of this.beforeHooks) {
+            const result = await hook.handler({ ...input, args: currentArgs });
+            if (result.deny) {
+                return { denied: true, reason: result.reason, args: currentArgs };
+            }
+            if (result.args) {
+                currentArgs = result.args;
+            }
+        }
+        return { denied: false, args: currentArgs };
+    }
+    /**
+     * Run all after hooks in registration order.
+     */
+    async runAfter(input) {
+        let currentOutput = input.result.output;
+        for (const hook of this.afterHooks) {
+            const result = await hook.handler({
+                ...input,
+                result: { ...input.result, output: currentOutput },
+            });
+            if (result.output !== undefined) {
+                currentOutput = result.output;
+            }
+        }
+        return { output: currentOutput };
+    }
+    /**
+     * Get the count of registered before hooks.
+     */
+    get beforeCount() {
+        return this.beforeHooks.length;
+    }
+    /**
+     * Get the count of registered after hooks.
+     */
+    get afterCount() {
+        return this.afterHooks.length;
+    }
+    /**
+     * Clear all registered hooks.
+     */
+    clear() {
+        this.beforeHooks = [];
+        this.afterHooks = [];
+    }
+}
+//# sourceMappingURL=ToolHooks.js.map

package/dist/plugins/hooks/ToolHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHooks.js","sourceRoot":"","sources":["../../../src/plugins/hooks/ToolHooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwEH;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,cAAc;IACjB,WAAW,GAAqB,EAAE,CAAC;IACnC,UAAU,GAAoB,EAAE,CAAC;IAEzC;;OAEG;IACH,cAAc,CAAC,IAAoB;QACjC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAmB;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChE,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAA0B;QACxC,IAAI,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACnE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACpE,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAyB;QACtC,IAAI,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;gBAChC,GAAG,KAAK;gBACR,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE;aACnD,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/plugins/hooks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plugin hook system — tool execution and chat transform hooks.
+ */
+export { ToolHookRunner, } from './ToolHooks.js';
+export type { ToolBeforeHook, ToolBeforeHookInput, ToolBeforeHookOutput, ToolBeforeResult, ToolAfterHook, ToolAfterHookInput, ToolAfterHookOutput, ToolAfterResult, } from './ToolHooks.js';
+export { ChatTransformRunner, } from './ChatTransformHook.js';
+export type { ChatTransformHook, ChatTransformInput, } from './ChatTransformHook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/plugins/hooks/index.js

@@ -0,0 +1,6 @@
+/**
+ * Plugin hook system — tool execution and chat transform hooks.
+ */
+export { ToolHookRunner, } from './ToolHooks.js';
+export { ChatTransformRunner, } from './ChatTransformHook.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,GACf,MAAM,gBAAgB,CAAC;AAaxB,OAAO,EACL,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/runtime/LoggingRuntime.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Logging Runtime — CLI / Web 日志配置统一口径 + 定期清理接线
+ *
+ * 统一目标：让 CLI（TUI）与 Web server 的 configureLogging 调用使用同一套
+ * 级别 / file / 清理策略默认，仅在 console sink 上区分：
+ * - CLI(TUI)：console:false —— ConsoleSink 直写 stderr 会污染 Ink 渲染区。
+ * - Web    ：console:true  —— 保留 stderr 输出便于 server 日志可见。
+ *
+ * 同时把 startLogMaintenance() 的定时清理接线收敛到这里，保证：
+ * - 默认 maxAgeDays / maxTotalBytes 与配置口径一致。
+ * - 单进程内幂等（多次调用只注册一次定时器），避免重复 timer。
+ */
+import { type LogMaintenanceConfig } from '../core/LogMaintenance.js';
+export interface RuntimeLoggingOptions {
+    /** 可选 session ID：额外写一份 session 分文件日志。 */
+    sessionId?: string;
+}
+/**
+ * CLI / TUI 日志配置。console:false 防止 ConsoleSink 直写 stderr 污染 Ink 渲染。
+ * level 留空 → configureLogging 内部回落到 LINGXIAO_LOG_LEVEL 或 WARN（与 Web 一致）。
+ */
+export declare function configureCliLogging(opts?: RuntimeLoggingOptions): void;
+/**
+ * Web server 日志配置。保留 console sink（stderr），其余口径与 CLI 一致。
+ */
+export declare function configureWebLogging(opts?: RuntimeLoggingOptions): void;
+/**
+ * 在主进程启动路径调用，注册定时日志清理（已由 startLogMaintenance 内部注册
+ * cleanupRegistry priority=50 + unref，不阻塞进程退出）。
+ * 进程内幂等：重复调用只启动一次定时器。
+ */
+export declare function ensureLogMaintenance(cfg?: LogMaintenanceConfig): void;
+/** 停止定时清理（幂等）。主要用于测试或显式关闭。 */
+export declare function stopLogMaintenance(): void;
+//# sourceMappingURL=LoggingRuntime.d.ts.map

package/dist/runtime/LoggingRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/LoggingRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAoBnC,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,qBAA0B,GAAG,IAAI,CAO1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,qBAA0B,GAAG,IAAI,CAO1E;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,oBAAyB,GAAG,IAAI,CAazE;AAED,8BAA8B;AAC9B,wBAAgB,kBAAkB,IAAI,IAAI,CAUzC"}

package/dist/runtime/LoggingRuntime.js

@@ -0,0 +1,87 @@
+/**
+ * Logging Runtime — CLI / Web 日志配置统一口径 + 定期清理接线
+ *
+ * 统一目标：让 CLI（TUI）与 Web server 的 configureLogging 调用使用同一套
+ * 级别 / file / 清理策略默认，仅在 console sink 上区分：
+ * - CLI(TUI)：console:false —— ConsoleSink 直写 stderr 会污染 Ink 渲染区。
+ * - Web    ：console:true  —— 保留 stderr 输出便于 server 日志可见。
+ *
+ * 同时把 startLogMaintenance() 的定时清理接线收敛到这里，保证：
+ * - 默认 maxAgeDays / maxTotalBytes 与配置口径一致。
+ * - 单进程内幂等（多次调用只注册一次定时器），避免重复 timer。
+ */
+import { configureLogging } from '../core/Log.js';
+import { startLogMaintenance, } from '../core/LogMaintenance.js';
+// ─── 共享默认（CLI / Web 统一口径）─────────────────────────────────────────────
+/** 日志默认主路径：优先 LINGXIAO_LOG_PATH，否则使用 Log.ts 默认 lingxiao.log。 */
+function defaultLogFile() {
+    return process.env.LINGXIAO_LOG_PATH || true;
+}
+/** 内存环形缓冲容量（最近 N 条），CLI / Web 一致。 */
+const SHARED_RECENT_CAPACITY = 200;
+/** 定期清理默认策略，CLI / Web 一致。 */
+const SHARED_MAINTENANCE = {
+    maxAgeDays: 14,
+    maxTotalBytes: 200 * 1024 * 1024, // 200MB
+};
+/**
+ * CLI / TUI 日志配置。console:false 防止 ConsoleSink 直写 stderr 污染 Ink 渲染。
+ * level 留空 → configureLogging 内部回落到 LINGXIAO_LOG_LEVEL 或 WARN（与 Web 一致）。
+ */
+export function configureCliLogging(opts = {}) {
+    configureLogging({
+        console: false,
+        file: defaultLogFile(),
+        recentCapacity: SHARED_RECENT_CAPACITY,
+        sessionId: opts.sessionId,
+    });
+}
+/**
+ * Web server 日志配置。保留 console sink（stderr），其余口径与 CLI 一致。
+ */
+export function configureWebLogging(opts = {}) {
+    configureLogging({
+        console: true,
+        file: defaultLogFile(),
+        recentCapacity: SHARED_RECENT_CAPACITY,
+        sessionId: opts.sessionId,
+    });
+}
+// ─── 定期清理接线（进程内幂等）───────────────────────────────────────────────
+let _maintenanceStarted = false;
+let _stopMaintenance;
+/**
+ * 在主进程启动路径调用，注册定时日志清理（已由 startLogMaintenance 内部注册
+ * cleanupRegistry priority=50 + unref，不阻塞进程退出）。
+ * 进程内幂等：重复调用只启动一次定时器。
+ */
+export function ensureLogMaintenance(cfg = {}) {
+    if (_maintenanceStarted)
+        return;
+    _maintenanceStarted = true;
+    try {
+        _stopMaintenance = startLogMaintenance({
+            maxAgeDays: SHARED_MAINTENANCE.maxAgeDays,
+            maxTotalBytes: SHARED_MAINTENANCE.maxTotalBytes,
+            ...cfg,
+        });
+    }
+    catch {
+        // best-effort：清理接线失败不应阻断启动
+        _maintenanceStarted = false;
+    }
+}
+/** 停止定时清理（幂等）。主要用于测试或显式关闭。 */
+export function stopLogMaintenance() {
+    if (_stopMaintenance) {
+        try {
+            _stopMaintenance();
+        }
+        catch {
+            // best-effort
+        }
+        _stopMaintenance = undefined;
+    }
+    _maintenanceStarted = false;
+}
+//# sourceMappingURL=LoggingRuntime.js.map

package/dist/runtime/LoggingRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingRuntime.js","sourceRoot":"","sources":["../../src/runtime/LoggingRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AAEnC,wEAAwE;AAExE,gEAAgE;AAChE,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,qCAAqC;AACrC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,6BAA6B;AAC7B,MAAM,kBAAkB,GAAyE;IAC/F,UAAU,EAAE,EAAE;IACd,aAAa,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;CAC3C,CAAC;AASF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B,EAAE;IAClE,gBAAgB,CAAC;QACf,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,cAAc,EAAE;QACtB,cAAc,EAAE,sBAAsB;QACtC,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B,EAAE;IAClE,gBAAgB,CAAC;QACf,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,cAAc,EAAE;QACtB,cAAc,EAAE,sBAAsB;QACtC,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AAEnE,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAChC,IAAI,gBAA0C,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B,EAAE;IACjE,IAAI,mBAAmB;QAAE,OAAO;IAChC,mBAAmB,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,gBAAgB,GAAG,mBAAmB,CAAC;YACrC,UAAU,EAAE,kBAAkB,CAAC,UAAU;YACzC,aAAa,EAAE,kBAAkB,CAAC,aAAa;YAC/C,GAAG,GAAG;SACP,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;QAC3B,mBAAmB,GAAG,KAAK,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,kBAAkB;IAChC,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,gBAAgB,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,gBAAgB,GAAG,SAAS,CAAC;IAC/B,CAAC;IACD,mBAAmB,GAAG,KAAK,CAAC;AAC9B,CAAC"}