npm - @ainyc/canonry - Versions diffs - 4.180.8 → 4.182.3 - Mend

@ainyc/canonry 4.180.8 → 4.182.3

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 (36) hide show

package/assets/index.html CHANGED Viewed

@@ -12,14 +12,14 @@
     <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-BlILyZJ5.js"></script>
-    <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-Dock0eH1.js">
-    <link rel="modulepreload" crossorigin href="./assets/vendor-radix-4UOaVWza.js">
-    <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-D8rt5lKn.js">
-    <link rel="modulepreload" crossorigin href="./assets/vendor-lucide-nYKv-BB7.js">
-    <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-Bn7fRwrx.js">
+    <script type="module" crossorigin src="./assets/index-Brb7M_6G.js"></script>
+    <link rel="modulepreload" crossorigin href="./assets/vendor-tanstack-CYBjbqVr.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-radix-BpmvLvpp.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-recharts-FA0uySU7.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-lucide-XjCNFK0x.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-markdown-9tTeP8v7.js">
     <link rel="modulepreload" crossorigin href="./assets/vendor-yaml-GWJz5H2G.js">
-    <link rel="stylesheet" crossorigin href="./assets/index-DXCQf5s1.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-DwdK2e4e.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/{chunk-GFVZOVG3.js → chunk-BDJT7XZL.js} RENAMED Viewed

@@ -11,7 +11,7 @@ import {
   loadConfig,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-IM4HFNGF.js";
+} from "./chunk-FVC7PGYQ.js";
 import {
   CC_CACHE_DIR,
   DUCKDB_SPEC,
@@ -157,7 +157,7 @@ import {
   siteCrawlSnapshots,
   toAlertView,
   usageCounters
-} from "./chunk-ZJ2VGTYU.js";
+} from "./chunk-K45YKXE4.js";
 import {
   AGENT_MEMORY_VALUE_MAX_BYTES,
   AGENT_PROVIDER_IDS,
@@ -296,7 +296,7 @@ import {
   validationError,
   winnabilityClassLabel,
   withRetry
-} from "./chunk-GN2G7VFK.js";
+} from "./chunk-DY5ZDKQW.js";
 // src/telemetry.ts
 import crypto from "crypto";
@@ -11867,7 +11867,7 @@ function readStoredGroundingSources(rawResponse) {
   return result;
 }
 async function backfillInsightsCommand(project, opts) {
-  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-IURLYRB3.js");
+  const { IntelligenceService: IntelligenceService2 } = await import("./intelligence-service-HGA553GT.js");
   const config = loadConfig();
   const db = createClient(config.database);
   migrate(db);
@@ -13803,6 +13803,68 @@ function trimRowsToFit(rows, render) {
   }
   return kept;
 }
