evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -4,12 +4,31 @@ import path from 'node:path';
4
4
  import { createHash } from 'node:crypto';
5
5
  import { gzipSync, gunzipSync } from 'node:zlib';
6
6
  import { loadTemplate } from './template.mjs';
7
- import { normalizeTeam, normalizeTeamSchema, validateContractSchema, readTeamSchema, packageSchema, contractDigest, canonicalJson, validateBuildSelection } from './template-contract.mjs';
8
- import { BASEAGENTS, assertPublicTemplateConfig } from './template-runtime.mjs';
7
+ import { resolveTemplateAidDomain } from './template-contract.mjs';
8
+ import { AID_PATTERN, normalizeTeam, normalizeTeamSchema, validateContractSchema, readTeamSchema, packageSchema, contractDigest, canonicalJson, validateBuildSelection } from './template-contract.mjs';
9
+ import { BASEAGENTS, assertPublicTemplateConfig, resolveMemberParameters, partitionTeamMembers, validateAccessDeclaration } from './template-runtime.mjs';
9
10
 
10
11
  export const PACKAGE_LIMITS = { file: 20 * 1024 * 1024, total: 200 * 1024 * 1024, entries: 20000 };
11
12
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
12
13
  const json = value => Buffer.from(JSON.stringify(value, null, 2) + '\n');
14
+ let eventPackRuntime;
15
+ const eventValidator = new URL('../../../dist/event-center/validation.js', import.meta.url);
16
+ const eventInstaller = new URL('../../../dist/core/pack-install.js', import.meta.url);
17
+ if (fs.existsSync(eventValidator) && fs.existsSync(eventInstaller)) {
18
+ const [validation, installation] = await Promise.all([import(eventValidator.href), import(eventInstaller.href)]);
19
+ configureTemplateEventPacks({ validatePackJson: validation.validatePackJson, runtimeEntries: installation.PACK_RUNTIME_ENTRIES });
20
+ }
21
+
22
+ /** Standalone consumers inject the real Core validator only when consuming event packs. */
23
+ export function configureTemplateEventPacks({ validatePackJson, runtimeEntries }) {
24
+ check(typeof validatePackJson === 'function' && (runtimeEntries instanceof Set || Array.isArray(runtimeEntries))
25
+ && [...runtimeEntries].every(name => typeof name === 'string'), 'Real Core event-pack validation and runtime entries required');
26
+ eventPackRuntime = { validatePackJson, runtimeEntries: new Set(runtimeEntries) };
27
+ }
28
+ function requireEventPackRuntime() {
29
+ check(eventPackRuntime, 'Core event-pack validator unavailable; configureTemplateEventPacks with the installed Core runtime', 'EVENT_VALIDATOR_UNAVAILABLE');
30
+ return eventPackRuntime;
31
+ }
13
32
  export const packageDigest = bytes => 'sha256:' + createHash('sha256').update(bytes).digest('hex');
14
33
  function check(value, message, code = 'INVALID_ARGUMENT') {
15
34
  if (!value) throw Object.assign(new Error(message), { code });
@@ -30,10 +49,85 @@ export function regularAncestors(file) {
30
49
  }
31
50
  }
32
51
  export function excludedResource(name) {
52
+ if (name === 'prebuild-members.json') return true;
33
53
  return name.split('/').some(part => ['.git', 'node_modules', '.claude'].includes(part)
34
54
  || /^\.env/.test(part) || /\.(?:pem|key|db(?:[-.].*)?)$/i.test(part));
35
55
  }
36
56
 
