lace-mcp 0.0.2-alpha.19 → 0.0.2-alpha.20

package/SKILL.md

@@ -12,8 +12,8 @@ Lace surfaces adoption insights as actionable decisions. When a decision is appr
 1. Call the `search_decisions` MCP tool with no params to see recently approved decisions, or pass filters such as `query`, `canvasId`, `projectId`, `appName`, or `elementRole` when the user has given scope.
 2. If the workspace has many canvases or projects, call `list_canvases` or `list_projects` first and use the returned IDs/titles to scope `search_decisions`.
 3. If there is exactly one relevant decision, proceed with it. If there are multiple plausible matches, ask the user which one to implement.
-4. Call `apply_decision` with the chosen decision ID. Use `target: "code"` for code changes, `target: "slideshow"` for slide content, `target: "graphic"` for graphic specs, or `target: "prototype"` for prototype data.
-5. Use `include: "implementation"` by default. Use `include: "image"` for a cropped element image, `include: "context"` for thread rationale, or `include: "all"` when you need screenshots, cropped image, and rationale together.
+4. Call `apply_decision` with the chosen decision ID.
+5. Use `include: "instructions"` by default. Use `include: "crop"` for a cropped element image, `include: "discussion"` for thread rationale, or `include: "all"` when you need screenshots, cropped image, and rationale together.
 6. Follow the implementation instructions returned by `apply_decision` exactly — they include screenshots, element targeting, and constraints.
 7. Implement the minimal code change described. Do not refactor or modify anything outside the target element.
 

package/dist/cli.js

