@waifucave/discord-waifus 1.5.192 → 1.5.193

package/dist/orchestration/deterministicOrchestrator.d.ts

@@ -0,0 +1,18 @@
+import type { ContextMessage } from "./context.js";
+import type { OrchestratorDecision } from "./decisions.js";
+import type { WaifuAvailability } from "../shared/schemas/domain.js";
+export type DeterministicCastMember = {
+    waifuId: string;
+    /** Every handle she answers to: name, display name, server nickname. */
+    names: string[];
+    /** Discord author ids that attribute context messages to her (bot entry id + application id). */
+    authorIds: string[];
+    availability: WaifuAvailability;
+};
+export type DeterministicDecisionInput = {
+    /** Chronological, oldest first — same order the model orchestrator receives. */
+    messages: ContextMessage[];
+    cast: DeterministicCastMember[];
+    now: Date;
+};
+export declare function decideDeterministically(input: DeterministicDecisionInput): OrchestratorDecision;

package/dist/orchestration/deterministicOrchestrator.js

@@ -0,0 +1,175 @@
+// Deterministic (model-free) orchestrator decisions.
+//
+// Two jobs: a zero-credit orchestration mode, and the fallback when the model call fails or a
+// provider blocks the prompt (live incident 2026-07-06: Gemini PROHIBITED_CONTENT blocked an
+// active room repeatedly). It picks the next speaker from structural signals only — reply
+// targets, name addressing, references, rotation, availability — never content judgment.
+//
+// Pure module: no side effects, no imports from runtime. Interval helpers are copied verbatim
+// from runtime.ts (modules stay decoupled per W1 precedent). Schedules are server-local time,
+// same convention as currentlyDoingForWaifu.
+const ROTATION_WINDOW = 4; // recent waifu messages examined for dominance penalties
+const SCORE_REPLY_TARGET = 100;
+const SCORE_ADDRESSED = 90;
+const SCORE_REFERENCED = 30;
+const SCORE_WAIFU_REFERENCED = 15;
+const SCORE_PARTICIPANT = 20; // must stay below PENALTY_PER_RECENT_MESSAGE so rotation wins on generic messages
+const PENALTY_LAST_SPEAKER = -60;
+const PENALTY_PER_RECENT_MESSAGE = -25;
+const PARTICIPATION_WINDOW = 10; // messages scanned for thread participation
+export function decideDeterministically(input) {
+    const { messages, now } = input;
+    const latest = messages[messages.length - 1];
+    const newestHumanTs = [...messages].reverse().find((m) => m.authorKind === "user")?.timestamp;
+    const humanAgeSeconds = newestHumanTs !== undefined ? Math.max(0, (now.getTime() - Date.parse(newestHumanTs)) / 1000) : Infinity;
+    const candidates = input.cast.filter((member) => isAvailable(member.availability, now));
+    const quiet = (reason) => ({
+        action: "no_reply",
+        respondingWaifus: [],
+        retriggerAfterSeconds: retriggerForHumanAge(humanAgeSeconds),
+        reasoning: `deterministic: ${reason}`
+    });
+    if (candidates.length === 0)
+        return quiet("no enabled, awake, unbusy waifu is available");
+    if (!latest || latest.authorKind !== "user") {
+        return quiet("latest message is not from a human; cast-only pacing");
+    }
+    const authorOf = (message) => input.cast.find((member) => member.authorIds.includes(message.authorId) || matchesName(member, message.displayName, "exact"));
+    const recentWaifuMessages = messages.filter((m) => m.authorKind === "waifu").slice(-ROTATION_WINDOW);
+    const lastWaifuMessage = recentWaifuMessages[recentWaifuMessages.length - 1];
+    const participationSlice = messages.slice(-PARTICIPATION_WINDOW);
+    const scored = candidates.map((member) => {
+        let score = 0;
+        const reasons = [];
+        if (latest.replyTo?.authorName && matchesName(member, latest.replyTo.authorName, "exact")) {
+            score += SCORE_REPLY_TARGET;
+            reasons.push("reply target");
+        }
+        if (isAddressed(member, latest.content)) {
+            score += SCORE_ADDRESSED;
+            reasons.push("addressed by name");
+        }
+        else if (isReferenced(member, latest.content)) {
+            score += SCORE_REFERENCED;
+            reasons.push("referenced");
+        }
+        if (recentWaifuMessages.some((m) => authorOf(m)?.waifuId !== member.waifuId && isReferenced(member, m.content))) {
+            score += SCORE_WAIFU_REFERENCED;
+            reasons.push("talked about by the cast");
+        }
+        if (participationSlice.some((m) => m.authorKind === "waifu" && authorOf(m)?.waifuId === member.waifuId)) {
+            score += SCORE_PARTICIPANT;
+            reasons.push("in the live thread");
+        }
+        if (lastWaifuMessage && authorOf(lastWaifuMessage)?.waifuId === member.waifuId) {
+            score += PENALTY_LAST_SPEAKER;
+            reasons.push("spoke last");
+        }
+        const recentCount = recentWaifuMessages.filter((m) => authorOf(m)?.waifuId === member.waifuId).length;
+        score += recentCount * PENALTY_PER_RECENT_MESSAGE;
+        // rotation tiebreak: the longer since she spoke, the better
+        const lastSpokeIndex = findLastIndex(messages, (m) => m.authorKind === "waifu" && authorOf(m)?.waifuId === member.waifuId);
+        const staleness = lastSpokeIndex === -1 ? messages.length : messages.length - 1 - lastSpokeIndex;
+        return { member, score, staleness, reasons };
+    });
+    scored.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        if (b.staleness !== a.staleness)
+            return b.staleness - a.staleness;
+        // stable variety tiebreak: hash of (latest message id, waifu id)
+        return stableHash(latest.id + b.member.waifuId) - stableHash(latest.id + a.member.waifuId);
+    });
+    const winner = scored[0];
+    const delaySeconds = 2 + (stableHash(latest.id + winner.member.waifuId) % 4);
+    return {
+        action: "reply",
+        respondingWaifus: [{ waifuId: winner.member.waifuId, delaySeconds }],
+        reasoning: `deterministic: ${winner.member.waifuId} picked (${winner.reasons.join(", ") || "rotation"}; score ${winner.score})`
+    };
+}
+/** Is she awake and not busy right now? Server-local time, like the schedule prompt blocks. */
+function isAvailable(availability, now) {
+    const minutes = now.getHours() * 60 + now.getMinutes();
+    if (availability.sleep.enabled && dailyIntervalContains(minutes, availability.sleep))
+        return false;
+    for (const interval of availability.busy) {
+        if (dailyIntervalContains(minutes, interval))
+            return false;
+    }
+    return true;
+}
+/** Addressed = her name opens/closes the message, or appears alongside second-person "you". */
+function isAddressed(member, content) {
+    const text = content.trim();
+    const lower = text.toLowerCase();
+    for (const name of member.names) {
+        const n = name.trim();
+        if (!n)
+            continue;
+        const ln = n.toLowerCase();
+        if (lower.startsWith(ln))
+            return true;
+        if (lower.endsWith(ln) || lower.endsWith(`${ln}?`) || lower.endsWith(`${ln}!`))
+            return true;
+        if (containsName(lower, ln) && /\byou\b|\bu\b/.test(lower))
+            return true;
+    }
+    return false;
+}
+function isReferenced(member, content) {
+    const lower = content.toLowerCase();
+    return member.names.some((name) => name.trim() && containsName(lower, name.trim().toLowerCase()));
+}
+/** Word-boundary match for ASCII names, substring for CJK/emoji handles where \b is useless. */
+function containsName(haystackLower, nameLower) {
+    if (/^[\x20-\x7e]+$/.test(nameLower)) {
+        return new RegExp(`(^|[^a-z0-9])${escapeRegExp(nameLower)}($|[^a-z0-9])`).test(haystackLower);
+    }
+    return haystackLower.includes(nameLower);
+}
+function matchesName(member, value, _mode) {
+    if (!value)
+        return false;
+    const v = value.trim().toLowerCase();
+    return member.names.some((name) => name.trim().toLowerCase() === v);
+}
+function retriggerForHumanAge(ageSeconds) {
+    if (ageSeconds < 120)
+        return 45;
+    if (ageSeconds < 900)
+        return 240;
+    if (ageSeconds < 7200)
+        return 900;
+    return 3600;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function stableHash(value) {
+    let hash = 0;
+    for (let i = 0; i < value.length; i++)
+        hash = (hash * 31 + value.charCodeAt(i)) | 0;
+    return Math.abs(hash);
+}
+function findLastIndex(items, predicate) {
+    for (let i = items.length - 1; i >= 0; i--) {
+        if (predicate(items[i]))
+            return i;
+    }
+    return -1;
+}
+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);
+}
+//# sourceMappingURL=deterministicOrchestrator.js.map

