@letta-ai/letta-code 0.30.2 → 0.30.3

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

@@ -0,0 +1,28 @@
+export interface DiscordGatewayIntentBitsLike {
+    Guilds: unknown;
+    GuildMessages: unknown;
+    GuildMessageReactions: unknown;
+    MessageContent: unknown;
+    DirectMessages: unknown;
+    DirectMessageReactions: unknown;
+}
+export interface DiscordPartialsLike {
+    Channel: unknown;
+    Message: unknown;
+    Reaction: unknown;
+    User: unknown;
+}
+export interface DiscordRuntimeModuleLike {
+    Client: new (options: {
+        intents: unknown[];
+        partials?: unknown[];
+    }) => unknown;
+    GatewayIntentBits: DiscordGatewayIntentBitsLike;
+    Partials: DiscordPartialsLike;
+}
+export declare function __testOverrideLoadDiscordModule(override: (() => Promise<DiscordRuntimeModuleLike>) | null): void;
+export declare function loadDiscordModule(): Promise<DiscordRuntimeModuleLike>;
+export declare function isDiscordRuntimeInstalled(): boolean;
+export declare function installDiscordRuntime(): Promise<void>;
+export declare function ensureDiscordRuntimeInstalled(): Promise<boolean>;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/runtime.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,KAAK,OAAO,EAAE;QACpB,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;KACtB,KAAK,OAAO,CAAC;IACd,iBAAiB,EAAE,4BAA4B,CAAC;IAChD,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAMD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,CAAC,MAAM,OAAO,CAAC,wBAAwB,CAAC,CAAC,GAAG,IAAI,GACzD,IAAI,CAEN;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAQ3E;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtE"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/setup.ts"],"names":[],"mappings":"AAeA,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAiMxD"}

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

@@ -0,0 +1,47 @@
+import type { DiscordChannelAccount } from "../types";
+import type { DiscordChannelLike, DiscordFetchedMessageLike, DiscordMessageLike } from "./internal-types";
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function isDiscordTextChannel(channel: DiscordChannelLike | null): channel is DiscordChannelLike & {
+    isTextBased: () => boolean;
+};
+export declare function hasDiscordMessageFetcher(channel: DiscordChannelLike | null): channel is DiscordChannelLike & {
+    isTextBased: () => boolean;
+    messages: {
+        fetch: (id: string) => Promise<DiscordFetchedMessageLike>;
+    };
+};
+export declare function isDiscordSendableChannel(channel: DiscordChannelLike | null): channel is DiscordChannelLike & {
+    isTextBased: () => boolean;
+    send: (options: string | Record<string, unknown>) => Promise<{
+        id: string;
+    }>;
+};
+export declare function isDiscordTypingChannel(channel: DiscordChannelLike | null): channel is DiscordChannelLike & {
+    isTextBased: () => boolean;
+    sendTyping: () => Promise<unknown>;
+};
+export declare function splitMessageText(text: string, maxLength: number): string[];
+export declare function normalizeDiscordMentionText(text: string, botUserId: string | null): string;
+export declare function resolveDiscordChatType(guildId: string | null | undefined): "direct" | "channel";
+/**
+ * Resolve native emoji for Discord reactions.
+ * Discord uses native Unicode emoji directly (not names like Slack).
+ * Strip colons for common named patterns.
+ */
+export declare function resolveDiscordReactionEmoji(value: string): string;
+export declare function shouldAutoThreadOnDiscordMention(account: Pick<DiscordChannelAccount, "autoThreadOnMention" | "threadPolicyByChannel">, channelId: string): boolean;
+export declare function buildDiscordIngressMessageKey(accountId: string | undefined, messageId: string | undefined): string | null;
+export declare function buildDiscordReplyOptions(replyToMessageId: string | undefined, channelId: string): {
+    reply: {
+        messageReference: string;
+        failIfNotExists: false;
+    };
+} | undefined;
+export declare function formatDiscordLifecycleErrorMessage(errorText: string, runId?: string | null): string;
+/**
+ * Best-effort: post a user-facing error reply when forwarding a Discord
+ * message to the agent runtime fails. Swallows any send failure so the
+ * notification path can never crash the listener.
+ */
+export declare function notifyDiscordDeliveryError(message: DiscordMessageLike, error: unknown): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/channels/discord/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAI1B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,OAAO,IAAI,kBAAkB,GAAG;IACjC,WAAW,EAAE,MAAM,OAAO,CAAC;CAC5B,CAEA;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,OAAO,IAAI,kBAAkB,GAAG;IACjC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,QAAQ,EAAE;QACR,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;KAC3D,CAAC;CACH,CAMA;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,OAAO,IAAI,kBAAkB,GAAG;IACjC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E,CAEA;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GACjC,OAAO,IAAI,kBAAkB,GAAG;IACjC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC,CAIA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB1E;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAGR;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajE;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,IAAI,CACX,qBAAqB,EACrB,qBAAqB,GAAG,uBAAuB,CAChD,EACD,SAAS,EAAE,MAAM,GAChB,OAAO,CAIT;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,IAAI,CAKf;AAED,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,KAAK,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,CAW7E;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAef"}

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

