evolcore 0.0.47 → 0.0.49

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 (266) hide show
  1. package/CHANGELOG.md +90 -1
  2. package/bin/ec-build.mjs +86 -0
  3. package/dist/agent-template/jobs.js +12 -4
  4. package/dist/agent-template/runtime.js +143 -40
  5. package/dist/agent-template/service.js +66 -13
  6. package/dist/agents/baseagent.js +60 -20
  7. package/dist/agents/claude-runner.js +34 -17
  8. package/dist/agents/codex-runner.js +36 -17
  9. package/dist/agents/ecagent-runner.js +7 -4
  10. package/dist/agents/gemini-runner.js +5 -2
  11. package/dist/agents/runner-types.js +5 -21
  12. package/dist/aun/aid/agentmd.js +5 -1
  13. package/dist/aun/msg/p2p.js +2 -1
  14. package/dist/aun/service-proxy.js +4 -2
  15. package/dist/build-identity.json +1 -0
  16. package/dist/channels/aun.js +722 -295
  17. package/dist/channels/daemon.js +9 -25
  18. package/dist/cli/aun-commands.js +86 -51
  19. package/dist/cli/code-stats.js +19 -8
  20. package/dist/cli/command-log.js +1 -1
  21. package/dist/cli/daemon-commands.js +44 -43
  22. package/dist/cli/directory.js +13 -2
  23. package/dist/cli/ecmsg-gateway.js +5 -2
  24. package/dist/cli/index.js +9 -9
  25. package/dist/cli/init-channel.js +4 -6
  26. package/dist/cli/init.js +72 -50
  27. package/dist/cli/invoke-command.js +1 -1
  28. package/dist/cli/managed-command-guard.js +2 -0
  29. package/dist/cli/model.js +20 -5
  30. package/dist/cli/provider-command.js +74 -13
  31. package/dist/cli/quota.js +89 -0
  32. package/dist/cli/role.js +62 -17
  33. package/dist/cli/services-command.js +1 -0
  34. package/dist/cli/stats.js +3 -3
  35. package/dist/cli/team-workspace-command.js +56 -2
  36. package/dist/cli/thread-command.js +16 -51
  37. package/dist/config/boot-log.js +3 -9
  38. package/dist/config/builtin-roles.js +5 -7
  39. package/dist/config/config-field-policy.js +71 -1
  40. package/dist/config/config-manager.js +13 -7
  41. package/dist/config/daemon-services.js +30 -3
  42. package/dist/config/gateway-config.js +2 -2
  43. package/dist/config/invoke-ipc-service.js +6 -4
  44. package/dist/config/peer-bind-code.js +3 -4
  45. package/dist/config/peer-book-store.js +62 -229
  46. package/dist/config/peer-book.js +26 -27
  47. package/dist/config/peer-role-resolver.js +16 -1
  48. package/dist/config/provider-identity-migration.js +4 -1
  49. package/dist/config/provider-ipc-service.js +56 -11
  50. package/dist/config/provider-menu-request.js +24 -5
  51. package/dist/config/provider-templates.js +127 -0
  52. package/dist/config/providers-config.js +67 -12
  53. package/dist/config/providers-management.js +477 -51
  54. package/dist/config/resolved-config-op.js +3 -2
  55. package/dist/config/role-command-service.js +248 -1
  56. package/dist/config/schema-migration.js +105 -4
  57. package/dist/core/agent-application-service.js +6 -1
  58. package/dist/core/agent-runtime.js +4 -0
  59. package/dist/core/auth/agent-delegation.js +2 -1
  60. package/dist/core/auth/auth-gateway.js +2 -1
  61. package/dist/core/auth/delegation-authorization.js +36 -26
  62. package/dist/core/auth/operation-authorizer.js +25 -0
  63. package/dist/core/auth/operation-catalog.js +37 -64
  64. package/dist/core/capability/providers/codex-capability-provider.js +7 -8
  65. package/dist/core/channel-loader.js +18 -0
  66. package/dist/core/command/agent-control.js +32 -0
  67. package/dist/core/command/cli-intent-parser.js +13 -0
  68. package/dist/core/command/command-handler.js +126 -87
  69. package/dist/core/command/menu-catalog.js +1 -0
  70. package/dist/core/command/menu-handler.js +67 -150
  71. package/dist/core/command/menu-protocol.js +31 -1
  72. package/dist/core/command/provider-menu.js +13 -3
  73. package/dist/core/command/remote-shell.js +565 -0
  74. package/dist/core/command/role-menu.js +47 -23
  75. package/dist/core/command/slash-handler.js +26 -43
  76. package/dist/core/command/team-workspace-items.js +81 -12
  77. package/dist/core/command/team-workspace-team.js +9 -71
  78. package/dist/core/command/topic-slash.js +9 -30
  79. package/dist/core/daemon-bootstrap.js +8 -1
  80. package/dist/core/daemon-control.js +64 -8
  81. package/dist/core/daemon-lifecycle.js +16 -2
  82. package/dist/core/evolagent-registry.js +20 -3
  83. package/dist/core/file-integrity/store.js +2 -0
  84. package/dist/core/handoff/runtime.js +37 -1
  85. package/dist/core/inference/text-inference.js +3 -1
  86. package/dist/core/initialization/service.js +11 -6
  87. package/dist/core/interaction-router.js +3 -0
  88. package/dist/core/invoke/executors/text.js +72 -19
  89. package/dist/core/ipc-registration.js +3 -1
  90. package/dist/core/message/aun-ipc-sender.js +279 -107
  91. package/dist/core/message/contact-admission.js +91 -6
  92. package/dist/core/message/contact-pending-inbound.js +113 -0
  93. package/dist/core/message/contact-thread-approval.js +212 -0
  94. package/dist/core/message/im-renderer.js +41 -2
  95. package/dist/core/message/message-admission.js +5 -39
  96. package/dist/core/message/message-bridge.js +140 -370
  97. package/dist/core/message/message-log.js +29 -0
  98. package/dist/core/message/message-queue.js +119 -15
  99. package/dist/core/message/message-utils.js +8 -0
  100. package/dist/core/message/response-engine.js +580 -134
  101. package/dist/core/message/send-routing.js +5 -1
  102. package/dist/core/model/catalog-service.js +31 -11
  103. package/dist/core/model/config-scope.js +6 -14
  104. package/dist/core/model/model-capabilities.js +22 -4
  105. package/dist/core/model/model-catalog.js +1 -0
  106. package/dist/core/model/model-diagnostics.js +19 -0
  107. package/dist/core/model/model-fallback.js +13 -2
  108. package/dist/core/ownership/owner-resolver.js +328 -50
  109. package/dist/core/pack-auth.js +3 -0
  110. package/dist/core/pack-install.js +1 -1
  111. package/dist/core/permission/ec-command-parser.js +106 -19
  112. package/dist/core/permission/protected-paths.js +6 -6
  113. package/dist/core/permission/services-path-acl.js +451 -0
  114. package/dist/core/permission/tool-policy.js +5 -1
  115. package/dist/core/relation/peer-identity.js +36 -1
  116. package/dist/core/relation/same-owner-proof.js +81 -112
  117. package/dist/core/session/adapters/codex-session-file-adapter.js +96 -15
  118. package/dist/core/session/session-file-health.js +13 -7
  119. package/dist/core/session/session-fs-store.js +91 -35
  120. package/dist/core/session/session-manager.js +68 -24
  121. package/dist/core/session/session-mapper.js +14 -34
  122. package/dist/core/session/session-transcript.js +5 -1
  123. package/dist/core/task/task-activity-store.js +84 -0
  124. package/dist/core/task/task-recovery-service.js +13 -0
  125. package/dist/core/thread/command-parser.js +7 -12
  126. package/dist/core/thread/thread-context-storage.js +3 -2
  127. package/dist/core/thread/thread-operation.js +2 -13
  128. package/dist/core/thread/thread-service.js +15 -46
  129. package/dist/core/thread/topic-id.js +15 -0
  130. package/dist/directory/owner-directory-admission.js +12 -9
  131. package/dist/directory/owner-directory-cache.js +64 -28
  132. package/dist/directory/owner-directory-markdown.js +14 -2
  133. package/dist/directory/owner-directory-policy.js +5 -30
  134. package/dist/directory/owner-directory-query-operation.js +29 -3
  135. package/dist/directory/owner-directory-remarks.js +11 -3
  136. package/dist/directory/owner-directory-request-operation.js +5 -2
  137. package/dist/eck/kit-renderer.js +1 -1
  138. package/dist/eck/message-renderer.js +112 -29
  139. package/dist/ecweb/basic-settings-service.js +3 -1
  140. package/dist/ecweb/message-context-service.js +1 -1
  141. package/dist/ecweb/pairing.js +4 -3
  142. package/dist/ecweb/providers-service.js +26 -1
  143. package/dist/ecweb/runtime/lifecycle.js +18 -8
  144. package/dist/ecweb/runtime/proxy-access.js +74 -0
  145. package/dist/ecweb/runtime/supervisor.js +36 -6
  146. package/dist/event-center/center-config.js +9 -5
  147. package/dist/event-center/dispatcher.js +10 -1
  148. package/dist/event-center/ipc-operation.js +19 -0
  149. package/dist/event-center/registry.js +29 -3
  150. package/dist/event-center/runtime.js +106 -11
  151. package/dist/event-center/script-runner.js +5 -5
  152. package/dist/index.js +96 -59
  153. package/dist/ipc.js +38 -3
  154. package/dist/outputs/authorization.js +16 -0
  155. package/dist/outputs/cards.js +336 -0
  156. package/dist/outputs/events.js +63 -0
  157. package/dist/outputs/protocol.js +103 -0
  158. package/dist/outputs/service.js +266 -0
  159. package/dist/paths.js +3 -0
  160. package/dist/proxy/manager.js +43 -13
  161. package/dist/services/index.js +114 -5
  162. package/dist/services/ipc-operation.js +88 -15
  163. package/dist/services/pack-manager.js +13 -1
  164. package/dist/services/router.js +21 -6
  165. package/dist/services/script-runner.js +5 -4
  166. package/dist/services/service-payload.js +13 -7
  167. package/dist/services/validation.js +1 -1
  168. package/dist/stats/budget.js +2 -2
  169. package/dist/stats/db.js +19 -0
  170. package/dist/stats/index.js +1 -1
  171. package/dist/stats/{price-resolver.js → model-resolver.js} +304 -23
  172. package/dist/stats/normalizer.js +2 -0
  173. package/dist/stats/query.js +35 -27
  174. package/dist/stats/quota-query.js +95 -0
  175. package/dist/stats/role-budget.js +5 -2
  176. package/dist/stats/writer.js +10 -6
  177. package/dist/trigger/audit.js +7 -0
  178. package/dist/trigger/authorization.js +105 -11
  179. package/dist/trigger/feedback.js +10 -0
  180. package/dist/trigger/history.js +37 -11
  181. package/dist/trigger/ipc-service.js +12 -1
  182. package/dist/trigger/manager.js +1 -0
  183. package/dist/trigger/scheduler.js +7 -5
  184. package/dist/trigger/script-executor.js +2 -1
  185. package/dist/trigger/script-sandbox.js +21 -3
  186. package/dist/trigger/validation.js +22 -0
  187. package/dist/utils/atomic-write.js +22 -8
  188. package/dist/utils/cross-platform.js +73 -26
  189. package/dist/utils/error-dict.json +94 -4
  190. package/dist/utils/error-utils.js +27 -4
  191. package/dist/utils/evolcore-version.js +36 -65
  192. package/dist/utils/host-info.js +100 -1
  193. package/dist/utils/msg-diag.js +1 -0
  194. package/dist/utils/npm-ops.js +43 -8
  195. package/dist/utils/process-introspect.js +12 -7
  196. package/dist/utils/process-tree.js +50 -2
  197. package/dist/utils/windows-shell-trust.js +2 -0
  198. package/dist/workbench/protocol.js +80 -0
  199. package/dist/workbench/service.js +359 -0
  200. package/ecagent/dist/types.d.ts +6 -2
  201. package/kits/docs/context-assembly.md +1 -1
  202. package/kits/docs/evolcore/INDEX.md +4 -2
  203. package/kits/docs/evolcore/aid.md +25 -0
  204. package/kits/docs/evolcore/config.md +16 -1
  205. package/kits/docs/evolcore/directory.md +30 -12
  206. package/kits/docs/evolcore/ecweb-lifecycle.md +15 -0
  207. package/kits/docs/evolcore/model.md +10 -0
  208. package/kits/docs/evolcore/msg.md +9 -0
  209. package/kits/docs/evolcore/peer.md +19 -65
  210. package/kits/docs/evolcore/provider.md +124 -4
  211. package/kits/docs/evolcore/quota.md +54 -0
  212. package/kits/docs/evolcore/role.md +83 -0
  213. package/kits/docs/evolcore/services.md +6 -6
  214. package/kits/docs/evolcore/stats.md +2 -0
  215. package/kits/docs/evolcore/team-workspace.md +1 -1
  216. package/kits/docs/evolcore/thread-chain.md +14 -15
  217. package/kits/docs/evolcore/tool-authorization.md +5 -0
  218. package/kits/docs/evolcore/trigger.md +12 -0
  219. package/kits/eck_message_manifest.json +12 -0
  220. package/kits/provider-templates.json +1213 -0
  221. package/kits/rules/04-relation.md +3 -3
  222. package/kits/schemas/_meta.json +14 -2
  223. package/kits/schemas/agent-config.schema.20.json +24 -0
  224. package/kits/schemas/contact-book.schema.4.json +52 -0
  225. package/kits/schemas/providers.schema.3.json +200 -0
  226. package/kits/skills/.switches.json +8 -0
  227. package/kits/skills/ability/references/calling.md +1 -1
  228. package/kits/skills/agent-output-cards/SKILL.md +57 -0
  229. package/kits/skills/ec-group/SKILL.md +2 -2
  230. package/kits/skills/ec-identity/SKILL.md +19 -72
  231. package/kits/skills/ec-provider/SKILL.md +270 -0
  232. package/kits/skills/ec-provider/scripts/check-model.mjs +80 -0
  233. package/kits/skills/ec-trigger/SKILL.md +1 -1
  234. package/kits/skills/thread-ops/SKILL.md +34 -21
  235. package/kits/templates/message-fragments/group-batch-item.md +1 -1
  236. package/kits/templates/message-fragments/group-batch.md +1 -1
  237. package/kits/templates/message-fragments/inject-default.md +1 -1
  238. package/kits/templates/message-fragments/interrupt-insert.md +1 -0
  239. package/kits/templates/message-fragments/item-group.md +1 -1
  240. package/kits/templates/message-fragments/item-private.md +1 -1
  241. package/kits/templates/message-fragments/thread-context.md +1 -1
  242. package/kits/templates/message-fragments/trigger-session.md +1 -1
  243. package/kits/templates/message-fragments/trigger-thread-check.md +1 -1
  244. package/kits/templates/roles/admin.json +2 -19
  245. package/kits/templates/roles/member.json +0 -3
  246. package/kits/templates/roles/visitor.json +1 -0
  247. package/kits/templates/system-fragments/baseagent.md +6 -0
  248. package/kits/templates/system-fragments/commands.md +4 -3
  249. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  250. package/kits/templates/system-fragments/managed-runtime.md +1 -1
  251. package/kits/templates/system-fragments/relation.md +1 -1
  252. package/kits/templates/system-fragments/thread.md +7 -5
  253. package/kits/templates/system-fragments/venue.md +11 -0
  254. package/package.json +6 -4
  255. package/scripts/agent-template/inspect.mjs +50 -11
  256. package/scripts/agent-template/shared/common.mjs +11 -6
  257. package/scripts/agent-template/shared/team-schema.json +6 -4
  258. package/scripts/agent-template/shared/template-contract.mjs +62 -11
  259. package/scripts/agent-template/shared/template-package.mjs +189 -21
  260. package/scripts/agent-template/shared/template-runtime.mjs +54 -6
  261. package/scripts/agent-template/shared/template.mjs +2 -2
  262. package/scripts/agent-template/team-pack.mjs +52 -14
  263. package/dist/cli/peer.js +0 -127
  264. package/dist/config/peer-operation-service.js +0 -132
  265. package/dist/config/peer-request-service.js +0 -532
  266. package/dist/core/command/connect-menu.js +0 -624
