feat: add client-side only tools

Author: hannessolo

src/server.ts

@@ -7,7 +7,7 @@ import {
 import { z } from 'zod';
 import { DAAdminClient } from './da-admin/client.js';
 import { EDSAdminClient } from './eds-admin/client.js';
-import { createDATools, createEDSTools } from './tools/tools.js';
+import { createCanvasClientTools, createDATools, createEDSTools } from './tools/tools.js';
 import { ensureHtmlExtension } from './tools/utils.js';
 import { createCollabClient } from './collab-client.js';
 
@@ -288,7 +288,8 @@ async function handleChat(request: Request, env: Env): Promise<Response> {
     collab: collab ?? undefined,
   });
   const edsTools = edsClient ? createEDSTools(edsClient) : {};
-  const tools = { ...daTools, ...edsTools };
+  const canvasClientTools = createCanvasClientTools();
+  const tools = { ...canvasClientTools, ...daTools, ...edsTools };
 
   const skills = daClient && pageContext
     ? await loadSkills(daClient, pageContext.org, pageContext.site)
@@ -335,6 +336,7 @@ Use the available tools to search documentation and provide accurate information
 Always provide helpful, accurate responses. You must never refer to the platform as "Dark Alley" or "DA".
 
 CRITICAL INSTRUCTION - TOOL USAGE:
+- For bulk preview, publish, or unpublish (live delete) of multiple DA pages in the canvas workspace, use the matching bulk canvas tools (run in the browser). Do not claim the operation finished until the user completes or dismisses the dialog.
 - NEVER mention tool names in your response text
 - NEVER explain that you are calling a tool or function
 - Simply perform the action and describe the RESULT, not the process

src/tools/tools.ts

@@ -395,6 +395,77 @@ export function createDATools(client: DAAdminClient | null, options?: DAToolsOpt
   return tools;
 }
 
+/**
+ * Runs only in the canvas browser; no `execute` so the AI SDK defers results to the client.
+ */
+export const CANVAS_CLIENT_ONLY_TOOLS = [
+  'da_bulk_preview',
+  'da_bulk_publish',
+  'da_bulk_delete',
+] as const;
+
+const bulkAemCanvasDialogOutputSchema = z.object({
+  cancelled: z.boolean().optional(),
+  okCount: z.number().optional(),
+  failCount: z.number().optional(),
+  message: z.string().optional(),
+  results: z
+    .array(
+      z.object({
+        path: z.string(),
+        ok: z.boolean(),
+        status: z.string().optional(),
+        message: z.string().optional(),
+      }),
+    )
+    .optional(),
+});
+
+const bulkAemPagesInputSchema = z.object({
+  pages: z
+    .array(z.string().min(1))
+    .min(1)
+    .describe(
+      'HTML page paths under the repo (e.g. "docs/guide.html" or "adobe/my-site/docs/guide.html")',
+    ),
+});
+
+/**
+ * Tools whose effects happen in the DA canvas UI (not on the worker).
+ * Each must omit `execute` and declare `outputSchema` for typing.
+ */
+export function createCanvasClientTools() {
+  return {
+    da_bulk_preview: tool({
+      description:
+        'Open a bulk preview dialog in the user\'s browser for multiple DA pages at once. '
+        + 'Use when the user wants to preview several pages in the canvas workspace without opening each one manually. '
+        + 'Paths may be relative to the current org/repo (e.g. "folder/page.html") or full "org/repo/path/to/page.html". '
+        + 'The user confirms in the dialog; results are returned after they finish or cancel.',
+      inputSchema: bulkAemPagesInputSchema,
+      outputSchema: bulkAemCanvasDialogOutputSchema,
+    }),
+    da_bulk_publish: tool({
+      description:
+        'Open a bulk publish dialog in the user\'s browser to publish multiple DA pages to AEM live (preview then live). '
+        + 'Use when the user wants to publish several pages at once from the canvas workspace. '
+        + 'Paths may be relative to the current org/repo or full "org/repo/path/to/page.html". '
+        + 'The user runs the action in the dialog; results return after they finish or cancel.',
+      inputSchema: bulkAemPagesInputSchema,
+      outputSchema: bulkAemCanvasDialogOutputSchema,
+    }),
+    da_bulk_delete: tool({
+      description:
+        'Open a bulk delete dialog in the user\'s browser to unpublish multiple pages from AEM live (DELETE on live). '
+        + 'Use only when the user explicitly wants to remove published pages. '
+        + 'Paths may be relative to the current org/repo or full "org/repo/path/to/page.html". '
+        + 'The user confirms in the dialog; results return after they finish or cancel.',
+      inputSchema: bulkAemPagesInputSchema,
+      outputSchema: bulkAemCanvasDialogOutputSchema,
+    }),
+  };
+}
+
 export function createEDSTools(client: EDSAdminClient) {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const tools: Record<string, any> = {};