@@ -82166,12 +82166,12 @@ var init_zod2 = __esm({
 
 // ../../libs/shared/src/decisionCanvas/types.ts
 function isFullPageBbox(target) {
-  return target.bbox_x1 <= 0 && target.bbox_y1 <= 0 && target.bbox_x2 >= 1 && target.bbox_y2 >= 1;
+  return target.bbox_x1 <= FULL_PAGE_EPSILON && target.bbox_y1 <= FULL_PAGE_EPSILON && target.bbox_x2 >= 1 - FULL_PAGE_EPSILON && target.bbox_y2 >= 1 - FULL_PAGE_EPSILON;
 }
 function isCanvasDecisionAnnotation(annotation) {
   return annotation.kind == null || annotation.kind === CANVAS_ANNOTATION_KIND_DECISION;
 }
-var CANVAS_ANNOTATION_KIND_ELEMENT, CANVAS_ANNOTATION_KIND_DECISION, CANVAS_ANNOTATION_KIND_VALUES, CANVAS_ANNOTATION_STATUS_VALUES, CANVAS_ANNOTATION_ANCHOR_STATE_VALUES, CANVAS_ANNOTATION_ANCHOR_SOURCE_VALUES, CANVAS_ANNOTATION_HEADLINE_MAX_LENGTH, uuidSchema, optionalCanvasTextSchema, canvasBboxCoordinateSchema, optionalIsoDateSchema, createCanvasAnnotationInputSchema, CANVAS_ANNOTATION_CHANGE_EVENT_TYPES, CANVAS_PAGE_CHANGE_EVENT_TYPES, CANVAS_REPLY_CHANGE_EVENT_TYPES, CANVAS_THREAD_CHANGE_EVENT_TYPES, CANVAS_CHANGE_EVENT_TYPES, LACE_MCP_INSTRUCTIONS;
+var CANVAS_ANNOTATION_KIND_ELEMENT, CANVAS_ANNOTATION_KIND_DECISION, CANVAS_ANNOTATION_KIND_VALUES, CANVAS_ANNOTATION_STATUS_VALUES, CANVAS_ANNOTATION_ANCHOR_STATE_VALUES, CANVAS_ANNOTATION_ANCHOR_SOURCE_VALUES, CANVAS_ANNOTATION_HEADLINE_MAX_LENGTH, uuidSchema, optionalCanvasTextSchema, canvasBboxCoordinateSchema, optionalIsoDateSchema, createCanvasAnnotationInputSchema, FULL_PAGE_EPSILON, CANVAS_ANNOTATION_CHANGE_EVENT_TYPES, CANVAS_PAGE_CHANGE_EVENT_TYPES, CANVAS_REPLY_CHANGE_EVENT_TYPES, CANVAS_THREAD_CHANGE_EVENT_TYPES, CANVAS_CHANGE_EVENT_TYPES, LACE_MCP_INSTRUCTIONS;
 var init_types4 = __esm({
   "../../libs/shared/src/decisionCanvas/types.ts"() {
     "use strict";
@@ -82225,6 +82225,7 @@ var init_types4 = __esm({
       if (status === "resolved") return value.resolved_at !== null && value.resolved_at !== void 0;
       return value.resolved_at === null || value.resolved_at === void 0;
     });
+    FULL_PAGE_EPSILON = 0.01;
     CANVAS_ANNOTATION_CHANGE_EVENT_TYPES = [
       "annotation-created",
       "annotation-updated",
@@ -82252,9 +82253,9 @@ Discovery:
 - list_projects: browse projects to find project IDs for scoping.
 
 Action:
-- apply_decision: get the implementation kit for a decision. Set target to control output format (code, slideshow, graphic, prototype). Set include to control detail level (implementation, image, context, all).
+- apply_decision: get the implementation kit for a decision. Set include to control detail level (instructions, crop, discussion, all).
 
-Workflow: search_decisions -> pick a decision -> apply_decision with the right target.
+Workflow: search_decisions -> pick a decision -> apply_decision with the desired include mode.
 
 All tools scope to canvases you have access to. Some canvases may be view-only (title and status visible, no decisions). Decision IDs from search_decisions are valid for apply_decision.`;
   }
@@ -82323,18 +82324,21 @@ function deriveFlowContext(decision, allDecisions) {
   if (order === -1) return null;
   return { id: decision.canvas_id, order: order + 1, total: sorted.length };
 }
+function normalizeRole(role) {
+  return role.startsWith("AX") ? role.slice(2).toLowerCase() : role.toLowerCase();
+}
 function buildCanvasVocabulary(elementAnnotations) {
   if (elementAnnotations.length === 0) return null;
   const elements = elementAnnotations.map((annotation) => {
     const parts = [];
-    if (annotation.element_role) parts.push(annotation.element_role);
+    if (annotation.element_role) parts.push(normalizeRole(annotation.element_role));
     parts.push(annotation.element_visible_text ?? annotation.headline);
     return parts.join(" ");
   }).filter(Boolean).slice(0, MAX_CANVAS_VOCABULARY_ELEMENTS);
   if (elements.length === 0) return null;
-  return `<vocabulary>
-${elements.map((element) => `  <element>${esc3(element)}</element>`).join("\n")}
-</vocabulary>`;
+  return `<page-elements>
+${elements.map((element) => `  <item>${esc3(element)}</item>`).join("\n")}
+</page-elements>`;
 }
 function canvasAnnotationToDecisionXmlInput(decision, allDecisions) {
   return {
@@ -82345,7 +82349,12 @@ function canvasAnnotationToDecisionXmlInput(decision, allDecisions) {
     createdAt: decision.created_at,
     resolvedAt: decision.resolved_at,
     resolvedBy: decision.approved_by ?? null,
-    bbox: decision.anchor_state === "detached" || isFullPageBbox(decision) ? null : [decision.bbox_x1, decision.bbox_y1, decision.bbox_x2, decision.bbox_y2],
+    bbox: decision.anchor_state === "detached" || isFullPageBbox(decision) ? null : [
+      Math.round(decision.bbox_x1 * 100),
+      Math.round(decision.bbox_y1 * 100),
+      Math.round(decision.bbox_x2 * 100),
+      Math.round(decision.bbox_y2 * 100)
+    ],
     element: {
       role: decision.element_role,
       label: decision.element_visible_text,
@@ -82374,19 +82383,16 @@ function serializeDecisionXml(decision) {
   const actionsXml = decision.element.actions?.length ? `
     <actions>${esc3(decision.element.actions.join(","))}</actions>` : "";
   return [
-    `<decision${attr("id", decision.id)}${attr("status", decision.status)}${optionalAttr("anchor_state", anchorState)}${optionalAttr("element_eid", decision.elementEid)}${attr("created_at", decision.createdAt)}${optionalAttr("resolved_at", decision.resolvedAt)}${optionalAttr("resolved_by", decision.resolvedBy)}>`,
+    `<review-item${attr("status", decision.status)}${optionalAttr("anchor_state", anchorState)}${attr("created_at", decision.createdAt)}${optionalAttr("resolved_at", decision.resolvedAt)}>`,
     decision.bbox ? `  <bbox${attr("x1", decision.bbox[0])}${attr("y1", decision.bbox[1])}${attr("x2", decision.bbox[2])}${attr("y2", decision.bbox[3])} />` : "",
-    `  <element${optionalAttr("role", decision.element.role)}${optionalAttr("label", decision.element.label)}${optionalAttr("confidence", decision.element.confidence)}${optionalAttr("interactivity", decision.element.interactivity)}${optionalAttr("type", decision.element.type)}${optionalAttr("value", decision.element.value)}>${actionsXml}`,
+    `  <element${optionalAttr("role", decision.element.role)}${optionalAttr("label", decision.element.label)}${optionalAttr("type", decision.element.type)}${optionalAttr("value", decision.element.value)}>${actionsXml}`,
     "  </element>",
     "  <content>",
     `    <headline>${esc3(decision.content.headline)}</headline>`,
     decision.content.body ? `    <body>${esc3(decision.content.body)}</body>` : "",
     "  </content>",
     `  <screen${optionalAttr("app", decision.screen.appName)}${optionalAttr("window", decision.screen.windowTitle)}${optionalAttr("url", decision.screen.url)}${optionalAttr("viewport_w", decision.screen.viewportWidth)}${optionalAttr("viewport_h", decision.screen.viewportHeight)}${optionalAttr("captured_at", decision.screen.capturedAt)} />`,
-    `  <canvas${attr("id", decision.canvas.id)}${attr("page", decision.canvas.pageIndex)} />`,
-    decision.thread.id ? `  <thread${attr("id", decision.thread.id)} />` : "",
-    decision.flow ? `  <flow${attr("id", decision.flow.id)}${attr("order", decision.flow.order)}${attr("total", decision.flow.total)} />` : "",
-    "</decision>"
+    "</review-item>"
   ].filter(Boolean).join("\n");
 }
 function formatApplyDecisionText(decision, allDecisions, vocabulary, threadContext) {
@@ -82405,7 +82411,7 @@ ${messages.join("\n")}
 </thread>`);
   }
   parts.push(
-    "Apply the resolved Decision Canvas change. Use the element context, bbox, and screen metadata above as implementation grounding."
+    "Implement the UI change described above. The XML metadata identifies the target element and its position on screen \u2014 use it for grounding only. DO NOT reproduce XML tags, UUIDs, coordinate values, or internal field names in your output. DO: describe the change in natural language or code referencing the element by its visible text, role, or position. DON'T: mention review-item, bbox, page-elements, anchor_state, or any attribute names from the metadata."
   );
   return parts.join("\n\n");
 }
@@ -82470,7 +82476,8 @@ function loaderErrorResponse(error51, fallback) {
   if (error51 instanceof DecisionLoaderError) {
     return { content: [{ type: "text", text: error51.contentText }], isError: true };
   }
-  return { content: [{ type: "text", text: fallback }], isError: true };
+  const detail = error51 instanceof Error ? error51.message : String(error51);
+  return { content: [{ type: "text", text: `${fallback} (${detail})` }], isError: true };
 }
 function loaderScope(scope) {
   return { orgId: scope.orgId, userId: scope.userId };
@@ -82502,7 +82509,13 @@ function resolveCropSource(detail) {
 }
 function decisionBbox(decision) {
   if (!isValidBbox(decision)) return null;
-  return [decision.bbox_x1, decision.bbox_y1, decision.bbox_x2, decision.bbox_y2];
+  const pad = 0.02;
+  return [
+    Math.max(0, decision.bbox_x1 - pad),
+    Math.max(0, decision.bbox_y1 - pad),
+    Math.min(1, decision.bbox_x2 + pad),
+    Math.min(1, decision.bbox_y2 + pad)
+  ];
 }
 function decisionNotFoundResult(id) {
   return {
@@ -82511,16 +82524,29 @@ function decisionNotFoundResult(id) {
   };
 }
 async function appendImplementationContent(context2, include) {
-  const detail = await context2.loader.loadDecisionDetail(context2.id, context2.scope);
+  const [detail, threadContext] = await (include === "all" ? Promise.all([
+    context2.loader.loadDecisionDetail(context2.id, context2.scope),
+    context2.loader.loadThreadContext(context2.id, context2.scope)
+  ]) : [await context2.loader.loadDecisionDetail(context2.id, context2.scope), void 0]);
   if (!detail) return null;
-  context2.content.push(...detail.images);
-  const vocabulary = await context2.loader.loadElementVocabulary(detail.decision.canvas_id, context2.scope);
+  const vocabulary = await context2.loader.loadElementVocabulary(
+    detail.decision.canvas_id,
+    context2.scope,
+    detail.decision.page_id
+  );
   const vocabStr = vocabulary.length > 0 ? buildCanvasVocabulary(vocabulary) : null;
-  const threadContext = include === "all" ? await context2.loader.loadThreadContext(context2.id, context2.scope) : void 0;
   context2.content.push({
     type: "text",
     text: formatApplyDecisionText(detail.decision, detail.allDecisions, vocabStr, threadContext)
   });
+  context2.content.push(...detail.images);
+  const totalImageBytes = detail.images.reduce((sum, img) => sum + (img.type === "image" ? img.data.length : 0), 0);
+  if (totalImageBytes > 5e6) {
+    context2.content.unshift({
+      type: "text",
+      text: "Warning: Large screenshot payload (" + Math.round(totalImageBytes / 1e6) + 'MB base64). Consider using include="instructions" without images if context window is limited.'
+    });
+  }
   return detail;
 }
 async function appendImageContent(context2, existingDetail) {
@@ -82528,7 +82554,12 @@ async function appendImageContent(context2, existingDetail) {
   if (!detail) return null;
   const cropSource = resolveCropSource(detail);
   const bbox = cropSource ? decisionBbox(cropSource) : null;
-  if (!cropSource || !bbox) return detail;
+  if (!cropSource || !bbox) {
+    if (detail.images.length > 0 && !context2.content.some((c) => c.type === "image")) {
+      context2.content.push(...detail.images);
+    }
+    return detail;
+  }
   const cropped = await context2.loader.cropElement(cropSource.page.artifact_id, bbox, context2.scope);
   if (cropped) context2.content.push({ type: "image", data: cropped, mimeType: "image/png" });
   return detail;
@@ -82539,61 +82570,57 @@ async function appendContextContent(content, loader, id, scope) {
     content.push({ type: "text", text: "No thread context available for this decision." });
     return;
   }
-  const formatted = messages.map((message) => "role" in message ? `[${message.role}] ${message.visibleText ?? ""}` : message.text).join("\n");
-  content.push({ type: "text", text: formatted });
+  const formatted = messages.map(
+    (message) => "role" in message ? `<message role="${message.role}">${esc3(message.visibleText ?? "")}</message>` : `<message>${esc3(message.text)}</message>`
+  ).join("\n");
+  content.push({ type: "text", text: `<thread>
+${formatted}
+</thread>` });
 }
 async function handleApplyDecision(loader, id, include, scope) {
   const content = [];
   const context2 = { content, loader, id, scope };
   let detail = null;
-  if (include === "implementation" || include === "all") {
+  if (include === "instructions" || include === "all") {
     detail = await appendImplementationContent(context2, include);
     if (!detail) return decisionNotFoundResult(id);
   }
-  if (include === "image" || include === "all") {
+  if (include === "crop" || include === "all") {
     detail = await appendImageContent(context2, detail);
   }
-  if (include === "context" && content.length === 0) {
+  if (include === "discussion" && content.length === 0) {
     await appendContextContent(content, loader, id, scope);
   }
-  return content.length > 0 ? { content } : decisionNotFoundResult(id);
+  if (content.length === 0) {
+    if (detail) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: 'Decision found but no content could be loaded for the requested include mode. Try include="instructions" for the full context.'
+          }
+        ],
+        isError: true
+      };
+    }
+    return decisionNotFoundResult(id);
+  }
+  return { content };
 }
-function registerSearchDecisionsTool(server2, loader, getScope, onToolInvoked) {
+function registerSearchDecisionsTool({
+  server: server2,
+  loader,
+  getScope,
+  onToolInvoked,
+  onToolError
+}) {
   server2.registerTool(
     "search_decisions",
     {
       title: "Search Decisions",
-      description: "Search and filter resolved decisions with cursor pagination. With no parameters, returns the top 20 ranked by recency and detail. For full detail on a specific decision, use apply_decision.",
+      description: "Search and filter resolved decisions with cursor pagination. With no parameters, returns the top 20 ranked by recency and detail. For full detail on a specific decision, use apply_decision. Tip: start broad (no filters), then narrow with canvasTitle, appName, or elementRole.",
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-      inputSchema: {
-        query: external_exports.string().optional().describe("Text search across headline, body, and element text"),
-        status: external_exports.enum(["resolved", "suggested", "all"]).default("resolved").optional().describe("Filter by annotation status (default: resolved)"),
-        limit: external_exports.number().int().min(1).max(100).default(20).optional().describe("Results per page (1-100, default 20)"),
-        cursor: external_exports.string().optional().describe("Opaque pagination cursor from a previous response"),
-        sort: external_exports.enum(["relevance", "resolved_at_desc", "created_at_desc"]).default("resolved_at_desc").optional().describe("Sort order"),
-        canvasId: external_exports.string().uuid().optional().describe("Exact canvas ID"),
-        canvasTitle: external_exports.string().optional().describe("Canvas title substring match"),
-        canvasStatus: external_exports.enum(["active", "archived"]).optional().describe("Canvas lifecycle status"),
-        pageId: external_exports.string().uuid().optional().describe("Exact page ID"),
-        pageName: external_exports.string().optional().describe("Page name substring match"),
-        projectId: external_exports.string().uuid().optional().describe("Exact project ID"),
-        projectName: external_exports.string().optional().describe("Project name substring match"),
-        threadId: external_exports.string().uuid().optional(),
-        appName: external_exports.string().optional().describe("App name substring match"),
-        windowTitle: external_exports.string().optional().describe("Window title substring match"),
-        url: external_exports.string().optional().describe("URL substring match"),
-        anchorState: external_exports.enum(["anchored", "reanchored", "detached"]).optional(),
-        elementEid: external_exports.string().optional().describe("Exact element accessibility ID"),
-        elementRole: external_exports.string().optional().describe("Exact element ARIA role"),
-        elementInteractivity: external_exports.boolean().optional(),
-        minEndorsements: external_exports.number().int().min(0).optional().describe("Minimum endorsement count"),
-        hasReplies: external_exports.boolean().optional().describe("Filter to decisions with replies"),
-        createdBy: external_exports.string().uuid().optional().describe("Creator user ID"),
-        resolvedFrom: external_exports.string().optional().describe("ISO date lower bound for resolved_at"),
-        resolvedTo: external_exports.string().optional().describe("ISO date upper bound for resolved_at"),
-        createdFrom: external_exports.string().optional().describe("ISO date lower bound for created_at"),
-        createdTo: external_exports.string().optional().describe("ISO date upper bound for created_at")
-      }
+      inputSchema: searchDecisionsSchema
     },
     async (params) => {
       onToolInvoked?.("search_decisions");
@@ -82607,38 +82634,38 @@ function registerSearchDecisionsTool(server2, loader, getScope, onToolInvoked) {
           ]
         };
       } catch (e) {
+        onToolError?.(e, { toolName: "search_decisions" });
         return loaderErrorResponse(e, "Failed to search decisions. Please try again.");
       }
     }
   );
 }
-function registerApplyDecisionTool(server2, loader, getScope, onToolInvoked) {
+function registerApplyDecisionTool({ server: server2, loader, getScope, onToolInvoked, onToolError }) {
   server2.registerTool(
     "apply_decision",
     {
       title: "Apply Decision",
-      description: "Act on a resolved decision. Returns implementation kit with screenshot, element targeting, and step-by-step instructions. Set target to control output format: code changes, slideshow content, graphic specs, or prototype data. Set include to control detail level.",
+      description: 'Retrieve the full implementation context for a UI change. Returns a multimodal response with screenshots, element metadata, and step-by-step instructions. Use include to select what is returned. For a full page screenshot with implementation instructions, use the default include="instructions". Do not use include="crop" expecting a full page \u2014 it returns only a cropped element.',
       inputSchema: {
         id: external_exports.string().describe("Decision ID from search_decisions"),
-        include: external_exports.enum(["implementation", "image", "context", "all"]).default("implementation").optional().describe(
-          "What to return: implementation (screenshot + instructions), image (cropped element), context (thread discussion), all (everything)"
-        ),
-        target: external_exports.enum(["code", "slideshow", "graphic", "prototype"]).default("code").optional().describe("Output format for instructions")
+        include: external_exports.enum(["instructions", "crop", "discussion", "all"]).default("instructions").optional().describe(
+          '"instructions" (default): full page screenshot + element metadata + instructions. "crop": cropped screenshot of the specific element only (falls back to full page when no element region exists). "discussion": thread discussion text, no images. "all": full page screenshot, cropped element, instructions, and thread context combined.'
+        )
       },
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    async ({ id, include = "implementation", target = "code" }) => {
+    async ({ id, include = "instructions" }) => {
       onToolInvoked?.("apply_decision");
       try {
-        void target;
         return await handleApplyDecision(loader, id, include, loaderScope(getScope()));
       } catch (e) {
+        onToolError?.(e, { toolName: "apply_decision" });
         return loaderErrorResponse(e, "Failed to apply decision. Please try again.");
       }
     }
   );
 }
-function registerListCanvasesTool(server2, loader, getScope, onToolInvoked) {
+function registerListCanvasesTool({ server: server2, loader, getScope, onToolInvoked, onToolError }) {
   server2.registerTool(
     "list_canvases",
     {
@@ -82656,14 +82683,21 @@ function registerListCanvasesTool(server2, loader, getScope, onToolInvoked) {
       onToolInvoked?.("list_canvases");
       try {
         const result = await loader.listCanvases(params, loaderScope(getScope()));
-        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        const text = result.nextCursor ? `Showing ${result.canvases.length} canvases. Pass cursor "${result.nextCursor}" to see more.` : `Showing ${result.canvases.length} canvases.`;
+        return {
+          content: [
+            { type: "text", text },
+            { type: "text", text: JSON.stringify(result) }
+          ]
+        };
       } catch (e) {
+        onToolError?.(e, { toolName: "list_canvases" });
         return loaderErrorResponse(e, "Failed to list canvases. Please try again.");
       }
     }
   );
 }
-function registerListProjectsTool(server2, loader, getScope, onToolInvoked) {
+function registerListProjectsTool({ server: server2, loader, getScope, onToolInvoked, onToolError }) {
   server2.registerTool(
     "list_projects",
     {
@@ -82679,29 +82713,79 @@ function registerListProjectsTool(server2, loader, getScope, onToolInvoked) {
       onToolInvoked?.("list_projects");
       try {
         const result = await loader.listProjects(params, loaderScope(getScope()));
-        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+        const text = result.nextCursor ? `Showing ${result.projects.length} projects. Pass cursor "${result.nextCursor}" to see more.` : `Showing ${result.projects.length} projects.`;
+        return {
+          content: [
+            { type: "text", text },
+            { type: "text", text: JSON.stringify(result) }
+          ]
+        };
       } catch (e) {
+        onToolError?.(e, { toolName: "list_projects" });
         return loaderErrorResponse(e, "Failed to list projects. Please try again.");
       }
     }
   );
 }
-function registerMcpTools(server2, loader, getScope, onToolInvoked) {
-  registerSearchDecisionsTool(server2, loader, getScope, onToolInvoked);
-  registerApplyDecisionTool(server2, loader, getScope, onToolInvoked);
-  registerListCanvasesTool(server2, loader, getScope, onToolInvoked);
-  registerListProjectsTool(server2, loader, getScope, onToolInvoked);
+function registerMcpTools(opts) {
+  registerSearchDecisionsTool(opts);
+  registerApplyDecisionTool(opts);
+  registerListCanvasesTool(opts);
+  registerListProjectsTool(opts);
 }
+var searchDecisionsSchema;
 var init_mcpToolRegistration = __esm({
   "../../libs/shared/src/mcpToolRegistration.ts"() {
     "use strict";
     init_zod2();
     init_decisionCanvas();
     init_mcpDecisionLoader();
+    searchDecisionsSchema = {
+      query: external_exports.string().optional().describe("Text search across headline, body, and element text"),
+      status: external_exports.enum(["resolved", "suggested", "all"]).default("resolved").optional().describe("Filter by annotation status (default: resolved)"),
+      limit: external_exports.number().int().min(1).max(100).default(20).optional().describe("Results per page (1-100, default 20)"),
+      cursor: external_exports.string().optional().describe("Opaque pagination cursor from a previous response"),
+      sort: external_exports.enum(["relevance", "resolved_at_desc", "created_at_desc"]).default("resolved_at_desc").optional().describe("Sort order"),
+      canvasId: external_exports.string().uuid().optional().describe("Exact canvas ID"),
+      canvasTitle: external_exports.string().optional().describe("Canvas title substring match"),
+      canvasStatus: external_exports.enum(["active", "archived"]).optional().describe("Canvas lifecycle status"),
+      pageId: external_exports.string().uuid().optional().describe("Exact page ID"),
+      pageName: external_exports.string().optional().describe("Page name substring match"),
+      projectId: external_exports.string().uuid().optional().describe("Exact project ID"),
+      projectName: external_exports.string().optional().describe("Project name substring match"),
+      threadId: external_exports.string().uuid().optional().describe("Filter by thread ID"),
+      appName: external_exports.string().optional().describe("App name substring match"),
+      windowTitle: external_exports.string().optional().describe("Window title substring match"),
+      url: external_exports.string().optional().describe("URL substring match"),
+      anchorState: external_exports.enum(["anchored", "reanchored", "detached"]).optional().describe(
+        "Filter by anchor state (anchored = confirmed position, reanchored = moved, detached = element not found)"
+      ),
+      elementEid: external_exports.string().optional().describe("Exact element accessibility ID"),
+      elementRole: external_exports.string().optional().describe("Exact element ARIA role"),
+      elementInteractivity: external_exports.boolean().optional().describe("Filter to interactive elements only"),
+      minEndorsements: external_exports.number().int().min(0).optional().describe("Minimum endorsement count"),
+      hasReplies: external_exports.boolean().optional().describe("Filter to decisions with replies"),
+      createdBy: external_exports.string().uuid().optional().describe("Creator user ID"),
+      resolvedFrom: external_exports.string().optional().describe("ISO date lower bound for resolved_at \u2014 prefer resolved dates for finding recently approved decisions"),
+      resolvedTo: external_exports.string().optional().describe("ISO date upper bound for resolved_at \u2014 prefer resolved dates for finding recently approved decisions"),
+      createdFrom: external_exports.string().optional().describe("ISO date lower bound for created_at \u2014 prefer created dates for finding recently suggested decisions"),
+      createdTo: external_exports.string().optional().describe("ISO date upper bound for created_at \u2014 prefer created dates for finding recently suggested decisions")
+    };
   }
 });
 
 // src/decisionLoaderHttp.ts
+async function fetchWithRetry(url2, init3, retries = 1) {
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const response = await fetch(url2, init3);
+      if (response.ok || attempt === retries) return response;
+    } catch (err) {
+      if (attempt === retries) throw err;
+    }
+  }
+  throw new Error("Unreachable");
+}
 function readMcpCredentials() {
   const apiBase = (process.env.LACE_API_BASE ?? process.env.API_BASE_URL ?? "").trim().replace(/\/$/, "");
   const token = (process.env.LACE_DESKTOP_API_TOKEN ?? "").trim();
@@ -82776,7 +82860,7 @@ function cropUrl(config4, artifactId, bbox) {
 }
 async function fetchCrop(config4, artifactId, bbox) {
   try {
-    const res = await fetch(cropUrl(config4, artifactId, bbox), {
+    const res = await fetchWithRetry(cropUrl(config4, artifactId, bbox), {
       headers: { Authorization: `Bearer ${config4.token}`, "x-org-id": config4.orgId },
       signal: AbortSignal.timeout(API_FETCH_TIMEOUT_MS)
     });
@@ -82806,7 +82890,7 @@ async function fetchDecisionThreadContext(decision) {
 }
 async function fetchArtifactPreviewUrl(artifactId, config4) {
   try {
-    const res = await fetch(
+    const res = await fetchWithRetry(
       `${config4.apiBase}/lace/screenshots/artifacts/${encodeURIComponent(artifactId)}/preview-url?kind=full`,
       {
         headers: { Accept: "application/json", Authorization: `Bearer ${config4.token}`, "x-org-id": config4.orgId },
@@ -82892,7 +82976,7 @@ function createHttpDecisionLoader() {
       const context2 = await fetchDecisionThreadContext(decision);
       return context2 ? [{ text: context2 }] : [];
     },
-    async loadElementVocabulary(canvasId, _scope) {
+    async loadElementVocabulary(canvasId, _scope, _pageId) {
       return fetchCanvasElementAnnotations(canvasId, requireConfig());
     },
     async listCanvases(query, _scope) {
@@ -82920,7 +83004,7 @@ var init_decisionLoaderHttp = __esm({
     init_decisionCanvas();
     init_mcpDecisionLoader();
     init_auth();
-    API_FETCH_TIMEOUT_MS = 1e4;
+    API_FETCH_TIMEOUT_MS = 3e4;
   }
 });
 
@@ -82928,9 +83012,18 @@ var init_decisionLoaderHttp = __esm({
 function getLocalScope() {
   return { orgId: readMcpCredentials()?.orgId ?? "", userId: "local-mcp" };
 }
+function handleToolError(error51, context2) {
+  esm_exports5.captureException(error51, { tags: { mcpTool: context2?.toolName ?? "unknown" } });
+}
 function createLaceServer() {
   const server2 = new McpServer({ name: "lace", version: "2.0.0" }, { instructions: LACE_MCP_INSTRUCTIONS });
-  registerMcpTools(server2, createHttpDecisionLoader(), getLocalScope, trackToolInvoked);
+  registerMcpTools({
+    server: server2,
+    loader: createHttpDecisionLoader(),
+    getScope: getLocalScope,
+    onToolInvoked: trackToolInvoked,
+    onToolError: handleToolError
+  });
   return server2;
 }
 var init_server3 = __esm({
@@ -82941,6 +83034,7 @@ var init_server3 = __esm({
     init_mcpToolRegistration();
     init_analytics();
     init_decisionLoaderHttp();
+    init_sentry();
   }
 });
 
@@ -82973,6 +83067,13 @@ var init_index = __esm({
       await flushTelemetry();
       throw err;
     }
+    process.on("uncaughtException", (err) => {
+      esm_exports5.captureException(err);
+      void flushTelemetry().finally(() => process.exit(1));
+    });
+    process.on("unhandledRejection", (reason) => {
+      esm_exports5.captureException(reason);
+    });
     process.on("beforeExit", () => void flushTelemetry());
     process.on("SIGINT", () => void flushTelemetry().finally(() => process.exit(0)));
     process.on("SIGTERM", () => void flushTelemetry().finally(() => process.exit(0)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lace-mcp",
-  "version": "0.0.2-alpha.19",
+  "version": "0.0.2-alpha.20",
   "type": "module",
   "files": [
     "dist/cli.js",