@tyvm/knowhow 0.0.159 → 0.0.161

package/tests/manual/modalities/xai.modalities.test.ts

@@ -1,294 +0,0 @@
-/**
- * XAI (Grok) Modalities Manual Test
- *
- * Tests:
- *  1. Image generation (grok-imagine-image) → saved to disk
- *  2. Vision – send generated image to Grok vision model and describe it
- *  3. Audio generation – not supported by XAI (documented)
- *  4. Audio transcription – not supported by XAI (documented)
- *  5. Video generation (grok-imagine-video) → polls until done, saves URL to disk
- *
- * Run with:
- *   npx jest tests/manual/modalities/xai.modalities.test.ts --testTimeout=720000
- */
-
-import * as fs from "fs";
-import * as path from "path";
-import { AIClient } from "../../../src/clients";
-import { Models } from "../../../src/types";
-
-const OUTPUT_DIR = path.join(__dirname, "outputs", "xai");
-
-function ensureOutputDir() {
-  fs.mkdirSync(OUTPUT_DIR, { recursive: true });
-}
-
-describe("XAI (Grok) Modalities", () => {
-  let client: AIClient;
-
-  beforeAll(() => {
-    if (!process.env.XAI_API_KEY) {
-      console.warn("XAI_API_KEY not set – skipping XAI modality tests");
-    }
-    ensureOutputDir();
-    client = new AIClient();
-  });
-
-  // ─── 1. Image Generation (grok-imagine-image) ────────────────────────────────
-
-  test("1. XAI grok-imagine-image – generate image and save to disk", async () => {
-    if (!process.env.XAI_API_KEY) {
-      console.log("Skipping: XAI_API_KEY not set");
-      return;
-    }
-
-    const prompt =
-      "A breathtaking aerial view of a neon-lit futuristic city at night, " +
-      "flying cars, holographic billboards, cyberpunk aesthetic";
-
-    const response = await client.createImageGeneration("xai", {
-      model: "grok-imagine-image",
-      prompt,
-      n: 1,
-      response_format: "b64_json",
-    });
-
-    expect(response.data.length).toBeGreaterThan(0);
-
-    const imageData = response.data[0];
-    const outputPath = path.join(OUTPUT_DIR, "aurora-output.png");
-
-    if (imageData.b64_json) {
-      const buffer = Buffer.from(imageData.b64_json, "base64");
-      fs.writeFileSync(outputPath, buffer);
-      console.log(`✅ Image saved to: ${outputPath}`);
-      console.log(`   Size: ${buffer.length} bytes`);
-    } else if (imageData.url) {
-      fs.writeFileSync(
-        path.join(OUTPUT_DIR, "aurora-output-url.txt"),
-        imageData.url
-      );
-      console.log(`✅ Image URL saved: ${imageData.url}`);
-    }
-
-    console.log(`   Estimated cost: $${response.usd_cost?.toFixed(6)}`);
-
-    expect(response.created).toBeGreaterThan(0);
-    expect(response.data.length).toBeGreaterThan(0);
-  }, 90000);
-
-  // ─── 2. Vision – send generated image to Grok Vision ────────────────────────
-
-  test("2. XAI Grok Vision – describe the generated image", async () => {
-    if (!process.env.XAI_API_KEY) {
-      console.log("Skipping: XAI_API_KEY not set");
-      return;
-    }
-
-    const imagePath = path.join(OUTPUT_DIR, "aurora-output.png");
-    if (!fs.existsSync(imagePath)) {
-      console.log(
-        "Skipping: aurora-output.png not found – run image generation test first"
-      );
-      return;
-    }
-
-    const imageBuffer = fs.readFileSync(imagePath);
-    const base64Image = imageBuffer.toString("base64");
-    const dataUrl = `data:image/png;base64,${base64Image}`;
-
-    const response = await client.createCompletion("xai", {
-      model: Models.xai.Grok_4_20_NonReasoning,
-      messages: [
-        {
-          role: "user",
-          content: [
-            {
-              type: "text",
-              text: "Please describe this image in detail. What do you see?",
-            },
-            {
-              type: "image_url",
-              image_url: { url: dataUrl },
-            },
-          ],
-        },
-      ],
-      max_tokens: 500,
-    });
-
-    const description = response.choices[0]?.message?.content || "";
-    const outputPath = path.join(OUTPUT_DIR, "vision-description.txt");
-    fs.writeFileSync(outputPath, description);
-
-    console.log(`✅ Vision description saved to: ${outputPath}`);
-    console.log(`   Description: ${description.substring(0, 200)}...`);
-    console.log(`   Estimated cost: $${response.usd_cost?.toFixed(6)}`);
-
-    expect(description).toBeTruthy();
-    expect(description.length).toBeGreaterThan(10);
-  }, 60000);
-
-  // ─── 3. Audio Generation – not supported ─────────────────────────────────────
-
-  test("3. XAI Audio Generation – not supported (expected error)", async () => {
-    if (!process.env.XAI_API_KEY) {
-      console.log("Skipping: XAI_API_KEY not set");
-      return;
-    }
-
-    /**
-     * XAI does not support audio generation. The client throws an error.
-     * This test verifies that the error is thrown correctly and documents
-     * the limitation.
-     */
-    await expect(
-      client.createAudioGeneration("xai", {
-        model: "xai-tts",
-        input: "Hello world",
-        voice: "default",
-      })
-    ).rejects.toThrow();
-
-    console.log(
-      "✅ XAI correctly throws an error for unsupported audio generation"
-    );
-  }, 15000);
-
-  // ─── 4. Audio Transcription – not supported ───────────────────────────────────
-
-  test("4. XAI Audio Transcription – not supported (expected error)", async () => {
-    if (!process.env.XAI_API_KEY) {
-      console.log("Skipping: XAI_API_KEY not set");
-      return;
-    }
-
-    /**
-     * XAI does not support audio transcription. This test verifies the error.
-     */
-    const fakeStream = { name: "test.mp3" } as any;
-
-    await expect(
-      client.createAudioTranscription("xai", {
-        file: fakeStream,
-        model: "whisper",
-      })
-    ).rejects.toThrow();
-
-    console.log(
-      "✅ XAI correctly throws an error for unsupported audio transcription"
-    );
-  }, 15000);
-
-  // ─── 5. Video Generation (grok-imagine-video) ────────────────────────────────
-
-  test(
-    "5. XAI grok-imagine-video – generate video and save URL to disk",
-    async () => {
-      if (!process.env.XAI_API_KEY) {
-        console.log("Skipping: XAI_API_KEY not set");
-        return;
-      }
-
-      const outputPath = path.join(OUTPUT_DIR, "video-output.txt");
-      const jobIdPath = path.join(OUTPUT_DIR, "video-job-id.txt");
-
-      // If final output already exists, skip entirely
-      if (fs.existsSync(outputPath)) {
-        console.log(`⏭️  Skipping: output already exists at ${outputPath}`);
-        return;
-      }
-
-      const prompt =
-        "A cyberpunk cityscape at night with flying cars and neon lights, " +
-        "cinematic camera slowly panning upward to reveal the skyline";
-
-      // Helper: poll a known job ID via client until done, then save results
-      async function pollAndSave(jobId: string) {
-        const maxPollingTime = 20 * 60 * 1000; // 20 minutes
-        const pollingInterval = 5000; // 5 seconds
-        const startTime = Date.now();
-
-        console.log(`⏳ Polling job ID: ${jobId}`);
-
-        while (Date.now() - startTime < maxPollingTime) {
-          await new Promise((resolve) => setTimeout(resolve, pollingInterval));
-
-          const status = await client.getVideoStatus("xai", { jobId });
-          console.log(
-            `   Status: ${status.status}, has data: ${!!status.data?.length}`
-          );
-
-          if (status.status === "failed") {
-            throw new Error(
-              `XAI video generation failed: ${status.error || "unknown error"}`
-            );
-          }
-
-          if (status.status === "expired") {
-            throw new Error("XAI video generation request expired");
-          }
-
-          if (status.status === "completed" && status.data?.[0]?.url) {
-            const videoUrl = status.data[0].url;
-            const outputContent = [
-              `Generated at: ${new Date().toISOString()}`,
-              `Prompt: ${prompt}`,
-              `Job ID: ${jobId}`,
-              `Video URL: ${videoUrl}`,
-            ].join("\n");
-            fs.writeFileSync(outputPath, outputContent);
-            console.log(`✅ Video URL saved to: ${outputPath}`);
-            console.log(`   Video URL: ${videoUrl}`);
-
-            // Clean up job ID file
-            if (fs.existsSync(jobIdPath)) fs.unlinkSync(jobIdPath);
-            return;
-          }
-          // queued / in_progress – keep polling
-        }
-
-        throw new Error(
-          "XAI video generation timed out after 20 minutes of polling"
-        );
-      }
-
-      // If we already have a job ID from a previous (timed-out) run, resume
-      if (fs.existsSync(jobIdPath)) {
-        const jobId = fs.readFileSync(jobIdPath, "utf8").trim();
-        console.log(`🔄 Resuming poll for existing job ID: ${jobId}`);
-        await pollAndSave(jobId);
-        expect(fs.existsSync(outputPath)).toBe(true);
-        return;
-      }
-
-      // Otherwise start a new job via the client
-      console.log("⏳ Submitting XAI video generation job...");
-
-      const response = await client.createVideoGeneration("xai", {
-        model: "grok-imagine-video",
-        prompt,
-        duration: 5,
-        aspect_ratio: "16:9",
-      });
-
-      const jobId = response.jobId;
-      if (!jobId) {
-        throw new Error(
-          `No jobId returned from video generation: ${JSON.stringify(response)}`
-        );
-      }
-
-      // Persist the job ID so subsequent runs can resume if this run times out
-      fs.writeFileSync(jobIdPath, jobId);
-      console.log(`📝 Job ID saved to: ${jobIdPath} (ID: ${jobId})`);
-      console.log(`   Estimated cost: $${response.usd_cost?.toFixed(6)}`);
-
-      await pollAndSave(jobId);
-
-      expect(fs.existsSync(outputPath)).toBe(true);
-    },
-    // 25 minute timeout
-    1500000
-  );
-});

