@elizaos/agent 0.25.8 → 2.0.0-alpha.83

package/packages/agent/src/config/types.gateway.d.ts

@@ -0,0 +1,216 @@
+export type GatewayBindMode = "auto" | "lan" | "loopback" | "custom" | "tailnet";
+export type GatewayTlsConfig = {
+    /** Enable TLS for the gateway server. */
+    enabled?: boolean;
+    /** Auto-generate a self-signed cert if cert/key are missing (default: true). */
+    autoGenerate?: boolean;
+    /** PEM certificate path for the gateway server. */
+    certPath?: string;
+    /** PEM private key path for the gateway server. */
+    keyPath?: string;
+    /** Optional PEM CA bundle for TLS clients (mTLS or custom roots). */
+    caPath?: string;
+};
+export type WideAreaDiscoveryConfig = {
+    enabled?: boolean;
+    /** Optional unicast DNS-SD domain (e.g. "eliza.internal"). */
+    domain?: string;
+};
+export type MdnsDiscoveryMode = "off" | "minimal" | "full";
+export type MdnsDiscoveryConfig = {
+    /**
+     * mDNS/Bonjour discovery broadcast mode (default: minimal).
+     * - off: disable mDNS entirely
+     * - minimal: omit cliPath/sshPort from TXT records
+     * - full: include cliPath/sshPort in TXT records
+     */
+    mode?: MdnsDiscoveryMode;
+};
+export type DiscoveryConfig = {
+    wideArea?: WideAreaDiscoveryConfig;
+    mdns?: MdnsDiscoveryConfig;
+};
+export type TalkConfig = {
+    /** Default ElevenLabs voice ID for Talk mode. */
+    voiceId?: string;
+    /** Optional voice name -> ElevenLabs voice ID map. */
+    voiceAliases?: Record<string, string>;
+    /** Default ElevenLabs model ID for Talk mode. */
+    modelId?: string;
+    /** Default ElevenLabs output format (e.g. mp3_44100_128). */
+    outputFormat?: string;
+    /** ElevenLabs API key (optional; falls back to ELEVENLABS_API_KEY). */
+    apiKey?: string;
+    /** Stop speaking when user starts talking (default: true). */
+    interruptOnSpeech?: boolean;
+};
+export type GatewayControlUiConfig = {
+    /** If false, the Gateway will not serve the Control UI (default /). */
+    enabled?: boolean;
+    /** Optional base path prefix for the Control UI (e.g. "/eliza"). */
+    basePath?: string;
+    /** Optional filesystem root for Control UI assets (defaults to dist/control-ui). */
+    root?: string;
+    /** Allowed browser origins for Control UI/WebChat websocket connections. */
+    allowedOrigins?: string[];
+    /** Allow token-only auth over insecure HTTP (default: false). */
+    allowInsecureAuth?: boolean;
+    /** DANGEROUS: Disable device identity checks for the Control UI (default: false). */
+    dangerouslyDisableDeviceAuth?: boolean;
+};
+export type GatewayAuthMode = "token" | "password";
+export type GatewayAuthConfig = {
+    /** Authentication mode for Gateway connections. Defaults to token when set. */
+    mode?: GatewayAuthMode;
+    /** Shared token for token mode (stored locally for CLI auth). */
+    token?: string;
+    /** Shared password for password mode (consider env instead). */
+    password?: string;
+    /** Allow Tailscale identity headers when serve mode is enabled. */
+    allowTailscale?: boolean;
+};
+export type GatewayTailscaleMode = "off" | "serve" | "funnel";
+export type GatewayTailscaleConfig = {
+    /** Tailscale exposure mode for the Gateway control UI. */
+    mode?: GatewayTailscaleMode;
+    /** Reset serve/funnel configuration on shutdown. */
+    resetOnExit?: boolean;
+};
+export type GatewayRemoteConfig = {
+    /** Remote Gateway WebSocket URL (ws:// or wss://). */
+    url?: string;
+    /** Transport for macOS remote connections (ssh tunnel or direct WS). */
+    transport?: "ssh" | "direct";
+    /** Token for remote auth (when the gateway requires token auth). */
+    token?: string;
+    /** Password for remote auth (when the gateway requires password auth). */
+    password?: string;
+    /** Expected TLS certificate fingerprint (sha256) for remote gateways. */
+    tlsFingerprint?: string;
+    /** SSH target for tunneling remote Gateway (user@host). */
+    sshTarget?: string;
+    /** SSH identity file path for tunneling remote Gateway. */
+    sshIdentity?: string;
+};
+export type GatewayReloadMode = "off" | "restart" | "hot" | "hybrid";
+export type GatewayReloadConfig = {
+    /** Reload strategy for config changes (default: hybrid). */
+    mode?: GatewayReloadMode;
+    /** Debounce window for config reloads (ms). Default: 300. */
+    debounceMs?: number;
+};
+export type GatewayHttpChatCompletionsConfig = {
+    /**
+     * If false, the Gateway will not serve `POST /v1/chat/completions`.
+     * Default: false when absent.
+     */
+    enabled?: boolean;
+};
+export type GatewayHttpResponsesConfig = {
+    /**
+     * If false, the Gateway will not serve `POST /v1/responses` (OpenResponses API).
+     * Default: false when absent.
+     */
+    enabled?: boolean;
+    /**
+     * Max request body size in bytes for `/v1/responses`.
+     * Default: 20MB.
+     */
+    maxBodyBytes?: number;
+    /** File inputs (input_file). */
+    files?: GatewayHttpResponsesFilesConfig;
+    /** Image inputs (input_image). */
+    images?: GatewayHttpResponsesImagesConfig;
+};
+export type GatewayHttpResponsesFilesConfig = {
+    /** Allow URL fetches for input_file. Default: true. */
+    allowUrl?: boolean;
+    /** Allowed MIME types (case-insensitive). */
+    allowedMimes?: string[];
+    /** Max bytes per file. Default: 5MB. */
+    maxBytes?: number;
+    /** Max decoded characters per file. Default: 200k. */
+    maxChars?: number;
+    /** Max redirects when fetching a URL. Default: 3. */
+    maxRedirects?: number;
+    /** Fetch timeout in ms. Default: 10s. */
+    timeoutMs?: number;
+    /** PDF handling (application/pdf). */
+    pdf?: GatewayHttpResponsesPdfConfig;
+};
+export type GatewayHttpResponsesPdfConfig = {
+    /** Max pages to parse/render. Default: 4. */
+    maxPages?: number;
+    /** Max pixels per rendered page. Default: 4M. */
+    maxPixels?: number;
+    /** Minimum extracted text length to skip rasterization. Default: 200 chars. */
+    minTextChars?: number;
+};
+export type GatewayHttpResponsesImagesConfig = {
+    /** Allow URL fetches for input_image. Default: true. */
+    allowUrl?: boolean;
+    /** Allowed MIME types (case-insensitive). */
+    allowedMimes?: string[];
+    /** Max bytes per image. Default: 10MB. */
+    maxBytes?: number;
+    /** Max redirects when fetching a URL. Default: 3. */
+    maxRedirects?: number;
+    /** Fetch timeout in ms. Default: 10s. */
+    timeoutMs?: number;
+};
+export type GatewayHttpEndpointsConfig = {
+    chatCompletions?: GatewayHttpChatCompletionsConfig;
+    responses?: GatewayHttpResponsesConfig;
+};
+export type GatewayHttpConfig = {
+    endpoints?: GatewayHttpEndpointsConfig;
+};
+export type GatewayNodesConfig = {
+    /** Browser routing policy for node-hosted browser proxies. */
+    browser?: {
+        /** Routing mode (default: auto). */
+        mode?: "auto" | "manual" | "off";
+        /** Pin to a specific node id/name (optional). */
+        node?: string;
+    };
+    /** Additional node.invoke commands to allow on the gateway. */
+    allowCommands?: string[];
+    /** Commands to deny even if they appear in the defaults or node claims. */
+    denyCommands?: string[];
+};
+export type GatewayConfig = {
+    /** Single multiplexed port for Gateway WS + HTTP (default: 18789). */
+    port?: number;
+    /**
+     * Explicit gateway mode. When set to "remote", local gateway start is disabled.
+     * When set to "local", the CLI may start the gateway locally.
+     */
+    mode?: "local" | "remote";
+    /**
+     * Bind address policy for the Gateway WebSocket + Control UI HTTP server.
+     * - auto: Loopback (127.0.0.1) if available, else 0.0.0.0 (fallback to all interfaces)
+     * - lan: 0.0.0.0 (all interfaces, no fallback)
+     * - loopback: 127.0.0.1 (local-only)
+     * - tailnet: Tailnet IPv4 if available (100.64.0.0/10), else loopback
+     * - custom: User-specified IP, fallback to 0.0.0.0 if unavailable (requires customBindHost)
+     * Default: loopback (127.0.0.1).
+     */
+    bind?: GatewayBindMode;
+    /** Custom IP address for bind="custom" mode. Fallback: 0.0.0.0. */
+    customBindHost?: string;
+    controlUi?: GatewayControlUiConfig;
+    auth?: GatewayAuthConfig;
+    tailscale?: GatewayTailscaleConfig;
+    remote?: GatewayRemoteConfig;
+    reload?: GatewayReloadConfig;
+    tls?: GatewayTlsConfig;
+    http?: GatewayHttpConfig;
+    nodes?: GatewayNodesConfig;
+    /**
+     * IPs of trusted reverse proxies (e.g. Traefik, nginx). When a connection
+     * arrives from one of these IPs, the Gateway trusts `x-forwarded-for` (or
+     * `x-real-ip`) to determine the client IP for local pairing and HTTP checks.
+     */
+    trustedProxies?: string[];
+};
+//# sourceMappingURL=types.gateway.d.ts.map

