@analitikisler/ai-tag-debugger 0.11.2 → 0.11.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.11.3 (2026-10-16)
+
+- `aitd` and `aitd --help` end with the AI a run would use: `AI: anthropic (claude-opus-5-5) via Cloudflare AI Gateway · also set: gemini (pick with --provider)`, or `AI: no key set`. The first line of a run names the other keys too.
+- Vercel AI Gateway: set `AI_GATEWAY_API_KEY` and pick any model it offers with `--model <provider>/<model>`, e.g. `google/gemini-3.6-flash`. The default is `anthropic/claude-opus-5.5`.
+
 ## 0.11.2 (2026-10-16)
 
 - Fix sentence requests (`aitd "check my GA tags"`) failing with a 400 "Invalid schema" error from the Anthropic API. The request schema now writes optional values in a form Anthropic, OpenAI and Gemini all accept.

package/README.md

@@ -99,6 +99,17 @@ ai-tag-debugger run --site https://yourshop.com --journey add_to_cart \
 
 Use the model id from your provider's documentation. You can also set `OPENAI_COMPATIBLE_BASE_URL` and `OPENAI_COMPATIBLE_MODEL` instead of the flags, or `"provider"`, `"base_url"` and `"model"` in the config. When the API can't return strict JSON schemas, the explanations fall back to plain JSON mode.
 
