paperclip-plugin-telegram 0.2.0 → 0.2.2

package/src/adapter.ts

@@ -1,129 +0,0 @@
-import type { PluginContext } from "@paperclipai/plugin-sdk";
-import {
-  sendMessage,
-  editMessage as editTelegramMessage,
-  escapeMarkdownV2,
-} from "./telegram-api.js";
-import type { SendMessageOptions } from "./telegram-api.js";
-
-export type MessageRef = {
-  chatId: string;
-  threadId: string;
-  messageId: string;
-};
-
-export type ActionButton = {
-  label: string;
-  callbackData: string;
-};
-
-export type SendOpts = {
-  replyTo?: string;
-  silent?: boolean;
-};
-
-export interface PlatformAdapter {
-  platformId: string;
-  sendText(chatId: string, threadId: string | undefined, text: string, opts?: SendOpts): Promise<MessageRef>;
-  sendButtons(chatId: string, threadId: string | undefined, text: string, buttons: ActionButton[]): Promise<MessageRef>;
-  editMessage(ref: MessageRef, text: string, buttons?: ActionButton[]): Promise<void>;
-  formatAgentLabel(agentName: string): string;
-  formatMention(userId: string): string;
-  formatCodeBlock(code: string, lang?: string): string;
-}
-
-export class TelegramAdapter implements PlatformAdapter {
-  platformId = "telegram" as const;
-
-  constructor(
-    private ctx: PluginContext,
-    private botToken: string,
-  ) {}
-
-  async sendText(
-    chatId: string,
-    threadId: string | undefined,
-    text: string,
-    opts?: SendOpts,
-  ): Promise<MessageRef> {
-    const options: SendMessageOptions = {
-      parseMode: "MarkdownV2",
-    };
-    if (threadId) options.messageThreadId = Number(threadId);
-    if (opts?.replyTo) options.replyToMessageId = Number(opts.replyTo);
-    if (opts?.silent) options.disableNotification = true;
-
-    const messageId = await sendMessage(this.ctx, this.botToken, chatId, text, options);
-    return {
-      chatId,
-      threadId: threadId || "",
-      messageId: String(messageId ?? ""),
-    };
-  }
-
-  async sendButtons(
-    chatId: string,
-    threadId: string | undefined,
-    text: string,
-    buttons: ActionButton[],
-  ): Promise<MessageRef> {
-    const keyboard = [];
-    for (let i = 0; i < buttons.length; i += 2) {
-      const row = buttons.slice(i, i + 2).map((b) => ({
-        text: b.label,
-        callback_data: b.callbackData,
-      }));
-      keyboard.push(row);
-    }
-
-    const options: SendMessageOptions = {
-      parseMode: "MarkdownV2",
-      inlineKeyboard: keyboard,
-    };
-    if (threadId) options.messageThreadId = Number(threadId);
-
-    const messageId = await sendMessage(this.ctx, this.botToken, chatId, text, options);
-    return {
-      chatId,
-      threadId: threadId || "",
-      messageId: String(messageId ?? ""),
-    };
-  }
-
-  async editMessage(ref: MessageRef, text: string, buttons?: ActionButton[]): Promise<void> {
-    const keyboard = buttons
-      ? (() => {
-          const rows = [];
-          for (let i = 0; i < buttons.length; i += 2) {
-            const row = buttons.slice(i, i + 2).map((b) => ({
-              text: b.label,
-              callback_data: b.callbackData,
-            }));
-            rows.push(row);
-          }
-          return rows;
-        })()
-      : undefined;
-
-    await editTelegramMessage(
-      this.ctx,
-      this.botToken,
-      ref.chatId,
-      Number(ref.messageId),
-      text,
-      { parseMode: "MarkdownV2", inlineKeyboard: keyboard },
-    );
-  }
-
-  formatAgentLabel(agentName: string): string {
-    return `*\\[${escapeMarkdownV2(agentName)}\\]*`;
-  }
-
-  formatMention(userId: string): string {
-    return `@${escapeMarkdownV2(userId)}`;
-  }
-
-  formatCodeBlock(code: string, lang?: string): string {
-    return lang ? `\`\`\`${lang}\n${code}\n\`\`\`` : `\`\`\`\n${code}\n\`\`\``;
-  }
-}

