0xkobold 0.0.2 → 0.0.4

package/dist/src/llm/ollama.js

@@ -3,13 +3,28 @@
  *
  * Local LLM via Ollama HTTP API.
  */
-const OLLAMA_BASE_URL = process.env.OLLAMA_URL ?? 'http://localhost:11434';
+import { shouldUseCloud } from '../extensions/core/ollama-router-extension';
+const LOCAL_BASE_URL = process.env.OLLAMA_URL ?? 'http://localhost:11434';
+const CLOUD_BASE_URL = 'https://ollama.com';
 /**
- * Check if Ollama is running
+ * Get Ollama base URL based on mode
+ */
+function getOllamaBaseUrl() {
+    return shouldUseCloud() ? CLOUD_BASE_URL : LOCAL_BASE_URL;
+}
+/**
+ * Get Ollama API key for cloud mode
+ */
+async function getOllamaApiKey() {
+    // Will be populated by framework from auth.json
+    return process.env.OLLAMA_API_KEY;
+}
+/**
+ * Check if Ollama is running (local mode)
  */
 export async function isOllamaRunning() {
     try {
-        const res = await fetch(`${OLLAMA_BASE_URL}/api/tags`, {
+        const res = await fetch(`${LOCAL_BASE_URL}/api/tags`, {
             method: 'GET',
         });
         return res.ok;
@@ -18,12 +33,30 @@ export async function isOllamaRunning() {
         return false;
     }
 }
+/**
+ * Check if Ollama Cloud is available
+ */
+export async function isOllamaCloudAvailable() {
+    try {
+        const apiKey = await getOllamaApiKey();
+        if (!apiKey)
+            return false;
+        const res = await fetch(`${CLOUD_BASE_URL}/api/tags`, {
+            headers: { 'Authorization': `Bearer ${apiKey}` },
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * List available Ollama models
  */
 export async function listOllamaModels() {
     try {
-        const res = await fetch(`${OLLAMA_BASE_URL}/api/tags`);
+        const baseUrl = getOllamaBaseUrl();
+        const res = await fetch(`${baseUrl}/api/tags`);
         if (!res.ok)
             return [];
         const data = await res.json();
@@ -35,15 +68,25 @@ export async function listOllamaModels() {
 }
 /**
  * Ollama LLM Provider
+ * Supports both local (localhost:11434) and cloud (ollama.com) modes
  */
 export class OllamaProvider {
     name = 'ollama';
     baseUrl;
-    constructor(baseUrl = OLLAMA_BASE_URL) {
-        this.baseUrl = baseUrl;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl ?? getOllamaBaseUrl();
+    }
+    /**
+     * Update base URL based on current mode
+     */
+    updateBaseUrl() {
+        this.baseUrl = getOllamaBaseUrl();
     }
     async chat(options) {
+        // Ensure we're using correct mode
+        this.updateBaseUrl();
         const model = options.model.replace('ollama/', '');
+        const isCloud = this.baseUrl === CLOUD_BASE_URL;
         // Convert messages to Ollama format
         const messages = options.messages.map((m) => ({
             role: m.role,
@@ -72,14 +115,25 @@ export class OllamaProvider {
                 function: t.function,
             }));
         }
+        // Build headers
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        // Add auth header for cloud mode
+        if (isCloud) {
+            const apiKey = await getOllamaApiKey();
+            if (apiKey) {
+                headers['Authorization'] = `Bearer ${apiKey}`;
+            }
+        }
         const res = await fetch(`${this.baseUrl}/api/chat`, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
+            headers,
             body: JSON.stringify(body),
         });
         if (!res.ok) {
             const err = await res.text();
-            throw new Error(`Ollama error: ${err}`);
+            throw new Error(`Ollama ${isCloud ? 'Cloud' : 'Local'} error: ${err}`);
         }
         const data = await res.json();
         // Parse tool calls from response
@@ -101,7 +155,24 @@ export class OllamaProvider {
         };
     }
     async listModels() {
-        return listOllamaModels();
+        this.updateBaseUrl();
+        const isCloud = this.baseUrl === CLOUD_BASE_URL;
+        try {
+            const headers = {};
+            if (isCloud) {
+                const apiKey = await getOllamaApiKey();
+                if (apiKey)
+                    headers['Authorization'] = `Bearer ${apiKey}`;
+            }
+            const res = await fetch(`${this.baseUrl}/api/tags`, { headers });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            return (data.models ?? []).map((m) => m.name);
+        }
+        catch {
+            return [];
+        }
     }
 }
 /**

package/dist/src/llm/ollama.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0xkobold",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Your digital familiar - a personal AI assistant that learns and evolves",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -28,15 +28,16 @@
     "update:install": "bun run src/cli/index.ts update install",
     "update:framework": "bun run src/cli/index.ts update framework",
     "setup-hooks": "bash scripts/install-hooks.sh",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "postinstall": "node scripts/postinstall.js || echo 'Welcome to 0xKobold! Run: 0xkobold setup'"
   },
   "keywords": ["ai", "assistant", "cli", "agent", "kobold"],
   "author": "0xKobold Team",
   "license": "MIT",
   "dependencies": {
-    "@mariozechner/pi-agent-core": "0.57.0",
-    "@mariozechner/pi-coding-agent": "0.57.0",
-    "@mariozechner/pi-tui": "0.57.0",
+    "@mariozechner/pi-agent-core": "0.57.1",
+    "@mariozechner/pi-coding-agent": "0.57.1",
+    "@mariozechner/pi-tui": "0.57.1",
     "ajv": "^8.18.0",
     "blessed": "^0.1.81",
     "commander": "^11.1.0",
@@ -63,6 +64,7 @@
   "private": false,
   "files": [
     "dist",
+    "scripts/postinstall.js",
     "README.md",
     "LICENSE",
     "package.json",

package/scripts/postinstall.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Post-install welcome message
+ * Shows when users install 0xKobold via npm
+ */
+
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+
+const isCiEnvironment = () => {
+  return process.env.CI || 
+         process.env.CONTINUOUS_INTEGRATION ||
+         process.env.NODE_ENV === "test";
+};
+
+const showWelcome = () => {
+  const configPath = join(homedir(), ".0xkobold", "config.json");
+  const isConfigured = existsSync(configPath);
+
+  console.log(`
+╔════════════════════════════════════════════════════════╗
+║                  🐲 0xKobold Installed                 ║
+╚════════════════════════════════════════════════════════╝
+
+   Your personal AI assistant with multi-agent capabilities
+
+`);
+
+  if (!isConfigured) {
+    console.log(`   Quick start:
+   ────────────
+   1. Configure 0xKobold:
+      0xkobold setup
+
+   2. Start the TUI:
+      0xkobold
+
+   3. Or start in specific mode:
+      0xkobold --mode plan    # For planning/research
+      0xkobold --mode build   # For implementation
+
+   Requirements:
+   ─────────────
+   • Bun runtime required (0xKobold will check for it)
+   • Install Bun: curl -fsSL https://bun.sh/install | bash
+
+   Documentation:
+   ──────────────
+   • GitHub: https://github.com/kobolds/0xKobolds
+   • Usage:  0xkobold --help
+   • VPS:    https://github.com/kobolds/0xKobolds/blob/main/docs/VPS-DEPLOYMENT.md
+
+`);
+  } else {
+    console.log(`   Your 0xKobold is configured.
+   
+   Start with: 0xkobold
+   Gateway:    0xkobold gateway start
+   Status:     0xkobold status
+
+`);
+  }
+
+  if (isCiEnvironment()) {
+    process.exit(0);
+  }
+};
+
+// Only show in actual install, not CI
+showWelcome();