@lingxiao-office/sdk 1.0.0

package/dist/tools/slidev/SlidevProjectBuilder.js

@@ -0,0 +1,139 @@
+import { existsSync, lstatSync, mkdirSync, symlinkSync } from 'fs';
+import { readdir, readFile, stat } from 'fs/promises';
+import { basename, join, relative, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { getSessionScopePaths, lockedAtomicWriteBuffer, resolveTaskWritePath } from '../implementations/utils.js';
+import { slugFileName, zipToBuffer } from '../implementations/OfficeXmlBuilder.js';
+const BUILTIN_THEMES = new Set(['default', 'seriph', 'apple-basic']);
+const THEME_PACKAGES = {
+    default: '@slidev/theme-default',
+    seriph: '@slidev/theme-seriph',
+    'apple-basic': '@slidev/theme-apple-basic',
+};
+function ensureFrontmatter(markdown, title, theme) {
+    const warnings = [];
+    const trimmed = markdown.trimStart();
+    if (trimmed.startsWith('---')) {
+        const end = trimmed.indexOf('\n---', 3);
+        if (end === -1) {
+            warnings.push('检测到 frontmatter 起始标记但未闭合，请检查 slides.md。');
+        }
+        return { markdown, warnings };
+    }
+    warnings.push('未检测到 Slidev frontmatter，已自动补充 title/theme/transition。');
+    return {
+        markdown: `---\ntitle: ${JSON.stringify(title)}\ntheme: ${theme}\ntransition: slide-left\n---\n\n${markdown}`,
+        warnings,
+    };
+}
+function defaultOutputDir(input, slug) {
+    const scope = getSessionScopePaths(input.workspace, input.sessionId);
+    const base = scope.scratchpadDir || resolve(input.workspace || process.cwd(), '.lingxiao', 'slidev');
+    return join(base, slug);
+}
+function packageJson(title, theme) {
+    const deps = {
+        '@slidev/cli': '^52.0.0',
+    };
+    if (theme === 'default')
+        deps['@slidev/theme-default'] = '^0.25.0';
+    if (theme === 'seriph')
+        deps['@slidev/theme-seriph'] = '^0.25.0';
+    if (theme === 'apple-basic')
+        deps['@slidev/theme-apple-basic'] = '^0.25.0';
+    return JSON.stringify({
+        name: slugFileName(title, 'lingxiao-slidev-deck').toLowerCase(),
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'slidev --host 127.0.0.1 slides.md',
+            build: 'slidev build slides.md',
+            'export:pdf': 'slidev export slides.md --format pdf',
+            'export:pptx': 'slidev export slides.md --format pptx',
+            'export:png': 'slidev export slides.md --format png',
+        },
+        devDependencies: deps,
+    }, null, 2) + '\n';
+}
+async function linkRuntimeDependencies(projectDir, theme) {
+    const packageNames = ['@slidev/cli', THEME_PACKAGES[theme]].filter((value) => Boolean(value));
+    for (const packageName of packageNames) {
+        const packagePath = fileURLToPath(new URL(`../../../node_modules/${packageName}/`, import.meta.url));
+        if (!existsSync(join(packagePath, 'package.json')))
+            continue;
+        const target = join(projectDir, 'node_modules', ...packageName.split('/'));
+        if (existsSync(target))
+            continue;
+        mkdirSync(join(target, '..'), { recursive: true });
+        try {
+            symlinkSync(packagePath, target, 'dir');
+        }
+        catch { /* swallowed: unhandled error */
+            if (!existsSync(target) || !lstatSync(target).isSymbolicLink())
+                throw new Error(`无法链接 Slidev 运行时依赖: ${packageName}`);
+        }
+    }
+}
+async function collectFiles(dir, root = dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = {};
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules')
+                continue;
+            Object.assign(files, await collectFiles(fullPath, root));
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const rel = relative(root, fullPath).replace(/\\/g, '/');
+        files[rel] = await readFile(fullPath);
+    }
+    return files;
+}
+export async function buildSlidevProject(input) {
+    const title = input.title?.trim() || 'Lingxiao Slidev Deck';
+    const slug = slugFileName(title, `slidev-${Date.now()}`).toLowerCase();
+    const warnings = [];
+    if (!BUILTIN_THEMES.has(input.theme)) {
+        warnings.push(`主题 ${input.theme} 未内置，已生成项目但预览/导出可能失败；建议使用 default、seriph 或 apple-basic。`);
+    }
+    const projectDir = input.outputDir
+        ? resolveTaskWritePath(input.workspace, input.outputDir, input.sessionId, input.taskWriteScope)
+        : defaultOutputDir(input, slug);
+    const { markdown, warnings: frontmatterWarnings } = ensureFrontmatter(input.markdown, title, input.theme);
+    warnings.push(...frontmatterWarnings);
+    const slides = markdown.includes('\n---') ? markdown : `${markdown.trimEnd()}\n\n---\n\n# Appendix\n`;
+    if (slides !== markdown)
+        warnings.push('仅检测到单页内容，已补充一页 Appendix 以保证 Slidev 分页结构。');
+    const slidesPath = join(projectDir, 'slides.md');
+    const packageJsonPath = join(projectDir, 'package.json');
+    const stylePath = input.styleCss?.trim() ? join(projectDir, 'style.css') : undefined;
+    await lockedAtomicWriteBuffer(slidesPath, Buffer.from(slides, 'utf-8'), { createDirs: true });
+    await lockedAtomicWriteBuffer(packageJsonPath, Buffer.from(packageJson(title, input.theme), 'utf-8'), { createDirs: true });
+    if (stylePath) {
+        await lockedAtomicWriteBuffer(stylePath, Buffer.from(input.styleCss, 'utf-8'), { createDirs: true });
+    }
+    await linkRuntimeDependencies(projectDir, input.theme);
+    const zipPath = join(projectDir, `${basename(projectDir)}.zip`);
+    const zipFiles = await collectFiles(projectDir);
+    delete zipFiles[basename(zipPath)];
+    const zipBuffer = await zipToBuffer(zipFiles);
+    await lockedAtomicWriteBuffer(zipPath, zipBuffer, { createDirs: true });
+    const fileNames = Object.keys(await collectFiles(projectDir)).sort();
+    if (!existsSync(slidesPath) || !(await stat(slidesPath)).isFile()) {
+        throw new Error(`Slidev slides.md 写入失败: ${slidesPath}`);
+    }
+    return {
+        projectDir,
+        slidesPath,
+        packageJsonPath,
+        stylePath,
+        zipPath,
+        files: fileNames,
+        slug,
+        warnings,
+    };
+}
+//# sourceMappingURL=SlidevProjectBuilder.js.map

