@theia/ai-terminal 1.76.0-next.6 → 1.76.0

package/lib/browser/abstract-shell-execution-tool.d.ts

@@ -0,0 +1,39 @@
+import { ToolProvider, ToolRequest } from '@theia/ai-core';
+import { WorkspaceService } from '@theia/workspace/lib/browser/workspace-service';
+import { OutputTruncationOptions, ShellExecutionCanceledResult, ShellExecutionServer, ShellExecutionToolResult } from '../common/shell-execution-server';
+/** A single shell command to run through {@link AbstractShellExecutionTool.runShellCommand}. */
+export interface ShellCommandExecution {
+    command: string;
+    /** Absolute working directory. If omitted the command runs in the backend process' cwd. */
+    cwd?: string;
+    /** Timeout in milliseconds. Falls back to the backend default when omitted. */
+    timeout?: number;
+    /**
+     * The invocation context, if any. Its tool call id makes the execution cancellable via
+     * {@link AbstractShellExecutionTool.cancelExecution}, and its cancellation token kills the
+     * underlying process when fired. Typed as `unknown` because tool handlers receive the context
+     * untyped; {@link ToolInvocationContext} narrows it.
+     */
+    ctx?: unknown;
+    /** Overrides the default output truncation budget. */
+    truncation?: OutputTruncationOptions;
+}
+/**
+ * Shared plumbing for tools that run a shell command through the {@link ShellExecutionServer}:
+ * execution-id bookkeeping, cancellation wiring, the canceled-result branch and output truncation.
+ *
+ * Subclasses only decide *which* command runs and how it is exposed to the LLM.
+ */
+export declare abstract class AbstractShellExecutionTool implements ToolProvider {
+    protected readonly shellServer: ShellExecutionServer;
+    protected readonly workspaceService: WorkspaceService;
+    /** Maps tool call ids to the execution ids of their in-flight shell commands. */
+    protected readonly runningExecutions: Map<string, string>;
+    abstract getTool(): ToolRequest;
+    cancelExecution(toolCallId: string): Promise<boolean>;
+    isExecutionRunning(toolCallId: string): boolean;
+    /** Runs `execution` and maps the raw server result onto the tool result shape. */
+    protected runShellCommand(execution: ShellCommandExecution): Promise<ShellExecutionToolResult | ShellExecutionCanceledResult>;
+    protected combineAndTruncate(stdout: string, stderr: string, options?: OutputTruncationOptions): string;
+}
+//# sourceMappingURL=abstract-shell-execution-tool.d.ts.map

package/lib/browser/abstract-shell-execution-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-shell-execution-tool.d.ts","sourceRoot":"","sources":["../../src/browser/abstract-shell-execution-tool.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAyB,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,OAAO,EACH,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EAE3B,MAAM,kCAAkC,CAAC;AAE1C,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAED;;;;;GAKG;AACH,8BACsB,0BAA2B,YAAW,YAAY;IAGpE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAGrD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAEtD,iFAAiF;IACjF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,sBAA6B;IAEjE,QAAQ,CAAC,OAAO,IAAI,WAAW;IAEzB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY3D,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI/C,kFAAkF;cAClE,eAAe,CAAC,SAAS,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,GAAG,4BAA4B,CAAC;IAwCnI,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM;CAG1G"}

package/lib/browser/abstract-shell-execution-tool.js

