joonecli 0.1.1 → 0.2.0

package/src/cli/modelFactory.ts

@@ -1,174 +0,0 @@
-import { BaseChatModel } from "@langchain/core/language_models/chat_models";
-import { pathToFileURL } from "node:url";
-import * as path from "node:path";
-import { JooneConfig } from "./config.js";
-import { getProviderDir, PROVIDER_PACKAGE_MAP } from "./providers.js";
-
-/**
- * Providers that do NOT require an API key (e.g. local models).
- */
-const NO_KEY_PROVIDERS = new Set(["ollama"]);
-
-import { createRequire } from "node:module";
-
-/**
- * Attempts to dynamically import a provider package.
- * First tries the user-local ~/.joone/providers/node_modules directory.
- * If that fails, falls back to a standard require/import for bundled setups.
- */
-async function loadProviderPackage(provider: string): Promise<any> {
-  const packageName = PROVIDER_PACKAGE_MAP[provider];
-  if (!packageName) {
-    throw new Error(`Unknown package name for provider: ${provider}`);
-  }
-
-  // 1. Try user-local plugin directory
-  const localPluginPath = path.join(getProviderDir(), "node_modules", packageName);
-  try {
-    // Node.js ESM cannot import absolute directories (ERR_UNSUPPORTED_DIR_IMPORT).
-    // We must use createRequire to resolve the actual package.json "main" or "exports" entry point.
-    const require = createRequire(import.meta.url);
-    const resolvedPath = require.resolve(localPluginPath);
-    return await import(pathToFileURL(resolvedPath).href);
-  } catch (err: any) {
-    // Ignore MODULE_NOT_FOUND or similar errors and fallback
-    if (err.code !== "ERR_MODULE_NOT_FOUND" && !err.message.includes("Cannot find module")) {
-       // console.debug(`Failed to load from plugin dir:`, err.message);
-    }
-  }
-
-  // 2. Fallback to standard resolution (for npx, bundled versions, etc)
-  try {
-    return await import(packageName);
-  } catch (err: any) {
-    throw new Error(`Provider "${provider}" requires the ${packageName} package.\nRun: joone provider add ${provider}`);
-  }
-}
-
-/**
- * Model Factory
- *
- * Creates a LangChain BaseChatModel based on the JooneConfig.
- * Uses dynamic imports so only the selected provider's package is loaded.
- */
-export async function createModel(config: JooneConfig): Promise<BaseChatModel> {
-  const { provider, model, apiKey, maxTokens, temperature } = config;
-
-  // API key validation for cloud providers
-  if (!NO_KEY_PROVIDERS.has(provider) && !apiKey) {
-    throw new Error(
-      `API key is required for provider "${provider}". Run: joone config`
-    );
-  }
-
-  try {
-    switch (provider) {
-      case "anthropic": {
-        const pkg = await loadProviderPackage(provider);
-        const ChatAnthropic = pkg.ChatAnthropic || pkg.default?.ChatAnthropic;
-        return new ChatAnthropic({
-          modelName: model,
-          anthropicApiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "openai": {
-        const pkg = await loadProviderPackage(provider);
-        const ChatOpenAI = pkg.ChatOpenAI || pkg.default?.ChatOpenAI;
-        return new ChatOpenAI({
-          modelName: model,
-          openAIApiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "google": {
-        const pkg = await loadProviderPackage(provider);
-        // Specifically for Google, LangChain frequently uses ChatGoogleGenerativeAI
-        const ChatGoogle = pkg.ChatGoogleGenerativeAI || pkg.default?.ChatGoogleGenerativeAI || pkg.ChatGoogleGenAI || pkg.default?.ChatGoogleGenAI;
-        
-        if (!apiKey) {
-          throw new Error("API key is required for provider \"google\". Run: joone config");
-        }
-
-        return new ChatGoogle({
-          model: model,
-          apiKey: apiKey,
-          maxOutputTokens: maxTokens,
-          temperature,
-        });
-      }
-
-      case "mistral": {
-        const { ChatMistralAI } = await loadProviderPackage(provider);
-        return new ChatMistralAI({
-          modelName: model,
-          apiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "groq": {
-        const { ChatGroq } = await loadProviderPackage(provider);
-        return new ChatGroq({
-          modelName: model,
-          apiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "deepseek": {
-        const { ChatDeepSeek } = await loadProviderPackage(provider);
-        return new ChatDeepSeek({
-          modelName: model,
-          apiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "fireworks": {
-        const { ChatFireworks } = await loadProviderPackage(provider);
-        return new ChatFireworks({
-          modelName: model,
-          fireworksApiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "together": {
-        const { ChatTogetherAI } = await loadProviderPackage(provider);
-        return new ChatTogetherAI({
-          modelName: model,
-          togetherAIApiKey: apiKey,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      case "ollama": {
-        const { ChatOllama } = await loadProviderPackage(provider);
-        return new ChatOllama({
-          model: model,
-          maxTokens,
-          temperature,
-        });
-      }
-
-      default:
-        throw new Error(
-          `Unsupported provider: "${provider}". Supported providers: anthropic, openai, google, mistral, groq, deepseek, fireworks, together, ollama.`
-        );
-    }
-  } catch (e: unknown) {
-    // If LangChain itself throws an API key error (sometimes they do runtime checks)
-    if (e instanceof Error && e.message.includes("API key")) throw e;
-    throw e; // Rethrow the loadProviderPackage message or other unexpected errors
-  }
-}

package/src/cli/postinstall.ts

@@ -1,28 +0,0 @@
-#!/usr/bin/env node
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-// We only want to show the banner on post-install if this is an interactive terminal
-// and we are not in a CI environment.
-if (process.stdout.isTTY && !process.env.CI) {
-  // Determine if it was installed globally
-  const npmConfigPrefix = process.env.npm_config_global === "true" || process.env.npm_config_global === "";
-  
-  const green = "\x1b[32m";
-  const cyan = "\x1b[36m";
-  const bold = "\x1b[1m";
-  const reset = "\x1b[0m";
-
-  console.log("");
-  console.log(`  ╭───────────────────────────────────────────────────╮`);
-  console.log(`  │                                                   │`);
-  console.log(`  │   🚀 ${green}${bold}Joone installed successfully!${reset}                │`);
-  console.log(`  │                                                   │`);
-  console.log(`  │   To complete setup and start the agent,          │`);
-  console.log(`  │   run the following command in your terminal:     │`);
-  console.log(`  │                                                   │`);
-  console.log(`  │   $ ${cyan}joone${reset}                                         │`);
-  console.log(`  │                                                   │`);
-  console.log(`  ╰───────────────────────────────────────────────────╯`);
-  console.log("");
-}

package/src/cli/providers.ts

@@ -1,107 +0,0 @@
-import spawn from "cross-spawn";
-import * as path from "node:path";
-import * as os from "node:os";
-import * as fs from "node:fs";
-
-/**
- * Returns the absolute path to the user-local providers directory.
- */
-export function getProviderDir(): string {
-  return path.join(os.homedir(), ".joone", "providers");
-}
-
-/**
- * Maps the internal Joone provider name to the official LangChain NPM package name.
- */
-export const PROVIDER_PACKAGE_MAP: Record<string, string> = {
-  anthropic: "@langchain/anthropic",
-  openai: "@langchain/openai",
-  google: "@langchain/google-genai",
-  mistral: "@langchain/mistralai",
-  groq: "@langchain/groq",
-  deepseek: "@langchain/deepseek",
-  fireworks: "@langchain/community",
-  together: "@langchain/community",
-  ollama: "@langchain/ollama"
-};
-
-/**
- * Installs the NPM package for the given provider into the user-local `~/.joone/providers` directory.
- * @param provider The internal Joone provider name (e.g., "google")
- */
-export async function installProvider(provider: string): Promise<void> {
-  const packageName = PROVIDER_PACKAGE_MAP[provider];
-  if (!packageName) {
-    throw new Error(`Unknown provider: "${provider}"`);
-  }
-
-  const providerDir = getProviderDir();
-  
-  // Ensure the directory exists
-  if (!fs.existsSync(providerDir)) {
-    fs.mkdirSync(providerDir, { recursive: true });
-  }
-
-  return new Promise((resolve, reject) => {
-    // We use --no-save to avoid creating a package.json and --no-package-lock to avoid lockfiles
-    // in this isolated directory, keeping it clean and fast.
-    const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
-    const args = ["install", packageName, "--prefix", providerDir, "--no-save", "--no-package-lock"];
-    
-    // Using cross-spawn automatically handles Windows command resolution securely without shell:true
-    const child = spawn(npmCmd, args, {
-      stdio: "ignore", // Suppress NPM's verbose output during install
-    });
-
-    child.on("close", (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Failed to install ${packageName} (npm install exited with code ${code})`));
-      }
-    });
-
-    child.on("error", (err) => {
-      reject(new Error(`Failed to spawn npm install: ${err.message}`));
-    });
-  });
-}
-
-/**
- * Uninstalls the NPM package for the given provider from the user-local `~/.joone/providers` directory.
- * @param provider The internal Joone provider name (e.g., "google")
- */
-export async function uninstallProvider(provider: string): Promise<void> {
-  const packageName = PROVIDER_PACKAGE_MAP[provider];
-  if (!packageName) {
-    throw new Error(`Unknown provider: "${provider}"`);
-  }
-
-  const providerDir = getProviderDir();
-  
-  // If the directory doesn't exist, it's already uninstalled implicitly
-  if (!fs.existsSync(providerDir)) {
-    return;
-  }
-
-  return new Promise((resolve, reject) => {
-    const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
-    const args = ["uninstall", packageName, "--prefix", providerDir, "--no-save", "--no-package-lock"];
-    
-    const child = spawn(npmCmd, args, {
-      stdio: "ignore",
-    });
-
-    child.on("close", (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Failed to uninstall ${packageName} (npm uninstall exited with code ${code})`));
-      }
-    });
-
-    child.on("error", (err) => {
-      reject(new Error(`Failed to spawn npm uninstall: ${err.message}`));
-    });
-  });
-}

package/src/commands/builtinCommands.ts

@@ -1,293 +0,0 @@
-/**
- * Built-in Slash Commands
- *
- * All default commands that ship with Joone. Each command is a self-contained
- * SlashCommand object registered into the CommandRegistry at session start.
- */
-
-import { SlashCommand, CommandContext } from "./commandRegistry.js";
-import { countMessageTokens, estimateTokens } from "../core/tokenCounter.js";
-
-// ─── /help ──────────────────────────────────────────────────────────────────────
-
-export const HelpCommand: SlashCommand = {
-  name: "help",
-  aliases: ["h", "?"],
-  description: "Show all available commands",
-  execute: async (_args, ctx) => {
-    // We import the registry's getHelp via context indirectly.
-    // The registry is responsible for calling this, so we return a static list.
-    const lines = [
-      "Available commands:\n",
-      "  /help (h, ?)       — Show this help message",
-      "  /model (m) [name]  — Switch model or show current model",
-      "  /clear (c)         — Clear conversation history",
-      "  /compact           — Manually trigger context compaction",
-      "  /tokens (t)        — Show current token usage",
-      "  /status (s)        — Show session status",
-      "  /history           — Show conversation summary",
-      "  /undo              — Remove last user+agent exchange",
-      "  /exit (quit, q)    — Exit the session",
-    ];
-    return lines.join("\n");
-  },
-};
-
-// ─── /model ─────────────────────────────────────────────────────────────────────
-
-export const ModelCommand: SlashCommand = {
-  name: "model",
-  aliases: ["m"],
-  description: "Switch LLM model or show current model",
-  execute: async (args, ctx) => {
-    if (!args.trim()) {
-      return `Current model: ${ctx.model} (provider: ${ctx.provider})\n` +
-        `To switch: /model <model-name>`;
-    }
-
-    // We can't hot-swap the LLM instance without re-creating the harness,
-    // so we update the config and inform the user to restart.
-    // In the future, this could support live reloading.
-    const newModel = args.trim();
-    return `⚠ Model switching requires a session restart.\n` +
-      `To use "${newModel}", update your config:\n` +
-      `  joone config\n` +
-      `Or restart with: joone start\n\n` +
-      `Current model: ${ctx.model}`;
-  },
-};
-
-// ─── /clear ─────────────────────────────────────────────────────────────────────
-
-export const ClearCommand: SlashCommand = {
-  name: "clear",
-  aliases: ["c"],
-  description: "Clear conversation history (keeps system prompt)",
-  execute: async (_args, ctx) => {
-    const prevCount = ctx.contextState.conversationHistory.length;
-    ctx.setContextState({
-      ...ctx.contextState,
-      conversationHistory: [],
-    });
-    return `✓ Cleared ${prevCount} messages from conversation history.\n` +
-      `System prompt and project context preserved.`;
-  },
-};
-
-// ─── /compact ───────────────────────────────────────────────────────────────────
-
-export const CompactCommand: SlashCommand = {
-  name: "compact",
-  description: "Manually trigger context compaction",
-  execute: async (_args, ctx) => {
-    const history = ctx.contextState.conversationHistory;
-    if (history.length <= 6) {
-      return `Not enough history to compact (${history.length} messages). Need > 6.`;
-    }
-
-    const allMessages = [
-      ...history, // Simplified — the full prompt builder would add system messages too
-    ];
-    const currentTokens = countMessageTokens(allMessages);
-    const pct = Math.round((currentTokens / ctx.maxTokens) * 100);
-
-    if (pct < 50) {
-      return `Context at ${pct}% capacity (${currentTokens} tokens). ` +
-        `Compaction not needed yet — typically triggers at 80%.`;
-    }
-
-    // For now, do a basic compaction. M12 will replace this with LLM-powered compaction.
-    const keepLastN = 8;
-    const recent = history.slice(-keepLastN);
-    const evictedCount = history.length - keepLastN;
-
-    // Simple string summary (M12 will upgrade to LLM summary)
-    const { HumanMessage } = await import("@langchain/core/messages");
-    const summaryMsg = new HumanMessage(
-      `<system-summary>\n[Compacted: ${evictedCount} messages removed. ` +
-      `Use /history for details. Conversation continues below.]\n</system-summary>`
-    );
-
-    ctx.setContextState({
-      ...ctx.contextState,
-      conversationHistory: [summaryMsg, ...recent],
-    });
-
-    const newTokens = countMessageTokens([summaryMsg, ...recent]);
-    return `✓ Compacted ${evictedCount} messages. ` +
-      `Tokens: ${currentTokens} → ${newTokens} (${Math.round((newTokens / ctx.maxTokens) * 100)}%)`;
-  },
-};
-
-// ─── /tokens ────────────────────────────────────────────────────────────────────
-
-export const TokensCommand: SlashCommand = {
-  name: "tokens",
-  aliases: ["t"],
-  description: "Show current token usage and context capacity",
-  execute: async (_args, ctx) => {
-    const history = ctx.contextState.conversationHistory;
-    const historyTokens = countMessageTokens(history);
-
-    const systemTokens =
-      estimateTokens(ctx.contextState.globalSystemInstructions) +
-      estimateTokens(ctx.contextState.projectMemory) +
-      estimateTokens(ctx.contextState.sessionContext);
-
-    const totalTokens = systemTokens + historyTokens;
-    const pct = Math.round((totalTokens / ctx.maxTokens) * 100);
-
-    const bar = generateBar(pct);
-
-    return [
-      `Token Usage:`,
-      `  System prompt:  ~${systemTokens} tokens`,
-      `  Conversation:   ~${historyTokens} tokens (${history.length} messages)`,
-      `  Total:          ~${totalTokens} / ${ctx.maxTokens} tokens`,
-      `  Capacity:       ${bar} ${pct}%`,
-      pct >= 80 ? `  ⚠ Near capacity — consider /compact` : "",
-    ].filter(Boolean).join("\n");
-  },
-};
-
-/**
- * Generates a simple text progress bar.
- */
-function generateBar(pct: number): string {
-  const filled = Math.round(pct / 5); // 20 chars total
-  const empty = 20 - filled;
-  return `[${"█".repeat(filled)}${"░".repeat(Math.max(0, empty))}]`;
-}
-
-// ─── /status ────────────────────────────────────────────────────────────────────
-
-export const StatusCommand: SlashCommand = {
-  name: "status",
-  aliases: ["s"],
-  description: "Show current session status",
-  execute: async (_args, ctx) => {
-    const history = ctx.contextState.conversationHistory;
-    const tokens = countMessageTokens(history);
-    const pct = Math.round((tokens / ctx.maxTokens) * 100);
-
-    return [
-      `Session Status:`,
-      `  Provider:     ${ctx.provider}`,
-      `  Model:        ${ctx.model}`,
-      `  Messages:     ${history.length}`,
-      `  Token Usage:  ~${tokens} / ${ctx.maxTokens} (${pct}%)`,
-      `  CWD:          ${process.cwd()}`,
-    ].join("\n");
-  },
-};
-
-// ─── /history ───────────────────────────────────────────────────────────────────
-
-export const HistoryCommand: SlashCommand = {
-  name: "history",
-  description: "Show conversation history summary",
-  execute: async (_args, ctx) => {
-    const history = ctx.contextState.conversationHistory;
-
-    if (history.length === 0) {
-      return "No conversation history yet.";
-    }
-
-    const lines: string[] = [`Conversation History (${history.length} messages):\n`];
-
-    // Show last 20 messages max
-    const start = Math.max(0, history.length - 20);
-    if (start > 0) {
-      lines.push(`  ... (${start} earlier messages omitted)\n`);
-    }
-
-    for (let i = start; i < history.length; i++) {
-      const msg = history[i];
-      const role = msg._getType();
-      const content = typeof msg.content === "string"
-        ? msg.content.slice(0, 80)
-        : "[complex content]";
-      const suffix = typeof msg.content === "string" && msg.content.length > 80 ? "..." : "";
-      lines.push(`  ${i + 1}. [${role}] ${content}${suffix}`);
-    }
-
-    return lines.join("\n");
-  },
-};
-
-// ─── /undo ──────────────────────────────────────────────────────────────────────
-
-export const UndoCommand: SlashCommand = {
-  name: "undo",
-  description: "Remove last user message and agent response",
-  execute: async (_args, ctx) => {
-    const history = ctx.contextState.conversationHistory;
-
-    if (history.length === 0) {
-      return "Nothing to undo — conversation history is empty.";
-    }
-
-    // Walk backwards to remove the last user→agent exchange.
-    // An exchange is: HumanMessage → [AIMessage + ToolMessages...]
-    let removeCount = 0;
-    let hitHuman = false;
-
-    for (let i = history.length - 1; i >= 0; i--) {
-      const type = history[i]._getType();
-      removeCount++;
-
-      if (type === "human") {
-        hitHuman = true;
-        break;
-      }
-    }
-
-    if (!hitHuman) {
-      // No HumanMessage found — remove the last message only
-      removeCount = 1;
-    }
-
-    const newHistory = history.slice(0, history.length - removeCount);
-    ctx.setContextState({
-      ...ctx.contextState,
-      conversationHistory: newHistory,
-    });
-
-    return `✓ Removed ${removeCount} message(s). History now has ${newHistory.length} messages.`;
-  },
-};
-
-// ─── /exit ──────────────────────────────────────────────────────────────────────
-
-export const ExitCommand: SlashCommand = {
-  name: "exit",
-  aliases: ["quit", "q"],
-  description: "Exit the Joone session",
-  execute: async (_args, _ctx) => {
-    // The TUI will handle the actual exit. We return a signal message.
-    return "__EXIT__";
-  },
-};
-
-// ─── Registration Helper ────────────────────────────────────────────────────────
-
-import { CommandRegistry } from "./commandRegistry.js";
-
-/**
- * Creates a CommandRegistry pre-loaded with all built-in commands.
- */
-export function createDefaultRegistry(): CommandRegistry {
-  const registry = new CommandRegistry();
-
-  registry.register(HelpCommand);
-  registry.register(ModelCommand);
-  registry.register(ClearCommand);
-  registry.register(CompactCommand);
-  registry.register(TokensCommand);
-  registry.register(StatusCommand);
-  registry.register(HistoryCommand);
-  registry.register(UndoCommand);
-  registry.register(ExitCommand);
-
-  return registry;
-}