evolcore 0.0.43-test.1 → 0.0.43-test.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (170) hide show
  1. package/CHANGELOG.md +24 -1
  2. package/README.md +22 -0
  3. package/dist/agents/claude-runner.js +26 -2
  4. package/dist/agents/codex/app-server-client.js +12 -0
  5. package/dist/agents/codex-runner.js +49 -8
  6. package/dist/agents/ecagent-runner.js +26 -9
  7. package/dist/agents/gemini-runner.js +15 -12
  8. package/dist/agents/tool-time-context.js +55 -0
  9. package/dist/aun/menu/client.js +1 -1
  10. package/dist/aun/model-headers.js +17 -0
  11. package/dist/aun/msg/p2p.js +3 -0
  12. package/dist/channels/aun.js +484 -43
  13. package/dist/channels/builtin-plugins.js +16 -11
  14. package/dist/channels/dingtalk.js +83 -31
  15. package/dist/channels/feishu.js +29 -13
  16. package/dist/channels/qqbot.js +32 -11
  17. package/dist/channels/wechat.js +13 -3
  18. package/dist/channels/wecom.js +67 -27
  19. package/dist/cli/agent-command.js +3 -86
  20. package/dist/cli/agent-create.js +22 -6
  21. package/dist/cli/agent.js +1 -79
  22. package/dist/cli/aun-commands.js +1 -0
  23. package/dist/cli/config.js +1 -1
  24. package/dist/cli/daemon-commands.js +47 -2
  25. package/dist/cli/data-command.js +9 -1
  26. package/dist/cli/debug-mode.js +1 -1
  27. package/dist/cli/diag.js +1 -1
  28. package/dist/cli/directory.js +77 -64
  29. package/dist/cli/getmeta-command.js +1 -1
  30. package/dist/cli/index.js +79 -22
  31. package/dist/cli/init.js +1 -23
  32. package/dist/cli/link-rules.js +1 -1
  33. package/dist/cli/managed-command-guard.js +0 -1
  34. package/dist/cli/pa-workspace-command.js +36 -2
  35. package/dist/cli/peer.js +1 -1
  36. package/dist/cli/restart-monitor.js +17 -3
  37. package/dist/cli/role.js +1 -1
  38. package/dist/cli/session-command.js +1 -1
  39. package/dist/cli/stats.js +2 -2
  40. package/dist/cli/thread-command.js +1 -1
  41. package/dist/cli/watch-msg.js +1 -1
  42. package/dist/config/access-policy.js +1 -0
  43. package/dist/config/config-field-policy.js +2 -2
  44. package/dist/config/config-manager.js +7 -0
  45. package/dist/config/role-schema.js +4 -3
  46. package/dist/config/role-service.js +3 -3
  47. package/dist/config-store.js +75 -4
  48. package/dist/core/agent-ipc-registration.js +16 -59
  49. package/dist/core/auth/authorization-audit.js +52 -14
  50. package/dist/core/auth/operation-authorizer.js +0 -11
  51. package/dist/core/auth/operation-catalog.js +0 -18
  52. package/dist/core/channel-loader.js +152 -16
  53. package/dist/core/command/agent-control.js +2 -1
  54. package/dist/core/command/cli-intent-parser.js +0 -8
  55. package/dist/core/command/command-handler.js +17 -46
  56. package/dist/core/command/connect-menu.js +7 -3
  57. package/dist/core/command/menu-catalog.js +3 -2
  58. package/dist/core/command/menu-handler.js +51 -8
  59. package/dist/core/command/menu-protocol.js +20 -0
  60. package/dist/core/command/slash-handler.js +101 -40
  61. package/dist/core/daemon-file-cache.js +3 -3
  62. package/dist/core/evolagent-registry.js +5 -4
  63. package/dist/core/evolagent.js +5 -8
  64. package/dist/core/handoff/argv-parse.js +115 -0
  65. package/dist/core/handoff/ipc-registration.js +1 -1
  66. package/dist/core/ipc-registration.js +19 -2
  67. package/dist/core/memory/consolidation.js +8 -1
  68. package/dist/core/memory/relation-sweep.js +20 -8
  69. package/dist/core/message/aun-ipc-sender.js +28 -1
  70. package/dist/core/message/contact-admission.js +548 -0
  71. package/dist/core/message/im-renderer.js +69 -10
  72. package/dist/core/message/message-admission.js +28 -3
  73. package/dist/core/message/message-bridge.js +46 -5
  74. package/dist/core/message/message-utils.js +0 -5
  75. package/dist/core/message/peer-mode.js +44 -10
  76. package/dist/core/message/response-engine.js +268 -69
  77. package/dist/core/message/retry-scheduler.js +4 -0
  78. package/dist/core/permission/ec-command-parser.js +1 -28
  79. package/dist/core/permission/readonly-shell-query.js +34 -8
  80. package/dist/core/permission/tool-policy.js +50 -5
  81. package/dist/core/role/runtime-policy.js +14 -2
  82. package/dist/core/session/session-manager.js +9 -1
  83. package/dist/core/soul.js +66 -0
  84. package/dist/core/system-session/memory.js +2 -2
  85. package/dist/directory/contact-admission-paths.js +9 -0
  86. package/dist/directory/owner-directory-admission.js +128 -29
  87. package/dist/directory/owner-directory-cache.js +364 -50
  88. package/dist/directory/owner-directory-identity.js +60 -0
  89. package/dist/directory/owner-directory-markdown.js +120 -47
  90. package/dist/directory/owner-directory-policy.js +108 -0
  91. package/dist/directory/owner-directory-query-operation.js +219 -32
  92. package/dist/directory/owner-directory-remarks.js +29 -2
  93. package/dist/directory/owner-directory-search.js +50 -18
  94. package/dist/directory/owner-directory-store.js +150 -30
  95. package/dist/eck/kit-renderer.js +12 -5
  96. package/dist/eck/manifest-engine.js +55 -6
  97. package/dist/eck/message-renderer.js +5 -2
  98. package/dist/eck/paactive-context.js +45 -0
  99. package/dist/ecweb/basic-settings-service.js +2 -2
  100. package/dist/ecweb/message-context-service.js +24 -16
  101. package/dist/index.js +9 -5
  102. package/dist/ipc.js +1 -1
  103. package/dist/paths.js +26 -0
  104. package/dist/response-system/config-resolver.js +1 -1
  105. package/dist/response-system/engines/v1/index.js +4 -1
  106. package/dist/response-system/engines/v1/paactive-flow.js +18 -0
  107. package/dist/response-system/modes/single-session/index.js +7 -2
  108. package/dist/trigger/scheduler.js +3 -5
  109. package/dist/trigger/validation.js +4 -0
  110. package/dist/utils/error-utils.js +5 -2
  111. package/dist/utils/logger.js +13 -4
  112. package/dist/utils/npm-ops.js +2 -2
  113. package/dist/utils/windows-autostart.js +1 -1
  114. package/ecagent/dist/agent-loop.js +43 -1
  115. package/kits/docs/INDEX.md +1 -0
  116. package/kits/docs/context-assembly.md +21 -6
  117. package/kits/docs/eck_templates/INDEX.template.md +1 -2
  118. package/kits/docs/evolcore/INDEX.md +1 -1
  119. package/kits/docs/evolcore/agent-create.md +5 -5
  120. package/kits/docs/evolcore/agent.md +4 -9
  121. package/kits/docs/evolcore/directory.md +137 -0
  122. package/kits/docs/evolcore/menu-protocol.md +55 -0
  123. package/kits/docs/evolcore/response.md +7 -1
  124. package/kits/docs/evolcore/tool-authorization.md +1 -1
  125. package/kits/docs/evolcore/trigger.md +4 -0
  126. package/kits/docs/prompt-loading-architecture.md +6 -2
  127. package/kits/eck_manifest.auxiliary.json +1 -0
  128. package/kits/eck_manifest.json +57 -4
  129. package/kits/eck_manifest.memory.json +67 -3
  130. package/kits/eck_manifest.paactive.json +528 -0
  131. package/kits/eck_message_manifest.paactive.json +233 -0
  132. package/kits/rules/01-overview.md +2 -2
  133. package/kits/rules/03-identity.md +10 -9
  134. package/kits/rules/05-venue.md +2 -4
  135. package/kits/rules/06-channel.md +1 -1
  136. package/kits/schemas/_meta.json +31 -3
  137. package/kits/schemas/agent-config.schema.18.json +5 -0
  138. package/kits/schemas/agent-config.schema.19.json +924 -0
  139. package/kits/schemas/relation-config.schema.12.json +289 -0
  140. package/kits/schemas/role-config.schema.2.json +215 -0
  141. package/kits/skills/ec-skill/scripts/cli.mjs +3 -2
  142. package/kits/skills/ec-trigger/SKILL.md +4 -4
  143. package/kits/skills/personal-assistant/SKILL.md +109 -53
  144. package/kits/skills/personal-assistant/references/02-bootstrap.md +73 -30
  145. package/kits/skills/personal-assistant/scripts/clean.mjs +35 -18
  146. package/kits/skills/personal-assistant/scripts/init.mjs +41 -2
  147. package/kits/skills/personal-assistant/scripts/lib/persona.mjs +185 -0
  148. package/kits/skills/personal-assistant/scripts/migrate.mjs +55 -4
  149. package/kits/skills/personal-assistant/scripts/pa.mjs +173 -0
  150. package/kits/skills/personal-assistant/scripts/uninstall.mjs +130 -0
  151. package/kits/skills/personal-assistant/templates/persona-section.md +3 -3
  152. package/kits/templates/message-fragments/handoff-request-to-target.md +1 -1
  153. package/kits/templates/message-fragments/paactive/item.md +3 -0
  154. package/kits/templates/soul/00-GUIDE.md +61 -0
  155. package/kits/templates/soul/01-identity.md +5 -0
  156. package/kits/templates/soul/02-persona.md +11 -0
  157. package/kits/templates/soul/03-duties.md +5 -0
  158. package/kits/templates/soul/04-working-style.md +5 -0
  159. package/kits/templates/system-fragments/bootstrap.md +7 -7
  160. package/kits/templates/system-fragments/commands.md +3 -2
  161. package/kits/templates/system-fragments/directory-contacts.md +9 -0
  162. package/kits/templates/system-fragments/memory.md +1 -1
  163. package/kits/templates/system-fragments/paactive/channel.md +25 -0
  164. package/kits/templates/system-fragments/paactive/reply.md +25 -0
  165. package/kits/templates/system-fragments/paactive/session.md +32 -0
  166. package/kits/templates/system-fragments/personal-assistant.md +65 -0
  167. package/package.json +3 -2
  168. package/dist/cli/handoff-command.js +0 -353
  169. package/dist/directory/owner-directory-remark-operation.js +0 -147
  170. package/kits/docs/evolcore/self-summary.md +0 -29
