remoteclaw 0.0.0 → 0.0.1

package/dist/plugin-sdk/config/types.agent-defaults.d.ts

@@ -0,0 +1,168 @@
+import type { ChannelId } from "../channels/plugins/types.js";
+import type { AgentSandboxConfig } from "./types.agents-shared.js";
+import type { BlockStreamingChunkConfig, BlockStreamingCoalesceConfig, HumanDelayConfig, TypingMode } from "./types.base.js";
+/**
+ * Per-model entry in the `agents.defaults.models` map.
+ * Kept as a named type for legacy config compat; model management
+ * infrastructure has been removed — CLIs own model selection.
+ */
+export type AgentModelEntryConfig = {
+    alias?: string;
+    params?: Record<string, unknown>;
+    streaming?: boolean;
+};
+export type AgentContextPruningConfig = {
+    mode?: "off" | "cache-ttl";
+    /** TTL to consider cache expired (duration string, default unit: minutes). */
+    ttl?: string;
+    keepLastAssistants?: number;
+    softTrimRatio?: number;
+    hardClearRatio?: number;
+    minPrunableToolChars?: number;
+    tools?: {
+        allow?: string[];
+        deny?: string[];
+    };
+    softTrim?: {
+        maxChars?: number;
+        headChars?: number;
+        tailChars?: number;
+    };
+    hardClear?: {
+        enabled?: boolean;
+        placeholder?: string;
+    };
+};
+export type AgentDefaultsConfig = {
+    /** Legacy image-model override (kept for config compat). */
+    imageModel?: unknown;
+    /** Legacy per-model settings map (kept for config compat). */
+    models?: Record<string, AgentModelEntryConfig>;
+    /** Agent working directory (preferred). Used as the default cwd for agent runs. */
+    workspace?: string;
+    /** Optional repository root for system prompt runtime line (overrides auto-detect). */
+    repoRoot?: string;
+    /** Optional IANA timezone for the user (used in system prompt; defaults to host timezone). */
+    userTimezone?: string;
+    /** Time format in system prompt: auto (OS preference), 12-hour, or 24-hour. */
+    timeFormat?: "auto" | "12" | "24";
+    /**
+     * Envelope timestamp timezone: "utc" (default), "local", "user", or an IANA timezone string.
+     */
+    envelopeTimezone?: string;
+    /**
+     * Include absolute timestamps in message envelopes ("on" | "off", default: "on").
+     */
+    envelopeTimestamp?: "on" | "off";
+    /**
+     * Include elapsed time in message envelopes ("on" | "off", default: "on").
+     */
+    envelopeElapsed?: "on" | "off";
+    /** Optional context window cap (used for runtime estimates + status %). */
+    contextTokens?: number;
+    /** Legacy CLI-backends config (kept for config compat). */
+    cliBackends?: unknown;
+    /** Opt-in: prune old tool results from the LLM context to reduce token usage. */
+    contextPruning?: AgentContextPruningConfig;
+    /** Default verbose level when no /verbose directive is present. */
+    verboseDefault?: "off" | "on" | "full";
+    /** Default block streaming level when no override is present. */
+    blockStreamingDefault?: "off" | "on";
+    /**
+     * Block streaming boundary:
+     * - "text_end": end of each assistant text content block (before tool calls)
+     * - "message_end": end of the whole assistant message (may include tool blocks)
+     */
+    blockStreamingBreak?: "text_end" | "message_end";
+    /** Soft block chunking for streamed replies (min/max chars, prefer paragraph/newline). */
+    blockStreamingChunk?: BlockStreamingChunkConfig;
+    /**
+     * Block reply coalescing (merge streamed chunks before send).
+     * idleMs: wait time before flushing when idle.
+     */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** Human-like delay between block replies. */
+    humanDelay?: HumanDelayConfig;
+    timeoutSeconds?: number;
+    /** Max inbound media size in MB for agent-visible attachments (text note or future image attach). */
+    mediaMaxMb?: number;
+    /**
+     * Max image side length (pixels) when sanitizing base64 image payloads in transcripts/tool results.
+     * Default: 1200.
+     */
+    imageMaxDimensionPx?: number;
+    typingIntervalSeconds?: number;
+    /** Typing indicator start mode (never|instant|thinking|message). */
+    typingMode?: TypingMode;
+    /** Periodic background heartbeat runs. */
+    heartbeat?: {
+        /** Heartbeat interval (duration string, default unit: minutes; default: 30m). */
+        every?: string;
+        /** Optional active-hours window (local time); heartbeats run only inside this window. */
+        activeHours?: {
+            /** Start time (24h, HH:MM). Inclusive. */
+            start?: string;
+            /** End time (24h, HH:MM). Exclusive. Use "24:00" for end-of-day. */
+            end?: string;
+            /** Timezone for the window ("user", "local", or IANA TZ id). Default: "user". */
+            timezone?: string;
+        };
+        /** Heartbeat model override (provider/model). */
+        model?: string;
+        /** Session key for heartbeat runs ("main" or explicit session key). */
+        session?: string;
+        /** Delivery target ("last", "none", or a channel id). */
+        target?: "last" | "none" | ChannelId;
+        /** Optional delivery override (E.164 for WhatsApp, chat id for Telegram). Supports :topic:NNN suffix for Telegram topics. */
+        to?: string;
+        /** Optional account id for multi-account channels. */
+        accountId?: string;
+        /** Override the heartbeat prompt body (default: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats."). */
+        prompt?: string;
+        /** Path to a file containing the heartbeat prompt (relative to workspace, read at runtime). prompt takes precedence if both set. */
+        file?: string;
+        /** Suppress tool error warning payloads during heartbeat runs. */
+        suppressToolErrorWarnings?: boolean;
+    };
+    /** Boot prompt configuration (runs on gateway startup). */
+    boot?: {
+        /** Inline boot prompt text. Takes precedence over `file` if both are set. */
+        prompt?: string;
+        /** Path to a boot prompt file (relative to workspace directory). */
+        file?: string;
+    };
+    /** Max concurrent agent runs across all conversations. Default: 1 (sequential). */
+    maxConcurrent?: number;
+    /** Sub-agent defaults (spawned via sessions_spawn). */
+    subagents?: {
+        /** Max concurrent sub-agent runs (global lane: "subagent"). Default: 1. */
+        maxConcurrent?: number;
+        /** Maximum depth allowed for sessions_spawn chains. Default behavior: 1 (no nested spawns). */
+        maxSpawnDepth?: number;
+        /** Maximum active children a single requester session may spawn. Default behavior: 5. */
+        maxChildrenPerAgent?: number;
+        /** Auto-archive sub-agent sessions after N minutes (default: 60). */
+        archiveAfterMinutes?: number;
+        /** Default run timeout in seconds for spawned sub-agents (0 = no timeout). */
+        runTimeoutSeconds?: number;
+        /** Gateway timeout in ms for sub-agent announce delivery calls (default: 60000). */
+        announceTimeoutMs?: number;
+    };
+    /** Glob patterns for files exposed via agents.files.list/get/set (default: []). */
+    editableFiles?: string[];
+    /** Optional sandbox settings for non-main sessions. */
+    sandbox?: AgentSandboxConfig;
+    /** Selected agent runtime (claude, gemini, codex, opencode). */
+    runtime?: "claude" | "gemini" | "codex" | "opencode";
+    /** Extra CLI arguments appended to every runtime invocation. */
+    runtimeArgs?: string[];
+    /** Extra environment variables injected into every runtime invocation. */
+    runtimeEnv?: Record<string, string>;
+    /**
+     * Default auth profile(s) for all agents. Per-agent `auth` overrides this.
+     * - `false` — skip auth profile injection (default)
+     * - `"provider:profile"` — single profile
+     * - `["provider:key1", "provider:key2"]` — round-robin rotation
+     */
+    auth?: false | string | string[];
+};

