paperclip-plugin-telegram 0.1.0

package/README.md

@@ -0,0 +1,116 @@
+# paperclip-plugin-telegram
+
+Bidirectional Telegram integration for [Paperclip](https://github.com/paperclipai/paperclip). Push agent notifications to Telegram, receive bot commands, approve requests with inline buttons, and route forum topics to projects.
+
+Built on the Paperclip plugin SDK and the domain event bridge ([PR #909](https://github.com/paperclipai/paperclip/pull/909)).
+
+## Features
+
+- **Push notifications** on issue created, issue done, approval requested, agent error, run lifecycle
+- **Bot commands**: `/status`, `/issues`, `/agents`, `/approve`, `/help`, `/connect`
+- **Inline buttons** for approve/reject on approval notifications
+- **Inbound routing**: reply to a notification in Telegram and it becomes an issue comment in Paperclip
+- **Per-company chat routing** with `/connect` command
+- **Forum topic routing**: map Telegram topics to Paperclip projects
+- **Daily digest**: scheduled summary of agent activity
+- **MarkdownV2 formatting** with automatic plain text fallback
+
+## Setup
+
+### 1. Create a Telegram bot
+
+1. Open Telegram and chat with [@BotFather](https://t.me/BotFather)
+2. Run `/newbot` and follow the prompts
+3. Save the bot token
+
+### 2. Get your chat ID
+
+Send a message to your bot, then run:
+
+```bash
+curl "https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates"
+```
+
+Find the `chat.id` field in the response. For groups, the ID is a negative number.
+
+### 3. Install the plugin
+
+```bash
+# From your Paperclip directory
+pnpm paperclipai plugin install /path/to/paperclip-plugin-telegram
+```
+
+### 4. Configure
+
+In your Paperclip instance settings, configure:
+
+| Setting | Required | Description |
+|---------|----------|-------------|
+| `telegramBotTokenRef` | Yes | Secret reference to your bot token |
+| `defaultChatId` | Yes | Chat ID for notifications |
+| `approvalsChatId` | No | Separate chat for approvals |
+| `errorsChatId` | No | Separate chat for errors |
+| `enableCommands` | No | Enable bot commands (default: true) |
+| `enableInbound` | No | Route Telegram replies to issues (default: true) |
+| `dailyDigestEnabled` | No | Send daily activity summary |
+| `topicRouting` | No | Map forum topics to projects |
+
+### 5. Add bot to group (optional)
+
+If using a group chat:
+1. Add the bot to your Telegram group
+2. Disable privacy mode via BotFather (`/setprivacy` -> Disable) if you want the bot to see all messages
+3. Run `/connect <company-name>` in the group
+
+## How it works
+
+### Notifications (outbound)
+
+When Paperclip events fire (issue created, approval needed, agent error), the plugin formats them as Telegram messages with MarkdownV2 and sends to the configured chat.
+
+Approval notifications include inline Approve/Reject buttons. Clicking a button calls the Paperclip API directly and updates the message to show the resolution.
+
+### Commands (inbound)
+
+The bot registers commands with Telegram's command menu. Users can interact with Paperclip directly:
+
+- `/status` - overview of agents and tasks
+- `/issues` - list open issues
+- `/agents` - list agents with status
+- `/approve <id>` - approve a pending request
+- `/connect <company>` - link this chat to a Paperclip company
+
+### Reply routing
+
+When a user replies to a bot notification, the plugin looks up which Paperclip entity that notification was about and posts the reply as an issue comment. This turns Telegram threads into a natural conversation interface for Paperclip issues.
+
+## Comparison with PR #407
+
+| Feature | PR #407 | This plugin |
+|---------|---------|-------------|
+| Push notifications | Yes | Yes |
+| Receive messages | No | Yes |
+| Bot commands | No | /status, /issues, /agents, /approve |
+| Inline buttons | No | Approve/reject on approvals |
+| Reply routing | No | Replies become issue comments |
+| Topic routing | No | Forum topic = project |
+| Daily digest | No | Yes |
+| Architecture | Monorepo example | Standalone npm package |
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm typecheck
+```
+
+## License
+
+MIT
+
+## Credits
+
+This contribution was developed with AI assistance (Claude Code).
+
+Inspired by [OpenClaw's Telegram integration](https://github.com/openclaw/openclaw) (grammY, bidirectional messaging, inline buttons) and adapted for the Paperclip plugin SDK.

package/dist/acp-bridge.d.ts

@@ -0,0 +1,12 @@
+import type { PluginContext } from "@paperclipai/plugin-sdk";
+type AcpOutputEvent = {
+    sessionId: string;
+    chatId: string;
+    threadId: number;
+    text: string;
+    done?: boolean;
+};
+export declare function handleAcpCommand(ctx: PluginContext, token: string, chatId: string, args: string, messageThreadId?: number): Promise<void>;
+export declare function routeMessageToAcp(ctx: PluginContext, chatId: string, threadId: number, text: string): Promise<boolean>;
+export declare function handleAcpOutput(ctx: PluginContext, token: string, event: AcpOutputEvent): Promise<void>;
+export {};

package/dist/acp-bridge.js

@@ -0,0 +1,166 @@
+import { sendMessage, escapeMarkdownV2, sendChatAction } from "./telegram-api.js";
+export async function handleAcpCommand(ctx, token, chatId, args, messageThreadId) {
+    const parts = args.trim().split(/\s+/);
+    const subcommand = parts[0]?.toLowerCase() ?? "";
+    switch (subcommand) {
+        case "spawn":
+            await handleAcpSpawn(ctx, token, chatId, parts.slice(1).join(" "), messageThreadId);
+            break;
+        case "status":
+            await handleAcpStatus(ctx, token, chatId, messageThreadId);
+            break;
+        case "cancel":
+            await handleAcpCancel(ctx, token, chatId, messageThreadId);
+            break;
+        case "close":
+            await handleAcpClose(ctx, token, chatId, messageThreadId);
+            break;
+        default:
+            await sendMessage(ctx, token, chatId, [
+                escapeMarkdownV2("🔌") + " *ACP Commands*",
+                "",
+                `/acp spawn <agent\\-name> \\- ${escapeMarkdownV2("Start a coding agent session in this thread")}`,
+                `/acp status \\- ${escapeMarkdownV2("Show current ACP session status")}`,
+                `/acp cancel \\- ${escapeMarkdownV2("Cancel the running agent task")}`,
+                `/acp close \\- ${escapeMarkdownV2("End the ACP session and unbind this thread")}`,
+            ].join("\n"), { parseMode: "MarkdownV2", messageThreadId });
+    }
+}
+async function handleAcpSpawn(ctx, token, chatId, agentName, messageThreadId) {
+    if (!agentName.trim()) {
+        await sendMessage(ctx, token, chatId, "Usage: /acp spawn <agent-name>", {
+            messageThreadId,
+        });
+        return;
+    }
+    if (!messageThreadId) {
+        await sendMessage(ctx, token, chatId, "ACP sessions must be started inside a topic thread.", { messageThreadId });
+        return;
+    }
+    const existingBinding = await getAcpBinding(ctx, chatId, messageThreadId);
+    if (existingBinding) {
+        await sendMessage(ctx, token, chatId, `This thread already has an ACP session: \`${escapeMarkdownV2(existingBinding.sessionId)}\``, { parseMode: "MarkdownV2", messageThreadId });
+        return;
+    }
+    await sendChatAction(ctx, token, chatId);
+    const sessionId = `acp_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    await ctx.state.set({ scopeKind: "instance", stateKey: `acp_${chatId}_${messageThreadId}` }, { sessionId, agentName: agentName.trim(), boundAt: new Date().toISOString() });
+    await ctx.events.emit("acp-message", "", {
+        type: "spawn",
+        sessionId,
+        agentName: agentName.trim(),
+        chatId,
+        threadId: messageThreadId,
+    });
+    await sendMessage(ctx, token, chatId, [
+        escapeMarkdownV2("🔌") + " *ACP Session Started*",
+        "",
+        `Agent: *${escapeMarkdownV2(agentName.trim())}*`,
+        `Session: \`${escapeMarkdownV2(sessionId)}\``,
+        "",
+        escapeMarkdownV2("Send messages in this thread to interact with the agent."),
+    ].join("\n"), { parseMode: "MarkdownV2", messageThreadId });
+    ctx.logger.info("ACP session spawned", { sessionId, agentName: agentName.trim(), chatId, threadId: messageThreadId });
+}
+async function handleAcpStatus(ctx, token, chatId, messageThreadId) {
+    if (!messageThreadId) {
+        await sendMessage(ctx, token, chatId, "Run /acp status inside a thread with an active session.", {
+            messageThreadId,
+        });
+        return;
+    }
+    const binding = await getAcpBinding(ctx, chatId, messageThreadId);
+    if (!binding) {
+        await sendMessage(ctx, token, chatId, "No ACP session bound to this thread.", {
+            messageThreadId,
+        });
+        return;
+    }
+    await sendMessage(ctx, token, chatId, [
+        escapeMarkdownV2("🔌") + " *ACP Session*",
+        "",
+        `Agent: *${escapeMarkdownV2(binding.agentName)}*`,
+        `Session: \`${escapeMarkdownV2(binding.sessionId)}\``,
+        `Started: ${escapeMarkdownV2(binding.boundAt)}`,
+    ].join("\n"), { parseMode: "MarkdownV2", messageThreadId });
+}
+async function handleAcpCancel(ctx, token, chatId, messageThreadId) {
+    if (!messageThreadId) {
+        await sendMessage(ctx, token, chatId, "Run /acp cancel inside a thread with an active session.", {
+            messageThreadId,
+        });
+        return;
+    }
+    const binding = await getAcpBinding(ctx, chatId, messageThreadId);
+    if (!binding) {
+        await sendMessage(ctx, token, chatId, "No ACP session bound to this thread.", {
+            messageThreadId,
+        });
+        return;
+    }
+    await ctx.events.emit("acp-message", "", {
+        type: "cancel",
+        sessionId: binding.sessionId,
+        chatId,
+        threadId: messageThreadId,
+    });
+    await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("⏹")} Cancellation requested for session \`${escapeMarkdownV2(binding.sessionId)}\``, { parseMode: "MarkdownV2", messageThreadId });
+    ctx.logger.info("ACP cancel requested", { sessionId: binding.sessionId, chatId, threadId: messageThreadId });
+}
+async function handleAcpClose(ctx, token, chatId, messageThreadId) {
+    if (!messageThreadId) {
+        await sendMessage(ctx, token, chatId, "Run /acp close inside a thread with an active session.", {
+            messageThreadId,
+        });
+        return;
+    }
+    const binding = await getAcpBinding(ctx, chatId, messageThreadId);
+    if (!binding) {
+        await sendMessage(ctx, token, chatId, "No ACP session bound to this thread.", {
+            messageThreadId,
+        });
+        return;
+    }
+    await ctx.events.emit("acp-message", "", {
+        type: "close",
+        sessionId: binding.sessionId,
+        chatId,
+        threadId: messageThreadId,
+    });
+    await ctx.state.set({ scopeKind: "instance", stateKey: `acp_${chatId}_${messageThreadId}` }, null);
+    await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("🔌")} ACP session \`${escapeMarkdownV2(binding.sessionId)}\` closed\\.`, { parseMode: "MarkdownV2", messageThreadId });
+    ctx.logger.info("ACP session closed", { sessionId: binding.sessionId, chatId, threadId: messageThreadId });
+}
+export async function routeMessageToAcp(ctx, chatId, threadId, text) {
+    const binding = await getAcpBinding(ctx, chatId, threadId);
+    if (!binding)
+        return false;
+    await ctx.events.emit("acp-message", "", {
+        type: "message",
+        sessionId: binding.sessionId,
+        chatId,
+        threadId,
+        text,
+    });
+    ctx.logger.info("Routed message to ACP session", { sessionId: binding.sessionId, chatId, threadId });
+    return true;
+}
+export async function handleAcpOutput(ctx, token, event) {
+    const { chatId, threadId, text, done } = event;
+    const prefix = done
+        ? escapeMarkdownV2("✅")
+        : escapeMarkdownV2("🤖");
+    const formatted = `${prefix} ${escapeMarkdownV2(text)}`;
+    await sendMessage(ctx, token, chatId, formatted, {
+        parseMode: "MarkdownV2",
+        messageThreadId: threadId,
+    });
+}
+async function getAcpBinding(ctx, chatId, threadId) {
+    const binding = await ctx.state.get({
+        scopeKind: "instance",
+        stateKey: `acp_${chatId}_${threadId}`,
+    });
+    return binding;
+}
+//# sourceMappingURL=acp-bridge.js.map

