remoteclaw 0.0.0 → 0.0.1

package/dist/plugin-sdk/middleware/types.d.ts

@@ -0,0 +1,236 @@
+import type { ReplyPayload } from "../auto-reply/types.js";
+/** Core interface that all CLI runtime implementations (Claude, Gemini, Codex, OpenCode) implement. */
+export interface AgentRuntime {
+    execute(params: AgentExecuteParams): AsyncIterable<AgentEvent>;
+    /** Declare which media types this runtime can handle natively. */
+    readonly mediaCapabilities?: {
+        /** MIME type prefixes accepted as inbound media (e.g., ["image/", "audio/", "video/"]). */
+        acceptsInbound?: readonly string[];
+        /** Whether the runtime can emit media in responses. */
+        emitsOutbound?: boolean;
+    };
+}
+/** A media attachment included with a prompt or produced by an agent. */
+export type MediaAttachment = {
+    /** MIME type (e.g., "image/jpeg", "audio/ogg", "video/mp4"). */
+    mimeType: string;
+    /** Local file path to the media (preferred for CLI runtimes that accept file paths). */
+    filePath?: string | undefined;
+    /** Base64-encoded content (for runtimes that accept inline data). */
+    base64?: string | undefined;
+    /** Original URL (for reference/logging; runtimes should prefer filePath or base64). */
+    sourceUrl?: string | undefined;
+    /** Original filename (for display/logging). */
+    fileName?: string | undefined;
+};
+/** Input to {@link AgentRuntime.execute}. */
+export type AgentExecuteParams = {
+    /** The user prompt to send to the agent. */
+    prompt: string;
+    /** System instructions for the agent (passed separately where supported). */
+    systemPrompt?: string | undefined;
+    /** Extra context inserted between the system prompt and user prompt. */
+    extraContext?: string | undefined;
+    /** Thread history or thread-starter context (skipped on session resume). */
+    threadContext?: string | undefined;
+    /** Media attachments to include with the prompt. */
+    media?: MediaAttachment[] | undefined;
+    /** Resume an existing session (CLI-specific session identifier). */
+    sessionId?: string | undefined;
+    /** MCP server configurations to expose to the agent. */
+    mcpServers?: Record<string, McpServerConfig> | undefined;
+    /** Abort signal for cancelling the execution. */
+    abortSignal?: AbortSignal | undefined;
+    /** Working directory for the CLI subprocess. */
+    workingDirectory?: string | undefined;
+    /** Additional environment variables for the CLI subprocess. */
+    env?: Record<string, string> | undefined;
+    /** Extra CLI arguments appended after the runtime's own args. */
+    extraArgs?: string[] | undefined;
+};
+/** MCP server configuration passed to agent CLI subprocesses. */
+export type McpServerConfig = {
+    command: string;
+    args?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+};
+/** Discriminated union of events emitted during CLI subprocess execution. */
+export type AgentEvent = AgentTextEvent | AgentMediaEvent | AgentThinkingEvent | AgentToolUseEvent | AgentToolResultEvent | AgentErrorEvent | AgentDoneEvent;
+export type AgentTextEvent = {
+    type: "text";
+    text: string;
+};
+export type AgentMediaEvent = {
+    type: "media";
+    media: MediaAttachment;
+};
+export type AgentThinkingEvent = {
+    type: "thinking";
+    text: string;
+};
+export type AgentToolUseEvent = {
+    type: "tool_use";
+    toolName: string;
+    toolId: string;
+    input: Record<string, unknown>;
+};
+export type AgentToolResultEvent = {
+    type: "tool_result";
+    toolId: string;
+    output: string;
+    isError?: boolean | undefined;
+};
+export type AgentErrorEvent = {
+    type: "error";
+    message: string;
+    code?: string | undefined;
+};
+export type AgentDoneEvent = {
+    type: "done";
+    result: AgentRunResult;
+};
+/** Final CLI output summary produced when execution completes. */
+export type AgentRunResult = {
+    /** Accumulated text output from the agent. */
+    text: string;
+    /** Media attachments produced by the agent (non-MCP path). */
+    media?: MediaAttachment[] | undefined;
+    /** CLI-specific session identifier for resumption. */
+    sessionId: string | undefined;
+    /** Wall-clock duration of the entire run in milliseconds. */
+    durationMs: number;
+    /** Token usage breakdown (if reported by the CLI). */
+    usage: AgentUsage | undefined;
+    /** Whether the run was aborted via the abort signal. */
+    aborted: boolean;
+    /** Captured stderr output from the CLI subprocess (if any). */
+    stderr?: string | undefined;
+    /** Estimated total cost in USD (if reported by the CLI). */
+    totalCostUsd?: number | undefined;
+    /** Duration spent in API calls in milliseconds (if reported). */
+    apiDurationMs?: number | undefined;
+    /** Number of agentic turns taken (if reported). */
+    numTurns?: number | undefined;
+    /** Why the agent stopped (e.g., "end_turn", "max_tokens"). */
+    stopReason?: string | undefined;
+    /** Error subtype for classification (e.g., "rate_limit", "context_window"). */
+    errorSubtype?: string | undefined;
+    /** Permission denials encountered during the run. */
+    permissionDenials?: PermissionDenial[] | undefined;
+};
+/** Token usage breakdown. */
+export type AgentUsage = {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+};
+/** A permission denial encountered during an agent run. */
+export type PermissionDenial = {
+    tool: string;
+    reason?: string | undefined;
+};
+/** Target of a message sent via an MCP tool during the agent run. */
+export type McpMessageTarget = {
+    /** MCP tool name (e.g., "message", "sessions_send", "telegram_send"). */
+    tool: string;
+    /** Channel provider (e.g., "telegram", "discord", "slack"). */
+    provider: string;
+    /** Account identifier within the provider. */
+    accountId?: string | undefined;
+    /** Target identifier (chat ID, channel ID, etc.). */
+    to?: string | undefined;
+};
+/** Structured heartbeat report from the heartbeat_report MCP tool. */
+export type McpHeartbeatReport = {
+    /** Whether any actions were performed during the heartbeat run. */
+    anythingDone: boolean;
+    /** Optional summary text. */
+    summary?: string | null;
+};
+/** Gateway-side MCP server tracking of side effects during agent execution. */
+export type McpSideEffects = {
+    /** Texts sent via MCP messaging tools. */
+    sentTexts: string[];
+    /** Media URLs sent via MCP messaging tools. */
+    sentMediaUrls: string[];
+    /** Targets of messages sent via MCP messaging tools. */
+    sentTargets: McpMessageTarget[];
+    /** Number of cron jobs added via MCP tools. */
+    cronAdds: number;
+    /** Heartbeat report from the heartbeat_report tool (if called). */
+    heartbeatReport?: McpHeartbeatReport | undefined;
+};
+/**
+ * The three-type delivery contract:
+ * `AgentRunResult` (CLI output) + `McpSideEffects` (gateway tracking) = `AgentDeliveryResult`.
+ *
+ * This is what the delivery pipeline consumers receive.
+ */
+export type AgentDeliveryResult = {
+    /** Reply payloads for delivery to the channel. */
+    payloads: ReplyPayload[];
+    /** CLI subprocess output summary. */
+    run: AgentRunResult;
+    /** Gateway-side MCP server side effects. */
+    mcp: McpSideEffects;
+    /** Top-level error message, if the run failed. */
+    error?: string | undefined;
+};
+/** Incoming message from a channel, normalized across providers. */
+export type ChannelMessage = {
+    /** Provider-assigned message identifier. */
+    id: string;
+    /** Message text body. */
+    text: string;
+    /** Sender identifier (provider-specific). */
+    from: string;
+    /** Channel or chat identifier. */
+    channelId: string;
+    /** Channel provider name (e.g., "telegram", "discord", "whatsapp"). */
+    provider: string;
+    /** Message timestamp (epoch milliseconds). */
+    timestamp: number;
+    /** ID of the message being replied to, if any. */
+    replyToId?: string | undefined;
+    /** Media URLs attached to the message. */
+    mediaUrls?: string[] | undefined;
+    /** Channel-specific formatting hints (e.g., LINE directives, Discord component schema). */
+    messageToolHints?: string[] | undefined;
+    /** Extra context to prepend between the system prompt and user text (e.g. per-channel instructions). */
+    extraContext?: string | undefined;
+    /** Thread history or thread-starter context (skipped on session resume). */
+    threadContext?: string | undefined;
+    /** Provider-specific metadata. */
+    metadata?: Record<string, unknown> | undefined;
+    /** Whether the message sender is the bot owner. Defaults to `false`. */
+    senderIsOwner?: boolean | undefined;
+    /** Tool profile controlling which tool categories are available. Defaults to `"full"`. */
+    toolProfile?: string | undefined;
+    /** Display name of the user sending the message. */
+    userName?: string | undefined;
+    /** Agent identifier within RemoteClaw. */
+    agentId?: string | undefined;
+    /** IANA timezone string (e.g., "America/New_York"). */
+    timezone?: string | undefined;
+    /** Phone numbers / IDs of authorized senders (owner allowlist). */
+    authorizedSenders?: string[] | undefined;
+    /** Reaction/emoji guidance level for the system prompt. */
+    reactionGuidance?: {
+        level: "minimal" | "extensive";
+        channel: string;
+    } | undefined;
+};
+/** Streaming callbacks used by ChannelBridge during agent execution. */
+export type BridgeCallbacks = {
+    /** Called when a partial (streaming) text chunk is available. */
+    onPartialReply?: ((payload: ReplyPayload) => Promise<void> | void) | undefined;
+    /** Called when a complete reply block is available. */
+    onBlockReply?: ((payload: ReplyPayload) => Promise<void> | void) | undefined;
+    /** Called when a tool result is available. */
+    onToolResult?: ((payload: ReplyPayload) => Promise<void> | void) | undefined;
+    /** Called when the agent emits thinking content. */
+    onThinking?: ((payload: {
+        text: string;
+    }) => void) | undefined;
+};