@@ -0,0 +1,60 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { isValidAid } from '../aun/aid/validation.js';
4
+ /**
5
+ * ECK 变量的身份来源。
6
+ *
7
+ * `directory.md` 是给模型看的名录正文,不适合让每轮都去解析它;`contacts.json`
8
+ * 又太大(还要校验摘要)。所以渲染名录时顺手写一份只有四个字段的小文件,每轮
9
+ * 读它一次——典型几百字节,成本与 `hasOwnerDirectory` 那次 stat 同量级。
10
+ *
11
+ * **这里只存身份事实,不存角色判断**:`isPersonalAssistant` / `isOwner` 由调用方
12
+ * 拿 `selfAid` 即时比较。落盘的布尔会过期,而且改文件就能伪造角色。
13
+ */
14
+ export const OWNER_DIRECTORY_IDENTITY_FILE = 'identity.json';
15
+ /** 读不出来时的结论:没有 Owner、没有个人助理。调用方据此 fail-closed。 */
16
+ export const EMPTY_IDENTITY = Object.freeze({ schemaVersion: 1 });
17
+ /** 渲染产物侧:把快照里的身份块裁成注入要用的最小形态。 */
18
+ export function buildOwnerDirectoryIdentity(snapshot) {
19
+ return {
20
+ schemaVersion: 1,
21
+ ...(identityField(snapshot?.owner) ? { owner: identityField(snapshot?.owner) } : {}),
22
+ ...(identityField(snapshot?.personalAssistant) ? { personalAssistant: identityField(snapshot?.personalAssistant) } : {}),
23
+ };
24
+ }
25
+ /**
26
+ * 读身份文件。任何异常(不存在、解析失败、schema 不对、AID 非法)都返回 `EMPTY_IDENTITY`。
27
+ *
28
+ * 调用方是每轮上下文渲染,不能让一个坏文件把整轮渲染带崩;返回空对象等价于
29
+ * "这个 agent 既不是 Owner 也不是个人助理",是注入侧最保守的结论。
30
+ */
31
+ export function readOwnerDirectoryIdentity(directory) {
32
+ try {
33
+ const raw = JSON.parse(fs.readFileSync(path.join(directory, OWNER_DIRECTORY_IDENTITY_FILE), 'utf8'));
34
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw))
35
+ return EMPTY_IDENTITY;
36
+ const record = raw;
37
+ if (record.schemaVersion !== 1)
38
+ return EMPTY_IDENTITY;
39
+ const owner = identityField(record.owner);
40
+ const personalAssistant = identityField(record.personalAssistant);
41
+ return {
42
+ schemaVersion: 1,
43
+ ...(owner ? { owner } : {}),
44
+ ...(personalAssistant ? { personalAssistant } : {}),
45
+ };
46
+ }
47
+ catch {
48
+ return EMPTY_IDENTITY;
49
+ }
50
+ }
51
+ function identityField(value) {
52
+ if (!value || typeof value !== 'object' || Array.isArray(value))
53
+ return undefined;
54
+ const record = value;
55
+ const aid = typeof record.aid === 'string' ? record.aid.trim() : '';
56
+ if (!aid || !isValidAid(aid))
57
+ return undefined;
58
+ const name = typeof record.name === 'string' && record.name.trim() ? record.name.trim() : undefined;
59
+ return name ? { aid, name } : { aid };
60
+ }
@@ -1,5 +1,6 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
+ import { splitAliases } from './owner-directory-remarks.js';
3
4
  import { classifyEntry, ownerRefAid } from './owner-directory-scope.js';
