evolcore 0.0.2 → 0.0.4

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

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.7.json",
+  "title": "RelationConfig v7 (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": 7, "default": 7, "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" },
+    "groupRules": {
+      "type": "object",
+      "x-merge": "dict",
+      "additionalProperties": false,
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["load", "ignore"],
+          "default": "load",
+          "description": "是否读取并注入当前 AUN 群已发布的 /rules.md；默认 load。"
+        }
+      }
+    },
+    "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

@@ -23,6 +23,7 @@
   "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",

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

@@ -26,8 +26,8 @@
       "default": { "private": null, "group": null },
       "description": "未显式分配角色时，私聊和群聊分别采用的默认角色；null 表示不自动授予角色。",
       "properties": {
-        "private": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "私聊对端的默认角色；非 null 时必须已注册、有效且不能为 owner/admin。" },
-        "group": { "type": ["string", "null"], "pattern": "^[a-z0-9_-]+$", "default": null, "description": "群聊对端的默认角色；非 null 时必须已注册、有效且不能为 owner/admin。" }
+        "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.2.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "single-session.schema.2.json",
+  "title": "SingleSessionParams (responseModeParams['single-session'])",
+  "x-logical-name": "single-session",
+  "x-scope": "mode",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "auxiliaryModel": {
+      "oneOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": false,
+          "properties": {
+            "claude": { "type": "string", "minLength": 1 },
+            "codex": { "type": "string", "minLength": 1 }
+          }
+        }
+      ],
+      "description": "辅助判断模型；可直接配置模型 ID，或按 claude/codex 配置映射。当前 Session 的 baseagent 在映射中无对应模型时执行 fallback_action。"
+    },
+    "auxiliaryEffort": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "xhigh", "max"],
+      "description": "辅助判断推理强度；配置时同一模式桶必须同时配置 auxiliaryModel，未配置时不向模型 API 发送 effort。"
+    },
+    "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": "禁用：静默执行工具"
+      }
+    }
+  },
+  "dependencies": {
+    "auxiliaryEffort": ["auxiliaryModel"]
+  }
+}

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

