gentoo_action_approve
ChatGPTApprove and publish an Action to the live store. Requires expectedReviewFingerprint (or approvalViewFingerprint) from gentoo_action_preview and explicit user confirmation.
gentoo_action_get
ChatGPTGet the version state, version history, and revision progress of one Action.
gentoo_action_list
ChatGPTList Actions as short summaries (name, status, credits, dates, linked opportunities), 25 per page; pass nextCursor for more. statusCounts gives the count of every status, so counting needs no paging. Cancelled Actions are hidden unless status asks for them. Use gentoo_action_preview for the Before/After change, credit cost and approval fingerprint, and gentoo_action_get for version history.
gentoo_action_pause
ChatGPTDecline a pending Action so it is not published. Confirm with the merchant first.
gentoo_action_preview
ChatGPTInspect the Before/After preview comparison, capture URLs, credit cost, approvalViewFingerprint (reviewFingerprint), and live preview URL for an Action before approval.
gentoo_action_restore
ChatGPTRestore an Action to the revision before the latest merchant correction. This replaces the current draft.
gentoo_action_rollback
ChatGPTRoll back a deployed Action on the live store (mode defaults to safe_only).
gentoo_action_rollback_preview
ChatGPTPreview what rolling back a deployed Action on the live store would restore (clean, already_restored, drifted, unverifiable).
gentoo_chat_ask
ChatGPTSend a message to the Gentoo chat. Each call sends a new message, so a retry sends it again. Returns turn_id and session_id right away, not the answer: Gentoo replies in the background, so read the reply with gentoo_chat_sessions(sessionId, turnId, waitSeconds: 20), repeating if it is not there yet. To attach an image or file (at most 5), upload it first with gentoo_chat_attachment_prepare_upload and pass the returned s3Key in attachments. A key can be reused across ordinary conversations. An Action's conversation (sessionId starting with action-) shares keys with no other conversation; if Gentoo says the attachment belongs to a different conversation, upload the file again.
gentoo_chat_attachment_get
ChatGPTShow a chat image or file by its s3_key (from gentoo_chat_sessions history). Returns the image inline when it is under 5MB, plus a 5-minute download URL.
gentoo_chat_attachment_prepare_upload
ChatGPTPrepare an upload of a local file for the Gentoo chat (images: png, jpeg, webp, gif; also pdf, csv, txt). This tool does not upload the file: it returns an s3Key and a curl command that is valid for 5 minutes. Run the curl command with the local file path from a shell, then pass {s3Key, mediaType, filename} in gentoo_chat_ask attachments. Without a shell, ask the merchant to attach the file in the Gentoo app instead.
gentoo_chat_inbox
ChatGPTGet Home inbox items, recommendations, and recent activity from Gentoo.
gentoo_chat_sessions
ChatGPTList Gentoo conversation sessions, or fetch the messages of one sessionId as the merchant sees them in the chat (text, attachments, cards, errors). Images appear as s3_key; show them with gentoo_chat_attachment_get.
gentoo_credit_history
ChatGPTList credit ledger transactions (charges, refunds, grants).
gentoo_credit_status
ChatGPTGet current billing cycle credit balance, plan allowance, and status.
gentoo_credit_usage
ChatGPTGet credit usage breakdown for the current cycle.
gentoo_goal_current
ChatGPTGet the current active Store Goal including objective, metric, direction, scope, and rationale.
gentoo_goal_history
ChatGPTList historical Store Goals for the current store.
gentoo_goal_metric_select
ChatGPTChoose the metric a new Store Goal should target. Required before gentoo_goal_propose; it does not change the current Goal. Replaces any metric chosen earlier for the next proposal. Metrics: sessions (organic search sessions), add_to_cart_rate, checkout_start_rate, purchase_conversion_rate, online_aov (average order value), bounce_rate.
gentoo_goal_proposal
ChatGPTPoll or retrieve a generated Store Goal proposal by generationId.
gentoo_goal_propose
ChatGPTStart a Store Goal proposal generation based on merchant input. Call gentoo_goal_metric_select first with the same expectedGoalId; without a chosen metric this fails with 409. Returns generationId; generation usually takes 1 to 3 minutes, so call gentoo_goal_proposal with waitSeconds: 20 until it is no longer running. Nothing changes until gentoo_goal_select.
gentoo_goal_select
ChatGPTConfirm and activate a proposed Store Goal candidate. Replaces the current Goal and resets open Opportunities.
gentoo_opportunity_decline
ChatGPTDecline an Opportunity so Gentoo stops preparing changes for it. Confirm with the merchant first.
gentoo_opportunity_get
ChatGPTGet full detail for one Opportunity: the issue found, the linked Actions, version history, and preparation progress.
gentoo_opportunity_list
ChatGPTList Gentoo-initiated Opportunities and summary counts (active, published, closed).
gentoo_performance_summary
ChatGPTRead the Performance tab for the current Goal or an earlier Goal period: Overall (the Goal metric and funnel since the Goal started, compared with the weeks before), notes on these numbers, Changes during this Goal, and Week by week for each funnel metric. These are observed store-level numbers: say how a metric moved and whether that is in the Goal direction, but never say an action or Gentoo caused a change, never estimate the share of one action, and do not call the Goal achieved or failed. Without goalId it reads the current Goal; pass an id from goals to read an earlier Goal period. Each Week by week row shows the Goal's own scope and lists its other scopes; pass one scope key to include that scope's weekly series.
gentoo_shop_deploy_mode_get
ChatGPTGet the current store deploy mode (manual or auto).
gentoo_shop_deploy_mode_set
ChatGPTSwitch the store between manual and auto deploy mode. In manual mode every Action waits for the merchant's approval. In auto mode Gentoo publishes eligible Actions to the live store without a separate approval for each one, and this also applies to Actions that are already waiting. Only call this after the merchant explicitly confirms the change in the current conversation.
gentoo_shop_email_prefs_get
ChatGPTGet recurring approval reminder email preferences and delivery timezone.
gentoo_shop_email_prefs_set
ChatGPTUpdate the approval reminder email preference or its delivery timezone (IANA). This replaces the current setting.
gentoo_shop_info
ChatGPTGet store profile, subscription status, and notification recipient info.