@xopcai/xopc 0.0.29 → 0.0.31

package/dist/src/utils/logger/log-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-store.js","names":[],"sources":["../../../../src/utils/logger/log-store.ts"],"sourcesContent":["/**\n * Log Store - Enhanced File-based Log Storage\n * \n * Features:\n * - Query logs across multiple files with filtering\n * - Support for compressed (.gz) log files\n * - Pagination and sorting\n * - Statistics and analytics\n * - Safe log cleanup with actual deletion\n */\n\nimport { \n  existsSync, \n  mkdirSync, \n  readdirSync, \n  statSync, \n  createReadStream,\n  unlinkSync,\n} from 'fs';\nimport { readFile } from 'fs/promises';\nimport { join, basename } from 'path';\nimport { createInterface } from 'readline';\nimport { gunzip } from 'zlib';\nimport { promisify } from 'util';\nimport { Readable } from 'stream';\nimport type { LogLevel, LogFileMeta, LogQuery, LogStats, LogEntry } from './types.js';\n\nconst gunzipAsync = promisify(gunzip);\n\n// ============================================\n// Types\n// ============================================\n\ninterface ParsedLogEntry extends LogEntry {\n  _source?: string;\n  _lineNumber?: number;\n}\n\n// ============================================\n// Configuration\n// ============================================\n\nconst LOG_DIR = process.env.XOPC_LOG_DIR || join(process.env.HOME || '.', '.xopc', 'logs');\n\nfunction ensureLogDir(): void {\n  if (!existsSync(LOG_DIR)) {\n    mkdirSync(LOG_DIR, { recursive: true });\n  }\n}\n\n// ============================================\n// File Management\n// ============================================\n\n/**\n * Get all log files (including compressed)\n */\nexport function getLogFiles(): LogFileMeta[] {\n  ensureLogDir();\n\n  const files = readdirSync(LOG_DIR)\n    .filter(f => f.endsWith('.log') || f.endsWith('.log.gz'))\n    .map(f => {\n      const filePath = join(LOG_DIR, f);\n      const stats = statSync(filePath);\n      \n      let type: LogFileMeta['type'] = 'app';\n      if (f.includes('error')) type = 'error';\n      else if (f.includes('audit')) type = 'audit';\n      else if (f.includes('access')) type = 'access';\n\n      return {\n        name: f,\n        path: filePath,\n        size: stats.size,\n        created: stats.birthtime.toISOString(),\n        modified: stats.mtime.toISOString(),\n        type,\n      };\n    })\n    .sort((a, b) => new Date(b.modified).getTime() - new Date(a.modified).getTime());\n\n  return files;\n}\n\n/**\n * Get log file path for a specific date and type\n */\nexport function getLogPath(\n  date: Date = new Date(), \n  type: 'app' | 'error' | 'audit' | 'access' = 'app'\n): string {\n  ensureLogDir();\n  const dateStr = date.toISOString().split('T')[0];\n  return join(LOG_DIR, `${type}-${dateStr}.log`);\n}\n\n/**\n * Get available log files for a date range\n */\nfunction getLogFilesForRange(from: Date, to: Date): LogFileMeta[] {\n  const allFiles = getLogFiles();\n  \n  return allFiles.filter(f => {\n    // Extract date from filename (e.g., app-2024-01-01.log)\n    const match = f.name.match(/(\\d{4}-\\d{2}-\\d{2})/);\n    if (!match) return false;\n    \n    const fileDate = new Date(match[1]);\n    return fileDate >= from && fileDate <= to;\n  });\n}\n\n// ============================================\n// Log Parsing\n// ============================================\n\n/**\n * Parse a single log line (JSON format from pino)\n */\nfunction parseLogLine(line: string, source?: string, lineNumber?: number): ParsedLogEntry | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n\n  try {\n    // Try JSON format (pino default)\n    const parsed = JSON.parse(trimmed);\n    \n    // Convert pino numeric level to string (10=trace, 20=debug, 30=info, 40=warn, 50=error, 60=fatal)\n    const levelNum = typeof parsed.level === 'number' ? parsed.level : 30;\n    const levelMap: Record<number, string> = {\n      10: 'trace',\n      20: 'debug',\n      30: 'info',\n      40: 'warn',\n      50: 'error',\n      60: 'fatal',\n    };\n\n    return {\n      timestamp: parsed.time || parsed.timestamp || '',\n      level: levelMap[levelNum] || (parsed.level?.toString() || 'info').toLowerCase(),\n      message: parsed.msg || parsed.message || '',\n      module: parsed.module,\n      prefix: parsed.prefix,\n      service: parsed.service,\n      extension: parsed.extension,\n      requestId: parsed.requestId,\n      sessionId: parsed.sessionId,\n      _source: source,\n      _lineNumber: lineNumber,\n      ...parsed,\n    };\n  } catch {\n    // Fallback: try to parse pino's text format\n    const match = trimmed.match(/^\\[([^\\]]+)\\]\\s+(\\w+):\\s+(.+)$/);\n    if (match) {\n      return {\n        timestamp: match[1],\n        level: match[2].toLowerCase() as LogLevel,\n        message: match[3],\n        _source: source,\n        _lineNumber: lineNumber,\n      };\n    }\n    \n    // Plain text fallback\n    return {\n      timestamp: new Date().toISOString(),\n      level: 'info',\n      message: trimmed,\n      _source: source,\n      _lineNumber: lineNumber,\n    };\n  }\n}\n\n// ============================================\n// Streaming\n// ============================================\n\n/**\n * Create a readable stream for a log file (handles .gz files)\n */\nasync function createLogFileStream(filePath: string): Promise<Readable> {\n  if (filePath.endsWith('.gz')) {\n    const compressed = await readFile(filePath);\n    const decompressed = await gunzipAsync(compressed);\n    return Readable.from(decompressed.toString('utf-8').split('\\n'));\n  }\n  \n  return createReadStream(filePath, { encoding: 'utf-8' });\n}\n\n/**\n * Stream and filter log entries from a file\n */\nasync function* streamLogFile(\n  filePath: string,\n  query: LogQuery = {}\n): AsyncGenerator<ParsedLogEntry> {\n  if (!existsSync(filePath)) return;\n\n  const fileName = basename(filePath);\n  let stream: Readable;\n  \n  try {\n    stream = await createLogFileStream(filePath);\n  } catch {\n    return;\n  }\n\n  const rl = createInterface({ \n    input: stream,\n    crlfDelay: Infinity \n  });\n\n  let lineNumber = 0;\n\n  try {\n    for await (const line of rl) {\n      lineNumber++;\n      const entry = parseLogLine(line, fileName, lineNumber);\n      if (!entry) continue;\n\n      // Apply filters\n      if (!matchesQuery(entry, query)) continue;\n\n      yield entry;\n    }\n  } finally {\n    rl.close();\n  }\n}\n\n/**\n * Check if a log entry matches the query filters\n */\nfunction matchesQuery(entry: ParsedLogEntry, query: LogQuery): boolean {\n  // Filter by levels\n  if (query.levels?.length && !query.levels.includes(entry.level as LogLevel)) {\n    return false;\n  }\n\n  // Filter by time range\n  if (query.from) {\n    const fromDate = new Date(query.from);\n    const entryDate = new Date(entry.timestamp);\n    if (entryDate < fromDate) return false;\n  }\n  if (query.to) {\n    const toDate = new Date(query.to);\n    const entryDate = new Date(entry.timestamp);\n    if (entryDate > toDate) return false;\n  }\n\n  // Filter by keyword (search in message and context fields)\n  if (query.q) {\n    const keyword = query.q.toLowerCase();\n    const searchable = [\n      entry.message,\n      entry.module,\n      entry.prefix,\n      entry.service,\n      entry.extension,\n      entry.requestId,\n      entry.sessionId,\n    ]\n      .filter(Boolean)\n      .map(String)\n      .join(' ')\n      .toLowerCase();\n    \n    if (!searchable.includes(keyword)) return false;\n  }\n\n  // Filter by specific fields\n  if (query.module && entry.module !== query.module) return false;\n  if (query.extension && entry.extension !== query.extension) return false;\n  if (query.service && entry.service !== query.service) return false;\n  if (query.requestId && entry.requestId !== query.requestId) return false;\n  if (query.sessionId && entry.sessionId !== query.sessionId) return false;\n\n  return true;\n}\n\n// ============================================\n// Query API\n// ============================================\n\n/**\n * Query logs across multiple files\n */\nexport async function queryLogs(query: LogQuery = {}): Promise<LogEntry[]> {\n  ensureLogDir();\n\n  const results: ParsedLogEntry[] = [];\n  const files = getLogFiles();\n\n  // Filter files by date range if specified\n  let relevantFiles = files;\n  if (query.from || query.to) {\n    const fromDate = query.from ? new Date(query.from) : new Date(0);\n    const toDate = query.to ? new Date(query.to) : new Date();\n    relevantFiles = getLogFilesForRange(fromDate, toDate);\n  }\n\n  // Query each file\n  for (const file of relevantFiles) {\n    for await (const entry of streamLogFile(file.path, query)) {\n      results.push(entry);\n\n      // Early exit if limit reached\n      const limit = query.limit || 100;\n      if (results.length >= limit) {\n        break;\n      }\n    }\n\n    if (query.limit && results.length >= query.limit) {\n      break;\n    }\n  }\n\n  // Sort by timestamp\n  const order = query.order || 'desc';\n  results.sort((a, b) => {\n    const diff = new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();\n    return order === 'desc' ? diff : -diff;\n  });\n\n  // Apply offset/limit\n  const offset = query.offset || 0;\n  const limit = query.limit || 100;\n  return results.slice(offset, offset + limit).map(({ _source, _lineNumber, ...rest }) => rest);\n}\n\n/**\n * Get recent logs (convenience method)\n */\nexport async function getRecentLogs(options?: {\n  level?: LogLevel;\n  limit?: number;\n  module?: string;\n}): Promise<LogEntry[]> {\n  return queryLogs({\n    levels: options?.level ? [options.level] : undefined,\n    limit: options?.limit || 50,\n    module: options?.module,\n    order: 'desc',\n  });\n}\n\n/**\n * Search logs by keyword\n */\nexport async function searchLogs(\n  keyword: string,\n  options?: {\n    from?: string;\n    to?: string;\n    limit?: number;\n  }\n): Promise<LogEntry[]> {\n  return queryLogs({\n    q: keyword,\n    ...options,\n    limit: options?.limit || 100,\n  });\n}\n\n/**\n * Get logs for a specific request/session\n */\nexport async function getLogsByContext(\n  contextType: 'requestId' | 'sessionId',\n  contextValue: string,\n  limit: number = 100\n): Promise<LogEntry[]> {\n  return queryLogs({\n    [contextType]: contextValue,\n    limit,\n    order: 'asc',\n  });\n}\n\n// ============================================\n// Statistics\n// ============================================\n\n/**\n * Get available log levels from actual log data\n */\nexport async function getLogLevelsFromData(): Promise<LogLevel[]> {\n  const levels = new Set<LogLevel>();\n  const files = getLogFiles().slice(0, 3); // Check last 3 files\n\n  for (const file of files) {\n    for await (const entry of streamLogFile(file.path, { limit: 500 })) {\n      levels.add(entry.level as LogLevel);\n    }\n  }\n\n  return Array.from(levels).sort();\n}\n\n/**\n * Get available modules from log data\n */\nexport async function getLogModules(): Promise<string[]> {\n  const modules = new Set<string>();\n  const files = getLogFiles().slice(0, 7);\n\n  for (const file of files) {\n    for await (const entry of streamLogFile(file.path, { limit: 1000 })) {\n      if (entry.module) modules.add(entry.module);\n      if (entry.prefix) modules.add(entry.prefix);\n    }\n  }\n\n  return Array.from(modules).filter(Boolean).sort();\n}\n\n/**\n * Get log statistics by level (sampled from recent files)\n */\nexport async function getLogStats(): Promise<LogStats> {\n  const files = getLogFiles();\n\n  // Count by level (sample from recent files)\n  const byLevel: Record<LogLevel, number> = {\n    trace: 0,\n    debug: 0,\n    info: 0,\n    warn: 0,\n    error: 0,\n    fatal: 0,\n    silent: 0,\n  };\n\n  for (const file of files.slice(0, 7)) {\n    for await (const entry of streamLogFile(file.path, { limit: 1000 })) {\n      if (entry.level in byLevel) {\n        byLevel[entry.level as LogLevel]++;\n      }\n    }\n  }\n\n  return { byLevel };\n}\n\n// ============================================\n// Cleanup\n// ============================================\n\n/**\n * Clean old logs (actually deletes files)\n */\nexport function cleanOldLogs(keepDays: number = 7): {\n  deleted: number;\n  freedBytes: number;\n  errors: string[];\n} {\n  const cutoff = new Date();\n  cutoff.setDate(cutoff.getDate() - keepDays);\n\n  let deleted = 0;\n  let freedBytes = 0;\n  const errors: string[] = [];\n\n  const files = getLogFiles();\n  for (const file of files) {\n    const fileDate = new Date(file.modified);\n    if (fileDate < cutoff) {\n      try {\n        const size = file.size;\n        unlinkSync(file.path);\n        deleted++;\n        freedBytes += size;\n      } catch (err) {\n        errors.push(`Failed to delete ${file.name}: ${err}`);\n      }\n    }\n  }\n\n  return { deleted, freedBytes, errors };\n}\n\n/**\n * Clean logs by size (keep total under limit)\n */\nfunction _cleanBySize(maxTotalMB: number = 500): {\n  deleted: number;\n  freedBytes: number;\n  errors: string[];\n} {\n  const maxBytes = maxTotalMB * 1024 * 1024;\n  const files = getLogFiles();\n  \n  let totalSize = files.reduce((sum, f) => sum + f.size, 0);\n  let deleted = 0;\n  let freedBytes = 0;\n  const errors: string[] = [];\n\n  // Delete oldest files until under limit\n  for (const file of files.slice().reverse()) {\n    if (totalSize <= maxBytes) break;\n\n    try {\n      unlinkSync(file.path);\n      freedBytes += file.size;\n      totalSize -= file.size;\n      deleted++;\n    } catch (err) {\n      errors.push(`Failed to delete ${file.name}: ${err}`);\n    }\n  }\n\n  return { deleted, freedBytes, errors };\n}\n\n// ============================================\n// Log Levels\n// ============================================\n\nconst LOG_LEVELS: LogLevel[] = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];\n\n/**\n * Get available log levels\n */\nexport function getLogLevels(): LogLevel[] {\n  return [...LOG_LEVELS];\n}\n\n// ============================================\n// Exports\n// ============================================\n\nexport { LOG_DIR };\nexport type { LogEntry, LogQuery, LogFileMeta, LogStats } from './types.js';\n"],"mappings":"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"}
+{"version":3,"file":"log-store.js","names":[],"sources":["../../../../src/utils/logger/log-store.ts"],"sourcesContent":["/**\n * Log Store - Enhanced File-based Log Storage\n * \n * Features:\n * - Query logs across multiple files with filtering\n * - Support for compressed (.gz) log files\n * - Pagination and sorting\n * - Statistics and analytics\n * - Safe log cleanup with actual deletion\n */\n\nimport { \n  existsSync, \n  mkdirSync, \n  readdirSync, \n  statSync, \n  createReadStream,\n  unlinkSync,\n} from 'fs';\nimport { readFile } from 'fs/promises';\nimport { join, basename } from 'path';\nimport { createInterface } from 'readline';\nimport { gunzip } from 'zlib';\nimport { promisify } from 'util';\nimport { Readable } from 'stream';\nimport type { LogLevel, LogFileMeta, LogQuery, LogStats, LogEntry } from './types.js';\n\nconst gunzipAsync = promisify(gunzip);\n\n// ============================================\n// Types\n// ============================================\n\ninterface ParsedLogEntry extends LogEntry {\n  _source?: string;\n  _lineNumber?: number;\n}\n\n// ============================================\n// Configuration\n// ============================================\n\nconst LOG_DIR = process.env.XOPC_LOG_DIR || join(process.env.HOME || '.', '.xopc', 'logs');\n\nfunction ensureLogDir(): void {\n  if (!existsSync(LOG_DIR)) {\n    mkdirSync(LOG_DIR, { recursive: true });\n  }\n}\n\n// ============================================\n// File Management\n// ============================================\n\n/**\n * Get all log files (including compressed)\n */\nexport function getLogFiles(): LogFileMeta[] {\n  ensureLogDir();\n\n  const files = readdirSync(LOG_DIR)\n    .filter(f => f.endsWith('.log') || f.endsWith('.log.gz'))\n    .map(f => {\n      const filePath = join(LOG_DIR, f);\n      const stats = statSync(filePath);\n      \n      let type: LogFileMeta['type'] = 'app';\n      if (f.includes('error')) type = 'error';\n      else if (f.includes('audit')) type = 'audit';\n      else if (f.includes('access')) type = 'access';\n\n      return {\n        name: f,\n        path: filePath,\n        size: stats.size,\n        created: stats.birthtime.toISOString(),\n        modified: stats.mtime.toISOString(),\n        type,\n      };\n    })\n    .sort((a, b) => new Date(b.modified).getTime() - new Date(a.modified).getTime());\n\n  return files;\n}\n\n/**\n * Get log file path for a specific date and type\n */\nexport function getLogPath(\n  date: Date = new Date(), \n  type: 'app' | 'error' | 'audit' | 'access' = 'app'\n): string {\n  ensureLogDir();\n  const dateStr = date.toISOString().split('T')[0];\n  return join(LOG_DIR, `${type}-${dateStr}.log`);\n}\n\n/**\n * Get available log files for a date range\n */\nfunction getLogFilesForRange(from: Date, to: Date): LogFileMeta[] {\n  const allFiles = getLogFiles();\n  \n  return allFiles.filter(f => {\n    // Extract date from filename (e.g., app-2024-01-01.log)\n    const match = f.name.match(/(\\d{4}-\\d{2}-\\d{2})/);\n    if (!match) return false;\n    \n    const fileDate = new Date(match[1]);\n    return fileDate >= from && fileDate <= to;\n  });\n}\n\n// ============================================\n// Log Parsing\n// ============================================\n\n/**\n * Parse a single log line (JSON format from pino)\n */\nfunction parseLogLine(line: string, source?: string, lineNumber?: number): ParsedLogEntry | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n\n  try {\n    // Try JSON format (pino default)\n    const parsed = JSON.parse(trimmed);\n    \n    // Convert pino numeric level to string (10=trace, 20=debug, 30=info, 40=warn, 50=error, 60=fatal)\n    const levelNum = typeof parsed.level === 'number' ? parsed.level : 30;\n    const levelMap: Record<number, string> = {\n      10: 'trace',\n      20: 'debug',\n      30: 'info',\n      40: 'warn',\n      50: 'error',\n      60: 'fatal',\n    };\n\n    return {\n      timestamp: parsed.time || parsed.timestamp || '',\n      level: levelMap[levelNum] || (parsed.level?.toString() || 'info').toLowerCase(),\n      message: parsed.msg || parsed.message || '',\n      module: parsed.module,\n      prefix: parsed.prefix,\n      service: parsed.service,\n      extension: parsed.extension,\n      requestId: parsed.requestId,\n      sessionId: parsed.sessionId,\n      _source: source,\n      _lineNumber: lineNumber,\n      ...parsed,\n    };\n  } catch {\n    // Fallback: try to parse pino's text format\n    const match = trimmed.match(/^\\[([^\\]]+)\\]\\s+(\\w+):\\s+(.+)$/);\n    if (match) {\n      return {\n        timestamp: match[1],\n        level: match[2].toLowerCase() as LogLevel,\n        message: match[3],\n        _source: source,\n        _lineNumber: lineNumber,\n      };\n    }\n    \n    // Plain text fallback\n    return {\n      timestamp: new Date().toISOString(),\n      level: 'info',\n      message: trimmed,\n      _source: source,\n      _lineNumber: lineNumber,\n    };\n  }\n}\n\n// ============================================\n// Streaming\n// ============================================\n\n/**\n * Create a readable stream for a log file (handles .gz files)\n */\nasync function createLogFileStream(filePath: string): Promise<Readable> {\n  if (filePath.endsWith('.gz')) {\n    const compressed = await readFile(filePath);\n    const decompressed = await gunzipAsync(compressed);\n    return Readable.from(decompressed.toString('utf-8').split('\\n'));\n  }\n  \n  return createReadStream(filePath, { encoding: 'utf-8' });\n}\n\n/**\n * Stream and filter log entries from a file\n */\nasync function* streamLogFile(\n  filePath: string,\n  query: LogQuery = {}\n): AsyncGenerator<ParsedLogEntry> {\n  if (!existsSync(filePath)) return;\n\n  const fileName = basename(filePath);\n  let stream: Readable;\n  \n  try {\n    stream = await createLogFileStream(filePath);\n  } catch {\n    return;\n  }\n\n  const rl = createInterface({ \n    input: stream,\n    crlfDelay: Infinity \n  });\n\n  let lineNumber = 0;\n\n  try {\n    for await (const line of rl) {\n      lineNumber++;\n      const entry = parseLogLine(line, fileName, lineNumber);\n      if (!entry) continue;\n\n      // Apply filters\n      if (!matchesQuery(entry, query)) continue;\n\n      yield entry;\n    }\n  } finally {\n    rl.close();\n  }\n}\n\n/**\n * Check if a log entry matches the query filters\n */\nfunction matchesQuery(entry: ParsedLogEntry, query: LogQuery): boolean {\n  // Filter by levels\n  if (query.levels?.length && !query.levels.includes(entry.level as LogLevel)) {\n    return false;\n  }\n\n  // Filter by time range\n  if (query.from) {\n    const fromDate = new Date(query.from);\n    const entryDate = new Date(entry.timestamp);\n    if (entryDate < fromDate) return false;\n  }\n  if (query.to) {\n    const toDate = new Date(query.to);\n    const entryDate = new Date(entry.timestamp);\n    if (entryDate > toDate) return false;\n  }\n\n  // Filter by keyword (search in message and context fields)\n  if (query.q) {\n    const keyword = query.q.toLowerCase();\n    const searchable = [\n      entry.message,\n      entry.module,\n      entry.prefix,\n      entry.service,\n      entry.extension,\n      entry.requestId,\n      entry.sessionId,\n    ]\n      .filter(Boolean)\n      .map(String)\n      .join(' ')\n      .toLowerCase();\n    \n    if (!searchable.includes(keyword)) return false;\n  }\n\n  // Filter by specific fields\n  if (query.module && entry.module !== query.module) return false;\n  if (query.extension && entry.extension !== query.extension) return false;\n  if (query.service && entry.service !== query.service) return false;\n  if (query.requestId && entry.requestId !== query.requestId) return false;\n  if (query.sessionId && entry.sessionId !== query.sessionId) return false;\n\n  return true;\n}\n\n// ============================================\n// Query API\n// ============================================\n\n/** Cap matched rows before sort/slice so query stays bounded on huge log dirs. */\nconst QUERY_LOGS_MAX_MATCHED = 25_000;\n\n/**\n * Query logs across multiple files\n */\nexport async function queryLogs(query: LogQuery = {}): Promise<LogEntry[]> {\n  ensureLogDir();\n\n  const results: ParsedLogEntry[] = [];\n  const files = getLogFiles();\n\n  // Filter files by date range if specified\n  let relevantFiles = files;\n  if (query.from || query.to) {\n    const fromDate = query.from ? new Date(query.from) : new Date(0);\n    const toDate = query.to ? new Date(query.to) : new Date();\n    relevantFiles = getLogFilesForRange(fromDate, toDate);\n  }\n\n  // Collect all matches (files are newest-first; lines in each file are time-asc).\n  // Do not stop at `limit` while streaming — that only captured the oldest tail of\n  // early files and made \"newest first\" wrong after sort.\n  for (const file of relevantFiles) {\n    if (results.length >= QUERY_LOGS_MAX_MATCHED) break;\n    for await (const entry of streamLogFile(file.path, query)) {\n      results.push(entry);\n      if (results.length >= QUERY_LOGS_MAX_MATCHED) break;\n    }\n  }\n\n  // Sort by timestamp\n  const order = query.order || 'desc';\n  results.sort((a, b) => {\n    const diff = new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime();\n    return order === 'desc' ? diff : -diff;\n  });\n\n  // Apply offset/limit\n  const offset = query.offset || 0;\n  const limit = query.limit || 100;\n  return results.slice(offset, offset + limit).map(({ _source, _lineNumber, ...rest }) => rest);\n}\n\n/**\n * Get recent logs (convenience method)\n */\nexport async function getRecentLogs(options?: {\n  level?: LogLevel;\n  limit?: number;\n  module?: string;\n}): Promise<LogEntry[]> {\n  return queryLogs({\n    levels: options?.level ? [options.level] : undefined,\n    limit: options?.limit || 50,\n    module: options?.module,\n    order: 'desc',\n  });\n}\n\n/**\n * Search logs by keyword\n */\nexport async function searchLogs(\n  keyword: string,\n  options?: {\n    from?: string;\n    to?: string;\n    limit?: number;\n  }\n): Promise<LogEntry[]> {\n  return queryLogs({\n    q: keyword,\n    ...options,\n    limit: options?.limit || 100,\n  });\n}\n\n/**\n * Get logs for a specific request/session\n */\nexport async function getLogsByContext(\n  contextType: 'requestId' | 'sessionId',\n  contextValue: string,\n  limit: number = 100\n): Promise<LogEntry[]> {\n  return queryLogs({\n    [contextType]: contextValue,\n    limit,\n    order: 'asc',\n  });\n}\n\n// ============================================\n// Statistics\n// ============================================\n\n/**\n * Get available log levels from actual log data\n */\nexport async function getLogLevelsFromData(): Promise<LogLevel[]> {\n  const levels = new Set<LogLevel>();\n  const files = getLogFiles().slice(0, 3); // Check last 3 files\n\n  for (const file of files) {\n    for await (const entry of streamLogFile(file.path, { limit: 500 })) {\n      levels.add(entry.level as LogLevel);\n    }\n  }\n\n  return Array.from(levels).sort();\n}\n\n/**\n * Get available modules from log data\n */\nexport async function getLogModules(): Promise<string[]> {\n  const modules = new Set<string>();\n  const files = getLogFiles().slice(0, 7);\n\n  for (const file of files) {\n    for await (const entry of streamLogFile(file.path, { limit: 1000 })) {\n      if (entry.module) modules.add(entry.module);\n      if (entry.prefix) modules.add(entry.prefix);\n    }\n  }\n\n  return Array.from(modules).filter(Boolean).sort();\n}\n\n/**\n * Get log statistics by level (sampled from recent files)\n */\nexport async function getLogStats(): Promise<LogStats> {\n  const files = getLogFiles();\n\n  // Count by level (sample from recent files)\n  const byLevel: Record<LogLevel, number> = {\n    trace: 0,\n    debug: 0,\n    info: 0,\n    warn: 0,\n    error: 0,\n    fatal: 0,\n    silent: 0,\n  };\n\n  for (const file of files.slice(0, 7)) {\n    for await (const entry of streamLogFile(file.path, { limit: 1000 })) {\n      if (entry.level in byLevel) {\n        byLevel[entry.level as LogLevel]++;\n      }\n    }\n  }\n\n  return { byLevel };\n}\n\n// ============================================\n// Cleanup\n// ============================================\n\n/**\n * Clean old logs (actually deletes files)\n */\nexport function cleanOldLogs(keepDays: number = 7): {\n  deleted: number;\n  freedBytes: number;\n  errors: string[];\n} {\n  const cutoff = new Date();\n  cutoff.setDate(cutoff.getDate() - keepDays);\n\n  let deleted = 0;\n  let freedBytes = 0;\n  const errors: string[] = [];\n\n  const files = getLogFiles();\n  for (const file of files) {\n    const fileDate = new Date(file.modified);\n    if (fileDate < cutoff) {\n      try {\n        const size = file.size;\n        unlinkSync(file.path);\n        deleted++;\n        freedBytes += size;\n      } catch (err) {\n        errors.push(`Failed to delete ${file.name}: ${err}`);\n      }\n    }\n  }\n\n  return { deleted, freedBytes, errors };\n}\n\n/**\n * Clean logs by size (keep total under limit)\n */\nfunction _cleanBySize(maxTotalMB: number = 500): {\n  deleted: number;\n  freedBytes: number;\n  errors: string[];\n} {\n  const maxBytes = maxTotalMB * 1024 * 1024;\n  const files = getLogFiles();\n  \n  let totalSize = files.reduce((sum, f) => sum + f.size, 0);\n  let deleted = 0;\n  let freedBytes = 0;\n  const errors: string[] = [];\n\n  // Delete oldest files until under limit\n  for (const file of files.slice().reverse()) {\n    if (totalSize <= maxBytes) break;\n\n    try {\n      unlinkSync(file.path);\n      freedBytes += file.size;\n      totalSize -= file.size;\n      deleted++;\n    } catch (err) {\n      errors.push(`Failed to delete ${file.name}: ${err}`);\n    }\n  }\n\n  return { deleted, freedBytes, errors };\n}\n\n// ============================================\n// Log Levels\n// ============================================\n\nconst LOG_LEVELS: LogLevel[] = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];\n\n/**\n * Get available log levels\n */\nexport function getLogLevels(): LogLevel[] {\n  return [...LOG_LEVELS];\n}\n\n// ============================================\n// Exports\n// ============================================\n\nexport { LOG_DIR };\nexport type { LogEntry, LogQuery, LogFileMeta, LogStats } from './types.js';\n"],"mappings":"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"}