package/dist/tools/slidev/SlidevProjectBuilder.js.map

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

package/dist/types/canonical.d.ts

@@ -0,0 +1,124 @@
+/**
+ * canonical.ts — Core type definitions (Single Source of Truth)
+ *
+ * All modules MUST import these canonical types rather than redefining locally.
+ * Use Pick/Omit/Extend for module-specific subsets.
+ */
+import type { MessageContent } from '../contracts/types/Message.js';
+import type { TaskStatus } from '../contracts/types/Status.js';
+import type { OrchestrationTaskMetadata } from '../core/OrchestrationTypes.js';
+export type { ImageBlobRefContentPart, ImageUrlContentPart, McpAppContentPart, MessageContent, MessageContentPart, TextBlock as TextContentPart, } from '../contracts/types/Message.js';
+export type { EternalTokenSnapshot, TokenUsage, TokenUsageRecord, TokenUsageView, } from '../contracts/types/TokenUsage.js';
+export { EMPTY_TOKEN_USAGE, } from '../contracts/types/TokenUsage.js';
+/**
+ * Canonical Task record — the full runtime representation used by TaskBoard.
+ * DB persistence layer and agent-facing subset derive from this via Pick/Omit.
+ */
+export interface TaskRecord {
+    id: string;
+    session_id: string;
+    subject: string;
+    description: string | object;
+    context?: string;
+    status: TaskStatus;
+    exitReason?: string;
+    /** 任务执行代际；每次派发/重派/重开递增 */
+    runGeneration: number;
+    agent_type: string;
+    blocked_by: string[];
+    blocks: string[];
+    assigned_agent: string;
+    /** 预绑定 agent name */
+    preferred_agent_name?: string;
+    working_directory: string;
+    write_scope: string[];
+    result?: string | object;
+    /** 外部阻塞原因（坏 API key / 缺凭证 / ask_user / 权限等）。置位时 getReadyTasks 排除该任务，
+     *  防止 external_blocking 故障的任务被无限重派烧 token；prepareTaskForRedispatch 清除。 */
+    blocked_reason?: string;
+    orchestration?: OrchestrationTaskMetadata;
+    /** task 起源标签 */
+    origin?: string;
+    /** task 高层目标 */
+    goal?: string;
+    /** task 类型 */
+    taskType?: 'bootstrap' | 'reason' | 'explore' | 'generic';
+    created_at: number;
+    updated_at: number;
+}
+/**
+ * Lightweight agent-facing task — subset of TaskRecord for worker dispatch.
+ * Matches the existing BaseAgent.Task interface.
+ * Note: description is string (not string|object) at the agent level.
+ */
+export interface AgentTask {
+    id: string;
+    subject: string;
+    description: string;
+    context?: string;
+    working_directory?: string;
+    write_scope?: string[];
+    agent_type?: string;
+    session_id?: string;
+    origin?: string;
+    goal?: string;
+    taskType?: 'bootstrap' | 'reason' | 'explore' | 'generic';
+}
+/**
+ * DB-level Task row — snake_case fields for SQLite storage.
+ * Uses string for status/exit_reason (no enum dependency in DB layer).
+ */
+export interface TaskDbRow {
+    id: string;
+    session_id: string;
+    subject: string;
+    description: string | object;
+    context?: string;
+    status: string;
+    exit_reason?: string;
+    run_generation?: number;
+    agent_type: string;
+    blocked_by: string[];
+    blocks: string[];
+    assigned_agent: string;
+    preferred_agent_name?: string;
+    working_directory?: string;
+    write_scope?: string[];
+    result?: string | object;
+    /** 外部阻塞原因（与 TaskRecord.blocked_reason 同义，DB 列）。置位时 getReadyTasks 排除。 */
+    blocked_reason?: string;
+    orchestration?: OrchestrationTaskMetadata;
+    origin?: string;
+    goal?: string;
+    task_type?: string;
+    created_at: number;
+    updated_at: number;
+}
+/**
+ * Canonical Session record — shared between Database and SessionManager.
+ */
+export interface SessionRecord {
+    id: string;
+    created_at: number;
+    workspace: string;
+    user_request: MessageContent | object;
+    status: string;
+    summary?: string;
+    /** 会话名称（自动生成或用户手动编辑）；与 summary（结束总结）语义分离 */
+    name?: string;
+}
+/**
+ * ThinkingMode — how to activate thinking for a given provider.
+ */
+export type ThinkingMode = 'reasoning_effort' | 'thinking_block' | 'extra_body';
+/**
+ * Canonical model capability spec — describes how to invoke thinking for a model.
+ * Unifies config.ts ModelCapability, llm/types.ts ModelCapability, and
+ * model_capability_config.ts ModelCapabilityConfig.
+ */
+export interface ModelCapabilitySpec {
+    thinking_mode?: ThinkingMode | null;
+    param_name?: string;
+    param_value?: unknown;
+}
+//# sourceMappingURL=canonical.d.ts.map

