Bundle a folder of images + caption for TikTok mobile upload.

Photo carousel can only be uploaded from TikTok mobile app (not web). This tool prepares a folder + ZIP with:

• images/ (sorted 01.png, 02.png, ...)

• caption.txt (ready to paste into TikTok)

• manifest.json (metadata)

• README.txt (human upload instructions)

User then copies the ZIP/folder to their phone and uploads manually.

Args: images_dir: Absolute path to folder with 2-35 PNG/JPG images. caption: Caption text (1-2200 chars). Hashtags can be inline or via arg. hashtags: Optional list of hashtags without '#'. Max 30. series_slug: Series identifier for bundle naming (lowercase, no spaces). part_slug: Part identifier (optional). bundles_dir: Override default bundles output directory. make_zip: Also create .zip alongside the folder.

Returns: JSON with {"ok": true, "bundle_id": "...", "zip_path": "...", ...}.

List all prepared bundles with summary metadata.

Args: bundles_dir: Override default bundles directory.

Returns: JSON array of bundle summaries (id, image_count, created_at, has_zip, ...).

Get full manifest for a bundle.

Args: bundle_id: Bundle identifier (from list_bundles). bundles_dir: Override default bundles directory.

Returns: JSON manifest with image hashes, caption, timestamps, etc.

Delete a bundle folder + its ZIP file.

Args: bundle_id: Bundle identifier. bundles_dir: Override default bundles directory.

Returns: JSON with list of removed paths.