@oxygen-agent/cli 1.365.3 → 1.575.19

package/node_modules/@oxygen/shared/dist/sequence-crm-events.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Canonical sequencer activity vocabulary for CRM event sync.
+ *
+ * The worker source selectors, workflow payload, API, CLI/MCP descriptors, and
+ * Launch UI all consume this catalog. A row is only added when the sequencer has
+ * a durable source ledger for it; this keeps the mapping UI from advertising an
+ * event that can never fire.
+ */
+export declare const SEQUENCE_CRM_EVENT_DEFINITIONS: readonly [{
+    readonly key: "linkedin_profile_visited";
+    readonly label: "LinkedIn profile visited";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_profile_visited_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["visit_profile"];
+    };
+}, {
+    readonly key: "linkedin_connection_sent";
+    readonly label: "LinkedIn connection sent";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_connection_sent_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["invite"];
+    };
+}, {
+    readonly key: "linkedin_connection_accepted";
+    readonly label: "LinkedIn connection accepted";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_connection_accepted_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["linkedin_connected"];
+    };
+}, {
+    readonly key: "linkedin_message_sent";
+    readonly label: "LinkedIn message sent";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_message_sent_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["message"];
+    };
+}, {
+    readonly key: "linkedin_inmail_sent";
+    readonly label: "LinkedIn InMail sent";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_inmail_sent_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["inmail"];
+    };
+}, {
+    readonly key: "linkedin_reply_received";
+    readonly label: "LinkedIn reply received";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_reply_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["linkedin_replied"];
+    };
+}, {
+    readonly key: "linkedin_followed";
+    readonly label: "LinkedIn profile followed";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_followed_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["follow"];
+    };
+}, {
+    readonly key: "linkedin_post_liked";
+    readonly label: "LinkedIn post liked";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_post_liked_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["like_post"];
+    };
+}, {
+    readonly key: "linkedin_post_commented";
+    readonly label: "LinkedIn post commented";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_post_commented_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["comment_post"];
+    };
+}, {
+    readonly key: "linkedin_connection_withdrawn";
+    readonly label: "LinkedIn connection withdrawn";
+    readonly group: "LinkedIn";
+    readonly defaultHubSpotProperty: "oxygen_last_linkedin_connection_withdrawn_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["withdraw_invite"];
+    };
+}, {
+    readonly key: "email_sent";
+    readonly label: "Email sent";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_sent_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["email_send", "email_reply"];
+    };
+    readonly additionalSources: readonly [{
+        readonly kind: "signal";
+        readonly values: readonly ["email_sent"];
+    }];
+}, {
+    readonly key: "email_campaign_enrolled";
+    readonly label: "Email campaign enrolled";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_campaign_enrolled_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["email_enroll"];
+    };
+}, {
+    readonly key: "email_campaign_moved";
+    readonly label: "Email campaign moved";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_campaign_moved_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["email_move"];
+    };
+}, {
+    readonly key: "email_campaign_stopped";
+    readonly label: "Email campaign stopped";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_campaign_stopped_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["email_stop"];
+    };
+}, {
+    readonly key: "email_opened";
+    readonly label: "Email opened";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_opened_at";
+    readonly source: {
+        readonly kind: "tracking";
+        readonly values: readonly ["open"];
+    };
+    readonly additionalSources: readonly [{
+        readonly kind: "signal";
+        readonly values: readonly ["email_opened"];
+    }];
+}, {
+    readonly key: "email_clicked";
+    readonly label: "Email link clicked";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_clicked_at";
+    readonly source: {
+        readonly kind: "tracking";
+        readonly values: readonly ["click"];
+    };
+    readonly additionalSources: readonly [{
+        readonly kind: "signal";
+        readonly values: readonly ["email_clicked"];
+    }];
+}, {
+    readonly key: "email_reply_received";
+    readonly label: "Email reply received";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_reply_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["email_replied"];
+    };
+}, {
+    readonly key: "email_bounced";
+    readonly label: "Email bounced";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_bounced_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["email_bounced"];
+    };
+    readonly additionalSources: readonly [{
+        readonly kind: "suppression";
+        readonly values: readonly ["hard_bounce"];
+    }];
+}, {
+    readonly key: "email_unsubscribed";
+    readonly label: "Email unsubscribed";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_unsubscribed_at";
+    readonly source: {
+        readonly kind: "suppression";
+        readonly values: readonly ["unsubscribe"];
+    };
+    readonly additionalSources: readonly [{
+        readonly kind: "signal";
+        readonly values: readonly ["email_unsubscribed"];
+    }];
+}, {
+    readonly key: "email_spam_complaint";
+    readonly label: "Email spam complaint";
+    readonly group: "Email";
+    readonly defaultHubSpotProperty: "oxygen_last_email_spam_complaint_at";
+    readonly source: {
+        readonly kind: "suppression";
+        readonly values: readonly ["complaint"];
+    };
+}, {
+    readonly key: "whatsapp_message_sent";
+    readonly label: "WhatsApp message sent";
+    readonly group: "WhatsApp";
+    readonly defaultHubSpotProperty: "oxygen_last_whatsapp_message_sent_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["whatsapp_message"];
+    };
+}, {
+    readonly key: "whatsapp_reply_received";
+    readonly label: "WhatsApp reply received";
+    readonly group: "WhatsApp";
+    readonly defaultHubSpotProperty: "oxygen_last_whatsapp_reply_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["whatsapp_replied"];
+    };
+}, {
+    readonly key: "call_task_created";
+    readonly label: "Call task created";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_call_task_created_at";
+    readonly source: {
+        readonly kind: "call_task";
+        readonly values: readonly ["created"];
+    };
+}, {
+    readonly key: "call_connected";
+    readonly label: "Call connected";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_call_connected_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["call_connected"];
+    };
+}, {
+    readonly key: "call_no_answer";
+    readonly label: "Call — no answer";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_call_no_answer_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["call_no_answer"];
+    };
+}, {
+    readonly key: "call_voicemail";
+    readonly label: "Call — voicemail";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_call_voicemail_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["call_voicemail"];
+    };
+}, {
+    readonly key: "meeting_booked";
+    readonly label: "Meeting booked";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_meeting_booked_at";
+    readonly source: {
+        readonly kind: "signal";
+        readonly values: readonly ["meeting_booked"];
+    };
+}, {
+    readonly key: "crm_task_created";
+    readonly label: "CRM task created";
+    readonly group: "Calls & CRM";
+    readonly defaultHubSpotProperty: "oxygen_last_crm_task_created_at";
+    readonly source: {
+        readonly kind: "action";
+        readonly values: readonly ["crm_task"];
+    };
+}];
+export type SequenceCrmEventDefinition = (typeof SEQUENCE_CRM_EVENT_DEFINITIONS)[number];
+export type SequenceCrmEventKey = SequenceCrmEventDefinition["key"];
+export type SequenceCrmEventGroup = SequenceCrmEventDefinition["group"];
+export declare const SEQUENCE_CRM_EVENT_KEYS: readonly SequenceCrmEventKey[];
+export declare const SEQUENCE_HUBSPOT_EVENT_SYNC_TEMPLATE_ID = "sequencer-hubspot-event-sync";
+export declare const SEQUENCE_WORKFLOW_EVENT_SOURCE = "sequencer";
+export declare const SEQUENCE_CONTACT_ACTIVITY_EVENT = "contact_activity";
+export declare const SEQUENCE_HUBSPOT_LINKEDIN_IDENTITY_PROPERTY = "oxygen_linkedin_url";
+export declare const DEFAULT_SEQUENCE_HUBSPOT_EVENT_MAPPINGS: Readonly<Record<"linkedin_profile_visited" | "linkedin_connection_sent" | "linkedin_connection_accepted" | "linkedin_message_sent" | "linkedin_inmail_sent" | "linkedin_reply_received" | "linkedin_followed" | "linkedin_post_liked" | "linkedin_post_commented" | "linkedin_connection_withdrawn" | "email_sent" | "email_campaign_enrolled" | "email_campaign_moved" | "email_campaign_stopped" | "email_opened" | "email_clicked" | "email_reply_received" | "email_bounced" | "email_unsubscribed" | "email_spam_complaint" | "whatsapp_message_sent" | "whatsapp_reply_received" | "call_task_created" | "call_connected" | "call_no_answer" | "call_voicemail" | "meeting_booked" | "crm_task_created", string>>;
+export declare function isSequenceCrmEventKey(value: unknown): value is SequenceCrmEventKey;

