@kieksme/csp-plugin-chat 0.8.0 → 0.10.0

package/README.md

@@ -23,3 +23,5 @@ Der System-Prompt begrenzt den Chat auf Support und Portalbedienung. Fachfremde
 Optional persisted conversations and real human support are available through the Teams plugin. The UI uses `chatSupport` from the public profile and identifies real support separately from the digital assistant. See [Teams support](../../docs/teams-support.md).
 
 For portals with an existing same-origin authenticated gateway, set `chatSupport.auth` to `session` to reuse the login without browser tokens. The API still requires a validated delegated access token supplied by the internal gateway. See [Teams support](../../docs/teams-support.md#vorhandene-portal-anmeldung-verwenden).
+
+WebMCP tool: `chat_ask` streams one answer from `POST /api/v1/chat` and returns text, responder and sources. It changes no data but uses the chat rate limit and provider quota, so it is not marked read-only. See [WebMCP](../../docs/webmcp.md).

package/dist/browser.d.ts

@@ -1,10 +1,12 @@
-import * as react from 'react';
+import * as _kieksme_csp_sdk from '@kieksme/csp-sdk';
 import { BrowserContext } from '@kieksme/csp-sdk';
+import * as react from 'react';
 
 declare function Chat(ctx: BrowserContext): react.JSX.Element;
 declare const _default: {
     id: string;
     sdkVersion: string;
+    tools: _kieksme_csp_sdk.WebMcpTool[];
     sections: {
         id: string;
         placement: "hero";

package/dist/browser.js

@@ -1,9 +1,13 @@
 import {
   cspPlugin
-} from "./chunk-NHJR47VI.js";
+} from "./chunk-MGUWXMOX.js";
 
-// src/browser.tsx
-import { useEffect as useEffect2, useLayoutEffect, useRef as useRef2, useState as useState2 } from "react";
+// src/tools.ts
+import {
+  UNTRUSTED_NOTE,
+  webMcpError,
+  webMcpJson
+} from "@kieksme/csp-sdk";
 
 // src/answer.ts
 import { safeUrl } from "@kieksme/csp-sdk";
@@ -33,6 +37,138 @@ function answerParts(text, sources, streaming = false) {
   });
 }
 
+// src/tools.ts
+function parseMessages(value) {
+  if (!Array.isArray(value) || value.length < 1 || value.length > 20)
+    return "messages muss 1 bis 20 Eintr\xE4ge enthalten.";
+  let total = 0;
+  const messages = [];
+  for (const item of value) {
+    const { role, content } = item ?? {};
+    if (role !== "user" && role !== "assistant" || typeof content !== "string" || content.length < 1 || content.length > 4e3)
+      return "Jede Nachricht braucht role (user|assistant) und content (1 bis 4000 Zeichen).";
+    total += content.length;
+    messages.push({ role, content });
+  }
+  if (messages.at(-1).role !== "user")
+    return "Die letzte Nachricht muss von user stammen.";
+  if (total > 16e3)
+    return "Der Verlauf darf h\xF6chstens 16000 Zeichen enthalten.";
+  return messages;
+}
+async function askChat(ctx, messages, signal) {
+  const response = await (ctx.request ?? fetch)(
+    ctx.config.apiUrl + "/api/v1/chat",
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ messages }),
+      signal
+    }
+  );
+  if (!response.ok || !response.body)
+    throw new Error(
+      response.status === 429 ? "Zu viele Anfragen. Bitte eine Minute warten." : "Chat derzeit nicht erreichbar."
+    );
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let answer = "";
+  let complete = false;
+  let responder;
+  let sources = [];
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      buffer += decoder.decode(value, { stream: !done });
+      let boundary;
+      while ((boundary = buffer.indexOf("\n\n")) >= 0) {
+        const block = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        const type = block.match(/^event: (.+)$/m)?.[1];
+        const payload = block.match(/^data: (.+)$/m)?.[1];
+        if (!payload) continue;
+        const event = JSON.parse(payload);
+        if (type === "delta") answer += event.text;
+        if (type === "responder") responder = event;
+        if (type === "sources") sources = event;
+        if (type === "error") throw new Error(event.message);
+        if (type === "done") complete = true;
+      }
+      if (done) break;
+    }
+  } finally {
+    await reader.cancel().catch(() => void 0);
+    reader.releaseLock();
+  }
+  if (!complete)
+    throw new Error(
+      "Die Verbindung wurde unterbrochen. Antwort unvollst\xE4ndig."
+    );
+  return { answer, responder, sources };
+}
+var chatTools = [
+  {
+    name: "chat_ask",
+    description: "Fragt den digitalen Assistenten des Portals (kennt Hilfe-Inhalte, Team, Schichten und Status). Verbraucht Chat-Kontingent (Rate-Limit pro IP) und ruft einen KI-Anbieter auf; nur nutzen, wenn die anderen Tools nicht reichen. \xC4ndert keine Daten. Die letzte Nachricht muss von user stammen.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        messages: {
+          type: "array",
+          minItems: 1,
+          maxItems: 20,
+          items: {
+            type: "object",
+            properties: {
+              role: { type: "string", enum: ["user", "assistant"] },
+              content: { type: "string", minLength: 1, maxLength: 4e3 }
+            },
+            required: ["role", "content"],
+            additionalProperties: false
+          }
+        }
+      },
+      required: ["messages"],
+      additionalProperties: false
+    },
+    annotations: { readOnlyHint: false },
+    execute: async (args, ctx) => {
+      if (ctx.config.chatSupport)
+        return webMcpError(
+          "Der Chat l\xE4uft im Supportmodus mit Anmeldung und ist per Tool nicht verf\xFCgbar. Bitte die Hotline nutzen."
+        );
+      const messages = parseMessages(args.messages);
+      if (typeof messages === "string") return webMcpError(messages);
+      try {
+        const { answer, responder, sources } = await askChat(
+          ctx,
+          messages,
+          AbortSignal.timeout(9e4)
+        );
+        return webMcpJson({
+          notice: UNTRUSTED_NOTE,
+          responder: responder?.role === "on-duty" ? responder.name : "Service-Team",
+          answer,
+          sources: sources.map((s) => ({
+            id: s.id,
+            title: s.title,
+            href: sourceHref(s.href),
+            stale: s.stale ?? false
+          }))
+        });
+      } catch (error) {
+        return webMcpError(
+          error instanceof Error ? error.message : "Chat nicht verf\xFCgbar."
+        );
+      }
+    }
+  }
+];
+
+// src/browser.tsx
+import { useEffect as useEffect2, useLayoutEffect, useRef as useRef2, useState as useState2 } from "react";
+
 // src/support-chat.tsx
 import { useEffect, useRef, useState } from "react";
 