@@ -0,0 +1,103 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// 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.AbstractShellExecutionTool = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+const ai_core_1 = require("@theia/ai-core");
+const workspace_service_1 = require("@theia/workspace/lib/browser/workspace-service");
+const shell_execution_server_1 = require("../common/shell-execution-server");
+/**
+ * Shared plumbing for tools that run a shell command through the {@link ShellExecutionServer}:
+ * execution-id bookkeeping, cancellation wiring, the canceled-result branch and output truncation.
+ *
+ * Subclasses only decide *which* command runs and how it is exposed to the LLM.
+ */
+let AbstractShellExecutionTool = class AbstractShellExecutionTool {
+    constructor() {
+        /** Maps tool call ids to the execution ids of their in-flight shell commands. */
+        this.runningExecutions = new Map();
+    }
+    async cancelExecution(toolCallId) {
+        const executionId = this.runningExecutions.get(toolCallId);
+        if (executionId) {
+            const canceled = await this.shellServer.cancel(executionId);
+            if (canceled) {
+                this.runningExecutions.delete(toolCallId);
+            }
+            return canceled;
+        }
+        return false;
+    }
+    isExecutionRunning(toolCallId) {
+        return this.runningExecutions.has(toolCallId);
+    }
+    /** Runs `execution` and maps the raw server result onto the tool result shape. */
+    async runShellCommand(execution) {
+        const { command, cwd, timeout, ctx, truncation } = execution;
+        const toolCallId = ai_core_1.ToolInvocationContext.getToolCallId(ctx);
+        const cancellationToken = ai_core_1.ToolInvocationContext.getCancellationToken(ctx);
+        const executionId = (0, core_1.generateUuid)();
+        if (toolCallId) {
+            this.runningExecutions.set(toolCallId, executionId);
+        }
+        const cancellationListener = cancellationToken?.onCancellationRequested(() => {
+            this.shellServer.cancel(executionId);
+        });
+        try {
+            const result = await this.shellServer.execute({ command, cwd, timeout, executionId });
+            if (result.canceled) {
+                return {
+                    canceled: true,
+                    output: this.combineAndTruncate(result.stdout, result.stderr, truncation) || undefined,
+                    duration: result.duration
+                };
+            }
+            return {
+                success: result.success,
+                exitCode: result.exitCode,
+                output: this.combineAndTruncate(result.stdout, result.stderr, truncation),
+                error: result.error,
+                duration: result.duration,
+                cwd: result.resolvedCwd
+            };
+        }
+        finally {
+            cancellationListener?.dispose();
+            if (toolCallId) {
+                this.runningExecutions.delete(toolCallId);
+            }
+        }
+    }
+    combineAndTruncate(stdout, stderr, options) {
+        return (0, shell_execution_server_1.combineAndTruncate)(stdout, stderr, options);
+    }
+};
+exports.AbstractShellExecutionTool = AbstractShellExecutionTool;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(shell_execution_server_1.ShellExecutionServer),
+    tslib_1.__metadata("design:type", Object)
+], AbstractShellExecutionTool.prototype, "shellServer", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(workspace_service_1.WorkspaceService),
+    tslib_1.__metadata("design:type", workspace_service_1.WorkspaceService)
+], AbstractShellExecutionTool.prototype, "workspaceService", void 0);
+exports.AbstractShellExecutionTool = AbstractShellExecutionTool = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], AbstractShellExecutionTool);
+//# sourceMappingURL=abstract-shell-execution-tool.js.map

package/lib/browser/abstract-shell-execution-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-shell-execution-tool.js","sourceRoot":"","sources":["../../src/browser/abstract-shell-execution-tool.ts"],"names":[],"mappings":"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"}

package/lib/browser/index.d.ts

@@ -1,2 +1,3 @@
 export * from './shell-command-permission-service';
+export * from './predefined-shell-tool';
 //# sourceMappingURL=index.d.ts.map

package/lib/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAgBA,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAgBA,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC"}

package/lib/browser/index.js

@@ -17,4 +17,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./shell-command-permission-service"), exports);
+tslib_1.__exportStar(require("./predefined-shell-tool"), exports);
 //# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,6EAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,6EAAmD;AACnD,kEAAwC"}

package/lib/browser/predefined-shell-tool.d.ts

