@bendyline/docblocks-react 2.7.5 → 2.7.7

package/dist/chunk-6QHZNL6C.js

@@ -0,0 +1,208 @@
+import {
+  KnowledgeIcon,
+  SourcedFactsIcon,
+  UnsourcedFactsIcon
+} from "./chunk-KHQ44ZFA.js";
+
+// src/Ai/AiKnowledgeIndicator.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var QUIET_NOTES = {
+  none: "Your knowledge catalogs were searched, and nothing in them matched this request.",
+  skipped: "Your knowledge catalogs could not be searched for this request. A long document can leave no room for reference passages."
+};
+function AiKnowledgeIndicator({ knowledge }) {
+  if (!knowledge) return null;
+  if (knowledge.outcome !== "used") {
+    return /* @__PURE__ */ jsxs("details", { className: "db-ai-knowledge db-ai-knowledge--quiet", children: [
+      /* @__PURE__ */ jsxs("summary", { children: [
+        /* @__PURE__ */ jsx(KnowledgeIcon, {}),
+        knowledge.outcome === "none" ? "No matching knowledge" : "Knowledge not searched"
+      ] }),
+      /* @__PURE__ */ jsx("p", { children: QUIET_NOTES[knowledge.outcome] })
+    ] });
+  }
+  const several = knowledge.sources.length > 1;
+  const count = knowledge.sources.reduce((sum, source) => sum + source.titles.length, 0);
+  return /* @__PURE__ */ jsxs("details", { className: "db-ai-knowledge db-ai-knowledge--used", children: [
+    /* @__PURE__ */ jsxs("summary", { children: [
+      /* @__PURE__ */ jsx(KnowledgeIcon, {}),
+      /* @__PURE__ */ jsxs("span", { className: "db-ai-knowledge-names", children: [
+        "Knowledge: ",
+        knowledge.sources.map((source) => source.name).join(", ")
+      ] }),
+      count > 0 && /* @__PURE__ */ jsxs("span", { className: "db-ai-knowledge-count", children: [
+        " ",
+        "\xB7 ",
+        count,
+        " ",
+        count === 1 ? "article" : "articles"
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("p", { children: "Passages from these articles were given to the model as reference material:" }),
+    knowledge.sources.map((source) => /* @__PURE__ */ jsxs("div", { className: "db-ai-knowledge-source", children: [
+      several && /* @__PURE__ */ jsx("p", { className: "db-ai-knowledge-catalog", children: source.name }),
+      /* @__PURE__ */ jsx("ul", { children: source.titles.map((title) => /* @__PURE__ */ jsx("li", { children: title }, title)) })
+    ] }, source.catalogId))
+  ] });
+}
+function markDetails(text, details) {
+  const terms = details.map((detail) => detail.replace(/ next to .+$/u, "")).filter(Boolean).map((detail) => detail.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")).sort((a, b) => b.length - a.length);
+  if (terms.length === 0) return [text];
+  const pattern = new RegExp(
+    `(?<![\\p{L}\\p{N}])(${terms.join("|")})(?=(?:st|nd|rd|th)?(?![\\p{L}\\p{N}]))`,
+    "giu"
+  );
+  return text.split(pattern).map((part, index) => index % 2 === 1 ? /* @__PURE__ */ jsx("mark", { children: part }, index) : part);
+}
+function AiFactsIndicator({ check }) {
+  if (!check || check.checked === 0) return null;
+  if (check.unsourced.length === 0) {
+    return /* @__PURE__ */ jsxs("details", { className: "db-ai-knowledge db-ai-knowledge--quiet db-ai-facts--sourced", children: [
+      /* @__PURE__ */ jsxs("summary", { children: [
+        /* @__PURE__ */ jsx(SourcedFactsIcon, {}),
+        "Details found in sources"
+      ] }),
+      /* @__PURE__ */ jsx("p", { children: "Every name, date, number and quotation in the draft appears in your document, your instructions or the reference passages. The check cannot tell whether a source is right." })
+    ] });
+  }
+  const count = check.unsourced.length;
+  return /* @__PURE__ */ jsxs("details", { className: "db-ai-knowledge db-ai-facts", children: [
+    /* @__PURE__ */ jsxs("summary", { children: [
+      /* @__PURE__ */ jsx(UnsourcedFactsIcon, {}),
+      count,
+      " ",
+      count === 1 ? "statement" : "statements",
+      " to check"
+    ] }),
+    /* @__PURE__ */ jsx("p", { children: "Neither your document, your instructions nor the reference passages show the marked details. The model may have written them from memory." }),
+    /* @__PURE__ */ jsx("ul", { children: check.unsourced.map((sentence, index) => /* @__PURE__ */ jsx("li", { children: sentence.problem === "bad-citation" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      sentence.text,
+      " ",
+      /* @__PURE__ */ jsxs("span", { className: "db-ai-facts-note", children: [
+        "It cites ",
+        sentence.missing.join(", "),
+        ", which is not one of the reference passages."
+      ] })
+    ] }) : markDetails(sentence.text, sentence.missing) }, index)) })
+  ] });
+}
+
+// src/Ai/ai-knowledge.ts
+import { useEffect, useMemo, useRef, useState } from "react";
+import { AI_WIRE_LIMITS } from "@bendyline/docblocks/host";
+function mergeAiKnowledge(current, next) {
+  if (!current) return next;
+  if (current.outcome !== "used" || next.outcome !== "used") {
+    if (current.outcome === "used") return current;
+    if (next.outcome === "used") return next;
+    return current.outcome === "none" ? current : next;
+  }
+  const sources = current.sources.map((source) => ({ ...source, titles: [...source.titles] }));
+  for (const source of next.sources) {
+    const existing = sources.find((entry) => entry.catalogId === source.catalogId);
+    if (!existing) {
+      sources.push({ ...source, titles: [...source.titles] });
+      continue;
+    }
+    for (const title of source.titles) {
+      if (!existing.titles.includes(title)) existing.titles.push(title);
+    }
+  }
+  const evidence = [...current.evidence];
+  for (const passage of next.evidence) {
+    if (!evidence.some((known) => known.text === passage.text)) evidence.push(passage);
+  }
+  return { outcome: "used", sources, evidence };
+}
+function sameEvidence(a, b) {
+  return a.length === b.length && a.every((passage, index) => passage.text === b[index]?.text);
+}
+function numberingHolds(current, next) {
+  return current?.outcome !== "used" || next.outcome !== "used" || sameEvidence(current.evidence, next.evidence);
+}
+function useAiKnowledge(ai) {
+  const [run, setRun] = useState({
+    knowledge: null,
+    citable: true
+  });
+  const runRef = useRef(0);
+  const helpers = useMemo(() => {
+    const tapped = {
+      chat(request, onEvent) {
+        const started = runRef.current;
+        return ai.chat(request, (event) => {
+          if (event.kind === "knowledge" && started === runRef.current) {
+            setRun((current) => ({
+              knowledge: mergeAiKnowledge(current.knowledge, event.knowledge),
+              citable: current.citable && numberingHolds(current.knowledge, event.knowledge)
+            }));
+          }
+          onEvent(event);
+        });
+      }
+    };
+    const reset = () => {
+      runRef.current += 1;
+      setRun({ knowledge: null, citable: true });
+    };
+    return { ai: tapped, reset };
+  }, [ai]);
+  return { knowledge: run.knowledge, citable: run.citable, ...helpers };
+}
+function factCheckRequest(text, knowledge, given, citable) {
+  if (text.length > AI_WIRE_LIMITS.factCheckTextCharacters) return null;
+  const evidence = [];
+  let total = 0;
+  for (const passage of knowledge?.outcome === "used" ? knowledge.evidence : []) {
+    total += passage.text.length;
+    if (evidence.length >= AI_WIRE_LIMITS.factCheckEvidence || total > AI_WIRE_LIMITS.factCheckEvidenceCharacters) {
+      break;
+    }
+    evidence.push(passage.text);
+  }
+  return {
+    text,
+    evidence,
+    given: given.slice(0, AI_WIRE_LIMITS.factCheckGivenCharacters),
+    // Passages were numbered for citing only when there were passages.
+    citations: citable && evidence.length > 0
+  };
+}
+function factsNeedReview(check) {
+  return check.unsourced.some((sentence) => sentence.strong) || check.unsourced.length >= 3;
+}
+function useFactCheck(ai, text, knowledge, given, citable) {
+  const [result, setResult] = useState(null);
+  useEffect(() => {
+    const request = text?.trim() && ai.checkFacts ? factCheckRequest(text, knowledge, given, citable) : null;
+    if (!request) {
+      setResult(null);
+      return;
+    }
+    let live = true;
+    const timer = setTimeout(() => {
+      ai.checkFacts?.(request).then(
+        (checked) => {
+          if (live) setResult(checked.ok ? checked.value : null);
+        },
+        () => {
+          if (live) setResult(null);
+        }
+      );
+    }, 400);
+    return () => {
+      live = false;
+      clearTimeout(timer);
+    };
+  }, [ai, text, knowledge, given, citable]);
+  return result;
+}
+
+export {
+  AiKnowledgeIndicator,
+  AiFactsIndicator,
+  useAiKnowledge,
+  factCheckRequest,
+  factsNeedReview,
+  useFactCheck
+};