@@ -0,0 +1,26 @@
+import type { ChannelRoute, InboundChannelMessage } from "./types";
+export declare const CHANNEL_FEEDBACK_MESSAGE_MAX = 10000;
+export interface ChannelFeedbackSubmission {
+    message: string;
+    channel: string;
+    accountId?: string;
+    agentId: string;
+    conversationId: string;
+}
+export type ChannelFeedbackMetadataSubmitter = (payload: Record<string, unknown>) => Promise<void>;
+export declare function buildChannelFeedbackUsageMessage(channelId: string): string;
+export declare function buildChannelFeedbackTooLongMessage(channelId: string, maxLength?: number): string;
+export declare function buildChannelFeedbackNoRouteMessage(channelId: string): string;
+export declare function buildChannelFeedbackSubmittedMessage(channelId: string): string;
+export declare function buildChannelFeedbackFailedMessage(channelId: string): string;
+export declare function buildChannelFeedbackPayload(submission: ChannelFeedbackSubmission): Record<string, unknown>;
+export declare function submitChannelFeedback(submission: ChannelFeedbackSubmission): Promise<void>;
+export declare function handleChannelFeedbackCommand(params: {
+    msg: InboundChannelMessage;
+    command: {
+        args: string;
+    };
+    route?: ChannelRoute | null;
+}): Promise<string>;
+export declare function __testOverrideSubmitChannelFeedback(submitter: ChannelFeedbackMetadataSubmitter | null): void;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../src/channels/feedback.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEnE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAInD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gCAAgC,GAAG,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;AAYnB,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAqC,GAC/C,MAAM,CAGR;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAUD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,yBAAyB,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,yBAAyB,GACpC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,GAAG,EAAE,qBAAqB,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlB;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,gCAAgC,GAAG,IAAI,GACjD,IAAI,CAEN"}

package/dist/types/channels/gateway-core.d.ts