package/dist/acp-bridge.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,10 @@
+import type { PluginContext } from "@paperclipai/plugin-sdk";
+type BotCommand = {
+    command: string;
+    description: string;
+};
+export declare const BOT_COMMANDS: BotCommand[];
+export declare function handleCommand(ctx: PluginContext, token: string, chatId: string, command: string, args: string, messageThreadId?: number, baseUrl?: string): Promise<void>;
+export declare function handleConnectTopic(ctx: PluginContext, token: string, chatId: string, args: string, messageThreadId?: number): Promise<void>;
+export declare function getTopicForProject(ctx: PluginContext, chatId: string, projectName?: string): Promise<number | undefined>;
+export {};

package/dist/commands.js

@@ -0,0 +1,212 @@
+import { sendMessage, escapeMarkdownV2, sendChatAction } from "./telegram-api.js";
+import { METRIC_NAMES } from "./constants.js";
+import { handleAcpCommand } from "./acp-bridge.js";
+export const BOT_COMMANDS = [
+    { command: "status", description: "Company health: active agents, open issues" },
+    { command: "issues", description: "List open issues (optionally by project)" },
+    { command: "agents", description: "List agents with current status" },
+    { command: "approve", description: "Approve a pending request by ID" },
+    { command: "help", description: "Show available commands" },
+    { command: "acp", description: "Manage ACP coding agent sessions (spawn, status, cancel, close)" },
+];
+export async function handleCommand(ctx, token, chatId, command, args, messageThreadId, baseUrl) {
+    await ctx.metrics.write(METRIC_NAMES.commandsHandled, 1);
+    switch (command) {
+        case "status":
+            await handleStatus(ctx, token, chatId, messageThreadId);
+            break;
+        case "issues":
+            await handleIssues(ctx, token, chatId, args, messageThreadId);
+            break;
+        case "agents":
+            await handleAgents(ctx, token, chatId, messageThreadId);
+            break;
+        case "approve":
+            await handleApprove(ctx, token, chatId, args, messageThreadId, baseUrl);
+            break;
+        case "help":
+            await handleHelp(ctx, token, chatId, messageThreadId);
+            break;
+        case "connect":
+            await handleConnect(ctx, token, chatId, args, messageThreadId);
+            break;
+        case "connect-topic":
+            await handleConnectTopic(ctx, token, chatId, args, messageThreadId);
+            break;
+        case "acp":
+            await handleAcpCommand(ctx, token, chatId, args, messageThreadId);
+            break;
+        default:
+            await sendMessage(ctx, token, chatId, `Unknown command: /${command}. Try /help`, {
+                messageThreadId,
+            });
+    }
+}
+async function handleStatus(ctx, token, chatId, messageThreadId) {
+    await sendChatAction(ctx, token, chatId);
+    try {
+        const companyId = await resolveCompanyId(ctx, chatId);
+        const agents = await ctx.agents.list({ companyId });
+        const activeAgents = agents.filter((a) => a.status === "active");
+        const issues = await ctx.issues.list({ companyId, limit: 10 });
+        const doneIssues = issues.filter((i) => i.status === "done");
+        const lines = [
+            escapeMarkdownV2("📊") + " *Paperclip Status*",
+            "",
+            `${escapeMarkdownV2("🤖")} Active agents: *${activeAgents.length}*/${escapeMarkdownV2(String(agents.length))}`,
+            `${escapeMarkdownV2("📋")} Recent issues: *${escapeMarkdownV2(String(issues.length))}* \\(${escapeMarkdownV2(String(doneIssues.length))} done\\)`,
+        ];
+        await sendMessage(ctx, token, chatId, lines.join("\n"), {
+            parseMode: "MarkdownV2",
+            messageThreadId,
+        });
+    }
+    catch {
+        await sendMessage(ctx, token, chatId, escapeMarkdownV2("📊") + " *Paperclip Status*\n\n" + escapeMarkdownV2("Could not fetch status. Make sure this chat is linked to a company with /connect."), {
+            parseMode: "MarkdownV2",
+            messageThreadId,
+        });
+    }
+}
+async function handleIssues(ctx, token, chatId, projectFilter, messageThreadId) {
+    await sendChatAction(ctx, token, chatId);
+    try {
+        const companyId = await resolveCompanyId(ctx, chatId);
+        const issues = await ctx.issues.list({ companyId, limit: 10 });
+        const filtered = projectFilter
+            ? issues.filter((i) => {
+                const projName = i.project?.name ?? "";
+                return projName.toLowerCase().includes(projectFilter.toLowerCase());
+            })
+            : issues;
+        if (filtered.length === 0) {
+            const filter = projectFilter ? ` for project "${projectFilter}"` : "";
+            await sendMessage(ctx, token, chatId, `No issues found${filter}.`, { messageThreadId });
+            return;
+        }
+        const statusEmoji = { done: "✅", todo: "📋", in_progress: "🔄", backlog: "📥" };
+        const lines = [escapeMarkdownV2("📋") + " *Open Issues*", ""];
+        for (const issue of filtered) {
+            const emoji = statusEmoji[issue.status] ?? "📋";
+            const id = issue.identifier ?? issue.id;
+            lines.push(`${escapeMarkdownV2(emoji)} ${escapeMarkdownV2(id)} \\- ${escapeMarkdownV2(issue.title)}`);
+        }
+        await sendMessage(ctx, token, chatId, lines.join("\n"), {
+            parseMode: "MarkdownV2",
+            messageThreadId,
+        });
+    }
+    catch {
+        const filter = projectFilter ? ` for project "${projectFilter}"` : "";
+        await sendMessage(ctx, token, chatId, `Could not fetch issues${filter}. Make sure this chat is linked with /connect.`, { messageThreadId });
+    }
+}
+async function handleAgents(ctx, token, chatId, messageThreadId) {
+    await sendChatAction(ctx, token, chatId);
+    try {
+        const companyId = await resolveCompanyId(ctx, chatId);
+        const agents = await ctx.agents.list({ companyId });
+        if (agents.length === 0) {
+            await sendMessage(ctx, token, chatId, "No agents found.", { messageThreadId });
+            return;
+        }
+        const statusEmoji = { active: "🟢", error: "🔴", paused: "🟡", idle: "⚪", running: "🔵" };
+        const lines = [escapeMarkdownV2("🤖") + " *Agents*", ""];
+        for (const agent of agents) {
+            const emoji = statusEmoji[agent.status] ?? "⚪";
+            lines.push(`${escapeMarkdownV2(emoji)} *${escapeMarkdownV2(agent.name)}* \\- ${escapeMarkdownV2(agent.status)}`);
+        }
+        await sendMessage(ctx, token, chatId, lines.join("\n"), {
+            parseMode: "MarkdownV2",
+            messageThreadId,
+        });
+    }
+    catch {
+        await sendMessage(ctx, token, chatId, "Could not fetch agents. Make sure this chat is linked with /connect.", { messageThreadId });
+    }
+}
+async function handleApprove(ctx, token, chatId, approvalId, messageThreadId, baseUrl = "http://localhost:3100") {
+    if (!approvalId.trim()) {
+        await sendMessage(ctx, token, chatId, "Usage: /approve <approval-id>", {
+            messageThreadId,
+        });
+        return;
+    }
+    try {
+        await ctx.http.fetch(`${baseUrl}/api/approvals/${approvalId.trim()}/approve`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ decidedByUserId: `telegram:${chatId}` }),
+        });
+        await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("✅")} *Approved*: \`${escapeMarkdownV2(approvalId.trim())}\``, { parseMode: "MarkdownV2", messageThreadId });
+    }
+    catch (err) {
+        await sendMessage(ctx, token, chatId, `Failed to approve ${approvalId}: ${err instanceof Error ? err.message : String(err)}`, { messageThreadId });
+    }
+}
+async function handleHelp(ctx, token, chatId, messageThreadId) {
+    const lines = [
+        escapeMarkdownV2("📎") + " *Paperclip Bot Commands*",
+        "",
+        ...BOT_COMMANDS.map((cmd) => `/${escapeMarkdownV2(cmd.command)} \\- ${escapeMarkdownV2(cmd.description)}`),
+        "",
+        `/${escapeMarkdownV2("connect")} \\- ${escapeMarkdownV2("Link this chat to a Paperclip company")}`,
+        `/${escapeMarkdownV2("connect-topic")} \\- ${escapeMarkdownV2("Map a project to a forum topic")}`,
+    ];
+    await sendMessage(ctx, token, chatId, lines.join("\n"), {
+        parseMode: "MarkdownV2",
+        messageThreadId,
+    });
+}
+async function handleConnect(ctx, token, chatId, companyName, messageThreadId) {
+    if (!companyName.trim()) {
+        await sendMessage(ctx, token, chatId, "Usage: /connect <company-name>", {
+            messageThreadId,
+        });
+        return;
+    }
+    await ctx.state.set({ scopeKind: "instance", stateKey: `chat_${chatId}` }, { companyName: companyName.trim(), linkedAt: new Date().toISOString() });
+    await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("🔗")} ${escapeMarkdownV2("Linked this chat to company:")} *${escapeMarkdownV2(companyName.trim())}*`, { parseMode: "MarkdownV2", messageThreadId });
+    ctx.logger.info("Chat linked to company", { chatId, companyName: companyName.trim() });
+}
+export async function handleConnectTopic(ctx, token, chatId, args, messageThreadId) {
+    const parts = args.trim().split(/\s+/);
+    if (parts.length < 2) {
+        await sendMessage(ctx, token, chatId, "Usage: /connect\\-topic <project\\-name> <topic\\-id>", {
+            parseMode: "MarkdownV2",
+            messageThreadId,
+        });
+        return;
+    }
+    const topicId = parts.pop();
+    const projectName = parts.join(" ");
+    const existing = (await ctx.state.get({
+        scopeKind: "instance",
+        stateKey: `topic-map-${chatId}`,
+    }));
+    const topicMap = existing ?? {};
+    topicMap[projectName] = topicId;
+    await ctx.state.set({ scopeKind: "instance", stateKey: `topic-map-${chatId}` }, topicMap);
+    await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("🔗")} ${escapeMarkdownV2(`Mapped project "${projectName}" to topic ${topicId}`)}`, { parseMode: "MarkdownV2", messageThreadId });
+    ctx.logger.info("Topic mapped", { chatId, projectName, topicId });
+}
+export async function getTopicForProject(ctx, chatId, projectName) {
+    if (!projectName)
+        return undefined;
+    const topicMap = (await ctx.state.get({
+        scopeKind: "instance",
+        stateKey: `topic-map-${chatId}`,
+    }));
+    if (!topicMap)
+        return undefined;
+    const topicId = topicMap[projectName];
+    return topicId ? Number(topicId) : undefined;
+}
+async function resolveCompanyId(ctx, chatId) {
+    const mapping = await ctx.state.get({
+        scopeKind: "instance",
+        stateKey: `chat_${chatId}`,
+    });
+    return mapping?.companyName ?? chatId;
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,24 @@
+export declare const PLUGIN_ID = "paperclip-plugin-telegram";
+export declare const PLUGIN_VERSION = "0.1.0";
+export declare const DEFAULT_CONFIG: {
+    readonly telegramBotTokenRef: "";
+    readonly defaultChatId: "";
+    readonly approvalsChatId: "";
+    readonly errorsChatId: "";
+    readonly paperclipBaseUrl: "http://localhost:3100";
+    readonly notifyOnIssueCreated: true;
+    readonly notifyOnIssueDone: true;
+    readonly notifyOnApprovalCreated: true;
+    readonly notifyOnAgentError: true;
+    readonly enableCommands: true;
+    readonly enableInbound: true;
+    readonly dailyDigestEnabled: false;
+    readonly dailyDigestTime: "09:00";
+    readonly topicRouting: false;
+};
+export declare const METRIC_NAMES: {
+    readonly sent: "telegram_notifications_sent";
+    readonly failed: "telegram_notification_failures";
+    readonly commandsHandled: "telegram_commands_handled";
+    readonly inboundRouted: "telegram_inbound_routed";
+};

package/dist/constants.js

@@ -0,0 +1,25 @@
+export const PLUGIN_ID = "paperclip-plugin-telegram";
+export const PLUGIN_VERSION = "0.1.0";
+export const DEFAULT_CONFIG = {
+    telegramBotTokenRef: "",
+    defaultChatId: "",
+    approvalsChatId: "",
+    errorsChatId: "",
+    paperclipBaseUrl: "http://localhost:3100",
+    notifyOnIssueCreated: true,
+    notifyOnIssueDone: true,
+    notifyOnApprovalCreated: true,
+    notifyOnAgentError: true,
+    enableCommands: true,
+    enableInbound: true,
+    dailyDigestEnabled: false,
+    dailyDigestTime: "09:00",
+    topicRouting: false,
+};
+export const METRIC_NAMES = {
+    sent: "telegram_notifications_sent",
+    failed: "telegram_notification_failures",
+    commandsHandled: "telegram_commands_handled",
+    inboundRouted: "telegram_inbound_routed",
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,2BAA2B,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,mBAAmB,EAAE,EAAE;IACvB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,uBAAuB;IACzC,oBAAoB,EAAE,IAAI;IAC1B,iBAAiB,EAAE,IAAI;IACvB,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,KAAK;IACzB,eAAe,EAAE,OAAO;IACxB,YAAY,EAAE,KAAK;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,6BAA6B;IACnC,MAAM,EAAE,gCAAgC;IACxC,eAAe,EAAE,2BAA2B;IAC5C,aAAa,EAAE,yBAAyB;CAChC,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,13 @@
+import type { PluginEvent } from "@paperclipai/plugin-sdk";
+import type { SendMessageOptions } from "./telegram-api.js";
+type FormattedMessage = {
+    text: string;
+    options: SendMessageOptions;
+};
+export declare function formatIssueCreated(event: PluginEvent): FormattedMessage;
+export declare function formatIssueDone(event: PluginEvent): FormattedMessage;
+export declare function formatApprovalCreated(event: PluginEvent): FormattedMessage;
+export declare function formatAgentError(event: PluginEvent): FormattedMessage;
+export declare function formatAgentRunStarted(event: PluginEvent): FormattedMessage;
+export declare function formatAgentRunFinished(event: PluginEvent): FormattedMessage;
+export {};