@polpo-ai/channels 0.15.63

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026-present Lumea Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,205 @@
+# @polpo-ai/channels
+
+Provider-neutral messaging channels for the Polpo runtime, built on the official
+Vercel Chat SDK adapters for Slack, Telegram, Discord, and WhatsApp.
+
+The package owns transport concerns: webhook verification, provider event
+normalization, deduplication, typing indicators, response delivery, attachments,
+and provider message limits. Your host owns credentials, durable state, routing,
+agent execution, sessions, billing, and rollout policy.
+
+## Install
+
+```bash
+pnpm add @polpo-ai/channels ai
+```
+
+Node.js 20 or later is required.
+
+## Runtime
+
+```ts
+import {
+  ChannelRuntime,
+  dispatchChannelWebhook,
+  type ChannelInstallation,
+} from "@polpo-ai/channels";
+
+const runtime = new ChannelRuntime({
+  handleEvent: async (event) => {
+    if (event.type === "message") {
+      return { text: `Received ${event.messages.length} message(s)` };
+    }
+    if (event.type === "action") {
+      return { text: `Selected ${event.actionId}` };
+    }
+  },
+});
+
+async function resolveInstallation(
+  routeKey: string | undefined,
+): Promise<ChannelInstallation | null> {
+  // Resolve an opaque route key to scoped credentials in your own store.
+  return null;
+}
+
+export async function webhook(request: Request, provider: string, routeKey: string) {
+  return dispatchChannelWebhook({
+    provider,
+    request,
+    routeKey,
+    resolveInstallation: ({ routeKey }) => resolveInstallation(routeKey),
+    runtime,
+  });
+}
+```
+
+Never select an installation from an unverified workspace, chat, team, or phone
+identifier contained in the request body. Resolve only an opaque route key from
+the webhook URL, then let the official adapter verify the untouched request.
+
+## Installations
+
+Each installation has a stable `id` and a `credentialRevision`. Change the
+revision whenever credentials rotate; the runtime will evict the old adapter.
+
+```ts
+const telegram = {
+  id: "channel_123",
+  provider: "telegram",
+  credentialRevision: "sha256-of-secret-version",
+  credentials: {
+    botToken: process.env.TELEGRAM_BOT_TOKEN!,
+    secretToken: process.env.TELEGRAM_WEBHOOK_SECRET,
+  },
+} as const;
+```
+
+Equivalent typed installation shapes exist for Slack, Discord, and WhatsApp.
+Secrets stay in the host credential store and are never added to normalized
+turns.
+
+## Response delivery
+
+Responses remain one logical provider message by default and are split only when
+the provider hard limit requires it. Messaging products can opt into shorter,
+semantic conversational messages per installation:
+
+```ts
+const installation = {
+  // credentials, id, provider, and revision omitted
+  responseDelivery: {
+    style: "conversational",
+    targetCharacters: 900,
+    maxMessages: 6,
+  },
+};
+```
+
+The runtime prefers paragraphs, sentences, and whitespace, preserves the exact
+output, never splits a Unicode surrogate pair, and always honors provider hard
+limits. `maxMessages` is a conversational preference rather than permission to
+truncate; additional technical segments are emitted when a provider limit makes
+them unavoidable.
+
+## Durable state
+
+The default state adapter is in-memory and is appropriate for local development
+or one process. Production hosts should provide a shared `stateFactory` backed
+by Redis or another atomic store so webhook deduplication, queues, subscriptions,
+and locks work across replicas.
+
+```ts
+const runtime = new ChannelRuntime({
+  stateFactory: (installation) => createRedisState(installation.id),
+  handleTurn,
+});
+```
+
+## Events and native output
+
+`handleEvent` receives a discriminated union for messages, slash commands,
+actions, reactions, modal submit/close events, and dynamic option loads. This
+keeps provider payloads available in `raw` while exposing a provider-neutral
+contract for normal application logic.
+
+Handlers can return `text`, files, a Chat SDK stream, or native
+`PostableMessage` objects in `posts`. Native posts support cards, actions, and
+other rich content without flattening it to text. Native posts cannot be mixed
+with convenience output in the same result, which prevents duplicate delivery.
+
+Use `channelProviderCapabilities(provider)` before exposing provider-specific
+controls. The returned immutable matrix distinguishes native, partial, buffered,
+fallback, file-fallback, and unsupported behavior.
+
+## Event coordination
+
+The runtime serializes turns for the same installation and thread in one process.
+Distributed hosts can replace that behavior with `coordinateEvent` to implement
+a durable active-run policy such as queueing, steering, or rejection:
+
+```ts
+const runtime = new ChannelRuntime({
+  coordinateEvent: (event, execute) =>
+    activeRuns.coordinate(event.installationId, event.threadId, execute),
+  handleEvent,
+});
+```
+
+Return `executed` after awaiting `execute()` exactly once. Return `queued`,
+`steered`, or `rejected` without executing inline after durably recording that
+decision. The runtime rejects contradictory dispositions and duplicate calls to
+`execute()`. `coordinateTurn` remains available for hosts using the legacy
+message-only handler.
+
+## Polpo conversation bridge
+
+`@polpo-ai/server` exports `createConversationChannelTurnHandler`. It maps a
+normalized channel turn onto Polpo's canonical conversation runtime, keeps one
+stable Session per external user and thread, loads bounded history, and supports
+host-defined attachment resolution.
+
+```ts
+import { createConversationChannelTurnHandler } from "@polpo-ai/server";
+
+const handleTurn = createConversationChannelTurnHandler(serverDeps, {
+  agent: (turn) => resolveAgentForInstallation(turn.installationId),
+  resolveAttachment: processChannelAttachment,
+});
+```
+
+Chat SDK thread history is transport state. Polpo Sessions remain the canonical
+conversation history used by the model.
+
+## Self-hosted webhook routes
+
+`@polpo-ai/node` can mount the runtime directly:
+
+```ts
+await server.start({
+  channels: {
+    runtime,
+    resolveInstallation: async ({ routeKey }) => loadInstallation(routeKey),
+  },
+});
+```
+
+This exposes:
+
+- `POST /v1/channel-webhooks/:provider/:routeKey`
+- `POST /v1/channel-webhooks/:provider`
+
+The route without a key is useful only when the resolver has another trusted,
+host-controlled installation binding.
+
+## Provider behavior
+
+- Streams are delegated to the official Chat SDK adapter. Slack streams
+  natively, Discord and Telegram use their adapter-specific streaming strategy,
+  and WhatsApp buffers until completion.
+- Long non-streaming text is split at semantic boundaries without silently
+  truncating output.
+- Typing indicator failures are observable but do not fail an agent turn.
+- Inbound files remain lazy when the provider supports authenticated fetching.
+- Discord HTTP interactions are supported by the official webhook adapter;
+  Gateway-only event flows require a separate gateway process.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ChannelRuntime } from "./runtime.js";
+export { channelProviderCapabilities, createOfficialChannelAdapter, } from "./providers.js";
+export { channelMessageHardLimit, normalizeChannelResponseDeliveryPolicy, segmentChannelText, } from "./response.js";
+export { dispatchChannelWebhook, isChannelProviderId, type DispatchChannelWebhookInput, } from "./webhook.js";
+export { CHANNEL_PROVIDER_IDS, type ChannelActionEvent, type ChannelAdapterFactory, type ChannelAttachment, type ChannelAuthor, type ChannelCapabilitySupport, type ChannelConcurrencyPolicy, type ChannelEventCoordinator, type ChannelEventHandler, type ChannelEventResult, type ChannelInboundMessage, type ChannelInboundEvent, type ChannelInboundTurn, type ChannelInstallation, type ChannelInstallationResolver, type ChannelInstallationResolverInput, type ChannelMessageEvent, type ChannelModalCloseEvent, type ChannelModalSubmitEvent, type ChannelNativePost, type ChannelOptionsLoadEvent, type ChannelOutputFile, type ChannelOutputStream, type ChannelProviderId, type ChannelProviderCapabilities, type ChannelReactionEvent, type ChannelResponseDeliveryPolicy, type ChannelRuntimeEvent, type ChannelRuntimeOptions, type ChannelStateFactory, type ChannelStateAdapter, type ChannelStateLock, type ChannelStateQueueEntry, type ChannelTurnHandler, type ChannelTurnCoordinator, type ChannelTurnResult, type ChannelWebhookOptions, type ChannelSlashCommandEvent, type DiscordChannelInstallation, type SlackChannelInstallation, type TelegramChannelInstallation, type WhatsAppChannelInstallation, } from "./types.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,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,sCAAsC,EACtC,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,2BAA2B,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { ChannelRuntime } from "./runtime.js";
+export { channelProviderCapabilities, createOfficialChannelAdapter, } from "./providers.js";
+export { channelMessageHardLimit, normalizeChannelResponseDeliveryPolicy, segmentChannelText, } from "./response.js";
+export { dispatchChannelWebhook, isChannelProviderId, } from "./webhook.js";
+export { CHANNEL_PROVIDER_IDS, } from "./types.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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,sCAAsC,EACtC,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,GA0CrB,MAAM,YAAY,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,5 @@
+import type { Adapter } from "chat";
+import type { ChannelInstallation, ChannelProviderCapabilities, ChannelProviderId } from "./types.js";
+export declare function channelProviderCapabilities(provider: ChannelProviderId): ChannelProviderCapabilities;
+export declare function createOfficialChannelAdapter(installation: ChannelInstallation): Adapter;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA6DpB,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,iBAAiB,GAC1B,2BAA2B,CAE7B;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,mBAAmB,GAChC,OAAO,CA0CT"}

