@sonordev/contracts 2.13.0 → 2.15.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## Unreleased
+
+- `llms` holds the rules for what llms.txt says about each page, so the Sonor API and site-kit's local generator build page lines the same way. New: `pickLlmsPageDescription` and `resolveLlmsPageDescription` (summary, curated meta, served meta, schema description, then a cleaned scrape), `llmsPageListNote`, `llmsPageTitle`, `isLlmsListablePage`, `selectLlmsPages`, `groupLlmsPages`, `llmsBlockquoteSummary`, `llmsContactLines`, `llmsAbsoluteUrl`, `cleanScrapedPageText`, `stripContactDetails`, `stripPageFiller` and `LLMS_DESCRIPTION_MAX_LENGTH`.
+- `sanitizeLlmsPublicSummary` removes a phone number or email address, with the "call" or "email us at" in front of it, and a "This page covers" lead-in, and keeps the rest. It used to return `null` for any summary that mentioned a phone or email, and a page with no summary is described by its scrape.
+
+## 2.15.0
+
+- Add `@sonordev/contracts/funnels` with bounded incomplete drafts, launch-ready definitions, command envelopes, brand presentation overrides, readiness and public page validation. Runtime parsers and JSON schemas share the same shapes.
+- Add the canonical funnel content cache tag and campaign normalization used by managed landing pages. Existing publication logo roles and inbox behavior remain available.
+
+## 2.14.0
+
+- Publication branding adds optional `identity.squareLogoUrl` and `identity.fullLogoUrl` for a square publication mark and its full/display logo. Both use the existing URL validation and support `null` in patches to clear an override. Theme variants in `identity.logos`, the text `identity.wordmark`, and publisher attribution remain separate. Existing saved profiles keep their shape and version.
+- Add `@sonordev/contracts/inbox`: the one rule for which inbox cards are decisions that "Mark all read" and "Dismiss all" leave alone. `isDecisionCard(card)` counts an approval, the ledger's unconfirmed-action card and any card carrying a proposal; `DECISION_INSIGHT_TYPES`, `APPROVAL_NEEDED_INSIGHT_TYPE` and `LEDGER_UNCONFIRMED_INSIGHT_TYPE` are the types behind it. The Signal API and the dashboard read the same rule, so a bulk action's preview matches what it writes.
+
 ## 2.13.0
 
 - Publication branding adds `editorial.focusClosingBackground`, with `planned_photo` and `article_atmosphere` choices. The setting inherits through publication and platform layers, and supports clearing an override. Article atmosphere closing frames reuse saved artwork and the real author portrait; other publications retain their existing behavior.

package/README.md

@@ -18,7 +18,7 @@ pnpm add @sonordev/contracts
 | `@sonordev/contracts/sites` | The canonical shape of a site host (the multi-site `site` dimension) | every ingest and read that filters by site |
 | `@sonordev/contracts/seo-pages` | Which `seo_pages` row a path resolves to on a multi-site project | the Sonor API, Signal, site-kit's sitemap sync |
 | `@sonordev/contracts/seo-meta` | Whether a title or description is fit to ship | site-kit, Signal's SEO gate |
-| `@sonordev/contracts/llms` | llms.txt sanitizers, the word-safe cut they use (`clipAtWordBoundary`), and the contract version | site-kit, the Sonor API, Signal's schema validation |
+| `@sonordev/contracts/llms` | llms.txt sanitizers, the word-safe cut they use (`clipAtWordBoundary`), what each page line says (`pickLlmsPageDescription`: summary, curated meta, served meta, schema description, then a cleaned scrape; `llmsPageTitle`, `isLlmsListablePage`, `groupLlmsPages`, `selectLlmsPages`) and the contract version | site-kit, the Sonor API, Signal's schema validation |
 | `@sonordev/contracts/forms` | The honeypot policy | site-kit forms, the Sonor API's form intake |
 | `@sonordev/contracts/fleet` | The fleet heartbeat's wire shape | site-kit, the Sonor API |
 | `@sonordev/contracts/slots` | Slot payload signing, contract v2 (HMAC; Node only). Signs and verifies v1 for older site-kit releases | the Sonor API, site-kit on the server |