4
5
  /** ECK 载入的名录文件,与名录快照同目录。 */
5
6
  export const OWNER_DIRECTORY_MARKDOWN_FILE = 'directory.md';
@@ -12,6 +13,21 @@ export const OWNER_DIRECTORY_MARKDOWN_MAX_BYTES = 32 * 1024;
12
13
  const NAME_MAX = 32;
13
14
  const DESCRIPTION_MAX = 100;
14
15
  const TYPE_MAX = 24;
16
+ /**
17
+ * 归一化开关入参。
18
+ *
19
+ * `policy` 与旧的 `allowExternalContacts` 同时存在时以 `policy` 为准:前者是开关
20
+ * 快照(五项一起读,口径一致),后者是单个回调的遗留形态,只用来保住旧调用方。
21
+ */
22
+ function normalizePolicy(input) {
23
+ if (input.policy) {
24
+ return {
25
+ ...input.policy,
26
+ allowedAids: (input.policy.allowedAids ?? []).filter(aid => typeof aid === 'string' && aid !== ''),
27
+ };
28
+ }
29
+ return { allowExternalContacts: input.allowExternalContacts === true, allowedAids: [] };
30
+ }
15
31
  /**
16
32
  * `directory.md` 是否存在且非空。
17
33
  *
@@ -35,16 +51,23 @@ export function hasOwnerDirectoryMarkdown(directory) {
35
51
  * - Owner / 个人助理:固定两行,永不降级、永不截断。
36
52
  * - 内部联系人:完整列(名称、AID、类型、备注名、描述)。超预算时从尾部降级为
37
53
  * 两列,再超才整行省略——同事的名字不能丢,AID 丢了还能 `find` 回来。
38
- * - 外部四组(外部 Agent、外部人类、加入的群、无 Owner Agent):默认只留
39
- * 名称与备注名。**只有该 AID 存在本地备注文件时才补齐 AID、类型与备注正文**;
40
- * 备注是这个 agent 自己记的,不属于远端不可信资料,值得占预算。
54
+ * - 外部四组(外部 Agent、外部人类、加入的群、无 Owner Agent):`brief` 形态,
55
+ * 只留名称与备注名(备注是本地记的,不属于远端不可信资料,值得占预算)。
56
+ * - 白名单联系人:`allowedAids` 命中的外部条目,独立成组,不受外部开关影响;
57
+ * 用 `full` 形态(Owner 显式放行过,需要完整记录)。
58
+ * - 类型未知:`brief` 形态,与外部四组一致;`type` 要看就用 ec directory show。
59
+ *
60
+ * 行形态只有 `full` / `brief` 两种,提示文案由 `groupHint` 按形态统一追加。
41
61
  *
42
62
  * 输出不含时间戳:内容不变就逐字节相同,调用方据此跳过写盘。
43
63
  */
