@alpic-ai/api 0.0.0-dev.gf7dfd6e → 0.0.0-dev.gf7e6015

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 +1284 -871
  2. package/dist/index.mjs +150 -28
  3. package/package.json +6 -6
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.30.0_supports-color@7.2.0_zod@4.5.4/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/auth.js
5
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_supports-color@8.1.1_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
  */
@@ -119,7 +119,12 @@ z$1.object({
119
119
  token_type: z$1.string(),
120
120
  expires_in: z$1.coerce.number().optional(),
121
121
  scope: z$1.string().optional(),
122
- refresh_token: z$1.string().optional()
122
+ refresh_token: z$1.string().optional(),
123
+ /**
124
+ * Not part of the wire format: the authorization server this value was obtained from, added by
125
+ * the client's `auth()` before it is stored and compared when it is read back.
126
+ */
127
+ issuer: z$1.string().optional().catch(void 0)
123
128
  }).strip();
124
129
  z$1.object({
125
130
  error: z$1.string(),
@@ -158,7 +163,12 @@ const OAuthClientInformationSchema = z$1.object({
158
163
  client_id: z$1.string(),
159
164
  client_secret: z$1.string().optional(),
160
165
  client_id_issued_at: z$1.number().optional(),
161
- client_secret_expires_at: z$1.number().optional()
166
+ client_secret_expires_at: z$1.number().optional(),
167
+ /**
168
+ * Not part of the wire format: the authorization server this value was obtained from, added by
169
+ * the client's `auth()` before it is stored and compared when it is read back.
170
+ */
171
+ issuer: z$1.string().optional().catch(void 0)
162
172
  }).strip();
163
173
  OAuthClientMetadataSchema.merge(OAuthClientInformationSchema);
164
174
  z$1.object({
@@ -336,7 +346,8 @@ const standaloneEnvironmentSchema = z.object({
336
346
  const protectedWithoutDiscoveryEnvironmentSchema = z.object({
337
347
  allowsAnonymous: z.literal(false),
338
348
  oAuthMetadata: z.strictObject({}),
339
- scope: z.string().optional()
349
+ scope: z.string().optional(),
350
+ wwwAuthenticate: z.string().optional()
340
351
  });
341
352
  const legacyPublicEnvironmentSchema = z.object({
342
353
  isPublic: z.literal(true),
@@ -381,10 +392,13 @@ z.union([
381
392
  legacyProtectedWithoutDiscoveryEnvironmentSchema
382
393
  ]);
383
394
  const playgroundModelSchema = z.enum([
395
+ "global.anthropic.claude-haiku-5-5",
384
396
  "global.anthropic.claude-haiku-4-5-20251001-v1:0",
385
- "global.anthropic.claude-sonnet-4-5-20250929-v1:0",
397
+ "global.anthropic.claude-sonnet-5-5",
386
398
  "openai.gpt-5.4",
387
- "openai.gpt-5.5"
399
+ "openai.gpt-5.5",
400
+ "openai.gpt-6-luna",
401
+ "openai.gpt-6.1-sol"
388
402
  ]);
389
403
  const environmentDomainSchema = z.object({
390
404
  name: z.string(),
@@ -581,6 +595,12 @@ const MCP_CLIENT_GROUPS = [
581
595
  vendor: "anthropic",
582
596
  rawNames: ["Anthropic/Cowork"]
583
597
  },
598
+ {
599
+ id: "claude_sheet_add_in",
600
+ label: "Claude (Sheet Add-In)",
601
+ vendor: "anthropic",
602
+ rawNames: ["sheet-add-in"]
603
+ },
584
604
  {
585
605
  id: "claude_toolbox",
586
606
  label: "Claude Toolbox",
@@ -615,7 +635,7 @@ const MCP_CLIENT_GROUPS = [
615
635
  id: "chatgpt",
616
636
  label: "ChatGPT",
617
637
  vendor: "openai",
618
- rawNames: ["openai-mcp (ChatGPT)"]
638
+ rawNames: ["openai-mcp", "openai-mcp (ChatGPT)"]
619
639
  },
620
640
  {
621
641
  id: "openai_responses_api",
@@ -629,12 +649,6 @@ const MCP_CLIENT_GROUPS = [
629
649
  vendor: "openai",
630
650
  rawNames: ["openai-mcp (Agent Builder)"]
631
651
  },
632
- {
633
- id: "openai_other",
634
- label: "OpenAI Other",
635
- vendor: "openai",
636
- rawNames: ["openai-mcp"]
637
- },
638
652
  {
639
653
  id: "cursor",
640
654
  label: "Cursor",
@@ -1219,7 +1233,7 @@ const chatgptTranslationLocaleSchema = z.enum([
1219
1233
  const negativeTestCaseSchema = z.object({
1220
1234
  scenario: z.string().min(1),
1221
1235
  userPrompt: z.string().min(1)
1222
- }).describe("Each case: Scenario + User prompt (the app should NOT trigger).");
1236
+ }).describe("Each case: Scenario + User prompt (the plugin should NOT trigger).");
1223
1237
  const negativeTestCaseDraftSchema = negativeTestCaseSchema.partial().extend({
1224
1238
  scenario: z.string().optional(),
1225
1239
  userPrompt: z.string().optional()
@@ -1248,28 +1262,28 @@ chatgptTranslationSchema.extend({ tagline: clampStringField(chatgptTaglineSchema
1248
1262
  const chatgptSubmissionFormDataSchema = z.object({
1249
1263
  logoLight: z.string().describe("Logo icon for light mode. Square PNG, no borders or rounded corners (clients apply circular cropping)."),
1250
1264
  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."),
1251
- appName: z.string().describe("The name users will see in ChatGPT and in the Apps Directory."),
1265
+ appName: z.string().describe("The name users will see in ChatGPT and in the Plugin Directory."),
1252
1266
  tagline: chatgptTaglineSchema.describe("Plain-language phrase focused on function and user value, 30 chars max. Avoid generic superlatives like \"the best …\"."),
1253
- 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)."),
1267
+ description: chatgptDescriptionSchema.describe("Clear, engaging description highlighting what the plugin does and why people will love it. Appears publicly on the directory page. End it by naming the product categories or intents the plugin 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)."),
1254
1268
  category: chatgptCategorySchema.describe("Category from the OpenAI taxonomy."),
1255
- developerName: z.string().describe("Developer name shown publicly on the app's directory page."),
1269
+ developerName: z.string().describe("Developer name shown publicly on the plugin's directory page."),
1256
1270
  companyUrl: urlField.describe("Your company's main website URL."),
1257
1271
  supportChannel: supportChannelSchema.describe("Customer support URL or email address."),
1258
1272
  privacyPolicyUrl: urlField.describe("URL to your privacy policy."),
1259
- termsOfServiceUrl: urlField.describe("URL to the app's terms of service."),
1260
- 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."),
1261
- 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."),
1273
+ termsOfServiceUrl: urlField.describe("URL to the plugin's terms of service."),
1274
+ demoRecordingUrl: urlField.describe("URL to a video demonstrating the plugin, recorded via OpenAI Developer Mode. Cover all main use cases on web, iOS, and Android."),
1275
+ appCommerceAndPurchasing: z.boolean().describe("Checkbox: 'My plugin links or directs users out of ChatGPT to make purchases.' Defaults to false. Verify the plugin does not offer digital goods."),
1262
1276
  serverUrl: urlField.describe("URL of the MCP server."),
1263
1277
  authentication: chatgptAuthenticationSchema.describe("OAuth 2.0 or No auth. OAuth configuration is auto-discovered from the MCP server's metadata."),
1264
1278
  tools: z.array(toolDefinitionSchema).describe("List of tools exposed by the MCP server (auto-populated from the production server's manifest)."),
1265
1279
  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."),
1266
1280
  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."),
1267
1281
  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."),
1268
- 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."),
1269
- 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."),
1282
+ negativeTestCases: z.array(negativeTestCaseSchema).length(3).describe("Exactly 3 negative test cases: prompts where the plugin 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 plugin does not carry, the right brand or domain but an intent the plugin does not serve, or a boundary with a sibling plugin."),
1283
+ screenshots: z.array(screenshotEntrySchema.extend({ prompt: z.string().max(75, { error: "Screenshot prompts are limited to 75 characters." }) })).max(3).describe("In-plugin screenshots paired with the user prompt that produced them (each prompt is 75 characters max). Widget plugins must show the widget UI; non-widget plugins show the model response. Min 1, max 3 entries, all public. Images: 706px wide, 400–860px tall, PNG."),
1270
1284
  translations: z.array(chatgptTranslationSchema).describe("Per-locale translation of tagline + description. English (US) is the default."),
1271
1285
  allowedCountries: chatgptAllowedCountriesSchema.describe("Availability: all supported countries, or an allow-list / block-list of specific ones (ISO alpha-2)."),
1272
- releaseNotes: z.string().describe("Publicly displayed on the app details page.")
1286
+ releaseNotes: z.string().describe("Publicly displayed on the plugin details page.")
1273
1287
  });
1274
1288
  const chatgptSubmissionDraftSchema = chatgptSubmissionFormDataSchema.partial().extend({
1275
1289
  tagline: z.string().optional(),
@@ -1556,6 +1570,7 @@ const metricsQueueEventSchema = z.object({
1556
1570
  tool: z.string().nullable(),
1557
1571
  client: z.string(),
1558
1572
  sessionId: z.string().nullable(),
1573
+ conversationId: z.string().nullable().optional(),
1559
1574
  durationMs: z.number().int(),
1560
1575
  outputTokens: z.number().int().nullable(),
1561
1576
  errorType: z.enum([
@@ -1571,12 +1586,14 @@ z.object({
1571
1586
  events: z.array(metricsQueueEventSchema)
1572
1587
  });
1573
1588
  z.object({ v: z.number() });
1574
- const telemetrySignalSchema = z.enum([
1589
+ const TELEMETRY_SIGNALS = [
1575
1590
  "logs",
1576
1591
  "metrics",
1577
1592
  "traces"
1578
- ]);
1579
- const otlpProtocolSchema = z.enum(["http/protobuf", "http/json"]);
1593
+ ];
1594
+ const telemetrySignalSchema = z.enum(TELEMETRY_SIGNALS);
1595
+ const OTLP_PROTOCOLS = ["http/protobuf", "http/json"];
1596
+ const otlpProtocolSchema = z.enum(OTLP_PROTOCOLS);
1580
1597
  const otlpEndpointSchema = z.string().trim().min(1).max(2048);
1581
1598
  const OTLP_HEADER_VALUE_MAX_LENGTH = 2048;
1582
1599
  const otlpHeaderNameSchema = z.string().trim().min(1, "Enter a header name").max(128).regex(/^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$/, "Use letters, digits and !#$%&'*+-.^_`|~ only");
@@ -1607,8 +1624,13 @@ z.object({
1607
1624
  protocol: otlpProtocolSchema,
1608
1625
  headers: z.array(telemetryDestinationHeaderSchema),
1609
1626
  status: telemetryDestinationStatusSchema,
1610
- lastFailureReason: otlpPushFailureReasonSchema.nullable()
1627
+ lastFailureReason: otlpPushFailureReasonSchema.nullable(),
1628
+ isScopedToIntentionalRequestsOnly: z.boolean()
1611
1629
  });
1630
+ const hasDuplicateHeaderNames = (headers) => {
1631
+ const names = headers.map(({ name }) => name.trim().toLowerCase());
1632
+ return new Set(names).size !== names.length;
1633
+ };
1612
1634
  //#endregion
1613
1635
  //#region src/auth-scope.ts
1614
1636
  /** Accepts an API key or OAuth access token (default for most routes). */
@@ -1899,6 +1921,100 @@ const environmentVariableOutputSchema = z.object({
1899
1921
  isSecret: z.boolean(),
1900
1922
  createdAt: z.coerce.date()
1901
1923
  });
1924
+ const telemetryDestinationHeaderOutputSchema = z.discriminatedUnion("isSecret", [z.object({
1925
+ id: z.string(),
1926
+ name: otlpHeaderNameSchema,
1927
+ value: z.null(),
1928
+ isSecret: z.literal(true)
1929
+ }), z.object({
1930
+ id: z.string(),
1931
+ name: otlpHeaderNameSchema,
1932
+ value: otlpHeaderValueSchema,
1933
+ isSecret: z.literal(false)
1934
+ })]);
1935
+ const telemetryDestinationOutputSchema = z.object({
1936
+ id: z.string(),
1937
+ signal: telemetrySignalSchema,
1938
+ endpoint: otlpEndpointSchema,
1939
+ protocol: otlpProtocolSchema,
1940
+ headers: z.array(telemetryDestinationHeaderOutputSchema),
1941
+ status: telemetryDestinationStatusSchema,
1942
+ lastFailureReason: otlpPushFailureReasonSchema.nullable(),
1943
+ isScopedToIntentionalRequestsOnly: z.boolean()
1944
+ });
1945
+ const createTelemetryDestinationHeaderInputSchema = z.object({
1946
+ name: otlpHeaderNameSchema,
1947
+ value: otlpHeaderValueSchema.min(1, "Enter a header value"),
1948
+ isSecret: z.boolean()
1949
+ });
1950
+ const updateTelemetryDestinationHeaderInputSchema = z.object({
1951
+ id: z.string().optional(),
1952
+ name: otlpHeaderNameSchema,
1953
+ value: otlpHeaderValueSchema.optional(),
1954
+ isSecret: z.boolean()
1955
+ });
1956
+ const uniqueTelemetryHeaders = (headers) => !hasDuplicateHeaderNames(headers);
1957
+ const listTelemetryDestinationsContractV1 = base.route({
1958
+ path: "/v1/environments/{environmentId}/telemetry-destinations",
1959
+ method: "GET",
1960
+ summary: "List telemetry destinations",
1961
+ description: "List the OTLP destinations configured for an environment. Secret header values are never returned.",
1962
+ tags: ["telemetry"],
1963
+ successDescription: "The list of telemetry destinations"
1964
+ }).errors({ NOT_FOUND: {} }).input(z.object({ environmentId: z.string().describe("The ID of the environment") })).output(z.array(telemetryDestinationOutputSchema));
1965
+ const createTelemetryDestinationContractV1 = base.route({
1966
+ path: "/v1/environments/{environmentId}/telemetry-destinations",
1967
+ method: "POST",
1968
+ summary: "Create a telemetry destination",
1969
+ description: "Verify and save an OTLP destination for logs, metrics, or traces.",
1970
+ tags: ["telemetry"],
1971
+ successDescription: "The telemetry destination has been created"
1972
+ }).errors({
1973
+ NOT_FOUND: {},
1974
+ FORBIDDEN: {},
1975
+ OTLP_DESTINATION_UNVERIFIED: { status: 400 },
1976
+ INTERNAL_SERVER_ERROR: {}
1977
+ }).input(z.object({
1978
+ environmentId: z.string().describe("The ID of the environment"),
1979
+ signal: telemetrySignalSchema,
1980
+ endpoint: otlpEndpointSchema,
1981
+ protocol: otlpProtocolSchema.default("http/protobuf"),
1982
+ isScopedToIntentionalRequestsOnly: z.boolean().default(false),
1983
+ headers: z.array(createTelemetryDestinationHeaderInputSchema).default([]).refine(uniqueTelemetryHeaders, "Header names must be unique")
1984
+ })).output(telemetryDestinationOutputSchema);
1985
+ const updateTelemetryDestinationContractV1 = base.route({
1986
+ path: "/v1/environments/{environmentId}/telemetry-destinations/{destinationId}",
1987
+ method: "PATCH",
1988
+ summary: "Update a telemetry destination",
1989
+ description: "Verify and save changes to an OTLP destination. Omit headers to keep them unchanged; omit the value of an existing header to preserve it. A secret header value must be re-entered when the endpoint changes.",
1990
+ tags: ["telemetry"],
1991
+ successDescription: "The telemetry destination has been updated"
1992
+ }).errors({
1993
+ NOT_FOUND: {},
1994
+ FORBIDDEN: {},
1995
+ OTLP_DESTINATION_UNVERIFIED: { status: 400 }
1996
+ }).input(z.object({
1997
+ environmentId: z.string().describe("The ID of the environment"),
1998
+ destinationId: z.string().describe("The ID of the telemetry destination"),
1999
+ endpoint: otlpEndpointSchema.optional(),
2000
+ protocol: otlpProtocolSchema.optional(),
2001
+ isScopedToIntentionalRequestsOnly: z.boolean().optional(),
2002
+ headers: z.array(updateTelemetryDestinationHeaderInputSchema).refine(uniqueTelemetryHeaders, "Header names must be unique").optional()
2003
+ })).output(telemetryDestinationOutputSchema);
2004
+ const deleteTelemetryDestinationContractV1 = base.route({
2005
+ path: "/v1/environments/{environmentId}/telemetry-destinations/{destinationId}",
2006
+ method: "DELETE",
2007
+ summary: "Delete a telemetry destination",
2008
+ description: "Delete an OTLP destination from an environment.",
2009
+ tags: ["telemetry"],
2010
+ successDescription: "The telemetry destination has been deleted"
2011
+ }).errors({
2012
+ NOT_FOUND: {},
2013
+ INTERNAL_SERVER_ERROR: {}
2014
+ }).input(z.object({
2015
+ environmentId: z.string().describe("The ID of the environment"),
2016
+ destinationId: z.string().describe("The ID of the telemetry destination")
2017
+ })).output(z.object({ success: z.literal(true) }));
1902
2018
  const listEnvironmentVariablesContractV1 = base.route({
1903
2019
  path: "/v1/environments/{environmentId}/environment-variables",
1904
2020
  method: "GET",
@@ -2462,6 +2578,12 @@ const contract = {
2462
2578
  update: { v1: updateEnvironmentVariableContractV1 },
2463
2579
  delete: { v1: deleteEnvironmentVariableContractV1 }
2464
2580
  },
2581
+ telemetryDestinations: {
2582
+ list: { v1: listTelemetryDestinationsContractV1 },
2583
+ create: { v1: createTelemetryDestinationContractV1 },
2584
+ update: { v1: updateTelemetryDestinationContractV1 },
2585
+ delete: { v1: deleteTelemetryDestinationContractV1 }
2586
+ },
2465
2587
  projects: {
2466
2588
  update: { v1: updateProjectContractV1 },
2467
2589
  get: { v1: getProjectContractV1 },
@@ -2516,4 +2638,4 @@ const OPENAPI_DOC_OPTIONS = {
2516
2638
  }
2517
2639
  };
2518
2640
  //#endregion
2519
- export { AI_PLATFORMS, AUTH_SCOPE_ANY, AUTH_SCOPE_USER, INTENT_CATEGORY_COLORS, OPENAPI_DOC_OPTIONS, PLATFORM_LABELS, buildSettingsSchema, chatgptSubmissionUpdateSchema, claudeSubmissionUpdateSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, intentCategoryColorSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, transportSchema, updateEnvironmentVariableSchema };
2641
+ export { AI_PLATFORMS, AUTH_SCOPE_ANY, AUTH_SCOPE_USER, INTENT_CATEGORY_COLORS, OPENAPI_DOC_OPTIONS, OTLP_PROTOCOLS, PLATFORM_LABELS, TELEMETRY_SIGNALS, buildSettingsSchema, chatgptSubmissionUpdateSchema, claudeSubmissionUpdateSchema, contract, contractForDocs, createEnvironmentContractV1, deploymentStatusSchema, environmentVariableSchema, environmentVariablesSchema, intentCategoryColorSchema, otlpProtocolSchema, playgroundExamplePromptSchema, playgroundHeaderSchema, runtimeSchema, serverFieldsSchema, telemetrySignalSchema, transportSchema, updateEnvironmentVariableSchema };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alpic-ai/api",
3
- "version": "0.0.0-dev.gf7dfd6e",
3
+ "version": "0.0.0-dev.gf7e6015",
4
4
  "description": "Contract for the Alpic API",
5
5
  "type": "module",
6
6
  "main": "./dist/index.mjs",
@@ -33,20 +33,20 @@
33
33
  "author": "Alpic",
34
34
  "license": "ISC",
35
35
  "dependencies": {
36
- "@orpc/contract": "^1.15.2",
36
+ "@orpc/contract": "^1.15.7",
37
37
  "ms": "^2.1.3",
38
38
  "zod": "^4.5.4"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@alpic-ai/domains": "0.0.0",
42
- "@orpc/openapi": "^1.15.2",
43
- "@orpc/zod": "^1.15.2",
42
+ "@orpc/openapi": "^1.15.7",
43
+ "@orpc/zod": "^1.15.7",
44
44
  "@total-typescript/tsconfig": "^1.0.4",
45
45
  "@types/ms": "^2.1.0",
46
46
  "shx": "^0.4.0",
47
- "tsdown": "^0.23.0",
47
+ "tsdown": "^0.23.1",
48
48
  "typescript": "^6.0.3",
49
- "vitest": "^5.0.1"
49
+ "vitest": "^5.0.5"
50
50
  },
51
51
  "scripts": {
52
52
  "build": "shx rm -rf dist && tsdown",