package/dist/types/canonical.d.ts.map

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

package/dist/types/canonical.js

@@ -0,0 +1,8 @@
+/**
+ * canonical.ts — Core type definitions (Single Source of Truth)
+ *
+ * All modules MUST import these canonical types rather than redefining locally.
+ * Use Pick/Omit/Extend for module-specific subsets.
+ */
+export { EMPTY_TOKEN_USAGE, } from '../contracts/types/TokenUsage.js';
+//# sourceMappingURL=canonical.js.map

package/dist/types/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/types/canonical.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,OAAO,EACL,iBAAiB,GAClB,MAAM,kCAAkC,CAAC"}

package/dist/utils/SmartTruncator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 确定性输出截断（禁止启发式）。
+ *
+ * 设计原则：
+ * - 不再用关键词正则（ERROR/failed/...）判定是否保留尾部——改为**始终 head+tail 截断**：
+ *   既保留开头上下文，也保留结尾结果/错误，对成功与失败输出都是最优覆盖，且完全可预测。
+ * - JSON 单文档走**边界感知**截断：在元素/键边界切断并标注省略量，避免 byte/line 切在
+ *   token 中间产生无效 JSON（`{"error":null}`、`"failed":0` 等正常字段不会再触发误判模式）。
+ */
+export interface TruncationResult {
+    text: string;
+    truncated: boolean;
+}
+/**
+ * 确定性截断：超限时，JSON 走边界感知；其余走 head+tail。
+ *
+ * @param output    - Raw output string
+ * @param maxBytes  - Maximum byte budget (default 51200 = 50 KiB)
+ * @param maxLines  - Maximum line budget (default 2000)
+ */
+export declare function smartTruncate(output: string, maxBytes?: number, maxLines?: number): TruncationResult;
+//# sourceMappingURL=SmartTruncator.d.ts.map