package/tests/manual/test-concurrent-ask.ts

@@ -1,43 +0,0 @@
-/**
- * Manual test to verify that concurrent ask() calls don't duplicate input
- * 
- * To run this test:
- * npx ts-node tests/manual/test-concurrent-ask.ts
- * 
- * Expected behavior:
- * 1. You should see "Question 2: What is your age?" displayed
- * 2. As you type, each character should appear only once (not doubled)
- * 3. When you press Enter, both promises resolve with the same answer
- * 4. The output shows both questions got the same response
- */
-
-import { ask } from "../../src/utils";
-
-async function testConcurrentAsks() {
-  console.log("Testing concurrent ask() calls...\n");
-  console.log("This test asks two questions before you can answer.");
-  console.log("You should only see the second question and typing should not duplicate.\n");
-  
-  // Start two asks without awaiting - simulates the collision scenario
-  const promise1 = ask("Question 1: What is your name? ");
-  
-  // Simulate a small delay like an agent would have
-  await new Promise(resolve => setTimeout(resolve, 100));
-  
-  const promise2 = ask("Question 2: What is your age? ");
-  
-  // Now wait for both to resolve
-  const [answer1, answer2] = await Promise.all([promise1, promise2]);
-  
-  console.log("\nResults:");
-  console.log("Answer to question 1:", answer1);
-  console.log("Answer to question 2:", answer2);
-  console.log("\nBoth questions should have received the same answer.");
-  
-  process.exit(0);
-}
-
-testConcurrentAsks().catch(error => {
-  console.error("Error:", error);
-  process.exit(1);
-});