+function nestedArrayCandidates(root) {
+  const candidates = [];
+  const visit = (object) => {
+    let containsRecordCollection = false;
+    for (const [key, value] of Object.entries(object)) {
+      if (Array.isArray(value)) {
+        let hasNestedRecords = false;
+        let hasRecordRows = false;
+        for (const row of value) {
+          if (row && typeof row === "object" && !Array.isArray(row)) {
+            hasRecordRows = true;
+            hasNestedRecords = visit(row) || hasNestedRecords;
+          }
+        }
+        if (value.length > 0 && !hasNestedRecords) {
+          candidates.push({ owner: object, key, rows: value, size: serializeResult(value).length, hasRecordRows });
+        }
+        containsRecordCollection = hasRecordRows || hasNestedRecords || containsRecordCollection;
+      } else if (value && typeof value === "object") {
+        containsRecordCollection = visit(value) || containsRecordCollection;
+      }
+    }
+    return containsRecordCollection;
+  };
+  visit(root);
+  return candidates.sort(
+    (left, right) => Number(right.hasRecordRows) - Number(left.hasRecordRows) || right.size - left.size
+  );
+}
+function trimNestedArrays(full) {
+  const parsed = JSON.parse(full);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return void 0;
+  const copy = parsed;
+  copy.__truncated = true;
+  let out = serializeResult(copy);
+  while (out.length > MAX_TOOL_RESULT_CHARS) {
+    const candidate = nestedArrayCandidates(copy).at(0);
+    if (!candidate) return void 0;
+    const { owner, key, rows } = candidate;
+    const previous = owner.__omittedRowsByField;
+    const omitted = previous && typeof previous === "object" && !Array.isArray(previous) ? { ...previous } : {};
+    const priorCount = typeof omitted[key] === "number" ? omitted[key] : 0;
+    owner.__truncated = true;
+    owner.__omittedRowsByField = omitted;
+    const keep = (count2) => {
+      owner[key] = rows.slice(0, count2);
+      omitted[key] = priorCount + rows.length - count2;
+      return serializeResult(copy);
+    };
+    out = keep(0);
+    if (out.length > MAX_TOOL_RESULT_CHARS) continue;
+    let low = 0;
+    let high = rows.length - 1;
+    while (low < high) {
+      const middle = Math.ceil((low + high) / 2);
+      if (keep(middle).length <= MAX_TOOL_RESULT_CHARS) low = middle;
+      else high = middle - 1;
+    }
+    out = keep(low);
+  }
+  return out;
+}
 function truncateToolResult(details) {
   const full = serializeResult(details);
   if (full.length <= MAX_TOOL_RESULT_CHARS) return full;
@@ -13830,6 +13892,8 @@ function truncateToolResult(details) {
       });
       if (out.length <= MAX_TOOL_RESULT_CHARS) return out;
     }
+    const nested = trimNestedArrays(full);
+    if (nested !== void 0) return nested;
   }
   return full.slice(0, MAX_TOOL_RESULT_CHARS) + "\n" + TRUNCATION_NOTE;
 }

package/dist/{chunk-GN2G7VFK.js → chunk-DY5ZDKQW.js} RENAMED Viewed

@@ -6723,6 +6723,22 @@ var measurementDraftUpsertCompetitorRequestSchema = z15.object({
   groupKey: measurementV2StableKeySchema,
   competitor: measurementDraftCompetitorSchema
 }).strict();
