@theia/debug 1.45.0 → 1.46.0-next.72

package/lib/common/debug-model.d.ts

@@ -1,153 +1,153 @@
-import { DebugConfiguration } from './debug-configuration';
-import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
-import { MaybePromise } from '@theia/core/lib/common/types';
-import { Event } from '@theia/core';
-import { DebugChannel } from './debug-service';
-/**
- * DebugAdapterSession symbol for DI.
- */
-export declare const DebugAdapterSession: unique symbol;
-/**
- * The debug adapter session. The debug adapter session manages the lifecycle of a
- * debug session: the debug session should be discarded if and only if the debug adapter
- * session is stopped.
- */
-export interface DebugAdapterSession {
-    id: string;
-    parentSession?: DebugAdapterSession;
-    start(channel: DebugChannel): Promise<void>;
-    stop(): Promise<void>;
-}
-/**
- * DebugAdapterSessionFactory symbol for DI.
- */
-export declare const DebugAdapterSessionFactory: unique symbol;
-/**
- * The [debug session](#DebugSession) factory.
- */
-export interface DebugAdapterSessionFactory {
-    get(sessionId: string, debugAdapter: DebugAdapter): DebugAdapterSession;
-}
-/**
- * Debug adapter executable for spawning.
- */
-export interface DebugAdapterSpawnExecutable {
-    command: string;
-    args?: string[];
-}
-/**
- * Debug adapter executable for forking.
- */
-export interface DebugAdapterForkExecutable {
-    modulePath: string;
-    execArgv?: string[];
-    args?: string[];
-}
-/**
- * Debug adapter executable.
- * Parameters to instantiate the debug adapter.
- *
- * In case of launching adapter the parameters contain a command and arguments. For instance:
- * {'command' : 'COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
- *
- * In case of forking the node process, contain the modulePath to fork. For instance:
- * {'modulePath' : 'NODE_COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
- */
-export declare type DebugAdapterExecutable = DebugAdapterSpawnExecutable | DebugAdapterForkExecutable;
-/**
- * Implementers stand for the various types of debug adapters the system can talk to.
- * Creation of debug adapters is not covered in this interface, but handling communication
- * and the end of life is.
- */
-export interface DebugAdapter {
-    /**
-     * A DAP protocol message has been received from the debug adapter
-     */
-    onMessageReceived: Event<string>;
-    /**
-     * Send a DAP message to the debug adapter
-     * @param message the JSON-encoded DAP message
-     */
-    send(message: string): void;
-    /**
-     * An error has occurred communicating with the debug adapter. This does not meant the debug adapter
-     * has terminated.
-     */
-    onError: Event<Error>;
-    /**
-     * The connection to the debug adapter has been lost. This signals the end of life for this
-     * debug adapter instance.
-     */
-    onClose: Event<void>;
-    /**
-     * Terminate the connection to the debug adapter.
-     */
-    stop(): Promise<void>;
-}
-/**
- * DebugAdapterFactory symbol for DI.
- */
-export declare const DebugAdapterFactory: unique symbol;
-/**
- * Factory to start debug adapter.
- */
-export interface DebugAdapterFactory {
-    start(executable: DebugAdapterExecutable): DebugAdapter;
-    connect(debugServerPort: number): DebugAdapter;
-}
-/**
- * DebugAdapterContribution symbol for DI.
- */
-export declare const DebugAdapterContribution: unique symbol;
-/**
- * A contribution point for debug adapters.
- */
-export interface DebugAdapterContribution {
-    /**
-     * The debug type. Should be a unique value among all debug adapters.
-     */
-    readonly type: string;
-    readonly label?: MaybePromise<string | undefined>;
-    readonly languages?: MaybePromise<string[] | undefined>;
-    /**
-     * The [debug adapter session](#DebugAdapterSession) factory.
-     * If a default implementation of the debug adapter session does not
-     * fit all needs it is possible to provide its own implementation using
-     * this factory. But it is strongly recommended to extend the default
-     * implementation if so.
-     */
-    debugAdapterSessionFactory?: DebugAdapterSessionFactory;
-    /**
-     * @returns The contributed configuration schema for this debug type.
-     */
-    getSchemaAttributes?(): MaybePromise<IJSONSchema[]>;
-    getConfigurationSnippets?(): MaybePromise<IJSONSchemaSnippet[]>;
-    /**
-     * Provides a [debug adapter executable](#DebugAdapterExecutable)
-     * based on [debug configuration](#DebugConfiguration) to launch a new debug adapter
-     * or to connect to existed one.
-     * @param config The resolved [debug configuration](#DebugConfiguration).
-     * @returns The [debug adapter executable](#DebugAdapterExecutable).
-     */
-    provideDebugAdapterExecutable?(config: DebugConfiguration): MaybePromise<DebugAdapterExecutable | undefined>;
-    /**
-     * Provides initial [debug configuration](#DebugConfiguration).
-     * @returns An array of [debug configurations](#DebugConfiguration).
-     */
-    provideDebugConfigurations?(workspaceFolderUri?: string): MaybePromise<DebugConfiguration[]>;
-    /**
-     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
-     * or by adding/changing/removing attributes before variable substitution.
-     * @param config The [debug configuration](#DebugConfiguration) to resolve.
-     * @returns The resolved debug configuration.
-     */
-    resolveDebugConfiguration?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
-    /**
-     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
-     * or by adding/changing/removing attributes with substituted variables.
-     * @param config The [debug configuration](#DebugConfiguration) to resolve.
-     * @returns The resolved debug configuration.
-     */
-    resolveDebugConfigurationWithSubstitutedVariables?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
-}
+import { DebugConfiguration } from './debug-configuration';
+import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
+import { MaybePromise } from '@theia/core/lib/common/types';
+import { Event } from '@theia/core';
+import { DebugChannel } from './debug-service';
+/**
+ * DebugAdapterSession symbol for DI.
+ */
+export declare const DebugAdapterSession: unique symbol;
+/**
+ * The debug adapter session. The debug adapter session manages the lifecycle of a
+ * debug session: the debug session should be discarded if and only if the debug adapter
+ * session is stopped.
+ */
+export interface DebugAdapterSession {
+    id: string;
+    parentSession?: DebugAdapterSession;
+    start(channel: DebugChannel): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * DebugAdapterSessionFactory symbol for DI.
+ */
+export declare const DebugAdapterSessionFactory: unique symbol;
+/**
+ * The [debug session](#DebugSession) factory.
+ */
+export interface DebugAdapterSessionFactory {
+    get(sessionId: string, debugAdapter: DebugAdapter): DebugAdapterSession;
+}
+/**
+ * Debug adapter executable for spawning.
+ */
+export interface DebugAdapterSpawnExecutable {
+    command: string;
+    args?: string[];
+}
+/**
+ * Debug adapter executable for forking.
+ */
+export interface DebugAdapterForkExecutable {
+    modulePath: string;
+    execArgv?: string[];
+    args?: string[];
+}
+/**
+ * Debug adapter executable.
+ * Parameters to instantiate the debug adapter.
+ *
+ * In case of launching adapter the parameters contain a command and arguments. For instance:
+ * {'command' : 'COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
+ *
+ * In case of forking the node process, contain the modulePath to fork. For instance:
+ * {'modulePath' : 'NODE_COMMAND_TO_LAUNCH_DEBUG_ADAPTER', args : [ { 'arg1', 'arg2' } ] }
+ */
+export declare type DebugAdapterExecutable = DebugAdapterSpawnExecutable | DebugAdapterForkExecutable;
+/**
+ * Implementers stand for the various types of debug adapters the system can talk to.
+ * Creation of debug adapters is not covered in this interface, but handling communication
+ * and the end of life is.
+ */
+export interface DebugAdapter {
+    /**
+     * A DAP protocol message has been received from the debug adapter
+     */
+    onMessageReceived: Event<string>;
+    /**
+     * Send a DAP message to the debug adapter
+     * @param message the JSON-encoded DAP message
+     */
+    send(message: string): void;
+    /**
+     * An error has occurred communicating with the debug adapter. This does not meant the debug adapter
+     * has terminated.
+     */
+    onError: Event<Error>;
+    /**
+     * The connection to the debug adapter has been lost. This signals the end of life for this
+     * debug adapter instance.
+     */
+    onClose: Event<void>;
+    /**
+     * Terminate the connection to the debug adapter.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * DebugAdapterFactory symbol for DI.
+ */
+export declare const DebugAdapterFactory: unique symbol;
+/**
+ * Factory to start debug adapter.
+ */
+export interface DebugAdapterFactory {
+    start(executable: DebugAdapterExecutable): DebugAdapter;
+    connect(debugServerPort: number): DebugAdapter;
+}
+/**
+ * DebugAdapterContribution symbol for DI.
+ */
+export declare const DebugAdapterContribution: unique symbol;
+/**
+ * A contribution point for debug adapters.
+ */
+export interface DebugAdapterContribution {
+    /**
+     * The debug type. Should be a unique value among all debug adapters.
+     */
+    readonly type: string;
+    readonly label?: MaybePromise<string | undefined>;
+    readonly languages?: MaybePromise<string[] | undefined>;
+    /**
+     * The [debug adapter session](#DebugAdapterSession) factory.
+     * If a default implementation of the debug adapter session does not
+     * fit all needs it is possible to provide its own implementation using
+     * this factory. But it is strongly recommended to extend the default
+     * implementation if so.
+     */
+    debugAdapterSessionFactory?: DebugAdapterSessionFactory;
+    /**
+     * @returns The contributed configuration schema for this debug type.
+     */
+    getSchemaAttributes?(): MaybePromise<IJSONSchema[]>;
+    getConfigurationSnippets?(): MaybePromise<IJSONSchemaSnippet[]>;
+    /**
+     * Provides a [debug adapter executable](#DebugAdapterExecutable)
+     * based on [debug configuration](#DebugConfiguration) to launch a new debug adapter
+     * or to connect to existed one.
+     * @param config The resolved [debug configuration](#DebugConfiguration).
+     * @returns The [debug adapter executable](#DebugAdapterExecutable).
+     */
+    provideDebugAdapterExecutable?(config: DebugConfiguration): MaybePromise<DebugAdapterExecutable | undefined>;
+    /**
+     * Provides initial [debug configuration](#DebugConfiguration).
+     * @returns An array of [debug configurations](#DebugConfiguration).
+     */
+    provideDebugConfigurations?(workspaceFolderUri?: string): MaybePromise<DebugConfiguration[]>;
+    /**
+     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
+     * or by adding/changing/removing attributes before variable substitution.
+     * @param config The [debug configuration](#DebugConfiguration) to resolve.
+     * @returns The resolved debug configuration.
+     */
+    resolveDebugConfiguration?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
+    /**
+     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
+     * or by adding/changing/removing attributes with substituted variables.
+     * @param config The [debug configuration](#DebugConfiguration) to resolve.
+     * @returns The resolved debug configuration.
+     */
+    resolveDebugConfigurationWithSubstitutedVariables?(config: DebugConfiguration, workspaceFolderUri?: string): MaybePromise<DebugConfiguration | undefined>;
+}
 //# sourceMappingURL=debug-model.d.ts.map

package/lib/common/debug-model.js

@@ -1,36 +1,36 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2018 Red Hat, Inc. and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DebugAdapterContribution = exports.DebugAdapterFactory = exports.DebugAdapterSessionFactory = exports.DebugAdapterSession = void 0;
-// FIXME: break down this file to debug adapter and debug adapter contribution (see Theia file naming conventions)
-/**
- * DebugAdapterSession symbol for DI.
- */
-exports.DebugAdapterSession = Symbol('DebugAdapterSession');
-/**
- * DebugAdapterSessionFactory symbol for DI.
- */
-exports.DebugAdapterSessionFactory = Symbol('DebugAdapterSessionFactory');
-/**
- * DebugAdapterFactory symbol for DI.
- */
-exports.DebugAdapterFactory = Symbol('DebugAdapterFactory');
-/**
- * DebugAdapterContribution symbol for DI.
- */
-exports.DebugAdapterContribution = Symbol('DebugAdapterContribution');
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2018 Red Hat, Inc. and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugAdapterContribution = exports.DebugAdapterFactory = exports.DebugAdapterSessionFactory = exports.DebugAdapterSession = void 0;
+// FIXME: break down this file to debug adapter and debug adapter contribution (see Theia file naming conventions)
+/**
+ * DebugAdapterSession symbol for DI.
+ */
+exports.DebugAdapterSession = Symbol('DebugAdapterSession');
+/**
+ * DebugAdapterSessionFactory symbol for DI.
+ */
+exports.DebugAdapterSessionFactory = Symbol('DebugAdapterSessionFactory');
+/**
+ * DebugAdapterFactory symbol for DI.
+ */
+exports.DebugAdapterFactory = Symbol('DebugAdapterFactory');
+/**
+ * DebugAdapterContribution symbol for DI.
+ */
+exports.DebugAdapterContribution = Symbol('DebugAdapterContribution');
 //# sourceMappingURL=debug-model.js.map

package/lib/common/debug-service.d.ts

@@ -1,124 +1,124 @@
-import { Channel, Disposable, Event } from '@theia/core';
-import { ApplicationError } from '@theia/core/lib/common/application-error';
-import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
-import { CommandIdVariables } from '@theia/variable-resolver/lib/common/variable-types';
-import { DebugConfiguration } from './debug-configuration';
-export interface DebuggerDescription {
-    type: string;
-    label: string;
-}
-/**
- * The WS endpoint path to the Debug service.
- */
-export declare const DebugPath = "/services/debug";
-/**
- * DebugService symbol for DI.
- */
-export declare const DebugService: unique symbol;
-/**
- * This service provides functionality to configure and to start a new debug adapter session.
- * The workflow is the following. If user wants to debug an application and
- * there is no debug configuration associated with the application then
- * the list of available providers is requested to create suitable debug configuration.
- * When configuration is chosen it is possible to alter the configuration
- * by filling in missing values or by adding/changing/removing attributes. For this purpose the
- * #resolveDebugConfiguration method is invoked. After that the debug adapter session will be started.
- */
-export interface DebugService extends Disposable {
-    onDidChangeDebuggers?: Event<void>;
-    /**
-     * Finds and returns an array of registered debug types.
-     * @returns An array of registered debug types
-     */
-    debugTypes(): Promise<string[]>;
-    getDebuggersForLanguage(language: string): Promise<DebuggerDescription[]>;
-    /**
-     * Provide debugger contributed variables
-     * see "variables" at https://code.visualstudio.com/api/references/contribution-points#contributes.debuggers
-     */
-    provideDebuggerVariables(debugType: string): Promise<CommandIdVariables>;
-    /**
-     * Provides the schema attributes.
-     * @param debugType The registered debug type
-     * @returns An JSON Schema describing the configuration attributes for the given debug type
-     */
-    getSchemaAttributes(debugType: string): Promise<IJSONSchema[]>;
-    getConfigurationSnippets(): Promise<IJSONSchemaSnippet[]>;
-    /**
-     * Provides initial [debug configuration](#DebugConfiguration).
-     * @param debugType The registered debug type
-     * @returns An array of [debug configurations](#DebugConfiguration)
-     */
-    provideDebugConfigurations(debugType: string, workspaceFolderUri: string | undefined): Promise<DebugConfiguration[]>;
-    /**
-     * @returns A Record of debug configuration provider types and a corresponding dynamic debug configurations array
-     */
-    provideDynamicDebugConfigurations?(folder?: string): Promise<Record<string, DebugConfiguration[]>>;
-    /**
-     * Provides a dynamic debug configuration matching the name and the provider debug type
-     */
-    fetchDynamicDebugConfiguration(name: string, type: string, folder?: string): Promise<DebugConfiguration | undefined>;
-    /**
-     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
-     * or by adding/changing/removing attributes before variable substitution.
-     * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
-     * @returns The resolved debug configuration, undefined or null.
-     */
-    resolveDebugConfiguration(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
-    /**
-     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
-     * or by adding/changing/removing attributes with substituted variables.
-     * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
-     * @returns The resolved debug configuration, undefined or null.
-     */
-    resolveDebugConfigurationWithSubstitutedVariables(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
-    /**
-     * Creates a new [debug adapter session](#DebugAdapterSession).
-     * @param config The resolved [debug configuration](#DebugConfiguration).
-     * @param workspaceFolderUri The workspace folder for this sessions or undefined when folderless
-     * @returns The identifier of the created [debug adapter session](#DebugAdapterSession).
-     */
-    createDebugSession(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<string>;
-    /**
-     * Stop a running session for the given session id.
-     */
-    terminateDebugSession(sessionId: string): Promise<void>;
-    /**
-     * Event handle to indicate when one or more dynamic debug configuration providers
-     * have been registered or unregistered.
-     */
-    onDidChangeDebugConfigurationProviders: Event<void>;
-}
-/**
- * The endpoint path to the debug adapter session.
- */
-export declare const DebugAdapterPath = "/services/debug-adapter";
-export declare namespace DebugError {
-    const NotFound: ApplicationError.Constructor<-41000, {
-        type: string;
-    }>;
-}
-/**
- * A closeable channel to send debug protocol messages over with error/close handling
- */
-export interface DebugChannel {
-    send(content: string): void;
-    onMessage(cb: (message: string) => void): void;
-    onError(cb: (reason: unknown) => void): void;
-    onClose(cb: (code: number, reason: string) => void): void;
-    close(): void;
-}
-/**
- * A {@link DebugChannel} wrapper implementation that sends and receives messages to/from an underlying {@link Channel}.
- */
-export declare class ForwardingDebugChannel implements DebugChannel {
-    private readonly underlyingChannel;
-    private onMessageEmitter;
-    constructor(underlyingChannel: Channel);
-    send(content: string): void;
-    onMessage(cb: (message: string) => void): void;
-    onError(cb: (reason: unknown) => void): void;
-    onClose(cb: (code: number, reason: string) => void): void;
-    close(): void;
-}
+import { Channel, Disposable, Event } from '@theia/core';
+import { ApplicationError } from '@theia/core/lib/common/application-error';
+import { IJSONSchema, IJSONSchemaSnippet } from '@theia/core/lib/common/json-schema';
+import { CommandIdVariables } from '@theia/variable-resolver/lib/common/variable-types';
+import { DebugConfiguration } from './debug-configuration';
+export interface DebuggerDescription {
+    type: string;
+    label: string;
+}
+/**
+ * The WS endpoint path to the Debug service.
+ */
+export declare const DebugPath = "/services/debug";
+/**
+ * DebugService symbol for DI.
+ */
+export declare const DebugService: unique symbol;
+/**
+ * This service provides functionality to configure and to start a new debug adapter session.
+ * The workflow is the following. If user wants to debug an application and
+ * there is no debug configuration associated with the application then
+ * the list of available providers is requested to create suitable debug configuration.
+ * When configuration is chosen it is possible to alter the configuration
+ * by filling in missing values or by adding/changing/removing attributes. For this purpose the
+ * #resolveDebugConfiguration method is invoked. After that the debug adapter session will be started.
+ */
+export interface DebugService extends Disposable {
+    onDidChangeDebuggers?: Event<void>;
+    /**
+     * Finds and returns an array of registered debug types.
+     * @returns An array of registered debug types
+     */
+    debugTypes(): Promise<string[]>;
+    getDebuggersForLanguage(language: string): Promise<DebuggerDescription[]>;
+    /**
+     * Provide debugger contributed variables
+     * see "variables" at https://code.visualstudio.com/api/references/contribution-points#contributes.debuggers
+     */
+    provideDebuggerVariables(debugType: string): Promise<CommandIdVariables>;
+    /**
+     * Provides the schema attributes.
+     * @param debugType The registered debug type
+     * @returns An JSON Schema describing the configuration attributes for the given debug type
+     */
+    getSchemaAttributes(debugType: string): Promise<IJSONSchema[]>;
+    getConfigurationSnippets(): Promise<IJSONSchemaSnippet[]>;
+    /**
+     * Provides initial [debug configuration](#DebugConfiguration).
+     * @param debugType The registered debug type
+     * @returns An array of [debug configurations](#DebugConfiguration)
+     */
+    provideDebugConfigurations(debugType: string, workspaceFolderUri: string | undefined): Promise<DebugConfiguration[]>;
+    /**
+     * @returns A Record of debug configuration provider types and a corresponding dynamic debug configurations array
+     */
+    provideDynamicDebugConfigurations?(folder?: string): Promise<Record<string, DebugConfiguration[]>>;
+    /**
+     * Provides a dynamic debug configuration matching the name and the provider debug type
+     */
+    fetchDynamicDebugConfiguration(name: string, type: string, folder?: string): Promise<DebugConfiguration | undefined>;
+    /**
+     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
+     * or by adding/changing/removing attributes before variable substitution.
+     * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
+     * @returns The resolved debug configuration, undefined or null.
+     */
+    resolveDebugConfiguration(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
+    /**
+     * Resolves a [debug configuration](#DebugConfiguration) by filling in missing values
+     * or by adding/changing/removing attributes with substituted variables.
+     * @param debugConfiguration The [debug configuration](#DebugConfiguration) to resolve.
+     * @returns The resolved debug configuration, undefined or null.
+     */
+    resolveDebugConfigurationWithSubstitutedVariables(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<DebugConfiguration | undefined | null>;
+    /**
+     * Creates a new [debug adapter session](#DebugAdapterSession).
+     * @param config The resolved [debug configuration](#DebugConfiguration).
+     * @param workspaceFolderUri The workspace folder for this sessions or undefined when folderless
+     * @returns The identifier of the created [debug adapter session](#DebugAdapterSession).
+     */
+    createDebugSession(config: DebugConfiguration, workspaceFolderUri: string | undefined): Promise<string>;
+    /**
+     * Stop a running session for the given session id.
+     */
+    terminateDebugSession(sessionId: string): Promise<void>;
+    /**
+     * Event handle to indicate when one or more dynamic debug configuration providers
+     * have been registered or unregistered.
+     */
+    onDidChangeDebugConfigurationProviders: Event<void>;
+}
+/**
+ * The endpoint path to the debug adapter session.
+ */
+export declare const DebugAdapterPath = "/services/debug-adapter";
+export declare namespace DebugError {
+    const NotFound: ApplicationError.Constructor<-41000, {
+        type: string;
+    }>;
+}
+/**
+ * A closeable channel to send debug protocol messages over with error/close handling
+ */
+export interface DebugChannel {
+    send(content: string): void;
+    onMessage(cb: (message: string) => void): void;
+    onError(cb: (reason: unknown) => void): void;
+    onClose(cb: (code: number, reason: string) => void): void;
+    close(): void;
+}
+/**
+ * A {@link DebugChannel} wrapper implementation that sends and receives messages to/from an underlying {@link Channel}.
+ */
+export declare class ForwardingDebugChannel implements DebugChannel {
+    private readonly underlyingChannel;
+    private onMessageEmitter;
+    constructor(underlyingChannel: Channel);
+    send(content: string): void;
+    onMessage(cb: (message: string) => void): void;
+    onError(cb: (reason: unknown) => void): void;
+    onClose(cb: (code: number, reason: string) => void): void;
+    close(): void;
+}
 //# sourceMappingURL=debug-service.d.ts.map