teleton 0.6.0 → 0.7.0

package/README.md

@@ -12,19 +12,19 @@
 
 ---
 
-<p align="center">Teleton is an autonomous AI agent platform that operates as a real Telegram user account (not a bot). It thinks through an agentic loop with tool calling, remembers conversations across sessions with hybrid RAG, and can operate a TON wallet: send crypto, swap on DEXs, bid on domains, verify payments. All from a chat message. It ships with 114 built-in tools, supports 6 LLM providers, and exposes a Plugin SDK so you can build your own tools on top of the platform.</p>
+<p align="center">Teleton is an autonomous AI agent platform that operates as a real Telegram user account (not a bot). It thinks through an agentic loop with tool calling, remembers conversations across sessions with hybrid RAG, and natively integrates the TON blockchain: send crypto, swap on DEXs, bid on domains, verify payments - all from a chat message. It can schedule tasks to run autonomously at any time. It ships with 114 built-in tools, supports 6 LLM providers, and exposes a Plugin SDK so you can build your own tools on top of the platform.</p>
 
-	### Key Highlights
+### Key Highlights
 
-	- **Full Telegram access**: Operates as a real user via MTProto (GramJS), not a limited bot
-	- **Agentic loop**: Up to 5 iterations of tool calling per message — the agent thinks, acts, observes, and repeats
-	- **Multi-Provider LLM**: Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, OpenRouter
-	- **TON Blockchain**: Built-in W5R1 wallet, send/receive TON & jettons, swap on STON.fi and DeDust, NFTs, DNS domains
-	- **Persistent memory**: Hybrid RAG (sqlite-vec + FTS5), auto-compaction with AI summarization, daily logs
-	- **114 built-in tools**: Messaging, media, blockchain, DEX trading, deals, DNS, journaling, and more
-	- **Plugin SDK**: Extend the agent with custom tools — frozen SDK with isolated databases, secrets management, lifecycle hooks
-	- **MCP Client**: Connect external tool servers (stdio/SSE) with 2 lines of YAML — no code, no rebuild
-	- **Secure by design**: Prompt injection defense, sandboxed workspace, plugin isolation, wallet encryption
+- **Full Telegram access** - Operates as a real user via MTProto (GramJS), not a limited bot
+- **Agentic loop** - Up to 5 iterations of tool calling per message, the agent thinks, acts, observes, and repeats
+- **Multi-Provider LLM** - Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, OpenRouter
+- **TON Blockchain** - Built-in W5R1 wallet, send/receive TON & jettons, swap on STON.fi and DeDust, NFTs, DNS domains
+- **Persistent memory** - Hybrid RAG (sqlite-vec + FTS5), auto-compaction with AI summarization, daily logs
+- **114 built-in tools** - Messaging, media, blockchain, DEX trading, deals, DNS, journaling, and more
+- **Plugin SDK** - Extend the agent with custom tools, frozen SDK with isolated databases, secrets management, lifecycle hooks
+- **MCP Client** - Connect external tool servers (stdio/SSE) with 2 lines of YAML, no code, no rebuild
+- **Secure by design** - Prompt injection defense, sandboxed workspace, plugin isolation, wallet encryption
 
 ---
 
@@ -59,8 +59,8 @@
 | **Message Debouncing**  | Intelligent batching of rapid group messages (DMs are always instant)                                                       |
 | **Daily Logs**          | Automatic session summaries preserved across resets                                                                         |
 | **Multi-Policy Access** | Configurable DM/group policies (open, allowlist, pairing, disabled) with per-group module permissions                       |
-| **Tool RAG**            | Semantic tool selection — sends only the top-K most relevant tools per message (hybrid vector + FTS5, configurable `top_k`, `always_include` patterns) |
-| **MCP Client**          | Connect external MCP tool servers (stdio or SSE) — auto-discovery, namespaced tools, managed via CLI or WebUI               |
+| **Tool RAG**            | Semantic tool selection - sends only the top-K most relevant tools per message (hybrid vector + FTS5, configurable `top_k`, `always_include` patterns) |
+| **MCP Client**          | Connect external MCP tool servers (stdio or SSE) - auto-discovery, namespaced tools, managed via CLI or WebUI               |
 | **Sandboxed Workspace** | Secure file system with recursive URL decoding, symlink detection, and immutable config files                               |
 
 ---