package/tests/manual/ycmd/debug_diagnostics_test.ts

@@ -1,127 +0,0 @@
-import { ycmdStart, ycmdDiagnostics } from "../../../src/agents/tools/ycmd";
-import * as fs from "fs";
-import * as path from "path";
-import { execSync } from "child_process";
-
-async function testDiagnostics() {
-  console.log("🔧 Starting ycmd server...");
-
-  try {
-    // Start ycmd server
-    const startResult = await ycmdStart({
-      workspaceRoot: process.cwd(),
-      logLevel: "debug",
-    });
-    console.log("✅ ycmd server started:", startResult);
-
-    // Wait for server to fully initialize
-    console.log("⏳ Waiting for server initialization...");
-    await new Promise((resolve) => setTimeout(resolve, 3000));
-
-    const testFile = path.join(
-      process.cwd(),
-      "tests/ycmd/fixtures/debug_diagnostics.ts"
-    );
-
-    // Ensure the test file exists
-    if (!fs.existsSync(testFile)) {
-      console.log("❌ Test file does not exist:", testFile);
-      return;
-    }
-
-    console.log("📁 Test file path:", testFile);
-    console.log("📄 Test file contents:");
-    console.log(fs.readFileSync(testFile, "utf8"));
-
-    // Test diagnostics multiple times with increasing delays
-    const delays = [1000, 3000, 5000, 10000];
-
-    for (const delay of delays) {
-      console.log(`\n🔍 Testing diagnostics after ${delay}ms delay...`);
-      await new Promise((resolve) => setTimeout(resolve, delay));
-
-      try {
-        const diagnostics = await ycmdDiagnostics({
-          filepath: testFile,
-          line: 1,
-          column: 1,
-        });
-
-        console.log(
-          "📊 Diagnostics result:",
-          JSON.stringify(diagnostics, null, 2)
-        );
-
-        if (
-          diagnostics &&
-          typeof diagnostics === "object" &&
-          "content" in diagnostics
-        ) {
-          const content = diagnostics.content;
-          if (Array.isArray(content) && content.length > 0) {
-            console.log(`✅ Found ${content.length} diagnostic(s)!`);
-            content.forEach((diag, index) => {
-              console.log(
-                `  ${index + 1}. ${
-                  diag.text || diag.message || JSON.stringify(diag)
-                }`
-              );
-            });
-            break; // Found diagnostics, stop testing
-          }
-        }
-      } catch (error) {
-        console.log("❌ Diagnostics error:", error.message);
-      }
-    }
-
-    // Try diagnostics on a specific error line
-    console.log(
-      "\n🎯 Testing diagnostics on specific error line (line 9 - missing property)..."
-    );
-    try {
-      const specificDiagnostics = await ycmdDiagnostics({
-        filepath: testFile,
-        line: 9,
-        column: 12,
-      });
-      console.log(
-        "📊 Specific line diagnostics:",
-        JSON.stringify(specificDiagnostics, null, 2)
-      );
-    } catch (error) {
-      console.log("❌ Specific diagnostics error:", error.message);
-    }
-
-    // Check if TypeScript is properly configured
-    console.log("\n🔧 Checking TypeScript configuration...");
-    const tsconfigPath = path.join(process.cwd(), "tsconfig.json");
-    if (fs.existsSync(tsconfigPath)) {
-      console.log("✅ tsconfig.json found");
-      const tsconfig = JSON.parse(fs.readFileSync(tsconfigPath, "utf8"));
-      console.log(
-        "📋 Compiler options:",
-        JSON.stringify(tsconfig.compilerOptions, null, 2)
-      );
-    } else {
-      console.log("⚠️ No tsconfig.json found");
-    }
-
-    // Try running TypeScript compiler directly to see if it detects errors
-    console.log("\n🔍 Running TypeScript compiler directly...");
-    try {
-      execSync(`npx tsc --noEmit ${testFile}`, { stdio: "pipe" });
-      console.log("✅ TypeScript compiler found no errors");
-    } catch (error) {
-      console.log("❌ TypeScript compiler errors:");
-      console.log(
-        error.stdout?.toString() || error.stderr?.toString() || error.message
-      );
-    }
-  } catch (error) {
-    console.error("❌ Test failed:", error.message);
-    console.error("Stack trace:", error.stack);
-  }
-}
-
-testDiagnostics().catch(console.error);

