evolcore 0.0.43-test.6 → 0.0.43-test.7

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 (197) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/bin/ecmsg.js +171 -54
  3. package/dist/agents/baseagent-availability.js +1 -1
  4. package/dist/agents/codex/app-server-client.js +22 -0
  5. package/dist/agents/codex-runner.js +69 -2
  6. package/dist/aun/msg/p2p.js +6 -1
  7. package/dist/channels/aun.js +234 -21
  8. package/dist/cli/agent-create.js +2 -2
  9. package/dist/cli/daemon-commands.js +6 -66
  10. package/dist/cli/daemon-lifecycle-client.js +61 -0
  11. package/dist/cli/ecmsg-gateway.js +35 -2
  12. package/dist/cli/events-command.js +73 -0
  13. package/dist/cli/index.js +31 -14
  14. package/dist/cli/invoke-command.js +182 -0
  15. package/dist/cli/managed-command-guard.js +6 -1
  16. package/dist/cli/restart-monitor.js +45 -47
  17. package/dist/cli/services-command.js +111 -0
  18. package/dist/cli/team-workspace-command.js +134 -0
  19. package/dist/cli/thread-command.js +6 -2
  20. package/dist/cli/watch-msg.js +1 -1
  21. package/dist/config/config-field-policy.js +2 -2
  22. package/dist/config/config-manager.js +0 -7
  23. package/dist/config/invoke-ipc-service.js +118 -0
  24. package/dist/config/schema-migration.js +6 -1
  25. package/dist/config-store.js +2 -1
  26. package/dist/core/agent-reload-coordinator.js +6 -4
  27. package/dist/core/agent-runtime.js +104 -10
  28. package/dist/core/auth/delegation-authorization.js +66 -0
  29. package/dist/core/auth/operation-catalog.js +20 -0
  30. package/dist/core/baseagent-loader.js +60 -130
  31. package/dist/core/channel-loader.js +10 -1
  32. package/dist/core/channel-runtime.js +4 -3
  33. package/dist/core/command/agent-control.js +1 -1
  34. package/dist/core/command/agent-storage-menu.js +1 -1
  35. package/dist/core/command/chatmode-config.js +2 -36
  36. package/dist/core/command/command-handler.js +53 -11
  37. package/dist/core/command/data-root-resolver.js +32 -23
  38. package/dist/core/command/eventcenter-menu.js +338 -0
  39. package/dist/core/command/menu-catalog.js +8 -0
  40. package/dist/core/command/menu-handler.js +198 -84
  41. package/dist/core/command/menu-protocol.js +60 -11
  42. package/dist/core/command/menu-query-batch.js +194 -0
  43. package/dist/core/command/slash-gate.js +1 -1
  44. package/dist/core/command/slash-handler.js +34 -42
  45. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  46. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  47. package/dist/core/command/team-workspace-initializer.js +2 -0
  48. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  49. package/dist/core/command/team-workspace-job-store.js +88 -0
  50. package/dist/core/command/team-workspace-management-service.js +2 -0
  51. package/dist/core/command/team-workspace-management-store.js +96 -0
  52. package/dist/core/command/team-workspace-management.js +265 -0
  53. package/dist/core/command/team-workspace-members-menu.js +88 -0
  54. package/dist/core/command/team-workspace-store.js +612 -0
  55. package/dist/core/command/team-workspace-team.js +193 -0
  56. package/dist/core/daemon-control.js +8 -5
  57. package/dist/core/daemon-lifecycle.js +132 -73
  58. package/dist/core/handoff/runtime.js +3 -3
  59. package/dist/core/invoke/executors/index.js +13 -0
  60. package/dist/core/invoke/executors/media.js +283 -0
  61. package/dist/core/invoke/executors/text.js +198 -0
  62. package/dist/core/invoke/invoke-service.js +157 -0
  63. package/dist/core/invoke/style-router.js +48 -0
  64. package/dist/core/invoke/types.js +19 -0
  65. package/dist/core/ipc-registration.js +46 -7
  66. package/dist/core/memory/consolidation.js +7 -5
  67. package/dist/core/message/aun-ipc-sender.js +147 -17
  68. package/dist/core/message/im-renderer.js +28 -84
  69. package/dist/core/message/message-bridge.js +4 -0
  70. package/dist/core/message/message-utils.js +10 -2
  71. package/dist/core/message/peer-mode.js +7 -34
  72. package/dist/core/message/response-engine.js +157 -54
  73. package/dist/core/message/send-options.js +7 -4
  74. package/dist/core/message/send-routing.js +43 -5
  75. package/dist/core/ownership/owner-resolver.js +7 -0
  76. package/dist/core/permission/ec-command-parser.js +3 -2
  77. package/dist/core/permission/protected-paths.js +12 -2
  78. package/dist/core/permission/shell-environment.js +9 -0
  79. package/dist/core/session/session-file-health.js +243 -0
  80. package/dist/core/session/session-fs-store.js +2 -3
  81. package/dist/core/task/task-recovery-service.js +13 -2
  82. package/dist/core/thread/command-parser.js +9 -2
  83. package/dist/core/thread/thread-operation.js +21 -2
  84. package/dist/core/thread/thread-route.js +13 -2
  85. package/dist/directory/owner-directory-admission.js +40 -53
  86. package/dist/directory/owner-directory-cache.js +89 -113
  87. package/dist/directory/owner-directory-query-operation.js +8 -10
  88. package/dist/eck/kit-renderer.js +7 -5
  89. package/dist/ecweb/basic-settings-service.js +1 -1
  90. package/dist/ecweb/message-context-service.js +0 -4
  91. package/dist/ecweb/runtime/lifecycle.js +6 -2
  92. package/dist/ecweb/runtime/supervisor.js +19 -4
  93. package/dist/event-center/admission-materializer.js +114 -0
  94. package/dist/event-center/bus-gate.js +136 -0
  95. package/dist/event-center/bus-host.js +290 -0
  96. package/dist/event-center/bus-resolver.js +120 -0
  97. package/dist/event-center/center-config.js +100 -0
  98. package/dist/event-center/client-factory.js +50 -0
  99. package/dist/event-center/daemon.js +45 -0
  100. package/dist/event-center/directory-source.js +53 -0
  101. package/dist/event-center/dispatcher.js +157 -0
  102. package/dist/event-center/event-log.js +110 -0
  103. package/dist/event-center/index-generator.js +63 -0
  104. package/dist/event-center/ipc-operation.js +308 -0
  105. package/dist/event-center/ledger.js +52 -0
  106. package/dist/event-center/pack-loader.js +202 -0
  107. package/dist/event-center/pack-manager.js +85 -0
  108. package/dist/event-center/registry.js +238 -0
  109. package/dist/event-center/runtime.js +641 -0
  110. package/dist/event-center/script-runner.js +356 -0
  111. package/dist/event-center/types.js +35 -0
  112. package/dist/event-center/validation.js +413 -0
  113. package/dist/index.js +285 -99
  114. package/dist/ipc.js +66 -12
  115. package/dist/paths.js +20 -0
  116. package/dist/product.js +14 -0
  117. package/dist/proxy/manager.js +5 -1
  118. package/dist/proxy/service-supervisor.js +13 -4
  119. package/dist/response-system/engines/v1/index.js +0 -1
  120. package/dist/response-system/modes/single-session/index.js +1 -1
  121. package/dist/services/dispatcher.js +100 -0
  122. package/dist/services/idempotency.js +90 -0
  123. package/dist/services/identity.js +52 -0
  124. package/dist/services/index-generator.js +70 -0
  125. package/dist/services/index.js +449 -0
  126. package/dist/services/ipc-operation.js +458 -0
  127. package/dist/services/ledger.js +52 -0
  128. package/dist/services/message-log.js +112 -0
  129. package/dist/services/pack-manager.js +204 -0
  130. package/dist/services/reply.js +55 -0
  131. package/dist/services/router.js +95 -0
  132. package/dist/services/script-runner.js +422 -0
  133. package/dist/services/service-payload.js +70 -0
  134. package/dist/services/types.js +18 -0
  135. package/dist/services/validation.js +297 -0
  136. package/dist/trigger/application-service.js +18 -0
  137. package/dist/trigger/event-source.js +1 -1
  138. package/dist/trigger/ipc-service.js +3 -1
  139. package/dist/trigger/script-sandbox.js +118 -22
  140. package/dist/utils/cross-platform.js +24 -10
  141. package/dist/utils/evolcore-version.js +69 -27
  142. package/dist/utils/instance-registry.js +19 -13
  143. package/dist/utils/process-introspect.js +45 -9
  144. package/dist/utils/startup-trace.js +74 -37
  145. package/dist/utils/windows-shell-trust.js +80 -6
  146. package/kits/docs/INDEX.md +2 -2
  147. package/kits/docs/aun/ABILITY_CALLING.md +7 -14
  148. package/kits/docs/context-assembly.md +1 -1
  149. package/kits/docs/evolcore/INDEX.md +2 -0
  150. package/kits/docs/evolcore/ability.md +4 -0
  151. package/kits/docs/evolcore/aid.md +1 -1
  152. package/kits/docs/evolcore/event-center.md +207 -0
  153. package/kits/docs/evolcore/file-navigation.md +10 -264
  154. package/kits/docs/evolcore/fs.md +3 -2
  155. package/kits/docs/evolcore/group.md +1 -1
  156. package/kits/docs/evolcore/memory-architecture.md +2 -0
  157. package/kits/docs/evolcore/menu-protocol.md +21 -0
  158. package/kits/docs/evolcore/msg.md +15 -3
  159. package/kits/docs/evolcore/provider.md +3 -1
  160. package/kits/docs/evolcore/response.md +5 -5
  161. package/kits/docs/evolcore/services.md +277 -0
  162. package/kits/docs/evolcore/task.md +2 -0
  163. package/kits/docs/evolcore/team-workspace.md +41 -0
  164. package/kits/eck_manifest.json +26 -0
  165. package/kits/rules/02-navigation.md +10 -1
  166. package/kits/schemas/_meta.json +17 -6
  167. package/kits/schemas/agent-config.schema.19.json +5 -7
  168. package/kits/schemas/agent-config.schema.20.json +936 -0
  169. package/kits/schemas/relation-config.schema.12.json +2 -3
  170. package/kits/schemas/role-config.schema.2.json +4 -4
  171. package/kits/skills/.switches.json +1 -5
  172. package/kits/skills/ability/SKILL.md +56 -0
  173. package/kits/skills/ability/references/calling.md +56 -0
  174. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  175. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  176. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  177. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  178. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  179. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  180. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  181. package/kits/skills/personal-assistant/SKILL.md +6 -6
  182. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  183. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  184. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  185. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  186. package/kits/templates/system-fragments/channel.md +3 -3
  187. package/kits/templates/system-fragments/commands.md +5 -3
  188. package/kits/templates/system-fragments/reply.md +0 -5
  189. package/kits/templates/system-fragments/thread.md +10 -8
  190. package/package.json +3 -5
  191. package/dist/cli/pa-workspace-command.js +0 -225
  192. package/dist/core/command/pa-workspace-store.js +0 -468
  193. package/dist/core/relation/pa-team.js +0 -132
  194. package/kits/docs/evolcore/pa-workspace.md +0 -51
  195. package/kits/skills/aid-ability/SKILL.md +0 -244
  196. package/kits/skills/ec-ability/SKILL.md +0 -67
  197. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -0,0 +1,265 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { isValidAid } from '../../aun/aid/validation.js';
