@waifucave/discord-waifus 1.5.176 → 1.5.178

package/dist/api/assistant/conversations.d.ts

@@ -0,0 +1,51 @@
+import type { ChatMessage } from "@waifucave/gateway";
+export type AssistantEvent = {
+    type: "turn_started";
+} | {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_call";
+    name: string;
+    arguments: string;
+} | {
+    type: "tool_result";
+    name: string;
+    result: string;
+} | {
+    type: "turn_completed";
+} | {
+    type: "error";
+    message: string;
+};
+export type StoredMessage = {
+    role: "user" | "assistant";
+    content: string;
+    at: string;
+} | {
+    role: "event";
+    event: AssistantEvent;
+    at: string;
+};
+/**
+ * In-memory conversation state for the dashboard assistant. `messages` is the display
+ * transcript (user/assistant text plus tool events); `chat` is the model-facing gateway
+ * transcript. Both live only for the process lifetime — v1 has no persistence by design.
+ */
+export declare class ConversationStore {
+    private readonly conversations;
+    create(): {
+        id: string;
+    };
+    get(id: string): {
+        id: string;
+        messages: StoredMessage[];
+        chat: ChatMessage[];
+        busy: boolean;
+    } | undefined;
+    appendChat(id: string, messages: ChatMessage[]): void;
+    appendStored(id: string, message: StoredMessage): void;
+    setBusy(id: string, busy: boolean): void;
+    subscribe(id: string, listener: (event: AssistantEvent) => void): () => void;
+    emit(id: string, event: AssistantEvent): void;
+}

package/dist/api/assistant/conversations.js