@@ -139,7 +139,7 @@ You: /status
 Agent: [Displays uptime, model, tool count, wallet balance]
 ```
 
-> **Need more details?** See [GETTING_STARTED.md](GETTING_STARTED.md) for the full guide — admin commands, troubleshooting, workspace templates, plugins, and more.
+> **Need more details?** See [GETTING_STARTED.md](GETTING_STARTED.md) for the full guide - admin commands, troubleshooting, workspace templates, plugins, and more.
 
 ---
 
@@ -182,7 +182,7 @@ webui:                       # Optional: Web dashboard
 
 ### MCP Servers
 
-Connect external tool servers via the [Model Context Protocol](https://modelcontextprotocol.io/). No code needed — tools are auto-discovered and registered at startup.
+Connect external tool servers via the [Model Context Protocol](https://modelcontextprotocol.io/). No code needed - tools are auto-discovered and registered at startup.
 
 **Via CLI (recommended):**
 ```bash
@@ -209,7 +209,7 @@ mcp:
 
 **Via WebUI:**
 
-When the WebUI is enabled, the **MCP Servers** page lets you add/remove servers, configure environment variables (API keys), and view connection status and tool lists — all from the browser.
+When the WebUI is enabled, the **MCP Servers** page lets you add/remove servers, configure environment variables (API keys), and view connection status and tool lists - all from the browser.
 
 Tools are namespaced as `mcp_<server>_<tool>` (e.g. `mcp_filesystem_read_file`). Each server supports `scope` (always, dm-only, group-only, admin-only) and `enabled` toggle.
 