package/node_modules/@oxygen/shared/dist/sequence-crm-events.js

@@ -0,0 +1,224 @@
+/**
+ * Canonical sequencer activity vocabulary for CRM event sync.
+ *
+ * The worker source selectors, workflow payload, API, CLI/MCP descriptors, and
+ * Launch UI all consume this catalog. A row is only added when the sequencer has
+ * a durable source ledger for it; this keeps the mapping UI from advertising an
+ * event that can never fire.
+ */
+export const SEQUENCE_CRM_EVENT_DEFINITIONS = [
+    {
+        key: "linkedin_profile_visited",
+        label: "LinkedIn profile visited",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_profile_visited_at",
+        source: { kind: "action", values: ["visit_profile"] },
+    },
+    {
+        key: "linkedin_connection_sent",
+        label: "LinkedIn connection sent",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_connection_sent_at",
+        source: { kind: "action", values: ["invite"] },
+    },
+    {
+        key: "linkedin_connection_accepted",
+        label: "LinkedIn connection accepted",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_connection_accepted_at",
+        source: { kind: "signal", values: ["linkedin_connected"] },
+    },
+    {
+        key: "linkedin_message_sent",
+        label: "LinkedIn message sent",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_message_sent_at",
+        source: { kind: "action", values: ["message"] },
+    },
+    {
+        key: "linkedin_inmail_sent",
+        label: "LinkedIn InMail sent",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_inmail_sent_at",
+        source: { kind: "action", values: ["inmail"] },
+    },
+    {
+        key: "linkedin_reply_received",
+        label: "LinkedIn reply received",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_reply_at",
+        source: { kind: "signal", values: ["linkedin_replied"] },
+    },
+    {
+        key: "linkedin_followed",
+        label: "LinkedIn profile followed",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_followed_at",
+        source: { kind: "action", values: ["follow"] },
+    },
+    {
+        key: "linkedin_post_liked",
+        label: "LinkedIn post liked",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_post_liked_at",
+        source: { kind: "action", values: ["like_post"] },
+    },
+    {
+        key: "linkedin_post_commented",
+        label: "LinkedIn post commented",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_post_commented_at",
+        source: { kind: "action", values: ["comment_post"] },
+    },
+    {
+        key: "linkedin_connection_withdrawn",
+        label: "LinkedIn connection withdrawn",
+        group: "LinkedIn",
+        defaultHubSpotProperty: "oxygen_last_linkedin_connection_withdrawn_at",
+        source: { kind: "action", values: ["withdraw_invite"] },
+    },
+    {
+        key: "email_sent",
+        label: "Email sent",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_sent_at",
+        source: { kind: "action", values: ["email_send", "email_reply"] },
+        additionalSources: [{ kind: "signal", values: ["email_sent"] }],
+    },
+    {
+        key: "email_campaign_enrolled",
+        label: "Email campaign enrolled",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_campaign_enrolled_at",
+        source: { kind: "action", values: ["email_enroll"] },
+    },
+    {
+        key: "email_campaign_moved",
+        label: "Email campaign moved",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_campaign_moved_at",
+        source: { kind: "action", values: ["email_move"] },
+    },
+    {
+        key: "email_campaign_stopped",
+        label: "Email campaign stopped",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_campaign_stopped_at",
+        source: { kind: "action", values: ["email_stop"] },
+    },
+    {
+        key: "email_opened",
+        label: "Email opened",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_opened_at",
+        source: { kind: "tracking", values: ["open"] },
+        additionalSources: [{ kind: "signal", values: ["email_opened"] }],
+    },
+    {
+        key: "email_clicked",
+        label: "Email link clicked",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_clicked_at",
+        source: { kind: "tracking", values: ["click"] },
+        additionalSources: [{ kind: "signal", values: ["email_clicked"] }],
+    },
+    {
+        key: "email_reply_received",
+        label: "Email reply received",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_reply_at",
+        source: { kind: "signal", values: ["email_replied"] },
+    },
+    {
+        key: "email_bounced",
+        label: "Email bounced",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_bounced_at",
+        source: { kind: "signal", values: ["email_bounced"] },
+        additionalSources: [{ kind: "suppression", values: ["hard_bounce"] }],
+    },
+    {
+        key: "email_unsubscribed",
+        label: "Email unsubscribed",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_unsubscribed_at",
+        source: { kind: "suppression", values: ["unsubscribe"] },
+        additionalSources: [{ kind: "signal", values: ["email_unsubscribed"] }],
+    },
+    {
+        key: "email_spam_complaint",
+        label: "Email spam complaint",
+        group: "Email",
+        defaultHubSpotProperty: "oxygen_last_email_spam_complaint_at",
+        source: { kind: "suppression", values: ["complaint"] },
+    },
+    {
+        key: "whatsapp_message_sent",
+        label: "WhatsApp message sent",
+        group: "WhatsApp",
+        defaultHubSpotProperty: "oxygen_last_whatsapp_message_sent_at",
+        source: { kind: "action", values: ["whatsapp_message"] },
+    },
+    {
+        key: "whatsapp_reply_received",
+        label: "WhatsApp reply received",
+        group: "WhatsApp",
+        defaultHubSpotProperty: "oxygen_last_whatsapp_reply_at",
+        source: { kind: "signal", values: ["whatsapp_replied"] },
+    },
+    {
+        key: "call_task_created",
+        label: "Call task created",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_call_task_created_at",
+        source: { kind: "call_task", values: ["created"] },
+    },
+    {
+        key: "call_connected",
+        label: "Call connected",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_call_connected_at",
+        source: { kind: "signal", values: ["call_connected"] },
+    },
+    {
+        key: "call_no_answer",
+        label: "Call — no answer",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_call_no_answer_at",
+        source: { kind: "signal", values: ["call_no_answer"] },
+    },
+    {
+        key: "call_voicemail",
+        label: "Call — voicemail",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_call_voicemail_at",
+        source: { kind: "signal", values: ["call_voicemail"] },
+    },
+    {
+        key: "meeting_booked",
+        label: "Meeting booked",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_meeting_booked_at",
+        source: { kind: "signal", values: ["meeting_booked"] },
+    },
+    {
+        key: "crm_task_created",
+        label: "CRM task created",
+        group: "Calls & CRM",
+        defaultHubSpotProperty: "oxygen_last_crm_task_created_at",
+        source: { kind: "action", values: ["crm_task"] },
+    },
+];
+export const SEQUENCE_CRM_EVENT_KEYS = SEQUENCE_CRM_EVENT_DEFINITIONS.map((definition) => definition.key);
+export const SEQUENCE_HUBSPOT_EVENT_SYNC_TEMPLATE_ID = "sequencer-hubspot-event-sync";
+export const SEQUENCE_WORKFLOW_EVENT_SOURCE = "sequencer";
+export const SEQUENCE_CONTACT_ACTIVITY_EVENT = "contact_activity";
+export const SEQUENCE_HUBSPOT_LINKEDIN_IDENTITY_PROPERTY = "oxygen_linkedin_url";
+export const DEFAULT_SEQUENCE_HUBSPOT_EVENT_MAPPINGS = Object.freeze(Object.fromEntries(SEQUENCE_CRM_EVENT_DEFINITIONS.map((definition) => [
+    definition.key,
+    definition.defaultHubSpotProperty,
+])));
+export function isSequenceCrmEventKey(value) {
+    return (typeof value === "string"
+        && SEQUENCE_CRM_EVENT_KEYS.includes(value));
+}

