@diegoaltoworks/chatter 0.21.0 → 0.23.0

package/dist/core/answer.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Brain hook — the seam where a consumer replaces the completion call.
+ *
+ * Every chat surface (widget routes, OpenAI-compatible routes, channels,
+ * programmatic use) asks for an answer through `answerOnce`/`answerStream`
+ * instead of calling `completeOnce`/`completeStream` directly. When
+ * `ChatterConfig.answerFn` is set it produces the answer — an agent
+ * framework, a graph runtime, a remote service, anything — and Chatter keeps
+ * owning the rest: retrieval and prompt assembly upstream, auth, rate
+ * limiting, transports and output guardrails around it.
+ *
+ * With no `answerFn` configured these are thin pass-throughs, so behaviour is
+ * exactly what it has always been.
+ */
+import type OpenAI from "openai";
+import type { PipelineMessage, PipelineMode } from "./pipeline";
+/** Token accounting in the OpenAI wire shape */
+export interface AnswerUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+/** What a brain is given: the assembled prompt plus who is asking */
+export interface AnswerFnInput {
+    /** Fully assembled system prompt from `prepareChat` */
+    system: string;
+    /** Conversation messages */
+    messages: PipelineMessage[];
+    /** Which pipeline the answer is for */
+    mode: PipelineMode;
+    /** Channel-specific sender identity, when the surface knows one */
+    sender?: string;
+}
+/**
+ * What a brain returns: the answer text, optionally with token usage for
+ * surfaces that report it.
+ */
+export type AnswerFnResult = string | {
+    content: string;
+    usage?: AnswerUsage;
+};
+/**
+ * Replaces the completion call on every chat surface. Rejections propagate to
+ * the caller like any other completion failure.
+ */
+export type AnswerFn = (input: AnswerFnInput) => Promise<AnswerFnResult> | AnswerFnResult;
+export interface AnswerOptions {
+    /** Caller-supplied brain; falls back to the built-in completion when unset */
+    answerFn?: AnswerFn;
+    /** Used by the built-in completion; untouched when `answerFn` answers */
+    client: OpenAI;
+    system: string;
+    messages: PipelineMessage[];
+    mode: PipelineMode;
+    sender?: string;
+    temperature?: number;
+    model?: string;
+}
+/**
+ * Produce one complete answer, from `answerFn` when configured.
+ */
+export declare function answerOnce({ answerFn, client, system, messages, mode, sender, temperature, model, }: AnswerOptions): Promise<{
+    content: string;
+    usage: AnswerUsage;
+}>;
+/**
+ * Stream an answer. A brain that returns a plain string cannot stream, so its
+ * answer degrades to a single chunk followed by the stream's normal end —
+ * streaming surfaces keep their wire format either way.
+ *
+ * Because a brain's answer arrives whole, it gets the full guardrails; the
+ * built-in stream only scrubs each delta, since leakage detection needs text
+ * no streamed chunk has yet.
+ */
+export declare function answerStream({ answerFn, client, system, messages, mode, sender, temperature, model, }: AnswerOptions): AsyncGenerator<string>;
+//# sourceMappingURL=answer.d.ts.map

package/dist/core/answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../src/core/answer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAC/B,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,WAAW,EACX,KAAK,GACN,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,CAKlE;AAED;;;;;;;;GAQG;AACH,wBAAuB,YAAY,CAAC,EAClC,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,WAAW,EACX,KAAK,GACN,EAAE,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,CAOxC"}

package/dist/core/answer.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Brain hook tests
+ *
+ * Uses a faked OpenAI client so both the built-in completion path and the
+ * `answerFn` path can be asserted without touching OpenAI.
+ */
+export {};
+//# sourceMappingURL=answer.test.d.ts.map

package/dist/core/answer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.test.d.ts","sourceRoot":"","sources":["../../src/core/answer.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/guardrails.d.ts

@@ -1,3 +1,11 @@
 export declare function detectLeakage(text: string): boolean;
 export declare function scrubOutput(text: string): string;
+/**
+ * Apply the full output guardrails to a complete answer: refuse leaked
+ * instructions outright, then scrub credentials from whatever remains.
+ *
+ * Used for every non-streamed answer, whoever produced it — the built-in
+ * completion or a caller-supplied brain (`answerFn`).
+ */
+export declare function guardOutput(text: string): string;
 //# sourceMappingURL=guardrails.d.ts.map

package/dist/core/guardrails.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASnD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhD"}
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/core/guardrails.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASnD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD"}

