@tyvm/knowhow 0.0.159 → 0.0.160

package/src/chat.ts

@@ -1,140 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * New Modular Chat Interface - Simplified and cleaner than original chat.ts
- *
- * Supports custom renderers and root modules via .knowhow/knowhow.json:
- *
- * ```json
- * {
- *   "chat": {
- *     "renderer": "./my-renderer.ts",       // local TS/JS file or npm package
- *     "rootModule": "./my-module.ts"        // local TS/JS file or npm package
- *   }
- * }
- * ```
- */
-
-import { CliChatService } from "./chat/CliChatService.js";
-import { InternalChatModule } from "./chat/modules/InternalChatModule.js";
-import { getConfig } from "./config.js";
-import { loadRenderer, loadRootModule, loadChatModule } from "./chat/renderer/loadRenderer.js";
-import { AgentModule } from "./chat/modules/AgentModule.js";
-
-async function main(initialCommand?: string) {
-  try {
-    // Load configuration and plugins
-    let config;
-    try {
-      config = await getConfig();
-    } catch (configError) {
-      console.warn(
-        "Warning: Could not load config, using default plugins:",
-        configError
-      );
-      config = {
-        plugins: {
-          enabled: [
-            "embeddings",
-            "language",
-            "vim",
-            "github",
-            "asana",
-            "jira",
-            "linear",
-            "download",
-            "figma",
-            "url",
-          ],
-          disabled: [],
-        },
-      };
-    }
-
-    // Create chat service with plugins
-    const chatService = new CliChatService(config.plugins?.enabled ?? []);
-
-    // ── Default Agent / Model / Provider ──────────────────────────────────────
-    // If chat config specifies defaults, inject them into the context so
-    // AgentModule can pick them up during initialize().
-    if (config.chat?.defaultAgent || config.chat?.defaultModel || config.chat?.defaultProvider) {
-      chatService.setContext({
-        defaultAgent: config.chat?.defaultAgent,
-        defaultModel: config.chat?.defaultModel,
-        defaultProvider: config.chat?.defaultProvider,
-      });
-    }
-
-    // ── Renderer ──────────────────────────────────────────────────────────────
-    // Load a custom renderer if configured, otherwise use the default
-    // ConsoleRenderer (already the default inside AgentModule).
-    const rendererSpecifier = config.chat?.renderer;
-    if (rendererSpecifier) {
-      try {
-        const customRenderer = await loadRenderer(rendererSpecifier);
-        // Inject the renderer into AgentModule via the chat service context
-        // AgentModule picks it up from context.renderer
-        chatService.setContext({ renderer: customRenderer });
-        console.log(`✓ Loaded custom renderer: ${rendererSpecifier}`);
-      } catch (err: any) {
-        console.warn(`⚠ Could not load renderer "${rendererSpecifier}": ${err.message}`);
-        console.warn("  Falling back to default ConsoleRenderer.");
-      }
-    }
-
-    // ── Root Module ───────────────────────────────────────────────────────────
-    // Allow swapping the root chat module entirely via config.
-    // The root module drives the whole CLI chat experience.
-    const rootModuleSpecifier = config.chat?.rootModule;
-    if (rootModuleSpecifier) {
-      try {
-        const customModule = await loadRootModule(rootModuleSpecifier);
-        await customModule.initialize(chatService);
-        console.log(`✓ Loaded custom root module: ${rootModuleSpecifier}`);
-      } catch (err: any) {
-        console.warn(`⚠ Could not load root module "${rootModuleSpecifier}": ${err.message}`);
-        console.warn("  Falling back to InternalChatModule.");
-        const internalModule = new InternalChatModule();
-        await internalModule.initialize(chatService);
-      }
-    } else {
-      // Default: use the internal module
-      const internalModule = new InternalChatModule();
-      await internalModule.initialize(chatService);
-    }
-
-    // ── Additional Chat Modules ────────────────────────────────────────────────
-    // Load any additional chat modules specified in config.chat.modules.
-    // These are loaded AFTER the root module so they can add commands/modes
-    // on top of whatever the root module provides.
-    const moduleSpecifiers = config.chat?.modules ?? [];
-    for (const specifier of moduleSpecifiers) {
-      try {
-        const chatModule = await loadChatModule(specifier);
-        await chatModule.initialize(chatService);
-        console.log(`✓ Loaded chat module: ${specifier}`);
-      } catch (err: any) {
-        console.warn(`⚠ Could not load chat module "${specifier}": ${err.message}`);
-      }
-    }
-
-    // Start the chat loop
-    await chatService.startChatLoop(initialCommand);
-  } catch (error) {
-    console.error("Error starting chat:", error);
-    process.exit(1);
-  }
-}
-
-// Check if this file is being run directly
-const isMainModule =
-  (process.argv[1] && process.argv[1].endsWith("chat2.ts")) ||
-  (process.argv[1] && process.argv[1].endsWith("chat2.js")) ||
-  (process.argv[1] && process.argv[1].endsWith("chat.ts")) ||
-  (process.argv[1] && process.argv[1].endsWith("chat.js"));
-
-if (isMainModule) {
-  main().catch(console.error);
-}
-
-export { main as startChat };

