gravity-cli 0.5.2__tar.gz → 0.5.3__tar.gz

{gravity_cli-0.5.2 → gravity_cli-0.5.3}/AGENT_STANDARD.md

@@ -202,6 +202,26 @@ emb = OpenAIEmbeddings(model="voyageai/voyage-4-lite",   # or google/gemini-embe
 vectors = await emb.aembed_documents(["first text", "second text"])
 ```
 
+**Images** come from an image model through the same URL and token: no tool to
+declare. Ask for image output; the picture comes back as a data URL, which is
+exactly what the corpus takes (§8):
+
+```python
+async with httpx.AsyncClient(timeout=120) as http:
+    resp = await http.post(f"{os.environ['GRAVITY_LLM_URL']}/chat/completions",
+        headers={"Authorization": f"Bearer {os.environ['GRAVITY_RUN_TOKEN']}"},
+        json={"model": "google/gemini-2.5-flash-image",   # or openai/gpt-5-image-mini
+              "modalities": ["image", "text"],
+              "messages": [{"role": "user", "content": "A flat illustration of ..., no text"}]})
+    resp.raise_for_status()
+    src = resp.json()["choices"][0]["message"]["images"][0]["image_url"]["url"]   # data:image/png;base64,...
+```
+
+An image is a few MB and the whole state is checkpointed after every step, so
+make pictures in the **last** node (or the one that builds the corpus) and keep
+them out of state until then. Each one is metered and counts toward the run's
+budget like any model call.
+
 Those three env vars — `GRAVITY_GATEWAY_URL`, `GRAVITY_LLM_URL`,
 `GRAVITY_RUN_TOKEN` — are the entire Gravity surface, plus the `gravity`
 package for tools on the platform (§8). No `OPENAI_API_KEY`: locally and in
@@ -228,6 +248,11 @@ undeclared tool is refused locally exactly as it will be when hosted. Your
 agent only ever sees the run token. `GRAVITY_GATEWAY_URL` defaults to
 `http://127.0.0.1:8000/mcp` and `GRAVITY_LLM_URL` to the same host's `/v1`.
 
+`gravity dev` opens a local dashboard over the same runs: a form from your
+manifest, a live timeline, approvals, the result and a history. A run from
+`gravity run` in the same folder shows up in it, and the other way round (both
+leave their record in `.gravity/runs/`; one run is live per folder).
+
 ## 7. What's checked where
 
 | Stage | Catches |
@@ -328,6 +353,7 @@ corpus = gravity.Corpus(
         facts=[gravity.Fact(label="TAM", value="$18B", source="s1")],   # value: text or a number
         table=gravity.Table(columns=["Segment", "Teams"], rows=[["Founders", "1.2M"]]),
         notes="speaker notes / read-out text",
+        images=[gravity.Image(src=src, alt="server rack", caption="Option A")],   # data URL, see §4
         sections=[gravity.Section(heading="one level of nesting, same shape")],
     )],
     sources=[gravity.Source(id="s1", title="Report", url="https://example.com")],
@@ -336,7 +362,10 @@ return {**corpus.to_state(), "result": {"title": corpus.title}}
 ```
 
 A plain dict of the same shape works too. The models catch a typo when the
-corpus is built rather than when it's rendered. Set `result` as well: it's
+corpus is built rather than when it's rendered. Images (`png`, `jpeg`, `webp`
+or `gif` data URLs, at most 8 MB each and 12 per corpus) are embedded in the
+Word, PowerPoint and Markdown downloads and shown on `/app` and in `gravity
+dev`; an emailed output names each one as `[image: alt — caption]` instead. Set `result` as well: it's
 what the run returns.
 
 ## 9. Checklist

gravity_cli-0.5.2/README.md → gravity_cli-0.5.3/PKG-INFO

@@ -1,3 +1,20 @@
+Metadata-Version: 2.5
+Name: gravity-cli
+Version: 0.5.3
+Summary: gravity cli — init, run, and push python agents to the Gravity marketplace
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Requires-Python: >=3.12
+Requires-Dist: gravity-schema==0.5.3
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.9.0
+Requires-Dist: typer>=0.15.0
+Requires-Dist: uv>=0.8.0
+Description-Content-Type: text/markdown
+
 <h1 align="center">Gravity CLI</h1>
 
 <p align="center">
@@ -179,6 +196,7 @@ Run `gravity help` for this list in the terminal, and add `-h` to any command fo
 | **Build an agent** | [`gravity init`](#gravity-init) | Create a new agent from a template |
 | | [`gravity validate`](#gravity-validate) | Check your agent for mistakes before it runs |
 | | [`gravity run`](#gravity-run) | Run your agent locally against real tools |
+| | [`gravity dev`](#gravity-dev) | Open a local dashboard to run and watch your agent |
 | | [`gravity schedule`](#gravity-schedule) | Run your agent on its schedule, locally |
 | | [`gravity adapt`](#gravity-adapt) | Write a new slot adapter with AI, kept only if its tests pass |
 | **Publish** | [`gravity build`](#gravity-build) | Package your agent into `build/agent.zip` |
@@ -274,6 +292,29 @@ gravity run --reply "make it shorter"
 - Requires a gateway token: the one `gravity login` stores, or `GRAVITY_DEV_TOKEN`.
 - A call to a tool in `approvals.required_for` pauses, shows what it would do, and waits for `y` or `n`. With no terminal to ask in, it is rejected.
 - Exits with code 0 when the run finishes and 1 when it fails.
+- Leaves a record in `.gravity/runs/<id>/` (`run.json` and `events.jsonl`), which is what `gravity dev` reads. One run is live per folder at a time, because runs share the folder's memory, store and thread files.
+
+### `gravity dev`
+
+Open a local dashboard for the agent in this folder: a form built from the manifest's inputs, a live timeline of each step, model call and tool call, approval buttons for held calls, the result, and a history of runs.
+
+```
+gravity dev [path] [--port 4747] [--no-open] [--llm-url URL]
+```
+
+| Option | Description |
+|---|---|
+| `--port N` | Port to listen on (default 4747). If it is taken, a free one is used and printed. |
+| `--no-open` | Print the address without opening a browser (SSH, WSL, CI) |
+| `--llm-url URL` | Model endpoint to use instead of `GRAVITY_LLM_URL` |
+
+- A run from `gravity run` in the same folder shows up in the dashboard live, and a run started in the dashboard is the same run (same engine, same memory, store and thread files), so `gravity run --reply` continues it.
+- It listens on `127.0.0.1` only, behind a random token in the printed address, for as long as the command runs. Ctrl+C stops it and any run it started. Nothing keeps running in the background.
+- Connected accounts: it shows the accounts your tools need and a Connect button for each one that is missing.
+- Approvals: a call held for approval can be decided in the terminal or in the dashboard; whichever answers first wins.
+- Cancel a run from the dashboard only if the dashboard started it; stop a terminal run with Ctrl+C in that terminal.
+- Results show as text. Word, PowerPoint and CSV files are produced by Gravity after you push. A file input is read as text here.
+- Same requirements as `gravity run`: a gateway token from `gravity login`, or `GRAVITY_DEV_TOKEN`.
 
 ### `gravity schedule`
 
@@ -738,6 +779,7 @@ Real tools act on a connected account. Connect one with `gravity-gateway connect
 
 ## What's new
 
+- **0.5.3** `gravity dev` opens a local dashboard for your agent: a form from your manifest, a live timeline, approvals, the result and run history; runs from `gravity run` in the same folder show up in it live, and the other way round. WhatsApp joins the catalog (51 tools; 1,374 across 12 apps). Agents can return generated images: put them in a corpus section's `images` and they land in the Word, PowerPoint and Markdown outputs. The agent standard now shows how to generate images and embeddings through the gateway. `NEEDS_RECONNECT` on the shared test account tells you to ask Gravity, not to connect your own account.
 - **0.5.2** Jira, Confluence and Notion join the catalog: 1,351 tools across 11 apps. `get_store()` works in local runs, kept in `.gravity/store.json`. Renewing an expired sign-in keeps your gateway token, so `gravity run` keeps working after an hour. Commands start faster: the catalog loads in a quarter of the time.
 - **0.5.0** `gravity connect` links your own accounts. `web.search` and `web.fetch` join the catalog. `gravity validate` now refuses a tool that isn't in the catalog, an imported write tool without an approval, and code that names a write tool the manifest doesn't grant. `gravity tools` reads the gateway's list and needs no sign-in. On Windows the session stays in the keychain instead of a file.
 - **0.4.4** Same code as 0.4.3, released from this repository so the GitHub release, the tag and PyPI line up again. Adds `RELEASING.md`.

gravity_cli-0.5.2/PKG-INFO → gravity_cli-0.5.3/README.md

@@ -1,20 +1,3 @@
-Metadata-Version: 2.5
-Name: gravity-cli
-Version: 0.5.2
-Summary: gravity cli — init, run, and push python agents to the Gravity marketplace
-License-Expression: Apache-2.0
-License-File: LICENSE
-License-File: NOTICE
-Requires-Python: >=3.12
-Requires-Dist: gravity-schema==0.5.2
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: keyring>=25.0.0
-Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: rich>=13.9.0
-Requires-Dist: typer>=0.15.0
-Requires-Dist: uv>=0.8.0
-Description-Content-Type: text/markdown
-
 <h1 align="center">Gravity CLI</h1>
 
 <p align="center">
@@ -196,6 +179,7 @@ Run `gravity help` for this list in the terminal, and add `-h` to any command fo
 | **Build an agent** | [`gravity init`](#gravity-init) | Create a new agent from a template |
 | | [`gravity validate`](#gravity-validate) | Check your agent for mistakes before it runs |
 | | [`gravity run`](#gravity-run) | Run your agent locally against real tools |
+| | [`gravity dev`](#gravity-dev) | Open a local dashboard to run and watch your agent |
 | | [`gravity schedule`](#gravity-schedule) | Run your agent on its schedule, locally |
 | | [`gravity adapt`](#gravity-adapt) | Write a new slot adapter with AI, kept only if its tests pass |
 | **Publish** | [`gravity build`](#gravity-build) | Package your agent into `build/agent.zip` |
@@ -291,6 +275,29 @@ gravity run --reply "make it shorter"
 - Requires a gateway token: the one `gravity login` stores, or `GRAVITY_DEV_TOKEN`.
 - A call to a tool in `approvals.required_for` pauses, shows what it would do, and waits for `y` or `n`. With no terminal to ask in, it is rejected.
 - Exits with code 0 when the run finishes and 1 when it fails.
+- Leaves a record in `.gravity/runs/<id>/` (`run.json` and `events.jsonl`), which is what `gravity dev` reads. One run is live per folder at a time, because runs share the folder's memory, store and thread files.
+
+### `gravity dev`
+
+Open a local dashboard for the agent in this folder: a form built from the manifest's inputs, a live timeline of each step, model call and tool call, approval buttons for held calls, the result, and a history of runs.
+
+```
+gravity dev [path] [--port 4747] [--no-open] [--llm-url URL]
+```
+
+| Option | Description |
+|---|---|
+| `--port N` | Port to listen on (default 4747). If it is taken, a free one is used and printed. |
+| `--no-open` | Print the address without opening a browser (SSH, WSL, CI) |
+| `--llm-url URL` | Model endpoint to use instead of `GRAVITY_LLM_URL` |
+
+- A run from `gravity run` in the same folder shows up in the dashboard live, and a run started in the dashboard is the same run (same engine, same memory, store and thread files), so `gravity run --reply` continues it.
+- It listens on `127.0.0.1` only, behind a random token in the printed address, for as long as the command runs. Ctrl+C stops it and any run it started. Nothing keeps running in the background.
+- Connected accounts: it shows the accounts your tools need and a Connect button for each one that is missing.
+- Approvals: a call held for approval can be decided in the terminal or in the dashboard; whichever answers first wins.
+- Cancel a run from the dashboard only if the dashboard started it; stop a terminal run with Ctrl+C in that terminal.
+- Results show as text. Word, PowerPoint and CSV files are produced by Gravity after you push. A file input is read as text here.
+- Same requirements as `gravity run`: a gateway token from `gravity login`, or `GRAVITY_DEV_TOKEN`.
 
 ### `gravity schedule`
 
@@ -755,6 +762,7 @@ Real tools act on a connected account. Connect one with `gravity-gateway connect
 
 ## What's new
 
+- **0.5.3** `gravity dev` opens a local dashboard for your agent: a form from your manifest, a live timeline, approvals, the result and run history; runs from `gravity run` in the same folder show up in it live, and the other way round. WhatsApp joins the catalog (51 tools; 1,374 across 12 apps). Agents can return generated images: put them in a corpus section's `images` and they land in the Word, PowerPoint and Markdown outputs. The agent standard now shows how to generate images and embeddings through the gateway. `NEEDS_RECONNECT` on the shared test account tells you to ask Gravity, not to connect your own account.
 - **0.5.2** Jira, Confluence and Notion join the catalog: 1,351 tools across 11 apps. `get_store()` works in local runs, kept in `.gravity/store.json`. Renewing an expired sign-in keeps your gateway token, so `gravity run` keeps working after an hour. Commands start faster: the catalog loads in a quarter of the time.
 - **0.5.0** `gravity connect` links your own accounts. `web.search` and `web.fetch` join the catalog. `gravity validate` now refuses a tool that isn't in the catalog, an imported write tool without an approval, and code that names a write tool the manifest doesn't grant. `gravity tools` reads the gateway's list and needs no sign-in. On Windows the session stays in the keychain instead of a file.
 - **0.4.4** Same code as 0.4.3, released from this repository so the GitHub release, the tag and PyPI line up again. Adds `RELEASING.md`.

{gravity_cli-0.5.2 → gravity_cli-0.5.3}/packages/gravity-schema/gravity_schema/catalog_imported.yaml

@@ -13156,3 +13156,481 @@
   breadth: generic
   guarantee: experimental
   side_effect: read
+- name: whatsapp.configure_conversational_automation
+  slug: WHATSAPP_CONFIGURE_CONVERSATIONAL_AUTOMATION
+  toolkit: whatsapp
+  description: Configure conversational automation settings for a WhatsApp Business phone number. Sets up away messages, greeting messages, custom commands, and ice breaker prompts to automate customer interactions....
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_flow
+  slug: WHATSAPP_CREATE_FLOW
+  toolkit: whatsapp
+  description: Create a new WhatsApp Flow for the WhatsApp Business Account. Use this action when you want to create an interactive flow that can collect user data, guide users through a process, or provide structur...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_max_price_agreements
+  slug: WHATSAPP_CREATE_MAX_PRICE_AGREEMENTS
+  toolkit: whatsapp
+  description: Create a max price agreement for WhatsApp marketing messages pricing. Max price agreements set a ceiling on the per-conversation price you'll pay for WhatsApp messaging across your WhatsApp Business A...
+  scopes:
+  - business_management
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_message_template
+  slug: WHATSAPP_CREATE_MESSAGE_TEMPLATE
+  toolkit: whatsapp
+  description: Create a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used. Templates are required for marketing messages and messages sent outside...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_qr_code
+  slug: WHATSAPP_CREATE_QR_CODE
+  toolkit: whatsapp
+  description: Create a new QR code with a prefilled message for a WhatsApp Business phone number. Use this action when you need to generate a shareable QR code that customers can scan to start a conversation with y...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.create_upload_session
+  slug: WHATSAPP_CREATE_UPLOAD_SESSION
+  toolkit: whatsapp
+  description: Create a resumable upload session for large file uploads to WhatsApp. This action initiates an upload session that allows you to upload large files in chunks. First create a session, then use the sess...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.get_activities
+  slug: WHATSAPP_GET_ACTIVITIES
+  toolkit: whatsapp
+  description: Retrieve activity history for a WhatsApp Business Account. This action returns a paginated list of activities such as phone number verifications, user additions, and other administrative actions perfo...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_account_details
+  slug: WHATSAPP_GET_BUSINESS_ACCOUNT_DETAILS
+  toolkit: whatsapp
+  description: Retrieve comprehensive details about a WhatsApp Business Account (WABA). Returns configuration, status, and settings information including account review status, business verification status, timezone...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_compliance_info
+  slug: WHATSAPP_GET_BUSINESS_COMPLIANCE_INFO
+  toolkit: whatsapp
+  description: Retrieve comprehensive business compliance information for a WhatsApp Business phone number. Returns regulatory and compliance details including entity registration status, grievance officer contact i...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_encryption
+  slug: WHATSAPP_GET_BUSINESS_ENCRYPTION
+  toolkit: whatsapp
+  description: Retrieve the WhatsApp Business public key and its signature verification status. Use this action when you need to obtain the end-to-end encryption public key for a WhatsApp Business phone number. This...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_business_profile
+  slug: WHATSAPP_GET_BUSINESS_PROFILE
+  toolkit: whatsapp
+  description: Get the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_client_business_accounts
+  slug: WHATSAPP_GET_CLIENT_BUSINESS_ACCOUNTS
+  toolkit: whatsapp
+  description: Retrieve WhatsApp Business Accounts shared with or managed by a business portfolio. Use this action when you need to get WhatsApp Business Accounts (WABAs) that are client accounts shared with or mana...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_commerce_settings
+  slug: WHATSAPP_GET_COMMERCE_SETTINGS
+  toolkit: whatsapp
+  description: Get commerce settings for a WhatsApp Business phone number. Retrieves cart and catalog visibility settings for a specific WhatsApp Business phone number. Use this action to check whether shopping cart...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_flow_assets
+  slug: WHATSAPP_GET_FLOW_ASSETS
+  toolkit: whatsapp
+  description: List assets associated with a WhatsApp Flow. Use this action when you need to retrieve the assets (such as flow.json) that are associated with a WhatsApp Flow. The response includes download URLs for...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_join_requests
+  slug: WHATSAPP_GET_JOIN_REQUESTS
+  toolkit: whatsapp
+  description: Get all pending join requests for a WhatsApp group. Use this action when you need to retrieve pending requests from users who want to join a WhatsApp group. This is useful for group administration, mo...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_media_info
+  slug: WHATSAPP_GET_MEDIA_INFO
+  toolkit: whatsapp
+  description: Get metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size. The download URL can be used to retrieve the act...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_message_history
+  slug: WHATSAPP_GET_MESSAGE_HISTORY
+  toolkit: whatsapp
+  description: Retrieve message history for a WhatsApp Business phone number. Returns a paginated list of messages with their delivery status information, including events like delivery status updates, timestamps, a...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_message_templates
+  slug: WHATSAPP_GET_MESSAGE_TEMPLATES
+  toolkit: whatsapp
+  description: Get all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_owned_business_accounts
+  slug: WHATSAPP_GET_OWNED_BUSINESS_ACCOUNTS
+  toolkit: whatsapp
+  description: Retrieve WhatsApp Business Accounts owned by a business portfolio. Use this action when you need to get all WhatsApp Business Accounts (WABAs) that are directly owned by a specific business. This diff...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_phone_number
+  slug: WHATSAPP_GET_PHONE_NUMBER
+  toolkit: whatsapp
+  description: Retrieve detailed information about a specific WhatsApp Business phone number. Returns phone number details including verification status, quality rating, display number, verified business name, throu...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_phone_numbers
+  slug: WHATSAPP_GET_PHONE_NUMBERS
+  toolkit: whatsapp
+  description: Retrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits. Use the phone...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_schedules
+  slug: WHATSAPP_GET_SCHEDULES
+  toolkit: whatsapp
+  description: Retrieve campaign schedules associated with a WhatsApp Business Account. Use this action when you need to list all scheduled campaigns for a WABA, including their status, timing, and recurrence patter...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_settings
+  slug: WHATSAPP_GET_SETTINGS
+  toolkit: whatsapp
+  description: Get Cloud API settings for a WhatsApp Business phone number. Retrieves calling, storage, and payload encryption settings for a specific WhatsApp Business phone number. This includes information about...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_subscribed_apps
+  slug: WHATSAPP_GET_SUBSCRIBED_APPS
+  toolkit: whatsapp
+  description: Get all applications currently subscribed to webhooks for a WhatsApp Business Account. Use this action when you need to retrieve the list of third-party applications or integrations that are subscribe...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_template_library
+  slug: WHATSAPP_GET_TEMPLATE_LIBRARY
+  toolkit: whatsapp
+  description: Browse the pre-built message template library for WhatsApp Business Account. This retrieves a list of available templates that can be used for messaging. Use when you need to discover available messag...
+  scopes:
+  - whatsapp_business_messaging
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.get_template_status
+  slug: WHATSAPP_GET_TEMPLATE_STATUS
+  toolkit: whatsapp
+  description: Get the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_flows
+  slug: WHATSAPP_LIST_FLOWS
+  toolkit: whatsapp
+  description: List all WhatsApp Flows associated with the WhatsApp Business Account. Returns flow details including name, status, categories, and any validation errors. Use when you need to retrieve all available f...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_groups
+  slug: WHATSAPP_LIST_GROUPS
+  toolkit: whatsapp
+  description: List all WhatsApp groups associated with a business phone number. Use this action when you need to retrieve the list of groups that a business phone number is a member of. This is useful for managing...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_qr_codes
+  slug: WHATSAPP_LIST_QR_CODES
+  toolkit: whatsapp
+  description: Get a list of all QR codes for a WhatsApp Business phone number. Use this action when you need to retrieve all message QR codes associated with a specific WhatsApp Business phone number. This is usefu...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.list_solutions
+  slug: WHATSAPP_LIST_SOLUTIONS
+  toolkit: whatsapp
+  description: Retrieve a paginated list of Multi-Partner Solutions for a WhatsApp Business Account. Use when you need to view all multi-partner solutions (such as SMB solutions) associated with a WABA, including th...
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: read
+- name: whatsapp.publish_flow
+  slug: WHATSAPP_PUBLISH_FLOW
+  toolkit: whatsapp
+  description: Publish a WhatsApp Flow to make it available for use. Use this action when you have finished designing and testing a WhatsApp Flow and are ready to make it available for users. The flow must be in DRA...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.register_phone
+  slug: WHATSAPP_REGISTER_PHONE
+  toolkit: whatsapp
+  description: Register a WhatsApp Business phone number for use with WhatsApp Cloud API. Use when you need to register a phone number that has been added to your WhatsApp Business Account. This action requires sett...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_contacts
+  slug: WHATSAPP_SEND_CONTACTS
+  toolkit: whatsapp
+  description: 'Send contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_interactive_buttons
+  slug: WHATSAPP_SEND_INTERACTIVE_BUTTONS
+  toolkit: whatsapp
+  description: Send an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons. Perfect for yes/no ques...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_interactive_list
+  slug: WHATSAPP_SEND_INTERACTIVE_LIST
+  toolkit: whatsapp
+  description: Send an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option. Perfect for product c...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_location
+  slug: WHATSAPP_SEND_LOCATION
+  toolkit: whatsapp
+  description: Send a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API. The location message includes latitu...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_media
+  slug: WHATSAPP_SEND_MEDIA
+  toolkit: whatsapp
+  description: 'Send a media message to a WhatsApp number. Note: The media will be delivered to the recipient only if they have texted first.'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_media_by_id
+  slug: WHATSAPP_SEND_MEDIA_BY_ID
+  toolkit: whatsapp
+  description: Send media using a media ID from previously uploaded media. This is more efficient than sending media by URL as the media is already on WhatsApp servers. Use upload_media action first to get the media...
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_message
+  slug: WHATSAPP_SEND_MESSAGE
+  toolkit: whatsapp
+  description: 'Send a text message to a WhatsApp user. Important: The recipient phone number must be registered on WhatsApp and must have initiated a conversation with your business within the last 24 hours, OR you...'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.send_template_message
+  slug: WHATSAPP_SEND_TEMPLATE_MESSAGE
+  toolkit: whatsapp
+  description: Send a template message to a WhatsApp number.
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.set_two_step_verification
+  slug: WHATSAPP_SET_TWO_STEP_VERIFICATION
+  toolkit: whatsapp
+  description: Set or reset the two-step verification PIN for a WhatsApp Business phone number. Use when you need to change the 6-digit PIN that protects a registered phone number — for example after onboarding a ne...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.subscribe_app
+  slug: WHATSAPP_SUBSCRIBE_APP
+  toolkit: whatsapp
+  description: Subscribe your application to receive webhook notifications for a WhatsApp Business Account (WABA). This action registers the application to receive webhook events from the specified WABA. Use this ac...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_business_account
+  slug: WHATSAPP_UPDATE_BUSINESS_ACCOUNT
+  toolkit: whatsapp
+  description: Update metadata for a WhatsApp Flow including its name, categories, and endpoint URI. Use when you need to modify the configuration or settings of an existing WhatsApp Flow.
+  scopes:
+  - whatsapp_business_management
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_business_profile
+  slug: WHATSAPP_UPDATE_BUSINESS_PROFILE
+  toolkit: whatsapp
+  description: Update WhatsApp Business Profile information including business details, contact information, and profile settings. Use when you need to modify the business profile settings such as the about text, bu...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_commerce_settings
+  slug: WHATSAPP_UPDATE_COMMERCE_SETTINGS
+  toolkit: whatsapp
+  description: Set or update commerce settings for a WhatsApp Business phone number. Use this action to enable or disable shopping cart functionality and product catalog visibility for a specific WhatsApp Business p...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_flow_json
+  slug: WHATSAPP_UPDATE_FLOW_JSON
+  toolkit: whatsapp
+  description: Update the Flow JSON configuration for a WhatsApp Flow. Use this action when you need to update or upload a new flow.json file for an existing WhatsApp Flow. The Flow JSON defines the structure, scree...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.update_settings
+  slug: WHATSAPP_UPDATE_SETTINGS
+  toolkit: whatsapp
+  description: Update Cloud API settings for a WhatsApp Business phone number. Use this action to modify calling features, user identity verification settings, payload encryption configuration, and data storage pref...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.upload_media
+  slug: WHATSAPP_UPLOAD_MEDIA
+  toolkit: whatsapp
+  description: 'Upload media files (images, videos, audio, documents, stickers) to WhatsApp servers. The uploaded media gets a media ID that can be used in send_media or other messaging actions. Supported formats: -...'
+  scopes:
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.upsert_message_template
+  slug: WHATSAPP_UPSERT_MESSAGE_TEMPLATE
+  toolkit: whatsapp
+  description: Create or update a message template for the WhatsApp Business Account. Use this action when you need to create a new message template or update an existing one with the same name. If a template with t...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.verify_code
+  slug: WHATSAPP_VERIFY_CODE
+  toolkit: whatsapp
+  description: Verify the OTP code for a pre-verified phone number. Use when you need to complete phone number verification by submitting the received OTP code. The phone number must first be added to your WhatsApp...
+  scopes:
+  - whatsapp_business_management
+  - whatsapp_business_messaging
+  breadth: generic
+  guarantee: experimental
+  side_effect: write
+- name: whatsapp.who_am_i
+  slug: WHATSAPP_WHO_AM_I
+  toolkit: whatsapp
+  description: Return the identity (name) of the connected WhatsApp (Meta) account.
+  scopes: []
+  breadth: generic
+  guarantee: experimental
+  side_effect: read