@vertesia/common 1.6.0-dev.20261009.095813Z → 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 (133) hide show
  1. package/lib/api-contract/components.generated.json +1329 -37
  2. package/lib/api-schemas/agent-runs.d.ts +410 -0
  3. package/lib/api-schemas/agent-runs.d.ts.map +1 -1
  4. package/lib/api-schemas/agent-runs.js +10 -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 +948 -6
  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 +199 -0
  22. package/lib/api-schemas/content.d.ts.map +1 -1
  23. package/lib/api-schemas/content.js +19 -5
  24. package/lib/api-schemas/content.js.map +1 -1
  25. package/lib/api-schemas/data-store.d.ts +30 -0
  26. package/lib/api-schemas/data-store.d.ts.map +1 -1
  27. package/lib/api-schemas/data-store.js +8 -0
  28. package/lib/api-schemas/data-store.js.map +1 -1
  29. package/lib/api-schemas/document-processing.d.ts +117 -0
  30. package/lib/api-schemas/document-processing.d.ts.map +1 -1
  31. package/lib/api-schemas/events.d.ts +351 -0
  32. package/lib/api-schemas/events.d.ts.map +1 -1
  33. package/lib/api-schemas/indexing.d.ts +1 -0
  34. package/lib/api-schemas/indexing.d.ts.map +1 -1
  35. package/lib/api-schemas/indexing.js +9 -0
  36. package/lib/api-schemas/indexing.js.map +1 -1
  37. package/lib/api-schemas/inference-profile.d.ts +234 -0
  38. package/lib/api-schemas/inference-profile.d.ts.map +1 -1
  39. package/lib/api-schemas/interaction.d.ts +3013 -0
  40. package/lib/api-schemas/interaction.d.ts.map +1 -1
  41. package/lib/api-schemas/interaction.js +9 -7
  42. package/lib/api-schemas/interaction.js.map +1 -1
  43. package/lib/api-schemas/oauth-server.d.ts +128 -0
  44. package/lib/api-schemas/oauth-server.d.ts.map +1 -1
  45. package/lib/api-schemas/oauth-server.js +95 -2
  46. package/lib/api-schemas/oauth-server.js.map +1 -1
  47. package/lib/api-schemas/process.d.ts +81 -0
  48. package/lib/api-schemas/process.d.ts.map +1 -1
  49. package/lib/api-schemas/process.js +29 -0
  50. package/lib/api-schemas/process.js.map +1 -1
  51. package/lib/api-schemas/project-configuration.d.ts +390 -0
  52. package/lib/api-schemas/project-configuration.d.ts.map +1 -1
  53. package/lib/api-schemas/project.d.ts +591 -6
  54. package/lib/api-schemas/project.d.ts.map +1 -1
  55. package/lib/api-schemas/prompt.d.ts.map +1 -1
  56. package/lib/api-schemas/prompt.js +5 -2
  57. package/lib/api-schemas/prompt.js.map +1 -1
  58. package/lib/api-schemas/registry.d.ts +23032 -461
  59. package/lib/api-schemas/registry.d.ts.map +1 -1
  60. package/lib/api-schemas/registry.js +38 -3
  61. package/lib/api-schemas/registry.js.map +1 -1
  62. package/lib/api-schemas/schema-primitives.d.ts +8 -0
  63. package/lib/api-schemas/schema-primitives.d.ts.map +1 -1
  64. package/lib/api-schemas/schema-primitives.js +8 -0
  65. package/lib/api-schemas/schema-primitives.js.map +1 -1
  66. package/lib/api-schemas/store.d.ts +1950 -0
  67. package/lib/api-schemas/store.d.ts.map +1 -1
  68. package/lib/api-schemas/store.js +3 -3
  69. package/lib/api-schemas/store.js.map +1 -1
  70. package/lib/api-schemas/task.d.ts.map +1 -1
  71. package/lib/api-schemas/task.js +3 -2
  72. package/lib/api-schemas/task.js.map +1 -1
  73. package/lib/api-schemas/workflow-runs.d.ts +78 -0
  74. package/lib/api-schemas/workflow-runs.d.ts.map +1 -1
  75. package/lib/apikey.d.ts +7 -0
  76. package/lib/apikey.d.ts.map +1 -1
  77. package/lib/apikey.js.map +1 -1
  78. package/lib/apps.d.ts +37 -1
  79. package/lib/apps.d.ts.map +1 -1
  80. package/lib/apps.js +74 -3
  81. package/lib/apps.js.map +1 -1
  82. package/lib/interaction.d.ts.map +1 -1
  83. package/lib/interaction.js.map +1 -1
  84. package/lib/oauth-server.d.ts +5 -0
  85. package/lib/oauth-server.d.ts.map +1 -1
  86. package/lib/store/index.d.ts +1 -0
  87. package/lib/store/index.d.ts.map +1 -1
  88. package/lib/store/index.js +1 -0
  89. package/lib/store/index.js.map +1 -1
  90. package/lib/store/intake-policy-schema.generated.d.ts.map +1 -1
  91. package/lib/store/intake-policy-schema.generated.js +20 -2
  92. package/lib/store/intake-policy-schema.generated.js.map +1 -1
  93. package/lib/store/store.d.ts +1 -0
  94. package/lib/store/store.d.ts.map +1 -1
  95. package/lib/store/store.js.map +1 -1
  96. package/lib/store/text-limits.d.ts +18 -0
  97. package/lib/store/text-limits.d.ts.map +1 -0
  98. package/lib/store/text-limits.js +56 -0
  99. package/lib/store/text-limits.js.map +1 -0
  100. package/lib/vertesia-common.js +4 -2
  101. package/lib/vertesia-common.js.map +1 -1
  102. package/lib/wire-types.generated.d.ts +261 -3
  103. package/lib/wire-types.generated.d.ts.map +1 -1
  104. package/lib/workflow-analytics.d.ts +19 -1
  105. package/lib/workflow-analytics.d.ts.map +1 -1
  106. package/package.json +6 -6
  107. package/src/api-contract/components.generated.json +1329 -37
  108. package/src/api-schemas/agent-runs.ts +10 -3
  109. package/src/api-schemas/app-lifecycle.ts +163 -1
  110. package/src/api-schemas/app-runtime.ts +54 -0
  111. package/src/api-schemas/apps.ts +46 -0
  112. package/src/api-schemas/audit-trail.ts +5 -5
  113. package/src/api-schemas/content.ts +21 -5
  114. package/src/api-schemas/data-store.ts +8 -0
  115. package/src/api-schemas/indexing.ts +10 -0
  116. package/src/api-schemas/interaction.ts +9 -7
  117. package/src/api-schemas/oauth-server.ts +103 -2
  118. package/src/api-schemas/process.ts +32 -0
  119. package/src/api-schemas/prompt.ts +5 -2
  120. package/src/api-schemas/registry.ts +59 -6
  121. package/src/api-schemas/schema-primitives.ts +9 -0
  122. package/src/api-schemas/store.ts +3 -3
  123. package/src/api-schemas/task.ts +3 -2
  124. package/src/apikey.ts +8 -0
  125. package/src/apps.ts +116 -3
  126. package/src/interaction.ts +1 -0
  127. package/src/oauth-server.ts +10 -0
  128. package/src/store/index.ts +1 -0
  129. package/src/store/intake-policy-schema.generated.ts +20 -2
  130. package/src/store/store.ts +2 -0
  131. package/src/store/text-limits.ts +64 -0
  132. package/src/wire-types.generated.ts +285 -3
  133. package/src/workflow-analytics.ts +21 -1