package/dist/plugin-sdk/config/types.agents-shared.d.ts

@@ -0,0 +1,43 @@
+type SandboxDockerSettings = {
+    image?: string;
+    network?: string;
+    networkMode?: string;
+    dns?: string[];
+    env?: Record<string, string>;
+    ports?: Array<string | number>;
+    binds?: string[];
+    memory?: string;
+    cpus?: number;
+};
+type SandboxBrowserSettings = {
+    enabled?: boolean;
+    image?: string;
+    ports?: Array<string | number>;
+};
+type SandboxPruneSettings = {
+    enabled?: boolean;
+    maxAge?: string;
+};
+export type AgentSandboxConfig = {
+    mode?: "off" | "non-main" | "all";
+    /** Agent workspace access inside the sandbox. */
+    workspaceAccess?: "none" | "ro" | "rw";
+    /**
+     * Session tools visibility for sandboxed sessions.
+     * - "spawned": only allow session tools to target sessions spawned from this session (default)
+     * - "all": allow session tools to target any session
+     */
+    sessionToolsVisibility?: "spawned" | "all";
+    /** Container/workspace scope for sandbox isolation. */
+    scope?: "session" | "agent" | "shared";
+    /** Legacy alias for scope ("session" when true, "shared" when false). */
+    perSession?: boolean;
+    workspaceRoot?: string;
+    /** Docker-specific sandbox settings. */
+    docker?: SandboxDockerSettings;
+    /** Optional sandboxed browser settings. */
+    browser?: SandboxBrowserSettings;
+    /** Auto-prune sandbox settings. */
+    prune?: SandboxPruneSettings;
+};
+export {};

