@ainyc/canonry 2.10.3 → 2.12.0

package/dist/{chunk-Z3BWDCBJ.js → chunk-PLI7EOPM.js}

@@ -1540,15 +1540,55 @@ var ccCachedReleaseSchema = z14.object({
   lastUsedAt: z14.string().nullable()
 });
 
-// ../contracts/src/content.ts
+// ../contracts/src/composites.ts
 import { z as z15 } from "zod";
-var contentActionSchema = z15.enum(["create", "expand", "refresh", "add-schema"]);
+var searchHitKindSchema = z15.enum(["snapshot", "insight"]);
+var projectSearchSnapshotHitSchema = z15.object({
+  kind: z15.literal("snapshot"),
+  id: z15.string(),
+  runId: z15.string(),
+  keyword: z15.string(),
+  provider: z15.string(),
+  model: z15.string().nullable(),
+  citationState: citationStateSchema,
+  matchedField: z15.enum(["answerText", "citedDomains", "searchQueries", "keyword"]),
+  snippet: z15.string(),
+  createdAt: z15.string()
+});
+var projectSearchInsightHitSchema = z15.object({
+  kind: z15.literal("insight"),
+  id: z15.string(),
+  runId: z15.string().nullable(),
+  type: z15.enum(["regression", "gain", "opportunity"]),
+  severity: z15.enum(["critical", "high", "medium", "low"]),
+  title: z15.string(),
+  keyword: z15.string(),
+  provider: z15.string(),
+  matchedField: z15.enum(["title", "keyword", "recommendation", "cause"]),
+  snippet: z15.string(),
+  dismissed: z15.boolean(),
+  createdAt: z15.string()
+});
+var projectSearchHitSchema = z15.discriminatedUnion("kind", [
+  projectSearchSnapshotHitSchema,
+  projectSearchInsightHitSchema
+]);
+var projectSearchResponseSchema = z15.object({
+  query: z15.string(),
+  totalHits: z15.number().int().nonnegative(),
+  truncated: z15.boolean(),
+  hits: z15.array(projectSearchHitSchema)
+});
+
+// ../contracts/src/content.ts
+import { z as z16 } from "zod";
+var contentActionSchema = z16.enum(["create", "expand", "refresh", "add-schema"]);
 var ContentActions = contentActionSchema.enum;
-var demandSourceSchema = z15.enum(["gsc", "competitor-evidence", "both"]);
+var demandSourceSchema = z16.enum(["gsc", "competitor-evidence", "both"]);
 var DemandSources = demandSourceSchema.enum;
-var actionConfidenceSchema = z15.enum(["high", "medium", "low"]);
+var actionConfidenceSchema = z16.enum(["high", "medium", "low"]);
 var ActionConfidences = actionConfidenceSchema.enum;
