@aetherai/aether 0.0.3

package/dist/CLI/packages/core/src/services/sessionService.js

@@ -0,0 +1,527 @@
+/**
+ * @license
+ * Copyright 2025 Qwen Code
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Storage } from '../config/storage.js';
+import { getProjectHash } from '../utils/paths.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import readline from 'node:readline';
+import * as jsonl from '../utils/jsonl-utils.js';
+import { uiTelemetryService } from '../telemetry/uiTelemetry.js';
+import { createDebugLogger } from '../utils/debugLogger.js';
+const debugLogger = createDebugLogger('SESSION');
+/**
+ * Maximum number of files to process when listing sessions.
+ * This is a safety limit to prevent performance issues with very large chat directories.
+ */
+const MAX_FILES_TO_PROCESS = 10000;
+/**
+ * Pattern for validating session file names.
+ * Session files are named as `${sessionId}.jsonl` where sessionId is a UUID-like identifier
+ * (32-36 hex characters, optionally with hyphens).
+ */
+const SESSION_FILE_PATTERN = /^[0-9a-fA-F-]{32,36}\.jsonl$/;
+/** Maximum number of lines to scan when looking for the first prompt text. */
+const MAX_PROMPT_SCAN_LINES = 10;
+/**
+ * Service for managing chat sessions.
+ *
+ * This service handles:
+ * - Listing sessions with pagination (ordered by mtime)
+ * - Loading full session data for resumption
+ * - Removing sessions
+ *
+ * Sessions are stored as JSONL files, one per session.
+ * File location: ~/.aether/tmp/<project_id>/chats/
+ */
+export class SessionService {
+    storage;
+    projectHash;
+    constructor(cwd) {
+        this.storage = new Storage(cwd);
+        this.projectHash = getProjectHash(cwd);
+    }
+    getChatsDir() {
+        return path.join(this.storage.getProjectDir(), 'chats');
+    }
+    /**
+     * Extracts the first user prompt text from a Content object.
+     */
+    extractPromptText(message) {
+        if (!message?.parts)
+            return '';
+        for (const part of message.parts) {
+            if ('text' in part) {
+                const textPart = part;
+                const text = textPart.text;
+                // Truncate long prompts for display
+                return text.length > 200 ? `${text.slice(0, 200)}...` : text;
+            }
+        }
+        return '';
+    }
+    /**
+     * Finds the first available prompt text by scanning the first N records,
+     * preferring user messages. Returns an empty string if none found.
+     */
+    extractFirstPromptFromRecords(records) {
+        for (const record of records) {
+            if (record.type !== 'user')
+                continue;
+            const prompt = this.extractPromptText(record.message);
+            if (prompt)
+                return prompt;
+        }
+        return '';
+    }
+    /**
+     * Counts unique message UUIDs in a session file.
+     * This gives the number of logical messages in the session.
+     */
+    async countSessionMessages(filePath) {
+        const uniqueUuids = new Set();
+        try {
+            const fileStream = fs.createReadStream(filePath);
+            const rl = readline.createInterface({
+                input: fileStream,
+                crlfDelay: Infinity,
+            });
+            for await (const line of rl) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    const record = JSON.parse(trimmed);
+                    if (record.type === 'user' || record.type === 'assistant') {
+                        uniqueUuids.add(record.uuid);
+                    }
+                }
+                catch {
+                    // Ignore malformed lines
+                    continue;
+                }
+            }
+            return uniqueUuids.size;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Lists sessions for the current project with pagination.
+     *
+     * Sessions are ordered by file modification time (most recent first).
+     * Uses cursor-based pagination with mtime as the cursor.
+     *
+     * Only reads the first line of each JSONL file for efficiency.
+     * Files are filtered by UUID pattern first, then by project hash.
+     *
+     * @param options Pagination options
+     * @returns Paginated list of sessions
+     */
+    async listSessions(options = {}) {
+        const { cursor, size = 20 } = options;
+        const chatsDir = this.getChatsDir();
+        // Get all valid session files (matching UUID pattern) with their stats
+        let files = [];
+        try {
+            const fileNames = fs.readdirSync(chatsDir);
+            for (const name of fileNames) {
+                // Only process files matching session file pattern
+                if (!SESSION_FILE_PATTERN.test(name))
+                    continue;
+                const filePath = path.join(chatsDir, name);
+                try {
+                    const stats = fs.statSync(filePath);
+                    files.push({ name, mtime: stats.mtimeMs });
+                }
+                catch {
+                    // Skip files we can't stat
+                    continue;
+                }
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { items: [], hasMore: false };
+            }
+            throw error;
+        }
+        // Sort by mtime descending (most recent first)
+        files.sort((a, b) => b.mtime - a.mtime);
+        // Apply cursor filter (items with mtime < cursor)
+        if (cursor !== undefined) {
+            files = files.filter((f) => f.mtime < cursor);
+        }
+        // Iterate through files until we have enough matching ones.
+        // Different projects may share the same chats directory due to path sanitization,
+        // so we need to filter by project hash and continue until we have enough items.
+        const items = [];
+        let filesProcessed = 0;
+        let lastProcessedMtime;
+        let hasMoreFiles = false;
+        for (const file of files) {
+            // Safety limit to prevent performance issues
+            if (filesProcessed >= MAX_FILES_TO_PROCESS) {
+                hasMoreFiles = true;
+                break;
+            }
+            // Stop if we have enough items
+            if (items.length >= size) {
+                hasMoreFiles = true;
+                break;
+            }
+            filesProcessed++;
+            lastProcessedMtime = file.mtime;
+            const filePath = path.join(chatsDir, file.name);
+            const records = await jsonl.readLines(filePath, MAX_PROMPT_SCAN_LINES);
+            if (records.length === 0)
+                continue;
+            const firstRecord = records[0];
+            // Skip if not matching current project
+            // We use cwd comparison since first record doesn't have projectHash
+            const recordProjectHash = getProjectHash(firstRecord.cwd);
+            if (recordProjectHash !== this.projectHash)
+                continue;
+            // Count messages for this session
+            const messageCount = await this.countSessionMessages(filePath);
+            const prompt = this.extractFirstPromptFromRecords(records);
+            items.push({
+                sessionId: firstRecord.sessionId,
+                cwd: firstRecord.cwd,
+                startTime: firstRecord.timestamp,
+                mtime: file.mtime,
+                prompt,
+                gitBranch: firstRecord.gitBranch,
+                filePath,
+                messageCount,
+            });
+        }
+        // Determine next cursor (mtime of last processed file)
+        // Only set if there are more files to process
+        const nextCursor = hasMoreFiles && lastProcessedMtime !== undefined
+            ? lastProcessedMtime
+            : undefined;
+        return {
+            items,
+            nextCursor,
+            hasMore: hasMoreFiles,
+        };
+    }
+    /**
+     * Reads all records from a session file.
+     */
+    async readAllRecords(filePath) {
+        try {
+            return await jsonl.read(filePath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                debugLogger.error('Error reading session file:', error);
+            }
+            return [];
+        }
+    }
+    /**
+     * Aggregates multiple records with the same uuid into a single ChatRecord.
+     * Merges content fields (message, tokens, model, toolCallResult).
+     */
+    aggregateRecords(records) {
+        if (records.length === 0) {
+            throw new Error('Cannot aggregate empty records array');
+        }
+        const base = { ...records[0] };
+        for (let i = 1; i < records.length; i++) {
+            const record = records[i];
+            // Merge message (Content objects)
+            if (record.message !== undefined) {
+                if (base.message === undefined) {
+                    base.message = record.message;
+                }
+                else {
+                    base.message = {
+                        role: base.message.role,
+                        parts: [
+                            ...(base.message.parts || []),
+                            ...(record.message.parts || []),
+                        ],
+                    };
+                }
+            }
+            // Merge tokens (take the latest)
+            if (record.usageMetadata) {
+                base.usageMetadata = record.usageMetadata;
+            }
+            // Merge toolCallResult
+            if (record.toolCallResult && !base.toolCallResult) {
+                base.toolCallResult = record.toolCallResult;
+            }
+            // Merge model (take the first non-empty one)
+            if (record.model && !base.model) {
+                base.model = record.model;
+            }
+            // Update timestamp to the latest
+            if (record.timestamp > base.timestamp) {
+                base.timestamp = record.timestamp;
+            }
+        }
+        return base;
+    }
+    /**
+     * Reconstructs a linear conversation from tree-structured records.
+     */
+    reconstructHistory(records, leafUuid) {
+        if (records.length === 0)
+            return [];
+        const recordsByUuid = new Map();
+        for (const record of records) {
+            const existing = recordsByUuid.get(record.uuid) || [];
+            existing.push(record);
+            recordsByUuid.set(record.uuid, existing);
+        }
+        let currentUuid = leafUuid ?? records[records.length - 1].uuid;
+        const uuidChain = [];
+        const visited = new Set();
+        while (currentUuid && !visited.has(currentUuid)) {
+            visited.add(currentUuid);
+            uuidChain.push(currentUuid);
+            const recordsForUuid = recordsByUuid.get(currentUuid);
+            if (!recordsForUuid || recordsForUuid.length === 0)
+                break;
+            currentUuid = recordsForUuid[0].parentUuid;
+        }
+        uuidChain.reverse();
+        const messages = [];
+        for (const uuid of uuidChain) {
+            const recordsForUuid = recordsByUuid.get(uuid);
+            if (recordsForUuid && recordsForUuid.length > 0) {
+                messages.push(this.aggregateRecords(recordsForUuid));
+            }
+        }
+        return messages;
+    }
+    /**
+     * Loads a session by its session ID.
+     * Reconstructs the full conversation from tree-structured records.
+     *
+     * @param sessionId The session ID to load
+     * @returns Session data for resumption, or null if not found
+     */
+    async loadSession(sessionId) {
+        const chatsDir = this.getChatsDir();
+        const filePath = path.join(chatsDir, `${sessionId}.jsonl`);
+        const records = await this.readAllRecords(filePath);
+        if (records.length === 0) {
+            return;
+        }
+        // Verify this session belongs to the current project
+        const firstRecord = records[0];
+        const recordProjectHash = getProjectHash(firstRecord.cwd);
+        if (recordProjectHash !== this.projectHash) {
+            return;
+        }
+        // Reconstruct linear history
+        const messages = this.reconstructHistory(records);
+        if (messages.length === 0) {
+            return;
+        }
+        const lastMessage = messages[messages.length - 1];
+        const stats = fs.statSync(filePath);
+        const conversation = {
+            sessionId: firstRecord.sessionId,
+            projectHash: this.projectHash,
+            startTime: firstRecord.timestamp,
+            lastUpdated: new Date(stats.mtimeMs).toISOString(),
+            messages,
+        };
+        return {
+            conversation,
+            filePath,
+            lastCompletedUuid: lastMessage.uuid,
+        };
+    }
+    /**
+     * Removes a session by its session ID.
+     *
+     * @param sessionId The session ID to remove
+     * @returns true if removed, false if not found
+     */
+    async removeSession(sessionId) {
+        const chatsDir = this.getChatsDir();
+        const filePath = path.join(chatsDir, `${sessionId}.jsonl`);
+        try {
+            // Verify the file exists and belongs to this project
+            const records = await jsonl.readLines(filePath, 1);
+            if (records.length === 0) {
+                return false;
+            }
+            const recordProjectHash = getProjectHash(records[0].cwd);
+            if (recordProjectHash !== this.projectHash) {
+                return false;
+            }
+            fs.unlinkSync(filePath);
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Loads the most recent session for the current project.
+     * Combines listSessions and loadSession for convenience.
+     *
+     * @returns Session data for resumption, or undefined if no sessions exist
+     */
+    async loadLastSession() {
+        const result = await this.listSessions({ size: 1 });
+        if (result.items.length === 0) {
+            return;
+        }
+        return this.loadSession(result.items[0].sessionId);
+    }
+    /**
+     * Checks if a session exists by its session ID.
+     *
+     * @param sessionId The session ID to check
+     * @returns true if session exists and belongs to current project
+     */
+    async sessionExists(sessionId) {
+        const chatsDir = this.getChatsDir();
+        const filePath = path.join(chatsDir, `${sessionId}.jsonl`);
+        try {
+            const records = await jsonl.readLines(filePath, 1);
+            if (records.length === 0) {
+                return false;
+            }
+            const recordProjectHash = getProjectHash(records[0].cwd);
+            return recordProjectHash === this.projectHash;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Strips thought parts from a Content object.
+ * Thought parts are identified by having `thought: true`.
+ * Returns null if the content only contained thought parts.
+ */
+function stripThoughtsFromContent(content) {
+    if (!content.parts)
+        return content;
+    const filteredParts = content.parts.filter((part) => !part.thought);
+    // If all parts were thoughts, remove the entire content
+    if (filteredParts.length === 0) {
+        return null;
+    }
+    return {
+        ...content,
+        parts: filteredParts,
+    };
+}
+/**
+ * Builds the model-facing chat history (Content[]) from a reconstructed
+ * conversation. This keeps UI history intact while applying chat compression
+ * checkpoints for the API history used on resume.
+ *
+ * Strategy:
+ * - Find the latest system/chat_compression record (if any).
+ * - Use its compressedHistory snapshot as the base history.
+ * - Append all messages after that checkpoint (skipping system records).
+ * - If no checkpoint exists, return the linear message list (message field only).
+ */
+export function buildApiHistoryFromConversation(conversation, options = {}) {
+    const { stripThoughtsFromHistory = true } = options;
+    const { messages } = conversation;
+    let lastCompressionIndex = -1;
+    let compressedHistory;
+    messages.forEach((record, index) => {
+        if (record.type === 'system' && record.subtype === 'chat_compression') {
+            const payload = record.systemPayload;
+            if (payload?.compressedHistory) {
+                lastCompressionIndex = index;
+                compressedHistory = payload.compressedHistory;
+            }
+        }
+    });
+    if (compressedHistory && lastCompressionIndex >= 0) {
+        const baseHistory = structuredClone(compressedHistory);
+        // Append everything after the compression record (newer turns)
+        for (let i = lastCompressionIndex + 1; i < messages.length; i++) {
+            const record = messages[i];
+            if (record.type === 'system')
+                continue;
+            if (record.message) {
+                baseHistory.push(structuredClone(record.message));
+            }
+        }
+        if (stripThoughtsFromHistory) {
+            return baseHistory
+                .map(stripThoughtsFromContent)
+                .filter((content) => content !== null);
+        }
+        return baseHistory;
+    }
+    // Fallback: return linear messages as Content[]
+    const result = messages
+        .map((record) => record.message)
+        .filter((message) => message !== undefined)
+        .map((message) => structuredClone(message));
+    if (stripThoughtsFromHistory) {
+        return result
+            .map(stripThoughtsFromContent)
+            .filter((content) => content !== null);
+    }
+    return result;
+}
+/**
+ * Replays stored UI telemetry events to rebuild metrics when resuming a session.
+ * Also restores the last prompt token count from the best available source.
+ */
+export function replayUiTelemetryFromConversation(conversation) {
+    uiTelemetryService.reset();
+    for (const record of conversation.messages) {
+        if (record.type !== 'system' || record.subtype !== 'ui_telemetry') {
+            continue;
+        }
+        const payload = record.systemPayload;
+        const uiEvent = payload?.uiEvent;
+        if (uiEvent) {
+            uiTelemetryService.addEvent(uiEvent);
+        }
+    }
+    const resumePromptTokens = getResumePromptTokenCount(conversation);
+    if (resumePromptTokens !== undefined) {
+        uiTelemetryService.setLastPromptTokenCount(resumePromptTokens);
+    }
+}
+/**
+ * Returns the best available prompt token count for resuming telemetry:
+ * - If a chat compression checkpoint exists, use its new token count.
+ * - Otherwise, use the last assistant usageMetadata input (fallback to total).
+ */
+export function getResumePromptTokenCount(conversation) {
+    let fallback;
+    for (let i = conversation.messages.length - 1; i >= 0; i--) {
+        const record = conversation.messages[i];
+        if (record.type === 'system' && record.subtype === 'chat_compression') {
+            const payload = record.systemPayload;
+            if (payload?.info) {
+                return payload.info.newTokenCount;
+            }
+        }
+        if (fallback === undefined && record.type === 'assistant') {
+            const usage = record.usageMetadata;
+            if (usage) {
+                fallback = usage.totalTokenCount ?? usage.promptTokenCount;
+            }
+        }
+    }
+    return fallback;
+}
+//# sourceMappingURL=sessionService.js.map

package/dist/CLI/packages/core/src/services/sessionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionService.js","sourceRoot":"","sources":["../../../../../../../core/src/services/sessionService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,KAAK,KAAK,MAAM,yBAAyB,CAAC;AAMjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAgFjD;;;GAGG;AACH,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAC5D,8EAA8E;AAC9E,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,CAAU;IACjB,WAAW,CAAS;IAErC,YAAY,GAAW;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,OAA4B;QACpD,IAAI,CAAC,OAAO,EAAE,KAAK;YAAE,OAAO,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAe,EAAE,CAAC;YAC3C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,QAAQ,GAAG,IAAwB,CAAC;gBAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;gBAC3B,oCAAoC;gBACpC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACK,6BAA6B,CAAC,OAAqB;QACzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,oBAAoB,CAAC,QAAgB;QACjD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;gBAClC,KAAK,EAAE,UAAU;gBACjB,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAC;oBACjD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;wBAC1D,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,yBAAyB;oBACzB,SAAS;gBACX,CAAC;YACH,CAAC;YAED,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,YAAY,CAChB,UAA+B,EAAE;QAEjC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,uEAAuE;QACvE,IAAI,KAAK,GAA2C,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,mDAAmD;gBACnD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;oBAC3B,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,+CAA+C;QAC/C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAExC,kDAAkD;QAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAChD,CAAC;QAED,4DAA4D;QAC5D,kFAAkF;QAClF,gFAAgF;QAChF,MAAM,KAAK,GAAsB,EAAE,CAAC;QACpC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,kBAAsC,CAAC;QAC3C,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,6CAA6C;YAC7C,IAAI,cAAc,IAAI,oBAAoB,EAAE,CAAC;gBAC3C,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,CAAC;YAED,+BAA+B;YAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;gBACzB,YAAY,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,CAAC;YAED,cAAc,EAAE,CAAC;YACjB,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC;YAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CACnC,QAAQ,EACR,qBAAqB,CACtB,CAAC;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACnC,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAE/B,uCAAuC;YACvC,oEAAoE;YACpE,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC1D,IAAI,iBAAiB,KAAK,IAAI,CAAC,WAAW;gBAAE,SAAS;YAErD,kCAAkC;YAClC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAG,IAAI,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;YAE3D,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,WAAW,CAAC,SAAS;gBAChC,GAAG,EAAE,WAAW,CAAC,GAAG;gBACpB,SAAS,EAAE,WAAW,CAAC,SAAS;gBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM;gBACN,SAAS,EAAE,WAAW,CAAC,SAAS;gBAChC,QAAQ;gBACR,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QAED,uDAAuD;QACvD,8CAA8C;QAC9C,MAAM,UAAU,GACd,YAAY,IAAI,kBAAkB,KAAK,SAAS;YAC9C,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,KAAK;YACL,UAAU;YACV,OAAO,EAAE,YAAY;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,QAAgB;QAC3C,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,IAAI,CAAa,QAAQ,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,WAAW,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,gBAAgB,CAAC,OAAqB;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAE1B,kCAAkC;YAClC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,OAAO,GAAG;wBACb,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;wBACvB,KAAK,EAAE;4BACL,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;4BAC7B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;yBAChC;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;YAC5C,CAAC;YAED,uBAAuB;YACvB,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBAClD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC9C,CAAC;YAED,6CAA6C;YAC7C,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,CAAC;YAED,iCAAiC;YACjC,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YACpC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,kBAAkB,CACxB,OAAqB,EACrB,QAAiB;QAEjB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;QACtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,WAAW,GACb,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,OAAO,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACzB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5B,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACtD,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAC1D,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7C,CAAC;QAED,SAAS,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,SAAiB;QAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,qDAAqD;QACrD,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,iBAAiB,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEpC,MAAM,YAAY,GAAuB;YACvC,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YAClD,QAAQ;SACT,CAAC;QAEF,OAAO;YACL,YAAY;YACZ,QAAQ;YACR,iBAAiB,EAAE,WAAW,CAAC,IAAI;SACpC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,qDAAqD;YACrD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAa,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACzD,IAAI,iBAAiB,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAa,QAAQ,EAAE,CAAC,CAAC,CAAC;YAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACzD,OAAO,iBAAiB,KAAK,IAAI,CAAC,WAAW,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAcD;;;;GAIG;AACH,SAAS,wBAAwB,CAAC,OAAgB;IAChD,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAEnC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAE,IAAa,CAAC,OAAO,CAAC,CAAC;IAE9E,wDAAwD;IACxD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,aAAa;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAC7C,YAAgC,EAChC,UAAkC,EAAE;IAEpC,MAAM,EAAE,wBAAwB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;IAElC,IAAI,oBAAoB,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,iBAAwC,CAAC;IAE7C,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACjC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,CAAC,aAEV,CAAC;YACd,IAAI,OAAO,EAAE,iBAAiB,EAAE,CAAC;gBAC/B,oBAAoB,GAAG,KAAK,CAAC;gBAC7B,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,iBAAiB,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,WAAW,GAAc,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAElE,+DAA+D;QAC/D,KAAK,IAAI,CAAC,GAAG,oBAAoB,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAkB,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,IAAI,wBAAwB,EAAE,CAAC;YAC7B,OAAO,WAAW;iBACf,GAAG,CAAC,wBAAwB,CAAC;iBAC7B,MAAM,CAAC,CAAC,OAAO,EAAsB,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,gDAAgD;IAChD,MAAM,MAAM,GAAG,QAAQ;SACpB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;SAC/B,MAAM,CAAC,CAAC,OAAO,EAAsB,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC;SAC9D,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IAE9C,IAAI,wBAAwB,EAAE,CAAC;QAC7B,OAAO,MAAM;aACV,GAAG,CAAC,wBAAwB,CAAC;aAC7B,MAAM,CAAC,CAAC,OAAO,EAAsB,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,YAAgC;IAEhC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAE3B,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;YAClE,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,aAEV,CAAC;QACd,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QACjC,IAAI,OAAO,EAAE,CAAC;YACZ,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,kBAAkB,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAgC;IAEhC,IAAI,QAA4B,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,MAAM,CAAC,aAEV,CAAC;YACd,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,OAAO,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;YACpC,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,QAAQ,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,gBAAgB,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/CLI/packages/core/src/services/shellExecutionService.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type AnsiOutput } from '../utils/terminalSerializer.js';
+/** A structured result from a shell command execution. */
+export interface ShellExecutionResult {
+    /** The raw, unprocessed output buffer. */
+    rawOutput: Buffer;
+    /** The combined, decoded output as a string. */
+    output: string;
+    /** The process exit code, or null if terminated by a signal. */
+    exitCode: number | null;
+    /** The signal that terminated the process, if any. */
+    signal: number | null;
+    /** An error object if the process failed to spawn. */
+    error: Error | null;
+    /** A boolean indicating if the command was aborted by the user. */
+    aborted: boolean;
+    /** The process ID of the spawned shell. */
+    pid: number | undefined;
+    /** The method used to execute the shell command. */
+    executionMethod: 'lydell-node-pty' | 'node-pty' | 'child_process' | 'none';
+}
+/** A handle for an ongoing shell execution. */
+export interface ShellExecutionHandle {
+    /** The process ID of the spawned shell. */
+    pid: number | undefined;
+    /** A promise that resolves with the complete execution result. */
+    result: Promise<ShellExecutionResult>;
+}
+export interface ShellExecutionConfig {
+    terminalWidth?: number;
+    terminalHeight?: number;
+    pager?: string;
+    showColor?: boolean;
+    defaultFg?: string;
+    defaultBg?: string;
+    disableDynamicLineTrimming?: boolean;
+}
+/**
+ * Describes a structured event emitted during shell command execution.
+ */
+export type ShellOutputEvent = {
+    /** The event contains a chunk of output data. */
+    type: 'data';
+    /** The decoded string chunk. */
+    chunk: string | AnsiOutput;
+} | {
+    /** Signals that the output stream has been identified as binary. */
+    type: 'binary_detected';
+} | {
+    /** Provides progress updates for a binary stream. */
+    type: 'binary_progress';
+    /** The total number of bytes received so far. */
+    bytesReceived: number;
+};
+/**
+ * A centralized service for executing shell commands with robust process
+ * management, cross-platform compatibility, and streaming output capabilities.
+ *
+ */
+export declare class ShellExecutionService {
+    private static activePtys;
+    private static activeChildProcesses;
+    static cleanup(): void;
+    /**
+     * Executes a shell command using `node-pty`, capturing all output and lifecycle events.
+     *
+     * @param commandToExecute The exact command string to run.
+     * @param cwd The working directory to execute the command in.
+     * @param onOutputEvent A callback for streaming structured events about the execution, including data chunks and status updates.
+     * @param abortSignal An AbortSignal to terminate the process and its children.
+     * @returns An object containing the process ID (pid) and a promise that
+     *          resolves with the complete execution result.
+     */
+    static execute(commandToExecute: string, cwd: string, onOutputEvent: (event: ShellOutputEvent) => void, abortSignal: AbortSignal, shouldUseNodePty: boolean, shellExecutionConfig: ShellExecutionConfig): Promise<ShellExecutionHandle>;
+    private static childProcessFallback;
+    private static executeWithPty;
+    /**
+     * Writes a string to the pseudo-terminal (PTY) of a running process.
+     *
+     * @param pid The process ID of the target PTY.
+     * @param input The string to write to the terminal.
+     */
+    static writeToPty(pid: number, input: string): void;
+    static isPtyActive(pid: number): boolean;
+    /**
+     * Resizes the pseudo-terminal (PTY) of a running process.
+     *
+     * @param pid The process ID of the target PTY.
+     * @param cols The new number of columns.
+     * @param rows The new number of rows.
+     */
+    static resizePty(pid: number, cols: number, rows: number): void;
+    /**
+     * Scrolls the pseudo-terminal (PTY) of a running process.
+     *
+     * @param pid The process ID of the target PTY.
+     * @param lines The number of lines to scroll.
+     */
+    static scrollPty(pid: number, lines: number): void;
+}