AutoShot

Read an existing photo by its exact processing-job ID or a photo ID returned by list_recent_photos, waiting up to 20 seconds for completion. Data only: no card, new processing or credit charge. While queued/processing, check again later without resubmitting. After every job in the run reaches success/error, call show_photo_result once with all of their jobs and presentation labels to display one card, unless the run is already displayed. For a single photo, the id form also works. An error job refunds the reserved credit; a status retrieval error does not imply a refund.

get_photo_processing_status

Create a short-lived PUT upload for one vehicle photo in the connected chat. PUT the raw image bytes to upload_url with Content-Type set to content_type, then pass path to start_photo_processing as source_path. Image bytes never go in this tool call. Do not pass upload_url or any other URL you chose to start_photo_processing. Does not reserve a credit. JPEG, PNG, or WebP up to 25 MiB.

create_photo_upload

Show the single integrated settings/background picker. It is the same picker as list_studio_backgrounds: use this tool once for a settings request, never both tools or a separate native form. Only its five canonical preview assets may illustrate backgrounds. Named chat choices remain valid. Call this in the user-facing main conversation; a worker or subagent cannot display this card in the parent conversation. Show the getting-started card for AutoShot-related greetings, first-use help or unclear AutoShot setup requests. Use this when someone asks what AutoShot can do, how to get started, how to process a photo or add a logo, or why an action is unavailable, and when they want to change a background or plate preference. Selection is temporary until an explicit account save succeeds. If a guide card is already shown, do not call again just to repeat the capabilities; answer briefly instead. Explains the current capabilities of the connected chat, suggested prompts and website steps. Use the returned currentSettings for account-specific logo or plate advice; another preference read is unnecessary. Keep get_photo_preferences for headless processing checks. Do not call this guide during a reply that processes or displays photos; reserve that reply for the result card.

get_autoshot_guide

Headless saved-settings read for processing confirmation and account-specific checks; it creates no card. For a user asking to see settings, browse or select backgrounds, call get_autoshot_guide OR list_studio_backgrounds once to show the single integrated picker. Never add a separate native form, searched/generated illustration or substitute preview. backgroundTitle identifies the exact saved catalog asset; backgroundPreviewUrl is returned only to non-card clients because the picker embeds its previews. Plate treatment applies only when a clear plate is detected and is not guaranteed.

get_photo_preferences

Use this to retrieve the connected account’s processed AutoShot photos from the last seven days. Returned photo IDs can be passed unchanged to show_photo_result or get_photo_processing_status to reopen existing results without processing or charges. Download links expire after one hour; call again for fresh links.

list_recent_photos

Show the single integrated AutoShot background/settings picker in the user-facing main conversation. It is the same picker as get_autoshot_guide: use either tool once, never both for one request. Its five canonical previews are the only background images; do not add generated/searched illustrations, separate images or a native selection form. Selection stays temporary until Save to account; Process applies per-run choices. Non-card hosts receive the genuine JPEG previews. Do not show it in a processing/result reply.

list_studio_backgrounds

Replace the background of one vehicle photo from the connected chat. Uses ONE existing AutoShot credit; explain this cost before starting. Pass the host file object when the connected chat attached one, or source_path from create_photo_upload. Never pass a URL you chose and never inline image bytes. Uses the saved background, plate treatment and dealer logo. Pass background or plate_mode only when the latest user request names a different choice for this run; they apply to this photo only, never change saved defaults, and logo plates need a saved logo. Explain the background, logo, plate treatment and total credit cost before starting. Interiors keep their cabin view, receive no dealer-logo stamp and may show limited changes; ask whether to include them before charging. For multiple photos, pass presentation with fileName, index and total to label each result. Up to ten photos may be in flight per account: start every approved file right away; only after a busy answer wait for existing jobs before starting the rest. Requires photos:process consent. Returns a durable job id without creating a card; reused true means an earlier job for the same file and settings was returned and no new credit was used. Poll get_photo_processing_status on that exact id until terminal; once every photo of the run is terminal, call show_photo_result once with all of their jobs. Never submit again while queued or successful. For an intentional rerun of the same file/background only, supply a new request_id.

start_photo_processing

Only use when the user explicitly asks to save account defaults or clicks Save to account. Save the selected studio background and plate treatment for future photos across AutoShot. This is free and does not process a photo, upload a logo or spend credits. Requires preferences:write consent. Do not call for a per-photo selection or a refresh.

save_photo_preferences

Interactive cards must be displayed by a tool call in the user-facing main conversation. If processing is delegated to a worker or subagent, it must return the exact ordered job IDs, presentation labels, actual settings and charged/reused outcomes; the main assistant must call show_photo_result itself. A subagent tool result does not display a card in the parent conversation. Never claim a card is visible based only on a worker report. Display ONE inline result card for a whole run. Accepts processing-job IDs and photo IDs returned by list_recent_photos. Pass every terminal job of the run in jobs, in photo order with the same presentation labels (up to 10; the single id form is for one photo). The connected chat may show only one card per reply, so call this once per reply, never once per photo. Call it after get_photo_processing_status reports success or error for the jobs. This only reads the connected account's existing jobs: it never starts processing or charges credits. Do not repeat it for photos already displayed unless the user asks to reopen them. The card provides each full resolution download; do not duplicate or rewrite those links. Hosts without UI should display returned images through native image output or direct the user to AutoShot website history; they also receive a full-resolution download link for each successful photo in the result.

show_photo_result