@mono-agent/messenger-adapter 0.21.0

package/dist/config.js.map

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

package/dist/graph-client.d.ts

@@ -0,0 +1,92 @@
+import type { MessengerMessagingType } from "./config.js";
+export declare const DEFAULT_GRAPH_API_BASE_URL = "https://graph.facebook.com";
+export type MessengerSenderAction = "typing_on" | "typing_off" | "mark_seen";
+export interface MessengerSendOptions {
+    readonly messagingType?: MessengerMessagingType;
+    readonly tag?: string;
+    readonly maxMessageChars?: number;
+}
+export interface MessengerSendResult {
+    /** Send API message ids in delivery order (one per chunk). */
+    readonly messageIds: readonly string[];
+}
+export interface MessengerGraphClientLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface MessengerGraphClientOptions {
+    readonly pageAccessToken: string;
+    readonly apiVersion: string;
+    readonly baseUrl?: string;
+    readonly fetch?: typeof fetch;
+    readonly timeoutMs?: number;
+    readonly logger?: MessengerGraphClientLogger;
+}
+/** Minimal surface the adapter and stream depend on; tests inject fakes. */
+export interface MessengerGraphClientLike {
+    sendText(recipientId: string, text: string, options?: MessengerSendOptions): Promise<MessengerSendResult>;
+    sendAttachmentUrl(recipientId: string, attachmentType: "image" | "video" | "audio" | "file", url: string, options?: MessengerSendOptions): Promise<MessengerSendResult>;
+    senderAction(recipientId: string, action: MessengerSenderAction): Promise<void>;
+}
+export declare class MessengerGraphError extends Error {
+    readonly status: number;
+    readonly detail: unknown;
+    /** Bounded `Retry-After` from the response, when the server sent a usable one. */
+    readonly retryAfterMs: number | undefined;
+    constructor(status: number, detail: unknown, retryAfterMs?: number);
+    get retryable(): boolean;
+    /**
+     * True when the server definitively refused to act on the request. A 429 is
+     * a pre-processing rejection, so replaying it cannot duplicate a message; a
+     * 5xx may have been applied before the failure and is ambiguous instead.
+     */
+    get definitivelyRejected(): boolean;
+}
+/**
+ * A non-idempotent Send API POST whose outcome is unknown: the request may have
+ * been accepted by Meta and only its response lost. It is deliberately NOT
+ * retried — a replay would deliver the message twice — and is surfaced so the
+ * caller can report an ambiguous delivery instead of silently duplicating or
+ * silently dropping it.
+ */
+export declare class MessengerAmbiguousDeliveryError extends Error {
+    readonly path: string;
+    readonly cause: unknown;
+    /** Chunks already confirmed delivered before the ambiguous one, in order. */
+    readonly deliveredMessageIds: readonly string[];
+    constructor(path: string, cause: unknown, deliveredMessageIds?: readonly string[]);
+}
+export declare function isMessengerAmbiguousDeliveryError(error: unknown): error is MessengerAmbiguousDeliveryError;
+/** Thin Send API client over global `fetch`; retries one transient failure per request. */
+export declare class MessengerGraphClient implements MessengerGraphClientLike {
+    private readonly pageAccessToken;
+    private readonly apiVersion;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private readonly logger;
+    constructor(options: MessengerGraphClientOptions);
+    sendText(recipientId: string, text: string, options?: MessengerSendOptions): Promise<MessengerSendResult>;
+    sendAttachmentUrl(recipientId: string, attachmentType: "image" | "video" | "audio" | "file", url: string, options?: MessengerSendOptions): Promise<MessengerSendResult>;
+    senderAction(recipientId: string, action: MessengerSenderAction): Promise<void>;
+    /**
+     * A replay-safe POST: retried once on any transient failure, because a
+     * duplicate delivery of this request has no user-visible effect.
+     */
+    private postReplaySafe;
+    /**
+     * A message-bearing POST. Meta's Send API has no idempotency key, so the only
+     * safe retry is one the server definitively refused before acting (429).
+     * Every other transient outcome — timeout, transport failure, 5xx — may have
+     * been applied on Meta's side, and is surfaced as
+     * {@link MessengerAmbiguousDeliveryError} rather than replayed into a
+     * duplicate message.
+     */
+    private postDelivery;
+    /** Classify a failed delivery POST as ambiguous (unknown outcome) or a clean rejection. */
+    private asDeliveryFailure;
+    private postOnce;
+}
+/** Parse `Retry-After` (delta-seconds or HTTP-date) into a bounded millisecond delay. */
+export declare function retryAfterMsFromHeader(header: string | null): number | undefined;
+//# sourceMappingURL=graph-client.d.ts.map

