rootr-cli 0.14.1 → 0.17.0

package/lib/credentials.js

@@ -27,16 +27,22 @@ export function candidateClients(cfg = loadConfig()) {
 }
 
 /**
- * Collect every workspace the registered keys can see, and (when asked) which
- * of them a key can actually open — listing is not a capability probe: a
- * workspace key lists all of its owner's workspaces while being rejected by
- * every one but its own.
+ * Collect every workspace the registered keys can see, and which of them a
+ * key can actually open — listing is not a capability probe: a workspace key
+ * lists all of its owner's workspaces while being rejected by every one but
+ * its own. `GET /workspaces` now tags each entry with `accessible` (computed
+ * server-side from the calling key's own scope), so this reads straight off
+ * that field instead of firing one extra request per workspace. Older
+ * servers that predate the field fall back to the old per-workspace probe
+ * when `probe` is requested.
  */
 export async function surveyWorkspaces(candidates, { probe = false, probeLimit = 12 } = {}) {
   const seen = new Map();
   const reachable = new Set();
   let listed = 0;
   let failures = 0;
+  let sawAccessibleField = false;
+  const lists = [];
   for (const { client } of candidates) {
     let list = [];
     try {
@@ -46,19 +52,29 @@ export async function surveyWorkspaces(candidates, { probe = false, probeLimit =
       failures += 1;
       continue; // a revoked/foreign key shouldn't hide the others
     }
-    for (const w of list) if (!seen.has(w.id)) seen.set(w.id, w);
-    if (!probe) continue;
-    for (const w of list.slice(0, probeLimit)) {
-      if (reachable.has(w.id)) continue;
-      try {
-        await client.request(`/workspaces/${encodeURIComponent(w.id)}`);
-        reachable.add(w.id);
-      } catch {
-        // scoped key rejected here; another key may still cover it
+    lists.push({ client, list });
+    for (const w of list) {
+      if (!seen.has(w.id)) seen.set(w.id, w);
+      if (typeof w.accessible === 'boolean') {
+        sawAccessibleField = true;
+        if (w.accessible) reachable.add(w.id);
+      }
+    }
+  }
+  if (!sawAccessibleField && probe) {
+    for (const { client, list } of lists) {
+      for (const w of list.slice(0, probeLimit)) {
+        if (reachable.has(w.id)) continue;
+        try {
+          await client.request(`/workspaces/${encodeURIComponent(w.id)}`);
+          reachable.add(w.id);
+        } catch {
+          // scoped key rejected here; another key may still cover it
+        }
       }
     }
   }
-  return { workspaces: [...seen.values()], reachable, listed, failures };
+  return { workspaces: [...seen.values()], reachable, listed, failures, probed: sawAccessibleField || probe };
 }
 
 /**

package/lib/mcp-tools/crm.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 /**
  * Shared context repeated (shortened) across tool descriptions so an agent
@@ -56,7 +56,9 @@ export function registerCrmTools(server) {
         'activities and tasks all live inside it. Optionally seed custom `pipelines` (name + ordered stages, each ' +
         'with an optional win probability/color) and/or custom company/contact/deal `fields`; sane defaults are ' +
         'used if omitted. ' +
-        CRM_CONTEXT,
+        CRM_CONTEXT +
+        ' ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('CRM node name'),

package/lib/mcp-tools/databases.js

@@ -8,6 +8,7 @@ import {
   resolveNodeId,
   resolveOptionalNodeId,
   NODE_TARGET_HINT,
+  NODE_URL_HINT,
 } from './shared.js';
 
 /** Human text for the `databaseId` param — accepts a path just like the document tools. */
@@ -135,7 +136,12 @@ export function registerDatabaseTools(server) {
         'Views default to a single table view; view types are table | board | gallery | calendar | timeline | list — ' +
         'a "board" view needs config.groupBy (a select/status property id), a "timeline"/"calendar" view needs ' +
         'config.dateProp. Row `values` are keyed by column NAME (or id); date values are ' +
-        '{ start: "YYYY-MM-DDTHH:mm" or "YYYY-MM-DD", end? }, multi_select is string[], relation is an array of row ids.',
+        '{ start: "YYYY-MM-DDTHH:mm" or "YYYY-MM-DD", end? }, multi_select is string[], relation is an array of row ids. ' +
+        'COST NOTE: by default, every row added to this table (now or later) queues that table for graph extraction ' +
+        '(embeddings + LLM) — fine for a handful of rows, expensive for a bulk-loaded roster/log table. Pass ' +
+        'graphSync:false for tables you are about to bulk-load; flip it back with ' +
+        '`rootr_update_node({ graphSyncOff: true|false })` any time after. ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().describe('Table name, e.g. "업무 목록"'),
@@ -215,10 +221,18 @@ export function registerDatabaseTools(server) {
             'calculation sheet, "FORM" a per-row intake. Default "DOCUMENT". This is only the default — a single ' +
             'row can be made something else with rootr_create_row_page.',
         ),
+        graphSync: z
+          .boolean()
+          .optional()
+          .describe(
+            'Default true. Set to false for tables you will bulk-load (rosters, logs, imports) — otherwise ' +
+              'every row added queues this table for graph extraction (embeddings + LLM), one job per row. ' +
+              'Flip it later with rootr_update_node({ graphSyncOff: true|false }).',
+          ),
         workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config if omitted'),
       },
     },
-    async ({ name, parentId, path, createParents, icon, properties, views, rows, rowPageType, workspace }) => {
+    async ({ name, parentId, path, createParents, icon, properties, views, rows, rowPageType, graphSync, workspace }) => {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
@@ -233,6 +247,7 @@ export function registerDatabaseTools(server) {
           views,
           rows,
           rowPageType,
+          graphSync,
         });
         return jsonResult(database);
       } catch (err) {
@@ -271,9 +286,17 @@ export function registerDatabaseTools(server) {
             'Column widths in px for this view, keyed by column NAME or id — e.g. {"공고명": 420}. ' +
               '40~1200. Use it when a column holds long text and is being cut off. {} resets every column to auto.',
           ),
+        calendarScale: z
+          .enum(['week', 'month', 'year'])
+          .optional()
+          .describe(
+            'calendar view only: which span the calendar opens on — week / month / year. ' +
+              'Default month. The year view shows twelve mini-months at once (darker = more rows that day). ' +
+              'Saved on the view, so everyone who opens it sees that span.',
+          ),
       },
     },
-    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths }) => {
+    async ({ databaseId, name, type, groupBy, dateProp, endDateProp, filters, sort, colWidths, calendarScale }) => {
       try {
         const client = makeClient();
         const id = await resolveNodeId(client, databaseId);
@@ -286,6 +309,7 @@ export function registerDatabaseTools(server) {
           filters,
           sort,
           colWidths,
+          calendarScale,
         });
         return jsonResult(view);
       } catch (err) {
@@ -350,6 +374,14 @@ export function registerDatabaseTools(server) {
             'Column widths in px for this view, keyed by column NAME or id — e.g. {"공고명": 420}. ' +
               '40~1200. Use it when a column holds long text and is being cut off. {} resets every column to auto.',
           ),
+        calendarScale: z
+          .enum(['week', 'month', 'year'])
+          .optional()
+          .describe(
+            'calendar view only: which span the calendar opens on — week / month / year. ' +
+              'Default month. The year view shows twelve mini-months at once (darker = more rows that day). ' +
+              'Saved on the view, so everyone who opens it sees that span.',
+          ),
       },
     },
     async ({
@@ -363,6 +395,7 @@ export function registerDatabaseTools(server) {
       filters,
       sort,
       colWidths,
+      calendarScale,
     }) => {
       try {
         const client = makeClient();
@@ -376,6 +409,7 @@ export function registerDatabaseTools(server) {
           filters,
           sort,
           colWidths,
+          calendarScale,
         });
         return jsonResult({ view });
       } catch (err) {
@@ -1048,4 +1082,113 @@ export function registerDatabaseTools(server) {
       }
     },
   );
