@letta-ai/letta-code 0.30.2 → 0.30.3

package/dist/types/channels/telegram/message-actions.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelMessageActionAdapter } from "../plugin-types";
+export declare const telegramMessageActions: ChannelMessageActionAdapter;
+//# sourceMappingURL=message-actions.d.ts.map

package/dist/types/channels/telegram/message-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-actions.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/message-actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAI5B,MAAM,yBAAyB,CAAC;AAoDjC,eAAO,MAAM,sBAAsB,EAAE,2BAiFpC,CAAC"}

package/dist/types/channels/telegram/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "../plugin-types";
+export declare const telegramChannelPlugin: ChannelPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/channels/telegram/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAO7D,eAAO,MAAM,qBAAqB,EAAE,aAsBnC,CAAC"}

package/dist/types/channels/telegram/runtime.d.ts

@@ -0,0 +1,6 @@
+export declare function __testOverrideLoadGrammyModule(factory: (() => Promise<typeof import("grammy")>) | null): void;
+export declare function loadGrammyModule(): Promise<typeof import("grammy")>;
+export declare function isTelegramRuntimeInstalled(): boolean;
+export declare function installTelegramRuntime(): Promise<void>;
+export declare function ensureTelegramRuntimeInstalled(): Promise<boolean>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/channels/telegram/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/runtime.ts"],"names":[],"mappings":"AAUA,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,cAAc,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,GACvD,IAAI,CAEN;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,QAAQ,CAAC,CAAC,CAMzE;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvE"}

package/dist/types/channels/telegram/setup.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Telegram bot setup wizard for `letta channels configure telegram`.
+ *
+ * Interactive CLI flow:
+ * 1. Prompt for bot token from @BotFather
+ * 2. Validate via getMe()
+ * 3. Choose DM policy
+ * 4. Write config to ~/.letta/channels/telegram/accounts.json
+ * 5. Start `letta server --channels telegram`
+ * 6. Message the bot from Telegram to get a pairing code
+ * 7. Run `/channels telegram pair <code>` in the target ADE/Desktop conversation
+ */
+export declare function runTelegramSetup(): Promise<boolean>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/types/channels/telegram/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAwIzD"}

package/dist/types/channels/telegram/startup-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { ChannelAdapterStartOptions } from "../types";
+import type { TelegramBot } from "./internal-types";
+export declare const DEFAULT_TELEGRAM_INIT_TIMEOUT_MS = 15000;
+export declare const DEFAULT_TELEGRAM_START_TIMEOUT_MS = 20000;
+export declare const TELEGRAM_FAILED_START_STOP_TIMEOUT_MS = 5000;
+export declare function getStartupTimeoutMs(envName: string, fallbackMs: number): number;
+export declare function withStartupTimeout<T>(promise: Promise<T>, label: string, timeoutMs: number): Promise<T>;
+export declare function logTelegramStartup(options: ChannelAdapterStartOptions | undefined, message: string): void;
+export declare function stopTelegramBotQuietly(telegramBot: TelegramBot, options: ChannelAdapterStartOptions | undefined): Promise<void>;
+//# sourceMappingURL=startup-helpers.d.ts.map

package/dist/types/channels/telegram/startup-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-helpers.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/startup-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,eAAO,MAAM,iCAAiC,QAAS,CAAC;AAExD,eAAO,MAAM,qCAAqC,OAAQ,CAAC;AAE3D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAC/C,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,0BAA0B,GAAG,SAAS,GAC9C,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/types/channels/telegram/typing-controller.d.ts

@@ -0,0 +1,11 @@
+import type { ChannelTurnSource } from "../types";
+export declare function createTelegramTypingController(deps: {
+    sendTypingAction: (chatId: string) => Promise<void>;
+}): {
+    clearAll: () => void;
+    clearChat: (chatId: string) => void;
+    getChatId: (source: ChannelTurnSource) => string | null;
+    start: (source: ChannelTurnSource) => void;
+    stop: (source: ChannelTurnSource) => void;
+};
+//# sourceMappingURL=typing-controller.d.ts.map

