@team-semicolon/semo-cli 3.14.1 → 4.0.0

package/dist/kb.d.ts

@@ -0,0 +1,134 @@
+/**
+ * SEMO KB/Ontology Module
+ *
+ * Knowledge Base and Ontology management for SEMO bot ecosystem.
+ * Uses the team's core PostgreSQL database as Single Source of Truth.
+ *
+ * v3.15.0: Initial implementation
+ * v3.15.1: pgvector embedding integration
+ */
+import { Pool } from "pg";
+/**
+ * Generate embedding vector for text using OpenAI API
+ * Requires OPENAI_API_KEY environment variable
+ */
+export declare function generateEmbedding(text: string): Promise<number[] | null>;
+/**
+ * Generate embeddings for multiple texts (batched)
+ */
+export declare function generateEmbeddings(texts: string[]): Promise<(number[] | null)[]>;
+export interface KBEntry {
+    domain: string;
+    key: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_by?: string;
+    version?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface BotKBEntry extends KBEntry {
+    bot_id: string;
+    synced_at?: string;
+}
+export interface OntologyDomain {
+    domain: string;
+    schema: Record<string, unknown>;
+    description: string | null;
+    version: number;
+    updated_at?: string;
+}
+export interface KBStatusInfo {
+    shared: {
+        total: number;
+        domains: Record<string, number>;
+        lastUpdated: string | null;
+    };
+    bot: {
+        total: number;
+        domains: Record<string, number>;
+        lastUpdated: string | null;
+        lastSynced: string | null;
+    };
+}
+export interface KBDiffResult {
+    added: KBEntry[];
+    removed: KBEntry[];
+    modified: Array<{
+        local: KBEntry;
+        remote: KBEntry;
+    }>;
+    unchanged: number;
+}
+export interface SyncState {
+    botId: string;
+    lastPull: string | null;
+    lastPush: string | null;
+    sharedCount: number;
+    botCount: number;
+}
+/**
+ * Get shared KB entries from semo.knowledge_base
+ */
+export declare function kbPull(pool: Pool, botId: string, domain?: string, cwd?: string): Promise<{
+    shared: KBEntry[];
+    bot: BotKBEntry[];
+}>;
+/**
+ * Push local KB entries to database
+ */
+export declare function kbPush(pool: Pool, botId: string, entries: KBEntry[], target?: "shared" | "bot", cwd?: string): Promise<{
+    upserted: number;
+    errors: string[];
+}>;
+/**
+ * Get KB status for a bot
+ */
+export declare function kbStatus(pool: Pool, botId: string): Promise<KBStatusInfo>;
+/**
+ * List KB entries with optional filters
+ */
+export declare function kbList(pool: Pool, options: {
+    domain?: string;
+    botId?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    shared: KBEntry[];
+    bot: BotKBEntry[];
+}>;
+/**
+ * Diff local KB files against database
+ */
+export declare function kbDiff(pool: Pool, botId: string, cwd: string): Promise<KBDiffResult>;
+/**
+ * Search KB — hybrid: vector similarity (if embedding available) + text fallback
+ */
+export declare function kbSearch(pool: Pool, query: string, options: {
+    domain?: string;
+    botId?: string;
+    limit?: number;
+    mode?: "semantic" | "text" | "hybrid";
+}): Promise<KBEntry[]>;
+/**
+ * List all ontology domains
+ */
+export declare function ontoList(pool: Pool): Promise<OntologyDomain[]>;
+/**
+ * Show ontology detail for a domain
+ */
+export declare function ontoShow(pool: Pool, domain: string): Promise<OntologyDomain | null>;
+/**
+ * Validate KB entries against ontology schema (basic JSON Schema validation)
+ */
+export declare function ontoValidate(pool: Pool, domain: string, entries?: KBEntry[]): Promise<{
+    valid: number;
+    invalid: Array<{
+        key: string;
+        errors: string[];
+    }>;
+}>;
+/**
+ * Write ontology schemas to local cache
+ */
+export declare function ontoPullToLocal(pool: Pool, cwd: string): Promise<number>;