@idapt/cli 1.11.0 → 1.12.0

package/dist/index.cjs

@@ -5714,6 +5714,8 @@ var noteBoxSchema = zod.z.object({
 var noteSchema = zod.z.object({
   /** Public resourceId of the note. */
   id: zod.z.string(),
+  /** Containing folder's resourceId, or null at the box root. */
+  folder_id: zod.z.string().nullable(),
   title: zod.z.string(),
   content: zod.z.string(),
   /** "note" or "index". */
@@ -5723,6 +5725,38 @@ var noteSchema = zod.z.object({
   created_at: zod.z.string(),
   updated_at: zod.z.string()
 }).meta({ id: "Note" });
+var noteFolderSchema = zod.z.object({
+  /** Public resourceId of the folder. */
+  id: zod.z.string(),
+  /** Parent folder's resourceId, or null at the box root. */
+  parent_id: zod.z.string().nullable(),
+  name: zod.z.string(),
+  created_at: zod.z.string(),
+  updated_at: zod.z.string()
+}).meta({ id: "NoteFolder" });
+var noteTreeSchema = zod.z.object({
+  folders: zod.z.array(noteFolderSchema),
+  notes: zod.z.array(noteSchema)
+}).meta({ id: "NoteTree" });
+var noteTrashEntrySchema = zod.z.object({
+  /** "note", "folder", or "box". */
+  kind: zod.z.string(),
+  /** Public resourceId of the trashed root. */
+  id: zod.z.string(),
+  /** Owning box resourceId (null for a box entry). */
+  note_box_id: zod.z.string().nullable(),
+  /** Note title / folder name / box name. */
+  name: zod.z.string(),
+  /** Location hint (box name for notes/folders). */
+  path: zod.z.string().nullable(),
+  child_count: zod.z.number().int(),
+  trashed_at: zod.z.string()
+}).meta({ id: "NoteTrashEntry" });
+var noteImportResultSchema = zod.z.object({
+  imported_notes: zod.z.number().int(),
+  created_folders: zod.z.number().int(),
+  skipped: zod.z.number().int()
+}).meta({ id: "NoteImportResult" });
 var noteHitSchema = zod.z.object({
   id: zod.z.string(),
   title: zod.z.string(),
@@ -5803,6 +5837,47 @@ var noteRenameRequestSchema = zod.z.object({
   retarget_wikilinks: zod.z.coerce.boolean().optional()
 });
 var noteRenameResponseSchema = zod.z.object({ note: noteSchema, retargeted_count: zod.z.number().int() }).meta({ id: "NoteRenameResult" });
+var folderCreateRequestSchema = zod.z.object({
+  name: zod.z.string().min(1).max(100),
+  /** Parent folder resourceId (null/omitted = box root). */
+  parent_id: zod.z.string().max(64).nullable().optional()
+});
+var folderRenameRequestSchema = zod.z.object({
+  name: zod.z.string().min(1).max(100)
+});
+var folderMoveRequestSchema = zod.z.object({
+  /** New parent folder resourceId (null/omitted = box root). */
+  parent_id: zod.z.string().max(64).nullable().optional()
+});
+var noteMoveRequestSchema = zod.z.object({
+  /** The note's title (identifies it within the box). */
+  title: zod.z.string().min(1).max(200),
+  /** Destination folder resourceId (null/omitted = box root). */
+  folder_id: zod.z.string().max(64).nullable().optional()
+});
+var noteImportRequestSchema = zod.z.object({
+  /** Text files to import; folders are derived from the `/`-separated path. */
+  items: zod.z.array(
+    zod.z.object({
+      /** Relative path incl. filename, e.g. `sub/dir/Readme.md`. */
+      path: zod.z.string().min(1).max(1024),
+      content: zod.z.string().max(262144)
+    })
+  ).min(1).max(5e3)
+});
+var trashListRequestSchema = zod.z.object({
+  workspace_id: zod.z.string().max(64).optional()
+});
+var trashActionRequestSchema = zod.z.object({
+  /** "note", "folder", or "box". */
+  kind: zod.z.enum(["note", "folder", "box"]),
+  /** The trashed root's public resourceId. */
+  id: zod.z.string().max(64)
+});
+var trashEmptyRequestSchema = zod.z.object({
+  workspace_id: zod.z.string().max(64).optional()
+});
+var trashCountResponseSchema = zod.z.object({ purged_count: zod.z.number().int() }).meta({ id: "NoteTrashPurgeResult" });
 var notesCommands = [
   cmd({
     resource: "notes",
@@ -6054,6 +6129,167 @@ var notesCommands = [
     responseKind: "single",
     request: noteRenameRequestSchema,
     response: noteRenameResponseSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "note-move",
+    method: "POST",
+    path: "/notes/boxes/:id/notes/move",
+    permission: ["notes", "write"],
+    summary: "Move a note into a folder (or the box root).",
+    tags: ["Notes"],
+    errors: [404, 422],
+    responseKind: "single",
+    request: noteMoveRequestSchema,
+    response: noteSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "tree",
+    method: "GET",
+    path: "/notes/boxes/:id/tree",
+    permission: ["notes", "read"],
+    summary: "Get a box's full tree (folders + notes) in one call.",
+    tags: ["Notes"],
+    errors: [404],
+    responseKind: "single",
+    response: noteTreeSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "folder-list",
+    method: "GET",
+    path: "/notes/boxes/:id/folders",
+    permission: ["notes", "read"],
+    summary: "List a box's folders.",
+    tags: ["Notes"],
+    errors: [404],
+    responseKind: "list",
+    response: noteFolderSchema,
+    columns: [
+      { header: "Name", field: "name" },
+      { header: "ID", field: "id" }
+    ]
+  }),
+  cmd({
+    resource: "notes",
+    verb: "folder-create",
+    method: "POST",
+    path: "/notes/boxes/:id/folders",
+    permission: ["notes", "write"],
+    summary: "Create a folder in a box (optionally under a parent folder).",
+    tags: ["Notes"],
+    errors: [404, 409, 422],
+    responseKind: "created",
+    request: folderCreateRequestSchema,
+    response: noteFolderSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "folder-rename",
+    method: "PATCH",
+    path: "/notes/folders/:folderId",
+    permission: ["notes", "write"],
+    summary: "Rename a folder.",
+    tags: ["Notes"],
+    errors: [404, 409, 422],
+    responseKind: "single",
+    request: folderRenameRequestSchema,
+    response: noteFolderSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "folder-move",
+    method: "POST",
+    path: "/notes/folders/:folderId/move",
+    permission: ["notes", "write"],
+    summary: "Move a folder under another folder (or the box root).",
+    tags: ["Notes"],
+    errors: [404, 409, 422],
+    responseKind: "single",
+    request: folderMoveRequestSchema,
+    response: noteFolderSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "folder-delete",
+    method: "DELETE",
+    path: "/notes/folders/:folderId",
+    permission: ["notes", "write"],
+    summary: "Delete a folder \u2192 moves it and its contents to the trash.",
+    tags: ["Notes"],
+    errors: [404],
+    responseKind: "deleted",
+    response: deletedEnvelopeSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "import",
+    method: "POST",
+    path: "/notes/boxes/:id/import",
+    permission: ["notes", "write"],
+    summary: "Import text files into a box, recreating their folder hierarchy. 413 over quota.",
+    tags: ["Notes"],
+    errors: [404, 413, 422],
+    responseKind: "single",
+    request: noteImportRequestSchema,
+    response: noteImportResultSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "trash-list",
+    method: "GET",
+    path: "/notes/trash",
+    permission: ["notes", "read"],
+    summary: "List the trashed notes, folders, and boxes in a workspace.",
+    tags: ["Notes"],
+    responseKind: "list",
+    request: trashListRequestSchema,
+    response: noteTrashEntrySchema,
+    argLocation: "query",
+    columns: [
+      { header: "Kind", field: "kind" },
+      { header: "Name", field: "name" }
+    ]
+  }),
+  cmd({
+    resource: "notes",
+    verb: "restore",
+    method: "POST",
+    path: "/notes/trash/restore",
+    permission: ["notes", "write"],
+    summary: "Restore a trashed note, folder, or box.",
+    tags: ["Notes"],
+    errors: [404],
+    responseKind: "deleted",
+    request: trashActionRequestSchema,
+    response: deletedEnvelopeSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "purge",
+    method: "POST",
+    path: "/notes/trash/purge",
+    permission: ["notes", "write"],
+    summary: "Permanently delete a trashed note, folder, or box (irreversible).",
+    tags: ["Notes"],
+    errors: [404, 422],
+    responseKind: "deleted",
+    request: trashActionRequestSchema,
+    response: deletedEnvelopeSchema
+  }),
+  cmd({
+    resource: "notes",
+    verb: "trash-empty",
+    method: "DELETE",
+    path: "/notes/trash",
+    permission: ["notes", "write"],
+    summary: "Permanently delete every trashed item in a workspace (irreversible).",
+    tags: ["Notes"],
+    responseKind: "single",
+    request: trashEmptyRequestSchema,
+    response: trashCountResponseSchema,
+    argLocation: "query"
   })
 ];
 var notesPlaybook = {
@@ -6075,6 +6311,14 @@ var notesPlaybook = {
     "  references a note. Search BEFORE writing to avoid duplicates.",
     "- After adding a note worth surfacing, update the Index with `notes",
     "  index-write` so the map stays accurate. The Index cannot be deleted.",
+    "- Organize with FOLDERS: `notes folder-create --box <box> --name` (optionally",
+    "  `--parent-id`), then `notes note-move --box <box> --title --folder-id` to",
+    "  place a note. Folders are organizational only \u2014 titles stay unique per box,",
+    "  so `[[wikilinks]]` resolve the same regardless of folder. `notes tree` returns",
+    "  the whole folders+notes hierarchy in one call.",
+    "- Deleting a note/folder/box moves it to the TRASH (recoverable). `notes",
+    "  trash-list` shows trashed roots; `notes restore --kind --id` brings one back;",
+    "  `notes purge --kind --id` deletes it forever. Trash auto-purges after 30 days.",
     "- Writes that would exceed your account's Notes size quota fail with 413 \u2014",
     "  prune or consolidate notes."
   ].join("\n")
@@ -26102,6 +26346,336 @@ var commandCatalog = [
       422
     ]
   },
+  {
+    "command": "notes folder-create",
+    "resource": "notes",
+    "verb": "folder-create",
+    "summary": "Create a folder in a box (optionally under a parent folder).",
+    "method": "POST",
+    "path": "/notes/boxes/:id/folders",
+    "pathParams": [
+      "id"
+    ],
+    "argLocation": "body",
+    "responseKind": "created",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 64
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "parent_id",
+        "name",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      409,
+      422
+    ]
+  },
+  {
+    "command": "notes folder-delete",
+    "resource": "notes",
+    "verb": "folder-delete",
+    "summary": "Delete a folder \u2192 moves it and its contents to the trash.",
+    "method": "DELETE",
+    "path": "/notes/folders/:folderId",
+    "pathParams": [
+      "folderId"
+    ],
+    "argLocation": "body",
+    "responseKind": "deleted",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": {}
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "deleted": {
+          "type": "boolean",
+          "const": true
+        },
+        "id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "deleted",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404
+    ]
+  },
+  {
+    "command": "notes folder-list",
+    "resource": "notes",
+    "verb": "folder-list",
+    "summary": "List a box's folders.",
+    "method": "GET",
+    "path": "/notes/boxes/:id/folders",
+    "pathParams": [
+      "id"
+    ],
+    "argLocation": "query",
+    "responseKind": "list",
+    "permission": [
+      "notes",
+      "read"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "parent_id",
+        "name",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404
+    ]
+  },
+  {
+    "command": "notes folder-move",
+    "resource": "notes",
+    "verb": "folder-move",
+    "summary": "Move a folder under another folder (or the box root).",
+    "method": "POST",
+    "path": "/notes/folders/:folderId/move",
+    "pathParams": [
+      "folderId"
+    ],
+    "argLocation": "body",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 64
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "parent_id",
+        "name",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      409,
+      422
+    ]
+  },
+  {
+    "command": "notes folder-rename",
+    "resource": "notes",
+    "verb": "folder-rename",
+    "summary": "Rename a folder.",
+    "method": "PATCH",
+    "path": "/notes/folders/:folderId",
+    "pathParams": [
+      "folderId"
+    ],
+    "argLocation": "body",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "parent_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "parent_id",
+        "name",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      409,
+      422
+    ]
+  },
   {
     "command": "notes graph",
     "resource": "notes",
@@ -26179,6 +26753,86 @@ var commandCatalog = [
       404
     ]
   },
+  {
+    "command": "notes import",
+    "resource": "notes",
+    "verb": "import",
+    "summary": "Import text files into a box, recreating their folder hierarchy. 413 over quota.",
+    "method": "POST",
+    "path": "/notes/boxes/:id/import",
+    "pathParams": [
+      "id"
+    ],
+    "argLocation": "body",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "minItems": 1,
+          "maxItems": 5e3,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 1024
+              },
+              "content": {
+                "type": "string",
+                "maxLength": 262144
+              }
+            },
+            "required": [
+              "path",
+              "content"
+            ]
+          }
+        }
+      },
+      "required": [
+        "items"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "imported_notes": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "created_folders": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "skipped": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "imported_notes",
+        "created_folders",
+        "skipped"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      413,
+      422
+    ]
+  },
   {
     "command": "notes index-read",
     "resource": "notes",
@@ -26206,6 +26860,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26229,6 +26893,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26277,6 +26942,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26300,6 +26975,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26415,6 +27091,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26438,6 +27124,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26451,6 +27138,101 @@ var commandCatalog = [
       404
     ]
   },
