@sylphx/flow 1.8.0 → 1.8.1

package/src/utils/prompts.ts

@@ -1,120 +0,0 @@
-/**
- * Modern CLI prompts with progressive output
- */
-
-import { createInterface } from 'node:readline';
-import chalk from 'chalk';
-
-export async function ask(question: string, defaultValue?: string): Promise<string> {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  const prompt = defaultValue
-    ? `${chalk.cyan('❯')} ${question} ${chalk.gray(`(${defaultValue})`)}: `
-    : `${chalk.cyan('❯')} ${question}: `;
-
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      rl.close();
-      resolve(answer.trim() || defaultValue || '');
-    });
-  });
-}
-
-export async function askSecret(question: string): Promise<string> {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  const prompt = `${chalk.cyan('❯')} ${question}: `;
-
-  return new Promise((resolve) => {
-    // Hide input for secrets
-    const stdin = process.stdin;
-    const _onData = (char: Buffer) => {
-      const str = char.toString('utf8');
-      if (str === '\n' || str === '\r' || str === '\r\n') {
-        (stdin as any).removeListener('data', _onData);
-        process.stdout.write('\n');
-        rl.close();
-      } else {
-        process.stdout.write('•');
-      }
-    };
-
-    process.stdout.write(prompt);
-    let input = '';
-    stdin.on('data', (char) => {
-      const str = char.toString('utf8');
-      if (str === '\n' || str === '\r' || str === '\r\n') {
-        process.stdout.write('\n');
-        rl.close();
-        resolve(input);
-      } else if (str === '\x7f' || str === '\b') {
-        // Backspace
-        if (input.length > 0) {
-          input = input.slice(0, -1);
-          process.stdout.write('\b \b');
-        }
-      } else {
-        input += str;
-        process.stdout.write('•');
-      }
-    });
-    stdin.setRawMode(true);
-    stdin.resume();
-  }).finally(() => {
-    const stdin = process.stdin;
-    stdin.setRawMode(false);
-    stdin.pause();
-  });
-}
-
-export async function select<T extends string>(question: string, choices: T[]): Promise<T> {
-  console.log(`${chalk.cyan('❯')} ${question}`);
-  choices.forEach((choice, index) => {
-    console.log(chalk.gray(`  ${index + 1}. ${choice}`));
-  });
-
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  return new Promise((resolve) => {
-    rl.question(chalk.cyan(`  Select (1-${choices.length}): `), (answer) => {
-      rl.close();
-      const index = Number.parseInt(answer.trim(), 10) - 1;
-      if (index >= 0 && index < choices.length) {
-        resolve(choices[index]);
-      } else {
-        resolve(choices[0]);
-      }
-    });
-  });
-}
-
-export async function confirm(question: string, defaultValue = true): Promise<boolean> {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  const defaultText = defaultValue ? 'Y/n' : 'y/N';
-  const prompt = `${chalk.cyan('❯')} ${question} ${chalk.gray(`(${defaultText})`)}: `;
-
-  return new Promise((resolve) => {
-    rl.question(prompt, (answer) => {
-      rl.close();
-      const input = answer.trim().toLowerCase();
-      if (input) {
-        resolve(input === 'y' || input === 'yes');
-      } else {
-        resolve(defaultValue);
-      }
-    });
-  });
-}

package/src/utils/search-tool-builder.ts

