evolcore 0.0.1 → 0.0.3

package/kits/templates/roles/member.json

@@ -0,0 +1,41 @@
+{
+  "$schema_version": 1,
+  "description": "Trusted user with own-scope access",
+  "rank": 300,
+  "allowAccess": true,
+  "usageLimits": {
+    "enabled": true,
+    "resetMode": "daily",
+    "currency": "CNY",
+    "limitAmount": 50,
+    "costBasis": "gateway",
+    "scope": "subject"
+  },
+  "permissions": {
+    "permissionMode": { "default": "auto", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "role.assign": { "allow": false },
+    "role.revoke": { "allow": false },
+    "category:read": { "allow": true },
+    "category:write-own": { "allow": true },
+    "config.get": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "behavior-read" } },
+    "config.set": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "role-overridable-write" } },
+    "config.unset": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "role-overridable-write" } },
+    "model.*": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.answer": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.update": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
+    "mentionmode.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 } },
+    "ec.group.send": { "allow": true, "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.group.file": { "allow": true, "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.ctl.*": { "allow": false },
+    "cli.exec.raw": { "allow": false, "dangerous": true },
+    "dangerous:*": { "allow": false, "dangerous": true }
+  }
+}

package/kits/templates/roles/owner.json

@@ -0,0 +1,9 @@
+{
+  "$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

@@ -0,0 +1,40 @@
+{
+  "$schema_version": 1,
+  "description": "Low-trust visitor with minimal own-scope access",
+  "rank": 100,
+  "allowAccess": true,
+  "usageLimits": {
+    "enabled": true,
+    "resetMode": "daily",
+    "currency": "CNY",
+    "limitAmount": 5,
+    "costBasis": "gateway",
+    "scope": "subject"
+  },
+  "permissions": {
+    "permissionMode": { "default": "readonly", "allowOverride": false }
+  },
+  "commandPermissions": {
+    "role.assign": { "allow": false },
+    "role.revoke": { "allow": false },
+    "config.get": { "allow": true, "scopes": ["relation"], "constraints": { "currentRelationOnly": true, "targetCurrentAgentOnly": true, "configFieldPolicy": "behavior-read" } },
+    "model.list": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "model.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "model.use": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "permission.answer": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "ownPeerOnly": true, "targetCurrentAgentOnly": true } },
+    "chatmode.update": { "allow": false },
+    "mentionmode.current": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true } },
+    "mentionmode.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 } },
+    "ec.msg.file": { "allow": false },
+    "ec.group.send": { "allow": true, "scopes": ["relation"], "constraints": { "groupOnly": true, "currentRelationOnly": true } },
+    "ec.group.file": { "allow": false },
+    "ec.ctl.*": { "allow": false },
+    "cli.exec.raw": { "allow": false, "dangerous": true },
+    "dangerous:*": { "allow": false, "dangerous": true }
+  }
+}

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

@@ -0,0 +1,14 @@
+[baseagent]
+baseAgentName: {{baseAgentName}} # 底层推理引擎（Claude Code / Codex / Gemini CLI）
+{{?effectiveModel}}
+effectiveModel: {{effectiveModel}} # 当前实际生效的模型（关系级 > agent级 > 全局 优先级解析）
+{{/}}
+{{?baseAgentModel}}
+baseAgentModel: {{baseAgentModel}} # base agent 引擎底座模型（evolcore 作用域无配置时的兜底）
+{{/}}
+{{?modelFallbackActive}}
+modelFallbackActive: true # evolcore 配置的模型不可用，当前正在使用降级模型 {{modelFallbackModel}}
+{{/}}
+{{?agentSessionId}}
+agentSessionId: {{agentSessionId}} # 底层引擎的会话 ID（区别于 evolcore sessionId）
+{{/}}

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