package/dist/types/channels/telegram/typing-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-controller.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/typing-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;oBAgEsB,IAAI;wBA1CE,MAAM,KAAG,IAAI;wBAnBb,iBAAiB,KAAG,MAAM,GAAG,IAAI;oBA2BrC,iBAAiB,KAAG,IAAI;mBAwBzB,iBAAiB,KAAG,IAAI;EAmB/C"}

package/dist/types/channels/telegram/utils.d.ts

@@ -0,0 +1,43 @@
+import type { ReactionType } from "@grammyjs/types";
+import type { ChannelReplyContext, ChannelRichMessage, ChannelTurnSource, OutboundChannelMessage, OutboundChannelRichMessageDraft } from "../types";
+import type { GrammYModule, TelegramBotConstructor, TelegramInputFileConstructor, TelegramInputRichMessage, TelegramMentionResult, TelegramReactionType, TelegramReactionUpdate, TelegramRichMessageDraftPayload, TelegramRichMessagePayload } from "./internal-types";
+import { type TelegramLikeMessage } from "./media";
+export declare const TELEGRAM_LIFECYCLE_ERROR_TEXT_MAX = 3500;
+export declare const TELEGRAM_LIFECYCLE_ERROR_DEDUPE_TTL_MS: number;
+export declare const TELEGRAM_LIFECYCLE_ERROR_DEDUPE_MAX = 1000;
+export declare const TELEGRAM_LIFECYCLE_ERROR_REPORT_TTL_MS: number;
+export declare const TELEGRAM_LIFECYCLE_ERROR_REPORT_MAX = 1000;
+export declare const TELEGRAM_REPORT_CALLBACK_PREFIX = "lc_report:";
+export declare function escapeRegExp(value: string): string;
+export declare function getTelegramMessageEntities(message: TelegramLikeMessage): Array<{
+    type?: string;
+    offset?: number;
+    length?: number;
+}>;
+export declare function detectTelegramBotMention(message: TelegramLikeMessage, botUsername: string | null | undefined, botDisplayName?: string | null | undefined, text?: string): TelegramMentionResult;
+export declare function resolveTelegramBotConstructor(mod: GrammYModule): TelegramBotConstructor;
+export declare function resolveTelegramInputFileConstructor(mod: GrammYModule): TelegramInputFileConstructor;
+export declare function resolveTelegramOutboundThreadId(msg: {
+    threadId?: string | null;
+}): string | null;
+export declare function buildTelegramReplyOptions(msg: Pick<OutboundChannelMessage, "chatId" | "replyToMessageId" | "threadId" | "parseMode" | "text" | "title">): Record<string, unknown>;
+export declare function toTelegramInputRichMessage(richMessage: ChannelRichMessage): TelegramInputRichMessage;
+export declare function buildTelegramRichMessagePayload(msg: Pick<OutboundChannelMessage, "chatId" | "replyToMessageId" | "threadId" | "richMessage">): TelegramRichMessagePayload;
+export declare function buildTelegramRichMessageDraftPayload(draft: Pick<OutboundChannelRichMessageDraft, "chatId" | "threadId" | "draftId" | "richMessage">): TelegramRichMessageDraftPayload;
+export declare function getTelegramErrorText(error: unknown): string;
+export declare function shouldFallbackTelegramRichMessage(error: unknown): boolean;
+export declare function getTelegramReactionToken(reaction: TelegramReactionType): string | null;
+export declare function parseTelegramReactionInput(reaction: string): ReactionType | null;
+export declare function getTelegramReactionSenderName(update: TelegramReactionUpdate): string | undefined;
+export declare function getTelegramReactionSenderId(update: TelegramReactionUpdate): string | null;
+export declare function getTelegramChatType(chat: {
+    type?: string;
+}): "direct" | "channel";
+export declare function getTelegramChatLabel(message: TelegramLikeMessage): string | undefined;
+export declare function getTelegramMessageThreadId(message: TelegramLikeMessage): string | null;
+export declare function getTelegramReplyContext(message: TelegramLikeMessage): ChannelReplyContext | undefined;
+export declare function getTelegramLifecycleErrorReplyKey(source: ChannelTurnSource): string | null;
+export declare function formatTelegramLifecycleErrorMessage(errorText: string, runId?: string | null): string;
+export declare const TELEGRAM_TYPING_REFRESH_MS = 4000;
+export declare const TELEGRAM_TYPING_MAX_MS: number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/channels/telegram/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/channels/telegram/utils.ts"],"names":[],"mappings":"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"}

