openclaw/dist/plugin-sdk/channel-targets.d.ts

Multi-channel AI gateway with extensible messaging integrations

import { V as ChannelTtsVoiceDeliveryCapabilities } from "./types.core-DVz0Aka0.js";
import { t as ChannelId } from "./channel-id.types-DjYEl-_2.js";
import { a as normalizeChannelSlug, c as resolveChannelMatchConfig, i as buildChannelKeyCandidates, l as resolveNestedAllowlistDecision, n as ChannelMatchSource, o as resolveChannelEntryMatch, r as applyChannelMatchMeta, s as resolveChannelEntryMatchWithFallback, t as ChannelEntryMatch } from "./channel-config-BBLiKj96.js";
import { t as normalizeChannelId } from "./registry-CE_KPzio.js";
import { a as ensureTargetId, c as parseMentionPrefixOrAtUserTarget, d as parseTargetPrefixes, f as requireTargetKind, i as buildMessagingTarget, l as parseTargetMention, n as MessagingTargetKind, o as normalizeTargetId, r as MessagingTargetParseOptions, s as parseAtUserTarget, t as MessagingTarget, u as parseTargetPrefix } from "./targets-CYTLGChd.js";
import { n as resolveTargetsWithOptionalToken, t as buildUnresolvedTargetResults } from "./target-resolvers-Cgp5HmSp.js";

//#region src/channels/plugins/chat-target-prefixes.d.ts
/**
 * Prefix mapping for service-qualified target strings.
 */
type ServicePrefix<TService extends string> = {
  prefix: string;
  service: TService;
};
/**
 * Normalized input used by chat target prefix parsers.
 */
type ChatTargetPrefixesParams = {
  trimmed: string;
  lower: string;
  chatIdPrefixes: string[];
  chatGuidPrefixes: string[];
  chatIdentifierPrefixes: string[];
};
/**
 * Parsed conversation target forms accepted by channel allowlists and target resolvers.
 */
type ParsedChatTarget = {
  kind: "chat_id";
  chatId: number;
} | {
  kind: "chat_guid";
  chatGuid: string;
} | {
  kind: "chat_identifier";
  chatIdentifier: string;
};
/**
 * Parsed allowlist target, including sender handles.
 */
type ParsedChatAllowTarget = ParsedChatTarget | {
  kind: "handle";
  handle: string;
};
/**
 * Sender metadata used for chat-aware allowlist checks.
 */
type ChatSenderAllowParams = {
  allowFrom: Array<string | number>;
  sender: string;
  chatId?: number | null;
  chatGuid?: string | null;
  chatIdentifier?: string | null;
  allowConversationTargets?: boolean | null;
};
/**
 * Resolves service-prefixed handle targets, delegating chat-shaped remainders.
 */
declare function resolveServicePrefixedTarget<TService extends string, TTarget>(params: {
  trimmed: string;
  lower: string;
  servicePrefixes: Array<ServicePrefix<TService>>;
  isChatTarget: (remainderLower: string) => boolean;
  parseTarget: (remainder: string) => TTarget;
}): ({
  kind: "handle";
  to: string;
  service: TService;
} | TTarget) | null;
/**
 * Resolves service-prefixed targets where chat ids should bypass handle parsing.
 */
declare function resolveServicePrefixedChatTarget<TService extends string, TTarget>(params: {
  trimmed: string;
  lower: string;
  servicePrefixes: Array<ServicePrefix<TService>>;
  chatIdPrefixes: string[];
  chatGuidPrefixes: string[];
  chatIdentifierPrefixes: string[];
  extraChatPrefixes?: string[];
  parseTarget: (remainder: string) => TTarget;
}): ({
  kind: "handle";
  to: string;
  service: TService;
} | TTarget) | null;
/**
 * Parses chat target prefixes and throws for malformed prefixed values.
 */
declare function parseChatTargetPrefixesOrThrow(params: ChatTargetPrefixesParams): ParsedChatTarget | null;
/**
 * Resolves service-prefixed allowlist targets.
 */
declare function resolveServicePrefixedAllowTarget<TAllowTarget>(params: {
  trimmed: string;
  lower: string;
  servicePrefixes: Array<{
    prefix: string;
  }>;
  parseAllowTarget: (remainder: string) => TAllowTarget;
}): (TAllowTarget | {
  kind: "handle";
  handle: string;
}) | null;
/**
 * Resolves service-prefixed allow targets before falling back to chat prefixes.
 */
declare function resolveServicePrefixedOrChatAllowTarget<TAllowTarget extends ParsedChatAllowTarget>(params: {
  trimmed: string;
  lower: string;
  servicePrefixes: Array<{
    prefix: string;
  }>;
  parseAllowTarget: (remainder: string) => TAllowTarget;
  chatIdPrefixes: string[];
  chatGuidPrefixes: string[];
  chatIdentifierPrefixes: string[];
}): TAllowTarget | null;
/**
 * Creates a reusable sender matcher for chat-aware channel allowlists.
 */
declare function createAllowedChatSenderMatcher(params: {
  normalizeSender: (sender: string) => string;
  parseAllowTarget: (entry: string) => ParsedChatAllowTarget;
  allowConversationTargets?: boolean;
}): (input: ChatSenderAllowParams) => boolean;
/**
 * Parses chat target prefixes for allowlist entries, ignoring malformed values.
 */
declare function parseChatAllowTargetPrefixes(params: ChatTargetPrefixesParams): ParsedChatTarget | null;
//#endregion
//#region src/channels/plugins/tts-capabilities.d.ts
declare function resolveChannelTtsVoiceDelivery(channel: string | undefined): ChannelTtsVoiceDeliveryCapabilities | undefined;
//#endregion
export { type ChannelEntryMatch, type ChannelId, type ChannelMatchSource, type ChatSenderAllowParams, type ChatTargetPrefixesParams, type MessagingTarget, type MessagingTargetKind, type MessagingTargetParseOptions, type ParsedChatAllowTarget, type ParsedChatTarget, type ServicePrefix, applyChannelMatchMeta, buildChannelKeyCandidates, buildMessagingTarget, buildUnresolvedTargetResults, createAllowedChatSenderMatcher, ensureTargetId, normalizeChannelId, normalizeChannelSlug, normalizeTargetId, parseAtUserTarget, parseChatAllowTargetPrefixes, parseChatTargetPrefixesOrThrow, parseMentionPrefixOrAtUserTarget, parseTargetMention, parseTargetPrefix, parseTargetPrefixes, requireTargetKind, resolveChannelEntryMatch, resolveChannelEntryMatchWithFallback, resolveChannelMatchConfig, resolveChannelTtsVoiceDelivery, resolveNestedAllowlistDecision, resolveServicePrefixedAllowTarget, resolveServicePrefixedChatTarget, resolveServicePrefixedOrChatAllowTarget, resolveServicePrefixedTarget, resolveTargetsWithOptionalToken };