evolcore 0.0.41-test.0 → 0.0.41-test.2

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 (235) hide show
  1. package/CHANGELOG.md +62 -0
  2. package/dist/agents/baseagent-availability.js +1 -1
  3. package/dist/agents/baseagent.js +88 -49
  4. package/dist/agents/claude-runner.js +177 -92
  5. package/dist/agents/codex-runner.js +146 -71
  6. package/dist/agents/ecagent-runner.js +1 -1
  7. package/dist/agents/gemini-runner.js +1 -1
  8. package/dist/aun/aid/agentmd.js +98 -11
  9. package/dist/aun/aid/client.js +1 -1
  10. package/dist/aun/aid/control-aid.js +26 -2
  11. package/dist/aun/aid/identity.js +91 -0
  12. package/dist/aun/aid/index.js +1 -1
  13. package/dist/aun/aid/managed-operation.js +1 -1
  14. package/dist/aun/aid/ownership-operation.js +23 -22
  15. package/dist/aun/group/fs-download.js +39 -0
  16. package/dist/aun/group/identity.js +36 -21
  17. package/dist/aun/group/operations.js +5 -0
  18. package/dist/aun/menu/client.js +27 -0
  19. package/dist/aun/msg/managed-operation.js +68 -7
  20. package/dist/aun/msg/p2p.js +8 -8
  21. package/dist/aun/service-proxy.js +53 -12
  22. package/dist/channels/aun.js +633 -32
  23. package/dist/channels/daemon.js +15 -1
  24. package/dist/cli/agent-command.js +5 -2
  25. package/dist/cli/agent-create.js +991 -233
  26. package/dist/cli/agent.js +49 -10
  27. package/dist/cli/aid-bind-command.js +48 -19
  28. package/dist/cli/aun-commands.js +48 -36
  29. package/dist/cli/daemon-commands.js +679 -697
  30. package/dist/cli/fs-command.js +64 -2
  31. package/dist/cli/index.js +72 -5
  32. package/dist/cli/init-channel.js +1 -1
  33. package/dist/cli/init.js +75 -1
  34. package/dist/cli/managed-command-guard.js +17 -1
  35. package/dist/cli/model.js +40 -40
  36. package/dist/cli/provider-command.js +57 -0
  37. package/dist/cli/proxy-command.js +92 -0
  38. package/dist/cli/restart-monitor.js +4 -2
  39. package/dist/cli/role.js +85 -0
  40. package/dist/cli/stats.js +10 -3
  41. package/dist/cli/task-context.js +19 -0
  42. package/dist/config/access-policy.js +7 -2
  43. package/dist/config/boot-log.js +39 -1
  44. package/dist/config/config-field-policy.js +17 -39
  45. package/dist/config/config-manager.js +183 -44
  46. package/dist/config/config-operation-service.js +5 -19
  47. package/dist/config/contact-book-store.js +47 -21
  48. package/dist/config/contact-book.js +18 -12
  49. package/dist/config/contact-operation-service.js +3 -4
  50. package/dist/config/contact-request-service.js +11 -0
  51. package/dist/config/daemon-services.js +11 -0
  52. package/dist/config/gateway-config.js +88 -594
  53. package/dist/config/owner-config.js +2 -2
  54. package/dist/config/peer-role-resolver.js +15 -12
  55. package/dist/config/provider-ipc-service.js +132 -0
  56. package/dist/config/provider-menu-request.js +58 -0
  57. package/dist/config/providers-config.js +12 -7
  58. package/dist/config/providers-import.js +3 -21
  59. package/dist/config/providers-management.js +78 -5
  60. package/dist/config/resolved-config-op.js +11 -1
  61. package/dist/config/role-command-service.js +166 -0
  62. package/dist/config/role-request-service.js +193 -0
  63. package/dist/config/schema-migration.js +1000 -25
  64. package/dist/config-store.js +89 -4
  65. package/dist/contracts/ecweb-instance.js +41 -0
  66. package/dist/contracts/ecweb-service-protocol.js +4 -1
  67. package/dist/core/agent-application-service.js +60 -11
  68. package/dist/core/agent-create-status.js +203 -0
  69. package/dist/core/agent-creation-claim.js +177 -0
  70. package/dist/core/agent-ipc-registration.js +39 -18
  71. package/dist/core/agent-runtime.js +194 -24
  72. package/dist/core/auth/agent-delegation.js +6 -3
  73. package/dist/core/auth/auth-gateway.js +67 -2
  74. package/dist/core/auth/authorization-audit.js +58 -11
  75. package/dist/core/auth/delegation-authorization.js +5 -2
  76. package/dist/core/auth/operation-authorizer.js +43 -6
  77. package/dist/core/auth/operation-catalog.js +45 -7
  78. package/dist/core/channel-loader.js +2 -0
  79. package/dist/core/command/agent-control.js +260 -21
  80. package/dist/core/command/agent-storage-menu.js +5 -3
  81. package/dist/core/command/cli-intent-parser.js +8 -3
  82. package/dist/core/command/command-handler.js +112 -154
  83. package/dist/core/command/connect-menu.js +11 -3
  84. package/dist/core/command/data-root-resolver.js +5 -4
  85. package/dist/core/command/memory-slash.js +16 -8
  86. package/dist/core/command/menu-catalog.js +10 -6
  87. package/dist/core/command/menu-handler.js +106 -73
  88. package/dist/core/command/menu-protocol.js +15 -1
  89. package/dist/core/command/provider-menu.js +46 -0
  90. package/dist/core/command/role-menu.js +147 -30
  91. package/dist/core/command/slash-handler.js +125 -255
  92. package/dist/core/daemon-control.js +26 -27
  93. package/dist/core/event-catalog.js +10 -0
  94. package/dist/core/evolagent-registry.js +7 -5
  95. package/dist/core/evolagent.js +10 -8
  96. package/dist/core/file-integrity/store.js +11 -0
  97. package/dist/core/handoff/ipc-registration.js +3 -0
  98. package/dist/core/inference/text-inference.js +31 -40
  99. package/dist/core/initialization/service.js +491 -0
  100. package/dist/core/ipc-registration.js +40 -24
  101. package/dist/core/memory/consolidation-context.js +51 -5
  102. package/dist/core/memory/consolidation-ops-records.js +96 -1
  103. package/dist/core/memory/consolidation-trigger.js +208 -191
  104. package/dist/core/memory/consolidation.js +333 -35
  105. package/dist/core/memory/index-manager.js +27 -5
  106. package/dist/core/memory/memory-admin.js +45 -5
  107. package/dist/core/memory/memory-writer.js +163 -18
  108. package/dist/core/memory/relation-idle-monitor.js +119 -58
  109. package/dist/core/memory/relation-sweep.js +55 -45
  110. package/dist/core/message/aun-ipc-sender.js +81 -69
  111. package/dist/core/message/im-renderer.js +25 -4
  112. package/dist/core/message/message-admission.js +89 -4
  113. package/dist/core/message/message-bridge.js +66 -21
  114. package/dist/core/message/response-engine.js +108 -35
  115. package/dist/core/model/catalog-service.js +5 -3
  116. package/dist/core/model/config-scope.js +29 -71
  117. package/dist/core/model/field-scope.js +1 -1
  118. package/dist/core/model/model-catalog.js +30 -41
  119. package/dist/core/model/model-diagnostics.js +4 -3
  120. package/dist/core/model/model-fallback.js +10 -7
  121. package/dist/core/model/model-permission.js +3 -2
  122. package/dist/core/ownership/owner-resolver.js +772 -158
  123. package/dist/core/permission/approval-gateway.js +103 -403
  124. package/dist/core/permission/ec-command-parser.js +62 -6
  125. package/dist/core/permission/index.js +1 -0
  126. package/dist/core/permission/permission-result.js +78 -0
  127. package/dist/core/permission/sandbox-runtime.js +18 -1
  128. package/dist/core/permission/tool-policy.js +21 -46
  129. package/dist/core/relation/peer-identity.js +64 -1
  130. package/dist/core/role/runtime-policy.js +72 -13
  131. package/dist/core/session/session-capsule.js +1 -1
  132. package/dist/core/session/session-idle-monitor.js +1 -1
  133. package/dist/core/session/session-manager.js +20 -0
  134. package/dist/core/session/session-renew.js +3 -3
  135. package/dist/core/skill/index-generator.js +15 -5
  136. package/dist/core/system-session/memory.js +43 -8
  137. package/dist/core/thread/thread-service.js +19 -6
  138. package/dist/directory/owner-directory-admission.js +95 -0
  139. package/dist/directory/owner-directory-authorization.js +309 -0
  140. package/dist/directory/owner-directory-cache.js +635 -0
  141. package/dist/eck/kit-renderer.js +2 -2
  142. package/dist/ecweb/basic-settings-service.js +33 -40
  143. package/dist/ecweb/init-menu.js +32 -0
  144. package/dist/ecweb/message-context-service.js +110 -0
  145. package/dist/index.js +93 -19
  146. package/dist/ipc.js +247 -29
  147. package/dist/paths.js +7 -0
  148. package/dist/proxy/command.js +122 -0
  149. package/dist/proxy/ipc-service.js +68 -0
  150. package/dist/proxy/manager.js +484 -0
  151. package/dist/proxy/service-supervisor.js +603 -0
  152. package/dist/response-system/engines/v1/proactive-flow.js +16 -6
  153. package/dist/trigger/authorization.js +27 -17
  154. package/dist/trigger/feedback.js +2 -3
  155. package/dist/trigger/ipc-service.js +105 -78
  156. package/dist/trigger/local-files.js +2 -1
  157. package/dist/trigger/manager.js +5 -3
  158. package/dist/trigger/scheduler.js +88 -6
  159. package/dist/utils/atomic-write.js +28 -0
  160. package/dist/utils/cross-platform.js +14 -0
  161. package/dist/utils/ecweb-supervisor.js +258 -83
  162. package/dist/utils/error-utils.js +26 -2
  163. package/dist/utils/logger.js +92 -6
  164. package/dist/utils/package-version-info.js +4 -2
  165. package/dist/utils/welcome.js +1 -1
  166. package/kits/docs/INDEX.md +1 -0
  167. package/kits/docs/aun/SDK.md +4 -1
  168. package/kits/docs/channels/aun.md +9 -0
  169. package/kits/docs/evolcore/INDEX.md +1 -0
  170. package/kits/docs/evolcore/agent.md +8 -1
  171. package/kits/docs/evolcore/aid.md +67 -17
  172. package/kits/docs/evolcore/config.md +28 -7
  173. package/kits/docs/evolcore/contact.md +3 -0
  174. package/kits/docs/evolcore/fs.md +11 -0
  175. package/kits/docs/evolcore/group.md +1 -1
  176. package/kits/docs/evolcore/memory-architecture.md +2 -2
  177. package/kits/docs/evolcore/memory-consolidation.md +32 -8
  178. package/kits/docs/evolcore/memory.md +1 -1
  179. package/kits/docs/evolcore/menu-protocol.md +4 -0
  180. package/kits/docs/evolcore/model.md +23 -20
  181. package/kits/docs/evolcore/msg.md +4 -7
  182. package/kits/docs/evolcore/provider.md +50 -0
  183. package/kits/docs/identity/AID_PROFILE_SPEC.md +52 -17
  184. package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
  185. package/kits/rules/01-overview.md +3 -0
  186. package/kits/rules/04-relation.md +1 -1
  187. package/kits/schemas/_meta.json +37 -4
  188. package/kits/schemas/agent-config.schema.13.json +8 -3
  189. package/kits/schemas/agent-config.schema.16.json +891 -0
  190. package/kits/schemas/daemon.schema.9.json +366 -0
  191. package/kits/schemas/defaults.schema.5.json +406 -127
  192. package/kits/schemas/relation-config.schema.11.json +277 -0
  193. package/kits/schemas/role-config.schema.1.json +7 -7
  194. package/kits/skills/.switches.json +4 -0
  195. package/kits/skills/ec-agent-create/SKILL.md +3 -0
  196. package/kits/skills/ec-identity/SKILL.md +2 -2
  197. package/kits/skills/ec-service-proxy/SKILL.md +118 -0
  198. package/kits/skills/ec-skill/scripts/skill.mjs +6 -0
  199. package/kits/skills/personal-assistant/SKILL.md +176 -0
  200. package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
  201. package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
  202. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
  203. package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
  204. package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
  205. package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
  206. package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
  207. package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
  208. package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
  209. package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
  210. package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
  211. package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
  212. package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
  213. package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
  214. package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
  215. package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
  216. package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
  217. package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
  218. package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
  219. package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
  220. package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
  221. package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
  222. package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
  223. package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
  224. package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
  225. package/kits/skills/thread-ops/SKILL.md +5 -0
  226. package/kits/templates/memory-consolidation/forget.md +19 -6
  227. package/kits/templates/memory-consolidation/notes.md +1 -1
  228. package/kits/templates/memory-consolidation/profile.md +2 -2
  229. package/kits/templates/memory-consolidation/promote.md +20 -3
  230. package/kits/templates/roles/member.json +8 -1
  231. package/kits/templates/system-fragments/baseagent.md +2 -2
  232. package/kits/templates/system-fragments/memory.md +4 -4
  233. package/kits/templates/system-fragments/venue.md +1 -1
  234. package/package.json +7 -3
  235. package/dist/core/message/create-status.js +0 -96