@@ -0,0 +1,69 @@
+import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
+import type { ApprovalResponseBody, ExternalToolCallRequestMessage, ExternalToolCallResult, ExternalToolDefinitionPayload, InputAcceptedResponseMessage, InputCommand, RuntimeScope, RuntimeStartCommand, RuntimeStartResponseMessage, StreamDeltaMessage, WsProtocolMessage } from "../types/app-server-protocol";
+import type { ChannelControlRequestEvent, ChannelDefaultPermissionMode, ChannelTurnLifecycleEvent, ChannelTurnProgressEvent, ChannelTurnSource } from "./types";
+export declare const CHANNEL_GATEWAY_TOOL_SCOPE_ID = "channel-gateway";
+export interface ChannelGatewayClient {
+    close(): void;
+    onMessage(listener: (message: WsProtocolMessage) => void): () => void;
+    onExternalToolCall(handler: (request: ExternalToolCallRequestMessage) => Promise<ExternalToolCallResult> | ExternalToolCallResult): () => void;
+    submitInput(command: Omit<InputCommand, "type">): Promise<InputAcceptedResponseMessage>;
+    runtimeStart(options: Omit<RuntimeStartCommand, "type" | "request_id"> & {
+        request_id?: string;
+    }): Promise<RuntimeStartResponseMessage>;
+}
+export interface ChannelGatewayDelivery {
+    runtime: RuntimeScope;
+    content: MessageCreate["content"];
+    sources: ChannelTurnSource[];
+    clientMessageId: string;
+    defaultPermissionMode?: ChannelDefaultPermissionMode;
+}
+export interface ChannelGatewayHooks {
+    buildExternalTool(runtime: RuntimeScope, sources: ChannelTurnSource[]): Promise<ExternalToolDefinitionPayload>;
+    executeExternalTool(request: ExternalToolCallRequestMessage, sources: ChannelTurnSource[]): Promise<ExternalToolCallResult> | ExternalToolCallResult;
+    onLifecycle(event: ChannelTurnLifecycleEvent): void | Promise<void>;
+    onProgress(event: ChannelTurnProgressEvent): void | Promise<void>;
+    onControlRequest(event: ChannelControlRequestEvent): void | Promise<void>;
+    createRichDraft?(options: {
+        batchId: string;
+        sources: ChannelTurnSource[];
+    }): ChannelGatewayRichDraft | null;
+}
+export interface ChannelGatewayRichDraft {
+    handleDelta(delta: StreamDeltaMessage["delta"]): void;
+    flushPending(): Promise<void>;
+    dispose(): void;
+}
+export interface ChannelGatewayModelStatus {
+    modelHandle: string | null;
+    scope: "agent" | "conversation";
+}
+/**
+ * Process-neutral Channels bridge. It only speaks the public App Server
+ * protocol; channel adapters and credentials stay behind the injected hooks.
+ */
+export declare class ChannelGateway {
+    private readonly client;
+    private readonly hooks;
+    private readonly states;
+    private readonly disposers;
+    constructor(client: ChannelGatewayClient, hooks: ChannelGatewayHooks);
+    close(): void;
+    submit(delivery: ChannelGatewayDelivery): Promise<boolean>;
+    private submitDelivery;
+    restoreRuntime(runtime: RuntimeScope, sources: ChannelTurnSource[]): Promise<Set<string>>;
+    registerRuntime(runtime: RuntimeScope, sources?: ChannelTurnSource[], defaultPermissionMode?: ChannelDefaultPermissionMode): Promise<void>;
+    submitApprovalResponse(runtime: RuntimeScope, response: ApprovalResponseBody): Promise<boolean>;
+    getModelStatus(runtime: RuntimeScope): ChannelGatewayModelStatus | null;
+    updateModelStatus(runtime: RuntimeScope, modelHandle: string | null): void;
+    private getState;
+    private enqueueHook;
+    private ensureRuntimeRegistration;
+    private handleMessage;
+    private handleQueueUpdate;
+    private activateSources;
+    private handleStreamDelta;
+    private handleTurnFinished;
+    private handleControlRequest;
+}
+//# sourceMappingURL=gateway-core.d.ts.map

package/dist/types/channels/gateway-core.d.ts.map

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

package/dist/types/channels/inbound-debounce.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Trailing-edge keyed debouncer for inbound channel messages.
+ *
+ * When a burst of messages arrives with the same key (e.g. a user sending
+ * several short Slack messages in a row), they are buffered and flushed as
+ * a single batch after `debounceMs` of quiet time. Ordering per key is
+ * preserved: an immediate (non-debounced) item for the same key cannot
+ * overtake a pending debounced flush.
+ *
+ * Ported (with minor simplifications) from openclaw's
+ * `src/auto-reply/inbound-debounce.ts`, which has field-tested the
+ * reserved-slot ordering model.
+ */
+export interface InboundDebounceParams<T> {
+    /** Debounce window in ms. `0` disables debouncing (items flush immediately). */
+    debounceMs: number;
+    /**
+     * Group key for an item. Items with the same key stack together.
+     * Returning `null`/`undefined` forces immediate dispatch (no grouping).
+     */
+    buildKey: (item: T) => string | null | undefined;
+    /**
+     * Optional per-item gate. Return `false` to bypass debouncing for the
+     * item (flushes immediately, but still respects any pending buffer for
+     * the same key to preserve ordering).
+     */
+    shouldDebounce?: (item: T) => boolean;
+    /** Called with the buffered items when a key's window expires. */
+    onFlush: (items: T[]) => Promise<void>;
+    /** Called when `onFlush` throws. Non-throwing. */
+    onError?: (err: unknown, items: T[]) => void;
+    /** Safety cap on the number of tracked keys. Defaults to 2048. */
+    maxTrackedKeys?: number;
+}
+export interface InboundDebouncer<T> {
+    /**
+     * Enqueue an item. Resolves when the flush that owns this item (if any)
+     * has been dispatched via `onFlush`. For immediate (non-debounced) items,
+     * resolves after dispatch.
+     */
+    enqueue: (item: T) => Promise<void>;
+    /** Force an immediate flush for a specific key, if any buffer is pending. */
+    flushKey: (key: string) => Promise<void>;
+}
+export declare function createInboundDebouncer<T>(params: InboundDebounceParams<T>): InboundDebouncer<T>;
+//# sourceMappingURL=inbound-debounce.d.ts.map

