@tyvm/knowhow 0.0.108-dev.bd8f104-dev.bd8f104-dev.bd8f104 → 0.0.108-dev.c47492f

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyvm/knowhow",
-  "version": "0.0.108-dev.bd8f104-dev.bd8f104-dev.bd8f104",
+  "version": "0.0.108-dev.c47492f",
   "description": "ai cli with plugins and agents",
   "main": "ts_build/src/index.js",
   "bin": {
@@ -55,7 +55,7 @@
     "@inquirer/editor": "^4.2.18",
     "@modelcontextprotocol/sdk": "^1.13.3",
     "@simplewebauthn/server": "^13.3.0",
-    "@tyvm/knowhow-tunnel": "0.0.4",
+    "@tyvm/knowhow-tunnel": "0.0.5",
     "commander": "^14.0.0",
     "diff": "^5.2.0",
     "express": "^4.19.2",

package/scripts/publish.sh

@@ -10,21 +10,37 @@ get_current_version() {
 version_nightly() {
   local version
   version=$(get_current_version)
+  # Strip any existing pre-release suffix (e.g. -dev.xxx or -nightly.xxx)
+  version=$(echo "$version" | sed 's/-.*$//')
   local stamp
   stamp=$(date -u +%Y%m%d)
   local pre="${version}-nightly.${stamp}"
-  echo "Bumping version to: $pre"
-  npm version "$pre" --no-git-tag-version
+  local current
+  current=$(get_current_version)
+  if [ "$current" = "$pre" ]; then
+    echo "Version already set to: $pre (no change needed)"
+  else
+    echo "Bumping version to: $pre"
+    npm version "$pre" --no-git-tag-version
+  fi
 }
 
 version_dev() {
   local version
   version=$(get_current_version)
+  # Strip any existing pre-release suffix (e.g. -dev.xxx or -nightly.xxx)
+  version=$(echo "$version" | sed 's/-.*$//')
   local hash
   hash=$(git rev-parse --short HEAD)
   local pre="${version}-dev.${hash}"
-  echo "Bumping version to: $pre"
-  npm version "$pre" --no-git-tag-version
+  local current
+  current=$(get_current_version)
+  if [ "$current" = "$pre" ]; then
+    echo "Version already set to: $pre (no change needed)"
+  else
+    echo "Bumping version to: $pre"
+    npm version "$pre" --no-git-tag-version
+  fi
 }
 
 case "$COMMAND" in

package/src/agents/base/base.ts

@@ -317,6 +317,15 @@ export abstract class BaseAgent implements IAgent {
       if (trimmed.startsWith("✅") || /^[\d\.\-\*]/.test(trimmed)) return true;
     }
 
+    // Detect JSON-wrapped finalAnswer output, e.g. {"answer":"..."} or {"finalAnswer":"..."}
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (parsed && typeof parsed === "object") {
+        if (typeof parsed.answer === "string") return true;
+        if (typeof parsed.finalAnswer === "string") return true;
+      }
+    } catch (_) {}
+
     return false;
   }
 

package/src/chat/CliChatService.ts

