@alpic-ai/api 0.0.0-dev.gf241aee → 0.0.0-dev.gf24c182
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/dist/index.d.mts +1558 -48
- package/dist/index.mjs +929 -394
- package/package.json +26 -10
package/dist/index.mjs
CHANGED
|
@@ -2,7 +2,7 @@ import { z } from "zod";
|
|
|
2
2
|
import * as z$1 from "zod/v4";
|
|
3
3
|
import { oc } from "@orpc/contract";
|
|
4
4
|
import ms from "ms";
|
|
5
|
-
//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.
|
|
5
|
+
//#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_supports-color@7.2.0_zod@4.5.4/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
|
|
6
6
|
/**
|
|
7
7
|
* Reusable URL validation that disallows javascript: scheme
|
|
8
8
|
*/
|
|
@@ -169,11 +169,22 @@ z$1.object({
|
|
|
169
169
|
token: z$1.string(),
|
|
170
170
|
token_type_hint: z$1.string().optional()
|
|
171
171
|
}).strip();
|
|
172
|
-
|
|
172
|
+
//#endregion
|
|
173
|
+
//#region ../domains/dist/index.mjs
|
|
174
|
+
const AI_PLATFORMS = ["chatgpt", "claudeai"];
|
|
175
|
+
const platformSchema = z.enum(AI_PLATFORMS);
|
|
173
176
|
const PLATFORM_LABELS = {
|
|
174
177
|
chatgpt: "ChatGPT",
|
|
175
178
|
claudeai: "Claude.ai"
|
|
176
179
|
};
|
|
180
|
+
const WAF_PLATFORMS = [
|
|
181
|
+
"akamai",
|
|
182
|
+
"cato",
|
|
183
|
+
"cloudflare",
|
|
184
|
+
"fastly"
|
|
185
|
+
];
|
|
186
|
+
const ALLOWED_PLATFORMS = [...AI_PLATFORMS, ...WAF_PLATFORMS];
|
|
187
|
+
const allowedPlatformSchema = z.enum(ALLOWED_PLATFORMS);
|
|
177
188
|
const auditStatusSchema = z.enum([
|
|
178
189
|
"pending",
|
|
179
190
|
"partial",
|
|
@@ -246,6 +257,25 @@ z.object({
|
|
|
246
257
|
clientSecret: z.string(),
|
|
247
258
|
clientScopes: z.array(z.string())
|
|
248
259
|
});
|
|
260
|
+
const creditEntryReasonSchema = z.enum([
|
|
261
|
+
"free_seed",
|
|
262
|
+
"paid_conversion_floor",
|
|
263
|
+
"top_up",
|
|
264
|
+
"usage",
|
|
265
|
+
"admin_adjustment"
|
|
266
|
+
]);
|
|
267
|
+
z.enum(["playground"]);
|
|
268
|
+
z.number().int().min(500);
|
|
269
|
+
const creditActivityEntrySchema = z.object({
|
|
270
|
+
reason: creditEntryReasonSchema,
|
|
271
|
+
day: z.number(),
|
|
272
|
+
amountInNanoUSD: z.number(),
|
|
273
|
+
messageCount: z.number().nullable()
|
|
274
|
+
});
|
|
275
|
+
z.object({
|
|
276
|
+
balanceInNanoUSD: z.number(),
|
|
277
|
+
recentActivity: z.array(creditActivityEntrySchema)
|
|
278
|
+
});
|
|
249
279
|
const deploymentStatusSchema$1 = z.enum([
|
|
250
280
|
"ongoing",
|
|
251
281
|
"deployed",
|
|
@@ -273,34 +303,51 @@ const deploymentSummarySchema = z.object({
|
|
|
273
303
|
createdAt: z.coerce.date(),
|
|
274
304
|
updatedAt: z.coerce.date()
|
|
275
305
|
});
|
|
276
|
-
/**
|
|
277
|
-
* Public environment
|
|
278
|
-
*
|
|
279
|
-
* No OAuth metadata exposed.
|
|
280
|
-
*/
|
|
306
|
+
/** Public environment: answers anonymously and exposes no OAuth metadata. */
|
|
281
307
|
const publicEnvironmentSchema = z.object({
|
|
308
|
+
allowsAnonymous: z.literal(true),
|
|
309
|
+
oAuthMetadata: z.strictObject({})
|
|
310
|
+
});
|
|
311
|
+
/** Protected environment whose external resource metadata URL is returned in the WWW-Authenticate header on the first 401; everything after is handled outside the MCP server scope. */
|
|
312
|
+
const externalResourceMetadataEnvironmentSchema = z.object({
|
|
313
|
+
allowsAnonymous: z.boolean(),
|
|
314
|
+
oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
|
|
315
|
+
scope: z.string().optional()
|
|
316
|
+
});
|
|
317
|
+
/** Protected environment whose own /.well-known/oauth-protected-resource endpoint points at an external authorization server; everything after is handled outside the MCP server scope. */
|
|
318
|
+
const externalAuthorizationServerEnvironmentSchema = z.object({
|
|
319
|
+
allowsAnonymous: z.boolean(),
|
|
320
|
+
oAuthMetadata: z.object({
|
|
321
|
+
externalAuthorizationServerUrl: z.url(),
|
|
322
|
+
resourceMetadata: OAuthProtectedResourceMetadataSchema.optional()
|
|
323
|
+
}),
|
|
324
|
+
scope: z.string().optional()
|
|
325
|
+
});
|
|
326
|
+
/** Standalone protected environment: the server itself exposes both the /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server endpoints. */
|
|
327
|
+
const standaloneEnvironmentSchema = z.object({
|
|
328
|
+
allowsAnonymous: z.boolean(),
|
|
329
|
+
oAuthMetadata: z.object({
|
|
330
|
+
authorizationServerMetadata: z.union([OAuthMetadataSchema, OpenIdProviderDiscoveryMetadataSchema]),
|
|
331
|
+
resourceMetadata: OAuthProtectedResourceMetadataSchema.optional()
|
|
332
|
+
}),
|
|
333
|
+
scope: z.string().optional()
|
|
334
|
+
});
|
|
335
|
+
/** Protected environment that enforces authentication but advertises no OAuth discovery metadata; clients must obtain credentials out-of-band. */
|
|
336
|
+
const protectedWithoutDiscoveryEnvironmentSchema = z.object({
|
|
337
|
+
allowsAnonymous: z.literal(false),
|
|
338
|
+
oAuthMetadata: z.strictObject({}),
|
|
339
|
+
scope: z.string().optional()
|
|
340
|
+
});
|
|
341
|
+
const legacyPublicEnvironmentSchema = z.object({
|
|
282
342
|
isPublic: z.literal(true),
|
|
283
343
|
oAuthMetadata: z.undefined().optional()
|
|
284
344
|
});
|
|
285
|
-
|
|
286
|
-
* Protected environment with an external resource metadata URL
|
|
287
|
-
*
|
|
288
|
-
* An external resource metadata URL is returned in the WWW-Authenticate header during the first 401 response.
|
|
289
|
-
* Everything that follows is handled outside of the MCP server scope.
|
|
290
|
-
*/
|
|
291
|
-
const externalResourceMetadataEnvironmentSchema = z.object({
|
|
345
|
+
const legacyExternalResourceMetadataEnvironmentSchema = z.object({
|
|
292
346
|
isPublic: z.literal(false),
|
|
293
347
|
oAuthMetadata: z.object({ externalResourceMetadataUrl: z.url() }),
|
|
294
348
|
scope: z.string().optional()
|
|
295
349
|
});
|
|
296
|
-
|
|
297
|
-
* Protected environment with an external authorization server URL
|
|
298
|
-
*
|
|
299
|
-
* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
|
|
300
|
-
* An external authorization server URL is returned when requesting the endpoint.
|
|
301
|
-
* Everything that follows is handled outside of the MCP server scope.
|
|
302
|
-
*/
|
|
303
|
-
const externalAuthorizationServerEnvironmentSchema = z.object({
|
|
350
|
+
const legacyExternalAuthorizationServerEnvironmentSchema = z.object({
|
|
304
351
|
isPublic: z.literal(false),
|
|
305
352
|
oAuthMetadata: z.object({
|
|
306
353
|
externalAuthorizationServerUrl: z.url(),
|
|
@@ -308,13 +355,7 @@ const externalAuthorizationServerEnvironmentSchema = z.object({
|
|
|
308
355
|
}),
|
|
309
356
|
scope: z.string().optional()
|
|
310
357
|
});
|
|
311
|
-
|
|
312
|
-
* Standalone protected environment
|
|
313
|
-
*
|
|
314
|
-
* The server itself exposes the /.well-known/oauth-protected-resource endpoint.
|
|
315
|
-
* The server itself exposes the /.well-known/oauth-authorization-server endpoint.
|
|
316
|
-
*/
|
|
317
|
-
const standaloneEnvironmentSchema = z.object({
|
|
358
|
+
const legacyStandaloneEnvironmentSchema = z.object({
|
|
318
359
|
isPublic: z.literal(false),
|
|
319
360
|
oAuthMetadata: z.object({
|
|
320
361
|
authorizationServerMetadata: z.union([OAuthMetadataSchema, OpenIdProviderDiscoveryMetadataSchema]),
|
|
@@ -322,14 +363,7 @@ const standaloneEnvironmentSchema = z.object({
|
|
|
322
363
|
}),
|
|
323
364
|
scope: z.string().optional()
|
|
324
365
|
});
|
|
325
|
-
|
|
326
|
-
* Protected environment without OAuth discovery
|
|
327
|
-
*
|
|
328
|
-
* The server enforces authentication but exposes no OAuth discovery metadata.
|
|
329
|
-
* Neither /.well-known/oauth-protected-resource nor /.well-known/oauth-authorization-server
|
|
330
|
-
* are advertised. Clients must obtain credentials out-of-band.
|
|
331
|
-
*/
|
|
332
|
-
const protectedWithoutDiscoveryEnvironmentSchema = z.object({
|
|
366
|
+
const legacyProtectedWithoutDiscoveryEnvironmentSchema = z.object({
|
|
333
367
|
isPublic: z.literal(false),
|
|
334
368
|
oAuthMetadata: z.strictObject({}),
|
|
335
369
|
scope: z.string().optional()
|
|
@@ -339,11 +373,21 @@ z.union([
|
|
|
339
373
|
externalResourceMetadataEnvironmentSchema,
|
|
340
374
|
externalAuthorizationServerEnvironmentSchema,
|
|
341
375
|
standaloneEnvironmentSchema,
|
|
342
|
-
protectedWithoutDiscoveryEnvironmentSchema
|
|
376
|
+
protectedWithoutDiscoveryEnvironmentSchema,
|
|
377
|
+
legacyPublicEnvironmentSchema,
|
|
378
|
+
legacyExternalResourceMetadataEnvironmentSchema,
|
|
379
|
+
legacyExternalAuthorizationServerEnvironmentSchema,
|
|
380
|
+
legacyStandaloneEnvironmentSchema,
|
|
381
|
+
legacyProtectedWithoutDiscoveryEnvironmentSchema
|
|
382
|
+
]);
|
|
383
|
+
const playgroundModelSchema = z.enum([
|
|
384
|
+
"global.anthropic.claude-haiku-4-5-20251001-v1:0",
|
|
385
|
+
"global.anthropic.claude-sonnet-4-5-20250929-v1:0",
|
|
386
|
+
"openai.gpt-5.4",
|
|
387
|
+
"openai.gpt-5.5"
|
|
343
388
|
]);
|
|
344
|
-
const allowedPlatformSchema = platformSchema;
|
|
345
389
|
const environmentDomainSchema = z.object({
|
|
346
|
-
|
|
390
|
+
name: z.string(),
|
|
347
391
|
status: z.enum([
|
|
348
392
|
"ongoing",
|
|
349
393
|
"deployed",
|
|
@@ -361,6 +405,7 @@ const environmentSchema$1 = z.object({
|
|
|
361
405
|
latestDeployment: deploymentSummarySchema.optional(),
|
|
362
406
|
openaiAppsChallenge: z.string().nullable().optional(),
|
|
363
407
|
isPlaygroundEnabled: z.boolean(),
|
|
408
|
+
playgroundModel: playgroundModelSchema,
|
|
364
409
|
isIpWhitelistEnabled: z.boolean(),
|
|
365
410
|
ipAllowlist: z.array(z.string()).nullable(),
|
|
366
411
|
allowedPlatforms: z.array(allowedPlatformSchema),
|
|
@@ -370,11 +415,20 @@ const environmentSchema$1 = z.object({
|
|
|
370
415
|
});
|
|
371
416
|
const environmentWithDomainsSchema = environmentSchema$1.extend({ domains: z.array(environmentDomainSchema) });
|
|
372
417
|
z.object({
|
|
418
|
+
sessionReplayEnabled: z.boolean(),
|
|
419
|
+
collectRequestPayload: z.boolean(),
|
|
420
|
+
collectResponsePayload: z.boolean(),
|
|
421
|
+
collectErrorMessage: z.boolean(),
|
|
422
|
+
collectUserData: z.boolean(),
|
|
423
|
+
identityTraitKey: z.string().min(1).max(200).nullable()
|
|
424
|
+
});
|
|
425
|
+
const feedbackSchema = z.object({
|
|
373
426
|
id: z.string(),
|
|
374
427
|
createdAt: z.coerce.date(),
|
|
375
428
|
environmentId: z.string(),
|
|
376
429
|
content: z.string(),
|
|
377
|
-
source: z.enum(["model", "user"])
|
|
430
|
+
source: z.enum(["model", "user"]),
|
|
431
|
+
clientName: z.string().nullable()
|
|
378
432
|
});
|
|
379
433
|
z.object({
|
|
380
434
|
content: z.string(),
|
|
@@ -390,7 +444,7 @@ const intentCategoryColorSchema = z.enum([
|
|
|
390
444
|
"pink",
|
|
391
445
|
"gray"
|
|
392
446
|
]);
|
|
393
|
-
intentCategoryColorSchema.options;
|
|
447
|
+
const INTENT_CATEGORY_COLORS = intentCategoryColorSchema.options;
|
|
394
448
|
const intentCategorySchema = z.object({
|
|
395
449
|
id: z.string(),
|
|
396
450
|
createdAt: z.coerce.date(),
|
|
@@ -398,7 +452,7 @@ const intentCategorySchema = z.object({
|
|
|
398
452
|
name: z.string(),
|
|
399
453
|
color: intentCategoryColorSchema
|
|
400
454
|
});
|
|
401
|
-
z.object({
|
|
455
|
+
const intentCategorySummarySchema = z.object({
|
|
402
456
|
id: z.string(),
|
|
403
457
|
name: z.string(),
|
|
404
458
|
color: intentCategoryColorSchema,
|
|
@@ -410,6 +464,7 @@ z.object({
|
|
|
410
464
|
environmentId: z.string(),
|
|
411
465
|
toolName: z.string(),
|
|
412
466
|
message: z.string(),
|
|
467
|
+
clientName: z.string().nullable(),
|
|
413
468
|
categories: z.array(intentCategorySchema)
|
|
414
469
|
});
|
|
415
470
|
const signalCategorySchema = z.object({
|
|
@@ -468,12 +523,262 @@ z.object({
|
|
|
468
523
|
createdAt: z.coerce.date(),
|
|
469
524
|
updatedAt: z.coerce.date()
|
|
470
525
|
});
|
|
526
|
+
const alpicMcpRequestLogSchema = z.object({
|
|
527
|
+
type: z.literal("mcp_request"),
|
|
528
|
+
method: z.string()
|
|
529
|
+
});
|
|
530
|
+
const alpicMcpErrorLogSchema = z.object({
|
|
531
|
+
type: z.literal("mcp_error"),
|
|
532
|
+
method: z.string(),
|
|
533
|
+
error: z.string()
|
|
534
|
+
});
|
|
535
|
+
z.union([alpicMcpRequestLogSchema, alpicMcpErrorLogSchema]);
|
|
471
536
|
z.enum([
|
|
472
537
|
"INFO",
|
|
473
538
|
"WARNING",
|
|
474
539
|
"DEBUG",
|
|
475
540
|
"ERROR"
|
|
476
541
|
]);
|
|
542
|
+
/** Only names a vendor actually ships belong here: lookalikes like `claude-code-test` are customers' own scripts. */
|
|
543
|
+
const MCP_CLIENT_GROUPS = [
|
|
544
|
+
{
|
|
545
|
+
id: "claude_code",
|
|
546
|
+
label: "Claude Code",
|
|
547
|
+
vendor: "anthropic",
|
|
548
|
+
rawNames: ["claude-code", "Anthropic/ClaudeCodeDesktop"]
|
|
549
|
+
},
|
|
550
|
+
{
|
|
551
|
+
id: "claude",
|
|
552
|
+
label: "Claude",
|
|
553
|
+
vendor: "anthropic",
|
|
554
|
+
rawNames: [
|
|
555
|
+
"Anthropic/ClaudeAI",
|
|
556
|
+
"claude-ai",
|
|
557
|
+
"claude",
|
|
558
|
+
"Claude",
|
|
559
|
+
"claude-desktop",
|
|
560
|
+
"claude-desktop-3p"
|
|
561
|
+
]
|
|
562
|
+
},
|
|
563
|
+
{
|
|
564
|
+
id: "claude_mobile",
|
|
565
|
+
label: "Claude mobile",
|
|
566
|
+
vendor: "anthropic",
|
|
567
|
+
rawNames: ["claude-ios", "ClaudeAndroid"]
|
|
568
|
+
},
|
|
569
|
+
{
|
|
570
|
+
id: "claude_cowork",
|
|
571
|
+
label: "Claude Cowork",
|
|
572
|
+
vendor: "anthropic",
|
|
573
|
+
rawNames: ["Anthropic/Cowork"]
|
|
574
|
+
},
|
|
575
|
+
{
|
|
576
|
+
id: "claude_toolbox",
|
|
577
|
+
label: "Claude Toolbox",
|
|
578
|
+
vendor: "anthropic",
|
|
579
|
+
rawNames: ["Anthropic/Toolbox", "Anthropic/toolbox-bootstrap"]
|
|
580
|
+
},
|
|
581
|
+
{
|
|
582
|
+
id: "anthropic_api",
|
|
583
|
+
label: "Anthropic API",
|
|
584
|
+
vendor: "anthropic",
|
|
585
|
+
rawNames: ["Anthropic/API"]
|
|
586
|
+
},
|
|
587
|
+
{
|
|
588
|
+
id: "anthropic_connector_refresh",
|
|
589
|
+
label: "Anthropic (connector refresh)",
|
|
590
|
+
vendor: "anthropic",
|
|
591
|
+
rawNames: ["Anthropic"]
|
|
592
|
+
},
|
|
593
|
+
{
|
|
594
|
+
id: "codex",
|
|
595
|
+
label: "Codex",
|
|
596
|
+
vendor: "openai",
|
|
597
|
+
rawNames: [
|
|
598
|
+
"codex-mcp-client",
|
|
599
|
+
"codex",
|
|
600
|
+
"Codex",
|
|
601
|
+
"codex-cli",
|
|
602
|
+
"openai-mcp (Codex)"
|
|
603
|
+
]
|
|
604
|
+
},
|
|
605
|
+
{
|
|
606
|
+
id: "chatgpt",
|
|
607
|
+
label: "ChatGPT",
|
|
608
|
+
vendor: "openai",
|
|
609
|
+
rawNames: ["openai-mcp (ChatGPT)"]
|
|
610
|
+
},
|
|
611
|
+
{
|
|
612
|
+
id: "openai_responses_api",
|
|
613
|
+
label: "OpenAI Responses API",
|
|
614
|
+
vendor: "openai",
|
|
615
|
+
rawNames: ["openai-mcp (Responses API)"]
|
|
616
|
+
},
|
|
617
|
+
{
|
|
618
|
+
id: "openai_agent_builder",
|
|
619
|
+
label: "OpenAI Agent Builder",
|
|
620
|
+
vendor: "openai",
|
|
621
|
+
rawNames: ["openai-mcp (Agent Builder)"]
|
|
622
|
+
},
|
|
623
|
+
{
|
|
624
|
+
id: "openai_other",
|
|
625
|
+
label: "OpenAI Other",
|
|
626
|
+
vendor: "openai",
|
|
627
|
+
rawNames: ["openai-mcp"]
|
|
628
|
+
},
|
|
629
|
+
{
|
|
630
|
+
id: "cursor",
|
|
631
|
+
label: "Cursor",
|
|
632
|
+
vendor: "cursor",
|
|
633
|
+
rawNames: [
|
|
634
|
+
"cursor-vscode",
|
|
635
|
+
"Cursor",
|
|
636
|
+
"cursor"
|
|
637
|
+
]
|
|
638
|
+
},
|
|
639
|
+
{
|
|
640
|
+
id: "cline",
|
|
641
|
+
label: "Cline",
|
|
642
|
+
vendor: "cline",
|
|
643
|
+
rawNames: [
|
|
644
|
+
"Cline",
|
|
645
|
+
"cline",
|
|
646
|
+
"@cline/core"
|
|
647
|
+
]
|
|
648
|
+
},
|
|
649
|
+
{
|
|
650
|
+
id: "github_copilot",
|
|
651
|
+
label: "GitHub Copilot",
|
|
652
|
+
vendor: "githubCopilot",
|
|
653
|
+
rawNames: [
|
|
654
|
+
"Copilot",
|
|
655
|
+
"github-copilot-developer",
|
|
656
|
+
"Copilot MCP Gateway",
|
|
657
|
+
"Xcode/copilot-xcode"
|
|
658
|
+
]
|
|
659
|
+
},
|
|
660
|
+
{
|
|
661
|
+
id: "gemini_cli",
|
|
662
|
+
label: "Gemini CLI",
|
|
663
|
+
vendor: "google",
|
|
664
|
+
rawNames: ["gemini-cli-mcp-client", "gemini-cli"]
|
|
665
|
+
},
|
|
666
|
+
{
|
|
667
|
+
id: "antigravity",
|
|
668
|
+
label: "Antigravity",
|
|
669
|
+
vendor: "google",
|
|
670
|
+
rawNames: ["antigravity-client"]
|
|
671
|
+
},
|
|
672
|
+
{
|
|
673
|
+
id: "gemini",
|
|
674
|
+
label: "Gemini",
|
|
675
|
+
vendor: "google",
|
|
676
|
+
rawNames: ["Gemini", "google-ai-edge-gallery"]
|
|
677
|
+
},
|
|
678
|
+
{
|
|
679
|
+
id: "windsurf",
|
|
680
|
+
label: "Windsurf",
|
|
681
|
+
vendor: "windsurf",
|
|
682
|
+
rawNames: ["Windsurf", "windsurf-client"]
|
|
683
|
+
},
|
|
684
|
+
{
|
|
685
|
+
id: "mistral",
|
|
686
|
+
label: "Mistral / Le Chat",
|
|
687
|
+
vendor: "mistral",
|
|
688
|
+
rawNames: ["Mistral"],
|
|
689
|
+
rawNamePrefixes: ["connector:custom-mcp:"]
|
|
690
|
+
},
|
|
691
|
+
{
|
|
692
|
+
id: "n8n",
|
|
693
|
+
label: "n8n",
|
|
694
|
+
vendor: "n8n",
|
|
695
|
+
rawNames: [
|
|
696
|
+
"@n8n/n8n-nodes-langchain.mcpClient",
|
|
697
|
+
"@n8n/n8n-nodes-langchain.mcpClientTool",
|
|
698
|
+
"n8n"
|
|
699
|
+
]
|
|
700
|
+
},
|
|
701
|
+
{
|
|
702
|
+
id: "alpic_playground",
|
|
703
|
+
label: "Alpic Playground",
|
|
704
|
+
vendor: "alpic",
|
|
705
|
+
rawNames: ["alpic-playground", "playground"]
|
|
706
|
+
},
|
|
707
|
+
{
|
|
708
|
+
id: "opencode",
|
|
709
|
+
label: "opencode",
|
|
710
|
+
vendor: "opencode",
|
|
711
|
+
rawNames: ["opencode"]
|
|
712
|
+
},
|
|
713
|
+
{
|
|
714
|
+
id: "zed",
|
|
715
|
+
label: "Zed",
|
|
716
|
+
vendor: "zed",
|
|
717
|
+
rawNames: ["Zed", "zed"]
|
|
718
|
+
},
|
|
719
|
+
{
|
|
720
|
+
id: "zapier",
|
|
721
|
+
label: "Zapier",
|
|
722
|
+
vendor: "zapier",
|
|
723
|
+
rawNames: ["Zapier", "zapier"]
|
|
724
|
+
},
|
|
725
|
+
{
|
|
726
|
+
id: "make",
|
|
727
|
+
label: "Make",
|
|
728
|
+
vendor: "make",
|
|
729
|
+
rawNames: ["Make", "make"]
|
|
730
|
+
},
|
|
731
|
+
{
|
|
732
|
+
id: "librechat",
|
|
733
|
+
label: "LibreChat",
|
|
734
|
+
vendor: "mcp",
|
|
735
|
+
rawNames: ["LibreChat", "librechat"]
|
|
736
|
+
},
|
|
737
|
+
{
|
|
738
|
+
id: "jan",
|
|
739
|
+
label: "Jan",
|
|
740
|
+
vendor: "mcp",
|
|
741
|
+
rawNames: ["Jan", "jan"]
|
|
742
|
+
},
|
|
743
|
+
{
|
|
744
|
+
id: "goose",
|
|
745
|
+
label: "goose",
|
|
746
|
+
vendor: "mcp",
|
|
747
|
+
rawNames: ["goose", "Goose"]
|
|
748
|
+
},
|
|
749
|
+
{
|
|
750
|
+
id: "mcphost",
|
|
751
|
+
label: "mcphost",
|
|
752
|
+
vendor: "mcp",
|
|
753
|
+
rawNames: ["mcphost"]
|
|
754
|
+
},
|
|
755
|
+
{
|
|
756
|
+
id: "mcporter",
|
|
757
|
+
label: "mcporter",
|
|
758
|
+
vendor: "mcp",
|
|
759
|
+
rawNames: ["mcporter"]
|
|
760
|
+
},
|
|
761
|
+
{
|
|
762
|
+
id: "rmcp",
|
|
763
|
+
label: "rmcp",
|
|
764
|
+
vendor: "mcp",
|
|
765
|
+
rawNames: ["rmcp"]
|
|
766
|
+
},
|
|
767
|
+
{
|
|
768
|
+
id: "unnamed_client",
|
|
769
|
+
label: "Unnamed client",
|
|
770
|
+
vendor: "mcp",
|
|
771
|
+
rawNames: [
|
|
772
|
+
"mcp",
|
|
773
|
+
"unknown",
|
|
774
|
+
""
|
|
775
|
+
]
|
|
776
|
+
}
|
|
777
|
+
];
|
|
778
|
+
/** A source pattern, not a RegExp, because analytics renders the same rule into ClickHouse RE2, which shares this syntax. */
|
|
779
|
+
const MCP_REMOTE_WRAPPER_SUFFIX = String.raw` \(via mcp-remote [^\n]+?\)$`;
|
|
780
|
+
new RegExp(MCP_REMOTE_WRAPPER_SUFFIX);
|
|
781
|
+
new Map(MCP_CLIENT_GROUPS.map((group) => [group.id, group]));
|
|
477
782
|
const runtimeSchema = z.enum([
|
|
478
783
|
"python3.13",
|
|
479
784
|
"python3.14",
|
|
@@ -502,15 +807,27 @@ z.object({
|
|
|
502
807
|
environments: z.array(environmentWithDomainsSchema),
|
|
503
808
|
productionEnvironment: environmentWithDomainsSchema.nullable()
|
|
504
809
|
});
|
|
810
|
+
const domainFailureReasonSchema = z.enum([
|
|
811
|
+
"caa",
|
|
812
|
+
"dns",
|
|
813
|
+
"invalid_domain",
|
|
814
|
+
"other"
|
|
815
|
+
]);
|
|
816
|
+
const projectDomainMappingSchema = z.object({
|
|
817
|
+
pathPrefix: z.string(),
|
|
818
|
+
environment: environmentSchema$1
|
|
819
|
+
});
|
|
505
820
|
z.object({
|
|
506
|
-
|
|
821
|
+
name: z.string(),
|
|
507
822
|
createdAt: z.coerce.date(),
|
|
508
823
|
status: z.enum([
|
|
509
824
|
"ongoing",
|
|
510
825
|
"deployed",
|
|
511
826
|
"failed"
|
|
512
827
|
]),
|
|
513
|
-
|
|
828
|
+
failureReason: domainFailureReasonSchema.nullable(),
|
|
829
|
+
environment: environmentSchema$1,
|
|
830
|
+
mappings: z.array(projectDomainMappingSchema)
|
|
514
831
|
});
|
|
515
832
|
const serverFieldsSchema$1 = z.object({
|
|
516
833
|
$schema: z.string(),
|
|
@@ -539,15 +856,7 @@ z.object({
|
|
|
539
856
|
serverFields: serverFieldsSchema$1,
|
|
540
857
|
source: z.enum(["registry", "defaults"])
|
|
541
858
|
});
|
|
542
|
-
/**
|
|
543
|
-
* Returns a variant of a `maxLength`-constrained string that clamps (truncates) instead of
|
|
544
|
-
* rejecting on overflow — used for AI-generated copy where the model routinely overshoots.
|
|
545
|
-
*
|
|
546
|
-
* NOTE: this rebuilds the schema from scratch, carrying over only `maxLength` (as a clamp),
|
|
547
|
-
* `minLength`, and the description. Any other validators on the source field (`.regex()`,
|
|
548
|
-
* `.email()`, custom refinements) are intentionally dropped — this helper is meant for plain
|
|
549
|
-
* free-text length caps only. A field with `null` `maxLength` is returned unchanged.
|
|
550
|
-
*/
|
|
859
|
+
/** Clamps instead of rejecting on max-length overflow (for AI-generated copy that overshoots); intentionally carries over only maxLength, minLength, and description, dropping any other validators. */
|
|
551
860
|
const clampStringField = (field) => {
|
|
552
861
|
const max = field.maxLength;
|
|
553
862
|
if (max === null) return field;
|
|
@@ -555,6 +864,10 @@ const clampStringField = (field) => {
|
|
|
555
864
|
const withMin = field.minLength === null ? clamped : clamped.min(field.minLength);
|
|
556
865
|
return field.description ? withMin.describe(field.description) : withMin;
|
|
557
866
|
};
|
|
867
|
+
const unboundedArrayField = (field) => {
|
|
868
|
+
const unbounded = z.array(field.element);
|
|
869
|
+
return field.description ? unbounded.describe(field.description) : unbounded;
|
|
870
|
+
};
|
|
558
871
|
const toolDefinitionSchema = z.object({
|
|
559
872
|
name: z.string(),
|
|
560
873
|
title: z.string().optional().describe("Human-friendly name for the tool, used in the UI. If not provided, `name` will be used."),
|
|
@@ -567,17 +880,28 @@ const toolDefinitionSchema = z.object({
|
|
|
567
880
|
}).optional()
|
|
568
881
|
});
|
|
569
882
|
const positiveTestCaseSchema = z.object({
|
|
570
|
-
scenario: z.string().describe("Short label for what this case demonstrates."),
|
|
571
|
-
userPrompt: z.string().describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
|
|
883
|
+
scenario: z.string().min(1).describe("Short label for what this case demonstrates."),
|
|
884
|
+
userPrompt: z.string().min(1).describe("A realistic, standalone user message a reviewer can paste and run with no prior state or multi-turn setup. Vary phrasing and tone across cases."),
|
|
572
885
|
toolTriggered: z.string().optional().describe("The tool this prompt should invoke."),
|
|
573
886
|
expectedOutput: z.string().optional().describe("What the user should see, including post-interaction behaviour where relevant.")
|
|
574
|
-
}).
|
|
887
|
+
}).describe("Each case: Scenario, User prompt, Tool triggered, Expected output.");
|
|
888
|
+
const positiveTestCaseDraftSchema = positiveTestCaseSchema.partial();
|
|
889
|
+
const blankPositiveTestCase = () => ({
|
|
890
|
+
scenario: "",
|
|
891
|
+
userPrompt: "",
|
|
892
|
+
toolTriggered: "",
|
|
893
|
+
expectedOutput: ""
|
|
894
|
+
});
|
|
895
|
+
const toFixedLength = (entries, length, blank) => Array.from({ length }, (_, index) => entries[index] ?? blank());
|
|
575
896
|
const screenshotEntrySchema = z.object({
|
|
576
897
|
prompt: z.string(),
|
|
577
|
-
url: z.url()
|
|
898
|
+
url: z.url()
|
|
578
899
|
}).describe("Each screenshot: the user prompt that produced it + the image URL.");
|
|
900
|
+
const screenshotDraftEntrySchema = screenshotEntrySchema.extend({ url: z.string() });
|
|
579
901
|
/** Accepts either a valid email or URL. */
|
|
580
902
|
const supportChannelSchema = z.string().refine((value) => z.email().safeParse(value).success || z.url().safeParse(value).success, { error: "Must be a valid email or URL" });
|
|
903
|
+
/** A URL field whose error spells out that the scheme is required. */
|
|
904
|
+
const urlField = z.url({ error: "Enter a full URL including https:// (e.g. https://example.com)" });
|
|
581
905
|
const chatgptCategorySchema = z.enum([
|
|
582
906
|
"BUSINESS",
|
|
583
907
|
"COLLABORATION",
|
|
@@ -881,20 +1205,22 @@ const chatgptTranslationLocaleSchema = z.enum([
|
|
|
881
1205
|
"zh-TW"
|
|
882
1206
|
]);
|
|
883
1207
|
const negativeTestCaseSchema = z.object({
|
|
884
|
-
scenario: z.string(),
|
|
885
|
-
userPrompt: z.string()
|
|
886
|
-
}).
|
|
1208
|
+
scenario: z.string().min(1),
|
|
1209
|
+
userPrompt: z.string().min(1)
|
|
1210
|
+
}).describe("Each case: Scenario + User prompt (the app should NOT trigger).");
|
|
1211
|
+
const negativeTestCaseDraftSchema = negativeTestCaseSchema.partial();
|
|
1212
|
+
const blankNegativeTestCase = () => ({
|
|
1213
|
+
scenario: "",
|
|
1214
|
+
userPrompt: ""
|
|
1215
|
+
});
|
|
1216
|
+
const chatgptSkillSchema = z.object({ name: z.string() }).describe("A skill discovered on the MCP server, by name.");
|
|
887
1217
|
const chatgptToolJustificationSchema = z.object({
|
|
888
1218
|
toolName: z.string(),
|
|
889
1219
|
readOnlyJustification: z.string().describe("One sentence on what the tool reads and returns."),
|
|
890
1220
|
openWorldJustification: z.string().describe("One sentence on whether the tool reaches external systems beyond your own service."),
|
|
891
1221
|
destructiveJustification: z.string().describe("One sentence on whether the tool changes data. For a read-only tool, state the full triad: \"No data is created, modified, or deleted.\"")
|
|
892
1222
|
}).describe("Per-tool justification of each MCP annotation value (one specific sentence per hint).");
|
|
893
|
-
/**
|
|
894
|
-
* Base copy fields, defined once and reused by both the submission form and per-locale
|
|
895
|
-
* translations so the constraints (tagline ≤ 30 chars) never drift. The translation generation
|
|
896
|
-
* path wraps these in {@link clampStringField} since the LLM tends to overshoot the limit.
|
|
897
|
-
*/
|
|
1223
|
+
/** Defined once and reused by both the submission form and per-locale translations so the tagline ≤ 30 chars constraint never drifts. */
|
|
898
1224
|
const chatgptTaglineSchema = z.string().max(30);
|
|
899
1225
|
const chatgptDescriptionSchema = z.string();
|
|
900
1226
|
const chatgptTranslationSchema = z.object({
|
|
@@ -903,10 +1229,7 @@ const chatgptTranslationSchema = z.object({
|
|
|
903
1229
|
description: chatgptDescriptionSchema
|
|
904
1230
|
}).describe("Locale-scoped override for tagline + description. English (US) is the default.");
|
|
905
1231
|
chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema) });
|
|
906
|
-
/**
|
|
907
|
-
* Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
|
|
908
|
-
* When adding/removing/reordering fields, keep this in sync with the sheet.
|
|
909
|
-
*/
|
|
1232
|
+
/** Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section; keep it in sync with the sheet. */
|
|
910
1233
|
const chatgptSubmissionFormDataSchema = z.object({
|
|
911
1234
|
logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
|
|
912
1235
|
logoDark: z.string().optional().describe("Optional dark-mode logo icon. Square PNG, same specs as the light icon. Leave empty if the light icon also works on dark backgrounds."),
|
|
@@ -915,40 +1238,64 @@ const chatgptSubmissionFormDataSchema = z.object({
|
|
|
915
1238
|
description: chatgptDescriptionSchema.describe("Clear, engaging description highlighting what the app does and why people will love it. Appears publicly on the directory page. End it by naming the product categories or intents the app does NOT cover, so ChatGPT learns when not to route to it (define exclusions by absent categories or wrong intents, never by naming other brands)."),
|
|
916
1239
|
category: chatgptCategorySchema.describe("Category from the OpenAI taxonomy."),
|
|
917
1240
|
developerName: z.string().describe("Developer name shown publicly on the app's directory page."),
|
|
918
|
-
companyUrl:
|
|
1241
|
+
companyUrl: urlField.describe("Your company's main website URL."),
|
|
919
1242
|
supportChannel: supportChannelSchema.describe("Customer support URL or email address."),
|
|
920
|
-
privacyPolicyUrl:
|
|
921
|
-
termsOfServiceUrl:
|
|
922
|
-
demoRecordingUrl:
|
|
1243
|
+
privacyPolicyUrl: urlField.describe("URL to your privacy policy."),
|
|
1244
|
+
termsOfServiceUrl: urlField.describe("URL to the app's terms of service."),
|
|
1245
|
+
demoRecordingUrl: urlField.describe("URL to a video demonstrating the app, recorded via OpenAI Developer Mode. Cover all main use cases on web, iOS, and Android."),
|
|
923
1246
|
appCommerceAndPurchasing: z.boolean().describe("Checkbox: 'My app links or directs users out of ChatGPT to make purchases.' Defaults to false. Verify the app does not offer digital goods."),
|
|
924
|
-
serverUrl:
|
|
1247
|
+
serverUrl: urlField.describe("URL of the MCP server."),
|
|
925
1248
|
authentication: chatgptAuthenticationSchema.describe("OAuth 2.0 or No auth. OAuth configuration is auto-discovered from the MCP server's metadata."),
|
|
926
1249
|
tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
|
|
927
1250
|
toolJustifications: z.array(chatgptToolJustificationSchema).describe("Per-tool justification of `readOnlyHint`, `openWorldHint`, and `destructiveHint` annotation values. One short, specific sentence per hint describing what the tool actually does."),
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
1251
|
+
skills: z.array(chatgptSkillSchema).optional().describe("Skills the server exposes over MCP (auto-populated from the production server's manifest). Left unset when the server does not advertise the skills extension, which is a different state from advertising it and exposing none."),
|
|
1252
|
+
testCases: z.array(positiveTestCaseSchema).length(5).describe("Exactly 5 positive test cases. Each: Scenario, User prompt, Tool triggered, Expected output. Collectively cover the full capability across different flow stages (initial search or browse, market or locale handling, post-interaction detail, an action ChatGPT performs on the user's behalf, and a conversion or secondary tool) rather than five variations of the same first step."),
|
|
1253
|
+
negativeTestCases: z.array(negativeTestCaseSchema).length(3).describe("Exactly 3 negative test cases: prompts where the app should NOT trigger but the model might think it is relevant. These become production routing metadata that teaches ChatGPT when to stay silent, so pick tight near-misses: a product category the app does not carry, the right brand or domain but an intent the app does not serve, or a boundary with a sibling app."),
|
|
1254
|
+
screenshots: z.array(screenshotEntrySchema.extend({ prompt: z.string().max(75, { error: "Screenshot prompts are limited to 75 characters." }) })).max(3).describe("In-app screenshots paired with the user prompt that produced them (each prompt is 75 characters max). Widget apps must show the widget UI; non-widget apps show the model response. Min 1, max 3 entries, all public. Images: 706px wide, 400–860px tall, PNG."),
|
|
931
1255
|
translations: z.array(chatgptTranslationSchema).describe("Per-locale translation of tagline + description. English (US) is the default."),
|
|
932
1256
|
allowedCountries: chatgptAllowedCountriesSchema.describe("Availability: all supported countries, or an allow-list / block-list of specific ones (ISO alpha-2)."),
|
|
933
1257
|
releaseNotes: z.string().describe("Publicly displayed on the app details page.")
|
|
934
1258
|
});
|
|
935
|
-
chatgptSubmissionFormDataSchema.
|
|
1259
|
+
const chatgptSubmissionDraftSchema = chatgptSubmissionFormDataSchema.partial().extend({
|
|
1260
|
+
tagline: z.string().optional(),
|
|
1261
|
+
companyUrl: z.string().optional(),
|
|
1262
|
+
supportChannel: z.string().optional(),
|
|
1263
|
+
privacyPolicyUrl: z.string().optional(),
|
|
1264
|
+
termsOfServiceUrl: z.string().optional(),
|
|
1265
|
+
demoRecordingUrl: z.string().optional(),
|
|
1266
|
+
serverUrl: z.string().optional(),
|
|
1267
|
+
screenshots: z.array(screenshotDraftEntrySchema).optional(),
|
|
1268
|
+
testCases: z.array(positiveTestCaseDraftSchema).optional(),
|
|
1269
|
+
negativeTestCases: z.array(negativeTestCaseDraftSchema).optional(),
|
|
1270
|
+
translations: z.array(chatgptTranslationSchema.extend({ tagline: z.string() })).optional()
|
|
1271
|
+
});
|
|
1272
|
+
/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "chatgpt" })` can populate. */
|
|
1273
|
+
const chatgptPrefillFormDataSchema = chatgptSubmissionFormDataSchema.pick({
|
|
936
1274
|
appName: true,
|
|
937
1275
|
developerName: true,
|
|
938
1276
|
serverUrl: true,
|
|
939
1277
|
tools: true,
|
|
1278
|
+
skills: true,
|
|
940
1279
|
authentication: true
|
|
941
1280
|
});
|
|
942
|
-
|
|
1281
|
+
/** Source of truth for `SubmissionPrefillService.generate({ platform: "chatgpt" })`. */
|
|
1282
|
+
const chatgptAiGeneratedFormDataSchema = chatgptSubmissionFormDataSchema.pick({
|
|
943
1283
|
tagline: true,
|
|
944
1284
|
description: true,
|
|
945
1285
|
category: true,
|
|
946
1286
|
testCases: true,
|
|
947
1287
|
negativeTestCases: true,
|
|
948
1288
|
toolJustifications: true
|
|
949
|
-
}).extend({
|
|
1289
|
+
}).extend({
|
|
1290
|
+
testCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.testCases),
|
|
1291
|
+
negativeTestCases: unboundedArrayField(chatgptSubmissionFormDataSchema.shape.negativeTestCases)
|
|
1292
|
+
}).extend({
|
|
1293
|
+
tagline: clampStringField(chatgptSubmissionFormDataSchema.shape.tagline),
|
|
1294
|
+
testCases: z.array(positiveTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 5, blankPositiveTestCase)),
|
|
1295
|
+
negativeTestCases: z.array(negativeTestCaseDraftSchema).transform((cases) => toFixedLength(cases, 3, blankNegativeTestCase))
|
|
1296
|
+
});
|
|
950
1297
|
const claudeCategorySchema = z.enum([
|
|
951
|
-
"
|
|
1298
|
+
"Productivity",
|
|
952
1299
|
"Communication",
|
|
953
1300
|
"Data & Analytics",
|
|
954
1301
|
"Development tools",
|
|
@@ -956,222 +1303,220 @@ const claudeCategorySchema = z.enum([
|
|
|
956
1303
|
"Consumer Health",
|
|
957
1304
|
"Health & Life Sciences",
|
|
958
1305
|
"Media & Entertainment",
|
|
959
|
-
"Commerce & Shopping"
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
"
|
|
963
|
-
"
|
|
964
|
-
"
|
|
1306
|
+
"Commerce & Shopping",
|
|
1307
|
+
"Legal",
|
|
1308
|
+
"Sales and marketing",
|
|
1309
|
+
"Creative",
|
|
1310
|
+
"Nonprofit",
|
|
1311
|
+
"Education",
|
|
1312
|
+
"Other"
|
|
965
1313
|
]);
|
|
966
|
-
const
|
|
967
|
-
z.enum(["Static OAuth Client", "Dynamic OAuth Client (DCR / CIMD)"]);
|
|
1314
|
+
const claudeCategoryDescription = `The categories used to filter connectors in the directory UI. Select up to 5 that best describe your connector.`;
|
|
968
1315
|
const claudeReadWriteCapabilitiesSchema = z.enum([
|
|
969
|
-
"
|
|
970
|
-
"
|
|
971
|
-
"
|
|
1316
|
+
"read_only",
|
|
1317
|
+
"write_only",
|
|
1318
|
+
"read_write"
|
|
972
1319
|
]);
|
|
973
|
-
const
|
|
974
|
-
|
|
975
|
-
"
|
|
976
|
-
"
|
|
977
|
-
"
|
|
978
|
-
"
|
|
979
|
-
]);
|
|
980
|
-
const claudeThirdPartySchema = z.enum([
|
|
981
|
-
"Web access: Fetches information from the open web (e.g., web scraping, search engines, or browsing arbitrary URLs, not just connecting to a specific API)",
|
|
982
|
-
"Third-party AI model integration: Sends data to or receives data from a generative AI model other than Claude",
|
|
983
|
-
"Third-party data retrieval: Connects to external services that themselves retrieve data from other sources (e.g., workflow automation platforms or other services that aggregate or relay data from multiple third-party sources)",
|
|
984
|
-
"Third-party data modification: Can connect to external services that themselves create, update, or delete data in other sources (e.g., workflow automation platforms or other services that write to multiple third-party sources)",
|
|
985
|
-
"N/A"
|
|
1320
|
+
const claudeAuthenticationSchema = z.enum([
|
|
1321
|
+
"oauth_dcr",
|
|
1322
|
+
"oauth_cimd",
|
|
1323
|
+
"oauth_anthropic_creds",
|
|
1324
|
+
"custom_connection",
|
|
1325
|
+
"none"
|
|
986
1326
|
]);
|
|
987
|
-
const
|
|
988
|
-
"
|
|
989
|
-
"
|
|
990
|
-
"
|
|
991
|
-
"GDPR compliant (if applicable)"
|
|
1327
|
+
const claudeApiOwnershipSchema = z.enum([
|
|
1328
|
+
"first_party",
|
|
1329
|
+
"proxied",
|
|
1330
|
+
"third_party"
|
|
992
1331
|
]);
|
|
993
|
-
const
|
|
994
|
-
|
|
995
|
-
"
|
|
996
|
-
"
|
|
1332
|
+
const claudeYesNoOtherSchema = z.union([z.boolean(), z.object({ other: z.string() })]);
|
|
1333
|
+
const claudePolicyAcknowledgementSchema = z.enum([
|
|
1334
|
+
"I have read and understand the MCP Directory developer guidelines.",
|
|
1335
|
+
"My server calls our own first-party APIs (or APIs we legitimately proxy with permission).",
|
|
1336
|
+
"My connector does not transfer money, cryptocurrency, or other financial assets on a user's behalf.",
|
|
1337
|
+
"My connector does not use AI models to generate images, video, or audio.",
|
|
1338
|
+
"Tool descriptions contain no instructions about model behavior, other tools, or external instruction sources, and no hidden or encoded text.",
|
|
1339
|
+
"My connector does not collect conversation data beyond what is needed for its function.",
|
|
1340
|
+
"Public documentation for this connector will be live by the publish date."
|
|
997
1341
|
]);
|
|
998
|
-
/**
|
|
999
|
-
* Field order mirrors the Claude (Anthropic) submission spreadsheet, grouped by section.
|
|
1000
|
-
* When adding/removing/reordering fields, keep this in sync with the sheet.
|
|
1001
|
-
*/
|
|
1342
|
+
/** Field order mirrors the claude.ai directory submission wizard (`claude.ai/admin-settings/directory/submissions/new`), grouped by step; keep it in sync with the wizard. */
|
|
1002
1343
|
const claudeSubmissionFormDataSchema = z.object({
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
(
|
|
1013
|
-
|
|
1014
|
-
(
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1031
|
-
•
|
|
1032
|
-
•
|
|
1033
|
-
•
|
|
1034
|
-
|
|
1035
|
-
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
1041
|
-
|
|
1042
|
-
|
|
1043
|
-
|
|
1044
|
-
|
|
1045
|
-
|
|
1046
|
-
|
|
1047
|
-
|
|
1048
|
-
• '
|
|
1049
|
-
• '
|
|
1050
|
-
• '
|
|
1051
|
-
|
|
1052
|
-
|
|
1053
|
-
|
|
1054
|
-
|
|
1055
|
-
|
|
1056
|
-
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
|
|
1060
|
-
|
|
1061
|
-
|
|
1062
|
-
|
|
1063
|
-
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
|
|
1071
|
-
|
|
1072
|
-
|
|
1073
|
-
|
|
1074
|
-
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
|
|
1079
|
-
|
|
1080
|
-
• 'SSE (Server-Sent Events)' — the older transport. SSE may be deprecated by Anthropic later in 2025/2026. If you currently only support SSE, you should plan to migrate to Streamable HTTP.
|
|
1081
|
-
If you support both, select both. If you're building from scratch, implement Streamable HTTP only.`),
|
|
1082
|
-
serverDocumentationLink: z.url().describe(`A public URL pointing to documentation that helps users understand and use your connector. This is displayed in the Directory listing and must be publicly accessible without login. Minimum requirements for the docs page:
|
|
1083
|
-
• What the connector does and its key capabilities
|
|
1084
|
-
• How to connect/set it up (step by step)
|
|
1085
|
-
• What each tool does (or at least the main ones)
|
|
1086
|
-
• How to troubleshoot common issues
|
|
1087
|
-
• A support contact or channel
|
|
1088
|
-
Acceptable formats: a dedicated docs page, a help center article, a README on GitHub, or a blog post — as long as it's comprehensive. Note: Anthropic requires public documentation to be live by your publish date.`),
|
|
1089
|
-
privacyPolicyUrl: z.url().describe(`URL to your privacy policy. This is mandatory and displayed in the directory listing. Missing or incomplete privacy policies result in immediate rejection. Your privacy policy must cover:
|
|
1090
|
-
• What data you collect (and how)
|
|
1091
|
-
• How you use the collected data
|
|
1092
|
-
• Where and how long you store it
|
|
1093
|
-
• Whether you share data with third parties (and who)
|
|
1094
|
-
• How users can contact you about data concerns
|
|
1095
|
-
The policy must be publicly accessible. If you don't have one yet, create one before submitting — there are free generators online, but make sure it accurately reflects your actual practices. If you're GDPR-compliant, your policy should reflect that.`),
|
|
1096
|
-
supportChannel: supportChannelSchema.describe(`A URL or email address where users can get help with your connector. This is displayed in the Directory listing. Acceptable options:
|
|
1097
|
-
• Email address (e.g. support@myapp.com)
|
|
1098
|
-
• Link to a GitHub Issues page
|
|
1099
|
-
• Link to a help center or support article
|
|
1100
|
-
• Link to a Discord/Slack community
|
|
1101
|
-
• Link to your documentation's troubleshooting section
|
|
1102
|
-
Also uses this to notify you of security or compliance issues, so make sure it's actively monitored.`),
|
|
1103
|
-
testingCredentials: z.string().describe(`Provide login credentials for a test account that Anthropic reviewers can use to verify your server works end-to-end. Critical requirements:
|
|
1104
|
-
• The account must have sample/demo data loaded — reviewers need to actually test your tools with real data.
|
|
1105
|
-
• No 2FA — reviewers can't receive SMS codes. Disable 2FA on this account.
|
|
1106
|
-
• If your service uses Google OAuth or another OAuth that requires email verification, use mcp-review@anthropic.com as the account email — Anthropic has access to this inbox.
|
|
1107
|
-
• Credentials must remain valid for at least 30 days from submission.
|
|
1108
|
-
• If your service requires API keys instead of a password, provide those.
|
|
1109
|
-
Format suggestion: Username/email: xxx | Password: xxx | Any other notes`),
|
|
1110
|
-
tools: z.array(toolDefinitionSchema).describe(`A comma-separated list of all tools your MCP server exposes. Use the format: tool_name (Human-Readable Name). The tool_name is the internal identifier (snake_case, max 64 characters). The Human-Readable Name is what users see.
|
|
1111
|
-
Example: list_issues (List Issues), create_issue (Create Issue), update_issue (Update Issue), delete_issue (Delete Issue), search_issues (Search Issues)
|
|
1112
|
-
Reviewers test every single tool you list here — don't list tools that don't work. Also: do not have a single catch-all tool like api_request(method, endpoint) — Anthropic rejects these. Each action should be its own purpose-built tool.`),
|
|
1113
|
-
toolTitlesAnnotationsConfirmed: z.boolean().describe(`This is a compliance confirmation — check both boxes only if you have actually implemented these in your server code:
|
|
1114
|
-
• 'I've specified user-friendly titles for all tools' — every tool has a 'title' annotation (a human-readable label, different from the tool name).
|
|
1115
|
-
• 'I've specified accurate tool annotations for all tools' — every tool has the correct annotation: readOnlyHint: true for read operations (search, get, list, fetch), OR destructiveHint: true for write operations (create, update, delete, send).
|
|
1116
|
-
This is the #1 reason submissions get rejected (30% of all rejections). Do not check these boxes without actually having implemented the annotations. See MCP spec for how to add them.`),
|
|
1117
|
-
testedSurfaces: z.array(claudeTestedSurfaceSchema).describe(`Confirm testing is complete and your server works as intended in these surfaces. Select every surface you've verified. Claude.ai (web) and Claude Desktop are the usual targets for remote MCP servers; Claude Code and Cowork compatibility is not required. Anthropic requires at least two surfaces.`),
|
|
1118
|
-
logoLight: z.string().describe(`Your connector's logo for light backgrounds. Requirements:
|
|
1119
|
-
• Format: SVG only
|
|
1120
|
-
• Aspect ratio: square (1:1)
|
|
1121
|
-
• Should work on a light background
|
|
1122
|
-
• Provide via URL (Google Drive link is fine) or upload directly
|
|
1123
|
-
Tip: use a simple, recognizable icon — not a full wordmark. The logo appears at small sizes in the directory grid.`),
|
|
1124
|
-
logoDark: z.string().optional().describe(`Optional dark-mode variant of the connector logo. Same specs as the light variant (SVG, square 1:1) but designed to read on a dark background. Leave empty if the light logo already works on dark.`),
|
|
1125
|
-
screenshots: z.array(screenshotEntrySchema).describe(`Screenshots or promotional images of your connector in action within Claude. Strongly recommended for all connectors, and required for MCP Apps (interactive UI). Guidelines:
|
|
1126
|
-
• 3–5 images is ideal
|
|
1127
|
-
• Minimum 1000px width, PNG format preferred
|
|
1128
|
-
• Each screenshot is paired with the user prompt that produced it
|
|
1129
|
-
• Crop to just the relevant part of the Claude interface (the tool response area)
|
|
1130
|
-
• Show your connector doing something impressive and useful — real data, real results
|
|
1131
|
-
• If you're an MCP App, include screenshots of your interactive UI elements
|
|
1132
|
-
These images appear in your directory listing and are a key factor in driving user installs.`)
|
|
1133
|
-
});
|
|
1134
|
-
claudeSubmissionFormDataSchema.pick({
|
|
1135
|
-
companyName: true,
|
|
1136
|
-
appName: true,
|
|
1137
|
-
mcpUrlType: true,
|
|
1344
|
+
serverUrl: z.url().describe(`The full https:// URL where your MCP server is hosted and reachable. In the claude.ai wizard this is read live
|
|
1345
|
+
from the custom connector you select — the connection is used to verify the URL and the tool list at submission time.
|
|
1346
|
+
The server must be publicly accessible without VPN or whitelisting.`),
|
|
1347
|
+
name: z.string().max(100).describe(`The public display name for your connector as it appears in the directory. Use your brand/product name. You must
|
|
1348
|
+
own or have the right to use this name. Max 100 characters.`),
|
|
1349
|
+
slug: z.string().max(50).regex(/^[a-z0-9-]+$/).describe(`URL-safe identifier for your connector's directory page. Lowercase letters, numbers, and hyphens only.
|
|
1350
|
+
PERMANENT after submission — it cannot be changed. Pre-filled from the name. Max 50 characters.`),
|
|
1351
|
+
oneLiner: z.string().max(200).describe(`A short tagline shown below your connector name in the directory listing. Max 200 characters. Avoid generic
|
|
1352
|
+
phrases like 'The best MCP server for...'. Example: 'Manage tasks and projects in Linear'.`),
|
|
1353
|
+
description: z.string().max(2e3).describe(`A description of what your connector does and its key features, shown on the connector's detail page in
|
|
1354
|
+
claude.ai. Write it from a user perspective and be specific. Max 2000 characters.`),
|
|
1355
|
+
categories: z.array(claudeCategorySchema).max(5).describe(claudeCategoryDescription),
|
|
1356
|
+
iconUrl: z.url().optional().describe(`Optional custom icon for the directory listing — a square SVG. By default the favicon from your MCP URL is used
|
|
1357
|
+
(recommended); upload a custom icon only to override it.`),
|
|
1358
|
+
documentation: z.url().describe(`A public URL pointing to documentation that helps users understand and use your connector. Must be publicly
|
|
1359
|
+
accessible without login. IT admins often review these when deciding whether to approve a server. Required to be live
|
|
1360
|
+
by your publish date.`),
|
|
1361
|
+
support: supportChannelSchema.describe(`A support URL or email address where users can get help with your connector. Displayed in the directory listing and
|
|
1362
|
+
used to notify you of security or compliance issues, so make sure it's actively monitored.`),
|
|
1363
|
+
privacyPolicy: z.url().describe(`URL to your privacy policy. Mandatory and displayed in the directory listing. Must be publicly accessible and cover
|
|
1364
|
+
what data you collect, how you use and store it, and whether you share it with third parties.`),
|
|
1365
|
+
screenshots: z.array(screenshotEntrySchema).optional().describe(`Carousel images shown on your connector's directory page (PNG). Each is paired with the user prompt that produced
|
|
1366
|
+
it. This is editable on the directory page only after the connector is submitted — optional here so you can prepare it.`),
|
|
1367
|
+
primaryUseCases: z.string().describe(`Describe the main tasks users will accomplish with this connector, and include a few example prompts a user might
|
|
1368
|
+
type. These may be shown publicly but are primarily used for internal review — reviewers test your server using them.`),
|
|
1369
|
+
connectionRequirements: z.string().describe(`What accounts, permissions, or setup a user needs before connecting (e.g. 'Requires a paid Acme account with admin
|
|
1370
|
+
permissions'). If there are genuinely no special requirements, say so explicitly.`),
|
|
1371
|
+
readWriteCapabilities: claudeReadWriteCapabilitiesSchema.describe(`What your server can do:
|
|
1372
|
+
• 'read_only': retrieves data but never modifies it.
|
|
1373
|
+
• 'write_only': creates or modifies data but does not read it.
|
|
1374
|
+
• 'read_write': both retrieves and modifies data (most common).`),
|
|
1375
|
+
companyName: z.string().describe("The company or organization behind this connector — its legal name or publicly known product name."),
|
|
1376
|
+
companyWebsite: z.url().describe("The company's main website URL, e.g. https://example.com."),
|
|
1377
|
+
primaryContactName: z.string().describe("Full name of the person Anthropic should contact about this submission. Receives review feedback and follow-up questions."),
|
|
1378
|
+
primaryContactEmail: z.email().describe("Email for the primary contact (pre-filled from the Claude account). Anthropic uses this to communicate about your submission."),
|
|
1379
|
+
primaryContactRole: z.string().optional().describe("The primary contact's role at the company (e.g. 'Engineer', 'Product Manager'). Optional."),
|
|
1380
|
+
anthropicPointOfContact: z.string().optional().describe("If you've been working with someone at Anthropic, their name or email. Optional, can expedite review."),
|
|
1381
|
+
authentication: claudeAuthenticationSchema.describe(`How users authenticate with your server:
|
|
1382
|
+
• 'oauth_dcr': OAuth 2.0 + Dynamic Client Registration (RFC 7591) — clients register themselves.
|
|
1383
|
+
• 'oauth_cimd': OAuth 2.0 + Client ID Metadata Document — a published client_id metadata document.
|
|
1384
|
+
• 'oauth_anthropic_creds': OAuth 2.0 with Anthropic-held client credentials (a static client_id, and secret if needed).
|
|
1385
|
+
• 'custom_connection': users supply their own URL or client details at connection time (e.g. Snowflake).
|
|
1386
|
+
• 'none': no authentication (authless) — anyone can connect and call tools without credentials.`),
|
|
1387
|
+
partialAuth: z.boolean().optional().describe("Whether some tools return 401 and prompt for auth on demand while the server otherwise starts authless (partial auth)."),
|
|
1388
|
+
apiOwnership: claudeApiOwnershipSchema.describe(`How your connector relates to the API it calls:
|
|
1389
|
+
• 'first_party': the MCP server calls your own production APIs.
|
|
1390
|
+
• 'proxied': calls go to a third-party API you're authorized to integrate (e.g. a Zapier-style integration).
|
|
1391
|
+
• 'third_party': calls a third-party API you don't control — typically blocks listing; explain in 'additionalNotes'.`),
|
|
1392
|
+
personalHealthData: claudeYesNoOtherSchema.describe(`Whether this connector accesses, processes, or stores personal health information.
|
|
1393
|
+
No → false, Yes → true, or { other: explanation } when it depends on configuration.`),
|
|
1394
|
+
sponsoredContent: claudeYesNoOtherSchema.describe(`Whether this connector surfaces sponsored, promoted, or advertising content (prohibited in directory connectors).
|
|
1395
|
+
No → false, Yes → true, or { other: explanation }.`),
|
|
1396
|
+
testInstructions: z.string().optional().describe(`Clear test-account setup and access instructions for reviewers: every link, credential, and step needed to access
|
|
1397
|
+
the MCP server autonomously. For accounts that need to be populated, provide test credentials granting access to a
|
|
1398
|
+
fully populated account.`),
|
|
1399
|
+
selfTested: z.boolean().optional().describe("Confirmation that you have run every tool via MCP Inspector or as a custom connector in Claude."),
|
|
1400
|
+
policyAcknowledgements: z.array(claudePolicyAcknowledgementSchema).describe(`Anthropic directory policy acknowledgements. All items must be acknowledged before the claude.ai wizard allows
|
|
1401
|
+
submission. Each is an attestation you are legally agreeing to by submitting.`),
|
|
1402
|
+
additionalNotes: z.string().optional().describe("Anything else the review team should know about your connector. Optional.")
|
|
1403
|
+
});
|
|
1404
|
+
const claudeSubmissionDraftSchema = claudeSubmissionFormDataSchema.partial().extend({
|
|
1405
|
+
serverUrl: z.string().optional(),
|
|
1406
|
+
name: z.string().optional(),
|
|
1407
|
+
slug: z.string().optional(),
|
|
1408
|
+
oneLiner: z.string().optional(),
|
|
1409
|
+
description: z.string().optional(),
|
|
1410
|
+
iconUrl: z.string().optional(),
|
|
1411
|
+
documentation: z.string().optional(),
|
|
1412
|
+
support: z.string().optional(),
|
|
1413
|
+
privacyPolicy: z.string().optional(),
|
|
1414
|
+
companyWebsite: z.string().optional(),
|
|
1415
|
+
primaryContactEmail: z.string().optional(),
|
|
1416
|
+
categories: z.array(claudeCategorySchema).optional(),
|
|
1417
|
+
screenshots: z.array(screenshotDraftEntrySchema).optional()
|
|
1418
|
+
});
|
|
1419
|
+
/** Source of truth for the fields `SubmissionPrefillService.prefill({ platform: "claudeai" })` can populate. */
|
|
1420
|
+
const claudePrefillFormDataSchema = claudeSubmissionFormDataSchema.pick({
|
|
1138
1421
|
serverUrl: true,
|
|
1139
|
-
|
|
1140
|
-
|
|
1141
|
-
|
|
1142
|
-
transportSupport: true,
|
|
1422
|
+
name: true,
|
|
1423
|
+
slug: true,
|
|
1424
|
+
companyName: true,
|
|
1143
1425
|
primaryContactEmail: true,
|
|
1144
1426
|
primaryContactName: true,
|
|
1427
|
+
readWriteCapabilities: true,
|
|
1145
1428
|
authentication: true,
|
|
1146
|
-
|
|
1147
|
-
|
|
1429
|
+
apiOwnership: true,
|
|
1430
|
+
personalHealthData: true
|
|
1148
1431
|
}).extend({
|
|
1149
1432
|
connectionRequirements: claudeSubmissionFormDataSchema.shape.connectionRequirements.optional(),
|
|
1150
|
-
|
|
1433
|
+
testInstructions: claudeSubmissionFormDataSchema.shape.testInstructions.optional()
|
|
1434
|
+
});
|
|
1435
|
+
/** Loose shape returned by AI generation for Claude narrative fields; transforms live here so generation leniency stays colocated with the Claude contract. */
|
|
1436
|
+
const claudeAiGeneratedFormDataRawSchema = z.object({
|
|
1437
|
+
oneLiner: claudeSubmissionFormDataSchema.shape.oneLiner,
|
|
1438
|
+
description: claudeSubmissionFormDataSchema.shape.description,
|
|
1439
|
+
categories: z.array(claudeCategorySchema).describe(claudeCategoryDescription),
|
|
1440
|
+
primaryUseCases: claudeSubmissionFormDataSchema.shape.primaryUseCases
|
|
1441
|
+
});
|
|
1442
|
+
const claudeAiGeneratedFormDataSchema = claudeAiGeneratedFormDataRawSchema.extend({
|
|
1443
|
+
oneLiner: clampStringField(claudeSubmissionFormDataSchema.shape.oneLiner),
|
|
1444
|
+
categories: claudeAiGeneratedFormDataRawSchema.shape.categories.transform((categories) => categories.slice(0, 5))
|
|
1445
|
+
});
|
|
1446
|
+
function provenanceByField(prefillShape, aiGeneratedShape) {
|
|
1447
|
+
const byField = {};
|
|
1448
|
+
for (const field of Object.keys(prefillShape)) byField[field] = "prefilled";
|
|
1449
|
+
for (const field of Object.keys(aiGeneratedShape)) byField[field] = "ai-generated";
|
|
1450
|
+
return byField;
|
|
1451
|
+
}
|
|
1452
|
+
provenanceByField(claudePrefillFormDataSchema.shape, claudeAiGeneratedFormDataSchema.shape), provenanceByField(chatgptPrefillFormDataSchema.shape, chatgptAiGeneratedFormDataSchema.shape);
|
|
1453
|
+
const urlVerificationOutcomeSchema = z.enum([
|
|
1454
|
+
"pass",
|
|
1455
|
+
"fail",
|
|
1456
|
+
"unverified"
|
|
1457
|
+
]);
|
|
1458
|
+
const VERIFIABLE_URL_FIELDS = {
|
|
1459
|
+
chatgpt: ["privacyPolicyUrl", "termsOfServiceUrl"],
|
|
1460
|
+
claudeai: ["privacyPolicy"]
|
|
1461
|
+
};
|
|
1462
|
+
const verifiableUrlFieldSchema = z.enum([...VERIFIABLE_URL_FIELDS.chatgpt, ...VERIFIABLE_URL_FIELDS.claudeai]);
|
|
1463
|
+
const policyDisclosureSchema = z.enum([
|
|
1464
|
+
"dataCategories",
|
|
1465
|
+
"purposesOfUse",
|
|
1466
|
+
"recipients",
|
|
1467
|
+
"retention"
|
|
1468
|
+
]);
|
|
1469
|
+
const urlVerificationFieldResultSchema = z.object({
|
|
1470
|
+
field: verifiableUrlFieldSchema,
|
|
1471
|
+
url: z.string(),
|
|
1472
|
+
outcome: urlVerificationOutcomeSchema,
|
|
1473
|
+
reason: z.string(),
|
|
1474
|
+
concerns: z.array(z.string()).optional(),
|
|
1475
|
+
scrapedWith: z.enum(["fetch", "firecrawl"]).optional()
|
|
1476
|
+
});
|
|
1477
|
+
const urlVerificationSchema = z.object({
|
|
1478
|
+
verifiedAt: z.coerce.date(),
|
|
1479
|
+
results: z.array(urlVerificationFieldResultSchema)
|
|
1480
|
+
});
|
|
1481
|
+
const pageKindSchema = z.enum([
|
|
1482
|
+
"expectedDocument",
|
|
1483
|
+
"errorPage",
|
|
1484
|
+
"loginWall",
|
|
1485
|
+
"parkedDomain",
|
|
1486
|
+
"comingSoon",
|
|
1487
|
+
"marketingPage",
|
|
1488
|
+
"unrelatedDocument"
|
|
1489
|
+
]);
|
|
1490
|
+
z.object({
|
|
1491
|
+
pageKind: pageKindSchema.describe("What the page actually is. Use 'expectedDocument' only when it is genuinely the document the field claims."),
|
|
1492
|
+
reason: z.string().max(200).describe("One sentence naming what the page is, addressed to the developer who entered the URL."),
|
|
1493
|
+
missingDisclosures: z.array(policyDisclosureSchema).describe("For a privacy policy only: which of the four required disclosures the text does not cover. Empty for every other page kind.")
|
|
1151
1494
|
});
|
|
1152
|
-
claudeSubmissionFormDataSchema.pick({
|
|
1153
|
-
tagline: true,
|
|
1154
|
-
description: true,
|
|
1155
|
-
category: true,
|
|
1156
|
-
testCases: true
|
|
1157
|
-
}).extend({ tagline: clampStringField(claudeSubmissionFormDataSchema.shape.tagline) });
|
|
1158
1495
|
const submissionMetaFieldsSchema = z.object({
|
|
1159
1496
|
id: z.string(),
|
|
1160
1497
|
environmentId: z.string(),
|
|
1161
1498
|
auditId: z.string().nullable(),
|
|
1499
|
+
urlVerification: urlVerificationSchema.nullable().default(null),
|
|
1162
1500
|
createdAt: z.coerce.date(),
|
|
1163
1501
|
updatedAt: z.coerce.date()
|
|
1164
1502
|
});
|
|
1165
1503
|
const claudeSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
|
|
1166
1504
|
platform: z.literal("claudeai"),
|
|
1167
|
-
formData:
|
|
1505
|
+
formData: claudeSubmissionDraftSchema,
|
|
1506
|
+
prefillSnapshot: claudeSubmissionDraftSchema.nullable().default(null)
|
|
1168
1507
|
});
|
|
1169
1508
|
const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
|
|
1170
1509
|
platform: z.literal("chatgpt"),
|
|
1171
|
-
formData:
|
|
1510
|
+
formData: chatgptSubmissionDraftSchema,
|
|
1511
|
+
prefillSnapshot: chatgptSubmissionDraftSchema.nullable().default(null)
|
|
1172
1512
|
});
|
|
1173
1513
|
z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
|
|
1174
|
-
z.union([
|
|
1514
|
+
z.union([claudeSubmissionDraftSchema, chatgptSubmissionDraftSchema]);
|
|
1515
|
+
z.literal([
|
|
1516
|
+
100,
|
|
1517
|
+
75,
|
|
1518
|
+
50
|
|
1519
|
+
]);
|
|
1175
1520
|
const subscriptionPlanSchema = z.enum([
|
|
1176
1521
|
"pro",
|
|
1177
1522
|
"business",
|
|
@@ -1183,17 +1528,76 @@ const customerCreditsSchema = z.object({
|
|
|
1183
1528
|
expiresAt: z.number().nullable(),
|
|
1184
1529
|
currency: z.string()
|
|
1185
1530
|
});
|
|
1186
|
-
const customerUsageSchema = z.object({
|
|
1187
|
-
amountInCents: z.number(),
|
|
1188
|
-
currency: z.string(),
|
|
1189
|
-
periodEnd: z.number()
|
|
1190
|
-
});
|
|
1191
1531
|
const partnerDiscountSchema = z.object({ endsAt: z.number() });
|
|
1192
1532
|
z.object({
|
|
1193
1533
|
customerCredits: customerCreditsSchema.nullable(),
|
|
1194
|
-
customerUsage: customerUsageSchema.nullable(),
|
|
1195
1534
|
partnerDiscount: partnerDiscountSchema.nullable()
|
|
1196
1535
|
});
|
|
1536
|
+
const metricsQueueEventSchema = z.object({
|
|
1537
|
+
ts: z.number().int(),
|
|
1538
|
+
method: z.string(),
|
|
1539
|
+
tool: z.string().nullable(),
|
|
1540
|
+
client: z.string(),
|
|
1541
|
+
sessionId: z.string().nullable(),
|
|
1542
|
+
durationMs: z.number().int(),
|
|
1543
|
+
outputTokens: z.number().int().nullable(),
|
|
1544
|
+
errorType: z.enum([
|
|
1545
|
+
"mcp_error",
|
|
1546
|
+
"tool_error",
|
|
1547
|
+
"timeout"
|
|
1548
|
+
]).nullable(),
|
|
1549
|
+
errorCode: z.number().int().nullable()
|
|
1550
|
+
});
|
|
1551
|
+
z.object({
|
|
1552
|
+
v: z.literal(1),
|
|
1553
|
+
envId: z.string(),
|
|
1554
|
+
events: z.array(metricsQueueEventSchema)
|
|
1555
|
+
});
|
|
1556
|
+
z.object({ v: z.number() });
|
|
1557
|
+
const telemetrySignalSchema = z.enum([
|
|
1558
|
+
"logs",
|
|
1559
|
+
"metrics",
|
|
1560
|
+
"traces"
|
|
1561
|
+
]);
|
|
1562
|
+
const otlpProtocolSchema = z.enum(["http/protobuf", "http/json"]);
|
|
1563
|
+
const otlpEndpointSchema = z.string().trim().min(1).max(2048);
|
|
1564
|
+
const OTLP_HEADER_VALUE_MAX_LENGTH = 2048;
|
|
1565
|
+
const otlpHeaderNameSchema = z.string().trim().min(1, "Enter a header name").max(128).regex(/^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$/, "Use letters, digits and !#$%&'*+-.^_`|~ only");
|
|
1566
|
+
const otlpHeaderValueSchema = z.string().trim().max(OTLP_HEADER_VALUE_MAX_LENGTH).refine((value) => !/[\r\n]/.test(value), "Line breaks are not allowed in a header value");
|
|
1567
|
+
const telemetryDestinationHeaderSchema = z.object({
|
|
1568
|
+
id: z.string(),
|
|
1569
|
+
name: otlpHeaderNameSchema,
|
|
1570
|
+
value: otlpHeaderValueSchema,
|
|
1571
|
+
isSecret: z.boolean()
|
|
1572
|
+
});
|
|
1573
|
+
const otlpPushFailureReasonSchema = z.enum([
|
|
1574
|
+
"credentials",
|
|
1575
|
+
"wrong-path",
|
|
1576
|
+
"wrong-protocol",
|
|
1577
|
+
"invalid-payload",
|
|
1578
|
+
"partial-rejection",
|
|
1579
|
+
"blocked-target",
|
|
1580
|
+
"timeout",
|
|
1581
|
+
"unreachable",
|
|
1582
|
+
"receiver-error",
|
|
1583
|
+
"unexpected-status"
|
|
1584
|
+
]);
|
|
1585
|
+
const telemetryDestinationStatusSchema = z.enum(["active", "suspended"]);
|
|
1586
|
+
z.object({
|
|
1587
|
+
id: z.string(),
|
|
1588
|
+
signal: telemetrySignalSchema,
|
|
1589
|
+
endpoint: otlpEndpointSchema,
|
|
1590
|
+
protocol: otlpProtocolSchema,
|
|
1591
|
+
headers: z.array(telemetryDestinationHeaderSchema),
|
|
1592
|
+
status: telemetryDestinationStatusSchema,
|
|
1593
|
+
lastFailureReason: otlpPushFailureReasonSchema.nullable()
|
|
1594
|
+
});
|
|
1595
|
+
//#endregion
|
|
1596
|
+
//#region src/auth-scope.ts
|
|
1597
|
+
/** Accepts an API key or OAuth access token (default for most routes). */
|
|
1598
|
+
const AUTH_SCOPE_ANY = "any";
|
|
1599
|
+
/** Requires a user OAuth access token; API keys are not accepted. */
|
|
1600
|
+
const AUTH_SCOPE_USER = "user";
|
|
1197
1601
|
//#endregion
|
|
1198
1602
|
//#region src/schemas.ts
|
|
1199
1603
|
const RESERVED_KEYS = [
|
|
@@ -1230,7 +1634,10 @@ const RESERVED_KEYS = [
|
|
|
1230
1634
|
"BUILD_ARG_START_COMMAND",
|
|
1231
1635
|
"ALPIC_HOST",
|
|
1232
1636
|
"ALPIC_CUSTOM_DOMAINS",
|
|
1233
|
-
"ALPIC_INTENT_META_KEY"
|
|
1637
|
+
"ALPIC_INTENT_META_KEY",
|
|
1638
|
+
"ALPIC_FEEDBACK_META_KEY",
|
|
1639
|
+
"ALPIC_EVENTS_META_KEY",
|
|
1640
|
+
"ALPIC_IDENTIFY_META_KEY"
|
|
1234
1641
|
];
|
|
1235
1642
|
const environmentVariableSchema = z.object({
|
|
1236
1643
|
key: z.string().min(2, "Key must be at least 2 characters").regex(/^[a-zA-Z]([a-zA-Z0-9_])+$/, "Key must start with a letter and contain only letters, numbers, and underscores").refine((key) => !RESERVED_KEYS.includes(key), "This key is reserved and cannot be used as an environment variable key"),
|
|
@@ -1283,6 +1690,14 @@ const serverFieldsSchema = z.object({
|
|
|
1283
1690
|
});
|
|
1284
1691
|
//#endregion
|
|
1285
1692
|
//#region src/api.contract.ts
|
|
1693
|
+
const isValidIanaTimeZone = (timeZone) => {
|
|
1694
|
+
try {
|
|
1695
|
+
new Intl.DateTimeFormat("en-US", { timeZone });
|
|
1696
|
+
return true;
|
|
1697
|
+
} catch {
|
|
1698
|
+
return false;
|
|
1699
|
+
}
|
|
1700
|
+
};
|
|
1286
1701
|
const deploymentStatusSchema = z.enum([
|
|
1287
1702
|
"ongoing",
|
|
1288
1703
|
"deployed",
|
|
@@ -1311,21 +1726,20 @@ const deploymentSchema = z.object({
|
|
|
1311
1726
|
isCurrent: z.boolean(),
|
|
1312
1727
|
deploymentPageUrl: z.url().nullable()
|
|
1313
1728
|
});
|
|
1314
|
-
const
|
|
1729
|
+
const isValidTimeInput = (value) => {
|
|
1315
1730
|
if (ms(value) !== void 0) return true;
|
|
1316
1731
|
return !Number.isNaN(new Date(value).getTime());
|
|
1317
1732
|
};
|
|
1318
|
-
const
|
|
1733
|
+
const timeInputSchema = z.string().refine(isValidTimeInput, { message: "Invalid time. Use relative (1h, 30m, 2d) or ISO 8601 format." });
|
|
1734
|
+
const base = oc.errors({ BAD_REQUEST: {} });
|
|
1735
|
+
const createEnvironmentContractV1 = base.route({
|
|
1319
1736
|
path: "/v1/environments",
|
|
1320
1737
|
method: "POST",
|
|
1321
1738
|
summary: "Create an environment",
|
|
1322
1739
|
description: "Create an environment for a project",
|
|
1323
1740
|
tags: ["environments"],
|
|
1324
1741
|
successDescription: "The environment has been created successfully"
|
|
1325
|
-
}).errors({
|
|
1326
|
-
NOT_FOUND: {},
|
|
1327
|
-
BAD_REQUEST: {}
|
|
1328
|
-
}).input(z.object({
|
|
1742
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1329
1743
|
projectId: z.string().describe("The ID of the project to create the environment for"),
|
|
1330
1744
|
name: z.string().min(1).describe("The name of the environment"),
|
|
1331
1745
|
sourceBranch: z.string().min(1).describe("The branch used to build the environment"),
|
|
@@ -1338,7 +1752,7 @@ const createEnvironmentContractV1 = oc.route({
|
|
|
1338
1752
|
createdAt: z.coerce.date(),
|
|
1339
1753
|
projectId: z.string().describe("The ID of the project the environment belongs to")
|
|
1340
1754
|
}));
|
|
1341
|
-
const getEnvironmentContractV1 =
|
|
1755
|
+
const getEnvironmentContractV1 = base.route({
|
|
1342
1756
|
path: "/v1/environments/{environmentId}",
|
|
1343
1757
|
method: "GET",
|
|
1344
1758
|
summary: "Get an environment",
|
|
@@ -1354,6 +1768,14 @@ const getEnvironmentContractV1 = oc.route({
|
|
|
1354
1768
|
createdAt: z.coerce.date(),
|
|
1355
1769
|
projectId: z.string()
|
|
1356
1770
|
}));
|
|
1771
|
+
const deleteEnvironmentContractV1 = base.route({
|
|
1772
|
+
path: "/v1/environments/{environmentId}",
|
|
1773
|
+
method: "DELETE",
|
|
1774
|
+
summary: "Delete an environment",
|
|
1775
|
+
description: "All environments can be deleted except the production environment. This operation is not reversible: associated logs, analytics, and metrics are deleted as well.",
|
|
1776
|
+
tags: ["environments"],
|
|
1777
|
+
successDescription: "The environment has been deleted successfully"
|
|
1778
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.object({ success: z.literal(true) }));
|
|
1357
1779
|
const domainSchema = z.object({
|
|
1358
1780
|
domain: z.string(),
|
|
1359
1781
|
status: z.enum([
|
|
@@ -1395,7 +1817,7 @@ const projectOutputSchema = z.object({
|
|
|
1395
1817
|
productionEnvironment: productionEnvironmentSchema.nullable(),
|
|
1396
1818
|
environments: z.array(environmentSchema)
|
|
1397
1819
|
});
|
|
1398
|
-
const getProjectContractV1 =
|
|
1820
|
+
const getProjectContractV1 = base.route({
|
|
1399
1821
|
path: "/v1/projects/{projectId}",
|
|
1400
1822
|
method: "GET",
|
|
1401
1823
|
summary: "Get a project",
|
|
@@ -1403,18 +1825,15 @@ const getProjectContractV1 = oc.route({
|
|
|
1403
1825
|
tags: ["projects"],
|
|
1404
1826
|
successDescription: "The project details"
|
|
1405
1827
|
}).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(projectOutputSchema);
|
|
1406
|
-
const listProjectsContractV1 =
|
|
1828
|
+
const listProjectsContractV1 = base.route({
|
|
1407
1829
|
path: "/v1/projects",
|
|
1408
1830
|
method: "GET",
|
|
1409
1831
|
summary: "List projects",
|
|
1410
1832
|
description: "List all projects for a team",
|
|
1411
1833
|
tags: ["projects"],
|
|
1412
1834
|
successDescription: "The list of projects"
|
|
1413
|
-
}).errors({
|
|
1414
|
-
|
|
1415
|
-
BAD_REQUEST: {}
|
|
1416
|
-
}).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
|
|
1417
|
-
const createProjectContractV1 = oc.route({
|
|
1835
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.array(projectOutputSchema));
|
|
1836
|
+
const createProjectContractV1 = base.route({
|
|
1418
1837
|
path: "/v1/projects",
|
|
1419
1838
|
method: "POST",
|
|
1420
1839
|
summary: "Create a project",
|
|
@@ -1423,7 +1842,7 @@ const createProjectContractV1 = oc.route({
|
|
|
1423
1842
|
successDescription: "The project has been created successfully"
|
|
1424
1843
|
}).errors({
|
|
1425
1844
|
NOT_FOUND: {},
|
|
1426
|
-
|
|
1845
|
+
FORBIDDEN: {}
|
|
1427
1846
|
}).input(z.object({
|
|
1428
1847
|
teamId: z.string().optional(),
|
|
1429
1848
|
name: z.string().trim().min(1).max(100),
|
|
@@ -1463,7 +1882,7 @@ const environmentVariableOutputSchema = z.object({
|
|
|
1463
1882
|
isSecret: z.boolean(),
|
|
1464
1883
|
createdAt: z.coerce.date()
|
|
1465
1884
|
});
|
|
1466
|
-
const listEnvironmentVariablesContractV1 =
|
|
1885
|
+
const listEnvironmentVariablesContractV1 = base.route({
|
|
1467
1886
|
path: "/v1/environments/{environmentId}/environment-variables",
|
|
1468
1887
|
method: "GET",
|
|
1469
1888
|
summary: "List environment variables",
|
|
@@ -1471,48 +1890,39 @@ const listEnvironmentVariablesContractV1 = oc.route({
|
|
|
1471
1890
|
tags: ["environments"],
|
|
1472
1891
|
successDescription: "The list of environment variables"
|
|
1473
1892
|
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(environmentVariableOutputSchema));
|
|
1474
|
-
const createEnvironmentVariablesContractV1 =
|
|
1893
|
+
const createEnvironmentVariablesContractV1 = base.route({
|
|
1475
1894
|
path: "/v1/environments/{environmentId}/environment-variables",
|
|
1476
1895
|
method: "POST",
|
|
1477
1896
|
summary: "Add environment variables",
|
|
1478
1897
|
description: "Add one or more environment variables to an environment",
|
|
1479
1898
|
tags: ["environments"],
|
|
1480
1899
|
successDescription: "The environment variables have been added successfully"
|
|
1481
|
-
}).errors({
|
|
1482
|
-
NOT_FOUND: {},
|
|
1483
|
-
BAD_REQUEST: {}
|
|
1484
|
-
}).input(z.object({
|
|
1900
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1485
1901
|
environmentId: z.string().describe("The ID of the environment"),
|
|
1486
1902
|
environmentVariables: environmentVariablesSchema
|
|
1487
1903
|
})).output(z.object({ success: z.literal(true) }));
|
|
1488
|
-
const updateEnvironmentVariableContractV1 =
|
|
1904
|
+
const updateEnvironmentVariableContractV1 = base.route({
|
|
1489
1905
|
path: "/v1/environment-variables/{environmentVariableId}",
|
|
1490
1906
|
method: "PATCH",
|
|
1491
1907
|
summary: "Update an environment variable",
|
|
1492
1908
|
description: "Update an environment variable by ID",
|
|
1493
1909
|
tags: ["environments"],
|
|
1494
1910
|
successDescription: "The environment variable has been updated successfully"
|
|
1495
|
-
}).errors({
|
|
1496
|
-
NOT_FOUND: {},
|
|
1497
|
-
BAD_REQUEST: {}
|
|
1498
|
-
}).input(z.object({
|
|
1911
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1499
1912
|
environmentVariableId: z.string().describe("The ID of the environment variable"),
|
|
1500
1913
|
key: environmentVariableSchema.shape.key,
|
|
1501
1914
|
value: environmentVariableSchema.shape.value.optional(),
|
|
1502
1915
|
isSecret: environmentVariableSchema.shape.isSecret.optional()
|
|
1503
1916
|
})).output(z.object({ success: z.literal(true) }));
|
|
1504
|
-
const deleteEnvironmentVariableContractV1 =
|
|
1917
|
+
const deleteEnvironmentVariableContractV1 = base.route({
|
|
1505
1918
|
path: "/v1/environment-variables/{environmentVariableId}",
|
|
1506
1919
|
method: "DELETE",
|
|
1507
1920
|
summary: "Delete an environment variable",
|
|
1508
1921
|
description: "Delete an environment variable by ID",
|
|
1509
1922
|
tags: ["environments"],
|
|
1510
1923
|
successDescription: "The environment variable has been deleted successfully"
|
|
1511
|
-
}).errors({
|
|
1512
|
-
|
|
1513
|
-
BAD_REQUEST: {}
|
|
1514
|
-
}).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
|
|
1515
|
-
const deleteProjectContractV1 = oc.route({
|
|
1924
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentVariableId: z.string().describe("The ID of the environment variable") })).output(z.object({ success: z.literal(true) }));
|
|
1925
|
+
const deleteProjectContractV1 = base.route({
|
|
1516
1926
|
path: "/v1/projects/{projectId}",
|
|
1517
1927
|
method: "DELETE",
|
|
1518
1928
|
summary: "Delete a project",
|
|
@@ -1520,7 +1930,7 @@ const deleteProjectContractV1 = oc.route({
|
|
|
1520
1930
|
tags: ["projects"],
|
|
1521
1931
|
successDescription: "The project has been deleted successfully"
|
|
1522
1932
|
}).errors({ NOT_FOUND: {} }).input(z.object({ projectId: z.string().describe("The ID of the project") })).output(z.object({ success: z.literal(true) }));
|
|
1523
|
-
const updateProjectContractV1 =
|
|
1933
|
+
const updateProjectContractV1 = base.route({
|
|
1524
1934
|
path: "/v1/projects/{projectId}",
|
|
1525
1935
|
method: "PATCH",
|
|
1526
1936
|
summary: "Update a project",
|
|
@@ -1529,13 +1939,13 @@ const updateProjectContractV1 = oc.route({
|
|
|
1529
1939
|
successDescription: "The project has been updated successfully"
|
|
1530
1940
|
}).errors({
|
|
1531
1941
|
NOT_FOUND: {},
|
|
1532
|
-
|
|
1942
|
+
FORBIDDEN: {}
|
|
1533
1943
|
}).input(z.object({
|
|
1534
1944
|
projectId: z.string().describe("The ID of the project"),
|
|
1535
1945
|
name: z.string().min(1).max(100).optional().describe("The new name for the project"),
|
|
1536
1946
|
sourceRepository: z.string().nullable().optional().describe("The source repository to connect to the project")
|
|
1537
1947
|
})).output(projectOutputSchema);
|
|
1538
|
-
const deployEnvironmentContractV1 =
|
|
1948
|
+
const deployEnvironmentContractV1 = base.route({
|
|
1539
1949
|
path: "/v1/environments/{environmentId}/deploy",
|
|
1540
1950
|
method: "POST",
|
|
1541
1951
|
summary: "Deploy an environment",
|
|
@@ -1544,27 +1954,25 @@ const deployEnvironmentContractV1 = oc.route({
|
|
|
1544
1954
|
successDescription: "The environment has been deployed successfully"
|
|
1545
1955
|
}).errors({
|
|
1546
1956
|
NOT_FOUND: {},
|
|
1547
|
-
|
|
1957
|
+
CONFLICT: {}
|
|
1548
1958
|
}).input(z.object({
|
|
1549
1959
|
environmentId: z.string().describe("The ID of the environment to deploy"),
|
|
1550
|
-
token: z.string().describe("The token to identify the source archive").optional()
|
|
1960
|
+
token: z.string().describe("The token to identify the source archive").optional(),
|
|
1961
|
+
settings: buildSettingsSchema.extend({ transport: transportSchema }).optional().describe("Project settings detected by the client from the source. When provided, the server skips downloading and extracting the source archive to detect them.")
|
|
1551
1962
|
})).output(deploymentSchema);
|
|
1552
|
-
const uploadDeploymentArtifactContractV1 =
|
|
1963
|
+
const uploadDeploymentArtifactContractV1 = base.route({
|
|
1553
1964
|
path: "/v1/deployments/upload",
|
|
1554
1965
|
method: "POST",
|
|
1555
1966
|
summary: "Upload deployment artifacts",
|
|
1556
1967
|
description: "Return a presigned S3 URL to upload a deployment artifact",
|
|
1557
1968
|
tags: ["deployments"],
|
|
1558
1969
|
successDescription: "The presigned upload URL has been generated successfully"
|
|
1559
|
-
}).errors({
|
|
1560
|
-
NOT_FOUND: {},
|
|
1561
|
-
BAD_REQUEST: {}
|
|
1562
|
-
}).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
|
|
1970
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().optional() }).optional()).output(z.object({
|
|
1563
1971
|
uploadUrl: z.url().describe("Presigned S3 URL to upload the source archive with HTTP PUT"),
|
|
1564
1972
|
token: z.string().describe("Token to identify the source archive"),
|
|
1565
1973
|
expiresAt: z.coerce.date().describe("Expiration date of the presigned URL")
|
|
1566
1974
|
}));
|
|
1567
|
-
const listDeploymentsContractV1 =
|
|
1975
|
+
const listDeploymentsContractV1 = base.route({
|
|
1568
1976
|
path: "/v1/projects/{projectId}/deployments",
|
|
1569
1977
|
method: "GET",
|
|
1570
1978
|
summary: "List project deployments",
|
|
@@ -1576,7 +1984,7 @@ const listDeploymentsContractV1 = oc.route({
|
|
|
1576
1984
|
status: z.array(deploymentStatusSchema).optional().describe("Filter by one or more statuses"),
|
|
1577
1985
|
environmentId: z.string().optional().describe("Filter by environment ID")
|
|
1578
1986
|
})).output(z.array(deploymentSchema));
|
|
1579
|
-
const getDeploymentContractV1 =
|
|
1987
|
+
const getDeploymentContractV1 = base.route({
|
|
1580
1988
|
path: "/v1/deployments/{deploymentId}",
|
|
1581
1989
|
method: "GET",
|
|
1582
1990
|
summary: "Get a deployment",
|
|
@@ -1584,20 +1992,32 @@ const getDeploymentContractV1 = oc.route({
|
|
|
1584
1992
|
tags: ["deployments"],
|
|
1585
1993
|
successDescription: "The deployment details"
|
|
1586
1994
|
}).errors({ NOT_FOUND: {} }).input(z.object({ deploymentId: z.string().describe("The ID of the deployment") })).output(deploymentSchema);
|
|
1587
|
-
const
|
|
1995
|
+
const logEntrySchema = z.object({
|
|
1996
|
+
timestamp: z.coerce.date(),
|
|
1997
|
+
type: z.enum([
|
|
1998
|
+
"START",
|
|
1999
|
+
"END",
|
|
2000
|
+
"INFO",
|
|
2001
|
+
"ERROR",
|
|
2002
|
+
"WARNING",
|
|
2003
|
+
"DEBUG"
|
|
2004
|
+
]),
|
|
2005
|
+
requestId: z.string(),
|
|
2006
|
+
content: z.string().optional(),
|
|
2007
|
+
method: z.string().optional(),
|
|
2008
|
+
durationInMs: z.number().optional()
|
|
2009
|
+
});
|
|
2010
|
+
const getLogsContractV1 = base.route({
|
|
1588
2011
|
path: "/v1/environments/{environmentId}/logs",
|
|
1589
2012
|
method: "GET",
|
|
1590
2013
|
summary: "Get logs",
|
|
1591
2014
|
description: "Get logs for an environment",
|
|
1592
2015
|
tags: ["environments"],
|
|
1593
2016
|
successDescription: "The logs"
|
|
1594
|
-
}).errors({
|
|
1595
|
-
NOT_FOUND: {},
|
|
1596
|
-
BAD_REQUEST: {}
|
|
1597
|
-
}).input(z.object({
|
|
2017
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1598
2018
|
environmentId: z.string().describe("The ID of the environment"),
|
|
1599
|
-
since:
|
|
1600
|
-
until:
|
|
2019
|
+
since: timeInputSchema.optional().describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
|
|
2020
|
+
until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
|
|
1601
2021
|
limit: z.coerce.number().int().min(1).max(1e3).default(1e3).describe("Maximum number of log entries to return."),
|
|
1602
2022
|
level: z.array(z.enum([
|
|
1603
2023
|
"INFO",
|
|
@@ -1608,34 +2028,17 @@ const getLogsContractV1 = oc.route({
|
|
|
1608
2028
|
search: z.string().optional().describe("Filter pattern to search for in log content"),
|
|
1609
2029
|
nextToken: z.string().optional().describe("Pagination token from a previous response")
|
|
1610
2030
|
})).output(z.object({
|
|
1611
|
-
logs: z.array(
|
|
1612
|
-
timestamp: z.coerce.date(),
|
|
1613
|
-
type: z.enum([
|
|
1614
|
-
"START",
|
|
1615
|
-
"END",
|
|
1616
|
-
"INFO",
|
|
1617
|
-
"ERROR",
|
|
1618
|
-
"WARNING",
|
|
1619
|
-
"DEBUG"
|
|
1620
|
-
]),
|
|
1621
|
-
requestId: z.string(),
|
|
1622
|
-
content: z.string().optional(),
|
|
1623
|
-
method: z.string().optional(),
|
|
1624
|
-
durationInMs: z.number().optional()
|
|
1625
|
-
})),
|
|
2031
|
+
logs: z.array(logEntrySchema),
|
|
1626
2032
|
nextToken: z.string().nullable()
|
|
1627
2033
|
}));
|
|
1628
|
-
const getLatestLogsContractV1 =
|
|
2034
|
+
const getLatestLogsContractV1 = base.route({
|
|
1629
2035
|
path: "/v1/environments/{environmentId}/latest-logs",
|
|
1630
2036
|
method: "GET",
|
|
1631
2037
|
summary: "Get latest logs",
|
|
1632
2038
|
description: "Get the N most recent logs for an environment",
|
|
1633
2039
|
tags: ["environments"],
|
|
1634
2040
|
successDescription: "The latest logs"
|
|
1635
|
-
}).errors({
|
|
1636
|
-
NOT_FOUND: {},
|
|
1637
|
-
BAD_REQUEST: {}
|
|
1638
|
-
}).input(z.object({
|
|
2041
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1639
2042
|
environmentId: z.string().describe("The ID of the environment"),
|
|
1640
2043
|
limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
|
|
1641
2044
|
level: z.array(z.enum([
|
|
@@ -1645,22 +2048,8 @@ const getLatestLogsContractV1 = oc.route({
|
|
|
1645
2048
|
"DEBUG"
|
|
1646
2049
|
])).optional().describe("Filter by log level"),
|
|
1647
2050
|
search: z.string().optional().describe("Filter pattern to search for in log content")
|
|
1648
|
-
})).output(z.object({ logs: z.array(
|
|
1649
|
-
|
|
1650
|
-
type: z.enum([
|
|
1651
|
-
"START",
|
|
1652
|
-
"END",
|
|
1653
|
-
"INFO",
|
|
1654
|
-
"ERROR",
|
|
1655
|
-
"WARNING",
|
|
1656
|
-
"DEBUG"
|
|
1657
|
-
]),
|
|
1658
|
-
requestId: z.string(),
|
|
1659
|
-
content: z.string().optional(),
|
|
1660
|
-
method: z.string().optional(),
|
|
1661
|
-
durationInMs: z.number().optional()
|
|
1662
|
-
})) }));
|
|
1663
|
-
const getDeploymentLogsContractV1 = oc.route({
|
|
2051
|
+
})).output(z.object({ logs: z.array(logEntrySchema) }));
|
|
2052
|
+
const getDeploymentLogsContractV1 = base.route({
|
|
1664
2053
|
path: "/v1/deployments/{deploymentId}/logs",
|
|
1665
2054
|
method: "GET",
|
|
1666
2055
|
summary: "Get deployment logs",
|
|
@@ -1687,22 +2076,19 @@ const analyticsTimeSeriesSchema = z.object({
|
|
|
1687
2076
|
output_token_mean: z.array(analyticsDataPointSchema),
|
|
1688
2077
|
task_count: z.array(analyticsDataPointSchema)
|
|
1689
2078
|
});
|
|
1690
|
-
const getProjectAnalyticsContractV1 =
|
|
2079
|
+
const getProjectAnalyticsContractV1 = base.route({
|
|
1691
2080
|
path: "/v1/analytics/{projectId}",
|
|
1692
2081
|
method: "GET",
|
|
1693
2082
|
summary: "Get project analytics",
|
|
1694
2083
|
description: "Get analytics data for a project over a time range",
|
|
1695
2084
|
tags: ["analytics"],
|
|
1696
2085
|
successDescription: "The project analytics data"
|
|
1697
|
-
}).errors({
|
|
1698
|
-
NOT_FOUND: {},
|
|
1699
|
-
BAD_REQUEST: {}
|
|
1700
|
-
}).input(z.object({
|
|
2086
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1701
2087
|
projectId: z.string().describe("The ID of the project"),
|
|
1702
2088
|
startTimestamp: z.coerce.number().describe("Start timestamp in milliseconds"),
|
|
1703
2089
|
endTimestamp: z.coerce.number().describe("End timestamp in milliseconds"),
|
|
1704
2090
|
timeZone: z.string().describe("IANA timezone (e.g. Europe/Paris)")
|
|
1705
|
-
}).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <=
|
|
2091
|
+
}).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp > 0, { message: "End date must be after start date" }).refine(({ startTimestamp, endTimestamp }) => endTimestamp - startTimestamp <= 26784e5, { message: "Date range must be less than 1 month" }).refine(({ timeZone }) => isValidIanaTimeZone(timeZone), { message: "Time zone must be a valid IANA timezone" })).output(z.object({
|
|
1706
2092
|
metadata: z.object({
|
|
1707
2093
|
startTimestamp: z.number(),
|
|
1708
2094
|
endTimestamp: z.number(),
|
|
@@ -1712,7 +2098,132 @@ const getProjectAnalyticsContractV1 = oc.route({
|
|
|
1712
2098
|
}),
|
|
1713
2099
|
timeSeries: analyticsTimeSeriesSchema
|
|
1714
2100
|
}));
|
|
1715
|
-
const
|
|
2101
|
+
const paginatedInsightsInputShape = {
|
|
2102
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2103
|
+
since: timeInputSchema.default("7d").describe("Start time — ISO 8601 (2024-01-01T00:00:00Z) or relative (1h, 30m, 2d)"),
|
|
2104
|
+
until: timeInputSchema.optional().describe("End time — ISO 8601 or relative"),
|
|
2105
|
+
limit: z.coerce.number().int().min(1).max(200).default(50),
|
|
2106
|
+
offset: z.coerce.number().int().min(0).default(0),
|
|
2107
|
+
search: z.string().trim().min(1).max(200).optional()
|
|
2108
|
+
};
|
|
2109
|
+
const listIntentsContractV1 = base.route({
|
|
2110
|
+
path: "/v1/environments/{environmentId}/intents",
|
|
2111
|
+
method: "GET",
|
|
2112
|
+
summary: "List intents",
|
|
2113
|
+
description: "List grouped user intents for an environment over a time range",
|
|
2114
|
+
tags: ["insights"],
|
|
2115
|
+
successDescription: "The grouped user intents"
|
|
2116
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2117
|
+
...paginatedInsightsInputShape,
|
|
2118
|
+
tools: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
|
|
2119
|
+
clientIds: z.array(z.string().min(1)).min(1).max(100).optional(),
|
|
2120
|
+
categoryIds: z.array(z.string().trim().min(1)).min(1).max(100).optional(),
|
|
2121
|
+
sortDir: z.enum(["asc", "desc"]).default("desc")
|
|
2122
|
+
})).output(z.object({
|
|
2123
|
+
intents: z.array(z.object({
|
|
2124
|
+
id: z.string(),
|
|
2125
|
+
intentIds: z.array(z.string()).min(1),
|
|
2126
|
+
environmentId: z.string(),
|
|
2127
|
+
message: z.string(),
|
|
2128
|
+
toolName: z.string(),
|
|
2129
|
+
createdAt: z.coerce.date(),
|
|
2130
|
+
occurrenceCount: z.number().int().positive(),
|
|
2131
|
+
clientName: z.string().nullable(),
|
|
2132
|
+
clientId: z.string().nullable(),
|
|
2133
|
+
categories: z.array(z.object({
|
|
2134
|
+
id: z.string(),
|
|
2135
|
+
name: z.string(),
|
|
2136
|
+
color: intentCategoryColorSchema
|
|
2137
|
+
}))
|
|
2138
|
+
})),
|
|
2139
|
+
totalCount: z.number().int().nonnegative()
|
|
2140
|
+
}));
|
|
2141
|
+
const listFeedbacksContractV1 = base.route({
|
|
2142
|
+
path: "/v1/environments/{environmentId}/feedbacks",
|
|
2143
|
+
method: "GET",
|
|
2144
|
+
summary: "List feedbacks",
|
|
2145
|
+
description: "List user feedback for an environment over a time range",
|
|
2146
|
+
tags: ["insights"],
|
|
2147
|
+
successDescription: "The user feedback"
|
|
2148
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2149
|
+
...paginatedInsightsInputShape,
|
|
2150
|
+
clientIds: z.array(z.string().min(1)).min(1).max(100).optional()
|
|
2151
|
+
})).output(z.object({
|
|
2152
|
+
feedbacks: z.array(feedbackSchema.extend({ clientId: z.string().nullable() })),
|
|
2153
|
+
totalCount: z.number().int().nonnegative()
|
|
2154
|
+
}));
|
|
2155
|
+
const intentCategoryNameSchema = z.string().trim().min(1).max(100).describe("The category name");
|
|
2156
|
+
const categorizableIntentIdsSchema = z.array(z.string().trim().min(1)).min(1).max(100).describe("IDs of the intents to categorize");
|
|
2157
|
+
const listIntentCategoriesContractV1 = base.route({
|
|
2158
|
+
path: "/v1/environments/{environmentId}/intent-categories",
|
|
2159
|
+
method: "GET",
|
|
2160
|
+
summary: "List intent categories",
|
|
2161
|
+
description: "List intent categories for an environment, including how many intents each category is linked to",
|
|
2162
|
+
tags: ["insights"],
|
|
2163
|
+
successDescription: "The intent categories"
|
|
2164
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(intentCategorySummarySchema));
|
|
2165
|
+
const createIntentCategoryContractV1 = base.route({
|
|
2166
|
+
path: "/v1/environments/{environmentId}/intent-categories",
|
|
2167
|
+
method: "POST",
|
|
2168
|
+
summary: "Create an intent category",
|
|
2169
|
+
description: "Create an intent category, optionally linking it to existing intents",
|
|
2170
|
+
tags: ["insights"],
|
|
2171
|
+
successDescription: "The created intent category"
|
|
2172
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2173
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2174
|
+
name: intentCategoryNameSchema,
|
|
2175
|
+
color: intentCategoryColorSchema.optional().describe("The category color; derived from the name when omitted"),
|
|
2176
|
+
intentIds: categorizableIntentIdsSchema.optional().describe("IDs of intents to link to the new category")
|
|
2177
|
+
})).output(intentCategorySchema);
|
|
2178
|
+
const updateIntentCategoryContractV1 = base.route({
|
|
2179
|
+
path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
|
|
2180
|
+
method: "PATCH",
|
|
2181
|
+
summary: "Update an intent category",
|
|
2182
|
+
description: "Rename or recolor an intent category",
|
|
2183
|
+
tags: ["insights"],
|
|
2184
|
+
successDescription: "The updated intent category"
|
|
2185
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2186
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2187
|
+
categoryId: z.string().describe("The ID of the category"),
|
|
2188
|
+
name: intentCategoryNameSchema.optional(),
|
|
2189
|
+
color: intentCategoryColorSchema.optional().describe("The category color")
|
|
2190
|
+
}).refine(({ name, color }) => name !== void 0 || color !== void 0, { message: "At least one of name or color must be provided" })).output(intentCategorySchema);
|
|
2191
|
+
const deleteIntentCategoryContractV1 = base.route({
|
|
2192
|
+
path: "/v1/environments/{environmentId}/intent-categories/{categoryId}",
|
|
2193
|
+
method: "DELETE",
|
|
2194
|
+
summary: "Delete an intent category",
|
|
2195
|
+
description: "Delete an intent category; its intents are unlinked but not deleted",
|
|
2196
|
+
tags: ["insights"],
|
|
2197
|
+
successDescription: "The intent category has been deleted successfully"
|
|
2198
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2199
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2200
|
+
categoryId: z.string().describe("The ID of the category")
|
|
2201
|
+
})).output(z.object({ success: z.literal(true) }));
|
|
2202
|
+
const linkIntentCategoryContractV1 = base.route({
|
|
2203
|
+
path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/link",
|
|
2204
|
+
method: "POST",
|
|
2205
|
+
summary: "Link an intent category",
|
|
2206
|
+
description: "Link an intent category to intents; already linked intents are ignored",
|
|
2207
|
+
tags: ["insights"],
|
|
2208
|
+
successDescription: "The intents have been linked successfully"
|
|
2209
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2210
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2211
|
+
categoryId: z.string().describe("The ID of the category"),
|
|
2212
|
+
intentIds: categorizableIntentIdsSchema
|
|
2213
|
+
})).output(z.object({ success: z.literal(true) }));
|
|
2214
|
+
const unlinkIntentCategoryContractV1 = base.route({
|
|
2215
|
+
path: "/v1/environments/{environmentId}/intent-categories/{categoryId}/unlink",
|
|
2216
|
+
method: "POST",
|
|
2217
|
+
summary: "Unlink an intent category",
|
|
2218
|
+
description: "Unlink an intent category from intents; intents without the category are ignored",
|
|
2219
|
+
tags: ["insights"],
|
|
2220
|
+
successDescription: "The intents have been unlinked successfully"
|
|
2221
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
2222
|
+
environmentId: z.string().describe("The ID of the environment"),
|
|
2223
|
+
categoryId: z.string().describe("The ID of the category"),
|
|
2224
|
+
intentIds: categorizableIntentIdsSchema
|
|
2225
|
+
})).output(z.object({ success: z.literal(true) }));
|
|
2226
|
+
const listTeamsContractV1 = base.route({
|
|
1716
2227
|
path: "/v1/teams",
|
|
1717
2228
|
method: "GET",
|
|
1718
2229
|
summary: "List teams",
|
|
@@ -1725,28 +2236,40 @@ const listTeamsContractV1 = oc.route({
|
|
|
1725
2236
|
createdAt: z.coerce.date(),
|
|
1726
2237
|
hasStripeAccount: z.boolean()
|
|
1727
2238
|
})));
|
|
1728
|
-
const
|
|
2239
|
+
const getTeamUsageContractV1 = base.route({
|
|
2240
|
+
path: "/v1/teams/{teamId}/usage",
|
|
2241
|
+
method: "GET",
|
|
2242
|
+
summary: "Get team usage",
|
|
2243
|
+
description: "Get the MCP request usage of a team for its current billing window. A team that has made no request in the window reports zero.",
|
|
2244
|
+
tags: ["teams"],
|
|
2245
|
+
successDescription: "The current billing window usage"
|
|
2246
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({ teamId: z.string().describe("The ID of the team") })).output(z.object({
|
|
2247
|
+
teamId: z.string(),
|
|
2248
|
+
plan: subscriptionPlanSchema.nullable().describe("The plan in force for the window, null on the Free plan"),
|
|
2249
|
+
periodStart: z.coerce.date().describe("Start of the current billing window"),
|
|
2250
|
+
periodEnd: z.coerce.date().describe("End of the current billing window"),
|
|
2251
|
+
requestCount: z.number().int().describe("MCP requests settled during the current billing window"),
|
|
2252
|
+
includedRequests: z.number().int().nullable().describe("Requests included in the plan for one window, null when the allowance is contract-specific")
|
|
2253
|
+
}));
|
|
2254
|
+
const getTunnelTicketContractV1 = base.route({
|
|
1729
2255
|
path: "/v1/tunnels/ticket",
|
|
1730
2256
|
method: "GET",
|
|
1731
2257
|
summary: "Get a tunnel ticket",
|
|
1732
2258
|
description: "Get a signed ticket for establishing a tunnel connection. Requires user authentication (API keys are not supported).",
|
|
1733
2259
|
tags: ["tunnels"],
|
|
1734
2260
|
successDescription: "The tunnel ticket"
|
|
1735
|
-
}).errors({ FORBIDDEN: {} }).output(z.object({
|
|
2261
|
+
}).meta({ authScope: AUTH_SCOPE_USER }).errors({ FORBIDDEN: {} }).output(z.object({
|
|
1736
2262
|
subdomain: z.string().describe("The subdomain assigned to the user"),
|
|
1737
2263
|
ticket: z.string().describe("The signed tunnel ticket"),
|
|
1738
2264
|
tunnelHost: z.string().describe("The tunnel host to connect to")
|
|
1739
2265
|
}));
|
|
1740
|
-
const publishServerContractV1 =
|
|
2266
|
+
const publishServerContractV1 = base.route({
|
|
1741
2267
|
path: "/v1/distribution/publish",
|
|
1742
2268
|
method: "POST",
|
|
1743
2269
|
summary: "Publish a server to the MCP registry",
|
|
1744
2270
|
tags: ["distribution"],
|
|
1745
2271
|
successDescription: "The server has been published successfully"
|
|
1746
|
-
}).errors({
|
|
1747
|
-
NOT_FOUND: {},
|
|
1748
|
-
BAD_REQUEST: {}
|
|
1749
|
-
}).input(z.object({
|
|
2272
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1750
2273
|
projectId: z.string(),
|
|
1751
2274
|
domain: z.string(),
|
|
1752
2275
|
title: z.string().min(1).max(100),
|
|
@@ -1755,17 +2278,14 @@ const publishServerContractV1 = oc.route({
|
|
|
1755
2278
|
iconSrc: z.url().max(255).optional(),
|
|
1756
2279
|
dryRun: z.boolean().optional()
|
|
1757
2280
|
})).output(z.object({ serverFields: serverFieldsSchema }));
|
|
1758
|
-
const getServerInfoContractV1 =
|
|
2281
|
+
const getServerInfoContractV1 = base.route({
|
|
1759
2282
|
path: "/v1/distribution/get",
|
|
1760
2283
|
method: "GET",
|
|
1761
2284
|
summary: "Get server info",
|
|
1762
2285
|
description: "Get info about a server",
|
|
1763
2286
|
tags: ["distribution"],
|
|
1764
2287
|
successDescription: "The server info"
|
|
1765
|
-
}).errors({
|
|
1766
|
-
NOT_FOUND: {},
|
|
1767
|
-
BAD_REQUEST: {}
|
|
1768
|
-
}).input(z.object({
|
|
2288
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1769
2289
|
projectId: z.string(),
|
|
1770
2290
|
domain: z.string()
|
|
1771
2291
|
})).output(z.object({ serverFields: serverFieldsSchema }));
|
|
@@ -1784,7 +2304,7 @@ const playgroundOutputSchema = z.object({
|
|
|
1784
2304
|
isPlaygroundEnabled: z.boolean(),
|
|
1785
2305
|
serverMetadata: playgroundServerMetadataOutputSchema.nullable()
|
|
1786
2306
|
});
|
|
1787
|
-
const getPlaygroundContractV1 =
|
|
2307
|
+
const getPlaygroundContractV1 = base.route({
|
|
1788
2308
|
path: "/v1/environments/{environmentId}/playground",
|
|
1789
2309
|
method: "GET",
|
|
1790
2310
|
summary: "Get playground configuration",
|
|
@@ -1792,17 +2312,14 @@ const getPlaygroundContractV1 = oc.route({
|
|
|
1792
2312
|
tags: ["environments"],
|
|
1793
2313
|
successDescription: "The playground configuration"
|
|
1794
2314
|
}).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
|
|
1795
|
-
const upsertPlaygroundContractV1 =
|
|
2315
|
+
const upsertPlaygroundContractV1 = base.route({
|
|
1796
2316
|
path: "/v1/environments/{environmentId}/playground",
|
|
1797
2317
|
method: "PUT",
|
|
1798
2318
|
summary: "Update playground configuration",
|
|
1799
2319
|
description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
|
|
1800
2320
|
tags: ["environments"],
|
|
1801
2321
|
successDescription: "The updated playground configuration"
|
|
1802
|
-
}).errors({
|
|
1803
|
-
NOT_FOUND: {},
|
|
1804
|
-
BAD_REQUEST: {}
|
|
1805
|
-
}).input(z.object({
|
|
2322
|
+
}).errors({ NOT_FOUND: {} }).input(z.object({
|
|
1806
2323
|
environmentId: z.string().describe("The ID of the environment"),
|
|
1807
2324
|
isPlaygroundEnabled: z.boolean().optional(),
|
|
1808
2325
|
name: z.string().min(1).max(100).optional(),
|
|
@@ -1810,7 +2327,7 @@ const upsertPlaygroundContractV1 = oc.route({
|
|
|
1810
2327
|
headers: z.array(playgroundHeaderSchema).optional(),
|
|
1811
2328
|
examplePrompts: z.array(playgroundExamplePromptSchema).max(5).optional()
|
|
1812
2329
|
})).output(playgroundOutputSchema);
|
|
1813
|
-
const createBeaconContractV1 =
|
|
2330
|
+
const createBeaconContractV1 = base.route({
|
|
1814
2331
|
path: "/v1/beacon/audits",
|
|
1815
2332
|
method: "POST",
|
|
1816
2333
|
summary: "Create a beacon audit",
|
|
@@ -1819,7 +2336,6 @@ const createBeaconContractV1 = oc.route({
|
|
|
1819
2336
|
successDescription: "The audit has been created"
|
|
1820
2337
|
}).errors({
|
|
1821
2338
|
NOT_FOUND: {},
|
|
1822
|
-
BAD_REQUEST: {},
|
|
1823
2339
|
DNS_RESOLUTION_FAILED: { status: 400 }
|
|
1824
2340
|
}).input(z.object({
|
|
1825
2341
|
targetUrl: z.url().describe("The HTTPS URL of the MCP server to audit"),
|
|
@@ -1827,7 +2343,7 @@ const createBeaconContractV1 = oc.route({
|
|
|
1827
2343
|
projectId: z.string().optional().describe("The project ID to associate the audit with"),
|
|
1828
2344
|
excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
|
|
1829
2345
|
})).output(z.object({ id: z.string() }));
|
|
1830
|
-
const getBeaconContractV1 =
|
|
2346
|
+
const getBeaconContractV1 = base.route({
|
|
1831
2347
|
path: "/v1/beacon/audits/{auditId}",
|
|
1832
2348
|
method: "GET",
|
|
1833
2349
|
summary: "Get a beacon audit",
|
|
@@ -1843,8 +2359,21 @@ const getBeaconContractV1 = oc.route({
|
|
|
1843
2359
|
report: auditReportWithScreenshotsSchema.nullable()
|
|
1844
2360
|
}));
|
|
1845
2361
|
const contract = {
|
|
1846
|
-
teams: {
|
|
2362
|
+
teams: {
|
|
2363
|
+
list: { v1: listTeamsContractV1 },
|
|
2364
|
+
getUsage: { v1: getTeamUsageContractV1 }
|
|
2365
|
+
},
|
|
1847
2366
|
analytics: { get: { v1: getProjectAnalyticsContractV1 } },
|
|
2367
|
+
intents: { list: { v1: listIntentsContractV1 } },
|
|
2368
|
+
intentCategories: {
|
|
2369
|
+
list: { v1: listIntentCategoriesContractV1 },
|
|
2370
|
+
create: { v1: createIntentCategoryContractV1 },
|
|
2371
|
+
update: { v1: updateIntentCategoryContractV1 },
|
|
2372
|
+
delete: { v1: deleteIntentCategoryContractV1 },
|
|
2373
|
+
link: { v1: linkIntentCategoryContractV1 },
|
|
2374
|
+
unlink: { v1: unlinkIntentCategoryContractV1 }
|
|
2375
|
+
},
|
|
2376
|
+
feedbacks: { list: { v1: listFeedbacksContractV1 } },
|
|
1848
2377
|
deployments: {
|
|
1849
2378
|
list: { v1: listDeploymentsContractV1 },
|
|
1850
2379
|
get: { v1: getDeploymentContractV1 },
|
|
@@ -1854,6 +2383,7 @@ const contract = {
|
|
|
1854
2383
|
environments: {
|
|
1855
2384
|
create: { v1: createEnvironmentContractV1 },
|
|
1856
2385
|
get: { v1: getEnvironmentContractV1 },
|
|
2386
|
+
delete: { v1: deleteEnvironmentContractV1 },
|
|
1857
2387
|
deploy: { v1: deployEnvironmentContractV1 },
|
|
1858
2388
|
getLogs: { v1: getLogsContractV1 },
|
|
1859
2389
|
getLatestLogs: { v1: getLatestLogsContractV1 }
|
|
@@ -1885,5 +2415,10 @@ const contract = {
|
|
|
1885
2415
|
get: { v1: getBeaconContractV1 }
|
|
1886
2416
|
}
|
|
1887
2417
|
};
|
|
2418
|
+
const { uploadArtifact: _discard, ...deploymentsForDocs } = contract.deployments;
|
|
2419
|
+
const contractForDocs = {
|
|
2420
|
+
...contract,
|
|
2421
|
+
deployments: deploymentsForDocs
|
|
2422
|
+
};
|
|
1888
2423
|
//#endregion
|
|
1889
|
-
export { PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
|
|
2424
|
+
export { AUTH_SCOPE_ANY, AUTH_SCOPE_USER, INTENT_CATEGORY_COLORS, PLATFORM_LABELS, buildSettingsSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, intentCategoryColorSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
|