@vertesia/common 1.6.0-dev.20261014.015055Z → 1.6.0-dev.20261019.172735Z

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 (116) hide show
  1. package/lib/api-contract/components.generated.json +1203 -24
  2. package/lib/api-schemas/agent-runs.d.ts +50 -0
  3. package/lib/api-schemas/agent-runs.d.ts.map +1 -1
  4. package/lib/api-schemas/agent-runs.js +3 -3
  5. package/lib/api-schemas/agent-runs.js.map +1 -1
  6. package/lib/api-schemas/app-lifecycle.d.ts +126 -0
  7. package/lib/api-schemas/app-lifecycle.d.ts.map +1 -1
  8. package/lib/api-schemas/app-lifecycle.js +134 -1
  9. package/lib/api-schemas/app-lifecycle.js.map +1 -1
  10. package/lib/api-schemas/app-runtime.d.ts +466 -0
  11. package/lib/api-schemas/app-runtime.d.ts.map +1 -1
  12. package/lib/api-schemas/app-runtime.js +50 -1
  13. package/lib/api-schemas/app-runtime.js.map +1 -1
  14. package/lib/api-schemas/apps.d.ts +73 -0
  15. package/lib/api-schemas/apps.d.ts.map +1 -1
  16. package/lib/api-schemas/apps.js +41 -0
  17. package/lib/api-schemas/apps.js.map +1 -1
  18. package/lib/api-schemas/audit-trail.d.ts.map +1 -1
  19. package/lib/api-schemas/audit-trail.js +5 -5
  20. package/lib/api-schemas/audit-trail.js.map +1 -1
  21. package/lib/api-schemas/content.d.ts +25 -0
  22. package/lib/api-schemas/content.d.ts.map +1 -1
  23. package/lib/api-schemas/content.js +5 -5
  24. package/lib/api-schemas/content.js.map +1 -1
  25. package/lib/api-schemas/document-processing.d.ts +15 -0
  26. package/lib/api-schemas/document-processing.d.ts.map +1 -1
  27. package/lib/api-schemas/events.d.ts +45 -0
  28. package/lib/api-schemas/events.d.ts.map +1 -1
  29. package/lib/api-schemas/inference-profile.d.ts +30 -0
  30. package/lib/api-schemas/inference-profile.d.ts.map +1 -1
  31. package/lib/api-schemas/interaction.d.ts +395 -0
  32. package/lib/api-schemas/interaction.d.ts.map +1 -1
  33. package/lib/api-schemas/interaction.js +9 -7
  34. package/lib/api-schemas/interaction.js.map +1 -1
  35. package/lib/api-schemas/oauth-server.d.ts +128 -0
  36. package/lib/api-schemas/oauth-server.d.ts.map +1 -1
  37. package/lib/api-schemas/oauth-server.js +95 -2
  38. package/lib/api-schemas/oauth-server.js.map +1 -1
  39. package/lib/api-schemas/process.d.ts +11 -0
  40. package/lib/api-schemas/process.d.ts.map +1 -1
  41. package/lib/api-schemas/process.js +12 -0
  42. package/lib/api-schemas/process.js.map +1 -1
  43. package/lib/api-schemas/project-configuration.d.ts +50 -0
  44. package/lib/api-schemas/project-configuration.d.ts.map +1 -1
  45. package/lib/api-schemas/project.d.ts +75 -0
  46. package/lib/api-schemas/project.d.ts.map +1 -1
  47. package/lib/api-schemas/prompt.d.ts.map +1 -1
  48. package/lib/api-schemas/prompt.js +5 -2
  49. package/lib/api-schemas/prompt.js.map +1 -1
  50. package/lib/api-schemas/registry.d.ts +1266 -0
  51. package/lib/api-schemas/registry.d.ts.map +1 -1
  52. package/lib/api-schemas/registry.js +33 -3
  53. package/lib/api-schemas/registry.js.map +1 -1
  54. package/lib/api-schemas/schema-primitives.d.ts +8 -0
  55. package/lib/api-schemas/schema-primitives.d.ts.map +1 -1
  56. package/lib/api-schemas/schema-primitives.js +8 -0
  57. package/lib/api-schemas/schema-primitives.js.map +1 -1
  58. package/lib/api-schemas/store.d.ts +250 -0
  59. package/lib/api-schemas/store.d.ts.map +1 -1
  60. package/lib/api-schemas/store.js +3 -3
  61. package/lib/api-schemas/store.js.map +1 -1
  62. package/lib/api-schemas/task.d.ts.map +1 -1
  63. package/lib/api-schemas/task.js +3 -2
  64. package/lib/api-schemas/task.js.map +1 -1
  65. package/lib/api-schemas/workflow-runs.d.ts +10 -0
  66. package/lib/api-schemas/workflow-runs.d.ts.map +1 -1
  67. package/lib/apikey.d.ts +7 -0
  68. package/lib/apikey.d.ts.map +1 -1
  69. package/lib/apikey.js.map +1 -1
  70. package/lib/apps.d.ts +37 -1
  71. package/lib/apps.d.ts.map +1 -1
  72. package/lib/apps.js +74 -3
  73. package/lib/apps.js.map +1 -1
  74. package/lib/interaction.d.ts.map +1 -1
  75. package/lib/interaction.js.map +1 -1
  76. package/lib/oauth-server.d.ts +5 -0
  77. package/lib/oauth-server.d.ts.map +1 -1
  78. package/lib/store/index.d.ts +1 -0
  79. package/lib/store/index.d.ts.map +1 -1
  80. package/lib/store/index.js +1 -0
  81. package/lib/store/index.js.map +1 -1
  82. package/lib/store/intake-policy-schema.generated.d.ts.map +1 -1
  83. package/lib/store/intake-policy-schema.generated.js +1 -2
  84. package/lib/store/intake-policy-schema.generated.js.map +1 -1
  85. package/lib/store/text-limits.d.ts +18 -0
  86. package/lib/store/text-limits.d.ts.map +1 -0
  87. package/lib/store/text-limits.js +56 -0
  88. package/lib/store/text-limits.js.map +1 -0
  89. package/lib/vertesia-common.js +4 -2
  90. package/lib/vertesia-common.js.map +1 -1
  91. package/lib/wire-types.generated.d.ts +246 -2
  92. package/lib/wire-types.generated.d.ts.map +1 -1
  93. package/package.json +3 -3
  94. package/src/api-contract/components.generated.json +1203 -24
  95. package/src/api-schemas/agent-runs.ts +3 -3
  96. package/src/api-schemas/app-lifecycle.ts +163 -1
  97. package/src/api-schemas/app-runtime.ts +54 -0
  98. package/src/api-schemas/apps.ts +46 -0
  99. package/src/api-schemas/audit-trail.ts +5 -5
  100. package/src/api-schemas/content.ts +5 -5
  101. package/src/api-schemas/interaction.ts +9 -7
  102. package/src/api-schemas/oauth-server.ts +103 -2
  103. package/src/api-schemas/process.ts +13 -0
  104. package/src/api-schemas/prompt.ts +5 -2
  105. package/src/api-schemas/registry.ts +52 -0
  106. package/src/api-schemas/schema-primitives.ts +9 -0
  107. package/src/api-schemas/store.ts +3 -3
  108. package/src/api-schemas/task.ts +3 -2
  109. package/src/apikey.ts +8 -0
  110. package/src/apps.ts +116 -3
  111. package/src/interaction.ts +1 -0
  112. package/src/oauth-server.ts +10 -0
  113. package/src/store/index.ts +1 -0
  114. package/src/store/intake-policy-schema.generated.ts +1 -2
  115. package/src/store/text-limits.ts +64 -0
  116. package/src/wire-types.generated.ts +266 -2
