import type { ChannelId } from "../channels/plugins/types.js";
import type { MediaUnderstandingDecision, MediaUnderstandingOutput } from "../media-understanding/types.js";
import type { InternalMessageChannel } from "../utils/message-channel.js";
import type { CommandArgs } from "./commands-registry.types.js";
/** Valid message channels for routing. */
export type OriginatingChannelType = ChannelId | InternalMessageChannel;
export type MsgContext = {
    Body?: string;
    /**
     * Agent prompt body (may include envelope/history/context). Prefer this for prompt shaping.
     * Should use real newlines (`\n`), not escaped `\\n`.
     */
    BodyForAgent?: string;
    /**
     * Recent chat history for context (untrusted user content). Prefer passing this
     * as structured context blocks in the user prompt rather than rendering plaintext envelopes.
     */
    InboundHistory?: Array<{
        sender: string;
        body: string;
        timestamp?: number;
    }>;
    /**
     * Raw message body without structural context (history, sender labels).
     * Legacy alias for CommandBody. Falls back to Body if not set.
     */
    RawBody?: string;
    /**
     * Prefer for command detection; RawBody is treated as legacy alias.
     */
    CommandBody?: string;
    /**
     * Command parsing body. Prefer this over CommandBody/RawBody when set.
     * Should be the "clean" text (no history/sender context).
     */
    BodyForCommands?: string;
    CommandArgs?: CommandArgs;
    From?: string;
    To?: string;
    SessionKey?: string;
    /** Provider account id (multi-account). */
    AccountId?: string;
    ParentSessionKey?: string;
    MessageSid?: string;
    /** Provider-specific full message id when MessageSid is a shortened alias. */
    MessageSidFull?: string;
    MessageSids?: string[];
    MessageSidFirst?: string;
    MessageSidLast?: string;
    ReplyToId?: string;
    /** Provider-specific full reply-to id when ReplyToId is a shortened alias. */
    ReplyToIdFull?: string;
    ReplyToBody?: string;
    ReplyToSender?: string;
    ReplyToIsQuote?: boolean;
    ForwardedFrom?: string;
    ForwardedFromType?: string;
    ForwardedFromId?: string;
    ForwardedFromUsername?: string;
    ForwardedFromTitle?: string;
    ForwardedFromSignature?: string;
    ForwardedFromChatType?: string;
    ForwardedFromMessageId?: number;
    ForwardedDate?: number;
    ThreadStarterBody?: string;
    /** Full thread history when starting a new thread session. */
    ThreadHistoryBody?: string;
    IsFirstThreadTurn?: boolean;
    ThreadLabel?: string;
    MediaPath?: string;
    MediaUrl?: string;
    MediaType?: string;
    MediaDir?: string;
    MediaPaths?: string[];
    MediaUrls?: string[];
    MediaTypes?: string[];
    OutputDir?: string;
    OutputBase?: string;
    /** Remote host for SCP when media lives on a different machine (e.g., symi@192.168.64.3). */
    MediaRemoteHost?: string;
    Transcript?: string;
    MediaUnderstanding?: MediaUnderstandingOutput[];
    MediaUnderstandingDecisions?: MediaUnderstandingDecision[];
    LinkUnderstanding?: string[];
    Prompt?: string;
    MaxChars?: number;
    ChatType?: string;
    /** Human label for envelope headers (conversation label, not sender). */
    ConversationLabel?: string;
    GroupSubject?: string;
    /** Human label for channel-like group conversations (e.g. #general, #support). */
    GroupChannel?: string;
    GroupSpace?: string;
    GroupMembers?: string;
    GroupSystemPrompt?: string;
    /** Untrusted metadata that must not be treated as system instructions. */
    UntrustedContext?: string[];
    /** Explicit owner allowlist overrides (trusted, configuration-derived). */
    OwnerAllowFrom?: Array<string | number>;
    SenderName?: string;
    SenderId?: string;
    SenderUsername?: string;
    SenderTag?: string;
    SenderE164?: string;
    Timestamp?: number;
    /** Provider label (e.g. slack, msteams). */
    Provider?: string;
    /** Provider surface label (e.g. slack, msteams). Prefer this over `Provider` when available. */
    Surface?: string;
    WasMentioned?: boolean;
    CommandAuthorized?: boolean;
    CommandSource?: "text" | "native";
    CommandTargetSessionKey?: string;
    /** Gateway client scopes when the message originates from the gateway. */
    GatewayClientScopes?: string[];
    /** Thread identifier (Telegram topic id or Matrix thread event id). */
    MessageThreadId?: string | number;
    /** Telegram forum supergroup marker. */
    IsForum?: boolean;
    /**
     * Originating channel for reply routing.
     * When set, replies should be routed back to this provider
     * instead of using lastChannel from the session.
     */
    OriginatingChannel?: OriginatingChannelType;
    /**
     * Originating destination for reply routing.
     * The chat/channel/user ID where the reply should be sent.
     */
    OriginatingTo?: string;
    /**
     * Messages from hooks to be included in the response.
     * Used for hook confirmation messages like "Session context saved to memory".
     */
    HookMessages?: string[];
};
export type FinalizedMsgContext = Omit<MsgContext, "CommandAuthorized"> & {
    /**
     * Always set by finalizeInboundContext().
     * Default-deny: missing/undefined becomes false.
     */
    CommandAuthorized: boolean;
};
export type TemplateContext = MsgContext & {
    BodyStripped?: string;
    SessionId?: string;
    IsNewSession?: string;
};
export declare function applyTemplate(str: string | undefined, ctx: TemplateContext): string;
