comisai 1.0.36 → 1.0.37

package/node_modules/@comis/core/dist/config/schema-integrations.d.ts

@@ -3,7 +3,6 @@ import { z } from "zod";
  * Brave Search integration configuration.
  */
 export declare const BraveSearchConfigSchema: z.ZodObject<{
-    /** Brave Search API key (optional — search disabled without it; string or SecretRef) */
     apiKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         source: z.ZodEnum<{
             file: "file";
@@ -13,104 +12,68 @@ export declare const BraveSearchConfigSchema: z.ZodObject<{
         provider: z.ZodString;
         id: z.ZodString;
     }, z.core.$strict>]>>;
-    /** Default number of results to return (default: 5) */
     maxResultsDefault: z.ZodDefault<z.ZodNumber>;
-    /** Cache TTL in milliseconds (default: 3600000 = 1 hour) */
     cacheTtlMs: z.ZodDefault<z.ZodNumber>;
-    /** Rate limit in requests per second (default: 1) */
     rateLimitRps: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * MCP (Model Context Protocol) server entry.
  */
 export declare const McpServerEntrySchema: z.ZodObject<{
-    /** Unique name for this MCP server */
     name: z.ZodString;
-    /** Transport type: "stdio" for local process, "sse" for legacy SSE servers, "http" for Streamable HTTP */
     transport: z.ZodEnum<{
         http: "http";
         stdio: "stdio";
         sse: "sse";
     }>;
-    /** Command to execute for stdio transport */
     command: z.ZodOptional<z.ZodString>;
-    /** Arguments for the stdio command */
     args: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** URL for remote transports (sse, http) */
     url: z.ZodOptional<z.ZodURL>;
-    /** Environment variables to pass to the stdio process (e.g. API keys) */
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Working directory for stdio transport. Overrides the default workspace CWD. */
     cwd: z.ZodOptional<z.ZodString>;
-    /** Whether this server is enabled (default: true) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Custom HTTP headers for remote transports (sse, http). Ignored for stdio. */
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    /** Maximum concurrent tool calls to this server. Undefined = auto (transport-based default). */
     maxConcurrency: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * MCP integration configuration.
  */
 export declare const McpConfigSchema: z.ZodObject<{
-    /** List of MCP servers to connect to */
     servers: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Unique name for this MCP server */
         name: z.ZodString;
-        /** Transport type: "stdio" for local process, "sse" for legacy SSE servers, "http" for Streamable HTTP */
         transport: z.ZodEnum<{
             http: "http";
             stdio: "stdio";
             sse: "sse";
         }>;
-        /** Command to execute for stdio transport */
         command: z.ZodOptional<z.ZodString>;
-        /** Arguments for the stdio command */
         args: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        /** URL for remote transports (sse, http) */
         url: z.ZodOptional<z.ZodURL>;
-        /** Environment variables to pass to the stdio process (e.g. API keys) */
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Working directory for stdio transport. Overrides the default workspace CWD. */
         cwd: z.ZodOptional<z.ZodString>;
-        /** Whether this server is enabled (default: true) */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Custom HTTP headers for remote transports (sse, http). Ignored for stdio. */
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        /** Maximum concurrent tool calls to this server. Undefined = auto (transport-based default). */
         maxConcurrency: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
-    /** Default timeout for MCP tool calls in milliseconds (default: 120000).
-     * Image generation and other slow tools may need 2+ minutes. */
     callToolTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Default max concurrent tool calls for stdio servers (default: 1). */
     stdioDefaultConcurrency: z.ZodDefault<z.ZodNumber>;
-    /** Default max concurrent tool calls for HTTP/SSE servers (default: 4). */
     httpDefaultConcurrency: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * Transcription service configuration.
  */
 export declare const TranscriptionConfigSchema: z.ZodObject<{
-    /** Primary STT provider (default: "openai") */
     provider: z.ZodDefault<z.ZodEnum<{
         openai: "openai";
         groq: "groq";
         deepgram: "deepgram";
     }>>;
-    /** Provider-specific model ID (e.g., "gpt-4o-mini-transcribe", "whisper-large-v3-turbo", "nova-3") */
     model: z.ZodOptional<z.ZodString>;
-    /** Maximum file size in megabytes (default: 25) */
     maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-    /** API request timeout in milliseconds (default: 60000) */
     timeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** BCP-47 language hint for transcription (e.g., "en", "es"). Auto-detect if omitted. */
     language: z.ZodOptional<z.ZodString>;
-    /** Auto-transcribe voice messages in the inbound pipeline (default: true) */
     autoTranscribe: z.ZodDefault<z.ZodBoolean>;
-    /** Enable preflight STT for mention detection in voice messages (default: true) */
     preflight: z.ZodDefault<z.ZodBoolean>;
-    /** Ordered fallback providers to try when primary fails (default: []) */
     fallbackProviders: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         openai: "openai";
         groq: "groq";
@@ -135,19 +98,12 @@ export declare const TtsAutoModeSchema: z.ZodDefault<z.ZodEnum<{
  * ElevenLabs-specific voice settings for fine-grained control.
  */
 export declare const ElevenLabsVoiceSettingsSchema: z.ZodObject<{
-    /** Voice stability (0-1, higher = more consistent) */
     stability: z.ZodOptional<z.ZodNumber>;
-    /** Similarity boost (0-1, higher = more similar to original voice) */
     similarityBoost: z.ZodOptional<z.ZodNumber>;
-    /** Style exaggeration (0-1) */
     style: z.ZodOptional<z.ZodNumber>;
-    /** Enable speaker boost for clarity */
     useSpeakerBoost: z.ZodOptional<z.ZodBoolean>;
-    /** Playback speed multiplier */
     speed: z.ZodOptional<z.ZodNumber>;
-    /** Random seed for reproducible output */
     seed: z.ZodOptional<z.ZodNumber>;
-    /** Text normalization mode */
     applyTextNormalization: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
         off: "off";
@@ -162,72 +118,46 @@ export declare const ElevenLabsVoiceSettingsSchema: z.ZodObject<{
  * actual codec (e.g., "opus" -> "opus" for OpenAI, "opus_48000_64" for ElevenLabs).
  */
 export declare const TtsOutputFormatSchema: z.ZodObject<{
-    /** Telegram: Opus for native voice notes */
     telegram: z.ZodDefault<z.ZodString>;
-    /** Discord: MP3 for broadest compatibility */
     discord: z.ZodDefault<z.ZodString>;
-    /** WhatsApp: MP3 default */
     whatsapp: z.ZodDefault<z.ZodString>;
-    /** Slack: MP3 default */
     slack: z.ZodDefault<z.ZodString>;
-    /** Default format for unknown channels */
     default: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
 /**
  * Text-to-speech service configuration.
  */
 export declare const TtsConfigSchema: z.ZodObject<{
-    /** TTS provider (default: "openai") */
     provider: z.ZodDefault<z.ZodEnum<{
         openai: "openai";
         elevenlabs: "elevenlabs";
         edge: "edge";
     }>>;
-    /** Voice identifier (default: "alloy") */
     voice: z.ZodDefault<z.ZodString>;
-    /** Output audio format (default: "opus") */
     format: z.ZodDefault<z.ZodString>;
-    /** Provider-specific model ID (e.g., "eleven_multilingual_v2" for ElevenLabs) */
     model: z.ZodOptional<z.ZodString>;
-    /** Auto mode — when to automatically synthesize speech */
     autoMode: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
         always: "always";
         off: "off";
         inbound: "inbound";
         tagged: "tagged";
     }>>>;
-    /** Maximum text length for TTS synthesis (default: 4096) */
     maxTextLength: z.ZodDefault<z.ZodNumber>;
-    /** Regex pattern to detect TTS-tagged responses (default matches [[tts]] or [[tts:...]]) */
     tagPattern: z.ZodDefault<z.ZodString>;
-    /** Per-channel output format overrides */
     outputFormats: z.ZodDefault<z.ZodObject<{
-        /** Telegram: Opus for native voice notes */
         telegram: z.ZodDefault<z.ZodString>;
-        /** Discord: MP3 for broadest compatibility */
         discord: z.ZodDefault<z.ZodString>;
-        /** WhatsApp: MP3 default */
         whatsapp: z.ZodDefault<z.ZodString>;
-        /** Slack: MP3 default */
         slack: z.ZodDefault<z.ZodString>;
-        /** Default format for unknown channels */
         default: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
-    /** ElevenLabs-specific voice settings */
     elevenlabsSettings: z.ZodOptional<z.ZodObject<{
-        /** Voice stability (0-1, higher = more consistent) */
         stability: z.ZodOptional<z.ZodNumber>;
-        /** Similarity boost (0-1, higher = more similar to original voice) */
         similarityBoost: z.ZodOptional<z.ZodNumber>;
-        /** Style exaggeration (0-1) */
         style: z.ZodOptional<z.ZodNumber>;
-        /** Enable speaker boost for clarity */
         useSpeakerBoost: z.ZodOptional<z.ZodBoolean>;
-        /** Playback speed multiplier */
         speed: z.ZodOptional<z.ZodNumber>;
-        /** Random seed for reproducible output */
         seed: z.ZodOptional<z.ZodNumber>;
-        /** Text normalization mode */
         applyTextNormalization: z.ZodDefault<z.ZodEnum<{
             auto: "auto";
             off: "off";
@@ -239,20 +169,15 @@ export declare const TtsConfigSchema: z.ZodObject<{
  * Image analysis service configuration.
  */
 export declare const ImageAnalysisConfigSchema: z.ZodObject<{
-    /** Maximum image file size in megabytes (default: 20) */
     maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * Vision scope rule: controls which channels/chats trigger vision analysis.
  */
 export declare const VisionScopeRuleSchema: z.ZodObject<{
-    /** Channel type to match (e.g. "telegram", "discord"). */
     channel: z.ZodOptional<z.ZodString>;
-    /** Chat type to match (e.g. "private", "group"). */
     chatType: z.ZodOptional<z.ZodString>;
-    /** Session key prefix to match via startsWith. */
     keyPrefix: z.ZodOptional<z.ZodString>;
-    /** Action to take when this rule matches. */
     action: z.ZodEnum<{
         allow: "allow";
         deny: "deny";
@@ -262,41 +187,27 @@ export declare const VisionScopeRuleSchema: z.ZodObject<{
  * Vision analysis configuration: multi-provider image/video analysis.
  */
 export declare const VisionConfigSchema: z.ZodObject<{
-    /** Enable vision analysis (default: true). */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Ordered list of vision providers to consider (default: all three). */
     providers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         openai: "openai";
         anthropic: "anthropic";
         google: "google";
     }>>>;
-    /** Preferred default provider (overrides auto-selection). */
     defaultProvider: z.ZodOptional<z.ZodString>;
-    /** Maximum base64-encoded size for video in bytes (default: 70MB). */
     videoMaxBase64Bytes: z.ZodDefault<z.ZodNumber>;
-    /** Maximum raw video file size in bytes (default: 50MB). */
     videoMaxRawBytes: z.ZodDefault<z.ZodNumber>;
-    /** Timeout in milliseconds for video description API calls (default: 120s). */
     videoTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters for video description output (default: 500). */
     videoMaxDescriptionChars: z.ZodDefault<z.ZodNumber>;
-    /** Maximum image file size in megabytes (default: 20). */
     imageMaxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-    /** Scope rules for vision analysis (first match wins). */
     scopeRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Channel type to match (e.g. "telegram", "discord"). */
         channel: z.ZodOptional<z.ZodString>;
-        /** Chat type to match (e.g. "private", "group"). */
         chatType: z.ZodOptional<z.ZodString>;
-        /** Session key prefix to match via startsWith. */
         keyPrefix: z.ZodOptional<z.ZodString>;
-        /** Action to take when this rule matches. */
         action: z.ZodEnum<{
             allow: "allow";
             deny: "deny";
         }>;
     }, z.core.$strict>>>;
-    /** Default action when no scope rule matches (default: "allow"). */
     defaultScopeAction: z.ZodDefault<z.ZodEnum<{
         allow: "allow";
         deny: "deny";
@@ -309,28 +220,19 @@ export declare const VisionConfigSchema: z.ZodObject<{
  * from inbound messages.
  */
 export declare const LinkUnderstandingConfigSchema: z.ZodObject<{
-    /** Enable automatic link understanding (default: true) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum number of links to process per message (default: 3) */
     maxLinks: z.ZodDefault<z.ZodNumber>;
-    /** Timeout for fetching each URL in milliseconds (default: 10000) */
     fetchTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters of extracted content per link (default: 5000) */
     maxContentChars: z.ZodDefault<z.ZodNumber>;
-    /** User-Agent string for outbound fetch requests */
     userAgentString: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
 /**
  * Media infrastructure configuration for fetch limits, concurrency, and temp file management.
  */
 export declare const MediaInfraConfigSchema: z.ZodObject<{
-    /** Max file size for remote media fetches in bytes (default: 25MB) */
     maxRemoteFetchBytes: z.ZodDefault<z.ZodNumber>;
-    /** Max concurrent media operations (default: 3) */
     concurrencyLimit: z.ZodDefault<z.ZodNumber>;
-    /** Temp file TTL in milliseconds (default: 30 min) */
     tempFileTtlMs: z.ZodDefault<z.ZodNumber>;
-    /** Cleanup interval in milliseconds (default: 5 min) */
     tempCleanupIntervalMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -348,23 +250,14 @@ export declare const DOCUMENT_MIME_WHITELIST: readonly ["text/plain", "text/csv"
  * All fields have sensible defaults so an empty object produces a valid configuration.
  */
 export declare const FileExtractionConfigSchema: z.ZodObject<{
-    /** Enable document extraction (default: true) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Allowed MIME types for extraction (default: DOCUMENT_MIME_WHITELIST) */
     allowedMimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Maximum file size in bytes (default: 10MB) */
     maxBytes: z.ZodDefault<z.ZodNumber>;
-    /** Maximum characters in extracted text (default: 200000) */
     maxChars: z.ZodDefault<z.ZodNumber>;
-    /** Maximum total characters across all attachments per message (default: 500000) */
     maxTotalChars: z.ZodDefault<z.ZodNumber>;
-    /** Maximum pages to extract from paginated documents (default: 20) */
     maxPages: z.ZodDefault<z.ZodNumber>;
-    /** Extraction timeout in milliseconds (default: 30000) */
     timeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Use OCR/image fallback for PDF pages with little text (default: false) */
     pdfImageFallback: z.ZodDefault<z.ZodBoolean>;
-    /** Minimum character threshold per page to trigger image fallback (default: 50, 0 = always fallback) */
     pdfImageFallbackThreshold: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -374,117 +267,77 @@ export declare const FileExtractionConfigSchema: z.ZodObject<{
  * to organized workspace subdirectories.
  */
 export declare const MediaPersistenceConfigSchema: z.ZodObject<{
-    /** Enable automatic media file persistence to workspace (default: true) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Soft limit for total workspace media storage in MB (default: 1024 = 1GB). Logs WARN when exceeded. */
     maxStorageMb: z.ZodDefault<z.ZodNumber>;
-    /** Maximum individual file size in bytes (default: 52428800 = 50MB) */
     maxFileBytes: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * Image generation service configuration.
  */
 export declare const ImageGenerationConfigSchema: z.ZodObject<{
-    /** Image generation provider (default: "fal") */
     provider: z.ZodDefault<z.ZodEnum<{
         openai: "openai";
         fal: "fal";
     }>>;
-    /** Provider-specific model ID (e.g., "fal-ai/flux/dev", "gpt-image-1") */
     model: z.ZodOptional<z.ZodString>;
-    /** Enable safety checker on generated images (default: true) */
     safetyChecker: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum image generations per hour per agent (default: 10) */
     maxPerHour: z.ZodDefault<z.ZodNumber>;
-    /** Default image size/dimensions (default: "1024x1024") */
     defaultSize: z.ZodDefault<z.ZodString>;
-    /** Generation timeout in milliseconds (default: 60000) */
     timeoutMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * Media processing configuration (transcription, TTS, image analysis, vision, link understanding, infrastructure, persistence).
  */
 export declare const MediaConfigSchema: z.ZodObject<{
-    /** Transcription (voice-to-text) settings */
     transcription: z.ZodDefault<z.ZodObject<{
-        /** Primary STT provider (default: "openai") */
         provider: z.ZodDefault<z.ZodEnum<{
             openai: "openai";
             groq: "groq";
             deepgram: "deepgram";
         }>>;
-        /** Provider-specific model ID (e.g., "gpt-4o-mini-transcribe", "whisper-large-v3-turbo", "nova-3") */
         model: z.ZodOptional<z.ZodString>;
-        /** Maximum file size in megabytes (default: 25) */
         maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-        /** API request timeout in milliseconds (default: 60000) */
         timeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** BCP-47 language hint for transcription (e.g., "en", "es"). Auto-detect if omitted. */
         language: z.ZodOptional<z.ZodString>;
-        /** Auto-transcribe voice messages in the inbound pipeline (default: true) */
         autoTranscribe: z.ZodDefault<z.ZodBoolean>;
-        /** Enable preflight STT for mention detection in voice messages (default: true) */
         preflight: z.ZodDefault<z.ZodBoolean>;
-        /** Ordered fallback providers to try when primary fails (default: []) */
         fallbackProviders: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             openai: "openai";
             groq: "groq";
             deepgram: "deepgram";
         }>>>;
     }, z.core.$strict>>;
-    /** Text-to-speech settings */
     tts: z.ZodDefault<z.ZodObject<{
-        /** TTS provider (default: "openai") */
         provider: z.ZodDefault<z.ZodEnum<{
             openai: "openai";
             elevenlabs: "elevenlabs";
             edge: "edge";
         }>>;
-        /** Voice identifier (default: "alloy") */
         voice: z.ZodDefault<z.ZodString>;
-        /** Output audio format (default: "opus") */
         format: z.ZodDefault<z.ZodString>;
-        /** Provider-specific model ID (e.g., "eleven_multilingual_v2" for ElevenLabs) */
         model: z.ZodOptional<z.ZodString>;
-        /** Auto mode — when to automatically synthesize speech */
         autoMode: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
             always: "always";
             off: "off";
             inbound: "inbound";
             tagged: "tagged";
         }>>>;
-        /** Maximum text length for TTS synthesis (default: 4096) */
         maxTextLength: z.ZodDefault<z.ZodNumber>;
-        /** Regex pattern to detect TTS-tagged responses (default matches [[tts]] or [[tts:...]]) */
         tagPattern: z.ZodDefault<z.ZodString>;
-        /** Per-channel output format overrides */
         outputFormats: z.ZodDefault<z.ZodObject<{
-            /** Telegram: Opus for native voice notes */
             telegram: z.ZodDefault<z.ZodString>;
-            /** Discord: MP3 for broadest compatibility */
             discord: z.ZodDefault<z.ZodString>;
-            /** WhatsApp: MP3 default */
             whatsapp: z.ZodDefault<z.ZodString>;
-            /** Slack: MP3 default */
             slack: z.ZodDefault<z.ZodString>;
-            /** Default format for unknown channels */
             default: z.ZodDefault<z.ZodString>;
         }, z.core.$strict>>;
-        /** ElevenLabs-specific voice settings */
         elevenlabsSettings: z.ZodOptional<z.ZodObject<{
-            /** Voice stability (0-1, higher = more consistent) */
             stability: z.ZodOptional<z.ZodNumber>;
-            /** Similarity boost (0-1, higher = more similar to original voice) */
             similarityBoost: z.ZodOptional<z.ZodNumber>;
-            /** Style exaggeration (0-1) */
             style: z.ZodOptional<z.ZodNumber>;
-            /** Enable speaker boost for clarity */
             useSpeakerBoost: z.ZodOptional<z.ZodBoolean>;
-            /** Playback speed multiplier */
             speed: z.ZodOptional<z.ZodNumber>;
-            /** Random seed for reproducible output */
             seed: z.ZodOptional<z.ZodNumber>;
-            /** Text normalization mode */
             applyTextNormalization: z.ZodDefault<z.ZodEnum<{
                 auto: "auto";
                 off: "off";
@@ -492,123 +345,74 @@ export declare const MediaConfigSchema: z.ZodObject<{
             }>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Image analysis settings */
     imageAnalysis: z.ZodDefault<z.ZodObject<{
-        /** Maximum image file size in megabytes (default: 20) */
         maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Multi-provider vision analysis settings */
     vision: z.ZodDefault<z.ZodObject<{
-        /** Enable vision analysis (default: true). */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Ordered list of vision providers to consider (default: all three). */
         providers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
             openai: "openai";
             anthropic: "anthropic";
             google: "google";
         }>>>;
-        /** Preferred default provider (overrides auto-selection). */
         defaultProvider: z.ZodOptional<z.ZodString>;
-        /** Maximum base64-encoded size for video in bytes (default: 70MB). */
         videoMaxBase64Bytes: z.ZodDefault<z.ZodNumber>;
-        /** Maximum raw video file size in bytes (default: 50MB). */
         videoMaxRawBytes: z.ZodDefault<z.ZodNumber>;
-        /** Timeout in milliseconds for video description API calls (default: 120s). */
         videoTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters for video description output (default: 500). */
         videoMaxDescriptionChars: z.ZodDefault<z.ZodNumber>;
-        /** Maximum image file size in megabytes (default: 20). */
         imageMaxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-        /** Scope rules for vision analysis (first match wins). */
         scopeRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Channel type to match (e.g. "telegram", "discord"). */
             channel: z.ZodOptional<z.ZodString>;
-            /** Chat type to match (e.g. "private", "group"). */
             chatType: z.ZodOptional<z.ZodString>;
-            /** Session key prefix to match via startsWith. */
             keyPrefix: z.ZodOptional<z.ZodString>;
-            /** Action to take when this rule matches. */
             action: z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
             }>;
         }, z.core.$strict>>>;
-        /** Default action when no scope rule matches (default: "allow"). */
         defaultScopeAction: z.ZodDefault<z.ZodEnum<{
             allow: "allow";
             deny: "deny";
         }>>;
     }, z.core.$strict>>;
-    /** Link understanding settings */
     linkUnderstanding: z.ZodDefault<z.ZodObject<{
-        /** Enable automatic link understanding (default: true) */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum number of links to process per message (default: 3) */
         maxLinks: z.ZodDefault<z.ZodNumber>;
-        /** Timeout for fetching each URL in milliseconds (default: 10000) */
         fetchTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters of extracted content per link (default: 5000) */
         maxContentChars: z.ZodDefault<z.ZodNumber>;
-        /** User-Agent string for outbound fetch requests */
         userAgentString: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
-    /** Infrastructure settings (fetch limits, concurrency, temp files) */
     infrastructure: z.ZodDefault<z.ZodObject<{
-        /** Max file size for remote media fetches in bytes (default: 25MB) */
         maxRemoteFetchBytes: z.ZodDefault<z.ZodNumber>;
-        /** Max concurrent media operations (default: 3) */
         concurrencyLimit: z.ZodDefault<z.ZodNumber>;
-        /** Temp file TTL in milliseconds (default: 30 min) */
         tempFileTtlMs: z.ZodDefault<z.ZodNumber>;
-        /** Cleanup interval in milliseconds (default: 5 min) */
         tempCleanupIntervalMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Document extraction settings */
     documentExtraction: z.ZodDefault<z.ZodObject<{
-        /** Enable document extraction (default: true) */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Allowed MIME types for extraction (default: DOCUMENT_MIME_WHITELIST) */
         allowedMimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Maximum file size in bytes (default: 10MB) */
         maxBytes: z.ZodDefault<z.ZodNumber>;
-        /** Maximum characters in extracted text (default: 200000) */
         maxChars: z.ZodDefault<z.ZodNumber>;
-        /** Maximum total characters across all attachments per message (default: 500000) */
         maxTotalChars: z.ZodDefault<z.ZodNumber>;
-        /** Maximum pages to extract from paginated documents (default: 20) */
         maxPages: z.ZodDefault<z.ZodNumber>;
-        /** Extraction timeout in milliseconds (default: 30000) */
         timeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Use OCR/image fallback for PDF pages with little text (default: false) */
         pdfImageFallback: z.ZodDefault<z.ZodBoolean>;
-        /** Minimum character threshold per page to trigger image fallback (default: 50, 0 = always fallback) */
         pdfImageFallbackThreshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Media file persistence settings */
     persistence: z.ZodDefault<z.ZodObject<{
-        /** Enable automatic media file persistence to workspace (default: true) */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Soft limit for total workspace media storage in MB (default: 1024 = 1GB). Logs WARN when exceeded. */
         maxStorageMb: z.ZodDefault<z.ZodNumber>;
-        /** Maximum individual file size in bytes (default: 52428800 = 50MB) */
         maxFileBytes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Image generation settings */
     imageGeneration: z.ZodDefault<z.ZodObject<{
-        /** Image generation provider (default: "fal") */
         provider: z.ZodDefault<z.ZodEnum<{
             openai: "openai";
             fal: "fal";
         }>>;
-        /** Provider-specific model ID (e.g., "fal-ai/flux/dev", "gpt-image-1") */
         model: z.ZodOptional<z.ZodString>;
-        /** Enable safety checker on generated images (default: true) */
         safetyChecker: z.ZodDefault<z.ZodBoolean>;
-        /** Maximum image generations per hour per agent (default: 10) */
         maxPerHour: z.ZodDefault<z.ZodNumber>;
-        /** Default image size/dimensions (default: "1024x1024") */
         defaultSize: z.ZodDefault<z.ZodString>;
-        /** Generation timeout in milliseconds (default: 60000) */
         timeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -616,34 +420,22 @@ export declare const MediaConfigSchema: z.ZodObject<{
  * Auto-reply rule entry.
  */
 export declare const AutoReplyRuleSchema: z.ZodObject<{
-    /** Unique identifier for this rule */
     id: z.ZodString;
-    /** Regex pattern to match incoming messages */
     pattern: z.ZodString;
-    /** Response template (supports {{match}} placeholders) */
     template: z.ZodString;
-    /** Optional channel filter (rule applies only to listed channels) */
     channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** Priority for rule ordering (higher = first, default: 0) */
     priority: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 /**
  * Auto-reply configuration.
  */
 export declare const AutoReplyConfigSchema: z.ZodObject<{
-    /** Enable auto-reply rules (default: false) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** List of auto-reply rules */
     rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Unique identifier for this rule */
         id: z.ZodString;
-        /** Regex pattern to match incoming messages */
         pattern: z.ZodString;
-        /** Response template (supports {{match}} placeholders) */
         template: z.ZodString;
-        /** Optional channel filter (rule applies only to listed channels) */
         channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        /** Priority for rule ordering (higher = first, default: 0) */
         priority: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;
@@ -654,9 +446,7 @@ export declare const AutoReplyConfigSchema: z.ZodObject<{
  * media processing (transcription, TTS, image analysis), and auto-reply rules.
  */
 export declare const IntegrationsConfigSchema: z.ZodObject<{
-    /** Brave Search API integration */
     braveSearch: z.ZodDefault<z.ZodObject<{
-        /** Brave Search API key (optional — search disabled without it; string or SecretRef) */
         apiKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             source: z.ZodEnum<{
                 file: "file";
@@ -666,132 +456,81 @@ export declare const IntegrationsConfigSchema: z.ZodObject<{
             provider: z.ZodString;
             id: z.ZodString;
         }, z.core.$strict>]>>;
-        /** Default number of results to return (default: 5) */
         maxResultsDefault: z.ZodDefault<z.ZodNumber>;
-        /** Cache TTL in milliseconds (default: 3600000 = 1 hour) */
         cacheTtlMs: z.ZodDefault<z.ZodNumber>;
-        /** Rate limit in requests per second (default: 1) */
         rateLimitRps: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** MCP (Model Context Protocol) server connections */
     mcp: z.ZodDefault<z.ZodObject<{
-        /** List of MCP servers to connect to */
         servers: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Unique name for this MCP server */
             name: z.ZodString;
-            /** Transport type: "stdio" for local process, "sse" for legacy SSE servers, "http" for Streamable HTTP */
             transport: z.ZodEnum<{
                 http: "http";
                 stdio: "stdio";
                 sse: "sse";
             }>;
-            /** Command to execute for stdio transport */
             command: z.ZodOptional<z.ZodString>;
-            /** Arguments for the stdio command */
             args: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            /** URL for remote transports (sse, http) */
             url: z.ZodOptional<z.ZodURL>;
-            /** Environment variables to pass to the stdio process (e.g. API keys) */
             env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            /** Working directory for stdio transport. Overrides the default workspace CWD. */
             cwd: z.ZodOptional<z.ZodString>;
-            /** Whether this server is enabled (default: true) */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Custom HTTP headers for remote transports (sse, http). Ignored for stdio. */
             headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            /** Maximum concurrent tool calls to this server. Undefined = auto (transport-based default). */
             maxConcurrency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
-        /** Default timeout for MCP tool calls in milliseconds (default: 120000).
-         * Image generation and other slow tools may need 2+ minutes. */
         callToolTimeoutMs: z.ZodDefault<z.ZodNumber>;
-        /** Default max concurrent tool calls for stdio servers (default: 1). */
         stdioDefaultConcurrency: z.ZodDefault<z.ZodNumber>;
-        /** Default max concurrent tool calls for HTTP/SSE servers (default: 4). */
         httpDefaultConcurrency: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Media processing services */
     media: z.ZodDefault<z.ZodObject<{
-        /** Transcription (voice-to-text) settings */
         transcription: z.ZodDefault<z.ZodObject<{
-            /** Primary STT provider (default: "openai") */
             provider: z.ZodDefault<z.ZodEnum<{
                 openai: "openai";
                 groq: "groq";
                 deepgram: "deepgram";
             }>>;
-            /** Provider-specific model ID (e.g., "gpt-4o-mini-transcribe", "whisper-large-v3-turbo", "nova-3") */
             model: z.ZodOptional<z.ZodString>;
-            /** Maximum file size in megabytes (default: 25) */
             maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-            /** API request timeout in milliseconds (default: 60000) */
             timeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** BCP-47 language hint for transcription (e.g., "en", "es"). Auto-detect if omitted. */
             language: z.ZodOptional<z.ZodString>;
-            /** Auto-transcribe voice messages in the inbound pipeline (default: true) */
             autoTranscribe: z.ZodDefault<z.ZodBoolean>;
-            /** Enable preflight STT for mention detection in voice messages (default: true) */
             preflight: z.ZodDefault<z.ZodBoolean>;
-            /** Ordered fallback providers to try when primary fails (default: []) */
             fallbackProviders: z.ZodDefault<z.ZodArray<z.ZodEnum<{
                 openai: "openai";
                 groq: "groq";
                 deepgram: "deepgram";
             }>>>;
         }, z.core.$strict>>;
-        /** Text-to-speech settings */
         tts: z.ZodDefault<z.ZodObject<{
-            /** TTS provider (default: "openai") */
             provider: z.ZodDefault<z.ZodEnum<{
                 openai: "openai";
                 elevenlabs: "elevenlabs";
                 edge: "edge";
             }>>;
-            /** Voice identifier (default: "alloy") */
             voice: z.ZodDefault<z.ZodString>;
-            /** Output audio format (default: "opus") */
             format: z.ZodDefault<z.ZodString>;
-            /** Provider-specific model ID (e.g., "eleven_multilingual_v2" for ElevenLabs) */
             model: z.ZodOptional<z.ZodString>;
-            /** Auto mode — when to automatically synthesize speech */
             autoMode: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
                 always: "always";
                 off: "off";
                 inbound: "inbound";
                 tagged: "tagged";
             }>>>;
-            /** Maximum text length for TTS synthesis (default: 4096) */
             maxTextLength: z.ZodDefault<z.ZodNumber>;
-            /** Regex pattern to detect TTS-tagged responses (default matches [[tts]] or [[tts:...]]) */
             tagPattern: z.ZodDefault<z.ZodString>;
-            /** Per-channel output format overrides */
             outputFormats: z.ZodDefault<z.ZodObject<{
-                /** Telegram: Opus for native voice notes */
                 telegram: z.ZodDefault<z.ZodString>;
-                /** Discord: MP3 for broadest compatibility */
                 discord: z.ZodDefault<z.ZodString>;
-                /** WhatsApp: MP3 default */
                 whatsapp: z.ZodDefault<z.ZodString>;
-                /** Slack: MP3 default */
                 slack: z.ZodDefault<z.ZodString>;
-                /** Default format for unknown channels */
                 default: z.ZodDefault<z.ZodString>;
             }, z.core.$strict>>;
-            /** ElevenLabs-specific voice settings */
             elevenlabsSettings: z.ZodOptional<z.ZodObject<{
-                /** Voice stability (0-1, higher = more consistent) */
                 stability: z.ZodOptional<z.ZodNumber>;
-                /** Similarity boost (0-1, higher = more similar to original voice) */
                 similarityBoost: z.ZodOptional<z.ZodNumber>;
-                /** Style exaggeration (0-1) */
                 style: z.ZodOptional<z.ZodNumber>;
-                /** Enable speaker boost for clarity */
                 useSpeakerBoost: z.ZodOptional<z.ZodBoolean>;
-                /** Playback speed multiplier */
                 speed: z.ZodOptional<z.ZodNumber>;
-                /** Random seed for reproducible output */
                 seed: z.ZodOptional<z.ZodNumber>;
-                /** Text normalization mode */
                 applyTextNormalization: z.ZodDefault<z.ZodEnum<{
                     auto: "auto";
                     off: "off";
@@ -799,141 +538,84 @@ export declare const IntegrationsConfigSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
-        /** Image analysis settings */
         imageAnalysis: z.ZodDefault<z.ZodObject<{
-            /** Maximum image file size in megabytes (default: 20) */
             maxFileSizeMb: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Multi-provider vision analysis settings */
         vision: z.ZodDefault<z.ZodObject<{
-            /** Enable vision analysis (default: true). */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Ordered list of vision providers to consider (default: all three). */
             providers: z.ZodDefault<z.ZodArray<z.ZodEnum<{
                 openai: "openai";
                 anthropic: "anthropic";
                 google: "google";
             }>>>;
-            /** Preferred default provider (overrides auto-selection). */
             defaultProvider: z.ZodOptional<z.ZodString>;
-            /** Maximum base64-encoded size for video in bytes (default: 70MB). */
             videoMaxBase64Bytes: z.ZodDefault<z.ZodNumber>;
-            /** Maximum raw video file size in bytes (default: 50MB). */
             videoMaxRawBytes: z.ZodDefault<z.ZodNumber>;
-            /** Timeout in milliseconds for video description API calls (default: 120s). */
             videoTimeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** Maximum characters for video description output (default: 500). */
             videoMaxDescriptionChars: z.ZodDefault<z.ZodNumber>;
-            /** Maximum image file size in megabytes (default: 20). */
             imageMaxFileSizeMb: z.ZodDefault<z.ZodNumber>;
-            /** Scope rules for vision analysis (first match wins). */
             scopeRules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                /** Channel type to match (e.g. "telegram", "discord"). */
                 channel: z.ZodOptional<z.ZodString>;
-                /** Chat type to match (e.g. "private", "group"). */
                 chatType: z.ZodOptional<z.ZodString>;
-                /** Session key prefix to match via startsWith. */
                 keyPrefix: z.ZodOptional<z.ZodString>;
-                /** Action to take when this rule matches. */
                 action: z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
                 }>;
             }, z.core.$strict>>>;
-            /** Default action when no scope rule matches (default: "allow"). */
             defaultScopeAction: z.ZodDefault<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
             }>>;
         }, z.core.$strict>>;
-        /** Link understanding settings */
         linkUnderstanding: z.ZodDefault<z.ZodObject<{
-            /** Enable automatic link understanding (default: true) */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum number of links to process per message (default: 3) */
             maxLinks: z.ZodDefault<z.ZodNumber>;
-            /** Timeout for fetching each URL in milliseconds (default: 10000) */
             fetchTimeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** Maximum characters of extracted content per link (default: 5000) */
             maxContentChars: z.ZodDefault<z.ZodNumber>;
-            /** User-Agent string for outbound fetch requests */
             userAgentString: z.ZodDefault<z.ZodString>;
         }, z.core.$strict>>;
-        /** Infrastructure settings (fetch limits, concurrency, temp files) */
         infrastructure: z.ZodDefault<z.ZodObject<{
-            /** Max file size for remote media fetches in bytes (default: 25MB) */
             maxRemoteFetchBytes: z.ZodDefault<z.ZodNumber>;
-            /** Max concurrent media operations (default: 3) */
             concurrencyLimit: z.ZodDefault<z.ZodNumber>;
-            /** Temp file TTL in milliseconds (default: 30 min) */
             tempFileTtlMs: z.ZodDefault<z.ZodNumber>;
-            /** Cleanup interval in milliseconds (default: 5 min) */
             tempCleanupIntervalMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Document extraction settings */
         documentExtraction: z.ZodDefault<z.ZodObject<{
-            /** Enable document extraction (default: true) */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Allowed MIME types for extraction (default: DOCUMENT_MIME_WHITELIST) */
             allowedMimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            /** Maximum file size in bytes (default: 10MB) */
             maxBytes: z.ZodDefault<z.ZodNumber>;
-            /** Maximum characters in extracted text (default: 200000) */
             maxChars: z.ZodDefault<z.ZodNumber>;
-            /** Maximum total characters across all attachments per message (default: 500000) */
             maxTotalChars: z.ZodDefault<z.ZodNumber>;
-            /** Maximum pages to extract from paginated documents (default: 20) */
             maxPages: z.ZodDefault<z.ZodNumber>;
-            /** Extraction timeout in milliseconds (default: 30000) */
             timeoutMs: z.ZodDefault<z.ZodNumber>;
-            /** Use OCR/image fallback for PDF pages with little text (default: false) */
             pdfImageFallback: z.ZodDefault<z.ZodBoolean>;
-            /** Minimum character threshold per page to trigger image fallback (default: 50, 0 = always fallback) */
             pdfImageFallbackThreshold: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Media file persistence settings */
         persistence: z.ZodDefault<z.ZodObject<{
-            /** Enable automatic media file persistence to workspace (default: true) */
             enabled: z.ZodDefault<z.ZodBoolean>;
-            /** Soft limit for total workspace media storage in MB (default: 1024 = 1GB). Logs WARN when exceeded. */
             maxStorageMb: z.ZodDefault<z.ZodNumber>;
-            /** Maximum individual file size in bytes (default: 52428800 = 50MB) */
             maxFileBytes: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Image generation settings */
         imageGeneration: z.ZodDefault<z.ZodObject<{
-            /** Image generation provider (default: "fal") */
             provider: z.ZodDefault<z.ZodEnum<{
                 openai: "openai";
                 fal: "fal";
             }>>;
-            /** Provider-specific model ID (e.g., "fal-ai/flux/dev", "gpt-image-1") */
             model: z.ZodOptional<z.ZodString>;
-            /** Enable safety checker on generated images (default: true) */
             safetyChecker: z.ZodDefault<z.ZodBoolean>;
-            /** Maximum image generations per hour per agent (default: 10) */
             maxPerHour: z.ZodDefault<z.ZodNumber>;
-            /** Default image size/dimensions (default: "1024x1024") */
             defaultSize: z.ZodDefault<z.ZodString>;
-            /** Generation timeout in milliseconds (default: 60000) */
             timeoutMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Auto-reply rule engine */
     autoReply: z.ZodDefault<z.ZodObject<{
-        /** Enable auto-reply rules (default: false) */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** List of auto-reply rules */
         rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            /** Unique identifier for this rule */
             id: z.ZodString;
-            /** Regex pattern to match incoming messages */
             pattern: z.ZodString;
-            /** Response template (supports {{match}} placeholders) */
             template: z.ZodString;
-            /** Optional channel filter (rule applies only to listed channels) */
             channels: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            /** Priority for rule ordering (higher = first, default: 0) */
             priority: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;