package/dist/plugin-sdk/config/types.agents.d.ts

@@ -0,0 +1,66 @@
+import type { ChatType } from "../channels/chat-type.js";
+import type { AgentDefaultsConfig } from "./types.agent-defaults.js";
+import type { AgentSandboxConfig } from "./types.agents-shared.js";
+import type { HumanDelayConfig, IdentityConfig } from "./types.base.js";
+import type { GroupChatConfig } from "./types.messages.js";
+import type { AgentToolsConfig } from "./types.tools.js";
+export type AgentConfig = {
+    id: string;
+    default?: boolean;
+    name?: string;
+    workspace?: string;
+    agentDir?: string;
+    /** Human-like delay between block replies for this agent. */
+    humanDelay?: HumanDelayConfig;
+    /** Optional per-agent heartbeat overrides. */
+    heartbeat?: AgentDefaultsConfig["heartbeat"];
+    /** Optional per-agent boot prompt overrides. */
+    boot?: AgentDefaultsConfig["boot"];
+    identity?: IdentityConfig;
+    groupChat?: GroupChatConfig;
+    subagents?: {
+        /** Allow spawning sub-agents under other agent ids. Use "*" to allow any. */
+        allowAgents?: string[];
+    };
+    /** Optional per-agent sandbox overrides. */
+    sandbox?: AgentSandboxConfig;
+    /** Optional per-agent stream params (e.g. cacheRetention, temperature). */
+    params?: Record<string, unknown>;
+    /** Glob patterns for files exposed via agents.files.list/get/set. Per-agent overrides defaults. */
+    editableFiles?: string[];
+    tools?: AgentToolsConfig;
+    /**
+     * Auth profile(s) for credential injection.
+     * - `false` — skip auth profile injection (rely on CLI-native auth / runtimeEnv / process.env)
+     * - `"provider:profile"` — single profile, resolve key and inject as env var
+     * - `["provider:key1", "provider:key2"]` — round-robin rotation across invocations
+     * - `undefined` — inherit from `agents.defaults.auth`
+     */
+    auth?: false | string | string[];
+    /** Selected agent runtime (claude, gemini, codex, opencode). Overrides `agents.defaults.runtime`. */
+    runtime?: "claude" | "gemini" | "codex" | "opencode";
+    /** Extra CLI arguments appended to runtime invocation. Replaces `agents.defaults.runtimeArgs`. */
+    runtimeArgs?: string[];
+    /** Extra environment variables injected into runtime invocation. Replaces `agents.defaults.runtimeEnv`. */
+    runtimeEnv?: Record<string, string>;
+};
+export type AgentsConfig = {
+    defaults?: AgentDefaultsConfig;
+    list?: AgentConfig[];
+};
+export type AgentBinding = {
+    agentId: string;
+    comment?: string;
+    match: {
+        channel: string;
+        accountId?: string;
+        peer?: {
+            kind: ChatType;
+            id: string;
+        };
+        guildId?: string;
+        teamId?: string;
+        /** Discord role IDs used for role-based routing. */
+        roles?: string[];
+    };
+};

