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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (197) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/bin/ecmsg.js +171 -54
  3. package/dist/agents/baseagent-availability.js +1 -1
  4. package/dist/agents/codex/app-server-client.js +22 -0
  5. package/dist/agents/codex-runner.js +69 -2
  6. package/dist/aun/msg/p2p.js +6 -1
  7. package/dist/channels/aun.js +234 -21
  8. package/dist/cli/agent-create.js +2 -2
  9. package/dist/cli/daemon-commands.js +6 -66
  10. package/dist/cli/daemon-lifecycle-client.js +61 -0
  11. package/dist/cli/ecmsg-gateway.js +35 -2
  12. package/dist/cli/events-command.js +73 -0
  13. package/dist/cli/index.js +31 -14
  14. package/dist/cli/invoke-command.js +182 -0
  15. package/dist/cli/managed-command-guard.js +6 -1
  16. package/dist/cli/restart-monitor.js +45 -47
  17. package/dist/cli/services-command.js +111 -0
  18. package/dist/cli/team-workspace-command.js +134 -0
  19. package/dist/cli/thread-command.js +6 -2
  20. package/dist/cli/watch-msg.js +1 -1
  21. package/dist/config/config-field-policy.js +2 -2
  22. package/dist/config/config-manager.js +0 -7
  23. package/dist/config/invoke-ipc-service.js +118 -0
  24. package/dist/config/schema-migration.js +6 -1
  25. package/dist/config-store.js +2 -1
  26. package/dist/core/agent-reload-coordinator.js +6 -4
  27. package/dist/core/agent-runtime.js +104 -10
  28. package/dist/core/auth/delegation-authorization.js +66 -0
  29. package/dist/core/auth/operation-catalog.js +20 -0
  30. package/dist/core/baseagent-loader.js +60 -130
  31. package/dist/core/channel-loader.js +10 -1
  32. package/dist/core/channel-runtime.js +4 -3
  33. package/dist/core/command/agent-control.js +1 -1
  34. package/dist/core/command/agent-storage-menu.js +1 -1
  35. package/dist/core/command/chatmode-config.js +2 -36
  36. package/dist/core/command/command-handler.js +53 -11
  37. package/dist/core/command/data-root-resolver.js +32 -23
  38. package/dist/core/command/eventcenter-menu.js +338 -0
  39. package/dist/core/command/menu-catalog.js +8 -0
  40. package/dist/core/command/menu-handler.js +198 -84
  41. package/dist/core/command/menu-protocol.js +60 -11
  42. package/dist/core/command/menu-query-batch.js +194 -0
  43. package/dist/core/command/slash-gate.js +1 -1
  44. package/dist/core/command/slash-handler.js +34 -42
  45. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  46. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  47. package/dist/core/command/team-workspace-initializer.js +2 -0
  48. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  49. package/dist/core/command/team-workspace-job-store.js +88 -0
  50. package/dist/core/command/team-workspace-management-service.js +2 -0
  51. package/dist/core/command/team-workspace-management-store.js +96 -0
  52. package/dist/core/command/team-workspace-management.js +265 -0
  53. package/dist/core/command/team-workspace-members-menu.js +88 -0
  54. package/dist/core/command/team-workspace-store.js +612 -0
  55. package/dist/core/command/team-workspace-team.js +193 -0
  56. package/dist/core/daemon-control.js +8 -5
  57. package/dist/core/daemon-lifecycle.js +132 -73
  58. package/dist/core/handoff/runtime.js +3 -3
  59. package/dist/core/invoke/executors/index.js +13 -0
  60. package/dist/core/invoke/executors/media.js +283 -0
  61. package/dist/core/invoke/executors/text.js +198 -0
  62. package/dist/core/invoke/invoke-service.js +157 -0
  63. package/dist/core/invoke/style-router.js +48 -0
  64. package/dist/core/invoke/types.js +19 -0
  65. package/dist/core/ipc-registration.js +46 -7
  66. package/dist/core/memory/consolidation.js +7 -5
  67. package/dist/core/message/aun-ipc-sender.js +147 -17
  68. package/dist/core/message/im-renderer.js +28 -84
  69. package/dist/core/message/message-bridge.js +4 -0
  70. package/dist/core/message/message-utils.js +10 -2
  71. package/dist/core/message/peer-mode.js +7 -34
  72. package/dist/core/message/response-engine.js +157 -54
  73. package/dist/core/message/send-options.js +7 -4
  74. package/dist/core/message/send-routing.js +43 -5
  75. package/dist/core/ownership/owner-resolver.js +7 -0
  76. package/dist/core/permission/ec-command-parser.js +3 -2
  77. package/dist/core/permission/protected-paths.js +12 -2
  78. package/dist/core/permission/shell-environment.js +9 -0
  79. package/dist/core/session/session-file-health.js +243 -0
  80. package/dist/core/session/session-fs-store.js +2 -3
  81. package/dist/core/task/task-recovery-service.js +13 -2
  82. package/dist/core/thread/command-parser.js +9 -2
  83. package/dist/core/thread/thread-operation.js +21 -2
  84. package/dist/core/thread/thread-route.js +13 -2
  85. package/dist/directory/owner-directory-admission.js +40 -53
  86. package/dist/directory/owner-directory-cache.js +89 -113
  87. package/dist/directory/owner-directory-query-operation.js +8 -10
  88. package/dist/eck/kit-renderer.js +7 -5
  89. package/dist/ecweb/basic-settings-service.js +1 -1
  90. package/dist/ecweb/message-context-service.js +0 -4
  91. package/dist/ecweb/runtime/lifecycle.js +6 -2
  92. package/dist/ecweb/runtime/supervisor.js +19 -4
  93. package/dist/event-center/admission-materializer.js +114 -0
  94. package/dist/event-center/bus-gate.js +136 -0
  95. package/dist/event-center/bus-host.js +290 -0
  96. package/dist/event-center/bus-resolver.js +120 -0
  97. package/dist/event-center/center-config.js +100 -0
  98. package/dist/event-center/client-factory.js +50 -0
  99. package/dist/event-center/daemon.js +45 -0
  100. package/dist/event-center/directory-source.js +53 -0
  101. package/dist/event-center/dispatcher.js +157 -0
  102. package/dist/event-center/event-log.js +110 -0
  103. package/dist/event-center/index-generator.js +63 -0
  104. package/dist/event-center/ipc-operation.js +308 -0
  105. package/dist/event-center/ledger.js +52 -0
  106. package/dist/event-center/pack-loader.js +202 -0
  107. package/dist/event-center/pack-manager.js +85 -0
  108. package/dist/event-center/registry.js +238 -0
  109. package/dist/event-center/runtime.js +641 -0
  110. package/dist/event-center/script-runner.js +356 -0
  111. package/dist/event-center/types.js +35 -0
  112. package/dist/event-center/validation.js +413 -0
  113. package/dist/index.js +285 -99
  114. package/dist/ipc.js +66 -12
  115. package/dist/paths.js +20 -0
  116. package/dist/product.js +14 -0
  117. package/dist/proxy/manager.js +5 -1
  118. package/dist/proxy/service-supervisor.js +13 -4
  119. package/dist/response-system/engines/v1/index.js +0 -1
  120. package/dist/response-system/modes/single-session/index.js +1 -1
  121. package/dist/services/dispatcher.js +100 -0
  122. package/dist/services/idempotency.js +90 -0
  123. package/dist/services/identity.js +52 -0
  124. package/dist/services/index-generator.js +70 -0
  125. package/dist/services/index.js +449 -0
  126. package/dist/services/ipc-operation.js +458 -0
  127. package/dist/services/ledger.js +52 -0
  128. package/dist/services/message-log.js +112 -0
  129. package/dist/services/pack-manager.js +204 -0
  130. package/dist/services/reply.js +55 -0
  131. package/dist/services/router.js +95 -0
  132. package/dist/services/script-runner.js +422 -0
  133. package/dist/services/service-payload.js +70 -0
  134. package/dist/services/types.js +18 -0
  135. package/dist/services/validation.js +297 -0
  136. package/dist/trigger/application-service.js +18 -0
  137. package/dist/trigger/event-source.js +1 -1
  138. package/dist/trigger/ipc-service.js +3 -1
  139. package/dist/trigger/script-sandbox.js +118 -22
  140. package/dist/utils/cross-platform.js +24 -10
  141. package/dist/utils/evolcore-version.js +69 -27
  142. package/dist/utils/instance-registry.js +19 -13
  143. package/dist/utils/process-introspect.js +45 -9
  144. package/dist/utils/startup-trace.js +74 -37
  145. package/dist/utils/windows-shell-trust.js +80 -6
  146. package/kits/docs/INDEX.md +2 -2
  147. package/kits/docs/aun/ABILITY_CALLING.md +7 -14
  148. package/kits/docs/context-assembly.md +1 -1
  149. package/kits/docs/evolcore/INDEX.md +2 -0
  150. package/kits/docs/evolcore/ability.md +4 -0
  151. package/kits/docs/evolcore/aid.md +1 -1
  152. package/kits/docs/evolcore/event-center.md +207 -0
  153. package/kits/docs/evolcore/file-navigation.md +10 -264
  154. package/kits/docs/evolcore/fs.md +3 -2
  155. package/kits/docs/evolcore/group.md +1 -1
  156. package/kits/docs/evolcore/memory-architecture.md +2 -0
  157. package/kits/docs/evolcore/menu-protocol.md +21 -0
  158. package/kits/docs/evolcore/msg.md +15 -3
  159. package/kits/docs/evolcore/provider.md +3 -1
  160. package/kits/docs/evolcore/response.md +5 -5
  161. package/kits/docs/evolcore/services.md +277 -0
  162. package/kits/docs/evolcore/task.md +2 -0
  163. package/kits/docs/evolcore/team-workspace.md +41 -0
  164. package/kits/eck_manifest.json +26 -0
  165. package/kits/rules/02-navigation.md +10 -1
  166. package/kits/schemas/_meta.json +17 -6
  167. package/kits/schemas/agent-config.schema.19.json +5 -7
  168. package/kits/schemas/agent-config.schema.20.json +936 -0
  169. package/kits/schemas/relation-config.schema.12.json +2 -3
  170. package/kits/schemas/role-config.schema.2.json +4 -4
  171. package/kits/skills/.switches.json +1 -5
  172. package/kits/skills/ability/SKILL.md +56 -0
  173. package/kits/skills/ability/references/calling.md +56 -0
  174. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  175. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  176. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  177. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  178. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  179. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  180. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  181. package/kits/skills/personal-assistant/SKILL.md +6 -6
  182. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  183. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  184. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  185. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  186. package/kits/templates/system-fragments/channel.md +3 -3
  187. package/kits/templates/system-fragments/commands.md +5 -3
  188. package/kits/templates/system-fragments/reply.md +0 -5
  189. package/kits/templates/system-fragments/thread.md +10 -8
  190. package/package.json +3 -5
  191. package/dist/cli/pa-workspace-command.js +0 -225
  192. package/dist/core/command/pa-workspace-store.js +0 -468
  193. package/dist/core/relation/pa-team.js +0 -132
  194. package/kits/docs/evolcore/pa-workspace.md +0 -51
  195. package/kits/skills/aid-ability/SKILL.md +0 -244
  196. package/kits/skills/ec-ability/SKILL.md +0 -67
  197. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -0,0 +1,283 @@
