feat(copilot): Add scope property to tool manifests and update repository

- Add optional 'scope' property to ManifestUaiAgentTool.meta
- Update frontend tool repository to read scope from manifest
- Change filter from m.api to m.meta.parameters for accurate frontend tool detection
- Add scopes to frontend tools using kebab-case format:
  - set_property_value: entity-write
  - get_page_info: navigation
  - show_weather: web
  - get_current_time, confirm_action: no scope (defaults to 'general')

This aligns with the tool permission system defined in Core,
where scopes are defined by AIToolScopeBase classes with AIToolScopeAttribute.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: mattbrailsford

Umbraco.AI.Agent.Copilot/src/Umbraco.AI.Agent.Copilot/Client/src/copilot/tools/entity/manifests.ts

@@ -21,6 +21,7 @@ const setPropertyValueManifest: ManifestUaiAgentTool = {
 			"Only supports TextBox and TextArea properties. " +
 			"Use the entity context to see available properties and their current values.",
 		icon: "icon-edit",
+		scope: "entity-write",
 		parameters: {
 			type: "object",
 			properties: {

Umbraco.AI.Agent.Copilot/src/Umbraco.AI.Agent.Copilot/Client/src/copilot/tools/examples/manifests.ts

@@ -11,7 +11,7 @@ const getCurrentTimeManifest: ManifestUaiAgentTool = {
   name: "Get Current Time Tool",
   api: () => import("./get-current-time.api.js"),
   meta: {
-    toolName: "getCurrentTime",
+    toolName: "get_current_time",
     label: "Get Current Time",
     description: "Get the current date and time in the user's timezone. Use this when you need to know the current time.",
     icon: "icon-time",
@@ -39,10 +39,11 @@ const getPageInfoManifest: ManifestUaiAgentTool = {
   name: "Get Page Info Tool",
   api: () => import("./get-page-info.api.js"),
   meta: {
-    toolName: "getPageInfo",
+    toolName: "get_page_info",
     label: "Get Page Info",
     description: "Get information about the current Umbraco backoffice page including URL, section, and context.",
     icon: "icon-info",
+    scope: "navigation",
     parameters: {
       type: "object",
       properties: {},
@@ -62,10 +63,11 @@ const showWeatherManifest: ManifestUaiAgentTool = {
   api: () => import("./show-weather.api.js"),
   element: () => import("./show-weather.element.js"),
   meta: {
-    toolName: "showWeather",
+    toolName: "show_weather",
     label: "Weather",
     description: "Get and display the current weather for a location. Shows a visual weather card with temperature, conditions, and details.",
     icon: "icon-cloud",
+    scope: "web",
     parameters: {
       type: "object",
       properties: {
@@ -91,7 +93,7 @@ const confirmActionManifest: ManifestUaiAgentTool = {
   name: "Confirm Action Tool",
   api: () => import("./confirm-action.api.js"),
   meta: {
-    toolName: "confirmAction",
+    toolName: "confirm_action",
     label: "Confirm Action",
     description:
       "Ask the user to confirm an action before executing it. Use this when you need explicit user approval for an operation.",

Umbraco.AI.Agent.Copilot/src/Umbraco.AI.Agent.Copilot/Client/src/copilot/tools/frontend-tool.repository.ts

@@ -17,20 +17,22 @@ export class UaiFrontendToolRepository
     }
 
     /**
-     * Get all available frontend tools (tools with api property).
+     * Get all available frontend tools (tools with parameters defined).
+     * Backend tools don't define parameters - they come from the server.
      * @returns Array of frontend tool metadata
      */
     async getTools(): Promise<UaiFrontendToolData[]> {
-        const allManifests = umbExtensionsRegistry.getByType('uaiAgentTool') as ManifestUaiAgentTool[];
 
-        // Filter to only tools with api (frontend execution)
-        const frontendToolManifests = allManifests.filter((m) => m.api);
+        const frontendToolManifests = umbExtensionsRegistry.getByTypeAndFilter<
+          "uaiAgentTool",
+          ManifestUaiAgentTool
+        >("uaiAgentTool", (m) => Boolean(m.api));
 
         return frontendToolManifests.map((m) => ({
             id: m.meta.toolName,
             name: m.meta.label || m.meta.toolName,
             description: m.meta.description || '',
-            scopeId: 'frontend', // All copilot tools use 'frontend' scope
+            scopeId: m.meta.scope || 'general', // Read scope from manifest, default to 'general'
         }));
     }
 }

Umbraco.AI.Agent.Copilot/src/Umbraco.AI.Agent.Copilot/Client/src/copilot/tools/uai-agent-tool.extension.ts

@@ -148,6 +148,11 @@ export interface ManifestUaiAgentTool
     parameters?: Record<string, unknown>;
     /** Icon to display with the tool */
     icon?: string;
+    /**
+     * Tool scope for permission grouping (e.g., 'entity.write', 'navigation').
+     * Used to control which agents can access this tool.
+     */
+    scope?: string;
     /**
      * HITL approval configuration.
      * When specified, tool pauses for user approval before execution.