@ainyc/canonry 4.142.0 → 4.144.0

package/dist/{chunk-D7NJUGNQ.js → chunk-Z672VQ7G.js}

@@ -26,6 +26,9 @@ import {
   gscPerformanceOrderBySchema,
   keywordBatchRequestSchema,
   keywordGenerateRequestSchema,
+  measurementDiscoveryRequestSchema,
+  measurementPlanAuthoringSchema,
+  measurementPlanPublishRequestSchema,
   notificationCreateRequestSchema,
   notificationEventSchema,
   organicEvidencePeriodSchema,
@@ -43,7 +46,7 @@ import {
   trafficConnectWordpressRequestSchema,
   trafficEventKindSchema,
   trafficSeriesGranularitySchema
-} from "./chunk-LS6SEZVF.js";
+} from "./chunk-WADGZMWT.js";
 
 // src/config.ts
 import fs from "fs";
@@ -1144,6 +1147,130 @@ var putApiV1ProjectsByName = (options) => {
     }
   });
 };
+var postApiV1ProjectsByNameMeasurementDiscovery = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-discovery",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var getApiV1ProjectsByNameMeasurementPlan = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan",
+    ...options
+  });
+};
+var putApiV1ProjectsByNameMeasurementPlan = (options) => {
+  return (options.client ?? client).put({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameMeasurementPlanCompilePreview = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan/compile-preview",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var postApiV1ProjectsByNameMeasurementPlanDiffPreview = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan/diff-preview",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var getApiV1ProjectsByNameMeasurementPlanVersions = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan/versions",
+    ...options
+  });
+};
+var postApiV1ProjectsByNameMeasurementPlanSegmentsByStableKeyRetire = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan/segments/{stableKey}/retire",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameMeasurementPlanVersionsByRevision = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-plan/versions/{revision}",
+    ...options
+  });
+};
+var getApiV1ProjectsByNameMeasurementReport = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/projects/{name}/measurement-report",
+    ...options
+  });
+};
 var getApiV1Projects = (options) => {
   return (options?.client ?? client).get({
     security: [
@@ -1768,6 +1895,46 @@ var postApiV1KeysByIdRevoke = (options) => {
     ...options
   });
 };
+var getApiV1Users = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/users",
+    ...options
+  });
+};
+var postApiV1Users = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/users",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
+var deleteApiV1UsersByName = (options) => {
+  return (options.client ?? client).delete({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/api/v1/users/{name}",
+    ...options
+  });
+};
 var postApiV1Snapshot = (options) => {
   return (options.client ?? client).post({
     security: [
@@ -4558,6 +4725,77 @@ var ApiClient = class {
       })
     );
   }
+  async getMeasurementPlan(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameMeasurementPlan({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async listMeasurementPlanVersions(project) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameMeasurementPlanVersions({ client: this.heyClient, path: { name: project } })
+    );
+  }
+  async getMeasurementPlanVersion(project, revision) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameMeasurementPlanVersionsByRevision({
+        client: this.heyClient,
+        path: { name: project, revision }
+      })
+    );
+  }
+  async compileMeasurementPlanPreview(project, plan) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameMeasurementPlanCompilePreview({
+        client: this.heyClient,
+        path: { name: project },
+        body: plan
+      })
+    );
+  }
+  async diffMeasurementPlanPreview(project, plan) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameMeasurementPlanDiffPreview({
+        client: this.heyClient,
+        path: { name: project },
+        body: plan
+      })
+    );
+  }
+  async publishMeasurementPlan(project, request) {
+    return this.invoke(
+      () => putApiV1ProjectsByNameMeasurementPlan({
+        client: this.heyClient,
+        path: { name: project },
+        body: request
+      })
+    );
+  }
+  async retireMeasurementPlanSegment(project, stableKey) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameMeasurementPlanSegmentsByStableKeyRetire({
+        client: this.heyClient,
+        path: { name: project, stableKey }
+      })
+    );
+  }
+  async discoverMeasurementTargets(project, request) {
+    return this.invoke(
+      () => postApiV1ProjectsByNameMeasurementDiscovery({
+        client: this.heyClient,
+        path: { name: project },
+        body: request
+      })
+    );
+  }
+  async getMeasurementReport(project, revision) {
+    return this.invoke(
+      () => getApiV1ProjectsByNameMeasurementReport({
+        client: this.heyClient,
+        path: { name: project },
+        query: { revision }
+      })
+    );
+  }
   async listRuns(project, limit, kind) {
     return this.invoke(
       () => getApiV1ProjectsByNameRuns({
@@ -4660,6 +4898,18 @@ var ApiClient = class {
       () => postApiV1KeysByIdRevoke({ client: this.heyClient, path: { id } })
     );
   }
+  // ── Account management ──────────────────────────────────────────────────
+  async listUsers() {
+    return this.invoke(() => getApiV1Users({ client: this.heyClient }));
+  }
+  async createUser(body) {
+    return this.invoke(() => postApiV1Users({ client: this.heyClient, body }));
+  }
+  async deleteUser(name) {
+    return this.invoke(
+      () => deleteApiV1UsersByName({ client: this.heyClient, path: { name } })
+    );
+  }
   async updateProvider(name, body) {
     return this.invoke(
       () => putApiV1SettingsProvidersByName({ client: this.heyClient, path: { name }, body })
@@ -6110,6 +6360,11 @@ var runTriggerInputSchema = z2.object({
   project: projectNameSchema,
   request: runTriggerRequestSchema.optional()
 });
+var measurementPlanVersionInputSchema = z2.object({ project: projectNameSchema, revision: z2.number().int().positive() });
+var measurementPlanPreviewInputSchema = z2.object({ project: projectNameSchema, plan: measurementPlanAuthoringSchema });
+var measurementPlanPublishInputSchema = measurementPlanPublishRequestSchema.extend({ project: projectNameSchema });
+var measurementPlanRetireInputSchema = z2.object({ project: projectNameSchema, stableKey: z2.string().min(1) });
+var measurementDiscoveryInputSchema = measurementDiscoveryRequestSchema.extend({ project: projectNameSchema });
 var runsListInputSchema = z2.object({
   project: projectNameSchema,
   limit: z2.number().int().positive().max(500).optional()
@@ -7671,10 +7926,116 @@ var canonryMcpTools = [
       await client2.putKeywords(input.project, uniqueStrings(input.request.keywords));
     }
   }),
+  defineTool({
+    name: "canonry_measurement_discovery",
+    title: "Discover measurement Targets",
+    description: "Fetch a public sitemap under bounded network policy and deterministically classify project-owned URLs into Target proposals, aliases, shared paths, unmatched paths, and exclusions. Does not publish a plan.",
+    access: "write",
+    tier: "setup",
+    inputSchema: measurementDiscoveryInputSchema,
+    annotations: writeAnnotations({ idempotentHint: false, openWorldHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/measurement-discovery"],
+    handler: (client2, input) => client2.discoverMeasurementTargets(input.project, {
+      sitemapUrl: input.sitemapUrl,
+      rule: input.rule,
+      ...input.maxUrls === void 0 ? {} : { maxUrls: input.maxUrls }
+    })
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_get",
+    title: "Get measurement plan",
+    description: "Get the active measurement plan for a project.",
+    access: "read",
+    tier: "setup",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/measurement-plan"],
+    handler: (client2, input) => client2.getMeasurementPlan(input.project)
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_versions",
+    title: "List measurement plan versions",
+    description: "List immutable measurement-plan revisions.",
+    access: "read",
+    tier: "setup",
+    inputSchema: projectInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/measurement-plan/versions"],
+    handler: (client2, input) => client2.listMeasurementPlanVersions(input.project)
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_version_get",
+    title: "Get measurement plan revision",
+    description: "Get one immutable measurement-plan revision.",
+    access: "read",
+    tier: "setup",
+    inputSchema: measurementPlanVersionInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/measurement-plan/versions/{revision}"],
+    handler: (client2, input) => client2.getMeasurementPlanVersion(input.project, input.revision)
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_compile_preview",
+    title: "Compile measurement plan",
+    description: "Validate and compile a Target/group plan without publishing it.",
+    access: "write",
+    tier: "setup",
+    inputSchema: measurementPlanPreviewInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/measurement-plan/compile-preview"],
+    handler: (client2, input) => client2.compileMeasurementPlanPreview(input.project, input.plan)
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_diff_preview",
+    title: "Preview measurement plan changes",
+    description: "Compare a compiled Target/group plan with the active immutable revision without publishing it.",
+    access: "write",
+    tier: "setup",
+    inputSchema: measurementPlanPreviewInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/measurement-plan/diff-preview"],
+    handler: (client2, input) => client2.diffMeasurementPlanPreview(input.project, input.plan)
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_publish",
+    title: "Publish measurement plan",
+    description: "Publish only when the active revision still matches the revision you reviewed. Use null only when you reviewed a planless project.",
+    access: "write",
+    tier: "setup",
+    inputSchema: measurementPlanPublishInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true }),
+    openApiOperations: ["PUT /api/v1/projects/{name}/measurement-plan"],
+    handler: (client2, input) => client2.publishMeasurementPlan(input.project, {
+      expectedActiveRevision: input.expectedActiveRevision,
+      plan: input.plan
+    })
+  }),
+  defineTool({
+    name: "canonry_measurement_plan_segment_retire",
+    title: "Retire measurement segment",
+    description: "Permanently retire an inactive Target or group stable key. Publish a revision without it first; there is no unretire.",
+    access: "write",
+    tier: "setup",
+    inputSchema: measurementPlanRetireInputSchema,
+    annotations: writeAnnotations({ idempotentHint: true, destructiveHint: true }),
+    openApiOperations: ["POST /api/v1/projects/{name}/measurement-plan/segments/{stableKey}/retire"],
+    handler: (client2, input) => client2.retireMeasurementPlanSegment(input.project, input.stableKey)
+  }),
+  defineTool({
+    name: "canonry_measurement_report",
+    title: "Get measurement report",
+    description: "Get a revision-pinned Target and group measurement report from stored runs. Never starts live provider work.",
+    access: "read",
+    tier: "setup",
+    inputSchema: measurementPlanVersionInputSchema,
+    annotations: readAnnotations(),
+    openApiOperations: ["GET /api/v1/projects/{name}/measurement-report"],
+    handler: (client2, input) => client2.getMeasurementReport(input.project, input.revision)
+  }),
   defineTool({
     name: "canonry_run_trigger",
     title: "Trigger run",
-    description: "Trigger an answer-visibility run for a Canonry project. Pass request.queries[] to scope the sweep to a subset of the project's tracked queries; omit for a full sweep. For verification scenarios (testing whether a provider migration worked, reproducing a regression, sanity-checking after a code change), set request.trigger='probe' \u2014 probe runs write a snapshot you can inspect via canonry_runs_get but are EXCLUDED from dashboard, analytics, intelligence, report, and notifications. Use 'probe' whenever you are testing on your own initiative rather than producing data the user/dashboard will consume.",
+    description: "Trigger an answer-visibility run for a Canonry project. Omit both scoping fields for a full sweep. Pass request.queries[] to measure only some of the project's tracked questions. On a project with a published measurement plan, pass request.measurementScope with at least one group or target to measure one slice of that plan \u2014 a group stands for its member Targets, and only the questions those Targets selected are measured. A scope naming nothing is rejected rather than treated as a full sweep, so omit the field entirely when you want everything. Either kind of slice is recorded as a spot check: it never replaces a full sweep in the dashboard, analytics or report. For verification scenarios (testing whether a provider migration worked, reproducing a regression, sanity-checking after a code change), set request.trigger='probe' \u2014 probe runs write a snapshot you can inspect via canonry_runs_get but are EXCLUDED from dashboard, analytics, intelligence, report, and notifications. Use 'probe' whenever you are testing on your own initiative rather than producing data the user/dashboard will consume.",
     access: "write",
     tier: "core",
     inputSchema: runTriggerInputSchema,