@canonry/canonry 5.19.0 → 5.20.0

package/dist/{chunk-WLL7Q7JD.js → chunk-QF7SY7AF.js}

@@ -248,11 +248,6 @@ var PROVIDER_LOCATION_HANDLING = {
     supportsLocationContext: true,
     description: "Location appended to the query text the Gemini model receives."
   },
-  perplexity: {
-    treatment: "prompt",
-    supportsLocationContext: true,
-    description: "Location appended to the query text the Perplexity model receives."
-  },
   local: {
     treatment: "prompt",
     supportsLocationContext: true,
@@ -268,6 +263,11 @@ var PROVIDER_LOCATION_HANDLING = {
     supportsLocationContext: true,
     description: "Location sent as a structured `user_location` field on Anthropic\u2019s web_search_20250305 tool."
   },
+  perplexity: {
+    treatment: "request-param",
+    supportsLocationContext: true,
+    description: "Location sent as a structured `user_location` field on Perplexity\u2019s web_search tool."
+  },
   "cdp:chatgpt": {
     treatment: "browser-geo",
     supportsLocationContext: false,
@@ -4383,6 +4383,25 @@ var measurementPropertyEvidenceQuerySchema = z6.object({
   limit: z6.number().int().positive().max(MEASUREMENT_PAGE_MAX_LIMIT).optional()
 }).strict();
 
+// ../contracts/src/models.ts
+var PROVIDER_MODEL_ALIASES = {
+  perplexity: {
+    sonar: "fast",
+    "sonar-pro": "low",
+    "sonar-reasoning": "low",
+    "sonar-reasoning-pro": "low",
+    "sonar-deep-research": "medium",
+    "fast-search": "fast",
+    "pro-search": "low",
+    "deep-research": "medium",
+    "advanced-deep-research": "high"
+  }
+};
+function resolveProviderModel(provider, model) {
+  const aliases = PROVIDER_MODEL_ALIASES[provider];
+  return aliases !== void 0 && Object.hasOwn(aliases, model) ? aliases[model] : model;
+}
+
 // ../contracts/src/measurement-plan.ts
 var MEASUREMENT_PLAN_SCHEMA_VERSION = 1;
 var measurementPlanRevisionSchema = z7.number().int().positive();
@@ -4762,7 +4781,7 @@ function normalizeExecutionIdentity(input) {
   const models = {};
   for (const provider of providers) {
     const model = input.models[provider];
-    if (model && model.trim()) models[provider] = model.trim();
+    if (model && model.trim()) models[provider] = resolveProviderModel(provider, model.trim());
   }
   return { providers, models };
 }
@@ -7157,25 +7176,97 @@ var measurementDemoFilterQueryShape = {
   location: measurementDemoLocationSchema.optional()
 };
 var measurementDemoRecommendedNameSchema = z18.string().trim().min(1);
+var MEASUREMENT_PORTFOLIO_DEFAULT_LIMIT = 4;
+var MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT = 5;
+var MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT = 10;
+var MEASUREMENT_PORTFOLIO_TIE_NOTE = "tied Properties are ordered by name, not ranked";
 var measurementPortfolioSummaryQuerySchema = z18.object({
   runId: measurementDemoFilterQueryShape.runId,
   groupKey: measurementV2StableKeySchema.optional(),
   queryClass: measurementQueryClassFilterSchema.default("non-brand"),
   provider: measurementDemoFilterQueryShape.provider,
   location: measurementDemoFilterQueryShape.location,
-  limit: z18.number().int().positive().max(50).optional()
+  /** Caps every list in the response (Property rows, both mention rankings, markets). Defaults to 4. */
+  limit: z18.number().int().positive().max(50).optional(),
+  /**
+   * Off by default: `markets` holds one level only, the top-level markets (or
+   * the selected group's direct children), worst-first and capped at `limit`.
+   * True returns every market in scope at every level, uncapped, as the
+   * roll-up did before it was levelled.
+   */
+  includeNestedMarkets: z18.boolean().optional()
+}).strict();
+var measurementPortfolioMetroSchema = z18.object({
+  groupKey: measurementV2StableKeySchema,
+  label: measurementDemoLabelSchema
+}).strict();
+var measurementPortfolioPropertyContextShape = {
+  /** The top-level group holding this Property; null when it is in none. */
+  metro: measurementPortfolioMetroSchema.nullable(),
+  /** Further top-level groups holding the same Property. Present only when there are any. */
+  otherMetros: z18.array(measurementPortfolioMetroSchema).min(1).optional(),
+  /** Labels of every nested (non-top-level) group holding this Property, shallowest first. */
+  submarkets: z18.array(measurementDemoLabelSchema),
+  queries: measurementDemoCountSchema
+};
+var measurementPortfolioCountedNameSchema = z18.object({
+  name: measurementDemoRecommendedNameSchema,
+  /** Answers that wrote this name. */
+  answers: measurementDemoCountSchema
+}).strict();
+var measurementPortfolioRecommendedInsteadSchema = z18.object({
+  name: measurementDemoRecommendedNameSchema,
+  /** Answers that wrote this name, one per answer however it spells it: the same count as `namedInsteadInAnswerText[].answers`. */
+  occurrences: measurementDemoCountSchema
+}).strict();
+var measurementPortfolioCountedDomainSchema = z18.object({
+  domain: z18.string().trim().min(1),
+  /** Answers citing at least one URL on this domain. */
+  answers: measurementDemoCountSchema
 }).strict();
 var measurementPortfolioWeakestPropertySchema = measurementDemoPropertySchema.extend({
+  ...measurementPortfolioPropertyContextShape,
   mentionCoverage: measurementMetricValueSchema,
   citationCoverage: measurementMetricValueSchema,
   flags: measurementDemoCountSchema,
-  recommendedInstead: z18.array(z18.object({
-    name: measurementDemoRecommendedNameSchema,
-    occurrences: measurementDemoCountSchema
-  }).strict()).max(5),
-  recommendedInsteadTotal: measurementDemoCountSchema,
-  recommendedInsteadTruncated: z18.boolean()
+  /**
+   * Names WRITTEN IN THE ANSWER TEXT of this Property's answers that neither
+   * named nor cited it, counted by answer. These are mentions, never
+   * citations: a name here says nothing about which sources were linked.
+   * Supersedes the deprecated `recommendedInstead`, whose name read as a
+   * citation.
+   */
+  namedInsteadInAnswerText: z18.array(measurementPortfolioCountedNameSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT),
+  /** Distinct names across those answers; more than returned means the list was cut. */
+  namedInsteadInAnswerTextTotal: measurementDemoCountSchema,
+  /**
+   * Domains cited by this Property's stored answers in this run and class,
+   * every engine included: each answer's stored domains plus the hosts of its
+   * captured source URLs, and answers whose text was not captured count too.
+   */
+  citedDomains: z18.array(measurementPortfolioCountedDomainSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT),
+  /** Distinct cited domains; more than returned means the list was cut. */
+  citedDomainsTotal: measurementDemoCountSchema,
+  /**
+   * Deprecated: read `namedInsteadInAnswerText`. The same names in the same
+   * order, kept for existing consumers. `occurrences` counts answers, one per
+   * answer however it spells the name, exactly as `answers` does there.
+   */
+  recommendedInstead: z18.array(measurementPortfolioRecommendedInsteadSchema).max(MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT).meta({ deprecated: true, description: "Deprecated: read namedInsteadInAnswerText, which carries the same names in the same order. occurrences counts answers, exactly as answers does there." }),
+  /** Deprecated: read `namedInsteadInAnswerTextTotal`, which it always equals. */
+  recommendedInsteadTotal: measurementDemoCountSchema.meta({ deprecated: true, description: "Deprecated: read namedInsteadInAnswerTextTotal, which it always equals." }),
+  /** Deprecated: true when `namedInsteadInAnswerTextTotal` exceeds the names returned. */
+  recommendedInsteadTruncated: z18.boolean().meta({ deprecated: true, description: "Deprecated: true when namedInsteadInAnswerTextTotal exceeds the names returned in namedInsteadInAnswerText." })
 }).strict().superRefine((row, ctx) => {
+  if (row.namedInsteadInAnswerText.length > row.namedInsteadInAnswerTextTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["namedInsteadInAnswerTextTotal"], message: "Total cannot be smaller than the returned names" });
+  }
+  if (row.citedDomains.length > row.citedDomainsTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["citedDomainsTotal"], message: "Total cannot be smaller than the returned domains" });
+  }
+  if (row.recommendedInsteadTotal !== row.namedInsteadInAnswerTextTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTotal"], message: "The deprecated total must equal namedInsteadInAnswerTextTotal" });
+  }
   if (row.recommendedInstead.length > row.recommendedInsteadTotal) {
     ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTotal"], message: "Total cannot be smaller than the returned replacements" });
   }