@@ -0,0 +1,9 @@
+说明：
+- 以下是此前未纳入本会话上下文的本地发言，仅补充一次。
+- 请结合这些发言与当前对端回复继续处理。
+
+本地发言：
+{{#each handoffContextEntries}}- {{previousContent}}
+{{/each}}
+当前对端回复内容：
+{{content}}

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

@@ -1,13 +1,19 @@
 说明：
-- 跨会话请求回复，仅本端可见。
-- 请结合下方内容理解当前对端回复。
-- 当前回流策略：{{handoffReturnPolicy}}
-- 若策略为 required 且当前回复足以处理请求，使用：`ec handoff return {{handoffId}} "<完整回流内容>"`
-- 若策略为 none 且当前回复已处理请求，使用：`ec handoff return {{handoffId}}`
+- 以下是尚未完成的跨会话请求，仅本端可见。
+- 请结合请求列表与当前对端回复，分别判断哪些请求已经得到充分回答。
+- 不要在对外回复中主动提及 handoff、ID、return 命令或内部路由机制。
+- 当前回复足以处理某项请求时，需要使用：`ec handoff return ID "<完整回流内容>"`
+- 命令双引号内若含双引号、反引号或 Shell 展开形式的 `$`，需经转义符转义，Shell 传给 ec 时会做还原。
 - 若回复不足，不要执行 return。
 
-此前发给当前对端的内容：
-{{handoffPreviousContent}}
-
+待回流请求：
+{{#each handoffRequiredEntries}}- ID：{{handoffId}}
+  原请求：{{previousContent}}
+{{/each}}
+{{?handoffContextEntries}}
+以下本地发言只用于补充上下文，不需要回流：
+{{#each handoffContextEntries}}- {{previousContent}}
+{{/each}}
+{{/}}
 当前对端回复内容：
 {{content}}

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

@@ -1,10 +1,9 @@
 说明：
 - 跨会话结果回流，仅本端可见。
-- 这是此前本会话请求的返回结果，请结合当前上下文回复当前对端。
+- 以下是此前本会话一个或多个请求的返回结果，请逐项结合当前上下文处理。
 - 不要提及 handoff 或内部路由机制。
 
-此前跨会话请求内容：
-{{handoffPreviousContent}}
-
-回流内容：
-{{content}}
+待处理结果：
+{{#each handoffOriginEntries}}- 原请求：{{previousContent}}
+  返回结果：{{responseContent}}
+{{/each}}

package/kits/templates/roles/admin.json

@@ -1,8 +1,55 @@
 {
   "$schema_version": 1,
   "description": "Agent administrator with guarded management authority",
+  "rank": 700,
   "allowAccess": true,
   "permissions": {
     "permissionMode": { "default": "request", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "contact.read": { "allow": true, "scopes": ["agent"] },
+    "contact.block": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "connect.write": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "connect.access.write": {
+      "allow": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentOwner": true }
+    },
+    "role.assign": { "allow": true, "scopes": ["agent"] },
+    "role.revoke": { "allow": true, "scopes": ["agent"] },
+    "role.policy.read": { "allow": true, "scopes": ["agent"] },
+    "role.relation.read": { "allow": true, "scopes": ["agent"] },
+    "config.get": { "allow": true, "scopes": ["agent", "relation"] },
+    "config.set": { "allow": true, "scopes": ["agent", "relation"] },
+    "config.unset": { "allow": true, "scopes": ["agent", "relation"] },
+    "role.policy.write": {
+      "allow": true,
+      "dangerous": true,
+      "scopes": ["agent"],
+      "constraints": { "requireAgentAdmin": true }
+    },
+    "*": { "allow": true },
+    "agent.reload": {
+      "allow": true,
+      "dangerous": true,
+      "scopes": ["agent"],
+      "constraints": {
+        "targetCurrentAgentOnly": true,
+        "requireAgentAdmin": true
+      }
+    },
+    "dangerous:*": {
+      "allow": true,
+      "dangerous": true,
+      "constraints": { "requireDaemonOwner": true }
+    }
   }
 }

package/kits/templates/roles/member.json

@@ -1,6 +1,7 @@
 {
   "$schema_version": 1,
   "description": "Trusted user with own-scope access",
+  "rank": 300,
   "allowAccess": true,
   "usageLimits": {
     "enabled": true,
@@ -28,6 +29,10 @@
     "chatmode.update": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
     "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
     "mentionmode.update": { "allow": false },
+    "group.mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.mentionmode.update": { "allow": false },
+    "group.rulespolicy.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.rulespolicy.update": { "allow": false },
     "trigger.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
     "ec.msg.send": { "allow": true, "constraints": { "ownPeerOnly": true } },
     "ec.msg.file": { "allow": true, "constraints": { "ownPeerOnly": true } },

package/kits/templates/roles/owner.json

@@ -1,6 +1,7 @@
 {
   "$schema_version": 1,
   "description": "Agent owner with full Agent management authority",
+  "rank": 900,
   "allowAccess": true,
   "permissions": {
     "permissionMode": { "default": "bypass", "allowOverride": false }

package/kits/templates/roles/visitor.json

@@ -1,6 +1,7 @@
 {
   "$schema_version": 1,
   "description": "Low-trust visitor with minimal own-scope access",
+  "rank": 100,
   "allowAccess": true,
   "usageLimits": {
     "enabled": true,
@@ -26,6 +27,10 @@
     "chatmode.update": { "allow": false },
     "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
     "mentionmode.update": { "allow": false },
+    "group.mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.mentionmode.update": { "allow": false },
+    "group.rulespolicy.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true, "targetCurrentAgentOnly": true } },
+    "group.rulespolicy.update": { "allow": false },
     "trigger.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
     "session.list": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true } },
     "ec.msg.send": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "privateOnly": true } },

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

@@ -24,8 +24,13 @@ chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送
 {{/}}
 {{?groupId}}
 {{?channel=aun}}
-ec group send {{selfAid}} {{groupId}} "<text>" [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
+ec group send {{selfAid}} {{groupId}} "<text>" [--return none|required] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--payload '<json>'] [--mention <aid>] [--mention-all]
+# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
 group-send 是群内公开回复；interactive 下直接输出即为公开回复，仅 @某人/发文件/手动控制加密时才需此命令
+# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
+{{/}}
 # 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 group send 时【必须】跟随本轮入站消息的加密态——
 # 回复某条密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送。
 # interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送（批次含密文则整轮密文），无需你操心。
@@ -36,8 +41,13 @@ group-send 是群内公开回复；interactive 下直接输出即为公开回复
 {{/}}
 {{?peerId}}
 {{?channel=aun}}
-ec msg send {{selfAid}} {{peerId}} "<text>" [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+ec msg send {{selfAid}} {{peerId}} "<text>" [--return none|required] [--text-from-file <path>] [--encrypt|--no-encrypt] [--file <path> --as image|video|voice|file] [--link <url> --title "<title>"] [--payload '<json>']
+# 双引号正文中的双引号、反引号和 Shell 变量 `$` 需分别在其前加反斜杠；ec 收到的仍是原字符。
 msg-send 用于私聊对端的附加能力（文件/链接/手动控制加密）；群聊中仅在确需私下联系本条消息发送者时才用，否则用上面的 group send
+# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+# Trigger 任务的跨会话发送只允许 --return none，禁止 required。
+{{/}}
 # 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 msg send 时【必须】跟随你所回复的那条入站消息的加密态——
 # 回复密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送（密文会话漏发明文是严重事故）。
 # interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送，无需你操心；仅当你显式调用 msg send 时才需自己带加密参数。

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

@@ -6,7 +6,7 @@ ec model   模型与推理强度管理（切模型/列模型/当前模型/模型
 ec response 响应模式管理（切换响应模式/列响应模式/看当前模式/改响应配置）  $KITS_DOCS/evolcore/response.md
 ec stats   Token 用量与费用统计（用量/费用/统计/预算/token/cost）  $KITS_DOCS/evolcore/stats.md
 ec config  读配置/查字段/看生效值（get/show/list/effective/fields/history/diff/current/boots/validate）；set/unset 权限由 API 层控制  $KITS_DOCS/evolcore/config.md
-ec trigger 定时与事件触发器管理（定时任务/cron/提醒/自动执行/巡检/禁用/删除）。需要写操作的无人值守任务用 --permission bypass；单个 trigger 可用 --model/--effort 覆盖执行模型/强度  $KITS_DOCS/evolcore/trigger.md
+ec trigger 定时与事件触发器管理（create/update/list/run/enable/disable/delete；set 仅为 create 兼容别名）。需要写操作的无人值守任务用 --permission bypass；单个 trigger 可用 --model/--effort 覆盖执行模型/强度  $KITS_DOCS/evolcore/trigger.md
 ec aid     身份/证书/名片/探测对端                   $KITS_DOCS/evolcore/aid.md
 ec fs      AUN 文件系统统一入口（ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/setfacl/getfacl/token/find/df/mount/approve/reject/umount；个人/群空间同一入口；没有 ec group fs） $KITS_DOCS/evolcore/fs.md
 ec storage 文件上传/下载/配额（底层调试入口，日常优先 ec fs） $KITS_DOCS/evolcore/storage.md
@@ -19,8 +19,10 @@ ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/
 {{/}}
 {{?peerRole=owner}}
 ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md
+ec contact 联系人与访问控制（拉黑/解除拉黑/查拉黑；显式 --self） $KITS_DOCS/evolcore/contact.md
 {{/}}
 {{?peerRole=admin}}
 ec agent   EvolAgent 生命周期（创建/启停/热重载/改配置）。ec agent reload 仅对配置/persona/memory 生效，改源码无效  $KITS_DOCS/evolcore/agent.md
+ec contact 联系人与访问控制（拉黑/解除拉黑/查拉黑；显式 --self） $KITS_DOCS/evolcore/contact.md
 {{/}}
 完整命令集目录（含触发词与适用场景）：$KITS_DOCS/evolcore/INDEX.md

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

@@ -1,6 +1,8 @@
 [identity]
-{{?selfAid}}
+{{?selfName}}
 selfName: {{selfName}}
+{{/}}
+{{?selfAid}}
 selfAid: {{selfAid}}
 {{/}}
 {{?hasPersona}}

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

@@ -11,7 +11,7 @@ peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
 {{?groupId}}
 groupId: {{groupId}}
 {{?groupRulesStatus}}
-groupRulesStatus: {{groupRulesStatus}} # synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
+groupRulesStatus: {{groupRulesStatus}} # ignored/synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
 {{/}}
 {{?groupRulesError}}
 groupRulesError: {{groupRulesError}}

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

@@ -45,9 +45,13 @@ readonly: true — 禁止写入项目目录及临时目录；如需生成文件
 {{/}}
 # 命令速查：
 {{?chatType=group}}
-#   ec group send {{selfAid}} {{groupId}} "<text>" [--file <path>] [--mention <aid>]
+#   ec group send {{selfAid}} {{groupId}} "<text>" [--return none|required] [--file <path>] [--mention <aid>]
 {{/}}
 {{?chatType=private}}
-#   ec msg send {{selfAid}} {{peerId}} "<text>" [--text-from-file <path>] [--file <path>]
+#   ec msg send {{selfAid}} {{peerId}} "<text>" [--return none|required] [--text-from-file <path>] [--file <path>]
+{{/}}
+# 跨会话发送必须显式填写 --return none|required；同会话发送不要求。
+{{?isTriggerTask}}
+# Trigger 任务的跨会话发送只允许 --return none，禁止 required；需要等待人工操作时使用 Trigger 的交互/待处理机制。
 {{/}}
 {{/}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "AI Agent gateway connecting multiple backends (Claude, Codex, Gemini) to messaging channels (Feishu, WeChat, AUN, QQ) with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -9,14 +9,16 @@
   },
   "files": [
     "dist/",
+    "!dist/cli/mode.js",
     "bin/",
-    "assets/",
-    "!assets/wechat-group-qr.jpeg",
+    "assets/.env.template",
     "!dist/experimental/",
     "kits/",
     "!kits/.kits-version",
     "*.md",
     "!CLAUDE.md",
+    "!COMPLETED.md",
+    "!DECISIONS_PENDING.md",
     "!DEPLOYMENT.md",
     "!ONBOARDING.md",
     "!TODO.md",
@@ -35,7 +37,7 @@
   },
   "dependencies": {
     "@agentunion/fastaun": "^0.5.4",
-    "@anthropic-ai/claude-agent-sdk": "^0.3.211",
+    "@anthropic-ai/claude-agent-sdk": "0.3.220",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.20.0",
     "cron-parser": "^5.5.0",
@@ -47,7 +49,7 @@
   },
   "optionalDependencies": {
     "@larksuiteoapi/node-sdk": "^1.59.0",
-    "@wecom/aibot-node-sdk": "^1.0.6",
+    "@wecom/aibot-node-sdk": "^1.0.7",
     "dingtalk-stream": "^2.1.6-beta.1",
     "form-data": "^4.0.5",
     "pure-qqbot": "^2.0.0"