package/tests/manual/ycmd/fixtures/debug_diagnostics.ts

@@ -1,26 +0,0 @@
-// TypeScript file with clear errors to test diagnostics
-interface User {
-    name: string;
-    age: number;
-    email?: string;
-}
-
-function createUser(name: string, age: number): User {
-    // This should trigger a type error - missing 'age' property
-    return { name }; 
-}
-
-// This should trigger an error - React is not imported
-const component = React.createElement('div');
-
-// This should trigger an error - missing 'age' property  
-const user: User = { name: 'Alice' };
-
-// This should trigger an error - undefined variable
-console.log(undefinedVariable);
-
-// This should trigger an error - calling method on possibly undefined
-const maybeString: string | undefined = undefined;
-maybeString.toUpperCase();
-
-export { createUser };

package/tests/manual/ycmd/fixtures/file_change_test.ts

@@ -1,17 +0,0 @@
-interface User {
-    name: string;
-    age: number;
-}
-
-function createUser(name: string, age: number): User {
-    // ERROR: Missing 'age' property - should cause TypeScript error
-    return { name };
-}
-
-// ERROR: Using undefined variable - should cause TypeScript error
-console.log(undefinedVariable);
-
-// ERROR: Type mismatch - missing required property - should cause TypeScript error
-const user: User = { name: 'Alice' };
-
-export { createUser };

