@kernel.chat/kbot 3.2.0 → 3.2.1

package/dist/tools/git.test.js

@@ -0,0 +1,303 @@
+// kbot Git Tools Tests
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { execSync } from 'node:child_process';
+import { executeTool, getTool } from './index.js';
+import { registerGitTools } from './git.js';
+// Register once
+registerGitTools();
+// Temp git repo for tests
+const TEST_DIR = join(tmpdir(), 'kbot-git-test-' + Date.now());
+/** Run a command in the test repo */
+function run(cmd) {
+    return execSync(cmd, { cwd: TEST_DIR, encoding: 'utf-8' }).trim();
+}
+beforeAll(() => {
+    mkdirSync(TEST_DIR, { recursive: true });
+    // Initialize a git repo with an initial commit
+    run('git init');
+    run('git config user.email "test@kbot.dev"');
+    run('git config user.name "KBot Test"');
+    writeFileSync(join(TEST_DIR, 'README.md'), '# Test Repo');
+    run('git add .');
+    run('git commit -m "initial commit"');
+    // Override cwd so git tools operate on our test repo
+    process.chdir(TEST_DIR);
+});
+afterAll(() => {
+    try {
+        rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+    catch { }
+});
+// ─────────────────────────────────────────────────────────────────────
+// 1. Registration
+// ─────────────────────────────────────────────────────────────────────
+describe('Git Tools Registration', () => {
+    it('registers git_status', () => {
+        const tool = getTool('git_status');
+        expect(tool).toBeTruthy();
+        expect(tool.tier).toBe('free');
+    });
+    it('registers git_diff', () => {
+        const tool = getTool('git_diff');
+        expect(tool).toBeTruthy();
+        expect(tool.parameters.staged).toBeTruthy();
+    });
+    it('registers git_log', () => {
+        const tool = getTool('git_log');
+        expect(tool).toBeTruthy();
+    });
+    it('registers git_commit', () => {
+        const tool = getTool('git_commit');
+        expect(tool).toBeTruthy();
+        expect(tool.parameters.message.required).toBe(true);
+    });
+    it('registers git_branch', () => {
+        const tool = getTool('git_branch');
+        expect(tool).toBeTruthy();
+        expect(tool.parameters.name.required).toBe(true);
+    });
+    it('registers git_push', () => {
+        const tool = getTool('git_push');
+        expect(tool).toBeTruthy();
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 2. git_status
+// ─────────────────────────────────────────────────────────────────────
+describe('git_status', () => {
+    it('returns empty on clean repo', async () => {
+        const result = await executeTool({
+            id: 'gs-1',
+            name: 'git_status',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        // Clean repo should return empty or whitespace
+        expect(result.result.trim()).toBe('');
+    });
+    it('shows modified files', async () => {
+        writeFileSync(join(TEST_DIR, 'README.md'), '# Modified');
+        const result = await executeTool({
+            id: 'gs-2',
+            name: 'git_status',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('README.md');
+        expect(result.result).toMatch(/M\s/);
+        // Restore
+        run('git checkout -- README.md');
+    });
+    it('shows untracked files', async () => {
+        writeFileSync(join(TEST_DIR, 'newfile.txt'), 'new');
+        const result = await executeTool({
+            id: 'gs-3',
+            name: 'git_status',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('newfile.txt');
+        expect(result.result).toContain('??');
+        // Cleanup
+        run('rm newfile.txt');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 3. git_diff
+// ─────────────────────────────────────────────────────────────────────
+describe('git_diff', () => {
+    it('returns "No changes" on clean repo', async () => {
+        const result = await executeTool({
+            id: 'gd-1',
+            name: 'git_diff',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toBe('No changes');
+    });
+    it('shows unstaged changes', async () => {
+        writeFileSync(join(TEST_DIR, 'README.md'), '# Changed Content');
+        const result = await executeTool({
+            id: 'gd-2',
+            name: 'git_diff',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Changed Content');
+        expect(result.result).toContain('diff --git');
+        // Restore
+        run('git checkout -- README.md');
+    });
+    it('shows staged changes with staged flag', async () => {
+        writeFileSync(join(TEST_DIR, 'README.md'), '# Staged Change');
+        run('git add README.md');
+        const result = await executeTool({
+            id: 'gd-3',
+            name: 'git_diff',
+            arguments: { staged: true },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Staged Change');
+        // Unstage and restore
+        run('git reset HEAD README.md');
+        run('git checkout -- README.md');
+    });
+    it('limits diff to a specific path', async () => {
+        writeFileSync(join(TEST_DIR, 'README.md'), '# Path Diff');
+        writeFileSync(join(TEST_DIR, 'other.txt'), 'other change');
+        run('git add other.txt');
+        const result = await executeTool({
+            id: 'gd-4',
+            name: 'git_diff',
+            arguments: { path: 'README.md' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Path Diff');
+        expect(result.result).not.toContain('other change');
+        // Restore
+        run('git checkout -- README.md');
+        run('git reset HEAD other.txt');
+        run('rm -f other.txt');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 4. git_log
+// ─────────────────────────────────────────────────────────────────────
+describe('git_log', () => {
+    it('shows commit history', async () => {
+        const result = await executeTool({
+            id: 'gl-1',
+            name: 'git_log',
+            arguments: {},
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('initial commit');
+    });
+    it('respects count parameter', async () => {
+        // Add a second commit
+        writeFileSync(join(TEST_DIR, 'log-test.txt'), 'log test');
+        run('git add log-test.txt');
+        run('git commit -m "second commit"');
+        const result = await executeTool({
+            id: 'gl-2',
+            name: 'git_log',
+            arguments: { count: 1 },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('second commit');
+        // With count=1, should not show initial commit (oneline format = 1 line)
+        expect(result.result.split('\n').length).toBe(1);
+    });
+    it('uses oneline format by default', async () => {
+        const result = await executeTool({
+            id: 'gl-3',
+            name: 'git_log',
+            arguments: { count: 2 },
+        });
+        expect(result.error).toBeUndefined();
+        // Oneline format: hash + message per line
+        const lines = result.result.trim().split('\n');
+        expect(lines.length).toBe(2);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 5. git_commit
+// ─────────────────────────────────────────────────────────────────────
+describe('git_commit', () => {
+    it('commits staged files with a message', async () => {
+        writeFileSync(join(TEST_DIR, 'commit-test.txt'), 'commit me');
+        run('git add commit-test.txt');
+        const result = await executeTool({
+            id: 'gc-1',
+            name: 'git_commit',
+            arguments: { message: 'test commit via tool' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('test commit via tool');
+        // Verify it's in the log
+        const log = run('git log --oneline -1');
+        expect(log).toContain('test commit via tool');
+    });
+    it('stages and commits specified files', async () => {
+        writeFileSync(join(TEST_DIR, 'auto-stage.txt'), 'auto staged');
+        const result = await executeTool({
+            id: 'gc-2',
+            name: 'git_commit',
+            arguments: { message: 'auto-stage commit', files: ['auto-stage.txt'] },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('auto-stage commit');
+    });
+    it('handles commit with nothing staged', async () => {
+        const result = await executeTool({
+            id: 'gc-3',
+            name: 'git_commit',
+            arguments: { message: 'empty commit attempt' },
+        });
+        // git commit with nothing staged should error
+        expect(result.error).toBe(true);
+        expect(result.result).toBeTruthy();
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 6. git_branch
+// ─────────────────────────────────────────────────────────────────────
+describe('git_branch', () => {
+    it('creates a new branch', async () => {
+        const result = await executeTool({
+            id: 'gb-1',
+            name: 'git_branch',
+            arguments: { name: 'test-branch-create', create: true },
+        });
+        expect(result.error).toBeUndefined();
+        // git checkout -b outputs to stderr — stdout may be empty, which is fine
+        // Verify the branch was created by checking git branch list
+        const branches = run('git branch');
+        expect(branches).toContain('test-branch-create');
+        // Switch back
+        run('git checkout master 2>/dev/null || git checkout main 2>/dev/null');
+    });
+    it('switches to an existing branch', async () => {
+        // First ensure the branch exists
+        run('git branch test-branch-switch 2>/dev/null || true');
+        const result = await executeTool({
+            id: 'gb-2',
+            name: 'git_branch',
+            arguments: { name: 'test-branch-switch' },
+        });
+        expect(result.error).toBeUndefined();
+        // Verify we're on the branch
+        const current = run('git rev-parse --abbrev-ref HEAD');
+        expect(current).toBe('test-branch-switch');
+        // Switch back
+        run('git checkout master 2>/dev/null || git checkout main 2>/dev/null');
+    });
+    it('returns error for nonexistent branch', async () => {
+        const result = await executeTool({
+            id: 'gb-3',
+            name: 'git_branch',
+            arguments: { name: 'nonexistent-branch-xyz' },
+        });
+        expect(result.error).toBe(true);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 7. git_push (should fail — no remote configured)
+// ─────────────────────────────────────────────────────────────────────
+describe('git_push', () => {
+    it('returns error when no remote is configured', async () => {
+        const result = await executeTool({
+            id: 'gp-1',
+            name: 'git_push',
+            arguments: {},
+        });
+        expect(result.error).toBe(true);
+        // No remote configured, so it should fail
+        expect(result.result).toBeTruthy();
+    });
+});
+//# sourceMappingURL=git.test.js.map

package/dist/tools/git.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.test.js","sourceRoot":"","sources":["../../src/tools/git.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search.test.d.ts.map

package/dist/tools/search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.test.d.ts","sourceRoot":"","sources":["../../src/tools/search.test.ts"],"names":[],"mappings":""}

package/dist/tools/search.test.js

@@ -0,0 +1,311 @@
+// kbot Search Tools Tests — Mocked (no real network calls)
+import { describe, it, expect, vi, beforeAll, afterAll } from 'vitest';
+import { executeTool, getTool } from './index.js';
+import { registerSearchTools } from './search.js';
+// Register once
+registerSearchTools();
+// ─────────────────────────────────────────────────────────────────────
+// Mock global fetch to avoid real network calls
+// ─────────────────────────────────────────────────────────────────────
+const originalFetch = globalThis.fetch;
+beforeAll(() => {
+    globalThis.fetch = vi.fn();
+});
+afterAll(() => {
+    globalThis.fetch = originalFetch;
+});
+function mockFetch(impl) {
+    ;
+    globalThis.fetch.mockImplementation(impl);
+}
+function mockFetchReset() {
+    ;
+    globalThis.fetch.mockReset();
+}
+// ─────────────────────────────────────────────────────────────────────
+// 1. Registration
+// ─────────────────────────────────────────────────────────────────────
+describe('Search Tools Registration', () => {
+    it('registers web_search', () => {
+        const tool = getTool('web_search');
+        expect(tool).toBeTruthy();
+        expect(tool.tier).toBe('free');
+        expect(tool.parameters.query.required).toBe(true);
+    });
+    it('registers research', () => {
+        const tool = getTool('research');
+        expect(tool).toBeTruthy();
+        expect(tool.tier).toBe('free');
+        expect(tool.parameters.topic.required).toBe(true);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 2. web_search — DuckDuckGo success
+// ─────────────────────────────────────────────────────────────────────
+describe('web_search', () => {
+    it('returns DuckDuckGo instant answer', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({
+                    AbstractText: 'TypeScript is a typed superset of JavaScript.',
+                    AbstractSource: 'Wikipedia',
+                    RelatedTopics: [],
+                }), { status: 200 });
+            }
+            // Wikipedia fallback
+            if (urlStr.includes('wikipedia.org')) {
+                return new Response(JSON.stringify({
+                    extract: 'TypeScript is a programming language developed by Microsoft.',
+                }), { status: 200 });
+            }
+            return new Response('', { status: 404 });
+        });
+        const result = await executeTool({
+            id: 'ws-1',
+            name: 'web_search',
+            arguments: { query: 'TypeScript' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('TypeScript');
+        expect(result.result).toContain('Wikipedia');
+    });
+    it('returns related topics from DuckDuckGo', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({
+                    AbstractText: '',
+                    RelatedTopics: [
+                        { Text: 'React is a JavaScript library' },
+                        { Text: 'Vue.js is a progressive framework' },
+                    ],
+                }), { status: 200 });
+            }
+            return new Response(JSON.stringify({}), { status: 200 });
+        });
+        const result = await executeTool({
+            id: 'ws-2',
+            name: 'web_search',
+            arguments: { query: 'frontend frameworks' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('React is a JavaScript library');
+        expect(result.result).toContain('Vue.js');
+    });
+    it('includes StackOverflow for programming queries', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({ AbstractText: '', RelatedTopics: [] }), { status: 200 });
+            }
+            if (urlStr.includes('wikipedia.org')) {
+                return new Response(JSON.stringify({}), { status: 200 });
+            }
+            if (urlStr.includes('stackexchange.com')) {
+                return new Response(JSON.stringify({
+                    items: [
+                        { title: 'How to install npm packages', excerpt: 'Use npm install to add packages to your project...' },
+                    ],
+                }), { status: 200 });
+            }
+            return new Response('', { status: 404 });
+        });
+        const result = await executeTool({
+            id: 'ws-3',
+            name: 'web_search',
+            arguments: { query: 'how to install npm packages' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Stack Overflow');
+        expect(result.result).toContain('npm');
+    });
+    it('returns fallback message when no results', async () => {
+        mockFetch(async () => {
+            return new Response(JSON.stringify({ AbstractText: '', RelatedTopics: [] }), { status: 200 });
+        });
+        const result = await executeTool({
+            id: 'ws-4',
+            name: 'web_search',
+            arguments: { query: 'xyznonexistentquery12345' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('No instant results');
+        expect(result.result).toContain('url_fetch');
+    });
+    it('handles fetch failures gracefully', async () => {
+        mockFetch(async () => {
+            throw new Error('Network error');
+        });
+        const result = await executeTool({
+            id: 'ws-5',
+            name: 'web_search',
+            arguments: { query: 'test query' },
+        });
+        // Should not throw — should return fallback
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('No instant results');
+    });
+    it('handles Wikipedia 404 gracefully', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({
+                    AbstractText: 'Some answer',
+                    AbstractSource: 'DDG',
+                    RelatedTopics: [],
+                }), { status: 200 });
+            }
+            // Wikipedia returns 404
+            return new Response('Not found', { status: 404 });
+        });
+        const result = await executeTool({
+            id: 'ws-6',
+            name: 'web_search',
+            arguments: { query: 'obscure topic' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Some answer');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────
+// 3. research
+// ─────────────────────────────────────────────────────────────────────
+describe('research', () => {
+    it('fetches provided URLs and DDG/Wikipedia', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('example.com')) {
+                return new Response('<html><body><p>Example content about AI</p></body></html>', {
+                    status: 200,
+                    headers: { 'content-type': 'text/html' },
+                });
+            }
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({
+                    AbstractText: 'AI is a branch of computer science.',
+                    AbstractSource: 'Wikipedia',
+                    RelatedTopics: [],
+                }), { status: 200 });
+            }
+            if (urlStr.includes('wikipedia.org')) {
+                return new Response(JSON.stringify({
+                    extract: 'Artificial intelligence is intelligence demonstrated by machines.',
+                }), { status: 200 });
+            }
+            return new Response('', { status: 404 });
+        });
+        const result = await executeTool({
+            id: 'r-1',
+            name: 'research',
+            arguments: {
+                topic: 'artificial intelligence',
+                urls: ['https://example.com/ai-page'],
+            },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Research results for: artificial intelligence');
+        expect(result.result).toContain('Example content about AI');
+        expect(result.result).toContain('AI is a branch of computer science');
+        expect(result.result).toContain('Wikipedia');
+    });
+    it('limits URLs to 5', async () => {
+        let fetchCount = 0;
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('example.com')) {
+                fetchCount++;
+                return new Response(`Content ${fetchCount}`, { status: 200 });
+            }
+            return new Response(JSON.stringify({ AbstractText: '', RelatedTopics: [] }), { status: 200 });
+        });
+        const urls = Array.from({ length: 10 }, (_, i) => `https://example.com/page${i}`);
+        const result = await executeTool({
+            id: 'r-2',
+            name: 'research',
+            arguments: { topic: 'test', urls },
+        });
+        expect(result.error).toBeUndefined();
+        // Only first 5 URLs should be fetched
+        expect(fetchCount).toBeLessThanOrEqual(5);
+    });
+    it('returns fallback for no results', async () => {
+        mockFetch(async () => {
+            throw new Error('Network failure');
+        });
+        const result = await executeTool({
+            id: 'r-3',
+            name: 'research',
+            arguments: { topic: 'impossible topic' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('No research results found');
+    });
+    it('strips HTML from fetched URLs', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('example.com')) {
+                return new Response('<html><head><script>alert("xss")</script><style>body{color:red}</style></head><body><p>Clean text</p></body></html>', { status: 200 });
+            }
+            return new Response(JSON.stringify({ AbstractText: '', RelatedTopics: [] }), { status: 200 });
+        });
+        const result = await executeTool({
+            id: 'r-4',
+            name: 'research',
+            arguments: { topic: 'html stripping', urls: ['https://example.com'] },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Clean text');
+        expect(result.result).not.toContain('alert');
+        expect(result.result).not.toContain('<script');
+        expect(result.result).not.toContain('<style');
+    });
+    it('handles mixed URL success and failure', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('good.com')) {
+                return new Response('Good content', { status: 200 });
+            }
+            if (urlStr.includes('bad.com')) {
+                throw new Error('Connection refused');
+            }
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({ AbstractText: 'DDG result', AbstractSource: 'DDG', RelatedTopics: [] }), { status: 200 });
+            }
+            return new Response(JSON.stringify({}), { status: 200 });
+        });
+        const result = await executeTool({
+            id: 'r-5',
+            name: 'research',
+            arguments: {
+                topic: 'test',
+                urls: ['https://good.com/page', 'https://bad.com/page'],
+            },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Good content');
+        expect(result.result).toContain('DDG result');
+        // bad.com should be silently skipped
+    });
+    it('works without urls parameter', async () => {
+        mockFetch(async (url) => {
+            const urlStr = String(url);
+            if (urlStr.includes('duckduckgo.com')) {
+                return new Response(JSON.stringify({
+                    AbstractText: 'Research result',
+                    AbstractSource: 'Source',
+                    RelatedTopics: [{ Text: 'Related item' }],
+                }), { status: 200 });
+            }
+            return new Response(JSON.stringify({ extract: 'Wiki content' }), { status: 200 });
+        });
+        const result = await executeTool({
+            id: 'r-6',
+            name: 'research',
+            arguments: { topic: 'test topic' },
+        });
+        expect(result.error).toBeUndefined();
+        expect(result.result).toContain('Research result');
+    });
+});
+//# sourceMappingURL=search.test.js.map