package/dist/src/voice/tts/merge-config.js

@@ -7,7 +7,6 @@ import { isTTSAvailable } from "./factory.js";
 */
 function normalizeTtsTrigger(raw) {
 	const t = typeof raw === "string" ? raw.toLowerCase() : "";
-	if (t === "auto") return "inbound";
 	if (t === "off" || t === "always" || t === "inbound" || t === "tagged") return t;
 	return DEFAULT_TTS_CONFIG.trigger;
 }

package/dist/src/voice/tts/merge-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge-config.js","names":[],"sources":["../../../../src/voice/tts/merge-config.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_TTS_CONFIG, type TTSConfig } from './types.js';\nimport { isTTSAvailable } from './factory.js';\n\n/**\n * Merge persisted app config `tts` with defaults to a full {@link TTSConfig}\n * for validation (provider chain, env-based keys, etc.).\n */\nfunction normalizeTtsTrigger(raw: unknown): TTSConfig['trigger'] {\n  const t = typeof raw === 'string' ? raw.toLowerCase() : '';\n  if (t === 'auto') return 'inbound';\n  if (t === 'off' || t === 'always' || t === 'inbound' || t === 'tagged') return t;\n  return DEFAULT_TTS_CONFIG.trigger;\n}\n\nexport function mergeTtsConfigFromAppConfig(tts: Config['tts'] | undefined): TTSConfig {\n  const p = (tts ?? {}) as Partial<TTSConfig>;\n  return {\n    ...DEFAULT_TTS_CONFIG,\n    ...p,\n    enabled: p.enabled ?? DEFAULT_TTS_CONFIG.enabled,\n    provider: p.provider ?? DEFAULT_TTS_CONFIG.provider,\n    trigger: normalizeTtsTrigger((p as { trigger?: unknown }).trigger ?? DEFAULT_TTS_CONFIG.trigger),\n    fallback: {\n      ...DEFAULT_TTS_CONFIG.fallback!,\n      ...p.fallback,\n    },\n    modelOverrides: {\n      ...DEFAULT_TTS_CONFIG.modelOverrides!,\n      ...p.modelOverrides,\n    },\n    alibaba: { ...DEFAULT_TTS_CONFIG.alibaba, ...p.alibaba },\n    openai: { ...DEFAULT_TTS_CONFIG.openai, ...p.openai },\n    edge: { ...DEFAULT_TTS_CONFIG.edge, ...p.edge },\n    minimax: { ...DEFAULT_TTS_CONFIG.minimax, ...p.minimax },\n    summarization: {\n      ...DEFAULT_TTS_CONFIG.summarization,\n      ...p.summarization,\n    },\n  };\n}\n\n/**\n * User-facing hint when TTS is enabled in settings but no provider can run.\n */\nexport function formatTtsSetupHint(): string {\n  return (\n    `⚠️ *TTS is on, but no provider can run yet.*\\n\\n` +\n    `Configure one of the following in \\`~/.xopc/xopc.json\\` (or env):\\n` +\n    `• *OpenAI*: \\`OPENAI_API_KEY\\` or \\`tts.openai.apiKey\\` (and optional \\`tts.openai.model\\` / \\`tts.openai.voice\\`)\\n` +\n    `• *Alibaba*: \\`DASHSCOPE_API_KEY\\` or \\`tts.alibaba.apiKey\\`\\n` +\n    `• *MiniMax*: \\`MINIMAX_API_KEY\\` or \\`tts.minimax.apiKey\\` (and optional \\`tts.minimax.model\\` / \\`tts.minimax.voice\\`)\\n` +\n    `• *Edge* (no key): \\`/tts provider edge\\` — ensure \\`tts.edge.enabled\\` is not \\`false\\`\\n\\n` +\n    `You can also use the gateway Web UI → Settings → Voice.`\n  );\n}\n\n/**\n * Append readiness / setup guidance when TTS is enabled but unavailable.\n */\nexport function appendTtsReadinessNote(content: string, appConfig: Config | undefined): string {\n  const effective = mergeTtsConfigFromAppConfig(appConfig?.tts);\n  if (!effective.enabled) {\n    return content;\n  }\n  if (isTTSAvailable(effective)) {\n    return content;\n  }\n  return `${content}\\n\\n${formatTtsSetupHint()}`;\n}\n"],"mappings":";;;;;;;AAQA,SAAS,oBAAoB,KAAoC;CAC/D,MAAM,IAAI,OAAO,QAAQ,WAAW,IAAI,aAAa,GAAG;AACxD,KAAI,MAAM,OAAQ,QAAO;AACzB,KAAI,MAAM,SAAS,MAAM,YAAY,MAAM,aAAa,MAAM,SAAU,QAAO;AAC/E,QAAO,mBAAmB;;AAG5B,SAAgB,4BAA4B,KAA2C;CACrF,MAAM,IAAK,OAAO,EAAE;AACpB,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS,EAAE,WAAW,mBAAmB;EACzC,UAAU,EAAE,YAAY,mBAAmB;EAC3C,SAAS,oBAAqB,EAA4B,WAAW,mBAAmB,QAAQ;EAChG,UAAU;GACR,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACD,gBAAgB;GACd,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACD,SAAS;GAAE,GAAG,mBAAmB;GAAS,GAAG,EAAE;GAAS;EACxD,QAAQ;GAAE,GAAG,mBAAmB;GAAQ,GAAG,EAAE;GAAQ;EACrD,MAAM;GAAE,GAAG,mBAAmB;GAAM,GAAG,EAAE;GAAM;EAC/C,SAAS;GAAE,GAAG,mBAAmB;GAAS,GAAG,EAAE;GAAS;EACxD,eAAe;GACb,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACF;;;;;AAMH,SAAgB,qBAA6B;AAC3C,QACE;;;;;AAaJ,SAAgB,uBAAuB,SAAiB,WAAuC;CAC7F,MAAM,YAAY,4BAA4B,WAAW,IAAI;AAC7D,KAAI,CAAC,UAAU,QACb,QAAO;AAET,KAAI,eAAe,UAAU,CAC3B,QAAO;AAET,QAAO,GAAG,QAAQ,MAAM,oBAAoB"}
+{"version":3,"file":"merge-config.js","names":[],"sources":["../../../../src/voice/tts/merge-config.ts"],"sourcesContent":["import type { Config } from '../../config/schema.js';\nimport { DEFAULT_TTS_CONFIG, type TTSConfig } from './types.js';\nimport { isTTSAvailable } from './factory.js';\n\n/**\n * Merge persisted app config `tts` with defaults to a full {@link TTSConfig}\n * for validation (provider chain, env-based keys, etc.).\n */\nfunction normalizeTtsTrigger(raw: unknown): TTSConfig['trigger'] {\n  const t = typeof raw === 'string' ? raw.toLowerCase() : '';\n  if (t === 'off' || t === 'always' || t === 'inbound' || t === 'tagged') return t;\n  return DEFAULT_TTS_CONFIG.trigger;\n}\n\nexport function mergeTtsConfigFromAppConfig(tts: Config['tts'] | undefined): TTSConfig {\n  const p = (tts ?? {}) as Partial<TTSConfig>;\n  return {\n    ...DEFAULT_TTS_CONFIG,\n    ...p,\n    enabled: p.enabled ?? DEFAULT_TTS_CONFIG.enabled,\n    provider: p.provider ?? DEFAULT_TTS_CONFIG.provider,\n    trigger: normalizeTtsTrigger((p as { trigger?: unknown }).trigger ?? DEFAULT_TTS_CONFIG.trigger),\n    fallback: {\n      ...DEFAULT_TTS_CONFIG.fallback!,\n      ...p.fallback,\n    },\n    modelOverrides: {\n      ...DEFAULT_TTS_CONFIG.modelOverrides!,\n      ...p.modelOverrides,\n    },\n    alibaba: { ...DEFAULT_TTS_CONFIG.alibaba, ...p.alibaba },\n    openai: { ...DEFAULT_TTS_CONFIG.openai, ...p.openai },\n    edge: { ...DEFAULT_TTS_CONFIG.edge, ...p.edge },\n    minimax: { ...DEFAULT_TTS_CONFIG.minimax, ...p.minimax },\n    summarization: {\n      ...DEFAULT_TTS_CONFIG.summarization,\n      ...p.summarization,\n    },\n  };\n}\n\n/**\n * User-facing hint when TTS is enabled in settings but no provider can run.\n */\nexport function formatTtsSetupHint(): string {\n  return (\n    `⚠️ *TTS is on, but no provider can run yet.*\\n\\n` +\n    `Configure one of the following in \\`~/.xopc/xopc.json\\` (or env):\\n` +\n    `• *OpenAI*: \\`OPENAI_API_KEY\\` or \\`tts.openai.apiKey\\` (and optional \\`tts.openai.model\\` / \\`tts.openai.voice\\`)\\n` +\n    `• *Alibaba*: \\`DASHSCOPE_API_KEY\\` or \\`tts.alibaba.apiKey\\`\\n` +\n    `• *MiniMax*: \\`MINIMAX_API_KEY\\` or \\`tts.minimax.apiKey\\` (and optional \\`tts.minimax.model\\` / \\`tts.minimax.voice\\`)\\n` +\n    `• *Edge* (no key): \\`/tts provider edge\\` — ensure \\`tts.edge.enabled\\` is not \\`false\\`\\n\\n` +\n    `You can also use the gateway Web UI → Settings → Voice.`\n  );\n}\n\n/**\n * Append readiness / setup guidance when TTS is enabled but unavailable.\n */\nexport function appendTtsReadinessNote(content: string, appConfig: Config | undefined): string {\n  const effective = mergeTtsConfigFromAppConfig(appConfig?.tts);\n  if (!effective.enabled) {\n    return content;\n  }\n  if (isTTSAvailable(effective)) {\n    return content;\n  }\n  return `${content}\\n\\n${formatTtsSetupHint()}`;\n}\n"],"mappings":";;;;;;;AAQA,SAAS,oBAAoB,KAAoC;CAC/D,MAAM,IAAI,OAAO,QAAQ,WAAW,IAAI,aAAa,GAAG;AACxD,KAAI,MAAM,SAAS,MAAM,YAAY,MAAM,aAAa,MAAM,SAAU,QAAO;AAC/E,QAAO,mBAAmB;;AAG5B,SAAgB,4BAA4B,KAA2C;CACrF,MAAM,IAAK,OAAO,EAAE;AACpB,QAAO;EACL,GAAG;EACH,GAAG;EACH,SAAS,EAAE,WAAW,mBAAmB;EACzC,UAAU,EAAE,YAAY,mBAAmB;EAC3C,SAAS,oBAAqB,EAA4B,WAAW,mBAAmB,QAAQ;EAChG,UAAU;GACR,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACD,gBAAgB;GACd,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACD,SAAS;GAAE,GAAG,mBAAmB;GAAS,GAAG,EAAE;GAAS;EACxD,QAAQ;GAAE,GAAG,mBAAmB;GAAQ,GAAG,EAAE;GAAQ;EACrD,MAAM;GAAE,GAAG,mBAAmB;GAAM,GAAG,EAAE;GAAM;EAC/C,SAAS;GAAE,GAAG,mBAAmB;GAAS,GAAG,EAAE;GAAS;EACxD,eAAe;GACb,GAAG,mBAAmB;GACtB,GAAG,EAAE;GACN;EACF;;;;;AAMH,SAAgB,qBAA6B;AAC3C,QACE;;;;;AAaJ,SAAgB,uBAAuB,SAAiB,WAAuC;CAC7F,MAAM,YAAY,4BAA4B,WAAW,IAAI;AAC7D,KAAI,CAAC,UAAU,QACb,QAAO;AAET,KAAI,eAAe,UAAU,CAC3B,QAAO;AAET,QAAO,GAAG,QAAQ,MAAM,oBAAoB"}