package/tests/manual/ycmd/minimal_advanced_test.ts

@@ -1,108 +0,0 @@
-#!/usr/bin/env npx tsx
-
-/**
- * Minimal test of ycmd advanced features
- */
-
-import {
-  ycmdStart,
-  ycmdDiagnostics,
-  ycmdCompletion,
-  ycmdRefactor,
-} from "../../../src/agents/tools/ycmd";
-import * as fs from "fs";
-import * as path from "path";
-
-async function minimalAdvancedTest() {
-  console.log("🧪 Minimal ycmd Advanced Features Test\n");
-
-  // Create a test file with TypeScript code
-  const testFile = path.join(process.cwd(), "minimal_test.ts");
-  const testContent = `function hello(name: string): string {
-    return "Hello " + name;
-}
-
-const result = hello("World");
-console.log(result);
-`;
-
-  fs.writeFileSync(testFile, testContent);
-  console.log("✅ Created minimal test file");
-
-  try {
-    // Start ycmd with shorter timeout expectation
-    console.log("🚀 Starting ycmd (this may take a moment)...");
-    const startResult = await ycmdStart({});
-    console.log(
-      "✅ ycmd start result:",
-      startResult.success ? "SUCCESS" : "FAILED"
-    );
-
-    if (!startResult.success) {
-      console.log("❌ ycmd failed to start:", startResult.message);
-      return;
-    }
-
-    // Test 1: Basic diagnostics
-    console.log("\n🔍 Test 1: Basic diagnostics...");
-    const diagnosticsResult = await ycmdDiagnostics({
-      filepath: testFile,
-      fileContents: testContent,
-    });
-
-    console.log("Diagnostics result:", {
-      success: diagnosticsResult.success,
-      diagnosticCount: diagnosticsResult.diagnostics?.length || 0,
-      message: diagnosticsResult.message,
-    });
-
-    // Test 2: Basic completions
-    console.log("\n⚡ Test 2: Basic completions...");
-    const completionsResult = await ycmdCompletion({
-      filepath: testFile,
-      line: 2,
-      column: 15,
-      contents: testContent,
-    });
-
-    console.log("Completions result:", {
-      success: completionsResult.success,
-      completionCount: completionsResult.completions?.length || 0,
-      message: completionsResult.message,
-    });
-
-    // Test 3: Organize imports (even if no imports present)
-    console.log("\n📦 Test 3: Organize imports...");
-    const organizeResult = await ycmdRefactor({
-      filepath: testFile,
-      line: 1,
-      column: 1,
-      command: "organize_imports",
-      contents: testContent,
-    });
-
-    console.log("Organize imports result:", {
-      success: organizeResult.success,
-      message: organizeResult.message,
-      hasEdits: organizeResult.result?.edits
-        ? organizeResult.result.edits.length > 0
-        : false,
-    });
-
-    console.log("\n🎉 Minimal test completed successfully");
-  } catch (error: any) {
-    console.error("❌ Test failed:", error.message);
-  } finally {
-    // Cleanup
-    try {
-      fs.unlinkSync(testFile);
-      console.log("🧹 Cleaned up test file");
-    } catch (e) {
-      // Silent cleanup failure
-    }
-  }
-}
-
-if (require.main === module) {
-  minimalAdvancedTest().catch(console.error);
-}

