Skip to content

AI Gateway Coverage

Menu Location: Kiva Tools > AI Gateway Coverage (also under AI > Setup, Kiva admins only)

Last Updated: 2026-11-19


Overview

AI Gateway Coverage is a Kiva staff reference page. It lists every admin page that the AI gateway (Connect AI / MCP) can act for on a store's behalf, when that page was added to the gateway, when its gateway tools were last brought in line with the page, and whether the page has changed since.

The gateway lets a store's own AI do work through the same writes the admin pages make. When an admin page gains a feature, its gateway tools can fall behind. This page surfaces that: a page that changed after its last sync is flagged Review, so someone can check whether the new feature needs a gateway tool.

The list lives in kiv/api/resources/_coverage.php, which is the source of truth. The page reads it and compares each covered page's last change date against its Synced date.

Primary Features

Coverage table

One row per covered admin page:

Column Meaning
Admin page The page the gateway tools stand in for. Click to open it in a new tab.
Gateway tools How many gateway tools cover this page. Hover the count for the tool names.
Added When this page was first added to the AI gateway.
Synced When this page's gateway tools were last brought in line with the page.
Page last changed The admin page file's last change: its last SVN commit where the server has a working copy, otherwise the file's modified date. An uncommitted edit note appears when the file was saved after its last commit.
Status Review = the page changed after its Synced date. Current = no page change since the last sync. Page missing = the page file was not found. n/a = a gateway tool that stands in for no admin page.
Not in the gateway What the admin page can do that the gateway still cannot.

Pages flagged Review sort to the top, and a banner counts them.

Untagged tools warning

If the gateway exposes a tool that no coverage entry claims, a red banner names each tool and its resource, with a reminder to add it to _coverage.php.

Not in the gateway yet

A collapsed section listing admin menu pages that no gateway tool covers yet. Those pages are admin only: a store's AI cannot do them and has to send the owner to the page. The table shows the menu label and the page path.

Common Use Cases

  • Checking whether a new admin feature is available to the store's AI. Find the page, read its Status and Not in the gateway column.
  • After shipping an admin page change, check whether the page now shows Review. If the change needs gateway coverage, add the tools and update the page's Synced date in _coverage.php.
  • Auditing gaps. Use the untagged banner and the "Not in the gateway yet" list to see what a store's AI still cannot do.

Troubleshooting

A page shows Review but nothing important changed: The page file was touched (or committed) after its Synced date. If its gateway tools already match, update its synced date in _coverage.php.

A page shows Page missing: The path in _coverage.php no longer matches a real file. Correct the path or remove the entry.

A gateway tool appears under "not in the coverage list": Add the tool name to the right entry's tools array in _coverage.php and set that entry's synced date to today.

The page is empty or redirects: This page is Kiva-admin only and redirects non-Kiva admins to the Kiva dashboard.

Change Log

2026-11-19

  • Coverage list updated for the shop sort controls: Shop sort (Products Settings + Store categories) (kiv/product-settings.php) added as a covered page, with the read tool plus the store-wide default sort, sold-out handling, and per-category override tools. Its "Not in the gateway" gap names what stays admin only: pinning individual products to the top of a category, which is the shop's drag-and-drop sort mode.
  • The shop sort page's "Not in the gateway" gap is now closed for pinning. Pin products to the top of a category is on the gateway: give a category and an ordered list of products (ids, or exact active names) and they take a leading sort order, first product first. The order shows under the Relevance sort; if the category (or the store) sorts another way, the response says so and how to switch it. The sort order belongs to the product, not the category, so a pinned product also leads everywhere else it appears. Each product's previous sort order comes back, but there is no one-click undo, so restoring it is a manual step in the shop's drag-and-drop sort mode. The full visual drag-reorder of a whole category stays admin only.

2026-11-16

  • This page is now also listed under AI > Setup in the admin menu, alongside the other AI setup pages, in addition to Kiva Tools.
  • Coverage list updated for the AI menu writes: Product details (kiv/add-product.php) added as a covered page (product details, menu change, apply, undo, and SEO). Products and Menu Builder now list the menu-change tools, with their "Not in the gateway" gaps rewritten to name what stays admin only (order steps, deleting, CSV / SKU imports). The "stop asking me" trust tool is listed under Gateway only (no admin page).

2026-11-15

  • Initial documentation.