+### Vercel AI Gateway
+
+One key for many models. Set `AI_GATEWAY_API_KEY` from your Vercel dashboard and pick a model as `<provider>/<model>`:
+
+```bash
+export AI_GATEWAY_API_KEY=...
+aitd run --site https://yourshop.com --journey purchase --model google/gemini-3.6-flash
+```
+
+Without `--model` it uses `anthropic/claude-opus-5.5`. Usage and costs show in Vercel's AI Gateway dashboard and are billed by Vercel. To see which AI a run will use, run `aitd`: the last line says, for example, `AI: vercel (anthropic/claude-opus-5.5) · also set: anthropic (pick with --provider)`.
+
 ### Cloudflare AI Gateway
 
 To see logs, costs and rate limits for every AI call, send them through [Cloudflare AI Gateway](https://developers.cloudflare.com/ai-gateway/). Your provider key stays the same:

package/README.tr.md

@@ -99,6 +99,17 @@ ai-tag-debugger run --site https://yourshop.com --journey add_to_cart \
 
 Model kimliğini sağlayıcınızın dokümantasyonundan alın. Bayrakların yerine `OPENAI_COMPATIBLE_BASE_URL` ve `OPENAI_COMPATIBLE_MODEL` değişkenlerini ya da ayar dosyasında `"provider"`, `"base_url"` ve `"model"` alanlarını da kullanabilirsiniz. API katı JSON şemalarını döndüremezse açıklamalar düz JSON moduna geçer.
 
+### Vercel AI Gateway
+
+Tek anahtarla birçok model. Vercel panelinizden `AI_GATEWAY_API_KEY` alın ve modeli `<sağlayıcı>/<model>` olarak seçin:
+
+```bash
+export AI_GATEWAY_API_KEY=...
+aitd run --site https://yourshop.com --journey purchase --model google/gemini-3.6-flash
+```
+
+`--model` verilmezse `anthropic/claude-opus-5.5` kullanılır. Kullanım ve maliyet Vercel'in AI Gateway panelinde görünür ve Vercel tarafından faturalandırılır. Hangi yapay zekânın kullanılacağını görmek için `aitd` çalıştırın: son satır örneğin `AI: vercel (anthropic/claude-opus-5.5) · also set: anthropic (pick with --provider)` der.
+
 ### Cloudflare AI Gateway
 
 Her AI çağrısının kayıtlarını, maliyetini ve limitlerini görmek için çağrıları [Cloudflare AI Gateway](https://developers.cloudflare.com/ai-gateway/) üzerinden gönderin. Sağlayıcı anahtarınız aynı kalır:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@analitikisler/ai-tag-debugger",
   "mcpName": "io.github.analitikisler/ai-tag-debugger",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "Open-source AI agent that QA-tests your website's analytics, ad and consent tracking (GA4, GTM, Google Ads, Meta, TikTok). Bring your own model (Claude, OpenAI, Gemini) or use it from your chat app over MCP.",
   "type": "module",
   "bin": {

package/src/audit.js

@@ -9,7 +9,7 @@ import { VIEWPORTS } from "./browser.js";
 import { checkRun, groupFindings, planCheck, summarize } from "./checks.js";
 import { explainFindings, renderCsv, renderHtml, renderMarkdown } from "./report.js";
 import { LANGUAGES, messages } from "./i18n.js";
-import { createProvider } from "./providers.js";
+import { createProvider, alsoSet } from "./providers.js";
 import { filterFindings, JOURNEY_PRESETS, planRun } from "./journeys.js";
 import { resolveProviders } from "./parsers.js";
 import { SAVED_SITE_FILE, writeSavedSite } from "./replay.js";
@@ -102,7 +102,7 @@ export async function runAudit(opts) {
   }
 
   const provider = useAi ? await createProvider({ name: opts.provider ?? config.provider, model: opts.model ?? config.model, baseUrl: opts.baseUrl ?? config.base_url }) : null;
-  if (provider) log(`Using ${provider.name} (${provider.model})${provider.via ? ` via ${provider.via}` : ""}`);
+  if (provider) log(`Using ${provider.name} (${provider.model})${provider.via ? ` via ${provider.via}` : ""}${alsoSet(provider.key)}`);
 
   if (opts.saveSite) await mkdir(opts.saveSite, { recursive: true });
   const runs = [];

package/src/help.js

@@ -1,5 +1,5 @@
 import { LANGUAGES } from "./i18n.js";
-import { PROVIDERS } from "./providers.js";
+import { PROVIDERS, aiStatus } from "./providers.js";
 import { JOURNEY_PRESETS } from "./journeys.js";
 
 const journeys = Object.keys(JOURNEY_PRESETS).join(", ");
@@ -103,5 +103,6 @@ const HELP = { run: RUN, plan: PLAN, replay: REPLAY, mcp: MCP };
 
 /** Help text for a command, or the top-level help when the command is unknown or missing. */
 export function helpText(command) {
-  return HELP[command] ?? MAIN;
+  // The main help ends with which AI a run would use, so a mix of exported keys is never a surprise.
+  return HELP[command] ?? `${MAIN}\n\n${aiStatus()}`;
 }

package/src/providers.js

@@ -11,6 +11,8 @@ export const PROVIDERS = {
   anthropic: { label: "Anthropic (Claude)", env: "ANTHROPIC_API_KEY", defaultModel: "claude-opus-5-5" },
   openai: { label: "OpenAI", env: "OPENAI_API_KEY", defaultModel: "gpt-5.5" },
   gemini: { label: "Google Gemini", env: "GEMINI_API_KEY", defaultModel: "gemini-pro-latest" },
+  // Vercel AI Gateway: one key, any model as "<provider>/<model>". OpenAI-compatible API.
+  vercel: { label: "Vercel AI Gateway", env: "AI_GATEWAY_API_KEY", defaultModel: "anthropic/claude-opus-5.5" },
   // Any API that speaks the OpenAI chat completions protocol. Needs a base URL and a model.
   "openai-compatible": { label: "OpenAI-compatible API", env: "OPENAI_COMPATIBLE_API_KEY", defaultModel: null },
 };
@@ -22,16 +24,17 @@ export function resolveProviderName(name, env = process.env) {
     return name;
   }
   if (env.OPENAI_COMPATIBLE_BASE_URL) return "openai-compatible";
+  if (env.AI_GATEWAY_API_KEY) return "vercel";
   if (env.ANTHROPIC_API_KEY) return "anthropic";
   if (env.OPENAI_API_KEY) return "openai";
   if (env.GEMINI_API_KEY || env.GOOGLE_API_KEY) return "gemini";
   return "anthropic";
 }
 
-const NO_API_KEY = `No AI provider key found. Set one of ANTHROPIC_API_KEY, OPENAI_API_KEY or GEMINI_API_KEY (or OPENAI_COMPATIBLE_BASE_URL for an OpenAI-compatible API), or pick one with --provider. To run without any AI model, replay saved steps with --no-ai.`;
+const NO_API_KEY = `No AI provider key found. Set one of ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY or AI_GATEWAY_API_KEY for Vercel AI Gateway (or OPENAI_COMPATIBLE_BASE_URL for an OpenAI-compatible API), or pick one with --provider. To run without any AI model, replay saved steps with --no-ai.`;
 
 function hasApiKey(env) {
-  return Boolean(env.OPENAI_COMPATIBLE_BASE_URL || env.ANTHROPIC_API_KEY || env.ANTHROPIC_AUTH_TOKEN || env.OPENAI_API_KEY || env.GEMINI_API_KEY || env.GOOGLE_API_KEY);
+  return Boolean(env.OPENAI_COMPATIBLE_BASE_URL || env.AI_GATEWAY_API_KEY || env.ANTHROPIC_API_KEY || env.ANTHROPIC_AUTH_TOKEN || env.OPENAI_API_KEY || env.GEMINI_API_KEY || env.GOOGLE_API_KEY);
 }
 
 /**
@@ -42,6 +45,12 @@ function hasApiKey(env) {
 export async function createProvider(opts = {}, env = process.env) {
   // A bare client (tests, embedding) is an Anthropic client unless named otherwise.
   const name = opts.client && !opts.name ? "anthropic" : opts.baseUrl && !opts.name ? "openai-compatible" : resolveProviderName(opts.name, env);
+  const provider = await buildProvider(name, opts, env);
+  provider.key = name; // The PROVIDERS key, for status lines.
+  return provider;
+}
+
+async function buildProvider(name, opts, env) {
   // With no provider named and no key set, the SDK would only fail at the first step with an
   // unclear auth error, after the browser has started. A named provider skips this check, since
   // its SDK may find credentials elsewhere (an Anthropic profile, Google Cloud credentials).
@@ -56,6 +65,10 @@ export async function createProvider(opts = {}, env = process.env) {
     const client = opts.client ?? new (await import("openai")).default({ baseURL, apiKey });
     return openaiProvider(client, model, { compatible: true, label: new URL(baseURL).host });
   }
+  if (name === "vercel") {
+    const client = opts.client ?? new (await import("openai")).default({ baseURL: VERCEL_GATEWAY, apiKey: env.AI_GATEWAY_API_KEY });
+    return { ...openaiProvider(client, opts.model ?? PROVIDERS.vercel.defaultModel, { compatible: true }), name: "vercel" };
+  }
   const model = opts.model ?? PROVIDERS[name].defaultModel;
   const gateway = gatewayOptions(name, env);
   const provider = await builtInProvider(name, model, gateway, opts.client, env);
@@ -73,6 +86,34 @@ async function builtInProvider(name, model, gateway, client, env) {
   return geminiProvider(client ?? new GoogleGenAI({ ...(apiKey ? { apiKey } : {}), ...httpOptions }), model);
 }
 
+const VERCEL_GATEWAY = "https://ai-gateway.vercel.sh/v1";
+
+const KEY_PROVIDERS = [
+  ["vercel", (env) => env.AI_GATEWAY_API_KEY],
+  ["anthropic", (env) => env.ANTHROPIC_API_KEY || env.ANTHROPIC_AUTH_TOKEN],
+  ["openai", (env) => env.OPENAI_API_KEY],
+  ["gemini", (env) => env.GEMINI_API_KEY || env.GOOGLE_API_KEY],
+  ["openai-compatible", (env) => env.OPENAI_COMPATIBLE_BASE_URL],
+];
+
+/**
+ * One line saying which AI aitd would use and why, e.g.
+ * "AI: anthropic (claude-opus-5-5) via Cloudflare AI Gateway · also set: gemini (pick with --provider)".
+ */
+export function aiStatus(opts = {}, env = process.env) {
+  if (!opts.name && !KEY_PROVIDERS.some(([, has]) => has(env))) return "AI: no key set (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY or AI_GATEWAY_API_KEY)";
+  const name = resolveProviderName(opts.name, env);
+  const model = opts.model ?? (name === "openai-compatible" ? env.OPENAI_COMPATIBLE_MODEL : PROVIDERS[name].defaultModel) ?? "no model set";
+  const via = name !== "vercel" && gatewayOptions(name, env).baseURL ? " via Cloudflare AI Gateway" : "";
+  return `AI: ${name} (${model})${via}${alsoSet(name, env)}`;
+}
+
+/** " · also set: gemini (pick with --provider)" when keys for other providers are set too. */
+export function alsoSet(name, env = process.env) {
+  const others = KEY_PROVIDERS.filter(([n, has]) => n !== name && has(env)).map(([n]) => n);
+  return others.length ? ` · also set: ${others.join(", ")} (pick with --provider)` : "";
+}
+
 // Cloudflare AI Gateway path for each provider, appended to AI_GATEWAY_URL.
 const GATEWAY_PATHS = { anthropic: "anthropic", openai: "openai", gemini: "google-ai-studio" };