package/src/command-registry.ts

@@ -1,482 +0,0 @@
-import type { PluginContext } from "@paperclipai/plugin-sdk";
-import { sendMessage, escapeMarkdownV2, sendChatAction } from "./telegram-api.js";
-import { METRIC_NAMES } from "./constants.js";
-
-// --- Types ---
-
-type WorkflowStepBase = {
-  id: string;
-  name?: string;
-};
-
-type FetchIssueStep = WorkflowStepBase & {
-  type: "fetch_issue";
-  issueId: string; // supports {{arg1}} template
-};
-
-type InvokeAgentStep = WorkflowStepBase & {
-  type: "invoke_agent";
-  agentId: string;
-  prompt: string; // supports {{prev.result}}, {{arg1}} etc.
-};
-
-type HttpRequestStep = WorkflowStepBase & {
-  type: "http_request";
-  url: string;
-  method: "GET" | "POST" | "PUT" | "DELETE";
-  headers?: Record<string, string>;
-  body?: string;
-};
-
-type SendMessageStep = WorkflowStepBase & {
-  type: "send_message";
-  text: string;
-};
-
-type CreateIssueStep = WorkflowStepBase & {
-  type: "create_issue";
-  title: string;
-  description?: string;
-  projectId?: string;
-};
-
-type WaitApprovalStep = WorkflowStepBase & {
-  type: "wait_approval";
-  prompt: string;
-  timeoutMs?: number;
-};
-
-type SetStateStep = WorkflowStepBase & {
-  type: "set_state";
-  key: string;
-  value: string;
-};
-
-type WorkflowStep =
-  | FetchIssueStep
-  | InvokeAgentStep
-  | HttpRequestStep
-  | SendMessageStep
-  | CreateIssueStep
-  | WaitApprovalStep
-  | SetStateStep;
-
-type CustomCommand = {
-  name: string;
-  description: string;
-  steps: WorkflowStep[];
-  createdBy: string;
-  createdAt: string;
-};
-
-type StepResult = {
-  stepId: string;
-  result: string;
-  data?: unknown;
-};
-
-// --- Built-in commands ---
-
-const BUILTIN_COMMANDS = new Set([
-  "status", "issues", "agents", "approve", "help",
-  "connect", "connect-topic", "acp", "commands",
-]);
-
-// --- Command registry ---
-
-export async function handleCommandsCommand(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  args: string,
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<void> {
-  const parts = args.trim().split(/\s+/);
-  const subcommand = parts[0]?.toLowerCase() ?? "";
-
-  switch (subcommand) {
-    case "list":
-      await listCommands(ctx, token, chatId, messageThreadId, companyId);
-      break;
-    case "import":
-      await importCommand(ctx, token, chatId, parts.slice(1).join(" "), messageThreadId, companyId);
-      break;
-    case "delete":
-      await deleteCommand(ctx, token, chatId, parts[1] ?? "", messageThreadId, companyId);
-      break;
-    case "run":
-      await runCommand(ctx, token, chatId, parts[1] ?? "", parts.slice(2), messageThreadId, companyId);
-      break;
-    default:
-      await sendMessage(ctx, token, chatId, [
-        escapeMarkdownV2("\ud83d\udee0\ufe0f") + " *Custom Commands*",
-        "",
-        `/commands list \\- ${escapeMarkdownV2("Show all custom commands")}`,
-        `/commands import <json> \\- ${escapeMarkdownV2("Import a workflow command")}`,
-        `/commands delete <name> \\- ${escapeMarkdownV2("Remove a custom command")}`,
-        `/commands run <name> [args] \\- ${escapeMarkdownV2("Execute a custom command")}`,
-      ].join("\n"), { parseMode: "MarkdownV2", messageThreadId });
-  }
-}
-
-// Check if a command is custom and run it, returns true if handled
-export async function tryCustomCommand(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  command: string,
-  argsStr: string,
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<boolean> {
-  if (BUILTIN_COMMANDS.has(command)) return false;
-
-  const resolvedCompanyId = companyId ?? chatId;
-  const commands = await getCommandRegistry(ctx, resolvedCompanyId);
-  const cmd = commands.find((c) => c.name === command);
-
-  if (!cmd) return false;
-
-  const args = argsStr.trim().split(/\s+/).filter(Boolean);
-  await executeWorkflow(ctx, token, chatId, cmd, args, messageThreadId, resolvedCompanyId);
-  return true;
-}
-
-async function listCommands(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<void> {
-  const resolvedCompanyId = companyId ?? chatId;
-  const commands = await getCommandRegistry(ctx, resolvedCompanyId);
-
-  if (commands.length === 0) {
-    await sendMessage(ctx, token, chatId, "No custom commands registered. Use /commands import to add one.", { messageThreadId });
-    return;
-  }
-
-  const lines = [
-    escapeMarkdownV2("\ud83d\udee0\ufe0f") + " *Custom Commands*",
-    "",
-  ];
-
-  for (const cmd of commands) {
-    lines.push(`/${escapeMarkdownV2(cmd.name)} \\- ${escapeMarkdownV2(cmd.description)}`);
-    lines.push(`  Steps: ${escapeMarkdownV2(String(cmd.steps.length))} \\| Created: ${escapeMarkdownV2(cmd.createdAt.split("T")[0] ?? cmd.createdAt)}`);
-  }
-
-  await sendMessage(ctx, token, chatId, lines.join("\n"), {
-    parseMode: "MarkdownV2",
-    messageThreadId,
-  });
-}
-
-async function importCommand(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  jsonStr: string,
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<void> {
-  if (!jsonStr.trim()) {
-    await sendMessage(ctx, token, chatId, "Usage: /commands import <json-definition>", { messageThreadId });
-    return;
-  }
-
-  let definition: { name: string; description: string; steps: WorkflowStep[] };
-  try {
-    definition = JSON.parse(jsonStr);
-  } catch {
-    await sendMessage(ctx, token, chatId, "Invalid JSON. Please provide a valid command definition.", { messageThreadId });
-    return;
-  }
-
-  if (!definition.name || !definition.steps || !Array.isArray(definition.steps)) {
-    await sendMessage(ctx, token, chatId, "Command definition must have 'name' and 'steps' fields.", { messageThreadId });
-    return;
-  }
-
-  if (BUILTIN_COMMANDS.has(definition.name)) {
-    await sendMessage(ctx, token, chatId, `Cannot override built-in command: /${definition.name}`, { messageThreadId });
-    return;
-  }
-
-  // Validate steps
-  for (const step of definition.steps) {
-    if (!step.type || !step.id) {
-      await sendMessage(ctx, token, chatId, "Each step must have 'type' and 'id' fields.", { messageThreadId });
-      return;
-    }
-    const validTypes = ["fetch_issue", "invoke_agent", "http_request", "send_message", "create_issue", "wait_approval", "set_state"];
-    if (!validTypes.includes(step.type)) {
-      await sendMessage(ctx, token, chatId, `Invalid step type: ${step.type}. Valid: ${validTypes.join(", ")}`, { messageThreadId });
-      return;
-    }
-  }
-
-  const resolvedCompanyId = companyId ?? chatId;
-  const commands = await getCommandRegistry(ctx, resolvedCompanyId);
-
-  // Replace existing or add new
-  const existingIdx = commands.findIndex((c) => c.name === definition.name);
-  const newCmd: CustomCommand = {
-    name: definition.name,
-    description: definition.description ?? "No description",
-    steps: definition.steps,
-    createdBy: `telegram:${chatId}`,
-    createdAt: new Date().toISOString(),
-  };
-
-  if (existingIdx >= 0) {
-    commands[existingIdx] = newCmd;
-  } else {
-    commands.push(newCmd);
-  }
-
-  await saveCommandRegistry(ctx, resolvedCompanyId, commands);
-
-  await sendMessage(
-    ctx,
-    token,
-    chatId,
-    `${escapeMarkdownV2("\u2705")} Command /${escapeMarkdownV2(definition.name)} ${existingIdx >= 0 ? "updated" : "imported"} \\(${escapeMarkdownV2(String(definition.steps.length))} steps\\)`,
-    { parseMode: "MarkdownV2", messageThreadId },
-  );
-}
-
-async function deleteCommand(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  name: string,
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<void> {
-  if (!name.trim()) {
-    await sendMessage(ctx, token, chatId, "Usage: /commands delete <name>", { messageThreadId });
-    return;
-  }
-
-  const resolvedCompanyId = companyId ?? chatId;
-  const commands = await getCommandRegistry(ctx, resolvedCompanyId);
-  const filtered = commands.filter((c) => c.name !== name);
-
-  if (filtered.length === commands.length) {
-    await sendMessage(ctx, token, chatId, `Command /${name} not found.`, { messageThreadId });
-    return;
-  }
-
-  await saveCommandRegistry(ctx, resolvedCompanyId, filtered);
-
-  await sendMessage(
-    ctx,
-    token,
-    chatId,
-    `${escapeMarkdownV2("\ud83d\uddd1\ufe0f")} Command /${escapeMarkdownV2(name)} deleted.`,
-    { parseMode: "MarkdownV2", messageThreadId },
-  );
-}
-
-async function runCommand(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  name: string,
-  args: string[],
-  messageThreadId?: number,
-  companyId?: string,
-): Promise<void> {
-  const resolvedCompanyId = companyId ?? chatId;
-  const commands = await getCommandRegistry(ctx, resolvedCompanyId);
-  const cmd = commands.find((c) => c.name === name);
-
-  if (!cmd) {
-    await sendMessage(ctx, token, chatId, `Command /${name} not found.`, { messageThreadId });
-    return;
-  }
-
-  await executeWorkflow(ctx, token, chatId, cmd, args, messageThreadId, resolvedCompanyId);
-}
-
-// --- Workflow executor ---
-
-async function executeWorkflow(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  cmd: CustomCommand,
-  args: string[],
-  messageThreadId: number | undefined,
-  companyId: string,
-): Promise<void> {
-  await sendChatAction(ctx, token, chatId);
-  await ctx.metrics.write(METRIC_NAMES.commandsExecuted, 1);
-
-  const results: StepResult[] = [];
-
-  for (const step of cmd.steps) {
-    try {
-      const result = await executeStep(ctx, token, chatId, step, args, results, messageThreadId, companyId);
-      results.push({ stepId: step.id, result: result ?? "" });
-    } catch (err) {
-      ctx.logger.error("Workflow step failed", { command: cmd.name, stepId: step.id, error: String(err) });
-      await sendMessage(
-        ctx,
-        token,
-        chatId,
-        `Step "${step.name ?? step.id}" failed: ${String(err)}`,
-        { messageThreadId },
-      );
-      return; // Stop execution on failure
-    }
-  }
-
-  ctx.logger.info("Workflow completed", { command: cmd.name, steps: results.length });
-}
-
-async function executeStep(
-  ctx: PluginContext,
-  token: string,
-  chatId: string,
-  step: WorkflowStep,
-  args: string[],
-  prevResults: StepResult[],
-  messageThreadId: number | undefined,
-  companyId: string,
-): Promise<string | null> {
-  const interpolate = (template: string): string => {
-    let result = template;
-    // Replace {{arg0}}, {{arg1}}, etc.
-    for (let i = 0; i < args.length; i++) {
-      result = result.replace(new RegExp(`\\{\\{arg${i}\\}\\}`, "g"), args[i]!);
-    }
-    result = result.replace(/\{\{args\}\}/g, args.join(" "));
-    // Replace {{prev.result}}, {{step_id.result}}
-    if (prevResults.length > 0) {
-      const lastResult = prevResults[prevResults.length - 1]!;
-      result = result.replace(/\{\{prev\.result\}\}/g, lastResult.result);
-    }
-    for (const prev of prevResults) {
-      result = result.replace(new RegExp(`\\{\\{${prev.stepId}\\.result\\}\\}`, "g"), prev.result);
-    }
-    return result;
-  };
-
-  switch (step.type) {
-    case "fetch_issue": {
-      const issueId = interpolate(step.issueId);
-      const issue = await ctx.issues.get(issueId, companyId);
-      if (!issue) return JSON.stringify({ error: "Issue not found", issueId });
-      return JSON.stringify({ id: issue.id, title: issue.title, status: issue.status });
-    }
-
-    case "invoke_agent": {
-      const prompt = interpolate(step.prompt);
-      const { runId } = await ctx.agents.invoke(step.agentId, companyId, {
-        prompt,
-        reason: `custom_command:${step.id}`,
-      });
-      return runId;
-    }
-
-    case "http_request": {
-      const url = interpolate(step.url);
-      const body = step.body ? interpolate(step.body) : undefined;
-      const res = await ctx.http.fetch(url, {
-        method: step.method,
-        headers: step.headers ? Object.fromEntries(
-          Object.entries(step.headers).map(([k, v]) => [k, interpolate(v)]),
-        ) : undefined,
-        body,
-      });
-      const data = await res.text();
-      return data;
-    }
-
-    case "send_message": {
-      const text = interpolate(step.text);
-      await sendMessage(ctx, token, chatId, text, { messageThreadId });
-      return "sent";
-    }
-
-    case "create_issue": {
-      const title = interpolate(step.title);
-      const description = step.description ? interpolate(step.description) : undefined;
-      const res = await ctx.http.fetch(
-        `${await resolveBaseUrl(ctx)}/api/issues`,
-        {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({
-            companyId,
-            title,
-            description,
-            projectId: step.projectId,
-          }),
-        },
-      );
-      const data = (await res.json()) as { id: string };
-      return data.id;
-    }
-
-    case "wait_approval": {
-      const prompt = interpolate(step.prompt);
-      const approvalId = `cmd_approval_${Date.now()}`;
-      await sendMessage(ctx, token, chatId, prompt, {
-        messageThreadId,
-        inlineKeyboard: [
-          [
-            { text: "Approve", callback_data: `cmd_approve_${approvalId}` },
-            { text: "Reject", callback_data: `cmd_reject_${approvalId}` },
-          ],
-        ],
-      });
-      // Store approval state - workflow will be continued by callback handler
-      await ctx.state.set(
-        { scopeKind: "instance", stateKey: `cmd_approval_${approvalId}` },
-        { status: "pending", createdAt: Date.now() },
-      );
-      return "awaiting_approval";
-    }
-
-    case "set_state": {
-      const key = interpolate(step.key);
-      const value = interpolate(step.value);
-      await ctx.state.set(
-        { scopeKind: "company", scopeId: companyId, stateKey: key },
-        value,
-      );
-      return value;
-    }
-
-    default:
-      return null;
-  }
-}
-
-// --- State helpers ---
-
-async function getCommandRegistry(ctx: PluginContext, companyId: string): Promise<CustomCommand[]> {
-  const commands = await ctx.state.get({
-    scopeKind: "company",
-    scopeId: companyId,
-    stateKey: `commands_${companyId}`,
-  }) as CustomCommand[] | null;
-  return commands ?? [];
-}
-
-async function saveCommandRegistry(ctx: PluginContext, companyId: string, commands: CustomCommand[]): Promise<void> {
-  await ctx.state.set(
-    { scopeKind: "company", scopeId: companyId, stateKey: `commands_${companyId}` },
-    commands,
-  );
-}
-
-async function resolveBaseUrl(ctx: PluginContext): Promise<string> {
-  const config = await ctx.config.get() as { paperclipBaseUrl?: string };
-  return config.paperclipBaseUrl ?? "http://localhost:3100";
-}