package/dist/plugin-sdk/config/types.approvals.d.ts

@@ -0,0 +1,26 @@
+export type ExecApprovalForwardingMode = "session" | "targets" | "both";
+export type ExecApprovalForwardTarget = {
+    /** Channel id (e.g. "discord", "slack", or plugin channel id). */
+    channel: string;
+    /** Destination id (channel id, user id, etc. depending on channel). */
+    to: string;
+    /** Optional account id for multi-account channels. */
+    accountId?: string;
+    /** Optional thread id to reply inside a thread. */
+    threadId?: string | number;
+};
+export type ExecApprovalForwardingConfig = {
+    /** Enable forwarding exec approvals to chat channels. Default: false. */
+    enabled?: boolean;
+    /** Delivery mode (session=origin chat, targets=config targets, both=both). Default: session. */
+    mode?: ExecApprovalForwardingMode;
+    /** Only forward approvals for these agent IDs. Omit = all agents. */
+    agentFilter?: string[];
+    /** Only forward approvals matching these session key patterns (substring or regex). */
+    sessionFilter?: string[];
+    /** Explicit delivery targets (used when mode includes targets). */
+    targets?: ExecApprovalForwardTarget[];
+};
+export type ApprovalsConfig = {
+    exec?: ExecApprovalForwardingConfig;
+};

package/dist/plugin-sdk/config/types.auth.d.ts

@@ -0,0 +1,28 @@
+export type AuthProfileConfig = {
+    provider: string;
+    /**
+     * Credential type expected in auth-profiles.json for this profile id.
+     * - api_key: static provider API key
+     * - oauth: refreshable OAuth credentials (access+refresh+expires)
+     * - token: static bearer-style token (optionally expiring; no refresh)
+     */
+    mode: "api_key" | "oauth" | "token";
+    email?: string;
+};
+export type AuthConfig = {
+    profiles?: Record<string, AuthProfileConfig>;
+    order?: Record<string, string[]>;
+    cooldowns?: {
+        /** Default billing backoff (hours). Default: 5. */
+        billingBackoffHours?: number;
+        /** Optional per-provider billing backoff (hours). */
+        billingBackoffHoursByProvider?: Record<string, number>;
+        /** Billing backoff cap (hours). Default: 24. */
+        billingMaxHours?: number;
+        /**
+         * Failure window for backoff counters (hours). If no failures occur within
+         * this window, counters reset. Default: 24.
+         */
+        failureWindowHours?: number;
+    };
+};

package/dist/plugin-sdk/config/types.base.d.ts

