@diegoaltoworks/chatter 0.20.0 → 0.21.0

package/dist/core/pipeline.d.ts

@@ -14,7 +14,7 @@ export interface PipelineMessage {
     content: string;
 }
 export interface PreparedChat {
-    /** Fully assembled system prompt (rules + persona + retrieved context) */
+    /** Fully assembled system prompt (see `prepareChat` for the layer order) */
     system: string;
     /** Conversation messages, unchanged */
     messages: PipelineMessage[];
@@ -22,12 +22,24 @@ export interface PreparedChat {
 /**
  * Run retrieval for the latest user message and assemble the system prompt.
  *
+ * The assembled system prompt is layered, in order:
+ * base rules → persona → channel hint (optional) → retrieved context.
+ *
+ * `personaLayer` and `channelHint` let a caller shape those middle layers
+ * without hand-rolling its own sandwich around `store`/`prompts`. Both are
+ * optional, and blank (or whitespace-only) values are ignored: omit them and
+ * the prompt is exactly what it has always been.
+ *
  * @throws if the conversation contains no user message
  */
-export declare function prepareChat({ store, prompts, mode, messages, }: {
+export declare function prepareChat({ store, prompts, mode, messages, personaLayer, channelHint, }: {
     store: VectorStore;
     prompts: PromptLoader;
     mode: PipelineMode;
     messages: PipelineMessage[];
+    /** Replaces the mode's persona from the loader when provided */
+    personaLayer?: string;
+    /** Extra system-prompt section describing the delivery channel */
+    channelHint?: string;
 }): Promise<PreparedChat>;
 //# sourceMappingURL=pipeline.d.ts.map

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,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAOD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,EAChC,KAAK,EACL,OAAO,EACP,IAAI,EACJ,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,GAAG,OAAO,CAAC,YAAY,CAAC,CAYxB"}
+{"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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Chat pipeline tests
+ *
+ * Uses faked prompts and vector store so prompt assembly can be asserted
+ * without touching OpenAI or Turso.
+ */
+export {};
+//# sourceMappingURL=pipeline.test.d.ts.map

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

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

package/dist/index.js

@@ -7768,7 +7768,9 @@ async function prepareChat({
   store,
   prompts,
   mode,
-  messages
+  messages,
+  personaLayer,
+  channelHint
 }) {
   const lastUserMsg = [...messages].reverse().find((m) => m.role === "user");
   if (!lastUserMsg) {
@@ -7776,9 +7778,15 @@ async function prepareChat({
   }
   const { topK, label } = MODE_SETTINGS[mode];
   const ctx = await store.query(lastUserMsg.content, topK, ["base", mode]);
-  const persona = mode === "private" ? prompts.privatePersona : prompts.publicPersona;
-  const system = [prompts.baseSystemRules, persona, `${label}:
-${ctx.join("\n\n")}`].join("\n\n");
+  const persona = personaLayer?.trim() || (mode === "private" ? prompts.privatePersona : prompts.publicPersona);
+  const hint = channelHint?.trim();
+  const system = [
+    prompts.baseSystemRules,
+    persona,
+    ...hint ? [hint] : [],
+    `${label}:
+${ctx.join("\n\n")}`
+  ].join("\n\n");
   return { system, messages };
 }
 

package/dist/index.mjs

@@ -7737,7 +7737,9 @@ async function prepareChat({
   store,
   prompts,
   mode,
-  messages
+  messages,
+  personaLayer,
+  channelHint
 }) {
   const lastUserMsg = [...messages].reverse().find((m) => m.role === "user");
   if (!lastUserMsg) {
@@ -7745,9 +7747,15 @@ async function prepareChat({
   }
   const { topK, label } = MODE_SETTINGS[mode];
   const ctx = await store.query(lastUserMsg.content, topK, ["base", mode]);
-  const persona = mode === "private" ? prompts.privatePersona : prompts.publicPersona;
-  const system = [prompts.baseSystemRules, persona, `${label}:
-${ctx.join("\n\n")}`].join("\n\n");
+  const persona = personaLayer?.trim() || (mode === "private" ? prompts.privatePersona : prompts.publicPersona);
+  const hint = channelHint?.trim();
+  const system = [
+    prompts.baseSystemRules,
+    persona,
+    ...hint ? [hint] : [],
+    `${label}:
+${ctx.join("\n\n")}`
+  ].join("\n\n");
   return { system, messages };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -94,19 +94,19 @@
     "zod": "^3.25.76 || ^4.4.3"
   },
   "dependencies": {
-    "jose": "6.2.3"
+    "jose": "6.2.8"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.6",
+    "@biomejs/biome": "2.5.7",
     "@libsql/client": "0.17.4",
     "@modelcontextprotocol/sdk": "1.30.0",
     "@types/bun": "1.3.14",
-    "@types/node": "26.1.2",
+    "@types/node": "26.2.0",
     "esbuild": "0.28.1",
-    "hono": "4.12.34",
+    "hono": "4.13.1",
     "husky": "9.1.7",
     "lint-staged": "17.3.0",
-    "openai": "7.3.0",
+    "openai": "7.4.0",
     "typescript": "7.0.2",
     "zod": "4.4.3"
   },