npm - @ainyc/canonry - Versions diffs - 4.32.0 → 4.33.1 - Mend

@ainyc/canonry 4.32.0 → 4.33.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/assets/agent-workspace/skills/canonry/references/canonry-cli.md +2 -1
package/assets/assets/{index-CUMjedc6.js → index-47V0U52s.js} +34 -34
package/assets/index.html +1 -1
package/dist/{chunk-LVX5TOYA.js → chunk-5EBN7736.js} +1 -1
package/dist/{chunk-LUAJVZVZ.js → chunk-BJXHETQW.js} +1 -1
package/dist/{chunk-7I65IXVU.js → chunk-DZENHID5.js} +104 -40
package/dist/{chunk-5M4PP6P4.js → chunk-XW3F5EEW.js} +112 -81
package/dist/cli.js +31 -13
package/dist/index.js +4 -4
package/dist/{intelligence-service-RSRWDBHS.js → intelligence-service-XKOUBRCE.js} +2 -2
package/dist/mcp.js +2 -2
package/package.json +9 -9

package/assets/index.html CHANGED Viewed

@@ -12,7 +12,7 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
     <link rel="apple-touch-icon" href="./apple-touch-icon.png" />
     <title>Canonry</title>
-    <script type="module" crossorigin src="./assets/index-CUMjedc6.js"></script>
+    <script type="module" crossorigin src="./assets/index-47V0U52s.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CNKAwZMB.css">
   </head>
   <body>

package/dist/{chunk-LVX5TOYA.js → chunk-5EBN7736.js} RENAMED Viewed

@@ -22,7 +22,7 @@ import {
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema
-} from "./chunk-5M4PP6P4.js";
+} from "./chunk-XW3F5EEW.js";
 // src/config.ts
 import fs from "fs";

package/dist/{chunk-LUAJVZVZ.js → chunk-BJXHETQW.js} RENAMED Viewed

@@ -8,7 +8,7 @@ import {
   categoryLabel,
   determineAnswerMentioned,
   normalizeProjectDomain
-} from "./chunk-5M4PP6P4.js";
+} from "./chunk-XW3F5EEW.js";
 // src/intelligence-service.ts
 import { eq, desc, asc, and, or, inArray } from "drizzle-orm";

package/dist/{chunk-7I65IXVU.js → chunk-DZENHID5.js} RENAMED Viewed

@@ -5,7 +5,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-LVX5TOYA.js";
+} from "./chunk-5EBN7736.js";
 import {
   DEFAULT_RUN_HISTORY_LIMIT,
   IntelligenceService,
@@ -70,7 +70,7 @@ import {
   schedules,
   trafficSources,
   usageCounters
-} from "./chunk-LUAJVZVZ.js";
+} from "./chunk-BJXHETQW.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -162,6 +162,7 @@ import {
   reportHorizonLabel,
   reportSeverityLabel,
   resolveConfigSpecQueries,
+  resolveLocations,
   resolveSnapshotRequestQueries,
   runInProgress,
   runNotCancellable,
@@ -178,7 +179,7 @@ import {
   visibilityStateFromAnswerMentioned,
   windowCutoff,
   wordpressEnvSchema
-} from "./chunk-5M4PP6P4.js";
+} from "./chunk-XW3F5EEW.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -10387,7 +10388,7 @@ var routeCatalog = [
     method: "post",
     path: "/api/v1/projects/{name}/discover/run",
     summary: "Start a tracked-basket discovery session",
