@letta-ai/letta-code 0.30.2 → 0.30.4

package/dist/types/channels/access-control.d.ts

@@ -0,0 +1,104 @@
+import type { ChannelChatType, ChannelGroupSenderPolicy, DmPolicy } from "./types";
+/**
+ * Centralized sender access control for channel inbound traffic.
+ *
+ * Modeled on the Hermes gateway's authorization layer: one decision
+ * function consulted on every inbound message (DMs and groups), an
+ * env-var allowlist axis that works across all channels, and an
+ * opt-in admin/user command tier that stays disabled until an
+ * operator lists at least one admin.
+ */
+export type ChannelAccessScope = "dm" | "group";
+export declare function resolveChannelAccessScope(chatType: ChannelChatType | undefined): ChannelAccessScope;
+/** Union of the global and per-channel allowed-user env vars. */
+export declare function getChannelEnvAllowedUsers(channelId: string): string[];
+/** Union of the global and per-channel admin-user env vars. */
+export declare function getChannelEnvAdminUsers(channelId: string): string[];
+/** Explicit opt-out of sender gating (LETTA_CHANNELS_ALLOW_ALL_USERS=1). */
+export declare function isChannelAllowAllUsersEnabled(channelId: string): boolean;
+/**
+ * Minimal structural view of a channel account used for access
+ * decisions, satisfied by every ChannelAccount variant including
+ * custom plugin accounts.
+ */
+export interface ChannelAccessAccount {
+    accountId: string;
+    dmPolicy: DmPolicy;
+    allowedUsers: string[];
+    groupPolicy?: ChannelGroupSenderPolicy;
+    adminUsers?: string[];
+    userAllowedCommands?: string[];
+}
+export type ChannelSenderAccessDecision = "allow" | "deny" | "pair";
+export interface ChannelSenderAccessInput {
+    account: ChannelAccessAccount;
+    channelId: string;
+    senderId: string;
+    chatType: ChannelChatType | undefined;
+}
+/**
+ * Decide whether an inbound sender may reach the agent.
+ *
+ * Order of checks, most permissive first:
+ * 1. Allow-all env flag → allow.
+ * 2. Sender in the effective allowlist (account allowedUsers + adminUsers
+ *    + env allowlists, `*` wildcard supported) → allow.
+ * 3. Sender approved via pairing → allow (pairing grants are a union
+ *    with the allowlist, not an alternative).
+ * 4. Otherwise the scope policy decides:
+ *    - group: `groupPolicy: "allowlist"` denies; an env allowlist being
+ *      configured also denies (a configured allowlist restricts
+ *      everywhere); default stays open for backwards compatibility.
+ *    - dm: `dmPolicy` semantics — open allows (unless an env allowlist
+ *      is configured), allowlist denies, pairing asks for a code.
+ *
+ * Slack exception: Slack DM `dmPolicy: "pairing"` is a legacy default
+ * that was never enforced (the workspace membership is the trust
+ * boundary and there is no Slack pairing UX), so it behaves as "open".
+ * Explicit `dmPolicy: "allowlist"` and env allowlists ARE enforced.
+ */
+export declare function evaluateChannelSenderAccess(input: ChannelSenderAccessInput): ChannelSenderAccessDecision;
+export declare function buildChannelAccessDeniedMessage(channelId: string): string;
+/**
+ * Read-only commands that stay reachable for every allowed user even
+ * when command gating is enabled. Anything an operator lists in
+ * `userAllowedCommands` is added on top; the floor is never removed.
+ */
+export declare const CHANNEL_COMMAND_FLOOR: readonly ["help", "status", "whoami"];
+export interface ChannelCommandGate {
+    /** Gating is active only when at least one admin is configured. */
+    enabled: boolean;
+    isAdmin: boolean;
+    /** Normalized extra commands non-admins may run (floor excluded). */
+    allowedCommands: string[];
+    /** True when the sender still needs to pair; changes denial wording. */
+    pairingPending?: boolean;
+}
+/**
+ * Gate limiting a sender to the read-only floor. Applied to senders in
+ * the pairing handshake regardless of whether admin tiers are enabled,
+ * so a not-yet-paired DM sender cannot run mutating commands against a
+ * pre-existing route.
+ */
+export declare function floorOnlyChannelCommandGate(): ChannelCommandGate;
+/** Resolve command aliases to the canonical name used for gating. */
+export declare function canonicalizeChannelCommandName(name: string): string;
+/**
+ * Resolve the command tier for a sender. Mirrors Hermes's backward
+ * compatibility rule: when no admin is configured for the account (or
+ * via env), gating is disabled and every allowed user has full access.
+ */
+export declare function resolveChannelCommandGate(params: {
+    account: ChannelAccessAccount;
+    channelId: string;
+    senderId: string;
+}): ChannelCommandGate;
+export declare function canRunChannelCommand(gate: ChannelCommandGate, commandName: string): boolean;
+export declare function buildChannelCommandDeniedMessage(channelId: string, commandName: string, gate: ChannelCommandGate): string;
+export declare function buildChannelWhoamiMessage(msg: {
+    channel: string;
+    senderId: string;
+    senderName?: string;
+    chatType?: ChannelChatType;
+}, gate?: ChannelCommandGate): string;
+//# sourceMappingURL=access-control.d.ts.map