-var pageTypeSchema = z15.enum([
+var pageTypeSchema = z16.enum([
   "blog-post",
   "comparison",
   "listicle",
@@ -1557,7 +1597,7 @@ var pageTypeSchema = z15.enum([
   "glossary"
 ]);
 var PageTypes = pageTypeSchema.enum;
-var contentActionStateSchema = z15.enum([
+var contentActionStateSchema = z16.enum([
   "proposed",
   "briefed",
   "payload-generated",
@@ -1567,79 +1607,79 @@ var contentActionStateSchema = z15.enum([
   "dismissed"
 ]);
 var ContentActionStates = contentActionStateSchema.enum;
-var ourBestPageSchema = z15.object({
-  url: z15.string(),
-  gscImpressions: z15.number().nonnegative(),
-  gscClicks: z15.number().nonnegative(),
+var ourBestPageSchema = z16.object({
+  url: z16.string(),
+  gscImpressions: z16.number().nonnegative(),
+  gscClicks: z16.number().nonnegative(),
   // Null when the page came from the inventory fallback (no GSC ranking data).
-  gscAvgPosition: z15.number().nonnegative().nullable(),
-  organicSessions: z15.number().nonnegative()
-});
-var winningCompetitorSchema = z15.object({
-  domain: z15.string(),
-  url: z15.string(),
-  title: z15.string(),
-  citationCount: z15.number().int().nonnegative()
-});
-var scoreBreakdownSchema = z15.object({
-  demand: z15.number(),
-  competitor: z15.number(),
-  absence: z15.number(),
-  gapSeverity: z15.number()
-});
-var existingActionRefSchema = z15.object({
-  actionId: z15.string(),
+  gscAvgPosition: z16.number().nonnegative().nullable(),
+  organicSessions: z16.number().nonnegative()
+});
+var winningCompetitorSchema = z16.object({
+  domain: z16.string(),
+  url: z16.string(),
+  title: z16.string(),
+  citationCount: z16.number().int().nonnegative()
+});
+var scoreBreakdownSchema = z16.object({
+  demand: z16.number(),
+  competitor: z16.number(),
+  absence: z16.number(),
+  gapSeverity: z16.number()
+});
+var existingActionRefSchema = z16.object({
+  actionId: z16.string(),
   state: contentActionStateSchema,
-  lastUpdated: z15.string()
+  lastUpdated: z16.string()
 });
-var contentTargetRowDtoSchema = z15.object({
-  targetRef: z15.string(),
-  query: z15.string(),
+var contentTargetRowDtoSchema = z16.object({
+  targetRef: z16.string(),
+  query: z16.string(),
   action: contentActionSchema,
   ourBestPage: ourBestPageSchema.nullable(),
   winningCompetitor: winningCompetitorSchema.nullable(),
-  score: z15.number(),
+  score: z16.number(),
   scoreBreakdown: scoreBreakdownSchema,
-  drivers: z15.array(z15.string()),
+  drivers: z16.array(z16.string()),
   demandSource: demandSourceSchema,
   actionConfidence: actionConfidenceSchema,
   existingAction: existingActionRefSchema.nullable()
 });
-var contentTargetsResponseDtoSchema = z15.object({
-  targets: z15.array(contentTargetRowDtoSchema),
-  contextMetrics: z15.object({
-    totalAiReferralSessions: z15.number().int().nonnegative(),
-    latestRunId: z15.string(),
-    runTimestamp: z15.string()
+var contentTargetsResponseDtoSchema = z16.object({
+  targets: z16.array(contentTargetRowDtoSchema),
+  contextMetrics: z16.object({
+    totalAiReferralSessions: z16.number().int().nonnegative(),
+    latestRunId: z16.string(),
+    runTimestamp: z16.string()
   })
 });
-var contentGroundingSourceSchema = z15.object({
-  uri: z15.string(),
-  title: z15.string(),
-  domain: z15.string(),
-  isOurDomain: z15.boolean(),
-  isCompetitor: z15.boolean(),
-  citationCount: z15.number().int().nonnegative(),
-  providers: z15.array(providerNameSchema)
-});
-var contentSourceRowDtoSchema = z15.object({
-  query: z15.string(),
-  groundingSources: z15.array(contentGroundingSourceSchema)
-});
-var contentSourcesResponseDtoSchema = z15.object({
-  sources: z15.array(contentSourceRowDtoSchema),
-  latestRunId: z15.string()
-});
-var contentGapRowDtoSchema = z15.object({
-  query: z15.string(),
-  competitorDomains: z15.array(z15.string()),
-  competitorCount: z15.number().int().nonnegative(),
-  missRate: z15.number().min(0).max(1),
-  lastSeenInRunId: z15.string()
-});
-var contentGapsResponseDtoSchema = z15.object({
-  gaps: z15.array(contentGapRowDtoSchema),
-  latestRunId: z15.string()
+var contentGroundingSourceSchema = z16.object({
+  uri: z16.string(),
+  title: z16.string(),
+  domain: z16.string(),
+  isOurDomain: z16.boolean(),
+  isCompetitor: z16.boolean(),
+  citationCount: z16.number().int().nonnegative(),
+  providers: z16.array(providerNameSchema)
+});
+var contentSourceRowDtoSchema = z16.object({
+  query: z16.string(),
+  groundingSources: z16.array(contentGroundingSourceSchema)
+});
+var contentSourcesResponseDtoSchema = z16.object({
+  sources: z16.array(contentSourceRowDtoSchema),
+  latestRunId: z16.string()
+});
+var contentGapRowDtoSchema = z16.object({
+  query: z16.string(),
+  competitorDomains: z16.array(z16.string()),
+  competitorCount: z16.number().int().nonnegative(),
+  missRate: z16.number().min(0).max(1),
+  lastSeenInRunId: z16.string()
+});
+var contentGapsResponseDtoSchema = z16.object({
+  gaps: z16.array(contentGapRowDtoSchema),
+  latestRunId: z16.string()
 });
 
 // src/client.ts
@@ -2233,6 +2273,17 @@ var ApiClient = class {
   async getHealth(project) {
     return this.request("GET", `/projects/${encodeURIComponent(project)}/health/latest`);
   }
+  async getProjectOverview(project) {
+    return this.request("GET", `/projects/${encodeURIComponent(project)}/overview`);
+  }
+  async searchProject(project, opts) {
+    const params = new URLSearchParams({ q: opts.q });
+    if (opts.limit !== void 0) params.set("limit", String(opts.limit));
+    return this.request(
+      "GET",
+      `/projects/${encodeURIComponent(project)}/search?${params.toString()}`
+    );
+  }
   async getHealthHistory(project, limit) {
     const qs = limit ? `?limit=${limit}` : "";
     return this.request("GET", `/projects/${encodeURIComponent(project)}/health/history${qs}`);

package/dist/cli.js

@@ -17,7 +17,7 @@ import {
   setGoogleAuthConfig,
   showFirstRunNotice,
   trackEvent
-} from "./chunk-FAP76VXF.js";
+} from "./chunk-FCYNFM4B.js";
 import {
   CcReleaseSyncStatuses,
   CliError,
@@ -41,7 +41,7 @@ import {
   saveConfig,
   saveConfigPatch,
   usageError
-} from "./chunk-Z3BWDCBJ.js";
+} from "./chunk-PLI7EOPM.js";
 import {
   apiKeys,
   competitors,
@@ -1847,7 +1847,7 @@ async function gaSocialReferralSummary(project, opts) {
     console.log(`  Sessions: ${traffic.socialSessions} (${traffic.socialSharePct}% of ${traffic.totalSessions} total)`);
     console.log(`  Users:    ${traffic.socialUsers}`);
     console.log();
-    const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+    const fmtTrend = (pct2) => pct2 === null ? "n/a" : `${pct2 >= 0 ? "+" : ""}${pct2}%`;
     console.log(`  7d trend:  ${fmtTrend(trend.trend7dPct)} (${trend.socialSessions7d} vs ${trend.socialSessionsPrev7d})`);
     console.log(`  30d trend: ${fmtTrend(trend.trend30dPct)} (${trend.socialSessions30d} vs ${trend.socialSessionsPrev30d})`);
     if (trend.biggestMover) {
@@ -1890,7 +1890,7 @@ async function gaSocialReferralSummary(project, opts) {
 async function gaAttribution(project, opts) {
   const client = getClient4();
   const traffic = await client.gaTraffic(project);
-  const fmtTrend = (pct) => pct === null ? "n/a" : `${pct >= 0 ? "+" : ""}${pct}%`;
+  const fmtTrend = (pct2) => pct2 === null ? "n/a" : `${pct2 >= 0 ? "+" : ""}${pct2}%`;
   if (opts?.trend) {
     const trend = await client.gaAttributionTrend(project);
     if (opts.format === "json") {
@@ -4047,14 +4047,14 @@ function printMetrics(data) {
   console.log(`
 Citation Rate Trends (${data.window})`);
   console.log("\u2500".repeat(50));
-  const pct = (n) => `${(n * 100).toFixed(1)}%`;
-  console.log(`  Overall: ${pct(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
+  const pct2 = (n) => `${(n * 100).toFixed(1)}%`;
+  console.log(`  Overall: ${pct2(data.overall.citationRate)} (${data.overall.cited}/${data.overall.total})`);
   console.log(`  Trend:   ${data.trend}`);
   if (Object.keys(data.byProvider).length > 0) {
     console.log(`
   By Provider:`);
     for (const [provider, metric] of Object.entries(data.byProvider)) {
-      console.log(`    ${provider.padEnd(10)} ${pct(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
+      console.log(`    ${provider.padEnd(10)} ${pct2(metric.citationRate).padStart(6)} (${metric.cited}/${metric.total})`);
     }
   }
   if (data.buckets.length > 0) {
@@ -4063,7 +4063,7 @@ Citation Rate Trends (${data.window})`);
     for (const bucket of data.buckets) {
       const start = bucket.startDate.slice(0, 10);
       const bar = bucket.total > 0 ? "\u2588".repeat(Math.round(bucket.citationRate * 20)) : "";
-      console.log(`    ${start}  ${pct(bucket.citationRate).padStart(6)}  ${bar}`);
+      console.log(`    ${start}  ${pct2(bucket.citationRate).padStart(6)}  ${bar}`);
     }
   }
 }
@@ -4100,9 +4100,9 @@ Source Origin Breakdown`);
     return;
   }
   for (const cat of data.overall) {
-    const pct = `${(cat.percentage * 100).toFixed(1)}%`;
+    const pct2 = `${(cat.percentage * 100).toFixed(1)}%`;
     const domains = cat.topDomains.slice(0, 3).map((d) => d.domain).join(", ");
-    console.log(`  ${cat.label.padEnd(20)} ${pct.padStart(6)}  (${cat.count})  ${domains}`);
+    console.log(`  ${cat.label.padEnd(20)} ${pct2.padStart(6)}  (${cat.count})  ${domains}`);
   }
 }
 
@@ -6026,6 +6026,84 @@ async function showHealth(project, opts) {
   }
 }
 
+// src/commands/overview.ts
+async function showOverview(project, opts) {
+  const client = createApiClient();
+  const overview = await client.getProjectOverview(project);
+  if (opts.format === "json") {
+    console.log(JSON.stringify(overview, null, 2));
+    return;
+  }
+  const { project: meta, latestRun, health, topInsights, keywordCounts, providers, transitions } = overview;
+  console.log(`Overview: ${meta.displayName ?? meta.name} (${meta.name})
+`);
+  console.log(`  Domain:   ${meta.canonicalDomain}`);
+  console.log(`  Country:  ${meta.country}`);
+  console.log(`  Language: ${meta.language}`);
+  if (latestRun.run) {
+    const finished = latestRun.run.finishedAt ?? "\u2014";
+    console.log(`
+  Latest run: ${latestRun.run.id} (${latestRun.run.status}, ${finished})`);
+    console.log(`  Total runs: ${latestRun.totalRuns}`);
+  } else {
+    console.log("\n  No runs yet.");
+  }
+  console.log(`
+  Keywords cited: ${keywordCounts.citedKeywords}/${keywordCounts.totalKeywords} (${pct(keywordCounts.citedRate)})`);
+  if (providers.length > 0) {
+    console.log("  Providers:");
+    for (const p of providers) {
+      console.log(`    ${p.provider.padEnd(10)} ${p.cited}/${p.total} (${pct(p.citedRate)})`);
+    }
+  }
+  if (transitions.since) {
+    console.log(`
+  vs run at ${transitions.since}: +${transitions.gained} gained, -${transitions.lost} lost, ${transitions.emerging} emerging`);
+  }
+  if (health) {
+    console.log(`
+  Health: ${pct(health.overallCitedRate)} cited (${health.citedPairs}/${health.totalPairs} pairs)`);
+  }
+  if (topInsights.length > 0) {
+    console.log("\n  Top insights:");
+    for (const insight of topInsights) {
+      console.log(`    [${insight.severity.toUpperCase()}] ${insight.type} \u2014 ${insight.title}`);
+    }
+  }
+}
+function pct(value) {
+  return `${(value * 100).toFixed(1)}%`;
+}
+
+// src/commands/search.ts
+async function searchProject(project, opts) {
+  const client = createApiClient();
+  const result = await client.searchProject(project, { q: opts.query, limit: opts.limit });
+  if (opts.format === "json") {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(`Search: "${result.query}" \u2014 ${result.totalHits} hit${result.totalHits === 1 ? "" : "s"}${result.truncated ? " (truncated)" : ""}
+`);
+  if (result.hits.length === 0) {
+    console.log("  No matches.");
+    return;
+  }
+  for (const hit of result.hits) {
+    if (hit.kind === "snapshot") {
+      console.log(`  [snapshot] ${hit.keyword} (${hit.provider}, ${hit.citationState}) \u2014 ${hit.matchedField}`);
+      console.log(`    ${hit.snippet}`);
+      console.log(`    run=${hit.runId}  at ${hit.createdAt}`);
+    } else {
+      const dismissed = hit.dismissed ? " [dismissed]" : "";
+      console.log(`  [insight ${hit.severity.toUpperCase()}] ${hit.type} \u2014 ${hit.title}${dismissed}`);
+      console.log(`    ${hit.snippet}`);
+      console.log(`    keyword=${hit.keyword}  at ${hit.createdAt}`);
+    }
+    console.log("");
+  }
+}
+
 // src/cli-commands/intelligence.ts
 var INTELLIGENCE_CLI_COMMANDS = [
   {
@@ -6072,6 +6150,34 @@ var INTELLIGENCE_CLI_COMMANDS = [
       });
       await showHealth(project, { history, limit, format: input.format });
     }
+  },
+  {
+    path: ["overview"],
+    usage: "canonry overview <project> [--format json]",
+    options: {},
+    run: async (input) => {
+      const usage = "canonry overview <project> [--format json]";
+      const project = requireProject(input, "overview", usage);
+      await showOverview(project, { format: input.format });
+    }
+  },
+  {
+    path: ["search"],
+    usage: "canonry search <project> <query> [--limit <n>] [--format json]",
+    options: {
+      limit: { type: "string" }
+    },
+    run: async (input) => {
+      const usage = "canonry search <project> <query> [--limit <n>] [--format json]";
+      const project = requireProject(input, "search", usage);
+      const query = requirePositional(input, 1, { command: "search", usage, message: "query is required" });
+      const limit = parseIntegerOption(input, "limit", {
+        command: "search",
+        usage,
+        message: "--limit must be an integer"
+      });
+      await searchProject(project, { query, limit, format: input.format });
+    }
   }
 ];
 

package/dist/index.js

@@ -1,9 +1,9 @@
 import {
   createServer
-} from "./chunk-FAP76VXF.js";
+} from "./chunk-FCYNFM4B.js";
 import {
   loadConfig
-} from "./chunk-Z3BWDCBJ.js";
+} from "./chunk-PLI7EOPM.js";
 import "./chunk-UM6RDSRJ.js";
 import "./chunk-MLKGABMK.js";
 export {

package/dist/mcp.js

@@ -10,7 +10,7 @@ import {
   projectUpsertRequestSchema,
   runTriggerRequestSchema,
   scheduleUpsertRequestSchema
-} from "./chunk-Z3BWDCBJ.js";
+} from "./chunk-PLI7EOPM.js";
 import "./chunk-MLKGABMK.js";
 
 // src/mcp/cli.ts
@@ -202,6 +202,32 @@ var canonryMcpTools = [
     openApiOperations: ["GET /api/v1/projects/{name}"],
     handler: (client, input) => client.getProject(input.project)
   }),
+  defineTool({
+    name: "canonry_project_overview",
+    title: "Get project overview (composite)",
+    description: 'One-call summary for "how is project X doing?" \u2014 bundles project info, latest run, top undismissed insights, latest health snapshot, keyword cited rate, per-provider breakdown, and gained/lost/emerging vs the previous run. Prefer this over fanning out to separate tools.',
+    access: "read",
+    tier: "core",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/overview"],
+    handler: (client, input) => client.getProjectOverview(input.project)
+  }),
+  defineTool({
+    name: "canonry_search",
+    title: "Search project (composite)",
+    description: "Search query snapshots and intelligence insights for the given text. Looks at snapshot answer text, cited domains, raw provider responses, and insight title/keyword/recommendation/cause. Returns ranked hits with snippets \u2014 use it instead of paginating snapshots when you need to find a competitor mention or term.",
+    access: "read",
+    tier: "core",
+    inputSchema: z2.object({
+      project: projectNameSchema,
+      q: z2.string().min(2).describe("Search term, at least 2 characters."),
+      limit: z2.number().int().positive().max(50).optional().describe("Max combined hits (1-50, default 25).")
+    }),
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/search"],
+    handler: (client, input) => client.searchProject(input.project, { q: input.q, limit: input.limit })
+  }),
   defineTool({
     name: "canonry_project_export",
     title: "Export project config",
@@ -885,7 +911,9 @@ var DynamicToolCatalog = class {
   loaded = /* @__PURE__ */ new Set();
   eager;
   scope;
-  constructor(entries, scope, options = {}) {
+  server;
+  constructor(server, entries, scope, options = {}) {
+    this.server = server;
     this.entries = entries;
     this.scope = scope;
     this.eager = Boolean(options.eager);
@@ -899,9 +927,11 @@ var DynamicToolCatalog = class {
   }
   applyInitialEnablement() {
     if (this.eager) return;
-    for (const entry of this.entries) {
-      if (entry.tool.tier !== "core") entry.registered.disable();
-    }
+    this.batchListChanged(() => {
+      for (const entry of this.entries) {
+        if (entry.tool.tier !== "core") entry.registered.disable();
+      }
+    });
   }
   loadToolkit(rawName) {
     if (!isCanonryMcpToolkitName(rawName)) {
@@ -916,9 +946,11 @@ var DynamicToolCatalog = class {
     if (this.loaded.has(name)) {
       return { status: "already-loaded", name, tools: matches.map((entry) => entry.tool.name) };
     }
-    for (const entry of matches) {
-      entry.registered.enable();
-    }
+    this.batchListChanged(() => {
+      for (const entry of matches) {
+        entry.registered.enable();
+      }
+    });
     this.loaded.add(name);
     return { status: "loaded", name, tools: matches.map((entry) => entry.tool.name) };
   }
@@ -929,7 +961,7 @@ var DynamicToolCatalog = class {
       loadedToolkits: [...this.loaded].sort(),
       coreTools: this.entries.filter((entry) => entry.tool.tier === "core").map((entry) => entry.tool.name),
       toolkits: CANONRY_MCP_TOOLKITS.map((toolkit) => this.toolkitEntry(toolkit)).filter((entry) => entry.toolCount > 0),
-      usage: "Call canonry_load_toolkit with one of the toolkit names listed in `toolkits[].name` to register its tools for the rest of this session."
+      usage: "Call canonry_load_toolkit with one of the toolkit names listed in `toolkits[].name` to register its tools for the rest of this session. Wait for its response before calling any newly enabled tool."
     };
   }
   toolkitEntry(toolkit) {
@@ -947,6 +979,25 @@ var DynamicToolCatalog = class {
   toolsForToolkit(name) {
     return this.entries.filter((entry) => entry.tool.tier === name).map((entry) => entry.tool.name);
   }
+  // RegisteredTool.enable/disable each call sendToolListChanged on the McpServer
+  // we registered with. Loading an 11-tool toolkit emits 11 notifications under
+  // that contract, which a spec-compliant client will treat as 11 catalog
+  // refetches. Coalesce them into one notification per batch by intercepting
+  // the SDK's sender for the duration of the batch.
+  batchListChanged(fn) {
+    const host = this.server;
+    const original = host.sendToolListChanged;
+    let suppressed = false;
+    host.sendToolListChanged = () => {
+      suppressed = true;
+    };
+    try {
+      fn();
+    } finally {
+      host.sendToolListChanged = original;
+    }
+    if (suppressed) original.call(host);
+  }
 };
 
 // src/mcp/server.ts
@@ -981,7 +1032,7 @@ function createCanonryMcpServerWithCatalog(options = {}) {
     );
     entries.push({ tool, registered });
   }
-  const catalog = new DynamicToolCatalog(entries, scope, { eager: options.eager });
+  const catalog = new DynamicToolCatalog(server, entries, scope, { eager: options.eager });
   catalog.applyInitialEnablement();
   registerMetaTools(server, catalog);
   return { server, catalog };
@@ -1004,7 +1055,7 @@ function registerMetaTools(server, catalog) {
     "canonry_load_toolkit",
     {
       title: "Load a Canonry MCP toolkit",
-      description: "Register a toolkit's tools for this session and emit notifications/tools/list_changed. Idempotent. Loaded toolkits remain loaded for the rest of the session.",
+      description: `Register a toolkit's tools for this session and emit one notifications/tools/list_changed. Idempotent. Loaded toolkits remain loaded for the rest of the session. Wait for this call to return before calling any newly enabled tool \u2014 pipelining the call with a tools/call on the same connection can race the registration and fail with "Tool ... disabled".`,
       inputSchema: loadToolkitInputSchema.shape,
       annotations: { readOnlyHint: false, idempotentHint: true, destructiveHint: false }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainyc/canonry",
-  "version": "2.10.3",
+  "version": "2.12.0",
   "type": "module",
   "description": "Agent-first open-source AEO operating platform - track how answer engines cite your domain",
   "license": "FSL-1.1-ALv2",
@@ -60,19 +60,19 @@
     "tsup": "^8.5.1",
     "tsx": "^4.19.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",
+    "@ainyc/canonry-config": "0.0.0",
     "@ainyc/canonry-intelligence": "0.0.0",
-    "@ainyc/canonry-contracts": "0.0.0",
     "@ainyc/canonry-integration-bing": "0.0.0",
+    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
+    "@ainyc/canonry-integration-wordpress": "0.0.0",
     "@ainyc/canonry-integration-google": "0.0.0",
     "@ainyc/canonry-provider-cdp": "0.0.0",
-    "@ainyc/canonry-integration-wordpress": "0.0.0",
-    "@ainyc/canonry-provider-claude": "0.0.0",
     "@ainyc/canonry-provider-gemini": "0.0.0",
-    "@ainyc/canonry-provider-openai": "0.0.0",
-    "@ainyc/canonry-integration-commoncrawl": "0.0.0",
     "@ainyc/canonry-provider-local": "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": {