@rolino/contracts 0.5.0 → 0.7.0

package/dist/index.js

@@ -1,13 +1,14 @@
 // src/index.ts
 import { z } from "zod";
 var API_VERSION = "v1";
-var CONTRACT_VERSION = "0.16.0";
+var CONTRACT_VERSION = "0.18.0";
 var RequestMetadataSchema = z.object({
   requestId: z.string().min(1)
 });
 var ApiErrorCodeSchema = z.enum([
   "AUTH_REQUIRED",
   "FORBIDDEN",
+  "METHOD_NOT_ALLOWED",
   "NOT_FOUND",
   "FEATURE_DISABLED",
   "BILLING_REQUIRED",
@@ -26,6 +27,9 @@ var ApiProblemSchema = z.object({
   error: z.object({
     code: ApiErrorCodeSchema,
     message: z.string().min(1),
+    // Optional while clients can still communicate with older Rolino deployments.
+    // Current servers include this field on every API problem response.
+    resolution: z.string().min(1).optional(),
     details: z.record(z.string(), z.unknown()).optional()
   }),
   meta: RequestMetadataSchema
@@ -91,20 +95,26 @@ var CapabilityIdSchema = z.enum([
   "integrations:read",
   "calendar:read",
   "seo:read",
+  "backlinks:read",
+  "backlinks:write",
+  "backlinks:contacts",
   "blog:read",
   "blog:write",
   "blog:manage",
   "blog:approve",
   "blog:publish"
 ]);
+var AGENT_CAPABILITIES = CapabilityIdSchema.options;
 var AgentBlogPlanSchema = z.object({
   id: z.string().min(1),
+  version: z.number().int().positive(),
   state: z.string().min(1),
   windowStart: z.string().datetime(),
   windowEnd: z.string().datetime(),
   cadence: z.object({ weekdays: z.array(z.number().int().min(0).max(6)) }),
   activeRevisionId: z.string().nullable(),
-  itemCount: z.number().int().nonnegative()
+  itemCount: z.number().int().nonnegative(),
+  successorState: z.enum(["NOT_STARTED", "GENERATING", "READY", "NEEDS_ATTENTION"]).optional()
 });
 var AgentBlogArticleSchema = z.object({
   id: z.string().min(1),
@@ -115,8 +125,34 @@ var AgentBlogArticleSchema = z.object({
   approvedRevisionId: z.string().nullable(),
   publishedRevisionId: z.string().nullable(),
   scheduledPublishAt: z.string().datetime().nullable(),
-  updatedAt: z.string().datetime()
+  updatedAt: z.string().datetime(),
+  preparationState: z.enum(["PREPARING", "READY_FOR_REVIEW", "SCHEDULED", "MEASURING", "NEEDS_ATTENTION"]).optional(),
+  nextAction: z.enum(["WAIT", "REVIEW_ARTICLE", "OPEN_SCHEDULE", "VIEW_OBSERVATION", "RESOLVE_ISSUE"]).optional()
 });
+var AgentBlogArticleQualitySummarySchema = z.object({
+  version: z.literal(2),
+  decision: z.enum(["READY_FOR_REVIEW", "NEEDS_ATTENTION"]),
+  checks: z.array(z.object({ code: z.enum(["SAFE_MARKDOWN", "REQUIRED_METADATA", "CANONICAL_PATH", "CATALOG_LINKS", "LIVE_LINK_TARGETS", "QUERY_OWNERSHIP", "CONTENT_OVERLAP", "BRAND_TERMS", "EVIDENCE_OWNERSHIP"]), status: z.enum(["PASSED", "FAILED", "WARNING"]), message: z.string().max(240) }).strict()).max(9)
+}).strict();
+var AgentBlogMetricSourceSchema = z.object({
+  provider: z.enum(["GOOGLE_SEARCH_CONSOLE", "GOOGLE_ANALYTICS"]),
+  observedAt: z.string().datetime(),
+  periodStart: z.string().datetime().nullable(),
+  periodEnd: z.string().datetime().nullable(),
+  metrics: z.record(z.string().max(40), z.number().finite()).refine((metrics) => Object.keys(metrics).length <= 20, { message: "Blog metric sources can contain at most 20 metrics." })
+}).strict();
+var AgentBlogPerformanceObservationSchema = z.object({
+  state: z.enum(["WAITING", "MATCHED", "MISSING_MATCH", "MEASURING", "OBSERVED", "PARTIAL", "UNAVAILABLE", "STALE"]),
+  latestCheckpoint: z.enum(["BASELINE", "DAY_28", "DAY_56"]).nullable(),
+  nextCheckpoint: z.enum(["BASELINE", "DAY_28", "DAY_56"]).nullable(),
+  checkpoints: z.array(z.object({
+    checkpoint: z.enum(["BASELINE", "DAY_28", "DAY_56"]),
+    state: z.enum(["WAITING", "MATCHED", "MISSING_MATCH", "MEASURING", "OBSERVED", "PARTIAL", "UNAVAILABLE", "STALE"]),
+    targetDataThrough: z.string().date().nullable(),
+    sources: z.array(AgentBlogMetricSourceSchema).max(2),
+    siteContext: z.array(AgentBlogMetricSourceSchema).max(2)
+  }).strict()).max(3)
+}).strict();
 var AgentBlogImageSchema = z.object({
   id: z.string().min(1),
   revisionId: z.string().nullable(),
@@ -148,8 +184,9 @@ var AgentBlogArticleDetailSchema = AgentBlogArticleSchema.extend({
     callToAction: z.unknown().nullable(),
     internalLinks: z.unknown()
   }).nullable(),
-  revisions: z.array(z.object({ id: z.string().min(1), revisionNumber: z.number().int().positive(), contentHash: z.string().min(1), approvedAt: z.string().datetime().nullable(), createdAt: z.string().datetime() })),
-  images: z.array(AgentBlogImageSchema)
+  revisions: z.array(z.object({ id: z.string().min(1), revisionNumber: z.number().int().positive(), contentHash: z.string().min(1), approvedAt: z.string().datetime().nullable(), createdAt: z.string().datetime(), quality: AgentBlogArticleQualitySummarySchema.nullable().optional() })),
+  images: z.array(AgentBlogImageSchema),
+  measurement: AgentBlogPerformanceObservationSchema.nullable().optional()
 });
 var AgentBlogJobSchema = z.object({
   id: z.string().min(1),
@@ -295,7 +332,7 @@ var AgentBlogScheduleCancelExecuteSchema = AgentBlogScheduleCancelPreviewSchema.
 var AgentBlogPublishPreviewRequestSchema = z.object({ revisionId: z.string().min(1), destinationIds: AgentBlogDestinationSelectionSchema.optional() });
 var AgentBlogPublishExecuteRequestSchema = z.object({ revisionId: z.string().min(1), destinationIds: AgentBlogDestinationSelectionSchema.optional(), confirmationToken: z.string().min(1), idempotencyKey: z.string().trim().min(8).max(200) });
 var AgentBlogPublishingProviderSchema = z.object({ key: z.string(), name: z.string(), description: z.string(), mode: z.string(), rollout: z.enum(["PREVIEW", "VISIBLE"]), capabilities: z.array(z.string()), authorizationStrategy: z.string(), requiresResourceDiscovery: z.boolean(), requiresFieldMapping: z.boolean(), officialDocumentationUrl: z.string().url() }).strict();
-var AgentBlogPublishingDestinationSchema = z.object({ id: z.string(), name: z.string(), providerKey: z.string(), mode: z.string(), status: z.string(), isPrimary: z.boolean(), enabled: z.boolean(), externalSiteName: z.string().nullable(), externalSiteUrl: z.string().url().nullable(), lastTestedAt: z.string().datetime().nullable(), lastSucceededAt: z.string().datetime().nullable(), lastErrorCode: z.string().nullable() }).strict();
+var AgentBlogPublishingDestinationSchema = z.object({ id: z.string(), name: z.string(), providerKey: z.string(), mode: z.string(), status: z.string(), isPrimary: z.boolean(), enabled: z.boolean(), capabilities: z.array(z.string()), externalSiteName: z.string().nullable(), externalSiteUrl: z.string().url().nullable(), lastTestedAt: z.string().datetime().nullable(), lastSucceededAt: z.string().datetime().nullable(), lastErrorCode: z.string().nullable() }).strict();
 var AgentBlogDeliveryAttemptSchema = z.object({ id: z.string(), articleId: z.string().nullable(), revisionId: z.string().nullable(), destinationId: z.string().nullable(), destinationName: z.string().nullable(), operation: z.string().nullable(), state: z.string(), attemptCount: z.number().int().nonnegative(), errorCode: z.string().nullable(), retryAt: z.string().datetime().nullable(), remoteUrl: z.string().url().nullable(), createdAt: z.string().datetime(), deliveredAt: z.string().datetime().nullable() }).strict();
 var AgentBlogPublishPreviewSchema = z.object({ articleId: z.string(), revisionId: z.string(), contentHash: z.string(), approvalBundleHash: z.string().regex(/^[a-f0-9]{64}$/), approvalSource: z.enum(["USER", "AGENT"]).nullable(), title: z.string(), slug: z.string(), publicUrl: z.string().url(), destinations: z.array(AgentBlogPublishingDestinationSchema), confirmation: z.object({ token: z.string(), expiresAt: z.string().datetime() }) });
 var AgentBlogReadinessSchema = z.enum([
@@ -345,6 +382,75 @@ var AgentBlogCadenceInputSchema = z.object({
 var AgentBlogIdempotentRequestSchema = z.object({
   idempotencyKey: z.string().trim().min(8).max(200)
 }).strict();
+var AgentBlogPublicationWeekdaysSchema = z.array(z.number().int().min(0).max(6)).min(1).max(7).superRefine((weekdays, context) => {
+  if (new Set(weekdays).size !== weekdays.length) {
+    context.addIssue({ code: "custom", message: "Weekdays must be unique." });
+  }
+});
+var AgentBlogEditorialDateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+var AgentBlogPlanItemStateSchema = z.enum([
+  "PLANNED",
+  "ACCEPTED",
+  "DISMISSED",
+  "DRAFTING",
+  "IN_REVIEW",
+  "APPROVED",
+  "SCHEDULED",
+  "PUBLISHED",
+  "NEEDS_ATTENTION"
+]);
+var AgentBlogScheduleDigestSchema = z.string().regex(/^[a-f0-9]{64}$/);
+var AgentBlogPlanDateMoveSchema = z.object({
+  itemId: z.string().min(1),
+  title: z.string().min(1).max(200),
+  oldDate: AgentBlogEditorialDateSchema,
+  newDate: AgentBlogEditorialDateSchema,
+  state: AgentBlogPlanItemStateSchema,
+  version: z.number().int().positive()
+}).strict();
+var AgentBlogPlanLockedItemSchema = z.object({
+  itemId: z.string().min(1),
+  title: z.string().min(1).max(200),
+  date: AgentBlogEditorialDateSchema,
+  state: z.enum(["SCHEDULED", "PUBLISHED"]),
+  version: z.number().int().positive()
+}).strict();
+var AgentBlogPlanCadencePreviewRequestSchema = z.object({
+  weekdays: AgentBlogPublicationWeekdaysSchema,
+  expectedPlanVersion: z.number().int().positive()
+}).strict();
+var AgentBlogPlanCadencePreviewSchema = z.object({
+  planId: z.string().min(1),
+  planTitle: z.string().min(1).max(200),
+  planVersion: z.number().int().positive(),
+  scheduleDigest: AgentBlogScheduleDigestSchema,
+  kind: z.enum(["ready", "blocked", "noop"]),
+  canExecute: z.boolean(),
+  oldWeekdays: AgentBlogPublicationWeekdaysSchema,
+  newWeekdays: AgentBlogPublicationWeekdaysSchema,
+  moves: z.array(AgentBlogPlanDateMoveSchema).max(30),
+  lockedItems: z.array(AgentBlogPlanLockedItemSchema).max(30),
+  warnings: z.array(z.string().min(1).max(500)).max(30),
+  reason: z.string().min(1).max(500).nullable(),
+  confirmation: z.object({ token: z.string().min(1), expiresAt: z.string().datetime() }).strict().nullable()
+}).strict();
+var AgentBlogPlanCadenceExecuteRequestSchema = z.object({
+  weekdays: AgentBlogPublicationWeekdaysSchema,
+  expectedPlanVersion: z.number().int().positive(),
+  expectedScheduleDigest: AgentBlogScheduleDigestSchema,
+  confirmationToken: z.string().min(1),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogPlanCadenceExecuteSchema = z.object({
+  planId: z.string().min(1),
+  planVersion: z.number().int().positive(),
+  publicationWeekdays: AgentBlogPublicationWeekdaysSchema,
+  cadencePerWeek: z.number().int().min(1).max(7),
+  expectedItemCount: z.number().int().nonnegative().max(30),
+  moves: z.array(AgentBlogPlanDateMoveSchema).max(30),
+  lockedItems: z.array(AgentBlogPlanLockedItemSchema).max(30),
+  scheduleDigest: AgentBlogScheduleDigestSchema
+}).strict();
 var AgentBlogPlanCreateRequestSchema = AgentBlogCadenceInputSchema.and(AgentBlogIdempotentRequestSchema);
 var AgentBlogPlanRetryRequestSchema = AgentBlogIdempotentRequestSchema;
 var AgentBlogPlanItemSchema = z.object({
@@ -370,7 +476,9 @@ var AgentBlogPlanItemSchema = z.object({
   existingArticleComparison: z.string().nullable(),
   recommendedLinks: z.unknown(),
   targetConversionPage: z.string().nullable(),
-  articleId: z.string().min(1).nullable()
+  articleId: z.string().min(1).nullable(),
+  preparationState: z.enum(["PREPARING", "READY_FOR_REVIEW", "SCHEDULED", "MEASURING", "NEEDS_ATTENTION"]).optional(),
+  nextAction: z.enum(["WAIT", "REVIEW_ARTICLE", "OPEN_SCHEDULE", "VIEW_OBSERVATION", "RESOLVE_ISSUE"]).optional()
 }).strict();
 var AgentBlogPlanItemStateRequestSchema = z.object({
   state: z.enum(["ACCEPTED", "DISMISSED"]),
@@ -428,6 +536,67 @@ var AgentBlogConnectionExecuteSchema = z.object({
   webhookSecret: z.string().min(1).optional(),
   message: z.string().min(1)
 }).strict();
+var AgentBlogWebhookSemanticsSchema = z.enum(["DRAFT", "LIVE"]);
+var AgentBlogWebhookDestinationChangeSchema = z.object({
+  destinationId: z.string().min(1).optional(),
+  siteId: z.string().min(1),
+  name: z.string().trim().min(1).max(160),
+  endpoint: z.string().url(),
+  semantics: AgentBlogWebhookSemanticsSchema
+}).strict();
+var AgentBlogWebhookDestinationPreviewRequestSchema = AgentBlogWebhookDestinationChangeSchema;
+var AgentBlogWebhookDestinationExecuteRequestSchema = AgentBlogWebhookDestinationChangeSchema.extend({
+  confirmationToken: z.string().min(1).max(300),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogWebhookDestinationPreviewSchema = AgentBlogWebhookDestinationChangeSchema.extend({
+  destinationId: z.string().min(1).nullable(),
+  effect: z.string().min(1),
+  confirmation: z.object({ token: z.string().min(1), expiresAt: z.string().datetime() }).strict()
+}).strict();
+var AgentBlogWebhookDestinationExecuteSchema = z.object({
+  projectId: z.string().min(1),
+  siteId: z.string().min(1),
+  destinationId: z.string().min(1),
+  completed: z.literal(true),
+  secretDelivered: z.boolean(),
+  alreadyDelivered: z.boolean(),
+  webhookSecret: z.string().min(1).optional(),
+  message: z.string().min(1)
+}).strict();
+var AgentBlogWebhookTestRequestSchema = z.object({
+  siteId: z.string().min(1),
+  destinationId: z.string().min(1),
+  makePrimary: z.boolean().optional()
+}).strict();
+var AgentBlogWebhookTestSchema = z.object({
+  destinationId: z.string().min(1),
+  status: z.enum(["CONNECTED", "NEEDS_ATTENTION"]),
+  enabled: z.boolean(),
+  testedAt: z.string().datetime(),
+  errorCode: z.string().nullable()
+}).strict();
+var AgentBlogWebhookRotatePreviewRequestSchema = z.object({
+  siteId: z.string().min(1),
+  destinationId: z.string().min(1)
+}).strict();
+var AgentBlogWebhookRotateExecuteRequestSchema = AgentBlogWebhookRotatePreviewRequestSchema.extend({
+  confirmationToken: z.string().min(1).max(300),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogWebhookRotatePreviewSchema = AgentBlogWebhookRotatePreviewRequestSchema.extend({
+  destinationName: z.string().min(1),
+  effect: z.string().min(1),
+  confirmation: z.object({ token: z.string().min(1), expiresAt: z.string().datetime() }).strict()
+}).strict();
+var AgentBlogWebhookRotateExecuteSchema = z.object({
+  destinationId: z.string().min(1),
+  completed: z.literal(true),
+  secretDelivered: z.boolean(),
+  alreadyDelivered: z.boolean(),
+  webhookSecret: z.string().min(1).optional(),
+  message: z.string().min(1)
+}).strict();
 var AgentBlogRevalidationTestRequestSchema = AgentBlogIdempotentRequestSchema;
 var AgentBlogRevalidationTestSchema = z.object({
   status: z.enum(["VERIFIED", "NEEDS_ATTENTION"]),
@@ -461,6 +630,8 @@ var AgentBlogDeliveryAttemptListResponseSchema = successEnvelopeSchema(z.object(
 var AgentBlogSetupStatusResponseSchema = successEnvelopeSchema(AgentBlogSetupStatusSchema);
 var AgentBlogPlanItemsResponseSchema = successEnvelopeSchema(z.object({ items: z.array(AgentBlogPlanItemSchema) }).strict());
 var AgentBlogPlanItemResponseSchema = successEnvelopeSchema(AgentBlogPlanItemSchema);
+var AgentBlogPlanCadencePreviewResponseSchema = successEnvelopeSchema(AgentBlogPlanCadencePreviewSchema);
+var AgentBlogPlanCadenceExecuteResponseSchema = successEnvelopeSchema(AgentBlogPlanCadenceExecuteSchema);
 var AgentBlogPlanQueuedResponseSchema = successEnvelopeSchema(z.object({
   planId: z.string().min(1),
   job: AgentBlogJobSchema
@@ -473,6 +644,11 @@ var AgentBlogConnectionStatusResponseSchema = successEnvelopeSchema(AgentBlogCon
 var AgentBlogConnectionPreviewResponseSchema = successEnvelopeSchema(AgentBlogConnectionPreviewSchema);
 var AgentBlogConnectionExecuteResponseSchema = successEnvelopeSchema(AgentBlogConnectionExecuteSchema);
 var AgentBlogRevalidationTestResponseSchema = successEnvelopeSchema(AgentBlogRevalidationTestSchema);
+var AgentBlogWebhookDestinationPreviewResponseSchema = successEnvelopeSchema(AgentBlogWebhookDestinationPreviewSchema);
+var AgentBlogWebhookDestinationExecuteResponseSchema = successEnvelopeSchema(AgentBlogWebhookDestinationExecuteSchema);
+var AgentBlogWebhookTestResponseSchema = successEnvelopeSchema(AgentBlogWebhookTestSchema);
+var AgentBlogWebhookRotatePreviewResponseSchema = successEnvelopeSchema(AgentBlogWebhookRotatePreviewSchema);
+var AgentBlogWebhookRotateExecuteResponseSchema = successEnvelopeSchema(AgentBlogWebhookRotateExecuteSchema);
 var CapabilitySchema = z.object({
   id: CapabilityIdSchema,
   available: z.boolean(),
@@ -502,7 +678,7 @@ var ApiMetaSchema = z.object({
   capabilities: z.array(CapabilitySchema)
 });
 var ApiMetaResponseSchema = successEnvelopeSchema(ApiMetaSchema);
-var AuthenticationKindSchema = z.enum(["session", "api_key"]);
+var AuthenticationKindSchema = z.enum(["session", "api_key", "oauth"]);
 var ActorSchema = z.object({
   user: z.object({
     id: z.string().min(1),
@@ -521,31 +697,6 @@ var ActorSchema = z.object({
   capabilities: z.array(CapabilityIdSchema)
 });
 var WhoAmIResponseSchema = successEnvelopeSchema(ActorSchema);
-var Base64UrlSecretSchema = z.string().min(43).max(128).regex(/^[A-Za-z0-9_-]+$/);
-var CLI_BROWSER_AUTHORIZATION_TIMEOUT_MS = 5 * 60 * 1e3;
-var CliAuthorizationExchangeRequestSchema = z.object({
-  code: Base64UrlSecretSchema,
-  codeVerifier: Base64UrlSecretSchema
-});
-var CliAuthorizationCredentialSchema = z.object({
-  token: z.string().min(1),
-  tokenType: z.literal("Bearer"),
-  expiresAt: z.string().datetime(),
-  organization: z.object({
-    id: z.string().min(1),
-    name: z.string().min(1)
-  }),
-  capabilities: z.array(CapabilityIdSchema)
-});
-var CliAuthorizationExchangeResponseSchema = successEnvelopeSchema(
-  CliAuthorizationCredentialSchema
-);
-var CliAuthorizationRevokeDataSchema = z.object({
-  revoked: z.literal(true)
-});
-var CliAuthorizationRevokeResponseSchema = successEnvelopeSchema(
-  CliAuthorizationRevokeDataSchema
-);
 var CapabilitiesDataSchema = z.object({
   capabilities: z.array(CapabilitySchema)
 });
@@ -682,7 +833,8 @@ var PublishingProviderSchema = z.enum([
   "TIKTOK",
   "YOUTUBE",
   "BLUESKY",
-  "LINKEDIN"
+  "LINKEDIN",
+  "GOOGLE_BUSINESS_PROFILE"
 ]);
 var PUBLISHING_PROVIDER_COUNT = PublishingProviderSchema.options.length;
 var PostDeliveryModeSchema = z.enum(["IMMEDIATE", "SCHEDULED"]);
@@ -882,7 +1034,8 @@ var DraftCaptionOverridesObjectSchema = z.object({
   TIKTOK: z.string().max(2200).nullable().optional(),
   YOUTUBE: YouTubeDescriptionSchema.nullable().optional(),
   BLUESKY: BlueskyCaptionSchema.nullable().optional(),
-  LINKEDIN: z.string().max(3e3).nullable().optional()
+  LINKEDIN: z.string().max(3e3).nullable().optional(),
+  GOOGLE_BUSINESS_PROFILE: z.string().max(1500).nullable().optional()
 }).strict();
 var DraftPlatformsSchema = z.array(PublishingProviderSchema).max(PUBLISHING_PROVIDER_COUNT).refine(
   (providers) => new Set(providers).size === providers.length,
@@ -1559,7 +1712,97 @@ var SeoReportListResponseSchema = successEnvelopeSchema(
   SeoReportListDataSchema
 );
 var SeoReportResponseSchema = successEnvelopeSchema(SeoReportSchema);
+var BacklinkOpportunityTypeSchema = z.enum(["TOOL_ROUNDUP", "COMPARISON", "RESOURCE_PAGE", "RELEVANT_ARTICLE"]);
+var BacklinkProspectStageSchema = z.enum(["NEW", "APPROVED", "CONTACT_RESEARCHING", "REVIEW_OUTREACH", "READY_TO_CONTACT", "CONTACTED", "REPLIED", "LINK_WON", "REJECTED", "NO_CONTACT", "DECLINED"]);
+var BacklinkNextActionSchema = z.enum(["REVIEW", "FIND_CONTACT", "VIEW_PROGRESS", "REVIEW_OUTREACH", "COPY_OUTREACH", "RETRY_CONTACT", "OPEN"]);
+var BacklinkContactStateSchema = z.enum(["PUBLIC_CONFIRMED", "GENERIC_PUBLIC", "NOT_FOUND", "STALE"]);
+var BacklinkVerificationStateSchema = z.enum(["QUEUED", "CHECKING", "VERIFIED", "MISSING", "BLOCKED", "FAILED"]);
+var BacklinkScoreReasonSchema = z.object({ score: z.number().int().min(0).max(100), reason: z.string().min(1).max(500) }).strict();
+var BacklinkScoreComponentsSchema = z.object({
+  topicalRelevance: BacklinkScoreReasonSchema,
+  editorialFit: BacklinkScoreReasonSchema,
+  pageFreshness: BacklinkScoreReasonSchema,
+  siteLegitimacy: BacklinkScoreReasonSchema,
+  outreachFeasibility: BacklinkScoreReasonSchema.optional(),
+  publisherType: z.enum([
+    "INDEPENDENT_PUBLISHER",
+    "PROFESSIONAL_ORGANIZATION",
+    "EDUCATIONAL_ORGANIZATION",
+    "AGENCY_OR_ECOSYSTEM",
+    "REVIEW_OR_DIRECTORY",
+    "PRODUCT_VENDOR",
+    "MARKETPLACE",
+    "COMMUNITY",
+    "OWNED",
+    "UNKNOWN"
+  ]).optional(),
+  difficulty: z.enum(["EASY", "MEDIUM", "HARD"]).optional(),
+  productClaimsToVerify: z.array(z.string().min(1).max(300)).max(10).optional()
+}).strict();
+var BacklinkProspectSchema = z.object({
+  id: SeoEntityIdSchema,
+  projectId: SeoEntityIdSchema,
+  url: z.string().url().max(2048),
+  domain: z.string().min(1).max(253),
+  title: z.string().min(1).max(300),
+  opportunityType: BacklinkOpportunityTypeSchema,
+  stage: BacklinkProspectStageSchema,
+  version: z.number().int().positive(),
+  nextAction: BacklinkNextActionSchema,
+  score: z.number().int().min(0).max(100),
+  scoreComponents: BacklinkScoreComponentsSchema,
+  evidenceExcerpt: z.string().min(1).max(2e3),
+  evidenceSourceUrl: z.string().url().max(2048),
+  suggestedTargetUrl: z.string().url().max(2048),
+  placementAngle: z.string().min(1).max(1e3),
+  contactState: BacklinkContactStateSchema,
+  lastCheckedAt: z.string().datetime(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime()
+}).strict();
+var BacklinkProspectListQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(50).default(20),
+  cursor: SeoCursorSchema.optional(),
+  stage: BacklinkProspectStageSchema.optional(),
+  opportunityType: BacklinkOpportunityTypeSchema.optional()
+}).strict();
+var BacklinkProspectListDataSchema = z.object({
+  items: z.array(BacklinkProspectSchema).max(50),
+  page: z.object({ limit: z.number().int().min(1).max(50), nextCursor: SeoCursorSchema.nullable() }).strict()
+}).strict();
+var BacklinkProspectListResponseSchema = successEnvelopeSchema(BacklinkProspectListDataSchema);
+var BacklinkProspectResponseSchema = successEnvelopeSchema(BacklinkProspectSchema);
+var BacklinkTargetInputSchema = z.object({ url: z.string().url().max(2048), label: z.string().trim().min(1).max(120), topicSummary: z.string().trim().min(1).max(500).optional() }).strict();
+var BacklinkDiscoveryInputSchema = z.object({ limit: z.number().int().min(1).max(20).default(20) }).strict();
+var BacklinkStageUpdateInputSchema = z.object({ stage: BacklinkProspectStageSchema, expectedVersion: z.number().int().positive() }).strict();
+var BacklinkVerificationInputSchema = z.object({ url: z.string().url().max(2048), expectedVersion: z.number().int().positive() }).strict();
+var BacklinkOutreachUpdateInputSchema = z.object({ expectedVersion: z.number().int().positive(), subject: z.string().trim().min(1).max(200), body: z.string().trim().min(1).max(3e3) }).strict();
+var BacklinkTargetSchema = z.object({ id: SeoEntityIdSchema, projectId: SeoEntityIdSchema, normalizedUrl: z.string().url().max(2048), label: z.string().min(1).max(120), topicSummary: z.string().max(500).nullable(), enabled: z.boolean(), createdAt: z.string().datetime(), updatedAt: z.string().datetime() }).strict();
+var BacklinkTargetListResponseSchema = successEnvelopeSchema(z.array(BacklinkTargetSchema).max(10));
+var BacklinkTargetResponseSchema = successEnvelopeSchema(BacklinkTargetSchema);
+var BacklinkDiscoveryRunSchema = z.object({ id: SeoEntityIdSchema, projectId: SeoEntityIdSchema, status: z.enum(["QUEUED", "RUNNING", "SUCCEEDED", "PARTIAL", "FAILED", "CANCELLED"]), promptVersion: z.number().int().positive(), configurationVersion: z.number().int().positive(), searchedCount: z.number().int().nonnegative(), fetchedCount: z.number().int().nonnegative(), savedCount: z.number().int().nonnegative(), failedCount: z.number().int().nonnegative(), safeErrorCode: z.string().max(100).nullable(), createdAt: z.string().datetime(), updatedAt: z.string().datetime() }).strict();
+var BacklinkDiscoveryRunResponseSchema = successEnvelopeSchema(BacklinkDiscoveryRunSchema);
+var BacklinkQueueResponseSchema = successEnvelopeSchema(z.object({ prospectId: SeoEntityIdSchema, status: z.literal("QUEUED") }).strict());
+var BacklinkVerificationSchema = z.object({ id: SeoEntityIdSchema, prospectId: SeoEntityIdSchema, state: BacklinkVerificationStateSchema, submittedUrl: z.string().url(), expectedTargetUrl: z.string().url() }).strict();
+var BacklinkVerificationResponseSchema = successEnvelopeSchema(BacklinkVerificationSchema);
+var BacklinkOutreachDraftSchema = z.object({ id: SeoEntityIdSchema, prospectId: SeoEntityIdSchema, version: z.number().int().positive(), subject: z.string().max(200), body: z.string().max(3e3) }).strict();
+var BacklinkOutreachDraftResponseSchema = successEnvelopeSchema(BacklinkOutreachDraftSchema);
+var BacklinkContactSchema = z.object({
+  prospectId: SeoEntityIdSchema,
+  name: z.string().max(160).nullable(),
+  role: z.string().max(120).nullable(),
+  email: z.string().email().max(320),
+  evidenceState: BacklinkContactStateSchema.exclude(["NOT_FOUND"]),
+  sourceUrl: z.string().url().max(2048),
+  evidenceExcerpt: z.string().min(1).max(1e3),
+  checkedAt: z.string().datetime(),
+  draft: z.object({ version: z.number().int().positive(), subject: z.string().max(200), body: z.string().max(3e3) }).strict().nullable()
+}).strict();
+var BacklinkContactListDataSchema = z.object({ items: z.array(BacklinkContactSchema).max(50), page: z.object({ limit: z.number().int().min(1).max(50), nextCursor: SeoCursorSchema.nullable() }).strict() }).strict();
+var BacklinkContactListQuerySchema = z.object({ limit: z.coerce.number().int().min(1).max(50).default(20), cursor: SeoCursorSchema.optional() }).strict();
+var BacklinkContactListResponseSchema = successEnvelopeSchema(BacklinkContactListDataSchema);
 export {
+  AGENT_CAPABILITIES,
   API_VERSION,
   ActorSchema,
   AgentBlogApprovalExecuteRequestSchema,
@@ -1573,6 +1816,7 @@ export {
   AgentBlogArticleCreateRequestSchema,
   AgentBlogArticleDetailSchema,
   AgentBlogArticleListResponseSchema,
+  AgentBlogArticleQualitySummarySchema,
   AgentBlogArticleQueuedResponseSchema,
   AgentBlogArticleResponseSchema,
   AgentBlogArticleSchema,
@@ -1602,12 +1846,22 @@ export {
   AgentBlogImageUploadPrepareRequestSchema,
   AgentBlogJobResponseSchema,
   AgentBlogJobSchema,
+  AgentBlogMetricSourceSchema,
+  AgentBlogPerformanceObservationSchema,
+  AgentBlogPlanCadenceExecuteRequestSchema,
+  AgentBlogPlanCadenceExecuteResponseSchema,
+  AgentBlogPlanCadenceExecuteSchema,
+  AgentBlogPlanCadencePreviewRequestSchema,
+  AgentBlogPlanCadencePreviewResponseSchema,
+  AgentBlogPlanCadencePreviewSchema,
   AgentBlogPlanCreateRequestSchema,
+  AgentBlogPlanDateMoveSchema,
   AgentBlogPlanItemResponseSchema,
   AgentBlogPlanItemSchema,
   AgentBlogPlanItemStateRequestSchema,
   AgentBlogPlanItemsResponseSchema,
   AgentBlogPlanListResponseSchema,
+  AgentBlogPlanLockedItemSchema,
   AgentBlogPlanQueuedResponseSchema,
   AgentBlogPlanRetryRequestSchema,
   AgentBlogPlanSchema,
@@ -1637,17 +1891,63 @@ export {
   AgentBlogSchedulePreviewSchema,
   AgentBlogSetupStatusResponseSchema,
   AgentBlogSetupStatusSchema,
+  AgentBlogWebhookDestinationChangeSchema,
+  AgentBlogWebhookDestinationExecuteRequestSchema,
+  AgentBlogWebhookDestinationExecuteResponseSchema,
+  AgentBlogWebhookDestinationExecuteSchema,
+  AgentBlogWebhookDestinationPreviewRequestSchema,
+  AgentBlogWebhookDestinationPreviewResponseSchema,
+  AgentBlogWebhookDestinationPreviewSchema,
+  AgentBlogWebhookRotateExecuteRequestSchema,
+  AgentBlogWebhookRotateExecuteResponseSchema,
+  AgentBlogWebhookRotateExecuteSchema,
+  AgentBlogWebhookRotatePreviewRequestSchema,
+  AgentBlogWebhookRotatePreviewResponseSchema,
+  AgentBlogWebhookRotatePreviewSchema,
+  AgentBlogWebhookSemanticsSchema,
+  AgentBlogWebhookTestRequestSchema,
+  AgentBlogWebhookTestResponseSchema,
+  AgentBlogWebhookTestSchema,
   ApiErrorCodeSchema,
   ApiMetaResponseSchema,
   ApiMetaSchema,
   ApiProblemSchema,
   AuthenticationKindSchema,
+  BacklinkContactListDataSchema,
+  BacklinkContactListQuerySchema,
+  BacklinkContactListResponseSchema,
+  BacklinkContactSchema,
+  BacklinkContactStateSchema,
+  BacklinkDiscoveryInputSchema,
+  BacklinkDiscoveryRunResponseSchema,
+  BacklinkDiscoveryRunSchema,
+  BacklinkNextActionSchema,
+  BacklinkOpportunityTypeSchema,
+  BacklinkOutreachDraftResponseSchema,
+  BacklinkOutreachDraftSchema,
+  BacklinkOutreachUpdateInputSchema,
+  BacklinkProspectListDataSchema,
+  BacklinkProspectListQuerySchema,
+  BacklinkProspectListResponseSchema,
+  BacklinkProspectResponseSchema,
+  BacklinkProspectSchema,
+  BacklinkProspectStageSchema,
+  BacklinkQueueResponseSchema,
+  BacklinkScoreComponentsSchema,
+  BacklinkStageUpdateInputSchema,
+  BacklinkTargetInputSchema,
+  BacklinkTargetListResponseSchema,
+  BacklinkTargetResponseSchema,
+  BacklinkTargetSchema,
+  BacklinkVerificationInputSchema,
+  BacklinkVerificationResponseSchema,
+  BacklinkVerificationSchema,
+  BacklinkVerificationStateSchema,
   BlogArticleListSchema,
   BlogImageSchema,
   BlogMetadataSchema,
   BlogSitemapEntrySchema,
   BlogSlugRedirectSchema,
-  CLI_BROWSER_AUTHORIZATION_TIMEOUT_MS,
   CONTRACT_VERSION,
   CalendarEventSchema,
   CalendarListDataSchema,
@@ -1657,11 +1957,6 @@ export {
   CapabilitiesResponseSchema,
   CapabilityIdSchema,
   CapabilitySchema,
-  CliAuthorizationCredentialSchema,
-  CliAuthorizationExchangeRequestSchema,
-  CliAuthorizationExchangeResponseSchema,
-  CliAuthorizationRevokeDataSchema,
-  CliAuthorizationRevokeResponseSchema,
   DraftPostInputSchema,
   DraftPostUpdateInputSchema,
   IntegrationConnectionStatusSchema,