package/dist/types/channels/transcription/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Voice memo transcription via OpenAI.
+ *
+ * Minimal: one API call, no format conversion, no chunking.
+ * Telegram voice memos are .ogg/opus which OpenAI transcription supports
+ * natively.
+ */
+export interface TranscriptionResult {
+    success: boolean;
+    text?: string;
+    error?: string;
+}
+/** Check whether an API key is available for transcription. */
+export declare function isTranscriptionConfigured(): boolean;
+/**
+ * Transcribe a local audio file using OpenAI's transcription API.
+ * Never throws; returns { success: false, error } on failure.
+ */
+export declare function transcribeAudioFile(localPath: string): Promise<TranscriptionResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/channels/transcription/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/channels/transcription/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmFD,+DAA+D;AAC/D,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CA0D9B"}

package/dist/types/channels/whatsapp/adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ChannelAdapter, WhatsAppChannelAccount } from "../types";
+import type { LidStore } from "./lid-store";
+import { loadWhatsAppModule } from "./runtime";
+import { createWhatsAppSocket } from "./session";
+export type WhatsAppAdapterDependencies = {
+    createSocket?: typeof createWhatsAppSocket;
+    loadRuntimeModule?: typeof loadWhatsAppModule;
+    lidStore?: LidStore;
+};
+export declare function isWhatsAppConflictDisconnect(update: unknown): boolean;
+export declare function createWhatsAppAdapter(account: WhatsAppChannelAccount, dependencies?: WhatsAppAdapterDependencies): ChannelAdapter;
+export declare function resolveWhatsAppAccountDisplayName(account: WhatsAppChannelAccount): string | undefined;
+export declare function getWhatsAppAuthPath(accountId: string): string;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/types/channels/whatsapp/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EAMd,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAsB,MAAM,WAAW,CAAC;AA4CrE,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,CAAC,EAAE,OAAO,oBAAoB,CAAC;IAC3C,iBAAiB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAQF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAarE;AAqGD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,YAAY,GAAE,2BAAgC,GAC7C,cAAc,CAsdhB;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,sBAAsB,GAC9B,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/types/channels/whatsapp/identity.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Canonical WhatsApp inbound identity resolver.
+ *
+ * Pure with respect to LidStore: only calls `store.resolve()`, never
+ * `record()` or `flush()`. Returns validated `observedMappings` that the
+ * caller may persist.
+ */
+import type { LidStore } from "./lid-store";
+export interface InboundTransport {
+    selfPhoneJid?: string | null;
+    selfLid?: string | null;
+    remoteJid: string;
+    participant?: string | null;
+    senderPn?: string | null;
+    senderLid?: string | null;
+    participantPn?: string | null;
+    participantLid?: string | null;
+}
+export interface ObservedMapping {
+    lidJid: string;
+    phoneJid: string;
+}
+export interface ResolvedIdentity {
+    chatId: string;
+    senderId: string;
+    observedMappings: ObservedMapping[];
+}
+export declare function resolveInboundIdentity(transport: InboundTransport, store?: LidStore | null): ResolvedIdentity | null;
+//# sourceMappingURL=identity.d.ts.map

package/dist/types/channels/whatsapp/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAqGD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,GAAE,QAAQ,GAAG,IAAW,GAC5B,gBAAgB,GAAG,IAAI,CAKzB"}

