@map-audio/pam-mcp-server 1.22.0 → 1.27.0

package/dist/patternLanes.js

@@ -0,0 +1,108 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const VALUE_LANES = ["pitch", "slice", "stretch"];
+export const CC_LANES = ["ccOut1", "ccOut2", "ccOut3", "ccOut4"];
+export const PARAM_LANES = ["paramLane1", "paramLane2", "paramLane3", "paramLane4"];
+export const PATTERN_LANE_IDS = ["note", ...VALUE_LANES, ...CC_LANES, ...PARAM_LANES];
+/** State-key suffix per lane: `cell{N}_<suffix>`. */
+export const PATTERN_LANE_SUFFIX = {
+    note: "midiSequence",
+    pitch: "pitchSequence",
+    slice: "sliceSequence",
+    stretch: "stretchSequence",
+    ccOut1: "ccOut1Sequence",
+    ccOut2: "ccOut2Sequence",
+    ccOut3: "ccOut3Sequence",
+    ccOut4: "ccOut4Sequence",
+    paramLane1: "paramLane1Sequence",
+    paramLane2: "paramLane2Sequence",
+    paramLane3: "paramLane3Sequence",
+    paramLane4: "paramLane4Sequence",
+};
+/** The cells-object field holding a param lane's target suffix ("" = none). */
+export const LANE_TARGET_FIELD = {
+    paramLane1: "paramLaneTarget1",
+    paramLane2: "paramLaneTarget2",
+    paramLane3: "paramLaneTarget3",
+    paramLane4: "paramLaneTarget4",
+};
+export const isCcLane = (lane) => CC_LANES.includes(lane);
+export const isParamLane = (lane) => PARAM_LANES.includes(lane);
+export const ccLaneIndex = (lane) => Number(lane.slice("ccOut".length));
+/** Sixteen CC out slots per cell (cell config ccOutCc{K}); each CC lane locks one (ccLaneSlot{L}, 0 = none). */
+export const CC_OUT_SLOTS = Array.from({ length: 16 }, (_, index) => index + 1);
+export const CC_OUT_CONFIG_KEYS = CC_OUT_SLOTS.map((slot) => `ccOutCc${slot}`);
+export const isCcOutValueSuffix = (suffix) => /^ccOut\d{1,2}$/.test(suffix);
+export const ccLaneSlotField = (lane) => `ccLaneSlot${ccLaneIndex(lane)}`;
+/** The slot a CC lane locks in `cell`, as the engine reads it: lane L's default is slot L. */
+export function ccLaneSlotOf(cell, lane) {
+    const raw = cell[ccLaneSlotField(lane)];
+    const slot = Math.round(Number(raw ?? ccLaneIndex(lane)));
+    return Number.isInteger(slot) && slot >= 1 && slot <= CC_OUT_SLOTS.length ? slot : 0;
+}
+// shared/patternLanes/targetDenylist.json is the one list the UI, this server and the engine read.
+const TARGET_DENYLIST = (() => {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(here, "..", "..", "..", "shared", "patternLanes", "targetDenylist.json"),
+        resolve(here, "targetDenylist.json"),
+    ];
+    for (const file of candidates) {
+        if (!existsSync(file))
+            continue;
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        return { exact: parsed.exact ?? [], prefixes: parsed.prefixes ?? [], unreachable: parsed.unreachable ?? [] };
+    }
+    throw new Error("pam-mcp: shared/patternLanes/targetDenylist.json not found; rebuild the package.");
+})();
+function isDeniedLaneTarget(suffix) {
+    return (TARGET_DENYLIST.exact.includes(suffix) ||
+        TARGET_DENYLIST.unreachable.includes(suffix) ||
+        TARGET_DENYLIST.prefixes.some((prefix) => suffix.startsWith(prefix)));
+}
+/** The manifest parameter a param lane may be pointed at, or a reason it may not. */
+export function resolveLaneTarget(cellId, suffix, parameters) {
+    if (isDeniedLaneTarget(suffix))
+        return { reason: `${suffix} cannot be a lane target` };
+    const param = parameters.find((p) => p.paramId === `cell${cellId}_${suffix}`);
+    if (!param)
+        return { reason: `cell${cellId}_${suffix} is not a parameter of this product` };
+    if (param.isModulatable !== true)
+        return { reason: `cell${cellId}_${suffix} is not modulatable` };
+    return { param };
+}
+export function productHasLane(cellId, lane, stateVariables) {
+    const key = `cell${cellId}_${PATTERN_LANE_SUFFIX[lane]}`;
+    return (stateVariables ?? []).some((entry) => entry.paramId === key);
+}
+const finiteOr = (value, fallback) => typeof value === "number" && Number.isFinite(value) ? value : fallback;
+/** CC lane events: integer 0..127 values, bar height equal to the value (a CC bar floors at 0), no pitch fields. */
+export function normalizeCcLaneEvents(events) {
+    return events.map((event) => {
+        const { pitch: _pitch, pitchRnd: _pitchRnd, ...rest } = event;
+        const value = Math.max(0, Math.min(127, Math.round(finiteOr(event.value, 64))));
+        return { time: 0, duration: 0.25, prob: 1, ...rest, value, velocity: value };
+    });
+}
+// Steps a value like its knob (interface/src/utils/paramScale.ts), so the lane holds what the knob could.
+function stepLikeKnob(value, param) {
+    return param.step > 0 && param.step < param.max - param.min ? Math.round(value / param.step) * param.step : value;
+}
+/** A param lane's events, clamped to its target's range and stepped like its knob. */
+export function normalizeTargetLaneEvents(events, param) {
+    const span = param.max - param.min;
+    return events.map((event) => {
+        const { pitch: _pitch, pitchRnd: _pitchRnd, ...rest } = event;
+        const clamp = (v) => Math.max(param.min, Math.min(param.max, v));
+        const value = clamp(stepLikeKnob(clamp(finiteOr(event.value, param.defaultValue)), param));
+        const normalized = span > 0 ? Math.pow((value - param.min) / span, param.skew) : 0;
+        return { time: 0, duration: 0.25, prob: 1, ...rest, value, velocity: Math.round(normalized * 127) };
+    });
+}
+/** A CC lane may land on a destination slot only when that slot is Off or wired to the same controller. */
+export function ccLaneMayLand(sourceController, destinationController) {
+    const dst = typeof destinationController === "number" ? destinationController : -1;
+    return dst < 0 || dst === sourceController;
+}
+//# sourceMappingURL=patternLanes.js.map

