evolcore 0.0.2 → 0.0.4

package/kits/schemas/contact-book.schema.2.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "contact-book.schema.2.json",
+  "title": "ContactBook v2 (agents/{aid}/contact.json)",
+  "x-logical-name": "contact-book",
+  "x-scope": "contact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "contacts"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 2, "default": 2, "x-merge": "scalar" },
+    "contacts": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "AID 联系人字典；群和无 AID 对端不进入 Contact Book",
+      "propertyNames": {
+        "pattern": "^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\\.){2,}[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "displayName": { "type": "string", "description": "显示名" },
+          "aliases": {
+            "type": "array",
+            "description": "跨渠道身份映射，格式 <channelKey>:<urlEncode(peerId)>",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_-]+#([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\\.){2,}[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?#[A-Za-z0-9_-]+:[^:]+$"
+            },
+            "uniqueItems": true
+          },
+          "status": {
+            "type": "string",
+            "enum": ["active", "blocked", "pending"],
+            "default": "active",
+            "description": "AID 联系状态；blocked 只阻断该 AID 的 AUN 私聊"
+          }
+        }
+      }
+    }
+  }
+}

package/kits/schemas/contact-book.schema.3.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "contact-book.schema.3.json",
+  "title": "ContactBook v3 (agents/{aid}/contact.json)",
+  "x-logical-name": "contact-book",
+  "x-scope": "contact",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "contacts"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 3, "default": 3, "x-merge": "scalar" },
+    "contacts": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "AID 联系人字典；群和无 AID 对端不进入 Contact Book",
+      "propertyNames": {
+        "pattern": "^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\\.){2,}[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "displayName": { "type": "string", "description": "显示名" },
+          "aliases": {
+            "type": "array",
+            "description": "跨渠道身份映射，格式 <channelKey>:<urlEncode(peerId)>",
+            "items": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_-]+#([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\\.){2,}[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?#[A-Za-z0-9_-]+:[^:]+$"
+            },
+            "uniqueItems": true
+          },
+          "status": {
+            "type": "string",
+            "enum": ["active", "blocked", "pending", "declined"],
+            "default": "active"
+          },
+          "pendingRequest": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "submittedAt", "expiresAt"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^creq_[A-Za-z0-9_-]{8,}$" },
+              "submittedAt": { "type": "string", "minLength": 1 },
+              "expiresAt": { "type": "string", "minLength": 1 }
+            }
+          },
+          "declinedAt": { "type": "string", "minLength": 1 }
+        },
+        "allOf": [
+          {
+            "if": { "properties": { "status": { "const": "pending" } }, "required": ["status"] },
+            "then": { "required": ["pendingRequest"], "not": { "required": ["declinedAt"] } }
+          },
+          {
+            "if": { "properties": { "status": { "const": "declined" } }, "required": ["status"] },
+            "then": { "required": ["declinedAt"], "not": { "required": ["pendingRequest"] } }
+          },
+          {
+            "if": { "properties": { "status": { "enum": ["active", "blocked"] } }, "required": ["status"] },
+            "then": { "not": { "anyOf": [{ "required": ["pendingRequest"] }, { "required": ["declinedAt"] }] } }
+          }
+        ]
+      }
+    }
+  }
+}

package/kits/schemas/daemon.schema.1.json

@@ -38,10 +38,10 @@
     },
     "aun": {
       "type": "object",
-      "description": "keystore 加密种子等（值用 ${VAR} 引用）",
+      "description": "AUN 进程配置",
       "x-merge": "dict",
       "properties": {
-        "encryptionSeed": { "type": ["string", "null"], "description": "keystore 加密种子（用 ${VAR} 引用，勿明文）" }
+        "encryptionSeed": { "type": ["string", "null"], "description": "已废弃兼容字段；EvolCore 固定使用内置值，检测到其他值时拒绝启动并提示联系管理人员" }
       }
     },
     "serviceProxy": {
@@ -66,6 +66,7 @@
       "properties": {
         "enabled": { "type": "boolean", "default": true, "description": "是否启用空闲监控" },
         "timeout": { "type": "number", "default": 120, "description": "空闲超时秒数" },
+        "retryAttemptTimeout": { "type": "number", "description": "API 重试尝试连续无事件时的超时秒数；未设置时继承 timeout" },
         "maxExecutionTime": { "type": "number", "default": 3600, "description": "单个任务总执行时限（秒），等待审批期间仍继续计时" }
       }
     },

package/kits/schemas/daemon.schema.2.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "daemon.schema.2.json",
+  "title": "ProcessConfig (daemon.json)",
+  "description": "进程级配置：daemon 自身运行配置，链外独立作用域，不进覆盖链。",
+  "x-logical-name": "daemon",
+  "x-scope": "process",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "default": 2, "x-merge": "scalar" },
+    "aid": { "type": "string", "description": "daemon 默认身份 AID", "x-merge": "scalar" },
+    "owners": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "进程控制面鉴权名单（谁能远程管 daemon）",
+      "x-merge": "list"
+    },
+    "debug": {
+      "type": "object",
+      "description": "进程级调试配置",
+      "x-merge": "dict",
+      "properties": {
+        "eckSnapshots": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照"
+        }
+      }
+    },
+    "tunnel": {
+      "type": "object",
+      "description": "内网穿透配置",
+      "x-merge": "dict",
+      "properties": {
+        "targets": { "type": "array", "description": "穿透目标列表", "items": { "type": "object" } }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "AUN 进程配置",
+      "x-merge": "dict",
+      "properties": {
+        "encryptionSeed": { "type": ["string", "null"], "description": "已废弃兼容字段；EvolCore 固定使用内置值，检测到其他值时拒绝启动并提示联系管理人员" },
+        "minEvolVersion": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+          "description": "AUN Menu 允许的最低 Evol 客户端版本；省略时不限制"
+        },
+        "menuTokenRequired": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否要求普通 AUN Menu 请求携带有效 menu_token；默认 false"
+        }
+      }
+    },
+    "serviceProxy": {
+      "type": "object",
+      "description": "AUN Service Proxy：把一个本地 HTTP/WS 服务暴露到 AUN 网络",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 Service Proxy" },
+        "services": { "type": "array", "description": "暴露到 AUN 的本地服务列表", "items": { "type": "object" } }
+      }
+    },
+    "configSnapshots": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否自动维护配置快照、启动日志和自检回落",
+      "x-merge": "scalar"
+    },
+    "idleMonitor": {
+      "type": "object",
+      "description": "流式输出空闲监控配置",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true, "description": "是否启用空闲监控" },
+        "timeout": { "type": "number", "default": 120, "description": "空闲超时秒数" },
+        "retryAttemptTimeout": { "type": "number", "description": "API 重试尝试连续无事件时的超时秒数；未设置时继承 timeout" },
+        "maxExecutionTime": { "type": "number", "default": 3600, "description": "单个任务总执行时限（秒），等待审批期间仍继续计时" }
+      }
+    },
+    "ecweb": {
+      "type": "object",
+      "description": "web 控制台开关/端口",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 web 控制台" },
+        "port": { "type": "number", "description": "web 控制台监听端口" }
+      }
+    },
+    "watch": {
+      "type": "object",
+      "description": "日志监听配置",
+      "x-merge": "dict",
+      "properties": {
+        "logTypes": { "type": "array", "description": "要监听的日志类型", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/kits/schemas/daemon.schema.3.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "daemon.schema.3.json",
+  "title": "ProcessConfig v3 (daemon.json)",
+  "description": "进程级配置：daemon 自身运行配置，链外独立作用域，不进覆盖链。",
+  "x-logical-name": "daemon",
+  "x-scope": "process",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 3, "default": 3, "x-merge": "scalar" },
+    "aid": { "type": "string", "description": "daemon 默认身份 AID", "x-merge": "scalar" },
+    "owners": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "进程控制面鉴权名单（谁能远程管 daemon）",
+      "x-merge": "list"
+    },
+    "debug": {
+      "type": "object",
+      "description": "进程级调试配置；唯一合法来源为 daemon.json，不参与 Agent 覆盖链",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "logLevel": {
+          "type": "string",
+          "enum": ["DEBUG", "INFO", "WARN", "ERROR"],
+          "description": "daemon 日志级别"
+        },
+        "flusherDiag": {
+          "type": "boolean",
+          "description": "是否启用消息 flusher 诊断"
+        },
+        "aunTrace": {
+          "type": "boolean",
+          "description": "是否记录 AUN 协议 trace"
+        },
+        "aunSdkLog": {
+          "type": "boolean",
+          "description": "是否启用 AUN SDK 调试日志"
+        },
+        "upmsg": {
+          "type": "boolean",
+          "description": "是否向 Agent owner 发送 daemon 上线通知"
+        },
+        "eckSnapshots": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否写入可能包含敏感上下文的 ECK 旁路调试快照"
+        }
+      }
+    },
+    "tunnel": {
+      "type": "object",
+      "description": "内网穿透配置",
+      "x-merge": "dict",
+      "properties": {
+        "targets": { "type": "array", "description": "穿透目标列表", "items": { "type": "object" } }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "AUN 进程配置",
+      "x-merge": "dict",
+      "properties": {
+        "encryptionSeed": { "type": ["string", "null"], "description": "已废弃兼容字段；EvolCore 固定使用内置值，检测到其他值时拒绝启动并提示联系管理人员" },
+        "minEvolVersion": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$",
+          "description": "AUN Menu 允许的最低 Evol 客户端版本；省略时不限制"
+        },
+        "menuTokenRequired": {
+          "type": "boolean",
+          "default": false,
+          "description": "是否要求普通 AUN Menu 请求携带有效 menu_token；默认 false"
+        }
+      }
+    },
+    "serviceProxy": {
+      "type": "object",
+      "description": "AUN Service Proxy：把一个本地 HTTP/WS 服务暴露到 AUN 网络",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 Service Proxy" },
+        "services": { "type": "array", "description": "暴露到 AUN 的本地服务列表", "items": { "type": "object" } }
+      }
+    },
+    "configSnapshots": {
+      "type": "boolean",
+      "default": true,
+      "description": "是否自动维护配置快照、启动日志和自检回落",
+      "x-merge": "scalar"
+    },
+    "idleMonitor": {
+      "type": "object",
+      "description": "流式输出空闲监控配置",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true, "description": "是否启用空闲监控" },
+        "timeout": { "type": "number", "default": 120, "description": "空闲超时秒数" },
+        "retryAttemptTimeout": { "type": "number", "description": "API 重试尝试连续无事件时的超时秒数；未设置时继承 timeout" },
+        "maxExecutionTime": { "type": "number", "default": 3600, "description": "单个任务总执行时限（秒），等待审批期间仍继续计时" }
+      }
+    },
+    "ecweb": {
+      "type": "object",
+      "description": "web 控制台开关/端口",
+      "x-merge": "dict",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用 web 控制台" },
+        "port": { "type": "number", "description": "web 控制台监听端口" }
+      }
+    },
+    "watch": {
+      "type": "object",
+      "description": "日志监听配置",
+      "x-merge": "dict",
+      "properties": {
+        "logTypes": { "type": "array", "description": "要监听的日志类型", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/kits/schemas/defaults.schema.2.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "defaults.schema.2.json",
+  "title": "DefaultsConfig v2 (agents/defaults.json)",
+  "description": "全局默认配置。覆盖链最低层。",
+  "x-logical-name": "defaults",
+  "x-scope": "defaults",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 2, "default": 2, "x-merge": "scalar" },
+    "models": {
+      "type": "object",
+      "description": "模型配置",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string", "description": "全局默认模型" },
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "全局模型白名单"
+        }
+      }
+    },
+    "active_baseagent": {
+      "type": "string",
+      "description": "当前活跃的 base agent（claude/codex/gemini）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "scalar"
+    },
+    "baseagents": {
+      "type": "object",
+      "description": "各 base agent 配置（model/effort/apiKey/baseUrl 等）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "dict"
+    },
+    "projects": {
+      "type": "object",
+      "description": "项目路径配置",
+      "x-merge": "dict",
+      "properties": {
+        "rootPath": { "type": "string", "description": "全局项目根路径" },
+        "defaultPath": { "type": "string", "description": "全局默认项目路径" }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "全局 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "debug": {
+      "type": "object",
+      "description": "全局调试配置",
+      "x-merge": "dict",
+      "properties": {
+        "logLevel": { "type": "string", "enum": ["DEBUG", "INFO", "WARN", "ERROR"], "description": "日志级别", "x-enumDescriptions": { "DEBUG": "调试：最详细", "INFO": "信息：常规运行日志", "WARN": "警告：仅警告及以上", "ERROR": "错误：仅错误" } },
+        "flusherDiag": { "type": "boolean" },
+        "aunTrace": { "type": "boolean" },
+        "aunSdkLog": { "type": "boolean" },
+        "upmsg": { "type": "boolean" }
+      }
+    },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "响应模式特有参数的全局默认字典，按模式 id 分桶：{ [modeId]: {...} }"
+    },
+    "config": { "type": "object", "x-merge": "dict" },
+    "session_renew": {
+      "type": "object",
+      "description": "会话超时后的续接判定策略，默认关闭",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    }
+  }
+}

