evolcore 0.0.1 → 0.0.3

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

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.2.json",
+  "title": "RelationConfig (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema_version": { "type": "number", "default": 2, "x-merge": "scalar" },
+    "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"], "description": "人类私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "group": { "enum": ["interactive", "proactive"], "description": "群聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "nothuman": { "enum": ["interactive", "proactive"], "description": "非人类（agent）私聊场景的投递方式", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } } }, "additionalProperties": false, "description": "chatmode 场景覆盖表；关系级按键覆盖 agent 级。键封闭 private/group/nothuman，值枚举 interactive/proactive" },
+    "mentionMode": { "type": "string", "enum": ["disabled", "mention-only"], "x-merge": "scalar", "description": "@ 处理策略（顶层通用参数）；关系级不带 default，缺省继承 agent 级/schema 出厂值", "x-enumDescriptions": { "disabled": "处理所有消息", "mention-only": "只处理被 @ 的消息，未 @ 作引用上下文" } },
+    "model": { "type": "string", "x-merge": "scalar", "description": "主会话模型（顶层通用参数）；关系级覆盖 agent 级" },
+    "responseMode": { "type": "string", "x-merge": "scalar", "description": "响应模式 id（标量）；关系级覆盖 agent 级" },
+    "responseModeParams": { "type": "object", "x-merge": "dict", "description": "响应模式特有参数字典，按模式 id 分桶" },
+    "flush_delay": { "type": "number", "x-merge": "scalar" },
+    "debounce": { "type": "number", "x-merge": "scalar" },
+    "show_activities": { "type": "string", "enum": ["all", "text", "none"], "x-merge": "scalar", "description": "中间输出展示范围（仅对 interactive 私聊有意义）", "x-enumDescriptions": { "all": "文本 + activity", "text": "仅文本", "none": "全部静默" } },
+    "enable_rich_content": { "type": "boolean", "x-merge": "scalar" },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "description": "会话超时后的续接判定",
+      "properties": {
+        "enabled": { "type": "boolean", "description": "是否启用超时后的会话连续性判定" },
+        "after_hours": { "type": "number", "exclusiveMinimum": 0, "description": "距最后一条有效对话超过该小时数才触发判定" },
+        "effort": { "type": "string", "enum": ["low", "medium", "high", "xhigh", "max"], "description": "续接判定的推理强度", "x-enumDescriptions": { "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
+        "fallback_action": { "type": "string", "enum": ["continue", "new"], "description": "无法判定时的兜底动作", "x-enumDescriptions": { "continue": "继续沿用当前会话", "new": "开启新会话" } }
+      }
+    },
+    "group_venue_sync": { "type": "object", "x-merge": "dict" },
+    "render": { "type": "object", "x-merge": "dict" },
+    "sessionManifests": { "type": "object", "x-merge": "dict" },
+    "permissionMode": {
+      "type": "string",
+      "enum": ["auto", "bypass", "readonly", "request", "edit", "plan", "noask"],
+      "x-merge": "scalar",
+      "description": "工具调用的审批策略",
+      "x-enumDescriptions": {
+        "auto": "自动模式：常规 workspace 操作自动执行，已识别危险操作和扩权请求拒绝",
+        "bypass": "放行模式：沙箱内常规和普通审批命令自动执行，强危险 Git 和越界扩权仍需审批",
+        "readonly": "只读模式：明确只读工具自动执行，写入、普通 Shell 和未知工具拒绝；EC 命令仍由 daemon 鉴权",
+        "request": "请求模式：常规操作自动执行，危险 Bash 和沙箱扩权请求人工审批",
+        "edit": "历史值：运行时按 request 迁移",
+        "plan": "历史值：运行时按 readonly 迁移，并保留 Claude plan 工作流提示",
+        "noask": "历史值：运行时安全降级为 readonly"
+      }
+    },
+    "roles": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "assigned": {
+          "type": ["string", "null"],
+          "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$"
+        },
+        "members": {
+          "type": "object",
+          "additionalProperties": {
+            "type": ["string", "null"],
+            "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$"
+          }
+        }
+      }
+    },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}

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