package/dist/patternLanes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patternLanes.js","sourceRoot":"","sources":["../src/patternLanes.ts"],"names":[],"mappings":"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"}

package/dist/players.d.ts

@@ -0,0 +1,89 @@
+export interface PlayerSlotSpec {
+    label: string;
+    default: number;
+    steps?: number;
+    stepLabels?: string[];
+    hint?: string;
+    center?: boolean;
+}
+export interface PlayerSpec {
+    id: number;
+    name: string;
+    tag: "drum" | "melodic" | "both";
+    replay: boolean;
+    blurb: string;
+    defaults: {
+        density: number;
+        mutate: number;
+    };
+    slots: PlayerSlotSpec[];
+}
+export interface PlayerPreset {
+    name: string;
+    density: number;
+    mutate: number;
+    p: number[];
+}
+export declare const PLAYER_SLOT_FIELDS: readonly ["playerP1", "playerP2", "playerP3", "playerP4", "playerP5"];
+export type PlayerSlotField = (typeof PLAYER_SLOT_FIELDS)[number];
+export type PlayerField = "playerDensity" | "playerMutate" | PlayerSlotField;
+/** The seven fields that are ALSO manifest params: every write must reach both. */
+export declare const MODULATABLE_PLAYER_FIELDS: readonly PlayerField[];
+export declare const LISTEN_MODES: readonly ["off", "complement", "answer", "harmonic"];
+export type ListenModeName = (typeof LISTEN_MODES)[number];
+export declare const PATTERN_MODES: readonly ["mask", "keep"];
+export type PatternModeName = (typeof PATTERN_MODES)[number];
+/** "No arm on record" in the persisted poly ledger (interface/src/utils/playerPolyArm.ts). */
+export declare const NO_POLY_ARM = -1;
+export declare const PLAYER_GENRES: readonly ["boom_bap", "trap", "drill", "house", "techno", "dnb", "idm"];
+export type PlayerGenre = (typeof PLAYER_GENRES)[number];
+export declare const GENERATIVE_PLAYERS: PlayerSpec[];
+export declare const PLAYER_NAMES: string[];
+export declare const getPlayerSpec: (type: number) => PlayerSpec | undefined;
+/** A roster name (any case) or a numeric id; undefined for anything else. */
+export declare function resolvePlayerSpec(ref: string | number): PlayerSpec | undefined;
+export declare const playerPresetsFor: (type: number) => PlayerPreset[];
+export declare function resolvePlayerPreset(spec: PlayerSpec, name: string): PlayerPreset | undefined;
+/** The roster's own voicing for a type pick — what setCellPlayer seeds before the caller's fields. */
+export declare function playerDefaultsFor(type: number): Record<string, number>;
+export declare function presetConfig(preset: PlayerPreset): Record<string, number>;
+/** A detented field writes exactly i/(steps-1); continuous is the clamped identity. */
+export declare function snapPlayerValue(steps: number | undefined, value: number): number;
+export declare function playerSlotStepIndex(slot: PlayerSlotSpec, value: number): number;
+export declare function playerSlotDisplay(slot: PlayerSlotSpec, value: number): string;
+export declare const playerDensityDisplay: (value: number) => string;
+export declare const playerMutateDisplay: (value: number) => string;
+/**
+ * A slot write from an agent: a 0..1 position (snapped to the slot's detents) or,
+ * on a labelled slot, one of its step labels. Returns an error string on a miss.
+ */
+export declare function resolveSlotValue(slot: PlayerSlotSpec, input: number | string): number | string;
+export interface PlayerGenreSlot {
+    index: number;
+    genres: PlayerGenre[];
+}
+/** The slot whose detents all name randomizer genres — found from the registry, never hardcoded. */
+export declare function playerGenreSlot(spec: PlayerSpec | undefined): PlayerGenreSlot | undefined;
+export declare function playerGenreConfig(spec: PlayerSpec | undefined, genre: string | undefined): Record<string, number>;
+export interface RolePlayerConfig {
+    playerType: number;
+    playerP1?: number;
+    playerP5?: number;
+    isPoly?: number;
+}
+export declare const DEFAULT_PLAYER_TYPE = 2;
+export declare const rolePlayerConfigFor: (cellId: number) => RolePlayerConfig;
+export declare const roleSpreadSummary: () => Record<number, string>;
+export declare const isMelodicPlayer: (spec: PlayerSpec | undefined) => boolean;
+/** uint31 so the seed round-trips through every JSON/number layer intact. */
+export declare const randomPlayerSeed: () => number;
+export declare const cellPlayerType: (cell: Record<string, unknown> | undefined) => number;
+/**
+ * Human-readable summary of a cell's running player. The seven modulatable
+ * fields are read from the PARAMS (`cell{N}_player*`) with the config as the
+ * fallback, because only a UI write mirrors the two and an automated move
+ * leaves the config behind.
+ */
+export declare function describeCellPlayer(cellId: number, cell: Record<string, unknown> | undefined, state: Record<string, unknown>): Record<string, unknown> | undefined;
+/** The roster as an agent-facing catalogue: one entry per player, presets attached. */
+export declare function describePlayerSpec(spec: PlayerSpec, includePresets: boolean): Record<string, unknown>;