package/dist/providers.js

@@ -0,0 +1,109 @@
+import { createDiscordAdapter } from "@chat-adapter/discord";
+import { createSlackAdapter } from "@chat-adapter/slack";
+import { createTelegramAdapter } from "@chat-adapter/telegram";
+import { createWhatsAppAdapter } from "@chat-adapter/whatsapp";
+const PROVIDER_CAPABILITIES = {
+    slack: Object.freeze({
+        actions: "native",
+        audioAttachments: "native",
+        cards: "native",
+        files: "native",
+        formattedText: "native",
+        modals: "native",
+        reactions: "native",
+        streaming: "native",
+        structuredStreaming: "native",
+        typing: "native",
+        videoAttachments: "native",
+        voiceReplies: "file-fallback",
+    }),
+    telegram: Object.freeze({
+        actions: "native",
+        audioAttachments: "native",
+        cards: "partial",
+        files: "native",
+        formattedText: "native",
+        modals: "unsupported",
+        reactions: "native",
+        streaming: "native",
+        structuredStreaming: "fallback",
+        typing: "native",
+        videoAttachments: "native",
+        voiceReplies: "native",
+    }),
+    discord: Object.freeze({
+        actions: "native",
+        audioAttachments: "native",
+        cards: "native",
+        files: "native",
+        formattedText: "native",
+        modals: "unsupported",
+        reactions: "native",
+        streaming: "fallback",
+        structuredStreaming: "fallback",
+        typing: "native",
+        videoAttachments: "native",
+        voiceReplies: "file-fallback",
+    }),
+    whatsapp: Object.freeze({
+        actions: "native",
+        audioAttachments: "native",
+        cards: "partial",
+        files: "native",
+        formattedText: "native",
+        modals: "unsupported",
+        reactions: "native",
+        streaming: "buffered",
+        structuredStreaming: "fallback",
+        typing: "native",
+        videoAttachments: "native",
+        voiceReplies: "native",
+    }),
+};
+export function channelProviderCapabilities(provider) {
+    return PROVIDER_CAPABILITIES[provider];
+}
+export function createOfficialChannelAdapter(installation) {
+    let adapter;
+    switch (installation.provider) {
+        case "slack":
+            adapter = createSlackAdapter({
+                botToken: installation.credentials.botToken,
+                botUserId: installation.credentials.botUserId,
+                mode: "webhook",
+                signingSecret: installation.credentials.signingSecret,
+                userName: installation.userName,
+            });
+            break;
+        case "telegram":
+            adapter = createTelegramAdapter({
+                botToken: installation.credentials.botToken,
+                mode: "webhook",
+                secretToken: installation.credentials.secretToken,
+                userName: installation.userName,
+            });
+            break;
+        case "discord":
+            adapter = createDiscordAdapter({
+                applicationId: installation.credentials.applicationId,
+                botToken: installation.credentials.botToken,
+                publicKey: installation.credentials.publicKey,
+                userName: installation.userName,
+            });
+            break;
+        case "whatsapp":
+            adapter = createWhatsAppAdapter({
+                accessToken: installation.credentials.accessToken,
+                appSecret: installation.credentials.appSecret,
+                phoneNumberId: installation.credentials.phoneNumberId,
+                userName: installation.userName,
+                verifyToken: installation.credentials.verifyToken,
+            });
+            break;
+    }
+    if (installation.typingEnabled === false) {
+        adapter.startTyping = async () => { };
+    }
+    return adapter;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/response.d.ts

@@ -0,0 +1,5 @@
+import type { ChannelProviderId, ChannelResponseDeliveryPolicy } from "./types.js";
+export declare function channelMessageHardLimit(provider: ChannelProviderId): number;
+export declare function segmentChannelText(provider: ChannelProviderId, text: string, responseDelivery?: ChannelResponseDeliveryPolicy): string[];
+export declare function normalizeChannelResponseDeliveryPolicy(input: unknown): ChannelResponseDeliveryPolicy | undefined;
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAgBpB,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAE3E;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,6BAA6B,GAC/C,MAAM,EAAE,CAoCV;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,SAAS,CAmC3C"}

package/dist/response.js

@@ -0,0 +1,115 @@
+const HARD_LIMITS = {
+    discord: 2_000,
+    slack: 40_000,
+    telegram: 4_096,
+    whatsapp: 4_096,
+};
+const SOFT_LIMITS = {
+    discord: 1_850,
+    slack: 8_000,
+    telegram: 3_800,
+    whatsapp: 3_800,
+};
+export function channelMessageHardLimit(provider) {
+    return HARD_LIMITS[provider];
+}
+export function segmentChannelText(provider, text, responseDelivery) {
+    if (!text.trim())
+        return [];
+    const hardLimit = HARD_LIMITS[provider];
+    const softLimit = Math.min(SOFT_LIMITS[provider], hardLimit);
+    if (responseDelivery?.style !== "conversational") {
+        return segmentWithLimits(text, softLimit, hardLimit);
+    }
+    const targetCharacters = Math.min(responseDelivery.targetCharacters ?? 900, softLimit);
+    const maxMessages = responseDelivery.maxMessages ?? 6;
+    if (text.length <= targetCharacters)
+        return [text];
+    const segments = [];
+    let remaining = text;
+    const preferredMaximum = Math.min(hardLimit, Math.max(targetCharacters + 1, Math.floor(targetCharacters * 1.35)));
+    while (remaining.length > preferredMaximum
+        && segments.length < maxMessages - 1) {
+        const splitAt = findSemanticSplit(remaining, targetCharacters, preferredMaximum);
+        const part = remaining.slice(0, splitAt);
+        if (part)
+            segments.push(part);
+        remaining = remaining.slice(splitAt);
+    }
+    return [...segments, ...segmentWithLimits(remaining, softLimit, hardLimit)];
+}
+export function normalizeChannelResponseDeliveryPolicy(input) {
+    if (input === undefined || input === null)
+        return undefined;
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        throw new Error("responseDelivery must be an object");
+    }
+    const value = input;
+    const style = value.style;
+    if (style !== "single" && style !== "conversational") {
+        throw new Error('responseDelivery.style must be "single" or "conversational"');
+    }
+    const targetCharacters = boundedInteger(value.targetCharacters, "responseDelivery.targetCharacters", 200, 4_000);
+    const maxMessages = boundedInteger(value.maxMessages, "responseDelivery.maxMessages", 2, 20);
+    if (style === "single"
+        && (targetCharacters !== undefined || maxMessages !== undefined)) {
+        throw new Error("responseDelivery targetCharacters and maxMessages are only valid for conversational style");
+    }
+    return {
+        style,
+        ...(targetCharacters === undefined ? {} : { targetCharacters }),
+        ...(maxMessages === undefined ? {} : { maxMessages }),
+    };
+}
+function segmentWithLimits(text, softLimit, hardLimit) {
+    if (!text)
+        return [];
+    if (text.length <= hardLimit)
+        return [text];
+    const segments = [];
+    let remaining = text;
+    while (remaining.length > hardLimit) {
+        const splitAt = findSemanticSplit(remaining, softLimit, hardLimit);
+        segments.push(remaining.slice(0, splitAt));
+        remaining = remaining.slice(splitAt);
+    }
+    if (remaining)
+        segments.push(remaining);
+    return segments;
+}
+function boundedInteger(value, label, min, max) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Number.isInteger(value) || Number(value) < min || Number(value) > max) {
+        throw new Error(`${label} must be an integer between ${min} and ${max}`);
+    }
+    return Number(value);
+}
+function findSemanticSplit(text, softLimit, hardLimit) {
+    const window = text.slice(0, hardLimit + 1);
+    const preferred = ["\n\n", "\n", ". ", "! ", "? ", "; ", ", ", " "];
+    for (const delimiter of preferred) {
+        const index = window.lastIndexOf(delimiter, hardLimit);
+        if (index >= softLimit)
+            return index + delimiter.length;
+    }
+    // Prefer a coherent earlier boundary over a hard cut when no good split
+    // exists in the ideal window. Avoid producing a tiny leading segment.
+    const minimumUsefulLength = Math.floor(hardLimit * 0.35);
+    for (const delimiter of preferred) {
+        const index = window.lastIndexOf(delimiter, softLimit);
+        if (index >= minimumUsefulLength)
+            return index + delimiter.length;
+    }
+    return avoidSplittingSurrogatePair(text, hardLimit);
+}
+function avoidSplittingSurrogatePair(text, index) {
+    if (index <= 0 || index >= text.length)
+        return index;
+    const before = text.charCodeAt(index - 1);
+    const after = text.charCodeAt(index);
+    const splitsPair = before >= 0xd800 && before <= 0xdbff
+        && after >= 0xdc00 && after <= 0xdfff;
+    return splitsPair ? index - 1 : index;
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,32 @@
+import type { ChannelInstallation, ChannelRuntimeOptions, ChannelTurnResult, ChannelWebhookOptions } from "./types.js";
+export declare class ChannelRuntime {
+    private readonly entries;
+    private readonly pendingInstallations;
+    private readonly pendingTurns;
+    private readonly options;
+    constructor(options: ChannelRuntimeOptions);
+    handleWebhook(installation: ChannelInstallation, request: Request, options?: ChannelWebhookOptions): Promise<Response>;
+    post(installation: ChannelInstallation, threadId: string, result: ChannelTurnResult | string): Promise<void>;
+    invalidate(installationId: string): Promise<void>;
+    shutdown(): Promise<void>;
+    get size(): number;
+    private getOrCreate;
+    private createEntry;
+    private handleMessage;
+    private handleSlashCommand;
+    private handleAction;
+    private handleReaction;
+    private handleModalSubmit;
+    private handleModalClose;
+    private handleOptionsLoad;
+    private acceptEvent;
+    private executeTurn;
+    private executeEvent;
+    private coordinateEventLocally;
+    private coordinateLocally;
+    private deliver;
+    private prune;
+    private evict;
+    private emit;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAMV,mBAAmB,EAEnB,qBAAqB,EAErB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAwBpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA4C;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEE;gBAEd,OAAO,EAAE,qBAAqB;IAWpC,aAAa,CACjB,YAAY,EAAE,mBAAmB,EACjC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC;IAiBd,IAAI,CACR,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,GAAG,MAAM,GACjC,OAAO,CAAC,IAAI,CAAC;IAeV,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,IAAI,IAAI,IAAI,MAAM,CAEjB;YAEa,WAAW;YAyBX,WAAW;YA2DX,aAAa;YAsCb,kBAAkB;YA8ElB,YAAY;YAqCZ,cAAc;YAkCd,iBAAiB;YAsCjB,gBAAgB;YAiChB,iBAAiB;YAsBjB,WAAW;YAaX,WAAW;YAuFX,YAAY;YA+EZ,sBAAsB;YAetB,iBAAiB;YAiBjB,OAAO;YAiFP,KAAK;YAgBL,KAAK;YAUL,IAAI;CAGnB"}