@@ -0,0 +1,202 @@
+import type { ChatType } from "../channels/chat-type.js";
+export type ReplyMode = "text" | "command";
+export type TypingMode = "never" | "instant" | "thinking" | "message";
+export type SessionScope = "per-sender" | "global";
+export type DmScope = "main" | "per-peer" | "per-channel-peer" | "per-account-channel-peer";
+export type ReplyToMode = "off" | "first" | "all";
+export type GroupPolicy = "open" | "disabled" | "allowlist";
+export type DmPolicy = "pairing" | "allowlist" | "open" | "disabled";
+export type OutboundRetryConfig = {
+    /** Max retry attempts for outbound requests (default: 3). */
+    attempts?: number;
+    /** Minimum retry delay in ms (default: 300-500ms depending on provider). */
+    minDelayMs?: number;
+    /** Maximum retry delay cap in ms (default: 30000). */
+    maxDelayMs?: number;
+    /** Jitter factor (0-1) applied to delays (default: 0.1). */
+    jitter?: number;
+};
+export type BlockStreamingCoalesceConfig = {
+    minChars?: number;
+    maxChars?: number;
+    idleMs?: number;
+};
+export type BlockStreamingChunkConfig = {
+    minChars?: number;
+    maxChars?: number;
+    breakPreference?: "paragraph" | "newline" | "sentence";
+};
+export type MarkdownTableMode = "off" | "bullets" | "code";
+export type MarkdownConfig = {
+    /** Table rendering mode (off|bullets|code). */
+    tables?: MarkdownTableMode;
+};
+export type HumanDelayConfig = {
+    /** Delay style for block replies (off|natural|custom). */
+    mode?: "off" | "natural" | "custom";
+    /** Minimum delay in milliseconds (default: 800). */
+    minMs?: number;
+    /** Maximum delay in milliseconds (default: 2500). */
+    maxMs?: number;
+};
+export type SessionSendPolicyAction = "allow" | "deny";
+export type SessionSendPolicyMatch = {
+    channel?: string;
+    chatType?: ChatType;
+    /**
+     * Session key prefix match.
+     * Note: some consumers match against a normalized key (for example, stripping `agent:<id>:`).
+     */
+    keyPrefix?: string;
+    /** Optional raw session-key prefix match for consumers that normalize session keys. */
+    rawKeyPrefix?: string;
+};
+export type SessionSendPolicyRule = {
+    action: SessionSendPolicyAction;
+    match?: SessionSendPolicyMatch;
+};
+export type SessionSendPolicyConfig = {
+    default?: SessionSendPolicyAction;
+    rules?: SessionSendPolicyRule[];
+};
+export type SessionResetMode = "daily" | "idle";
+export type SessionResetConfig = {
+    mode?: SessionResetMode;
+    /** Local hour (0-23) for the daily reset boundary. */
+    atHour?: number;
+    /** Sliding idle window (minutes). When set with daily mode, whichever expires first wins. */
+    idleMinutes?: number;
+};
+export type SessionResetByTypeConfig = {
+    direct?: SessionResetConfig;
+    /** @deprecated Use `direct` instead. Kept for backward compatibility. */
+    dm?: SessionResetConfig;
+    group?: SessionResetConfig;
+    thread?: SessionResetConfig;
+};
+export type SessionThreadBindingsConfig = {
+    /**
+     * Master switch for thread-bound session routing features.
+     * Channel/provider keys can override this default.
+     */
+    enabled?: boolean;
+    /**
+     * Auto-unfocus TTL for thread-bound sessions (hours).
+     * Set to 0 to disable. Default: 24.
+     */
+    ttlHours?: number;
+};
+export type SessionConfig = {
+    scope?: SessionScope;
+    /** DM session scoping (default: "main"). */
+    dmScope?: DmScope;
+    /** Map platform-prefixed identities (e.g. "telegram:123") to canonical DM peers. */
+    identityLinks?: Record<string, string[]>;
+    resetTriggers?: string[];
+    idleMinutes?: number;
+    reset?: SessionResetConfig;
+    resetByType?: SessionResetByTypeConfig;
+    /** Channel-specific reset overrides (e.g. { discord: { mode: "idle", idleMinutes: 10080 } }). */
+    resetByChannel?: Record<string, SessionResetConfig>;
+    store?: string;
+    typingIntervalSeconds?: number;
+    typingMode?: TypingMode;
+    mainKey?: string;
+    sendPolicy?: SessionSendPolicyConfig;
+    agentToAgent?: {
+        /** Max ping-pong turns between requester/target (0–5). Default: 5. */
+        maxPingPongTurns?: number;
+    };
+    /** Shared defaults for thread-bound session routing across channels/providers. */
+    threadBindings?: SessionThreadBindingsConfig;
+    /** Automatic session store maintenance (pruning, capping, file rotation). */
+    maintenance?: SessionMaintenanceConfig;
+};
+export type SessionMaintenanceMode = "enforce" | "warn";
+export type SessionMaintenanceConfig = {
+    /** Whether to enforce maintenance or warn only. Default: "warn". */
+    mode?: SessionMaintenanceMode;
+    /** Remove session entries older than this duration (e.g. "30d", "12h"). Default: "30d". */
+    pruneAfter?: string | number;
+    /** Deprecated. Use pruneAfter instead. */
+    pruneDays?: number;
+    /** Maximum number of session entries to keep. Default: 500. */
+    maxEntries?: number;
+    /** Rotate sessions.json when it exceeds this size (e.g. "10mb"). Default: 10mb. */
+    rotateBytes?: number | string;
+    /**
+     * Retention for archived reset transcripts (`*.reset.<timestamp>`).
+     * Set `false` to disable reset-archive cleanup. Default: same as `pruneAfter` (30d).
+     */
+    resetArchiveRetention?: string | number | false;
+    /**
+     * Optional per-agent sessions-directory disk budget (e.g. "500mb").
+     * When exceeded, warn (mode=warn) or enforce oldest-first cleanup (mode=enforce).
+     */
+    maxDiskBytes?: number | string;
+    /**
+     * Target size after disk-budget cleanup (high-water mark), e.g. "400mb".
+     * Default: 80% of maxDiskBytes.
+     */
+    highWaterBytes?: number | string;
+};
+export type LoggingConfig = {
+    level?: "silent" | "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+    file?: string;
+    /** Maximum size of a single log file in bytes before writes are suppressed. Default: 500 MB. */
+    maxFileBytes?: number;
+    consoleLevel?: "silent" | "fatal" | "error" | "warn" | "info" | "debug" | "trace";
+    consoleStyle?: "pretty" | "compact" | "json";
+    /** Redact sensitive tokens in tool summaries. Default: "tools". */
+    redactSensitive?: "off" | "tools";
+    /** Regex patterns used to redact sensitive tokens (defaults apply when unset). */
+    redactPatterns?: string[];
+};
+export type DiagnosticsOtelConfig = {
+    enabled?: boolean;
+    endpoint?: string;
+    protocol?: "http/protobuf" | "grpc";
+    headers?: Record<string, string>;
+    serviceName?: string;
+    traces?: boolean;
+    metrics?: boolean;
+    logs?: boolean;
+    /** Trace sample rate (0.0 - 1.0). */
+    sampleRate?: number;
+    /** Metric export interval (ms). */
+    flushIntervalMs?: number;
+};
+export type DiagnosticsCacheTraceConfig = {
+    enabled?: boolean;
+    filePath?: string;
+    includeMessages?: boolean;
+    includePrompt?: boolean;
+    includeSystem?: boolean;
+};
+export type DiagnosticsConfig = {
+    enabled?: boolean;
+    /** Optional ad-hoc diagnostics flags (e.g. "telegram.http"). */
+    flags?: string[];
+    otel?: DiagnosticsOtelConfig;
+    cacheTrace?: DiagnosticsCacheTraceConfig;
+};
+export type WebReconnectConfig = {
+    initialMs?: number;
+    maxMs?: number;
+    factor?: number;
+    jitter?: number;
+    maxAttempts?: number;
+};
+export type WebConfig = {
+    /** If false, do not start the WhatsApp web provider. Default: true. */
+    enabled?: boolean;
+    heartbeatSeconds?: number;
+    reconnect?: WebReconnectConfig;
+};
+export type IdentityConfig = {
+    name?: string;
+    theme?: string;
+    emoji?: string;
+    /** Avatar image: workspace-relative path, http(s) URL, or data URI. */
+    avatar?: string;
+};