1
+ /**
2
+ * 多模态内置执行器:openai-images / openai-audio(speech|transcribe) / openai-embeddings。
3
+ *
4
+ * 设计见 `docs/model-intent/invoke-design.md` 第十节。
5
+ *
6
+ * 产物统一归一成 `InvokeArtifact`:端点返回 URL、返回 base64、还是直接回二进制,
7
+ * 调用方看到的都是同一个结构。落盘位置**只由调用方的 `--out` 决定**,
8
+ * 执行器不自己挑路径。
9
+ */
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+ import { appendRequestPath, appendRequestQueryParams } from '../../../agents/request-identity.js';
13
+ import { InvokeError } from '../types.js';
14
+ const MIME_EXTENSION = {
15
+ 'image/png': '.png',
16
+ 'image/jpeg': '.jpg',
17
+ 'image/webp': '.webp',
18
+ 'image/gif': '.gif',
19
+ 'audio/mpeg': '.mp3',
20
+ 'audio/wav': '.wav',
21
+ 'audio/opus': '.opus',
22
+ 'audio/aac': '.aac',
23
+ 'audio/flac': '.flac',
24
+ 'video/mp4': '.mp4',
25
+ 'application/json': '.json',
26
+ };
27
+ function extensionFor(mimeType, fallback) {
28
+ return (mimeType && MIME_EXTENSION[mimeType]) ?? fallback;
29
+ }
30
+ function asRecord(value) {
31
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
32
+ throw new InvokeError('INVALID_INPUT', 'invoke input must be a JSON object');
33
+ }
34
+ return value;
35
+ }
36
+ async function fetchOnce(url, init, options) {
37
+ const timeout = AbortSignal.timeout(options.timeoutMs);
38
+ const signal = options.signal ? AbortSignal.any([options.signal, timeout]) : timeout;
39
+ try {
40
+ return await fetch(url, { ...init, signal });
41
+ }
42
+ catch (error) {
43
+ if (error?.name === 'AbortError' && options.signal?.aborted) {
44
+ throw new InvokeError('ABORTED', 'Invoke was aborted');
45
+ }
46
+ throw new InvokeError('TRANSPORT_ERROR', error?.message ?? 'Network request failed');
47
+ }
48
+ }
49
+ async function parseFailure(response) {
50
+ let raw = '';
51
+ try {
52
+ raw = await response.text();
53
+ }
54
+ catch { }
55
+ let detail = raw;
56
+ try {
57
+ const body = JSON.parse(raw);
58
+ detail = body?.error?.message || body?.message || body?.detail || raw;
59
+ }
60
+ catch { }
61
+ const code = response.status >= 500 ? 'UPSTREAM_ERROR' : 'UPSTREAM_REJECTED';
62
+ const suffix = detail ? `: ${String(detail).slice(0, 500)}` : '';
63
+ return new InvokeError(code, `Endpoint returned HTTP ${response.status}${suffix}`, { status: response.status });
64
+ }
65
+ /**
66
+ * 把一段产物写到 `--out`。
67
+ *
68
+ * `outPath` 是文件时只允许一个产物;多个产物时把它当目录,按序号命名。
69
+ */
70
+ function writeArtifact(input) {
71
+ if (!input.outPath)
72
+ return undefined;
73
+ let target = input.outPath;
74
+ if (input.count === 1 && !input.outPath.endsWith(path.sep) && !input.outPath.endsWith('/')) {
75
+ target = input.outPath;
76
+ }
77
+ else {
78
+ const directory = input.outPath;
79
+ fs.mkdirSync(directory, { recursive: true });
80
+ const ext = extensionFor(input.mimeType, input.fallbackExt);
81
+ target = path.join(directory, `${path.basename(directory)}-${input.index + 1}${ext}`);
82
+ }
83
+ fs.mkdirSync(path.dirname(target), { recursive: true });
84
+ fs.writeFileSync(target, input.data);
85
+ return target;
86
+ }
87
+ async function materialize(outPath, source, options, meta) {
88
+ if (source.base64) {
89
+ const data = Buffer.from(source.base64, 'base64');
90
+ const mimeType = meta.mimeType ?? 'application/octet-stream';
91
+ const file = writeArtifact({ outPath, data, mimeType, fallbackExt: meta.fallbackExt, index: meta.index, count: meta.count });
92
+ return { kind: meta.kind, ...(file ? { path: file } : {}), mimeType, bytes: data.byteLength };
93
+ }
94
+ if (source.url) {
95
+ if (!outPath)
96
+ return { kind: meta.kind, url: source.url, ...(meta.mimeType ? { mimeType: meta.mimeType } : {}) };
97
+ // 端点只给了 URL,需要下载后才落盘。
98
+ const response = await fetchOnce(source.url, { method: 'GET' }, options);
99
+ if (!response.ok)
100
+ throw await parseFailure(response);
101
+ const data = Buffer.from(await response.arrayBuffer());
102
+ const mimeType = meta.mimeType ?? response.headers.get('content-type') ?? 'application/octet-stream';
103
+ const file = writeArtifact({ outPath, data, mimeType, fallbackExt: meta.fallbackExt, index: meta.index, count: meta.count });
104
+ return { kind: meta.kind, ...(file ? { path: file } : {}), url: source.url, mimeType, bytes: data.byteLength };
105
+ }
106
+ throw new InvokeError('EMPTY_RESPONSE', 'Endpoint returned neither a URL nor inline data');
107
+ }
108
+ /** openai-images:`POST /v1/images/generations`。 */
109
+ export const openaiImagesExecutor = {
110
+ id: 'builtin:openai-images',
111
+ handles: ['openai-images'],
112
+ services: ['image', 'images'],
113
+ async invoke(context, options) {
114
+ const input = asRecord(context.input);
115
+ const prompt = input.prompt ?? input.input;
116
+ if (typeof prompt !== 'string' || !prompt.trim()) {
117
+ throw new InvokeError('INVALID_INPUT', 'image generation requires a non-empty "prompt"');
118
+ }
119
+ const n = typeof input.n === 'number' && input.n > 0 ? Math.min(input.n, 10) : 1;
120
+ const response = await fetchOnce(appendRequestQueryParams(appendRequestPath(context.provider.baseUrl, 'images/generations'), context.provider.queryParams), {
121
+ method: 'POST',
122
+ headers: {
123
+ 'Content-Type': 'application/json',
124
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
125
+ ...context.provider.headers,
126
+ },
127
+ body: JSON.stringify({
128
+ model: context.model,
129
+ prompt,
130
+ n,
131
+ ...(input.size ? { size: input.size } : {}),
132
+ ...(input.quality ? { quality: input.quality } : {}),
133
+ ...(input.style ? { style: input.style } : {}),
134
+ ...(context.outPath ? { response_format: 'b64_json' } : {}),
135
+ }),
136
+ }, options);
137
+ if (!response.ok)
138
+ throw await parseFailure(response);
139
+ const body = await response.json();
140
+ const rows = Array.isArray(body?.data) ? body.data : [];
141
+ if (!rows.length)
142
+ throw new InvokeError('EMPTY_RESPONSE', 'Image endpoint returned no data');
143
+ // 生图端点一般不回 content-type;按请求的输出格式推断,缺省 png。
144
+ const requestedFormat = typeof input.output_format === 'string'
145
+ ? input.output_format
146
+ : typeof input.response_format === 'string' ? input.response_format : 'png';
147
+ const imageMime = requestedFormat === 'jpeg' || requestedFormat === 'jpg' ? 'image/jpeg'
148
+ : requestedFormat === 'webp' ? 'image/webp'
149
+ : 'image/png';
150
+ const artifacts = [];
151
+ for (const [index, row] of rows.entries()) {
152
+ artifacts.push(await materialize(context.outPath, {
153
+ url: typeof row?.url === 'string' ? row.url : undefined,
154
+ base64: typeof row?.b64_json === 'string' ? row.b64_json : undefined,
155
+ }, options, { kind: 'image', mimeType: imageMime, index, count: rows.length, fallbackExt: '.png' }));
156
+ }
157
+ return { output: body, artifacts, latencyMs: 0 };
158
+ },
159
+ };
160
+ /** openai-audio(speech):`POST /v1/audio/speech`,返回音频二进制。 */
161
+ export const openaiSpeechExecutor = {
162
+ id: 'builtin:openai-speech',
163
+ handles: ['openai-audio', 'openai-speech'],
164
+ services: ['speech', 'tts'],
165
+ async invoke(context, options) {
166
+ const input = asRecord(context.input);
167
+ const text = input.text ?? input.input;
168
+ if (typeof text !== 'string' || !text.trim()) {
169
+ throw new InvokeError('INVALID_INPUT', 'speech synthesis requires a non-empty "text"');
170
+ }
171
+ const response = await fetchOnce(appendRequestQueryParams(appendRequestPath(context.provider.baseUrl, 'audio/speech'), context.provider.queryParams), {
172
+ method: 'POST',
173
+ headers: {
174
+ 'Content-Type': 'application/json',
175
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
176
+ ...context.provider.headers,
177
+ },
178
+ body: JSON.stringify({
179
+ model: context.model,
180
+ input: text,
181
+ ...(input.voice ? { voice: input.voice } : {}),
182
+ ...(input.format ? { response_format: input.format } : {}),
183
+ ...(input.speed ? { speed: input.speed } : {}),
184
+ }),
185
+ }, options);
186
+ if (!response.ok)
187
+ throw await parseFailure(response);
188
+ const data = Buffer.from(await response.arrayBuffer());
189
+ const mimeType = response.headers.get('content-type') ?? 'audio/mpeg';
190
+ const file = writeArtifact({
191
+ outPath: context.outPath, data, mimeType, fallbackExt: '.mp3', index: 0, count: 1,
192
+ });
193
+ return {
194
+ output: { bytes: data.byteLength, mimeType },
195
+ artifacts: [{ kind: 'audio', ...(file ? { path: file } : {}), mimeType, bytes: data.byteLength }],
196
+ latencyMs: 0,
197
+ };
198
+ },
199
+ };
200
+ /** openai-audio(transcription):`POST /v1/audio/transcriptions`,multipart 上传。 */
201
+ export const openaiTranscriptionExecutor = {
202
+ id: 'builtin:openai-transcribe',
203
+ handles: ['openai-audio', 'openai-transcribe'],
204
+ services: ['transcribe', 'transcription', 'stt'],
205
+ async invoke(context, options) {
206
+ const input = asRecord(context.input);
207
+ const filePath = typeof input.file === 'string' ? input.file : undefined;
208
+ if (!filePath)
209
+ throw new InvokeError('INVALID_INPUT', 'transcription requires "file" (absolute path)');
210
+ if (!path.isAbsolute(filePath))
211
+ throw new InvokeError('INVALID_INPUT', 'transcription "file" must be an absolute path');
212
+ let data;
213
+ try {
214
+ data = fs.readFileSync(filePath);
215
+ }
216
+ catch (error) {
217
+ throw new InvokeError('INVALID_INPUT', `cannot read audio file: ${error.message}`);
218
+ }
219
+ const form = new FormData();
220
+ // Uint8Array 的底层 buffer 类型与 BlobPart 对齐;直接用 Buffer 会因
221
+ // ArrayBufferLike 的 SharedArrayBuffer 分支报类型不兼容。
222
+ form.append('file', new Blob([new Uint8Array(data)]), path.basename(filePath));
223
+ form.append('model', context.model);
224
+ if (typeof input.language === 'string')
225
+ form.append('language', input.language);
226
+ if (typeof input.prompt === 'string')
227
+ form.append('prompt', input.prompt);
228
+ if (typeof input.response_format === 'string')
229
+ form.append('response_format', input.response_format);
230
+ const response = await fetchOnce(appendRequestQueryParams(appendRequestPath(context.provider.baseUrl, 'audio/transcriptions'), context.provider.queryParams), {
231
+ method: 'POST',
232
+ headers: {
233
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
234
+ ...context.provider.headers,
235
+ },
236
+ body: form,
237
+ }, options);
238
+ if (!response.ok)
239
+ throw await parseFailure(response);
240
+ const text = await response.text();
241
+ let output = text;
242
+ try {
243
+ output = JSON.parse(text);
244
+ }
245
+ catch { }
246
+ return { output, latencyMs: 0 };
247
+ },
248
+ };
249
+ /** openai-embeddings:`POST /v1/embeddings`。 */
250
+ export const openaiEmbeddingsExecutor = {
251
+ id: 'builtin:openai-embeddings',
252
+ handles: ['openai-embeddings'],
253
+ services: ['embedding', 'embeddings'],
254
+ async invoke(context, options) {
255
+ const input = asRecord(context.input);
256
+ const value = input.input ?? input.text;
257
+ if (value === undefined)
258
+ throw new InvokeError('INVALID_INPUT', 'embeddings require "input"');
259
+ const response = await fetchOnce(appendRequestQueryParams(appendRequestPath(context.provider.baseUrl, 'embeddings'), context.provider.queryParams), {
260
+ method: 'POST',
261
+ headers: {
262
+ 'Content-Type': 'application/json',
263
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
264
+ ...context.provider.headers,
265
+ },
266
+ body: JSON.stringify({
267
+ model: context.model,
268
+ input: value,
269
+ ...(input.dimensions ? { dimensions: input.dimensions } : {}),
270
+ ...(input.encoding_format ? { encoding_format: input.encoding_format } : {}),
271
+ }),
272
+ }, options);
273
+ if (!response.ok)
274
+ throw await parseFailure(response);
275
+ return { output: await response.json(), latencyMs: 0 };
276
+ },
277
+ };
278
+ export const MEDIA_EXECUTORS = [
279
+ openaiImagesExecutor,
280
+ openaiSpeechExecutor,
281
+ openaiTranscriptionExecutor,
282
+ openaiEmbeddingsExecutor,
283
+ ];
@@ -0,0 +1,198 @@
1
+ /**
2
+ * 文本类内置执行器:claude / codex / openai-compatible / systemone / gemini。
3
+ *
4
+ * 这些执行器**不复用** `text-inference.ts` 里为 runner 设计的
5
+ * `TextInferenceProvider.completeText`——那条路径把 `max_tokens`、system/user
6
+ * 双段消息等业务假设写死了。`ec invoke` 是通用入口,入参由调用方直接给出,
7
+ * 所以这里按 style 组装**原生请求体**,只做「发送 + 解析」。
8
+ */
9
+ import { appendRequestPath, appendV1RequestPath, appendRequestQueryParams, } from '../../../agents/request-identity.js';
10
+ import { InvokeError } from '../types.js';
11
+ /** 单次尝试的超时包装。 */
12
+ async function fetchOnce(url, init, options) {
13
+ const timeout = AbortSignal.timeout(options.timeoutMs);
14
+ const signal = options.signal ? AbortSignal.any([options.signal, timeout]) : timeout;
15
+ try {
16
+ return await fetch(url, { ...init, signal });
17
+ }
18
+ catch (error) {
19
+ if (error?.name === 'AbortError' && options.signal?.aborted) {
20
+ throw new InvokeError('ABORTED', 'Invoke was aborted');
21
+ }
22
+ // 网络错误统一成可重试的传输层错误。
23
+ throw new InvokeError('TRANSPORT_ERROR', error?.message ?? 'Network request failed');
24
+ }
25
+ }
26
+ /** 解析失败响应,保留状态码供重试判定。 */
27
+ async function parseFailure(response) {
28
+ let raw = '';
29
+ try {
30
+ raw = await response.text();
31
+ }
32
+ catch { }
33
+ let detail = raw;
34
+ try {
35
+ const body = JSON.parse(raw);
36
+ detail = body?.error?.message || body?.message || body?.detail || raw;
37
+ }
38
+ catch { }
39
+ const code = response.status >= 500 ? 'UPSTREAM_ERROR' : 'UPSTREAM_REJECTED';
40
+ const suffix = detail ? `: ${String(detail).slice(0, 500)}` : '';
41
+ return new InvokeError(code, `Endpoint returned HTTP ${response.status}${suffix}`, { status: response.status });
42
+ }
43
+ function asRecord(value) {
44
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
45
+ throw new InvokeError('INVALID_INPUT', 'invoke input must be a JSON object');
46
+ }
47
+ return value;
48
+ }
49
+ function stringArray(value) {
50
+ if (!Array.isArray(value))
51
+ return undefined;
52
+ return value.filter((item) => !!item && typeof item === 'object');
53
+ }
54
+ /** claude / anthropic:`POST /v1/messages`。 */
55
+ export const anthropicExecutor = {
56
+ id: 'builtin:claude',
57
+ handles: ['claude', 'anthropic'],
58
+ services: ['*'],
59
+ async invoke(context, options) {
60
+ const input = asRecord(context.input);
61
+ const endpoint = appendV1RequestPath(context.provider.baseUrl, 'messages');
62
+ const response = await fetchOnce(appendRequestQueryParams(endpoint, context.provider.queryParams), {
63
+ method: 'POST',
64
+ headers: {
65
+ 'Content-Type': 'application/json',
66
+ 'anthropic-version': '2023-06-01',
67
+ ...(context.provider.apiKey ? { 'x-api-key': context.provider.apiKey } : {}),
68
+ ...context.provider.headers,
69
+ },
70
+ body: JSON.stringify({
71
+ model: context.model,
72
+ max_tokens: typeof input.max_tokens === 'number' ? input.max_tokens : 1024,
73
+ ...(input.system !== undefined ? { system: input.system } : {}),
74
+ messages: input.messages ?? [{ role: 'user', content: String(input.input ?? input.prompt ?? '') }],
75
+ ...(input.effort ? { output_config: { effort: input.effort } } : {}),
76
+ }),
77
+ }, options);
78
+ if (!response.ok)
79
+ throw await parseFailure(response);
80
+ return { output: await response.json(), latencyMs: 0 };
81
+ },
82
+ };
83
+ /** codex / openai-responses:`POST /v1/responses`。 */
84
+ export const openaiResponsesExecutor = {
85
+ id: 'builtin:codex',
86
+ handles: ['codex', 'openai-responses'],
87
+ services: ['*'],
88
+ async invoke(context, options) {
89
+ const input = asRecord(context.input);
90
+ const endpoint = appendRequestPath(context.provider.baseUrl, 'responses');
91
+ const response = await fetchOnce(appendRequestQueryParams(endpoint, context.provider.queryParams), {
92
+ method: 'POST',
93
+ headers: {
94
+ 'Content-Type': 'application/json',
95
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
96
+ ...context.provider.headers,
97
+ },
98
+ body: JSON.stringify({
99
+ model: context.model,
100
+ ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),
101
+ input: input.input ?? String(input.prompt ?? ''),
102
+ store: input.store === true,
103
+ max_output_tokens: typeof input.max_output_tokens === 'number' ? input.max_output_tokens : 1024,
104
+ ...(input.effort ? { reasoning: { effort: input.effort } } : {}),
105
+ }),
106
+ }, options);
107
+ if (!response.ok)
108
+ throw await parseFailure(response);
109
+ return { output: await response.json(), latencyMs: 0 };
110
+ },
111
+ };
112
+ /** openai-compatible:`POST /v1/chat/completions`。 */
113
+ export const openaiCompatibleExecutor = {
114
+ id: 'builtin:openai-compatible',
115
+ handles: ['openai-compatible'],
116
+ services: ['*'],
117
+ async invoke(context, options) {
118
+ const input = asRecord(context.input);
119
+ const endpoint = appendRequestPath(context.provider.baseUrl, 'chat/completions');
120
+ const response = await fetchOnce(appendRequestQueryParams(endpoint, context.provider.queryParams), {
121
+ method: 'POST',
122
+ headers: {
123
+ 'Content-Type': 'application/json',
124
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
125
+ ...context.provider.headers,
126
+ },
127
+ body: JSON.stringify({
128
+ model: context.model,
129
+ messages: input.messages ?? [{ role: 'user', content: String(input.input ?? input.prompt ?? '') }],
130
+ ...(typeof input.max_tokens === 'number' ? { max_tokens: input.max_tokens } : {}),
131
+ ...(input.effort ? { reasoning_effort: input.effort } : {}),
132
+ }),
133
+ }, options);
134
+ if (!response.ok)
135
+ throw await parseFailure(response);
136
+ return { output: await response.json(), latencyMs: 0 };
137
+ },
138
+ };
139
+ /** systemone:`POST {baseUrl}` + `{model, state, questions}`。 */
140
+ export const systemoneExecutor = {
141
+ id: 'builtin:systemone',
142
+ handles: ['systemone'],
143
+ services: ['*'],
144
+ async invoke(context, options) {
145
+ const input = asRecord(context.input);
146
+ const response = await fetchOnce(appendRequestQueryParams(context.provider.baseUrl, context.provider.queryParams), {
147
+ method: 'POST',
148
+ headers: {
149
+ 'Content-Type': 'application/json',
150
+ ...(context.provider.apiKey ? { Authorization: `Bearer ${context.provider.apiKey}` } : {}),
151
+ ...context.provider.headers,
152
+ },
153
+ body: JSON.stringify({
154
+ model: context.model,
155
+ state: input.state,
156
+ questions: input.questions,
157
+ }),
158
+ }, options);
159
+ if (!response.ok)
160
+ throw await parseFailure(response);
161
+ // systemone 返回 JSON;原样透传(可能是字符串化的 JSON)。
162
+ return { output: await response.json(), latencyMs: 0 };
163
+ },
164
+ };
165
+ /** gemini:`POST /v1beta/models/{model}:generateContent`,头带 x-goog-api-key。 */
166
+ export const geminiExecutor = {
167
+ id: 'builtin:gemini',
168
+ handles: ['gemini'],
169
+ services: ['*'],
170
+ async invoke(context, options) {
171
+ const input = asRecord(context.input);
172
+ const base = context.provider.baseUrl.replace(/\/+$/u, '');
173
+ const resource = `${base}/v1beta/models/${encodeURIComponent(context.model)}:generateContent`;
174
+ const contents = stringArray(input.contents) ?? [{
175
+ role: 'user',
176
+ parts: [{ text: String(input.input ?? input.prompt ?? '') }],
177
+ }];
178
+ const response = await fetchOnce(appendRequestQueryParams(resource, context.provider.queryParams), {
179
+ method: 'POST',
180
+ headers: {
181
+ 'Content-Type': 'application/json',
182
+ ...(context.provider.apiKey ? { 'x-goog-api-key': context.provider.apiKey } : {}),
183
+ ...context.provider.headers,
184
+ },
185
+ body: JSON.stringify({ contents }),
186
+ }, options);
187
+ if (!response.ok)
188
+ throw await parseFailure(response);
189
+ return { output: await response.json(), latencyMs: 0 };
190
+ },
191
+ };
192
+ export const TEXT_EXECUTORS = [
193
+ anthropicExecutor,
194
+ openaiResponsesExecutor,
195
+ openaiCompatibleExecutor,
196
+ systemoneExecutor,
197
+ geminiExecutor,
198
+ ];
@@ -0,0 +1,157 @@
1
+ /**
2
+ * `ec invoke` 的调用编排:解析 → 路由 → 执行 → 重试 → 归一化。
3
+ *
4
+ * 设计见 `docs/model-intent/invoke-design.md`。
5
+ *
6
+ * 重试语义(唯一一处重试):
7
+ * - 5xx / 连接失败 / 超时 → 重试,直到 `--retries` 次,指数退避
8
+ * - 4xx → 不重试,直接失败
9
+ * - `--retries 0` → 只打一次
10
+ */
11
+ import { resolveProviderService } from '../../config/providers.js';
12
+ import { InvokeError } from './types.js';
13
+ import { resolveStyleRoute } from './style-router.js';
14
+ export const DEFAULT_INVOKE_TIMEOUT_MS = 60_000;
15
+ export const DEFAULT_INVOKE_RETRIES = 3;
16
+ export const MAX_INVOKE_RETRIES = 10;
17
+ export const MAX_INVOKE_TIMEOUT_MS = 3_600_000;
18
+ /** 判定一个错误是否可重试:传输层错误才重试。 */
19
+ function isRetryable(error) {
20
+ if (error instanceof InvokeError)
21
+ return error.code === 'TRANSPORT_ERROR' || error.code === 'UPSTREAM_ERROR';
22
+ return false;
23
+ }
24
+ function backoffMs(attempt) {
25
+ // 200ms, 400ms, 800ms ... 上限 4s
26
+ return Math.min(200 * 2 ** (attempt - 1), 4_000);
27
+ }
28
+ function sleep(ms, signal) {
29
+ return new Promise((resolve, reject) => {
30
+ const timer = setTimeout(resolve, ms);
31
+ signal?.addEventListener('abort', () => {
32
+ clearTimeout(timer);
33
+ reject(new InvokeError('ABORTED', 'Invoke was aborted'));
34
+ }, { once: true });
35
+ });
36
+ }
37
+ /** 带重试地跑一个执行器。导出供测试验证重试语义。 */
38
+ export async function runWithRetry(executor, context, options) {
39
+ const started = Date.now();
40
+ let lastError;
41
+ for (let attempt = 0; attempt <= options.retries; attempt++) {
42
+ options.signal?.throwIfAborted();
43
+ if (attempt > 0)
44
+ await sleep(backoffMs(attempt), options.signal);
45
+ try {
46
+ const result = await executor.invoke(context, options);
47
+ return { ...result, latencyMs: Date.now() - started };
48
+ }
49
+ catch (error) {
50
+ lastError = error;
51
+ if (!isRetryable(error))
52
+ throw error;
53
+ }
54
+ }
55
+ throw lastError;
56
+ }
57
+ /** 解析 `--model` 缺省值:从 catalog 取第一个已启用模型。 */
58
+ async function resolveDefaultModel(providerId, serviceType) {
59
+ const { getLocalProviderCatalog } = await import('../model/model-catalog.js');
60
+ const snapshot = await getLocalProviderCatalog(providerId, serviceType, false);
61
+ const model = snapshot.models.find(entry => !entry.aliasFor) ?? snapshot.models[0];
62
+ if (!model) {
63
+ throw new InvokeError('MODEL_REQUIRED', `No model available for provider ${providerId} service ${serviceType}; pass --model`);
64
+ }
65
+ return model.id;
66
+ }
67
+ export async function executeInvoke(request) {
68
+ const timeoutMs = request.timeoutMs ?? DEFAULT_INVOKE_TIMEOUT_MS;
69
+ const retries = request.retries ?? DEFAULT_INVOKE_RETRIES;
70
+ if (!Number.isFinite(timeoutMs) || timeoutMs <= 0 || timeoutMs > MAX_INVOKE_TIMEOUT_MS) {
71
+ return { ok: false, code: 'INVALID_ARGUMENT', error: `--timeout must be between 1 and ${MAX_INVOKE_TIMEOUT_MS} ms` };
72
+ }
73
+ if (!Number.isInteger(retries) || retries < 0 || retries > MAX_INVOKE_RETRIES) {
74
+ return { ok: false, code: 'INVALID_ARGUMENT', error: `--retries must be an integer between 0 and ${MAX_INVOKE_RETRIES}` };
75
+ }
76
+ let connection;
77
+ try {
78
+ connection = resolveProviderService(request.providerId, request.serviceType);
79
+ }
80
+ catch (error) {
81
+ return { ok: false, code: 'PROVIDER_NOT_FOUND', error: error.message };
82
+ }
83
+ let model = request.model;
84
+ if (!model) {
85
+ // `--dry-run` 的契约是「不触网」。缺省模型要走目录接口(网络),
86
+ // 所以 dry-run 且未显式给 --model 时不解析真实模型,用占位值。
87
+ if (request.dryRun) {
88
+ model = '<dry-run>';
89
+ }
90
+ else {
91
+ try {
92
+ model = await resolveDefaultModel(connection.providerId, connection.serviceType);
93
+ }
94
+ catch (error) {
95
+ return { ok: false, code: error instanceof InvokeError ? error.code : 'MODEL_REQUIRED', error: error.message };
96
+ }
97
+ }
98
+ }
99
+ let route;
100
+ try {
101
+ route = await resolveStyleRoute({ style: connection.style, serviceType: request.serviceType });
102
+ }
103
+ catch (error) {
104
+ return { ok: false, code: 'ROUTE_FAILED', error: error.message };
105
+ }
106
+ if (request.dryRun) {
107
+ return {
108
+ ok: true,
109
+ provider: connection.providerId,
110
+ service: request.serviceType,
111
+ model,
112
+ style: connection.style,
113
+ executor: route.kind === 'builtin' ? route.executor.id : route.kind,
114
+ result: { output: { dryRun: true, route }, latencyMs: 0 },
115
+ };
116
+ }
117
+ if (route.kind !== 'builtin') {
118
+ return {
119
+ ok: false,
120
+ code: 'STYLE_UNSUPPORTED',
121
+ error: `No builtin executor handles style "${connection.style}" for service "${request.serviceType}"`,
122
+ data: { style: connection.style, serviceType: request.serviceType, hint: 'Plugin generation lands in phase C' },
123
+ };
124
+ }
125
+ const context = {
126
+ provider: {
127
+ providerId: connection.providerId,
128
+ serviceType: connection.serviceType,
129
+ style: connection.style,
130
+ baseUrl: connection.baseUrl,
131
+ apiKey: connection.apiKey,
132
+ headers: connection.headers,
133
+ queryParams: connection.queryParams,
134
+ },
135
+ model,
136
+ input: request.input,
137
+ outPath: request.outPath,
138
+ };
139
+ try {
140
+ const result = await runWithRetry(route.executor, context, { timeoutMs, retries });
141
+ return {
142
+ ok: true,
143
+ provider: connection.providerId,
144
+ service: request.serviceType,
145
+ model,
146
+ style: connection.style,
147
+ executor: route.executor.id,
148
+ result,
149
+ };
150
+ }
151
+ catch (error) {
152
+ if (error instanceof InvokeError) {
153
+ return { ok: false, code: error.code, error: error.message, data: error.data };
154
+ }
155
+ return { ok: false, code: 'INVOKE_FAILED', error: error.message };
156
+ }
157
+ }
@@ -0,0 +1,48 @@
1
+ /**
2
+ * style 路由表。
3
+ *
4
+ * 设计见 `docs/model-intent/invoke-design.md` 第二节「路由表」。
5
+ *
6
+ * 路由**只按 style 判定**,不按域名、不看模型名。内置执行器优先,
7
+ * 未命中才考虑插件(插件机制在阶段 C 接入)。
8
+ */
9
+ import { BUILTIN_EXECUTORS } from './executors/index.js';
10
+ /** style 别名归一:路由只认 canonical 形态。 */
11
+ const STYLE_ALIASES = {
12
+ anthropic: 'claude',
13
+ 'openai-responses': 'codex',
14
+ };
15
+ export function canonicalStyle(style) {
16
+ const normalized = style.trim().toLowerCase();
17
+ return STYLE_ALIASES[normalized] ?? normalized;
18
+ }
19
+ /** 查询内置执行器;未命中返回 undefined。 */
20
+ export function findBuiltinExecutor(style, serviceType, executors = BUILTIN_EXECUTORS) {
21
+ const target = canonicalStyle(style);
22
+ return executors.find(executor => executor.handles.some(handle => canonicalStyle(handle) === target)
23
+ && (executor.services.includes('*') || executor.services.includes(serviceType)));
24
+ }
25
+ /**
26
+ * 解析一次调用该走谁。
27
+ *
28
+ * @param pluginLookup 插件查找(阶段 C)。返回插件 ID 表示可路由到插件。
29
+ */
30
+ export async function resolveStyleRoute(input) {
31
+ const executor = findBuiltinExecutor(input.style, input.serviceType, input.executors);
32
+ if (executor)
33
+ return { kind: 'builtin', executor };
34
+ if (input.pluginLookup) {
35
+ const pluginId = await input.pluginLookup(input.style, input.serviceType);
36
+ if (pluginId)
37
+ return { kind: 'plugin', pluginId };
38
+ }
39
+ return { kind: 'unsupported', style: input.style, serviceType: input.serviceType };
40
+ }
41
+ /** `--dry-run` 与帮助用的路由表快照。 */
42
+ export function describeRouteTable(executors = BUILTIN_EXECUTORS) {
43
+ return executors.map(executor => ({
44
+ executor: executor.id,
45
+ handles: [...executor.handles],
46
+ services: [...executor.services],
47
+ }));
48
+ }