evolcore 0.0.5 → 0.0.7

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

@@ -0,0 +1,370 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-config.schema.10.json",
+  "title": "AgentConfig v10 (agents/{aid}/config.json)",
+  "description": "Agent v10 主配置。备用模型链只允许在 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": 10,
+      "default": 10,
+      "x-merge": "scalar",
+      "description": "配置 Schema 版本；v10 禁止 Agent 级 fallbackModels"
+    },
+    "aid": {
+      "type": "string",
+      "x-merge": "scalar",
+      "description": "Agent 的全局唯一身份标识"
+    },
+    "enabled": {
+      "type": "boolean",
+      "default": true,
+      "x-merge": "scalar",
+      "description": "是否启用 Agent；缺省按启用处理"
+    },
+    "lifecycle": {
+      "type": "string",
+      "enum": [
+        "created",
+        "bootstrapping",
+        "active"
+      ],
+      "x-merge": "scalar",
+      "description": "agent 生命周期状态",
+      "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",
+        "description": "一个渠道实例配置；具体字段由渠道类型及其适配器定义。"
+      },
+      "x-merge": "list",
+      "description": "Agent 绑定的消息渠道实例列表"
+    },
+    "aun": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 级 AUN 通信配置"
+    },
+    "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"]
+        }
+      }
+    },
+    "projects": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 可用项目路径和项目选择配置"
+    },
+    "capabilities": {
+      "type": "object",
+      "x-merge": "dict",
+      "description": "Agent 能力开关及能力参数"
+    },
+    "observable": {
+      "type": "boolean",
+      "default": false,
+      "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": "只处理被 @ 的消息，未 @ 作引用上下文"
+      }
+    },
+    "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/schemas/defaults.schema.4.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "defaults.schema.4.json",
+  "title": "DefaultsConfig v4 (agents/defaults.json)",
+  "description": "全局默认配置。覆盖链最低层；模型降级候选链仅允许定义在本文件。",
+  "x-logical-name": "defaults",
+  "x-scope": "defaults",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema_version": { "type": "number", "const": 4, "default": 4, "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 等），以及仅 defaults 可定义的备用模型链。",
+      "x-merge": "dict",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "fallbackModels": {
+            "type": "array",
+            "maxItems": 3,
+            "description": "同 base agent 的有序备用模型链；为空时禁用自动模型降级。",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["model"],
+              "properties": {
+                "model": { "type": "string", "minLength": 1 },
+                "effort": { "type": "string", "minLength": 1 }
+              }
+            }
+          }
+        }
+      }
+    },
+    "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.8.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "relation-config.schema.8.json",
+  "title": "RelationConfig v8 (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": 8, "default": 8, "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",
+      "description": "关系级模型覆盖；备用模型链只能在 defaults.json 配置。",
+      "additionalProperties": {
+        "not": {
+          "type": "object",
+          "required": ["fallbackModels"]
+        }
+      }
+    },
+    "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/templates/roles/admin.json

@@ -40,7 +40,7 @@
     "agent.reload": {
       "allow": true,
       "dangerous": true,
-      "scopes": ["agent"],
+      "scopes": ["agent", "control"],
       "constraints": {
         "targetCurrentAgentOnly": true,
         "requireAgentAdmin": true

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "evolcore",
-  "version": "0.0.5",
-  "description": "AI Agent gateway connecting multiple backends (Claude, Codex, Gemini) to messaging channels (Feishu, WeChat, AUN, QQ) with multi-project session management",
+  "version": "0.0.7",
+  "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",
   "bin": {
@@ -9,10 +9,17 @@
   },
   "files": [
     "dist/",
+    "ecagent/src/",
+    "ecagent/dist/",
+    "ecagent/package.json",
+    "ecagent/tsconfig.build.json",
+    "ecagent/LICENSE",
+    "ecagent/NOTICE",
+    "ecagent/README.md",
     "!dist/cli/mode.js",
     "bin/",
-    "assets/.env.template",
     "!dist/experimental/",
+    "skills/",
     "kits/",
     "!kits/.kits-version",
     "*.md",
@@ -27,8 +34,10 @@
     "!evolcore-install-aun.md"
   ],
   "scripts": {
+    "predev": "npm run build:ecagent",
     "dev": "tsx watch src/index.ts",
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"require('fs').copyFileSync('src/utils/error-dict.json','dist/utils/error-dict.json');require('fs').copyFileSync('src/utils/model-prices.jsonl','dist/utils/model-prices.jsonl')\" && npm --prefix ecweb run build",
+    "build:ecagent": "npm --prefix ecagent run build",
+    "build": "npm run build:ecagent && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"require('fs').copyFileSync('src/utils/error-dict.json','dist/utils/error-dict.json');require('fs').copyFileSync('src/utils/model-prices.jsonl','dist/utils/model-prices.jsonl')\" && npm --prefix ecweb run build",
     "start": "node dist/index.js",
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
@@ -42,9 +51,13 @@
     "ajv": "^8.20.0",
     "cron-parser": "^5.5.0",
     "dotenv": "^17.4.2",
+    "ignore": "7.0.5",
     "image-type": "^6.0.0",
+    "partial-json": "0.1.7",
     "qrcode-terminal": "^0.12.0",
+    "typebox": "1.1.38",
     "ws": "^8.21.0",
+    "yaml": "2.9.0",
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
@@ -56,12 +69,15 @@
   },
   "devDependencies": {
     "@types/form-data": "^2.2.1",
-    "@types/node": "^25.5.0",
+    "@types/node": "24.12.4",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.1.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.6.0",
+    "typescript": "5.9.3",
     "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=22.19.0"
   }
 }