@@ -0,0 +1,16 @@
+[bootstrap]
+phase: bootstrapping
+
+你正在进行首次自我设定。当前目标不是处理普通任务，而是和 owner 确认并写入你的基础名片信息。
+
+需要确认的字段：
+- name：显示名，简短清晰
+- description：一句到两句话描述你的职责或定位
+- tags：3 到 6 个标签，用于检索和归类
+
+流程：
+1. 如果 owner 尚未明确这些信息，继续提问并收敛选项。
+2. 信息齐全后，编辑本地 agent.md（`$EVOLCORE_HOME/AIDs/{{selfAid}}/agent.md`）中的 YAML frontmatter：更新 `name`、`description`、`tags`。
+3. 调用 `ec aid agentmd put {{selfAid}}` 签名并发布 agent.md。
+4. 发布成功后，调用 `ec agent ready {{selfAid}}` 完成 bootstrap。
+5. 完成前不要承诺已经进入正常工作状态。

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

@@ -0,0 +1,48 @@
+[channel]
+channel: {{channel}} # 渠道类型：aun|feishu|wechat|dingtalk|qqbot|wecom
+{{?capabilities}}
+capabilities: {{capabilities}} # 当前渠道支持的能力
+{{/}}
+{{?supportsFileMarker}}
+发送文件语法：
+  [SEND_FILE:文件路径]
+相对路径从项目根目录解析，图片自动内联预览。
+{{/}}
+# ── 怎么回复（唯一事实源，跟 chatMode 走）──
+chatMode: {{chatMode}} # interactive=同步对话 / proactive=主动推送
+{{?chatMode=interactive}}
+# interactive：你直接输出的文本就是回复，无需调用发送命令。
+# 下面的命令仅用于附加能力（发文件/@某人/加密/联系第三方），不是回复手段。
+{{/}}
+{{?chatMode=proactive}}
+# proactive：你的普通文本被投影成「思考过程」（message.thought.put）：
+#   - 前端可见，但不入历史、不触发对端 message.received 事件
+#   - 对端大模型不会被唤醒，因此不是回复
+# 要正式回复，必须调用发送命令（message.send 协议）触发对端接收。
+# 设计意图：避免 agent↔agent 无限循环；某一方不再发送 → 对话自然终止。
+# 拿不到 self-aid 时可用 ec ctl send "<text>"（自动继承当前 AID 和对端）。
+{{/}}
+{{?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]
+group-send 是群内公开回复；interactive 下直接输出即为公开回复，仅 @某人/发文件/手动控制加密时才需此命令
+# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 group send 时【必须】跟随本轮入站消息的加密态——
+# 回复某条密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送。
+# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送（批次含密文则整轮密文），无需你操心。
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
+{{/}}
+{{/}}
+{{?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>']
+msg-send 用于私聊对端的附加能力（文件/链接/手动控制加密）；群聊中仅在确需私下联系本条消息发送者时才用，否则用上面的 group send
+# 加密：消息信封头标注每条入站消息是 🔒密文 还是 ✉明文。你用 msg send 时【必须】跟随你所回复的那条入站消息的加密态——
+# 回复密文消息务必带 --encrypt，回复明文消息带 --no-encrypt；不带任何加密参数则默认明文发送（密文会话漏发明文是严重事故）。
+# interactive 下你直接输出的回复由 evolcore 自动按入站加密态发送，无需你操心；仅当你显式调用 msg send 时才需自己带加密参数。
+{{/}}
+{{?channel!=aun}}
+非 aun 渠道：回复由 evolcore 自动完成，无需调用 CLI
+{{/}}
+{{/}}

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

@@ -0,0 +1,28 @@
+[commands] 当前场景可用命令集（前缀 ec，以自己 AID 为发送者；完整用法 Read 对应文档）
+遇到明确触发词（费用/用量/统计/创建agent/建群/查群等）优先查 INDEX.md 或直接试对应 ec 命令
+
+ec ctl     当前会话工具（主动发消息/文件、重命名、队列、项目路径、会话状态）  $KITS_DOCS/evolcore/ctl.md
+ec model   模型与推理强度管理（切模型/列模型/当前模型/模型详情/改强度/诊断网关）  $KITS_DOCS/evolcore/model.md
+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 定时与事件触发器管理（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
+ec rpc     底层 AUN RPC 逃生通道                      $KITS_DOCS/evolcore/rpc.md
+{{?peerId}}
+ec msg     私聊收发消息（回复/拉取/撤回）            $KITS_DOCS/evolcore/msg.md
+{{/}}
+{{?selfAid}}
+ec group   群聊收发与群管理（群发/建群/查群/邀请/踢人/角色/封禁/规则；高级 group.* 用 ec rpc） $KITS_DOCS/evolcore/group.md
+{{/}}
+{{?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

@@ -0,0 +1,11 @@
+[identity]
+{{?selfAid}}
+selfName: {{selfName}}
+selfAid: {{selfAid}}
+{{/}}
+{{?hasPersona}}
+hasPersona: active
+{{/}}
+{{?hasWorkingMemory}}
+hasWorkingMemory: active
+{{/}}

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

@@ -0,0 +1,19 @@
+[relation]
+{{?peerKey}}
+peerName: {{peerName}}
+peerId: {{peerId}} # 对端在当前渠道内的原生 ID
+peerRole: {{peerRole}} # owner|admin|member|visitor|自定义角色|none
+{{?peerType}}
+peerType: {{peerType}} # human 或 agent
+{{/}}
+peerKey: {{peerKey}} # 跨渠道唯一标识，格式 channel#urlEncode(peerId)
+{{/}}
+{{?groupId}}
+groupId: {{groupId}}
+{{?groupRulesStatus}}
+groupRulesStatus: {{groupRulesStatus}} # synced/cached/missing/forbidden/invalid_metadata/file_mismatch/too_large/unreadable/error
+{{/}}
+{{?groupRulesError}}
+groupRulesError: {{groupRulesError}}
+{{/}}
+{{/}}

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

@@ -0,0 +1,53 @@
+[session]
+project: {{project}} # 项目目录名
+CURRENT_PROJECT: {{CURRENT_PROJECT}} # 项目完整路径
+sessionId: {{sessionId}} # evolcore 会话 ID
+{{?sessionKey}}
+sessionKey: {{sessionKey}} # 会话路由键（channelType#urlEncode(channelId)#urlEncode(threadId)）
+{{/}}
+{{?sessionName}}
+sessionName: {{sessionName}}
+{{/}}
+sessionCreatedAt: {{sessionCreatedAt}}
+{{?localDate}}
+localDate: {{localDate}} {{weekday}} # 当前日期与星期（每条消息的精确时刻见消息正文前缀 ‹…›）
+{{/}}
+{{?timezone}}
+timezone: {{timezone}} # 时区 IANA 名：把消息/记忆里的 ISO 时间戳转成本地时间字符串时按此换算
+{{/}}
+{{?tzOffset}}
+tzOffset: {{tzOffset}} # 当前 UTC 偏移（DST 已计入）
+{{/}}
+{{?osInfo}}
+os: {{osInfo}} # 当前操作系统及版本
+{{/}}
+{{?permissionMode}}
+permissionMode: {{permissionMode}} # readonly / auto / request / bypass
+{{/}}
+{{?threadId}}
+threadId: {{threadId}} # 同一会话内的子话题 ID（多话题路由时）
+{{/}}
+{{?readonly}}
+readonly: true — 禁止写入项目目录及临时目录；如需生成文件，请先请求切换到非 readonly 模式
+{{/}}
+{{?chatMode=proactive}}
+# proactive 模式（回复机制见 [channel] 段）：
+{{?chatType=group}}
+# 群聊：先判断是否需要响应（@你/话题相关/明确询问等）。
+# 不需要响应时：给出简短静默理由，然后直接结束，不调用发送命令。
+{{/}}
+# 决定响应后：
+{{?proactiveFirstSendRequired}}
+#   - 首次调用任何非发送工具前，必须先用发送命令向{{proactiveSendTargetLabel}}说明意图
+{{/}}
+{{?proactiveToolReportRequired}}
+#   - 每 {{proactiveToolReportInterval}} 次非发送工具调用后，必须先用发送命令汇报当前进展和下一步，否则后续非发送工具会被拒绝
+{{/}}
+# 命令速查：
+{{?chatType=group}}
+#   ec group send {{selfAid}} {{groupId}} "<text>" [--file <path>] [--mention <aid>]
+{{/}}
+{{?chatType=private}}
+#   ec msg send {{selfAid}} {{peerId}} "<text>" [--text-from-file <path>] [--file <path>]
+{{/}}
+{{/}}

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

@@ -0,0 +1,31 @@
+[venue]
+chatType: {{chatType}} # private|group
+EVOLCORE_HOME: {{EVOLCORE_HOME}} # 用户数据根目录（agents/sessions/logs）
+PACKAGE_ROOT: {{PACKAGE_ROOT}} # evolcore 安装目录（kits/rules/docs）
+{{?evolcoreMode=dev}}
+evolcoreMode: dev # evolcore 以源码仓库运行，$PACKAGE_ROOT/src 下的代码可直接查看和修改
+{{/}}
+{{?evolcoreMode=install}}
+evolcoreMode: install # evolcore 为全局安装包，$PACKAGE_ROOT 下代码可查看但不应直接修改；发现 bug 时生成 markdown 报告并通过附件消息发送给 toleiliang.agentid.pub
+{{/}}
+{{?venueUid}}
+venueUid: {{venueUid}}
+{{/}}
+{{?mentionMode}}
+mentionMode: {{mentionMode}} # 群 @ 处理模式：mention-only(被@才响应) / disabled(所有消息都响应)
+{{/}}
+{{?clientType}}
+clientType: {{clientType}} # 客户端类型：desktop / web / mobile
+{{/}}
+{{?groupId}}
+groupId: {{groupId}}
+{{/}}
+{{?sameDevice}}
+sameDevice: true # 对端与你运行在同一台设备上
+{{/}}
+{{?sameNetwork}}
+sameNetwork: true # 对端与你在同一网络内（同域）
+{{/}}
+{{?sameEgressIp}}
+sameEgressIp: true # 对端与你共享同一出口 IP
+{{/}}

package/package.json

@@ -1,29 +1,64 @@
 {
   "name": "evolcore",
-  "version": "0.0.1",
-  "description": "EvolCore - Core utilities and abstractions for EvolClaw ecosystem",
+  "version": "0.0.3",
+  "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",
-  "types": "dist/index.d.ts",
+  "bin": {
+    "ec": "bin/ec.js"
+  },
   "files": [
     "dist/",
-    "README.md"
+    "!dist/cli/mode.js",
+    "bin/",
+    "assets/.env.template",
+    "!dist/experimental/",
+    "kits/",
+    "!kits/.kits-version",
+    "*.md",
+    "!CLAUDE.md",
+    "!DEPLOYMENT.md",
+    "!ONBOARDING.md",
+    "!TODO.md",
+    "!SKILLS.md",
+    "!proxy-setup.md",
+    "!evolcore-install-aun.md"
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "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",
+    "start": "node dist/index.js",
+    "test": "npm run build && vitest run",
+    "test:watch": "vitest",
+    "test:hooks": "tsx test-sdk-hooks.ts",
+    "prepublishOnly": "npm test"
+  },
+  "dependencies": {
+    "@agentunion/fastaun": "^0.5.4",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.211",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ajv": "^8.20.0",
+    "cron-parser": "^5.5.0",
+    "dotenv": "^17.4.2",
+    "image-type": "^6.0.0",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.21.0",
+    "zod": "^4.0.0"
+  },
+  "optionalDependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@wecom/aibot-node-sdk": "^1.0.7",
+    "dingtalk-stream": "^2.1.6-beta.1",
+    "form-data": "^4.0.5",
+    "pure-qqbot": "^2.0.0"
   },
-  "keywords": [
-    "evolclaw",
-    "core",
-    "utilities"
-  ],
-  "author": "",
-  "license": "MIT",
   "devDependencies": {
+    "@types/form-data": "^2.2.1",
     "@types/node": "^25.5.0",
+    "@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",
     "vitest": "^4.1.0"
   }

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * EvolCore - Core utilities and abstractions for EvolClaw ecosystem
- * @module evolcore
- */
-export declare const version = "0.0.1";
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}