package/dist/core/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/core/llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,wBAAsB,YAAY,CAAC,EACjC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,WAAiB,EACjB,KAAqB,GACtB,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;GAaA;AAGD,wBAAuB,cAAc,CAAC,EACpC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,WAAiB,EACjB,KAAqB,GACtB,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,yCAYA"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/core/llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC,wBAAsB,YAAY,CAAC,EACjC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,WAAiB,EACjB,KAAqB,GACtB,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;;GAWA;AAGD,wBAAuB,cAAc,CAAC,EACpC,MAAM,EACN,MAAM,EACN,QAAQ,EACR,WAAiB,EACjB,KAAqB,GACtB,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,yCAYA"}

package/dist/core/pipeline.d.ts

@@ -4,7 +4,9 @@
  * This is the single place where a conversation is turned into a
  * retrieval-augmented completion request. Every surface (widget routes,
  * OpenAI-compatible routes, MCP, programmatic use) should go through here
- * so behaviour stays identical regardless of how the chat is consumed.
+ * so behaviour stays identical regardless of how the chat is consumed, and
+ * then ask for the answer via `answerOnce`/`answerStream` (see ./answer.ts)
+ * so a caller-supplied brain is honoured.
  */
 import type { PromptLoader } from "./prompts";
 import type { VectorStore } from "./retrieval";

package/dist/core/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,EAChC,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBxB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,EAChC,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBxB"}

package/dist/core/retrieval.d.ts

@@ -1,14 +1,39 @@
+import { type Client as LibsqlClient } from "@libsql/client";
 import type OpenAI from "openai";
 import { type Bucket } from "./loaders";
