@canonry/canonry 4.129.1 → 4.130.0

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

@@ -30,6 +30,7 @@ import {
   queryBatchRequestSchema,
   queryGenerateRequestSchema,
   reportPeriodSchema,
+  researchRunCreateSchema,
   runTriggerRequestSchema,
   schedulableRunKindSchema,
   scheduleUpsertRequestSchema,
@@ -38,7 +39,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-K4FDDCYG.js";
+} from "./chunk-NVRJZU6V.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1147,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: [
@@ -5369,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({
@@ -6222,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."),
@@ -7504,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",