@neon/tools 2.12.0 → 2.13.0

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 (91) hide show
  1. package/README.md +150 -7
  2. package/dist/descriptions.gen.d.ts +10 -0
  3. package/dist/descriptions.gen.d.ts.map +1 -0
  4. package/dist/descriptions.gen.js +150 -0
  5. package/dist/generated/zod.gen.d.ts +3 -3
  6. package/dist/index.d.ts +4 -3
  7. package/dist/index.d.ts.map +1 -1
  8. package/dist/index.js +14 -11
  9. package/dist/lib/custom/auth-config.d.ts +164 -0
  10. package/dist/lib/custom/auth-config.d.ts.map +1 -0
  11. package/dist/lib/custom/auth-config.js +177 -0
  12. package/dist/lib/custom/docs.d.ts +58 -0
  13. package/dist/lib/custom/docs.d.ts.map +1 -0
  14. package/dist/lib/custom/docs.js +143 -0
  15. package/dist/lib/custom/feedback.d.ts +15 -0
  16. package/dist/lib/custom/feedback.d.ts.map +1 -0
  17. package/dist/lib/custom/feedback.js +55 -0
  18. package/dist/lib/custom/fetch.d.ts +402 -0
  19. package/dist/lib/custom/fetch.d.ts.map +1 -0
  20. package/dist/lib/custom/fetch.js +198 -0
  21. package/dist/lib/custom/organizations.d.ts +23 -0
  22. package/dist/lib/custom/organizations.d.ts.map +1 -0
  23. package/dist/lib/custom/organizations.js +32 -0
  24. package/dist/lib/custom/resources.d.ts +22 -0
  25. package/dist/lib/custom/resources.d.ts.map +1 -0
  26. package/dist/lib/custom/resources.js +113 -0
  27. package/dist/lib/custom/sql/connection.d.ts +46 -0
  28. package/dist/lib/custom/sql/connection.d.ts.map +1 -0
  29. package/dist/lib/custom/sql/connection.js +78 -0
  30. package/dist/lib/custom/sql/describe-branch.d.ts +84 -0
  31. package/dist/lib/custom/sql/describe-branch.d.ts.map +1 -0
  32. package/dist/lib/custom/sql/describe-branch.js +155 -0
  33. package/dist/lib/custom/sql/inspect/inspect.d.ts +75 -0
  34. package/dist/lib/custom/sql/inspect/inspect.d.ts.map +1 -0
  35. package/dist/lib/custom/sql/inspect/inspect.js +135 -0
  36. package/dist/lib/custom/sql/inspect/queries.d.ts +63 -0
  37. package/dist/lib/custom/sql/inspect/queries.d.ts.map +1 -0
  38. package/dist/lib/custom/sql/inspect/queries.js +528 -0
  39. package/dist/lib/custom/sql/inspect/report.d.ts +31 -0
  40. package/dist/lib/custom/sql/inspect/report.d.ts.map +1 -0
  41. package/dist/lib/custom/sql/inspect/report.js +43 -0
  42. package/dist/lib/custom/sql/inspect/targets.d.ts +27 -0
  43. package/dist/lib/custom/sql/inspect/targets.d.ts.map +1 -0
  44. package/dist/lib/custom/sql/inspect/targets.js +33 -0
  45. package/dist/lib/custom/sql/migrations.d.ts +69 -0
  46. package/dist/lib/custom/sql/migrations.d.ts.map +1 -0
  47. package/dist/lib/custom/sql/migrations.js +144 -0
  48. package/dist/lib/custom/sql/plan.d.ts +27 -0
  49. package/dist/lib/custom/sql/plan.d.ts.map +1 -0
  50. package/dist/lib/custom/sql/plan.js +53 -0
  51. package/dist/lib/custom/sql/query-tuning.d.ts +107 -0
  52. package/dist/lib/custom/sql/query-tuning.d.ts.map +1 -0
  53. package/dist/lib/custom/sql/query-tuning.js +129 -0
  54. package/dist/lib/custom/sql/rows.d.ts +11 -0
  55. package/dist/lib/custom/sql/rows.d.ts.map +1 -0
  56. package/dist/lib/custom/sql/rows.js +19 -0
  57. package/dist/lib/custom/sql/run.d.ts +81 -0
  58. package/dist/lib/custom/sql/run.d.ts.map +1 -0
  59. package/dist/lib/custom/sql/run.js +90 -0
  60. package/dist/lib/custom/sql/schema.d.ts +84 -0
  61. package/dist/lib/custom/sql/schema.d.ts.map +1 -0
  62. package/dist/lib/custom/sql/schema.js +201 -0
  63. package/dist/lib/custom/sql/slow-queries.d.ts +43 -0
  64. package/dist/lib/custom/sql/slow-queries.d.ts.map +1 -0
  65. package/dist/lib/custom/sql/slow-queries.js +87 -0
  66. package/dist/lib/customize.d.ts +9 -2
  67. package/dist/lib/customize.d.ts.map +1 -1
  68. package/dist/lib/customize.js +21 -7
  69. package/dist/lib/ergonomic/bind.d.ts +11 -1
  70. package/dist/lib/ergonomic/bind.d.ts.map +1 -1
  71. package/dist/lib/ergonomic/bind.js +13 -3
  72. package/dist/lib/ergonomic/catalog.d.ts +854 -39
  73. package/dist/lib/ergonomic/catalog.d.ts.map +1 -1
  74. package/dist/lib/ergonomic/catalog.js +35 -8
  75. package/dist/lib/ergonomic/composed.d.ts +4 -4
  76. package/dist/lib/ergonomic/composed.d.ts.map +1 -1
  77. package/dist/lib/ergonomic/composed.js +47 -45
  78. package/dist/lib/ergonomic/ids.d.ts +3 -1
  79. package/dist/lib/ergonomic/ids.d.ts.map +1 -1
  80. package/dist/lib/ergonomic/ids.js +41 -2
  81. package/dist/lib/ergonomic/index.d.ts +1 -1
  82. package/dist/lib/ergonomic/index.d.ts.map +1 -1
  83. package/dist/lib/ergonomic/index.js +2 -2
  84. package/dist/lib/operation.d.ts +11 -0
  85. package/dist/lib/operation.d.ts.map +1 -1
  86. package/dist/lib/references.d.ts +10 -0
  87. package/dist/lib/references.d.ts.map +1 -0
  88. package/dist/lib/references.js +28 -0
  89. package/dist/operations.gen.d.ts +2 -2
  90. package/dist/operations.gen.js +301 -301
  91. package/package.json +8 -5