package/dist/plugin-sdk/config/types.browser.d.ts

@@ -0,0 +1,65 @@
+export type BrowserProfileConfig = {
+    /** CDP port for this profile. Allocated once at creation, persisted permanently. */
+    cdpPort?: number;
+    /** CDP URL for this profile (use for remote Chrome). */
+    cdpUrl?: string;
+    /** Profile driver (default: remoteclaw). */
+    driver?: "remoteclaw" | "extension";
+    /** Profile color (hex). Auto-assigned at creation. */
+    color: string;
+};
+export type BrowserSnapshotDefaults = {
+    /** Default snapshot mode (applies when mode is not provided). */
+    mode?: "efficient";
+};
+export type BrowserSsrFPolicyConfig = {
+    /** Legacy alias for private-network access. Prefer dangerouslyAllowPrivateNetwork. */
+    allowPrivateNetwork?: boolean;
+    /** If true, permit browser navigation to private/internal networks. Default: true */
+    dangerouslyAllowPrivateNetwork?: boolean;
+    /**
+     * Explicitly allowed hostnames (exact-match), including blocked names like localhost.
+     * Example: ["localhost", "metadata.internal"]
+     */
+    allowedHostnames?: string[];
+    /**
+     * Hostname allowlist patterns for browser navigation.
+     * Supports exact hosts and "*.example.com" wildcard subdomains.
+     */
+    hostnameAllowlist?: string[];
+};
+export type BrowserConfig = {
+    enabled?: boolean;
+    /** If false, disable browser act:evaluate (arbitrary JS). Default: true */
+    evaluateEnabled?: boolean;
+    /** Base URL of the CDP endpoint (for remote browsers). Default: loopback CDP on the derived port. */
+    cdpUrl?: string;
+    /** Remote CDP HTTP timeout (ms). Default: 1500. */
+    remoteCdpTimeoutMs?: number;
+    /** Remote CDP WebSocket handshake timeout (ms). Default: max(remoteCdpTimeoutMs * 2, 2000). */
+    remoteCdpHandshakeTimeoutMs?: number;
+    /** Accent color for the remoteclaw browser profile (hex). Default: #FF4500 */
+    color?: string;
+    /** Override the browser executable path (all platforms). */
+    executablePath?: string;
+    /** Start Chrome headless (best-effort). Default: false */
+    headless?: boolean;
+    /** Pass --no-sandbox to Chrome (Linux containers). Default: false */
+    noSandbox?: boolean;
+    /** If true: never launch; only attach to an existing browser. Default: false */
+    attachOnly?: boolean;
+    /** Default profile to use when profile param is omitted. Default: "chrome" */
+    defaultProfile?: string;
+    /** Named browser profiles with explicit CDP ports or URLs. */
+    profiles?: Record<string, BrowserProfileConfig>;
+    /** Default snapshot options (applied by the browser tool/CLI when unset). */
+    snapshotDefaults?: BrowserSnapshotDefaults;
+    /** SSRF policy for browser navigation/open-tab operations. */
+    ssrfPolicy?: BrowserSsrFPolicyConfig;
+    /**
+     * Additional Chrome launch arguments.
+     * Useful for stealth flags, window size overrides, or custom user-agent strings.
+     * Example: ["--window-size=1920,1080", "--disable-infobars"]
+     */
+    extraArgs?: string[];
+};