@@ -0,0 +1,51 @@
+import { ToolInvocationContext, ToolRequest, ToolRequestParameters } from '@theia/ai-core';
+import { AbstractShellExecutionTool } from './abstract-shell-execution-tool';
+import { OutputTruncationOptions, ShellExecutionCanceledResult, ShellExecutionToolResult } from '../common/shell-execution-server';
+/** `providerName` reported by tools that derive from {@link PredefinedShellTool}. */
+export declare const PREDEFINED_SHELL_TOOL_PROVIDER = "ai-predefined-shell";
+/**
+ * Base class for tools that execute a fixed, hardcoded shell command. A subclass declares its
+ * tool `id`, its parameters and a `buildCommand(args)` method that assembles the command from
+ * typed arguments. The LLM only supplies the typed arguments, so the subclass stays in control
+ * of the command.
+ *
+ * Unlike the general-purpose `shellExecute` tool, a {@link PredefinedShellTool} does not consult
+ * `ShellCommandPermissionService` and does not appear on the user's shell allow/deny lists. The
+ * safety boundary is the subclass `buildCommand`, which must not be coercible into running
+ * arbitrary commands.
+ */
+export declare abstract class PredefinedShellTool extends AbstractShellExecutionTool {
+    /** The unique identifier of this tool. Must not be `shellExecute`. */
+    abstract readonly id: string;
+    /** Human-readable description of this tool, shown to the LLM. */
+    abstract readonly description: string;
+    protected readonly parameters: ToolRequestParameters;
+    /** Timeout for the underlying shell execution, in milliseconds. */
+    protected readonly timeout: number;
+    /** Output truncation budget. `undefined` keeps the `shellExecute` defaults (first/last 50 lines). */
+    protected readonly truncation: OutputTruncationOptions | undefined;
+    /** Build the exact shell command to execute from the parsed arguments. */
+    protected abstract buildCommand(args: Record<string, unknown>): string;
+    /**
+     * Resolves the working directory for the shell command, given the same parsed arguments that
+     * {@link buildCommand} receives, so a tool can let the caller pick the folder it runs in.
+     *
+     * Deliberately abstract: the cwd materially affects most predefined commands (anything
+     * talking to a specific repository, build script, or per-folder tool), and silently
+     * defaulting to an arbitrary workspace root produces results that look plausible but describe
+     * the wrong folder.
+     *
+     * Subclasses that genuinely do not care about the cwd can return
+     * {@link firstWorkspaceRoot} or `undefined`.
+     */
+    protected abstract resolveWorkspaceRoot(args: Record<string, unknown>): string | undefined;
+    /**
+     * The **first** workspace root, or `undefined` when no workspace is open. Only a sensible
+     * `resolveWorkspaceRoot` implementation for commands that produce the same output regardless
+     * of cwd. In a multi-root workspace the first root is arbitrary.
+     */
+    protected firstWorkspaceRoot(): string | undefined;
+    getTool(): ToolRequest;
+    protected execute(argString: string, ctx?: ToolInvocationContext): Promise<ShellExecutionToolResult | ShellExecutionCanceledResult>;
+}
+//# sourceMappingURL=predefined-shell-tool.d.ts.map

package/lib/browser/predefined-shell-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-shell-tool.d.ts","sourceRoot":"","sources":["../../src/browser/predefined-shell-tool.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEnI,qFAAqF;AACrF,eAAO,MAAM,8BAA8B,wBAAwB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,8BACsB,mBAAoB,SAAQ,0BAA0B;IAExE,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAsC;IAE1F,mEAAmE;IACnE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAU;IAE5C,qGAAqG;IACrG,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,CAAa;IAE/E,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAEtE;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS;IAE1F;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIlD,OAAO,IAAI,WAAW;cAWN,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,GAAG,4BAA4B,CAAC;CAU5I"}

package/lib/browser/predefined-shell-tool.js

