@rolino/contracts 0.6.0 → 0.7.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import { z } from "zod";
 var API_VERSION = "v1";
-var CONTRACT_VERSION = "0.17.0";
+var CONTRACT_VERSION = "0.18.0";
 var RequestMetadataSchema = z.object({
   requestId: z.string().min(1)
 });
@@ -95,12 +95,16 @@ 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(),
@@ -109,7 +113,8 @@ var AgentBlogPlanSchema = z.object({
   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),
@@ -120,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(),
@@ -153,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),
@@ -444,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"]),
@@ -1678,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,
@@ -1692,6 +1816,7 @@ export {
   AgentBlogArticleCreateRequestSchema,
   AgentBlogArticleDetailSchema,
   AgentBlogArticleListResponseSchema,
+  AgentBlogArticleQualitySummarySchema,
   AgentBlogArticleQueuedResponseSchema,
   AgentBlogArticleResponseSchema,
   AgentBlogArticleSchema,
@@ -1721,6 +1846,8 @@ export {
   AgentBlogImageUploadPrepareRequestSchema,
   AgentBlogJobResponseSchema,
   AgentBlogJobSchema,
+  AgentBlogMetricSourceSchema,
+  AgentBlogPerformanceObservationSchema,
   AgentBlogPlanCadenceExecuteRequestSchema,
   AgentBlogPlanCadenceExecuteResponseSchema,
   AgentBlogPlanCadenceExecuteSchema,
@@ -1786,6 +1913,36 @@ export {
   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,