package/dist/types/channels/whatsapp/jid.d.ts

@@ -0,0 +1,40 @@
+export declare const WHATSAPP_CHANNEL_ID = "whatsapp";
+export declare const WHATSAPP_PHONE_SUFFIX = "@s.whatsapp.net";
+export declare const WHATSAPP_LID_SUFFIX = "@lid";
+export declare const WHATSAPP_GROUP_SUFFIX = "@g.us";
+export declare function stripDeviceSuffix(jid: string | null | undefined): string;
+export declare function isPhoneJid(jid: string | null | undefined): boolean;
+export declare function isLidJid(jid: string | null | undefined): boolean;
+export declare function isGroupJid(jid: string | null | undefined): boolean;
+/**
+ * Strict phone-JID check: suffix must be `@s.whatsapp.net` AND the localpart
+ * (before `@`) must be all digits (device suffix `:N` allowed and stripped).
+ *
+ * Use this instead of {@link isPhoneJid} when accepting external/untrusted
+ * input that could carry a non-numeric localpart (e.g. `garbage@s.whatsapp.net`).
+ */
+export declare function isStrictPhoneJid(jid: string | null | undefined): boolean;
+/**
+ * Strict LID-JID check: suffix must be `@lid` AND the localpart must be all
+ * digits (device suffix `:N` allowed and stripped).
+ *
+ * Use this instead of {@link isLidJid} when accepting external/untrusted
+ * input that could carry a non-numeric localpart.
+ */
+export declare function isStrictLidJid(jid: string | null | undefined): boolean;
+export declare function isStatusOrBroadcastJid(jid: string | null | undefined): boolean;
+export declare function jidToDigits(jid: string | null | undefined): string;
+export declare function normalizePhoneLike(value: string | null | undefined): string;
+export declare function phoneDigitsToJid(phoneDigits: string): string;
+export declare function normalizeMaybePhoneJid(value: string | null | undefined): string | null;
+export declare function isSelfChat(remoteJid: string | null | undefined, selfPhoneJid: string | null | undefined, selfLid: string | null | undefined): boolean;
+export declare function senderIdFromJid(jid: string | null | undefined): string;
+export declare function allowedUsersIncludes(allowedUsers: string[], senderId: string): boolean;
+export declare function resolveSendJid(params: {
+    chatId: string;
+    selfPhoneJid?: string | null;
+    selfLid?: string | null;
+    resolveLid?: (lidJid: string) => string | null;
+}): string;
+export declare function sanitizePathSegment(input: string): string;
+//# sourceMappingURL=jid.d.ts.map

package/dist/types/channels/whatsapp/jid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jid.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/jid.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGxE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAElE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEhE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMtE;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,OAAO,CAQT;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIlE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG3E;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,OAAO,CAQT;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEtE;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EAAE,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAChD,GAAG,MAAM,CAeT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/types/channels/whatsapp/lid-store.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Narrow persistent store: LID JID → phone JID.
+ *
+ * Invariants:
+ *   - Only strict-valid LID keys and strict-valid phone-JID values are accepted.
+ *   - Device suffixes are normalised on both keys and values.
+ *   - An existing mapping is never silently rebound. A conflicting `record()`
+ *     returns `{ status: "conflict" }` and preserves the old mapping.
+ *   - Multiple distinct LIDs may map to the same phone JID.
+ *   - Corrupt or invalid persisted entries are silently skipped.
+ *   - On load, if the same normalized LID appears with different phone JIDs,
+ *     that LID is omitted entirely (ambiguous data, not first-wins).
+ *
+ * Persistence:
+ *   - Construction loads once from disk. There is no public reload.
+ *   - `record()` mutates in-memory state only; it does NOT persist.
+ *   - `flush()` is caller-owned and writes atomically via an exclusive temp
+ *     file + rename. The caller is responsible for single-writer ownership;
+ *     no locking is provided.
+ */
+export type RecordResult = {
+    status: "recorded";
+} | {
+    status: "idempotent";
+} | {
+    status: "conflict";
+    existingPhoneJid: string;
+    requestedPhoneJid: string;
+};
+export interface LidStore {
+    /** Resolve a LID JID to its canonical phone JID, or `null` if unknown. */
+    resolve(lidJid: string): string | null;
+    /**
+     * Record a LID → phone mapping (in-memory only; does not persist).
+     *
+     * Returns `null` when either argument is invalid.
+     * Returns `"conflict"` when the LID is already mapped to a different phone;
+     * the old mapping is preserved.
+     */
+    record(lidJid: string, phoneJid: string): RecordResult | null;
+    /** Flush in-memory state to disk atomically. Caller-owned, single-writer. */
+    flush(): void;
+}
+export declare function createLidStore(filePath: string): LidStore;
+//# sourceMappingURL=lid-store.d.ts.map

