@aetherai/aether 0.0.8 → 0.0.10

package/dist/CLI/packages/core/src/hooks/types.js

@@ -0,0 +1,376 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createDebugLogger } from '../utils/debugLogger.js';
+const debugLogger = createDebugLogger('TRUSTED_HOOKS');
+export var HooksConfigSource;
+(function (HooksConfigSource) {
+    HooksConfigSource["Project"] = "project";
+    HooksConfigSource["User"] = "user";
+    HooksConfigSource["System"] = "system";
+    HooksConfigSource["Extensions"] = "extensions";
+})(HooksConfigSource || (HooksConfigSource = {}));
+/**
+ * Event names for the hook system
+ */
+export var HookEventName;
+(function (HookEventName) {
+    // PreToolUse - Before tool execution
+    HookEventName["PreToolUse"] = "PreToolUse";
+    // PostToolUse - After tool execution
+    HookEventName["PostToolUse"] = "PostToolUse";
+    // PostToolUseFailure - After tool execution fails
+    HookEventName["PostToolUseFailure"] = "PostToolUseFailure";
+    // Notification - When notifications are sent
+    HookEventName["Notification"] = "Notification";
+    // UserPromptSubmit - When the user submits a prompt
+    HookEventName["UserPromptSubmit"] = "UserPromptSubmit";
+    // SessionStart - When a new session is started
+    HookEventName["SessionStart"] = "SessionStart";
+    // Stop - Right before Claude concludes its response
+    HookEventName["Stop"] = "Stop";
+    // SubagentStart - When a subagent (Task tool call) is started
+    HookEventName["SubagentStart"] = "SubagentStart";
+    // SubagentStop - Right before a subagent (Task tool call) concludes its response
+    HookEventName["SubagentStop"] = "SubagentStop";
+    // PreCompact - Before conversation compaction
+    HookEventName["PreCompact"] = "PreCompact";
+    // SessionEnd - When a session is ending
+    HookEventName["SessionEnd"] = "SessionEnd";
+    // When a permission dialog is displayed
+    HookEventName["PermissionRequest"] = "PermissionRequest";
+})(HookEventName || (HookEventName = {}));
+/**
+ * Fields in the hooks configuration that are not hook event names
+ */
+export const HOOKS_CONFIG_FIELDS = ['enabled', 'disabled', 'notifications'];
+/**
+ * Hook implementation types
+ */
+export var HookType;
+(function (HookType) {
+    HookType["Command"] = "command";
+})(HookType || (HookType = {}));
+/**
+ * Generate a unique key for a hook configuration
+ */
+export function getHookKey(hook) {
+    const name = hook.name ?? '';
+    return name ? `${name}:${hook.command}` : hook.command;
+}
+/**
+ * Factory function to create the appropriate hook output class based on event name
+ * Returns specialized HookOutput subclasses for events with specific methods
+ */
+export function createHookOutput(eventName, data) {
+    switch (eventName) {
+        case HookEventName.PreToolUse:
+            return new PreToolUseHookOutput(data);
+        case HookEventName.PostToolUse:
+            return new PostToolUseHookOutput(data);
+        case HookEventName.PostToolUseFailure:
+            return new PostToolUseFailureHookOutput(data);
+        case HookEventName.Stop:
+        case HookEventName.SubagentStop:
+            return new StopHookOutput(data);
+        case HookEventName.PermissionRequest:
+            return new PermissionRequestHookOutput(data);
+        default:
+            return new DefaultHookOutput(data);
+    }
+}
+/**
+ * Default implementation of HookOutput with utility methods
+ */
+export class DefaultHookOutput {
+    continue;
+    stopReason;
+    suppressOutput;
+    systemMessage;
+    decision;
+    reason;
+    hookSpecificOutput;
+    constructor(data = {}) {
+        this.continue = data.continue;
+        this.stopReason = data.stopReason;
+        this.suppressOutput = data.suppressOutput;
+        this.systemMessage = data.systemMessage;
+        this.decision = data.decision;
+        this.reason = data.reason;
+        this.hookSpecificOutput = data.hookSpecificOutput;
+    }
+    /**
+     * Check if this output represents a blocking decision
+     */
+    isBlockingDecision() {
+        return this.decision === 'block' || this.decision === 'deny';
+    }
+    /**
+     * Check if this output requests to stop execution
+     */
+    shouldStopExecution() {
+        return this.continue === false;
+    }
+    /**
+     * Get the effective reason for blocking or stopping
+     */
+    getEffectiveReason() {
+        return this.stopReason || this.reason || 'No reason provided';
+    }
+    /**
+     * Get sanitized additional context for adding to responses.
+     */
+    getAdditionalContext() {
+        if (this.hookSpecificOutput &&
+            'additionalContext' in this.hookSpecificOutput) {
+            const context = this.hookSpecificOutput['additionalContext'];
+            if (typeof context !== 'string') {
+                return undefined;
+            }
+            // Sanitize by escaping < and > to prevent tag injection
+            return context.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        }
+        return undefined;
+    }
+    /**
+     * Check if execution should be blocked and return error info
+     */
+    getBlockingError() {
+        if (this.isBlockingDecision()) {
+            return {
+                blocked: true,
+                reason: this.getEffectiveReason(),
+            };
+        }
+        return { blocked: false, reason: '' };
+    }
+    /**
+     * Check if context clearing was requested by hook.
+     */
+    shouldClearContext() {
+        return false;
+    }
+}
+/**
+ * Specific hook output class for PreToolUse events.
+ */
+export class PreToolUseHookOutput extends DefaultHookOutput {
+    /**
+     * Get permission decision from hook output
+     * @returns 'allow' | 'deny' | 'ask' | undefined
+     */
+    getPermissionDecision() {
+        if (this.hookSpecificOutput &&
+            'permissionDecision' in this.hookSpecificOutput) {
+            const decision = this.hookSpecificOutput['permissionDecision'];
+            if (decision === 'allow' || decision === 'deny' || decision === 'ask') {
+                return decision;
+            }
+        }
+        // Fall back to base decision field
+        if (this.decision === 'allow' || this.decision === 'approve') {
+            return 'allow';
+        }
+        if (this.decision === 'deny' || this.decision === 'block') {
+            return 'deny';
+        }
+        if (this.decision === 'ask') {
+            return 'ask';
+        }
+        return undefined;
+    }
+    /**
+     * Get permission decision reason
+     */
+    getPermissionDecisionReason() {
+        if (this.hookSpecificOutput &&
+            'permissionDecisionReason' in this.hookSpecificOutput) {
+            const reason = this.hookSpecificOutput['permissionDecisionReason'];
+            if (typeof reason === 'string') {
+                return reason;
+            }
+        }
+        return this.reason;
+    }
+    /**
+     * Check if permission was denied
+     */
+    isDenied() {
+        return this.getPermissionDecision() === 'deny';
+    }
+    /**
+     * Check if user confirmation is required
+     */
+    isAsk() {
+        return this.getPermissionDecision() === 'ask';
+    }
+    /**
+     * Check if permission was allowed
+     */
+    isAllowed() {
+        return this.getPermissionDecision() === 'allow';
+    }
+}
+/**
+ * Specific hook output class for PostToolUse events.
+ * Default behavior is to allow tool usage if the hook does not explicitly set a decision.
+ * This follows the security model of allowing by default unless explicitly blocked.
+ */
+export class PostToolUseHookOutput extends DefaultHookOutput {
+    decision;
+    reason;
+    constructor(data = {}) {
+        super(data);
+        // Default to allowing tool usage if hook does not provide explicit decision
+        // This maintains backward compatibility and follows security model of allowing by default
+        this.decision = data.decision ?? 'allow';
+        this.reason = data.reason ?? 'No reason provided';
+        // Log when default values are used to help with debugging
+        if (data.decision === undefined) {
+            debugLogger.debug('PostToolUseHookOutput: No explicit decision set, defaulting to "allow"');
+        }
+        if (data.reason === undefined) {
+            debugLogger.debug('PostToolUseHookOutput: No explicit reason set, defaulting to "No reason provided"');
+        }
+    }
+}
+/**
+ * Specific hook output class for PostToolUseFailure events.
+ */
+export class PostToolUseFailureHookOutput extends DefaultHookOutput {
+    /**
+     * Get additional context to provide error handling information
+     */
+    getAdditionalContext() {
+        return super.getAdditionalContext();
+    }
+}
+/**
+ * Specific hook output class for Stop events.
+ */
+export class StopHookOutput extends DefaultHookOutput {
+    stopReason;
+    constructor(data = {}) {
+        super(data);
+        this.stopReason = data.stopReason;
+    }
+    /**
+     * Get the stop reason if provided
+     */
+    getStopReason() {
+        if (!this.stopReason) {
+            return undefined;
+        }
+        return `Stop hook feedback:\n${this.stopReason}`;
+    }
+}
+/**
+ * Specific hook output class for PermissionRequest events.
+ */
+export class PermissionRequestHookOutput extends DefaultHookOutput {
+    /**
+     * Get the permission decision if provided by hook
+     */
+    getPermissionDecision() {
+        if (this.hookSpecificOutput && 'decision' in this.hookSpecificOutput) {
+            const decision = this.hookSpecificOutput['decision'];
+            if (typeof decision === 'object' &&
+                decision !== null &&
+                !Array.isArray(decision)) {
+                return decision;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if the permission was denied
+     */
+    isPermissionDenied() {
+        const decision = this.getPermissionDecision();
+        return decision?.behavior === 'deny';
+    }
+    /**
+     * Get the deny message if permission was denied
+     */
+    getDenyMessage() {
+        const decision = this.getPermissionDecision();
+        return decision?.message;
+    }
+    /**
+     * Check if execution should be interrupted after denial
+     */
+    shouldInterrupt() {
+        const decision = this.getPermissionDecision();
+        return decision?.interrupt === true;
+    }
+    /**
+     * Get updated tool input if permission was allowed with modifications
+     */
+    getUpdatedToolInput() {
+        const decision = this.getPermissionDecision();
+        return decision?.updatedInput;
+    }
+    /**
+     * Get updated permissions if permission was allowed with permission updates
+     */
+    getUpdatedPermissions() {
+        const decision = this.getPermissionDecision();
+        return decision?.updatedPermissions;
+    }
+}
+/**
+ * Notification types
+ */
+export var NotificationType;
+(function (NotificationType) {
+    NotificationType["PermissionPrompt"] = "permission_prompt";
+    NotificationType["IdlePrompt"] = "idle_prompt";
+    NotificationType["AuthSuccess"] = "auth_success";
+    NotificationType["ElicitationDialog"] = "elicitation_dialog";
+})(NotificationType || (NotificationType = {}));
+/**
+ * SessionStart source types
+ */
+export var SessionStartSource;
+(function (SessionStartSource) {
+    SessionStartSource["Startup"] = "startup";
+    SessionStartSource["Resume"] = "resume";
+    SessionStartSource["Clear"] = "clear";
+    SessionStartSource["Compact"] = "compact";
+})(SessionStartSource || (SessionStartSource = {}));
+export var PermissionMode;
+(function (PermissionMode) {
+    PermissionMode["Default"] = "default";
+    PermissionMode["Plan"] = "plan";
+    PermissionMode["AutoEdit"] = "auto_edit";
+    PermissionMode["Yolo"] = "yolo";
+})(PermissionMode || (PermissionMode = {}));
+/**
+ * SessionEnd reason types
+ */
+export var SessionEndReason;
+(function (SessionEndReason) {
+    SessionEndReason["Clear"] = "clear";
+    SessionEndReason["Logout"] = "logout";
+    SessionEndReason["PromptInputExit"] = "prompt_input_exit";
+    SessionEndReason["Bypass_permissions_disabled"] = "bypass_permissions_disabled";
+    SessionEndReason["Other"] = "other";
+})(SessionEndReason || (SessionEndReason = {}));
+/**
+ * PreCompress trigger types
+ */
+export var PreCompactTrigger;
+(function (PreCompactTrigger) {
+    PreCompactTrigger["Manual"] = "manual";
+    PreCompactTrigger["Auto"] = "auto";
+})(PreCompactTrigger || (PreCompactTrigger = {}));
+export var AgentType;
+(function (AgentType) {
+    AgentType["Bash"] = "Bash";
+    AgentType["Explorer"] = "Explorer";
+    AgentType["Plan"] = "Plan";
+    AgentType["Custom"] = "Custom";
+})(AgentType || (AgentType = {}));
+//# sourceMappingURL=types.js.map

package/dist/CLI/packages/core/src/hooks/types.js.map

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

package/dist/CLI/packages/core/src/ide/constants.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const AETHER_CODE_COMPANION_EXTENSION_NAME = "Aether Companion";
+export declare const IDE_MAX_OPEN_FILES = 10;
+export declare const IDE_MAX_SELECTED_TEXT_LENGTH = 16384;
+export declare const IDE_REQUEST_TIMEOUT_MS: number;

package/dist/CLI/packages/core/src/ide/constants.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const AETHER_CODE_COMPANION_EXTENSION_NAME = 'Aether Companion';
+export const IDE_MAX_OPEN_FILES = 10;
+export const IDE_MAX_SELECTED_TEXT_LENGTH = 16384; // 16 KiB limit
+export const IDE_REQUEST_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+//# sourceMappingURL=constants.js.map

package/dist/CLI/packages/core/src/ide/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../../core/src/ide/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,kBAAkB,CAAC;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,CAAC,eAAe;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa"}

package/dist/CLI/packages/core/src/ide/detect-ide.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const IDE_DEFINITIONS: {
+    readonly devin: {
+        readonly name: "devin";
+        readonly displayName: "Devin";
+    };
+    readonly replit: {
+        readonly name: "replit";
+        readonly displayName: "Replit";
+    };
+    readonly cursor: {
+        readonly name: "cursor";
+        readonly displayName: "Cursor";
+    };
+    readonly cloudshell: {
+        readonly name: "cloudshell";
+        readonly displayName: "Cloud Shell";
+    };
+    readonly codespaces: {
+        readonly name: "codespaces";
+        readonly displayName: "GitHub Codespaces";
+    };
+    readonly firebasestudio: {
+        readonly name: "firebasestudio";
+        readonly displayName: "Firebase Studio";
+    };
+    readonly trae: {
+        readonly name: "trae";
+        readonly displayName: "Trae";
+    };
+    readonly vscode: {
+        readonly name: "vscode";
+        readonly displayName: "VS Code";
+    };
+    readonly vscodefork: {
+        readonly name: "vscodefork";
+        readonly displayName: "IDE";
+    };
+};
+export interface IdeInfo {
+    name: string;
+    displayName: string;
+}
+export declare function isCloudShell(): boolean;
+export declare function detectIdeFromEnv(): IdeInfo;
+export declare function detectIde(ideProcessInfo: {
+    pid: number;
+    command: string;
+}, ideInfoFromFile?: {
+    name?: string;
+    displayName?: string;
+}): IdeInfo | undefined;

package/dist/CLI/packages/core/src/ide/detect-ide.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const IDE_DEFINITIONS = {
+    devin: { name: 'devin', displayName: 'Devin' },
+    replit: { name: 'replit', displayName: 'Replit' },
+    cursor: { name: 'cursor', displayName: 'Cursor' },
+    cloudshell: { name: 'cloudshell', displayName: 'Cloud Shell' },
+    codespaces: { name: 'codespaces', displayName: 'GitHub Codespaces' },
+    firebasestudio: { name: 'firebasestudio', displayName: 'Firebase Studio' },
+    trae: { name: 'trae', displayName: 'Trae' },
+    vscode: { name: 'vscode', displayName: 'VS Code' },
+    vscodefork: { name: 'vscodefork', displayName: 'IDE' },
+};
+export function isCloudShell() {
+    return !!(process.env['EDITOR_IN_CLOUD_SHELL'] || process.env['CLOUD_SHELL']);
+}
+export function detectIdeFromEnv() {
+    if (process.env['__COG_BASHRC_SOURCED']) {
+        return IDE_DEFINITIONS.devin;
+    }
+    if (process.env['REPLIT_USER']) {
+        return IDE_DEFINITIONS.replit;
+    }
+    if (process.env['CURSOR_TRACE_ID']) {
+        return IDE_DEFINITIONS.cursor;
+    }
+    if (process.env['CODESPACES']) {
+        return IDE_DEFINITIONS.codespaces;
+    }
+    if (isCloudShell()) {
+        return IDE_DEFINITIONS.cloudshell;
+    }
+    if (process.env['TERM_PRODUCT'] === 'Trae') {
+        return IDE_DEFINITIONS.trae;
+    }
+    if (process.env['MONOSPACE_ENV']) {
+        return IDE_DEFINITIONS.firebasestudio;
+    }
+    return IDE_DEFINITIONS.vscode;
+}
+function verifyVSCode(ide, ideProcessInfo) {
+    if (ide.name !== IDE_DEFINITIONS.vscode.name) {
+        return ide;
+    }
+    if (ideProcessInfo.command &&
+        ideProcessInfo.command.toLowerCase().includes('code')) {
+        return IDE_DEFINITIONS.vscode;
+    }
+    return IDE_DEFINITIONS.vscodefork;
+}
+export function detectIde(ideProcessInfo, ideInfoFromFile) {
+    if (ideInfoFromFile?.name && ideInfoFromFile.displayName) {
+        return {
+            name: ideInfoFromFile.name,
+            displayName: ideInfoFromFile.displayName,
+        };
+    }
+    // Only VSCode-based integrations are currently supported.
+    if (process.env['TERM_PROGRAM'] !== 'vscode') {
+        return undefined;
+    }
+    const ide = detectIdeFromEnv();
+    return verifyVSCode(ide, ideProcessInfo);
+}
+//# sourceMappingURL=detect-ide.js.map

package/dist/CLI/packages/core/src/ide/detect-ide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-ide.js","sourceRoot":"","sources":["../../../../../../../core/src/ide/detect-ide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACjD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACjD,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE;IAC9D,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE;IACpE,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC1E,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE;IAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE;IAClD,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE;CAC9C,CAAC;AAOX,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACxC,OAAO,eAAe,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,eAAe,CAAC,UAAU,CAAC;IACpC,CAAC;IACD,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAO,eAAe,CAAC,UAAU,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,eAAe,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,cAAc,CAAC;IACxC,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CACnB,GAAY,EACZ,cAGC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IACE,cAAc,CAAC,OAAO;QACtB,cAAc,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EACrD,CAAC;QACD,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,OAAO,eAAe,CAAC,UAAU,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,cAGC,EACD,eAAyD;IAEzD,IAAI,eAAe,EAAE,IAAI,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,eAAe,CAAC,IAAI;YAC1B,WAAW,EAAE,eAAe,CAAC,WAAW;SACzC,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,OAAO,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC"}

package/dist/CLI/packages/core/src/ide/ide-client.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type IdeInfo } from '../ide/detect-ide.js';
+export type DiffUpdateResult = {
+    status: 'accepted';
+    content?: string;
+} | {
+    status: 'rejected';
+    content: undefined;
+};
+export type IDEConnectionState = {
+    status: IDEConnectionStatus;
+    details?: string;
+};
+export declare enum IDEConnectionStatus {
+    Connected = "connected",
+    Disconnected = "disconnected",
+    Connecting = "connecting"
+}
+type StdioConfig = {
+    command: string;
+    args: string[];
+};
+type ConnectionConfig = {
+    port?: string;
+    authToken?: string;
+    stdio?: StdioConfig;
+};
+type IdeConnectionConfig = ConnectionConfig & {
+    workspacePath?: string;
+    ideInfo?: IdeInfo;
+    ppid?: number;
+};
+/**
+ * Manages the connection to and interaction with the IDE server.
+ */
+export declare class IdeClient {
+    private static instancePromise;
+    private client;
+    private state;
+    private currentIde;
+    private ideProcessInfo;
+    private connectionConfig;
+    private authToken;
+    private diffResponses;
+    private statusListeners;
+    private trustChangeListeners;
+    private availableTools;
+    /**
+     * A mutex to ensure that only one diff view is open in the IDE at a time.
+     * This prevents race conditions and UI issues in IDEs like VSCode that
+     * can't handle multiple diff views being opened simultaneously.
+     */
+    private diffMutex;
+    private constructor();
+    static getInstance(): Promise<IdeClient>;
+    addStatusChangeListener(listener: (state: IDEConnectionState) => void): void;
+    removeStatusChangeListener(listener: (state: IDEConnectionState) => void): void;
+    addTrustChangeListener(listener: (isTrusted: boolean) => void): void;
+    removeTrustChangeListener(listener: (isTrusted: boolean) => void): void;
+    connect(): Promise<void>;
+    /**
+     * Opens a diff view in the IDE, allowing the user to review and accept or
+     * reject changes.
+     *
+     * This method sends a request to the IDE to display a diff between the
+     * current content of a file and the new content provided. It then waits for
+     * a notification from the IDE indicating that the user has either accepted
+     * (potentially with manual edits) or rejected the diff.
+     *
+     * A mutex ensures that only one diff view can be open at a time to prevent
+     * race conditions.
+     *
+     * @param filePath The absolute path to the file to be diffed.
+     * @param newContent The proposed new content for the file.
+     * @returns A promise that resolves with a `DiffUpdateResult`, indicating
+     *   whether the diff was 'accepted' or 'rejected' and including the final
+     *   content if accepted.
+     */
+    openDiff(filePath: string, newContent: string): Promise<DiffUpdateResult>;
+    /**
+     * Acquires a lock to ensure sequential execution of critical sections.
+     *
+     * This method implements a promise-based mutex. It works by chaining promises.
+     * Each call to `acquireMutex` gets the current `diffMutex` promise. It then
+     * creates a *new* promise (`newMutex`) that will be resolved when the caller
+     * invokes the returned `release` function. The `diffMutex` is immediately
+     * updated to this `newMutex`.
+     *
+     * The method returns a promise that resolves with the `release` function only
+     * *after* the *previous* `diffMutex` promise has resolved. This creates a
+     * queue where each subsequent operation must wait for the previous one to release
+     * the lock.
+     *
+     * @returns A promise that resolves to a function that must be called to
+     *   release the lock.
+     */
+    private acquireMutex;
+    closeDiff(filePath: string, options?: {
+        suppressNotification?: boolean;
+    }): Promise<string | undefined>;
+    resolveDiffFromCli(filePath: string, outcome: 'accepted' | 'rejected'): Promise<void>;
+    disconnect(): Promise<void>;
+    getCurrentIde(): IdeInfo | undefined;
+    getConnectionStatus(): IDEConnectionState;
+    getDetectedIdeDisplayName(): string | undefined;
+    isDiffingEnabled(): boolean;
+    private discoverTools;
+    private setState;
+    static validateWorkspacePath(ideWorkspacePath: string | undefined, cwd: string): {
+        isValid: boolean;
+        error?: string;
+    };
+    private getPortFromEnv;
+    private getStdioConfigFromEnv;
+    private getConnectionConfigFromFile;
+    private getLegacyConnectionConfig;
+    protected getAllConnectionConfigs(ideDir: string): Promise<IdeConnectionConfig[]>;
+    private cleanupStaleLockFile;
+    private tryFallbackPorts;
+    private createProxyAwareFetch;
+    private registerClientHandlers;
+    private establishHttpConnection;
+    private tryHttpConnect;
+    private establishStdioConnection;
+}
+/**
+ * Reset the cached host promise. Exported for testing only.
+ * @internal
+ */
+export declare function _resetCachedIdeServerHost(): void;
+export declare function getIdeServerHost(): Promise<string>;
+export {};