package/dist/plugin-sdk/config/types.channel-messaging-common.d.ts

@@ -0,0 +1,44 @@
+import type { BlockStreamingCoalesceConfig, DmPolicy, GroupPolicy, MarkdownConfig } from "./types.base.js";
+import type { ChannelHeartbeatVisibilityConfig } from "./types.channels.js";
+import type { DmConfig } from "./types.messages.js";
+export type CommonChannelMessagingConfig = {
+    /** Optional display name for this account (used in CLI/UI lists). */
+    name?: string;
+    /** Optional provider capability tags used for agent/runtime guidance. */
+    capabilities?: string[];
+    /** Markdown formatting overrides (tables). */
+    markdown?: MarkdownConfig;
+    /** Allow channel-initiated config writes (default: true). */
+    configWrites?: boolean;
+    /** If false, do not start this account. Default: true. */
+    enabled?: boolean;
+    /** Direct message access policy (default: pairing). */
+    dmPolicy?: DmPolicy;
+    /** Optional allowlist for inbound DM senders. */
+    allowFrom?: Array<string | number>;
+    /** Default delivery target for CLI --deliver when no explicit --reply-to is provided. */
+    defaultTo?: string;
+    /** Optional allowlist for group/channel senders. */
+    groupAllowFrom?: Array<string | number>;
+    /** Group/channel message handling policy. */
+    groupPolicy?: GroupPolicy;
+    /** Max group/channel messages to keep as history context (0 disables). */
+    historyLimit?: number;
+    /** Max DM turns to keep as history context. */
+    dmHistoryLimit?: number;
+    /** Per-DM config overrides keyed by sender ID. */
+    dms?: Record<string, DmConfig>;
+    /** Outbound text chunk size (chars). */
+    textChunkLimit?: number;
+    /** Chunking mode: "length" (default) splits by size; "newline" splits on every newline. */
+    chunkMode?: "length" | "newline";
+    blockStreaming?: boolean;
+    /** Merge streamed block replies before sending. */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** Heartbeat visibility settings for this channel. */
+    heartbeat?: ChannelHeartbeatVisibilityConfig;
+    /** Outbound response prefix override for this channel/account. */
+    responsePrefix?: string;
+    /** Max outbound media size in MB. */
+    mediaMaxMb?: number;
+};