@codingame/monaco-vscode-katex-common 30.0.0 → 31.0.0

package/vscode/src/vs/workbench/contrib/terminalContrib/chatAgentTools/browser/tools/monitoring/types.js

@@ -0,0 +1,23 @@
+
+
+var OutputMonitorState;
+(function (OutputMonitorState) {
+    OutputMonitorState["Initial"] = "Initial";
+    OutputMonitorState["Idle"] = "Idle";
+    OutputMonitorState["PollingForIdle"] = "PollingForIdle";
+    OutputMonitorState["Prompting"] = "Prompting";
+    OutputMonitorState["Timeout"] = "Timeout";
+    OutputMonitorState["Active"] = "Active";
+    OutputMonitorState["Cancelled"] = "Cancelled";
+})(OutputMonitorState || (OutputMonitorState = {}));
+var PollingConsts;
+(function (PollingConsts) {
+    PollingConsts[PollingConsts["MinIdleEvents"] = 2] = "MinIdleEvents";
+    PollingConsts[PollingConsts["MinPollingDuration"] = 500] = "MinPollingDuration";
+    PollingConsts[PollingConsts["FirstPollingMaxDuration"] = 20000] = "FirstPollingMaxDuration";
+    PollingConsts[PollingConsts["ExtendedPollingMaxDuration"] = 120000] = "ExtendedPollingMaxDuration";
+    PollingConsts[PollingConsts["MaxPollingIntervalDuration"] = 10000] = "MaxPollingIntervalDuration";
+    PollingConsts[PollingConsts["MaxRecursionCount"] = 5] = "MaxRecursionCount";
+})(PollingConsts || (PollingConsts = {}));
+
+export { OutputMonitorState, PollingConsts };

package/vscode/src/vs/workbench/contrib/terminalContrib/chatAgentTools/browser/tools/outputAnalyzer.d.ts

@@ -0,0 +1,9 @@
+export interface IOutputAnalyzerOptions {
+    readonly exitCode: number | undefined;
+    readonly exitResult: string;
+    readonly commandLine: string;
+    readonly isSandboxWrapped: boolean;
+}
+export interface IOutputAnalyzer {
+    analyze(options: IOutputAnalyzerOptions): Promise<string | undefined>;
+}

package/vscode/src/vs/workbench/contrib/terminalContrib/chatAgentTools/browser/tools/runInTerminalTool.d.ts

