@shuyhere/takotako 0.0.1 → 0.0.21

package/dist/tools/message.d.ts

@@ -9,6 +9,11 @@
  *
  * This is the tool for all messaging and channel management operations.
  * Do NOT confuse with skill-creator (which creates skills) or agents_add (which creates agents).
+ *
+ * Target resolution:
+ * - Pass "current" (or omit target) on a "send" action to reply in the
+ *   same channel/chat the agent is currently active in. The channel ID
+ *   is resolved from the session's ToolContext (ctx.channelTarget).
  */
 import type { Tool } from './tool.js';
 import type { DiscordChannel } from '../channels/discord.js';
@@ -16,9 +21,14 @@ import type { TelegramChannel } from '../channels/telegram.js';
 export interface MessageToolDeps {
     discord?: DiscordChannel;
     telegram?: TelegramChannel;
+    /** Resolve the correct Discord channel for a given agentId at call time. */
+    resolveDiscord?: (agentId?: string) => DiscordChannel | undefined;
+    /** Resolve the correct Telegram channel for a given agentId at call time. */
+    resolveTelegram?: (agentId?: string) => TelegramChannel | undefined;
 }
 /**
  * Create the message tool bound to channel adapters.
+ * Supports per-agent channel resolution via resolveDiscord/resolveTelegram.
  */
 export declare function createMessageTools(deps: MessageToolDeps): Tool[];
 //# sourceMappingURL=message.d.ts.map

package/dist/tools/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,EAAE,CAiNhE"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/tools/message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAClE,6EAA6E;IAC7E,eAAe,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;CACrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,EAAE,CA+PhE"}

package/dist/tools/message.js

@@ -9,12 +9,23 @@
  *
  * This is the tool for all messaging and channel management operations.
  * Do NOT confuse with skill-creator (which creates skills) or agents_add (which creates agents).
