@lingxiao-office/sdk 1.0.0

package/dist/core/compress/MessageByteTruncator.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MessageByteTruncator — 单条巨型消息的「中段截断 + 全文归档」
+ *
+ * 动机：HTTP 413 "Payload Too Large" 是网关对**请求体字节**的限制。现有压缩链路
+ * （CompressionPipeline / performContextReset）只能按整条 pop 消息，对「单条就有
+ * 几十万 token 的巨型消息」（一次粘贴的长文 / 巨大工具结果 / 长 assistant 回复）
+ * 无能为力——这条消息若落在 pinned（首 user）或 recent 窗口里就被原样保留，
+ * token 与字节都降不下来，导致反复 413 死循环。
+ *
+ * 本模块对超过阈值的单条消息做中段截断：保留头部 + 尾部，中段替换为占位符，
+ * 并把**完整原文**写入归档盘（无损可追溯）。tool_call_id / role / tool_calls
+ * 等字段原样保留，维持 tool_use ↔ tool_result 配对完整性，避免下游 sanitizer 报错。
+ */
+import { type ChatMessage } from '../../llm/types.js';
+import type { ContextOwner } from './CompressionTypes.js';
+export interface OversizedArchiveInfo {
+    /** 消息在原数组中的下标 */
+    index: number;
+    role: ChatMessage['role'];
+    /** 截断前的字节数 */
+    bytes: number;
+    /** 完整原文（纯文本视图，供归档） */
+    fullText: string;
+}
+/** 归档写入器：写入完整原文，返回归档路径（失败返回 undefined）。 */
+export type OversizedArchiveWriter = (info: OversizedArchiveInfo) => string | undefined;
+export interface TruncateOversizedOptions {
+    /** 单条消息字节上限，超过即截断 */
+    maxSingleMessageBytes: number;
+    /** 归档写入器（可选）；提供则把完整原文写盘并在占位符里附路径 */
+    archiveWriter?: OversizedArchiveWriter;
+    /** 头部保留比例（相对 maxSingleMessageBytes），默认 0.4 */
+    headRatio?: number;
+    /** 尾部保留比例（相对 maxSingleMessageBytes），默认 0.2 */
+    tailRatio?: number;
+}
+export interface TruncateOversizedResult {
+    /** 处理后的消息列表（未超限的条目为原对象引用） */
+    messages: ChatMessage[];
+    /** 被截断的条数 */
+    truncatedCount: number;
+    /** 节省的字节数 */
+    bytesSaved: number;
+}
+/**
+ * 对超过单条字节上限的消息做中段截断。未超限的消息原样返回（保持引用）。
+ */
+export declare function truncateOversizedMessages(messages: ChatMessage[], opts: TruncateOversizedOptions): TruncateOversizedResult;
+/**
+ * 按 UTF-8 字节保留头部 headBytes + 尾部 tailBytes，中间插入占位符。
+ * code-point 安全（不切断 surrogate pair）。
+ */
+export declare function truncateStringToBytes(text: string, headBytes: number, tailBytes: number, placeholder: string): string;
+/**
+ * 构造一个把超大原文写入会话归档盘的同步归档写入器。
+ * 路径约定与 CompressionPipeline 的压缩归档一致：
+ *   leader → workspace/.lingxiao/sessions/<sessionId>/context/leader
+ *   agent  → workspace/.lingxiao/sessions/<sessionId>/context/agents/<agentId>
+ * 缺少 workspace/sessionId 时返回 undefined（不归档，仍会截断）。
+ */
+export declare function createOversizedArchiveWriter(params: {
+    owner: ContextOwner;
+    sessionId?: string;
+}): OversizedArchiveWriter | undefined;
+//# sourceMappingURL=MessageByteTruncator.d.ts.map

package/dist/core/compress/MessageByteTruncator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageByteTruncator.d.ts","sourceRoot":"","sources":["../../../src/core/compress/MessageByteTruncator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D,MAAM,WAAW,oBAAoB;IACnC,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,oBAAoB,KAAK,MAAM,GAAG,SAAS,CAAC;AAExF,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,6BAA6B;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,wBAAwB,GAC7B,uBAAuB,CAwBzB;AAuDD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAuCD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,sBAAsB,GAAG,SAAS,CAiCrC"}

package/dist/core/compress/MessageByteTruncator.js