package/dist/types/channels/access-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-control.d.ts","sourceRoot":"","sources":["../../../src/channels/access-control.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,QAAQ,EACT,MAAM,SAAS,CAAC;AAGjB;;;;;;;;GAQG;AAIH,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC;AAEhD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,eAAe,GAAG,SAAS,GACpC,kBAAkB,CAEpB;AA0BD,iEAAiE;AACjE,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAKrE;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnE;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKxE;AAID;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;CACvC;AAqDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,wBAAwB,GAC9B,2BAA2B,CAwC7B;AASD,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzE;AAID;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,uCAAwC,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,kBAAkB,CAOhE;AAMD,qEAAqE;AACrE,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,kBAAkB,CAiBrB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAST;AAsBD,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAWR;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,EACD,IAAI,CAAC,EAAE,kBAAkB,GACxB,MAAM,CA6BR"}

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

@@ -0,0 +1,17 @@
+import type { ChannelAccount } from "./types";
+export declare const LEGACY_CHANNEL_ACCOUNT_ID = "__legacy_migrated__";
+export declare function loadChannelAccounts(channelId: string): void;
+export declare function flushPendingChannelSecretWrites(): Promise<void>;
+export declare function hydrateChannelAccountSecrets(channelId: string): Promise<void>;
+export declare function listChannelAccounts(channelId: string): ChannelAccount[];
+export declare function listChannelAccountsWithSecrets(channelId: string): Promise<ChannelAccount[]>;
+export declare function getChannelAccount(channelId: string, accountId: string): ChannelAccount | null;
+export declare function getChannelAccountWithSecrets(channelId: string, accountId: string): Promise<ChannelAccount | null>;
+export declare function upsertChannelAccount(channelId: string, account: ChannelAccount): ChannelAccount;
+export declare function upsertChannelAccountWithSecrets(channelId: string, account: ChannelAccount): Promise<ChannelAccount>;
+export declare function removeChannelAccount(channelId: string, accountId: string): boolean;
+export declare function removeChannelAccountWithSecrets(channelId: string, accountId: string): Promise<boolean>;
+export declare function clearChannelAccountStores(): void;
+export declare function __testOverrideLoadChannelAccounts(fn: ((channelId: string) => ChannelAccount[] | null) | null): void;
+export declare function __testOverrideSaveChannelAccounts(fn: ((channelId: string, accounts: ChannelAccount[]) => void) | null): void;
+//# sourceMappingURL=accounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../src/channels/accounts.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,cAAc,EASf,MAAM,SAAS,CAAC;AAwDjB,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAud/D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgD3D;AA0CD,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAEvE;AAED,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3B;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,GAAG,IAAI,CAKvB;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGhC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,cAAc,CAahB;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAWT;AAED,wBAAsB,+BAA+B,CACnD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,GAC1D,IAAI,CAEN;AAED,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GACnE,IAAI,CAEN"}

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

