@idapt/cli 1.11.0 → 1.12.0

package/dist/bin.cjs

@@ -5997,6 +5997,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". */
@@ -6006,6 +6008,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(),
@@ -6086,6 +6120,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",
@@ -6337,6 +6412,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 = {
@@ -6358,6 +6594,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")
@@ -26382,6 +26626,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",
@@ -26459,6 +27033,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",
@@ -26486,6 +27140,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26509,6 +27173,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26557,6 +27222,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26580,6 +27255,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26695,6 +27371,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26718,6 +27404,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26731,6 +27418,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",
@@ -26794,6 +27576,16 @@ var commandCatalog = [
             "id": {
               "type": "string"
             },
+            "folder_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
             "title": {
               "type": "string"
             },
@@ -26817,6 +27609,7 @@ var commandCatalog = [
           },
           "required": [
             "id",
+            "folder_id",
             "title",
             "content",
             "kind",
@@ -26834,6 +27627,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",
@@ -26870,6 +27721,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -26893,6 +27754,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -26906,6 +27768,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",
@@ -27179,6 +28098,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",
@@ -27225,6 +28393,16 @@ var commandCatalog = [
         "id": {
           "type": "string"
         },
+        "folder_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "title": {
           "type": "string"
         },
@@ -27248,6 +28426,7 @@ var commandCatalog = [
       },
       "required": [
         "id",
+        "folder_id",
         "title",
         "content",
         "kind",
@@ -45461,6 +46640,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];
@@ -45498,6 +46682,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";
@@ -45594,10 +46785,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
@@ -45770,7 +46962,7 @@ function createFetchTransport(opts) {
 }
 
 // src/version.ts
-var VERSION = "1.11.0";
+var VERSION = "1.12.0";
 var USER_AGENT = `idapt-cli/${VERSION}`;
 var MAX_BUNDLE_FILES = 500;
 var MAX_BUNDLE_FILE_BYTES = 25 * 1024 * 1024;
@@ -47197,6 +48389,113 @@ Automatic update failed (exit ${code}). Run it manually:
   return 0;
 }
 
+// src/workspace-context.ts
+function pick(row, ...keys) {
+  for (const k of keys) {
+    const v = row[k];
+    if (typeof v === "string" && v.length > 0) return v;
+  }
+  return void 0;
+}
+function qualifiedSlug(row) {
+  const q = pick(row, "qualified_slug", "qualifiedSlug");
+  if (q) return q;
+  const owner = pick(row, "owner_slug", "ownerSlug", "owner");
+  const slug = pick(row, "slug");
+  return owner && slug ? `${owner}/${slug}` : slug;
+}
+function resourceIdOf(row) {
+  return pick(row, "resourceId", "resource_id", "id");
+}
+function matches(row, ref) {
+  const r = ref.toLowerCase();
+  return [
+    pick(row, "resourceId", "resource_id"),
+    pick(row, "id"),
+    pick(row, "slug"),
+    qualifiedSlug(row)
+  ].some((c) => c !== void 0 && c.toLowerCase() === r);
+}
+async function runWorkspaceContext(sub, args, transport, io) {
+  if (sub === "current") {
+    const creds2 = loadCredentials();
+    if (creds2.defaultWorkspaceId) {
+      io.print(`${creds2.defaultWorkspaceSlug ?? creds2.defaultWorkspaceId}
+`);
+    } else {
+      io.print(
+        "(no default workspace \u2014 scope verbs run in your personal workspace)\n"
+      );
+    }
+    return 0;
+  }
+  if (sub === "clear") {
+    const creds2 = loadCredentials();
+    if (!creds2.defaultWorkspaceId) {
+      io.print("No default workspace was set.\n");
+      return 0;
+    }
+    const was = creds2.defaultWorkspaceSlug ?? creds2.defaultWorkspaceId;
+    creds2.defaultWorkspaceId = void 0;
+    creds2.defaultWorkspaceSlug = void 0;
+    saveCredentials(creds2);
+    io.print(
+      `Cleared the default workspace (was ${was}). Scope verbs now run in your personal workspace.
+`
+    );
+    return 0;
+  }
+  const ref = args[0];
+  if (!ref) {
+    io.err(
+      "idapt workspace use: missing workspace. Usage: `idapt workspace use <ownerSlug/workspaceSlug | resourceId>`.\n"
+    );
+    return 1;
+  }
+  if (!transport) {
+    io.err("idapt workspace use: not logged in. Run `idapt login` first.\n");
+    return 1;
+  }
+  const listed = await execute("idapt workspace list", {
+    transport,
+    mode: "json"
+  });
+  if (!listed.ok) {
+    io.err(
+      `idapt workspace use: could not list workspaces: ${listed.error ?? "unknown error"}
+`
+    );
+    return 1;
+  }
+  const rows = Array.isArray(listed.data) ? listed.data : [];
+  const match = rows.find((w) => matches(w, ref));
+  if (!match) {
+    const available = rows.map((w) => `  ${qualifiedSlug(w) ?? resourceIdOf(w) ?? "?"}`).join("\n") || "  (none)";
+    io.err(
+      `idapt workspace use: no workspace matches "${ref}". Your workspaces:
+${available}
+`
+    );
+    return 1;
+  }
+  const resourceId = resourceIdOf(match);
+  if (!resourceId) {
+    io.err(
+      "idapt workspace use: the matched workspace is missing a resourceId.\n"
+    );
+    return 1;
+  }
+  const creds = loadCredentials();
+  creds.defaultWorkspaceId = resourceId;
+  creds.defaultWorkspaceSlug = qualifiedSlug(match) ?? resourceId;
+  saveCredentials(creds);
+  io.print(
+    `Default workspace set to ${creds.defaultWorkspaceSlug}. Scope verbs now run there (override per-call with --workspace-id, or run \`idapt workspace clear\`).
+`
+  );
+  return 0;
+}
+
 // src/bin.ts
 var DEFAULT_BASE_URL = "https://idapt.app";
 var OUTPUT_MODES = /* @__PURE__ */ new Set(["json", "jsonl", "table", "quiet"]);
@@ -47348,6 +48647,32 @@ async function run(io) {
       rest.slice(1)
     );
   }
+  if (cmd2 === "workspace") {
+    const sub = rest[1];
+    if (sub === "current" || sub === "clear") {
+      return runWorkspaceContext(sub, rest.slice(2), void 0, {
+        print: io.stdout,
+        err: io.stderr
+      });
+    }
+    if (sub === "use") {
+      const wsCred = await resolveCredential({
+        apiKeyFlag,
+        env: io.env,
+        baseUrl,
+        userAgent: USER_AGENT
+      }).catch(() => null);
+      const wsTransport = wsCred ? createFetchTransport({
+        baseUrl,
+        token: wsCred.token,
+        userAgent: USER_AGENT
+      }) : void 0;
+      return runWorkspaceContext(sub, rest.slice(2), wsTransport, {
+        print: io.stdout,
+        err: io.stderr
+      });
+    }
+  }
   const doc = isDocCommand(rest);
   let token;
   const resolved = await resolveCredential({
@@ -47374,9 +48699,11 @@ async function run(io) {
     readFile: (p) => fs.readFileSync(p, "utf-8"),
     readStdin: () => fs.readFileSync(0, "utf-8")
   });
+  const ambientWorkspace = loadCredentials().defaultWorkspaceId;
   const result = await execute(buildCommandFromArgv(restWithJson), {
     transport,
-    mode: autoMode(io.isTty, requested)
+    mode: autoMode(io.isTty, requested),
+    ...ambientWorkspace ? { defaultWorkspaceRef: ambientWorkspace } : {}
   });
   if (result.ok) io.stdout(`${result.rendered}
 `);