@alpic-ai/api 0.0.0-staging.cdbdcc3 → 0.0.0-staging.ce7992f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.mts +195 -214
  2. package/dist/index.mjs +373 -80
  3. package/package.json +18 -6
package/dist/index.mjs CHANGED
@@ -1,6 +1,265 @@
1
+ import { z } from "zod";
1
2
  import { oc } from "@orpc/contract";
2
3
  import ms from "ms";
3
- import { z } from "zod";
4
+ const platformSchema = z.enum(["chatgpt", "claudeai"]);
5
+ const PLATFORM_LABELS = {
6
+ chatgpt: "ChatGPT",
7
+ claudeai: "Claude.ai"
8
+ };
9
+ const auditStatusSchema = z.enum([
10
+ "pending",
11
+ "partial",
12
+ "completed",
13
+ "failed"
14
+ ]);
15
+ const checkSeveritySchema = z.enum([
16
+ "error",
17
+ "warning",
18
+ "info"
19
+ ]);
20
+ const checkCategorySchema = z.enum([
21
+ "connectivity",
22
+ "tool-metadata",
23
+ "resource-metadata",
24
+ "performance",
25
+ "e2e"
26
+ ]);
27
+ const checkScopeSchema = z.enum(["server", "view"]);
28
+ const checkDetailSchema = z.object({
29
+ label: z.string(),
30
+ value: z.string().optional()
31
+ });
32
+ const checkResultSchema = z.object({
33
+ checkId: z.string(),
34
+ checkName: z.string(),
35
+ description: z.string(),
36
+ status: z.enum([
37
+ "pass",
38
+ "fail",
39
+ "skip",
40
+ "pending"
41
+ ]),
42
+ message: z.string(),
43
+ skipReason: z.string().optional(),
44
+ severity: checkSeveritySchema,
45
+ category: checkCategorySchema,
46
+ scope: checkScopeSchema,
47
+ platforms: z.array(platformSchema).readonly().optional(),
48
+ durationMs: z.number(),
49
+ details: z.array(checkDetailSchema).optional(),
50
+ hint: z.object({ text: z.string() }).optional()
51
+ });
52
+ const auditReportSchema = z.object({
53
+ schemaVersion: z.string(),
54
+ auditId: z.string(),
55
+ targetUrl: z.string(),
56
+ startedAt: z.string(),
57
+ completedAt: z.string(),
58
+ durationMs: z.number(),
59
+ results: z.array(checkResultSchema),
60
+ requiresAuth: z.boolean(),
61
+ hasViewSupport: z.boolean(),
62
+ viewPlatforms: z.array(platformSchema).readonly().optional(),
63
+ isReadyForPlatform: z.record(platformSchema, z.boolean()),
64
+ widgetScreenshotKeys: z.object({
65
+ chatgpt: z.string().optional(),
66
+ claudeai: z.string().optional()
67
+ })
68
+ });
69
+ const widgetScreenshotSchema = z.object({ url: z.string() });
70
+ const auditReportWithScreenshotsSchema = auditReportSchema.extend({ widgetScreenshots: z.object({
71
+ chatgpt: widgetScreenshotSchema.optional(),
72
+ claudeai: widgetScreenshotSchema.optional()
73
+ }) });
74
+ z.object({
75
+ id: z.string(),
76
+ createdAt: z.coerce.date(),
77
+ environmentId: z.string(),
78
+ content: z.string(),
79
+ source: z.enum(["model", "user"])
80
+ });
81
+ z.object({
82
+ content: z.string(),
83
+ source: z.enum(["model", "user"])
84
+ });
85
+ const toolDefinitionSchema = z.object({
86
+ name: z.string(),
87
+ title: z.string().optional(),
88
+ description: z.string().optional(),
89
+ annotations: z.object({
90
+ readOnlyHint: z.boolean().optional(),
91
+ destructiveHint: z.boolean().optional(),
92
+ openWorldHint: z.boolean().optional(),
93
+ idempotentHint: z.boolean().optional()
94
+ }).optional()
95
+ });
96
+ const positiveTestCaseSchema = z.object({
97
+ scenario: z.string(),
98
+ userPrompt: z.string(),
99
+ toolTriggered: z.string().optional(),
100
+ expectedOutput: z.string().optional()
101
+ }).partial().describe("Each case: Scenario, User prompt, Tool triggered, Expected output.");
102
+ const chatgptCategorySchema = z.enum([
103
+ "BUSINESS",
104
+ "COLLABORATION",
105
+ "DESIGN",
106
+ "DEVELOPER_TOOLS",
107
+ "EDUCATION",
108
+ "ENTERTAINMENT",
109
+ "FINANCE",
110
+ "FOOD",
111
+ "LIFESTYLE",
112
+ "NEWS",
113
+ "PRODUCTIVITY",
114
+ "SHOPPING",
115
+ "TRAVEL"
116
+ ]);
117
+ const chatgptAuthenticationSchema = z.enum(["No auth needed", "OAuth 2.0"]);
118
+ const chatgptAllowedCountriesSchema = z.enum(["Allow all", "Restrict to specific countries"]);
119
+ const negativeTestCaseSchema = z.object({
120
+ scenario: z.string(),
121
+ userPrompt: z.string()
122
+ }).partial().describe("Each case: Scenario + User prompt (the app should NOT trigger).");
123
+ const chatgptToolJustificationSchema = z.object({
124
+ toolName: z.string(),
125
+ readOnlyJustification: z.string(),
126
+ openWorldJustification: z.string(),
127
+ destructiveJustification: z.string()
128
+ }).describe("Per-tool justification of each MCP annotation value (one sentence per hint).");
129
+ const chatgptTranslationSchema = z.object({
130
+ locale: z.string(),
131
+ tagline: z.string().optional(),
132
+ description: z.string().optional()
133
+ }).describe("Locale-scoped override for tagline + description. English (US) is the default.");
134
+ /**
135
+ * Field order mirrors the ChatGPT (OpenAI) submission spreadsheet, grouped by section.
136
+ * When adding/removing/reordering fields, keep this in sync with the sheet.
137
+ */
138
+ const chatgptSubmissionFormDataSchema = z.object({
139
+ logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
140
+ logoDark: z.string().describe("Logo icon for dark mode. Square PNG. Same specs as the light icon."),
141
+ appName: z.string().describe("The name users will see in ChatGPT and in the Apps Directory."),
142
+ tagline: z.string().max(30).describe("Plain-language phrase focused on function and user value. 30 chars max."),
143
+ description: z.string().describe("Clear, engaging description highlighting what the app does and why people will love it. Appears publicly on the directory page."),
144
+ category: chatgptCategorySchema.describe("Category from the OpenAI taxonomy."),
145
+ developerName: z.string().describe("Developer name shown publicly on the app's directory page."),
146
+ companyUrl: z.url().describe("Your company's main website URL."),
147
+ supportChannel: z.string().describe("Customer support URL or email address."),
148
+ privacyPolicyUrl: z.url().describe("URL to your privacy policy."),
149
+ termsOfServiceUrl: z.url().describe("URL to the app's terms of service."),
150
+ demoRecordingUrl: z.url().describe("URL to a video demonstrating the app, recorded via OpenAI Developer Mode. Cover all main use cases on web, iOS, and Android."),
151
+ 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."),
152
+ serverUrl: z.url().describe("URL of the MCP server."),
153
+ authentication: chatgptAuthenticationSchema.describe("OAuth 2.0 or No auth. OAuth configuration is auto-discovered from the MCP server's metadata."),
154
+ tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
155
+ toolJustifications: z.array(chatgptToolJustificationSchema).describe("Per-tool justification of `readOnlyHint`, `openWorldHint`, and `destructiveHint` annotation values."),
156
+ testCases: z.array(positiveTestCaseSchema).describe("At least 5 positive test cases. Each: Scenario, User prompt, Tool triggered, Expected output. Coverage over all major use cases."),
157
+ negativeTestCases: z.array(negativeTestCaseSchema).describe("3 negative test cases — prompts where the app should NOT trigger but the model might think it's relevant."),
158
+ screenshots: z.array(z.url()).describe("URLs of in-app screenshots. Widget apps must show the widget UI; non-widget apps show the model response. Min 1, max 4. First three are public."),
159
+ translations: z.array(chatgptTranslationSchema).describe("Per-locale translation of tagline + description. English (US) is the default."),
160
+ allowedCountries: chatgptAllowedCountriesSchema.describe("'Allow all' or restrict to a specific list. See OpenAI's supported countries list."),
161
+ releaseNotes: z.string().describe("Publicly displayed on the app details page.")
162
+ }).partial();
163
+ const claudeCategorySchema = z.enum([
164
+ "Business & Productivity",
165
+ "Communication",
166
+ "Data & Analytics",
167
+ "Development tools",
168
+ "Financial Services",
169
+ "Consumer Health",
170
+ "Health & Life Sciences",
171
+ "Media & Entertainment",
172
+ "Commerce & Shopping"
173
+ ]);
174
+ z.enum([
175
+ "No auth needed",
176
+ "OAuth 2.0",
177
+ "Custom URL"
178
+ ]);
179
+ const claudeMcpUrlTypeSchema = z.enum(["Universal URL", "Custom MCP URLs"]);
180
+ z.enum(["Static OAuth Client", "Dynamic OAuth Client (DCR / CIMD)"]);
181
+ const claudeReadWriteCapabilitiesSchema = z.enum([
182
+ "Read only",
183
+ "Write only",
184
+ "Read + write"
185
+ ]);
186
+ const claudeTransportSchema = z.enum(["Streamable HTTP", "SSE"]);
187
+ const claudeThirdPartySchema = z.enum([
188
+ "Web access (open web fetch / scraping / arbitrary URLs)",
189
+ "Third-party AI model integration",
190
+ "Third-party data retrieval (via workflow / aggregator)",
191
+ "Third-party data modification (via workflow / aggregator)",
192
+ "N/A"
193
+ ]);
194
+ const claudeDataHandlingSchema = z.enum([
195
+ "Server only accesses data explicitly requested by user",
196
+ "No data is stored beyond session requirements",
197
+ "Data transmission is encrypted (HTTPS / TLS)",
198
+ "GDPR compliant (if applicable)"
199
+ ]);
200
+ const claudeSponsoredContentSchema = z.enum([
201
+ "No, there is no sponsored content or advertisements",
202
+ "Yes, there are banner ads or other paid visual elements",
203
+ "Yes, returned content or ranking is impacted by sponsorship or ad placement"
204
+ ]);
205
+ /**
206
+ * Field order mirrors the Claude (Anthropic) submission spreadsheet, grouped by section.
207
+ * When adding/removing/reordering fields, keep this in sync with the sheet.
208
+ */
209
+ const claudeSubmissionFormDataSchema = z.object({
210
+ companyName: z.string().describe("Enter your company's legal name or the name under which your product is publicly known. This is used for internal tracking and may appear in directory listings."),
211
+ companyUrl: z.url().describe("Your company's main website URL, e.g. https://mycompany.com. Must be a valid URL with https://. This should be the root domain of the company behind this MCP server."),
212
+ primaryContactName: z.string().describe("Full name of the person Anthropic should contact about this submission. This person will receive review feedback, approval notices, and any follow-up questions."),
213
+ primaryContactEmail: z.email().describe("Business email for the primary contact. Must be a valid email address. Anthropic uses this to communicate about your submission status, required changes, and post-listing issues. Avoid using personal email addresses."),
214
+ primaryContactRole: z.string().optional().describe("The job title or role of the primary contact (e.g. 'CTO', 'Developer Relations Lead', 'Founder'). Optional but helps Anthropic route questions to the right person."),
215
+ anthropicPointOfContact: z.string().optional().describe("If you have a direct contact at Anthropic (e.g. from a partnership or sales conversation), enter their name here. This is optional but can greatly help expedite the review process. Leave blank if you don't have one."),
216
+ appName: z.string().describe("The public display name for your connector as it will appear in the Connectors Directory. Rules: (1) Do NOT include the words 'MCP' or 'Server'. these are auto-rejected. (2) Use your brand/product name, e.g. 'Notion', 'Linear', 'Slack'. (3) You must own or have the right to use this brand name. For example, don't call it 'Google Drive Helper' if you're not Google."),
217
+ mcpUrlType: claudeMcpUrlTypeSchema.describe("Universal URL = one URL serves all users. Custom MCP URLs = signup URL + regex matching per-user URLs."),
218
+ serverUrl: z.url().describe("Production MCP server URL (https). Derived from the project's production environment by default."),
219
+ tagline: z.string().max(55).describe("Short blurb shown below the server name. 55 chars max."),
220
+ description: z.string().describe("50–100 words describing what the server does and its key capabilities. Lives on the directory listing."),
221
+ testCases: z.array(positiveTestCaseSchema).describe("At least 3 use cases with example prompts showing the value of the connector."),
222
+ connectionRequirements: z.string().describe("Prerequisites before connecting (free/premium account, admin seat, geographic availability, custom instance URL). State 'No special requirements.' if none."),
223
+ readWriteCapabilities: claudeReadWriteCapabilitiesSchema.describe("Inferred from the `readOnlyHint` annotations on the MCP tools."),
224
+ isMcpApp: z.boolean().describe("True if the server exposes interactive UI elements (widgets). Inferred from the MCP connection."),
225
+ thirdPartyConnectionsAndWebAccess: z.array(claudeThirdPartySchema).describe("Multi-select of what the server reaches out to (web, third-party AI, data aggregators)."),
226
+ dataHandling: z.array(claudeDataHandlingSchema).describe("Multi-select of data-handling practices that accurately describe the server. Cannot be inferred — user must self-declare."),
227
+ personalDataHealthAccess: z.boolean().describe("True only if the connector gives users access to their own personal health data (medical records, lab results, health metrics)."),
228
+ categories: z.array(claudeCategorySchema).describe("Multi-select of categories that best describe the server in the directory."),
229
+ sponsoredContentsOrAdvertisement: claudeSponsoredContentSchema.describe("Disclose paid promotion or sponsored content. Cannot be filled by Alpic — user must self-declare."),
230
+ transportSupport: z.array(claudeTransportSchema).describe("Multi-select of transport protocols the server supports. Anthropic recommends Streamable HTTP (SSE may be deprecated later this year)."),
231
+ serverDocumentationLink: z.url().describe("Public docs URL covering what the MCP does, setup, debugging, and self-serve support. The Alpic playground may be used."),
232
+ privacyPolicyUrl: z.url().describe("URL to your privacy policy. Mandatory and displayed alongside the directory listing."),
233
+ supportChannel: z.string().describe("Link or email for user support (help center, GitHub issues, docs, support@…). Displayed alongside the directory listing."),
234
+ testingCredentials: z.string().describe("Credentials for reviewers to verify functionality. Required if the server uses OAuth. No 2FA. Use mcp-review@anthropic.com if an accessible email is needed."),
235
+ tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
236
+ toolTitlesAnnotationsConfirmed: z.boolean().describe("Confirmation that all tools have user-friendly titles and accurate annotations (readOnlyHint, destructiveHint, …)."),
237
+ logoLight: z.string().describe("Server/app logo for light mode. Square 1:1 aspect ratio. SVG preferred for Claude."),
238
+ screenshots: z.array(z.url()).describe("URLs of screenshots of the connector on Claude.ai or promo material. 3–5 ideal. ≥1000px width preferred, PNG, cropped to the app response. Videos welcome.")
239
+ }).partial();
240
+ const submissionMetaFieldsSchema = z.object({
241
+ id: z.string(),
242
+ environmentId: z.string(),
243
+ createdAt: z.coerce.date(),
244
+ updatedAt: z.coerce.date()
245
+ });
246
+ const claudeSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
247
+ platform: z.literal("claudeai"),
248
+ formData: claudeSubmissionFormDataSchema
249
+ });
250
+ const chatgptSubmissionSchemaInternal = submissionMetaFieldsSchema.extend({
251
+ platform: z.literal("chatgpt"),
252
+ formData: chatgptSubmissionFormDataSchema
253
+ });
254
+ z.discriminatedUnion("platform", [claudeSubmissionSchemaInternal, chatgptSubmissionSchemaInternal]);
255
+ z.union([claudeSubmissionFormDataSchema, chatgptSubmissionFormDataSchema]);
256
+ const subscriptionPlanSchema = z.enum([
257
+ "pro",
258
+ "business",
259
+ "enterprise"
260
+ ]);
261
+ z.object({ plan: subscriptionPlanSchema.nullable() });
262
+ //#endregion
4
263
  //#region src/schemas.ts