@@ -0,0 +1,98 @@
+import type { ListModelsResponseModelEntry } from "../types/protocol_v2";
+import { type ChannelCommandGate } from "./access-control";
+import type { ChannelAdapter, ChannelModelPickerData, ChannelRoute, InboundChannelMessage } from "./types";
+export type ChannelSlashCommandKind = "direct" | "agent-scoped";
+export type ParsedChannelSlashCommand = {
+    name: string;
+    args: string;
+    raw: string;
+};
+export type ChannelSlashCommandDefinition = {
+    name: string;
+    aliases?: string[];
+    kind: ChannelSlashCommandKind;
+    summary: string;
+};
+export type ChannelSlashCommandHandlerResult = {
+    handled: boolean;
+    text?: string;
+    modelPicker?: ChannelModelPickerData;
+};
+export type ChannelSlashCommandHandlers = {
+    cancel?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    chat?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    detach?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    model?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    newConversation?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    pause?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    reflection?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    reload?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+    resume?: (command: ParsedChannelSlashCommand, msg: InboundChannelMessage) => Promise<ChannelSlashCommandHandlerResult>;
+};
+export type ChannelStatusContext = {
+    adapterRunning: boolean;
+    accountConfigured: boolean;
+    accountEnabled?: boolean;
+    route: ChannelRoute | null;
+};
+export type ChannelSlashCommandOptions = {
+    statusContext?: ChannelStatusContext;
+    handlers?: ChannelSlashCommandHandlers;
+    enableBangCommands?: boolean;
+    /** Admin/user tier gate for this sender; undefined disables gating. */
+    commandGate?: ChannelCommandGate;
+};
+export declare function listChannelSlashCommands(): ChannelSlashCommandDefinition[];
+export declare function parseChannelSlashCommand(text: string): ParsedChannelSlashCommand | null;
+export declare function parseChannelBangCommand(text: string): ParsedChannelSlashCommand | null;
+export declare function buildChannelHelpMessage(channelId: string): string;
+export declare function buildUnsupportedChannelCommandMessage(channelId: string, command: ParsedChannelSlashCommand): string;
+export declare function buildChannelStatusMessage(msg: InboundChannelMessage, context: ChannelStatusContext): string;
+export declare function buildChannelNoRouteMessage(channelId: string): string;
+export declare function buildChannelPausedMessage(channelId: string, route: ChannelRoute): string;
+export declare function buildChannelAlreadyPausedMessage(channelId: string): string;
+export declare function buildChannelResumedMessage(channelId: string, route: ChannelRoute): string;
+export declare function buildChannelAlreadyActiveMessage(channelId: string): string;
+export declare function buildChannelCancelUnavailableMessage(channelId: string): string;
+export declare function buildChannelCancelNoActiveTurnMessage(channelId: string): string;
+export declare function buildChannelCancelAcceptedMessage(channelId: string): string;
+export declare function buildChannelChatLinkMessage(channelId: string, route: ChannelRoute, chatUrl: string): string;
+export declare function buildChannelChatUnavailableMessage(channelId: string, route: ChannelRoute): string;
+export declare function buildChannelDetachUnsupportedMessage(channelId: string): string;
+export declare function buildChannelDetachedMessage(channelId: string): string;
+export declare function buildChannelAlreadyDetachedMessage(channelId: string): string;
+export declare function buildChannelNewConversationMessage(channelId: string, route: ChannelRoute): string;
+export declare function buildChannelNewConversationUnavailableMessage(channelId: string): string;
+export type ChannelModelListEntry = Pick<ListModelsResponseModelEntry, "id" | "handle" | "label" | "description" | "isDefault" | "isFeatured" | "updateArgs">;
+export declare function buildModelEntriesByHandle(entries: ChannelModelListEntry[]): Map<string, ChannelModelListEntry>;
+export declare function resolveModelHandles(params: {
+    handles: string[];
+    byHandle: Map<string, ChannelModelListEntry>;
+    availableHandles?: Set<string> | null;
+}): ChannelModelListEntry[];
+export declare function getFallbackModelEntries(byHandle: Map<string, ChannelModelListEntry>): ChannelModelListEntry[];
+export declare function buildChannelModelNotFoundText(channelId: string): string;
+export declare function buildChannelCurrentModelMessage(channelId: string, params: {
+    modelLabel: string;
+    modelHandle: string | null;
+    scope?: "agent" | "conversation";
+}): string;
+export declare function buildChannelModelListMessage(channelId: string, params: {
+    entries: ListModelsResponseModelEntry[];
+    availableHandles?: string[] | null;
+    recentHandles?: string[];
+    limit?: number;
+}): string;
+export declare function buildChannelModelListUnavailableMessage(channelId: string, error: string): string;
+export declare function buildChannelCurrentModelUnavailableMessage(channelId: string, error: string): string;
+export declare function buildChannelModelUpdatedMessage(channelId: string, params: {
+    modelLabel: string;
+    modelHandle: string;
+    appliedTo?: "agent" | "conversation";
+}): string;
+export declare function buildChannelModelUpdateFailedMessage(channelId: string, identifier: string, error: string): string;
+export declare function buildChannelModelUnavailableMessage(channelId: string): string;
+export declare function buildChannelReflectionUnavailableMessage(channelId: string): string;
+export declare function buildChannelReloadUnavailableMessage(channelId: string): string;
+export declare function tryHandleChannelSlashCommand(adapter: ChannelAdapter, msg: InboundChannelMessage, options?: ChannelSlashCommandOptions): Promise<boolean>;
+//# sourceMappingURL=commands.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Channel config read/write helpers.
+ *
+ * Channel configs live at ~/.letta/channels/<channel_name>/config.yaml.
+ * This module handles reading, writing, and validating channel configs.
+ */
+import type { ChannelConfig } from "./types";
+export declare function getChannelsRoot(): string;
+export declare function getChannelDir(channelId: string): string;
+export declare function getChannelConfigPath(channelId: string): string;
+export declare function getChannelAccountsPath(channelId: string): string;
+export declare function getChannelRoutingPath(channelId: string): string;
+export declare function getChannelPairingPath(channelId: string): string;
+export declare function getChannelTargetsPath(channelId: string): string;
+export declare function getPendingChannelControlRequestsPath(): string;
+export declare function __testOverrideChannelsRoot(root: string | null): void;
+export declare function readChannelConfig(channelId: string): ChannelConfig | null;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/channels/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EACV,aAAa,EAYd,MAAM,SAAS,CAAC;AAYjB,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oCAAoC,IAAI,MAAM,CAE7D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEpE;AAySD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAazE"}