-    description: 'Kicks off a discovery session for the project. The pipeline: ICP description \u2192 Gemini grounded seed prompt \u2192 embed + cluster (cosine \u2265 0.85 by default) \u2192 pick canonical representatives \u2192 probe each canonical via Gemini grounding \u2192 classify into cited / aspirational / wasted-surface \u2192 aggregate competitor map. Returns immediately with `{ runId, sessionId, status: "running" }`; the actual work runs in the background. Poll `GET /projects/{name}/discover/sessions/{id}` until `status` is `completed` or `failed`.',
+    description: 'Kicks off a discovery session for the project. The pipeline: ICP description \u2192 Gemini grounded seed prompt \u2192 embed + cluster (cosine \u2265 0.85 by default) \u2192 pick canonical representatives \u2192 probe each canonical via Gemini grounding \u2192 classify into cited / aspirational / wasted-surface \u2192 aggregate competitor map. Returns immediately with `{ runId, sessionId, status: "running", consolidated }`; the actual work runs in the background. Poll `GET /projects/{name}/discover/sessions/{id}` until `status` is `completed` or `failed`. Concurrent/duplicate requests for the same (project, ICP) are consolidated onto a single in-flight session: the response carries `consolidated: true` and `200 OK` instead of `201`, and the request\'s `dedupThreshold` / `maxProbes` are ignored (the in-flight session keeps its original config).',
     tags: ["discovery"],
     parameters: [nameParameter],
     requestBody: {
@@ -10399,14 +10400,20 @@ var routeCatalog = [
             properties: {
               icpDescription: { type: "string", description: "Free-text ICP. Required if the project does not have spec.icpDescription stored." },
               dedupThreshold: { type: "number", description: "Cosine similarity threshold for clustering. Defaults to 0.85." },
-              maxProbes: { type: "integer", description: "Max canonical queries to probe in this session. Default 100, hard cap 500." }
+              maxProbes: { type: "integer", description: "Max canonical queries to probe in this session. Default 100, hard cap 500." },
+              locations: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional override of the project location labels used to geo-constrain seed generation. Each label must match a configured project location; an unknown label is a 400. Omit to use every project location."
+              }
             }
           }
         }
       }
     },
     responses: {
-      201: { description: "Discovery session enqueued; returns { runId, sessionId, status }." },
+      200: { description: "An in-flight session with the same project + ICP was reused; returns { runId, sessionId, status, consolidated: true }. The request's dedupThreshold / maxProbes are ignored." },
+      201: { description: "New discovery session enqueued; returns { runId, sessionId, status, consolidated: false }." },
       400: { description: "Missing or invalid ICP / parameters." },
       404: { description: "Project not found." }
     }