package/dist/players.js

@@ -0,0 +1,235 @@
+// Generative Players (per-cell PLAYER mode) for the MCP server, read from the
+// two shared registries build.js and the UI consume; vendored into dist/ by
+// scripts/build-postprocess.mjs.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const PLAYER_SLOT_FIELDS = ["playerP1", "playerP2", "playerP3", "playerP4", "playerP5"];
+/** The seven fields that are ALSO manifest params: every write must reach both. */
+export const MODULATABLE_PLAYER_FIELDS = ["playerDensity", "playerMutate", ...PLAYER_SLOT_FIELDS];
+export const LISTEN_MODES = ["off", "complement", "answer", "harmonic"];
+export const PATTERN_MODES = ["mask", "keep"];
+/** "No arm on record" in the persisted poly ledger (interface/src/utils/playerPolyArm.ts). */
+export const NO_POLY_ARM = -1;
+export const PLAYER_GENRES = ["boom_bap", "trap", "drill", "house", "techno", "dnb", "idm"];
+function readRegistry(fileName, valid) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(here, "..", "..", "..", "shared", fileName), // repo checkout
+        resolve(here, fileName), // published dist/
+    ];
+    for (const file of candidates) {
+        if (!existsSync(file))
+            continue;
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        if (valid(parsed))
+            return parsed;
+    }
+    throw new Error(`pam-mcp: ${fileName} not found. Rebuild the package (scripts/build-postprocess.mjs vendors it into dist/) — ` +
+        "arming a player without it would write values that disagree with the plugin.");
+}
+const REGISTRY = readRegistry("generativePlayers.json", (parsed) => !!parsed.players && Object.keys(parsed.players).length > 0);
+const PRESETS = readRegistry("generativePlayerPresets.json", (parsed) => !!parsed.presets);
+export const GENERATIVE_PLAYERS = Object.keys(REGISTRY.players)
+    .map(Number)
+    .sort((a, b) => a - b)
+    .map((id) => ({ id, ...REGISTRY.players[String(id)] }));
+const BY_ID = new Map(GENERATIVE_PLAYERS.map((spec) => [spec.id, spec]));
+const BY_NAME = new Map(GENERATIVE_PLAYERS.map((spec) => [spec.name.toLowerCase(), spec]));
+export const PLAYER_NAMES = GENERATIVE_PLAYERS.map((spec) => spec.name);
+export const getPlayerSpec = (type) => BY_ID.get(Math.round(type));
+/** A roster name (any case) or a numeric id; undefined for anything else. */
+export function resolvePlayerSpec(ref) {
+    if (typeof ref === "number")
+        return getPlayerSpec(ref);
+    const trimmed = ref.trim();
+    if (/^\d+$/.test(trimmed))
+        return getPlayerSpec(Number(trimmed));
+    return BY_NAME.get(trimmed.toLowerCase());
+}
+export const playerPresetsFor = (type) => PRESETS.presets[String(Math.round(type))] ?? [];
+export function resolvePlayerPreset(spec, name) {
+    const wanted = name.trim().toLowerCase();
+    return playerPresetsFor(spec.id).find((preset) => preset.name.toLowerCase() === wanted);
+}
+/** The roster's own voicing for a type pick — what setCellPlayer seeds before the caller's fields. */
+export function playerDefaultsFor(type) {
+    const spec = getPlayerSpec(type);
+    const out = {
+        playerType: type,
+        playerDensity: spec?.defaults.density ?? 0.5,
+        playerMutate: spec?.defaults.mutate ?? 0.25,
+    };
+    PLAYER_SLOT_FIELDS.forEach((field, i) => {
+        out[field] = spec?.slots[i]?.default ?? 0.5;
+    });
+    return out;
+}
+export function presetConfig(preset) {
+    const out = { playerDensity: preset.density, playerMutate: preset.mutate };
+    preset.p.forEach((value, i) => {
+        const field = PLAYER_SLOT_FIELDS[i];
+        if (field)
+            out[field] = value;
+    });
+    return out;
+}
+/** A detented field writes exactly i/(steps-1); continuous is the clamped identity. */
+export function snapPlayerValue(steps, value) {
+    const clamped = Math.max(0, Math.min(1, value));
+    if (!steps || steps < 2)
+        return clamped;
+    return Math.round(clamped * (steps - 1)) / (steps - 1);
+}
+export function playerSlotStepIndex(slot, value) {
+    if (!slot.steps || slot.steps < 2)
+        return 0;
+    const clamped = Math.max(0, Math.min(1, value));
+    return Math.max(0, Math.min(slot.steps - 1, Math.round(clamped * (slot.steps - 1))));
+}
+export function playerSlotDisplay(slot, value) {
+    if (slot.steps && slot.stepLabels)
+        return slot.stepLabels[playerSlotStepIndex(slot, value)] ?? "";
+    if (slot.steps && slot.steps >= 2)
+        return String(playerSlotStepIndex(slot, value));
+    const clamped = Math.max(0, Math.min(1, value));
+    if (slot.center) {
+        const signed = Math.round((clamped - 0.5) * 200);
+        return signed > 0 ? `+${signed}%` : `${signed}%`;
+    }
+    return `${Math.round(clamped * 100)}%`;
+}
+export const playerDensityDisplay = (value) => `${Math.round(value * 100)}%`;
+export const playerMutateDisplay = (value) => (value < 0.02 ? "Lock" : `${Math.round(value * 100)}%`);
+/**
+ * A slot write from an agent: a 0..1 position (snapped to the slot's detents) or,
+ * on a labelled slot, one of its step labels. Returns an error string on a miss.
+ */
+export function resolveSlotValue(slot, input) {
+    if (typeof input === "number")
+        return snapPlayerValue(slot.steps, input);
+    const wanted = input.trim().toLowerCase();
+    if (slot.stepLabels && slot.steps) {
+        const index = slot.stepLabels.findIndex((label) => label.toLowerCase() === wanted);
+        if (index >= 0)
+            return index / (slot.steps - 1);
+        return `'${input}' is not a ${slot.label} position — one of: ${slot.stepLabels.join(", ")}.`;
+    }
+    const numeric = Number(wanted.replace(/%$/, ""));
+    if (Number.isFinite(numeric))
+        return snapPlayerValue(slot.steps, wanted.endsWith("%") ? numeric / 100 : numeric);
+    return `${slot.label} takes a 0..1 value${slot.steps ? ` (${slot.steps} detents)` : ""}, not '${input}'.`;
+}
+const normalizeGenre = (label) => {
+    const lowered = label.toLowerCase().trim().replace(/-/g, "_").replace(/\s+/g, "_");
+    return PLAYER_GENRES.includes(lowered) ? lowered : undefined;
+};
+/** The slot whose detents all name randomizer genres — found from the registry, never hardcoded. */
+export function playerGenreSlot(spec) {
+    if (!spec)
+        return undefined;
+    for (let index = 0; index < spec.slots.length; index++) {
+        const labels = spec.slots[index].stepLabels;
+        if (!labels || labels.length === 0)
+            continue;
+        const genres = labels.map(normalizeGenre);
+        if (genres.every((genre) => genre !== undefined))
+            return { index, genres };
+    }
+    return undefined;
+}
+export function playerGenreConfig(spec, genre) {
+    const slot = spec ? playerGenreSlot(spec) : undefined;
+    const wanted = genre ? normalizeGenre(genre) : undefined;
+    if (!spec || !slot || !wanted)
+        return {};
+    const position = slot.genres.indexOf(wanted);
+    if (position < 0)
+        return {};
+    const steps = spec.slots[slot.index].steps ?? 1;
+    return { [PLAYER_SLOT_FIELDS[slot.index]]: position / (steps - 1) };
+}
+// Twin of ROLE_PLAYER_CONFIGS in interface/src/utils/generativePlayers.ts
+// (KIT's positional cellId → role table); scripts/check-parity.mjs diffs them.
+const ROLE_PLAYER_CONFIGS = {
+    1: { playerType: 2 },
+    2: { playerType: 6, playerP1: 1 / 3 },
+    3: { playerType: 1 },
+    4: { playerType: 7 },
+    5: { playerType: 4, isPoly: 1 },
+    6: { playerType: 3 },
+    7: { playerType: 5, playerP5: 2 / 5, isPoly: 1 },
+    8: { playerType: 8, playerP5: 3 / 5, isPoly: 1 },
+};
+export const DEFAULT_PLAYER_TYPE = 2;
+export const rolePlayerConfigFor = (cellId) => ROLE_PLAYER_CONFIGS[cellId] ?? { playerType: DEFAULT_PLAYER_TYPE };
+export const roleSpreadSummary = () => Object.fromEntries(Object.entries(ROLE_PLAYER_CONFIGS).map(([cellId, config]) => [
+    Number(cellId),
+    getPlayerSpec(config.playerType)?.name ?? String(config.playerType),
+]));
+export const isMelodicPlayer = (spec) => spec?.tag === "melodic";
+/** uint31 so the seed round-trips through every JSON/number layer intact. */
+export const randomPlayerSeed = () => Math.floor(Math.random() * 0x7fffffff);
+export const cellPlayerType = (cell) => Math.round(Number(cell?.playerType ?? 0));
+const numberOr = (value, fallback) => {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : fallback;
+};
+/**
+ * Human-readable summary of a cell's running player. The seven modulatable
+ * fields are read from the PARAMS (`cell{N}_player*`) with the config as the
+ * fallback, because only a UI write mirrors the two and an automated move
+ * leaves the config behind.
+ */
+export function describeCellPlayer(cellId, cell, state) {
+    const type = cellPlayerType(cell);
+    const spec = getPlayerSpec(type);
+    if (!spec)
+        return undefined;
+    const readField = (field, fallback) => numberOr(state[`cell${cellId}_${field}`], numberOr(cell?.[field], fallback));
+    const slots = {};
+    spec.slots.forEach((slot, i) => {
+        const field = PLAYER_SLOT_FIELDS[i];
+        slots[slot.label] = playerSlotDisplay(slot, readField(field, slot.default));
+    });
+    const density = readField("playerDensity", spec.defaults.density);
+    const mutate = readField("playerMutate", spec.defaults.mutate);
+    const listenMode = Math.round(numberOr(cell?.playerListenMode, 0));
+    return {
+        id: spec.id,
+        name: spec.name,
+        density: playerDensityDisplay(density),
+        mutate: playerMutateDisplay(mutate),
+        slots,
+        seed: Math.round(numberOr(cell?.playerSeed, 0)),
+        patternMode: PATTERN_MODES[Math.round(numberOr(cell?.playerPatternMode, 0))] ?? "mask",
+        listen: listenMode > 0
+            ? {
+                mode: LISTEN_MODES[listenMode] ?? "off",
+                source: Math.round(numberOr(cell?.playerListenSource, 0)),
+                amount: numberOr(cell?.playerListenAmount, 0.5),
+            }
+            : undefined,
+    };
+}
+/** The roster as an agent-facing catalogue: one entry per player, presets attached. */
+export function describePlayerSpec(spec, includePresets) {
+    return {
+        id: spec.id,
+        name: spec.name,
+        tag: spec.tag,
+        blurb: spec.blurb,
+        defaults: spec.defaults,
+        slots: spec.slots.map((slot, i) => ({
+            arg: `p${i + 1}`,
+            label: slot.label,
+            default: slot.default,
+            ...(slot.steps && slot.steps >= 2
+                ? { detents: slot.steps, ...(slot.stepLabels ? { positions: slot.stepLabels } : {}) }
+                : { range: slot.center ? "bipolar 0..1, centre 0.5" : "0..1" }),
+            ...(slot.hint ? { hint: slot.hint } : {}),
+        })),
+        ...(includePresets ? { presets: playerPresetsFor(spec.id).map((preset) => preset.name) } : {}),
+    };
+}
+//# sourceMappingURL=players.js.map

