@ainyc/canonry 1.20.0 → 1.20.1

package/dist/{chunk-V7JJJDPL.js → chunk-YXYC7NGJ.js}

@@ -378,6 +378,9 @@ function authInvalid() {
 function runInProgress(projectName) {
   return new AppError("RUN_IN_PROGRESS", `A run is already in progress for '${projectName}'`, 409);
 }
+function runNotCancellable(runId, status) {
+  return new AppError("RUN_NOT_CANCELLABLE", `Run '${runId}' is already in terminal state '${status}' and cannot be cancelled`, 409);
+}
 function unsupportedKind(kind) {
   return new AppError("UNSUPPORTED_KIND", `Kind '${kind}' is not supported in this version`, 400);
 }
@@ -555,7 +558,7 @@ function effectiveDomains(project) {
 
 // ../contracts/src/run.ts
 import { z as z7 } from "zod";
-var runStatusSchema = z7.enum(["queued", "running", "completed", "partial", "failed"]);
+var runStatusSchema = z7.enum(["queued", "running", "completed", "partial", "failed", "cancelled"]);
 var runKindSchema = z7.enum(["answer-visibility", "site-audit", "gsc-sync", "inspect-sitemap"]);
 var runTriggerSchema = z7.enum(["manual", "scheduled", "config-apply"]);
 var citationStateSchema = z7.enum(["cited", "not-cited"]);
@@ -1997,6 +2000,29 @@ async function runRoutes(app, opts) {
     }
     return reply.status(207).send(results);
   });