@@ -7183,24 +7274,46 @@ var measurementPortfolioWeakestPropertySchema = measurementDemoPropertySchema.ex
     ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["recommendedInsteadTruncated"], message: "Truncation must agree with the replacement total" });
   }
 });
+var measurementPortfolioWeakestTieSchema = z18.object({
+  count: z18.number().int().min(2),
+  mentionRate: z18.number(),
+  citationRate: z18.number(),
+  note: z18.literal(MEASUREMENT_PORTFOLIO_TIE_NOTE)
+}).strict();
+var measurementPortfolioAnswerSourcesSchema = z18.object({
+  properties: measurementDemoCountSchema,
+  answers: measurementDemoCountSchema,
+  domains: z18.array(measurementPortfolioCountedDomainSchema).max(MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT),
+  domainTotal: measurementDemoCountSchema
+}).strict().superRefine((sources, ctx) => {
+  if (sources.domains.length > sources.domainTotal) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["domainTotal"], message: "Total cannot be smaller than the returned domains" });
+  }
+  if (sources.domains.some((row) => row.answers > sources.answers)) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["domains"], message: "A domain cannot be cited by more answers than the basis holds" });
+  }
+});
 var measurementPortfolioMarketSchema = z18.object({
   groupKey: measurementV2StableKeySchema,
   label: measurementDemoLabelSchema,
+  /** Null for a top-level market. */
+  parentGroupKey: measurementV2StableKeySchema.nullable(),
+  /** Direct child markets; read one with `groupKey` to list them. */
+  childMarketCount: measurementDemoCountSchema,
   propertyCount: measurementDemoCountSchema,
   propertiesMentioned: measurementMetricValueSchema,
   mentionCoverage: measurementMetricValueSchema,
   citationCoverage: measurementMetricValueSchema
 }).strict();
