0xkobold 0.2.0 → 0.3.1

package/dist/src/gateway/client.js

@@ -0,0 +1,318 @@
+/**
+ * Gateway Client - Remote/VPS Support
+ *
+ * Connect to remote or local gateway server for distributed architecture.
+ * Based on kod/OpenClaw client architecture - simplified for 0xKobold.
+ */
+import { EventEmitter } from "events";
+import { homedir } from "os";
+import { join } from "path";
+import * as fs from "node:fs/promises";
+export const GATEWAY_STATE = {
+    DISCONNECTED: "disconnected",
+    CONNECTING: "connecting",
+    CONNECTED: "connected",
+};
+/**
+ * GatewayClient - WebSocket client for connecting to local or remote gateway
+ *
+ * Architecture:
+ * - Local mode: Connects to ws://localhost:7777
+ * - Remote mode: Connects to wss://your-vps.com:7777
+ * - Handles auth tokens (local storage in ~/.0xkobold/)
+ * - Auto-reconnect with exponential backoff
+ * - Heartbeat/ping-pong for connection health
+ */
+export class GatewayClient extends EventEmitter {
+    ws = null;
+    config;
+    state = GATEWAY_STATE.DISCONNECTED;
+    reconnectTimer;
+    pingTimer;
+    reconnectCount = 0;
+    pendingMessages = [];
+    messageId = 0;
+    constructor(config) {
+        super();
+        this.config = {
+            url: config.url,
+            autoReconnect: config.autoReconnect ?? true,
+            reconnectDelay: config.reconnectDelay ?? 1000,
+            reconnectAttempts: config.reconnectAttempts ?? 10,
+            token: config.token,
+            deviceToken: config.deviceToken,
+            password: config.password,
+            clientName: config.clientName ?? "0xKobold-Client",
+            clientVersion: config.clientVersion ?? "0.3.0",
+            deviceId: config.deviceId ?? "unknown",
+            capabilities: config.capabilities ?? ["chat", "files", "heartbeat"],
+            onConnect: config.onConnect,
+            onDisconnect: config.onDisconnect,
+            onMessage: config.onMessage,
+            onError: config.onError,
+        };
+    }
+    /**
+     * Connect to gateway
+     */
+    async connect() {
+        if (this.state === GATEWAY_STATE.CONNECTED) {
+            return true;
+        }
+        this.state = GATEWAY_STATE.CONNECTING;
+        this.emit("stateChange", this.state);
+        try {
+            // Determine protocol (ws:// vs wss://)
+            const isSecure = this.config.url.startsWith("wss://");
+            const wsUrl = this.config.url;
+            console.log(`[GatewayClient] Connecting to ${isSecure ? "secure" : "insecure"} WebSocket...`);
+            console.log(`[GatewayClient] URL: ${wsUrl}`);
+            // Create WebSocket
+            this.ws = new WebSocket(wsUrl);
+            // Setup handlers
+            this.ws.onopen = () => this.handleOpen();
+            this.ws.onclose = (event) => this.handleClose(event.code, event.reason);
+            this.ws.onerror = (err) => this.handleError(new Error(String(err)));
+            this.ws.onmessage = (msg) => this.handleMessage(msg.data);
+            // Wait for connection
+            await this.waitForConnection();
+            return true;
+        }
+        catch (err) {
+            this.handleError(err);
+            return false;
+        }
+    }
+    /**
+     * Disconnect from gateway
+     */
+    disconnect() {
+        this.clearTimers();
+        if (this.ws) {
+            this.ws.close(1000, "Client disconnect");
+            this.ws = null;
+        }
+        this.state = GATEWAY_STATE.DISCONNECTED;
+        this.emit("stateChange", this.state);
+    }
+    /**
+     * Send message to gateway
+     */
+    send(message) {
+        const fullMessage = {
+            ...message,
+            id: this.generateMessageId(),
+            timestamp: Date.now(),
+        };
+        if (this.state === GATEWAY_STATE.CONNECTED && this.ws) {
+            this.ws.send(JSON.stringify(fullMessage));
+        }
+        else {
+            // Queue for later
+            this.pendingMessages.push(fullMessage);
+        }
+        return fullMessage.id;
+    }
+    /**
+     * Send chat request
+     */
+    chat(message, context) {
+        return this.send({
+            type: "request",
+            channel: "chat",
+            payload: {
+                message,
+                context,
+                capabilities: this.config.capabilities,
+            },
+        });
+    }
+    /**
+     * Send ping to check connection
+     */
+    ping() {
+        this.send({
+            type: "ping",
+            payload: { timestamp: Date.now() },
+        });
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.state === GATEWAY_STATE.CONNECTED;
+    }
+    /**
+     * Load cached device token from disk
+     */
+    static async loadDeviceToken() {
+        const tokenPath = join(homedir(), ".0xkobold", ".device-token");
+        try {
+            const token = await fs.readFile(tokenPath, "utf-8");
+            return token.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save device token to disk
+     */
+    static async saveDeviceToken(token) {
+        const tokenPath = join(homedir(), ".0xkobold", ".device-token");
+        await fs.mkdir(join(homedir(), ".0xkobold"), { recursive: true });
+        await fs.writeFile(tokenPath, token, "utf-8");
+        await fs.chmod(tokenPath, 0o600); // Secure permissions
+    }
+    /**
+     * Clear saved device token
+     */
+    static async clearDeviceToken() {
+        const tokenPath = join(homedir(), ".0xkobold", ".device-token");
+        try {
+            await fs.unlink(tokenPath);
+        }
+        catch {
+            // Ignore if doesn't exist
+        }
+    }
+    // Private methods
+    handleOpen() {
+        console.log("[GatewayClient] Connected successfully");
+        this.state = GATEWAY_STATE.CONNECTED;
+        this.reconnectCount = 0;
+        // Send authentication
+        this.sendAuth();
+        // Process queued messages
+        this.processPendingMessages();
+        // Start heartbeat
+        this.startHeartbeat();
+        this.emit("connected");
+        this.config.onConnect?.();
+    }
+    handleClose(code, reason) {
+        console.log(`[GatewayClient] Disconnected: ${code} - ${reason}`);
+        this.state = GATEWAY_STATE.DISCONNECTED;
+        this.emit("disconnected", code, reason);
+        this.config.onDisconnect?.(code, reason);
+        this.clearTimers();
+        // Attempt reconnect if enabled
+        if (this.config.autoReconnect && this.reconnectCount < this.config.reconnectAttempts) {
+            this.scheduleReconnect();
+        }
+    }
+    handleError(err) {
+        console.error("[GatewayClient] Error:", err.message);
+        this.emit("error", err);
+        this.config.onError?.(err);
+    }
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data.toString());
+            // Handle ping/pong
+            if (message.type === "pong") {
+                this.emit("pong", message);
+                return;
+            }
+            this.emit("message", message);
+            this.config.onMessage?.(message);
+        }
+        catch (err) {
+            console.error("[GatewayClient] Failed to parse message:", err);
+        }
+    }
+    sendAuth() {
+        const authPayload = {
+            client: this.config.clientName,
+            version: this.config.clientVersion,
+            deviceId: this.config.deviceId,
+            capabilities: this.config.capabilities,
+        };
+        if (this.config.token) {
+            authPayload.token = this.config.token;
+        }
+        if (this.config.deviceToken) {
+            authPayload.deviceToken = this.config.deviceToken;
+        }
+        if (this.config.password) {
+            authPayload.password = this.config.password;
+        }
+        this.send({
+            type: "request",
+            channel: "auth",
+            payload: authPayload,
+        });
+    }
+    waitForConnection() {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error("Connection timeout"));
+            }, 10000);
+            const onConnect = () => {
+                clearTimeout(timeout);
+                this.off("error", onError);
+                resolve();
+            };
+            const onError = (err) => {
+                clearTimeout(timeout);
+                this.off("connected", onConnect);
+                reject(err);
+            };
+            this.once("connected", onConnect);
+            this.once("error", onError);
+        });
+    }
+    scheduleReconnect() {
+        this.reconnectCount++;
+        const delay = this.config.reconnectDelay * Math.min(this.reconnectCount, 5);
+        console.log(`[GatewayClient] Reconnecting in ${delay}ms (attempt ${this.reconnectCount})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect();
+        }, delay);
+    }
+    startHeartbeat() {
+        this.pingTimer = setInterval(() => {
+            if (this.isConnected()) {
+                this.ping();
+            }
+        }, 30000); // Ping every 30s
+    }
+    processPendingMessages() {
+        while (this.pendingMessages.length > 0) {
+            const msg = this.pendingMessages.shift();
+            if (msg && this.ws) {
+                this.ws.send(JSON.stringify(msg));
+            }
+        }
+    }
+    clearTimers() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = undefined;
+        }
+    }
+    generateMessageId() {
+        return `msg-${Date.now()}-${++this.messageId}`;
+    }
+}
+// Factory for creating client with auto-loaded token
+export async function createGatewayClient(url, options) {
+    const deviceToken = await GatewayClient.loadDeviceToken();
+    return new GatewayClient({
+        url,
+        deviceToken: deviceToken ?? undefined,
+        ...options,
+    });
+}
+export default GatewayClient;
+//# sourceMappingURL=client.js.map

package/dist/src/gateway/client.js.map

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

package/dist/src/infra/index.js

@@ -0,0 +1,3 @@
+// Infrastructure Module - v0.3.0
+export { TailscaleIntegration, getTailscaleIntegration, } from "./tailscale.js";
+//# sourceMappingURL=index.js.map

package/dist/src/infra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infra/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,gBAAgB,CAAC"}

package/dist/src/infra/tailscale.js

@@ -0,0 +1,163 @@
+/**
+ * Tailscale Integration - v0.3.0
+ *
+ * Zero-config VPN for secure remote gateway access.
+ * No port forwarding required, works through NAT/firewalls.
+ */
+import { spawn } from "node:child_process";
+import { EventEmitter } from "events";
+class TailscaleIntegration extends EventEmitter {
+    config;
+    connected = false;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            enabled: false,
+            autoStart: true,
+            advertiseExitNode: false,
+            ...config,
+        };
+    }
+    /**
+     * Check if Tailscale is installed
+     */
+    async isInstalled() {
+        try {
+            const result = await this.execCommand("tailscale", ["version"]);
+            return result.success;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if Tailscale is running
+     */
+    async isRunning() {
+        try {
+            const result = await this.execCommand("tailscale", ["status", "--json"]);
+            if (!result.success)
+                return false;
+            const status = JSON.parse(result.stdout);
+            return status?.Self?.Online || false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get Tailscale status
+     */
+    async getStatus() {
+        const installed = await this.isInstalled();
+        const running = installed ? await this.isRunning() : false;
+        if (running) {
+            try {
+                const result = await this.execCommand("tailscale", ["status", "--json"]);
+                const status = JSON.parse(result.stdout);
+                return {
+                    installed,
+                    running,
+                    connected: status?.Self?.Online || false,
+                    myIP: status?.Self?.TailscaleIPs?.[0],
+                };
+            }
+            catch {
+                return { installed, running, connected: false };
+            }
+        }
+        return { installed, running, connected: false };
+    }
+    /**
+     * Start Tailscale daemon
+     */
+    async start() {
+        const status = await this.getStatus();
+        if (!status.installed) {
+            console.log("⚠️  Tailscale not installed");
+            console.log("   Install: https://tailscale.com/download");
+            return false;
+        }
+        if (status.running) {
+            console.log("✅ Tailscale already running");
+            this.emit("ready", { ip: status.myIP });
+            return true;
+        }
+        console.log("🚀 Starting Tailscale...");
+        let result;
+        if (process.platform === "darwin") {
+            result = await this.execCommand("sudo", ["tailscaled", "--daemon"]);
+        }
+        else if (process.platform === "linux") {
+            result = await this.execCommand("sudo", ["systemctl", "start", "tailscaled"]);
+        }
+        else {
+            console.log("⚠️  Windows not yet supported for auto-start");
+            return false;
+        }
+        if (result.success) {
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            const newStatus = await this.getStatus();
+            if (newStatus.running) {
+                console.log(`✅ Tailscale ready: ${newStatus.myIP}`);
+                this.emit("ready", { ip: newStatus.myIP });
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get my Tailscale IP
+     */
+    async getMyIP() {
+        const result = await this.execCommand("tailscale", ["ip", "-4"]);
+        if (result.success) {
+            return result.stdout.trim();
+        }
+        return undefined;
+    }
+    /**
+     * Generate gateway URL for this device
+     */
+    async getGatewayURL(port = 7777) {
+        const ip = await this.getMyIP();
+        if (!ip)
+            return undefined;
+        return `wss://${ip}:${port}`;
+    }
+    /**
+     * Execute command helper
+     */
+    execCommand(cmd, args) {
+        return new Promise((resolve) => {
+            const child = spawn(cmd, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout?.on("data", (data) => {
+                stdout += data.toString();
+            });
+            child.stderr?.on("data", (data) => {
+                stderr += data.toString();
+            });
+            child.on("exit", (code) => {
+                resolve({ success: code === 0, stdout, stderr });
+            });
+            child.on("error", () => {
+                resolve({ success: false, stdout, stderr });
+            });
+        });
+    }
+}
+// Singleton
+let instance = null;
+export function getTailscaleIntegration(config) {
+    if (!instance) {
+        instance = new TailscaleIntegration(config);
+    }
+    return instance;
+}
+export { TailscaleIntegration };
+export default TailscaleIntegration;
+//# sourceMappingURL=tailscale.js.map

package/dist/src/infra/tailscale.js.map

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

package/dist/src/media/audio.js

@@ -0,0 +1,130 @@
+/**
+ * Audio Transcription - v0.3.0
+ *
+ * Speech-to-text using Whisper API or local inference.
+ */
+import OpenAI from "openai";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+export class AudioTranscriber {
+    config;
+    openai;
+    constructor(config) {
+        this.config = {
+            model: config.provider === "openai" ? "whisper-1" : "base",
+            responseFormat: "json",
+            ...config,
+        };
+        if (config.provider === "openai" && config.apiKey) {
+            this.openai = new OpenAI({ apiKey: config.apiKey });
+        }
+    }
+    /**
+     * Transcribe audio file
+     */
+    async transcribeFile(audioPath) {
+        if (this.config.provider === "openai") {
+            return this.transcribeWithOpenAI(audioPath);
+        }
+        return this.transcribeLocal(audioPath);
+    }
+    /**
+     * Transcribe audio buffer
+     */
+    async transcribeBuffer(audioBuffer, filename = "audio.mp3") {
+        // Save to temp file
+        const tempPath = `/tmp/transcribe-${Date.now()}-${filename}`;
+        await fs.writeFile(tempPath, audioBuffer);
+        try {
+            return await this.transcribeFile(tempPath);
+        }
+        finally {
+            await fs.unlink(tempPath).catch(() => { });
+        }
+    }
+    /**
+     * Transcribe with OpenAI Whisper
+     */
+    async transcribeWithOpenAI(audioPath) {
+        if (!this.openai) {
+            throw new Error("OpenAI client not initialized");
+        }
+        // Read file as buffer
+        const buffer = await fs.readFile(audioPath);
+        const blob = new Blob([buffer], { type: "audio/mpeg" });
+        const file = new File([blob], path.basename(audioPath), { type: "audio/mpeg" });
+        const response = await this.openai.audio.transcriptions.create({
+            file: file,
+            model: this.config.model,
+            language: this.config.language,
+            response_format: this.config.responseFormat,
+        });
+        const result = {
+            text: typeof response === "string" ? response : response.text,
+            language: this.config.language,
+        };
+        // Parse verbose JSON if available
+        if (typeof response === "object" && "segments" in response) {
+            result.segments = response.segments?.map((seg) => ({
+                id: seg.id,
+                start: seg.start,
+                end: seg.end,
+                text: seg.text,
+            }));
+            result.duration = response.duration;
+        }
+        return result;
+    }
+    /**
+     * Local transcription (placeholder for future local Whisper)
+     */
+    async transcribeLocal(audioPath) {
+        // Placeholder: would use local whisper.cpp or similar
+        throw new Error("Local transcription not yet implemented. Use OpenAI provider.");
+    }
+    /**
+     * Convert audio format using ffmpeg
+     */
+    async convertAudio(inputPath, outputFormat = "mp3") {
+        const outputPath = inputPath.replace(/\.[^.]+$/, `.${outputFormat}`);
+        return new Promise((resolve, reject) => {
+            const ffmpeg = spawn("ffmpeg", [
+                "-i", inputPath,
+                "-ar", "16000",
+                "-ac", "1",
+                "-f", outputFormat,
+                outputPath,
+            ]);
+            ffmpeg.on("close", (code) => {
+                if (code === 0) {
+                    resolve(outputPath);
+                }
+                else {
+                    reject(new Error(`ffmpeg exited with code ${code}`));
+                }
+            });
+            ffmpeg.on("error", (err) => {
+                if (err.message.includes("ENOENT")) {
+                    reject(new Error("ffmpeg not found. Install ffmpeg to convert audio."));
+                }
+                else {
+                    reject(err);
+                }
+            });
+        });
+    }
+}
+// Helper functions
+export async function transcribeAudio(audioPath, config) {
+    const transcriber = new AudioTranscriber(config);
+    return transcriber.transcribeFile(audioPath);
+}
+export async function transcribeVoiceNote(audioPath, apiKey) {
+    const result = await transcribeAudio(audioPath, {
+        provider: "openai",
+        apiKey,
+    });
+    return result.text;
+}
+//# sourceMappingURL=audio.js.map

package/dist/src/media/audio.js.map

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

package/dist/src/media/index.js

@@ -0,0 +1,4 @@
+// Media Module - v0.3.0
+export { VisionAnalyzer, analyzeImage, } from "./vision.js";
+export { AudioTranscriber, transcribeAudio, transcribeVoiceNote, } from "./audio.js";
+//# sourceMappingURL=index.js.map

package/dist/src/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EACL,cAAc,EACd,YAAY,GAGb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GAGpB,MAAM,YAAY,CAAC"}