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,309 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { randomUUID } from 'node:crypto';
4
+ import Ajv from 'ajv';
5
+ import { readAuthoritativePersonalFsObject } from '../aun/group/fs-download.js';
6
+ import { atomicReadJson, atomicWriteJson } from '../utils/atomic-write.js';
7
+ import { getAunRequestRegistry } from '../core/message/aun-request-registry.js';
8
+ import { parseOwnerDirectoryGrantAbilityResponse } from './owner-directory-cache.js';
9
+ import { logger } from '../utils/logger.js';
10
+ const ABILITY_PATH = 'directory/access';
11
+ const DEFINITION_ID = 'evol-directory-access-v1';
12
+ const REQUEST_TTL_SECONDS = 60;
13
+ const REQUEST_PARAMS = {
14
+ action: 'request', scopes: ['agents'], valid_for_seconds: 2_592_000,
15
+ purpose: '同步 Owner 的 Agent 名录,识别并联系同属 Owner 的 Agent',
16
+ };
17
+ /** Startup/Owner-message retries, with a durable stop only for a correlated Owner refusal. */
18
+ export class OwnerDirectoryAuthorization {
19
+ options;
20
+ inFlight;
21
+ retryTimer;
22
+ registry;
23
+ now;
24
+ constructor(options) {
25
+ this.options = options;
26
+ this.registry = options.registry ?? getAunRequestRegistry();
27
+ this.now = options.now ?? Date.now;
28
+ }
29
+ ensureAuthorization() {
30
+ if (this.inFlight) {
31
+ logger.debug(`[OwnerDirectory] Authorization request already in flight for ${this.options.selfAid} -> ${this.options.ownerAid}`);
32
+ return this.inFlight;
33
+ }
34
+ logger.info(`[OwnerDirectory] Starting authorization check: selfAid=${this.options.selfAid}, Owner=${this.options.ownerAid}`);
35
+ const task = this.requestIfNeeded().finally(() => {
36
+ if (this.inFlight === task)
37
+ this.inFlight = undefined;
38
+ });
39
+ this.inFlight = task;
40
+ return task;
41
+ }
42
+ dispose() {
43
+ if (this.retryTimer)
44
+ clearTimeout(this.retryTimer);
45
+ this.retryTimer = undefined;
46
+ }
47
+ scheduleCheck(at) {
48
+ this.dispose();
49
+ this.retryTimer = setTimeout(() => {
50
+ this.retryTimer = undefined;
51
+ if (!this.options.isCurrent())
52
+ return;
53
+ void this.ensureAuthorization().catch(() => {
54
+ if (this.options.isCurrent())
55
+ this.scheduleCheck(this.now() + 5_000);
56
+ });
57
+ }, Math.max(1, at - this.now()));
58
+ this.retryTimer.unref();
59
+ }
60
+ ownsRequest(record) {
61
+ return record.selfAid === this.options.selfAid && record.targetAid === this.options.ownerAid
62
+ && record.requestId.startsWith('owner-directory-auto-');
63
+ }
64
+ /** Called only after the channel refreshes Ownership and the registry verifies the sender/device. */
65
+ async acceptResponse(record) {
66
+ const attempt = this.readAttempt();
67
+ const response = record.responsePayload;
68
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Received authorization response from ${record.targetAid}, state: ${record.state}, hasAttempt=${!!attempt}, hasResponse=${!!response}`);
69
+ if (response) {
70
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Response payload summary: type=${response.type}, role=${response.role}, ok=${response.ok}, ability_path=${response.ability_path}, definition_id=${response.definition_id}, call_id=${response.call_id}, operation_id=${response.operation_id}, error=${JSON.stringify(response.error)}`);
71
+ }
72
+ if (!this.options.isCurrent()) {
73
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - connection no longer current`);
74
+ return;
75
+ }
76
+ if (!attempt) {
77
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - no local attempt on disk`);
78
+ return;
79
+ }
80
+ if (!this.ownsRequest(record)) {
81
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - record not owned by this attempt (requestId=${record.requestId}, selfAid=${record.selfAid}, targetAid=${record.targetAid})`);
82
+ return;
83
+ }
84
+ if (record.state !== 'completed') {
85
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - record.state=${record.state} (not completed)`);
86
+ return;
87
+ }
88
+ if (!record.targetDeviceId || record.responseDeviceId !== record.targetDeviceId) {
89
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - device mismatch: target=${record.targetDeviceId}, response=${record.responseDeviceId}`);
90
+ return;
91
+ }
92
+ if (!response || response.type !== 'ability' || response.role !== 'result'
93
+ || response.call_id !== record.requestId || response.operation_id !== attempt.operationId
94
+ || response.ability_path !== ABILITY_PATH || response.definition_id !== DEFINITION_ID) {
95
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: acceptResponse skipped - response validation failed. matches: type=${response?.type === 'ability'}, role=${response?.role === 'result'}, call_id=${response?.call_id === record.requestId}, operation_id=${response?.operation_id === attempt.operationId}, ability_path=${response?.ability_path === ABILITY_PATH}, definition_id=${response?.definition_id === DEFINITION_ID}`);
96
+ return;
97
+ }
98
+ // An absent grant, an ACK, a timeout or a storage/transport error is not an Owner refusal.
99
+ if (response.ok === false && isRecord(response.error)
100
+ && ['user_denied', 'permission_denied'].includes(String(response.error.code))) {
101
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: Authorization explicitly denied by Owner: ${response.error.code}, message=${response.error.message}`);
102
+ this.dispose();
103
+ this.writeAttempt({ ...attempt, status: 'denied' });
104
+ return;
105
+ }
106
+ if (response.ok === false) {
107
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: Authorization request failed (retryable): ${JSON.stringify(response.error)}`);
108
+ this.writeAttempt({ ...attempt, status: 'retryable' });
109
+ if (attempt.action === 'status')
110
+ this.scheduleCheck(this.now() + 5_000);
111
+ return;
112
+ }
113
+ const grant = parseOwnerDirectoryGrantAbilityResponse(response);
114
+ if (!grant || grant.owner_aid !== this.options.ownerAid || grant.grantee_aid !== this.options.selfAid) {
115
+ logger.warn(`[OwnerDirectory] Authorization response validation failed or identity mismatch`);
116
+ return;
117
+ }
118
+ logger.info(`[OwnerDirectory] Received valid authorization grant: status=${grant.status}, scopes=${JSON.stringify(grant.active_scopes)}`);
119
+ this.options.cache.saveAuthorization(grant);
120
+ const result = response.result;
121
+ if (this.options.cache.scopeAccess('agents') !== 'authorized' && isRecord(result)
122
+ && result.status === 'sync_pending' && ['initializing', 'syncing'].includes(String(result.readiness))
123
+ && isRecord(result.retry_request) && result.retry_request.action === 'status') {
124
+ const hint = result.retry_after_seconds;
125
+ const delay = typeof hint === 'number' && Number.isFinite(hint) ? Math.min(300, Math.max(1, hint)) : 5;
126
+ const retryAt = this.now() + Math.ceil(delay * 1_000);
127
+ logger.info(`[OwnerDirectory] Owner directory is ${result.readiness}, will check status in ${delay}s`);
128
+ this.writeAttempt({ ...attempt, status: 'initializing', action: 'status', retryAt });
129
+ this.scheduleCheck(retryAt);
130
+ return;
131
+ }
132
+ this.dispose();
133
+ const finalStatus = this.options.cache.scopeAccess('agents') === 'authorized' ? 'granted' : 'retryable';
134
+ logger.info(`[OwnerDirectory] Authorization completed with status: ${finalStatus}`);
135
+ this.writeAttempt({ ...attempt, action: 'request', retryAt: undefined, status: finalStatus });
136
+ logger.info(`[OwnerDirectory] Triggering directory cache refresh after authorization`);
137
+ await this.options.cache.handleOwnerChangedEvent(this.options.ownerAid);
138
+ }
139
+ async requestIfNeeded() {
140
+ if (!this.options.isCurrent()) {
141
+ logger.debug(`[OwnerDirectory] Authorization check skipped - connection no longer current for ${this.options.selfAid}`);
142
+ return;
143
+ }
144
+ let previous = this.readAttempt();
145
+ const scopeAccess = this.options.cache.scopeAccess('agents');
146
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Scope 'agents' access status: ${scopeAccess}, previous status: ${previous?.status || 'none'}`);
147
+ if (scopeAccess === 'authorized') {
148
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Already authorized for Owner ${this.options.ownerAid}, skipping request`);
149
+ this.dispose();
150
+ // A later valid grant supersedes an earlier refusal, including grants requested manually.
151
+ if (previous?.status === 'denied')
152
+ this.writeAttempt({ ...previous, status: 'granted' });
153
+ return;
154
+ }
155
+ if (previous?.status === 'denied') {
156
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: Authorization previously denied by Owner ${this.options.ownerAid}, not retrying`);
157
+ this.dispose();
158
+ return;
159
+ }
160
+ if (previous?.status === 'pending') {
161
+ const record = this.registry.get(this.options.selfAid, previous.callId);
162
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: found pending attempt, callId=${previous.callId.slice(0, 24)}..., record=${record ? `state=${record.state}` : 'not found'}, deadlineAt=${new Date(previous.deadlineAt).toISOString()}, expired=${previous.deadlineAt <= this.now()}`);
163
+ if (record?.state === 'completed') {
164
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: processing completed record`);
165
+ await this.acceptResponse(record);
166
+ previous = this.readAttempt();
167
+ if (previous?.status === 'denied' || this.options.cache.scopeAccess('agents') === 'authorized')
168
+ return;
169
+ }
170
+ else if (previous.deadlineAt > this.now() && record && !['failed', 'unknown'].includes(record.state)) {
171
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: pending request still within deadline, skipping (record.state=${record.state})`);
172
+ return;
173
+ }
174
+ else {
175
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: pending request expired or failed, will retry (record=${record ? `state=${record.state}` : 'not found'})`);
176
+ }
177
+ }
178
+ if (previous?.status === 'initializing' && (previous.retryAt ?? 0) > this.now()) {
179
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: initializing, retryAt=${new Date(previous.retryAt).toISOString()}, waiting`);
180
+ this.scheduleCheck(previous.retryAt);
181
+ return;
182
+ }
183
+ const action = previous?.action === 'status' ? 'status' : 'request';
184
+ const params = action === 'status' ? { action: 'status' } : REQUEST_PARAMS;
185
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Discovering device for Owner ${this.options.ownerAid}, action: ${action}`);
186
+ let deviceId;
187
+ try {
188
+ deviceId = await this.discoverDevice(previous?.deviceId, params);
189
+ }
190
+ catch (error) {
191
+ logger.warn(`[OwnerDirectory] Agent ${this.options.selfAid}: Device discovery failed: ${error instanceof Error ? error.message : String(error)}`);
192
+ throw error;
193
+ }
194
+ logger.info(`[OwnerDirectory] Agent ${this.options.selfAid}: Selected device: ${deviceId}`);
195
+ if (!this.options.isCurrent() || this.options.cache.scopeAccess('agents') === 'authorized'
196
+ || this.readAttempt()?.status === 'denied')
197
+ return;
198
+ // Retain the logical operation across unanswered attempts for Provider idempotency.
199
+ const operationId = previous?.status === 'pending' ? previous.operationId : `directory-${randomUUID()}`;
200
+ const callId = `owner-directory-auto-${randomUUID()}`;
201
+ logger.info(`[OwnerDirectory] Sending authorization ${action} to Owner ${this.options.ownerAid}, operation: ${operationId.slice(0, 16)}..., call: ${callId.slice(0, 24)}...`);
202
+ const prepared = this.registry.prepare({
203
+ selfAid: this.options.selfAid, targetAid: this.options.ownerAid, targetDeviceId: deviceId,
204
+ timeoutMs: REQUEST_TTL_SECONDS * 1_000,
205
+ payload: { type: 'ability', role: 'call', call_id: callId, operation_id: operationId,
206
+ ability_path: ABILITY_PATH, definition_id: DEFINITION_ID, params,
207
+ ttl: REQUEST_TTL_SECONDS, async: false },
208
+ });
209
+ this.writeAttempt({ schemaVersion: 1, selfAid: this.options.selfAid, ownerAid: this.options.ownerAid,
210
+ operationId, callId, deviceId, action, deadlineAt: this.now() + REQUEST_TTL_SECONDS * 1_000, status: 'pending' });
211
+ if (action === 'status')
212
+ this.scheduleCheck(this.now() + REQUEST_TTL_SECONDS * 1_000);
213
+ this.registry.markSending(this.options.selfAid, callId);
214
+ try {
215
+ const sent = await this.options.send(prepared.payload, deviceId, REQUEST_TTL_SECONDS);
216
+ if (!sent.ok || !sent.message_id) {
217
+ logger.error(`[OwnerDirectory] Authorization request not accepted: ${sent.error}`);
218
+ throw new Error(sent.error ?? 'directory authorization request was not accepted');
219
+ }
220
+ logger.info(`[OwnerDirectory] Authorization request sent successfully, message_id: ${sent.message_id}`);
221
+ this.registry.markTransportAccepted(this.options.selfAid, callId, sent.message_id, sent.status);
222
+ }
223
+ catch (error) {
224
+ logger.error(`[OwnerDirectory] Authorization request failed: ${error instanceof Error ? error.message : String(error)}`);
225
+ this.registry.markFailed(this.options.selfAid, callId, error instanceof Error ? error.message : String(error));
226
+ throw error;
227
+ }
228
+ }
229
+ async discoverDevice(preferred, params) {
230
+ logger.info(`[OwnerDirectory] discoverDevice: reading ability/index.json from Owner ${this.options.ownerAid}`);
231
+ let index;
232
+ try {
233
+ index = await this.readPublishedJson('/ability/index.json', 128 * 1024);
234
+ }
235
+ catch (error) {
236
+ logger.warn(`[OwnerDirectory] discoverDevice: failed to read ability/index.json: ${error instanceof Error ? error.message : String(error)}`);
237
+ throw error;
238
+ }
239
+ const capabilities = Array.isArray(index.capabilities) ? index.capabilities : [];
240
+ logger.info(`[OwnerDirectory] discoverDevice: ability/index.json has ${capabilities.length} capabilities`);
241
+ const entry = capabilities.find(value => isRecord(value)
242
+ && value.path === ABILITY_PATH && value.definition_id === DEFINITION_ID);
243
+ if (!isRecord(entry) || !Array.isArray(entry.devices) || !entry.devices.length
244
+ || entry.devices.some(device => typeof device !== 'string' || !device.trim())
245
+ || typeof entry.detail_ref !== 'string') {
246
+ logger.warn(`[OwnerDirectory] discoverDevice: Owner has no valid directory/access entry. entry=${JSON.stringify(entry)}`);
247
+ throw new Error('Owner has no published directory/access device/contract');
248
+ }
249
+ logger.info(`[OwnerDirectory] discoverDevice: found entry, devices=${JSON.stringify(entry.devices)}, detail_ref=${entry.detail_ref}`);
250
+ const prefix = `${this.options.ownerAid}:/`;
251
+ if (!entry.detail_ref.startsWith(prefix)) {
252
+ logger.warn(`[OwnerDirectory] discoverDevice: detail_ref does not start with owner prefix: ${entry.detail_ref}`);
253
+ throw new Error('Owner directory contract must belong to the same Owner');
254
+ }
255
+ const contractPath = entry.detail_ref.slice(this.options.ownerAid.length + 1);
256
+ logger.info(`[OwnerDirectory] discoverDevice: reading contract at ${contractPath}`);
257
+ let contract;
258
+ try {
259
+ contract = await this.readPublishedJson(contractPath, 24 * 1024);
260
+ }
261
+ catch (error) {
262
+ logger.warn(`[OwnerDirectory] discoverDevice: failed to read contract: ${error instanceof Error ? error.message : String(error)}`);
263
+ throw error;
264
+ }
265
+ if (contract.path !== ABILITY_PATH || contract.definition_id !== DEFINITION_ID
266
+ || contract.idempotency !== 'keyed' || contract.require_confirm !== entry.require_confirm
267
+ || contract.auth_required !== entry.auth_required || !isRecord(contract.params_schema)
268
+ || JSON.stringify(contract.effects) !== JSON.stringify(entry.effects)) {
269
+ logger.warn(`[OwnerDirectory] discoverDevice: contract mismatch. contract.path=${contract.path}, contract.idempotency=${contract.idempotency}, require_confirm=${contract.require_confirm}/${entry.require_confirm}, auth_required=${contract.auth_required}/${entry.auth_required}, effects_match=${JSON.stringify(contract.effects) === JSON.stringify(entry.effects)}`);
270
+ throw new Error('Owner directory index and contract do not match');
271
+ }
272
+ const validate = new Ajv({ strict: false }).compile(contract.params_schema);
273
+ if (!validate(params)) {
274
+ logger.warn(`[OwnerDirectory] discoverDevice: params schema validation failed: ${JSON.stringify(validate.errors)}`);
275
+ throw new Error('Owner directory contract does not accept the authorization parameters');
276
+ }
277
+ const devices = entry.devices;
278
+ const selected = preferred && devices.includes(preferred) ? preferred : [...devices].sort()[0];
279
+ logger.info(`[OwnerDirectory] discoverDevice: selected device=${selected}`);
280
+ return selected;
281
+ }
282
+ async readPublishedJson(remotePath, maxBytes) {
283
+ const { bytes } = await readAuthoritativePersonalFsObject(this.options.client, remotePath, this.options.ownerAid, maxBytes);
284
+ const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes).replace(/^\uFEFF/, ''));
285
+ if (!isRecord(value))
286
+ throw new Error('Owner ability document must be a JSON object');
287
+ return value;
288
+ }
289
+ readAttempt() {
290
+ const value = atomicReadJson(this.statePath());
291
+ if (!isRecord(value) || value.schemaVersion !== 1 || value.selfAid !== this.options.selfAid
292
+ || value.ownerAid !== this.options.ownerAid || typeof value.operationId !== 'string'
293
+ || typeof value.callId !== 'string' || typeof value.deviceId !== 'string' || !Number.isSafeInteger(value.deadlineAt)
294
+ || !['pending', 'initializing', 'retryable', 'denied', 'granted'].includes(String(value.status))
295
+ || (value.action !== undefined && !['request', 'status'].includes(String(value.action)))
296
+ || (value.retryAt !== undefined && !Number.isSafeInteger(value.retryAt)))
297
+ return undefined;
298
+ return value;
299
+ }
300
+ writeAttempt(attempt) {
301
+ fs.mkdirSync(this.options.directory, { recursive: true, mode: 0o700 });
302
+ atomicWriteJson(this.statePath(), attempt);
303
+ fs.chmodSync(this.statePath(), 0o600);
304
+ }
305
+ statePath() { return path.join(this.options.directory, 'authorization-request.json'); }
306
+ }
307
+ function isRecord(value) {
308
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
309
+ }