@@ -38,6 +38,8 @@ pnpm add @sonordev/contracts
 | `@sonordev/contracts/broadcast-layouts` | Which Broadcast card layouts are drawn (centered `headline`, low `anchor`), which retired IDs still read and what each draws as (`normalizeArticleCoverLayout`), the Broadcast styles, and the review compositions with the frozen draw that gives each review its own (`reviewCardVariationFromDigest`) | the Sonor API's card renderers and settings, Signal's agent tools, the dashboard's pickers |
 | `@sonordev/contracts/publication-branding` | What a publication's branding may hold and what a change may set (`createPublicationBrandingValidator`), how a change merges, the editorial charter, and safe font stacks | the Sonor API stores and resolves it, Signal checks an agent's change before filing it, the dashboard edits it |
 | `@sonordev/contracts/public-url-host` | Which literal hosts are refused as public fetch destinations (`isBlockedPublicUrlHost`) | the Sonor API and Signal's URL validators and network fetchers |
+| `@sonordev/contracts/funnels` | Incomplete drafts, launch definitions, command/readiness/receipt schemas, bounded public pages and presentation-only brand overrides | Sites, APIs, UI and agent adapters share the same rules |
+| `@sonordev/contracts/inbox` | Which inbox cards are decisions a bulk action leaves alone (`isDecisionCard`, `DECISION_INSIGHT_TYPES`) | Signal's inbox decides what "Mark all read" and "Dismiss all" may touch, the dashboard previews the same result before the write |
 
 ## Focus closing artwork
 
@@ -63,6 +65,31 @@ isn't proof a destination is public: the fetcher still validates the protocol,
 credentials and port, checks the DNS addresses it connects to, and applies its
 redirect policy on each hop. Those network protections stay in the APIs.
 
+## Inbox decisions
+
+"Mark all read" and "Dismiss all" never touch a decision, so clearing a backlog
+of notices can't bury an approval waiting on a yes. `isDecisionCard(card)` is
+that rule: the Signal API follows it when it writes, and the dashboard follows
+it to show the result before the write, so the two can't drift apart.
+
+A card is a decision when it is:
+
+- an approval (insight type `approval_needed`, `APPROVAL_NEEDED_INSIGHT_TYPE`);
+- the ledger's unconfirmed-action card (`ledger_unconfirmed_action`,
+  `LEDGER_UNCONFIRMED_INSIGHT_TYPE`): Signal started something it never saw
+  finish, so a person has to check it. It's raised once per claim, so a bulk
+  dismissal that took it would leave nobody told. It carries no proposal, so
+  there's nothing to approve or reject on it; or
+- any card carrying a ledger proposal (`data.proposal_id` set).
+
+`DECISION_INSIGHT_TYPES` is the first two, for the callers that need them as a
+list (a database filter that leaves them out of a bulk write, for one).
+`isDecisionCard` takes any object with an `insight_type` string and an optional
+`data` object, so a stored row and the dashboard's inbox item both fit. It reads
+`data.proposal_id` the way the database reads `data->>proposal_id`: a missing
+key, a JSON `null` and a `null` `data` mean no proposal, and any other value,
+an empty string included, means one.
+
 ## Schema placeholders
 
 `schema-placeholders` finds the parts of a JSON-LD value that a template left
