dev: improve clarity of sample contributions (#16937)

Clearly mark contributions of api-samples in UI and logs.
This is useful for Theia developers to easily separate between
framework and api-samples behavior when testing.

- Use named logger 'api-samples' for consistent log identification
- Prefix console logs with [api-samples] in electron-main context
- Use unified 'API Samples' category for all commands
- Append 'Sample' suffix to chat agent IDs and names
- Prefix MCP tool and resource names with 'sample-'
- Update notification messages to include 'Sample Updater' prefix

Author: sdirix

examples/api-samples/src/browser/chat/ask-and-continue-chat-agent-contribution.ts

@@ -109,8 +109,8 @@ Do not ask further questions once the text contains 5 or more "Question/Answer"
  */
 @injectable()
 export class AskAndContinueChatAgent extends AbstractStreamParsingChatAgent {
-    id = 'AskAndContinue';
-    name = 'AskAndContinue';
+    id = 'AskAndContinueSample';
+    name = 'AskAndContinueSample';
     override description = 'This chat will ask questions related to the input and continues after that.';
     protected defaultLanguageModelPurpose = 'chat';
     override languageModelRequirements = [

examples/api-samples/src/browser/chat/change-set-chat-agent-contribution.ts

@@ -40,8 +40,8 @@ export function bindChangeSetChatAgentContribution(bind: interfaces.Bind): void
  */
 @injectable()
 export class ChangeSetChatAgent extends AbstractStreamParsingChatAgent {
-    readonly id = 'ChangeSet';
-    readonly name = 'ChangeSet';
+    readonly id = 'ChangeSetSample';
+    readonly name = 'ChangeSetSample';
     readonly defaultLanguageModelPurpose = 'chat';
     override readonly description = 'This chat will create and modify a change set.';
     override languageModelRequirements: LanguageModelRequirement[] = [];

examples/api-samples/src/browser/chat/chat-node-toolbar-action-contribution.ts

@@ -31,7 +31,7 @@ export function bindChatNodeToolbarActionContribution(bind: interfaces.Bind): vo
                 return [{
                     commandId: 'sample-command',
                     icon: 'codicon codicon-feedback',
-                    tooltip: 'Example command'
+                    tooltip: 'API Samples: Example command'
                 }];
             } else {
                 return [];

examples/api-samples/src/browser/chat/custom-response-content-agent-contribution.ts

@@ -240,7 +240,7 @@ export class CustomNonSerializableContentRenderer implements ChatResponsePartRen
 
 @injectable()
 export class CustomResponseContentRendererAgent extends AbstractStreamParsingChatAgent implements ChatAgent {
-    id = 'CustomContent';
+    id = 'CustomContentSample';
     name = this.id;
     override description = 'Demonstrates custom serializable and non-serializable chat response content';
     languageModelRequirements = [];

examples/api-samples/src/browser/chat/mode-chat-agent-contribution.ts

@@ -36,8 +36,8 @@ export function bindModeChatAgentContribution(bind: interfaces.Bind): void {
  */
 @injectable()
 export class ModeChatAgent extends AbstractStreamParsingChatAgent {
-    readonly id = 'ModeTest';
-    readonly name = 'ModeTest';
+    readonly id = 'ModeTestSample';
+    readonly name = 'ModeTestSample';
     readonly defaultLanguageModelPurpose = 'chat';
     override readonly description = 'A test agent that demonstrates different response modes (concise vs detailed).';
     override languageModelRequirements: LanguageModelRequirement[] = [];

examples/api-samples/src/browser/chat/original-state-test-agent-contribution.ts

@@ -40,8 +40,8 @@ export function bindOriginalStateTestAgentContribution(bind: interfaces.Bind): v
  */
 @injectable()
 export class OriginalStateTestAgent extends AbstractStreamParsingChatAgent {
-    readonly id = 'OriginalStateTest';
-    readonly name = 'OriginalStateTest';
+    readonly id = 'OriginalStateTestSample';
+    readonly name = 'OriginalStateTestSample';
     readonly defaultLanguageModelPurpose = 'chat';
     override readonly description = 'This chat will test originalState functionality with sequential changes.';
     override languageModelRequirements: LanguageModelRequirement[] = [];

examples/api-samples/src/browser/contribution-filter/sample-filtered-command-contribution.ts

@@ -19,17 +19,17 @@ import { injectable, interfaces } from '@theia/core/shared/inversify';
 
 export namespace SampleFilteredCommand {
 
-    const EXAMPLE_CATEGORY = 'Examples';
+    const API_SAMPLES_CATEGORY = 'API Samples';
 
     export const FILTERED: Command = {
         id: 'example_command.filtered',
-        category: EXAMPLE_CATEGORY,
+        category: API_SAMPLES_CATEGORY,
         label: 'This command should be filtered out'
     };
 
     export const FILTERED2: Command = {
         id: 'example_command.filtered2',
-        category: EXAMPLE_CATEGORY,
+        category: API_SAMPLES_CATEGORY,
         label: 'This command should be filtered out (2)'
     };
 }

examples/api-samples/src/browser/file-system/sample-file-system-capabilities.ts

@@ -29,7 +29,8 @@ export class SampleFileSystemCapabilities implements CommandContribution {
     registerCommands(commands: CommandRegistry): void {
         commands.registerCommand({
             id: 'toggleFileSystemReadonly',
-            label: 'Toggle File System Readonly'
+            label: 'Toggle File System Readonly',
+            category: 'API Samples'
         }, {
             execute: () => {
                 const readonly = (this.remoteFileSystemProvider.capabilities & FileSystemProviderCapabilities.Readonly) !== 0;
@@ -43,7 +44,8 @@ export class SampleFileSystemCapabilities implements CommandContribution {
 
         commands.registerCommand({
             id: 'addFileSystemReadonlyMessage',
-            label: 'Add a File System ReadonlyMessage for readonly'
+            label: 'Add File System ReadonlyMessage',
+            category: 'API Samples'
         }, {
             execute: () => {
                 const readonlyMessage = new MarkdownStringImpl(`Added new **Markdown** string '+${Date.now()}`);
@@ -53,7 +55,8 @@ export class SampleFileSystemCapabilities implements CommandContribution {
 
         commands.registerCommand({
             id: 'removeFileSystemReadonlyMessage',
-            label: 'Remove File System ReadonlyMessage for readonly'
+            label: 'Remove File System ReadonlyMessage',
+            category: 'API Samples'
         }, {
             execute: () => {
                 this.remoteFileSystemProvider['setReadOnlyMessage'](undefined);

examples/api-samples/src/browser/file-watching/sample-file-watching-contribution.ts

@@ -14,10 +14,11 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 
-import { postConstruct, injectable, inject, interfaces } from '@theia/core/shared/inversify';
+import { postConstruct, injectable, inject, interfaces, named } from '@theia/core/shared/inversify';
 import {
     FrontendApplicationContribution, LabelProvider,
 } from '@theia/core/lib/browser';
+import { ILogger } from '@theia/core/lib/common/logger';
 import { FileService } from '@theia/filesystem/lib/browser/file-service';
 import { WorkspaceService } from '@theia/workspace/lib/browser';
 import { createPreferenceProxy, PreferenceService, PreferenceProxy, PreferenceContribution } from '@theia/core';
@@ -55,6 +56,9 @@ class SampleFileWatchingContribution implements FrontendApplicationContribution
     @inject(FileWatchingPreferences)
     protected readonly fileWatchingPreferences: FileWatchingPreferences;
 
+    @inject(ILogger) @named('api-samples')
+    protected readonly logger: ILogger;
+
     @postConstruct()
     protected init(): void {
         this.verbose = this.fileWatchingPreferences['sample.file-watching.verbose'];
@@ -75,7 +79,7 @@ class SampleFileWatchingContribution implements FrontendApplicationContribution
                 const workspace = roots.length > 0
                     ? roots.map(root => this.labelProvider.getLongName(root.resource)).join('+')
                     : '<no workspace>';
-                console.log(`Sample File Watching: ${event.changes.length} file(s) changed! ${workspace}`);
+                this.logger.info(`Sample File Watching: ${event.changes.length} file(s) changed! ${workspace}`);
             }
         });
     }

examples/api-samples/src/browser/label/sample-dynamic-label-provider-command-contribution.ts

@@ -20,10 +20,10 @@ import { FrontendApplicationContribution, LabelProviderContribution } from '@the
 import { SampleDynamicLabelProviderContribution } from './sample-dynamic-label-provider-contribution';
 
 export namespace ExampleLabelProviderCommands {
-    const EXAMPLE_CATEGORY = 'Examples';
+    const API_SAMPLES_CATEGORY = 'API Samples';
     export const TOGGLE_SAMPLE: Command = {
         id: 'example_label_provider.toggle',
-        category: EXAMPLE_CATEGORY,
+        category: API_SAMPLES_CATEGORY,
         label: 'Toggle Dynamically-Changing Labels'
     };
 }