package/dist/utils/SmartTruncator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartTruncator.d.ts","sourceRoot":"","sources":["../../src/utils/SmartTruncator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAYD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAc,EACxB,QAAQ,GAAE,MAAa,GACtB,gBAAgB,CAalB"}

package/dist/utils/SmartTruncator.js

@@ -0,0 +1,88 @@
+/**
+ * 确定性输出截断（禁止启发式）。
+ *
+ * 设计原则：
+ * - 不再用关键词正则（ERROR/failed/...）判定是否保留尾部——改为**始终 head+tail 截断**：
+ *   既保留开头上下文，也保留结尾结果/错误，对成功与失败输出都是最优覆盖，且完全可预测。
+ * - JSON 单文档走**边界感知**截断：在元素/键边界切断并标注省略量，避免 byte/line 切在
+ *   token 中间产生无效 JSON（`{"error":null}`、`"failed":0` 等正常字段不会再触发误判模式）。
+ */
+/** 判断文本是否以 JSON 文档开头（首个非空白字符为 { 或 [）。 */
+function looksLikeJsonDocument(text) {
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r')
+            continue;
+        return ch === '{' || ch === '[';
+    }
+    return false;
+}
+/**
+ * 确定性截断：超限时，JSON 走边界感知；其余走 head+tail。
+ *
+ * @param output    - Raw output string
+ * @param maxBytes  - Maximum byte budget (default 51200 = 50 KiB)
+ * @param maxLines  - Maximum line budget (default 2000)
+ */
+export function smartTruncate(output, maxBytes = 51200, maxLines = 2000) {
+    const byteLength = Buffer.byteLength(output, 'utf-8');
+    const lines = output.split('\n');
+    if (byteLength <= maxBytes && lines.length <= maxLines) {
+        return { text: output, truncated: false };
+    }
+    if (looksLikeJsonDocument(output)) {
+        return jsonAwareTruncate(output, maxBytes);
+    }
+    return headTailTruncate(lines, maxLines, maxBytes);
+}
+/**
+ * JSON 边界感知截断：在 maxBytes 内回退到最后一个元素/行边界，避免切在 token 中间。
+ */
+function jsonAwareTruncate(output, maxBytes) {
+    const buf = Buffer.from(output, 'utf-8');
+    if (buf.length <= maxBytes)
+        return { text: output, truncated: false };
+    const head = buf.subarray(0, maxBytes).toString('utf-8');
+    // 候选边界：对象/数组元素结束、逗号、换行——取 maxBytes 后半段内最后一个。
+    let boundary = -1;
+    for (const sep of ['},', '],', ',', '\n']) {
+        const idx = head.lastIndexOf(sep);
+        if (idx > boundary && idx > maxBytes * 0.5) {
+            boundary = idx + sep.length;
+        }
+    }
+    const cut = boundary > 0 ? boundary : maxBytes;
+    const kept = head.slice(0, cut);
+    const omitted = buf.length - Buffer.byteLength(kept, 'utf-8');
+    return {
+        text: `${kept}\n... (JSON output truncated, ~${omitted} bytes omitted) ...`,
+        truncated: true,
+    };
+}
+/**
+ * head+tail 模式：70% head，30% tail，中间插省略标记。始终使用（不再按关键词切换）。
+ */
+function headTailTruncate(lines, maxLines, maxBytes) {
+    const effectiveLineLimit = Math.min(maxLines, lines.length);
+    const headLineCount = Math.max(Math.floor(effectiveLineLimit * 0.7), 1);
+    const tailLineCount = Math.max(effectiveLineLimit - headLineCount, 1);
+    let headLines = lines.slice(0, headLineCount);
+    let tailLines = lines.slice(Math.max(lines.length - tailLineCount, headLineCount));
+    const buildResult = () => {
+        const omittedCount = lines.length - headLines.length - tailLines.length;
+        const marker = `\n... (${omittedCount} lines omitted) ...\n`;
+        return headLines.join('\n') + marker + tailLines.join('\n');
+    };
+    let result = buildResult();
+    // 字节预算：先削 head，再削 tail。
+    while (Buffer.byteLength(result, 'utf-8') > maxBytes && headLines.length > 1) {
+        headLines = headLines.slice(0, headLines.length - 1);
+        result = buildResult();
+    }
+    while (Buffer.byteLength(result, 'utf-8') > maxBytes && tailLines.length > 1) {
+        tailLines = tailLines.slice(1);
+        result = buildResult();
+    }
+    return { text: result, truncated: true };
+}
+//# sourceMappingURL=SmartTruncator.js.map