@@ -0,0 +1,63 @@
+import { randomUUID } from "node:crypto";
+const MAX_CONVERSATIONS = 20;
+const MAX_STORED_MESSAGES = 200;
+/**
+ * In-memory conversation state for the dashboard assistant. `messages` is the display
+ * transcript (user/assistant text plus tool events); `chat` is the model-facing gateway
+ * transcript. Both live only for the process lifetime — v1 has no persistence by design.
+ */
+export class ConversationStore {
+    conversations = new Map();
+    create() {
+        const id = randomUUID();
+        this.conversations.set(id, { id, messages: [], chat: [], busy: false, listeners: new Set() });
+        // Map preserves insertion order — evict the oldest past the cap.
+        while (this.conversations.size > MAX_CONVERSATIONS) {
+            const oldest = this.conversations.keys().next().value;
+            this.conversations.delete(oldest);
+        }
+        return { id };
+    }
+    get(id) {
+        const conversation = this.conversations.get(id);
+        if (!conversation)
+            return undefined;
+        const { listeners: _listeners, ...visible } = conversation;
+        return visible;
+    }
+    appendChat(id, messages) {
+        const conversation = this.conversations.get(id);
+        if (conversation)
+            conversation.chat = messages;
+    }
+    appendStored(id, message) {
+        const conversation = this.conversations.get(id);
+        if (!conversation)
+            return;
+        conversation.messages.push(message);
+        if (conversation.messages.length > MAX_STORED_MESSAGES) {
+            conversation.messages.splice(0, conversation.messages.length - MAX_STORED_MESSAGES);
+        }
+    }
+    setBusy(id, busy) {
+        const conversation = this.conversations.get(id);
+        if (conversation)
+            conversation.busy = busy;
+    }
+    subscribe(id, listener) {
+        const conversation = this.conversations.get(id);
+        if (!conversation)
+            return () => undefined;
+        conversation.listeners.add(listener);
+        return () => conversation.listeners.delete(listener);
+    }
+    emit(id, event) {
+        const conversation = this.conversations.get(id);
+        if (!conversation)
+            return;
+        this.appendStored(id, { role: "event", event, at: new Date().toISOString() });
+        for (const listener of conversation.listeners)
+            listener(event);
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/dist/api/assistant/conversations.js.map

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

package/dist/api/assistant/routes.d.ts

@@ -0,0 +1,9 @@
+import type { FastifyInstance } from "fastify";
+import type { ModelPipeline } from "../../providers/types.js";
+export declare function registerAssistantRoutes(app: FastifyInstance, options: {
+    dataRoot: string;
+    createPipeline?: (target: {
+        providerId: string;
+        modelId: string;
+    }) => ModelPipeline;
+}): void;

package/dist/api/assistant/routes.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { ConversationStore } from "./conversations.js";
+import { AssistantTurnError, runAssistantTurn } from "./service.js";
+const MessageBodySchema = z.object({ content: z.string().min(1).max(8000) });
+export function registerAssistantRoutes(app, options) {
+    const store = new ConversationStore();
+    app.post("/api/assistant/conversations", async () => {
+        const { id } = store.create();
+        return { conversationId: id };
+    });
+    app.get("/api/assistant/conversations/:id", async (request, reply) => {
+        const { id } = request.params;
+        const conversation = store.get(id);
+        if (!conversation)
+            return reply.code(404).send({ error: "unknown conversation" });
+        return { id: conversation.id, busy: conversation.busy, messages: conversation.messages };
+    });
+    app.post("/api/assistant/conversations/:id/messages", async (request, reply) => {
+        const { id } = request.params;
+        const body = MessageBodySchema.parse(request.body);
+        try {
+            const content = await runAssistantTurn({ app, store, dataRoot: options.dataRoot, createPipeline: options.createPipeline }, id, body.content);
+            return { reply: content };
+        }
+        catch (error) {
+            if (error instanceof AssistantTurnError) {
+                return reply.code(error.statusCode).send({ error: error.message });
+            }
+            throw error;
+        }
+    });
+    app.get("/api/assistant/conversations/:id/stream", (request, reply) => {
+        const { id } = request.params;
+        const conversation = store.get(id);
+        if (!conversation) {
+            reply.code(404).send({ error: "unknown conversation" });
+            return;
+        }
+        reply.raw.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-cache",
+            connection: "keep-alive"
+        });
+        // Replay recorded events so a reopened panel catches up, then stream live.
+        for (const message of conversation.messages) {
+            if (message.role === "event") {
+                reply.raw.write(`event: assistant\ndata: ${JSON.stringify(message.event)}\n\n`);
+            }
+        }
+        const unsubscribe = store.subscribe(id, (event) => {
+            reply.raw.write(`event: assistant\ndata: ${JSON.stringify(event)}\n\n`);
+        });
+        const heartbeat = setInterval(() => {
+            reply.raw.write(`event: heartbeat\ndata: ${JSON.stringify({ time: new Date().toISOString() })}\n\n`);
+        }, 30_000);
+        request.raw.on("close", () => {
+            clearInterval(heartbeat);
+            unsubscribe();
+            reply.raw.end();
+        });
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/api/assistant/routes.js.map

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

package/dist/api/assistant/service.d.ts

@@ -0,0 +1,37 @@
+import type { FastifyInstance } from "fastify";
+import type { ModelPipeline } from "../../providers/types.js";
+import { ConversationStore } from "./conversations.js";
+export type AssistantTarget = {
+    ok: true;
+    providerId: string;
+    modelId: string;
+    params: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * The assistant runs on its own configured model when set, otherwise it borrows the
+ * orchestrator's. Params always come from the config that supplied the model.
+ */
+export declare function resolveAssistantTarget(app: FastifyInstance, dataRoot: string): Promise<AssistantTarget>;
+export declare function assistantSystemPrompt(snapshot: {
+    waifuCount: number;
+    serverCount: number;
+    providerIds: string[];
+    discordConnected: boolean;
+}): string;
+export type AssistantServiceDeps = {
+    app: FastifyInstance;
+    store: ConversationStore;
+    dataRoot: string;
+    createPipeline?: (target: {
+        providerId: string;
+        modelId: string;
+    }) => ModelPipeline;
+};
+export declare class AssistantTurnError extends Error {
+    readonly statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+export declare function runAssistantTurn(deps: AssistantServiceDeps, conversationId: string, userContent: string): Promise<string>;

package/dist/api/assistant/service.js

@@ -0,0 +1,124 @@
+import { createGatewayModelPipeline } from "../../orchestration/pipeline/gatewayPipeline.js";
+import { resolveModelTarget } from "../../orchestration/pipeline/resolveTarget.js";
+import { createProviderCredentialsLookup } from "../llmGatewayCredentials.js";
+import { executeAssistantTool, toolDefs } from "./tools.js";
+async function getJson(app, url) {
+    const response = await app.inject({ method: "GET", url });
+    if (response.statusCode !== 200)
+        return undefined;
+    return JSON.parse(response.body);
+}
+/**
+ * The assistant runs on its own configured model when set, otherwise it borrows the
+ * orchestrator's. Params always come from the config that supplied the model.
+ */
+export async function resolveAssistantTarget(app, dataRoot) {
+    const assistant = await getJson(app, "/api/assistant/config");
+    const orchestrator = await getJson(app, "/api/orchestrator/config");
+    const source = assistant?.modelId ? assistant : orchestrator?.modelId ? orchestrator : undefined;
+    if (!source) {
+        return { ok: false, reason: "No model configured — set one on the assistant or the orchestrator." };
+    }
+    let target;
+    try {
+        target = resolveModelTarget({
+            providerId: source.providerId,
+            modelId: source.modelId
+        });
+    }
+    catch {
+        return { ok: false, reason: `Model ${String(source.modelId)} is not recognized.` };
+    }
+    if (!createProviderCredentialsLookup(dataRoot)(target.providerId)) {
+        return { ok: false, reason: `Provider ${target.providerId} has no API key configured.` };
+    }
+    return { ok: true, ...target, params: source.params ?? {} };
+}
+export function assistantSystemPrompt(snapshot) {
+    return [
+        "You are the Discord Waifus dashboard assistant. You operate a locally-hosted multi-character Discord bot app on the user's behalf.",
+        "You have tools that read AND directly modify live configuration (waifus, servers, providers, agent configs, memories) plus a docs knowledge base (docs_search/docs_read).",
+        "Rules:",
+        "- Changes apply immediately. For destructive or hard-to-reverse actions (deleting a waifu, replacing a bot token, clearing a provider key), restate what you are about to do and ask the user to confirm in chat before calling the tool.",
+        "- Never echo API keys or bot tokens back to the user, even if they appear in tool output.",
+        "- Prefer docs_search before answering how-to questions you are not certain about.",
+        "- Be concise. Report what you changed with the field values that matter.",
+        `Current state: ${snapshot.waifuCount} waifus, ${snapshot.serverCount} servers, providers configured: ${snapshot.providerIds.join(", ") || "none"}, discord ${snapshot.discordConnected ? "connected" : "disconnected"}.`
+    ].join("\n");
+}
+async function buildSnapshot(app) {
+    const [status, waifus, servers, providers] = await Promise.all([
+        getJson(app, "/api/status"),
+        getJson(app, "/api/waifus"),
+        getJson(app, "/api/servers"),
+        getJson(app, "/api/providers")
+    ]);
+    const providerList = providers?.providers ?? [];
+    return {
+        waifuCount: (waifus?.waifus ?? []).length,
+        serverCount: (servers?.servers ?? []).length,
+        providerIds: providerList
+            .filter((provider) => provider.credentials?.configured)
+            .map((provider) => String(provider.providerId ?? provider.id)),
+        discordConnected: Boolean(status?.discord?.connected)
+    };
+}
+export class AssistantTurnError extends Error {
+    statusCode;
+    constructor(statusCode, message) {
+        super(message);
+        this.statusCode = statusCode;
+    }
+}
+export async function runAssistantTurn(deps, conversationId, userContent) {
+    const { app, store, dataRoot } = deps;
+    const conversation = store.get(conversationId);
+    if (!conversation)
+        throw new AssistantTurnError(404, "Unknown conversation.");
+    if (conversation.busy)
+        throw new AssistantTurnError(409, "A turn is already running in this conversation.");
+    const target = await resolveAssistantTarget(app, dataRoot);
+    if (!target.ok)
+        throw new AssistantTurnError(503, target.reason);
+    const pipeline = deps.createPipeline
+        ? deps.createPipeline({ providerId: target.providerId, modelId: target.modelId })
+        : createGatewayModelPipeline({
+            providerId: target.providerId,
+            modelId: target.modelId,
+            queryRole: "assistant",
+            dataRoot
+        });
+    if (!pipeline.generateAssistantTurn)
+        throw new AssistantTurnError(503, "The resolved pipeline cannot run assistant turns.");
+    const transcript = conversation.chat.length > 0
+        ? [...conversation.chat]
+        : [{ role: "system", content: assistantSystemPrompt(await buildSnapshot(app)) }];
+    transcript.push({ role: "user", content: userContent });
+    store.setBusy(conversationId, true);
+    store.appendStored(conversationId, { role: "user", content: userContent, at: new Date().toISOString() });
+    store.emit(conversationId, { type: "turn_started" });
+    try {
+        const result = await pipeline.generateAssistantTurn({
+            modelId: target.modelId,
+            messages: transcript,
+            tools: toolDefs(),
+            params: target.params,
+            executeTool: (name, argsJson) => executeAssistantTool({ app }, name, argsJson),
+            onEvent: (event) => store.emit(conversationId, event)
+        });
+        store.appendChat(conversationId, result.messages);
+        store.appendStored(conversationId, { role: "assistant", content: result.content, at: new Date().toISOString() });
+        store.emit(conversationId, { type: "text", content: result.content });
+        store.emit(conversationId, { type: "turn_completed" });
+        return result.content;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        store.emit(conversationId, { type: "error", message });
+        throw new AssistantTurnError(500, message);
+    }
+    finally {
+        store.setBusy(conversationId, false);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/api/assistant/service.js.map

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

package/dist/api/assistant/tools.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyInstance } from "fastify";
+import type { ToolDef } from "@waifucave/gateway";
+export type AssistantToolContext = {
+    app: FastifyInstance;
+};
+export type AssistantTool = {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (ctx: AssistantToolContext, args: Record<string, unknown>) => Promise<string>;
+};
+export declare const ASSISTANT_TOOLS: AssistantTool[];
+export declare function toolDefs(): ToolDef[];
+/** Execute a tool by name. Never throws — failures come back as strings the model can react to. */
+export declare function executeAssistantTool(ctx: AssistantToolContext, name: string, argsJson: string): Promise<string>;