drafted 1.14.9 → 1.14.10

package/mcp/server.mjs

@@ -1078,6 +1078,15 @@ function shapeSkillCatalog(result, { limit, offset = 0, compact = false } = {})
   return result;
 }
 
+// Semantic frame URL (/o/<org>/<project>/<layer>/<lane>/<label>) from a row that
+// carries slugs (e.g. /api/search hits). Returns null when a slug is missing so the
+// caller can fall back to the /f/<uuid> resolver.
+function semanticFrameUrl({ orgSlug, projectSlug, layer, lane, label }) {
+  if (!orgSlug || !projectSlug || !label) return null;
+  const e = encodeURIComponent;
+  return `${getServerUrl()}/o/${e(orgSlug)}/${e(projectSlug)}/${e(layer || 'designs')}/${e(lane || 'default')}/${e(label)}`;
+}
+
 // Build the structuredContent shape that the frame-preview widget reads.
 // Tools that produce or return a frame (read/write/edit) call this so the
 // model and widget see the same metadata view.
@@ -1093,7 +1102,9 @@ function frameStructuredContent(result, project = null) {
     lane: result.lane,
     width: result.width,
     height: result.height,
-    frameUrl: result.id ? `${getServerUrl()}/f/${result.id}` : undefined,
+    // Server emits the semantic /o/<org>/<project>/<layer>/... URL; /f/<uuid> is the
+    // fallback (still resolved + redirected server-side).
+    frameUrl: result.frameUrl || (result.id ? `${getServerUrl()}/f/${result.id}` : undefined),
     project, // {id, slug, name, orgId} of the active project — visible in client UI
   };
 }
@@ -1880,17 +1891,21 @@ tool('project', 'START HERE for project management. Dispatch by `action`: list (
         joinAgentWsRoom(projectId);
         const base = getServerUrl();
         let projectSlug = projectId;
-        let projectMeta = { id: projectId, slug: null, name: null, orgId: null };
+        let orgSlug = null;
+        let projectMeta = { id: projectId, slug: null, name: null, orgId: null, orgSlug: null };
         try {
           const data = await api('GET', '/api/projects');
           const proj = (data.projects || []).find(p => p.id === projectId);
           if (proj) {
             projectSlug = proj.slug || projectId;
-            projectMeta = { id: proj.id, slug: proj.slug || null, name: proj.name || null, orgId: proj.orgId || null };
+            orgSlug = proj.orgSlug || null;
+            projectMeta = { id: proj.id, slug: proj.slug || null, name: proj.name || null, orgId: proj.orgId || null, orgSlug };
           }
         } catch { /* fall back to projectId */ }
         setMcpActiveProject(projectId, projectMeta);
-        const url = `${base}/project/${projectSlug}`;
+        // Semantic /o/<org-slug>/<project-slug> when the org slug is known; otherwise
+        // the /project/<slug> resolver redirects to it.
+        const url = orgSlug ? `${base}/o/${encodeURIComponent(orgSlug)}/${encodeURIComponent(projectSlug)}` : `${base}/project/${projectSlug}`;
         // Surfacing to the user is the focus mechanism's job now (agent-active ping ->
         // desktop window / notification+glow for browser tabs) — this used to also force
         // `exec('open <url>')` on the MCP host machine, an unsolicited GUI action that both
@@ -3039,7 +3054,7 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
             path: `/${r.layer}/${r.lane}/${r.label}`,
             project: r.projectName,
             projectId: r.projectId,
-            frameUrl: `${getServerUrl()}/f/${r.id}`,
+            frameUrl: semanticFrameUrl(r) || `${getServerUrl()}/f/${r.id}`,
             contentType: r.contentType,
             updatedAt: r.updatedAt,
           })),
@@ -3112,7 +3127,11 @@ tool('ls', 'List contents of the ACTIVE PROJECT. Use ls / after project(action="
     const projectId = getState().projectId;
     const structuredContent = {
       project: result?.project || result?.projectName,
-      canvasUrl: result?.projectSlug ? `${getServerUrl()}/project/${result.projectSlug}` : undefined,
+      canvasUrl: result?.project?.slug
+        ? (result.project.orgSlug
+            ? `${getServerUrl()}/o/${encodeURIComponent(result.project.orgSlug)}/${encodeURIComponent(result.project.slug)}`
+            : `${getServerUrl()}/project/${encodeURIComponent(result.project.slug)}`)
+        : undefined,
       byLayer,
       truncated: result?.truncated || false,
       totalAvailable: result?.totalAvailable,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.14.9",
+  "version": "1.14.10",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [