rootr-cli 0.2.1 → 0.4.1

package/lib/mcp-tools/logs.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
 
 /** LOG datastore tools: create/update-fields/add-entries/query-entries/stats. */
 export function registerLogTools(server) {
@@ -13,6 +13,7 @@ export function registerLogTools(server) {
         '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.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().describe('Name of the LOG store'),
         fields: z
@@ -21,7 +22,7 @@ export function registerLogTools(server) {
             'Field definitions: [{name, type, ...}]. type=string|int|float|bool|datetime|json|enum|level|relation. ' +
               'relation fields add target (node id), many?, relation?.',
           ),
-        parentId: z.string().optional().describe('Parent node id to nest the LOG store under'),
+        parentId: z.string().optional().describe(`Parent node id${NODE_TARGET_HINT}`),
         workspace: z
           .string()
           .optional()
@@ -32,6 +33,7 @@ export function registerLogTools(server) {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
+        parentId = await resolveOptionalNodeId(client, parentId);
         const result = await client.createLogStore(ws, { name, fields, parentId });
         return jsonResult(result);
       } catch (err) {
@@ -48,8 +50,9 @@ export function registerLogTools(server) {
         'Update the field schema of an existing LOG store. WARNING: this REPLACES THE ENTIRE FIELD SET — ' +
         'you must resend every field you want to keep, not just the ones you are changing/adding. ' +
         'Read the LOG store first (e.g. via rootr_read or a get-log call) to see its current fields before calling this.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
       inputSchema: {
-        logId: z.string().describe('LOG store node id'),
+        logId: z.string().describe(`LOG store node id${NODE_TARGET_HINT}`),
         fields: z
           .array(z.record(z.any()))
           .describe('COMPLETE field list to set — omitted existing fields will be dropped'),
@@ -58,6 +61,7 @@ export function registerLogTools(server) {
     async ({ logId, fields }) => {
       try {
         const client = makeClient();
+        logId = await resolveNodeId(client, logId);
         const result = await client.updateLogFields(logId, fields);
         return jsonResult(result);
       } catch (err) {
@@ -73,8 +77,9 @@ export function registerLogTools(server) {
       description:
         'Append one or more entries (rows) to a LOG store. Each entry may carry ts, source, level, message, data ' +
         '(shaped per the store\'s field schema). This is additive — existing entries are untouched.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        logId: z.string().describe('LOG store node id'),
+        logId: z.string().describe(`LOG store node id${NODE_TARGET_HINT}`),
         entries: z
           .array(z.record(z.any()))
           .describe('Entries to add: [{ts?, source?, level?, message?, data?}, ...]'),
@@ -83,6 +88,7 @@ export function registerLogTools(server) {
     async ({ logId, entries }) => {
       try {
         const client = makeClient();
+        logId = await resolveNodeId(client, logId);
         const result = await client.addLogEntries(logId, entries);
         return jsonResult(result);
       } catch (err) {
@@ -98,8 +104,9 @@ export function registerLogTools(server) {
       description:
         'Query/filter entries from a LOG store by time range, source, level, and/or anomaly flag. ' +
         'Use this to inspect recent activity or find anomalous entries before asking rootr_ask for root-cause analysis.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
-        logId: z.string().describe('LOG store node id'),
+        logId: z.string().describe(`LOG store node id${NODE_TARGET_HINT}`),
         from: z.string().optional().describe('ISO timestamp lower bound'),
         to: z.string().optional().describe('ISO timestamp upper bound'),
         source: z.string().optional().describe('Filter by source'),
@@ -112,6 +119,7 @@ export function registerLogTools(server) {
     async ({ logId, from, to, source, level, anomalyOnly, limit, order }) => {
       try {
         const client = makeClient();
+        logId = await resolveNodeId(client, logId);
         const result = await client.queryLogEntries(logId, {
           from,
           to,
@@ -136,8 +144,9 @@ export function registerLogTools(server) {
         'Compute aggregate statistics over a LOG store\'s entries, grouped by hour/day/source/level, with a ' +
         'metric of count/avg/max/min/sum (avg/max/min/sum require a numeric `field`). Useful for trend/volume ' +
         'questions without pulling raw entries.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
-        logId: z.string().describe('LOG store node id'),
+        logId: z.string().describe(`LOG store node id${NODE_TARGET_HINT}`),
         groupBy: z.string().optional().describe('hour | day | source | level'),
         metric: z.string().optional().describe('count | avg | max | min | sum'),
         field: z.string().optional().describe('Numeric field name, required for avg/max/min/sum'),
@@ -148,6 +157,7 @@ export function registerLogTools(server) {
     async ({ logId, groupBy, metric, field, from, to }) => {
       try {
         const client = makeClient();
+        logId = await resolveNodeId(client, logId);
         const result = await client.logStats(logId, { groupBy, metric, field, from, to });
         return jsonResult(result);
       } catch (err) {

package/lib/mcp-tools/misc.js

@@ -12,6 +12,7 @@ export function registerMiscTools(server) {
       description:
         'List saved versions of a Rootr (루터) document, most recent first. Useful for seeing what changed and ' +
         'when, or to recover an older revision.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
         target: z.string().describe('Document path (starting with "/") or node id'),
         limit: z.number().optional().describe('Max number of versions to return'),
@@ -37,6 +38,7 @@ export function registerMiscTools(server) {
       description:
         'Delete a Rootr (루터) document or folder by moving it to the trash — this is recoverable, not a ' +
         'permanent delete. Use rootr_read/rootr_list first to confirm you have the right target.',
+      annotations: { readOnlyHint: false, destructiveHint: true },
       inputSchema: {
         target: z.string().describe('Document/folder path (starting with "/") or node id'),
       },

package/lib/mcp-tools/presentations.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 
-import { jsonResult, errorResult, makeClient, requireWorkspace } from './shared.js';
+import { jsonResult, errorResult, makeClient, requireWorkspace, resolveNodeId, NODE_TARGET_HINT, resolveOptionalNodeId } from './shared.js';
 
 /**
  * Authoring guide, repeated (shortened) across every tool description so an
@@ -124,9 +124,10 @@ export function registerPresentationTools(server) {
         'Create a new PRESENTATION node (a slide deck) in a Rootr (루터) workspace, optionally seeded with an ' +
         'initial theme and slides. ' +
         AUTHORING_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         name: z.string().optional().describe('Deck name/title'),
-        parentId: z.string().optional().describe('Parent folder/node id to create the deck under'),
+        parentId: z.string().optional().describe(`Parent folder/node id${NODE_TARGET_HINT}`),
         theme: themeShape,
         slides: z.array(slideShape).optional().describe('Initial slides, in order'),
         config: z.record(z.unknown()).optional().describe('Free-form deck config/settings object'),
@@ -141,6 +142,7 @@ export function registerPresentationTools(server) {
       try {
         const ws = requireWorkspace(workspace);
         const client = makeClient(ws);
+        parentId = await resolveOptionalNodeId(client, parentId);
         const result = await client.createPresentation(ws, {
           name,
           parentId,
@@ -164,13 +166,15 @@ export function registerPresentationTools(server) {
         'Read a Rootr (루터) PRESENTATION node — its theme and full slides array. Read this before ' +
         'rootr_update_presentation / rootr_append_presentation_slides / rootr_reorder_presentation_slides so you ' +
         'know the current slide ids and content.',
+      annotations: { readOnlyHint: true, destructiveHint: false },
       inputSchema: {
-        presentationId: z.string().describe('PRESENTATION node id'),
+        presentationId: z.string().describe(`PRESENTATION node id${NODE_TARGET_HINT}`),
       },
     },
     async ({ presentationId }) => {
       try {
         const client = makeClient();
+        presentationId = await resolveNodeId(client, presentationId);
         const result = await client.getPresentation(presentationId);
         return jsonResult(result);
       } catch (err) {
@@ -189,8 +193,9 @@ export function registerPresentationTools(server) {
         'slides you want to keep, or use rootr_append_presentation_slides / rootr_update_presentation_slide instead ' +
         'for incremental changes). ' +
         AUTHORING_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        presentationId: z.string().describe('PRESENTATION node id'),
+        presentationId: z.string().describe(`PRESENTATION node id${NODE_TARGET_HINT}`),
         theme: themeShape,
         slides: z
           .array(slideShape)
@@ -203,6 +208,7 @@ export function registerPresentationTools(server) {
     async ({ presentationId, theme, slides, config, icon }) => {
       try {
         const client = makeClient();
+        presentationId = await resolveNodeId(client, presentationId);
         const result = await client.updatePresentation(presentationId, {
           theme,
           slides: ensureSlideIds(slides),
@@ -224,14 +230,16 @@ export function registerPresentationTools(server) {
         'Append one or more slides to the END of a Rootr (루터) PRESENTATION, without touching existing slides. ' +
         'PREFER this over rootr_update_presentation when you are only adding new slides. ' +
         AUTHORING_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        presentationId: z.string().describe('PRESENTATION node id'),
+        presentationId: z.string().describe(`PRESENTATION node id${NODE_TARGET_HINT}`),
         slides: z.array(slideShape).describe('Slides to append, in order'),
       },
     },
     async ({ presentationId, slides }) => {
       try {
         const client = makeClient();
+        presentationId = await resolveNodeId(client, presentationId);
         const result = await client.appendPresentationSlides(presentationId, ensureSlideIds(slides));
         return jsonResult(result);
       } catch (err) {
@@ -249,8 +257,9 @@ export function registerPresentationTools(server) {
         'targeted edit (e.g. rewrite one slide\'s title/blocks); use rootr_append_presentation_slides instead when ' +
         'you are only adding new slides. Call rootr_read_presentation first to get the exact slideId. ' +
         AUTHORING_GUIDE,
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        presentationId: z.string().describe('PRESENTATION node id'),
+        presentationId: z.string().describe(`PRESENTATION node id${NODE_TARGET_HINT}`),
         slideId: z.string().describe('Slide id to update (must belong to the deck)'),
         slide: slideShape.describe('Partial slide fields to merge into the existing slide'),
       },
@@ -258,6 +267,7 @@ export function registerPresentationTools(server) {
     async ({ presentationId, slideId, slide }) => {
       try {
         const client = makeClient();
+        presentationId = await resolveNodeId(client, presentationId);
         const result = await client.updatePresentationSlide(presentationId, slideId, slide);
         return jsonResult(result);
       } catch (err) {
@@ -273,14 +283,16 @@ export function registerPresentationTools(server) {
       description:
         'Reorder a Rootr (루터) PRESENTATION\'s slides. `order` must be the FULL list of the deck\'s slide ids, ' +
         'in the new desired order — call rootr_read_presentation first to get the current ids.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
-        presentationId: z.string().describe('PRESENTATION node id'),
+        presentationId: z.string().describe(`PRESENTATION node id${NODE_TARGET_HINT}`),
         order: z.array(z.string()).describe('Complete ordered array of slide ids'),
       },
     },
     async ({ presentationId, order }) => {
       try {
         const client = makeClient();
+        presentationId = await resolveNodeId(client, presentationId);
         const result = await client.reorderPresentationSlides(presentationId, order);
         return jsonResult(result);
       } catch (err) {
@@ -301,9 +313,10 @@ export function registerPresentationTools(server) {
         'Prompt tips: describe a clean, flat, presentation-ready illustration; specify colors to match the deck ' +
         'theme; and say "no text" — baked-in text is not indexed and often renders wrong (put the meaning in the ' +
         'slide title/blocks instead, and always give the image an `alt` caption). Consumes AI credits.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         prompt: z.string().describe('English image description; ask for "no text" in the image'),
-        nodeId: z.string().optional().describe('Presentation/node id to attach the image to (permission-checked)'),
+        nodeId: z.string().optional().describe(`Presentation/node id${NODE_TARGET_HINT} to attach the image to (permission-checked)`),
         workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config'),
       },
     },
@@ -311,6 +324,7 @@ export function registerPresentationTools(server) {
       try {
         const client = makeClient();
         const ws = requireWorkspace(workspace);
+        nodeId = await resolveOptionalNodeId(client, nodeId);
         const result = await client.generateImage(ws, { prompt, nodeId });
         return jsonResult(result);
       } catch (err) {
@@ -328,9 +342,10 @@ export function registerPresentationTools(server) {
         'and store the result as a new transparent PNG. Pass the source attachment id; returns { id, url, ... } for ' +
         'the cut-out image, which you can then place on a slide. Useful for product shots / logos / subjects that ' +
         'should sit on the slide without a boxed background.',
+      annotations: { readOnlyHint: false, destructiveHint: false },
       inputSchema: {
         attachmentId: z.string().describe('Source attachment id (from rootr_generate_image or an upload)'),
-        nodeId: z.string().optional().describe('Presentation/node id to attach the result to (permission-checked)'),
+        nodeId: z.string().optional().describe(`Presentation/node id${NODE_TARGET_HINT} to attach the result to (permission-checked)`),
         workspace: z.string().optional().describe('Workspace id; defaults to ROOTR_WORKSPACE/config'),
       },
     },
@@ -338,6 +353,7 @@ export function registerPresentationTools(server) {
       try {
         const client = makeClient();
         const ws = requireWorkspace(workspace);
+        nodeId = await resolveOptionalNodeId(client, nodeId);
         const result = await client.removeImageBackground(ws, { attachmentId, nodeId });
         return jsonResult(result);
       } catch (err) {