cognova 0.1.0

package/server/utils/pty-manager.ts

@@ -0,0 +1,130 @@
+import { createRequire } from 'module'
+import { resolve } from 'path'
+import type { IPty } from 'node-pty'
+import { getVaultRoot } from './path-validator'
+
+// Use createRequire for node-pty to avoid ESM issues with native modules
+// For bundled builds, we need to resolve from a known location
+const requireFromCwd = createRequire(resolve(process.cwd(), 'package.json'))
+const pty = requireFromCwd('node-pty')
+
+interface PtySession {
+  pty: IPty
+  outputBuffer: string[]
+  maxBufferSize: number
+  lastActivity: number
+}
+
+const sessions = new Map<string, PtySession>()
+const MAX_BUFFER_SIZE = 10000 // Lines to keep in buffer
+const SESSION_TIMEOUT = 30 * 60 * 1000 // 30 minutes
+
+export function createPtySession(sessionId: string, cols = 80, rows = 24): IPty {
+  const shell = process.env.SHELL || '/bin/bash'
+  const cwd = getVaultRoot()
+
+  console.log(`[PTY] Creating session: shell=${shell}, cwd=${cwd}, cols=${cols}, rows=${rows}`)
+
+  const ptyProcess = pty.spawn(shell, [], {
+    name: 'xterm-256color',
+    cols,
+    rows,
+    cwd,
+    env: {
+      ...process.env,
+      TERM: 'xterm-256color',
+      COLORTERM: 'truecolor'
+    }
+  }) as IPty
+
+  const session: PtySession = {
+    pty: ptyProcess,
+    outputBuffer: [],
+    maxBufferSize: MAX_BUFFER_SIZE,
+    lastActivity: Date.now()
+  }
+
+  // Buffer output for replay on reconnect
+  ptyProcess.onData((data: string) => {
+    session.lastActivity = Date.now()
+    session.outputBuffer.push(data)
+
+    // Trim buffer if too large
+    if (session.outputBuffer.length > session.maxBufferSize) {
+      session.outputBuffer = session.outputBuffer.slice(-session.maxBufferSize / 2)
+    }
+  })
+
+  ptyProcess.onExit(() => {
+    sessions.delete(sessionId)
+  })
+
+  sessions.set(sessionId, session)
+  return ptyProcess
+}
+
+export function getPtySession(sessionId: string): PtySession | undefined {
+  const session = sessions.get(sessionId)
+  if (session) {
+    session.lastActivity = Date.now()
+  }
+  return session
+}
+
+export function getOrCreatePtySession(sessionId: string, cols = 80, rows = 24): { pty: IPty, isNew: boolean } {
+  const existing = sessions.get(sessionId)
+  if (existing) {
+    existing.lastActivity = Date.now()
+    return { pty: existing.pty, isNew: false }
+  }
+
+  const pty = createPtySession(sessionId, cols, rows)
+  return { pty, isNew: true }
+}
+
+export function getOutputBuffer(sessionId: string): string[] {
+  const session = sessions.get(sessionId)
+  return session?.outputBuffer || []
+}
+
+export function resizePty(sessionId: string, cols: number, rows: number): boolean {
+  const session = sessions.get(sessionId)
+  if (session) {
+    session.pty.resize(cols, rows)
+    session.lastActivity = Date.now()
+    return true
+  }
+  return false
+}
+
+export function writeToPty(sessionId: string, data: string): boolean {
+  const session = sessions.get(sessionId)
+  if (session) {
+    session.pty.write(data)
+    session.lastActivity = Date.now()
+    return true
+  }
+  return false
+}
+
+export function destroyPtySession(sessionId: string): boolean {
+  const session = sessions.get(sessionId)
+  if (session) {
+    session.pty.kill()
+    sessions.delete(sessionId)
+    return true
+  }
+  return false
+}
+
+// Cleanup inactive sessions periodically
+setInterval(() => {
+  const now = Date.now()
+  for (const [sessionId, session] of sessions) {
+    if (now - session.lastActivity > SESSION_TIMEOUT) {
+      console.log(`Cleaning up inactive PTY session: ${sessionId}`)
+      session.pty.kill()
+      sessions.delete(sessionId)
+    }
+  }
+}, 60000) // Check every minute

package/shared/types/index.ts