@@ -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.
@@ -2542,6 +2701,14 @@ export type AlterTableOperation =
2542
2701
  op: 'modify_column';
2543
2702
  column: string;
2544
2703
  updates: DataColumnUpdate;
2704
+ }
2705
+ | {
2706
+ op: 'add_foreign_key';
2707
+ foreign_key: DataForeignKey;
2708
+ }
2709
+ | {
2710
+ op: 'drop_foreign_key';
2711
+ column: string;
2545
2712
  };
2546
2713
  /**
2547
2714
  * Payload for altering a table schema.
@@ -4605,8 +4772,12 @@ export type OAuthClientType = 'public' | 'confidential';
4605
4772
  export type OAuthClientStatus = 'active' | 'disabled';
4606
4773
  export type OAuthRegistrationSource = 'admin' | 'dynamic';
4607
4774
  export type OAuthProjectBindingMode = 'user_select' | 'fixed';
4608
- export type OAuthTokenEndpointAuthMethod = 'none' | 'client_secret_post' | 'client_secret_basic';
4609
- 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';
4610
4781
  export type OAuthResponseType = 'code';
4611
4782
  export type OAuthAuthorizationRequestStatus = 'pending' | 'denied' | 'consumed';
4612
4783
  export type OAuthClientRegistrationMode = 'registered' | 'client_id_metadata_document';
@@ -4622,12 +4793,14 @@ export type OAuthGrantSortField =
4622
4793
  export type OAuthGrantSortOrder = 'asc' | 'desc';
4623
4794
  /** An OAuth client's registration, without the id the server issues for it. */