package/dist/types/channels/credential-store.d.ts

@@ -0,0 +1,21 @@
+export type ChannelCredentialsStoreMode = "file" | "keyring" | "auto";
+export type ActiveChannelCredentialsStoreMode = "file" | "keyring";
+declare let channelSecretStoreOverrideForTests: {
+    get: (name: string) => Promise<string | null>;
+    set: (name: string, value: string) => Promise<void>;
+    delete: (name: string) => Promise<boolean>;
+} | null;
+export declare function getRequestedChannelCredentialsStoreMode(): ChannelCredentialsStoreMode;
+export declare function getActiveChannelCredentialsStoreMode(): Promise<ActiveChannelCredentialsStoreMode>;
+export declare function getCachedChannelCredentialsStoreMode(): ActiveChannelCredentialsStoreMode | null;
+export declare function buildChannelSecretName(channelId: string, accountId: string, field: string): string;
+export declare function getChannelSecret(channelId: string, accountId: string, field: string): Promise<string | null>;
+export declare function setChannelSecret(channelId: string, accountId: string, field: string, value: string): Promise<void>;
+export declare function deleteChannelSecret(channelId: string, accountId: string, field: string): Promise<boolean>;
+export declare function __setChannelCredentialsStoreModeForTests(mode: ChannelCredentialsStoreMode | null): void;
+export declare function __resetChannelCredentialsStoreModeCacheForTests(): void;
+export declare function __setActiveChannelCredentialsStoreModeForTests(mode: ActiveChannelCredentialsStoreMode | null): void;
+export declare function __setChannelKeychainAvailableForTests(available: boolean | null): void;
+export declare function __setChannelSecretStoreOverrideForTests(override: typeof channelSecretStoreOverrideForTests): void;
+export {};
+//# sourceMappingURL=credential-store.d.ts.map