package/dist/types/channels/whatsapp/lid-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lid-store.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/lid-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwBH,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GACxB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IAC9D,6EAA6E;IAC7E,KAAK,IAAI,IAAI,CAAC;CACf;AA2ED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAiEzD"}

package/dist/types/channels/whatsapp/media.d.ts

@@ -0,0 +1,24 @@
+import type { ChannelMessageAttachment, OutboundChannelMessage } from "../types";
+export declare const DEFAULT_WHATSAPP_MEDIA_MAX_BYTES: number;
+export type WhatsAppMediaKind = "image" | "video" | "audio" | "document" | "sticker";
+export declare function unwrapWhatsAppMessageContent(message: unknown): Record<string, unknown> | null;
+export declare function extractWhatsAppText(message: unknown): string;
+export declare function extractMentionedJids(message: unknown): string[];
+export declare function extractReplyParticipant(message: unknown): string | null;
+export declare function collectWhatsAppAttachments(params: {
+    accountId: string;
+    chatId: string;
+    messageId: string;
+    message: unknown;
+    downloadContentFromMessage?: (message: unknown, type: string) => Promise<AsyncIterable<Uint8Array>>;
+    downloadMedia: boolean;
+    mediaMaxBytes?: number;
+    transcribeVoice: boolean;
+}): Promise<{
+    attachments: ChannelMessageAttachment[];
+    transcriptionText?: string;
+}>;
+export declare function buildWhatsAppOutboundPayload(msg: Pick<OutboundChannelMessage, "text" | "mediaPath" | "fileName" | "title">): Record<string, unknown>;
+export declare const WHATSAPP_VOICE_MEMO_REQUIREMENT = "WhatsApp voice memos require an Ogg/Opus file (.ogg, .oga, or .opus). Convert MP3/M4A/WAV audio to Ogg Opus before upload.";
+export declare function getWhatsAppOutboundMediaValidationError(msg: Pick<OutboundChannelMessage, "mediaPath" | "fileName">): string | null;
+//# sourceMappingURL=media.d.ts.map

package/dist/types/channels/whatsapp/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/media.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,gCAAgC,QAAmB,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAQd,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBhC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgB5D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAqB/D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAoBvE;AA0ED,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B,CAAC,EAAE,CAC3B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC,CA0ED;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,IAAI,CACP,sBAAsB,EACtB,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAC5C,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB;AAED,eAAO,MAAM,+BAA+B,+HACkF,CAAC;AA0B/H,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,UAAU,CAAC,GAC1D,MAAM,GAAG,IAAI,CASf"}

package/dist/types/channels/whatsapp/message-actions.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelMessageActionAdapter } from "../plugin-types";
+export declare const whatsappMessageActions: ChannelMessageActionAdapter;
+//# sourceMappingURL=message-actions.d.ts.map

package/dist/types/channels/whatsapp/message-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-actions.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/message-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,yBAAyB,CAAC;AAkEjC,eAAO,MAAM,sBAAsB,EAAE,2BA+BpC,CAAC"}