@@ -0,0 +1,50 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.3.json",
+  "title": "RelationConfig (agents/{aid}/relations/{peerKey}/config.json)",
+  "x-logical-name": "relation-config",
+  "x-scope": "relation",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema_version": { "type": "number", "default": 3, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "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" },
+    "permissionMode": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "x-merge": "scalar", "description": "工具调用权限模式；历史 edit/plan/noask 在运行时安全迁移" },
+    "roles": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "assigned": { "type": ["string", "null"], "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$" },
+        "members": { "type": "object", "additionalProperties": { "type": ["string", "null"], "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$" } }
+      }
+    },
+    "extra_backup": { "type": "array", "items": { "type": "object" }, "x-merge": "list" }
+  }
+}

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

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.4.json",
+  "title": "RelationConfig (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", "default": 4, "x-merge": "scalar" },
+    "targetKind": { "type": "string", "enum": ["private", "group"], "x-merge": "scalar" },
+    "role": { "type": ["string", "null"], "pattern": "^(?!owner$)(?!admin$)[a-z0-9_-]+$", "x-merge": "scalar" },
+    "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.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/role-config.schema.1.json

@@ -0,0 +1,201 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "role-config.schema.1.json",
+  "title": "RoleConfig (agents/{aid}/roles/{roleId}.json)",
+  "description": "单个角色的独立策略配置。角色 ID 由文件名表达，本文件定义访问权限、行为字段约束、命令权限和用量额度。",
+  "x-logical-name": "role-config",
+  "x-scope": "role",
+  "x-permission-fields": [
+    { "value": "permissionMode", "label": "Permission Mode", "description": "角色的工具调用审批模式；只能由角色策略决定，关系级不可覆盖。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": false, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "readonly", "label": "Readonly" }, { "value": "auto", "label": "Auto" }, { "value": "request", "label": "Request" }, { "value": "bypass", "label": "Bypass" }] },
+    { "value": "chatmode.private", "label": "Private Chat Mode", "description": "角色在私聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
+    { "value": "chatmode.group", "label": "Group Chat Mode", "description": "角色在群聊场景中的响应方式策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "interactive", "label": "Interactive" }, { "value": "proactive", "label": "Proactive" }] },
+    { "value": "mentionMode", "label": "Group Mention Mode", "description": "角色在群聊场景中的提及响应策略。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "disabled", "label": "Disabled" }, { "value": "mention-only", "label": "Mention Only" }] },
+    { "value": "baseagents.claude.model", "label": "Claude Model", "description": "角色可使用的 Claude 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Claude models" }, { "value": "claude-opus-*", "label": "Claude Opus family" }, { "value": "claude-sonnet-*", "label": "Claude Sonnet family" }, { "value": "claude-haiku-*", "label": "Claude Haiku family" }] },
+    { "value": "baseagents.claude.effort", "label": "Claude Effort", "description": "角色使用 Claude 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }, { "value": "max", "label": "Max" }] },
+    { "value": "baseagents.codex.model", "label": "Codex Model", "description": "角色可使用的 Codex 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Codex models" }, { "value": "gpt-5.4*", "label": "GPT-5.4 family" }, { "value": "gpt-5.3-codex*", "label": "GPT-5.3 Codex family" }] },
+    { "value": "baseagents.codex.reasoning", "label": "Codex Reasoning", "description": "角色使用 Codex 时的默认推理强度及可覆盖范围。", "valueType": "enum", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "static-enum", "options": [{ "value": "auto", "label": "Auto" }, { "value": "low", "label": "Low" }, { "value": "medium", "label": "Medium" }, { "value": "high", "label": "High" }, { "value": "xhigh", "label": "Xhigh" }] },
+    { "value": "baseagents.gemini.model", "label": "Gemini Model", "description": "角色可使用的 Gemini 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Gemini models" }, { "value": "gemini-*", "label": "Gemini model family" }] },
+    { "value": "baseagents.hermes.model", "label": "Hermes Model", "description": "角色可使用的 Hermes 默认模型和模型白名单。", "valueType": "model", "hasOptions": true, "relationOverrideApplied": true, "constraintsApplied": true, "editable": true, "x-runtimeApplied": true, "x-optionsSource": "model-catalog", "patterns": [{ "value": "*", "label": "All Hermes models" }] }
+  ],
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "description", "permissions"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 1, "default": 1, "description": "角色配置 Schema 版本，固定为 1。" },
+    "description": { "type": "string", "description": "角色的用途、信任级别和授权边界说明。" },
+    "rank": { "type": "integer", "enum": [100, 300, 500, 700, 900], "description": "角色排序系数；内置角色固定，自定义角色固定为 500。旧文件缺省时由角色加载器补齐。" },
+    "allowAccess": { "type": "boolean", "default": true, "description": "是否允许该角色访问 Agent；缺省为 true。" },
+    "permissions": {
+      "type": "object",
+      "required": ["permissionMode"],
+      "description": "角色对运行时行为字段施加的默认值、关系级覆盖权及候选值约束。",
+      "properties": {
+        "permissionMode": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "工具调用审批模式策略；该策略必须存在且不允许关系级覆盖。",
+          "properties": {
+            "default": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "description": "该角色实际使用的工具调用审批模式。", "x-enumDescriptions": { "readonly": "只读模式：明确只读工具自动执行，写入、普通 Shell 和未知工具拒绝；EC 命令仍由 daemon 鉴权", "auto": "自动模式：常规 workspace 操作自动执行，已识别危险操作和扩权请求拒绝", "request": "请求模式：常规操作自动执行，危险 Bash 和沙箱扩权请求人工审批", "bypass": "放行模式：沙箱内常规和普通审批命令自动执行，强危险 Git 和越界扩权仍需审批" } },
+            "allowOverride": { "const": false, "default": false, "description": "权限模式禁止关系级覆盖，固定为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["readonly", "auto", "request", "bypass"], "description": "一个可列入权限模式候选集合的值。", "x-enumDescriptions": { "readonly": "只读模式", "auto": "自动模式", "request": "请求人工审批模式", "bypass": "受强制危险规则约束的放行模式" } }, "uniqueItems": true, "description": "保留的权限模式候选集合；permissionMode 当前不可由关系级覆盖，通常无需配置。" },
+            "reason": { "type": "string", "description": "采用该权限模式策略的可审计原因或管理备注。" }
+          }
+        },
+        "chatmode.private": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在私聊场景中的响应方式策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的私聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖私聊响应方式；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["interactive", "proactive"], "description": "一个可用于私聊响应方式覆盖的值。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "uniqueItems": true, "description": "允许关系级覆盖到的私聊响应方式白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该私聊响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "chatmode.group": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在群聊场景中的响应方式策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["interactive", "proactive"], "description": "未设置有效关系级覆盖时使用的群聊响应方式。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊响应方式；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["interactive", "proactive"], "description": "一个可用于群聊响应方式覆盖的值。", "x-enumDescriptions": { "interactive": "同步交互：输出即回复", "proactive": "主动推送：CLI 回复 + 思考投影" } }, "uniqueItems": true, "description": "允许关系级覆盖到的群聊响应方式白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该群聊响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "mentionMode": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色在群聊场景中的提及响应策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["disabled", "mention-only"], "description": "未设置有效关系级覆盖时使用的群聊提及响应策略。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖群聊提及响应策略；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["disabled", "mention-only"], "description": "一个可用于群聊提及响应策略覆盖的值。", "x-enumDescriptions": { "disabled": "不要求被提及即可响应", "mention-only": "仅在被明确提及时响应" } }, "uniqueItems": true, "description": "允许关系级覆盖到的群聊提及响应策略白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该群聊提及响应策略的可审计原因或管理备注。" }
+          }
+        },
+        "baseagents.claude.effort": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色使用 Claude runner 时的推理强度策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "角色默认的 Claude 推理强度。", "x-enumDescriptions": { "auto": "由 Claude runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 Claude 推理强度；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "description": "一个允许覆盖到的 Claude 推理强度。", "x-enumDescriptions": { "auto": "由 Claude runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高", "max": "最高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Claude 推理强度白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该 Claude 推理强度策略的可审计原因或管理备注。" }
+          }
+        },
+        "baseagents.codex.reasoning": {
+          "type": "object",
+          "required": ["default", "allowOverride"],
+          "additionalProperties": false,
+          "description": "该角色使用 Codex runner 时的推理强度策略。",
+          "properties": {
+            "default": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "角色默认的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖 Codex 推理强度；缺省为 false。" },
+            "allowedValues": { "type": "array", "items": { "type": "string", "enum": ["auto", "low", "medium", "high", "xhigh"], "description": "一个允许覆盖到的 Codex 推理强度。", "x-enumDescriptions": { "auto": "由 Codex runner 自动选择", "low": "低", "medium": "中", "high": "高", "xhigh": "很高" } }, "uniqueItems": true, "description": "允许关系级覆盖到的 Codex 推理强度白名单；若提供，必须包含 default。" },
+            "reason": { "type": "string", "description": "采用该 Codex 推理强度策略的可审计原因或管理备注。" }
+          }
+        }
+      },
+      "patternProperties": {
+        "^baseagents\\.[a-z0-9_-]+\\.model$": {
+          "type": "object",
+          "required": ["default", "allowOverride", "allowedModels"],
+          "additionalProperties": false,
+          "description": "指定 base agent 的角色模型策略；默认模型必须匹配 allowedModels。",
+          "properties": {
+            "default": { "type": "string", "minLength": 1, "description": "该角色默认使用的模型标识；必须被 allowedModels 中的精确值或通配符允许。" },
+            "allowOverride": { "type": "boolean", "default": false, "description": "是否允许该角色在关系级覆盖模型；缺省为 false。" },
+            "allowedModels": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "description": "一个允许使用的模型标识或以 * 表达的通配符模式。" }, "uniqueItems": true, "description": "该角色可用的模型白名单；支持通配符，且至少包含一个条目。" },
+            "reason": { "type": "string", "description": "采用该角色模型策略的可审计原因或管理备注。" }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "commandPermissions": {
+      "type": "object",
+      "x-optionsSource": "operation-catalog",
+      "description": "按 operation 标识定义角色的命令执行权限；候选 operation 来自运行时 operation catalog。",
+      "propertyNames": { "type": "string", "minLength": 1, "description": "非空 operation 标识，支持精确名称及系统识别的通配规则。" },
+      "additionalProperties": {
+        "type": "object",
+        "required": ["allow"],
+        "additionalProperties": false,
+        "description": "一个 operation 的角色授权规则。",
+        "properties": {
+          "allow": { "type": "boolean", "description": "是否允许该角色执行匹配的 operation。" },
+          "dangerous": { "type": "boolean", "default": false, "description": "是否将该授权规则标记为危险操作规则；危险操作还会应用额外安全约束。" },
+          "scopes": {
+            "type": "array",
+            "items": { "type": "string", "enum": ["relation", "role", "agent", "process", "filesystem", "control", "raw-cli"], "description": "该命令权限适用的一个配置或执行作用域。", "x-enumDescriptions": { "relation": "当前 Agent 与对端的关系配置域", "role": "独立角色注册表或角色策略配置域", "agent": "单个 Agent 的配置与生命周期域", "process": "EvolCore 进程级配置与运行域", "filesystem": "受控文件系统操作域", "control": "控制面命令和管理通道域", "raw-cli": "未经结构化 operation 封装的原始 CLI 执行域" } },
+            "uniqueItems": true,
+            "description": "该授权规则允许生效的作用域白名单；未配置时由 operation 自身和鉴权器决定。"
+          },
+          "constraints": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "operation 级附加约束，例如对端、Agent、群聊、控制通道、参数或工作目录限制。",
+            "properties": {
+              "ownPeerOnly": { "type": "boolean" },
+              "ownAgentOnly": { "type": "boolean" },
+              "targetCurrentAgentOnly": { "type": "boolean" },
+              "requireAgentAdmin": { "type": "boolean" },
+              "requireAgentOwner": { "type": "boolean" },
+              "privateOnly": { "type": "boolean" },
+              "groupOnly": { "type": "boolean" },
+              "requireDaemonOwner": { "type": "boolean" },
+              "requireControlChannel": { "type": "boolean" },
+              "requireExplicitDangerousGrant": { "type": "boolean" },
+              "currentRelationOnly": { "type": "boolean" },
+              "requireFieldOverride": { "type": "string", "minLength": 1 },
+              "configFieldPolicy": { "type": "string", "enum": ["behavior-read", "role-overridable-write"] },
+              "allowedArgs": { "$ref": "#/definitions/argumentConstraints" },
+              "deniedArgs": { "$ref": "#/definitions/argumentConstraints" },
+              "forbiddenFlags": { "$ref": "#/definitions/stringList" },
+              "allowedConfigKeys": { "$ref": "#/definitions/stringList" },
+              "allowedPrefixes": { "$ref": "#/definitions/stringList" },
+              "timeoutMs": { "type": "integer", "minimum": 0 },
+              "outputLimitBytes": { "type": "integer", "minimum": 0 },
+              "cwdPolicy": { "type": "string", "enum": ["agentProject", "evolcoreHome", "none"] },
+              "envAllowlist": { "$ref": "#/definitions/stringList" }
+            }
+          },
+          "reason": { "type": "string", "description": "采用该命令权限规则的可审计原因或管理备注。" }
+        }
+      }
+    },
+    "usageLimits": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "角色用量额度策略；enabled 未开启或未配置时不启用额度限制。",
+      "properties": {
+        "enabled": { "type": "boolean", "default": false, "description": "是否启用该角色的用量额度限制；缺省为 false。" },
+        "resetMode": { "type": "string", "enum": ["never", "daily", "weekly", "monthly"], "description": "用量额度的重置周期。", "x-enumDescriptions": { "never": "累计额度，从不自动重置", "daily": "每日重置", "weekly": "每周重置", "monthly": "每月重置" } },
+        "currency": { "type": "string", "enum": ["CNY", "USD"], "description": "额度金额使用的计价货币。", "x-enumDescriptions": { "CNY": "人民币", "USD": "美元" } },
+        "limitAmount": { "type": ["number", "null"], "minimum": 0, "description": "额度上限金额；非负数表示上限，null 表示不限。" },
+        "costBasis": { "type": "string", "enum": ["gateway", "official"], "description": "额度统计采用的模型计费口径。", "x-enumDescriptions": { "gateway": "按实际网关计费价统计", "official": "按模型提供商官方定价统计" } },
+        "scope": { "type": "string", "enum": ["subject", "role"], "description": "额度累计和重置的统计范围。", "x-enumDescriptions": { "subject": "按对端主体分别统计", "role": "同一角色的所有主体共享统计" } }
+      }
+    }
+  },
+  "definitions": {
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "argumentConstraints": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": ["string", "number", "boolean"] }
+      }
+    }
+  }
+}

