@ainyc/canonry 4.31.0 → 4.33.0

package/dist/{chunk-HTNC6AWN.js → chunk-XW3F5EEW.js}

@@ -300,6 +300,74 @@ var notificationCreateRequestSchema = z3.object({
 
 // ../contracts/src/project.ts
 import { z as z4 } from "zod";
+
+// ../contracts/src/errors.ts
+var AppError = class extends Error {
+  code;
+  statusCode;
+  details;
+  constructor(code, message, statusCode, details) {
+    super(message);
+    this.name = "AppError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+  }
+  toJSON() {
+    return {
+      error: {
+        code: this.code,
+        message: this.message,
+        ...this.details ? { details: this.details } : {}
+      }
+    };
+  }
+};
+function notFound(entity, id) {
+  return new AppError("NOT_FOUND", `${entity} '${id}' not found`, 404);
+}
+function validationError(message, details) {
+  return new AppError("VALIDATION_ERROR", message, 400, details);
+}
+function authRequired() {
+  return new AppError("AUTH_REQUIRED", "Authentication required", 401);
+}
+function authInvalid() {
+  return new AppError("AUTH_INVALID", "Invalid API key", 401);
+}
+function providerError(message, details) {
+  return new AppError("PROVIDER_ERROR", message, 502, details);
+}
+function runInProgress(projectName) {
+  return new AppError("RUN_IN_PROGRESS", `A run is already in progress for '${projectName}'`, 409);
+}
+function runNotCancellable(runId, status) {
+  return new AppError("RUN_NOT_CANCELLABLE", `Run '${runId}' is already in terminal state '${status}' and cannot be cancelled`, 409);
+}
+function unsupportedKind(kind) {
+  return new AppError("UNSUPPORTED_KIND", `Kind '${kind}' is not supported in this version`, 400);
+}
+function notImplemented(message) {
+  return new AppError("NOT_IMPLEMENTED", message, 501);
+}
+function deliveryFailed(message) {
+  return new AppError("DELIVERY_FAILED", message, 502);
+}
+function agentBusy(projectName) {
+  return new AppError(
+    "AGENT_BUSY",
+    `Aero is already running a turn for '${projectName}'. Retry after the current turn settles.`,
+    409
+  );
+}
+function missingDependency(message, details) {
+  return new AppError("MISSING_DEPENDENCY", message, 422, details);
+}
+function internalError(message, details) {
+  return new AppError("INTERNAL_ERROR", message, 500, details);
+}
+
+// ../contracts/src/project.ts
 var configSourceSchema = z4.enum(["cli", "api", "config-file"]);
 function findDuplicateLocationLabels(locations) {
   const seen = /* @__PURE__ */ new Set();
@@ -317,6 +385,26 @@ function hasLocationLabel(locations, label) {
   if (!label) return true;
   return locations.some((location) => location.label === label);
 }
+function resolveLocations(projectLocations, requestedLabels) {
+  const normalizedRequest = (requestedLabels ?? []).map((label) => label.trim()).filter((label) => label.length > 0);
+  if (normalizedRequest.length === 0) return [...projectLocations];
+  const byLabel = new Map(projectLocations.map((loc) => [loc.label.toLowerCase(), loc]));
+  const resolved = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const label of normalizedRequest) {
+    const key = label.toLowerCase();
+    if (seen.has(key)) continue;
+    const match = byLabel.get(key);
+    if (!match) {
+      throw validationError(
+        `Location "${label}" is not configured for this project. Add it to the project's locations or omit the locations override.`
+      );
+    }
+    seen.add(key);
+    resolved.push(match);
+  }
+  return resolved;
+}
 var projectUpsertRequestSchema = z4.object({
   displayName: z4.string().min(1),
   canonicalDomain: z4.string().min(1),
@@ -542,72 +630,6 @@ function resolveConfigSpecQueries(spec) {
   return spec.queries ?? spec.keywords ?? [];
 }
 
-// ../contracts/src/errors.ts
-var AppError = class extends Error {
-  code;
-  statusCode;
-  details;
-  constructor(code, message, statusCode, details) {
-    super(message);
-    this.name = "AppError";
-    this.code = code;
-    this.statusCode = statusCode;
-    this.details = details;
-  }
-  toJSON() {
-    return {
-      error: {
-        code: this.code,
-        message: this.message,
-        ...this.details ? { details: this.details } : {}
-      }
-    };
-  }
-};
-function notFound(entity, id) {
-  return new AppError("NOT_FOUND", `${entity} '${id}' not found`, 404);
-}
-function validationError(message, details) {
-  return new AppError("VALIDATION_ERROR", message, 400, details);
-}
-function authRequired() {
-  return new AppError("AUTH_REQUIRED", "Authentication required", 401);
-}
-function authInvalid() {
-  return new AppError("AUTH_INVALID", "Invalid API key", 401);
-}
-function providerError(message, details) {
-  return new AppError("PROVIDER_ERROR", message, 502, details);
-}
-function runInProgress(projectName) {
-  return new AppError("RUN_IN_PROGRESS", `A run is already in progress for '${projectName}'`, 409);
-}
-function runNotCancellable(runId, status) {
-  return new AppError("RUN_NOT_CANCELLABLE", `Run '${runId}' is already in terminal state '${status}' and cannot be cancelled`, 409);
-}
-function unsupportedKind(kind) {
-  return new AppError("UNSUPPORTED_KIND", `Kind '${kind}' is not supported in this version`, 400);
-}
-function notImplemented(message) {
-  return new AppError("NOT_IMPLEMENTED", message, 501);
-}
-function deliveryFailed(message) {
-  return new AppError("DELIVERY_FAILED", message, 502);
-}
-function agentBusy(projectName) {
-  return new AppError(
-    "AGENT_BUSY",
-    `Aero is already running a turn for '${projectName}'. Retry after the current turn settles.`,
-    409
-  );
-}
-function missingDependency(message, details) {
-  return new AppError("MISSING_DEPENDENCY", message, 422, details);
-}
-function internalError(message, details) {
-  return new AppError("INTERNAL_ERROR", message, 500, details);
-}
-
 // ../contracts/src/google.ts
 import { z as z6 } from "zod";
 var googleConnectionTypeSchema = z6.enum(["gsc", "ga4"]);
@@ -2442,7 +2464,15 @@ var DISCOVERY_MAX_PROBES_CAP = 500;
 var discoveryRunRequestSchema = z21.object({
   icpDescription: z21.string().min(1).optional(),
   dedupThreshold: z21.number().min(0).max(1).optional(),
-  maxProbes: z21.number().int().positive().max(DISCOVERY_MAX_PROBES_CAP).optional()
+  maxProbes: z21.number().int().positive().max(DISCOVERY_MAX_PROBES_CAP).optional(),
+  /**
+   * Optional override of the project's location labels, constraining seed
+   * generation to a subset of the configured service areas. Each label must
+   * match a configured project location (resolved server-side via
+   * `resolveLocations`). Omitted means "use every project location" — a
+   * project with no locations is unaffected.
+   */
+  locations: z21.array(z21.string().min(1)).optional()
 });
 var discoveryPromoteRequestSchema = z21.object({
   buckets: z21.array(discoveryBucketSchema).min(1).optional(),
@@ -2614,20 +2644,6 @@ export {
   getProviderLocationHandling,
   notificationEventSchema,
   notificationCreateRequestSchema,
-  findDuplicateLocationLabels,
-  hasLocationLabel,
-  projectUpsertRequestSchema,
-  queryBatchRequestSchema,
-  keywordBatchRequestSchema,
-  queryGenerateRequestSchema,
-  keywordGenerateRequestSchema,
-  competitorBatchRequestSchema,
-  normalizeProjectDomain,
-  registrableDomain,
-  brandLabelFromDomain,
-  effectiveDomains,
-  projectConfigSchema,
-  resolveConfigSpecQueries,
   AppError,
   notFound,
   validationError,
@@ -2642,6 +2658,21 @@ export {
   agentBusy,
   missingDependency,
   internalError,
+  findDuplicateLocationLabels,
+  hasLocationLabel,
+  resolveLocations,
+  projectUpsertRequestSchema,
+  queryBatchRequestSchema,
+  keywordBatchRequestSchema,
+  queryGenerateRequestSchema,
+  keywordGenerateRequestSchema,
+  competitorBatchRequestSchema,
+  normalizeProjectDomain,
+  registrableDomain,
+  brandLabelFromDomain,
+  effectiveDomains,
+  projectConfigSchema,
+  resolveConfigSpecQueries,
   wordpressEnvSchema,
   AgentProviderIds,
   AGENT_PROVIDER_IDS,
@@ -2705,6 +2736,7 @@ export {
   VerificationStatuses,
   trafficConnectCloudRunRequestSchema,
   trafficConnectWordpressRequestSchema,
+  trafficConnectVercelRequestSchema,
   trafficEventKindSchema,
   TrafficEventKinds,
   discoveryBucketSchema,

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   setTelemetrySource,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-PUTJHEVR.js";
+} from "./chunk-JJHBPITI.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -36,7 +36,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-5STLZRGB.js";
+} from "./chunk-5EBN7736.js";
 import {
   apiKeys,
   competitors,
@@ -49,7 +49,7 @@ import {
   queries,
   querySnapshots,
   runs
-} from "./chunk-U3YKRV47.js";
+} from "./chunk-BJXHETQW.js";
 import {
   CcReleaseSyncStatuses,
   CheckScopes,
@@ -71,7 +71,7 @@ import {
   providerQuotaPolicySchema,
   resolveProviderInput,
   skillsClientSchema
-} from "./chunk-HTNC6AWN.js";
+} from "./chunk-XW3F5EEW.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -623,7 +623,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService } = await import("./intelligence-service-CJONZ7ST.js");
+  const { IntelligenceService } = await import("./intelligence-service-XKOUBRCE.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -1971,6 +1971,7 @@ function buildRunBody(opts, icpDescription) {
   if (icpDescription) body.icpDescription = icpDescription;
   if (opts.dedupThreshold !== void 0) body.dedupThreshold = opts.dedupThreshold;
   if (opts.maxProbes !== void 0) body.maxProbes = opts.maxProbes;
+  if (opts.locations && opts.locations.length > 0) body.locations = opts.locations;
   return body;
 }
 function resolveIcpAngles(opts) {
@@ -2241,6 +2242,12 @@ Usage: ${usage}`, {
   }
   return parsed;
 }
+function parseLocationsOption(values) {
+  const raw = getStringArray(values, "locations");
+  if (!raw || raw.length === 0) return void 0;
+  const expanded = raw.flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+  return expanded.length > 0 ? expanded : void 0;
+}
 function parseBucketsOption(values, usage) {
   const raw = getStringArray(values, "bucket");
   if (!raw || raw.length === 0) return void 0;
@@ -2307,20 +2314,22 @@ Usage: ${usage}`,
 var DISCOVER_CLI_COMMANDS = [
   {
     path: ["discover", "run"],
-    usage: 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]',
+    usage: 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]',
     options: {
       icp: stringOption(),
       "icp-angle": multiStringOption(),
+      locations: multiStringOption(),
       "dedup-threshold": stringOption(),
       "max-probes": stringOption(),
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]';
+      const usage = 'canonry discover run <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]';
       const project = requireProject(input, "discover.run", usage);
       await discoverRun(project, {
         icp: getString(input.values, "icp"),
         icpAngles: getStringArray(input.values, "icp-angle"),
+        locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),
         maxProbes: parseIntegerOption(input, "max-probes", {
           command: "discover.run",
@@ -2334,20 +2343,22 @@ var DISCOVER_CLI_COMMANDS = [
   },
   {
     path: ["discover", "seed"],
-    usage: 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]',
+    usage: 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]',
     options: {
       icp: stringOption(),
       "icp-angle": multiStringOption(),
+      locations: multiStringOption(),
       "dedup-threshold": stringOption(),
       "max-probes": stringOption(),
       wait: { type: "boolean", default: false }
     },
     run: async (input) => {
-      const usage = 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]';
+      const usage = 'canonry discover seed <project> [--icp "..."] [--icp-angle "..."] [--locations michigan,florida] [--dedup-threshold 0.85] [--max-probes 100] [--wait] [--format json]';
       const project = requireProject(input, "discover.seed", usage);
       await discoverSeed(project, {
         icp: getString(input.values, "icp"),
         icpAngles: getStringArray(input.values, "icp-angle"),
+        locations: parseLocationsOption(input.values),
         dedupThreshold: parseFloatOption(input.values, "dedup-threshold", usage),
         maxProbes: parseIntegerOption(input, "max-probes", {
           command: "discover.seed",
@@ -3345,6 +3356,84 @@ async function trafficConnectCloudRun(project, opts) {
   console.log("");
   console.log(`Next: canonry traffic sync ${project} --source ${result.id}`);
 }
+async function trafficConnectVercel(project, opts) {
+  if (!opts.projectId) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_PROJECT_ID_REQUIRED",
+      message: "--project-id is required",
+      displayMessage: "Error: --project-id is required (the Vercel project id, e.g. prj_...)",
+      details: { project }
+    });
+  }
+  if (!opts.teamId) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TEAM_ID_REQUIRED",
+      message: "--team-id is required",
+      displayMessage: "Error: --team-id is required (the Vercel team / owner id, e.g. team_...)",
+      details: { project }
+    });
+  }
+  if (opts.token && opts.tokenFile) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TOKEN_CONFLICT",
+      message: "--token and --token-file are mutually exclusive",
+      displayMessage: "Error: pass either --token <token> or --token-file <path>, not both",
+      details: { project }
+    });
+  }
+  let token = opts.token?.trim() ?? "";
+  if (!token && opts.tokenFile) {
+    const fs13 = await import("fs");
+    try {
+      token = fs13.readFileSync(opts.tokenFile, "utf-8").trim();
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      throw new CliError({
+        code: "TRAFFIC_VERCEL_TOKEN_FILE_READ_ERROR",
+        message: `Failed to read --token-file: ${msg}`,
+        displayMessage: `Error: failed to read --token-file "${opts.tokenFile}": ${msg}`,
+        details: { project, tokenFile: opts.tokenFile }
+      });
+    }
+  }
+  if (!token) {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_TOKEN_REQUIRED",
+      message: "--token or --token-file is required",
+      displayMessage: "Error: pass --token <token> or --token-file <path>",
+      details: { project }
+    });
+  }
+  if (opts.environment && opts.environment !== "production" && opts.environment !== "preview") {
+    throw new CliError({
+      code: "TRAFFIC_VERCEL_INVALID_ENVIRONMENT",
+      message: '--environment must be "production" or "preview"',
+      displayMessage: 'Error: --environment must be "production" or "preview"',
+      details: { project, environment: opts.environment }
+    });
+  }
+  const client = getClient6();
+  const result = await client.trafficConnectVercel(project, {
+    projectId: opts.projectId,
+    teamId: opts.teamId,
+    token,
+    environment: opts.environment,
+    displayName: opts.displayName
+  });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Vercel traffic source connected for project "${project}".`);
+  console.log(`  Source ID:    ${result.id}`);
+  console.log(`  Display name: ${result.displayName}`);
+  console.log(`  Status:       ${result.status}`);
+  console.log(`  Project ID:   ${result.config.projectId ?? "(unset)"}`);
+  console.log(`  Team ID:      ${result.config.teamId ?? "(unset)"}`);
+  console.log(`  Environment:  ${result.config.environment ?? "(unset)"}`);
+  console.log("");
+  console.log(`Next: canonry traffic sync ${project} --source ${result.id}`);
+}
 async function trafficBackfill(project, opts) {
   if (!opts.source) {
     throw new CliError({
@@ -3626,6 +3715,38 @@ var TRAFFIC_CLI_COMMANDS = [
       });
     }
   },
+  {
+    path: ["traffic", "connect", "vercel"],
+    usage: "canonry traffic connect vercel <project> --project-id <prj> --team-id <team> (--token <token> | --token-file <path>) [--environment production|preview] [--display-name <name>] [--format json]",
+    options: {
+      "project-id": stringOption(),
+      "team-id": stringOption(),
+      token: stringOption(),
+      "token-file": stringOption(),
+      environment: stringOption(),
+      "display-name": stringOption()
+    },
+    run: async (input) => {
+      const project = requireProject(
+        input,
+        "traffic.connect.vercel",
+        "canonry traffic connect vercel <project> --project-id <prj> --team-id <team> (--token <token> | --token-file <path>)"
+      );
+      const projectId = getString(input.values, "project-id");
+      if (!projectId) throw new Error("--project-id is required");
+      const teamId = getString(input.values, "team-id");
+      if (!teamId) throw new Error("--team-id is required");
+      await trafficConnectVercel(project, {
+        projectId,
+        teamId,
+        token: getString(input.values, "token"),
+        tokenFile: getString(input.values, "token-file"),
+        environment: getString(input.values, "environment"),
+        displayName: getString(input.values, "display-name"),
+        format: input.format
+      });
+    }
+  },
   {
     path: ["traffic", "connect"],
     usage: "canonry traffic connect <provider> <project> [args]",
@@ -3633,7 +3754,7 @@ var TRAFFIC_CLI_COMMANDS = [
       unknownSubcommand(input.positionals[0], {
         command: "traffic connect",
         usage: "canonry traffic connect <provider> <project> [args]",
-        available: ["cloud-run", "wordpress"]
+        available: ["cloud-run", "wordpress", "vercel"]
       });
     }
   },

package/dist/index.d.ts

@@ -107,6 +107,25 @@ interface WordpressTrafficConnectionConfigEntry {
 interface WordpressTrafficConfigEntry {
     connections?: WordpressTrafficConnectionConfigEntry[];
 }
+type VercelTrafficEnvironment = 'production' | 'preview';
+/**
+ * Per-project Vercel traffic connection. Authenticates against Vercel's
+ * internal `request-logs` endpoint using a Vercel API token. The project id,
+ * team id, and environment are non-secret and also mirrored onto the
+ * `traffic_sources` row; the token lives only here.
+ */
+interface VercelTrafficConnectionConfigEntry {
+    projectName: string;
+    projectId: string;
+    teamId: string;
+    token: string;
+    environment: VercelTrafficEnvironment;
+    createdAt: string;
+    updatedAt: string;
+}
+interface VercelTrafficConfigEntry {
+    connections?: VercelTrafficConnectionConfigEntry[];
+}
 interface AgentConfigEntry {
     /** Agent mode. Only 'disabled' is valid until the native loop ships. */
     mode?: 'disabled';
@@ -130,6 +149,7 @@ interface CanonryConfig {
     cloudRun?: CloudRunConfigEntry;
     wordpress?: WordpressConfigEntry;
     wordpressTraffic?: WordpressTrafficConfigEntry;
+    vercelTraffic?: VercelTrafficConfigEntry;
     dashboardPasswordHash?: string;
     telemetry?: boolean;
     anonymousId?: string;

package/dist/index.js

@@ -1,11 +1,11 @@
 import {
   createServer
-} from "./chunk-PUTJHEVR.js";
+} from "./chunk-JJHBPITI.js";
 import {
   loadConfig
-} from "./chunk-5STLZRGB.js";
-import "./chunk-U3YKRV47.js";
-import "./chunk-HTNC6AWN.js";
+} from "./chunk-5EBN7736.js";
+import "./chunk-BJXHETQW.js";
+import "./chunk-XW3F5EEW.js";
 export {
   createServer,
   loadConfig

package/dist/{intelligence-service-CJONZ7ST.js → intelligence-service-XKOUBRCE.js}

@@ -1,7 +1,7 @@
 import {
   IntelligenceService
-} from "./chunk-U3YKRV47.js";
-import "./chunk-HTNC6AWN.js";
+} from "./chunk-BJXHETQW.js";
+import "./chunk-XW3F5EEW.js";
 export {
   IntelligenceService
 };

package/dist/mcp.js

@@ -2,8 +2,8 @@ import {
   CliError,
   canonryMcpTools,
   createApiClient
-} from "./chunk-5STLZRGB.js";
-import "./chunk-HTNC6AWN.js";
+} from "./chunk-5EBN7736.js";
+import "./chunk-XW3F5EEW.js";
 
 // src/mcp/cli.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "4.31.0",
+  "version": "4.33.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -61,22 +61,22 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-api-routes": "0.0.0",
-    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-integration-bing": "0.0.0",
-    "@ainyc/canonry-integration-cloud-run": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
+    "@ainyc/canonry-integration-cloud-run": "0.0.0",
+    "@ainyc/canonry-config": "0.0.0",
+    "@ainyc/canonry-integration-bing": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-traffic": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
+    "@ainyc/canonry-integration-traffic": "0.0.0",
+    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0"
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-local": "0.0.0"
   },
   "scripts": {
     "build": "tsx scripts/copy-agent-assets.ts && tsup && tsx build-web.ts",