5
264
  const RESERVED_KEYS = [
6
265
  "_HANDLER",
@@ -35,7 +294,8 @@ const RESERVED_KEYS = [
35
294
  "BUILD_ARG_BUILD_OUTPUT_DIR",
36
295
  "BUILD_ARG_START_COMMAND",
37
296
  "ALPIC_HOST",
38
- "ALPIC_CUSTOM_DOMAINS"
297
+ "ALPIC_CUSTOM_DOMAINS",
298
+ "ALPIC_INTENT_META_KEY"
39
299
  ];
40
300
  const environmentVariableSchema = z.object({
41
301
  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"),
@@ -43,6 +303,10 @@ const environmentVariableSchema = z.object({
43
303
  isSecret: z.boolean().default(false)
44
304
  });
45
305
  const environmentVariablesSchema = z.array(environmentVariableSchema);
306
+ const updateEnvironmentVariableSchema = environmentVariableSchema.partial({
307
+ value: true,
308
+ isSecret: true
309
+ });
46
310
  const buildSettingsSchema = z.object({
47
311
  installCommand: z.string().optional(),
48
312
  buildCommand: z.string().optional(),
@@ -60,68 +324,15 @@ const transportSchema = z.enum([
60
324
  "sse",
61
325
  "streamablehttp"
62
326
  ]);
63
- const analysisStatusSchema = z.enum([
64
- "pending",
65
- "partial",
66
- "completed",
67
- "failed"
68
- ]);
69
- const platformSchema = z.enum(["chatgpt", "claudeai"]);
70
- const checkSeveritySchema = z.enum([
71
- "error",
72
- "warning",
73
- "info"
74
- ]);
75
- const checkCategorySchema = z.enum([
76
- "connectivity",
77
- "tool-metadata",
78
- "resource-metadata",
79
- "performance",
80
- "e2e"
81
- ]);
82
- const checkScopeSchema = z.enum(["server", "view"]);
83
- const checkDetailSchema = z.object({
84
- label: z.string(),
85
- value: z.string().optional()
86
- });
87
- const checkResultSchema = z.object({
88
- checkId: z.string(),
89
- status: z.enum([
90
- "pass",
91
- "fail",
92
- "skip",
93
- "pending"
94
- ]),
95
- message: z.string(),
96
- skipReason: z.string().optional(),
97
- severity: checkSeveritySchema,
98
- category: checkCategorySchema,
99
- scope: checkScopeSchema,
100
- platforms: z.array(platformSchema).readonly().optional(),
101
- durationMs: z.number(),
102
- details: z.array(checkDetailSchema).optional(),
103
- hint: z.object({ text: z.string() }).optional()
327
+ const playgroundHeaderSchema = z.object({
328
+ name: z.string().min(1).max(100),
329
+ description: z.string().max(200),
330
+ isRequired: z.boolean().default(false),
331
+ isSecret: z.boolean().default(false)
104
332
  });
105
- const auditReportSchema = z.object({
106
- schemaVersion: z.string(),
107
- auditId: z.string(),
108
- targetUrl: z.string(),
109
- startedAt: z.string(),
110
- completedAt: z.string(),
111
- durationMs: z.number(),
112
- results: z.array(checkResultSchema),
113
- requiresAuth: z.boolean(),
114
- hasViewSupport: z.boolean(),
115
- viewPlatforms: z.array(platformSchema).readonly().optional(),
116
- isReadyForPlatform: z.record(platformSchema, z.boolean()),
117
- widgetScreenshotKeys: z.object({
118
- chatgpt: z.string().optional(),
119
- claudeai: z.string().optional()
120
- }).optional(),
121
- widgetScreenshots: z.object({
122
- chatgpt: z.object({ url: z.string() }).optional(),
123
- claudeai: z.object({ url: z.string() }).optional()
124
- }).optional()
333
+ const playgroundExamplePromptSchema = z.object({
334
+ title: z.string().min(1).max(100),
335
+ prompt: z.string().min(1).max(500)
125
336
  });
126
337
  const serverFieldsSchema = z.object({
127
338
  $schema: z.string(),
@@ -361,7 +572,7 @@ const updateEnvironmentVariableContractV1 = oc.route({
361
572
  environmentVariableId: z.string().describe("The ID of the environment variable"),
362
573
  key: environmentVariableSchema.shape.key,
363
574
  value: environmentVariableSchema.shape.value.optional(),
364
- isSecret: environmentVariableSchema.shape.isSecret
575
+ isSecret: environmentVariableSchema.shape.isSecret.optional()
365
576
  })).output(z.object({ success: z.literal(true) }));
366
577
  const deleteEnvironmentVariableContractV1 = oc.route({
367
578
  path: "/v1/environment-variables/{environmentVariableId}",
@@ -481,6 +692,41 @@ const getLogsContractV1 = oc.route({
481
692
  })),
482
693
  nextToken: z.string().nullable()
483
694
  }));
695
+ const getLatestLogsContractV1 = oc.route({
696
+ path: "/v1/environments/{environmentId}/latest-logs",
697
+ method: "GET",
698
+ summary: "Get latest logs",
699
+ description: "Get the N most recent logs for an environment",
700
+ tags: ["environments"],
701
+ successDescription: "The latest logs"
702
+ }).errors({
703
+ NOT_FOUND: {},
704
+ BAD_REQUEST: {}
705
+ }).input(z.object({
706
+ environmentId: z.string().describe("The ID of the environment"),
707
+ limit: z.coerce.number().int().min(1).max(1e3).default(100).describe("Number of most recent log entries to return"),
708
+ level: z.array(z.enum([
709
+ "INFO",
710
+ "ERROR",
711
+ "WARNING",
712
+ "DEBUG"
713
+ ])).optional().describe("Filter by log level"),
714
+ search: z.string().optional().describe("Filter pattern to search for in log content")
715
+ })).output(z.object({ logs: z.array(z.object({
716
+ timestamp: z.coerce.date(),
717
+ type: z.enum([
718
+ "START",
719
+ "END",
720
+ "INFO",
721
+ "ERROR",
722
+ "WARNING",
723
+ "DEBUG"
724
+ ]),
725
+ requestId: z.string(),
726
+ content: z.string().optional(),
727
+ method: z.string().optional(),
728
+ durationInMs: z.number().optional()
729
+ })) }));
484
730
  const getDeploymentLogsContractV1 = oc.route({
485
731
  path: "/v1/deployments/{deploymentId}/logs",
486
732
  method: "GET",
@@ -590,35 +836,77 @@ const getServerInfoContractV1 = oc.route({
590
836
  projectId: z.string(),
591
837
  domain: z.string()
592
838
  })).output(z.object({ serverFields: serverFieldsSchema }));
839
+ const playgroundServerMetadataOutputSchema = z.object({
840
+ name: z.string(),
841
+ description: z.string(),
842
+ headers: z.array(z.object({
843
+ name: z.string(),
844
+ description: z.string(),
845
+ isRequired: z.boolean(),
846
+ isSecret: z.boolean()
847
+ })),
848
+ examplePrompts: z.array(playgroundExamplePromptSchema)
849
+ });
850
+ const playgroundOutputSchema = z.object({
851
+ isPlaygroundEnabled: z.boolean(),
852
+ serverMetadata: playgroundServerMetadataOutputSchema.nullable()
853
+ });
854
+ const getPlaygroundContractV1 = oc.route({
855
+ path: "/v1/environments/{environmentId}/playground",
856
+ method: "GET",
857
+ summary: "Get playground configuration",
858
+ description: "Get the playground configuration for an environment",
859
+ tags: ["environments"],
860
+ successDescription: "The playground configuration"
861
+ }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(playgroundOutputSchema);
862
+ const upsertPlaygroundContractV1 = oc.route({
863
+ path: "/v1/environments/{environmentId}/playground",
864
+ method: "PUT",
865
+ summary: "Update playground configuration",
866
+ description: "Update the playground configuration for an environment. All fields are optional — only provided fields are updated.",
867
+ tags: ["environments"],
868
+ successDescription: "The updated playground configuration"
869
+ }).errors({
870
+ NOT_FOUND: {},
871
+ BAD_REQUEST: {}
872
+ }).input(z.object({
873
+ environmentId: z.string().describe("The ID of the environment"),
874
+ isPlaygroundEnabled: z.boolean().optional(),
875
+ name: z.string().min(1).max(100).optional(),
876
+ description: z.string().min(1).max(500).optional(),
877
+ headers: z.array(playgroundHeaderSchema).optional(),
878
+ examplePrompts: z.array(playgroundExamplePromptSchema).max(3).optional()
879
+ })).output(playgroundOutputSchema);
593
880
  const createBeaconContractV1 = oc.route({
594
- path: "/v1/beacon/analyses",
881
+ path: "/v1/beacon/audits",
595
882
  method: "POST",
596
- summary: "Create a beacon analysis",
597
- description: "Analyze an MCP server for spec compliance and AI client compatibility",
883
+ summary: "Create a beacon audit",
884
+ description: "Audit an MCP server for spec compliance and AI client compatibility",
598
885
  tags: ["beacon"],
599
- successDescription: "The analysis has been created"
886
+ successDescription: "The audit has been created"
600
887
  }).errors({
601
888
  NOT_FOUND: {},
602
889
  BAD_REQUEST: {}
603
890
  }).input(z.object({
604
- targetUrl: z.string().url().describe("The HTTPS URL of the MCP server to analyze"),
605
- teamId: z.string().optional().describe("The team ID to associate the analysis with"),
606
- projectId: z.string().optional().describe("The project ID to associate the analysis with")
891
+ targetUrl: z.url().describe("The HTTPS URL of the MCP server to audit"),
892
+ teamId: z.string().optional().describe("The team ID to associate the audit with"),
893
+ projectId: z.string().optional().describe("The project ID to associate the audit with"),
894
+ excludeCategories: z.array(checkCategorySchema).optional().describe("Check categories to exclude from the audit")
607
895
  })).output(z.object({ id: z.string() }));
608
896
  const getBeaconContractV1 = oc.route({
609
- path: "/v1/beacon/analyses/{analysisId}",
897
+ path: "/v1/beacon/audits/{auditId}",
610
898
  method: "GET",
611
- summary: "Get a beacon analysis",
612
- description: "Get a beacon analysis by ID, including the report if completed",
899
+ summary: "Get a beacon audit",
900
+ description: "Get a beacon audit by ID, including the report if completed",
613
901
  tags: ["beacon"],
614
- successDescription: "The analysis details"
615
- }).errors({ NOT_FOUND: {} }).input(z.object({ analysisId: z.string().describe("The ID of the analysis") })).output(z.object({
902
+ successDescription: "The audit details"
903
+ }).errors({ NOT_FOUND: {} }).input(z.object({ auditId: z.string().describe("The ID of the audit") })).output(z.object({
616
904
  id: z.string(),
617
905
  targetUrl: z.string(),
618
- status: analysisStatusSchema,
906
+ status: auditStatusSchema,
619
907
  durationMs: z.number().nullable(),
620
908
  createdAt: z.coerce.date(),
621
- report: auditReportSchema.nullable()
909
+ report: auditReportWithScreenshotsSchema.nullable()
622
910
  }));
623
911
  const contract = {
624
912
  teams: { list: { v1: listTeamsContractV1 } },
@@ -633,7 +921,8 @@ const contract = {
633
921
  create: { v1: createEnvironmentContractV1 },
634
922
  get: { v1: getEnvironmentContractV1 },
635
923
  deploy: { v1: deployEnvironmentContractV1 },
636
- getLogs: { v1: getLogsContractV1 }
924
+ getLogs: { v1: getLogsContractV1 },
925
+ getLatestLogs: { v1: getLatestLogsContractV1 }
637
926
  },
638
927
  environmentVariables: {
639
928
  list: { v1: listEnvironmentVariablesContractV1 },
@@ -648,6 +937,10 @@ const contract = {
648
937
  create: { v1: createProjectContractV1 },
649
938
  delete: { v1: deleteProjectContractV1 }
650
939
  },
940
+ playground: {
941
+ get: { v1: getPlaygroundContractV1 },
942
+ upsert: { v1: upsertPlaygroundContractV1 }
943
+ },
651
944
  tunnels: { getTicket: { v1: getTunnelTicketContractV1 } },
652
945
  distribution: {
653
946
  publish: { v1: publishServerContractV1 },
@@ -659,4 +952,4 @@ const contract = {
659
952
  }
660
953
  };
661
954
  //#endregion
662
- export { analysisStatusSchema, auditReportSchema, buildSettingsSchema, checkDetailSchema, checkResultSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, platformSchema, runtimeSchema, serverFieldsSchema, transportSchema };
955
+ export { PLATFORM_LABELS, buildSettingsSchema, contract, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alpic-ai/api",
3
- "version": "0.0.0-staging.cdbdcc3",
3
+ "version": "0.0.0-staging.ce7992f",
4
4
  "description": "Contract for the Alpic API",
5
5
  "type": "module",
6
6
  "main": "./dist/index.mjs",
@@ -14,20 +14,32 @@
14
14
  "files": [
15
15
  "dist"
16
16
  ],
17
+ "nx": {
18
+ "targets": {
19
+ "build": {
20
+ "dependsOn": [
21
+ "^build"
22
+ ]
23
+ }
24
+ }
25
+ },
17
26
  "author": "Alpic",
18
27
  "license": "ISC",
19
28
  "dependencies": {
20
- "@orpc/contract": "^1.13.8",
29
+ "@orpc/contract": "^1.14.3",
21
30
  "ms": "^2.1.3",
22
- "zod": "^4.3.6"
31
+ "zod": "^4.4.3"
23
32
  },
24
33
  "devDependencies": {
34
+ "@orpc/openapi": "^1.14.3",
35
+ "@orpc/zod": "^1.14.3",
25
36
  "@total-typescript/tsconfig": "^1.0.4",
26
37
  "@types/ms": "^2.1.0",
27
38
  "shx": "^0.4.0",
28
- "tsdown": "^0.21.4",
29
- "typescript": "^5.9.3",
30
- "vitest": "^4.1.0"
39
+ "tsdown": "^0.22.0",
40
+ "typescript": "^6.0.3",
41
+ "vitest": "^4.1.6",
42
+ "@alpic-ai/domains": "0.0.0"
31
43
  },
32
44
  "scripts": {
33
45
  "build": "shx rm -rf dist && tsdown",