@sahan-sac/chat-kit 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @sahan-sac/chat-kit
 
+## 0.3.0
+
+### Minor Changes
+
+- f465908: Owner guidance and per-post steering. `BlogSiteProfile.guidance` and `ChatSite.guidance` add the site owner's standing guidance to every blog, SEO, helper and chatbot prompt, after the fixed rules. `BlogGenerationInput` takes optional `instructions` (up to `MAX_INSTRUCTIONS_LENGTH`, 2,000 characters) and `resources` (pasted reference text, up to `MAX_RESOURCES_LENGTH`, 12,000), both fenced as untrusted data: resources are used as facts, never as instructions, and nothing is fetched from a link.
+
+### Patch Changes
+
+- Updated dependencies [b9d2dd6]
+- Updated dependencies [4fa21e3]
+- Updated dependencies [f465908]
+  - @sahan-sac/ai-core@0.3.0
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -35,7 +35,9 @@ Only `handler` imports `server-only`. The other subpaths are pure, and `session-
 Uses `@sahan-sac/ai-core`'s variables; see its README for the full table. The chatbot runs only when `chatbotEnabled(env)` from `@sahan-sac/ai-core/availability` is true:
 
 - `ENABLE_CHATBOT` is on. It defaults to `true`; `false`, `0`, `no` or `off` turns it off.
-- At least one text provider key is set.
+- At least one provider can answer chat: its key is set, it is in `AI_PROVIDER_ORDER_CHAT` (or `AI_PROVIDER_ORDER`) when one is set, and a paid one also has `AI_ALLOW_PAID=true`.
+
+The chat chain falls through providers on any failure (quota, timeout, bad key, bad output), so one provider's outage does not stop the chatbot. Set `AI_PROVIDER_ORDER_CHAT` to choose which providers answer and in what order; see `@sahan-sac/ai-core`'s README.
 
 When the chatbot is off, return 503 from the route and do not render the widget.
 
@@ -51,7 +53,7 @@ const result = await runChat(
     history: await store.getRecentMessages(sessionId, 10),
     knowledge: await getKnowledge(), // cached by the app
     config: { tone: "professional" },
-    site: chatSite,
+    site: { ...chatSite, guidance: ownerGuidance }, // optional: added after the fixed rules
     siteHostname: new URL(env.SITE_URL).hostname,
     extraHosts: ["wa.me", "t.me"],
   },

package/dist/handler.js

@@ -66,6 +66,7 @@ function knowledgeHosts(knowledge) {
 }
 
 // src/prompts.ts
+import { guidanceSection } from "@sahan-sac/ai-core/guard";
 function toneDescription(tone, site) {
   const kind = site.kind ?? "site";
   switch (tone) {
@@ -134,7 +135,9 @@ Use markdown formatting for readability:`,
     `
 - Use inline links like ${linkExample}.`,
     `
-- Structure responses with short paragraphs, not walls of text.`
+- Structure responses with short paragraphs, not walls of text.`,
+    // The owner's standing guidance (AI context settings): after the fixed rules, which it cannot override.
+    guidanceSection(site.guidance)
   ];
   if (knowledge) {
     systemParts.push("\n\n<<<BEGIN_REFERENCE_DATA>>>\n");

package/dist/prompts.js

@@ -1,3 +1,6 @@
+// src/prompts.ts
+import { guidanceSection } from "@sahan-sac/ai-core/guard";
+
 // src/guard.ts
 import { wrapUserData, looksLikeLeak } from "@sahan-sac/ai-core/guard";
 function guardUserMessage(message) {
@@ -73,7 +76,9 @@ Use markdown formatting for readability:`,
     `
 - Use inline links like ${linkExample}.`,
     `
-- Structure responses with short paragraphs, not walls of text.`
+- Structure responses with short paragraphs, not walls of text.`,
+    // The owner's standing guidance (AI context settings): after the fixed rules, which it cannot override.
+    guidanceSection(site.guidance)
   ];
   if (knowledge) {
     systemParts.push("\n\n<<<BEGIN_REFERENCE_DATA>>>\n");

package/dist/types.d.ts

@@ -26,6 +26,8 @@ interface ChatSite {
     scope?: string;
     /** How the assistant should format a site link, e.g. "[Project Name](/works) when referencing portfolio content". */
     linkExample?: string;
+    /** Standing guidance from the owner (voice, facts, do and don't), appended after the fixed rules. Empty adds nothing. */
+    guidance?: string;
 }
 /** One earlier turn of the conversation, oldest first. */
 interface ChatTurn {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sahan-sac/chat-kit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Headless chatbot core for the portfolio site: guarded prompt building, prompt-injection and output-link guards, an anonymous-visitor rate-limit cookie, a knowledge-base builder that tolerates a failing source, and runChat, the pure request/response path behind /api/chat. Depends on @sahan-sac/ai-core; never on @sahan-sac/blog-kit or @sahan-sac/media-kit.",
   "license": "Apache-2.0",
   "repository": {
@@ -61,7 +61,7 @@
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
   "dependencies": {
-    "@sahan-sac/ai-core": "^0.2.0",
+    "@sahan-sac/ai-core": "^0.3.0",
     "server-only": "^0.0.1"
   },
   "devDependencies": {