@@ -0,0 +1,77 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// 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.PredefinedShellTool = exports.PREDEFINED_SHELL_TOOL_PROVIDER = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const abstract_shell_execution_tool_1 = require("./abstract-shell-execution-tool");
+/** `providerName` reported by tools that derive from {@link PredefinedShellTool}. */
+exports.PREDEFINED_SHELL_TOOL_PROVIDER = 'ai-predefined-shell';
+/**
+ * Base class for tools that execute a fixed, hardcoded shell command. A subclass declares its
+ * tool `id`, its parameters and a `buildCommand(args)` method that assembles the command from
+ * typed arguments. The LLM only supplies the typed arguments, so the subclass stays in control
+ * of the command.
+ *
+ * Unlike the general-purpose `shellExecute` tool, a {@link PredefinedShellTool} does not consult
+ * `ShellCommandPermissionService` and does not appear on the user's shell allow/deny lists. The
+ * safety boundary is the subclass `buildCommand`, which must not be coercible into running
+ * arbitrary commands.
+ */
+let PredefinedShellTool = class PredefinedShellTool extends abstract_shell_execution_tool_1.AbstractShellExecutionTool {
+    constructor() {
+        super(...arguments);
+        this.parameters = { type: 'object', properties: {} };
+        /** Timeout for the underlying shell execution, in milliseconds. */
+        this.timeout = 30_000;
+        /** Output truncation budget. `undefined` keeps the `shellExecute` defaults (first/last 50 lines). */
+        this.truncation = undefined;
+    }
+    /**
+     * The **first** workspace root, or `undefined` when no workspace is open. Only a sensible
+     * `resolveWorkspaceRoot` implementation for commands that produce the same output regardless
+     * of cwd. In a multi-root workspace the first root is arbitrary.
+     */
+    firstWorkspaceRoot() {
+        return this.workspaceService.getWorkspaceRootUri(undefined)?.path.fsPath();
+    }
+    getTool() {
+        return {
+            id: this.id,
+            name: this.id,
+            providerName: exports.PREDEFINED_SHELL_TOOL_PROVIDER,
+            description: this.description,
+            parameters: this.parameters,
+            handler: (argString, ctx) => this.execute(argString, ctx)
+        };
+    }
+    async execute(argString, ctx) {
+        const args = argString ? JSON.parse(argString) : {};
+        return this.runShellCommand({
+            command: this.buildCommand(args),
+            cwd: this.resolveWorkspaceRoot(args),
+            timeout: this.timeout,
+            ctx,
+            truncation: this.truncation
+        });
+    }
+};
+exports.PredefinedShellTool = PredefinedShellTool;
+exports.PredefinedShellTool = PredefinedShellTool = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], PredefinedShellTool);
+//# sourceMappingURL=predefined-shell-tool.js.map

package/lib/browser/predefined-shell-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-shell-tool.js","sourceRoot":"","sources":["../../src/browser/predefined-shell-tool.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,4DAA0D;AAE1D,mFAA6E;AAG7E,qFAAqF;AACxE,QAAA,8BAA8B,GAAG,qBAAqB,CAAC;AAEpE;;;;;;;;;;GAUG;AAEI,IAAe,mBAAmB,GAAlC,MAAe,mBAAoB,SAAQ,0DAA0B;IAArE;;QAQgB,eAAU,GAA0B,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAE1F,mEAAmE;QAChD,YAAO,GAAW,MAAM,CAAC;QAE5C,qGAAqG;QAClF,eAAU,GAAwC,SAAS,CAAC;IAiDnF,CAAC;IA9BG;;;;OAIG;IACO,kBAAkB;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/E,CAAC;IAED,OAAO;QACH,OAAO;YACH,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,YAAY,EAAE,sCAA8B;YAC5C,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,CAAC,SAAiB,EAAE,GAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SAC5F,CAAC;IACN,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAA2B;QAClE,MAAM,IAAI,GAA4B,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,eAAe,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAChC,GAAG,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG;YACH,UAAU,EAAE,IAAI,CAAC,UAAU;SAC9B,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AA/DqB,kDAAmB;8BAAnB,mBAAmB;IADxC,IAAA,sBAAU,GAAE;GACS,mBAAmB,CA+DxC"}

package/lib/browser/predefined-shell-tool.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=predefined-shell-tool.spec.d.ts.map

package/lib/browser/predefined-shell-tool.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-shell-tool.spec.d.ts","sourceRoot":"","sources":["../../src/browser/predefined-shell-tool.spec.ts"],"names":[],"mappings":""}

package/lib/browser/predefined-shell-tool.spec.js

