evolcore 0.0.21 → 0.0.22

package/kits/schemas/agent-config.schema.12.json

@@ -0,0 +1,427 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.12.json",
+  "title": "AgentConfig v12 (agents/{aid}/config.json)",
+  "description": "Agent v12 主配置。备用模型链只允许在 defaults.json 定义。",
+  "x-logical-name": "agent-config",
+  "x-scope": "agent",
+  "type": "object",
+  "additionalProperties": true,
+  "not": {
+    "description": "禁止旧权限字段和已迁移到 relation role 的 admins。",
+    "anyOf": [
+      {
+        "description": "禁止旧版顶层 permissionMode；权限模式由独立角色策略决定。",
+        "required": [
+          "permissionMode"
+        ]
+      },
+      {
+        "description": "禁止旧版内嵌 roles；角色定义和默认角色已迁移到独立 roles/ 配置域。",
+        "required": [
+          "roles"
+        ]
+      },
+      {
+        "description": "admin 关系身份由 AUN 私聊 relation role 管理。",
+        "required": [
+          "admins"
+        ]
+      },
+      {
+        "description": "debug 是 daemon 进程级配置，不进入 Agent 覆盖链。",
+        "required": [
+          "debug"
+        ]
+      }
+    ]
+  },
+  "required": [
+    "aid",
+    "channels"
+  ],
+  "properties": {
+    "$schema_version": {
+      "type": "number",
+      "const": 12,
+      "default": 12,
+      "x-merge": "scalar",
+      "description": "配置 Schema 版本；v12 添加 Agent 级群聊 slash 提及校验开关"
+    },
+    "aid": {
+      "type": "string",
+      "x-merge": "scalar",
+      "description": "Agent 的全局唯一身份标识"
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "x-merge": "scalar",
+      "description": "是否启用 Agent；缺省按启用处理"
+    },
+    "lifecycle": {
+      "type": "string",
+      "default": "active",
+      "enum": [
+        "created",
+        "bootstrapping",
+        "active"
+      ],
+      "x-merge": "scalar",
+      "description": "agent 生命周期状态；缺失时按 active 处理",
+      "x-enumDescriptions": {
+        "created": "已创建，尚未进入引导流程",
+        "bootstrapping": "引导中（初始化配置/身份）",
+        "active": "已激活，正常运行"
+      }
+    },
+    "initialized": {
+      "type": "boolean",
+      "x-merge": "scalar",
+      "description": "是否已完成 Agent 初始化流程"
+    },
+    "owners": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "description": "一个 Agent owner 的身份标识，通常为 AID。"
+      },
+      "uniqueItems": true,
+      "x-merge": "list",
+      "description": "Agent 所有者身份列表；用于 owner 级控制和通知"
+    },
+    "access": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "required": [
+        "policyMode",
+        "requestLimit"
+      ],
+      "properties": {
+        "policyMode": {
+          "type": "string",
+          "enum": [
+            "open",
+            "contacts",
+            "owners"
+          ],
+          "description": "私聊和群聊准入策略：开放、仅联系人或仅 Owner。"
+        },
+        "requestLimit": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "maxTimes",
+            "coolDown"
+          ],
+          "properties": {
+            "maxTimes": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100000,
+              "description": "每个 Agent、每个渠道实例在窗口内最多发送的准入控制消息数。"
+            },
+            "coolDown": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 86400,
+              "description": "准入控制消息限额的冷却窗口，单位秒。"
+            }
+          }
+        }
+      },
+      "description": "Agent 自身的消息准入策略；不参与 defaults 或 relation 覆盖链。"
+    },
+    "channels": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "allOf": [
+          {
+            "if": {
+              "properties": { "type": { "const": "aun" } },
+              "required": ["type"]
+            },
+            "then": { "not": { "required": ["gatewayUrl"] } }
+          }
+        ],
+        "description": "一个渠道实例配置；具体字段由渠道类型及其适配器定义。"
+      },
+      "x-merge": "list",
+      "description": "Agent 绑定的消息渠道实例列表"
+    },
+    "aun": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 级 AUN 通信配置",
+      "properties": {
+        "gatewayUrl": {
+          "not": {},
+          "description": "已移除；网关由 fastaun 缓存和 AID discovery 决定"
+        },
+        "defaultEncrypt": {
+          "not": {},
+          "description": "不支持在 Agent 配置；请使用 daemon.json.aun.defaultEncrypt"
+        }
+      }
+    },
+    "models": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 级模型别名、注册表或模型覆盖配置"
+    },
+    "active_baseagent": {
+      "type": "string",
+      "x-merge": "scalar",
+      "description": "默认使用的 base agent 标识，例如 claude 或 codex"
+    },
+    "baseagents": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "各 base agent 的模型、推理强度及运行参数；备用模型链只能在 defaults.json 配置。",
+      "additionalProperties": {
+        "not": {
+          "type": "object",
+          "required": ["fallbackModels"]
+        },
+        "properties": {
+          "headers": {
+            "type": "object",
+            "propertyNames": { "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$" },
+            "additionalProperties": { "type": "string", "pattern": "^[^\\u0000\\r\\n]*$" }
+          },
+          "queryParams": {
+            "type": "object",
+            "propertyNames": { "minLength": 1 },
+            "additionalProperties": { "type": "string" }
+          },
+          "auxiliaryModel": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Session Renew 语义连续性判断使用的 direct 辅助模型。"
+          },
+          "auxiliaryEffort": {
+            "type": "string",
+            "enum": ["low", "medium", "high", "xhigh", "max"],
+            "description": "Session Renew 辅助模型的可选推理强度。"
+          }
+        },
+        "dependencies": {
+          "auxiliaryEffort": ["auxiliaryModel"]
+        }
+      }
+    },
+    "projects": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 可用项目路径和项目选择配置"
+    },
+    "capabilities": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 能力开关及能力参数"
+    },
+    "readonlySourceDiagnostics": {
+      "type": "boolean",
+      "x-merge": "scalar",
+      "default": false,
+      "description": "允许只读会话在显式源码目录内执行受限、可证明只读的诊断查询"
+    },
+    "observable": {
+      "type": "boolean",
+      "default": true,
+      "x-merge": "scalar",
+      "description": "是否将 Agent 的入站和出站消息转发给 owners；默认开启"
+    },
+    "chatmode": {
+      "type": "object",
+      "x-merge": "dict",
+      "default": {
+        "private": "interactive",
+        "group": "proactive",
+        "nothuman": "proactive"
+      },
+      "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 场景默认表；出厂默认值即此 default（agent 级改默认，关系级按键覆盖）。键封闭 private/group/nothuman，值枚举 interactive/proactive"
+    },
+    "mentionMode": {
+      "type": "string",
+      "enum": [
+        "disabled",
+        "mention-only"
+      ],
+      "default": "disabled",
+      "x-merge": "scalar",
+      "description": "@ 处理策略（顶层通用参数）",
+      "x-enumDescriptions": {
+        "disabled": "处理所有消息",
+        "mention-only": "只处理被 @ 的消息，未 @ 作引用上下文"
+      }
+    },
+    "groupSlashRequireMentions": {
+      "type": "boolean",
+      "default": true,
+      "x-merge": "scalar",
+      "description": "AUN 群聊 slash 命令是否必须携带结构化 mentions；默认必须"
+    },
+    "model": {
+      "type": "string",
+      "x-merge": "scalar",
+      "description": "主会话模型（顶层通用参数）；无默认值，缺省时由响应模式/全局默认决定"
+    },
+    "responseMode": {
+      "type": "string",
+      "x-merge": "scalar",
+      "description": "响应模式 id（标量）；候选清单/默认值来自注册表，非 schema。关系级>agent级>注册表首选"
+    },
+    "responseModeParams": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "响应模式特有参数字典，按模式 id 分桶：{ [modeId]: {...} }"
+    },
+    "flush_delay": {
+      "type": "number",
+      "minimum": 0,
+      "default": 3,
+      "x-merge": "scalar",
+      "description": "流式出站消息的批量刷新间隔，单位为秒；默认 3 秒"
+    },
+    "debounce": {
+      "type": "number",
+      "minimum": 0,
+      "default": 0,
+      "x-merge": "scalar",
+      "description": "入站消息合并窗口，单位为秒；0 表示不合并，默认 0"
+    },
+    "show_activities": {
+      "type": "string",
+      "enum": [
+        "all",
+        "text",
+        "none"
+      ],
+      "default": "all",
+      "x-merge": "scalar",
+      "description": "中间输出展示范围（仅对 interactive 私聊有意义）",
+      "x-enumDescriptions": {
+        "all": "文本 + activity",
+        "text": "仅文本",
+        "none": "全部静默"
+      }
+    },
+    "session_renew": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "description": "会话超时后的续接判定",
+      "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": "开启新会话"
+          }
+        }
+      }
+    },
+    "group_venue_sync": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "AUN 群资源同步配置；控制规则文件路径、资源索引路径、条目/字节限制及刷新间隔。"
+    },
+    "groupRules": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "load",
+            "ignore"
+          ],
+          "default": "load",
+          "description": "是否读取并注入 AUN 群已发布的 /rules.md；默认 load。"
+        }
+      },
+      "description": "本 Agent 对 AUN 群规则的本地加载策略。"
+    },
+    "render": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "私聊、群聊及注入内容使用的渲染器标识配置。"
+    },
+    "sessionManifests": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "会话类型到 manifest 文件的映射，用于选择对应的系统提示词清单。"
+    },
+    "enable_rich_content": {
+      "type": "boolean",
+      "x-merge": "scalar",
+      "description": "是否允许渠道使用富内容消息；未设置时由渠道能力和运行时默认决定"
+    },
+    "extra_backup": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "一个额外备份规则，包含相对 path 和可选的文件匹配 pattern。"
+      },
+      "x-merge": "list",
+      "description": "配置快照需要额外包含的文件声明；不得指向 .env。"
+    }
+  }
+}

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

