@sonordev/site-kit 8.3.0 → 8.4.0

package/dist/layout/client.js

@@ -1,8 +1,8 @@
 'use client';
-export { SiteKitClientProviders } from '../chunk-QDILCQBL.js';
+export { SiteKitClientProviders } from '../chunk-KASKB7UK.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-U7Y3QG3A.js';
-import '../chunk-LPKKSYKX.js';
+import '../chunk-MZX4EN6Z.js';
+import '../chunk-5TDZHIG6.js';
 import '../chunk-ZTZQPYP6.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-FESKKJAS.js';
@@ -10,11 +10,11 @@ import '../chunk-A4CC4ZG3.js';
 import '../chunk-ZKADJNR2.js';
 import '../chunk-5TM3WPCI.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-JO76F5WP.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
-import '../chunk-QCZHYO5M.js';
+import '../chunk-5S7YTOCB.js';
+import '../chunk-4HYIDQJJ.js';
 import '../chunk-PKBMQBKP.js';

package/dist/layout/index.js

@@ -1,11 +1,11 @@
-import { SiteKitClientProviders } from '../chunk-QDILCQBL.js';
+import { SiteKitClientProviders } from '../chunk-KASKB7UK.js';
 import '../chunk-6G43IRWR.js';
-import '../chunk-U7Y3QG3A.js';
-import '../chunk-LPKKSYKX.js';
+import '../chunk-MZX4EN6Z.js';
+import '../chunk-5TDZHIG6.js';
 import '../chunk-ZTZQPYP6.js';
 import { ManagedFavicon } from '../chunk-GW7GSBO7.js';
 import '../chunk-YC7ELZS3.js';
-import { resolveClientCredential } from '../chunk-WSOZ3FQN.js';
+import { resolveClientCredential } from '../chunk-LPVEBQVL.js';
 import '../chunk-UAYAJPEP.js';
 import { ManagedScripts } from '../chunk-MVLMXC44.js';
 import { resolveApiOrigin } from '../chunk-C7TLGL3R.js';
@@ -15,13 +15,13 @@ import '../chunk-A4CC4ZG3.js';
 import '../chunk-ZKADJNR2.js';
 import '../chunk-5TM3WPCI.js';
 import '../chunk-GJWI74ZZ.js';
-import '../chunk-JO76F5WP.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
-import '../chunk-QCZHYO5M.js';
+import '../chunk-5S7YTOCB.js';
+import '../chunk-4HYIDQJJ.js';
 import '../chunk-PKBMQBKP.js';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/dist/llms/index.js

@@ -1,10 +1,10 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-2JMCBJM5.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-DS6LECIX.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-FHUTOXS7.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-XENW66OF.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
 import '../chunk-XTRZGXB2.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-D6ZIQMHB.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-CE7VPAEH.js';
 export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-XA7Q2VQA.js';
 import '../chunk-5D7ZISUP.js';
 import '../chunk-4K735O3J.js';
@@ -16,5 +16,5 @@ import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/maps/index.js

@@ -1,9 +1,9 @@
 'use client';
 import { monotonicMs } from '../chunk-MH2DSGC6.js';
-import { sonorFetch } from '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import { sonorFetch } from '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import { getClientApiConfig } from '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';
 import { useState, useCallback, useEffect } from 'react';
 import { APIProvider, Map as Map$1, AdvancedMarker, Pin, InfoWindow } from '@vis.gl/react-google-maps';

package/dist/mcp/sonor.d.ts

@@ -41,6 +41,7 @@
 import 'server-only';
 import { type McpServerDefinition } from './protocol';
 import type { McpServerInfo, SiteKitMcpTool } from './types';
+import { type PublicationRoutingOptions } from '../articles/routes';
 export { reportToolCallsToSonor } from './report';
 export type { ReportToolCallsOptions } from './report';
 /** The public fields article tools read. Readers can come from Press Kit or a site's own CMS. */