+var measurementDraftPinCompetitorRequestSchema = z15.object({
+  expectedActiveRevision: measurementDraftRevisionSchema,
+  groupKey: measurementV2StableKeySchema,
+  domain: z15.string().trim().min(1).refine((value) => hostOf(value) !== null, "A competitor domain must be a valid hostname"),
+  label: z15.string().trim().min(1).optional(),
+  aliases: z15.array(z15.string().trim().min(1)).optional()
+}).strict();
+var measurementDraftPinCompetitorResponseSchema = measurementDraftMutationResponseSchema.extend({
+  groupKey: measurementV2StableKeySchema,
+  competitor: measurementDraftCompetitorSchema,
+  draftCreated: z15.boolean(),
+  published: z15.object({
+    revision: measurementDraftRevisionSchema,
+    competitorsChanged: z15.literal(false)
+  }).strict()
+}).strict();
 var measurementDraftRemoveCompetitorRequestSchema = z15.object({
   groupKey: measurementV2StableKeySchema,
   competitorKey: measurementV2StableKeySchema
@@ -11835,6 +11851,143 @@ var sourceBreakdownDtoSchema = z35.object({
   /** Applied ranked-list limit; null when the full list is returned. */
   limit: z35.number().int().nullable()
 });
+var competitorLandscapeSurfaceClassSchema = z35.enum([
+  "own",
+  "direct-competitor",
+  "ota-aggregator",
+  "editorial-media",
+  "other",
+  "unknown"
+]);
+var competitorLandscapeScopeSchema = z35.discriminatedUnion("kind", [
+  z35.object({ kind: z35.literal("project") }).strict(),
+  z35.object({ kind: z35.literal("group"), groupKey: z35.string().trim().min(1) }).strict(),
+  z35.object({ kind: z35.literal("all-markets") }).strict()
+]);
+var competitorLandscapeQueryClassSchema = z35.enum(["all", "branded", "non-brand"]);
+var competitorLandscapeModeSchema = z35.enum(["project", "all-markets"]);
+var competitorLandscapeQuerySchema = z35.object({
+  window: metricsWindowSchema.optional(),
+  groupKey: z35.string().trim().min(1).optional(),
+  scope: competitorLandscapeModeSchema.optional(),
+  provider: z35.string().trim().min(1).optional(),
+  /** Exact requested model ID; provider is required to disambiguate model names. */
+  model: modelIdSchema.optional(),
+  /** Opt-in agent comparison; the default landscape remains pooled. */
+  groupBy: z35.literal("model").optional(),
+  queryClass: competitorLandscapeQueryClassSchema.optional(),
+  location: z35.string().trim().min(1).optional(),
+  runId: z35.string().trim().min(1).optional()
+}).strict().superRefine((value, context) => {
+  if (value.scope === "all-markets" && value.groupKey !== void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["groupKey"],
+      message: "groupKey cannot be combined with scope=all-markets"
+    });
+  }
+  if (value.model !== void 0 && value.provider === void 0) {
+    context.addIssue({
+      code: "custom",
+      path: ["provider"],
+      message: "provider is required when filtering by model"
+    });
+  }
+});
+var competitorLandscapeRowSchema = z35.object({
+  domain: z35.string().trim().min(1),
+  label: z35.string().trim().min(1),
+  surfaceClass: competitorLandscapeSurfaceClassSchema,
+  pinned: z35.boolean(),
+  /** One answer-text match at most per result. */
+  mentionCount: z35.number().int().nonnegative(),
+  /**
+   * Percentage points (0..100). Null outside the competitive denominator, and
+   * null for any selection that pools query classes: a brand wins its own
+   * branded queries by definition, so a pooled ratio flatters the project and
+   * buries every competitor. Counts stay populated either way.
+   */
+  shareOfVoice: z35.number().min(0).max(100).nullable(),
+  /** One source-list credit at most per result. Independent of mentions. */
+  citationCount: z35.number().int().nonnegative(),
+  /** Answer-text result count behind the mention field. */
+  answeredResults: z35.number().int().nonnegative(),
+  firstSeenAt: z35.string().datetime().nullable(),
+  lastSeenAt: z35.string().datetime().nullable(),
+  sampleUrls: z35.array(z35.string().url()).max(3)
+}).strict();
+var competitorLandscapeEvidenceSchema = z35.object({
+  answeredResults: z35.number().int().nonnegative(),
+  sourceResults: z35.number().int().nonnegative(),
+  missingAnswerTextResults: z35.number().int().nonnegative(),
+  /** Project plus direct-competitor named credits behind SOV. */
+  mentionCredits: z35.number().int().nonnegative(),
+  /** Citation captures that cannot prove a complete source list; never inferred as misses. */
+  incompleteSourceResults: z35.number().int().nonnegative(),
+  /** Stored probe snapshots intentionally omitted from every landscape metric. */
+  excludedProbeResults: z35.number().int().nonnegative(),
+  /** Stored snapshots from queued/running/failed/cancelled runs omitted from every metric. */
+  excludedNonCompletedResults: z35.number().int().nonnegative()
+}).strict();
+var COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT = 50;
+var competitorLandscapeModelGroupSchema = z35.object({
+  provider: z35.string().trim().min(1),
+  /** Null preserves historical observations with unknown requested model identity. */
+  model: modelIdSchema.nullable(),
+  /** Raw upstream-reported identity; never filled from the requested model or current settings. */
+  servedModels: modelEvidenceStateSchema,
+  snapshotCount: z35.number().int().positive(),
+  project: competitorLandscapeRowSchema,
+  pinned: z35.array(competitorLandscapeRowSchema),
+  observed: z35.array(competitorLandscapeRowSchema),
+  otherSources: z35.array(competitorLandscapeRowSchema),
+  evidence: competitorLandscapeEvidenceSchema,
+  /** Per-group ranked-row truncation; all pins and full-population denominators remain included. */
+  truncated: z35.boolean()
+}).strict();
+var competitorLandscapeModelComparisonSchema = z35.object({
+  basis: z35.literal("requested-model"),
+  groups: z35.array(competitorLandscapeModelGroupSchema).max(COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT),
+  totalGroups: z35.number().int().nonnegative(),
+  /** Groups sort by provider and requested model. Use provider/model filters to narrow a truncated result. */
+  truncated: z35.boolean()
+}).strict();
+var competitorLandscapeResponseSchema = z35.object({
+  window: metricsWindowSchema,
+  scope: competitorLandscapeScopeSchema,
+  project: competitorLandscapeRowSchema,
+  /** Explicit/custom competitors, preserved even with zero observations. */
+  pinned: z35.array(competitorLandscapeRowSchema),
+  /** Stored-discovery direct competitors, ordered by historical mention share. */
+  observed: z35.array(competitorLandscapeRowSchema),
+  /** Aggregators, editorial, unknown, and other cited sources; never share-of-voice competitors. */
+  otherSources: z35.array(competitorLandscapeRowSchema),
+  evidence: competitorLandscapeEvidenceSchema,
+  /** Present only when groupBy=model; pooled fields remain available and unchanged. */
+  modelComparison: competitorLandscapeModelComparisonSchema.optional(),
+  /** Present only for Advanced market reads; active metrics stay frozen while draft pins remain pending publish. */
+  marketState: z35.object({
+    activeRevision: z35.number().int().positive(),
+    draft: z35.object({
+      etag: z35.string().trim().min(1),
+      /** Draft-only market identities included in `pinned` for this response. */
+      pendingCompetitorDomains: z35.array(z35.string().trim().min(1))
+    }).strict().nullable()
+  }).strict().nullable(),
+  /** Echoes all applied filters so a client never mistakes a scoped reading for a project-wide one. */
+  filters: z35.object({
+    scope: competitorLandscapeModeSchema,
+    groupKey: z35.string().nullable(),
+    provider: z35.string().nullable(),
+    model: modelIdSchema.optional(),
+    groupBy: z35.literal("model").optional(),
+    queryClass: competitorLandscapeQueryClassSchema,
+    location: z35.string().nullable(),
+    runId: z35.string().nullable()
+  }).strict(),
+  /** True when ranked observed/source lists exceed the server cap; pinned rows are never dropped. */
+  truncated: z35.boolean()
+}).strict();
 function parseWindow(value) {
   if (value === void 0 || value === "") return "all";
   const parsed = metricsWindowSchema.safeParse(value);
@@ -16589,6 +16742,7 @@ export {
   measurementChangesResponseSchema,
   measurementDataQualityQuerySchema,
   measurementDataQualityResponseSchema,
+  measurementDraftCompetitorSchema,
   measurementDraftAuthoringSchema,
   MEASUREMENT_DRAFT_MAX_ASSIGNMENTS_PER_ACTION,
   MEASUREMENT_DRAFT_MAX_GROUPS,
@@ -16621,6 +16775,8 @@ export {
   measurementDraftUpsertGroupRequestSchema,
   measurementDraftRemoveGroupRequestSchema,
   measurementDraftUpsertCompetitorRequestSchema,
+  measurementDraftPinCompetitorRequestSchema,
+  measurementDraftPinCompetitorResponseSchema,
   measurementDraftRemoveCompetitorRequestSchema,
   measurementDraftCompilePreviewResponseSchema,
   measurementDraftDiffPreviewResponseSchema,
@@ -16920,6 +17076,9 @@ export {
   modelIdsEquivalent,
   brandMetricsDtoSchema,
   sourceBreakdownDtoSchema,
+  competitorLandscapeQuerySchema,
+  COMPETITOR_LANDSCAPE_MODEL_GROUP_LIMIT,
+  competitorLandscapeResponseSchema,
   parseWindow,
   windowCutoff,
   resolveDateRange,

package/dist/{chunk-IM4HFNGF.js → chunk-FVC7PGYQ.js} RENAMED Viewed

@@ -25,6 +25,7 @@ import {
   classifySkillFile,
   coerceSkillManifest,
   competitorBatchRequestSchema,
+  competitorLandscapeQuerySchema,
   describeError,
   discoveryBucketSchema,
   discoveryCompetitorTypeSchema,
@@ -92,7 +93,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-GN2G7VFK.js";
+} from "./chunk-DY5ZDKQW.js";
 // src/config.ts
 import fs from "fs";
@@ -2398,6 +2399,18 @@ var postApiV1ProjectsByNameCompetitors = (options) => {
     }
   });
 };
+var getApiV1ProjectsByNameAnalyticsCompetitors = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/analytics/competitors",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameRuns = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -6583,6 +6596,16 @@ var ApiClient = class {
       })
     );
   }