4624
4795
  export type OAuthClientData = {
4796
+ app_id?: string | undefined;
4625
4797
  client_name: string;
4626
4798
  client_type: OAuthClientType;
4627
4799
  redirect_uris: string[];
4628
4800
  grant_types: OAuthGrantType[];
4629
4801
  response_types: OAuthResponseType[];
4630
4802
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4803
+ jwks_uri?: string | undefined;
4631
4804
  allowed_scopes: string[];
4632
4805
  default_scopes?: string[] | undefined;
4633
4806
  registration_source: OAuthRegistrationSource;
@@ -4646,12 +4819,14 @@ export type OAuthClientData = {
4646
4819
  updated_at: string;
4647
4820
  };
4648
4821
  export type OAuthClient = {
4822
+ app_id?: string | undefined;
4649
4823
  client_name: string;
4650
4824
  client_type: OAuthClientType;
4651
4825
  redirect_uris: string[];
4652
4826
  grant_types: OAuthGrantType[];
4653
4827
  response_types: OAuthResponseType[];
4654
4828
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4829
+ jwks_uri?: string | undefined;
4655
4830
  allowed_scopes: string[];
4656
4831
  default_scopes?: string[] | undefined;
4657
4832
  registration_source: OAuthRegistrationSource;
@@ -4672,12 +4847,14 @@ export type OAuthClient = {
4672
4847
  };
4673
4848
  /** The read shape plus the client secret, which is returned by the create call and never again. */
4674
4849
  export type OAuthClientCreateResponse = {
4850
+ app_id?: string | undefined;
4675
4851
  client_name: string;
4676
4852
  client_type: OAuthClientType;
4677
4853
  redirect_uris: string[];
4678
4854
  grant_types: OAuthGrantType[];
4679
4855
  response_types: OAuthResponseType[];
4680
4856
  token_endpoint_auth_method: OAuthTokenEndpointAuthMethod;
4857
+ jwks_uri?: string | undefined;
4681
4858
  allowed_scopes: string[];
4682
4859
  default_scopes?: string[] | undefined;
4683
4860
  registration_source: OAuthRegistrationSource;
@@ -4765,6 +4942,7 @@ export type CreateOAuthClientPayload = {
4765
4942
  grant_types?: OAuthGrantType[] | undefined;
4766
4943
  response_types?: OAuthResponseType[] | undefined;
4767
4944
  token_endpoint_auth_method?: OAuthTokenEndpointAuthMethod | undefined;
4945
+ jwks_uri?: string | undefined;
4768
4946
  allowed_scopes?: string[] | undefined;
4769
4947
  default_scopes?: string[] | undefined;
4770
4948
  project_binding_mode?: OAuthProjectBindingMode | undefined;
@@ -4783,9 +4961,11 @@ export type UpdateOAuthClientPayload = {
4783
4961
  grant_types?: OAuthGrantType[] | undefined;
4784
4962
  response_types?: OAuthResponseType[] | undefined;
4785
4963
  token_endpoint_auth_method?: OAuthTokenEndpointAuthMethod | undefined;
4964
+ jwks_uri?: string | undefined;
4786
4965
  allowed_scopes?: string[] | undefined;
4787
4966
  default_scopes?: string[] | undefined;
4788
4967
  status?: OAuthClientStatus | undefined;
4968
+ revoke_previous_client_secret?: boolean | undefined;
4789
4969
  project_binding_mode?: OAuthProjectBindingMode | undefined;
4790
4970
  fixed_project_id?: string | undefined;
4791
4971
  restrict_to_owner_account?: boolean | undefined;
@@ -4807,6 +4987,7 @@ export type OAuthAuthorizationServerMetadata = {
4807
4987
  grant_types_supported: string[];
4808
4988
  code_challenge_methods_supported: string[];
4809
4989
  token_endpoint_auth_methods_supported: string[];
4990
+ token_endpoint_auth_signing_alg_values_supported?: string[] | undefined;
4810
4991
  scopes_supported: string[];
4811
4992
  client_id_metadata_document_supported?: boolean | undefined;
4812
4993
  authorization_response_iss_parameter_supported?: boolean | undefined;
@@ -4847,6 +5028,7 @@ export type OAuthAuthorizationRequest = {
4847
5028
  user_code?: string | undefined;
4848
5029
  client_id: string;
4849
5030
  client_name: string;
5031
+ app_id?: string | undefined;
4850
5032
  client_metadata?: OAuthClientDisplayMetadata | undefined;
4851
5033
  client_registration_mode?: OAuthClientRegistrationMode | undefined;
4852
5034
  redirect_uri: string;
@@ -4920,6 +5102,73 @@ export type OAuthLoginUserNotFoundResponse = {
4920
5102
  error: 'user_not_found';
4921
5103
  ensure_user_url: string;
4922
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
+ };
4923
5172
  /**
4924
5173
  * OAuth Provider data stored in MongoDB.
4925
5174
  * Represents the configuration for an OAuth 2.0 provider at the project level.
@@ -5795,6 +6044,7 @@ export type StartProjectReindexPayload = {
5795
6044
  concurrency?: number | undefined;
5796
6045
  bulk_size_bytes?: number | undefined;
5797
6046
  bulk_concurrency?: number | undefined;
6047
+ modified_since?: string | undefined;
5798
6048
  };
5799
6049
  export type ReindexAgentRunsPayload = {
5800
6050
  recreate_index?: boolean | undefined;
@@ -7340,6 +7590,7 @@ export type PublishProcessDefinitionPayload = {
7340
7590
  tags?: string[] | undefined;
7341
7591
  label?: string | undefined;
7342
7592
  comment?: string | undefined;
7593
+ idempotency_key?: string | undefined;
7343
7594
  };
7344
7595
  export type RevertProcessDefinitionPayload = {
7345
7596
  confirmed: boolean;
@@ -7456,6 +7707,7 @@ export type StartProcessTestRunPayload = {
7456
7707
  suite_id: string;
7457
7708
  process_revision_id: string;
7458
7709
  scenario_ids?: string[] | undefined;
7710
+ idempotency_key?: string | undefined;
7459
7711
  };
7460
7712
  export type ProcessTestAssertionResult = {
7461
7713
  assertion: string;
@@ -7721,6 +7973,10 @@ export type ContentObjectUserPermissions = {
7721
7973
  export type ContentObjectTextResponse = {
7722
7974
  text?: string | undefined;
7723
7975
  };
7976
+ export type SetObjectTextPayload = {
7977
+ text: string;
7978
+ etag?: string | undefined;
7979
+ };
7724
7980
  export type DeleteContentObjectResult = {
7725
7981
  id: string;
7726
7982
  count: number;
@@ -9829,6 +10085,7 @@ export type ProcessTestTargetWithDefinitionWire = {
9829
10085
  export type SubmitProcessTestRunPayloadWire = {
9830
10086
  process: ProcessTestTargetWire;
9831
10087
  scenarios: ProcessTestScenario[];
10088
+ idempotency_key?: string | undefined;
9832
10089
  };
9833
10090
  export type CreateContentObjectPayloadWire = {
9834
10091
  text?: string | undefined;
@@ -10494,7 +10751,9 @@ export type TurnEvaluationFlagWire =
10494
10751
  | 'overhead'
10495
10752
  | 'followup_after_answer'
10496
10753
  | 'approval_denied'
10497
- | 'circuit_breaker';
10754
+ | 'circuit_breaker'
10755
+ | 'no_visible_answer'
10756
+ | 'answer_in_tool_preamble';
10498
10757
  export type ToolErrorClassWire = 'schema' | 'platform' | 'config' | 'environment' | 'other';
10499
10758
  export type EvaluationGateReasonWire = 'signal' | 'sample' | 'opt_in' | 'always_on';
10500
10759
  export type EvaluationOutcomeWire = 'evaluated' | 'skipped_unarchived' | 'failed';
@@ -10731,6 +10990,7 @@ export interface ApiComponentTypes {
10731
10990
  AppCapabilities: AppCapabilities;
10732
10991
  AppAccessControl: AppAccessControl;
10733
10992
  AppSourceConfig: AppSourceConfig;
10993
+ AppGitSourceProvider: AppGitSourceProvider;
10734
10994
  AppManifestSource: AppManifestSource;
10735
10995
  SuccessResponse: SuccessResponse;
10736
10996
  OAuthProvider: OAuthProvider;
@@ -10768,6 +11028,11 @@ export interface ApiComponentTypes {
10768
11028
  OAuthDeviceAuthorizationRequest: OAuthDeviceAuthorizationRequest;
10769
11029
  OAuthDeviceAuthorizationResponse: OAuthDeviceAuthorizationResponse;
10770
11030
  OAuthTokenResponse: OAuthTokenResponse;
11031
+ OidcFederationConnectionPayload: OidcFederationConnectionPayload;
11032
+ OidcFederationConnection: OidcFederationConnection;
11033
+ OidcFederationConnectionArray: OidcFederationConnectionArray;
11034
+ OAuthTokenExchangeRequest: OAuthTokenExchangeRequest;
11035
+ OAuthTokenExchangeResponse: OAuthTokenExchangeResponse;
10771
11036
  OAuthClient: OAuthClient;
10772
11037
  OAuthClientArray: OAuthClientArray;
10773
11038
  OAuthClientCreateResponse: OAuthClientCreateResponse;
@@ -11287,6 +11552,7 @@ export interface ApiComponentTypes {
11287
11552
  TranscriptSegment: TranscriptSegment;
11288
11553
  ContentObjectTypeArray: ContentObjectTypeArray;
11289
11554
  ContentObjectTextResponse: ContentObjectTextResponse;
11555
+ SetObjectTextPayload: SetObjectTextPayload;
11290
11556
  DeleteContentObjectResult: DeleteContentObjectResult;
11291
11557
  Transcript: Transcript;
11292
11558
  CreateContentObjectPayload: CreateContentObjectPayloadWire;
@@ -11725,6 +11991,20 @@ export interface ApiComponentTypes {
11725
11991
  AppRepoBranch: AppRepoBranch;
11726
11992
  AppRepoDocumentCommit: AppRepoDocumentCommit;
11727
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;
11728
12008
  StartAppScaffoldRequest: StartAppScaffoldRequest;
11729
12009
  StartAppDevelopmentTaskRequest: StartAppDevelopmentTaskRequest;
11730
12010
  StartAppBuildRequest: StartAppBuildRequest;
@@ -11749,6 +12029,7 @@ export interface ApiComponentTypes {
11749
12029
  AgentRunSearchHit: AgentRunSearchHit;
11750
12030
  UpsertAppVersionRequest: UpsertAppVersionRequest;
11751
12031
  AppInstallationPayload: AppInstallationPayload;
12032
+ AppInstanceAvailability: AppInstanceAvailability;
11752
12033
  AppDevelopmentTaskDetails: AppDevelopmentTaskDetails;
11753
12034
  AppVersionRecordArray: AppVersionRecordArray;
11754
12035
  AppToolCollectionArray: AppToolCollectionArray;
@@ -11827,6 +12108,7 @@ export interface ApiComponentTypes {
11827
12108
  MCPOAuthConfigMap: MCPOAuthConfigMap;
11828
12109
  AppWidgetInfo: AppWidgetInfo;
11829
12110
  AppDashboardDefinition: AppDashboardDefinition;
12111
+ AppOAuthClientConfig: AppOAuthClientConfig;
11830
12112
  AppManifestData: AppManifestData;
11831
12113
  UpdateAppPayload: UpdateAppPayload;
11832
12114
  AppManifest: AppManifest;
@@ -84,7 +84,9 @@ export type TurnEvaluationFlag =
84
84
  | 'overhead'
85
85
  | 'followup_after_answer'
86
86
  | 'approval_denied'
87
- | 'circuit_breaker';
87
+ | 'circuit_breaker'
88
+ | 'no_visible_answer'
89
+ | 'answer_in_tool_preamble';
88
90
 
89
91
  /** Coarse class of a tool error, derived from the error text. */
90
92
  export type ToolErrorClass = 'schema' | 'platform' | 'config' | 'environment' | 'other';
@@ -238,6 +240,14 @@ interface BaseLlmCallEvent extends BaseAgentEvent {
238
240
  streamingEnabled: boolean;
239
241
  /** Number of tool uses returned by the LLM */
240
242
  toolUseCount: number;
243
+ /** Provider stop reason, normalized by the driver (`stop`, `length`, `tool_use`, ...). Absent on failed calls. */
244
+ finishReason?: string;
245
+ /**
246
+ * Characters of visible output (text and JSON parts, trimmed; thoughts and media excluded).
247
+ * `0` with `toolUseCount: 0` and `finishReason: 'stop'` is a completion with nothing to show.
248
+ * Absent on failed calls and on events from producers that predate the field.
249
+ */
250
+ outputTextChars?: number;
241
251
  /** Type of call: 'start' for initial, 'resume_tools' for tool results, 'resume_user' for user message */
242
252
  callType: LlmCallType;
243
253
  /** Activity attempt number (for retries) */
@@ -415,6 +425,16 @@ export interface TurnEvaluationEvent extends BaseAgentEvent {
415
425
  stallCorrectives?: number;
416
426
  /** Stall circuit-breaker trips: the model ignored the corrective and the loop was stopped. Same caveat. */
417
427
  stallTrips?: number;
428
+ /**
429
+ * Characters of the answers posted in the turn. `0` with a `no_visible_answer` flag is a turn the
430
+ * user saw end without a reply. Absent on events from producers that predate the field.
431
+ */
432
+ answerChars?: number;
433
+ /**
434
+ * Characters of text the model sent alongside its last tool calls in the turn. Text sent with tool
435
+ * calls is shown as working prose, not as the answer. Same caveat.
436
+ */
437
+ finalToolCallTextChars?: number;
418
438
  /** An unprompted user message after an answer was followed by substantive tool work */
419
439
  followupAfterAnswer: boolean;
420
440
  severity: EvaluationSeverity;