@tyvm/knowhow 0.0.83 → 0.0.85

package/src/cli.ts

@@ -35,6 +35,7 @@ import { BaseAgent } from "./agents/base/base";
 import { AskModule } from "./chat/modules/AskModule";
 import { SearchModule } from "./chat/modules/SearchModule";
 import { AgentModule } from "./chat/modules/AgentModule";
+import { SessionsModule } from "./chat/modules/SessionsModule";
 import { readPromptFile } from "./ai";
 import { SetupModule } from "./chat/modules/SetupModule";
 import { CliChatService } from "./chat/CliChatService";
@@ -48,22 +49,32 @@ async function setupServices() {
     ...OldTools.getContext(),
   });
 
-  const { Researcher, Developer, Patcher, Setup } = agents({
+  // Build the AgentContext with the fully-populated LazyToolsService so every
+  // agent created (including those in setupAgent) gets all tools registered.
+  const agentContext: import("./agents/base/base").AgentContext = {
     ...services(),
     Tools,
+  };
+
+  const { Researcher, Developer, Patcher, Setup } = agents({
+    ...agentContext,
   });
 
   Agents.registerAgent(Researcher);
   Agents.registerAgent(Patcher);
   Agents.registerAgent(Developer);
   Agents.registerAgent(Setup);
-  Agents.loadAgentsFromConfig(services());
+  Agents.loadAgentsFromConfig(agentContext);
 
   Tools.defineTools(includedTools, allTools);
 
   // Add Mcp service to tool context directly so MCP management tools can access it
   Tools.addContext("Mcp", Mcp);
 
+  // Store the fully-wired AgentContext on AgentService so AgentModule.setupAgent
+  // can retrieve it when creating fresh agent instances via createAgent().
+  Agents.setAgentContext(agentContext);
+
   console.log("🔌 Connecting to MCP...");
   await Mcp.connectToConfigured(Tools);
   console.log("Connecting to clients...");
@@ -322,7 +333,9 @@ async function main() {
     .action(async (options) => {
       try {
         await setupServices();
-        const setupModule = new SetupModule();
+        const agentModule = new AgentModule();
+        await agentModule.initialize(chatService);
+        const setupModule = new SetupModule(agentModule);
         await setupModule.initialize(chatService);
         await setupModule.handleSetupCommand([]);
       } catch (error) {
@@ -367,11 +380,15 @@ async function main() {
   program
     .command("sessions")
     .description("Manage agent sessions from CLI")
-    .action(async () => {
+    .option("--all", "Show all historical sessions (default: current process only)")
+    .option("--csv", "Output sessions as CSV")
+    .action(async (options) => {
       try {
         const agentModule = new AgentModule();
         await agentModule.initialize(chatService);
-        await agentModule.logSessionTable();
+        const sessionsModule = new SessionsModule(agentModule);
+        await sessionsModule.initialize(chatService);
+        await sessionsModule.logSessionTable(options.all || false, options.csv || false, true);
       } catch (error) {
         console.error("Error listing sessions:", error);
         process.exit(1);
@@ -394,6 +411,8 @@ async function main() {
       "--no-sandbox",
       "Run worker directly on host (disable sandbox mode)"
     )
+    .option("--passkey", "Set up passkey authentication for this worker")
+    .option("--passkey-reset", "Remove passkey authentication requirement")
     .action(async (options) => {
       await setupServices();
       await worker(options);

package/src/clients/index.ts

@@ -25,10 +25,23 @@ import { GenericGeminiClient } from "./gemini";
 import { HttpClient } from "./http";
 import { EmbeddingModels, Models } from "../types";
 import { getConfig } from "../config";
+import {
+  GoogleImageModels,
+  GoogleVideoModels,
+  GoogleTTSModels,
+  OpenAiImageModels,
+  OpenAiVideoModels,
+  OpenAiTTSModels,
+  OpenAiTranscriptionModels,
+  XaiImageModels,
+  XaiVideoModels,
+} from "../types";
 import { GenericXAIClient } from "./xai";
 import { KnowhowGenericClient } from "./knowhow";
 import { loadKnowhowJwt } from "../services/KnowhowClient";
 
+export type ModelModality = "completion" | "embedding" | "image" | "audio" | "video";
+
 function envCheck(key: string): boolean {
   const value = process.env[key];
   if (!value) {
@@ -85,6 +98,39 @@ export class AIClient {
     ...(envCheck("XAI_API_KEY") && { xai: this.completionModels.xai }),
   };
 
+  imageModels: Record<string, string[]> = {
+    ...(envCheck("OPENAI_KEY") && {
+      openai: OpenAiImageModels,
+    }),
+    ...(envCheck("GEMINI_API_KEY") && {
+      google: GoogleImageModels,
+    }),
+    ...(envCheck("XAI_API_KEY") && {
+      xai: XaiImageModels,
+    }),
+  };
+
+  audioModels: Record<string, string[]> = {
+    ...(envCheck("OPENAI_KEY") && {
+      openai: [...OpenAiTTSModels, ...OpenAiTranscriptionModels],
+    }),
+    ...(envCheck("GEMINI_API_KEY") && {
+      google: GoogleTTSModels,
+    }),
+  };
+
+  videoModels: Record<string, string[]> = {
+    ...(envCheck("OPENAI_KEY") && {
+      openai: OpenAiVideoModels,
+    }),
+    ...(envCheck("GEMINI_API_KEY") && {
+      google: GoogleVideoModels,
+    }),
+    ...(envCheck("XAI_API_KEY") && {
+      xai: XaiVideoModels,
+    }),
+  };
+
   getClient(provider: string, model?: string) {
     if (provider && !model) {
       return { client: this.clients[provider], provider, model: undefined };
@@ -215,6 +261,39 @@ export class AIClient {
     );
   }
 
+  registerImageModels(provider: string, models: string[]) {
+    const currentModels = this.clientModels[provider] || [];
+    const currentImageModels = this.imageModels[provider] || [];
+    this.clientModels[provider] = Array.from<string>(
+      new Set(currentModels.concat(models))
+    );
+    this.imageModels[provider] = Array.from<string>(
+      new Set(currentImageModels.concat(models))
+    );
+  }
+
+  registerAudioModels(provider: string, models: string[]) {
+    const currentModels = this.clientModels[provider] || [];
+    const currentAudioModels = this.audioModels[provider] || [];
+    this.clientModels[provider] = Array.from<string>(
+      new Set(currentModels.concat(models))
+    );
+    this.audioModels[provider] = Array.from<string>(
+      new Set(currentAudioModels.concat(models))
+    );
+  }
+
+  registerVideoModels(provider: string, models: string[]) {
+    const currentModels = this.clientModels[provider] || [];
+    const currentVideoModels = this.videoModels[provider] || [];
+    this.clientModels[provider] = Array.from<string>(
+      new Set(currentModels.concat(models))
+    );
+    this.videoModels[provider] = Array.from<string>(
+      new Set(currentVideoModels.concat(models))
+    );
+  }
+
   providerHasModel(provider: string, model: string): boolean {
     const models = this.clientModels[provider];
     if (!models) return false;
@@ -517,6 +596,18 @@ export class AIClient {
   listAllProviders() {
     return Object.keys(this.clientModels);
   }
+
+  listAllImageModels() {
+    return this.imageModels;
+  }
+
+  listAllAudioModels() {
+    return this.audioModels;
+  }
+
+  listAllVideoModels() {
+    return this.videoModels;
+  }
 }
 
 export const Clients = new AIClient();

package/src/clients/pricing/google.ts

@@ -1,7 +1,8 @@
 import { Models, EmbeddingModels } from "../../types";
 
 export const GeminiTextPricing = {
-  [Models.google.Gemini_3_Preview]: {
+  // Gemini 3.x
+  [Models.google.Gemini_31_Pro_Preview]: {
     input: 2,
     input_gt_200k: 4,
     output: 12,
@@ -9,6 +10,45 @@ export const GeminiTextPricing = {
     context_caching: 0.2,
     context_caching_gt_200k: 0.4,
   },
+  [Models.google.Gemini_31_Flash_Image_Preview]: {
+    input: 0.5,
+    output: 3,
+    image_generation: 0.045, // per 0.5K image
+  },
+  [Models.google.Gemini_31_Flash_Lite_Preview]: {
+    input: 0.25,
+    output: 1.5,
+    context_caching: 0.025,
+  },
+  [Models.google.Gemini_3_Flash_Preview]: {
+    input: 0.5,
+    output: 3.0,
+    context_caching: 0.05,
+  },
+  [Models.google.Gemini_3_Pro_Image_Preview]: {
+    input: 2,
+    output: 12,
+    image_generation: 0.134, // per 1K/2K image
+  },
+  // Gemini 2.5
+  [Models.google.Gemini_25_Pro]: {
+    input: 1.25,
+    input_gt_200k: 2.5,
+    output: 10.0,
+    output_gt_200k: 15.0,
+    context_caching: 0.125,
+    context_caching_gt_200k: 0.25,
+  },
+  [Models.google.Gemini_25_Flash]: {
+    input: 0.3,
+    output: 2.5,
+    context_caching: 0.03,
+  },
+  [Models.google.Gemini_25_Flash_Lite]: {
+    input: 0.1,
+    output: 0.4,
+    context_caching: 0.01,
+  },
   [Models.google.Gemini_25_Flash_Preview]: {
     input: 0.3,
     output: 2.5,
@@ -23,6 +63,19 @@ export const GeminiTextPricing = {
     context_caching: 0.125,
     context_caching_gt_200k: 0.25,
   },
+  [Models.google.Gemini_25_Flash_Image]: {
+    input: 0.3,
+    output: 0.039, // per image ($30/1M tokens, 1290 tokens per image)
+  },
+  [Models.google.Gemini_25_Flash_TTS]: {
+    input: 0.5,
+    output: 10.0,
+  },
+  [Models.google.Gemini_25_Pro_TTS]: {
+    input: 1.0,
+    output: 20.0,
+  },
+  // Gemini 2.0 (deprecated)
   [Models.google.Gemini_20_Flash]: {
     input: 0.1,
     output: 0.4,
@@ -37,6 +90,7 @@ export const GeminiTextPricing = {
     input: 0.075,
     output: 0.3,
   },
+  // Gemini 1.5 (legacy)
   [Models.google.Gemini_15_Flash]: {
     input: 0.075,
     output: 0.3,
@@ -52,14 +106,39 @@ export const GeminiTextPricing = {
     output: 5.0,
     context_caching: 0.3125,
   },
+  // Image generation
   [Models.google.Imagen_3]: {
-    image_generation: 0.03,
+    image_generation: 0.04, // Imagen 4 Standard: $0.04/image
+  },
+  [Models.google.Imagen_4_Fast]: {
+    image_generation: 0.02, // $0.02/image
   },
+  [Models.google.Imagen_4_Ultra]: {
+    image_generation: 0.06, // $0.06/image
+  },
+  // Video generation
   [Models.google.Veo_2]: {
     video_generation: 0.35,
   },
+  [Models.google.Veo_3]: {
+    video_generation: 0.4, // $0.40/second
+  },
+  [Models.google.Veo_3_Fast]: {
+    video_generation: 0.15, // $0.15/second
+  },
+  [Models.google.Veo_3_1]: {
+    video_generation: 0.4, // $0.40/second (720p/1080p)
+  },
+  [Models.google.Veo_3_1_Fast]: {
+    video_generation: 0.15, // $0.15/second
+  },
+  // Embeddings
   [EmbeddingModels.google.Gemini_Embedding]: {
     input: 0, // Free of charge
     output: 0, // Free of charge
   },
+  [EmbeddingModels.google.Gemini_Embedding_001]: {
+    input: 0.15,
+    output: 0,
+  },
 };

package/src/clients/pricing/openai.ts

@@ -1,6 +1,36 @@
 import { Models, EmbeddingModels } from "../../types";
 
 export const OpenAiTextPricing = {
+  [Models.openai.GPT_54]: {
+    input: 2.5,
+    cached_input: 0.25,
+    output: 15.0,
+  },
+  [Models.openai.GPT_54_Mini]: {
+    input: 0.75,
+    cached_input: 0.075,
+    output: 4.5,
+  },
+  [Models.openai.GPT_54_Nano]: {
+    input: 0.2,
+    cached_input: 0.02,
+    output: 1.25,
+  },
+  [Models.openai.GPT_54_Pro]: {
+    input: 30.0,
+    cached_input: 0,
+    output: 180.0,
+  },
+  [Models.openai.GPT_53_Chat]: {
+    input: 1.75,
+    cached_input: 0.175,
+    output: 14.0,
+  },
+  [Models.openai.GPT_53_Codex]: {
+    input: 1.75,
+    cached_input: 0.175,
+    output: 14.0,
+  },
   [Models.openai.GPT_4o]: {
     input: 2.5,
     cached_input: 1.25,
@@ -76,6 +106,11 @@ export const OpenAiTextPricing = {
     cached_input: 0.5,
     output: 8.0,
   },
+  [Models.openai.o3_Pro]: {
+    input: 20.0,
+    cached_input: 0,
+    output: 80.0,
+  },
   [Models.openai.o4_Mini]: {
     input: 1.1,
     cached_input: 0.275,
@@ -131,4 +166,37 @@ export const OpenAiTextPricing = {
     cached_input: 0,
     output: 0,
   },
+  // New realtime models
+  [Models.openai.GPT_Realtime_15]: {
+    input: 4.0,
+    cached_input: 0.4,
+    output: 16.0,
+  },
+  [Models.openai.GPT_Realtime_Mini]: {
+    input: 0.6,
+    cached_input: 0.06,
+    output: 2.4,
+  },
+  // New image models (text token pricing)
+  [Models.openai.GPT_Image_15]: {
+    input: 5.0,
+    cached_input: 1.25,
+    output: 10.0,
+  },
+  [Models.openai.GPT_Image_1_Mini]: {
+    input: 2.0,
+    cached_input: 0.2,
+    output: 0,
+  },
+  // New transcription models
+  [Models.openai.GPT_4o_Transcribe]: {
+    input: 2.5,
+    cached_input: 0,
+    output: 10.0,
+  },
+  [Models.openai.GPT_4o_Mini_Transcribe]: {
+    input: 1.25,
+    cached_input: 0,
+    output: 5.0,
+  },
 };

package/src/config.ts

@@ -262,6 +262,21 @@ export async function getConfig() {
   }
 }
 
+export async function getGlobalConfig(): Promise<Config> {
+  const globalConfigDir = getGlobalConfigDir();
+  const globalConfigPath = path.join(globalConfigDir, "knowhow.json");
+  if (!fs.existsSync(globalConfigPath)) {
+    return {} as Config;
+  }
+  try {
+    const config = await readFile(globalConfigPath, "utf8");
+    return JSON.parse(config) as Config;
+  } catch (error) {
+    console.warn("Failed to load global knowhow config:", error);
+    return {} as Config;
+  }
+}
+
 export async function migrateConfig() {
   // Apply migrations, used to keep config structure up to date.
   if (!fs.existsSync(".knowhow/knowhow.json")) {

package/src/plugins/AgentsMdPlugin.ts

@@ -98,7 +98,7 @@ export class AgentsMdPlugin extends PluginBase implements Plugin {
 
       events.emit("agent:msg", alertMessage);
     } catch (error) {
-      console.error("AGENTS-MD PLUGIN: Error handling file event:", error);
+      this.log("AGENTS-MD PLUGIN: Error handling file event: " + error, "error");
     }
   }
 

package/src/plugins/GitPlugin.ts

@@ -110,7 +110,7 @@ Your modifications are automatically tracked separately and won't affect the use
 
       await this.setBranch("main");
     } catch (error) {
-      console.error("Failed to initialize .knowhow git repository:", error);
+      this.log(`Failed to initialize .knowhow git repository: ${error}`, "error");
     }
   }
 
@@ -144,7 +144,7 @@ Your modifications are automatically tracked separately and won't affect the use
     try {
       return this.gitCommand(command, options);
     } catch (error) {
-      console.warn(`Safe git command failed: ${command}`, error);
+      this.log(`Safe git command failed: ${command} - ${error}`, "warn");
       return null;
     }
   }
@@ -235,7 +235,7 @@ Your modifications are automatically tracked separately and won't affect the use
 
       // Get the current HEAD commit hash from the actual repo (if it exists)
       const actualRepoHash = this.getRepoHash();
-      console.log(`GitPlugin: Current branch is ${this.getCurrentBranch()}`);
+      this.log(`Current branch is ${this.getCurrentBranch()}`);
 
       // First, handle any uncommitted changes on the current branch
       const hasChanges = await this.hasChanges();
@@ -246,7 +246,7 @@ Your modifications are automatically tracked separately and won't affect the use
             : `sync ${new Date().toISOString()}`;
           await this.commitAll(message);
         } catch (error) {
-          console.error("Failed to commit uncommitted changes:", error);
+          this.log(`Failed to commit uncommitted changes: ${error}`, "error");
         }
       }
 
@@ -259,7 +259,7 @@ Your modifications are automatically tracked separately and won't affect the use
 
       await this.setBranch("main");
     } catch (error) {
-      console.error("Failed to ensure clean state:", error);
+      this.log(`Failed to ensure clean state: ${error}`, "error");
     }
   }
 
@@ -288,7 +288,7 @@ Your modifications are automatically tracked separately and won't affect the use
         this.gitCommand(`checkout -b ${branchName}`);
       }
     } catch (error) {
-      console.error(`GitPlugin: Failed to set branch ${branchName}:`);
+      this.log(`Failed to set branch ${branchName}`, "error");
     }
   }
 
@@ -298,7 +298,7 @@ Your modifications are automatically tracked separately and won't affect the use
     try {
       this.gitCommand(`checkout -b ${branchName}`);
     } catch (error) {
-      console.error(`GitPlugin: Failed to create branch ${branchName}:`);
+      this.log(`Failed to create branch ${branchName}`, "error");
     }
   }
 
@@ -317,7 +317,7 @@ Your modifications are automatically tracked separately and won't affect the use
         try {
           this.gitCommand(`add "${file}"`);
         } catch (error) {
-          console.warn(`Failed to add file ${file}:`, error);
+          this.log(`Failed to add file ${file}: ${error}`, "warn");
         }
       }
     } else {
@@ -339,7 +339,7 @@ Your modifications are automatically tracked separately and won't affect the use
       this.gitCommand("add -A");
       await this.commitWithEvents(message);
     } catch (error) {
-      console.error("Failed to commit all changes:", error);
+      this.log(`Failed to commit all changes: ${error}`, "error");
     }
   }
 
@@ -389,7 +389,7 @@ Your modifications are automatically tracked separately and won't affect the use
         `
       );
     } catch (error) {
-      console.error("Failed to commit with events:", error);
+      this.log(`Failed to commit with events: ${error}`, "error");
     }
   }
 
@@ -402,7 +402,7 @@ Your modifications are automatically tracked separately and won't affect the use
       try {
         this.gitCommand('commit --allow-empty -m "Initial empty commit"');
       } catch (error) {
-        console.warn("Could not create initial commit:", error);
+        this.log(`Could not create initial commit: ${error}`, "warn");
       }
     }
   }
@@ -424,7 +424,7 @@ Your modifications are automatically tracked separately and won't affect the use
 
       await this.commitAll(message);
     } catch (error) {
-      console.error("Auto-commit failed:", error);
+      this.log(`Auto-commit failed: ${error}`, "error");
     }
   }
 
@@ -455,9 +455,9 @@ Your modifications are automatically tracked separately and won't affect the use
         );
       }
 
-      console.log(`Created new task branch: ${branchName}`);
+      this.log(`Created new task branch: ${branchName}`);
     } catch (error) {
-      console.error("Failed to handle new task:", error);
+      this.log(`Failed to handle new task: ${error}`, "error");
     }
   }
 
@@ -466,7 +466,7 @@ Your modifications are automatically tracked separately and won't affect the use
 
     try {
       if (!this.currentTask) {
-        console.warn("No tasks in progress to complete");
+        this.log("No tasks in progress to complete", "warn");
         return;
       }
 
@@ -488,7 +488,7 @@ Your modifications are automatically tracked separately and won't affect the use
       // Clear current task
       this.currentTask = null;
     } catch (error) {
-      console.error("Failed to handle task completion:", error);
+      this.log(`Failed to handle task completion: ${error}`, "error");
     }
   }
 
@@ -523,9 +523,9 @@ Your modifications are automatically tracked separately and won't affect the use
     try {
       const noteMessage = `[Build Stable] No linting issues found on branch: ${this.getCurrentBranch()}`;
       this.gitCommand(`notes add -f -m "${noteMessage}" ${commitHash}`);
-      console.log(`GitPlugin: Marked commit ${commitHash} as build stable`);
+      this.log(`Marked commit ${commitHash} as build stable`);
     } catch (error) {
-      console.warn(`GitPlugin: Failed to add git note for commit ${commitHash}:`, error);
+      this.log(`Failed to add git note for commit ${commitHash}: ${error}`, "warn");
     }
   }
 
@@ -559,7 +559,7 @@ Your modifications are automatically tracked separately and won't affect the use
         .map((line) => line.replace(/^\*?\s*/, "").trim())
         .filter((line) => line.length > 0);
     } catch (error) {
-      console.error("Error getting branches:", error);
+      this.log(`Error getting branches: ${error}`, "error");
       return [];
     }
   }
@@ -592,7 +592,7 @@ Your modifications are automatically tracked separately and won't affect the use
         this.commitAll(message);
       }
     } catch (error) {
-      console.error(`Failed to merge ${branchName}:`, error);
+      this.log(`Failed to merge ${branchName}: ${error}`, "error");
     }
   }
 }

package/src/plugins/PluginBase.ts

@@ -43,6 +43,17 @@ export abstract class PluginBase implements Plugin {
     return true; // subclasses override if needed
   }
 
+  protected log(message: string, level: "info" | "warn" | "error" = "info"): void {
+    if (this.context.Events) {
+      this.context.Events.log(this.meta.name, message, level);
+    } else {
+      // Fallback to console if no Events service
+      if (level === "error") console.error(`[${this.meta.name}] ${message}`);
+      else if (level === "warn") console.warn(`[${this.meta.name}] ${message}`);
+      else console.log(`[${this.meta.name}] ${message}`);
+    }
+  }
+
   /* ------------------------------------------------------------------ */
   /** Default callMany implementation - delegates to call ------------ */
   /* ------------------------------------------------------------------ */