@@ -0,0 +1,178 @@
+/**
+ * MessageByteTruncator — 单条巨型消息的「中段截断 + 全文归档」
+ *
+ * 动机：HTTP 413 "Payload Too Large" 是网关对**请求体字节**的限制。现有压缩链路
+ * （CompressionPipeline / performContextReset）只能按整条 pop 消息，对「单条就有
+ * 几十万 token 的巨型消息」（一次粘贴的长文 / 巨大工具结果 / 长 assistant 回复）
+ * 无能为力——这条消息若落在 pinned（首 user）或 recent 窗口里就被原样保留，
+ * token 与字节都降不下来，导致反复 413 死循环。
+ *
+ * 本模块对超过阈值的单条消息做中段截断：保留头部 + 尾部，中段替换为占位符，
+ * 并把**完整原文**写入归档盘（无损可追溯）。tool_call_id / role / tool_calls
+ * 等字段原样保留，维持 tool_use ↔ tool_result 配对完整性，避免下游 sanitizer 报错。
+ */
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { contentToPlainText, } from '../../llm/types.js';
+import { calculateMessageBytes } from './ContextTokenCalculator.js';
+const DEFAULT_HEAD_RATIO = 0.4;
+const DEFAULT_TAIL_RATIO = 0.2;
+/**
+ * 对超过单条字节上限的消息做中段截断。未超限的消息原样返回（保持引用）。
+ */
+export function truncateOversizedMessages(messages, opts) {
+    const headRatio = opts.headRatio ?? DEFAULT_HEAD_RATIO;
+    const tailRatio = opts.tailRatio ?? DEFAULT_TAIL_RATIO;
+    const headBudget = Math.max(1, Math.floor(opts.maxSingleMessageBytes * headRatio));
+    const tailBudget = Math.max(1, Math.floor(opts.maxSingleMessageBytes * tailRatio));
+    let truncatedCount = 0;
+    let bytesSaved = 0;
+    const out = messages.map((msg, index) => {
+        const bytes = calculateMessageBytes(msg);
+        if (bytes <= opts.maxSingleMessageBytes) {
+            return msg;
+        }
+        const truncated = truncateMessage(msg, index, bytes, headBudget, tailBudget, opts.archiveWriter);
+        if (!truncated) {
+            return msg;
+        }
+        truncatedCount += 1;
+        bytesSaved += bytes - calculateMessageBytes(truncated);
+        return truncated;
+    });
+    return { messages: out, truncatedCount, bytesSaved };
+}
+function truncateMessage(msg, index, bytes, headBudget, tailBudget, archiveWriter) {
+    const fullText = contentToPlainText(msg.content);
+    const archivePath = archiveWriter?.({ index, role: msg.role, bytes, fullText });
+    const placeholder = buildPlaceholder(bytes, archivePath);
+    // 字符串内容：直接头尾保留 + 中段占位。
+    if (typeof msg.content === 'string') {
+        const newText = truncateStringToBytes(msg.content, headBudget, tailBudget, placeholder);
+        return { ...msg, content: newText };
+    }
+    // 数组内容：截断超大文本块；超大 image_url（巨型 base64）替换为占位文本块；
+    // 其余小块原样保留，维持结构与 tool 配对。
+    if (Array.isArray(msg.content)) {
+        const newParts = msg.content.map((part) => {
+            if (!part || typeof part !== 'object' || !('type' in part)) {
+                return part;
+            }
+            if (part.type === 'text') {
+                const partBytes = Buffer.byteLength(part.text || '', 'utf8');
+                if (partBytes > headBudget + tailBudget) {
+                    return { type: 'text', text: truncateStringToBytes(part.text || '', headBudget, tailBudget, placeholder) };
+                }
+                return part;
+            }
+            if (part.type === 'image_url') {
+                const urlBytes = Buffer.byteLength(part.image_url?.url || '', 'utf8');
+                if (urlBytes > headBudget + tailBudget) {
+                    return { type: 'text', text: `[超大内联图片已移除以规避请求体上限${archivePath ? `，原文见归档: ${archivePath}` : ''}]` };
+                }
+                return part;
+            }
+            return part;
+        });
+        return { ...msg, content: newParts };
+    }
+    return null;
+}
+function buildPlaceholder(originalBytes, archivePath) {
+    const kb = Math.round(originalBytes / 1024);
+    const archiveNote = archivePath ? `完整原文见归档: ${archivePath}` : '完整原文未归档';
+    return `\n\n[... 中段已截断（原 ${kb}KB 超单条字节上限），${archiveNote} ...]\n\n`;
+}
+/**
+ * 按 UTF-8 字节保留头部 headBytes + 尾部 tailBytes，中间插入占位符。
+ * code-point 安全（不切断 surrogate pair）。
+ */
+export function truncateStringToBytes(text, headBytes, tailBytes, placeholder) {
+    const total = Buffer.byteLength(text, 'utf8');
+    if (total <= headBytes + tailBytes) {
+        return text;
+    }
+    const head = sliceByBytesFromStart(text, headBytes);
+    const tail = sliceByBytesFromEnd(text, tailBytes);
+    return head + placeholder + tail;
+}
+function sliceByBytesFromStart(text, maxBytes) {
+    let bytes = 0;
+    let i = 0;
+    while (i < text.length) {
+        const cp = text.codePointAt(i);
+        const charLen = cp !== undefined && cp > 0xffff ? 2 : 1;
+        const ch = text.substr(i, charLen);
+        const cb = Buffer.byteLength(ch, 'utf8');
+        if (bytes + cb > maxBytes)
+            break;
+        bytes += cb;
+        i += charLen;
+    }
+    return text.slice(0, i);
+}
+function sliceByBytesFromEnd(text, maxBytes) {
+    let bytes = 0;
+    let i = text.length;
+    while (i > 0) {
+        let start = i - 1;
+        if (start > 0) {
+            const prev = text.charCodeAt(start - 1);
+            const cur = text.charCodeAt(start);
+            // 前一个是高代理、当前是低代理 → 合成一个 code point
+            if (prev >= 0xd800 && prev <= 0xdbff && cur >= 0xdc00 && cur <= 0xdfff) {
+                start -= 1;
+            }
+        }
+        const ch = text.slice(start, i);
+        const cb = Buffer.byteLength(ch, 'utf8');
+        if (bytes + cb > maxBytes)
+            break;
+        bytes += cb;
+        i = start;
+    }
+    return text.slice(i);
+}
+/**
+ * 构造一个把超大原文写入会话归档盘的同步归档写入器。
+ * 路径约定与 CompressionPipeline 的压缩归档一致：
+ *   leader → workspace/.lingxiao/sessions/<sessionId>/context/leader
+ *   agent  → workspace/.lingxiao/sessions/<sessionId>/context/agents/<agentId>
+ * 缺少 workspace/sessionId 时返回 undefined（不归档，仍会截断）。
+ */
+export function createOversizedArchiveWriter(params) {
+    const { owner, sessionId } = params;
+    if (!owner.workspace || !sessionId) {
+        return undefined;
+    }
+    return (info) => {
+        try {
+            const scopeDir = owner.kind === 'agent'
+                ? join(owner.workspace, '.lingxiao', 'sessions', sessionId, 'context', 'agents', owner.agentId || 'unknown')
+                : join(owner.workspace, '.lingxiao', 'sessions', sessionId, 'context', 'leader');
+            mkdirSync(scopeDir, { recursive: true });
+            const safeOwner = (owner.agentName || owner.agentId || owner.kind).replace(/[^a-zA-Z0-9_-]+/g, '_');
+            const filePath = join(scopeDir, `oversized-${Date.now()}-m${info.index}-${safeOwner}.md`);
+            const content = [
+                '# Oversized Message Archive',
+                '',
+                `- session_id: ${sessionId}`,
+                `- owner: ${owner.kind}${owner.agentName ? `/${owner.agentName}` : ''}`,
+                `- message_index: ${info.index}`,
+                `- role: ${info.role}`,
+                `- original_bytes: ${info.bytes}`,
+                `- created_at: ${new Date().toISOString()}`,
+                '',
+                '## Full Original Content',
+                info.fullText,
+                '',
+            ].join('\n');
+            writeFileSync(filePath, content, 'utf-8');
+            return filePath;
+        }
+        catch { /* expected: resource not available */
+            return undefined;
+        }
+    };
+}
+//# sourceMappingURL=MessageByteTruncator.js.map

