teleton 0.1.1 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Digital Resistance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,12 +1,12 @@
-# Teleton Agent
+<h1 align="center">Teleton Agent</h1>
 
-**Autonomous AI Agent for Telegram with TON Blockchain Integration**
+<p align="center"><b>Your personal AI that lives on Telegram and trades on TON</b></p>
 
-![Now in Public Beta](https://img.shields.io/badge/Now_in_Public_Beta-0088cc?style=for-the-badge&logoColor=white)
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen" alt="Node.js"></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.7-blue" alt="TypeScript"></a>
+</p>
 
 ---
 
@@ -16,13 +16,14 @@ Teleton is a production-grade autonomous AI agent that operates as a real Telegr
 
 ### Key Highlights
 
-- **True Autonomy** - Operates as a Telegram userbot with access to full API (not limited like bots)
-- **Multi-Provider LLM** - Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, OpenRouter
-- **TON Native** - Built-in W5R1 wallet, jetton swaps, DNS, and DeFi integrations
-- **Deals System** - Secure gift/TON trading with strategy enforcement and inline bot confirmations
-- **Advanced Memory** - RAG system with hybrid FTS5 + vector search, auto-compaction, daily logs
-- **121 Tools** - Telegram operations, blockchain transactions, market analysis, deals, and more
-- **Production Ready** - SQLite storage, sandboxed workspace, multi-layer security
+- **Full Telegram access**: Operates as a real user with the full API, not a limited bot
+- **Multi-Provider LLM**: Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, OpenRouter
+- **TON Blockchain**: Built-in wallet, send/receive TON, swap jettons on STON.fi and DeDust, NFT auctions
+- **Gift trading**: Buy and sell Telegram collectible gifts with real-time floor prices and strategy enforcement
+- **Persistent memory**: Remembers context across restarts with automatic context management
+- **121 tools**: Messaging, media, blockchain transactions, DEX swaps, market analysis, deals, and more
+- **Plugin system**: Drop a `.js` file in a folder and restart, no rebuild needed
+- **Secure by design**: Sandboxed workspace, immutable config, strategy rules enforced in code
 
 ---
 
@@ -114,7 +115,7 @@ The wizard will configure:
 - Access policies (DM/group response rules)
 - Admin user ID
 - TON wallet generation (W5R1 with 24-word mnemonic)
-- Workspace initialization (SOUL.md, STRATEGY.md, SECURITY.md, MEMORY.md)
+- Workspace initialization (SOUL.md, IDENTITY.md, STRATEGY.md, SECURITY.md, USER.md, BOOTSTRAP.md, MEMORY.md)
 
 Configuration files created:
 - `~/.teleton/config.yaml` - Main configuration
@@ -124,6 +125,8 @@ Configuration files created:
 
 ### 3. Start
 
+If setup completed without errors, your agent is ready to go:
+
 ```bash
 teleton start
 ```
@@ -140,11 +143,13 @@ 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.
+
 ---
 
 ## Configuration
 
-Edit `~/.teleton/config.yaml`:
+The `teleton setup` wizard generates a fully configured `~/.teleton/config.yaml` file. Manual editing is only necessary if you want to adjust settings after the initial setup.
 
 ```yaml
 agent:
@@ -183,15 +188,20 @@ telegram:
 
 ### Workspace Files
 
-The agent's personality and rules are configured via markdown files in `~/.teleton/workspace/`:
+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 |
 |------|---------|-----------------|
-| `SOUL.md` | Personality, behavior guidelines | No |
-| `STRATEGY.md` | Trading rules, pricing thresholds | No |
+| `SOUL.md` | Personality, tone, behavior guidelines | No |
+| `IDENTITY.md` | Agent name, bio, public-facing identity | No |
+| `STRATEGY.md` | Trading rules, buy/sell thresholds | No |
 | `SECURITY.md` | Security principles, threat recognition | No |
+| `USER.md` | Owner information and preferences | No |
+| `BOOTSTRAP.md` | First-run instructions (read once at startup) | No |
 | `MEMORY.md` | Persistent memory (facts, contacts, decisions) | Yes |
 
+> **Tip**: Templates are located in `src/templates/` if installing from source. Edit the workspace copies in `~/.teleton/workspace/` — not the source templates.
+
 ### Admin Commands
 
 | Command | Description |
@@ -328,30 +338,47 @@ npm run lint        # ESLint
 npm run format      # Prettier
 ```
 
-### Adding Custom Tools
-
-```typescript
-// src/agent/tools/custom/my-tool.ts
-import { Type } from "@sinclair/typebox";
-import type { Tool, ToolExecutor, ToolResult } from "../types.js";
-
-export const myTool: Tool = {
-  name: "my_custom_tool",
-  description: "Does something useful",
-  parameters: Type.Object({
-    input: Type.String({ description: "Input parameter" }),
-  }),
-};
-
-export const myToolExecutor: ToolExecutor<{ input: string }> = async (
-  params,
-  context
-): Promise<ToolResult> => {
-  return { success: true, data: { result: "..." } };
-};
-
-// Register in src/index.ts:
-// this.toolRegistry.register(myTool, myToolExecutor);
+### Plugins
+
+Teleton supports external plugins loaded from `~/.teleton/plugins/`. Drop a `.js` file or a folder with `index.js`, and it's automatically loaded at startup — no rebuild needed.
+
+```
+~/.teleton/plugins/
+├── weather.js              # Single file plugin
+└── rss-reader/
+    └── index.js            # Folder plugin
+```
+
+Each plugin exports a `tools` array:
+
+```js
+// ~/.teleton/plugins/weather.js
+export const tools = [
+  {
+    name: "weather_get",
+    description: "Get current weather for a city",
+    parameters: {
+      type: "object",
+      properties: {
+        city: { type: "string", description: "City name" }
+      },
+      required: ["city"]
+    },
+    execute: async (params, context) => {
+      const res = await fetch(`https://wttr.in/${params.city}?format=j1`);
+      const data = await res.json();
+      return { success: true, data: { temp: data.current_condition[0].temp_C } };
+    }
+  }
+];
+```
+
+The `context` object gives access to `bridge` (Telegram), `db` (SQLite), `chatId`, `senderId`, `config`, and `marketService`.
+
+At startup you'll see:
+```
+🔌 Plugin "weather.js": 1 tool registered
+✅ 122 tools loaded (1 from plugins)
 ```
 
 ---
@@ -392,4 +419,5 @@ MIT License - See [LICENSE](LICENSE) for details.
 
 - **Issues**: [GitHub Issues](https://github.com/TONresistor/teleton-agent/issues)
 - **Channel**: [@ResistanceTools](https://t.me/ResistanceTools)
+- **Group Chat**: [@ResistanceForum](https://t.me/ResistanceForum)
 - **Contact**: [@zkproof](https://t.me/zkproof)

package/dist/{chunk-XBGUNXF2.js → chunk-B2PRMXOH.js}

@@ -1,6 +1,8 @@
 // src/agent/tools/telegram/gifts/get-my-gifts.ts
 import { Type } from "@sinclair/typebox";
 import { Api } from "telegram";
+var giftCatalogCache = null;
+var CATALOG_CACHE_TTL_MS = 5 * 60 * 1e3;
 function extractEmoji(sticker) {
   if (!sticker?.attributes) return null;
   const attr = sticker.attributes.find(
@@ -61,28 +63,56 @@ NEVER dump all raw data. Keep responses natural and concise.`,
         description: "Sort by value instead of date. Default: false (sorted by date)"
       })
     )
