@canonry/canonry 5.11.0 → 5.13.0

package/dist/cli.js

@@ -35,11 +35,11 @@ import {
   trackCliCommandFinished,
   trackEvent,
   waitForServerRuntimeStartup
-} from "./chunk-UYSTNPTX.js";
+} from "./chunk-TDHRUXN3.js";
 import {
   autoSyncSkills,
   formatAutoSyncNotice
-} from "./chunk-NV3X6O5P.js";
+} from "./chunk-6YLNO2T5.js";
 import {
   CliError,
   EXIT_SYSTEM_ERROR,
@@ -66,13 +66,13 @@ import {
   shouldPrintServeSkillsNudge,
   systemError,
   usageError
-} from "./chunk-JW5DCORY.js";
+} from "./chunk-IPGBK7XR.js";
 import {
   DEFAULT_DEMO_TRUSTED_PROXIES,
   trustedProxiesProblem,
   trustedProxyProblem
 } from "./chunk-RB2F4D3Z.js";
-import "./chunk-JNU6GLAV.js";
+import "./chunk-IDZQ5H3J.js";
 import "./chunk-AOJU5LKX.js";
 import {
   CLOUDFLARE_WORKER_BINDINGS,
@@ -88,7 +88,7 @@ import {
   queries,
   renderReportHtml,
   runs
-} from "./chunk-SMYBGUVV.js";
+} from "./chunk-Q35D2R2P.js";
 import {
   AdsDeliverySnapshotStatuses,
   AdsHistoricalCampaignRollupStatuses,
@@ -173,7 +173,7 @@ import {
   snapshotProviderModeSchema,
   visibilityReportRequestSchema,
   winnabilityClassSchema
-} from "./chunk-MQMJJZ6W.js";
+} from "./chunk-UWJAATGC.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";
@@ -438,7 +438,7 @@ function parseDemoTrustedProxies(values) {
 async function demoCommand(options) {
   const { host, port } = parseDemoListenOptions(options);
   const trustProxy = parseDemoTrustedProxies(options.trustProxy);
-  const { createDemoServer } = await import("./demo-server-76IZBMJ3.js");
+  const { createDemoServer } = await import("./demo-server-IZFTJI7E.js");
   const app = await createDemoServer({ trustProxy });
   let stopping = false;
   const stop = () => {
@@ -12775,10 +12775,96 @@ function printRunDetail(run) {
     }
   }
 }
+var FILL_POLL_INTERVAL_MS = 3e3;
+var FILL_POLL_TIMEOUT_MS = 6 * 60 * 60 * 1e3;
+function missingSummary(completeness) {
+  const parts = Object.entries(completeness.missingByProvider).sort(([left], [right]) => left.localeCompare(right)).map(([provider, count]) => `${provider} ${count}`);
+  return parts.length ? parts.join(", ") : "none";
+}
+function printCompleteness(completeness) {
+  console.log(`Run: ${completeness.runId}`);
+  console.log(`  Status:   ${completeness.status}`);
+  if (!completeness.planned) {
+    console.log("  Not a measurement-plan run: there are no expected answers to count.");
+    return;
+  }
+  if (!completeness.readable) {
+    console.log("  Answers:  unknown (the run's manifest cannot be read)");
+  } else {
+    console.log(`  Answers:  ${completeness.executed}/${completeness.expected}`);
+    console.log(`  Missing:  ${completeness.missing} (${missingSummary(completeness)})`);
+  }
+  if (completeness.refusal) console.log(`  Fillable: no. ${completeness.refusal.message}`);
+  else console.log(`  Fillable: ${completeness.fillable ? "yes" : "not right now (a sweep or another fill is running)"}`);
+  const fill = completeness.latestFill;
+  if (fill) {
+    console.log(`  Last fill: ${fill.id} ${fill.status}, ${fill.filled}/${fill.expected} recorded${fill.error ? `. ${fill.error}` : ""}`);
+  }
+}
+async function showRunCompleteness(runId, format) {
+  const completeness = await getClient23().getRunCompleteness(runId);
+  if (isMachineFormat(format)) {
+    console.log(JSON.stringify(completeness, null, 2));
+    return;
+  }
+  printCompleteness(completeness);
+}
+async function fillRun(runId, opts = {}) {
+  const client = getClient23();
+  const response = await client.fillRun(runId, {
+    ...opts.providers?.length ? { providers: opts.providers } : {},
+    ...opts.dryRun ? { dryRun: true } : {}
+  });
+  if (!opts.wait || response.outcome !== "queued" || !response.fill) {
+    if (isMachineFormat(opts.format)) {
+      console.log(JSON.stringify(response, null, 2));
+      return;
+    }
+    if (response.outcome === "already-complete") console.log(`Run ${runId} is already complete: nothing to fill.`);
+    else if (response.outcome === "dry-run") console.log("Dry run: nothing was queued.");
+    else if (response.fill) console.log(`Fill ${response.fill.id} queued: ${response.fill.expected} missing answer(s) (${missingSummary(response.completeness)}).`);
+    printCompleteness(response.completeness);
+    return;
+  }
+  const fillId = response.fill.id;
+  const deadline = Date.now() + FILL_POLL_TIMEOUT_MS;
+  let completeness = response.completeness;
+  if (!isMachineFormat(opts.format)) {
+    process.stderr.write(`Filling ${response.fill.expected} missing answer(s) in run ${runId}`);
+  }
+  for (; ; ) {
+    await new Promise((resolve) => setTimeout(resolve, FILL_POLL_INTERVAL_MS));
+    if (Date.now() > deadline) {
+      throw new CliError({
+        code: "RUN_FILL_INCOMPLETE",
+        message: `Timed out waiting for fill ${fillId}; it may still be running. Check with: canonry run completeness ${runId}`,
+        exitCode: EXIT_SYSTEM_ERROR,
+        details: { runId, fillId }
+      });
+    }
+    completeness = await client.getRunCompleteness(runId);
+    if (!isMachineFormat(opts.format)) process.stderr.write(".");
+    const latest = completeness.latestFill;
+    const working = latest !== null && (latest.status === "queued" || latest.status === "running");
+    if (completeness.status === "completed" || !working) break;
+  }
+  if (!isMachineFormat(opts.format)) process.stderr.write("\n");
+  if (isMachineFormat(opts.format)) console.log(JSON.stringify(completeness, null, 2));
+  else printCompleteness(completeness);
+  if (completeness.status !== "completed") {
+    throw new CliError({
+      code: "RUN_FILL_INCOMPLETE",
+      message: `Run ${runId} is still ${completeness.status}: ${completeness.missing} answer(s) missing (${missingSummary(completeness)}).`,
+      exitCode: EXIT_SYSTEM_ERROR,
+      details: { runId, fillId, missing: completeness.missing, missingByProvider: completeness.missingByProvider }
+    });
+  }
+}
 
 // src/cli-commands/run.ts
 var RUN_TRIGGER_USAGE = "canonry run trigger <project> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--wait] [--format json]";
 var RUN_USAGE2 = "canonry run <project|--all> [--group <key>]... [--target <key>]... [--provider <name>] [--query <q>...] [--location <label>] [--all-locations] [--no-location] [--probe] [--wait] [--format json]";
+var RUN_FILL_USAGE = "canonry run fill <run-id> [--provider <name>[,<name>]] [--dry-run] [--wait] [--format json]";
 var RUNS_USAGE = "canonry runs <project> [--limit <n>] [--kind <kind>] [--status <status>] [--format json]";
 var RUN_TRIGGER_OPTIONS = {
   provider: stringOption(),
@@ -12875,6 +12961,43 @@ var RUN_CLI_COMMANDS = [
       await showRun(id, input.format);
     }
   },
+  {
+    path: ["run", "fill"],
+    usage: RUN_FILL_USAGE,
+    options: {
+      provider: stringOption(),
+      wait: { type: "boolean", default: false }
+    },
+    supportsDryRun: true,
+    run: async (input) => {
+      if (input.positionals.length === 0 && !input.dryRun) return triggerRunCommand({ ...input, positionals: ["fill"] }, "run");
+      const runId = requirePositional(input, 0, {
+        command: "run.fill",
+        usage: RUN_FILL_USAGE,
+        message: "run ID is required"
+      });
+      const provider = getString(input.values, "provider");
+      await fillRun(runId, {
+        providers: provider ? provider.split(",").map((value) => value.trim()).filter(Boolean) : void 0,
+        dryRun: input.dryRun,
+        wait: getBoolean(input.values, "wait"),
+        format: input.format
+      });
+    }
+  },
+  {
+    path: ["run", "completeness"],
+    usage: "canonry run completeness <run-id> [--format json]",
+    run: async (input) => {
+      if (input.positionals.length === 0) return triggerRunCommand({ ...input, positionals: ["completeness"] }, "run");
+      const runId = requirePositional(input, 0, {
+        command: "run.completeness",
+        usage: "canonry run completeness <run-id> [--format json]",
+        message: "run ID is required"
+      });
+      await showRunCompleteness(runId, input.format);
+    }
+  },
   {
     path: ["run", "cancel"],
     usage: "canonry run cancel <project> [run-id] [--format json]",
@@ -19536,6 +19659,9 @@ var TELEMETRY_ERROR_CODES = /* @__PURE__ */ new Set([
   "AGENT_BUSY",
   "MISSING_DEPENDENCY",
   "RUNTIME_STATE_MISSING",
+  "RUN_FILL_REFUSED",
+  "RUN_FILL_IN_PROGRESS",
+  "RUN_FILL_INCOMPLETE",
   "API_ERROR",
   "CLI_ERROR",
   "CLI_USAGE_ERROR",

package/dist/{demo-server-76IZBMJ3.js → demo-server-IZFTJI7E.js}

@@ -4,7 +4,7 @@ import {
 import {
   layoutSiteCrawlGraphInput,
   persistSiteCrawlGraphLayout
-} from "./chunk-JNU6GLAV.js";
+} from "./chunk-IDZQ5H3J.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -83,7 +83,7 @@ import {
   siteCrawlPages,
   siteCrawlSnapshots,
   trafficSources
-} from "./chunk-SMYBGUVV.js";
+} from "./chunk-Q35D2R2P.js";
 import {
   RunKinds,
   SiteCrawlFetchStates,
@@ -104,7 +104,7 @@ import {
   measurementPlanV2Schema,
   placementLinkDecision,
   siteAuditPageFactorSchema
-} from "./chunk-MQMJJZ6W.js";
+} from "./chunk-UWJAATGC.js";
 
 // src/demo-server.ts
 import { dirname, join as join2 } from "path";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { FastifyInstance } from 'fastify';
 import { DatabaseClient } from '@ainyc/canonry-db';
-import { ProviderQuotaPolicy, SchedulableRunKind, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
+import { ProviderQuotaPolicy, SchedulableRunKind, AgentProviderId, EmbedConfigEntry, AgentPluginState, GoogleAdsCampaignMetricsQuery, GoogleAdsRawSnapshotDto, GoogleAdsEffectiveGoalGraphDto, GoogleMarketingProvider, GoogleAdsAccessibleCustomersResponse, GoogleAdsAccessibleCustomerDto, GtmAccountsResponse, GtmContainerListResponse, GtmWorkspaceListResponse, GtmRawSnapshotDto } from '@ainyc/canonry-contracts';
 import { GoogleTokenResponse } from '@ainyc/canonry-integration-google';
 
 type GoogleConnectionType = 'gsc' | 'ga4' | 'gbp';
@@ -289,6 +289,33 @@ interface AgentConfigEntry {
      * Both resolvers live in agent-config.ts.
      */
     mode?: 'disabled' | 'prompt-only';
+    /**
+     * Pin the LLM provider Aero reasons with.
+     *
+     * Absent (the default) keeps the historical behaviour: the first provider
+     * holding a usable key wins, by `autoDetectPriority`. That default is an
+     * accident of which ANSWER-ENGINE keys the install happens to hold -- an
+     * install that sweeps with Claude silently gets Claude for Aero too, at that
+     * provider's agent-tier pricing -- so any deployment that cares which model
+     * answers has to say so here rather than rely on detection order.
+     *
+     * Ranked by `resolveSessionProviderAndModel`: an explicit per-request
+     * provider beats this pin, and this pin beats both the persisted session row
+     * and auto-detection. Because it outranks the row, a pin survives the
+     * conversation-delete path that drops that row entirely. An explicit request
+     * lasts one turn: the next turn that names no provider returns to the pin.
+     *
+     * Removing the pin does not move an existing session back to detection:
+     * without a pin a session keeps its stored provider, as it always has, until
+     * its conversation is deleted. Starting a new conversation keeps it too.
+     */
+    provider?: AgentProviderId;
+    /**
+     * Model id for `provider`. Ignored unless `provider` is set: a model slug is
+     * only meaningful against the provider that serves it. Absent uses that
+     * provider's agent-tier default.
+     */
+    model?: string;
 }
 interface DashboardConfigEntry {
     /**

package/dist/index.js

@@ -3,14 +3,14 @@ import {
   createGoogleMarketingCredentialStore,
   createGoogleMarketingRuntime,
   createServer
-} from "./chunk-UYSTNPTX.js";
+} from "./chunk-TDHRUXN3.js";
 import {
   loadConfig
-} from "./chunk-JW5DCORY.js";
-import "./chunk-JNU6GLAV.js";
+} from "./chunk-IPGBK7XR.js";
+import "./chunk-IDZQ5H3J.js";
 import "./chunk-AOJU5LKX.js";
-import "./chunk-SMYBGUVV.js";
-import "./chunk-MQMJJZ6W.js";
+import "./chunk-Q35D2R2P.js";
+import "./chunk-UWJAATGC.js";
 export {
   GoogleMarketingRuntimeError,
   createGoogleMarketingCredentialStore,

package/dist/{intelligence-service-KF5WWPGR.js → intelligence-service-PM7MC5VC.js}

@@ -1,8 +1,8 @@
 import {
   HISTORY_WINDOW_RUNS,
   IntelligenceService
-} from "./chunk-SMYBGUVV.js";
-import "./chunk-MQMJJZ6W.js";
+} from "./chunk-Q35D2R2P.js";
+import "./chunk-UWJAATGC.js";
 export {
   HISTORY_WINDOW_RUNS,
   IntelligenceService

package/dist/mcp.js

@@ -1,15 +1,15 @@
 import {
   autoSyncSkills
-} from "./chunk-NV3X6O5P.js";
+} from "./chunk-6YLNO2T5.js";
 import {
   createApiClient,
   createCanonryMcpServer
-} from "./chunk-JW5DCORY.js";
+} from "./chunk-IPGBK7XR.js";
 import "./chunk-AOJU5LKX.js";
 import {
   isReadOnlyKey,
   updateCheckEnvOptOut
-} from "./chunk-MQMJJZ6W.js";
+} from "./chunk-UWJAATGC.js";
 
 // src/mcp/cli.ts
 import { randomUUID } from "crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonry/canonry",
-  "version": "5.11.0",
+  "version": "5.13.0",
   "type": "module",
   "description": "Self-hosted AI visibility (AEO) platform: track how ChatGPT, Claude, Gemini, and Perplexity cite your domain, join it with Search Console, GA4, server-side traffic, and paid media, and fix what you find through agent tools (CLI, REST, MCP). Local SQLite.",
   "keywords": [
@@ -87,8 +87,8 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.0",
     "@ainyc/canonry-web": "0.0.0",
-    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-api-client": "0.0.0",
+    "@ainyc/canonry-api-routes": "0.0.0",
     "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-db": "0.0.0",
@@ -97,21 +97,21 @@
     "@ainyc/canonry-integration-cloudflare-queue": "0.0.0",
     "@ainyc/canonry-integration-cloudflare-worker": "0.0.0",
     "@ainyc/canonry-integration-commoncrawl": "0.0.0",
-    "@ainyc/canonry-integration-google-ads": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
-    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-integration-google-ads": "0.0.0",
     "@ainyc/canonry-integration-google-places": "0.0.0",
     "@ainyc/canonry-integration-google-tag-manager": "0.0.0",
     "@ainyc/canonry-integration-openai-ads": "0.0.0",
     "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-integration-traffic": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-integration-google-business-profile": "0.0.0",
+    "@ainyc/canonry-provider-gemini": "0.0.0",
     "@ainyc/canonry-provider-local": "0.0.0",
-    "@ainyc/canonry-provider-perplexity": "0.0.0",
-    "@ainyc/canonry-provider-gemini": "0.0.0"
+    "@ainyc/canonry-provider-claude": "0.0.0",
+    "@ainyc/canonry-provider-openai": "0.0.0",
+    "@ainyc/canonry-provider-perplexity": "0.0.0"
   },
   "scripts": {
     "build": "pnpm run build:cli && pnpm run build:web",