@tyvm/knowhow 0.0.99 → 0.0.101

package/jest.manual.config.js

@@ -0,0 +1,19 @@
+module.exports = {
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.ts?$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  testEnvironment: 'node',
+  testRegex: '/tests/manual/.*\.(test|spec)\.(ts|tsx|js)$',
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  modulePathIgnorePatterns: ["ts_build", "benchmarks"],
+  testPathIgnorePatterns: [],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyvm/knowhow",
-  "version": "0.0.99",
+  "version": "0.0.101",
   "description": "ai cli with plugins and agents",
   "main": "ts_build/src/index.js",
   "bin": {
@@ -9,8 +9,10 @@
   "scripts": {
     "test": "jest --testTimeout 300000",
     "test:debug": "node --inspect-brk ../../node_modules/jest/bin/jest.js --detectOpenHandles --forceExit --testTimeout 300000",
+    "build": "npm run compile",
     "compile": "npm run clean && tsc",
     "clean": "rm -rf ts_build",
+    "node:build": "bash scripts/build-for-node.sh",
     "start": "npm run compile && node --no-node-snapshot ts_build/src/server/index.js",
     "dataset:diffs:generate": "ts-node src/dataset/diffs/generate.ts",
     "dataset:diffs:jsonl": "ts-node src/dataset/diffs/jsonl.ts",

package/scripts/build-for-node.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+# Usage: bash scripts/build-for-node.sh [node-version]
+# Example: bash scripts/build-for-node.sh 24        # any Node 24.x
+# Example: bash scripts/build-for-node.sh 20.19.0   # exact version
+# Example: npm run node:build 24
+#
+# This script:
+#   1. Compiles TypeScript with Node 20 (required for workspace deps)
+#   2. Creates /tmp/knowhow-node-<major> with the compiled output
+#   3. Installs the correct isolated-vm version for the target node in that dir
+#   4. Symlinks the package globally for ALL installed nvm versions matching the target
+#
+# This approach avoids polluting the workspace node_modules with a different
+# isolated-vm ABI, so Node 20 and Node 24 builds can coexist.
+
+set -e
+
+TARGET_VERSION="${1:-}"
+
+if [ -z "$TARGET_VERSION" ]; then
+  echo "Usage: $0 <node-version>"
+  echo "Example: $0 24"
+  echo "Example: $0 20.19.0"
+  exit 1
+fi
+
+# Extract the major version number for staging dir naming and glob matching
+TARGET_MAJOR="$(echo "$TARGET_VERSION" | cut -d. -f1)"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PACKAGE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "📦 Package dir: $PACKAGE_DIR"
+
+# --- Find Node 20 for compiling TypeScript ---
+NODE20_BIN=""
+for dir in "$HOME/.nvm/versions/node"/v20.*/bin; do
+  if [ -f "$dir/node" ]; then
+    NODE20_BIN="$dir/node"
+    break
+  fi
+done
+
+if [ -z "$NODE20_BIN" ]; then
+  echo "⚠️  Node 20 not found via nvm, falling back to current node for TS compile"
+  NODE20_BIN="$(which node)"
+fi
+
+NODE20_NPM="$(dirname "$NODE20_BIN")/npm"
+echo "🔨 Compiling TypeScript with: $NODE20_BIN ($(${NODE20_BIN} --version))"
+
+# --- Compile TypeScript ---
+cd "$PACKAGE_DIR"
+"$NODE20_NPM" run compile
+echo "✅ TypeScript compiled"
+
+# --- Find target Node binaries ---
+# If exact version given (e.g. 20.19.0), match exactly. Otherwise match all patch versions.
+TARGET_NODE_BINS=()
+
+if echo "$TARGET_VERSION" | grep -qE '^\d+\.\d+\.\d+$'; then
+  # Exact version like 20.19.0
+  exact_dir="$HOME/.nvm/versions/node/v${TARGET_VERSION}/bin"
+  if [ -f "$exact_dir/node" ]; then
+    TARGET_NODE_BINS+=("$exact_dir/node")
+  fi
+else
+  # Major only — collect all patch versions
+  for dir in "$HOME/.nvm/versions/node"/v${TARGET_MAJOR}.*/bin; do
+    if [ -f "$dir/node" ]; then
+      TARGET_NODE_BINS+=("$dir/node")
+    fi
+  done
+fi
+
+if [ ${#TARGET_NODE_BINS[@]} -eq 0 ]; then
+  echo "❌ Node $TARGET_VERSION not found in ~/.nvm/versions/node/"
+  echo "   Run: nvm install $TARGET_VERSION"
+  exit 1
+fi
+
+# Use the last (latest patch) for building
+TARGET_NODE_BIN="${TARGET_NODE_BINS[${#TARGET_NODE_BINS[@]}-1]}"
+TARGET_NODE_NPM="$(dirname "$TARGET_NODE_BIN")/npm"
+TARGET_NODE_DIR="$(dirname "$TARGET_NODE_BIN")"
+TARGET_NODE_ACTUAL_VERSION="$("$TARGET_NODE_BIN" --version)"
+
+echo "🎯 Found Node $TARGET_VERSION installs: ${TARGET_NODE_BINS[*]}"
+echo "🔨 Building with: $TARGET_NODE_BIN ($TARGET_NODE_ACTUAL_VERSION)"
+
+# --- Pick the right isolated-vm version for the target node ---
+# isolated-vm@5.x supports Node <22, isolated-vm@6.x requires Node >=22
+if [ "$TARGET_MAJOR" -ge 22 ]; then
+  IVM_VERSION="^6.0.0"
+  echo "📌 Using isolated-vm@6.x (Node >= 22)"
+else
+  IVM_VERSION="^5.0.4"
+  echo "📌 Using isolated-vm@5.x (Node < 22)"
+fi
+
+# --- Create staging directory ---
+STAGING_DIR="/tmp/knowhow-node-${TARGET_MAJOR}"
+rm -rf "$STAGING_DIR"
+mkdir -p "$STAGING_DIR"
+echo ""
+echo "📁 Staging dir: $STAGING_DIR"
+
+# --- Copy compiled output and package files into staging dir ---
+echo "📋 Copying compiled output to staging dir..."
+cp -r "$PACKAGE_DIR/ts_build" "$STAGING_DIR/ts_build"
+cp -r "$PACKAGE_DIR/bin" "$STAGING_DIR/bin" 2>/dev/null || true
+cp "$PACKAGE_DIR/package.json" "$STAGING_DIR/package.json"
+for item in README.md LICENSE .npmignore; do
+  [ -e "$PACKAGE_DIR/$item" ] && cp "$PACKAGE_DIR/$item" "$STAGING_DIR/" || true
+done
+
+# --- Patch package.json for target isolated-vm version ---
+echo "📝 Patching package.json for isolated-vm $IVM_VERSION..."
+"$NODE20_BIN" -e "
+  const fs = require('fs');
+  const pkg = JSON.parse(fs.readFileSync('$STAGING_DIR/package.json', 'utf8'));
+  pkg.dependencies['isolated-vm'] = '$IVM_VERSION';
+  // Remove workspace protocol deps that won't resolve outside the monorepo
+  if (pkg.dependencies) {
+    for (const [k, v] of Object.entries(pkg.dependencies)) {
+      if (String(v).startsWith('workspace:')) delete pkg.dependencies[k];
+    }
+  }
+  fs.writeFileSync('$STAGING_DIR/package.json', JSON.stringify(pkg, null, 2));
+  console.log('✅ package.json patched');
+"
+
+# --- Install deps in staging dir using target node ---
+echo ""
+echo "📦 Installing dependencies in staging dir with Node $TARGET_MAJOR..."
+cd "$STAGING_DIR"
+# Prepend target node bin to PATH so npm/node-gyp uses the correct node version
+PATH="$TARGET_NODE_DIR:$PATH" "$TARGET_NODE_NPM" install --no-save 2>&1
+echo "✅ Dependencies installed (isolated-vm compiled for Node $TARGET_MAJOR)"
+
+# --- Symlink globally for ALL matching Node version installs ---
+PKG_NAME="$("$NODE20_BIN" -e "console.log(require('$STAGING_DIR/package.json').name)")"
+PKG_BIN_NAME="$("$NODE20_BIN" -e "const b=require('$STAGING_DIR/package.json').bin; console.log(Object.keys(b)[0])")"
+PKG_BIN_FILE="$("$NODE20_BIN" -e "const b=require('$STAGING_DIR/package.json').bin; console.log(Object.values(b)[0])")"
+
+echo ""
+echo "🔗 Linking $PKG_NAME globally for all Node $TARGET_MAJOR installs..."
+for node_bin in "${TARGET_NODE_BINS[@]}"; do
+  node_prefix="$("$node_bin" -e "const p=require('path');console.log(p.join(p.dirname(process.execPath),'..'))" 2>/dev/null)"
+  global_modules="$node_prefix/lib/node_modules"
+  global_bin="$node_prefix/bin"
+  mkdir -p "$global_modules/@tyvm"
+  rm -rf "$global_modules/$PKG_NAME"
+  ln -sf "$STAGING_DIR" "$global_modules/$PKG_NAME"
+  rm -f "$global_bin/$PKG_BIN_NAME"
+  ln -sf "$global_modules/$PKG_NAME/$PKG_BIN_FILE" "$global_bin/$PKG_BIN_NAME"
+  echo "✅ $("$node_bin" --version): $global_modules/$PKG_NAME → $STAGING_DIR"
+done
+
+echo ""
+echo "🎉 Done! Switch to Node $TARGET_MAJOR and run: knowhow"
+echo "   nvm use $TARGET_MAJOR && knowhow"

package/src/agents/base/base.ts

@@ -619,6 +619,17 @@ export abstract class BaseAgent implements IAgent {
         tool_choice: "auto",
       });
 
+      // If the agent was paused while the completion was in-flight, wait here
+      // before processing tool calls. This allows the user to send messages
+      // (via addPendingUserMessage) and prevents the agent from proceeding to
+      // tool calls (e.g. finalAnswer) without seeing those interactions.
+      if (this.status === this.eventTypes.pause) {
+        this.log(
+          "Agent was paused after completion, waiting before processing tool calls"
+        );
+        await this.unpaused();
+      }
+
       if (response?.usd_cost === undefined) {
         this.log(
           `Response cost is undefined: ${JSON.stringify(response, null, 2)}`,
@@ -662,6 +673,13 @@ export abstract class BaseAgent implements IAgent {
           this.updateCurrentThread(messages);
 
           for (const toolCall of toolCalls) {
+            if(this.status === this.eventTypes.pause) {
+              this.log(
+                "Agent was paused before tool call, waiting before processing tool calls"
+              );
+              await this.unpaused();
+            }
+
             const toolMessages = await this.processToolMessages(toolCall);
             // Add the tool responses to the thread
             messages.push(...(toolMessages as Message[]));
@@ -676,6 +694,18 @@ export abstract class BaseAgent implements IAgent {
             );
 
             if (finalMessage) {
+              // If user added pending messages after finalAnswer was called,
+              // continue running to respond to that feedback instead of returning
+              if (this.pendingUserMessages.length > 0) {
+                this.log(
+                  "finalAnswer called but pending user messages exist, continuing to respond to feedback"
+                );
+                messages.push(...this.pendingUserMessages);
+                this.pendingUserMessages = [];
+                this.updateCurrentThread(messages);
+                return this.call(userInput, messages);
+              }
+
               // Emit task completion event for plugins (like GitPlugin)
               this.events.emit(this.eventTypes.agentTaskComplete, {
                 taskId:
@@ -685,6 +715,8 @@ export abstract class BaseAgent implements IAgent {
                 result: finalMessage.content || "Done",
               });
               const doneMsg = finalMessage.content || "Done";
+
+
               this.agentEvents.emit(this.eventTypes.done, doneMsg);
               this.status = this.eventTypes.done;
               return doneMsg;

package/src/cli.ts

@@ -38,6 +38,20 @@ import { readPromptFile } from "./ai";
 import { SetupModule } from "./chat/modules/SetupModule";
 import { CliChatService } from "./chat/CliChatService";
 
+// 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 setupServices() {
   const { Agents, Mcp, Clients, Tools: OldTools } = services();
   const Tools = new LazyToolsService(); // eslint-disable-line no-shadow
@@ -74,7 +88,14 @@ async function setupServices() {
   Agents.setAgentContext(agentContext);
 
   console.log("🔌 Connecting to MCP...");
-  await Mcp.connectToConfigured(Tools);
+  try {
+    await Mcp.connectToConfigured(Tools);
+  } catch (mcpError) {
+    const msg = mcpError instanceof Error ? mcpError.message : String(mcpError);
+    console.warn(
+      `⚠ Some MCP servers failed to connect (continuing without them): ${msg}`
+    );
+  }
   console.log("Connecting to clients...");
   await Clients.registerConfiguredModels();
   console.log("✓ Services are set up and ready to go!");
@@ -138,7 +159,7 @@ async function main() {
         console.log(`Current version: ${version}`);
 
         console.log("📦 Installing latest version from npm...");
-        execSync("npm install -g knowhow@latest", {
+        execSync("npm install -g @tyvm/knowhow@latest", {
           stdio: "inherit",
           encoding: "utf-8",
         });

package/src/clients/contextLimits.ts

@@ -52,7 +52,6 @@ export const ContextLimits: Record<string, number> = {
   [Models.anthropic.Haiku4_5]: 200_000,
   [Models.anthropic.Sonnet3_7]: 200_000,
   [Models.anthropic.Sonnet3_5]: 200_000,
-  [Models.anthropic.Haiku3_5]: 200_000,
   [Models.anthropic.Opus3]: 200_000,
   [Models.anthropic.Haiku3]: 200_000,
 
@@ -74,7 +73,6 @@ export const ContextLimits: Record<string, number> = {
   [Models.google.Gemini_25_Pro_TTS]: 1_000_000,
   [Models.google.Gemini_20_Flash]: 1_000_000,
   [Models.google.Gemini_20_Flash_Preview_Image_Generation]: 1_000_000,
-  [Models.google.Gemini_20_Flash_Lite]: 1_000_000,
   [Models.google.Gemini_20_Flash_Live]: 1_000_000,
   [Models.google.Gemini_20_Flash_TTS]: 1_000_000,
   [Models.google.Gemini_15_Flash]: 1_000_000,

package/src/clients/index.ts

@@ -217,7 +217,12 @@ export class AIClient {
     for (const entry of providers) {
       const client = this.resolveClient(entry);
 
-      if (!client) continue;
+      if (!client) {
+        if (entry.provider === "knowhow") {
+          console.warn(`⚠️  Knowhow provider is not logged in. Run 'knowhow login' to enable Knowhow models.`);
+        }
+        continue;
+      }
 
       const reg = this.providerRegistry[entry.provider];
 
@@ -493,11 +498,19 @@ export class AIClient {
       return foundByModel;
     }
 
-    console.log("unable to find", {
-      provider,
-      model,
-      all: this.listAllModels(),
-    });
+    const allModels = this.listAllModels();
+    const hasKnowhowModels =
+      allModels["knowhow"] && allModels["knowhow"].length > 0;
+    const knowhowIsConfigured = Object.keys(allModels).includes("knowhow");
+
+    console.warn(`⚠️  Unable to find model '${model}' for provider '${provider}'.`);
+    console.warn(`   Available providers: ${Object.keys(allModels).join(", ") || "(none)"}`);
+
+    if (!hasKnowhowModels && !knowhowIsConfigured) {
+      console.warn(`   Tip: Run 'knowhow login' to enable Knowhow models.`);
+    } else if (!hasKnowhowModels) {
+      console.warn(`   Tip: The Knowhow provider returned no models. Try running 'knowhow login' to re-authenticate.`);
+    }
 
     return { provider, model };
   }

package/src/clients/pricing/anthropic.ts

@@ -65,12 +65,6 @@ export const AnthropicTextPricing = {
     cache_hit: 0.3,
     output: 15.0,
   },
-  [Models.anthropic.Haiku3_5]: {
-    input: 0.8,
-    cache_write: 1.0,
-    cache_hit: 0.08,
-    output: 4.0,
-  },
   [Models.anthropic.Opus3]: {
     input: 15.0,
     cache_write: 18.75,

package/src/clients/pricing/google.ts

@@ -174,10 +174,6 @@ export const GeminiPricing: Record<string, GeminiModelPricing> = {
     output: 0.4,
     image_generation: 0.039,
   },
-  [Models.google.Gemini_20_Flash_Lite]: {
-    input: 0.075,
-    output: 0.3,
-  },
 
   // ── Gemini 1.5 (legacy) ───────────────────────────────────────────────────
   [Models.google.Gemini_15_Flash]: {

package/src/clients/pricing/xai.ts

@@ -1,6 +1,17 @@
 import { Models } from "../../types";
 
 export const XaiTextPricing = {
+
+  [Models.xai.Grok_4_20_Reasoning]: {
+    input: 2.0,
+    cache_hit: 0.20,
+    output: 6.0,
+  },
+  [Models.xai.Grok_4_20_NonReasoning]: {
+    input: 2.0,
+    cache_hit: 0.20,
+    output: 6.0,
+  },
   [Models.xai.Grok4_1_Fast_NonReasoning]: {
     input: 0.2,
     cache_hit: 0.05,

package/src/login.ts

@@ -49,20 +49,17 @@ export async function login(jwtFlag?: boolean): Promise<void> {
     );
 
     const config = await getConfig();
-    const proxyUrl = KNOWHOW_API_URL + "/api/proxy";
 
     if (!config.modelProviders) {
       config.modelProviders = [];
     }
 
     const hasProvider = config.modelProviders.find(
-      (provider) => provider.provider === "knowhow" && provider.url === proxyUrl
+      (provider) => provider.provider === "knowhow"
     );
     if (!hasProvider) {
       config.modelProviders.push({
         provider: "knowhow",
-        url: proxyUrl,
-        jwtFile: ".knowhow/.jwt",
       });
 
       await updateConfig(config);

package/src/services/Mcp.ts

@@ -136,13 +136,24 @@ export class McpService {
         if (shouldAutoConnect && !this.connected[index]) {
           console.log(`Connecting to MCP server: ${config.name}`);
           try {
-            await client.connect(this.transports[index]);
+            // Wrap connect in a race with a timeout to prevent hanging,
+            // and use a wrapping Promise to catch errors that may come
+            // from event-emitter callbacks (unhandled rejection pattern in MCP SDK)
+            await new Promise<void>(async (resolve, reject) => {
+              try {
+                await client.connect(this.transports[index]);
+                resolve();
+              } catch (err) {
+                reject(err);
+              }
+            });
           } catch (error) {
             console.error(
               `Failed to connect to MCP server '${config.name}':`,
               error.message || error
             );
-            throw error; // Re-throw to mark as rejected in Promise.allSettled
+            // Don't re-throw — just log and continue so other servers can still connect
+            return;
           }
           this.connected[index] = true;
         } else if (!shouldAutoConnect) {
@@ -155,7 +166,10 @@ export class McpService {
 
     // Log summary of auto-connection results
     const successful = results.filter((r) => r.status === "fulfilled").length;
-    const failed = results.filter((r) => r.status === "rejected").length;
+    // Since we no longer re-throw, count servers that are NOT connected after the attempt
+    const failed = this.clients.filter(
+      (_, i) => this.config[i]?.autoConnect !== false && !this.connected[i]
+    ).length;
     if (failed > 0) {
       console.warn(
         `Auto-connected ${successful}/${this.clients.length} MCP servers (${failed} failed)`

package/src/types.ts

@@ -89,9 +89,9 @@ export type Config = {
     auth?: {
       required?: boolean;
       passkey?: {
-        publicKey?: string;       // base64-encoded public key
-        credentialId?: string;    // base64-encoded credential ID
-        algorithm?: string;       // e.g. "ES256"
+        publicKey?: string; // base64-encoded public key
+        credentialId?: string; // base64-encoded credential ID
+        algorithm?: string; // e.g. "ES256"
       };
       sessionDurationHours?: number;
     };
@@ -187,19 +187,20 @@ export const Models = {
   anthropic: {
     Opus4_6: "claude-opus-4-6",
     Sonnet4_6: "claude-sonnet-4-6",
-    Opus4_5: "claude-opus-4-5-20251101",
-    Opus4: "claude-opus-4-20250514",
-    Opus4_1: "claude-opus-4-1-20250805",
-    Sonnet4_5: "claude-sonnet-4-5-20250929",
-    Haiku4_5: "claude-haiku-4-5-20251001",
-    Sonnet4: "claude-sonnet-4-20250514",
-    Sonnet3_7: "claude-3-7-sonnet-20250219",
-    Sonnet3_5: "claude-3-5-sonnet-20241022",
-    Haiku3_5: "claude-3-5-haiku-20241022",
-    Opus3: "claude-3-opus-20240229",
-    Haiku3: "claude-3-haiku-20240307",
+    Opus4_5: "claude-opus-4-5",
+    Opus4: "claude-opus-4",
+    Opus4_1: "claude-opus-4-1",
+    Sonnet4_5: "claude-sonnet-4-5",
+    Haiku4_5: "claude-haiku-4-5",
+    Sonnet4: "claude-sonnet-4",
+    Sonnet3_7: "claude-3-7-sonnet",
+    Sonnet3_5: "claude-3-5-sonnet",
+    Opus3: "claude-3-opus",
+    Haiku3: "claude-3-haiku",
   },
   xai: {
+    Grok_4_20_Reasoning: "grok-4.20-0309-reasoning",
+    Grok_4_20_NonReasoning: "grok-4.20-0309-non-reasoning",
     Grok4_1_Fast_Reasoning: "grok-4-1-fast-reasoning",
     Grok4_1_Fast_NonReasoning: "grok-4-1-fast-non-reasoning",
     GrokCodeFast: "grok-code-fast-1",
@@ -277,13 +278,13 @@ export const Models = {
     Gemini_25_Pro_Preview: "gemini-2.5-pro-preview-05-06",
     Gemini_25_Flash_Image: "gemini-2.5-flash-image",
     Gemini_25_Flash_Live: "gemini-2.5-flash-live-preview",
-    Gemini_25_Flash_Native_Audio: "gemini-2.5-flash-native-audio-preview-12-2025",
+    Gemini_25_Flash_Native_Audio:
+      "gemini-2.5-flash-native-audio-preview-12-2025",
     Gemini_25_Pro_TTS: "gemini-2.5-pro-preview-tts",
     // Gemini 2.0 (deprecated)
     Gemini_20_Flash: "gemini-2.0-flash",
     Gemini_20_Flash_Preview_Image_Generation:
       "gemini-2.0-flash-exp-image-generation",
-    Gemini_20_Flash_Lite: "gemini-2.0-flash-lite",
     // Gemini 1.5 (legacy)
     Gemini_15_Flash: "gemini-1.5-flash",
     Gemini_15_Flash_8B: "gemini-1.5-flash-8b",
@@ -380,7 +381,6 @@ export const GoogleReasoningModels = [
   Models.google.Gemini_25_Flash_Preview,
   Models.google.Gemini_25_Pro_Preview,
   Models.google.Gemini_20_Flash,
-  Models.google.Gemini_20_Flash_Lite,
   Models.google.Gemini_15_Flash,
   Models.google.Gemini_15_Flash_8B,
   Models.google.Gemini_15_Pro,