package/dist/plugin-sdk/pairing/pairing-labels.d.ts

@@ -0,0 +1,2 @@
+import type { PairingChannel } from "./pairing-store.js";
+export declare function resolvePairingIdLabel(channel: PairingChannel): string;

package/dist/plugin-sdk/pairing/pairing-messages.d.ts

@@ -0,0 +1,6 @@
+import type { PairingChannel } from "./pairing-store.js";
+export declare function buildPairingReply(params: {
+    channel: PairingChannel;
+    idLine: string;
+    code: string;
+}): string;

package/dist/plugin-sdk/pairing/pairing-store.d.ts

@@ -0,0 +1,48 @@
+import type { ChannelId, ChannelPairingAdapter } from "../channels/plugins/types.js";
+export type PairingChannel = ChannelId;
+export type PairingRequest = {
+    id: string;
+    code: string;
+    createdAt: string;
+    lastSeenAt: string;
+    meta?: Record<string, string>;
+};
+export declare function readChannelAllowFromStore(channel: PairingChannel, env?: NodeJS.ProcessEnv, accountId?: string): Promise<string[]>;
+export declare function readChannelAllowFromStoreSync(channel: PairingChannel, env?: NodeJS.ProcessEnv, accountId?: string): string[];
+type AllowFromStoreEntryUpdateParams = {
+    channel: PairingChannel;
+    entry: string | number;
+    accountId?: string;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function addChannelAllowFromStoreEntry(params: AllowFromStoreEntryUpdateParams): Promise<{
+    changed: boolean;
+    allowFrom: string[];
+}>;
+export declare function removeChannelAllowFromStoreEntry(params: AllowFromStoreEntryUpdateParams): Promise<{
+    changed: boolean;
+    allowFrom: string[];
+}>;
+export declare function listChannelPairingRequests(channel: PairingChannel, env?: NodeJS.ProcessEnv, accountId?: string): Promise<PairingRequest[]>;
+export declare function upsertChannelPairingRequest(params: {
+    channel: PairingChannel;
+    id: string | number;
+    accountId?: string;
+    meta?: Record<string, string | undefined | null>;
+    env?: NodeJS.ProcessEnv;
+    /** Extension channels can pass their adapter directly to bypass registry lookup. */
+    pairingAdapter?: ChannelPairingAdapter;
+}): Promise<{
+    code: string;
+    created: boolean;
+}>;
+export declare function approveChannelPairingCode(params: {
+    channel: PairingChannel;
+    code: string;
+    accountId?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<{
+    id: string;
+    entry?: PairingRequest;
+} | null>;
+export {};

package/dist/plugin-sdk/plugin-sdk/account-id.d.ts

@@ -0,0 +1 @@
+export { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "../routing/session-key.js";

package/dist/plugin-sdk/plugin-sdk/agent-media-payload.d.ts

@@ -0,0 +1,12 @@
+export type AgentMediaPayload = {
+    MediaPath?: string;
+    MediaType?: string;
+    MediaUrl?: string;
+    MediaPaths?: string[];
+    MediaUrls?: string[];
+    MediaTypes?: string[];
+};
+export declare function buildAgentMediaPayload(mediaList: Array<{
+    path: string;
+    contentType?: string | null;
+}>): AgentMediaPayload;

package/dist/plugin-sdk/plugin-sdk/allow-from.d.ts

@@ -0,0 +1,32 @@
+export declare function formatAllowFromLowercase(params: {
+    allowFrom: Array<string | number>;
+    stripPrefixRe?: RegExp;
+}): string[];
+export declare function isNormalizedSenderAllowed(params: {
+    senderId: string | number;
+    allowFrom: Array<string | number>;
+    stripPrefixRe?: RegExp;
+}): boolean;
+type ParsedChatAllowTarget = {
+    kind: "chat_id";
+    chatId: number;
+} | {
+    kind: "chat_guid";
+    chatGuid: string;
+} | {
+    kind: "chat_identifier";
+    chatIdentifier: string;
+} | {
+    kind: "handle";
+    handle: string;
+};
+export declare function isAllowedParsedChatSender<TParsed extends ParsedChatAllowTarget>(params: {
+    allowFrom: Array<string | number>;
+    sender: string;
+    chatId?: number | null;
+    chatGuid?: string | null;
+    chatIdentifier?: string | null;
+    normalizeSender: (sender: string) => string;
+    parseAllowTarget: (entry: string) => TParsed;
+}): boolean;
+export {};

package/dist/plugin-sdk/plugin-sdk/command-auth.d.ts

@@ -0,0 +1,25 @@
+import type { RemoteClawConfig } from "../config/config.js";
+export type ResolveSenderCommandAuthorizationParams = {
+    cfg: RemoteClawConfig;
+    rawBody: string;
+    isGroup: boolean;
+    dmPolicy: string;
+    configuredAllowFrom: string[];
+    senderId: string;
+    isSenderAllowed: (senderId: string, allowFrom: string[]) => boolean;
+    readAllowFromStore: () => Promise<string[]>;
+    shouldComputeCommandAuthorized: (rawBody: string, cfg: RemoteClawConfig) => boolean;
+    resolveCommandAuthorizedFromAuthorizers: (params: {
+        useAccessGroups: boolean;
+        authorizers: Array<{
+            configured: boolean;
+            allowed: boolean;
+        }>;
+    }) => boolean;
+};
+export declare function resolveSenderCommandAuthorization(params: ResolveSenderCommandAuthorizationParams): Promise<{
+    shouldComputeAuth: boolean;
+    effectiveAllowFrom: string[];
+    senderAllowedForCommands: boolean;
+    commandAuthorized: boolean | undefined;
+}>;

package/dist/plugin-sdk/plugin-sdk/config-paths.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteClawConfig } from "../config/config.js";
+export declare function resolveChannelAccountConfigBasePath(params: {
+    cfg: RemoteClawConfig;
+    channelKey: string;
+    accountId: string;
+}): string;

package/dist/plugin-sdk/plugin-sdk/file-lock.d.ts

@@ -0,0 +1,16 @@
+export type FileLockOptions = {
+    retries: {
+        retries: number;
+        factor: number;
+        minTimeout: number;
+        maxTimeout: number;
+        randomize?: boolean;
+    };
+    stale: number;
+};
+export type FileLockHandle = {
+    lockPath: string;
+    release: () => Promise<void>;
+};
+export declare function acquireFileLock(filePath: string, options: FileLockOptions): Promise<FileLockHandle>;
+export declare function withFileLock<T>(filePath: string, options: FileLockOptions, fn: () => Promise<T>): Promise<T>;

package/dist/plugin-sdk/plugin-sdk/group-access.d.ts

@@ -0,0 +1,16 @@
+import type { GroupPolicy } from "../config/types.base.js";
+export type SenderGroupAccessReason = "allowed" | "disabled" | "empty_allowlist" | "sender_not_allowlisted";
+export type SenderGroupAccessDecision = {
+    allowed: boolean;
+    groupPolicy: GroupPolicy;
+    providerMissingFallbackApplied: boolean;
+    reason: SenderGroupAccessReason;
+};
+export declare function evaluateSenderGroupAccess(params: {
+    providerConfigPresent: boolean;
+    configuredGroupPolicy?: GroupPolicy;
+    defaultGroupPolicy?: GroupPolicy;
+    groupAllowFrom: string[];
+    senderId: string;
+    isSenderAllowed: (senderId: string, allowFrom: string[]) => boolean;
+}): SenderGroupAccessDecision;

package/dist/plugin-sdk/plugin-sdk/index.d.ts

@@ -0,0 +1,166 @@
+export { createAccountListHelpers } from "../channels/plugins/account-helpers.js";
+export { CHANNEL_MESSAGE_ACTION_NAMES } from "../channels/plugins/message-action-names.js";
+export { BLUEBUBBLES_ACTIONS, BLUEBUBBLES_ACTION_NAMES, BLUEBUBBLES_GROUP_ACTIONS, } from "../channels/plugins/bluebubbles-actions.js";
+export type { ChannelAccountSnapshot, ChannelAccountState, ChannelAgentTool, ChannelAgentToolFactory, ChannelAuthAdapter, ChannelCapabilities, ChannelCommandAdapter, ChannelConfigAdapter, ChannelDirectoryAdapter, ChannelDirectoryEntry, ChannelDirectoryEntryKind, ChannelGatewayAdapter, ChannelGatewayContext, ChannelGroupAdapter, ChannelGroupContext, ChannelHeartbeatAdapter, ChannelHeartbeatDeps, ChannelId, ChannelLogSink, ChannelLoginWithQrStartResult, ChannelLoginWithQrWaitResult, ChannelLogoutContext, ChannelLogoutResult, ChannelMentionAdapter, ChannelMessageActionAdapter, ChannelMessageActionContext, ChannelMessageActionName, ChannelMessagingAdapter, ChannelMeta, ChannelOutboundAdapter, ChannelOutboundContext, ChannelOutboundTargetMode, ChannelPairingAdapter, ChannelPollContext, ChannelPollResult, ChannelResolveKind, ChannelResolveResult, ChannelResolverAdapter, ChannelSecurityAdapter, ChannelSecurityContext, ChannelSecurityDmPolicy, ChannelSetupAdapter, ChannelSetupInput, ChannelStatusAdapter, ChannelStatusIssue, ChannelStreamingAdapter, ChannelThreadingAdapter, ChannelThreadingContext, ChannelThreadingToolContext, ChannelToolSend, BaseProbeResult, BaseTokenResolution, } from "../channels/plugins/types.js";
+export type { ChannelConfigSchema, ChannelPlugin } from "../channels/plugins/types.plugin.js";
+export type { ThreadBindingManager, ThreadBindingRecord, ThreadBindingTargetKind, } from "../discord/monitor/thread-bindings.js";
+export { autoBindSpawnedDiscordSubagent, listThreadBindingsBySessionKey, unbindThreadBindingsBySessionKey, } from "../discord/monitor/thread-bindings.js";
+export type { AnyAgentTool, RemoteClawPluginApi, RemoteClawPluginService, RemoteClawPluginServiceContext, ProviderAuthContext, ProviderAuthResult, } from "../plugins/types.js";
+export type { GatewayRequestHandler, GatewayRequestHandlerOptions, RespondFn, } from "../gateway/server-methods/types.js";
+export type { PluginRuntime, RuntimeLogger } from "../plugins/runtime/types.js";
+export { normalizePluginHttpPath } from "../plugins/http-path.js";
+export { registerPluginHttpRoute } from "../plugins/http-registry.js";
+export { emptyPluginConfigSchema } from "../plugins/config-schema.js";
+export type { RemoteClawConfig } from "../config/config.js";
+/** @deprecated Use RemoteClawConfig instead */
+export type { RemoteClawConfig as ClawdbotConfig } from "../config/config.js";
+export { isDangerousNameMatchingEnabled } from "../config/dangerous-name-matching.js";
+export type { FileLockHandle, FileLockOptions } from "./file-lock.js";
+export { acquireFileLock, withFileLock } from "./file-lock.js";
+export { normalizeWebhookPath, resolveWebhookPath } from "./webhook-path.js";
+export { registerWebhookTarget, rejectNonPostWebhookRequest, resolveSingleWebhookTarget, resolveSingleWebhookTargetAsync, resolveWebhookTargets, } from "./webhook-targets.js";
+export type { WebhookTargetMatchResult } from "./webhook-targets.js";
+export type { AgentMediaPayload } from "./agent-media-payload.js";
+export { buildAgentMediaPayload } from "./agent-media-payload.js";
+export { buildBaseAccountStatusSnapshot, buildBaseChannelStatusSummary, buildTokenChannelStatusSummary, collectStatusIssuesFromLastError, createDefaultChannelRuntimeState, } from "./status-helpers.js";
+export type { ChannelDock } from "../channels/dock.js";
+export { getChatChannelMeta } from "../channels/registry.js";
+export type { BlockStreamingCoalesceConfig, DmPolicy, DmConfig, GroupPolicy, GroupToolPolicyConfig, GroupToolPolicyBySenderConfig, MarkdownConfig, MarkdownTableMode, GoogleChatAccountConfig, GoogleChatConfig, GoogleChatDmConfig, GoogleChatGroupConfig, GoogleChatActionConfig, MSTeamsChannelConfig, MSTeamsConfig, MSTeamsReplyStyle, MSTeamsTeamConfig, } from "../config/types.js";
+export { GROUP_POLICY_BLOCKED_LABEL, resetMissingProviderGroupPolicyFallbackWarningsForTesting, resolveAllowlistProviderRuntimeGroupPolicy, resolveDefaultGroupPolicy, resolveOpenProviderRuntimeGroupPolicy, resolveRuntimeGroupPolicy, type GroupPolicyDefaultsConfig, type RuntimeGroupPolicyResolution, type RuntimeGroupPolicyParams, type ResolveProviderRuntimeGroupPolicyParams, warnMissingProviderGroupPolicyFallbackOnce, } from "../config/runtime-group-policy.js";
+export { DiscordConfigSchema, GoogleChatConfigSchema, IMessageConfigSchema, MSTeamsConfigSchema, SignalConfigSchema, SlackConfigSchema, TelegramConfigSchema, } from "../config/zod-schema.providers-core.js";
+export { WhatsAppConfigSchema } from "../config/zod-schema.providers-whatsapp.js";
+export { BlockStreamingCoalesceSchema, DmConfigSchema, DmPolicySchema, GroupPolicySchema, MarkdownConfigSchema, MarkdownTableModeSchema, normalizeAllowFrom, ReplyRuntimeConfigSchemaShape, requireOpenAllowFrom, TtsAutoSchema, TtsConfigSchema, TtsModeSchema, TtsProviderSchema, } from "../config/zod-schema.core.js";
+export { ToolPolicySchema } from "../config/zod-schema.agent-runtime.js";
+export type { RuntimeEnv } from "../runtime.js";
+export type { WizardPrompter } from "../wizard/prompts.js";
+export { DEFAULT_ACCOUNT_ID, normalizeAccountId, resolveThreadSessionKeys, } from "../routing/session-key.js";
+export { formatAllowFromLowercase, isAllowedParsedChatSender, isNormalizedSenderAllowed, } from "./allow-from.js";
+export { evaluateSenderGroupAccess, type SenderGroupAccessDecision, type SenderGroupAccessReason, } from "./group-access.js";
+export { resolveSenderCommandAuthorization } from "./command-auth.js";
+export { handleSlackMessageAction } from "./slack-message-actions.js";
+export { extractToolSend } from "./tool-send.js";
+export { createNormalizedOutboundDeliverer, formatTextWithAttachmentLinks, normalizeOutboundReplyPayload, resolveOutboundMediaUrls, sendMediaWithLeadingCaption, } from "./reply-payload.js";
+export type { OutboundReplyPayload } from "./reply-payload.js";
+export { resolveChannelAccountConfigBasePath } from "./config-paths.js";
+export { buildMediaPayload } from "../channels/plugins/media-payload.js";
+export type { MediaPayload, MediaPayloadInput } from "../channels/plugins/media-payload.js";
+export { createLoggerBackedRuntime } from "./runtime.js";
+export { chunkTextForOutbound } from "./text-chunking.js";
+export { readJsonFileWithFallback, writeJsonFileAtomically } from "./json-store.js";
+export { buildRandomTempFilePath, withTempDownloadPath } from "./temp-path.js";
+export { resolvePreferredRemoteClawTmpDir } from "../infra/tmp-remoteclaw-dir.js";
+export { runPluginCommandWithTimeout, type PluginCommandRunOptions, type PluginCommandRunResult, } from "./run-command.js";
+export { resolveGatewayBindUrl } from "../shared/gateway-bind-url.js";
+export type { GatewayBindUrlResult } from "../shared/gateway-bind-url.js";
+export { resolveTailnetHostWithRunner } from "../shared/tailscale-status.js";
+export type { TailscaleStatusCommandResult, TailscaleStatusCommandRunner, } from "../shared/tailscale-status.js";
+export type { ChatType } from "../channels/chat-type.js";
+/** @deprecated Use ChatType instead */
+export type { RoutePeerKind } from "../routing/resolve-route.js";
+export { resolveAckReaction } from "../agents/identity.js";
+export type { AgentToolResult } from "../types/agent-types.js";
+export type { ReplyPayload } from "../auto-reply/types.js";
+export type { OutboundDeliveryResult } from "../infra/outbound/deliver.js";
+export type { ChunkMode } from "../auto-reply/chunk.js";
+export { SILENT_REPLY_TOKEN, isSilentReplyText } from "../auto-reply/tokens.js";
+export { formatInboundFromLabel } from "../auto-reply/envelope.js";
+export { approveDevicePairing, listDevicePairing, rejectDevicePairing, } from "../infra/device-pairing.js";
+export { createDedupeCache } from "../infra/dedupe.js";
+export type { DedupeCache } from "../infra/dedupe.js";
+export { createPersistentDedupe } from "./persistent-dedupe.js";
+export type { PersistentDedupe, PersistentDedupeCheckOptions, PersistentDedupeOptions, } from "./persistent-dedupe.js";
+export { formatErrorMessage } from "../infra/errors.js";
+export { DEFAULT_WEBHOOK_BODY_TIMEOUT_MS, DEFAULT_WEBHOOK_MAX_BODY_BYTES, RequestBodyLimitError, installRequestBodyLimitGuard, isRequestBodyLimitError, readJsonBodyWithLimit, readRequestBodyWithLimit, requestBodyErrorToText, } from "../infra/http-body.js";
+export { fetchWithSsrFGuard } from "../infra/net/fetch-guard.js";
+export { SsrFBlockedError, isBlockedHostname, isBlockedHostnameOrIp, isPrivateIpAddress, } from "../infra/net/ssrf.js";
+export type { LookupFn, SsrFPolicy } from "../infra/net/ssrf.js";
+export { rawDataToString } from "../infra/ws.js";
+export { isWSLSync, isWSL2Sync, isWSLEnv } from "../infra/wsl.js";
+export { isTruthyEnvValue } from "../infra/env.js";
+export { resolveChannelGroupPolicy, resolveToolsBySender } from "../config/group-policy.js";
+export { buildPendingHistoryContextFromMap, clearHistoryEntries, clearHistoryEntriesIfEnabled, DEFAULT_GROUP_HISTORY_LIMIT, evictOldHistoryKeys, recordPendingHistoryEntry, recordPendingHistoryEntryIfEnabled, } from "../auto-reply/reply/history.js";
+export type { HistoryEntry } from "../auto-reply/reply/history.js";
+export { mergeAllowlist, summarizeMapping } from "../channels/allowlists/resolve-utils.js";
+export { resolveMentionGating, resolveMentionGatingWithBypass, } from "../channels/mention-gating.js";
+export type { AckReactionGateParams, AckReactionScope, WhatsAppAckReactionMode, } from "../channels/ack-reactions.js";
+export { removeAckReactionAfterReply, shouldAckReaction, shouldAckReactionForWhatsApp, } from "../channels/ack-reactions.js";
+export { createTypingCallbacks } from "../channels/typing.js";
+export { createReplyPrefixContext, createReplyPrefixOptions } from "../channels/reply-prefix.js";
+export { logAckFailure, logInboundDrop, logTypingFailure } from "../channels/logging.js";
+export { resolveChannelMediaMaxBytes } from "../channels/plugins/media-limits.js";
+export type { NormalizedLocation } from "../channels/location.js";
+export { formatLocationText, toLocationContext } from "../channels/location.js";
+export { resolveControlCommandGate } from "../channels/command-gating.js";
+export { resolveBlueBubblesGroupRequireMention, resolveDiscordGroupRequireMention, resolveGoogleChatGroupRequireMention, resolveIMessageGroupRequireMention, resolveSlackGroupRequireMention, resolveTelegramGroupRequireMention, resolveWhatsAppGroupRequireMention, resolveBlueBubblesGroupToolPolicy, resolveDiscordGroupToolPolicy, resolveGoogleChatGroupToolPolicy, resolveIMessageGroupToolPolicy, resolveSlackGroupToolPolicy, resolveTelegramGroupToolPolicy, resolveWhatsAppGroupToolPolicy, } from "../channels/plugins/group-mentions.js";
+export { recordInboundSession } from "../channels/session.js";
+export { buildChannelKeyCandidates, normalizeChannelSlug, resolveChannelEntryMatch, resolveChannelEntryMatchWithFallback, resolveNestedAllowlistDecision, } from "../channels/plugins/channel-config.js";
+export { listDiscordDirectoryGroupsFromConfig, listDiscordDirectoryPeersFromConfig, listSlackDirectoryGroupsFromConfig, listSlackDirectoryPeersFromConfig, listTelegramDirectoryGroupsFromConfig, listTelegramDirectoryPeersFromConfig, listWhatsAppDirectoryGroupsFromConfig, listWhatsAppDirectoryPeersFromConfig, } from "../channels/plugins/directory-config.js";
+export type { AllowlistMatch } from "../channels/plugins/allowlist-match.js";
+export { formatAllowlistMatchMeta, resolveAllowlistMatchSimple, } from "../channels/plugins/allowlist-match.js";
+export { optionalStringEnum, stringEnum } from "../agents/schema/typebox.js";
+export type { PollInput } from "../polls.js";
+export { buildChannelConfigSchema } from "../channels/plugins/config-schema.js";
+export { deleteAccountFromConfigSection, setAccountEnabledInConfigSection, } from "../channels/plugins/config-helpers.js";
+export { applyAccountNameToChannelSection, migrateBaseNameToDefaultAccount, } from "../channels/plugins/setup-helpers.js";
+export { formatPairingApproveHint } from "../channels/plugins/helpers.js";
+export { PAIRING_APPROVED_MESSAGE } from "../channels/plugins/pairing-message.js";
+export type { ChannelOnboardingAdapter, ChannelOnboardingDmPolicy, } from "../channels/plugins/onboarding-types.js";
+export { addWildcardAllowFrom, mergeAllowFromEntries, promptAccountId, } from "../channels/plugins/onboarding/helpers.js";
+export { promptChannelAccessConfig } from "../channels/plugins/onboarding/channel-access.js";
+export { createActionGate, jsonResult, readNumberParam, readReactionParams, readStringParam, } from "../agents/tools/common.js";
+export { formatDocsLink } from "../terminal/links.js";
+export { resolveDmAllowState, resolveDmGroupAccessDecision, resolveEffectiveAllowFromLists, } from "../security/dm-policy-shared.js";
+export type { HookEntry } from "../hooks/types.js";
+export { clamp, escapeRegExp, normalizeE164, safeParseJson, sleep } from "../utils.js";
+export { stripAnsi } from "../terminal/ansi.js";
+export { missingTargetError } from "../infra/outbound/target-errors.js";
+export { registerLogTransport } from "../logging/logger.js";
+export type { LogTransport, LogTransportRecord } from "../logging/logger.js";
+export { emitDiagnosticEvent, isDiagnosticsEnabled, onDiagnosticEvent, } from "../infra/diagnostic-events.js";
+export type { DiagnosticEventPayload, DiagnosticHeartbeatEvent, DiagnosticLaneDequeueEvent, DiagnosticLaneEnqueueEvent, DiagnosticMessageProcessedEvent, DiagnosticMessageQueuedEvent, DiagnosticRunAttemptEvent, DiagnosticSessionState, DiagnosticSessionStateEvent, DiagnosticSessionStuckEvent, DiagnosticUsageEvent, DiagnosticWebhookErrorEvent, DiagnosticWebhookProcessedEvent, DiagnosticWebhookReceivedEvent, } from "../infra/diagnostic-events.js";
+export { detectMime, extensionForMime, getFileExtension } from "../media/mime.js";
+export { extractOriginalFilename } from "../media/store.js";
+export { listDiscordAccountIds, resolveDefaultDiscordAccountId, resolveDiscordAccount, type ResolvedDiscordAccount, } from "../discord/accounts.js";
+export { collectDiscordAuditChannelIds } from "../discord/audit.js";
+export { discordOnboardingAdapter } from "../channels/plugins/onboarding/discord.js";
+export { looksLikeDiscordTargetId, normalizeDiscordMessagingTarget, normalizeDiscordOutboundTarget, } from "../channels/plugins/normalize/discord.js";
+export { collectDiscordStatusIssues } from "../channels/plugins/status-issues/discord.js";
+export { listIMessageAccountIds, resolveDefaultIMessageAccountId, resolveIMessageAccount, type ResolvedIMessageAccount, } from "../imessage/accounts.js";
+export { imessageOnboardingAdapter } from "../channels/plugins/onboarding/imessage.js";
+export { looksLikeIMessageTargetId, normalizeIMessageMessagingTarget, } from "../channels/plugins/normalize/imessage.js";
+export { parseChatAllowTargetPrefixes, parseChatTargetPrefixesOrThrow, resolveServicePrefixedAllowTarget, resolveServicePrefixedTarget, } from "../imessage/target-parsing-helpers.js";
+export { listEnabledSlackAccounts, listSlackAccountIds, resolveDefaultSlackAccountId, resolveSlackAccount, resolveSlackReplyToMode, type ResolvedSlackAccount, } from "../slack/accounts.js";
+export { extractSlackToolSend, listSlackMessageActions } from "../slack/message-actions.js";
+export { slackOnboardingAdapter } from "../channels/plugins/onboarding/slack.js";
+export { looksLikeSlackTargetId, normalizeSlackMessagingTarget, } from "../channels/plugins/normalize/slack.js";
+export { buildSlackThreadingToolContext } from "../slack/threading-tool-context.js";
+export { listTelegramAccountIds, resolveDefaultTelegramAccountId, resolveTelegramAccount, type ResolvedTelegramAccount, } from "../telegram/accounts.js";
+export { telegramOnboardingAdapter } from "../channels/plugins/onboarding/telegram.js";
+export { looksLikeTelegramTargetId, normalizeTelegramMessagingTarget, } from "../channels/plugins/normalize/telegram.js";
+export { collectTelegramStatusIssues } from "../channels/plugins/status-issues/telegram.js";
+export { parseTelegramReplyToMessageId, parseTelegramThreadId, } from "../telegram/outbound-params.js";
+export { type TelegramProbe } from "../telegram/probe.js";
+export { listSignalAccountIds, resolveDefaultSignalAccountId, resolveSignalAccount, type ResolvedSignalAccount, } from "../signal/accounts.js";
+export { signalOnboardingAdapter } from "../channels/plugins/onboarding/signal.js";
+export { looksLikeSignalTargetId, normalizeSignalMessagingTarget, } from "../channels/plugins/normalize/signal.js";
+export { listWhatsAppAccountIds, resolveDefaultWhatsAppAccountId, resolveWhatsAppAccount, type ResolvedWhatsAppAccount, } from "../web/accounts.js";
+export { isWhatsAppGroupJid, normalizeWhatsAppTarget } from "../whatsapp/normalize.js";
+export { resolveWhatsAppOutboundTarget } from "../whatsapp/resolve-outbound-target.js";
+export { whatsappOnboardingAdapter } from "../channels/plugins/onboarding/whatsapp.js";
+export { resolveWhatsAppHeartbeatRecipients } from "../channels/plugins/whatsapp-heartbeat.js";
+export { looksLikeWhatsAppTargetId, normalizeWhatsAppAllowFromEntries, normalizeWhatsAppMessagingTarget, } from "../channels/plugins/normalize/whatsapp.js";
+export { resolveWhatsAppGroupIntroHint, resolveWhatsAppMentionStripPatterns, } from "../channels/plugins/whatsapp-shared.js";
+export { collectWhatsAppStatusIssues } from "../channels/plugins/status-issues/whatsapp.js";
+export { collectBlueBubblesStatusIssues } from "../channels/plugins/status-issues/bluebubbles.js";
+export { listLineAccountIds, normalizeAccountId as normalizeLineAccountId, resolveDefaultLineAccountId, resolveLineAccount, } from "../line/accounts.js";
+export { LineConfigSchema } from "../line/config-schema.js";
+export type { LineConfig, LineAccountConfig, ResolvedLineAccount, LineChannelData, } from "../line/types.js";
+export { createInfoCard, createListCard, createImageCard, createActionCard, createReceiptCard, type CardAction, type ListItem, } from "../line/flex-templates.js";
+export { processLineMessage, hasMarkdownToConvert, stripMarkdown, } from "../line/markdown-to-line.js";
+export type { ProcessedLineMessage } from "../line/markdown-to-line.js";
+export { loadWebMedia, type WebMediaResult } from "../web/media.js";
+export { redactSensitiveText } from "../logging/redact.js";
+export type { AudioTranscriptionRequest, AudioTranscriptionResult, SttProvider, } from "../stt/types.js";
+export type { TtsProviderImpl, TtsSynthesisRequest, TtsSynthesisResult } from "../tts/types.js";
+export { checkSttCredentials, checkTtsCredentials, validateVoiceCredentials, } from "../channels/voice-credentials.js";
+export type { VoiceCredentialReport, VoiceCredentialStatus, } from "../channels/voice-credentials.js";

package/dist/plugin-sdk/plugin-sdk/json-store.d.ts

@@ -0,0 +1,5 @@
+export declare function readJsonFileWithFallback<T>(filePath: string, fallback: T): Promise<{
+    value: T;
+    exists: boolean;
+}>;
+export declare function writeJsonFileAtomically(filePath: string, value: unknown): Promise<void>;

package/dist/plugin-sdk/plugin-sdk/onboarding.d.ts

@@ -0,0 +1,11 @@
+import type { RemoteClawConfig } from "../config/config.js";
+import type { WizardPrompter } from "../wizard/prompts.js";
+export type PromptAccountIdParams = {
+    cfg: RemoteClawConfig;
+    prompter: WizardPrompter;
+    label: string;
+    currentId?: string;
+    listAccountIds: (cfg: RemoteClawConfig) => string[];
+    defaultAccountId: string;
+};
+export declare function promptAccountId(params: PromptAccountIdParams): Promise<string>;

package/dist/plugin-sdk/plugin-sdk/persistent-dedupe.d.ts

@@ -0,0 +1,20 @@
+import type { FileLockOptions } from "./file-lock.js";
+export type PersistentDedupeOptions = {
+    ttlMs: number;
+    memoryMaxSize: number;
+    fileMaxEntries: number;
+    resolveFilePath: (namespace: string) => string;
+    lockOptions?: Partial<FileLockOptions>;
+    onDiskError?: (error: unknown) => void;
+};
+export type PersistentDedupeCheckOptions = {
+    namespace?: string;
+    now?: number;
+    onDiskError?: (error: unknown) => void;
+};
+export type PersistentDedupe = {
+    checkAndRecord: (key: string, options?: PersistentDedupeCheckOptions) => Promise<boolean>;
+    clearMemory: () => void;
+    memorySize: () => number;
+};
+export declare function createPersistentDedupe(options: PersistentDedupeOptions): PersistentDedupe;