@signalsandsorcery/plugin-sdk 1.3.1 → 1.3.3

package/README.md

@@ -2,6 +2,12 @@
 
 Plugin SDK for building custom generator plugins for [Signals & Sorcery](https://signalsandsorcery.com) — an AI-powered music production workstation.
 
+<p align="center">
+  <img src="assets/signals-and-sorcery.png" alt="Signals & Sorcery" width="420" />
+</p>
+
+> Part of the **[Signals & Sorcery](https://signalsandsorcery.com)** ecosystem.
+
 Plugins extend the Loop Workstation with custom input generators that create MIDI patterns, manage audio samples, generate AI audio textures, or combine all three. Each plugin gets its own accordion section in the workstation UI and a scoped `PluginHost` API for interacting with tracks, MIDI, audio, and more.
 
 ## Installation
@@ -363,6 +369,18 @@ All errors are `PluginError` instances with a typed `code` property:
 - **Secret isolation** — Each plugin's secrets are encrypted and scoped per plugin
 - **Track limits** — 16 tracks per plugin per scene (configurable)
 
+## The Signals & Sorcery Ecosystem
+
+- **[Signals & Sorcery](https://signalsandsorcery.com)** — the flagship AI music production workstation
+- **[sas-synth-plugin](https://github.com/shiehn/sas-synth-plugin)** — AI MIDI generation with Surge XT
+- **[sas-sample-plugin](https://github.com/shiehn/sas-sample-plugin)** — Sample library browser with time-stretching
+- **[sas-audio-plugin](https://github.com/shiehn/sas-audio-plugin)** — AI audio texture generation
+- **[DeclarAgent](https://github.com/shiehn/DeclarAgent)** — Declarative agent + MCP transport for S&S
+
+<p align="center">
+  <a href="https://signalsandsorcery.com">signalsandsorcery.com</a>
+</p>
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -145,6 +145,20 @@ interface PluginHost {
     setTrackSolo(trackId: string, solo: boolean): Promise<void>;
     /** Rename a track. Only works on owned tracks. */
     setTrackName(trackId: string, name: string): Promise<void>;
+    /**
+     * Persist a track's musical role to the `tracks.role` column. Call this
+     * after an LLM generation classifies the track (e.g. `'bass'`, `'lead'`,
+     * `'pad'`, `'fx'`, `'kicks'`) so downstream features — especially the v1
+     * transition generator's layer classifier — can see the role.
+     *
+     * Canonical values understood by the transition classifier include
+     * `bass`, `drums`, `lead`, `chords`, `pad`, `arp`, `fx`, `kicks`,
+     * `snares`, `hats`, `clap`, `perc`, `riser`, `impact`. Anything else is
+     * stored verbatim but won't match the neutral-role set.
+     *
+     * Only works on owned tracks.
+     */
+    setTrackRole(trackId: string, role: string): Promise<void>;
     /** Shuffle preset: keep MIDI, apply a random preset from the same category. Only works on owned tracks. */
     shufflePreset(trackId: string): Promise<ShufflePresetResult>;
     /** Duplicate track: copy MIDI + role to a new track with a different preset. Only works on owned tracks. */

package/dist/index.d.ts

@@ -145,6 +145,20 @@ interface PluginHost {
     setTrackSolo(trackId: string, solo: boolean): Promise<void>;
     /** Rename a track. Only works on owned tracks. */
     setTrackName(trackId: string, name: string): Promise<void>;
+    /**
+     * Persist a track's musical role to the `tracks.role` column. Call this
+     * after an LLM generation classifies the track (e.g. `'bass'`, `'lead'`,
+     * `'pad'`, `'fx'`, `'kicks'`) so downstream features — especially the v1
+     * transition generator's layer classifier — can see the role.
+     *
+     * Canonical values understood by the transition classifier include
+     * `bass`, `drums`, `lead`, `chords`, `pad`, `arp`, `fx`, `kicks`,
+     * `snares`, `hats`, `clap`, `perc`, `riser`, `impact`. Anything else is
+     * stored verbatim but won't match the neutral-role set.
+     *
+     * Only works on owned tracks.
+     */
+    setTrackRole(trackId: string, role: string): Promise<void>;
     /** Shuffle preset: keep MIDI, apply a random preset from the same category. Only works on owned tracks. */
     shufflePreset(trackId: string): Promise<ShufflePresetResult>;
     /** Duplicate track: copy MIDI + role to a new track with a different preset. Only works on owned tracks. */