package/kits/schemas/role-registry.schema.1.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "role-registry.schema.1.json",
+  "title": "RoleRegistry (agents/{aid}/roles/index.json)",
+  "description": "Agent 的角色注册表。声明可加载的角色 ID，并配置未显式分配角色时私聊和群聊使用的默认角色。",
+  "x-logical-name": "role-registry",
+  "x-scope": "role",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema_version", "roles", "defaultRoles"],
+  "properties": {
+    "$schema_version": { "type": "number", "const": 1, "default": 1, "x-merge": "scalar", "description": "角色注册表 Schema 版本，固定为 1。" },
+    "roles": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "contains": { "const": "visitor", "description": "注册表必须包含 visitor，以保证始终存在低权限安全回退角色。" },
+      "items": { "type": "string", "pattern": "^[a-z0-9_-]+$", "description": "一个已注册角色 ID；对应 roles/{roleId}.json 或同名内置模板。" },
+      "x-merge": "list",
+      "description": "允许加载、展示和分配的角色 ID 列表；未注册的角色文件不产生运行时权限。"
+    },
+    "defaultRoles": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["private", "group"],
+      "default": { "private": null, "group": null },
+      "description": "未显式分配角色时，私聊和群聊分别采用的默认角色；null 表示不自动授予角色。",
+      "properties": {
+        "private": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "default": null, "description": "私聊默认角色；必须已注册且不能为 owner。" },
+        "group": { "type": ["string", "null"], "pattern": "^(?!owner$)[a-z0-9_-]+$", "default": null, "description": "群聊默认角色；必须已注册且不能为 owner。" }
+      },
+      "x-merge": "dict"
+    }
+  }
+}

