drafted 1.11.1 → 1.11.3

package/mcp/server.mjs

@@ -567,12 +567,13 @@ function reportMcpToolError(tool, error) {
 
 function wikiPageUrl(path = '', org = '') {
   const normalized = normalizeWikiPath(path || '');
-  // Org-qualify so the link resolves to this org's wiki regardless of the
-  // viewer's current active org (wiki paths collide across orgs). The /wiki
-  // route resolves ?org id-first then slug.
-  const q = org ? `?org=${encodeURIComponent(org)}` : '';
-  if (!normalized) return `${getServerUrl()}/wiki${q}`;
-  return `${getServerUrl()}/wiki/${normalized.split('/').map(encodeURIComponent).join('/')}${q}`;
+  // Canonical org-scoped URL: /o/<org>/wiki/<path>. Portable across the viewer's
+  // orgs (wiki paths collide across orgs). `org` is the org id; the
+  // /o/<org>/wiki route resolves it id-first then slug. Falls back to bare /wiki
+  // (which 302s to the canonical form) when org is unknown.
+  const base = org ? `${getServerUrl()}/o/${encodeURIComponent(org)}/wiki` : `${getServerUrl()}/wiki`;
+  if (!normalized) return base;
+  return `${base}/${normalized.split('/').map(encodeURIComponent).join('/')}`;
 }
 
 function getBootstrapSessionId() {
@@ -1902,7 +1903,7 @@ tool('get_org', {
 // ── Filesystem tools (direct HTTP to /api/fs) ─────────────────────
 
 tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by path, frame URL, or UUID), write (new frame or overwrite), Google Sheet actions (`get_sheet`, `read_sheet_values`, `write_sheet_values`, `append_sheet_rows`, `clear_sheet_range`, `update_sheet`), Google Doc actions (`get_doc`, `read_doc_content`, `write_doc_content`, `append_doc_content`, `clear_doc_content`, `update_doc`), Google Slide actions (`get_slide`, `read_slide_content`, `write_slide_content`, `append_slides`, `clear_slides`, `update_slide`), write_excalidraw (native editable Excalidraw diagram), edit (hashline ops), mv (rename/move), anchor (mark as required-read for the layer), search (match frame names). Use project(action="open") first. For listing use `ls`, for deletion use `rm`.\n\n**Google Workspace native content:** Create or attach Google Docs/Sheets/Slides with `frame(action="write", googleType=...)`. After creating, immediately populate the native file using the matching write action in the same tool — do NOT leave it empty and do NOT tell the user you cannot write to it. For Sheets: `write_sheet_values` or `append_sheet_rows` (pass `path` or `googleId` from the create response). For Docs: `write_doc_content`/`append_doc_content`. For Slides: `write_slide_content`/`append_slides`. Read with `read_sheet_values`/`read_doc_content`/`read_slide_content`. Do NOT use inline `frame.write(content)` or hashline `frame.edit` to populate Google Workspace frames.\n\n**Write — content, binary, or Google Workspace frame:** ' + (isRemote ? 'Provide exactly one of `content` (HTML/markdown/text), `base64` (base64-encoded binary with optional `content_type`), or `googleType` (`google-doc`, `google-sheet`, `google-slide`).' : 'Provide exactly one of `content` (HTML/markdown/text), `file_path` (absolute local file), `base64` (base64-encoded binary with optional `content_type`), or `googleType` (`google-doc`, `google-sheet`, `google-slide`).') + ' Call get_org first; when `googleDrive.connected` is true, strongly prefer Google Workspace frames for docs, sheets, and slides in that org. For inline content, filename extension matters: use `.html` for complete HTML documents and `.md` for Markdown. Never place a full HTML document in a `.md` or extensionless frame. For a new Google file, pass `googleType` and optional `title`; for an existing Google file, pass `googleType` plus `url` or `googleId`. ' + (isRemote ? 'For binary frames (images, PDFs, videos), pass `base64` with the binary bytes.' : 'For binary frames (images, PDFs, videos), use `file_path` when the file is local to the MCP host, or `base64` when the caller already has binary bytes.') + '\n\n**Write — dimensions:** By default, frames use the layer\'s default size (e.g. 1440×900 for designs, 1440×3000 for wireframes). Often too large for small content. Use `autoSize: true` to measure HTML content and size to fit, or pass explicit `width`/`height`.', {
-  action: z.enum(['read', 'write', 'write_sheet_values', 'read_sheet_values', 'append_sheet_rows', 'clear_sheet_range', 'get_sheet', 'update_sheet', 'get_doc', 'read_doc_content', 'write_doc_content', 'append_doc_content', 'clear_doc_content', 'update_doc', 'get_slide', 'read_slide_content', 'write_slide_content', 'append_slides', 'clear_slides', 'update_slide', 'write_excalidraw', 'edit', 'mv', 'anchor', 'search', 'versions', 'read_version', 'restore_version']).describe('Operation to perform. Use native Doc/Slide actions for Google Docs/Slides; do not use inline write/edit for native Workspace content.'),
+  action: z.enum(['read', 'write', 'write_sheet_values', 'read_sheet_values', 'append_sheet_rows', 'clear_sheet_range', 'get_sheet', 'update_sheet', 'get_doc', 'read_doc_content', 'write_doc_content', 'append_doc_content', 'clear_doc_content', 'update_doc', 'get_slide', 'read_slide_content', 'write_slide_content', 'append_slides', 'clear_slides', 'update_slide', 'create_office', 'read_office', 'edit_office', 'write_excalidraw', 'edit', 'mv', 'anchor', 'search', 'versions', 'read_version', 'restore_version']).describe('Operation to perform. Use native Doc/Slide actions for Google Docs/Slides; do not use inline write/edit for native Workspace content.'),
   path: z.string().optional().describe('[read] /{layer}/{lane}/{filename}, frame URL, or UUID. [write|edit|anchor] /{layer}/{lane}/{filename}.'),
   lines: z.string().optional().describe('[read] line range (e.g. "1-50"). Omit to read all.'),
   content: z.string().optional().describe('[write] HTML/markdown/text for Drafted inline frames. [write_doc_content|append_doc_content] native Google Doc body text. Do not use action=write content to populate Google Doc/Slide frames.'),
@@ -1915,6 +1916,24 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
   title: z.string().optional().describe('[write + googleType] Title for a new native file. Defaults to filename from path.'),
   url: z.string().optional().describe('[write + googleType] Existing Google file URL to attach.'),
   googleId: z.string().optional().describe('[write + googleType] Existing Google file ID to attach. [Sheet/Doc/Slide actions] Native Google file ID to use when not resolving from path/frame.'),
+  officeType: z.enum(['xlsx']).optional().describe('[create_office] native Drafted-owned Office format to author. Currently xlsx (real .xlsx bytes — download is the file itself, no conversion).'),
+  rows: z.array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()]))).optional().describe('[create_office] initial rows for a single-sheet xlsx (2D array of cell values).'),
+  sheets: z.array(z.object({ name: z.string().optional(), rows: z.array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()]))).optional() })).optional().describe('[create_office] multiple sheets: [{ name, rows }].'),
+  sheet: z.string().optional().describe('[read_office] limit the read to one sheet by name.'),
+  maxCells: z.number().optional().describe('[read_office] cap non-empty cells returned (default 5000).'),
+  ops: z.array(z.object({
+    type: z.string(),
+    sheet: z.string().optional(),
+    ref: z.string().optional(),
+    value: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),
+    formula: z.string().optional(),
+    cells: z.array(z.object({ ref: z.string(), value: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(), formula: z.string().optional() })).optional(),
+    range: z.string().optional(),
+    name: z.string().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    rows: z.array(z.array(z.union([z.string(), z.number(), z.boolean(), z.null()]))).optional(),
+  })).optional().describe('[edit_office] xlsx edit ops (resolved against stable cell/sheet addresses): {type:"setCell",sheet?,ref,value|formula} | {type:"setCells",sheet?,cells:[{ref,value|formula}]} | {type:"clearRange",sheet?,range} | {type:"addSheet",name,rows?} | {type:"renameSheet",from,to} | {type:"deleteSheet",name}.'),
   format: z.enum(['plain_text', 'markdown']).optional().describe('[write_doc_content|append_doc_content] Source format hint. Currently plain_text and minimal markdown are accepted as text.'),
   mode: z.enum(['replace', 'append', 'clear']).optional().describe('[Doc/Slide content actions] Optional mode hint for clients; prefer the explicit write/append/clear action names.'),
   slides: z.array(z.object({
@@ -1991,6 +2010,19 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
       }
       return body;
     };
+    // Resolve a frame path / URL / UUID to a frame id for the native Office routes.
+    const resolveOfficeFrameId = async (path) => {
+      if (!path) throw new Error('Provide path to an office frame, frame URL, or frame ID');
+      const frameUrlMatch = path.match(/\/f\/([a-f0-9-]{36})/);
+      const uuidMatch = path.match(/^[a-f0-9-]{36}$/);
+      if (frameUrlMatch?.[1] || uuidMatch) return frameUrlMatch?.[1] || path;
+      const parts = path.replace(/^\/+/, '').split('/');
+      if (parts.length !== 3) throw new Error('Path must be /{layer}/{lane}/{filename}, a frame URL, or a frame ID');
+      const frame = await api('GET', `/api/fs/${parts[0]}/${parts[1]}/${parts[2]}`);
+      const id = frame?.id || frame?.frame?.id;
+      if (!id) throw new Error('Office frame not found for path');
+      return id;
+    };
     switch (action) {
       case 'read': {
         const { path, lines } = args;
@@ -2132,6 +2164,32 @@ tool('frame', 'Frame CRUD in the ACTIVE PROJECT. Dispatch by `action`: read (by
         const result = await api('POST', endpoint, body);
         return ok(withProject(result));
       }
+      case 'create_office': {
+        // Author a native Drafted-owned Office file (real bytes; download is the
+        // file itself). Populate via edit_office; read structure via read_office.
+        const { path, title, officeType = 'xlsx', rows, sheets } = args;
+        let layer = 'copy';
+        let lane = 'default';
+        let label = title;
+        if (path) {
+          const p = path.replace(/^\/+/, '').split('/');
+          if (p.length === 3) { layer = p[0]; lane = p[1]; label = p[2]; }
+        }
+        if (!label) throw new Error('Provide title (filename) or a /{layer}/{lane}/{filename} path for the new office file');
+        return ok(await api('POST', '/api/office/create', { projectId: getState().projectId, layer, lane, label, format: officeType, rows, sheets }));
+      }
+      case 'read_office': {
+        const id = await resolveOfficeFrameId(args.path);
+        const q = [];
+        if (args.sheet) q.push('sheet=' + encodeURIComponent(args.sheet));
+        if (args.maxCells) q.push('maxCells=' + Number(args.maxCells));
+        return ok(await api('GET', `/api/office/${id}${q.length ? '?' + q.join('&') : ''}`));
+      }
+      case 'edit_office': {
+        if (!Array.isArray(args.ops) || !args.ops.length) throw new Error('ops (non-empty array) required for action=edit_office');
+        const id = await resolveOfficeFrameId(args.path);
+        return ok(await api('POST', `/api/office/${id}/edit`, { ops: args.ops }));
+      }
       case 'write': {
         const { path, content, file_path, base64, content_type, autoSize, width, height, color, googleType, title, url, googleId } = args;
         if (!path) throw new Error('path required for action=write');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.11.1",
+  "version": "1.11.3",
   "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": [
@@ -54,6 +54,7 @@
     "dotenv": "^17.3.1",
     "drizzle-orm": "^0.45.1",
     "esbuild": "^0.28.0",
+    "exceljs": "^4.4.0",
     "express": "^4.18.2",
     "jsdom": "^27.0.1",
     "lucide": "^1.16.0",