package/packages/agent/src/config/types.gateway.d.ts.map

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

package/packages/agent/src/config/types.gateway.js

@@ -0,0 +1 @@
+export {};

package/packages/agent/src/config/types.hooks.d.ts

@@ -0,0 +1,107 @@
+export type HookMappingMatch = {
+    path?: string;
+    source?: string;
+};
+export type HookMappingTransform = {
+    module: string;
+    export?: string;
+};
+export type HookMappingConfig = {
+    id?: string;
+    match?: HookMappingMatch;
+    action?: "wake" | "agent";
+    wakeMode?: "now" | "next-heartbeat";
+    name?: string;
+    sessionKey?: string;
+    messageTemplate?: string;
+    textTemplate?: string;
+    deliver?: boolean;
+    /** DANGEROUS: Disable external content safety wrapping for this hook. */
+    allowUnsafeExternalContent?: boolean;
+    channel?: "last" | "whatsapp" | "telegram" | "discord" | "googlechat" | "slack" | "signal" | "imessage" | "msteams";
+    to?: string;
+    /** Override model for this hook (provider/model or alias). */
+    model?: string;
+    thinking?: string;
+    timeoutSeconds?: number;
+    transform?: HookMappingTransform;
+};
+export type HooksGmailTailscaleMode = "off" | "serve" | "funnel";
+export type HooksGmailConfig = {
+    account?: string;
+    label?: string;
+    topic?: string;
+    subscription?: string;
+    pushToken?: string;
+    hookUrl?: string;
+    includeBody?: boolean;
+    maxBytes?: number;
+    renewEveryMinutes?: number;
+    /** DANGEROUS: Disable external content safety wrapping for Gmail hooks. */
+    allowUnsafeExternalContent?: boolean;
+    serve?: {
+        bind?: string;
+        port?: number;
+        path?: string;
+    };
+    tailscale?: {
+        mode?: HooksGmailTailscaleMode;
+        path?: string;
+        /** Optional tailscale serve/funnel target (port, host:port, or full URL). */
+        target?: string;
+    };
+    /** Optional model override for Gmail hook processing (provider/model or alias). */
+    model?: string;
+    /** Optional thinking level override for Gmail hook processing. */
+    thinking?: "off" | "minimal" | "low" | "medium" | "high";
+};
+export type InternalHookHandlerConfig = {
+    /** Event key to listen for (e.g., 'command:new', 'session:start') */
+    event: string;
+    /** Path to handler module (absolute or relative to cwd) */
+    module: string;
+    /** Export name from module (default: 'default') */
+    export?: string;
+};
+export type HookConfig = {
+    enabled?: boolean;
+    env?: Record<string, string>;
+    [key: string]: unknown;
+};
+export type HookInstallRecord = {
+    source: "npm" | "archive" | "path";
+    spec?: string;
+    sourcePath?: string;
+    installPath?: string;
+    version?: string;
+    installedAt?: string;
+    hooks?: string[];
+};
+export type InternalHooksConfig = {
+    /** Enable hooks system */
+    enabled?: boolean;
+    /** Legacy: List of internal hook handlers to register (still supported) */
+    handlers?: InternalHookHandlerConfig[];
+    /** Per-hook configuration overrides */
+    entries?: Record<string, HookConfig>;
+    /** Load configuration */
+    load?: {
+        /** Additional hook directories to scan */
+        extraDirs?: string[];
+    };
+    /** Install records for hook packs or hooks */
+    installs?: Record<string, HookInstallRecord>;
+};
+export type HooksConfig = {
+    enabled?: boolean;
+    path?: string;
+    token?: string;
+    maxBodyBytes?: number;
+    presets?: string[];
+    transformsDir?: string;
+    mappings?: HookMappingConfig[];
+    gmail?: HooksGmailConfig;
+    /** Internal agent event hooks */
+    internal?: InternalHooksConfig;
+};
+//# sourceMappingURL=types.hooks.d.ts.map