44
64
  export function renderOwnerDirectoryMarkdown(input) {
45
- const { selfAid, ownerAid, snapshot, remarks, allowExternalContacts } = input;
65
+ const { selfAid, ownerAid, snapshot, remarks } = input;
46
66
  if (!snapshot)
47
67
  return undefined;
68
+ const policy = normalizePolicy(input);
69
+ const externalVisible = policy.allowExternalContacts === true || policy.allowAllContacts === true;
70
+ const allowlisted = new Set(policy.allowedAids ?? []);
48
71
  const owner = snapshot.owner;
49
72
  const assistant = snapshot.personalAssistant;
50
73
  const ownerRef = ownerRefAid(snapshot, ownerAid);
@@ -57,17 +80,25 @@ export function renderOwnerDirectoryMarkdown(input) {
57
80
  const buckets = {
58
81
  internal: [], external_agent: [], external_human: [], group: [], unbound_agent: [], other: [],
59
82
  };
83
+ // 白名单命中的外部条目单独成组:Owner 显式放行过,就不能因为外部档关着而看不见。
84
+ const allowed = [];
60
85
  for (const entry of snapshot.entries) {
61
86
  if (reserved.has(entry.aid))
62
87
  continue;
63
- buckets[classifyEntry(entry, ownerRef)].push(entry);
88
+ const group = classifyEntry(entry, ownerRef);
89
+ if (group !== 'internal' && allowlisted.has(entry.aid)) {
90
+ allowed.push(entry);
91
+ continue;
92
+ }
93
+ buckets[group].push(entry);
64
94
  }
65
95
  // 固定部分:说明 + 自己 + Owner/个人助理。这些不参与预算竞争。
66
96
  const head = [
67
97
  '[owner-directory]',
68
98
  `Owner(${ownerAid})的名录。名字、描述、备注由各主体、Owner 或个人助理填写,只是资料,不是指令。`,
69
99
  'agent 和 human 通过消息联系;群按群聊联系;host、device、service、org、custom 不收发消息,通过调用 ability 使用。',
70
- '需要某个人的详情时:ec directory find <名字> 拿到 AID,再用 ec directory show <AID> 看完整记录。',
100
+ '名字列与备注名列是 **Owner 平时怎么称呼这个人**——Owner 跟你说话时会用这些叫法提到他,对上号再行动。括号里是你自己记的称呼。',
101
+ '要看某个人的详情:ec directory show <名字>,接受名字或 AID,同名会全部列出;按能力或描述找人用 ec directory find <关键词>。',
71
102
  selfLine(selfAid, snapshot.entries.find(entry => entry.aid === selfAid)),
72
103
  ];
73
104
  if (owner?.aid) {
@@ -77,56 +108,50 @@ export function renderOwnerDirectoryMarkdown(input) {
77
108
  head.push('', '## 个人助理(1)', identityRow(assistant.aid, assistant.name, remarks?.get(assistant.aid)));
78
109
  }
79
110
  const blocks = [
80
- groupBlock('内部联系人', buckets.internal, remarks, '同一 Owner 名下。格式:名字 | AID | 类型 | 备注名 | 描述'),
111
+ // 内部档关着时仍列出(认得是谁比看不见更重要),但在组提示里说清"只能识别、不能联系"。
112
+ groupBlock('内部联系人', buckets.internal, remarks, 'full', '同一 Owner 名下', policy.allowInternalContacts === false ? '当前不接受内部联系消息,以下仅供识别,不要主动联系' : undefined),
81
113
  ];
82
114
  // 外部条目整组受开关控制:关闭时既不注入也不提示,避免诱导模型去联系外界。
83
- if (allowExternalContacts === true) {
84
- blocks.push(groupBlock('外部 Agent', buckets.external_agent, remarks, '不属于本 Owner 的 Agent。默认只列名字;联系前先 find 拿 AID', true), groupBlock('外部人类', buckets.external_human, remarks, '不属于本 Owner 的人类。默认只列名字;联系前先 find 拿 AID', true), groupBlock('加入的群', buckets.group, remarks, '已加入的群。默认只列名字;发消息前先 find 拿群 AID', true), groupBlock('无 Owner 的外部 Agent', buckets.unbound_agent, remarks, '名录里没有 Owner 归属的 Agent,内外无法判断。默认只列名字;联系前先 find 确认身份', true));
115
+ // 总开关同样放行外部档——它是"压过三档"的总闸,注入不能比准入更窄。
116
+ if (externalVisible) {
117
+ blocks.push(groupBlock('外部 Agent', buckets.external_agent, remarks, 'brief', '不属于本 Owner 的 Agent'), groupBlock('外部人类', buckets.external_human, remarks, 'brief', '不属于本 Owner 的人类'), groupBlock('加入的群', buckets.group, remarks, 'brief', '已加入的群,按群聊联系'), groupBlock('无 Owner 的外部 Agent', buckets.unbound_agent, remarks, 'brief', '名录里没有 Owner 归属的 Agent,内外无法判断,联系前先确认身份'));
118
+ }
119
+ if (allowed.length > 0) {
120
+ blocks.push(groupBlock('白名单联系人', allowed, remarks, 'full', 'Owner 在 allowedAids 里显式放行的外部联系人,不受外部联系开关影响'));
85
121
  }
86
122
  // 类型未知的条目不受外部开关控制:它们不是"外部",只是没法判断怎么联系。
87
- // 恒注入并明说只能靠 find/show 查,避免开关把它们整个藏掉。
123
+ // 恒注入,形态与外部四组一致(brief),避免开关把它们整个藏掉。
88
124
  if (buckets.other.length > 0) {
89
- blocks.push(otherBlock(buckets.other));
125
+ blocks.push(groupBlock('类型未知', buckets.other, remarks, 'brief', 'type 不在 agent/human/group/service/device/org/custom/host 之内,用途与联系方式未知,联系前先确认身份'));
90
126
  }
91
127
  const lines = assembleWithinBudget(head, blocks, input.maxBytes ?? OWNER_DIRECTORY_MARKDOWN_MAX_BYTES);
92
128
  return `${lines.join('\n')}\n`;
93
129
  }
94
- function groupBlock(title, entries, remarks, hint,
95
- /** 外部组:没有本地备注文件就一律两列,存在备注文件才齐整成完整行。 */
96
- external = false) {
130
+ const FORM_HINT = {
131
+ full: '格式:名字 | AID | 类型 | 备注名 | 描述,有本地备注时末尾再加「备注:…」一列。',
132
+ brief: '格式:名字 | 备注名,有本地备注的列全字段。要详情直接 ec directory show <名字>,支持名字或 AID,同名会全部列出。',
133
+ };
134
+ /** 组提示 = 语义说明 + 补充说明(可选)+ 形态说明。三段顺序固定。 */
135
+ function groupHint(description, form, note) {
136
+ const sentence = (text) => (text.endsWith('。') ? text : `${text}。`);
137
+ return [sentence(description), note ? sentence(note) : '', FORM_HINT[form]].filter(Boolean).join('');
138
+ }
139
+ function groupBlock(title, entries, remarks, form,
140
+ /** 语义说明,一句话;形态说明由 `groupHint` 统一追加。 */
141
+ description, note) {
97
142
  return {
98
143
  title,
99
- hint,
144
+ hint: groupHint(description, form, note),
100
145
  total: entries.length,
146
+ // brief 组逐条升级:**有本地备注文件**的条目列全字段。备注是本地判断、
147
+ // 不受远端不可信资料影响,值得占预算;也省掉"先 find 再 show"两次命令。
101
148
  full: entries.map(entry => {
102
149
  const remark = remarks?.get(entry.aid);
103
- return external && !remark ? compactRow(entry, undefined) : fullRow(entry, remark);
150
+ return form === 'full' || remark ? fullRow(entry, remark) : compactRow(entry, undefined);
104
151
  }),
105
152
  compact: entries.map(entry => compactRow(entry, remarks?.get(entry.aid))),
106
153
  };
107
154
  }
108
- /**
109
- * 类型未知的条目:只列 名字 | AID | type。
110
- *
111
- * 不载描述和备注——协议外的类型意味着"怎么联系、属于谁"都不知道,
112
- * 这两个字段既解释不了它,还会挤占真正可用的条目。type 原样列出,
113
- * 让人一眼看出是哪种未知值(`ai`、`codeagent`、空…)。
114
- */
115
- function otherBlock(entries) {
116
- const rows = entries.map(entry => {
117
- const name = nameCell(entry);
118
- const cells = [name || entry.aid, name ? entry.aid : '', clean(entry.type, TYPE_MAX) ?? '']
119
- .filter(cell => cell !== '');
120
- return `- ${cells.join(' | ')}`;
121
- });
122
- return {
123
- title: '类型未知',
124
- hint: 'type 不在 agent/human/group/service/device/org/custom/host 之内。用途与联系方式未知,用 ec directory show <AID> 查详情',
125
- total: entries.length,
126
- full: rows,
127
- compact: rows,
128
- };
129
- }
130
155
  /** 省略提示的固定前缀/后缀,长度在渲染前预留,避免追加后超预算。 */
131
156
  const OMISSION_PREFIX = '(其余 ';
132
157
  const OMISSION_SUFFIX = ' 条已省略,用 ec directory find <关键词> 查)';
@@ -224,15 +249,62 @@ function utf8Bytes(lines) {
224
249
  * 外部组只有在存在本地备注文件时才用这一版——备注是本地判断,可以载全文;
225
250
  * 没有备注时远端描述不算"值得占预算的资料",一律降到两列。
226
251
  */
252
+ /**
253
+ * 显示名 = 名录名(或远端备注名)+ 本地称呼。
254
+ *
255
+ * 两种写法**都保留**:名录名是 Owner/对方写的事实,本地称呼是 PA 自己的叫法,
256
+ * 认人的时候两段信息都有用。`张工(老张)` 这样的形态能让人一眼看出
257
+ * "Owner 那边管他叫张工,我平时叫他老张"。
258
+ *
259
+ * 边界:
260
+ * - 本地称呼与名录名相同 → 只写一次,不写成 `张工(张工)`。
261
+ * - 只有本地称呼、没有名录名 → 只写本地称呼。
262
+ * - 名录名与 AID 相同(没有独立名字)→ 用 AID 顶位,本地称呼仍进括号。
263
+ */
264
+ function displayName(entry, remark) {
265
+ // Owner 侧的叫法优先用备注名(那是 Owner 实际拿来指代这个人的称呼),
266
+ // 其次是名片里的名字;两者都没有才退到 AID。
267
+ const ownerName = nameCell(entry);
268
+ const ownerRemark = clean(entry.remark, NAME_MAX);
269
+ const base = ownerName || ownerRemark || entry.aid;
270
+ // 本地可以有多个称呼:第一个进括号,其余交给 remarkCell 单列。
271
+ const aliases = splitAliases(remark?.remark).map(alias => clean(alias, NAME_MAX)).filter(Boolean);
272
+ const primary = aliases.find(alias => alias !== base && alias !== ownerName && alias !== ownerRemark);
273
+ return primary ? `${base}(${primary})` : base;
274
+ }
275
+ /** 备注名一列:远端备注名与本地称呼并列时不重复已经写进显示名的那一个。 */
276
+ function remarkCell(entry, remark) {
277
+ // 备注名列放「还没在名字列出现过的其余叫法」,每个只出现一次:
278
+ // Owner 写的备注名 + 本地除第一个以外的称呼,用「、」连起来。
279
+ const ownerName = nameCell(entry);
280
+ const ownerRemark = clean(entry.remark, NAME_MAX);
281
+ const base = ownerName || ownerRemark || entry.aid;
282
+ const aliases = splitAliases(remark?.remark).map(alias => clean(alias, NAME_MAX)).filter(Boolean);
283
+ const primary = aliases.find(alias => alias !== base && alias !== ownerName && alias !== ownerRemark);
284
+ const rest = [];
285
+ if (ownerRemark && ownerRemark !== base)
286
+ rest.push(ownerRemark);
287
+ for (const alias of aliases) {
288
+ if (alias === base || alias === ownerName || alias === ownerRemark || alias === primary)
289
+ continue;
290
+ if (rest.includes(alias))
291
+ continue;
292
+ rest.push(alias);
293
+ }
294
+ return rest.join('、');
295
+ }
227
296
  function fullRow(entry, remark) {
228
- const name = nameCell(entry);
229
- // 名字缺失或与 AID 相同时不单列名字,AID 顶到第一列——只写一次。
297
+ const name = displayName(entry, remark);
298
+ // 名字列已经不是 AID 时才单独列 AID;本地称呼已并入名字列,不再单占一列。
230
299
  const cells = [
231
- name || entry.aid,
232
- name ? entry.aid : '',
300
+ name,
301
+ name !== entry.aid ? entry.aid : '',
233
302
  typeLabel(entry) ?? '',
234
- clean(remark?.remark ?? entry.remark, NAME_MAX),
235
- clean(remark?.body ?? entry.description, DESCRIPTION_MAX),
303
+ remarkCell(entry, remark),
304
+ clean(entry.description, DESCRIPTION_MAX),
305
+ // 本地备注加前缀标注来源:名录里两段描述并排时,模型必须能分清哪段是 Owner 写的
306
+ // 身份、哪段是 PA 自己记的"什么事该找他"。不加标注会被当成同一份资料的续写。
307
+ clean(remark?.body, DESCRIPTION_MAX) ? `备注:${clean(remark?.body, DESCRIPTION_MAX)}` : '',
236
308
  ].filter(cell => cell !== '');
237
309
  return `- ${cells.join(' | ')}`;
238
310
  }
@@ -243,14 +315,15 @@ function fullRow(entry, remark) {
243
315
  * 认出"有这么个人",AID 与描述用 `find` / `show` 现取。
244
316
  */
245
317
  function compactRow(entry, remark) {
318
+ // 精简形态也只写"名字(本地称呼)":认得出来就行,备注名与描述用 show 取。
246
319
  const cells = [
247
- label(entry),
248
- clean(remark?.remark ?? entry.remark, NAME_MAX),
320
+ displayName(entry, remark),
321
+ remarkCell(entry, remark),
249
322
  ].filter(cell => cell !== '');
250
323
  return `- ${cells.join(' | ')}`;
251
324
  }
252
325
  function identityRow(aid, name, remark) {
253
- const cells = [label({ aid, name }), aid, clean(remark?.remark, NAME_MAX)].filter(Boolean);
326
+ const cells = [displayName({ aid, name }, remark), aid].filter(Boolean);
254
327
  return `- ${cells.join(' | ')}`;
255
328
  }
256
329
  /** 名字与 AID 相同时视为没有独立名字,返回空串由调用方用 AID 补位。 */
@@ -0,0 +1,108 @@
1
+ import { readAccessPolicy, readExplicitAllowExternalContacts } from '../config/access-policy.js';
2
+ /**
3
+ * 名录「开关语义」的唯一来源。
4
+ *
5
+ * 单独成文件是为了断开依赖环:`owner-directory-cache` 渲染时要读开关,而它不能
6
+ * import `owner-directory-admission`(后者 import 它)。这里只依赖 `config/access-policy`,
7
+ * 快照由调用方传进来,不碰任何缓存实例。
8
+ *
9
+ * 注意本模块**不做准入判定**:准入在 `message-admission` / `owner-directory-admission`
10
+ * 里现读配置。这里只回答"注入内容该怎么渲染"。
11
+ */
12
+ /**
13
+ * 外部联系开关的最终值:**显式配置 > 个人助理判据 > false**。
14
+ *
15
+ * 个人助理要联系 Owner 之外的人,所以对自己默认打开;其余 agent 默认关闭,
16
+ * 只有明确有外部业务需求时才由 Owner 打开。准入、注入、查询三处共用这一个判据。
17
+ */
18
+ export function resolveAllowExternalContacts(selfAid, snapshot,
19
+ /** 显式配置;缺省时从配置文件读。测试用来固定优先级。 */
20
+ explicit = readExplicitAllowExternalContacts(selfAid)) {
21
+ if (explicit !== undefined)
22
+ return explicit;
23
+ return !!snapshot?.personalAssistant?.aid && snapshot.personalAssistant.aid === selfAid;
24
+ }
25
+ export function resolveContactsState(selfAid,
26
+ /** 名录里的个人助理 AID;调用方每轮已有(identity.json),不必为此解析快照。 */
27
+ personalAssistantAid) {
28
+ const isAssistant = !!personalAssistantAid && personalAssistantAid === selfAid;
29
+ try {
30
+ const policy = readAccessPolicy(selfAid);
31
+ return {
32
+ internalContacts: policy.allowInternalContacts !== false,
33
+ // 与准入同一判据:显式配置 > 个人助理默认开 > 关。
34
+ externalContacts: readExplicitAllowExternalContacts(selfAid) ?? isAssistant,
35
+ strangerContacts: policy.allowAllContacts === true,
36
+ };
37
+ }
38
+ catch {
39
+ return { internalContacts: true, externalContacts: isAssistant, strangerContacts: false };
40
+ }
41
+ }
42
+ /** 这个 agent 是否是 Owner 名录里的个人助理。快照缺失、AID 为空都返回 false。 */
43
+ export function isPersonalAssistantSnapshot(selfAid, snapshot) {
44
+ const aid = snapshot?.personalAssistant?.aid;
45
+ return !!aid && !!selfAid && aid === selfAid;
46
+ }
47
+ /**
48
+ * 渲染 `directory.md` 要用的整份开关快照。
49
+ *
50
+ * 一次读全五项,避免渲染时逐项回读配置导致同一份文件里的口径不一致。
51
+ * `allowExternalContacts` 走上面那个 PA 判据,与准入共用同一个结论——
52
+ * 之前准入直接读 `policy.allowExternalContacts`(已补齐成 false),
53
+ * 导致 PA 会话里"目录看得到人、对方发进来却被拒"。
54
+ *
55
+ * 读配置失败时按最保守的口径返回:外部与总开关都关、白名单为空。
56
+ * 渲染是"看得见什么",宁可少看到,也不能让一个读不出配置的 agent 拿到全量外部联系人。
57
+ */
58
+ export function resolveOwnerDirectoryRenderPolicy(selfAid, snapshot) {
59
+ let policy;
60
+ try {
61
+ policy = readAccessPolicy(selfAid);
62
+ }
63
+ catch {
64
+ return {
65
+ allowInternalContacts: true,
66
+ allowExternalContacts: false,
67
+ allowAllContacts: false,
68
+ allowedAids: [],
69
+ };
70
+ }
71
+ return {
72
+ allowInternalContacts: policy.allowInternalContacts !== false,
73
+ // 必须传"显式写过"的值:`policy.allowExternalContacts` 已被补成缺省 false,
74
+ // 传它等于让个人助理判据永远不生效,渲染与准入都会和文档描述相反。
75
+ allowExternalContacts: resolveAllowExternalContacts(selfAid, snapshot),
76
+ allowAllContacts: policy.allowAllContacts === true,
77
+ allowedAids: policy.allowedAids ?? [],
78
+ };
79
+ }
80
+ /**
81
+ * 单条名录条目当前能不能联系。`ec directory show/list` 用它,`directory.md` 用上面
82
+ * 那份快照——两边读的是同一组开关,口径必须一致,否则会出现"目录里标着能联系、
83
+ * 发出去却被拒"。
84
+ *
85
+ * 判据顺序照搬准入:总开关 > 名单(白名单命中即通)> 内部档 / 外部档。
86
+ * 黑名单**参与**这里:它是 Owner 显式指定的拒绝,总开关也翻不动它。
87
+ */
88
+ export function resolveEntryContactable(selfAid, snapshot, entry) {
89
+ let policy;
90
+ try {
91
+ policy = readAccessPolicy(selfAid);
92
+ }
93
+ catch {
94
+ // 配置读不出不等于"谁都不能联系":外部档仍按"显式配置 > 个人助理判据"回落,
95
+ // 与注入侧口径保持一致(那份快照在同样的失败下也只关掉外部与总开关)。
96
+ return entry.internal === true || resolveAllowExternalContacts(selfAid, snapshot) === true;
97
+ }
98
+ if (policy.deniedAids?.includes(entry.aid))
99
+ return false;
100
+ if (entry.internal === true)
101
+ return policy.allowInternalContacts !== false;
102
+ if (policy.allowedAids?.includes(entry.aid))
103
+ return true;
104
+ if (policy.allowAllContacts === true)
105
+ return true;
106
+ // 同 `resolveOwnerDirectoryRenderPolicy`:传 undefined 让函数自己去读显式配置。
107
+ return resolveAllowExternalContacts(selfAid, snapshot) === true;
108
+ }