57
+ /** References live in string literals and comments; bare property chains are not identities. */
58
+ function scriptReferenceText(text) {
59
+ const contexts = [{ quote: '', depth: 0, regexAllowed: true, parens: [], control: false }]; let out = '';
60
+ for (let i = 0; i < text.length; i++) {
61
+ const context = contexts.at(-1); const char = text[i]; const next = text[i + 1];
62
+ if (context.quote) {
63
+ if (char === '\\') { out += char + (next ?? ''); i++; }
64
+ else if (char === context.quote) { contexts.pop(); contexts.at(-1).regexAllowed = false; out += '\n'; }
65
+ else if (context.quote === '`' && char === '$' && next === '{') {
66
+ contexts.push({ quote: '', depth: 1, regexAllowed: true, parens: [], control: false }); out += '\n'; i++;
67
+ } else out += char;
68
+ } else if (char === '/' && next === '/') {
69
+ const end = text.indexOf('\n', i + 2);
70
+ out += '\n' + text.slice(i + 2, end < 0 ? text.length : end) + '\n'; i = end < 0 ? text.length : end;
71
+ } else if (char === '/' && next === '*') {
72
+ const end = text.indexOf('*/', i + 2);
73
+ out += '\n' + text.slice(i + 2, end < 0 ? text.length : end) + '\n'; i = end < 0 ? text.length : end + 1;
74
+ } else if (char === '/' && context.regexAllowed) {
75
+ let bracket = false; let end = i + 1;
76
+ for (; end < text.length && !/[\r\n]/.test(text[end]); end++) {
77
+ if (text[end] === '\\') end++;
78
+ else if (text[end] === '[') bracket = true;
79
+ else if (text[end] === ']') bracket = false;
80
+ else if (text[end] === '/' && !bracket) break;
81
+ }
82
+ if (text[end] === '/') { i = end; context.regexAllowed = false; }
83
+ } else if (['"', "'", '`'].includes(char)) {
84
+ contexts.push({ quote: char, depth: 0, regexAllowed: false }); out += '\n';
85
+ } else if (/[a-zA-Z0-9_$]/.test(char)) {
86
+ const start = i;
87
+ while (/[a-zA-Z0-9_$]/.test(text[i + 1] ?? '')) i++;
88
+ const word = text.slice(start, i + 1);
89
+ context.control = /^(?:if|while|for|with|switch|catch)$/.test(word);
90
+ context.regexAllowed = /^(?:return|throw|case|delete|void|typeof|new|in|instanceof|yield|await|else|do)$/.test(word);
91
+ } else if (!/\s/.test(char)) {
92
+ if (context.depth && char === '{') context.depth++;
93
+ else if (context.depth && char === '}' && --context.depth === 0) { contexts.pop(); out += '\n'; }
94
+ if (char === '(') context.parens.push(context.control);
95
+ context.regexAllowed = char === ')' ? context.parens.pop() === true : ![']', '}', '.'].includes(char);
96
+ context.control = false;
97
+ }
98
+ }
99
+ return out;
100
+ }
101
+
102
+ const aidPattern = new RegExp(AID_PATTERN);
103
+ function extractExternalAids(text, name) {
104
+ if (name === 'template/team.json') {
105
+ const team = JSON.parse(text);
106
+ for (const member of team.agents ?? []) {
107
+ delete member.update;
108
+ if (record(member.config)) delete member.config.update;
109
+ }
110
+ text = JSON.stringify(team);
111
+ }
112
+ let references = /\.(?:[cm]?[jt]s|jsx|tsx)$/i.test(name) ? scriptReferenceText(text) : text;
113
+ if (/\.(?:md|markdown|mdx)$/i.test(name)) {
114
+ references = references.replace(/^([ \t]*)(`{3,}|~{3,})[ \t]*(?:[cm]?[jt]s|javascript|typescript|jsx|tsx)\b[^\n]*\n([\s\S]*?)^\1\2[ \t]*\r?$/gim,
115
+ (_match, _indent, _fence, script) => '\n' + scriptReferenceText(script) + '\n');
116
+ }
117
+ references = references.replace(/<script\b[^>]*>([\s\S]*?)<\/script\s*>/gi,
118
+ (_match, script) => '\n' + scriptReferenceText(script) + '\n');
119
+ // Mask each URL/placeholder occurrence so an independent AID on the same line survives.
120
+ references = references.replace(/\{\{[\s\S]*?\}\}|[a-z][a-z0-9+.-]*:\/\/[^\s"'`<>]+/gi, '\n');
121
+ // Consume entire dotted tokens, including invalid JS identifier characters, before validation.
122
+ const candidates = [...references.matchAll(/(?<![a-zA-Z0-9_$.-])[a-zA-Z0-9_$-]+(?:\.[a-zA-Z0-9_$-]+){2,}(?![a-zA-Z0-9_$-]|\.[a-zA-Z0-9_$-])/g)];
123
+ return candidates.filter(match => {
124
+ const aid = match[0];
125
+ return aidPattern.test(aid) && /\.[a-z]{2,}$/.test(aid)
126
+ && !/\.(?:[cm]?[jt]sx?|json|html|css)$/.test(aid) && !aid.startsWith('www.')
127
+ && !/^\s*\(/.test(references.slice(match.index + aid.length));
128
+ }).map(match => match[0]);
129
+ }
130
+
37
131
  /** Ordered USTAR+gzip, compatible with EvolCore archive(). */
38
132
  export function encodePackageEntries(entries) {
39
133
  check(entries instanceof Map && entries.size && entries.size <= PACKAGE_LIMITS.entries, 'Invalid package entries');
@@ -97,7 +191,8 @@ function portableFile(name, keys) {
97
191
  const relative = rest.join('/');
98
192
  return group === 'workspace' && !excludedResource(relative)
99
193
  || group === 'agents' && (relative.startsWith('personal/soul/') && relative.endsWith('.md') && !relative.endsWith('/00-GUIDE.md')
100
- || relative === 'personal/welcome.md' || relative.startsWith('triggers/') && !excludedResource(relative));
194
+ || relative === 'personal/welcome.md' || relative.startsWith('triggers/') && !excludedResource(relative)
195
+ || isPortableEventPackFile(relative) && !excludedResource(relative));
101
196
  }
102
197
 
103
198
  /** Validate all bytes before extracting; never trusts a MANIFEST path for filesystem access. */
@@ -107,7 +202,8 @@ export function inspectTemplatePackage(bytes, { digest } = {}) {
107
202
  const entries = decodePackageEntries(bytes);
108
203
  const read = name => { check(entries.has(name), 'Missing package entry: ' + name, 'INTEGRITY_FAILED'); return JSON.parse(entries.get(name).bytes.toString('utf8')); };
109
204
  const metadata = read('PACKAGE.json'); const manifest = read('MANIFEST.json');
110
- check(!validateContractSchema(metadata, packageSchema).length, 'Invalid package v2 metadata', 'INTEGRITY_FAILED');
205
+ const metadataErrors = validateContractSchema(metadata, packageSchema);
206
+ check(!metadataErrors.length, 'Invalid package metadata: ' + metadataErrors.join('; '), 'INTEGRITY_FAILED');
111
207
  check(Array.isArray(manifest) && manifest.length && entries.size === manifest.length + 2, 'Invalid manifest', 'INTEGRITY_FAILED');
112
208
  const seen = new Set();
113
209
  for (const entry of manifest) {
@@ -122,18 +218,22 @@ export function inspectTemplatePackage(bytes, { digest } = {}) {
122
218
  const team = normalized.team; const schema = normalizeTeamSchema(read('template/team.schema.json'));
123
219
  const errors = validateContractSchema(team, schema);
124
220
  check(!errors.length, errors.join('; '));
125
- const keys = team.agents.map(agent => agent.key);
221
+ const keys = partitionTeamMembers(team).inlineMembers.map(agent => agent.key);
126
222
  for (const { path: name } of manifest) check(portableFile(name, keys), 'Unsupported portable resource: ' + name);
223
+ validateEventPackEntries(new Map([...entries].filter(([name]) => name.startsWith('template/'))
224
+ .map(([name, entry]) => [name.slice('template/'.length), entry])), keys);
127
225
  return { metadata, team, schema, entries, digest: actual, changes: normalized.changes,
128
226
  resources: manifest.map(({ path: name, size }) => ({ path: name, size })) };
129
227
  }
130
228
 
131
229
  /** Directory adapter: reads exactly one keyed member and snapshots all source bytes/permissions. */
132
- export function collectTemplateDirectory(templateDir, memberKey) {
230
+ export function collectTemplateDirectory(templateDir, memberKey, { includeWorkspace = true } = {}) {
133
231
  regularAncestors(templateDir);
134
- const { tpl, errors } = loadTemplate(templateDir);
232
+ const { tpl, errors } = loadTemplate(templateDir, { includeWorkspace });
135
233
  check(!errors.length, errors.join('; '));
136
- check(tpl.keys.includes(memberKey), 'Unknown directory member: ' + memberKey);
234
+ const declaredMember = tpl.team.agents.find(agent => agent.key === memberKey);
235
+ check(declaredMember?.optional !== true, 'Optional member is an ID reference, not a collectable Agent: ' + memberKey);
236
+ check(tpl.actualKeys.includes(memberKey), 'Unknown actual directory member: ' + memberKey);
137
237
  const excluded = [];
138
238
  const readOptional = relative => {
139
239
  const file = path.join(tpl.root, ...relative.split('/'));
@@ -142,10 +242,12 @@ export function collectTemplateDirectory(templateDir, memberKey) {
142
242
  const defaults = readOptional('.evolcore/agents/defaults.json');
143
243
  const providers = readOptional('.evolcore/providers.json').providers ?? {};
144
244
  const member = structuredClone(tpl.team.agents.find(agent => agent.key === memberKey));
245
+ Object.assign(member, resolveMemberParameters(member));
145
246
  const source = { ...structuredClone(defaults), ...member.config,
146
247
  baseagents: { ...defaults.baseagents, ...member.config?.baseagents } };
147
248
  const config = {};
148
249
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
250
+ if (Object.hasOwn(member.config ?? {}, 'access')) config.access = validateAccessDeclaration(member.config.access);
149
251
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
150
252
  for (const [name, sourceBlock] of Object.entries(source.baseagents)) {
151
253
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
@@ -156,7 +258,8 @@ export function collectTemplateDirectory(templateDir, memberKey) {
156
258
  for (const field of ['model', 'effort', 'params']) if (block[field] !== undefined) config.baseagents[name][field] = structuredClone(block[field]);
157
259
  }
158
260
  check(config.baseagents[config.active_baseagent], 'Default baseagent must have a binding: ' + memberKey);
159
- for (const field of Object.keys(member.config ?? {})) if (!Object.hasOwn(config, field)) excluded.push('members/' + memberKey + '/config/' + field);
261
+ for (const field of Object.keys(member.config ?? {})) if (!Object.hasOwn(config, field)
262
+ && !['version', 'update'].includes(field)) excluded.push('members/' + memberKey + '/config/' + field);
160
263
  member.config = config;
161
264
  const entries = new Map(); const snapshot = [];
162
265
  for (const relative of tpl.files) {
@@ -168,30 +271,39 @@ export function collectTemplateDirectory(templateDir, memberKey) {
168
271
  if (!portableFile(name, [memberKey])) { excluded.push(name); continue; }
169
272
  entries.set(name, { bytes, mode: stat.mode & 0o777 });
170
273
  }
171
- const resources = { baseagents: Object.keys(config.baseagents).sort(), triggers: [], skills: [], files: [] };
274
+ const resources = { baseagents: Object.keys(config.baseagents).sort(), triggers: [], events: [], skills: [], files: [] };
172
275
  for (const name of entries.keys()) {
173
276
  if (name.startsWith('workspace/' + memberKey + '/')) resources.files.push(name.slice(('workspace/' + memberKey + '/').length));
174
277
  if (name.startsWith('agents/' + memberKey + '/triggers/')) resources.triggers.push(name.split('/')[3]);
278
+ if (name.startsWith('agents/' + memberKey + '/events/')) resources.events.push(name.split('/')[3]);
175
279
  if (name.startsWith('.evolcore/skills/')) resources.skills.push(name.split('/')[2]);
176
280
  }
177
281
  resources.skills.push(...Object.keys(member.skills ?? {}));
178
282
  for (const kind of Object.keys(resources)) resources[kind] = [...new Set(resources[kind])].sort();
179
283
  return { member, entries, excluded, platforms: [...tpl.team.host.platform].sort(),
180
- sourceDigest: contractDigest({ snapshot, member, metadata: { name: tpl.team.name, version: tpl.team.version } }), resources,
284
+ sourceDigest: contractDigest({ snapshot, member, metadata: { name: tpl.team.id, version: tpl.team.version } }), resources,
181
285
  defaultBaseagent: config.active_baseagent, warnings: [] };
182
286
  }
183
287
 
184
288
  /** One pure package planner for both runtime-agent and directory collection adapters. */
185
- export function buildTemplatePackage({ metadata, members, externalAids = [], publisher, createdAt, evolcoreRange = '>=0.0.43-test.8' }) {
186
- const team = { $schema_version: 1, name: metadata.id, title: metadata.name, version: metadata.version,
289
+ export function buildTemplatePackage({ metadata, members, externalAids = [], publisher, createdAt, evolcoreRange = '>=0.0.43-test.8',
290
+ memberReferences: references = { optional: [], external: [] }, externalContacts, assistantKey }) {
291
+ const team = { $schema_version: 1, id: metadata.id, title: metadata.name, version: metadata.version,
187
292
  ...(metadata.description !== undefined ? { description: metadata.description } : {}), host: { platform: structuredClone(metadata.platforms) }, agents: [] };
188
293
  const entries = new Map(); const excluded = []; const external = new Set(externalAids);
189
294
  for (const [key, collected] of Object.entries(members)) {
190
295
  const { member, include } = collected;
191
296
  check(record(member) && record(include), 'Collected member and selection required');
297
+ if (member.optional === true) {
298
+ check(collected.entries instanceof Map && collected.entries.size === 0, 'Optional references cannot carry executable resources');
299
+ team.agents.push({ ...structuredClone(member), key });
300
+ continue;
301
+ }
192
302
  check(include.baseagents.includes(member.config?.active_baseagent), 'Default baseagent is required: ' + key);
193
303
  const chosen = structuredClone(member);
304
+ Object.assign(chosen, resolveMemberParameters(chosen));
194
305
  assertPublicTemplateConfig(chosen.config);
306
+ for (const field of ['version', 'update']) delete chosen.config[field];
195
307
  chosen.config.baseagents = Object.fromEntries(Object.entries(chosen.config.baseagents).filter(([name]) => include.baseagents.includes(name)));
196
308
  chosen.skills = Object.fromEntries(Object.entries(chosen.skills ?? {}).filter(([name]) => include.skills.includes(name)));
197
309
  team.agents.push({ ...chosen, key });
@@ -201,13 +313,26 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
201
313
  check(portableFile(name, [key]), 'Unsupported collected resource: ' + name);
202
314
  const selected = name.startsWith('workspace/') ? include.files.includes(name.slice(('workspace/' + key + '/').length))
203
315
  : name.startsWith('.evolcore/skills/') ? include.skills.includes(name.split('/')[2])
204
- : name.startsWith('agents/' + key + '/triggers/') ? include.triggers.includes(name.split('/')[3]) : true;
316
+ : name.startsWith('agents/' + key + '/triggers/') ? include.triggers.includes(name.split('/')[3])
317
+ : name.startsWith('agents/' + key + '/events/') ? (include.events ?? []).includes(name.split('/')[3]) : true;
205
318
  if (!selected) { excluded.push(name); continue; }
206
319
  const target = 'template/' + name;
207
320
  if (entries.has(target)) check(entries.get(target).bytes.equals(entry.bytes) && entries.get(target).mode === entry.mode, 'Conflicting shared resource', 'SOURCE_CHANGED');
208
321
  entries.set(target, { bytes: Buffer.from(entry.bytes), mode: entry.mode });
209
322
  }
210
323
  }
324
+ check(record(references) && Array.isArray(references.optional) && Array.isArray(references.external), 'Invalid member references');
325
+ team.agents.push(...structuredClone(references.optional));
326
+ if (references.external.length) team.external_contacts = structuredClone(references.external);
327
+ if (externalContacts !== undefined) {
328
+ check(Array.isArray(externalContacts), 'externalContacts must be an array');
329
+ check(!references.external.length || canonicalJson(references.external) === canonicalJson(externalContacts), 'Conflicting external contact declarations');
330
+ team.external_contacts = structuredClone(externalContacts);
331
+ }
332
+ if (assistantKey !== undefined) {
333
+ team.personal_assistant = team.agents.findIndex(member => member.key === assistantKey);
334
+ check(team.personal_assistant >= 0, 'Unknown personal assistant key');
335
+ }
211
336
  const normalized = normalizeTeam(team);
212
337
  check(!normalized.errors.length, normalized.errors.join('; '));
213
338
  entries.set('template/team.json', { bytes: json(team), mode: 0o644 });
@@ -219,18 +344,21 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
219
344
  memberReferences ||= /\{\{\s*members\./.test(line);
220
345
  check(!/(?:sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|AKIA[A-Z0-9]{16}|-----BEGIN .*PRIVATE KEY|(?:API_KEY|TOKEN|SECRET|PASSWORD)\s*=\s*(?!\$\{)\S{8,})/i.test(line),
221
346
  'Credential content in portable resource: ' + name, 'SCAN_BLOCKED');
222
- for (const aid of line.match(/[a-z0-9][a-z0-9_-]*\.(?:[a-z0-9-]+\.)+[a-z]{2,}/gi) ?? []) {
223
- if (!line.includes('://' + aid) && !aid.startsWith('www.') && !line.includes('{{' + aid + '}}') && !new RegExp('\\{\\{\\s*' + aid.replaceAll('.', '\\.') + '\\s*\\}\\}').test(line)) external.add(aid);
224
- }
225
347
  }
348
+ for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
226
349
  }
227
350
  if (memberReferences && evolcoreRange === '>=0.0.43-test.8') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
351
+ const templateFeatures = [
352
+ ...(memberReferences ? ['member-references-v1'] : []),
353
+ ...(team.agents.some(member => member.optional) || team.external_contacts?.length ? ['optional-members-v1'] : []),
354
+ ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/events\//.test(name)) ? ['event-packs-v1'] : []),
355
+ ];
228
356
  const info = { $schema_version: 1, id: metadata.id, name: metadata.name, version: metadata.version,
229
357
  ...(publisher !== undefined ? { publisher: structuredClone(publisher) } : {}), ...(createdAt !== undefined ? { createdAt } : {}),
230
358
  ...(metadata.description !== undefined ? { description: metadata.description } : {}),
231
359
  compat: { platforms: structuredClone(metadata.platforms), evolcore: evolcoreRange,
232
- ...(memberReferences ? { templateFeatures: ['member-references-v1'] } : {}),
233
- baseagents: [...new Set(team.agents.flatMap(member => Object.keys(member.config.baseagents)))].sort() },
360
+ ...(templateFeatures.length ? { templateFeatures } : {}),
361
+ baseagents: [...new Set(team.agents.flatMap(member => Object.keys(member.config?.baseagents ?? {})))].sort() },
234
362
  externalAids: [...external].sort() };
235
363
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
236
364
  entries.set('PACKAGE.json', { bytes: json(info), mode: 0o644 });
@@ -254,11 +382,15 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
254
382
  const defaults = readOptional('.evolcore/agents/defaults.json');
255
383
  const providers = readOptional('.evolcore/providers.json').providers ?? {};
256
384
  if (team.host.config !== undefined) { delete team.host.config; excluded.push('host.config'); }
385
+ if (team.host.name !== undefined) { delete team.host.name; excluded.push('host.name'); }
257
386
  for (const agent of team.agents) {
387
+ if (agent.optional === true) continue;
388
+ Object.assign(agent, resolveMemberParameters(agent));
258
389
  const source = { ...structuredClone(defaults), ...agent.config,
259
390
  baseagents: { ...defaults.baseagents, ...agent.config?.baseagents } };
260
391
  const config = {};
261
392
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
393
+ if (Object.hasOwn(agent.config ?? {}, 'access')) config.access = validateAccessDeclaration(agent.config.access);
262
394
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
263
395
  for (const [name, sourceBlock] of Object.entries(source.baseagents)) {
264
396
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
@@ -269,7 +401,8 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
269
401
  for (const field of ['model', 'effort', 'params']) if (block[field] !== undefined) config.baseagents[name][field] = structuredClone(block[field]);
270
402
  }
271
403
  check(config.baseagents[config.active_baseagent], 'Default baseagent must have a binding: ' + agent.key);
272
- for (const field of Object.keys(agent.config ?? {})) if (!Object.hasOwn(config, field)) excluded.push('agents/' + agent.key + '/config/' + field);
404
+ for (const field of Object.keys(agent.config ?? {})) if (!Object.hasOwn(config, field)
405
+ && !['version', 'update'].includes(field)) excluded.push('agents/' + agent.key + '/config/' + field);
273
406
  agent.config = config;
274
407
  assertPublicTemplateConfig(config);
275
408
  }
@@ -280,7 +413,7 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
280
413
  for (const relative of tpl.files) {
281
414
  const name = relative.split(path.sep).join('/');
282
415
  if (['team.json', 'team.schema.json'].includes(name)) continue;
283
- if (!portableFile(name, tpl.keys)) { excluded.push(name); continue; }
416
+ if (!portableFile(name, tpl.actualKeys)) { excluded.push(name); continue; }
284
417
  const file = path.join(tpl.root, relative);
285
418
  entries.set('template/' + name, { bytes: fs.readFileSync(file), mode: fs.statSync(file).mode & 0o777 });
286
419
  }
@@ -294,19 +427,22 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
294
427
  memberReferences ||= /\{\{\s*members\./.test(line);
295
428
  check(!/(?:sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|AKIA[A-Z0-9]{16}|-----BEGIN .*PRIVATE KEY|(?:API_KEY|TOKEN|SECRET|PASSWORD)\s*=\s*(?!\$\{)\S{8,})/i.test(line),
296
429
  'Credential content in portable resource: ' + name, 'SENSITIVE_CONTENT');
297
- for (const aid of line.match(/[a-z0-9][a-z0-9_-]*\.(?:[a-z0-9-]+\.)+[a-z]{2,}/gi) ?? []) {
298
- if (!line.includes('://' + aid) && !aid.startsWith('www.') && !line.includes('{{' + aid + '}}') && !new RegExp('\\{\\{\\s*' + aid.replaceAll('.', '\\.') + '\\s*\\}\\}').test(line)) external.add(aid);
299
- }
300
430
  }
431
+ for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
301
432
  }
302
433
  // Older readers normalize test builds to the final version. The upper bound
303
434
  // makes those readers reject member references instead of leaving old AIDs.
304
435
  if (memberReferences && evolcoreRange === '>=0.0.43') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
305
- const metadata = { $schema_version: 1, id: team.name, name: team.title ?? team.name, version: team.version,
436
+ const templateFeatures = [
437
+ ...(memberReferences ? ['member-references-v1'] : []),
438
+ ...(team.agents.some(member => member.optional) || team.external_contacts?.length ? ['optional-members-v1'] : []),
439
+ ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/events\//.test(name)) ? ['event-packs-v1'] : []),
440
+ ];
441
+ const metadata = { $schema_version: 1, id: team.id, name: team.title ?? team.id, version: team.version,
306
442
  ...(team.description !== undefined ? { description: team.description } : {}), ...(publisher ? { publisher } : {}), createdAt,
307
443
  compat: { platforms: team.host.platform, evolcore: evolcoreRange,
308
- ...(memberReferences ? { templateFeatures: ['member-references-v1'] } : {}),
309
- baseagents: [...new Set(team.agents.flatMap(agent => Object.keys(agent.config.baseagents)))] }, externalAids: [...external].sort() };
444
+ ...(templateFeatures.length ? { templateFeatures } : {}),
445
+ baseagents: [...new Set(team.agents.flatMap(agent => Object.keys(agent.config?.baseagents ?? {})))] }, externalAids: [...external].sort() };
310
446
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
311
447
  entries.set('PACKAGE.json', { bytes: json(metadata), mode: 0o644 });
312
448
  entries.set('MANIFEST.json', { bytes: json(manifest), mode: 0o644 });
@@ -360,8 +496,11 @@ export function attachBuildEnvironment(templateDir, sourceDir) {
360
496
  check(!base.errors.length, 'Invalid build environment: ' + base.errors.join('; '));
361
497
  const teamFile = path.join(templateDir, 'team.json');
362
498
  const team = JSON.parse(fs.readFileSync(teamFile, 'utf8'));
363
- if (base.tpl.team.host?.config !== undefined) team.host.config = structuredClone(base.tpl.team.host.config);
364
- if (base.tpl.team.issuer !== undefined) team.issuer = base.tpl.team.issuer;
499
+ delete team.host.name;
500
+ if (base.tpl.team.host.name !== undefined) team.host.name = base.tpl.team.host.name;
501
+ team.host.config = structuredClone(base.tpl.team.host.config ?? {});
502
+ team.host.config.aun = { ...team.host.config.aun, defaultAidDomain: resolveTemplateAidDomain(base.tpl.team) };
503
+ delete team.issuer;
365
504
  for (const name of ['providers.json', 'agents/defaults.json', '.env']) {
366
505
  const source = path.join(base.tpl.root, '.evolcore', ...name.split('/'));
367
506
  if (!fs.existsSync(source)) continue;
@@ -379,3 +518,89 @@ export function templateProviderSummary(templateDir) {
379
518
  const providers = JSON.parse(fs.readFileSync(file, 'utf8')).providers ?? {};
380
519
  return Object.entries(providers).map(([id, value]) => ({ id, name: value.name ?? id, services: Object.keys(value.services ?? {}) }));
381
520
  }
521
+
522
+ const EVENT_PACK_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
523
+ const TEMPLATE_EVENT_BUS_PATTERN = /^\{\{\s*(?:members\.[a-z0-9][a-z0-9_-]{0,31}\.aid|(?:agent|owner|host)\.aid)\s*\}\}$/;
524
+
525
+ /** Share package definitions/assets, never runtime state, logs, backups or caches. */
526
+ export function isPortableEventPackResource(relative) {
527
+ const { runtimeEntries } = requireEventPackRuntime();
528
+ return relative.split('/').every(part => part && part !== '..' && !part.startsWith('.')
529
+ && !runtimeEntries.has(part) && !['node_modules', '__pycache__'].includes(part)
530
+ && !part.endsWith('_') && !part.endsWith('~') && !/\.(?:bak|pyc)$/i.test(part));
531
+ }
532
+
533
+ export function isPortableEventPackFile(relative) {
534
+ const [group, id, ...rest] = relative.split('/');
535
+ return group === 'events' && EVENT_PACK_NAME_PATTERN.test(id ?? '') && rest.length > 0
536
+ && isPortableEventPackResource(rest.join('/'));
537
+ }
538
+
539
+ /** Reuse the runtime validator; only template bus references need a validation placeholder. */
540
+ export function validateEventPack(raw, files, { template = false, location = 'events' } = {}) {
541
+ const checked = structuredClone(raw);
542
+ if (template && checked && typeof checked === 'object') {
543
+ for (const kind of ['publish', 'subscribe']) if (Array.isArray(checked[kind])) {
544
+ for (const entry of checked[kind]) if (entry && TEMPLATE_EVENT_BUS_PATTERN.test(entry.bus)) entry.bus = packageDigest(entry.bus).slice(7, 23) + '.agentid.cn';
545
+ }
546
+ }
547
+ const result = requireEventPackRuntime().validatePackJson(checked);
548
+ check(result.ok, location + '/pack.json: ' + result.errors.join('; '));
549
+ for (const entry of result.value.subscribe) {
550
+ check(files.includes(entry.handler.script), location + ': missing handler ' + entry.handler.script);
551
+ }
552
+ return raw;
553
+ }
554
+
555
+ function eventPackFiles(root) {
556
+ const files = []; let total = 0;
557
+ const visit = (directory, prefix = '') => {
558
+ for (const entry of fs.readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
559
+ const relative = prefix + entry.name;
560
+ if (!isPortableEventPackResource(relative)) continue;
561
+ check(!entry.isSymbolicLink() && (entry.isFile() || entry.isDirectory()), 'Only regular event-pack files/directories: ' + relative);
562
+ const file = path.join(directory, entry.name);
563
+ if (entry.isDirectory()) visit(file, relative + '/');
564
+ else {
565
+ const size = fs.statSync(file).size; total += size;
566
+ check(files.length < PACKAGE_LIMITS.entries && size <= PACKAGE_LIMITS.file && total <= PACKAGE_LIMITS.total, 'Event-pack size limit exceeded', 'PACKAGE_TOO_LARGE');
567
+ files.push(relative);
568
+ }
569
+ }
570
+ };
571
+ visit(root); return files.sort();
572
+ }
573
+
574
+ /** Read-only inventory: loading must not create logs or migrate source files. */
575
+ export function readEventPacks(eventsDir, { template = false } = {}) {
576
+ if (!fs.existsSync(eventsDir)) return [];
577
+ regularAncestors(eventsDir);
578
+ return fs.readdirSync(eventsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))
579
+ .filter(entry => !entry.name.startsWith('.') && !entry.name.startsWith('_'))
580
+ .flatMap(entry => {
581
+ check(!entry.isSymbolicLink(), 'Symbolic event pack: ' + entry.name);
582
+ if (!entry.isDirectory()) return [];
583
+ const dir = path.join(eventsDir, entry.name);
584
+ if (fs.existsSync(path.join(dir, '.archived'))) return [];
585
+ check(EVENT_PACK_NAME_PATTERN.test(entry.name), 'Invalid event pack name: ' + entry.name);
586
+ const files = eventPackFiles(dir);
587
+ check(files.includes('pack.json'), 'Event pack missing pack.json: ' + entry.name);
588
+ const definition = validateEventPack(JSON.parse(fs.readFileSync(path.join(dir, 'pack.json'), 'utf8')), files, { template, location: 'events/' + entry.name });
589
+ return [{ id: entry.name, dir, files, definition }];
590
+ });
591
+ }
592
+
593
+ /** Validate the complete portable file set, including disabled packs and orphan assets. */
594
+ export function validateEventPackEntries(entries, keys) {
595
+ for (const key of keys) {
596
+ const prefix = 'agents/' + key + '/events/';
597
+ const ids = new Set([...entries.keys()].filter(name => name.startsWith(prefix)).map(name => name.slice(prefix.length).split('/')[0]));
598
+ for (const id of ids) {
599
+ const packPrefix = prefix + id + '/';
600
+ const entry = entries.get(packPrefix + 'pack.json');
601
+ check(entry, 'Event pack missing pack.json: ' + prefix + id);
602
+ const files = [...entries.keys()].filter(name => name.startsWith(packPrefix)).map(name => name.slice(packPrefix.length));
603
+ validateEventPack(JSON.parse(entry.bytes.toString('utf8')), files, { template: true, location: prefix + id });
604
+ }
605
+ }
606
+ }
@@ -1,7 +1,148 @@
1
1
  /** Shared, pure template binding/rendering. No home discovery or runtime writes. */
2
2
  export const BASEAGENTS = ['claude', 'codex', 'gemini', 'ecagent'];
3
+ export const MEMBER_PARAMETER_FIELDS = ['version', 'update'];
3
4
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
4
5
  const fail = message => { throw Object.assign(new Error(message), { code: 'INVALID_ARGUMENT' }); };
6
+ const AID = /^[a-z0-9][a-z0-9_-]*\.(?:[a-z0-9-]+\.)*[a-z0-9-]+$/;
7
+ // Agent access lists follow the runtime schema; contact references retain their own contract.
8
+ const ACCESS_AID = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?){2,}$/;
9
+ const TEMPLATE_ID = /^agent_[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
10
+
11
+ /** Validate author declarations without inserting runtime defaults. */
12
+ export function validateAccessDeclaration(access) {
13
+ if (!record(access)) fail('access must be an object');
14
+ for (const [key, value] of Object.entries(access)) {
15
+ if (['allowInternalContacts', 'allowExternalContacts', 'allowAllContacts'].includes(key)) {
16
+ if (typeof value !== 'boolean') fail('access.' + key + ' must be boolean');
17
+ } else if (['allowedAids', 'deniedAids'].includes(key)) {
18
+ if (!Array.isArray(value) || value.some(aid => typeof aid !== 'string' || !ACCESS_AID.test(aid))
19
+ || new Set(value).size !== value.length) fail('access.' + key + ' must contain unique AIDs');
20
+ } else if (key === 'requestLimit') {
21
+ if (!record(value) || Object.keys(value).some(field => !['maxTimes', 'coolDown'].includes(field))) fail('access.requestLimit is invalid');
22
+ for (const [field, number] of Object.entries(value)) {
23
+ const maximum = field === 'maxTimes' ? 100000 : 86400;
24
+ if (!Number.isSafeInteger(number) || number < 1 || number > maximum) fail('access.requestLimit.' + field + ' is invalid');
25
+ }
26
+ } else if (key === 'contactAdmission') {
27
+ if (!['legacy', 'app-v1'].includes(value)) fail('access.contactAdmission is invalid');
28
+ } else fail('Unknown access field: ' + key);
29
+ }
30
+ return structuredClone(access);
31
+ }
32
+
33
+ /** Missing values inherit; explicit false, empty arrays and nested declarations override. */
34
+ export function mergeMemberDefaults(defaults, member) {
35
+ if (!record(defaults) || !record(member)) fail('Member defaults and template required');
36
+ const merge = (low, high) => {
37
+ if (!record(low) || !record(high)) return structuredClone(high);
38
+ const result = structuredClone(low);
39
+ for (const [key, value] of Object.entries(high)) {
40
+ if (['__proto__', 'prototype', 'constructor'].includes(key)) fail('Invalid configuration key');
41
+ result[key] = record(value) && record(result[key]) ? merge(result[key], value) : structuredClone(value);
42
+ }
43
+ return result;
44
+ };
45
+ for (const source of [defaults, member]) {
46
+ if (source.config?.access !== undefined) validateAccessDeclaration(source.config.access);
47
+ }
48
+ const result = structuredClone(member);
49
+ if (defaults.profile || member.profile) result.profile = merge(defaults.profile ?? {}, member.profile ?? {});
50
+ const low = defaults.config?.access, high = member.config?.access;
51
+ if (low !== undefined || high !== undefined) {
52
+ result.config ??= {};
53
+ result.config.access = high === undefined ? structuredClone(low) : merge(low ?? {}, high);
54
+ }
55
+ return result;
56
+ }
57
+
58
+ /** One partition used by authors, identity generation and delivery consumers. Never mutates input. */
59
+ export function partitionTeamMembers(team) {
60
+ if (!record(team) || !Array.isArray(team.agents) || !team.agents.length) fail('Team agents required');
61
+ const inlineMembers = [], optionalReferences = [], keys = new Set();
62
+ for (const member of team.agents) {
63
+ if (!record(member) || !/^[a-z0-9][a-z0-9_-]{0,31}$/.test(member.key ?? '') || keys.has(member.key)) fail('Invalid or duplicate member key');
64
+ keys.add(member.key);
65
+ if (member.optional !== undefined && typeof member.optional !== 'boolean') fail('Member optional must be boolean');
66
+ if (member.config?.access !== undefined) validateAccessDeclaration(member.config.access);
67
+ if (member.optional === true) {
68
+ if (Object.keys(member).some(key => !['key', 'optional', 'agentTemplateId', 'profile', 'config'].includes(key))) fail('Optional member contains executable configuration: ' + member.key);
69
+ if (!TEMPLATE_ID.test(member.agentTemplateId ?? '')) fail('Invalid agentTemplateId for ' + member.key);
70
+ if (!record(member.profile) || typeof member.profile.name !== 'string' || !member.profile.name.trim()
71
+ || typeof member.profile.description !== 'string') fail('Optional member profile.name and profile.description required: ' + member.key);
72
+ if (member.config !== undefined && (!record(member.config) || Object.keys(member.config).some(key => key !== 'access'))) fail('Optional member config only accepts access: ' + member.key);
73
+ optionalReferences.push(structuredClone(member));
74
+ } else {
75
+ if (member.agentTemplateId !== undefined) fail('agentTemplateId requires optional=true: ' + member.key);
76
+ inlineMembers.push(structuredClone(member));
77
+ }
78
+ }
79
+ const index = team.personal_assistant ?? 0;
80
+ if (!Number.isInteger(index) || index < 0 || index >= team.agents.length) fail('personal_assistant: index outside agents');
81
+ const assistantKey = team.agents[index].key;
82
+ if (!inlineMembers.some(member => member.key === assistantKey)) fail('Personal assistant must be a required member');
83
+ if (!inlineMembers.length) fail('At least one required member is needed');
84
+ if (team.external_contacts !== undefined && !Array.isArray(team.external_contacts)) fail('external_contacts must be an array');
85
+ const externalAids = new Set();
86
+ const externalContacts = (team.external_contacts ?? []).map(contact => {
87
+ if (!record(contact) || Object.keys(contact).some(key => !['aid', 'name'].includes(key))
88
+ || typeof contact.aid !== 'string' || !AID.test(contact.aid) || externalAids.has(contact.aid)
89
+ || contact.name !== undefined && (typeof contact.name !== 'string' || !contact.name.trim())) fail('Invalid or duplicate external contact');
90
+ externalAids.add(contact.aid);
91
+ return { aid: contact.aid, name: contact.name ?? contact.aid };
92
+ });
93
+ return { inlineMembers, optionalReferences, externalContacts, assistantKey };
94
+ }
95
+
96
+ export function teamMemberReferences(team) {
97
+ const { optionalReferences, externalContacts } = partitionTeamMembers(team);
98
+ return optionalReferences.length || externalContacts.length
99
+ ? { optional: optionalReferences, external: externalContacts } : undefined;
100
+ }
101
+
102
+ /** Keep external identity/ownership unknown until independently verified. */
103
+ export function createTeamContactEntries({ members, ownerAid, hostAid, externalContacts = [], selfAid, remote = false }) {
104
+ const owned = new Set([ownerAid, hostAid, ...members.map(member => member.aid)]);
105
+ if (externalContacts.some(contact => owned.has(contact.aid))) fail('External contact conflicts with a team identity');
106
+ const entries = members.filter(member => member.aid !== selfAid).map(member => ({
107
+ aid: member.aid, name: member.name, [remote ? 'owner_aid' : 'ownerAid']: ownerAid,
108
+ remark: '', type: 'agent', description: member.description ?? '', ownership_status: 'owned',
109
+ agent_md_signed_at: remote ? null : 0,
110
+ ...(remote ? {} : { exttype: '', baseagent: '' }),
111
+ }));
112
+ return entries.concat(externalContacts.map(contact => ({ aid: contact.aid, name: contact.name ?? contact.aid,
113
+ ownership_status: 'unknown', agent_md_signed_at: remote ? null : 0 })));
114
+ }
115
+
116
+ /** Author declarations only; never generates versions or grants update authority. */
117
+ export function resolveMemberParameters(member) {
118
+ if (!record(member)) fail('Member must be an object');
119
+ const out = {};
120
+ const prefix = 'Member ' + (member.key ?? '(unknown)') + '.';
121
+ if ([member, member.config].some(value => record(value) && Object.hasOwn(value, 'publisherAid'))) fail(prefix + 'publisherAid: use update.publisher');
122
+ for (const field of MEMBER_PARAMETER_FIELDS) {
123
+ const declarations = [member, member.config].filter(value => record(value) && Object.hasOwn(value, field));
124
+ for (const declaration of declarations) {
125
+ const value = declaration[field];
126
+ const valid = field === 'version'
127
+ ? typeof value === 'string' && /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/.test(value)
128
+ : record(value) && Object.keys(value).every(key => ['mode', 'publisher'].includes(key))
129
+ && ['auto', 'manual', 'disabled'].includes(value.mode);
130
+ if (!valid) fail(prefix + field + ': invalid declaration');
131
+ if (field === 'update' && Object.hasOwn(value, 'publisher')
132
+ && (typeof value.publisher !== 'string' || !/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?){2,}$/.test(value.publisher))) {
133
+ fail(prefix + 'update.publisher: invalid AID');
134
+ }
135
+ }
136
+ if (declarations.length === 2) {
137
+ const equal = field === 'update'
138
+ ? declarations[0][field].mode === declarations[1][field].mode && declarations[0][field].publisher === declarations[1][field].publisher
139
+ : declarations[0][field] === declarations[1][field];
140
+ if (!equal) fail(prefix + field + ': conflicts with config.' + field);
141
+ }
142
+ if (declarations.length) out[field] = structuredClone(declarations[0][field]);
143
+ }
144
+ return out;
145
+ }
5
146
 
6
147
  /** Connection credentials cannot be hidden in otherwise public nested configuration. */
7
148
  export function assertPublicTemplateConfig(config) {
@@ -126,10 +267,12 @@ export function teamMemberVariables(members, ownerAid, hostAid) {
126
267
  export function planMemberConfig({ member, vars, providers, defaults = {}, fallbackProviders = {}, selections = {}, allowMissing = false, modelCatalog, mode = 'create_prebuilt' }) {
127
268
  if (!record(member) || !MEMBER_KEY.test(member.key) || !record(vars)) fail('Invalid member plan');
128
269
  if (!['create_prebuilt', 'create_on_host', 'overlay_existing'].includes(mode)) fail('Invalid member plan mode');
270
+ const parameters = resolveMemberParameters(member);
129
271
  const rendered = renderValue(member, vars);
130
272
  if (mode !== 'create_prebuilt' && (!record(rendered.config) || Object.keys(rendered.config)
131
- .some(key => !['chatmode', 'memory', 'active_baseagent', 'baseagents'].includes(key)))) fail('Unsupported live-host member configuration');
132
- const binding = bindTemplateProviders(rendered.config ?? {}, { providers, defaults, fallbackProviders, selections, allowMissing, modelCatalog });
273
+ .some(key => !['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version', 'update'].includes(key)))) fail('Unsupported live-host member configuration');
274
+ if (rendered.config?.access !== undefined) validateAccessDeclaration(rendered.config.access);
275
+ const binding = bindTemplateProviders({ ...rendered.config, ...parameters }, { providers, defaults, fallbackProviders, selections, allowMissing, modelCatalog });
133
276
  return { key: member.key, profile: rendered.profile, skills: rendered.skills ?? {}, config: binding.config, providers: binding.refs };
134
277
  }
135
278