evolcore 0.0.45 → 0.0.46

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 (204) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/bin/ecmsg.js +33 -23
  3. package/dist/ability/application-service.js +1 -2
  4. package/dist/ability/package.js +28 -0
  5. package/dist/agent-template/jobs.js +158 -36
  6. package/dist/agent-template/runtime.js +401 -34
  7. package/dist/agent-template/service.js +764 -369
  8. package/dist/agent-template/tool-runner.js +35 -17
  9. package/dist/agent-template/types.js +7 -4
  10. package/dist/agents/baseagent.js +10 -9
  11. package/dist/agents/claude-runner.js +13 -5
  12. package/dist/agents/codex/app-server-client.js +2 -4
  13. package/dist/agents/codex/diagnostics.js +18 -1
  14. package/dist/agents/codex-runner.js +3 -1
  15. package/dist/agents/ecagent-runner.js +3 -1
  16. package/dist/agents/gemini-runner.js +2 -1
  17. package/dist/aun/menu/client.js +142 -182
  18. package/dist/aun/rpc/client.js +33 -17
  19. package/dist/aun/service-proxy.js +6 -23
  20. package/dist/channels/aun.js +656 -112
  21. package/dist/cli/agent-create.js +37 -10
  22. package/dist/cli/agent-template.js +105 -84
  23. package/dist/cli/agent.js +31 -18
  24. package/dist/cli/daemon-commands.js +15 -17
  25. package/dist/cli/daemon-lifecycle-client.js +40 -18
  26. package/dist/cli/directory.js +12 -4
  27. package/dist/cli/ecmsg-gateway.js +5 -2
  28. package/dist/cli/events-command.js +2 -1
  29. package/dist/cli/init.js +50 -20
  30. package/dist/cli/integrity-command.js +2 -0
  31. package/dist/cli/managed-command-guard.js +20 -1
  32. package/dist/cli/menu-client.js +7 -5
  33. package/dist/cli/restart-monitor.js +33 -20
  34. package/dist/cli/services-command.js +28 -5
  35. package/dist/config/config-field-policy.js +24 -0
  36. package/dist/config/config-manager.js +20 -2
  37. package/dist/config/peer-book-store.js +152 -120
  38. package/dist/config/peer-role-resolver.js +24 -4
  39. package/dist/config/provider-identity-migration.js +1 -1
  40. package/dist/config/provider-identity.js +10 -4
  41. package/dist/config/provider-ipc-service.js +10 -2
  42. package/dist/config/provider-local-sync.js +2 -2
  43. package/dist/config/providers-config.js +95 -10
  44. package/dist/config/providers-import.js +4 -6
  45. package/dist/config/providers.js +14 -3
  46. package/dist/config/role-store.js +1 -1
  47. package/dist/config-store.js +9 -1
  48. package/dist/core/agent-application-service.js +56 -29
  49. package/dist/core/agent-create-status.js +3 -1
  50. package/dist/core/agent-creation-claim.js +1 -0
  51. package/dist/core/agent-ipc-registration.js +2 -2
  52. package/dist/core/agent-reload-coordinator.js +38 -1
  53. package/dist/core/agent-runtime.js +85 -38
  54. package/dist/core/auth/agent-delegation.js +5 -0
  55. package/dist/core/auth/operation-authorizer.js +1 -1
  56. package/dist/core/auth/operation-catalog.js +3 -3
  57. package/dist/core/bootstrap-service.js +3 -0
  58. package/dist/core/capability/capability-manager.js +3 -1
  59. package/dist/core/channel-loader.js +29 -3
  60. package/dist/core/channel-runtime.js +1 -1
  61. package/dist/core/command/agent-control.js +6 -5
  62. package/dist/core/command/agent-template-menu.js +32 -97
  63. package/dist/core/command/eventcenter-menu.js +61 -13
  64. package/dist/core/command/menu-catalog.js +11 -4
  65. package/dist/core/command/menu-handler.js +35 -8
  66. package/dist/core/command/menu-protocol.js +8 -16
  67. package/dist/core/command/skill-slash.js +6 -2
  68. package/dist/core/command/team-workspace-bootstrap.js +1 -2
  69. package/dist/core/command/team-workspace-management-store.js +83 -0
  70. package/dist/core/command/team-workspace-management.js +1 -2
  71. package/dist/core/command/team-workspace-team.js +26 -3
  72. package/dist/core/daemon-control.js +3 -4
  73. package/dist/core/daemon-lifecycle.js +146 -110
  74. package/dist/core/evolagent-registry.js +42 -0
  75. package/dist/core/evolagent.js +2 -1
  76. package/dist/core/file-integrity/read.js +9 -16
  77. package/dist/core/file-integrity/store.js +94 -34
  78. package/dist/core/handoff/dispatcher.js +33 -7
  79. package/dist/core/handoff/runtime.js +8 -0
  80. package/dist/core/inference/text-inference.js +12 -2
  81. package/dist/core/invoke/invoke-service.js +24 -3
  82. package/dist/core/ipc-registration.js +3 -0
  83. package/dist/core/message/aun-ipc-sender.js +109 -7
  84. package/dist/core/message/contact-admission.js +6 -2
  85. package/dist/core/message/message-bridge.js +13 -0
  86. package/dist/core/message/message-queue.js +131 -30
  87. package/dist/core/message/pending-hints.js +8 -0
  88. package/dist/core/message/response-engine.js +48 -2
  89. package/dist/core/message/send-routing.js +3 -12
  90. package/dist/core/model/catalog-service.js +13 -0
  91. package/dist/core/model/model-catalog.js +57 -18
  92. package/dist/core/pack-auth.js +163 -31
  93. package/dist/core/pack-install.js +42 -1
  94. package/dist/{services/ledger.js → core/pack-ledger.js} +17 -6
  95. package/dist/core/permission/ec-command-parser.js +3 -1
  96. package/dist/core/permission/shell-environment.js +23 -0
  97. package/dist/core/rate-window.js +6 -1
  98. package/dist/core/session/session-idle-monitor.js +0 -1
  99. package/dist/core/session/session-manager.js +14 -0
  100. package/dist/core/session/session-title.js +26 -6
  101. package/dist/core/skill/index-generator.js +3 -4
  102. package/dist/core/thread/thread-service.js +0 -1
  103. package/dist/core/thread/topic-id.js +8 -0
  104. package/dist/directory/owner-directory-admission.js +17 -0
  105. package/dist/directory/owner-directory-cache.js +3 -1
  106. package/dist/directory/owner-directory-markdown.js +145 -23
  107. package/dist/directory/owner-directory-policy.js +23 -0
  108. package/dist/directory/owner-directory-query-operation.js +20 -6
  109. package/dist/directory/owner-directory-search.js +47 -0
  110. package/dist/eck/message-renderer.js +171 -32
  111. package/dist/ecweb/basic-settings-service.js +7 -3
  112. package/dist/ecweb/providers-service.js +17 -10
  113. package/dist/ecweb/runtime/lifecycle.js +1 -1
  114. package/dist/ecweb/runtime/supervisor.js +77 -35
  115. package/dist/event-center/admission-materializer.js +1 -1
  116. package/dist/event-center/bus-gate.js +48 -4
  117. package/dist/event-center/bus-host.js +3 -3
  118. package/dist/event-center/center-config.js +57 -28
  119. package/dist/event-center/dispatcher.js +8 -0
  120. package/dist/event-center/event-log.js +69 -27
  121. package/dist/event-center/index-generator.js +6 -1
  122. package/dist/event-center/ipc-operation.js +66 -25
  123. package/dist/event-center/pack-loader.js +12 -55
  124. package/dist/event-center/pack-manager.js +5 -3
  125. package/dist/event-center/registry.js +48 -52
  126. package/dist/event-center/runtime.js +219 -81
  127. package/dist/event-center/script-runner.js +18 -7
  128. package/dist/event-center/types.js +9 -1
  129. package/dist/event-center/validation.js +33 -4
  130. package/dist/index.js +96 -42
  131. package/dist/ipc.js +33 -7
  132. package/dist/product.js +1 -0
  133. package/dist/proxy/manager.js +52 -11
  134. package/dist/proxy/service-supervisor.js +265 -67
  135. package/dist/services/dispatcher.js +26 -3
  136. package/dist/services/idempotency.js +128 -0
  137. package/dist/services/identity.js +3 -27
  138. package/dist/services/index-generator.js +5 -1
  139. package/dist/services/index.js +244 -45
  140. package/dist/services/ipc-operation.js +164 -20
  141. package/dist/services/pack-manager.js +37 -9
  142. package/dist/services/router.js +100 -31
  143. package/dist/services/script-runner.js +15 -4
  144. package/dist/services/service-payload.js +50 -2
  145. package/dist/services/validation.js +107 -3
  146. package/dist/trigger/scheduler.js +14 -4
  147. package/dist/trigger/script-sandbox.js +39 -2
  148. package/dist/utils/cross-platform.js +35 -11
  149. package/dist/utils/error-utils.js +13 -1
  150. package/dist/utils/instance-registry.js +33 -35
  151. package/dist/utils/process-introspect.js +35 -20
  152. package/dist/utils/project-path.js +47 -3
  153. package/dist/utils/windows-shell-trust.js +174 -68
  154. package/kits/docs/context-assembly.md +3 -3
  155. package/kits/docs/evolcore/agent.md +28 -10
  156. package/kits/docs/evolcore/config.md +22 -0
  157. package/kits/docs/evolcore/directory.md +46 -12
  158. package/kits/docs/evolcore/event-center.md +6 -6
  159. package/kits/docs/evolcore/group-collaboration.md +1 -1
  160. package/kits/docs/evolcore/menu-client.md +7 -5
  161. package/kits/docs/evolcore/menu-protocol.md +5 -3
  162. package/kits/docs/evolcore/msg.md +10 -3
  163. package/kits/docs/evolcore/provider.md +7 -3
  164. package/kits/docs/evolcore/services.md +145 -12
  165. package/kits/docs/evolcore/thread-chain.md +17 -9
  166. package/kits/docs/prompt-loading-architecture.md +4 -4
  167. package/kits/eck_message_manifest.json +46 -3
  168. package/kits/rules/04-relation.md +10 -2
  169. package/kits/rules/06-channel.md +2 -1
  170. package/kits/schemas/providers.schema.2.json +1 -0
  171. package/kits/skills/ec-group/SKILL.md +4 -0
  172. package/kits/skills/ec-skill/scripts/cli.mjs +1 -1
  173. package/kits/skills/ec-skill/scripts/skill.mjs +13 -2
  174. package/kits/skills/thread-ops/SKILL.md +8 -5
  175. package/kits/templates/message-fragments/group-batch-item.md +3 -0
  176. package/kits/templates/message-fragments/group-batch.md +1 -0
  177. package/kits/templates/message-fragments/item-group.md +4 -0
  178. package/kits/templates/message-fragments/item-private.md +4 -0
  179. package/kits/templates/message-fragments/thread-context.md +1 -1
  180. package/kits/templates/system-fragments/commands.md +5 -5
  181. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  182. package/kits/templates/system-fragments/relation.md +11 -7
  183. package/package.json +3 -2
  184. package/scripts/agent-template/index.mjs +9 -4
  185. package/scripts/agent-template/inspect.mjs +16 -9
  186. package/scripts/agent-template/shared/plan.mjs +3 -33
  187. package/scripts/agent-template/shared/template-contract.mjs +186 -3
  188. package/scripts/agent-template/shared/template-package.mjs +119 -10
  189. package/scripts/agent-template/shared/template-runtime.mjs +49 -6
  190. package/scripts/agent-template/shared/template.mjs +5 -5
  191. package/scripts/agent-template/team-pack.mjs +245 -0
  192. package/scripts/agent-template/team-preview.mjs +111 -0
  193. package/scripts/aid-batch/identity-batch.mjs +143 -0
  194. package/dist/ability/versions.js +0 -32
  195. package/dist/aun/model-headers.js +0 -17
  196. package/dist/channels/builtin-plugins.js +0 -19
  197. package/dist/core/command/team-workspace-initializer.js +0 -2
  198. package/dist/core/command/team-workspace-job-store.js +0 -88
  199. package/dist/core/command/team-workspace-management-service.js +0 -2
  200. package/dist/core/contact-bind-registry.js +0 -27
  201. package/dist/event-center/ledger.js +0 -52
  202. package/dist/services/reply.js +0 -55
  203. package/kits/templates/message-fragments/item.md +0 -3
  204. package/scripts/agent-template/pack.mjs +0 -169
