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