package/kits/schemas/defaults.schema.3.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "defaults.schema.3.json",
+  "title": "DefaultsConfig v3 (agents/defaults.json)",
+  "description": "全局默认配置。覆盖链最低层；进程级 debug 仅允许配置在 daemon.json。",
+  "x-logical-name": "defaults",
+  "x-scope": "defaults",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 3, "default": 3, "x-merge": "scalar" },
+    "models": {
+      "type": "object",
+      "description": "模型配置",
+      "x-merge": "dict",
+      "properties": {
+        "default": { "type": "string", "description": "全局默认模型" },
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "全局模型白名单"
+        }
+      }
+    },
+    "active_baseagent": {
+      "type": "string",
+      "description": "当前活跃的 base agent（claude/codex/gemini）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "scalar"
+    },
+    "baseagents": {
+      "type": "object",
+      "description": "各 base agent 配置（model/effort/apiKey/baseUrl 等）。暂存于此，待权限体系实现后迁移。",
+      "x-merge": "dict"
+    },
+    "projects": {
+      "type": "object",
+      "description": "项目路径配置",
+      "x-merge": "dict",
+      "properties": {
+        "rootPath": { "type": "string", "description": "全局项目根路径" },
+        "defaultPath": { "type": "string", "description": "全局默认项目路径" }
+      }
+    },
+    "aun": {
+      "type": "object",
+      "description": "全局 AUN 配置",
+      "x-merge": "dict",
+      "properties": {
+        "keystorePath": { "type": "string" },
+        "encryptionSeed": { "type": "string" },
+        "gatewayUrl": { "type": "string" }
+      }
+    },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "响应模式特有参数的全局默认字典，按模式 id 分桶：{ [modeId]: {...} }"
+    },
+    "config": { "type": "object", "x-merge": "dict" },
+    "session_renew": {
+      "type": "object",
+      "description": "会话超时后的续接判定策略，默认关闭",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "default": 24, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "default": "continue", "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    }
+  }
+}