package/dist/types/channels/credential-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../../../src/channels/credential-store.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AACtE,MAAM,MAAM,iCAAiC,GAAG,MAAM,GAAG,SAAS,CAAC;AASnE,QAAA,IAAI,kCAAkC,EAAE;IACtC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C,GAAG,IAAW,CAAC;AAQhB,wBAAgB,uCAAuC,IAAI,2BAA2B,CAkBrF;AAED,wBAAsB,oCAAoC,IAAI,OAAO,CAAC,iCAAiC,CAAC,CA+BvG;AAED,wBAAgB,oCAAoC,IAAI,iCAAiC,GAAG,IAAI,CAE/F;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,wCAAwC,CACtD,IAAI,EAAE,2BAA2B,GAAG,IAAI,GACvC,IAAI,CAGN;AAED,wBAAgB,+CAA+C,IAAI,IAAI,CAEtE;AAED,wBAAgB,8CAA8C,CAC5D,IAAI,EAAE,iCAAiC,GAAG,IAAI,GAC7C,IAAI,CAGN;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,OAAO,GAAG,IAAI,GACxB,IAAI,CAGN;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,OAAO,kCAAkC,GAClD,IAAI,CAEN"}

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

@@ -0,0 +1,3 @@
+import type { ChannelAdapter, CustomChannelAccount } from "../types";
+export declare function createCustomAdapter(account: CustomChannelAccount): ChannelAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/channels/custom/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EAErB,MAAM,kBAAkB,CAAC;AAgC1B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAgGhB"}

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

@@ -0,0 +1,10 @@
+import type { ChannelConfigSchema, ChannelPlugin } from "../plugin-types";
+/**
+ * Declarative config schema for the custom channel.
+ * Matches the field set used by CustomManageDialog so the desktop UI can
+ * render a dynamic form when it receives this schema from
+ * `channels_list_response`.
+ */
+export declare const CUSTOM_CHANNEL_CONFIG_SCHEMA: ChannelConfigSchema;
+export declare const customChannelPlugin: ChannelPlugin;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/channels/custom/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACd,MAAM,yBAAyB,CAAC;AAIjC;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,mBAgD1C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,aAajC,CAAC"}

package/dist/types/channels/discord/account-display.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveDiscordAccountDisplayName(token: string): Promise<string | undefined>;
+//# sourceMappingURL=account-display.d.ts.map

package/dist/types/channels/discord/account-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-display.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/account-display.ts"],"names":[],"mappings":"AAGA,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B"}

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

@@ -0,0 +1,3 @@
+import type { ChannelAdapter, DiscordChannelAccount } from "../types";
+export declare function createDiscordAdapter(config: DiscordChannelAccount): ChannelAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAGd,qBAAqB,EAGtB,MAAM,kBAAkB,CAAC;AAuD1B,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,GAC5B,cAAc,CA85BhB"}

package/dist/types/channels/discord/bot-policy.d.ts

@@ -0,0 +1,19 @@
+import type { DiscordAllowBotsMode } from "../types";
+interface DiscordBotPolicyMessage {
+    content?: unknown;
+    author?: {
+        id?: unknown;
+        bot?: unknown;
+    } | null;
+}
+export declare function isValidDiscordAllowBotsConfigValue(value: unknown): value is DiscordAllowBotsMode | undefined;
+export declare function normalizeDiscordAllowBotsMode(value: unknown): DiscordAllowBotsMode;
+export declare function hasExplicitDiscordUserMention(message: Pick<DiscordBotPolicyMessage, "content">, userId: string | null | undefined): boolean;
+export declare function shouldAcceptDiscordInboundBotMessage(input: {
+    message: DiscordBotPolicyMessage;
+    allowBots?: DiscordAllowBotsMode;
+    botUserId: string | null;
+    wasExplicitlyMentioned: boolean;
+}): boolean;
+export {};
+//# sourceMappingURL=bot-policy.d.ts.map

package/dist/types/channels/discord/bot-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-policy.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/bot-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,UAAU,uBAAuB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,GAAG,IAAI,CAAC;CACV;AAMD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,GAAG,SAAS,CAE3C;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,oBAAoB,CAEtB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,EACjD,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,OAAO,CAQT;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CASV"}