+var measurementPortfolioRankedPropertySchema = measurementDemoPropertySchema.extend({
+  ...measurementPortfolioPropertyContextShape,
+  mentionCoverage: measurementMetricValueSchema.options[0],
+  citationCoverage: measurementMetricValueSchema
+}).strict();
 var measurementPortfolioMentionRankingSchema = z18.object({
   eligiblePropertyCount: measurementDemoCountSchema,
-  strongest: z18.array(measurementDemoPropertySchema.extend({
-    mentionCoverage: measurementMetricValueSchema.options[0],
-    citationCoverage: measurementMetricValueSchema
-  }).strict()).max(50),
-  weakest: z18.array(measurementDemoPropertySchema.extend({
-    mentionCoverage: measurementMetricValueSchema.options[0],
-    citationCoverage: measurementMetricValueSchema
-  }).strict()).max(50),
+  strongest: z18.array(measurementPortfolioRankedPropertySchema).max(50),
+  weakest: z18.array(measurementPortfolioRankedPropertySchema).max(50),
   /** All excluded Properties in this scope, independent of the ranked list limit. */
   excluded: z18.array(measurementDemoPropertySchema.extend({
     reason: measurementMetricUnavailableReasonSchema
@@ -7217,23 +7330,37 @@ var measurementPortfolioSummaryResponseSchema = z18.object({
   }).strict(),
   measurement: measurementDemoRunMetadataSchema,
   queryClass: measurementQueryClassFilterSchema,
+  /** Engines behind the displayed answers, after any provider filter. Empty before a run completes. */
+  engines: z18.array(providerNameSchema),
   metrics: z18.object({
     propertiesMentioned: measurementMetricValueSchema,
     mentionCoverage: measurementMetricValueSchema,
     citationCoverage: measurementMetricValueSchema
   }).strict(),
   weakestProperties: z18.array(measurementPortfolioWeakestPropertySchema),
+  /** Set when two or more Properties share the weakest row's rates; null otherwise. */
+  tiedAtWeakest: measurementPortfolioWeakestTieSchema.nullable(),
+  /** Null before a run completes. */
+  weakestAnswerSources: measurementPortfolioAnswerSourcesSchema.nullable(),
   /** Descriptive mention ranking, using the response queryClass and scope; aggregate unavailability does not invalidate it. */
   mentionRanking: measurementPortfolioMentionRankingSchema,
   /**
-   * Every named market, worst-first. Empty when the request already narrowed to
-   * one group (a roll-up would only restate the scope) and when the plan defines
-   * no groups. Additive field.
+   * Markets worst-first. By default one level: the top-level markets, or the
+   * selected group's direct children when `groupKey` is set (empty when it has
+   * none), capped at `limit`. `includeNestedMarkets` returns every market in
+   * scope at every level, uncapped. Empty when the plan defines no groups.
    */
   markets: z18.array(measurementPortfolioMarketSchema),
+  /** Markets at the returned level before `limit`; more than returned means the list was cut. */
+  totalMarkets: measurementDemoCountSchema,
+  marketsTruncated: z18.boolean(),
   totalProperties: measurementDemoCountSchema,
   truncated: z18.boolean()
-}).strict();
+}).strict().superRefine((response, ctx) => {
+  if (response.marketsTruncated !== response.markets.length < response.totalMarkets) {
+    ctx.addIssue({ code: z18.ZodIssueCode.custom, path: ["marketsTruncated"], message: "Market truncation must agree with the market total" });
+  }
+});
 var measurementPropertyQuestionsQuerySchema = z18.object({
   targetKey: measurementV2StableKeySchema,
   runId: measurementDemoFilterQueryShape.runId,
@@ -10899,6 +11026,7 @@ var runFillRefusalCodeSchema = z33.enum([
   "plan_revision_changed",
   "manifest_unreadable",
   "model_not_frozen",
+  "model_retired",
   "provider_not_in_plan",
   "provider_nothing_missing",
   "provider_not_configured",
@@ -13055,6 +13183,12 @@ var sourceRankEntrySchema = z40.object({
   count: z40.number().int(),
   /** Share of the list's `totalCitedSlots`, 0..1 (4dp). */
   percentage: z40.number(),
+  /**
+   * Share of the list's `answerTotal` (every answer in scope, including answers
+   * that cited nothing) that cite this domain, 0..1 (4dp). Optional only so an
+   * older server's response still parses.
+   */
+  answerShare: z40.number().optional(),
   category: sourceCategorySchema,
   label: z40.string(),
   surfaceClass: surfaceClassSchema
@@ -13068,8 +13202,12 @@ var surfaceClassCountSchema = z40.object({
   domainCount: z40.number().int()
 });
 var rankedSourceListSchema = z40.object({
-  /** Total cited slots (grounding citations) counted in this scope. */
+  /** Total cited slots in this scope: one per (answer, cited domain) pair. */
   totalCitedSlots: z40.number().int(),
+  /** Answers in this scope, including answers that cited nothing. Denominator of `answerShare`. */
+  answerTotal: z40.number().int().optional(),
+  /** Answers in this scope whose stored source list names at least one domain. */
+  answersWithSources: z40.number().int().optional(),
   /** Distinct domains in this scope. */
   domainTotal: z40.number().int(),
   /** Ranked domains, desc by count; truncated to the applied limit if any. */
@@ -13081,17 +13219,57 @@ var rankedSourceListSchema = z40.object({
   /** Surface-class roll-up over the FULL scope (not just `entries`). */
   bySurfaceClass: z40.array(surfaceClassCountSchema)
 });
+var sourceBreakdownQueryClassBasisSchema = z40.enum(["measurement-plan", "query-text"]);
+var sourceBreakdownQuerySchema = z40.object({
+  /** One stored answer-visibility run. Omit to pool every run in the window. */
+  runId: z40.string().trim().min(1).optional(),
+  /**
+   * Branded or non-brand answers only. With an active v2 measurement plan the
+   * class comes from each run's frozen plan assignments; otherwise from the
+   * project's brand-name classifier over the query text. `all` (the default)
+   * pools both classes.
+   */
+  queryClass: queryClassFilterSchema.optional(),
+  /** `false` omits the per-query breakdown (`byQuery`), which is large. Defaults to `true`. */
+  includeByQuery: z40.enum(["true", "false", "1", "0"]).optional()
+});
 var sourceBreakdownDtoSchema = z40.object({
-  overall: z40.array(sourceCategoryCountSchema),
-  byQuery: z40.record(z40.string(), z40.array(sourceCategoryCountSchema)),
   /** Full ranked + classified cited-domain list across all providers (#675). */
   ranked: rankedSourceListSchema,
   /** Per-provider ranked + classified breakdown, keyed by provider name (#675). */
   byProvider: z40.record(z40.string(), rankedSourceListSchema),
+  /**
+   * Providers that answered in scope but whose answers name no resolvable
+   * source. They are absent from `byProvider`; listed here so their absence is
+   * never read as missing data.
+   */
+  providersWithoutSources: z40.array(z40.string()).optional(),
+  /** Answers in scope after every filter, across all providers. */
+  answerTotal: z40.number().int().optional(),
+  /** Runs pooled into this response. More than one means several sweeps are pooled. */
+  runCount: z40.number().int().optional(),
+  /**
+   * Answers the `queryClass` filter could not place in either class (a run with
+   * no frozen v2 plan, an answer with no plan execution, or no query text).
+   * They are excluded from every count. Zero when no class filter is applied.
+   */
+  unclassifiedAnswers: z40.number().int().optional(),
+  /** Echo of the applied filters. */
+  filters: z40.object({
+    runId: z40.string().nullable(),
+    queryClass: queryClassFilterSchema,
+    /** Null when `queryClass` is `all` and no classification was applied. */
+    queryClassBasis: z40.union([sourceBreakdownQueryClassBasisSchema, z40.null()]),
+    includeByQuery: z40.boolean()
+  }).optional(),
   runId: z40.string(),
   window: metricsWindowSchema,
   /** Applied ranked-list limit; null when the full list is returned. */
-  limit: z40.number().int().nullable()
+  limit: z40.number().int().nullable(),
+  /** Legacy category breakdown (top 5 domains per category). */
+  overall: z40.array(sourceCategoryCountSchema),
+  /** Per-query category breakdown keyed by current query text. Omitted with `includeByQuery=false`. */
+  byQuery: z40.record(z40.string(), z40.array(sourceCategoryCountSchema)).optional()
 });
 var competitorLandscapeSurfaceClassSchema = z40.enum([
   "own",
@@ -13172,10 +13350,14 @@ var competitorLandscapeEvidenceSchema = z40.object({
   excludedNonCompletedResults: z40.number().int().nonnegative()
 }).strict();
 var COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT = 50;
+var COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT = 50;
 var competitorLandscapeModelGroupSchema = z40.object({
   ...shareOfVoiceContextFields,
   comparison: z40.array(z40.object({ domain: z40.string(), mentions: z40.number().int().nonnegative() })).optional(),
+  /** Names written in the answer text (not cited sources), top `COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT` by answer count. */
   observedNames: z40.array(z40.object({ name: z40.string(), answerCount: z40.number().int().nonnegative() })).optional(),
+  /** Distinct observed names before the cap. Greater than `observedNames.length` when the list was cut. */
+  observedNamesTotal: z40.number().int().nonnegative().optional(),
   provider: z40.string().trim().min(1),
   /** Null preserves historical observations with unknown requested model identity. */
   model: modelIdSchema.nullable(),
@@ -13200,7 +13382,10 @@ var competitorLandscapeModelComparisonSchema = z40.object({
 var competitorLandscapeResponseSchema = z40.object({
   ...shareOfVoiceContextFields,
   comparison: z40.array(z40.object({ domain: z40.string(), mentions: z40.number().int().nonnegative() })).optional(),
+  /** Names written in the answer text (not cited sources), top `COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT` by answer count. */
   observedNames: z40.array(z40.object({ name: z40.string(), answerCount: z40.number().int().nonnegative() })).optional(),
+  /** Distinct observed names before the cap. Greater than `observedNames.length` when the list was cut. */
+  observedNamesTotal: z40.number().int().nonnegative().optional(),
   window: metricsWindowSchema,
   scope: competitorLandscapeScopeSchema,
   project: competitorLandscapeRowSchema,
@@ -19477,6 +19662,8 @@ export {
   effectiveBrandNames,
   projectConfigSchema,
   resolveConfigSpecQueries,
+  resolveProviderModel,
+  queryClassFilterSchema,
   compileQueryClassifier,
   MEASUREMENT_PLAN_V2_SCHEMA_VERSION,
   measurementV2UsageEdgeKey,
@@ -19550,6 +19737,10 @@ export {
   buildMeasurementRunManifestV1,
   measurementReportResponseSchema,
   measurementPropertyEvidenceResponseSchema,
+  MEASUREMENT_PORTFOLIO_DEFAULT_LIMIT,
+  MEASUREMENT_PORTFOLIO_ROW_EVIDENCE_LIMIT,
+  MEASUREMENT_PORTFOLIO_ANSWER_SOURCES_LIMIT,
+  MEASUREMENT_PORTFOLIO_TIE_NOTE,
   measurementPortfolioSummaryQuerySchema,
   measurementPortfolioSummaryResponseSchema,
   measurementPropertyQuestionsQuerySchema,
@@ -19912,9 +20103,11 @@ export {
   normalizeModelId,
   modelIdsEquivalent,
   brandMetricsDtoSchema,
+  sourceBreakdownQuerySchema,
   sourceBreakdownDtoSchema,
   competitorLandscapeQuerySchema,
   COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT,
+  COMPETITOR_LANDSCAPE_OBSERVED_NAME_LIMIT,
   competitorLandscapeResponseSchema,
   parseWindow,
   windowCutoff,

package/dist/{chunk-ABUO27BV.js → chunk-TSFKNQ5X.js}

@@ -4,14 +4,14 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-SPCEXW3B.js";
+} from "./chunk-5FKR2K76.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-YHKKCXGY.js";
+} from "./chunk-XBGPHZKA.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-WLL7Q7JD.js";
+} from "./chunk-QF7SY7AF.js";
 
 // src/skills-autosync.ts
 import fs from "fs";