@aexhq/sdk 0.30.0 → 0.31.0
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.
- package/README.md +23 -9
- package/dist/_contracts/connection-ticket.d.ts +1 -1
- package/dist/_contracts/connection-ticket.js +1 -1
- package/dist/_contracts/event-envelope.d.ts +5 -8
- package/dist/_contracts/event-envelope.js +5 -6
- package/dist/_contracts/event-stream-client.d.ts +1 -1
- package/dist/_contracts/http.js +1 -1
- package/dist/_contracts/operations.d.ts +2 -47
- package/dist/_contracts/operations.js +7 -112
- package/dist/_contracts/provider-support.d.ts +48 -138
- package/dist/_contracts/provider-support.js +10 -41
- package/dist/_contracts/proxy-protocol.d.ts +7 -7
- package/dist/_contracts/proxy-protocol.js +8 -8
- package/dist/_contracts/run-config.d.ts +7 -20
- package/dist/_contracts/run-config.js +8 -46
- package/dist/_contracts/run-cost.d.ts +1 -5
- package/dist/_contracts/run-cost.js +0 -8
- package/dist/_contracts/run-custody.d.ts +4 -6
- package/dist/_contracts/run-custody.js +0 -8
- package/dist/_contracts/run-unit.d.ts +1 -1
- package/dist/_contracts/run-unit.js +2 -2
- package/dist/_contracts/runner-event.d.ts +1 -1
- package/dist/_contracts/runner-event.js +1 -1
- package/dist/_contracts/runtime-manifest.d.ts +13 -26
- package/dist/_contracts/runtime-manifest.js +6 -35
- package/dist/_contracts/runtime-types.d.ts +1 -1
- package/dist/_contracts/sdk-secrets.js +4 -4
- package/dist/_contracts/side-effect-audit.d.ts +2 -4
- package/dist/_contracts/side-effect-audit.js +2 -4
- package/dist/_contracts/status.d.ts +1 -1
- package/dist/_contracts/status.js +1 -1
- package/dist/_contracts/submission.d.ts +5 -126
- package/dist/_contracts/submission.js +10 -182
- package/dist/_contracts/webhook-verify.d.ts +1 -1
- package/dist/_contracts/webhook-verify.js +1 -1
- package/dist/asset-upload.d.ts +4 -10
- package/dist/asset-upload.js +4 -47
- package/dist/asset-upload.js.map +1 -1
- package/dist/cli.mjs +19 -193
- package/dist/cli.mjs.sha256 +1 -1
- package/dist/client.d.ts +8 -69
- package/dist/client.js +21 -98
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts +4 -4
- package/dist/index.js +3 -4
- package/dist/index.js.map +1 -1
- package/dist/skill.d.ts +1 -1
- package/dist/skill.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/docs/cleanup.md +2 -2
- package/docs/concepts/agent-tools.md +2 -2
- package/docs/concepts/composition.md +1 -1
- package/docs/concepts/providers-and-runtimes.md +2 -4
- package/docs/concepts/runs.md +3 -6
- package/docs/credentials.md +2 -5
- package/docs/defaults.md +22 -22
- package/docs/limits-and-quotas.md +40 -40
- package/docs/limits.md +1 -1
- package/docs/networking.md +2 -2
- package/docs/outputs.md +1 -1
- package/docs/provider-runtime-capabilities.md +36 -64
- package/docs/public-surface.json +2 -3
- package/docs/quickstart.md +18 -6
- package/docs/run-config.md +3 -4
- package/docs/secrets.md +7 -5
- package/docs/skills.md +4 -12
- package/docs/vision-skills.md +1 -1
- package/package.json +2 -2
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { RunProvider
|
|
1
|
+
import type { RunProvider } from "./submission.js";
|
|
2
2
|
export interface SupportPointer {
|
|
3
3
|
readonly label: string;
|
|
4
4
|
/** Markdown href, relative to `packages/sdk/docs/provider-runtime-capabilities.md`. */
|
|
@@ -9,28 +9,8 @@ export interface ProviderPublicSupport {
|
|
|
9
9
|
readonly docsAnchor: string;
|
|
10
10
|
readonly docs: readonly SupportPointer[];
|
|
11
11
|
readonly evidence: readonly SupportPointer[];
|
|
12
|
-
readonly
|
|
12
|
+
readonly managedEvidence: readonly SupportPointer[];
|
|
13
13
|
}
|
|
14
|
-
export interface RuntimeValidationSupport {
|
|
15
|
-
readonly docsAnchor: string;
|
|
16
|
-
readonly docs: readonly SupportPointer[];
|
|
17
|
-
readonly evidence: readonly SupportPointer[];
|
|
18
|
-
readonly enforcement: string;
|
|
19
|
-
}
|
|
20
|
-
export declare const RUNTIME_VALIDATION_SUPPORT: {
|
|
21
|
-
readonly feature_runtime_mismatch: {
|
|
22
|
-
readonly docsAnchor: "managed-unsupported-features";
|
|
23
|
-
readonly docs: readonly [{
|
|
24
|
-
readonly label: "Runtime routing";
|
|
25
|
-
readonly href: "provider-runtime-capabilities.md#runtime-routing";
|
|
26
|
-
}];
|
|
27
|
-
readonly evidence: readonly [{
|
|
28
|
-
readonly label: "Submission parser and routing parity";
|
|
29
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
30
|
-
}];
|
|
31
|
-
readonly enforcement: "collectManagedUnsupportedFeatures + selectRuntime";
|
|
32
|
-
};
|
|
33
|
-
};
|
|
34
14
|
/**
|
|
35
15
|
* Public provider support facts for generated SDK docs. Keep this metadata
|
|
36
16
|
* public-facing only: provider names, docs anchors, and evidence pointers.
|
|
@@ -50,28 +30,17 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
50
30
|
readonly evidence: readonly [{
|
|
51
31
|
readonly label: "Submission parser and routing parity";
|
|
52
32
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
53
|
-
}, {
|
|
54
|
-
readonly label: "Runtime support validator";
|
|
55
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
56
33
|
}, {
|
|
57
34
|
readonly label: "Generated matrix freshness";
|
|
58
35
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
59
36
|
}, {
|
|
60
37
|
readonly label: "Installed-SDK Anthropic live user test";
|
|
61
38
|
readonly href: "../../../apps/user-tests/test/live/live-sdk-anthropic-managed.test.ts";
|
|
62
|
-
}, {
|
|
63
|
-
readonly label: "Runtime support validator";
|
|
64
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
65
39
|
}];
|
|
66
|
-
readonly
|
|
67
|
-
readonly
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
}, {
|
|
71
|
-
readonly label: "Runtime support validator";
|
|
72
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
73
|
-
}];
|
|
74
|
-
};
|
|
40
|
+
readonly managedEvidence: readonly [{
|
|
41
|
+
readonly label: "Installed-SDK Anthropic live user test";
|
|
42
|
+
readonly href: "../../../apps/user-tests/test/live/live-sdk-anthropic-managed.test.ts";
|
|
43
|
+
}];
|
|
75
44
|
};
|
|
76
45
|
readonly deepseek: {
|
|
77
46
|
readonly displayName: "DeepSeek";
|
|
@@ -86,9 +55,6 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
86
55
|
readonly evidence: readonly [{
|
|
87
56
|
readonly label: "Submission parser and routing parity";
|
|
88
57
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
89
|
-
}, {
|
|
90
|
-
readonly label: "Runtime support validator";
|
|
91
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
92
58
|
}, {
|
|
93
59
|
readonly label: "Generated matrix freshness";
|
|
94
60
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
@@ -98,22 +64,14 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
98
64
|
}, {
|
|
99
65
|
readonly label: "Installed-SDK DeepSeek comprehensive live user matrix";
|
|
100
66
|
readonly href: "../../../apps/user-tests/test/live/live-sdk-comprehensive.test.ts";
|
|
67
|
+
}];
|
|
68
|
+
readonly managedEvidence: readonly [{
|
|
69
|
+
readonly label: "Installed-SDK DeepSeek live user test";
|
|
70
|
+
readonly href: "../../../apps/user-tests/test/live/live-sdk-deepseek.test.ts";
|
|
101
71
|
}, {
|
|
102
|
-
readonly label: "
|
|
103
|
-
readonly href: "
|
|
72
|
+
readonly label: "Installed-SDK DeepSeek comprehensive live user matrix";
|
|
73
|
+
readonly href: "../../../apps/user-tests/test/live/live-sdk-comprehensive.test.ts";
|
|
104
74
|
}];
|
|
105
|
-
readonly runtimeEvidence: {
|
|
106
|
-
readonly managed: readonly [{
|
|
107
|
-
readonly label: "Installed-SDK DeepSeek live user test";
|
|
108
|
-
readonly href: "../../../apps/user-tests/test/live/live-sdk-deepseek.test.ts";
|
|
109
|
-
}, {
|
|
110
|
-
readonly label: "Installed-SDK DeepSeek comprehensive live user matrix";
|
|
111
|
-
readonly href: "../../../apps/user-tests/test/live/live-sdk-comprehensive.test.ts";
|
|
112
|
-
}, {
|
|
113
|
-
readonly label: "Runtime support validator";
|
|
114
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
115
|
-
}];
|
|
116
|
-
};
|
|
117
75
|
};
|
|
118
76
|
readonly openai: {
|
|
119
77
|
readonly displayName: "OpenAI";
|
|
@@ -129,24 +87,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
129
87
|
readonly label: "Submission parser and routing parity";
|
|
130
88
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
131
89
|
}, {
|
|
132
|
-
readonly label: "
|
|
133
|
-
readonly href: "
|
|
90
|
+
readonly label: "Generated matrix freshness";
|
|
91
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
92
|
+
}];
|
|
93
|
+
readonly managedEvidence: readonly [{
|
|
94
|
+
readonly label: "Submission parser and routing parity";
|
|
95
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
134
96
|
}, {
|
|
135
97
|
readonly label: "Generated matrix freshness";
|
|
136
98
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
137
99
|
}];
|
|
138
|
-
readonly runtimeEvidence: {
|
|
139
|
-
readonly managed: readonly [{
|
|
140
|
-
readonly label: "Submission parser and routing parity";
|
|
141
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
142
|
-
}, {
|
|
143
|
-
readonly label: "Runtime support validator";
|
|
144
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
145
|
-
}, {
|
|
146
|
-
readonly label: "Generated matrix freshness";
|
|
147
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
148
|
-
}];
|
|
149
|
-
};
|
|
150
100
|
};
|
|
151
101
|
readonly gemini: {
|
|
152
102
|
readonly displayName: "Gemini";
|
|
@@ -162,24 +112,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
162
112
|
readonly label: "Submission parser and routing parity";
|
|
163
113
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
164
114
|
}, {
|
|
165
|
-
readonly label: "
|
|
166
|
-
readonly href: "
|
|
115
|
+
readonly label: "Generated matrix freshness";
|
|
116
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
117
|
+
}];
|
|
118
|
+
readonly managedEvidence: readonly [{
|
|
119
|
+
readonly label: "Submission parser and routing parity";
|
|
120
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
167
121
|
}, {
|
|
168
122
|
readonly label: "Generated matrix freshness";
|
|
169
123
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
170
124
|
}];
|
|
171
|
-
readonly runtimeEvidence: {
|
|
172
|
-
readonly managed: readonly [{
|
|
173
|
-
readonly label: "Submission parser and routing parity";
|
|
174
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
175
|
-
}, {
|
|
176
|
-
readonly label: "Runtime support validator";
|
|
177
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
178
|
-
}, {
|
|
179
|
-
readonly label: "Generated matrix freshness";
|
|
180
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
181
|
-
}];
|
|
182
|
-
};
|
|
183
125
|
};
|
|
184
126
|
readonly mistral: {
|
|
185
127
|
readonly displayName: "Mistral";
|
|
@@ -195,24 +137,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
195
137
|
readonly label: "Submission parser and routing parity";
|
|
196
138
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
197
139
|
}, {
|
|
198
|
-
readonly label: "
|
|
199
|
-
readonly href: "
|
|
140
|
+
readonly label: "Generated matrix freshness";
|
|
141
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
142
|
+
}];
|
|
143
|
+
readonly managedEvidence: readonly [{
|
|
144
|
+
readonly label: "Submission parser and routing parity";
|
|
145
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
200
146
|
}, {
|
|
201
147
|
readonly label: "Generated matrix freshness";
|
|
202
148
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
203
149
|
}];
|
|
204
|
-
readonly runtimeEvidence: {
|
|
205
|
-
readonly managed: readonly [{
|
|
206
|
-
readonly label: "Submission parser and routing parity";
|
|
207
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
208
|
-
}, {
|
|
209
|
-
readonly label: "Runtime support validator";
|
|
210
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
211
|
-
}, {
|
|
212
|
-
readonly label: "Generated matrix freshness";
|
|
213
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
214
|
-
}];
|
|
215
|
-
};
|
|
216
150
|
};
|
|
217
151
|
readonly openrouter: {
|
|
218
152
|
readonly displayName: "OpenRouter";
|
|
@@ -228,24 +162,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
228
162
|
readonly label: "Submission parser and routing parity";
|
|
229
163
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
230
164
|
}, {
|
|
231
|
-
readonly label: "
|
|
232
|
-
readonly href: "
|
|
165
|
+
readonly label: "Generated matrix freshness";
|
|
166
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
167
|
+
}];
|
|
168
|
+
readonly managedEvidence: readonly [{
|
|
169
|
+
readonly label: "Submission parser and routing parity";
|
|
170
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
233
171
|
}, {
|
|
234
172
|
readonly label: "Generated matrix freshness";
|
|
235
173
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
236
174
|
}];
|
|
237
|
-
readonly runtimeEvidence: {
|
|
238
|
-
readonly managed: readonly [{
|
|
239
|
-
readonly label: "Submission parser and routing parity";
|
|
240
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
241
|
-
}, {
|
|
242
|
-
readonly label: "Runtime support validator";
|
|
243
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
244
|
-
}, {
|
|
245
|
-
readonly label: "Generated matrix freshness";
|
|
246
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
247
|
-
}];
|
|
248
|
-
};
|
|
249
175
|
};
|
|
250
176
|
readonly doubao: {
|
|
251
177
|
readonly displayName: "Doubao";
|
|
@@ -261,24 +187,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
261
187
|
readonly label: "Submission parser and routing parity";
|
|
262
188
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
263
189
|
}, {
|
|
264
|
-
readonly label: "
|
|
265
|
-
readonly href: "
|
|
190
|
+
readonly label: "Generated matrix freshness";
|
|
191
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
192
|
+
}];
|
|
193
|
+
readonly managedEvidence: readonly [{
|
|
194
|
+
readonly label: "Submission parser and routing parity";
|
|
195
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
266
196
|
}, {
|
|
267
197
|
readonly label: "Generated matrix freshness";
|
|
268
198
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
269
199
|
}];
|
|
270
|
-
readonly runtimeEvidence: {
|
|
271
|
-
readonly managed: readonly [{
|
|
272
|
-
readonly label: "Submission parser and routing parity";
|
|
273
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
274
|
-
}, {
|
|
275
|
-
readonly label: "Runtime support validator";
|
|
276
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
277
|
-
}, {
|
|
278
|
-
readonly label: "Generated matrix freshness";
|
|
279
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
280
|
-
}];
|
|
281
|
-
};
|
|
282
200
|
};
|
|
283
201
|
readonly "doubao-cn": {
|
|
284
202
|
readonly displayName: "Doubao (China)";
|
|
@@ -294,24 +212,16 @@ export declare const PROVIDER_PUBLIC_SUPPORT: {
|
|
|
294
212
|
readonly label: "Submission parser and routing parity";
|
|
295
213
|
readonly href: "../../contracts/test/submission.test.ts";
|
|
296
214
|
}, {
|
|
297
|
-
readonly label: "
|
|
298
|
-
readonly href: "
|
|
215
|
+
readonly label: "Generated matrix freshness";
|
|
216
|
+
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
217
|
+
}];
|
|
218
|
+
readonly managedEvidence: readonly [{
|
|
219
|
+
readonly label: "Submission parser and routing parity";
|
|
220
|
+
readonly href: "../../contracts/test/submission.test.ts";
|
|
299
221
|
}, {
|
|
300
222
|
readonly label: "Generated matrix freshness";
|
|
301
223
|
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
302
224
|
}];
|
|
303
|
-
readonly runtimeEvidence: {
|
|
304
|
-
readonly managed: readonly [{
|
|
305
|
-
readonly label: "Submission parser and routing parity";
|
|
306
|
-
readonly href: "../../contracts/test/submission.test.ts";
|
|
307
|
-
}, {
|
|
308
|
-
readonly label: "Runtime support validator";
|
|
309
|
-
readonly href: "../../contracts/test/runtime-support.test.ts";
|
|
310
|
-
}, {
|
|
311
|
-
readonly label: "Generated matrix freshness";
|
|
312
|
-
readonly href: "../../../scripts/validate/capability-matrix.test.ts";
|
|
313
|
-
}];
|
|
314
|
-
};
|
|
315
225
|
};
|
|
316
226
|
};
|
|
317
227
|
export declare function providerPublicSupport(provider: RunProvider): ProviderPublicSupport;
|
|
@@ -4,7 +4,6 @@ const COMMON_DOCS = [
|
|
|
4
4
|
];
|
|
5
5
|
const COMMON_EVIDENCE = [
|
|
6
6
|
{ label: "Submission parser and routing parity", href: "../../contracts/test/submission.test.ts" },
|
|
7
|
-
{ label: "Runtime support validator", href: "../../contracts/test/runtime-support.test.ts" },
|
|
8
7
|
{ label: "Generated matrix freshness", href: "../../../scripts/validate/capability-matrix.test.ts" }
|
|
9
8
|
];
|
|
10
9
|
const ANTHROPIC_LIVE_USER_EVIDENCE = [
|
|
@@ -23,22 +22,8 @@ const DEEPSEEK_LIVE_USER_EVIDENCE = [
|
|
|
23
22
|
href: "../../../apps/user-tests/test/live/live-sdk-comprehensive.test.ts"
|
|
24
23
|
}
|
|
25
24
|
];
|
|
26
|
-
const ANTHROPIC_MANAGED_EVIDENCE =
|
|
27
|
-
|
|
28
|
-
{ label: "Runtime support validator", href: "../../contracts/test/runtime-support.test.ts" }
|
|
29
|
-
];
|
|
30
|
-
const DEEPSEEK_MANAGED_EVIDENCE = [
|
|
31
|
-
...DEEPSEEK_LIVE_USER_EVIDENCE,
|
|
32
|
-
{ label: "Runtime support validator", href: "../../contracts/test/runtime-support.test.ts" }
|
|
33
|
-
];
|
|
34
|
-
export const RUNTIME_VALIDATION_SUPPORT = {
|
|
35
|
-
feature_runtime_mismatch: {
|
|
36
|
-
docsAnchor: "managed-unsupported-features",
|
|
37
|
-
docs: [{ label: "Runtime routing", href: "provider-runtime-capabilities.md#runtime-routing" }],
|
|
38
|
-
evidence: [{ label: "Submission parser and routing parity", href: "../../contracts/test/submission.test.ts" }],
|
|
39
|
-
enforcement: "collectManagedUnsupportedFeatures + selectRuntime"
|
|
40
|
-
}
|
|
41
|
-
};
|
|
25
|
+
const ANTHROPIC_MANAGED_EVIDENCE = ANTHROPIC_LIVE_USER_EVIDENCE;
|
|
26
|
+
const DEEPSEEK_MANAGED_EVIDENCE = DEEPSEEK_LIVE_USER_EVIDENCE;
|
|
42
27
|
/**
|
|
43
28
|
* Public provider support facts for generated SDK docs. Keep this metadata
|
|
44
29
|
* public-facing only: provider names, docs anchors, and evidence pointers.
|
|
@@ -50,54 +35,42 @@ export const PROVIDER_PUBLIC_SUPPORT = {
|
|
|
50
35
|
docsAnchor: "anthropic",
|
|
51
36
|
docs: COMMON_DOCS,
|
|
52
37
|
evidence: [...COMMON_EVIDENCE, ...ANTHROPIC_MANAGED_EVIDENCE],
|
|
53
|
-
|
|
54
|
-
managed: ANTHROPIC_MANAGED_EVIDENCE
|
|
55
|
-
}
|
|
38
|
+
managedEvidence: ANTHROPIC_MANAGED_EVIDENCE
|
|
56
39
|
},
|
|
57
40
|
deepseek: {
|
|
58
41
|
displayName: "DeepSeek",
|
|
59
42
|
docsAnchor: "deepseek",
|
|
60
43
|
docs: COMMON_DOCS,
|
|
61
44
|
evidence: [...COMMON_EVIDENCE, ...DEEPSEEK_MANAGED_EVIDENCE],
|
|
62
|
-
|
|
63
|
-
managed: DEEPSEEK_MANAGED_EVIDENCE
|
|
64
|
-
}
|
|
45
|
+
managedEvidence: DEEPSEEK_MANAGED_EVIDENCE
|
|
65
46
|
},
|
|
66
47
|
openai: {
|
|
67
48
|
displayName: "OpenAI",
|
|
68
49
|
docsAnchor: "openai",
|
|
69
50
|
docs: COMMON_DOCS,
|
|
70
51
|
evidence: COMMON_EVIDENCE,
|
|
71
|
-
|
|
72
|
-
managed: COMMON_EVIDENCE
|
|
73
|
-
}
|
|
52
|
+
managedEvidence: COMMON_EVIDENCE
|
|
74
53
|
},
|
|
75
54
|
gemini: {
|
|
76
55
|
displayName: "Gemini",
|
|
77
56
|
docsAnchor: "gemini",
|
|
78
57
|
docs: COMMON_DOCS,
|
|
79
58
|
evidence: COMMON_EVIDENCE,
|
|
80
|
-
|
|
81
|
-
managed: COMMON_EVIDENCE
|
|
82
|
-
}
|
|
59
|
+
managedEvidence: COMMON_EVIDENCE
|
|
83
60
|
},
|
|
84
61
|
mistral: {
|
|
85
62
|
displayName: "Mistral",
|
|
86
63
|
docsAnchor: "mistral",
|
|
87
64
|
docs: COMMON_DOCS,
|
|
88
65
|
evidence: COMMON_EVIDENCE,
|
|
89
|
-
|
|
90
|
-
managed: COMMON_EVIDENCE
|
|
91
|
-
}
|
|
66
|
+
managedEvidence: COMMON_EVIDENCE
|
|
92
67
|
},
|
|
93
68
|
openrouter: {
|
|
94
69
|
displayName: "OpenRouter",
|
|
95
70
|
docsAnchor: "openrouter",
|
|
96
71
|
docs: COMMON_DOCS,
|
|
97
72
|
evidence: COMMON_EVIDENCE,
|
|
98
|
-
|
|
99
|
-
managed: COMMON_EVIDENCE
|
|
100
|
-
}
|
|
73
|
+
managedEvidence: COMMON_EVIDENCE
|
|
101
74
|
},
|
|
102
75
|
// Doubao (ByteDance) via the official Ark API — international BytePlus gateway.
|
|
103
76
|
doubao: {
|
|
@@ -105,9 +78,7 @@ export const PROVIDER_PUBLIC_SUPPORT = {
|
|
|
105
78
|
docsAnchor: "doubao",
|
|
106
79
|
docs: COMMON_DOCS,
|
|
107
80
|
evidence: COMMON_EVIDENCE,
|
|
108
|
-
|
|
109
|
-
managed: COMMON_EVIDENCE
|
|
110
|
-
}
|
|
81
|
+
managedEvidence: COMMON_EVIDENCE
|
|
111
82
|
},
|
|
112
83
|
// Doubao (ByteDance) via the official Ark API — China Volcengine gateway.
|
|
113
84
|
"doubao-cn": {
|
|
@@ -115,9 +86,7 @@ export const PROVIDER_PUBLIC_SUPPORT = {
|
|
|
115
86
|
docsAnchor: "doubao-cn",
|
|
116
87
|
docs: COMMON_DOCS,
|
|
117
88
|
evidence: COMMON_EVIDENCE,
|
|
118
|
-
|
|
119
|
-
managed: COMMON_EVIDENCE
|
|
120
|
-
}
|
|
89
|
+
managedEvidence: COMMON_EVIDENCE
|
|
121
90
|
}
|
|
122
91
|
};
|
|
123
92
|
export function providerPublicSupport(provider) {
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* header on every request; the BFF rejects mismatches with HTTP 426
|
|
5
5
|
* `unsupported_protocol`.
|
|
6
6
|
*
|
|
7
|
-
* Bumps are coordinated: CLI and BFF release together, the
|
|
7
|
+
* Bumps are coordinated: CLI and BFF release together, the hosted API
|
|
8
8
|
* bundles the matching CLI artifact, and the e2e suite runs both with
|
|
9
9
|
* the new version.
|
|
10
10
|
*/
|
|
@@ -12,19 +12,19 @@ export declare const PROXY_PROTOCOL_VERSION: "1";
|
|
|
12
12
|
/**
|
|
13
13
|
* Streaming named-proxy protocol. A client that sends `"2"` in
|
|
14
14
|
* {@link PROXY_PROTOCOL_HEADER} opts into the streamed response path: the
|
|
15
|
-
*
|
|
16
|
-
*
|
|
15
|
+
* hosted API pipes the upstream body back unbuffered (no base64, no
|
|
16
|
+
* full-body JSON envelope) and carries the envelope metadata
|
|
17
17
|
* in the `x-aex-proxy-*` response headers below instead of a JSON envelope.
|
|
18
18
|
*
|
|
19
19
|
* Additive: `"1"` stays valid and keeps the buffered
|
|
20
20
|
* {@link ProxyResponseEnvelope}. Old runners keep working; new runners
|
|
21
|
-
* stream. The version is on the request header so the
|
|
21
|
+
* stream. The version is on the request header so the hosted API can serve
|
|
22
22
|
* both shapes without a coordinated CLI/BFF release.
|
|
23
23
|
*/
|
|
24
24
|
export declare const PROXY_PROTOCOL_VERSION_V2: "2";
|
|
25
25
|
export declare const PROXY_PROTOCOL_HEADER = "x-aex-proxy-protocol";
|
|
26
26
|
/**
|
|
27
|
-
* Response headers for the streamed (v2) named-proxy path. The
|
|
27
|
+
* Response headers for the streamed (v2) named-proxy path. The hosted API sets
|
|
28
28
|
* these BEFORE it starts streaming the upstream body, so the client can
|
|
29
29
|
* reconstruct the same fields the v1 {@link ProxyResponseEnvelope} carried
|
|
30
30
|
* without buffering. All values are plain strings; numeric fields are
|
|
@@ -166,7 +166,7 @@ export interface ProxyEndpointPolicy {
|
|
|
166
166
|
export interface BuildProxyIndexFileInput {
|
|
167
167
|
readonly runId: string;
|
|
168
168
|
/**
|
|
169
|
-
*
|
|
169
|
+
* Hosted API origin that serves `/api/runs/:runId/proxy/:endpointName`.
|
|
170
170
|
* When unset
|
|
171
171
|
* (or empty) the run has no reachable proxy plane and `proxyBaseUrl`
|
|
172
172
|
* resolves to `null`.
|
|
@@ -245,7 +245,7 @@ export declare function authShapeQueryName(shape: ProxyAuthShape): string | unde
|
|
|
245
245
|
* upstream's IP allowlist / rate-limit (`host`, `content-length`,
|
|
246
246
|
* `x-forwarded-*`, `x-real-ip`, `forwarded`).
|
|
247
247
|
*
|
|
248
|
-
* The
|
|
248
|
+
* The platform API provider-proxy and the dashboard MCP proxy strip exactly
|
|
249
249
|
* this set (both inject upstream auth separately — the provider key, or the
|
|
250
250
|
* Vault MCP-bundle headers, applied AFTER the strip). The dashboard
|
|
251
251
|
* customer HTTP proxy hard-denies this set MINUS `x-api-key`, because a
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// Wire format between the in-container runtime bridge (mounted at
|
|
2
2
|
// `/mnt/session/uploads/aex/aex`, invoked through `bun`) and
|
|
3
|
-
// the
|
|
3
|
+
// the hosted API's named proxy route
|
|
4
4
|
// (`POST /api/runs/:runId/proxy/:endpointName`).
|
|
5
5
|
//
|
|
6
6
|
// This module is the single source of truth for the request shape, the
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* header on every request; the BFF rejects mismatches with HTTP 426
|
|
14
14
|
* `unsupported_protocol`.
|
|
15
15
|
*
|
|
16
|
-
* Bumps are coordinated: CLI and BFF release together, the
|
|
16
|
+
* Bumps are coordinated: CLI and BFF release together, the hosted API
|
|
17
17
|
* bundles the matching CLI artifact, and the e2e suite runs both with
|
|
18
18
|
* the new version.
|
|
19
19
|
*/
|
|
@@ -21,19 +21,19 @@ export const PROXY_PROTOCOL_VERSION = "1";
|
|
|
21
21
|
/**
|
|
22
22
|
* Streaming named-proxy protocol. A client that sends `"2"` in
|
|
23
23
|
* {@link PROXY_PROTOCOL_HEADER} opts into the streamed response path: the
|
|
24
|
-
*
|
|
25
|
-
*
|
|
24
|
+
* hosted API pipes the upstream body back unbuffered (no base64, no
|
|
25
|
+
* full-body JSON envelope) and carries the envelope metadata
|
|
26
26
|
* in the `x-aex-proxy-*` response headers below instead of a JSON envelope.
|
|
27
27
|
*
|
|
28
28
|
* Additive: `"1"` stays valid and keeps the buffered
|
|
29
29
|
* {@link ProxyResponseEnvelope}. Old runners keep working; new runners
|
|
30
|
-
* stream. The version is on the request header so the
|
|
30
|
+
* stream. The version is on the request header so the hosted API can serve
|
|
31
31
|
* both shapes without a coordinated CLI/BFF release.
|
|
32
32
|
*/
|
|
33
33
|
export const PROXY_PROTOCOL_VERSION_V2 = "2";
|
|
34
34
|
export const PROXY_PROTOCOL_HEADER = "x-aex-proxy-protocol";
|
|
35
35
|
/**
|
|
36
|
-
* Response headers for the streamed (v2) named-proxy path. The
|
|
36
|
+
* Response headers for the streamed (v2) named-proxy path. The hosted API sets
|
|
37
37
|
* these BEFORE it starts streaming the upstream body, so the client can
|
|
38
38
|
* reconstruct the same fields the v1 {@link ProxyResponseEnvelope} carried
|
|
39
39
|
* without buffering. All values are plain strings; numeric fields are
|
|
@@ -147,7 +147,7 @@ export const PROXY_ERROR_CODES = [
|
|
|
147
147
|
export const PROXY_ENDPOINT_DEFAULTS = {
|
|
148
148
|
allowHeaders: [],
|
|
149
149
|
responseMode: "headers_only",
|
|
150
|
-
// 10 MiB. The body is buffered
|
|
150
|
+
// 10 MiB. The body is buffered in the hosted API to enforce this cap, while the
|
|
151
151
|
// launch default fits practical multimodal/tool POSTs without every endpoint
|
|
152
152
|
// needing an override.
|
|
153
153
|
maxRequestBytes: 10 * 1024 * 1024,
|
|
@@ -241,7 +241,7 @@ export function authShapeQueryName(shape) {
|
|
|
241
241
|
* upstream's IP allowlist / rate-limit (`host`, `content-length`,
|
|
242
242
|
* `x-forwarded-*`, `x-real-ip`, `forwarded`).
|
|
243
243
|
*
|
|
244
|
-
* The
|
|
244
|
+
* The platform API provider-proxy and the dashboard MCP proxy strip exactly
|
|
245
245
|
* this set (both inject upstream auth separately — the provider key, or the
|
|
246
246
|
* Vault MCP-bundle headers, applied AFTER the strip). The dashboard
|
|
247
247
|
* customer HTTP proxy hard-denies this set MINUS `x-api-key`, because a
|
|
@@ -5,9 +5,7 @@
|
|
|
5
5
|
*
|
|
6
6
|
* - `SkillRef` is the wire-level reference to a skill. Public run
|
|
7
7
|
* configs use storage-neutral `kind:"asset"` refs produced by the SDK
|
|
8
|
-
* upload path or by workspace catalog records.
|
|
9
|
-
* in the parser for wire compatibility, but the managed runtime rejects
|
|
10
|
-
* them at submission time.
|
|
8
|
+
* upload path or by workspace catalog records.
|
|
11
9
|
*
|
|
12
10
|
* - `McpServerRef` is the non-secret part of an MCP server declaration:
|
|
13
11
|
* `name` and `url`. Bearer / cookie / per-request headers travel in
|
|
@@ -30,7 +28,7 @@
|
|
|
30
28
|
* Keep this as the public source of truth for the SDK/CLI composition
|
|
31
29
|
* boundary.
|
|
32
30
|
*/
|
|
33
|
-
import { type JsonValue, type PlatformProxyEndpoint, type PlatformEnvironment
|
|
31
|
+
import { type JsonValue, type PlatformProxyEndpoint, type PlatformEnvironment } from "./submission.js";
|
|
34
32
|
import { type RunModel } from "./models.js";
|
|
35
33
|
import type { RuntimeSize } from "./runtime-sizes.js";
|
|
36
34
|
import { type PlatformPostHookInput } from "./post-hook.js";
|
|
@@ -82,7 +80,7 @@ export declare const SKILL_BUNDLE_LIMITS: {
|
|
|
82
80
|
/** Stored directory mode. */
|
|
83
81
|
readonly defaultDirMode: 493;
|
|
84
82
|
};
|
|
85
|
-
export type SkillRef =
|
|
83
|
+
export type SkillRef = AssetRef;
|
|
86
84
|
/**
|
|
87
85
|
* Storage-neutral uploaded asset reference. Runtime materialization resolves
|
|
88
86
|
* `assetId` privately; public callers never name object-store paths.
|
|
@@ -110,15 +108,8 @@ export interface ToolRef extends AssetRef {
|
|
|
110
108
|
readonly input_schema: ToolInputSchema;
|
|
111
109
|
readonly entry: string;
|
|
112
110
|
}
|
|
113
|
-
export interface ProviderSkillRef {
|
|
114
|
-
readonly kind: "provider";
|
|
115
|
-
readonly vendor: "anthropic" | "custom";
|
|
116
|
-
readonly skillId: string;
|
|
117
|
-
readonly version?: string;
|
|
118
|
-
}
|
|
119
111
|
/** Content-hash format: `sha256:<64 lowercase hex>`. */
|
|
120
112
|
export declare const INLINE_CONTENT_HASH_PATTERN: RegExp;
|
|
121
|
-
export declare function isProviderSkillRef(ref: SkillRef): ref is ProviderSkillRef;
|
|
122
113
|
export declare function isAssetRef(ref: SkillRef | AgentsMdRef | FileRef): ref is AssetRef;
|
|
123
114
|
/**
|
|
124
115
|
* Asset ids are storage-neutral product ids. Current uploads derive the id from
|
|
@@ -153,10 +144,8 @@ export declare const MOUNT_PATH_MAX_LENGTH = 512;
|
|
|
153
144
|
*/
|
|
154
145
|
export declare function assertValidMountPath(value: string, field: string): void;
|
|
155
146
|
/**
|
|
156
|
-
* Parse a `SkillRef` from untrusted input.
|
|
157
|
-
*
|
|
158
|
-
* `kind: "asset"` and `kind: "provider"` are valid; all other historical
|
|
159
|
-
* wire shapes (including storage-specific refs) are rejected.
|
|
147
|
+
* Parse a `SkillRef` from untrusted input. Only asset-backed skill refs are
|
|
148
|
+
* accepted on the public surface.
|
|
160
149
|
*/
|
|
161
150
|
export declare function parseSkillRef(input: unknown, path: string): SkillRef;
|
|
162
151
|
/**
|
|
@@ -308,8 +297,6 @@ export interface RunRequestConfig {
|
|
|
308
297
|
readonly environment?: PlatformEnvironment;
|
|
309
298
|
/** Managed runtime size preset (see {@link RuntimeSize}). */
|
|
310
299
|
readonly runtimeSize?: RuntimeSize;
|
|
311
|
-
/** Product placement region. Omitted lets the hosted platform infer/fallback. */
|
|
312
|
-
readonly region?: Region;
|
|
313
300
|
/** Run deadline as a duration string (`"1h"`, `"30m"`); bounded [1m, 6h] server-side. */
|
|
314
301
|
readonly timeout?: string;
|
|
315
302
|
/** Post-agent-run verifier command. Empty command is treated as omitted. */
|
|
@@ -331,8 +318,8 @@ export declare function parseRunRequestConfig(input: unknown): RunRequestConfig;
|
|
|
331
318
|
* `mcpServerSecrets` half is what enters run-scoped custody.
|
|
332
319
|
*
|
|
333
320
|
* `prompt` is normalised to `readonly string[]` (single-string callers
|
|
334
|
-
* get wrapped in a length-1 array) so the wire payload, the
|
|
335
|
-
* the audit log don't have to re-handle two shapes.
|
|
321
|
+
* get wrapped in a length-1 array) so the wire payload, the hosted API,
|
|
322
|
+
* and the audit log don't have to re-handle two shapes.
|
|
336
323
|
*/
|
|
337
324
|
export interface NormalisedRunRequestConfig {
|
|
338
325
|
readonly model: RunModel;
|