@theia/ai-ide 1.71.0-next.72 → 1.71.0

package/lib/common/user-interaction-tool.spec.js

@@ -0,0 +1,216 @@
+"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 chai_1 = require("chai");
+const user_interaction_tool_1 = require("./user-interaction-tool");
+describe('parseUserInteractionArgs', () => {
+    it('should return undefined for undefined input', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(undefined)).to.be.undefined;
+    });
+    it('should return undefined for invalid JSON', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)('not json')).to.be.undefined;
+    });
+    it('should return undefined when interactions is missing', () => {
+        const input = JSON.stringify({ foo: 'bar' });
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
+    });
+    it('should return undefined when interactions is not an array', () => {
+        const input = JSON.stringify({ interactions: 'nope' });
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
+    });
+    it('should return undefined when no step is valid', () => {
+        const input = JSON.stringify({ interactions: [{ foo: 'bar' }, { title: 1 }] });
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionArgs)(input)).to.be.undefined;
+    });
+    it('should drop steps that are missing title or message', () => {
+        const input = JSON.stringify({
+            interactions: [
+                { title: 'Valid', message: 'Hello' },
+                { title: 'No message' },
+                { message: 'No title' }
+            ]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result).to.not.be.undefined;
+        (0, chai_1.expect)(result.interactions).to.have.length(1);
+        (0, chai_1.expect)(result.interactions[0].title).to.equal('Valid');
+    });
+    it('should accept a step without options (informational)', () => {
+        const input = JSON.stringify({
+            interactions: [{ title: 'Info', message: 'Just so you know' }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result).to.not.be.undefined;
+        (0, chai_1.expect)(result.interactions[0].options).to.be.undefined;
+    });
+    it('should filter out invalid options within a step', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ text: 'A', value: 'a' }, { bad: true }, { text: 'B', value: 'b' }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].options).to.have.length(2);
+    });
+    it('should drop options array if no options are valid', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ bad: true }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].options).to.be.undefined;
+    });
+    it('should normalize singular link into a links array on a step', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ text: 'A', value: 'a' }],
+                    link: { ref: 'src/index.ts' }
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links).to.deep.equal([{ ref: 'src/index.ts' }]);
+    });
+    it('should accept a links array with multiple entries', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ text: 'A', value: 'a' }],
+                    links: [
+                        { ref: 'src/a.ts' },
+                        { ref: 'src/old.ts', rightRef: 'src/new.ts' }
+                    ]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links).to.have.length(2);
+    });
+    it('should filter out invalid links from a step', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ text: 'A', value: 'a' }],
+                    links: [
+                        { ref: 'src/a.ts' },
+                        { noRef: true },
+                        { ref: '' }
+                    ]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links).to.have.length(1);
+    });
+    it('should accept multiple steps in order', () => {
+        const input = JSON.stringify({
+            interactions: [
+                { title: 'Overview', message: 'PR summary' },
+                { title: 'Area 1', message: 'finding', options: [{ text: 'OK', value: 'approve' }] },
+                { title: 'Area 2', message: 'no findings' }
+            ]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions).to.have.length(3);
+        (0, chai_1.expect)(result.interactions[1].options).to.have.length(1);
+        (0, chai_1.expect)(result.interactions[2].options).to.be.undefined;
+    });
+    it('should preserve buttonLabel in options', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    options: [{ text: 'Confirm changes', value: 'confirm', buttonLabel: '✅ Confirm' }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].options[0].buttonLabel).to.equal('✅ Confirm');
+    });
+    it('should reject step links with empty path in object ref', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    links: [{ ref: { path: '' } }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links).to.be.undefined;
+    });
+    it('should accept step links with EmptyContentRef', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    links: [{ ref: { empty: true, label: 'New file' } }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links[0].ref).to.deep.equal({ empty: true, label: 'New file' });
+    });
+    it('should accept step links with EmptyContentRef as rightRef', () => {
+        const input = JSON.stringify({
+            interactions: [{
+                    title: 'T', message: 'M',
+                    links: [{ ref: 'src/old.ts', rightRef: { empty: true } }]
+                }]
+        });
+        const result = (0, user_interaction_tool_1.parseUserInteractionArgs)(input);
+        (0, chai_1.expect)(result.interactions[0].links[0].rightRef).to.deep.equal({ empty: true });
+    });
+});
+describe('parseUserInteractionInput', () => {
+    it('should return empty result for undefined input', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(undefined)).to.deep.equal({ title: '', stepCount: 0 });
+    });
+    it('should return empty result for empty string', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)('')).to.deep.equal({ title: '', stepCount: 0 });
+    });
+    it('should extract first step title and step count from valid JSON', () => {
+        const input = JSON.stringify({ interactions: [{ title: 'First' }, { title: 'Second' }] });
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input)).to.deep.equal({ title: 'First', stepCount: 2 });
+    });
+    it('should return empty title and 0 count when interactions array is empty', () => {
+        const input = JSON.stringify({ interactions: [] });
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input)).to.deep.equal({ title: '', stepCount: 0 });
+    });
+    it('should fall back to regex-based title extraction for incomplete JSON', () => {
+        const input = '{"interactions": [{"title": "Streaming Title", "message": "incom';
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input).title).to.equal('Streaming Title');
+    });
+    it('should return empty title from incomplete JSON without title field', () => {
+        const input = '{"interactions": [{"message": "no title here';
+        (0, chai_1.expect)((0, user_interaction_tool_1.parseUserInteractionInput)(input).title).to.equal('');
+    });
+});
+describe('buildDiffLabel', () => {
+    it('formats two empty refs', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.buildDiffLabel)({ empty: true, label: 'New' }, { empty: true, label: 'Deleted' }))
+            .to.equal('New ⟷ Deleted');
+    });
+    it('formats empty left vs path with gitRef', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.buildDiffLabel)({ empty: true, label: 'New' }, { path: 'src/x.ts', gitRef: 'abcdef0123' }))
+            .to.equal('src/x.ts (New ⟷ abcdef0)');
+    });
+    it('formats path with gitRef vs working copy of same path', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.buildDiffLabel)({ path: 'src/x.ts', gitRef: 'abcdef0123' }, { path: 'src/x.ts' }))
+            .to.equal('src/x.ts (abcdef0 ⟷ Working Copy)');
+    });
+    it('formats two different paths', () => {
+        (0, chai_1.expect)((0, user_interaction_tool_1.buildDiffLabel)({ path: 'src/old.ts' }, { path: 'src/new.ts' }))
+            .to.equal('src/old.ts ⟷ src/new.ts');
+    });
+});
+//# sourceMappingURL=user-interaction-tool.spec.js.map