@@ -0,0 +1,197 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH.
+//
+// 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 });
+const jsdom_1 = require("@theia/core/lib/browser/test/jsdom");
+let disableJSDOM = (0, jsdom_1.enableJSDOM)();
+const frontend_application_config_provider_1 = require("@theia/core/lib/browser/frontend-application-config-provider");
+frontend_application_config_provider_1.FrontendApplicationConfigProvider.set({});
+const chai_1 = require("chai");
+const sinon = require("sinon");
+const inversify_1 = require("@theia/core/shared/inversify");
+const cancellation_1 = require("@theia/core/lib/common/cancellation");
+const uri_1 = require("@theia/core/lib/common/uri");
+const workspace_service_1 = require("@theia/workspace/lib/browser/workspace-service");
+const shell_execution_server_1 = require("../common/shell-execution-server");
+const predefined_shell_tool_1 = require("./predefined-shell-tool");
+disableJSDOM();
+class TestPredefinedShellTool extends predefined_shell_tool_1.PredefinedShellTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'test-predefined';
+        this.description = 'A test predefined shell tool that returns hello';
+    }
+    buildCommand(args) {
+        const upper = args.upper === true;
+        return upper ? 'echo HELLO' : 'echo hello';
+    }
+    resolveWorkspaceRoot(args) {
+        return typeof args.cwd === 'string' ? args.cwd : this.firstWorkspaceRoot();
+    }
+}
+function createResult(overrides = {}) {
+    return {
+        success: true,
+        exitCode: 0,
+        stdout: 'hello\n',
+        stderr: '',
+        duration: 5,
+        ...overrides
+    };
+}
+describe('PredefinedShellTool', () => {
+    let container;
+    let shellServer;
+    let tool;
+    before(() => {
+        disableJSDOM = (0, jsdom_1.enableJSDOM)();
+    });
+    after(() => {
+        disableJSDOM();
+    });
+    beforeEach(() => {
+        container = new inversify_1.Container();
+        shellServer = {
+            execute: sinon.stub().resolves(createResult()),
+            cancel: sinon.stub().resolves(true)
+        };
+        const workspaceService = {
+            getWorkspaceRootUri: () => new uri_1.default('file:///workspace')
+        };
+        container.bind(shell_execution_server_1.ShellExecutionServer).toConstantValue(shellServer);
+        container.bind(workspace_service_1.WorkspaceService).toConstantValue(workspaceService);
+        container.bind(TestPredefinedShellTool).toSelf();
+        tool = container.get(TestPredefinedShellTool);
+    });
+    it('exposes the subclass id and description on the tool', () => {
+        const request = tool.getTool();
+        (0, chai_1.expect)(request.id).to.equal('test-predefined');
+        (0, chai_1.expect)(request.name).to.equal('test-predefined');
+        (0, chai_1.expect)(request.description).to.equal('A test predefined shell tool that returns hello');
+        (0, chai_1.expect)(request.providerName).to.equal(predefined_shell_tool_1.PREDEFINED_SHELL_TOOL_PROVIDER);
+    });
+    it('does not declare checkAutoAction so confirmation flows through the normal ToolConfirmationManager', () => {
+        const request = tool.getTool();
+        (0, chai_1.expect)(request.checkAutoAction).to.be.undefined;
+    });
+    it('passes the hardcoded command, workspace root and a generated execution id to ShellExecutionServer', async () => {
+        const request = tool.getTool();
+        await request.handler('{}');
+        (0, chai_1.expect)(shellServer.execute.calledOnce).to.be.true;
+        const arg = shellServer.execute.firstCall.args[0];
+        (0, chai_1.expect)(arg.command).to.equal('echo hello');
+        // URI.fsPath() uses the platform-native separator, so the cwd comes back as
+        // `\workspace` on Windows. Normalize before asserting to keep the test platform-agnostic.
+        (0, chai_1.expect)(arg.cwd?.replace(/\\/g, '/')).to.equal('/workspace');
+        (0, chai_1.expect)(arg.timeout).to.equal(30_000);
+        (0, chai_1.expect)(typeof arg.executionId).to.equal('string');
+        (0, chai_1.expect)(arg.executionId.length).to.be.greaterThan(0);
+    });
+    it('forwards typed args to buildCommand', async () => {
+        const request = tool.getTool();
+        await request.handler(JSON.stringify({ upper: true }));
+        const arg = shellServer.execute.firstCall.args[0];
+        (0, chai_1.expect)(arg.command).to.equal('echo HELLO');
+    });
+    it('forwards the same typed args to resolveWorkspaceRoot, so the cwd can depend on them', async () => {
+        await tool.getTool().handler(JSON.stringify({ cwd: '/elsewhere' }));
+        const arg = shellServer.execute.firstCall.args[0];
+        (0, chai_1.expect)(arg.cwd).to.equal('/elsewhere');
+    });
+    it('handles an empty argument string as an empty args object', async () => {
+        const request = tool.getTool();
+        await request.handler('');
+        const arg = shellServer.execute.firstCall.args[0];
+        (0, chai_1.expect)(arg.command).to.equal('echo hello');
+    });
+    it('returns a formatted result with combined output', async () => {
+        shellServer.execute.resolves(createResult({ stdout: 'out\n', stderr: 'err\n' }));
+        const request = tool.getTool();
+        const raw = await request.handler('{}');
+        (0, chai_1.expect)(raw).to.deep.include({
+            success: true,
+            exitCode: 0
+        });
+        const result = raw;
+        (0, chai_1.expect)(result.output).to.contain('out');
+        (0, chai_1.expect)(result.output).to.contain('err');
+    });
+    it('returns a canceled result when the underlying execution is canceled', async () => {
+        shellServer.execute.resolves(createResult({ canceled: true, stdout: 'partial\n', stderr: '' }));
+        const request = tool.getTool();
+        const result = await request.handler('{}');
+        (0, chai_1.expect)(result.canceled).to.be.true;
+        (0, chai_1.expect)(result.output).to.contain('partial');
+    });
+    it('wires the invocation cancellation token to ShellExecutionServer.cancel', async () => {
+        const cts = new cancellation_1.CancellationTokenSource();
+        const request = tool.getTool();
+        let capturedExecutionId;
+        shellServer.execute.callsFake(async (req) => {
+            capturedExecutionId = req.executionId;
+            return new Promise(resolve => {
+                cts.token.onCancellationRequested(() => resolve(createResult({ canceled: true, stdout: '', stderr: '' })));
+            });
+        });
+        const handlerPromise = request.handler('{}', { toolCallId: 'tc-1', cancellationToken: cts.token });
+        cts.cancel();
+        await handlerPromise;
+        (0, chai_1.expect)(shellServer.cancel.calledOnce).to.be.true;
+        (0, chai_1.expect)(shellServer.cancel.firstCall.args[0]).to.equal(capturedExecutionId);
+    });
+    it('tracks the execution by tool call id so it can be cancelled by id', async () => {
+        let capturedExecutionId;
+        let release;
+        shellServer.execute.callsFake(async (req) => {
+            capturedExecutionId = req.executionId;
+            return new Promise(resolve => {
+                release = () => resolve(createResult());
+            });
+        });
+        const handlerPromise = tool.getTool().handler('{}', { toolCallId: 'tc-1' });
+        (0, chai_1.expect)(tool.isExecutionRunning('tc-1')).to.be.true;
+        (0, chai_1.expect)(await tool.cancelExecution('tc-1')).to.be.true;
+        (0, chai_1.expect)(shellServer.cancel.firstCall.args[0]).to.equal(capturedExecutionId);
+        release();
+        await handlerPromise;
+        (0, chai_1.expect)(tool.isExecutionRunning('tc-1')).to.be.false;
+    });
+    it('applies the default truncation budget, keeping only the first and last 50 lines', async () => {
+        const stdout = Array.from({ length: 500 }, (_unused, index) => `line ${index}`).join('\n');
+        shellServer.execute.resolves(createResult({ stdout }));
+        const result = await tool.getTool().handler('{}');
+        (0, chai_1.expect)(result.output).to.contain('line 0');
+        (0, chai_1.expect)(result.output).to.contain('line 499');
+        (0, chai_1.expect)(result.output).to.not.contain('line 250');
+        (0, chai_1.expect)(result.output).to.contain('400 lines omitted');
+    });
+    it('honours a raised truncation budget declared by the subclass', async () => {
+        class GenerousTool extends TestPredefinedShellTool {
+            constructor() {
+                super(...arguments);
+                this.truncation = { headLines: 400, tailLines: 100 };
+            }
+        }
+        container.bind(GenerousTool).toSelf();
+        const generous = container.get(GenerousTool);
+        const stdout = Array.from({ length: 500 }, (_unused, index) => `line ${index}`).join('\n');
+        shellServer.execute.resolves(createResult({ stdout }));
+        const result = await generous.getTool().handler('{}');
+        (0, chai_1.expect)(result.output).to.contain('line 250');
+        (0, chai_1.expect)(result.output).to.not.contain('lines omitted');
+    });
+});
+//# sourceMappingURL=predefined-shell-tool.spec.js.map

