awaitly-visualizer 1.0.0

package/dist/types-BIZSmXif.d.ts

@@ -0,0 +1,350 @@
+import { AsyncResult } from 'awaitly';
+import { WorkflowEvent } from 'awaitly/workflow';
+import { W as WorkflowIR, M as MermaidInkExportOptions, U as UrlGeneratorOptions, S as ScopeStartEvent, e as ScopeEndEvent, b as DecisionStartEvent, c as DecisionBranchEvent, d as DecisionEndEvent } from './url-PkfQz4V5.js';
+
+/**
+ * Mermaid.ink URL Generation
+ *
+ * Generates shareable URLs for mermaid.ink diagram rendering service.
+ * Alternative to Kroki with additional features like themes, background colors, and sizing.
+ *
+ * @see https://mermaid.ink/
+ */
+
+/**
+ * Supported mermaid.ink output formats.
+ */
+type MermaidInkFormat = "svg" | "img" | "pdf";
+/**
+ * Image type for /img endpoint.
+ */
+type MermaidInkImageType = "jpeg" | "png" | "webp";
+/**
+ * Mermaid.ink built-in themes.
+ */
+type MermaidInkTheme = "default" | "neutral" | "dark" | "forest";
+/**
+ * PDF paper sizes.
+ */
+type MermaidInkPaperSize = "letter" | "legal" | "tabloid" | "ledger" | "a0" | "a1" | "a2" | "a3" | "a4" | "a5" | "a6";
+/**
+ * Options for mermaid.ink URL generation.
+ */
+interface MermaidInkOptions {
+    /** Base URL for mermaid.ink service (default: https://mermaid.ink) */
+    baseUrl?: string;
+    /**
+     * Background color.
+     * - Hex color without #: "FF0000" for red
+     * - Named color with ! prefix: "!white", "!black"
+     */
+    bgColor?: string;
+    /** Mermaid theme */
+    theme?: MermaidInkTheme;
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** Image scale (1-3). Only applies if width or height is set */
+    scale?: number;
+    /** Image type for /img endpoint (default: jpeg) */
+    imageType?: MermaidInkImageType;
+    /** Fit PDF size to diagram size */
+    fit?: boolean;
+    /** Paper size for PDF (default: a4) */
+    paper?: MermaidInkPaperSize;
+    /** Landscape orientation for PDF */
+    landscape?: boolean;
+}
+/**
+ * Encode text for mermaid.ink URL.
+ * Uses pako deflate compression + base64 encoding with "pako:" prefix.
+ *
+ * @param text - The Mermaid diagram text
+ * @returns Encoded string with "pako:" prefix
+ */
+declare function encodeForMermaidInk(text: string): string;
+/**
+ * Build a mermaid.ink URL for the given Mermaid diagram text.
+ *
+ * @param format - Output format (svg, img, pdf)
+ * @param text - The Mermaid diagram text
+ * @param options - Optional mermaid.ink options (MermaidInkOptions or MermaidInkExportOptions)
+ * @returns The mermaid.ink URL
+ *
+ * @example
+ * ```typescript
+ * const url = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B');
+ * // => "https://mermaid.ink/svg/pako:eNpLzs8tyc9NTgQADsMDmA"
+ *
+ * const darkUrl = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B', {
+ *   theme: 'dark',
+ *   bgColor: '1b1b1f'
+ * });
+ * // => "https://mermaid.ink/svg/pako:eNp...?theme=dark&bgColor=1b1b1f"
+ *
+ * // With MermaidInkExportOptions
+ * const exportUrl = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B', {
+ *   provider: 'mermaid-ink',
+ *   mermaidTheme: 'dark',
+ *   background: '1b1b1f'
+ * });
+ * ```
+ */
+declare function buildMermaidInkUrl(format: MermaidInkFormat, text: string, options?: MermaidInkOptions | MermaidInkExportOptions): string;
+/**
+ * Generate a mermaid.ink URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param format - Output format (default: 'svg')
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink URL
+ *
+ * @example
+ * ```typescript
+ * const url = toMermaidInkUrl(workflowIR, 'svg');
+ * // Share this URL - image renders when viewed
+ *
+ * const darkUrl = toMermaidInkUrl(workflowIR, 'svg', { theme: 'dark' });
+ * ```
+ */
+declare function toMermaidInkUrl(ir: WorkflowIR, format?: MermaidInkFormat, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink SVG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink SVG URL
+ *
+ * @example
+ * ```typescript
+ * const svgUrl = toMermaidInkSvgUrl(workflowIR);
+ * // => "https://mermaid.ink/svg/pako:eNp..."
+ *
+ * const darkSvg = toMermaidInkSvgUrl(workflowIR, { theme: 'dark' });
+ * ```
+ */
+declare function toMermaidInkSvgUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink PNG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink PNG URL
+ *
+ * @example
+ * ```typescript
+ * const pngUrl = toMermaidInkPngUrl(workflowIR);
+ * // => "https://mermaid.ink/img/pako:eNp...?type=png"
+ *
+ * const scaledPng = toMermaidInkPngUrl(workflowIR, { width: 800, scale: 2 });
+ * ```
+ */
+declare function toMermaidInkPngUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink JPEG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink JPEG URL
+ */
+declare function toMermaidInkJpegUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink WebP URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink WebP URL
+ */
+declare function toMermaidInkWebpUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink PDF URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options (fit, paper, landscape)
+ * @returns The mermaid.ink PDF URL
+ *
+ * @example
+ * ```typescript
+ * // Fit PDF to diagram size
+ * const fitPdf = toMermaidInkPdfUrl(workflowIR, { fit: true });
+ *
+ * // A3 landscape
+ * const a3Pdf = toMermaidInkPdfUrl(workflowIR, { paper: 'a3', landscape: true });
+ * ```
+ */
+declare function toMermaidInkPdfUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Mermaid.ink URL Generator interface.
+ */
+interface MermaidInkGenerator {
+    /** Generate URL with specified format */
+    toUrl(ir: WorkflowIR, format: MermaidInkFormat): string;
+    /** Generate SVG URL */
+    toSvgUrl(ir: WorkflowIR): string;
+    /** Generate PNG URL */
+    toPngUrl(ir: WorkflowIR): string;
+    /** Generate JPEG URL */
+    toJpegUrl(ir: WorkflowIR): string;
+    /** Generate WebP URL */
+    toWebpUrl(ir: WorkflowIR): string;
+    /** Generate PDF URL */
+    toPdfUrl(ir: WorkflowIR): string;
+    /** Get the configured base URL */
+    getBaseUrl(): string;
+    /** Get the configured options */
+    getOptions(): MermaidInkOptions;
+}
+/**
+ * Create a mermaid.ink URL generator with default options.
+ * Useful for consistent theming across all generated URLs.
+ *
+ * @param options - Default mermaid.ink options applied to all URLs
+ * @returns A mermaid.ink URL generator instance
+ *
+ * @example
+ * ```typescript
+ * // Create generator with dark theme defaults
+ * const generator = createMermaidInkGenerator({
+ *   theme: 'dark',
+ *   bgColor: '1b1b1f',
+ * });
+ *
+ * // All URLs will use dark theme
+ * const svgUrl = generator.toSvgUrl(workflowIR);
+ * const pngUrl = generator.toPngUrl(workflowIR);
+ *
+ * // Self-hosted mermaid.ink
+ * const privateGenerator = createMermaidInkGenerator({
+ *   baseUrl: 'https://mermaid.internal.company.com',
+ * });
+ * ```
+ */
+declare function createMermaidInkGenerator(options?: MermaidInkOptions): MermaidInkGenerator;
+
+/**
+ * Notifier Types
+ *
+ * Interfaces for notification systems that push workflow visualizations
+ * to external services like Slack, Discord, or custom webhooks.
+ */
+
+/**
+ * Extended event types that the live session can handle.
+ * Includes both core WorkflowEvent and visualizer-specific events.
+ */
+type LiveSessionEvent = WorkflowEvent<unknown> | ScopeStartEvent | ScopeEndEvent | DecisionStartEvent | DecisionBranchEvent | DecisionEndEvent;
+/**
+ * Error types for notifier operations.
+ */
+type NotifyError = "SEND_FAILED" | "INVALID_CONFIG";
+/**
+ * Diagram rendering provider.
+ */
+type DiagramProvider = "kroki" | "mermaid-ink";
+/**
+ * Options for Kroki provider.
+ */
+interface KrokiProviderOptions extends UrlGeneratorOptions {
+    /** Provider type */
+    provider: "kroki";
+}
+/**
+ * Options for mermaid.ink provider.
+ */
+interface MermaidInkProviderOptions extends MermaidInkOptions {
+    /** Provider type */
+    provider: "mermaid-ink";
+}
+/**
+ * Combined provider options.
+ */
+type ProviderOptions = KrokiProviderOptions | MermaidInkProviderOptions;
+/**
+ * Status of a workflow when finalized.
+ */
+type WorkflowStatus = "completed" | "failed" | "cancelled";
+/**
+ * Options for creating a live session.
+ */
+interface LiveSessionOptions {
+    /** Title for the notification (e.g., "Order #123 Processing") */
+    title: string;
+    /** Debounce interval in milliseconds (default: 500) */
+    debounceMs?: number;
+    /** Max time between posts even during constant updates (default: 5000) */
+    maxWaitMs?: number;
+    /** Additional metadata to include in notifications */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Live session for real-time workflow updates.
+ *
+ * Behavior:
+ * - First `update()`: Posts new message with Kroki URL
+ * - Subsequent `update()`: Edits same message (debounced)
+ * - `finalize()`: Posts final state, marks session complete
+ * - `cancel()`: Aborts session, optionally deletes partial message
+ */
+interface LiveSession {
+    /** Update the visualization (debounced) */
+    update(eventOrIr: LiveSessionEvent | WorkflowIR): void;
+    /** Finalize the session with final status */
+    finalize(status?: WorkflowStatus): Promise<void>;
+    /** Cancel the session, optionally deleting the message */
+    cancel(): void;
+    /** Get the current session ID (e.g., message timestamp for Slack) */
+    getSessionId(): string | undefined;
+    /** Check if the session is still active */
+    isActive(): boolean;
+}
+/**
+ * Notifier interface for pushing workflow visualizations.
+ */
+interface Notifier {
+    /** Send a one-time notification with the current workflow state */
+    notify(ir: WorkflowIR, options?: NotifyOptions): AsyncResult<string | undefined, NotifyError>;
+    /** Create a live session for real-time updates */
+    createLive(options: LiveSessionOptions): LiveSession;
+    /** Get the notifier type (e.g., "slack", "discord", "webhook") */
+    getType(): string;
+}
+/**
+ * Options for one-time notifications.
+ */
+interface NotifyOptions {
+    /** Title for the notification */
+    title?: string;
+    /** Additional text content */
+    text?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Base options for all notifiers.
+ */
+interface BaseNotifierOptions {
+    /** Debounce interval in milliseconds for live sessions (default: 500) */
+    debounceMs?: number;
+    /** Max wait between updates during constant churn (default: 5000) */
+    maxWaitMs?: number;
+    /**
+     * Diagram rendering provider configuration.
+     * REQUIRED - no silent default to prevent surprise network calls.
+     *
+     * @example
+     * ```typescript
+     * // Use Kroki
+     * { provider: 'kroki' }
+     *
+     * // Use mermaid.ink with dark theme
+     * { provider: 'mermaid-ink', theme: 'dark', bgColor: '1b1b1f' }
+     *
+     * // Use self-hosted Kroki
+     * { provider: 'kroki', baseUrl: 'https://kroki.internal' }
+     * ```
+     */
+    diagramProvider: ProviderOptions;
+}
+
+export { type BaseNotifierOptions as B, type DiagramProvider as D, type KrokiProviderOptions as K, type MermaidInkFormat as M, type Notifier as N, type ProviderOptions as P, type WorkflowStatus as W, type MermaidInkGenerator as a, type MermaidInkImageType as b, type MermaidInkOptions as c, type MermaidInkPaperSize as d, type MermaidInkProviderOptions as e, type MermaidInkTheme as f, buildMermaidInkUrl as g, createMermaidInkGenerator as h, encodeForMermaidInk as i, toMermaidInkPdfUrl as j, toMermaidInkPngUrl as k, toMermaidInkSvgUrl as l, toMermaidInkUrl as m, toMermaidInkWebpUrl as n, toMermaidInkJpegUrl as t };

package/dist/types-BnWc9Wlr.d.cts

@@ -0,0 +1,350 @@
+import { AsyncResult } from 'awaitly';
+import { WorkflowEvent } from 'awaitly/workflow';
+import { W as WorkflowIR, M as MermaidInkExportOptions, U as UrlGeneratorOptions, S as ScopeStartEvent, e as ScopeEndEvent, b as DecisionStartEvent, c as DecisionBranchEvent, d as DecisionEndEvent } from './url-PkfQz4V5.cjs';
+
+/**
+ * Mermaid.ink URL Generation
+ *
+ * Generates shareable URLs for mermaid.ink diagram rendering service.
+ * Alternative to Kroki with additional features like themes, background colors, and sizing.
+ *
+ * @see https://mermaid.ink/
+ */
+
+/**
+ * Supported mermaid.ink output formats.
+ */
+type MermaidInkFormat = "svg" | "img" | "pdf";
+/**
+ * Image type for /img endpoint.
+ */
+type MermaidInkImageType = "jpeg" | "png" | "webp";
+/**
+ * Mermaid.ink built-in themes.
+ */
+type MermaidInkTheme = "default" | "neutral" | "dark" | "forest";
+/**
+ * PDF paper sizes.
+ */
+type MermaidInkPaperSize = "letter" | "legal" | "tabloid" | "ledger" | "a0" | "a1" | "a2" | "a3" | "a4" | "a5" | "a6";
+/**
+ * Options for mermaid.ink URL generation.
+ */
+interface MermaidInkOptions {
+    /** Base URL for mermaid.ink service (default: https://mermaid.ink) */
+    baseUrl?: string;
+    /**
+     * Background color.
+     * - Hex color without #: "FF0000" for red
+     * - Named color with ! prefix: "!white", "!black"
+     */
+    bgColor?: string;
+    /** Mermaid theme */
+    theme?: MermaidInkTheme;
+    /** Image width in pixels */
+    width?: number;
+    /** Image height in pixels */
+    height?: number;
+    /** Image scale (1-3). Only applies if width or height is set */
+    scale?: number;
+    /** Image type for /img endpoint (default: jpeg) */
+    imageType?: MermaidInkImageType;
+    /** Fit PDF size to diagram size */
+    fit?: boolean;
+    /** Paper size for PDF (default: a4) */
+    paper?: MermaidInkPaperSize;
+    /** Landscape orientation for PDF */
+    landscape?: boolean;
+}
+/**
+ * Encode text for mermaid.ink URL.
+ * Uses pako deflate compression + base64 encoding with "pako:" prefix.
+ *
+ * @param text - The Mermaid diagram text
+ * @returns Encoded string with "pako:" prefix
+ */
+declare function encodeForMermaidInk(text: string): string;
+/**
+ * Build a mermaid.ink URL for the given Mermaid diagram text.
+ *
+ * @param format - Output format (svg, img, pdf)
+ * @param text - The Mermaid diagram text
+ * @param options - Optional mermaid.ink options (MermaidInkOptions or MermaidInkExportOptions)
+ * @returns The mermaid.ink URL
+ *
+ * @example
+ * ```typescript
+ * const url = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B');
+ * // => "https://mermaid.ink/svg/pako:eNpLzs8tyc9NTgQADsMDmA"
+ *
+ * const darkUrl = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B', {
+ *   theme: 'dark',
+ *   bgColor: '1b1b1f'
+ * });
+ * // => "https://mermaid.ink/svg/pako:eNp...?theme=dark&bgColor=1b1b1f"
+ *
+ * // With MermaidInkExportOptions
+ * const exportUrl = buildMermaidInkUrl('svg', 'flowchart TD\n  A-->B', {
+ *   provider: 'mermaid-ink',
+ *   mermaidTheme: 'dark',
+ *   background: '1b1b1f'
+ * });
+ * ```
+ */
+declare function buildMermaidInkUrl(format: MermaidInkFormat, text: string, options?: MermaidInkOptions | MermaidInkExportOptions): string;
+/**
+ * Generate a mermaid.ink URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param format - Output format (default: 'svg')
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink URL
+ *
+ * @example
+ * ```typescript
+ * const url = toMermaidInkUrl(workflowIR, 'svg');
+ * // Share this URL - image renders when viewed
+ *
+ * const darkUrl = toMermaidInkUrl(workflowIR, 'svg', { theme: 'dark' });
+ * ```
+ */
+declare function toMermaidInkUrl(ir: WorkflowIR, format?: MermaidInkFormat, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink SVG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink SVG URL
+ *
+ * @example
+ * ```typescript
+ * const svgUrl = toMermaidInkSvgUrl(workflowIR);
+ * // => "https://mermaid.ink/svg/pako:eNp..."
+ *
+ * const darkSvg = toMermaidInkSvgUrl(workflowIR, { theme: 'dark' });
+ * ```
+ */
+declare function toMermaidInkSvgUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink PNG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink PNG URL
+ *
+ * @example
+ * ```typescript
+ * const pngUrl = toMermaidInkPngUrl(workflowIR);
+ * // => "https://mermaid.ink/img/pako:eNp...?type=png"
+ *
+ * const scaledPng = toMermaidInkPngUrl(workflowIR, { width: 800, scale: 2 });
+ * ```
+ */
+declare function toMermaidInkPngUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink JPEG URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink JPEG URL
+ */
+declare function toMermaidInkJpegUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink WebP URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options
+ * @returns The mermaid.ink WebP URL
+ */
+declare function toMermaidInkWebpUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Generate a mermaid.ink PDF URL from workflow IR.
+ *
+ * @param ir - Workflow intermediate representation
+ * @param options - Optional mermaid.ink options (fit, paper, landscape)
+ * @returns The mermaid.ink PDF URL
+ *
+ * @example
+ * ```typescript
+ * // Fit PDF to diagram size
+ * const fitPdf = toMermaidInkPdfUrl(workflowIR, { fit: true });
+ *
+ * // A3 landscape
+ * const a3Pdf = toMermaidInkPdfUrl(workflowIR, { paper: 'a3', landscape: true });
+ * ```
+ */
+declare function toMermaidInkPdfUrl(ir: WorkflowIR, options?: MermaidInkOptions): string;
+/**
+ * Mermaid.ink URL Generator interface.
+ */
+interface MermaidInkGenerator {
+    /** Generate URL with specified format */
+    toUrl(ir: WorkflowIR, format: MermaidInkFormat): string;
+    /** Generate SVG URL */
+    toSvgUrl(ir: WorkflowIR): string;
+    /** Generate PNG URL */
+    toPngUrl(ir: WorkflowIR): string;
+    /** Generate JPEG URL */
+    toJpegUrl(ir: WorkflowIR): string;
+    /** Generate WebP URL */
+    toWebpUrl(ir: WorkflowIR): string;
+    /** Generate PDF URL */
+    toPdfUrl(ir: WorkflowIR): string;
+    /** Get the configured base URL */
+    getBaseUrl(): string;
+    /** Get the configured options */
+    getOptions(): MermaidInkOptions;
+}
+/**
+ * Create a mermaid.ink URL generator with default options.
+ * Useful for consistent theming across all generated URLs.
+ *
+ * @param options - Default mermaid.ink options applied to all URLs
+ * @returns A mermaid.ink URL generator instance
+ *
+ * @example
+ * ```typescript
+ * // Create generator with dark theme defaults
+ * const generator = createMermaidInkGenerator({
+ *   theme: 'dark',
+ *   bgColor: '1b1b1f',
+ * });
+ *
+ * // All URLs will use dark theme
+ * const svgUrl = generator.toSvgUrl(workflowIR);
+ * const pngUrl = generator.toPngUrl(workflowIR);
+ *
+ * // Self-hosted mermaid.ink
+ * const privateGenerator = createMermaidInkGenerator({
+ *   baseUrl: 'https://mermaid.internal.company.com',
+ * });
+ * ```
+ */
+declare function createMermaidInkGenerator(options?: MermaidInkOptions): MermaidInkGenerator;
+
+/**
+ * Notifier Types
+ *
+ * Interfaces for notification systems that push workflow visualizations
+ * to external services like Slack, Discord, or custom webhooks.
+ */
+
+/**
+ * Extended event types that the live session can handle.
+ * Includes both core WorkflowEvent and visualizer-specific events.
+ */
+type LiveSessionEvent = WorkflowEvent<unknown> | ScopeStartEvent | ScopeEndEvent | DecisionStartEvent | DecisionBranchEvent | DecisionEndEvent;
+/**
+ * Error types for notifier operations.
+ */
+type NotifyError = "SEND_FAILED" | "INVALID_CONFIG";
+/**
+ * Diagram rendering provider.
+ */
+type DiagramProvider = "kroki" | "mermaid-ink";
+/**
+ * Options for Kroki provider.
+ */
+interface KrokiProviderOptions extends UrlGeneratorOptions {
+    /** Provider type */
+    provider: "kroki";
+}
+/**
+ * Options for mermaid.ink provider.
+ */
+interface MermaidInkProviderOptions extends MermaidInkOptions {
+    /** Provider type */
+    provider: "mermaid-ink";
+}
+/**
+ * Combined provider options.
+ */
+type ProviderOptions = KrokiProviderOptions | MermaidInkProviderOptions;
+/**
+ * Status of a workflow when finalized.
+ */
+type WorkflowStatus = "completed" | "failed" | "cancelled";
+/**
+ * Options for creating a live session.
+ */
+interface LiveSessionOptions {
+    /** Title for the notification (e.g., "Order #123 Processing") */
+    title: string;
+    /** Debounce interval in milliseconds (default: 500) */
+    debounceMs?: number;
+    /** Max time between posts even during constant updates (default: 5000) */
+    maxWaitMs?: number;
+    /** Additional metadata to include in notifications */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Live session for real-time workflow updates.
+ *
+ * Behavior:
+ * - First `update()`: Posts new message with Kroki URL
+ * - Subsequent `update()`: Edits same message (debounced)
+ * - `finalize()`: Posts final state, marks session complete
+ * - `cancel()`: Aborts session, optionally deletes partial message
+ */
+interface LiveSession {
+    /** Update the visualization (debounced) */
+    update(eventOrIr: LiveSessionEvent | WorkflowIR): void;
+    /** Finalize the session with final status */
+    finalize(status?: WorkflowStatus): Promise<void>;
+    /** Cancel the session, optionally deleting the message */
+    cancel(): void;
+    /** Get the current session ID (e.g., message timestamp for Slack) */
+    getSessionId(): string | undefined;
+    /** Check if the session is still active */
+    isActive(): boolean;
+}
+/**
+ * Notifier interface for pushing workflow visualizations.
+ */
+interface Notifier {
+    /** Send a one-time notification with the current workflow state */
+    notify(ir: WorkflowIR, options?: NotifyOptions): AsyncResult<string | undefined, NotifyError>;
+    /** Create a live session for real-time updates */
+    createLive(options: LiveSessionOptions): LiveSession;
+    /** Get the notifier type (e.g., "slack", "discord", "webhook") */
+    getType(): string;
+}
+/**
+ * Options for one-time notifications.
+ */
+interface NotifyOptions {
+    /** Title for the notification */
+    title?: string;
+    /** Additional text content */
+    text?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Base options for all notifiers.
+ */
+interface BaseNotifierOptions {
+    /** Debounce interval in milliseconds for live sessions (default: 500) */
+    debounceMs?: number;
+    /** Max wait between updates during constant churn (default: 5000) */
+    maxWaitMs?: number;
+    /**
+     * Diagram rendering provider configuration.
+     * REQUIRED - no silent default to prevent surprise network calls.
+     *
+     * @example
+     * ```typescript
+     * // Use Kroki
+     * { provider: 'kroki' }
+     *
+     * // Use mermaid.ink with dark theme
+     * { provider: 'mermaid-ink', theme: 'dark', bgColor: '1b1b1f' }
+     *
+     * // Use self-hosted Kroki
+     * { provider: 'kroki', baseUrl: 'https://kroki.internal' }
+     * ```
+     */
+    diagramProvider: ProviderOptions;
+}
+
+export { type BaseNotifierOptions as B, type DiagramProvider as D, type KrokiProviderOptions as K, type MermaidInkFormat as M, type Notifier as N, type ProviderOptions as P, type WorkflowStatus as W, type MermaidInkGenerator as a, type MermaidInkImageType as b, type MermaidInkOptions as c, type MermaidInkPaperSize as d, type MermaidInkProviderOptions as e, type MermaidInkTheme as f, buildMermaidInkUrl as g, createMermaidInkGenerator as h, encodeForMermaidInk as i, toMermaidInkPdfUrl as j, toMermaidInkPngUrl as k, toMermaidInkSvgUrl as l, toMermaidInkUrl as m, toMermaidInkWebpUrl as n, toMermaidInkJpegUrl as t };