forgesmith 0.3.0 → 0.6.1

package/dist/index.d.ts

@@ -122,9 +122,797 @@ declare function generateOnboardingDoc(blueprint: BlueprintData | null, opts: On
 
 declare function generateRefactoringReport(blueprint: BlueprintData | null, opts: RefactoringReportOpts, provider: LlmProvider): Promise<GenerationResult>;
 
-declare function readPrismDirectory(prismPath: string): Promise<PrismData>;
-declare function readBlueprintData(targetPath: string): Promise<BlueprintData | null>;
-
 declare function generateAskDrivenAsset(blueprint: BlueprintData | null, question: string, opts: AskDrivenAssetOpts, provider: LlmProvider): Promise<GenerationResult>;
 
-export { type ArchitectureWalkthroughOpts, type AskDrivenAssetFormat, type AskDrivenAssetOpts, type BlueprintData, type BlueprintEdge, type BlueprintFile, type ChangesSinceOpts, type GenerationResult, type LlmMessage, type LlmProvider, type LlmRequest, type LlmResponse, type OnboardingDocOpts, type PrismData, type PrismInsight, type PrismRecommendation, type PrismSession, type RefactoringReportOpts, type ReleaseNotesOpts, generateArchitectureWalkthrough, generateAskDrivenAsset, generateChangesSince, generateOnboardingDoc, generateRefactoringReport, generateReleaseNotes, readBlueprintData, readPrismDirectory };
+type ScopeKind = "framework" | "app" | "tenant";
+type SignalKind = "brief" | "knowledge_ref" | "git_range" | "app_feature_ref" | "business_capability_ref" | "amber_capability_ref" | "platform_walkthrough" | "green_insight_ref";
+type Channel = "heise" | "connect" | "linkedin" | "instagram" | "landing" | "onepager" | "internal" | "email" | "deck" | "x" | "product_hunt" | "presentation";
+type AudienceId = string & {
+    readonly __brand: "AudienceId";
+};
+declare const asAudienceId: (id: string) => AudienceId;
+type Intent = "inform" | "pitch" | "announce" | "convince" | "educate" | "explain_to_layperson" | "recruit" | "celebrate_release";
+type Format = "long_article" | "short_post" | "carousel_sequence" | "story_sequence" | "pitch_paragraphs" | "landing_block" | "one_pager_section" | "quote_card" | "screenshot_narrative" | "visual_brief" | "video_brief" | "shotlist" | "hook_sequence";
+type Modality = "text" | "text_with_visual_brief" | "interactive_visual" | "image" | "video" | "mixed";
+type AssetKind = "image_brief" | "screenshot_request" | "video_brief" | "shotlist" | "quote_card_spec";
+type OutputStatus = "draft" | "generating" | "ready" | "failed";
+type Tonality = "sachlich-tief" | "sachlich-zugänglich" | "ambitioniert-glaubwürdig" | "warm-zugänglich" | "nüchtern-direkt";
+type ReadingLevel = "expert" | "professional" | "general" | "lay";
+interface ForgeAudience {
+    id: AudienceId;
+    label: string;
+    tonality: Tonality;
+    reading_level: ReadingLevel;
+    channel_hints: Channel[];
+    description: string;
+}
+interface ForgeSignal {
+    id: string;
+    scope_kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+    kind: SignalKind;
+    payload: Record<string, unknown>;
+    source_refs: Record<string, unknown>;
+    created_by?: string | null;
+    created_at: string;
+}
+interface ForgeTemplate {
+    id: string;
+    channel: Channel;
+    audience_id: AudienceId;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+    tonality?: Tonality;
+    schema_json: Record<string, unknown>;
+    asset_slots: Array<Record<string, unknown>>;
+    created_at?: string;
+}
+interface ForgeOutput {
+    id: string;
+    signal_id?: string | null;
+    template_id?: string | null;
+    status: OutputStatus;
+    scope_kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+    channel: Channel;
+    audience_id: AudienceId;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+    result_json?: Record<string, unknown> | null;
+    revision_of?: string | null;
+    created_at: string;
+}
+interface ForgeAsset {
+    id: string;
+    output_id: string;
+    kind: AssetKind;
+    modality: Modality;
+    props_json: Record<string, unknown>;
+    source_refs: Record<string, unknown>;
+    widget_def_id?: string | null;
+    widget_runtime?: string | null;
+    widget_def_history?: Array<{
+        widget_def_id: string;
+        replaced_at: string;
+        reason?: string;
+    }>;
+    created_at: string;
+}
+interface ForgeScope {
+    kind: ScopeKind;
+    app_id?: string | null;
+    env?: string | null;
+}
+type ForgeSubview = "signals" | "templates" | "audiences" | "outputs" | "walkthroughs";
+interface Zone {
+    id: string;
+    name: string;
+    files: string[];
+    fileCount: number;
+    heat: number;
+}
+interface FileEntry {
+    path: string;
+    importCount: number;
+    importedByCount: number;
+    lineCount: number;
+    zone: string;
+}
+
+interface BrandKitPalette {
+    primary: string;
+    secondary: string;
+    accent: string;
+    surface: string;
+    text: string;
+    muted: string;
+}
+interface BrandKitFonts {
+    heading: string;
+    body: string;
+    mono: string;
+}
+interface BrandKitVoice {
+    tone: string;
+    audience: string;
+    vocabulary: string[];
+    avoid: string[];
+    formality: number;
+    technicality: number;
+}
+interface BrandKitLogo {
+    url?: string;
+    svg?: string;
+}
+interface BrandKitSnapshot {
+    version: number;
+    saved_at: string;
+    palette: BrandKitPalette;
+    voice: BrandKitVoice;
+}
+interface BrandKit {
+    id: string;
+    name: string;
+    source: "manual" | "url" | "prism";
+    source_url?: string;
+    palette: BrandKitPalette;
+    fonts: BrandKitFonts;
+    voice: BrandKitVoice;
+    logo: BrandKitLogo;
+    prism_detected?: boolean;
+    version: number;
+    versions: BrandKitSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare const DEFAULT_BRAND_KIT_PALETTE: BrandKitPalette;
+declare const DEFAULT_BRAND_KIT_FONTS: BrandKitFonts;
+declare const DEFAULT_BRAND_KIT_VOICE: BrandKitVoice;
+declare function defaultBrandKit(partial?: Partial<BrandKit>): Omit<BrandKit, "id" | "created_at" | "updated_at">;
+interface UrlBrandHints {
+    url: string;
+    pageTitle?: string;
+    metaDescription?: string;
+    themeColor?: string;
+    ogImage?: string;
+    cssColorHints?: string[];
+    fontHints?: string[];
+}
+declare function assembleBrandUrlExtractionPrompt(hints: UrlBrandHints): string;
+declare function parseBrandKitFromLlmResponse(text: string, hints: UrlBrandHints): Omit<BrandKit, "id" | "created_at" | "updated_at" | "version" | "versions">;
+interface PrismBrandDraft {
+    suggestedName: string;
+    voice: BrandKitVoice;
+    prism_detected: true;
+    blueprint_path: string;
+    stats: {
+        totalFiles: number;
+        categories: Record<string, number>;
+        technicalScore: number;
+        audienceMix: string;
+    };
+}
+
+type WidgetKind = "stat-card" | "feature-grid" | "testimonial" | "cta-banner" | "metric-badge" | "pricing-tier" | "changelog-row" | "social-proof";
+type WidgetSlotType = "text" | "number" | "color" | "url" | "image-url" | "multiline" | "select";
+type WidgetExportFormat = "html" | "markdown" | "react";
+interface WidgetSlotDef {
+    id: string;
+    label: string;
+    type: WidgetSlotType;
+    default?: string | number;
+    required?: boolean;
+    placeholder?: string;
+    options?: string[];
+}
+interface WidgetTemplate {
+    id: WidgetKind;
+    name: string;
+    description: string;
+    slots: WidgetSlotDef[];
+    exportFormats: WidgetExportFormat[];
+    free_tier: boolean;
+}
+interface WidgetInstanceSnapshot {
+    version: number;
+    saved_at: string;
+    slots: Record<string, string | number>;
+    style_id?: string;
+}
+interface WidgetInstance {
+    id: string;
+    template_id: WidgetKind;
+    name: string;
+    slots: Record<string, string | number>;
+    brand_kit_id?: string;
+    style_id?: string;
+    version: number;
+    versions: WidgetInstanceSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare function getSlotValue(slots: Record<string, string | number>, template: WidgetTemplate, slotId: string): string;
+
+interface StyleTokens {
+    radius: {
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    shadow: {
+        sm: string;
+        md: string;
+        lg: string;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    borderWidth: string;
+    borderStyle: "solid" | "dashed" | "none";
+    animation: {
+        entry: "fade" | "slide" | "scale" | "none";
+        durationMs: number;
+    };
+}
+interface WidgetStyleSnapshot {
+    version: number;
+    saved_at: string;
+    tokens: StyleTokens;
+}
+interface WidgetStyle {
+    id: string;
+    name: string;
+    preset: boolean;
+    tokens: StyleTokens;
+    customCss?: string;
+    templateOverrides?: Record<string, {
+        html?: string;
+        jsx?: string;
+    }>;
+    version: number;
+    versions: WidgetStyleSnapshot[];
+    created_at: string;
+    updated_at: string;
+}
+declare const STYLE_PRESET_DEFAULT: WidgetStyle;
+declare const STYLE_PRESET_MINIMAL: WidgetStyle;
+declare const STYLE_PRESET_GLASSY: WidgetStyle;
+declare const STYLE_PRESET_BRUTALIST: WidgetStyle;
+declare const BUNDLED_STYLE_PRESETS: WidgetStyle[];
+declare function getStyleById(id: string): WidgetStyle;
+declare function parseStyleFromTokensJson(json: unknown): Partial<StyleTokens>;
+declare function parseStyleFromTailwindConfig(jsSource: string): Partial<StyleTokens>;
+declare function parseStyleFromCss(css: string): {
+    tokens: Partial<StyleTokens>;
+    customCss: string;
+};
+
+type ChannelKind = "tweet" | "linkedin" | "blog" | "newsletter" | "hn" | "instagram" | "reddit" | "email" | "slack";
+interface DispatchChannel {
+    id: string;
+    name: string;
+    kind: ChannelKind;
+    /** Hard character cap — orchestrateDispatch truncates to this. */
+    maxLength: number;
+    /** Injected into the channel-specific system prompt. */
+    promptHints: string;
+}
+declare const DISPATCH_CHANNEL_TWEET: DispatchChannel;
+declare const DISPATCH_CHANNEL_LINKEDIN: DispatchChannel;
+declare const DISPATCH_CHANNEL_BLOG: DispatchChannel;
+declare const DISPATCH_CHANNEL_NEWSLETTER: DispatchChannel;
+declare const DISPATCH_CHANNEL_HN: DispatchChannel;
+declare const DISPATCH_CHANNEL_INSTAGRAM: DispatchChannel;
+declare const DISPATCH_CHANNEL_REDDIT: DispatchChannel;
+declare const DISPATCH_CHANNEL_EMAIL: DispatchChannel;
+declare const DISPATCH_CHANNEL_SLACK: DispatchChannel;
+declare const BUNDLED_DISPATCH_CHANNELS: DispatchChannel[];
+declare function getDispatchChannel(id: string): DispatchChannel | undefined;
+
+interface ChannelOutput {
+    channel_id: string;
+    channel_name: string;
+    kind: string;
+    content: string;
+    char_count: number;
+    truncated: boolean;
+    generated_at: string;
+    error?: string;
+}
+interface DispatchRun {
+    id: string;
+    ask: string;
+    audience_label?: string;
+    brand_name?: string;
+    blueprint_grounded: boolean;
+    outputs: ChannelOutput[];
+    created_at: string;
+}
+interface DispatchBrandContext {
+    name: string;
+    voice: {
+        tone: string;
+        formality: number;
+        vocabulary?: string[];
+        avoid?: string[];
+    };
+}
+interface DispatchAudienceContext {
+    label: string;
+    tonality: string;
+    reading_level: string;
+}
+interface OrchestrationInput {
+    ask: string;
+    channels: DispatchChannel[];
+    audience?: DispatchAudienceContext;
+    brand?: DispatchBrandContext;
+    blueprintContext?: string;
+    toneOverrides?: Record<string, number>;
+}
+interface TokenUsage {
+    total_input: number;
+    total_output: number;
+    channel_count: number;
+}
+interface OrchestrationResult {
+    outputs: ChannelOutput[];
+    usage: TokenUsage;
+}
+declare function orchestrateDispatch(input: OrchestrationInput, provider: LlmProvider): Promise<OrchestrationResult>;
+
+interface AssetVersion {
+    id: string;
+    assetId: string;
+    versionNumber: number;
+    content: string;
+    message: string;
+    createdAt: string;
+    usedTokens?: number;
+    brandKitId?: string;
+    styleId?: string;
+    blueprintFocus?: string;
+    fromPrism?: boolean;
+    revertedFrom?: number;
+}
+interface DiffEntry {
+    type: "unchanged" | "added" | "removed";
+    line: string;
+    lineNo?: number;
+}
+interface DiffResult {
+    entries: DiffEntry[];
+    addedCount: number;
+    removedCount: number;
+}
+/**
+ * Deterministic line-level diff using a simple LCS approach.
+ * Returns DiffEntry[] suitable for a two-column diff display.
+ */
+declare function computeDiff(contentA: string, contentB: string): DiffResult;
+declare function buildVersion(assetId: string, versionNumber: number, content: string, message: string, meta?: Partial<Omit<AssetVersion, "id" | "assetId" | "versionNumber" | "content" | "message" | "createdAt">>): AssetVersion;
+declare function buildRevertVersion(assetId: string, versionNumber: number, source: AssetVersion): AssetVersion;
+declare function nextVersionNumber(versions: AssetVersion[]): number;
+
+type ScheduledStatus = "draft" | "queued" | "exported" | "cancelled";
+interface ScheduledEntryMetadata {
+    exportedTo?: "buffer" | "hypefury" | "icalendar";
+    exportedAt?: string;
+    exportRef?: string;
+    dispatchRunId?: string;
+    brandKitId?: string;
+    assetType?: string;
+}
+interface ScheduledEntry {
+    id: string;
+    assetId: string;
+    channelId: string;
+    scheduledFor: string;
+    status: ScheduledStatus;
+    contentPreview: string;
+    metadata: ScheduledEntryMetadata;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ScheduleRange {
+    from: string;
+    to: string;
+}
+declare function buildScheduledEntry(assetId: string, channelId: string, scheduledFor: string, contentPreview: string, metadata?: ScheduledEntryMetadata): ScheduledEntry;
+declare function applyEntryPatch(entry: ScheduledEntry, patch: Partial<Pick<ScheduledEntry, "scheduledFor" | "status" | "channelId" | "contentPreview" | "metadata">>): ScheduledEntry;
+declare function entryInRange(entry: ScheduledEntry, range: ScheduleRange): boolean;
+declare function next7DaysRange(): ScheduleRange;
+/** Cascading cadence for "Schedule all dispatch outputs". */
+declare function cascadingScheduledFor(channelIds: string[], startFrom?: Date): Record<string, string>;
+
+interface ListOutputsOpts {
+    signalId?: string;
+    templateId?: string;
+    limit?: number;
+}
+interface ForgeStorage {
+    getSignal(id: string): Promise<ForgeSignal | null>;
+    getTemplate(id: string): Promise<ForgeTemplate | null>;
+    getAudience(id: string): Promise<ForgeAudience | null>;
+    listTemplates(): Promise<ForgeTemplate[]>;
+    listAudiences(): Promise<ForgeAudience[]>;
+    listOutputs(opts?: ListOutputsOpts): Promise<ForgeOutput[]>;
+    saveSignal(signal: Omit<ForgeSignal, "id" | "created_at">): Promise<ForgeSignal>;
+    saveTemplate(template: Omit<ForgeTemplate, "created_at">): Promise<ForgeTemplate>;
+    saveAudience(audience: ForgeAudience): Promise<ForgeAudience>;
+    saveOutput(output: Omit<ForgeOutput, "id" | "created_at">): Promise<ForgeOutput>;
+    saveAsset(asset: Omit<ForgeAsset, "id" | "created_at">): Promise<ForgeAsset>;
+    deleteTemplate(id: string): Promise<void>;
+    deleteAudience(id: string): Promise<void>;
+    deleteOutput(id: string): Promise<void>;
+    saveBrandKit(kit: Omit<BrandKit, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<BrandKit>;
+    getBrandKit(id: string): Promise<BrandKit | null>;
+    listBrandKits(): Promise<BrandKit[]>;
+    deleteBrandKit(id: string): Promise<void>;
+    saveWidget(widget: Omit<WidgetInstance, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<WidgetInstance>;
+    getWidget(id: string): Promise<WidgetInstance | null>;
+    listWidgets(templateId?: string): Promise<WidgetInstance[]>;
+    deleteWidget(id: string): Promise<void>;
+    saveStyle(style: Omit<WidgetStyle, "id" | "created_at" | "updated_at"> & {
+        id?: string;
+    }): Promise<WidgetStyle>;
+    getStyle(id: string): Promise<WidgetStyle | null>;
+    listStyles(): Promise<WidgetStyle[]>;
+    deleteStyle(id: string): Promise<void>;
+    saveDispatch(run: Omit<DispatchRun, "id" | "created_at"> & {
+        id?: string;
+    }): Promise<DispatchRun>;
+    getDispatch(id: string): Promise<DispatchRun | null>;
+    listDispatches(limit?: number): Promise<DispatchRun[]>;
+    deleteDispatch(id: string): Promise<void>;
+    saveAssetVersion(assetId: string, version: AssetVersion): Promise<AssetVersion>;
+    listAssetVersions(assetId: string): Promise<AssetVersion[]>;
+    revertAsset(assetId: string, versionId: string): Promise<AssetVersion>;
+    saveScheduledEntry(entry: ScheduledEntry): Promise<ScheduledEntry>;
+    listScheduledEntries(range?: ScheduleRange): Promise<ScheduledEntry[]>;
+    updateScheduledEntry(id: string, patch: Partial<Pick<ScheduledEntry, "scheduledFor" | "status" | "channelId" | "contentPreview" | "metadata">>): Promise<ScheduledEntry>;
+    deleteScheduledEntry(id: string): Promise<void>;
+}
+
+interface ProductTruthClaim {
+    id: string;
+    statement: string;
+    source_ref: string;
+}
+interface ProductTruth {
+    signal_id: string;
+    audience_id: string;
+    audience_label: string;
+    tonality: string;
+    reading_level: string;
+    claims: ProductTruthClaim[];
+    raw_source_refs: Record<string, unknown>;
+}
+declare function distill(input: {
+    signal: ForgeSignal;
+    audience: ForgeAudience;
+}): ProductTruth;
+
+interface ResolvedTuple {
+    channel: Channel;
+    audience_id: string;
+    intent: Intent;
+    format: Format;
+    modality: Modality;
+}
+interface ForgePrompt {
+    system: string;
+    user: string;
+    schema_name: string;
+    schema: unknown;
+}
+declare function assembleForgePrompt(input: {
+    template: ForgeTemplate;
+    audience: ForgeAudience;
+    productTruth: ProductTruth;
+    resolved: ResolvedTuple;
+    contextBlocks?: string[];
+}): ForgePrompt;
+
+interface ValidationOk<T> {
+    ok: true;
+    value: T;
+}
+interface ValidationErr {
+    ok: false;
+    errors: string[];
+    unsupported?: string[];
+}
+type ValidationResult<T = Record<string, unknown>> = ValidationOk<T> | ValidationErr;
+declare function validateAgainstTemplateSchema(schema: unknown, candidate: unknown): ValidationResult;
+declare function tryParseJsonObject(raw: string): unknown;
+
+interface SchemaDefinitionOk {
+    valid: true;
+}
+interface SchemaDefinitionErr {
+    valid: false;
+    errors: string[];
+}
+type SchemaDefinitionResult = SchemaDefinitionOk | SchemaDefinitionErr;
+declare function validateSchemaDefinition(input: unknown): SchemaDefinitionResult;
+declare function parseAndValidateSchemaDefinition(jsonText: string): {
+    valid: true;
+    parsed: Record<string, unknown>;
+} | {
+    valid: false;
+    errors: string[];
+};
+
+interface AssetSlotsValidationOk {
+    valid: true;
+}
+interface AssetSlotsValidationErr {
+    valid: false;
+    errors: string[];
+}
+type AssetSlotsValidationResult = AssetSlotsValidationOk | AssetSlotsValidationErr;
+declare function validateAssetSlots(input: unknown): AssetSlotsValidationResult;
+
+declare function templateAnimatedDefault(assetSlots: unknown): boolean;
+declare function resolveAnimatedChoice(templateDefault: boolean, override: boolean | undefined): boolean;
+
+declare const DEFAULT_ANIMATION_DURATION_SECONDS = 10;
+declare const ANIMATION_DURATION_PRESETS: readonly [5, 10, 20, 30];
+declare const MIN_ANIMATION_DURATION_SECONDS = 1;
+declare const MAX_ANIMATION_DURATION_SECONDS = 120;
+declare function clampAnimationDuration(seconds: number): number;
+declare function resolveAnimationDuration(override: number | undefined, persisted: number | undefined, fallback?: number): number;
+
+declare const REFINE_SESSION_SOFT_CAP = 100;
+declare const REFINE_COUNTDOWN_THRESHOLD = 90;
+interface RefineLimitState {
+    used: number;
+    capped: boolean;
+    remaining: number;
+    showCountdown: boolean;
+}
+declare function refineLimitState(usedRefines: number, softCap?: number): RefineLimitState;
+
+interface BrandPalette {
+    primary: string;
+    accent: string;
+    background: string;
+    card: string;
+    text: string;
+}
+interface ForgeThemeEntry {
+    id?: string;
+    label?: string;
+    primary?: string;
+    accent?: string;
+    bg?: string;
+    card?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+declare function themeEntryToPalette(entry: ForgeThemeEntry | null | undefined): BrandPalette | null;
+declare function parseThemeConfigContent(content: unknown): ForgeThemeEntry[];
+declare const FORGE_BRAND_THEME_ID = "__forge_brand__";
+declare const BRAND_CONTENT_SLOT_KEYS: {
+    readonly primary: "content-primary";
+    readonly accent: "content-accent";
+    readonly bg: "content-bg";
+    readonly card: "content-card";
+    readonly text: "content-text";
+};
+interface BrandThemeConfig {
+    id?: string;
+    name?: string;
+    values?: Record<string, string>;
+    [key: string]: unknown;
+}
+declare function parseBrandThemeContent(content: unknown): BrandThemeConfig[];
+declare function brandThemeConfigToEntry(config: BrandThemeConfig | null | undefined): ForgeThemeEntry | null;
+interface ResolveBrandPaletteInput {
+    scope: ScopeKind;
+    themes: ForgeThemeEntry[];
+    selectedThemeId?: string | null;
+    frameworkDefault: BrandPalette | null;
+    appDefault: BrandPalette | null;
+}
+declare function resolveBrandPalette(input: ResolveBrandPaletteInput): BrandPalette | null;
+
+interface BaseField {
+    name: string;
+    label: string;
+    required: boolean;
+    description?: string;
+}
+interface StringField extends BaseField {
+    kind: "string";
+    multiline: boolean;
+    enum?: string[];
+    maxLength?: number;
+    minLength?: number;
+}
+interface NumberField extends BaseField {
+    kind: "number";
+    integer: boolean;
+    minimum?: number;
+    maximum?: number;
+}
+interface BooleanField extends BaseField {
+    kind: "boolean";
+}
+interface ArrayField extends BaseField {
+    kind: "array";
+    itemField: FormField | null;
+    minItems?: number;
+    maxItems?: number;
+}
+interface ObjectField extends BaseField {
+    kind: "object";
+    fields: FormField[];
+}
+type FormField = StringField | NumberField | BooleanField | ArrayField | ObjectField;
+interface FormSpecOk {
+    kind: "form";
+    fields: FormField[];
+}
+interface FormSpecRaw {
+    kind: "raw";
+    reason: string;
+}
+type FormSpec = FormSpecOk | FormSpecRaw;
+declare function schemaToForm(schema: unknown): FormSpec;
+declare function defaultValueForField(field: FormField): unknown;
+declare function initialFormValues(fields: FormField[], source: Record<string, unknown>): Record<string, unknown>;
+type FormErrors = Record<string, string>;
+declare function validateFormValues(fields: FormField[], values: Record<string, unknown>): FormErrors;
+declare const TEMPLATE_SCHEMA_EXAMPLES: Partial<Record<Format, Record<string, unknown>>>;
+declare const TEMPLATE_SCHEMA_GENERIC: Record<string, unknown>;
+declare function schemaExampleFor(format: Format): Record<string, unknown>;
+
+interface ForgeGenerationInput {
+    /** Storage adapter the engine reads/writes through. */
+    storage: ForgeStorage;
+    /** LLM provider that handles the model call. */
+    provider: LlmProvider;
+    /** Signal id to generate from. */
+    signalId: string;
+    /** Template id that shapes the generation. */
+    templateId: string;
+    /** Per-generation tuple overrides — each replaces the template default. */
+    audienceOverride?: string;
+    intentOverride?: Intent;
+    formatOverride?: Format;
+    modalityOverride?: Modality;
+    /** Honest dry-run: assemble + validate inputs, never call the model, never persist. */
+    dryRun?: boolean;
+    /** Max tokens for the LLM call (default: 4096). */
+    maxTokens?: number;
+}
+interface ForgeGenerationError {
+    kind: "error";
+    status: number;
+    error: string;
+    field?: string;
+}
+interface ForgeGenerationDryRun {
+    kind: "dry_run";
+    payload: {
+        dryRun: true;
+        resolved: ResolvedTuple;
+        product_truth: unknown;
+        prompt: {
+            system: string;
+            user: string;
+            schema_name: string;
+        };
+    };
+}
+interface ForgeGenerationGenerated {
+    kind: "generated";
+    status: 200 | 201;
+    payload: {
+        output: unknown;
+        validation: ReturnType<typeof validateAgainstTemplateSchema> | null;
+        failure_reason: string | null;
+    };
+}
+type ForgeGenerationResult = ForgeGenerationError | ForgeGenerationDryRun | ForgeGenerationGenerated;
+declare function runForgeGeneration(input: ForgeGenerationInput): Promise<ForgeGenerationResult>;
+
+declare const WIDGET_TEMPLATE_STAT_CARD: WidgetTemplate;
+declare const WIDGET_TEMPLATE_FEATURE_GRID: WidgetTemplate;
+declare const WIDGET_TEMPLATE_TESTIMONIAL: WidgetTemplate;
+declare const WIDGET_TEMPLATE_CTA_BANNER: WidgetTemplate;
+declare const WIDGET_TEMPLATE_METRIC_BADGE: WidgetTemplate;
+declare const WIDGET_TEMPLATE_PRICING_TIER: WidgetTemplate;
+declare const WIDGET_TEMPLATE_CHANGELOG_ROW: WidgetTemplate;
+declare const WIDGET_TEMPLATE_SOCIAL_PROOF: WidgetTemplate;
+declare const BUNDLED_WIDGET_TEMPLATES: WidgetTemplate[];
+declare const FREE_TIER_WIDGET_IDS: string[];
+declare function getWidgetTemplate(id: string): WidgetTemplate | undefined;
+
+interface RenderWidgetInput {
+    template: WidgetTemplate;
+    slots: Record<string, string | number>;
+    brandKit?: BrandKit | null;
+    style?: WidgetStyle | string | null;
+    format: WidgetExportFormat;
+}
+declare function renderWidget(input: RenderWidgetInput): string;
+
+declare const FORGE_AUDIENCES: ForgeAudience[];
+
+declare const FORGE_TEMPLATES: ForgeTemplate[];
+
+/** Defence-in-depth: scan derived text for secret patterns before sending to LLM. */
+declare function scanForSecrets(text: string): boolean;
+
+type PrismFocus = "release" | "changelog" | "deepdive" | "summary" | `zone:${string}` | `module:${string}`;
+interface PrismContextPrompt {
+    systemFragment: string;
+    contextBlock: string;
+    suggestedAsk: string;
+}
+interface PrismTemplate {
+    id: string;
+    name: string;
+    description: string;
+    defaultFocus: PrismFocus;
+    suggestedAsk: string;
+    suggestedChannels: string[];
+    requiresZone?: boolean;
+}
+declare const PRISM_TEMPLATE_RELEASE_ANNOUNCEMENT: PrismTemplate;
+declare const PRISM_TEMPLATE_SHIPPING_DIGEST: PrismTemplate;
+declare const PRISM_TEMPLATE_ZONE_DEEPDIVE: PrismTemplate;
+declare const PRISM_TEMPLATE_ARCHITECTURE_OVERVIEW: PrismTemplate;
+declare const PRISM_TEMPLATE_REFACTOR_RATIONALE: PrismTemplate;
+declare const PRISM_TEMPLATES: PrismTemplate[];
+declare function getPrismTemplate(id: string): PrismTemplate | undefined;
+
+interface RefineAssetInput {
+    assetId: string;
+    assetType: string;
+    currentContent: string;
+    userMessage: string;
+    brandName?: string;
+    brandVoice?: string;
+    styleHint?: string;
+    blueprintContext?: string;
+}
+interface RefineAssetResult {
+    newContent: string;
+    llmReply: string;
+    usedTokens: number;
+}
+/**
+ * Sends the current asset content + user message to an LLM and returns
+ * the refined content and a brief explanation of changes.
+ *
+ * Applies scanForSecrets() to both the system prompt and the current content
+ * before sending — throws if secrets are detected (defence-in-depth).
+ */
+declare function refineAsset(input: RefineAssetInput, provider: LlmProvider): Promise<RefineAssetResult>;
+declare const REFINE_SUGGESTIONS: readonly ["Make it more concise", "Add more technical detail", "Make the tone more formal", "Make the tone more casual and conversational", "Add a strong opening hook", "Strengthen the call to action", "Break into shorter paragraphs", "Focus more on developer impact"];
+type RefineSuggestion = (typeof REFINE_SUGGESTIONS)[number];
+
+declare function exportToBufferCsv(entries: ScheduledEntry[]): string;
+declare function exportToHypefuryCsv(entries: ScheduledEntry[]): string;
+declare function exportToICalendar(entries: ScheduledEntry[]): string;
+type ExportFormat = "buffer" | "hypefury" | "icalendar";
+declare function previewExport(entries: ScheduledEntry[], format: ExportFormat): string;
+
+export { ANIMATION_DURATION_PRESETS, type ArchitectureWalkthroughOpts, type ArrayField, type AskDrivenAssetFormat, type AskDrivenAssetOpts, type AssetKind, type AssetSlotsValidationErr, type AssetSlotsValidationOk, type AssetSlotsValidationResult, type AssetVersion, type AudienceId, BRAND_CONTENT_SLOT_KEYS, BUNDLED_DISPATCH_CHANNELS, BUNDLED_STYLE_PRESETS, BUNDLED_WIDGET_TEMPLATES, type BlueprintData, type BlueprintEdge, type BlueprintFile, type BooleanField, type BrandKit, type BrandKitFonts, type BrandKitLogo, type BrandKitPalette, type BrandKitSnapshot, type BrandKitVoice, type BrandPalette, type BrandThemeConfig, type ChangesSinceOpts, type Channel, type ChannelKind, type ChannelOutput, DEFAULT_ANIMATION_DURATION_SECONDS, DEFAULT_BRAND_KIT_FONTS, DEFAULT_BRAND_KIT_PALETTE, DEFAULT_BRAND_KIT_VOICE, DISPATCH_CHANNEL_BLOG, DISPATCH_CHANNEL_EMAIL, DISPATCH_CHANNEL_HN, DISPATCH_CHANNEL_INSTAGRAM, DISPATCH_CHANNEL_LINKEDIN, DISPATCH_CHANNEL_NEWSLETTER, DISPATCH_CHANNEL_REDDIT, DISPATCH_CHANNEL_SLACK, DISPATCH_CHANNEL_TWEET, type DiffEntry, type DiffResult, type DispatchAudienceContext, type DispatchBrandContext, type DispatchChannel, type DispatchRun, type ExportFormat, FORGE_AUDIENCES, FORGE_BRAND_THEME_ID, FORGE_TEMPLATES, FREE_TIER_WIDGET_IDS, type FileEntry, type ForgeAsset, type ForgeAudience, type ForgeGenerationDryRun, type ForgeGenerationError, type ForgeGenerationGenerated, type ForgeGenerationInput, type ForgeGenerationResult, type ForgeOutput, type ForgePrompt, type ForgeScope, type ForgeSignal, type ForgeStorage, type ForgeSubview, type ForgeTemplate, type ForgeThemeEntry, type FormErrors, type FormField, type FormSpec, type FormSpecOk, type FormSpecRaw, type Format, type GenerationResult, type Intent, type ListOutputsOpts, type LlmMessage, type LlmProvider, type LlmRequest, type LlmResponse, MAX_ANIMATION_DURATION_SECONDS, MIN_ANIMATION_DURATION_SECONDS, type Modality, type NumberField, type ObjectField, type OnboardingDocOpts, type OrchestrationInput, type OrchestrationResult, type OutputStatus, PRISM_TEMPLATES, PRISM_TEMPLATE_ARCHITECTURE_OVERVIEW, PRISM_TEMPLATE_REFACTOR_RATIONALE, PRISM_TEMPLATE_RELEASE_ANNOUNCEMENT, PRISM_TEMPLATE_SHIPPING_DIGEST, PRISM_TEMPLATE_ZONE_DEEPDIVE, type PrismBrandDraft, type PrismContextPrompt, type PrismData, type PrismFocus, type PrismInsight, type PrismRecommendation, type PrismSession, type PrismTemplate, type ProductTruth, type ProductTruthClaim, REFINE_COUNTDOWN_THRESHOLD, REFINE_SESSION_SOFT_CAP, REFINE_SUGGESTIONS, type ReadingLevel, type RefactoringReportOpts, type RefineAssetInput, type RefineAssetResult, type RefineLimitState, type RefineSuggestion, type ReleaseNotesOpts, type RenderWidgetInput, type ResolveBrandPaletteInput, type ResolvedTuple, STYLE_PRESET_BRUTALIST, STYLE_PRESET_DEFAULT, STYLE_PRESET_GLASSY, STYLE_PRESET_MINIMAL, type ScheduleRange, type ScheduledEntry, type ScheduledEntryMetadata, type ScheduledStatus, type SchemaDefinitionErr, type SchemaDefinitionOk, type SchemaDefinitionResult, type ScopeKind, type SignalKind, type StringField, type StyleTokens, TEMPLATE_SCHEMA_EXAMPLES, TEMPLATE_SCHEMA_GENERIC, type TokenUsage, type Tonality, type UrlBrandHints, type ValidationErr, type ValidationOk, type ValidationResult, WIDGET_TEMPLATE_CHANGELOG_ROW, WIDGET_TEMPLATE_CTA_BANNER, WIDGET_TEMPLATE_FEATURE_GRID, WIDGET_TEMPLATE_METRIC_BADGE, WIDGET_TEMPLATE_PRICING_TIER, WIDGET_TEMPLATE_SOCIAL_PROOF, WIDGET_TEMPLATE_STAT_CARD, WIDGET_TEMPLATE_TESTIMONIAL, type WidgetExportFormat, type WidgetInstance, type WidgetInstanceSnapshot, type WidgetKind, type WidgetSlotDef, type WidgetSlotType, type WidgetStyle, type WidgetStyleSnapshot, type WidgetTemplate, type Zone, applyEntryPatch, asAudienceId, assembleBrandUrlExtractionPrompt, assembleForgePrompt, brandThemeConfigToEntry, buildRevertVersion, buildScheduledEntry, buildVersion, cascadingScheduledFor, clampAnimationDuration, computeDiff, defaultBrandKit, defaultValueForField, distill, entryInRange, exportToBufferCsv, exportToHypefuryCsv, exportToICalendar, generateArchitectureWalkthrough, generateAskDrivenAsset, generateChangesSince, generateOnboardingDoc, generateRefactoringReport, generateReleaseNotes, getDispatchChannel, getPrismTemplate, getSlotValue, getStyleById, getWidgetTemplate, initialFormValues, next7DaysRange, nextVersionNumber, orchestrateDispatch, parseAndValidateSchemaDefinition, parseBrandKitFromLlmResponse, parseBrandThemeContent, parseStyleFromCss, parseStyleFromTailwindConfig, parseStyleFromTokensJson, parseThemeConfigContent, previewExport, refineAsset, refineLimitState, renderWidget, resolveAnimatedChoice, resolveAnimationDuration, resolveBrandPalette, runForgeGeneration, scanForSecrets, schemaExampleFor, schemaToForm, templateAnimatedDefault, themeEntryToPalette, tryParseJsonObject, validateAgainstTemplateSchema, validateAssetSlots, validateFormValues, validateSchemaDefinition };