+  {
+    "command": "notes note-move",
+    "resource": "notes",
+    "verb": "note-move",
+    "summary": "Move a note into a folder (or the box root).",
+    "method": "POST",
+    "path": "/notes/boxes/:id/notes/move",
+    "pathParams": [
+      "id"
+    ],
+    "argLocation": "body",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 64
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "title"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "title": {
+          "type": "string"
+        },
+        "content": {
+          "type": "string"
+        },
+        "kind": {
+          "type": "string"
+        },
+        "version": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "folder_id",
+        "title",
+        "content",
+        "kind",
+        "version",
+        "created_at",
+        "updated_at"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      422
+    ]
+  },
   {
     "command": "notes note-rename",
     "resource": "notes",
@@ -26514,6 +27296,16 @@ var commandCatalog = [
             "id": {
               "type": "string"
             },
+            "folder_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
             "title": {
               "type": "string"
             },
@@ -26537,6 +27329,7 @@ var commandCatalog = [
           },
           "required": [
             "id",
+            "folder_id",
             "title",
             "content",
             "kind",
@@ -26554,6 +27347,64 @@ var commandCatalog = [
       422
     ]
   },
+  {
+    "command": "notes purge",
+    "resource": "notes",
+    "verb": "purge",
+    "summary": "Permanently delete a trashed note, folder, or box (irreversible).",
+    "method": "POST",
+    "path": "/notes/trash/purge",
+    "pathParams": [],
+    "argLocation": "body",
+    "responseKind": "deleted",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "note",
+            "folder",
+            "box"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "kind",
+        "id"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "deleted": {
+          "type": "boolean",
+          "const": true
+        },
+        "id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "deleted",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404,
+      422
+    ]
+  },
   {
     "command": "notes read",
     "resource": "notes",
@@ -26590,6 +27441,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26613,6 +27474,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26626,6 +27488,63 @@ var commandCatalog = [
       404
     ]
   },
+  {
+    "command": "notes restore",
+    "resource": "notes",
+    "verb": "restore",
+    "summary": "Restore a trashed note, folder, or box.",
+    "method": "POST",
+    "path": "/notes/trash/restore",
+    "pathParams": [],
+    "argLocation": "body",
+    "responseKind": "deleted",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "note",
+            "folder",
+            "box"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "kind",
+        "id"
+      ]
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "deleted": {
+          "type": "boolean",
+          "const": true
+        },
+        "id": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "deleted",
+        "id"
+      ],
+      "additionalProperties": false
+    },
+    "errors": [
+      404
+    ]
+  },
   {
     "command": "notes search",
     "resource": "notes",
@@ -26899,6 +27818,255 @@ var commandCatalog = [
       422
     ]
   },