package/packages/agent/src/config/types.hooks.d.ts.map

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

package/packages/agent/src/config/types.hooks.js

@@ -0,0 +1 @@
+export {};

package/packages/agent/src/config/types.js

@@ -0,0 +1,7 @@
+export * from "./types.agent-defaults";
+export * from "./types.agents";
+export * from "./types.eliza";
+export * from "./types.gateway";
+export * from "./types.hooks";
+export * from "./types.messages";
+export * from "./types.tools";

package/packages/agent/src/config/types.messages.d.ts

@@ -0,0 +1,176 @@
+import type { GroupChatConfig, NativeCommandsSetting } from "@elizaos/core";
+export type QueueMode = "steer" | "followup" | "collect" | "steer-backlog" | "steer+backlog" | "queue" | "interrupt";
+export type QueueDropPolicy = "old" | "new" | "summarize";
+export type QueueModeByProvider = {
+    whatsapp?: QueueMode;
+    telegram?: QueueMode;
+    discord?: QueueMode;
+    googlechat?: QueueMode;
+    slack?: QueueMode;
+    signal?: QueueMode;
+    imessage?: QueueMode;
+    msteams?: QueueMode;
+    webchat?: QueueMode;
+};
+export type TtsProvider = "elevenlabs" | "openai" | "edge";
+export type TtsMode = "final" | "all";
+export type TtsAutoMode = "off" | "always" | "inbound" | "tagged";
+export type TtsModelOverrideConfig = {
+    /** Enable model-provided overrides for TTS. */
+    enabled?: boolean;
+    /** Allow model-provided TTS text blocks. */
+    allowText?: boolean;
+    /** Allow model-provided provider override. */
+    allowProvider?: boolean;
+    /** Allow model-provided voice/voiceId override. */
+    allowVoice?: boolean;
+    /** Allow model-provided modelId override. */
+    allowModelId?: boolean;
+    /** Allow model-provided voice settings override. */
+    allowVoiceSettings?: boolean;
+    /** Allow model-provided normalization or language overrides. */
+    allowNormalization?: boolean;
+    /** Allow model-provided seed override. */
+    allowSeed?: boolean;
+};
+export type TtsConfig = {
+    /** Auto-TTS mode (preferred). */
+    auto?: TtsAutoMode;
+    /** Legacy: enable auto-TTS when `auto` is not set. */
+    enabled?: boolean;
+    /** Apply TTS to final replies only or to all replies (tool/block/final). */
+    mode?: TtsMode;
+    /** Primary TTS provider (fallbacks are automatic). */
+    provider?: TtsProvider;
+    /** Optional model override for TTS auto-summary (provider/model or alias). */
+    summaryModel?: string;
+    /** Allow the model to override TTS parameters. */
+    modelOverrides?: TtsModelOverrideConfig;
+    /** ElevenLabs configuration. */
+    elevenlabs?: {
+        apiKey?: string;
+        baseUrl?: string;
+        voiceId?: string;
+        modelId?: string;
+        seed?: number;
+        applyTextNormalization?: "auto" | "on" | "off";
+        languageCode?: string;
+        voiceSettings?: {
+            stability?: number;
+            similarityBoost?: number;
+            style?: number;
+            useSpeakerBoost?: boolean;
+            speed?: number;
+        };
+    };
+    /** OpenAI configuration. */
+    openai?: {
+        apiKey?: string;
+        model?: string;
+        voice?: string;
+    };
+    /** Microsoft Edge (node-edge-tts) configuration. */
+    edge?: {
+        /** Explicitly allow Edge TTS usage (no API key required). */
+        enabled?: boolean;
+        voice?: string;
+        lang?: string;
+        outputFormat?: string;
+        pitch?: string;
+        rate?: string;
+        volume?: string;
+        saveSubtitles?: boolean;
+        proxy?: string;
+        timeoutMs?: number;
+    };
+    /** Optional path for local TTS user preferences JSON. */
+    prefsPath?: string;
+    /** Hard cap for text sent to TTS (chars). */
+    maxTextLength?: number;
+    /** API request timeout (ms). */
+    timeoutMs?: number;
+};
+export type QueueConfig = {
+    mode?: QueueMode;
+    byChannel?: QueueModeByProvider;
+    debounceMs?: number;
+    /** Per-channel debounce overrides (ms). */
+    debounceMsByChannel?: InboundDebounceByProvider;
+    cap?: number;
+    drop?: QueueDropPolicy;
+};
+export type InboundDebounceByProvider = Record<string, number>;
+export type InboundDebounceConfig = {
+    debounceMs?: number;
+    byChannel?: InboundDebounceByProvider;
+};
+export type BroadcastStrategy = "parallel" | "sequential";
+export type BroadcastConfig = {
+    /** Default processing strategy for broadcast peers. */
+    strategy?: BroadcastStrategy;
+    /**
+     * Map peer IDs to arrays of agent IDs that should ALL process messages.
+     *
+     * Note: the index signature includes `undefined` so `strategy?: ...` remains type-safe.
+     */
+    [peerId: string]: string[] | BroadcastStrategy | undefined;
+};
+export type MessagesConfig = {
+    /**
+     * Prefix auto-added to all outbound replies.
+     *
+     * - string: explicit prefix (may include template variables)
+     * - special value: `"auto"` derives `[{agents.list[].identity.name}]` for the routed agent (when set)
+     *
+     * Supported template variables (case-insensitive):
+     * - `{model}` - short model name (e.g., `claude-opus-4-5`, `gpt-5`)
+     * - `{modelFull}` - full model identifier (e.g., `anthropic/claude-opus-4-5`)
+     * - `{provider}` - provider name (e.g., `anthropic`, `openai`)
+     * - `{thinkingLevel}` or `{think}` - current thinking level (`high`, `low`, `off`)
+     * - `{identity.name}` or `{identityName}` - agent identity name
+     *
+     * Example: `"[{model} | think:{thinkingLevel}]"` → `"[claude-opus-4-5 | think:high]"`
+     *
+     * Unresolved variables remain as literal text (e.g., `{model}` if context unavailable).
+     *
+     * Default: none
+     */
+    responsePrefix?: string;
+    groupChat?: GroupChatConfig;
+    queue?: QueueConfig;
+    /** Debounce rapid inbound messages per sender (global + per-channel overrides). */
+    inbound?: InboundDebounceConfig;
+    /** Emoji reaction used to acknowledge inbound messages (empty disables). */
+    ackReaction?: string;
+    /** When to send ack reactions. Default: "group-mentions". */
+    ackReactionScope?: "group-mentions" | "group-all" | "direct" | "all";
+    /** Remove ack reaction after reply is sent (default: false). */
+    removeAckAfterReply?: boolean;
+    /** Text-to-speech settings for outbound replies. */
+    tts?: TtsConfig;
+};
+/** Audio configuration (placeholder for future audio-specific settings). */
+export type AudioConfig = {
+    [key: string]: unknown;
+};
+export type CommandsConfig = {
+    /** Enable native command registration when supported (default: "auto"). */
+    native?: NativeCommandsSetting;
+    /** Enable native skill command registration when supported (default: "auto"). */
+    nativeSkills?: NativeCommandsSetting;
+    /** Enable text command parsing (default: true). */
+    text?: boolean;
+    /** Allow bash chat command (`!`; `/bash` alias) (default: false). */
+    bash?: boolean;
+    /** How long bash waits before backgrounding (default: 2000; 0 backgrounds immediately). */
+    bashForegroundMs?: number;
+    /** Allow /config command (default: false). */
+    config?: boolean;
+    /** Allow /debug command (default: false). */
+    debug?: boolean;
+    /** Allow restart commands/tools (default: false). */
+    restart?: boolean;
+    /** Enforce access-group allowlists/policies for commands (default: true). */
+    useAccessGroups?: boolean;
+};
+//# sourceMappingURL=types.messages.d.ts.map

package/packages/agent/src/config/types.messages.d.ts.map

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

package/packages/agent/src/config/types.messages.js

@@ -0,0 +1 @@
+export {};