@@ -794,6 +821,14 @@ branding.mergePublicationBrandingPatch(saved, { identity: { logos: { dark: null
   `{ version: 1 }`, and a change that sets nothing returns the profile as it
   was. **`mergePublicationBrandingLayers`** is the same leaf-wise merge for
   resolving layers.
+- **Publication logo roles** are optional `identity.squareLogoUrl` and
+  `identity.fullLogoUrl`. Use the first for a square publication mark and the
+  second for its full/display logo. Both follow the same URL policy as other
+  logo fields. Set either leaf to `null` in a patch to clear that override
+  and restore inheritance. `identity.logos.default/light/dark` remain theme
+  variants, `identity.wordmark` stays text, and `publisherLogoUrl` is publisher
+  attribution. Omitting the new leaves preserves existing profiles; the
+  validator doesn't infer a square mark or select an effective display logo.
 - **Refusals name the field.** A `PublicationBrandingValidationError` carries
   the path (`publication_branding.platforms.email.colors.primary`) and says
   what's allowed. A charter set on a channel override is a plain `Error`: a
@@ -882,3 +917,15 @@ a shape bumps the major and that contract's own `*_VERSION` constant.
 ### Editorial media
 
 `@sonordev/contracts/editorial-media` exports `resolveArticlePhotoPlacements(html, photos)`, returning section targets and a status/offset for each explicit placement. Both the editor and article renderer use this contract; a heading with no eligible prose is reported as `no_paragraph`, and missing/ambiguous anchors never drift to another section. `editorialTextId` creates content identities for explicit takeaway assignments. Source-image format, size and completed-art exclusions are shared by the picker and resolver.
+
+## The funnels contract
+
+Import from `@sonordev/contracts/funnels`. `createFunnelDraft(template)` provides neutral defaults for `newsletter`, `requested_guide` and `inquiry`. `parseFunnelDraftDefinition` accepts bounded incomplete drafts so each setup step can save. `parseFunnelDefinition` requires a launch-ready structural definition. Resource ownership, current permission, route installation and launch authorization remain server checks.
+
+Use `parseFunnelCreateArgs`, `parseFunnelUpdateArgs`, `parseFunnelRevisionArgs`, `parseFunnelLaunchArgs`, `parseFunnelLifecycleArgs` and `parseFunnelRetryArgs` at command boundaries. `parseFunnelDraftArgs(value, mode)` requires an explicit create/update mode. Rollback uses `parseFunnelLifecycleArgs(value, 'rollback')`. Matching exported JSON schemas describe the closed structural shapes; runtime parsers also enforce semantic checks such as matching form references and managed paths.
+
+`applyFunnelBrandOverride` takes an already resolved brand, an allowlisted presentation patch and an API-authorized asset map. Null leaves restore inheritance. It returns the resulting brand, overridden field paths and asset references. It doesn't fetch assets, resolve business precedence or calculate authoritative hashes. `parseFunnelBrandSnapshot` validates the captured presentation and provenance.
+
+`parsePublishedFunnelPage` refuses private definition fields and unsafe asset URLs. It supports bounded text paragraphs and bullet lists, with a managed form slug and canonical campaign identity. `managedFunnelPath` reserves `/f/:slug`; a consuming site must opt in and verify its actual routes.
+
+`parseFunnelReadiness`, `parseFunnelOperationReceipt` and the detail/catalog/preview parsers validate bounded response envelopes. Operation receipts bind the exact command target and approved action, and always report zero messages sent by the configuration command. Preview and published-version detail parsers preserve the exact launch or rollback evidence.

package/dist/campaign-normalize.d.ts

@@ -0,0 +1,2 @@
+/** Single source of truth for campaign identities across sites, APIs and funnels. */
+export declare function normalizeCampaignSlug(input?: string | null): string | null;

package/dist/funnels.d.ts

@@ -0,0 +1,576 @@
+import { type PublicationColors } from './publication-branding';
+export { normalizeCampaignSlug } from './campaign-normalize';
+export declare const FUNNEL_SCHEMA_VERSION: 1;
+export declare const MANAGED_FUNNEL_PATH_PREFIX: '/f';
+export declare const FUNNEL_TEMPLATES: readonly ['newsletter', 'requested_guide', 'inquiry'];
+export type FunnelTemplate = typeof FUNNEL_TEMPLATES[number];
+export type FunnelLifecycle = 'draft' | 'active' | 'paused';
+export type FunnelHealth = 'healthy' | 'waiting' | 'needs_attention' | 'unknown';
+export type FunnelBodyBlock = {
+    type: 'paragraph';
+    text: string;
+} | {
+    type: 'bullets';
+    items: string[];
+};
+export interface FunnelBrandPresentation {
+    displayName: string;
+    tagline: string;
+    fullLogoUrl: string | null;
+    squareLogoUrl: string | null;
+    colors: Required<PublicationColors>;
+    typography: {
+        headingFamily: string;
+        bodyFamily: string;
+    };
+    scheme: 'light' | 'dark';
+}
+export interface FunnelBrandOverride {
+    displayName?: string | null;
+    tagline?: string | null;
+    fullLogoAssetId?: string | null;
+    squareLogoAssetId?: string | null;
+    colors?: {
+        [K in keyof PublicationColors]?: string | null;
+    };
+    typography?: {
+        headingFamily?: string | null;
+        bodyFamily?: string | null;
+    };
+}
+export type FunnelBrandSource = 'project' | 'brand_profile' | 'site_design' | 'publication_branding' | 'platforms.publication' | 'platforms.email' | 'funnel_override' | 'default';
+export interface FunnelBrandSnapshot {
+    page: FunnelBrandPresentation;
+    email: FunnelBrandPresentation;
+    provenance: Record<string, FunnelBrandSource>;
+    assetRefs: {
+        id: string | null;
+        version: string | null;
+    }[];
+    capturedAt: string;
+    fingerprint: string;
+}
+export type FunnelStep = {
+    id: string;
+    type: 'wait';
+    durationSeconds: number;
+} | {
+    id: string;
+    type: 'send_email';
+    templateId: string;
+    purpose: 'requested_fulfillment' | 'marketing';
+    guideAssetId?: string | null;
+} | {
+    id: string;
+    type: 'add_tag';
+    target: 'subscriber';
+    tag: string;
+} | {
+    id: string;
+    type: 'create_task';
+    ownerContactId: string;
+    title: string;
+    dueAfterSeconds: number;
+};
+export interface FunnelDefinition {
+    schemaVersion: 1;
+    name: string;
+    template: FunnelTemplate;
+    site: string;
+    entry: {
+        formId: string;
+        mode: 'future_accepted_form_only';
+    };
+    goal: {
+        type: 'newsletter_confirmed' | 'guide_requested' | 'inquiry_received' | 'booking_confirmed';
+        bookingTypeId?: string | null;
+    };
+    page: {
+        mode: 'existing' | 'managed';
+        path: string;
+        slug?: string | null;
+        headline: string;
+        body: FunnelBodyBlock[];
+        formId: string;
+        offerAssetId?: string | null;
+    };
+    permission: {
+        mode: 'requested_only' | 'marketing_opt_in';
+        optInFieldSlug?: string | null;
+    };
+    brandOverride?: FunnelBrandOverride;
+    steps: FunnelStep[];
+    exits: {
+        unsubscribe: true;
+        manualStop: true;
+        confirmedBooking?: {
+            enabled: boolean;
+            bookingTypeId: string | null;
+        };
+    };
+}
+export interface FunnelIssue {
+    code: string;
+    path: string;
+    message: string;
+    fixRef?: {
+        section: string;
+        field?: string;
+        resourceId?: string;
+    };
+}
+export interface FunnelReadiness {
+    definitionRevision: number;
+    brandFingerprint: string;
+    resourceFingerprint: string;
+    ready: boolean;
+    blockers: FunnelIssue[];
+    warnings: FunnelIssue[];
+    capabilities: {
+        managedPage: boolean;
+    };
+}
+export interface PublishedFunnelPage {
+    schemaVersion: 1;
+    id: string;
+    versionId: string;
+    revision: number;
+    site: string;
+    path: string;
+    content: {
+        headline: string;
+        body: FunnelBodyBlock[];
+        offer?: {
+            label: string;
+            href: string;
+        };
+    };
+    brand: FunnelBrandPresentation;
+    conversion: {
+        formSlug: string;
+    };
+    tracking: {
+        campaignSlug: string;
+    };
+}
+export interface FunnelOperationReceipt {
+    operationId: string;
+    projectId: string;
+    orgId: string;
+    funnelId: string;
+    operation: 'create' | 'update' | 'launch' | 'pause' | 'resume' | 'retry' | 'rollback';
+    idempotencyKey: string;
+    requestDigest: string;
+    versionId: string | null;
+    lifecycle: FunnelLifecycle;
+    replayed: boolean;
+    armedFutureEntrantsOnly: true;
+    enrolledExisting: 0;
+    messagesSent: 0;
+    pagePublication: 'not_requested' | 'published' | 'revalidation_pending';
+    health: FunnelHealth;
+    revision: number;
+    commandState: 'committed';
+    funnel: FunnelDetail | null;
+    actor: string;
+    armedAt: string | null;
+    effectScope: 'configuration_only' | 'safe_retry_armed';
+    target: FunnelCommandTarget;
+    ledgerProposalId: string;
+}
+export interface FunnelCommandTarget {
+    funnelId: string | null;
+    enrollmentId: string | null;
+    executionId: string | null;
+    targetVersionId: string | null;
+}
+export interface FunnelLaunchArgs {
+    expectedRevision: number;
+    previewId: string;
+    idempotencyKey: string;
+    confirm: true;
+}
+export interface FunnelLifecycleArgs {
+    expectedActiveVersionId: string;
+    idempotencyKey: string;
+    confirm: true;
+    targetVersionId?: string;
+}
+/** Small closed JSON-schema vocabulary shared by the exported schema and its runtime parser. */
+type Shape = {
+    type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, Shape>;
+    required?: readonly string[];
+    additionalProperties?: false;
+    items?: Shape;
+    minItems?: number;
+    maxItems?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    enum?: readonly unknown[];
+    const?: unknown;
+    oneOf?: readonly Shape[];
+};
+export type FunnelDraftStep = Extract<FunnelStep, {
+    type: 'wait' | 'add_tag';
+}> | (Omit<Extract<FunnelStep, {
+    type: 'send_email';
+}>, 'templateId' | 'guideAssetId'> & {
+    templateId: string | null;
+    guideAssetId?: string | null;
+}) | (Omit<Extract<FunnelStep, {
+    type: 'create_task';
+}>, 'ownerContactId'> & {
+    ownerContactId: string | null;
+});
+export interface FunnelDraftDefinition extends Omit<FunnelDefinition, 'site' | 'entry' | 'page' | 'steps'> {
+    site: string | null;
+    entry: {
+        formId: string | null;
+        mode: 'future_accepted_form_only';
+    };
+    page: Omit<FunnelDefinition['page'], 'path' | 'formId'> & {
+        path: string | null;
+        formId: string | null;
+    };
+    steps: FunnelDraftStep[];
+}
+export declare const FUNNEL_DRAFT_DEFINITION_JSON_SCHEMA: {
+    readonly type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
+    readonly properties?: Record<string, Shape>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+    readonly items?: Shape;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly oneOf?: readonly Shape[];
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+};
+export declare function parseFunnelDraftDefinition(value: unknown): FunnelDraftDefinition;
+export declare function createFunnelDraft(template: FunnelTemplate): FunnelDraftDefinition;
+export declare const FUNNEL_DEFINITION_JSON_SCHEMA: {
+    readonly type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
+    readonly properties?: Record<string, Shape>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+    readonly items?: Shape;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly oneOf?: readonly Shape[];
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+};
+export declare const PUBLISHED_FUNNEL_PAGE_JSON_SCHEMA: {
+    readonly type?: 'object' | 'array' | 'string' | 'integer' | 'boolean' | 'null';
+    readonly properties?: Record<string, Shape>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+    readonly items?: Shape;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly enum?: readonly unknown[];
+    readonly const?: unknown;
+    readonly oneOf?: readonly Shape[];
+    readonly $schema: 'http://json-schema.org/draft-07/schema#';
+};
+export declare const FUNNEL_LAUNCH_JSON_SCHEMA: Shape;
+export declare const FUNNEL_LIFECYCLE_JSON_SCHEMA: Shape;
+export declare const FUNNEL_ROLLBACK_JSON_SCHEMA: Shape;
+export declare class FunnelValidationError extends Error {
+    readonly path: string;
+    constructor(path: string, reason: string);
+}
+/** No DNS/network access. Consumers fetching URLs still enforce their connection policy. */
+export declare function isSafeFunnelPublicUrl(value: string): boolean;
+export declare function managedFunnelPath(value: string): string;
+export declare function parseFunnelDefinition(value: unknown): FunnelDefinition;
+export declare function parsePublishedFunnelPage(value: unknown): PublishedFunnelPage;
+export declare function parseFunnelLaunchArgs(value: unknown): FunnelLaunchArgs;
+export declare function parseFunnelLifecycleArgs(value: unknown, operation?: 'pause' | 'resume' | 'rollback'): FunnelLifecycleArgs;
+/** Apply presentation-only overrides to an already resolved canonical brand. Null means inherit. */
+export declare function applyFunnelBrandOverride(inherited: FunnelBrandPresentation, patch?: FunnelBrandOverride, resolvedAssets?: Record<string, {
+    url: string;
+    version?: string;
+}>): {
+    brand: FunnelBrandPresentation;
+    overridePaths: string[];
+    assetRefs: {
+        id: string;
+        version: string | null;
+    }[];
+};
+export interface FunnelCreateArgs {
+    idempotencyKey: string;
+    definition: FunnelDraftDefinition;
+}
+export interface FunnelUpdateArgs extends FunnelCreateArgs {
+    expectedRevision: number;
+}
+export declare const FUNNEL_CREATE_JSON_SCHEMA: Shape;
+export declare const FUNNEL_UPDATE_JSON_SCHEMA: Shape;
+export declare function parseFunnelCreateArgs(value: unknown): FunnelCreateArgs;
+export declare function parseFunnelUpdateArgs(value: unknown): FunnelUpdateArgs;
+export interface FunnelPreview {
+    previewId: string;
+    versionId: string;
+    expiresAt: string;
+    definitionRevision: number;
+    brand: FunnelBrandSnapshot;
+    readiness: FunnelReadiness;
+    page: PublishedFunnelPage | null;
+    launchEvidence: FunnelLaunchEvidence;
+    emailPreviews: {
+        stepId: string;
+        ready: boolean;
+        subject: string | null;
+        contentHtml: string | null;
+        issues: FunnelIssue[];
+    }[];
+}
+export interface FunnelSummary {
+    id: string;
+    name: string;
+    template: FunnelTemplate;
+    site: string | null;
+    revision: number;
+    activeVersionId: string | null;
+    lifecycle: FunnelLifecycle;
+    health: FunnelHealth;
+    hasDraftChanges: boolean;
+    counts: {
+        entered: number;
+        waiting: number;
+        running: number;
+        completed: number;
+        exited: number;
+        needsAttention: number;
+    };
+    countsBasis: 'all_versions_all_time';
+    lastEventAt: string | null;
+}
+export type FunnelDraftArgs = FunnelCreateArgs | FunnelUpdateArgs;
+/** Select create/update explicitly at the HTTP boundary; a missing revision never downgrades an update. */
+export declare function parseFunnelDraftArgs(value: unknown, mode: 'create' | 'update'): FunnelDraftArgs;
+export interface FunnelRevisionArgs {
+    expectedRevision: number;
+}
+export interface FunnelRetryArgs {
+    expectedAttempt: number;
+    idempotencyKey: string;
+    confirm: true;
+}
+export declare const FUNNEL_REVISION_JSON_SCHEMA: Shape;
+export declare const FUNNEL_RETRY_JSON_SCHEMA: Shape;
+export declare const FUNNEL_DRAFT_JSON_SCHEMAS: {
+    readonly create: Shape;
+    readonly update: Shape;
+};
+export declare function parseFunnelRevisionArgs(value: unknown): FunnelRevisionArgs;
+export declare function parseFunnelRetryArgs(value: unknown): FunnelRetryArgs;
+export declare const FUNNEL_READINESS_JSON_SCHEMA: Shape;
+export declare function parseFunnelReadiness(value: unknown): FunnelReadiness;
+export interface FunnelDetail {
+    id: string;
+    revision: number;
+    definition: FunnelDraftDefinition;
+    activeVersionId: string | null;
+    lifecycle: FunnelLifecycle;
+    health: FunnelHealth;
+    hasDraftChanges: boolean;
+    readiness: FunnelReadiness;
+}
+export declare const FUNNEL_DETAIL_JSON_SCHEMA: Shape;
+export declare function parseFunnelDetail(value: unknown): FunnelDetail;
+export declare const FUNNEL_OPERATION_RECEIPT_JSON_SCHEMA: Shape;
+export declare function parseFunnelOperationReceipt(value: unknown): FunnelOperationReceipt;
+export declare const FUNNEL_BRAND_SNAPSHOT_JSON_SCHEMA: Shape;
+export declare function parseFunnelBrandSnapshot(value: unknown): FunnelBrandSnapshot;
+export interface FunnelCatalogItem {
+    id: string;
+    label: string;
+}
+export interface FunnelFormChoice extends FunnelCatalogItem {
+    slug: string;
+    site: string | null;
+    formType: string;
+    active: boolean;
+    newsletterListIds: string[];
+    fields: {
+        slug: string;
+        type: string;
+        label: string;
+        required: boolean;
+    }[];
+}
+export interface FunnelListChoice extends FunnelCatalogItem {
+    active: boolean;
+    doubleOptIn: boolean;
+}
+export interface FunnelEmailTemplateChoice extends FunnelCatalogItem {
+    subject: string;
+    updatedAt: string | null;
+}
+export interface FunnelAssetChoice extends FunnelCatalogItem {
+    mimeType: string;
+    sizeBytes: number;
+    visibility: 'public';
+    publicUrl: string;
+    version: string | null;
+}
+export interface FunnelOwnerChoice extends FunnelCatalogItem {
+    active: true;
+}
+export interface FunnelBookingChoice extends FunnelCatalogItem {
+    site: string | null;
+    active: true;
+    requiresConfirmation: boolean;
+}
+export interface FunnelChoicePage<T> {
+    items: T[];
+    nextCursor: string | null;
+}
+export interface FunnelCatalog {
+    templates: {
+        id: FunnelTemplate;
+        label: string;
+        defaults: FunnelDraftDefinition;
+    }[];
+    sites: {
+        host: string;
+        label: string;
+    }[];
+    brand: FunnelBrandSnapshot | null;
+    choices: {
+        forms?: FunnelChoicePage<FunnelFormChoice>;
+        lists?: FunnelChoicePage<FunnelListChoice>;
+        emailTemplates?: FunnelChoicePage<FunnelEmailTemplateChoice>;
+        assets?: FunnelChoicePage<FunnelAssetChoice>;
+        owners?: FunnelChoicePage<FunnelOwnerChoice>;
+        bookingTypes?: FunnelChoicePage<FunnelBookingChoice>;
+    };
+    capabilities: {
+        managedPage: boolean;
+    };
+}
+export declare const FUNNEL_CATALOG_JSON_SCHEMA: Shape;
+export declare function parseFunnelCatalog(value: unknown): FunnelCatalog;
+export interface FunnelLaunchEvidence {
+    projectId: string;
+    orgId: string;
+    funnelId: string;
+    previewId: string;
+    versionId: string;
+    definitionRevision: number;
+    definitionDigest: string;
+    brandFingerprint: string;
+    resourceFingerprint: string;
+    entryDigest: string;
+    permissionDigest: string;
+    expiresAt: string;
+}
+export interface FunnelRollbackEvidence {
+    orgId: string;
+    projectId: string;
+    funnelId: string;
+    targetVersionId: string;
+    definitionRevision: number;
+    definitionDigest: string;
+    brandFingerprint: string;
+    resourceFingerprint: string;
+}
+export declare const FUNNEL_LAUNCH_EVIDENCE_JSON_SCHEMA: Shape;
+export declare function parseFunnelLaunchEvidence(value: unknown): FunnelLaunchEvidence;
+export declare const FUNNEL_ROLLBACK_EVIDENCE_JSON_SCHEMA: Shape;
+export declare function parseFunnelRollbackEvidence(value: unknown): FunnelRollbackEvidence;
+export declare const FUNNEL_PREVIEW_JSON_SCHEMA: Shape;
+export declare function parseFunnelPreview(value: unknown): FunnelPreview;
+export type FunnelEnrollmentState = 'waiting' | 'running' | 'completed' | 'exited' | 'needs_attention';
+export interface FunnelEnrollmentSummary {
+    id: string;
+    versionId: string;
+    state: FunnelEnrollmentState;
+    effectiveStatus: FunnelEnrollmentState | 'paused';
+    source: {
+        submissionId: string;
+        acceptedAt: string;
+    };
+    subject: {
+        kind: 'subscriber' | 'contact' | 'submission';
+        id: string;
+        displayLabel: string;
+    };
+    enteredAt: string;
+    nextRunAt: string | null;
+    exitCode: string | null;
+    stepsCompleted: number;
+    stepsTotal: number;
+    lastReceiptAt: string | null;
+}
+export interface FunnelTimeline {
+    items: {
+        executionId: string;
+        stepId: string;
+        type: FunnelStep['type'];
+        state: 'pending' | 'claimed' | 'queued' | 'admitted' | 'succeeded' | 'skipped' | 'uncertain' | 'failed';
+        dueAt: string | null;
+        occurredAt: string | null;
+        attempt: number;
+        reasonCode: string | null;
+        message: string;
+        receipt: {
+            domain: 'campaign_send' | 'subscriber_tag' | 'crm_task' | 'wait';
+            id: string | null;
+            state: string;
+        } | null;
+        canRetry: boolean;
+    }[];
+    nextCursor: string | null;
+    exit: {
+        code: string;
+        sourceType: string;
+        sourceId: string | null;
+        occurredAt: string;
+    } | null;
+}
+export declare const FUNNEL_SUMMARY_JSON_SCHEMA: Shape;
+export declare function parseFunnelSummary(value: unknown): FunnelSummary;
+export declare const FUNNEL_ENROLLMENT_JSON_SCHEMA: Shape;
+export declare function parseFunnelEnrollmentSummary(value: unknown): FunnelEnrollmentSummary;
+export declare const FUNNEL_TIMELINE_JSON_SCHEMA: Shape;
+export declare function parseFunnelTimeline(value: unknown): FunnelTimeline;
+export interface FunnelPublishedVersion {
+    versionId: string;
+    definitionRevision: number;
+    publishedAt: string;
+    brandFingerprint: string;
+    resourceFingerprint: string;
+    active: boolean;
+}
+export interface FunnelPublishedVersionDetail extends FunnelPublishedVersion {
+    rollbackEvidence: FunnelRollbackEvidence;
+}
+export declare const FUNNEL_VERSION_JSON_SCHEMA: Shape;
+export declare const FUNNEL_VERSION_DETAIL_JSON_SCHEMA: Shape;
+export declare function parseFunnelPublishedVersion(value: unknown): FunnelPublishedVersion;
+export declare function parseFunnelPublishedVersionDetail(value: unknown): FunnelPublishedVersionDetail;