package/src/cli.ts

@@ -1,180 +0,0 @@
-#!/usr/bin/env node --no-node-snapshot
-// Mark this process as running the Knowhow CLI (not just the SDK)
-process.env.KNOWHOW_CLI = "1";
-
-// Determine which warnings to show based on the command being run.
-// Commands that don't need AI models or a config file should not spam warnings.
-// Individual commands can override by setting KNOWHOW_WARN_NEEDS before parsing.
-// Format: comma-separated list of "models" | "config" (or empty string to suppress all).
-const _rawArgs = process.argv.slice(2);
-const _firstArg = _rawArgs.find((a) => !a.startsWith("-"));
-const COMMANDS_NEEDING_MODELS = new Set(["chat", "agent", "ask", "generate", "embed", "replay"]);
-const COMMANDS_NEEDING_CONFIG = new Set([
-  "chat", "agent", "ask", "generate", "embed", "upload", "download",
-  "worker", "workers", "replay", "behaviors", "skills",
-]);
-const _needsModels = _firstArg && COMMANDS_NEEDING_MODELS.has(_firstArg) ? "models" : "";
-const _needsConfig = _firstArg && COMMANDS_NEEDING_CONFIG.has(_firstArg) ? "config" : "";
-const _needs = [_needsModels, _needsConfig].filter(Boolean).join(",");
-process.env.KNOWHOW_WARN_NEEDS = process.env.KNOWHOW_WARN_NEEDS ?? _needs;
-
-import { Command } from "commander";
-import { version } from "../package.json";
-import { logger } from "./logger";
-import { migrateConfig } from "./config";
-import { getConfig, getGlobalConfig } from "./config";
-import { getEnabledPlugins } from "./types";
-import { CliChatService } from "./chat/CliChatService";
-import { ModulesService } from "./services/modules";
-
-// Command registrars
-import { addModulesCommand } from "./commands/modules";
-import { addMcpCommands } from "./commands/mcp";
-import {
-  addWorkerCommand,
-  addWorkersCommand,
-  addTunnelCommand,
-  addFilesCommand,
-  addCloudWorkerCommand,
-} from "./commands/workers";
-import {
-  addAgentCommand,
-  addAskCommand,
-  addSetupCommand,
-  addSearchCommand,
-  addSessionsCommand,
-} from "./commands/agent";
-import {
-  addInitCommand,
-  addLoginCommand,
-  addUpdateCommand,
-  addGenerateCommand,
-  addEmbedCommands,
-  addUploadCommand,
-  addDownloadCommand,
-  addChatCommand,
-  addGithubCredentialsCommand,
-} from "./commands/misc";
-import { addConvertCommand } from "./commands/convert";
-import { addReplayCommand } from "./commands/replay";
-import { addBehaviorsCommand } from "./commands/behaviors";
-import { addSkillsCommand } from "./commands/skills";
-import { addAgentsCommand } from "./commands/agents";
-import { addHashCommand } from "./commands/hash";
-import { addSandboxCommand } from "./commands/sandbox";
-import { addProcessesCommand } from "./commands/processes";
-import { addRemoteCommand } from "./commands/remote";
-
-// Handle unhandled promise rejections gracefully — particularly from MCP SDK
-// which fires errors via event emitters that can bypass Promise.allSettled.
-// Without this, a single failing MCP server (e.g. expired Notion token) will
-// crash the entire CLI with an unhandled rejection.
-process.on("unhandledRejection", (reason: unknown) => {
-  const message = reason instanceof Error ? reason.message : String(reason);
-  // Only warn — don't exit. The MCP connect errors are recoverable;
-  // the server will simply be unavailable but others continue working.
-  console.warn(`⚠ Unhandled MCP/async error (non-fatal): ${message}`);
-});
-
-async function main() {
-  const program = new Command();
-
-  // Install console overload early so ALL output (including third-party modules)
-  // goes through our logger closure — respects silence() for clean-stdout commands.
-  logger.installConsoleOverload();
-
-  // Silence immediately if this is a clean-stdout command (e.g. git credential helpers).
-  // Module loading happens before parseAsync, so we must silence before that point.
-  const rawArgs = process.argv.slice(2);
-  const SILENT_COMMANDS = ["github-credentials"];
-  if (rawArgs.some((a) => SILENT_COMMANDS.includes(a))) {
-    logger.silence();
-  }
-
-  await migrateConfig();
-  const config = await getConfig();
-  const chatService = new CliChatService(getEnabledPlugins(config.plugins));
-
-  // Lazily expose chatService and config to commands that need them
-  const getChatService = () => chatService;
-  const getConfigFn = () => config;
-
-  program
-    .name("knowhow")
-    .description("AI CLI with plugins and agents")
-    .version(version);
-
-  // Register all commands
-  addInitCommand(program);
-  addLoginCommand(program);
-  addRemoteCommand(program);
-  addUpdateCommand(program);
-  addGenerateCommand(program);
-  addEmbedCommands(program);
-  addUploadCommand(program);
-  addDownloadCommand(program);
-  addChatCommand(program);
-  addAgentCommand(program, getChatService);
-  addAskCommand(program, getChatService, getConfigFn);
-  addSetupCommand(program, getChatService);
-  addSearchCommand(program);
-  addSessionsCommand(program, getChatService);
-  addWorkerCommand(program);
-  addWorkersCommand(program);
-  addTunnelCommand(program);
-  addFilesCommand(program);
-  addCloudWorkerCommand(program);
-  addGithubCredentialsCommand(program);
-  addModulesCommand(program);
-  addMcpCommands(program);
-  addConvertCommand(program);
-  addReplayCommand(program);
-  addBehaviorsCommand(program);
-  addSkillsCommand(program);
-  addAgentsCommand(program, getChatService);
-  addHashCommand(program);
-  addSandboxCommand(program);
-  addProcessesCommand(program);
-
-  // Load global modules early (before parse) so they can register CLI subcommands.
-  // We pass only the Program in context — no services are spun up at this stage.
-  // Each module's command action is responsible for calling setupServices() as needed.
-  try {
-    const globalConfig = await getGlobalConfig();
-    const globalModules = [...new Set(globalConfig.modules || [])];
-    const localModules = [...new Set(config.modules || [])];
-    // Local modules take precedence: if a module appears in both global and
-    // local configs, use the local version so it resolves against local
-    // node_modules first. This prevents duplicate command registration errors.
-    const allModulePaths = [
-      ...globalModules.filter((m) => !localModules.includes(m)),
-      ...localModules,
-    ];
-    if (allModulePaths.length) {
-      const earlyModulesService = new ModulesService();
-      await earlyModulesService.loadModulesFrom(
-        { ...config, modules: allModulePaths },
-        {
-          Program: program,
-        }
-      );
-    }
-  } catch (e) {
-    // Non-fatal: if global modules fail to load for CLI registration, continue
-  }
-
-  await program.parseAsync(process.argv);
-}
-
-export { main };
-
-if (require.main === module) {
-  main()
-    .catch((e) => {
-      console.error(e);
-      process.exit(1);
-    })
-    .then(() => {
-      process.exit(0);
-    });
-}