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
@@ -1,11 +1,14 @@
1
1
  import fs from 'node:fs';
2
2
  import { createHash } from 'node:crypto';
3
+ import { resolveMemberParameters, partitionTeamMembers } from './template-runtime.mjs';
3
4
 
4
5
  export const TEAM_SCHEMA_VERSION = 1;
5
6
  export const PACKAGE_SCHEMA_VERSION = 1;
6
7
  export const TEAM_SCHEMA_ID = 'urn:evolcore:agent-template:team:v1';
7
8
  export const SELECTION_TTL_MS = 900000;
8
- export const TEMPLATE_ACTIONS = ['inspect', 'build', 'push', 'pull', 'preview', 'deploy', 'status', 'resume', 'cancel', 'capabilities'];
9
+ export const TEMPLATE_ACTIONS = ['inspect', 'build', 'push', 'pull', 'preview', 'deploy', 'status', 'resume', 'cancel', 'capabilities',
10
+ 'register-team', 'team-members', 'prepare-member-install', 'resume-member-join',
11
+ 'update-status', 'check-update', 'bind-update-source', 'confirm-update-source', 'preview-update', 'read-update-notice'];
9
12
  const schema = JSON.parse(fs.readFileSync(new URL('./team-schema.json', import.meta.url), 'utf8'));
10
13
  export const readTeamSchema = () => structuredClone(schema);
11
14
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -19,9 +22,14 @@ const strings = { type: 'array', uniqueItems: true, items: string };
19
22
  const object = (properties, required = Object.keys(properties)) => ({ type: 'object', properties, required, additionalProperties: false });
20
23
  const members = item => ({ type: 'object', minProperties: 1, propertyNames: { pattern: MEMBER_KEY_PATTERN }, additionalProperties: item });
21
24
  const jobId = { ...string, pattern: '^job_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' };
25
+ const instanceId = { ...string, pattern: '^team_[a-f0-9]{64}$' };
26
+ const memberKey = { ...string, pattern: MEMBER_KEY_PATTERN };
27
+ const memberInstallId = { ...string, pattern: '^member_install_[a-f0-9-]{36}$' };
28
+ const memberReferences = object({ optional: { type: 'array', items: schema.properties.agents.items },
29
+ external: schema.properties.external_contacts });
22
30
  const location = object({ aid, path: { ...string, pattern: '^/[^\\\\\\u0000]*$' } });
23
31
  const metadata = object({
24
- id: schema.properties.name, name: { type: 'string', minLength: 1, maxLength: 64 },
32
+ id: schema.properties.id, name: { type: 'string', minLength: 1, maxLength: 64 },
25
33
  version: schema.properties.version, description: schema.properties.description,
26
34
  platforms: schema.properties.host.properties.platform,
27
35
  }, ['id', 'name', 'version', 'platforms']);
@@ -32,32 +40,55 @@ const source = { oneOf: [
32
40
  object({ kind: { const: 'remote' }, location,
33
41
  download: object({ shareId: { ...string, pattern: '^[A-Za-z0-9]{10}$' } }, []), digest }, ['kind', 'location', 'digest']),
34
42
  ] };
35
- const include = object({ baseagents: strings, triggers: strings, skills: strings, files: strings });
43
+ const include = object({ baseagents: strings, triggers: strings, skills: strings, files: strings, events: strings }, ['baseagents', 'triggers', 'skills', 'files']);
36
44
  const provider = object({ provider: string, model: string, effort: { type: ['string', 'null'], minLength: 1 } }, ['provider', 'model']);
37
45
  const selection = object({
38
- target: object({ aid: { oneOf: [aid, { const: 'auto' }] }, project: string }),
46
+ target: object({ aid: { oneOf: [aid, { const: 'auto' }] }, project: {
47
+ ...string, description: 'Absolute path on the target host. Optional for create: the host allocates and freezes it during preview. Required for overwrite.',
48
+ } }, ['aid']),
39
49
  providers: { type: 'object', propertyNames: { enum: ['claude', 'codex', 'gemini', 'ecagent'] }, additionalProperties: provider },
40
50
  externalAids: { type: 'object', propertyNames: aid, additionalProperties: aid },
41
51
  }, ['target']);
