npm - agent-knowledge - Versions diffs - 1.0.0 - Mend

agent-knowledge 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

package/CHANGELOG.md +77 -0
package/LICENSE +21 -0
package/README.md +191 -0
package/dist/dashboard.d.ts +4 -0
package/dist/dashboard.d.ts.map +1 -0
package/dist/dashboard.js +434 -0
package/dist/dashboard.js.map +1 -0
package/dist/embeddings/claude.d.ts +21 -0
package/dist/embeddings/claude.d.ts.map +1 -0
package/dist/embeddings/claude.js +84 -0
package/dist/embeddings/claude.js.map +1 -0
package/dist/embeddings/factory.d.ts +9 -0
package/dist/embeddings/factory.d.ts.map +1 -0
package/dist/embeddings/factory.js +60 -0
package/dist/embeddings/factory.js.map +1 -0
package/dist/embeddings/gemini.d.ts +21 -0
package/dist/embeddings/gemini.d.ts.map +1 -0
package/dist/embeddings/gemini.js +86 -0
package/dist/embeddings/gemini.js.map +1 -0
package/dist/embeddings/index.d.ts +4 -0
package/dist/embeddings/index.d.ts.map +1 -0
package/dist/embeddings/index.js +3 -0
package/dist/embeddings/index.js.map +1 -0
package/dist/embeddings/local.d.ts +20 -0
package/dist/embeddings/local.d.ts.map +1 -0
package/dist/embeddings/local.js +73 -0
package/dist/embeddings/local.js.map +1 -0
package/dist/embeddings/openai.d.ts +20 -0
package/dist/embeddings/openai.d.ts.map +1 -0
package/dist/embeddings/openai.js +84 -0
package/dist/embeddings/openai.js.map +1 -0
package/dist/embeddings/types.d.ts +39 -0
package/dist/embeddings/types.d.ts.map +1 -0
package/dist/embeddings/types.js +12 -0
package/dist/embeddings/types.js.map +1 -0
package/dist/index.d.ts +2 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +18 -0
package/dist/index.js.map +1 -0
package/dist/knowledge/distill.d.ts +27 -0
package/dist/knowledge/distill.d.ts.map +1 -0
package/dist/knowledge/distill.js +407 -0
package/dist/knowledge/distill.js.map +1 -0
package/dist/knowledge/git.d.ts +30 -0
package/dist/knowledge/git.d.ts.map +1 -0
package/dist/knowledge/git.js +228 -0
package/dist/knowledge/git.js.map +1 -0
package/dist/knowledge/search.d.ts +20 -0
package/dist/knowledge/search.d.ts.map +1 -0
package/dist/knowledge/search.js +72 -0
package/dist/knowledge/search.js.map +1 -0
package/dist/knowledge/store.d.ts +47 -0
package/dist/knowledge/store.d.ts.map +1 -0
package/dist/knowledge/store.js +173 -0
package/dist/knowledge/store.js.map +1 -0
package/dist/search/excerpt.d.ts +12 -0
package/dist/search/excerpt.d.ts.map +1 -0
package/dist/search/excerpt.js +28 -0
package/dist/search/excerpt.js.map +1 -0
package/dist/search/fuzzy.d.ts +15 -0
package/dist/search/fuzzy.d.ts.map +1 -0
package/dist/search/fuzzy.js +81 -0
package/dist/search/fuzzy.js.map +1 -0
package/dist/search/tfidf.d.ts +19 -0
package/dist/search/tfidf.d.ts.map +1 -0
package/dist/search/tfidf.js +200 -0
package/dist/search/tfidf.js.map +1 -0
package/dist/search/types.d.ts +19 -0
package/dist/search/types.d.ts.map +1 -0
package/dist/search/types.js +2 -0
package/dist/search/types.js.map +1 -0
package/dist/server.d.ts +3 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +518 -0
package/dist/server.js.map +1 -0
package/dist/sessions/indexer.d.ts +15 -0
package/dist/sessions/indexer.d.ts.map +1 -0
package/dist/sessions/indexer.js +182 -0
package/dist/sessions/indexer.js.map +1 -0
package/dist/sessions/parser.d.ts +58 -0
package/dist/sessions/parser.d.ts.map +1 -0
package/dist/sessions/parser.js +142 -0
package/dist/sessions/parser.js.map +1 -0
package/dist/sessions/scopes.d.ts +16 -0
package/dist/sessions/scopes.d.ts.map +1 -0
package/dist/sessions/scopes.js +153 -0
package/dist/sessions/scopes.js.map +1 -0
package/dist/sessions/search.d.ts +26 -0
package/dist/sessions/search.d.ts.map +1 -0
package/dist/sessions/search.js +256 -0
package/dist/sessions/search.js.map +1 -0
package/dist/sessions/summary.d.ts +28 -0
package/dist/sessions/summary.d.ts.map +1 -0
package/dist/sessions/summary.js +135 -0
package/dist/sessions/summary.js.map +1 -0
package/dist/types.d.ts +26 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +109 -0
package/dist/types.js.map +1 -0
package/dist/ui/app.js +1029 -0
package/dist/ui/index.html +373 -0
package/dist/ui/styles.css +1508 -0
package/dist/ui/ui/app.js +811 -0
package/dist/ui/ui/index.html +300 -0
package/dist/ui/ui/styles.css +1154 -0
package/dist/validate.d.ts +21 -0
package/dist/validate.d.ts.map +1 -0
package/dist/validate.js +86 -0
package/dist/validate.js.map +1 -0
package/dist/vectorstore/chunker.d.ts +48 -0
package/dist/vectorstore/chunker.d.ts.map +1 -0
package/dist/vectorstore/chunker.js +165 -0
package/dist/vectorstore/chunker.js.map +1 -0
package/dist/vectorstore/index.d.ts +5 -0
package/dist/vectorstore/index.d.ts.map +1 -0
package/dist/vectorstore/index.js +3 -0
package/dist/vectorstore/index.js.map +1 -0
package/dist/vectorstore/store.d.ts +139 -0
package/dist/vectorstore/store.d.ts.map +1 -0
package/dist/vectorstore/store.js +500 -0
package/dist/vectorstore/store.js.map +1 -0
package/dist/version.d.ts +2 -0
package/dist/version.d.ts.map +1 -0
package/dist/version.js +2 -0
package/dist/version.js.map +1 -0
package/docs/ARCHITECTURE.md +244 -0
package/docs/DASHBOARD.md +133 -0
package/docs/SETUP.md +178 -0
package/package.json +92 -0
package/scripts/copy-ui.js +6 -0

package/dist/ui/index.html ADDED Viewed

@@ -0,0 +1,373 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap"
+      rel="stylesheet"
+    />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200&display=swap"
+      rel="stylesheet"
+    />
+    <link rel="stylesheet" href="styles.css" />
+    <link
+      rel="icon"
+      href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><circle cx='13' cy='13' r='9' fill='none' stroke='%235d8da8' stroke-width='3'/><line x1='20' y1='20' x2='28' y2='28' stroke='%235d8da8' stroke-width='3' stroke-linecap='round'/><circle cx='13' cy='13' r='4' fill='%235d8da8' opacity='.3'/></svg>"
+    />
+    <title>agent-knowledge</title>
+  </head>
+  <body>
+    <header role="banner">
+      <div class="header-left">
+        <span class="material-symbols-outlined brand-icon">psychology</span>
+        <h1>agent-knowledge</h1>
+        <span class="version" id="version">v1.0.0</span>
+        <span
+          id="connection-status"
+          class="status-badge disconnected"
+          role="status"
+          aria-live="polite"
+          >Connecting</span
+        >
+      </div>
+      <div class="header-right">
+        <div class="stats" id="stats" aria-live="polite" aria-atomic="true">
+          <span class="stat-badge" id="stat-knowledge" title="Knowledge entries">
+            <span class="material-symbols-outlined stat-icon">folder</span>
+            <span class="stat-value">0</span>
+          </span>
+          <span class="stat-badge" id="stat-sessions" title="Sessions">
+            <span class="material-symbols-outlined stat-icon">history</span>
+            <span class="stat-value">0</span>
+          </span>
+          <span class="stat-badge" id="stat-vectors" title="Vector embeddings">
+            <span class="material-symbols-outlined stat-icon">neurology</span>
+            <span class="stat-value">0</span>
+          </span>
+        </div>
+        <button id="theme-toggle" class="icon-btn" title="Toggle theme" aria-label="Toggle theme">
+          <span class="material-symbols-outlined theme-icon">dark_mode</span>
+        </button>
+      </div>
+    </header>
+    <nav class="tab-bar" role="tablist" aria-label="Main navigation">
+      <button
+        id="tab-knowledge"
+        class="tab active"
+        role="tab"
+        aria-selected="true"
+        aria-controls="view-knowledge"
+        data-view="knowledge"
+      >
+        <span class="material-symbols-outlined tab-icon">folder</span>
+        Knowledge
+      </button>
+      <button
+        id="tab-search"
+        class="tab"
+        role="tab"
+        aria-selected="false"
+        aria-controls="view-search"
+        data-view="search"
+      >
+        <span class="material-symbols-outlined tab-icon">search</span>
+        Search
+      </button>
+      <button
+        id="tab-sessions"
+        class="tab"
+        role="tab"
+        aria-selected="false"
+        aria-controls="view-sessions"
+        data-view="sessions"
+      >
+        <span class="material-symbols-outlined tab-icon">history</span>
+        Sessions
+      </button>
+      <button
+        id="tab-recall"
+        class="tab"
+        role="tab"
+        aria-selected="false"
+        aria-controls="view-recall"
+        data-view="recall"
+      >
+        <span class="material-symbols-outlined tab-icon">psychology</span>
+        Recall
+      </button>
+      <button
+        id="tab-embeddings"
+        class="tab"
+        role="tab"
+        aria-selected="false"
+        aria-controls="view-embeddings"
+        data-view="embeddings"
+      >
+        <span class="material-symbols-outlined tab-icon">neurology</span>
+        Embeddings
+      </button>
+    </nav>
+    <div class="content-wrapper" id="content-wrapper">
+      <main id="content">
+        <!-- ===== Knowledge Tab ===== -->
+        <section
+          id="view-knowledge"
+          class="view active"
+          role="tabpanel"
+          aria-labelledby="tab-knowledge"
+        >
+          <div class="view-header">
+            <h2><span class="material-symbols-outlined view-icon">folder</span>Knowledge Base</h2>
+          </div>
+          <div
+            class="filter-chips"
+            id="knowledge-categories"
+            role="group"
+            aria-label="Filter by category"
+          >
+            <button class="chip active" data-category="all">
+              <span class="material-symbols-outlined chip-icon">select_all</span>All
+            </button>
+            <button class="chip" data-category="projects">
+              <span class="material-symbols-outlined chip-icon">code</span>Projects
+            </button>
+            <button class="chip" data-category="people">
+              <span class="material-symbols-outlined chip-icon">group</span>People
+            </button>
+            <button class="chip" data-category="decisions">
+              <span class="material-symbols-outlined chip-icon">gavel</span>Decisions
+            </button>
+            <button class="chip" data-category="workflows">
+              <span class="material-symbols-outlined chip-icon">account_tree</span>Workflows
+            </button>
+            <button class="chip" data-category="notes">
+              <span class="material-symbols-outlined chip-icon">sticky_note_2</span>Notes
+            </button>
+          </div>
+          <div id="knowledge-grid" class="card-grid"></div>
+          <div id="knowledge-empty" class="empty-state hidden">
+            <span class="material-symbols-outlined empty-icon">folder_off</span>
+            <div class="empty-text">No knowledge entries found</div>
+            <div class="empty-hint">
+              Entries will appear here when added via the knowledge MCP tools
+            </div>
+          </div>
+        </section>
+        <!-- ===== Search Tab ===== -->
+        <section id="view-search" class="view" role="tabpanel" aria-labelledby="tab-search" hidden>
+          <div class="view-header">
+            <h2><span class="material-symbols-outlined view-icon">search</span>Search Sessions</h2>
+          </div>
+          <div class="search-bar">
+            <span class="material-symbols-outlined search-input-icon">search</span>
+            <input
+              type="search"
+              id="search-input"
+              class="search-input"
+              placeholder="Search sessions..."
+              autocomplete="off"
+              aria-label="Search sessions"
+            />
+          </div>
+          <div class="search-controls">
+            <div
+              class="filter-chips"
+              id="search-role-filters"
+              role="group"
+              aria-label="Filter by role"
+            >
+              <button class="chip active" data-role="all">All</button>
+              <button class="chip" data-role="user">
+                <span class="material-symbols-outlined chip-icon">person</span>User
+              </button>
+              <button class="chip" data-role="assistant">
+                <span class="material-symbols-outlined chip-icon">smart_toy</span>Assistant
+              </button>
+            </div>
+            <div class="mode-toggle" role="group" aria-label="Search mode">
+              <button
+                class="mode-btn active"
+                id="mode-ranked"
+                data-mode="ranked"
+                title="TF-IDF ranked search"
+              >
+                <span class="material-symbols-outlined">sort</span>Ranked
+              </button>
+              <button
+                class="mode-btn"
+                id="mode-semantic"
+                data-mode="semantic"
+                title="Hybrid semantic + TF-IDF search"
+              >
+                <span class="material-symbols-outlined">neurology</span>Semantic
+              </button>
+              <button
+                class="mode-btn"
+                id="mode-regex"
+                data-mode="regex"
+                title="Regular expression search"
+              >
+                <span class="material-symbols-outlined">code</span>Regex
+              </button>
+            </div>
+          </div>
+          <div id="search-results" class="results-list"></div>
+          <div id="search-empty" class="empty-state">
+            <span class="material-symbols-outlined empty-icon">manage_search</span>
+            <div class="empty-text">Search across session transcripts</div>
+            <div class="empty-hint">Enter a query above to find matching messages</div>
+          </div>
+        </section>
+        <!-- ===== Sessions Tab ===== -->
+        <section
+          id="view-sessions"
+          class="view"
+          role="tabpanel"
+          aria-labelledby="tab-sessions"
+          hidden
+        >
+          <div class="view-header">
+            <h2><span class="material-symbols-outlined view-icon">history</span>Sessions</h2>
+            <div class="view-actions">
+              <select
+                id="session-project-filter"
+                class="filter-select"
+                aria-label="Filter by project"
+              >
+                <option value="">All projects</option>
+              </select>
+            </div>
+          </div>
+          <div id="sessions-list" class="sessions-list"></div>
+          <div id="sessions-empty" class="empty-state hidden">
+            <span class="material-symbols-outlined empty-icon">event_busy</span>
+            <div class="empty-text">No sessions found</div>
+            <div class="empty-hint">Sessions will appear here once indexed</div>
+          </div>
+        </section>
+        <!-- ===== Recall Tab ===== -->
+        <section id="view-recall" class="view" role="tabpanel" aria-labelledby="tab-recall" hidden>
+          <div class="view-header">
+            <h2><span class="material-symbols-outlined view-icon">psychology</span>Recall</h2>
+          </div>
+          <div class="filter-chips" id="recall-scopes" role="group" aria-label="Filter by scope">
+            <button class="chip active" data-scope="all">
+              <span class="material-symbols-outlined chip-icon">select_all</span>All
+            </button>
+            <button class="chip" data-scope="errors">
+              <span class="material-symbols-outlined chip-icon">error</span>Errors
+            </button>
+            <button class="chip" data-scope="plans">
+              <span class="material-symbols-outlined chip-icon">checklist</span>Plans
+            </button>
+            <button class="chip" data-scope="configs">
+              <span class="material-symbols-outlined chip-icon">settings</span>Configs
+            </button>
+            <button class="chip" data-scope="tools">
+              <span class="material-symbols-outlined chip-icon">build</span>Tools
+            </button>
+            <button class="chip" data-scope="files">
+              <span class="material-symbols-outlined chip-icon">description</span>Files
+            </button>
+            <button class="chip" data-scope="decisions">
+              <span class="material-symbols-outlined chip-icon">gavel</span>Decisions
+            </button>
+          </div>
+          <div class="search-bar">
+            <span class="material-symbols-outlined search-input-icon">psychology</span>
+            <input
+              type="search"
+              id="recall-input"
+              class="search-input"
+              placeholder="Query recall..."
+              autocomplete="off"
+              aria-label="Query recall"
+            />
+          </div>
+          <label class="semantic-toggle" title="Enable semantic similarity search">
+            <input type="checkbox" id="recall-semantic" checked />
+            <span class="material-symbols-outlined toggle-icon">neurology</span>
+            Semantic
+          </label>
+          <div id="recall-results" class="results-list"></div>
+          <div id="recall-empty" class="empty-state">
+            <span class="material-symbols-outlined empty-icon">psychology</span>
+            <div class="empty-text">Scoped recall across sessions</div>
+            <div class="empty-hint">
+              Select a scope and enter a query to recall relevant information
+            </div>
+          </div>
+        </section>
+        <!-- ===== Embeddings Tab ===== -->
+        <section
+          id="view-embeddings"
+          class="view"
+          role="tabpanel"
+          aria-labelledby="tab-embeddings"
+          hidden
+        >
+          <div class="view-header">
+            <h2><span class="material-symbols-outlined view-icon">neurology</span>Embeddings</h2>
+          </div>
+          <div id="embeddings-status" class="embeddings-dashboard">
+            <div class="embedding-stats-grid" id="embedding-stats-grid"></div>
+          </div>
+          <div id="embeddings-empty" class="empty-state">
+            <span class="material-symbols-outlined empty-icon">neurology</span>
+            <div class="empty-text">Vector index not initialized</div>
+            <div class="empty-hint">Embeddings are generated automatically on server startup</div>
+          </div>
+        </section>
+      </main>
+      <aside
+        id="side-panel"
+        class="side-panel"
+        role="complementary"
+        aria-label="Detail view"
+        hidden
+      >
+        <div class="panel-header">
+          <div class="panel-title" id="panel-title"></div>
+          <button id="panel-close" class="icon-btn" title="Close panel" aria-label="Close panel">
+            <span class="material-symbols-outlined">close</span>
+          </button>
+        </div>
+        <div class="panel-body" id="panel-body"></div>
+      </aside>
+    </div>
+    <div id="loading-overlay" class="loading-overlay" aria-label="Loading">
+      <div class="loading-spinner"></div>
+      <div class="loading-text">Connecting to agent-knowledge...</div>
+    </div>
+    <div id="toast-container" class="toast-container" aria-live="polite"></div>
+    <script src="https://cdn.jsdelivr.net/npm/marked@15/marked.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/dompurify@3/dist/purify.min.js"></script>
+    <link
+      rel="stylesheet"
+      href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11/build/styles/github.min.css"
+      media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)"
+    />
+    <link
+      rel="stylesheet"
+      href="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11/build/styles/github-dark.min.css"
+      media="(prefers-color-scheme: dark)"
+    />
+    <script src="https://cdn.jsdelivr.net/gh/highlightjs/cdn-release@11/build/highlight.min.js"></script>
+    <script src="app.js"></script>
+  </body>
+</html>