-  })
+  }),
+  category: "data-bearing"
 };
 var telegramGetMyGiftsExecutor = async (params, context) => {
   try {
-    const { userId, viewSender, limit = 50, excludeUnsaved, excludeSaved, sortByValue = false } = params;
+    const {
+      userId,
+      viewSender,
+      limit = 50,
+      excludeUnsaved,
+      excludeSaved,
+      sortByValue = false
+    } = params;
     const gramJsClient = context.bridge.getClient().getClient();
     const targetUserId = viewSender ? context.senderId.toString() : userId;
     const peer = targetUserId ? await gramJsClient.getEntity(targetUserId) : new Api.InputPeerSelf();
-    const catalog = await gramJsClient.invoke(
-      new Api.payments.GetStarGifts({ hash: 0 })
-    );
-    const catalogMap = /* @__PURE__ */ new Map();
-    for (const catalogGift of catalog.gifts || []) {
-      const id = catalogGift.id?.toString();
-      if (id) {
-        catalogMap.set(id, {
-          limited: catalogGift.limited || false,
-          soldOut: catalogGift.soldOut || false,
-          emoji: extractEmoji(catalogGift.sticker),
-          availabilityTotal: catalogGift.availabilityTotal,
-          availabilityRemains: catalogGift.availabilityRemains
-        });
+    let catalogMap;
+    if (giftCatalogCache && Date.now() < giftCatalogCache.expiresAt) {
+      catalogMap = giftCatalogCache.map;
+    } else {
+      const prevHash = giftCatalogCache?.hash ?? 0;
+      const catalog = await gramJsClient.invoke(
+        new Api.payments.GetStarGifts({ hash: prevHash })
+      );
+      if (catalog.gifts && catalog.gifts.length > 0) {
+        catalogMap = /* @__PURE__ */ new Map();
+        for (const catalogGift of catalog.gifts) {
+          const id = catalogGift.id?.toString();
+          if (id) {
+            catalogMap.set(id, {
+              limited: catalogGift.limited || false,
+              soldOut: catalogGift.soldOut || false,
+              emoji: extractEmoji(catalogGift.sticker),
+              availabilityTotal: catalogGift.availabilityTotal,
+              availabilityRemains: catalogGift.availabilityRemains
+            });
+          }
+        }
+        giftCatalogCache = {
+          map: catalogMap,
+          hash: catalog.hash ?? 0,
+          expiresAt: Date.now() + CATALOG_CACHE_TTL_MS
+        };
+      } else {
+        catalogMap = giftCatalogCache?.map ?? /* @__PURE__ */ new Map();
+        giftCatalogCache = {
+          map: catalogMap,
+          hash: catalog.hash ?? giftCatalogCache?.hash ?? 0,
+          expiresAt: Date.now() + CATALOG_CACHE_TTL_MS
+        };
       }
     }
     const result = await gramJsClient.invoke(
@@ -123,9 +153,15 @@ var telegramGetMyGiftsExecutor = async (params, context) => {
         compactGift.num = gift.num;
         compactGift.slug = gift.slug;
         compactGift.nftLink = `t.me/nft/${gift.slug}`;
-        const modelAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributeModel");
-        const patternAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributePattern");
-        const backdropAttr = gift.attributes?.find((a) => a.className === "StarGiftAttributeBackdrop");
+        const modelAttr = gift.attributes?.find(
+          (a) => a.className === "StarGiftAttributeModel"
+        );
+        const patternAttr = gift.attributes?.find(
+          (a) => a.className === "StarGiftAttributePattern"
+        );
+        const backdropAttr = gift.attributes?.find(
+          (a) => a.className === "StarGiftAttributeBackdrop"
+        );
         compactGift.model = extractAttrSummary(modelAttr);
         compactGift.pattern = extractAttrSummary(patternAttr);
         compactGift.backdrop = extractAttrSummary(backdropAttr);
@@ -145,7 +181,9 @@ var telegramGetMyGiftsExecutor = async (params, context) => {
     const unlimited = gifts.filter((g) => !g.isLimited);
     const collectibles = gifts.filter((g) => g.isCollectible);
     const viewingLabel = viewSender ? `sender (${context.senderId})` : userId || "self";
-    console.log(`\u{1F4E6} get_my_gifts: viewing ${viewingLabel}, found ${gifts.length} gifts (${collectibles.length} collectibles)`);
+    console.log(
+      `\u{1F4E6} get_my_gifts: viewing ${viewingLabel}, found ${gifts.length} gifts (${collectibles.length} collectibles)`
+    );
     return {
       success: true,
       data: {

package/dist/{chunk-UR2LQEKR.js → chunk-E2NXSWOS.js}

@@ -241,7 +241,9 @@ var TaskStore = class {
         `Cannot add dependency: would create circular dependency (${taskId} \u2192 ${parentTaskId})`
       );
     }
-    this.db.prepare(`INSERT OR IGNORE INTO task_dependencies (task_id, depends_on_task_id) VALUES (?, ?)`).run(taskId, parentTaskId);
+    this.db.prepare(
+      `INSERT OR IGNORE INTO task_dependencies (task_id, depends_on_task_id) VALUES (?, ?)`
+    ).run(taskId, parentTaskId);
   }
   /**
    * Get all tasks that this task depends on

package/dist/{chunk-EBFMA7CL.js → chunk-LJXYESJJ.js}

@@ -17,6 +17,14 @@ var SCRAPER_SCROLL_INCREMENT_PX = 250;
 var SCRAPER_SCROLL_PADDING_PX = 500;
 var SCRAPER_MAX_SCROLL_ITERATIONS = 15;
 var SCRAPER_COLLECTION_NAV_MS = 6e4;
+var RETRY_DEFAULT_MAX_ATTEMPTS = 3;
+var RETRY_DEFAULT_BASE_DELAY_MS = 1e3;
+var RETRY_DEFAULT_MAX_DELAY_MS = 1e4;
+var RETRY_DEFAULT_TIMEOUT_MS = 15e3;
+var RETRY_BLOCKCHAIN_BASE_DELAY_MS = 2e3;
+var RETRY_BLOCKCHAIN_MAX_DELAY_MS = 15e3;
+var RETRY_BLOCKCHAIN_TIMEOUT_MS = 3e4;
+var GRAMJS_RETRY_DELAY_MS = 1e3;
 
 export {
   TTS_TIMEOUT_MS,
@@ -36,5 +44,13 @@ export {
   SCRAPER_SCROLL_INCREMENT_PX,
   SCRAPER_SCROLL_PADDING_PX,
   SCRAPER_MAX_SCROLL_ITERATIONS,
-  SCRAPER_COLLECTION_NAV_MS
+  SCRAPER_COLLECTION_NAV_MS,
+  RETRY_DEFAULT_MAX_ATTEMPTS,
+  RETRY_DEFAULT_BASE_DELAY_MS,
+  RETRY_DEFAULT_MAX_DELAY_MS,
+  RETRY_DEFAULT_TIMEOUT_MS,
+  RETRY_BLOCKCHAIN_BASE_DELAY_MS,
+  RETRY_BLOCKCHAIN_MAX_DELAY_MS,
+  RETRY_BLOCKCHAIN_TIMEOUT_MS,
+  GRAMJS_RETRY_DELAY_MS
 };

package/dist/{chunk-MPU2XS5H.js → chunk-PMX75DTX.js}

@@ -1,14 +1,16 @@
 import {
   VOYAGE_API_URL
-} from "./chunk-I6ZVPVLK.js";
+} from "./chunk-ST5CO7TV.js";
 import {
+  KNOWLEDGE_CHUNK_OVERLAP,
+  KNOWLEDGE_CHUNK_SIZE,
   SQLITE_CACHE_SIZE_KB,
   SQLITE_MMAP_SIZE,
   VOYAGE_BATCH_SIZE
-} from "./chunk-5BEHAIBQ.js";
+} from "./chunk-QMN6ZOA5.js";
 import {
   DEFAULT_FETCH_TIMEOUT_MS
-} from "./chunk-EBFMA7CL.js";
+} from "./chunk-LJXYESJJ.js";
 
 // src/memory/database.ts
 import Database from "better-sqlite3";
@@ -1121,8 +1123,8 @@ var KnowledgeIndexer = class {
   chunkMarkdown(content, path) {
     const lines = content.split("\n");
     const chunks = [];
-    const chunkSize = 500;
-    const overlap = 50;
+    const chunkSize = KNOWLEDGE_CHUNK_SIZE;
+    const overlap = KNOWLEDGE_CHUNK_OVERLAP;
     let currentChunk = "";
     let startLine = 1;
     let currentLine = 1;
@@ -1352,9 +1354,7 @@ var MessageStore = class {
   ensureChat(chatId, isGroup = false) {
     const existing = this.db.prepare(`SELECT id FROM tg_chats WHERE id = ?`).get(chatId);
     if (!existing) {
-      this.db.prepare(
-        `INSERT INTO tg_chats (id, type, is_monitored) VALUES (?, ?, 1)`
-      ).run(chatId, isGroup ? "group" : "dm");
+      this.db.prepare(`INSERT INTO tg_chats (id, type, is_monitored) VALUES (?, ?, 1)`).run(chatId, isGroup ? "group" : "dm");
     }
   }
   /**
@@ -1364,9 +1364,7 @@ var MessageStore = class {
     if (!userId) return;
     const existing = this.db.prepare(`SELECT id FROM tg_users WHERE id = ?`).get(userId);
     if (!existing) {
-      this.db.prepare(
-        `INSERT INTO tg_users (id) VALUES (?)`
-      ).run(userId);
+      this.db.prepare(`INSERT INTO tg_users (id) VALUES (?)`).run(userId);
     }
   }
   /**

package/dist/{chunk-5BEHAIBQ.js → chunk-QMN6ZOA5.js}

@@ -16,6 +16,19 @@ var COMPACTION_KEEP_RECENT = 20;
 var COMPACTION_MAX_TOKENS_RATIO = 0.75;
 var COMPACTION_SOFT_THRESHOLD_RATIO = 0.5;
 var SCRAPER_PARALLEL_WORKERS = 4;
+var PENDING_HISTORY_MAX_PER_CHAT = 50;
+var PENDING_HISTORY_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
+var DEBOUNCE_MAX_MULTIPLIER = 3;
+var DEBOUNCE_MAX_BUFFER_SIZE = 20;
+var CONTEXT_MAX_RECENT_MESSAGES = 10;
+var CONTEXT_MAX_RELEVANT_CHUNKS = 5;
+var CONTEXT_OVERFLOW_SUMMARY_MESSAGES = 15;
+var RATE_LIMIT_MAX_RETRIES = 3;
+var KNOWLEDGE_CHUNK_SIZE = 500;
+var KNOWLEDGE_CHUNK_OVERLAP = 50;
+var PAYMENT_TOLERANCE_RATIO = 0.99;
+var TELEGRAM_CONNECTION_RETRIES = 5;
+var TELEGRAM_FLOOD_SLEEP_THRESHOLD = 60;
 
 export {
   MAX_TOOL_RESULT_SIZE,
@@ -34,5 +47,18 @@ export {
   COMPACTION_KEEP_RECENT,
   COMPACTION_MAX_TOKENS_RATIO,
   COMPACTION_SOFT_THRESHOLD_RATIO,
-  SCRAPER_PARALLEL_WORKERS
+  SCRAPER_PARALLEL_WORKERS,
+  PENDING_HISTORY_MAX_PER_CHAT,
+  PENDING_HISTORY_MAX_AGE_MS,
+  DEBOUNCE_MAX_MULTIPLIER,
+  DEBOUNCE_MAX_BUFFER_SIZE,
+  CONTEXT_MAX_RECENT_MESSAGES,
+  CONTEXT_MAX_RELEVANT_CHUNKS,
+  CONTEXT_OVERFLOW_SUMMARY_MESSAGES,
+  RATE_LIMIT_MAX_RETRIES,
+  KNOWLEDGE_CHUNK_SIZE,
+  KNOWLEDGE_CHUNK_OVERLAP,
+  PAYMENT_TOLERANCE_RATIO,
+  TELEGRAM_CONNECTION_RETRIES,
+  TELEGRAM_FLOOD_SLEEP_THRESHOLD
 };

package/dist/{chunk-I6ZVPVLK.js → chunk-ST5CO7TV.js}

@@ -1,5 +1,16 @@
 // src/constants/api-endpoints.ts
 var TONAPI_BASE_URL = "https://tonapi.io/v2";
+var _tonapiKey;
+function setTonapiKey(key) {
+  _tonapiKey = key;
+}
+function tonapiHeaders() {
+  const headers = { Accept: "application/json" };
+  if (_tonapiKey) {
+    headers["Authorization"] = `Bearer ${_tonapiKey}`;
+  }
+  return headers;
+}
 var STONFI_API_BASE_URL = "https://api.ston.fi/v1";
 var GECKOTERMINAL_API_URL = "https://api.geckoterminal.com/api/v2";
 var COINGECKO_API_URL = "https://api.coingecko.com/api/v3";
@@ -10,6 +21,8 @@ var VOYAGE_API_URL = "https://api.voyageai.com/v1";
 
 export {
   TONAPI_BASE_URL,
+  setTonapiKey,
+  tonapiHeaders,
   STONFI_API_BASE_URL,
   GECKOTERMINAL_API_URL,
   COINGECKO_API_URL,