package/dist/players.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"players.js","sourceRoot":"","sources":["../src/players.ts"],"names":[],"mappings":"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"}

package/dist/presetSave.d.ts

@@ -1,5 +1,9 @@
+import { Buffer } from "node:buffer";
 /** Strip the library prefix accepted by MCP tools before resolving a preset on disk. */
 export declare function normalizePresetLookupPath(presetPath: string): string;
+/** Native resolves relative preset paths against the product base folder, which holds Presets/. */
+export declare function nativePresetPath(presetPath: string): string;
+export declare function isFactoryPresetPath(presetPath: string): boolean;
 /**
  * Select the preset whose variation bank a save operation should preserve.
  *
@@ -8,3 +12,7 @@ export declare function normalizePresetLookupPath(presetPath: string): string;
  * destination remains the only useful source (for explicit-path overwrites).
  */
 export declare function selectSaveVariationSourcePath(activePresetPath: unknown, destinationPath: string): string;
+export declare function parsePresetFile(raw: string | Buffer): {
+    metadata: Record<string, unknown>;
+    data: Record<string, unknown>;
+};

package/dist/presetSave.js

@@ -1,9 +1,23 @@
+import { Buffer } from "node:buffer";
+import { isAbsolute, posix } from "node:path";
 /** Strip the library prefix accepted by MCP tools before resolving a preset on disk. */
 export function normalizePresetLookupPath(presetPath) {
     return presetPath.startsWith("Presets/")
         ? presetPath.slice("Presets/".length)
         : presetPath;
 }
