@poncho-ai/messaging 0.6.0 → 0.7.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/messaging@0.6.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/messaging
+> @poncho-ai/messaging@0.7.1 build /home/runner/work/poncho-ai/poncho-ai/packages/messaging
 > tsup src/index.ts --format esm --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 46.08 KB
-ESM ⚡️ Build success in 161ms
+ESM dist/index.js 51.09 KB
+ESM ⚡️ Build success in 67ms
 DTS Build start
-DTS ⚡️ Build success in 2515ms
-DTS dist/index.d.ts 10.53 KB
+DTS ⚡️ Build success in 5004ms
+DTS dist/index.d.ts 11.24 KB

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @poncho-ai/messaging
 
+## 0.7.1
+
+### Patch Changes
+
+- [#42](https://github.com/cesr/poncho-ai/pull/42) [`e58a984`](https://github.com/cesr/poncho-ai/commit/e58a984efaa673b649318102bbf735fb4c2f9172) Thanks [@cesr](https://github.com/cesr)! - Add continuation model and fire-and-forget subagents
+
+  **Continuation model**: Agents no longer send a synthetic `"Continue"` user message between steps. Instead, the harness injects a transient signal when needed, and the full internal message chain is preserved across continuations so the LLM never loses context. `RunInput` gains `disableSoftDeadline` and `RunResult` gains `continuationMessages`.
+
+  **Fire-and-forget subagents**: Subagents now run asynchronously in the background. `spawn_subagent` returns immediately with a subagent ID; results are delivered back to the parent conversation as a callback once the subagent completes. Subagents cannot spawn their own subagents. The web UI shows results in a collapsible disclosure and reconnects the live event stream automatically when the parent agent resumes.
+
+  **Bug fixes**:
+  - Fixed a race condition where concurrent runs on the same harness instance could assign a subagent or browser tab to the wrong parent conversation (shared `_currentRunConversationId` field replaced with per-run `ToolContext.conversationId`).
+  - Fixed Upstash KV store silently dropping large values by switching from URL-path encoding to request body format for `SET`/`SETEX` commands.
+  - Fixed empty assistant content blocks causing Anthropic `text content blocks must be non-empty` errors.
+
+  **Client**: Added `getConversationStatus()` and `waitForSubagents` option on `sendMessage()`.
+
+- Updated dependencies [[`e58a984`](https://github.com/cesr/poncho-ai/commit/e58a984efaa673b649318102bbf735fb4c2f9172)]:
+  - @poncho-ai/sdk@1.6.0
+
+## 0.7.0
+
+### Minor Changes
+
+- [`26be28a`](https://github.com/cesr/poncho-ai/commit/26be28a958f2eb27dd78225f1cf80b67b16d673d) Thanks [@cesr](https://github.com/cesr)! - Add tool approval support in Telegram via inline keyboard buttons. When the agent needs approval for a tool call, the bot sends Approve/Deny buttons to the chat. After all decisions are made, the run resumes and the response is delivered. Approvals from the web UI for Telegram conversations are also routed back to the chat.
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -71,7 +71,7 @@ interface AgentRunner {
         messages: Message[];
     }>;
     run(conversationId: string, input: {
-        task: string;
+        task?: string;
         messages: Message[];
         files?: FileAttachment[];
         metadata?: {
@@ -200,6 +200,12 @@ declare class ResendAdapter implements MessagingAdapter {
     private fetchAndDownloadAttachments;
 }
 
+interface TelegramApprovalInfo {
+    approvalId: string;
+    tool: string;
+    input: Record<string, unknown>;
+}
+type TelegramApprovalDecisionHandler = (approvalId: string, approved: boolean, chatId: string) => Promise<void>;
 interface TelegramAdapterOptions {
     botTokenEnv?: string;
     webhookSecretEnv?: string;
@@ -217,7 +223,9 @@ declare class TelegramAdapter implements MessagingAdapter {
     private readonly webhookSecretEnv;
     private readonly allowedUserIds;
     private handler;
+    private approvalDecisionHandler;
     private readonly sessionCounters;
+    private readonly approvalMessageIds;
     private lastUpdateId;
     constructor(options?: TelegramAdapterOptions);
     initialize(): Promise<void>;
@@ -227,7 +235,13 @@ declare class TelegramAdapter implements MessagingAdapter {
         files?: FileAttachment[];
     }): Promise<void>;
     indicateProcessing(threadRef: ThreadRef): Promise<() => Promise<void>>;
+    onApprovalDecision(handler: TelegramApprovalDecisionHandler): void;
+    sendApprovalRequest(chatId: string, approvals: TelegramApprovalInfo[], opts?: {
+        message_thread_id?: number;
+    }): Promise<void>;
+    updateApprovalMessage(approvalId: string, decision: "approved" | "denied", tool: string): Promise<void>;
     private handleRequest;
+    private handleCallbackQuery;
     private sessionKey;
     private extractFiles;
 }
@@ -284,4 +298,4 @@ declare function markdownToEmailHtml(text: string): string;
  */
 declare function matchesSenderPattern(sender: string, patterns: string[] | undefined): boolean;
 
-export { AgentBridge, type AgentBridgeOptions, type AgentRunner, type FileAttachment, type IncomingMessage, type IncomingMessageHandler, type MessagingAdapter, ResendAdapter, type ResendAdapterOptions, type RouteHandler, type RouteRegistrar, SlackAdapter, type SlackAdapterOptions, TelegramAdapter, type TelegramAdapterOptions, type ThreadRef, buildReplyHeaders, buildReplySubject, conversationIdFromThread, deriveRootMessageId, extractDisplayName, extractEmailAddress, markdownToEmailHtml, matchesSenderPattern, parseReferences, stripQuotedReply };
+export { AgentBridge, type AgentBridgeOptions, type AgentRunner, type FileAttachment, type IncomingMessage, type IncomingMessageHandler, type MessagingAdapter, ResendAdapter, type ResendAdapterOptions, type RouteHandler, type RouteRegistrar, SlackAdapter, type SlackAdapterOptions, TelegramAdapter, type TelegramAdapterOptions, type TelegramApprovalDecisionHandler, type TelegramApprovalInfo, type ThreadRef, buildReplyHeaders, buildReplySubject, conversationIdFromThread, deriveRootMessageId, extractDisplayName, extractEmailAddress, markdownToEmailHtml, matchesSenderPattern, parseReferences, stripQuotedReply };

package/dist/index.js

@@ -87,7 +87,7 @@ ${message.text}`;
         if (result.continuation && continuationCount < MAX_CONTINUATIONS && (stepBudget <= 0 || totalSteps < stepBudget)) {
           continuationCount++;
           console.log(`[agent-bridge] continuation ${continuationCount}/${MAX_CONTINUATIONS} for ${conversationId}`);
-          currentTask = "Continue";
+          currentTask = void 0;
           currentFiles = void 0;
           continue;
         }
@@ -1080,6 +1080,49 @@ var sendDocument = async (token, chatId, docData, opts) => {
     throw new Error(`Telegram sendDocument failed: ${result.description}`);
   }
 };
+var sendMessageWithKeyboard = async (token, chatId, text, keyboard, opts) => {
+  const body = {
+    chat_id: chatId,
+    text,
+    reply_markup: { inline_keyboard: keyboard }
+  };
+  if (opts?.reply_to_message_id) {
+    body.reply_parameters = {
+      message_id: opts.reply_to_message_id,
+      allow_sending_without_reply: true
+    };
+  }
+  if (opts?.message_thread_id) {
+    body.message_thread_id = opts.message_thread_id;
+  }
+  const result = await telegramFetch(token, "sendMessage", body);
+  if (!result.ok) {
+    throw new Error(`Telegram sendMessage (keyboard) failed: ${result.description}`);
+  }
+  const msg = result.result;
+  return msg.message_id;
+};
+var editMessageText = async (token, chatId, messageId, text, opts) => {
+  const body = {
+    chat_id: chatId,
+    message_id: messageId,
+    text
+  };
+  if (opts?.reply_markup) {
+    body.reply_markup = opts.reply_markup;
+  }
+  const result = await telegramFetch(token, "editMessageText", body);
+  if (!result.ok) {
+    throw new Error(`Telegram editMessageText failed: ${result.description}`);
+  }
+};
+var answerCallbackQuery = async (token, callbackQueryId, opts) => {
+  const body = {
+    callback_query_id: callbackQueryId
+  };
+  if (opts?.text) body.text = opts.text;
+  await telegramFetch(token, "answerCallbackQuery", body);
+};
 var sendChatAction = async (token, chatId, action) => {
   await telegramFetch(token, "sendChatAction", {
     chat_id: chatId,
@@ -1161,7 +1204,9 @@ var TelegramAdapter = class {
   webhookSecretEnv;
   allowedUserIds;
   handler;
+  approvalDecisionHandler;
   sessionCounters = /* @__PURE__ */ new Map();
+  approvalMessageIds = /* @__PURE__ */ new Map();
   lastUpdateId = 0;
   constructor(options = {}) {
     this.botTokenEnv = options.botTokenEnv ?? "TELEGRAM_BOT_TOKEN";
@@ -1233,6 +1278,72 @@ var TelegramAdapter = class {
     };
   }
   // -----------------------------------------------------------------------
+  // Approval support
+  // -----------------------------------------------------------------------
+  onApprovalDecision(handler) {
+    this.approvalDecisionHandler = handler;
+  }
+  async sendApprovalRequest(chatId, approvals, opts) {
+    const MAX_INPUT_LENGTH = 3500;
+    for (const approval of approvals) {
+      let inputSummary = Object.entries(approval.input).map(([k, v]) => `  ${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`).join("\n");
+      if (inputSummary.length > MAX_INPUT_LENGTH) {
+        inputSummary = inputSummary.slice(0, MAX_INPUT_LENGTH) + "\n  \u2026(truncated)";
+      }
+      const text = [
+        `\u{1F527} Tool approval required: ${approval.tool}`,
+        "",
+        inputSummary ? `Input:
+${inputSummary}` : "(no input)"
+      ].join("\n");
+      const keyboard = [
+        [
+          { text: "\u2705 Approve", callback_data: `a:${approval.approvalId}` },
+          { text: "\u274C Deny", callback_data: `d:${approval.approvalId}` }
+        ]
+      ];
+      try {
+        const messageId = await sendMessageWithKeyboard(
+          this.botToken,
+          chatId,
+          text,
+          keyboard,
+          { message_thread_id: opts?.message_thread_id }
+        );
+        this.approvalMessageIds.set(approval.approvalId, {
+          chatId,
+          messageId
+        });
+      } catch (err) {
+        console.error(
+          "[telegram-adapter] failed to send approval request:",
+          err instanceof Error ? err.message : err
+        );
+      }
+    }
+  }
+  async updateApprovalMessage(approvalId, decision, tool) {
+    const tracked = this.approvalMessageIds.get(approvalId);
+    if (!tracked) return;
+    const icon = decision === "approved" ? "\u2705" : "\u274C";
+    const label = decision === "approved" ? "Approved" : "Denied";
+    const text = `${icon} ${label}: ${tool}`;
+    try {
+      await editMessageText(
+        this.botToken,
+        tracked.chatId,
+        tracked.messageId,
+        text
+      );
+    } catch (err) {
+      console.warn(
+        "[telegram-adapter] failed to update approval message:",
+        err instanceof Error ? err.message : err
+      );
+    }
+    this.approvalMessageIds.delete(approvalId);
+  }
+  // -----------------------------------------------------------------------
   // HTTP request handling
   // -----------------------------------------------------------------------
   async handleRequest(req, res) {
@@ -1259,6 +1370,17 @@ var TelegramAdapter = class {
       return;
     }
     this.lastUpdateId = payload.update_id;
+    if (payload.callback_query) {
+      res.writeHead(200);
+      res.end();
+      void this.handleCallbackQuery(payload.callback_query).catch((err) => {
+        console.error(
+          "[telegram-adapter] callback_query error:",
+          err instanceof Error ? err.message : err
+        );
+      });
+      return;
+    }
     const message = payload.message;
     if (!message) {
       res.writeHead(200);
@@ -1350,6 +1472,37 @@ var TelegramAdapter = class {
     });
   }
   // -----------------------------------------------------------------------
+  // Callback query handling
+  // -----------------------------------------------------------------------
+  async handleCallbackQuery(query) {
+    if (this.allowedUserIds && !this.allowedUserIds.includes(query.from.id)) {
+      await answerCallbackQuery(this.botToken, query.id, {
+        text: "You are not authorized to approve tools."
+      });
+      return;
+    }
+    const data = query.data;
+    if (!data) {
+      await answerCallbackQuery(this.botToken, query.id);
+      return;
+    }
+    const isApprove = data.startsWith("a:");
+    const isDeny = data.startsWith("d:");
+    if (!isApprove && !isDeny) {
+      await answerCallbackQuery(this.botToken, query.id);
+      return;
+    }
+    const approvalId = data.slice(2);
+    const approved = isApprove;
+    const chatId = query.message?.chat.id ? String(query.message.chat.id) : void 0;
+    await answerCallbackQuery(this.botToken, query.id, {
+      text: approved ? "Approved" : "Denied"
+    });
+    if (this.approvalDecisionHandler && chatId) {
+      await this.approvalDecisionHandler(approvalId, approved, chatId);
+    }
+  }
+  // -----------------------------------------------------------------------
   // Helpers
   // -----------------------------------------------------------------------
   sessionKey(message) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/messaging",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Messaging platform adapters for Poncho agents (Slack, Telegram, etc.)",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
     }
   },
   "dependencies": {
-    "@poncho-ai/sdk": "1.5.0"
+    "@poncho-ai/sdk": "1.6.0"
   },
   "peerDependencies": {
     "resend": ">=4.0.0"

package/src/adapters/telegram/index.ts

@@ -9,15 +9,19 @@ import type {
 } from "../../types.js";
 import { verifyTelegramSecret } from "./verify.js";
 import {
+  type TelegramInlineKeyboardButton,
   type TelegramMessage,
   type TelegramUpdate,
+  answerCallbackQuery,
   downloadFile,
+  editMessageText,
   getFile,
   getMe,
   isBotMentioned,
   sendChatAction,
   sendDocument,
   sendMessage,
+  sendMessageWithKeyboard,
   sendPhoto,
   splitMessage,
   stripMention,
@@ -26,6 +30,18 @@ import {
 const TYPING_INTERVAL_MS = 4_000;
 const NEW_COMMAND_RE = /^\/new(?:@(\S+))?$/i;
 
+export interface TelegramApprovalInfo {
+  approvalId: string;
+  tool: string;
+  input: Record<string, unknown>;
+}
+
+export type TelegramApprovalDecisionHandler = (
+  approvalId: string,
+  approved: boolean,
+  chatId: string,
+) => Promise<void>;
+
 export interface TelegramAdapterOptions {
   botTokenEnv?: string;
   webhookSecretEnv?: string;
@@ -53,7 +69,9 @@ export class TelegramAdapter implements MessagingAdapter {
   private readonly webhookSecretEnv: string;
   private readonly allowedUserIds: number[] | undefined;
   private handler: IncomingMessageHandler | undefined;
+  private approvalDecisionHandler: TelegramApprovalDecisionHandler | undefined;
   private readonly sessionCounters = new Map<string, number>();
+  private readonly approvalMessageIds = new Map<string, { chatId: string; messageId: number }>();
   private lastUpdateId = 0;
 
   constructor(options: TelegramAdapterOptions = {}) {
@@ -148,6 +166,92 @@ export class TelegramAdapter implements MessagingAdapter {
     };
   }
 
+  // -----------------------------------------------------------------------
+  // Approval support
+  // -----------------------------------------------------------------------
+
+  onApprovalDecision(handler: TelegramApprovalDecisionHandler): void {
+    this.approvalDecisionHandler = handler;
+  }
+
+  async sendApprovalRequest(
+    chatId: string,
+    approvals: TelegramApprovalInfo[],
+    opts?: { message_thread_id?: number },
+  ): Promise<void> {
+    const MAX_INPUT_LENGTH = 3500;
+
+    for (const approval of approvals) {
+      let inputSummary = Object.entries(approval.input)
+        .map(([k, v]) => `  ${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`)
+        .join("\n");
+
+      if (inputSummary.length > MAX_INPUT_LENGTH) {
+        inputSummary = inputSummary.slice(0, MAX_INPUT_LENGTH) + "\n  …(truncated)";
+      }
+
+      const text = [
+        `🔧 Tool approval required: ${approval.tool}`,
+        "",
+        inputSummary ? `Input:\n${inputSummary}` : "(no input)",
+      ].join("\n");
+
+      const keyboard: TelegramInlineKeyboardButton[][] = [
+        [
+          { text: "✅ Approve", callback_data: `a:${approval.approvalId}` },
+          { text: "❌ Deny", callback_data: `d:${approval.approvalId}` },
+        ],
+      ];
+
+      try {
+        const messageId = await sendMessageWithKeyboard(
+          this.botToken,
+          chatId,
+          text,
+          keyboard,
+          { message_thread_id: opts?.message_thread_id },
+        );
+        this.approvalMessageIds.set(approval.approvalId, {
+          chatId,
+          messageId,
+        });
+      } catch (err) {
+        console.error(
+          "[telegram-adapter] failed to send approval request:",
+          err instanceof Error ? err.message : err,
+        );
+      }
+    }
+  }
+
+  async updateApprovalMessage(
+    approvalId: string,
+    decision: "approved" | "denied",
+    tool: string,
+  ): Promise<void> {
+    const tracked = this.approvalMessageIds.get(approvalId);
+    if (!tracked) return;
+
+    const icon = decision === "approved" ? "✅" : "❌";
+    const label = decision === "approved" ? "Approved" : "Denied";
+    const text = `${icon} ${label}: ${tool}`;
+
+    try {
+      await editMessageText(
+        this.botToken,
+        tracked.chatId,
+        tracked.messageId,
+        text,
+      );
+    } catch (err) {
+      console.warn(
+        "[telegram-adapter] failed to update approval message:",
+        err instanceof Error ? err.message : err,
+      );
+    }
+    this.approvalMessageIds.delete(approvalId);
+  }
+
   // -----------------------------------------------------------------------
   // HTTP request handling
   // -----------------------------------------------------------------------
@@ -187,6 +291,19 @@ export class TelegramAdapter implements MessagingAdapter {
     }
     this.lastUpdateId = payload.update_id;
 
+    // -- Callback query (inline keyboard button press) ---------------------
+    if (payload.callback_query) {
+      res.writeHead(200);
+      res.end();
+      void this.handleCallbackQuery(payload.callback_query).catch((err) => {
+        console.error(
+          "[telegram-adapter] callback_query error:",
+          err instanceof Error ? err.message : err,
+        );
+      });
+      return;
+    }
+
     const message = payload.message;
     if (!message) {
       res.writeHead(200);
@@ -313,6 +430,48 @@ export class TelegramAdapter implements MessagingAdapter {
     });
   }
 
+  // -----------------------------------------------------------------------
+  // Callback query handling
+  // -----------------------------------------------------------------------
+
+  private async handleCallbackQuery(
+    query: import("./utils.js").TelegramCallbackQuery,
+  ): Promise<void> {
+    if (this.allowedUserIds && !this.allowedUserIds.includes(query.from.id)) {
+      await answerCallbackQuery(this.botToken, query.id, {
+        text: "You are not authorized to approve tools.",
+      });
+      return;
+    }
+
+    const data = query.data;
+    if (!data) {
+      await answerCallbackQuery(this.botToken, query.id);
+      return;
+    }
+
+    const isApprove = data.startsWith("a:");
+    const isDeny = data.startsWith("d:");
+    if (!isApprove && !isDeny) {
+      await answerCallbackQuery(this.botToken, query.id);
+      return;
+    }
+
+    const approvalId = data.slice(2);
+    const approved = isApprove;
+    const chatId = query.message?.chat.id
+      ? String(query.message.chat.id)
+      : undefined;
+
+    await answerCallbackQuery(this.botToken, query.id, {
+      text: approved ? "Approved" : "Denied",
+    });
+
+    if (this.approvalDecisionHandler && chatId) {
+      await this.approvalDecisionHandler(approvalId, approved, chatId);
+    }
+  }
+
   // -----------------------------------------------------------------------
   // Helpers
   // -----------------------------------------------------------------------

package/src/adapters/telegram/utils.ts

@@ -55,9 +55,22 @@ export interface TelegramMessage {
   message_thread_id?: number;
 }
 
+export interface TelegramCallbackQuery {
+  id: string;
+  from: TelegramUser;
+  message?: TelegramMessage;
+  data?: string;
+}
+
+export interface TelegramInlineKeyboardButton {
+  text: string;
+  callback_data?: string;
+}
+
 export interface TelegramUpdate {
   update_id: number;
   message?: TelegramMessage;
+  callback_query?: TelegramCallbackQuery;
 }
 
 // ---------------------------------------------------------------------------
@@ -259,6 +272,72 @@ export const sendDocument = async (
   }
 };
 
+// ---------------------------------------------------------------------------
+// Inline keyboard messages
+// ---------------------------------------------------------------------------
+
+export const sendMessageWithKeyboard = async (
+  token: string,
+  chatId: number | string,
+  text: string,
+  keyboard: TelegramInlineKeyboardButton[][],
+  opts?: { reply_to_message_id?: number; message_thread_id?: number },
+): Promise<number> => {
+  const body: Record<string, unknown> = {
+    chat_id: chatId,
+    text,
+    reply_markup: { inline_keyboard: keyboard },
+  };
+  if (opts?.reply_to_message_id) {
+    body.reply_parameters = {
+      message_id: opts.reply_to_message_id,
+      allow_sending_without_reply: true,
+    };
+  }
+  if (opts?.message_thread_id) {
+    body.message_thread_id = opts.message_thread_id;
+  }
+  const result = await telegramFetch(token, "sendMessage", body);
+  if (!result.ok) {
+    throw new Error(`Telegram sendMessage (keyboard) failed: ${result.description}`);
+  }
+  const msg = result.result as { message_id: number };
+  return msg.message_id;
+};
+
+export const editMessageText = async (
+  token: string,
+  chatId: number | string,
+  messageId: number,
+  text: string,
+  opts?: { reply_markup?: { inline_keyboard: TelegramInlineKeyboardButton[][] } },
+): Promise<void> => {
+  const body: Record<string, unknown> = {
+    chat_id: chatId,
+    message_id: messageId,
+    text,
+  };
+  if (opts?.reply_markup) {
+    body.reply_markup = opts.reply_markup;
+  }
+  const result = await telegramFetch(token, "editMessageText", body);
+  if (!result.ok) {
+    throw new Error(`Telegram editMessageText failed: ${result.description}`);
+  }
+};
+
+export const answerCallbackQuery = async (
+  token: string,
+  callbackQueryId: string,
+  opts?: { text?: string },
+): Promise<void> => {
+  const body: Record<string, unknown> = {
+    callback_query_id: callbackQueryId,
+  };
+  if (opts?.text) body.text = opts.text;
+  await telegramFetch(token, "answerCallbackQuery", body);
+};
+
 // ---------------------------------------------------------------------------
 // Typing indicator
 // ---------------------------------------------------------------------------

package/src/bridge.ts

@@ -79,7 +79,7 @@ export class AgentBridge {
       const subjectLine = message.subject ? `Subject: ${message.subject}` : "";
       const header = [senderLine, subjectLine].filter(Boolean).join("\n");
 
-      let currentTask = `${header}\n\n${message.text}`;
+      let currentTask: string | undefined = `${header}\n\n${message.text}`;
       let currentFiles = message.files;
       let accumulatedResponse = "";
       let accumulatedFiles: FileAttachment[] = [];
@@ -122,7 +122,7 @@ export class AgentBridge {
         ) {
           continuationCount++;
           console.log(`[agent-bridge] continuation ${continuationCount}/${MAX_CONTINUATIONS} for ${conversationId}`);
-          currentTask = "Continue";
+          currentTask = undefined;
           currentFiles = undefined;
           continue;
         }

package/src/index.ts

@@ -16,7 +16,11 @@ export type { SlackAdapterOptions } from "./adapters/slack/index.js";
 export { ResendAdapter } from "./adapters/resend/index.js";
 export type { ResendAdapterOptions } from "./adapters/resend/index.js";
 export { TelegramAdapter } from "./adapters/telegram/index.js";
-export type { TelegramAdapterOptions } from "./adapters/telegram/index.js";
+export type {
+  TelegramAdapterOptions,
+  TelegramApprovalInfo,
+  TelegramApprovalDecisionHandler,
+} from "./adapters/telegram/index.js";
 
 export {
   buildReplyHeaders,

package/src/types.ts

@@ -117,7 +117,7 @@ export interface AgentRunner {
   run(
     conversationId: string,
     input: {
-      task: string;
+      task?: string;
       messages: Message[];
       files?: FileAttachment[];
       metadata?: {

package/.turbo/turbo-test.log

@@ -1,53 +0,0 @@
-
-> @poncho-ai/messaging@0.5.1 test /Users/cesar/Dev/latitude/poncho-ai/packages/messaging
-> vitest
-
-
- RUN  v1.6.1 /Users/cesar/Dev/latitude/poncho-ai/packages/messaging
-
- ✓ test/adapters/resend.test.ts  (13 tests) 4ms
-stderr | test/bridge.test.ts > AgentBridge > posts an error message and cleans up on runner failure
-[agent-bridge] handleMessage error: Model overloaded
-
-stderr | test/bridge.test.ts > AgentBridge > skips sendReply when autoReply is false
-[agent-bridge] tool mode completed without send_email being called; no reply sent
-
-stderr | test/bridge.test.ts > AgentBridge > suppresses error reply when hasSentInCurrentRequest is true
-[agent-bridge] handleMessage error: Oops
-
-stderr | test/bridge.test.ts > AgentBridge > calls resetRequestState before handling each message
- ❯ test/bridge.test.ts  (15 tests | 1 failed) 11ms
-   ❯ test/bridge.test.ts > AgentBridge > derives deterministic conversation IDs from ThreadRef
-[agent-bridge] tool mode completed without send_email being called; no reply sent
-     → expected 'c61bdca0-71e1-4785-869c-5552b90054c5' to be 'test:C001:ts_123' // Object.is equality
-
- ✓ test/adapters/email-utils.test.ts  (44 tests) 7ms
- ✓ test/adapters/slack.test.ts  (17 tests) 63ms
-
-⎯⎯⎯⎯⎯⎯⎯ Failed Tests 1 ⎯⎯⎯⎯⎯⎯⎯
-
- FAIL  test/bridge.test.ts > AgentBridge > derives deterministic conversation IDs from ThreadRef
-AssertionError: expected 'c61bdca0-71e1-4785-869c-5552b90054c5' to be 'test:C001:ts_123' // Object.is equality
-
-- Expected
-+ Received
-
-- test:C001:ts_123
-+ c61bdca0-71e1-4785-869c-5552b90054c5
-
- ❯ test/bridge.test.ts:88:33
-     86| 
-     87|     expect(runner._runs).toHaveLength(1);
-     88|     expect(runner._runs[0]!.id).toBe("test:C001:ts_123");
-       |                                 ^
-     89|   });
-     90| 
-
- Test Files  1 failed | 3 passed (4)
-⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯
-
-      Tests  1 failed | 88 passed (89)
-   Start at  21:53:18
-   Duration  639ms (transform 246ms, setup 0ms, collect 323ms, tests 85ms, environment 0ms, prepare 392ms)
-
- ELIFECYCLE  Test failed. See above for more details.