package/dist/types/channels/inbound-debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-debounce.d.ts","sourceRoot":"","sources":["../../../src/channels/inbound-debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACtC,kEAAkE;IAClE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7C,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,gBAAgB,CAAC,CAAC,CAAC,CAuLrB"}

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

@@ -0,0 +1,13 @@
+import type { ApprovalResponseBody } from "../types/protocol_v2";
+import type { ChannelControlRequestEvent } from "./types";
+type ParsedChannelControlRequestResponse = {
+    type: "response";
+    response: ApprovalResponseBody;
+} | {
+    type: "reprompt";
+    message: string;
+};
+export declare function formatChannelControlRequestPrompt(event: ChannelControlRequestEvent): string;
+export declare function parseChannelControlRequestResponse(event: ChannelControlRequestEvent, rawText: string): ParsedChannelControlRequestResponse;
+export {};
+//# sourceMappingURL=interactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../../src/channels/interactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAe1D,KAAK,mCAAmC,GACpC;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;CAChC,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAyaN,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,0BAA0B,GAChC,MAAM,CAWR;AA8FD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,MAAM,GACd,mCAAmC,CAmBrC"}

package/dist/types/channels/lifecycle-error-report.d.ts

@@ -0,0 +1,19 @@
+import { type ChannelLifecycleErrorKind } from "./lifecycle-error";
+import type { ChannelTurnSource } from "./types";
+export interface ChannelLifecycleErrorReport {
+    channel: string;
+    accountId?: string;
+    agentId?: string;
+    conversationId?: string;
+    errorKind: ChannelLifecycleErrorKind;
+    errorMessage: string;
+    runId?: string;
+}
+export type ChannelLifecycleErrorReportSubmitter = (report: ChannelLifecycleErrorReport) => Promise<void>;
+export declare function buildChannelLifecycleErrorReport(source: ChannelTurnSource, errorText: string | null | undefined, options?: {
+    runId?: string | null;
+}): ChannelLifecycleErrorReport;
+export declare function buildChannelLifecycleErrorReportPayload(report: ChannelLifecycleErrorReport): Record<string, unknown>;
+export declare function submitChannelLifecycleErrorReport(report: ChannelLifecycleErrorReport): Promise<void>;
+export declare function __testOverrideSubmitChannelLifecycleErrorReport(submitter: ChannelLifecycleErrorReportSubmitter | null): void;
+//# sourceMappingURL=lifecycle-error-report.d.ts.map

package/dist/types/channels/lifecycle-error-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-error-report.d.ts","sourceRoot":"","sources":["../../../src/channels/lifecycle-error-report.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIjD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,yBAAyB,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oCAAoC,GAAG,CACjD,MAAM,EAAE,2BAA2B,KAChC,OAAO,CAAC,IAAI,CAAC,CAAC;AAiBnB,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACtC,2BAA2B,CAa7B;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAgB,+CAA+C,CAC7D,SAAS,EAAE,oCAAoC,GAAG,IAAI,GACrD,IAAI,CAEN"}

package/dist/types/channels/message-channel-executor.d.ts