package/kits/schemas/single-session.schema.1.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "single-session.schema.1.json",
+  "title": "SingleSessionParams (responseModeParams['single-session'])",
+  "x-logical-name": "single-session",
+  "x-scope": "mode",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pre_tool_1stmsgchk": {
+      "type": "boolean",
+      "enum": [true, false],
+      "default": true,
+      "description": "proactive 首工具表态检查（仅 chatmode=proactive 生效）：首个工具调用前必须先向对端表态，否则拦截。",
+      "x-enumDescriptions": {
+        "true": "启用：首工具前必须先发送消息或文件",
+        "false": "禁用：允许直接调用工具"
+      }
+    },
+    "tool_use_reminder": {
+      "type": "boolean",
+      "enum": [true, false],
+      "default": true,
+      "description": "proactive 工具汇报提醒（仅 chatmode=proactive 生效）：启用队列未读提醒 + 每 10 次工具调用的汇报提醒。",
+      "x-enumDescriptions": {
+        "true": "启用：自动汇报工具使用情况",
+        "false": "禁用：静默执行工具"
+      }
+    }
+  }
+}

package/kits/templates/bootstrap-welcome.md

@@ -0,0 +1,15 @@
+你好，我是 {{agentName}}。
+
+我刚刚完成连接，需要先和你确认我的基础信息，然后再进入正常工作状态。
+
+请帮我确认三项内容：
+1. 显示名：你希望我叫什么？
+2. 简介：我主要负责什么？一句到两句话即可。
+3. 标签：给我 3 到 6 个标签，例如 `代码审查`、`客服助手`、`项目管理`。
+
+当前信息：
+- AID: {{agentAid}}
+- 渠道: {{channel}}
+- Baseagent: {{baseagent}}
+
+你可以直接按上面的三项回复。