@@ -219,8 +219,8 @@ The agent has two built-in web tools powered by [Tavily](https://tavily.com/) (f
 
 | Tool | Description |
 |------|-------------|
-| `web_search` | Search the web — returns titles, URLs, content snippets, relevance scores. Supports `topic`: general, news, finance |
-| `web_fetch` | Extract readable text from a URL — articles, docs, links shared by users |
+| `web_search` | Search the web - returns titles, URLs, content snippets, relevance scores. Supports `topic`: general, news, finance |
+| `web_fetch` | Extract readable text from a URL - articles, docs, links shared by users |
 
 Both tools require a Tavily API key. Set it via CLI or config:
 
@@ -258,7 +258,7 @@ Configurable keys: `tavily_api_key`, `tonapi_key`, `telegram.bot_token`, `telegr
 
 ### Environment Variables
 
-All environment variables override the corresponding `config.yaml` value at startup — useful for Docker and CI:
+All environment variables override the corresponding `config.yaml` value at startup - useful for Docker and CI:
 
 | Variable | Description | Default |
 |----------|-------------|---------|
@@ -339,7 +339,7 @@ ssh -L 7777:localhost:7777 user@remote-server
 
 ### Workspace Files
 
-The agent's personality and rules are configured via markdown files in `~/.teleton/workspace/`. Default templates are generated during `teleton setup` — you can edit any of them to customize your agent:
+The agent's personality and rules are configured via markdown files in `~/.teleton/workspace/`. Default templates are generated during `teleton setup` - you can edit any of them to customize your agent:
 
 | File | Purpose | Mutable by Agent |
 |------|---------|-----------------|
@@ -349,7 +349,7 @@ The agent's personality and rules are configured via markdown files in `~/.telet
 | `MEMORY.md` | Persistent memory (facts, contacts, decisions) | Yes |
 | `memory/*.md` | Session summaries, daily logs (auto-generated) | Yes |
 
-> **Tip**: Templates are located in `src/templates/` if installing from source. Edit the workspace copies in `~/.teleton/workspace/` — not the source templates.
+> **Tip**: Templates are located in `src/templates/` if installing from source. Edit the workspace copies in `~/.teleton/workspace/` - not the source templates.
 
 ### Admin Commands
 
@@ -535,7 +535,7 @@ npm run format      # Prettier
 
 ### Plugins
 
-Plugins extend the agent with custom tools. Drop a `.js` file or folder in `~/.teleton/plugins/` — loaded at startup, hot-reloaded in dev mode, no rebuild needed. See [official example plugins](https://github.com/TONresistor/teleton-plugins) for complete working examples.
+Plugins extend the agent with custom tools. Drop a `.js` file or folder in `~/.teleton/plugins/` - loaded at startup, hot-reloaded in dev mode, no rebuild needed. See [official example plugins](https://github.com/TONresistor/teleton-plugins) for complete working examples.
 
 ```
 ~/.teleton/plugins/
@@ -602,12 +602,12 @@ When `tools` is a function, the SDK provides namespaced access to core services:
 | | **Moderation**: `banUser()`, `unbanUser()`, `muteUser()` |
 | | **Stars & Gifts**: `getStarsBalance()`, `sendGift()`, `getAvailableGifts()`, `getMyGifts()`, `getResaleGifts()`, `buyResaleGift()` |
 | | **Advanced**: `getMe()`, `isAvailable()`, `getRawClient()`, `setTyping()`, `sendStory()` |
-| `sdk.secrets` | `get()`, `require()`, `has()` — 3-tier resolution (env var → secrets file → plugin config) |
-| `sdk.storage` | `get()`, `set()`, `delete()`, `has()`, `clear()` — KV store with TTL support |
-| `sdk.db` | Raw `better-sqlite3` database — isolated per plugin at `~/.teleton/plugins/data/<name>.db` |
+| `sdk.secrets` | `get()`, `require()`, `has()` - 3-tier resolution (env var → secrets file → plugin config) |
+| `sdk.storage` | `get()`, `set()`, `delete()`, `has()`, `clear()` - KV store with TTL support |
+| `sdk.db` | Raw `better-sqlite3` database - isolated per plugin at `~/.teleton/plugins/data/<name>.db` |
 | `sdk.config` | Sanitized app config (no API keys exposed) |
 | `sdk.pluginConfig` | Plugin-specific config from `config.yaml` `plugins:` section |
-| `sdk.log` | `info()`, `warn()`, `error()`, `debug()` — Prefixed logger |
+| `sdk.log` | `info()`, `warn()`, `error()`, `debug()` - Prefixed logger |
 
 **Lifecycle hooks**: `migrate(db)`, `start(ctx)`, `stop()`, `onMessage(event)`, `onCallbackQuery(event)`
 

package/dist/{chunk-D5I7GBV7.js → chunk-FNV5FF35.js}

@@ -1,7 +1,6 @@
 import {
-  VOYAGE_API_URL,
-  fetchWithTimeout
-} from "./chunk-GDCODBNO.js";
+  VOYAGE_API_URL
+} from "./chunk-XBKSS6DM.js";
 import {
   EMBEDDING_CACHE_EVICTION_INTERVAL,
   EMBEDDING_CACHE_EVICTION_RATIO,
@@ -9,9 +8,15 @@ import {
   EMBEDDING_CACHE_TTL_DAYS,
   VOYAGE_BATCH_SIZE
 } from "./chunk-RO62LO6Z.js";
+import {
+  fetchWithTimeout
+} from "./chunk-VAUJSSD3.js";
 import {
   TELETON_ROOT
 } from "./chunk-EYWNOHMJ.js";
+import {
+  createLogger
+} from "./chunk-RCMD3U65.js";
 
 // src/memory/embeddings/provider.ts
 var NoopEmbeddingProvider = class {
@@ -86,18 +91,19 @@ var AnthropicEmbeddingProvider = class {
 // src/memory/embeddings/local.ts
 import { pipeline, env } from "@huggingface/transformers";
 import { join } from "path";
+var log = createLogger("Memory");
 env.cacheDir = join(TELETON_ROOT, "models");
 var extractorPromise = null;
 function getExtractor(model) {
   if (!extractorPromise) {
-    console.log(`\u{1F4E6} Loading local embedding model: ${model} (cache: ${env.cacheDir})`);
+    log.info(`Loading local embedding model: ${model} (cache: ${env.cacheDir})`);
     extractorPromise = pipeline("feature-extraction", model, {
       dtype: "fp32"
     }).then((ext) => {
-      console.log(`\u2705 Local embedding model ready`);
+      log.info(`Local embedding model ready`);
       return ext;
     }).catch((err) => {
-      console.error(`\u274C Failed to load embedding model: ${err.message}`);
+      log.error(`Failed to load embedding model: ${err.message}`);
       extractorPromise = null;
       throw err;
     });
@@ -124,8 +130,8 @@ var LocalEmbeddingProvider = class {
       await getExtractor(this.model);
       return true;
     } catch (err) {
-      console.warn(
-        `\u26A0\uFE0F Local embedding model unavailable \u2014 falling back to FTS5-only search (no vector embeddings)`
+      log.warn(
+        `Local embedding model unavailable \u2014 falling back to FTS5-only search (no vector embeddings)`
       );
       this._disabled = true;
       return false;
@@ -193,7 +199,7 @@ function deserializeEmbedding(data) {
 }
 
 // src/memory/embeddings/cached.ts
-var CachedEmbeddingProvider = class {
+var CachedEmbeddingProvider = class _CachedEmbeddingProvider {
   constructor(inner, db) {
     this.inner = inner;
     this.db = db;
@@ -204,6 +210,7 @@ var CachedEmbeddingProvider = class {
   id;
   model;
   dimensions;
+  static log = createLogger("Memory");
   hits = 0;
   misses = 0;
   ops = 0;
@@ -284,8 +291,8 @@ var CachedEmbeddingProvider = class {
     const total = this.hits + this.misses;
     if (total > 0 && total % 100 === 0) {
       const rate = (this.hits / total * 100).toFixed(0);
-      console.log(
-        `\u{1F4CA} Embedding cache: ${this.hits} hits, ${this.misses} misses (${rate}% hit rate)`
+      _CachedEmbeddingProvider.log.info(
+        `Embedding cache: ${this.hits} hits, ${this.misses} misses (${rate}% hit rate)`
       );
     }
   }
@@ -302,10 +309,12 @@ var CachedEmbeddingProvider = class {
               SELECT hash, model, provider FROM embedding_cache ORDER BY accessed_at ASC LIMIT ?
             )`
         ).run(toDelete);
-        console.log(`\u{1F9F9} Embedding cache eviction: removed ${toDelete} entries (${count} total)`);
+        _CachedEmbeddingProvider.log.info(
+          `Embedding cache eviction: removed ${toDelete} entries (${count} total)`
+        );
       }
     } catch (err) {
-      console.warn("\u26A0\uFE0F Embedding cache eviction error:", err);
+      _CachedEmbeddingProvider.log.warn({ err }, "Embedding cache eviction error");
     }
   }
 };