@@ -46,6 +182,7 @@ async function supportSession(ctx) {
       },
       name: "Portal-Nutzer Demo"
     };
+  if (c.auth === "anonymous") return anonymousSession(ctx);
   if (c.auth === "session") return cookieSession(ctx);
   const { PublicClientApplication } = await import("@azure/msal-browser");
   const client = new PublicClientApplication({
@@ -98,12 +235,74 @@ function cookieSession(ctx) {
   };
   return current;
 }
+function anonymousSession(ctx) {
+  const key = `csp-support:${ctx.config.apiUrl}`;
+  let saved;
+  try {
+    const value = JSON.parse(window.sessionStorage.getItem(key) ?? "null");
+    if (typeof value?.token === "string" && typeof value?.expiresAt === "number" && value.expiresAt > Date.now() && typeof value?.name === "string")
+      saved = value;
+  } catch {
+  }
+  let pending;
+  const current = {
+    name: saved?.name ?? "Besucher",
+    async token() {
+      if (saved) {
+        if (saved.expiresAt <= Date.now())
+          throw new Error(
+            "Chat-Sitzung abgelaufen. Bitte verbinden Sie den Chat neu."
+          );
+        return saved.token;
+      }
+      if (pending) return pending;
+      pending = (async () => {
+        const response = await (ctx.request ?? fetch)(
+          ctx.config.apiUrl + "/api/v1/conversations/session",
+          {
+            method: "POST",
+            credentials: "omit",
+            cache: "no-store"
+          }
+        );
+        if (!response.ok)
+          throw new Error(
+            "Chat derzeit nicht verf\xFCgbar. Bitte versuchen Sie es sp\xE4ter erneut."
+          );
+        const value = await response.json();
+        if (typeof value.token !== "string" || typeof value.expiresAt !== "number" || value.expiresAt <= Date.now() || typeof value.name !== "string")
+          throw new Error("Chat derzeit nicht verf\xFCgbar.");
+        saved = value;
+        current.name = value.name;
+        try {
+          window.sessionStorage.setItem(key, JSON.stringify(value));
+        } catch {
+        }
+        return value.token;
+      })();
+      try {
+        return await pending;
+      } finally {
+        pending = void 0;
+      }
+    },
+    async login() {
+      try {
+        window.sessionStorage.removeItem(key);
+      } catch {
+      }
+      window.location.reload();
+    }
+  };
+  return current;
+}
 
 // src/support-chat.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 function SupportChat(ctx) {
   const [current, setCurrent] = useState(null), [input, setInput] = useState(""), [error, setError] = useState(""), [busy, setBusy] = useState(false), [ready, setReady] = useState(false), [auth, setAuth] = useState(null);
   const seq = useRef(0), requestRef = useRef(null);
+  const anonymous = ctx.config.chatSupport?.auth === "anonymous";
   const demo = ctx.config.chatSupport?.mode === "demo";
   useEffect(() => {
     let alive = true;
@@ -261,10 +460,10 @@ function SupportChat(ctx) {
     }
   }
   return /* @__PURE__ */ jsxs("div", { className: "chat-panel support-chat text-ink bg-card border border-line p-6 rounded-card compact:p-4", children: [
-    /* @__PURE__ */ jsx("p", { className: "text-[0.75rem] text-ink mb-3", children: demo ? "Synthetische Support-Demo. Keine \xDCbertragung an Teams." : "Ihre Nachrichten und die Antworten werden an den Thinkport-Support in Microsoft Teams weitergegeben." }),
+    /* @__PURE__ */ jsx("p", { className: "text-[0.75rem] text-ink mb-3", children: demo ? "Synthetische Support-Demo. Keine \xDCbertragung an einen Support-Channel." : `Ihre Nachrichten und die Antworten werden an den Support in ${ctx.config.chatSupport?.mode === "slack" ? "Slack" : "Microsoft Teams"} weitergegeben.` }),
     /* @__PURE__ */ jsxs("p", { role: "status", className: "text-[0.8125rem] mb-3", children: [
       current?.status === "support" ? `${current.support?.name} \xB7 Support` : current?.status === "closed" ? "Gespr\xE4ch abgeschlossen" : "Digitaler Assistent",
-      auth && ready && !demo ? ` \xB7 Angemeldet als ${auth.name}` : ""
+      auth && ready && !demo ? anonymous ? ` \xB7 ${auth.name}` : ` \xB7 Angemeldet als ${auth.name}` : ""
     ] }),
     /* @__PURE__ */ jsx(
       "div",
@@ -305,9 +504,11 @@ function SupportChat(ctx) {
         className: "bg-accent text-accent-ink rounded-card px-4 py-2",
         disabled: !auth,
         onClick: () => void auth?.login().catch(
-          () => setError("Microsoft-Anmeldung konnte nicht gestartet werden.")
+          () => setError(
+            anonymous ? "Chat konnte nicht neu verbunden werden." : "Microsoft-Anmeldung konnte nicht gestartet werden."
+          )
         ),
-        children: ctx.config.chatSupport?.auth === "session" ? "Portal-Anmeldung erneuern" : "Mit Microsoft anmelden"
+        children: anonymous ? "Chat neu verbinden" : ctx.config.chatSupport?.auth === "session" ? "Portal-Anmeldung erneuern" : "Mit Microsoft anmelden"
       }
     ),
     ready && /* @__PURE__ */ jsxs("form", { onSubmit: submit, className: "chat-form flex gap-2.5 items-end", children: [
@@ -394,9 +595,11 @@ function SupportChat(ctx) {
         type: "button",
         className: "underline mt-3",
         onClick: () => void auth.login().catch(
-          () => setError("Microsoft-Anmeldung konnte nicht gestartet werden.")
+          () => setError(
+            anonymous ? "Chat konnte nicht neu verbunden werden." : "Microsoft-Anmeldung konnte nicht gestartet werden."
+          )
         ),
-        children: ctx.config.chatSupport?.auth === "session" ? "Portal-Anmeldung erneuern" : "Microsoft-Anmeldung erneuern"
+        children: anonymous ? "Chat neu verbinden" : ctx.config.chatSupport?.auth === "session" ? "Portal-Anmeldung erneuern" : "Microsoft-Anmeldung erneuern"
       }
     ),
     error && /* @__PURE__ */ jsx("p", { role: "alert", className: "text-danger text-[0.75rem] mt-3", children: error })
@@ -648,6 +851,7 @@ function LegacyChat(ctx) {
 var browser_default = {
   id: "chat",
   sdkVersion: cspPlugin.sdkVersion,
+  tools: chatTools,
   sections: [
     {
       id: "chat",

package/dist/{chunk-NHJR47VI.js → chunk-MGUWXMOX.js}

@@ -1,7 +1,7 @@
 // package.json
 var cspPlugin = {
   id: "chat",
-  sdkVersion: "^0.8.0",
+  sdkVersion: "^0.10.0",
   browser: "./browser",
   server: "./server"
 };

package/dist/server.js

@@ -1,6 +1,6 @@
 import {
   cspPlugin
-} from "./chunk-NHJR47VI.js";
+} from "./chunk-MGUWXMOX.js";
 
 // src/server.ts
 import { z as z2 } from "zod";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kieksme/csp-plugin-chat",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "type": "module",
   "license": "MIT",
   "files": [
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "@azure/msal-browser": "^5.25.0",
-    "@kieksme/csp-sdk": "^0.8.0",
+    "@kieksme/csp-sdk": "^0.10.0",
     "openai": "^6.3.0",
     "zod": "^3.25.76"
   },
@@ -35,7 +35,7 @@
   },
   "cspPlugin": {
     "id": "chat",
-    "sdkVersion": "^0.8.0",
+    "sdkVersion": "^0.10.0",
     "browser": "./browser",
     "server": "./server"
   },