package/dist/graph-client.d.ts.map

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

package/dist/graph-client.js

@@ -0,0 +1,296 @@
+import { splitForMessenger, MESSENGER_MAX_MESSAGE_CHARS } from "./text.js";
+export const DEFAULT_GRAPH_API_BASE_URL = "https://graph.facebook.com";
+const DEFAULT_TIMEOUT_MS = 20_000;
+const RETRY_DELAY_MS = 1_000;
+/** Upper bound on an honored `Retry-After`, so a hostile/typo'd header cannot park a turn. */
+const MAX_RETRY_AFTER_MS = 10_000;
+/** Cap on any retained error string, applied after redaction. */
+const MAX_DETAIL_CHARS = 2_000;
+export class MessengerGraphError extends Error {
+    status;
+    detail;
+    /** Bounded `Retry-After` from the response, when the server sent a usable one. */
+    retryAfterMs;
+    constructor(status, detail, retryAfterMs) {
+        super(`Messenger Graph API request failed with HTTP ${status}.`);
+        this.name = "MessengerGraphError";
+        this.status = status;
+        this.detail = detail;
+        this.retryAfterMs = retryAfterMs;
+    }
+    get retryable() {
+        return this.status === 429 || this.status >= 500;
+    }
+    /**
+     * True when the server definitively refused to act on the request. A 429 is
+     * a pre-processing rejection, so replaying it cannot duplicate a message; a
+     * 5xx may have been applied before the failure and is ambiguous instead.
+     */
+    get definitivelyRejected() {
+        return this.status === 429;
+    }
+}
+/**
+ * A non-idempotent Send API POST whose outcome is unknown: the request may have
+ * been accepted by Meta and only its response lost. It is deliberately NOT
+ * retried — a replay would deliver the message twice — and is surfaced so the
+ * caller can report an ambiguous delivery instead of silently duplicating or
+ * silently dropping it.
+ */
+export class MessengerAmbiguousDeliveryError extends Error {
+    path;
+    cause;
+    /** Chunks already confirmed delivered before the ambiguous one, in order. */
+    deliveredMessageIds;
+    constructor(path, cause, deliveredMessageIds = []) {
+        super(`Messenger Send API request to ${path} has an unknown outcome and was not retried.`);
+        this.name = "MessengerAmbiguousDeliveryError";
+        this.path = path;
+        this.cause = cause;
+        this.deliveredMessageIds = deliveredMessageIds;
+    }
+}
+export function isMessengerAmbiguousDeliveryError(error) {
+    return error instanceof MessengerAmbiguousDeliveryError;
+}
+/** Thin Send API client over global `fetch`; retries one transient failure per request. */
+export class MessengerGraphClient {
+    pageAccessToken;
+    apiVersion;
+    baseUrl;
+    fetchImpl;
+    timeoutMs;
+    logger;
+    constructor(options) {
+        if (options.pageAccessToken.length === 0) {
+            throw new TypeError("MessengerGraphClient requires a page access token.");
+        }
+        this.pageAccessToken = options.pageAccessToken;
+        this.apiVersion = options.apiVersion;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_GRAPH_API_BASE_URL).replace(/\/+$/u, "");
+        this.fetchImpl = options.fetch ?? fetch;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.logger = options.logger;
+    }
+    async sendText(recipientId, text, options) {
+        const chunks = splitForMessenger(text, options?.maxMessageChars ?? MESSENGER_MAX_MESSAGE_CHARS);
+        const messageIds = [];
+        for (const chunk of chunks) {
+            // Report the chunks already on their way when a later one goes ambiguous,
+            // so the caller can describe a partial delivery instead of guessing.
+            const data = await this.postDelivery("/me/messages", {
+                ...basePayload(recipientId, options),
+                message: { text: chunk },
+            }, messageIds);
+            const messageId = readMessageId(data);
+            if (messageId !== undefined) {
+                messageIds.push(messageId);
+            }
+        }
+        return { messageIds };
+    }
+    async sendAttachmentUrl(recipientId, attachmentType, url, options) {
+        const data = await this.postDelivery("/me/messages", {
+            ...basePayload(recipientId, options),
+            message: { attachment: { type: attachmentType, payload: { url, is_reusable: true } } },
+        }, []);
+        const messageId = readMessageId(data);
+        return { messageIds: messageId === undefined ? [] : [messageId] };
+    }
+    async senderAction(recipientId, action) {
+        // Sender actions are replay-safe: `typing_on`/`typing_off`/`mark_seen` are
+        // state assignments, so a duplicate is a no-op rather than a second message.
+        await this.postReplaySafe("/me/messages", { recipient: { id: recipientId }, sender_action: action });
+    }
+    /**
+     * A replay-safe POST: retried once on any transient failure, because a
+     * duplicate delivery of this request has no user-visible effect.
+     */
+    async postReplaySafe(path, payload) {
+        try {
+            return await this.postOnce(path, payload);
+        }
+        catch (error) {
+            const retryable = error instanceof MessengerGraphError ? error.retryable : isNetworkError(error);
+            if (!retryable) {
+                throw error;
+            }
+            this.logger?.debug?.("Messenger Graph API request failed; retrying once.", {
+                path,
+                error: errorText(error),
+            });
+            await delay(retryDelayFor(error));
+            return await this.postOnce(path, payload);
+        }
+    }
+    /**
+     * A message-bearing POST. Meta's Send API has no idempotency key, so the only
+     * safe retry is one the server definitively refused before acting (429).
+     * Every other transient outcome — timeout, transport failure, 5xx — may have
+     * been applied on Meta's side, and is surfaced as
+     * {@link MessengerAmbiguousDeliveryError} rather than replayed into a
+     * duplicate message.
+     */
+    async postDelivery(path, payload, deliveredMessageIds) {
+        try {
+            return await this.postOnce(path, payload);
+        }
+        catch (error) {
+            if (error instanceof MessengerGraphError && error.definitivelyRejected) {
+                this.logger?.debug?.("Messenger Send API rejected the request before delivery; retrying once.", {
+                    path,
+                    status: error.status,
+                });
+                await delay(retryDelayFor(error));
+                try {
+                    return await this.postOnce(path, payload);
+                }
+                catch (retryError) {
+                    throw this.asDeliveryFailure(path, retryError, deliveredMessageIds);
+                }
+            }
+            throw this.asDeliveryFailure(path, error, deliveredMessageIds);
+        }
+    }
+    /** Classify a failed delivery POST as ambiguous (unknown outcome) or a clean rejection. */
+    asDeliveryFailure(path, error, deliveredMessageIds) {
+        const ambiguous = error instanceof MessengerGraphError
+            ? error.status >= 500
+            : isNetworkError(error);
+        if (!ambiguous) {
+            return error;
+        }
+        this.logger?.warn?.("Messenger Send API outcome is unknown; not retrying a non-idempotent send.", {
+            path,
+            error: errorText(error),
+            deliveredMessageIds: deliveredMessageIds.length,
+        });
+        return new MessengerAmbiguousDeliveryError(path, error, [...deliveredMessageIds]);
+    }
+    async postOnce(path, payload) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchImpl(`${this.baseUrl}/${this.apiVersion}${path}`, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${this.pageAccessToken}`,
+                    "content-type": "application/json",
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            const text = await response.text();
+            let data = text;
+            try {
+                data = text.length === 0 ? {} : JSON.parse(text);
+            }
+            catch {
+                // Non-JSON error bodies are surfaced as text.
+            }
+            if (response.status >= 400) {
+                throw new MessengerGraphError(response.status, redactGraphError(data, this.pageAccessToken), retryAfterMsFromHeader(response.headers.get("retry-after")));
+            }
+            return data;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function delay(ms) {
+    return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
+}
+function retryDelayFor(error) {
+    const advertised = error instanceof MessengerGraphError ? error.retryAfterMs : undefined;
+    return advertised ?? RETRY_DELAY_MS;
+}
+/** Parse `Retry-After` (delta-seconds or HTTP-date) into a bounded millisecond delay. */
+export function retryAfterMsFromHeader(header) {
+    if (header === null) {
+        return undefined;
+    }
+    const trimmed = header.trim();
+    const seconds = Number(trimmed);
+    const ms = Number.isFinite(seconds) && trimmed.length > 0
+        ? seconds * 1_000
+        : Date.parse(trimmed) - Date.now();
+    if (!Number.isFinite(ms) || ms <= 0) {
+        return undefined;
+    }
+    return Math.min(ms, MAX_RETRY_AFTER_MS);
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function basePayload(recipientId, options) {
+    const messagingType = options?.messagingType ?? "RESPONSE";
+    return {
+        recipient: { id: recipientId },
+        messaging_type: messagingType,
+        ...(messagingType === "MESSAGE_TAG" && options?.tag !== undefined ? { tag: options.tag } : {}),
+    };
+}
+function readMessageId(data) {
+    if (typeof data !== "object" || data === null) {
+        return undefined;
+    }
+    const messageId = data.message_id;
+    return typeof messageId === "string" && messageId.length > 0 ? messageId : undefined;
+}
+function isNetworkError(error) {
+    return error instanceof Error && (error.name === "AbortError" || error.name === "TypeError");
+}
+const REDACTED = "<redacted>";
+/**
+ * Keep Graph error bodies inspectable but never echo the configured credential.
+ *
+ * Meta reflects request content in some error messages, so every retained
+ * string is scrubbed of the exact configured token plus the usual bearer and
+ * query-parameter carriers. Structured bodies are reduced to an allowlist of
+ * scalar diagnostic fields — anything not on it is dropped rather than trusted,
+ * so a newly added Graph field cannot leak a credential by default.
+ */
+function redactGraphError(data, pageAccessToken) {
+    if (typeof data === "string") {
+        return sanitizeErrorString(data, pageAccessToken);
+    }
+    if (typeof data === "object" && data !== null && "error" in data) {
+        const error = data.error;
+        if (typeof error === "object" && error !== null) {
+            const source = error;
+            const out = {};
+            for (const key of ["message", "type", "code", "error_subcode", "fbtrace_id"]) {
+                const value = sanitizeScalar(source[key], pageAccessToken);
+                if (value !== undefined) {
+                    out[key] = value;
+                }
+            }
+            return out;
+        }
+        return { error: sanitizeScalar(error, pageAccessToken) };
+    }
+    return typeof data === "object" && data !== null ? {} : sanitizeScalar(data, pageAccessToken);
+}
+/** Retain only bounded scalars, redacted; everything else becomes `undefined`. */
+function sanitizeScalar(value, pageAccessToken) {
+    if (typeof value === "string") {
+        return sanitizeErrorString(value, pageAccessToken);
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    return undefined;
+}
+function sanitizeErrorString(value, pageAccessToken) {
+    let out = value;
+    // The configured credential first: a reflected token is the one value we know
+    // exactly, and it may appear with no surrounding `access_token=` marker.
+    if (pageAccessToken.length > 0) {
+        out = out.split(pageAccessToken).join(REDACTED);
+    }
+    out = out.replace(/access_token=[^&\s"']+/giu, `access_token=${REDACTED}`);
+    out = out.replace(/\bBearer\s+[A-Za-z0-9._~+/-]+=*/giu, `Bearer ${REDACTED}`);
+    return out.slice(0, MAX_DETAIL_CHARS);
+}
+//# sourceMappingURL=graph-client.js.map

package/dist/graph-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { AgentRequest, AgentResponder, AgentResponse, MessengerAdapterLogger, MessengerAdapterMessages, MessengerAdapterOptions, MessengerAttachmentIngestOptions, MessengerEventResult, MessengerIgnoredReason, MessengerNotifyOptions, MessengerNotifyResult, MessengerProactiveOptions, MessengerRequestMetadata, MessengerWebhookAttachment, MessengerWebhookEvent, } from "./adapter.js";
+export { DEFAULT_MESSENGER_ATTACHMENT_HOST_SUFFIXES, MESSENGER_CHANNEL_ID, MessengerAdapter, attachmentUrlPolicyRejection, isPublicUnicastAddress, isSafeAttachmentUrl, messengerConversationId, messengerUserIdFromConversation, } from "./adapter.js";
+export { DEFAULT_MESSENGER_API_VERSION, DEFAULT_MESSENGER_HOST, DEFAULT_MESSENGER_PORT, DEFAULT_MESSENGER_WEBHOOK_PATH, MESSENGER_CONFIG_FIELDS, MESSENGER_ENV_ONLY_SECRET_KEYS, MESSENGER_MESSAGING_TYPES, MessengerAdapterConfigError, assertMessengerBindAllowed, assertNoMessengerSecretsInJson, assertValidMessengerAdapterConfig, isLoopbackHost, loadMessengerAdapterConfig, redactMessengerAdapterConfig, } from "./config.js";
+export type { LoadMessengerAdapterConfigInput, MessengerAdapterConfig, MessengerAdapterConfigErrorCode, MessengerAdapterConfigErrorDetails, MessengerMessagingType, RedactedMessengerAdapterConfig, } from "./config.js";
+export { DEFAULT_GRAPH_API_BASE_URL, MessengerAmbiguousDeliveryError, MessengerGraphClient, MessengerGraphError, isMessengerAmbiguousDeliveryError, } from "./graph-client.js";
+export type { MessengerGraphClientLike, MessengerGraphClientLogger, MessengerGraphClientOptions, MessengerSendOptions, MessengerSendResult, MessengerSenderAction, } from "./graph-client.js";
+export type { AgentMessageStream } from "@mono-agent/agent-contracts";
+export { MessengerMessageStream } from "./message-stream.js";
+export type { MessengerMessageStreamLogger, MessengerMessageStreamOptions } from "./message-stream.js";
+export { createMessengerWebhookServer } from "./server.js";
+export type { MessengerWebhookServer, MessengerWebhookServerLogger, MessengerWebhookServerOptions, } from "./server.js";
+export { startMessengerAdapter } from "./start.js";
+export type { MessengerAdapterStartLogger, MessengerAdapterStartResult, StartMessengerAdapterOptions, } from "./start.js";
+export { MESSENGER_MAX_MESSAGE_CHARS, splitForMessenger, stripMarkdownForMessenger, verifyMessengerSignature, } from "./text.js";
+export { createChannelDriver, createMessengerChannelDriver } from "./channel-driver.js";
+export type { MessengerChannelDriverConfig, MessengerChannelDriverOptions } from "./channel-driver.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,0CAA0C,EAC1C,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,+BAA+B,EAC/B,sBAAsB,EACtB,+BAA+B,EAC/B,kCAAkC,EAClC,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEvG,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { DEFAULT_MESSENGER_ATTACHMENT_HOST_SUFFIXES, MESSENGER_CHANNEL_ID, MessengerAdapter, attachmentUrlPolicyRejection, isPublicUnicastAddress, isSafeAttachmentUrl, messengerConversationId, messengerUserIdFromConversation, } from "./adapter.js";
+export { DEFAULT_MESSENGER_API_VERSION, DEFAULT_MESSENGER_HOST, DEFAULT_MESSENGER_PORT, DEFAULT_MESSENGER_WEBHOOK_PATH, MESSENGER_CONFIG_FIELDS, MESSENGER_ENV_ONLY_SECRET_KEYS, MESSENGER_MESSAGING_TYPES, MessengerAdapterConfigError, assertMessengerBindAllowed, assertNoMessengerSecretsInJson, assertValidMessengerAdapterConfig, isLoopbackHost, loadMessengerAdapterConfig, redactMessengerAdapterConfig, } from "./config.js";
+export { DEFAULT_GRAPH_API_BASE_URL, MessengerAmbiguousDeliveryError, MessengerGraphClient, MessengerGraphError, isMessengerAmbiguousDeliveryError, } from "./graph-client.js";
+export { MessengerMessageStream } from "./message-stream.js";
+export { createMessengerWebhookServer } from "./server.js";
+export { startMessengerAdapter } from "./start.js";
+export { MESSENGER_MAX_MESSAGE_CHARS, splitForMessenger, stripMarkdownForMessenger, verifyMessengerSignature, } from "./text.js";
+export { createChannelDriver, createMessengerChannelDriver } from "./channel-driver.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,0CAA0C,EAC1C,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAUrB,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAO3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAOnD,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/message-stream.d.ts

@@ -0,0 +1,37 @@
+import { type AgentMessageFinishOptions, type AgentMessageStream } from "@mono-agent/agent-contracts";
+import type { MessengerGraphClientLike, MessengerSendOptions } from "./graph-client.js";
+export interface MessengerMessageStreamLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+    error?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface MessengerMessageStreamOptions {
+    readonly client: MessengerGraphClientLike;
+    readonly recipientId: string;
+    readonly send?: MessengerSendOptions;
+    readonly maxMessageChars?: number;
+    /** Flatten Markdown before sending (Messenger renders plain text). Default true. */
+    readonly stripMarkdown?: boolean;
+    readonly logger?: MessengerMessageStreamLogger;
+}
+/**
+ * Buffered, final-only stream: Messenger cannot edit a sent message, so
+ * intermediate deltas are accumulated and the final answer is posted once as
+ * one or more 2,000-character Send API messages.
+ */
+export declare class MessengerMessageStream implements AgentMessageStream {
+    private readonly client;
+    private readonly recipientId;
+    private readonly send;
+    private readonly stripMarkdown;
+    private readonly logger;
+    private currentText;
+    private finished;
+    constructor(options: MessengerMessageStreamOptions);
+    status(): Promise<void>;
+    append(delta: string): Promise<void>;
+    replace(text: string): Promise<void>;
+    finish(finalText?: string, options?: AgentMessageFinishOptions): Promise<void>;
+    private assertOpen;
+}
+//# sourceMappingURL=message-stream.d.ts.map

package/dist/message-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-stream.d.ts","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;CAChD;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,6BAA6B;IAQ5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpF,OAAO,CAAC,UAAU;CAKnB"}

package/dist/message-stream.js

@@ -0,0 +1,62 @@
+import { DEFAULT_EMPTY_FINAL_TEXT, appendReplyPartFallback, normalizeTrailing, } from "@mono-agent/agent-contracts";
+import { MESSENGER_MAX_MESSAGE_CHARS, stripMarkdownForMessenger } from "./text.js";
+/**
+ * Buffered, final-only stream: Messenger cannot edit a sent message, so
+ * intermediate deltas are accumulated and the final answer is posted once as
+ * one or more 2,000-character Send API messages.
+ */
+export class MessengerMessageStream {
+    client;
+    recipientId;
+    send;
+    stripMarkdown;
+    logger;
+    currentText = "";
+    finished = false;
+    constructor(options) {
+        this.client = options.client;
+        this.recipientId = options.recipientId;
+        this.send = { ...options.send, maxMessageChars: options.maxMessageChars ?? MESSENGER_MAX_MESSAGE_CHARS };
+        this.stripMarkdown = options.stripMarkdown !== false;
+        this.logger = options.logger;
+    }
+    async status() {
+        // Typing indicators are owned by the adapter; Messenger has no status message to edit.
+        this.assertOpen();
+    }
+    async append(delta) {
+        this.assertOpen();
+        this.currentText += delta;
+    }
+    async replace(text) {
+        this.assertOpen();
+        this.currentText = text;
+    }
+    async finish(finalText, options) {
+        if (this.finished) {
+            return;
+        }
+        this.finished = true;
+        const deliveredText = appendReplyPartFallback(finalText, options?.parts);
+        if (deliveredText !== undefined) {
+            this.currentText = deliveredText;
+        }
+        const text = normalizeTrailing(this.currentText, DEFAULT_EMPTY_FINAL_TEXT);
+        const rendered = this.stripMarkdown ? normalizeTrailing(stripMarkdownForMessenger(text), DEFAULT_EMPTY_FINAL_TEXT) : text;
+        try {
+            await this.client.sendText(this.recipientId, rendered, this.send);
+        }
+        catch (error) {
+            this.logger?.error?.("Messenger stream send failed.", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    assertOpen() {
+        if (this.finished) {
+            throw new Error("Cannot write to a finished MessengerMessageStream.");
+        }
+    }
+}
+//# sourceMappingURL=message-stream.js.map

package/dist/message-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-stream.js","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAkBnF;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAA2B;IACjC,WAAW,CAAS;IACpB,IAAI,CAAuB;IAC3B,aAAa,CAAU;IACvB,MAAM,CAA2C;IAC1D,WAAW,GAAG,EAAE,CAAC;IACjB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,OAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,2BAA2B,EAAE,CAAC;QACzG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,KAAK,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM;QACV,uFAAuF;QACvF,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAkB,EAAE,OAAmC;QAClE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,aAAa,GAAG,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACzE,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,aAAa,CAAC;QACnC,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;QAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1H,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,+BAA+B,EAAE;gBACpD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,38 @@
+export interface MessengerWebhookServerLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+    error?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface MessengerWebhookServerOptions {
+    readonly host: string;
+    readonly port: number;
+    readonly webhookPath: string;
+    readonly verifyToken: string;
+    readonly appSecret: string;
+    /**
+     * Explicit opt-in for a non-loopback bind. Required (not optional-defaulting)
+     * so a direct caller of this low-level factory has to make the same decision
+     * the config loader does; `start()` re-checks it immediately before `listen()`.
+     */
+    readonly allowNonLoopback: boolean;
+    readonly maxBodyBytes?: number;
+    readonly logger?: MessengerWebhookServerLogger;
+    /** Called after the 200 reply; processing must not delay Meta's delivery ack. */
+    readonly onPayload: (payload: unknown) => Promise<unknown> | unknown;
+    /** Called when the listening server dies after a successful start. */
+    readonly onServerError?: (reason: string) => void;
+}
+export interface MessengerWebhookServer {
+    start(): Promise<{
+        readonly host: string;
+        readonly port: number;
+    }>;
+    stop(): Promise<void>;
+}
+/**
+ * Meta webhook endpoint: `GET <path>` answers the `hub.challenge` handshake,
+ * `POST <path>` validates `X-Hub-Signature-256` over the raw body, and
+ * `GET <path>/health` reports liveness. Everything else is 404.
+ */
+export declare function createMessengerWebhookServer(options: MessengerWebhookServerOptions): MessengerWebhookServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACrE,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB,CAyH3G"}