DesignerBox

Delete a Video Studio project in the active team. It disappears from the Video Studio. Confirm with the user before calling.

delete_video_project

Create a fashion video from a single image: a cinematic runway/spin/fabric-flow/etc. motion while preserving the exact outfit. Async — returns a taskUUID; poll get_video_status. Credit cost = model + duration. Requires available AI credits.

fashion_video

Create a professional flat-lay composition from multiple product images. Cost = image model per-image credits. Requires available AI credits.

flat_lay

Use this when the user asks DesignerBox for a new image from a text description, with no template and no photo of theirs: DesignerBox generates it and saves it to the user's library. For a template or the user's own photo, use apply_image_template instead. Generates one or more AI images synchronously (~30s). Cost is the SELECTED model's per-image price — the default model charges 14 credits/image and prices range roughly 4–22; call list_image_models to compare costs and pick a cheaper model. Total = perImage × numberResults, returned as creditsCharged. Requires available AI credits. Pass clientRequestId for idempotent retries within 5 minutes.

generate_image

Submit an AI video generation task. Returns a taskUUID immediately; the task is processed asynchronously (BullMQ-backed). Use get_video_status to poll for completion. Credit cost is calculated from model + duration. Requires available AI credits. Supports BOTH text-to-video (default) and image-to-video — for image-to-video set type:'image-to-video' and pass inputImage (a public image URL).

generate_video

Generate cinematic AI image(s) from a scene description using camera-body / lens / focal-length / aperture combinations. Costs 14 AI credits per image (returned as creditsCharged). Requires available AI credits. To EDIT an existing image (image-to-image), use the edit_image tool instead. Pass clientRequestId for idempotent retries within 5 minutes.

generate_cinema_studio

Generate a gallery design by applying a skill to a source image (image-to-image). Synchronous ~30-45s. Costs 5 AI credits (returned as creditsCharged). Requires available AI credits. Pass clientRequestId for idempotent retries within 5 minutes. Use list_skills to discover available skill IDs.

generate_design

Fetch one curated AI-image template by id or slug. Returns preview images, title/description, hashtags and the NON-SECRET generation params (model, aspect ratio, dimensions). The prompt is intentionally withheld — apply the template by reference with apply_image_template (it loads the prompt server-side).

get_image_template

Poll a workflow App run by its runId. Returns status, progress (completed/total/percent), any error, and the final result images. Only runs owned by your team are visible.

get_app_run

Retrieve full detail for a single asset by ID. Cross-team access is rejected by the underlying service.

get_asset

Retrieve full detail for a single avatar task by taskUUID. Returns task state including generated images when complete. Cross-team access is rejected when teamId is resolved.

get_avatar

Poll an avatar task's progress. Returns a slim status snapshot (status + progress + message). Use get_avatar to retrieve full detail including generated images once complete.

get_avatar_status

Retrieve full detail for a single brand asset by ID. Cross-team access is rejected with a generic not-found (no existence-leak). Use list_brand_assets to enumerate IDs.

get_brand_asset

Retrieve full detail for a single brand profile by ID. Cross-team access is rejected with a generic not-found (no existence-leak). Use list_brand_profiles to enumerate IDs.

get_brand_profile

Retrieve full detail for a community workflow including its node graph and edges. Use list_community_workflows for browsing.

get_community_workflow

Retrieve a single AI Assistant conversation including its full message history. Cross-user/cross-team access is rejected by the underlying service.

get_conversation

Retrieve full detail for a single design by ID. Returns null-safe fields; throws if cross-team access is attempted.

get_design

Retrieve a single photo-pack category including its images. Catalog-shaped (no team scoping). Optional language code; falls back to English if the requested locale is missing.

get_photo_pack

Retrieve a pipeline (workflow canvas) by ID, scoped to the active team. Returns the full node + edge graph.

get_pipeline

Return the user's current subscription tier and per-tier quotas (storage, AI credits). aiCredits now includes purchasedBalance (one-off credit packs) alongside the monthly subscription bucket. Available on every plan (no AI credit cost). Call when the user asks 'what plan am I on?' or 'what are my limits?', or proactively before suggesting an action that might be blocked.