@@ -20003,7 +20010,8 @@ async function doctorRoutes(app, opts) {
 // ../api-routes/src/discovery/routes.ts
 import crypto21 from "crypto";
-import { eq as eq25, desc as desc13 } from "drizzle-orm";
+import { and as and16, desc as desc13, eq as eq25, gte as gte4, inArray as inArray8 } from "drizzle-orm";
+var MAX_INFLIGHT_DISCOVERY_AGE_MS = 2 * 60 * 60 * 1e3;
 async function discoveryRoutes(app, opts) {
   app.post("/projects/:name/discover/run", async (request, reply) => {
     const project = resolveProject(app.db, request.params.name);
@@ -20022,15 +20030,33 @@ async function discoveryRoutes(app, opts) {
         "icpDescription is required. Pass it in the request body or store it on the project (spec.icpDescription)."
       );
     }
+    const locations = resolveLocations(
+      parseJsonColumn(project.locations, []),
+      parsed.data.locations
+    );
     if (!opts.onDiscoveryRunRequested) {
       throw validationError("Discovery is not available on this deployment.", {
         reason: "no-discovery-handler"
       });
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const sessionId = crypto21.randomUUID();
-    const runId = crypto21.randomUUID();
-    app.db.transaction((tx) => {
+    const ageFloorIso = new Date(Date.now() - MAX_INFLIGHT_DISCOVERY_AGE_MS).toISOString();
+    const decision = app.db.transaction((tx) => {
+      const existing = tx.select({ id: discoverySessions.id, runId: discoverySessions.runId }).from(discoverySessions).where(and16(
+        eq25(discoverySessions.projectId, project.id),
+        eq25(discoverySessions.icpDescription, icpDescription),
+        inArray8(discoverySessions.status, [
+          DiscoverySessionStatuses.queued,
+          DiscoverySessionStatuses.seeding,
+          DiscoverySessionStatuses.probing
+        ]),
+        gte4(discoverySessions.createdAt, ageFloorIso)
+      )).orderBy(desc13(discoverySessions.createdAt)).get();
+      if (existing && existing.runId) {
+        return { reused: true, sessionId: existing.id, runId: existing.runId };
+      }
+      const sessionId = crypto21.randomUUID();
+      const runId = crypto21.randomUUID();
       tx.insert(discoverySessions).values({
         id: sessionId,
         projectId: project.id,
@@ -20056,16 +20082,31 @@ async function discoveryRoutes(app, opts) {
         entityType: "discovery_session",
         entityId: sessionId
       });
+      return { reused: false, sessionId, runId };
     });
+    if (decision.reused) {
+      return reply.status(200).send({
+        runId: decision.runId,
+        sessionId: decision.sessionId,
+        status: "running",
+        consolidated: true
+      });
+    }
     opts.onDiscoveryRunRequested({
-      runId,
-      sessionId,
+      runId: decision.runId,
+      sessionId: decision.sessionId,
       projectId: project.id,
       icpDescription,
       dedupThreshold: parsed.data.dedupThreshold,
-      maxProbes: parsed.data.maxProbes
+      maxProbes: parsed.data.maxProbes,
+      locations
+    });
+    return reply.status(201).send({
+      runId: decision.runId,
+      sessionId: decision.sessionId,
+      status: "running",
+      consolidated: false
     });
-    return reply.status(201).send({ runId, sessionId, status: "running" });
   });
   app.get(
     "/projects/:name/discover/sessions",
@@ -20343,7 +20384,8 @@ async function executeDiscovery(opts) {
   }).where(eq26(discoverySessions.id, opts.sessionId)).run();
   const seedResult = await opts.deps.seed({
     project: opts.project,
-    icpDescription: opts.icpDescription
+    icpDescription: opts.icpDescription,
+    locations: opts.locations ?? []
   });
   const rawCandidates = dedupeStrings(seedResult.candidates);
   const seedCountRaw = rawCandidates.length;
@@ -23316,7 +23358,7 @@ import crypto24 from "crypto";
 import fs7 from "fs";
 import path9 from "path";
 import os5 from "os";
-import { and as and16, eq as eq27, inArray as inArray8, sql as sql10 } from "drizzle-orm";
+import { and as and17, eq as eq27, inArray as inArray9, sql as sql10 } from "drizzle-orm";
 // src/run-telemetry.ts
 import crypto23 from "crypto";
@@ -23657,7 +23699,7 @@ var JobRunner = class {
     this.registry = registry;
   }
   recoverStaleRuns() {
-    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray8(runs.status, ["running", "queued"])).all();
+    const stale = this.db.select({ id: runs.id, status: runs.status }).from(runs).where(inArray9(runs.status, ["running", "queued"])).all();
     if (stale.length === 0) return;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const run of stale) {
@@ -23695,7 +23737,7 @@ var JobRunner = class {
         throw new Error(`Run ${runId} is not executable from status '${existingRun.status}'`);
       }
       if (existingRun.status === "queued") {
-        this.db.update(runs).set({ status: "running", startedAt: now }).where(and16(eq27(runs.id, runId), eq27(runs.status, "queued"))).run();
+        this.db.update(runs).set({ status: "running", startedAt: now }).where(and17(eq27(runs.id, runId), eq27(runs.status, "queued"))).run();
       }
       this.throwIfRunCancelled(runId);
       const project = this.db.select().from(projects).where(eq27(projects.id, projectId)).get();
@@ -23720,7 +23762,7 @@ var JobRunner = class {
       }
       log.info("run.dispatch", { runId, providerCount: activeProviders.length, providers: activeProviders.map((p) => p.adapter.name) });
       const scopedQueryNames = parseJsonColumn(existingRun.queries, null);
-      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and16(eq27(queries.projectId, projectId), inArray8(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
+      projectQueries = scopedQueryNames ? this.db.select().from(queries).where(and17(eq27(queries.projectId, projectId), inArray9(queries.query, scopedQueryNames))).all() : this.db.select().from(queries).where(eq27(queries.projectId, projectId)).all();
       const projectCompetitors = this.db.select().from(competitors).where(eq27(competitors.projectId, projectId)).all();
       const competitorDomains = projectCompetitors.map((c) => c.domain);
       const allDomains = effectiveDomains({
@@ -24056,7 +24098,7 @@ function buildPhases(input) {
 // src/gsc-sync.ts
 import crypto25 from "crypto";
-import { eq as eq28, and as and17, sql as sql11 } from "drizzle-orm";
+import { eq as eq28, and as and18, sql as sql11 } from "drizzle-orm";
 var log2 = createLogger("GscSync");
 function formatDate3(d) {
   return d.toISOString().split("T")[0];
@@ -24108,7 +24150,7 @@ async function executeGscSync(db, runId, projectId, opts) {
     });
     log2.info("fetch.complete", { runId, projectId, rowCount: rows.length });
     db.delete(gscSearchData).where(
-      and17(
+      and18(
         eq28(gscSearchData.projectId, projectId),
         sql11`${gscSearchData.date} >= ${startDate}`,
         sql11`${gscSearchData.date} <= ${endDate}`
@@ -24197,7 +24239,7 @@ async function executeGscSync(db, runId, projectId, opts) {
       }
     }
     const snapshotDate = formatDate3(/* @__PURE__ */ new Date());
-    db.delete(gscCoverageSnapshots).where(and17(eq28(gscCoverageSnapshots.projectId, projectId), eq28(gscCoverageSnapshots.date, snapshotDate))).run();
+    db.delete(gscCoverageSnapshots).where(and18(eq28(gscCoverageSnapshots.projectId, projectId), eq28(gscCoverageSnapshots.date, snapshotDate))).run();
     db.insert(gscCoverageSnapshots).values({
       id: crypto25.randomUUID(),
       projectId,
@@ -24220,7 +24262,7 @@ async function executeGscSync(db, runId, projectId, opts) {
 // src/gsc-inspect-sitemap.ts
 import crypto26 from "crypto";
-import { eq as eq29, and as and18 } from "drizzle-orm";
+import { eq as eq29, and as and19 } from "drizzle-orm";
 // src/sitemap-parser.ts
 var log3 = createLogger("SitemapParser");
@@ -24436,7 +24478,7 @@ async function executeInspectSitemap(db, runId, projectId, opts) {
       }
     }
     const snapshotDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    db.delete(gscCoverageSnapshots).where(and18(eq29(gscCoverageSnapshots.projectId, projectId), eq29(gscCoverageSnapshots.date, snapshotDate))).run();
+    db.delete(gscCoverageSnapshots).where(and19(eq29(gscCoverageSnapshots.projectId, projectId), eq29(gscCoverageSnapshots.date, snapshotDate))).run();
     db.insert(gscCoverageSnapshots).values({
       id: crypto26.randomUUID(),
       projectId,
@@ -24647,7 +24689,7 @@ async function executeBingInspectSitemap(db, runId, projectId, opts) {
 // src/commoncrawl-sync.ts
 import crypto28 from "crypto";
 import path10 from "path";
-import { and as and19, eq as eq31, sql as sql12 } from "drizzle-orm";
+import { and as and20, eq as eq31, sql as sql12 } from "drizzle-orm";
 var log6 = createLogger("CommonCrawlSync");
 var INSERT_CHUNK_SIZE = 1e4;
 function defaultDeps() {
@@ -24838,7 +24880,7 @@ function computeSummary(rows) {
 // src/backlink-extract.ts
 import crypto29 from "crypto";
 import fs8 from "fs";
-import { and as and20, desc as desc15, eq as eq32 } from "drizzle-orm";
+import { and as and21, desc as desc15, eq as eq32 } from "drizzle-orm";
 var log7 = createLogger("BacklinkExtract");
 function defaultDeps2() {
   return {
@@ -24884,7 +24926,7 @@ async function executeBacklinkExtract(db, runId, projectId, opts = {}) {
     const targetDomain = project.canonicalDomain;
     db.transaction((tx) => {
       tx.delete(backlinkDomains).where(
-        and20(eq32(backlinkDomains.projectId, projectId), eq32(backlinkDomains.release, release))
+        and21(eq32(backlinkDomains.projectId, projectId), eq32(backlinkDomains.release, release))
       ).run();
       if (rows.length > 0) {
         const values = rows.map((r) => ({
@@ -24984,6 +25026,7 @@ async function executeDiscoveryRun(opts) {
       icpDescription: opts.icpDescription,
       dedupThreshold: opts.dedupThreshold,
       maxProbes: opts.maxProbes,
+      locations: opts.locations,
       deps
     });
     writeDiscoveryInsight(opts.db, {
@@ -25141,12 +25184,32 @@ function extractClassificationCategory(line) {
   }
   return null;
 }
+function formatLocationLine(location) {
+  return [location.city, location.region, location.country].map((part) => part.trim()).filter(Boolean).join(", ");
+}
+function buildLocationConstraint(locations) {
+  if (locations.length === 0) return [];
+  const formatted = locations.map(formatLocationLine);
+  if (locations.length === 1) {
+    return [
+      `The business serves ${formatted[0]}. Every query must be relevant to that service area \u2014 work the city or region into the query the way a real searcher would.`
+    ];
+  }
+  const perLocation = Math.max(1, Math.floor(DEFAULT_SEED_COUNT / locations.length));
+  return [
+    "The business serves these locations:",
+    ...formatted.map((line) => ` - ${line}`),
+    `Generate at least ${perLocation} queries for EACH service area listed above so coverage stays balanced \u2014 do not let one area dominate. Every query must be relevant to at least one of these service areas, working the city or region into the query the way a real searcher would.`
+  ];
+}
 function buildSeedPrompt(input) {
+  const locationConstraint = buildLocationConstraint(input.locations ?? []);
   return [
     "You are an AEO (Answer Engine Optimization) analyst expanding a tracked-query basket for a customer.",
     "",
     `Customer: ${input.project.name} (domains: ${input.project.canonicalDomains.join(", ")})`,
     `ICP: ${input.icpDescription}`,
+    ...locationConstraint.length > 0 ? ["", ...locationConstraint] : [],
     "",
     "Brainstorm a wide set of queries a member of this ICP would type into an AI answer engine (Gemini, ChatGPT, Perplexity) when they are about to make a decision in this space. Aim for 30+ candidates covering:",
     ' - Comparison queries ("best X for Y")',
@@ -25280,7 +25343,7 @@ var ProviderRegistry = class {
 // src/scheduler.ts
 import cron from "node-cron";
-import { and as and21, eq as eq34 } from "drizzle-orm";
+import { and as and22, eq as eq34 } from "drizzle-orm";
 var log9 = createLogger("Scheduler");
 function taskKey(projectId, kind) {
   return `${projectId}::${kind}`;
@@ -25325,7 +25388,7 @@ var Scheduler = class {
       this.stopTask(key, existing, "Stopped");
       this.tasks.delete(key);
     }
-    const schedule = this.db.select().from(schedules).where(and21(eq34(schedules.projectId, projectId), eq34(schedules.kind, kind))).get();
+    const schedule = this.db.select().from(schedules).where(and22(eq34(schedules.projectId, projectId), eq34(schedules.kind, kind))).get();
     if (schedule && schedule.enabled === 1) {
       this.registerCronTask(schedule);
     }
@@ -25449,7 +25512,7 @@ var Scheduler = class {
 };
 // src/notifier.ts
-import { eq as eq35, desc as desc16, and as and22, inArray as inArray9, or as or4 } from "drizzle-orm";
+import { eq as eq35, desc as desc16, and as and23, inArray as inArray10, or as or4 } from "drizzle-orm";
 import crypto31 from "crypto";
 var log10 = createLogger("Notifier");
 var Notifier = class {
@@ -25556,7 +25619,7 @@ var Notifier = class {
   computeTransitions(runId, projectId) {
     const thisRun = this.db.select().from(runs).where(eq35(runs.id, runId)).get();
     if (!thisRun) return [];
-    const groupSiblings = this.db.select().from(runs).where(and22(
+    const groupSiblings = this.db.select().from(runs).where(and23(
       eq35(runs.projectId, projectId),
       eq35(runs.kind, thisRun.kind),
       eq35(runs.createdAt, thisRun.createdAt)
@@ -25582,7 +25645,7 @@ var Notifier = class {
     );
     const RECENT_FETCH_LIMIT = Math.max(8, locationCount * 4);
     const recentRuns = this.db.select().from(runs).where(
-      and22(
+      and23(
         eq35(runs.projectId, projectId),
         eq35(runs.kind, thisRun.kind),
         or4(eq35(runs.status, "completed"), eq35(runs.status, "partial"))
@@ -25602,13 +25665,13 @@ var Notifier = class {
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).leftJoin(queries, eq35(querySnapshots.queryId, queries.id)).where(inArray9(querySnapshots.runId, currentRunIds)).all();
+    }).from(querySnapshots).leftJoin(queries, eq35(querySnapshots.queryId, queries.id)).where(inArray10(querySnapshots.runId, currentRunIds)).all();
     const previousSnapshots = this.db.select({
       queryId: querySnapshots.queryId,
       provider: querySnapshots.provider,
       location: querySnapshots.location,
       citationState: querySnapshots.citationState
-    }).from(querySnapshots).where(inArray9(querySnapshots.runId, previousRunIds)).all();
+    }).from(querySnapshots).where(inArray10(querySnapshots.runId, previousRunIds)).all();
     const prevMap = /* @__PURE__ */ new Map();
     for (const s of previousSnapshots) {
       prevMap.set(`${s.queryId}:${s.provider}:${s.location ?? ""}`, s.citationState);
@@ -26119,7 +26182,7 @@ function resolveSessionProviderAndModel(config, opts) {
 // src/agent/memory-store.ts
 import crypto32 from "crypto";
-import { and as and23, desc as desc17, eq as eq37, like as like2, sql as sql13 } from "drizzle-orm";
+import { and as and24, desc as desc17, eq as eq37, like as like2, sql as sql13 } from "drizzle-orm";
 var COMPACTION_KEY_PREFIX = "compaction:";
 var COMPACTION_NOTES_PER_SESSION = 3;
 function rowToDto2(row) {
@@ -26164,12 +26227,12 @@ function upsertMemoryEntry(db, args) {
       updatedAt: now
     }
   }).run();
-  const row = db.select().from(agentMemory).where(and23(eq37(agentMemory.projectId, args.projectId), eq37(agentMemory.key, args.key))).get();
+  const row = db.select().from(agentMemory).where(and24(eq37(agentMemory.projectId, args.projectId), eq37(agentMemory.key, args.key))).get();
   if (!row) throw new Error("memory upsert produced no row");
   return rowToDto2(row);
 }
 function deleteMemoryEntry(db, projectId, key) {
-  const result = db.delete(agentMemory).where(and23(eq37(agentMemory.projectId, projectId), eq37(agentMemory.key, key))).run();
+  const result = db.delete(agentMemory).where(and24(eq37(agentMemory.projectId, projectId), eq37(agentMemory.key, key))).run();
   const changes = result.changes ?? 0;
   return changes > 0;
 }
@@ -26198,7 +26261,7 @@ function writeCompactionNote(db, args) {
     }).run();
     const sessionPrefix = `${COMPACTION_KEY_PREFIX}${args.sessionId}:`;
     const existing = tx.select({ id: agentMemory.id, updatedAt: agentMemory.updatedAt }).from(agentMemory).where(
-      and23(
+      and24(
         eq37(agentMemory.projectId, args.projectId),
         like2(agentMemory.key, `${sessionPrefix}%`)
       )
@@ -26207,7 +26270,7 @@ function writeCompactionNote(db, args) {
     if (stale.length > 0) {
       tx.delete(agentMemory).where(sql13`${agentMemory.id} IN (${sql13.join(stale.map((s) => sql13`${s}`), sql13`, `)})`).run();
     }
-    const row = tx.select().from(agentMemory).where(and23(eq37(agentMemory.projectId, args.projectId), eq37(agentMemory.key, key))).get();
+    const row = tx.select().from(agentMemory).where(and24(eq37(agentMemory.projectId, args.projectId), eq37(agentMemory.key, key))).get();
     if (row) inserted = rowToDto2(row);
   });
   if (!inserted) throw new Error("compaction note write produced no row");
@@ -28308,7 +28371,8 @@ async function createServer(opts) {
         projectId: input.projectId,
         icpDescription: input.icpDescription,
         dedupThreshold: input.dedupThreshold,
-        maxProbes: input.maxProbes
+        maxProbes: input.maxProbes,
+        locations: input.locations
       }).then(() => runCoordinator.onRunCompleted(input.runId, input.projectId)).catch((err) => {
         app.log.error({ runId: input.runId, err }, "Discovery run failed");
       });

package/dist/{chunk-5M4PP6P4.js → chunk-XW3F5EEW.js} RENAMED Viewed

@@ -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,