tana-mcp-codemode 0.2.0 → 0.2.2

package/package.json

@@ -1,12 +1,25 @@
 {
   "name": "tana-mcp-codemode",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Codemode MCP server for Tana — AI writes TypeScript that executes against Tana Local API",
   "type": "module",
   "main": "src/index.ts",
   "bin": {
     "tana-mcp-codemode": "src/index.ts"
   },
+  "scripts": {
+    "generate": "bun run scripts/generate.ts",
+    "list-endpoints": "bun run scripts/list-endpoints.ts",
+    "start": "bun run --env-file=.env src/index.ts",
+    "dev": "bun run --env-file=.env --watch src/index.ts",
+    "debug": "bun run --env-file=.env src/debug-server.ts",
+    "test": "bun test",
+    "typecheck": "bunx tsc --noEmit",
+    "prepublishOnly": "bun run typecheck",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
   "files": [
     "src/index.ts",
     "src/prompts.ts",
@@ -41,14 +54,5 @@
     "openapi-typescript": "^7.10.1",
     "typescript": "^5.9.3"
   },
-  "license": "MIT",
-  "scripts": {
-    "generate": "bun run scripts/generate.ts",
-    "list-endpoints": "bun run scripts/list-endpoints.ts",
-    "start": "bun run --env-file=.env src/index.ts",
-    "dev": "bun run --env-file=.env --watch src/index.ts",
-    "debug": "bun run --env-file=.env src/debug-server.ts",
-    "test": "bun test",
-    "typecheck": "bunx tsc --noEmit"
-  }
-}
+  "license": "MIT"
+}

package/src/api/tana.ts