@@ -0,0 +1,46 @@
+import type { MessageChannelInput } from "./message-channel-types";
+import type { ChannelMessageActionAdapter, ChannelMessageActionRoute, ChannelMessageActionTransport, ChannelResolvedMessageTarget } from "./plugin-types";
+import type { ChannelTurnSource, SupportedChannelId } from "./types";
+export interface MessageChannelExecutionScope {
+    agentId: string;
+    conversationId: string;
+}
+export interface ResolvedMessageChannelContext {
+    route: ChannelMessageActionRoute;
+    transport: ChannelMessageActionTransport;
+    messageActions: ChannelMessageActionAdapter;
+}
+export interface ResolvedProactiveMessageChannelContext {
+    accountId: string;
+    target: ChannelResolvedMessageTarget;
+    transport: ChannelMessageActionTransport;
+    messageActions: ChannelMessageActionAdapter;
+}
+export interface MessageChannelExecutionResolver {
+    isSupportedChannel(channel: string): boolean;
+    resolveRoutedContext(params: {
+        channel: SupportedChannelId;
+        chatId: string;
+        accountId?: string;
+        scope: MessageChannelExecutionScope;
+    }): Promise<ResolvedMessageChannelContext | string | null> | ResolvedMessageChannelContext | string | null;
+    resolveProactiveContext?(params: {
+        channel: SupportedChannelId;
+        target: string;
+        accountId?: string;
+        scope: MessageChannelExecutionScope;
+    }): Promise<ResolvedProactiveMessageChannelContext | string> | ResolvedProactiveMessageChannelContext | string;
+}
+export interface ExecuteMessageChannelOptions {
+    scope: MessageChannelExecutionScope;
+    resolver: MessageChannelExecutionResolver;
+    channelTurnSources?: ChannelTurnSource[];
+}
+/**
+ * Execute the canonical MessageChannel contract against host-owned routing and
+ * transport adapters. This owns normalization, scope checks, thread/account
+ * inference, action discovery, and outbound formatting without requiring the
+ * local channel registry or local credentials.
+ */
+export declare function executeMessageChannel(input: MessageChannelInput | Record<string, unknown>, options: ExecuteMessageChannelOptions): Promise<string>;
+//# sourceMappingURL=message-channel-executor.d.ts.map

package/dist/types/channels/message-channel-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-channel-executor.d.ts","sourceRoot":"","sources":["../../../src/channels/message-channel-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,2BAA2B,EAE3B,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,yBAAyB,CAAC;IACjC,SAAS,EAAE,6BAA6B,CAAC;IACzC,cAAc,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,WAAW,sCAAsC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,EAAE,6BAA6B,CAAC;IACzC,cAAc,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,WAAW,+BAA+B;IAC9C,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,oBAAoB,CAAC,MAAM,EAAE;QAC3B,OAAO,EAAE,kBAAkB,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,4BAA4B,CAAC;KACrC,GACG,OAAO,CAAC,6BAA6B,GAAG,MAAM,GAAG,IAAI,CAAC,GACtD,6BAA6B,GAC7B,MAAM,GACN,IAAI,CAAC;IACT,uBAAuB,CAAC,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,kBAAkB,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,4BAA4B,CAAC;KACrC,GACG,OAAO,CAAC,sCAAsC,GAAG,MAAM,CAAC,GACxD,sCAAsC,GACtC,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,4BAA4B,CAAC;IACpC,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AA8ND;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CA0FjB"}

package/dist/types/channels/message-channel-formatting.d.ts

@@ -0,0 +1,6 @@
+import type { OutboundChannelMessage } from "./types";
+export declare function markdownToTelegramHtml(text: string): string;
+export declare function markdownToSlackMrkdwn(text: string): string;
+export declare function markdownToSignalTextStyles(text: string): Pick<OutboundChannelMessage, "text" | "textStyle">;
+export declare function formatOutboundChannelMessage(channel: string, text: string): Pick<OutboundChannelMessage, "text" | "parseMode" | "textStyle">;
+//# sourceMappingURL=message-channel-formatting.d.ts.map

package/dist/types/channels/message-channel-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-channel-formatting.d.ts","sourceRoot":"","sources":["../../../src/channels/message-channel-formatting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAiRtD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAoLD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AA+ND,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,WAAW,CAAC,CAsDpD;AAqBD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC,CAOlE"}

package/dist/types/channels/message-channel-tool-definition.d.ts

@@ -0,0 +1,40 @@
+import type { ExternalToolDefinitionPayload } from "../types/app-server-protocol";
+import type { ChannelMessageActionAdapter, ChannelMessageToolSchemaContribution } from "./plugin-types";
+import type { SupportedChannelId } from "./types";
+export interface MessageChannelToolChannel {
+    channelId: SupportedChannelId;
+    displayName: string;
+    accountId?: string | null;
+    messageActions?: Pick<ChannelMessageActionAdapter, "describeMessageTool"> | null;
+}
+export interface MessageChannelToolDiscoveryResult {
+    activeChannels: SupportedChannelId[];
+    displayNames: string[];
+    accountIds: string[];
+    actions: string[];
+    schemaContributions: ChannelMessageToolSchemaContribution[];
+}
+export interface BuildMessageChannelToolOptions {
+    channels: readonly MessageChannelToolChannel[];
+    /** Whether this tool is attached to one routed external-channel scope. */
+    scoped: boolean;
+    /** Advertise target-based proactive sends when the host can resolve them. */
+    allowProactiveTargets?: boolean;
+}
+export interface ResolvedMessageChannelToolDefinition {
+    description: string;
+    schema: Record<string, unknown>;
+}
+export declare function resolveMessageChannelToolChannels(channels: readonly MessageChannelToolChannel[]): MessageChannelToolDiscoveryResult;
+export declare function buildMessageChannelSchemaFromDiscovery(baseSchema: Record<string, unknown>, discovery: MessageChannelToolDiscoveryResult, allowProactiveTargets?: boolean): Record<string, unknown>;
+export declare function buildMessageChannelDescriptionFromDiscovery(baseDescription: string, discovery: MessageChannelToolDiscoveryResult, scoped: boolean, allowProactiveTargets?: boolean): string;
+export declare function buildMessageChannelToolFromDiscovery(params: {
+    baseDescription: string;
+    baseSchema: Record<string, unknown>;
+    discovery: MessageChannelToolDiscoveryResult;
+    scoped: boolean;
+    allowProactiveTargets?: boolean;
+}): ResolvedMessageChannelToolDefinition;
+/** Build the exact model-facing MessageChannel tool for an external gateway. */
+export declare function buildMessageChannelExternalToolDefinition(options: BuildMessageChannelToolOptions): ExternalToolDefinitionPayload;
+//# sourceMappingURL=message-channel-tool-definition.d.ts.map

package/dist/types/channels/message-channel-tool-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-channel-tool-definition.d.ts","sourceRoot":"","sources":["../../../src/channels/message-channel-tool-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EACV,2BAA2B,EAE3B,oCAAoC,EACrC,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,IAAI,CACnB,2BAA2B,EAC3B,qBAAqB,CACtB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,iCAAiC;IAChD,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mBAAmB,EAAE,oCAAoC,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC/C,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAyBD,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,SAAS,yBAAyB,EAAE,GAC7C,iCAAiC,CA6BnC;AAcD,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,EAAE,iCAAiC,EAC5C,qBAAqB,UAAO,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzB;AAgDD,wBAAgB,2CAA2C,CACzD,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,iCAAiC,EAC5C,MAAM,EAAE,OAAO,EACf,qBAAqB,UAAO,GAC3B,MAAM,CAqER;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,iCAAiC,CAAC;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,oCAAoC,CAcvC;AAED,gFAAgF;AAChF,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAc/B"}

package/dist/types/channels/message-channel-types.d.ts

@@ -0,0 +1,46 @@
+import type { ChannelMessageActionName } from "./plugin-types";
+import type { ChannelTurnSource, SupportedChannelId } from "./types";
+export interface MessageChannelInput {
+    channel: string;
+    action: string;
+    chat_id?: string;
+    target?: string;
+    accountId?: string;
+    message?: string;
+    replyTo?: string;
+    threadId?: string;
+    messageId?: string;
+    attachmentId?: string;
+    emoji?: string;
+    remove?: boolean;
+    media?: string;
+    filename?: string;
+    title?: string;
+}
+export interface MessageChannelArgs extends MessageChannelInput {
+    /** Injected by executeTool() — NOT read from global context. */
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+    /** Injected by executeTool() for channel-originated turns. */
+    channelTurnSources?: ChannelTurnSource[];
+}
+export interface NormalizedMessageChannelInput {
+    channel: SupportedChannelId;
+    action: ChannelMessageActionName;
+    chatId?: string;
+    target?: string;
+    accountId?: string;
+    message?: string;
+    replyToMessageId?: string;
+    threadId?: string | null;
+    messageId?: string;
+    attachmentId?: string;
+    emoji?: string;
+    remove?: boolean;
+    mediaPath?: string;
+    filename?: string;
+    title?: string;
+}
+//# sourceMappingURL=message-channel-types.d.ts.map

