lace-mcp 0.0.2-alpha.23 → 0.0.2-alpha.25

package/README.md

@@ -30,6 +30,7 @@ The Lace desktop app must be open and signed in for the MCP server to work.
 | --- | --- |
 | `search_decisions` | Search and filter resolved decisions with pagination. No params returns the top 20 |
 | `apply_decision` | Implementation kit for a decision: screenshots, targeting, instructions. `include` controls detail level (`discussion` requires the canvas owner to enable chat sharing) |
+| `publish_artifact` | Publish a local or remote artifact URL back into Lace and receive a shareable review canvas |
 | `list_canvases` | Browse review canvases with page names and decision counts |
 | `list_projects` | Browse projects with thread and canvas counts |
 

package/dist/cli.js

@@ -78947,6 +78947,79 @@ var init_mcp = __esm({
   }
 });
 
+// ../../libs/shared/src/reviewCommentRunBinding.ts
+var reviewCommentRunBindingSchema;
+var init_reviewCommentRunBinding = __esm({
+  "../../libs/shared/src/reviewCommentRunBinding.ts"() {
+    "use strict";
+    init_zod();
+    reviewCommentRunBindingSchema = external_exports.object({
+      bindingSource: external_exports.literal("prepared-context"),
+      canvasId: external_exports.string().trim().min(1),
+      commentRunId: external_exports.string().trim().min(1),
+      pageId: external_exports.string().trim().min(1),
+      screenshotId: external_exports.string().trim().min(1).nullable(),
+      shotId: external_exports.string().trim().min(1).nullable(),
+      sourceCaptureStatus: external_exports.enum(["unavailable", "live", "pending-durable", "durable"]),
+      viewport: external_exports.object({
+        height: external_exports.number().int().positive().nullable(),
+        width: external_exports.number().int().positive().nullable()
+      })
+    });
+  }
+});
+
+// ../../libs/shared/src/decisionCanvas/canvasMutations.ts
+var CANVAS_ANNOTATION_CHANGE_EVENT_TYPES, CANVAS_PAGE_CHANGE_EVENT_TYPES, CANVAS_REPLY_CHANGE_EVENT_TYPES, CANVAS_THREAD_CHANGE_EVENT_TYPES, CANVAS_CHANGE_EVENT_TYPES;
+var init_canvasMutations = __esm({
+  "../../libs/shared/src/decisionCanvas/canvasMutations.ts"() {
+    "use strict";
+    CANVAS_ANNOTATION_CHANGE_EVENT_TYPES = [
+      "annotation-created",
+      "annotation-updated",
+      "annotation-deleted",
+      "annotation-endorsed",
+      "annotation-resolved",
+      "annotation-reopened"
+    ];
+    CANVAS_PAGE_CHANGE_EVENT_TYPES = ["page-added", "page-removed", "page-reordered", "page-updated"];
+    CANVAS_REPLY_CHANGE_EVENT_TYPES = ["reply-created", "reply-updated", "reply-deleted"];
+    CANVAS_THREAD_CHANGE_EVENT_TYPES = ["thread-linked", "thread-unlinked"];
+    CANVAS_CHANGE_EVENT_TYPES = [
+      ...CANVAS_ANNOTATION_CHANGE_EVENT_TYPES,
+      ...CANVAS_PAGE_CHANGE_EVENT_TYPES,
+      ...CANVAS_REPLY_CHANGE_EVENT_TYPES,
+      "canvas-created",
+      "canvas-updated",
+      ...CANVAS_THREAD_CHANGE_EVENT_TYPES
+    ];
+  }
+});
+
+// ../../libs/shared/src/decisionCanvas/mcpInstructions.ts
+var LACE_MCP_INSTRUCTIONS;
+var init_mcpInstructions = __esm({
+  "../../libs/shared/src/decisionCanvas/mcpInstructions.ts"() {
+    "use strict";
+    LACE_MCP_INSTRUCTIONS = `Lace surfaces UI decisions from product reviews. Decisions drive code changes, slideshows, graphics, and prototypes.
+
+Discovery:
+- search_decisions: find decisions by text, canvas, project, app, time, or element. No params = top 20 ranked.
+- list_canvases: browse review canvases to find canvas IDs for filtering.
+- list_projects: browse projects to find project IDs for scoping.
+
+Action:
+- apply_decision: get the implementation kit for a decision. Set include to control detail level (instructions, crop, discussion, all).
+
+Publish:
+- publish_artifact: publish a Vite+React prototype to a shareable canvas link for commenting. Pass source files as [{path, content}]. Returns canvas_id and share_url.
+
+Workflow: search_decisions -> pick a decision -> apply_decision with the desired include level -> build a prototype -> publish_artifact with source files -> share the returned URL for commenting.
+
+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.`;
+  }
+});
+
 // ../../libs/shared/src/decisionCanvas/types.ts
 function isFullPageBbox(target) {
   if (target.bbox_x1 == null || target.bbox_y1 == null || target.bbox_x2 == null || target.bbox_y2 == null) {
@@ -78957,11 +79030,14 @@ function isFullPageBbox(target) {
 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, createUnboundAnnotationInputSchema, FULL_PAGE_EPSILON, canvasBboxCoordinateNullableSchema, enrichAnnotationPatchSchema, enrichAnnotationsBulkInputSchema, 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, canvasBboxCoordinateNullableSchema, optionalIsoDateSchema, createCanvasAnnotationInputSchema, createUnboundAnnotationInputSchema, FULL_PAGE_EPSILON, enrichAnnotationPatchSchema, enrichAnnotationsBulkInputSchema;
 var init_types7 = __esm({
   "../../libs/shared/src/decisionCanvas/types.ts"() {
     "use strict";
     init_zod();
+    init_reviewCommentRunBinding();
+    init_canvasMutations();
+    init_mcpInstructions();
     CANVAS_ANNOTATION_KIND_ELEMENT = "element";
     CANVAS_ANNOTATION_KIND_DECISION = "decision";
     CANVAS_ANNOTATION_KIND_VALUES = [CANVAS_ANNOTATION_KIND_ELEMENT, CANVAS_ANNOTATION_KIND_DECISION];
@@ -78972,6 +79048,7 @@ var init_types7 = __esm({
     uuidSchema = external_exports.string().uuid();
     optionalCanvasTextSchema = external_exports.string().trim().min(1).optional().nullable();
     canvasBboxCoordinateSchema = external_exports.number().min(0).max(1);
+    canvasBboxCoordinateNullableSchema = external_exports.number().min(0).max(1).nullable();
     optionalIsoDateSchema = external_exports.string().trim().min(1).optional().nullable();
     createCanvasAnnotationInputSchema = external_exports.object({
       id: uuidSchema.optional(),
@@ -79008,7 +79085,8 @@ var init_types7 = __esm({
       element_fusion_source: optionalCanvasTextSchema,
       element_content: optionalCanvasTextSchema,
       element_detection_source: optionalCanvasTextSchema,
-      element_value: optionalCanvasTextSchema
+      element_value: optionalCanvasTextSchema,
+      comment_run_binding: reviewCommentRunBindingSchema.optional().nullable()
     }).refine((value) => value.bbox_x1 < value.bbox_x2 && value.bbox_y1 < value.bbox_y2).refine((value) => {
       const status = value.status ?? "suggested";
       if (status === "resolved") return value.resolved_at !== null && value.resolved_at !== void 0;
@@ -79021,8 +79099,8 @@ var init_types7 = __esm({
       comment_lineage_id: uuidSchema.optional(),
       headline: external_exports.string().trim().min(1).max(CANVAS_ANNOTATION_HEADLINE_MAX_LENGTH),
       body: external_exports.string().trim().optional().nullable(),
-      pin_x: canvasBboxCoordinateSchema,
-      pin_y: canvasBboxCoordinateSchema,
+      pin_x: canvasBboxCoordinateNullableSchema,
+      pin_y: canvasBboxCoordinateNullableSchema,
       screenshot_id: external_exports.string().trim().min(1).optional(),
       element_eid: optionalCanvasTextSchema,
       element_tag: optionalCanvasTextSchema,
@@ -79044,12 +79122,14 @@ var init_types7 = __esm({
       sibling_before_tag: optionalCanvasTextSchema,
       sibling_before_text: optionalCanvasTextSchema,
       sibling_after_tag: optionalCanvasTextSchema,
-      sibling_after_text: optionalCanvasTextSchema
+      sibling_after_text: optionalCanvasTextSchema,
+      comment_run_binding: reviewCommentRunBindingSchema.optional().nullable()
     });
     FULL_PAGE_EPSILON = 0.01;
-    canvasBboxCoordinateNullableSchema = external_exports.number().min(0).max(1).nullable();
     enrichAnnotationPatchSchema = external_exports.object({
       id: external_exports.string().uuid(),
+      page_id: external_exports.string().uuid().nullable().optional(),
+      binding_status: external_exports.enum(["pending", "bound"]).optional(),
       element_eid: optionalCanvasTextSchema,
       element_role: optionalCanvasTextSchema,
       element_visible_text: optionalCanvasTextSchema,
@@ -79069,38 +79149,6 @@ var init_types7 = __esm({
     enrichAnnotationsBulkInputSchema = external_exports.object({
       patches: external_exports.array(enrichAnnotationPatchSchema).min(1).max(500)
     });
-    CANVAS_ANNOTATION_CHANGE_EVENT_TYPES = [
-      "annotation-created",
-      "annotation-updated",
-      "annotation-deleted",
-      "annotation-endorsed",
-      "annotation-resolved",
-      "annotation-reopened"
-    ];
-    CANVAS_PAGE_CHANGE_EVENT_TYPES = ["page-added", "page-removed", "page-reordered", "page-updated"];
-    CANVAS_REPLY_CHANGE_EVENT_TYPES = ["reply-created", "reply-updated", "reply-deleted"];
-    CANVAS_THREAD_CHANGE_EVENT_TYPES = ["thread-linked", "thread-unlinked"];
-    CANVAS_CHANGE_EVENT_TYPES = [
-      ...CANVAS_ANNOTATION_CHANGE_EVENT_TYPES,
-      ...CANVAS_PAGE_CHANGE_EVENT_TYPES,
-      ...CANVAS_REPLY_CHANGE_EVENT_TYPES,
-      "canvas-created",
-      "canvas-updated",
-      ...CANVAS_THREAD_CHANGE_EVENT_TYPES
-    ];
-    LACE_MCP_INSTRUCTIONS = `Lace surfaces UI decisions from product reviews. Decisions drive code changes, slideshows, graphics, and prototypes.
-
-Discovery:
-- search_decisions: find decisions by text, canvas, project, app, time, or element. No params = top 20 ranked.
-- list_canvases: browse review canvases to find canvas IDs for filtering.
-- list_projects: browse projects to find project IDs for scoping.
-
-Action:
-- 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 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.`;
   }
 });
 
@@ -79341,7 +79389,7 @@ function serializeDecisionXml(decision) {
   return [
     `<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])} />` : "",
-    decision.pin && !decision.bbox ? `  <pin${attr("x", decision.pin.x)}${attr("y", decision.pin.y)} />` : "",
+    decision.pin ? `  <pin${attr("x", decision.pin.x)}${attr("y", decision.pin.y)} />` : "",
     `  <element${optionalAttr("role", decision.element.role)}${optionalAttr("label", decision.element.label)}${optionalAttr("type", decision.element.type)}${optionalAttr("value", decision.element.value)}>${actionsXml}`,
     "  </element>",
     decision.domContext ? `  <dom-context${optionalAttr("element_tag", decision.domContext.elementTag)}${optionalAttr("parent_tag", decision.domContext.parentTag)}${optionalAttr("parent_text", decision.domContext.parentText)}${optionalAttr("sibling_before_tag", decision.domContext.siblingBeforeTag)}${optionalAttr("sibling_before_text", decision.domContext.siblingBeforeText)}${optionalAttr("sibling_after_tag", decision.domContext.siblingAfterTag)}${optionalAttr("sibling_after_text", decision.domContext.siblingAfterText)} />` : "",
@@ -79442,6 +79490,13 @@ var init_mcpFormat = __esm({
   }
 });
 
+// ../../libs/shared/src/decisionCanvas/pageImageRecovery.ts
+var init_pageImageRecovery = __esm({
+  "../../libs/shared/src/decisionCanvas/pageImageRecovery.ts"() {
+    "use strict";
+  }
+});
+
 // ../../libs/shared/src/decisionCanvas/pagePrimaryImage.ts
 var init_pagePrimaryImage = __esm({
   "../../libs/shared/src/decisionCanvas/pagePrimaryImage.ts"() {
@@ -79458,6 +79513,7 @@ var init_decisionCanvas = __esm({
     init_flow();
     init_interactions();
     init_mcpFormat();
+    init_pageImageRecovery();
     init_pagePrimaryImage();
     init_readModel();
     init_types7();
@@ -79502,26 +79558,8 @@ function isValidBbox(decision) {
   return decision.bbox_x1 != null && decision.bbox_y1 != null && decision.bbox_x2 != null && decision.bbox_y2 != null && [decision.bbox_x1, decision.bbox_y1, decision.bbox_x2, decision.bbox_y2].every(Number.isFinite) && decision.bbox_x1 < decision.bbox_x2 && decision.bbox_y1 < decision.bbox_y2 && // Page-scoped comments are stored as a full-page box; they have no region to crop.
   !isFullPageBbox(decision);
 }
-function placementTimestamp(decision) {
-  const createdAt = Date.parse(decision.created_at);
-  if (Number.isFinite(createdAt)) return createdAt;
-  const resolvedAt = decision.resolved_at ? Date.parse(decision.resolved_at) : Number.NaN;
-  return Number.isFinite(resolvedAt) ? resolvedAt : 0;
-}
-function findHistoricalNonDetachedPlacement(decision, allDecisions) {
-  let newest = null;
-  for (const candidate of allDecisions) {
-    if (candidate.id === decision.id) continue;
-    if (candidate.comment_lineage_id !== decision.comment_lineage_id) continue;
-    if (candidate.anchor_state === "detached") continue;
-    if (!newest || placementTimestamp(candidate) > placementTimestamp(newest)) {
-      newest = candidate;
-    }
-  }
-  return newest;
-}
 function resolveCropSource(detail) {
-  return detail.decision.anchor_state === "detached" ? findHistoricalNonDetachedPlacement(detail.decision, detail.allDecisions) : detail.decision;
+  return detail.decision.anchor_state === "detached" ? null : detail.decision;
 }
 function decisionBbox(decision) {
   if (!isValidBbox(decision)) return null;
@@ -79693,6 +79731,7 @@ function registerListCanvasesTool({ server: server2, loader, getScope, onToolInv
       description: "List review canvases in the current org. Returns title, project, page names, and decision counts per page. Call this when the user mentions a specific design file, screen, or review session by name \u2014 use the returned canvas IDs and titles to scope search_decisions queries.",
       inputSchema: {
         status: external_exports.enum(["active", "archived"]).default("active").optional(),
+        content_type: external_exports.enum(["review", "artifact"]).optional().describe("Filter by canvas content type"),
         projectId: external_exports.string().uuid().optional().describe("Filter by project ID"),
         limit: external_exports.number().int().min(1).max(100).default(50).optional(),
         cursor: external_exports.string().optional()
@@ -79747,11 +79786,64 @@ function registerListProjectsTool({ server: server2, loader, getScope, onToolInv
     }
   );
 }
+function registerPublishArtifactTool({
+  server: server2,
+  loader,
+  getScope,
+  onToolInvoked,
+  onToolError
+}) {
+  if (!loader.publishArtifact) return;
+  const publishArtifact = loader.publishArtifact;
+  server2.registerTool(
+    "publish_artifact",
+    {
+      title: "Publish Artifact",
+      description: "Publish a Vite+React prototype to a shareable Lace canvas link for commenting. Returns canvas_id and share_url in the response content.",
+      inputSchema: {
+        title: external_exports.string().describe("Artifact title"),
+        files: external_exports.array(
+          external_exports.object({
+            path: external_exports.string().describe("File path relative to project root (no leading /, no ..)"),
+            content: external_exports.string().describe("File content as text")
+          })
+        ).describe("Source files (no node_modules). Must include package.json.")
+      },
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
+    },
+    async (params) => {
+      onToolInvoked?.("publish_artifact");
+      try {
+        const result = await publishArtifact({ title: params.title, files: params.files }, loaderScope(getScope()));
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Artifact published successfully.
+
+Canvas ID: ${result.canvasId}
+Share URL: ${result.shareUrl}
+
+Share this link with reviewers. They can comment directly on your prototype.`
+            }
+          ]
+        };
+      } catch (e) {
+        onToolError?.(e, { toolName: "publish_artifact" });
+        return loaderErrorResponse(
+          e,
+          "Failed to publish artifact. Check that your files include a valid package.json and try again."
+        );
+      }
+    }
+  );
+}
 function registerMcpTools(opts) {
   registerSearchDecisionsTool(opts);
   registerApplyDecisionTool(opts);
   registerListCanvasesTool(opts);
   registerListProjectsTool(opts);
+  registerPublishArtifactTool(opts);
 }
 var searchDecisionsSchema;
 var init_mcpToolRegistration = __esm({
@@ -79844,6 +79936,24 @@ async function fetchJson(config4, path) {
   if (!response.ok) throw new DecisionLoaderError(`Request failed (${response.status}: ${response.statusText})`);
   return await response.json();
 }
+async function postJsonOnce(config4, path, body) {
+  const response = await fetch(`${config4.apiBase}${path}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      Authorization: `Bearer ${config4.token}`,
+      "x-org-id": config4.orgId
+    },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(API_ARTIFACT_PUBLISH_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new DecisionLoaderError(`Request failed (${response.status}): ${text || response.statusText}`);
+  }
+  return await response.json();
+}
 function searchParamsFromRecord(query) {
   const params = new URLSearchParams();
   for (const [key, value] of Object.entries(query)) {
@@ -80005,6 +80115,7 @@ function createHttpDecisionLoader() {
       const config4 = requireConfig();
       const params = new URLSearchParams();
       if (query.status) params.set("status", query.status);
+      if (query.content_type) params.set("content_type", query.content_type);
       if (query.projectId) params.set("projectId", query.projectId);
       params.set("limit", String(query.limit ?? 50));
       if (query.cursor) params.set("cursor", query.cursor);
@@ -80016,10 +80127,18 @@ function createHttpDecisionLoader() {
       params.set("limit", String(query.limit ?? 50));
       if (query.cursor) params.set("cursor", query.cursor);
       return fetchJson(config4, `/projects?${params}`);
+    },
+    async publishArtifact(input, _scope) {
+      const result = await postJsonOnce(
+        requireConfig(),
+        "/lace/artifacts/publish",
+        input
+      );
+      return { canvasId: result.canvas_id, shareUrl: result.share_url };
     }
   };
 }
-var API_FETCH_TIMEOUT_MS;
+var API_FETCH_TIMEOUT_MS, API_ARTIFACT_PUBLISH_TIMEOUT_MS;
 var init_decisionLoaderHttp = __esm({
   "src/decisionLoaderHttp.ts"() {
     "use strict";
@@ -80027,6 +80146,7 @@ var init_decisionLoaderHttp = __esm({
     init_mcpDecisionLoader();
     init_auth();
     API_FETCH_TIMEOUT_MS = 3e4;
+    API_ARTIFACT_PUBLISH_TIMEOUT_MS = 12e4;
   }
 });
 

package/package.json

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