@jxgame2020/dsh-token-quota 0.1.23 → 0.1.26

package/lib/client.js

@@ -40,6 +40,7 @@ window.__ModuleLoader__.load({
 					musicEnabled: false,
 					musicVolume: .5,
 					musicStyle: "major",
+					musicOnlyCurrentSession: true,
 					upgrade: null,
 					upgradeDismissed: false,
 					checkingUpdates: false,
@@ -90,8 +91,11 @@ window.__ModuleLoader__.load({
 					setMusicStyle: (d, style) => {
 						d.musicStyle = style;
 					},
+					setMusicOnlyCurrentSession: (d, only) => {
+						d.musicOnlyCurrentSession = only;
+					},
 					setUpgrade: (d, upgrade) => {
-						const normalized = upgrade !== null && upgrade.latestVersion !== "" && upgrade.latestVersion !== "0.1.23" ? upgrade : null;
+						const normalized = upgrade !== null && upgrade.latestVersion !== "" && upgrade.latestVersion !== "0.1.26" ? upgrade : null;
 						if (d.upgrade === null || d.upgrade.latestVersion !== normalized?.latestVersion) d.upgradeDismissed = false;
 						d.upgrade = normalized;
 					},
@@ -197,92 +201,92 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var TokenQuotaPanel_module_css_default = {
-			"row": "NPLLIq_row",
-			"upgradeBannerFlash": "NPLLIq_upgradeBannerFlash",
-			"bar": "NPLLIq_bar",
+			"checkBtn": "NPLLIq_checkBtn",
+			"body": "NPLLIq_body",
+			"dialogLabel": "NPLLIq_dialogLabel",
+			"upgradeBanner": "NPLLIq_upgradeBanner",
+			"dialogActions": "NPLLIq_dialogActions",
+			"currentBadge": "NPLLIq_currentBadge",
+			"dialogBody": "NPLLIq_dialogBody",
+			"notice": "NPLLIq_notice",
+			"rowMeta": "NPLLIq_rowMeta",
 			"title": "NPLLIq_title",
+			"logPagerInfo": "NPLLIq_logPagerInfo",
+			"headerText": "NPLLIq_headerText",
+			"bar": "NPLLIq_bar",
 			"noticeError": "NPLLIq_noticeError",
-			"rowHeader": "NPLLIq_rowHeader",
-			"settingsBtn": "NPLLIq_settingsBtn",
-			"checkUpdatesRow": "NPLLIq_checkUpdatesRow",
-			"logHeader": "NPLLIq_logHeader",
-			"logTable": "NPLLIq_logTable",
+			"tab": "NPLLIq_tab",
+			"logScroll": "NPLLIq_logScroll",
 			"dialogTitle": "NPLLIq_dialogTitle",
-			"dialogSection": "NPLLIq_dialogSection",
-			"dialogActions": "NPLLIq_dialogActions",
+			"selectBtn": "NPLLIq_selectBtn",
+			"monitorList": "NPLLIq_monitorList",
+			"switch": "NPLLIq_switch",
+			"monitorRow": "NPLLIq_monitorRow",
+			"resetSelect": "NPLLIq_resetSelect",
+			"dialogBtn": "NPLLIq_dialogBtn",
+			"logHeader": "NPLLIq_logHeader",
+			"panelDim": "NPLLIq_panelDim",
+			"logToolbar": "NPLLIq_logToolbar",
+			"upgradeCommands": "NPLLIq_upgradeCommands",
+			"upgradeHint": "NPLLIq_upgradeHint",
+			"logDayCol": "NPLLIq_logDayCol",
+			"settingsBtn": "NPLLIq_settingsBtn",
 			"tabLabel": "NPLLIq_tabLabel",
-			"logModelCol": "NPLLIq_logModelCol",
-			"logPagerPages": "NPLLIq_logPagerPages",
-			"logSearch": "NPLLIq_logSearch",
-			"monitorName": "NPLLIq_monitorName",
-			"controls": "NPLLIq_controls",
 			"dialogClose": "NPLLIq_dialogClose",
+			"fillOver": "NPLLIq_fillOver",
+			"rowHeader": "NPLLIq_rowHeader",
+			"upgradeBannerFlash": "NPLLIq_upgradeBannerFlash",
+			"copyBtn": "NPLLIq_copyBtn",
+			"upgradeClose": "NPLLIq_upgradeClose",
+			"logModelCol": "NPLLIq_logModelCol",
+			"upgradeCommandRow": "NPLLIq_upgradeCommandRow",
+			"logPagerBtn": "NPLLIq_logPagerBtn",
+			"upgradeBannerText": "NPLLIq_upgradeBannerText",
+			"checkUpdatesLabel": "NPLLIq_checkUpdatesLabel",
+			"fillWarn": "NPLLIq_fillWarn",
+			"headerActions": "NPLLIq_headerActions",
+			"save": "NPLLIq_save",
+			"checkUpdatesRow": "NPLLIq_checkUpdatesRow",
+			"settingsBtnActive": "NPLLIq_settingsBtnActive",
+			"radioRow": "NPLLIq_radioRow",
+			"logClearBtn": "NPLLIq_logClearBtn",
 			"logPageSizeSelect": "NPLLIq_logPageSizeSelect",
 			"dialogHint": "NPLLIq_dialogHint",
-			"checkBtn": "NPLLIq_checkBtn",
-			"dialogBody": "NPLLIq_dialogBody",
-			"rowName": "NPLLIq_rowName",
-			"copyBtnDone": "NPLLIq_copyBtnDone",
-			"logClearDate": "NPLLIq_logClearDate",
-			"notice": "NPLLIq_notice",
-			"resetRow": "NPLLIq_resetRow",
-			"rowMeta": "NPLLIq_rowMeta",
 			"logClearDialog": "NPLLIq_logClearDialog",
-			"subtitle": "NPLLIq_subtitle",
-			"panel": "NPLLIq_panel",
-			"monitorHint": "NPLLIq_monitorHint",
+			"monitorName": "NPLLIq_monitorName",
+			"dialogBtnPrimary": "NPLLIq_dialogBtnPrimary",
 			"logPager": "NPLLIq_logPager",
-			"save": "NPLLIq_save",
-			"tab": "NPLLIq_tab",
-			"selectBtn": "NPLLIq_selectBtn",
-			"upgradeCommand": "NPLLIq_upgradeCommand",
-			"resetSelect": "NPLLIq_resetSelect",
-			"logScroll": "NPLLIq_logScroll",
-			"monitorRow": "NPLLIq_monitorRow",
-			"upgradeCommandRow": "NPLLIq_upgradeCommandRow",
-			"logPagerControls": "NPLLIq_logPagerControls",
-			"logDayCol": "NPLLIq_logDayCol",
-			"header": "NPLLIq_header",
+			"logClearDate": "NPLLIq_logClearDate",
+			"rowName": "NPLLIq_rowName",
 			"logDialog": "NPLLIq_logDialog",
-			"radioRow": "NPLLIq_radioRow",
 			"dialogOverlay": "NPLLIq_dialogOverlay",
-			"collapse": "NPLLIq_collapse",
-			"fillWarn": "NPLLIq_fillWarn",
-			"tabIcon": "NPLLIq_tabIcon",
-			"checkUpdatesLabel": "NPLLIq_checkUpdatesLabel",
-			"switch": "NPLLIq_switch",
+			"logUsedCol": "NPLLIq_logUsedCol",
+			"input": "NPLLIq_input",
 			"gearBtn": "NPLLIq_gearBtn",
-			"dialogLabel": "NPLLIq_dialogLabel",
-			"upgradeBannerText": "NPLLIq_upgradeBannerText",
+			"row": "NPLLIq_row",
+			"monitorHint": "NPLLIq_monitorHint",
+			"header": "NPLLIq_header",
+			"logPagerPages": "NPLLIq_logPagerPages",
 			"versionNew": "NPLLIq_versionNew",
-			"monitorList": "NPLLIq_monitorList",
-			"logClearBtn": "NPLLIq_logClearBtn",
-			"settingsBtnActive": "NPLLIq_settingsBtnActive",
-			"currentBadge": "NPLLIq_currentBadge",
+			"subtitle": "NPLLIq_subtitle",
+			"version": "NPLLIq_version",
 			"fullNotice": "NPLLIq_fullNotice",
-			"dialogBtn": "NPLLIq_dialogBtn",
-			"input": "NPLLIq_input",
-			"panelDimStrong": "NPLLIq_panelDimStrong",
-			"logToolbar": "NPLLIq_logToolbar",
-			"logPagerBtn": "NPLLIq_logPagerBtn",
-			"panelDim": "NPLLIq_panelDim",
-			"upgradeBanner": "NPLLIq_upgradeBanner",
-			"copyBtn": "NPLLIq_copyBtn",
-			"body": "NPLLIq_body",
-			"upgradeHint": "NPLLIq_upgradeHint",
-			"dialog": "NPLLIq_dialog",
+			"resetRow": "NPLLIq_resetRow",
+			"logTable": "NPLLIq_logTable",
 			"fillIdle": "NPLLIq_fillIdle",
-			"headerText": "NPLLIq_headerText",
-			"logPagerInfo": "NPLLIq_logPagerInfo",
-			"headerActions": "NPLLIq_headerActions",
 			"checkErrorHint": "NPLLIq_checkErrorHint",
-			"upgradeCommands": "NPLLIq_upgradeCommands",
-			"dialogBtnPrimary": "NPLLIq_dialogBtnPrimary",
-			"version": "NPLLIq_version",
-			"upgradeClose": "NPLLIq_upgradeClose",
+			"tabIcon": "NPLLIq_tabIcon",
+			"logPagerControls": "NPLLIq_logPagerControls",
+			"collapse": "NPLLIq_collapse",
+			"upgradeCommand": "NPLLIq_upgradeCommand",
+			"copyBtnDone": "NPLLIq_copyBtnDone",
+			"dialogSection": "NPLLIq_dialogSection",
+			"controls": "NPLLIq_controls",
+			"panel": "NPLLIq_panel",
+			"panelDimStrong": "NPLLIq_panelDimStrong",
+			"logSearch": "NPLLIq_logSearch",
 			"dialogHeader": "NPLLIq_dialogHeader",
-			"logUsedCol": "NPLLIq_logUsedCol",
-			"fillOver": "NPLLIq_fillOver"
+			"dialog": "NPLLIq_dialog"
 		};
 		//#endregion
 		//#region lib/types/client/TokenQuotaPanel.js
@@ -369,7 +373,7 @@ window.__ModuleLoader__.load({
 		* @param props - composed slot props.
 		* @returns the panel element tree.
 		*/
-		function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setMusicEnabled, setMusicVolume, setMusicStyle, useStore, actions, useSessions }) {
+		function TokenQuotaPanel({ t, load, setLimit, selectModel, setMonitored, setOnFull, setReset, setCheckUpdates, checkUpdatesNow, clearLogBefore, setDimWhenIdle, setMusicEnabled, setMusicVolume, setMusicStyle, setMusicOnlyCurrentSession, useStore, actions, useSessions }) {
 			const [collapsed, setCollapsed] = (0, react.useState)(false);
 			const [drafts, setDrafts] = (0, react.useState)({});
 			const [editingKey, setEditingKey] = (0, react.useState)(null);
@@ -403,6 +407,7 @@ window.__ModuleLoader__.load({
 			const musicEnabled = useStore((s) => s.musicEnabled);
 			const musicVolume = useStore((s) => s.musicVolume);
 			const musicStyle = useStore((s) => s.musicStyle);
+			const musicOnlyCurrentSession = useStore((s) => s.musicOnlyCurrentSession);
 			const upgrade = useStore((s) => s.upgrade);
 			const upgradeDismissed = useStore((s) => s.upgradeDismissed);
 			const checkingUpdates = useStore((s) => s.checkingUpdates);
@@ -587,13 +592,13 @@ window.__ModuleLoader__.load({
 									title: t("upgradeAvailableHint"),
 									children: [
 										"v",
-										"0.1.23",
+										"0.1.26",
 										" → v",
 										upgrade.latestVersion
 									]
 								}) : (0, react_jsx_runtime.jsxs)("span", {
 									className: TokenQuotaPanel_module_css_default.version,
-									children: ["v", "0.1.23"]
+									children: ["v", "0.1.26"]
 								})]
 							}), (0, react_jsx_runtime.jsx)("div", {
 								className: TokenQuotaPanel_module_css_default.subtitle,
@@ -956,41 +961,58 @@ window.__ModuleLoader__.load({
 										className: TokenQuotaPanel_module_css_default.dialogHint,
 										children: t("musicHint")
 									}),
-									musicEnabled && (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsxs)("label", {
-										className: TokenQuotaPanel_module_css_default.checkUpdatesLabel,
-										children: [(0, react_jsx_runtime.jsx)("span", { children: t("musicVolume") }), (0, react_jsx_runtime.jsx)("input", {
-											type: "range",
-											min: 0,
-											max: 1,
-											step: .05,
-											value: musicVolume,
-											onChange: (event) => {
-												setMusicVolume(Number(event.target.value));
-											}
-										})]
-									}), (0, react_jsx_runtime.jsxs)("label", {
-										className: TokenQuotaPanel_module_css_default.checkUpdatesLabel,
-										children: [(0, react_jsx_runtime.jsx)("span", { children: t("musicStyle") }), (0, react_jsx_runtime.jsxs)("select", {
-											value: musicStyle,
-											onChange: (event) => {
-												setMusicStyle(event.target.value);
-											},
-											children: [
-												(0, react_jsx_runtime.jsx)("option", {
-													value: "major",
-													children: t("musicStyleMajor")
-												}),
-												(0, react_jsx_runtime.jsx)("option", {
-													value: "minor",
-													children: t("musicStyleMinor")
-												}),
-												(0, react_jsx_runtime.jsx)("option", {
-													value: "pentatonic",
-													children: t("musicStylePentatonic")
-												})
-											]
-										})]
-									})] })
+									musicEnabled && (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+										(0, react_jsx_runtime.jsxs)("label", {
+											className: TokenQuotaPanel_module_css_default.checkUpdatesLabel,
+											children: [(0, react_jsx_runtime.jsx)("span", { children: t("musicVolume") }), (0, react_jsx_runtime.jsx)("input", {
+												type: "range",
+												min: 0,
+												max: 1,
+												step: .05,
+												value: musicVolume,
+												onChange: (event) => {
+													setMusicVolume(Number(event.target.value));
+												}
+											})]
+										}),
+										(0, react_jsx_runtime.jsxs)("label", {
+											className: TokenQuotaPanel_module_css_default.checkUpdatesLabel,
+											children: [(0, react_jsx_runtime.jsx)("span", { children: t("musicStyle") }), (0, react_jsx_runtime.jsxs)("select", {
+												value: musicStyle,
+												onChange: (event) => {
+													setMusicStyle(event.target.value);
+												},
+												children: [
+													(0, react_jsx_runtime.jsx)("option", {
+														value: "major",
+														children: t("musicStyleMajor")
+													}),
+													(0, react_jsx_runtime.jsx)("option", {
+														value: "minor",
+														children: t("musicStyleMinor")
+													}),
+													(0, react_jsx_runtime.jsx)("option", {
+														value: "pentatonic",
+														children: t("musicStylePentatonic")
+													})
+												]
+											})]
+										}),
+										(0, react_jsx_runtime.jsxs)("label", {
+											className: TokenQuotaPanel_module_css_default.checkUpdatesLabel,
+											children: [(0, react_jsx_runtime.jsx)("input", {
+												type: "checkbox",
+												checked: musicOnlyCurrentSession,
+												onChange: (event) => {
+													setMusicOnlyCurrentSession(event.target.checked);
+												}
+											}), (0, react_jsx_runtime.jsx)("span", { children: t("musicOnlyCurrentSessionLabel") })]
+										}),
+										(0, react_jsx_runtime.jsx)("div", {
+											className: TokenQuotaPanel_module_css_default.dialogHint,
+											children: t("musicOnlyCurrentSessionHint")
+										})
+									] })
 								]
 							}),
 							(0, react_jsx_runtime.jsxs)("div", {
@@ -1210,16 +1232,19 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/music.js
 		/**
-		* Live-composed soundtrack driven by host actions (turns, steps, tool calls,
-		* etc.). Outputs through Web Audio (built-in synthesis) by default, and also
-		* sends MIDI NoteOn/NoteOff to the first available MIDI output when one is
-		* detected (both play simultaneously when MIDI is present — use the panel
-		* volume for overall level, the MIDI output has its own gain on the receiver).
+		* Live-composed ambient soundtrack driven by host actions (turns, steps,
+		* tool calls, etc.). Three layers:
 		*
-		* The composition is intentionally simple: a fixed chord progression under a
-		* scale-constrained melody, with one short musical gesture per host action.
-		* It is meant as gentle ambience while waiting for LLM responses, not as a
-		* full piece — everything stays in key so you can never hit a wrong note.
+		*  - **Pad**: a sustained three-note chord (triangle waves) that fades in when
+		*    a request starts and crossfades to the next chord on every step.
+		*  - **Bass**: one long root note per beat (lower octave), keeps the pulse.
+		*  - **Melody**: an eighth-note scale line that dances inside the current
+		*    chord — always in key, never a wrong note.
+		*
+		* Outputs through Web Audio (built-in synthesis) by default, and also sends
+		* MIDI NoteOn/NoteOff to the first available MIDI output when one is detected
+		* (both play simultaneously when MIDI is present — use the panel volume for
+		* overall level, the MIDI output has its own gain on the receiver).
 		*
 		* @module @jxgame2020/dsh-token-quota/music
 		*/
@@ -1295,14 +1320,26 @@ window.__ModuleLoader__.load({
 				"major"
 			]
 		};
-		/**
-		* Turn a MIDI note number into a frequency (Hz) using equal temperament at
-		* A4 = 440 Hz.
-		*/
+		/** Turn a MIDI note number into a frequency (equal temperament, A4 = 440). */
 		function midiToFreq(midi) {
 			return 440 * Math.pow(2, (midi - 69) / 12);
 		}
-		/** Live-composed music engine driven by host actions. */
+		/** Interval in semitones from the root for each chord-tone. */
+		function chordIntervals(quality) {
+			return [
+				0,
+				quality === "major" ? 4 : quality === "minor" ? 3 : 3,
+				quality === "dim" ? 6 : 7
+			];
+		}
+		/**
+		* Live-composed music engine driven by host actions.
+		*
+		* The engine is idle until `ensureStarted()` is called from a user gesture
+		* (the panel switch), and only produces sound while `enabled` is true AND a
+		* request is in flight (pad + bass + melody are gated by `startPad` /
+		* `stopPad`).
+		*/
 		var TokenQuotaMusic = class TokenQuotaMusic {
 			audio = null;
 			midiOutput = null;
@@ -1310,14 +1347,23 @@ window.__ModuleLoader__.load({
 			enabled = false;
 			volume = .5;
 			style = "major";
-			/** Current position in the chord progression (advances per step). */
 			chordIndex = 0;
-			/** Step counter — used for melody degree selection. */
 			stepCount = 0;
-			/** Tool counter — used for tool-note pitch. */
 			toolCount = 0;
-			/** Base MIDI note of the current key. C4 = middle C. */
+			padOscs = [];
+			padGain = null;
+			padTarget = 0;
+			padActive = false;
+			beatTimer;
+			beatIndex = 0;
+			melodyDirection = 1;
+			melodyDegree = 0;
+			currentRoot = 60;
+			currentQuality = "major";
+			/** Base MIDI note of the key. C4 = middle C. */
 			static BASE_MIDI = 60;
+			/** Beat length in ms — eighth note = beat / 2. */
+			static BEAT_MS = 640;
 			/** True once the audio context has been started (needs a user gesture). */
 			get started() {
 				return this.audio !== null;
@@ -1353,12 +1399,16 @@ window.__ModuleLoader__.load({
 			}
 			setEnabled(value) {
 				this.enabled = value;
+				if (!value) this.stopAll();
 			}
 			setVolume(value) {
 				this.volume = Math.max(0, Math.min(1, value));
+				if (this.padGain !== null && this.audio !== null) this.padGain.gain.setValueAtTime(this.volume * this.padTarget, this.audio.currentTime);
 			}
 			setStyle(value) {
 				this.style = value;
+				this.melodyDegree = 0;
+				this.melodyDirection = 1;
 			}
 			/** Handle one incoming host action and turn it into sound. */
 			onAction(action) {
@@ -1366,82 +1416,177 @@ window.__ModuleLoader__.load({
 				const base = TokenQuotaMusic.BASE_MIDI;
 				switch (action.type) {
 					case "turn/start":
+						this.stopAll();
 						this.chordIndex = 0;
 						this.stepCount = 0;
 						this.toolCount = 0;
-						this.playChord(base, this.currentChordQuality(), 1.6, .55);
+						this.currentRoot = base;
+						this.currentQuality = CHORD_QUALITIES[this.style][0] ?? "major";
+						this.playChord(base, this.currentQuality, 1.6, .6);
 						break;
 					case "step/start": {
 						this.chordIndex = (this.chordIndex + 1) % CHORD_PROGRESSIONS[this.style].length;
 						this.stepCount += 1;
-						this.playNote(this.currentChordRoot(base) - 12, 1.2, .35);
-						const root = this.currentChordRoot(base);
-						const [d1, d2, d3] = this.arpeggioDegrees();
-						setTimeout(() => this.playNote(root + d1, .2, .4), 0);
-						setTimeout(() => this.playNote(root + d2, .2, .4), 80);
-						setTimeout(() => this.playNote(root + d3, .35, .4), 160);
+						const root = base + (CHORD_PROGRESSIONS[this.style][this.chordIndex] ?? 0);
+						const quality = CHORD_QUALITIES[this.style][this.chordIndex] ?? "major";
+						this.currentRoot = root;
+						this.currentQuality = quality;
+						if (this.padActive) this.crossfadePad(root, quality);
 						break;
 					}
 					case "request/header": {
+						this.startPad(this.currentRoot, this.currentQuality);
+						this.startBeatClock();
 						const degree = (this.stepCount * 2 + this.toolCount) % SCALES[this.style].length;
-						const note = base + 12 + SCALES[this.style][degree];
-						this.playNote(note, .18, .35);
+						const note = base + 12 + (SCALES[this.style][degree] ?? 0);
+						this.playNote(note, .25, .4);
 						break;
 					}
 					case "tool/call":
 						this.toolCount += 1;
 						this.playNote(base + 24 + this.toolCount % 3 * 2, .12, .45);
-						this.playNote(base - 12, .08, .25);
+						this.playNote(base - 12, .08, .3);
 						break;
 					case "tool/result":
 						if (action.error) {
 							this.playNote(base + 13, .18, .4);
 							setTimeout(() => this.playNote(base + 12, .25, .4), 90);
 						} else {
-							this.playNote(base + 9, .14, .3);
-							setTimeout(() => this.playNote(base + 11, .22, .3), 70);
+							this.playNote(base + 9, .14, .35);
+							setTimeout(() => this.playNote(base + 11, .22, .35), 70);
 						}
 						break;
+					case "assistant/attempt":
+						this.playNote(base + 8, .18, .4);
+						setTimeout(() => this.playNote(base + 7, .2, .4), 100);
+						setTimeout(() => this.playNote(base + 5, .3, .4), 200);
+						break;
 					case "assistant/message":
-						if (action.interrupted) this.playChord(base + 7, "dim", .9, .5);
-						else this.playChord(this.currentChordRoot(base), this.currentChordQuality(), 1.1, .55);
+						this.stopBeatClock();
+						this.stopPad();
+						if (action.interrupted) this.playChord(base + 7, "dim", .9, .55);
+						else this.playChord(this.currentRoot, this.currentQuality, 1.1, .6);
 						break;
 					case "turn/end":
-						this.playChord(base, this.style === "minor" ? "minor" : "major", 2.2, .65);
+						this.stopAll();
+						this.playChord(base, this.style === "minor" ? "minor" : "major", 2.4, .7);
 						this.chordIndex = 0;
 						break;
 				}
 			}
-			currentChordRoot(base) {
-				const prog = CHORD_PROGRESSIONS[this.style];
-				return base + prog[this.chordIndex % prog.length];
+			/** Start the pad from silence, fading in to the target level. */
+			startPad(rootMidi, quality) {
+				if (!this.audio) return;
+				if (this.padActive) return;
+				const now = this.audio.currentTime;
+				const gain = this.audio.createGain();
+				gain.gain.setValueAtTime(0, now);
+				gain.connect(this.audio.destination);
+				const intervals = chordIntervals(quality);
+				const oscs = [];
+				for (const interval of intervals) {
+					const osc = this.audio.createOscillator();
+					osc.type = "triangle";
+					osc.frequency.value = midiToFreq(rootMidi + interval);
+					osc.connect(gain);
+					osc.start(now);
+					oscs.push(osc);
+				}
+				this.padOscs = oscs;
+				this.padGain = gain;
+				this.padTarget = .18;
+				gain.gain.linearRampToValueAtTime(this.volume * this.padTarget, now + .6);
+				this.padActive = true;
+			}
+			/** Smoothly morph the pad to a new root + quality. */
+			crossfadePad(rootMidi, quality) {
+				if (!this.audio || !this.padActive || this.padGain === null) return;
+				const now = this.audio.currentTime;
+				const intervals = chordIntervals(quality);
+				this.padOscs.forEach((osc, i) => {
+					const interval = intervals[i] ?? 0;
+					osc.frequency.setValueAtTime(osc.frequency.value, now);
+					osc.frequency.exponentialRampToValueAtTime(midiToFreq(rootMidi + interval), now + .5);
+				});
+			}
+			/** Fade the pad to silence, then stop the oscillators. */
+			stopPad() {
+				if (!this.audio || !this.padActive || this.padGain === null) return;
+				const now = this.audio.currentTime;
+				const gain = this.padGain;
+				gain.gain.cancelScheduledValues(now);
+				gain.gain.setValueAtTime(gain.gain.value, now);
+				gain.gain.linearRampToValueAtTime(0, now + .8);
+				const oscs = this.padOscs;
+				setTimeout(() => {
+					for (const osc of oscs) {
+						try {
+							osc.stop();
+						} catch {}
+						try {
+							osc.disconnect();
+						} catch {}
+					}
+					try {
+						gain.disconnect();
+					} catch {}
+				}, 850);
+				this.padActive = false;
+				this.padOscs = [];
+				this.padGain = null;
 			}
-			currentChordQuality() {
-				const q = CHORD_QUALITIES[this.style];
-				return q[this.chordIndex % q.length] ?? "major";
+			/** Start the per-beat clock that drives bass and melody. */
+			startBeatClock() {
+				if (this.beatTimer !== void 0) return;
+				this.beatIndex = 0;
+				this.melodyDegree = 0;
+				this.melodyDirection = 1;
+				const tick = () => {
+					if (!this.audio || !this.enabled) return;
+					if (this.beatIndex % 2 === 0) this.playNote(this.currentRoot - 12, .45, .3);
+					const scale = SCALES[this.style];
+					const chordTones = new Set(chordIntervals(this.currentQuality));
+					let degree = this.melodyDegree;
+					let next = degree + this.melodyDirection;
+					if (next >= scale.length) {
+						this.melodyDirection = -1;
+						next = scale.length - 2;
+					} else if (next < 0) {
+						this.melodyDirection = 1;
+						next = 0;
+					}
+					this.melodyDegree = next;
+					degree = next;
+					if (this.beatIndex % 2 === 0) {
+						const rootRel = (scale[degree] ?? 0) % 12;
+						if (!chordTones.has(rootRel)) {
+							this.melodyDegree += this.melodyDirection;
+							degree = this.melodyDegree;
+						}
+					}
+					const note = this.currentRoot + 12 + (scale[degree] ?? 0);
+					this.playNote(note, .22, .28);
+					this.beatIndex = (this.beatIndex + 1) % 4;
+				};
+				tick();
+				this.beatTimer = setInterval(tick, TokenQuotaMusic.BEAT_MS);
+			}
+			stopBeatClock() {
+				if (this.beatTimer !== void 0) {
+					clearInterval(this.beatTimer);
+					this.beatTimer = void 0;
+				}
 			}
-			/** Intervals of an ascending arpeggio from the chord root. */
-			arpeggioDegrees() {
-				return this.style === "pentatonic" ? [
-					0,
-					7,
-					12
-				] : this.currentChordQuality() === "major" ? [
-					0,
-					4,
-					7
-				] : [
-					0,
-					3,
-					7
-				];
+			stopAll() {
+				this.stopBeatClock();
+				this.stopPad();
 			}
 			/** Play one note: Web Audio + MIDI simultaneously when available. */
 			playNote(midi, durationSec, velocity) {
 				if (!this.audio) return;
-				const now = this.audio.currentTime;
 				const peak = this.volume * velocity * .5;
 				if (peak <= 0) return;
+				const now = this.audio.currentTime;
 				const osc = this.audio.createOscillator();
 				osc.type = "sine";
 				osc.frequency.value = midiToFreq(midi);
@@ -1471,12 +1616,9 @@ window.__ModuleLoader__.load({
 			}
 			/** Play a three-note chord plus a bass octave below. */
 			playChord(rootMidi, quality, durationSec, velocity) {
-				const third = quality === "major" ? 4 : 3;
-				const fifth = quality === "dim" ? 6 : 7;
-				this.playNote(rootMidi, durationSec, velocity * .45);
-				this.playNote(rootMidi + third, durationSec, velocity * .35);
-				this.playNote(rootMidi + fifth, durationSec, velocity * .35);
-				this.playNote(rootMidi - 12, durationSec * 1.15, velocity * .45);
+				const intervals = chordIntervals(quality);
+				for (const interval of intervals) this.playNote(rootMidi + interval, durationSec, velocity * .45);
+				this.playNote(rootMidi - 12, durationSec * 1.1, velocity * .5);
 			}
 		};
 		//#endregion
@@ -1556,6 +1698,8 @@ window.__ModuleLoader__.load({
 			musicStyleMajor: "大调",
 			musicStyleMinor: "小调",
 			musicStylePentatonic: "五声",
+			musicOnlyCurrentSessionLabel: "只播当前会话",
+			musicOnlyCurrentSessionHint: "开启后仅当前窗口的会话有音乐，后台子任务静音；关闭则所有会话都参与作曲",
 			checkUpdatesNow: "立即检查",
 			checkingUpdates: "检查中…",
 			checkUpToDate: "已是最新",
@@ -1630,6 +1774,8 @@ window.__ModuleLoader__.load({
 			musicStyleMajor: "Major",
 			musicStyleMinor: "Minor",
 			musicStylePentatonic: "Pentatonic",
+			musicOnlyCurrentSessionLabel: "Current session only",
+			musicOnlyCurrentSessionHint: "When on, only the visible session drives the soundtrack (background tasks stay silent); when off, every session contributes.",
 			checkUpdatesNow: "Check now",
 			checkingUpdates: "Checking…",
 			checkUpToDate: "Up to date",
@@ -1674,6 +1820,7 @@ window.__ModuleLoader__.load({
 			let lastMonitored = null;
 			let lastOnFull = "stop";
 			let lastReset = null;
+			let lastOnlyCurrentSession = true;
 			const music = new TokenQuotaMusic();
 			const sse = new EventSource("/token-quota/events");
 			sse.addEventListener("action", (event) => {
@@ -1683,12 +1830,19 @@ window.__ModuleLoader__.load({
 				} catch {
 					return;
 				}
-				if (lastSessionId !== void 0 && action.sessionId !== String(lastSessionId)) return;
+				if (lastOnlyCurrentSession && lastSessionId !== void 0 && action.sessionId !== String(lastSessionId)) return;
 				music.onAction(action);
 			});
 			ctx.effect(() => () => {
 				sse.close();
 			}, "token-quota-ui: music SSE");
+			/** Build a writable music-settings clone with defaults applied. */
+			const musicDefaults = (raw) => ({
+				enabled: raw?.enabled ?? false,
+				volume: raw?.volume ?? .5,
+				style: raw?.style ?? "major",
+				onlyCurrentSession: raw?.onlyCurrentSession ?? true
+			});
 			const keyOf = (selection) => {
 				if (selection === null) return void 0;
 				return `${selection.provider}/${selection.model}`;
@@ -1798,18 +1952,15 @@ window.__ModuleLoader__.load({
 				bound?.setCheckUpdates(doc?.checkUpdates ?? true);
 				bound?.setDimWhenIdle(doc?.dimWhenIdle ?? false);
 				bound?.setReset(lastReset);
-				const musicSettings = {
-					enabled: false,
-					volume: .5,
-					style: "major",
-					...doc?.music ?? {}
-				};
+				const musicSettings = musicDefaults(doc?.music);
+				lastOnlyCurrentSession = musicSettings.onlyCurrentSession;
 				music.setEnabled(musicSettings.enabled);
 				music.setVolume(musicSettings.volume);
 				music.setStyle(musicSettings.style);
 				bound?.setMusicEnabled(musicSettings.enabled);
 				bound?.setMusicVolume(musicSettings.volume);
 				bound?.setMusicStyle(musicSettings.style);
+				bound?.setMusicOnlyCurrentSession(musicSettings.onlyCurrentSession);
 				fetch("/token-quota", { headers: { accept: "application/json" } }).then((response) => {
 					if (!response.ok) {
 						bound?.setError(`quota route: ${String(response.status)}`);
@@ -1880,36 +2031,30 @@ window.__ModuleLoader__.load({
 				scope.set("dimWhenIdle", enabled);
 			};
 			const setMusicEnabled = (enabled) => {
-				const current = {
-					enabled: false,
-					volume: .5,
-					style: "major",
-					...scope.getSnapshot().value?.music ?? {}
-				};
+				const doc = scope.getSnapshot().value;
+				const current = musicDefaults(doc?.music);
 				current.enabled = enabled;
 				scope.set("music", current);
 				if (enabled) music.ensureStarted();
 			};
 			const setMusicVolume = (volume) => {
-				const current = {
-					enabled: false,
-					volume: .5,
-					style: "major",
-					...scope.getSnapshot().value?.music ?? {}
-				};
+				const doc = scope.getSnapshot().value;
+				const current = musicDefaults(doc?.music);
 				current.volume = Math.max(0, Math.min(1, volume));
 				scope.set("music", current);
 			};
 			const setMusicStyle = (style) => {
-				const current = {
-					enabled: false,
-					volume: .5,
-					style: "major",
-					...scope.getSnapshot().value?.music ?? {}
-				};
+				const doc = scope.getSnapshot().value;
+				const current = musicDefaults(doc?.music);
 				current.style = style;
 				scope.set("music", current);
 			};
+			const setMusicOnlyCurrentSession = (only) => {
+				const doc = scope.getSnapshot().value;
+				const current = musicDefaults(doc?.music);
+				current.onlyCurrentSession = only;
+				scope.set("music", current);
+			};
 			/** Ask the Host to check the registry right now, then refresh the snapshot. */
 			const checkUpdatesNow = () => {
 				bound?.setCheckingUpdates(true);
@@ -1996,7 +2141,8 @@ window.__ModuleLoader__.load({
 					setDimWhenIdle,
 					setMusicEnabled,
 					setMusicVolume,
-					setMusicStyle
+					setMusicStyle,
+					setMusicOnlyCurrentSession
 				};
 			};
 			ctx.slots.inject("shell.overlay", () => ctx.slots.register({