package/dist/types/channels/message-channel-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-channel-types.d.ts","sourceRoot":"","sources":["../../../src/channels/message-channel-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,gEAAgE;IAChE,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/channels/message-tool.d.ts

@@ -0,0 +1,15 @@
+import { type MessageChannelToolDiscoveryResult, type ResolvedMessageChannelToolDefinition } from "./message-channel-tool-definition";
+import type { SupportedChannelId } from "./types";
+export type MessageChannelToolScopeEntry = {
+    channelId: SupportedChannelId;
+    accountId?: string | null;
+};
+export type MessageChannelToolDiscoveryScope = {
+    channels: MessageChannelToolScopeEntry[];
+};
+export declare function resolveMessageChannelToolDiscovery(scope?: MessageChannelToolDiscoveryScope | null): Promise<MessageChannelToolDiscoveryResult>;
+export declare function buildDynamicMessageChannelSchema(baseSchema: Record<string, unknown>, scope?: MessageChannelToolDiscoveryScope | null): Promise<Record<string, unknown>>;
+export declare function buildDynamicMessageChannelToolDefinition(baseDescription: string, baseSchema: Record<string, unknown>, scope?: MessageChannelToolDiscoveryScope | null): Promise<ResolvedMessageChannelToolDefinition>;
+export declare function getCachedDynamicMessageChannelToolDefinition(): ResolvedMessageChannelToolDefinition | null;
+export declare function clearDynamicMessageChannelToolCache(): void;
+//# sourceMappingURL=message-tool.d.ts.map

package/dist/types/channels/message-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-tool.d.ts","sourceRoot":"","sources":["../../../src/channels/message-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iCAAiC,EACtC,KAAK,oCAAoC,EAE1C,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C,CAAC;AAmDF,wBAAsB,kCAAkC,CACtD,KAAK,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAC9C,OAAO,CAAC,iCAAiC,CAAC,CAI5C;AAED,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKlC;AAED,wBAAsB,wCAAwC,CAC5D,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,CAAC,EAAE,gCAAgC,GAAG,IAAI,GAC9C,OAAO,CAAC,oCAAoC,CAAC,CAc/C;AAED,wBAAgB,4CAA4C,IAAI,oCAAoC,GAAG,IAAI,CAM1G;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAG1D"}

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

@@ -0,0 +1,53 @@
+/**
+ * Channel pairing store.
+ *
+ * Handles the pairing flow for channels with dm_policy: "pairing".
+ * When an unknown user messages the channel, they get a pairing code.
+ * The user runs `/channels <channel> pair <code>` to approve the connection.
+ *
+ * Persisted in ~/.letta/channels/<channel>/pairing.yaml.
+ *
+ * Reference: earlier pairing-store implementation
+ */
+import type { ApprovedUser, PairingStore, PendingPairing } from "./types";
+export declare function loadPairingStore(channelId: string): void;
+/**
+ * Check if a user is approved (has completed pairing).
+ */
+export declare function isUserApproved(channelId: string, userId: string, accountId?: string): boolean;
+/**
+ * Create a pending pairing code for an unknown user.
+ * Returns the generated code.
+ */
+export declare function createPairingCode(channelId: string, userId: string, chatId: string, username?: string, accountId?: string): string;
+/**
+ * Validate and consume a pairing code.
+ * Returns the pending pairing info if valid, null if invalid/expired.
+ */
+export declare function consumePairingCode(channelId: string, code: string, accountId?: string): PendingPairing | null;
+/**
+ * Get all pending pairing codes for a channel.
+ * Filters out expired codes.
+ */
+export declare function getPendingPairings(channelId: string, accountId?: string): PendingPairing[];
+/**
+ * Get all approved users for a channel.
+ */
+export declare function getApprovedUsers(channelId: string, accountId?: string): ApprovedUser[];
+/**
+ * Roll back a pairing approval.
+ * Re-adds the pending code and removes the approved user entry.
+ * Used when route creation fails after pairing was consumed.
+ */
+export declare function rollbackPairingApproval(channelId: string, pending: PendingPairing): void;
+export declare function removePairingStateForAccount(channelId: string, accountId: string): {
+    pendingRemoved: number;
+    approvedRemoved: number;
+};
+/**
+ * Clear all pairing state (for testing).
+ */
+export declare function clearPairingStores(): void;
+export declare function __testOverrideLoadPairingStore(fn: ((channelId: string) => PairingStore | null) | null): void;
+export declare function __testOverrideSavePairingStore(fn: ((channelId: string, store: PairingStore) => void) | null): void;
+//# sourceMappingURL=pairing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/channels/pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAuC1E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CA0BxD;AAoCD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAQT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAqDR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI,CAuDvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,cAAc,EAAE,CAWlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,YAAY,EAAE,CAQhB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,IAAI,CAiBN;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAsBrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI,GACtD,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,GAC5D,IAAI,CAEN"}

