Args:
    query: Search keywords
    limit: Results per page (max 100)
    offset: Pagination offset

Args:
    category_id: Category ID (0=all, get IDs from list_categories)
    limit: Results per page (max 100)
    offset: Pagination offset

Args:
    footprint_id: Bookmark ID (from list_footprints or search results, field "id")

Call list_categories() and list_tags() FIRST to discover existing categories
and tags — avoid creating duplicates. If title is empty, it will be auto-extracted.

Args:
    url: Web page URL (required)
    title: Custom title (leave empty for auto-extraction)
    description: Summary/notes
    category_ids: Comma-separated category IDs, e.g. "1,3"
    tag_names: Comma-separated tag names, e.g. "AI,tutorial"

⚠️ category_ids REPLACES the entire category list — NOT append!
Correct approach: get_footprint(id) to see current categories → merge in new IDs → send the full list.
Example: existing [3,5], want to add 7 → category_ids="3,5,7" (NOT just "7")

Args:
    footprint_id: Bookmark ID (from search or list results)
    title/description/category_ids/tag_names: Leave empty to keep unchanged

Returns each category with id, name, and mode fields.
mode=null → personal category. mode="cocreate"/"subscribe" → shared category.
Use the 'id' field in add_footprint / update_footprint category_ids parameter.

Args:
    name: Category name
    category_set_id: Parent category set (0=default)

Args:
    name: Category set name

⚠️ In subscribe mode, NO ONE (including the creator) can add bookmarks —
add_to_shared_category returns 403. Use mode="cocreate" if collaboration is needed.

Args:
    invite_code: 8-character invite code

Args:
    shared_category_id: Shared category ID (from list_categories — pick ones where mode is not null)
    duration_hours: Link validity in hours

Args:
    shared_category_id: Shared category ID
    footprint_id: Bookmark ID

Args:
    shared_category_id: Shared category ID
    footprint_id: Bookmark ID

Args:
    footprint_id: Bookmark ID to copy
    category_ids: Target category IDs, comma-separated, e.g. "1,3"

Args:
    updates: JSON string, format '[{"id":"uuid","title":"New Title","category_ids":"1,3"}, ...]'
             Each object may contain title/description/category_ids/tag_names; "id" is required

After the Agent organizes the user's bookmarks, call this to generate a link.
Send it to the user: "Done organizing — view here → [link]"
User clicks to see a card-based interface. Link valid for 30 days, reusable.