package/dist/chunk-LRCPA7SC.js

@@ -0,0 +1,149 @@
+// src/config/providers.ts
+var PROVIDER_REGISTRY = {
+  anthropic: {
+    id: "anthropic",
+    displayName: "Anthropic (Claude)",
+    envVar: "ANTHROPIC_API_KEY",
+    keyPrefix: "sk-ant-",
+    keyHint: "sk-ant-api03-...",
+    consoleUrl: "https://console.anthropic.com/",
+    defaultModel: "claude-opus-4-5-20251101",
+    utilityModel: "claude-3-5-haiku-20241022",
+    toolLimit: null,
+    piAiProvider: "anthropic"
+  },
+  openai: {
+    id: "openai",
+    displayName: "OpenAI (GPT-4o)",
+    envVar: "OPENAI_API_KEY",
+    keyPrefix: "sk-",
+    keyHint: "sk-proj-...",
+    consoleUrl: "https://platform.openai.com/api-keys",
+    defaultModel: "gpt-4o",
+    utilityModel: "gpt-4o-mini",
+    toolLimit: 128,
+    piAiProvider: "openai"
+  },
+  google: {
+    id: "google",
+    displayName: "Google (Gemini)",
+    envVar: "GOOGLE_API_KEY",
+    keyPrefix: null,
+    keyHint: "AIza...",
+    consoleUrl: "https://aistudio.google.com/apikey",
+    defaultModel: "gemini-2.5-flash",
+    utilityModel: "gemini-2.0-flash-lite",
+    toolLimit: 128,
+    piAiProvider: "google"
+  },
+  xai: {
+    id: "xai",
+    displayName: "xAI (Grok)",
+    envVar: "XAI_API_KEY",
+    keyPrefix: "xai-",
+    keyHint: "xai-...",
+    consoleUrl: "https://console.x.ai/",
+    defaultModel: "grok-3",
+    utilityModel: "grok-3-mini-fast",
+    toolLimit: 128,
+    piAiProvider: "xai"
+  },
+  groq: {
+    id: "groq",
+    displayName: "Groq",
+    envVar: "GROQ_API_KEY",
+    keyPrefix: "gsk_",
+    keyHint: "gsk_...",
+    consoleUrl: "https://console.groq.com/keys",
+    defaultModel: "llama-3.3-70b-versatile",
+    utilityModel: "llama-3.1-8b-instant",
+    toolLimit: 128,
+    piAiProvider: "groq"
+  },
+  openrouter: {
+    id: "openrouter",
+    displayName: "OpenRouter",
+    envVar: "OPENROUTER_API_KEY",
+    keyPrefix: "sk-or-",
+    keyHint: "sk-or-v1-...",
+    consoleUrl: "https://openrouter.ai/keys",
+    defaultModel: "anthropic/claude-opus-4.5",
+    utilityModel: "google/gemini-2.5-flash-lite",
+    toolLimit: 128,
+    piAiProvider: "openrouter"
+  },
+  moonshot: {
+    id: "moonshot",
+    displayName: "Moonshot (Kimi K2.5)",
+    envVar: "MOONSHOT_API_KEY",
+    keyPrefix: "sk-",
+    keyHint: "sk-...",
+    consoleUrl: "https://platform.moonshot.ai/",
+    defaultModel: "kimi-k2.5",
+    utilityModel: "kimi-k2.5",
+    toolLimit: 128,
+    piAiProvider: "moonshot"
+  },
+  mistral: {
+    id: "mistral",
+    displayName: "Mistral AI",
+    envVar: "MISTRAL_API_KEY",
+    keyPrefix: null,
+    keyHint: "...",
+    consoleUrl: "https://console.mistral.ai/api-keys",
+    defaultModel: "devstral-small-2507",
+    utilityModel: "ministral-8b-latest",
+    toolLimit: 128,
+    piAiProvider: "mistral"
+  },
+  cocoon: {
+    id: "cocoon",
+    displayName: "Cocoon Network (Decentralized)",
+    envVar: "",
+    keyPrefix: null,
+    keyHint: "No API key needed \u2014 pays in TON",
+    consoleUrl: "https://cocoon.network",
+    defaultModel: "Qwen/Qwen3-32B",
+    utilityModel: "Qwen/Qwen3-32B",
+    toolLimit: 128,
+    piAiProvider: "cocoon"
+  },
+  local: {
+    id: "local",
+    displayName: "Local (Ollama, vLLM, LM Studio...)",
+    envVar: "",
+    keyPrefix: null,
+    keyHint: "No API key needed",
+    consoleUrl: "",
+    defaultModel: "auto",
+    utilityModel: "auto",
+    toolLimit: 128,
+    piAiProvider: "local"
+  }
+};
+function getProviderMetadata(provider) {
+  const meta = PROVIDER_REGISTRY[provider];
+  if (!meta) {
+    throw new Error(`Unknown provider: ${provider}`);
+  }
+  return meta;
+}
+function getSupportedProviders() {
+  return Object.values(PROVIDER_REGISTRY);
+}
+function validateApiKeyFormat(provider, key) {
+  const meta = PROVIDER_REGISTRY[provider];
+  if (!meta) return `Unknown provider: ${provider}`;
+  if (provider === "cocoon" || provider === "local") return void 0;
+  if (!key || key.trim().length === 0) return "API key is required";
+  if (meta.keyPrefix && !key.startsWith(meta.keyPrefix)) {
+    return `Invalid format (should start with ${meta.keyPrefix})`;
+  }
+  return void 0;
+}
+
+export {
+  getProviderMetadata,
+  getSupportedProviders,
+  validateApiKeyFormat
+};