mu-coding 0.4.0 → 0.8.0

package/src/cli.ts

@@ -1,96 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import type { ChatMessage } from 'mu-provider';
-import { getLatestSession, loadSession } from './session';
-
-interface CliArgs {
-  model?: string;
-  continueSession?: boolean;
-  sessionPath?: string;
-}
-
-function printHelp(): never {
-  console.log(`mu — minimal terminal AI assistant
-
-Usage:
-  mu                        Start interactive chat
-  mu -m model               Interactive with specific model
-  mu -c                     Continue most recent session
-  mu --session <path>       Resume a specific session file
-  mu install npm:<package>  Install a plugin from npm
-  mu uninstall npm:<pkg>    Remove an installed plugin
-  mu -v, --version          Print version and exit
-
-Config (XDG):
-  ~/.config/mu/config.json  — configuration (baseUrl, model, streamTimeoutMs)
-  ~/.config/mu/SYSTEM.md    — system prompt
-  ~/.local/share/mu/sessions/ — saved conversation sessions (JSONL)
-  ~/.cache/mu/repomap/        — code index cache
-
-Keyboard shortcuts (interactive):
-  Ctrl+C  Abort / Quit (press twice)
-  Esc     Stop generation (press twice while streaming)
-  Enter       Send message
-  Shift+Enter New line
-  Ctrl+S      Send message
-  ↑ / ↓   Navigate input history
-  Ctrl+N  New conversation
-  Ctrl+M  Cycle models
-  Ctrl+O  Model picker
-  Ctrl+V  Paste image from clipboard`);
-  process.exit(0);
-}
-
-function printVersion(): never {
-  const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
-  console.log(`mu ${pkg.version}`);
-  process.exit(0);
-}
-
-export function parseArgs(): CliArgs {
-  const args = process.argv.slice(2);
-  const result: CliArgs = {};
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '-m' && args[i + 1]) {
-      result.model = args[++i];
-    } else if (arg === '-c' || arg === '--continue') {
-      result.continueSession = true;
-    } else if (arg === '--session' && args[i + 1]) {
-      result.sessionPath = args[++i];
-    } else if (arg === '-v' || arg === '--version') {
-      printVersion();
-    } else if (arg === '-h' || arg === '--help') {
-      printHelp();
-    }
-  }
-
-  return result;
-}
-
-export function resolveInitialMessages(cliArgs: CliArgs): ChatMessage[] | undefined {
-  if (cliArgs.sessionPath) {
-    const msgs = loadSession(cliArgs.sessionPath);
-    if (msgs.length === 0) {
-      console.error(`Error: session file is empty or not found: ${cliArgs.sessionPath}`);
-      process.exit(1);
-    }
-    return msgs;
-  }
-  if (cliArgs.continueSession) {
-    const latest = getLatestSession();
-    if (!latest) {
-      console.error('Error: no sessions found');
-      process.exit(1);
-    }
-    const msgs = loadSession(latest);
-    if (msgs.length === 0) {
-      console.error('Error: latest session is empty');
-      process.exit(1);
-    }
-    console.log(`Resuming session: ${latest}`);
-    return msgs;
-  }
-  return undefined;
-}

package/src/clipboard.ts