package/kits/schemas/relation-config.schema.5.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.5.json",
+  "title": "RelationConfig v5 (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "anyOf": [
+      { "required": ["permissionMode"] },
+      { "required": ["roles"] }
+    ]
+  },
+  "properties": {
+    "$schema_version": { "type": "number", "const": 5, "default": 5, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "role": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "x-merge": "scalar", "description": "关系角色；允许 admin/member/visitor/自定义角色，禁止 owner" },
+    "active_baseagent": { "type": "string", "x-merge": "scalar" },
+    "models": { "type": "object", "x-merge": "dict" },
+    "baseagents": { "type": "object", "x-merge": "dict" },
+    "chatmode": { "type": "object", "x-merge": "dict", "properties": { "private": { "enum": ["interactive", "proactive"] }, "group": { "enum": ["interactive", "proactive"] }, "nothuman": { "enum": ["interactive", "proactive"] } }, "additionalProperties": false },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "x-merge": "scalar" },
+    "model": { "type": "string", "x-merge": "scalar" },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": { "type": "object", "x-merge": "dict" },
+    "flush_delay": { "type": "number", "x-merge": "scalar" },
+    "debounce": { "type": "number", "x-merge": "scalar" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "x-merge": "scalar" },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar" },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0 },
+        "effort": { "type": "string", "enum": ["low", "medium", "high", "xhigh", "max"] },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"] }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}

package/kits/schemas/relation-config.schema.6.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.6.json",
+  "title": "RelationConfig v6 (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "anyOf": [
+      { "required": ["permissionMode"] },
+      { "required": ["roles"] }
+    ]
+  },
+  "properties": {
+    "$schema_version": { "type": "number", "const": 6, "default": 6, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "role": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "x-merge": "scalar", "description": "关系角色；允许 admin/member/visitor/自定义角色，禁止 owner" },
+    "active_baseagent": { "type": "string", "x-merge": "scalar" },
+    "models": { "type": "object", "x-merge": "dict" },
+    "baseagents": { "type": "object", "x-merge": "dict" },
+    "chatmode": { "type": "object", "x-merge": "dict", "properties": { "private": { "enum": ["interactive", "proactive"] }, "group": { "enum": ["interactive", "proactive"] }, "nothuman": { "enum": ["interactive", "proactive"] } }, "additionalProperties": false },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "x-merge": "scalar" },
+    "model": { "type": "string", "x-merge": "scalar" },
+    "responseMode": { "type": "string", "x-merge": "scalar" },
+    "responseModeParams": { "type": "object", "x-merge": "dict" },
+    "flush_delay": { "type": "number", "x-merge": "scalar" },
+    "debounce": { "type": "number", "x-merge": "scalar" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "x-merge": "scalar" },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar" },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0 },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"] }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}