cognova 0.2.12 → 0.2.14

package/dist/cli/index.js

@@ -1250,14 +1250,38 @@ async function checkPrerequisites() {
   } else {
     R2.success(`Claude Code ${claudeOut}`);
   }
+  let hasDocker = !!dockerOut;
   if (dockerOut) {
     R2.success(`Docker available ${import_picocolors3.default.dim("(for local PostgreSQL)")}`);
   } else {
-    R2.info(`Docker not found ${import_picocolors3.default.dim("(needed only for local PostgreSQL)")}`);
+    const installDocker = await Re({
+      message: "Docker not found. Install it? (needed only for local PostgreSQL)",
+      initialValue: false
+    });
+    if (!Ct(installDocker) && installDocker) {
+      const s = bt2();
+      s.start("Installing Docker");
+      try {
+        if (process.platform === "darwin") {
+          execSync("brew install --cask docker", { stdio: "inherit" });
+          s.stop("Docker Desktop installed \u2014 open it from Applications to finish setup");
+        } else {
+          const cmd = process.platform === "linux" ? "sudo apt-get update -qq && sudo apt-get install -y -qq docker.io docker-compose-plugin" : "apt-get update -qq && apt-get install -y -qq docker.io docker-compose-plugin";
+          execSync(cmd, { stdio: "inherit" });
+          s.stop("Docker installed");
+        }
+        hasDocker = !!checkCommand("docker --version");
+      } catch {
+        s.stop("Docker installation failed");
+        R2.warn("Install Docker manually: https://docs.docker.com/get-docker/");
+      }
+    } else {
+      R2.info(`Skipped \u2014 you can use a remote PostgreSQL instead`);
+    }
   }
   return {
     ok: true,
-    hasDocker: !!dockerOut,
+    hasDocker,
     nodeVersion: nodeOut || "",
     pythonVersion: pythonOut || "",
     pnpmVersion: pnpmOut || "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cognova",
   "type": "module",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Personal knowledge management system with Claude Code integration",
   "repository": {
     "type": "git",

package/server/api/agents/index.get.ts

@@ -1,12 +1,31 @@
-import { getDb } from '~~/server/db'
+import { inArray, sql } from 'drizzle-orm'
+import { getDb, schema } from '~~/server/db'
 import { requireDb } from '~~/server/utils/db-guard'
 
 export default defineEventHandler(async (event) => {
   requireDb(event)
 
+  const query = getQuery(event)
+  const search = query.search as string | undefined
+
   const db = getDb()
 
+  // Full-text search via tsvector + GIN index
+  let where
+  if (search) {
+    const ftsResult = await db.execute<{ id: string }>(sql`
+      SELECT id FROM cron_agents
+      WHERE search_vector @@ plainto_tsquery('english', ${search})
+      ORDER BY ts_rank(search_vector, plainto_tsquery('english', ${search})) DESC
+      LIMIT 50
+    `)
+    const ids = ftsResult.map(r => r.id)
+    if (ids.length === 0) return { data: [] }
+    where = inArray(schema.cronAgents.id, ids)
+  }
+
   const agents = await db.query.cronAgents.findMany({
+    where,
     with: { creator: true },
     orderBy: (agents, { asc }) => [asc(agents.name)]
   })

package/server/api/conversations/index.get.ts

@@ -1,4 +1,4 @@
-import { desc } from 'drizzle-orm'
+import { desc, inArray, sql } from 'drizzle-orm'
 import { getDb } from '~~/server/db'
 import * as schema from '~~/server/db/schema'
 import { requireDb } from '~~/server/utils/db-guard'
@@ -6,13 +6,31 @@ import { requireDb } from '~~/server/utils/db-guard'
 export default defineEventHandler(async (event) => {
   requireDb(event)
 
+  const query = getQuery(event)
+  const search = query.search as string | undefined
+
   const db = getDb()
 
+  // Full-text search via tsvector + GIN index
+  let where
+  if (search) {
+    const ftsResult = await db.execute<{ id: string }>(sql`
+      SELECT id FROM conversations
+      WHERE search_vector @@ plainto_tsquery('english', ${search})
+      ORDER BY ts_rank(search_vector, plainto_tsquery('english', ${search})) DESC
+      LIMIT 50
+    `)
+    const ids = ftsResult.map(r => r.id)
+    if (ids.length === 0) return { data: [] }
+    where = inArray(schema.conversations.id, ids)
+  }
+
   // Main Chat always first, then by most recent
-  const conversations = await db.select()
-    .from(schema.conversations)
-    .orderBy(desc(schema.conversations.isMain), desc(schema.conversations.startedAt))
-    .limit(50)
+  const conversations = await db.query.conversations.findMany({
+    where,
+    orderBy: [desc(schema.conversations.isMain), desc(schema.conversations.startedAt)],
+    limit: 50
+  })
 
   return { data: conversations }
 })

package/server/api/documents/index.get.ts

@@ -1,4 +1,4 @@
-import { eq, isNull, ilike, and, or } from 'drizzle-orm'
+import { eq, isNull, inArray, and, sql } from 'drizzle-orm'
 import { getDb } from '~~/server/db'
 import * as schema from '~~/server/db/schema'
 import { requireDb } from '~~/server/utils/db-guard'
@@ -24,15 +24,17 @@ export default defineEventHandler(async (event) => {
   if (fileType)
     conditions.push(eq(schema.documents.fileType, fileType))
 
+  // Full-text search via tsvector + GIN index
   if (search) {
-    const pattern = `%${search}%`
-    conditions.push(
-      or(
-        ilike(schema.documents.title, pattern),
-        ilike(schema.documents.content, pattern),
-        ilike(schema.documents.path, pattern)
-      )
-    )
+    const ftsResult = await db.execute<{ id: string }>(sql`
+      SELECT id FROM documents
+      WHERE search_vector @@ plainto_tsquery('english', ${search})
+      ORDER BY ts_rank(search_vector, plainto_tsquery('english', ${search})) DESC
+      LIMIT 50
+    `)
+    const ids = ftsResult.map(r => r.id)
+    if (ids.length === 0) return { data: [] }
+    conditions.push(inArray(schema.documents.id, ids))
   }
 
   const documents = await db.query.documents.findMany({

package/server/api/memory/search.get.ts

@@ -1,4 +1,4 @@
-import { sql, desc, eq, and, gte, ilike, or } from 'drizzle-orm'
+import { sql, desc, eq, and, gte, inArray } from 'drizzle-orm'
 import { getDb, schema } from '~~/server/db'
 import { requireDb } from '~~/server/utils/db-guard'
 import type { MemoryChunk, MemoryChunkType } from '~~/shared/types'
@@ -29,12 +29,17 @@ export default defineEventHandler(async (event) => {
   if (minRelevance !== undefined)
     conditions.push(gte(schema.memoryChunks.relevanceScore, minRelevance))
 
-  // Text search (simple ILIKE for now, will upgrade to tsvector)
+  // Full-text search via tsvector + GIN index
   if (searchQuery) {
-    conditions.push(or(
-      ilike(schema.memoryChunks.content, `%${searchQuery}%`),
-      ilike(schema.memoryChunks.sourceExcerpt, `%${searchQuery}%`)
-    ))
+    const ftsResult = await db.execute<{ id: string }>(sql`
+      SELECT id FROM memory_chunks
+      WHERE search_vector @@ plainto_tsquery('english', ${searchQuery})
+      ORDER BY ts_rank(search_vector, plainto_tsquery('english', ${searchQuery})) DESC
+      LIMIT ${limit}
+    `)
+    const ids = ftsResult.map(r => r.id)
+    if (ids.length === 0) return { data: [] as MemoryChunk[] }
+    conditions.push(inArray(schema.memoryChunks.id, ids))
   }
 
   let dbQuery = db.select()

package/server/api/tasks/index.get.ts

@@ -1,4 +1,4 @@
-import { eq, isNull, ilike, inArray, and, or } from 'drizzle-orm'
+import { eq, isNull, inArray, and, sql } from 'drizzle-orm'
 import { getDb, schema } from '~~/server/db'
 import { requireDb } from '~~/server/utils/db-guard'
 
@@ -29,15 +29,17 @@ export default defineEventHandler(async (event) => {
   if (projectId)
     conditions.push(eq(schema.tasks.projectId, projectId))
 
-  // Search filter (title and description)
+  // Full-text search via tsvector + GIN index
   if (search) {
-    const searchPattern = `%${search}%`
-    conditions.push(
-      or(
-        ilike(schema.tasks.title, searchPattern),
-        ilike(schema.tasks.description, searchPattern)
-      )
-    )
+    const ftsResult = await db.execute<{ id: string }>(sql`
+      SELECT id FROM tasks
+      WHERE search_vector @@ plainto_tsquery('english', ${search})
+      ORDER BY ts_rank(search_vector, plainto_tsquery('english', ${search})) DESC
+      LIMIT 50
+    `)
+    const ids = ftsResult.map(r => r.id)
+    if (ids.length === 0) return { data: [] }
+    conditions.push(inArray(schema.tasks.id, ids))
   }
 
   const tasks = await db.query.tasks.findMany({

package/server/bridge/adapters/imessage.ts

@@ -263,12 +263,19 @@ export class IMessageAdapter implements BridgeAdapter {
     }
 
     try {
+      // Format chatGuid if recipient is a bare phone number or email
+      const chatGuid = msg.recipient.includes(';')
+        ? msg.recipient
+        : `iMessage;-;${msg.recipient.startsWith('+') ? msg.recipient : `+${msg.recipient}`}`
+
       const resp = await fetch(`${this.bbUrl}/api/v1/message/text?password=${encodeURIComponent(this.bbPassword)}`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
-          chatGuid: msg.recipient,
-          message: msg.text
+          chatGuid,
+          tempGuid: `temp-${randomBytes(16).toString('hex')}`,
+          message: msg.text,
+          method: 'private-api'
         })
       })
 

package/server/drizzle/migrations/0016_full_text_search.sql

@@ -0,0 +1,127 @@
+-- Full-Text Search: Add tsvector columns, GIN indexes, and auto-update triggers
+-- This migration enables PostgreSQL full-text search across 5 tables.
+
+-- =============================================================================
+-- TASKS
+-- =============================================================================
+
+ALTER TABLE tasks ADD COLUMN search_vector tsvector;
+
+CREATE INDEX idx_tasks_search ON tasks USING GIN (search_vector);
+
+CREATE OR REPLACE FUNCTION tasks_search_vector_update() RETURNS trigger AS $$
+BEGIN
+  NEW.search_vector := to_tsvector('english',
+    coalesce(NEW.title, '') || ' ' || coalesce(NEW.description, '')
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER tasks_search_vector_trigger
+  BEFORE INSERT OR UPDATE OF title, description ON tasks
+  FOR EACH ROW EXECUTE FUNCTION tasks_search_vector_update();
+
+UPDATE tasks SET search_vector = to_tsvector('english',
+  coalesce(title, '') || ' ' || coalesce(description, '')
+);
+
+-- =============================================================================
+-- DOCUMENTS
+-- =============================================================================
+
+ALTER TABLE documents ADD COLUMN search_vector tsvector;
+
+CREATE INDEX idx_documents_search ON documents USING GIN (search_vector);
+
+CREATE OR REPLACE FUNCTION documents_search_vector_update() RETURNS trigger AS $$
+BEGIN
+  NEW.search_vector := to_tsvector('english',
+    coalesce(NEW.title, '') || ' ' || coalesce(NEW.content, '') || ' ' || coalesce(NEW.path, '')
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER documents_search_vector_trigger
+  BEFORE INSERT OR UPDATE OF title, content, path ON documents
+  FOR EACH ROW EXECUTE FUNCTION documents_search_vector_update();
+
+UPDATE documents SET search_vector = to_tsvector('english',
+  coalesce(title, '') || ' ' || coalesce(content, '') || ' ' || coalesce(path, '')
+);
+
+-- =============================================================================
+-- MEMORY CHUNKS
+-- =============================================================================
+
+ALTER TABLE memory_chunks ADD COLUMN search_vector tsvector;
+
+CREATE INDEX idx_memory_chunks_search ON memory_chunks USING GIN (search_vector);
+
+CREATE OR REPLACE FUNCTION memory_chunks_search_vector_update() RETURNS trigger AS $$
+BEGIN
+  NEW.search_vector := to_tsvector('english',
+    coalesce(NEW.content, '') || ' ' || coalesce(NEW.source_excerpt, '')
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER memory_chunks_search_vector_trigger
+  BEFORE INSERT OR UPDATE OF content, source_excerpt ON memory_chunks
+  FOR EACH ROW EXECUTE FUNCTION memory_chunks_search_vector_update();
+
+UPDATE memory_chunks SET search_vector = to_tsvector('english',
+  coalesce(content, '') || ' ' || coalesce(source_excerpt, '')
+);
+
+-- =============================================================================
+-- CRON AGENTS
+-- =============================================================================
+
+ALTER TABLE cron_agents ADD COLUMN search_vector tsvector;
+
+CREATE INDEX idx_cron_agents_search ON cron_agents USING GIN (search_vector);
+
+CREATE OR REPLACE FUNCTION cron_agents_search_vector_update() RETURNS trigger AS $$
+BEGIN
+  NEW.search_vector := to_tsvector('english',
+    coalesce(NEW.name, '') || ' ' || coalesce(NEW.description, '') || ' ' || coalesce(NEW.prompt, '')
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER cron_agents_search_vector_trigger
+  BEFORE INSERT OR UPDATE OF name, description, prompt ON cron_agents
+  FOR EACH ROW EXECUTE FUNCTION cron_agents_search_vector_update();
+
+UPDATE cron_agents SET search_vector = to_tsvector('english',
+  coalesce(name, '') || ' ' || coalesce(description, '') || ' ' || coalesce(prompt, '')
+);
+
+-- =============================================================================
+-- CONVERSATIONS
+-- =============================================================================
+
+ALTER TABLE conversations ADD COLUMN search_vector tsvector;
+
+CREATE INDEX idx_conversations_search ON conversations USING GIN (search_vector);
+
+CREATE OR REPLACE FUNCTION conversations_search_vector_update() RETURNS trigger AS $$
+BEGIN
+  NEW.search_vector := to_tsvector('english',
+    coalesce(NEW.title, '') || ' ' || coalesce(NEW.summary, '')
+  );
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER conversations_search_vector_trigger
+  BEFORE INSERT OR UPDATE OF title, summary ON conversations
+  FOR EACH ROW EXECUTE FUNCTION conversations_search_vector_update();
+
+UPDATE conversations SET search_vector = to_tsvector('english',
+  coalesce(title, '') || ' ' || coalesce(summary, '')
+);

package/server/drizzle/migrations/meta/_journal.json

@@ -113,6 +113,13 @@
       "when": 1771736174854,
       "tag": "0015_great_mephistopheles",
       "breakpoints": true
+    },
+    {
+      "idx": 16,
+      "version": "7",
+      "when": 1772006400000,
+      "tag": "0016_full_text_search",
+      "breakpoints": true
     }
   ]
 }

package/server/routes/_ws/chat.ts

@@ -4,7 +4,8 @@ import { chatSessionManager } from '~~/server/utils/chat-session-manager'
 import { getDb } from '~~/server/db'
 import * as schema from '~~/server/db/schema'
 import { logTokenUsage } from '~~/server/utils/log-token-usage'
-import type { ChatClientMessage, ChatContentBlock } from '~~/shared/types'
+import type { ChatClientMessage, ChatContentBlock, ChatImageBlock, ChatDocumentBlock } from '~~/shared/types'
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources/messages/messages'
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function send(peer: any, data: object) {
@@ -16,6 +17,42 @@ function send(peer: any, data: object) {
   }
 }
 
+function buildSdkContent(
+  message: string,
+  attachments?: ChatImageBlock[],
+  documents?: ChatDocumentBlock[]
+): string | ContentBlockParam[] {
+  if (!attachments?.length && !documents?.length) return message
+
+  const blocks: ContentBlockParam[] = []
+
+  if (attachments?.length) {
+    for (const img of attachments) {
+      blocks.push({
+        type: 'image',
+        source: {
+          type: 'base64',
+          media_type: img.source.media_type,
+          data: img.source.data
+        }
+      })
+    }
+  }
+
+  if (documents?.length) {
+    for (const doc of documents) {
+      blocks.push({
+        type: 'document',
+        source: doc.source,
+        title: doc.title
+      })
+    }
+  }
+
+  if (message) blocks.push({ type: 'text', text: message })
+  return blocks
+}
+
 export default defineWebSocketHandler({
   open(peer) {
     console.log(`[chat] WebSocket opened: ${peer.id}`)
@@ -28,7 +65,7 @@ export default defineWebSocketHandler({
 
       switch (msg.type) {
         case 'chat:send':
-          handleSend(peer, msg.message, msg.conversationId)
+          handleSend(peer, msg.message, msg.conversationId, msg.attachments, msg.documents)
           break
         case 'chat:interrupt':
           handleInterrupt(peer, msg.conversationId)
@@ -49,8 +86,14 @@ export default defineWebSocketHandler({
   }
 })
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-async function handleSend(peer: any, message: string, conversationId?: string) {
+async function handleSend(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  peer: any,
+  message: string,
+  conversationId?: string,
+  attachments?: ChatImageBlock[],
+  documents?: ChatDocumentBlock[]
+) {
   const db = getDb()
 
   let convId = conversationId
@@ -61,7 +104,7 @@ async function handleSend(peer: any, message: string, conversationId?: string) {
     const [conv] = await db.insert(schema.conversations)
       .values({
         sessionId: randomUUID(),
-        title: message.slice(0, 100),
+        title: message.slice(0, 100) || 'File attachment',
         status: 'streaming',
         messageCount: 0,
         totalCostUsd: 0
@@ -93,16 +136,27 @@ async function handleSend(peer: any, message: string, conversationId?: string) {
       .where(eq(schema.conversations.id, convId))
   }
 
+  // Build content blocks for persistence
+  const userContent: ChatContentBlock[] = []
+  if (attachments?.length)
+    for (const img of attachments) userContent.push(img)
+  if (documents?.length)
+    for (const doc of documents) userContent.push(doc)
+  if (message) userContent.push({ type: 'text', text: message })
+
   // Persist user message
   await db.insert(schema.conversationMessages).values({
     conversationId: convId,
     role: 'user',
-    content: JSON.stringify([{ type: 'text', text: message }]),
+    content: JSON.stringify(userContent),
     source: 'web'
   })
 
+  // Build prompt for SDK (string for text-only, ContentBlockParam[] for multimodal)
+  const prompt = buildSdkContent(message, attachments, documents)
+
   // Start SDK streaming (fire-and-forget so WS stays responsive for interrupts)
-  const session = chatSessionManager.startSession(convId, message, resumeSessionId)
+  const session = chatSessionManager.startSession(convId, prompt, resumeSessionId)
   send(peer, { type: 'chat:stream_start', conversationId: convId })
 
   streamSDKResponse(peer, session, convId).catch((err) => {

package/server/utils/chat-session-manager.ts

@@ -1,4 +1,8 @@
 import { query } from '@anthropic-ai/claude-agent-sdk'
+import type { SDKUserMessage } from '@anthropic-ai/claude-agent-sdk'
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources/messages/messages'
+
+export type PromptInput = string | ContentBlockParam[]
 
 interface ActiveSession {
   conversationId: string
@@ -8,15 +12,29 @@ interface ActiveSession {
   startedAt: Date
 }
 
+async function* createMultimodalPrompt(content: ContentBlockParam[]): AsyncGenerator<SDKUserMessage> {
+  yield {
+    type: 'user',
+    message: { role: 'user', content },
+    parent_tool_use_id: null,
+    session_id: ''
+  } as SDKUserMessage
+}
+
 class ChatSessionManager {
   private sessions = new Map<string, ActiveSession>()
 
-  startSession(conversationId: string, prompt: string, resumeSessionId?: string): ActiveSession {
+  startSession(conversationId: string, prompt: PromptInput, resumeSessionId?: string): ActiveSession {
     // Use the project directory as CWD so the SDK picks up .claude/ (skills, rules, CLAUDE.md)
     // The vault is accessible via VAULT_PATH env var in tools
     const projectDir = process.env.COGNOVA_PROJECT_DIR || process.cwd()
+
+    const promptArg = typeof prompt === 'string'
+      ? prompt
+      : createMultimodalPrompt(prompt)
+
     const conversation = query({
-      prompt,
+      prompt: promptArg,
       options: {
         cwd: projectDir,
         settingSources: ['user', 'project'],

package/shared/types/index.ts

@@ -207,10 +207,16 @@ export interface PublicDocumentResponse {
 
 export interface Conversation {
   id: string
+  sessionId: string
+  sdkSessionId?: string
+  title?: string
+  summary?: string
+  status: 'idle' | 'streaming' | 'interrupted' | 'error'
+  totalCostUsd: number
+  isMain: boolean
   startedAt: Date
   endedAt?: Date
   messageCount: number
-  summary?: string
 }
 
 export interface ConversationDetail extends Conversation {
@@ -689,7 +695,31 @@ export interface ChatToolResultBlock {
   is_error?: boolean
 }
 
-export type ChatContentBlock = ChatTextBlock | ChatToolUseBlock | ChatToolResultBlock
+export type ChatImageMediaType = 'image/jpeg' | 'image/png' | 'image/gif' | 'image/webp'
+
+export interface ChatImageBlock {
+  type: 'image'
+  source: {
+    type: 'base64'
+    media_type: ChatImageMediaType
+    data: string
+  }
+}
+
+export interface ChatDocumentBlock {
+  type: 'document'
+  source:
+    | { type: 'base64', media_type: 'application/pdf', data: string }
+    | { type: 'text', media_type: 'text/plain', data: string }
+  title?: string
+}
+
+export type ChatContentBlock
+  = ChatTextBlock
+    | ChatImageBlock
+    | ChatDocumentBlock
+    | ChatToolUseBlock
+    | ChatToolResultBlock
 
 export type MessageSource = 'web' | 'telegram' | 'discord' | 'imessage' | 'email' | 'google'
 
@@ -724,6 +754,8 @@ export interface ChatConversation {
 export interface ChatSendMessage {
   type: 'chat:send'
   message: string
+  attachments?: ChatImageBlock[]
+  documents?: ChatDocumentBlock[]
   conversationId?: string
 }