@diegoaltoworks/chatter 0.61.0 → 0.63.0

package/dist/shortener.d.ts

@@ -2,10 +2,11 @@
  * URL shortening against a Kutt-compatible API, config-injected (no
  * `process.env` reads) so hosts can wire credentials however they like.
  *
- * The hard invariant: {@link Shortener.shorten} never throws. Any failure —
- * network error, an aborted request past `timeoutMs`, or a non-2xx/malformed
- * response — resolves to the original URL, since a shortener outage must
- * never break something user-facing that only wanted a shorter link.
+ * The hard invariant: {@link Shortener.shorten} never throws. Any failure
+ * (a network error, an aborted request past `timeoutMs`, or a
+ * non-2xx/malformed response) resolves to the original URL instead, since a
+ * shortener outage must never break something user-facing that only wanted
+ * a shorter link.
  */
 export interface ShortenerConfig {
     /** Base URL of the Kutt (or Kutt-compatible) instance, e.g. "https://kutt.it". */

package/dist/shortener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shortener.d.ts","sourceRoot":"","sources":["../src/shortener.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAQD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,OAAO,KAAa,GAC9B,SAAS,CAqCX"}
+{"version":3,"file":"shortener.d.ts","sourceRoot":"","sources":["../src/shortener.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAQD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,OAAO,KAAa,GAC9B,SAAS,CAwCX"}

package/dist/types.d.ts

@@ -11,9 +11,9 @@ import type { Channel, ChannelSenderRegistry } from "./channels";
 import type { AnswerFn, TransformReply } from "./core/answer";
 import type { BucketsFor } from "./core/buckets";
 import type { Logger, LogLevel } from "./core/logger";
-import type { RerankContext, RewriteQuery } from "./core/pipeline";
+import type { FallbackFn, RerankContext, RewriteQuery } from "./core/pipeline";
 import type { PromptLoader } from "./core/prompts";
-import type { VectorStore } from "./core/retrieval";
+import type { Retriever } from "./core/retrieval";
 export type { Logger, LogLevel } from "./core/logger";
 /**
  * USD price per 1M tokens, used to turn token usage into an estimated cost.
@@ -58,10 +58,106 @@ export interface BotChatConfig {
     /** Subtitle for private chat widget */
     privateSubtitle?: string;
 }
+/**
+ * The brain and retrieval hooks a chat surface consults, in the order a turn
+ * reaches them: `bucketsFor` scopes retrieval, `rewriteQuery` shapes the
+ * search, `rerankContext` post-processes what came back, `fallbackFn` steps
+ * in only when that leaves nothing, `answerFn` replaces the completion call
+ * itself, and `transformReply` has the last word on what gets delivered.
+ * `ChatterConfig` sets the server-wide default for each; a
+ * channel config (`TelegramChannelConfig`, `MatrixChannelConfig`,
+ * `WhatsAppInboundConfig`, ...) extends this same interface so a single
+ * channel can override any of them for its own traffic, falling back to the
+ * server-level hook when unset: see `resolveBrainHooks` in `./channels`.
+ */
+export interface BrainHooks {
+    /**
+     * 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;
+    /**
+     * Decides which knowledge buckets each chat turn may retrieve from, given
+     * the pipeline mode and — where the surface knows it — the sender's
+     * identity. Use it for role-gated knowledge: entitle a signed-in operator
+     * to buckets an anonymous visitor cannot see.
+     *
+     * Consulted by the chat routes, the OpenAI-compatible endpoints, the MCP
+     * chat tools and the demo route. Return `undefined` to keep the mode
+     * defaults (`base` plus the mode's own bucket). For a caller the surface
+     * could not identify, the answer is filtered down to those same defaults —
+     * the hook can narrow retrieval for an unnamed caller but never widen it.
+     *
+     * Unset: the mode defaults apply everywhere.
+     */
+    bucketsFor?: BucketsFor;
+    /**
+     * Rewrites the retrieval query for a turn before it reaches the vector
+     * store — e.g. expanding an ambiguous follow-up into something embeddable
+     * on its own. Receives the same `sender` identity `answerFn` sees (not the
+     * retrieval-scope-restricted one `bucketsFor` sees on the public
+     * OpenAI-compatible route — rewriting a query widens nothing, so it isn't
+     * subject to that clamp).
+     *
+     * Consulted everywhere `bucketsFor` is. A throw/rejection, or a return
+     * value that isn't a non-blank string, falls back to the unmodified query
+     * — a broken rewrite degrades relevance, never the chat path. Unset:
+     * retrieval runs on the latest user message unmodified.
+     */
+    rewriteQuery?: RewriteQuery;
+    /**
+     * Post-processes the chunks retrieval returned — reordering, filtering, or
+     * otherwise reranking — before they're folded into the system prompt.
+     *
+     * Consulted everywhere `bucketsFor` is, immediately after retrieval runs.
+     * A throw/rejection, or a return value that isn't a string array, falls
+     * back to the chunks retrieval returned, unmodified. Unset: retrieved
+     * chunks are used as-is.
+     */
+    rerankContext?: RerankContext;
+    /**
+     * Injects turn-scoped guidance when retrieval comes back with nothing to
+     * fold into the prompt, after `rerankContext`, if configured, has had its
+     * say. Receives the query, mode, buckets retrieval ran against and (via
+     * `retrievedChunks`) what `store.query` itself returned before
+     * `rerankContext` ran, so a hook can tell "the store found nothing" apart
+     * from "a reranker filtered everything out". Return a string to add it as
+     * an extra system-prompt layer for this turn only; return `undefined` to
+     * leave the prompt as-is.
+     *
+     * Consulted everywhere `bucketsFor` is. A throw/rejection is logged and
+     * the turn proceeds without fallback guidance: a broken hook must never
+     * break the chat path. Unset: an empty retrieval changes nothing about the
+     * assembled prompt, same as today.
+     */
+    fallbackFn?: FallbackFn;
+    /**
+     * Modifies or vetoes an outgoing reply after it has already been produced
+     * (by `answerFn` or the built-in completion, past guardrails). Return a
+     * string to replace the reply, or `null` to veto it — a deliberate drop,
+     * treated the same as an empty answer: nothing is delivered, and the
+     * channel pipeline never records an assistant turn for it (the user's own
+     * turn, already appended before answering, stays recorded either way). A
+     * throw/rejection is logged and the ORIGINAL reply is sent.
+     *
+     * Consulted by the channel pipeline and every non-streaming HTTP chat
+     * surface (widget and demo routes, OpenAI-compatible endpoints, MCP chat
+     * tools). Streaming responses are delivered incrementally as they're
+     * produced, before a final answer exists to transform, so this hook is
+     * never consulted for them. Unset: replies pass through unchanged.
+     */
+    transformReply?: TransformReply;
+}
 /**
  * Main configuration for Chatter server
  */
-export interface ChatterConfig {
+export interface ChatterConfig extends BrainHooks {
     bot: BotIdentity;
     branding?: BotBranding;
     chat?: BotChatConfig;
@@ -88,12 +184,30 @@ export interface ChatterConfig {
          */
         pricing?: PricingRates;
     };
-    database: {
+    /**
+     * Turso/libsql credentials for the default knowledge store. Required
+     * unless `retriever` is set - the default `VectorStore` has nowhere else
+     * to keep chunks and embeddings. A server started with neither fails fast
+     * at startup naming the missing one, rather than throwing on the first
+     * chat request.
+     */
+    database?: {
         /** Turso database URL */
         url: string;
         /** Turso auth token */
         authToken: string;
     };
+    /**
+     * Retrieval backend for `prepareChat`, replacing the default `VectorStore`
+     * (brute-force cosine similarity over embeddings in Turso). Set this to
+     * scale past the default's storage or search strategy (pgvector,
+     * sqlite-vec, Qdrant, a managed vector database) without touching any chat
+     * surface. See
+     * [patterns/adding-a-retriever.md](../docs/patterns/adding-a-retriever.md).
+     *
+     * Unset: `database` is required, and the built-in `VectorStore` is used.
+     */
+    retriever?: Retriever;
     auth?: {
         /** Secret for JWT API key creation/verification */
         secret?: string;
@@ -224,72 +338,6 @@ export interface ChatterConfig {
          */
         strictTransportSecurity?: string | false;
     };
-    /**
-     * 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;
-    /**
-     * Modifies or vetoes an outgoing reply after it has already been produced
-     * (by `answerFn` or the built-in completion, past guardrails). Return a
-     * string to replace the reply, or `null` to veto it — a deliberate drop,
-     * treated the same as an empty answer: nothing is delivered, and the
-     * channel pipeline never records an assistant turn for it (the user's own
-     * turn, already appended before answering, stays recorded either way). A
-     * throw/rejection is logged and the ORIGINAL reply is sent.
-     *
-     * Consulted by the channel pipeline and every non-streaming HTTP chat
-     * surface (widget and demo routes, OpenAI-compatible endpoints, MCP chat
-     * tools). Streaming responses are delivered incrementally as they're
-     * produced, before a final answer exists to transform, so this hook is
-     * never consulted for them. Unset: replies pass through unchanged.
-     */
-    transformReply?: TransformReply;
-    /**
-     * Decides which knowledge buckets each chat turn may retrieve from, given
-     * the pipeline mode and — where the surface knows it — the sender's
-     * identity. Use it for role-gated knowledge: entitle a signed-in operator
-     * to buckets an anonymous visitor cannot see.
-     *
-     * Consulted by the chat routes, the OpenAI-compatible endpoints, the MCP
-     * chat tools and the demo route. Return `undefined` to keep the mode
-     * defaults (`base` plus the mode's own bucket). For a caller the surface
-     * could not identify, the answer is filtered down to those same defaults —
-     * the hook can narrow retrieval for an unnamed caller but never widen it.
-     *
-     * Unset: the mode defaults apply everywhere.
-     */
-    bucketsFor?: BucketsFor;
-    /**
-     * Rewrites the retrieval query for a turn before it reaches the vector
-     * store — e.g. expanding an ambiguous follow-up into something embeddable
-     * on its own. Receives the same `sender` identity `answerFn` sees (not the
-     * retrieval-scope-restricted one `bucketsFor` sees on the public
-     * OpenAI-compatible route — rewriting a query widens nothing, so it isn't
-     * subject to that clamp).
-     *
-     * Consulted everywhere `bucketsFor` is. A throw/rejection, or a return
-     * value that isn't a non-blank string, falls back to the unmodified query
-     * — a broken rewrite degrades relevance, never the chat path. Unset:
-     * retrieval runs on the latest user message unmodified.
-     */
-    rewriteQuery?: RewriteQuery;
-    /**
-     * Post-processes the chunks retrieval returned — reordering, filtering, or
-     * otherwise reranking — before they're folded into the system prompt.
-     *
-     * Consulted everywhere `bucketsFor` is, immediately after retrieval runs.
-     * A throw/rejection, or a return value that isn't a string array, falls
-     * back to the chunks retrieval returned, unmodified. Unset: retrieved
-     * chunks are used as-is.
-     */
-    rerankContext?: RerankContext;
     /** Custom route handler for advanced use cases. May be async — see {@link CustomRoutes} */
     customRoutes?: CustomRoutes;
     /**
@@ -335,12 +383,18 @@ export type CustomRoutes = ((app: Hono, deps: ServerDependencies) => void) | ((a
 export interface ServerDependencies {
     /** OpenAI client instance */
     client: OpenAI;
-    /** Vector store instance */
-    store: VectorStore;
+    /** The retrieval backend `prepareChat` queries - the default `VectorStore`, or `config.retriever` when set. */
+    store: Retriever;
     /**
-     * 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.
+     * The libsql database client, shared with the default vector store when
+     * one was built. Custom routes should use this handle rather than opening
+     * their own connection to the same database.
+     *
+     * Only actually present when `config.database` was set - the type stays
+     * required for now (narrowing it to reflect that is deferred, tracked as a
+     * follow-up ticket), so a host that configures `config.retriever` with no
+     * `config.database` and then reads `deps.db` gets `undefined` at runtime
+     * despite the type.
      */
     db: LibsqlClient;
     /** Chatter configuration */

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.61.0",
+  "version": "0.63.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -178,6 +178,9 @@
     "@hono/node-server": {
       "optional": true
     },
+    "@libsql/client": {
+      "optional": true
+    },
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
@@ -198,14 +201,14 @@
     "@biomejs/biome": "2.5.8",
     "@commitlint/cli": "21.2.2",
     "@commitlint/config-conventional": "21.2.2",
-    "@hono/node-server": "2.1.0",
+    "@hono/node-server": "2.1.1",
     "@libsql/client": "0.17.4",
     "@modelcontextprotocol/sdk": "1.30.0",
     "@types/bun": "1.3.14",
     "@types/node": "26.2.0",
     "@whiskeysockets/baileys": "7.0.0-rc14",
     "esbuild": "0.28.2",
-    "hono": "4.13.1",
+    "hono": "4.13.2",
     "husky": "9.1.7",
     "lint-staged": "17.3.0",
     "openai": "7.4.0",