@@ -1,62 +0,0 @@
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync, statSync, unlinkSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import type { ImageAttachment } from 'mu-provider';
-
-const CLIPBOARD_TIMEOUT = 3000;
-
-function tryExecSync(command: string): boolean {
-  try {
-    execSync(command, { stdio: 'pipe', timeout: CLIPBOARD_TIMEOUT });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function extractPlatformImage(tmpFile: string): boolean {
-  if (process.platform === 'darwin') {
-    if (tryExecSync('which pngpaste')) {
-      return tryExecSync(`pngpaste "${tmpFile}"`);
-    }
-    return tryExecSync(
-      `osascript -e 'tell application "System Events" -e 'set imgData to the clipboard as «class PNGf»' -e 'set fp to open for access POSIX file "${tmpFile}" with write permission' -e 'write imgData to fp' -e 'close access fp' -e 'end tell'`,
-    );
-  }
-  if (process.platform === 'linux') {
-    if (tryExecSync(`xclip -selection clipboard -t image/png -o > "${tmpFile}"`)) {
-      return true;
-    }
-    return tryExecSync(`wl-paste --type image/png > "${tmpFile}"`);
-  }
-  return false;
-}
-
-function readTmpAsAttachment(tmpFile: string): ImageAttachment | null {
-  if (!existsSync(tmpFile)) {
-    return null;
-  }
-  if (statSync(tmpFile).size === 0) {
-    unlinkSync(tmpFile);
-    return null;
-  }
-  const buffer = readFileSync(tmpFile);
-  unlinkSync(tmpFile);
-  return { data: buffer.toString('base64'), mimeType: 'image/png', name: 'clipboard.png' };
-}
-
-export function readClipboardImage(): ImageAttachment | null {
-  const tmpFile = join(tmpdir(), `mu-clip-${Date.now()}.png`);
-  try {
-    if (!extractPlatformImage(tmpFile)) {
-      return null;
-    }
-    return readTmpAsAttachment(tmpFile);
-  } catch {
-    if (existsSync(tmpFile)) {
-      unlinkSync(tmpFile);
-    }
-    return null;
-  }
-}

package/src/config.ts

@@ -1,116 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import type { ProviderConfig } from 'mu-provider';
-
-export interface AppConfig extends ProviderConfig {
-  plugins?: Array<string | { name: string; config?: Record<string, unknown> }>;
-}
-
-export function getPluginsDir(): string {
-  return join(CONFIG_DIR, 'plugins');
-}
-
-// XDG Base Directory paths
-const HOME = homedir();
-const CONFIG_DIR = process.env.XDG_CONFIG_HOME ? join(process.env.XDG_CONFIG_HOME, 'mu') : join(HOME, '.config', 'mu');
-const DATA_DIR = process.env.XDG_DATA_HOME
-  ? join(process.env.XDG_DATA_HOME, 'mu')
-  : join(HOME, '.local', 'share', 'mu');
-const CACHE_DIR = process.env.XDG_CACHE_HOME ? join(process.env.XDG_CACHE_HOME, 'mu') : join(HOME, '.cache', 'mu');
-
-const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
-const SYSTEM_PROMPT_PATH = join(CONFIG_DIR, 'SYSTEM.md');
-
-export function getConfigDir(): string {
-  return CONFIG_DIR;
-}
-
-export function getDataDir(): string {
-  return DATA_DIR;
-}
-
-export function getCacheDir(): string {
-  return CACHE_DIR;
-}
-
-function tryRead(path: string): string | undefined {
-  try {
-    return readFileSync(path, 'utf-8').trim() || undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-function tryParseJson(text: string | undefined): Partial<AppConfig> {
-  if (!text) {
-    return {};
-  }
-  try {
-    return JSON.parse(text);
-  } catch {
-    return {};
-  }
-}
-
-function envInt(key: string): number | undefined {
-  const v = process.env[key];
-  if (!v) {
-    return undefined;
-  }
-  const n = Number.parseInt(v, 10);
-  return Number.isNaN(n) ? undefined : n;
-}
-
-function envFloat(key: string): number | undefined {
-  const v = process.env[key];
-  if (!v) {
-    return undefined;
-  }
-  const n = Number.parseFloat(v);
-  return Number.isNaN(n) ? undefined : n;
-}
-
-export function loadConfig(cliModel?: string): AppConfig {
-  const file = tryParseJson(tryRead(CONFIG_PATH));
-
-  const config: AppConfig = {
-    baseUrl: process.env.MU_BASE_URL || file.baseUrl || 'http://localhost:8080/v1',
-    model: cliModel || process.env.MU_MODEL || file.model,
-    maxTokens: envInt('MU_MAX_TOKENS') ?? file.maxTokens ?? 4096,
-    temperature: envFloat('MU_TEMPERATURE') ?? file.temperature ?? 0.7,
-    streamTimeoutMs: envInt('MU_STREAM_TIMEOUT') ?? file.streamTimeoutMs ?? 60_000,
-    systemPrompt: process.env.MU_SYSTEM_PROMPT || file.systemPrompt || tryRead(SYSTEM_PROMPT_PATH),
-    plugins: file.plugins,
-  };
-
-  if (!existsSync(CONFIG_PATH)) {
-    mkdirSync(CONFIG_DIR, { recursive: true });
-    const KEYS = [
-      'baseUrl',
-      'model',
-      'maxTokens',
-      'temperature',
-      'streamTimeoutMs',
-      'systemPrompt',
-      'plugins',
-    ] as const;
-    const fileConfig = Object.fromEntries(
-      KEYS.filter((k) => file[k] !== undefined).map((k) => [k, file[k]]),
-    ) as Partial<AppConfig>;
-    writeFileSync(CONFIG_PATH, JSON.stringify(fileConfig, null, 2), 'utf-8');
-  }
-
-  return config;
-}
-
-export function saveConfig(updates: Partial<AppConfig>): void {
-  const file = tryParseJson(tryRead(CONFIG_PATH));
-  const merged = { ...file, ...updates };
-  const KEYS = ['baseUrl', 'model', 'maxTokens', 'temperature', 'streamTimeoutMs', 'systemPrompt', 'plugins'] as const;
-  const fileConfig = Object.fromEntries(
-    KEYS.filter((k) => merged[k] !== undefined).map((k) => [k, merged[k]]),
-  ) as Partial<AppConfig>;
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_PATH, JSON.stringify(fileConfig, null, 2), 'utf-8');
-}

package/src/main.tsx

@@ -1,147 +0,0 @@
-#!/usr/bin/env bun
-import { readdirSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import { join, resolve } from 'node:path';
-import { render } from 'ink';
-import { createBuiltinPlugin, PluginRegistry } from 'mu-agents';
-import { parseArgs, resolveInitialMessages } from './cli';
-import { type AppConfig, getDataDir, getPluginsDir, loadConfig } from './config';
-import { handleSubcommand } from './subcommands';
-import { ChatPanel } from './tui/components/chat/ChatPanel';
-import { InkUIService } from './tui/services/uiService';
-
-function discoverPluginFiles(): string[] {
-  const dir = getPluginsDir();
-  try {
-    return readdirSync(dir)
-      .filter((f) => f.endsWith('.ts'))
-      .map((f) => join(dir, f));
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Resolve an npm: specifier to an absolute path via the data dir's node_modules.
- */
-function formatPluginError(name: string, err: unknown): string {
-  const parts: string[] = [`Plugin "${name}" failed`];
-  let current: unknown = err;
-  while (current) {
-    if (current instanceof Error) {
-      parts.push(current.message);
-      current = current.cause;
-    } else {
-      parts.push(String(current));
-      break;
-    }
-  }
-  return parts.join(': ');
-}
-
-function resolveNpmPlugin(specifier: string): string {
-  const bare = specifier.slice(4);
-  const dataDir = getDataDir();
-  try {
-    const require = createRequire(resolve(dataDir, 'package.json'));
-    return require.resolve(bare);
-  } catch (err) {
-    throw new Error(`Cannot resolve "${bare}" from ${dataDir}/node_modules — is it installed?`, { cause: err });
-  }
-}
-
-/**
- * Load a plugin by name or path, resolving from this package's context.
- * This allows workspace packages (like mu-pi-compat) to be found even though
- * mu-agents' registry can't resolve them from its own location.
- *
- * Plugins prefixed with npm: are resolved from ~/.local/share/mu/node_modules/.
- */
-async function loadPluginFromHere(
-  registry: PluginRegistry,
-  name: string,
-  pluginConfig?: Record<string, unknown>,
-  uiService?: InkUIService,
-): Promise<void> {
-  try {
-    const target = name.startsWith('npm:') ? resolveNpmPlugin(name) : name;
-    const mod = await import(target);
-    const factory = mod.default ?? mod.createPlugin;
-
-    if (typeof factory === 'function') {
-      const plugin = factory(pluginConfig ?? {});
-      await registry.register(plugin);
-    } else if (typeof mod === 'object' && mod !== null && 'name' in mod) {
-      await registry.register(mod);
-    } else {
-      const exportKeys = Object.keys(mod).join(', ') || '(none)';
-      uiService?.notify(`Plugin "${name}": no plugin export found. Exports: [${exportKeys}]`, 'error');
-    }
-  } catch (err) {
-    // npm: plugins don't fall back — they must resolve from data dir
-    if (name.startsWith('npm:')) {
-      uiService?.notify(formatPluginError(name, err), 'error');
-      return;
-    }
-    // Non-npm plugins fall back to registry loader (for file paths)
-    try {
-      await registry.loadPlugin(name, pluginConfig);
-    } catch (fallbackErr) {
-      uiService?.notify(formatPluginError(name, fallbackErr), 'error');
-    }
-  }
-}
-
-async function createRegistry(cwd: string, config: AppConfig, uiService: InkUIService) {
-  const registry = new PluginRegistry({ cwd, config: {} });
-
-  // Register built-in tools (read, write, edit, bash)
-  await registry.register(createBuiltinPlugin());
-
-  // Auto-load .ts plugin files from ~/.config/mu/plugins/
-  for (const filePath of discoverPluginFiles()) {
-    await registry.loadPlugin(filePath);
-  }
-
-  // Load configured plugins
-  if (config.plugins?.length) {
-    for (const entry of config.plugins) {
-      const name = typeof entry === 'string' ? entry : entry.name;
-      const pluginConfig = typeof entry === 'string' ? undefined : entry.config;
-
-      // Inject uiService for plugins that accept it (duck typing)
-      const finalConfig = pluginConfig ? { ...pluginConfig, ui: uiService } : { ui: uiService };
-
-      await loadPluginFromHere(registry, name, finalConfig, uiService);
-    }
-  }
-
-  return registry;
-}
-
-async function main() {
-  if (await handleSubcommand()) return;
-
-  const cliArgs = parseArgs();
-  const config = loadConfig(cliArgs.model);
-  const root = process.cwd();
-
-  const uiService = new InkUIService();
-  const registry = await createRegistry(root, config, uiService);
-
-  const initialMessages = resolveInitialMessages(cliArgs);
-
-  render(<ChatPanel config={config} initialMessages={initialMessages} registry={registry} uiService={uiService} />, {
-    exitOnCtrlC: false,
-    kittyKeyboard: { mode: 'enabled' },
-  });
-
-  process.on('exit', () => {
-    registry.shutdown();
-  });
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/src/project.ts

@@ -1,32 +0,0 @@
-import { execSync } from 'node:child_process';
-import { createHash } from 'node:crypto';
-
-function findGitRoot(from: string): string | null {
-  try {
-    const root = execSync('git rev-parse --show-toplevel', {
-      cwd: from,
-      encoding: 'utf-8',
-      stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-    return root || null;
-  } catch {
-    return null;
-  }
-}
-
-function getProjectRoot(): string {
-  const cwd = process.cwd();
-  return findGitRoot(cwd) ?? cwd;
-}
-
-export function getProjectId(): string {
-  const root = getProjectRoot();
-  const hash = createHash('sha256').update(root).digest('hex').slice(0, 12);
-  const name = root.split('/').pop() || 'unknown';
-  return `${name}-${hash}`;
-}
-
-export function getProjectName(): string {
-  const root = getProjectRoot();
-  return root.split('/').pop() || root;
-}

package/src/session.ts

@@ -1,95 +0,0 @@
-import { mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import type { ChatMessage } from 'mu-provider';
-import { getDataDir } from './config';
-import { getProjectId, getProjectName } from './project';
-
-function getProjectSessionsDir(): string {
-  return join(getDataDir(), 'sessions', getProjectId());
-}
-
-function getSortedSessionFiles(): string[] {
-  try {
-    const dir = getProjectSessionsDir();
-    return readdirSync(dir)
-      .filter((f) => f.endsWith('.jsonl'))
-      .sort()
-      .reverse();
-  } catch {
-    return [];
-  }
-}
-
-export interface SessionInfo {
-  path: string;
-  name: string;
-  date: Date;
-  messageCount: number;
-  preview: string;
-  project: string;
-}
-
-export function generateSessionPath(): string {
-  const dir = getProjectSessionsDir();
-  mkdirSync(dir, { recursive: true });
-  const ts = new Date().toISOString().replace(/[:.]/g, '-');
-  return join(dir, `${ts}.jsonl`);
-}
-
-export function saveSession(path: string, messages: ChatMessage[]): void {
-  writeFileSync(path, `${messages.map((m) => JSON.stringify(m)).join('\n')}\n`, 'utf-8');
-}
-
-export function loadSession(path: string): ChatMessage[] {
-  try {
-    const content = readFileSync(path, 'utf-8').trim();
-    if (!content) {
-      return [];
-    }
-    return content
-      .split('\n')
-      .map((line) => {
-        try {
-          return JSON.parse(line) as ChatMessage;
-        } catch {
-          return null;
-        }
-      })
-      .filter((msg): msg is ChatMessage => msg !== null);
-  } catch {
-    return [];
-  }
-}
-
-export function getLatestSession(): string | null {
-  const files = getSortedSessionFiles();
-  return files.length ? join(getProjectSessionsDir(), files[0]) : null;
-}
-
-export function listSessions(): SessionInfo[] {
-  try {
-    const dir = getProjectSessionsDir();
-    mkdirSync(dir, { recursive: true });
-    const files = getSortedSessionFiles();
-    const project = getProjectName();
-
-    return files.map((file) => {
-      const path = join(dir, file);
-      const stat = statSync(path);
-      const messages = loadSession(path);
-      const firstUserMsg = messages.find((m) => m.role === 'user');
-      const preview = firstUserMsg ? firstUserMsg.content.slice(0, 80).replace(/\n/g, ' ') : '(empty)';
-
-      return {
-        path,
-        name: file.replace('.jsonl', ''),
-        date: stat.mtime,
-        messageCount: messages.length,
-        preview,
-        project,
-      };
-    });
-  } catch {
-    return [];
-  }
-}

package/src/tui/commands.ts

@@ -1,33 +0,0 @@
-import type { CommandContext, SlashCommand as PluginSlashCommand } from 'mu-agents';
-
-export interface SlashCommand {
-  name: string;
-  description: string;
-  action?: string;
-  execute?: (args: string) => Promise<string | undefined>;
-}
-
-const BUILTIN_COMMANDS: SlashCommand[] = [
-  { name: '/model', description: 'Select a model', action: 'model' },
-  { name: '/sessions', description: 'List project sessions', action: 'sessions' },
-  { name: '/new', description: 'New conversation', action: 'new' },
-];
-
-export function matchCommands(input: string, pluginCommands: PluginSlashCommand[] = []): SlashCommand[] {
-  if (!input.startsWith('/')) {
-    return [];
-  }
-  const q = input.toLowerCase();
-
-  const fromPlugins: SlashCommand[] = pluginCommands.map((pc) => ({
-    name: `/${pc.name}`,
-    description: pc.description,
-    execute: (args: string) => {
-      const ctx: CommandContext = { messages: [], cwd: process.cwd(), config: {} as CommandContext['config'] };
-      return pc.execute(args, ctx);
-    },
-  }));
-
-  const all = [...BUILTIN_COMMANDS, ...fromPlugins];
-  return all.filter((cmd) => cmd.name.startsWith(q));
-}