teleton 0.8.4 → 0.8.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -12
- package/dist/{bootstrap-NNEI3Z5H.js → bootstrap-SPDT3XBQ.js} +4 -4
- package/dist/{chunk-GHMXWAXI.js → chunk-2MZP75SH.js} +72 -202
- package/dist/chunk-35X3V6OW.js +139 -0
- package/dist/{chunk-LVTKJQ7O.js → chunk-4KURCUWD.js} +1 -1
- package/dist/{chunk-XDZDOKIF.js → chunk-5K4YDCVU.js} +1 -1
- package/dist/{chunk-LZQOX6YY.js → chunk-6U6VA2OT.js} +512 -1522
- package/dist/{chunk-5LOHRZYY.js → chunk-7ZXUUDQQ.js} +5 -5
- package/dist/{chunk-NH2CNRKJ.js → chunk-FSL2MOYK.js} +14 -3
- package/dist/{chunk-LC4TV3KL.js → chunk-GUX6ZFVF.js} +1 -1
- package/dist/{chunk-CUE4UZXR.js → chunk-KYSAHDYE.js} +2 -2
- package/dist/{chunk-C4NKJT2Z.js → chunk-L3LPVF4Z.js} +1 -1
- package/dist/{chunk-EYWNOHMJ.js → chunk-L653KKCR.js} +1 -0
- package/dist/{chunk-ALKAAG4O.js → chunk-LD24DWWE.js} +4 -4
- package/dist/{chunk-UMUONAD6.js → chunk-LM6AL6LN.js} +2413 -861
- package/dist/{chunk-JROBTXWY.js → chunk-M6M4DCDU.js} +36 -2
- package/dist/{chunk-35MX4ZUI.js → chunk-PK3TVFBT.js} +2 -2
- package/dist/{chunk-G7PCW63M.js → chunk-Z63KUQX4.js} +29 -5
- package/dist/cli/index.js +28 -15
- package/dist/{client-5KD25NOP.js → client-G62EZT6U.js} +3 -3
- package/dist/harden-permissions-6BLHRCQJ.js +100 -0
- package/dist/index.js +14 -13
- package/dist/{local-IHKJFQJS.js → local-HQ3UJ7KR.js} +2 -2
- package/dist/{memory-QMJRM3XJ.js → memory-BJH724PQ.js} +6 -5
- package/dist/{memory-hook-VUNWZ3NY.js → memory-hook-LUAKTXU5.js} +5 -5
- package/dist/{migrate-5VBAP52B.js → migrate-C4LBLOZH.js} +6 -5
- package/dist/{paths-XA2RJH4S.js → paths-WMVV7ZAJ.js} +1 -1
- package/dist/{server-WWGVDFPW.js → server-4J56HS62.js} +8 -14
- package/dist/{server-AJCOURH7.js → server-I6TYJ36S.js} +7 -14
- package/dist/{setup-server-VDY64CWW.js → setup-server-VJ3MGUSM.js} +16 -17
- package/dist/{store-BY7S6IFN.js → store-2IGAMTES.js} +7 -6
- package/dist/{task-dependency-resolver-L6UUMTHK.js → task-dependency-resolver-CQ432Z7J.js} +1 -1
- package/dist/{task-executor-XBNJLUCS.js → task-executor-JELRREUV.js} +1 -1
- package/dist/{tool-index-FTERJSZK.js → tool-index-XPCMWBYY.js} +4 -4
- package/dist/{transcript-IM7G25OS.js → transcript-OEO3HA4Z.js} +2 -2
- package/dist/web/assets/{index-BfYCdwLI.js → index-Dn5ZH1Y6.js} +13 -13
- package/dist/web/assets/{index.es-DitvF-9H.js → index.es-eSR4Qv6s.js} +1 -1
- package/dist/web/index.html +1 -1
- package/package.json +2 -6
- package/src/templates/HEARTBEAT.md +5 -0
package/README.md
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
<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
|
|
18
|
+
<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 135+ built-in tools, supports 15 LLM providers, and exposes a Plugin SDK so you can build your own tools on top of the platform.</p>
|
|
19
19
|
|
|
20
20
|
### Key Highlights
|
|
21
21
|
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
<tr>
|
|
29
29
|
<td align="center"><br><b><ins>TON Blockchain</ins></b><br>Wallet, jettons, DEX swaps, DNS, NFTs<br><br></td>
|
|
30
30
|
<td align="center"><br><b><ins>Persistent Memory</ins></b><br>Hybrid RAG, vector + keyword, auto-compaction<br><br></td>
|
|
31
|
-
<td align="center"><br><b><ins>
|
|
31
|
+
<td align="center"><br><b><ins>135+ Built-in Tools</ins></b><br>Messaging, media, crypto, DEX, DNS, files<br><br></td>
|
|
32
32
|
</tr>
|
|
33
33
|
<tr>
|
|
34
34
|
<td align="center"><br><b><ins>Plugin SDK</ins></b><br>Custom tools, isolated DBs, secrets, hooks<br><br></td>
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
|
|
46
46
|
| Category | Tools | Description |
|
|
47
47
|
| ------------- | ----- | -------------------------------------------------------------- |
|
|
48
|
-
| Telegram |
|
|
48
|
+
| Telegram | 80 | Messages, media, chats, polls, stickers, gifts, stars, stories |
|
|
49
49
|
| TON & Jettons | 15 | Wallet, send/receive, balances, prices, NFTs, DEX router |
|
|
50
50
|
| STON.fi DEX | 5 | Swap, quote, search, trending, pools |
|
|
51
51
|
| DeDust DEX | 5 | Swap, quote, pools, prices, token analytics |
|
|
@@ -55,6 +55,7 @@
|
|
|
55
55
|
| Web | 2 | Search and page extraction via Tavily |
|
|
56
56
|
| Workspace | 6 | Sandboxed file operations, path traversal protection |
|
|
57
57
|
| Exec | 4 | Shell, files, processes (off by default, admin-only) |
|
|
58
|
+
| Bot | 1 | Inline bot message sending for plugin interactions |
|
|
58
59
|
|
|
59
60
|
### Advanced Capabilities
|
|
60
61
|
|
|
@@ -77,6 +78,7 @@
|
|
|
77
78
|
| **TON Proxy** | Browse .ton domains via HTTP proxy, auto-installed |
|
|
78
79
|
| **Management API** | HTTPS control plane for remote admin, bootstrap mode, lifecycle control |
|
|
79
80
|
| **Sandboxed Workspace** | Path traversal protection, symlink detection, immutable configs |
|
|
81
|
+
| **Heartbeat** | Autonomous periodic wake-up, HEARTBEAT.md task checklist, configurable intervals |
|
|
80
82
|
|
|
81
83
|
---
|
|
82
84
|
|
|
@@ -289,16 +291,19 @@ Optional web dashboard, localhost only, token auth. Start with `teleton start --
|
|
|
289
291
|
</tr>
|
|
290
292
|
<tr>
|
|
291
293
|
<td align="center"><br><b>Memory Search</b><br>Vector + keyword hybrid<br><br></td>
|
|
292
|
-
<td align="center"><br><b>Live Logs</b><br>Real-time SSE streaming<br><br></td>
|
|
294
|
+
<td align="center"><br><b>Live Logs (in Dashboard)</b><br>Real-time SSE streaming<br><br></td>
|
|
293
295
|
<td align="center"><br><b>Workspace</b><br>File browser + editor<br><br></td>
|
|
294
296
|
<td align="center"><br><b>MCP Servers</b><br>Add, remove, configure<br><br></td>
|
|
295
297
|
</tr>
|
|
296
298
|
<tr>
|
|
297
|
-
<td align="center"><br><b>TON Proxy</b><br>Start/stop, auto-install<br><br></td>
|
|
299
|
+
<td align="center"><br><b>TON Proxy (in Config)</b><br>Start/stop, auto-install<br><br></td>
|
|
298
300
|
<td align="center"><br><b>Tasks</b><br>Schedule, dependencies, bulk<br><br></td>
|
|
299
301
|
<td align="center"><br><b>Setup Wizard</b><br>QR code + phone auth<br><br></td>
|
|
300
302
|
<td align="center"><br><b>Config</b><br>Provider switch, key validation<br><br></td>
|
|
301
303
|
</tr>
|
|
304
|
+
<tr>
|
|
305
|
+
<td align="center"><br><b>Hooks</b><br>Plugin hook registrations<br><br></td>
|
|
306
|
+
</tr>
|
|
302
307
|
</table>
|
|
303
308
|
|
|
304
309
|
Auth token is printed at startup. Stored as HttpOnly cookie for 7 days. For remote access:
|
|
@@ -437,7 +442,7 @@ The SDK provides namespaced access to core services:
|
|
|
437
442
|
| `sdk.config` | Sanitized app config (no API keys) |
|
|
438
443
|
| `sdk.pluginConfig` | Plugin-specific config from `config.yaml` |
|
|
439
444
|
| `sdk.log` | `info()`, `warn()`, `error()`, `debug()` |
|
|
440
|
-
| `sdk.on()` | Register hooks: `message:receive`, `response:before
|
|
445
|
+
| `sdk.on()` | Register hooks: `tool:before`, `tool:after`, `tool:error`, `prompt:before`, `prompt:after`, `session:start`, `session:end`, `message:receive`, `response:before`, `response:after`, `response:error`, `agent:start`, `agent:stop` |
|
|
441
446
|
|
|
442
447
|
**Lifecycle hooks**: `migrate(db)`, `start(ctx)`, `stop()`, `onMessage(event)`, `onCallbackQuery(event)`
|
|
443
448
|
|
|
@@ -452,7 +457,7 @@ The SDK provides namespaced access to core services:
|
|
|
452
457
|
| Layer | Technology |
|
|
453
458
|
|-------|------------|
|
|
454
459
|
| LLM | Multi-provider via [pi-ai](https://github.com/mariozechner/pi-ai) (15 providers: Anthropic, Claude Code, OpenAI, Google, xAI, Groq, OpenRouter, Moonshot, Mistral, Cerebras, ZAI, MiniMax, Hugging Face, Cocoon, Local) |
|
|
455
|
-
| Telegram Userbot | [GramJS](https://gram.js.org/) Layer
|
|
460
|
+
| Telegram Userbot | [GramJS](https://gram.js.org/) Layer 223 fork (MTProto) |
|
|
456
461
|
| Inline Bot | [Grammy](https://grammy.dev/) (Bot API, for deals) |
|
|
457
462
|
| Blockchain | [TON SDK](https://github.com/ton-org/ton) (W5R1 wallet) |
|
|
458
463
|
| DeFi | STON.fi SDK, DeDust SDK |
|
|
@@ -460,7 +465,6 @@ The SDK provides namespaced access to core services:
|
|
|
460
465
|
| Vector Search | [sqlite-vec](https://github.com/asg017/sqlite-vec) (cosine similarity) |
|
|
461
466
|
| Full-Text Search | SQLite FTS5 (BM25 ranking) |
|
|
462
467
|
| Embeddings | [@huggingface/transformers](https://www.npmjs.com/package/@huggingface/transformers) (local ONNX) or Voyage AI |
|
|
463
|
-
| Token Counting | [js-tiktoken](https://github.com/dqbd/tiktoken) |
|
|
464
468
|
| MCP Client | [@modelcontextprotocol/sdk](https://modelcontextprotocol.io/) (stdio + SSE + Streamable HTTP) |
|
|
465
469
|
| WebUI | [Hono](https://hono.dev/) (API) + React + Vite (frontend) |
|
|
466
470
|
| Language | TypeScript 5.7, Node.js 20+ |
|
|
@@ -473,13 +477,13 @@ src/
|
|
|
473
477
|
├── agent/ # Core agent runtime
|
|
474
478
|
│ ├── runtime.ts # Agentic loop (5 iterations, tool calling, masking, compaction)
|
|
475
479
|
│ ├── client.ts # Multi-provider LLM client
|
|
476
|
-
│ └── tools/ #
|
|
477
|
-
│ ├── register-all.ts # Central tool registration (
|
|
480
|
+
│ └── tools/ # 135+ built-in tools
|
|
481
|
+
│ ├── register-all.ts # Central tool registration (9 categories)
|
|
478
482
|
│ ├── registry.ts # Tool registry, scope filtering, provider limits
|
|
479
483
|
│ ├── module-loader.ts # Built-in module loading (deals + exec)
|
|
480
484
|
│ ├── plugin-loader.ts # External plugin discovery, validation, hot-reload
|
|
481
485
|
│ ├── mcp-loader.ts # MCP client (stdio/SSE), tool discovery, lifecycle
|
|
482
|
-
│ ├── telegram/ # Telegram operations (
|
|
486
|
+
│ ├── telegram/ # Telegram operations (80 tools)
|
|
483
487
|
│ ├── ton/ # TON blockchain + jettons + DEX router (15 tools)
|
|
484
488
|
│ ├── stonfi/ # STON.fi DEX (5 tools)
|
|
485
489
|
│ ├── dedust/ # DeDust DEX (5 tools)
|
|
@@ -549,7 +553,7 @@ src/
|
|
|
549
553
|
├── templates/ # Workspace template files (SOUL.md, etc.)
|
|
550
554
|
└── cli/ # CLI commands (setup, config, doctor, mcp)
|
|
551
555
|
|
|
552
|
-
web/ # React + Vite frontend (
|
|
556
|
+
web/ # React + Vite frontend (11 pages)
|
|
553
557
|
packages/sdk/ # Published @teleton-agent/sdk
|
|
554
558
|
```
|
|
555
559
|
|
|
@@ -5,13 +5,13 @@ import {
|
|
|
5
5
|
configExists,
|
|
6
6
|
ensureWorkspace,
|
|
7
7
|
getDefaultConfigPath
|
|
8
|
-
} from "./chunk-
|
|
9
|
-
import "./chunk-
|
|
8
|
+
} from "./chunk-FSL2MOYK.js";
|
|
9
|
+
import "./chunk-L3LPVF4Z.js";
|
|
10
10
|
import "./chunk-6OOHHJ4N.js";
|
|
11
11
|
import {
|
|
12
12
|
SHUTDOWN_TIMEOUT_MS
|
|
13
13
|
} from "./chunk-R4YSJ4EY.js";
|
|
14
|
-
import "./chunk-
|
|
14
|
+
import "./chunk-L653KKCR.js";
|
|
15
15
|
import {
|
|
16
16
|
createLogger
|
|
17
17
|
} from "./chunk-NQ6FZKCE.js";
|
|
@@ -42,7 +42,7 @@ async function startApiOnly(options) {
|
|
|
42
42
|
marketplace: null,
|
|
43
43
|
userHookEvaluator: null
|
|
44
44
|
};
|
|
45
|
-
const { ApiServer } = await import("./server-
|
|
45
|
+
const { ApiServer } = await import("./server-4J56HS62.js");
|
|
46
46
|
const apiConfig = {
|
|
47
47
|
enabled: true,
|
|
48
48
|
port: parseInt(options.apiPort || process.env.TELETON_API_PORT || "7778"),
|