@tyvm/knowhow 0.0.130 → 0.0.132

package/src/clients/anthropic.ts

@@ -519,7 +519,15 @@ export class GenericAnthropicClient implements GenericClient {
     const rawP = this.pricesPerMillion()[model];
     // Fall back to pricing file for unknown/newer models
     const fallback = AnthropicTextPricing[model as keyof typeof AnthropicTextPricing];
-    const p: any = rawP || fallback || undefined;
+    // Second fallback: short aliases like "claude-sonnet-4-5" don't have their
+    // own entry but map to a dated version like "claude-sonnet-4-5-20250929".
+    // Find the first pricing entry whose key starts with the short model name.
+    const aliasFallback = !rawP && !fallback
+      ? Object.entries(AnthropicTextPricing).find(([key]) =>
+          key.startsWith(model + "-")
+        )?.[1]
+      : undefined;
+    const p: any = rawP || fallback || aliasFallback || undefined;
     if (!p) return undefined;
 
     const inputTokens = usage.input_tokens ?? 0;

package/src/clients/fireworks.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "./http";
-import { FireworksTextPricing } from "./pricing/fireworks";
+import { FireworksTextPricing, FireworksEmbeddingPricing } from "./pricing/fireworks";
 import { CompletionOptions, CompletionResponse } from "./types";
 
 type ModelInfo = { id: string; object: string; owned_by: string };
@@ -22,6 +22,15 @@ export class GenericFireworksClient extends HttpClient {
    * Our pricing map is the authoritative source of truth for available models.
    */
   async getModels(_type = "all"): Promise<ModelInfo[]> {
+    // Return embedding/reranker models when requested
+    if (_type === "embedding") {
+      return Object.keys(FireworksEmbeddingPricing).map((id) => ({
+        id,
+        object: "model",
+        owned_by: "fireworks",
+      }));
+    }
+
     return Object.keys(FireworksTextPricing).map((id) => ({
       id,
       object: "model",

package/src/clients/index.ts

@@ -310,9 +310,12 @@ export class AIClient {
 
       if (!client) {
         if (entry.provider === "knowhow") {
-          console.warn(
-            `⚠️  Knowhow provider is not logged in. Run 'knowhow login' to enable Knowhow models.`
-          );
+          if (process.env.KNOWHOW_CLI) {
+            const warnNeeds = (process.env.KNOWHOW_WARN_NEEDS ?? "").split(",");
+            if (warnNeeds.includes("models")) console.warn(
+              `⚠️  Knowhow provider is not logged in. Run 'knowhow login' to enable Knowhow models.`
+            );
+          }
         }
         continue;
       }

package/src/clients/meta.ts

@@ -1,5 +1,6 @@
 import { HttpClient } from "./http";
 import { MetaTextPricing } from "./pricing/meta";
+import { ModelModality } from "./types";
 
 /**
  * Meta Model API client — OpenAI-compatible API
@@ -15,4 +16,12 @@ export class GenericMetaClient extends HttpClient {
     if (apiKey) this.setJwt(apiKey);
     this.setPrices(MetaTextPricing);
   }
+
+  /**
+   * Meta Model API only provides chat completion models — no embeddings, images, audio, or video.
+   */
+  async getModels(type: ModelModality | "all" = "all") {
+    if (type === "embedding") return [];
+    return super.getModels(type as string);
+  }
 }

package/src/clients/pricing/anthropic.ts

@@ -10,6 +10,13 @@ import { completions, ModelCatalogEntry, ModelPricing } from "./types";
 export const AnthropicModels = {
   // Active models
   Fable5:    "claude-fable-5",
+  // Short aliases (without date suffix) — Anthropic resolves these to the latest
+  // dated version. Pricing entries for the short aliases are added to the pricing
+  // table below so cost tracking works regardless of whether the user specifies
+  // the full dated name or the short alias.
+  Sonnet4_5Short: "claude-sonnet-4-5",
+  Haiku4_5Short:  "claude-haiku-4-5",
+  Opus4_5Short:   "claude-opus-4-5",
   Sonnet5:   "claude-sonnet-5",
   Mythos5:   "claude-mythos-5",
   MythosPreview: "claude-mythos-preview",
@@ -101,6 +108,10 @@ export const AnthropicTextPricing: Record<string, ModelPricing> = {
   [AnthropicModels.Opus4_1]:   { input: 15.0, cache_write: 18.75,  cache_hit: 1.5,  output: 75.0 },
   [AnthropicModels.Sonnet4_5]: { input: 3.0,  input_gt_200k: 6.0,  cache_write: 3.75, cache_hit: 0.3, output: 15.0, output_gt_200k: 22.5 },
   [AnthropicModels.Haiku4_5]:  { input: 1.0,  cache_write: 1.25,   cache_hit: 0.1,  output: 5.0 },
+  // Short aliases — same pricing as their dated counterparts
+  [AnthropicModels.Sonnet4_5Short]: { input: 3.0, input_gt_200k: 6.0, cache_write: 3.75, cache_hit: 0.3, output: 15.0, output_gt_200k: 22.5 },
+  [AnthropicModels.Haiku4_5Short]:  { input: 1.0, cache_write: 1.25, cache_hit: 0.1, output: 5.0 },
+  [AnthropicModels.Opus4_5Short]:   { input: 5.0, cache_write: 6.25, cache_hit: 0.5, output: 25.0 },
   // Deprecated — pricing retained for cost tracking
   [AnthropicModels.Opus4]:     { input: 15.0, cache_write: 18.75,  cache_hit: 1.5,  output: 75.0,  deprecated: true, deprecationDate: "2026-06-15" },
   [AnthropicModels.Sonnet4]:   { input: 3.0,  input_gt_200k: 6.0,  cache_write: 3.75, cache_hit: 0.3, output: 15.0, output_gt_200k: 22.5, deprecated: true, deprecationDate: "2026-06-15" },

package/src/clients/pricing/fireworks.ts

@@ -40,3 +40,15 @@ export const FireworksTextPricing: Record<string, ModelPricing> = {
   // OpenAI OSS
   "accounts/fireworks/models/gpt-oss-120b": { input: 0.15, cache_hit: 0.01, output: 0.60 },
 };
+
+/**
+ * Fireworks AI embedding/reranker model pricing (USD per 1M tokens)
+ * Source: https://fireworks.ai/pricing
+ */
+export const FireworksEmbeddingPricing: Record<string, ModelPricing> = {
+  // Qwen3 Embedding 8B — $0.10/M tokens, context 40k
+  "accounts/fireworks/models/qwen3-embedding-8b": { input: 0.10, output: 0.10 },
+
+  // Qwen3 Reranker 8B — $0.20/M tokens, context 40k
+  "accounts/fireworks/models/qwen3-reranker-8b": { input: 0.20, output: 0.20 },
+};

package/src/commands/agent.ts

@@ -1,14 +1,31 @@
 import { Command } from "commander";
 import { readPromptFile } from "../ai";
+import { BehaviorsService } from "../services/BehaviorsService";
 import { AgentModule } from "../chat/modules/AgentModule";
-import { BehaviorsService, Behavior } from "../services/BehaviorsService";
 import { AskModule } from "../chat/modules/AskModule";
 import { SearchModule } from "../chat/modules/SearchModule";
 import { SessionsModule } from "../chat/modules/SessionsModule";
 import { SetupModule } from "../chat/modules/SetupModule";
+import { PlainRenderer } from "../chat/renderer/PlainRenderer";
 import { loadRenderer } from "../chat/renderer/loadRenderer";
 import { getConfig } from "../config";
 
+async function setupRenderer(chatService: any, rendererSpecifier: string): Promise<void> {
+  const resolved =
+    rendererSpecifier === "basic" && !process.stdout.isTTY ? "plain" : rendererSpecifier;
+  try {
+    const renderer = await loadRenderer(resolved);
+    chatService.setContext({ renderer });
+  } catch (err: any) {
+    console.warn(`⚠ Could not load renderer "${resolved}": ${err.message}`);
+    console.warn("  Falling back to basic renderer.");
+    try {
+      const fallback = !process.stdout.isTTY ? new PlainRenderer() : await loadRenderer("basic");
+      chatService.setContext({ renderer: fallback });
+    } catch (_) {}
+  }
+}
+
 async function readStdin(): Promise<string> {
   return new Promise((resolve) => {
     let data = "";
@@ -28,24 +45,6 @@ async function readStdin(): Promise<string> {
   });
 }
 
-/**
- * Set up the renderer on the chat service context.
- * Priority: CLI --renderer flag > config.chat.renderer > "basic" (ConsoleRenderer)
- */
-async function setupRenderer(chatService: any, rendererSpecifier: string): Promise<void> {
-  try {
-    const renderer = await loadRenderer(rendererSpecifier);
-    chatService.setContext({ renderer });
-  } catch (err: any) {
-    console.warn(`⚠ Could not load renderer "${rendererSpecifier}": ${err.message}`);
-    console.warn("  Falling back to basic renderer.");
-    try {
-      const fallback = await loadRenderer("basic");
-      chatService.setContext({ renderer: fallback });
-    } catch (_) {}
-  }
-}
-
 export function addAgentCommand(program: Command, getChatService: () => any): void {
   program
     .command("agent")
@@ -68,6 +67,14 @@ export function addAgentCommand(program: Command, getChatService: () => any): vo
     )
     .option("--message-id <messageId>", "Knowhow message ID for task tracking")
     .option("--sync-fs", "Enable filesystem-based synchronization")
+    .option(
+      "--behavior-id <id>",
+      "Force a specific behavior by its ID (skips trigger matching)"
+    )
+    .option(
+      "--behavior-file <path>",
+      "Force a specific behavior by its file path (skips trigger matching)"
+    )
     .option(
       "--task-id <taskId>",
       "Pre-generated task ID (used with --sync-fs for predictable agent directory path)"
@@ -93,6 +100,7 @@ export function addAgentCommand(program: Command, getChatService: () => any): vo
         try { config = await getConfig(); } catch (_) {}
         const rendererSpecifier = options.renderer ?? config.chat?.renderer ?? "basic";
         await setupRenderer(chatService, rendererSpecifier);
+
         const agentModule = new AgentModule();
 
         if (options.resume) {
@@ -137,7 +145,32 @@ export function addAgentCommand(program: Command, getChatService: () => any): vo
         let behaviorSystemPrompt: string | undefined;
         let behaviorModel: string | undefined;
         const behaviorsSvc = new BehaviorsService();
-        const matchedBehavior = behaviorsSvc.matchBehaviorLocal(input);
+
+        let matchedBehavior = null;
+
+        if (options.behaviorFile) {
+          // Load behavior directly from a file path
+          matchedBehavior = behaviorsSvc.loadBehaviorFromFile(options.behaviorFile);
+          if (matchedBehavior) {
+            console.log(`🎯 Using behavior from file: ${options.behaviorFile}`);
+          } else {
+            console.error(`❌ Could not load behavior from file: ${options.behaviorFile}`);
+            process.exit(1);
+          }
+        } else if (options.behaviorId) {
+          // Load behavior by ID (searches local disk behaviors)
+          matchedBehavior = behaviorsSvc.findBehaviorById(options.behaviorId);
+          if (matchedBehavior) {
+            console.log(`🎯 Using behavior by ID: ${options.behaviorId} (${matchedBehavior.name})`);
+          } else {
+            console.error(`❌ No behavior found with ID: ${options.behaviorId}`);
+            process.exit(1);
+          }
+        } else {
+          // Default: match by trigger text
+          matchedBehavior = behaviorsSvc.matchBehaviorLocal(input);
+        }
+
         if (matchedBehavior) {
           console.log(`🎯 Matched behavior: ${matchedBehavior.name}`);
           if (matchedBehavior.instructions) {