+
+  // ── DB-BUTTON — 표 위에 두는 "누르면 일하는 버튼" ──────────────────────────
+  //
+  // 사람은 화면에서 버튼을 만들 수 있는데 에이전트는 못 만들면, "이 표에 접수 버튼
+  // 하나 달아 줘"에서 멈춘다. 만들 수 있으면 눌러 줄 수도 있어야 한다.
+
+  server.registerTool(
+    'rootr_list_database_buttons',
+    {
+      title: 'List the action buttons on a database',
+      description:
+        'List the action buttons pinned to the top of a Rootr (루터) DATABASE. Each button is a named, ' +
+        'ordered list of steps (add a row / set values / let AI fill a cell / open the new row) that runs ' +
+        'when someone presses it — the repeated setup a table owner would otherwise do by hand every time. ' +
+        'Returns `myLevel` too: editing the buttons needs MANAGE, pressing one only needs WRITE.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+      },
+    },
+    async ({ databaseId }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.listDatabaseButtons(id));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_set_database_buttons',
+    {
+      title: 'Create or edit the action buttons on a database',
+      description:
+        'Replace the WHOLE button list of a Rootr (루터) DATABASE (needs MANAGE). This is a full replace, not a ' +
+        'merge — call rootr_list_database_buttons first and send back the buttons you want to KEEP, or they are ' +
+        'dropped. Up to 12 buttons, 8 steps each.\n' +
+        'Steps run in order and the row a step created is what the NEXT step works on, which is how ' +
+        '"add a row → have AI write its summary → open it" becomes one press:\n' +
+        '· {kind:"add_row", values?} — make a row, optionally pre-filled. Column keys may be NAMES or ids.\n' +
+        '· {kind:"update_rows", target:"created"|"selected", values} — set values on the rows this button just ' +
+        'made, or on the rows the person ticked in the table.\n' +
+        '· {kind:"ai_fill", target, propId, prompt} — let AI write ONE cell. The prompt may quote the row with ' +
+        '{칸이름}, e.g. "{제목}과 {메모}를 한 문장으로 요약해". If the AI fails the button keeps going.\n' +
+        '· {kind:"open_row"} — open the row this button made (UI only; over the API it just reports the id).\n' +
+        'Values accept @today, @today+7 and @me — the server fills them in at press time, not now.\n' +
+        'A button never grants permission: it runs as whoever presses it.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        buttons: z
+          .array(
+            z.object({
+              id: z.string().optional().describe('Keep an existing button by passing its id; omit to create one'),
+              label: z.string().describe('Button text, e.g. "접수"'),
+              icon: z.string().optional().describe('One emoji shown on the button'),
+              steps: z
+                .array(z.record(z.any()))
+                .describe('Ordered steps — see the tool description for each kind (max 8)'),
+            }),
+          )
+          .describe('The COMPLETE button list for this table. [] removes every button.'),
+      },
+    },
+    async ({ databaseId, buttons }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.setDatabaseButtons(id, buttons));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_run_database_button',
+    {
+      title: 'Press an action button on a database',
+      description:
+        'Press one button on a Rootr (루터) DATABASE and run its steps in order (needs WRITE). ' +
+        'Pass `rowIds` only when a step targets "selected" — that is the set of rows the person would have ' +
+        'ticked in the table; without it such a step reaches no rows and the server says so. ' +
+        'Returns `created` (the ARRAY of row ids it made, not a count), `updated` and `filled` counts, the ' +
+        '`openRowId` a final "open_row" step points at, and — if the AI could not write a cell — `aiFailed` ' +
+        'with the reason (the rest of the button still ran). ' +
+        'It runs with YOUR permissions: a button that writes a locked column stops there if you cannot edit it.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        databaseId: z.string().describe(DATABASE_TARGET_DESC),
+        buttonId: z.string().describe('Button id from rootr_list_database_buttons'),
+        rowIds: z
+          .array(z.string())
+          .optional()
+          .describe('Rows for steps whose target is "selected". Omit for buttons that only add rows.'),
+      },
+    },
+    async ({ databaseId, buttonId, rowIds }) => {
+      try {
+        const client = makeClient();
+        const id = await resolveNodeId(client, databaseId);
+        return jsonResult(await client.runDatabaseButton(id, buttonId, { rowIds }));
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
 }

package/lib/mcp-tools/documents.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 
 import { RootrApiError } from '../client.js';
 import { resolveTarget, requireResolved, resolveMoveDestination } from '../resolve.js';
-import { textResult, jsonResult, errorResult, makeClient, NODE_TARGET_HINT } from './shared.js';
+import { textResult, jsonResult, errorResult, makeClient, NODE_TARGET_HINT, NODE_URL_HINT } from './shared.js';
 
 /** Registers the original 6 document tools: list/read/append/edit/write/search. */
 export function registerDocumentTools(server) {
@@ -147,7 +147,8 @@ export function registerDocumentTools(server) {
       description:
         'Replace the ENTIRE content of a Rootr document, or create a new document at a path if it does not exist. ' +
         'This is DESTRUCTIVE — it discards whatever is currently there. Read the document first and pass its etag ' +
-        'as ifMatch to avoid clobbering concurrent changes. Prefer rootr_append or rootr_edit for incremental changes.',
+        'as ifMatch to avoid clobbering concurrent changes. Prefer rootr_append or rootr_edit for incremental changes. ' +
+        `When this creates a new document, the result text includes its address (same idea as: ${NODE_URL_HINT}).`,
       annotations: { readOnlyHint: false, destructiveHint: true },
       inputSchema: {
         target: z.string().describe('Document path (starting with "/", created if missing) or node id, or a full rootr.io URL'),
@@ -174,7 +175,8 @@ export function registerDocumentTools(server) {
             content,
           });
           const id = created.id || (created.node && created.node.id);
-          return textResult(`created ${resolved.path} (id ${id})`);
+          const url = created.url || (created.node && created.node.url);
+          return textResult(`created ${resolved.path} (id ${id})${url ? ` — ${url}` : ''}`);
         }
         const { etag } = await client.putDocument(resolved.id, content, { ifMatch });
         return textResult(`wrote (etag ${etag || 'n/a'})`);
@@ -194,11 +196,17 @@ export function registerDocumentTools(server) {
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         query: z.string().describe('Search query text'),
+        // rootr_list와 같은 이유로 필요하다: 이것만 안 받으면 다중 워크스페이스
+        // 연결에서 정체 모를 오류가 난다(#99).
+        workspace: z
+          .string()
+          .optional()
+          .describe('Workspace id; defaults to ROOTR_WORKSPACE/config'),
       },
     },
-    async ({ query }) => {
+    async ({ query, workspace }) => {
       try {
-        const client = makeClient();
+        const client = makeClient(workspace);
         const results = await client.search(query);
         const rows = results.map((r) => {
           const label = r.path || r.name || r.nodeId;
@@ -218,13 +226,19 @@ export function registerDocumentTools(server) {
       title: 'Comment on a Rootr document',
       description:
         'Add a comment to a Rootr (루터) document (optionally anchored to a block, or as a reply via parentId). ' +
+        'DB-ROW-COMMENT — to comment on a **row of a table**, pass the DATABASE as `target` and the ROW id as `blockId`; that is exactly what the row screen does, and the row will show it above its body. ' +
+        'Mentioning someone with @[userId] notifies them, and their notification opens that row and ' +
+        'highlights this comment. ' +
         'Comments carry a user identity: the comment is attributed to the person who owns the key ' +
         '(account keys and workspace keys both carry an owner). A key with no owner cannot comment.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         target: z.string().describe('Document path (starting with "/") or node id, or a full rootr.io URL'),
         body: z.string().describe('Comment text (markdown)'),
-        blockId: z.string().optional().describe('Block id to anchor the comment to'),
+        blockId: z
+          .string()
+          .optional()
+          .describe('Block id to anchor the comment to — or a DATABASE ROW id to comment on that row'),
         parentId: z.string().optional().describe('Parent comment id, to reply in a thread'),
       },
     },
@@ -244,11 +258,16 @@ export function registerDocumentTools(server) {
     {
       title: 'List comments on a Rootr document',
       description:
-        'List the comment threads on a Rootr (루터) document, optionally filtered to one block. Works with any key.',
+        'List the comment threads on a Rootr (루터) document, optionally filtered to one block. ' +
+        'DB-ROW-COMMENT — for the comments on ONE ROW of a table, pass the DATABASE as `target` and the ' +
+        'ROW id as `blockId`. Works with any key.',
       annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         target: z.string().describe('Document path (starting with "/") or node id, or a full rootr.io URL'),
-        blockId: z.string().optional().describe('Only comments anchored to this block'),
+        blockId: z
+          .string()
+          .optional()
+          .describe('Only comments anchored to this block — or a DATABASE ROW id for that row\'s comments'),
       },
     },
     async ({ target, blockId }) => {

package/lib/mcp-tools/forms.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 const fieldShape = z
   .object({
@@ -88,7 +88,9 @@ export function registerFormTools(server) {
         'Create a new FORM node (fillable intake) in a Rootr (루터) workspace, optionally seeded with field ' +
         'definitions. Use FORM for surveys/request queues collected from people outside the tree — set ' +
         '`targetDatabaseId` to also mirror each response into a DATABASE\'s rows. ' +
-        FIELDS_GUIDE,
+        FIELDS_GUIDE +
+        ' ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Form name/title'),
@@ -148,7 +150,8 @@ export function registerFormTools(server) {
         'rootr_read_form first and resend fields you want to keep (with their existing ids) so past responses ' +
         'stay attributable. Pass `targetDatabaseId: null` to unlink the mirrored DATABASE. ' +
         FIELDS_GUIDE,
-      annotations: { readOnlyHint: false, destructiveHint: false },
+      // `fields`를 주면 필드 전체를 갈아끼운다 — 기존 id 를 안 보내면 응답 귀속이 끊긴다.
+      annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
       inputSchema: {
         formId: z.string().describe(`FORM node id${NODE_TARGET_HINT}`),
         fields: z.array(fieldShape).optional().describe('COMPLETE fields array to set — omitted existing fields will be dropped'),

package/lib/mcp-tools/issues.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { textResult, jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT } from './shared.js';
+import { textResult, jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT } from './shared.js';
 
 /** Issue tracker tools: create tracker, list/create/get/update issues, comment. */
 export function registerIssueTools(server) {
@@ -10,7 +10,8 @@ export function registerIssueTools(server) {
       title: 'Create an issue tracker in a Rootr workspace',
       description:
         'Create a new GitHub-style issue tracker document in a Rootr (루터) workspace. Returns the tracker with ' +
-        'its id, plus its default labels/types — use rootr_create_issue afterward to add issues to it.',
+        'its id, plus its default labels/types — use rootr_create_issue afterward to add issues to it. ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().describe('Name of the issue tracker'),

package/lib/mcp-tools/logs.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, NODE_URL_HINT, resolveOptionalNodeId } from './shared.js';
 
 /** LOG datastore tools: create/update-fields/add-entries/query-entries/stats. */
 export function registerLogTools(server) {
@@ -12,7 +12,8 @@ export function registerLogTools(server) {
         'Create a new typed LOG store (a structured, queryable table-like node) in a Rootr (루터) workspace. ' +
         'Each field has a name/type; type is one of string|int|float|bool|datetime|json|enum|level|relation. ' +
         'Relation fields additionally need target (a node id to relate to) and optional many/relation flags. ' +
-        'Use rootr_add_log_entries afterward to insert rows, and rootr_query_log_entries / rootr_log_stats to read them back.',
+        'Use rootr_add_log_entries afterward to insert rows, and rootr_query_log_entries / rootr_log_stats to read them back. ' +
+        NODE_URL_HINT,
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().describe('Name of the LOG store'),

package/lib/mcp-tools/misc.js

@@ -95,11 +95,12 @@ export function registerMiscTools(server) {
     {
       title: 'Rename / re-icon / move any node',
       description:
-        'Change a Rootr (루터) node\'s NAME, ICON, TAGS, or PARENT — works for every node type ' +
-        '(DOCUMENT, FOLDER, DATABASE, SPREADSHEET, FORM, …). Until now icons could only be set when a node ' +
+        'Change a Rootr (루터) node\'s NAME, ICON, TAGS, PARENT, or graph auto-extraction setting — works for every ' +
+        'node type (DOCUMENT, FOLDER, DATABASE, SPREADSHEET, FORM, …). Until now icons could only be set when a node ' +
         'was CREATED, so matching a migrated tree to its Notion icons was impossible without recreating ' +
         'everything. Only the fields you pass change. `parentId: null` moves the node to the workspace root; ' +
-        'a node cannot be moved inside its own subtree.',
+        'a node cannot be moved inside its own subtree. `graphSyncOff: true` stops rows/edits from queuing this ' +
+        'node (and DATABASE tables especially) for graph extraction — useful right before a bulk load.',
       annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         target: z.string().describe('Node path (starting with "/") or node id'),
@@ -111,9 +112,16 @@ export function registerMiscTools(server) {
           .nullable()
           .optional()
           .describe('Move under this folder/document/database (id or path). null = workspace root.'),
+        graphSyncOff: z
+          .boolean()
+          .optional()
+          .describe(
+            'true = stop queuing this node for graph extraction (embeddings + LLM) on every edit; false = ' +
+              're-enable it (and backfill affected documents).',
+          ),
       },
     },
-    async ({ target, name, icon, tags, parentId }) => {
+    async ({ target, name, icon, tags, parentId, graphSyncOff }) => {
       try {
         const client = makeClient();
         const id = requireResolved(await resolveTarget(client, target));
@@ -122,7 +130,7 @@ export function registerMiscTools(server) {
         if (typeof parentId === 'string' && parentId) {
           parent = requireResolved(await resolveTarget(client, parentId));
         }
-        const node = await client.updateNode(id, { name, icon, tags, parentId: parent });
+        const node = await client.updateNode(id, { name, icon, tags, parentId: parent, graphSyncOff });
         return jsonResult(node);
       } catch (err) {
         return errorResult(err);
@@ -148,7 +156,36 @@ export function registerMiscTools(server) {
         const resolved = await resolveTarget(client, target);
         const id = requireResolved(resolved);
         await client.deleteNode(id);
-        return jsonResult({ deleted: id, note: 'moved to trash, recoverable' });
+        return jsonResult({
+          deleted: id,
+          note: 'moved to trash, recoverable — rootr_restore_node puts it back',
+        });
+      } catch (err) {
+        return errorResult(err);
+      }
+    },
+  );
+
+  server.registerTool(
+    'rootr_restore_node',
+    {
+      title: 'Restore a deleted node from the trash',
+      description:
+        'Put a trashed Rootr (루터) document, folder or table back where it was — the undo for ' +
+        'rootr_delete_node, and the same thing Ctrl+Z does in the app. Pass the node id you got back ' +
+        'from the delete (a path will NOT find it: a trashed node is no longer on the tree). ' +
+        'Children that went to the trash with it come back too. Needs WRITE on the node.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
+      inputSchema: {
+        nodeId: z
+          .string()
+          .describe('Node id of the trashed item (from the rootr_delete_node result or a notification)'),
+      },
+    },
+    async ({ nodeId }) => {
+      try {
+        const client = makeClient();
+        return jsonResult(await client.restoreNode(nodeId));
       } catch (err) {
         return errorResult(err);
       }