@vpxa/kb 0.1.23 → 0.1.25

package/packages/server/dist/tools/present-theme.js

@@ -0,0 +1,395 @@
+const e=`<link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">`;function t(){return`
+/* ── Reset ────────────────────────────────────────────────────────── */
+*{box-sizing:border-box;margin:0;padding:0}
+
+/* ── Design Tokens ────────────────────────────────────────────────── */
+:root{
+  /* Background hierarchy */
+  --background:#0f1419;
+  --background-subtle:#141b24;
+  --foreground:#e2e8f0;
+  --card:#1a2332;
+  --card-foreground:#e2e8f0;
+
+  /* Semantic colors */
+  --primary:#818cf8;
+  --primary-glow:rgba(129,140,248,.15);
+  --primary-foreground:#1e1b4b;
+  --secondary:#2a3549;
+  --secondary-foreground:#e2e8f0;
+  --muted:#2a3549;
+  --muted-foreground:#94a3b8;
+  --accent:#1e293b;
+  --accent-foreground:#a5b4fc;
+  --destructive:#f87171;
+  --border:rgba(148,163,184,.12);
+  --border-subtle:rgba(148,163,184,.06);
+  --input:#384766;
+  --ring:#6366f1;
+
+  /* Status colors */
+  --success:#10b981;
+  --success-light:#34d399;
+  --warning:#f59e0b;
+  --warning-light:#fbbf24;
+  --error:#ef4444;
+  --error-light:#f87171;
+  --info:#0ea5e9;
+  --info-light:#38bdf8;
+
+  /* Chart palette */
+  --chart-1:#818cf8;
+  --chart-2:#38bdf8;
+  --chart-3:#34d399;
+  --chart-4:#fbbf24;
+  --chart-5:#f87171;
+  --chart-6:#a78bfa;
+  --chart-7:#f472b6;
+  --chart-8:#2dd4bf;
+  --chart-9:#fb923c;
+  --chart-10:#22d3ee;
+  --chart-11:#c084fc;
+  --chart-12:#a3e635;
+  --chart-others:#a8a29e;
+  --chart-gradient-start:0.3;
+  --chart-gradient-end:0;
+
+  /* Layout */
+  --radius:0.625rem;
+  --shadow:0 4px 24px rgba(0,0,0,.25);
+  --shadow-sm:0 1px 3px rgba(0,0,0,.2);
+}
+
+/* ── Base ─────────────────────────────────────────────────────────── */
+body{
+  font-family:'Plus Jakarta Sans',ui-sans-serif,system-ui,-apple-system,sans-serif;
+  background:var(--background);color:var(--foreground);
+  min-height:100vh;padding:0;line-height:1.6;font-size:14px;
+  -webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;
+  background-image:radial-gradient(ellipse 80% 50% at 50% -20%,rgba(129,140,248,.08),transparent);
+}
+
+/* ── Animations ───────────────────────────────────────────────────── */
+@keyframes fadeInUp{from{opacity:0;transform:translateY(12px)}to{opacity:1;transform:translateY(0)}}
+@keyframes shimmer{0%{background-position:-200% 0}100%{background-position:200% 0}}
+
+/* ── Layout ───────────────────────────────────────────────────────── */
+.dashboard{max-width:1200px;margin:0 auto;padding:40px 28px}
+
+/* ── Header ───────────────────────────────────────────────────────── */
+.header{
+  padding:28px 0;margin-bottom:32px;
+  border-bottom:1px solid var(--border);
+  position:relative;
+}
+.header::after{
+  content:'';position:absolute;bottom:-1px;left:0;width:120px;height:2px;
+  background:linear-gradient(90deg,var(--primary),transparent);
+}
+.header h1{
+  font-size:1.75em;font-weight:700;color:var(--foreground);
+  letter-spacing:-0.03em;line-height:1.2;
+}
+.header .subtitle{
+  color:var(--muted-foreground);font-size:.88em;margin-top:6px;font-weight:400;
+  letter-spacing:.01em;
+}
+
+/* ── Section headings ─────────────────────────────────────────────── */
+h2{
+  font-size:1.1em;margin:32px 0 16px;color:var(--foreground);font-weight:600;
+  display:flex;align-items:center;gap:10px;letter-spacing:-0.01em;
+  animation:fadeInUp .4s ease both;
+}
+h2::before{
+  content:'';width:3px;height:16px;background:linear-gradient(180deg,var(--primary),rgba(129,140,248,.3));border-radius:2px;flex-shrink:0;
+}
+h3{font-size:1em;margin:16px 0 8px;color:var(--foreground);font-weight:600}
+
+/* ── Rendered markdown content ────────────────────────────────────── */
+.md-content{line-height:1.7;margin:12px 0}
+.md-content h1{font-size:1.4em;font-weight:700;margin:24px 0 12px;color:var(--foreground);letter-spacing:-0.02em}
+.md-content h2{font-size:1.2em;margin:20px 0 10px;color:var(--foreground);display:block}
+.md-content h2::before{display:none}
+.md-content h3{font-size:1.05em;margin:16px 0 8px;color:var(--foreground)}
+.md-content h4{font-size:.95em;margin:12px 0 6px;color:var(--foreground);font-weight:600}
+.md-content p{margin:8px 0;color:var(--foreground)}
+.md-content strong{color:var(--foreground);font-weight:600}
+.md-content em{color:var(--muted-foreground);font-style:italic}
+.md-content a{color:var(--primary);text-decoration:underline;text-underline-offset:2px}
+.md-content a:hover{color:var(--accent-foreground)}
+.md-content ul,.md-content ol{padding-left:24px;margin:8px 0}
+.md-content li{margin:4px 0;color:var(--foreground)}
+.md-content li::marker{color:var(--muted-foreground)}
+.md-content blockquote{
+  border-left:3px solid var(--primary);padding:10px 16px;margin:12px 0;
+  color:var(--muted-foreground);background:var(--card);border-radius:0 var(--radius) var(--radius) 0;
+}
+.md-content pre{
+  background:var(--card);border:1px solid var(--border);border-radius:var(--radius);
+  padding:16px;overflow-x:auto;margin:12px 0;
+}
+.md-content code{font-family:'JetBrains Mono','Cascadia Code','Fira Code',monospace;font-size:.88em}
+.md-content :not(pre)>code{background:var(--accent);padding:2px 6px;border-radius:4px;font-size:.85em;color:var(--accent-foreground)}
+.md-content table{width:100%;border-collapse:collapse;margin:12px 0;font-size:13px}
+.md-content th{
+  background:var(--accent);padding:10px 14px;text-align:left;font-weight:600;
+  color:var(--muted-foreground);border-bottom:2px solid var(--border);font-size:.8em;
+  text-transform:uppercase;letter-spacing:.5px;
+}
+.md-content td{padding:8px 14px;border-bottom:1px solid var(--border);color:var(--foreground)}
+.md-content tr:hover td{background:rgba(129,140,248,.04)}
+.md-content hr{border:none;border-top:1px solid var(--border);margin:24px 0}
+.md-content img{max-width:100%;border-radius:var(--radius)}
+
+/* ── Metrics grid ─────────────────────────────────────────────────── */
+.metric-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:14px;margin:14px 0 28px}
+.metric{
+  background:linear-gradient(135deg,var(--card),var(--accent));
+  border:1px solid var(--border);border-radius:var(--radius);
+  padding:22px 18px;text-align:center;transition:all .2s ease;position:relative;overflow:hidden;
+  animation:fadeInUp .4s ease both;
+}
+.metric::before{
+  content:'';position:absolute;top:0;left:0;right:0;height:2px;
+  background:linear-gradient(90deg,transparent,var(--primary),transparent);opacity:0;
+  transition:opacity .2s ease;
+}
+.metric:hover{border-color:rgba(129,140,248,.3);transform:translateY(-2px);box-shadow:0 8px 32px rgba(0,0,0,.2)}
+.metric:hover::before{opacity:1}
+.metric-value{
+  font-size:1.8em;font-weight:700;color:var(--primary);
+  font-variant-numeric:tabular-nums;letter-spacing:-0.02em;
+}
+.metric-label{
+  font-size:.75em;color:var(--muted-foreground);margin-top:6px;
+  text-transform:uppercase;letter-spacing:.6px;font-weight:500;
+}
+
+/* ── Cards grid ───────────────────────────────────────────────────── */
+.card-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:14px;margin:14px 0 28px}
+.card{
+  background:var(--card);border:1px solid var(--border);border-radius:var(--radius);
+  padding:20px;transition:all .2s ease;position:relative;overflow:hidden;
+  animation:fadeInUp .4s ease both;
+}
+.card::after{
+  content:'';position:absolute;top:0;left:0;width:3px;height:0;
+  background:var(--primary);transition:height .2s ease;border-radius:0 0 2px 0;
+}
+.card:hover{border-color:rgba(129,140,248,.2);box-shadow:0 4px 20px rgba(0,0,0,.15);transform:translateY(-1px)}
+.card:hover::after{height:100%}
+.card-title{font-weight:600;font-size:.98em;margin-bottom:8px;color:var(--foreground)}
+.card-body{color:var(--muted-foreground);font-size:.88em;line-height:1.55}
+.badge{
+  display:inline-flex;align-items:center;padding:3px 10px;border-radius:20px;
+  font-size:.75em;font-weight:600;margin-top:10px;
+  background:rgba(129,140,248,.1);color:var(--primary);border:1px solid rgba(129,140,248,.15);
+}
+
+/* ── Table ─────────────────────────────────────────────────────────── */
+.table-wrap{
+  overflow-x:auto;margin:14px 0 28px;border-radius:var(--radius);border:1px solid var(--border);
+  background:var(--card);animation:fadeInUp .4s ease both;
+}
+table{width:100%;border-collapse:collapse;font-size:13px}
+thead{position:sticky;top:0;z-index:1}
+th{
+  background:var(--accent);padding:12px 16px;text-align:left;font-weight:600;
+  color:var(--muted-foreground);text-transform:uppercase;letter-spacing:.5px;font-size:.72em;
+  border-bottom:1px solid var(--border);cursor:pointer;user-select:none;white-space:nowrap;
+  transition:color .15s;
+}
+th:hover{color:var(--primary)}
+td{padding:10px 16px;border-bottom:1px solid var(--border-subtle);color:var(--foreground)}
+tr:hover td{background:rgba(129,140,248,.04)}
+.tool-name{font-family:'JetBrains Mono','Cascadia Code',monospace;font-size:.85em;color:var(--primary);font-weight:500}
+.category-tag{
+  display:inline-flex;padding:2px 8px;border-radius:6px;font-size:.8em;font-weight:500;
+  background:var(--accent);color:var(--muted-foreground);border:1px solid var(--border);white-space:nowrap;
+}
+
+/* ── Code blocks ──────────────────────────────────────────────────── */
+pre{
+  background:var(--card);border:1px solid var(--border);border-radius:var(--radius);
+  padding:16px;overflow-x:auto;font-size:13px;margin:12px 0;
+}
+code{font-family:'JetBrains Mono','Cascadia Code','Fira Code',monospace;font-size:.9em}
+blockquote{
+  border-left:3px solid var(--primary);padding:10px 16px;color:var(--muted-foreground);
+  margin:12px 0;background:var(--card);border-radius:0 var(--radius) var(--radius) 0;
+}
+ul,ol{padding-left:24px;margin:8px 0}
+li{margin:4px 0}
+.tree-node{padding:3px 0}
+.tree-key{font-weight:600;color:var(--primary)}
+.tree-children{margin-left:20px;border-left:2px solid var(--border);padding-left:12px}
+
+/* ── Mermaid ──────────────────────────────────────────────────────── */
+.mermaid{background:transparent !important;border:none !important}
+
+/* ── Charts ───────────────────────────────────────────────────────── */
+.chart-container{
+  background:var(--card);border:1px solid var(--border);border-radius:var(--radius);
+  padding:24px;margin:14px 0 28px;overflow:hidden;animation:fadeInUp .4s ease both;
+}
+.chart-title{font-size:.95em;font-weight:600;color:var(--foreground);margin-bottom:14px}
+.chart-svg{width:100%;display:block}
+.chart-legend{
+  display:flex;flex-wrap:wrap;gap:14px;margin-top:14px;padding-top:12px;
+  border-top:1px solid var(--border);
+}
+.chart-legend-item{display:flex;align-items:center;gap:6px;font-size:.8em;color:var(--muted-foreground)}
+.chart-legend-swatch{width:10px;height:10px;border-radius:2px;flex-shrink:0}
+.chart-tooltip{
+  position:absolute;background:var(--card);border:1px solid var(--border);
+  border-radius:6px;padding:8px 12px;font-size:.8em;pointer-events:none;
+  box-shadow:var(--shadow);z-index:10;display:none;color:var(--foreground);
+}
+.chart-axis-label{font-size:.7em;fill:var(--muted-foreground);font-family:inherit}
+.chart-grid-line{stroke:var(--border);stroke-dasharray:3,3;stroke-width:0.5}
+
+/* ── Timeline ─────────────────────────────────────────────────────── */
+.timeline{margin:14px 0 28px;padding-left:28px;border-left:2px solid var(--border);position:relative;animation:fadeInUp .4s ease both}
+.timeline-item{position:relative;padding:0 0 28px 22px}
+.timeline-item:last-child{padding-bottom:0}
+.timeline-dot{
+  position:absolute;left:-33px;top:4px;width:12px;height:12px;
+  border-radius:50%;border:2px solid var(--border);background:var(--background);
+  transition:all .2s ease;
+}
+.timeline-dot.done{background:var(--success);border-color:var(--success);box-shadow:0 0 8px rgba(16,185,129,.3)}
+.timeline-dot.active{background:var(--primary);border-color:var(--primary);box-shadow:0 0 0 4px rgba(129,140,248,.15)}
+.timeline-dot.pending{background:var(--muted);border-color:var(--muted-foreground)}
+.timeline-dot.error{background:var(--error);border-color:var(--error);box-shadow:0 0 8px rgba(239,68,68,.3)}
+.timeline-phase{font-size:.7em;color:var(--muted-foreground);text-transform:uppercase;letter-spacing:.5px;font-weight:600;margin-bottom:2px}
+.timeline-title{font-weight:600;color:var(--foreground);font-size:.95em}
+.timeline-desc{color:var(--muted-foreground);font-size:.85em;margin-top:4px;line-height:1.5}
+
+/* ── Checklist ────────────────────────────────────────────────────── */
+.checklist{margin:14px 0 28px}
+.checklist-item{
+  display:flex;align-items:flex-start;gap:10px;padding:10px 14px;
+  border-radius:var(--radius);transition:background .1s;
+}
+.checklist-item:hover{background:var(--accent)}
+.checklist-check{
+  width:18px;height:18px;border-radius:4px;border:2px solid var(--border);
+  flex-shrink:0;margin-top:1px;display:flex;align-items:center;justify-content:center;
+  font-size:11px;color:transparent;
+}
+.checklist-check.checked{background:var(--success);border-color:var(--success);color:#fff}
+.checklist-label{color:var(--foreground);font-size:.9em;font-weight:500}
+.checklist-item.checked .checklist-label{color:var(--muted-foreground);text-decoration:line-through}
+.checklist-note{font-size:.8em;color:var(--muted-foreground);margin-top:2px}
+
+/* ── Comparison grid ──────────────────────────────────────────────── */
+.comparison-grid{
+  display:grid;gap:0;margin:14px 0 28px;border:1px solid var(--border);
+  border-radius:var(--radius);overflow:hidden;
+}
+.comparison-col{min-width:0}
+.comparison-col:not(:last-child){border-right:1px solid var(--border)}
+.comparison-header{
+  padding:14px 16px;font-weight:600;font-size:.9em;color:var(--foreground);
+  background:var(--accent);border-bottom:2px solid var(--border);text-align:center;
+}
+.comparison-item{
+  padding:10px 16px;border-bottom:1px solid var(--border);font-size:.88em;
+  color:var(--foreground);min-height:40px;display:flex;align-items:center;
+}
+.comparison-item:last-child{border-bottom:none}
+
+/* ── Status board ─────────────────────────────────────────────────── */
+.status-board{display:flex;flex-direction:column;gap:8px;margin:14px 0 28px}
+.status-row{
+  display:flex;align-items:center;gap:12px;padding:10px 14px;
+  background:var(--card);border:1px solid var(--border);border-radius:var(--radius);
+}
+.status-indicator{width:8px;height:8px;border-radius:50%;flex-shrink:0}
+.status-indicator.success{background:var(--success)}
+.status-indicator.warning{background:var(--warning)}
+.status-indicator.error{background:var(--error)}
+.status-indicator.info{background:var(--info)}
+.status-indicator.pending{background:var(--muted-foreground)}
+.status-label{font-weight:500;font-size:.9em;color:var(--foreground);flex:1}
+.status-detail{font-size:.8em;color:var(--muted-foreground)}
+
+/* ── Progress bars ────────────────────────────────────────────────── */
+.progress-list{display:flex;flex-direction:column;gap:12px;margin:14px 0 28px}
+.progress-item{display:flex;flex-direction:column;gap:4px}
+.progress-header{display:flex;justify-content:space-between;align-items:baseline}
+.progress-label{font-size:.88em;font-weight:500;color:var(--foreground)}
+.progress-value{font-size:.8em;color:var(--muted-foreground);font-variant-numeric:tabular-nums}
+.progress-track{
+  height:6px;background:var(--accent);border-radius:3px;overflow:hidden;
+}
+.progress-fill{
+  height:100%;border-radius:3px;transition:width .3s ease;
+}
+
+/* ── Prompt / Question block ──────────────────────────────────────── */
+.prompt-block{
+  background:var(--card);border:1px solid var(--primary);border-radius:var(--radius);
+  padding:20px;margin:14px 0 28px;
+}
+.prompt-question{font-size:1.05em;font-weight:600;color:var(--foreground);margin-bottom:8px}
+.prompt-context{font-size:.88em;color:var(--muted-foreground);line-height:1.6;margin-bottom:12px}
+.prompt-placeholder{
+  padding:10px 14px;background:var(--accent);border:1px dashed var(--border);
+  border-radius:var(--radius);color:var(--muted-foreground);font-size:.85em;font-style:italic;
+}
+
+/* ── Actions ──────────────────────────────────────────────────────── */
+.actions-bar{margin:32px 0}
+.actions-grid{display:flex;flex-wrap:wrap;gap:10px;margin-top:14px}
+.action-group{display:flex;flex-direction:column;gap:6px}
+.action-group label{font-size:.85em;color:var(--muted-foreground);font-weight:500}
+.action-group select{
+  padding:9px 14px;background:var(--card);border:1px solid var(--border);
+  border-radius:var(--radius);color:var(--foreground);font-size:.9em;cursor:pointer;min-width:200px;
+  font-family:inherit;
+}
+.action-group select:hover{border-color:var(--primary)}
+.action-btn{
+  padding:10px 22px;border:1px solid var(--border);border-radius:var(--radius);
+  font-size:.88em;font-weight:600;cursor:pointer;transition:all .2s ease;
+  background:var(--card);color:var(--foreground);font-family:inherit;
+}
+.action-btn:hover{transform:translateY(-1px);box-shadow:0 4px 16px rgba(0,0,0,.2)}
+.action-primary{background:linear-gradient(135deg,var(--primary),#6366f1);color:var(--primary-foreground);border-color:transparent}
+.action-primary:hover{opacity:.9;box-shadow:0 4px 20px rgba(129,140,248,.3)}
+.action-danger{background:var(--error);color:#fff;border-color:var(--error)}
+.action-danger:hover{opacity:.9}
+.action-default:hover{border-color:var(--primary);color:var(--primary)}
+.action-feedback{
+  margin-top:14px;padding:10px 16px;border-radius:var(--radius);
+  display:none;font-weight:500;font-size:.9em;
+}
+.action-feedback.sent{
+  display:block;background:rgba(16,185,129,.1);color:var(--success);
+  border:1px solid rgba(16,185,129,.2);
+}
+
+/* ── Footer ───────────────────────────────────────────────────────── */
+.footer{
+  text-align:center;padding:24px;color:var(--muted-foreground);font-size:.75em;
+  border-top:1px solid var(--border);margin-top:48px;letter-spacing:.02em;
+}
+
+/* ── Search filter (injected for tables) ──────────────────────────── */
+.search-bar{display:flex;gap:12px;margin-bottom:14px;align-items:center}
+.search-bar input{
+  flex:1;padding:9px 14px;background:var(--card);border:1px solid var(--border);
+  border-radius:var(--radius);color:var(--foreground);font-size:.9em;outline:none;
+  transition:border-color .15s;font-family:inherit;
+}
+.search-bar input:focus{border-color:var(--primary)}
+.search-bar .count{color:var(--muted-foreground);font-size:.85em;white-space:nowrap}
+
+/* ── Scrollbar ────────────────────────────────────────────────────── */
+::-webkit-scrollbar{width:6px;height:6px}
+::-webkit-scrollbar-track{background:var(--card)}
+::-webkit-scrollbar-thumb{background:var(--border);border-radius:3px}
+::-webkit-scrollbar-thumb:hover{background:var(--muted-foreground)}
+`}export{e as FONT_LINK,t as getDesignSystemCSS};

