@rolino/contracts 0.3.0 → 0.5.0-beta.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import { z } from "zod";
 var API_VERSION = "v1";
-var CONTRACT_VERSION = "0.14.0";
+var CONTRACT_VERSION = "0.16.0";
 var RequestMetadataSchema = z.object({
   requestId: z.string().min(1)
 });
@@ -15,6 +15,11 @@ var ApiErrorCodeSchema = z.enum([
   "VALIDATION_ERROR",
   "CONFLICT",
   "RATE_LIMITED",
+  "DELIVERY_CREDENTIAL_INVALID",
+  "DELIVERY_CREDENTIAL_REVOKED",
+  "ARTICLE_NOT_PUBLISHED",
+  "WEBHOOK_INVALID",
+  "WEBHOOK_REPLAYED",
   "INTERNAL_ERROR"
 ]);
 var ApiProblemSchema = z.object({
@@ -25,6 +30,50 @@ var ApiProblemSchema = z.object({
   }),
   meta: RequestMetadataSchema
 });
+var BlogImageSchema = z.object({
+  url: z.string().url(),
+  altText: z.string().min(1),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  purpose: z.enum(["FEATURED", "SECTION", "SOCIAL_PREVIEW"])
+});
+var PublishedBlogArticleSchema = z.object({
+  id: z.string().min(1),
+  revisionId: z.string().min(1),
+  revisionNumber: z.number().int().positive(),
+  slug: z.string().min(1),
+  title: z.string().min(1),
+  description: z.string().nullable(),
+  excerpt: z.string().nullable(),
+  tags: z.array(z.string()),
+  author: z.string().min(1),
+  language: z.string().min(1),
+  markdown: z.string(),
+  contentBlocks: z.array(z.unknown()),
+  canonicalPath: z.string().startsWith("/"),
+  publicUrl: z.string().url(),
+  publishedAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+  images: z.array(BlogImageSchema)
+});
+var BlogArticleListSchema = z.object({
+  articles: z.array(PublishedBlogArticleSchema.omit({ markdown: true, contentBlocks: true }))
+});
+var BlogMetadataSchema = z.object({
+  siteId: z.string().min(1),
+  name: z.string().min(1),
+  origin: z.string().url(),
+  blogBasePath: z.string().startsWith("/"),
+  language: z.string().min(1),
+  updatedAt: z.string().datetime().nullable()
+});
+var BlogSitemapEntrySchema = z.object({
+  url: z.string().url(),
+  lastModified: z.string().datetime()
+});
+var BlogSlugRedirectSchema = z.object({
+  redirect: z.object({ from: z.string().min(1), to: z.string().min(1), permanent: z.literal(true) })
+});
 function successEnvelopeSchema(data) {
   return z.object({
     data,
@@ -40,8 +89,245 @@ var CapabilityIdSchema = z.enum([
   "posts:schedule",
   "posts:publish",
   "integrations:read",
-  "calendar:read"
+  "calendar:read",
+  "seo:read",
+  "blog:read",
+  "blog:write",
+  "blog:manage",
+  "blog:publish"
 ]);
+var AgentBlogPlanSchema = z.object({
+  id: z.string().min(1),
+  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()
+});
+var AgentBlogArticleSchema = z.object({
+  id: z.string().min(1),
+  state: z.string().min(1),
+  title: z.string().min(1),
+  slug: z.string().min(1),
+  currentDraftId: z.string().nullable(),
+  approvedRevisionId: z.string().nullable(),
+  publishedRevisionId: z.string().nullable(),
+  scheduledPublishAt: z.string().datetime().nullable(),
+  updatedAt: z.string().datetime()
+});
+var AgentBlogArticleDetailSchema = AgentBlogArticleSchema.extend({
+  draft: z.object({
+    id: z.string().min(1),
+    version: z.number().int().positive(),
+    title: z.string(),
+    slug: z.string(),
+    description: z.string().nullable(),
+    excerpt: z.string().nullable(),
+    canonicalPath: z.string(),
+    tags: z.array(z.string()),
+    author: z.string(),
+    language: z.string(),
+    markdown: z.string(),
+    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() }))
+});
+var AgentBlogJobSchema = z.object({
+  id: z.string().min(1),
+  type: z.string().min(1),
+  state: z.string().min(1),
+  attemptCount: z.number().int().nonnegative(),
+  availableAt: z.string().datetime(),
+  startedAt: z.string().datetime().nullable(),
+  completedAt: z.string().datetime().nullable(),
+  lastErrorCode: z.string().nullable(),
+  lastErrorMessage: z.string().nullable()
+});
+var AgentBlogDraftUpdateSchema = z.object({
+  version: z.number().int().positive(),
+  title: z.string().trim().min(1).max(200),
+  slug: z.string().trim().min(1).max(160),
+  description: z.string().trim().max(320).nullable(),
+  excerpt: z.string().trim().max(500).nullable(),
+  canonicalPath: z.string().startsWith("/"),
+  tags: z.array(z.string().trim().min(1).max(80)).max(30),
+  author: z.string().trim().min(1).max(160),
+  language: z.string().trim().min(2).max(20),
+  markdown: z.string().max(2e5),
+  callToAction: z.object({ label: z.string().trim().min(1).max(160), pageId: z.string().min(1).nullable() }).strict().nullable(),
+  internalLinks: z.array(z.object({ pageId: z.string().min(1), anchorText: z.string().trim().min(1).max(200) }).strict()).max(20),
+  scheduledPublishAt: z.string().datetime().nullable().optional()
+});
+var AgentBlogGenerateRequestSchema = z.object({ idempotencyKey: z.string().trim().min(8).max(200) });
+var AgentBlogDestinationSelectionSchema = z.array(z.string().min(1)).min(1).max(20);
+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 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(), 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([
+  "MISSING",
+  "NOT_STARTED",
+  "QUEUED",
+  "RUNNING",
+  "READY",
+  "USED",
+  "CONFIGURED",
+  "VERIFIED",
+  "NEEDS_ATTENTION"
+]);
+var AgentBlogSetupStatusSchema = z.object({
+  projectId: z.string().min(1),
+  brandName: z.string().min(1),
+  brandWebsite: z.enum(["MISSING", "READY"]),
+  websiteOrigin: z.string().url().nullable(),
+  siteId: z.string().min(1).nullable(),
+  blogBasePath: z.string().startsWith("/").nullable(),
+  siteImport: AgentBlogReadinessSchema,
+  activeJobId: z.string().min(1).nullable(),
+  plan: AgentBlogReadinessSchema,
+  activePlanId: z.string().min(1).nullable(),
+  deliveryCredential: AgentBlogReadinessSchema,
+  revalidation: AgentBlogReadinessSchema,
+  nextAction: z.enum([
+    "ADD_WEBSITE",
+    "IMPORT_SITE",
+    "WAIT_FOR_JOB",
+    "CREATE_PLAN",
+    "REVIEW_PLAN",
+    "CONFIGURE_DELIVERY",
+    "TEST_CONNECTION",
+    "READY"
+  ])
+}).strict();
+var AgentBlogCadenceInputSchema = z.object({
+  startsOn: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  weekdays: z.array(z.number().int().min(0).max(6)).min(1).max(7),
+  timeZone: z.string().trim().min(1).max(100)
+}).strict().superRefine(({ weekdays }, context) => {
+  if (new Set(weekdays).size !== weekdays.length) {
+    context.addIssue({ code: "custom", path: ["weekdays"], message: "Weekdays must be unique." });
+  }
+});
+var AgentBlogIdempotentRequestSchema = z.object({
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogPlanCreateRequestSchema = AgentBlogCadenceInputSchema.and(AgentBlogIdempotentRequestSchema);
+var AgentBlogPlanRetryRequestSchema = AgentBlogIdempotentRequestSchema;
+var AgentBlogPlanItemSchema = z.object({
+  id: z.string().min(1),
+  planId: z.string().min(1),
+  planRevisionId: z.string().min(1),
+  version: z.number().int().positive(),
+  scheduledLocalDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  title: z.string().min(1),
+  recommendedSlug: z.string().min(1),
+  state: z.string().min(1),
+  workType: z.string().min(1),
+  format: z.string().min(1),
+  primaryQuery: z.string().nullable(),
+  searchIntent: z.string().nullable(),
+  summary: z.string(),
+  outline: z.unknown(),
+  selectionReason: z.string().min(1),
+  evidenceClassification: z.enum(["OBSERVED", "MIXED", "HYPOTHESIS"]),
+  evidence: z.unknown(),
+  displayMetrics: z.unknown(),
+  overlapExplanation: z.string().nullable(),
+  existingArticleComparison: z.string().nullable(),
+  recommendedLinks: z.unknown(),
+  targetConversionPage: z.string().nullable(),
+  articleId: z.string().min(1).nullable()
+}).strict();
+var AgentBlogPlanItemStateRequestSchema = z.object({
+  state: z.enum(["ACCEPTED", "DISMISSED"]),
+  expectedState: z.string().min(1),
+  expectedVersion: z.number().int().positive(),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogArticleCreateRequestSchema = z.object({
+  expectedState: z.literal("ACCEPTED"),
+  expectedVersion: z.number().int().positive(),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogConnectionStatusSchema = z.object({
+  projectId: z.string().min(1),
+  siteId: z.string().min(1),
+  origin: z.string().url(),
+  endpoint: z.string().url().nullable(),
+  deliveryCredential: z.enum(["MISSING", "READY", "USED"]),
+  activeCredentialId: z.string().min(1).nullable(),
+  credentialLastUsedAt: z.string().datetime().nullable(),
+  revalidation: z.enum(["MISSING", "CONFIGURED", "VERIFIED", "NEEDS_ATTENTION"]),
+  revalidationLastTestedAt: z.string().datetime().nullable(),
+  revalidationLastSucceededAt: z.string().datetime().nullable(),
+  revalidationLastErrorCode: z.string().nullable()
+}).strict();
+var AgentBlogConnectionRequestSchema = z.object({
+  endpoint: z.string().url().nullable(),
+  credentialAction: z.enum(["KEEP", "CREATE", "ROTATE", "REVOKE"]),
+  credentialId: z.string().min(1).nullable(),
+  secretAction: z.enum(["KEEP", "CREATE", "ROTATE"])
+}).strict();
+var AgentBlogConnectionPreviewRequestSchema = AgentBlogConnectionRequestSchema;
+var AgentBlogConnectionExecuteRequestSchema = AgentBlogConnectionRequestSchema.extend({
+  confirmationToken: z.string().min(1).max(300),
+  idempotencyKey: z.string().trim().min(8).max(200)
+}).strict();
+var AgentBlogConnectionPreviewSchema = z.object({
+  projectId: z.string().min(1),
+  siteId: z.string().min(1),
+  siteName: z.string().min(1),
+  origin: z.string().url(),
+  endpoint: z.string().url().nullable(),
+  credentialAction: z.enum(["KEEP", "CREATE", "ROTATE", "REVOKE"]),
+  secretAction: z.enum(["KEEP", "CREATE", "ROTATE"]),
+  effect: z.string().min(1),
+  confirmation: z.object({ token: z.string().min(1), expiresAt: z.string().datetime() }).strict()
+}).strict();
+var AgentBlogConnectionExecuteSchema = z.object({
+  projectId: z.string().min(1),
+  siteId: z.string().min(1),
+  completed: z.literal(true),
+  secretDelivered: z.boolean(),
+  alreadyDelivered: z.boolean(),
+  deliveryToken: z.string().min(1).optional(),
+  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"]),
+  testedAt: z.string().datetime(),
+  errorCode: z.string().nullable()
+}).strict();
+var AgentBlogPlanListResponseSchema = successEnvelopeSchema(z.object({ plans: z.array(AgentBlogPlanSchema) }));
+var AgentBlogArticleListResponseSchema = successEnvelopeSchema(z.object({ articles: z.array(AgentBlogArticleSchema) }));
+var AgentBlogArticleResponseSchema = successEnvelopeSchema(AgentBlogArticleDetailSchema);
+var AgentBlogJobResponseSchema = successEnvelopeSchema(AgentBlogJobSchema);
+var AgentBlogPublishPreviewResponseSchema = successEnvelopeSchema(AgentBlogPublishPreviewSchema);
+var AgentBlogPublishExecuteResponseSchema = successEnvelopeSchema(z.object({ publicationId: z.string(), articleId: z.string(), revisionId: z.string(), publicUrl: z.string().url(), publishedAt: z.string().datetime() }));
+var AgentBlogPublishingProviderListResponseSchema = successEnvelopeSchema(z.object({ providers: z.array(AgentBlogPublishingProviderSchema) }).strict());
+var AgentBlogPublishingDestinationListResponseSchema = successEnvelopeSchema(z.object({ destinations: z.array(AgentBlogPublishingDestinationSchema) }).strict());
+var AgentBlogDeliveryAttemptListResponseSchema = successEnvelopeSchema(z.object({ deliveries: z.array(AgentBlogDeliveryAttemptSchema) }).strict());
+var AgentBlogSetupStatusResponseSchema = successEnvelopeSchema(AgentBlogSetupStatusSchema);
+var AgentBlogPlanItemsResponseSchema = successEnvelopeSchema(z.object({ items: z.array(AgentBlogPlanItemSchema) }).strict());
+var AgentBlogPlanItemResponseSchema = successEnvelopeSchema(AgentBlogPlanItemSchema);
+var AgentBlogPlanQueuedResponseSchema = successEnvelopeSchema(z.object({
+  planId: z.string().min(1),
+  job: AgentBlogJobSchema
+}).strict());
+var AgentBlogArticleQueuedResponseSchema = successEnvelopeSchema(z.object({
+  articleId: z.string().min(1),
+  job: AgentBlogJobSchema.nullable()
+}).strict());
+var AgentBlogConnectionStatusResponseSchema = successEnvelopeSchema(AgentBlogConnectionStatusSchema);
+var AgentBlogConnectionPreviewResponseSchema = successEnvelopeSchema(AgentBlogConnectionPreviewSchema);
+var AgentBlogConnectionExecuteResponseSchema = successEnvelopeSchema(AgentBlogConnectionExecuteSchema);
+var AgentBlogRevalidationTestResponseSchema = successEnvelopeSchema(AgentBlogRevalidationTestSchema);
 var CapabilitySchema = z.object({
   id: CapabilityIdSchema,
   available: z.boolean(),
@@ -254,9 +540,24 @@ var PublishingProviderSchema = z.enum([
   "LINKEDIN"
 ]);
 var PUBLISHING_PROVIDER_COUNT = PublishingProviderSchema.options.length;
+var PostDeliveryModeSchema = z.enum(["IMMEDIATE", "SCHEDULED"]);
+var PostDestinationStageSchema = z.enum([
+  "DRAFT",
+  "QUEUED",
+  "UPLOADING",
+  "PROCESSING",
+  "CONFIRMING_SCHEDULE",
+  "SCHEDULED",
+  "PUBLISHING",
+  "PUBLISHED",
+  "ACTION_REQUIRED",
+  "FAILED"
+]);
 var PostDestinationSchema = z.object({
   provider: PublishingProviderSchema,
   status: PlatformPostStatusSchema,
+  deliveryMode: PostDeliveryModeSchema,
+  stage: PostDestinationStageSchema,
   captionOverride: z.string().nullable(),
   scheduledAt: z.string().datetime().nullable(),
   publishedAt: z.string().datetime().nullable(),
@@ -603,13 +904,21 @@ var LinkedInDeliveryOptionsSchema = z.object({
     displayName: z.string().nullable(),
     avatarUrl: z.string().url().nullable()
   }),
-  supportedPostTypes: z.array(z.enum(["TEXT", "SINGLE_IMAGE", "MULTI_IMAGE"])).length(3),
+  supportedPostTypes: z.array(z.enum(["TEXT", "SINGLE_IMAGE", "MULTI_IMAGE", "VIDEO"])).length(4),
   image: z.object({
     maxItems: z.literal(10),
     mimeTypes: z.tuple([z.literal("image/jpeg"), z.literal("image/png")]),
     maxPixelsExclusive: z.literal(36152320),
     maxBytes: z.literal(26214400)
   }),
+  video: z.object({
+    maxItems: z.literal(1),
+    mimeTypes: z.tuple([z.literal("video/mp4")]),
+    minBytes: z.literal(76800),
+    maxBytes: z.literal(524288e3),
+    minDurationMs: z.literal(3e3),
+    maxDurationMs: z.literal(18e5)
+  }),
   health: z.object({
     status: ProviderHealthStatusSchema,
     code: z.string().min(1),
@@ -635,11 +944,13 @@ var ReadinessActionSchema = z.object({
   kind: z.enum([
     "reconnect",
     "replace_media",
+    "adjust_media",
     "review_settings",
     "edit_caption",
     "refresh_health"
   ]),
-  provider: PublishingProviderSchema.optional()
+  provider: PublishingProviderSchema.optional(),
+  mediaId: z.string().min(1).optional()
 });
 var PostReadinessCheckSchema = z.object({
   key: z.string().min(1),
@@ -697,6 +1008,7 @@ var PostScheduleExecuteInputSchema = PostScheduleInputSchema.extend({
 }).strict();
 var PostSchedulePreviewSchema = z.object({
   operation: z.literal("posts.schedule.execute"),
+  deliveryMode: z.literal("SCHEDULED"),
   post: z.object({
     id: z.string().min(1),
     projectId: z.string().min(1),
@@ -705,6 +1017,12 @@ var PostSchedulePreviewSchema = z.object({
   }),
   schedule: PostScheduleInputSchema,
   destinations: z.array(PublishingProviderSchema).min(1).max(PUBLISHING_PROVIDER_COUNT),
+  youtube: z.object({
+    uploadVisibility: z.literal("PRIVATE"),
+    publishVisibility: z.literal("PUBLIC"),
+    preparationStartsImmediately: z.literal(true),
+    confirmationMeaning: z.string().min(1)
+  }).nullable().optional(),
   providerReconciliation: z.object({
     provider: z.literal("YOUTUBE"),
     required: z.boolean(),
@@ -725,6 +1043,8 @@ var PostSchedulePendingSchema = z.object({
   provider: z.literal("YOUTUBE"),
   mutationId: z.string().min(1),
   operation: z.enum(["SCHEDULE", "CANCEL"]),
+  phase: z.literal("REMOTE_SCHEDULE_CONFIRMATION"),
+  videoUploaded: z.literal(true),
   message: z.string().min(1)
 });
 var PostScheduleExecuteResultSchema = z.union([
@@ -745,6 +1065,7 @@ var PostPublishExecuteInputSchema = PostPublishInputSchema.extend({
 }).strict();
 var PostPublishPreviewSchema = z.object({
   operation: z.literal("posts.publish.execute"),
+  deliveryMode: z.literal("IMMEDIATE"),
   post: z.object({
     id: z.string().min(1),
     projectId: z.string().min(1),
@@ -752,6 +1073,11 @@ var PostPublishPreviewSchema = z.object({
     status: PostStatusSchema
   }),
   destinations: PostPublishInputSchema.shape.destinations,
+  youtube: z.object({
+    visibility: YouTubePostSettingsSchema.shape.privacyStatus,
+    preparationStartsImmediately: z.literal(true),
+    createsSchedule: z.literal(false)
+  }).nullable().optional(),
   readiness: PostReadinessSchema,
   confirmation: z.object({
     token: z.string().min(1),
@@ -824,14 +1150,330 @@ var CalendarListDataSchema = z.object({
 var CalendarListResponseSchema = successEnvelopeSchema(
   CalendarListDataSchema
 );
+var SeoEntityIdSchema = z.string().min(1).max(128).regex(/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/);
+var SeoCursorSchema = z.string().min(1).max(512).regex(/^[A-Za-z0-9_-]+$/);
+var SeoOpportunityKindSchema = z.enum([
+  "SEARCH_TOPIC_CTR",
+  "SEARCH_TOPIC_REFRESH",
+  "SEARCH_TOPIC_NEW_ARTICLE",
+  "SEARCH_TOPIC_CONSOLIDATE",
+  "SEARCH_TOPIC_CLUSTER",
+  "COMPETITOR_KEYWORD_GAP",
+  "COMPETITOR_RANK_GAIN",
+  "COMPETITOR_RANK_DROP",
+  "COMPETITOR_SHARED_GAP",
+  "SEO_VALIDATED_COMPETITOR_GAP"
+]);
+var SeoExpectedImpactSchema = z.enum(["HIGH", "MEDIUM", "LOW"]);
+var SeoEvidenceProvenanceSchema = z.enum([
+  "CUSTOMER_SEARCH_DATA",
+  "MARKET_ESTIMATE",
+  "ROLINO_ANALYSIS"
+]);
+var SeoEvidenceSchema = z.object({
+  title: z.string().min(1).max(180),
+  summary: z.string().min(1).max(500),
+  sourceUrl: z.string().url().max(2048).nullable(),
+  provenance: SeoEvidenceProvenanceSchema,
+  observedAt: z.string().datetime(),
+  periodStart: z.string().datetime().nullable(),
+  periodEnd: z.string().datetime().nullable(),
+  metrics: z.record(
+    z.string().regex(/^[A-Za-z][A-Za-z0-9]{0,39}$/),
+    z.number().finite()
+  ).refine((metrics) => Object.keys(metrics).length <= 20, {
+    message: "SEO evidence can contain at most 20 metrics."
+  }),
+  estimated: z.boolean(),
+  topRowsOnly: z.boolean(),
+  coverageNote: z.string().max(500).nullable()
+}).strict();
+var SeoActionDecisionSchema = z.enum(["READY", "NEEDS_REVIEW", "REJECTED"]);
+var SeoSearchIntentSchema = z.enum(["INFORMATIONAL", "COMMERCIAL", "NAVIGATIONAL", "BRANDED", "SUSPICIOUS"]);
+var SeoContentTypeSchema = z.enum(["GUIDE", "TUTORIAL", "COMPARISON_PAGE", "LANDING_PAGE", "CONTENT_REFRESH"]);
+var SeoActionPlanSchema = z.object({
+  version: z.number().int().positive(),
+  decision: SeoActionDecisionSchema,
+  decisionReason: z.string().min(1).max(500),
+  searchIntent: SeoSearchIntentSchema,
+  primaryKeyword: z.string().min(1).max(300),
+  supportingKeywords: z.array(z.string().min(1).max(300)).max(12),
+  questions: z.array(z.string().min(1).max(300)).max(8),
+  contentType: SeoContentTypeSchema,
+  suggestedTitle: z.string().min(1).max(180),
+  angle: z.string().max(500),
+  targetReader: z.string().min(1).max(500),
+  pageGoal: z.string().max(500),
+  outline: z.array(z.object({
+    heading: z.string().min(1).max(180),
+    purpose: z.string().min(1).max(500)
+  }).strict()).max(10),
+  rolinoConnection: z.string().max(600),
+  cta: z.string().max(300),
+  competitorPages: z.array(z.object({
+    domain: z.string().min(1).max(253),
+    url: z.string().url().nullable(),
+    keyword: z.string().min(1).max(300),
+    rank: z.number().min(1).max(1e3).nullable()
+  }).strict()).max(8),
+  existingPage: z.object({
+    title: z.string().min(1).max(180),
+    url: z.string().url()
+  }).strict().nullable(),
+  warnings: z.array(z.string().min(1).max(500)).max(8),
+  researchTasks: z.array(z.string().min(1).max(500)).max(8),
+  cluster: z.object({
+    competitorDomains: z.array(z.string().min(1).max(253)).max(3),
+    bestRank: z.number().min(1).max(1e3).nullable(),
+    estimatedDemand: z.number().min(0).nullable(),
+    firstPartyValidated: z.boolean(),
+    relevanceScore: z.number().min(0).max(1),
+    coverage: z.string().max(500)
+  }).strict()
+}).strict();
+var SeoTaskDecisionSchema = z.enum(["READY", "NEEDS_REVIEW", "REJECTED"]);
+var SeoTaskFormatSchema = z.enum([
+  "BLOG_ARTICLE",
+  "PRODUCT_LANDING_PAGE",
+  "COMPARISON_PAGE",
+  "EXISTING_PAGE_REFRESH",
+  "YOUTUBE_PRODUCTION_PACKAGE",
+  "SOCIAL_CAMPAIGN",
+  "LINK_OUTREACH_TASK",
+  "RESEARCH_TASK"
+]);
+var SeoConfidenceValueSchema = z.object({
+  score: z.number().int().min(0).max(100).nullable(),
+  level: z.enum(["HIGH", "MEDIUM", "LOW", "UNCONFIRMED"]),
+  label: z.string().min(1).max(120),
+  explanation: z.string().min(1).max(500)
+}).strict();
+var SeoDecisionConfidenceSchema = z.object({
+  topicRelevance: SeoConfidenceValueSchema,
+  actionReadiness: SeoConfidenceValueSchema
+}).strict();
+var SeoTaskEvidenceSummarySchema = z.object({
+  title: z.string().min(1).max(180),
+  summary: z.string().min(1).max(500),
+  provenance: SeoEvidenceProvenanceSchema,
+  observedAt: z.string().datetime(),
+  sourceUrl: z.string().url().max(2048).nullable()
+}).strict();
+var SeoAgentTaskSchema = z.object({
+  schemaVersion: z.number().int().positive(),
+  projectId: SeoEntityIdSchema.nullable(),
+  opportunityId: SeoEntityIdSchema.nullable(),
+  legacy: z.boolean(),
+  legacyLabel: z.string().max(500).nullable(),
+  decision: SeoTaskDecisionSchema,
+  decisionReason: z.string().min(1).max(700),
+  objective: z.string().min(1).max(700),
+  primaryFormat: SeoTaskFormatSchema,
+  supportingFormats: z.array(SeoTaskFormatSchema).max(4),
+  formatOptions: z.array(SeoTaskFormatSchema.exclude(["RESEARCH_TASK"])).max(7),
+  confidence: SeoDecisionConfidenceSchema,
+  target: z.object({
+    primaryKeyword: z.string().min(1).max(300),
+    supportingKeywords: z.array(z.string().min(1).max(300)).max(12),
+    searchIntent: SeoSearchIntentSchema,
+    audience: z.string().min(1).max(500),
+    angle: z.string().max(600)
+  }).strict(),
+  suggestedTitles: z.array(z.string().min(1).max(180)).max(3),
+  outline: z.array(z.object({
+    heading: z.string().min(1).max(180),
+    purpose: z.string().min(1).max(600)
+  }).strict()).max(12),
+  researchTasks: z.array(z.string().min(1).max(600)).max(10),
+  competitorPagesToInspect: z.array(z.object({
+    domain: z.string().min(1).max(253),
+    url: z.string().url().max(2048).nullable(),
+    keyword: z.string().min(1).max(300),
+    rank: z.number().int().min(1).max(1e3).nullable()
+  }).strict()).max(8),
+  productFactsToVerify: z.array(z.string().min(1).max(600)).max(8),
+  claimsNotToInvent: z.array(z.string().min(1).max(600)).max(8),
+  deliverables: z.array(z.object({
+    name: z.string().min(1).max(180),
+    requirements: z.array(z.string().min(1).max(600)).min(1).max(8)
+  }).strict()).min(1).max(12),
+  callToAction: z.string().max(400),
+  destination: z.string().min(1).max(700),
+  successMetric: z.object({
+    name: z.string().min(1).max(180),
+    target: z.string().min(1).max(600),
+    measurementWindow: z.string().min(1).max(300)
+  }).strict(),
+  evidenceSummary: z.array(SeoTaskEvidenceSummarySchema).max(5),
+  limitations: z.array(z.string().min(1).max(600)).max(10),
+  nextStep: z.string().min(1).max(700),
+  youtubePackageRequirements: z.object({
+    subject: z.string().min(1).max(300),
+    targetViewer: z.string().min(1).max(500),
+    objective: z.string().min(1).max(700),
+    titleOptions: z.number().int().min(1).max(10),
+    hook: z.string().min(1).max(600),
+    draftScript: z.string().min(1).max(600),
+    sceneList: z.string().min(1).max(600),
+    onScreenText: z.string().min(1).max(600),
+    thumbnailConcept: z.string().min(1).max(600),
+    thumbnailText: z.string().min(1).max(300),
+    description: z.string().min(1).max(600),
+    chapters: z.string().min(1).max(600),
+    callToAction: z.string().max(400),
+    supportingSocialPosts: z.number().int().min(0).max(10)
+  }).strict().nullable(),
+  imageBriefs: z.array(z.object({
+    concept: z.string().min(1).max(600),
+    brief: z.string().min(1).max(800),
+    altText: z.string().min(1).max(500),
+    prompt: z.string().min(1).max(1e3)
+  }).strict()).max(4)
+}).strict();
+var SeoOpportunityBriefSchema = z.object({
+  kind: SeoOpportunityKindSchema,
+  title: z.string().min(1).max(180),
+  summary: z.string().min(1).max(600),
+  score: z.number().int().min(0).max(100),
+  confidence: SeoDecisionConfidenceSchema,
+  expectedImpact: SeoExpectedImpactSchema,
+  recommendedAction: z.string().min(1).max(300),
+  actionPlan: SeoActionPlanSchema,
+  task: SeoAgentTaskSchema,
+  evidence: z.array(SeoEvidenceSchema).max(5),
+  brief: z.string().min(1).max(12e3)
+}).strict();
+var SeoOpportunitySchema = SeoOpportunityBriefSchema.extend({
+  id: SeoEntityIdSchema,
+  projectId: SeoEntityIdSchema,
+  lastDetectedAt: z.string().datetime(),
+  stale: z.boolean()
+}).strict();
+var SeoOpportunityListQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(50).default(20),
+  cursor: SeoCursorSchema.optional(),
+  kind: SeoOpportunityKindSchema.optional(),
+  expectedImpact: SeoExpectedImpactSchema.optional()
+}).strict();
+var SeoPageSchema = z.object({
+  limit: z.number().int().min(1).max(50),
+  nextCursor: SeoCursorSchema.nullable()
+}).strict();
+var SeoOpportunityListDataSchema = z.object({
+  items: z.array(SeoOpportunitySchema).max(50),
+  page: SeoPageSchema
+}).strict();
+var SeoOpportunityListResponseSchema = successEnvelopeSchema(
+  SeoOpportunityListDataSchema
+);
+var SeoOpportunityResponseSchema = successEnvelopeSchema(
+  SeoOpportunitySchema
+);
+var SeoReportCompletenessSchema = z.enum(["COMPLETE", "PARTIAL"]);
+var SeoReportTriggerSchema = z.enum(["SCHEDULED", "MANUAL"]);
+var SeoReportSummarySchema = z.object({
+  id: SeoEntityIdSchema,
+  projectId: SeoEntityIdSchema,
+  periodStart: z.string().datetime(),
+  periodEnd: z.string().datetime(),
+  timeZone: z.string().min(1).max(100),
+  deliveryDay: z.number().int().min(1).max(7),
+  completeness: SeoReportCompletenessSchema,
+  trigger: SeoReportTriggerSchema,
+  createdAt: z.string().datetime(),
+  opportunityCount: z.number().int().min(0).max(5),
+  readyTaskCount: z.number().int().min(0).max(5),
+  researchTaskCount: z.number().int().min(0).max(5),
+  rejectedFindingCount: z.number().int().min(0).max(20),
+  legacy: z.boolean()
+}).strict();
+var SeoReportSchema = SeoReportSummarySchema.extend({
+  generatedAt: z.string().datetime(),
+  partialLabel: z.string().max(500).nullable(),
+  freshThrough: z.string().datetime().nullable(),
+  opportunities: z.array(SeoOpportunityBriefSchema).max(5),
+  rejectedFindings: z.array(z.object({
+    decision: z.literal("REJECTED"),
+    query: z.string().min(1).max(300),
+    reason: z.string().min(1).max(700),
+    observedAt: z.string().datetime()
+  }).strict()).max(20)
+}).strict();
+var SeoReportListQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(26).default(10),
+  cursor: SeoCursorSchema.optional(),
+  completeness: SeoReportCompletenessSchema.optional()
+}).strict();
+var SeoReportListDataSchema = z.object({
+  items: z.array(SeoReportSummarySchema).max(26),
+  page: SeoPageSchema.extend({
+    limit: z.number().int().min(1).max(26)
+  }).strict()
+}).strict();
+var SeoReportListResponseSchema = successEnvelopeSchema(
+  SeoReportListDataSchema
+);
+var SeoReportResponseSchema = successEnvelopeSchema(SeoReportSchema);
 export {
   API_VERSION,
   ActorSchema,
+  AgentBlogArticleCreateRequestSchema,
+  AgentBlogArticleDetailSchema,
+  AgentBlogArticleListResponseSchema,
+  AgentBlogArticleQueuedResponseSchema,
+  AgentBlogArticleResponseSchema,
+  AgentBlogArticleSchema,
+  AgentBlogCadenceInputSchema,
+  AgentBlogConnectionExecuteRequestSchema,
+  AgentBlogConnectionExecuteResponseSchema,
+  AgentBlogConnectionExecuteSchema,
+  AgentBlogConnectionPreviewRequestSchema,
+  AgentBlogConnectionPreviewResponseSchema,
+  AgentBlogConnectionPreviewSchema,
+  AgentBlogConnectionRequestSchema,
+  AgentBlogConnectionStatusResponseSchema,
+  AgentBlogConnectionStatusSchema,
+  AgentBlogDeliveryAttemptListResponseSchema,
+  AgentBlogDeliveryAttemptSchema,
+  AgentBlogDestinationSelectionSchema,
+  AgentBlogDraftUpdateSchema,
+  AgentBlogGenerateRequestSchema,
+  AgentBlogIdempotentRequestSchema,
+  AgentBlogJobResponseSchema,
+  AgentBlogJobSchema,
+  AgentBlogPlanCreateRequestSchema,
+  AgentBlogPlanItemResponseSchema,
+  AgentBlogPlanItemSchema,
+  AgentBlogPlanItemStateRequestSchema,
+  AgentBlogPlanItemsResponseSchema,
+  AgentBlogPlanListResponseSchema,
+  AgentBlogPlanQueuedResponseSchema,
+  AgentBlogPlanRetryRequestSchema,
+  AgentBlogPlanSchema,
+  AgentBlogPublishExecuteRequestSchema,
+  AgentBlogPublishExecuteResponseSchema,
+  AgentBlogPublishPreviewRequestSchema,
+  AgentBlogPublishPreviewResponseSchema,
+  AgentBlogPublishPreviewSchema,
+  AgentBlogPublishingDestinationListResponseSchema,
+  AgentBlogPublishingDestinationSchema,
+  AgentBlogPublishingProviderListResponseSchema,
+  AgentBlogPublishingProviderSchema,
+  AgentBlogRevalidationTestRequestSchema,
+  AgentBlogRevalidationTestResponseSchema,
+  AgentBlogRevalidationTestSchema,
+  AgentBlogSetupStatusResponseSchema,
+  AgentBlogSetupStatusSchema,
   ApiErrorCodeSchema,
   ApiMetaResponseSchema,
   ApiMetaSchema,
   ApiProblemSchema,
   AuthenticationKindSchema,
+  BlogArticleListSchema,
+  BlogImageSchema,
+  BlogMetadataSchema,
+  BlogSitemapEntrySchema,
+  BlogSlugRedirectSchema,
   CLI_BROWSER_AUTHORIZATION_TIMEOUT_MS,
   CONTRACT_VERSION,
   CalendarEventSchema,
@@ -865,7 +1507,9 @@ export {
   MediaAssetUploadPreparationSchema,
   PUBLISHING_PROVIDER_COUNT,
   PlatformPostStatusSchema,
+  PostDeliveryModeSchema,
   PostDestinationSchema,
+  PostDestinationStageSchema,
   PostListDataSchema,
   PostListQuerySchema,
   PostListResponseSchema,
@@ -899,10 +1543,40 @@ export {
   ProviderDeliveryOptionsResponseSchema,
   ProviderDeliveryOptionsSchema,
   ProviderHealthStatusSchema,
+  PublishedBlogArticleSchema,
   PublishingProviderSchema,
   ReadinessActionSchema,
   ReadinessStatusSchema,
   RequestMetadataSchema,
+  SeoActionDecisionSchema,
+  SeoActionPlanSchema,
+  SeoAgentTaskSchema,
+  SeoConfidenceValueSchema,
+  SeoContentTypeSchema,
+  SeoCursorSchema,
+  SeoDecisionConfidenceSchema,
+  SeoEntityIdSchema,
+  SeoEvidenceProvenanceSchema,
+  SeoEvidenceSchema,
+  SeoExpectedImpactSchema,
+  SeoOpportunityBriefSchema,
+  SeoOpportunityKindSchema,
+  SeoOpportunityListDataSchema,
+  SeoOpportunityListQuerySchema,
+  SeoOpportunityListResponseSchema,
+  SeoOpportunityResponseSchema,
+  SeoOpportunitySchema,
+  SeoReportCompletenessSchema,
+  SeoReportListDataSchema,
+  SeoReportListQuerySchema,
+  SeoReportListResponseSchema,
+  SeoReportResponseSchema,
+  SeoReportSchema,
+  SeoReportSummarySchema,
+  SeoReportTriggerSchema,
+  SeoSearchIntentSchema,
+  SeoTaskDecisionSchema,
+  SeoTaskFormatSchema,
   TikTokDeliveryOptionsSchema,
   TikTokDraftSettingsSchema,
   TikTokPostSettingsSchema,