52
+ const updateSource = object({ catalogAid: aid, publisher: aid,
53
+ templateId: { ...string, pattern: '^[a-z0-9][a-z0-9._-]{0,63}$' }, memberKey });
54
+ const releaseId = { ...string, pattern: '^[a-f0-9]{64}$' };
55
+ const bindingId = { ...string, pattern: '^binding_[a-f0-9-]{36}$' };
56
+ const noticeId = { ...string, pattern: '^notice_[a-f0-9]{64}$' };
42
57
  const inputSchemas = {
43
58
  inspect: object({ members: members(object({ source: { oneOf: [
44
59
  object({ kind: { const: 'agent' }, aid }),
45
60
  object({ kind: { const: 'directory' }, path: string }),
46
61
  ] } })) }),
47
- build: object({ inspectionJobId: jobId, inventoryDigest: digest, metadata, members: members(object({ include })) }),
62
+ build: object({ inspectionJobId: jobId, inventoryDigest: digest, metadata, members: members(object({ include,
63
+ version: schema.properties.agents.items.properties.version,
64
+ update: schema.properties.agents.items.properties.update,
65
+ }, ['include'])), memberReferences, assistantKey: memberKey }, ['inspectionJobId', 'inventoryDigest', 'metadata', 'members']),
48
66
  push: object({ packageId: string, location, releasedFindings: strings }),
49
- pull: object({ source }),
50
- preview: object({ packageId: string, installMode: { enum: ['create', 'overwrite'] }, members: members(selection), issuer: aid }, ['packageId', 'installMode', 'members']),
67
+ pull: { oneOf: [object({ source }), object({ memberInstallId })] },
68
+ preview: object({ packageId: string, installMode: { enum: ['create', 'overwrite'] }, members: members(selection), issuer: aid,
69
+ memberInstallId }, ['packageId', 'installMode', 'members']),
51
70
  deploy: object({ previewId: string, planDigest: digest }),
52
71
  status: { oneOf: [object({ jobId }), object({ requestId: string })] },
53
72
  resume: object({ jobId }),
54
73
  cancel: object({ jobId }),
55
74
  capabilities: object({}),
75
+ 'register-team': object({ manifest: { type: 'object' }, deliveryDigest: digest }),
76
+ 'team-members': { oneOf: [object({ instanceId }), object({ assistantAid: aid })] },
77
+ 'prepare-member-install': object({ instanceId, memberKey, expectedRevision: digest }),
78
+ 'resume-member-join': object({ instanceId, memberKey }),
79
+ 'update-status': object({ targetAid: aid }),
80
+ 'check-update': object({ targetAid: aid }),
81
+ 'bind-update-source': object({ targetAid: aid, source: updateSource, releaseId }),
82
+ 'confirm-update-source': object({ bindingId, planDigest: digest }),
83
+ 'preview-update': object({ targetAid: aid, releaseId, providers: selection.properties.providers,
84
+ resolutions: { type: 'object', additionalProperties: { enum: ['keep-local', 'use-candidate'] } },
85
+ approvals: strings }, ['targetAid', 'releaseId']),
86
+ 'read-update-notice': object({ targetAid: aid, noticeId }),
56
87
  };
57
88
  export const readTemplateInputSchemas = () => structuredClone(inputSchemas);