@@ -16,6 +16,7 @@ import type {
   SearchResult,
   Children,
   EditNodeOptions,
+  MoveNodeOptions,
   Tag,
   CreateTagOptions,
   AddFieldOptions,
@@ -54,6 +55,10 @@ export interface TanaAPI {
     ): Promise<Children>;
     /** Edit a node's name/description */
     edit(options: EditNodeOptions): Promise<{ success: boolean }>;
+    /** Move node to a new parent */
+    move(options: MoveNodeOptions): Promise<{ success: boolean }>;
+    /** Open a node in the Tana UI */
+    open(nodeId: string, openType?: "current" | "panel" | "tab"): Promise<{ success: boolean }>;
     /** Move node to trash */
     trash(nodeId: string): Promise<{ success: boolean }>;
     /** Check a node's checkbox */
@@ -86,13 +91,15 @@ export interface TanaAPI {
     setOption(
       nodeId: string,
       attributeId: string,
-      optionId: string
+      optionId: string,
+      mode?: "replace" | "append"
     ): Promise<{ success: boolean }>;
-    /** Set a field to a string value */
+    /** Set a field to a string value, or null to clear it */
     setContent(
       nodeId: string,
       attributeId: string,
-      content: string
+      content: string | null,
+      mode?: "replace" | "append"
     ): Promise<{ success: boolean }>;
   };
 
@@ -202,6 +209,31 @@ export function createTanaAPI(
         return { success: !!result.nodeId };
       },
 
+      async move(options: MoveNodeOptions): Promise<{ success: boolean }> {
+        const result = await client.post<{ nodeId: string; message: string }>(
+          `/nodes/${options.nodeId}/move`,
+          {
+            targetNodeId: options.targetNodeId,
+            keepSourceReference: options.keepSourceReference,
+            position: options.position,
+            referenceNodeId: options.referenceNodeId,
+            sourceParentId: options.sourceParentId,
+          }
+        );
+        return { success: !!result.nodeId };
+      },
+
+      async open(
+        nodeId: string,
+        openType: "current" | "panel" | "tab" = "current"
+      ): Promise<{ success: boolean }> {
+        const result = await client.post<{ nodeId: string; message: string }>(
+          `/nodes/${nodeId}/open`,
+          { openType }
+        );
+        return { success: !!result.nodeId };
+      },
+
       async trash(nodeId: string): Promise<{ success: boolean }> {
         const result = await client.post<{ nodeId: string; message: string }>(
           `/nodes/${nodeId}/trash`,
@@ -317,11 +349,12 @@ export function createTanaAPI(
       async setOption(
         nodeId: string,
         attributeId: string,
-        optionId: string
+        optionId: string,
+        mode?: "replace" | "append"
       ): Promise<{ success: boolean }> {
         const result = await client.post<{ nodeId: string; message: string }>(
           `/nodes/${nodeId}/fields/${attributeId}/option`,
-          { optionId }
+          { optionId, mode }
         );
         return { success: !!result.nodeId };
       },
@@ -329,11 +362,12 @@ export function createTanaAPI(
       async setContent(
         nodeId: string,
         attributeId: string,
-        content: string
+        content: string | null,
+        mode?: "replace" | "append"
       ): Promise<{ success: boolean }> {
         const result = await client.post<{ nodeId: string; message: string }>(
           `/nodes/${nodeId}/fields/${attributeId}/content`,
-          { content }
+          { content, mode }
         );
         return { success: !!result.nodeId };
       },

package/src/api/types.ts

@@ -161,6 +161,16 @@ export interface SetCheckboxOptions {
   };
 }
 
+/** Options for moving a node to a new parent */
+export interface MoveNodeOptions {
+  nodeId: string;
+  targetNodeId: string;
+  keepSourceReference?: boolean;
+  position?: "start" | "end" | "after" | "before";
+  referenceNodeId?: string;
+  sourceParentId?: string;
+}
+
 /** Options for editing a node */
 export interface EditNodeOptions {
   nodeId: string;

package/src/prompts.ts

@@ -14,6 +14,8 @@ tana.nodes.search(query, options?) → SearchResult[]
 tana.nodes.read(nodeId, maxDepth?) → string (markdown)
 tana.nodes.getChildren(nodeId, { limit?, offset? }) → { children, total, hasMore }
 tana.nodes.edit({ nodeId, name?, description? }) → { success }
+tana.nodes.move({ nodeId, targetNodeId, keepSourceReference?, position?, referenceNodeId?, sourceParentId? }) → { success }
+tana.nodes.open(nodeId, openType?) → { success }  // openType: "current" | "panel" | "tab" (default: "current")
 tana.nodes.trash(nodeId) → { success }
 tana.nodes.check(nodeId) / uncheck(nodeId) → { success }
 
@@ -26,8 +28,8 @@ tana.tags.addField({ tagId, name, dataType: "plain"|"number"|"date"|"url"|"email
 tana.tags.setCheckbox({ tagId, showCheckbox, doneStateMapping? })
 
 ### Fields
-tana.fields.setOption(nodeId, attributeId, optionId)
-tana.fields.setContent(nodeId, attributeId, content)
+tana.fields.setOption(nodeId, attributeId, optionId, mode?)  // mode: "replace" | "append" (default: "replace")
+tana.fields.setContent(nodeId, attributeId, content, mode?)  // content: string | null (null clears field), mode: "replace" | "append"
 
 ### Calendar
 tana.calendar.getOrCreate(workspaceId, "day"|"week"|"month"|"year", date?)

package/src/sandbox/executor.ts

@@ -58,6 +58,14 @@ function createTrackedTanaAPI(
         trackNodeId(options.nodeId);
         return track("nodes.edit", () => tana.nodes.edit(options));
       },
+      move: (options) => {
+        trackNodeId(options.nodeId);
+        return track("nodes.move", () => tana.nodes.move(options));
+      },
+      open: (nodeId, openType) => {
+        trackNodeId(nodeId);
+        return track("nodes.open", () => tana.nodes.open(nodeId, openType));
+      },
       trash: (nodeId) => {
         trackNodeId(nodeId);
         return track("nodes.trash", () => tana.nodes.trash(nodeId));