package/dist/utils/SmartTruncator.js.map

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

package/dist/utils/getPty.d.ts

@@ -0,0 +1,42 @@
+/**
+ * PTY 模块加载器 — 优先使用 @lydell/node-pty，回退到 node-pty，最终回退到 child_process
+ */
+export interface PtyProcess {
+    readonly pid: number;
+    write(data: string): void;
+    resize?(cols: number, rows: number): void;
+    onData(callback: (data: string) => void): void;
+    onExit(callback: (e: {
+        exitCode: number;
+        signal?: number;
+    }) => void): void;
+    kill(signal?: string): void;
+}
+export interface PtyModule {
+    spawn(file: string, args: string[], options: {
+        name: string;
+        cols: number;
+        rows: number;
+        cwd: string;
+        env: NodeJS.ProcessEnv | Record<string, string>;
+    }): PtyProcess;
+}
+export type PtyImplementation = {
+    module: PtyModule;
+    name: 'lydell-node-pty' | 'node-pty';
+} | null;
+export declare function shouldDisablePty(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * 获取 PTY 模块（带缓存）
+ *
+ * 尝试顺序：
+ * 1. @lydell/node-pty (qwen-code 使用的 fork)
+ * 2. node-pty (官方包)
+ * 3. 返回 null (将回退到 child_process)
+ */
+export declare const getPty: () => Promise<PtyImplementation>;
+/**
+ * 重置 PTY 缓存（用于测试）
+ */
+export declare const resetPtyCache: () => void;
+//# sourceMappingURL=getPty.d.ts.map

package/dist/utils/getPty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPty.d.ts","sourceRoot":"","sources":["../../src/utils/getPty.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;QAC3C,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjD,GAAG,UAAU,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAC;CACtC,GAAG,IAAI,CAAC;AAST,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAI9E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAa,OAAO,CAAC,iBAAiB,CAyBxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,IAEhC,CAAC"}

package/dist/utils/getPty.js

@@ -0,0 +1,57 @@
+/**
+ * PTY 模块加载器 — 优先使用 @lydell/node-pty，回退到 node-pty，最终回退到 child_process
+ */
+let cachedPty = undefined;
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+export function shouldDisablePty(env = process.env) {
+    if (isTruthyEnv(env.LINGXIAO_DISABLE_PTY))
+        return true;
+    if (isTruthyEnv(env.LINGXIAO_ENABLE_PTY_IN_CI))
+        return false;
+    return isTruthyEnv(env.CI);
+}
+/**
+ * 获取 PTY 模块（带缓存）
+ *
+ * 尝试顺序：
+ * 1. @lydell/node-pty (qwen-code 使用的 fork)
+ * 2. node-pty (官方包)
+ * 3. 返回 null (将回退到 child_process)
+ */
+export const getPty = async () => {
+    if (shouldDisablePty()) {
+        return null;
+    }
+    if (cachedPty !== undefined) {
+        return cachedPty;
+    }
+    try {
+        const lydell = '@lydell/node-pty';
+        const module = await import(lydell);
+        cachedPty = { module, name: 'lydell-node-pty' };
+        return cachedPty;
+    }
+    catch { /* swallowed: unhandled error */
+        try {
+            const nodePty = 'node-pty';
+            const module = await import(nodePty);
+            cachedPty = { module, name: 'node-pty' };
+            return cachedPty;
+        }
+        catch { /* swallowed: unhandled error */
+            cachedPty = null;
+            return null;
+        }
+    }
+};
+/**
+ * 重置 PTY 缓存（用于测试）
+ */
+export const resetPtyCache = () => {
+    cachedPty = undefined;
+};
+//# sourceMappingURL=getPty.js.map

package/dist/utils/getPty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPty.js","sourceRoot":"","sources":["../../src/utils/getPty.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,IAAI,SAAS,GAAyC,SAAS,CAAC;AAEhE,SAAS,WAAW,CAAC,KAAyB;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,IAAI,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,WAAW,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7D,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,IAAgC,EAAE;IAC3D,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,SAAS,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC,CAAA,gCAAgC;QACvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,SAAS,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC,CAAA,gCAAgC;YACvC,SAAS,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAS,EAAE;IACtC,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC,CAAC"}