58
89
  export const packageSchema = object({
59
90
  $schema_version: { const: PACKAGE_SCHEMA_VERSION },
60
- id: schema.properties.name, name: { type: 'string', minLength: 1, maxLength: 64 }, version: schema.properties.version,
91
+ id: schema.properties.id, name: { type: 'string', minLength: 1, maxLength: 64 }, version: schema.properties.version,
61
92
  description: schema.properties.description, publisher: { type: 'object' }, createdAt: { type: 'number', minimum: 0 },
62
93
  compat: object({ platforms: schema.properties.host.properties.platform, evolcore: string, baseagents: strings, templateFeatures: strings }, ['platforms', 'evolcore', 'baseagents']),
63
94
  externalAids: { ...strings, items: aid },
@@ -67,7 +98,8 @@ export const packageRefSchema = object({
67
98
  members: members(schema.properties.agents.items), externalAids: { ...strings, items: aid },
68
99
  scan: object({ findings: { type: 'array', items: object({ id: string, memberKey: string, path: string, code: string, message: string }) } }),
69
100
  excluded: { type: 'array', items: string },
70
- });
101
+ memberReferences: { type: 'object' }, assistantKey: string,
102
+ }, ['packageId', 'digest', 'size', 'metadata', 'members', 'externalAids', 'scan', 'excluded']);
71
103
  const freezeSchema = object({
72
104
  state: { enum: ['acquiring', 'held', 'transferred', 'releasing', 'released'] },
73
105
  generation: { type: 'integer', minimum: 1 }, frozenAt: { type: ['integer', 'null'] },
@@ -96,6 +128,15 @@ export function canonicalJson(value) {
96
128
  }
97
129
  export const contractDigest = value => 'sha256:' + createHash('sha256').update(canonicalJson(value)).digest('hex');
98
130
 
131
+ /** Explicit target build environment only; never reads the builder's daemon or environment. */
132
+ export function resolveTemplateAidDomain(team) {
133
+ const configured = team.host?.config?.aun?.defaultAidDomain;
134
+ const value = configured === undefined ? 'agentid.cn' : configured;
135
+ const errors = validateContractSchema(value, schema.properties.host.properties.config.properties.aun.properties.defaultAidDomain);
136
+ if (errors.length) throw contractError('INVALID_ARGUMENT', 'host.config.aun.defaultAidDomain: ' + errors.join('; '));
137
+ return value;
138
+ }
139
+
99
140
  export function normalizeTeamSchema(local = {}) {
100
141
  if (!record(local) || local.type !== 'object') throw new Error('team.schema.json must be a JSON Schema object');
101
142
  const merge = (base, custom) => {
@@ -116,6 +157,27 @@ export function normalizeTeamSchema(local = {}) {
116
157
  out.properties.$schema_version = structuredClone(schema.properties.$schema_version);
117
158
  out.properties.version = structuredClone(schema.properties.version);
118
159
  out.properties.host.properties.platform = structuredClone(schema.properties.host.properties.platform);
160
+ // Retired top-level name described the identifier, never the display title.
161
+ if (record(local.properties?.name)) {
162
+ const legacyId = structuredClone(local.properties.name);
163
+ for (const key of ['title', 'description', 'readOnly', 'x-aliasOf']) delete legacyId[key];
164
+ out.properties.id = merge(out.properties.id, legacyId);
165
+ }
166
+ delete out.properties.name;
167
+ out.required = [...new Set(out.required.map(key => key === 'name' ? 'id' : key))];
168
+ // Old custom forms may constrain/require issuer; carry those constraints to its canonical location.
169
+ const legacyDomain = local.properties?.issuer;
170
+ if (record(legacyDomain) || local.required?.includes('issuer')) {
171
+ const domain = out.properties.host.properties.config.properties.aun;
172
+ if (record(legacyDomain)) domain.properties.defaultAidDomain = merge(domain.properties.defaultAidDomain, legacyDomain);
173
+ if (local.required?.includes('issuer')) {
174
+ out.properties.host.required = [...new Set([...(out.properties.host.required ?? []), 'config'])];
175
+ out.properties.host.properties.config.required = [...new Set([...(out.properties.host.properties.config.required ?? []), 'aun'])];
176
+ domain.required = [...new Set([...(domain.required ?? []), 'defaultAidDomain'])];
177
+ }
178
+ }
179
+ delete out.properties.issuer;
180
+ out.required = out.required.filter(key => key !== 'issuer');
119
181
  const member = out.properties.agents.items;
120
182
  const original = local.properties?.agents?.items?.properties ?? {};
121
183
  for (const key of ['name', 'description']) {
@@ -189,10 +251,13 @@ export function normalizeTeam(input, { fallbackName, packageInfo } = {}) {
189
251
  const team = structuredClone(input);
190
252
  const change = (field, message) => changes.push({ field, message });
191
253
  if (legacy) { team.$schema_version = TEAM_SCHEMA_VERSION; change('$schema_version', 'Legacy declaration normalized to v1'); }
192
- if (team.name === undefined && fallbackName) { team.name = fallbackName; change('name', 'Use template directory identifier'); }
193
- if (typeof team.name === 'string' && team.name !== team.name.trim()) {
194
- team.name = team.name.trim(); change('name', 'Trimmed identifier whitespace');
254
+ for (const key of ['id', 'name']) if (typeof team[key] === 'string' && team[key] !== team[key].trim()) {
255
+ team[key] = team[key].trim(); change(key, 'Trimmed identifier whitespace');
195
256
  }
257
+ if (team.id === undefined && team.name === undefined && fallbackName) { team.id = fallbackName; change('id', 'Use template directory identifier'); }
258
+ if (team.id === undefined && team.name !== undefined) { team.id = team.name; change('id', 'Use compatible name identifier'); }
259
+ if (team.id !== undefined && team.name !== undefined && team.id !== team.name) errors.push('team.id: conflicts with team.name');
260
+ if (own(team, 'name')) { delete team.name; change('name', 'Retired compatible identifier; use id'); }
196
261
  if (legacy) {
197
262
  const oldVersion = team.version;
198
263
  if (oldVersion === undefined) team.version = '1.0.0';
@@ -207,9 +272,28 @@ export function normalizeTeam(input, { fallbackName, packageInfo } = {}) {
207
272
  else if (typeof team.host.platform === 'string') { team.host.platform = [team.host.platform]; change('host.platform', 'Converted legacy platform string to list'); }
208
273
  }
209
274
  }
275
+ const aun = team.host?.config?.aun;
276
+ if (record(aun) && typeof aun.defaultAidDomain === 'string') {
277
+ const value = aun.defaultAidDomain.trim().toLowerCase();
278
+ if (value !== aun.defaultAidDomain) { aun.defaultAidDomain = value; change('host.config.aun.defaultAidDomain', 'Normalized AID domain'); }
279
+ }
280
+ if (own(team, 'issuer')) {
281
+ const issuer = typeof team.issuer === 'string' ? team.issuer.trim().toLowerCase() : team.issuer;
282
+ const domainRule = schema.properties.host.properties.config.properties.aun.properties.defaultAidDomain;
283
+ errors.push(...validateContractSchema(issuer, domainRule, 'team.issuer'));
284
+ if (aun?.defaultAidDomain !== undefined && aun.defaultAidDomain !== issuer) errors.push('team.issuer: conflicts with host.config.aun.defaultAidDomain');
285
+ if (record(team.host) && (team.host.config === undefined || record(team.host.config))
286
+ && (team.host.config?.aun === undefined || record(team.host.config.aun))) {
287
+ team.host.config ??= {}; team.host.config.aun ??= {};
288
+ team.host.config.aun.defaultAidDomain ??= issuer;
289
+ }
290
+ delete team.issuer;
291
+ change('issuer', 'Use host.config.aun.defaultAidDomain');
292
+ }
210
293
  if (Array.isArray(team.agents)) team.agents.forEach((agent, i) => {
211
294
  if (!record(agent)) return;
212
295
  const prefix = `agents[${i}]`;
296
+ try { resolveMemberParameters(agent); } catch (error) { errors.push(prefix + ': ' + error.message); }
213
297
  if (agent.profile !== undefined && !record(agent.profile)) { errors.push(`${prefix}.profile: object required`); return; }
214
298
  if (legacy && agent.profile === undefined) agent.profile = {};
215
299
  if (!record(agent.profile)) return;
@@ -227,6 +311,7 @@ export function normalizeTeam(input, { fallbackName, packageInfo } = {}) {
227
311
  }
228
312
  });
229
313
  errors.push(...validateContractSchema(team, schema));
314
+ try { partitionTeamMembers(team); } catch (error) { errors.push(error.message); }
230
315
  if (Array.isArray(team.agents)) {
231
316
  const keys = new Set(); const names = new Set();
232
317
  for (const [i, agent] of team.agents.entries()) {
@@ -241,13 +326,13 @@ export function normalizeTeam(input, { fallbackName, packageInfo } = {}) {
241
326
  if (Number.isInteger(team.personal_assistant) && team.personal_assistant >= team.agents.length) errors.push('personal_assistant: index outside agents');
242
327
  }
243
328
  if (packageInfo) {
244
- if (team.name !== packageInfo.id) errors.push('team.name: differs from PACKAGE.id');
329
+ if (team.id !== packageInfo.id) errors.push('team.id: differs from PACKAGE.id');
245
330
  if (team.version !== packageInfo.version || !versionPattern.test(packageInfo.version)) errors.push('team.version: differs from PACKAGE.version');
246
331
  if (team.title !== undefined && team.title !== packageInfo.name) errors.push('team.title: differs from PACKAGE.name');
247
332
  if (team.description !== undefined && team.description !== packageInfo.description) errors.push('team.description: differs from PACKAGE.description');
248
333
  }
249
334
  return { ...(errors.length ? {} : { team }), errors, changes,
250
- metadata: { id: team.name, name: team.title ?? packageInfo?.name ?? team.name, version: team.version } };
335
+ metadata: { id: team.id, name: team.title ?? packageInfo?.name ?? team.id, version: team.version } };
251
336
  }
252
337
 
253
338
  /** Internal index; public declarations and manifests continue to use agents[]. */
@@ -263,7 +348,11 @@ export function validateTemplateRequest(request) {
263
348
  if (!errors.length && request.action === 'preview') {
264
349
  const keys = Object.keys(request.args.members);
265
350
  if (request.args.installMode === 'overwrite' && (keys.length !== 1 || request.args.issuer !== undefined || request.args.members[keys[0]].target.aid === 'auto')) errors.push('overwrite requires one existing target and forbids issuer');
351
+ if (request.args.installMode === 'overwrite') for (const key of keys) {
352
+ if (request.args.members[key].target.project === undefined) errors.push(`args.members.${key}.target.project: required for overwrite`);
353
+ }
266
354
  if (request.args.installMode === 'create' && keys.some(key => request.args.members[key].target.aid === 'auto') && !request.args.issuer) errors.push('issuer required for auto targets');
355
+ if (request.args.memberInstallId && (request.args.installMode !== 'create' || keys.length !== 1)) errors.push('memberInstallId requires a single new member');
267
356
  }
268
357
  return errors;
269
358
  }
@@ -286,11 +375,12 @@ export function readTemplateCapabilities({ actions = TEMPLATE_ACTIONS, installMo
286
375
  if (actions.some(action => !TEMPLATE_ACTIONS.includes(action))) throw contractError('INVALID_ARGUMENT', 'Unknown capability action');
287
376
  return {
288
377
  actions: [...actions], inputSchemas: Object.fromEntries(actions.map(action => [action, structuredClone(inputSchemas[action])])),
289
- resultSchemas: Object.fromEntries(actions.map(action => [action, action === 'capabilities' ? { type: 'object' } : structuredClone(jobSchema)])),
378
+ resultSchemas: Object.fromEntries(actions.map(action => [action, ['capabilities', 'register-team', 'team-members', 'prepare-member-install', 'resume-member-join',
379
+ 'update-status', 'bind-update-source', 'confirm-update-source', 'read-update-notice'].includes(action) ? { type: 'object' } : structuredClone(jobSchema)])),
290
380
  packageSchema: structuredClone(packageSchema), installModes: [...installModes], platforms: [...platforms],
291
381
  limits: { selectionTtlMs: SELECTION_TTL_MS, waitSeconds: { minimum: 0, maximum: 300 } },
292
382
  jobPolicy: { packageRetentionMs: 604800000, previewTtlMs: 3600000, resultRetentionMs: 2592000000, event: 'template.job', unknownEffectsPinned: true },
293
- features: structuredClone(features),
383
+ features: { singleAgentManualUpdate: true, automaticUpdateExecution: false, ...structuredClone(features) },
294
384
  };
295
385
  }
296
386
  export function validateBuildSelection(inventory, args) {
@@ -300,7 +390,7 @@ export function validateBuildSelection(inventory, args) {
300
390
  if (args.metadata.platforms.some(platform => !inventory.platforms.includes(platform))) throw contractError('INCOMPATIBLE', 'No common selected platform');
301
391
  for (const key of keys) {
302
392
  const member = inventory.members[key];
303
- for (const [kind, chosen] of Object.entries(args.members[key].include)) if (chosen.some(item => !member.resources[kind].includes(item))) throw contractError('INVALID_ARGUMENT', 'Selection outside inventory', { memberKey: key, kind });
393
+ for (const [kind, chosen] of Object.entries(args.members[key].include)) if (chosen.some(item => !(member.resources[kind] ?? []).includes(item))) throw contractError('INVALID_ARGUMENT', 'Selection outside inventory', { memberKey: key, kind });
304
394
  if (!args.members[key].include.baseagents.includes(member.defaultBaseagent)) throw contractError('INVALID_ARGUMENT', 'Default baseagent is required', { memberKey: key });
305
395
  }
306
396
  }