package/dist/types/channels/whatsapp/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from "../plugin-types";
+export declare const whatsappChannelPlugin: ChannelPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/channels/whatsapp/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,eAAO,MAAM,qBAAqB,EAAE,aAmBnC,CAAC"}

package/dist/types/channels/whatsapp/runtime.d.ts

@@ -0,0 +1,25 @@
+export type WhatsAppRuntimeModule = Record<string, unknown> & {
+    default?: unknown;
+    makeWASocket?: unknown;
+    useMultiFileAuthState?: unknown;
+    fetchLatestBaileysVersion?: unknown;
+    DisconnectReason?: Record<string, number>;
+    downloadContentFromMessage?: unknown;
+    makeCacheableSignalKeyStore?: unknown;
+};
+export type QrCodeTerminalModule = {
+    default?: {
+        generate?: (input: string, options?: {
+            small?: boolean;
+        }, callback?: (output: string) => void) => void;
+    };
+    generate?: (input: string, options?: {
+        small?: boolean;
+    }, callback?: (output: string) => void) => void;
+};
+export declare function loadWhatsAppModule(): Promise<WhatsAppRuntimeModule>;
+export declare function loadQrCodeTerminalModule(): Promise<QrCodeTerminalModule>;
+export declare function isWhatsAppRuntimeInstalled(): boolean;
+export declare function installWhatsAppRuntime(): Promise<void>;
+export declare function ensureWhatsAppRuntimeInstalled(): Promise<boolean>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/channels/whatsapp/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/runtime.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,EAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAChC,IAAI,CAAC;KACX,CAAC;IACF,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,KAChC,IAAI,CAAC;CACX,CAAC;AAEF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAKzE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAK9E;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5D;AAED,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,OAAO,CAAC,CAEvE"}

package/dist/types/channels/whatsapp/session.d.ts

@@ -0,0 +1,51 @@
+import type { QrCodeTerminalModule } from "./runtime";
+export declare function installWhatsAppConsoleFilters(): void;
+export declare function getWhatsAppAuthDir(accountId: string): string;
+type WhatsAppSocket = {
+    ev?: {
+        on?: (event: string, handler: (payload?: unknown) => void) => void;
+    };
+    ws?: {
+        close?: () => void;
+    };
+    user?: {
+        id?: string;
+        lid?: string;
+    };
+};
+type WhatsAppConnectionUpdate = Record<string, unknown> & {
+    qr?: string;
+    connection?: string;
+    lastDisconnect?: {
+        error?: {
+            message?: string;
+            output?: {
+                statusCode?: number;
+            };
+        };
+    };
+};
+type CreateSocketResult = {
+    sock: WhatsAppSocket;
+    saveCreds: () => Promise<void>;
+    DisconnectReason: Record<string, number>;
+    release: () => void;
+};
+type WhatsAppSessionLease = {
+    path: string;
+    release: () => void;
+};
+export declare function acquireWhatsAppSessionLease(accountId: string, options?: {
+    lockDir?: string;
+    pid?: number;
+    isProcessAlive?: (pid: number) => boolean;
+}): WhatsAppSessionLease;
+export declare function renderQrTerminal(qrMod: QrCodeTerminalModule | null, input: string): string | undefined;
+export declare function createWhatsAppSocket(params: {
+    accountId: string;
+    printQr?: boolean;
+    messageStore?: Map<string, unknown>;
+    onConnectionUpdate?: (update: WhatsAppConnectionUpdate) => void;
+}): Promise<CreateSocketResult>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/types/channels/whatsapp/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAiCtD,wBAAgB,6BAA6B,IAAI,IAAI,CA4BpD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,KAAK,cAAc,GAAG;IACpB,EAAE,CAAC,EAAE;QACH,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;KACpE,CAAC;IACF,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC5B,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC,CAAC;AAIF,KAAK,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QACf,KAAK,CAAC,EAAE;YACN,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE;gBAAE,UAAU,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;SAClC,CAAC;KACH,CAAC;CACH,CAAC;AAOF,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAoCF,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACtC,GACL,oBAAoB,CA2DtB;AA8BD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAClC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAoBpB;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACjE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6H9B"}

