@ainyc/canonry 1.26.0 → 1.27.1

package/dist/{chunk-L6TL4UQI.js → chunk-UTRZ3UB5.js}

@@ -72,6 +72,10 @@ Do not write config.yaml by hand; use "canonry init", "canonry settings", or "ca
     } catch {
     }
   }
+  if ("CANONRY_BASE_PATH" in process.env) {
+    const val = process.env.CANONRY_BASE_PATH.trim();
+    parsed.basePath = val || void 0;
+  }
   if (parsed.basePath) {
     const normalizedBase = "/" + parsed.basePath.replace(/^\/|\/$/g, "");
     try {
@@ -5047,6 +5051,14 @@ async function settingsRoutes(app, opts) {
         const err = validationError("baseUrl is required for local provider");
         return reply.status(err.statusCode).send(err.toJSON());
       }
+    } else if (name === "gemini" && !apiKey) {
+      const geminiSummary = (opts.providerSummary ?? []).find((p) => p.name === "gemini");
+      if (!geminiSummary?.vertexConfigured) {
+        const err = validationError(
+          "apiKey is required for Gemini unless Vertex AI is configured (set GEMINI_VERTEX_PROJECT env var or vertexProject in config file)"
+        );
+        return reply.status(err.statusCode).send(err.toJSON());
+      }
     } else {
       if (!apiKey || typeof apiKey !== "string") {
         const err = validationError("apiKey is required");
@@ -7627,18 +7639,58 @@ async function apiRoutes(app, opts) {
 
 // ../provider-gemini/src/normalize.ts
 import { GoogleGenerativeAI } from "@google/generative-ai";
+import { VertexAI } from "@google-cloud/vertexai";
 var DEFAULT_MODEL = "gemini-3-flash";
 var VALIDATION_PATTERN = /^gemini-/;
+function isVertexConfig(config) {
+  return !!config.vertexProject;
+}
 function resolveModel(config) {
   const m = config.model;
   if (!m) return DEFAULT_MODEL;
   if (VALIDATION_PATTERN.test(m)) return m;
+  const backend = isVertexConfig(config) ? "Vertex AI" : "AI Studio";
   console.warn(
-    `[provider-gemini] Invalid model name "${m}" \u2014 this provider uses the Gemini AI Studio API (generativelanguage.googleapis.com) which only accepts "gemini-*" model names. Falling back to ${DEFAULT_MODEL}.`
+    `[provider-gemini] Invalid model name "${m}" \u2014 this provider uses the Gemini ${backend} API which only accepts "gemini-*" model names. Falling back to ${DEFAULT_MODEL}.`
   );
   return DEFAULT_MODEL;
 }
+function wrapVertexResponse(response) {
+  return {
+    text: () => {
+      const parts = response.candidates?.[0]?.content?.parts;
+      return parts?.map((p) => p.text ?? "").join("") ?? "";
+    },
+    candidates: response.candidates?.map((c) => ({
+      content: c.content,
+      finishReason: c.finishReason,
+      groundingMetadata: c.groundingMetadata
+    })),
+    usageMetadata: response.usageMetadata
+  };
+}
+function createVertexModel(config, model, tools) {
+  const vertexOpts = {
+    project: config.vertexProject,
+    location: config.vertexRegion || "us-central1",
+    googleAuthOptions: config.vertexCredentials ? { keyFilename: config.vertexCredentials } : void 0
+  };
+  const vertexAI = new VertexAI(vertexOpts);
+  return vertexAI.getGenerativeModel({
+    model,
+    ...tools ? { tools } : {}
+  });
+}
 function validateConfig(config) {
+  if (isVertexConfig(config)) {
+    const model2 = resolveModel(config);
+    return {
+      ok: true,
+      provider: "gemini",
+      message: "config valid (Vertex AI)",
+      model: model2
+    };
+  }
   if (!config.apiKey || config.apiKey.length === 0) {
     return { ok: false, provider: "gemini", message: "missing api key" };
   }
@@ -7655,16 +7707,29 @@ async function healthcheck(config) {
   const validation = validateConfig(config);
   if (!validation.ok) return validation;
   try {
-    const genAI = new GoogleGenerativeAI(config.apiKey);
-    const model = genAI.getGenerativeModel({ model: resolveModel(config) });
-    const result = await model.generateContent('Say "ok"');
-    const text2 = result.response.text();
-    return {
-      ok: text2.length > 0,
-      provider: "gemini",
-      message: text2.length > 0 ? "gemini api key verified" : "empty response from gemini",
-      model: config.model ?? DEFAULT_MODEL
-    };
+    const model = resolveModel(config);
+    if (isVertexConfig(config)) {
+      const generativeModel = createVertexModel(config, model);
+      const result = await generativeModel.generateContent('Say "ok"');
+      const text2 = result.response.candidates?.[0]?.content?.parts?.map((p) => p.text ?? "").join("") ?? "";
+      return {
+        ok: text2.length > 0,
+        provider: "gemini",
+        message: text2.length > 0 ? "gemini vertex ai verified" : "empty response from gemini vertex ai",
+        model
+      };
+    } else {
+      const genAI = new GoogleGenerativeAI(config.apiKey);
+      const generativeModel = genAI.getGenerativeModel({ model });
+      const result = await generativeModel.generateContent('Say "ok"');
+      const text2 = result.response.text();
+      return {
+        ok: text2.length > 0,
+        provider: "gemini",
+        message: text2.length > 0 ? "gemini api key verified" : "empty response from gemini",
+        model
+      };
+    }
   } catch (err) {
     return {
       ok: false,
@@ -7676,23 +7741,41 @@ async function healthcheck(config) {
 }
 async function executeTrackedQuery(input) {
   const model = resolveModel(input.config);
-  const genAI = new GoogleGenerativeAI(input.config.apiKey);
-  const generativeModel = genAI.getGenerativeModel({
-    model,
-    tools: [{ googleSearch: {} }]
-  });
   const prompt = buildPrompt(input.keyword, input.location);
-  const result = await generativeModel.generateContent(prompt);
-  const response = result.response;
-  const groundingMetadata = extractGroundingMetadata(response);
-  const searchQueries = extractSearchQueries(response);
-  return {
-    provider: "gemini",
-    rawResponse: responseToRecord(response),
-    model,
-    groundingSources: groundingMetadata,
-    searchQueries
-  };
+  if (isVertexConfig(input.config)) {
+    const vertexSearchTool = { googleSearchRetrieval: {} };
+    const generativeModel = createVertexModel(input.config, model, [vertexSearchTool]);
+    const result = await generativeModel.generateContent(prompt);
+    const response = result.response;
+    const unified = wrapVertexResponse(response);
+    const groundingMetadata = extractGroundingMetadataFromUnified(unified);
+    const searchQueries = extractSearchQueriesFromUnified(unified);
+    return {
+      provider: "gemini",
+      rawResponse: unifiedToRecord(unified),
+      model,
+      groundingSources: groundingMetadata,
+      searchQueries
+    };
+  } else {
+    const searchTool = { googleSearch: {} };
+    const genAI = new GoogleGenerativeAI(input.config.apiKey);
+    const generativeModel = genAI.getGenerativeModel({
+      model,
+      tools: [searchTool]
+    });
+    const result = await generativeModel.generateContent(prompt);
+    const response = result.response;
+    const groundingMetadata = extractGroundingMetadata(response);
+    const searchQueries = extractSearchQueries(response);
+    return {
+      provider: "gemini",
+      rawResponse: responseToRecord(response),
+      model,
+      groundingSources: groundingMetadata,
+      searchQueries
+    };
+  }
 }
 function normalizeResult(raw) {
   const answerText = extractAnswerText(raw.rawResponse);
@@ -7738,6 +7821,22 @@ function extractGroundingMetadata(response) {
     return [];
   }
 }
+function extractGroundingMetadataFromUnified(response) {
+  try {
+    const candidate = response.candidates?.[0];
+    if (!candidate) return [];
+    const metadata = candidate.groundingMetadata;
+    if (!metadata) return [];
+    const chunks = metadata.groundingChunks;
+    if (!chunks) return [];
+    return chunks.filter((chunk) => chunk.web?.uri).map((chunk) => ({
+      uri: chunk.web.uri,
+      title: chunk.web?.title ?? ""
+    }));
+  } catch {
+    return [];
+  }
+}
 function extractSearchQueries(response) {
   try {
     const candidate = response.candidates?.[0];
@@ -7746,6 +7845,14 @@ function extractSearchQueries(response) {
     return [];
   }
 }
+function extractSearchQueriesFromUnified(response) {
+  try {
+    const candidate = response.candidates?.[0];
+    return candidate?.groundingMetadata?.webSearchQueries ?? [];
+  } catch {
+    return [];
+  }
+}
 function extractCitedDomains(raw) {
   const domains = /* @__PURE__ */ new Set();
   for (const source of raw.groundingSources) {
@@ -7793,10 +7900,16 @@ function extractDomainFromUri(uri) {
 }
 async function generateText(prompt, config) {
   const model = resolveModel(config);
-  const genAI = new GoogleGenerativeAI(config.apiKey);
-  const generativeModel = genAI.getGenerativeModel({ model });
-  const result = await generativeModel.generateContent(prompt);
-  return result.response.text();
+  if (isVertexConfig(config)) {
+    const generativeModel = createVertexModel(config, model);
+    const result = await generativeModel.generateContent(prompt);
+    return result.response.candidates?.[0]?.content?.parts?.map((p) => p.text ?? "").join("") ?? "";
+  } else {
+    const genAI = new GoogleGenerativeAI(config.apiKey);
+    const generativeModel = genAI.getGenerativeModel({ model });
+    const result = await generativeModel.generateContent(prompt);
+    return result.response.text();
+  }
 }
 function responseToRecord(response) {
   try {
@@ -7816,13 +7929,34 @@ function responseToRecord(response) {
     return { error: "failed to serialize response" };
   }
 }
+function unifiedToRecord(response) {
+  try {
+    const candidates = response.candidates?.map((c) => ({
+      content: c.content,
+      finishReason: c.finishReason,
+      groundingMetadata: c.groundingMetadata ? {
+        webSearchQueries: c.groundingMetadata.webSearchQueries,
+        groundingChunks: c.groundingMetadata.groundingChunks
+      } : void 0
+    }));
+    return {
+      candidates: candidates ?? [],
+      usageMetadata: response.usageMetadata ?? null
+    };
+  } catch {
+    return { error: "failed to serialize response" };
+  }
+}
 
 // ../provider-gemini/src/adapter.ts
 function toGeminiConfig(config) {
   return {
     apiKey: config.apiKey ?? "",
     model: config.model,
-    quotaPolicy: config.quotaPolicy
+    quotaPolicy: config.quotaPolicy,
+    vertexProject: config.vertexProject,
+    vertexRegion: config.vertexRegion,
+    vertexCredentials: config.vertexCredentials
   };
 }
 var geminiAdapter = {
@@ -10872,19 +11006,22 @@ async function createServer(opts) {
   }
   log6.info("providers.configured", { providers: Object.keys(providers).filter((k) => {
     const p = providers[k];
-    return p?.apiKey || p?.baseUrl;
+    return p?.apiKey || p?.baseUrl || p?.vertexProject;
   }) });
   for (const adapter of API_ADAPTERS) {
     const entry = providers[adapter.name];
     if (!entry) continue;
-    const isConfigured = adapter.name === "local" ? !!entry.baseUrl : !!entry.apiKey;
+    const isConfigured = adapter.name === "local" ? !!entry.baseUrl : adapter.name === "gemini" ? !!(entry.apiKey || entry.vertexProject) : !!entry.apiKey;
     if (isConfigured) {
       registry.register(adapter, {
         provider: adapter.name,
         apiKey: entry.apiKey,
         baseUrl: entry.baseUrl,
         model: entry.model,
-        quotaPolicy: entry.quota ?? DEFAULT_QUOTA
+        quotaPolicy: entry.quota ?? DEFAULT_QUOTA,
+        vertexProject: entry.vertexProject,
+        vertexRegion: entry.vertexRegion,
+        vertexCredentials: entry.vertexCredentials
       });
     }
   }
@@ -10918,7 +11055,8 @@ async function createServer(opts) {
     modelHint: `e.g. ${adapter.modelRegistry.defaultModel}`,
     model: registry.get(adapter.name)?.config.model,
     configured: !!registry.get(adapter.name),
-    quota: registry.get(adapter.name)?.config.quotaPolicy
+    quota: registry.get(adapter.name)?.config.quotaPolicy,
+    vertexConfigured: adapter.name === "gemini" ? !!opts.config.providers?.gemini?.vertexProject : void 0
   }));
   const googleSettingsSummary = {
     configured: Boolean(opts.config.google?.clientId && opts.config.google?.clientSecret)
@@ -11212,7 +11350,12 @@ async function createServer(opts) {
         apiKey: apiKey || existing?.apiKey,
         baseUrl: baseUrl || existing?.baseUrl,
         model: model || existing?.model,
-        quota: mergedQuota
+        quota: mergedQuota,
+        // Preserve Vertex AI config (Gemini provider) — these are set via
+        // config file or env vars, not through the dashboard update payload
+        vertexProject: existing?.vertexProject,
+        vertexRegion: existing?.vertexRegion,
+        vertexCredentials: existing?.vertexCredentials
       };
       try {
         saveConfig(opts.config);
@@ -11226,13 +11369,19 @@ async function createServer(opts) {
         apiKey: apiKey || existing?.apiKey,
         baseUrl: baseUrl || existing?.baseUrl,
         model: model || existing?.model,
-        quotaPolicy: quota
+        quotaPolicy: quota,
+        vertexProject: existing?.vertexProject,
+        vertexRegion: existing?.vertexRegion,
+        vertexCredentials: existing?.vertexCredentials
       });
       const entry = providerSummary.find((p) => p.name === name);
       if (entry) {
         entry.configured = true;
         entry.model = model || registry.get(name)?.config.model;
         entry.quota = quota;
+        if (name === "gemini") {
+          entry.vertexConfigured = !!opts.config.providers?.[name]?.vertexProject;
+        }
       }
       const afterConfig = summarizeProviderConfig(name, opts.config.providers[name]);
       if (JSON.stringify(beforeConfig) !== JSON.stringify(afterConfig)) {
@@ -11428,7 +11577,12 @@ async function createServer(opts) {
       return reply.status(404).send({ error: "Not found" });
     });
   }
-  const healthHandler = async () => ({ status: "ok", service: "canonry", version: PKG_VERSION });
+  const healthHandler = async () => ({
+    status: "ok",
+    service: "canonry",
+    version: PKG_VERSION,
+    ...basePath ? { basePath: basePath.replace(/\/$/, "") } : {}
+  });
   app.get("/health", healthHandler);
   if (basePath) {
     app.get(`${basePath}health`, healthHandler);

package/dist/cli.js

@@ -19,7 +19,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-L6TL4UQI.js";
+} from "./chunk-UTRZ3UB5.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -148,14 +148,56 @@ Usage: ${spec.usage}`, {
 }
 
 // src/client.ts
+function createApiClient() {
+  const config = loadConfig();
+  const basePathResolved = !!config.basePath || "CANONRY_BASE_PATH" in process.env;
+  return new ApiClient(config.apiUrl, config.apiKey, { skipProbe: basePathResolved });
+}
 var ApiClient = class {
   baseUrl;
+  originUrl;
   apiKey;
-  constructor(baseUrl, apiKey) {
-    this.baseUrl = baseUrl.replace(/\/$/, "") + "/api/v1";
+  probePromise = null;
+  probeSkipped;
+  constructor(baseUrl, apiKey, opts) {
+    this.originUrl = baseUrl.replace(/\/$/, "");
+    this.baseUrl = this.originUrl + "/api/v1";
     this.apiKey = apiKey;
+    this.probeSkipped = opts?.skipProbe ?? false;
+  }
+  /**
+   * On first API call, probe /health to auto-discover basePath when the user
+   * hasn't configured one locally. This lets `canonry run` in a separate shell
+   * discover that the server is running at e.g. /canonry/ without requiring
+   * config.yaml edits or CANONRY_BASE_PATH in every shell.
+   */
+  probeBasePath() {
+    if (this.probeSkipped) return Promise.resolve();
+    if (!this.probePromise) {
+      this.probePromise = (async () => {
+        try {
+          const origin = new URL(this.originUrl).origin;
+          const res = await fetch(`${origin}/health`, {
+            signal: AbortSignal.timeout(2e3)
+          });
+          if (res.ok) {
+            const body = await res.json();
+            if (body.basePath && typeof body.basePath === "string") {
+              const normalized = "/" + body.basePath.replace(/^\/|\/$/g, "");
+              if (normalized !== "/") {
+                this.originUrl = origin + normalized;
+                this.baseUrl = this.originUrl + "/api/v1";
+              }
+            }
+          }
+        } catch {
+        }
+      })();
+    }
+    return this.probePromise;
   }
   async request(method, path4, body) {
+    await this.probeBasePath();
     const url = `${this.baseUrl}${path4}`;
     const serializedBody = body != null ? JSON.stringify(body) : void 0;
     const headers = {
@@ -440,8 +482,7 @@ var ApiClient = class {
 
 // src/commands/bing.ts
 function getClient() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function bingConnect(project, opts) {
   let apiKey = opts?.apiKey;
@@ -963,8 +1004,7 @@ var BING_CLI_COMMANDS = [
 
 // src/commands/cdp.ts
 function getClient2() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function cdpConnect(opts) {
   const config = loadConfig();
@@ -1155,8 +1195,7 @@ var CDP_CLI_COMMANDS = [
 
 // src/commands/ga.ts
 function getClient3() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function gaConnect(project, opts) {
   if (!opts.propertyId) {
@@ -1398,8 +1437,7 @@ var GA_CLI_COMMANDS = [
 
 // src/commands/competitor.ts
 function getClient4() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function addCompetitors(project, domains, format) {
   const client = getClient4();
@@ -1480,8 +1518,7 @@ var COMPETITOR_CLI_COMMANDS = [
 
 // src/commands/google.ts
 function getClient5() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function waitForRunStatus(client, runId, config) {
   const start = Date.now();
@@ -2308,8 +2345,7 @@ var GOOGLE_CLI_COMMANDS = [
 // src/commands/keyword.ts
 import fs from "fs";
 function getClient6() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function addKeywords(project, keywords, format) {
   const client = getClient6();
@@ -2553,8 +2589,7 @@ var KEYWORD_CLI_COMMANDS = [
 
 // src/commands/notify.ts
 function getClient7() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function addNotification(project, opts) {
   const client = getClient7();
@@ -2726,8 +2761,7 @@ async function applyConfigFile(filePath) {
   }
   const content = fs2.readFileSync(filePath, "utf-8");
   const docs = parseAllDocuments(content);
-  const clientConfig = loadConfig();
-  const client = new ApiClient(clientConfig.apiUrl, clientConfig.apiKey);
+  const client = createApiClient();
   const errors = [];
   const applied = [];
   for (let i = 0; i < docs.length; i++) {
@@ -2789,8 +2823,7 @@ async function applyConfigs(filePaths, format) {
 
 // src/commands/analytics.ts
 function getClient8() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function showAnalytics(project, options) {
   const client = getClient8();
@@ -2897,8 +2930,7 @@ Source Origin Breakdown`);
 
 // src/commands/evidence.ts
 function getClient9() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function showEvidence(project, format) {
   const client = getClient9();
@@ -2933,8 +2965,7 @@ async function showEvidence(project, format) {
 // src/commands/export-cmd.ts
 import { stringify } from "yaml";
 async function exportProject(project, opts) {
-  const config = loadConfig();
-  const client = new ApiClient(config.apiUrl, config.apiKey);
+  const client = createApiClient();
   const data = await client.getExport(project);
   if (opts.includeResults) {
     try {
@@ -2955,8 +2986,7 @@ async function exportProject(project, opts) {
 
 // src/commands/history.ts
 function getClient10() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function showHistory(project, format) {
   const client = getClient10();
@@ -2995,8 +3025,7 @@ async function showHistory(project, format) {
 
 // src/commands/status.ts
 function getClient11() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function showStatus(project, format) {
   const client = getClient11();
@@ -3108,8 +3137,7 @@ var OPERATOR_CLI_COMMANDS = [
 
 // src/commands/project.ts
 function getClient12() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function createProject(name, opts) {
   const client = getClient12();
@@ -3445,8 +3473,7 @@ var PROJECT_CLI_COMMANDS = [
 
 // src/commands/run.ts
 function getClient13() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
 async function triggerRun(project, opts) {
@@ -3775,8 +3802,7 @@ var RUN_CLI_COMMANDS = [
 
 // src/commands/schedule.ts
 function getClient14() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function setSchedule(project, opts) {
   const client = getClient14();
@@ -3939,8 +3965,7 @@ var SCHEDULE_CLI_COMMANDS = [
 
 // src/commands/settings.ts
 function getClient15() {
-  const config = loadConfig();
-  return new ApiClient(config.apiUrl, config.apiKey);
+  return createApiClient();
 }
 async function setProvider(name, opts) {
   const client = getClient15();
@@ -4149,6 +4174,10 @@ var envSchema = z.object({
   GEMINI_MAX_CONCURRENCY: z.coerce.number().int().positive().default(2),
   GEMINI_MAX_REQUESTS_PER_MINUTE: z.coerce.number().int().positive().default(10),
   GEMINI_MAX_REQUESTS_PER_DAY: z.coerce.number().int().positive().default(1e3),
+  // Gemini Vertex AI (alternative to API key auth)
+  GEMINI_VERTEX_PROJECT: z.string().optional(),
+  GEMINI_VERTEX_REGION: z.string().optional(),
+  GEMINI_VERTEX_CREDENTIALS: z.string().optional(),
   // OpenAI
   OPENAI_API_KEY: z.string().optional(),
   OPENAI_MODEL: z.string().optional(),
@@ -4174,6 +4203,9 @@ var bootstrapEnvSchema = z.object({
   CANONRY_DATABASE_PATH: z.string().optional(),
   GEMINI_API_KEY: z.string().optional(),
   GEMINI_MODEL: z.string().optional(),
+  GEMINI_VERTEX_PROJECT: z.string().optional(),
+  GEMINI_VERTEX_REGION: z.string().optional(),
+  GEMINI_VERTEX_CREDENTIALS: z.string().optional(),
   OPENAI_API_KEY: z.string().optional(),
   OPENAI_MODEL: z.string().optional(),
   ANTHROPIC_API_KEY: z.string().optional(),
@@ -4190,15 +4222,18 @@ function getBootstrapEnv(source, overrides) {
   const filtered = overrides ? Object.fromEntries(Object.entries(overrides).filter(([, v]) => v != null)) : {};
   const parsed = bootstrapEnvSchema.parse({ ...source, ...filtered });
   const providers = {};
-  if (parsed.GEMINI_API_KEY) {
+  if (parsed.GEMINI_API_KEY || parsed.GEMINI_VERTEX_PROJECT) {
     providers.gemini = {
-      apiKey: parsed.GEMINI_API_KEY,
+      apiKey: parsed.GEMINI_API_KEY ?? "",
       model: parsed.GEMINI_MODEL || "gemini-3-flash",
       quota: providerQuotaPolicySchema.parse({
         maxConcurrency: 2,
         maxRequestsPerMinute: 10,
         maxRequestsPerDay: 500
-      })
+      }),
+      vertexProject: parsed.GEMINI_VERTEX_PROJECT,
+      vertexRegion: parsed.GEMINI_VERTEX_REGION,
+      vertexCredentials: parsed.GEMINI_VERTEX_CREDENTIALS
     };
   }
   if (parsed.OPENAI_API_KEY) {

package/dist/index.d.ts

@@ -8,6 +8,12 @@ interface ProviderConfigEntry {
     baseUrl?: string;
     model?: string;
     quota?: ProviderQuotaPolicy;
+    /** Vertex AI GCP project ID (Gemini provider only) */
+    vertexProject?: string;
+    /** Vertex AI region, e.g. "us-central1" (Gemini provider only) */
+    vertexRegion?: string;
+    /** Path to service account JSON for Vertex AI auth (falls back to ADC) */
+    vertexCredentials?: string;
 }
 interface CdpConfigEntry {
     host?: string;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createServer,
   loadConfig
-} from "./chunk-L6TL4UQI.js";
+} from "./chunk-UTRZ3UB5.js";
 export {
   createServer,
   loadConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "1.26.0",
+  "version": "1.27.1",
   "type": "module",
   "description": "The ultimate open-source AEO monitoring tool - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -36,6 +36,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.78.0",
     "@fastify/static": "^8.1.0",
+    "@google-cloud/vertexai": "^1.10.3",
     "@google/generative-ai": "^0.24.1",
     "better-sqlite3": "^12.6.2",
     "drizzle-orm": "^0.45.1",
@@ -52,17 +53,17 @@
     "@types/node-cron": "^3.0.11",
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
-    "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-db": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {