@vpxa/kb 0.1.24 → 0.1.25

package/packages/kb-client/dist/parsers.d.ts

@@ -0,0 +1,35 @@
+//#region packages/kb-client/src/parsers.d.ts
+/**
+ * Content parsers for MCP tool responses.
+ * Used by McpKBClient to parse structuredContent from tool calls.
+ */
+interface ParsedContent<T = unknown> {
+  text: string;
+  structured?: T;
+}
+/**
+ * Extract text content from an MCP tool result.
+ */
+declare function extractText(result: {
+  content?: unknown;
+} | null | undefined): string;
+/**
+ * Extract structured content from an MCP tool result.
+ */
+declare function extractStructured<T>(result: {
+  structuredContent?: unknown;
+} | null | undefined): T | undefined;
+/**
+ * Parse a tool result, returning both text and structured content.
+ */
+declare function parseToolResult<T = unknown>(result: {
+  content?: unknown;
+  structuredContent?: unknown;
+} | null | undefined): ParsedContent<T>;
+/**
+ * Try to parse JSON from a text tool result.
+ * Returns undefined if parsing fails.
+ */
+declare function tryParseJson<T = unknown>(text: string): T | undefined;
+//#endregion
+export { ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson };

package/packages/kb-client/dist/parsers.js

@@ -0,0 +1,2 @@
+function e(e){return!Array.isArray(e?.content)||e.content.length===0?``:e.content.filter(e=>typeof e==`object`&&!!e).filter(e=>e.type===`text`&&typeof e.text==`string`).map(e=>e.text).join(`
+`)}function t(e){return e?.structuredContent}function n(n){return{text:e(n),structured:t(n)}}function r(e){try{return JSON.parse(e)}catch{return}}export{t as extractStructured,e as extractText,n as parseToolResult,r as tryParseJson};

package/packages/kb-client/dist/types.d.ts

@@ -0,0 +1,62 @@
+//#region packages/kb-client/src/types.d.ts
+/**
+ * IKBClient — Unified data access interface for KB consumers.
+ *
+ * Implemented by:
+ * - DirectKBClient (in-process, used by TUI)
+ * - McpKBClient (over MCP transport, used by Dashboard)
+ */
+interface KBStatus {
+  totalRecords: number;
+  totalFiles: number;
+  lastIndexedAt: string | null;
+  onboarded: boolean;
+}
+interface KBSearchResult {
+  sourcePath: string;
+  contentType: string;
+  score: number;
+  content: string;
+  headingPath?: string;
+  startLine?: number;
+  endLine?: number;
+}
+interface KBKnowledgeEntry {
+  path: string;
+  title: string;
+  category: string;
+  tags: string[];
+  content: string;
+}
+interface KBGraphData {
+  nodes: Array<{
+    id: string;
+    name: string;
+    type: string;
+    sourcePath?: string;
+  }>;
+  edges: Array<{
+    fromId: string;
+    toId: string;
+    type: string;
+  }>;
+}
+interface IKBClient {
+  /** Get KB status. */
+  getStatus(): Promise<KBStatus>;
+  /** Search the knowledge base. */
+  search(query: string, options?: {
+    limit?: number;
+    mode?: 'hybrid' | 'semantic' | 'keyword';
+  }): Promise<KBSearchResult[]>;
+  /** List curated knowledge entries. */
+  listKnowledge(): Promise<KBKnowledgeEntry[]>;
+  /** Read a specific curated entry. */
+  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
+  /** Get knowledge graph data. */
+  getGraph(query?: string): Promise<KBGraphData>;
+  /** Get file tree of indexed sources. */
+  getFileTree(): Promise<string[]>;
+}
+//#endregion
+export { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus };

package/packages/kb-client/dist/types.js

@@ -0,0 +1 @@
+export{};