@kieksme/csp-plugin-chat 0.8.0 → 0.9.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-R6G6BYF4.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";
 
@@ -261,7 +397,7 @@ 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}` : ""
@@ -648,6 +784,7 @@ function LegacyChat(ctx) {
 var browser_default = {
   id: "chat",
   sdkVersion: cspPlugin.sdkVersion,
+  tools: chatTools,
   sections: [
     {
       id: "chat",

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

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

package/dist/server.js

@@ -1,6 +1,6 @@
 import {
   cspPlugin
-} from "./chunk-NHJR47VI.js";
+} from "./chunk-R6G6BYF4.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.9.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.9.0",
     "openai": "^6.3.0",
     "zod": "^3.25.76"
   },
@@ -35,7 +35,7 @@
   },
   "cspPlugin": {
     "id": "chat",
-    "sdkVersion": "^0.8.0",
+    "sdkVersion": "^0.9.0",
     "browser": "./browser",
     "server": "./server"
   },