@@ -0,0 +1,192 @@
+import { CancellationToken } from "@codingame/monaco-vscode-api/vscode/vs/base/common/cancellation";
+import { Disposable } from "@codingame/monaco-vscode-api/vscode/vs/base/common/lifecycle";
+import { ResourceMap } from "@codingame/monaco-vscode-api/vscode/vs/base/common/map";
+import { OperatingSystem } from "@codingame/monaco-vscode-api/vscode/vs/base/common/platform";
+import { IConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configuration.service";
+import { IFileService } from "@codingame/monaco-vscode-api/vscode/vs/platform/files/common/files.service";
+import { IInstantiationService, type ServicesAccessor } from "@codingame/monaco-vscode-api/vscode/vs/platform/instantiation/common/instantiation";
+import { ILabelService } from "@codingame/monaco-vscode-api/vscode/vs/platform/label/common/label.service";
+import { IStorageService } from "@codingame/monaco-vscode-api/vscode/vs/platform/storage/common/storage.service";
+import { ITerminalProfile } from "@codingame/monaco-vscode-api/vscode/vs/platform/terminal/common/terminal";
+import { ITerminalLogService } from "@codingame/monaco-vscode-api/vscode/vs/platform/terminal/common/terminal.service";
+import { IWorkspaceContextService } from "@codingame/monaco-vscode-api/vscode/vs/platform/workspace/common/workspace.service";
+import { IHistoryService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/history/common/history.service";
+import { IRemoteAgentService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/remote/common/remoteAgentService.service";
+import { IAgentSessionsService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/agentSessions/agentSessionsService.service";
+import { IChatWidgetService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/browser/chat.service";
+import { IChatService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/chatService/chatService.service";
+import { CountTokensCallback, IPreparedToolInvocation, IStreamedToolInvocation, IToolData, IToolImpl, IToolInvocation, IToolInvocationPreparationContext, IToolInvocationStreamContext, IToolResult, ToolProgress } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/languageModelToolsService";
+import { ILanguageModelToolsService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/chat/common/tools/languageModelToolsService.service";
+import { type ITerminalInstance } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/browser/terminal";
+import { ITerminalChatService, ITerminalService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/browser/terminal.service";
+import { ITerminalProfileResolverService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/contrib/terminal/common/terminal.service";
+import { ITerminalSandboxService } from "../../common/terminalSandboxService.js";
+import type { ITerminalExecuteStrategyResult } from "../executeStrategy/executeStrategy.js";
+import { type IToolTerminal } from "../toolTerminalCreator.js";
+export declare function createRunInTerminalToolData(accessor: ServicesAccessor): Promise<IToolData>;
+export interface IRunInTerminalInputParams {
+    command: string;
+    explanation: string;
+    goal: string;
+    mode?: "sync" | "async";
+    /**
+     * @deprecated Use `mode` instead.
+     */
+    isBackground?: boolean;
+    timeout?: number;
+    requestUnsandboxedExecution?: boolean;
+    requestUnsandboxedExecutionReason?: string;
+}
+export interface IAutomaticUnsandboxRetryOptions {
+    readonly didSandboxWrapCommand: boolean;
+    readonly requestUnsandboxedExecution: boolean;
+    readonly isPersistentSession: boolean;
+    readonly isBackgroundExecution: boolean;
+    readonly didTimeout: boolean;
+    readonly exitCode: number | undefined;
+    readonly output: string;
+}
+export declare function shouldAutomaticallyRetryUnsandboxed(options: IAutomaticUnsandboxRetryOptions): boolean;
+/**
+ * Interface for accessing a running terminal execution.
+ * Used by tools that need to await or interact with background terminal commands.
+ */
+export interface IActiveTerminalExecution {
+    /**
+     * Promise that resolves when the terminal command completes.
+     */
+    readonly completionPromise: Promise<ITerminalExecuteStrategyResult>;
+    /**
+     * The terminal instance associated with this execution.
+     */
+    readonly instance: ITerminalInstance;
+    /**
+     * Gets the current output from the terminal.
+     */
+    getOutput(): string;
+    /**
+     * Switches this execution to background mode, if supported.
+     */
+    setBackground?(): void;
+}
+export declare class RunInTerminalTool extends Disposable implements IToolImpl {
+    protected readonly _chatService: IChatService;
+    private readonly _configurationService;
+    private readonly _fileService;
+    private readonly _historyService;
+    private readonly _instantiationService;
+    private readonly _labelService;
+    private readonly _languageModelToolsService;
+    private readonly _remoteAgentService;
+    private readonly _storageService;
+    private readonly _terminalChatService;
+    private readonly _logService;
+    private readonly _terminalService;
+    private readonly _terminalSandboxService;
+    private readonly _workspaceContextService;
+    private readonly _chatWidgetService;
+    private readonly _agentSessionsService;
+    private readonly _terminalToolCreator;
+    private readonly _treeSitterCommandParser;
+    private readonly _telemetry;
+    private readonly _commandArtifactCollector;
+    protected readonly _profileFetcher: TerminalProfileFetcher;
+    private readonly _commandLineRewriters;
+    private readonly _commandLineAnalyzers;
+    private readonly _commandLinePresenters;
+    private readonly _outputAnalyzers;
+    private readonly _archivedSessionListener;
+    protected readonly _sessionTerminalAssociations: ResourceMap<IToolTerminal>;
+    protected readonly _sessionTerminalInstances: ResourceMap<Set<ITerminalInstance>>;
+    private readonly _terminalsBeingDisposedBySessionCleanup;
+    /**
+     * Tracks active background completion notifications per terminal ID.
+     * When a new notification is registered for a terminal that already has one,
+     * the previous notification (and its OutputMonitor) is disposed first to
+     * prevent listener accumulation on the terminal's onDidInputData emitter.
+     */
+    private readonly _backgroundNotifications;
+    protected readonly _osBackend: Promise<OperatingSystem>;
+    private static readonly _activeExecutions;
+    static getBackgroundOutput(id: string): string;
+    /**
+     * Gets an active terminal execution by ID. Returns undefined if not found.
+     * Can be used to await the completion of a background terminal command.
+     */
+    static getExecution(id: string): IActiveTerminalExecution | undefined;
+    /**
+     * Removes an active terminal execution by ID and disposes it.
+     * @returns true if the execution was found and removed, false otherwise.
+     */
+    static removeExecution(id: string): boolean;
+    private _resolveExecutionOptions;
+    /**
+     * Controls whether this tool wires up sandbox-specific command-line
+     * behavior, including both the {@link CommandLineSandboxRewriter} and the
+     * {@link CommandLineSandboxAnalyzer}. This is separate from
+     * ITerminalSandboxService.isEnabled(), which reports whether terminal
+     * sandboxing is currently enabled for the running window.
+     */
+    protected get _enableCommandLineSandboxRewriting(): boolean;
+    constructor(_chatService: IChatService, _configurationService: IConfigurationService, _fileService: IFileService, _historyService: IHistoryService, _instantiationService: IInstantiationService, _labelService: ILabelService, _languageModelToolsService: ILanguageModelToolsService, _remoteAgentService: IRemoteAgentService, _storageService: IStorageService, _terminalChatService: ITerminalChatService, _logService: ITerminalLogService, _terminalService: ITerminalService, _terminalSandboxService: ITerminalSandboxService, _workspaceContextService: IWorkspaceContextService, _chatWidgetService: IChatWidgetService, _agentSessionsService: IAgentSessionsService);
+    handleToolStream(context: IToolInvocationStreamContext, _token: CancellationToken): Promise<IStreamedToolInvocation | undefined>;
+    prepareToolInvocation(context: IToolInvocationPreparationContext, token: CancellationToken): Promise<IPreparedToolInvocation | undefined>;
+    private _formatBlockedDomainsForTitle;
+    private _getBlockedDomainReason;
+    private _rewriteCommandLine;
+    private _confirmAutomaticUnsandboxRetry;
+    private _getAutomaticUnsandboxRetryTitle;
+    private _acceptAutomaticUnsandboxRetryToolInvocationUpdate;
+    invoke(invocation: IToolInvocation, _countTokens: CountTokensCallback, _progress: ToolProgress, token: CancellationToken): Promise<IToolResult>;
+    private _getOutputAnalyzerMessage;
+    private static readonly _maxImageFileSize;
+    /**
+     * Scans terminal output for file paths that point to images and reads them.
+     * Returns data content parts for any found images that exist on disk.
+     */
+    private _extractImagesFromOutput;
+    private _handleTerminalVisibility;
+    /**
+     * Initializes a terminal for command execution. For foreground mode, reuses existing cached
+     * terminal from the session. For background mode, always creates a new terminal to allow
+     * parallel execution.
+     */
+    private _initTerminal;
+    private _registerInputListener;
+    private _restoreTerminalAssociations;
+    private _setupProcessIdAssociation;
+    private _associateProcessIdWithSession;
+    private _removeProcessIdAssociation;
+    private _cleanupSessionTerminals;
+    private _addSessionTerminalAssociation;
+    private _ensureArchivedSessionListener;
+    private _removeTerminalAssociations;
+    private _removeExecutionAssociations;
+    /**
+     * Registers a listener for command completion on a background terminal.
+     * When a command finishes, sends a steering message to the chat session
+     * so the agent is notified on its next turn.
+     *
+     * If an output monitor is provided, it is continued in background mode
+     * to detect prompts-for-input while the terminal runs in the background.
+     * The output monitor is cancelled and disposed when a command finishes.
+     */
+    private _registerCompletionNotification;
+    /**
+     * Find and dismiss any pending (not yet answered) question carousels that
+     * are associated with the given terminal. This is called when the user
+     * types directly into the terminal, bypassing the carousel UI.
+     */
+    private _dismissPendingCarouselsForTerminal;
+}
+export declare class TerminalProfileFetcher {
+    private readonly _configurationService;
+    private readonly _terminalProfileResolverService;
+    private readonly _remoteAgentService;
+    readonly osBackend: Promise<OperatingSystem>;
+    constructor(_configurationService: IConfigurationService, _terminalProfileResolverService: ITerminalProfileResolverService, _remoteAgentService: IRemoteAgentService);
+    getCopilotProfile(): Promise<ITerminalProfile>;
+    getCopilotShell(): Promise<string>;
+    private _getChatTerminalProfile;
+    private _isValidChatAgentTerminalProfile;
+}