@@ -0,0 +1,565 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { createHash } from 'node:crypto';
3
+ import { StringDecoder } from 'node:string_decoder';
4
+ import { killProcessTree } from '../../utils/cross-platform.js';
5
+ import { logger } from '../../utils/logger.js';
6
+ import { auditCommandAuthorization, hashArgv } from '../auth/authorization-audit.js';
7
+ import { parseLiteralShellCommand } from '../permission/ec-command-parser.js';
8
+ import { checkBlacklist, checkDangerousCommand } from '../permission/tool-policy.js';
9
+ import { sanitizeMenuLogValue } from './menu-protocol.js';
10
+ export const REMOTE_SHELL_WINDOW_MS = 30 * 60_000;
11
+ export const REMOTE_SHELL_IDLE_MS = 6 * 60_000;
12
+ const OUTPUT_BUFFER_BYTES = 8 * 1024 * 1024;
13
+ const TEXT_CHUNK_BYTES = 16 * 1024 - 256; // Leave room for message and fragment headers.
14
+ /**
15
+ * argv execution only; spawn supports detached groups (execFile does not forward
16
+ * detached to spawn). Keep pipes attached so cancellation waits for descendants.
17
+ */
18
+ export function executeRemoteShellCommand(argv, cwd, remainingMs) {
19
+ const child = spawn(argv[0], argv.slice(1), {
20
+ shell: false, cwd, env: process.env, windowsHide: true,
21
+ detached: process.platform !== 'win32', stdio: ['pipe', 'pipe', 'pipe'],
22
+ });
23
+ let settled = false;
24
+ let termination;
25
+ let code;
26
+ const stdout = [];
27
+ const stderr = [];
28
+ const capture = (stream, output) => {
29
+ const decoder = new StringDecoder('utf8');
30
+ let bytes = 0;
31
+ stream.on('data', (buffer) => {
32
+ const available = Math.max(0, OUTPUT_BUFFER_BYTES - bytes);
33
+ output.push(decoder.write(buffer.subarray(0, available)));
34
+ bytes += buffer.length;
35
+ if (bytes > OUTPUT_BUFFER_BYTES && code !== 'OUTPUT_LIMIT') {
36
+ code = 'OUTPUT_LIMIT';
37
+ void terminate();
38
+ }
39
+ });
40
+ stream.on('end', () => {
41
+ // Discard an incomplete UTF-8 character at the truncation boundary.
42
+ if (bytes <= OUTPUT_BUFFER_BYTES)
43
+ output.push(decoder.end());
44
+ });
45
+ };
46
+ capture(child.stdout, stdout);
47
+ capture(child.stderr, stderr);
48
+ child.stdin.end();
49
+ const timer = setTimeout(() => { code = 'WINDOW_EXPIRED'; void terminate(); }, Math.max(1, remainingMs));
50
+ timer.unref();
51
+ const result = new Promise((resolve) => {
52
+ child.once('error', (error) => { code = error.code ?? 'SPAWN_FAILED'; });
53
+ child.once('close', (exitCode, signal) => {
54
+ settled = true;
55
+ clearTimeout(timer);
56
+ resolve({
57
+ stdout: stdout.join(''), stderr: stderr.join(''), exitCode,
58
+ ...(signal ? { signal } : {}), ...(code ? { code } : {}),
59
+ });
60
+ });
61
+ });
62
+ function terminate() {
63
+ if (termination)
64
+ return termination;
65
+ if (!child.pid || settled)
66
+ return result.then(() => undefined);
67
+ const targetPid = child.pid;
68
+ killProcessTree(targetPid);
69
+ termination = new Promise((resolve) => {
70
+ // Escalate the entire group even if the parent exits before its descendants.
71
+ setTimeout(() => { killProcessTree(targetPid, true); resolve(); }, 250);
72
+ }).then(() => result).then(() => undefined);
73
+ return termination;
74
+ }
75
+ return { result, terminate };
76
+ }
77
+ /** Owner-only text management, deliberately separate from delegated tool authorization. */
78
+ export class RemoteShellService {
79
+ deps;
80
+ leases = new Map();
81
+ requests = new Map();
82
+ now;
83
+ disposed = false;
84
+ order = 0;
85
+ transportEpoch = 0;
86
+ barriers = new Map();
87
+ constructor(deps) {
88
+ this.deps = deps;
89
+ this.now = deps.now ?? (() => performance.now());
90
+ }
91
+ handles(input) {
92
+ if (input.selfAID !== this.deps.controlAid || input.channelType !== 'aun'
93
+ || input.chatType !== 'private' || input.payloadType !== 'text' || this.disposed)
94
+ return false;
95
+ return /^\/exec(?:[ \t]|$)/.test(input.content)
96
+ || input.content.replace(/[ \t]+$/, '') === '/stop'
97
+ || this.leases.get(this.key(input))?.entered === true;
98
+ }
99
+ key(input) {
100
+ return JSON.stringify([
101
+ input.peerId, input.peerDeviceId, input.peerSlotId ?? '', input.threadId ?? input.replyContext?.threadId ?? '',
102
+ ]);
103
+ }
104
+ sameOwner(owner, expected) {
105
+ return owner?.aid === expected.aid && owner.relationVersion === expected.relationVersion;
106
+ }
107
+ valid(lease) {
108
+ return !this.disposed && !lease.closing && this.deps.connected()
109
+ && this.sameOwner(this.deps.currentOwner(), lease.owner)
110
+ && this.now() < lease.deadline && (!!lease.running || this.now() < lease.idleDeadline);
111
+ }
112
+ async handleText(input) {
113
+ if (!this.handles(input) || this.disposed)
114
+ return;
115
+ if (!input.encrypted) {
116
+ this.audit(input, 'reject', 'E2EE_REQUIRED');
117
+ let owner;
118
+ try {
119
+ owner = await this.deps.refreshOwner();
120
+ }
121
+ catch {
122
+ this.audit(input, 'reject', 'OWNER_UNAVAILABLE');
123
+ return;
124
+ }
125
+ // Explain the rejection only to the verified Owner's authenticated device.
126
+ // The control sender forces E2EE even though the incoming request was plaintext.
127
+ if (owner?.aid === input.peerId && input.peerDeviceId && input.messageId) {
128
+ try {
129
+ await this.send(input, 'E2EE_REQUIRED: 请在与 daemon AID 的私聊中开启端到端加密后重发 /exec 指令。此次请求未执行。', owner);
130
+ }
131
+ catch {
132
+ this.audit(input, 'delivery', 'DELIVERY_FAILED');
133
+ }
134
+ }
135
+ return;
136
+ }
137
+ const key = this.key(input);
138
+ const transportEpoch = this.transportEpoch;
139
+ const order = ++this.order;
140
+ const receivedLease = this.leases.get(key);
141
+ const prefixed = /^\/exec(?:[ \t]|$)/.test(input.content);
142
+ const command = prefixed ? input.content.slice(5).replace(/^[ \t]+/, '') : input.content;
143
+ // Bare /exec queries status; raw on/off/status/stop remain executable names.
144
+ const control = prefixed ? command.replace(/[ \t]+$/, '')
145
+ : input.content.replace(/[ \t]+$/, '') === '/stop' ? 'stop' : undefined;
146
+ const query = prefixed && control === '';
147
+ const requestKey = JSON.stringify([key, input.messageId]);
148
+ const fingerprint = createHash('sha256').update(input.content).digest('hex');
149
+ const previous = this.requests.get(requestKey);
150
+ const record = { fingerprint, state: 'pending', replies: [], bytes: 0 };
151
+ if (!previous && input.messageId && input.peerDeviceId) {
152
+ this.requests.set(requestKey, record);
153
+ this.releaseResultCaches();
154
+ }
155
+ let knownOwner = false;
156
+ try {
157
+ const owner = await this.deps.refreshOwner();
158
+ if (!owner)
159
+ throw new Error('OWNER_UNAVAILABLE');
160
+ if (owner.aid !== input.peerId)
161
+ throw new Error('DAEMON_OWNER_REQUIRED');
162
+ knownOwner = true;
163
+ record.owner = owner;
164
+ if (!input.peerDeviceId)
165
+ throw new Error('DEVICE_ID_REQUIRED');
166
+ if (!input.messageId)
167
+ throw new Error('MESSAGE_ID_REQUIRED');
168
+ if (this.disposed || !this.deps.connected() || transportEpoch !== this.transportEpoch
169
+ || !this.sameOwner(this.deps.currentOwner(), owner))
170
+ throw new Error('REMOTE_SHELL_CLOSED');
171
+ if (previous) {
172
+ if (previous.fingerprint !== fingerprint) {
173
+ await this.reply(input, record, 'CONFLICT: 消息 ID 对应不同内容。');
174
+ }
175
+ else {
176
+ if (previous.owner && !this.sameOwner(owner, previous.owner))
177
+ throw new Error('REMOTE_SHELL_CLOSED');
178
+ const lease = this.leases.get(key);
179
+ const replies = query || control === 'on' || control === 'off' || control === 'stop'
180
+ ? [this.status(lease)] : previous.state === 'pending' ? ['命令已接收,正在处理。']
181
+ : previous.replies.length ? previous.replies : ['命令已处理,结果缓存已释放,不会重复执行。'];
182
+ for (const text of replies)
183
+ await this.send(input, text, owner);
184
+ }
185
+ return;
186
+ }
187
+ let lease = this.leases.get(key);
188
+ if (lease && !lease.closing && !this.valid(lease)) {
189
+ const reason = !this.sameOwner(this.deps.currentOwner(), lease.owner) ? 'owner-changed'
190
+ : this.now() >= lease.deadline ? 'expired' : 'idle';
191
+ await this.close(key, lease, reason);
192
+ lease = this.leases.get(key);
193
+ }
194
+ if (control === 'on') {
195
+ if ((this.barriers.get(key) ?? 0) > order)
196
+ throw new Error('CANCELLED');
197
+ if (!lease) {
198
+ // No await after the verified identity: on/off cannot interleave creation here.
199
+ if (!this.sameOwner(this.deps.currentOwner(), owner) || !this.deps.connected() || this.disposed
200
+ || transportEpoch !== this.transportEpoch) {
201
+ throw new Error('OWNER_UNAVAILABLE');
202
+ }
203
+ lease = {
204
+ owner, input, openedOrder: order, cwd: this.deps.cwd ?? process.cwd(), queue: [],
205
+ deadline: this.now() + (this.deps.windowMs ?? REMOTE_SHELL_WINDOW_MS),
206
+ idleDeadline: this.now() + (this.deps.idleMs ?? REMOTE_SHELL_IDLE_MS),
207
+ };
208
+ this.leases.set(key, lease);
209
+ this.arm(key, lease);
210
+ this.audit(input, 'on');
211
+ const opened = lease;
212
+ opened.entry = this.notice(input, `已进入终端操作状态。\n${this.status(opened)}\n可直接发送单条命令;/stop 或 /exec stop 取消执行,/exec off 退出。`, 'remote-shell.entered', owner).then(delivered => {
213
+ opened.entered = delivered;
214
+ return delivered;
215
+ });
216
+ try {
217
+ const delivered = await opened.entry;
218
+ if (!delivered || this.leases.get(key) !== opened || !this.valid(opened)) {
219
+ throw new Error('REMOTE_SHELL_CLOSED');
220
+ }
221
+ }
222
+ catch (error) {
223
+ await this.close(key, opened, 'entry-failed');
224
+ throw error;
225
+ }
226
+ }
227
+ else {
228
+ if (lease.entry && !lease.closing)
229
+ await lease.entry;
230
+ await this.reply(input, record, this.status(lease));
231
+ }
232
+ }
233
+ else if (control === 'off' || control === 'stop') {
234
+ this.barriers.set(key, Math.max(this.barriers.get(key) ?? 0, order));
235
+ if (lease && lease.openedOrder <= order) {
236
+ if (control === 'off')
237
+ await this.close(key, lease, 'manual');
238
+ else
239
+ await this.cancel(key, lease);
240
+ }
241
+ this.audit(input, control);
242
+ if (control === 'stop' || !lease) {
243
+ await this.reply(input, record, control === 'stop' && lease && !lease.closing
244
+ ? '当前执行已取消,仍处于终端操作状态。' : this.status(this.leases.get(key)));
245
+ }
246
+ }
247
+ else if (query) {
248
+ await this.reply(input, record, this.status(lease));
249
+ }
250
+ else {
251
+ if (!command.trim())
252
+ throw new Error('INVALID_ARGUMENT');
253
+ if (!lease || lease !== receivedLease || !this.valid(lease) || lease.stopping
254
+ || (this.barriers.get(key) ?? 0) > order)
255
+ throw new Error('REMOTE_SHELL_CLOSED');
256
+ // Keep the original text intact: structural newlines must reach the literal parser.
257
+ lease.queue.push({ input, record, command });
258
+ this.pump(key, lease);
259
+ return;
260
+ }
261
+ record.state = 'done';
262
+ }
263
+ catch (error) {
264
+ const message = error instanceof Error ? error.message : '';
265
+ const code = /^[A-Z][A-Z_]+$/.test(message) ? message : 'REMOTE_SHELL_FAILED';
266
+ record.state = 'done';
267
+ if (code === 'DELIVERY_FAILED') {
268
+ this.audit(input, 'delivery', code);
269
+ return;
270
+ }
271
+ this.audit(input, 'reject', code);
272
+ if (!knownOwner && this.requests.get(requestKey) === record)
273
+ this.requests.delete(requestKey);
274
+ if (knownOwner) {
275
+ try {
276
+ await this.reply(input, record, `${code}: 未执行。`);
277
+ }
278
+ catch {
279
+ this.audit(input, 'delivery', 'DELIVERY_FAILED');
280
+ }
281
+ }
282
+ }
283
+ }
284
+ status(lease) {
285
+ if (!lease || (!lease.closing && !this.valid(lease)))
286
+ return '已关闭。';
287
+ if (lease.closing)
288
+ return '正在关闭,等待所属进程退出。';
289
+ if (lease.entry && !lease.entered)
290
+ return '正在进入终端操作状态,等待提示投递。';
291
+ const remaining = Math.max(0, Math.ceil((lease.deadline - this.now()) / 1000));
292
+ const idle = Math.ceil((this.deps.idleMs ?? REMOTE_SHELL_IDLE_MS) / 60_000);
293
+ return `已开启,剩余 ${remaining} 秒,空闲 ${idle} 分钟后关闭。`
294
+ + (lease.running ? `\n正在执行 message_id=${lease.running.task.input.messageId}` : '\n当前无命令运行。')
295
+ + (lease.queue.length ? `\n排队 ${lease.queue.length} 条。` : '');
296
+ }
297
+ arm(key, lease) {
298
+ if (lease.timer)
299
+ clearTimeout(lease.timer);
300
+ if (lease.closing)
301
+ return;
302
+ const expiry = Math.min(lease.running ? lease.deadline : Math.min(lease.deadline, lease.idleDeadline), this.now() + (this.deps.currentOwner()?.validForMs ?? Infinity));
303
+ lease.timer = setTimeout(() => {
304
+ if (this.leases.get(key) !== lease)
305
+ return;
306
+ if (!this.sameOwner(this.deps.currentOwner(), lease.owner)) {
307
+ void this.close(key, lease, 'owner-unavailable');
308
+ }
309
+ else if (this.now() >= lease.deadline) {
310
+ void this.close(key, lease, 'expired');
311
+ }
312
+ else if (!lease.running && this.now() >= lease.idleDeadline) {
313
+ void this.close(key, lease, 'idle');
314
+ }
315
+ else
316
+ this.arm(key, lease); // Ownership evidence may have been refreshed.
317
+ }, Math.max(1, expiry - this.now()));
318
+ lease.timer.unref();
319
+ }
320
+ pump(key, lease) {
321
+ if (lease.running || lease.closing || lease.stopping)
322
+ return;
323
+ const task = lease.queue.shift();
324
+ if (!task) {
325
+ this.arm(key, lease);
326
+ return;
327
+ }
328
+ // Register running before awaiting ownership, so stop/off can cancel pre-start tasks.
329
+ const running = { task, done: Promise.resolve() };
330
+ lease.running = running;
331
+ this.arm(key, lease);
332
+ running.done = this.run(key, lease, running).catch(error => {
333
+ logger.warn(`[RemoteShell] command delivery failed: ${error instanceof Error ? error.message : String(error)}`);
334
+ this.audit(task.input, 'delivery', 'DELIVERY_FAILED');
335
+ }).finally(() => {
336
+ task.record.state = 'done';
337
+ if (lease.running === running)
338
+ lease.running = undefined;
339
+ // Rejected input and status queries must not keep an unused window alive.
340
+ if (running.completedAt !== undefined) {
341
+ lease.idleDeadline = running.completedAt + (this.deps.idleMs ?? REMOTE_SHELL_IDLE_MS);
342
+ }
343
+ if (this.leases.get(key) === lease && !lease.closing && !lease.stopping)
344
+ this.pump(key, lease);
345
+ });
346
+ }
347
+ async run(key, lease, running) {
348
+ const { task } = running;
349
+ let owner;
350
+ try {
351
+ owner = await this.deps.refreshOwner();
352
+ }
353
+ catch { /* No valid evidence means no execution. */ }
354
+ if (this.leases.get(key) !== lease || !this.valid(lease) || task.cancelled
355
+ || !this.sameOwner(owner, lease.owner)) {
356
+ this.audit(task.input, 'reject', task.cancelled ?? 'REMOTE_SHELL_CLOSED');
357
+ await this.reply(task.input, task.record, `${task.cancelled ?? 'REMOTE_SHELL_CLOSED'}: 未启动命令。`);
358
+ return;
359
+ }
360
+ const parsed = parseLiteralShellCommand(task.command, { dialect: process.platform === 'win32' ? 'cmd' : 'posix' });
361
+ if (!parsed.ok) {
362
+ this.audit(task.input, 'reject', 'SHELL_COMPOSITION_NOT_ALLOWED');
363
+ await this.reply(task.input, task.record, `SHELL_COMPOSITION_NOT_ALLOWED: ${parsed.issue}`);
364
+ return;
365
+ }
366
+ const blacklist = checkBlacklist('Bash', { command: task.command });
367
+ const danger = checkDangerousCommand('Bash', { command: task.command });
368
+ if (blacklist.behavior === 'deny' || danger.isDangerous) {
369
+ const kind = danger.isDangerous ? danger.kind : 'forbidden';
370
+ this.audit(task.input, 'reject', 'DANGEROUS_COMMAND_BLOCKED', parsed.argv, kind);
371
+ await this.reply(task.input, task.record, `DANGEROUS_COMMAND_BLOCKED: ${kind}`);
372
+ return;
373
+ }
374
+ const started = this.now();
375
+ this.audit(task.input, 'start', undefined, parsed.argv, undefined, undefined, undefined, lease.cwd);
376
+ let result;
377
+ try {
378
+ running.execution = (this.deps.execute ?? executeRemoteShellCommand)(parsed.argv, lease.cwd, lease.deadline - this.now());
379
+ result = await running.execution.result;
380
+ if (result.code === 'OUTPUT_LIMIT' || result.code === 'WINDOW_EXPIRED')
381
+ await running.execution.terminate();
382
+ }
383
+ catch {
384
+ result = { stdout: '', stderr: '', exitCode: null, code: 'SPAWN_FAILED' };
385
+ }
386
+ running.completedAt = this.now();
387
+ const code = task.cancelled ?? result.code;
388
+ this.audit(task.input, 'finish', code, parsed.argv, undefined, result.exitCode, this.now() - started, lease.cwd, result.signal);
389
+ const heading = `执行结果 · message_id=${task.input.messageId}\nexitCode: ${result.exitCode ?? 'null'}`
390
+ + (result.signal ? `\nsignal: ${result.signal}` : '') + (code ? `\ncode: ${code}` : '');
391
+ for (const [name, output] of [['stdout', result.stdout], ['stderr', result.stderr]]) {
392
+ if (!output)
393
+ continue;
394
+ const chunks = this.chunks(output);
395
+ for (let i = 0; i < chunks.length; i++) {
396
+ await this.reply(task.input, task.record, `message_id=${task.input.messageId} ${name} ${i + 1}/${chunks.length}\n${chunks[i]}`);
397
+ }
398
+ }
399
+ await this.reply(task.input, task.record, heading);
400
+ }
401
+ chunks(text) {
402
+ const chunks = [];
403
+ let chunk = '';
404
+ let bytes = 0;
405
+ for (const character of text) {
406
+ const size = Buffer.byteLength(character);
407
+ if (bytes + size > TEXT_CHUNK_BYTES) {
408
+ chunks.push(chunk);
409
+ chunk = '';
410
+ bytes = 0;
411
+ }
412
+ chunk += character;
413
+ bytes += size;
414
+ }
415
+ if (chunk)
416
+ chunks.push(chunk);
417
+ return chunks;
418
+ }
419
+ canSend(input, expectedOwner) {
420
+ const owner = this.deps.currentOwner();
421
+ return this.deps.connected() && owner?.aid === input.peerId && !this.disposed
422
+ && (!expectedOwner || this.sameOwner(owner, expectedOwner));
423
+ }
424
+ async send(input, text, expectedOwner) {
425
+ if (!this.canSend(input, expectedOwner))
426
+ return;
427
+ try {
428
+ await this.deps.send(input, text);
429
+ }
430
+ catch {
431
+ throw new Error('DELIVERY_FAILED');
432
+ }
433
+ }
434
+ async notice(input, text, subtype, owner) {
435
+ if (!this.canSend(input, owner))
436
+ return false;
437
+ try {
438
+ await this.deps.notice(input, text, subtype);
439
+ }
440
+ catch {
441
+ throw new Error('DELIVERY_FAILED');
442
+ }
443
+ return true;
444
+ }
445
+ async reply(input, record, text) {
446
+ // Keep bounded replay text; the request fingerprint remains even when output is released.
447
+ if (record.bytes + Buffer.byteLength(text) <= 128 * 1024) {
448
+ record.replies.push(text);
449
+ record.bytes += Buffer.byteLength(text);
450
+ }
451
+ else {
452
+ record.replies = [];
453
+ record.bytes = 128 * 1024 + 1;
454
+ }
455
+ await this.send(input, text, record.owner);
456
+ }
457
+ releaseResultCaches() {
458
+ // Retain fingerprints across off/on; release old text without ever rerunning a request.
459
+ if (this.requests.size <= 100)
460
+ return;
461
+ const old = [...this.requests.values()].slice(0, -100);
462
+ for (const record of old) {
463
+ record.replies = [];
464
+ record.bytes = 128 * 1024 + 1;
465
+ }
466
+ }
467
+ cancel(key, lease) {
468
+ if (lease.cancellation)
469
+ return lease.cancellation;
470
+ lease.stopping = true;
471
+ const queued = lease.queue.splice(0);
472
+ for (const task of queued) {
473
+ task.cancelled = 'CANCELLED';
474
+ task.record.state = 'done';
475
+ this.audit(task.input, 'reject', 'CANCELLED');
476
+ }
477
+ const running = lease.running;
478
+ if (running)
479
+ running.task.cancelled = lease.closing === 'expired' ? 'WINDOW_EXPIRED' : 'CANCELLED';
480
+ lease.cancellation = (async () => {
481
+ // Delivery errors must never prevent process termination or queue cleanup.
482
+ if (running) {
483
+ await running.execution?.terminate();
484
+ await running.done;
485
+ }
486
+ for (const task of queued) {
487
+ try {
488
+ await this.reply(task.input, task.record, `CANCELLED: message_id=${task.input.messageId} 未启动。`);
489
+ }
490
+ catch {
491
+ this.audit(task.input, 'delivery', 'DELIVERY_FAILED');
492
+ }
493
+ }
494
+ lease.stopping = false;
495
+ if (!lease.closing && this.leases.get(key) === lease)
496
+ this.arm(key, lease);
497
+ })().finally(() => { lease.cancellation = undefined; });
498
+ return lease.cancellation;
499
+ }
500
+ close(key, lease, reason) {
501
+ if (lease.closure)
502
+ return lease.closure;
503
+ if (this.leases.get(key) !== lease)
504
+ return Promise.resolve();
505
+ lease.closing = reason;
506
+ if (lease.timer)
507
+ clearTimeout(lease.timer);
508
+ this.audit(lease.input, 'close', undefined, undefined, reason);
509
+ lease.closure = this.cancel(key, lease).then(async () => {
510
+ // An off racing the entry notice must send its exit notice after entry delivery.
511
+ await lease.entry?.catch(() => false);
512
+ if (lease.entered) {
513
+ const text = reason === 'idle' ? '空闲超时,已退出终端操作状态。'
514
+ : reason === 'expired' ? '终端窗口已到期,已退出终端操作状态。' : '已退出终端操作状态。';
515
+ try {
516
+ await this.notice(lease.input, text, 'remote-shell.exited', lease.owner);
517
+ }
518
+ catch {
519
+ this.audit(lease.input, 'delivery', 'DELIVERY_FAILED');
520
+ }
521
+ }
522
+ if (this.leases.get(key) === lease)
523
+ this.leases.delete(key);
524
+ });
525
+ return lease.closure;
526
+ }
527
+ async closeAll(reason) {
528
+ // Also invalidate on requests still awaiting authentication during a disconnect.
529
+ this.transportEpoch++;
530
+ await Promise.all([...this.leases].map(([key, lease]) => this.close(key, lease, reason)));
531
+ }
532
+ /** Called on Ownership updates, including validity expiry without an Owner change. */
533
+ revalidateOwner() {
534
+ for (const [key, lease] of this.leases) {
535
+ if (!this.sameOwner(this.deps.currentOwner(), lease.owner)) {
536
+ void this.close(key, lease, 'owner-changed');
537
+ }
538
+ else
539
+ this.arm(key, lease);
540
+ }
541
+ }
542
+ async dispose() {
543
+ this.disposed = true;
544
+ await this.closeAll('shutdown');
545
+ this.requests.clear();
546
+ }
547
+ audit(input, action, code, argv, rule, exitCode, durationMs, cwd, signal) {
548
+ const failed = !!code || !!signal || (exitCode !== undefined && exitCode !== 0);
549
+ (this.deps.audit ?? auditCommandAuthorization)({
550
+ ts: Date.now(), source: 'control', operation: 'remote-shell.exec', scope: 'process', dangerous: true,
551
+ actorId: input.peerId, selfAid: this.deps.controlAid, channel: 'control', channelId: input.peerId,
552
+ role: 'none', processRole: this.deps.currentOwner()?.aid === input.peerId ? 'daemon-owner' : 'none',
553
+ isDaemonOwner: this.deps.currentOwner()?.aid === input.peerId, fromControlChannel: true,
554
+ requestId: input.messageId, messageId: input.messageId, action, name: 'remote-shell',
555
+ eventPhase: action, decisionSource: 'command', decision: code && action === 'reject' ? 'deny' : 'allow',
556
+ executed: action === 'start' || action === 'finish',
557
+ executionState: action === 'reject' ? 'blocked' : action === 'delivery' ? 'failed'
558
+ : action === 'finish' ? failed ? 'failed' : 'completed' : 'authorized',
559
+ ...(argv ? { args: sanitizeMenuLogValue({ argv }), argvHash: hashArgv(argv) } : {}),
560
+ argsSummary: { deviceId: input.peerDeviceId, slotId: input.peerSlotId, cwd, signal,
561
+ ...(action === 'close' ? { closeReason: rule } : {}) },
562
+ matchedRule: rule, code, ...(exitCode != null ? { exitCode } : {}), durationMs,
563
+ });
564
+ }
565
+ }