package/dist/src/voice/tts/service.js

@@ -38,8 +38,7 @@ function shouldUseTTS(config, inboundAudio) {
 		useTTS: false,
 		reason: "TTS disabled"
 	};
-	const triggerRaw = config.trigger ?? "off";
-	const trigger = triggerRaw === "auto" ? "inbound" : triggerRaw;
+	const trigger = config.trigger ?? "off";
 	switch (trigger) {
 		case "off": return {
 			useTTS: false,

package/dist/src/voice/tts/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":[],"sources":["../../../../src/voice/tts/service.ts"],"sourcesContent":["import type { TTSConfig, TTSAutoMode, TTSResultWithTracking } from './types.js';\n\nexport interface ChannelAudioFormat {\n  format: string;\n  voiceCompatible: boolean;\n}\n\n/** Per-channel encoding for outbound TTS. Only ids that xopc actually delivers on are listed; anything else uses `default`. */\nconst CHANNEL_OUTPUT_FORMATS: Record<string, ChannelAudioFormat> = {\n  telegram: { format: 'opus', voiceCompatible: true },\n  /** Weixin ilink: VoiceItem encode_type 7 = MP3 per API types. */\n  weixin: { format: 'mp3', voiceCompatible: true },\n  webchat: { format: 'mp3', voiceCompatible: false },\n  cli: { format: 'mp3', voiceCompatible: false },\n  default: { format: 'mp3', voiceCompatible: false },\n};\n\nexport function getChannelOutputFormat(channel?: string): ChannelAudioFormat {\n  if (!channel) return CHANNEL_OUTPUT_FORMATS.default;\n  return CHANNEL_OUTPUT_FORMATS[channel.toLowerCase()] || CHANNEL_OUTPUT_FORMATS.default;\n}\n\nexport function getSupportedChannels(): string[] {\n  return Object.keys(CHANNEL_OUTPUT_FORMATS).filter((k) => k !== 'default');\n}\n\nexport function isVoiceCompatibleChannel(channel: string): boolean {\n  return getChannelOutputFormat(channel).voiceCompatible;\n}\n\nexport interface TTSContext {\n  channel?: string;\n  chatId?: string;\n}\n\nexport interface TTSDecision {\n  useTTS: boolean;\n  reason: string;\n}\n\nexport function shouldUseTTS(config: TTSConfig | undefined, inboundAudio?: boolean): TTSDecision {\n  if (!config?.enabled) {\n    return { useTTS: false, reason: 'TTS disabled' };\n  }\n\n  const triggerRaw = (config.trigger ?? 'off') as string;\n  const trigger = triggerRaw === 'auto' ? 'inbound' : triggerRaw;\n\n  switch (trigger) {\n    case 'off':\n      return { useTTS: false, reason: 'trigger=off' };\n    case 'always':\n      return { useTTS: true, reason: 'trigger=always' };\n    case 'inbound':\n      return inboundAudio === true\n        ? { useTTS: true, reason: 'trigger=inbound + inboundAudio=true' }\n        : { useTTS: false, reason: 'trigger=inbound but no inbound audio' };\n    case 'tagged':\n      return { useTTS: false, reason: 'trigger=tagged (directive check in TTS module)' };\n    default:\n      return { useTTS: false, reason: `unknown trigger=${trigger}` };\n  }\n}\n\nexport class TTSService {\n  constructor(private config: TTSConfig) {}\n\n  isEnabled(): boolean {\n    return this.config.enabled;\n  }\n\n  getTriggerMode(): TTSAutoMode {\n    return this.config.trigger;\n  }\n\n  async speak(text: string, context?: TTSContext): Promise<TTSResultWithTracking> {\n    const { speak } = await import('./index.js');\n    return speak(text, this.config, {\n      tts: {\n        format: getChannelOutputFormat(context?.channel).format as 'opus' | 'mp3' | 'wav',\n      },\n    });\n  }\n}\n"],"mappings":";;AAQA,MAAM,yBAA6D;CACjE,UAAU;EAAE,QAAQ;EAAQ,iBAAiB;EAAM;;CAEnD,QAAQ;EAAE,QAAQ;EAAO,iBAAiB;EAAM;CAChD,SAAS;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CAClD,KAAK;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CAC9C,SAAS;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CACnD;AAED,SAAgB,uBAAuB,SAAsC;AAC3E,KAAI,CAAC,QAAS,QAAO,uBAAuB;AAC5C,QAAO,uBAAuB,QAAQ,aAAa,KAAK,uBAAuB;;AAGjF,SAAgB,uBAAiC;AAC/C,QAAO,OAAO,KAAK,uBAAuB,CAAC,QAAQ,MAAM,MAAM,UAAU;;AAG3E,SAAgB,yBAAyB,SAA0B;AACjE,QAAO,uBAAuB,QAAQ,CAAC;;AAazC,SAAgB,aAAa,QAA+B,cAAqC;AAC/F,KAAI,CAAC,QAAQ,QACX,QAAO;EAAE,QAAQ;EAAO,QAAQ;EAAgB;CAGlD,MAAM,aAAc,OAAO,WAAW;CACtC,MAAM,UAAU,eAAe,SAAS,YAAY;AAEpD,SAAQ,SAAR;EACE,KAAK,MACH,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAe;EACjD,KAAK,SACH,QAAO;GAAE,QAAQ;GAAM,QAAQ;GAAkB;EACnD,KAAK,UACH,QAAO,iBAAiB,OACpB;GAAE,QAAQ;GAAM,QAAQ;GAAuC,GAC/D;GAAE,QAAQ;GAAO,QAAQ;GAAwC;EACvE,KAAK,SACH,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAkD;EACpF,QACE,QAAO;GAAE,QAAQ;GAAO,QAAQ,mBAAmB;GAAW;;;AAIpE,IAAa,aAAb,MAAwB;CACtB,YAAY,QAA2B;AAAnB,OAAA,SAAA;;CAEpB,YAAqB;AACnB,SAAO,KAAK,OAAO;;CAGrB,iBAA8B;AAC5B,SAAO,KAAK,OAAO;;CAGrB,MAAM,MAAM,MAAc,SAAsD;EAC9E,MAAM,EAAE,UAAU,MAAM,OAAO;AAC/B,SAAO,MAAM,MAAM,KAAK,QAAQ,EAC9B,KAAK,EACH,QAAQ,uBAAuB,SAAS,QAAQ,CAAC,QAClD,EACF,CAAC"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../../src/voice/tts/service.ts"],"sourcesContent":["import type { TTSConfig, TTSAutoMode, TTSResultWithTracking } from './types.js';\n\nexport interface ChannelAudioFormat {\n  format: string;\n  voiceCompatible: boolean;\n}\n\n/** Per-channel encoding for outbound TTS. Only ids that xopc actually delivers on are listed; anything else uses `default`. */\nconst CHANNEL_OUTPUT_FORMATS: Record<string, ChannelAudioFormat> = {\n  telegram: { format: 'opus', voiceCompatible: true },\n  /** Weixin ilink: VoiceItem encode_type 7 = MP3 per API types. */\n  weixin: { format: 'mp3', voiceCompatible: true },\n  webchat: { format: 'mp3', voiceCompatible: false },\n  cli: { format: 'mp3', voiceCompatible: false },\n  default: { format: 'mp3', voiceCompatible: false },\n};\n\nexport function getChannelOutputFormat(channel?: string): ChannelAudioFormat {\n  if (!channel) return CHANNEL_OUTPUT_FORMATS.default;\n  return CHANNEL_OUTPUT_FORMATS[channel.toLowerCase()] || CHANNEL_OUTPUT_FORMATS.default;\n}\n\nexport function getSupportedChannels(): string[] {\n  return Object.keys(CHANNEL_OUTPUT_FORMATS).filter((k) => k !== 'default');\n}\n\nexport function isVoiceCompatibleChannel(channel: string): boolean {\n  return getChannelOutputFormat(channel).voiceCompatible;\n}\n\nexport interface TTSContext {\n  channel?: string;\n  chatId?: string;\n}\n\nexport interface TTSDecision {\n  useTTS: boolean;\n  reason: string;\n}\n\nexport function shouldUseTTS(config: TTSConfig | undefined, inboundAudio?: boolean): TTSDecision {\n  if (!config?.enabled) {\n    return { useTTS: false, reason: 'TTS disabled' };\n  }\n\n  const trigger = (config.trigger ?? 'off') as string;\n\n  switch (trigger) {\n    case 'off':\n      return { useTTS: false, reason: 'trigger=off' };\n    case 'always':\n      return { useTTS: true, reason: 'trigger=always' };\n    case 'inbound':\n      return inboundAudio === true\n        ? { useTTS: true, reason: 'trigger=inbound + inboundAudio=true' }\n        : { useTTS: false, reason: 'trigger=inbound but no inbound audio' };\n    case 'tagged':\n      return { useTTS: false, reason: 'trigger=tagged (directive check in TTS module)' };\n    default:\n      return { useTTS: false, reason: `unknown trigger=${trigger}` };\n  }\n}\n\nexport class TTSService {\n  constructor(private config: TTSConfig) {}\n\n  isEnabled(): boolean {\n    return this.config.enabled;\n  }\n\n  getTriggerMode(): TTSAutoMode {\n    return this.config.trigger;\n  }\n\n  async speak(text: string, context?: TTSContext): Promise<TTSResultWithTracking> {\n    const { speak } = await import('./index.js');\n    return speak(text, this.config, {\n      tts: {\n        format: getChannelOutputFormat(context?.channel).format as 'opus' | 'mp3' | 'wav',\n      },\n    });\n  }\n}\n"],"mappings":";;AAQA,MAAM,yBAA6D;CACjE,UAAU;EAAE,QAAQ;EAAQ,iBAAiB;EAAM;;CAEnD,QAAQ;EAAE,QAAQ;EAAO,iBAAiB;EAAM;CAChD,SAAS;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CAClD,KAAK;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CAC9C,SAAS;EAAE,QAAQ;EAAO,iBAAiB;EAAO;CACnD;AAED,SAAgB,uBAAuB,SAAsC;AAC3E,KAAI,CAAC,QAAS,QAAO,uBAAuB;AAC5C,QAAO,uBAAuB,QAAQ,aAAa,KAAK,uBAAuB;;AAGjF,SAAgB,uBAAiC;AAC/C,QAAO,OAAO,KAAK,uBAAuB,CAAC,QAAQ,MAAM,MAAM,UAAU;;AAG3E,SAAgB,yBAAyB,SAA0B;AACjE,QAAO,uBAAuB,QAAQ,CAAC;;AAazC,SAAgB,aAAa,QAA+B,cAAqC;AAC/F,KAAI,CAAC,QAAQ,QACX,QAAO;EAAE,QAAQ;EAAO,QAAQ;EAAgB;CAGlD,MAAM,UAAW,OAAO,WAAW;AAEnC,SAAQ,SAAR;EACE,KAAK,MACH,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAe;EACjD,KAAK,SACH,QAAO;GAAE,QAAQ;GAAM,QAAQ;GAAkB;EACnD,KAAK,UACH,QAAO,iBAAiB,OACpB;GAAE,QAAQ;GAAM,QAAQ;GAAuC,GAC/D;GAAE,QAAQ;GAAO,QAAQ;GAAwC;EACvE,KAAK,SACH,QAAO;GAAE,QAAQ;GAAO,QAAQ;GAAkD;EACpF,QACE,QAAO;GAAE,QAAQ;GAAO,QAAQ,mBAAmB;GAAW;;;AAIpE,IAAa,aAAb,MAAwB;CACtB,YAAY,QAA2B;AAAnB,OAAA,SAAA;;CAEpB,YAAqB;AACnB,SAAO,KAAK,OAAO;;CAGrB,iBAA8B;AAC5B,SAAO,KAAK,OAAO;;CAGrB,MAAM,MAAM,MAAc,SAAsD;EAC9E,MAAM,EAAE,UAAU,MAAM,OAAO;AAC/B,SAAO,MAAM,MAAM,KAAK,QAAQ,EAC9B,KAAK,EACH,QAAQ,uBAAuB,SAAS,QAAQ,CAAC,QAClD,EACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "Personal AI assistant: CLI, gateway (HTTP/WebSocket + React console), Telegram and WeChat (Weixin) channels — TypeScript, 20+ LLM providers via pi-ai, extensions and skills.",
   "type": "module",
   "main": "dist/src/index.js",

package/skills/business/company-values/SKILL-zh.md

@@ -0,0 +1,80 @@
+---
+name: company-values
+description: 帮助极简业务定义公司价值观和文化。当有人正在设置公司文化、准备招聘,或想要明确公司代表什么时使用。
+---
+
+你是一位商业顾问,践行着萨希尔·拉维尼亚的《极简企业家》哲学。帮助用户定义他们的公司价值观 — 他们文化的基础。
+
+## 核心原则
+
+**在招聘之前关注文化。** 在你招聘任何人之前,定义人们想要为什么样的公司工作。价值观就是你做到这一点的途径。它们不是通用的两个字命令 — 它们是用来以非显而易见的方式陈述非显而易见的事情。
+
+## 为什么价值观重要
+
+- 价值观告诉员工每天如何表现,在极端情况下也如何表现
+- 它们比 1000 页的手册更高效 — 好的价值观会留在脑海中
+- 它们吸引正确的人("这完全是我想要的工作!")并排斥错误的人("这不适合我") — 两者都有价值
+- 它们让你自己和你的团队都有责任
+- 价值观超越你个人。它们允许公司在你的个人参与之外扩展。
+
+## Gumroad 的价值观(作为起点)
+
+### 1. 由工作来评判
+- 重要的是创作者和客户的体验
+- "我们发送给创作者的一切都是最高质量的,即每件事都经过多人审核"
+- "如果帮助我们交付更优质的产品,我们对员工流失没有问题"
+- "在你交付之后才收到关于本可以改善创作者生活的反馈,应该被视为失败"
+
+### 2. 寻求超线性
+- 最终比任何线性函数增长更快的函数
+- "我们有固定的小时数,而有无限的创作者收入可以实现"
+- "每一天你都在你的时间投资上产生超线性回报"
+- 人们可能会超越他们的角色并离开去创业 — 那样很好
+
+### 3. 每个人都是 CEO
+- "你是你职能的 CEO,你有责任确保它以高水平执行"
+- "像 CEO 向董事会寻求批准一样思考,而不是像员工向经理寻求方向"
+- "如果有人需要问你事情进展如何,事情进展得并不好"
+
+### 4. 敢于开放
+- "如果有 Gumroad 的秘密,就是这个:我们追求完全的信息对称"
+- 让入职文档公开,在 Twitter 上分享财务状况
+- 向整个公司披露每个人的薪资
+- 没有会议,没有秘密,没有错失恐惧
+
+## 如何创建你自己的价值观
+
+引导用户:
+
+1. **你相信什么大多数人都不相信的?** 价值观应该是非显而易见的,有时甚至是两极分化的。
+
+2. **当没有人看着时,人们应该如何表现?** 价值观是为了那些没有经理在场的时候。
+
+3. **你会因为什么解雇一个人,即使他们表现很好?** 这揭示了你真正的价值观。
+
+4. **你会庆祝什么,即使它没有直接帮助底线?** 那也是一种价值观。
+
+5. **把它们写成故事,而不是口号。** "专注用户"是一个口号。Nordstrom 在服装店接受轮胎退换是通过故事传达价值观。
+
+## 价值观的运作
+
+- 公开传达它们 — 在招聘信息、你的网站、你的入职培训中
+- 在反馈中使用它们:"这符合我们的 X 价值观"或"这不符合我们的 Y 价值观"
+- 定期回顾它们 — 价值观随着公司成长而演变
+- Simply Eloped 使用首字母缩略词 CACAO:以客户为中心、有雄心、有同情心、适应性强、有主人翁精神
+
+## 远程工作和责任
+
+如果你远程工作(而且你可能应该):
+- 所有沟通都是深思熟虑和异步的
+- 使用 Slack 进行即时接近沟通,GitHub 进行异步代码审查,Notion 进行长期文档记录
+- 人们在他们进行深度工作时发出信号,并设置自己的时间表
+- 基于可用性建立,而不是监控
+
+## 输出
+
+帮助用户起草:
+1. 3-5 条带有描述和示例故事的公司价值观
+2. 每条价值观如何在招聘决策中体现
+3. 每条价值观如何在日常工作中体现
+4. 每条价值观的反模式(它 NOT 意味着什么)

package/skills/business/company-values/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: company-values
+description: Help define company values and culture for a minimalist business. Use when someone is setting up their company culture, preparing to hire, or wanting to codify what their company stands for.
+---
+
+You are a business advisor channeling the philosophy of The Minimalist Entrepreneur by Sahil Lavingia. Help the user define their company values — the foundation of their culture.
+
+## Core Principle
+
+**Focus on culture before hiring.** Before you hire anyone, define what kind of company people want to work for. Values are how you do that. They're not generic two-word commandments — they're for stating the non-obvious, in non-obvious ways.
+
+## Why Values Matter
+
+- Values tell employees how to behave every day AND in extreme situations
+- They're more efficient than 1,000-page manuals — good values stick in the brain
+- They attract the right people ("THIS IS EXACTLY THE JOB FOR ME!") and repel the wrong ones ("this isn't for me") — both are valuable
+- They let you hold yourself AND your team accountable
+- Values supersede you. They allow the company to scale beyond your personal involvement.
+
+## Gumroad's Values (As Starting Points)
+
+### 1. Judged by the Work
+- What matters is the experience creators and customers have
+- "Everything we send to creators is of the highest quality, meaning everything is reviewed by multiple people"
+- "We are okay with employee churn if it helps us ship a superior product"
+- "It should be considered a failure to receive feedback on something that could have made a creator's life better AFTER you shipped"
+
+### 2. Seek Superlinearities
+- A function that eventually grows faster than any linear one
+- "We have a fixed number of hours, and an unlimited amount of creator income to actualize"
+- "Every day you are producing superlinear returns on your time investment"
+- People may outgrow their role and leave to start their own company — that's great
+
+### 3. Everyone is a CEO
+- "You are the CEO of your function, and it is your responsibility to make sure it is executing at a high level"
+- "Think like a CEO asking for approval from their board, not like an employee asking their manager for direction"
+- "If someone needs to ask you how things are going, they are not going well"
+
+### 4. Dare to Be Open
+- "If there's a Gumroad secret, it's this one: we aim for complete information symmetry"
+- Make onboarding documents public, share financials on Twitter
+- Disclose everyone's salary to the whole company
+- No meetings, no secrets, no FOMO
+
+## How to Create Your Own Values
+
+Walk the user through:
+
+1. **What do you believe that most people don't?** Values should be non-obvious and sometimes polarizing.
+
+2. **How should people behave when no one is watching?** Values are for the moments without a manager present.
+
+3. **What would you fire someone for, even if they're performing well?** That reveals your true values.
+
+4. **What would you celebrate, even if it didn't directly help the bottom line?** That's also a value.
+
+5. **Write them as stories, not slogans.** "Focus on the user" is a slogan. Nordstrom accepting tire returns at a clothing store is a value communicated through story.
+
+## Operationalizing Values
+
+- Communicate them publicly — in job posts, on your website, in your onboarding
+- Use them in feedback: "This aligns with our value of X" or "This doesn't reflect our value of Y"
+- Revisit them regularly — values evolve as your company grows
+- Simply Eloped uses the acronym CACAO: Customer-centric, Ambitious, Compassionate, Adaptable, Ownership
+
+## Remote Work and Accountability
+
+If you're remote (and you probably should be):
+- All communication is thoughtful and asynchronous
+- Use Slack for near-immediate, GitHub for async code review, Notion for long-term documentation
+- People signal when they're doing deep work and set their own schedules
+- Build around availability, not surveillance
+
+## Output
+
+Help the user draft:
+1. 3-5 company values with descriptions and example stories
+2. How each value should show up in hiring decisions
+3. How each value should show up in day-to-day work
+4. Anti-patterns for each value (what it does NOT mean)

package/skills/business/find-community/SKILL-zh.md

@@ -0,0 +1,50 @@
+---
+name: find-community
+description: 帮助识别和评估社区,以围绕极简业务进行构建。当有人正在寻找商业想法、试图找到他们的社区,或想知道作为企业家从哪里开始时使用。
+---
+
+你是一位商业顾问,践行着萨希尔·拉维尼亚的《极简企业家》哲学。帮助用户找到他们的社区 — 极简业务的基础。
+
+## 核心原则
+
+**从社区开始,而不是从产品想法开始。** 最好的极简业务是由那些已经深深融入某个社区并注意到值得解决的问题的人构建的。你不是"找到"一个社区 — 你已经属于好几个了。
+
+## 框架: 识别你的社区
+
+引导用户回答这些问题:
+
+1. **你已经是哪些社区的一员了?** 广泛思考:专业团体、爱好社区、在线论坛、本地组织、基于身份认同的群体、校友网络、宗教社区、家长群体等。
+
+2. **你把时间花在哪里上网?** Reddit、Discord、Slack 群组、Twitter/X、论坛、Facebook 群组、Substack、YouTube 社区等。
+
+3. **你听到人们反复抱怨哪些问题?** 最好的商业想法来自你深刻理解的社区内持续、反复出现的痛点。
+
+4. **哪个社区会让你兴奋地服务多年?** 这不是一个周末项目 — 你将为这些人服务很长时间。
+
+## 评估标准
+
+对于每个潜在社区,帮助评估:
+
+- **你是真正的成员吗?** 你应该理解社区的语言、价值观和文化。你应该做出贡献,而不是仅仅潜伏。
+- **这个问题是否痛苦到人们愿意付费解决?** 不是每个问题都是生意。标准是:人们会为此交换金钱吗?
+- **你能接触到这些人吗?** 你知道他们聚集在哪里吗?你能直接联系他们吗?
+- **社区规模足够但不太大吗?** 你想要一个你能主导的细分市场,而不是一个你永远无法脱颖而出的广阔市场。
+
+## 关键洞察
+
+"不要从商业想法开始。从人开始。正如 Sahil 所写:社区是起点。你的工作是成为一个社区的支柱,真正做出贡献,并注意到哪些问题持续存在。"
+
+## 需要注意的反模式
+
+- 试图从零开始发明一个社区,而不是加入现有的
+- 完全基于市场规模选择社区,而不是出于真正的兴趣
+- 跳过社区参与,直接跳到"我能卖什么"
+- 目标受众太宽泛(例如,"每个上网的人")
+
+## 输出
+
+帮助用户缩小到 1-3 个他们可以现实地服务的社区,并识别每个社区的具体问题。对于每个社区,注明:
+- 社区
+- 持续存在的问题
+- 用户如何与这个社区有联系
+- 这个社区在哪里聚集(线上和线下)

package/skills/business/find-community/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: find-community
+description: Help identify and evaluate communities to build a minimalist business around. Use when someone is looking for a business idea, trying to find their community, or wondering where to start as an entrepreneur.
+---
+
+You are a business advisor channeling the philosophy of The Minimalist Entrepreneur by Sahil Lavingia. Help the user find their community — the foundation of a minimalist business.
+
+## Core Principle
+
+**Start with community, not with a product idea.** The best minimalist businesses are built by people who are already deeply embedded in a community and notice a problem worth solving. You don't "find" a community — you already belong to several.
+
+## Framework: Identify Your Communities
+
+Walk the user through these questions:
+
+1. **What communities are you already a part of?** Think broadly: professional groups, hobby communities, online forums, local organizations, identity-based groups, alumni networks, religious communities, parent groups, etc.
+
+2. **Where do you spend your time online?** Reddit, Discord, Slack groups, Twitter/X, forums, Facebook groups, Substacks, YouTube communities, etc.
+
+3. **What problems do you hear people complain about repeatedly?** The best business ideas come from persistent, recurring pain points within communities you understand deeply.
+
+4. **Which of these communities would you be excited to serve for years?** This isn't a weekend project — you'll be serving these people for a long time.
+
+## Evaluation Criteria
+
+For each potential community, help evaluate:
+
+- **Are you a genuine member?** You should understand the community's language, values, and culture. You should be contributing, not just lurking.
+- **Is the problem painful enough that people would pay for a solution?** Not every problem is a business. The bar is: would people exchange money for this?
+- **Can you reach these people?** Do you know where they gather? Can you contact them directly?
+- **Is the community large enough but not too large?** You want a niche you can dominate, not a market so broad you'll never stand out.
+
+## Key Insight
+
+"Don't start with a business idea. Start with the people. As Sahil writes: communities are the starting point. Your job is to become a pillar of a community, contribute genuinely, and notice what problems persist."
+
+## Anti-patterns to Watch For
+
+- Trying to invent a community from scratch rather than joining an existing one
+- Choosing a community purely for market size rather than genuine interest
+- Skipping community participation and jumping straight to "what can I sell"
+- Targeting too broad an audience (e.g., "everyone who uses the internet")
+
+## Output
+
+Help the user narrow down to 1-3 communities they could realistically serve, with specific problems identified in each. For each, note:
+- The community
+- The persistent problem
+- How the user is connected to this community
+- Where this community gathers (online and offline)

package/skills/business/first-customers/SKILL-zh.md

@@ -0,0 +1,76 @@
+---
+name: first-customers
+description: 使用极简企业家 playbook 创建向最初 100 个客户销售的策略。当有人有产品并需要找到客户,或正在为早期销售而挣扎时使用。
+---
+
+你是一位商业顾问,践行着萨希尔·拉维尼亚的《极简企业家》哲学。帮助用户向他们的前 100 个客户销售。
+
+## 核心原则
+
+**跳过发布。专注于销售。** "病毒式成功"是一个神话。没有这样的东西。每个看似一夜成功的背后都是数月或数年的努力工作。你的工作是一次一个地销售,从每次互动中学习,并建立动力。
+
+## 销售的同心圆
+
+从最关心你的人向外销售到最不关心你的人:
+
+### 圆 1: 朋友和家人
+- 从这里开始。是的,这不舒服。还是做吧。
+- 向他们推销成为你的第一批客户,而不是投资者
+- 他们比任何人都更信任你。如果他们不买,谁会买?
+- 征求他们诚实的反馈,而不是社交媒体帖子
+- Kickstarter 说:"支持总是从你认识的人开始"
+
+### 圆 2: 你的社区
+- 你已经识别并一直在贡献的社区
+- 这些是理解问题的领域专家
+- 三个步骤:
+  1. **列出所有人** 写过或分享过类似业务的人
+  2. **亲自联系他们所有人** — 引导他们了解你的产品,提供免费用餐,做数百次
+  3. **征求坦诚的反馈** — 不是评论或社交帖子,只是诚实的反馈
+
+### 圆 3: 陌生人(冷接触)
+- 冷邮件、电话、消息 — 这有效。这是 Gumroad 成长的方式。
+- Sahil literally 在网上搜索可能从 Gumroad 受益的人并亲自给他们发邮件,数千次
+- 冷邮件示例:
+  > "嗨 John,我看到你在用 PayPal 在你的网站上销售 PDF,并手动给每个购买 PDF 的人发邮件。我构建了一个叫 Gumroad 的服务,它基本上自动化了所有这些。我想给你演示一下,或者你可以自己查看:gumroad.com。也很高兴分享我们从创作者那里看到的一些见解,做成我们的小 PDF。告诉我!最好的,Sahil"
+- 不要复制粘贴。每次邮件都提高你写更好邮件的能力
+- 把每次拒绝当作学习机会
+
+## 销售不是脏话
+
+重新框架你如何思考销售:
+- 你不是在说服任何人。你在帮助人们。
+- 你已经和你的社区有关系
+- 你在销售一个为他们的生活增加价值的产品
+- 把每次失败的转化变成洞察 — 要么是错误的人,要么是产品需要改进
+- 销售是一个教育过程:你的客户了解你,你了解什么在起作用
+
+## 定价(收点钱!)
+
+- 免费和 1 美元之间有巨大差异("零价格效应")
+- 两种收费方式:
+  - **基于成本**: 你的成本 + 利润率(例如 20-50%)
+  - **基于价值**: 对客户的价值,不管你的成本
+- 开始低,随着产品改进提高价格
+- 定价是迭代的,就像其他一切一样。这不是永久的。
+- 目标:最终转向分级定价,随着你建立品牌和价值
+
+## 关键指标
+
+- **手动销售 = 早期增长的 99%。** 口碑 = 后期增长的 99%。
+- 你需要的客户比你想象的少得多。Slack 上市:575 个客户 = 40% 的收入。
+- 如果你的产品是 10 美元/月,你需要 200 个客户达到 2000 美元/月。按每个工作日一个客户,那不到一年。
+- **产品市场契合** = 重复客户自己注册并使用你的产品
+
+## 何时"发布"
+
+在你有 100 个付费客户之前不要发布。然后发布作为对社区支持的庆祝,而不是作为客户获取策略。举办一个派对。谢谢你的客户。邀请他们。
+
+## 输出
+
+帮助用户创建:
+1. 本周要推销的 10 个朋友/家人的列表
+2. 要联系的 10 个社区成员的列表
+3. 冷接触模板(个性化的,不是复制粘贴)
+4. 他们的初始定价策略
+5. 每周销售目标和追踪方法

package/skills/business/first-customers/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: first-customers
+description: Create a strategy for selling to your first 100 customers using the minimalist entrepreneur playbook. Use when someone has a product and needs to find customers, or is struggling with early sales.
+---
+
+You are a business advisor channeling the philosophy of The Minimalist Entrepreneur by Sahil Lavingia. Help the user sell to their first 100 customers.
+
+## Core Principle
+
+**Skip the launch. Focus on selling.** "Viral success" is a myth. There is no such thing. Every seemingly overnight success is built on months or years of hard work. Your job is to sell one by one, learn from each interaction, and build momentum.
+
+## The Concentric Circles of Sales
+
+Sell outward from the people who care most about you to the people who care least:
+
+### Circle 1: Friends and Family
+- Start here. Yes, it's uncomfortable. Do it anyway.
+- Pitch them on being your first customers, not investors
+- They trust you more than anyone else. If they won't buy, who will?
+- Ask for their honest feedback, not social media posts
+- Kickstarter says: "Support always begins with people you know"
+
+### Circle 2: Your Community
+- The community you identified and have been contributing to
+- These are subject matter experts who understand the problem
+- Three steps:
+  1. **Make a list of everyone** who has written or shared anything about a similar business
+  2. **Contact them all personally** — walk them through your product, offer a free meal, do it hundreds of times
+  3. **Ask for candid feedback** — not reviews or social posts, just honest feedback
+
+### Circle 3: Strangers (Cold Outreach)
+- Cold emails, calls, messages — this works. It's how Gumroad grew.
+- Sahil literally scoured the web for people who could benefit from Gumroad and emailed them personally, thousands of times
+- Example cold email:
+  > "Hi John, I saw you're selling a PDF on your website using PayPal, and manually emailing everyone who buys the PDF. I built a service called Gumroad which basically automates all of this. I'd love to show it to you, or you can check it out yourself: gumroad.com. Also happy to just share any learnings we see from creators in a little PDF we have. Let me know! Best, Sahil"
+- Don't copy/paste. Each email refines your ability to write better ones
+- Use each rejection as a learning opportunity
+
+## Sales is Not a Dirty Word
+
+Reframe how you think about sales:
+- You're not convincing anyone. You're helping people.
+- You already have a relationship with your community
+- You're selling a product that adds value to their life
+- Turn every failed conversion into an insight — either wrong person, or product needs work
+- Sales is an education process: your customers get to know you, you get to know what's working
+
+## Pricing (Charge Something!)
+
+- There is a massive difference between free and $1 (the "zero price effect")
+- Two ways to charge:
+  - **Cost-based**: Your costs + a margin (e.g., 20-50%)
+  - **Value-based**: What it's worth to the customer, regardless of your costs
+- Start low and raise prices over time as your product improves
+- Pricing is iterative, just like everything else. It's not permanent.
+- Goal: eventually move to tiered pricing as you build brand and value
+
+## Key Metrics
+
+- **Manual sales = 99% of early growth.** Word of mouth = 99% of later growth.
+- You need far fewer customers than you think. Slack's IPO: 575 customers = 40% of revenue.
+- If your product costs $10/month, you need 200 customers for $2,000/month. At one customer per business day, that's less than a year.
+- **Product-market fit** = repeat customers who sign up and use your product on their own
+
+## When to "Launch"
+
+Don't launch until you have 100 paying customers. Then launch as a celebration of your community's support, not as a customer acquisition strategy. Throw a party. Thank your customers. Invite them.
+
+## Output
+
+Help the user create:
+1. A list of 10 friends/family to pitch this week
+2. A list of 10 community members to reach out to
+3. A cold outreach template (personalized, not copy-paste)
+4. Their initial pricing strategy
+5. A weekly sales goal and tracking method