evolcore 0.0.43-test.4 → 0.0.43-test.6

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 (186) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/bin/ecmsg.js +437 -91
  3. package/dist/agents/baseagent-availability.js +19 -4
  4. package/dist/agents/baseagent.js +2 -2
  5. package/dist/agents/claude-runner.js +19 -4
  6. package/dist/agents/codex/app-server-client.js +14 -3
  7. package/dist/agents/codex-runner.js +18 -23
  8. package/dist/aun/aid/agentmd.js +25 -0
  9. package/dist/aun/aid/control-aid.js +15 -0
  10. package/dist/aun/aid/identity.js +8 -0
  11. package/dist/aun/aid/ownership-operation.js +12 -3
  12. package/dist/aun/group/invite-service.js +3 -2
  13. package/dist/aun/service-proxy.js +18 -6
  14. package/dist/channels/aun.js +99 -23
  15. package/dist/channels/daemon.js +2 -2
  16. package/dist/cli/agent-create.js +19 -7
  17. package/dist/cli/aid-bind-command.js +3 -0
  18. package/dist/cli/aun-commands.js +19 -4
  19. package/dist/cli/code-stats.js +451 -213
  20. package/dist/cli/ctl-command.js +1 -3
  21. package/dist/cli/daemon-commands.js +42 -4
  22. package/dist/cli/directory.js +3 -1
  23. package/dist/cli/ecmsg-gateway.js +206 -0
  24. package/dist/cli/index.js +6 -0
  25. package/dist/cli/init.js +120 -13
  26. package/dist/cli/provider-command.js +82 -5
  27. package/dist/cli/restart-monitor.js +35 -24
  28. package/dist/cli/stats.js +8 -1
  29. package/dist/cli/task-context.js +41 -1
  30. package/dist/cli/watch-logs.js +6 -4
  31. package/dist/config/boot-log.js +16 -3
  32. package/dist/config/builtin-roles.js +2 -2
  33. package/dist/config/config-manager.js +5 -14
  34. package/dist/config/daemon-services.js +1 -0
  35. package/dist/config/peer-role-resolver.js +6 -6
  36. package/dist/config/provider-identity-migration.js +277 -0
  37. package/dist/config/provider-identity.js +37 -0
  38. package/dist/config/provider-ipc-service.js +40 -3
  39. package/dist/config/provider-local-sync.js +155 -0
  40. package/dist/config/providers-config.js +45 -4
  41. package/dist/config/providers-management.js +242 -76
  42. package/dist/config/providers.js +4 -1
  43. package/dist/config/role-service.js +8 -8
  44. package/dist/config/role-store.js +22 -22
  45. package/dist/config/schema-migration.js +143 -86
  46. package/dist/config/snapshot.js +70 -41
  47. package/dist/core/agent-runtime.js +48 -9
  48. package/dist/core/auth/auth-gateway.js +5 -3
  49. package/dist/core/auth/delegation-diagnostics.js +6 -2
  50. package/dist/core/auth/operation-authorizer.js +3 -1
  51. package/dist/core/auth/operation-catalog.js +6 -4
  52. package/dist/core/baseagent-loader.js +114 -11
  53. package/dist/core/channel-loader.js +36 -13
  54. package/dist/core/channel-runtime.js +112 -42
  55. package/dist/core/command/cli-intent-parser.js +2 -1
  56. package/dist/core/command/command-handler.js +16 -11
  57. package/dist/core/command/menu-handler.js +8 -3
  58. package/dist/core/command/menu-protocol.js +80 -7
  59. package/dist/core/command/provider-menu.js +4 -2
  60. package/dist/core/command/role-menu.js +29 -17
  61. package/dist/core/command/slash-handler.js +52 -16
  62. package/dist/core/daemon-control.js +42 -15
  63. package/dist/core/daemon-lifecycle.js +411 -67
  64. package/dist/core/handoff/dispatcher.js +9 -3
  65. package/dist/core/handoff/runtime.js +139 -45
  66. package/dist/core/handoff/store.js +190 -2
  67. package/dist/core/handoff/types.js +5 -0
  68. package/dist/core/initialization/service.js +7 -6
  69. package/dist/core/ipc-registration.js +5 -4
  70. package/dist/core/lifecycle-notice.js +10 -4
  71. package/dist/core/message/aun-ipc-sender.js +83 -5
  72. package/dist/core/message/message-admission.js +2 -0
  73. package/dist/core/message/message-bridge.js +53 -4
  74. package/dist/core/message/message-queue.js +46 -4
  75. package/dist/core/message/pending-hints.js +4 -10
  76. package/dist/core/message/response-engine.js +33 -25
  77. package/dist/core/message/send-options.js +40 -0
  78. package/dist/core/message/send-routing.js +320 -0
  79. package/dist/core/ownership/owner-resolver.js +112 -8
  80. package/dist/core/permission/ec-command-parser.js +159 -16
  81. package/dist/core/permission/readonly-shell-query.js +66 -7
  82. package/dist/core/permission/tool-error-code.js +13 -1
  83. package/dist/core/permission/tool-policy.js +74 -20
  84. package/dist/core/relation/same-owner-proof.js +131 -0
  85. package/dist/core/session/adapters/claude-session-file-adapter.js +24 -0
  86. package/dist/core/session/adapters/codex-session-file-adapter.js +80 -0
  87. package/dist/core/session/adapters/ecagent-session-file-adapter.js +22 -0
  88. package/dist/core/session/adapters/gemini-session-file-adapter.js +39 -0
  89. package/dist/core/session/session-fs-store.js +164 -3
  90. package/dist/core/session/session-idle-monitor.js +103 -17
  91. package/dist/core/session/session-manager.js +105 -18
  92. package/dist/core/thread/thread-route.js +5 -2
  93. package/dist/directory/owner-directory-admission.js +26 -1
  94. package/dist/directory/owner-directory-cache.js +739 -109
  95. package/dist/directory/owner-directory-markdown.js +146 -36
  96. package/dist/directory/owner-directory-query-operation.js +6 -3
  97. package/dist/directory/owner-directory-scope.js +12 -0
  98. package/dist/directory/owner-directory-search.js +5 -1
  99. package/dist/directory/owner-directory-store.js +28 -0
  100. package/dist/ecweb/basic-settings-service.js +15 -1
  101. package/dist/ecweb/message-context-service.js +2 -2
  102. package/dist/ecweb/providers-service.js +3 -1
  103. package/dist/ecweb/runtime/lifecycle.js +26 -15
  104. package/dist/ecweb/runtime/supervisor.js +120 -51
  105. package/dist/index.js +551 -250
  106. package/dist/paths.js +2 -1
  107. package/dist/proxy/manager.js +40 -17
  108. package/dist/proxy/service-supervisor.js +67 -33
  109. package/dist/response-system/engines/v1/proactive-flow.js +4 -0
  110. package/dist/trigger/application-service.js +4 -1
  111. package/dist/trigger/audit.js +19 -4
  112. package/dist/trigger/authorization.js +14 -5
  113. package/dist/trigger/event-source.js +4 -0
  114. package/dist/trigger/feedback.js +26 -2
  115. package/dist/trigger/history.js +176 -7
  116. package/dist/trigger/manager.js +1 -3
  117. package/dist/trigger/scheduler.js +81 -8
  118. package/dist/trigger/system-definitions.js +2 -2
  119. package/dist/trigger/validation.js +4 -0
  120. package/dist/utils/autostart.js +2 -2
  121. package/dist/utils/cross-platform.js +188 -12
  122. package/dist/utils/host-info.js +11 -8
  123. package/dist/utils/npm-ops.js +48 -0
  124. package/dist/utils/process-introspect.js +64 -1
  125. package/dist/utils/public-suffix.js +5811 -0
  126. package/dist/utils/startup-trace.js +160 -19
  127. package/dist/utils/windows-autostart.js +41 -7
  128. package/ecagent/dist/harness/env/nodejs.js +46 -2
  129. package/kits/docs/aun/ABILITY_CALLING.md +6 -6
  130. package/kits/docs/channels/aun.md +1 -1
  131. package/kits/docs/channels/feishu.md +2 -2
  132. package/kits/docs/context-assembly.md +20 -4
  133. package/kits/docs/evolcore/INDEX.md +5 -3
  134. package/kits/docs/evolcore/agent.md +2 -2
  135. package/kits/docs/evolcore/aid.md +8 -2
  136. package/kits/docs/evolcore/ctl.md +15 -5
  137. package/kits/docs/evolcore/directory.md +48 -15
  138. package/kits/docs/evolcore/group.md +8 -8
  139. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  140. package/kits/docs/evolcore/menu-exec-schema-commands.md +1 -1
  141. package/kits/docs/evolcore/menu-protocol.md +32 -3
  142. package/kits/docs/evolcore/msg.md +38 -30
  143. package/kits/docs/evolcore/provider.md +57 -5
  144. package/kits/docs/evolcore/response.md +2 -2
  145. package/kits/docs/evolcore/thread-chain.md +11 -13
  146. package/kits/docs/evolcore/tool-authorization.md +17 -0
  147. package/kits/docs/evolcore/trigger.md +2 -2
  148. package/kits/docs/identity/ROLE_DETAIL.md +1 -1
  149. package/kits/docs/prompt-loading-architecture.md +30 -20
  150. package/kits/eck_manifest.auxiliary.json +5 -5
  151. package/kits/eck_manifest.json +44 -32
  152. package/kits/eck_manifest.memory.json +18 -18
  153. package/kits/eck_message_manifest.json +3 -3
  154. package/kits/rules/01-overview.md +1 -1
  155. package/kits/rules/06-channel.md +7 -8
  156. package/kits/schemas/_meta.json +7 -1
  157. package/kits/schemas/daemon.schema.1.json +5 -0
  158. package/kits/schemas/daemon.schema.2.json +5 -0
  159. package/kits/schemas/daemon.schema.3.json +2 -1
  160. package/kits/schemas/daemon.schema.4.json +2 -1
  161. package/kits/schemas/daemon.schema.5.json +2 -1
  162. package/kits/schemas/daemon.schema.6.json +1 -1
  163. package/kits/schemas/daemon.schema.7.json +1 -1
  164. package/kits/schemas/daemon.schema.8.json +2 -1
  165. package/kits/schemas/daemon.schema.9.json +2 -1
  166. package/kits/schemas/providers.schema.2.json +74 -0
  167. package/kits/schemas/role-registry.schema.1.json +2 -2
  168. package/kits/schemas/single-session.schema.1.json +1 -1
  169. package/kits/schemas/single-session.schema.2.json +1 -1
  170. package/kits/schemas/single-session.schema.3.json +1 -1
  171. package/kits/skills/aid-ability/SKILL.md +7 -7
  172. package/kits/skills/ec-agent-create/SKILL.md +1 -0
  173. package/kits/skills/ec-group/SKILL.md +8 -5
  174. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  175. package/kits/skills/ec-service-proxy/SKILL.md +3 -10
  176. package/kits/skills/ec-trigger/SKILL.md +9 -9
  177. package/kits/skills/ec-trigger/references/examples.md +1 -1
  178. package/kits/skills/thread-ops/SKILL.md +10 -10
  179. package/kits/templates/system-fragments/channel.md +5 -5
  180. package/kits/templates/system-fragments/commands.md +7 -6
  181. package/kits/templates/system-fragments/directory-contacts.md +10 -3
  182. package/kits/templates/system-fragments/personal-assistant.md +22 -3
  183. package/kits/templates/system-fragments/reply.md +48 -28
  184. package/kits/templates/system-fragments/session.md +3 -10
  185. package/kits/templates/system-fragments/thread.md +5 -5
  186. package/package.json +4 -4
