@signalsandsorcery/plugin-sdk 2.35.5 → 2.35.7

package/dist/index.d.mts

@@ -554,8 +554,12 @@ interface PluginHost {
      * @since SDK 1.4.0
      */
     readTextFile(absolutePath: string): Promise<string | null>;
-    /** Get the FULL generation context for the active scene. */
-    getGenerationContext(excludeTrackId?: string): Promise<PluginGenerationContext>;
+    /**
+     * Get the FULL generation context for the active scene. Pass
+     * `opts.pinTrackDbIds` to pin reference tracks past the note budget
+     * (see `PluginGenerationContextOptions`). @since SDK 2.42.0 (opts)
+     */
+    getGenerationContext(excludeTrackId?: string, opts?: PluginGenerationContextOptions): Promise<PluginGenerationContext>;
     /** Get lightweight musical context (no concurrent track MIDI data). */
     getMusicalContext(): Promise<MusicalContext>;
     /** Get the active scene ID. Null if no scene is active. */
@@ -630,6 +634,16 @@ interface PluginHost {
      * @since SDK 2.22.0
      */
     listSceneFamilyTracks?(sceneDbId: string): Promise<SceneFamilyTrack[]>;
+    /**
+     * Enumerate ALL tracks in the ACTIVE scene — unfiltered by plugin family or
+     * ownership (unlike `listSceneFamilyTracks`). Read-only; names are
+     * display-only per the Track Identity rule (use `dbId` for any lookup).
+     * Powers reference-track pickers ("write in counterpoint against these") —
+     * the returned `dbId`s feed `PluginGenerationContextOptions.pinTrackDbIds`.
+     * Returns [] when no project/scene is bound. Optional — callers MUST
+     * null-check (see `listImportableTracks`). @since SDK 2.42.0
+     */
+    listSceneTracks?(): Promise<SceneTrackSummary[]>;
     /**
      * Read a specific scene's musical key (tonic + mode) by db id. Labels the
      * SOURCE keys of a crossfade's origin/target patterns — the active-scene
@@ -1422,6 +1436,24 @@ interface ImportCandidateScene {
      */
     sameScene?: boolean;
 }
+/**
+ * One track in the ACTIVE scene, returned by `host.listSceneTracks` —
+ * unfiltered by family/ownership. `name` is display-only (Track Identity
+ * rule); `dbId` is the stable selector for `pinTrackDbIds`.
+ * @since SDK 2.42.0
+ */
+interface SceneTrackSummary {
+    /** Stable DB row id (`tracks.id`). */
+    dbId: string;
+    /** Display name — never use as an identifier. */
+    name: string;
+    /** Canonical role (`InstrumentType`) when stamped. */
+    role?: string;
+    /** User-typed prompt that produced the track, when stored. */
+    prompt?: string;
+    /** True when the track has saved MIDI (i.e. it can serve as a reference). */
+    hasMidi: boolean;
+}
 /**
  * A source track's current sound, as returned by `host.getTrackSound`. The
  * discriminant matches the panel that reads it: drums → 'sample', instruments →
@@ -1733,6 +1765,35 @@ interface PluginConcurrentTrackInfo {
     truncated?: boolean;
     /** The track's full note count before per-track truncation. */
     originalNoteCount?: number;
+    /**
+     * Track display name — CONTEXT/DISPLAY ONLY (prompts, pickers). Never an
+     * identifier: names are non-unique and mutable; use `trackId`/`dbId` for
+     * any lookup. @since SDK 2.42.0
+     */
+    name?: string;
+    /** Stable DB row id (`tracks.id`) — correlates with `pinTrackDbIds` and
+     *  `listSceneTracks()` entries. @since SDK 2.42.0 */
+    dbId?: string;
+    /**
+     * True when this track was pinned via
+     * `PluginGenerationContextOptions.pinTrackDbIds` — i.e. it is REFERENCE
+     * material the caller explicitly asked to write against, exempt from the
+     * note budget. Formatters render pinned tracks in a distinct REFERENCE
+     * block. @since SDK 2.42.0
+     */
+    pinned?: boolean;
+}
+/**
+ * Options for `getGenerationContext`. @since SDK 2.42.0
+ */
+interface PluginGenerationContextOptions {
+    /**
+     * DB row ids (`tracks.id`) of reference tracks that must ALWAYS be included
+     * whole — exempt from the cross-track note budget (ambient tracks fill the
+     * remaining budget). Powers "write in counterpoint against THESE tracks".
+     * Unknown ids and tracks without saved MIDI are ignored.
+     */
+    pinTrackDbIds?: readonly string[];
 }
 interface PluginChordSegment {
     chord: string;
@@ -4861,6 +4922,13 @@ interface PanelTransitionGroupAdapter {
     /** Group-fade row header label, e.g. `Bassline (3 voices)`. Default `Group (N tracks)`. */
     groupRowLabel?(memberCount: number): string;
 }
+/** What `onTrackCreated` gets to work with (Add Track is scene-gated, so the scene is non-null). */
+interface TrackCreatedContext {
+    /** Scene the track was created in. */
+    activeSceneId: string;
+    /** The ONE scene-data key builder (always dbId-based). */
+    trackDataKey: (dbId: string, suffix: string) => string;
+}
 interface GeneratorPanelAdapter<M = unknown> {
     identity: PanelIdentity;
     features: PanelFeatureFlags;
@@ -4871,6 +4939,18 @@ interface GeneratorPanelAdapter<M = unknown> {
      * Synth: `host.shufflePreset(handle.id)` non-fatal.
      */
     applyPortedTrackSound(handle: PluginTrackHandle, role?: string): Promise<void>;
+    /**
+     * Optional hook run right after a track is born (Add Track / Import Track).
+     * Lets a family stamp per-track scene-data on the newborn — e.g. the arp
+     * panel anchors every new track as a voice-group of ONE so the group
+     * header's intent controls (voice count / rate / split) exist BEFORE the
+     * first generation instead of appearing only after it (which wasted a
+     * throwaway generation on defaults). The core reloads tracks after the hook
+     * so stamped group metas resolve immediately. Failures are non-fatal — the
+     * track lands as a plain row.
+     * @since SDK 2.43.0
+     */
+    onTrackCreated?(handle: PluginTrackHandle, ctx: TrackCreatedContext): Promise<void>;
     /** System prompt for the family's LLM calls (incl. core-owned crossfade/fade generation). */
     buildSystemPrompt(validRoles: readonly string[]): string;
     /** Parse the family's LLM note responses (crossfade/fade flows). */
@@ -5116,6 +5196,252 @@ interface SurgeSoundAdapterOverrides {
 }
 declare function createSurgeSoundAdapter(host: PluginHost, overrides?: SurgeSoundAdapterOverrides): PanelSoundAdapter;
 
+/**
+ * ensemble-core: voice specifications — the register + complexity hierarchy
+ * as DATA. The first live per-voice register map in the platform (the only
+ * prior per-role [low,high] table, MusicTheory.getSuggestedRegister, was
+ * dead code).
+ *
+ * The shape encodes the product intent: the TOP voice is the highest-pitched
+ * and most complex line; complexity decreases with register; the bottom
+ * voice is a sparse anchor (root pitch classes only when `rootOnly`).
+ *
+ * All thresholds are exported constants in the bass-plugin tradition —
+ * tune by ear, not by refactor. Roles are plain strings validated by the
+ * host at stamp time (`host.getValidRoles()`); the SDK deliberately ships
+ * no role list.
+ *
+ * @since SDK 2.42.0
+ */
+interface EnsembleVoiceSpec {
+    /** 0 = top voice; increases downward. */
+    voiceIndex: number;
+    /** Human label for the track row + prompt ("high florid line"). */
+    label: string;
+    /** InstrumentType to stamp on the voice's track (drives preset category). */
+    role: string;
+    /** Playable window (MIDI note numbers, inclusive). Enforced by octave-fold. */
+    registerLow: number;
+    registerHigh: number;
+    /** Density budget — hard cap, enforced by weakest-note thinning. */
+    maxNotesPerBar: number;
+    /** Prompt text: rhythmic vocabulary for this voice. */
+    rhythmPalette: string;
+    /** Prompt text: harmonic discipline for this voice. */
+    harmonicDiscipline: string;
+    /** When true the voice plays ONLY each bar's chord-root pitch class. */
+    rootOnly?: boolean;
+    /**
+     * Equal-onset survivor during the per-voice monophony sweep: top voices
+     * keep the highest pitch, bottom voices the lowest (mirrors how ears
+     * track outer voices).
+     */
+    monoPreference: 'high' | 'low';
+}
+/** Supported ensemble sizes. */
+declare const ENSEMBLE_MIN_VOICES = 2;
+declare const ENSEMBLE_MAX_VOICES = 6;
+/**
+ * Default voice specs for an N-voice ensemble, top voice first. Clamps N to
+ * the supported range. Returned objects are fresh copies — callers may
+ * override fields (e.g. style packs narrowing registers) without touching
+ * the tables.
+ */
+declare function defaultVoiceSpecs(voiceCount: number): EnsembleVoiceSpec[];
+
+/**
+ * ensemble-core: HARD per-voice enforcement — the mechanical layer between
+ * the LLM's jointly-composed voices and the clips that get written. In the
+ * platform's bass-plugin tradition, everything here is deterministic
+ * analysis/repair of written notes, never LLM intention:
+ *
+ *   clip clamp → octave-fold into the voice's register window →
+ *   root-only pinning (anchor voices) → in-scale snap (optional) →
+ *   per-voice monophony sweep → per-bar density thinning
+ *
+ * Each voice stays a single line (monophonic); OVERLAP BETWEEN voices is the
+ * point of counterpoint and is never touched here. Soft, style-dependent
+ * rules (parallels, crossings, onset independence) live in
+ * analyze-ensemble.ts — they are reported, not repaired.
+ *
+ * Pure functions; inputs are never mutated. @since SDK 2.42.0
+ */
+
+/** Structural match for PluginMidiNote — keeps this module dependency-free. */
+interface EnsembleNote {
+    pitch: number;
+    startBeat: number;
+    durationBeats: number;
+    velocity: number;
+    channel?: number;
+}
+interface EnforceVoiceOptions {
+    /** Clip length in bars (4/4 assumed, matching the platform grid). */
+    bars: number;
+    /**
+     * Chord-root pitch class (0-11) for a given bar, or null when unknown.
+     * Required for `rootOnly` voices to mean anything; when absent, rootOnly
+     * degrades to plain register enforcement.
+     */
+    chordRootPcAtBar?: (bar: number) => number | null;
+    /**
+     * Scale pitch classes (0-11) for the scene key. When provided, non-scale
+     * pitches snap to the nearest scale pitch class (chord tones supplied via
+     * `chordPcsAtBar` are exempt — a sounding 7th over its chord is not an
+     * error even outside the scale).
+     */
+    scalePcs?: ReadonlySet<number>;
+    /** Chord-tone pitch classes for a bar — exemptions for the scale snap. */
+    chordPcsAtBar?: (bar: number) => ReadonlySet<number> | null;
+}
+interface EnforceVoiceResult {
+    notes: EnsembleNote[];
+    /** Human/LLM-readable descriptions of every repair performed. */
+    repairs: string[];
+}
+declare const MIN_NOTE_DURATION_BEATS = 0.0625;
+/** Octave-fold a pitch into [low, high], preserving pitch class when possible. */
+declare function foldPitchToRegister(pitch: number, low: number, high: number): number;
+/** Nearest pitch within [low, high] having pitch class `pc` (ties go low). */
+declare function nearestPitchWithPc(reference: number, pc: number, low: number, high: number): number;
+/**
+ * Enforce one voice's hard contract. Order matters: register first (so
+ * root-only/scale snaps operate in-window), monophony before density (the
+ * sweep can merge/trim what thinning would otherwise count).
+ */
+declare function enforceVoice(rawNotes: readonly EnsembleNote[], spec: EnsembleVoiceSpec, opts: EnforceVoiceOptions): EnforceVoiceResult;
+
+/**
+ * ensemble-core: SOFT cross-voice analysis — the "do the voices actually
+ * talk to each other?" metrics. Nothing here repairs notes; violations are
+ * REPORTED so the caller can (a) feed them back to the LLM for one guided
+ * retry and (b) surface honest telemetry. Which findings count as
+ * violations is style-dependent (see styles.ts) — parallels are a defect in
+ * counterpoint and a feature in minimal interlock.
+ *
+ * Pure functions; deterministic; fixture-testable without an LLM.
+ * @since SDK 2.42.0
+ */
+
+type MotionKind = 'contrary' | 'oblique' | 'similar' | 'parallel';
+interface AdjacentPairAnalysis {
+    /** Upper voice index of the pair (pairs with upperVoice + 1). */
+    upperVoice: number;
+    /** Fraction of the upper voice's onsets NOT shared with the lower voice. */
+    onsetIndependence: number;
+    /** Distribution of motion kinds across consecutive shared onsets. */
+    motion: Record<MotionKind, number>;
+    /** Consecutive perfect 5ths/octaves moving in similar motion. */
+    parallelPerfects: Array<{
+        atBeat: number;
+        intervalPc: 0 | 7;
+    }>;
+    /** Beats where the nominally-upper voice sounds BELOW the lower voice. */
+    crossings: number[];
+}
+interface EnsembleAnalysis {
+    pairs: AdjacentPairAnalysis[];
+    /** Fraction of ALL onsets (across voices) that land on a shared beat. */
+    homorhythmScore: number;
+}
+/**
+ * Analyze adjacent voice pairs (voice i against voice i+1, top-down order).
+ * Voices with no notes yield neutral entries rather than poisoning the run.
+ */
+declare function analyzeEnsemble(voices: ReadonlyArray<readonly EnsembleNote[]>): EnsembleAnalysis;
+/**
+ * Render style-filtered violations as short instructions an LLM can act on
+ * in a retry ("Between voice 1 and voice 2, avoid parallel octaves at beat
+ * 6"). Empty array = the ensemble passes this style's soft rules.
+ */
+declare function describeViolations(analysis: EnsembleAnalysis, rules: {
+    forbidParallelPerfects: boolean;
+    forbidVoiceCrossing: boolean;
+    minOnsetIndependence: number;
+}): string[];
+
+/**
+ * ensemble-core: style packs. A style = which SOFT rules are violations +
+ * a prompt paragraph steering the joint composition. Hard rules (register,
+ * per-voice monophony, density caps, root-only anchors) apply to every
+ * style — see enforce-voice.ts. Explicitly NOT just baroque: parallels are
+ * a defect in `counterpoint` and the whole point of `interlock`.
+ *
+ * @since SDK 2.42.0
+ */
+type EnsembleStyle = 'counterpoint' | 'chorale' | 'interlock';
+declare const ENSEMBLE_STYLES: readonly EnsembleStyle[];
+interface EnsembleStyleRules {
+    /** Consecutive perfect 5ths/octaves between adjacent voices are violations. */
+    forbidParallelPerfects: boolean;
+    /** A nominally-upper voice sounding below its neighbor is a violation. */
+    forbidVoiceCrossing: boolean;
+    /**
+     * Minimum fraction of an upper voice's onsets that must NOT coincide with
+     * its lower neighbor (0 = homorhythm fine, 1 = fully independent).
+     */
+    minOnsetIndependence: number;
+    /** Prompt paragraph injected into the system prompt for this style. */
+    promptParagraph: string;
+}
+declare const STYLE_RULES: Record<EnsembleStyle, EnsembleStyleRules>;
+
+/**
+ * ensemble-core: the `submit_ensemble` function-calling contract — how the
+ * ONE joint LLM call returns all voices as structured JSON. Built for
+ * `host.generateWithLLMTools` with `functionCallingConfig.mode: 'ANY'` +
+ * `allowedFunctionNames: [SUBMIT_ENSEMBLE_TOOL_NAME]`, which forces a
+ * schema-constrained call instead of free text (the `generateWithLLM`
+ * `responseFormat` field is a dead letter — this is the reliable path).
+ *
+ * Parsing is defensive: the model's args pass through structural checks and
+ * per-note validation; a voice the model omits comes back as an empty note
+ * list so the caller can decide whether that is acceptable for the style.
+ *
+ * @since SDK 2.42.0
+ */
+
+declare const SUBMIT_ENSEMBLE_TOOL_NAME = "submit_ensemble";
+/**
+ * JSON-Schema `parameters` for the submit_ensemble tool. Gemini function
+ * calling accepts standard JSON Schema here.
+ */
+declare function buildSubmitEnsembleParameters(voiceCount: number): Record<string, unknown>;
+interface ParsedEnsemble {
+    /** Index-aligned: entry v = notes for voiceIndex v (possibly empty). */
+    voiceNotes: EnsembleNote[][];
+    /** Structural oddities worth logging (wrong count, dropped notes…). */
+    warnings: string[];
+}
+/**
+ * Validate + normalize the functionCall args into per-voice note lists.
+ * Returns null only when nothing usable came back.
+ */
+declare function parseEnsembleArgs(args: unknown, voiceCount: number): ParsedEnsemble | null;
+
+/**
+ * ensemble-core: the joint-composition system prompt. ONE call composes ALL
+ * voices together — the coordination (imitation, staggered entrances,
+ * contrary motion) has to be planned across voices, which is exactly what
+ * per-track generation can never do. Mirrors the bass plugin's prompt
+ * discipline: numbered load-bearing rules, register/density contracts
+ * stated per voice, sound selection nowhere in sight (that stays
+ * mechanical, host-side).
+ *
+ * The musical context (key/BPM/chords/contract) arrives via the host's
+ * generateWithLLM(Tools) auto-prefix — this prompt states the ENSEMBLE
+ * rules and the per-voice contracts only.
+ *
+ * @since SDK 2.42.0
+ */
+
+declare function buildEnsembleSystemPrompt(specs: readonly EnsembleVoiceSpec[], style: EnsembleStyle): string;
+/**
+ * Build the retry user-message suffix from soft-rule violations — one
+ * guided second attempt, quota-conscious (callers should not loop).
+ */
+declare function buildViolationRetrySuffix(violations: readonly string[]): string;
+
 /**
  * useSceneState — Scene-keyed state hook for plugin developers.
  *
@@ -5169,7 +5495,7 @@ declare function useAnySolo(host: Pick<PluginHost, 'isAnySoloActive' | 'onTrackS
  * Registry checks semver.gte(PLUGIN_SDK_VERSION, manifest.minHostVersion)
  * during activation and marks incompatible plugins accordingly.
  */
-declare const PLUGIN_SDK_VERSION = "2.40.0";
+declare const PLUGIN_SDK_VERSION = "2.43.0";
 
 /**
  * FX Preset Definitions
@@ -5234,8 +5560,19 @@ declare function dbToSlider(db: number): number;
  * grouped by chord) so the model sees velocity / start-beat /
  * duration / pitch verbatim and can reason about feel + harmony.
  *
+ * Tracks pinned via `PluginGenerationContextOptions.pinTrackDbIds` render
+ * FIRST under a REFERENCE TRACKS header with an explicit counterpoint
+ * instruction — they are the parts the caller asked to write against,
+ * not merely ambient context.
+ *
  * Returns the empty string when there are no concurrent tracks — call
  * sites can `if (block) push(block)` rather than baking in a placeholder.
+ *
+ * NOTE: maintained as byte-identical copies in
+ * `sas-plugin-sdk/src/utils/format-concurrent-tracks.ts` (panels) and
+ * `sas-app/src/shared/utils/format-concurrent-tracks.ts` (main process,
+ * which must not import SDK runtime). The parity test
+ * `format-concurrent-tracks-parity.test.ts` pins the two together.
  */
 
 declare function formatConcurrentTracks(ctx: PluginGenerationContext): string;
@@ -5317,4 +5654,4 @@ interface PickTopKOptions {
  */
 declare function pickTopKWeighted<T>(scored: ReadonlyArray<ScoredCandidate<T>>, options?: PickTopKOptions): T | null;
 
-export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, EQUAL_POWER_GAIN, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupFadeEntry, type GroupFadeEntryOf, type GroupFadeMemberLayer, GroupFadeTrackRow, type GroupFadeTrackRowProps, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusLevels, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PanelTransitionGroupAdapter, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackExternalFxResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VerbatimFadeMember, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildFadeVolumeCurve, buildRowSlots, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, drawWaveform, formatConcurrentTracks, hashString, moveItem, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, splitFadeEntries, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };
+export { AUDIO_EFFECTS, AUDIO_EFFECT_LABEL, type AdjacentPairAnalysis, type AudioEffect, type AudioInputDevice, type BulkAddPlaceholderTrack, type ComposeProgressEvent, type ComposeProgressListener, type ComposeSceneOptions, type ComposeSceneResult, ConfirmDialog, type ConfirmDialogProps, type CoreTrackHandlers, type CreateTrackOptions, type CrossfadeInpaintInput, type CrossfadeLayer, type CrossfadeMeta, CrossfadeModal, type CrossfadeModalProps, type CrossfadePairMeta, type CrossfadeSelection, type CrossfadeSlot, CrossfadeTrackRow, type CrossfadeTrackRowProps, type CrossfadeVolumeCurves, DB_MAX, DB_MIN, DEFAULT_FX_CATEGORY_DETAIL, DEFAULT_FX_DRY_WET, DRAG_DEAD_ZONE, type DeckBoundaryEvent, type DeckBoundaryListener, type DesignerRowSlots, DownloadPackButton, type DownloadPackButtonProps, type DownloadPackButtonVariant, type DrawerTab, type DrumKit, EMPTY_FX_DETAIL_STATE, EMPTY_FX_STATE, ENSEMBLE_MAX_VOICES, ENSEMBLE_MIN_VOICES, ENSEMBLE_STYLES, EQUAL_POWER_GAIN, type EnforceVoiceOptions, type EnforceVoiceResult, type EnsembleAnalysis, type EnsembleNote, type EnsembleStyle, type EnsembleStyleRules, type EnsembleVoiceSpec, type ExportMidiBundleOptions, type ExportMidiBundleResult, type ExportedPluginData, FX_CATEGORIES, FX_CHAIN_ORDER, FX_DISPLAY_LABELS, FX_ENGINE_PLUGIN_NAMES, FX_PRESET_CONFIGS, type FadeDirection, type FadeEntry, type FadeGesture, type FadeLayer, type FadeMeta, FadeModal, type FadeModalProps, type FadeSelection, FadeTrackRow, type FadeTrackRowProps, type FxCategory, type FxCategoryDetailState, type FxPreset, type FxPresetConfig, type FxPresetData, type FxPresetDataEntry, FxToggleBar, type FxToggleBarProps, GUTTER_W, type GenerationServices, type GeneratorPanelAdapter, type GeneratorPanelCore, GeneratorPanelShell, type GeneratorPanelShellProps, type GeneratorPanelSlots, type GeneratorPlugin, type GeneratorTrackState, type GeneratorType, type GroupFadeEntry, type GroupFadeEntryOf, type GroupFadeMemberLayer, GroupFadeTrackRow, type GroupFadeTrackRowProps, type GroupParseSpec, type GroupRenderContext, type ImportCandidateScene, type ImportCandidateTrack, ImportTrackModal, type ImportTrackModalProps, type InstrumentDescriptor, TrackDrawer as InstrumentDrawer, type TrackDrawerProps as InstrumentDrawerProps, type InstrumentSampler, type InstrumentZone, type LLMCandidate, type LLMContent, type LLMFunctionDeclaration, type LLMGenerationConfig, type LLMGenerationRequest, type LLMGenerationResult, type LLMNoteResponse, type LLMPart, type LLMSystemInstruction, type LLMTool, type LLMToolUseRequest, type LLMToolUseResponse, type LLMUsageMetadata, LevelMeter, type LevelMeterProps, type ListAudioFilesOptions, type ListImportableTracksOptions, MIN_NOTE_DURATION_BEATS, type MidiClipData, type MidiWriteResult, type MixInterpolation, Modal, type ModalProps, type MotionKind, type MusicalContext, OffsetScrubber, type OffsetScrubberProps, PLUGIN_SDK_VERSION, PX_PER_BEAT, PanSlider, type PanelBusFxEntry, type PanelBusLevels, type PanelBusState, type PanelFeatureFlags, type PanelGenerationStrategy, type PanelGroupExtension, type PanelIdentity, PanelMasterStrip, type PanelMasterStripProps, type PanelShuffleAdapter, type PanelSoundAdapter, type PanelTransitionGroupAdapter, type ParsedEnsemble, type PeakAnalysis, PianoRollEditor, type PianoRollEditorProps, type PickTopKOptions, type PluginAppTool, type PluginAppToolInputSchema, type PluginAppToolResult, type PluginAudioTextureRequest, type PluginAudioTextureResult, type PluginCapabilities, type PluginChordSegment, type PluginChordTiming, type PluginConcurrentTrackInfo, type PluginCuePoints, type PluginDownloadOptions, PluginError, type PluginErrorCode, type PluginFileDialogOptions, type PluginFxCategoryDetailState, type PluginGenerationContext, type PluginGenerationContextOptions, type PluginHost, type PluginHttpRequestOptions, type PluginHttpResponse, type PluginManifest, type PluginMidiNote, type PluginPresetData, type PluginPresetInfo, type PluginRegistration, type PluginSampleFilter, type PluginSampleImportResult, type PluginSampleInfo, type PluginSampleTrackInfo, type PluginSceneContext, type PluginSceneInfo, type PluginSettingsSchema, type PluginSettingsStore, type PluginSkill, type PluginSkillInputSchema, type PluginStatus, type PluginStemSplitResult, type PluginStemTrackInfo, type PluginSynthInfo, type PluginTrackFxDetailState, type PluginTrackHandle, type PluginTrackInfo, type PluginTrackLevel, type PluginTrackRuntimeState, type PluginTransportState, type PluginTrimWindow, type PluginUIProps, type PostProcessOptions, RESIZE_HANDLE_PX, ROW_HEIGHT, type ReadMidiClip, type ReadMidiResult, type RecordingChunkFinalizedEvent, type RecordingTargetInfo, type ResolveGroupsOptions, type ResolvedCrossfadePair, type ResolvedFade, type ResolvedGroupFade, type ResolvedGroupsResult, type ResolvedTrackGroup, type SDKTrackRowProps, SLIDER_UNITY, STYLE_RULES, SUBMIT_ENSEMBLE_TOOL_NAME, SamplePackCTACard, type SamplePackCTACardProps, type SamplePackCTACardStatus, type SamplePackCardInfo, type SavePluginPresetOptions, type SceneChangeListener, type SceneFamilyTrack, type SceneTrackSummary, type ScoredCandidate, ScrollingWaveform, type ScrollingWaveformProps, type SettingDefinition, type ShufflePresetResult, SorceryProgressBar, type SoundHistoryEntry, type StemType, type SurgeSoundAdapterOverrides, type SynthesizeCuePointsOptions, TEXTURAL_ROLES, TRANSITION_DESIGNER_DRAFT_KEY, TrackDrawer, type TrackDrawerProps, type TrackExternalFxEntry, TrackExternalFxSection, type TrackExternalFxSectionProps, type TrackFxDetailState, type TrackFxState, type TrackGroupMember, type TrackGroupMeta, type TrackLevelsHandle, TrackMeterStrip, type TrackMeterStripProps, type TrackMeterView, TrackRow, type TrackRowDragProps, type TrackSoundHistory, type TrackSoundSnapshot, type TrackStateChangeListener, TransitionDesigner, type TransitionDesignerDraft, type TransitionDesignerProps, type TransitionOps, type TransitionRowType, type TransportEvent, type TransportEventListener, type UnsubscribeFn, type UseGeneratorPanelCoreOptions, type UsePanelBusResult, type UseSoundHistoryOptions, type UseSoundHistoryResult, type UseTrackExternalFxResult, type UseTrackReorderOptions, type UseTrackReorderResult, type UseTransitionOpsInputs, type VerbatimFadeMember, type VolumeAutomationPoint, VolumeSlider, type WaveformPeaks, WaveformView, type WaveformViewProps, analyzeEnsemble, analyzeWavPeak, asAudioEffect, asCrossfadeMeta, asFadeMeta, asTransitionDesignerDraft, buildCrossfadeInpaintPrompt, buildCrossfadeVolumeCurves, buildEnsembleSystemPrompt, buildFadeVolumeCurve, buildRowSlots, buildSubmitEnsembleParameters, buildViolationRetrySuffix, calculateTimeBasedTarget, cellToPx, centerScrollTop, computePeaks, createSurgeSoundAdapter, dbIdsFromKeys, dbToSlider, defaultFadeGesture, defaultVoiceSpecs, describeViolations, drawWaveform, enforceVoice, foldPitchToRegister, formatConcurrentTracks, hashString, moveItem, nearestPitchWithPc, newTrackState, normalizeSlots, padPair, padSlots, parseCrossfadePairs, parseEnsembleArgs, parseFades, parseLLMNoteResponse, parseTrackGroups, pickTopKWeighted, pitchToName, pluginFxToToggleFx, pxToCell, reconcileSlots, resizeNoteDuration, resolveTrackGroups, rowKey, rowType, scorePromptMatch, sliderToDb, slotsEqual, soundIdentity, splitFadeEntries, synthesizeCuePoints, tokenizePrompt, trackDataKey, transposeNotes, useAnySolo, useGeneratorPanelCore, usePanelBus, useSceneState, useSoundHistory, useTrackExternalFx, useTrackLevel, useTrackLevels, useTrackMeter, useTrackReorder, useTransitionOps, useTransportPlaying };