package/node_modules/@oxygen/shared/dist/sequence-template.d.ts

@@ -3,7 +3,7 @@
  * step (LinkedIn message / InMail / invite note, native email subject/body,
  * WhatsApp message, Instantly custom fields) against a lead's row values in a
  * SINGLE deterministic pass. Beyond the original `{{column}}` substitution it
- * supports three composable, nestable constructs:
+ * supports four composable, nestable constructs:
  *
  *  1. Inline fallback — `{{column|fallback text}}` renders the column's value, or
  *     the literal fallback text when the column is missing/empty. `{{column}}`
@@ -17,6 +17,17 @@
  *     `{% if column contains "x" %}A{% endif %}` (case-insensitive substring).
  *     The `{% else %}` arm and the operator/quoted value are optional; either
  *     branch may nest any construct.
+ *  4. Bare spintax — `{Hi|Hey|Hello}` (the industry-standard form users bring
+ *     from Instantly/Smartlead/Lemlist), nestable to MAX_SPINTAX_DEPTH:
+ *     `{Would {Tuesday|Thursday} work|How does next week look}`. A lone `{…}`
+ *     region is spintax ONLY when it contains at least one top-level `|` —
+ *     literal braces (CSS in body_html, JSON, code) render untouched. Options
+ *     render exactly as written (no trimming, unlike `{{RANDOM|…}}`) and may
+ *     nest any construct in either direction (`{{RANDOM|{a|b}|c}}` works too).
+ *     Sibling behavior deliberately differs from `{{RANDOM|…}}`: identical
+ *     RANDOM blocks in one template always pick the SAME option (back-compat),
+ *     while repeated bare blocks spin independently via an occurrence index —
+ *     the deliverability point of spintax.
  *
  * Determinism contract: the SAME (template, values, seed) always renders
  * byte-identically. The sequencer dispatch passes an enrollment-scoped seed so a
