@kieksme/csp-plugin-chat 0.7.0 → 0.9.0

package/README.md

@@ -21,3 +21,7 @@ Der Assistent unterscheidet das Unternehmen von seinem Serviceportal: „Service
 Der System-Prompt begrenzt den Chat auf Support und Portalbedienung. Fachfremde Aufgaben werden kurz zum Support-Zweck zurückgeführt; unklare Anliegen werden durch eine Rückfrage eingeordnet.
 
 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-ALGUQ3T5.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,10 +37,143 @@ 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";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-async function session(ctx) {
+
+// src/support-session.ts
+async function supportSession(ctx) {
   const c = ctx.config.chatSupport;
   if (c.mode === "demo")
     return {
@@ -45,6 +182,7 @@ async function session(ctx) {
       },
       name: "Portal-Nutzer Demo"
     };
+  if (c.auth === "session") return cookieSession(ctx);
   const { PublicClientApplication } = await import("@azure/msal-browser");
   const client = new PublicClientApplication({
     auth: {
@@ -68,6 +206,37 @@ async function session(ctx) {
     }
   };
 }
+function cookieSession(ctx) {
+  let loaded = false;
+  const current = {
+    name: "Portal-Nutzer",
+    async token() {
+      if (!loaded) {
+        const response = await (ctx.request ?? fetch)(
+          ctx.config.apiUrl + "/api/v1/conversations/identity",
+          { credentials: "same-origin", cache: "no-store" }
+        );
+        if (!response.ok)
+          throw new Error(
+            response.status === 401 ? "Bitte erneuern Sie Ihre Portal-Anmeldung." : "Portal-Anmeldung derzeit nicht verf\xFCgbar."
+          );
+        const identity = await response.json();
+        if (typeof identity.name !== "string" || !identity.name.trim() || identity.name.length > 200)
+          throw new Error("Portal-Anmeldung derzeit nicht verf\xFCgbar.");
+        current.name = identity.name;
+        loaded = true;
+      }
+      return "";
+    },
+    async login() {
+      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);
@@ -77,7 +246,7 @@ function SupportChat(ctx) {
     const controller = new AbortController();
     async function init() {
       try {
-        const identity = await session(ctx);
+        const identity = await supportSession(ctx);
         if (!alive) return;
         setAuth(identity);
         const request = async (path, init2 = {}) => {
@@ -86,6 +255,7 @@ function SupportChat(ctx) {
             ctx.config.apiUrl + "/api/v1/conversations" + path,
             {
               ...init2,
+              credentials: "same-origin",
               headers: {
                 ...token ? { Authorization: `Bearer ${token}` } : {},
                 ...init2.body !== void 0 ? { "Content-Type": "application/json" } : {},
@@ -227,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}` : ""
@@ -273,7 +443,7 @@ function SupportChat(ctx) {
         onClick: () => void auth?.login().catch(
           () => setError("Microsoft-Anmeldung konnte nicht gestartet werden.")
         ),
-        children: "Mit Microsoft anmelden"
+        children: 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: [
@@ -362,7 +532,7 @@ function SupportChat(ctx) {
         onClick: () => void auth.login().catch(
           () => setError("Microsoft-Anmeldung konnte nicht gestartet werden.")
         ),
-        children: "Microsoft-Anmeldung erneuern"
+        children: 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 })
@@ -614,6 +784,7 @@ function LegacyChat(ctx) {
 var browser_default = {
   id: "chat",
   sdkVersion: cspPlugin.sdkVersion,
+  tools: chatTools,
   sections: [
     {
       id: "chat",

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

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

package/dist/server.js

@@ -1,6 +1,6 @@
 import {
   cspPlugin
-} from "./chunk-ALGUQ3T5.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.7.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.7.0",
+    "@kieksme/csp-sdk": "^0.9.0",
     "openai": "^6.3.0",
     "zod": "^3.25.76"
   },
@@ -35,7 +35,7 @@
   },
   "cspPlugin": {
     "id": "chat",
-    "sdkVersion": "^0.7.0",
+    "sdkVersion": "^0.9.0",
     "browser": "./browser",
     "server": "./server"
   },