@llblab/pi-kit 0.27.5 → 0.28.0

package/node_modules/@llblab/pi-telegram/dist/lib/commands.d.ts

@@ -43,10 +43,7 @@ interface RegisteredTelegramExtensionCommand {
     emoji?: string;
     handler: TelegramExtensionCommandRegistration["handler"];
 }
-export declare function normalizeTelegramExtensionCommandName(name: string): string;
-export declare function isTelegramExtensionCommandName(name: string): boolean;
 export declare function registerTelegramCommand(registration: TelegramExtensionCommandRegistration): () => void;
-export declare function getTelegramExtensionCommands(): RegisteredTelegramExtensionCommand[];
 export declare function findTelegramExtensionCommand(name: string | undefined): RegisteredTelegramExtensionCommand | undefined;
 export declare function clearTelegramExtensionCommands(): void;
 export declare const TELEGRAM_COMMAND_EMOJI: {
@@ -65,18 +62,14 @@ export declare const TELEGRAM_COMMAND_EMOJI: {
     readonly new: "🆕";
 };
 export type TelegramCommandEmojiName = keyof typeof TELEGRAM_COMMAND_EMOJI;
-export declare function getTelegramCommandEmoji(command: TelegramCommandEmojiName): string;
 export declare function formatTelegramCommandEmojiPrefix(command: TelegramCommandEmojiName): string;
 export declare function formatTelegramPiCommandHtml(command: string): string;
 export declare function formatTelegramInformationHeading(emoji: string, text: string): string;
 export declare function formatTelegramInvalidInstanceName(validationError: string): string;
 export declare function formatTelegramThreadDisplayNameSavedHeading(name: string): string;
 export declare function formatTelegramAutomaticThreadDisplayNameRestoredHeading(name: string): string;
-export declare const TELEGRAM_COMPACTION_STARTED_TEXT: string;
-export declare const TELEGRAM_COMPACTION_COMPLETED_TEXT: string;
 export declare const TELEGRAM_COMPACTION_STARTED_MARKDOWN: string;
 export declare const TELEGRAM_COMPACTION_COMPLETED_MARKDOWN = "**\u2705 Compaction completed.**";
-export declare const TELEGRAM_BUILTIN_BOT_COMMANDS: readonly TelegramBotCommandDefinition[];
 export declare const TELEGRAM_BOT_COMMANDS: readonly TelegramBotCommandDefinition[];
 export declare function getTelegramReservedCommandNames(): string[];
 export interface TelegramBotCommandRegistrationDeps {
@@ -542,16 +535,8 @@ export declare function handleTelegramNextCommand(deps: {
         parseMode?: "HTML";
     }) => Promise<void>) | undefined;
 }): Promise<void>;
-export declare function handleTelegramContinueCommand<TMessage, TContext>(message: TMessage, ctx: TContext, deps: {
-    enqueueContinueTurn: (message: TMessage, ctx: TContext) => Promise<void>;
-}): Promise<void>;
-export declare function buildTelegramNewConfirmationReplyMarkup(): TelegramCompactConfirmationReplyMarkup;
-export declare function getTelegramNewConfirmationHtml(): string;
 export declare function openTelegramNewConfirmation(target: TelegramCommandMessageTarget, deps: TelegramCompactConfirmationDeps): Promise<void>;
 export declare function handleTelegramNewConfirmationCallback<TContext>(query: TelegramCompactConfirmationCallbackQuery, deps: TelegramNewConfirmationCallbackDeps<TContext>): Promise<boolean>;
