@llblab/pi-kit 0.7.0 → 0.8.0

package/node_modules/@llblab/pi-telegram/lib/telegram-api.ts

@@ -200,6 +200,10 @@ export interface TelegramSentMessage {
   message_id: number;
 }
 
+export interface TelegramSentGuestMessage {
+  inline_message_id?: string;
+}
+
 export interface TelegramReplyParameters {
   message_id: number;
   allow_sending_without_reply?: boolean;
@@ -427,6 +431,11 @@ export interface TelegramAnswerGuestQueryOptions {
   result?: TelegramGuestCachedMediaResult;
 }
 
+export interface TelegramEditGuestInlineMessageContent {
+  text?: string;
+  richMessage?: TelegramInputRichMessage;
+}
+
 export interface TelegramAnswerCallbackQueryOptions {
   recordRuntimeEvent?: (
     kind: "api",
@@ -810,6 +819,21 @@ export interface TelegramBridgeApiRuntime {
     text?: string,
     options?: TelegramAnswerGuestQueryOptions,
   ) => Promise<void>;
+  /**
+   * Temporary Guest Mode ACK experiment: answers the guest query and returns
+   * the sent inline message id so the final answer can edit that early reply.
+   * Requires direct transport ownership; Telegram does not document editing
+   * guest answers, so this exists only to falsify that behavior live.
+   */
+  answerGuestQueryForInlineMessage: (
+    guestQueryId: string,
+    text?: string,
+    options?: TelegramAnswerGuestQueryOptions,
+  ) => Promise<string | undefined>;
+  editGuestInlineMessage: (
+    inlineMessageId: string,
+    content: TelegramEditGuestInlineMessageContent,
+  ) => Promise<void>;
   deleteMessage: (chatId: number, messageId: number) => Promise<void>;
   prepareTempDir: () => Promise<number>;
 }
@@ -1700,6 +1724,31 @@ export function createTelegramAssistantDraftSender(deps: {
   };
 }
 
+export function buildTelegramAnswerGuestQueryBody(
+  guestQueryId: string,
+  text?: string,
+  options?: TelegramAnswerGuestQueryOptions,
+): Record<string, unknown> {
+  const body: Record<string, unknown> = { guest_query_id: guestQueryId };
+  if (options?.result) {
+    body.result = options.result;
+  } else if (text !== undefined || options?.richMessage) {
+    const inputContent: Record<string, unknown> = options?.richMessage
+      ? { rich_message: options.richMessage }
+      : { message_text: text };
+    if (!options?.richMessage && options?.parseMode) {
+      inputContent.parse_mode = options.parseMode;
+    }
+    body.result = {
+      type: "article",
+      id: "1",
+      title: "Response",
+      input_message_content: inputContent,
+    };
+  }
+  return body;
+}
+
 export function createDefaultTelegramBridgeApiRuntime(deps: {
   getBotToken: () => string | undefined;
   recordRuntimeEvent: TelegramBridgeApiRuntimeDeps["recordRuntimeEvent"];
@@ -2021,25 +2070,32 @@ export function createTelegramBridgeApiRuntime(
       guestQueryId: string,
       text: string | undefined,
       options: TelegramAnswerGuestQueryOptions | undefined,
+    ) =>
+      callRecorded<void>(
+        "answerGuestQuery",
+        buildTelegramAnswerGuestQueryBody(guestQueryId, text, options),
+      ),
+    answerGuestQueryForInlineMessage: async (
+      guestQueryId: string,
+      text: string | undefined,
+      options: TelegramAnswerGuestQueryOptions | undefined,
     ) => {
-      const body: Record<string, unknown> = { guest_query_id: guestQueryId };
-      if (options?.result) {
-        body.result = options.result;
-      } else if (text !== undefined || options?.richMessage) {
-        const inputContent: Record<string, unknown> = options?.richMessage
-          ? { rich_message: options.richMessage }
-          : { message_text: text };
-        if (!options?.richMessage && options?.parseMode) {
-          inputContent.parse_mode = options.parseMode;
-        }
-        body.result = {
-          type: "article",
-          id: "1",
-          title: "Response",
-          input_message_content: inputContent,
-        };
-      }
-      return callRecorded<void>("answerGuestQuery", body);
+      const sent = await callRecorded<TelegramSentGuestMessage | undefined>(
+        "answerGuestQuery",
+        buildTelegramAnswerGuestQueryBody(guestQueryId, text, options),
+      );
+      return sent?.inline_message_id;
+    },
+    editGuestInlineMessage: async (
+      inlineMessageId: string,
+      content: TelegramEditGuestInlineMessageContent,
+    ) => {
+      await callRecorded("editMessageText", {
+        inline_message_id: inlineMessageId,
+        ...(content.richMessage
+          ? { rich_message: content.richMessage }
+          : { text: content.text }),
+      });
     },
     prepareTempDir: () =>
       prepareTelegramTempDir(deps.tempDir, deps.tempFileMaxAgeMs),

package/node_modules/@llblab/pi-telegram/lib/turns.ts

@@ -41,6 +41,9 @@ import {
 
 export const TELEGRAM_PREFIX = "[telegram]";
 
+export const TELEGRAM_GUEST_TURN_NOTE =
+  "[guest] delivery: answer quickly with one concise, self-contained reply";
+
 export interface TelegramTurnTarget {
   chatId: number;
   threadId?: number;
@@ -198,6 +201,7 @@ export function buildTelegramTurnPrompt(options: {
   historyTurns?: Pick<PendingTelegramTurn, "historyText">[];
   timeLine?: string | null;
   voiceContext?: Record<string, string>;
+  guestTurn?: boolean;
 }): string {
   let prompt = options.telegramPrefix;
   if ((options.historyTurns?.length ?? 0) > 0) {
@@ -229,6 +233,9 @@ export function buildTelegramTurnPrompt(options: {
   if (options.timeLine) {
     prompt = `${prompt}\n\n[time] ${options.timeLine}`;
   }
+  if (options.guestTurn) {
+    prompt = `${prompt}\n\n${TELEGRAM_GUEST_TURN_NOTE}`;
+  }
   return prompt;
 }
 

package/node_modules/@llblab/pi-telegram/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.45.0",
+  "version": "0.45.1",
   "private": false,
   "publishConfig": {
     "access": "public"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -44,8 +44,8 @@
     "@llblab/pi-clean-room": "0.1.1",
     "@llblab/pi-codex-usage": "0.9.4",
     "@llblab/pi-grow-loop": "0.7.5",
-    "@llblab/pi-state-flow": "0.6.0",
-    "@llblab/pi-telegram": "0.45.0",
+    "@llblab/pi-state-flow": "0.7.0",
+    "@llblab/pi-telegram": "0.45.1",
     "@llblab/skills": "1.15.0"
   },
   "bundledDependencies": [

package/node_modules/@llblab/pi-state-flow/lib/validation.ts

@@ -1,27 +0,0 @@
-import { terminalRegenerationInstruction } from "./terminal.ts";
-
-export const MAX_VALIDATION_RETRIES = 3;
-
-export interface ValidationFeedback {
-	attempt: number;
-	error: string;
-	instruction: string;
-}
-
-export type ValidationDecision =
-	| { kind: "retry"; feedback: ValidationFeedback }
-	| { kind: "exhausted"; error: string };
-
-/** Decide retry progression without mutating persistent runtime state. */
-export function nextValidation(previous: ValidationFeedback | undefined, error: string): ValidationDecision {
-	const attempt = (previous?.attempt ?? 0) + 1;
-	if (attempt > MAX_VALIDATION_RETRIES) return { kind: "exhausted", error };
-	return {
-		kind: "retry",
-		feedback: {
-			attempt,
-			error,
-			instruction: terminalRegenerationInstruction(error),
-		},
-	};
-}