@@ -1,214 +0,0 @@
-/**
- * Unified search tool builder
- * Creates consistent search and status tools for indexers
- */
-
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import type { BaseIndexer } from '../services/search/base-indexer.js';
-import { searchDocuments } from '../services/search/tfidf.js';
-
-export interface SearchToolConfig {
-  indexer: BaseIndexer;
-  toolName: string; // e.g., 'search_knowledge', 'search_codebase'
-  statusToolName: string; // e.g., 'get_knowledge_status', 'get_indexing_status'
-  description: string;
-  searchDescription: string;
-  examples: string[];
-}
-
-/**
- * Build search tool with consistent pattern
- */
-export function buildSearchTool(server: McpServer, config: SearchToolConfig) {
-  const { indexer, toolName, statusToolName, description, searchDescription } = config;
-
-  // Register search tool
-  server.registerTool(
-    toolName,
-    {
-      description: `${description}
-
-${searchDescription}
-
-**Performance:**
-- First search: ~1-5s (indexing time)
-- Subsequent searches: <100ms (cached)
-- Background indexing: Starts automatically on server startup
-
-**Status:**
-- Use \`${statusToolName}\` to check indexing progress
-- If indexing in progress, returns progress message`,
-      inputSchema: {
-        query: z.string().describe('Search query'),
-        limit: z.number().optional().describe('Maximum results (default: 5, max: 20)'),
-        categories: z.array(z.string()).optional().describe('Filter by categories (optional)'),
-      },
-    },
-    async (args) => {
-      try {
-        const query = args.query as string;
-        const limit = Math.min((args.limit as number) || 5, 20);
-        const categories = args.categories as string[] | undefined;
-
-        // Check if indexing is in progress
-        const status = indexer.getStatus();
-        if (status.isIndexing) {
-          const elapsed = Math.round((Date.now() - status.startTime) / 1000);
-          return {
-            content: [
-              {
-                type: 'text',
-                text: `⏳ Indexing in progress...\n\n**Status:**\n- Progress: ${status.progress}%\n- Items indexed: ${status.indexedItems}/${status.totalItems}\n- Elapsed time: ${elapsed}s\n\n*Please wait and try again. Use \`${statusToolName}\` to check progress.*`,
-              },
-            ],
-          };
-        }
-
-        // Check for errors
-        if (status.error) {
-          return {
-            content: [
-              {
-                type: 'text',
-                text: `✗ Indexing failed: ${status.error}\n\nPlease check the error and try again.`,
-              },
-            ],
-            isError: true,
-          };
-        }
-
-        // Perform search
-        const startTime = Date.now();
-        const index = await indexer.loadIndex();
-        const indexTime = Date.now() - startTime;
-
-        const searchStartTime = Date.now();
-        const results = searchDocuments(query, index, {
-          limit: limit * 2,
-          minScore: 0.01,
-        });
-        const searchTime = Date.now() - searchStartTime;
-
-        // Filter by categories if specified
-        let filtered = results;
-        if (categories && categories.length > 0) {
-          filtered = results.filter((result) => {
-            // Extract scheme/protocol from URI (e.g., 'knowledge' from 'knowledge://path')
-            const category = result.uri.split('://')[0];
-            return categories.includes(category);
-          });
-        }
-
-        const finalResults = filtered.slice(0, limit);
-
-        if (finalResults.length === 0) {
-          return {
-            content: [
-              {
-                type: 'text',
-                text: `No results found for query: "${query}"\n\nTry:\n- Broader search terms\n- Different keywords\n- Check available categories`,
-              },
-            ],
-          };
-        }
-
-        // Build response
-        const resultTexts = finalResults.map((item, index) => {
-          const filePath = item.uri.replace(/^(knowledge|file):\/\//, '');
-          let text = `## ${index + 1}. ${filePath}\n`;
-          text += `**Relevance**: ${(item.score * 100).toFixed(0)}%\n`;
-          text += `**Matched terms**: ${item.matchedTerms.join(', ')}\n\n`;
-          return text;
-        });
-
-        const summary = `Found ${finalResults.length} result(s) for "${query}":\n\n`;
-        const stats = `\n---\n\n**Stats:**\n- Total items: ${index.totalDocuments}\n- Index time: ${indexTime}ms\n- Search time: ${searchTime}ms\n`;
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: summary + resultTexts.join('\n---\n\n') + stats,
-            },
-          ],
-        };
-      } catch (error: unknown) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error(`[ERROR] ${toolName} failed:`, error);
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `✗ Search error: ${errorMessage}`,
-            },
-          ],
-          isError: true,
-        };
-      }
-    }
-  );
-
-  // Register status tool
-  server.registerTool(
-    statusToolName,
-    {
-      description: `Get indexing status for ${toolName}.
-
-Shows:
-- Whether indexing is in progress
-- Progress percentage
-- Number of items indexed
-- Any errors`,
-      inputSchema: {},
-    },
-    async () => {
-      const status = indexer.getStatus();
-
-      if (status.isIndexing) {
-        const elapsed = Math.round((Date.now() - status.startTime) / 1000);
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `⏳ **Indexing in Progress**\n\n- Progress: ${status.progress}%\n- Items indexed: ${status.indexedItems}/${status.totalItems}\n- Elapsed time: ${elapsed}s`,
-            },
-          ],
-        };
-      }
-
-      if (status.error) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `✗ **Indexing Failed**\n\nError: ${status.error}`,
-            },
-          ],
-          isError: true,
-        };
-      }
-
-      if (indexer.isReady()) {
-        const stats = await indexer.getStats();
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `✓ **Index Ready**\n\n- Total items: ${stats?.totalDocuments || 0}\n- Unique terms: ${stats?.uniqueTerms || 0}\n- Status: Ready for search`,
-            },
-          ],
-        };
-      }
-
-      return {
-        content: [
-          {
-            type: 'text',
-            text: '⚠️ **Not Indexed**\n\nIndexing will start automatically on first search.',
-          },
-        ],
-      };
-    }
-  );
-}

