@mcptoolshop/claude-sfx 1.1.2 → 1.2.1

package/dist/verbs.d.ts

@@ -1,6 +1,9 @@
 /**
  * Verb generation engine — profile-driven.
  * Reads synthesis parameters from a Profile, applies modifiers, generates audio.
+ *
+ * Architecture: multi-note motifs in A major pentatonic with constrained variation.
+ * Each verb has 3 variants. Micro-jitter keeps sounds alive without breaking identity.
  */
 import type { Profile } from "./profiles.js";
 export type Status = "ok" | "err" | "warn";
@@ -10,10 +13,12 @@ export interface PlayOptions {
     status?: Status;
     scope?: Scope;
     direction?: Direction;
-    /** Streak intensity level (1-5). Higher = richer harmonics, momentum feel. */
+    /** Streak intensity level (1–5). Higher = richer harmonics, momentum feel. */
     intensity?: number;
-    /** Error escalation level (1-5). Higher = more urgent, dissonant error tone. */
+    /** Error escalation level (1–5). Higher = more urgent, darker tone. */
     escalation?: number;
+    /** Override variant selection (0-indexed). For testing determinism. */
+    variantIndex?: number;
 }
 export type Verb = "intake" | "transform" | "commit" | "navigate" | "execute" | "move" | "sync";
 export declare const VERB_LABELS: Record<Verb, string>;
@@ -24,21 +29,20 @@ export declare function generateVerb(profile: Profile, verb: Verb, options?: Pla
 export declare function generateSessionStart(profile: Profile): Float64Array;
 export declare function generateSessionEnd(profile: Profile): Float64Array;
 export interface SessionOutcome {
-    /** 0.0 = all errors, 1.0 = all successes */
+    /** 0.0 = all errors, 1.0 = all successes. */
     successRatio: number;
-    /** Total plays in the session */
+    /** Total plays in the session. */
     totalPlays: number;
 }
 /**
  * Generate an outcome-aware session end sound.
- *
- * Great session (ratio >= 0.8, 5+ plays): triumphant ascending chord
- * Good session (ratio >= 0.6): standard descending chime (existing behavior)
- * Rough session (ratio < 0.6): muted, lower, shorter resolution
- * Empty session (< 5 plays): standard chime (not enough data)
+ * Great (ratio >= 0.8, 5+ plays): A4 → C#5 → E5 ascending fanfare.
+ * Normal: standard descending chime.
+ * Rough (ratio < 0.6): muted, lower, shorter resolution.
+ * Empty (< 5 plays): standard chime.
  */
 export declare function generateSessionEndWithOutcome(profile: Profile, outcome: SessionOutcome): Float64Array;
 /** Generate a single chunk of the ambient thinking drone. */
 export declare function generateAmbientChunk(profile: Profile): Float64Array;
-/** Generate the resolution stinger (two ascending notes). */
+/** Generate the resolution stinger (two ascending notes, A major). */
 export declare function generateAmbientResolve(profile: Profile): Float64Array;