@theia/task 1.45.0 → 1.46.0-next.72

package/src/common/task-util.ts

@@ -1,43 +1,43 @@
-// *****************************************************************************
-// Copyright (C) 2023 EclipseSource 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
-// *****************************************************************************
-
-/**
- * Converts the given standard name to a variable name starting with '$' if not already present.
- *
- * Variable names are used, for instance, to reference problem matchers, within task configurations.
- *
- * @param name standard name
- * @returns variable name with leading '$' if not already present.
- *
- * @see {@link fromVariableName} for the reverse conversion.
- */
-export function asVariableName(name: string): string {
-    return name.startsWith('$') ? name : `$${name}`;
-}
-
-/**
- * Converts a given variable name to a standard name, effectively removing a leading '$' if present.
- *
- * Standard names are used, for instance, in registries to store variable objects
- *
- * @param name variable name
- * @returns variable name without leading '$' if present.
- *
- * @see {@link asVariableName} for the reverse conversion.
- */
-export function fromVariableName(name: string): string {
-    return name.startsWith('$') ? name.slice(1) : name;
-}
+// *****************************************************************************
+// Copyright (C) 2023 EclipseSource 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
+// *****************************************************************************
+
+/**
+ * Converts the given standard name to a variable name starting with '$' if not already present.
+ *
+ * Variable names are used, for instance, to reference problem matchers, within task configurations.
+ *
+ * @param name standard name
+ * @returns variable name with leading '$' if not already present.
+ *
+ * @see {@link fromVariableName} for the reverse conversion.
+ */
+export function asVariableName(name: string): string {
+    return name.startsWith('$') ? name : `$${name}`;
+}
+
+/**
+ * Converts a given variable name to a standard name, effectively removing a leading '$' if present.
+ *
+ * Standard names are used, for instance, in registries to store variable objects
+ *
+ * @param name variable name
+ * @returns variable name without leading '$' if present.
+ *
+ * @see {@link asVariableName} for the reverse conversion.
+ */
+export function fromVariableName(name: string): string {
+    return name.startsWith('$') ? name.slice(1) : name;
+}

package/src/common/task-watcher.ts