get_plan_limits

Return the user's plan name, billing cycle, renewal date, trial end, status, currency, and seat count. Use for 'when does my plan renew?' / 'am I on the yearly or monthly plan?' / 'when does my trial end?'. Pairs with get_plan_limits (which returns quota usage). Available on every plan (no AI credit cost).

get_plan

Poll a talking_avatar lipsync job. Returns status plus the finished video's durable CDN URL when done (the clip is persisted to storage on completion).

get_talking_avatar_status

Poll a Video Studio project's render (started by render_video_project). Returns the final MP4's durable CDN URL when done, or the render error when failed. For generate_video TASKS use get_video_status instead — this tool is for video-project composition renders.

get_video_render_status

Poll a video generation task's progress. Returns full task state including the final video URL when complete. Backed by a BullMQ queue (real async).

get_video_status

Retrieve a single whiteboard by ID, including its full content blob. Whiteboards are user-scoped (creator-only) — cross-user access is rejected with a generic not-found.

get_whiteboard

Use this when the user attached images to their message and wants DesignerBox to work on them: it saves them to their DesignerBox asset library and returns each image's url, to pass as referenceImages[].imageUrl to apply_image_template or as the image input of another DesignerBox image tool. Call it when the attached images can be passed to this tool as file inputs (each arrives as a file object with a download_url); otherwise call upload_asset so the user can pick the file. Images only (JPEG, PNG, WebP, GIF), up to 30MB each, at most 4 per call; uses the workspace's storage.

import_chat_image

Use this when the user asks about DesignerBox image templates or names one (search for it with q). Browse the curated AI-image template catalog. Returns catalog cards (id, slug, title, hashtags, preview images) — the generation prompt is intentionally NOT included. Supports search (q), hashtag filtering, sort and pagination. Use apply_image_template with an id to generate from a template.

list_image_templates

List active skills available for generate_design. Returns skillId, name, type (image|video), group, and category. Use this to discover valid skillId values before calling generate_design.

list_skills

List assets (uploaded images/videos/files) for the active team. Optionally filter by folder or MIME-type prefix. Use get_asset for full detail.

list_assets

List avatar generation tasks for the current user (user-scoped, NOT team-scoped — service signature predates team scoping). Optionally filter by status. Use get_avatar for full detail.

list_avatars

List brand assets (logos, fonts, palette swatches, etc.) for the active team. Optional filters by brand profile, file type, category, tags, or free-text search. Distinct from brand profiles — these are the binary asset library.

list_brand_assets

List all brand profiles for the active team. The active profile is the one applied to AI-driven content generation. Use update_brand_profile to patch the active one.

list_brand_profiles

List published community workflows. Filter by category, sort by popular/recent/views, and scope to mine/team/all. Use get_community_workflow for the full graph definition.

list_community_workflows

List the user's AI Assistant chat conversations for the active team. Optional status filter (active/archived) and tag filter. Use get_conversation for full message history.

list_conversations

List designs for the active team, paginated. Optionally filter by search term. Use get_design for full detail on a specific item.

list_designs

List all folders for the active team. Folders organise designs into a hierarchy. Returns flat list; parentId links to parent folder.

list_folders

List the active team+user's AI gallery assets (generated via generate_design). Pagination + optional category filter. Returns a slim shape — assetId, assetUrl, slug, displayName, galleryCategory, createdAt — to keep payloads small.

list_galleries

List the AI image models available for generate_image / edit_image, with each model's id, capabilities, supported aspect ratios, and per-image credit cost, plus the `looks` (ad-grade people-and-styling presets) those tools accept as `look`. Use this to pick a model and a look before generating. Optionally filter the models by capability or category.

list_image_models

List available photo pack categories. Photo packs are curated image collections usable in design generation. Accepts an optional language code for localised names.

list_photo_packs

List pipelines (workflow canvases) for the active team. Returns slim shape with node counts; use get_pipeline for the full graph.

list_pipelines