package/lib/common/user-interaction-tool.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/ai-ide",
-  "version": "1.71.0-next.72+95c8dba0e",
+  "version": "1.71.0",
   "description": "AI IDE Agents Extension",
   "license": "EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0",
   "repository": {
@@ -15,24 +15,24 @@
     "theia-extension"
   ],
   "dependencies": {
-    "@theia/ai-chat": "1.71.0-next.72+95c8dba0e",
-    "@theia/ai-chat-ui": "1.71.0-next.72+95c8dba0e",
-    "@theia/ai-core": "1.71.0-next.72+95c8dba0e",
-    "@theia/ai-mcp": "1.71.0-next.72+95c8dba0e",
-    "@theia/ai-terminal": "1.71.0-next.72+95c8dba0e",
-    "@theia/core": "1.71.0-next.72+95c8dba0e",
-    "@theia/debug": "1.71.0-next.72+95c8dba0e",
-    "@theia/editor": "1.71.0-next.72+95c8dba0e",
-    "@theia/filesystem": "1.71.0-next.72+95c8dba0e",
-    "@theia/markers": "1.71.0-next.72+95c8dba0e",
-    "@theia/monaco": "1.71.0-next.72+95c8dba0e",
-    "@theia/navigator": "1.71.0-next.72+95c8dba0e",
-    "@theia/preferences": "1.71.0-next.72+95c8dba0e",
-    "@theia/scm": "1.71.0-next.72+95c8dba0e",
-    "@theia/search-in-workspace": "1.71.0-next.72+95c8dba0e",
-    "@theia/task": "1.71.0-next.72+95c8dba0e",
-    "@theia/terminal": "1.71.0-next.72+95c8dba0e",
-    "@theia/workspace": "1.71.0-next.72+95c8dba0e",
+    "@theia/ai-chat": "1.71.0",
+    "@theia/ai-chat-ui": "1.71.0",
+    "@theia/ai-core": "1.71.0",
+    "@theia/ai-mcp": "1.71.0",
+    "@theia/ai-terminal": "1.71.0",
+    "@theia/core": "1.71.0",
+    "@theia/debug": "1.71.0",
+    "@theia/editor": "1.71.0",
+    "@theia/filesystem": "1.71.0",
+    "@theia/markers": "1.71.0",
+    "@theia/monaco": "1.71.0",
+    "@theia/navigator": "1.71.0",
+    "@theia/preferences": "1.71.0",
+    "@theia/scm": "1.71.0",
+    "@theia/search-in-workspace": "1.71.0",
+    "@theia/task": "1.71.0",
+    "@theia/terminal": "1.71.0",
+    "@theia/workspace": "1.71.0",
     "date-fns": "^4.1.0",
     "ignore": "^6.0.2",
     "js-yaml": "^4.1.1",
@@ -44,8 +44,8 @@
     "access": "public"
   },
   "devDependencies": {
-    "@theia/cli": "1.71.0-next.72+95c8dba0e",
-    "@theia/test": "1.71.0-next.72+95c8dba0e"
+    "@theia/cli": "1.71.0",
+    "@theia/test": "1.71.0"
   },
   "theiaExtensions": [
     {
@@ -69,5 +69,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "95c8dba0ee6349c6be262ac2cf383909a3b62761"
+  "gitHead": "d8a596fc99f0a8e68b466828ed162569d79e3a71"
 }

package/src/browser/frontend-module.ts

@@ -107,6 +107,8 @@ import { CreateSkillAgent } from './create-skill-agent';
 import { SuggestTerminalCommand } from './ai-terminal-functions';
 import { TodoWriteTool } from './todo-tool';
 import { TodoToolRenderer } from './todo-tool-renderer';
+import { UserInteractionTool } from './user-interaction-tool';
+import { UserInteractionToolRenderer } from './user-interaction-tool-renderer';
 import { ChatResponsePartRenderer } from '@theia/ai-chat-ui/lib/browser/chat-response-part-renderer';
 import { ContextFileValidationService } from '@theia/ai-chat/lib/browser/context-file-validation-service';
 import { ContextFileValidationServiceImpl } from './context-file-validation-service-impl';
@@ -122,6 +124,7 @@ import { AgentModeConfirmationService, AgentModeConfirmationServiceImpl } from '
 import { ExploreAgent } from './explore-agent';
 import { CodeReviewerAgent } from './code-reviewer-agent';
 import { CodeReviewCapabilityContribution } from './code-review-capability-contribution';
+import { PRReviewAgent } from './review/pr-review-agent';
 
 export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bind(PreferenceContribution).toConstantValue({ schema: aiIdePreferenceSchema });
@@ -185,6 +188,10 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bind(Agent).toService(CodeReviewerAgent);
     bind(ChatAgent).toService(CodeReviewerAgent);
 
+    bind(PRReviewAgent).toSelf().inSingletonScope();
+    bind(Agent).toService(PRReviewAgent);
+    bind(ChatAgent).toService(PRReviewAgent);
+
     bind(ChatWelcomeMessageProvider).to(IdeChatWelcomeMessageProvider).inSingletonScope();
     bind(ChatWelcomeMessageProvider).to(ChatSessionsWelcomeMessageProvider).inSingletonScope();
     bindContributionProvider(bind, ChatSessionCardActionContribution);
@@ -332,7 +339,9 @@ export default new ContainerModule((bind, _unbind, _isBound, rebind) => {
     bindToolProvider(ListTaskContextsFunction, bind);
     bindToolProvider(RewriteTaskContextFunction, bind);
     bindToolProvider(TodoWriteTool, bind);
+    bindToolProvider(UserInteractionTool, bind);
     bind(ChatResponsePartRenderer).to(TodoToolRenderer).inSingletonScope();
+    bind(ChatResponsePartRenderer).to(UserInteractionToolRenderer).inSingletonScope();
 
     bind(ContextFileValidationServiceImpl).toSelf().inSingletonScope();
     bind(ContextFileValidationService).toService(ContextFileValidationServiceImpl);

package/src/browser/review/pr-review-agent.ts

@@ -0,0 +1,42 @@
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+import { AbstractStreamParsingChatAgent } from '@theia/ai-chat';
+import { LanguageModelRequirement } from '@theia/ai-core/lib/common';
+import { nls } from '@theia/core';
+import { injectable } from '@theia/core/shared/inversify';
+import { PR_REVIEW_SYSTEM_PROMPT_ID, prReviewSystemPrompt } from './pr-review-prompt-template';
+
+export const PRReviewAgentId = 'pr-reviewer';
+
+@injectable()
+export class PRReviewAgent extends AbstractStreamParsingChatAgent {
+    id = PRReviewAgentId;
+    name = 'PR Reviewer';
+    languageModelRequirements: LanguageModelRequirement[] = [{
+        purpose: 'chat',
+        identifier: 'default/code',
+    }];
+    protected defaultLanguageModelPurpose: string = 'chat';
+    override description = nls.localize('theia/ai/ide/prReviewAgent/description',
+        'An AI-powered PR review agent that orchestrates a full code review workflow: fetches PR info, explores the codebase, ' +
+        'performs structured analysis, interactively walks the user through findings with diff viewers, and optionally creates a pending review on GitHub.');
+
+    override iconClass: string = 'codicon codicon-git-pull-request-go-to-changes';
+    override prompts = [{ id: PR_REVIEW_SYSTEM_PROMPT_ID, defaultVariant: prReviewSystemPrompt, variants: [] }];
+    protected override systemPromptId: string = PR_REVIEW_SYSTEM_PROMPT_ID;
+    override tags: string[] = [...this.tags, 'Alpha'];
+}