@@ -1,78 +1,78 @@
-// *****************************************************************************
-// Copyright (C) 2017 Ericsson 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
-// *****************************************************************************
-
-import { injectable } from '@theia/core/shared/inversify';
-import { Emitter, Event } from '@theia/core/lib/common/event';
-import { TaskClient, TaskExitedEvent, TaskInfo, TaskOutputProcessedEvent, BackgroundTaskEndedEvent } from './task-protocol';
-
-@injectable()
-export class TaskWatcher {
-
-    getTaskClient(): TaskClient {
-        const newTaskEmitter = this.onTaskCreatedEmitter;
-        const exitEmitter = this.onTaskExitEmitter;
-        const taskProcessStartedEmitter = this.onDidStartTaskProcessEmitter;
-        const taskProcessEndedEmitter = this.onDidEndTaskProcessEmitter;
-        const outputProcessedEmitter = this.onOutputProcessedEmitter;
-        const backgroundTaskEndedEmitter = this.onBackgroundTaskEndedEmitter;
-        return {
-            onTaskCreated(event: TaskInfo): void {
-                newTaskEmitter.fire(event);
-            },
-            onTaskExit(event: TaskExitedEvent): void {
-                exitEmitter.fire(event);
-            },
-            onDidStartTaskProcess(event: TaskInfo): void {
-                taskProcessStartedEmitter.fire(event);
-            },
-            onDidEndTaskProcess(event: TaskExitedEvent): void {
-                taskProcessEndedEmitter.fire(event);
-            },
-            onDidProcessTaskOutput(event: TaskOutputProcessedEvent): void {
-                outputProcessedEmitter.fire(event);
-            },
-            onBackgroundTaskEnded(event: BackgroundTaskEndedEvent): void {
-                backgroundTaskEndedEmitter.fire(event);
-            }
-        };
-    }
-
-    protected onTaskCreatedEmitter = new Emitter<TaskInfo>();
-    protected onTaskExitEmitter = new Emitter<TaskExitedEvent>();
-    protected onDidStartTaskProcessEmitter = new Emitter<TaskInfo>();
-    protected onDidEndTaskProcessEmitter = new Emitter<TaskExitedEvent>();
-    protected onOutputProcessedEmitter = new Emitter<TaskOutputProcessedEvent>();
-    protected onBackgroundTaskEndedEmitter = new Emitter<BackgroundTaskEndedEvent>();
-
-    get onTaskCreated(): Event<TaskInfo> {
-        return this.onTaskCreatedEmitter.event;
-    }
-    get onTaskExit(): Event<TaskExitedEvent> {
-        return this.onTaskExitEmitter.event;
-    }
-    get onDidStartTaskProcess(): Event<TaskInfo> {
-        return this.onDidStartTaskProcessEmitter.event;
-    }
-    get onDidEndTaskProcess(): Event<TaskExitedEvent> {
-        return this.onDidEndTaskProcessEmitter.event;
-    }
-    get onOutputProcessed(): Event<TaskOutputProcessedEvent> {
-        return this.onOutputProcessedEmitter.event;
-    }
-    get onBackgroundTaskEnded(): Event<BackgroundTaskEndedEvent> {
-        return this.onBackgroundTaskEndedEmitter.event;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2017 Ericsson 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
+// *****************************************************************************
+
+import { injectable } from '@theia/core/shared/inversify';
+import { Emitter, Event } from '@theia/core/lib/common/event';
+import { TaskClient, TaskExitedEvent, TaskInfo, TaskOutputProcessedEvent, BackgroundTaskEndedEvent } from './task-protocol';
+
+@injectable()
+export class TaskWatcher {
+
+    getTaskClient(): TaskClient {
+        const newTaskEmitter = this.onTaskCreatedEmitter;
+        const exitEmitter = this.onTaskExitEmitter;
+        const taskProcessStartedEmitter = this.onDidStartTaskProcessEmitter;
+        const taskProcessEndedEmitter = this.onDidEndTaskProcessEmitter;
+        const outputProcessedEmitter = this.onOutputProcessedEmitter;
+        const backgroundTaskEndedEmitter = this.onBackgroundTaskEndedEmitter;
+        return {
+            onTaskCreated(event: TaskInfo): void {
+                newTaskEmitter.fire(event);
+            },
+            onTaskExit(event: TaskExitedEvent): void {
+                exitEmitter.fire(event);
+            },
+            onDidStartTaskProcess(event: TaskInfo): void {
+                taskProcessStartedEmitter.fire(event);
+            },
+            onDidEndTaskProcess(event: TaskExitedEvent): void {
+                taskProcessEndedEmitter.fire(event);
+            },
+            onDidProcessTaskOutput(event: TaskOutputProcessedEvent): void {
+                outputProcessedEmitter.fire(event);
+            },
+            onBackgroundTaskEnded(event: BackgroundTaskEndedEvent): void {
+                backgroundTaskEndedEmitter.fire(event);
+            }
+        };
+    }
+
+    protected onTaskCreatedEmitter = new Emitter<TaskInfo>();
+    protected onTaskExitEmitter = new Emitter<TaskExitedEvent>();
+    protected onDidStartTaskProcessEmitter = new Emitter<TaskInfo>();
+    protected onDidEndTaskProcessEmitter = new Emitter<TaskExitedEvent>();
+    protected onOutputProcessedEmitter = new Emitter<TaskOutputProcessedEvent>();
+    protected onBackgroundTaskEndedEmitter = new Emitter<BackgroundTaskEndedEvent>();
+
+    get onTaskCreated(): Event<TaskInfo> {
+        return this.onTaskCreatedEmitter.event;
+    }
+    get onTaskExit(): Event<TaskExitedEvent> {
+        return this.onTaskExitEmitter.event;
+    }
+    get onDidStartTaskProcess(): Event<TaskInfo> {
+        return this.onDidStartTaskProcessEmitter.event;
+    }
+    get onDidEndTaskProcess(): Event<TaskExitedEvent> {
+        return this.onDidEndTaskProcessEmitter.event;
+    }
+    get onOutputProcessed(): Event<TaskOutputProcessedEvent> {
+        return this.onOutputProcessedEmitter.event;
+    }
+    get onBackgroundTaskEnded(): Event<BackgroundTaskEndedEvent> {
+        return this.onBackgroundTaskEndedEmitter.event;
+    }
+}

package/src/node/custom/custom-task-runner-backend-module.ts

@@ -1,37 +1,37 @@
-// *****************************************************************************
-// Copyright (C) 2021 ByteDance 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
-// *****************************************************************************
-
-import { interfaces, Container } from '@theia/core/shared/inversify';
-import { CustomTask, TaskFactory, TaskCustomOptions } from './custom-task';
-import { CustomTaskRunner } from './custom-task-runner';
-import { CustomTaskRunnerContribution } from './custom-task-runner-contribution';
-import { TaskRunnerContribution } from '../task-runner';
-
-export function bindCustomTaskRunnerModule(bind: interfaces.Bind): void {
-
-    bind(CustomTask).toSelf().inTransientScope();
-    bind(TaskFactory).toFactory(ctx =>
-        (options: TaskCustomOptions) => {
-            const child = new Container({ defaultScope: 'Singleton' });
-            child.parent = ctx.container;
-            child.bind(TaskCustomOptions).toConstantValue(options);
-            return child.get(CustomTask);
-        }
-    );
-    bind(CustomTaskRunner).toSelf().inSingletonScope();
-    bind(CustomTaskRunnerContribution).toSelf().inSingletonScope();
-    bind(TaskRunnerContribution).toService(CustomTaskRunnerContribution);
-}
+// *****************************************************************************
+// Copyright (C) 2021 ByteDance 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
+// *****************************************************************************
+
+import { interfaces, Container } from '@theia/core/shared/inversify';
+import { CustomTask, TaskFactory, TaskCustomOptions } from './custom-task';
+import { CustomTaskRunner } from './custom-task-runner';
+import { CustomTaskRunnerContribution } from './custom-task-runner-contribution';
+import { TaskRunnerContribution } from '../task-runner';
+
+export function bindCustomTaskRunnerModule(bind: interfaces.Bind): void {
+
+    bind(CustomTask).toSelf().inTransientScope();
+    bind(TaskFactory).toFactory(ctx =>
+        (options: TaskCustomOptions) => {
+            const child = new Container({ defaultScope: 'Singleton' });
+            child.parent = ctx.container;
+            child.bind(TaskCustomOptions).toConstantValue(options);
+            return child.get(CustomTask);
+        }
+    );
+    bind(CustomTaskRunner).toSelf().inSingletonScope();
+    bind(CustomTaskRunnerContribution).toSelf().inSingletonScope();
+    bind(TaskRunnerContribution).toService(CustomTaskRunnerContribution);
+}

package/src/node/custom/custom-task-runner-contribution.ts

@@ -1,30 +1,30 @@
-// *****************************************************************************
-// Copyright (C) 2021 ByteDance 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
-// *****************************************************************************
-
-import { injectable, inject } from '@theia/core/shared/inversify';
-import { CustomTaskRunner } from './custom-task-runner';
-import { TaskRunnerContribution, TaskRunnerRegistry } from '../task-runner';
-
-@injectable()
-export class CustomTaskRunnerContribution implements TaskRunnerContribution {
-
-    @inject(CustomTaskRunner)
-    protected readonly customTaskRunner: CustomTaskRunner;
-
-    registerRunner(runners: TaskRunnerRegistry): void {
-        runners.registerRunner('customExecution', this.customTaskRunner);
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2021 ByteDance 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
+// *****************************************************************************
+
+import { injectable, inject } from '@theia/core/shared/inversify';
+import { CustomTaskRunner } from './custom-task-runner';
+import { TaskRunnerContribution, TaskRunnerRegistry } from '../task-runner';
+
+@injectable()
+export class CustomTaskRunnerContribution implements TaskRunnerContribution {
+
+    @inject(CustomTaskRunner)
+    protected readonly customTaskRunner: CustomTaskRunner;
+
+    registerRunner(runners: TaskRunnerRegistry): void {
+        runners.registerRunner('customExecution', this.customTaskRunner);
+    }
+}

package/src/node/custom/custom-task-runner.ts

@@ -1,60 +1,60 @@
-// *****************************************************************************
-// Copyright (C) 2021 ByteDance 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
-// *****************************************************************************
-
-import { TaskConfiguration } from '../../common';
-import { Task } from '../task';
-import { TaskRunner } from '../task-runner';
-import { injectable, inject, named } from '@theia/core/shared/inversify';
-import { ILogger } from '@theia/core';
-import { TaskFactory } from './custom-task';
-import {
-    TerminalProcessFactory,
-    Process,
-    TerminalProcessOptions,
-} from '@theia/process/lib/node';
-
-/**
- * Task runner that runs a task as a pseudoterminal open.
- */
-@injectable()
-export class CustomTaskRunner implements TaskRunner {
-
-    @inject(ILogger) @named('task')
-    protected readonly logger: ILogger;
-
-    @inject(TerminalProcessFactory)
-    protected readonly terminalProcessFactory: TerminalProcessFactory;
-
-    @inject(TaskFactory)
-    protected readonly taskFactory: TaskFactory;
-
-    async run(taskConfig: TaskConfiguration, ctx?: string): Promise<Task> {
-        try {
-            const terminalProcessOptions = { isPseudo: true } as TerminalProcessOptions;
-            const terminal: Process = this.terminalProcessFactory(terminalProcessOptions);
-
-            return this.taskFactory({
-                context: ctx,
-                config: taskConfig,
-                label: taskConfig.label,
-                process: terminal,
-            });
-        } catch (error) {
-            this.logger.error(`Error occurred while creating task: ${error}`);
-            throw error;
-        }
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2021 ByteDance 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
+// *****************************************************************************
+
+import { TaskConfiguration } from '../../common';
+import { Task } from '../task';
+import { TaskRunner } from '../task-runner';
+import { injectable, inject, named } from '@theia/core/shared/inversify';
+import { ILogger } from '@theia/core';
+import { TaskFactory } from './custom-task';
+import {
+    TerminalProcessFactory,
+    Process,
+    TerminalProcessOptions,
+} from '@theia/process/lib/node';
+
+/**
+ * Task runner that runs a task as a pseudoterminal open.
+ */
+@injectable()
+export class CustomTaskRunner implements TaskRunner {
+
+    @inject(ILogger) @named('task')
+    protected readonly logger: ILogger;
+
+    @inject(TerminalProcessFactory)
+    protected readonly terminalProcessFactory: TerminalProcessFactory;
+
+    @inject(TaskFactory)
+    protected readonly taskFactory: TaskFactory;
+
+    async run(taskConfig: TaskConfiguration, ctx?: string): Promise<Task> {
+        try {
+            const terminalProcessOptions = { isPseudo: true } as TerminalProcessOptions;
+            const terminal: Process = this.terminalProcessFactory(terminalProcessOptions);
+
+            return this.taskFactory({
+                context: ctx,
+                config: taskConfig,
+                label: taskConfig.label,
+                process: terminal,
+            });
+        } catch (error) {
+            this.logger.error(`Error occurred while creating task: ${error}`);
+            throw error;
+        }
+    }
+}

package/src/node/custom/custom-task.ts

@@ -1,73 +1,73 @@
-// *****************************************************************************
-// Copyright (C) 2021 ByteDance 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
-// *****************************************************************************
-
-import { injectable, inject, named } from '@theia/core/shared/inversify';
-import { ILogger, MaybePromise } from '@theia/core/lib/common/';
-import { Task, TaskOptions } from '../task';
-import { TaskManager } from '../task-manager';
-import { TaskInfo } from '../../common/task-protocol';
-import { Process } from '@theia/process/lib/node';
-
-export const TaskCustomOptions = Symbol('TaskCustomOptions');
-export interface TaskCustomOptions extends TaskOptions {
-    process: Process
-}
-
-export const TaskFactory = Symbol('TaskFactory');
-export type TaskFactory = (options: TaskCustomOptions) => CustomTask;
-
-/** Represents a Task launched as a fake process by `CustomTaskRunner`. */
-@injectable()
-export class CustomTask extends Task {
-
-    constructor(
-        @inject(TaskManager) taskManager: TaskManager,
-        @inject(ILogger) @named('task') logger: ILogger,
-        @inject(TaskCustomOptions) protected override readonly options: TaskCustomOptions
-    ) {
-        super(taskManager, logger, options);
-        this.logger.info(`Created new custom task, id: ${this.id}, context: ${this.context}`);
-    }
-
-    kill(): Promise<void> {
-        return Promise.resolve();
-    }
-
-    getRuntimeInfo(): MaybePromise<TaskInfo> {
-        return {
-            taskId: this.id,
-            ctx: this.context,
-            config: this.options.config,
-            terminalId: this.process.id,
-            processId: this.process.id
-        };
-    }
-
-    public callbackTaskComplete(exitCode: number | undefined): MaybePromise<void> {
-        this.fireTaskExited({
-            taskId: this.taskId,
-            ctx: this.context,
-            config: this.options.config,
-            terminalId: this.process.id,
-            processId: this.process.id,
-            code: exitCode || 0
-        });
-    }
-
-    get process(): Process {
-        return this.options.process;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2021 ByteDance 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
+// *****************************************************************************
+
+import { injectable, inject, named } from '@theia/core/shared/inversify';
+import { ILogger, MaybePromise } from '@theia/core/lib/common/';
+import { Task, TaskOptions } from '../task';
+import { TaskManager } from '../task-manager';
+import { TaskInfo } from '../../common/task-protocol';
+import { Process } from '@theia/process/lib/node';
+
+export const TaskCustomOptions = Symbol('TaskCustomOptions');
+export interface TaskCustomOptions extends TaskOptions {
+    process: Process
+}
+
+export const TaskFactory = Symbol('TaskFactory');
+export type TaskFactory = (options: TaskCustomOptions) => CustomTask;
+
+/** Represents a Task launched as a fake process by `CustomTaskRunner`. */
+@injectable()
+export class CustomTask extends Task {
+
+    constructor(
+        @inject(TaskManager) taskManager: TaskManager,
+        @inject(ILogger) @named('task') logger: ILogger,
+        @inject(TaskCustomOptions) protected override readonly options: TaskCustomOptions
+    ) {
+        super(taskManager, logger, options);
+        this.logger.info(`Created new custom task, id: ${this.id}, context: ${this.context}`);
+    }
+
+    kill(): Promise<void> {
+        return Promise.resolve();
+    }
+
+    getRuntimeInfo(): MaybePromise<TaskInfo> {
+        return {
+            taskId: this.id,
+            ctx: this.context,
+            config: this.options.config,
+            terminalId: this.process.id,
+            processId: this.process.id
+        };
+    }
+
+    public callbackTaskComplete(exitCode: number | undefined): MaybePromise<void> {
+        this.fireTaskExited({
+            taskId: this.taskId,
+            ctx: this.context,
+            config: this.options.config,
+            terminalId: this.process.id,
+            processId: this.process.id,
+            code: exitCode || 0
+        });
+    }
+
+    get process(): Process {
+        return this.options.process;
+    }
+}