@mono-agent/agent-app 0.3.0 → 0.4.1

package/schema/mono-agent.config.schema.json

@@ -0,0 +1,1686 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/robertsreberski/mono-agent/main/packages/agent-app/schema/mono-agent.config.schema.json",
+  "title": "mono-agent.config.json",
+  "type": "object",
+  "required": [
+    "runtime",
+    "context"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "model": {
+          "description": "Configures model for the runtime section.",
+          "examples": [
+            "claude:claude-sonnet-4-6"
+          ],
+          "type": "string"
+        },
+        "fallbackModels": {
+          "description": "Configures fallbackModels for the runtime section.",
+          "examples": [
+            [
+              "pi:ollama:gemma4:31b"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "executionMode": {
+          "description": "Configures executionMode for the runtime section.",
+          "examples": [
+            "inferred"
+          ],
+          "type": "string",
+          "default": "inferred"
+        },
+        "effort": {
+          "description": "Configures effort for the runtime section.",
+          "examples": [
+            "medium"
+          ],
+          "type": "string"
+        },
+        "permissionMode": {
+          "description": "Configures permissionMode for the runtime section.",
+          "examples": [
+            "default"
+          ],
+          "type": "string"
+        },
+        "maxTurns": {
+          "description": "Configures maxTurns for the runtime section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "workspace": {
+          "description": "Configures workspace for the runtime section.",
+          "examples": [
+            "."
+          ],
+          "type": "string",
+          "default": "."
+        },
+        "session": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "description": "Configures session.mode for the runtime section.",
+              "examples": [
+                "continuous"
+              ],
+              "type": "string",
+              "default": "continuous"
+            },
+            "idleTimeoutMs": {
+              "description": "Configures session.idleTimeoutMs for the runtime section.",
+              "examples": [
+                1800000
+              ],
+              "type": "integer",
+              "default": 1800000
+            },
+            "rollover": {
+              "description": "Configures session.rollover for the runtime section.",
+              "examples": [
+                "none"
+              ],
+              "type": "string",
+              "default": "none"
+            },
+            "rolloverTimezone": {
+              "description": "Configures session.rolloverTimezone for the runtime section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "rolloverNotice": {
+              "description": "Configures session.rolloverNotice for the runtime section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": false
+            },
+            "isolateProactive": {
+              "description": "Configures session.isolateProactive for the runtime section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": false
+            }
+          }
+        }
+      },
+      "required": [
+        "model"
+      ]
+    },
+    "concurrency": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxConcurrentRuns": {
+          "description": "Configures maxConcurrentRuns for the concurrency section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "maxPendingRuns": {
+          "description": "Configures maxPendingRuns for the concurrency section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "identityPath": {
+          "description": "Configures identityPath for the context section.",
+          "examples": [
+            "./IDENTITY.md"
+          ],
+          "type": "string"
+        },
+        "soulPath": {
+          "description": "Configures soulPath for the context section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "skillsRoot": {
+          "description": "Configures skillsRoot for the context section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "selectedSkills": {
+          "description": "Configures selectedSkills for the context section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "skillMaxBytes": {
+          "description": "Configures skillMaxBytes for the context section.",
+          "examples": [
+            48000
+          ],
+          "type": "integer",
+          "default": 48000
+        },
+        "skillDisclosure": {
+          "description": "Configures skillDisclosure for the context section.",
+          "examples": [
+            "full"
+          ],
+          "type": "string",
+          "default": "full"
+        }
+      },
+      "required": [
+        "identityPath"
+      ]
+    },
+    "memory": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "backend": {
+          "description": "Configures backend for the memory section.",
+          "examples": [
+            "bujo"
+          ],
+          "type": "string",
+          "default": "bujo"
+        },
+        "mode": {
+          "description": "Configures mode for the memory section.",
+          "examples": [
+            "journal"
+          ],
+          "type": "string"
+        },
+        "path": {
+          "description": "Configures path for the memory section.",
+          "examples": [
+            "./.mono-agent/memory"
+          ],
+          "type": "string"
+        },
+        "maxBytes": {
+          "description": "Configures maxBytes for the memory section.",
+          "examples": [
+            64000
+          ],
+          "type": "integer",
+          "default": 64000
+        },
+        "writeMode": {
+          "description": "Configures writeMode for the memory section.",
+          "examples": [
+            "append-host-summary"
+          ],
+          "type": "string",
+          "default": "append-host-summary"
+        },
+        "supermemory": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "baseUrl": {
+              "description": "Configures supermemory.baseUrl for the memory section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "apiKey": {
+              "description": "Secret value for memory.supermemory.apiKey; prefer the env override.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "apiKeyEnv": {
+              "description": "Secret value for memory.supermemory.apiKeyEnv; prefer the env override.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "container": {
+              "description": "Configures supermemory.container for the memory section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "timeoutMs": {
+              "description": "Configures supermemory.timeoutMs for the memory section.",
+              "examples": [
+                10000
+              ],
+              "type": "integer",
+              "default": 10000
+            },
+            "exposeMcpServer": {
+              "description": "Configures supermemory.exposeMcpServer for the memory section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": false
+            }
+          }
+        },
+        "embeddings": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "provider": {
+              "description": "Configures embeddings.provider for the memory section.",
+              "examples": [
+                "ollama"
+              ],
+              "type": "string"
+            },
+            "model": {
+              "description": "Configures embeddings.model for the memory section.",
+              "examples": [
+                "nomic-embed-text"
+              ],
+              "type": "string"
+            },
+            "endpoint": {
+              "description": "Configures embeddings.endpoint for the memory section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "apiKey": {
+              "description": "Secret value for memory.embeddings.apiKey; prefer the env override.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "apiKeyEnv": {
+              "description": "Secret value for memory.embeddings.apiKeyEnv; prefer the env override.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "dim": {
+              "description": "Configures embeddings.dim for the memory section.",
+              "examples": [
+                1
+              ],
+              "type": "integer"
+            },
+            "timeoutMs": {
+              "description": "Configures embeddings.timeoutMs for the memory section.",
+              "examples": [
+                10000
+              ],
+              "type": "integer",
+              "default": 10000
+            },
+            "circuitBreaker": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "failureThreshold": {
+                  "description": "Configures embeddings.circuitBreaker.failureThreshold for the memory section.",
+                  "examples": [
+                    3
+                  ],
+                  "type": "integer",
+                  "default": 3
+                },
+                "cooldownMs": {
+                  "description": "Configures embeddings.circuitBreaker.cooldownMs for the memory section.",
+                  "examples": [
+                    30000
+                  ],
+                  "type": "integer",
+                  "default": 30000
+                }
+              }
+            }
+          }
+        },
+        "llm": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "provider": {
+              "description": "Configures llm.provider for the memory section.",
+              "examples": [
+                "agent-host"
+              ],
+              "type": "string"
+            },
+            "model": {
+              "description": "Configures llm.model for the memory section.",
+              "examples": [
+                "claude:claude-sonnet-4-6"
+              ],
+              "type": "string"
+            },
+            "executionMode": {
+              "description": "Configures llm.executionMode for the memory section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "trace": {
+              "description": "Configures llm.trace for the memory section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": true
+            },
+            "timeoutMs": {
+              "description": "Configures llm.timeoutMs for the memory section.",
+              "examples": [
+                60000
+              ],
+              "type": "integer",
+              "default": 60000
+            },
+            "endpoint": {
+              "description": "Configures llm.endpoint for the memory section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            }
+          }
+        },
+        "recallTool": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "description": "Enables the memory capability.",
+              "examples": [
+                true
+              ],
+              "type": "boolean"
+            }
+          }
+        },
+        "consolidation": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "description": "Enables the memory capability.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": true
+            },
+            "cron": {
+              "description": "Configures consolidation.cron for the memory section.",
+              "examples": [
+                "0 */2 * * *"
+              ],
+              "type": "string",
+              "default": "0 */2 * * *"
+            }
+          }
+        }
+      }
+    },
+    "tools": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allowedTools": {
+          "description": "Configures allowedTools for the tools section.",
+          "examples": [
+            [
+              "Read",
+              "Grep"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "disallowedTools": {
+          "description": "Configures disallowedTools for the tools section.",
+          "examples": [
+            [
+              "Read",
+              "Grep"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": []
+        },
+        "mcpConfigPath": {
+          "description": "Configures mcpConfigPath for the tools section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "mcpCallTimeoutMs": {
+          "description": "Configures mcpCallTimeoutMs for the tools section.",
+          "examples": [
+            120000
+          ],
+          "type": "integer",
+          "default": 120000
+        },
+        "mcpCallMaxTotalTimeoutMs": {
+          "description": "Configures mcpCallMaxTotalTimeoutMs for the tools section.",
+          "examples": [
+            2700000
+          ],
+          "type": "integer",
+          "default": 2700000
+        }
+      }
+    },
+    "sandbox": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "description": "Configures mode for the sandbox section.",
+          "examples": [
+            "native"
+          ],
+          "type": "string"
+        },
+        "network": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode": {
+              "description": "Configures network.mode for the sandbox section.",
+              "examples": [
+                "none"
+              ],
+              "type": "string",
+              "default": "none"
+            },
+            "allowlist": {
+              "description": "Configures network.allowlist for the sandbox section.",
+              "examples": [
+                [
+                  "example"
+                ]
+              ],
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "readableRoots": {
+          "description": "Configures readableRoots for the sandbox section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "writableRoots": {
+          "description": "Configures writableRoots for the sandbox section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "denyWrite": {
+          "description": "Configures denyWrite for the sandbox section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "fallback": {
+          "description": "Configures fallback for the sandbox section.",
+          "examples": [
+            "fail-closed"
+          ],
+          "type": "string",
+          "default": "fail-closed"
+        },
+        "unsafeAllowHostProcess": {
+          "description": "Configures unsafeAllowHostProcess for the sandbox section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "dir": {
+          "description": "Configures dir for the artifacts section.",
+          "examples": [
+            ".mono-agent/artifacts"
+          ],
+          "type": "string",
+          "default": ".mono-agent/artifacts"
+        },
+        "retention": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxAgeDays": {
+              "description": "Configures retention.maxAgeDays for the artifacts section.",
+              "examples": [
+                365
+              ],
+              "type": "integer",
+              "default": 365
+            },
+            "maxCount": {
+              "description": "Configures retention.maxCount for the artifacts section.",
+              "examples": [
+                50000
+              ],
+              "type": "integer",
+              "default": 50000
+            },
+            "dryRun": {
+              "description": "Configures retention.dryRun for the artifacts section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": false
+            }
+          }
+        },
+        "memoryRetention": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxAgeDays": {
+              "description": "Configures memoryRetention.maxAgeDays for the artifacts section.",
+              "examples": [
+                7
+              ],
+              "type": "integer",
+              "default": 7
+            },
+            "maxCount": {
+              "description": "Configures memoryRetention.maxCount for the artifacts section.",
+              "examples": [
+                5000
+              ],
+              "type": "integer",
+              "default": 5000
+            },
+            "dryRun": {
+              "description": "Configures memoryRetention.dryRun for the artifacts section.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": false
+            }
+          }
+        }
+      }
+    },
+    "traceability": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "registryDir": {
+          "description": "Configures registryDir for the traceability section.",
+          "examples": [
+            ".mono-agent/trace-sources"
+          ],
+          "type": "string",
+          "default": ".mono-agent/trace-sources"
+        },
+        "sourceId": {
+          "description": "Configures sourceId for the traceability section.",
+          "examples": [
+            "my-agent"
+          ],
+          "type": "string"
+        },
+        "sourceLabel": {
+          "description": "Configures sourceLabel for the traceability section.",
+          "examples": [
+            "My Agent"
+          ],
+          "type": "string"
+        },
+        "heartbeatMs": {
+          "description": "Configures heartbeatMs for the traceability section.",
+          "examples": [
+            10000
+          ],
+          "type": "integer",
+          "default": 10000
+        },
+        "staleAfterMs": {
+          "description": "Configures staleAfterMs for the traceability section.",
+          "examples": [
+            30000
+          ],
+          "type": "integer",
+          "default": 30000
+        },
+        "globalDiscovery": {
+          "description": "Configures globalDiscovery for the traceability section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "observability": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "exporters": {
+          "description": "Configures exporters for the observability section.",
+          "examples": [
+            []
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      }
+    },
+    "providers": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "piAuthPath": {
+          "description": "Configures piAuthPath for the providers section.",
+          "examples": [
+            "~/.pi/agent/auth.json"
+          ],
+          "type": "string"
+        },
+        "piNative": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "piMaxRetries": {
+              "description": "Configures piNative.piMaxRetries for the providers section.",
+              "examples": [
+                2
+              ],
+              "type": "integer",
+              "default": 2
+            },
+            "maxRetryDelayMs": {
+              "description": "Configures piNative.maxRetryDelayMs for the providers section.",
+              "examples": [
+                60000
+              ],
+              "type": "integer",
+              "default": 60000
+            },
+            "piSessionsRoot": {
+              "description": "Configures piNative.piSessionsRoot for the providers section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            }
+          }
+        },
+        "local": {
+          "description": "Configures local for the providers section.",
+          "examples": [
+            []
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      }
+    },
+    "interaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "bridge": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "host": {
+              "description": "Loopback host for the app-owned ask_user/tool-progress bridge.",
+              "examples": [
+                "127.0.0.1"
+              ],
+              "type": "string",
+              "default": "127.0.0.1"
+            },
+            "port": {
+              "description": "Bridge port. 0 chooses an ephemeral port.",
+              "examples": [
+                0
+              ],
+              "type": "integer",
+              "default": 0
+            }
+          }
+        },
+        "askUser": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "timeoutMs": {
+              "description": "Maximum wait for one ask_user question.",
+              "examples": [
+                600000
+              ],
+              "type": "integer",
+              "default": 600000
+            }
+          }
+        },
+        "progress": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "description": "Whether tool progress posts are relayed to channel status messages.",
+              "examples": [
+                true
+              ],
+              "type": "boolean",
+              "default": true
+            }
+          }
+        }
+      }
+    },
+    "channels": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "plugins": {
+          "type": "array",
+          "description": "External channel plugins loaded by package name.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "package"
+            ],
+            "properties": {
+              "package": {
+                "type": "string",
+                "description": "Package name exporting createChannelDriver(options)."
+              },
+              "id": {
+                "type": "string",
+                "description": "Optional channel id override."
+              },
+              "label": {
+                "type": "string",
+                "description": "Optional operator-facing label."
+              },
+              "config": {
+                "type": "object",
+                "description": "Plugin-owned config payload.",
+                "additionalProperties": true
+              }
+            }
+          }
+        }
+      }
+    },
+    "cron": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "jobs": {
+          "description": "Inline scheduled jobs. Folder-based cron jobs still merge from cron.dir.",
+          "examples": [
+            [
+              {
+                "id": "daily",
+                "expression": "0 8 * * *",
+                "prompt": "Summarize the overnight queue."
+              }
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+              "id",
+              "expression",
+              "prompt"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "enabled": {
+                "type": "boolean"
+              },
+              "expression": {
+                "type": "string"
+              },
+              "timezone": {
+                "type": "string"
+              },
+              "prompt": {
+                "type": "string"
+              },
+              "conversationId": {
+                "type": "string"
+              },
+              "maxRunMs": {
+                "type": "integer"
+              },
+              "notify": {
+                "type": "boolean"
+              },
+              "notifyConversationId": {
+                "type": "string"
+              },
+              "notifyFailureCooldownHours": {
+                "type": "integer"
+              },
+              "model": {
+                "type": "string"
+              },
+              "effort": {
+                "type": "string"
+              }
+            }
+          },
+          "default": []
+        },
+        "enabled": {
+          "description": "Enables the cron capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "dir": {
+          "description": "Configures dir for the cron section.",
+          "examples": [
+            "cron"
+          ],
+          "type": "string",
+          "default": "cron"
+        },
+        "expression": {
+          "description": "Configures expression for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "timezone": {
+          "description": "Configures timezone for the cron section.",
+          "examples": [
+            "UTC"
+          ],
+          "type": "string",
+          "default": "UTC"
+        },
+        "prompt": {
+          "description": "Configures prompt for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "conversationId": {
+          "description": "Configures conversationId for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "notify": {
+          "description": "Configures notify for the cron section.",
+          "examples": [
+            "false"
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "notifyConversationId": {
+          "description": "Configures notifyConversationId for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "notifyFailureCooldownHours": {
+          "description": "Configures notifyFailureCooldownHours for the cron section.",
+          "examples": [
+            6
+          ],
+          "type": "integer",
+          "default": 6
+        },
+        "model": {
+          "description": "Configures model for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "effort": {
+          "description": "Configures effort for the cron section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        }
+      }
+    },
+    "webhook": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "endpoints": {
+          "description": "Additional named webhook endpoints beyond webhook.path.",
+          "examples": [
+            [
+              {
+                "name": "triage",
+                "path": "/webhook/triage",
+                "prompt": "Triage this payload."
+              }
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+              "path"
+            ],
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "path": {
+                "type": "string"
+              },
+              "mode": {
+                "enum": [
+                  "sync",
+                  "async"
+                ]
+              },
+              "enabled": {
+                "type": "boolean"
+              },
+              "prompt": {
+                "type": "string"
+              },
+              "notify": {
+                "type": "boolean"
+              },
+              "notifyConversationId": {
+                "type": "string"
+              },
+              "model": {
+                "type": "string"
+              },
+              "effort": {
+                "type": "string"
+              }
+            }
+          },
+          "default": []
+        },
+        "enabled": {
+          "description": "Enables the webhook capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "dir": {
+          "description": "Configures dir for the webhook section.",
+          "examples": [
+            "webhook"
+          ],
+          "type": "string",
+          "default": "webhook"
+        },
+        "host": {
+          "description": "Configures host for the webhook section.",
+          "examples": [
+            "127.0.0.1"
+          ],
+          "type": "string",
+          "default": "127.0.0.1"
+        },
+        "port": {
+          "description": "Configures port for the webhook section.",
+          "examples": [
+            0
+          ],
+          "type": "integer",
+          "default": 0
+        },
+        "path": {
+          "description": "Configures path for the webhook section.",
+          "examples": [
+            "/webhook/invoke"
+          ],
+          "type": "string",
+          "default": "/webhook/invoke"
+        },
+        "prompt": {
+          "description": "Configures prompt for the webhook section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "notify": {
+          "description": "Configures notify for the webhook section.",
+          "examples": [
+            "example"
+          ],
+          "type": "boolean"
+        },
+        "notifyConversationId": {
+          "description": "Configures notifyConversationId for the webhook section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "model": {
+          "description": "Configures model for the webhook section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "effort": {
+          "description": "Configures effort for the webhook section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "allowNonLoopback": {
+          "description": "Configures allowNonLoopback for the webhook section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean"
+        },
+        "defaultMode": {
+          "description": "Configures defaultMode for the webhook section.",
+          "examples": [
+            "sync"
+          ],
+          "type": "string",
+          "default": "sync"
+        },
+        "retentionMs": {
+          "description": "Configures retentionMs for the webhook section.",
+          "examples": [
+            300000
+          ],
+          "type": "integer",
+          "default": 300000
+        },
+        "maxStoredRequests": {
+          "description": "Configures maxStoredRequests for the webhook section.",
+          "examples": [
+            "100"
+          ],
+          "type": "integer",
+          "default": 100
+        },
+        "maxRunMs": {
+          "description": "Configures maxRunMs for the webhook section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        }
+      }
+    },
+    "slack": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "shortcuts": {
+          "description": "Slack shortcut definitions handled by the Slack adapter.",
+          "examples": [
+            [
+              {
+                "callbackId": "triage",
+                "prompt": "Triage this Slack request."
+              }
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "default": []
+        },
+        "homeTab": {
+          "description": "Slack app home tab configuration.",
+          "examples": [
+            {
+              "enabled": true
+            }
+          ],
+          "type": "object",
+          "additionalProperties": true
+        },
+        "enabled": {
+          "description": "Enables the slack capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "botToken": {
+          "description": "Secret value for slack.botToken; prefer the env override.",
+          "examples": [
+            "env:MONO_AGENT_SLACK_BOT_TOKEN"
+          ],
+          "type": "string"
+        },
+        "appToken": {
+          "description": "Secret value for slack.appToken; prefer the env override.",
+          "examples": [
+            "env:MONO_AGENT_SLACK_APP_TOKEN"
+          ],
+          "type": "string"
+        },
+        "allowedChannelIds": {
+          "description": "Configures allowedChannelIds for the slack section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allowAllChannels": {
+          "description": "Configures allowAllChannels for the slack section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "botUserIds": {
+          "description": "Configures botUserIds for the slack section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "mentionTextAliases": {
+          "description": "Configures mentionTextAliases for the slack section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "stripMentionText": {
+          "description": "Configures stripMentionText for the slack section.",
+          "examples": [
+            "false"
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "heartbeatIntervalMs": {
+          "description": "Configures heartbeatIntervalMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "heartbeatTimeoutMs": {
+          "description": "Configures heartbeatTimeoutMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "reconnectInitialBackoffMs": {
+          "description": "Configures reconnectInitialBackoffMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "reconnectMaxBackoffMs": {
+          "description": "Configures reconnectMaxBackoffMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "reconnectStabilityMs": {
+          "description": "Configures reconnectStabilityMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "reconnectStartupGraceMs": {
+          "description": "Configures reconnectStartupGraceMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "drainDeadlineMs": {
+          "description": "Configures drainDeadlineMs for the slack section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        }
+      }
+    },
+    "telegram": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "commands": {
+          "description": "Telegram command definitions handled by the Telegram adapter.",
+          "examples": [
+            [
+              {
+                "command": "status",
+                "prompt": "Report current status."
+              }
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "default": []
+        },
+        "reactions": {
+          "description": "Telegram lifecycle reactions. The env override is boolean and toggles all states.",
+          "examples": [
+            {
+              "working": true,
+              "done": true,
+              "error": true
+            }
+          ],
+          "type": "object",
+          "additionalProperties": true
+        },
+        "quietHours": {
+          "description": "Quiet-hours rules for Telegram notifications.",
+          "examples": [
+            {
+              "timezone": "Europe/Amsterdam",
+              "start": "22:00",
+              "end": "07:00"
+            }
+          ],
+          "type": "object",
+          "additionalProperties": true
+        },
+        "enabled": {
+          "description": "Enables the telegram capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "botToken": {
+          "description": "Secret value for telegram.botToken; prefer the env override.",
+          "examples": [
+            "env:MONO_AGENT_TELEGRAM_BOT_TOKEN"
+          ],
+          "type": "string"
+        },
+        "allowedChatIds": {
+          "description": "Configures allowedChatIds for the telegram section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allowAllChats": {
+          "description": "Configures allowAllChats for the telegram section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "transport": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "ipFamily": {
+              "description": "Configures transport.ipFamily for the telegram section.",
+              "examples": [
+                "example"
+              ],
+              "type": "integer"
+            }
+          }
+        },
+        "pollWatchdogMs": {
+          "description": "Configures pollWatchdogMs for the telegram section.",
+          "examples": [
+            1
+          ],
+          "type": "integer"
+        },
+        "apiRoot": {
+          "description": "Configures apiRoot for the telegram section.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        },
+        "attachments": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxBytes": {
+              "description": "Configures attachments.maxBytes for the telegram section.",
+              "examples": [
+                1
+              ],
+              "type": "integer"
+            },
+            "downloadTimeoutMs": {
+              "description": "Configures attachments.downloadTimeoutMs for the telegram section.",
+              "examples": [
+                1
+              ],
+              "type": "integer"
+            },
+            "maxUploadBytes": {
+              "description": "Configures attachments.maxUploadBytes for the telegram section.",
+              "examples": [
+                1
+              ],
+              "type": "integer"
+            }
+          }
+        }
+      }
+    },
+    "openaiApi": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "description": "Enables the openaiApi capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "host": {
+          "description": "Configures host for the openaiApi section.",
+          "examples": [
+            "127.0.0.1"
+          ],
+          "type": "string",
+          "default": "127.0.0.1"
+        },
+        "port": {
+          "description": "Configures port for the openaiApi section.",
+          "examples": [
+            0
+          ],
+          "type": "integer",
+          "default": 0
+        },
+        "basePath": {
+          "description": "Configures basePath for the openaiApi section.",
+          "examples": [
+            "/v1"
+          ],
+          "type": "string",
+          "default": "/v1"
+        },
+        "allowNonLoopback": {
+          "description": "Configures allowNonLoopback for the openaiApi section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "apiKey": {
+          "description": "Secret value for openaiApi.apiKey; prefer the env override.",
+          "examples": [
+            "env:MONO_AGENT_OPENAI_API_KEY"
+          ],
+          "type": "string"
+        },
+        "modelId": {
+          "description": "Configures modelId for the openaiApi section.",
+          "examples": [
+            "agent"
+          ],
+          "type": "string",
+          "default": "agent"
+        }
+      }
+    },
+    "tui": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "description": "Enables the tui capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": true
+        },
+        "host": {
+          "description": "Configures host for the tui section.",
+          "examples": [
+            "127.0.0.1"
+          ],
+          "type": "string",
+          "default": "127.0.0.1"
+        },
+        "port": {
+          "description": "Configures port for the tui section.",
+          "examples": [
+            0
+          ],
+          "type": "integer",
+          "default": 0
+        },
+        "basePath": {
+          "description": "Configures basePath for the tui section.",
+          "examples": [
+            "/tui"
+          ],
+          "type": "string",
+          "default": "/tui"
+        },
+        "allowNonLoopback": {
+          "description": "Configures allowNonLoopback for the tui section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "apiKey": {
+          "description": "Secret value for tui.apiKey; prefer the env override.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        }
+      }
+    },
+    "live": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "description": "Enables the live capability.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": true
+        },
+        "host": {
+          "description": "Configures host for the live section.",
+          "examples": [
+            "127.0.0.1"
+          ],
+          "type": "string",
+          "default": "127.0.0.1"
+        },
+        "port": {
+          "description": "Configures port for the live section.",
+          "examples": [
+            0
+          ],
+          "type": "integer",
+          "default": 0
+        },
+        "basePath": {
+          "description": "Configures basePath for the live section.",
+          "examples": [
+            "/live"
+          ],
+          "type": "string",
+          "default": "/live"
+        },
+        "allowNonLoopback": {
+          "description": "Configures allowNonLoopback for the live section.",
+          "examples": [
+            true
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "apiKey": {
+          "description": "Secret value for live.apiKey; prefer the env override.",
+          "examples": [
+            "example"
+          ],
+          "type": "string"
+        }
+      }
+    }
+  }
+}