@llblab/pi-kit 0.1.8 → 0.1.10

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

@@ -1782,6 +1782,7 @@ export interface TelegramUpdateWorkerRuntimeDeps<TContext> {
   classifyExecutionFailure?: (
     error: unknown,
   ) => TelegramUpdateExecutionFailureClassification;
+  settleTerminalExecutionFailure?: (error: unknown) => Promise<boolean>;
   scheduleRetry?: (callback: () => void, delayMs: number) => unknown;
   cancelRetry?: (handle: unknown) => void;
   batchSize?: number;
@@ -4583,11 +4584,11 @@ export function createTelegramUpdateAdmissionLifecycleRuntime<TContext>(
         try {
           deps.recordRuntimeEvent?.(
             "inbound-worker",
-            "Recovered queued authority from a confirmed-dead process.",
+            "Discarded session-owned queue authority from a confirmed-dead process.",
             {
-              phase: "dead-queue-owner-recovery",
+              phase: "dead-queue-owner-cleanup",
               receiptId,
-              recoveredUpdateCount: result.recoveredUpdateIds.length,
+              removedUpdateCount: result.recoveredUpdateIds.length,
             },
           );
         } catch {
@@ -4833,13 +4834,20 @@ export function createTelegramUpdateAdmissionWorkerRuntime<
   });
   worker = createTelegramUpdateWorkerRuntime({
     ...deps,
-    executeUpdate: (update, ctx, signal) => {
+    async executeUpdate(update, ctx, signal) {
       const typedUpdate = update as TUpdate;
-      return executeUpdate(
-        deps.prepareUpdateForExecution?.(typedUpdate) ?? typedUpdate,
-        ctx,
-        signal,
-      );
+      try {
+        return await executeUpdate(
+          deps.prepareUpdateForExecution?.(typedUpdate) ?? typedUpdate,
+          ctx,
+          signal,
+        );
+      } catch (error) {
+        if (await deps.settleTerminalExecutionFailure?.(error)) {
+          return { kind: "complete" };
+        }
+        throw error;
+      }
     },
   });
   return worker;

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

@@ -38,15 +38,9 @@ function getNextAvailableProviderId<T>(
   return id;
 }
 
-export type TelegramVoiceReplyMode = "hidden" | "mirror" | "always";
+export type TelegramVoiceReplyMode = "manual" | "mirror" | "always";
 
-export type TelegramVoiceSynthesisProviderResult =
-  | string
-  | {
-      audioPath: string;
-      transcriptText?: string;
-    }
-  | undefined;
+export type TelegramVoiceSynthesisProviderResult = string | undefined;
 
 export interface TelegramVoiceTurnView {
   voiceReplyPreferred?: boolean;
@@ -215,7 +209,7 @@ export function clearTelegramVoiceTranscriptionProviders(): void {
 // --- Voice Reply Modes ---
 
 export const TELEGRAM_VOICE_REPLY_MODES = [
-  "hidden",
+  "manual",
   "mirror",
   "always",
 ] as const;
@@ -224,33 +218,15 @@ export const TELEGRAM_VOICE_REPLY_MODES = [
  * Returns the active voice reply mode for the current session.
  *
  * Pi-telegram owns reply-mode policy through telegram.json. If
- * config.voice.replyMode is missing, invalid, or legacy `manual`, the effective
- * mode is hidden.
+ * config.voice.replyMode is missing, invalid, or legacy `hidden`, the effective
+ * mode is manual.
  */
 export function getTelegramVoiceReplyMode(config?: {
   voice?: { replyMode?: string };
 }): TelegramVoiceReplyMode {
   const configMode = config?.voice?.replyMode;
-  if (
-    configMode &&
-    (TELEGRAM_VOICE_REPLY_MODES as readonly string[]).includes(configMode)
-  ) {
-    return configMode as TelegramVoiceReplyMode;
-  }
-  return "hidden";
-}
-
-/**
- * Returns whether the user wants the voice synthesis provider's transcript attached
- * as a caption on the voice message.
- *
- * Reads from `config.voice.sendTranscript`.
- * Default: false (no transcript text sent at all).
- */
-export function getTelegramVoiceSendTranscript(config?: {
-  voice?: { sendTranscript?: boolean };
-}): boolean {
-  return !!config?.voice?.sendTranscript;
+  if (configMode === "mirror" || configMode === "always") return configMode;
+  return "manual";
 }
 
 // --- Voice Turn Helpers ---

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

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

package/node_modules/@llblab/pi-telegram/skills/telegram-bridge/SKILL.md

@@ -122,7 +122,7 @@ Prefer no-code command-template configuration in `telegram.json` before adding a
 - `outboundHandlers` transforms final replies.
 - Voice transcription handlers can match `type: "voice"` or `mime: "audio/*"`; stdout becomes `[outputs]`.
 
-When asked to configure voice rather than merely operate it, follow the provider-neutral contracts in `docs/voice.md`, `docs/inbound.md`, `docs/outbound.md`, and `docs/command-templates.md` from the pi-telegram package or repository. Inspect the available Skill catalog and trusted local executables for STT, TTS, and media conversion capabilities; check only whether required environment variables exist, never reveal their values. Preserve unrelated `telegram.json` fields, order multiple matching inbound handlers as fallbacks, require OGG/Opus output for native voice delivery, and validate each stage before a live Telegram smoke test. Keep `voice.replyMode` at its existing value unless the user requests a policy change: the default `hidden` mode is fully functional because explicit top-level `telegram_voice` actions still use the configured synthesis pipeline.
+When asked to configure voice rather than merely operate it, follow the provider-neutral contracts in `docs/voice.md`, `docs/inbound.md`, `docs/outbound.md`, and `docs/command-templates.md` from the pi-telegram package or repository. Inspect the available Skill catalog and trusted local executables for STT, TTS, and media conversion capabilities; check only whether required environment variables exist, never reveal their values. Preserve unrelated `telegram.json` fields, order multiple matching inbound handlers as fallbacks, require OGG/Opus output for native voice delivery, and validate each stage before a live Telegram smoke test. Keep `voice.replyMode` at its existing value unless the user requests a policy change: the default `manual` mode is fully functional because explicit top-level `telegram_voice` actions still use the configured synthesis pipeline.
 
 When configuration is insufficient, use documented `@llblab/pi-telegram/*` public API subpaths. Never import package-private `lib/*`, start another polling loop, or bypass bridge ownership with raw Bot API access.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -42,8 +42,8 @@
   "dependencies": {
     "@llblab/pi-actors": "0.50.0",
     "@llblab/pi-codex-usage": "0.9.3",
-    "@llblab/pi-grow-loop": "0.7.2",
-    "@llblab/pi-telegram": "0.37.1"
+    "@llblab/pi-grow-loop": "0.7.3",
+    "@llblab/pi-telegram": "0.39.3"
   },
   "bundledDependencies": [
     "@llblab/pi-actors",