@@ -0,0 +1,245 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { inspectAgent } from './inspect.mjs';
4
+ import { assert, isRecord, inside, walkFiles, jsonBytes, sha256, atomicBytes, regularPath,
5
+ readJson, behaviorConfig, BASEAGENTS, PROFILE_FIELDS } from './shared/common.mjs';
6
+ import { loadTemplate } from './shared/template.mjs';
7
+ import { normalizeTeam, readTeamSchema } from './shared/template-contract.mjs';
8
+ import { collectTemplateDirectory, buildTemplatePackage, excludedResource as excluded } from './shared/template-package.mjs';
9
+
10
+ function entries(options) {
11
+ assert(isRecord(options.members) && Object.keys(options.members).length, 'INVALID_ARGUMENT', 'Members required');
12
+ const entries = Object.entries(options.members).sort(([a], [b]) => a.localeCompare(b));
13
+ assert(entries.every(([key]) => /^[a-z0-9][a-z0-9_-]{0,31}$/.test(key)), 'INVALID_ARGUMENT', 'Invalid member key');
14
+ const aids = entries.filter(([, source]) => source.kind !== 'directory').map(([, source]) => source.agentAid);
15
+ assert(new Set(aids).size === aids.length, 'INVALID_ARGUMENT', 'Agent sources must be distinct');
16
+ return entries;
17
+ }
18
+ const runtimeNames = new Set(['AIDs', 'agents', 'data', 'logs', 'backups', 'eck', 'directory', 'sessions']);
19
+ function projectFiles(source) {
20
+ return walkFiles(source.projectPath, relative => excluded(relative)
21
+ || source.projectPath === source.home && runtimeNames.has(relative.split('/')[0]));
22
+ }
23
+ function directory(source, key) {
24
+ const { tpl, errors } = loadTemplate(source.path);
25
+ assert(!errors.length && tpl.team.agents.some(member => member.key === key), 'INVALID_ARGUMENT', errors.join('; ') || 'Directory member missing');
26
+ return { tpl, member: tpl.team.agents.find(member => member.key === key) };
27
+ }
28
+ function sourceSnapshot(selected) {
29
+ const values = [];
30
+ for (const [key, source] of selected) {
31
+ const add = file => {
32
+ regularPath(file); values.push([key, file, sha256(fs.readFileSync(file)), fs.statSync(file).mode & 0o777]);
33
+ };
34
+ if (source.kind === 'directory') {
35
+ for (const relative of walkFiles(source.path)) add(inside(source.path, relative));
36
+ } else {
37
+ values.push([key, source.profile, source.profileVersion, source.effectiveConfig, source.skills]);
38
+ add(path.join(source.agentDir, 'config.json'));
39
+ const personal = path.join(source.agentDir, 'personal');
40
+ for (const relative of walkFiles(personal)) if (relative === 'welcome.md' || relative.startsWith('soul/') && relative.endsWith('.md')) add(inside(personal, relative));
41
+ const triggers = path.join(source.agentDir, 'triggers');
42
+ for (const relative of walkFiles(triggers)) if (relative !== 'active.json' && !relative.endsWith('/active.json')) add(inside(triggers, relative));
43
+ for (const skill of source.skills ?? []) if (skill.type === 'local' && skill.enabled) {
44
+ const root = inside(path.join(source.home, 'skills'), skill.name);
45
+ for (const relative of walkFiles(root)) add(inside(root, relative));
46
+ }
47
+ for (const relative of projectFiles(source)) add(inside(source.projectPath, relative));
48
+ }
49
+ }
50
+ return sha256(jsonBytes(values));
51
+ }
52
+ export async function inspectCollection(options) {
53
+ const selected = entries(options); const snapshot = sourceSnapshot(selected); const members = {};
54
+ let platforms = ['linux', 'darwin', 'win32'];
55
+ for (const [key, source] of selected) {
56
+ if (source.kind === 'directory') {
57
+ const { tpl, member } = directory(source, key);
58
+ const platform = tpl.team.host.platform;
59
+ members[key] = { profile: member.profile, resources: { baseagents: Object.keys(member.config.baseagents),
60
+ triggers: walkFiles(path.join(source.path, 'agents', key, 'triggers')).filter(file => file.endsWith('/trigger.json')).map(file => file.split('/')[0]),
61
+ skills: Object.keys(member.skills ?? {}), files: fs.existsSync(path.join(source.path, 'workspace', key))
62
+ ? fs.readdirSync(path.join(source.path, 'workspace', key)).sort() : [] },
63
+ defaultBaseagent: member.config.active_baseagent, platforms: platform, warnings: [] };
64
+ platforms = platforms.filter(platformName => platform.includes(platformName));
65
+ } else {
66
+ const data = await inspectAgent(source);
67
+ members[key] = { profile: source.profile, resources: { baseagents: data.baseagents.map(item => item.name),
68
+ triggers: data.triggers.map(item => item.id), skills: data.skills.filter(item => item.type === 'local' && item.enabled).map(item => item.name),
69
+ files: projectFiles(source) },
70
+ defaultBaseagent: data.activeBaseagent, platforms: [process.platform], warnings: [] };
71
+ platforms = platforms.filter(platform => platform === process.platform);
72
+ }
73
+ }
74
+ assert(snapshot === sourceSnapshot(selected), 'SOURCE_CHANGED', 'Source changed while generating inventory');
75
+ return { inventoryDigest: 'sha256:' + sha256(jsonBytes({ snapshot, members, platforms })), members, platforms };
76
+ }
77
+ export function validateCollectionSelection({ inventory, metadata, members }) {
78
+ assert(isRecord(members) && Object.keys(members).sort().join() === Object.keys(inventory.members).sort().join(),
79
+ 'INVALID_ARGUMENT', 'Select every inventory member');
80
+ assert(metadata.platforms.every(platform => inventory.platforms.includes(platform)), 'INCOMPATIBLE', 'Platforms must be common to every member');
81
+ for (const [key, member] of Object.entries(members)) {
82
+ assert(isRecord(member) && Object.keys(member).length === 1 && isRecord(member.include), 'INVALID_ARGUMENT', 'Member include required');
83
+ for (const field of ['baseagents', 'triggers', 'skills', 'files']) {
84
+ const selected = member.include[field];
85
+ assert(Array.isArray(selected) && new Set(selected).size === selected.length
86
+ && selected.every(value => inventory.members[key].resources[field].includes(value)), 'INVALID_ARGUMENT', 'Selection is outside frozen inventory: ' + key + '.' + field);
87
+ }
88
+ assert(member.include.baseagents.includes(inventory.members[key].defaultBaseagent), 'INVALID_ARGUMENT', 'Include the source default baseagent');
89
+ }
90
+ }
91
+ function copyDirectoryMember(root, source, key, include) {
92
+ const { member } = directory(source, key); const result = structuredClone(member);
93
+ result.config.baseagents = Object.fromEntries(Object.entries(result.config.baseagents).filter(([name]) => include.baseagents.includes(name)));
94
+ result.skills = Object.fromEntries(Object.entries(result.skills ?? {}).filter(([name]) => include.skills.includes(name)));
95
+ for (const relative of walkFiles(source.path)) {
96
+ const wanted = relative.startsWith('agents/' + key + '/personal/')
97
+ || include.triggers.some(id => relative.startsWith('agents/' + key + '/triggers/' + id + '/'))
98
+ || include.files.some(file => relative === 'workspace/' + key + '/' + file || relative.startsWith('workspace/' + key + '/' + file + '/'))
99
+ || include.skills.some(name => relative.startsWith('.evolcore/skills/' + name + '/'));
100
+ if (wanted) {
101
+ const file = inside(source.path, relative);
102
+ atomicBytes(inside(root, relative), fs.readFileSync(file), fs.statSync(file).mode & 0o777);
103
+ }
104
+ }
105
+ return result;
106
+ }
107
+ export async function buildCollection(options) {
108
+ const inventory = await inspectCollection(options);
109
+ assert(inventory.inventoryDigest === options.inventoryDigest, 'SOURCE_CHANGED', 'Sources changed since inspect');
110
+ validateCollectionSelection({ inventory, metadata: options.metadata, members: options.selections });
111
+ const selected = entries(options); const members = {};
112
+ assert(!fs.existsSync(options.out), 'CONFLICT', 'Build output already exists');
113
+ fs.mkdirSync(options.out, { recursive: true });
114
+ const teamVariables = selected.filter(([, source]) => source.kind !== 'directory')
115
+ .flatMap(([key, source]) => [[source.agentAid, '{{members.' + key + '.aid}}'], [source.projectPath, '{{members.' + key + '.project}}']]);
116
+ try {
117
+ for (const [key, source] of selected) {
118
+ const include = options.selections[key].include;
119
+ if (source.kind === 'directory') members[key] = { ...collectTemplateDirectory(source.path, key), include };
120
+ else {
121
+ const root = path.join(options.out, 'collect', key); fs.mkdirSync(root, { recursive: true });
122
+ const member = await collectAgent({ ...source, include, teamVariables }, key, root);
123
+ const collected = new Map(walkFiles(root).map(relative => {
124
+ const file = inside(root, relative);
125
+ return [relative, { bytes: fs.readFileSync(file), mode: fs.statSync(file).mode & 0o777 }];
126
+ }));
127
+ // File selections in the inventory are complete relative files, shared with directory collection.
128
+ members[key] = { member, entries: collected, include, excluded: [] };
129
+ }
130
+ }
131
+ const built = buildTemplatePackage({ metadata: options.metadata, members, publisher: selected[0][1].publisher, createdAt: options.createdAt ?? Date.now() });
132
+ assert((await inspectCollection(options)).inventoryDigest === inventory.inventoryDigest, 'SOURCE_CHANGED', 'Sources changed during build');
133
+ const checked = (await import('./shared/template-package.mjs')).inspectTemplatePackage(built.bytes);
134
+ const file = path.join(options.out, built.filename); atomicBytes(file, built.bytes, 0o600);
135
+ fs.rmSync(path.join(options.out, 'collect'), { recursive: true, force: true });
136
+ return { file, metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(checked.team.agents.map(member => [member.key, member])), digest: built.digest, size: built.bytes.length,
137
+ externalAids: built.metadata.externalAids ?? [], scan: built.scan, excluded: built.excluded };
138
+ } catch (error) { fs.rmSync(options.out, { recursive: true, force: true }); throw error; }
139
+ }
140
+
141
+ export function identityText(text, options, reverse = false) {
142
+ if (options.teamVariables && !reverse) {
143
+ const mapping = new Map([...options.teamVariables, [options.ownerAid, '{{owner.aid}}'], [options.hostAid, '{{host.aid}}']].filter(([key]) => key));
144
+ const pattern = [...mapping.keys()].sort((a, b) => b.length - a.length).map(key => key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|');
145
+ return pattern ? text.replace(new RegExp(pattern, 'g'), value => mapping.get(value)) : text;
146
+ }
147
+ const pairs = [[options.agentAid, '{{agent.aid}}'], [options.ownerAid, '{{owner.aid}}'], [options.hostAid, '{{host.aid}}']];
148
+ if (options.projectPath) pairs.push([options.projectPath, '{{project.path}}']);
149
+ for (const [value, token] of pairs) if (value) text = text.split(reverse ? token : value).join(reverse ? value : token);
150
+ return text;
151
+ }
152
+
153
+ function identityValue(value, options) {
154
+ if (typeof value === 'string') return identityText(value, options);
155
+ if (Array.isArray(value)) return value.map(v => identityValue(v, options));
156
+ if (isRecord(value)) return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, identityValue(v, options)]));
157
+ return value;
158
+ }
159
+
160
+ export function normalizeId(aid) {
161
+ let id = aid.split('.')[0].toLowerCase().replace(/[^a-z0-9_-]/g, '-').replace(/^[^a-z0-9]+/, '');
162
+ if (id.length < 3) id = (id || 'a') + '-tpl';
163
+ return id.slice(0, 64);
164
+ }
165
+
166
+ export async function collectAgent(options, key, root) {
167
+ const inventory = await inspectAgent(options);
168
+ const include = options.include;
169
+ assert(isRecord(include), 'INVALID_ARGUMENT', 'include is required');
170
+ const selected = options.include.baseagents.map(name => ({ name, default: name === inventory.activeBaseagent,
171
+ model: inventory.baseagents.find(item => item.name === name)?.currentModel ?? undefined,
172
+ effort: inventory.baseagents.find(item => item.name === name)?.currentEffort ?? undefined }));
173
+ assert(selected.some(item => item.default), 'INVALID_ARGUMENT', 'The current default baseagent must be selected');
174
+ const sourceConfig = options.effectiveConfig ?? readJson(path.join(options.agentDir, 'config.json'));
175
+ const config = behaviorConfig(sourceConfig);
176
+ config.active_baseagent = selected.find(b => b.default).name;
177
+ config.baseagents = {};
178
+ for (const b of selected) {
179
+ assert(BASEAGENTS.includes(b.name) && inventory.baseagents.some(x => x.name === b.name), 'INVALID_ARGUMENT', 'Unknown baseagent');
180
+ const source = sourceConfig.baseagents?.[b.name] ?? {};
181
+ const providerId = options.providerRefs?.[b.name]?.id ?? source.provider;
182
+ assert(typeof providerId === 'string' && options.providers?.[providerId], 'PROVIDER_NOT_FOUND', 'Configure a Provider for ' + b.name);
183
+ const provider = options.providers[providerId];
184
+ const block = { provider: { id: providerId, name: provider.name || providerId } };
185
+ if (b.model !== undefined) { assert(typeof b.model === 'string' && b.model.trim(), 'INVALID_ARGUMENT', 'Invalid model'); block.model = b.model; }
186
+ if (b.effort !== undefined) { assert(typeof b.effort === 'string' && b.effort.length, 'INVALID_ARGUMENT', 'Invalid effort'); block.effort = b.effort; }
187
+ if (source.params !== undefined) block.params = structuredClone(source.params);
188
+ config.baseagents[b.name] = block;
189
+ }
190
+ const put = (relative, bytes, mode) => {
191
+ const buffer = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
192
+ let content = buffer;
193
+ if (!buffer.includes(0) && Buffer.from(buffer.toString('utf8')).equals(buffer)) {
194
+ content = Buffer.from(identityText(buffer.toString('utf8'), options));
195
+ }
196
+ atomicBytes(inside(root, relative), content, mode);
197
+ };
198
+ const agentPrefix = 'agents/' + key;
199
+ for (const name of inventory.profile.soul) put(agentPrefix + '/personal/soul/' + name,
200
+ fs.readFileSync(inside(path.join(options.agentDir, 'personal', 'soul'), name)));
201
+ if (inventory.profile.welcome) put(agentPrefix + '/personal/welcome.md', fs.readFileSync(path.join(options.agentDir, 'personal', 'welcome.md')));
202
+ const triggers = include.triggers ?? [];
203
+ assert(Array.isArray(triggers) && triggers.every(id => inventory.triggers.some(t => t.id === id)), 'INVALID_ARGUMENT', 'Unknown Trigger selection');
204
+ for (const id of triggers) {
205
+ const dir = inside(path.join(options.agentDir, 'triggers'), id);
206
+ const def = readJson(path.join(dir, 'trigger.json'));
207
+ // Approval/runtime provenance belongs to the target environment, never to a template.
208
+ delete def.authorizedBy; delete def.operatorPeers;
209
+ put(agentPrefix + '/triggers/' + id + '/trigger.json', jsonBytes(identityValue(def, options)));
210
+ if (def.execution?.type === 'script') {
211
+ const script = def.execution.script.path;
212
+ const source = inside(dir, script); regularPath(source);
213
+ put(agentPrefix + '/triggers/' + id + '/' + script, fs.readFileSync(source), fs.statSync(source).mode & 0o777);
214
+ }
215
+ }
216
+ const skillNames = include.skills;
217
+ assert(Array.isArray(skillNames) && skillNames.every(name => inventory.skills.some(s => s.name === name && s.type === 'local' && s.enabled)),
218
+ 'INVALID_ARGUMENT', 'Unknown or disabled local skill');
219
+ const switches = {};
220
+ for (const s of inventory.skills.filter(s => s.type === 'builtin')) switches[s.name] = { enabled: s.enabled };
221
+ for (const name of skillNames) {
222
+ switches[name] = { enabled: true };
223
+ const dir = inside(path.join(options.home, 'skills'), name);
224
+ for (const file of walkFiles(dir)) put('.evolcore/skills/' + name + '/' + file, fs.readFileSync(inside(dir, file)), fs.statSync(inside(dir, file)).mode & 0o777);
225
+ }
226
+ const files = include.files ?? [];
227
+ assert(Array.isArray(files), 'INVALID_ARGUMENT', 'Invalid files selection');
228
+ const copied = new Set();
229
+ for (const relative of files) {
230
+ const absolute = path.resolve(inventory.project.path, relative);
231
+ const homeRelative = path.relative(options.home, absolute).split(path.sep);
232
+ assert(homeRelative[0] === '..' || !['AIDs', 'agents', 'data', 'logs', 'backups', 'eck', 'directory'].includes(homeRelative[0]),
233
+ 'INVALID_ARGUMENT', 'Runtime data is not a project artifact');
234
+ const file = inside(inventory.project.path, relative); regularPath(file);
235
+ assert(!excluded(relative) && fs.existsSync(file), 'INVALID_ARGUMENT', 'Excluded or missing selection: ' + relative);
236
+ const paths = fs.statSync(file).isDirectory() ? walkFiles(file, p => excluded(relative + '/' + p)).map(p => relative + '/' + p) : [relative];
237
+ for (const p of paths) if (!excluded(p) && !copied.has(p)) {
238
+ copied.add(p); const source = inside(inventory.project.path, p);
239
+ put('workspace/' + key + '/' + p, fs.readFileSync(source), fs.statSync(source).mode & 0o777);
240
+ }
241
+ }
242
+ const profile = Object.fromEntries([...PROFILE_FIELDS, 'type']
243
+ .filter(field => options.profile?.[field] !== undefined).map(field => [field, options.profile[field]]));
244
+ return { profile: identityValue(profile, options), config: identityValue(config, options), skills: switches };
245
+ }
@@ -0,0 +1,111 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { inspectPackage } from './inspect.mjs';
4
+ import { assert, isRecord, unpack, jsonBytes, atomicBytes, sha256, regularPath } from './shared/common.mjs';
5
+ import { inspectTemplatePackage } from './shared/template-package.mjs';
6
+
7
+ export function readPackage(options) {
8
+ const checked = inspectTemplatePackage(fs.readFileSync(options.archivePath), { digest: options.digest });
9
+ return { metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(checked.team.agents.map(member => [member.key, member])), digest: checked.digest,
10
+ size: fs.statSync(options.archivePath).size, externalAids: checked.metadata.externalAids ?? [], scan: { findings: [] }, excluded: [] };
11
+ }
12
+ export async function previewInstallation(options) {
13
+ const bytes = fs.readFileSync(options.archivePath);
14
+ const checked = inspectTemplatePackage(bytes, { digest: options.digest });
15
+ assert(checked.team.host.platform.includes(process.platform), 'INCOMPATIBLE', 'Template does not support this platform');
16
+ const keys = checked.team.agents.map(member => member.key);
17
+ assert(isRecord(options.members) && keys.sort().join() === Object.keys(options.members).sort().join(), 'INVALID_ARGUMENT', 'Map every template member');
18
+ const root = path.join(options.out, 'package'); assert(!fs.existsSync(root), 'CONFLICT', 'Preview exists');
19
+ unpack(bytes, root); const targets = {};
20
+ for (const key of keys) {
21
+ const input = options.members[key];
22
+ assert(isRecord(input) && typeof input.aid === 'string' && path.isAbsolute(input.projectPath), 'INVALID_ARGUMENT', 'Agent and project required');
23
+ targets[key] = options.installMode === 'overwrite' ? options.targets[key] : {
24
+ home: options.home, targetAid: input.aid, targetConfig: { $schema_version: options.agentSchemaVersion, aid: input.aid,
25
+ enabled: true, lifecycle: 'ownerpending', channels: [], projects: { defaultPath: input.projectPath } },
26
+ projectPath: input.projectPath, ownerAid: options.ownerAid, hostAid: options.hostAid, providers: options.providers,
27
+ profile: {}, profileVersion: 'new-agent',
28
+ };
29
+ }
30
+ const data = await inspectPackage({ packageDir: root, targets, members: options.selections,
31
+ packageRoot: options.packageRoot, out: options.out, digest: checked.digest,
32
+ planMode: options.installMode === 'create' ? 'create_on_host' : 'overlay_existing' });
33
+ const plan = JSON.parse(fs.readFileSync(data.planFile, 'utf8'));
34
+ const configs = {};
35
+ for (const member of plan.members) {
36
+ const write = plan.writes.find(item => item.path === path.join(options.home, 'agents', member.targetAid, 'config.json'));
37
+ assert(write, 'CONFLICT', 'Missing member configuration');
38
+ configs[member.key] = JSON.parse(Buffer.from(write.content, 'base64').toString('utf8'));
39
+ }
40
+ atomicBytes(path.join(options.out, 'source.ectpl'), bytes, 0o600);
41
+ return { ...data, configs, profiles: Object.fromEntries(plan.members.map(member => [member.key, member.profile])),
42
+ metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, platforms: checked.metadata.compat.platforms }, digest: checked.digest, ignored: [], sourceDigest: sha256(bytes) };
43
+ }
44
+
45
+ export async function applyInstallationPlan(options) {
46
+ const { overlay } = await import('./overlay.mjs');
47
+ const { snapshot } = await import('./shared/common.mjs');
48
+ const plan = JSON.parse(fs.readFileSync(options.planFile, 'utf8'));
49
+ const journalFile = path.join(options.backupDir, 'journal.json');
50
+ if (fs.existsSync(journalFile)) {
51
+ const prior = JSON.parse(fs.readFileSync(journalFile, 'utf8'));
52
+ if (prior.applied && !prior.restored) {
53
+ const final = JSON.parse(fs.readFileSync(path.join(path.dirname(options.planFile), 'creation-plan.json'), 'utf8'));
54
+ assert(final.writes.every(write => write.remove ? !fs.existsSync(write.path)
55
+ : fs.existsSync(write.path) && fs.readFileSync(write.path).equals(Buffer.from(write.content, 'base64'))), 'CONFLICT', 'Applied team resources changed');
56
+ return { applied: true, recovered: true };
57
+ }
58
+ const planned = JSON.parse(fs.readFileSync(path.join(path.dirname(options.planFile), 'creation-plan.json'), 'utf8'));
59
+ for (const entry of prior.entries) {
60
+ regularPath(entry.path);
61
+ const current = fs.existsSync(entry.path) ? fs.readFileSync(entry.path) : null;
62
+ const original = entry.existed ? fs.readFileSync(path.join(options.backupDir, entry.backup)) : null;
63
+ const write = planned.writes.find(value => value.path === entry.path);
64
+ assert(write, 'CONFLICT', 'Recovery journal has an unknown target');
65
+ const desired = write.remove ? null : Buffer.from(write.content, 'base64');
66
+ const equal = bytes => current === null ? bytes === null : bytes !== null && current.equals(bytes);
67
+ assert(equal(original) || equal(desired), 'CONFLICT', 'Interrupted team target was independently modified');
68
+ }
69
+ await overlay({ operation: 'restore', backupDir: options.backupDir });
70
+ fs.renameSync(options.backupDir, options.backupDir + '-restored-' + Date.now());
71
+ }
72
+ for (const write of plan.writes) {
73
+ if (!write.path.includes(path.sep + 'agents' + path.sep)) continue;
74
+ const member = plan.members.find(value => write.path.startsWith(path.join(plan.home, 'agents', value.targetAid) + path.sep));
75
+ assert(member, 'INVALID_ARGUMENT', 'Unexpected Agent write');
76
+ const expected = options.baselines?.[member.key]?.[write.path];
77
+ assert(expected !== undefined && JSON.stringify(snapshot(write.path)) === JSON.stringify(expected), 'CONFLICT', 'Prepared Agent changed');
78
+ write.expected = expected;
79
+ if (write.path === path.join(plan.home, 'agents', member.targetAid, 'config.json')) {
80
+ const config = JSON.parse(Buffer.from(write.content, 'base64').toString('utf8'));
81
+ const current = JSON.parse(fs.readFileSync(write.path, 'utf8'));
82
+ config.initialization = current.initialization;
83
+ config.lifecycle = 'ownerpending';
84
+ write.content = jsonBytes(config).toString('base64');
85
+ }
86
+ }
87
+ const final = path.join(path.dirname(options.planFile), 'creation-plan.json');
88
+ atomicBytes(final, jsonBytes(plan), 0o600);
89
+ return await overlay({ planFile: final, backupDir: options.backupDir });
90
+ }
91
+
92
+ /** Compare all planned bytes after restart/activation; lifecycle is controlled by Core. */
93
+ export async function verifyInstallationPlan(options) {
94
+ const plan = JSON.parse(fs.readFileSync(path.join(path.dirname(options.planFile), 'creation-plan.json'), 'utf8'));
95
+ for (const write of plan.writes) {
96
+ if (write.remove) { assert(!fs.existsSync(write.path), 'CONFLICT', 'Removed team resource reappeared'); continue; }
97
+ regularPath(write.path);
98
+ assert(fs.existsSync(write.path), 'CONFLICT', 'Team resource is missing');
99
+ const bytes = fs.readFileSync(write.path);
100
+ const desired = Buffer.from(write.content, 'base64');
101
+ const config = plan.members.some(member => write.path === path.join(plan.home, 'agents', member.targetAid, 'config.json'));
102
+ if (config) {
103
+ const current = JSON.parse(bytes); const expected = JSON.parse(desired);
104
+ assert(['ownerpending', 'active'].includes(current.lifecycle), 'CONFLICT', 'Team lifecycle changed');
105
+ current.lifecycle = expected.lifecycle;
106
+ assert(JSON.stringify(current) === JSON.stringify(expected), 'CONFLICT', 'Team configuration changed');
107
+ } else assert(bytes.equals(desired), 'CONFLICT', 'Team resource changed');
108
+ if (process.platform !== 'win32') assert((fs.statSync(write.path).mode & 0o777) === write.mode, 'CONFLICT', 'Team resource permissions changed');
109
+ }
110
+ return { verified: true };
111
+ }
@@ -0,0 +1,143 @@
1
+ /** Shared AID preparation kernel. No registry, Host creation, profiles, Core paths or SDK internals. */
2
+ import { createHash, randomUUID } from 'node:crypto';
3
+
4
+ export const AID_BATCH_CONTRACT_VERSION = 1;
5
+ const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
6
+ const fail = (code, message, details) => { throw Object.assign(new Error(message), { code, ...(details ? { details } : {}) }); };
7
+ const stable = value => JSON.stringify(value, Object.keys(value).sort());
8
+ const fingerprint = value => createHash('sha256').update(stable(value)).digest('hex');
9
+ const aidPattern = /^[a-z0-9][a-z0-9_-]*\.(?:[a-z0-9-]+\.)*[a-z0-9-]+$/;
10
+ const delay = ms => new Promise(resolve => setTimeout(resolve, ms));
11
+
12
+ export function createMemoryAidCheckpoints() {
13
+ const entries = new Map();
14
+ return {
15
+ durable: false,
16
+ read: key => entries.has(key) ? structuredClone(entries.get(key)) : null,
17
+ write(key, next, expectedRevision) {
18
+ if ((entries.get(key)?.revision ?? null) !== expectedRevision) fail('CONFLICT', 'AID checkpoint revision changed');
19
+ entries.set(key, structuredClone(next));
20
+ },
21
+ };
22
+ }
23
+
24
+ /** A pending Owner is a resumable result. Wrong identity/Owner/version is never accepted. */
25
+ export async function waitForAidConsensus({ subject, ownerAid, readConsensus, attempts = 20, delayMs = 500, wait = delay, signal }) {
26
+ if (!Number.isInteger(attempts) || attempts < 1 || attempts > 100 || typeof readConsensus !== 'function') fail('INVALID_ARGUMENT', 'Invalid consensus query');
27
+ for (let attempt = 0; attempt < attempts; attempt++) {
28
+ signal?.throwIfAborted();
29
+ const view = await readConsensus();
30
+ if (view?.status === 'consensus') {
31
+ if (view.owner_aid !== ownerAid || view.sub_aid !== subject.aid || view.lock !== 'locked'
32
+ || !Number.isSafeInteger(view.relation_version) || view.relation_version !== (subject.relationVersion ?? 1)) {
33
+ fail('OWNERSHIP_MISMATCH', 'Ownership consensus mismatch', { aid: subject.aid });
34
+ }
35
+ return structuredClone(view);
36
+ }
37
+ if (view?.owner_aid && view.owner_aid !== ownerAid) fail('OWNERSHIP_MISMATCH', 'Ownership belongs to another Owner', { aid: subject.aid });
38
+ if (attempt + 1 < attempts) await wait(delayMs);
39
+ }
40
+ return null;
41
+ }
42
+
43
+ /**
44
+ * transport: authorize,register,connect,bind,consensus,close; recover is mandatory on unknown results.
45
+ * Checkpoint persistence belongs to the caller; members mode requires a durable CAS implementation.
46
+ * register/bind receive stable requestId+operationId. A transport must query authoritative effects on recovery.
47
+ */
48
+ export async function prepareAidBatch({ subjects, context, transport, checkpoints, concurrency = 1,
49
+ consensusAttempts = 20, consensusDelayMs = 500, wait = delay, signal } = {}) {
50
+ if (!record(context) || !['team', 'members'].includes(context.mode) || !aidPattern.test(context.ownerAid ?? '')
51
+ || !aidPattern.test(context.hostAid ?? '') || typeof context.requestId !== 'string' || !context.requestId
52
+ || !Array.isArray(subjects) || !subjects.length || !Number.isInteger(concurrency) || concurrency < 1 || concurrency > 32) fail('INVALID_ARGUMENT', 'Invalid AID batch context');
53
+ if (!checkpoints || typeof checkpoints.read !== 'function' || typeof checkpoints.write !== 'function'
54
+ || context.mode === 'members' && checkpoints.durable !== true) fail('INVALID_ARGUMENT', 'Members mode requires durable AID checkpoints');
55
+ for (const method of ['authorize', 'register', 'connect', 'bind', 'consensus', 'close']) if (typeof transport?.[method] !== 'function') fail('INVALID_ARGUMENT', 'Missing identity transport: ' + method);
56
+ const aids = new Set(), keys = new Set();
57
+ for (const s of subjects) {
58
+ if (!record(s) || !/^[a-z0-9][a-z0-9_-]{0,31}$/.test(s.key ?? '') || !aidPattern.test(s.aid ?? '')
59
+ || s.relationVersion !== undefined && (!Number.isSafeInteger(s.relationVersion) || s.relationVersion < 1)
60
+ || !['agent', 'host'].includes(s.type) || aids.has(s.aid) || keys.has(s.key) || s.aid === context.ownerAid
61
+ || context.mode === 'members' && (s.type !== 'agent' || s.aid === context.hostAid)
62
+ || s.type === 'host' && s.aid !== context.hostAid) fail('INVALID_ARGUMENT', 'Invalid or duplicate identity subject');
63
+ aids.add(s.aid); keys.add(s.key);
64
+ }
65
+ const processSubject = async subject => {
66
+ signal?.throwIfAborted();
67
+ const authorize = async () => {
68
+ const authorization = await transport.authorize(subject, context);
69
+ if (authorization?.ownerAid !== context.ownerAid || authorization?.hostAid !== context.hostAid) fail('NOT_ALLOWED', 'Trusted Owner/Host authorization required');
70
+ };
71
+ await authorize();
72
+ const identity = { aid: subject.aid, type: subject.type, ownerAid: context.ownerAid, hostAid: context.hostAid,
73
+ requestId: context.requestId + ':' + subject.key, relationVersion: subject.relationVersion ?? 1 };
74
+ const requestFingerprint = fingerprint(identity), key = identity.requestId;
75
+ let state = await checkpoints.read(key);
76
+ if (state && (state.fingerprint !== requestFingerprint || state.version !== AID_BATCH_CONTRACT_VERSION)) fail('CONFLICT', 'AID request already belongs to another identity');
77
+ const save = async patch => {
78
+ const revision = state?.revision ?? null;
79
+ const next = { ...(state ?? {}), ...structuredClone(patch), revision: (revision ?? -1) + 1 };
80
+ await checkpoints.write(key, next, revision);
81
+ state = next;
82
+ };
83
+ if (!state) await save({ version: AID_BATCH_CONTRACT_VERSION, fingerprint: requestFingerprint, ...identity,
84
+ operationId: randomUUID(), status: 'running', registration: 'not_started', binding: 'not_started' });
85
+ const operation = () => ({ requestId: state.requestId, operationId: state.operationId, ownerAid: context.ownerAid, hostAid: context.hostAid, signal });
86
+ const effect = async (field, action, client) => {
87
+ if (state[field] === 'confirmed') return;
88
+ if (['intent', 'unknown'].includes(state[field])) {
89
+ if (typeof transport.recover !== 'function') fail('RECOVERY_REQUIRED', 'Unknown ' + field + ' outcome requires authoritative recovery', { aid: subject.aid, requestId: state.requestId });
90
+ const recovered = await transport.recover(field, subject, state, operation());
91
+ if (recovered?.state === 'confirmed' && recovered.proven === true && recovered.operationId === state.operationId && recovered.fingerprint === state.fingerprint) { await save({ [field]: 'confirmed', status: 'running' }); return; }
92
+ if (recovered?.state !== 'not_started' || recovered.proven !== true || recovered.operationId !== state.operationId || recovered.fingerprint !== state.fingerprint) fail('RECOVERY_REQUIRED', 'Identity effect remains unknown', { aid: subject.aid, requestId: state.requestId });
93
+ await save({ [field]: 'not_started', status: 'running' });
94
+ }
95
+ signal?.throwIfAborted();
96
+ await authorize();
97
+ await save({ [field]: 'intent', status: 'running' });
98
+ try {
99
+ const result = await action(subject, client, operation());
100
+ if (result?.ok === false) throw Object.assign(new Error(result.error?.message ?? field + ' failed'), { code: result.error?.code });
101
+ await save({ [field]: 'confirmed', status: 'running' });
102
+ } catch (error) {
103
+ await save({ [field]: 'unknown', status: 'recovery_required', error: { code: error.code ?? 'UNKNOWN_EFFECT', phase: field } });
104
+ fail('RECOVERY_REQUIRED', field + ' result is unknown: ' + error.message, { aid: subject.aid, requestId: state.requestId });
105
+ }
106
+ };
107
+ await effect('registration', (s, _client, op) => transport.register(s, op));
108
+ let client, failure, result;
109
+ try {
110
+ signal?.throwIfAborted();
111
+ client = await transport.connect(subject, operation());
112
+ if (!client) fail('INVALID_IDENTITY', 'Subject connection required');
113
+ if (typeof client.getType === 'function' && client.getType() !== subject.type) fail('INVALID_IDENTITY', 'Subject type mismatch');
114
+ await effect('binding', (s, active, op) => transport.bind(s, active, op), client);
115
+ await authorize();
116
+ const consensus = await waitForAidConsensus({ subject, ownerAid: context.ownerAid, attempts: consensusAttempts,
117
+ delayMs: consensusDelayMs, wait, signal, readConsensus: () => transport.consensus(subject, client, operation()) });
118
+ if (!consensus) {
119
+ await save({ status: 'awaiting_owner' });
120
+ result = { key: subject.key, aid: subject.aid, status: 'awaiting_owner', requestId: state.requestId, operationId: state.operationId };
121
+ } else {
122
+ await save({ status: 'ready', consensus });
123
+ result = { key: subject.key, aid: subject.aid, status: 'ready', requestId: state.requestId, operationId: state.operationId, consensus };
124
+ }
125
+ } catch (error) { failure = error; }
126
+ finally {
127
+ if (client) try { await transport.close(client, subject); }
128
+ catch (error) { failure ??= error; }
129
+ }
130
+ if (failure) throw failure;
131
+ return result;
132
+ };
133
+ const results = new Array(subjects.length);
134
+ let cursor = 0, failure;
135
+ await Promise.all(Array.from({ length: Math.min(concurrency, subjects.length) }, async () => {
136
+ while (!failure && cursor < subjects.length) {
137
+ const index = cursor++;
138
+ try { results[index] = await processSubject(subjects[index]); } catch (error) { failure ??= error; }
139
+ }
140
+ }));
141
+ if (failure) throw failure;
142
+ return { status: results.every(result => result.status === 'ready') ? 'ready' : 'awaiting_owner', subjects: results };
143
+ }
@@ -1,32 +0,0 @@
1
- import { createRequire } from 'node:module';
2
- import canonicalize from 'canonicalize';
3
- import { abilityAssert } from './types.js';
4
- const semver = createRequire(import.meta.url)('semver');
5
- export const sameJson = (a, b) => canonicalize(a) === canonicalize(b);
6
- export const dataVersion = (pkg) => pkg.manifest.data?.schemaVersion ?? 1;
7
- export function versionImpact(instance, previous, candidate) {
8
- const oldPaths = previous.definitions.map(row => String(row.definition.path));
9
- const newPaths = candidate.definitions.map(row => String(row.definition.path));
10
- const changedPaths = newPaths.filter(path => {
11
- const old = previous.definitions.find(row => row.definition.path === path);
12
- return old && !sameJson(old, candidate.definitions.find(row => row.definition.path === path));
13
- });
14
- return {
15
- fromVersion: previous.manifest.version, toVersion: candidate.manifest.version,
16
- downgrade: semver.lt(candidate.manifest.version, previous.manifest.version), samePackage: previous.digest === candidate.digest,
17
- addedPaths: newPaths.filter(path => !oldPaths.includes(path)), removedPaths: oldPaths.filter(path => !newPaths.includes(path)), changedPaths,
18
- contracts: changedPaths.map(path => ({ path, before: previous.definitions.find(row => row.definition.path === path), after: candidate.definitions.find(row => row.definition.path === path) })),
19
- configSchemaChanged: !sameJson(previous.configSchema, candidate.configSchema),
20
- configuration: { before: previous.configSchema, after: candidate.configSchema },
21
- permissionsChanged: !sameJson(previous.manifest.permissions, candidate.manifest.permissions),
22
- permissions: { before: previous.manifest.permissions, after: candidate.manifest.permissions },
23
- data: { fromVersion: dataVersion(previous), toVersion: dataVersion(candidate), migrationRequired: dataVersion(previous) !== dataVersion(candidate) },
24
- invalidatedGrantIds: instance.grants.filter(grant => grant.permission === 'remote-call' && !grant.revokedAt).map(grant => grant.id),
25
- externalDataWarning: instance.grants.some(grant => grant.permission === 'workspace' && !grant.revokedAt
26
- && (grant.expiresAt ?? 0) > Date.now() && grant.issuedByAid === instance.approvedByAid && grant.value.mode === 'read-write'),
27
- };
28
- }
29
- export function assertPackageVersion(store, candidate) {
30
- for (const previous of store.list('package'))
31
- abilityAssert(previous.manifest.id !== candidate.manifest.id || previous.manifest.version !== candidate.manifest.version || previous.digest === candidate.digest, 'VERSION_CONTENT_CONFLICT', 'A plugin version already identifies different content on this host; publish a new version', 409);
32
- }
@@ -1,17 +0,0 @@
1
- /** Per-message authenticated metadata. Never read the Agent's mutable model here:
2
- * an in-flight turn must keep its model even after a configuration change. */
3
- export function aunProtectedHeaders(context) {
4
- const headers = {};
5
- const raw = context?.metadata?.protectedHeaders;
6
- if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
7
- for (const [key, value] of Object.entries(raw)) {
8
- const name = key.trim().toLowerCase();
9
- if (/^[a-z0-9_-]+$/.test(name) && typeof value === 'string')
10
- headers[name] = value;
11
- }
12
- }
13
- const model = context?.model?.trim();
14
- if (model)
15
- headers.model = model;
16
- return Object.keys(headers).length > 0 ? headers : undefined;
17
- }
@@ -1,19 +0,0 @@
1
- import { AUNChannelPlugin } from './aun.js';
2
- export async function registerBuiltinChannelPlugins(channelLoader) {
3
- channelLoader.register(new AUNChannelPlugin());
4
- const providers = [
5
- ['feishu', async () => new (await import('./feishu.js')).FeishuChannelPlugin()],
6
- ['wechat', async () => new (await import('./wechat.js')).WechatChannelPlugin()],
7
- ['dingtalk', async () => new (await import('./dingtalk.js')).DingtalkChannelPlugin()],
8
- ['qqbot', async () => new (await import('./qqbot.js')).QQBotChannelPlugin()],
9
- ['wecom', async () => new (await import('./wecom.js')).WecomChannelPlugin()],
10
- ];
11
- for (const [channelType, load] of providers) {
12
- try {
13
- channelLoader.register(await load());
14
- }
15
- catch (error) {
16
- channelLoader.recordProviderFailure(channelType, error);
17
- }
18
- }
19
- }
@@ -1,2 +0,0 @@
1
- /** Public Phase 1 entry point; implementation lives with bootstrap lifecycle code. */
2
- export { TeamWorkspaceInitializer, TeamWorkspaceBootstrapError, resolveTeamWorkspaceIdentity, } from './team-workspace-bootstrap.js';