+ *
+ * Target resolution:
+ * - Pass "current" (or omit target) on a "send" action to reply in the
+ *   same channel/chat the agent is currently active in. The channel ID
+ *   is resolved from the session's ToolContext (ctx.channelTarget).
  */
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
 /**
  * Create the message tool bound to channel adapters.
+ * Supports per-agent channel resolution via resolveDiscord/resolveTelegram.
  */
 export function createMessageTools(deps) {
-    const { discord, telegram } = deps;
+    const { resolveDiscord, resolveTelegram } = deps;
+    // Fallback to static channels if resolvers not provided
+    const getDiscord = (agentId) => resolveDiscord ? resolveDiscord(agentId) : deps.discord;
+    const getTelegram = (agentId) => resolveTelegram ? resolveTelegram(agentId) : deps.telegram;
     const messageTool = {
         name: 'message',
         description: 'Send messages and manage channels on Discord and Telegram. Use this for all messaging operations: sending messages, creating/editing/deleting Discord channels, creating threads, and reacting to messages. This is NOT for creating agents (use agents_add) or skills (use skill-creator).',
@@ -41,12 +52,16 @@ export function createMessageTools(deps) {
                 },
                 target: {
                     type: 'string',
-                    description: 'Channel ID, chat ID, or guild ID (depends on action)',
+                    description: 'Channel ID, chat ID, or guild ID (depends on action). Use "current" to send to the channel this agent is currently active in.',
                 },
                 message: {
                     type: 'string',
                     description: 'Message content to send (for "send" action)',
                 },
+                media: {
+                    type: 'string',
+                    description: 'Optional media path or URL to attach (Discord send only)',
+                },
                 name: {
                     type: 'string',
                     description: 'Name for new channel or thread (for "channel-create" and "thread-create")',
@@ -74,34 +89,67 @@ export function createMessageTools(deps) {
             },
             required: ['action', 'platform'],
         },
-        async execute(params, _ctx) {
+        async execute(params, ctx) {
             const p = params;
+            // Resolve "current" target → use the session's active channel
+            const resolveTarget = (t) => {
+                if (!t || t === 'current')
+                    return ctx.channelTarget;
+                return t;
+            };
+            // Resolve per-agent channels at call time using ctx.agentId
+            const discord = getDiscord(ctx.agentId);
+            const telegram = getTelegram(ctx.agentId);
             // Validate platform availability
             if (p.platform === 'discord' && !discord) {
-                return { output: '', success: false, error: 'Discord channel is not configured or connected.' };
+                return { output: '', success: false, error: 'Discord channel is not configured or connected for this agent.' };
             }
             if (p.platform === 'telegram' && !telegram) {
-                return { output: '', success: false, error: 'Telegram channel is not configured or connected.' };
+                return { output: '', success: false, error: 'Telegram channel is not configured or connected for this agent.' };
             }
             try {
                 switch (p.action) {
                     // ─── send ──────────────────────────────────────────────
                     case 'send': {
-                        if (!p.target)
-                            return { output: '', success: false, error: 'target (channel/chat ID) is required for send' };
-                        if (!p.message)
-                            return { output: '', success: false, error: 'message content is required for send' };
+                        const target = resolveTarget(p.target);
+                        if (!target)
+                            return { output: '', success: false, error: 'target (channel/chat ID) is required for send — or use "current" to send to the active channel' };
+                        if (!p.message && !p.media)
+                            return { output: '', success: false, error: 'message or media is required for send' };
                         if (p.platform === 'discord') {
-                            const msgId = await discord.sendToChannel(p.target, p.message);
+                            if (p.media) {
+                                const isUrl = /^https?:\/\//i.test(p.media);
+                                const attachments = [];
+                                if (isUrl) {
+                                    attachments.push({ type: 'file', url: p.media, filename: basename(new URL(p.media).pathname) || 'attachment' });
+                                }
+                                else {
+                                    const data = await readFile(p.media);
+                                    attachments.push({ type: 'file', data, filename: basename(p.media) || 'attachment' });
+                                }
+                                const msgId = await discord.sendAndGetId({
+                                    target,
+                                    content: p.message ?? '',
+                                    attachments,
+                                });
+                                return {
+                                    output: JSON.stringify({ sent: true, platform: 'discord', channelId: target, messageId: msgId, attached: true, agentId: ctx.agentId }),
+                                    success: true,
+                                };
+                            }
+                            const msgId = await discord.sendToChannel(target, p.message ?? '');
                             return {
-                                output: JSON.stringify({ sent: true, platform: 'discord', channelId: p.target, messageId: msgId }),
+                                output: JSON.stringify({ sent: true, platform: 'discord', channelId: target, messageId: msgId, agentId: ctx.agentId }),
                                 success: true,
                             };
                         }
                         else {
-                            const msgId = await telegram.sendToChat(p.target, p.message);
+                            if (p.media) {
+                                return { output: '', success: false, error: 'media attachments are currently supported for Discord only' };
+                            }
+                            const msgId = await telegram.sendToChat(target, p.message ?? '');
                             return {
-                                output: JSON.stringify({ sent: true, platform: 'telegram', chatId: p.target, messageId: msgId }),
+                                output: JSON.stringify({ sent: true, platform: 'telegram', chatId: target, messageId: msgId, agentId: ctx.agentId }),
                                 success: true,
                             };
                         }

package/dist/tools/message.js.map

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

package/dist/tools/system-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgCpH"}
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoDpH"}

package/dist/tools/system-tools.js

@@ -3,6 +3,12 @@
  *
  * Allows the agent to restart itself and deliver a post-restart note.
  */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+const RESTART_GUARD_PATH = join(homedir(), '.tako', 'restart-guard.json');
+const MIN_RESTART_INTERVAL_MS = 90_000;
 export function registerSystemTools(registry, opts) {
     registry.register({
         name: 'system_restart',
@@ -19,11 +25,30 @@ export function registerSystemTools(registry, opts) {
         execute: async (_args, ctx) => {
             const note = _args.note || 'Tako restarted.';
             const sessionKey = ctx.sessionId || null;
+            const channelId = ctx.channelTarget || null;
+            const agentId = ctx.agentId || null;
             try {
+                // Guard against restart loops caused by repeated tool calls.
+                try {
+                    if (existsSync(RESTART_GUARD_PATH)) {
+                        const raw = await readFile(RESTART_GUARD_PATH, 'utf-8');
+                        const parsed = JSON.parse(raw);
+                        const last = parsed.lastRestartAt ?? 0;
+                        const elapsed = Date.now() - last;
+                        if (elapsed < MIN_RESTART_INTERVAL_MS) {
+                            const wait = Math.ceil((MIN_RESTART_INTERVAL_MS - elapsed) / 1000);
+                            return { success: false, output: `Restart blocked by safety guard. Try again in ~${wait}s.` };
+                        }
+                    }
+                }
+                catch {
+                    // Ignore malformed guard file.
+                }
+                await writeFile(RESTART_GUARD_PATH, JSON.stringify({ lastRestartAt: Date.now() }) + '\n', { mode: 0o600 });
                 const res = await fetch(`http://${opts.gatewayBind}:${opts.gatewayPort}/restart`, {
                     method: 'POST',
                     headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ note, sessionKey }),
+                    body: JSON.stringify({ note, sessionKey, channelId, agentId }),
                 });
                 if (res.ok) {
                     return { success: true, output: `Restart initiated. Note "${note}" will be delivered after restart.` };

package/dist/tools/system-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-tools.js","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,UAAU,mBAAmB,CAAC,QAAsB,EAAE,IAAkD;IAC5G,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,6RAA6R;QAC1S,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yFAAyF;iBACvG;aACF;SACF;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAAE,GAAgB,EAAuB,EAAE;YACvF,MAAM,IAAI,GAAI,KAAK,CAAC,IAAe,IAAI,iBAAiB,CAAC;YACzD,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC;YAEzC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,UAAU,EAAE;oBAChF,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;iBAC3C,CAAC,CAAC;gBACH,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,IAAI,oCAAoC,EAAE,CAAC;gBACzG,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,2BAA2B,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC7E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5G,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"system-tools.js","sourceRoot":"","sources":["../../src/tools/system-tools.ts"],"names":[],"mappings":"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"}

package/docs/INSTALL.md

@@ -4,9 +4,9 @@ This guide covers production and local installation for Tako.
 
 ## Requirements
 
-- Node.js >= 20
-- npm >= 9
-- (Optional) Bun >= 1.0
+- Node.js >= 20 (required)
+- npm >= 9 (required)
+- Bun >= 1.0 (recommended; required for Bun-based commands)
 - Git
 
 ## 0) Environment setup (for users)
@@ -44,6 +44,8 @@ git --version
 
 ## 1) Install package
 
+Published package: `@shuyhere/takotako`
+
 ### npm
 
 ```bash
@@ -66,6 +68,7 @@ Verify:
 
 ```bash
 tako --help
+npm view @shuyhere/takotako version
 ```
 
 ## 2) First-time setup
@@ -138,7 +141,7 @@ tako status
 
 ```bash
 npm install -g @shuyhere/takotako
-# or pre-publish fallback:
+# or GitHub source fallback:
 # npm install -g github:shuyhere/tako
 ```
 

package/docs/channels.md

@@ -1,140 +1,81 @@
-# Channels
+# Channel Setup — Getting Your Bot Tokens
 
-Channels are messaging I/O adapters that connect Tako to different platforms. Multiple channels run simultaneously.
+Tako connects to Discord and Telegram through bot tokens. This guide explains how to get those tokens. Once you have them, just run `tako onboard` and paste them in when prompted.
 
-## CLI (Built-in)
+---
 
-Terminal readline interface. Always active.
+## Discord
 
-**Configuration:**
-```json
-{
-  "channels": {
-    "cli": {
-      "prompt": "tako> "
-    }
-  }
-}
-```
+### Step 1 — Create a Discord application
+
+1. Go to [https://discord.com/developers/applications](https://discord.com/developers/applications)
+2. Click **New Application** → give it a name (e.g. `Tako`)
+3. Go to the **Bot** tab → click **Add Bot**
+4. Under **Token**, click **Reset Token** → **copy it** (you'll need this in `tako onboard`)
+
+### Step 2 — Enable required intents
 
-**Features:**
-- Streaming output (chunks written to stdout in real-time)
-- `/quit` and `/exit` commands to stop
-- Serialized message handling (no overlapping executions)
+Still on the **Bot** tab, scroll down to **Privileged Gateway Intents** and enable:
 
-## TUI (Built-in)
+- ✅ `MESSAGE CONTENT INTENT` — required to read messages
+- ✅ `SERVER MEMBERS INTENT` — optional, for member info
 
-Terminal UI built with Ink/React. Attach to a running daemon or run standalone.
+### Step 3 — Invite the bot to your server
+
+1. Go to **OAuth2 → URL Generator**
+2. Under **Scopes**, check: `bot` and `applications.commands`
+3. Under **Bot Permissions**, check:
+   - Send Messages
+   - Read Messages / View Channels
+   - Read Message History
+   - Add Reactions
+   - Attach Files
+   - Embed Links
+   - Create Public Threads
+   - Send Messages in Threads
+   - Manage Channels
+   - Use Slash Commands
+4. Copy the generated URL → open it in your browser → select your server → **Authorize**
+
+### Step 4 — Run onboarding
 
-**Launch:**
 ```bash
-tako tui          # Attach to running daemon
+tako onboard
 ```
 
-**Features:**
-- Real-time streaming output
-- Image attachment support
-- Tab-completion for commands
-- Active agent display in header
-- Bot name masking for privacy
-
-## Discord (Built-in)
-
-Discord bot via discord.js.
-
-**Configuration:**
-```json
-{
-  "channels": {
-    "discord": {
-      "token": "your-bot-token",
-      "guilds": ["guild-id-1", "guild-id-2"]
-    }
-  }
-}
-```
+When prompted for a Discord bot token, paste the token you copied in Step 1.
 
-**Features:**
-- Auto-create threads for replies (reference runtime-style)
-- DM support (via Partials.Channel + Partials.Message)
-- Typing indicators (configurable via `agent.typingMode`)
-- Automatic message splitting (Discord's 2000 char limit)
-- Auto-reconnect with exponential backoff (up to 5 attempts)
-- Guild filtering (optional — respond only in specific servers)
-- Attachment extraction (images, files)
-- Sender name shown in messages: `[From: name]`
-
-**Setup:**
-1. Create a bot at [Discord Developer Portal](https://discord.com/developers/applications)
-2. Enable Message Content Intent
-3. Invite bot to your server with message permissions
-4. Set the token via `tako onboard` or `tako channels`
-
-## Telegram (Built-in)
-
-Telegram bot via grammY.
-
-**Configuration:**
-```json
-{
-  "channels": {
-    "telegram": {
-      "token": "your-bot-token",
-      "allowedUsers": ["username1", "username2"]
-    }
-  }
-}
-```
+---
 
-**Features:**
-- Long polling (non-blocking)
-- Typing indicators (configurable via `agent.typingMode`)
-- Reactions support
-- Markdown formatting with fallback to plain text
-- Max 4096 chars per message (Telegram limit)
-- User filtering (optional — respond only to specific users)
-- Supports photos, documents, audio, video attachments
-- Sender name shown in messages: `[From: name]`
+## Telegram
 
-**Setup:**
-1. Create a bot via [@BotFather](https://t.me/BotFather)
-2. Get the token
-3. Set via `tako onboard` or `tako channels`
+### Step 1 — Create a bot with BotFather
 
-## Custom Channels
+1. Open Telegram and search for **@BotFather**
+2. Send `/newbot`
+3. Follow the prompts — choose a name and username for your bot
+4. BotFather will reply with your bot token — **copy it**
 
-Implement the `Channel` interface in `src/channels/channel.ts`:
+### Step 2 — Find your Telegram user ID (for access control)
 
-```typescript
-import type { Channel, OutboundMessage, MessageHandler, InboundMessage } from './channel.js';
+Message **[@userinfobot](https://t.me/userinfobot)** on Telegram. It will reply with your numeric user ID. Keep this handy — `tako onboard` will ask for it to lock the bot to your account.
 
-export class MyChannel implements Channel {
-  id = 'my-channel';
-  private handler?: MessageHandler;
+### Step 3 — Run onboarding
 
-  async connect(): Promise<void> {
-    // Connect to your platform
-  }
+```bash
+tako onboard
+```
 
-  async disconnect(): Promise<void> {
-    // Clean up
-  }
+When prompted for a Telegram bot token, paste the token from Step 1.
 
-  async send(msg: OutboundMessage): Promise<void> {
-    // Send message to your platform
-  }
+---
 
-  onMessage(handler: MessageHandler): void {
-    this.handler = handler;
-  }
-}
-```
+## Multiple agents
 
-## Multi-Channel Routing
+Each agent (e.g. `code-agent`, `project-manager`) can have its own Discord bot. Just create a separate Discord application for each one and configure them via:
 
-When multiple channels are active, Tako routes messages independently:
+```
+/setup
+```
 
-- Each channel + author pair gets its own session
-- Sessions are keyed by `channelId:authorId`
-- The agent loop runs per-message, streaming output back through the originating channel
-- CLI streams to stdout; other channels send the complete response
+in Discord after Tako is running. See **[agent use cases in the README](../README.md#creating-agents)** for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuyhere/takotako",
-  "version": "0.0.1",
+  "version": "0.0.21",
   "description": "Agent-as-CPU OS: minimal core + pluggable skill arms",
   "type": "module",
   "main": "dist/index.js",