@ainyc/canonry 5.0.1 → 5.1.2

package/dist/{chunk-GMNZNLVX.js → chunk-BS4ZC7FG.js}

@@ -15,8 +15,9 @@ import {
   loadConfig,
   loadConfigRaw,
   resolveOperatorApiKeyIds,
+  runWithUsageTags,
   saveConfigPatch
-} from "./chunk-MEQGGODM.js";
+} from "./chunk-5K2NUQOV.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -167,9 +168,10 @@ import {
   siteCrawlSnapshots,
   toAlertView,
   usageCounters
-} from "./chunk-LHHJVGH7.js";
+} from "./chunk-WSYJ4IT7.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
+  AGENT_NONE,
   AGENT_PROVIDER_IDS,
   AI_ENGINE_DOMAINS,
   AI_ENGINE_SELF_DOMAINS,
@@ -247,6 +249,7 @@ import {
   deriveIndexCoverage,
   deriveSiteHealthState,
   describeError,
+  detectAgentRuntime,
   determineAnswerMentioned,
   dollarsToMicros,
   effectiveBrandNames,
@@ -283,6 +286,7 @@ import {
   mapWithConcurrency,
   maskTelemetryAnonymousId,
   nextScheduleUpdatedAt,
+  normalizeAgentSlug,
   normalizeIdTokens,
   normalizeMeasurementExecutionQueryText,
   normalizeServedModel,
@@ -309,10 +313,19 @@ import {
   templateLinkUbiquityAvailable,
   textContainsBrandAlias,
   textContainsDomain,
+  usageSurfaceSchema,
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-3DL3KV6C.js";
+} from "./chunk-5ZIUROAQ.js";
+
+// src/runtime-context.ts
+function cliRuntimeContext(env = process.env, stdio = process) {
+  return {
+    agent: detectAgentRuntime(env),
+    interactive: Boolean(stdio.stdin.isTTY && stdio.stdout.isTTY)
+  };
+}
 
 // src/telemetry.ts
 import crypto from "crypto";
@@ -343,7 +356,8 @@ function trackCliCommandFinished(input) {
       command: input.command,
       success: input.success,
       duration_bucket: bucketCliCommandDuration(input.durationMs),
-      ...input.setupState ? { setup_state: input.setupState } : {}
+      ...input.setupState ? { setup_state: input.setupState } : {},
+      ...cliRuntimeContext()
     },
     input.errorCode ? { errorCode: input.errorCode } : void 0
   );
@@ -418,7 +432,8 @@ function getOrCreateAnonymousId() {
     try {
       const config = loadConfig();
       if (config.anonymousId) return config.anonymousId;
-      const id = crypto.randomUUID();
+      const carried = preConfigAnonymousId?.configPath === getConfigPath() ? preConfigAnonymousId.id : void 0;
+      const id = carried ?? crypto.randomUUID();
       config.anonymousId = id;
       try {
         saveConfigPatch(config);
@@ -430,8 +445,11 @@ function getOrCreateAnonymousId() {
       return getDeterministicAnonymousId();
     }
   }
-  return getDeterministicAnonymousId();
+  const fallback = getDeterministicAnonymousId();
+  if (fallback) preConfigAnonymousId = { configPath: getConfigPath(), id: fallback };
+  return fallback;
 }
+var preConfigAnonymousId;
 function readEnvAnonymousId() {
   const raw = process.env[ANON_ID_ENV_VAR]?.trim();
   if (!raw) return void 0;
@@ -506,10 +524,19 @@ function detectAndTrackUpgrade() {
   trackEvent("cli.upgraded", { fromVersion: lastSeen, toVersion: VERSION });
 }
 function trackEvent(event, properties, options) {
-  if (!isTelemetryEnabled()) return;
-  if (shouldDropTelemetryEvent(event, properties)) return;
+  void deliverEvent(event, properties, options);
+}
+function setTelemetryPreference(enabled, method) {
+  loadConfig();
+  const announce = !enabled && isTelemetryEnabled();
+  saveConfigPatch({ telemetry: enabled });
+  return announce ? deliverEvent("telemetry.disabled", { method }, void 0, { preferenceChecked: true }) : Promise.resolve();
+}
+function deliverEvent(event, properties, options, delivery = {}) {
+  if (!delivery.preferenceChecked && !isTelemetryEnabled()) return Promise.resolve();
+  if (shouldDropTelemetryEvent(event, properties)) return Promise.resolve();
   const anonymousId = getOrCreateAnonymousId();
-  if (!anonymousId) return;
+  if (!anonymousId) return Promise.resolve();
   const payload = {
     eventId: options?.eventId ?? crypto.randomUUID(),
     anonymousId,
@@ -529,15 +556,15 @@ function trackEvent(event, properties, options) {
   const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
   timeout.unref();
   try {
-    void fetch(TELEMETRY_ENDPOINT, {
+    return fetch(TELEMETRY_ENDPOINT, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(payload),
       signal: controller.signal
-    }).catch(() => {
-    }).finally(() => clearTimeout(timeout));
+    }).then(() => void 0, () => void 0).finally(() => clearTimeout(timeout));
   } catch {
     clearTimeout(timeout);
+    return Promise.resolve();
   }
 }
 
@@ -6280,13 +6307,93 @@ function removeWordpressConnection(config, projectName) {
   return true;
 }
 
+// src/usage-telemetry.ts
+var API_REQUEST_BUCKET_CAPACITY = 20;
+var API_REQUEST_REFILL_PER_MS = 1 / 1e4;
+var MAX_TRACKED_MCP_SESSIONS = 2e3;
+var MAX_ROUTE_LENGTH = 200;
+var SKIPPED_ROUTE_PATTERN = /(?:^|\/)(?:health|openapi\.json|telemetry)(?:\/|$)/;
+var MCP_CALL_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var MCP_TOOL_PATTERN = /^[a-z][a-z0-9_]{0,79}$/;
+function classifyUsageSurface(info) {
+  const labelled = usageSurfaceSchema.safeParse(info.usageLabels.surface);
+  if (labelled.success) return labelled.data;
+  const ua = info.userAgent ?? "";
+  if (ua.startsWith("canonry-cli")) return "cli";
+  if (ua.startsWith("canonry-mcp/")) return "mcp-http";
+  if (ua === "canonry-mcp") return "mcp-stdio";
+  if (ua.startsWith("Mozilla/")) return "dashboard";
+  return "api";
+}
+function statusClass(statusCode) {
+  if (statusCode >= 500) return "5xx";
+  if (statusCode >= 400) return "4xx";
+  if (statusCode >= 300) return "3xx";
+  return "2xx";
+}
+function createApiUsageTelemetry(options = {}) {
+  const emit = options.emit ?? trackEvent;
+  const now = options.now ?? Date.now;
+  let tokens = API_REQUEST_BUCKET_CAPACITY;
+  let refilledAt = now();
+  let droppedBefore = 0;
+  const seenSessions = /* @__PURE__ */ new Set();
+  const takeToken = () => {
+    const at = now();
+    tokens = Math.min(API_REQUEST_BUCKET_CAPACITY, tokens + (at - refilledAt) * API_REQUEST_REFILL_PER_MS);
+    refilledAt = at;
+    if (tokens < 1) return false;
+    tokens -= 1;
+    return true;
+  };
+  return (info) => {
+    if (info.method === "OPTIONS" || info.method === "HEAD") return;
+    if (SKIPPED_ROUTE_PATTERN.test(info.route)) return;
+    const surface = classifyUsageSurface(info);
+    if (surface === "cli" || surface === "dashboard") return;
+    const labels = info.usageLabels;
+    const mcpClient = normalizeAgentSlug(labels.mcpClient);
+    const detected = normalizeAgentSlug(labels.agent);
+    const agent = detected && detected !== AGENT_NONE ? detected : mcpClient ?? detected ?? AGENT_NONE;
+    const mcpTool = labels.mcpTool && MCP_TOOL_PATTERN.test(labels.mcpTool) ? labels.mcpTool : void 0;
+    const mcpCallId = labels.mcpCall && MCP_CALL_ID_PATTERN.test(labels.mcpCall) ? labels.mcpCall.toLowerCase() : void 0;
+    const isMcp = surface === "mcp-stdio" || surface === "mcp-http";
+    if (isMcp && mcpTool && info.actorSession && !seenSessions.has(info.actorSession)) {
+      if (seenSessions.size >= MAX_TRACKED_MCP_SESSIONS) {
+        const oldest = seenSessions.values().next().value;
+        if (oldest !== void 0) seenSessions.delete(oldest);
+      }
+      seenSessions.add(info.actorSession);
+      emit("mcp.session.started", { surface, agent, ...mcpClient ? { mcpClient } : {} }, { source: "cli-server" });
+    }
+    if (!takeToken()) {
+      droppedBefore += 1;
+      return;
+    }
+    const properties = {
+      surface,
+      agent,
+      method: info.method,
+      route: info.route.slice(0, MAX_ROUTE_LENGTH),
+      statusClass: statusClass(info.statusCode),
+      durationBucket: bucketCliCommandDuration(info.durationMs),
+      ...mcpClient ? { mcpClient } : {},
+      ...mcpTool ? { mcpTool } : {},
+      ...mcpCallId ? { mcpCallId } : {},
+      ...droppedBefore > 0 ? { droppedBefore } : {}
+    };
+    droppedBefore = 0;
+    emit("api.request", properties, { source: "cli-server" });
+  };
+}
+
 // src/instance-identity.ts
 function nonBlank(value) {
   const trimmed = value?.trim();
   return trimmed ? trimmed : void 0;
 }
 function resolveBuildCommit(env = process.env) {
-  const embedded = true ? "92ebeea19d64dffdadfcfaf8dcb2696e34c8636b" : void 0;
+  const embedded = true ? "267b6410fa27a2bf032d4957047859e1f9eee6d1" : void 0;
   return nonBlank(embedded) ?? nonBlank(env.CANONRY_COMMIT);
 }
 function resolveInstanceIdentity(env = process.env) {
@@ -6342,6 +6449,30 @@ function buildRunCompletedProps(input) {
   if (input.location) props.location = input.location;
   return props;
 }
+function buildSiteAuditCompletedProps(input) {
+  const props = {
+    status: input.status,
+    durationMs: Date.now() - input.startTime
+  };
+  if (input.trigger) props.trigger = input.trigger;
+  const domainHash = hashDomain(input.canonicalDomain ?? null);
+  if (domainHash) props.domainHash = domainHash;
+  const crawl = input.crawl;
+  if (!crawl) return props;
+  props.complete = crawl.complete;
+  if (crawl.termination) props.termination = crawl.termination;
+  props.pagesDiscovered = crawl.pagesDiscovered;
+  props.pagesFetched = crawl.pagesFetched;
+  props.pagesAudited = crawl.pagesAudited;
+  props.pagesErrored = crawl.pagesErrored;
+  if (crawl.pagesAudited > 0 && typeof crawl.aggregateScore === "number" && Number.isFinite(crawl.aggregateScore)) {
+    props.aggregateScore = crawl.aggregateScore;
+  }
+  props.pageBudget = crawl.pageBudget;
+  props.checkDeadLinks = crawl.checkDeadLinks;
+  if (crawl.checkDeadLinks) props.deadLinksFound = crawl.deadLinksFound;
+  return props;
+}
 
 // src/provider-execution-gate.ts
 var ProviderExecutionGate = class {
@@ -6610,7 +6741,14 @@ var JobRunner = class {
     this.registry = registry;
   }
   recoverStaleRuns() {
-    const stale = this.db.select({ id: runs.id, projectId: runs.projectId, kind: runs.kind, status: runs.status }).from(runs).where(inArray(runs.status, ["running", "queued"])).all();
+    const stale = this.db.select({
+      id: runs.id,
+      projectId: runs.projectId,
+      kind: runs.kind,
+      status: runs.status,
+      trigger: runs.trigger,
+      startedAt: runs.startedAt
+    }).from(runs).where(inArray(runs.status, ["running", "queued"])).all();
     if (stale.length === 0) return;
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const run of stale) {
@@ -6628,6 +6766,35 @@ var JobRunner = class {
       });
       if (!recovered) continue;
       log2.warn("run.recovered-stale", { runId: run.id, previousStatus: run.status });
+      if (run.kind === RunKinds["site-audit"]) this.trackRecoveredSiteAudit(run);
+    }
+  }
+  /**
+   * A crawl the process died under never reaches `executeSiteAudit`'s terminal
+   * telemetry, so without this every interrupted audit vanishes from the data.
+   * Emitted after the recovery transaction commits. `durationMs` runs from the
+   * crawl's start to this recovery, so it includes the downtime and is an upper
+   * bound; a run that was still queued has no start and reports 0.
+   *
+   * The source is set explicitly: recovery runs during server construction,
+   * before `canonry serve` switches the process source to `cli-server`.
+   */
+  trackRecoveredSiteAudit(run) {
+    try {
+      const startedAt = run.startedAt ? Date.parse(run.startedAt) : Number.NaN;
+      const project = this.db.select({ canonicalDomain: projects.canonicalDomain }).from(projects).where(eq2(projects.id, run.projectId)).get();
+      trackEvent(
+        "site_audit.completed",
+        buildSiteAuditCompletedProps({
+          status: "failed",
+          startTime: Number.isFinite(startedAt) ? startedAt : Date.now(),
+          trigger: run.trigger,
+          canonicalDomain: project?.canonicalDomain ?? null
+        }),
+        { errorCode: "SERVER_RESTARTED", source: "cli-server" }
+      );
+    } catch (err) {
+      log2.warn("telemetry.recovered-site-audit-failed", { runId: run.id, error: describeError(err) });
     }
   }
   async executeRun(runId, projectId, providerOverride, locationOverride) {
@@ -7149,6 +7316,7 @@ var JobRunner = class {
       if (existingRun.kind === "answer-visibility" && runTrigger !== "probe" && totalSnapshotsInserted > 0 && !this.hasPriorActivation(projectId, runId)) {
         trackEvent("activation.completed", {
           flowVersion: ONBOARDING_FLOW_VERSION,
+          kind: "answer_visibility",
           status: finalStatus,
           providerCountBucket: bucketOnboardingCount(executionContext.providerCount),
           queryCountBucket: bucketOnboardingCount(executionContext.queryCount),
@@ -10031,7 +10199,7 @@ function buildDiscoveryInsightTitle(input) {
 
 // src/execute-site-audit.ts
 import crypto19 from "crypto";
-import { and as and13, eq as eq15, sql as sql6 } from "drizzle-orm";
+import { and as and13, eq as eq15, ne as ne3, sql as sql6 } from "drizzle-orm";
 import { runSiteCrawl } from "@canonry/aeo-audit";
 
 // src/site-audit-root.ts
@@ -11108,10 +11276,35 @@ function deadLinkCheckedCount(edges, pages) {
   }
   return new Set([...edges].filter((edge) => edge.type === "anchor" && edge.classification === "internal" && attemptedUrls.has(edge.to)).map((edge) => edge.to)).size;
 }
+function trackSiteAuditOutcome(db, input) {
+  try {
+    const errorCode = input.status === "cancelled" ? "RUN_CANCELLED" : input.status === "failed" ? "UNKNOWN" : void 0;
+    trackEvent(
+      "site_audit.completed",
+      buildSiteAuditCompletedProps(input),
+      errorCode ? { errorCode } : void 0
+    );
+    const pagesAudited = input.crawl?.pagesAudited ?? 0;
+    if (pagesAudited === 0 || input.trigger === RunTriggers.probe) return;
+    const prior = db.select({ id: siteAuditSnapshots.id }).from(siteAuditSnapshots).where(and13(eq15(siteAuditSnapshots.projectId, input.projectId), ne3(siteAuditSnapshots.runId, input.runId))).limit(1).get();
+    if (prior) return;
+    trackEvent("activation.completed", {
+      flowVersion: ONBOARDING_FLOW_VERSION,
+      kind: "site_health",
+      status: input.status,
+      pagesAuditedBucket: bucketOnboardingCount(pagesAudited)
+    });
+  } catch (error) {
+    log13.warn("telemetry.failed", { runId: input.runId, projectId: input.projectId, error: describeError(error) });
+  }
+}
 async function executeSiteAudit(db, runId, projectId, opts = {}) {
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   const claim = db.update(runs).set({ status: "running", startedAt }).where(and13(eq15(runs.id, runId), eq15(runs.projectId, projectId), eq15(runs.status, "queued"))).run();
   if (claim.changes === 0) return;
+  const startTime = Date.now();
+  const trigger = db.select({ trigger: runs.trigger }).from(runs).where(eq15(runs.id, runId)).get()?.trigger ?? null;
+  let canonicalDomain = null;
   const attemptNumber = (db.select({ value: sql6`coalesce(max(${siteCrawlAttempts.attemptNumber}), 0)` }).from(siteCrawlAttempts).where(eq15(siteCrawlAttempts.runId, runId)).get()?.value ?? 0) + 1;
   const attemptId = crypto19.randomUUID();
   db.insert(siteCrawlAttempts).values({
@@ -11391,6 +11584,7 @@ async function executeSiteAudit(db, runId, projectId, opts = {}) {
   try {
     const project = db.select().from(projects).where(eq15(projects.id, projectId)).get();
     if (!project) throw new Error(`Project not found: ${projectId}`);
+    canonicalDomain = project.canonicalDomain;
     const homepageUrl = toHomepageUrl(project.canonicalDomain);
     const maxPages = clampSiteAuditLimit(opts.maxPages ?? opts.limit);
     const maxEdges = clampSiteAuditEdgeLimit(opts.maxEdges);
@@ -11610,6 +11804,26 @@ async function executeSiteAudit(db, runId, projectId, opts = {}) {
       throw new Error(`Site audit run was no longer running before publication: ${runId}`);
     }
     log13.info("completed", { runId, projectId, status: terminalStatus, complete: crawlSummary.complete, pages: crawlSummary.pagesObserved });
+    trackSiteAuditOutcome(db, {
+      runId,
+      projectId,
+      status: crawlSummary.complete ? "completed" : "partial",
+      startTime,
+      trigger,
+      canonicalDomain,
+      crawl: {
+        complete: crawlSummary.complete,
+        termination: crawlSummary.terminationReason,
+        pagesDiscovered: crawlSummary.pagesDiscovered,
+        pagesFetched: crawlSummary.pagesFetched,
+        pagesAudited: crawlSummary.auditRollup.auditedPages,
+        pagesErrored: errorCount,
+        aggregateScore: crawlSummary.auditRollup.aggregateScore,
+        pageBudget: maxPages,
+        checkDeadLinks: opts.checkDeadLinks ?? false,
+        deadLinksFound
+      }
+    });
   } catch (error) {
     const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
     const cancelled = isCancelled(error, opts.signal);
@@ -11628,6 +11842,14 @@ async function executeSiteAudit(db, runId, projectId, opts = {}) {
       }).where(and13(eq15(runs.id, runId), eq15(runs.status, "running"))).run();
     });
     log13.error("failed", { runId, projectId, cancelled, error: message });
+    trackSiteAuditOutcome(db, {
+      runId,
+      projectId,
+      status: cancelled ? "cancelled" : "failed",
+      startTime,
+      trigger,
+      canonicalDomain
+    });
     throw error;
   }
 }
@@ -12097,7 +12319,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-7XX5ZRYE.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-D2HY2S5F.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -14191,6 +14413,7 @@ import { Type as Type3 } from "@sinclair/typebox";
 
 // src/agent/mcp-to-agent-tool.ts
 import { Type as Type2 } from "@sinclair/typebox";
+import { randomUUID } from "crypto";
 var MAX_TOOL_RESULT_CHARS = 2e4;
 var TRUNCATION_NOTE = "... (truncated \u2014 result too large)";
 function serializeResult(value) {
@@ -14340,7 +14563,7 @@ function mcpToAgentTool(tool, ctx) {
   const parameters = Type2.Unsafe(visibleSchema);
   const execute = async (_toolCallId, params) => {
     const handlerInput = hadProject ? { ...params, project: ctx.projectName } : params;
-    const result = await tool.handler(ctx.client, handlerInput);
+    const result = await runWithUsageTags(ctx.client, { mcpTool: tool.name, mcpCall: randomUUID() }, () => tool.handler(ctx.client, handlerInput));
     return textResult2(result);
   };
   return {
@@ -15854,6 +16077,7 @@ function registerMcpHttpRoutes(scope, opts) {
     const client = new ApiClient(opts.selfApiUrl, sessionKey?.raw ?? bearer, {
       skipProbe: true,
       clientName: `canonry-mcp/${PACKAGE_VERSION}`,
+      surface: "mcp-http",
       // Correlation only: this is never accepted as caller identity or authority.
       actorSession: crypto26.randomUUID()
     });
@@ -17608,7 +17832,7 @@ function cloneGtmConfig(config) {
 function createGoogleMarketingConfigCredentialStore(input) {
   const persistConfigPatch = input.saveConfigPatch ?? saveConfigPatch;
   const env = input.env ?? process.env;
-  const randomUUID = input.randomUUID ?? crypto27.randomUUID;
+  const randomUUID2 = input.randomUUID ?? crypto27.randomUUID;
   const snapshot = () => ({
     googleAds: cloneGoogleAdsConfig(input.config.googleAds),
     gtm: cloneGtmConfig(input.config.gtm)
@@ -17656,7 +17880,7 @@ function createGoogleMarketingConfigCredentialStore(input) {
           upsertGoogleAdsConnection(input.config, {
             projectId: project.id,
             projectName: project.name,
-            credentialGeneration: randomUUID(),
+            credentialGeneration: randomUUID2(),
             ...credential.accessToken ? { accessToken: credential.accessToken } : {},
             refreshToken: credential.refreshToken ?? null,
             tokenExpiresAt: credential.expiresAt ?? null,
@@ -17668,7 +17892,7 @@ function createGoogleMarketingConfigCredentialStore(input) {
           upsertGtmConnection(input.config, {
             projectId: project.id,
             projectName: project.name,
-            credentialGeneration: randomUUID(),
+            credentialGeneration: randomUUID2(),
             ...credential.accessToken ? { accessToken: credential.accessToken } : {},
             refreshToken: credential.refreshToken ?? null,
             tokenExpiresAt: credential.expiresAt ?? null,
@@ -17781,6 +18005,10 @@ async function createServer(opts) {
   const notifier = new Notifier(opts.db, serverUrl);
   const intelligenceService = new IntelligenceService(opts.db);
   const aeroClient = new ApiClient(opts.config.apiUrl, opts.config.apiKey, {
+    skipProbe: true,
+    surface: "aero"
+  });
+  const schedulerClient = new ApiClient(opts.config.apiUrl, opts.config.apiKey, {
     skipProbe: true
   });
   const agentEnabled = resolveAgentEnabled(process.env, opts.config);
@@ -18221,7 +18449,7 @@ async function createServer(opts) {
     getRunnableProviderNames: () => registry.getAll().map((provider) => provider.adapter.name),
     getEffectiveProviderModels: () => effectiveProviderModels(registry),
     onTrafficSyncRequested: (projectName, sourceId) => {
-      aeroClient.trafficSync(projectName, sourceId).catch((err) => {
+      schedulerClient.trafficSync(projectName, sourceId).catch((err) => {
         app.log.error(
           {
             projectName,
@@ -18241,7 +18469,7 @@ async function createServer(opts) {
     onDoctorRequested: (projectName) => {
       void (async () => {
         try {
-          const report = await aeroClient.runDoctor({ project: projectName });
+          const report = await schedulerClient.runDoctor({ project: projectName });
           const project = opts.db.select().from(projects).where(eq26(projects.name, projectName)).get();
           if (!project) {
             app.log.warn({ projectName }, "doctor schedule fired for an unknown project");
@@ -18257,7 +18485,7 @@ async function createServer(opts) {
       })();
     },
     onDataRefreshRequested: (projectName) => {
-      void refreshAllIntegrations(aeroClient, projectName);
+      void refreshAllIntegrations(schedulerClient, projectName);
     },
     onBacklinksSyncRequested: (projectName) => {
       void (async () => {
@@ -18282,7 +18510,7 @@ async function createServer(opts) {
           );
           return;
         }
-        aeroClient.backlinksTriggerSync(probed.release).catch((err) => {
+        schedulerClient.backlinksTriggerSync(probed.release).catch((err) => {
           app.log.error(
             {
               projectName,
@@ -18783,6 +19011,9 @@ async function createServer(opts) {
   await app.register(apiRoutes, {
     db: opts.db,
     routePrefix: apiPrefix,
+    // Agent-surface usage (MCP, Aero, raw API). CLI and dashboard requests are
+    // measured elsewhere and skipped inside.
+    onRequestCompleted: createApiUsageTelemetry(),
     skipAuth: false,
     sessionCookieName: SESSION_COOKIE_NAME,
     resolveSessionApiKeyId,
@@ -19313,9 +19544,7 @@ async function createServer(opts) {
     listOperationalLogs: (query) => operationalLogs.list(query),
     getTelemetryStatus,
     setTelemetryEnabled: (enabled) => {
-      const config = loadConfig();
-      config.telemetry = enabled;
-      saveConfigPatch(config);
+      void setTelemetryPreference(enabled, "api");
       opts.config.telemetry = enabled;
     },
     recordOnboardingEvent: (event) => {
@@ -19647,6 +19876,7 @@ function parseQueryResponse(raw, count2) {
 }
 
 export {
+  cliRuntimeContext,
   trackCliCommandFinished,
   setTelemetrySource,
   getTelemetryStatus,
@@ -19656,6 +19886,7 @@ export {
   showFirstRunNotice,
   detectAndTrackUpgrade,
   trackEvent,
+  setTelemetryPreference,
   backfillAnswerVisibilityCommand,
   backfillNormalizedPaths,
   backfillNormalizedPathsCommand,

package/dist/{chunk-66KGNC4U.js → chunk-NKEKDWGX.js}

@@ -5,11 +5,11 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-MEQGGODM.js";
+} from "./chunk-5K2NUQOV.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-3DL3KV6C.js";
+} from "./chunk-5ZIUROAQ.js";
 
 // src/skills-autosync.ts
 import fs from "fs";