@@ -49,6 +50,8 @@ export interface McpArticle {
     title: string;
     excerpt?: string;
     content?: string;
+    content_html?: string;
+    canonical_url?: string;
     author?: unknown;
     category?: unknown;
     published_at?: string;
@@ -131,6 +134,7 @@ export interface SonorMcpOptions {
      * Omitting both readers retains the 8.x legacy adapter. false drops article tools. Default '/blog'. */
     articles?: ({
         path?: string;
+        routing?: PublicationRoutingOptions;
     } & Partial<McpArticleReaders>) | false;
     /** `false` drops get_reviews (a site with no reviews in Sonor). */
     reviews?: boolean;

package/dist/mcp/sonor.js

@@ -1,9 +1,9 @@
 import { fetchReviews, fetchReviewStats } from '../chunk-BSQP6PRA.js';
 import { toolErrorResult } from '../chunk-FYAB6CXS.js';
-import { fetchBookingTypes, fetchAvailability } from '../chunk-WBUG7XRL.js';
+import { fetchBookingTypes, fetchAvailability } from '../chunk-S6QDNXDK.js';
 import { getLLMsData, getServices, getFAQItems, getPageSummaries } from '../chunk-XA7Q2VQA.js';
-import { getFormConfig } from '../chunk-NA4Z4CQG.js';
-import '../chunk-5RYSTKVU.js';
+import { getFormConfig } from '../chunk-YM5KMNTU.js';
+import '../chunk-LEGMPX6N.js';
 import '../chunk-C2FZBUSS.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-LNSF6BJC.js';
@@ -12,6 +12,7 @@ import '../chunk-TYAVHRWH.js';
 import '../chunk-5SQK3D53.js';
 import '../chunk-HW7B43E5.js';
 import '../chunk-NJCTQH2P.js';
+import { resolveArticleUrl } from '../chunk-4K735O3J.js';
 import { resolveFetch } from '../chunk-UAYAJPEP.js';
 import '../chunk-NZ4RXN3G.js';
 import '../chunk-MJP63SSS.js';
@@ -19,10 +20,10 @@ import { resolveServerApiConfig } from '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import { resolveSiteHost } from '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import '../chunk-W7OPEMGJ.js';
-import { SITE_KIT_VERSION } from '../chunk-C2UROFGZ.js';
+import { SITE_KIT_VERSION } from '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';
 import 'server-only';
 import { after } from 'next/server.js';
@@ -197,24 +198,36 @@ function findPages(ctx) {
     }
   };
 }
