@canonry/canonry 4.129.0 → 4.130.0

package/dist/{chunk-IHRW6WWV.js → chunk-WIALMCXM.js}

@@ -30,14 +30,16 @@ import {
   queryBatchRequestSchema,
   queryGenerateRequestSchema,
   reportPeriodSchema,
+  researchRunCreateSchema,
   runTriggerRequestSchema,
   schedulableRunKindSchema,
   scheduleUpsertRequestSchema,
   trafficConnectCloudRunRequestSchema,
   trafficConnectVercelRequestSchema,
   trafficConnectWordpressRequestSchema,
-  trafficEventKindSchema
-} from "./chunk-BLSHHRRU.js";
+  trafficEventKindSchema,
+  trafficSeriesGranularitySchema
+} from "./chunk-NVRJZU6V.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1146,6 +1148,46 @@ var getApiV1ProjectsByNameDeletePreview = (options) => {
     ...options
   });
 };
+var getApiV1ProjectsByNameResearchRuns = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/research/runs",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameResearchRuns = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/research/runs",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var getApiV1ProjectsByNameResearchRunsByRunId = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/research/runs/{runId}",
+    ...options
+  });
+};
 var getApiV1ProjectsByNameLocations = (options) => {
   return (options.client ?? client).get({
     security: [
@@ -5335,7 +5377,8 @@ var ApiClient = class {
           until: params?.until,
           kind: params?.kind,
           limit: params?.limit !== void 0 ? String(params.limit) : void 0,
-          sourceId: params?.sourceId
+          sourceId: params?.sourceId,
+          granularity: params?.granularity
         }
       })
     );
@@ -5367,6 +5410,37 @@ var ApiClient = class {
       })
     );
   }
+  // ── Research query runs ────────────────────────────────────────────────
+  /**
+   * Start one saved research batch. Research results are deliberately kept
+   * outside the tracked-query basket and visibility-run history.
+   */
+  async startResearchRun(project, request) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameResearchRuns({
+        client: this.heyClient,
+        path: { name: project },
+        body: request
+      })
+    );
+  }
+  async listResearchRuns(project, opts) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameResearchRuns({
+        client: this.heyClient,
+        path: { name: project },
+        query: { limit: opts?.limit !== void 0 ? String(opts.limit) : void 0 }
+      })
+    );
+  }
+  async getResearchRun(project, runId) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameResearchRunsByRunId({
+        client: this.heyClient,
+        path: { name: project, runId }
+      })
+    );
+  }
   async getDiscoveryHarvest(project, sessionId, opts) {
     return this.invoke(
       () => getApiV1ProjectsByNameDiscoverSessionsByIdHarvest({
@@ -6190,9 +6264,10 @@ var trafficEventsInputSchema = z2.object({
   project: projectNameSchema,
   since: z2.string().optional().describe("ISO 8601 lower bound. Defaults to 24h ago when omitted."),
   until: z2.string().optional().describe("ISO 8601 upper bound. Defaults to now when omitted."),
-  kind: z2.union([trafficEventKindSchema, z2.literal("all")]).optional().describe('Filter to "crawler" or "ai-referral"; "all" (default) returns both.'),
+  kind: z2.union([trafficEventKindSchema, z2.literal("all")]).optional().describe('Filter to one traffic kind; "all" (default) returns every kind.'),
   sourceId: z2.string().min(1).optional().describe("Restrict to a single traffic source ID."),
-  limit: z2.number().int().positive().max(5e3).optional().describe("Max combined rows. Defaults to 500, max 5000. Totals always reflect the full window.")
+  limit: z2.number().int().positive().max(5e3).optional().describe("Max combined rows. Defaults to 500, max 5000. Totals always reflect the full window."),
+  granularity: trafficSeriesGranularitySchema.optional().describe("Full-window chart series bucket size: hour (default) or day.")
 });
 var trafficSourceIdInputSchema = z2.object({
   project: projectNameSchema,
@@ -6219,6 +6294,18 @@ var discoverySessionIdInputSchema = z2.object({
   project: projectNameSchema,
   sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start.")
 });
+var researchRunStartInputSchema = z2.object({
+  project: projectNameSchema,
+  request: researchRunCreateSchema.describe("One shared provider/model/location context for every free-form query in this saved research batch.")
+});
+var researchRunsListInputSchema = z2.object({
+  project: projectNameSchema,
+  limit: z2.number().int().positive().max(100).optional().describe("Max saved research runs returned. Default 20.")
+});
+var researchRunIdInputSchema = z2.object({
+  project: projectNameSchema,
+  runId: z2.string().min(1).describe("Research run ID returned by canonry_research_run_start.")
+});
 var discoveryHarvestInputSchema = z2.object({
   project: projectNameSchema,
   sessionId: z2.string().min(1).describe("Discovery session ID returned by canonry_discover_run_start."),
@@ -7110,7 +7197,7 @@ var canonryMcpTools = [
   defineTool({
     name: "canonry_traffic_events",
     title: "List traffic events",
-    description: 'Read crawler and AI-referral hourly rollups from server-side traffic sources. Returns a discriminated list (kind="crawler" rows carry botId/operator/verificationStatus; kind="ai-referral" rows carry product/sourceDomain/evidenceType) plus totals over the full window even when limit truncates rows. Window defaults to last 24h.',
+    description: "Read crawler, AI user-fetch, and AI-referral rollups from server-side traffic sources. Returns complete full-window chart series and totals plus a capped discriminated detail list with explicit truncation metadata. Window defaults to last 24h.",
     access: "read",
     tier: "traffic",
     inputSchema: trafficEventsInputSchema,
@@ -7123,6 +7210,7 @@ var canonryMcpTools = [
       if (input.kind) params.kind = input.kind;
       if (input.sourceId) params.sourceId = input.sourceId;
       if (input.limit !== void 0) params.limit = input.limit;
+      if (input.granularity) params.granularity = input.granularity;
       return client2.trafficListEvents(input.project, params);
     }
   }),
@@ -7500,6 +7588,39 @@ var canonryMcpTools = [
       return { status: "detached", project: input.project };
     }
   }),
+  defineTool({
+    name: "canonry_research_run_start",
+    title: "Start research query run",
+    description: "Run a batch of free-form queries once each against one API provider, with an optional exact model and location. Results are saved as a research run for later inspection. This does not add any query to the tracked basket or affect overview tracking.",
+    access: "write",
+    tier: "discovery",
+    inputSchema: researchRunStartInputSchema,
+    annotations: writeAnnotations({ idempotentHint: false, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/research/runs"],
+    handler: (client2, input) => client2.startResearchRun(input.project, input.request)
+  }),
+  defineTool({
+    name: "canonry_research_runs_list",
+    title: "List research query runs",
+    description: "List saved research query runs for a project, newest first. Research and ICP discovery are distinct workflows: these are direct free-form query experiments and never modify the tracked basket.",
+    access: "read",
+    tier: "discovery",
+    inputSchema: researchRunsListInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/research/runs"],
+    handler: (client2, input) => client2.listResearchRuns(input.project, input.limit === void 0 ? void 0 : { limit: input.limit })
+  }),
+  defineTool({
+    name: "canonry_research_run_get",
+    title: "Get research query run",
+    description: "Get the saved per-query answers, sources, cited domains, and independent mention/citation results for one research run. It is read-only and does not promote or track any query.",
+    access: "read",
+    tier: "discovery",
+    inputSchema: researchRunIdInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/research/runs/{runId}"],
+    handler: (client2, input) => client2.getResearchRun(input.project, input.runId)
+  }),
   defineTool({
     name: "canonry_discover_run_start",
     title: "Start discovery run",