@@ -1,2 +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}}
+{{?isHandoff!=true}}{{content}}{{/}}

package/kits/templates/system-fragments/bootstrap.md

@@ -3,6 +3,7 @@ phase: bootstrapping
 
 这是 agent 生命周期的强制门禁。你正在进行首次自我设定；在完成前，唯一目标是和 owner 确认并写入基础名片信息，不处理普通任务。
 整个过程由你根据当前对话自主推进，不存在需要查询或维护的额外 bootstrap 子状态。
+系统已经在进入本阶段时向 owner 发送过固定的首条引导消息。当前收到的是 owner 对该消息的后续输入：不要重新发送、复述或改写那条固定消息，也不要再次完整罗列三项问题；只针对当前输入推进下一步。
 
 需要确认的字段：
 - name：显示名，简短清晰
@@ -17,7 +18,7 @@ phase: bootstrapping
 - 除这些 bootstrap 操作及向 owner 回复外，不得调用工具或执行命令。
 
 每轮处理规则：
-1. 首次需要候选值时，读取本地 agent.md 的 YAML frontmatter。已有且格式有效的 `name`、`description`、`tags` 是现有候选值：向 owner 回显并询问保持还是修改，不要求重新输入。空值、占位值或格式无效的字段视为缺失；`tags` 必须为 3 到 6 个非空标签。
+1. 首次需要候选值时，读取本地 agent.md 的 YAML frontmatter。已有且格式有效的 `name`、`description`、`tags` 是现有候选值：简短回显并询问保持还是修改，不要求重新输入。空值、占位值或格式无效的字段视为缺失；`tags` 必须为 3 到 6 个非空标签。
 2. 只把 owner 明确提供、修改、选择或确认的 `name`、`description`、`tags` 当作候选信息。普通任务内容、示例值和顺带提及的词语都不是候选信息，不得据此推断字段。
 3. 信息缺失、互相冲突或含义不清时，只追问缺失或有歧义的部分；保留此前已经明确或 owner 选择保持的内容。
 4. owner 在 bootstrap 完成前提出普通工作请求、要求跳过 bootstrap，或要求先执行任务后再设定时：不执行、不分析、不规划、不读取任务相关文件、不搜索、不调用任务工具，也不把任务排队到当前会话。只简短说明必须先完成首次设定，然后回显现有候选值并询问保持/修改，或只追问仍缺失的字段。