@@ -265,7 +265,13 @@ export class CliChatService implements ChatService {
     if (this.context.voiceMode) {
       value = await voiceToText();
     } else if (this.context.multilineMode) {
-      value = await editor({ message: prompt });
+      const renderer = this.context.renderer;
+      if (renderer) renderer.pause();
+      try {
+        value = await editor({ message: prompt });
+      } finally {
+        if (renderer) renderer.resume();
+      }
       this.context.multilineMode = false; // Disable after use like original
     } else {
       // Use saved input history for scrollback (InputQueueManager handles reverse access)

package/src/chat/renderer/CompactRenderer.ts

@@ -72,6 +72,8 @@ function colorFor(n: string) {
 export class CompactRenderer implements AgentRenderer {
   private activeTaskId: string | undefined;
   private emitter = new EventEmitter();
+  private paused = false;
+  private bufferedEvents: RenderEvent[] = [];
 
   setActiveTaskId(id: string | undefined): void {
     this.activeTaskId = id;
@@ -110,8 +112,26 @@ export class CompactRenderer implements AgentRenderer {
     this.emitter.on("agentDone", handler);
   }
 
+  pause(): void {
+    this.paused = true;
+  }
+
+  resume(): void {
+    this.paused = false;
+    const buffered = this.bufferedEvents.splice(0);
+    for (const event of buffered) {
+      this.render(event);
+    }
+  }
+
   render(event: RenderEvent): void {
     if (!this.isActiveTask(event.taskId)) return;
+
+    if (this.paused) {
+      this.bufferedEvents.push(event);
+      return;
+    }
+
     this.emitter.emit(event.type, event);
     switch (event.type) {
       case "log":

package/src/chat/renderer/ConsoleRenderer.ts

@@ -17,6 +17,8 @@ import { EventEmitter } from "events";
 export class ConsoleRenderer implements AgentRenderer {
   private activeTaskId: string | undefined;
   private emitter = new EventEmitter();
+  private paused = false;
+  private bufferedEvents: RenderEvent[] = [];
 
   setActiveTaskId(taskId: string | undefined): void {
     this.activeTaskId = taskId;
@@ -56,9 +58,26 @@ export class ConsoleRenderer implements AgentRenderer {
     this.emitter.on("agentDone", handler);
   }
 
+  pause(): void {
+    this.paused = true;
+  }
+
+  resume(): void {
+    this.paused = false;
+    const buffered = this.bufferedEvents.splice(0);
+    for (const event of buffered) {
+      this.render(event);
+    }
+  }
+
   render(event: RenderEvent): void {
     if (!this.isActiveTask(event.taskId)) return;
 
+    if (this.paused) {
+      this.bufferedEvents.push(event);
+      return;
+    }
+
     switch (event.type) {
       case "log":
         this.emitter.emit("log", event);

package/src/chat/renderer/FancyRenderer.ts

@@ -194,6 +194,8 @@ const toolTimers = new Map<string, number>();
 export class FancyRenderer implements AgentRenderer {
   private activeTaskId: string | undefined;
   private emitter = new EventEmitter();
+  private paused = false;
+  private bufferedEvents: RenderEvent[] = [];
 
   setActiveTaskId(taskId: string | undefined): void {
     this.activeTaskId = taskId;
@@ -227,9 +229,26 @@ export class FancyRenderer implements AgentRenderer {
     this.emitter.on("agentDone", handler);
   }
 
+  pause(): void {
+    this.paused = true;
+  }
+
+  resume(): void {
+    this.paused = false;
+    const buffered = this.bufferedEvents.splice(0);
+    for (const event of buffered) {
+      this.render(event);
+    }
+  }
+
   render(event: RenderEvent): void {
     if (!this.isActiveTask(event.taskId)) return;
 
+    if (this.paused) {
+      this.bufferedEvents.push(event);
+      return;
+    }
+
     switch (event.type) {
       case "log":
         this.emitter.emit("log", event);

package/src/chat/renderer/types.ts

@@ -80,6 +80,17 @@ export interface AgentRenderer {
   setActiveTaskId(taskId: string | undefined): void;
   getActiveTaskId(): string | undefined;
 
+  /**
+   * Pause rendering - buffer any incoming events instead of printing them.
+   * Useful when an interactive UI (e.g. editor for /multi) takes over the terminal.
+   */
+  pause(): void;
+
+  /**
+   * Resume rendering - flush any buffered events and resume normal output.
+   */
+  resume(): void;
+
   /**
    * Replay the last N render events (used by /logs command).
    * If count is not provided, shows last 10.

package/src/cli.ts

@@ -14,7 +14,8 @@ import { includedTools } from "./agents/tools/list";
 import * as allTools from "./agents/tools";
 import { LazyToolsService, services } from "./services";
 import { login } from "./login";
-import { worker, tunnel } from "./worker";
+import { worker } from "./worker";
+import { TUNNEL_MINIMAL_TOOLS } from "./tunnel";
 import { fileSync } from "./fileSync";
 import { KnowhowSimpleClient } from "./services/KnowhowClient";
 import { ModulesService } from "./services/modules";
@@ -44,23 +45,28 @@ import { CliChatService } from "./chat/CliChatService";
 // 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);
+  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}`
-  );
+  console.warn(`⚠ Unhandled MCP/async error (non-fatal): ${message}`);
 });
 
 async function setupServices() {
-  const { Agents, Mcp, Clients, Tools: OldTools } = services();
+  const {
+    Agents,
+    Mcp,
+    Clients,
+    Tools: AllTools,
+    Embeddings,
+    Plugins,
+    MediaProcessor,
+  } = services();
   const Tools = new LazyToolsService(); // eslint-disable-line no-shadow
 
   // Load modules from config first so module-provided tools/agents/plugins are available
   // We need to wireup the LazyTools to be connected to the same singletons that are in services()
   Tools.setContext({
-    ...OldTools.getContext(),
+    ...AllTools.getContext(),
   });
 
   // Build the AgentContext with the fully-populated LazyToolsService so every
@@ -107,16 +113,17 @@ async function setupServices() {
   const modulesService = new ModulesService();
   await modulesService.loadModulesFromConfig({
     Agents,
-    Embeddings: services().Embeddings,
-    Plugins: services().Plugins,
+    Embeddings,
+    Plugins,
     Clients,
+
     // Use LazyToolsService so module-provided tools are visible to agents and scripts
-    Tools: Tools as any,
-    MediaProcessor: services().MediaProcessor,
+    Tools,
+    MediaProcessor,
   });
 
-  // Return both LazyToolsService (for agents) and OldTools (plain ToolsService with all tools for scripts)
-  return { Tools, Clients, PlainTools: OldTools };
+  // Return both LazyToolsService (for agents) and AllTools (plain ToolsService with all tools for scripts)
+  return { Tools, Clients };
 }
 
 // Utility function to read from stdin
@@ -528,14 +535,25 @@ async function main() {
   program
     .command("cloudworker")
     .description("Create or sync a cloud worker with your local knowhow config")
-    .option("--create", "Create a new cloud worker with synced config and files")
-    .option("--push <uid>", "Push/sync local config and files to an existing cloud worker")
-    .option("--pull <id>", "Pull the latest workerConfigJson from a cloud worker and update local config")
+    .option(
+      "--create",
+      "Create a new cloud worker with synced config and files"
+    )
+    .option(
+      "--push <uid>",
+      "Push/sync local config and files to an existing cloud worker"
+    )
+    .option(
+      "--pull <id>",
+      "Pull the latest workerConfigJson from a cloud worker and update local config"
+    )
     .option("--name <name>", "Name for the cloud worker (used with --create)")
     .option("--dry-run", "Print what would be synced without doing it")
     .action(async (options) => {
       try {
-        const { cloudWorker, pullCloudWorkerConfig } = await import("./cloudWorker");
+        const { cloudWorker, pullCloudWorkerConfig } = await import(
+          "./cloudWorker"
+        );
         if (options.pull) {
           await pullCloudWorkerConfig({ id: options.pull });
         } else {
@@ -550,7 +568,9 @@ async function main() {
   program
     .command("tunnel")
     .description(
-      "Start tunnel-only mode: expose local ports to the cloud without registering any tools"
+      "Start a minimal worker with tunnel enabled: exposes local ports to the cloud. " +
+      "Registers essential tools (unlock, lock, listAllowedPorts) so the backend is aware of the worker and ports. " +
+      "If passkey auth is configured, the tunnel is locked until unlocked via tool call or WebSocket auth protocol."
     )
     .option(
       "--share",
@@ -558,10 +578,14 @@ async function main() {
     )
     .option("--unshare", "Make this tunnel private (only you can use it)")
     .action(async (options) => {
-      await tunnel(options);
+      console.log("🌐 Starting tunnel (minimal worker) mode...");
+      console.log(`   Tools: ${TUNNEL_MINIMAL_TOOLS.join(", ")}`);
+      await worker({
+        ...options,
+        allowedTools: TUNNEL_MINIMAL_TOOLS,
+      });
     });
 
-
   program
     .command("script")
     .description("Run a local tool script file using the executeScript sandbox")

package/src/clients/types.ts

@@ -1,4 +1,10 @@
-export type ModelModality = "completion" | "embedding" | "image" | "audio" | "video" | "transcription";
+export type ModelModality =
+  | "completion"
+  | "embedding"
+  | "image"
+  | "audio"
+  | "video"
+  | "transcription";
 
 export type MessageContent =
   | { type: "text"; text: string }
@@ -8,7 +14,7 @@ export type MessageContent =
 
 export interface Message {
   role: "system" | "user" | "assistant" | "tool";
-  content?: string | MessageContent[];
+  content?: string | MessageContent[] | null;
 
   name?: string;
   tool_call_id?: string;
@@ -16,7 +22,7 @@ export interface Message {
 }
 
 export interface OutputMessage extends Message {
-  content: string;
+  content?: string | null;
 }
 
 export interface ToolProp {
@@ -301,7 +307,9 @@ export interface GenericClient {
    * When modality is provided, return only models for that modality (static list).
    * When omitted, return ALL models (backward compat — may do a live API call).
    */
-  getModels(modality?: ModelModality): Promise<{ id: string; modality?: ModelModality[] }[]>;
+  getModels(
+    modality?: ModelModality
+  ): Promise<{ id: string; modality?: ModelModality[] }[]>;
   /**
    * Returns the context window limit and compression threshold for a given model,
    * or undefined if the model is not known to this client.

package/src/processors/JsonCompressor.ts

@@ -382,7 +382,7 @@ export class JsonCompressor {
             i + currentChunk.length - 1
           }]\nPreview: ${chunkString.substring(0, 100)}...\n[Use ${
             this.toolName
-          } tool with key "${key}" to retrieve this chunk]`;
+          } tool with key "${key}" to retrieve this chunk]\n[TIP: try jqToolResponse,grepToolResponse,tailToolResponse to filter/search/map without repeated ${this.toolName} calls - especially useful for JSON data]`;
           finalArray.unshift(stub); // Add stub to the start of our final result.
 
           currentChunk = [];
@@ -453,7 +453,7 @@ export class JsonCompressor {
           result
         ).join(", ")}\nPreview: ${objectAsString.substring(0, 200)}...\n[Use ${
           this.toolName
-        } tool with key "${key}" to retrieve full content]`;
+        } tool with key "${key}" to retrieve full content]\n[TIP: try jqToolResponse,grepToolResponse,tailToolResponse to filter/search/map without repeated ${this.toolName} calls - especially useful for JSON data]`;
       }
       return result;
     }
@@ -486,7 +486,7 @@ export class JsonCompressor {
           200
         )}...\n[Use ${
           this.toolName
-        } tool with key "${key}" to retrieve full content]`;
+        } tool with key "${key}" to retrieve full content]\n[TIP: try jqToolResponse,grepToolResponse,tailToolResponse to filter/search/map without repeated ${this.toolName} calls - especially useful for JSON data]`;
       }
       return obj;
     }

package/src/services/modules/index.ts

@@ -5,20 +5,21 @@ import { services } from "../";
 import * as path from "path";
 
 export class ModulesService {
+  async getDefaultContext() {
+    return { ...services() };
+  }
+
+  async overrideDefaultContext(overrides: Partial<ModuleContext>) {
+    const defaultContext = await this.getDefaultContext();
+    return { ...defaultContext, ...overrides };
+  }
+
   async loadModulesFromConfig(context?: ModuleContext) {
     const config = await getConfig();
 
     // If no context provided, fall back to global singletons
     if (!context) {
-      const { Clients, Plugins, Agents, Tools, Embeddings, MediaProcessor } = services();
-      context = {
-        Agents,
-        Embeddings,
-        Plugins,
-        Clients,
-        Tools,
-        MediaProcessor,
-      };
+      context = { ...(await this.getDefaultContext()) };
     }
 
     // Use the toolsService from context
@@ -43,9 +44,13 @@ export class ModulesService {
         : modulePath;
       const rawModule = require(resolvedPath);
       const importedModule = (rawModule.default || rawModule) as KnowhowModule;
-      console.log(`🔌 Loading module: ${modulePath} (resolved: ${resolvedPath})`);
+      console.log(
+        `🔌 Loading module: ${modulePath} (resolved: ${resolvedPath})`
+      );
       await importedModule.init({ config, cwd: process.cwd(), context });
-      console.log(`✅ Module initialized: ${modulePath} (tools: ${importedModule.tools.length}, agents: ${importedModule.agents.length}, plugins: ${importedModule.plugins.length}, clients: ${importedModule.clients.length})`);
+      console.log(
+        `✅ Module initialized: ${modulePath} (tools: ${importedModule.tools.length}, agents: ${importedModule.agents.length}, plugins: ${importedModule.plugins.length}, clients: ${importedModule.clients.length})`
+      );
 
       for (const agent of importedModule.agents) {
         agentService.registerAgent(agent);
@@ -58,13 +63,12 @@ export class ModulesService {
 
       for (const plugin of importedModule.plugins) {
         const pluginContext = {
-          Agents: agentService,
-          Clients: clients,
-          Tools: toolsService,
-          Plugins: pluginService,
-          ...(context.MediaProcessor ? { MediaProcessor: context.MediaProcessor } : {}),
+          ...context,
         };
-        pluginService.registerPlugin(plugin.name, new plugin.plugin(pluginContext as any));
+        pluginService.registerPlugin(
+          plugin.name,
+          new plugin.plugin(pluginContext as any)
+        );
       }
 
       for (const client of importedModule.clients) {