@@ -0,0 +1,166 @@
1
+ import fs from 'fs';
2
+ import { isValidAid } from '../aun/aid/validation.js';
3
+ import { agentConfig } from '../paths.js';
4
+ import { listRoleRequests, reviewRoleRequest, submitRoleRequest, } from './role-request-service.js';
5
+ export function resolveRoleCommand(argv) {
6
+ const args = argv[0] === 'role' ? argv.slice(1) : [...argv];
7
+ const selfAid = String(argValue(args, '--self') || '').trim();
8
+ if (!isValidAid(selfAid))
9
+ return invalid('INVALID_SELF', '--self must be a valid Agent AID');
10
+ const positional = stripOptions(args);
11
+ const [command, subcommand, ...extra] = positional;
12
+ if (extra.length > 0)
13
+ return invalid('INVALID_ARGUMENT', `Unexpected role arguments: ${extra.join(' ')}`);
14
+ if (command === 'request') {
15
+ if (!isValidAid(subcommand || ''))
16
+ return invalid('INVALID_AID', 'role request requires a valid peer AID');
17
+ const roleId = String(argValue(args, '--role') || argValue(args, '--as') || '').trim();
18
+ if (!roleId)
19
+ return invalid('INVALID_ARGUMENT', 'role request requires --role <role-id>');
20
+ const reason = argValue(args, '--reason');
21
+ return {
22
+ ok: true,
23
+ command: {
24
+ kind: 'request',
25
+ selfAid,
26
+ peerAid: subcommand,
27
+ roleId,
28
+ ...(reason ? { reason } : {}),
29
+ canonicalArgv: canonicalArgv(argv),
30
+ },
31
+ };
32
+ }
33
+ if (command === 'approve' || command === 'reject') {
34
+ const requestId = String(subcommand || '').trim();
35
+ if (!requestId)
36
+ return invalid('INVALID_ARGUMENT', `role ${command} requires a request id`);
37
+ const note = argValue(args, '--reason');
38
+ return {
39
+ ok: true,
40
+ command: {
41
+ kind: 'review',
42
+ decision: command === 'approve' ? 'approve' : 'reject',
43
+ selfAid,
44
+ requestId,
45
+ ...(note ? { note } : {}),
46
+ canonicalArgv: canonicalArgv(argv),
47
+ },
48
+ };
49
+ }
50
+ if (command === 'list') {
51
+ if (subcommand !== undefined)
52
+ return invalid('INVALID_ARGUMENT', 'role list does not accept a positional argument');
53
+ const statusValue = String(argValue(args, '--status') || '').trim();
54
+ const status = statusValue ? parseStatus(statusValue) : undefined;
55
+ if (statusValue && !status)
56
+ return invalid('INVALID_ARGUMENT', '--status must be pending, approved, rejected, or expired');
57
+ return {
58
+ ok: true,
59
+ command: { kind: 'list', selfAid, ...(status ? { status } : {}), canonicalArgv: canonicalArgv(argv) },
60
+ };
61
+ }
62
+ return invalid('UNKNOWN_COMMAND', `Unknown role command: ${positional.join(' ')}`);
63
+ }
64
+ export async function executeResolvedRoleCommand(command, actorAid, apply) {
65
+ if (!fs.existsSync(agentConfig(command.selfAid))) {
66
+ return { ok: false, code: 'AGENT_NOT_FOUND', error: `Agent does not exist: ${command.selfAid}` };
67
+ }
68
+ if (command.kind === 'request') {
69
+ const submission = await submitRoleRequest({
70
+ selfAid: command.selfAid,
71
+ peerAid: command.peerAid,
72
+ requestedRole: command.roleId,
73
+ reason: command.reason,
74
+ });
75
+ if (!submission.request) {
76
+ const code = submission.code === 'capacity' ? 'CAPACITY' : 'INVALID_REQUEST';
77
+ return { ok: false, code, error: submission.code };
78
+ }
79
+ return {
80
+ ok: true,
81
+ operation: 'request',
82
+ selfAid: command.selfAid,
83
+ code: submission.code,
84
+ request: submission.request,
85
+ };
86
+ }
87
+ if (command.kind === 'review') {
88
+ const reviewed = await reviewRoleRequest({
89
+ selfAid: command.selfAid,
90
+ requestId: command.requestId,
91
+ decision: command.decision,
92
+ actorAid,
93
+ note: command.note,
94
+ apply,
95
+ });
96
+ if (reviewed.code === 'forbidden') {
97
+ return { ok: false, code: 'PERMISSION_DENIED', error: 'Only the Agent owner can review role requests' };
98
+ }
99
+ if (reviewed.code === 'not-found') {
100
+ return { ok: false, code: 'NOT_FOUND', error: `Role request was not found: ${command.requestId}` };
101
+ }
102
+ if (reviewed.code === 'apply-failed') {
103
+ return {
104
+ ok: false,
105
+ code: 'APPLY_FAILED',
106
+ error: reviewed.error ?? 'Failed to apply the approved role assignment',
107
+ data: { requestId: command.requestId },
108
+ };
109
+ }
110
+ return {
111
+ ok: true,
112
+ operation: 'review',
113
+ selfAid: command.selfAid,
114
+ code: reviewed.code,
115
+ requestId: command.requestId,
116
+ status: reviewed.request?.status ?? (reviewed.code === 'expired' ? 'expired' : 'pending'),
117
+ ...(reviewed.request ? { request: reviewed.request } : {}),
118
+ };
119
+ }
120
+ return {
121
+ ok: true,
122
+ operation: 'list',
123
+ selfAid: command.selfAid,
124
+ requests: listRoleRequests({ selfAid: command.selfAid, status: command.status }),
125
+ };
126
+ }
127
+ function parseStatus(value) {
128
+ return value === 'pending' || value === 'approved' || value === 'rejected' || value === 'expired'
129
+ ? value
130
+ : undefined;
131
+ }
132
+ function argValue(args, name) {
133
+ const index = args.indexOf(name);
134
+ if (index < 0)
135
+ return undefined;
136
+ return args[index + 1];
137
+ }
138
+ function stripOptions(args) {
139
+ const options = new Set(['--self', '--role', '--as', '--reason', '--status', '--format']);
140
+ const positional = [];
141
+ for (let index = 0; index < args.length; index += 1) {
142
+ const value = args[index];
143
+ if (options.has(value)) {
144
+ index += 1;
145
+ continue;
146
+ }
147
+ if (value.startsWith('-'))
148
+ continue;
149
+ positional.push(value);
150
+ }
151
+ return positional;
152
+ }
153
+ function canonicalArgv(argv) {
154
+ const result = [];
155
+ for (let index = 0; index < argv.length; index += 1) {
156
+ if (argv[index] === '--format') {
157
+ index += 1;
158
+ continue;
159
+ }
160
+ result.push(argv[index]);
161
+ }
162
+ return result;
163
+ }
164
+ function invalid(code, reason) {
165
+ return { ok: false, code, reason };
166
+ }
@@ -0,0 +1,193 @@
1
+ import crypto from 'crypto';
2
+ import fs from 'fs';
3
+ import path from 'path';
4
+ import { isValidAid } from '../aun/aid/validation.js';
5
+ import { agentRoleRequestsPath } from '../paths.js';
6
+ import { listStaticAgentOwners } from './peer-role-resolver.js';
7
+ import { getRoleDefinition } from './roles.js';
8
+ export const ROLE_REQUEST_TTL_MS = 24 * 60 * 60 * 1000;
9
+ export const ROLE_REQUEST_MAX_PENDING = 50;
10
+ export const ROLE_REQUEST_MAX_RETAINED = 200;
11
+ export const ROLE_REQUEST_REASON_MAX_LENGTH = 500;
12
+ function emptyStore() {
13
+ return { $schema_version: 1, revision: revisionOf([]), requests: [] };
14
+ }
15
+ function revisionOf(requests) {
16
+ const hash = crypto.createHash('sha256').update(JSON.stringify(requests)).digest('hex');
17
+ return `sha256:${hash}`;
18
+ }
19
+ function readStore(selfAid) {
20
+ const file = agentRoleRequestsPath(selfAid);
21
+ let raw;
22
+ try {
23
+ raw = fs.readFileSync(file, 'utf8');
24
+ }
25
+ catch (error) {
26
+ if (error?.code === 'ENOENT')
27
+ return emptyStore();
28
+ throw error;
29
+ }
30
+ let parsed;
31
+ try {
32
+ parsed = JSON.parse(raw);
33
+ }
34
+ catch {
35
+ throw new Error(`Invalid role request store: ${file}`);
36
+ }
37
+ if (!parsed || typeof parsed !== 'object' || !Array.isArray(parsed.requests)) {
38
+ throw new Error(`Invalid role request store: ${file}`);
39
+ }
40
+ const requests = parsed.requests
41
+ .filter(isRoleRequestRecord)
42
+ .map(record => ({ ...record }));
43
+ return { $schema_version: 1, revision: revisionOf(requests), requests };
44
+ }
45
+ function isRoleRequestRecord(value) {
46
+ if (!value || typeof value !== 'object')
47
+ return false;
48
+ const record = value;
49
+ return typeof record.id === 'string'
50
+ && record.id.length > 0
51
+ && typeof record.peerAid === 'string'
52
+ && isValidAid(record.peerAid)
53
+ && typeof record.requestedRole === 'string'
54
+ && typeof record.submittedAt === 'string'
55
+ && Number.isFinite(Date.parse(record.submittedAt))
56
+ && typeof record.expiresAt === 'string'
57
+ && Number.isFinite(Date.parse(record.expiresAt))
58
+ && ['pending', 'approved', 'rejected', 'expired'].includes(record.status)
59
+ && (record.reason === undefined || typeof record.reason === 'string')
60
+ && (record.decidedAt === undefined || typeof record.decidedAt === 'string')
61
+ && (record.decidedBy === undefined || typeof record.decidedBy === 'string')
62
+ && (record.decisionNote === undefined || typeof record.decisionNote === 'string');
63
+ }
64
+ function writeStore(selfAid, requests) {
65
+ const file = agentRoleRequestsPath(selfAid);
66
+ fs.mkdirSync(path.dirname(file), { recursive: true });
67
+ const payload = {
68
+ $schema_version: 1,
69
+ revision: revisionOf(requests),
70
+ requests,
71
+ };
72
+ const tmp = `${file}.${process.pid}.${crypto.randomUUID()}.tmp`;
73
+ fs.writeFileSync(tmp, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
74
+ fs.renameSync(tmp, file);
75
+ }
76
+ function normalizeReason(value) {
77
+ const reason = String(value ?? '').trim();
78
+ if (!reason)
79
+ return undefined;
80
+ return reason.slice(0, ROLE_REQUEST_REASON_MAX_LENGTH);
81
+ }
82
+ function expireOverdue(requests, now) {
83
+ let changed = false;
84
+ const nowIso = new Date(now).toISOString();
85
+ for (const request of requests) {
86
+ if (request.status === 'pending' && Date.parse(request.expiresAt) <= now) {
87
+ request.status = 'expired';
88
+ request.decidedAt = nowIso;
89
+ changed = true;
90
+ }
91
+ }
92
+ return changed;
93
+ }
94
+ /**
95
+ * 记录一条由本 Agent 发起的角色提升申请。申请本身不改变任何权限,
96
+ * 只是把「把 peerAid 提升为 requestedRole」这件事交给本 Agent 的 owner 审批。
97
+ */
98
+ export async function submitRoleRequest(input) {
99
+ const peerAid = String(input.peerAid || '').trim();
100
+ const requestedRole = String(input.requestedRole || '').trim();
101
+ if (!isValidAid(peerAid))
102
+ return { code: 'invalid-peer' };
103
+ if (!requestedRole || requestedRole === 'owner' || requestedRole === 'daemon-owner'
104
+ || !getRoleDefinition(requestedRole, input.selfAid)) {
105
+ return { code: 'invalid-role' };
106
+ }
107
+ if (listStaticAgentOwners(input.selfAid).includes(peerAid)) {
108
+ return { code: 'owner-protected' };
109
+ }
110
+ const now = input.now ?? Date.now();
111
+ const requests = readStore(input.selfAid).requests;
112
+ const expired = expireOverdue(requests, now);
113
+ const existing = requests.find(record => (record.peerAid === peerAid
114
+ && record.requestedRole === requestedRole
115
+ && record.status === 'pending'));
116
+ if (existing) {
117
+ if (expired)
118
+ writeStore(input.selfAid, requests);
119
+ return { code: 'already-pending', request: { ...existing } };
120
+ }
121
+ const pendingCount = requests.filter(record => record.status === 'pending').length;
122
+ if (expired || pendingCount >= ROLE_REQUEST_MAX_PENDING) {
123
+ writeStore(input.selfAid, requests);
124
+ }
125
+ if (pendingCount >= ROLE_REQUEST_MAX_PENDING)
126
+ return { code: 'capacity' };
127
+ const submittedAt = new Date(now).toISOString();
128
+ const record = {
129
+ id: `rreq_${crypto.randomUUID().replace(/-/g, '')}`,
130
+ peerAid,
131
+ requestedRole,
132
+ reason: normalizeReason(input.reason),
133
+ status: 'pending',
134
+ submittedAt,
135
+ expiresAt: new Date(now + ROLE_REQUEST_TTL_MS).toISOString(),
136
+ };
137
+ const retained = requests.slice(-(ROLE_REQUEST_MAX_RETAINED - 1));
138
+ writeStore(input.selfAid, [...retained, record]);
139
+ return { code: 'submitted', request: record };
140
+ }
141
+ /** 只允许本 Agent 的 owner 审批;审批通过后由 apply 回调写入 relation.role。 */
142
+ export async function reviewRoleRequest(input) {
143
+ const owners = listStaticAgentOwners(input.selfAid, { fresh: true });
144
+ if (!owners.includes(input.actorAid))
145
+ return { code: 'forbidden' };
146
+ const now = input.now ?? Date.now();
147
+ const requests = readStore(input.selfAid).requests;
148
+ const request = requests.find(record => record.id === input.requestId);
149
+ if (!request)
150
+ return { code: 'not-found' };
151
+ if (request.status !== 'pending') {
152
+ return { code: request.status === 'expired' ? 'expired' : 'not-pending', request: { ...request } };
153
+ }
154
+ if (Date.parse(request.expiresAt) <= now) {
155
+ expireOverdue(requests, now);
156
+ writeStore(input.selfAid, requests);
157
+ return { code: 'expired', request: { ...request, status: 'expired' } };
158
+ }
159
+ if (input.decision === 'approve') {
160
+ try {
161
+ await input.apply({
162
+ selfAid: input.selfAid,
163
+ peerAid: request.peerAid,
164
+ roleId: request.requestedRole,
165
+ });
166
+ }
167
+ catch (error) {
168
+ return {
169
+ code: 'apply-failed',
170
+ request: { ...request },
171
+ error: error?.message ?? String(error),
172
+ };
173
+ }
174
+ }
175
+ const decidedAt = new Date(now).toISOString();
176
+ request.status = input.decision === 'approve' ? 'approved' : 'rejected';
177
+ request.decidedAt = decidedAt;
178
+ request.decidedBy = input.actorAid;
179
+ const note = normalizeReason(input.note);
180
+ if (note)
181
+ request.decisionNote = note;
182
+ writeStore(input.selfAid, requests);
183
+ return { code: input.decision === 'approve' ? 'approved' : 'rejected', request: { ...request } };
184
+ }
185
+ export function listRoleRequests(input) {
186
+ const now = input.now ?? Date.now();
187
+ const requests = readStore(input.selfAid).requests;
188
+ if (expireOverdue(requests, now))
189
+ writeStore(input.selfAid, requests);
190
+ return requests
191
+ .filter(record => !input.status || record.status === input.status)
192
+ .map(record => ({ ...record }));
193
+ }