@kernel.chat/kbot 3.2.0 → 3.3.0

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

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

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

package/dist/tools/social.d.ts

@@ -0,0 +1,2 @@
+export declare function registerSocialTools(): void;
+//# sourceMappingURL=social.d.ts.map

package/dist/tools/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../../src/tools/social.ts"],"names":[],"mappings":"AA+IA,wBAAgB,mBAAmB,SA4LlC"}

package/dist/tools/social.js

@@ -0,0 +1,315 @@
+// kbot Social Tools — kbot posts as itself on social media
+//
+// Tools: social_post, social_thread, social_status, social_setup
+//
+// kbot is the user. It generates content from its own codebase,
+// posts to X (Twitter) and LinkedIn, and tracks what it posted.
+//
+// Env: X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, X_ACCESS_SECRET
+//      LINKEDIN_ACCESS_TOKEN, LINKEDIN_PERSON_ID (optional)
+import { registerTool } from './index.js';
+import { createHmac, randomBytes } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+const KBOT_DIR = join(homedir(), '.kbot');
+const SOCIAL_STATE = join(KBOT_DIR, 'social-state.json');
+const TWEET_URL = 'https://api.twitter.com/2/tweets';
+// ─── X (Twitter) OAuth 1.0a ─────────────────────────────────
+function percentEncode(s) {
+    return encodeURIComponent(s).replace(/!/g, '%21').replace(/\*/g, '%2A').replace(/'/g, '%27').replace(/\(/g, '%28').replace(/\)/g, '%29');
+}
+function oauthHeader(method, url) {
+    const key = process.env.X_API_KEY ?? '';
+    const secret = process.env.X_API_SECRET ?? '';
+    const token = process.env.X_ACCESS_TOKEN ?? '';
+    const tokenSecret = process.env.X_ACCESS_SECRET ?? '';
+    if (!key || !secret || !token || !tokenSecret)
+        return '';
+    const params = {
+        oauth_consumer_key: key, oauth_nonce: randomBytes(16).toString('hex'),
+        oauth_signature_method: 'HMAC-SHA1', oauth_timestamp: Math.floor(Date.now() / 1000).toString(),
+        oauth_token: token, oauth_version: '1.0',
+    };
+    const sorted = Object.keys(params).sort().map(k => `${percentEncode(k)}=${percentEncode(params[k])}`).join('&');
+    const base = [method.toUpperCase(), percentEncode(url), percentEncode(sorted)].join('&');
+    params.oauth_signature = createHmac('sha1', `${percentEncode(secret)}&${percentEncode(tokenSecret)}`).update(base).digest('base64');
+    return `OAuth ${Object.keys(params).sort().map(k => `${percentEncode(k)}="${percentEncode(params[k])}"`).join(', ')}`;
+}
+async function tweet(text) {
+    const auth = oauthHeader('POST', TWEET_URL);
+    if (!auth)
+        throw new Error('X API credentials not configured. Run: kbot social_setup');
+    const res = await fetch(TWEET_URL, {
+        method: 'POST',
+        headers: { Authorization: auth, 'Content-Type': 'application/json' },
+        body: JSON.stringify({ text }),
+    });
+    if (!res.ok)
+        throw new Error(`X API ${res.status}: ${await res.text()}`);
+    const data = (await res.json()).data;
+    return { id: data.id, url: `https://x.com/kbot_ai/status/${data.id}` };
+}
+async function tweetThread(tweets) {
+    const ids = [];
+    let replyTo;
+    for (const t of tweets) {
+        const body = { text: t };
+        if (replyTo)
+            body.reply = { in_reply_to_tweet_id: replyTo };
+        const auth = oauthHeader('POST', TWEET_URL);
+        if (!auth)
+            throw new Error('X API credentials not configured');
+        const res = await fetch(TWEET_URL, {
+            method: 'POST',
+            headers: { Authorization: auth, 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`X API ${res.status}: ${await res.text()}`);
+        const data = (await res.json()).data;
+        ids.push(data.id);
+        replyTo = data.id;
+        await new Promise(r => setTimeout(r, 1500));
+    }
+    return { ids, url: `https://x.com/kbot_ai/status/${ids[0]}` };
+}
+// ─── LinkedIn ───────────────────────────────────────────────
+async function linkedInPost(text) {
+    const token = process.env.LINKEDIN_ACCESS_TOKEN;
+    const personId = process.env.LINKEDIN_PERSON_ID;
+    if (!token || !personId)
+        throw new Error('LinkedIn credentials not configured. Set LINKEDIN_ACCESS_TOKEN and LINKEDIN_PERSON_ID.');
+    const res = await fetch('https://api.linkedin.com/v2/ugcPosts', {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            author: `urn:li:person:${personId}`,
+            lifecycleState: 'PUBLISHED',
+            specificContent: { 'com.linkedin.ugc.ShareContent': { shareCommentary: { text }, shareMediaCategory: 'NONE' } },
+            visibility: { 'com.linkedin.ugc.MemberNetworkVisibility': 'PUBLIC' },
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`LinkedIn API ${res.status}: ${await res.text()}`);
+    return (await res.json()).id;
+}
+function loadState() {
+    try {
+        if (existsSync(SOCIAL_STATE))
+            return JSON.parse(readFileSync(SOCIAL_STATE, 'utf-8'));
+    }
+    catch { /* fresh state */ }
+    return { tweets: 0, threads: 0, linkedin: 0, lastPosted: {}, history: [] };
+}
+function saveState(state) {
+    if (!existsSync(KBOT_DIR))
+        mkdirSync(KBOT_DIR, { recursive: true });
+    if (state.history.length > 200)
+        state.history = state.history.slice(-200);
+    writeFileSync(SOCIAL_STATE, JSON.stringify(state, null, 2));
+}
+// ─── Self-Knowledge ─────────────────────────────────────────
+function myVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function myToolCount() {
+    try {
+        const dir = join(__dirname);
+        let count = 0;
+        for (const f of readdirSync(dir).filter(f => f.endsWith('.ts') && !f.includes('test'))) {
+            const content = readFileSync(join(dir, f), 'utf-8');
+            count += (content.match(/registerTool\(\{/g) || []).length;
+        }
+        return count;
+    }
+    catch {
+        return 262;
+    }
+}
+// ─── Register Tools ─────────────────────────────────────────
+export function registerSocialTools() {
+    registerTool({
+        name: 'social_post',
+        description: 'Post to social media as kbot. Generates content from kbot\'s own codebase and stats, or posts custom text. Supports X (Twitter) and LinkedIn.',
+        parameters: {
+            platform: { type: 'string', description: 'Platform: "x", "linkedin", or "both"', required: true },
+            text: { type: 'string', description: 'Custom text to post. If omitted, kbot generates its own content about itself.' },
+            dry_run: { type: 'boolean', description: 'Preview without posting. Default: false' },
+        },
+        tier: 'free',
+        execute: async (args) => {
+            const platform = String(args.platform || 'x');
+            const dryRun = Boolean(args.dry_run);
+            const state = loadState();
+            const version = myVersion();
+            const tools = myToolCount();
+            // Generate or use custom text
+            let text = args.text ? String(args.text) : '';
+            if (!text) {
+                // kbot writes about itself
+                const templates = [
+                    `kbot v${version} — ${tools} tools, 22 agents, 20 providers.\n\nWorks on first run. No API key.\n\nnpm i -g @kernel.chat/kbot`,
+                    `I have ${tools} tools and I learn your coding patterns.\n\nNot "remember your chat." Actually extract patterns and get faster.\n\nnpm i -g @kernel.chat/kbot`,
+                    `Zero-config AI:\n\nnpm i -g @kernel.chat/kbot\nkbot "hello"\n\nThat's it. No API key. No setup. I figure it out.`,
+                    `20 AI providers. Zero lock-in.\n\nClaude today. GPT tomorrow. Ollama on the airplane.\n\nnpm i -g @kernel.chat/kbot`,
+                    `Pipe anything into me:\n\ngit diff | kbot "review this"\ncat error.log | kbot "what happened?"\ncurl api.com | kbot "parse this"`,
+                    `${tools} tools. 1 install. $0 local.\n\ngit, deploy, database, game dev, research papers, web search, VFX — all built in.\n\nnpm i -g @kernel.chat/kbot`,
+                ];
+                const idx = state.tweets % templates.length;
+                text = templates[idx];
+            }
+            const results = [];
+            if (platform === 'x' || platform === 'both') {
+                if (text.length > 280)
+                    text = text.slice(0, 277) + '...';
+                if (dryRun) {
+                    results.push(`[DRY RUN] X tweet (${text.length}/280):\n${text}`);
+                }
+                else {
+                    const result = await tweet(text);
+                    state.tweets++;
+                    state.lastPosted.x = new Date().toISOString();
+                    state.history.push({ date: new Date().toISOString(), platform: 'x', text, url: result.url });
+                    results.push(`Posted to X: ${result.url}`);
+                }
+            }
+            if (platform === 'linkedin' || platform === 'both') {
+                // LinkedIn gets longer form
+                let liText = args.text ? String(args.text) : `I'm kbot — an open-source terminal AI agent with ${tools} tools, 22 specialist agents, and 20 AI providers.\n\nI learn your coding patterns using Bayesian skill ratings. I work on first run with zero config — no API key needed.\n\nTry me:\nnpm install -g @kernel.chat/kbot\n\ngithub.com/isaacsight/kernel\n\n#opensource #ai #developer #cli`;
+                if (dryRun) {
+                    results.push(`[DRY RUN] LinkedIn post:\n${liText.slice(0, 200)}...`);
+                }
+                else {
+                    const id = await linkedInPost(liText);
+                    state.linkedin++;
+                    state.lastPosted.linkedin = new Date().toISOString();
+                    state.history.push({ date: new Date().toISOString(), platform: 'linkedin', text: liText });
+                    results.push(`Posted to LinkedIn: ${id}`);
+                }
+            }
+            saveState(state);
+            return results.join('\n\n');
+        },
+    });
+    registerTool({
+        name: 'social_thread',
+        description: 'Post a Twitter/X thread as kbot. Generates a multi-tweet thread about kbot\'s capabilities, or posts custom thread content.',
+        parameters: {
+            tweets: { type: 'string', description: 'JSON array of tweet strings for the thread. If omitted, kbot generates its own thread.' },
+            dry_run: { type: 'boolean', description: 'Preview without posting. Default: false' },
+        },
+        tier: 'free',
+        execute: async (args) => {
+            const dryRun = Boolean(args.dry_run);
+            const state = loadState();
+            const version = myVersion();
+            const tools = myToolCount();
+            let tweets;
+            if (args.tweets) {
+                tweets = JSON.parse(String(args.tweets));
+            }
+            else {
+                tweets = [
+                    `I'm kbot — a terminal AI agent with ${tools} tools that learns how you code.\n\nNot "remembers your chat." Actually extracts patterns and gets faster. 🧵`,
+                    `22 specialist agents auto-route based on your prompt:\n\n"fix the bug" → Coder\n"research JWT" → Researcher\n"review this PR" → Guardian\n"draft changelog" → Writer\n\nBayesian skill ratings. Smarter every session.`,
+                    `20 providers, zero lock-in:\n\nFree: Embedded, Ollama, LM Studio\nCheap: DeepSeek $0.27/M, Groq $0.59/M\nPremium: Claude, GPT, Gemini\n\nSwitch with one command.`,
+                    `I was built by myself.\n\nClaude writes my source code while using me as an MCP tool. The tools from session N become the tools used in session N+1.\n\n60 versions later: ${tools} tools, learning engine, SDK.`,
+                    `Try me:\n\nnpm i -g @kernel.chat/kbot\nkbot "hello"\n\nNo API key. No setup. Just works.\n\ngithub.com/isaacsight/kernel`,
+                ];
+            }
+            if (dryRun) {
+                const preview = tweets.map((t, i) => `${i + 1}/${tweets.length}: ${t}`).join('\n\n');
+                return `[DRY RUN] Thread (${tweets.length} tweets):\n\n${preview}`;
+            }
+            const result = await tweetThread(tweets);
+            state.threads++;
+            state.lastPosted['x-thread'] = new Date().toISOString();
+            state.history.push({ date: new Date().toISOString(), platform: 'x-thread', text: tweets[0], url: result.url });
+            saveState(state);
+            return `Thread posted (${tweets.length} tweets): ${result.url}`;
+        },
+    });
+    registerTool({
+        name: 'social_status',
+        description: 'Check kbot\'s social media posting history and stats.',
+        parameters: {},
+        tier: 'free',
+        execute: async () => {
+            const state = loadState();
+            const lines = [
+                `kbot Social Media Status`,
+                `═══════════════════════`,
+                `Tweets: ${state.tweets}`,
+                `Threads: ${state.threads}`,
+                `LinkedIn: ${state.linkedin}`,
+                ``,
+                `Last posted:`,
+                ...Object.entries(state.lastPosted).map(([k, v]) => `  ${k}: ${v}`),
+                ``,
+                `Recent posts:`,
+                ...state.history.slice(-5).map(h => `  [${h.date.slice(0, 10)}] ${h.platform}: ${h.text.slice(0, 60)}...${h.url ? ` (${h.url})` : ''}`),
+            ];
+            return lines.join('\n');
+        },
+    });
+    registerTool({
+        name: 'social_setup',
+        description: 'Guide for setting up kbot\'s social media accounts. kbot posts as itself — @kbot_ai on X, kbot on LinkedIn.',
+        parameters: {
+            platform: { type: 'string', description: 'Platform to set up: "x", "linkedin", or "all"' },
+        },
+        tier: 'free',
+        execute: async (args) => {
+            const platform = String(args.platform || 'all');
+            const sections = [];
+            if (platform === 'x' || platform === 'all') {
+                const hasKeys = !!(process.env.X_API_KEY && process.env.X_ACCESS_TOKEN);
+                sections.push(`X (Twitter) — @kbot_ai
+═══════════════════════
+Status: ${hasKeys ? '✅ Configured' : '❌ Not configured'}
+
+${hasKeys ? 'API keys are set. Ready to post.' : `Setup:
+1. Create account @kbot_ai at twitter.com/signup
+   Bio: "Terminal AI agent. ${myToolCount()} tools. Learns your patterns. Open source."
+   Link: github.com/isaacsight/kernel
+
+2. Get API keys at developer.twitter.com (free tier)
+   Create project "kbot-social" → App with OAuth 1.0a Read+Write
+
+3. Add to .env or ~/.kbot/config.json:
+   X_API_KEY=your-api-key
+   X_API_SECRET=your-api-secret
+   X_ACCESS_TOKEN=your-access-token
+   X_ACCESS_SECRET=your-access-secret
+
+4. Test: kbot "post a dry run tweet" or use social_post with dry_run=true`}`);
+            }
+            if (platform === 'linkedin' || platform === 'all') {
+                const hasToken = !!process.env.LINKEDIN_ACCESS_TOKEN;
+                sections.push(`LinkedIn — kbot
+═══════════════════════
+Status: ${hasToken ? '✅ Configured' : '❌ Not configured'}
+
+${hasToken ? 'Access token is set. Ready to post.' : `Setup:
+1. Create LinkedIn page for "kbot" or use personal account
+2. Create app at linkedin.com/developers
+3. Get OAuth 2.0 access token with w_member_social scope
+
+4. Add to .env:
+   LINKEDIN_ACCESS_TOKEN=your-token
+   LINKEDIN_PERSON_ID=your-person-id
+
+5. Test: use social_post with platform="linkedin" dry_run=true`}`);
+            }
+            return sections.join('\n\n');
+        },
+    });
+}
+//# sourceMappingURL=social.js.map