+  {
+    "command": "notes trash-empty",
+    "resource": "notes",
+    "verb": "trash-empty",
+    "summary": "Permanently delete every trashed item in a workspace (irreversible).",
+    "method": "DELETE",
+    "path": "/notes/trash",
+    "pathParams": [],
+    "argLocation": "query",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "write"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "workspace_id": {
+          "type": "string",
+          "maxLength": 64
+        }
+      }
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "purged_count": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "purged_count"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "command": "notes trash-list",
+    "resource": "notes",
+    "verb": "trash-list",
+    "summary": "List the trashed notes, folders, and boxes in a workspace.",
+    "method": "GET",
+    "path": "/notes/trash",
+    "pathParams": [],
+    "argLocation": "query",
+    "responseKind": "list",
+    "permission": [
+      "notes",
+      "read"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "workspace_id": {
+          "type": "string",
+          "maxLength": 64
+        }
+      }
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "note_box_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "path": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "child_count": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "trashed_at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind",
+        "id",
+        "note_box_id",
+        "name",
+        "path",
+        "child_count",
+        "trashed_at"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "command": "notes tree",
+    "resource": "notes",
+    "verb": "tree",
+    "summary": "Get a box's full tree (folders + notes) in one call.",
+    "method": "GET",
+    "path": "/notes/boxes/:id/tree",
+    "pathParams": [
+      "id"
+    ],
+    "argLocation": "query",
+    "responseKind": "single",
+    "permission": [
+      "notes",
+      "read"
+    ],
+    "async": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "folders": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/NoteFolder"
+          }
+        },
+        "notes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Note"
+          }
+        }
+      },
+      "required": [
+        "folders",
+        "notes"
+      ],
+      "additionalProperties": false,
+      "$defs": {
+        "NoteFolder": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "parent_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "name": {
+              "type": "string"
+            },
+            "created_at": {
+              "type": "string"
+            },
+            "updated_at": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "parent_id",
+            "name",
+            "created_at",
+            "updated_at"
+          ],
+          "additionalProperties": false
+        },
+        "Note": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "folder_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "title": {
+              "type": "string"
+            },
+            "content": {
+              "type": "string"
+            },
+            "kind": {
+              "type": "string"
+            },
+            "version": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "created_at": {
+              "type": "string"
+            },
+            "updated_at": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "folder_id",
+            "title",
+            "content",
+            "kind",
+            "version",
+            "created_at",
+            "updated_at"
+          ],
+          "additionalProperties": false
+        }
+      }
+    },
+    "errors": [
+      404
+    ]
+  },
   {
     "command": "notes write",
     "resource": "notes",
@@ -26945,6 +28113,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26968,6 +28146,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -45454,6 +46633,11 @@ function mapArgsToV1(path, pathParams, args) {
     delete out.content;
     delete out.path;
   }
+  if (path === "drive create-folder" && out.name === void 0 && typeof out.path === "string") {
+    const target = out.path;
+    out.name = target.split("/").pop() || target;
+    delete out.path;
+  }
   const resolvedParent = out.resolved_parent_id;
   for (const [from, to] of Object.entries(RESOLVED_FIELD_TO_V1)) {
     const val = out[from];
@@ -45491,6 +46675,13 @@ function mapArgsToV1(path, pathParams, args) {
 }
 
 // src/execute.ts
+function requestDeclaresWorkspaceId(request) {
+  const shape = request?.shape;
+  return !!shape && Object.hasOwn(shape, "workspace_id");
+}
+function hasWorkspaceArg(args) {
+  return args.workspace_id !== void 0 || args.workspace !== void 0;
+}
 var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 function isOperationHandle(data) {
   return typeof data === "object" && data !== null && typeof data.id === "string" && typeof data.status === "string";
@@ -45587,10 +46778,11 @@ async function execute(cmd2, opts) {
       rendered: renderInstructions(spec.resource)
     };
   }
+  const mergedArgs = opts.defaultWorkspaceRef && !hasWorkspaceArg(mappedArgs) && requestDeclaresWorkspaceId(spec.request) ? { ...mappedArgs, workspace_id: opts.defaultWorkspaceRef } : mappedArgs;
   return runSpec(
     spec,
     positionals,
-    mappedArgs,
+    mergedArgs,
     opts,
     mode,
     opts.background ?? inv.background