@icen.ai/ui 0.8.0 → 0.9.0

package/dist/behaviors/kb-core.mjs

@@ -0,0 +1,890 @@
+// src/behaviors/ai-core.ts
+var svg = (body) => `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${body}</svg>`;
+var ICON_TERMINAL = svg('<path d="m4 17 6-6-6-6"/><path d="M12 19h8"/>');
+var ICON_FILE = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>'
+);
+var ICON_FILE_PEN = svg(
+  '<path d="M12.5 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8l5 5v3.5"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M19 6.5 16.5 4"/><path d="M21.378 16.626a1 1 0 0 0-3.004-3.004l-4.01 4.012a2 2 0 0 0-.506.854l-.837 2.87a.5.5 0 0 0 .62.62l2.87-.837a2 2 0 0 0 .854-.506z"/>'
+);
+var ICON_FILE_PLUS = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M9 15h6"/><path d="M12 12v6"/>'
+);
+var ICON_TRASH = svg(
+  '<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>'
+);
+var ICON_SEARCH = svg('<circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/>');
+var ICON_FOLDER_SEARCH = svg(
+  '<path d="M11 20H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h3.9a2 2 0 0 1 1.69.9l.81 1.2a2 2 0 0 0 1.67.9H20a2 2 0 0 1 2 2v4"/><circle cx="17" cy="17" r="3"/><path d="m21 21-1.9-1.9"/>'
+);
+var ICON_SCAN_SEARCH = svg(
+  '<path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/>'
+);
+var ICON_GLOBE = svg(
+  '<circle cx="12" cy="12" r="10"/><path d="M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"/><path d="M2 12h20"/>'
+);
+var ICON_DOWNLOAD = svg(
+  '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>'
+);
+var ICON_BLOCKS = svg(
+  '<rect width="7" height="7" x="4" y="4" rx="1"/><rect width="7" height="7" x="13" y="4" rx="1"/><rect width="7" height="7" x="4" y="13" rx="1"/><rect width="7" height="7" x="13" y="13" rx="1"/>'
+);
+var ICON_ZAP = svg(
+  '<path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/>'
+);
+var ICON_LIST = svg(
+  '<path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/>'
+);
+var ICON_LIST_CHECKS = svg(
+  '<path d="m3 17 2 2 4-4"/><path d="m3 7 2 2 4-4"/><path d="M13 6h8"/><path d="M13 12h8"/><path d="M13 18h8"/>'
+);
+var ICON_BOT = svg(
+  '<path d="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/>'
+);
+var ICON_CHART = svg(
+  '<path d="M3 3v18h18"/><path d="M7 15l4-6 3 4 5-8"/>'
+);
+var ICON_FILE_TEXT = svg(
+  '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/>'
+);
+function isObj(v) {
+  return typeof v === "object" && v !== null;
+}
+function pickStr(input, keys) {
+  if (!isObj(input)) return void 0;
+  for (const k of keys) {
+    const v = input[k];
+    if (typeof v === "string" && v) return v;
+  }
+  return void 0;
+}
+function pickNum(src, keys) {
+  if (!isObj(src)) return void 0;
+  for (const k of keys) {
+    const v = src[k];
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+  }
+  return void 0;
+}
+function firstLine(s, max = 80) {
+  const line = s.split("\n", 1)[0]?.trim() ?? "";
+  return line.length > max ? `${line.slice(0, max)}\u2026` : line;
+}
+function filePathOf(input) {
+  return pickStr(input, ["file_path", "path", "file", "filename"]);
+}
+var summarizePath = (input) => filePathOf(input);
+function summarizeRead(input) {
+  const p = filePathOf(input);
+  if (!p) return void 0;
+  const offset = pickNum(input, ["offset", "start_line"]);
+  if (offset == null) return p;
+  const limit = pickNum(input, ["limit", "end_line"]);
+  return limit != null ? `${p}:${offset}-${offset + limit}` : `${p}:${offset}`;
+}
+function summarizeShell(input) {
+  const cmd = typeof input === "string" ? input : pickStr(input, ["command", "cmd", "script"]);
+  return cmd ? firstLine(cmd) : void 0;
+}
+function summarizeGrep(input) {
+  const pattern = pickStr(input, ["pattern", "regex", "query"]);
+  const p = filePathOf(input);
+  if (pattern) return p ? `${firstLine(pattern, 40)} \xB7 ${p}` : firstLine(pattern);
+  return p;
+}
+var sum = (fn) => {
+  return (input) => fn(input) ?? "";
+};
+var BUILTIN_KINDS = {
+  shell: { label: "\u547D\u4EE4", icon: ICON_TERMINAL, tint: "accent", summarize: sum(summarizeShell) },
+  read: { label: "\u8BFB\u53D6", icon: ICON_FILE, tint: "info", summarize: sum(summarizeRead) },
+  edit: { label: "\u7F16\u8F91", icon: ICON_FILE_PEN, tint: "warning", summarize: sum(summarizePath) },
+  write: { label: "\u5199\u5165", icon: ICON_FILE_PLUS, tint: "warning", summarize: sum(summarizePath) },
+  rm: { label: "\u5220\u9664", icon: ICON_TRASH, tint: "error", summarize: sum(summarizePath) },
+  grep: { label: "\u641C\u7D22", icon: ICON_SEARCH, tint: "info", summarize: sum(summarizeGrep) },
+  glob: { label: "\u5339\u914D", icon: ICON_FOLDER_SEARCH, tint: "info", summarize: sum((i) => pickStr(i, ["pattern", "glob", "path"])) },
+  browser: { label: "\u6D4F\u89C8", icon: ICON_GLOBE, tint: "accent", summarize: sum((i) => pickStr(i, ["url", "uri", "target"])) },
+  search: { label: "\u68C0\u7D22", icon: ICON_SCAN_SEARCH, tint: "accent", summarize: sum((i) => pickStr(i, ["query", "q", "pattern"])) },
+  fetch: { label: "\u8BF7\u6C42", icon: ICON_DOWNLOAD, tint: "info", summarize: sum((i) => pickStr(i, ["url", "uri", "endpoint"])) },
+  mcp: { label: "MCP", icon: ICON_BLOCKS, tint: "muted", summarize: sum((i) => pickStr(i, ["tool", "method", "name"])) },
+  skill: { label: "\u6280\u80FD", icon: ICON_ZAP, tint: "accent", summarize: sum((i) => pickStr(i, ["skill", "name", "command"])) },
+  todo: {
+    label: "\u5F85\u529E",
+    icon: ICON_LIST,
+    tint: "info",
+    summarize: sum((input) => {
+      const items = input && typeof input === "object" && Array.isArray(input.items) ? input.items : Array.isArray(input) ? input : [];
+      const done = items.filter((it) => it?.status === "done").length;
+      return items.length > 0 ? `${done}/${items.length} \u5B8C\u6210` : "";
+    })
+  },
+  plan: { label: "\u8BA1\u5212", icon: ICON_LIST_CHECKS, tint: "info" },
+  subagent: { label: "\u5B50\u4EE3\u7406", icon: ICON_BOT, tint: "accent", summarize: sum((i) => pickStr(i, ["task", "description", "prompt", "message", "subagent_type"])) },
+  note: { label: "\u7B14\u8BB0", icon: ICON_FILE_TEXT, tint: "muted" },
+  chart: { label: "\u56FE\u8868", icon: ICON_CHART, tint: "info", summarize: sum((i) => pickStr(i, ["title", "name"])) }
+};
+var kindRegistry = new Map(Object.entries(BUILTIN_KINDS));
+function h(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text != null) node.textContent = text;
+  return node;
+}
+function svgIcon(svg2) {
+  if (typeof document === "undefined" || typeof DOMParser === "undefined") return null;
+  let parsed;
+  try {
+    parsed = new DOMParser().parseFromString(svg2, "image/svg+xml");
+  } catch {
+    return null;
+  }
+  const root = parsed.documentElement;
+  if (!root || root.tagName.toLowerCase() !== "svg" || parsed.querySelector("parsererror")) {
+    return null;
+  }
+  const sanitize = (el) => {
+    for (const attr of Array.from(el.attributes)) {
+      const name = attr.name.toLowerCase();
+      if (name.startsWith("on")) el.removeAttribute(attr.name);
+      if ((name === "href" || name === "xlink:href") && attr.value.trim().toLowerCase().startsWith("javascript:")) {
+        el.removeAttribute(attr.name);
+      }
+    }
+    for (const child of Array.from(el.children)) {
+      const tag = child.tagName.toLowerCase();
+      if (tag === "script" || tag === "foreignobject") {
+        child.remove();
+        continue;
+      }
+      sanitize(child);
+    }
+  };
+  sanitize(root);
+  return document.importNode(root, true);
+}
+
+// src/behaviors/kb-core.ts
+var ic = (label, d) => ({ label, icon: `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">${d}</svg>` });
+var BUILTIN_SOURCE_TYPES = {
+  doc: ic("\u6587\u6863", '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/>'),
+  web: ic("\u7F51\u9875", '<circle cx="12" cy="12" r="10"/><path d="M2 12h20"/><path d="M12 2a15 15 0 0 1 0 20 15 15 0 0 1 0-20z"/>'),
+  wiki: ic("\u77E5\u8BC6\u5E93", '<path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"/><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"/>'),
+  sheet: ic("\u8868\u683C", '<rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18M15 3v18"/>'),
+  db: ic("\u6570\u636E\u5E93", '<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14c0 1.7 4 3 9 3s9-1.3 9-3V5"/><path d="M3 12c0 1.7 4 3 9 3s9-1.3 9-3"/>'),
+  ticket: ic("\u5DE5\u5355", '<path d="M3 9V7a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v2a2 2 0 0 0 0 6v2a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-2a2 2 0 0 0 0-6z"/><path d="M13 5v14"/>'),
+  code: ic("\u4EE3\u7801", '<path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/>'),
+  api: ic("\u63A5\u53E3", '<path d="M4 7a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v3a2 2 0 0 0 0 4v3a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-3a2 2 0 0 0 0-4z"/>'),
+  image: ic("\u56FE\u7247", '<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-4.6-4.6a2 2 0 0 0-2.8 0L3 21"/>'),
+  mail: ic("\u90AE\u4EF6", '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="m22 7-10 7L2 7"/>')
+};
+var sourceTypeRegistry = new Map(Object.entries(BUILTIN_SOURCE_TYPES));
+function registerKbSourceType(name, def) {
+  sourceTypeRegistry.set(name, def);
+}
+function unregisterKbSourceType(name) {
+  if (!Object.prototype.hasOwnProperty.call(BUILTIN_SOURCE_TYPES, name)) sourceTypeRegistry.delete(name);
+}
+function getKbSourceType(name) {
+  if (name) return sourceTypeRegistry.get(name) ?? BUILTIN_SOURCE_TYPES.doc;
+  return BUILTIN_SOURCE_TYPES.doc;
+}
+function listKbSourceTypes() {
+  return [...sourceTypeRegistry.keys()];
+}
+function normalizeCitation(raw) {
+  const r = raw;
+  const score = typeof r.score === "number" && Number.isFinite(r.score) ? r.score : r.score == null ? null : null;
+  return {
+    id: String(r.id ?? ""),
+    index: typeof r.index === "number" ? r.index : void 0,
+    title: String(r.title ?? "\u672A\u547D\u540D\u6765\u6E90"),
+    url: typeof r.url === "string" && r.url ? r.url : void 0,
+    kind: typeof r.kind === "string" ? r.kind : void 0,
+    citedText: typeof r.citedText === "string" ? r.citedText : void 0,
+    snippet: typeof r.snippet === "string" ? r.snippet : void 0,
+    date: typeof r.date === "string" ? r.date : void 0,
+    score: score === void 0 ? null : score,
+    scoreKind: r.scoreKind,
+    official: r.official === true,
+    permission: r.permission === "restricted" || r.permission === "requestable" ? r.permission : "readable",
+    owner: typeof r.owner === "string" ? r.owner : void 0,
+    loc: r.loc,
+    documentId: typeof r.documentId === "string" ? r.documentId : void 0,
+    useCount: typeof r.useCount === "number" ? r.useCount : void 0
+  };
+}
+var CITE_RE = /\[(\d{1,3})\]/g;
+function parseInlineCitations(text) {
+  const out = [];
+  if (!text) return out;
+  let last = 0;
+  CITE_RE.lastIndex = 0;
+  let m;
+  while ((m = CITE_RE.exec(text)) !== null) {
+    if (m.index > last) out.push({ text: text.slice(last, m.index) });
+    out.push({ text: m[0], n: Number(m[1]) });
+    last = m.index + m[0].length;
+  }
+  if (last < text.length) out.push({ text: text.slice(last) });
+  return out;
+}
+function collectCitationNumbers(text) {
+  return parseInlineCitations(text).filter((s) => typeof s.n === "number").map((s) => s.n);
+}
+var KB_SCORE_KINDS = [
+  "cosine",
+  "dot",
+  "ip",
+  "l2",
+  "bm25",
+  "rrf",
+  "dbsf",
+  "rerank",
+  "hybrid"
+];
+var LOWER_IS_BETTER = /* @__PURE__ */ new Set(["l2"]);
+function scoreHigherIsBetter(kind) {
+  return kind != null && LOWER_IS_BETTER.has(kind) ? false : true;
+}
+function formatScore(v, digits = 3) {
+  if (v == null || !Number.isFinite(v)) return "\u2014";
+  return v.toFixed(digits).replace(/\.?0+$/, (s) => s.includes(".") ? "" : s);
+}
+function scorePercent(v, kind, max = 1) {
+  if (v == null || !Number.isFinite(v)) return null;
+  const pct = scoreHigherIsBetter(kind) ? v / max * 100 : (1 - v / max) * 100;
+  return Math.max(0, Math.min(100, pct));
+}
+function normalizeChunk(raw) {
+  const kw = Array.isArray(raw.keywords) ? raw.keywords.map(String) : void 0;
+  return {
+    id: String(raw.id ?? ""),
+    documentId: String(raw.documentId ?? ""),
+    content: String(raw.content ?? ""),
+    keywords: kw && kw.length ? kw : void 0,
+    available: raw.available !== false,
+    page: typeof raw.page === "number" ? raw.page : void 0,
+    start: typeof raw.start === "number" ? raw.start : void 0,
+    end: typeof raw.end === "number" ? raw.end : void 0,
+    imageId: typeof raw.imageId === "string" ? raw.imageId : void 0,
+    meta: raw.meta && typeof raw.meta === "object" ? raw.meta : void 0,
+    edited: raw.edited === true
+  };
+}
+var KB_RUN_STATUSES = ["unstart", "queued", "running", "cancel", "done", "fail"];
+var RUN_LABELS = {
+  unstart: "\u672A\u5F00\u59CB",
+  queued: "\u6392\u961F\u4E2D",
+  running: "\u8FDB\u884C\u4E2D",
+  cancel: "\u5DF2\u53D6\u6D88",
+  done: "\u5DF2\u5B8C\u6210",
+  fail: "\u5931\u8D25"
+};
+function kbRunStatusLabel(s) {
+  return RUN_LABELS[s] ?? s;
+}
+var STEP = (raw) => ({
+  key: String(raw.key ?? ""),
+  label: String(raw.label ?? raw.key ?? ""),
+  status: KB_RUN_STATUSES.includes(raw.status) ? raw.status : "unstart",
+  detail: typeof raw.detail === "string" ? raw.detail : void 0,
+  elapsedMs: typeof raw.elapsedMs === "number" ? raw.elapsedMs : void 0,
+  count: typeof raw.count === "number" ? raw.count : void 0
+});
+function normalizePipelineRun(raw) {
+  const steps = Array.isArray(raw.steps) ? raw.steps.map((s) => STEP(s)) : [];
+  return {
+    documentId: String(raw.documentId ?? ""),
+    title: typeof raw.title === "string" ? raw.title : void 0,
+    status: KB_RUN_STATUSES.includes(raw.status) ? raw.status : "unstart",
+    progress: typeof raw.progress === "number" ? Math.max(0, Math.min(100, raw.progress)) : void 0,
+    steps,
+    chunkCount: typeof raw.chunkCount === "number" ? raw.chunkCount : void 0,
+    elapsedMs: typeof raw.elapsedMs === "number" ? raw.elapsedMs : void 0,
+    error: raw.error && typeof raw.error === "object" ? { stage: typeof raw.error.stage === "string" ? raw.error.stage : void 0, message: String(raw.error.message ?? "") } : void 0
+  };
+}
+function normalizeConnector(raw) {
+  return {
+    id: String(raw.id ?? ""),
+    name: String(raw.name ?? ""),
+    kind: typeof raw.kind === "string" ? raw.kind : void 0,
+    scope: typeof raw.scope === "string" ? raw.scope : void 0,
+    enabled: raw.enabled !== false,
+    lastSyncAt: typeof raw.lastSyncAt === "string" ? raw.lastSyncAt : void 0,
+    lastCrawlStatus: raw.lastCrawlStatus === "ok" || raw.lastCrawlStatus === "fail" ? raw.lastCrawlStatus : "none",
+    itemsSynced: typeof raw.itemsSynced === "number" ? raw.itemsSynced : void 0,
+    crawlRate: typeof raw.crawlRate === "number" ? raw.crawlRate : void 0,
+    changeRate: typeof raw.changeRate === "number" ? raw.changeRate : void 0,
+    credential: raw.credential === "expired" || raw.credential === "none" ? raw.credential : "ok",
+    schedule: typeof raw.schedule === "string" ? raw.schedule : void 0,
+    metrics: raw.metrics && typeof raw.metrics === "object" ? raw.metrics : void 0
+  };
+}
+function connectorHealth(c, now = /* @__PURE__ */ new Date()) {
+  if (!c.enabled) return "off";
+  if (c.lastCrawlStatus === "fail" || c.credential === "expired" || c.credential === "none") return "failing";
+  const last = c.lastSyncAt ? Date.parse(c.lastSyncAt) : NaN;
+  const staleMs = 24 * 60 * 60 * 1e3;
+  if (!Number.isFinite(last) || now.getTime() - last > staleMs) return "stale";
+  return "healthy";
+}
+var KB_CLEAN_OPTIONS = ["collapse-blank", "strip-url", "strip-email"];
+function normalizeSegmentConfig(raw) {
+  const r = raw ?? {};
+  return {
+    mode: r.mode === "custom" || r.mode === "parent-child" ? r.mode : "auto",
+    delimiter: typeof r.delimiter === "string" && r.delimiter ? r.delimiter : r.mode === "custom" || r.mode === "parent-child" ? void 0 : "\n\n",
+    maxLength: typeof r.maxLength === "number" && r.maxLength > 0 ? Math.floor(r.maxLength) : 500,
+    overlap: typeof r.overlap === "number" && r.overlap >= 0 ? Math.floor(r.overlap) : 50,
+    clean: Array.isArray(r.clean) ? r.clean.filter((c) => KB_CLEAN_OPTIONS.includes(c)) : [],
+    locked: r.locked === true
+  };
+}
+var URL_RE = /https?:\/\/\S+/g;
+var EMAIL_RE = /[\w.+-]+@[\w-]+\.[\w.]+/g;
+function cleanText(text, clean) {
+  let out = text;
+  if (clean.includes("collapse-blank")) out = out.replace(/\n{3,}/g, "\n\n");
+  if (clean.includes("strip-url")) out = out.replace(URL_RE, "");
+  if (clean.includes("strip-email")) out = out.replace(EMAIL_RE, "");
+  return out;
+}
+function delimiterToRe(delim) {
+  const literal = delim.replace(/\\n/g, "\n").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(literal, "g");
+}
+function segmentText(text, config) {
+  const cfg = normalizeSegmentConfig(config);
+  const cleaned = cleanText(text ?? "", cfg.clean);
+  if (!cleaned.trim()) return [];
+  const parts = [];
+  if (cfg.mode === "custom" || cfg.mode === "parent-child" || cfg.mode === "auto" && cfg.delimiter) {
+    const re = delimiterToRe(cfg.delimiter ?? "\n\n");
+    for (const seg of cleaned.split(re)) {
+      const s = seg.trim();
+      if (s) parts.push(s);
+    }
+  } else {
+    parts.push(cleaned.trim());
+  }
+  if (cfg.mode === "parent-child") return parts;
+  const out = [];
+  for (const p of parts) {
+    if (p.length <= cfg.maxLength) {
+      out.push(p);
+      continue;
+    }
+    const overlap = Math.min(cfg.overlap, Math.max(0, cfg.maxLength - 1));
+    for (let i = 0; i < p.length; i += cfg.maxLength - overlap) {
+      out.push(p.slice(i, i + cfg.maxLength));
+      if (i + cfg.maxLength >= p.length) break;
+    }
+  }
+  return out;
+}
+function segmentStats(chunks) {
+  const count = chunks.length;
+  const total = chunks.reduce((n, c) => n + c.length, 0);
+  return { count, avgLength: count ? Math.round(total / count) : 0, tokensEstimate: Math.round(total / 2) };
+}
+function normalizeHit(raw) {
+  const score = typeof raw.score === "number" && Number.isFinite(raw.score) ? raw.score : null;
+  return {
+    chunkId: String(raw.chunkId ?? raw.id ?? ""),
+    documentId: typeof raw.documentId === "string" ? raw.documentId : void 0,
+    title: typeof raw.title === "string" ? raw.title : void 0,
+    snippet: String(raw.snippet ?? raw.content ?? ""),
+    score,
+    scoreKind: raw.scoreKind,
+    vectorPart: typeof raw.vectorPart === "number" ? raw.vectorPart : void 0,
+    keywordPart: typeof raw.keywordPart === "number" ? raw.keywordPart : void 0,
+    explain: typeof raw.explain === "string" ? raw.explain : void 0,
+    page: typeof raw.page === "number" ? raw.page : void 0,
+    meta: raw.meta && typeof raw.meta === "object" ? raw.meta : void 0
+  };
+}
+function normalizeRetrievalParams(raw) {
+  const r = raw ?? {};
+  return {
+    topK: typeof r.topK === "number" && r.topK > 0 ? Math.floor(r.topK) : 5,
+    mode: r.mode === "vector" || r.mode === "keyword" || r.mode === "hybrid" ? r.mode : "hybrid",
+    alpha: typeof r.alpha === "number" ? Math.max(0, Math.min(1, r.alpha)) : 0.5,
+    rerank: r.rerank === true,
+    rerankModel: typeof r.rerankModel === "string" ? r.rerankModel : void 0,
+    threshold: typeof r.threshold === "number" ? r.threshold : null
+  };
+}
+var KB_FILTER_OPS = ["eq", "ne", "gt", "gte", "lt", "lte", "in", "contains", "exists"];
+function normalizeFilterNode(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  if (r.type === "group") {
+    const children = Array.isArray(r.children) ? r.children.map(normalizeFilterNode).filter((c) => c !== null) : [];
+    return children.length ? { type: "group", op: r.op === "or" ? "or" : "and", children } : null;
+  }
+  if (r.type === "rule") {
+    const field = String(r.field ?? "").trim();
+    const op = KB_FILTER_OPS.includes(r.op) ? r.op : null;
+    if (!field || !op) return null;
+    let value;
+    if (Array.isArray(r.value)) value = r.value.map((v) => typeof v === "number" ? v : String(v));
+    else if (typeof r.value === "number" || typeof r.value === "string" || typeof r.value === "boolean") value = r.value;
+    return { type: "rule", field, op, value };
+  }
+  return null;
+}
+var MONGO_OP = {
+  eq: "$eq",
+  ne: "$ne",
+  gt: "$gt",
+  gte: "$gte",
+  lt: "$lt",
+  lte: "$lte",
+  in: "$in",
+  contains: "$regex",
+  exists: "$exists"
+};
+function filterToMongo(node) {
+  const n = normalizeFilterNode(node);
+  if (!n) return null;
+  if (n.type === "group") {
+    const key = n.op === "or" ? "$or" : "$and";
+    return { [key]: n.children.map((c) => filterToMongo(c) ?? {}) };
+  }
+  if (n.op === "exists") return { [n.field]: { $exists: n.value !== false } };
+  if (n.op === "contains") {
+    const v = Array.isArray(n.value) ? String(n.value[0] ?? "") : String(n.value ?? "");
+    return { [n.field]: { $regex: v.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), $options: "i" } };
+  }
+  const mk = MONGO_OP[n.op];
+  if (!mk) return null;
+  const value = Array.isArray(n.value) ? n.value : n.value ?? "";
+  return { [n.field]: { [mk]: value } };
+}
+function odataQuote(v) {
+  return typeof v === "number" ? String(v) : `'${String(v).replace(/'/g, "''")}'`;
+}
+var ODATA_OP = {
+  eq: "eq",
+  ne: "ne",
+  gt: "gt",
+  gte: "ge",
+  lt: "lt",
+  lte: "le",
+  in: "in",
+  contains: "contains",
+  exists: "exists"
+};
+function filterToOData(node) {
+  const n = normalizeFilterNode(node);
+  if (!n) return "";
+  if (n.type === "group") {
+    const join = n.op === "or" ? " or " : " and ";
+    return n.children.map((c) => `(${filterToOData(c)})`).join(join);
+  }
+  if (n.op === "contains") {
+    const v = Array.isArray(n.value) ? String(n.value[0] ?? "") : String(n.value ?? "");
+    return `contains(${n.field},${odataQuote(v)})`;
+  }
+  if (n.op === "in") {
+    const list = Array.isArray(n.value) ? n.value : [typeof n.value === "number" ? n.value : String(n.value ?? "")];
+    return `${n.field} in (${list.map(odataQuote).join(",")})`;
+  }
+  if (n.op === "exists") return n.value === false ? `${n.field} eq null` : `${n.field} ne null`;
+  const raw = Array.isArray(n.value) ? n.value[0] : n.value;
+  const value = typeof raw === "number" ? raw : String(raw ?? "");
+  return `${n.field} ${ODATA_OP[n.op]} ${odataQuote(value)}`;
+}
+function rerankDelta(item) {
+  if (!item.before || !item.after) return null;
+  return item.after.rank - item.before.rank;
+}
+function hitTestStats(cases) {
+  const ran = cases.filter((c) => c.passed !== void 0);
+  const passed = ran.filter((c) => c.passed === true);
+  const scores = ran.flatMap((c) => (c.lastHits ?? []).map((h2) => h2.score)).filter((s) => typeof s === "number");
+  return {
+    total: cases.length,
+    passed: passed.length,
+    hitRate: ran.length ? passed.length / ran.length : null,
+    avgScore: scores.length ? scores.reduce((a, b) => a + b, 0) / scores.length : null
+  };
+}
+function normalizeSqlQuery(raw) {
+  return {
+    sql: String(raw.sql ?? ""),
+    dialect: typeof raw.dialect === "string" ? raw.dialect : void 0,
+    tables: Array.isArray(raw.tables) ? raw.tables.map(String) : void 0,
+    visibility: raw.visibility === "admin" ? "admin" : "all",
+    editable: raw.editable !== false,
+    prevSql: typeof raw.prevSql === "string" ? raw.prevSql : void 0,
+    reasoning: typeof raw.reasoning === "string" ? raw.reasoning : void 0
+  };
+}
+function normalizeQueryResult(raw) {
+  const columns = Array.isArray(raw.columns) ? raw.columns.map((c) => typeof c === "string" ? { name: c } : { name: String(c.name ?? ""), type: c.type }) : [];
+  return {
+    columns,
+    rows: Array.isArray(raw.rows) ? raw.rows.map((r) => Array.isArray(r) ? r.map((v) => typeof v === "number" || typeof v === "string" ? v : null) : []) : [],
+    totalRows: typeof raw.totalRows === "number" ? raw.totalRows : void 0,
+    truncated: raw.truncated === true,
+    limit: typeof raw.limit === "number" ? raw.limit : void 0,
+    rowCount: typeof raw.rowCount === "number" ? raw.rowCount : Array.isArray(raw.rows) ? raw.rows.length : 0,
+    durationMs: typeof raw.durationMs === "number" ? raw.durationMs : void 0,
+    exportFormats: Array.isArray(raw.exportFormats) ? raw.exportFormats.map(String) : void 0
+  };
+}
+var KB_SPAN_KINDS = [
+  "retrieval",
+  "generation",
+  "rerank",
+  "embed",
+  "tool",
+  "guard",
+  "chunk",
+  "query",
+  "agent"
+];
+var SPAN_LABELS = {
+  retrieval: "\u68C0\u7D22",
+  generation: "\u751F\u6210",
+  rerank: "\u91CD\u6392",
+  embed: "\u5411\u91CF\u5316",
+  tool: "\u5DE5\u5177",
+  guard: "\u62A4\u680F",
+  chunk: "\u5207\u7247",
+  query: "\u67E5\u8BE2",
+  agent: "\u4EE3\u7406"
+};
+function kbSpanKindLabel(k) {
+  return SPAN_LABELS[k] ?? k;
+}
+var KB_SPAN_STATUSES = ["running", "done", "error", "cancel"];
+function toSpanStatus(v) {
+  return v === "running" || v === "error" || v === "cancel" ? v : "done";
+}
+function normalizeSpans(raw) {
+  const spans = raw.map((r) => ({
+    id: String(r.id ?? ""),
+    parentId: typeof r.parentId === "string" ? r.parentId : void 0,
+    kind: KB_SPAN_KINDS.includes(r.kind) ? r.kind : "tool",
+    name: String(r.name ?? ""),
+    status: toSpanStatus(r.status),
+    startedAt: typeof r.startedAt === "number" || typeof r.startedAt === "string" ? r.startedAt : void 0,
+    elapsedMs: typeof r.elapsedMs === "number" ? r.elapsedMs : void 0,
+    detail: typeof r.detail === "string" ? r.detail : void 0,
+    usage: r.usage && typeof r.usage === "object" ? r.usage : void 0,
+    hits: Array.isArray(r.hits) ? r.hits.map((h2) => normalizeHit(h2)) : void 0,
+    error: typeof r.error === "string" ? r.error : void 0
+  })).filter((s) => s.id);
+  const byId = new Map(spans.map((s) => [s.id, s]));
+  return [...spans].sort((a, b) => {
+    const da = depthOf(a, byId, 0);
+    const db = depthOf(b, byId, 0);
+    return da === db ? indexIn(spans, a) - indexIn(spans, b) : da - db;
+  });
+}
+function depthOf(span, byId, guard) {
+  if (guard > 32 || !span.parentId) return 0;
+  const parent = byId.get(span.parentId);
+  return parent ? depthOf(parent, byId, guard + 1) + 1 : 0;
+}
+function indexIn(spans, target) {
+  const i = spans.findIndex((s) => s.id === target.id);
+  return i === -1 ? spans.length : i;
+}
+function evalGrade(scoreDelta, costDeltaPct, latencyDeltaPct) {
+  if (scoreDelta == null || Math.abs(scoreDelta) < 1e-9) {
+    if (scoreDelta == null) return "tie";
+    const worse = costDeltaPct != null && costDeltaPct > 5 || latencyDeltaPct != null && latencyDeltaPct > 15;
+    return worse ? "tradeoff" : "tie";
+  }
+  if (scoreDelta > 0) {
+    const worse = costDeltaPct != null && costDeltaPct > 5 || latencyDeltaPct != null && latencyDeltaPct > 15;
+    return worse ? "tradeoff" : "improvement";
+  }
+  return "regression";
+}
+function meanScore(scores) {
+  if (!scores) return null;
+  const vals = Object.values(scores).filter((v) => typeof v === "number");
+  return vals.length ? vals.reduce((a, b) => a + b, 0) / vals.length : null;
+}
+function deltaLabel(v, digits = 1) {
+  if (v == null || !Number.isFinite(v)) return "\u2014";
+  const s = v.toFixed(digits);
+  return v > 0 ? `+${s}` : s;
+}
+var KB_ROLES = ["viewer", "commenter", "editor", "owner"];
+function kbRoleLabel(r) {
+  return r === "viewer" ? "\u53EF\u67E5\u770B" : r === "commenter" ? "\u53EF\u8BC4\u8BBA" : r === "editor" ? "\u53EF\u7F16\u8F91" : r === "owner" ? "\u8D1F\u8D23\u4EBA" : "\u65E0\u6743\u9650";
+}
+function roleAtLeast(role, floor) {
+  return KB_ROLES.indexOf(role) >= KB_ROLES.indexOf(floor);
+}
+var KB_VISIBILITIES = ["hidden", "metadata", "restricted", "summary", "full"];
+function kbVisibilityLabel(v) {
+  return v === "hidden" ? "\u4E0D\u53EF\u89C1" : v === "metadata" ? "\u4EC5\u5143\u6570\u636E" : v === "restricted" ? "\u53D7\u9650" : v === "summary" ? "\u4EC5\u6458\u8981" : "\u53EF\u89C1";
+}
+function normalizeAclEntry(raw) {
+  const r = raw;
+  const s = r.subject ?? {};
+  const kind = s.kind === "user" || s.kind === "group" || s.kind === "org" || s.kind === "anyone" || s.kind === "link" ? s.kind : "user";
+  return {
+    subject: { kind, id: String(s.id ?? ""), label: String(s.label ?? "\u672A\u547D\u540D\u4E3B\u4F53"), note: typeof s.note === "string" ? s.note : void 0 },
+    role: KB_ROLES.includes(r.role) ? r.role : "viewer",
+    inheritedFrom: typeof r.inheritedFrom === "string" && r.inheritedFrom ? r.inheritedFrom : void 0,
+    expiresAt: typeof r.expiresAt === "string" && r.expiresAt ? r.expiresAt : void 0,
+    deny: r.deny === true,
+    system: r.system === true
+  };
+}
+function normalizeIdentity(raw) {
+  const r = raw;
+  return {
+    user: String(r.user ?? ""),
+    groups: Array.isArray(r.groups) ? r.groups.map(String) : [],
+    label: typeof r.label === "string" ? r.label : void 0,
+    note: typeof r.note === "string" ? r.note : void 0
+  };
+}
+function visibilityForRole(role, policy) {
+  if (role) return "full";
+  if (policy?.summaryAllowed === true) return "summary";
+  return policy?.discoverable === false ? "hidden" : "metadata";
+}
+function subjectMatches(subject, identity) {
+  if (subject.kind === "user") return subject.id === identity.user || subject.label === identity.user;
+  if (subject.kind === "group") return identity.groups.includes(subject.id) || identity.groups.includes(subject.label);
+  if (subject.kind === "org" || subject.kind === "anyone") return true;
+  return false;
+}
+function evaluateAcl(entries, identity, policy) {
+  const list = (Array.isArray(entries) ? entries : []).map((e) => normalizeAclEntry(e));
+  const id = normalizeIdentity(identity);
+  const matched = list.filter((e) => subjectMatches(e.subject, id));
+  const chain = matched.map((entry) => ({
+    entry,
+    via: entry.subject.kind === "link" ? "link" : entry.inheritedFrom ? "inherit" : "direct"
+  }));
+  const deny = matched.find((e) => e.deny);
+  if (deny) {
+    return { role: null, visibility: visibilityForRole(null, { ...policy, summaryAllowed: false }), chain, deniedBy: deny.subject };
+  }
+  const grants = matched.filter((e) => !e.deny);
+  const role = grants.reduce((acc, e) => acc && roleAtLeast(acc, e.role) ? acc : e.role, null);
+  const futureExpiry = grants.map((e) => Date.parse(e.expiresAt ?? "")).filter((t) => Number.isFinite(t) && t > Date.now()).sort((a, b) => a - b)[0];
+  return {
+    role,
+    visibility: visibilityForRole(role, policy),
+    chain,
+    expiresAt: Number.isFinite(futureExpiry) ? new Date(futureExpiry).toISOString() : void 0
+  };
+}
+var KB_ACCESS_STATES = [
+  "idle",
+  "requested",
+  "pending_review",
+  "granted",
+  "expiring",
+  "expired",
+  "denied",
+  "revoked"
+];
+function kbAccessStateLabel(s) {
+  return {
+    idle: "\u672A\u7533\u8BF7",
+    requested: "\u5DF2\u63D0\u4EA4",
+    pending_review: "\u5F85\u5BA1\u6279",
+    granted: "\u5DF2\u5F00\u901A",
+    expiring: "\u5373\u5C06\u5230\u671F",
+    expired: "\u5DF2\u8FC7\u671F",
+    denied: "\u672A\u901A\u8FC7",
+    revoked: "\u5DF2\u6536\u56DE"
+  }[s] ?? s;
+}
+function normalizeAccessRequest(raw) {
+  const r = raw;
+  const state = KB_ACCESS_STATES.includes(r.state) ? r.state : "idle";
+  const str = (v) => typeof v === "string" && v ? v : void 0;
+  return {
+    id: String(r.id ?? ""),
+    requester: String(r.requester ?? ""),
+    resource: String(r.resource ?? ""),
+    role: KB_ROLES.includes(r.role) ? r.role : "viewer",
+    reason: str(r.reason),
+    state,
+    submittedAt: str(r.submittedAt) ?? (/* @__PURE__ */ new Date()).toISOString(),
+    approverNote: str(r.approverNote),
+    decidedBy: str(r.decidedBy),
+    decidedAt: str(r.decidedAt),
+    expiresAt: str(r.expiresAt)
+  };
+}
+var KB_AUDIT_ACTIONS = [
+  "read",
+  "preview",
+  "permission_change",
+  "grant",
+  "revoke",
+  "request",
+  "approve",
+  "deny",
+  "delegation",
+  "break_glass",
+  "sync"
+];
+function kbAuditActionLabel(a) {
+  return {
+    read: "\u8BFB\u53D6",
+    preview: "\u9884\u89C8",
+    permission_change: "\u6743\u9650\u53D8\u66F4",
+    grant: "\u6388\u4E88",
+    revoke: "\u6536\u56DE",
+    request: "\u7533\u8BF7",
+    approve: "\u6279\u51C6",
+    deny: "\u62D2\u7EDD",
+    delegation: "\u59D4\u6D3E",
+    break_glass: "\u5E94\u6025\u8BBF\u95EE",
+    sync: "\u6743\u9650\u540C\u6B65"
+  }[a] ?? a;
+}
+var KB_AUDIT_CHANNELS = ["read", "permission", "request", "system"];
+function auditChannelOf(a) {
+  if (a === "read" || a === "preview") return "read";
+  if (a === "permission_change" || a === "grant" || a === "revoke" || a === "delegation" || a === "sync") return "permission";
+  if (a === "request" || a === "approve" || a === "deny") return "request";
+  return "system";
+}
+function normalizeAuditEntry(raw) {
+  const r = raw;
+  const actor = r.actor ?? {};
+  const kind = actor.kind === "app" || actor.kind === "system" ? actor.kind : "human";
+  return {
+    id: String(r.id ?? ""),
+    at: String(r.at ?? ""),
+    actor: { kind, name: String(actor.name ?? "\u672A\u77E5") },
+    action: KB_AUDIT_ACTIONS.includes(r.action) ? r.action : "read",
+    resource: typeof r.resource === "string" && r.resource ? r.resource : void 0,
+    detail: String(r.detail ?? ""),
+    breakGlass: r.breakGlass === true
+  };
+}
+var KB_HYGIENE_KINDS = [
+  "org_wide_link",
+  "broad_group",
+  "sensitive_mismatch",
+  "broken_inheritance",
+  "orphaned_owner",
+  "overexposed"
+];
+function kbHygieneLabel(k) {
+  return {
+    org_wide_link: "\u7EC4\u7EC7\u7EA7\u94FE\u63A5",
+    broad_group: "\u8FC7\u5BBD\u7EC4\u6388\u6743",
+    sensitive_mismatch: "\u654F\u611F\u5EA6\u9519\u914D",
+    broken_inheritance: "\u65AD\u7EE7\u627F",
+    orphaned_owner: "\u8D1F\u8D23\u4EBA\u7F3A\u4F4D",
+    overexposed: "\u8FC7\u5EA6\u66B4\u9732"
+  }[k] ?? k;
+}
+function normalizeHygieneIssue(raw) {
+  const r = raw;
+  const severity = r.severity === "high" || r.severity === "medium" || r.severity === "low" ? r.severity : "medium";
+  return {
+    id: String(r.id ?? ""),
+    kind: KB_HYGIENE_KINDS.includes(r.kind) ? r.kind : "overexposed",
+    resource: String(r.resource ?? ""),
+    metric: String(r.metric ?? ""),
+    hint: String(r.hint ?? ""),
+    severity
+  };
+}
+function formatPercent(v, digits = 1) {
+  if (v == null || !Number.isFinite(v)) return "\u2014";
+  return `${(v * 100).toFixed(digits)}%`;
+}
+function formatCount(n) {
+  if (n == null || !Number.isFinite(n)) return "\u2014";
+  if (Math.abs(n) >= 1e4) return `${(n / 1e3).toFixed(1)}k`;
+  return n.toLocaleString("en-US");
+}
+function relativeTime(input, now = /* @__PURE__ */ new Date()) {
+  const t = input instanceof Date ? input.getTime() : typeof input === "number" ? input : Date.parse(input);
+  if (!Number.isFinite(t)) return typeof input === "string" ? input : "\u2014";
+  const diff = now.getTime() - t;
+  const MIN = 6e4, HOUR = 36e5, DAY = 864e5;
+  if (diff < MIN) return "\u521A\u521A";
+  if (diff < HOUR) return `${Math.floor(diff / MIN)} \u5206\u949F\u524D`;
+  if (diff < DAY) return `${Math.floor(diff / HOUR)} \u5C0F\u65F6\u524D`;
+  if (diff < 30 * DAY) return `${Math.floor(diff / DAY)} \u5929\u524D`;
+  const d = new Date(t);
+  const ymd = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+  return ymd;
+}
+export {
+  KB_ACCESS_STATES,
+  KB_AUDIT_ACTIONS,
+  KB_AUDIT_CHANNELS,
+  KB_CLEAN_OPTIONS,
+  KB_FILTER_OPS,
+  KB_HYGIENE_KINDS,
+  KB_ROLES,
+  KB_RUN_STATUSES,
+  KB_SCORE_KINDS,
+  KB_SPAN_KINDS,
+  KB_SPAN_STATUSES,
+  KB_VISIBILITIES,
+  auditChannelOf,
+  collectCitationNumbers,
+  connectorHealth,
+  deltaLabel,
+  evalGrade,
+  evaluateAcl,
+  filterToMongo,
+  filterToOData,
+  formatCount,
+  formatPercent,
+  formatScore,
+  getKbSourceType,
+  h,
+  hitTestStats,
+  kbAccessStateLabel,
+  kbAuditActionLabel,
+  kbHygieneLabel,
+  kbRoleLabel,
+  kbRunStatusLabel,
+  kbSpanKindLabel,
+  kbVisibilityLabel,
+  listKbSourceTypes,
+  meanScore,
+  normalizeAccessRequest,
+  normalizeAclEntry,
+  normalizeAuditEntry,
+  normalizeChunk,
+  normalizeCitation,
+  normalizeConnector,
+  normalizeFilterNode,
+  normalizeHit,
+  normalizeHygieneIssue,
+  normalizeIdentity,
+  normalizePipelineRun,
+  normalizeQueryResult,
+  normalizeRetrievalParams,
+  normalizeSegmentConfig,
+  normalizeSpans,
+  normalizeSqlQuery,
+  parseInlineCitations,
+  registerKbSourceType,
+  relativeTime,
+  rerankDelta,
+  roleAtLeast,
+  scoreHigherIsBetter,
+  scorePercent,
+  segmentStats,
+  segmentText,
+  svgIcon,
+  unregisterKbSourceType,
+  visibilityForRole
+};