@@ -43,6 +54,11 @@ export type RenderTemplateOptions = {
  * sequences.ts (which imports it from this module).
  */
 export declare function hashVariantKey(value: string): number;
+/**
+ * Bare-spintax nesting cap enforced at WRITE time by spintaxSyntaxIssues — legit
+ * stored copy therefore never reaches the render-time MAX_RENDER_DEPTH guard.
+ */
+export declare const MAX_SPINTAX_DEPTH = 10;
 /**
  * Render a sequence-copy template against a lead's row values. Supports
  * `{{column}}` substitution, `{{column|fallback}}`, `{{RANDOM|…}}` spintax, and
@@ -58,3 +74,28 @@ export declare function renderTemplate(template: string, values: Record<string,
  * nested construct still surfaces. Deduplicated.
  */
 export declare function templateColumnKeys(template: string): string[];
+/**
+ * Whether a template contains any spintax — `{{RANDOM|…}}` or a valid bare
+ * `{a|b}` block (closed, with a top-level `|`), at any nesting position. Cheap
+ * pure scan used by the start-preview "spintax is not an A/B test" advisory.
+ */
+export declare function templateHasSpintax(template: string): boolean;
+/**
+ * Write-time lint of BARE spintax grammar. Returns human-readable issues for:
+ * an unclosed bare block that contains a top-level `|` (the renderer would emit
+ * it literally — never intended), an empty option (`{a||b}`, `{|a}`, `{a|}`),
+ * and nesting beyond MAX_SPINTAX_DEPTH. Deliberately silent on `{{RANDOM|…}}`
+ * malformations — stored sequences with a sloppy RANDOM block must keep
+ * re-validating (those get soft preview warnings instead). Literal braces
+ * without a top-level pipe (CSS/JSON/copy) are never flagged, mirroring the
+ * renderer's spintax-only-iff-top-level-pipe rule.
+ */
+export declare function spintaxSyntaxIssues(template: string): string[];
+/**
+ * Soft preview-time warnings for `{{RANDOM|…}}` malformations: a single-option
+ * block (always renders the same text) and an empty option (one spin renders
+ * nothing). Deliberately NOT part of write-time validation — sequences that
+ * already store such blocks must keep re-validating unchanged; the start
+ * preview surfaces these as advisories instead.
+ */
+export declare function randomSpintaxWarnings(template: string): string[];