@lobu/cli 3.0.5 → 3.0.7

package/dist/system-skills.json

@@ -0,0 +1,364 @@
+{
+  "skills": [
+    {
+      "id": "owletto",
+      "name": "Owletto Memory",
+      "description": "Long-term memory across conversations. Use when you need to remember user preferences, recall past context, or store important facts.",
+      "instructions": "Check Owletto memory at the start of each conversation for relevant context. Store important user preferences, facts, and decisions.",
+      "hidden": true,
+      "mcpServers": [
+        {
+          "id": "owletto",
+          "name": "Owletto",
+          "url": "${env:MEMORY_URL}",
+          "type": "sse"
+        }
+      ]
+    },
+    {
+      "id": "github",
+      "name": "GitHub",
+      "description": "Repos, issues, pull requests, and code access",
+      "instructions": "Use Owletto MCP tools for GitHub API access (issues, PRs, repos). For git operations, use the CLI directly — network permissions are granted for github.com.",
+      "permissions": ["github.com", ".github.com", ".githubusercontent.com"]
+    },
+    {
+      "id": "google-workspace",
+      "name": "Google Workspace",
+      "description": "Gmail, Calendar, and Drive integration",
+      "instructions": "Use Owletto MCP tools for Google Workspace API access (Gmail, Calendar, Drive)."
+    },
+    {
+      "id": "linear",
+      "name": "Linear",
+      "description": "Issue tracking and project management",
+      "instructions": "Use Owletto MCP tools for Linear API access (issues, projects, cycles)."
+    },
+    {
+      "id": "notion",
+      "name": "Notion",
+      "description": "Workspace pages, databases, and content",
+      "instructions": "Use Owletto MCP tools for Notion API access (pages, databases, blocks)."
+    },
+    {
+      "id": "jira",
+      "name": "Jira",
+      "description": "Atlassian Jira project and issue management",
+      "instructions": "Use Owletto MCP tools for Jira API access (issues, projects, boards)."
+    },
+    {
+      "id": "sentry",
+      "name": "Sentry",
+      "description": "Error tracking and performance monitoring",
+      "instructions": "Use Owletto MCP tools for Sentry API access (issues, events, releases)."
+    },
+    {
+      "id": "microsoft-365",
+      "name": "Microsoft 365",
+      "description": "Outlook, OneDrive, and Teams integration",
+      "instructions": "Use Owletto MCP tools for Microsoft 365 API access (Mail, Calendar, Files, Teams)."
+    },
+    {
+      "id": "spotify",
+      "name": "Spotify",
+      "description": "Music playback, playlists, and library",
+      "instructions": "Use Owletto MCP tools for Spotify API access (player, playlists, library, search)."
+    },
+    {
+      "id": "groq",
+      "name": "Groq",
+      "description": "Fast LLM inference via Groq",
+      "providers": [
+        {
+          "displayName": "Groq",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=groq.com&sz=128",
+          "envVarName": "GROQ_API_KEY",
+          "upstreamBaseUrl": "https://api.groq.com/openai",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://console.groq.com/keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Groq Console</a>",
+          "apiKeyPlaceholder": "gsk_...",
+          "sdkCompat": "openai",
+          "defaultModel": "llama-3.3-70b-versatile",
+          "modelsEndpoint": "/v1/models",
+          "stt": {
+            "enabled": true,
+            "sdkCompat": "openai",
+            "transcriptionPath": "/v1/audio/transcriptions",
+            "model": "whisper-large-v3-turbo"
+          }
+        }
+      ]
+    },
+    {
+      "id": "gemini",
+      "name": "Gemini",
+      "description": "Google Gemini models",
+      "providers": [
+        {
+          "displayName": "Gemini",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=gemini.google.com&sz=128",
+          "envVarName": "GEMINI_API_KEY",
+          "upstreamBaseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://aistudio.google.com/apikey\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Google AI Studio</a>",
+          "apiKeyPlaceholder": "AIza...",
+          "sdkCompat": "openai",
+          "defaultModel": "gemini-2.0-flash",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "together-ai",
+      "name": "Together AI",
+      "description": "Open-source models hosted by Together",
+      "providers": [
+        {
+          "displayName": "Together AI",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=together.ai&sz=128",
+          "envVarName": "TOGETHER_API_KEY",
+          "upstreamBaseUrl": "https://api.together.xyz/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://api.together.ai/settings/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Together AI Dashboard</a>",
+          "apiKeyPlaceholder": "tok_...",
+          "sdkCompat": "openai",
+          "defaultModel": "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "nvidia",
+      "name": "NVIDIA NIM",
+      "description": "NVIDIA-hosted models and inference APIs",
+      "providers": [
+        {
+          "displayName": "NVIDIA NIM (free)",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=nvidia.com&sz=128",
+          "envVarName": "NVIDIA_API_KEY",
+          "upstreamBaseUrl": "https://integrate.api.nvidia.com/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://build.nvidia.com/settings/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">NVIDIA Build</a>",
+          "apiKeyPlaceholder": "nvapi-...",
+          "sdkCompat": "openai",
+          "modelsEndpoint": "/v1/models",
+          "defaultModel": "nvidia/moonshotai/kimi-k2.5"
+        }
+      ]
+    },
+    {
+      "id": "z-ai",
+      "name": "z.ai",
+      "description": "z.ai coding and reasoning models",
+      "providers": [
+        {
+          "displayName": "z.ai",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=z.ai&sz=128",
+          "envVarName": "Z_AI_API_KEY",
+          "upstreamBaseUrl": "https://api.z.ai/api/coding/paas/v4",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://z.ai/manage-apikey/apikey-list\" target=\"_blank\" class=\"text-blue-600 hover:underline\">z.ai</a>",
+          "apiKeyPlaceholder": "zai-...",
+          "sdkCompat": "openai"
+        }
+      ]
+    },
+    {
+      "id": "elevenlabs",
+      "name": "ElevenLabs",
+      "description": "Voice and speech models",
+      "providers": [
+        {
+          "displayName": "ElevenLabs",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=elevenlabs.io&sz=128",
+          "envVarName": "ELEVENLABS_API_KEY",
+          "upstreamBaseUrl": "https://api.elevenlabs.io",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://elevenlabs.io/app/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">ElevenLabs</a>",
+          "apiKeyPlaceholder": "sk_...",
+          "sdkCompat": "openai"
+        }
+      ]
+    },
+    {
+      "id": "fireworks",
+      "name": "Fireworks AI",
+      "description": "Fast inference for open-source models",
+      "providers": [
+        {
+          "displayName": "Fireworks AI",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=fireworks.ai&sz=128",
+          "envVarName": "FIREWORKS_API_KEY",
+          "upstreamBaseUrl": "https://api.fireworks.ai/inference/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://fireworks.ai/account/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Fireworks Dashboard</a>",
+          "apiKeyPlaceholder": "fw_...",
+          "sdkCompat": "openai",
+          "defaultModel": "accounts/fireworks/models/llama-v3p3-70b-instruct",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "mistral",
+      "name": "Mistral",
+      "description": "Mistral AI models",
+      "providers": [
+        {
+          "displayName": "Mistral",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=mistral.ai&sz=128",
+          "envVarName": "MISTRAL_API_KEY",
+          "upstreamBaseUrl": "https://api.mistral.ai/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://console.mistral.ai/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Mistral Console</a>",
+          "apiKeyPlaceholder": "sk-...",
+          "sdkCompat": "openai",
+          "defaultModel": "mistral-large-latest",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "deepseek",
+      "name": "DeepSeek",
+      "description": "DeepSeek reasoning and coding models",
+      "providers": [
+        {
+          "displayName": "DeepSeek",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=deepseek.com&sz=128",
+          "envVarName": "DEEPSEEK_API_KEY",
+          "upstreamBaseUrl": "https://api.deepseek.com",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://platform.deepseek.com/api_keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">DeepSeek Platform</a>",
+          "apiKeyPlaceholder": "sk-...",
+          "sdkCompat": "openai",
+          "defaultModel": "deepseek-chat",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "openrouter",
+      "name": "OpenRouter",
+      "description": "Multi-provider model router with per-user billing",
+      "providers": [
+        {
+          "displayName": "OpenRouter",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=openrouter.ai&sz=128",
+          "envVarName": "OPENROUTER_API_KEY",
+          "upstreamBaseUrl": "https://openrouter.ai/api/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://openrouter.ai/keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">OpenRouter</a>, or connect via OAuth for per-user billing",
+          "apiKeyPlaceholder": "sk-or-...",
+          "sdkCompat": "openai",
+          "defaultModel": "anthropic/claude-sonnet-4",
+          "modelsEndpoint": "/v1/models",
+          "stt": {
+            "enabled": true,
+            "sdkCompat": "openai",
+            "transcriptionPath": "/audio/transcriptions",
+            "model": "whisper-1"
+          }
+        }
+      ]
+    },
+    {
+      "id": "cerebras",
+      "name": "Cerebras",
+      "description": "Ultra-fast inference on Cerebras hardware",
+      "providers": [
+        {
+          "displayName": "Cerebras",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=cerebras.ai&sz=128",
+          "envVarName": "CEREBRAS_API_KEY",
+          "upstreamBaseUrl": "https://api.cerebras.ai/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://cloud.cerebras.ai/\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Cerebras Cloud</a>",
+          "apiKeyPlaceholder": "csk-...",
+          "sdkCompat": "openai",
+          "defaultModel": "llama-3.3-70b",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "opencode-zen",
+      "name": "OpenCode Zen",
+      "description": "Curated AI gateway with 40+ coding-optimized models",
+      "providers": [
+        {
+          "displayName": "OpenCode Zen",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=opencode.ai&sz=128",
+          "envVarName": "OPENCODE_ZEN_API_KEY",
+          "upstreamBaseUrl": "https://opencode.ai/zen/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://opencode.ai/auth\" target=\"_blank\" class=\"text-blue-600 hover:underline\">OpenCode Zen</a>",
+          "apiKeyPlaceholder": "zen-...",
+          "sdkCompat": "openai",
+          "defaultModel": "anthropic/claude-sonnet-4",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "xai",
+      "name": "xAI",
+      "description": "Grok models by xAI",
+      "providers": [
+        {
+          "displayName": "xAI",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=x.ai&sz=128",
+          "envVarName": "XAI_API_KEY",
+          "upstreamBaseUrl": "https://api.x.ai/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://console.x.ai/\" target=\"_blank\" class=\"text-blue-600 hover:underline\">xAI Console</a>",
+          "apiKeyPlaceholder": "xai-...",
+          "sdkCompat": "openai",
+          "defaultModel": "grok-3",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "perplexity",
+      "name": "Perplexity",
+      "description": "Search-augmented AI models",
+      "providers": [
+        {
+          "displayName": "Perplexity",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=perplexity.ai&sz=128",
+          "envVarName": "PERPLEXITY_API_KEY",
+          "upstreamBaseUrl": "https://api.perplexity.ai",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://www.perplexity.ai/settings/api\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Perplexity Settings</a>",
+          "apiKeyPlaceholder": "pplx-...",
+          "sdkCompat": "openai",
+          "defaultModel": "sonar-pro",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "cohere",
+      "name": "Cohere",
+      "description": "Enterprise AI with Command and Embed models",
+      "providers": [
+        {
+          "displayName": "Cohere",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=cohere.com&sz=128",
+          "envVarName": "COHERE_API_KEY",
+          "upstreamBaseUrl": "https://api.cohere.com/compatibility/v1",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://dashboard.cohere.com/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">Cohere Dashboard</a>",
+          "apiKeyPlaceholder": "co-...",
+          "sdkCompat": "openai",
+          "defaultModel": "command-r-plus",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    },
+    {
+      "id": "openai",
+      "name": "OpenAI",
+      "description": "OpenAI Models",
+      "providers": [
+        {
+          "displayName": "OpenAI",
+          "iconUrl": "https://www.google.com/s2/favicons?domain=openai.com&sz=128",
+          "envVarName": "OPENAI_API_KEY",
+          "upstreamBaseUrl": "https://api.openai.com",
+          "apiKeyInstructions": "Get your API key from <a href=\"https://platform.openai.com/api-keys\" target=\"_blank\" class=\"text-blue-600 hover:underline\">OpenAI Dashboard</a>",
+          "apiKeyPlaceholder": "sk-...",
+          "sdkCompat": "openai",
+          "defaultModel": "gpt-4o",
+          "modelsEndpoint": "/v1/models"
+        }
+      ]
+    }
+  ]
+}

package/dist/templates/.env.tmpl

@@ -0,0 +1,18 @@
+# Gateway Configuration
+GATEWAY_PORT={{GATEWAY_PORT}}
+DEPLOYMENT_MODE={{DEPLOYMENT_MODE}}
+
+# Security
+ADMIN_PASSWORD={{ADMIN_PASSWORD}}
+ENCRYPTION_KEY={{ENCRYPTION_KEY}}
+
+# Worker Network Access Control
+# Empty/unset: Complete isolation (deny all)
+# WORKER_ALLOWED_DOMAINS=*: Unrestricted access
+# WORKER_ALLOWED_DOMAINS=domains: Allowlist mode (deny by default, allow only these)
+# WORKER_DISALLOWED_DOMAINS=domains: Blocklist mode (use with WORKER_ALLOWED_DOMAINS=*)
+WORKER_ALLOWED_DOMAINS={{WORKER_ALLOWED_DOMAINS}}
+WORKER_DISALLOWED_DOMAINS={{WORKER_DISALLOWED_DOMAINS}}
+
+# CLI Version (used for image tags)
+CLI_VERSION={{CLI_VERSION}}

package/dist/templates/.gitignore.tmpl

@@ -0,0 +1,33 @@
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Generated files
+.lobu/
+data/
+
+# Workspace data
+workspaces/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Editor directories
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Node modules (if you add custom scripts)
+node_modules/

package/dist/templates/AGENTS.md.tmpl

@@ -0,0 +1 @@
+@TESTING.md

package/dist/templates/Dockerfile.worker.tmpl

@@ -0,0 +1,29 @@
+FROM ghcr.io/lobu-ai/lobu-worker-base:latest
+
+# === CUSTOMIZE BELOW THIS LINE ===
+# This Dockerfile extends the lobu worker base image with your custom tools and dependencies.
+# The same Dockerfile works for local Docker development.
+
+# Example: Add system packages
+# RUN apt-get update && apt-get install -y \
+#     postgresql-client \
+#     && rm -rf /var/lib/apt/lists/*
+
+# Example: Add Python packages
+# RUN pip install --no-cache-dir \
+#     pandas \
+#     matplotlib \
+#     requests
+
+# Example: Add Node.js packages
+# RUN bun add @octokit/rest lodash
+
+# Example: Copy custom scripts
+# COPY ./scripts /workspace/scripts
+# RUN chmod +x /workspace/scripts/*.sh
+
+# Example: Set custom environment variables
+# ENV MY_CUSTOM_VAR=value
+
+# Example: Install language runtimes
+# RUN curl -fsSL https://deno.land/install.sh | sh

package/dist/templates/README.md.tmpl

@@ -0,0 +1,94 @@
+# {{PROJECT_NAME}}
+
+Lobu instance created with `@lobu/cli` v{{CLI_VERSION}}
+
+## Quick Start
+
+Make sure you have Docker CLI installed.
+
+```bash
+# Start the services
+npx @lobu/cli run -d
+
+# View logs
+docker compose logs -f
+
+# Stop the services
+docker compose down
+```
+
+## Upgrading to Latest Version
+
+### Update Gateway and Pre-built Images
+Pull the latest images and restart services:
+```bash
+docker compose pull
+docker compose up -d
+```
+
+### Rebuild Worker (when Dockerfile.worker changes)
+If you modified your `Dockerfile.worker` or want to use the latest base image:
+```bash
+docker compose build worker
+docker compose restart gateway
+```
+
+### Update Environment Variables
+Check for new environment variables in release notes or the [Lobu documentation](https://github.com/lobu-ai/lobu):
+1. Compare your `.env` with the latest `.env.example` from the repository
+2. Add any new required variables
+3. Restart services: `docker compose restart`
+
+**Tip**: Always use `latest` tags to ensure gateway and worker versions stay in sync.
+
+## Configuration
+
+### Environment Variables
+
+Edit `.env` to configure:
+- `PUBLIC_GATEWAY_URL` - Public URL for OAuth callbacks
+- `WORKER_ALLOWED_DOMAINS` - Allowed domains for worker network access
+
+### Platform Connections
+
+Platforms (Slack, Telegram, Discord, WhatsApp, Teams) are configured through the gateway APIs. No platform-specific env vars are required in `docker-compose.yml`; manage connections against `{PUBLIC_GATEWAY_URL}/api/v1/connections` and related auth/config endpoints.
+
+### Worker Customization
+
+Edit `Dockerfile.worker` to add custom tools and dependencies.
+
+Example customizations:
+```dockerfile
+# Add system packages
+RUN apt-get update && apt-get install -y postgresql-client
+
+# Add Python packages
+RUN pip install pandas matplotlib
+
+# Add Node.js packages
+RUN bun add @octokit/rest
+```
+
+When you modify `Dockerfile.worker` or context files, rebuild the worker image:
+```bash
+docker compose build worker
+```
+
+The gateway will automatically pick up the latest worker image.
+
+## Services
+
+The docker-compose.yml defines these services:
+- **redis** - Redis cache and queue
+- **gateway** - Platform connections and worker orchestration
+- **worker** - Agent worker (build-only, spawned dynamically)
+
+## Learn More
+
+- [Lobu Documentation](https://github.com/lobu-ai/lobu)
+- [CLI Reference](https://github.com/lobu-ai/lobu/tree/main/packages/cli)
+- [Examples](https://github.com/lobu-ai/lobu/tree/main/examples)
+
+## Support
+
+- [GitHub Issues](https://github.com/lobu-ai/lobu/issues)