@@ -0,0 +1,604 @@
+// === Users ===
+
+export interface User {
+  id: string
+  name: string
+  email: string
+  image?: string
+}
+
+// === Projects ===
+
+export interface Project {
+  id: string
+  name: string
+  color: string
+  description?: string
+  createdAt: Date
+  modifiedAt?: Date
+  deletedAt?: Date
+  createdBy?: string
+  modifiedBy?: string
+  deletedBy?: string
+  creator?: User
+}
+
+export interface CreateProjectInput {
+  name: string
+  color: string
+  description?: string
+}
+
+export interface UpdateProjectInput {
+  name?: string
+  color?: string
+  description?: string
+}
+
+// === Tasks ===
+
+export type TaskStatus = 'todo' | 'in_progress' | 'done' | 'blocked'
+
+export interface Task {
+  id: string
+  title: string
+  description?: string
+  status: TaskStatus
+  priority: number // 1=Low, 2=Medium, 3=High
+  projectId?: string
+  project?: Project // Populated on fetch
+  dueDate?: Date
+  tags: string[]
+  createdAt: Date
+  modifiedAt?: Date
+  completedAt?: Date
+  deletedAt?: Date
+  createdBy?: string
+  modifiedBy?: string
+  deletedBy?: string
+  creator?: User // Populated on fetch
+}
+
+export interface CreateTaskInput {
+  title: string
+  description?: string
+  status?: TaskStatus
+  priority?: number // 1-3, defaults to 2
+  projectId?: string
+  dueDate?: string
+  tags?: string[]
+}
+
+export interface UpdateTaskInput {
+  title?: string
+  description?: string
+  status?: TaskStatus
+  priority?: number
+  projectId?: string | null
+  dueDate?: string | null
+  tags?: string[]
+}
+
+export interface TaskFilters {
+  status?: TaskStatus | TaskStatus[]
+  projectId?: string
+  search?: string
+  includeDeleted?: boolean
+}
+
+// === Reminders ===
+
+export interface Reminder {
+  id: string
+  taskId?: string
+  message: string
+  remindAt: Date
+  notified: boolean
+  createdAt: Date
+}
+
+// === Files ===
+
+export interface FileEntry {
+  name: string
+  path: string
+  type: 'file' | 'directory'
+  size?: number
+  modifiedAt?: Date
+  children?: FileEntry[]
+}
+
+export interface FileContent {
+  path: string
+  content: string
+  modifiedAt: Date
+}
+
+// === Documents ===
+
+export type ShareType = 'public' | 'private'
+export type FileType = 'markdown' | 'text' | 'binary'
+
+export type CodeLanguage
+  = 'markdown'
+    | 'javascript'
+    | 'typescript'
+    | 'json'
+    | 'html'
+    | 'css'
+    | 'vue'
+    | 'python'
+    | 'sql'
+    | 'yaml'
+    | 'bash'
+    | 'go'
+    | 'rust'
+    | 'dockerfile'
+    | 'java'
+    | 'cpp'
+    | 'xml'
+    | 'plaintext'
+
+export interface Document {
+  id: string
+  title: string
+  path: string
+  content?: string
+  contentHash?: string
+  tags: string[]
+  projectId?: string
+  project?: Project
+  shared: boolean
+  shareType?: ShareType
+  fileType: FileType
+  mimeType?: string
+  syncedAt?: Date
+  createdAt: Date
+  createdBy?: string
+  creator?: User
+  modifiedAt?: Date
+  modifiedBy?: string
+  deletedAt?: Date
+  deletedBy?: string
+}
+
+export interface DocumentMetadata {
+  title: string
+  tags: string[]
+  projectId?: string
+  shared: boolean
+  shareType?: ShareType
+  [key: string]: unknown
+}
+
+export interface DocumentWithContent {
+  document: Document
+  metadata: DocumentMetadata
+  body: string
+}
+
+export interface UpdateDocumentInput {
+  title?: string
+  tags?: string[]
+  projectId?: string | null
+  shared?: boolean
+  shareType?: ShareType | null
+  body?: string
+}
+
+// TOC types for MDC parseMarkdown output
+export interface TocLink {
+  id: string
+  text: string
+  depth: number
+  children?: TocLink[]
+}
+
+// Public document viewer API response
+export interface PublicDocumentResponse {
+  document: Pick<Document, 'id' | 'title' | 'path' | 'fileType' | 'shared' | 'shareType' | 'tags' | 'createdAt' | 'modifiedAt'> & {
+    creatorName: string | null
+  }
+  content: string | null
+  isOwner: boolean
+}
+
+// === Conversations ===
+
+export interface Conversation {
+  id: string
+  startedAt: Date
+  endedAt?: Date
+  messageCount: number
+  summary?: string
+}
+
+export interface ConversationDetail extends Conversation {
+  messages: ConversationMessage[]
+}
+
+export interface ConversationMessage {
+  role: 'user' | 'assistant'
+  content: string
+  timestamp: Date
+}
+
+// === API ===
+
+export interface ApiResponse<T> {
+  data?: T
+  error?: string
+}
+
+// === Editor ===
+
+export type SaveStatus = 'idle' | 'saving' | 'saved' | 'error'
+
+// === Cron Agents ===
+
+export type AgentStatus = 'success' | 'error' | 'budget_exceeded' | 'cancelled'
+export type RunStatus = 'running' | 'success' | 'error' | 'budget_exceeded' | 'cancelled'
+
+export interface CronAgent {
+  id: string
+  name: string
+  description?: string
+  schedule: string
+  prompt: string
+  enabled: boolean
+  maxTurns?: number
+  maxBudgetUsd?: number
+  lastRunAt?: Date
+  lastStatus?: AgentStatus
+  createdAt: Date
+  updatedAt: Date
+  createdBy?: string
+  creator?: User
+}
+
+export interface CronAgentRun {
+  id: string
+  agentId: string
+  status: RunStatus
+  output?: string
+  error?: string
+  costUsd?: number
+  inputTokens?: number
+  outputTokens?: number
+  numTurns?: number
+  startedAt: Date
+  completedAt?: Date
+  durationMs?: number
+}
+
+export interface CreateAgentInput {
+  name: string
+  description?: string
+  schedule: string
+  prompt: string
+  enabled?: boolean
+  maxTurns?: number
+  maxBudgetUsd?: number
+}
+
+export interface UpdateAgentInput {
+  name?: string
+  description?: string
+  schedule?: string
+  prompt?: string
+  enabled?: boolean
+  maxTurns?: number
+  maxBudgetUsd?: number | null
+}
+
+// === Notification Bus ===
+
+export type NotificationType
+  = 'agent:started'
+    | 'agent:completed'
+    | 'agent:failed'
+    | 'toast'
+
+export interface NotificationPayload {
+  type: NotificationType
+  agentId?: string
+  agentName?: string
+  runId?: string
+  status?: string
+  message?: string
+  title?: string
+  color?: 'success' | 'error' | 'warning' | 'info'
+  timestamp?: string
+}
+
+// === Agent Stats ===
+
+export type StatsPeriod = '24h' | '7d' | '30d'
+
+export interface DailyRunData {
+  date: string
+  success: number
+  error: number
+  total: number
+  costUsd: number
+}
+
+export interface AgentGlobalStats {
+  totalAgents: number
+  activeAgents: number
+  runsInPeriod: number
+  successRate: number
+  totalCostUsd: number
+  runningAgentIds: string[]
+  dailyRuns: DailyRunData[]
+}
+
+export interface AgentDetailStats {
+  totalRuns: number
+  successRate: number
+  avgDurationMs: number
+  totalCostUsd: number
+  lastRunAt: string | null
+  dailyRuns: DailyRunData[]
+}
+
+// === Hook Events ===
+
+export type HookEventType
+  = | 'SessionStart'
+    | 'SessionEnd'
+    | 'PreToolUse'
+    | 'PostToolUse'
+    | 'PostToolUseFailure'
+    | 'UserPromptSubmit'
+
+export interface HookEvent {
+  id: string
+  eventType: HookEventType
+  sessionId?: string
+  projectDir?: string
+  toolName?: string
+  toolMatcher?: string
+  eventData?: Record<string, unknown>
+  exitCode?: number
+  blocked: boolean
+  blockReason?: string
+  durationMs?: number
+  hookScript?: string
+  createdAt: Date
+}
+
+export interface CreateHookEventInput {
+  eventType: HookEventType
+  sessionId?: string
+  projectDir?: string
+  toolName?: string
+  toolMatcher?: string
+  eventData?: Record<string, unknown>
+  exitCode?: number
+  blocked?: boolean
+  blockReason?: string
+  durationMs?: number
+  hookScript?: string
+}
+
+export interface HookEventFilters {
+  eventType?: HookEventType | HookEventType[]
+  sessionId?: string
+  toolName?: string
+  blocked?: boolean | string // Query params can be string 'true'/'false'
+  since?: string
+  limit?: number
+}
+
+// === Hook Analytics Stats ===
+
+export interface HookDailyData {
+  date: string
+  total: number
+  blocked: number
+  allowed: number
+  avgDurationMs: number
+}
+
+export interface HookToolBreakdown {
+  toolName: string
+  total: number
+  blocked: number
+  avgDurationMs: number
+}
+
+export interface HookEventStats {
+  totalEvents: number
+  blockedEvents: number
+  blockRate: number
+  avgDurationMs: number
+  eventsByType: Partial<Record<HookEventType, number>>
+  toolBreakdown: HookToolBreakdown[]
+  dailyActivity: HookDailyData[]
+  recentSessions: string[]
+}
+
+// === Memory System ===
+
+export type MemoryChunkType
+  = | 'decision'
+    | 'fact'
+    | 'solution'
+    | 'pattern'
+    | 'preference'
+    | 'summary'
+
+export interface MemoryChunk {
+  id: string
+  sessionId?: string
+  projectPath?: string
+  chunkType: MemoryChunkType
+  content: string
+  sourceExcerpt?: string
+  relevanceScore: number
+  accessCount: number
+  lastAccessedAt?: Date
+  createdAt: Date
+  expiresAt?: Date
+}
+
+export interface CreateMemoryInput {
+  sessionId?: string
+  projectPath?: string
+  chunkType: MemoryChunkType
+  content: string
+  sourceExcerpt?: string
+  relevanceScore?: number
+}
+
+export interface MemorySearchFilters {
+  query?: string
+  projectPath?: string
+  chunkType?: MemoryChunkType | MemoryChunkType[]
+  minRelevance?: number
+  limit?: number
+}
+
+export interface ExtractMemoryInput {
+  transcript: string
+  sessionId?: string
+  projectPath?: string
+}
+
+export interface ExtractedMemory {
+  type: MemoryChunkType
+  content: string
+  relevance: number
+}
+
+export interface MemoryContextResponse {
+  memories: MemoryChunk[]
+  formatted: string
+}
+
+// === Chat System ===
+
+export type ChatSessionStatus = 'idle' | 'streaming' | 'interrupted' | 'error'
+export type ChatConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error'
+
+// Content blocks (maps to SDK content structure)
+export interface ChatTextBlock {
+  type: 'text'
+  text: string
+}
+
+export interface ChatToolUseBlock {
+  type: 'tool_use'
+  id: string
+  name: string
+  input: Record<string, unknown>
+}
+
+export interface ChatToolResultBlock {
+  type: 'tool_result'
+  tool_use_id: string
+  content: string
+  is_error?: boolean
+}
+
+export type ChatContentBlock = ChatTextBlock | ChatToolUseBlock | ChatToolResultBlock
+
+// Persisted message
+export interface ChatMessage {
+  id: string
+  conversationId: string
+  role: 'user' | 'assistant'
+  content: ChatContentBlock[]
+  costUsd?: number
+  durationMs?: number
+  createdAt: Date
+}
+
+// Conversation metadata
+export interface ChatConversation {
+  id: string
+  sessionId: string
+  sdkSessionId?: string
+  title?: string
+  summary?: string
+  status: ChatSessionStatus
+  totalCostUsd: number
+  messageCount: number
+  startedAt: Date
+  endedAt?: Date
+}
+
+// WebSocket protocol: Client -> Server
+export interface ChatSendMessage {
+  type: 'chat:send'
+  message: string
+  conversationId?: string
+}
+
+export interface ChatInterruptMessage {
+  type: 'chat:interrupt'
+  conversationId: string
+}
+
+export type ChatClientMessage = ChatSendMessage | ChatInterruptMessage
+
+// WebSocket protocol: Server -> Client
+export interface ChatSessionCreated {
+  type: 'chat:session_created'
+  conversationId: string
+}
+
+export interface ChatStreamStart {
+  type: 'chat:stream_start'
+  conversationId: string
+}
+
+export interface ChatTextDelta {
+  type: 'chat:text_delta'
+  conversationId: string
+  delta: string
+}
+
+export interface ChatToolStart {
+  type: 'chat:tool_start'
+  conversationId: string
+  toolUseId: string
+  toolName: string
+}
+
+export interface ChatToolEnd {
+  type: 'chat:tool_end'
+  conversationId: string
+  toolUseId: string
+  result: string
+  isError: boolean
+}
+
+export interface ChatStreamEnd {
+  type: 'chat:stream_end'
+  conversationId: string
+  costUsd: number
+  durationMs: number
+}
+
+export interface ChatError {
+  type: 'chat:error'
+  conversationId?: string
+  message: string
+}
+
+export interface ChatInterrupted {
+  type: 'chat:interrupted'
+  conversationId: string
+}
+
+export type ChatServerMessage
+  = ChatSessionCreated
+    | ChatStreamStart
+    | ChatTextDelta
+    | ChatToolStart
+    | ChatToolEnd
+    | ChatStreamEnd
+    | ChatError
+    | ChatInterrupted