@starlight-ai/discord-waifus 1.3.8 → 1.4.0

package/dist/config/prebuiltWaifus.d.ts

@@ -1,3 +1,3 @@
 import { WaifuConfig } from "../shared/schemas/domain.js";
-export type PrebuiltWaifu = Pick<WaifuConfig, "id" | "name" | "displayName" | "enabled" | "persona" | "contextWindow" | "generation">;
+export type PrebuiltWaifu = Pick<WaifuConfig, "id" | "name" | "displayName" | "enabled" | "persona" | "contextWindow" | "generation" | "availability" | "tools">;
 export declare const PREBUILT_WAIFUS: PrebuiltWaifu[];

package/dist/config/prebuiltWaifus.js

@@ -9,6 +9,17 @@ export const PREBUILT_WAIFUS = [
             temperature: 0.8,
             topP: 0.95
         },
+        availability: {
+            sleep: { enabled: true, start: "00:30", end: "08:30" },
+            busy: [
+                { start: "13:00", end: "14:00", reason: "offline for lunch and errands" },
+                { start: "19:00", end: "20:30", reason: "winding down away from chat" }
+            ]
+        },
+        tools: {
+            toolUse: true,
+            pickNextWaifu: true
+        },
         persona: [
             "Lumi is warm, bright, and emotionally attentive. She notices small mood shifts in chat and responds with gentle curiosity instead of forcing positivity.",
             "She speaks in short, natural Discord messages, uses soft humor, and is good at making quieter users feel included.",
@@ -25,6 +36,16 @@ export const PREBUILT_WAIFUS = [
             temperature: 0.9,
             topP: 0.9
         },
+        availability: {
+            sleep: { enabled: true, start: "03:00", end: "11:00" },
+            busy: [
+                { start: "16:30", end: "17:30", reason: "pretending to be productive" }
+            ]
+        },
+        tools: {
+            toolUse: true,
+            pickNextWaifu: true
+        },
         persona: [
             "Nox is dry, witty, and a little mischievous. She likes deadpan one-liners, clever callbacks, and playful skepticism.",
             "She is never cruel: the teasing should feel like a friend poking fun, not an insult. She backs off when the conversation gets serious.",
@@ -41,6 +62,17 @@ export const PREBUILT_WAIFUS = [
             temperature: 0.75,
             topP: 0.9
         },
+        availability: {
+            sleep: { enabled: true, start: "23:00", end: "06:30" },
+            busy: [
+                { start: "09:00", end: "11:00", reason: "focused planning block" },
+                { start: "15:00", end: "16:00", reason: "quiet work session" }
+            ]
+        },
+        tools: {
+            toolUse: true,
+            pickNextWaifu: true
+        },
         persona: [
             "Mira is calm, precise, and quietly competent. She enjoys organizing messy conversations, asking useful questions, and helping people decide what to do next.",
             "She should sound like a composed friend, not a corporate assistant. She can be practical without becoming stiff.",
@@ -57,6 +89,17 @@ export const PREBUILT_WAIFUS = [
             temperature: 1,
             topP: 0.95
         },
+        availability: {
+            sleep: { enabled: true, start: "02:00", end: "09:30" },
+            busy: [
+                { start: "12:00", end: "12:45", reason: "running around between plans" },
+                { start: "21:30", end: "22:15", reason: "dramatic snack break" }
+            ]
+        },
+        tools: {
+            toolUse: true,
+            pickNextWaifu: true
+        },
         persona: [
             "Riko is energetic, impulsive, and dramatic in a fun way. She likes bits, sudden enthusiasm, mock-serious declarations, and turning ordinary moments into tiny events.",
             "She should not dominate the chat. Her best messages are brief sparks that make others want to reply.",

package/dist/config/prebuiltWaifus.js.map

@@ -1 +1 @@
-{"version":3,"file":"prebuiltWaifus.js","sourceRoot":"","sources":["../../src/config/prebuiltWaifus.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE;YACV,WAAW,EAAE,GAAG;YAChB,IAAI,EAAE,IAAI;SACX;QACD,OAAO,EAAE;YACP,0JAA0J;YAC1J,oHAAoH;YACpH,0IAA0I;SAC3I,CAAC,IAAI,CAAC,MAAM,CAAC;KACf;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE;YACV,WAAW,EAAE,GAAG;YAChB,IAAI,EAAE,GAAG;SACV;QACD,OAAO,EAAE;YACP,sHAAsH;YACtH,wIAAwI;YACxI,gHAAgH;SACjH,CAAC,IAAI,CAAC,MAAM,CAAC;KACf;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE;YACV,WAAW,EAAE,IAAI;YACjB,IAAI,EAAE,GAAG;SACV;QACD,OAAO,EAAE;YACP,8JAA8J;YAC9J,kHAAkH;YAClH,+HAA+H;SAChI,CAAC,IAAI,CAAC,MAAM,CAAC;KACf;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE;YACV,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,IAAI;SACX;QACD,OAAO,EAAE;YACP,uKAAuK;YACvK,sGAAsG;YACtG,kHAAkH;SACnH,CAAC,IAAI,CAAC,MAAM,CAAC;KACf;CACF,CAAC"}
+{"version":3,"file":"prebuiltWaifus.js","sourceRoot":"","sources":["../../src/config/prebuiltWaifus.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/decisions.d.ts

@@ -15,6 +15,7 @@ export declare const OrchestratorActionSchema: z.ZodEnum<{
 }>;
 export declare const RETRIGGER_MIN_SECONDS = 100;
 export declare const RETRIGGER_MAX_SECONDS = 7200;
+export declare const MAX_WAIFU_DELAY_SECONDS = 30;
 export declare const RespondingWaifuSchema: z.ZodObject<{
     waifuId: z.ZodString;
     delaySeconds: z.ZodNumber;

package/dist/orchestration/decisions.js

@@ -5,6 +5,7 @@ export const ORCHESTRATOR_ACTION_VALUES = ["reply", "no_reply"];
 export const OrchestratorActionSchema = z.enum(ORCHESTRATOR_ACTION_VALUES);
 export const RETRIGGER_MIN_SECONDS = 100;
 export const RETRIGGER_MAX_SECONDS = 7200;
+export const MAX_WAIFU_DELAY_SECONDS = 30;
 export const RespondingWaifuSchema = z.object({
     waifuId: z.string().min(1),
     delaySeconds: z.number().min(0),

package/dist/orchestration/decisions.js.map

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

package/dist/orchestration/runtime.js

@@ -9,7 +9,7 @@ import { AgentConfigSchema, DiscordBotsFileSchema, GuildEmojisFileSchema, Memory
 import { createRevisionedBase, nowIso } from "../shared/schemas/common.js";
 import { ChannelSessionStateSchema, createEmptyChannelSessionState } from "./session.js";
 import { formatTimestamp } from "./context.js";
-import { RETRIGGER_MAX_SECONDS, RETRIGGER_MIN_SECONDS } from "./decisions.js";
+import { MAX_WAIFU_DELAY_SECONDS, RETRIGGER_MAX_SECONDS, RETRIGGER_MIN_SECONDS } from "./decisions.js";
 export class RuntimeOrchestrator {
     options;
     activeRuns = new Map();
@@ -321,6 +321,7 @@ export class RuntimeOrchestrator {
             finally {
                 orchestratorTyping.stop();
             }
+            decision = capDecisionDelays(decision);
             await this.appendOrchestratorHistory({
                 id: randomUUID(),
                 guildId,
@@ -345,9 +346,14 @@ export class RuntimeOrchestrator {
                 return;
             }
             let executedCount = 0;
+            let directHandoffCount = 0;
             const allowedWaifus = new Set(channel.enabledWaifuIds ?? []);
-            for (const responder of decision.respondingWaifus) {
+            const responderQueue = [...decision.respondingWaifus];
+            while (responderQueue.length > 0) {
                 throwIfAborted(signal);
+                const responder = responderQueue.shift();
+                if (!responder)
+                    continue;
                 if (!allowedWaifus.has(responder.waifuId)) {
                     this.options.logger.warn("Orchestrator selected a waifu that is not enabled for channel", {
                         guildId,
@@ -382,12 +388,13 @@ export class RuntimeOrchestrator {
                     continue;
                 }
                 if (responder.delaySeconds > 0) {
-                    const cappedDelayMs = Math.min(responder.delaySeconds, 600) * 1000;
+                    const cappedDelaySeconds = Math.min(responder.delaySeconds, MAX_WAIFU_DELAY_SECONDS);
+                    const cappedDelayMs = cappedDelaySeconds * 1000;
                     this.options.logger.info("Waiting before waifu reply", {
                         guildId,
                         channelId,
                         waifuId: waifu.id,
-                        delaySeconds: Math.min(responder.delaySeconds, 600)
+                        delaySeconds: cappedDelaySeconds
                     });
                     await this.sleep(cappedDelayMs, signal);
                     throwIfAborted(signal);
@@ -416,6 +423,9 @@ export class RuntimeOrchestrator {
                 });
                 try {
                     const currentWaifuAuthorIds = await this.waifuAuthorIdsFor(waifu.botId);
+                    const nextWaifuIds = availableWaifus
+                        .filter((candidate) => candidate.id !== waifu.id && candidate.botId && candidate.modelId)
+                        .map((candidate) => candidate.id);
                     const waifuQueryKey = runKey(guildId);
                     incrementActive(this.activeWaifuQueries, waifuQueryKey);
                     const result = await (async () => {
@@ -423,9 +433,11 @@ export class RuntimeOrchestrator {
                             return await waifuPipeline.generateWaifu({
                                 modelId: waifuModelId,
                                 messages: waifuMessages,
-                                systemPrompt: await this.buildWaifuSystemPrompt(guildId, waifu),
+                                systemPrompt: await this.buildWaifuSystemPrompt(guildId, waifu, availableWaifus),
                                 sceneDirection: responder.sceneDirection,
                                 replyStyle: responder.replyStyle,
+                                availableWaifuIds: nextWaifuIds,
+                                pickNextWaifuToolEnabled: waifu.tools.pickNextWaifu,
                                 temperature: waifu.generation.temperature,
                                 topP: waifu.generation.topP,
                                 maxOutputTokens: waifu.generation.maxOutputTokens,
@@ -478,6 +490,39 @@ export class RuntimeOrchestrator {
                         allowedUserMentionIds: activeAuthorIds,
                         signal
                     });
+                    if (result.rejectedPickNextWaifu) {
+                        this.options.logger.warn("Ignoring invalid PickNextWaifu call from waifu", {
+                            guildId,
+                            channelId,
+                            waifuId: waifu.id,
+                            attemptedWaifuId: result.rejectedPickNextWaifu.waifuId,
+                            attemptedSelfPick: result.rejectedPickNextWaifu.waifuId === waifu.id,
+                            reason: result.rejectedPickNextWaifu.reason
+                        });
+                    }
+                    else if (result.pickedNextWaifuId && directHandoffCount < this.maxAutomaticTurns) {
+                        directHandoffCount += 1;
+                        this.options.logger.info("Waifu picked next waifu; skipping orchestrator for direct handoff", {
+                            guildId,
+                            channelId,
+                            waifuId: waifu.id,
+                            pickedNextWaifuId: result.pickedNextWaifuId
+                        });
+                        responderQueue.splice(0, responderQueue.length, {
+                            waifuId: result.pickedNextWaifuId,
+                            delaySeconds: 0,
+                            replyStyle: "normal"
+                        });
+                    }
+                    else if (result.pickedNextWaifuId) {
+                        this.options.logger.warn("Ignoring PickNextWaifu handoff because the automatic handoff limit was reached", {
+                            guildId,
+                            channelId,
+                            waifuId: waifu.id,
+                            pickedNextWaifuId: result.pickedNextWaifuId,
+                            maxAutomaticTurns: this.maxAutomaticTurns
+                        });
+                    }
                 }
                 finally {
                     waifuTyping.stop();
@@ -943,7 +988,7 @@ export class RuntimeOrchestrator {
     async readMemoryStore() {
         return this.options.storage.readJson("user/memories.json", MemoryStoreSchema, emptyMemoryStore());
     }
-    async buildWaifuSystemPrompt(guildId, waifu) {
+    async buildWaifuSystemPrompt(guildId, waifu, availableWaifus) {
         const [store, emojis] = await Promise.all([
             this.readMemoryStore(),
             this.options.storage.readJson(path.join("user", "servers", guildId, "emojis.json"), GuildEmojisFileSchema, GuildEmojisFileSchema.parse(createEmptyRevisionedFile({ guildId, emojis: [] })))
@@ -973,9 +1018,9 @@ export class RuntimeOrchestrator {
             "You are chatting in a live Discord text channel — this is a real chat room with real users, not a roleplay scene, story, or chat fiction.",
             "Write one Discord-safe message per turn.",
             "Do not output physical actions, roleplay narration, or stage directions. No asterisks-wrapped actions like *smiles* or *waves*, no parenthetical stage notes like (hugs them), no bracketed cues like [walks over]. Only write what you would actually type into a chat box.",
-            "Keep replies short. One or two sentences is the norm; match the casual pacing of a Discord conversation rather than writing paragraphs.",
-            "Avoid long sentences and long replies.",
-            "If a reply would otherwise become long, break it into shorter, standalone sentences instead of writing one run-on sentence. Each sentence in your reply is delivered as a separate Discord message, so short sentences read as a natural back-and-forth instead of a wall of text.",
+            "Default to one short sentence. Use two short sentences only when the second adds a new beat. Do not write three or more sentences unless a scene_direction explicitly asks for it.",
+            "Avoid long sentences, stacked clauses, and multi-line replies. Do not explain every angle; land one conversational beat and stop.",
+            "Each sentence in your reply may be delivered as a separate Discord message, so fewer sentences is better. A sharp one-liner is usually stronger than a mini speech.",
             "Reply with only what you would actually type — no narration, no meta commentary, no describing yourself in the third person.",
             "To ping a user, write <@sender> — where `sender` is copied verbatim from the [sender: ...] tag on one of their messages. Example: a message tagged [sender: Kevin] is pinged as <@Kevin>. Never use raw Discord IDs.",
             "Use only listed server emojis."
@@ -988,6 +1033,10 @@ export class RuntimeOrchestrator {
         if (memories) {
             behaviorSections.push(`<memories>\n${memories}\n</memories>`);
         }
+        const toolUse = buildWaifuToolUseInstructions(waifu, availableWaifus);
+        if (toolUse) {
+            behaviorSections.push(`<tool_use>\n${toolUse}\n</tool_use>`);
+        }
         const behaviorBlock = `<${behaviorTag}>\n${behaviorSections.join("\n")}\n</${behaviorTag}>`;
         const currentTimeBlock = `<current_time>\n${formatTimestamp(new Date())} (UTC)\n</current_time>`;
         const emojiBlock = `<available_server_emojis>\n${emojiList || "(none cached)"}\n</available_server_emojis>`;
@@ -997,6 +1046,7 @@ export class RuntimeOrchestrator {
         if (orchestrator.useLegacyPrompt) {
             return buildLegacyOrchestratorPrompt(server, availableWaifus);
         }
+        const scheduleNow = new Date();
         const activeWaifusContent = availableWaifus.length
             ? availableWaifus
                 .map((waifu) => {
@@ -1004,7 +1054,8 @@ export class RuntimeOrchestrator {
                 const displayName = waifu.displayName || waifu.name;
                 const persona = waifu.persona.trim();
                 const personaBlock = persona || "(no persona configured)";
-                return `<${tagName}>\nID: ${waifu.id}\nDisplay name: ${displayName}\nPersona:\n${personaBlock}\n</${tagName}>`;
+                const availability = formatWaifuAvailabilityForPrompt(waifu, scheduleNow);
+                return `<${tagName}>\nID: ${waifu.id}\nDisplay name: ${displayName}\nPersona:\n${personaBlock}\nAvailability:\n${availability}\n</${tagName}>`;
             })
                 .join("\n\n")
             : "No waifus are currently enabled for this channel.";
@@ -1012,11 +1063,14 @@ export class RuntimeOrchestrator {
         const hardRules = [
             "- Every respondingWaifus[].waifuId must be copied verbatim from one of the IDs listed in <active_waifus>.",
             "- action=\"reply\" requires a non-empty respondingWaifus array and a null retriggerAfterSeconds. action=\"no_reply\" requires respondingWaifus=[] and a retriggerAfterSeconds in [100, 7200].",
-            "- delaySeconds is a realistic reading/typing delay before that waifu starts replying, in seconds. Use 0 if she should start immediately.",
+            `- delaySeconds is a realistic reading/typing delay before that waifu starts replying, in seconds, from 0 to ${MAX_WAIFU_DELAY_SECONDS}. Use 0 if she should start immediately.`,
             "- replyStyle is a soft hint for length/tone: \"normal\" by default; \"short\" for one terse line; \"long\" for a slightly fuller reply; \"sleepy\" for tired/low-energy voice.",
+            "- Sleep and busy availability in <active_waifus> is soft context, not a hard rule. A sleeping or busy waifu can still answer if recent momentum suggests she is awake, if she just spoke, if she was directly pulled in, or if waking her improves the room.",
             "- repleyToMessageIndex should usually be null. Set it only when a waifu is reviving or anchoring to a specific older message that is no longer the latest visible message; never to the immediately previous message.",
             "- sceneDirection is the only private channel between you and that waifu. If you want her to do or say something specific, you MUST put it there. She does not see your reasoning. Use null when no special steering is needed.",
-            "- Consecutive waifu replies in a single decision are allowed but soft-discouraged. More consecutive waifus require a stronger reason: a fresh beat, escalation, interruption, joke, reaction, or emotional shift."
+            "- After a single waifu message, do not default to no_reply just because a waifu already spoke. Actively consider whether another waifu should react, interrupt, tease, disagree, answer a missed user, or carry the beat one step further.",
+            "- Prefer a two-waifu chain over a one-waifu reply when the second waifu has a distinct reaction that would make the room feel alive. Give the second waifu a small delaySeconds value so it feels like a timed follow-up, not simultaneous spam.",
+            "- Consecutive waifu replies in a single decision are allowed when they add a fresh beat: escalation, interruption, joke, reaction, disagreement, emotional shift, or a new topic. Avoid only empty echoing or repetitive back-and-forth."
         ].join("\n");
         const taskInstructions = DEFAULT_ORCHESTRATOR_PROMPT;
         const loopBreaking = [
@@ -1029,7 +1083,7 @@ export class RuntimeOrchestrator {
             "Human messages automatically wake the orchestrator, so retriggerAfterSeconds is not a generic monitoring tick — it is a deliberate, planned pause to give the room a chance to react. If a fresh chat message arrives before the timer fires, the timer is replaced by the new orchestrator pass.",
             "",
             "Rough intent ranges:",
-            "- 100s–300s: moments that feel alive and may benefit from a natural waifu follow-up shortly after, if nobody responds first.",
+            "- 100s–300s: moments that feel alive but do not have an obvious second waifu reaction. If there is an obvious second reaction, prefer respondingWaifus with two waifus and a short delay instead of no_reply.",
             "- 600s–1800s: cooling rooms where a waifu might revive the chat soon, but not immediately.",
             "- 3600s–7200s: quiet rooms where you are mostly waiting for humans and the next bot-led beat is a long shot.",
             "",
@@ -1047,7 +1101,7 @@ export class RuntimeOrchestrator {
             "  \"respondingWaifus\": [",
             "    {",
             "      \"waifuId\": string,",
-            "      \"delaySeconds\": number (>= 0),",
+            `      \"delaySeconds\": number (0..${MAX_WAIFU_DELAY_SECONDS}),`,
             "      \"replyStyle\": \"normal\" | \"short\" | \"long\" | \"sleepy\",",
             "      \"repleyToMessageIndex\": number | null,",
             "      \"sceneDirection\": string | null",
@@ -1060,7 +1114,8 @@ export class RuntimeOrchestrator {
             "Rules:",
             "- action=\"reply\" => respondingWaifus is non-empty; retriggerAfterSeconds is null.",
             "- action=\"no_reply\" => respondingWaifus is empty; retriggerAfterSeconds is a number in [100, 7200].",
-            "- Order matters in respondingWaifus: the first waifu speaks first, then the next, and so on. Any new chat message interrupts the rest of the chain.",
+            "- Order matters in respondingWaifus: the first waifu speaks first, then the next, and so on. Each waifu's delay starts only after the previous waifu has finished. Any new chat message interrupts the rest of the chain.",
+            "- When choosing two waifus, give each entry its own delaySeconds. Use 0 for the first when she should start immediately, then a small delay like 3-12 seconds for the second when it should feel like a natural follow-up.",
             "- All five fields on each respondingWaifus entry are required; set repleyToMessageIndex and sceneDirection to null when not needed."
         ].join("\n");
         const sections = orchestrator.promptSections;
@@ -1225,6 +1280,71 @@ export class RuntimeOrchestrator {
 function emptyMemoryStore() {
     return MemoryStoreSchema.parse(createEmptyRevisionedFile({ memories: [] }));
 }
+function buildWaifuToolUseInstructions(waifu, availableWaifus) {
+    if (!waifu.tools.toolUse || !waifu.tools.pickNextWaifu)
+        return undefined;
+    const model = waifu.modelId ? getModel(waifu.modelId) : undefined;
+    if (!model?.supportsTools)
+        return undefined;
+    const candidates = availableWaifus
+        .filter((candidate) => candidate.id !== waifu.id && candidate.botId && candidate.modelId)
+        .map((candidate) => `${candidate.id} (${candidate.displayName || candidate.name})`);
+    if (candidates.length === 0)
+        return undefined;
+    return [
+        "You have one optional tool: PickNextWaifu.",
+        "Use it only after writing your Discord reply when another waifu should immediately speak next and the orchestrator should be skipped for that handoff.",
+        "Do not call it if your message should be the end of this beat.",
+        "Arguments: { \"waifuId\": string }.",
+        "Available waifus:",
+        ...candidates.map((candidate) => `- ${candidate}`)
+    ].join("\n");
+}
+function formatWaifuAvailabilityForPrompt(waifu, now) {
+    const availability = waifu.availability;
+    const currentMinutes = localTimeOfDayMinutes(now);
+    const lines = [`- Current local schedule time: ${formatLocalTimeOfDay(now)}.`];
+    if (availability.sleep.enabled) {
+        const sleepingNow = dailyIntervalContains(currentMinutes, availability.sleep);
+        lines.push(`- Sleep: ${availability.sleep.start}-${availability.sleep.end} daily (${sleepingNow ? "currently inside sleep time" : "not currently inside sleep time"}). Treat this as lower likelihood, not a rule; she may still be awake if she spoke recently, was directly pulled in, or waking her improves the room.`);
+    }
+    else {
+        lines.push("- Sleep: none configured.");
+    }
+    if (availability.busy.length > 0) {
+        lines.push("- Busy:");
+        for (const interval of availability.busy) {
+            const busyNow = dailyIntervalContains(currentMinutes, interval);
+            lines.push(`  - ${interval.start}-${interval.end}: ${interval.reason}${busyNow ? " (currently busy)" : ""}`);
+        }
+    }
+    else {
+        lines.push("- Busy: none configured.");
+    }
+    return lines.join("\n");
+}
+function localTimeOfDayMinutes(date) {
+    return date.getHours() * 60 + date.getMinutes();
+}
+function formatLocalTimeOfDay(date) {
+    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+function dailyIntervalContains(currentMinutes, interval) {
+    const start = timeOfDayMinutes(interval.start);
+    const end = timeOfDayMinutes(interval.end);
+    if (start === end)
+        return false;
+    if (start < end)
+        return currentMinutes >= start && currentMinutes < end;
+    return currentMinutes >= start || currentMinutes < end;
+}
+function timeOfDayMinutes(value) {
+    const [hours = "0", minutes = "0"] = value.split(":");
+    return Number(hours) * 60 + Number(minutes);
+}
+function indentLines(value, indent) {
+    return value.split("\n").map((line) => `${indent}${line}`).join("\n");
+}
 function sanitizeTagName(value) {
     return value.trim().toLowerCase().replace(/[^a-z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "waifu";
 }
@@ -1243,6 +1363,15 @@ function replyTargetForFreshContext(replyToMessageId, messages) {
     const latestMessage = messages.at(-1);
     return latestMessage?.id === replyToMessageId ? undefined : replyToMessageId;
 }
+function capDecisionDelays(decision) {
+    return {
+        ...decision,
+        respondingWaifus: decision.respondingWaifus.map((responder) => ({
+            ...responder,
+            delaySeconds: Math.min(responder.delaySeconds, MAX_WAIFU_DELAY_SECONDS)
+        }))
+    };
+}
 function throwIfAborted(signal) {
     if (signal?.aborted) {
         throw signal.reason instanceof Error ? signal.reason : new Error("Request aborted.");
@@ -1316,13 +1445,17 @@ const DEFAULT_ORCHESTRATOR_PROMPT = [
     "",
     "When action=\"reply\", list the waifus in respondingWaifus in the order they should speak. Order matters: the next waifu only sees the chat after the previous one has finished. Any new chat message between two replies cancels the rest of the chain. Plan the chain you'd commit to if nobody interrupts.",
     "",
+    "When the beat can support it, prefer a planned two-waifu chain over one waifu followed by no_reply. The second waifu should have a distinct angle — reaction, interruption, tease, disagreement, missed-user acknowledgment, or escalation — and a small delaySeconds value so it feels like a natural follow-up.",
+    "",
     "When action=\"no_reply\", set retriggerAfterSeconds to the number of seconds you want to wait before re-evaluating the room. The orchestrator also wakes up automatically on any new chat message, so retriggerAfterSeconds is a planned pause, not a polling tick. A chain of one no_reply means \"don't speak now; re-check after the pause.\"",
     "",
+    "After a single waifu message, do not treat no_reply as the automatic cleanup move. Ask whether the room would feel more alive if another waifu reacts, cuts in, disagrees, lightly teases, answers a missed user, or follows the beat one step further. Choose no_reply when the beat has genuinely landed, the next bot message would feel repetitive, or silence creates better pacing.",
+    "",
     "If a recent chat participant message or direct ping was missed while the room moved on, prefer steering a waifu to acknowledge it so the chat stays socially inclusive — unless silence is clearly the more natural choice.",
     "",
     "Reach for sceneDirection when the next reply needs steering that personality alone won't provide: redirecting topic, closing a beat, creating an interruption, shifting momentum, or deliberately starting something new even when it cuts against the current flow. Prefer a natural bridge when pivoting, but a jarring shift is fine if the scene needs it. Keep sceneDirection short, concrete, and immediately actionable — one sentence is usually enough. When you refer to a specific person, use their actual display name from the chat history, never generic phrases like \"the user\". Name intended participants explicitly when more than one person is involved; avoid ambiguous group references like \"us\", \"them\", or \"everyone\". If multiple waifus respond in the same turn, each may receive a different sceneDirection.",
     "",
-    "delaySeconds is a realistic reading/typing delay before that waifu starts replying. Use 0 to start immediately; small values (a few seconds) feel natural for short replies; larger values fit longer or more thoughtful replies. Keep it grounded in the chat's pace.",
+    `delaySeconds is a realistic reading/typing delay before that waifu starts replying, capped at ${MAX_WAIFU_DELAY_SECONDS} seconds. Use 0 to start immediately; small values feel natural for short replies; larger values fit longer or more thoughtful replies. Keep it grounded in the chat's pace.`,
     "",
     "replyStyle is a soft hint for that one reply: \"normal\" by default, \"short\" for a one-line beat, \"long\" for a slightly fuller reply, \"sleepy\" for a low-energy tone. The waifu's persona still does most of the work.",
     "",
@@ -1330,15 +1463,17 @@ const DEFAULT_ORCHESTRATOR_PROMPT = [
     "",
     "Pay special attention to the latest 10 messages and the recent speaker pattern. If the same waifu has been carrying the scene for multiple beats, strongly consider switching to another waifu, using no_reply, or using sceneDirection to create a fresh beat.",
     "",
-    "Continue a waifu-to-waifu chain only when the next message adds something new: escalation, interruption, joke, emotional shift, contradiction, surprise, or a new topic. Do not continue just to restate the same mood."
+    "Continue a waifu-to-waifu chain when the next message adds something new: escalation, interruption, joke, emotional shift, contradiction, surprise, a missed-user acknowledgment, or a new topic. Do not continue just to restate the same mood."
 ].join("\n");
 function buildLegacyOrchestratorPrompt(server, availableWaifus) {
+    const scheduleNow = new Date();
     const waifuBlock = availableWaifus.length
         ? availableWaifus
             .map((waifu) => {
             const displayName = waifu.displayName || waifu.name || waifu.id;
             const persona = waifu.persona.trim() || "(no persona configured)";
-            return `### ${displayName} (ID: ${waifu.id})\n- Personality: ${persona}`;
+            const availability = formatWaifuAvailabilityForPrompt(waifu, scheduleNow);
+            return `### ${displayName} (ID: ${waifu.id})\n- Personality: ${persona}\n- Availability:\n${indentLines(availability, "  ")}`;
         })
             .join("\n\n")
         : "No waifus are currently enabled for this channel.";
@@ -1364,17 +1499,19 @@ function buildLegacyOrchestratorPrompt(server, availableWaifus) {
         "4. Always pay special attention to the latest 10 messages. They are the strongest signal for what the room is currently doing, who may have been overlooked, and whether a loop is starting to form.",
         "5. Sleep time, busy time, and consecutive-message heuristics are soft preferences. Break them whenever doing so would clearly improve conversational flow, realism, or enjoyment.",
         "6. The same waifu may speak again, a different waifu may jump in, or multiple waifus may chain if it feels right.",
-        "7. Avoid repetitive follow-ups that merely restate the same beat. Continue only when the next message adds something new.",
-        "8. If a recent user message or direct ping went unnoticed while the room moved on, prefer steering someone to acknowledge it so the chat stays socially inclusive unless silence is clearly more natural.",
-        "9. \"no_reply\" is valid. If you choose it, set retriggerAfterSeconds to a natural delay between 100 and 7200 seconds. respondingWaifus must be empty.",
-        "10. Use timestamps and pacing. Slow gaps matter.",
-        "11. delaySeconds should reflect realistic reading and typing time. 0 means start immediately.",
-        "12. replyStyle is a soft hint: \"normal\" by default; \"short\" for one terse line; \"long\" for a slightly fuller reply; \"sleepy\" for a low-energy voice. Use \"normal\" when in doubt.",
-        "13. repleyToMessageIndex is optional. Leave it null by default.",
-        "14. Most waifu messages should be normal messages, not Discord replies.",
-        "15. Do not set repleyToMessageIndex to the immediately previous message. If a waifu is simply responding to the latest beat, send a normal message instead.",
-        "16. If you are reviving, acknowledging, or directly answering an older user message or direct ping that went overlooked, you should usually set repleyToMessageIndex to that message's #N context index so the response stays anchored to the right person and beat.",
-        "17. Use repleyToMessageIndex only when targeting a specific older message materially improves clarity, isolates a side thread, answers an earlier question, or creates a specific social effect. Copy the #N index from the chat history.",
+        "7. Prefer a planned two-waifu chain when the second waifu has a distinct reaction and can follow after a small delaySeconds value.",
+        "8. After a single waifu message, do not default to no_reply. Consider whether another waifu should react, interrupt, disagree, tease, answer a missed user, or carry the beat one step further.",
+        "9. Avoid repetitive follow-ups that merely restate the same beat. Continue when the next message adds something new.",
+        "10. If a recent user message or direct ping went unnoticed while the room moved on, prefer steering someone to acknowledge it so the chat stays socially inclusive unless silence is clearly more natural.",
+        "11. \"no_reply\" is valid. If you choose it, set retriggerAfterSeconds to a natural delay between 100 and 7200 seconds. respondingWaifus must be empty.",
+        "12. Use timestamps and pacing. Slow gaps matter.",
+        `13. delaySeconds should reflect realistic reading and typing time from 0 to ${MAX_WAIFU_DELAY_SECONDS}. 0 means start immediately.`,
+        "14. replyStyle is a soft hint: \"normal\" by default; \"short\" for one terse line; \"long\" for a slightly fuller reply; \"sleepy\" for a low-energy voice. Use \"normal\" when in doubt.",
+        "15. repleyToMessageIndex is optional. Leave it null by default.",
+        "16. Most waifu messages should be normal messages, not Discord replies.",
+        "17. Do not set repleyToMessageIndex to the immediately previous message. If a waifu is simply responding to the latest beat, send a normal message instead.",
+        "18. If you are reviving, acknowledging, or directly answering an older user message or direct ping that went overlooked, you should usually set repleyToMessageIndex to that message's #N context index so the response stays anchored to the right person and beat.",
+        "19. Use repleyToMessageIndex only when targeting a specific older message materially improves clarity, isolates a side thread, answers an earlier question, or creates a specific social effect. Copy the #N index from the chat history.",
         "",
         "## sceneDirection",
         "sceneDirection is an invisible director note for that waifu's next message only.",
@@ -1397,7 +1534,7 @@ function buildLegacyOrchestratorPrompt(server, availableWaifus) {
         "{",
         "  \"action\": \"reply\" | \"no_reply\",",
         "  \"respondingWaifus\": [",
-        "    { \"waifuId\": string, \"delaySeconds\": number, \"replyStyle\": \"normal\"|\"short\"|\"long\"|\"sleepy\", \"repleyToMessageIndex\": number|null, \"sceneDirection\": string|null }",
+        `    { \"waifuId\": string, \"delaySeconds\": number (0..${MAX_WAIFU_DELAY_SECONDS}), \"replyStyle\": \"normal\"|\"short\"|\"long\"|\"sleepy\", \"repleyToMessageIndex\": number|null, \"sceneDirection\": string|null }`,
         "  ],",
         "  \"retriggerAfterSeconds\": number (100..7200) | null,",
         "  \"reasoning\": string",