+function articleUrl(ctx, basePath, post) {
+  const articles = ctx.options.articles;
+  return resolveArticleUrl({ slug: post.slug, canonical_url: post.canonical_url, category: post.category }, {
+    ...articles && articles.routing,
+    basePath,
+    siteUrl: (linkTo(ctx, "/") || "").replace(/\/$/, "")
+  });
+}
 function listArticles(ctx, basePath, readers) {
   return {
     name: "list_articles",
     title: "List articles",
     description: `${ctx.options.businessName}'s published articles, newest first, optionally matching a topic. Call get_article for the full text.`,
-    inputSchema: { type: "object", properties: { query: QUERY, limit: LIMIT }, additionalProperties: false },
+    inputSchema: { type: "object", properties: { query: QUERY, limit: LIMIT, offset: { type: "integer", minimum: 0, description: "Start at this result offset when browsing the archive." } }, additionalProperties: false },
     annotations: READ,
     handler: async (args) => {
-      const posts = await readers.readMany({ maxPosts: 100, site: ctx.site });
-      const picked = rankByQuery(posts, text(args.query, 200), (p) => [p.title, [p.excerpt, nameOf(p.category)].filter(Boolean).join(" ")], limitOf(args.limit, 5));
+      const posts = await readers.readMany({ maxPosts: Infinity, site: ctx.site });
+      const picked = rankByQuery(posts, text(args.query, 200), (p) => [p.title, [p.excerpt, nameOf(p.category), p.content_html || p.content].filter(Boolean).join(" ")], posts.length);
+      const offset = Math.max(0, Math.floor(Number(args.offset) || 0));
+      const limit = limitOf(args.limit, 5);
       return {
-        articles: picked.map((p) => ({
+        total: picked.length,
+        next_offset: offset + limit < picked.length ? offset + limit : null,
+        articles: picked.slice(offset, offset + limit).map((p) => ({
           slug: p.slug,
           title: p.title,
           excerpt: p.excerpt,
           category: nameOf(p.category),
           published_at: p.published_at,
-          url: linkTo(ctx, `${basePath}/${p.slug}`)
+          url: articleUrl(ctx, basePath, p)
         }))
       };
     }
@@ -227,7 +240,7 @@ function getArticleTool(ctx, basePath, readers) {
     description: "One article in full, with approved supporting photo descriptions and section placements, by the slug list_articles returned. Cite it by its URL. Photo captions describe context; they do not verify claims beyond the article.",
     inputSchema: {
       type: "object",
-      properties: { slug: { type: "string", description: "The article slug from list_articles." } },
+      properties: { slug: { type: "string", description: "The article slug from list_articles." }, offset: { type: "integer", minimum: 0, description: "Character offset. Follow next_offset until null to read the entire article." } },
       required: ["slug"],
       additionalProperties: false
     },
@@ -236,16 +249,20 @@ function getArticleTool(ctx, basePath, readers) {
       const slug = text(args.slug, 200).replace(/^\/+|\/+$/g, "").split("/").pop() ?? "";
       const post = slug ? await readers.readOne(slug, { site: ctx.site }) : null;
       if (!post) return { found: false, note: `No published article with the slug "${slug}". Call list_articles for the slugs that exist.` };
-      const content = post.content ?? "";
+      const content = post.content_html || post.content || "";
+      const offset = Math.max(0, Math.floor(Number(args.offset) || 0));
       return {
         found: true,
         title: post.title,
-        url: linkTo(ctx, `${basePath}/${post.slug}`),
+        url: articleUrl(ctx, basePath, post),
         author: nameOf(post.author),
         category: nameOf(post.category),
         published_at: post.published_at,
-        content: content.slice(0, ARTICLE_CONTENT_MAX),
-        truncated: content.length > ARTICLE_CONTENT_MAX,
+        content: content.slice(offset, offset + ARTICLE_CONTENT_MAX),
+        offset,
+        total_length: content.length,
+        next_offset: offset + ARTICLE_CONTENT_MAX < content.length ? offset + ARTICLE_CONTENT_MAX : null,
+        truncated: offset + ARTICLE_CONTENT_MAX < content.length,
         faq: post.faq_items,
         editorial_photos: post.editorial_photos?.slice(0, 8).map(({ url, alt, caption, width, height, placement }) => ({ url, alt, caption, width, height, placement }))
       };

package/dist/press-kit/articles/artwork.d.ts

@@ -10,4 +10,7 @@ type ArtworkSource = Pick<Article, 'title' | 'featured_image' | 'featured_image_
 export declare function resolveArticleArtwork(post: ArtworkSource, placement?: 'article' | 'card'): ArticleArtwork;
 /** Preserve generated text and graphics across every stock card surface. */
 export declare function articleArtworkImageStyle(artwork: ArticleArtwork): CSSProperties | undefined;
+/** Search/discovery artwork is the representative photograph; social cards stay available separately. */
+export declare function resolveRepresentativeImage(post: Partial<Pick<Article, 'title' | 'representative_image' | 'editorial_image' | 'editorial_image_alt' | 'editorial_image_width' | 'editorial_image_height' | 'featured_image' | 'featured_image_alt' | 'featured_image_width' | 'featured_image_height'>>): import('./types').ArticleImage | undefined;
+export declare function articleImageSchema(post: Partial<Article>): object | string | undefined;
 export {};

package/dist/press-kit/articles/index.d.ts

@@ -39,6 +39,7 @@
  * }
  * ```
  */
+export type { PublicationDefinition } from './publication-definition';
 export type { ArticleServerProps, ArticleStyles } from './Article';
 export type { ArticleListServerProps, ArticleListStyles } from './ArticleList';
 export type { PublicationSidebarProps } from './PublicationSidebar';

package/dist/press-kit/articles/news-sitemap.d.ts

@@ -1,13 +1,4 @@
-/**
- * Google News sitemap and feed-size helpers. Pure, environment-free: the
- * server helpers in server-core fetch the posts and hand them here, so the XML
- * rules can be tested without a network.
- *
- * News sitemap rules (https://developers.google.com/search/docs/crawling-indexing/sitemaps/news-sitemap):
- * only articles published in the last two days, at most 1,000 URLs, each with
- * a publication name, language and publication date. Older articles belong in
- * the ordinary sitemap, which already lists them.
- */
+import type { Article } from './types';
 import { type PublicationRoutingOptions, type ArticleRoutePost } from './routes';
 /** Google only reads articles from the last two days in a News sitemap. */
 export declare const NEWS_SITEMAP_WINDOW_MS: number;
@@ -23,6 +14,9 @@ export declare const FEED_DEFAULT_ITEMS = 20;
 export interface NewsSitemapPost extends ArticleRoutePost {
     title: string;
     published_at?: string | null;
+    representative_image?: Article['representative_image'];
+    editorial_image?: string;
+    featured_image?: string;
 }
 export interface NewsSitemapOptions extends PublicationRoutingOptions {
     siteUrl: string;

package/dist/press-kit/articles/public-reads.d.ts

@@ -5,8 +5,24 @@ export interface ArticleReadConfig {
     /** Sub-site host override. Omit to resolve from NEXT_PUBLIC_SITE_URL. */
     site?: string;
 }
-/** GET /public/articles/posts/:slug — null when missing or on any failure. */
-export declare function fetchArticleBySlug({ apiUrl, apiKey, site }: ArticleReadConfig, slug: string): Promise<Article | null>;
+/** A failed upstream read must never masquerade as a missing article. */
+export declare class ArticleUnavailableError extends Error {
+    readonly status?: number | undefined;
+    readonly code = "ARTICLE_UNAVAILABLE";
+    constructor(status?: number | undefined);
+}
+export type ArticleReadResult<T> = {
+    state: 'ready';
+    value: T;
+} | {
+    state: 'not_found';
+} | {
+    state: 'unavailable';
+    status?: number;
+};
+export declare function readArticleBySlug({ apiUrl, apiKey, site }: ArticleReadConfig, slug: string): Promise<ArticleReadResult<Article>>;
+/** Returns null only on a confirmed 404; outages propagate to the route error boundary. */
+export declare function fetchArticleBySlug(config: ArticleReadConfig, slug: string): Promise<Article | null>;
 /** GET /public/articles/categories — [] on any failure. */
 export declare function fetchArticleCategories({ apiUrl, apiKey, site }: ArticleReadConfig): Promise<ArticleCategory[]>;
 /**

package/dist/press-kit/articles/publication-definition.d.ts

@@ -0,0 +1,41 @@
+/** One portable, tenant-authored launch definition. Contains no credential or content. */
+export interface PublicationDefinition {
+    version: 1;
+    name: string;
+    description: string;
+    siteUrl: string;
+    basePath: string;
+    style: 'newsroom' | 'journal' | 'briefing';
+    sections: Array<{
+        slug: string;
+        title: string;
+    }>;
+    newsletterFormId: string;
+    brand: {
+        primary: string;
+    };
+}
+export declare const PUBLICATION_STARTERS: {
+    readonly newsroom: {
+        readonly label: 'Newsroom';
+        readonly description: 'A strong masthead and a visual grid for frequent reporting.';
+        readonly columns: 3;
+        readonly maxWidth: 1280;
+        readonly serif: false;
+    };
+    readonly journal: {
+        readonly label: 'Journal';
+        readonly description: 'A quieter serif masthead and roomy stories for expert essays.';
+        readonly columns: 2;
+        readonly maxWidth: 1040;
+        readonly serif: true;
+    };
+    readonly briefing: {
+        readonly label: 'Briefing';
+        readonly description: 'A compact single-column reading list for useful updates.';
+        readonly columns: 1;
+        readonly maxWidth: 820;
+        readonly serif: false;
+    };
+};
+export declare function definePublication(input: unknown): PublicationDefinition;

package/dist/press-kit/articles/publication-reads.d.ts

@@ -0,0 +1,54 @@
+import 'server-only';
+import type { Article } from './types';
+import type { ArticleReadResult } from './public-reads';
+export interface PublicationIssue {
+    id: string;
+    title: string;
+    subject: string;
+    sentAt: string;
+    window?: {
+        start?: string;
+        end?: string;
+    };
+    articles: Array<{
+        id: string;
+        title: string;
+        url: string;
+    }>;
+    /** Immutable, public-safe sent snapshot; no recipient tokens or private fields. */
+    html?: string;
+    text?: string;
+}
+export interface PublicationIssueList {
+    issues: PublicationIssue[];
+    nextCursor?: string;
+}
+export declare function getPublicationIssues(options?: {
+    site?: string;
+    limit?: number;
+    cursor?: string;
+}): Promise<ArticleReadResult<PublicationIssueList>>;
+export declare function getPublicationIssue(id: string, options?: {
+    site?: string;
+}): Promise<ArticleReadResult<PublicationIssue>>;
+export interface ArticlePreview {
+    post: Article;
+    revision: string;
+    expiresAt: string;
+    site: string;
+}
+export declare const PUBLICATION_PREVIEW_COOKIE = "_sk_press_preview";
+export declare const PUBLICATION_PREVIEW_HEADERS: {
+    'Cache-Control': string;
+    'X-Robots-Tag': string;
+    'Referrer-Policy': string;
+};
+/** Server-to-server exchange. Never render or log the token; every read rechecks its exact revision. */
+export declare function getArticlePreview(token: string, options: {
+    site: string;
+}): Promise<ArticleReadResult<ArticlePreview>>;
+/** CMS entry: validate once, hide token in a scoped HttpOnly cookie, redirect only to configured local preview. */
+export declare function createPublicationPreviewHandler(options: {
+    siteUrl: string;
+    previewPath: string;
+}): (request: Request) => Promise<Response>;

package/dist/press-kit/articles/server-core.d.ts

@@ -7,10 +7,26 @@
  */
 import type { Metadata } from 'next';
 import type { Article as ArticleRecord, ArticleAuthor, TopicCluster, ClusterNavigation } from './types';
+import { ArticleUnavailableError } from './public-reads';
 import { sanitizeExcerpt } from './excerpt';
+import { articleImageSchema, resolveRepresentativeImage } from './artwork';
 import { type PublicationRoutingOptions } from './routes';
 import { type NewsSitemapOptions } from './news-sitemap';
-export { sanitizeExcerpt };
+export { sanitizeExcerpt, ArticleUnavailableError, resolveRepresentativeImage, articleImageSchema };
+export type { ArticleReadResult } from './public-reads';
+export declare function getArticleResult(slug: string, options?: {
+    site?: string;
+}): Promise<{
+    state: 'ready';
+    value: ArticleRecord;
+} | {
+    state: 'not_found';
+} | {
+    state: 'unavailable';
+    status?: number;
+} | {
+    state: 'unavailable';
+}>;
 export declare const SEO_LIMITS: {
     readonly title: {
         readonly min: 30;
@@ -276,8 +292,8 @@ export interface RssFeedOptions extends PublicationRoutingOptions {
  * Fetch all published articles for RSS feed.
  *
  * Paginates with `per_page`/`page` — the only pagination params the deployed
- * controller reads — accumulating up to FEED_MAX_POSTS. A mid-loop failure
- * returns what was accumulated so far: a partial feed beats an empty one.
+ * controller reads — accumulating up to FEED_MAX_POSTS. A mid-loop failure throws ArticleUnavailableError; a truncated archive must
+ * not be reported as a complete collection.
  */
 export declare function getAllArticles(options?: {
     maxPosts?: number; /** Sub-site host override (see getArticle). */
@@ -459,3 +475,5 @@ export { insertArticlePhotos, articlePhotoCss } from './article-photos';
 export type { ArticleEditorialPhoto } from './types';
 export { FEED_DEFAULT_ITEMS, NEWS_SITEMAP_MAX_URLS, NEWS_SITEMAP_WINDOW_MS, buildNewsSitemapXml, cdata, recentNewsPosts } from './news-sitemap';
 export type { NewsSitemapOptions, NewsSitemapPost } from './news-sitemap';
+export { getPublicationIssues, getPublicationIssue, getArticlePreview, createPublicationPreviewHandler, PUBLICATION_PREVIEW_COOKIE, PUBLICATION_PREVIEW_HEADERS } from './publication-reads';
+export type { PublicationIssue, PublicationIssueList, ArticlePreview } from './publication-reads';

package/dist/press-kit/articles/types.d.ts

@@ -17,6 +17,13 @@ export interface ArticleEditorialPhoto {
         headingId?: string;
     };
 }
+export interface ArticleImage {
+    url: string;
+    alt?: string;
+    /** Actual asset dimensions, never an assumed social ratio. */
+    width?: number;
+    height?: number;
+}
 export interface Article {
     id: string;
     project_id: string;
@@ -31,10 +38,15 @@ export interface Article {
     /** Complete promotional image, including composed share-card text when generated. */
     featured_image?: string;
     featured_image_alt?: string;
+    featured_image_width?: number;
+    featured_image_height?: number;
+    representative_image?: ArticleImage;
     /** Article artwork, separate from the promotional card. Optional on older APIs. */
     editorial_image?: string;
     /** Empty for decorative atmosphere artwork; preserve an explicitly empty value. */
     editorial_image_alt?: string;
+    editorial_image_width?: number;
+    editorial_image_height?: number;
     /** Dedicated index frame from Sonor's atmosphere + content-stage renderer. */
     index_image?: string;
     index_image_alt?: string;
@@ -71,6 +83,17 @@ export interface Article {
         description?: string;
         url?: string;
     }[];
+    /** An editor-approved public note, distinct from generation or update timestamps. */
+    publication_cta?: {
+        label: string;
+        url: string;
+        goal: string;
+    };
+    editorial_verification?: {
+        note: string;
+        reviewedAt?: string;
+        reviewDueAt?: string;
+    };
     /** Publishing */
     status: 'draft' | 'published' | 'scheduled' | 'archived';
     published_at?: string;

package/dist/revalidate/index.js

@@ -1,7 +1,7 @@
-import { createSeoRevalidationHandler } from '../chunk-FHUTOXS7.js';
+import { createSeoRevalidationHandler } from '../chunk-XENW66OF.js';
 import '../chunk-XTRZGXB2.js';
 export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-6KU7STM3.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/revalidate/index.ts

package/dist/runtime/index.js

@@ -1,8 +1,8 @@
 import '../chunk-B7T2SFUF.js';
 export { readAnalyticsIdentity } from '../chunk-5ROTTMBL.js';
 import '../chunk-5TM3WPCI.js';
-export { sonorFetch } from '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+export { sonorFetch } from '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 export { DEFAULT_SONOR_API_URL, getClientApiConfig, readPublishedApiConfig } from '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/client.js

@@ -1,10 +1,10 @@
 'use client';
-export { SitemapSync } from '../chunk-SCTVADDL.js';
+export { SitemapSync } from '../chunk-HH2GOZTO.js';
 import '../chunk-YVKRYQRG.js';
-import '../chunk-JO76F5WP.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/index.js

@@ -2,7 +2,7 @@ export { ManagedNoScripts, ManagedScripts } from '../chunk-MVLMXC44.js';
 import { pickManagedLlmSchemaForJsonLd } from '../chunk-NZ4RXN3G.js';
 import { withoutSchemaPlaceholders } from '../chunk-VWWITFWM.js';
 import { safeJsonLd } from '../chunk-4KZ6W3ZH.js';
-export { SitemapSync } from '../chunk-SCTVADDL.js';
+export { SitemapSync } from '../chunk-HH2GOZTO.js';
 import { getManagedMetadata, mergeAlternates } from '../chunk-URJN75ZG.js';
 export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-URJN75ZG.js';
 import { getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, pruneSchemaTypes } from '../chunk-Y35BWW2C.js';
@@ -16,12 +16,12 @@ import '../chunk-YVKRYQRG.js';
 import '../chunk-DIKNRN34.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-JO76F5WP.js';
+import '../chunk-DLM4FFNH.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-OIWFXUVD.js';
-import '../chunk-C4AFNZT2.js';
+import '../chunk-3VSFOD2Z.js';
+import '../chunk-RBNHRZGD.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';
 import { Suspense } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/seo/llms.js

@@ -1,10 +1,10 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-2JMCBJM5.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-DS6LECIX.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-FHUTOXS7.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-XENW66OF.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
 import '../chunk-XTRZGXB2.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-D6ZIQMHB.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-CE7VPAEH.js';
 export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-XA7Q2VQA.js';
 import '../chunk-5D7ZISUP.js';
 import '../chunk-4K735O3J.js';
@@ -16,5 +16,5 @@ import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
 import '../chunk-W7OPEMGJ.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/register-sitemap-cli.js

@@ -458,7 +458,7 @@ async function registerLocalSitemap(options) {
   }
   if (options.writeLlms && result.success) {
     try {
-      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-VKHCM5IS.js');
+      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-N4Y4YC2H.js');
       const written = await writeLLMsTxtToPublic({
         // Resolved here too: the sync's own `site` is scoped to the branch that
         // posts, and this runs on the skip path as well.

package/dist/seo/sitemap.js

@@ -1,5 +1,5 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-BOCYBDKV.js';
-import '../chunk-D6ZIQMHB.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-JCSU6EJI.js';
+import '../chunk-CE7VPAEH.js';
 import '../chunk-XA7Q2VQA.js';
 import '../chunk-Z22QVHT4.js';
 import '../chunk-5D7ZISUP.js';

package/dist/server/index.js

@@ -1,8 +1,8 @@
 import '../chunk-34ZYJTQR.js';
-export { resolveClientCredential } from '../chunk-WSOZ3FQN.js';
+export { resolveClientCredential } from '../chunk-LPVEBQVL.js';
 import '../chunk-UAYAJPEP.js';
 export { SITE_CACHE_TAGS } from '../chunk-6KU7STM3.js';
 export { isNextControlFlow, requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
-import '../chunk-C2UROFGZ.js';
+import '../chunk-5S7YTOCB.js';
 import '../chunk-PKBMQBKP.js';

package/dist/shared/reporting-gate.d.ts

@@ -3,6 +3,8 @@
  * Analytics, fleet, SitemapSync, chat and popups all resolve through this gate.
  * Kept separate from transport wrappers so non-analytics modules stay lean.
  */
+/** A server-rendered marker keeps private drafts out of every reporting path. */
+export declare function isPrivatePreview(): boolean;
 /** Resolved destination for an analytics send. */
 export interface AnalyticsTarget {
     apiUrl: string;

package/dist/shared/version.d.ts

@@ -7,4 +7,4 @@
  * it matches package.json at publish time, and version.test.ts asserts it in
  * dev, so it can't silently drift.
  */
-export declare const SITE_KIT_VERSION = "8.3.0";
+export declare const SITE_KIT_VERSION = "8.4.0";