4
+ import { ownerResolver } from '../ownership/owner-resolver.js';
5
+ import { DataRootError } from './team-workspace-store.js';
6
+ import { teamWorkspaceStore } from './team-workspace-store.js';
7
+ import { TeamWorkspaceBootstrapError, TeamWorkspaceBootstrapService, resolveTeamWorkspaceIdentity } from './team-workspace-bootstrap.js';
8
+ import { teamWorkspaceJobStore, TeamWorkspaceJobError } from './team-workspace-job-store.js';
9
+ import { teamWorkspaceManagementStore } from './team-workspace-management-store.js';
10
+ export const TEAM_WORKSPACE_MANAGEMENT_PROTOCOL = 'evol.team-workspace-management';
11
+ export const TEAM_WORKSPACE_MANAGEMENT_VERSION = 1;
12
+ function managementError(code, message, data) {
13
+ throw new DataRootError(code, message, data);
14
+ }
15
+ function safeStatus(state) {
16
+ return state?.status ?? 'unconfigured';
17
+ }
18
+ export class TeamWorkspaceManagementService {
19
+ bootstrap;
20
+ constructor(bootstrap = new TeamWorkspaceBootstrapService()) {
21
+ this.bootstrap = bootstrap;
22
+ }
23
+ async ensureReady(subject) {
24
+ const identity = this.authorizeSubject(subject);
25
+ this.migrateLegacyDefault(identity);
26
+ const existingBinding = teamWorkspaceStore.read(identity.agentAid);
27
+ if (existingBinding && existingBinding.ownerAid !== identity.ownerAid) {
28
+ managementError('OWNER_UNAVAILABLE', 'Team workspace binding belongs to another Owner');
29
+ }
30
+ let state = teamWorkspaceManagementStore.read(identity.agentAid);
31
+ if (state && state.ownerAid !== identity.ownerAid)
32
+ managementError('OWNER_UNAVAILABLE', 'Team workspace management state belongs to another Owner');
33
+ if (!state) {
34
+ void this.bootstrap.start(identity);
35
+ state = teamWorkspaceManagementStore.read(identity.agentAid);
36
+ if (state?.status === 'ready' && teamWorkspaceStore.read(identity.agentAid))
37
+ return;
38
+ throw new DataRootError('WORKSPACE_INITIALIZING', 'Team workspace is initializing', { retryAfterMs: 1000 });
39
+ }
40
+ if (state.status === 'initializing')
41
+ throw new DataRootError('WORKSPACE_INITIALIZING', 'Team workspace is initializing', { retryAfterMs: 1000, ...(state.activeJobId ? { jobId: state.activeJobId } : {}) });
42
+ if (state.status === 'failed') {
43
+ throw new DataRootError(state.lastError?.code ?? 'INITIALIZE_FAILED', state.lastError?.message ?? 'Team workspace initialization failed', { retryable: state.lastError?.retryable !== false });
44
+ }
45
+ if (state.status === 'unavailable' || !teamWorkspaceStore.read(identity.agentAid)) {
46
+ throw new DataRootError('WORKSPACE_UNAVAILABLE', 'Team workspace is unavailable');
47
+ }
48
+ if (state.status !== 'ready') {
49
+ void this.bootstrap.start(identity);
50
+ throw new DataRootError('WORKSPACE_INITIALIZING', 'Team workspace is initializing', { retryAfterMs: 1000 });
51
+ }
52
+ }
53
+ async workspaceInfo(subject) {
54
+ const identity = this.authorizeSubject(subject);
55
+ this.migrateLegacyDefault(identity);
56
+ const existingBinding = teamWorkspaceStore.read(identity.agentAid);
57
+ if (existingBinding && existingBinding.ownerAid !== identity.ownerAid)
58
+ managementError('OWNER_UNAVAILABLE', 'Team workspace binding belongs to another Owner');
59
+ let state = teamWorkspaceManagementStore.read(identity.agentAid);
60
+ if (state && state.ownerAid !== identity.ownerAid)
61
+ managementError('OWNER_UNAVAILABLE', 'Team workspace management state belongs to another Owner');
62
+ if (!state) {
63
+ state = teamWorkspaceManagementStore.ensure(identity.agentAid, identity.ownerAid);
64
+ void this.bootstrap.start(identity);
65
+ state = teamWorkspaceManagementStore.read(identity.agentAid) ?? state;
66
+ }
67
+ else if (state.status === 'unconfigured') {
68
+ void this.bootstrap.start(identity);
69
+ state = teamWorkspaceManagementStore.read(identity.agentAid) ?? state;
70
+ }
71
+ const binding = teamWorkspaceStore.read(identity.agentAid);
72
+ const root = binding ? this.safeRoot(binding.rootPath) : undefined;
73
+ const marker = root ? this.readMarker(root) : undefined;
74
+ const status = !root || !binding
75
+ ? state.status === 'ready' ? 'unavailable' : safeStatus(state)
76
+ : safeStatus(state);
77
+ const activeJob = state.activeJobId ? this.safeJob(identity, state.activeJobId) : undefined;
78
+ const stats = root && binding && status === 'ready' ? scanWorkspaceStatistics(root) : { status: 'unavailable' };
79
+ const capabilities = {
80
+ canOpen: false,
81
+ canSelectLocation: false,
82
+ canBind: false,
83
+ canMigrate: false,
84
+ canExport: false,
85
+ canCheckIntegrity: false,
86
+ canRebuildIndex: false,
87
+ canRetryInitialization: status === 'failed' && state.lastError?.retryable !== false,
88
+ };
89
+ return {
90
+ protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL,
91
+ managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION,
92
+ view: 'workspace-info',
93
+ workspace: {
94
+ status,
95
+ ...(binding ? { workspaceId: binding.workspaceId } : {}),
96
+ location: { kind: 'default', display: `$EVOLCORE_HOME/agents/${identity.agentAid}/workspace` },
97
+ ...(marker?.createdAt ? { createdAt: marker.createdAt } : state.createdAt ? { createdAt: state.createdAt } : {}),
98
+ ...(state.boundAt ? { boundAt: state.boundAt } : {}),
99
+ ...(root ? { lastModified: this.lastModified(root) } : {}),
100
+ statistics: stats,
101
+ capabilities,
102
+ ...(activeJob ? { activeJob } : { activeJob: null }),
103
+ ...(state.lastError && status === 'failed' ? { error: state.lastError, retryable: state.lastError.retryable } : {}),
104
+ ...(status === 'initializing' ? { retryAfterMs: 1000 } : {}),
105
+ },
106
+ };
107
+ }
108
+ async job(subject, jobId) {
109
+ const identity = this.authorizeSubject(subject);
110
+ if (typeof jobId !== 'string' || !jobId.trim())
111
+ managementError('INVALID_ARGUMENT', 'args.jobId is required');
112
+ try {
113
+ const job = teamWorkspaceJobStore.get(identity.agentAid, jobId, identity.ownerAid);
114
+ return { protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL, managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION, view: 'job', job: this.publicJob(job) };
115
+ }
116
+ catch (error) {
117
+ if (error instanceof TeamWorkspaceJobError)
118
+ managementError(error.code, error.message);
119
+ throw error;
120
+ }
121
+ }
122
+ async retryInitialization(subject, args) {
123
+ const identity = this.authorizeSubject(subject);
124
+ const existingBinding = teamWorkspaceStore.read(identity.agentAid);
125
+ if (existingBinding && existingBinding.ownerAid !== identity.ownerAid)
126
+ managementError('OWNER_UNAVAILABLE', 'Team workspace binding belongs to another Owner');
127
+ if (args?.managementVersion !== 1)
128
+ managementError('SCHEMA_VERSION_UNSUPPORTED', 'retry-initialization requires managementVersion=1');
129
+ const operationId = typeof args?.operationId === 'string' ? args.operationId.trim() : '';
130
+ if (!operationId || operationId.length > 200)
131
+ managementError('INVALID_ARGUMENT', 'args.operationId is required');
132
+ const state = teamWorkspaceManagementStore.read(identity.agentAid);
133
+ if (state && state.ownerAid !== identity.ownerAid)
134
+ managementError('OWNER_UNAVAILABLE', 'Team workspace management state belongs to another Owner');
135
+ if (state?.status === 'initializing' && state.activeJobId) {
136
+ return { protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL, managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION, action: 'retry-initialization', accepted: true, jobId: state.activeJobId };
137
+ }
138
+ if (state?.status === 'ready' && teamWorkspaceStore.read(identity.agentAid)) {
139
+ return { protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL, managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION, action: 'retry-initialization', accepted: true, alreadyReady: true };
140
+ }
141
+ const result = this.bootstrap.start(identity, operationId);
142
+ const after = teamWorkspaceManagementStore.read(identity.agentAid);
143
+ const jobId = after?.activeJobId;
144
+ if (!jobId) {
145
+ await result;
146
+ return { protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL, managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION, action: 'retry-initialization', accepted: true, alreadyReady: true };
147
+ }
148
+ return { protocol: TEAM_WORKSPACE_MANAGEMENT_PROTOCOL, managementVersion: TEAM_WORKSPACE_MANAGEMENT_VERSION, action: 'retry-initialization', accepted: true, jobId };
149
+ }
150
+ authorizeSubject(subject) {
151
+ const agentAid = String(subject.selfAid ?? '').trim();
152
+ const principalId = String(subject.principalId ?? '').trim();
153
+ if (!isValidAid(agentAid) || subject.channelType !== 'aun' || subject.chatType !== 'private') {
154
+ managementError('TEAM_IDENTITY_UNAVAILABLE', 'Team workspace management requires a verified private AUN Agent context');
155
+ }
156
+ if (!isValidAid(principalId) || subject.role !== 'owner' || !ownerResolver.isOwner(agentAid, principalId)) {
157
+ managementError('FORBIDDEN', 'Team workspace management requires the current Agent Owner');
158
+ }
159
+ const identity = resolveTeamWorkspaceIdentity(agentAid);
160
+ if (!identity || identity.ownerAid !== principalId)
161
+ managementError('TEAM_IDENTITY_UNAVAILABLE', 'A current Team Workspace Agent Owner could not be verified');
162
+ return identity;
163
+ }
164
+ migrateLegacyDefault(identity) {
165
+ try {
166
+ teamWorkspaceStore.importPersonalAssistantRegistration(identity.agentAid, identity.ownerAid);
167
+ this.bootstrap.migrateLegacyDefault(identity);
168
+ this.bootstrap.migrateOutput(identity);
169
+ }
170
+ catch (error) {
171
+ if (error instanceof TeamWorkspaceBootstrapError)
172
+ managementError(error.code, error.message);
173
+ throw error;
174
+ }
175
+ }
176
+ safeRoot(value) {
177
+ try {
178
+ return fs.realpathSync(value);
179
+ }
180
+ catch {
181
+ return undefined;
182
+ }
183
+ }
184
+ readMarker(root) {
185
+ try {
186
+ const value = JSON.parse(fs.readFileSync(path.join(root, '.workspace', 'marker.json'), 'utf8'));
187
+ return Number.isFinite(value.createdAt) ? { createdAt: Number(value.createdAt) } : undefined;
188
+ }
189
+ catch {
190
+ return undefined;
191
+ }
192
+ }
193
+ lastModified(root) {
194
+ try {
195
+ return Math.floor(fs.statSync(root).mtimeMs);
196
+ }
197
+ catch {
198
+ return undefined;
199
+ }
200
+ }
201
+ safeJob(identity, jobId) {
202
+ try {
203
+ return this.publicJob(teamWorkspaceJobStore.get(identity.agentAid, jobId, identity.ownerAid));
204
+ }
205
+ catch {
206
+ return undefined;
207
+ }
208
+ }
209
+ publicJob(job) {
210
+ return {
211
+ jobId: job.jobId, type: job.type, status: job.status, progress: job.progress,
212
+ createdAt: job.createdAt, updatedAt: job.updatedAt,
213
+ ...(job.error ? { error: job.error } : {}), ...(job.result ? { result: job.result } : {}),
214
+ };
215
+ }
216
+ }
217
+ export function scanWorkspaceStatistics(root, maxFiles = 20_000) {
218
+ let totalFiles = 0;
219
+ let totalSize = 0;
220
+ let captureFiles = 0;
221
+ let outputFiles = 0;
222
+ let truncated = false;
223
+ const pending = ['.'];
224
+ try {
225
+ while (pending.length > 0) {
226
+ const relative = pending.pop();
227
+ const current = path.join(root, relative);
228
+ for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
229
+ if (entry.name.startsWith('.') || (relative === 'capture' && entry.name === '_manifest'))
230
+ continue;
231
+ const child = relative === '.' ? entry.name : path.join(relative, entry.name);
232
+ if (entry.isSymbolicLink())
233
+ continue;
234
+ if (entry.isDirectory())
235
+ pending.push(child);
236
+ else if (entry.isFile()) {
237
+ totalFiles++;
238
+ if (totalFiles > maxFiles) {
239
+ totalFiles = maxFiles;
240
+ truncated = true;
241
+ pending.length = 0;
242
+ break;
243
+ }
244
+ try {
245
+ totalSize += fs.statSync(path.join(root, child)).size;
246
+ }
247
+ catch {
248
+ truncated = true;
249
+ continue;
250
+ }
251
+ const normalized = child.replaceAll('\\', '/');
252
+ if (normalized.startsWith('capture/'))
253
+ captureFiles++;
254
+ if (normalized.startsWith('output/'))
255
+ outputFiles++;
256
+ }
257
+ }
258
+ }
259
+ return { status: truncated ? 'partial' : 'complete', totalFiles, totalSize, captureFiles, outputFiles, sampledAt: Date.now(), truncated };
260
+ }
261
+ catch {
262
+ return { status: totalFiles > 0 ? 'partial' : 'failed', totalFiles, totalSize, captureFiles, outputFiles, sampledAt: Date.now(), truncated: true };
263
+ }
264
+ }
265
+ export const teamWorkspaceManagementService = new TeamWorkspaceManagementService();
@@ -0,0 +1,88 @@
1
+ import { PeerMutationError } from '../../config/peer-book-store.js';
2
+ import { TeamWorkspaceTeamError, mutateTeamMembers, normalizeTeamMemberAids, readTeamMemberDetails, readTeamMembersState, } from './team-workspace-team.js';
3
+ const MEMBER_ACTIONS = new Map([
4
+ ['add-members', 'add'], ['remove-members', 'remove'], ['replace-members', 'replace'],
5
+ ]);
6
+ export function isTeamMembersMenuRequest(request) {
7
+ const args = request.args;
8
+ return request.type === 'menu.query' && args?.view === 'members'
9
+ || request.type === 'menu.action' && MEMBER_ACTIONS.has(String(request.action));
10
+ }
11
+ /** Shared by transport validation and execution, including direct internal calls. */
12
+ export function validateTeamMembersMenuRequest(request) {
13
+ if (request.args === null || typeof request.args !== 'object' || Array.isArray(request.args)) {
14
+ return { code: 'INVALID_ARGUMENT', message: 'Team members requires an args object' };
15
+ }
16
+ const args = request.args;
17
+ const query = request.type === 'menu.query' && args.view === 'members';
18
+ const action = request.type === 'menu.action' && MEMBER_ACTIONS.has(String(request.action));
19
+ if (!query && !action)
20
+ return { code: 'NOT_SUPPORTED', message: 'Unsupported Team members request' };
21
+ const allowed = query ? ['view', 'managementVersion'] : ['managementVersion', 'members', 'expectedRevision'];
22
+ const unknown = Object.keys(args).find(key => !allowed.includes(key));
23
+ if (unknown)
24
+ return { code: 'INVALID_ARGUMENT', message: `Team members does not accept args.${unknown}` };
25
+ if (args.managementVersion !== 1)
26
+ return { code: 'SCHEMA_VERSION_UNSUPPORTED', message: 'Team members requires managementVersion=1' };
27
+ if (action) {
28
+ if (typeof args.expectedRevision !== 'string' || !/^sha256:[a-f0-9]{64}$/.test(args.expectedRevision)) {
29
+ return { code: 'INVALID_ARGUMENT', message: 'Team members requires args.expectedRevision from the members view' };
30
+ }
31
+ try {
32
+ const members = normalizeTeamMemberAids(args.members);
33
+ if (request.action !== 'replace-members' && members.length === 0) {
34
+ return { code: 'INVALID_ARGUMENT', message: 'Add and remove operations require at least one member' };
35
+ }
36
+ }
37
+ catch (error) {
38
+ if (error instanceof TeamWorkspaceTeamError)
39
+ return { code: error.code, message: error.message };
40
+ throw error;
41
+ }
42
+ }
43
+ return null;
44
+ }
45
+ function failure(error) {
46
+ if (error instanceof PeerMutationError && ['INVALID_CONTACT_BOOK', 'ALIAS_CONFLICT'].includes(error.code)) {
47
+ return { error: 'The current Agent contact book is unavailable', code: 'CONTACT_BOOK_INVALID' };
48
+ }
49
+ if (error instanceof TeamWorkspaceTeamError) {
50
+ return {
51
+ error: error.message,
52
+ code: error.code === 'AGENT_NOT_FOUND' ? 'NOT_FOUND' : error.code,
53
+ ...(error.data ? { data: error.data } : {}),
54
+ };
55
+ }
56
+ return { error: 'Internal Team member operation error', code: 'INTERNAL_ERROR' };
57
+ }
58
+ // These functions run only after menu-handler verifies the current Agent Owner.
59
+ export function executeTeamMembersQuery(selfAid, args) {
60
+ const invalid = validateTeamMembersMenuRequest({ type: 'menu.query', args });
61
+ if (invalid)
62
+ return { error: invalid.message, code: invalid.code };
63
+ try {
64
+ const state = readTeamMembersState(selfAid);
65
+ return { data: {
66
+ protocol: 'evol.team-workspace-management', managementVersion: 1, view: 'members',
67
+ ...state, memberDetails: readTeamMemberDetails(selfAid, state.members),
68
+ } };
69
+ }
70
+ catch (error) {
71
+ return failure(error);
72
+ }
73
+ }
74
+ export function executeTeamMembersAction(selfAid, action, args) {
75
+ const invalid = validateTeamMembersMenuRequest({ type: 'menu.action', action, args });
76
+ if (invalid)
77
+ return { error: invalid.message, code: invalid.code };
78
+ try {
79
+ const mode = MEMBER_ACTIONS.get(action);
80
+ const state = mutateTeamMembers(selfAid, mode, args.members, args.expectedRevision);
81
+ return { data: {
82
+ protocol: 'evol.team-workspace-management', managementVersion: 1, action, ...state,
83
+ } };
84
+ }
85
+ catch (error) {
86
+ return failure(error);
87
+ }
88
+ }