drafted 1.14.29 → 1.15.0

package/mcp/server.mjs

@@ -245,7 +245,9 @@ BREADCRUMBS: When a frame you write or read corresponds to a file in the user's
 CONTEXT RULES (follow these before every action):
   - WIKI CHECK: Before acting on any request, search the org wiki for relevant conventions, existing designs, and prior decisions. Use wiki(action="search") with relevant keywords.
   - LAYER CONTEXT: Before reading or mutating a frame, read all anchored frames in the same layer. Anchored frames are per-layer required reading (style guides, design systems, conventions). The server enforces this mechanically for writes/edits/deletes/moves — but proactively reading anchored frames before any frame operation prevents wasted work.
-IMPORTANT: Any URL containing /f/{uuid} is a Drafted frame link — ALWAYS use read(path=URL) to get frame content, focus(target=URL) to pan the canvas to it. Never curl or WebFetch Drafted URLs.`,
+IMPORTANT: Any URL containing /f/{uuid} is a Drafted frame link — ALWAYS use read(path=URL) to get frame content, focus(target=URL) to pan the canvas to it. Never curl or WebFetch Drafted URLs.
+
+LINKING: link the user to the narrowest thing you touched, never the project as a stand-in. Wrote or edited ONE frame → give its \`frameUrl\` (from the write/read/ls response). Touched a whole lane → its \`laneUrl\`; a whole layer → its \`layerUrl\` (both on the matching \`ls\` entries). Only when the work spans the project is the project URL the right link. A project link where a frame link was available makes the user hunt the surface for what you just did.`,
 }, {
   // Initialize instructions: the agent-identity contract, so an agent learns its own
   // tab name + the right way to read it WITHOUT having to "think to" call a tool.
@@ -1260,6 +1262,10 @@ function withFrameBreadcrumb(result, { hint = false } = {}) {
   const out = { ...result, breadcrumb: `drafted:${result.id}` };
   if (hint) {
     out.breadcrumbHint = `If this frame maps to a file in the user's codebase, paste "drafted:${result.id}" as a comment in that file so future agents discover the link.`;
+    // The write path is where the project URL keeps getting substituted for the frame
+    // the agent just wrote. Name the right link at the moment it's produced.
+    const link = out.frameUrl || `${getServerUrl()}/f/${result.id}`;
+    out.linkHint = `Link the user to THIS frame — ${link} — not to the project URL.`;
   }
   return out;
 }
@@ -2953,8 +2959,9 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
     lineHash: z.string().describe('The full line anchor copied verbatim from read output — line number + 3-char hash, e.g. "182vix" (the token left of the "|"). NOT the bare hash "vix": that is rejected, since the same hash can recur on multiple lines.'),
     newContent: z.string().optional().describe('New content (for replace, insertAfter, insertBefore)'),
   })).optional().describe('[edit] hashline edit operations'),
-  from: z.string().optional().describe('[mv] source path /{layer}/{lane}/{filename}'),
-  to: z.string().optional().describe('[mv] destination path /{layer}/{lane}/{filename}'),
+  from: z.string().optional().describe('[mv] source path: /{layer}/{lane}/{filename} for a frame, /{layer}/{lane} for a lane, /{layer} for a whole layer (lane/layer require toProjectId)'),
+  to: z.string().optional().describe('[mv] destination path /{layer}/{lane}/{filename} — the layer segment is always required and explicit'),
+  toProjectId: z.string().optional().describe('[mv] move ACROSS projects: destination project UUID/slug/name. Same-org only. Frame ids and version history follow; frame-scoped shares, public links, and lane share tokens are NOT carried into the destination project. Omit for the classic in-project rename/move.'),
   dryRun: z.boolean().optional().describe('[mv] preview the move without applying it; returns the resolved frame and current path so you can confirm before retrying with dryRun=false.'),
   anchored: z.boolean().optional().describe('[anchor] true to anchor, false to unanchor. Anchored frames MUST be read before writing/editing in the same layer.'),
   query: z.string().optional().describe('[search] term to match against frame names'),
@@ -3314,7 +3321,7 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
         });
       }
       case 'mv': {
-        const { from, to, dryRun = false } = args;
+        const { from, to, toProjectId, dryRun = false } = args;
         if (!from || !to) throw new Error('from and to required for action=mv');
         if (dryRun) {
           // Resolve current frame at `from`. Don't apply the rename, just
@@ -3324,11 +3331,12 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
             dryRun: true,
             from,
             to,
+            toProjectId: toProjectId || undefined,
             currentFrame: current?.frame || current,
-            note: 'No changes applied. Re-call with dryRun=false (or omit) to perform the rename.',
+            note: 'No changes applied. Re-call with dryRun=false (or omit) to perform the move.',
           }));
         }
-        return ok(withProject(await api('POST', '/api/fs/mv', { from, to })));
+        return ok(withProject(await api('POST', '/api/fs/mv', { from, to, ...(toProjectId ? { toProjectId } : {}) })));
       }
       case 'anchor': {
         const { path, anchored } = args;
@@ -3398,7 +3406,7 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
 
 tool('ls', 'List contents of the ACTIVE PROJECT. Use ls / after project(action="open") to see layers, workflow, and confirm you\'re in the right project.', {
   projectId: PROJECT_OVERRIDE_PARAM,
-  path: z.string().optional().default('/').describe('Directory path: / (layers), /{layer} (lanes), /{layer}/{lane} (frames). Frame entries include frameUrl (canvas deep link) and id (frame UUID).'),
+  path: z.string().optional().default('/').describe('Directory path: / (layers), /{layer} (lanes), /{layer}/{lane} (frames). Frame entries include frameUrl (canvas deep link) and id (frame UUID); layer entries include layerUrl and lane entries laneUrl — relay those to the user instead of the project URL when your work was scoped to one layer or lane.'),
   recursive: z.boolean().optional().describe('List contents of subdirectories. When true, forces summary mode (metadata only, no full content) to keep results under the 25k token cap.'),
   summary: z.boolean().optional().describe('Include size, updatedAt, title for frames'),
   pattern: z.string().optional().describe('Glob pattern to filter filenames (e.g. "*.html")'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.14.29",
+  "version": "1.15.0",
   "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": [