@@ -208,7 +208,7 @@ const operationFactories = {
208
208
  title: "Accept a project transfer request",
209
209
  description: "Accepts a transfer request for the specified project, transferring it to the specified organization or user.",
210
210
  inputSchema: z.strictObject({
211
- "project_id": zAcceptProjectTransferRequestPath.shape.project_id,
211
+ "project_id": zAcceptProjectTransferRequestPath.shape.project_id.describe("Project id."),
212
212
  "request_id": zAcceptProjectTransferRequestPath.shape.request_id,
213
213
  "org_id": zAcceptProjectTransferRequestBody.shape.org_id.optional()
214
214
  }),
@@ -242,8 +242,8 @@ const operationFactories = {
242
242
  title: "Add an OAuth provider",
243
243
  description: "Adds an OAuth provider configuration to the specified branch's Neon Auth integration.",
244
244
  inputSchema: z.strictObject({
245
- "project_id": zAddBranchNeonAuthOauthProviderPath.shape.project_id,
246
- "branch_id": zAddBranchNeonAuthOauthProviderPath.shape.branch_id,
245
+ "project_id": zAddBranchNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
246
+ "branch_id": zAddBranchNeonAuthOauthProviderPath.shape.branch_id.describe("A br-... id, not a name."),
247
247
  "id": zAddBranchNeonAuthOauthProviderBody.shape.id,
248
248
  "client_id": zAddBranchNeonAuthOauthProviderBody.shape.client_id,
249
249
  "client_secret": zAddBranchNeonAuthOauthProviderBody.shape.client_secret,
@@ -288,8 +288,8 @@ const operationFactories = {
288
288
  title: "Add domain to redirect_uri whitelist",
289
289
  description: "Adds a domain to the redirect URI whitelist for the specified branch.",
290
290
  inputSchema: z.strictObject({
291
- "project_id": zAddBranchNeonAuthTrustedDomainPath.shape.project_id,
292
- "branch_id": zAddBranchNeonAuthTrustedDomainPath.shape.branch_id,
291
+ "project_id": zAddBranchNeonAuthTrustedDomainPath.shape.project_id.describe("Project id."),
292
+ "branch_id": zAddBranchNeonAuthTrustedDomainPath.shape.branch_id.describe("A br-... id, not a name."),
293
293
  "domain": zAddBranchNeonAuthTrustedDomainBody.shape.domain,
294
294
  "auth_provider": zAddBranchNeonAuthTrustedDomainBody.shape.auth_provider
295
295
  }),
@@ -326,7 +326,7 @@ const operationFactories = {
326
326
  title: "Add trusted redirect URI domain",
327
327
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/domains` instead.",
328
328
  inputSchema: z.strictObject({
329
- "project_id": zAddNeonAuthDomainToRedirectUriWhitelistPath.shape.project_id,
329
+ "project_id": zAddNeonAuthDomainToRedirectUriWhitelistPath.shape.project_id.describe("Project id."),
330
330
  "domain": zAddNeonAuthDomainToRedirectUriWhitelistBody.shape.domain,
331
331
  "auth_provider": zAddNeonAuthDomainToRedirectUriWhitelistBody.shape.auth_provider
332
332
  }),
@@ -360,7 +360,7 @@ const operationFactories = {
360
360
  title: "Add an OAuth provider",
361
361
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/oauth_providers` instead.",
362
362
  inputSchema: z.strictObject({
363
- "project_id": zAddNeonAuthOauthProviderPath.shape.project_id,
363
+ "project_id": zAddNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
364
364
  "id": zAddNeonAuthOauthProviderBody.shape.id,
365
365
  "client_id": zAddNeonAuthOauthProviderBody.shape.client_id,
366
366
  "client_secret": zAddNeonAuthOauthProviderBody.shape.client_secret,
@@ -402,7 +402,7 @@ const operationFactories = {
402
402
  title: "Add JWKS URL",
403
403
  description: "Adds a JWKS URL to the specified project for verifying JWTs used as the authentication mechanism.",
404
404
  inputSchema: z.strictObject({
405
- "project_id": zAddProjectJwksPath.shape.project_id,
405
+ "project_id": zAddProjectJwksPath.shape.project_id.describe("Project id."),
406
406
  "jwks_url": zAddProjectJwksBody.shape.jwks_url,
407
407
  "provider_name": zAddProjectJwksBody.shape.provider_name,
408
408
  "branch_id": zAddProjectJwksBody.shape.branch_id,
@@ -444,7 +444,7 @@ const operationFactories = {
444
444
  title: "Assign or update VPC endpoint",
445
445
  description: "Assigns a VPC endpoint to a Neon organization or updates its existing assignment.",
446
446
  inputSchema: z.strictObject({
447
- "org_id": zAssignOrganizationVpcEndpointPath.shape.org_id,
447
+ "org_id": zAssignOrganizationVpcEndpointPath.shape.org_id.describe("Organization id."),
448
448
  "region_id": zAssignOrganizationVpcEndpointPath.shape.region_id,
449
449
  "vpc_endpoint_id": zAssignOrganizationVpcEndpointPath.shape.vpc_endpoint_id,
450
450
  "label": zAssignOrganizationVpcEndpointBody.shape.label
@@ -480,7 +480,7 @@ const operationFactories = {
480
480
  title: "Set VPC endpoint restriction",
481
481
  description: "Sets or updates a VPC endpoint restriction for a Neon project.",
482
482
  inputSchema: z.strictObject({
483
- "project_id": zAssignProjectVpcEndpointPath.shape.project_id,
483
+ "project_id": zAssignProjectVpcEndpointPath.shape.project_id.describe("Project id."),
484
484
  "vpc_endpoint_id": zAssignProjectVpcEndpointPath.shape.vpc_endpoint_id,
485
485
  "label": zAssignProjectVpcEndpointBody.shape.label
486
486
  }),
@@ -514,7 +514,7 @@ const operationFactories = {
514
514
  title: "Retrieve number of branches",
515
515
  description: "Retrieves the total number of branches in the specified project.",
516
516
  inputSchema: z.strictObject({
517
- "project_id": zCountProjectBranchesPath.shape.project_id,
517
+ "project_id": zCountProjectBranchesPath.shape.project_id.describe("Project id."),
518
518
  "search": zCountProjectBranchesQuery.shape.search.optional()
519
519
  }),
520
520
  annotations: {
@@ -542,7 +542,7 @@ const operationFactories = {
542
542
  id: "count_projects",
543
543
  title: "Retrieve projects count",
544
544
  description: "Retrieves the number of active projects you can access in the specified organization, without paging through the list of projects.",
545
- inputSchema: z.strictObject({ "org_id": zCountProjectsQuery.shape.org_id.optional() }),
545
+ inputSchema: z.strictObject({ "org_id": zCountProjectsQuery.shape.org_id.describe("Organization id from {{user.organizations}}; required with a personal API key.").optional() }),
546
546
  annotations: {
547
547
  readOnlyHint: true,
548
548
  openWorldHint: false
@@ -594,8 +594,8 @@ const operationFactories = {
594
594
  title: "Create new auth user",
595
595
  description: "Creates a new user in the Neon Auth user directory for the specified branch.",
596
596
  inputSchema: z.strictObject({
597
- "project_id": zCreateBranchNeonAuthNewUserPath.shape.project_id,
598
- "branch_id": zCreateBranchNeonAuthNewUserPath.shape.branch_id,
597
+ "project_id": zCreateBranchNeonAuthNewUserPath.shape.project_id.describe("Project id."),
598
+ "branch_id": zCreateBranchNeonAuthNewUserPath.shape.branch_id.describe("A br-... id, not a name."),
599
599
  "email": zCreateBranchNeonAuthNewUserBody.shape.email,
600
600
  "name": zCreateBranchNeonAuthNewUserBody.shape.name
601
601
  }),
@@ -632,8 +632,8 @@ const operationFactories = {
632
632
  title: "Issue a scoped credential on the branch",
633
633
  description: "Issues a new scoped service credential anchored to the specified branch.",
634
634
  inputSchema: z.strictObject({
635
- "project_id": zCreateCredentialPath.shape.project_id,
636
- "branch_id": zCreateCredentialPath.shape.branch_id,
635
+ "project_id": zCreateCredentialPath.shape.project_id.describe("Project id."),
636
+ "branch_id": zCreateCredentialPath.shape.branch_id.describe("A br-... id, not a name."),
637
637
  "name": zCreateCredentialBody.shape.name,
638
638
  "scopes": zCreateCredentialBody.shape.scopes.describe("Capabilities to grant. The credential may only perform actions in these scopes."),
639
639
  "principal_type": zCreateCredentialBody.shape.principal_type
@@ -672,8 +672,8 @@ const operationFactories = {
672
672
  title: "Enable Neon Auth for the branch",
673
673
  description: "Enables Neon Auth for the specified branch by connecting it to an authentication provider.",
674
674
  inputSchema: z.strictObject({
675
- "project_id": zCreateNeonAuthPath.shape.project_id,
676
- "branch_id": zCreateNeonAuthPath.shape.branch_id,
675
+ "project_id": zCreateNeonAuthPath.shape.project_id.describe("Project id."),
676
+ "branch_id": zCreateNeonAuthPath.shape.branch_id.describe("A br-... id, not a name."),
677
677
  "auth_provider": zCreateNeonAuthBody.shape.auth_provider,
678
678
  "database_name": zCreateNeonAuthBody.shape.database_name
679
679
  }),
@@ -784,8 +784,8 @@ const operationFactories = {
784
784
  title: "Create an OAuth client",
785
785
  description: "Registers an OAuth client with the branch's Neon Auth OAuth provider.",
786
786
  inputSchema: z.strictObject({
787
- "project_id": zCreateNeonAuthOAuthClientPath.shape.project_id,
788
- "branch_id": zCreateNeonAuthOAuthClientPath.shape.branch_id,
787
+ "project_id": zCreateNeonAuthOAuthClientPath.shape.project_id.describe("Project id."),
788
+ "branch_id": zCreateNeonAuthOAuthClientPath.shape.branch_id.describe("A br-... id, not a name."),
789
789
  "name": zCreateNeonAuthOAuthClientBody.shape.name,
790
790
  "redirect_uris": zCreateNeonAuthOAuthClientBody.shape.redirect_uris,
791
791
  "type": zCreateNeonAuthOAuthClientBody.shape.type,
@@ -860,7 +860,7 @@ const operationFactories = {
860
860
  title: "Create organization invitations",
861
861
  description: "Creates invitations for a specific organization.",
862
862
  inputSchema: z.strictObject({
863
- "org_id": zCreateOrganizationInvitationsPath.shape.org_id,
863
+ "org_id": zCreateOrganizationInvitationsPath.shape.org_id.describe("Organization id."),
864
864
  "invitations": zCreateOrganizationInvitationsBody.shape.invitations
865
865
  }),
866
866
  annotations: {
@@ -890,7 +890,7 @@ const operationFactories = {
890
890
  title: "Create organization API key",
891
891
  description: "Creates an API key for the specified organization.",
892
892
  inputSchema: z.strictObject({
893
- "org_id": zCreateOrgApiKeyPath.shape.org_id,
893
+ "org_id": zCreateOrgApiKeyPath.shape.org_id.describe("Organization id."),
894
894
  "key_name": zCreateOrgApiKeyBody.shape.key_name,
895
895
  "project_id": zCreateOrgApiKeyBody.shape.project_id
896
896
  }),
@@ -978,7 +978,7 @@ const operationFactories = {
978
978
  title: "Create branch",
979
979
  description: "Creates a branch in the specified project.",
980
980
  inputSchema: z.strictObject({
981
- "project_id": zCreateProjectBranchPath.shape.project_id,
981
+ "project_id": zCreateProjectBranchPath.shape.project_id.describe("Project id."),
982
982
  "endpoints": zCreateProjectBranchBody.shape.endpoints.optional(),
983
983
  "branch": zCreateProjectBranchBody.shape.branch.optional(),
984
984
  "annotation_value": zCreateProjectBranchBody.shape.annotation_value.optional()
@@ -1014,7 +1014,7 @@ const operationFactories = {
1014
1014
  title: "Create anonymized branch",
1015
1015
  description: "Creates a new branch with anonymized data using PostgreSQL Anonymizer for static masking.",
1016
1016
  inputSchema: z.strictObject({
1017
- "project_id": zCreateProjectBranchAnonymizedPath.shape.project_id,
1017
+ "project_id": zCreateProjectBranchAnonymizedPath.shape.project_id.describe("Project id."),
1018
1018
  "annotation_value": zCreateProjectBranchAnonymizedBody.shape.annotation_value,
1019
1019
  "branch_create": zCreateProjectBranchAnonymizedBody.shape.branch_create,
1020
1020
  "masking_rules": zCreateProjectBranchAnonymizedBody.shape.masking_rules,
@@ -1052,8 +1052,8 @@ const operationFactories = {
1052
1052
  title: "Create a bucket on the branch",
1053
1053
  description: "Creates a new branchable object storage bucket on the specified branch.",
1054
1054
  inputSchema: z.strictObject({
1055
- "project_id": zCreateProjectBranchBucketPath.shape.project_id,
1056
- "branch_id": zCreateProjectBranchBucketPath.shape.branch_id,
1055
+ "project_id": zCreateProjectBranchBucketPath.shape.project_id.describe("Project id."),
1056
+ "branch_id": zCreateProjectBranchBucketPath.shape.branch_id.describe("A br-... id, not a name."),
1057
1057
  "name": zCreateProjectBranchBucketBody.shape.name,
1058
1058
  "access_level": zCreateProjectBranchBucketBody.shape.access_level
1059
1059
  }),
@@ -1090,8 +1090,8 @@ const operationFactories = {
1090
1090
  title: "Create Neon Data API",
1091
1091
  description: "Creates a new instance of Neon Data API in the specified branch.",
1092
1092
  inputSchema: z.strictObject({
1093
- "project_id": zCreateProjectBranchDataApiPath.shape.project_id,
1094
- "branch_id": zCreateProjectBranchDataApiPath.shape.branch_id,
1093
+ "project_id": zCreateProjectBranchDataApiPath.shape.project_id.describe("Project id."),
1094
+ "branch_id": zCreateProjectBranchDataApiPath.shape.branch_id.describe("A br-... id, not a name."),
1095
1095
  "database_name": zCreateProjectBranchDataApiPath.shape.database_name,
1096
1096
  "auth_provider": zCreateProjectBranchDataApiBody.shape.auth_provider.optional(),
1097
1097
  "jwks_url": zCreateProjectBranchDataApiBody.shape.jwks_url.optional(),
@@ -1140,8 +1140,8 @@ const operationFactories = {
1140
1140
  title: "Create database",
1141
1141
  description: "Creates a database in the specified branch.",
1142
1142
  inputSchema: z.strictObject({
1143
- "project_id": zCreateProjectBranchDatabasePath.shape.project_id,
1144
- "branch_id": zCreateProjectBranchDatabasePath.shape.branch_id,
1143
+ "project_id": zCreateProjectBranchDatabasePath.shape.project_id.describe("Project id."),
1144
+ "branch_id": zCreateProjectBranchDatabasePath.shape.branch_id.describe("A br-... id, not a name."),
1145
1145
  "name": zCreateProjectBranchDatabaseBody.shape.database.shape.name,
1146
1146
  "owner_name": zCreateProjectBranchDatabaseBody.shape.database.shape.owner_name
1147
1147
  }),
@@ -1178,8 +1178,8 @@ const operationFactories = {
1178
1178
  title: "Deploy code to a function",
1179
1179
  description: "Creates a deployment for the function.",
1180
1180
  inputSchema: z.strictObject({
1181
- "project_id": zCreateProjectBranchFunctionDeploymentPath.shape.project_id,
1182
- "branch_id": zCreateProjectBranchFunctionDeploymentPath.shape.branch_id,
1181
+ "project_id": zCreateProjectBranchFunctionDeploymentPath.shape.project_id.describe("Project id."),
1182
+ "branch_id": zCreateProjectBranchFunctionDeploymentPath.shape.branch_id.describe("A br-... id, not a name."),
1183
1183
  "slug": zCreateProjectBranchFunctionDeploymentPath.shape.slug,
1184
1184
  "zip": z.base64().describe("Base64-encoded ZIP of the function source. Omit to reuse the latest bundle; required for the first deployment.").optional(),
1185
1185
  "runtime": zCreateProjectBranchFunctionDeploymentBody.shape.runtime.describe("The Node.js runtime for the deployment."),
@@ -1220,8 +1220,8 @@ const operationFactories = {
1220
1220
  title: "Create role",
1221
1221
  description: "Creates a Postgres role in the specified branch.",
1222
1222
  inputSchema: z.strictObject({
1223
- "project_id": zCreateProjectBranchRolePath.shape.project_id,
1224
- "branch_id": zCreateProjectBranchRolePath.shape.branch_id,
1223
+ "project_id": zCreateProjectBranchRolePath.shape.project_id.describe("Project id."),
1224
+ "branch_id": zCreateProjectBranchRolePath.shape.branch_id.describe("A br-... id, not a name."),
1225
1225
  "name": zCreateProjectBranchRoleBody.shape.role.shape.name,
1226
1226
  "no_login": zCreateProjectBranchRoleBody.shape.role.shape.no_login
1227
1227
  }),
@@ -1258,8 +1258,8 @@ const operationFactories = {
1258
1258
  title: "Create a trigger",
1259
1259
  description: "Creates a trigger for a Function visible on the branch.",
1260
1260
  inputSchema: z.strictObject({
1261
- "project_id": zCreateProjectBranchTriggerPath.shape.project_id,
1262
- "branch_id": zCreateProjectBranchTriggerPath.shape.branch_id,
1261
+ "project_id": zCreateProjectBranchTriggerPath.shape.project_id.describe("Project id."),
1262
+ "branch_id": zCreateProjectBranchTriggerPath.shape.branch_id.describe("A br-... id, not a name."),
1263
1263
  "body": zCreateProjectBranchTriggerBody.describe("Trigger creation payload discriminated by `type`.")
1264
1264
  }),
1265
1265
  annotations: {
@@ -1292,7 +1292,7 @@ const operationFactories = {
1292
1292
  title: "Create compute endpoint",
1293
1293
  description: "Creates a compute endpoint for the specified branch.",
1294
1294
  inputSchema: z.strictObject({
1295
- "project_id": zCreateProjectEndpointPath.shape.project_id,
1295
+ "project_id": zCreateProjectEndpointPath.shape.project_id.describe("Project id."),
1296
1296
  "branch_id": zCreateProjectEndpointBody.shape.endpoint.shape.branch_id,
1297
1297
  "region_id": zCreateProjectEndpointBody.shape.endpoint.shape.region_id,
1298
1298
  "type": zCreateProjectEndpointBody.shape.endpoint.shape.type,
@@ -1348,7 +1348,7 @@ const operationFactories = {
1348
1348
  title: "Create a project transfer request",
1349
1349
  description: "Creates a transfer request for the specified project.",
1350
1350
  inputSchema: z.strictObject({
1351
- "project_id": zCreateProjectTransferRequestPath.shape.project_id,
1351
+ "project_id": zCreateProjectTransferRequestPath.shape.project_id.describe("Project id."),
1352
1352
  "ttl_seconds": zCreateProjectTransferRequestBody.shape.ttl_seconds.optional()
1353
1353
  }),
1354
1354
  annotations: {
@@ -1378,8 +1378,8 @@ const operationFactories = {
1378
1378
  title: "Create snapshot",
1379
1379
  description: "Creates a snapshot from the specified branch.",
1380
1380
  inputSchema: z.strictObject({
1381
- "project_id": zCreateSnapshotPath.shape.project_id,
1382
- "branch_id": zCreateSnapshotPath.shape.branch_id,
1381
+ "project_id": zCreateSnapshotPath.shape.project_id.describe("Project id."),
1382
+ "branch_id": zCreateSnapshotPath.shape.branch_id.describe("A br-... id, not a name."),
1383
1383
  "lsn": zCreateSnapshotQuery.shape.lsn.optional(),
1384
1384
  "timestamp": zCreateSnapshotQuery.shape.timestamp.optional(),
1385
1385
  "name": zCreateSnapshotQuery.shape.name.optional(),
@@ -1420,8 +1420,8 @@ const operationFactories = {
1420
1420
  title: "Delete OAuth provider",
1421
1421
  description: "Deletes an OAuth provider from the specified project.",
1422
1422
  inputSchema: z.strictObject({
1423
- "project_id": zDeleteBranchNeonAuthOauthProviderPath.shape.project_id,
1424
- "branch_id": zDeleteBranchNeonAuthOauthProviderPath.shape.branch_id,
1423
+ "project_id": zDeleteBranchNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
1424
+ "branch_id": zDeleteBranchNeonAuthOauthProviderPath.shape.branch_id.describe("A br-... id, not a name."),
1425
1425
  "oauth_provider_id": zDeleteBranchNeonAuthOauthProviderPath.shape.oauth_provider_id
1426
1426
  }),
1427
1427
  annotations: {
@@ -1454,8 +1454,8 @@ const operationFactories = {
1454
1454
  title: "Delete domain from redirect_uri whitelist",
1455
1455
  description: "Removes a domain from the redirect URI whitelist for the specified branch.",
1456
1456
  inputSchema: z.strictObject({
1457
- "project_id": zDeleteBranchNeonAuthTrustedDomainPath.shape.project_id,
1458
- "branch_id": zDeleteBranchNeonAuthTrustedDomainPath.shape.branch_id,
1457
+ "project_id": zDeleteBranchNeonAuthTrustedDomainPath.shape.project_id.describe("Project id."),
1458
+ "branch_id": zDeleteBranchNeonAuthTrustedDomainPath.shape.branch_id.describe("A br-... id, not a name."),
1459
1459
  "auth_provider": zDeleteBranchNeonAuthTrustedDomainBody.shape.auth_provider,
1460
1460
  "domains": zDeleteBranchNeonAuthTrustedDomainBody.shape.domains
1461
1461
  }),
@@ -1492,8 +1492,8 @@ const operationFactories = {
1492
1492
  title: "Delete auth user",
1493
1493
  description: "Deletes the specified user from the Neon Auth user directory for the specified branch.",
1494
1494
  inputSchema: z.strictObject({
1495
- "project_id": zDeleteBranchNeonAuthUserPath.shape.project_id,
1496
- "branch_id": zDeleteBranchNeonAuthUserPath.shape.branch_id,
1495
+ "project_id": zDeleteBranchNeonAuthUserPath.shape.project_id.describe("Project id."),
1496
+ "branch_id": zDeleteBranchNeonAuthUserPath.shape.branch_id.describe("A br-... id, not a name."),
1497
1497
  "auth_user_id": zDeleteBranchNeonAuthUserPath.shape.auth_user_id
1498
1498
  }),
1499
1499
  annotations: {
@@ -1526,7 +1526,7 @@ const operationFactories = {
1526
1526
  title: "Delete trusted redirect URI domain",
1527
1527
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/domains` instead.",
1528
1528
  inputSchema: z.strictObject({
1529
- "project_id": zDeleteNeonAuthDomainFromRedirectUriWhitelistPath.shape.project_id,
1529
+ "project_id": zDeleteNeonAuthDomainFromRedirectUriWhitelistPath.shape.project_id.describe("Project id."),
1530
1530
  "auth_provider": zDeleteNeonAuthDomainFromRedirectUriWhitelistBody.shape.auth_provider,
1531
1531
  "domains": zDeleteNeonAuthDomainFromRedirectUriWhitelistBody.shape.domains
1532
1532
  }),
@@ -1560,7 +1560,7 @@ const operationFactories = {
1560
1560
  title: "Delete integration with auth provider",
1561
1561
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth` instead.",
1562
1562
  inputSchema: z.strictObject({
1563
- "project_id": zDeleteNeonAuthIntegrationPath.shape.project_id,
1563
+ "project_id": zDeleteNeonAuthIntegrationPath.shape.project_id.describe("Project id."),
1564
1564
  "auth_provider": zDeleteNeonAuthIntegrationPath.shape.auth_provider,
1565
1565
  "delete_data": zDeleteNeonAuthIntegrationBody.shape.delete_data.optional()
1566
1566
  }),
@@ -1594,8 +1594,8 @@ const operationFactories = {
1594
1594
  title: "Delete an OAuth client",
1595
1595
  description: "Deletes an OAuth client.",
1596
1596
  inputSchema: z.strictObject({
1597
- "project_id": zDeleteNeonAuthOAuthClientPath.shape.project_id,
1598
- "branch_id": zDeleteNeonAuthOAuthClientPath.shape.branch_id,
1597
+ "project_id": zDeleteNeonAuthOAuthClientPath.shape.project_id.describe("Project id."),
1598
+ "branch_id": zDeleteNeonAuthOAuthClientPath.shape.branch_id.describe("A br-... id, not a name."),
1599
1599
  "client_id": zDeleteNeonAuthOAuthClientPath.shape.client_id
1600
1600
  }),
1601
1601
  annotations: {
@@ -1628,7 +1628,7 @@ const operationFactories = {
1628
1628
  title: "Delete OAuth provider",
1629
1629
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/oauth_providers/{oauth_provider_id}` instead.",
1630
1630
  inputSchema: z.strictObject({
1631
- "project_id": zDeleteNeonAuthOauthProviderPath.shape.project_id,
1631
+ "project_id": zDeleteNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
1632
1632
  "oauth_provider_id": zDeleteNeonAuthOauthProviderPath.shape.oauth_provider_id
1633
1633
  }),
1634
1634
  annotations: {
@@ -1660,7 +1660,7 @@ const operationFactories = {
1660
1660
  title: "Delete auth user",
1661
1661
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/users/{auth_user_id}` instead.",
1662
1662
  inputSchema: z.strictObject({
1663
- "project_id": zDeleteNeonAuthUserPath.shape.project_id,
1663
+ "project_id": zDeleteNeonAuthUserPath.shape.project_id.describe("Project id."),
1664
1664
  "auth_user_id": zDeleteNeonAuthUserPath.shape.auth_user_id
1665
1665
  }),
1666
1666
  annotations: {
@@ -1691,7 +1691,7 @@ const operationFactories = {
1691
1691
  id: "delete_organization_spending_limit",
1692
1692
  title: "Remove organization spending limit",
1693
1693
  description: "Removes the configured monthly spending limit for the specified organization.",
1694
- inputSchema: z.strictObject({ "org_id": zDeleteOrganizationSpendingLimitPath.shape.org_id }),
1694
+ inputSchema: z.strictObject({ "org_id": zDeleteOrganizationSpendingLimitPath.shape.org_id.describe("Organization id.") }),
1695
1695
  annotations: {
1696
1696
  readOnlyHint: false,
1697
1697
  destructiveHint: true,
@@ -1718,7 +1718,7 @@ const operationFactories = {
1718
1718
  title: "Delete VPC endpoint",
1719
1719
  description: "Deletes the VPC endpoint from the specified Neon organization.",
1720
1720
  inputSchema: z.strictObject({
1721
- "org_id": zDeleteOrganizationVpcEndpointPath.shape.org_id,
1721
+ "org_id": zDeleteOrganizationVpcEndpointPath.shape.org_id.describe("Organization id."),
1722
1722
  "region_id": zDeleteOrganizationVpcEndpointPath.shape.region_id,
1723
1723
  "vpc_endpoint_id": zDeleteOrganizationVpcEndpointPath.shape.vpc_endpoint_id
1724
1724
  }),
@@ -1751,7 +1751,7 @@ const operationFactories = {
1751
1751
  id: "delete_project",
1752
1752
  title: "Delete project",
1753
1753
  description: "Deletes the specified project and all its endpoints, branches, databases, and users.",
1754
- inputSchema: z.strictObject({ "project_id": zDeleteProjectPath.shape.project_id }),
1754
+ inputSchema: z.strictObject({ "project_id": zDeleteProjectPath.shape.project_id.describe("Project id.") }),
1755
1755
  annotations: {
1756
1756
  readOnlyHint: false,
1757
1757
  destructiveHint: true,
@@ -1778,8 +1778,8 @@ const operationFactories = {
1778
1778
  title: "Delete branch",
1779
1779
  description: "Deletes the specified branch from a project and places all compute endpoints into an idle state, breaking existing client connections.",
1780
1780
  inputSchema: z.strictObject({
1781
- "project_id": zDeleteProjectBranchPath.shape.project_id,
1782
- "branch_id": zDeleteProjectBranchPath.shape.branch_id
1781
+ "project_id": zDeleteProjectBranchPath.shape.project_id.describe("Project id."),
1782
+ "branch_id": zDeleteProjectBranchPath.shape.branch_id.describe("A br-... id, not a name.")
1783
1783
  }),
1784
1784
  annotations: {
1785
1785
  readOnlyHint: false,
@@ -1810,8 +1810,8 @@ const operationFactories = {
1810
1810
  title: "Delete a bucket on the branch",
1811
1811
  description: "Deletes the named bucket from the specified branch.",
1812
1812
  inputSchema: z.strictObject({
1813
- "project_id": zDeleteProjectBranchBucketPath.shape.project_id,
1814
- "branch_id": zDeleteProjectBranchBucketPath.shape.branch_id,
1813
+ "project_id": zDeleteProjectBranchBucketPath.shape.project_id.describe("Project id."),
1814
+ "branch_id": zDeleteProjectBranchBucketPath.shape.branch_id.describe("A br-... id, not a name."),
1815
1815
  "bucket_name": zDeleteProjectBranchBucketPath.shape.bucket_name
1816
1816
  }),
1817
1817
  annotations: {
@@ -1844,8 +1844,8 @@ const operationFactories = {
1844
1844
  title: "Delete an object in a bucket",
1845
1845
  description: "Deletes the named object from the bucket on the specified branch.",
1846
1846
  inputSchema: z.strictObject({
1847
- "project_id": zDeleteProjectBranchBucketObjectPath.shape.project_id,
1848
- "branch_id": zDeleteProjectBranchBucketObjectPath.shape.branch_id,
1847
+ "project_id": zDeleteProjectBranchBucketObjectPath.shape.project_id.describe("Project id."),
1848
+ "branch_id": zDeleteProjectBranchBucketObjectPath.shape.branch_id.describe("A br-... id, not a name."),
1849
1849
  "bucket_name": zDeleteProjectBranchBucketObjectPath.shape.bucket_name,
1850
1850
  "object_key": zDeleteProjectBranchBucketObjectPath.shape.object_key
1851
1851
  }),
@@ -1880,10 +1880,10 @@ const operationFactories = {
1880
1880
  title: "Delete every object under a key prefix (folder) in a bucket",
1881
1881
  description: "Soft-deletes every object on the specified branch whose key starts with `prefix`, in a single call.",
1882
1882
  inputSchema: z.strictObject({
1883
- "project_id": zDeleteProjectBranchBucketObjectsByPrefixPath.shape.project_id,
1884
- "branch_id": zDeleteProjectBranchBucketObjectsByPrefixPath.shape.branch_id,
1883
+ "project_id": zDeleteProjectBranchBucketObjectsByPrefixPath.shape.project_id.describe("Project id."),
1884
+ "branch_id": zDeleteProjectBranchBucketObjectsByPrefixPath.shape.branch_id.describe("A br-... id, not a name."),
1885
1885
  "bucket_name": zDeleteProjectBranchBucketObjectsByPrefixPath.shape.bucket_name,
1886
- "prefix": zDeleteProjectBranchBucketObjectsByPrefixQuery.shape.prefix
1886
+ "prefix": zDeleteProjectBranchBucketObjectsByPrefixQuery.shape.prefix.describe("Key prefix to delete, ending in / (for example app/avatars/).")
1887
1887
  }),
1888
1888
  annotations: {
1889
1889
  readOnlyHint: false,
@@ -1916,8 +1916,8 @@ const operationFactories = {
1916
1916
  title: "Delete a custom domain from a branch",
1917
1917
  description: "Removes a custom domain registered on the branch and stops routing it.",
1918
1918
  inputSchema: z.strictObject({
1919
- "project_id": zDeleteProjectBranchCustomDomainPath.shape.project_id,
1920
- "branch_id": zDeleteProjectBranchCustomDomainPath.shape.branch_id,
1919
+ "project_id": zDeleteProjectBranchCustomDomainPath.shape.project_id.describe("Project id."),
1920
+ "branch_id": zDeleteProjectBranchCustomDomainPath.shape.branch_id.describe("A br-... id, not a name."),
1921
1921
  "domain": zDeleteProjectBranchCustomDomainPath.shape.domain
1922
1922
  }),
1923
1923
  annotations: {
@@ -1950,8 +1950,8 @@ const operationFactories = {
1950
1950
  title: "Delete Neon Data API",
1951
1951
  description: "Deletes the Neon Data API for the specified branch.",
1952
1952
  inputSchema: z.strictObject({
1953
- "project_id": zDeleteProjectBranchDataApiPath.shape.project_id,
1954
- "branch_id": zDeleteProjectBranchDataApiPath.shape.branch_id,
1953
+ "project_id": zDeleteProjectBranchDataApiPath.shape.project_id.describe("Project id."),
1954
+ "branch_id": zDeleteProjectBranchDataApiPath.shape.branch_id.describe("A br-... id, not a name."),
1955
1955
  "database_name": zDeleteProjectBranchDataApiPath.shape.database_name
1956
1956
  }),
1957
1957
  annotations: {
@@ -1984,8 +1984,8 @@ const operationFactories = {
1984
1984
  title: "Delete database",
1985
1985
  description: "Deletes the specified database from the branch.",
1986
1986
  inputSchema: z.strictObject({
1987
- "project_id": zDeleteProjectBranchDatabasePath.shape.project_id,
1988
- "branch_id": zDeleteProjectBranchDatabasePath.shape.branch_id,
1987
+ "project_id": zDeleteProjectBranchDatabasePath.shape.project_id.describe("Project id."),
1988
+ "branch_id": zDeleteProjectBranchDatabasePath.shape.branch_id.describe("A br-... id, not a name."),
1989
1989
  "database_name": zDeleteProjectBranchDatabasePath.shape.database_name
1990
1990
  }),
1991
1991
  annotations: {
@@ -2018,8 +2018,8 @@ const operationFactories = {
2018
2018
  title: "Delete a function on the branch",
2019
2019
  description: "Deletes the function identified by its slug.",
2020
2020
  inputSchema: z.strictObject({
2021
- "project_id": zDeleteProjectBranchFunctionPath.shape.project_id,
2022
- "branch_id": zDeleteProjectBranchFunctionPath.shape.branch_id,
2021
+ "project_id": zDeleteProjectBranchFunctionPath.shape.project_id.describe("Project id."),
2022
+ "branch_id": zDeleteProjectBranchFunctionPath.shape.branch_id.describe("A br-... id, not a name."),
2023
2023
  "slug": zDeleteProjectBranchFunctionPath.shape.slug
2024
2024
  }),
2025
2025
  annotations: {
@@ -2052,8 +2052,8 @@ const operationFactories = {
2052
2052
  title: "Delete role",
2053
2053
  description: "Deletes the specified Postgres role from the branch.",
2054
2054
  inputSchema: z.strictObject({
2055
- "project_id": zDeleteProjectBranchRolePath.shape.project_id,
2056
- "branch_id": zDeleteProjectBranchRolePath.shape.branch_id,
2055
+ "project_id": zDeleteProjectBranchRolePath.shape.project_id.describe("Project id."),
2056
+ "branch_id": zDeleteProjectBranchRolePath.shape.branch_id.describe("A br-... id, not a name."),
2057
2057
  "role_name": zDeleteProjectBranchRolePath.shape.role_name
2058
2058
  }),
2059
2059
  annotations: {
@@ -2086,8 +2086,8 @@ const operationFactories = {
2086
2086
  title: "Delete a trigger",
2087
2087
  description: "Deletes a branch-local trigger or writes a branch-local tombstone for an inherited trigger so it does not reappear.",
2088
2088
  inputSchema: z.strictObject({
2089
- "project_id": zDeleteProjectBranchTriggerPath.shape.project_id,
2090
- "branch_id": zDeleteProjectBranchTriggerPath.shape.branch_id,
2089
+ "project_id": zDeleteProjectBranchTriggerPath.shape.project_id.describe("Project id."),
2090
+ "branch_id": zDeleteProjectBranchTriggerPath.shape.branch_id.describe("A br-... id, not a name."),
2091
2091
  "trigger_id": zDeleteProjectBranchTriggerPath.shape.trigger_id
2092
2092
  }),
2093
2093
  annotations: {
@@ -2120,7 +2120,7 @@ const operationFactories = {
2120
2120
  title: "Delete compute endpoint",
2121
2121
  description: "Deletes the specified compute endpoint.",
2122
2122
  inputSchema: z.strictObject({
2123
- "project_id": zDeleteProjectEndpointPath.shape.project_id,
2123
+ "project_id": zDeleteProjectEndpointPath.shape.project_id.describe("Project id."),
2124
2124
  "endpoint_id": zDeleteProjectEndpointPath.shape.endpoint_id
2125
2125
  }),
2126
2126
  annotations: {
@@ -2152,7 +2152,7 @@ const operationFactories = {
2152
2152
  title: "Delete JWKS URL",
2153
2153
  description: "Removes the specified JWKS URL from the project.",
2154
2154
  inputSchema: z.strictObject({
2155
- "project_id": zDeleteProjectJwksPath.shape.project_id,
2155
+ "project_id": zDeleteProjectJwksPath.shape.project_id.describe("Project id."),
2156
2156
  "jwks_id": zDeleteProjectJwksPath.shape.jwks_id
2157
2157
  }),
2158
2158
  annotations: {
@@ -2184,7 +2184,7 @@ const operationFactories = {
2184
2184
  title: "Delete VPC endpoint restriction",
2185
2185
  description: "Removes the specified VPC endpoint restriction from a Neon project.",
2186
2186
  inputSchema: z.strictObject({
2187
- "project_id": zDeleteProjectVpcEndpointPath.shape.project_id,
2187
+ "project_id": zDeleteProjectVpcEndpointPath.shape.project_id.describe("Project id."),
2188
2188
  "vpc_endpoint_id": zDeleteProjectVpcEndpointPath.shape.vpc_endpoint_id
2189
2189
  }),
2190
2190
  annotations: {
@@ -2216,7 +2216,7 @@ const operationFactories = {
2216
2216
  title: "Delete snapshot",
2217
2217
  description: "Deletes the specified snapshot.",
2218
2218
  inputSchema: z.strictObject({
2219
- "project_id": zDeleteSnapshotPath.shape.project_id,
2219
+ "project_id": zDeleteSnapshotPath.shape.project_id.describe("Project id."),
2220
2220
  "snapshot_id": zDeleteSnapshotPath.shape.snapshot_id
2221
2221
  }),
2222
2222
  annotations: {
@@ -2248,8 +2248,8 @@ const operationFactories = {
2248
2248
  title: "Disable Neon Auth for the branch",
2249
2249
  description: "Disables the Neon Auth integration for the specified branch, removing the connection to the authentication provider.",
2250
2250
  inputSchema: z.strictObject({
2251
- "project_id": zDisableNeonAuthPath.shape.project_id,
2252
- "branch_id": zDisableNeonAuthPath.shape.branch_id,
2251
+ "project_id": zDisableNeonAuthPath.shape.project_id.describe("Project id."),
2252
+ "branch_id": zDisableNeonAuthPath.shape.branch_id.describe("A br-... id, not a name."),
2253
2253
  "delete_data": zDisableNeonAuthBody.shape.delete_data.optional()
2254
2254
  }),
2255
2255
  annotations: {
@@ -2282,8 +2282,8 @@ const operationFactories = {
2282
2282
  title: "Disable Realtime",
2283
2283
  description: "Disables Realtime for the branch and discards its shared secret.",
2284
2284
  inputSchema: z.strictObject({
2285
- "project_id": zDisableProjectBranchRealtimePath.shape.project_id,
2286
- "branch_id": zDisableProjectBranchRealtimePath.shape.branch_id
2285
+ "project_id": zDisableProjectBranchRealtimePath.shape.project_id.describe("Project id."),
2286
+ "branch_id": zDisableProjectBranchRealtimePath.shape.branch_id.describe("A br-... id, not a name.")
2287
2287
  }),
2288
2288
  annotations: {
2289
2289
  readOnlyHint: false,
@@ -2314,8 +2314,8 @@ const operationFactories = {
2314
2314
  title: "Enable Realtime",
2315
2315
  description: "Enables Realtime for the branch, or applies new options to an enabled branch.",
2316
2316
  inputSchema: z.strictObject({
2317
- "project_id": zEnableProjectBranchRealtimePath.shape.project_id,
2318
- "branch_id": zEnableProjectBranchRealtimePath.shape.branch_id,
2317
+ "project_id": zEnableProjectBranchRealtimePath.shape.project_id.describe("Project id."),
2318
+ "branch_id": zEnableProjectBranchRealtimePath.shape.branch_id.describe("A br-... id, not a name."),
2319
2319
  "allowed_origins": zEnableProjectBranchRealtimeBody.shape.allowed_origins.optional()
2320
2320
  }),
2321
2321
  annotations: {
@@ -2348,8 +2348,8 @@ const operationFactories = {
2348
2348
  title: "Finalize branch restore from snapshot",
2349
2349
  description: "Finalize the restore operation for a branch created from a snapshot.",
2350
2350
  inputSchema: z.strictObject({
2351
- "project_id": zFinalizeRestoreBranchPath.shape.project_id,
2352
- "branch_id": zFinalizeRestoreBranchPath.shape.branch_id,
2351
+ "project_id": zFinalizeRestoreBranchPath.shape.project_id.describe("Project id."),
2352
+ "branch_id": zFinalizeRestoreBranchPath.shape.branch_id.describe("A br-... id, not a name."),
2353
2353
  "name": zFinalizeRestoreBranchBody.shape.name.optional()
2354
2354
  }),
2355
2355
  annotations: {
@@ -2407,8 +2407,8 @@ const operationFactories = {
2407
2407
  title: "Retrieve anonymized branch status",
2408
2408
  description: "Retrieves the current status of an anonymized branch, including its state and progress information.",
2409
2409
  inputSchema: z.strictObject({
2410
- "project_id": zGetAnonymizedBranchStatusPath.shape.project_id,
2411
- "branch_id": zGetAnonymizedBranchStatusPath.shape.branch_id
2410
+ "project_id": zGetAnonymizedBranchStatusPath.shape.project_id.describe("Project id."),
2411
+ "branch_id": zGetAnonymizedBranchStatusPath.shape.branch_id.describe("A br-... id, not a name.")
2412
2412
  }),
2413
2413
  annotations: {
2414
2414
  readOnlyHint: true,
@@ -2461,7 +2461,7 @@ const operationFactories = {
2461
2461
  id: "get_available_preload_libraries",
2462
2462
  title: "List available shared preload libraries",
2463
2463
  description: "Returns the shared preload libraries available for the specified project's Postgres version.",
2464
- inputSchema: z.strictObject({ "project_id": zGetAvailablePreloadLibrariesPath.shape.project_id }),
2464
+ inputSchema: z.strictObject({ "project_id": zGetAvailablePreloadLibrariesPath.shape.project_id.describe("Project id.") }),
2465
2465
  annotations: {
2466
2466
  readOnlyHint: true,
2467
2467
  openWorldHint: false
@@ -2487,7 +2487,7 @@ const operationFactories = {
2487
2487
  title: "Retrieve connection URI",
2488
2488
  description: "Retrieves a connection URI for the specified database.",
2489
2489
  inputSchema: z.strictObject({
2490
- "project_id": zGetConnectionUriPath.shape.project_id,
2490
+ "project_id": zGetConnectionUriPath.shape.project_id.describe("Project id."),
2491
2491
  "branch_id": zGetConnectionUriQuery.shape.branch_id,
2492
2492
  "endpoint_id": zGetConnectionUriQuery.shape.endpoint_id,
2493
2493
  "database_name": zGetConnectionUriQuery.shape.database_name,
@@ -2530,11 +2530,11 @@ const operationFactories = {
2530
2530
  "limit": zGetConsumptionHistoryPerBranchV2Query.shape.limit,
2531
2531
  "project_ids": zGetConsumptionHistoryPerBranchV2Query.shape.project_ids,
2532
2532
  "branch_ids": zGetConsumptionHistoryPerBranchV2Query.shape.branch_ids,
2533
- "from": zGetConsumptionHistoryPerBranchV2Query.shape.from,
2534
- "to": zGetConsumptionHistoryPerBranchV2Query.shape.to,
2535
- "granularity": zGetConsumptionHistoryPerBranchV2Query.shape.granularity,
2536
- "org_id": zGetConsumptionHistoryPerBranchV2Query.shape.org_id,
2537
- "metrics": zGetConsumptionHistoryPerBranchV2Query.shape.metrics
2533
+ "from": zGetConsumptionHistoryPerBranchV2Query.shape.from.describe("Period start, rounded to granularity."),
2534
+ "to": zGetConsumptionHistoryPerBranchV2Query.shape.to.describe("Period end, rounded to granularity."),
2535
+ "granularity": zGetConsumptionHistoryPerBranchV2Query.shape.granularity.describe("hourly reaches back 168 hours, daily 60 days, monthly one year."),
2536
+ "org_id": zGetConsumptionHistoryPerBranchV2Query.shape.org_id.describe("Organization id from {{user.organizations}}."),
2537
+ "metrics": zGetConsumptionHistoryPerBranchV2Query.shape.metrics.describe("Metric names from the tool description; any other returns HTTP 400. extra_branches_month and snapshot_storage_bytes_month are only on {{consumption.perProjectV2}}.")
2538
2538
  }),
2539
2539
  annotations: {
2540
2540
  readOnlyHint: true,
@@ -2574,11 +2574,11 @@ const operationFactories = {
2574
2574
  "cursor": zGetConsumptionHistoryPerProjectQuery.shape.cursor,
2575
2575
  "limit": zGetConsumptionHistoryPerProjectQuery.shape.limit,
2576
2576
  "project_ids": zGetConsumptionHistoryPerProjectQuery.shape.project_ids,
2577
- "from": zGetConsumptionHistoryPerProjectQuery.shape.from,
2578
- "to": zGetConsumptionHistoryPerProjectQuery.shape.to,
2577
+ "from": zGetConsumptionHistoryPerProjectQuery.shape.from.describe("Period start, rounded to granularity."),
2578
+ "to": zGetConsumptionHistoryPerProjectQuery.shape.to.describe("Period end, rounded to granularity."),
2579
2579
  "granularity": zGetConsumptionHistoryPerProjectQuery.shape.granularity,
2580
2580
  "org_id": zGetConsumptionHistoryPerProjectQuery.shape.org_id,
2581
- "include_v1_metrics": zGetConsumptionHistoryPerProjectQuery.shape.include_v1_metrics,
2581
+ "include_v1_metrics": zGetConsumptionHistoryPerProjectQuery.shape.include_v1_metrics.describe("Deprecated; has no effect."),
2582
2582
  "metrics": zGetConsumptionHistoryPerProjectQuery.shape.metrics
2583
2583
  }),
2584
2584
  annotations: {
@@ -2618,12 +2618,12 @@ const operationFactories = {
2618
2618
  inputSchema: z.strictObject({
2619
2619
  "cursor": zGetConsumptionHistoryPerProjectV2Query.shape.cursor,
2620
2620
  "limit": zGetConsumptionHistoryPerProjectV2Query.shape.limit,
2621
- "project_ids": zGetConsumptionHistoryPerProjectV2Query.shape.project_ids,
2622
- "from": zGetConsumptionHistoryPerProjectV2Query.shape.from,
2623
- "to": zGetConsumptionHistoryPerProjectV2Query.shape.to,
2624
- "granularity": zGetConsumptionHistoryPerProjectV2Query.shape.granularity,
2625
- "org_id": zGetConsumptionHistoryPerProjectV2Query.shape.org_id,
2626
- "metrics": zGetConsumptionHistoryPerProjectV2Query.shape.metrics
2621
+ "project_ids": zGetConsumptionHistoryPerProjectV2Query.shape.project_ids.describe("Up to 100 project ids. Omit for every project with history in the organization, including deleted ones."),
2622
+ "from": zGetConsumptionHistoryPerProjectV2Query.shape.from.describe("Period start, rounded to granularity."),
2623
+ "to": zGetConsumptionHistoryPerProjectV2Query.shape.to.describe("Period end, rounded to granularity."),
2624
+ "granularity": zGetConsumptionHistoryPerProjectV2Query.shape.granularity.describe("hourly reaches back 168 hours, daily 60 days, monthly one year."),
2625
+ "org_id": zGetConsumptionHistoryPerProjectV2Query.shape.org_id.describe("Organization id from {{user.organizations}}."),
2626
+ "metrics": zGetConsumptionHistoryPerProjectV2Query.shape.metrics.describe("Metric names from the tool description. An unknown name returns no data rather than an error.")
2627
2627
  }),
2628
2628
  annotations: {
2629
2629
  readOnlyHint: true,
@@ -2707,8 +2707,8 @@ const operationFactories = {
2707
2707
  title: "Retrieve masking rules",
2708
2708
  description: "Retrieves the masking rules for the specified anonymized branch.",
2709
2709
  inputSchema: z.strictObject({
2710
- "project_id": zGetMaskingRulesPath.shape.project_id,
2711
- "branch_id": zGetMaskingRulesPath.shape.branch_id
2710
+ "project_id": zGetMaskingRulesPath.shape.project_id.describe("Project id."),
2711
+ "branch_id": zGetMaskingRulesPath.shape.branch_id.describe("A br-... id, not a name.")
2712
2712
  }),
2713
2713
  annotations: {
2714
2714
  readOnlyHint: true,
@@ -2738,8 +2738,8 @@ const operationFactories = {
2738
2738
  title: "Retrieve Neon Auth details for the branch",
2739
2739
  description: "Retrieves the Neon Auth integration details for the specified branch, including the auth provider type and integration status.",
2740
2740
  inputSchema: z.strictObject({
2741
- "project_id": zGetNeonAuthPath.shape.project_id,
2742
- "branch_id": zGetNeonAuthPath.shape.branch_id
2741
+ "project_id": zGetNeonAuthPath.shape.project_id.describe("Project id."),
2742
+ "branch_id": zGetNeonAuthPath.shape.branch_id.describe("A br-... id, not a name.")
2743
2743
  }),
2744
2744
  annotations: {
2745
2745
  readOnlyHint: true,
@@ -2769,8 +2769,8 @@ const operationFactories = {
2769
2769
  title: "Retrieve localhost allow setting",
2770
2770
  description: "Retrieves the localhost allow setting for the specified branch's Neon Auth integration.",
2771
2771
  inputSchema: z.strictObject({
2772
- "project_id": zGetNeonAuthAllowLocalhostPath.shape.project_id,
2773
- "branch_id": zGetNeonAuthAllowLocalhostPath.shape.branch_id
2772
+ "project_id": zGetNeonAuthAllowLocalhostPath.shape.project_id.describe("Project id."),
2773
+ "branch_id": zGetNeonAuthAllowLocalhostPath.shape.branch_id.describe("A br-... id, not a name.")
2774
2774
  }),
2775
2775
  annotations: {
2776
2776
  readOnlyHint: true,
@@ -2800,8 +2800,8 @@ const operationFactories = {
2800
2800
  title: "Retrieve email and password configuration",
2801
2801
  description: "Retrieves the email and password authentication configuration for the specified branch's Neon Auth integration, including whether it is enabled and the email verification method.",
2802
2802
  inputSchema: z.strictObject({
2803
- "project_id": zGetNeonAuthEmailAndPasswordConfigPath.shape.project_id,
2804
- "branch_id": zGetNeonAuthEmailAndPasswordConfigPath.shape.branch_id
2803
+ "project_id": zGetNeonAuthEmailAndPasswordConfigPath.shape.project_id.describe("Project id."),
2804
+ "branch_id": zGetNeonAuthEmailAndPasswordConfigPath.shape.branch_id.describe("A br-... id, not a name.")
2805
2805
  }),
2806
2806
  annotations: {
2807
2807
  readOnlyHint: true,
@@ -2831,8 +2831,8 @@ const operationFactories = {
2831
2831
  title: "Retrieve email provider configuration",
2832
2832
  description: "Retrieves the email provider configuration for the specified branch's Neon Auth integration, including the provider type and server settings.",
2833
2833
  inputSchema: z.strictObject({
2834
- "project_id": zGetNeonAuthEmailProviderPath.shape.project_id,
2835
- "branch_id": zGetNeonAuthEmailProviderPath.shape.branch_id
2834
+ "project_id": zGetNeonAuthEmailProviderPath.shape.project_id.describe("Project id."),
2835
+ "branch_id": zGetNeonAuthEmailProviderPath.shape.branch_id.describe("A br-... id, not a name.")
2836
2836
  }),
2837
2837
  annotations: {
2838
2838
  readOnlyHint: true,
@@ -2861,7 +2861,7 @@ const operationFactories = {
2861
2861
  id: "get_neon_auth_email_server",
2862
2862
  title: "Retrieve email server configuration",
2863
2863
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/email_provider` instead.",
2864
- inputSchema: z.strictObject({ "project_id": zGetNeonAuthEmailServerPath.shape.project_id }),
2864
+ inputSchema: z.strictObject({ "project_id": zGetNeonAuthEmailServerPath.shape.project_id.describe("Project id.") }),
2865
2865
  annotations: {
2866
2866
  readOnlyHint: true,
2867
2867
  openWorldHint: false
@@ -2887,8 +2887,8 @@ const operationFactories = {
2887
2887
  title: "Retrieve an OAuth client",
2888
2888
  description: "Returns an OAuth client registered with the branch's Neon Auth OAuth provider.",
2889
2889
  inputSchema: z.strictObject({
2890
- "project_id": zGetNeonAuthOAuthClientPath.shape.project_id,
2891
- "branch_id": zGetNeonAuthOAuthClientPath.shape.branch_id,
2890
+ "project_id": zGetNeonAuthOAuthClientPath.shape.project_id.describe("Project id."),
2891
+ "branch_id": zGetNeonAuthOAuthClientPath.shape.branch_id.describe("A br-... id, not a name."),
2892
2892
  "client_id": zGetNeonAuthOAuthClientPath.shape.client_id
2893
2893
  }),
2894
2894
  annotations: {
@@ -2920,8 +2920,8 @@ const operationFactories = {
2920
2920
  title: "Retrieve OAuth provider plugin configuration",
2921
2921
  description: "Returns the OAuth provider plugin configuration for Neon Auth.",
2922
2922
  inputSchema: z.strictObject({
2923
- "project_id": zGetNeonAuthOAuthProviderPluginPath.shape.project_id,
2924
- "branch_id": zGetNeonAuthOAuthProviderPluginPath.shape.branch_id
2923
+ "project_id": zGetNeonAuthOAuthProviderPluginPath.shape.project_id.describe("Project id."),
2924
+ "branch_id": zGetNeonAuthOAuthProviderPluginPath.shape.branch_id.describe("A br-... id, not a name.")
2925
2925
  }),
2926
2926
  annotations: {
2927
2927
  readOnlyHint: true,
@@ -2951,8 +2951,8 @@ const operationFactories = {
2951
2951
  title: "Retrieve phone number plugin configuration",
2952
2952
  description: "Returns the phone number plugin configuration for Neon Auth.",
2953
2953
  inputSchema: z.strictObject({
2954
- "project_id": zGetNeonAuthPhoneNumberPluginPath.shape.project_id,
2955
- "branch_id": zGetNeonAuthPhoneNumberPluginPath.shape.branch_id
2954
+ "project_id": zGetNeonAuthPhoneNumberPluginPath.shape.project_id.describe("Project id."),
2955
+ "branch_id": zGetNeonAuthPhoneNumberPluginPath.shape.branch_id.describe("A br-... id, not a name.")
2956
2956
  }),
2957
2957
  annotations: {
2958
2958
  readOnlyHint: true,
@@ -2982,8 +2982,8 @@ const operationFactories = {
2982
2982
  title: "Retrieve Neon Auth plugin configurations",
2983
2983
  description: "Returns all plugin configurations for Neon Auth in a single response.",
2984
2984
  inputSchema: z.strictObject({
2985
- "project_id": zGetNeonAuthPluginConfigsPath.shape.project_id,
2986
- "branch_id": zGetNeonAuthPluginConfigsPath.shape.branch_id
2985
+ "project_id": zGetNeonAuthPluginConfigsPath.shape.project_id.describe("Project id."),
2986
+ "branch_id": zGetNeonAuthPluginConfigsPath.shape.branch_id.describe("A br-... id, not a name.")
2987
2987
  }),
2988
2988
  annotations: {
2989
2989
  readOnlyHint: true,
@@ -3013,8 +3013,8 @@ const operationFactories = {
3013
3013
  title: "Retrieve Neon Auth webhook configuration",
3014
3014
  description: "Returns the webhook configuration for the specified branch's Neon Auth integration, including the endpoint URL and the events that trigger it.",
3015
3015
  inputSchema: z.strictObject({
3016
- "project_id": zGetNeonAuthWebhookConfigPath.shape.project_id,
3017
- "branch_id": zGetNeonAuthWebhookConfigPath.shape.branch_id
3016
+ "project_id": zGetNeonAuthWebhookConfigPath.shape.project_id.describe("Project id."),
3017
+ "branch_id": zGetNeonAuthWebhookConfigPath.shape.branch_id.describe("A br-... id, not a name.")
3018
3018
  }),
3019
3019
  annotations: {
3020
3020
  readOnlyHint: true,
@@ -3043,7 +3043,7 @@ const operationFactories = {
3043
3043
  id: "get_organization",
3044
3044
  title: "Retrieve organization details",
3045
3045
  description: "Retrieves details for the specified organization, including its name, plan, and configuration.",
3046
- inputSchema: z.strictObject({ "org_id": zGetOrganizationPath.shape.org_id }),
3046
+ inputSchema: z.strictObject({ "org_id": zGetOrganizationPath.shape.org_id.describe("Organization id.") }),
3047
3047
  annotations: {
3048
3048
  readOnlyHint: true,
3049
3049
  openWorldHint: false
@@ -3068,7 +3068,7 @@ const operationFactories = {
3068
3068
  id: "get_organization_invitations",
3069
3069
  title: "List organization invitations",
3070
3070
  description: "Retrieves pending and accepted invitations for the specified organization.",
3071
- inputSchema: z.strictObject({ "org_id": zGetOrganizationInvitationsPath.shape.org_id }),
3071
+ inputSchema: z.strictObject({ "org_id": zGetOrganizationInvitationsPath.shape.org_id.describe("Organization id.") }),
3072
3072
  annotations: {
3073
3073
  readOnlyHint: true,
3074
3074
  openWorldHint: false
@@ -3094,7 +3094,7 @@ const operationFactories = {
3094
3094
  title: "Retrieve organization member details",
3095
3095
  description: "Retrieves information about the specified organization member.",
3096
3096
  inputSchema: z.strictObject({
3097
- "org_id": zGetOrganizationMemberPath.shape.org_id,
3097
+ "org_id": zGetOrganizationMemberPath.shape.org_id.describe("Organization id."),
3098
3098
  "member_id": zGetOrganizationMemberPath.shape.member_id
3099
3099
  }),
3100
3100
  annotations: {
@@ -3125,7 +3125,7 @@ const operationFactories = {
3125
3125
  title: "List organization members",
3126
3126
  description: "Retrieves a paginated list of members for the specified organization.",
3127
3127
  inputSchema: z.strictObject({
3128
- "org_id": zGetOrganizationMembersPath.shape.org_id,
3128
+ "org_id": zGetOrganizationMembersPath.shape.org_id.describe("Organization id."),
3129
3129
  "sort_by": zGetOrganizationMembersQuery.shape.sort_by.optional(),
3130
3130
  "cursor": zGetOrganizationMembersQuery.shape.cursor.optional(),
3131
3131
  "sort_order": zGetOrganizationMembersQuery.shape.sort_order.optional(),
@@ -3161,7 +3161,7 @@ const operationFactories = {
3161
3161
  id: "get_organization_spending_limit",
3162
3162
  title: "Retrieve organization spending limit",
3163
3163
  description: "Returns the configured monthly spending limit for the specified organization.",
3164
- inputSchema: z.strictObject({ "org_id": zGetOrganizationSpendingLimitPath.shape.org_id }),
3164
+ inputSchema: z.strictObject({ "org_id": zGetOrganizationSpendingLimitPath.shape.org_id.describe("Organization id.") }),
3165
3165
  annotations: {
3166
3166
  readOnlyHint: true,
3167
3167
  openWorldHint: false
@@ -3187,7 +3187,7 @@ const operationFactories = {
3187
3187
  title: "Retrieve VPC endpoint details",
3188
3188
  description: "Retrieves the current state and configuration details of a specified VPC endpoint.",
3189
3189
  inputSchema: z.strictObject({
3190
- "org_id": zGetOrganizationVpcEndpointDetailsPath.shape.org_id,
3190
+ "org_id": zGetOrganizationVpcEndpointDetailsPath.shape.org_id.describe("Organization id."),
3191
3191
  "region_id": zGetOrganizationVpcEndpointDetailsPath.shape.region_id,
3192
3192
  "vpc_endpoint_id": zGetOrganizationVpcEndpointDetailsPath.shape.vpc_endpoint_id
3193
3193
  }),
@@ -3219,7 +3219,7 @@ const operationFactories = {
3219
3219
  id: "get_project",
3220
3220
  title: "Retrieve project details",
3221
3221
  description: "Retrieves information about the specified project.",
3222
- inputSchema: z.strictObject({ "project_id": zGetProjectPath.shape.project_id }),
3222
+ inputSchema: z.strictObject({ "project_id": zGetProjectPath.shape.project_id.describe("Project id.") }),
3223
3223
  annotations: {
3224
3224
  readOnlyHint: true,
3225
3225
  openWorldHint: false
@@ -3245,7 +3245,7 @@ const operationFactories = {
3245
3245
  title: "Get advisor issues",
3246
3246
  description: "Analyzes the database for security and performance issues.",
3247
3247
  inputSchema: z.strictObject({
3248
- "project_id": zGetProjectAdvisorSecurityIssuesPath.shape.project_id,
3248
+ "project_id": zGetProjectAdvisorSecurityIssuesPath.shape.project_id.describe("Project id."),
3249
3249
  "branch_id": zGetProjectAdvisorSecurityIssuesQuery.shape.branch_id.optional(),
3250
3250
  "database_name": zGetProjectAdvisorSecurityIssuesQuery.shape.database_name.optional(),
3251
3251
  "category": zGetProjectAdvisorSecurityIssuesQuery.shape.category.optional(),
@@ -3282,8 +3282,8 @@ const operationFactories = {
3282
3282
  title: "Retrieve branch details",
3283
3283
  description: "Retrieves information about the specified branch.",
3284
3284
  inputSchema: z.strictObject({
3285
- "project_id": zGetProjectBranchPath.shape.project_id,
3286
- "branch_id": zGetProjectBranchPath.shape.branch_id
3285
+ "project_id": zGetProjectBranchPath.shape.project_id.describe("Project id."),
3286
+ "branch_id": zGetProjectBranchPath.shape.branch_id.describe("A br-... id, not a name.")
3287
3287
  }),
3288
3288
  annotations: {
3289
3289
  readOnlyHint: true,
@@ -3313,8 +3313,8 @@ const operationFactories = {
3313
3313
  title: "Get branch AI Gateway endpoint",
3314
3314
  description: "Returns the AI Gateway endpoint host for the specified branch, used to render code-snippet base URLs.",
3315
3315
  inputSchema: z.strictObject({
3316
- "project_id": zGetProjectBranchAiGatewayPath.shape.project_id,
3317
- "branch_id": zGetProjectBranchAiGatewayPath.shape.branch_id
3316
+ "project_id": zGetProjectBranchAiGatewayPath.shape.project_id.describe("Project id."),
3317
+ "branch_id": zGetProjectBranchAiGatewayPath.shape.branch_id.describe("A br-... id, not a name.")
3318
3318
  }),
3319
3319
  annotations: {
3320
3320
  readOnlyHint: true,
@@ -3344,8 +3344,8 @@ const operationFactories = {
3344
3344
  title: "Download an object's bytes",
3345
3345
  description: "Streams the raw bytes of the named object from the bucket on the specified branch, including objects inherited from ancestor branches.",
3346
3346
  inputSchema: z.strictObject({
3347
- "project_id": zGetProjectBranchBucketObjectPath.shape.project_id,
3348
- "branch_id": zGetProjectBranchBucketObjectPath.shape.branch_id,
3347
+ "project_id": zGetProjectBranchBucketObjectPath.shape.project_id.describe("Project id."),
3348
+ "branch_id": zGetProjectBranchBucketObjectPath.shape.branch_id.describe("A br-... id, not a name."),
3349
3349
  "bucket_name": zGetProjectBranchBucketObjectPath.shape.bucket_name,
3350
3350
  "object_key": zGetProjectBranchBucketObjectPath.shape.object_key
3351
3351
  }),
@@ -3379,8 +3379,8 @@ const operationFactories = {
3379
3379
  title: "Retrieve Neon Data API configuration",
3380
3380
  description: "Retrieves the Neon Data API configuration for the specified branch, including endpoint URL, enabled state, and database settings.",
3381
3381
  inputSchema: z.strictObject({
3382
- "project_id": zGetProjectBranchDataApiPath.shape.project_id,
3383
- "branch_id": zGetProjectBranchDataApiPath.shape.branch_id,
3382
+ "project_id": zGetProjectBranchDataApiPath.shape.project_id.describe("Project id."),
3383
+ "branch_id": zGetProjectBranchDataApiPath.shape.branch_id.describe("A br-... id, not a name."),
3384
3384
  "database_name": zGetProjectBranchDataApiPath.shape.database_name
3385
3385
  }),
3386
3386
  annotations: {
@@ -3412,8 +3412,8 @@ const operationFactories = {
3412
3412
  title: "Retrieve database details",
3413
3413
  description: "Retrieves information about the specified database.",
3414
3414
  inputSchema: z.strictObject({
3415
- "project_id": zGetProjectBranchDatabasePath.shape.project_id,
3416
- "branch_id": zGetProjectBranchDatabasePath.shape.branch_id,
3415
+ "project_id": zGetProjectBranchDatabasePath.shape.project_id.describe("Project id."),
3416
+ "branch_id": zGetProjectBranchDatabasePath.shape.branch_id.describe("A br-... id, not a name."),
3417
3417
  "database_name": zGetProjectBranchDatabasePath.shape.database_name
3418
3418
  }),
3419
3419
  annotations: {
@@ -3445,8 +3445,8 @@ const operationFactories = {
3445
3445
  title: "Get function details",
3446
3446
  description: "Returns the function identified by its slug.",
3447
3447
  inputSchema: z.strictObject({
3448
- "project_id": zGetProjectBranchFunctionPath.shape.project_id,
3449
- "branch_id": zGetProjectBranchFunctionPath.shape.branch_id,
3448
+ "project_id": zGetProjectBranchFunctionPath.shape.project_id.describe("Project id."),
3449
+ "branch_id": zGetProjectBranchFunctionPath.shape.branch_id.describe("A br-... id, not a name."),
3450
3450
  "slug": zGetProjectBranchFunctionPath.shape.slug
3451
3451
  }),
3452
3452
  annotations: {
@@ -3478,8 +3478,8 @@ const operationFactories = {
3478
3478
  title: "Retrieve Realtime state",
3479
3479
  description: "Retrieves whether Realtime is enabled for the branch, whether a change is still being applied, and, once provisioned, its invocation URL and allowed origins.",
3480
3480
  inputSchema: z.strictObject({
3481
- "project_id": zGetProjectBranchRealtimePath.shape.project_id,
3482
- "branch_id": zGetProjectBranchRealtimePath.shape.branch_id
3481
+ "project_id": zGetProjectBranchRealtimePath.shape.project_id.describe("Project id."),
3482
+ "branch_id": zGetProjectBranchRealtimePath.shape.branch_id.describe("A br-... id, not a name.")
3483
3483
  }),
3484
3484
  annotations: {
3485
3485
  readOnlyHint: true,
@@ -3509,8 +3509,8 @@ const operationFactories = {
3509
3509
  title: "Retrieve the Realtime shared secret",
3510
3510
  description: "Retrieves the secret the application backend issues Realtime tokens with.",
3511
3511
  inputSchema: z.strictObject({
3512
- "project_id": zGetProjectBranchRealtimeSecretPath.shape.project_id,
3513
- "branch_id": zGetProjectBranchRealtimeSecretPath.shape.branch_id
3512
+ "project_id": zGetProjectBranchRealtimeSecretPath.shape.project_id.describe("Project id."),
3513
+ "branch_id": zGetProjectBranchRealtimeSecretPath.shape.branch_id.describe("A br-... id, not a name.")
3514
3514
  }),
3515
3515
  annotations: {
3516
3516
  readOnlyHint: true,
@@ -3540,8 +3540,8 @@ const operationFactories = {
3540
3540
  title: "Retrieve role details",
3541
3541
  description: "Retrieves details about the specified role.",
3542
3542
  inputSchema: z.strictObject({
3543
- "project_id": zGetProjectBranchRolePath.shape.project_id,
3544
- "branch_id": zGetProjectBranchRolePath.shape.branch_id,
3543
+ "project_id": zGetProjectBranchRolePath.shape.project_id.describe("Project id."),
3544
+ "branch_id": zGetProjectBranchRolePath.shape.branch_id.describe("A br-... id, not a name."),
3545
3545
  "role_name": zGetProjectBranchRolePath.shape.role_name
3546
3546
  }),
3547
3547
  annotations: {
@@ -3573,8 +3573,8 @@ const operationFactories = {
3573
3573
  title: "Retrieve role password",
3574
3574
  description: "Retrieves the password for the specified Postgres role, if possible.",
3575
3575
  inputSchema: z.strictObject({
3576
- "project_id": zGetProjectBranchRolePasswordPath.shape.project_id,
3577
- "branch_id": zGetProjectBranchRolePasswordPath.shape.branch_id,
3576
+ "project_id": zGetProjectBranchRolePasswordPath.shape.project_id.describe("Project id."),
3577
+ "branch_id": zGetProjectBranchRolePasswordPath.shape.branch_id.describe("A br-... id, not a name."),
3578
3578
  "role_name": zGetProjectBranchRolePasswordPath.shape.role_name
3579
3579
  }),
3580
3580
  annotations: {
@@ -3606,8 +3606,8 @@ const operationFactories = {
3606
3606
  title: "Retrieve database schema",
3607
3607
  description: "Retrieves the database schema.",
3608
3608
  inputSchema: z.strictObject({
3609
- "project_id": zGetProjectBranchSchemaPath.shape.project_id,
3610
- "branch_id": zGetProjectBranchSchemaPath.shape.branch_id,
3609
+ "project_id": zGetProjectBranchSchemaPath.shape.project_id.describe("Project id."),
3610
+ "branch_id": zGetProjectBranchSchemaPath.shape.branch_id.describe("A br-... id, not a name."),
3611
3611
  "db_name": zGetProjectBranchSchemaQuery.shape.db_name,
3612
3612
  "lsn": zGetProjectBranchSchemaQuery.shape.lsn,
3613
3613
  "timestamp": zGetProjectBranchSchemaQuery.shape.timestamp,
@@ -3647,8 +3647,8 @@ const operationFactories = {
3647
3647
  title: "Compare database schema",
3648
3648
  description: "Compares the schema from the specified database with another branch's schema.",
3649
3649
  inputSchema: z.strictObject({
3650
- "project_id": zGetProjectBranchSchemaComparisonPath.shape.project_id,
3651
- "branch_id": zGetProjectBranchSchemaComparisonPath.shape.branch_id,
3650
+ "project_id": zGetProjectBranchSchemaComparisonPath.shape.project_id.describe("Project id."),
3651
+ "branch_id": zGetProjectBranchSchemaComparisonPath.shape.branch_id.describe("A br-... id, not a name."),
3652
3652
  "base_branch_id": zGetProjectBranchSchemaComparisonQuery.shape.base_branch_id,
3653
3653
  "db_name": zGetProjectBranchSchemaComparisonQuery.shape.db_name,
3654
3654
  "lsn": zGetProjectBranchSchemaComparisonQuery.shape.lsn,
@@ -3692,8 +3692,8 @@ const operationFactories = {
3692
3692
  title: "Get branch object storage state",
3693
3693
  description: "Returns whether branchable object storage is usable for the specified branch.",
3694
3694
  inputSchema: z.strictObject({
3695
- "project_id": zGetProjectBranchStoragePath.shape.project_id,
3696
- "branch_id": zGetProjectBranchStoragePath.shape.branch_id
3695
+ "project_id": zGetProjectBranchStoragePath.shape.project_id.describe("Project id."),
3696
+ "branch_id": zGetProjectBranchStoragePath.shape.branch_id.describe("A br-... id, not a name.")
3697
3697
  }),
3698
3698
  annotations: {
3699
3699
  readOnlyHint: true,
@@ -3723,8 +3723,8 @@ const operationFactories = {
3723
3723
  title: "Get a trigger",
3724
3724
  description: "Returns the trigger visible on the branch.",
3725
3725
  inputSchema: z.strictObject({
3726
- "project_id": zGetProjectBranchTriggerPath.shape.project_id,
3727
- "branch_id": zGetProjectBranchTriggerPath.shape.branch_id,
3726
+ "project_id": zGetProjectBranchTriggerPath.shape.project_id.describe("Project id."),
3727
+ "branch_id": zGetProjectBranchTriggerPath.shape.branch_id.describe("A br-... id, not a name."),
3728
3728
  "trigger_id": zGetProjectBranchTriggerPath.shape.trigger_id
3729
3729
  }),
3730
3730
  annotations: {
@@ -3756,7 +3756,7 @@ const operationFactories = {
3756
3756
  title: "Retrieve compute endpoint details",
3757
3757
  description: "Retrieves information about the specified compute endpoint.",
3758
3758
  inputSchema: z.strictObject({
3759
- "project_id": zGetProjectEndpointPath.shape.project_id,
3759
+ "project_id": zGetProjectEndpointPath.shape.project_id.describe("Project id."),
3760
3760
  "endpoint_id": zGetProjectEndpointPath.shape.endpoint_id
3761
3761
  }),
3762
3762
  annotations: {
@@ -3786,7 +3786,7 @@ const operationFactories = {
3786
3786
  id: "get_project_jwks",
3787
3787
  title: "List JWKS URLs",
3788
3788
  description: "Returns the JWKS URLs available for verifying JWTs used as the authentication mechanism for the specified project.",
3789
- inputSchema: z.strictObject({ "project_id": zGetProjectJwksPath.shape.project_id }),
3789
+ inputSchema: z.strictObject({ "project_id": zGetProjectJwksPath.shape.project_id.describe("Project id.") }),
3790
3790
  annotations: {
3791
3791
  readOnlyHint: true,
3792
3792
  openWorldHint: false
@@ -3812,7 +3812,7 @@ const operationFactories = {
3812
3812
  title: "Retrieve operation details",
3813
3813
  description: "Retrieves details for the specified operation.",
3814
3814
  inputSchema: z.strictObject({
3815
- "project_id": zGetProjectOperationPath.shape.project_id,
3815
+ "project_id": zGetProjectOperationPath.shape.project_id.describe("Project id."),
3816
3816
  "operation_id": zGetProjectOperationPath.shape.operation_id
3817
3817
  }),
3818
3818
  annotations: {
@@ -3843,8 +3843,8 @@ const operationFactories = {
3843
3843
  title: "Retrieve backup schedule",
3844
3844
  description: "Returns the backup schedule for the specified branch, including the configured snapshot frequencies.",
3845
3845
  inputSchema: z.strictObject({
3846
- "project_id": zGetSnapshotSchedulePath.shape.project_id,
3847
- "branch_id": zGetSnapshotSchedulePath.shape.branch_id
3846
+ "project_id": zGetSnapshotSchedulePath.shape.project_id.describe("Project id."),
3847
+ "branch_id": zGetSnapshotSchedulePath.shape.branch_id.describe("A br-... id, not a name.")
3848
3848
  }),
3849
3849
  annotations: {
3850
3850
  readOnlyHint: true,
@@ -3874,7 +3874,7 @@ const operationFactories = {
3874
3874
  title: "Grant project access",
3875
3875
  description: "Grants project access to the account associated with the specified email address.",
3876
3876
  inputSchema: z.strictObject({
3877
- "project_id": zGrantPermissionToProjectPath.shape.project_id.describe("The Neon project ID"),
3877
+ "project_id": zGrantPermissionToProjectPath.shape.project_id.describe("Project id."),
3878
3878
  "email": zGrantPermissionToProjectBody.shape.email
3879
3879
  }),
3880
3880
  annotations: {
@@ -3928,8 +3928,8 @@ const operationFactories = {
3928
3928
  title: "List OAuth providers for the branch",
3929
3929
  description: "Lists the OAuth providers configured for the specified branch's Neon Auth integration.",
3930
3930
  inputSchema: z.strictObject({
3931
- "project_id": zListBranchNeonAuthOauthProvidersPath.shape.project_id,
3932
- "branch_id": zListBranchNeonAuthOauthProvidersPath.shape.branch_id
3931
+ "project_id": zListBranchNeonAuthOauthProvidersPath.shape.project_id.describe("Project id."),
3932
+ "branch_id": zListBranchNeonAuthOauthProvidersPath.shape.branch_id.describe("A br-... id, not a name.")
3933
3933
  }),
3934
3934
  annotations: {
3935
3935
  readOnlyHint: true,
@@ -3959,8 +3959,8 @@ const operationFactories = {
3959
3959
  title: "List domains in redirect_uri whitelist",
3960
3960
  description: "Lists the trusted domains in the redirect URI whitelist for the specified branch.",
3961
3961
  inputSchema: z.strictObject({
3962
- "project_id": zListBranchNeonAuthTrustedDomainsPath.shape.project_id,
3963
- "branch_id": zListBranchNeonAuthTrustedDomainsPath.shape.branch_id
3962
+ "project_id": zListBranchNeonAuthTrustedDomainsPath.shape.project_id.describe("Project id."),
3963
+ "branch_id": zListBranchNeonAuthTrustedDomainsPath.shape.branch_id.describe("A br-... id, not a name.")
3964
3964
  }),
3965
3965
  annotations: {
3966
3966
  readOnlyHint: true,
@@ -3990,8 +3990,8 @@ const operationFactories = {
3990
3990
  title: "List credentials on the branch",
3991
3991
  description: "Returns metadata for customer-issued credentials on the branch.",
3992
3992
  inputSchema: z.strictObject({
3993
- "project_id": zListCredentialsPath.shape.project_id,
3994
- "branch_id": zListCredentialsPath.shape.branch_id
3993
+ "project_id": zListCredentialsPath.shape.project_id.describe("Project id."),
3994
+ "branch_id": zListCredentialsPath.shape.branch_id.describe("A br-... id, not a name.")
3995
3995
  }),
3996
3996
  annotations: {
3997
3997
  readOnlyHint: true,
@@ -4020,7 +4020,7 @@ const operationFactories = {
4020
4020
  id: "list_neon_auth_integrations",
4021
4021
  title: "List active integrations with auth providers",
4022
4022
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth` instead.",
4023
- inputSchema: z.strictObject({ "project_id": zListNeonAuthIntegrationsPath.shape.project_id }),
4023
+ inputSchema: z.strictObject({ "project_id": zListNeonAuthIntegrationsPath.shape.project_id.describe("Project id.") }),
4024
4024
  annotations: {
4025
4025
  readOnlyHint: true,
4026
4026
  openWorldHint: false
@@ -4046,8 +4046,8 @@ const operationFactories = {
4046
4046
  title: "List OAuth clients",
4047
4047
  description: "Lists the OAuth clients registered for the branch's Neon Auth OAuth provider.",
4048
4048
  inputSchema: z.strictObject({
4049
- "project_id": zListNeonAuthOAuthClientsPath.shape.project_id,
4050
- "branch_id": zListNeonAuthOAuthClientsPath.shape.branch_id
4049
+ "project_id": zListNeonAuthOAuthClientsPath.shape.project_id.describe("Project id."),
4050
+ "branch_id": zListNeonAuthOAuthClientsPath.shape.branch_id.describe("A br-... id, not a name.")
4051
4051
  }),
4052
4052
  annotations: {
4053
4053
  readOnlyHint: true,
@@ -4076,7 +4076,7 @@ const operationFactories = {
4076
4076
  id: "list_neon_auth_oauth_providers",
4077
4077
  title: "List OAuth providers",
4078
4078
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/oauth_providers` instead.",
4079
- inputSchema: z.strictObject({ "project_id": zListNeonAuthOauthProvidersPath.shape.project_id }),
4079
+ inputSchema: z.strictObject({ "project_id": zListNeonAuthOauthProvidersPath.shape.project_id.describe("Project id.") }),
4080
4080
  annotations: {
4081
4081
  readOnlyHint: true,
4082
4082
  openWorldHint: false
@@ -4101,7 +4101,7 @@ const operationFactories = {
4101
4101
  id: "list_neon_auth_redirect_uri_whitelist_domains",
4102
4102
  title: "List trusted redirect URI domains",
4103
4103
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/domains` instead.",
4104
- inputSchema: z.strictObject({ "project_id": zListNeonAuthRedirectUriWhitelistDomainsPath.shape.project_id }),
4104
+ inputSchema: z.strictObject({ "project_id": zListNeonAuthRedirectUriWhitelistDomainsPath.shape.project_id.describe("Project id.") }),
4105
4105
  annotations: {
4106
4106
  readOnlyHint: true,
4107
4107
  openWorldHint: false
@@ -4127,7 +4127,7 @@ const operationFactories = {
4127
4127
  title: "List VPC endpoints",
4128
4128
  description: "Retrieves the list of VPC endpoints for the specified Neon organization.",
4129
4129
  inputSchema: z.strictObject({
4130
- "org_id": zListOrganizationVpcEndpointsPath.shape.org_id,
4130
+ "org_id": zListOrganizationVpcEndpointsPath.shape.org_id.describe("Organization id."),
4131
4131
  "region_id": zListOrganizationVpcEndpointsPath.shape.region_id
4132
4132
  }),
4133
4133
  annotations: {
@@ -4157,7 +4157,7 @@ const operationFactories = {
4157
4157
  id: "list_organization_vpc_endpoints_all_regions",
4158
4158
  title: "List VPC endpoints across all regions",
4159
4159
  description: "Retrieves the list of VPC endpoints for the specified Neon organization across all regions.",
4160
- inputSchema: z.strictObject({ "org_id": zListOrganizationVpcEndpointsAllRegionsPath.shape.org_id }),
4160
+ inputSchema: z.strictObject({ "org_id": zListOrganizationVpcEndpointsAllRegionsPath.shape.org_id.describe("Organization id.") }),
4161
4161
  annotations: {
4162
4162
  readOnlyHint: true,
4163
4163
  openWorldHint: false
@@ -4182,7 +4182,7 @@ const operationFactories = {
4182
4182
  id: "list_org_api_keys",
4183
4183
  title: "List organization API keys",
4184
4184
  description: "Retrieves the API keys for the specified organization.",
4185
- inputSchema: z.strictObject({ "org_id": zListOrgApiKeysPath.shape.org_id }),
4185
+ inputSchema: z.strictObject({ "org_id": zListOrgApiKeysPath.shape.org_id.describe("Organization id.") }),
4186
4186
  annotations: {
4187
4187
  readOnlyHint: true,
4188
4188
  openWorldHint: false
@@ -4208,11 +4208,11 @@ const operationFactories = {
4208
4208
  title: "List objects in a bucket",
4209
4209
  description: "Lists objects visible in the named bucket on the specified branch, including those inherited from ancestor branches.",
4210
4210
  inputSchema: z.strictObject({
4211
- "project_id": zListProjectBranchBucketObjectsPath.shape.project_id,
4212
- "branch_id": zListProjectBranchBucketObjectsPath.shape.branch_id,
4211
+ "project_id": zListProjectBranchBucketObjectsPath.shape.project_id.describe("Project id."),
4212
+ "branch_id": zListProjectBranchBucketObjectsPath.shape.branch_id.describe("A br-... id, not a name."),
4213
4213
  "bucket_name": zListProjectBranchBucketObjectsPath.shape.bucket_name,
4214
4214
  "prefix": zListProjectBranchBucketObjectsQuery.shape.prefix.optional(),
4215
- "delimiter": zListProjectBranchBucketObjectsQuery.shape.delimiter.optional(),
4215
+ "delimiter": zListProjectBranchBucketObjectsQuery.shape.delimiter.describe("Groups keys up to this delimiter, usually /, into folders.").optional(),
4216
4216
  "cursor": zListProjectBranchBucketObjectsQuery.shape.cursor.optional(),
4217
4217
  "limit": zListProjectBranchBucketObjectsQuery.shape.limit.optional()
4218
4218
  }),
@@ -4251,8 +4251,8 @@ const operationFactories = {
4251
4251
  title: "List buckets on the branch",
4252
4252
  description: "Lists branchable object storage buckets visible on the specified branch, including those inherited from ancestor branches.",
4253
4253
  inputSchema: z.strictObject({
4254
- "project_id": zListProjectBranchBucketsPath.shape.project_id,
4255
- "branch_id": zListProjectBranchBucketsPath.shape.branch_id
4254
+ "project_id": zListProjectBranchBucketsPath.shape.project_id.describe("Project id."),
4255
+ "branch_id": zListProjectBranchBucketsPath.shape.branch_id.describe("A br-... id, not a name.")
4256
4256
  }),
4257
4257
  annotations: {
4258
4258
  readOnlyHint: true,
@@ -4282,8 +4282,8 @@ const operationFactories = {
4282
4282
  title: "List the custom domains on a branch",
4283
4283
  description: "Lists all custom domains registered on the branch, across every target entity.",
4284
4284
  inputSchema: z.strictObject({
4285
- "project_id": zListProjectBranchCustomDomainsPath.shape.project_id,
4286
- "branch_id": zListProjectBranchCustomDomainsPath.shape.branch_id,
4285
+ "project_id": zListProjectBranchCustomDomainsPath.shape.project_id.describe("Project id."),
4286
+ "branch_id": zListProjectBranchCustomDomainsPath.shape.branch_id.describe("A br-... id, not a name."),
4287
4287
  "cursor": zListProjectBranchCustomDomainsQuery.shape.cursor.optional(),
4288
4288
  "limit": zListProjectBranchCustomDomainsQuery.shape.limit.optional()
4289
4289
  }),
@@ -4319,8 +4319,8 @@ const operationFactories = {
4319
4319
  title: "List databases",
4320
4320
  description: "Retrieves a list of databases for the specified branch.",
4321
4321
  inputSchema: z.strictObject({
4322
- "project_id": zListProjectBranchDatabasesPath.shape.project_id,
4323
- "branch_id": zListProjectBranchDatabasesPath.shape.branch_id
4322
+ "project_id": zListProjectBranchDatabasesPath.shape.project_id.describe("Project id."),
4323
+ "branch_id": zListProjectBranchDatabasesPath.shape.branch_id.describe("A br-... id, not a name.")
4324
4324
  }),
4325
4325
  annotations: {
4326
4326
  readOnlyHint: true,
@@ -4350,8 +4350,8 @@ const operationFactories = {
4350
4350
  title: "List branch endpoints",
4351
4351
  description: "Retrieves a list of compute endpoints for the specified branch.",
4352
4352
  inputSchema: z.strictObject({
4353
- "project_id": zListProjectBranchEndpointsPath.shape.project_id,
4354
- "branch_id": zListProjectBranchEndpointsPath.shape.branch_id
4353
+ "project_id": zListProjectBranchEndpointsPath.shape.project_id.describe("Project id."),
4354
+ "branch_id": zListProjectBranchEndpointsPath.shape.branch_id.describe("A br-... id, not a name.")
4355
4355
  }),
4356
4356
  annotations: {
4357
4357
  readOnlyHint: true,
@@ -4381,7 +4381,7 @@ const operationFactories = {
4381
4381
  title: "List branches",
4382
4382
  description: "Retrieves a list of branches for the specified project.",
4383
4383
  inputSchema: z.strictObject({
4384
- "project_id": zListProjectBranchesPath.shape.project_id,
4384
+ "project_id": zListProjectBranchesPath.shape.project_id.describe("Project id."),
4385
4385
  "search": zListProjectBranchesQuery.shape.search.optional(),
4386
4386
  "sort_by": zListProjectBranchesQuery.shape.sort_by.optional(),
4387
4387
  "cursor": zListProjectBranchesQuery.shape.cursor.optional(),
@@ -4422,8 +4422,8 @@ const operationFactories = {
4422
4422
  title: "List functions on the branch",
4423
4423
  description: "Lists functions on the specified branch.",
4424
4424
  inputSchema: z.strictObject({
4425
- "project_id": zListProjectBranchFunctionsPath.shape.project_id,
4426
- "branch_id": zListProjectBranchFunctionsPath.shape.branch_id,
4425
+ "project_id": zListProjectBranchFunctionsPath.shape.project_id.describe("Project id."),
4426
+ "branch_id": zListProjectBranchFunctionsPath.shape.branch_id.describe("A br-... id, not a name."),
4427
4427
  "cursor": zListProjectBranchFunctionsQuery.shape.cursor.optional(),
4428
4428
  "limit": zListProjectBranchFunctionsQuery.shape.limit.optional()
4429
4429
  }),
@@ -4459,8 +4459,8 @@ const operationFactories = {
4459
4459
  title: "List branch log fields",
4460
4460
  description: "Lists the low-cardinality log fields observed on this branch whose distinct values can be discovered with the log field-values endpoint.",
4461
4461
  inputSchema: z.strictObject({
4462
- "project_id": zListProjectBranchLogFieldsPath.shape.project_id,
4463
- "branch_id": zListProjectBranchLogFieldsPath.shape.branch_id
4462
+ "project_id": zListProjectBranchLogFieldsPath.shape.project_id.describe("Project id."),
4463
+ "branch_id": zListProjectBranchLogFieldsPath.shape.branch_id.describe("A br-... id, not a name.")
4464
4464
  }),
4465
4465
  annotations: {
4466
4466
  readOnlyHint: true,
@@ -4490,9 +4490,9 @@ const operationFactories = {
4490
4490
  title: "List branch log field values",
4491
4491
  description: "Lists the distinct values observed for a low-cardinality log field in the requested time range.",
4492
4492
  inputSchema: z.strictObject({
4493
- "project_id": zListProjectBranchLogFieldValuesPath.shape.project_id,
4494
- "branch_id": zListProjectBranchLogFieldValuesPath.shape.branch_id,
4495
- "field_name": zListProjectBranchLogFieldValuesPath.shape.field_name,
4493
+ "project_id": zListProjectBranchLogFieldValuesPath.shape.project_id.describe("Project id."),
4494
+ "branch_id": zListProjectBranchLogFieldValuesPath.shape.branch_id.describe("A br-... id, not a name."),
4495
+ "field_name": zListProjectBranchLogFieldValuesPath.shape.field_name.describe("A field name from {{logs.fields}}."),
4496
4496
  "since": zListProjectBranchLogFieldValuesQuery.shape.since.optional(),
4497
4497
  "start_time": zListProjectBranchLogFieldValuesQuery.shape.start_time.optional(),
4498
4498
  "end_time": zListProjectBranchLogFieldValuesQuery.shape.end_time.optional(),
@@ -4535,8 +4535,8 @@ const operationFactories = {
4535
4535
  title: "List roles",
4536
4536
  description: "Retrieves a list of Postgres roles from the specified branch.",
4537
4537
  inputSchema: z.strictObject({
4538
- "project_id": zListProjectBranchRolesPath.shape.project_id,
4539
- "branch_id": zListProjectBranchRolesPath.shape.branch_id
4538
+ "project_id": zListProjectBranchRolesPath.shape.project_id.describe("Project id."),
4539
+ "branch_id": zListProjectBranchRolesPath.shape.branch_id.describe("A br-... id, not a name.")
4540
4540
  }),
4541
4541
  annotations: {
4542
4542
  readOnlyHint: true,
@@ -4566,8 +4566,8 @@ const operationFactories = {
4566
4566
  title: "List triggers on the branch",
4567
4567
  description: "Lists the complete project-bounded set of triggers visible on the branch, ordered by `trigger_id`.",
4568
4568
  inputSchema: z.strictObject({
4569
- "project_id": zListProjectBranchTriggersPath.shape.project_id,
4570
- "branch_id": zListProjectBranchTriggersPath.shape.branch_id
4569
+ "project_id": zListProjectBranchTriggersPath.shape.project_id.describe("Project id."),
4570
+ "branch_id": zListProjectBranchTriggersPath.shape.branch_id.describe("A br-... id, not a name.")
4571
4571
  }),
4572
4572
  annotations: {
4573
4573
  readOnlyHint: true,
@@ -4596,7 +4596,7 @@ const operationFactories = {
4596
4596
  id: "list_project_endpoints",
4597
4597
  title: "List compute endpoints",
4598
4598
  description: "Retrieves a list of compute endpoints for the specified project.",
4599
- inputSchema: z.strictObject({ "project_id": zListProjectEndpointsPath.shape.project_id }),
4599
+ inputSchema: z.strictObject({ "project_id": zListProjectEndpointsPath.shape.project_id.describe("Project id.") }),
4600
4600
  annotations: {
4601
4601
  readOnlyHint: true,
4602
4602
  openWorldHint: false
@@ -4622,7 +4622,7 @@ const operationFactories = {
4622
4622
  title: "List org members and their project roles",
4623
4623
  description: "Lists organization members and their per-project roles for an org-owned project.",
4624
4624
  inputSchema: z.strictObject({
4625
- "project_id": zListProjectMembersPath.shape.project_id.describe("The Neon project ID"),
4625
+ "project_id": zListProjectMembersPath.shape.project_id.describe("Project id."),
4626
4626
  "cursor": zListProjectMembersQuery.shape.cursor.optional(),
4627
4627
  "limit": zListProjectMembersQuery.shape.limit.optional()
4628
4628
  }),
@@ -4655,7 +4655,7 @@ const operationFactories = {
4655
4655
  title: "List operations",
4656
4656
  description: "Retrieves a list of operations for the specified Neon project.",
4657
4657
  inputSchema: z.strictObject({
4658
- "project_id": zListProjectOperationsPath.shape.project_id,
4658
+ "project_id": zListProjectOperationsPath.shape.project_id.describe("Project id."),
4659
4659
  "cursor": zListProjectOperationsQuery.shape.cursor.optional(),
4660
4660
  "limit": zListProjectOperationsQuery.shape.limit.optional()
4661
4661
  }),
@@ -4687,7 +4687,7 @@ const operationFactories = {
4687
4687
  id: "list_project_permissions",
4688
4688
  title: "List project access",
4689
4689
  description: "Retrieves details about users who have access to the project, including the permission `id`, the granted-to email address, and the date project access was granted.",
4690
- inputSchema: z.strictObject({ "project_id": zListProjectPermissionsPath.shape.project_id.describe("The Neon project ID") }),
4690
+ inputSchema: z.strictObject({ "project_id": zListProjectPermissionsPath.shape.project_id.describe("Project id.") }),
4691
4691
  annotations: {
4692
4692
  readOnlyHint: true,
4693
4693
  openWorldHint: false
@@ -4716,7 +4716,7 @@ const operationFactories = {
4716
4716
  "cursor": zListProjectsQuery.shape.cursor.optional(),
4717
4717
  "limit": zListProjectsQuery.shape.limit.optional(),
4718
4718
  "search": zListProjectsQuery.shape.search.optional(),
4719
- "org_id": zListProjectsQuery.shape.org_id.optional(),
4719
+ "org_id": zListProjectsQuery.shape.org_id.describe("Organization id from {{user.organizations}}; required with a personal API key.").optional(),
4720
4720
  "timeout": zListProjectsQuery.shape.timeout.optional(),
4721
4721
  "recoverable": zListProjectsQuery.shape.recoverable.optional()
4722
4722
  }),
@@ -4751,7 +4751,7 @@ const operationFactories = {
4751
4751
  id: "list_project_vpc_endpoints",
4752
4752
  title: "List VPC endpoint restrictions",
4753
4753
  description: "Lists VPC endpoint restrictions for the specified Neon project.",
4754
- inputSchema: z.strictObject({ "project_id": zListProjectVpcEndpointsPath.shape.project_id }),
4754
+ inputSchema: z.strictObject({ "project_id": zListProjectVpcEndpointsPath.shape.project_id.describe("Project id.") }),
4755
4755
  annotations: {
4756
4756
  readOnlyHint: true,
4757
4757
  openWorldHint: false
@@ -4811,7 +4811,7 @@ const operationFactories = {
4811
4811
  id: "list_snapshots",
4812
4812
  title: "List project snapshots",
4813
4813
  description: "Lists the snapshots for the specified project.",
4814
- inputSchema: z.strictObject({ "project_id": zListSnapshotsPath.shape.project_id }),
4814
+ inputSchema: z.strictObject({ "project_id": zListSnapshotsPath.shape.project_id.describe("Project id.") }),
4815
4815
  annotations: {
4816
4816
  readOnlyHint: true,
4817
4817
  openWorldHint: false
@@ -4837,8 +4837,8 @@ const operationFactories = {
4837
4837
  title: "Presign an upload or download for an object in a bucket",
4838
4838
  description: "Returns a presigned URL that transfers bytes directly to or from the object's bucket on the specified branch, without the caller ever handling S3 credentials.",
4839
4839
  inputSchema: z.strictObject({
4840
- "project_id": zPresignProjectBranchBucketObjectPath.shape.project_id,
4841
- "branch_id": zPresignProjectBranchBucketObjectPath.shape.branch_id,
4840
+ "project_id": zPresignProjectBranchBucketObjectPath.shape.project_id.describe("Project id."),
4841
+ "branch_id": zPresignProjectBranchBucketObjectPath.shape.branch_id.describe("A br-... id, not a name."),
4842
4842
  "bucket_name": zPresignProjectBranchBucketObjectPath.shape.bucket_name,
4843
4843
  "object_key": zPresignProjectBranchBucketObjectPath.shape.object_key,
4844
4844
  "operation": zPresignProjectBranchBucketObjectBody.shape.operation,
@@ -4881,8 +4881,8 @@ const operationFactories = {
4881
4881
  title: "Query branch logs",
4882
4882
  description: "Returns logs emitted by services running on the specified branch, ordered by timestamp according to `sort_order`.",
4883
4883
  inputSchema: z.strictObject({
4884
- "project_id": zQueryProjectBranchLogsPath.shape.project_id,
4885
- "branch_id": zQueryProjectBranchLogsPath.shape.branch_id,
4884
+ "project_id": zQueryProjectBranchLogsPath.shape.project_id.describe("Project id."),
4885
+ "branch_id": zQueryProjectBranchLogsPath.shape.branch_id.describe("A br-... id, not a name."),
4886
4886
  "since": zQueryProjectBranchLogsBody.shape.since,
4887
4887
  "start_time": zQueryProjectBranchLogsBody.shape.start_time,
4888
4888
  "end_time": zQueryProjectBranchLogsBody.shape.end_time,
@@ -4942,7 +4942,7 @@ const operationFactories = {
4942
4942
  id: "recover_project",
4943
4943
  title: "Recover a deleted project",
4944
4944
  description: "Recovers a deleted project within the 7-day deletion recovery period.",
4945
- inputSchema: z.strictObject({ "project_id": zRecoverProjectPath.shape.project_id }),
4945
+ inputSchema: z.strictObject({ "project_id": zRecoverProjectPath.shape.project_id.describe("Project id.") }),
4946
4946
  annotations: {
4947
4947
  readOnlyHint: false,
4948
4948
  destructiveHint: true,
@@ -4969,11 +4969,11 @@ const operationFactories = {
4969
4969
  title: "Register a custom domain on a branch",
4970
4970
  description: "Registers a customer-owned domain (for example `dashboard.acme.com`) on the branch and points it at a target entity, chosen by `entity_type` + `entity_id`.",
4971
4971
  inputSchema: z.strictObject({
4972
- "project_id": zRegisterProjectBranchCustomDomainPath.shape.project_id,
4973
- "branch_id": zRegisterProjectBranchCustomDomainPath.shape.branch_id,
4972
+ "project_id": zRegisterProjectBranchCustomDomainPath.shape.project_id.describe("Project id."),
4973
+ "branch_id": zRegisterProjectBranchCustomDomainPath.shape.branch_id.describe("A br-... id, not a name."),
4974
4974
  "domain": zRegisterProjectBranchCustomDomainBody.shape.domain,
4975
4975
  "entity_type": zRegisterProjectBranchCustomDomainBody.shape.entity_type,
4976
- "entity_id": zRegisterProjectBranchCustomDomainBody.shape.entity_id
4976
+ "entity_id": zRegisterProjectBranchCustomDomainBody.shape.entity_id.describe("The function slug from {{functions.list}}.")
4977
4977
  }),
4978
4978
  annotations: {
4979
4979
  readOnlyHint: false,
@@ -5009,7 +5009,7 @@ const operationFactories = {
5009
5009
  title: "Remove organization member",
5010
5010
  description: "Removes the specified member from the organization.",
5011
5011
  inputSchema: z.strictObject({
5012
- "org_id": zRemoveOrganizationMemberPath.shape.org_id,
5012
+ "org_id": zRemoveOrganizationMemberPath.shape.org_id.describe("Organization id."),
5013
5013
  "member_id": zRemoveOrganizationMemberPath.shape.member_id
5014
5014
  }),
5015
5015
  annotations: {
@@ -5041,7 +5041,7 @@ const operationFactories = {
5041
5041
  title: "Remove an org member's role on a project",
5042
5042
  description: "Idempotently removes the explicit project grant.",
5043
5043
  inputSchema: z.strictObject({
5044
- "project_id": zRemoveProjectMemberRolePath.shape.project_id.describe("The Neon project ID"),
5044
+ "project_id": zRemoveProjectMemberRolePath.shape.project_id.describe("Project id."),
5045
5045
  "member_id": zRemoveProjectMemberRolePath.shape.member_id.describe("The organization member ID"),
5046
5046
  "confirm_self_lockout": zRemoveProjectMemberRoleQuery.shape.confirm_self_lockout.describe("Set true to remove your own grant when you would lose manage access.").optional()
5047
5047
  }),
@@ -5075,8 +5075,8 @@ const operationFactories = {
5075
5075
  title: "Reset role password",
5076
5076
  description: "Resets the password for the specified Postgres role.",
5077
5077
  inputSchema: z.strictObject({
5078
- "project_id": zResetProjectBranchRolePasswordPath.shape.project_id,
5079
- "branch_id": zResetProjectBranchRolePasswordPath.shape.branch_id,
5078
+ "project_id": zResetProjectBranchRolePasswordPath.shape.project_id.describe("Project id."),
5079
+ "branch_id": zResetProjectBranchRolePasswordPath.shape.branch_id.describe("A br-... id, not a name."),
5080
5080
  "role_name": zResetProjectBranchRolePasswordPath.shape.role_name
5081
5081
  }),
5082
5082
  annotations: {
@@ -5109,7 +5109,7 @@ const operationFactories = {
5109
5109
  title: "Restart compute endpoint",
5110
5110
  description: "Restarts the specified compute endpoint by immediately suspending it and then starting it again.",
5111
5111
  inputSchema: z.strictObject({
5112
- "project_id": zRestartProjectEndpointPath.shape.project_id,
5112
+ "project_id": zRestartProjectEndpointPath.shape.project_id.describe("Project id."),
5113
5113
  "endpoint_id": zRestartProjectEndpointPath.shape.endpoint_id
5114
5114
  }),
5115
5115
  annotations: {
@@ -5141,8 +5141,8 @@ const operationFactories = {
5141
5141
  title: "Restore branch to a historical state",
5142
5142
  description: "Restores a branch to an earlier state in its own or another branch's history by specifying an LSN or timestamp.",
5143
5143
  inputSchema: z.strictObject({
5144
- "project_id": zRestoreProjectBranchPath.shape.project_id,
5145
- "branch_id": zRestoreProjectBranchPath.shape.branch_id,
5144
+ "project_id": zRestoreProjectBranchPath.shape.project_id.describe("Project id."),
5145
+ "branch_id": zRestoreProjectBranchPath.shape.branch_id.describe("A br-... id, not a name."),
5146
5146
  "source_branch_id": zRestoreProjectBranchBody.shape.source_branch_id,
5147
5147
  "source_lsn": zRestoreProjectBranchBody.shape.source_lsn,
5148
5148
  "source_timestamp": zRestoreProjectBranchBody.shape.source_timestamp,
@@ -5183,7 +5183,7 @@ const operationFactories = {
5183
5183
  title: "Restore snapshot",
5184
5184
  description: "Restores the specified snapshot to a new branch, and optionally finalizes the restore operation to replace the original branch.",
5185
5185
  inputSchema: z.strictObject({
5186
- "project_id": zRestoreSnapshotPath.shape.project_id,
5186
+ "project_id": zRestoreSnapshotPath.shape.project_id.describe("Project id."),
5187
5187
  "snapshot_id": zRestoreSnapshotPath.shape.snapshot_id,
5188
5188
  "name": zRestoreSnapshotBody.shape.name.optional(),
5189
5189
  "target_branch_id": zRestoreSnapshotBody.shape.target_branch_id.optional(),
@@ -5223,8 +5223,8 @@ const operationFactories = {
5223
5223
  title: "Reveal a credential's secrets",
5224
5224
  description: "Returns the live `api_token` and `s3_secret_access_key` of an existing credential, so a credential whose issuance response was lost can be recovered without minting a new one.",
5225
5225
  inputSchema: z.strictObject({
5226
- "project_id": zRevealCredentialPath.shape.project_id,
5227
- "branch_id": zRevealCredentialPath.shape.branch_id,
5226
+ "project_id": zRevealCredentialPath.shape.project_id.describe("Project id."),
5227
+ "branch_id": zRevealCredentialPath.shape.branch_id.describe("A br-... id, not a name."),
5228
5228
  "token_id": zRevealCredentialPath.shape.token_id
5229
5229
  }),
5230
5230
  annotations: {
@@ -5283,8 +5283,8 @@ const operationFactories = {
5283
5283
  title: "Revoke a credential",
5284
5284
  description: "Soft-deletes the credential.",
5285
5285
  inputSchema: z.strictObject({
5286
- "project_id": zRevokeCredentialPath.shape.project_id,
5287
- "branch_id": zRevokeCredentialPath.shape.branch_id,
5286
+ "project_id": zRevokeCredentialPath.shape.project_id.describe("Project id."),
5287
+ "branch_id": zRevokeCredentialPath.shape.branch_id.describe("A br-... id, not a name."),
5288
5288
  "token_id": zRevokeCredentialPath.shape.token_id
5289
5289
  }),
5290
5290
  annotations: {
@@ -5317,7 +5317,7 @@ const operationFactories = {
5317
5317
  title: "Revoke organization API key",
5318
5318
  description: "Revokes the specified organization API key.",
5319
5319
  inputSchema: z.strictObject({
5320
- "org_id": zRevokeOrgApiKeyPath.shape.org_id,
5320
+ "org_id": zRevokeOrgApiKeyPath.shape.org_id.describe("Organization id."),
5321
5321
  "key_id": zRevokeOrgApiKeyPath.shape.key_id
5322
5322
  }),
5323
5323
  annotations: {
@@ -5349,8 +5349,8 @@ const operationFactories = {
5349
5349
  title: "Revoke project access",
5350
5350
  description: "Revokes project access from the user associated with the specified permission `id`.",
5351
5351
  inputSchema: z.strictObject({
5352
- "project_id": zRevokePermissionFromProjectPath.shape.project_id.describe("The Neon project ID"),
5353
- "permission_id": zRevokePermissionFromProjectPath.shape.permission_id.describe("The permission `id` from listing project access.")
5352
+ "project_id": zRevokePermissionFromProjectPath.shape.project_id.describe("Project id."),
5353
+ "permission_id": zRevokePermissionFromProjectPath.shape.permission_id.describe("The permission id from {{projects.permissions.list}}.")
5354
5354
  }),
5355
5355
  annotations: {
5356
5356
  readOnlyHint: false,
@@ -5381,8 +5381,8 @@ const operationFactories = {
5381
5381
  title: "Rotate a credential's secrets",
5382
5382
  description: "Replaces the secret material on an existing scoped credential in place.",
5383
5383
  inputSchema: z.strictObject({
5384
- "project_id": zRotateCredentialPath.shape.project_id,
5385
- "branch_id": zRotateCredentialPath.shape.branch_id,
5384
+ "project_id": zRotateCredentialPath.shape.project_id.describe("Project id."),
5385
+ "branch_id": zRotateCredentialPath.shape.branch_id.describe("A br-... id, not a name."),
5386
5386
  "token_id": zRotateCredentialPath.shape.token_id
5387
5387
  }),
5388
5388
  annotations: {
@@ -5415,8 +5415,8 @@ const operationFactories = {
5415
5415
  title: "Rotate an OAuth client secret",
5416
5416
  description: "Generates a new secret for a confidential OAuth client and invalidates the previous one.",
5417
5417
  inputSchema: z.strictObject({
5418
- "project_id": zRotateNeonAuthOAuthClientSecretPath.shape.project_id,
5419
- "branch_id": zRotateNeonAuthOAuthClientSecretPath.shape.branch_id,
5418
+ "project_id": zRotateNeonAuthOAuthClientSecretPath.shape.project_id.describe("Project id."),
5419
+ "branch_id": zRotateNeonAuthOAuthClientSecretPath.shape.branch_id.describe("A br-... id, not a name."),
5420
5420
  "client_id": zRotateNeonAuthOAuthClientSecretPath.shape.client_id
5421
5421
  }),
5422
5422
  annotations: {
@@ -5449,8 +5449,8 @@ const operationFactories = {
5449
5449
  title: "Rotate the Realtime shared secret",
5450
5450
  description: "Replaces the branch's Realtime shared secret.",
5451
5451
  inputSchema: z.strictObject({
5452
- "project_id": zRotateProjectBranchRealtimeSecretPath.shape.project_id,
5453
- "branch_id": zRotateProjectBranchRealtimeSecretPath.shape.branch_id
5452
+ "project_id": zRotateProjectBranchRealtimeSecretPath.shape.project_id.describe("Project id."),
5453
+ "branch_id": zRotateProjectBranchRealtimeSecretPath.shape.branch_id.describe("A br-... id, not a name.")
5454
5454
  }),
5455
5455
  annotations: {
5456
5456
  readOnlyHint: false,
@@ -5481,8 +5481,8 @@ const operationFactories = {
5481
5481
  title: "Send test email using the saved email provider",
5482
5482
  description: "Sends a test email using the branch's already-saved custom SMTP configuration.",
5483
5483
  inputSchema: z.strictObject({
5484
- "project_id": zSendNeonAuthEmailProviderTestPath.shape.project_id,
5485
- "branch_id": zSendNeonAuthEmailProviderTestPath.shape.branch_id,
5484
+ "project_id": zSendNeonAuthEmailProviderTestPath.shape.project_id.describe("Project id."),
5485
+ "branch_id": zSendNeonAuthEmailProviderTestPath.shape.branch_id.describe("A br-... id, not a name."),
5486
5486
  "recipient_email": zSendNeonAuthEmailProviderTestBody.shape.recipient_email
5487
5487
  }),
5488
5488
  annotations: {
@@ -5515,8 +5515,8 @@ const operationFactories = {
5515
5515
  title: "Send test email",
5516
5516
  description: "Sends a test email using the SMTP server settings supplied in the request body to verify connectivity and credentials.",
5517
5517
  inputSchema: z.strictObject({
5518
- "project_id": zSendNeonAuthTestEmailPath.shape.project_id,
5519
- "branch_id": zSendNeonAuthTestEmailPath.shape.branch_id,
5518
+ "project_id": zSendNeonAuthTestEmailPath.shape.project_id.describe("Project id."),
5519
+ "branch_id": zSendNeonAuthTestEmailPath.shape.branch_id.describe("A br-... id, not a name."),
5520
5520
  "host": zSendNeonAuthTestEmailBody.shape.host,
5521
5521
  "port": zSendNeonAuthTestEmailBody.shape.port,
5522
5522
  "username": zSendNeonAuthTestEmailBody.shape.username,
@@ -5563,8 +5563,8 @@ const operationFactories = {
5563
5563
  title: "Set branch as default",
5564
5564
  description: "Sets the specified branch as the project's default branch.",
5565
5565
  inputSchema: z.strictObject({
5566
- "project_id": zSetDefaultProjectBranchPath.shape.project_id,
5567
- "branch_id": zSetDefaultProjectBranchPath.shape.branch_id
5566
+ "project_id": zSetDefaultProjectBranchPath.shape.project_id.describe("Project id."),
5567
+ "branch_id": zSetDefaultProjectBranchPath.shape.branch_id.describe("A br-... id, not a name.")
5568
5568
  }),
5569
5569
  annotations: {
5570
5570
  readOnlyHint: false,
@@ -5595,7 +5595,7 @@ const operationFactories = {
5595
5595
  title: "Set organization spending limit",
5596
5596
  description: "Sets the monthly spending limit for the specified organization.",
5597
5597
  inputSchema: z.strictObject({
5598
- "org_id": zSetOrganizationSpendingLimitPath.shape.org_id,
5598
+ "org_id": zSetOrganizationSpendingLimitPath.shape.org_id.describe("Organization id."),
5599
5599
  "spending_limit_cents": zSetOrganizationSpendingLimitBody.shape.spending_limit_cents
5600
5600
  }),
5601
5601
  annotations: {
@@ -5625,7 +5625,7 @@ const operationFactories = {
5625
5625
  title: "Set an org member's role on a project",
5626
5626
  description: "Idempotently sets or updates the explicit project grant of the specified org member.",
5627
5627
  inputSchema: z.strictObject({
5628
- "project_id": zSetProjectMemberRolePath.shape.project_id.describe("The Neon project ID"),
5628
+ "project_id": zSetProjectMemberRolePath.shape.project_id.describe("Project id."),
5629
5629
  "member_id": zSetProjectMemberRolePath.shape.member_id.describe("The organization member ID"),
5630
5630
  "confirm_self_demotion": zSetProjectMemberRoleQuery.shape.confirm_self_demotion.describe("Set true to lower your own role on the project.").optional(),
5631
5631
  "role": zSetProjectMemberRoleBody.shape.role
@@ -5661,8 +5661,8 @@ const operationFactories = {
5661
5661
  title: "Update backup schedule",
5662
5662
  description: "Updates the backup schedule for the specified branch.",
5663
5663
  inputSchema: z.strictObject({
5664
- "project_id": zSetSnapshotSchedulePath.shape.project_id,
5665
- "branch_id": zSetSnapshotSchedulePath.shape.branch_id,
5664
+ "project_id": zSetSnapshotSchedulePath.shape.project_id.describe("Project id."),
5665
+ "branch_id": zSetSnapshotSchedulePath.shape.branch_id.describe("A br-... id, not a name."),
5666
5666
  "schedule": zSetSnapshotScheduleBody.shape.schedule
5667
5667
  }),
5668
5668
  annotations: {
@@ -5695,8 +5695,8 @@ const operationFactories = {
5695
5695
  title: "Start anonymization",
5696
5696
  description: "Starts the anonymization process for an anonymized branch that is in the initialized, error, or anonymized state.",
5697
5697
  inputSchema: z.strictObject({
5698
- "project_id": zStartAnonymizationPath.shape.project_id,
5699
- "branch_id": zStartAnonymizationPath.shape.branch_id
5698
+ "project_id": zStartAnonymizationPath.shape.project_id.describe("Project id."),
5699
+ "branch_id": zStartAnonymizationPath.shape.branch_id.describe("A br-... id, not a name.")
5700
5700
  }),
5701
5701
  annotations: {
5702
5702
  readOnlyHint: false,
@@ -5727,7 +5727,7 @@ const operationFactories = {
5727
5727
  title: "Start compute endpoint",
5728
5728
  description: "Starts a compute endpoint.",
5729
5729
  inputSchema: z.strictObject({
5730
- "project_id": zStartProjectEndpointPath.shape.project_id,
5730
+ "project_id": zStartProjectEndpointPath.shape.project_id.describe("Project id."),
5731
5731
  "endpoint_id": zStartProjectEndpointPath.shape.endpoint_id
5732
5732
  }),
5733
5733
  annotations: {
@@ -5759,7 +5759,7 @@ const operationFactories = {
5759
5759
  title: "Suspend compute endpoint",
5760
5760
  description: "Suspends the specified compute endpoint.",
5761
5761
  inputSchema: z.strictObject({
5762
- "project_id": zSuspendProjectEndpointPath.shape.project_id,
5762
+ "project_id": zSuspendProjectEndpointPath.shape.project_id.describe("Project id."),
5763
5763
  "endpoint_id": zSuspendProjectEndpointPath.shape.endpoint_id
5764
5764
  }),
5765
5765
  annotations: {
@@ -5889,8 +5889,8 @@ const operationFactories = {
5889
5889
  title: "Update OAuth provider",
5890
5890
  description: "Updates an OAuth provider for the specified project.",
5891
5891
  inputSchema: z.strictObject({
5892
- "project_id": zUpdateBranchNeonAuthOauthProviderPath.shape.project_id,
5893
- "branch_id": zUpdateBranchNeonAuthOauthProviderPath.shape.branch_id,
5892
+ "project_id": zUpdateBranchNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
5893
+ "branch_id": zUpdateBranchNeonAuthOauthProviderPath.shape.branch_id.describe("A br-... id, not a name."),
5894
5894
  "oauth_provider_id": zUpdateBranchNeonAuthOauthProviderPath.shape.oauth_provider_id,
5895
5895
  "client_id": zUpdateBranchNeonAuthOauthProviderBody.shape.client_id,
5896
5896
  "client_secret": zUpdateBranchNeonAuthOauthProviderBody.shape.client_secret,
@@ -5935,8 +5935,8 @@ const operationFactories = {
5935
5935
  title: "Update masking rules",
5936
5936
  description: "Updates the masking rules for the specified anonymized branch.",
5937
5937
  inputSchema: z.strictObject({
5938
- "project_id": zUpdateMaskingRulesPath.shape.project_id,
5939
- "branch_id": zUpdateMaskingRulesPath.shape.branch_id,
5938
+ "project_id": zUpdateMaskingRulesPath.shape.project_id.describe("Project id."),
5939
+ "branch_id": zUpdateMaskingRulesPath.shape.branch_id.describe("A br-... id, not a name."),
5940
5940
  "masking_rules": zUpdateMaskingRulesBody.shape.masking_rules
5941
5941
  }),
5942
5942
  annotations: {
@@ -5969,8 +5969,8 @@ const operationFactories = {
5969
5969
  title: "Update localhost allow setting",
5970
5970
  description: "Updates the localhost allow setting for the specified branch's Neon Auth integration.",
5971
5971
  inputSchema: z.strictObject({
5972
- "project_id": zUpdateNeonAuthAllowLocalhostPath.shape.project_id,
5973
- "branch_id": zUpdateNeonAuthAllowLocalhostPath.shape.branch_id,
5972
+ "project_id": zUpdateNeonAuthAllowLocalhostPath.shape.project_id.describe("Project id."),
5973
+ "branch_id": zUpdateNeonAuthAllowLocalhostPath.shape.branch_id.describe("A br-... id, not a name."),
5974
5974
  "allow_localhost": zUpdateNeonAuthAllowLocalhostBody.shape.allow_localhost
5975
5975
  }),
5976
5976
  annotations: {
@@ -6003,8 +6003,8 @@ const operationFactories = {
6003
6003
  title: "Update auth configuration",
6004
6004
  description: "Updates the auth configuration for the branch.",
6005
6005
  inputSchema: z.strictObject({
6006
- "project_id": zUpdateNeonAuthConfigPath.shape.project_id,
6007
- "branch_id": zUpdateNeonAuthConfigPath.shape.branch_id,
6006
+ "project_id": zUpdateNeonAuthConfigPath.shape.project_id.describe("Project id."),
6007
+ "branch_id": zUpdateNeonAuthConfigPath.shape.branch_id.describe("A br-... id, not a name."),
6008
6008
  "name": zUpdateNeonAuthConfigBody.shape.name
6009
6009
  }),
6010
6010
  annotations: {
@@ -6037,8 +6037,8 @@ const operationFactories = {
6037
6037
  title: "Update email and password configuration",
6038
6038
  description: "Updates the email and password authentication configuration for the specified branch's Neon Auth integration.",
6039
6039
  inputSchema: z.strictObject({
6040
- "project_id": zUpdateNeonAuthEmailAndPasswordConfigPath.shape.project_id,
6041
- "branch_id": zUpdateNeonAuthEmailAndPasswordConfigPath.shape.branch_id,
6040
+ "project_id": zUpdateNeonAuthEmailAndPasswordConfigPath.shape.project_id.describe("Project id."),
6041
+ "branch_id": zUpdateNeonAuthEmailAndPasswordConfigPath.shape.branch_id.describe("A br-... id, not a name."),
6042
6042
  "enabled": zUpdateNeonAuthEmailAndPasswordConfigBody.shape.enabled,
6043
6043
  "email_verification_method": zUpdateNeonAuthEmailAndPasswordConfigBody.shape.email_verification_method,
6044
6044
  "require_email_verification": zUpdateNeonAuthEmailAndPasswordConfigBody.shape.require_email_verification,
@@ -6087,8 +6087,8 @@ const operationFactories = {
6087
6087
  title: "Update email provider configuration",
6088
6088
  description: "Updates the email provider configuration for the specified branch's Neon Auth integration.",
6089
6089
  inputSchema: z.strictObject({
6090
- "project_id": zUpdateNeonAuthEmailProviderPath.shape.project_id,
6091
- "branch_id": zUpdateNeonAuthEmailProviderPath.shape.branch_id,
6090
+ "project_id": zUpdateNeonAuthEmailProviderPath.shape.project_id.describe("Project id."),
6091
+ "branch_id": zUpdateNeonAuthEmailProviderPath.shape.branch_id.describe("A br-... id, not a name."),
6092
6092
  "body": zUpdateNeonAuthEmailProviderBody.describe("Email provider configuration for the branch's Neon Auth integration.")
6093
6093
  }),
6094
6094
  annotations: {
@@ -6121,7 +6121,7 @@ const operationFactories = {
6121
6121
  title: "Update email server configuration",
6122
6122
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/email_provider` instead.",
6123
6123
  inputSchema: z.strictObject({
6124
- "project_id": zUpdateNeonAuthEmailServerPath.shape.project_id,
6124
+ "project_id": zUpdateNeonAuthEmailServerPath.shape.project_id.describe("Project id."),
6125
6125
  "body": zUpdateNeonAuthEmailServerBody
6126
6126
  }),
6127
6127
  annotations: {
@@ -6151,8 +6151,8 @@ const operationFactories = {
6151
6151
  title: "Update Neon Auth logs export setting",
6152
6152
  description: "Enables or disables exporting Neon Auth events for the branch to Neon Platform logs.",
6153
6153
  inputSchema: z.strictObject({
6154
- "project_id": zUpdateNeonAuthLogsExportPath.shape.project_id,
6155
- "branch_id": zUpdateNeonAuthLogsExportPath.shape.branch_id,
6154
+ "project_id": zUpdateNeonAuthLogsExportPath.shape.project_id.describe("Project id."),
6155
+ "branch_id": zUpdateNeonAuthLogsExportPath.shape.branch_id.describe("A br-... id, not a name."),
6156
6156
  "enabled": zUpdateNeonAuthLogsExportBody.shape.enabled
6157
6157
  }),
6158
6158
  annotations: {
@@ -6185,8 +6185,8 @@ const operationFactories = {
6185
6185
  title: "Update magic link plugin configuration",
6186
6186
  description: "Updates the magic link plugin configuration for Neon Auth.",
6187
6187
  inputSchema: z.strictObject({
6188
- "project_id": zUpdateNeonAuthMagicLinkPluginPath.shape.project_id,
6189
- "branch_id": zUpdateNeonAuthMagicLinkPluginPath.shape.branch_id,
6188
+ "project_id": zUpdateNeonAuthMagicLinkPluginPath.shape.project_id.describe("Project id."),
6189
+ "branch_id": zUpdateNeonAuthMagicLinkPluginPath.shape.branch_id.describe("A br-... id, not a name."),
6190
6190
  "enabled": zUpdateNeonAuthMagicLinkPluginBody.shape.enabled,
6191
6191
  "expires_in": zUpdateNeonAuthMagicLinkPluginBody.shape.expires_in,
6192
6192
  "disable_sign_up": zUpdateNeonAuthMagicLinkPluginBody.shape.disable_sign_up
@@ -6225,8 +6225,8 @@ const operationFactories = {
6225
6225
  title: "Update an OAuth client",
6226
6226
  description: "Updates an OAuth client.",
6227
6227
  inputSchema: z.strictObject({
6228
- "project_id": zUpdateNeonAuthOAuthClientPath.shape.project_id,
6229
- "branch_id": zUpdateNeonAuthOAuthClientPath.shape.branch_id,
6228
+ "project_id": zUpdateNeonAuthOAuthClientPath.shape.project_id.describe("Project id."),
6229
+ "branch_id": zUpdateNeonAuthOAuthClientPath.shape.branch_id.describe("A br-... id, not a name."),
6230
6230
  "client_id": zUpdateNeonAuthOAuthClientPath.shape.client_id,
6231
6231
  "name": zUpdateNeonAuthOAuthClientBody.shape.name,
6232
6232
  "redirect_uris": zUpdateNeonAuthOAuthClientBody.shape.redirect_uris,
@@ -6271,7 +6271,7 @@ const operationFactories = {
6271
6271
  title: "Update OAuth provider",
6272
6272
  description: "Deprecated. Use `/projects/{project_id}/branches/{branch_id}/auth/oauth_providers/{oauth_provider_id}` instead.",
6273
6273
  inputSchema: z.strictObject({
6274
- "project_id": zUpdateNeonAuthOauthProviderPath.shape.project_id,
6274
+ "project_id": zUpdateNeonAuthOauthProviderPath.shape.project_id.describe("Project id."),
6275
6275
  "oauth_provider_id": zUpdateNeonAuthOauthProviderPath.shape.oauth_provider_id,
6276
6276
  "client_id": zUpdateNeonAuthOauthProviderBody.shape.client_id,
6277
6277
  "client_secret": zUpdateNeonAuthOauthProviderBody.shape.client_secret,
@@ -6315,8 +6315,8 @@ const operationFactories = {
6315
6315
  title: "Update OAuth provider plugin configuration",
6316
6316
  description: "Updates the OAuth provider plugin configuration for Neon Auth.",
6317
6317
  inputSchema: z.strictObject({
6318
- "project_id": zUpdateNeonAuthOAuthProviderPluginPath.shape.project_id,
6319
- "branch_id": zUpdateNeonAuthOAuthProviderPluginPath.shape.branch_id,
6318
+ "project_id": zUpdateNeonAuthOAuthProviderPluginPath.shape.project_id.describe("Project id."),
6319
+ "branch_id": zUpdateNeonAuthOAuthProviderPluginPath.shape.branch_id.describe("A br-... id, not a name."),
6320
6320
  "enabled": zUpdateNeonAuthOAuthProviderPluginBody.shape.enabled,
6321
6321
  "login_page": zUpdateNeonAuthOAuthProviderPluginBody.shape.login_page,
6322
6322
  "consent_page": zUpdateNeonAuthOAuthProviderPluginBody.shape.consent_page,
@@ -6359,8 +6359,8 @@ const operationFactories = {
6359
6359
  title: "Update organization plugin configuration",
6360
6360
  description: "Updates the organization plugin configuration for Neon Auth.",
6361
6361
  inputSchema: z.strictObject({
6362
- "project_id": zUpdateNeonAuthOrganizationPluginPath.shape.project_id,
6363
- "branch_id": zUpdateNeonAuthOrganizationPluginPath.shape.branch_id,
6362
+ "project_id": zUpdateNeonAuthOrganizationPluginPath.shape.project_id.describe("Project id."),
6363
+ "branch_id": zUpdateNeonAuthOrganizationPluginPath.shape.branch_id.describe("A br-... id, not a name."),
6364
6364
  "enabled": zUpdateNeonAuthOrganizationPluginBody.shape.enabled,
6365
6365
  "organization_limit": zUpdateNeonAuthOrganizationPluginBody.shape.organization_limit,
6366
6366
  "membership_limit": zUpdateNeonAuthOrganizationPluginBody.shape.membership_limit,
@@ -6403,8 +6403,8 @@ const operationFactories = {
6403
6403
  title: "Update phone number plugin configuration",
6404
6404
  description: "Updates the phone number plugin configuration for Neon Auth.",
6405
6405
  inputSchema: z.strictObject({
6406
- "project_id": zUpdateNeonAuthPhoneNumberPluginPath.shape.project_id,
6407
- "branch_id": zUpdateNeonAuthPhoneNumberPluginPath.shape.branch_id,
6406
+ "project_id": zUpdateNeonAuthPhoneNumberPluginPath.shape.project_id.describe("Project id."),
6407
+ "branch_id": zUpdateNeonAuthPhoneNumberPluginPath.shape.branch_id.describe("A br-... id, not a name."),
6408
6408
  "enabled": zUpdateNeonAuthPhoneNumberPluginBody.shape.enabled,
6409
6409
  "otp_expires_in": zUpdateNeonAuthPhoneNumberPluginBody.shape.otp_expires_in
6410
6410
  }),
@@ -6441,8 +6441,8 @@ const operationFactories = {
6441
6441
  title: "Update auth user role",
6442
6442
  description: "Updates the role of a user in the Neon Auth user directory for the specified branch.",
6443
6443
  inputSchema: z.strictObject({
6444
- "project_id": zUpdateNeonAuthUserRolePath.shape.project_id,
6445
- "branch_id": zUpdateNeonAuthUserRolePath.shape.branch_id,
6444
+ "project_id": zUpdateNeonAuthUserRolePath.shape.project_id.describe("Project id."),
6445
+ "branch_id": zUpdateNeonAuthUserRolePath.shape.branch_id.describe("A br-... id, not a name."),
6446
6446
  "auth_user_id": zUpdateNeonAuthUserRolePath.shape.auth_user_id,
6447
6447
  "roles": zUpdateNeonAuthUserRoleBody.shape.roles
6448
6448
  }),
@@ -6477,8 +6477,8 @@ const operationFactories = {
6477
6477
  title: "Update Neon Auth webhook configuration",
6478
6478
  description: "Updates the webhook configuration for the specified branch's Neon Auth integration.",
6479
6479
  inputSchema: z.strictObject({
6480
- "project_id": zUpdateNeonAuthWebhookConfigPath.shape.project_id,
6481
- "branch_id": zUpdateNeonAuthWebhookConfigPath.shape.branch_id,
6480
+ "project_id": zUpdateNeonAuthWebhookConfigPath.shape.project_id.describe("Project id."),
6481
+ "branch_id": zUpdateNeonAuthWebhookConfigPath.shape.branch_id.describe("A br-... id, not a name."),
6482
6482
  "enabled": zUpdateNeonAuthWebhookConfigBody.shape.enabled,
6483
6483
  "webhook_url": zUpdateNeonAuthWebhookConfigBody.shape.webhook_url,
6484
6484
  "enabled_events": zUpdateNeonAuthWebhookConfigBody.shape.enabled_events,
@@ -6519,7 +6519,7 @@ const operationFactories = {
6519
6519
  title: "Update role for organization member",
6520
6520
  description: "Updates the role of an existing member in the specified organization.",
6521
6521
  inputSchema: z.strictObject({
6522
- "org_id": zUpdateOrganizationMemberPath.shape.org_id,
6522
+ "org_id": zUpdateOrganizationMemberPath.shape.org_id.describe("Organization id."),
6523
6523
  "member_id": zUpdateOrganizationMemberPath.shape.member_id,
6524
6524
  "role": zUpdateOrganizationMemberBody.shape.role
6525
6525
  }),
@@ -6553,7 +6553,7 @@ const operationFactories = {
6553
6553
  title: "Update project",
6554
6554
  description: "Updates the specified project.",
6555
6555
  inputSchema: z.strictObject({
6556
- "project_id": zUpdateProjectPath.shape.project_id,
6556
+ "project_id": zUpdateProjectPath.shape.project_id.describe("Project id."),
6557
6557
  "settings": zUpdateProjectBody.shape.project.shape.settings,
6558
6558
  "name": zUpdateProjectBody.shape.project.shape.name,
6559
6559
  "default_endpoint_settings": zUpdateProjectBody.shape.project.shape.default_endpoint_settings,
@@ -6591,8 +6591,8 @@ const operationFactories = {
6591
6591
  title: "Update branch",
6592
6592
  description: "Updates the specified branch.",
6593
6593
  inputSchema: z.strictObject({
6594
- "project_id": zUpdateProjectBranchPath.shape.project_id,
6595
- "branch_id": zUpdateProjectBranchPath.shape.branch_id,
6594
+ "project_id": zUpdateProjectBranchPath.shape.project_id.describe("Project id."),
6595
+ "branch_id": zUpdateProjectBranchPath.shape.branch_id.describe("A br-... id, not a name."),
6596
6596
  "name": zUpdateProjectBranchBody.shape.branch.shape.name,
6597
6597
  "protected": zUpdateProjectBranchBody.shape.branch.shape.protected,
6598
6598
  "expires_at": zUpdateProjectBranchBody.shape.branch.shape.expires_at.describe("The timestamp when the branch is scheduled to expire and be automatically deleted.")
@@ -6631,8 +6631,8 @@ const operationFactories = {
6631
6631
  title: "Update Neon Data API",
6632
6632
  description: "Updates the Neon Data API configuration for the specified branch.",
6633
6633
  inputSchema: z.strictObject({
6634
- "project_id": zUpdateProjectBranchDataApiPath.shape.project_id,
6635
- "branch_id": zUpdateProjectBranchDataApiPath.shape.branch_id,
6634
+ "project_id": zUpdateProjectBranchDataApiPath.shape.project_id.describe("Project id."),
6635
+ "branch_id": zUpdateProjectBranchDataApiPath.shape.branch_id.describe("A br-... id, not a name."),
6636
6636
  "database_name": zUpdateProjectBranchDataApiPath.shape.database_name,
6637
6637
  "db_aggregates_enabled": zUpdateProjectBranchDataApiBody.shape.settings.unwrap().shape["db_aggregates_enabled"].optional(),
6638
6638
  "db_anon_role": zUpdateProjectBranchDataApiBody.shape.settings.unwrap().shape["db_anon_role"].optional(),
@@ -6687,10 +6687,10 @@ const operationFactories = {
6687
6687
  title: "Update database",
6688
6688
  description: "Updates the specified database in the branch.",
6689
6689
  inputSchema: z.strictObject({
6690
- "project_id": zUpdateProjectBranchDatabasePath.shape.project_id,
6691
- "branch_id": zUpdateProjectBranchDatabasePath.shape.branch_id,
6690
+ "project_id": zUpdateProjectBranchDatabasePath.shape.project_id.describe("Project id."),
6691
+ "branch_id": zUpdateProjectBranchDatabasePath.shape.branch_id.describe("A br-... id, not a name."),
6692
6692
  "database_name": zUpdateProjectBranchDatabasePath.shape.database_name,
6693
- "name": zUpdateProjectBranchDatabaseBody.shape.database.shape.name,
6693
+ "name": zUpdateProjectBranchDatabaseBody.shape.database.shape.name.describe("New name for the database."),
6694
6694
  "owner_name": zUpdateProjectBranchDatabaseBody.shape.database.shape.owner_name
6695
6695
  }),
6696
6696
  annotations: {
@@ -6727,8 +6727,8 @@ const operationFactories = {
6727
6727
  title: "Update a function",
6728
6728
  description: "Updates the function's mutable metadata — currently only the display `name`.",
6729
6729
  inputSchema: z.strictObject({
6730
- "project_id": zUpdateProjectBranchFunctionPath.shape.project_id,
6731
- "branch_id": zUpdateProjectBranchFunctionPath.shape.branch_id,
6730
+ "project_id": zUpdateProjectBranchFunctionPath.shape.project_id.describe("Project id."),
6731
+ "branch_id": zUpdateProjectBranchFunctionPath.shape.branch_id.describe("A br-... id, not a name."),
6732
6732
  "slug": zUpdateProjectBranchFunctionPath.shape.slug,
6733
6733
  "name": zUpdateProjectBranchFunctionBody.shape.name.describe("New display name for the function.")
6734
6734
  }),
@@ -6763,8 +6763,8 @@ const operationFactories = {
6763
6763
  title: "Update a trigger",
6764
6764
  description: "Applies a partial update.",
6765
6765
  inputSchema: z.strictObject({
6766
- "project_id": zUpdateProjectBranchTriggerPath.shape.project_id,
6767
- "branch_id": zUpdateProjectBranchTriggerPath.shape.branch_id,
6766
+ "project_id": zUpdateProjectBranchTriggerPath.shape.project_id.describe("Project id."),
6767
+ "branch_id": zUpdateProjectBranchTriggerPath.shape.branch_id.describe("A br-... id, not a name."),
6768
6768
  "trigger_id": zUpdateProjectBranchTriggerPath.shape.trigger_id,
6769
6769
  "body": zUpdateProjectBranchTriggerBody.describe("Partial trigger update discriminated by `type`.")
6770
6770
  }),
@@ -6799,7 +6799,7 @@ const operationFactories = {
6799
6799
  title: "Update compute endpoint",
6800
6800
  description: "Updates the specified compute endpoint.",
6801
6801
  inputSchema: z.strictObject({
6802
- "project_id": zUpdateProjectEndpointPath.shape.project_id,
6802
+ "project_id": zUpdateProjectEndpointPath.shape.project_id.describe("Project id."),
6803
6803
  "endpoint_id": zUpdateProjectEndpointPath.shape.endpoint_id,
6804
6804
  "branch_id": zUpdateProjectEndpointBody.shape.endpoint.shape.branch_id,
6805
6805
  "autoscaling_limit_min_cu": zUpdateProjectEndpointBody.shape.endpoint.shape.autoscaling_limit_min_cu,
@@ -6855,7 +6855,7 @@ const operationFactories = {
6855
6855
  title: "Update snapshot",
6856
6856
  description: "Updates the specified snapshot.",
6857
6857
  inputSchema: z.strictObject({
6858
- "project_id": zUpdateSnapshotPath.shape.project_id,
6858
+ "project_id": zUpdateSnapshotPath.shape.project_id.describe("Project id."),
6859
6859
  "snapshot_id": zUpdateSnapshotPath.shape.snapshot_id,
6860
6860
  "name": zUpdateSnapshotBody.shape.snapshot.shape.name,
6861
6861
  "expires_at": zUpdateSnapshotBody.shape.snapshot.shape.expires_at.describe("The date and time when the snapshot will expire.")