package/lib/browser/predefined-shell-tool.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-shell-tool.spec.js","sourceRoot":"","sources":["../../src/browser/predefined-shell-tool.spec.ts"],"names":[],"mappings":"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"}

package/lib/browser/shell-execution-tool.d.ts

@@ -1,15 +1,9 @@
-import { ToolProvider, ToolRequest } from '@theia/ai-core';
+import { ToolRequest } from '@theia/ai-core';
 import { ShellCommandPermissionService } from './shell-command-permission-service';
-import { WorkspaceService } from '@theia/workspace/lib/browser';
-import { ShellExecutionServer, ShellExecutionToolResult, ShellExecutionCanceledResult } from '../common/shell-execution-server';
-import { CancellationToken } from '@theia/core';
-export declare class ShellExecutionTool implements ToolProvider {
-    protected readonly shellServer: ShellExecutionServer;
-    protected readonly workspaceService: WorkspaceService;
+import { AbstractShellExecutionTool } from './abstract-shell-execution-tool';
+import { ShellExecutionToolResult, ShellExecutionCanceledResult } from '../common/shell-execution-server';
+export declare class ShellExecutionTool extends AbstractShellExecutionTool {
     protected readonly shellCommandPermissionService: ShellCommandPermissionService;
-    protected readonly runningExecutions: Map<string, string>;
-    cancelExecution(toolCallId: string): Promise<boolean>;
-    isExecutionRunning(toolCallId: string): boolean;
     getTool(): ToolRequest;
     protected executeCommand(argString: string, ctx?: unknown): Promise<ShellExecutionToolResult | ShellExecutionCanceledResult>;
     /**
@@ -18,8 +12,5 @@ export declare class ShellExecutionTool implements ToolProvider {
      * root-relative paths (<rootName>/...), and bare root names.
      */
     private resolveCwd;
-    protected extractToolCallId(ctx?: unknown): string | undefined;
-    protected extractCancellationToken(ctx: unknown): CancellationToken | undefined;
-    protected combineAndTruncate(stdout: string, stderr: string): string;
 }
 //# sourceMappingURL=shell-execution-tool.d.ts.map

package/lib/browser/shell-execution-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-execution-tool.d.ts","sourceRoot":"","sources":["../../src/browser/shell-execution-tool.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAEH,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAE/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AAEpE,qBACa,kBAAmB,YAAW,YAAY;IAGnD,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAGrD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAGtD,SAAS,CAAC,QAAQ,CAAC,6BAA6B,EAAE,6BAA6B,CAAC;IAEhF,SAAS,CAAC,QAAQ,CAAC,iBAAiB,sBAA6B;IAE3D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY3D,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI/C,OAAO,IAAI,WAAW;cA2GN,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,GAAG,4BAA4B,CAAC;IA2DlI;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAyClB,SAAS,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAO9D,SAAS,CAAC,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS;IAa/E,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAGvE"}
+{"version":3,"file":"shell-execution-tool.d.ts","sourceRoot":"","sources":["../../src/browser/shell-execution-tool.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAEH,wBAAwB,EACxB,4BAA4B,EAC/B,MAAM,kCAAkC,CAAC;AAG1C,qBACa,kBAAmB,SAAQ,0BAA0B;IAG9D,SAAS,CAAC,QAAQ,CAAC,6BAA6B,EAAE,6BAA6B,CAAC;IAEhF,OAAO,IAAI,WAAW;cA2GN,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,GAAG,4BAA4B,CAAC;IAelI;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAyCrB"}