package/kits/templates/message-fragments/handoff-request-to-target.md

@@ -0,0 +1,13 @@
+说明：
+- 跨会话请求回复，仅本端可见。
+- 请结合下方内容理解当前对端回复。
+- 当前回流策略：{{handoffReturnPolicy}}
+- 若策略为 required 且当前回复足以处理请求，使用：`ec handoff return {{handoffId}} "<完整回流内容>"`
+- 若策略为 none 且当前回复已处理请求，使用：`ec handoff return {{handoffId}}`
+- 若回复不足，不要执行 return。
+
+此前发给当前对端的内容：
+{{handoffPreviousContent}}
+
+当前对端回复内容：
+{{content}}

package/kits/templates/message-fragments/handoff-response-to-origin.md

@@ -0,0 +1,10 @@
+说明：
+- 跨会话结果回流，仅本端可见。
+- 这是此前本会话请求的返回结果，请结合当前上下文回复当前对端。
+- 不要提及 handoff 或内部路由机制。
+
+此前跨会话请求内容：
+{{handoffPreviousContent}}
+
+回流内容：
+{{content}}

package/kits/templates/message-fragments/inject-default.md

@@ -0,0 +1,2 @@
+‹owner 提示 · 已验证 · {{injectTime}}{{?ownerAid}} · from:{{ownerAid}}{{/}}›（仅你可见，对端无感；请据此决定如何回复对端）
+{{content}}

package/kits/templates/message-fragments/item.md

@@ -0,0 +1,2 @@
+‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?peerRole}} · role:{{peerRole}}{{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?encrypted=true}} · 🔒密文{{/}}{{?encrypted=false}} · ✉️明文{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
+{{content}}

package/kits/templates/roles/admin.json

@@ -0,0 +1,9 @@
+{
+  "$schema_version": 1,
+  "description": "Agent administrator with guarded management authority",
+  "rank": 700,
+  "allowAccess": true,
+  "permissions": {
+    "permissionMode": { "default": "request", "allowOverride": false }
+  }
+}