package/dist/types/channels/discord/channel-gating.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Discord guild-channel gating and mode resolution.
+ *
+ * When a Discord account has `allowedChannels` configured, only messages whose
+ * channel ID — or parent channel ID for thread messages — appears in the list
+ * are processed by the bot. Empty/undefined preserves the default behavior of
+ * listening in every guild channel the bot can see. DMs ignore this gate
+ * entirely.
+ *
+ * `allowedChannels` accepts two formats:
+ *   - Legacy `string[]`: simple allowlist, all entries default to "mention-only"
+ *   - `Record<channelId, mode>`: per-channel mode map
+ */
+import type { DiscordChannelMode } from "../types";
+export interface DiscordChannelGateParams {
+    /** ID of the channel the message arrived in. For thread messages this is the thread's channel ID. */
+    channelId: string;
+    /** Parent channel ID when the message is in a thread; null otherwise. */
+    parentChannelId: string | null;
+    /** Whether the message is in a thread. */
+    isThread: boolean;
+    /** The configured allowlist or mode map (may be empty/undefined to mean "no gate"). */
+    allowedChannels?: string[] | Record<string, DiscordChannelMode>;
+}
+/**
+ * Returns true when the message should be processed, false when the gate
+ * blocks it. Messages outside guilds (DMs) should not be passed through this
+ * helper — gate them at the call site by checking chat type first.
+ */
+export declare function isDiscordGuildChannelAllowed(params: DiscordChannelGateParams): boolean;
+/**
+ * Resolve the channel mode for a given guild channel.
+ *
+ * Returns:
+ *   - `"open"` or `"mention-only"` when the channel is found in the mode map
+ *   - `"mention-only"` when the channel appears in a legacy `string[]` allowlist
+ *   - `null` when no gate is configured (allowedChannels is undefined/empty)
+ *     or the channel is not found in the map
+ */
+export declare function resolveDiscordChannelMode(channelId: string, parentChannelId: string | null, isThread: boolean, allowedChannels?: string[] | Record<string, DiscordChannelMode>): DiscordChannelMode | null;
+//# sourceMappingURL=channel-gating.d.ts.map

package/dist/types/channels/discord/channel-gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-gating.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/channel-gating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAiC3D,MAAM,WAAW,wBAAwB;IACvC,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CA4BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,QAAQ,EAAE,OAAO,EACjB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC9D,kBAAkB,GAAG,IAAI,CAsB3B"}

package/dist/types/channels/discord/error-reply.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Helpers for surfacing message-handling errors back to the user in Discord
+ * so they aren't silently dropped after the adapter logs them. The adapter
+ * itself wires these into its DM and guild `messageCreate` handlers.
+ */
+/**
+ * Pull the most useful human-readable detail out of an unknown error,
+ * falling back through the Letta SDK shape, the standard Error.message,
+ * and finally `String(error)`.
+ */
+export declare function extractErrorDetail(error: unknown): string;
+/**
+ * Format an error encountered while forwarding a Discord message to the
+ * agent runtime into a short, user-facing string.
+ *
+ * Known shapes:
+ *   - 404 + "Agent with ID ... not found": agent binding is stale or wrong.
+ *   - 401/403: API credentials rejected.
+ *
+ * Everything else falls through to a generic message with the (truncated)
+ * detail in a code span so curly braces and quotes render cleanly.
+ */
+export declare function formatDiscordDeliveryError(error: unknown): string;
+//# sourceMappingURL=error-reply.d.ts.map

package/dist/types/channels/discord/error-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reply.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/error-reply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAwBjE"}

package/dist/types/channels/discord/internal-types.d.ts