-export declare function buildTelegramCompactConfirmationReplyMarkup(): TelegramCompactConfirmationReplyMarkup;
-export declare function getTelegramCompactConfirmationHtml(): string;
-export declare function openTelegramCompactConfirmation(target: TelegramCommandMessageTarget, deps: TelegramCompactConfirmationDeps): Promise<void>;
 export declare function handleTelegramCompactConfirmationCallback<TContext>(query: TelegramCompactConfirmationCallbackQuery, deps: TelegramCompactConfirmationCallbackDeps<TContext>): Promise<boolean>;
 export interface TelegramNewCommandDeps extends TelegramRuntimeEventRecorderPort {
     isIdle: () => boolean;
@@ -588,7 +573,6 @@ export declare function createTelegramCommandOrPromptRuntime<TMessage, TContext>
 export declare const TELEGRAM_INTERNAL_COMMAND_NAME = "telegram-internal";
 export declare const TELEGRAM_INTERNAL_COMMAND_DESCRIPTION = "Internal Telegram command cannot be run manually";
 export declare const TELEGRAM_INTERNAL_MANUAL_USE_MESSAGE = "This internal Telegram command cannot be run manually.";
-export declare function delayTelegramSessionAction(delayMs: number): Promise<void>;
 export interface TelegramSessionActionRuntimeDeps {
     registerCommand: Pi.ExtensionAPI["registerCommand"];
     sendUserMessage: Pi.ExtensionAPI["sendUserMessage"];
@@ -621,13 +605,6 @@ export interface TelegramSessionReplacementSettlementDeps {
     isCurrent?: () => boolean;
 }
 export declare function settleTelegramSessionReplacement(deps: TelegramSessionReplacementSettlementDeps): Promise<"none" | "settled" | "expired" | "failed" | "stale">;
-export declare function createTelegramSessionReplacementSettlementRuntime<TContext>(deps: {
-    resolve: (ctx: TContext) => TelegramSessionReplacementSettlementDeps | undefined;
-    onResult?: (result: "none" | "settled" | "expired" | "failed" | "stale") => void;
-    onError?: (error: unknown) => void;
-}): {
-    onSessionStart: (ctx: TContext) => void;
-};
 export interface TelegramSessionActionAssemblyDeps {
     registerCommand: Pi.ExtensionAPI["registerCommand"];
     sendUserMessage: Pi.ExtensionAPI["sendUserMessage"];

package/node_modules/@llblab/pi-telegram/dist/lib/commands.js

@@ -23,10 +23,10 @@ function getOrCreateTelegramCommandRegistry() {
     globalThis[TELEGRAM_EXTENSION_COMMAND_REGISTRY_KEY] = registry;
     return registry;
 }
-export function normalizeTelegramExtensionCommandName(name) {
+function normalizeTelegramExtensionCommandName(name) {
     return name.trim().replace(/^\/+/, "").toLowerCase();
 }
-export function isTelegramExtensionCommandName(name) {
+function isTelegramExtensionCommandName(name) {
     return TELEGRAM_BOT_COMMAND_NAME_PATTERN.test(name);
 }
 function normalizeTelegramExtensionCommandEmoji(emoji) {
@@ -67,7 +67,7 @@ export function registerTelegramCommand(registration) {
             registry.commands.delete(name);
     };
 }
-export function getTelegramExtensionCommands() {
+function getTelegramExtensionCommands() {
     return Array.from(getOrCreateTelegramCommandRegistry().commands.values()).sort((a, b) => a.order - b.order || a.name.localeCompare(b.name));
 }
 export function findTelegramExtensionCommand(name) {
@@ -93,7 +93,7 @@ export const TELEGRAM_COMMAND_EMOJI = {
     name: "🏷️",
     new: "🆕",
 };
-export function getTelegramCommandEmoji(command) {
+function getTelegramCommandEmoji(command) {
     return TELEGRAM_COMMAND_EMOJI[command];
 }
 export function formatTelegramCommandEmojiPrefix(command) {
@@ -124,14 +124,14 @@ export function formatTelegramThreadDisplayNameSavedHeading(name) {
 export function formatTelegramAutomaticThreadDisplayNameRestoredHeading(name) {
     return `<b>✅ Automatic Thread display name restored as <i>${escapeHtml(name)}</i>.</b>`;
 }
-export const TELEGRAM_COMPACTION_STARTED_TEXT = formatTelegramInformationHeading(getTelegramCommandEmoji("compact"), "Compaction started.");
-export const TELEGRAM_COMPACTION_COMPLETED_TEXT = formatTelegramInformationHeading("✅", "Compaction completed.");
+const TELEGRAM_COMPACTION_STARTED_TEXT = formatTelegramInformationHeading(getTelegramCommandEmoji("compact"), "Compaction started.");
+const TELEGRAM_COMPACTION_COMPLETED_TEXT = formatTelegramInformationHeading("✅", "Compaction completed.");
 export const TELEGRAM_COMPACTION_STARTED_MARKDOWN = `**${formatTelegramCommandEmojiPrefix("compact")}Compaction started.**`;
 export const TELEGRAM_COMPACTION_COMPLETED_MARKDOWN = "**✅ Compaction completed.**";
 function formatTelegramBotCommandDescription(command, description) {
     return `${formatTelegramCommandEmojiPrefix(command)}${description}`;
 }
-export const TELEGRAM_BUILTIN_BOT_COMMANDS = [
+const TELEGRAM_BUILTIN_BOT_COMMANDS = [
     {
         command: "start",
         description: formatTelegramBotCommandDescription("start", "Open menu / Pair bridge"),
@@ -738,7 +738,7 @@ export async function handleTelegramNextCommand(deps) {
     deps.dispatchNextQueuedTurn();
     deps.updateStatus();
 }
-export async function handleTelegramContinueCommand(message, ctx, deps) {
+async function handleTelegramContinueCommand(message, ctx, deps) {
     await deps.enqueueContinueTurn(message, ctx);
 }
 function dispatchNextQueuedTelegramTurnAfterCompact(deps) {
@@ -748,7 +748,7 @@ function dispatchNextQueuedTelegramTurnAfterCompact(deps) {
     }
     deps.dispatchNextQueuedTelegramTurn();
 }
-export function buildTelegramNewConfirmationReplyMarkup() {
+function buildTelegramNewConfirmationReplyMarkup() {
     return {
         inline_keyboard: [
             [
@@ -758,7 +758,7 @@ export function buildTelegramNewConfirmationReplyMarkup() {
         ],
     };
 }
-export function getTelegramNewConfirmationHtml() {
+function getTelegramNewConfirmationHtml() {
     return "<b>Start a new session?</b>";
 }
 export async function openTelegramNewConfirmation(target, deps) {
@@ -785,7 +785,7 @@ export async function handleTelegramNewConfirmationCallback(query, deps) {
     await deps.runNew(deps.ctx);
     return true;
 }
-export function buildTelegramCompactConfirmationReplyMarkup() {
+function buildTelegramCompactConfirmationReplyMarkup() {
     return {
         inline_keyboard: [
             [
@@ -795,10 +795,10 @@ export function buildTelegramCompactConfirmationReplyMarkup() {
         ],
     };
 }
-export function getTelegramCompactConfirmationHtml() {
+function getTelegramCompactConfirmationHtml() {
     return "<b>Compact session?</b>";
 }
-export async function openTelegramCompactConfirmation(target, deps) {
+async function openTelegramCompactConfirmation(target, deps) {
     await deps.sendInteractiveMessage(target.chatId, getTelegramCompactConfirmationHtml(), "html", buildTelegramCompactConfirmationReplyMarkup(), target.threadId !== undefined
         ? { target: { chatId: target.chatId, threadId: target.threadId } }
         : undefined);
@@ -1277,7 +1277,7 @@ async function handleTelegramCommandRuntime(commandName, message, ctx, deps, com
 export const TELEGRAM_INTERNAL_COMMAND_NAME = "telegram-internal";
 export const TELEGRAM_INTERNAL_COMMAND_DESCRIPTION = "Internal Telegram command cannot be run manually";
 export const TELEGRAM_INTERNAL_MANUAL_USE_MESSAGE = "This internal Telegram command cannot be run manually.";
-export function delayTelegramSessionAction(delayMs) {
+function delayTelegramSessionAction(delayMs) {
     return new Promise((resolve) => setTimeout(resolve, delayMs));
 }
 export async function settleTelegramSessionReplacement(deps) {
@@ -1309,7 +1309,7 @@ export async function settleTelegramSessionReplacement(deps) {
     }
     return "stale";
 }
-export function createTelegramSessionReplacementSettlementRuntime(deps) {
+function createTelegramSessionReplacementSettlementRuntime(deps) {
     let generation = 0;
     return {
         onSessionStart(ctx) {

package/node_modules/@llblab/pi-telegram/dist/lib/config.d.ts

@@ -16,17 +16,10 @@ export type TelegramBotTokenReference = {
 } | {
     kind: "malformed";
 };
-/**
- * Parse a persisted bot-token value. `$NAME` and `${NAME}` are exact
- * environment-variable references. Any other `$`-prefixed value is malformed
- * rather than a literal secret so a broken reference fails closed.
- */
-export declare function getTelegramBotTokenReference(value: string | undefined): TelegramBotTokenReference | undefined;
 /** Resolve a persisted token at a validation/activation boundary. */
 export declare function resolveTelegramBotToken(value: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
 /** Redacted diagnostic for an unresolved or malformed token reference. */
 export declare function getTelegramBotTokenDiagnostic(value: string | undefined, env?: NodeJS.ProcessEnv): string | undefined;
-export type TelegramOutboundCommandTemplateConfig = string | CommandTemplateObjectConfig;
 export interface TelegramOutboundHandlerConfig extends CommandTemplateObjectConfig {
     type?: string;
     match?: string | string[];
@@ -179,13 +172,6 @@ export declare function normalizeTelegramDefaultProfileConfig(config: TelegramCo
     changed: boolean;
 };
 export declare function createTelegramConfigStore(options?: TelegramConfigStoreOptions): TelegramConfigStore;
-export declare function createTelegramDraftPreviewsChecker(configStore: Pick<TelegramConfigStore, "get">): () => boolean;
-export declare function createTelegramDraftPreviewsSetter(configStore: TelegramMutableConfigStore): (enabled: boolean) => Promise<void>;
-export declare function createTelegramAssistantRenderingModeGetter(configStore: Pick<TelegramConfigStore, "get">): () => TelegramAssistantRenderingMode;
-export declare function createTelegramAssistantRenderingModeSetter(configStore: TelegramMutableConfigStore): (mode: TelegramAssistantRenderingMode) => Promise<void>;
-export declare function createTelegramActivityVerbosityGetter(configStore: Pick<TelegramConfigStore, "get">): () => TelegramActivityVerbosity;
-export declare function createTelegramActivityVerbosityRefresher(configStore: TelegramMutableConfigStore): () => Promise<void>;
-export declare function createTelegramActivityVerbositySetter(configStore: TelegramMutableConfigStore): (verbosity: TelegramActivityVerbosity) => Promise<void>;
 export declare function createTelegramVoiceReplyModeGetter(configStore: Pick<TelegramConfigStore, "get">): () => "manual" | "mirror" | "always";
 export declare function createTelegramVoiceReplyModeConfiguredChecker(configStore: Pick<TelegramConfigStore, "get">): () => boolean;
 export declare function createTelegramVoiceReplyModeSetter(configStore: TelegramMutableConfigStore): (replyMode: "manual" | "hidden" | "mirror" | "always" | undefined) => Promise<void>;
@@ -203,9 +189,6 @@ export declare function createTelegramProactivePushTargetGetter(deps: {
     getAssignedTarget: () => TelegramProactivePushTarget | undefined;
     getAllowedUserId: () => number | undefined;
 }): () => TelegramProactivePushTarget | undefined;
-export declare function createTelegramAutomaticThreadCleanupChecker(configStore: Pick<TelegramConfigStore, "get">): () => boolean;
-export declare function createTelegramAutomaticThreadCleanupResolver(configStore: TelegramMutableConfigStore): () => Promise<boolean>;
-export declare function createTelegramAutomaticThreadCleanupSetter(configStore: TelegramMutableConfigStore): (enabled: boolean) => Promise<void>;
 export declare function createTelegramConfigControls(configStore: TelegramMutableConfigStore): {
     areDraftPreviewsEnabled: () => boolean;
     setDraftPreviewsEnabled: (enabled: boolean) => Promise<void>;

package/node_modules/@llblab/pi-telegram/dist/lib/config.js

@@ -8,6 +8,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, statSync, u
 import { chmod, mkdir, rename, writeFile } from "node:fs/promises";
 import { resolveAgentDir, resolveTelegramConfigPath, TELEGRAM_DEFAULT_PROFILE_NAME, } from "./paths.js";
 export { TELEGRAM_DEFAULT_PROFILE_NAME } from "./paths.js";
+import { isWireRecord as isPlainConfigRecord } from "./wire.js";
 import { withTelegramFileTransaction } from "./locks.js";
 const CONFIG_RUNTIME_KEY = "__piTelegramConfigRuntime__";
 const CONFIG_REPLACE_RETRY_ATTEMPTS = 5;
@@ -45,7 +46,7 @@ const TELEGRAM_BOT_TOKEN_ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
  * environment-variable references. Any other `$`-prefixed value is malformed
  * rather than a literal secret so a broken reference fails closed.
  */
-export function getTelegramBotTokenReference(value) {
+function getTelegramBotTokenReference(value) {
     const trimmed = value?.trim();
     if (!trimmed)
         return undefined;
@@ -211,9 +212,6 @@ export async function writeTelegramConfig(agentDir, configPath, config) {
     await rename(tempConfigPath, configPath);
     await chmod(configPath, 0o600);
 }
-function isPlainConfigRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}
 function cloneTelegramConfig(value) {
     return structuredClone(value);
 }
@@ -628,7 +626,7 @@ export function createTelegramConfigStore(options = {}) {
         },
     };
 }
-export function createTelegramDraftPreviewsChecker(configStore) {
+function createTelegramDraftPreviewsChecker(configStore) {
     return () => {
         const config = configStore.get();
         return (config.assistant?.draftPreviews ??
@@ -637,7 +635,7 @@ export function createTelegramDraftPreviewsChecker(configStore) {
             true);
     };
 }
-export function createTelegramDraftPreviewsSetter(configStore) {
+function createTelegramDraftPreviewsSetter(configStore) {
     return async (enabled) => {
         await loadLatestTelegramConfig(configStore);
         const { draftPreviews: _legacyDraftPreviews, richDraftPreviews: _legacyRichDraftPreviews, ...current } = configStore.get();
@@ -649,14 +647,14 @@ export function createTelegramDraftPreviewsSetter(configStore) {
         await configStore.persist(config);
     };
 }
-export function createTelegramAssistantRenderingModeGetter(configStore) {
+function createTelegramAssistantRenderingModeGetter(configStore) {
     return () => {
         const config = configStore.get();
         const mode = config.assistant?.rendering ?? config.assistantRendering;
         return mode === "html" ? "html" : "rich";
     };
 }
-export function createTelegramAssistantRenderingModeSetter(configStore) {
+function createTelegramAssistantRenderingModeSetter(configStore) {
     return async (mode) => {
         await loadLatestTelegramConfig(configStore);
         const { assistantRendering: _legacyAssistantRendering, ...current } = configStore.get();
@@ -668,7 +666,7 @@ export function createTelegramAssistantRenderingModeSetter(configStore) {
         await configStore.persist(config);
     };
 }
-export function createTelegramActivityVerbosityGetter(configStore) {
+function createTelegramActivityVerbosityGetter(configStore) {
     return () => {
         const assistant = configStore.get().assistant;
         if (assistant?.activity !== undefined) {
@@ -685,10 +683,10 @@ export function createTelegramActivityVerbosityGetter(configStore) {
         return "verbose";
     };
 }
-export function createTelegramActivityVerbosityRefresher(configStore) {
+function createTelegramActivityVerbosityRefresher(configStore) {
     return () => loadLatestTelegramConfig(configStore);
 }
-export function createTelegramActivityVerbositySetter(configStore) {
+function createTelegramActivityVerbositySetter(configStore) {
     return async (verbosity) => {
         await loadLatestTelegramConfig(configStore);
         const current = configStore.get();
@@ -801,10 +799,10 @@ export function createTelegramProactivePushTargetGetter(deps) {
         return typeof chatId === "number" ? { chatId } : undefined;
     };
 }
-export function createTelegramAutomaticThreadCleanupChecker(configStore) {
+function createTelegramAutomaticThreadCleanupChecker(configStore) {
     return () => configStore.get().threads?.automaticCleanup ?? true;
 }
-export function createTelegramAutomaticThreadCleanupResolver(configStore) {
+function createTelegramAutomaticThreadCleanupResolver(configStore) {
     return async () => {
         await loadLatestTelegramConfig(configStore);
         if (configStore.didLastLoadRecoverInvalidConfig?.()) {
@@ -813,7 +811,7 @@ export function createTelegramAutomaticThreadCleanupResolver(configStore) {
         return createTelegramAutomaticThreadCleanupChecker(configStore)();
     };
 }
-export function createTelegramAutomaticThreadCleanupSetter(configStore) {
+function createTelegramAutomaticThreadCleanupSetter(configStore) {
     return async (enabled) => {
         await loadLatestTelegramConfig(configStore);
         const current = configStore.get();

package/node_modules/@llblab/pi-telegram/dist/lib/delivery.d.ts

@@ -108,10 +108,6 @@ export declare function createTelegramBridgeDeliveryLifecycleHooks<TTransportSta
     getTransportStamp?: () => TTransportStamp;
     isTransportStampActive?: (stamp: TTransportStamp) => boolean;
 }): ReturnType<typeof createTelegramDeliveryLifecycleHooks>;
-export declare function classifyTelegramDeliveryTransportError(error: unknown): {
-    reason: Extract<TelegramDeliveryFailureReason, "commit-unknown" | "message-unavailable" | "rate-limited" | "transport-retryable" | "transport-failed">;
-    retryAfterMs?: number;
-};
 /** @internal */
 export interface TelegramDeliveryTargetPolicyView {
     canDeliver: boolean;

package/node_modules/@llblab/pi-telegram/dist/lib/delivery.js

@@ -6,7 +6,7 @@
 import { markTelegramBusAggregateDelivery } from "./bus.js";
 import { assertTelegramInlineKeyboardCallbackData, } from "./keyboard.js";
 import { withTelegramReplyParameters, renderTelegramMessage, } from "./replies.js";
-import { getTelegramTargetThreadParams, } from "./target.js";
+import { areTelegramTargetsEqual as areDeliveryTargetsEqual, getTelegramTargetThreadParams, } from "./target.js";
 import { getTelegramApiRetryAfterMs, isRetryableTelegramApiError, isTelegramApiCommitUnknownError, isTelegramMessageUnavailableError, } from "./telegram-api.js";
 const TELEGRAM_DELIVERY_RUNTIME_KEY = "__piTelegramDeliveryRuntime__";
 class TelegramDeliveryTransportGenerationError extends Error {
@@ -69,7 +69,7 @@ function failure(reason, message, partial, retryAfterMs) {
         ? { ok: false, reason, message, ...retry }
         : { ok: false, reason, message, partial, ...retry };
 }
-export function classifyTelegramDeliveryTransportError(error) {
+function classifyTelegramDeliveryTransportError(error) {
     if (isTelegramApiCommitUnknownError(error))
         return { reason: "commit-unknown" };
     if (isTelegramMessageUnavailableError(error))
@@ -140,9 +140,6 @@ export function isTelegramDeliveryExplicitTargetAuthorized(candidate, view) {
         return areDeliveryTargetsEqual(candidate, target);
     });
 }
-function areDeliveryTargetsEqual(left, right) {
-    return left.chatId === right.chatId && left.threadId === right.threadId;
-}
 function cloneTarget(target) {
     return target.threadId === undefined
         ? { chatId: target.chatId }