comisai 1.0.36 → 1.0.37

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

@@ -58,20 +58,15 @@ export declare const ReplyModeSchema: z.ZodDefault<z.ZodEnum<{
  * streaming behavior, typing indicator mode, and delivery timing/coalescer settings.
  */
 export declare const PerChannelStreamingConfigSchema: z.ZodObject<{
-    /** Whether block streaming is enabled for this channel */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** How to split response text into blocks */
     chunkMode: z.ZodDefault<z.ZodEnum<{
         length: "length";
         paragraph: "paragraph";
         newline: "newline";
         sentence: "sentence";
     }>>;
-    /** Maximum characters per block (falls back to platform maxMessageChars if not set) */
     chunkMaxChars: z.ZodOptional<z.ZodNumber>;
-    /** Minimum characters before allowing a split point */
     chunkMinChars: z.ZodDefault<z.ZodNumber>;
-    /** Delivery timing configuration (pacing between block deliveries) */
     deliveryTiming: z.ZodDefault<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
             custom: "custom";
@@ -84,7 +79,6 @@ export declare const PerChannelStreamingConfigSchema: z.ZodObject<{
         jitterMs: z.ZodDefault<z.ZodNumber>;
         firstBlockDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Block coalescer configuration (accumulation before flush) */
     coalescer: z.ZodDefault<z.ZodObject<{
         minChars: z.ZodDefault<z.ZodNumber>;
         maxChars: z.ZodDefault<z.ZodNumber>;
@@ -95,34 +89,26 @@ export declare const PerChannelStreamingConfigSchema: z.ZodObject<{
         }>>;
         adaptiveIdle: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** When to show typing indicators */
     typingMode: z.ZodDefault<z.ZodEnum<{
         message: "message";
         never: "never";
         instant: "instant";
         thinking: "thinking";
     }>>;
-    /** Typing indicator refresh interval in ms (platforms auto-clear after ~10s) */
     typingRefreshMs: z.ZodDefault<z.ZodNumber>;
-    /** Consecutive sendTyping failures before circuit breaker trips (default 3) */
     typingCircuitBreakerThreshold: z.ZodDefault<z.ZodNumber>;
-    /** Maximum typing indicator duration in ms before auto-stop (default 60s) */
     typingTtlMs: z.ZodDefault<z.ZodNumber>;
-    /** Whether to use Markdown IR pipeline for format-first chunking (prevents double-chunking with chunkBlocks) */
     useMarkdownIR: z.ZodDefault<z.ZodBoolean>;
-    /** Table conversion mode when using IR pipeline */
     tableMode: z.ZodDefault<z.ZodEnum<{
         off: "off";
         code: "code";
         bullets: "bullets";
     }>>;
-    /** Reply-to threading mode for outbound messages */
     replyMode: z.ZodDefault<z.ZodEnum<{
         off: "off";
         first: "first";
         all: "all";
     }>>;
-    /** Per-chat-type reply mode overrides (e.g., { dm: "off", group: "first", forum: "all" }) */
     replyModeByChatType: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
         channel: "channel";
         dm: "dm";
@@ -142,16 +128,13 @@ export declare const PerChannelStreamingConfigSchema: z.ZodObject<{
  * Per-channel overrides take precedence over these defaults.
  */
 export declare const StreamingConfigSchema: z.ZodObject<{
-    /** Global enable/disable for block streaming (defaults to enabled) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Default chunk mode for channels without per-channel override */
     defaultChunkMode: z.ZodDefault<z.ZodEnum<{
         length: "length";
         paragraph: "paragraph";
         newline: "newline";
         sentence: "sentence";
     }>>;
-    /** Default delivery timing for channels without per-channel override */
     defaultDeliveryTiming: z.ZodDefault<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
             custom: "custom";
@@ -164,7 +147,6 @@ export declare const StreamingConfigSchema: z.ZodObject<{
         jitterMs: z.ZodDefault<z.ZodNumber>;
         firstBlockDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Default coalescer for channels without per-channel override */
     defaultCoalescer: z.ZodDefault<z.ZodObject<{
         minChars: z.ZodDefault<z.ZodNumber>;
         maxChars: z.ZodDefault<z.ZodNumber>;
@@ -175,45 +157,34 @@ export declare const StreamingConfigSchema: z.ZodObject<{
         }>>;
         adaptiveIdle: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Default typing indicator mode */
     defaultTypingMode: z.ZodDefault<z.ZodEnum<{
         message: "message";
         never: "never";
         instant: "instant";
         thinking: "thinking";
     }>>;
-    /** Default typing indicator refresh interval in ms */
     defaultTypingRefreshMs: z.ZodDefault<z.ZodNumber>;
-    /** Default table conversion mode for IR pipeline */
     defaultTableMode: z.ZodDefault<z.ZodEnum<{
         off: "off";
         code: "code";
         bullets: "bullets";
     }>>;
-    /** Default for Markdown IR pipeline (true = format-aware chunking with platform rendering) */
     defaultUseMarkdownIR: z.ZodDefault<z.ZodBoolean>;
-    /** Default reply-to threading mode for channels without per-channel override */
     defaultReplyMode: z.ZodDefault<z.ZodEnum<{
         off: "off";
         first: "first";
         all: "all";
     }>>;
-    /** Per-channel-type streaming configuration overrides */
     perChannel: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        /** Whether block streaming is enabled for this channel */
         enabled: z.ZodDefault<z.ZodBoolean>;
-        /** How to split response text into blocks */
         chunkMode: z.ZodDefault<z.ZodEnum<{
             length: "length";
             paragraph: "paragraph";
             newline: "newline";
             sentence: "sentence";
         }>>;
-        /** Maximum characters per block (falls back to platform maxMessageChars if not set) */
         chunkMaxChars: z.ZodOptional<z.ZodNumber>;
-        /** Minimum characters before allowing a split point */
         chunkMinChars: z.ZodDefault<z.ZodNumber>;
-        /** Delivery timing configuration (pacing between block deliveries) */
         deliveryTiming: z.ZodDefault<z.ZodObject<{
             mode: z.ZodDefault<z.ZodEnum<{
                 custom: "custom";
@@ -226,7 +197,6 @@ export declare const StreamingConfigSchema: z.ZodObject<{
             jitterMs: z.ZodDefault<z.ZodNumber>;
             firstBlockDelayMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
-        /** Block coalescer configuration (accumulation before flush) */
         coalescer: z.ZodDefault<z.ZodObject<{
             minChars: z.ZodDefault<z.ZodNumber>;
             maxChars: z.ZodDefault<z.ZodNumber>;
@@ -237,34 +207,26 @@ export declare const StreamingConfigSchema: z.ZodObject<{
             }>>;
             adaptiveIdle: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>;
-        /** When to show typing indicators */
         typingMode: z.ZodDefault<z.ZodEnum<{
             message: "message";
             never: "never";
             instant: "instant";
             thinking: "thinking";
         }>>;
-        /** Typing indicator refresh interval in ms (platforms auto-clear after ~10s) */
         typingRefreshMs: z.ZodDefault<z.ZodNumber>;
-        /** Consecutive sendTyping failures before circuit breaker trips (default 3) */
         typingCircuitBreakerThreshold: z.ZodDefault<z.ZodNumber>;
-        /** Maximum typing indicator duration in ms before auto-stop (default 60s) */
         typingTtlMs: z.ZodDefault<z.ZodNumber>;
-        /** Whether to use Markdown IR pipeline for format-first chunking (prevents double-chunking with chunkBlocks) */
         useMarkdownIR: z.ZodDefault<z.ZodBoolean>;
-        /** Table conversion mode when using IR pipeline */
         tableMode: z.ZodDefault<z.ZodEnum<{
             off: "off";
             code: "code";
             bullets: "bullets";
         }>>;
-        /** Reply-to threading mode for outbound messages */
         replyMode: z.ZodDefault<z.ZodEnum<{
             off: "off";
             first: "first";
             all: "all";
         }>>;
-        /** Per-chat-type reply mode overrides (e.g., { dm: "off", group: "first", forum: "all" }) */
         replyModeByChatType: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
             channel: "channel";
             dm: "dm";

package/node_modules/@comis/core/dist/config/schema-telegram-file-guard.d.ts

@@ -9,11 +9,8 @@ import { z } from "zod";
  * Enabled by default for Telegram channels.
  */
 export declare const TelegramFileRefGuardConfigSchema: z.ZodObject<{
-    /** Whether the file reference guard is active */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Additional file extensions to detect beyond the built-in curated set */
     additionalExtensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** File extensions to exclude from guard detection */
     excludedExtensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type TelegramFileRefGuardConfig = z.infer<typeof TelegramFileRefGuardConfigSchema>;

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

@@ -0,0 +1,87 @@
+/**
+ * Tool-first capability-layer configuration schema (v1.1).
+ *
+ * Operator-only YAML tree controlling capability clusters, MCP/skill
+ * capability hints, install-detour mode, and the per-turn capability
+ * index toggle. The entire `tooling.*` subtree is immutable at runtime
+ * (see immutable-keys.ts) -- agents cannot self-configure capability
+ * routing or detour policy.
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * Tool-first capability-layer configuration.
+ *
+ * Strict object: unknown top-level keys (and unknown keys at every nested
+ * level) are rejected at parse time. Every section is `.default(...)` so an
+ * empty `tooling: {}` block (or omitting `tooling` entirely from
+ * AppConfig) yields a fully-populated default tree.
+ *
+ * The entire tree is immutable at runtime and operator-only -- agents must
+ * not self-configure capability routing or detour policy.
+ */
+export declare const ToolingConfigSchema: z.ZodObject<{
+    capabilityClusters: z.ZodDefault<z.ZodObject<{
+        clusters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            label: z.ZodString;
+            priority: z.ZodDefault<z.ZodNumber>;
+            preferOverInstalls: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        builtinAssignments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    mcp: z.ZodDefault<z.ZodObject<{
+        capabilityHints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            cluster: z.ZodString;
+            description: z.ZodString;
+            replacesPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    skills: z.ZodDefault<z.ZodObject<{
+        capabilityHints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            cluster: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            replacesPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    capabilityIndex: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    installDetours: z.ZodDefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            observe: "observe";
+            advise: "advise";
+            "soft-stop": "soft-stop";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Inferred ToolingConfig type. */
+export type ToolingConfig = z.infer<typeof ToolingConfigSchema>;
+/**
+ * Three reserved cluster IDs ship by default. Renderer references them by literal:
+ * - "external-integrations" -- connected MCP servers without an operator hint
+ * - "prompt-skills" -- visible skills without operator/manifest metadata
+ * - "other-tools" -- non-MCP tools without getBuiltinCluster() resolution
+ *
+ * Operators may override label, priority, preferOverInstalls per-key, but the IDs
+ * themselves are fixed.
+ *
+ * IMPORTANT: This object is intentionally NOT used as a `.default(...)` argument on
+ * `clusters` because z.record(...).default({}) does NOT key-merge -- it replaces
+ * the whole record. The merge MUST happen at adapter construction:
+ *
+ *   const mergedClusters = {
+ *     ...DEFAULT_CLUSTER_CONFIG,
+ *     ...config.tooling.capabilityClusters.clusters,  // operator wins per-key
+ *   };
+ */
+export declare const DEFAULT_CLUSTER_CONFIG: Readonly<Record<string, {
+    readonly label: string;
+    readonly priority: number;
+    readonly preferOverInstalls: boolean;
+}>>;
+/**
+ * Default builtin tool->cluster assignments. Empty by default; operators
+ * populate via `tooling.capabilityClusters.builtinAssignments`.
+ */
+export declare const DEFAULT_BUILTIN_ASSIGNMENTS: Readonly<Record<string, string>>;

package/node_modules/@comis/core/dist/config/schema-tooling.js

@@ -0,0 +1,152 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Tool-first capability-layer configuration schema (v1.1).
+ *
+ * Operator-only YAML tree controlling capability clusters, MCP/skill
+ * capability hints, install-detour mode, and the per-turn capability
+ * index toggle. The entire `tooling.*` subtree is immutable at runtime
+ * (see immutable-keys.ts) -- agents cannot self-configure capability
+ * routing or detour policy.
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * Operator-overridable shape for a single cluster entry.
+ *
+ * `priority` (default 100) and `preferOverInstalls` (default true) make sense
+ * across both reserved and operator-defined clusters. Reserved IDs are listed
+ * in DEFAULT_CLUSTER_CONFIG below; operators may override scalar fields per-key
+ * but the IDs themselves are fixed (renderer references them by literal).
+ */
+const ClusterEntrySchema = z.strictObject({
+    /** Display label for the cluster (e.g., "Data fetching - financial / market"). */
+    label: z.string().min(1),
+    /** Render-order priority. Lower numbers surface earlier. (default: 100) */
+    priority: z.number().int().default(100),
+    /** Should this cluster's tools be preferred over `pip install`/`npm install` of comparable packages? (default: true) */
+    preferOverInstalls: z.boolean().default(true),
+});
+/**
+ * Capability hint shape for an MCP server.
+ *
+ * BOTH `cluster` and `description` are required. The asymmetry vs. skills is
+ * intentional: MCP servers do not carry an in-band human-readable description
+ * suitable for the renderer, so the operator must supply one. Skills already
+ * carry `description` in the manifest, so the hint may omit it.
+ */
+const McpCapabilityHintSchema = z.strictObject({
+    cluster: z.string().min(1),
+    description: z.string().min(1),
+    replacesPackages: z.array(z.string().min(1)).default([]),
+});
+/**
+ * Capability hint shape for a prompt skill.
+ *
+ * `description` is optional -- skills carry their own description in the
+ * manifest frontmatter; the hint may override it but is not required to.
+ */
+const SkillCapabilityHintSchema = z.strictObject({
+    cluster: z.string().min(1),
+    description: z.string().min(1).optional(),
+    replacesPackages: z.array(z.string().min(1)).default([]),
+});
+// Sub-section schemas (inner). Each top-level field uses
+// `.default(() => Sub.parse({}))` so empty input yields fully-populated
+// defaults (matches the codebase-wide convention -- see schema.ts root).
+const CapabilityClustersSubSchema = z.strictObject({
+    clusters: z.record(z.string(), ClusterEntrySchema).default({}),
+    /** Builtin tool name -> cluster ID assignments. Operator-supplied. */
+    builtinAssignments: z.record(z.string(), z.string()).default({}),
+});
+const McpSubSchema = z.strictObject({
+    capabilityHints: z.record(z.string(), McpCapabilityHintSchema).default({}),
+});
+const SkillsSubSchema = z.strictObject({
+    capabilityHints: z.record(z.string(), SkillCapabilityHintSchema).default({}),
+});
+const CapabilityIndexSubSchema = z.strictObject({
+    enabled: z.boolean().default(true),
+});
+const InstallDetoursSubSchema = z.strictObject({
+    /**
+     * Install-detour mode controls how the install-detour validator acts when
+     * an exec command would `pip install` / `npm install` a package that
+     * overlaps with an already-connected MCP server or skill.
+     *
+     * - "observe"   -- emit an event, no user-facing message, allow the install.
+     * - "advise"    -- emit an event AND surface a hint to the agent. (default)
+     * - "soft-stop" -- emit an event AND block the install pending override.
+     */
+    mode: z.enum(["observe", "advise", "soft-stop"]).default("advise"),
+});
+/**
+ * Tool-first capability-layer configuration.
+ *
+ * Strict object: unknown top-level keys (and unknown keys at every nested
+ * level) are rejected at parse time. Every section is `.default(...)` so an
+ * empty `tooling: {}` block (or omitting `tooling` entirely from
+ * AppConfig) yields a fully-populated default tree.
+ *
+ * The entire tree is immutable at runtime and operator-only -- agents must
+ * not self-configure capability routing or detour policy.
+ */
+export const ToolingConfigSchema = z.strictObject({
+    /**
+     * Cluster definitions and builtin tool->cluster assignments.
+     *
+     * NOTE: `clusters` is a `z.record(...)` whose default is `{}`, NOT
+     * `DEFAULT_CLUSTER_CONFIG`. See the load-bearing JSDoc on
+     * DEFAULT_CLUSTER_CONFIG below for why -- the merge-with-defaults
+     * contract is enforced at adapter-construction time.
+     */
+    capabilityClusters: CapabilityClustersSubSchema.default(() => CapabilityClustersSubSchema.parse({})),
+    /** Capability hints for connected MCP servers (keyed by server name). */
+    mcp: McpSubSchema.default(() => McpSubSchema.parse({})),
+    /** Capability hints for prompt skills (keyed by skill name or skill-key). */
+    skills: SkillsSubSchema.default(() => SkillsSubSchema.parse({})),
+    /** Per-turn capability index toggle. Default: true. */
+    capabilityIndex: CapabilityIndexSubSchema.default(() => CapabilityIndexSubSchema.parse({})),
+    /** Install-detour validator mode. Default: "advise". */
+    installDetours: InstallDetoursSubSchema.default(() => InstallDetoursSubSchema.parse({})),
+});
+/**
+ * Three reserved cluster IDs ship by default. Renderer references them by literal:
+ * - "external-integrations" -- connected MCP servers without an operator hint
+ * - "prompt-skills" -- visible skills without operator/manifest metadata
+ * - "other-tools" -- non-MCP tools without getBuiltinCluster() resolution
+ *
+ * Operators may override label, priority, preferOverInstalls per-key, but the IDs
+ * themselves are fixed.
+ *
+ * IMPORTANT: This object is intentionally NOT used as a `.default(...)` argument on
+ * `clusters` because z.record(...).default({}) does NOT key-merge -- it replaces
+ * the whole record. The merge MUST happen at adapter construction:
+ *
+ *   const mergedClusters = {
+ *     ...DEFAULT_CLUSTER_CONFIG,
+ *     ...config.tooling.capabilityClusters.clusters,  // operator wins per-key
+ *   };
+ */
+export const DEFAULT_CLUSTER_CONFIG = Object.freeze({
+    "external-integrations": Object.freeze({
+        label: "External integrations",
+        priority: 9999,
+        preferOverInstalls: true,
+    }),
+    "prompt-skills": Object.freeze({
+        label: "Prompt skills",
+        priority: 9999,
+        preferOverInstalls: true,
+    }),
+    "other-tools": Object.freeze({
+        label: "Other tools",
+        priority: 9999,
+        preferOverInstalls: false,
+    }),
+});
+/**
+ * Default builtin tool->cluster assignments. Empty by default; operators
+ * populate via `tooling.capabilityClusters.builtinAssignments`.
+ */
+export const DEFAULT_BUILTIN_ASSIGNMENTS = Object.freeze({});

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

@@ -11,7 +11,6 @@ export declare const VerbosityLevelSchema: z.ZodEnum<{
     detailed: "detailed";
 }>;
 export declare const VerbosityOverrideSchema: z.ZodObject<{
-    /** Override verbosity level for this channel. */
     level: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
         terse: "terse";
@@ -19,17 +18,12 @@ export declare const VerbosityOverrideSchema: z.ZodObject<{
         standard: "standard";
         detailed: "detailed";
     }>>;
-    /** Target response length in characters. */
     maxResponseChars: z.ZodOptional<z.ZodNumber>;
-    /** Whether to use markdown formatting (undefined = no opinion). */
     useMarkdown: z.ZodOptional<z.ZodBoolean>;
-    /** Whether code blocks are allowed. */
     allowCodeBlocks: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const VerbosityConfigSchema: z.ZodObject<{
-    /** Whether verbosity hints are enabled for this agent. */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Default verbosity level. */
     defaultLevel: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
         terse: "terse";
@@ -37,7 +31,6 @@ export declare const VerbosityConfigSchema: z.ZodObject<{
         standard: "standard";
         detailed: "detailed";
     }>>;
-    /** Override level for thread messages. */
     threadLevel: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
         terse: "terse";
@@ -45,9 +38,7 @@ export declare const VerbosityConfigSchema: z.ZodObject<{
         standard: "standard";
         detailed: "detailed";
     }>>;
-    /** Per-channel overrides keyed by channelType. */
     overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        /** Override verbosity level for this channel. */
         level: z.ZodOptional<z.ZodEnum<{
             auto: "auto";
             terse: "terse";
@@ -55,11 +46,8 @@ export declare const VerbosityConfigSchema: z.ZodObject<{
             standard: "standard";
             detailed: "detailed";
         }>>;
-        /** Target response length in characters. */
         maxResponseChars: z.ZodOptional<z.ZodNumber>;
-        /** Whether to use markdown formatting (undefined = no opinion). */
         useMarkdown: z.ZodOptional<z.ZodBoolean>;
-        /** Whether code blocks are allowed. */
         allowCodeBlocks: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;

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

@@ -6,9 +6,7 @@ import { z } from "zod";
  * If neither is provided, the mapping matches all requests.
  */
 export declare const WebhookMappingMatchSchema: z.ZodObject<{
-    /** URL path segment to match (normalized: leading/trailing slashes stripped) */
     path: z.ZodOptional<z.ZodString>;
-    /** Source identifier to match (from payload or header) */
     source: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 /**
@@ -19,44 +17,28 @@ export declare const WebhookMappingMatchSchema: z.ZodObject<{
  * message template).
  */
 export declare const WebhookMappingConfigSchema: z.ZodObject<{
-    /** Unique identifier for this mapping */
     id: z.ZodOptional<z.ZodString>;
-    /** Match conditions (path and/or source) */
     match: z.ZodOptional<z.ZodObject<{
-        /** URL path segment to match (normalized: leading/trailing slashes stripped) */
         path: z.ZodOptional<z.ZodString>;
-        /** Source identifier to match (from payload or header) */
         source: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    /** Action to take: "wake" triggers heartbeat, "agent" invokes agent */
     action: z.ZodDefault<z.ZodEnum<{
         wake: "wake";
         agent: "agent";
     }>>;
-    /** Wake mode: "now" fires immediately, "next-heartbeat" waits for next cycle */
     wakeMode: z.ZodDefault<z.ZodEnum<{
         now: "now";
         "next-heartbeat": "next-heartbeat";
     }>>;
-    /** Human-readable name for this mapping */
     name: z.ZodOptional<z.ZodString>;
-    /** Target agent ID for agent actions */
     agentId: z.ZodOptional<z.ZodString>;
-    /** Session key template (supports {{expr}} placeholders) */
     sessionKey: z.ZodOptional<z.ZodString>;
-    /** Message template for agent actions (supports {{expr}} placeholders) */
     messageTemplate: z.ZodOptional<z.ZodString>;
-    /** Alternative text template (plain text version) */
     textTemplate: z.ZodOptional<z.ZodString>;
-    /** Whether to deliver the message to a channel */
     deliver: z.ZodOptional<z.ZodBoolean>;
-    /** Target channel for delivery */
     channel: z.ZodOptional<z.ZodString>;
-    /** Target recipient for delivery */
     to: z.ZodOptional<z.ZodString>;
-    /** Model override for agent execution */
     model: z.ZodOptional<z.ZodString>;
-    /** Timeout in seconds for agent execution */
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 /**
@@ -66,11 +48,8 @@ export declare const WebhookMappingConfigSchema: z.ZodObject<{
  * body size limits, preset mappings, and custom mappings.
  */
 export declare const WebhooksConfigSchema: z.ZodObject<{
-    /** Enable the webhook subsystem (default: false) */
     enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Base path for webhook endpoints (default: "/hooks") */
     path: z.ZodDefault<z.ZodString>;
-    /** Optional bearer token for webhook authentication (min 32 chars when provided; string or SecretRef) */
     token: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         source: z.ZodEnum<{
             file: "file";
@@ -80,50 +59,31 @@ export declare const WebhooksConfigSchema: z.ZodObject<{
         provider: z.ZodString;
         id: z.ZodString;
     }, z.core.$strict>]>>;
-    /** Maximum request body size in bytes (default: 256KB) */
     maxBodyBytes: z.ZodDefault<z.ZodNumber>;
-    /** Preset mapping names to load (e.g., ["gmail", "github"]) */
     presets: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Custom webhook mappings */
     mappings: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        /** Unique identifier for this mapping */
         id: z.ZodOptional<z.ZodString>;
-        /** Match conditions (path and/or source) */
         match: z.ZodOptional<z.ZodObject<{
-            /** URL path segment to match (normalized: leading/trailing slashes stripped) */
             path: z.ZodOptional<z.ZodString>;
-            /** Source identifier to match (from payload or header) */
             source: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
-        /** Action to take: "wake" triggers heartbeat, "agent" invokes agent */
         action: z.ZodDefault<z.ZodEnum<{
             wake: "wake";
             agent: "agent";
         }>>;
-        /** Wake mode: "now" fires immediately, "next-heartbeat" waits for next cycle */
         wakeMode: z.ZodDefault<z.ZodEnum<{
             now: "now";
             "next-heartbeat": "next-heartbeat";
         }>>;
-        /** Human-readable name for this mapping */
         name: z.ZodOptional<z.ZodString>;
-        /** Target agent ID for agent actions */
         agentId: z.ZodOptional<z.ZodString>;
-        /** Session key template (supports {{expr}} placeholders) */
         sessionKey: z.ZodOptional<z.ZodString>;
-        /** Message template for agent actions (supports {{expr}} placeholders) */
         messageTemplate: z.ZodOptional<z.ZodString>;
-        /** Alternative text template (plain text version) */
         textTemplate: z.ZodOptional<z.ZodString>;
-        /** Whether to deliver the message to a channel */
         deliver: z.ZodOptional<z.ZodBoolean>;
-        /** Target channel for delivery */
         channel: z.ZodOptional<z.ZodString>;
-        /** Target recipient for delivery */
         to: z.ZodOptional<z.ZodString>;
-        /** Model override for agent execution */
         model: z.ZodOptional<z.ZodString>;
-        /** Timeout in seconds for agent execution */
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;