package/dist/core/compress/MessageByteTruncator.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 共享字符串常量 — 消除魔数字符串
+ *
+ * 新增代码请使用这些枚举/常量替代硬编码字符串。
+ */
+export declare const TaskStatus: {
+    readonly PENDING: "pending";
+    readonly RUNNING: "running";
+    readonly COMPLETED: "completed";
+    readonly FAILED: "failed";
+    readonly CANCELLED: "cancelled";
+    readonly BLOCKED: "blocked";
+    readonly WAITING: "waiting";
+    readonly SUSPENDED: "suspended";
+    readonly ACTIVE: "active";
+    readonly KILLED: "killed";
+    readonly IDLE: "idle";
+};
+export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];
+export declare const MessageRole: {
+    readonly SYSTEM: "system";
+    readonly USER: "user";
+    readonly ASSISTANT: "assistant";
+    readonly TOOL: "tool";
+};
+export type MessageRole = (typeof MessageRole)[keyof typeof MessageRole];
+export declare const ToolName: {
+    readonly FILE_READ: "file_read";
+    readonly FILE_CREATE: "file_create";
+    readonly STRUCTURED_PATCH: "structured_patch";
+    readonly LIST_DIR: "list_dir";
+    readonly GLOB: "glob";
+    readonly CODE_SEARCH: "code_search";
+    readonly SHELL: "shell";
+    readonly GIT: "git";
+    readonly WEB_FETCH: "web_fetch";
+    readonly WEB_SEARCH: "web_search";
+    readonly MEMORY: "memory";
+    readonly TASK_COMPLETE: "task_complete";
+    readonly SEND_MESSAGE: "send_message";
+    readonly DELEGATE: "delegate";
+    readonly SCREENSHOT: "screenshot";
+    readonly OCR: "ocr";
+    readonly TERMINAL_CONTROL: "terminal_control";
+    readonly GET_TERMINAL_OUTPUT: "get_terminal_output";
+    readonly HTTP_REQUEST: "http_request";
+    readonly PYTHON_EXEC: "python_exec";
+    readonly SESSION_ARTIFACTS: "session_artifacts";
+    readonly PARSE_FILE: "parse_file";
+    readonly WRITE_WORK_NOTE: "write_work_note";
+    readonly READ_WORK_NOTES: "read_work_notes";
+    readonly REQUEST_WORK_NOTE: "request_work_note";
+};
+export type ToolName = (typeof ToolName)[keyof typeof ToolName];
+export declare const Channel: {
+    readonly LEADER_STATUS: "leader:status";
+    readonly AGENT_STATUS: "agent:status";
+    readonly TASK_UPDATE: "task:update";
+};
+export type Channel = (typeof Channel)[keyof typeof Channel];
+export declare const ExecutionMode: {
+    readonly DELEGATE: "delegate";
+    readonly DIRECT: "direct";
+    readonly PROBE: "probe";
+};
+export type ExecutionMode = (typeof ExecutionMode)[keyof typeof ExecutionMode];
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAGtE,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAGzE,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BX,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAGhE,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAG7D,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,67 @@
+/**
+ * 共享字符串常量 — 消除魔数字符串
+ *
+ * 新增代码请使用这些枚举/常量替代硬编码字符串。
+ */
+// ── Task & Agent Status ──
+export const TaskStatus = {
+    PENDING: 'pending',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    CANCELLED: 'cancelled',
+    BLOCKED: 'blocked',
+    WAITING: 'waiting',
+    SUSPENDED: 'suspended',
+    ACTIVE: 'active',
+    KILLED: 'killed',
+    IDLE: 'idle',
+};
+// ── Chat Message Roles ──
+export const MessageRole = {
+    SYSTEM: 'system',
+    USER: 'user',
+    ASSISTANT: 'assistant',
+    TOOL: 'tool',
+};
+// ── Tool Names (commonly referenced as strings) ──
+export const ToolName = {
+    FILE_READ: 'file_read',
+    FILE_CREATE: 'file_create',
+    STRUCTURED_PATCH: 'structured_patch',
+    LIST_DIR: 'list_dir',
+    GLOB: 'glob',
+    CODE_SEARCH: 'code_search',
+    SHELL: 'shell',
+    GIT: 'git',
+    WEB_FETCH: 'web_fetch',
+    WEB_SEARCH: 'web_search',
+    MEMORY: 'memory',
+    TASK_COMPLETE: 'task_complete',
+    SEND_MESSAGE: 'send_message',
+    DELEGATE: 'delegate',
+    SCREENSHOT: 'screenshot',
+    OCR: 'ocr',
+    TERMINAL_CONTROL: 'terminal_control',
+    GET_TERMINAL_OUTPUT: 'get_terminal_output',
+    HTTP_REQUEST: 'http_request',
+    PYTHON_EXEC: 'python_exec',
+    SESSION_ARTIFACTS: 'session_artifacts',
+    PARSE_FILE: 'parse_file',
+    WRITE_WORK_NOTE: 'write_work_note',
+    READ_WORK_NOTES: 'read_work_notes',
+    REQUEST_WORK_NOTE: 'request_work_note',
+};
+// ── Bus / Event Channel Names ──
+export const Channel = {
+    LEADER_STATUS: 'leader:status',
+    AGENT_STATUS: 'agent:status',
+    TASK_UPDATE: 'task:update',
+};
+// ── Execution Modes ──
+export const ExecutionMode = {
+    DELEGATE: 'delegate',
+    DIRECT: 'direct',
+    PROBE: 'probe',
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,2BAA2B;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,oDAAoD;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,gBAAgB,EAAE,kBAAkB;IACpC,mBAAmB,EAAE,qBAAqB;IAC1C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAE1B,iBAAiB,EAAE,mBAAmB;IACtC,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAGX,kCAAkC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AAGX,wBAAwB;AACxB,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACN,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Centralized error utilities for the Lingxiao CLI codebase.
+ */
+/**
+ * Safely extract a string message from an unknown caught value.
+ * Replaces the repeated `e instanceof Error ? e.message : String(e)` pattern.
+ */
+export declare function toErrorMessage(e: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAQjD"}

package/dist/core/errors.js

@@ -0,0 +1,20 @@
+/**
+ * Centralized error utilities for the Lingxiao CLI codebase.
+ */
+/**
+ * Safely extract a string message from an unknown caught value.
+ * Replaces the repeated `e instanceof Error ? e.message : String(e)` pattern.
+ */
+export function toErrorMessage(e) {
+    if (e instanceof Error)
+        return e.message;
+    if (typeof e === 'string')
+        return e;
+    try {
+        return JSON.stringify(e);
+    }
+    catch { /* expected: fallback to default */
+        return String(e);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,IAAI,CAAC,YAAY,KAAK;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC,CAAA,mCAAmC;QAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/core/git/GitEnv.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build a non-interactive environment for server-side git commands.
+ *
+ * The desktop host may export askpass helpers for GUI credential prompts, but
+ * those helpers are not allowed inside the app sandbox and should not be needed
+ * for read-only Git UI operations. Removing them also makes write operations
+ * fail fast instead of hanging on an invisible prompt.
+ */
+export declare function buildSafeGitEnv(base?: NodeJS.ProcessEnv | Record<string, string | undefined>, overrides?: Record<string, string | undefined>): Record<string, string>;
+//# sourceMappingURL=GitEnv.d.ts.map

package/dist/core/git/GitEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitEnv.d.ts","sourceRoot":"","sources":["../../../src/core/git/GitEnv.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EAC1E,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAM,GACjD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB"}

package/dist/core/git/GitEnv.js

@@ -0,0 +1,47 @@
+import { withToolProxyEnv } from '../ProxyConfig.js';
+const ASKPASS_ENV_KEYS = [
+    'GIT_ASKPASS',
+    'SSH_ASKPASS',
+    'ASKPASS',
+];
+const PAGER_ENV_KEYS = [
+    'GIT_PAGER',
+    'PAGER',
+];
+const EDITOR_ENV_KEYS = [
+    'GIT_EDITOR',
+    'EDITOR',
+    'VISUAL',
+];
+/**
+ * Build a non-interactive environment for server-side git commands.
+ *
+ * The desktop host may export askpass helpers for GUI credential prompts, but
+ * those helpers are not allowed inside the app sandbox and should not be needed
+ * for read-only Git UI operations. Removing them also makes write operations
+ * fail fast instead of hanging on an invisible prompt.
+ */
+export function buildSafeGitEnv(base = process.env, overrides = {}) {
+    const env = {};
+    for (const [key, value] of Object.entries(base)) {
+        if (value !== undefined)
+            env[key] = String(value);
+    }
+    for (const [key, value] of Object.entries(overrides)) {
+        if (value !== undefined)
+            env[key] = String(value);
+    }
+    for (const key of ASKPASS_ENV_KEYS) {
+        delete env[key];
+    }
+    for (const key of PAGER_ENV_KEYS) {
+        delete env[key];
+    }
+    for (const key of EDITOR_ENV_KEYS) {
+        delete env[key];
+    }
+    env.GIT_TERMINAL_PROMPT = '0';
+    env.GCM_INTERACTIVE = 'never';
+    return withToolProxyEnv(env);
+}
+//# sourceMappingURL=GitEnv.js.map

package/dist/core/git/GitEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitEnv.js","sourceRoot":"","sources":["../../../src/core/git/GitEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,gBAAgB,GAAG;IACvB,aAAa;IACb,aAAa;IACb,SAAS;CACD,CAAC;AAEX,MAAM,cAAc,GAAG;IACrB,WAAW;IACX,OAAO;CACC,CAAC;AAEX,MAAM,eAAe,GAAG;IACtB,YAAY;IACZ,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+D,OAAO,CAAC,GAAG,EAC1E,YAAgD,EAAE;IAElD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,GAAG,CAAC,mBAAmB,GAAG,GAAG,CAAC;IAC9B,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC;IAC9B,OAAO,gBAAgB,CAAC,GAAG,CAA2B,CAAC;AACzD,CAAC"}

package/dist/core/git/GitPlatformApi.d.ts

@@ -0,0 +1,90 @@
+/**
+ * GitPlatformApi — 对接 GitHub / GitLab / Gitea REST API
+ *
+ * 使用 Strategy Pattern，每个平台一个 Driver 实现。
+ * 外部 API 不变：new GitPlatformApi(config) → .createMR(), .mergeMR(), etc.
+ */
+export interface GitPlatformConfig {
+    platform: 'github' | 'gitlab' | 'gitea' | 'none';
+    token: string;
+    apiUrl?: string;
+    owner?: string;
+    repo?: string;
+}
+export interface MergeRequest {
+    id: number | string;
+    iid?: number;
+    title: string;
+    description: string;
+    state: 'open' | 'merged' | 'closed';
+    sourceBranch: string;
+    targetBranch: string;
+    url: string;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+    platform: 'github' | 'gitlab' | 'gitea';
+    draft: boolean;
+    labels: string[];
+    comments: number;
+}
+export interface CreateMRParams {
+    title: string;
+    description?: string;
+    sourceBranch: string;
+    targetBranch: string;
+    draft?: boolean;
+    labels?: string[];
+    assignee?: string;
+}
+export interface RepoInfo {
+    owner: string;
+    repo: string;
+    fullName: string;
+    description: string;
+    defaultBranch: string;
+    url: string;
+    isPrivate: boolean;
+    stars: number;
+    forks: number;
+}
+/**
+ * 平台不可用原因 — 确定性分类，供路由层判断是否优雅降级（而非一律 500）。
+ *
+ * - no_platform: 未配置任何 Git 平台（platform === 'none'）
+ * - no_owner_repo: 缺少 owner/repo，无法定位仓库
+ * - unauthorized: 401 — 无 token 或 token 无效
+ * - forbidden:    403 — token 无权限
+ * - not_found:    404 — 仓库不可见 / 不存在
+ *
+ * 其它失败（5xx、网络错误等）仍抛普通 Error，由路由作为真实 500 上报。
+ */
+export type GitPlatformUnavailableReason = 'no_platform' | 'no_owner_repo' | 'unauthorized' | 'forbidden' | 'not_found';
+export declare class GitPlatformUnavailableError extends Error {
+    readonly reason: GitPlatformUnavailableReason;
+    constructor(reason: GitPlatformUnavailableReason, message: string);
+}
+export declare class GitPlatformApi {
+    private config;
+    private driver?;
+    constructor(config: GitPlatformConfig);
+    private get headers();
+    private request;
+    private get repoPath();
+    private ensureDriver;
+    listMRs(state?: 'open' | 'closed' | 'merged' | 'all'): Promise<MergeRequest[]>;
+    getMR(id: number | string): Promise<MergeRequest | null>;
+    createMR(params: CreateMRParams): Promise<MergeRequest>;
+    mergeMR(id: number | string, method?: 'merge' | 'squash' | 'rebase'): Promise<void>;
+    closeMR(id: number | string): Promise<void>;
+    addComment(id: number | string, body: string): Promise<void>;
+    getRepoInfo(): Promise<RepoInfo | null>;
+    /**
+     * 测试连接是否有效
+     */
+    testConnection(): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=GitPlatformApi.d.ts.map

package/dist/core/git/GitPlatformApi.d.ts.map

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