@@ -0,0 +1,277 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { isDeepStrictEqual } from 'node:util';
4
+ import { providerIdentity } from './provider-identity.js';
5
+ import { initializationRuntimePlan, providerEnvironmentVariable } from './providers-config.js';
6
+ import { validateProvidersFile } from './providers-config.js';
7
+ export function planProviderIdentityMigration(home, registry, options = {}) {
8
+ home = path.resolve(home);
9
+ const changes = [];
10
+ const expected = [];
11
+ const summary = { providersMigrated: 0, skippedProviders: 0, filesChanged: 0, referencesUpdated: 0, aliasesRemoved: 0 };
12
+ const pending = [];
13
+ const providerFile = path.join(home, 'providers.json');
14
+ const readJson = (file) => {
15
+ if (fs.lstatSync(file).isSymbolicLink())
16
+ throw new Error('Provider migration does not follow configuration symlinks');
17
+ const text = fs.readFileSync(file, 'utf8');
18
+ expected.push({ file, before: text });
19
+ const value = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text);
20
+ if (!value || typeof value !== 'object' || Array.isArray(value))
21
+ throw new Error('Provider migration requires object configurations');
22
+ return { text, value: value };
23
+ };
24
+ if (!fs.existsSync(providerFile) && !registry)
25
+ return { home, changes, summary, pending, expected, registry: { providers: {} } };
26
+ const original = fs.existsSync(providerFile) ? readJson(providerFile) : { text: null, value: { providers: {} } };
27
+ if (original.text === null)
28
+ expected.push({ file: providerFile, before: null });
29
+ const source = validateProvidersFile(registry ?? original.value);
30
+ const providers = {};
31
+ const mapping = {};
32
+ const sourceIds = new Map();
33
+ const mergeServicesFrom = (target, source, providerIds) => {
34
+ const targetBase = target.common.baseUrl;
35
+ const sourceBase = source.common.baseUrl;
36
+ const staticUrls = !providerEnvironmentVariable(targetBase) && !providerEnvironmentVariable(sourceBase);
37
+ const conflicts = [];
38
+ const targetCommon = { ...target.common, baseUrl: staticUrls ? new URL(targetBase).origin : targetBase };
39
+ const sourceCommon = { ...source.common, baseUrl: staticUrls ? new URL(sourceBase).origin : sourceBase };
40
+ for (const field of ['baseUrl', 'apiKey', 'headers', 'queryParams']) {
41
+ if (!isDeepStrictEqual(targetCommon[field], sourceCommon[field]))
42
+ conflicts.push(`common.${field}`);
43
+ }
44
+ const services = { ...(target.services ?? {}) };
45
+ for (const [serviceType, rawService] of Object.entries(source.services ?? {})) {
46
+ let service = rawService;
47
+ if (staticUrls && targetBase !== sourceBase && new URL(targetBase).origin === new URL(sourceBase).origin) {
48
+ const resolved = new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`);
49
+ service = { ...rawService, path: `${resolved.pathname}${resolved.search}${resolved.hash}` };
50
+ }
51
+ if (Object.hasOwn(services, serviceType)) {
52
+ const existing = services[serviceType];
53
+ const equivalent = staticUrls
54
+ ? new URL(existing.path || '.', targetBase.endsWith('/') ? targetBase : `${targetBase}/`).href.replace(/\/+$/u, '')
55
+ === new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`).href.replace(/\/+$/u, '')
56
+ && isDeepStrictEqual({ ...existing, path: undefined }, { ...rawService, path: undefined })
57
+ : isDeepStrictEqual(existing, service);
58
+ if (!equivalent) {
59
+ const sameEndpoint = staticUrls
60
+ ? new URL(existing.path || '.', targetBase.endsWith('/') ? targetBase : `${targetBase}/`).href.replace(/\/+$/u, '')
61
+ === new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`).href.replace(/\/+$/u, '')
62
+ : isDeepStrictEqual(existing.path, service.path);
63
+ if (!sameEndpoint)
64
+ conflicts.push(`services.${serviceType}.path`);
65
+ for (const field of ['style', 'models']) {
66
+ if (!isDeepStrictEqual(existing[field], service[field]))
67
+ conflicts.push(`services.${serviceType}.${field}`);
68
+ }
69
+ }
70
+ continue;
71
+ }
72
+ services[serviceType] = service;
73
+ }
74
+ if (conflicts.length) {
75
+ throw Object.assign(new Error('Provider migration conflicts; no configuration was changed'), {
76
+ code: 'PROVIDER_CONFLICT',
77
+ data: { kind: 'provider_migration_conflict', providerIds, domain: target.domain, fields: conflicts },
78
+ });
79
+ }
80
+ target.services = services;
81
+ };
82
+ for (const [oldId, provider] of Object.entries(source.providers).sort(([left], [right]) => left.localeCompare(right))) {
83
+ if (options.preserveProviderIds) {
84
+ providers[oldId] = provider;
85
+ continue;
86
+ }
87
+ let identity;
88
+ try {
89
+ identity = providerIdentity(provider);
90
+ }
91
+ catch (error) {
92
+ const errorCode = error?.code;
93
+ const legacyUnresolved = provider.domain === undefined && (providerEnvironmentVariable(provider.common.baseUrl)
94
+ ? errorCode === 'PROVIDER_DOMAIN_REQUIRED' : errorCode === 'PROVIDER_DOMAIN_INVALID');
95
+ if (!legacyUnresolved)
96
+ throw error;
97
+ if (Object.hasOwn(providers, oldId)) {
98
+ throw Object.assign(new Error(`Provider ID collision with a legacy entry: ${oldId}`), { code: 'PROVIDER_ID_COLLISION' });
99
+ }
100
+ providers[oldId] = provider;
101
+ pending.push(oldId);
102
+ summary.skippedProviders++;
103
+ continue;
104
+ }
105
+ const normalized = { ...provider, domain: identity.domain };
106
+ const existing = providers[identity.providerId];
107
+ if (existing) {
108
+ if (existing.domain !== identity.domain) {
109
+ throw Object.assign(new Error(`Provider ID collision: ${identity.providerId}`), { code: 'PROVIDER_ID_COLLISION' });
110
+ }
111
+ mergeServicesFrom(existing, normalized, [...sourceIds.get(identity.providerId), oldId]);
112
+ sourceIds.get(identity.providerId).push(oldId);
113
+ }
114
+ else {
115
+ providers[identity.providerId] = normalized;
116
+ sourceIds.set(identity.providerId, [oldId]);
117
+ }
118
+ if (oldId !== identity.providerId) {
119
+ mapping[oldId] = identity.providerId;
120
+ summary.providersMigrated++;
121
+ }
122
+ }
123
+ const aliases = {};
124
+ for (const [alias, target] of Object.entries(source.aliases ?? {}))
125
+ aliases[alias] = mapping[target] ?? target;
126
+ Object.assign(aliases, mapping);
127
+ for (const [alias, target] of Object.entries(aliases)) {
128
+ if (Object.hasOwn(providers, alias))
129
+ throw new Error(`Provider ID conflicts with an old ID: ${alias} -> ${target}`);
130
+ }
131
+ const normalizedRegistry = validateProvidersFile({ $schema_version: 2, providers,
132
+ ...(!options.cleanupAliases && Object.keys(aliases).length ? { aliases } : {}) });
133
+ if (options.cleanupAliases)
134
+ summary.aliasesRemoved = Object.keys(aliases).length;
135
+ const queue = (file, before, value) => {
136
+ changes.push({ file, kind: 'provider-domain-id', before, after: JSON.stringify(value, null, 2) + String.fromCharCode(10) });
137
+ summary.filesChanged++;
138
+ };
139
+ const finish = () => {
140
+ if (!isDeepStrictEqual(original.value, normalizedRegistry))
141
+ queue(providerFile, original.text, normalizedRegistry);
142
+ return { home, changes, summary, pending, expected, registry: normalizedRegistry };
143
+ };
144
+ if (!Object.keys(aliases).length)
145
+ return finish();
146
+ const agentsDir = path.join(home, 'agents');
147
+ if (fs.existsSync(agentsDir) && fs.lstatSync(agentsDir).isSymbolicLink())
148
+ throw new Error('Provider migration does not follow agent directory symlinks');
149
+ const files = [path.join(agentsDir, 'defaults.json')];
150
+ for (const agent of fs.existsSync(agentsDir) ? fs.readdirSync(agentsDir, { withFileTypes: true }) : []) {
151
+ if (agent.isSymbolicLink())
152
+ throw new Error('Provider migration does not follow agent directory symlinks');
153
+ if (!agent.isDirectory() || !/^[a-z0-9-]+(?:[.][a-z0-9-]+){2,}$/iu.test(agent.name))
154
+ continue;
155
+ const agentDir = path.join(agentsDir, agent.name);
156
+ files.push(path.join(agentDir, 'config.json'));
157
+ files.push(path.join(agentDir, 'data', 'initialization.json'));
158
+ const relations = path.join(agentDir, 'relations');
159
+ if (!fs.existsSync(relations))
160
+ continue;
161
+ if (fs.lstatSync(relations).isSymbolicLink())
162
+ throw new Error('Provider migration does not follow relation directory symlinks');
163
+ for (const relation of fs.readdirSync(relations, { withFileTypes: true })) {
164
+ if (relation.isSymbolicLink())
165
+ throw new Error('Provider migration does not follow relation directory symlinks');
166
+ if (relation.isDirectory())
167
+ files.push(path.join(relations, relation.name, 'config.json'));
168
+ }
169
+ }
170
+ const ecwebDir = path.join(home, 'data', 'ecweb');
171
+ files.push(path.join(ecwebDir, 'init-state.json'));
172
+ const creationsDir = path.join(ecwebDir, 'agent-creations');
173
+ if (fs.existsSync(creationsDir)) {
174
+ if (fs.lstatSync(creationsDir).isSymbolicLink())
175
+ throw new Error('Provider migration does not follow creation directory symlinks');
176
+ for (const entry of fs.readdirSync(creationsDir, { withFileTypes: true })) {
177
+ if (entry.name.endsWith('.json'))
178
+ files.push(path.join(creationsDir, entry.name));
179
+ }
180
+ }
181
+ const rewriteSelection = (value) => {
182
+ if (!value || typeof value !== 'object' || Array.isArray(value))
183
+ return 0;
184
+ let count = 0;
185
+ const selection = value;
186
+ if (typeof selection.provider === 'string' && Object.hasOwn(aliases, selection.provider)) {
187
+ selection.provider = aliases[selection.provider];
188
+ count++;
189
+ }
190
+ if (Array.isArray(selection.fallback)) {
191
+ for (const fallback of selection.fallback) {
192
+ if (fallback && typeof fallback === 'object' && !Array.isArray(fallback)) {
193
+ const candidate = fallback;
194
+ if (typeof candidate.provider === 'string' && Object.hasOwn(aliases, candidate.provider)) {
195
+ candidate.provider = aliases[candidate.provider];
196
+ count++;
197
+ }
198
+ }
199
+ }
200
+ }
201
+ return count;
202
+ };
203
+ const rewriteSelections = (value) => {
204
+ if (!value || typeof value !== 'object')
205
+ return 0;
206
+ let count = rewriteSelection(value);
207
+ for (const entry of Object.values(value)) {
208
+ count += rewriteSelections(entry);
209
+ }
210
+ return count;
211
+ };
212
+ for (const file of files) {
213
+ for (let parent = path.dirname(file); parent !== home; parent = path.dirname(parent)) {
214
+ if (fs.existsSync(parent) && fs.lstatSync(parent).isSymbolicLink())
215
+ throw new Error('Provider migration does not follow configuration symlinks');
216
+ }
217
+ try {
218
+ if (fs.lstatSync(file).isSymbolicLink())
219
+ throw new Error('Provider migration does not follow configuration symlinks');
220
+ }
221
+ catch (error) {
222
+ if (error.code !== 'ENOENT')
223
+ throw error;
224
+ expected.push({ file, before: null });
225
+ continue;
226
+ }
227
+ const parsed = readJson(file);
228
+ let count = 0;
229
+ count += rewriteSelections(parsed.value.baseagents);
230
+ count += rewriteSelections(parsed.value.agents);
231
+ count += rewriteSelections(parsed.value.Services);
232
+ count += rewriteSelections(parsed.value.decision_model);
233
+ if (path.basename(file) === 'initialization.json') {
234
+ const record = parsed.value;
235
+ if (!record.plan || typeof record.plan !== 'object' || Array.isArray(record.plan))
236
+ throw new Error('Invalid initialization plan during Provider migration');
237
+ const runtime = initializationRuntimePlan(record);
238
+ if (typeof runtime.provider === 'string' && Object.hasOwn(aliases, runtime.provider)) {
239
+ record.providerMigration = { from: record.plan.provider, to: aliases[runtime.provider] };
240
+ count++;
241
+ }
242
+ if (record.providerMigration && !Object.hasOwn(providers, record.providerMigration.to))
243
+ throw new Error('Initialization Provider migration target is missing');
244
+ }
245
+ else if (file.startsWith(ecwebDir + path.sep)) {
246
+ const creation = parsed.value.creation;
247
+ if (creation?.plan) {
248
+ const runtime = initializationRuntimePlan(creation);
249
+ if (runtime.provider && Object.hasOwn(aliases, runtime.provider)) {
250
+ creation.providerMigration = { from: creation.plan.provider, to: aliases[runtime.provider] };
251
+ count++;
252
+ }
253
+ if (creation.providerMigration && !Object.hasOwn(providers, creation.providerMigration.to))
254
+ throw new Error('Creation Provider migration target is missing');
255
+ }
256
+ const ids = parsed.value.providerIds;
257
+ if (ids && typeof ids === 'object' && !Array.isArray(ids)) {
258
+ for (const [key, value] of Object.entries(ids)) {
259
+ if (typeof value === 'string' && Object.hasOwn(aliases, value)) {
260
+ ids[key] = aliases[value];
261
+ count++;
262
+ }
263
+ }
264
+ }
265
+ }
266
+ else {
267
+ count += rewriteSelection(parsed.value.plan);
268
+ const creation = parsed.value.creation;
269
+ count += rewriteSelection(creation?.plan);
270
+ }
271
+ if (!count)
272
+ continue;
273
+ summary.referencesUpdated += count;
274
+ queue(file, parsed.text, parsed.value);
275
+ }
276
+ return finish();
277
+ }
@@ -0,0 +1,37 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { isIP } from 'node:net';
3
+ import { domainToASCII } from 'node:url';
4
+ import { registrableProviderDomain } from '../utils/public-suffix.js';
5
+ export function normalizeProviderDomain(value) {
6
+ if (typeof value !== 'string' || !value.trim() || /[\s/\\:@?#%]/u.test(value.trim())) {
7
+ throw Object.assign(new Error('Provider domain must be a hostname without a scheme, port or path'), { code: 'PROVIDER_DOMAIN_INVALID' });
8
+ }
9
+ const domain = domainToASCII(value.trim().replace(/\.$/u, '')).toLowerCase();
10
+ const labels = domain.split('.');
11
+ if (domain.length > 253 || labels.length < 2 || isIP(domain)
12
+ || labels.some(label => label.length > 63 || !/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u.test(label))) {
13
+ throw Object.assign(new Error('Provider domain must be a valid DNS hostname'), { code: 'PROVIDER_DOMAIN_INVALID' });
14
+ }
15
+ const registrable = registrableProviderDomain(domain);
16
+ if (!registrable)
17
+ throw Object.assign(new Error('Provider domain must include a name before the public suffix'), { code: 'PROVIDER_DOMAIN_INVALID' });
18
+ return domain === registrable ? `www.${domain}` : domain;
19
+ }
20
+ export function providerIdFromDomain(domain) {
21
+ const canonical = normalizeProviderDomain(domain);
22
+ const digest = createHash('sha256').update(canonical, 'utf8').digest('hex');
23
+ return `provider-${(BigInt(`0x${digest}`) % 100000000n).toString().padStart(8, '0')}`;
24
+ }
25
+ export function providerIdentity(provider) {
26
+ const baseUrl = provider.common.baseUrl;
27
+ const environmentReference = /^\$(?:[A-Za-z_][A-Za-z0-9_]*|\{[A-Za-z_][A-Za-z0-9_]*\})$/u.test(baseUrl);
28
+ if (environmentReference && provider.domain === undefined) {
29
+ throw Object.assign(new Error('Provider domain is required when common.baseUrl is an environment reference'), { code: 'PROVIDER_DOMAIN_REQUIRED' });
30
+ }
31
+ const endpointDomain = environmentReference ? undefined : normalizeProviderDomain(new URL(baseUrl).hostname);
32
+ const domain = provider.domain === undefined ? endpointDomain : normalizeProviderDomain(provider.domain);
33
+ if (endpointDomain !== undefined && domain !== endpointDomain) {
34
+ throw Object.assign(new Error('Provider domain must match the normalized common.baseUrl hostname'), { code: 'PROVIDER_DOMAIN_MISMATCH' });
35
+ }
36
+ return { domain, providerId: providerIdFromDomain(domain) };
37
+ }
@@ -3,6 +3,7 @@ import path from 'node:path';
3
3
  import { TextDecoder } from 'node:util';
4
4
  import { auditCommandAuthorization } from '../core/auth/authorization-audit.js';
5
5
  import { createProvider, parseProviderImport, readProvidersSnapshot, updateProvider } from './providers-management.js';
6
+ import { resolveProviderId } from './providers-config.js';
6
7
  export const PROVIDER_INPUT_LIMIT = 1024 * 1024;
7
8
  export function providerArgumentError(message) {
8
9
  throw Object.assign(new Error(message), { code: 'INVALID_ARGUMENT' });
@@ -18,7 +19,7 @@ export function parseProviderCommand(argv) {
18
19
  providerArgumentError('provider.op requires Provider argv');
19
20
  }
20
21
  const operation = argv[1];
21
- if (!['list', 'show', 'create', 'import', 'update', 'delete'].includes(operation)) {
22
+ if (!['list', 'show', 'create', 'import', 'update', 'delete', 'sync'].includes(operation)) {
22
23
  providerArgumentError('Unsupported Provider command');
23
24
  }
24
25
  const options = new Map();
@@ -70,6 +71,37 @@ export function providerFailure(error) {
70
71
  const failure = error;
71
72
  if (failure?.code === 'NOT_FOUND')
72
73
  return { ok: false, code: 'NOT_FOUND', error: 'Provider not found' };
74
+ if (failure?.code === 'PROVIDER_CONFLICT' && failure.data && typeof failure.data === 'object') {
75
+ const details = failure.data;
76
+ if (details.kind === 'provider_migration_conflict'
77
+ && Array.isArray(details.providerIds) && details.providerIds.length >= 2 && details.providerIds.length <= 100
78
+ && details.providerIds.every(value => typeof value === 'string' && /^[A-Za-z0-9_-]{1,128}$/u.test(value))
79
+ && typeof details.domain === 'string' && details.domain.length <= 253
80
+ && /^[a-z0-9-]+(?:\.[a-z0-9-]+)+$/u.test(details.domain)
81
+ && Array.isArray(details.fields) && details.fields.length > 0 && details.fields.length <= 100
82
+ && details.fields.every(value => typeof value === 'string' && value.length <= 160
83
+ && /^(?:common\.(?:baseUrl|apiKey|headers|queryParams)|services\.[A-Za-z0-9_-]+\.(?:path|style|models))$/u.test(value))) {
84
+ const data = { kind: details.kind, providerIds: details.providerIds, domain: details.domain, fields: details.fields };
85
+ return { ok: false, code: 'PROVIDER_CONFLICT', data,
86
+ error: `Provider migration conflict between ${data.providerIds.join(', ')} (${data.domain}): ${data.fields.join(', ')} differ; reconcile these fields and retry ec provider sync. Credential fields compare configured values/references, not resolved secrets. No configuration was changed` };
87
+ }
88
+ }
89
+ const identityErrors = {
90
+ PROVIDER_ID_COLLISION: 'Provider ID hash collision or reserved legacy ID; no ID was reassigned',
91
+ PROVIDER_CONFLICT: 'Provider domain already exists; update or explicitly merge the existing Provider',
92
+ PROVIDER_DOMAIN_REQUIRED: 'Provider domain is required when common.baseUrl is an environment reference',
93
+ PROVIDER_DOMAIN_INVALID: 'Provider domain must be a valid DNS hostname without a scheme, port or path',
94
+ PROVIDER_DOMAIN_MISMATCH: 'Provider domain must match the normalized common.baseUrl hostname',
95
+ PROVIDER_DOMAIN_IMMUTABLE: 'Provider domain is immutable; create a different Provider',
96
+ PROVIDER_ENV_BASE_URL_MISSING: 'A Provider base URL environment variable is unset or empty in the daemon; no configuration was changed',
97
+ PROVIDER_ENV_BASE_URL_INVALID: 'A Provider base URL environment variable is not a valid HTTP(S) URL; no configuration was changed',
98
+ PROVIDER_CATALOG_UNAVAILABLE: 'Cannot load a fresh preferred Provider model catalog; no configuration was changed',
99
+ PROVIDER_SERVICE_UNAVAILABLE: 'The preferred Provider has no usable ecagent/text connection; no configuration was changed',
100
+ PROVIDER_MODEL_NOT_FOUND: 'The preferred Provider has no enabled DeepSeek Flash model; no configuration was changed',
101
+ };
102
+ if (failure?.code && Object.hasOwn(identityErrors, failure.code)) {
103
+ return { ok: false, code: failure.code, error: identityErrors[failure.code] };
104
+ }
73
105
  if (failure?.code === 'CONFLICT' || failure?.statusCode === 409) {
74
106
  return { ok: false, code: 'CONFLICT', error: 'Provider configuration changed or is still referenced', data: failure.data };
75
107
  }
@@ -119,15 +151,20 @@ export async function executeProviderOperation(command) {
119
151
  /** Shared business execution; callers must authorize before reading input files. */
120
152
  export async function executeParsedProviderOperation(parsed) {
121
153
  try {
154
+ if (parsed.operation === 'sync') {
155
+ const { syncLocalProviders } = await import('./provider-local-sync.js');
156
+ return { ok: true, data: await syncLocalProviders() };
157
+ }
122
158
  const text = parsed.file ? readProviderInput(parsed.file) : undefined;
123
159
  const snapshot = readProvidersSnapshot();
124
160
  if (parsed.operation === 'list')
125
161
  return { ok: true, data: snapshot };
126
162
  if (parsed.operation === 'show') {
127
- const provider = snapshot.providers[parsed.providerId];
163
+ const providerId = resolveProviderId(parsed.providerId, snapshot);
164
+ const provider = snapshot.providers[providerId];
128
165
  if (!provider)
129
166
  throw Object.assign(new Error('Provider not found'), { code: 'NOT_FOUND' });
130
- return { ok: true, data: { providerId: parsed.providerId, provider, revision: snapshot.revision } };
167
+ return { ok: true, data: { providerId, provider, revision: snapshot.revision } };
131
168
  }
132
169
  const value = parsed.operation === 'import' ? parseProviderImport(text)
133
170
  : text === undefined ? undefined : parseProviderObject(text);
@@ -0,0 +1,155 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { resolvePaths } from '../paths.js';
4
+ import { previewProviderCatalog } from '../core/model/model-catalog.js';
5
+ import { ConfigTarget, notifyConfigWrite, validateConfig } from './config-manager.js';
6
+ import { loadSchema } from './schema-registry.js';
7
+ import { providerEnvironmentVariable, resolveProviderId, resolveProviderServiceForBaseagent, validateProvidersFile } from './providers-config.js';
8
+ import { providerIdentity } from './provider-identity.js';
9
+ import { listBaseagentImportSources, providerFromBaseagent } from './providers-import.js';
10
+ import { importBaseagentProviderIntoRegistry } from './providers-management.js';
11
+ import { planProviderIdentityMigration } from './provider-identity-migration.js';
12
+ import { commitProviderSyncMigration } from './schema-migration.js';
13
+ const PREFERRED_PROVIDER = 'provider-96659517';
14
+ export function selectDeepseekFlashModel(models) {
15
+ return models.filter(model => /^deepseek(?:[-._].*)?[-._]flash$/iu.test(model.id) && model.verification === 'listed')
16
+ .sort((left, right) => right.id.localeCompare(left.id, 'en', { numeric: true })
17
+ || (right.created ?? 0) - (left.created ?? 0))[0];
18
+ }
19
+ export async function syncLocalProviders() {
20
+ const home = resolvePaths().root;
21
+ const providerFile = resolvePaths().providersConfig;
22
+ if (fs.existsSync(providerFile) && fs.lstatSync(providerFile).isSymbolicLink()) {
23
+ throw Object.assign(new Error('Provider sync does not follow configuration symlinks'), { code: 'INVALID_ARGUMENT' });
24
+ }
25
+ const providersBefore = fs.existsSync(providerFile) ? fs.readFileSync(providerFile, 'utf8') : null;
26
+ const registry = validateProvidersFile(providersBefore === null ? { providers: {} }
27
+ : JSON.parse(providersBefore.replace(/^\uFEFF/u, '')));
28
+ const environment = { ...process.env };
29
+ let materializedBaseUrls = 0;
30
+ const materializeBaseUrl = (provider) => {
31
+ const variable = providerEnvironmentVariable(provider.common.baseUrl);
32
+ if (!variable)
33
+ return provider;
34
+ const baseUrl = environment[variable]?.trim();
35
+ if (!baseUrl) {
36
+ throw Object.assign(new Error(`Provider base URL environment variable ${variable} is unset or empty; no configuration was changed`), { code: 'PROVIDER_ENV_BASE_URL_MISSING' });
37
+ }
38
+ let resolved;
39
+ try {
40
+ if (providerEnvironmentVariable(baseUrl))
41
+ throw new Error('Nested environment reference');
42
+ resolved = validateProvidersFile({ providers: { resolved: {
43
+ ...provider, common: { ...provider.common, baseUrl },
44
+ } } }).providers.resolved;
45
+ }
46
+ catch (error) {
47
+ if (error?.code === 'PROVIDER_DOMAIN_MISMATCH')
48
+ throw error;
49
+ throw Object.assign(new Error(`Provider base URL environment variable ${variable} is not a valid HTTP(S) URL; no configuration was changed`), { code: 'PROVIDER_ENV_BASE_URL_INVALID' });
50
+ }
51
+ resolved.domain = providerIdentity(resolved).domain;
52
+ materializedBaseUrls++;
53
+ return resolved;
54
+ };
55
+ for (const [providerId, provider] of Object.entries(registry.providers)) {
56
+ registry.providers[providerId] = materializeBaseUrl(provider);
57
+ }
58
+ planProviderIdentityMigration(home, registry);
59
+ const imports = listBaseagentImportSources().map(source => {
60
+ const result = importBaseagentProviderIntoRegistry(registry, { value: materializeBaseUrl(providerFromBaseagent(source.baseagent)) });
61
+ return { baseagent: source.baseagent, providerId: result.providerId, merged: result.merged };
62
+ });
63
+ const plan = planProviderIdentityMigration(home, registry);
64
+ if (plan.expected.find(item => item.file === providerFile)?.before !== providersBefore) {
65
+ throw Object.assign(new Error('Providers changed during scanning; retry after reviewing the current configuration'), { code: 'CONFLICT' });
66
+ }
67
+ const defaultsFile = path.join(home, 'agents', 'defaults.json');
68
+ const defaultsChange = plan.changes.find(change => change.file === defaultsFile);
69
+ if (fs.existsSync(defaultsFile) && fs.lstatSync(defaultsFile).isSymbolicLink()) {
70
+ throw Object.assign(new Error('Provider sync does not follow configuration symlinks'), { code: 'INVALID_ARGUMENT' });
71
+ }
72
+ const before = defaultsChange?.before ?? (fs.existsSync(defaultsFile) ? fs.readFileSync(defaultsFile, 'utf8') : null);
73
+ if (!plan.expected.some(item => item.file === defaultsFile))
74
+ plan.expected.push({ file: defaultsFile, before });
75
+ const defaults = defaultsChange ? JSON.parse(defaultsChange.after)
76
+ : before === null ? {} : JSON.parse(before.replace(/^\uFEFF/u, ''));
77
+ if (!defaults || typeof defaults !== 'object' || Array.isArray(defaults)) {
78
+ throw Object.assign(new Error('Defaults must be an object'), { code: 'INVALID_ARGUMENT' });
79
+ }
80
+ const warnings = [];
81
+ let selectedModel;
82
+ if (Object.hasOwn(plan.registry.providers, PREFERRED_PROVIDER)) {
83
+ let connection;
84
+ try {
85
+ connection = resolveProviderServiceForBaseagent(PREFERRED_PROVIDER, 'ecagent', undefined, plan.registry);
86
+ }
87
+ catch {
88
+ throw Object.assign(new Error('The preferred Provider has no usable ecagent/text connection; no configuration was changed'), { code: 'PROVIDER_SERVICE_UNAVAILABLE' });
89
+ }
90
+ const catalog = await previewProviderCatalog(connection, 'ecagent').catch(() => {
91
+ throw Object.assign(new Error('Cannot fetch the preferred Provider model catalog; no configuration was changed'), { code: 'PROVIDER_CATALOG_UNAVAILABLE' });
92
+ });
93
+ if (catalog.source !== 'gateway' || catalog.freshness !== 'fresh') {
94
+ throw Object.assign(new Error('A fresh Provider model catalog is required; no configuration was changed'), { code: 'PROVIDER_CATALOG_UNAVAILABLE' });
95
+ }
96
+ const model = selectDeepseekFlashModel(catalog.models.filter(entry => connection.modelOverrides[entry.aliasFor ?? entry.id]?.enabled !== false));
97
+ if (!model) {
98
+ throw Object.assign(new Error('The preferred Provider has no enabled DeepSeek Flash model; no configuration was changed'), { code: 'PROVIDER_MODEL_NOT_FOUND' });
99
+ }
100
+ defaults.baseagents ??= {};
101
+ defaults.baseagents.ecagent ??= {};
102
+ const selection = defaults.baseagents.ecagent;
103
+ selection.provider = PREFERRED_PROVIDER;
104
+ selection.model = model.id;
105
+ if (selection.effort && !model.reasoningLevels?.includes(selection.effort))
106
+ delete selection.effort;
107
+ selectedModel = model.id;
108
+ }
109
+ else {
110
+ warnings.push('PREFERRED_PROVIDER_NOT_FOUND');
111
+ }
112
+ if (!imports.length)
113
+ warnings.push('NO_LOCAL_PROVIDER_SOURCES');
114
+ if (plan.pending.length)
115
+ warnings.push('LEGACY_PROVIDER_DOMAIN_REQUIRED');
116
+ defaults.$schema_version ??= loadSchema('defaults').version;
117
+ defaults.active_baseagent = 'ecagent';
118
+ const errors = validateConfig(ConfigTarget.Defaults, defaults);
119
+ if (errors.length)
120
+ throw Object.assign(new Error('Defaults validation failed; no configuration was changed'), { code: 'INVALID_ARGUMENT' });
121
+ const after = JSON.stringify(defaults, null, 2) + '\n';
122
+ if (after !== before) {
123
+ if (defaultsChange)
124
+ defaultsChange.after = after;
125
+ else
126
+ plan.changes.push({ file: defaultsFile, kind: 'provider-domain-id', before, after });
127
+ }
128
+ plan.summary.filesChanged = plan.changes.length;
129
+ const backup = commitProviderSyncMigration(plan);
130
+ if (plan.changes.length && !backup)
131
+ warnings.push('CONFIG_SNAPSHOTS_DISABLED');
132
+ for (const change of plan.changes) {
133
+ const parts = path.relative(home, change.file).split(path.sep);
134
+ if (parts[0] === 'providers.json')
135
+ notifyConfigWrite(ConfigTarget.Providers);
136
+ else if (parts[1] === 'defaults.json')
137
+ notifyConfigWrite(ConfigTarget.Defaults);
138
+ else if (parts[2] === 'config.json')
139
+ notifyConfigWrite(ConfigTarget.Agent, { self: parts[1] });
140
+ else if (parts[2] === 'relations')
141
+ notifyConfigWrite(ConfigTarget.Relation, { self: parts[1], peerKey: parts[3] });
142
+ }
143
+ return {
144
+ materializedBaseUrls,
145
+ imports: imports.map(item => ({ ...item, providerId: resolveProviderId(item.providerId, plan.registry) })),
146
+ aliases: plan.registry.aliases ?? {},
147
+ pending: plan.pending,
148
+ changedFiles: plan.changes.length,
149
+ referencesUpdated: plan.summary.referencesUpdated,
150
+ backup,
151
+ activeBaseagent: 'ecagent',
152
+ selection: selectedModel ? { provider: PREFERRED_PROVIDER, model: selectedModel } : null,
153
+ warnings,
154
+ };
155
+ }