+/** Native resolves relative preset paths against the product base folder, which holds Presets/. */
+export function nativePresetPath(presetPath) {
+    if (isAbsolute(presetPath))
+        return presetPath;
+    const normalized = presetPath.replaceAll("\\", "/");
+    return /^presets\//i.test(normalized) ? normalized : `Presets/${normalized}`;
+}
+// Native collapses "." / ".." / "//" and the macOS volume is case-insensitive, so match that form.
+export function isFactoryPresetPath(presetPath) {
+    const resolved = posix.normalize(nativePresetPath(presetPath).replaceAll("\\", "/")).toLowerCase();
+    return /(^|\/)presets\/(factory|default)\//.test(resolved);
+}
 /**
  * Select the preset whose variation bank a save operation should preserve.
  *
@@ -19,4 +33,25 @@ export function selectSaveVariationSourcePath(activePresetPath, destinationPath)
     }
     return normalizePresetLookupPath(destinationPath);
 }
+export function parsePresetFile(raw) {
+    const bytes = typeof raw === "string" ? Buffer.from(raw, "utf8") : raw;
+    let prefixLength = 0;
+    while (bytes[prefixLength] >= 48 && bytes[prefixLength] <= 57)
+        prefixLength++;
+    if (prefixLength === 0)
+        throw new Error("invalid format (no metadata size prefix)");
+    const metadataSize = Number(bytes.toString("ascii", 0, prefixLength));
+    const dataOffset = prefixLength + metadataSize;
+    if (!Number.isSafeInteger(metadataSize) || metadataSize <= 0 || dataOffset >= bytes.length) {
+        throw new Error("invalid format (metadata size out of bounds)");
+    }
+    const metadata = JSON.parse(bytes.toString("utf8", prefixLength, dataOffset));
+    const data = JSON.parse(bytes.toString("utf8", dataOffset));
+    for (const value of [metadata, data]) {
+        if (value === null || typeof value !== "object" || Array.isArray(value)) {
+            throw new Error("invalid format (metadata and data must be objects)");
+        }
+    }
+    return { metadata, data };
+}
 //# sourceMappingURL=presetSave.js.map

package/dist/presetSave.js.map

@@ -1 +1 @@
-{"version":3,"file":"presetSave.js","sourceRoot":"","sources":["../src/presetSave.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,OAAO,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC;QACtC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QACrC,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,gBAAyB,EACzB,eAAuB;IAEvB,IACE,OAAO,gBAAgB,KAAK,QAAQ;QACpC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAC3B,gBAAgB,KAAK,MAAM,EAC3B,CAAC;QACD,OAAO,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,yBAAyB,CAAC,eAAe,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"presetSave.js","sourceRoot":"","sources":["../src/presetSave.ts"],"names":[],"mappings":"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"}

package/dist/sampleSlicing.d.ts

@@ -0,0 +1,12 @@
+import type { WavData } from "./audioAnalysis.js";
+/** interface/src/stores/SliceProperties.ts MAX_SLICES */
+export declare const MAX_SLICES = 64;
+/** Sorted, clamped, deduplicated 0..1 boundaries that always start at 0 and end at 1. */
+export declare function normalizeBoundaries(input: number[]): number[];
+export declare function equalBoundaries(count: number): number[];
+/**
+ * Onset positions (0..1 of the file) from half-wave-rectified log-energy
+ * flux, peak-picked with a 40 ms refractory window. `sensitivity` 0..1 lowers
+ * the threshold; at most `maxSlices - 1` onsets survive, strongest first.
+ */
+export declare function detectOnsetBoundaries(wav: WavData, sensitivity?: number, maxSlices?: number): number[];