package/dist/orchestration/deterministicOrchestrator.js.map

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

package/dist/orchestration/runtime.d.ts

@@ -156,6 +156,8 @@ export declare class RuntimeOrchestrator {
     private readActiveChatParticipants;
     private recordWaifuNotes;
     private buildWaifuPromptParts;
+    /** Cast members + guild-nickname map for the deterministic decider and casting cards. */
+    private buildDeterministicCast;
     private buildOrchestratorSystemPrompt;
     private buildOrchestratorTrailingPrompt;
     private ensureServer;

package/dist/orchestration/runtime.js

@@ -8,6 +8,7 @@ import { SOFT_VALIDATOR_CHECKS, correctiveRetryMessage, validateWaifuOutput } fr
 import { extractReplyQuote } from "./replyQuote.js";
 import { createGatewayModelPipeline } from "./pipeline/gatewayPipeline.js";
 import { isPermissionError, PermissionWarningTracker } from "./permissionWarnings.js";
+import { decideDeterministically } from "./deterministicOrchestrator.js";
 import { GatewayPipelineError } from "./pipeline/params.js";
 import { resolveModelTarget, sharedRegistry } from "./pipeline/resolveTarget.js";
 import { ActiveChatParticipantsFileSchema, AgentConfigSchema, DiscordBotsFileSchema, GuildEmojisFileSchema, GuildMembersFileSchema, MemoryStoreSchema, OrchestratorDebugConfigFileSchema, OrchestratorHistoryFileSchema, PendingObservationsFileSchema, ReviewerHistoryFileSchema, ServerConfigSchema, StageManagerHistoryFileSchema, WaifuConfigSchema, createEmptyRevisionedFile } from "../shared/schemas/domain.js";
@@ -850,10 +851,8 @@ export class RuntimeOrchestrator {
                 return;
             }
             const orchestrator = await this.readAgentConfig("orchestrator", 40);
-            if (!orchestrator.modelId) {
-                this.options.logger.warn("Orchestrator model is not configured; channel loop stopped", { guildId, channelId });
-                return;
-            }
+            // No model + enabled = free deterministic mode: structural speaker selection, no API spend.
+            const deterministicMode = !orchestrator.modelId;
             let messages = await this.options.discord.fetchFreshContext({
                 guildId,
                 channelId,
@@ -861,7 +860,9 @@ export class RuntimeOrchestrator {
                 signal
             });
             await this.noteActiveChatParticipantsFromContext(guildId, channelId, messages);
-            messages = await this.messagesForModel(messages, { providerId: orchestrator.providerId, modelId: orchestrator.modelId }, signal);
+            if (orchestrator.modelId) {
+                messages = await this.messagesForModel(messages, { providerId: orchestrator.providerId, modelId: orchestrator.modelId }, signal);
+            }
             this.options.logger.info("Fetched Discord context for orchestrator", {
                 guildId,
                 channelId,
@@ -884,11 +885,14 @@ export class RuntimeOrchestrator {
                     return;
                 }
             }
-            const pipeline = this.pipelineFor({ providerId: orchestrator.providerId, modelId: orchestrator.modelId }, "orchestrator");
-            if (!pipeline.decideOrchestrator) {
+            const pipeline = deterministicMode
+                ? undefined
+                : this.pipelineFor({ providerId: orchestrator.providerId, modelId: orchestrator.modelId }, "orchestrator");
+            if (pipeline && !pipeline.decideOrchestrator) {
                 throw new Error(`Model ${orchestrator.modelId} does not implement orchestrator decisions.`);
             }
             const availableWaifus = await this.listAvailableWaifusForChannel(channel);
+            const { cast: deterministicCast, nicknames: guildNicknames } = await this.buildDeterministicCast(guildId, availableWaifus);
             const pastDecisions = await this.readCompletedOrchestratorDecisionsForChannel(guildId, channelId);
             const requireReply = Boolean(options.firstOrchestratorMustReply && turns === 1);
             const loop = assessLoop(messages);
@@ -916,22 +920,49 @@ export class RuntimeOrchestrator {
                         wakePlan: lastNoReply.wakePlan
                     }];
             }
-            const trailingPrompt = this.buildOrchestratorTrailingPrompt(orchestrator, availableWaifus, requireReply, runtimeNotice);
+            const trailingPrompt = this.buildOrchestratorTrailingPrompt(orchestrator, availableWaifus, requireReply, runtimeNotice, guildNicknames);
             // No typing scope for orchestrator decisions: the orchestrator bot showing "typing…" while it
             // deliberates leaks the machinery's presence into the room. Only the waifu send path types.
-            let decision = await pipeline.decideOrchestrator({
-                modelId: orchestrator.modelId,
-                messages,
-                pastDecisions,
-                decisionMarkers,
-                directiveBudgetOpen,
-                trailingPrompt,
-                systemPrompt: this.buildOrchestratorSystemPrompt(orchestrator, server, requireReply),
-                availableWaifuIds: availableWaifus.map((waifu) => waifu.id),
-                replyRequired: requireReply,
-                params: orchestrator.params,
-                signal
-            });
+            let decision;
+            if (!pipeline || !pipeline.decideOrchestrator) {
+                decision = decideDeterministically({ messages, cast: deterministicCast, now: new Date() });
+                this.options.logger.info("Deterministic orchestrator decision (no model configured)", {
+                    guildId,
+                    channelId,
+                    action: decision.action,
+                    reasoning: decision.reasoning
+                });
+            }
+            else {
+                try {
+                    decision = await pipeline.decideOrchestrator({
+                        modelId: orchestrator.modelId,
+                        messages,
+                        pastDecisions,
+                        decisionMarkers,
+                        directiveBudgetOpen,
+                        trailingPrompt,
+                        systemPrompt: this.buildOrchestratorSystemPrompt(orchestrator, server, requireReply),
+                        availableWaifuIds: availableWaifus.map((waifu) => waifu.id),
+                        replyRequired: requireReply,
+                        params: orchestrator.params,
+                        signal
+                    });
+                }
+                catch (error) {
+                    // Manual /run promised the user a reply from the model — surface its failure instead.
+                    if (requireReply || signal.aborted)
+                        throw error;
+                    decision = decideDeterministically({ messages, cast: deterministicCast, now: new Date() });
+                    this.options.logger.warn("Model orchestrator failed; deterministic fallback decision used", {
+                        guildId,
+                        channelId,
+                        message: error instanceof Error ? error.message : String(error),
+                        action: decision.action,
+                        reasoning: decision.reasoning
+                    });
+                }
+            }
             decision = capDecisionDelays(decision);
             if (requireReply) {
                 decision = applyFirstResponderDirectiveOverride(decision, options.firstResponderSceneDirectionOverride);
@@ -2631,6 +2662,29 @@ export class RuntimeOrchestrator {
             selfGuildNickname: serverNickname !== waifu.displayName ? serverNickname : undefined
         };
     }
+    /** Cast members + guild-nickname map for the deterministic decider and casting cards. */
+    async buildDeterministicCast(guildId, waifus) {
+        const [bots, members] = await Promise.all([
+            this.readDiscordBotsFile(),
+            this.options.storage.readJson(path.join("user", "servers", guildId, "members.json"), GuildMembersFileSchema, GuildMembersFileSchema.parse(createEmptyRevisionedFile({ guildId, members: [] })))
+        ]);
+        const guildNameByUserId = new Map(members.members
+            .filter((member) => member.guildDisplayName)
+            .map((member) => [member.userId, member.guildDisplayName]));
+        const nicknames = new Map();
+        const cast = [];
+        for (const waifu of waifus) {
+            const authorIds = resolveBotAuthorIds(waifu.botId, bots);
+            const nickname = authorIds.map((id) => guildNameByUserId.get(id)).find(Boolean);
+            if (nickname && nickname !== waifu.displayName)
+                nicknames.set(waifu.id, nickname);
+            if (!waifu.modelId)
+                continue; // she cannot generate a reply anyway
+            const names = [...new Set([waifu.name, waifu.displayName, nickname].filter((v) => Boolean(v?.trim())))];
+            cast.push({ waifuId: waifu.id, names, authorIds, availability: waifu.availability });
+        }
+        return { cast, nicknames };
+    }
     buildOrchestratorSystemPrompt(orchestrator, server, replyRequired = false) {
         const identity = replyRequired
             ? "You are the director of a multi-character Discord bot. This manual /run requires you to choose at least one waifu to reply now."
@@ -2654,10 +2708,10 @@ export class RuntimeOrchestrator {
             `<discord_server_information>\n${server.name ?? server.guildId}\n</discord_server_information>`
         ].filter(Boolean).join("\n");
     }
-    buildOrchestratorTrailingPrompt(orchestrator, availableWaifus, replyRequired = false, loopNotice) {
+    buildOrchestratorTrailingPrompt(orchestrator, availableWaifus, replyRequired = false, loopNotice, nicknames) {
         const now = new Date();
         const activeWaifusContent = availableWaifus.length
-            ? availableWaifus.map((waifu) => castingCard(waifu, now, waifuSeesImages(waifu))).join("\n")
+            ? availableWaifus.map((waifu) => castingCard(waifu, now, waifuSeesImages(waifu), nicknames?.get(waifu.id))).join("\n")
             : "No waifus are currently enabled for this channel.";
         const pausePlanning = "When you choose no_reply, retriggerAfterSeconds is a planned pause before YOU re-check the room — any new human message wakes you regardless, so long pauses cost nothing. wakePlan is one sentence on what you intend at wake; the runtime shows it back to you when the timer fires. A pivot plan should name the new topic, and when the wake comes you execute it with a change_topic directive — a plan without a directive usually dissolves into the old topic. Picking the pause: remember an ACTIVE room should rarely get here at all — if humans are engaged, the right move was a reply, not a pause. When the room genuinely cooled: 10–60s only to give a mid-flow room a short breath, 100–180s right after a beat lands (a quick check whether it caught), 240–600s for a cooling thread, 900–1800s for a planned revival of a quiet room, 3600s+ when you are mostly waiting for humans to return. Do NOT default to a round 300 — pick an exact number that matches the room's energy (e.g. 110, 140, 190, 420), and vary it so your pacing never becomes a predictable cycle. The same is true of your wake rhythm: if your last few wakes each produced the same shape (wake, two replies, pause), break the pattern — one voice instead of two, a directive instead of a reply, or a genuinely longer sleep. Repeated quiet checks must back off to longer pauses.";
         const task = replyRequired
@@ -3701,12 +3755,13 @@ function waifuSeesImages(waifu) {
         return false;
     }
 }
-function castingCard(waifu, now, seesImages = false) {
+function castingCard(waifu, now, seesImages = false, serverNickname) {
     const tagName = promptTagName(waifu.name || waifu.id);
     const displayName = waifu.displayName || waifu.name;
+    const nicknamePart = serverNickname && serverNickname !== displayName ? ` · appears in this server as "${serverNickname}"` : "";
     const lines = [
         `<${tagName}>`,
-        `ID: ${waifu.id} · ${displayName}${seesImages ? " · sees images natively" : ""}`
+        `ID: ${waifu.id} · ${displayName}${nicknamePart}${seesImages ? " · sees images natively" : ""}`
     ];
     if (waifu.personaDigest) {
         lines.push(`Voice: ${waifu.personaDigest.voice}`);