package/dist/types/channels/whatsapp/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runWhatsAppSetup(): Promise<boolean>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/types/channels/whatsapp/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/setup.ts"],"names":[],"mappings":"AAyBA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAgJzD"}

package/dist/types/channels/whatsapp/state.d.ts

@@ -0,0 +1,18 @@
+export type WhatsAppConnectionStatus = "idle" | "qr" | "connecting" | "connected" | "disconnected" | "logged_out" | "error";
+export interface WhatsAppConnectionState {
+    status: WhatsAppConnectionStatus;
+    qr?: string;
+    qrTerminal?: string;
+    phoneJid?: string;
+    lid?: string;
+    lastError?: string;
+    updatedAt: string;
+}
+type Listener = (accountId: string, state: WhatsAppConnectionState) => void;
+export declare function getWhatsAppConnectionState(accountId: string): WhatsAppConnectionState;
+export declare function setWhatsAppConnectionState(accountId: string, patch: Omit<Partial<WhatsAppConnectionState>, "updatedAt">): WhatsAppConnectionState;
+export declare function clearWhatsAppConnectionState(accountId: string): void;
+export declare function subscribeWhatsAppConnectionState(listener: Listener): () => void;
+export declare function toWhatsAppConnectionConfig(accountId: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/types/channels/whatsapp/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/channels/whatsapp/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,IAAI,GACJ,YAAY,GACZ,WAAW,GACX,cAAc,GACd,YAAY,GACZ,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,wBAAwB,CAAC;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;AAK5E,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAChB,uBAAuB,CAOzB;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,GACzD,uBAAuB,CAgBzB;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,GACjB,MAAM,IAAI,CAGZ;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/dist/types/channels/xml.d.ts

@@ -0,0 +1,32 @@
+/**
+ * XML formatting for channel notifications.
+ *
+ * Produces structured XML that the agent receives as message content.
+ * Follows the same escaping patterns used in taskNotifications.ts.
+ */
+import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
+import type { InboundChannelMessage } from "./types";
+/**
+ * Format the reminder text that explains channel reply semantics to the agent.
+ */
+export declare function buildChannelReminderText(msg: InboundChannelMessage): string;
+/**
+ * Format an inbound channel message as XML for the agent.
+ *
+ * Example output:
+ * ```xml
+ * <channel-notification source="telegram" chat_id="12345" sender_id="67890" sender_name="John">
+ * Hello from Telegram!
+ * </channel-notification>
+ * ```
+ */
+export declare function buildChannelNotificationXml(msg: InboundChannelMessage): string;
+/**
+ * Format an inbound channel message as structured content parts.
+ *
+ * The reminder and the notification XML are emitted as separate text parts so
+ * UIs that already know how to hide pure system-reminder parts can do so
+ * without needing to parse concatenated XML blobs.
+ */
+export declare function formatChannelNotification(msg: InboundChannelMessage): MessageCreate["content"];
+//# sourceMappingURL=xml.d.ts.map

package/dist/types/channels/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../src/channels/xml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAGpF,OAAO,KAAK,EAGV,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA6CjB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAoB3E;AAoOD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,qBAAqB,GACzB,MAAM,CA+CR;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,qBAAqB,GACzB,aAAa,CAAC,SAAS,CAAC,CA2B1B"}

package/dist/types/channels-public.d.ts

@@ -1,6 +1,6 @@
 export type { CollectLettaSseAssistantTextOptions, CollectLettaSseAssistantTextResult, FormatLettaStreamCoreErrorOptions, LettaStreamErrorParams, } from "./channels/core-stream";
 export { collectLettaSseAssistantText, formatLettaStreamCoreErrorForChannel, LETTA_STREAM_NO_ASSISTANT_MESSAGE_ERROR, LettaStreamCoreError, LettaStreamNoAssistantMessageError, } from "./channels/core-stream";
-export type { ChannelMessageActionAdapter, ChannelMessageActionContext, ChannelMessageActionRequest, ChannelResolvedMessageTarget, } from "./channels/plugin-types";
+export type { ChannelMessageActionAdapter, ChannelMessageActionContext, ChannelMessageActionRequest, ChannelMessageActionRoute, ChannelMessageActionTransport, ChannelResolvedMessageTarget, } from "./channels/plugin-types";
 export type { BuildChannelTurnSourceParams, BuildOutboundChannelMessageFromTurnSourceParams, ChannelBatchMessage, FormatBatchedChannelMessagesParams, FormatInboundChannelMessageParams, } from "./channels/processor";
 export { buildChannelTurnSource, buildOutboundChannelMessageFromTurnSource, formatBatchedChannelMessagesForAgent, formatInboundChannelMessageForAgent, } from "./channels/processor";
 export { type ChannelTurnProgressBuilder, createChannelTurnProgressBuilder, } from "./channels/progress-builder";

package/dist/types/channels-public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels-public.d.ts","sourceRoot":"","sources":["../../src/channels-public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mCAAmC,EACnC,kCAAkC,EAClC,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,uCAAuC,EACvC,oBAAoB,EACpB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,4BAA4B,EAC5B,+CAA+C,EAC/C,mBAAmB,EACnB,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,yCAAyC,EACzC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,0BAA0B,EAC/B,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"channels-public.d.ts","sourceRoot":"","sources":["../../src/channels-public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mCAAmC,EACnC,kCAAkC,EAClC,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,uCAAuC,EACvC,oBAAoB,EACpB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,4BAA4B,EAC5B,+CAA+C,EAC/C,mBAAmB,EACnB,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,yCAAyC,EACzC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,0BAA0B,EAC/B,gCAAgC,GACjC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,cAAc,EACd,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/types/channels-slack.d.ts

@@ -1,5 +1,7 @@
 export type { ResolveSlackAppMentionIngressPolicyParams, ResolveSlackMessageIngressPolicyParams, SlackAppMentionEventLike, SlackAppMentionIngressAccepted, SlackAppMentionIngressPolicy, SlackInboundMessageEventLike, SlackIngressIgnored, SlackIngressIgnoreReason, SlackMessageIngressAccepted, SlackMessageIngressPolicy, } from "./channels/slack/ingress-policy";
 export { isProcessableSlackInboundMessage, resolveSlackAppMentionIngressPolicy, resolveSlackMessageIngressPolicy, shouldSkipSlackMessageByLastSeen, } from "./channels/slack/ingress-policy";
+export type { CreateSlackMessageActionAdapterOptions } from "./channels/slack/message-action-contract";
+export { createSlackMessageActionAdapter } from "./channels/slack/message-action-contract";
 export { resolveSlackConcreteActivity, SLACK_ASSISTANT_STARTUP_STATUS, SLACK_ASSISTANT_WORKING_STATUS, } from "./channels/slack/progress";
 export { normalizeSlackReactionName, normalizeSlackText, resolveSlackChatType, resolveSlackOutboundThreadTs, slackTimestampToMillis, } from "./channels/slack/public-utils";
 export type { CreateSlackChannelSenderParams, SlackChannelSender, SlackDirectReplyParams, SlackSenderClient, SlackSenderMessageResult, SlackSenderPostMessageParams, SlackSenderPostMessageResult, SlackSenderReactionParams, } from "./channels/slack/sender";

package/dist/types/channels-slack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels-slack.d.ts","sourceRoot":"","sources":["../../src/channels-slack.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yCAAyC,EACzC,sCAAsC,EACtC,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,mCAAmC,EACnC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"channels-slack.d.ts","sourceRoot":"","sources":["../../src/channels-slack.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,yCAAyC,EACzC,sCAAsC,EACtC,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,mCAAmC,EACnC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,sCAAsC,EAAE,MAAM,0CAA0C,CAAC;AACvG,OAAO,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAC3F,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}