+  /** Stored competitor SOV, optionally grouped or filtered by requested model; never starts provider work. */
+  async getCompetitorLandscape(project, opts = {}) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameAnalyticsCompetitors({
+        client: this.heyClient,
+        path: { name: project },
+        query: opts
+      })
+    );
+  }
   async getAnalyticsGaps(project, window) {
     return this.invoke(
       () => getApiV1ProjectsByNameAnalyticsGaps({
@@ -9088,6 +9111,9 @@ var competitorsInputSchema = z3.object({
   project: projectNameSchema,
   request: competitorBatchRequestSchema
 });
+var competitorLandscapeInputSchema = competitorLandscapeQuerySchema.safeExtend({
+  project: projectNameSchema
+}).strict();
 var projectUpsertInputSchema = z3.object({
   project: projectNameSchema,
   request: projectUpsertRequestSchema
@@ -9480,6 +9506,20 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}/analytics/sources"],
     handler: (client2, input) => client2.getAnalyticsSources(input.project, { window: input.window, limit: input.limit })
   }),
+  defineTool({
+    name: "canonry_competitor_landscape",
+    title: "Get historical competitor landscape",
+    description: "Returns pinned competitors first, then observed direct competitors and other cited sources from stored answer/source evidence only. Mention share is percentage points (0..100) from answer text; citations are independent. Share of voice needs ONE query class: `queryClass=all`, and omitting it, pool branded and non-brand, so every `shareOfVoice` comes back null and only the counts are published. Pass `queryClass=non-brand` (or `branded`) for a ratio, exactly as visibility-stats does. A project with no brand name or alias cannot be split by class, so a class-scoped read on one is refused rather than answered empty. Optional groupBy: model adds provider/requested-model groups with separate served-model evidence and sample counts. Optional model filters one exact requested model ID and requires provider. Unknown historical models remain explicit. Groups are not a matched-query or equal-weight comparison. Advanced reads support one market group or explicit scope: all-markets. No provider, discovery, or classifier work runs. Ranked lists are capped at 100 observed/other-source rows per group; pins remain complete. Model groups are capped at 50 and disclose truncation.",
+    access: "read",
+    tier: "monitoring",
+    inputSchema: competitorLandscapeInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/analytics/competitors"],
+    handler: (client2, input) => {
+      const { project, ...query } = input;
+      return client2.getCompetitorLandscape(project, query);
+    }
+  }),
   defineTool({
     name: "canonry_search",
     title: "Search project (composite)",

package/dist/{chunk-G7M2KM7Q.js → chunk-I3KSOMJA.js} RENAMED Viewed

@@ -5,11 +5,11 @@ import {
   installSkills,
   loadConfigRaw,
   saveConfigPatch
-} from "./chunk-IM4HFNGF.js";
+} from "./chunk-FVC7PGYQ.js";
 import {
   SKILL_MANIFEST_FILENAME,
   SkillsClients
-} from "./chunk-GN2G7VFK.js";
+} from "./chunk-DY5ZDKQW.js";
 // src/skills-autosync.ts
 import fs from "fs";