package/tests/manual/ycmd/simple_diagnostics_test.ts

@@ -1,61 +0,0 @@
-import { ycmdStart, ycmdDiagnostics } from '../../../src/agents/tools/ycmd';
-import * as fs from 'fs';
-import * as path from 'path';
-
-async function testDiagnostics() {
-    console.log('🔧 Testing ycmd diagnostics...');
-    
-    try {
-        // Start ycmd server
-        console.log('Starting ycmd server...');
-        const startResult = await ycmdStart({
-            workspaceRoot: process.cwd(),
-            logLevel: 'debug'
-        });
-        console.log('✅ ycmd server started:', startResult);
-
-        // Wait for server to initialize
-        console.log('⏳ Waiting 5 seconds for server initialization...');
-        await new Promise(resolve => setTimeout(resolve, 5000));
-
-        const testFile = path.join(process.cwd(), 'tests/ycmd/fixtures/debug_diagnostics.ts');
-        
-        console.log('📁 Test file path:', testFile);
-        
-        // Test diagnostics
-        console.log('🔍 Testing diagnostics...');
-        const diagnostics = await ycmdDiagnostics({
-            filepath: testFile,
-            line: 1,
-            column: 1
-        });
-        
-        console.log('📊 Diagnostics result:');
-        console.log(JSON.stringify(diagnostics, null, 2));
-        
-        // Check if we got meaningful results
-        if (diagnostics && typeof diagnostics === 'object' && 'content' in diagnostics) {
-            const content = diagnostics.content;
-            if (Array.isArray(content) && content.length > 0) {
-                console.log(`✅ SUCCESS: Found ${content.length} diagnostic(s)!`);
-                content.forEach((diag, index) => {
-                    console.log(`  ${index + 1}. ${diag.text || diag.message || JSON.stringify(diag)}`);
-                });
-            } else {
-                console.log('⚠️ No diagnostics found in content array');
-            }
-        } else {
-            console.log('⚠️ Unexpected diagnostics response format');
-        }
-
-        console.log('✅ Test completed successfully');
-        process.exit(0);
-
-    } catch (error) {
-        console.error('❌ Test failed:', error.message);
-        console.error('Stack trace:', error.stack);
-        process.exit(1);
-    }
-}
-
-testDiagnostics();