@@ -0,0 +1,64 @@
1
+ /** Maximum UTF-8 size persisted for extracted document text. */
2
+ export const MAX_EXTRACTED_TEXT_BYTES = 10 * 1024 * 1024;
3
+
4
+ /**
5
+ * Request-body allowance for the JSON envelope carrying extracted text and its source etag.
6
+ * This is transport headroom, not a larger stored-text limit.
7
+ */
8
+ export const SET_OBJECT_TEXT_BODY_LIMIT_BYTES = 16 * 1024 * 1024;
9
+
10
+ export const EXTRACTED_TEXT_TRUNCATION_MARKER = '\n\n[... truncated at max text limit 10 MiB ...]';
11
+
12
+ export interface ExtractedTextLimitResult {
13
+ text: string;
14
+ truncated: boolean;
15
+ }
16
+
17
+ /**
18
+ * Retain the largest Unicode-safe prefix that fits together with the truncation marker.
19
+ * The marker is part of the byte budget, so persisted text never exceeds the declared limit.
20
+ */
21
+ export function truncateExtractedText(text: string): ExtractedTextLimitResult {
22
+ if (utf8PrefixEnd(text, MAX_EXTRACTED_TEXT_BYTES) === text.length) {
23
+ return { text, truncated: false };
24
+ }
25
+
26
+ const markerBytes = utf8ByteLength(EXTRACTED_TEXT_TRUNCATION_MARKER);
27
+ const prefixEnd = utf8PrefixEnd(text, MAX_EXTRACTED_TEXT_BYTES - markerBytes);
28
+ return {
29
+ text: text.slice(0, prefixEnd) + EXTRACTED_TEXT_TRUNCATION_MARKER,
30
+ truncated: true,
31
+ };
32
+ }
33
+
34
+ function utf8ByteLength(text: string): number {
35
+ let bytes = 0;
36
+ for (let index = 0; index < text.length; ) {
37
+ const codePoint = text.codePointAt(index) ?? 0;
38
+ bytes += utf8CodePointBytes(codePoint);
39
+ index += codePoint > 0xffff ? 2 : 1;
40
+ }
41
+ return bytes;
42
+ }
43
+
44
+ function utf8PrefixEnd(text: string, maxBytes: number): number {
45
+ let bytes = 0;
46
+ let index = 0;
47
+ while (index < text.length) {
48
+ const codePoint = text.codePointAt(index) ?? 0;
49
+ const codePointBytes = utf8CodePointBytes(codePoint);
50
+ if (bytes + codePointBytes > maxBytes) {
51
+ break;
52
+ }
53
+ bytes += codePointBytes;
54
+ index += codePoint > 0xffff ? 2 : 1;
55
+ }
56
+ return index;
57
+ }
58
+
59
+ function utf8CodePointBytes(codePoint: number): number {
60
+ if (codePoint <= 0x7f) return 1;
61
+ if (codePoint <= 0x7ff) return 2;
62
+ if (codePoint <= 0xffff) return 3;
63
+ return 4;
64
+ }
@@ -17,6 +17,7 @@ import type {
17
17
  JSONSchema,
18
18
  JSONValue,
19
19
  JsonResult,
20
+ // biome-ignore lint/suspicious/noDeprecatedImports: Legacy output_modality contracts require Modalities.
20
21
  Modalities,
21
22
  ModelOptions,
22
23
  ModelSearchPayload,
@@ -575,6 +576,9 @@ export type AppUIConfig = {
575
576
  navigation?: AppUINavItem[] | undefined;
576
577
  available_in?: AppAvailableIn[] | undefined;
577
578
  };
579
+ export type AppOAuthClientConfig = {
580
+ redirect_uris: string[];
581
+ };
578
582
  export type AppInstallationProjectsQuery = {
579
583
  name?: string | undefined;
580
584
  id?: string | undefined;
@@ -609,6 +613,8 @@ export type MCPToolCollectionObject = {
609
613
  url: string;
610
614
  auth?: ToolCollectionAuthType | undefined;
611
615
  type: 'mcp';
616
+ parameters?: Record<string, McpConnectionParameter> | undefined;
617
+ headers?: Record<string, string> | undefined;
612
618
  id: string;
613
619
  name: string;
614
620
  description: string;
@@ -846,6 +852,7 @@ export type AppBuildProgress = {
846
852
  updated_at: string;
847
853
  };
848
854
  export type AppScaffoldModule = 'service' | 'assistant' | 'content-app' | 'examples';
855
+ export type AppScaffoldSourceMode = 'generate' | 'existing';
849
856
  export type StartAppScaffoldRequest = {
850
857
  app_id: string;
851
858
  title?: string | undefined;
@@ -854,6 +861,10 @@ export type StartAppScaffoldRequest = {
854
861
  oauth_scopes?: string[] | undefined;
855
862
  appgen_package_spec?: string | undefined;
856
863
  create_version?: boolean | undefined;
864
+ source_mode?: AppScaffoldSourceMode | undefined;
865
+ source?: AppSourceConfig | undefined;
866
+ github_connection_id?: string | undefined;
867
+ github_repository_creation?: AppGithubRepositoryCreation | undefined;
857
868
  };
858
869
  export type StartAppScaffoldResponse = {
859
870
  workflow_id: string;
@@ -863,6 +874,69 @@ export type StartAppScaffoldResponse = {
863
874
  git_url?: string | undefined;
864
875
  create_version: boolean;
865
876
  };
877
+ export type AppGithubConfiguration = {
878
+ enabled: boolean;
879
+ app_slug?: string | undefined;
880
+ install_url?: string | undefined;
881
+ relay_url?: string | undefined;
882
+ };
883
+ export type StartAppGithubAuthorizationResponse = {
884
+ authorization_url: string;
885
+ };
886
+ export type ExchangeAppGithubAuthorizationRequest = {
887
+ code: string;
888
+ state: string;
889
+ };
890
+ export type AppGithubRepositoriesQuery = {
891
+ connection_id: string;
892
+ installation_id: string;
893
+ };
894
+ export type AppGithubInstallation = {
895
+ id: string;
896
+ account_login: string;
897
+ account_type?: string | undefined;
898
+ repository_selection: 'all' | 'selected';
899
+ };
900
+ export type AppGithubAccount = {
901
+ login: string;
902
+ account_type: string;
903
+ avatar_url?: string | undefined;
904
+ };
905
+ export type ExchangeAppGithubAuthorizationResponse = {
906
+ connection_id: string;
907
+ installations: AppGithubInstallation[];
908
+ accounts: AppGithubAccount[];
909
+ };
910
+ export type AppGithubRepository = {
911
+ name: string;
912
+ full_name: string;
913
+ private: boolean;
914
+ default_branch: string;
915
+ html_url: string;
916
+ };
917
+ export type AppGithubRepositoryCreation = {
918
+ name: string;
919
+ private?: boolean | undefined;
920
+ };
921
+ export type AppGithubRepositoryList = {
922
+ repositories: AppGithubRepository[];
923
+ };
924
+ export type AppGithubRepositorySetupQuery = {
925
+ connection_id: string;
926
+ installation_id: string;
927
+ repository: string;
928
+ branch: string;
929
+ };
930
+ export type AppGithubBranchState = {
931
+ name: string;
932
+ exists: boolean;
933
+ empty: boolean;
934
+ };
935
+ export type AppGithubRepositorySetup = {
936
+ default_branch: string;
937
+ branches: string[];
938
+ selected_branch: AppGithubBranchState;
939
+ };
866
940
  export type StartAppDevelopmentTaskRequest = {
867
941
  prompt: string;
868
942
  environment: string;
@@ -905,7 +979,9 @@ export type AppScaffoldProgress = {
905
979
  */
906
980
  export type AppAccessControl = 'all' | 'ui' | 'none';
907
981
  export type AppManifestData = {
982
+ parameters?: Record<string, McpConnectionParameter> | undefined;
908
983
  oauth_scopes?: string[] | undefined;
984
+ oauth_client?: AppOAuthClientConfig | undefined;
909
985
  name: string;
910
986
  visibility: 'public' | 'private' | 'vertesia';
911
987
  title: string;
@@ -934,7 +1010,9 @@ export type AppManifestData = {
934
1010
  access_control?: AppAccessControl | undefined;
935
1011
  };
936
1012
  export type UpdateAppPayload = {
1013
+ parameters?: Record<string, McpConnectionParameter> | undefined;
937
1014
  oauth_scopes?: string[] | undefined;
1015
+ oauth_client?: AppOAuthClientConfig | undefined;
938
1016
  name: string;
939
1017
  visibility: 'public' | 'private' | 'vertesia';
940
1018
  title: string;
@@ -964,11 +1042,15 @@ export type UpdateAppPayload = {
964
1042
  expected_edit_revision?: number | undefined;
965
1043
  };
966
1044
  export type AppGitSourceConfig = {
1045
+ provider?: AppGitSourceProvider | undefined;
967
1046
  url?: string | undefined;
1047
+ installation_id?: string | undefined;
1048
+ repository?: string | undefined;
968
1049
  default_branch?: string | undefined;
969
1050
  production_branch?: string | undefined;
970
1051
  development_branch?: string | undefined;
971
1052
  };
1053
+ export type AppGitSourceProvider = 'vertesia' | 'github';
972
1054
  export type AppSourceConfig = {
973
1055
  kind: 'git';
974
1056
  git?: AppGitSourceConfig | undefined;
@@ -1108,6 +1190,7 @@ export type AppEventSubscriptionDefinition = {
1108
1190
  priority?: EventPriority | undefined;
1109
1191
  };
1110
1192
  export type AppPackage = {
1193
+ oauth_client?: AppOAuthClientConfig | undefined;
1111
1194
  oauth_scopes?: string[] | undefined;
1112
1195
  ui?: AppUIConfig | undefined;
1113
1196
  tools?: AgentToolDefinition[] | undefined;
@@ -1189,7 +1272,9 @@ export type RenderingTemplateDefinitionRef = {
1189
1272
  tags?: string[] | undefined;
1190
1273
  };
1191
1274
  export type AppManifest = {
1275
+ parameters?: Record<string, McpConnectionParameter> | undefined;
1192
1276
  oauth_scopes?: string[] | undefined;
1277
+ oauth_client?: AppOAuthClientConfig | undefined;
1193
1278
  edit_revision: number;
1194
1279
  name: string;
1195
1280
  visibility: 'public' | 'private' | 'vertesia';
@@ -1225,7 +1310,10 @@ export type AppManifest = {
1225
1310
  export type AppManifestSource = {
1226
1311
  kind: 'git';
1227
1312
  git: {
1313
+ provider?: AppGitSourceProvider | undefined;
1228
1314
  url: string;
1315
+ installation_id?: string | undefined;
1316
+ repository?: string | undefined;
1229
1317
  default_branch?: string | undefined;
1230
1318
  production_branch?: string | undefined;
1231
1319
  development_branch?: string | undefined;
@@ -1254,7 +1342,22 @@ export type AppInstallationProviderBinding = {
1254
1342
  export type AppInstallation = {
1255
1343
  id: string;
1256
1344
  project: string;
1345
+ instance_key?: string | undefined;
1346
+ display_name?: string | undefined;
1347
+ installation_version?: 1 | undefined;
1348
+ namespace_overrides?: Record<string, string> | undefined;
1349
+ reserved_namespaces?: string[] | undefined;
1350
+ namespace_conflicts?: string[] | undefined;
1257
1351
  manifest: string;
1352
+ mcp_configuration?:
1353
+ | {
1354
+ revision: string;
1355
+ values: Record<string, Record<string, string>>;
1356
+ configured_secrets: Record<string, string[]>;
1357
+ shared_values?: Record<string, string> | undefined;
1358
+ configured_shared_secrets?: string[] | undefined;
1359
+ }
1360
+ | undefined;
1258
1361
  oauth_approval?:
1259
1362
  | {
1260
1363
  scopes: string[];
@@ -1262,6 +1365,7 @@ export type AppInstallation = {
1262
1365
  approved_at: string;
1263
1366
  }
1264
1367
  | undefined;
1368
+ oauth_client_id?: string | undefined;
1265
1369
  settings?:
1266
1370
  | {
1267
1371
  [k: string]: unknown;
@@ -1277,6 +1381,21 @@ export type AppInstallation = {
1277
1381
  export type AppInstallationWithManifest = {
1278
1382
  id: string;
1279
1383
  project: string;
1384
+ instance_key?: string | undefined;
1385
+ display_name?: string | undefined;
1386
+ installation_version?: 1 | undefined;
1387
+ namespace_overrides?: Record<string, string> | undefined;
1388
+ reserved_namespaces?: string[] | undefined;
1389
+ namespace_conflicts?: string[] | undefined;
1390
+ mcp_configuration?:
1391
+ | {
1392
+ revision: string;
1393
+ values: Record<string, Record<string, string>>;
1394
+ configured_secrets: Record<string, string[]>;
1395
+ shared_values?: Record<string, string> | undefined;
1396
+ configured_shared_secrets?: string[] | undefined;
1397
+ }
1398
+ | undefined;
1280
1399
  oauth_approval?:
1281
1400
  | {
1282
1401
  scopes: string[];
@@ -1284,6 +1403,7 @@ export type AppInstallationWithManifest = {
1284
1403
  approved_at: string;
1285
1404
  }
1286
1405
  | undefined;
1406
+ oauth_client_id?: string | undefined;
1287
1407
  settings?:
1288
1408
  | {
1289
1409
  [k: string]: unknown;
@@ -1301,6 +1421,21 @@ export type AppInstallationWithManifest = {
1301
1421
  export type AppInstallationListEntry = {
1302
1422
  id: string;
1303
1423
  project: string;
1424
+ instance_key?: string | undefined;
1425
+ display_name?: string | undefined;
1426
+ installation_version?: 1 | undefined;
1427
+ namespace_overrides?: Record<string, string> | undefined;
1428
+ reserved_namespaces?: string[] | undefined;
1429
+ namespace_conflicts?: string[] | undefined;
1430
+ mcp_configuration?:
1431
+ | {
1432
+ revision: string;
1433
+ values: Record<string, Record<string, string>>;
1434
+ configured_secrets: Record<string, string[]>;
1435
+ shared_values?: Record<string, string> | undefined;
1436
+ configured_shared_secrets?: string[] | undefined;
1437
+ }
1438
+ | undefined;
1304
1439
  oauth_approval?:
1305
1440
  | {
1306
1441
  scopes: string[];
@@ -1308,6 +1443,7 @@ export type AppInstallationListEntry = {
1308
1443
  approved_at: string;
1309
1444
  }
1310
1445
  | undefined;
1446
+ oauth_client_id?: string | undefined;
1311
1447
  settings?:
1312
1448
  | {
1313
1449
  [k: string]: unknown;
@@ -1341,6 +1477,11 @@ export type AppApiKeyCollectionParams = {
1341
1477
  export type AppOAuthProviderParams = AppOAuthCollectionParams;
1342
1478
  export type AppInstallationPayload = {
1343
1479
  app_id: string;
1480
+ instance_key?: string | undefined;
1481
+ display_name?: string | undefined;
1482
+ namespace_overrides?: Record<string, string> | undefined;
1483
+ mcp_shared_parameters?: Record<string, string | null> | undefined;
1484
+ mcp_parameters?: Record<string, Record<string, string | null>> | undefined;
1344
1485
  settings?:
1345
1486
  | {
1346
1487
  [k: string]: unknown;
@@ -1360,6 +1501,7 @@ export type AppInstallationKind = 'ui' | 'tools' | 'all';
1360
1501
  */
1361
1502
  export type AppToolCollection = {
1362
1503
  name: string;
1504
+ collection_id?: string | undefined;
1363
1505
  description?: string | undefined;
1364
1506
  tools: AgentToolDefinition[];
1365
1507
  };
@@ -1626,6 +1768,23 @@ export type AppDeleteSummary = {
1626
1768
  export type UpdateAppInstallationOAuthApprovalPayload = {
1627
1769
  approved_scopes: string[];
1628
1770
  };
1771
+ export type AppInstanceAvailability = {
1772
+ enabled: boolean;
1773
+ };
1774
+ export type McpPublicParameter = {
1775
+ title?: string | undefined;
1776
+ description?: string | undefined;
1777
+ required?: boolean | undefined;
1778
+ type?: 'string' | undefined;
1779
+ default?: string | undefined;
1780
+ };
1781
+ export type McpSecretParameter = {
1782
+ title?: string | undefined;
1783
+ description?: string | undefined;
1784
+ required?: boolean | undefined;
1785
+ type: 'secret';
1786
+ };
1787
+ export type McpConnectionParameter = McpPublicParameter | McpSecretParameter;
1629
1788
  /**
1630
1789
  * Generic metering entry attached to audit events.
1631
1790
  * Used for cost attribution, usage tracking, and billing.
@@ -4613,8 +4772,12 @@ export type OAuthClientType = 'public' | 'confidential';
4613
4772
  export type OAuthClientStatus = 'active' | 'disabled';
4614
4773
  export type OAuthRegistrationSource = 'admin' | 'dynamic';
4615
4774
  export type OAuthProjectBindingMode = 'user_select' | 'fixed';
4616
- export type OAuthTokenEndpointAuthMethod = 'none' | 'client_secret_post' | 'client_secret_basic';
4617
- export type OAuthGrantType = 'authorization_code' | 'refresh_token' | 'urn:ietf:params:oauth:grant-type:device_code';
4775
+ export type OAuthTokenEndpointAuthMethod = 'none' | 'client_secret_post' | 'client_secret_basic' | 'private_key_jwt';
4776
+ export type OAuthGrantType =
4777
+ | 'authorization_code'
4778
+ | 'refresh_token'
4779
+ | 'urn:ietf:params:oauth:grant-type:device_code'
4780
+ | 'urn:ietf:params:oauth:grant-type:token-exchange';
4618
4781
  export type OAuthResponseType = 'code';
4619
4782
  export type OAuthAuthorizationRequestStatus = 'pending' | 'denied' | 'consumed';
4620
4783
  export type OAuthClientRegistrationMode = 'registered' | 'client_id_metadata_document';
@@ -4630,12 +4793,14 @@ export type OAuthGrantSortField =
4630
4793
  export type OAuthGrantSortOrder = 'asc' | 'desc';
4631
4794
  /** An OAuth client's registration, without the id the server issues for it. */
4632
4795
  export type OAuthClientData = {
4796
+ app_id?: string | undefined;
4633
4797
  client_name: string;
4634
4798
  client_type: OAuthClientType;
4635
4799
  redirect_uris: string[];
4636
4800
  grant_types: OAuthGrantType[];
4637
4801
  response_types: OAuthResponseType[];
4638
4802
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4803
+ jwks_uri?: string | undefined;
4639
4804
  allowed_scopes: string[];
4640
4805
  default_scopes?: string[] | undefined;
4641
4806
  registration_source: OAuthRegistrationSource;
@@ -4654,12 +4819,14 @@ export type OAuthClientData = {
4654
4819
  updated_at: string;
4655
4820
  };
4656
4821
  export type OAuthClient = {
4822
+ app_id?: string | undefined;
4657
4823
  client_name: string;
4658
4824
  client_type: OAuthClientType;
4659
4825
  redirect_uris: string[];
4660
4826
  grant_types: OAuthGrantType[];
4661
4827
  response_types: OAuthResponseType[];
4662
4828
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4829
+ jwks_uri?: string | undefined;
4663
4830
  allowed_scopes: string[];
4664
4831
  default_scopes?: string[] | undefined;
4665
4832
  registration_source: OAuthRegistrationSource;
@@ -4680,12 +4847,14 @@ export type OAuthClient = {
4680
4847
  };
4681
4848
  /** The read shape plus the client secret, which is returned by the create call and never again. */
4682
4849
  export type OAuthClientCreateResponse = {
4850
+ app_id?: string | undefined;
4683
4851
  client_name: string;
4684
4852
  client_type: OAuthClientType;
4685
4853
  redirect_uris: string[];
4686
4854
  grant_types: OAuthGrantType[];
4687
4855
  response_types: OAuthResponseType[];
4688
4856
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4857
+ jwks_uri?: string | undefined;
4689
4858
  allowed_scopes: string[];
4690
4859
  default_scopes?: string[] | undefined;
4691
4860
  registration_source: OAuthRegistrationSource;
@@ -4773,6 +4942,7 @@ export type CreateOAuthClientPayload = {
4773
4942
  grant_types?: OAuthGrantType[] | undefined;
4774
4943
  response_types?: OAuthResponseType[] | undefined;
4775
4944
  token_endpoint_auth_method?: OAuthTokenEndpointAuthMethod | undefined;
4945
+ jwks_uri?: string | undefined;
4776
4946
  allowed_scopes?: string[] | undefined;
4777
4947
  default_scopes?: string[] | undefined;
4778
4948
  project_binding_mode?: OAuthProjectBindingMode | undefined;
@@ -4791,9 +4961,11 @@ export type UpdateOAuthClientPayload = {
4791
4961
  grant_types?: OAuthGrantType[] | undefined;
4792
4962
  response_types?: OAuthResponseType[] | undefined;
4793
4963
  token_endpoint_auth_method?: OAuthTokenEndpointAuthMethod | undefined;
4964
+ jwks_uri?: string | undefined;
4794
4965
  allowed_scopes?: string[] | undefined;
4795
4966
  default_scopes?: string[] | undefined;
4796
4967
  status?: OAuthClientStatus | undefined;
4968
+ revoke_previous_client_secret?: boolean | undefined;
4797
4969
  project_binding_mode?: OAuthProjectBindingMode | undefined;
4798
4970
  fixed_project_id?: string | undefined;
4799
4971
  restrict_to_owner_account?: boolean | undefined;
@@ -4815,6 +4987,7 @@ export type OAuthAuthorizationServerMetadata = {
4815
4987
  grant_types_supported: string[];
4816
4988
  code_challenge_methods_supported: string[];
4817
4989
  token_endpoint_auth_methods_supported: string[];
4990
+ token_endpoint_auth_signing_alg_values_supported?: string[] | undefined;
4818
4991
  scopes_supported: string[];
4819
4992
  client_id_metadata_document_supported?: boolean | undefined;
4820
4993
  authorization_response_iss_parameter_supported?: boolean | undefined;
@@ -4855,6 +5028,7 @@ export type OAuthAuthorizationRequest = {
4855
5028
  user_code?: string | undefined;
4856
5029
  client_id: string;
4857
5030
  client_name: string;
5031
+ app_id?: string | undefined;
4858
5032
  client_metadata?: OAuthClientDisplayMetadata | undefined;
4859
5033
  client_registration_mode?: OAuthClientRegistrationMode | undefined;
4860
5034
  redirect_uri: string;
@@ -4928,6 +5102,73 @@ export type OAuthLoginUserNotFoundResponse = {
4928
5102
  error: 'user_not_found';
4929
5103
  ensure_user_url: string;
4930
5104
  };
5105
+ export type OidcFederationConnectionPayload = {
5106
+ name: string;
5107
+ issuer: string;
5108
+ jwks_uri?: string | undefined;
5109
+ external_id_claim: string;
5110
+ allowed_audiences: string[];
5111
+ allowed_algorithms: ('RS256' | 'ES256')[];
5112
+ subject_token_type:
5113
+ | 'urn:ietf:params:oauth:token-type:jwt'
5114
+ | 'urn:ietf:params:oauth:token-type:id_token'
5115
+ | 'urn:ietf:params:oauth:token-type:access_token';
5116
+ required_claims?: Record<string, string> | undefined;
5117
+ all_projects?: boolean | undefined;
5118
+ allowed_project_ids: string[];
5119
+ allowed_client_ids?: string[] | undefined;
5120
+ allowed_scopes?: string[] | undefined;
5121
+ max_token_ttl_seconds: number;
5122
+ max_subject_token_age_seconds?: number | undefined;
5123
+ enabled: boolean;
5124
+ };
5125
+ export type OidcFederationConnection = {
5126
+ name: string;
5127
+ issuer: string;
5128
+ jwks_uri?: string | undefined;
5129
+ external_id_claim: string;
5130
+ allowed_audiences: string[];
5131
+ allowed_algorithms: ('RS256' | 'ES256')[];
5132
+ subject_token_type:
5133
+ | 'urn:ietf:params:oauth:token-type:jwt'
5134
+ | 'urn:ietf:params:oauth:token-type:id_token'
5135
+ | 'urn:ietf:params:oauth:token-type:access_token';
5136
+ required_claims?: Record<string, string> | undefined;
5137
+ all_projects?: boolean | undefined;
5138
+ allowed_project_ids: string[];
5139
+ allowed_client_ids?: string[] | undefined;
5140
+ allowed_scopes?: string[] | undefined;
5141
+ max_token_ttl_seconds: number;
5142
+ max_subject_token_age_seconds: number;
5143
+ enabled: boolean;
5144
+ id: string;
5145
+ account_id: string;
5146
+ };
5147
+ export type OidcFederationConnectionArray = OidcFederationConnection[];
5148
+ export type OAuthTokenExchangeRequest = {
5149
+ grant_type: 'urn:ietf:params:oauth:grant-type:token-exchange';
5150
+ subject_token: string;
5151
+ subject_token_type:
5152
+ | 'urn:ietf:params:oauth:token-type:jwt'
5153
+ | 'urn:ietf:params:oauth:token-type:id_token'
5154
+ | 'urn:ietf:params:oauth:token-type:access_token';
5155
+ requested_token_type?: 'urn:ietf:params:oauth:token-type:access_token' | undefined;
5156
+ federation_connection_id: string;
5157
+ client_id?: string | undefined;
5158
+ client_secret?: string | undefined;
5159
+ client_assertion?: string | undefined;
5160
+ client_assertion_type?: 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer' | undefined;
5161
+ project_id: string;
5162
+ resource: string;
5163
+ scope?: string | undefined;
5164
+ };
5165
+ export type OAuthTokenExchangeResponse = {
5166
+ access_token: string;
5167
+ token_type: 'Bearer';
5168
+ expires_in: number;
5169
+ scope?: string | undefined;
5170
+ issued_token_type: 'urn:ietf:params:oauth:token-type:access_token';
5171
+ };
4931
5172
  /**
4932
5173
  * OAuth Provider data stored in MongoDB.
4933
5174
  * Represents the configuration for an OAuth 2.0 provider at the project level.
@@ -7349,6 +7590,7 @@ export type PublishProcessDefinitionPayload = {
7349
7590
  tags?: string[] | undefined;
7350
7591
  label?: string | undefined;
7351
7592
  comment?: string | undefined;
7593
+ idempotency_key?: string | undefined;
7352
7594
  };
7353
7595
  export type RevertProcessDefinitionPayload = {
7354
7596
  confirmed: boolean;
@@ -10748,6 +10990,7 @@ export interface ApiComponentTypes {
10748
10990
  AppCapabilities: AppCapabilities;
10749
10991
  AppAccessControl: AppAccessControl;
10750
10992
  AppSourceConfig: AppSourceConfig;
10993
+ AppGitSourceProvider: AppGitSourceProvider;
10751
10994
  AppManifestSource: AppManifestSource;
10752
10995
  SuccessResponse: SuccessResponse;
10753
10996
  OAuthProvider: OAuthProvider;
@@ -10785,6 +11028,11 @@ export interface ApiComponentTypes {
10785
11028
  OAuthDeviceAuthorizationRequest: OAuthDeviceAuthorizationRequest;
10786
11029
  OAuthDeviceAuthorizationResponse: OAuthDeviceAuthorizationResponse;
10787
11030
  OAuthTokenResponse: OAuthTokenResponse;
11031
+ OidcFederationConnectionPayload: OidcFederationConnectionPayload;
11032
+ OidcFederationConnection: OidcFederationConnection;
11033
+ OidcFederationConnectionArray: OidcFederationConnectionArray;
11034
+ OAuthTokenExchangeRequest: OAuthTokenExchangeRequest;
11035
+ OAuthTokenExchangeResponse: OAuthTokenExchangeResponse;
10788
11036
  OAuthClient: OAuthClient;
10789
11037
  OAuthClientArray: OAuthClientArray;
10790
11038
  OAuthClientCreateResponse: OAuthClientCreateResponse;
@@ -11743,6 +11991,20 @@ export interface ApiComponentTypes {
11743
11991
  AppRepoBranch: AppRepoBranch;
11744
11992
  AppRepoDocumentCommit: AppRepoDocumentCommit;
11745
11993
  AppVersionGitSource: AppVersionGitSource;
11994
+ AppGithubConfiguration: AppGithubConfiguration;
11995
+ StartAppGithubAuthorizationResponse: StartAppGithubAuthorizationResponse;
11996
+ ExchangeAppGithubAuthorizationRequest: ExchangeAppGithubAuthorizationRequest;
11997
+ AppGithubRepositoriesQuery: AppGithubRepositoriesQuery;
11998
+ ExchangeAppGithubAuthorizationResponse: ExchangeAppGithubAuthorizationResponse;
11999
+ AppGithubInstallation: AppGithubInstallation;
12000
+ AppGithubAccount: AppGithubAccount;
12001
+ AppGithubRepository: AppGithubRepository;
12002
+ AppGithubRepositoryCreation: AppGithubRepositoryCreation;
12003
+ AppGithubRepositoryList: AppGithubRepositoryList;
12004
+ AppGithubRepositorySetupQuery: AppGithubRepositorySetupQuery;
12005
+ AppGithubBranchState: AppGithubBranchState;
12006
+ AppGithubRepositorySetup: AppGithubRepositorySetup;
12007
+ AppScaffoldSourceMode: AppScaffoldSourceMode;
11746
12008
  StartAppScaffoldRequest: StartAppScaffoldRequest;
11747
12009
  StartAppDevelopmentTaskRequest: StartAppDevelopmentTaskRequest;
11748
12010
  StartAppBuildRequest: StartAppBuildRequest;
@@ -11767,6 +12029,7 @@ export interface ApiComponentTypes {
11767
12029
  AgentRunSearchHit: AgentRunSearchHit;
11768
12030
  UpsertAppVersionRequest: UpsertAppVersionRequest;
11769
12031
  AppInstallationPayload: AppInstallationPayload;
12032
+ AppInstanceAvailability: AppInstanceAvailability;
11770
12033
  AppDevelopmentTaskDetails: AppDevelopmentTaskDetails;
11771
12034
  AppVersionRecordArray: AppVersionRecordArray;
11772
12035
  AppToolCollectionArray: AppToolCollectionArray;
@@ -11845,6 +12108,7 @@ export interface ApiComponentTypes {
11845
12108
  MCPOAuthConfigMap: MCPOAuthConfigMap;
11846
12109
  AppWidgetInfo: AppWidgetInfo;
11847
12110
  AppDashboardDefinition: AppDashboardDefinition;
12111
+ AppOAuthClientConfig: AppOAuthClientConfig;
11848
12112
  AppManifestData: AppManifestData;
11849
12113
  UpdateAppPayload: UpdateAppPayload;
11850
12114
  AppManifest: AppManifest;