+  app.post("/runs/:id/cancel", async (request, reply) => {
+    const run = app.db.select().from(runs).where(eq7(runs.id, request.params.id)).get();
+    if (!run) {
+      const err = notFound("Run", request.params.id);
+      return reply.status(err.statusCode).send(err.toJSON());
+    }
+    const terminalStatuses = /* @__PURE__ */ new Set(["completed", "partial", "failed", "cancelled"]);
+    if (terminalStatuses.has(run.status)) {
+      const err = runNotCancellable(run.id, run.status);
+      return reply.status(err.statusCode).send(err.toJSON());
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    app.db.update(runs).set({ status: "cancelled", finishedAt: now, error: "Cancelled by user" }).where(eq7(runs.id, run.id)).run();
+    writeAuditLog(app.db, {
+      projectId: run.projectId,
+      actor: "api",
+      action: "run.cancelled",
+      entityType: "run",
+      entityId: run.id
+    });
+    const updated = app.db.select().from(runs).where(eq7(runs.id, run.id)).get();
+    return reply.send(formatRun(updated));
+  });
   app.get("/runs/:id", async (request, reply) => {
     const run = app.db.select().from(runs).where(eq7(runs.id, request.params.id)).get();
     if (!run) {
@@ -3066,6 +3092,18 @@ var booleanSchema = { type: "boolean" };
 var integerSchema = { type: "integer" };
 var objectSchema = { type: "object", additionalProperties: true };
 var stringArraySchema = { type: "array", items: stringSchema };
+var googleConnectionTypeSchema2 = { type: "string", enum: ["gsc", "ga4"] };
+var locationSchema = {
+  type: "object",
+  required: ["label", "city", "region", "country"],
+  properties: {
+    label: stringSchema,
+    city: stringSchema,
+    region: stringSchema,
+    country: stringSchema,
+    timezone: stringSchema
+  }
+};
 var nameParameter = {
   name: "name",
   in: "path",
@@ -3094,6 +3132,58 @@ var providerNameParameter = {
   description: "Provider name.",
   schema: { type: "string", enum: ["gemini", "openai", "claude", "local"] }
 };
+var locationLabelParameter = {
+  name: "label",
+  in: "path",
+  required: true,
+  description: "Location label.",
+  schema: stringSchema
+};
+var googleTypeParameter = {
+  name: "type",
+  in: "path",
+  required: true,
+  description: "Google connection type.",
+  schema: googleConnectionTypeSchema2
+};
+var projectRunIdParameter = {
+  name: "runId",
+  in: "path",
+  required: true,
+  description: "Run ID for a project run.",
+  schema: stringSchema
+};
+var snapshotIdParameter = {
+  name: "snapshotId",
+  in: "path",
+  required: true,
+  description: "Snapshot ID.",
+  schema: stringSchema
+};
+var limitQueryParameter = {
+  name: "limit",
+  in: "query",
+  description: "Maximum number of records to return.",
+  schema: integerSchema
+};
+var offsetQueryParameter = {
+  name: "offset",
+  in: "query",
+  description: "Number of records to skip.",
+  schema: integerSchema
+};
+var locationQueryParameter = {
+  name: "location",
+  in: "query",
+  description: "Filter by location label. Use an empty value to request locationless results.",
+  schema: stringSchema
+};
+var analyticsWindowParameter = {
+  name: "window",
+  in: "query",
+  description: "Time window for analytics queries.",
+  schema: { type: "string", enum: ["7d", "30d", "90d", "all"] }
+};
 var routeCatalog = [
   {
     method: "get",
@@ -3122,11 +3212,14 @@ var routeCatalog = [
             properties: {
               displayName: stringSchema,
               canonicalDomain: stringSchema,
+              ownedDomains: stringArraySchema,
               country: stringSchema,
               language: stringSchema,
               tags: stringArraySchema,
               labels: objectSchema,
               providers: stringArraySchema,
+              locations: { type: "array", items: locationSchema },
+              defaultLocation: stringSchema,
               configSource: stringSchema
             }
           }
@@ -3169,6 +3262,75 @@ var routeCatalog = [
       404: { description: "Project not found." }
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/locations",
+    summary: "Add a project location",
+    tags: ["projects"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: locationSchema
+        }
+      }
+    },
+    responses: {
+      201: { description: "Location created." },
+      400: { description: "Invalid location." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/locations",
+    summary: "List project locations",
+    tags: ["projects"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Locations returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/locations/{label}",
+    summary: "Remove a project location",
+    tags: ["projects"],
+    parameters: [nameParameter, locationLabelParameter],
+    responses: {
+      204: { description: "Location removed." },
+      400: { description: "Invalid location." },
+      404: { description: "Project or location not found." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/projects/{name}/locations/default",
+    summary: "Set the default project location",
+    tags: ["projects"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["label"],
+            properties: {
+              label: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Default location updated." },
+      400: { description: "Invalid location." },
+      404: { description: "Project not found." }
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/export",
@@ -3214,6 +3376,31 @@ var routeCatalog = [
       200: { description: "Keywords replaced." }
     }
   },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/keywords",
+    summary: "Delete specific keywords",
+    tags: ["keywords"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["keywords"],
+            properties: {
+              keywords: stringArraySchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Remaining keywords returned." },
+      400: { description: "Invalid keyword delete request." }
+    }
+  },
   {
     method: "post",
     path: "/api/v1/projects/{name}/keywords",
@@ -3312,7 +3499,10 @@ var routeCatalog = [
             properties: {
               kind: stringSchema,
               trigger: stringSchema,
-              providers: stringArraySchema
+              providers: stringArraySchema,
+              location: stringSchema,
+              allLocations: booleanSchema,
+              noLocation: booleanSchema
             }
           }
         }
@@ -3375,6 +3565,18 @@ var routeCatalog = [
       404: { description: "Run not found." }
     }
   },
+  {
+    method: "post",
+    path: "/api/v1/runs/{id}/cancel",
+    summary: "Cancel a queued or running run",
+    tags: ["runs"],
+    parameters: [runIdParameter],
+    responses: {
+      200: { description: "Run cancelled." },
+      404: { description: "Run not found." },
+      409: { description: "Run is not cancellable." }
+    }
+  },
   {
     method: "post",
     path: "/api/v1/apply",
@@ -3420,18 +3622,9 @@ var routeCatalog = [
     tags: ["history"],
     parameters: [
       nameParameter,
-      {
-        name: "limit",
-        in: "query",
-        description: "Maximum number of snapshots to return.",
-        schema: integerSchema
-      },
-      {
-        name: "offset",
-        in: "query",
-        description: "Number of snapshots to skip.",
-        schema: integerSchema
-      }
+      limitQueryParameter,
+      offsetQueryParameter,
+      locationQueryParameter
     ],
     responses: {
       200: { description: "Snapshots returned." }
@@ -3442,11 +3635,44 @@ var routeCatalog = [
     path: "/api/v1/projects/{name}/timeline",
     summary: "Get keyword timeline",
     tags: ["history"],
-    parameters: [nameParameter],
+    parameters: [nameParameter, locationQueryParameter],
     responses: {
       200: { description: "Timeline returned." }
     }
   },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/analytics/metrics",
+    summary: "Get citation trend analytics",
+    tags: ["analytics"],
+    parameters: [nameParameter, analyticsWindowParameter],
+    responses: {
+      200: { description: "Citation metrics returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/analytics/gaps",
+    summary: "Get brand gap analysis",
+    tags: ["analytics"],
+    parameters: [nameParameter, analyticsWindowParameter],
+    responses: {
+      200: { description: "Gap analysis returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/analytics/sources",
+    summary: "Get source origin analytics",
+    tags: ["analytics"],
+    parameters: [nameParameter, analyticsWindowParameter],
+    responses: {
+      200: { description: "Source breakdown returned." },
+      404: { description: "Project not found." }
+    }
+  },
   {
     method: "get",
     path: "/api/v1/projects/{name}/snapshots/diff",
@@ -3511,6 +3737,83 @@ var routeCatalog = [
       501: { description: "Provider updates are not supported." }
     }
   },
+  {
+    method: "put",
+    path: "/api/v1/settings/google",
+    summary: "Update Google OAuth settings",
+    tags: ["settings"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["clientId", "clientSecret"],
+            properties: {
+              clientId: stringSchema,
+              clientSecret: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Google settings updated." },
+      400: { description: "Invalid Google settings." },
+      501: { description: "Google settings updates are not supported." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/settings/bing",
+    summary: "Update Bing settings",
+    tags: ["settings"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["apiKey"],
+            properties: {
+              apiKey: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Bing settings updated." },
+      400: { description: "Invalid Bing settings." },
+      501: { description: "Bing settings updates are not supported." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/settings/cdp",
+    summary: "Update CDP endpoint settings",
+    tags: ["settings", "cdp"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["host"],
+            properties: {
+              host: stringSchema,
+              port: integerSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "CDP endpoint updated." },
+      400: { description: "Invalid CDP settings." },
+      501: { description: "CDP updates are not supported." }
+    }
+  },
   {
     method: "put",
     path: "/api/v1/projects/{name}/schedule",
@@ -3664,6 +3967,573 @@ var routeCatalog = [
       400: { description: "Invalid telemetry request." },
       501: { description: "Telemetry configuration is not available." }
     }
+  },
+  {
+    method: "get",
+    path: "/api/v1/screenshots/{snapshotId}",
+    summary: "Fetch a stored browser screenshot",
+    tags: ["cdp"],
+    parameters: [snapshotIdParameter],
+    responses: {
+      200: { description: "Screenshot returned." },
+      404: { description: "Screenshot not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/cdp/status",
+    summary: "Get CDP connection status",
+    tags: ["cdp"],
+    responses: {
+      200: { description: "CDP status returned." },
+      501: { description: "CDP is not configured." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/cdp/screenshot",
+    summary: "Run a one-off browser query and capture screenshots",
+    tags: ["cdp"],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["query"],
+            properties: {
+              query: stringSchema,
+              targets: stringArraySchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "CDP screenshot results returned." },
+      400: { description: "Invalid CDP screenshot request." },
+      501: { description: "CDP screenshot support is not available." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/runs/{runId}/browser-diff",
+    summary: "Compare API and browser provider results for a run",
+    tags: ["cdp", "runs"],
+    parameters: [nameParameter, projectRunIdParameter],
+    responses: {
+      200: { description: "Browser diff returned." },
+      404: { description: "Project or run not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/google/callback",
+    summary: "Handle the shared Google OAuth callback",
+    tags: ["google"],
+    auth: false,
+    parameters: [
+      { name: "code", in: "query", description: "OAuth authorization code.", schema: stringSchema },
+      { name: "state", in: "query", description: "Signed OAuth state payload.", schema: stringSchema },
+      { name: "error", in: "query", description: "OAuth error code.", schema: stringSchema }
+    ],
+    responses: {
+      200: { description: "OAuth callback handled." },
+      400: { description: "Invalid callback request." },
+      500: { description: "OAuth configuration is incomplete." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/callback",
+    summary: "Handle the legacy project-scoped Google OAuth callback",
+    tags: ["google"],
+    auth: false,
+    parameters: [
+      nameParameter,
+      { name: "code", in: "query", description: "OAuth authorization code.", schema: stringSchema },
+      { name: "state", in: "query", description: "Signed OAuth state payload.", schema: stringSchema },
+      { name: "error", in: "query", description: "OAuth error code.", schema: stringSchema }
+    ],
+    responses: {
+      200: { description: "OAuth callback handled." },
+      400: { description: "Invalid callback request." },
+      500: { description: "OAuth configuration is incomplete." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/connections",
+    summary: "List Google connections for a project",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Google connections returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/connect",
+    summary: "Start a Google OAuth connection flow",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["type"],
+            properties: {
+              type: googleConnectionTypeSchema2,
+              propertyId: stringSchema,
+              publicUrl: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Google auth URL returned." },
+      400: { description: "Invalid Google connection request." }
+    }
+  },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/google/connections/{type}",
+    summary: "Delete a Google connection",
+    tags: ["google"],
+    parameters: [nameParameter, googleTypeParameter],
+    responses: {
+      204: { description: "Google connection deleted." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/properties",
+    summary: "List available Google Search Console properties",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Google properties returned." },
+      400: { description: "Google OAuth is not configured." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/projects/{name}/google/connections/{type}/property",
+    summary: "Set the property for a Google connection",
+    tags: ["google"],
+    parameters: [nameParameter, googleTypeParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["propertyId"],
+            properties: {
+              propertyId: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Google property updated." },
+      400: { description: "Invalid property request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "put",
+    path: "/api/v1/projects/{name}/google/connections/{type}/sitemap",
+    summary: "Set the sitemap URL for a Google connection",
+    tags: ["google"],
+    parameters: [nameParameter, googleTypeParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["sitemapUrl"],
+            properties: {
+              sitemapUrl: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Google sitemap updated." },
+      400: { description: "Invalid sitemap request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/gsc/sync",
+    summary: "Queue a GSC sync run",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              days: integerSchema,
+              full: booleanSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "GSC sync run returned." },
+      400: { description: "Invalid GSC sync request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/performance",
+    summary: "Get GSC search performance data",
+    tags: ["google"],
+    parameters: [
+      nameParameter,
+      { name: "startDate", in: "query", description: "Filter by start date.", schema: stringSchema },
+      { name: "endDate", in: "query", description: "Filter by end date.", schema: stringSchema },
+      { name: "query", in: "query", description: "Filter by search query.", schema: stringSchema },
+      { name: "page", in: "query", description: "Filter by page URL.", schema: stringSchema },
+      limitQueryParameter
+    ],
+    responses: {
+      200: { description: "GSC performance rows returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/gsc/inspect",
+    summary: "Inspect a URL through Google Search Console",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["url"],
+            properties: {
+              url: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "GSC inspection result returned." },
+      400: { description: "Invalid inspection request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/inspections",
+    summary: "List GSC URL inspections",
+    tags: ["google"],
+    parameters: [nameParameter, { name: "url", in: "query", description: "Filter by URL.", schema: stringSchema }, limitQueryParameter],
+    responses: {
+      200: { description: "GSC inspections returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/deindexed",
+    summary: "List GSC deindexed pages",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Deindexed pages returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/coverage",
+    summary: "Get GSC coverage summary",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "GSC coverage returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/coverage/history",
+    summary: "Get GSC coverage history",
+    tags: ["google"],
+    parameters: [nameParameter, limitQueryParameter],
+    responses: {
+      200: { description: "GSC coverage history returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/google/gsc/sitemaps",
+    summary: "List GSC sitemaps",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "GSC sitemaps returned." },
+      400: { description: "Invalid sitemap request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/gsc/discover-sitemaps",
+    summary: "Discover sitemaps and queue sitemap inspection",
+    tags: ["google"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Discovered sitemaps and queued run returned." },
+      400: { description: "Invalid sitemap discovery request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/gsc/inspect-sitemap",
+    summary: "Queue a sitemap inspection run",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              sitemapUrl: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Sitemap inspection run returned." },
+      400: { description: "Invalid sitemap inspection request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/google/indexing/request",
+    summary: "Request Google indexing notifications",
+    tags: ["google"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              urls: stringArraySchema,
+              allUnindexed: booleanSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Indexing request results returned." },
+      400: { description: "Invalid indexing request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/bing/connect",
+    summary: "Connect Bing Webmaster Tools",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["apiKey"],
+            properties: {
+              apiKey: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Bing connection returned." },
+      400: { description: "Invalid Bing connection request." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "delete",
+    path: "/api/v1/projects/{name}/bing/disconnect",
+    summary: "Disconnect Bing Webmaster Tools",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    responses: {
+      204: { description: "Bing connection deleted." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/bing/status",
+    summary: "Get Bing connection status",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Bing status returned." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/bing/sites",
+    summary: "List Bing sites for the current connection",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Bing sites returned." },
+      400: { description: "Bing is not configured for this project." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/bing/set-site",
+    summary: "Set the active Bing site",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["siteUrl"],
+            properties: {
+              siteUrl: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Active Bing site updated." },
+      400: { description: "Invalid Bing site request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/bing/coverage",
+    summary: "Get Bing index coverage",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    responses: {
+      200: { description: "Bing coverage returned." },
+      400: { description: "Bing is not configured for this project." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/bing/inspections",
+    summary: "List Bing URL inspections",
+    tags: ["bing"],
+    parameters: [nameParameter, { name: "url", in: "query", description: "Filter by URL.", schema: stringSchema }, limitQueryParameter],
+    responses: {
+      200: { description: "Bing inspections returned." },
+      400: { description: "Bing is not configured for this project." },
+      404: { description: "Project not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/bing/inspect-url",
+    summary: "Inspect a URL through Bing Webmaster Tools",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            required: ["url"],
+            properties: {
+              url: stringSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Bing inspection result returned." },
+      400: { description: "Invalid inspection request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "post",
+    path: "/api/v1/projects/{name}/bing/request-indexing",
+    summary: "Submit URLs to Bing for indexing",
+    tags: ["bing"],
+    parameters: [nameParameter],
+    requestBody: {
+      required: true,
+      content: {
+        "application/json": {
+          schema: {
+            type: "object",
+            properties: {
+              urls: stringArraySchema,
+              allUnindexed: booleanSchema
+            }
+          }
+        }
+      }
+    },
+    responses: {
+      200: { description: "Bing indexing request results returned." },
+      400: { description: "Invalid indexing request." },
+      404: { description: "Project or connection not found." }
+    }
+  },
+  {
+    method: "get",
+    path: "/api/v1/projects/{name}/bing/performance",
+    summary: "Get Bing keyword performance",
+    tags: ["bing"],
+    parameters: [nameParameter, limitQueryParameter],
+    responses: {
+      200: { description: "Bing performance returned." },
+      400: { description: "Bing is not configured for this project." },
+      404: { description: "Project not found." }
+    }
   }
 ];
 function buildOpenApiDocument(info = {}) {
@@ -3688,7 +4558,7 @@ function buildOpenApiDocument(info = {}) {
     info: {
       title: info.title ?? "Canonry API",
       version: info.version ?? "0.0.0",
-      description: info.description ?? "REST API for Canonry projects, runs, schedules, and notifications."
+      description: info.description ?? "REST API for Canonry projects, runs, analytics, integrations, and operator workflows."
     },
     servers: [
       {