package/packages/server/dist/tools/present-utils.d.ts

@@ -0,0 +1,11 @@
+//#region packages/server/src/tools/present-utils.d.ts
+/**
+ * Shared HTML utility functions for the Present tool family.
+ *
+ * Used by present.tool.ts, present-charts.ts, and present-blocks.ts
+ * to avoid duplicating escape logic across modules.
+ */
+/** HTML-escape a string for safe insertion into HTML content and attributes. */
+declare function escHtml(s: string): string;
+//#endregion
+export { escHtml };

package/packages/server/dist/tools/present-utils.js

@@ -0,0 +1 @@
+function e(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`)}export{e as escHtml};

package/packages/server/dist/tools/present.tool.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Elicitor } from "@kb/elicitation";
+
+//#region packages/server/src/tools/present.tool.d.ts
+declare function registerPresentTool(server: McpServer, elicitor?: Elicitor): void;
+//#endregion
+export { registerPresentTool };

package/packages/server/dist/tools/present.tool.js

@@ -0,0 +1,113 @@
+import{getToolMeta as e}from"../tool-metadata.js";import{escHtml as t}from"./present-utils.js";import{renderChecklistHtml as n,renderComparisonHtml as r,renderProgressHtml as i,renderPromptHtml as a,renderStatusBoardHtml as o,renderTimelineHtml as s}from"./present-blocks.js";import{renderChartAsHtml as c}from"./present-charts.js";import{FONT_LINK as l,getDesignSystemCSS as u}from"./present-theme.js";import{readFileSync as d}from"node:fs";import{dirname as f,join as p}from"node:path";import{fileURLToPath as m}from"node:url";import{z as h}from"zod";import{exec as g}from"node:child_process";import{createServer as _}from"node:http";import{createUIResource as v}from"@mcp-ui/server";import{RESOURCE_MIME_TYPE as y,registerAppResource as b,registerAppTool as x}from"@modelcontextprotocol/ext-apps/server";import{marked as S}from"marked";S.setOptions({async:!1,gfm:!0,breaks:!0}),S.use({renderer:{html(e){return t(e.text)}}});const C=import.meta.dirname??f(m(import.meta.url)),w=`ui://kb/present.html`;function T(){return p(C,`..`,`..`,`..`,`present`,`dist`,`index.html`)}let E;function D(){if(!E)try{E=d(T(),`utf-8`)}catch{E=``}return E}const O=h.object({type:h.enum([`button`,`select`]).describe(`Action type`),id:h.string().describe(`Unique action identifier`),label:h.string().describe(`Display label`),variant:h.enum([`primary`,`danger`,`default`]).optional().describe(`Button style variant`),options:h.array(h.union([h.string(),h.object({label:h.string(),value:h.string()})])).optional().describe(`Select options (for type=select)`)}),k={format:h.enum([`html`,`browser`]).default(`html`).describe(`Output format.
+- "html" (default): Rich markdown in chat + embedded UIResource for MCP-UI hosts. Actions shown as numbered choices.
+- "browser": Rich markdown in chat + opens beautiful themed dashboard in the browser. When actions are provided, the browser shows interactive buttons and the tool blocks until the user clicks, returning their selection.`),title:h.string().optional().describe(`Optional heading`),content:h.any().describe(`Content to present. Accepts: markdown string, array of objects (→ table), { nodes, edges } (→ mermaid graph), typed blocks [{ type, value }], or any JSON (→ tree).`),actions:h.array(O).optional().describe(`Interactive actions (buttons/selects). In html mode, shown as numbered choices. In browser mode, rendered as clickable buttons and the tool blocks until user clicks.`)};let A=!1;function j(t,n){let r=e(`present`);A||=(b(t,`KB Present App`,w,{description:`Rich interactive content viewer for KB tools`},async()=>({contents:[{uri:w,mimeType:y,text:D()}]})),!0),x(t,`present`,{title:r.title,description:`Present content to the user in the best format. Two modes:
+- "html" (default): Rich markdown in chat + embedded UIResource. Actions shown as numbered choices for display.
+- "browser": Rich markdown in chat + serves a themed dashboard on a local URL that auto-opens in your system browser. If openBrowserPage is available, also call it with the returned URL. When actions are provided, browser shows interactive buttons and the tool blocks until user clicks.
+Use "html" for in-chat display. Use "browser" for visual dashboards and when you need interactive user input back.
+After calling present with format "browser", extract the URL from the response and call openBrowserPage({ url }) to open it in VS Code.`,annotations:r.annotations,inputSchema:k,_meta:{ui:{resourceUri:w}}},async({format:e,title:t,content:r,actions:i})=>(e??`html`)===`browser`?await N(t,r,i,n):J(t,r,i))}let M=null;process.on(`exit`,()=>{if(M){try{M.close()}catch{}M=null}});async function N(e,t,n,r){let i=P(e,t),a=q(e,t,n),o,s,c=Array.isArray(n)?n:[],l=``;try{M&&=(M.close(),null),c.length>0&&(o=new Promise(e=>{s=e})),l=await new Promise((e,t)=>{let n=_((e,t)=>{if(e.method===`POST`&&e.url===`/callback`){let n=``;e.on(`data`,e=>{n+=e.toString()}),e.on(`end`,()=>{t.writeHead(200,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":`*`}),t.end(`{"ok":true}`);try{let e=JSON.parse(n);s?.(e)}catch{}});return}if(e.method===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(a)});n.listen(0,`127.0.0.1`,()=>{let r=n.address();typeof r==`object`&&r?(M=n,e(`http://127.0.0.1:${r.port}`)):t(Error(`Failed to start present server`))}),setTimeout(()=>{n.close(),M===n&&(M=null)},300*1e3).unref()});try{g(process.platform===`win32`?`start "" "${l}"`:process.platform===`darwin`?`open "${l}"`:`xdg-open "${l}"`)}catch{}}catch{}let u=v({uri:`ui://kb/present-static.html`,content:{type:`rawHtml`,htmlString:a},encoding:`text`,adapters:{mcpApps:{enabled:!0}}}),d=l?`${i}\n\n---\n🌐 **Dashboard opened in browser:** ${l}`:i;if(c.length>0&&r?.available&&o)try{let e=await Promise.race([o,new Promise((e,t)=>setTimeout(()=>t(Error(`timeout`)),300*1e3))]);return{content:[{type:`text`,text:`${d}\n\n✅ **Selected:** ${e.actionId} = \`${e.value}\``},u]}}catch{return{content:[{type:`text`,text:`${d}\n\n⚠️ *No selection received (timed out).*`},u]}}return{content:[{type:`text`,text:d},u]}}function P(e,t){let n=[];if(e&&n.push(`# ${e}\n`),typeof t==`string`)n.push(t);else if(Array.isArray(t))if(t.length===0)n.push(`*(empty)*`);else if(Z(t[0]))for(let e of t)n.push(F(e));else if(typeof t[0]==`object`&&t[0]!==null)n.push(I(t));else for(let e of t)n.push(`- ${String(e)}`);else if(typeof t==`object`&&t){let e=t;Array.isArray(e.nodes)&&Array.isArray(e.edges)?n.push(R(e)):Array.isArray(e.metrics)?n.push(L(e.metrics)):n.push(z(e))}else n.push(String(t));return n.join(`
+`)}function F(e){let t=[];switch(e.title&&t.push(`## ${e.title}\n`),e.type){case`markdown`:t.push(String(e.value??``));break;case`code`:t.push(`\`\`\`${e.language??``}\n${String(e.value??``)}\n\`\`\``);break;case`mermaid`:t.push(`\`\`\`mermaid\n${String(e.value??``)}\n\`\`\``);break;case`table`:Array.isArray(e.value)&&t.push(I(e.value));break;case`metrics`:Array.isArray(e.value)&&t.push(L(e.value));break;case`graph`:e.value&&typeof e.value==`object`&&t.push(R(e.value));break;case`cards`:if(Array.isArray(e.value))for(let n of e.value)t.push(`### ${n.title??`Card`}`),(n.body||n.description)&&t.push(String(n.body??n.description)),(n.badge||n.status)&&t.push(`> **${n.badge??n.status}**`),t.push(``);break;case`tree`:e.value&&typeof e.value==`object`&&t.push(z(e.value));break;case`chart`:{let n=e.value;n?.data&&Array.isArray(n.data)&&t.push(`*${String(n.chartType??`chart`)} chart — ${n.data.length} data points*`);break}case`timeline`:{let n=e.value;if(n?.items)for(let e of n.items){let n=e.status===`done`?`✅`:e.status===`active`?`🔄`:e.status===`error`?`❌`:`⬜`;t.push(`${n} **${e.title}**${e.description?` — ${e.description}`:``}`)}break}case`checklist`:{let n=e.value;if(n?.items)for(let e of n.items)t.push(`- [${e.checked?`x`:` `}] ${e.label}${e.note?` — ${e.note}`:``}`);break}case`comparison`:{let n=e.value;if(n?.columns&&n.columns.length>0){let e=Math.max(...n.columns.map(e=>e.items?.length??0)),r=n.columns.map(e=>e.title);t.push(`| ${r.join(` | `)} |`),t.push(`| ${r.map(()=>`---`).join(` | `)} |`);for(let r=0;r<e;r++)t.push(`| ${n.columns.map(e=>e.items?.[r]??``).join(` | `)} |`)}break}case`status-board`:{let n=e.value;if(n?.items)for(let e of n.items){let n=e.status===`success`?`🟢`:e.status===`warning`?`🟡`:e.status===`error`?`🔴`:e.status===`info`?`🔵`:`⚪`;t.push(`${n} **${e.label}**${e.detail?` — ${e.detail}`:``}`)}break}case`prompt`:{let n=e.value;n?.question&&(t.push(`> **${n.question}**`),n.context&&t.push(`> ${n.context}`));break}case`progress`:{let n=e.value;if(n?.items)for(let e of n.items){let n=e.max??100,r=n>0?Math.round(e.value/n*100):0,i=`█`.repeat(Math.round(r/5))+`░`.repeat(20-Math.round(r/5));t.push(`${e.label}: ${i} ${r}%`)}break}default:t.push(JSON.stringify(e.value,null,2))}return t.push(``),t.join(`
+`)}function I(e){if(e.length===0)return`*(empty table)*`;let t=Object.keys(e[0]),n=[];n.push(`| ${t.join(` | `)} |`),n.push(`| ${t.map(()=>`---`).join(` | `)} |`);for(let r of e)n.push(`| ${t.map(e=>String(r[e]??``)).join(` | `)} |`);return n.join(`
+`)}function L(e){return e.map(e=>`- **${e.label}**: ${e.value}`).join(`
+`)}function R(e){let t=["```mermaid",`graph LR`];for(let n of e.nodes){let e=X(String(n.id??n.name??``)),r=String(n.label??n.name??e);t.push(`  ${e}["${r}"]`)}for(let n of e.edges){let e=X(String(n.source??n.from??``)),r=X(String(n.target??n.to??``)),i=n.label?`|${String(n.label)}|`:``;t.push(`  ${e} -->${i} ${r}`)}return t.push("```"),t.join(`
+`)}function z(e,t=0){let n=`  `.repeat(t),r=[];for(let[i,a]of Object.entries(e))typeof a==`object`&&a&&!Array.isArray(a)?(r.push(`${n}- **${i}**:`),r.push(z(a,t+1))):r.push(`${n}- **${i}**: ${Y(a)}`);return r.join(`
+`)}function B(e,n){let r=[];if(e&&r.push(`<h1>${t(e)}</h1>`),typeof n==`string`)r.push(`<div class="md-content">${S.parse(n)}</div>`);else if(Array.isArray(n))if(n.length===0)r.push(`<p><em>empty</em></p>`);else if(Z(n[0]))for(let e of n)r.push(V(e));else typeof n[0]==`object`&&n[0]!==null?r.push(H(n)):r.push(`<ul>${n.map(e=>`<li>${t(String(e))}</li>`).join(``)}</ul>`);else if(typeof n==`object`&&n){let e=n;Array.isArray(e.metrics)?r.push(U(e.metrics)):Array.isArray(e.nodes)&&Array.isArray(e.edges)?(r.push(`<pre class="mermaid">${t(K(e))}</pre>`),r.push(`<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"><\/script>`),r.push(`<script>mermaid.run();<\/script>`)):r.push(G(e))}else r.push(`<p>${t(String(n))}</p>`);return r.join(`
+`)}function V(e){let l=[];switch(e.title&&l.push(`<h2>${t(e.title)}</h2>`),e.type){case`markdown`:l.push(`<div class="md-content">${S.parse(String(e.value??``))}</div>`);break;case`code`:l.push(`<pre><code>${t(String(e.value??``))}</code></pre>`);break;case`mermaid`:l.push(`<pre class="mermaid">${t(String(e.value??``))}</pre>`);break;case`table`:if(Array.isArray(e.value)){let t=e.value;if(t.length>0&&Array.isArray(t[0])){let e=t,n=e[0].map(String),r=e.slice(1).map(e=>Object.fromEntries(n.map((t,n)=>[t,e[n]])));l.push(H(r))}else l.push(H(t))}break;case`metrics`:{let t;Array.isArray(e.value)?t=e.value:e.value&&typeof e.value==`object`&&(t=Object.entries(e.value).map(([e,t])=>({label:e,value:String(t)}))),t&&l.push(U(t))}break;case`cards`:Array.isArray(e.value)&&l.push(W(e.value));break;case`tree`:e.value&&typeof e.value==`object`&&l.push(G(e.value));break;case`graph`:e.value&&typeof e.value==`object`&&l.push(`<pre class="mermaid">${t(K(e.value))}</pre>`);break;case`chart`:{let t=e.value;if(t&&!t.chartType&&t.type&&Array.isArray(t.labels)&&Array.isArray(t.datasets)){let n=t.labels,r=t.datasets,i=r.map((e,t)=>e.label??`series${t+1}`),a=n.map((e,t)=>{let n={_label:e};return r.forEach((e,r)=>{n[i[r]]=e.data[t]??0}),n}),o={type:`chart`,title:e.title,value:{chartType:String(t.type),data:a,xKey:`_label`,yKeys:i}};l.push(c(o))}else l.push(c(e));break}case`timeline`:{let t=e.value;Array.isArray(t)&&(t={items:t.map(e=>({title:String(e.event??e.title??``),phase:e.date==null?e.phase==null?void 0:String(e.phase):String(e.date),description:e.description==null?void 0:String(e.description),status:e.status??`done`}))}),t&&l.push(s(t));break}case`checklist`:e.value&&l.push(n(e.value));break;case`comparison`:e.value&&l.push(r(e.value));break;case`status-board`:e.value&&l.push(o(e.value));break;case`prompt`:e.value&&l.push(a(e.value));break;case`progress`:e.value&&l.push(i(e.value));break;default:l.push(`<pre>${t(JSON.stringify(e.value,null,2))}</pre>`)}return l.join(`
+`)}function H(e){if(e.length===0)return`<p><em>empty table</em></p>`;let n=Object.keys(e[0]);return`<div class="table-wrap"><table><thead><tr>${n.map(e=>`<th>${t(e)}</th>`).join(``)}</tr></thead><tbody>${e.map(e=>`<tr>${n.map(n=>`<td>${t(String(e[n]??``))}</td>`).join(``)}</tr>`).join(`
+`)}</tbody></table></div>`}function U(e){return`<div class="metric-grid">${e.map(e=>`<div class="metric"><div class="metric-value">${t(String(e.value))}</div><div class="metric-label">${t(e.label)}</div></div>`).join(``)}</div>`}function W(e){return`<div class="card-grid">${e.map(e=>{let n=[`<div class="card">`];return e.title&&n.push(`<div class="card-title">${t(String(e.title))}</div>`),(e.body||e.description)&&n.push(`<div class="card-body">${t(String(e.body??e.description))}</div>`),(e.badge||e.status)&&n.push(`<span class="badge">${t(String(e.badge??e.status))}</span>`),n.push(`</div>`),n.join(``)}).join(``)}</div>`}function G(e){let n=[];for(let[r,i]of Object.entries(e))typeof i==`object`&&i&&!Array.isArray(i)?n.push(`<div class="tree-node"><span class="tree-key">${t(r)}:</span><div class="tree-children">${G(i)}</div></div>`):n.push(`<div class="tree-node"><span class="tree-key">${t(r)}:</span> ${t(Y(i))}</div>`);return n.join(``)}function K(e){let t=[`graph LR`];for(let n of e.nodes){let e=X(String(n.id??n.name??``)),r=String(n.label??n.name??e);t.push(`  ${e}["${r}"]`)}for(let n of e.edges){let e=X(String(n.source??n.from??``)),r=X(String(n.target??n.to??``)),i=n.label?`|${String(n.label)}|`:``;t.push(`  ${e} -->${i} ${r}`)}return t.join(`
+`)}function q(e,n,r){let i=B(e,n);return`<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>${t(e??`KB Dashboard`)}</title>
+${l}
+<style>${u()}</style>
+</head>
+<body>
+<div class="dashboard">
+  <div class="header">
+    <h1>${t(e??`KB Dashboard`)}</h1>
+    <div class="subtitle">Knowledge Base</div>
+  </div>
+  ${i}
+  ${(()=>{let e=Array.isArray(r)?r:[];return e.length===0?``:`
+  <div class="actions-bar">
+    <h2>Actions</h2>
+    <div class="actions-grid">${e.map(e=>{let n=String(e.id??``);if(e.type===`select`&&Array.isArray(e.options)){let r=e.options.map(e=>{let n=typeof e==`string`?e:e.label;return`<option value="${t(typeof e==`string`?e:e.value)}">${t(n)}</option>`}).join(``);return`<div class="action-group"><label>${t(String(e.label??``))}</label><select data-action-id="${t(n)}" onchange="sendCallback(${t(JSON.stringify(n))},this.value)">${r}</select></div>`}return`<button class="action-btn action-${String(e.variant??`default`)}" onclick="sendCallback(${t(JSON.stringify(n))},'clicked')">${t(String(e.label??``))}</button>`}).join(`
+`)}</div>
+    <div id="action-feedback" class="action-feedback"></div>
+  </div>
+  <script>
+  let _cbSent=false;
+  function sendCallback(actionId,value){
+    if(_cbSent)return;
+    _cbSent=true;
+    document.querySelectorAll('.action-btn,.action-group select').forEach(el=>{el.disabled=true;el.style.opacity='0.5'});
+    const fb=document.getElementById('action-feedback');
+    fb.textContent='⏳ Sending selection: '+actionId+' = '+value;
+    fb.className='action-feedback sent';
+    fetch('/callback',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({actionId,value})})
+      .then(()=>{
+        fb.textContent='✓ Selection sent: '+actionId+' = '+value;
+      })
+      .catch(e=>{
+        fb.textContent='✗ Callback failed — '+e.message;
+        fb.style.color='var(--error)';
+        _cbSent=false;
+        document.querySelectorAll('.action-btn,.action-group select').forEach(el=>{el.disabled=false;el.style.opacity='1'});
+      });
+  }
+  <\/script>`})()}
+  <div class="footer">KB MCP Server &middot; Generated ${new Date().toLocaleString()}</div>
+</div>
+<script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"><\/script>
+<script>
+// Mermaid initialization
+if(document.querySelector('.mermaid'))mermaid.initialize({theme:'dark',startOnLoad:true});
+
+// Table sorting
+document.querySelectorAll('table').forEach(table=>{
+  const headers=table.querySelectorAll('th');
+  headers.forEach((th,i)=>{
+    let asc=true;
+    th.addEventListener('click',()=>{
+      const tbody=table.querySelector('tbody')||table;
+      const rows=[...tbody.querySelectorAll('tr')].filter(r=>r.querySelector('td'));
+      rows.sort((a,b)=>{
+        const at=(a.cells[i]?.textContent||'').trim();
+        const bt=(b.cells[i]?.textContent||'').trim();
+        return asc?at.localeCompare(bt,undefined,{numeric:true}):bt.localeCompare(at,undefined,{numeric:true});
+      });
+      rows.forEach(r=>tbody.appendChild(r));
+      asc=!asc;
+      headers.forEach(h=>h.style.color='');
+      th.style.color='var(--primary)';
+    });
+  });
+});
+
+// Table search/filter
+document.querySelectorAll('.table-wrap').forEach(wrap=>{
+  const table=wrap.querySelector('table');
+  if(!table||table.querySelectorAll('tr').length<5)return;
+  const bar=document.createElement('div');
+  bar.className='search-bar';
+  const input=document.createElement('input');
+  input.placeholder='Filter rows...';
+  const count=document.createElement('span');
+  count.className='count';
+  bar.appendChild(input);bar.appendChild(count);
+  wrap.parentNode.insertBefore(bar,wrap);
+  const rows=[...table.querySelectorAll('tbody tr, tr')].filter(r=>r.querySelector('td'));
+  const updateCount=()=>{const v=rows.filter(r=>r.style.display!=='none').length;count.textContent=v+'/'+rows.length};
+  updateCount();
+  input.addEventListener('input',()=>{
+    const q=input.value.toLowerCase();
+    rows.forEach(r=>{r.style.display=r.textContent.toLowerCase().includes(q)?'':'none'});
+    updateCount();
+  });
+});
+<\/script>
+</body>
+</html>`}function J(e,t,n){let r=Array.isArray(n)?n:[],i=[];if(e&&i.push(`## ${e}\n`),Array.isArray(t)){for(let e of t)if(e&&typeof e==`object`&&typeof e.type==`string`)if(e.type===`metrics`&&e.value&&typeof e.value==`object`){let t=e.value;i.push(Object.entries(t).map(([e,t])=>`**${e}**: ${String(t)}`).join(`  ·  `))}else e.type===`text`&&typeof e.value==`string`?i.push(e.value):i.push(`*${e.type}${e.title?`: ${String(e.title)}`:``}*`)}else typeof t==`string`&&i.push(t);if(r.length>0){i.push(``);for(let e=0;e<r.length;e++){let t=r[e],n=typeof t.label==`string`?t.label:`Action ${e+1}`;if(t.type===`select`&&Array.isArray(t.options)){let r=t.options.map(e=>typeof e==`string`?e:e.label).join(`, `);i.push(`${e+1}. **${n}** — choose: ${r}`)}else i.push(`${e+1}. **${n}**`)}}let a={title:e,content:t};return r.length>0&&(a.actions=r),{content:[{type:`text`,text:i.join(`
+`)}],structuredContent:a}}function Y(e){return e==null?`null`:Array.isArray(e)?`[${e.map(Y).join(`, `)}]`:String(e)}function X(e){return e.replace(/[^a-zA-Z0-9_]/g,`_`)}function Z(e){return typeof e==`object`&&!!e&&`type`in e&&`value`in e}export{j as registerPresentTool};

package/packages/server/dist/tools/produce.tool.js

@@ -1,4 +1,4 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{DependencyAnalyzer as n,DiagramGenerator as r,EntryPointAnalyzer as i,KnowledgeProducer as a,PatternAnalyzer as o,StructureAnalyzer as s,SymbolAnalyzer as c}from"../../../analyzers/dist/index.js";import{createLogger as l,serializeError as u}from"../../../core/dist/index.js";const d=l(`tools`);function f(l){let f=new a({structure:new s,dependencies:new n,symbols:new c,patterns:new o,entryPoints:new i,diagrams:new r}),p=e(`produce_knowledge`);l.registerTool(`produce_knowledge`,{title:p.title,description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:t.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:t.array(t.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:p.annotations},async({scope:e,aspects:t})=>{try{let n=e??`.`;d.info(`Running knowledge production`,{rootPath:n,aspects:t});let r=await f.runExtraction(n,t);return{content:[{type:`text`,text:f.buildSynthesisInstructions(r,t)+`
+import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";import{DependencyAnalyzer as i,DiagramGenerator as a,EntryPointAnalyzer as o,KnowledgeProducer as s,PatternAnalyzer as c,StructureAnalyzer as l,SymbolAnalyzer as u}from"../../../analyzers/dist/index.js";const d=n(`tools`);function f(n){let f=new s({structure:new l,dependencies:new i,symbols:new u,patterns:new c,entryPoints:new o,diagrams:new a}),p=e(`produce_knowledge`);n.registerTool(`produce_knowledge`,{title:p.title,description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:t.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:t.array(t.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:p.annotations},async({scope:e,aspects:t})=>{try{let n=e??`.`;d.info(`Running knowledge production`,{rootPath:n,aspects:t});let r=await f.runExtraction(n,t);return{content:[{type:`text`,text:f.buildSynthesisInstructions(r,t)+`
 
 ---
-_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return d.error(`Knowledge production failed`,u(e)),{content:[{type:`text`,text:`Knowledge production failed. Check server logs for details.`}],isError:!0}}})}export{f as registerProduceKnowledgeTool};
+_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return d.error(`Knowledge production failed`,r(e)),{content:[{type:`text`,text:`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{f as registerProduceKnowledgeTool};

package/packages/server/dist/tools/read.tool.js

@@ -1,2 +1,2 @@
 import{getToolMeta as e}from"../tool-metadata.js";import{curatedResourceLink as t}from"../resource-links.js";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";const a=r(`tools`);function o(r,o){let s=e(`read`);r.registerTool(`read`,{title:s.title,description:`Read the full content of a specific curated knowledge entry by its path. Use list first to discover available entries.`,inputSchema:{path:n.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`)},annotations:s.annotations},async({path:e})=>{try{let n=await o.read(e),r=[`## ${n.title}`,`- **Path**: .ai/curated/${e}`,`- **Category**: ${n.category}`,n.tags.length?`- **Tags**: ${n.tags.join(`, `)}`:null,`- **Version**: ${n.version}`,`- **Created**: ${n.created}`,n.updated===n.created?null:`- **Updated**: ${n.updated}`,``].filter(e=>e!==null).join(`
-`),i=t(e,n.title,`[${n.category}]`);return{content:[{type:`text`,text:`${r}\n${n.content}\n\n---\n_Next: Use \`update\` to modify this entry, or \`search\` to find related entries._`},...i?[i]:[]]}}catch(e){return a.error(`Read failed`,i(e)),{content:[{type:`text`,text:`Read failed. Check server logs for details.`}],isError:!0}}})}export{o as registerReadTool};
+`),i=t(e,n.title,`[${n.category}]`);return{content:[{type:`text`,text:`${r}\n${n.content}\n\n---\n_Next: Use \`update\` to modify this entry, or \`search\` to find related entries._`},...i?[i]:[]]}}catch(e){return a.error(`Read failed`,i(e)),{content:[{type:`text`,text:`Read failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{o as registerReadTool};

package/packages/server/dist/tools/reindex.tool.d.ts

@@ -1,10 +1,11 @@
 import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { ResourceNotifier } from "../resources/resource-notifier.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { KBConfig } from "@kb/core";
 import { IncrementalIndexer } from "@kb/indexer";
 import { IKnowledgeStore } from "@kb/store";
 
 //#region packages/server/src/tools/reindex.tool.d.ts
-declare function registerReindexTool(server: McpServer, indexer: IncrementalIndexer, config: KBConfig, curated: CuratedKnowledgeManager, store?: IKnowledgeStore): void;
+declare function registerReindexTool(server: McpServer, indexer: IncrementalIndexer, config: KBConfig, curated: CuratedKnowledgeManager, store?: IKnowledgeStore, resourceNotifier?: ResourceNotifier): void;
 //#endregion
 export { registerReindexTool };

package/packages/server/dist/tools/reindex.tool.js

@@ -1,3 +1,3 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";const i=n(`tools`);function a(n,a,o,s,c){let l=e(`reindex`);n.registerTool(`reindex`,{title:l.title,description:`Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.`,inputSchema:{full:t.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`)},annotations:l.annotations},async({full:e})=>{try{if(a.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
+import{getToolMeta as e}from"../tool-metadata.js";import{createTaskRunner as t}from"../task-manager.js";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";const a=r(`tools`);function o(r,o,s,c,l,u){let d=e(`reindex`);r.registerTool(`reindex`,{title:d.title,description:`Trigger re-indexing of the knowledge base. Can do incremental (only changed files) or full re-index.`,inputSchema:{full:n.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`)},annotations:d.annotations},async({full:e},n)=>{try{if(o.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
 
-A reindex operation is currently running. Search and other tools continue to work with existing data. Use \`status({})\` to check when it completes.`}]};i.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let t=e=>t=>{t.phase===`chunking`&&t.currentFile&&i.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})};return(e?a.reindexAll(o,t(`Reindex`)):a.index(o,t(`Index`))).then(async e=>{if(i.info(`Background re-index complete`,{filesProcessed:e.filesProcessed,chunksCreated:e.chunksCreated,durationMs:e.durationMs}),c)try{await c.createFtsIndex(),i.info(`FTS index rebuilt after reindex`)}catch(e){i.warn(`FTS index rebuild failed`,r(e))}try{let e=await s.reindexAll();i.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){i.warn(`Curated re-index failed`,r(e))}}).catch(e=>{i.error(`Background reindex failed`,r(e))}),{content:[{type:`text`,text:`## Reindex Started (Background)\n\n- **Mode**: ${e?`Full`:`Incremental`}\n- Search and other tools continue to work with existing data during reindex.\n- Completion will be logged. Use \`status({})\` to check index stats afterward.\n\n---\n_Next: Continue working — the reindex runs in the background._`}]}}catch(e){return i.error(`Reindex failed`,r(e)),{content:[{type:`text`,text:`Reindex failed. Check server logs for details.`}],isError:!0}}})}export{a as registerReindexTool};
+A reindex operation is currently running. Search and other tools continue to work with existing data. Use \`status({})\` to check when it completes.`}]};let r=t(n).createTask(`Reindex`,1);r.progress(0,`Starting ${e?`full`:`incremental`} reindex`),a.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let d=e=>t=>{t.phase===`chunking`&&t.currentFile&&a.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})};return(e?o.reindexAll(s,d(`Reindex`)):o.index(s,d(`Index`))).then(async e=>{if(a.info(`Background re-index complete`,{filesProcessed:e.filesProcessed,chunksCreated:e.chunksCreated,durationMs:e.durationMs}),r.complete(`Reindex complete: ${e.filesProcessed} files, ${e.chunksCreated} chunks in ${e.durationMs}ms`),l)try{await l.createFtsIndex(),a.info(`FTS index rebuilt after reindex`)}catch(e){a.warn(`FTS index rebuild failed`,i(e))}try{let e=await c.reindexAll();a.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){a.warn(`Curated re-index failed`,i(e))}if(u)try{await u.notifyAfterReindex()}catch(e){a.warn(`Post-reindex resource notification failed`,i(e))}}).catch(e=>{r.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),a.error(`Background reindex failed`,i(e))}),{content:[{type:`text`,text:`## Reindex Started (Background)\n\n- **Mode**: ${e?`Full`:`Incremental`}\n- Search and other tools continue to work with existing data during reindex.\n- Completion will be logged. Use \`status({})\` to check index stats afterward.\n\n---\n_Next: Continue working — the reindex runs in the background._`}]}}catch(e){return a.error(`Reindex failed`,i(e)),{content:[{type:`text`,text:`Reindex failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{o as registerReindexTool};

package/packages/server/dist/tools/remember.tool.d.ts

@@ -1,8 +1,9 @@
 import { CuratedKnowledgeManager } from "../curated-manager.js";
+import { ResourceNotifier } from "../resources/resource-notifier.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { EvolutionCollector, PolicyStore } from "@kb/enterprise-bridge";
 
 //#region packages/server/src/tools/remember.tool.d.ts
-declare function registerRememberTool(server: McpServer, curated: CuratedKnowledgeManager, policyStore?: PolicyStore, evolutionCollector?: EvolutionCollector): void;
+declare function registerRememberTool(server: McpServer, curated: CuratedKnowledgeManager, policyStore?: PolicyStore, evolutionCollector?: EvolutionCollector, resourceNotifier?: ResourceNotifier): void;
 //#endregion
 export { registerRememberTool };

package/packages/server/dist/tools/remember.tool.js

@@ -1,4 +1,4 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{curatedResourceLink as t}from"../resource-links.js";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";const a=r(`tools`);function o(r,o,s,c){let l=e(`remember`);r.registerTool(`remember`,{title:l.title,description:`Store a new piece of curated knowledge. Use this to persist decisions, patterns, conventions, or any insight worth remembering across sessions.`,inputSchema:{title:n.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),content:n.string().min(10).max(1e5).describe(`The markdown content to store`),category:n.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),tags:n.array(n.string()).default([]).describe(`Optional tags for filtering`)},annotations:l.annotations},async({title:e,content:n,category:l,tags:u})=>{try{let i=await o.remember(e,n,l,u),a=``;if(s){let t=s.classify(e,n,u);c&&c.recordClassification(e,t.matchingRules.map(e=>e.ruleId),t.pushRecommended),t.matchingRules.length>0&&(a=`\n\n### Classification Signals\n${t.matchingRules.map(e=>`  - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
+import{getToolMeta as e}from"../tool-metadata.js";import{curatedResourceLink as t}from"../resource-links.js";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";const a=r(`tools`);function o(r,o,s,c,l){let u=e(`remember`);r.registerTool(`remember`,{title:u.title,description:`Store a new piece of curated knowledge. Use this to persist decisions, patterns, conventions, or any insight worth remembering across sessions.`,inputSchema:{title:n.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),content:n.string().min(10).max(1e5).describe(`The markdown content to store`),category:n.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),tags:n.array(n.string()).default([]).describe(`Optional tags for filtering`)},annotations:u.annotations},async({title:e,content:n,category:r,tags:u})=>{try{let i=await o.remember(e,n,r,u),a=``;if(s){let t=s.classify(e,n,u);c&&c.recordClassification(e,t.matchingRules.map(e=>e.ruleId),t.pushRecommended),t.matchingRules.length>0&&(a=`\n\n### Classification Signals\n${t.matchingRules.map(e=>`  - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
 `)}\n- **Push recommended**: ${t.pushRecommended?`yes`:`no`} (max weight: ${t.maxPushWeight})`,t.pushRecommended&&(a+=`
 
-> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}r.sendResourceListChanged();let d=t(i.path,e,`[${l}]`);return{content:[{type:`text`,text:`Remembered: **${e}**\n\nStored at \`.ai/curated/${i.path}\` and indexed for semantic search.${a}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`list\` to see all curated entries._`},...d?[d]:[]]}}catch(e){return a.error(`Remember failed`,i(e)),{content:[{type:`text`,text:`Remember failed. Check server logs for details.`}],isError:!0}}})}export{o as registerRememberTool};
+> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}l&&l.notifyAfterCuratedWrite(i.path).catch(()=>{});let d=t(i.path,e,`[${r}]`);return{content:[{type:`text`,text:`Remembered: **${e}**\n\nStored at \`.ai/curated/${i.path}\` and indexed for semantic search.${a}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`list\` to see all curated entries._`},...d?[d]:[]]}}catch(e){return a.error(`Remember failed`,i(e)),{content:[{type:`text`,text:`Remember failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{o as registerRememberTool};