@@ -0,0 +1,101 @@
+export type DiscordEventHandlerResult = void | Promise<void>;
+export interface DiscordUserLike {
+    id: string;
+    username?: string | null;
+    globalName?: string | null;
+    tag?: string | null;
+    bot?: boolean;
+}
+export interface DiscordGuildMemberLike {
+    displayName?: string | null;
+}
+export interface DiscordAttachmentLike {
+    id: string;
+    name?: string | null;
+    contentType?: string | null;
+    size?: number;
+    url: string;
+}
+export interface DiscordMentionsLike {
+    has: (user: DiscordUserLike | null | undefined) => boolean;
+}
+export interface DiscordReactionResolutionLike {
+    me?: boolean;
+    remove?: () => Promise<unknown>;
+    users: {
+        remove: (userId: string) => Promise<unknown>;
+    };
+}
+export interface DiscordReactionStoreLike {
+    cache: Map<string, DiscordReactionResolutionLike>;
+    resolve?: (emoji: string) => DiscordReactionResolutionLike | null;
+}
+export interface DiscordFetchedMessageLike {
+    id: string;
+    content?: string | null;
+    author?: DiscordUserLike;
+    partial?: boolean;
+    fetch?: () => Promise<DiscordFetchedMessageLike>;
+    react: (emoji: string) => Promise<unknown>;
+    reactions: DiscordReactionStoreLike;
+}
+export interface DiscordThreadLike {
+    id: string;
+    name?: string | null;
+}
+export interface DiscordChannelLike {
+    name?: string | null;
+    parentId?: string | null;
+    isTextBased?: () => boolean;
+    isThread?: () => boolean;
+    send?: (options: string | Record<string, unknown>) => Promise<{
+        id: string;
+    }>;
+    sendTyping?: () => Promise<unknown>;
+    messages?: {
+        fetch: (id: string) => Promise<DiscordFetchedMessageLike>;
+    };
+}
+export interface DiscordMessageLike extends DiscordFetchedMessageLike {
+    channelId: string;
+    guildId?: string | null;
+    author: DiscordUserLike;
+    member?: DiscordGuildMemberLike | null;
+    channel: DiscordChannelLike;
+    mentions: DiscordMentionsLike;
+    attachments: Map<string, DiscordAttachmentLike>;
+    createdTimestamp: number;
+    startThread: (options: {
+        name: string;
+        reason?: string;
+    }) => Promise<DiscordThreadLike>;
+}
+export interface DiscordReactionLike {
+    partial?: boolean;
+    fetch: () => Promise<unknown>;
+    message: DiscordMessageLike;
+    emoji: {
+        id?: string | null;
+        name?: string | null;
+        toString: () => string;
+    };
+}
+export interface DiscordEventHandlerMap {
+    ready: () => DiscordEventHandlerResult;
+    messageCreate: (message: DiscordMessageLike) => DiscordEventHandlerResult;
+    messageReactionAdd: (reaction: DiscordReactionLike, user: DiscordUserLike) => DiscordEventHandlerResult;
+    messageReactionRemove: (reaction: DiscordReactionLike, user: DiscordUserLike) => DiscordEventHandlerResult;
+    error: (error: unknown) => DiscordEventHandlerResult;
+}
+export interface DiscordClient {
+    user?: DiscordUserLike | null;
+    channels: {
+        fetch: (id: string) => Promise<DiscordChannelLike | null>;
+    };
+    once<K extends keyof DiscordEventHandlerMap>(event: K, handler: DiscordEventHandlerMap[K]): DiscordClient;
+    on<K extends keyof DiscordEventHandlerMap>(event: K, handler: DiscordEventHandlerMap[K]): DiscordClient;
+    login: (token: string) => Promise<unknown>;
+    destroy: () => void;
+}
+export type DiscordMessage = DiscordMessageLike;
+//# sourceMappingURL=internal-types.d.ts.map

package/dist/types/channels/discord/internal-types.d.ts.map

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

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

@@ -0,0 +1,47 @@
+import type { ChannelMessageAttachment } from "../types";
+interface DiscordRawAttachment {
+    id: string;
+    name: string | null;
+    contentType: string | null;
+    size: number;
+    url: string;
+}
+export declare function resolveDiscordInboundAttachments(params: {
+    accountId: string;
+    rawAttachments: DiscordRawAttachment[];
+    chatId: string;
+    transcribeVoice?: boolean;
+}): Promise<ChannelMessageAttachment[]>;
+interface DiscordThreadMessage {
+    id: string;
+    userId?: string;
+    botId?: string;
+    text: string;
+}
+/**
+ * Fetch the starter message for a Discord thread.
+ * In Discord, threads have a "starter message" that is the parent message.
+ */
+export declare function resolveDiscordThreadStarter(params: {
+    client: {
+        channels: {
+            fetch: (id: string) => Promise<unknown>;
+        };
+    };
+    threadChannelId: string;
+}): Promise<DiscordThreadMessage | null>;
+/**
+ * Fetch recent thread history for first-turn context hydration.
+ */
+export declare function resolveDiscordThreadHistory(params: {
+    client: {
+        channels: {
+            fetch: (id: string) => Promise<unknown>;
+        };
+    };
+    threadChannelId: string;
+    currentMessageId?: string;
+    limit?: number;
+}): Promise<DiscordThreadMessage[]>;
+export {};
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/media.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AA4BjE,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAoGtC;AAED,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,MAAM,EAAE;QAAE,QAAQ,EAAE;YAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAClE,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA+BvC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,MAAM,EAAE;QAAE,QAAQ,EAAE;YAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAyClC"}

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

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

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

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

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

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

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

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