package/dist/sampleSlicing.js

@@ -0,0 +1,78 @@
+// Slice-boundary helpers for set_slices: boundary normalisation, equal division
+// and a plain energy-onset detector over a decoded WAV (no plugin round trip).
+/** interface/src/stores/SliceProperties.ts MAX_SLICES */
+export const MAX_SLICES = 64;
+/** Sorted, clamped, deduplicated 0..1 boundaries that always start at 0 and end at 1. */
+export function normalizeBoundaries(input) {
+    const points = input
+        .map((v) => Math.max(0, Math.min(1, Number(v))))
+        .filter((v) => Number.isFinite(v))
+        .sort((a, b) => a - b);
+    const out = [0];
+    for (const p of points) {
+        if (p - out[out.length - 1] > 1e-4 && p < 1 - 1e-4)
+            out.push(p);
+    }
+    out.push(1);
+    return out;
+}
+export function equalBoundaries(count) {
+    const n = Math.max(1, Math.min(MAX_SLICES, Math.round(count)));
+    return Array.from({ length: n + 1 }, (_, i) => i / n);
+}
+/**
+ * Onset positions (0..1 of the file) from half-wave-rectified log-energy
+ * flux, peak-picked with a 40 ms refractory window. `sensitivity` 0..1 lowers
+ * the threshold; at most `maxSlices - 1` onsets survive, strongest first.
+ */
+export function detectOnsetBoundaries(wav, sensitivity = 0.5, maxSlices = 32) {
+    const { samples, sampleRate } = wav;
+    const hop = Math.max(64, Math.round(sampleRate * 0.0058));
+    const frames = Math.floor(samples.length / hop);
+    if (frames < 4)
+        return [0, 1];
+    const energy = new Float64Array(frames);
+    for (let f = 0; f < frames; f++) {
+        let sum = 0;
+        const start = f * hop;
+        for (let i = 0; i < hop; i++) {
+            const s = samples[start + i];
+            sum += s * s;
+        }
+        energy[f] = 10 * Math.log10(sum / hop + 1e-10);
+    }
+    const flux = new Float64Array(frames);
+    let mean = 0;
+    for (let f = 1; f < frames; f++) {
+        flux[f] = Math.max(0, energy[f] - energy[f - 1]);
+        mean += flux[f];
+    }
+    mean /= frames - 1;
+    let variance = 0;
+    for (let f = 1; f < frames; f++)
+        variance += (flux[f] - mean) ** 2;
+    const std = Math.sqrt(variance / Math.max(1, frames - 2));
+    const clampedSensitivity = Math.max(0, Math.min(1, sensitivity));
+    const threshold = mean + (2.5 - 2.0 * clampedSensitivity) * std;
+    const floorDb = -60;
+    const refractory = Math.max(1, Math.round((sampleRate * 0.04) / hop));
+    const peaks = [];
+    let lastPeak = -refractory;
+    for (let f = 2; f < frames - 1; f++) {
+        if (flux[f] < threshold || energy[f] < floorDb)
+            continue;
+        if (flux[f] < flux[f - 1] || flux[f] < flux[f + 1])
+            continue;
+        if (f - lastPeak < refractory)
+            continue;
+        peaks.push({ frame: f - 1, strength: flux[f] });
+        lastPeak = f;
+    }
+    const keep = Math.max(0, Math.min(MAX_SLICES, Math.round(maxSlices)) - 1);
+    const chosen = peaks
+        .sort((a, b) => b.strength - a.strength)
+        .slice(0, keep)
+        .map((p) => (p.frame * hop) / samples.length);
+    return normalizeBoundaries(chosen);
+}
+//# sourceMappingURL=sampleSlicing.js.map