package/kits/templates/system-fragments/commands.md

@@ -1,5 +1,5 @@
 [commands] 当前场景可用命令集（前缀 ec，以自己 AID 为发送者；完整用法 Read 对应文档）
-遇到明确触发词（费用/用量/统计/创建agent/建群/查群等）优先查 INDEX.md 或直接试对应 ec 命令
+遇到明确触发词（费用/用量/统计/创建agent/建群/查群/群聊协作/任务分派等）优先查 INDEX.md 或直接试对应 ec 命令
 
 ec ctl     当前会话工具（主动发消息/文件、重命名、队列、项目路径、会话状态）  $KITS_DOCS/evolcore/ctl.md
 ec model   模型与推理强度管理（切模型/列模型/当前模型/模型详情/改强度/诊断网关）  $KITS_DOCS/evolcore/model.md
@@ -15,7 +15,7 @@ ec rpc     底层 AUN RPC 逃生通道                      $KITS_DOCS/evolcore/
 ec msg     私聊收发消息（回复/拉取/撤回）            $KITS_DOCS/evolcore/msg.md
 {{/}}
 {{?selfAid}}
-ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/封禁/规则；高级 group.* 用 ec rpc） $KITS_DOCS/evolcore/group.md
+ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/封禁/规则/协作；完整协作流程见 $KITS_DOCS/evolcore/group-collaboration.md） $KITS_DOCS/evolcore/group.md
 {{/}}
 {{?peerRole=owner}}
 ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@agentunion/fastaun": "0.5.10",
+    "@agentunion/fastaun": "0.5.11",
     "@anthropic-ai/claude-agent-sdk": "0.3.220",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.20.0",