package/src/utils/session-manager.ts

@@ -1,168 +0,0 @@
-/**
- * Session Manager
- * Manage chat sessions for headless mode
- */
-
-import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-import type { ProviderId } from '../config/ai-config.js';
-import type { Session } from '../types/session.types.js';
-
-export type { Session } from '../types/session.types.js';
-
-const SESSION_DIR = join(homedir(), '.sylphx', 'sessions');
-const LAST_SESSION_FILE = join(SESSION_DIR, '.last-session');
-
-/**
- * Ensure session directory exists
- */
-async function ensureSessionDir(): Promise<void> {
-  await mkdir(SESSION_DIR, { recursive: true });
-}
-
-/**
- * Get session file path
- */
-function getSessionPath(sessionId: string): string {
-  return join(SESSION_DIR, `${sessionId}.json`);
-}
-
-/**
- * Create new session
- */
-export async function createSession(provider: ProviderId, model: string): Promise<Session> {
-  await ensureSessionDir();
-
-  const session: Session = {
-    id: `session-${Date.now()}`,
-    provider,
-    model,
-    messages: [],
-    todos: [],        // Initialize empty todos
-    nextTodoId: 1,    // Start from 1
-    created: Date.now(),
-    updated: Date.now(),
-  };
-
-  await saveSession(session);
-  await setLastSession(session.id);
-
-  return session;
-}
-
-/**
- * Save session to file
- */
-export async function saveSession(session: Session): Promise<void> {
-  await ensureSessionDir();
-  // Create a new object with updated timestamp (don't mutate readonly session from Zustand)
-  const sessionToSave = {
-    ...session,
-    updated: Date.now(),
-  };
-  const path = getSessionPath(session.id);
-  // Use compact JSON format for faster serialization and smaller file size
-  await writeFile(path, JSON.stringify(sessionToSave), 'utf8');
-}
-
-/**
- * Load session from file with migration support
- * Automatically adds missing fields from newer schema versions
- */
-export async function loadSession(sessionId: string): Promise<Session | null> {
-  try {
-    const path = getSessionPath(sessionId);
-    const content = await readFile(path, 'utf8');
-    const rawSession = JSON.parse(content) as any;
-
-    // Migration: Add todos/nextTodoId if missing
-    if (!rawSession.todos) {
-      rawSession.todos = [];
-    }
-    if (typeof rawSession.nextTodoId !== 'number') {
-      rawSession.nextTodoId = 1;
-    }
-
-    // Migration: Normalize message content format
-    // Old: { content: string }
-    // New: { content: MessagePart[] }
-    if (Array.isArray(rawSession.messages)) {
-      rawSession.messages = rawSession.messages.map((msg: any) => {
-        if (typeof msg.content === 'string') {
-          return {
-            ...msg,
-            content: [{ type: 'text', content: msg.content }],
-          };
-        }
-        return msg;
-      });
-    }
-
-    return rawSession as Session;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Get last session ID
- */
-export async function getLastSessionId(): Promise<string | null> {
-  try {
-    const content = await readFile(LAST_SESSION_FILE, 'utf8');
-    return content.trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Set last session ID
- */
-export async function setLastSession(sessionId: string): Promise<void> {
-  await ensureSessionDir();
-  await writeFile(LAST_SESSION_FILE, sessionId, 'utf8');
-}
-
-/**
- * Load last session
- */
-export async function loadLastSession(): Promise<Session | null> {
-  const sessionId = await getLastSessionId();
-  if (!sessionId) return null;
-  return loadSession(sessionId);
-}
-
-/**
- * Add message to session (in-memory helper for headless mode)
- * Converts string content to MessagePart[] format
- */
-export function addMessage(
-  session: Session,
-  role: 'user' | 'assistant',
-  content: string
-): Session {
-  return {
-    ...session,
-    messages: [
-      ...session.messages,
-      {
-        role,
-        content: [{ type: 'text', content }], // Convert to MessagePart[]
-        timestamp: Date.now(),
-      },
-    ],
-  };
-}
-
-/**
- * Clear session messages but keep metadata
- */
-export function clearSessionMessages(session: Session): Session {
-  return {
-    ...session,
-    messages: [],
-    updated: Date.now(),
-  };
-}

package/src/utils/session-title.ts

@@ -1,87 +0,0 @@
-/**
- * Session Title Generation Utility
- * Re-exports pure functions from feature and adds streaming functionality
- */
-
-import { createAIStream } from '../core/ai-sdk.js';
-import type { ProviderId } from '../types/config.types.js';
-
-// Re-export pure functions from feature
-export {
-  generateSessionTitle,
-  formatSessionDisplay,
-  formatRelativeTime,
-  cleanTitle,
-  truncateTitle,
-} from '../features/session/utils/title.js';
-
-/**
- * Generate a session title using LLM with streaming
- */
-export async function generateSessionTitleWithStreaming(
-  firstMessage: string,
-  provider: ProviderId,
-  modelName: string,
-  providerConfig: any,
-  onChunk: (chunk: string) => void
-): Promise<string> {
-  if (!firstMessage || firstMessage.trim().length === 0) {
-    return 'New Chat';
-  }
-
-  try {
-    // Get the provider instance and create the model
-    const { getProvider } = await import('../providers/index.js');
-    const providerInstance = getProvider(provider);
-    const model = providerInstance.createClient(providerConfig, modelName);
-
-    const streamGenerator = createAIStream({
-      model,
-      messages: [
-        {
-          role: 'user',
-          content: `You need to generate a SHORT, DESCRIPTIVE title (maximum 50 characters) for a chat conversation.
-
-User's first message: "${firstMessage}"
-
-Requirements:
-- Summarize the TOPIC or INTENT, don't just copy the message
-- Be concise and descriptive
-- Maximum 50 characters
-- Output ONLY the title, nothing else
-
-Examples:
-- Message: "How do I implement authentication?" → Title: "Authentication Implementation"
-- Message: "你好，请帮我修复这个 bug" → Title: "Bug 修复请求"
-- Message: "Can you help me with React hooks?" → Title: "React Hooks Help"
-
-Now generate the title:`,
-        },
-      ],
-    });
-
-    let fullTitle = '';
-
-    // Iterate the async generator and stream to UI
-    for await (const chunk of streamGenerator) {
-      if (chunk.type === 'text-delta' && chunk.textDelta) {
-        fullTitle += chunk.textDelta;
-        onChunk(chunk.textDelta);
-      }
-    }
-
-    // Clean up title
-    let cleaned = fullTitle.trim();
-    cleaned = cleaned.replace(/^["'「『]+|["'」』]+$/g, ''); // Remove quotes
-    cleaned = cleaned.replace(/^(Title:|标题：)\s*/i, ''); // Remove "Title:" prefix
-    cleaned = cleaned.replace(/\n+/g, ' '); // Replace newlines with spaces
-    cleaned = cleaned.trim();
-
-    // Return truncated if needed
-    return cleaned.length > 50 ? cleaned.substring(0, 50) + '...' : cleaned;
-  } catch (error) {
-    // Fallback to simple title generation on any error
-    return generateSessionTitle(firstMessage);
-  }
-}
-