+/**
+ * How a {@link VectorStore} obtains its database connection: either credentials
+ * to open its own, or an existing libsql client to reuse.
+ *
+ * Reusing a client is preferred when the store lives alongside other consumers
+ * of the same database (route factories, custom routes) — the process then
+ * holds one connection instead of one per consumer.
+ */
+export type VectorStoreOptions = {
+    /** Directory of markdown knowledge files. Default: `./config/knowledge` */
+    knowledgeDir?: string;
+} & ({
+    /** Turso database URL */
+    databaseUrl: string;
+    /** Turso auth token */
+    databaseAuthToken: string;
+    databaseClient?: never;
+} | {
+    /** An existing libsql client to reuse instead of opening a second connection */
+    databaseClient: LibsqlClient;
+    databaseUrl?: never;
+    databaseAuthToken?: never;
+});
 export declare class VectorStore {
     private client;
-    private db;
+    /**
+     * The libsql client backing this store. When a client was injected this is
+     * that same instance, so callers holding it (e.g. `ServerDependencies.db`)
+     * and the store share one connection.
+     */
+    readonly db: LibsqlClient;
     private knowledgeDir;
-    constructor(client: OpenAI, options: {
-        databaseUrl: string;
-        databaseAuthToken: string;
-        knowledgeDir?: string;
-    });
+    constructor(client: OpenAI, options: VectorStoreOptions);
     build(): Promise<void>;
     private cleanupStaleChunks;
     private static cosine;

package/dist/core/retrieval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/core/retrieval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,WAAW,CAAC;AAyBvD,qBAAa,WAAW;IAKpB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,YAAY,CAAS;IAE7B,YACU,MAAM,EAAE,MAAM,EACtB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAOF;IAGK,KAAK,kBA0FV;YAGa,kBAAkB;IA8BhC,OAAO,CAAC,MAAM,CAAC,MAAM;IAaf,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,OAAO,GAAE,MAAM,EAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB7E;CACF"}
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/core/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,WAAW,CAAC;AAyBvD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,CACA;IACE,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,GACD;IACE,gFAAgF;IAChF,cAAc,EAAE,YAAY,CAAC;IAC7B,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,iBAAiB,CAAC,EAAE,KAAK,CAAC;CAC3B,CACJ,CAAC;AAEF,qBAAa,WAAW;IAUpB,OAAO,CAAC,MAAM;IAThB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,OAAO,CAAC,YAAY,CAAS;IAE7B,YACU,MAAM,EAAE,MAAM,EACtB,OAAO,EAAE,kBAAkB,EAS5B;IAGK,KAAK,kBA0FV;YAGa,kBAAkB;IA8BhC,OAAO,CAAC,MAAM,CAAC,MAAM;IAaf,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,OAAO,GAAE,MAAM,EAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB7E;CACF"}

package/dist/core/retrieval.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vector store connection tests
+ *
+ * Uses a faked libsql client and OpenAI client so the connection wiring can be
+ * asserted without touching Turso or OpenAI.
+ */
+export {};
+//# sourceMappingURL=retrieval.test.d.ts.map

package/dist/core/retrieval.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.test.d.ts","sourceRoot":"","sources":["../../src/core/retrieval.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/index.d.ts

@@ -14,12 +14,15 @@ export type { ApiKeyOptions, ApiKeyPayload, VerifyResult } from "./auth";
 export { ApiKeyManager } from "./auth";
 export type { ChatBotConfig, ChatButtonConfig, ChatConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./client";
 export { Chat, ChatBot, ChatButton } from "./client";
-export { detectLeakage, scrubOutput } from "./core/guardrails";
+export type { AnswerFn, AnswerFnInput, AnswerFnResult, AnswerOptions, AnswerUsage, } from "./core/answer";
+export { answerOnce, answerStream } from "./core/answer";
+export { detectLeakage, guardOutput, scrubOutput } from "./core/guardrails";
 export { completeOnce, completeStream, DEFAULT_MODEL } from "./core/llm";
 export { loadKnowledge } from "./core/loaders";
 export type { PipelineMessage, PipelineMode, PreparedChat } from "./core/pipeline";
 export { prepareChat } from "./core/pipeline";
 export { PromptLoader } from "./core/prompts";
+export type { VectorStoreOptions } from "./core/retrieval";
 export { VectorStore } from "./core/retrieval";
 export { createSession, getActiveSessions, getSessionInfo, validateSession, } from "./core/session";
 export type { MCPServerOptions, MCPTransportMode } from "./mcp-server";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7531,12 +7531,14 @@ var require_dist2 = __commonJS({
 var index_exports = {};
 __export(index_exports, {
   ApiKeyManager: () => ApiKeyManager,
-  Chat: () => import_client2.Chat,
-  ChatBot: () => import_client2.ChatBot,
-  ChatButton: () => import_client2.ChatButton,
+  Chat: () => import_client3.Chat,
+  ChatBot: () => import_client3.ChatBot,
+  ChatButton: () => import_client3.ChatButton,
   DEFAULT_MODEL: () => DEFAULT_MODEL,
   PromptLoader: () => PromptLoader,
   VectorStore: () => VectorStore,
+  answerOnce: () => answerOnce,
+  answerStream: () => answerStream,
   completeOnce: () => completeOnce,
   completeStream: () => completeStream,
   cors: () => cors,
@@ -7552,6 +7554,7 @@ __export(index_exports, {
   detectLeakage: () => detectLeakage,
   getActiveSessions: () => getActiveSessions,
   getSessionInfo: () => getSessionInfo,
+  guardOutput: () => guardOutput,
   loadKnowledge: () => loadKnowledge,
   openaiRoutes: () => openaiRoutes,
   prepareChat: () => prepareChat,
@@ -7674,7 +7677,7 @@ var ApiKeyManager = class {
 };
 
 // src/index.ts
-var import_client2 = __toESM(require_dist());
+var import_client3 = __toESM(require_dist());
 
 // src/core/guardrails.ts
 function detectLeakage(text) {
@@ -7690,6 +7693,12 @@ function detectLeakage(text) {
 function scrubOutput(text) {
   return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
 }
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
 
 // src/core/llm.ts
 var DEFAULT_MODEL = "gpt-4o";
@@ -7705,11 +7714,9 @@ async function completeOnce({
     temperature,
     messages: [{ role: "system", content: system }, ...messages]
   });
-  let text = res.choices[0]?.message?.content ?? "";
-  if (detectLeakage(text))
-    text = "Sorry, I can't share internal instructions. How else can I help?";
+  const text = res.choices[0]?.message?.content ?? "";
   return {
-    content: scrubOutput(text),
+    content: guardOutput(text),
     usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
   };
 }
@@ -7732,6 +7739,50 @@ async function* completeStream({
   }
 }
 
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender }) {
+  const result = await answerFn({ system, messages, mode, sender });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+async function* answerStream({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    const { content } = await runAnswerFn(answerFn, { system, messages, mode, sender });
+    if (content) yield content;
+    return;
+  }
+  yield* completeStream({ client, system, messages, temperature, model });
+}
+
 // src/core/loaders.ts
 var import_node_fs = require("node:fs");
 var import_node_path = require("node:path");
@@ -7848,13 +7899,18 @@ async function sha256(input) {
 var VectorStore = class _VectorStore {
   constructor(client, options) {
     this.client = client;
-    this.db = (0, import_client.createClient)({
+    this.db = options.databaseClient ? options.databaseClient : (0, import_client.createClient)({
       url: options.databaseUrl,
       authToken: options.databaseAuthToken
     });
     this.knowledgeDir = options.knowledgeDir || "./config/knowledge";
   }
   client;
+  /**
+   * The libsql client backing this store. When a client was injected this is
+   * that same instance, so callers holding it (e.g. `ServerDependencies.db`)
+   * and the store share one connection.
+   */
   db;
   knowledgeDir;
   // On boot: ingest new chunks and embed only missing ones.
@@ -32248,10 +32304,12 @@ async function createMCPServer(config2) {
           `Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config2.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "public"
         });
         const cost = calculateCost(result.usage);
         const duration3 = Date.now() - startTime;
@@ -32332,10 +32390,12 @@ ${ctx.join("\n\n")}`
           `Internal Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config2.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "private"
         });
         const cost = calculateCost(result.usage);
         const duration3 = Date.now() - startTime;
@@ -32753,7 +32813,13 @@ ${ctx.join("\n\n")}`
       const wantsStream3 = url2.searchParams.get("stream") === "1";
       if (wantsStream3) {
         return (0, import_streaming.stream)(c, async (s) => {
-          for await (const delta of completeStream({ client, system, messages })) {
+          for await (const delta of answerStream({
+            answerFn: config2.answerFn,
+            client,
+            system,
+            messages,
+            mode: "public"
+          })) {
             await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32761,7 +32827,13 @@ ${ctx.join("\n\n")}`
           await s.write("event: end\ndata: {}\n\n");
         });
       }
-      const out = await completeOnce({ client, system, messages });
+      const out = await answerOnce({
+        answerFn: config2.answerFn,
+        client,
+        system,
+        messages,
+        mode: "public"
+      });
       return c.json({ reply: out.content });
     } catch (error51) {
       const err = error51;
@@ -32858,10 +32930,12 @@ function openaiRoutes(deps) {
 
 `;
         await s.write(chunk2({ role: "assistant", content: "" }, null));
-        for await (const delta of completeStream({
+        for await (const delta of answerStream({
+          answerFn: config2.answerFn,
           client,
           system,
           messages,
+          mode,
           temperature,
           model: serverModel
         })) {
@@ -32871,7 +32945,15 @@ function openaiRoutes(deps) {
         await s.write("data: [DONE]\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, temperature, model: serverModel });
+    const out = await answerOnce({
+      answerFn: config2.answerFn,
+      client,
+      system,
+      messages,
+      mode,
+      temperature,
+      model: serverModel
+    });
     return c.json({
       id,
       object: "chat.completion",
@@ -32932,9 +33014,17 @@ function privateRoutes(deps) {
       return c.json({ error: "no user message found in conversation" }, 400);
     }
     const model = config2.openai.model;
+    const answerFn = config2.answerFn;
     if (wantsStream(c)) {
       return (0, import_streaming3.stream)(c, async (s) => {
-        for await (const delta of completeStream({ client, system, messages, model })) {
+        for await (const delta of answerStream({
+          answerFn,
+          client,
+          system,
+          messages,
+          mode: "private",
+          model
+        })) {
           await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32942,7 +33032,7 @@ function privateRoutes(deps) {
         await s.write("event: end\ndata: {}\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, model });
+    const out = await answerOnce({ answerFn, client, system, messages, mode: "private", model });
     return c.json({ reply: out.content });
   });
   return app;
@@ -32987,9 +33077,17 @@ function publicRoutes(deps) {
       return c.json({ error: "no user message found in conversation" }, 400);
     }
     const model = config2.openai.model;
+    const answerFn = config2.answerFn;
     if (wantsStream2(c)) {
       return (0, import_streaming4.stream)(c, async (s) => {
-        for await (const delta of completeStream({ client, system, messages, model })) {
+        for await (const delta of answerStream({
+          answerFn,
+          client,
+          system,
+          messages,
+          mode: "public",
+          model
+        })) {
           await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32997,13 +33095,14 @@ function publicRoutes(deps) {
         await s.write("event: end\ndata: {}\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, model });
+    const out = await answerOnce({ answerFn, client, system, messages, mode: "public", model });
     return c.json({ reply: out.content });
   });
   return app;
 }
 
 // src/server.ts
+var import_client2 = require("@libsql/client");
 var import_hono5 = require("hono");
 var import_bun = require("hono/bun");
 var import_openai2 = __toESM(require("openai"));
@@ -33050,9 +33149,12 @@ async function createServer(config2) {
   const client = new import_openai2.default({
     apiKey: config2.openai.apiKey
   });
+  const db = (0, import_client2.createClient)({
+    url: config2.database.url,
+    authToken: config2.database.authToken
+  });
   const store = new VectorStore(client, {
-    databaseUrl: config2.database.url,
-    databaseAuthToken: config2.database.authToken,
+    databaseClient: db,
     knowledgeDir
   });
   await store.build();
@@ -33130,7 +33232,7 @@ async function createServer(config2) {
     app.get("/demo/chatbot", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-chatbot.html` }));
     app.get("/demo/react", (0, import_bun.serveStatic)({ path: `${publicDir}/react-demo.html` }));
   }
-  const deps = { client, store, config: config2, prompts, apiKeyManager };
+  const deps = { client, store, db, config: config2, prompts, apiKeyManager };
   if (enablePublic) {
     app.route("/", publicRoutes(deps));
   }
@@ -33158,6 +33260,8 @@ async function createServer(config2) {
   DEFAULT_MODEL,
   PromptLoader,
   VectorStore,
+  answerOnce,
+  answerStream,
   completeOnce,
   completeStream,
   cors,
@@ -33173,6 +33277,7 @@ async function createServer(config2) {
   detectLeakage,
   getActiveSessions,
   getSessionInfo,
+  guardOutput,
   loadKnowledge,
   openaiRoutes,
   prepareChat,

package/dist/index.mjs

@@ -7643,7 +7643,7 @@ var ApiKeyManager = class {
 };
 
 // src/index.ts
-var import_client2 = __toESM(require_dist());
+var import_client3 = __toESM(require_dist());
 
 // src/core/guardrails.ts
 function detectLeakage(text) {
@@ -7659,6 +7659,12 @@ function detectLeakage(text) {
 function scrubOutput(text) {
   return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
 }
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
 
 // src/core/llm.ts
 var DEFAULT_MODEL = "gpt-4o";
@@ -7674,11 +7680,9 @@ async function completeOnce({
     temperature,
     messages: [{ role: "system", content: system }, ...messages]
   });
-  let text = res.choices[0]?.message?.content ?? "";
-  if (detectLeakage(text))
-    text = "Sorry, I can't share internal instructions. How else can I help?";
+  const text = res.choices[0]?.message?.content ?? "";
   return {
-    content: scrubOutput(text),
+    content: guardOutput(text),
     usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
   };
 }
@@ -7701,6 +7705,50 @@ async function* completeStream({
   }
 }
 
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender }) {
+  const result = await answerFn({ system, messages, mode, sender });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+async function* answerStream({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    const { content } = await runAnswerFn(answerFn, { system, messages, mode, sender });
+    if (content) yield content;
+    return;
+  }
+  yield* completeStream({ client, system, messages, temperature, model });
+}
+
 // src/core/loaders.ts
 import { readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
@@ -7817,13 +7865,18 @@ async function sha256(input) {
 var VectorStore = class _VectorStore {
   constructor(client, options) {
     this.client = client;
-    this.db = createClient({
+    this.db = options.databaseClient ? options.databaseClient : createClient({
       url: options.databaseUrl,
       authToken: options.databaseAuthToken
     });
     this.knowledgeDir = options.knowledgeDir || "./config/knowledge";
   }
   client;
+  /**
+   * The libsql client backing this store. When a client was injected this is
+   * that same instance, so callers holding it (e.g. `ServerDependencies.db`)
+   * and the store share one connection.
+   */
   db;
   knowledgeDir;
   // On boot: ingest new chunks and embed only missing ones.
@@ -32217,10 +32270,12 @@ async function createMCPServer(config2) {
           `Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config2.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "public"
         });
         const cost = calculateCost(result.usage);
         const duration3 = Date.now() - startTime;
@@ -32301,10 +32356,12 @@ ${ctx.join("\n\n")}`
           `Internal Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config2.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "private"
         });
         const cost = calculateCost(result.usage);
         const duration3 = Date.now() - startTime;
@@ -32722,7 +32779,13 @@ ${ctx.join("\n\n")}`
       const wantsStream3 = url2.searchParams.get("stream") === "1";
       if (wantsStream3) {
         return stream(c, async (s) => {
-          for await (const delta of completeStream({ client, system, messages })) {
+          for await (const delta of answerStream({
+            answerFn: config2.answerFn,
+            client,
+            system,
+            messages,
+            mode: "public"
+          })) {
             await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32730,7 +32793,13 @@ ${ctx.join("\n\n")}`
           await s.write("event: end\ndata: {}\n\n");
         });
       }
-      const out = await completeOnce({ client, system, messages });
+      const out = await answerOnce({
+        answerFn: config2.answerFn,
+        client,
+        system,
+        messages,
+        mode: "public"
+      });
       return c.json({ reply: out.content });
     } catch (error51) {
       const err = error51;
@@ -32827,10 +32896,12 @@ function openaiRoutes(deps) {
 
 `;
         await s.write(chunk2({ role: "assistant", content: "" }, null));
-        for await (const delta of completeStream({
+        for await (const delta of answerStream({
+          answerFn: config2.answerFn,
           client,
           system,
           messages,
+          mode,
           temperature,
           model: serverModel
         })) {
@@ -32840,7 +32911,15 @@ function openaiRoutes(deps) {
         await s.write("data: [DONE]\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, temperature, model: serverModel });
+    const out = await answerOnce({
+      answerFn: config2.answerFn,
+      client,
+      system,
+      messages,
+      mode,
+      temperature,
+      model: serverModel
+    });
     return c.json({
       id,
       object: "chat.completion",
@@ -32901,9 +32980,17 @@ function privateRoutes(deps) {
       return c.json({ error: "no user message found in conversation" }, 400);
     }
     const model = config2.openai.model;
+    const answerFn = config2.answerFn;
     if (wantsStream(c)) {
       return stream3(c, async (s) => {
-        for await (const delta of completeStream({ client, system, messages, model })) {
+        for await (const delta of answerStream({
+          answerFn,
+          client,
+          system,
+          messages,
+          mode: "private",
+          model
+        })) {
           await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32911,7 +32998,7 @@ function privateRoutes(deps) {
         await s.write("event: end\ndata: {}\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, model });
+    const out = await answerOnce({ answerFn, client, system, messages, mode: "private", model });
     return c.json({ reply: out.content });
   });
   return app;
@@ -32956,9 +33043,17 @@ function publicRoutes(deps) {
       return c.json({ error: "no user message found in conversation" }, 400);
     }
     const model = config2.openai.model;
+    const answerFn = config2.answerFn;
     if (wantsStream2(c)) {
       return stream4(c, async (s) => {
-        for await (const delta of completeStream({ client, system, messages, model })) {
+        for await (const delta of answerStream({
+          answerFn,
+          client,
+          system,
+          messages,
+          mode: "public",
+          model
+        })) {
           await s.write(`data: ${JSON.stringify({ delta })}
 
 `);
@@ -32966,13 +33061,14 @@ function publicRoutes(deps) {
         await s.write("event: end\ndata: {}\n\n");
       });
     }
-    const out = await completeOnce({ client, system, messages, model });
+    const out = await answerOnce({ answerFn, client, system, messages, mode: "public", model });
     return c.json({ reply: out.content });
   });
   return app;
 }
 
 // src/server.ts
+import { createClient as createClient2 } from "@libsql/client";
 import { Hono as Hono5 } from "hono";
 import { serveStatic } from "hono/bun";
 import OpenAI2 from "openai";
@@ -33018,9 +33114,12 @@ async function createServer(config2) {
   const client = new OpenAI2({
     apiKey: config2.openai.apiKey
   });
+  const db = createClient2({
+    url: config2.database.url,
+    authToken: config2.database.authToken
+  });
   const store = new VectorStore(client, {
-    databaseUrl: config2.database.url,
-    databaseAuthToken: config2.database.authToken,
+    databaseClient: db,
     knowledgeDir
   });
   await store.build();
@@ -33098,7 +33197,7 @@ async function createServer(config2) {
     app.get("/demo/chatbot", serveStatic({ path: `${publicDir}/demo-chatbot.html` }));
     app.get("/demo/react", serveStatic({ path: `${publicDir}/react-demo.html` }));
   }
-  const deps = { client, store, config: config2, prompts, apiKeyManager };
+  const deps = { client, store, db, config: config2, prompts, apiKeyManager };
   if (enablePublic) {
     app.route("/", publicRoutes(deps));
   }
@@ -33117,9 +33216,9 @@ async function createServer(config2) {
   console.log(`\u2705 ${config2.bot.name} server ready`);
   return app;
 }
-var export_Chat = import_client2.Chat;
-var export_ChatBot = import_client2.ChatBot;
-var export_ChatButton = import_client2.ChatButton;
+var export_Chat = import_client3.Chat;
+var export_ChatBot = import_client3.ChatBot;
+var export_ChatButton = import_client3.ChatButton;
 export {
   ApiKeyManager,
   export_Chat as Chat,
@@ -33128,6 +33227,8 @@ export {
   DEFAULT_MODEL,
   PromptLoader,
   VectorStore,
+  answerOnce,
+  answerStream,
   completeOnce,
   completeStream,
   cors,
@@ -33143,6 +33244,7 @@ export {
   detectLeakage,
   getActiveSessions,
   getSessionInfo,
+  guardOutput,
   loadKnowledge,
   openaiRoutes,
   prepareChat,

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,sBAuS7D"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,YAAY,EACV,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,gBAAgB,sBA2S7D"}

package/dist/mcp-server.js

@@ -51,6 +51,12 @@ function detectLeakage(text) {
 function scrubOutput(text) {
   return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
 }
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
 
 // src/core/llm.ts
 var DEFAULT_MODEL = "gpt-4o";
@@ -66,15 +72,40 @@ async function completeOnce({
     temperature,
     messages: [{ role: "system", content: system }, ...messages]
   });
-  let text = res.choices[0]?.message?.content ?? "";
-  if (detectLeakage(text))
-    text = "Sorry, I can't share internal instructions. How else can I help?";
+  const text = res.choices[0]?.message?.content ?? "";
   return {
-    content: scrubOutput(text),
+    content: guardOutput(text),
     usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
   };
 }
 
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender }) {
+  const result = await answerFn({ system, messages, mode, sender });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+
 // src/core/prompts.ts
 var import_node_fs = require("node:fs");
 var import_node_path = require("node:path");
@@ -162,13 +193,18 @@ async function sha256(input) {
 var VectorStore = class _VectorStore {
   constructor(client, options) {
     this.client = client;
-    this.db = (0, import_client.createClient)({
+    this.db = options.databaseClient ? options.databaseClient : (0, import_client.createClient)({
       url: options.databaseUrl,
       authToken: options.databaseAuthToken
     });
     this.knowledgeDir = options.knowledgeDir || "./config/knowledge";
   }
   client;
+  /**
+   * The libsql client backing this store. When a client was injected this is
+   * that same instance, so callers holding it (e.g. `ServerDependencies.db`)
+   * and the store share one connection.
+   */
   db;
   knowledgeDir;
   // On boot: ingest new chunks and embed only missing ones.
@@ -531,10 +567,12 @@ async function createMCPServer(config) {
           `Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "public"
         });
         const cost = calculateCost(result.usage);
         const duration = Date.now() - startTime;
@@ -615,10 +653,12 @@ ${ctx.join("\n\n")}`
           `Internal Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "private"
         });
         const cost = calculateCost(result.usage);
         const duration = Date.now() - startTime;

package/dist/mcp-server.mjs

@@ -17,6 +17,12 @@ function detectLeakage(text) {
 function scrubOutput(text) {
   return text.replace(/sk-[A-Za-z0-9]{15,}/g, "[REDACTED]").replace(/AIza[0-9A-Za-z_-]{30,}/g, "[REDACTED]");
 }
+function guardOutput(text) {
+  if (detectLeakage(text)) {
+    return "Sorry, I can't share internal instructions. How else can I help?";
+  }
+  return scrubOutput(text);
+}
 
 // src/core/llm.ts
 var DEFAULT_MODEL = "gpt-4o";
@@ -32,15 +38,40 @@ async function completeOnce({
     temperature,
     messages: [{ role: "system", content: system }, ...messages]
   });
-  let text = res.choices[0]?.message?.content ?? "";
-  if (detectLeakage(text))
-    text = "Sorry, I can't share internal instructions. How else can I help?";
+  const text = res.choices[0]?.message?.content ?? "";
   return {
-    content: scrubOutput(text),
+    content: guardOutput(text),
     usage: res.usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 }
   };
 }
 
+// src/core/answer.ts
+var noUsage = () => ({ prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 });
+async function runAnswerFn(answerFn, { system, messages, mode, sender }) {
+  const result = await answerFn({ system, messages, mode, sender });
+  const raw = typeof result === "string" ? result : result?.content;
+  const usage = typeof result === "string" ? void 0 : result?.usage;
+  return {
+    content: guardOutput(typeof raw === "string" ? raw : ""),
+    usage: usage ?? noUsage()
+  };
+}
+async function answerOnce({
+  answerFn,
+  client,
+  system,
+  messages,
+  mode,
+  sender,
+  temperature,
+  model
+}) {
+  if (answerFn) {
+    return runAnswerFn(answerFn, { system, messages, mode, sender });
+  }
+  return completeOnce({ client, system, messages, temperature, model });
+}
+
 // src/core/prompts.ts
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -128,13 +159,18 @@ async function sha256(input) {
 var VectorStore = class _VectorStore {
   constructor(client, options) {
     this.client = client;
-    this.db = createClient({
+    this.db = options.databaseClient ? options.databaseClient : createClient({
       url: options.databaseUrl,
       authToken: options.databaseAuthToken
     });
     this.knowledgeDir = options.knowledgeDir || "./config/knowledge";
   }
   client;
+  /**
+   * The libsql client backing this store. When a client was injected this is
+   * that same instance, so callers holding it (e.g. `ServerDependencies.db`)
+   * and the store share one connection.
+   */
   db;
   knowledgeDir;
   // On boot: ingest new chunks and embed only missing ones.
@@ -497,10 +533,12 @@ async function createMCPServer(config) {
           `Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "public"
         });
         const cost = calculateCost(result.usage);
         const duration = Date.now() - startTime;
@@ -581,10 +619,12 @@ ${ctx.join("\n\n")}`
           `Internal Context:
 ${ctx.join("\n\n")}`
         ].join("\n\n");
-        const result = await completeOnce({
+        const result = await answerOnce({
+          answerFn: config.answerFn,
           client,
           system,
-          messages: conversationMessages
+          messages: conversationMessages,
+          mode: "private"
         });
         const cost = calculateCost(result.usage);
         const duration = Date.now() - startTime;

package/dist/routes/chat.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Widget chat route tests
+ *
+ * Covers the brain hook on the public and private chat routes with faked
+ * dependencies: no OpenAI, no Turso, and a locally generated RS256 keypair
+ * for the private route's JWT so real verification runs offline.
+ */
+export {};
+//# sourceMappingURL=chat.test.d.ts.map

package/dist/routes/chat.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.test.d.ts","sourceRoot":"","sources":["../../src/routes/chat.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/routes/demo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/routes/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAsHnD,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,8EAqGlD"}
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/routes/demo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAsHnD,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,8EAiHlD"}

package/dist/routes/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/routes/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,kBAAkB,CAAC;AAGxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,IAAI,CA8BxE;AASD,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,8EAsHpD"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/routes/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,kBAAkB,CAAC;AAGxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,IAAI,CA8BxE;AASD,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,8EAgIpD"}

package/dist/routes/private.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"private.d.ts","sourceRoot":"","sources":["../../src/routes/private.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,8EAqDrD"}
+{"version":3,"file":"private.d.ts","sourceRoot":"","sources":["../../src/routes/private.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,8EA6DrD"}

package/dist/routes/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/routes/public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASnD,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,8EA8DpD"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/routes/public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASnD,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,8EAsEpD"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,uFAwJvD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,uFA8JvD"}

package/dist/types.d.ts

@@ -4,8 +4,10 @@
  * Core types for the Chatter chatbot framework.
  * These types define the public API and configuration interface.
  */
+import type { Client as LibsqlClient } from "@libsql/client";
 import type { Hono } from "hono";
 import type OpenAI from "openai";
+import type { AnswerFn } from "./core/answer";
 import type { PromptLoader } from "./core/prompts";
 import type { VectorStore } from "./core/retrieval";
 /**
@@ -143,6 +145,17 @@ export interface ChatterConfig {
          */
         allowedOrigins?: string[];
     };
+    /**
+     * Replaces the completion call on every chat surface with your own brain —
+     * an agent framework, a graph runtime, a remote service. Receives the
+     * assembled system prompt and conversation from the pipeline and returns
+     * the answer text (optionally with token usage).
+     *
+     * Retrieval, prompt assembly, auth, rate limiting, transports and output
+     * guardrails all stay Chatter's. Errors surface as normal completion
+     * errors. Unset: the built-in OpenAI completion is used.
+     */
+    answerFn?: AnswerFn;
     /** Custom route handler for advanced use cases */
     customRoutes?: (app: Hono, deps: ServerDependencies) => void;
 }
@@ -154,6 +167,12 @@ export interface ServerDependencies {
     client: OpenAI;
     /** Vector store instance */
     store: VectorStore;
+    /**
+     * The libsql database client, shared with the vector store. Custom routes
+     * should use this handle rather than opening their own connection to the
+     * same database.
+     */
+    db: LibsqlClient;
     /** Chatter configuration */
     config: ChatterConfig;
     /** Prompt loader instance */

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -59,6 +59,13 @@
     "security:audit:fix": "bun update",
     "security:check": "bun audit --audit-level=moderate",
     "check": "bun run typecheck && bun run lint && bun run test && bun run security:check",
+    "work": "bun ./.claude/work.ts run",
+    "work:continuous": "bun ./.claude/work.ts run --continuous",
+    "work:status": "bun ./.claude/work.ts status",
+    "work:reset": "bun ./.claude/work.ts reset",
+    "work:watch": "bun ./.claude/work.ts watch",
+    "work:resume": "bun ./.claude/work.ts resume",
+    "work:halt": "bun ./.claude/work.ts halt",
     "prepublishOnly": "bun run lint && bun run typecheck && bun run test && bun run security:check && bun run build",
     "prepare": "husky || true"
   },