package/dist/types/channels/pending-control-requests.d.ts

@@ -0,0 +1,12 @@
+import type { ChannelControlRequestEvent } from "./types";
+type PendingControlRequestStore = {
+    requests: ChannelControlRequestEvent[];
+};
+export declare function listPendingControlRequests(): ChannelControlRequestEvent[];
+export declare function upsertPendingControlRequest(event: ChannelControlRequestEvent): ChannelControlRequestEvent;
+export declare function removePendingControlRequest(requestId: string): boolean;
+export declare function clearPendingControlRequestStore(): void;
+export declare function __testOverrideLoadPendingControlRequestStore(fn: (() => PendingControlRequestStore | null) | null): void;
+export declare function __testOverrideSavePendingControlRequestStore(fn: ((nextStore: PendingControlRequestStore) => void) | null): void;
+export {};
+//# sourceMappingURL=pending-control-requests.d.ts.map

package/dist/types/channels/pending-control-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-control-requests.d.ts","sourceRoot":"","sources":["../../../src/channels/pending-control-requests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D,KAAK,0BAA0B,GAAG;IAChC,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC,CAAC;AAiGF,wBAAgB,0BAA0B,IAAI,0BAA0B,EAAE,CAGzE;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,0BAA0B,CAe5B;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAatE;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AAED,wBAAgB,4CAA4C,CAC1D,EAAE,EAAE,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,GAAG,IAAI,GACnD,IAAI,CAGN;AAED,wBAAgB,4CAA4C,CAC1D,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,0BAA0B,KAAK,IAAI,CAAC,GAAG,IAAI,GAC3D,IAAI,CAEN"}

package/dist/types/channels/plugin-registry.d.ts

@@ -0,0 +1,9 @@
+import type { ChannelPlugin, ChannelPluginMetadata } from "./plugin-types";
+export declare function isSupportedChannelId(value: string): value is string;
+export declare function getSupportedChannelIds(): string[];
+export declare function getChannelPluginMetadata(channelId: string): ChannelPluginMetadata;
+export declare function getChannelDisplayName(channelId: string): string;
+export declare function isFirstPartyChannelPlugin(channelId: string): boolean;
+export declare function loadChannelPlugin(channelId: string): Promise<ChannelPlugin>;
+export declare function __testClearUserChannelPluginCache(): void;
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/types/channels/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../../src/channels/plugin-registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,aAAa,EACb,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AA4RxB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEnE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAMjD;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAMvB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAMxB;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

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

@@ -189,10 +189,14 @@ export interface ChannelResolvedMessageTarget {
     threadId?: string | null;
     label?: string;
 }
+/** Minimal outbound surface consumed by channel-owned MessageChannel actions. */
+export type ChannelMessageActionTransport = Pick<ChannelAdapter, "sendMessage" | "downloadAttachment">;
+/** Route identity required by MessageChannel action implementations. */
+export type ChannelMessageActionRoute = Pick<ChannelRoute, "accountId" | "chatId" | "chatType" | "threadId" | "agentId" | "conversationId">;
 export interface ChannelMessageActionContext {
     request: ChannelMessageActionRequest;
-    route: ChannelRoute;
-    adapter: ChannelAdapter;
+    route: ChannelMessageActionRoute;
+    adapter: ChannelMessageActionTransport;
     /**
      * Format user-authored markdown/plain text for the target channel before the
      * plugin sends it. The shared MessageChannel tool owns cross-channel text