@naturali/sdk 0.156.1 → 0.157.1

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.
package/dist/index.d.cts CHANGED
@@ -402,16 +402,25 @@ type ActorRecord = {
402
402
  };
403
403
  type ErrorResponse = {
404
404
  /**
405
- * Structured error. Every error response uses this shape — 401, 403 and the 500 catch-all included — so `code` can be read without first checking the type of `error`.
405
+ * Structured error. Every error response uses this shape, so `code` can be read without first checking the type of `error`.
406
406
  */
407
407
  error: {
408
408
  /**
409
- * A key from the server's ERROR_CODES registry.
409
+ * Machine-readable error code: lower_snake for an error naturali raises (`access_denied`), UPPER_SNAKE for one the runtime reports (`RESOURCE_NOT_FOUND`).
410
410
  */
411
411
  code: string;
412
+ /**
413
+ * Human-readable explanation.
414
+ */
412
415
  message: string;
413
416
  /**
414
- * Optional structured context for the error.
417
+ * Structured context for an error naturali raises, such as the `resource` and `limit` of a `plan_limit_reached`.
418
+ */
419
+ details?: {
420
+ [key: string]: unknown;
421
+ };
422
+ /**
423
+ * Structured context for an error the runtime reports.
415
424
  */
416
425
  meta?: {
417
426
  [key: string]: unknown;
@@ -521,7 +530,7 @@ type User = {
521
530
  name?: string | null;
522
531
  email_verified: boolean;
523
532
  /**
524
- * Roles on naturali itself, not on a project. Empty for almost every account; `admin` marks a naturali operator.
533
+ * Roles on naturali itself, not on a project. Empty for almost every account; `admin` marks a naturali operator. Changed only through `PUT /v1/admin/users/{user_id}/roles`, by a caller holding the role that grants each one.
525
534
  */
526
535
  roles: Array<'admin'>;
527
536
  /**
@@ -8914,8 +8923,7 @@ type ListAddressesErrors = {
8914
8923
  */
8915
8924
  401: ErrorResponse;
8916
8925
  /**
8917
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
8918
- *
8926
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
8919
8927
  */
8920
8928
  403: ErrorResponse;
8921
8929
  /**
@@ -8953,8 +8961,7 @@ type DeleteAddressErrors = {
8953
8961
  */
8954
8962
  401: ErrorResponse;
8955
8963
  /**
8956
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
8957
- *
8964
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
8958
8965
  */
8959
8966
  403: ErrorResponse;
8960
8967
  /**
@@ -8992,8 +8999,7 @@ type GetAddressErrors = {
8992
8999
  */
8993
9000
  401: ErrorResponse;
8994
9001
  /**
8995
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
8996
- *
9002
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
8997
9003
  */
8998
9004
  403: ErrorResponse;
8999
9005
  /**
@@ -9035,8 +9041,7 @@ type SetAddressActionErrors = {
9035
9041
  */
9036
9042
  401: ErrorResponse;
9037
9043
  /**
9038
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9039
- *
9044
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
9040
9045
  */
9041
9046
  403: ErrorResponse;
9042
9047
  /**
@@ -9087,8 +9092,7 @@ type ListAddressConversationsErrors = {
9087
9092
  */
9088
9093
  401: ErrorResponse;
9089
9094
  /**
9090
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9091
- *
9095
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
9092
9096
  */
9093
9097
  403: ErrorResponse;
9094
9098
  /**
@@ -9138,8 +9142,7 @@ type ListUsersErrors = {
9138
9142
  */
9139
9143
  401: ErrorResponse;
9140
9144
  /**
9141
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9142
- *
9145
+ * The caller does not hold the `admin` role.
9143
9146
  */
9144
9147
  403: ErrorResponse;
9145
9148
  };
@@ -9169,12 +9172,11 @@ type UpdateUserRolesErrors = {
9169
9172
  */
9170
9173
  401: ErrorResponse;
9171
9174
  /**
9172
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9173
- *
9175
+ * The caller does not hold the `admin` role.
9174
9176
  */
9175
9177
  403: ErrorResponse;
9176
9178
  /**
9177
- * The resource does not exist (existence is not leaked).
9179
+ * No such user.
9178
9180
  */
9179
9181
  404: ErrorResponse;
9180
9182
  };
@@ -9213,12 +9215,11 @@ type ListUserPlanHistoryErrors = {
9213
9215
  */
9214
9216
  401: ErrorResponse;
9215
9217
  /**
9216
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9217
- *
9218
+ * The caller does not hold the `admin` role.
9218
9219
  */
9219
9220
  403: ErrorResponse;
9220
9221
  /**
9221
- * The resource does not exist (existence is not leaked).
9222
+ * No such user.
9222
9223
  */
9223
9224
  404: ErrorResponse;
9224
9225
  };
@@ -9248,12 +9249,11 @@ type GrantUserPlanErrors = {
9248
9249
  */
9249
9250
  401: ErrorResponse;
9250
9251
  /**
9251
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9252
- *
9252
+ * The caller does not hold the `admin` role.
9253
9253
  */
9254
9254
  403: ErrorResponse;
9255
9255
  /**
9256
- * The resource does not exist (existence is not leaked).
9256
+ * No such user.
9257
9257
  */
9258
9258
  404: ErrorResponse;
9259
9259
  };
@@ -9292,12 +9292,11 @@ type ListUserCreditsErrors = {
9292
9292
  */
9293
9293
  401: ErrorResponse;
9294
9294
  /**
9295
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9296
- *
9295
+ * The caller does not hold the `admin` role.
9297
9296
  */
9298
9297
  403: ErrorResponse;
9299
9298
  /**
9300
- * The resource does not exist (existence is not leaked).
9299
+ * No such user.
9301
9300
  */
9302
9301
  404: ErrorResponse;
9303
9302
  };
@@ -9327,12 +9326,11 @@ type GrantUserCreditErrors = {
9327
9326
  */
9328
9327
  401: ErrorResponse;
9329
9328
  /**
9330
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9331
- *
9329
+ * The caller does not hold the `admin` role.
9332
9330
  */
9333
9331
  403: ErrorResponse;
9334
9332
  /**
9335
- * The resource does not exist (existence is not leaked).
9333
+ * No such user.
9336
9334
  */
9337
9335
  404: ErrorResponse;
9338
9336
  };
@@ -9356,8 +9354,7 @@ type GetAdminPriceBookErrors = {
9356
9354
  */
9357
9355
  401: ErrorResponse;
9358
9356
  /**
9359
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9360
- *
9357
+ * The caller does not hold the `admin` role.
9361
9358
  */
9362
9359
  403: ErrorResponse;
9363
9360
  };
@@ -9396,12 +9393,11 @@ type ListUserStatementsErrors = {
9396
9393
  */
9397
9394
  401: ErrorResponse;
9398
9395
  /**
9399
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
9400
- *
9396
+ * The caller does not hold the `admin` role.
9401
9397
  */
9402
9398
  403: ErrorResponse;
9403
9399
  /**
9404
- * The resource does not exist (existence is not leaked).
9400
+ * No such user.
9405
9401
  */
9406
9402
  404: ErrorResponse;
9407
9403
  };
@@ -10456,8 +10452,7 @@ type CreateApiKeyErrors = {
10456
10452
  */
10457
10453
  401: ErrorResponse;
10458
10454
  /**
10459
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
10460
- *
10455
+ * Authenticated, but not permitted to act on this key.
10461
10456
  */
10462
10457
  403: ErrorResponse;
10463
10458
  };
@@ -10486,8 +10481,7 @@ type DeleteApiKeyErrors = {
10486
10481
  */
10487
10482
  401: ErrorResponse;
10488
10483
  /**
10489
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
10490
- *
10484
+ * Authenticated, but not permitted to act on this key.
10491
10485
  */
10492
10486
  403: ErrorResponse;
10493
10487
  /**
@@ -10520,8 +10514,7 @@ type GetApiKeyErrors = {
10520
10514
  */
10521
10515
  401: ErrorResponse;
10522
10516
  /**
10523
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
10524
- *
10517
+ * Authenticated, but not permitted to act on this key.
10525
10518
  */
10526
10519
  403: ErrorResponse;
10527
10520
  /**
@@ -10558,8 +10551,7 @@ type UpdateApiKeyErrors = {
10558
10551
  */
10559
10552
  401: ErrorResponse;
10560
10553
  /**
10561
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
10562
- *
10554
+ * Authenticated, but not permitted to act on this key.
10563
10555
  */
10564
10556
  403: ErrorResponse;
10565
10557
  /**
@@ -10592,8 +10584,7 @@ type RotateApiKeyErrors = {
10592
10584
  */
10593
10585
  401: ErrorResponse;
10594
10586
  /**
10595
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
10596
- *
10587
+ * Authenticated, but not permitted to act on this key.
10597
10588
  */
10598
10589
  403: ErrorResponse;
10599
10590
  /**
@@ -11380,8 +11371,7 @@ type ListChannelRoutesErrors = {
11380
11371
  */
11381
11372
  401: ErrorResponse;
11382
11373
  /**
11383
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11384
- *
11374
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11385
11375
  */
11386
11376
  403: ErrorResponse;
11387
11377
  /**
@@ -11422,8 +11412,7 @@ type CreateChannelRouteErrors = {
11422
11412
  */
11423
11413
  401: ErrorResponse;
11424
11414
  /**
11425
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11426
- *
11415
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11427
11416
  */
11428
11417
  403: ErrorResponse;
11429
11418
  /**
@@ -11468,8 +11457,7 @@ type DeleteChannelRouteErrors = {
11468
11457
  */
11469
11458
  401: ErrorResponse;
11470
11459
  /**
11471
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11472
- *
11460
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11473
11461
  */
11474
11462
  403: ErrorResponse;
11475
11463
  /**
@@ -11510,8 +11498,7 @@ type GetChannelRouteErrors = {
11510
11498
  */
11511
11499
  401: ErrorResponse;
11512
11500
  /**
11513
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11514
- *
11501
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11515
11502
  */
11516
11503
  403: ErrorResponse;
11517
11504
  /**
@@ -11556,8 +11543,7 @@ type UpdateChannelRouteErrors = {
11556
11543
  */
11557
11544
  401: ErrorResponse;
11558
11545
  /**
11559
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11560
- *
11546
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11561
11547
  */
11562
11548
  403: ErrorResponse;
11563
11549
  /**
@@ -11594,8 +11580,7 @@ type ListProjectChannelRoutesErrors = {
11594
11580
  */
11595
11581
  401: ErrorResponse;
11596
11582
  /**
11597
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11598
- *
11583
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11599
11584
  */
11600
11585
  403: ErrorResponse;
11601
11586
  /**
@@ -11639,8 +11624,7 @@ type ListChannelsErrors = {
11639
11624
  */
11640
11625
  401: ErrorResponse;
11641
11626
  /**
11642
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11643
- *
11627
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11644
11628
  */
11645
11629
  403: ErrorResponse;
11646
11630
  /**
@@ -11677,8 +11661,7 @@ type CreateChannelErrors = {
11677
11661
  */
11678
11662
  401: ErrorResponse;
11679
11663
  /**
11680
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11681
- *
11664
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11682
11665
  */
11683
11666
  403: ErrorResponse;
11684
11667
  /**
@@ -11729,8 +11712,7 @@ type DeleteChannelErrors = {
11729
11712
  */
11730
11713
  401: ErrorResponse;
11731
11714
  /**
11732
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11733
- *
11715
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11734
11716
  */
11735
11717
  403: ErrorResponse;
11736
11718
  /**
@@ -11772,8 +11754,7 @@ type GetChannelErrors = {
11772
11754
  */
11773
11755
  401: ErrorResponse;
11774
11756
  /**
11775
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11776
- *
11757
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11777
11758
  */
11778
11759
  403: ErrorResponse;
11779
11760
  /**
@@ -11814,8 +11795,7 @@ type UpdateChannelErrors = {
11814
11795
  */
11815
11796
  401: ErrorResponse;
11816
11797
  /**
11817
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11818
- *
11798
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11819
11799
  */
11820
11800
  403: ErrorResponse;
11821
11801
  /**
@@ -11875,8 +11855,7 @@ type ListChannelConversationsErrors = {
11875
11855
  */
11876
11856
  401: ErrorResponse;
11877
11857
  /**
11878
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11879
- *
11858
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11880
11859
  */
11881
11860
  403: ErrorResponse;
11882
11861
  /**
@@ -11922,8 +11901,7 @@ type OpenChannelConversationErrors = {
11922
11901
  */
11923
11902
  401: ErrorResponse;
11924
11903
  /**
11925
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11926
- *
11904
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11927
11905
  */
11928
11906
  403: ErrorResponse;
11929
11907
  /**
@@ -11973,8 +11951,7 @@ type DeleteChannelConversationErrors = {
11973
11951
  */
11974
11952
  401: ErrorResponse;
11975
11953
  /**
11976
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
11977
- *
11954
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
11978
11955
  */
11979
11956
  403: ErrorResponse;
11980
11957
  /**
@@ -12015,8 +11992,7 @@ type GetChannelConversationErrors = {
12015
11992
  */
12016
11993
  401: ErrorResponse;
12017
11994
  /**
12018
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
12019
- *
11995
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
12020
11996
  */
12021
11997
  403: ErrorResponse;
12022
11998
  /**
@@ -12070,8 +12046,7 @@ type ListChannelConversationMessagesErrors = {
12070
12046
  */
12071
12047
  401: ErrorResponse;
12072
12048
  /**
12073
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
12074
- *
12049
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
12075
12050
  */
12076
12051
  403: ErrorResponse;
12077
12052
  /**
@@ -15342,8 +15317,7 @@ type UploadFileErrors = {
15342
15317
  */
15343
15318
  401: ErrorResponse;
15344
15319
  /**
15345
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15346
- *
15320
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15347
15321
  */
15348
15322
  403: ErrorResponse;
15349
15323
  /**
@@ -15384,8 +15358,7 @@ type UploadFileBase64Errors = {
15384
15358
  */
15385
15359
  401: ErrorResponse;
15386
15360
  /**
15387
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15388
- *
15361
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15389
15362
  */
15390
15363
  403: ErrorResponse;
15391
15364
  /**
@@ -15493,8 +15466,7 @@ type DownloadFileErrors = {
15493
15466
  */
15494
15467
  401: ErrorResponse;
15495
15468
  /**
15496
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15497
- *
15469
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15498
15470
  */
15499
15471
  403: ErrorResponse;
15500
15472
  /**
@@ -15544,8 +15516,7 @@ type UpdateFileMetadataErrors = {
15544
15516
  */
15545
15517
  401: ErrorResponse;
15546
15518
  /**
15547
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15548
- *
15519
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15549
15520
  */
15550
15521
  403: ErrorResponse;
15551
15522
  /**
@@ -15591,8 +15562,7 @@ type DownloadFileBase64Errors = {
15591
15562
  */
15592
15563
  401: ErrorResponse;
15593
15564
  /**
15594
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15595
- *
15565
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15596
15566
  */
15597
15567
  403: ErrorResponse;
15598
15568
  /**
@@ -15646,8 +15616,7 @@ type GetFileTagsErrors = {
15646
15616
  */
15647
15617
  401: ErrorResponse;
15648
15618
  /**
15649
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15650
- *
15619
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15651
15620
  */
15652
15621
  403: ErrorResponse;
15653
15622
  /**
@@ -15684,8 +15653,7 @@ type MergeFileTagsErrors = {
15684
15653
  */
15685
15654
  401: ErrorResponse;
15686
15655
  /**
15687
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15688
- *
15656
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15689
15657
  */
15690
15658
  403: ErrorResponse;
15691
15659
  /**
@@ -15722,8 +15690,7 @@ type ReplaceFileTagsErrors = {
15722
15690
  */
15723
15691
  401: ErrorResponse;
15724
15692
  /**
15725
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
15726
- *
15693
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
15727
15694
  */
15728
15695
  403: ErrorResponse;
15729
15696
  /**
@@ -19620,8 +19587,7 @@ type CreateProjectErrors = {
19620
19587
  */
19621
19588
  401: ErrorResponse;
19622
19589
  /**
19623
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19624
- *
19590
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19625
19591
  */
19626
19592
  403: ErrorResponse;
19627
19593
  /**
@@ -19660,8 +19626,7 @@ type DeleteProjectErrors = {
19660
19626
  */
19661
19627
  401: ErrorResponse;
19662
19628
  /**
19663
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19664
- *
19629
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19665
19630
  */
19666
19631
  403: ErrorResponse;
19667
19632
  /**
@@ -19698,8 +19663,7 @@ type GetProjectErrors = {
19698
19663
  */
19699
19664
  401: ErrorResponse;
19700
19665
  /**
19701
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19702
- *
19666
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19703
19667
  */
19704
19668
  403: ErrorResponse;
19705
19669
  /**
@@ -19736,8 +19700,7 @@ type UpdateProjectErrors = {
19736
19700
  */
19737
19701
  401: ErrorResponse;
19738
19702
  /**
19739
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19740
- *
19703
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19741
19704
  */
19742
19705
  403: ErrorResponse;
19743
19706
  /**
@@ -19774,8 +19737,7 @@ type PauseProjectErrors = {
19774
19737
  */
19775
19738
  401: ErrorResponse;
19776
19739
  /**
19777
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19778
- *
19740
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19779
19741
  */
19780
19742
  403: ErrorResponse;
19781
19743
  /**
@@ -19808,8 +19770,7 @@ type ResumeProjectErrors = {
19808
19770
  */
19809
19771
  401: ErrorResponse;
19810
19772
  /**
19811
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19812
- *
19773
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19813
19774
  */
19814
19775
  403: ErrorResponse;
19815
19776
  /**
@@ -19846,8 +19807,7 @@ type ListProjectMembersErrors = {
19846
19807
  */
19847
19808
  401: ErrorResponse;
19848
19809
  /**
19849
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19850
- *
19810
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19851
19811
  */
19852
19812
  403: ErrorResponse;
19853
19813
  /**
@@ -19934,8 +19894,7 @@ type RemoveProjectMemberErrors = {
19934
19894
  */
19935
19895
  401: ErrorResponse;
19936
19896
  /**
19937
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19938
- *
19897
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19939
19898
  */
19940
19899
  403: ErrorResponse;
19941
19900
  /**
@@ -19976,8 +19935,7 @@ type UpdateProjectMemberErrors = {
19976
19935
  */
19977
19936
  401: ErrorResponse;
19978
19937
  /**
19979
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
19980
- *
19938
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
19981
19939
  */
19982
19940
  403: ErrorResponse;
19983
19941
  /**
@@ -20888,8 +20846,7 @@ type ListSessionsErrors = {
20888
20846
  */
20889
20847
  401: ErrorResponse;
20890
20848
  /**
20891
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
20892
- *
20849
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
20893
20850
  */
20894
20851
  403: ErrorResponse;
20895
20852
  /**
@@ -20927,8 +20884,7 @@ type CreateSessionErrors = {
20927
20884
  */
20928
20885
  401: ErrorResponse;
20929
20886
  /**
20930
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
20931
- *
20887
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
20932
20888
  */
20933
20889
  403: ErrorResponse;
20934
20890
  /**
@@ -20969,8 +20925,7 @@ type DeleteSessionErrors = {
20969
20925
  */
20970
20926
  401: ErrorResponse;
20971
20927
  /**
20972
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
20973
- *
20928
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
20974
20929
  */
20975
20930
  403: ErrorResponse;
20976
20931
  /**
@@ -21007,8 +20962,7 @@ type GetSessionErrors = {
21007
20962
  */
21008
20963
  401: ErrorResponse;
21009
20964
  /**
21010
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21011
- *
20965
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21012
20966
  */
21013
20967
  403: ErrorResponse;
21014
20968
  /**
@@ -21045,8 +20999,7 @@ type UpdateSessionErrors = {
21045
20999
  */
21046
21000
  401: ErrorResponse;
21047
21001
  /**
21048
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21049
- *
21002
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21050
21003
  */
21051
21004
  403: ErrorResponse;
21052
21005
  /**
@@ -21083,8 +21036,7 @@ type AddSessionMessageErrors = {
21083
21036
  */
21084
21037
  401: ErrorResponse;
21085
21038
  /**
21086
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21087
- *
21039
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21088
21040
  */
21089
21041
  403: ErrorResponse;
21090
21042
  /**
@@ -21130,8 +21082,7 @@ type GenerateSessionResponseErrors = {
21130
21082
  */
21131
21083
  401: ErrorResponse;
21132
21084
  /**
21133
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21134
- *
21085
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21135
21086
  */
21136
21087
  403: ErrorResponse;
21137
21088
  /**
@@ -21188,8 +21139,7 @@ type SubmitSessionToolOutputsErrors = {
21188
21139
  */
21189
21140
  401: ErrorResponse;
21190
21141
  /**
21191
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21192
- *
21142
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21193
21143
  */
21194
21144
  403: ErrorResponse;
21195
21145
  /**
@@ -21230,8 +21180,7 @@ type ForkSessionErrors = {
21230
21180
  */
21231
21181
  401: ErrorResponse;
21232
21182
  /**
21233
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21234
- *
21183
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21235
21184
  */
21236
21185
  403: ErrorResponse;
21237
21186
  /**
@@ -21271,8 +21220,7 @@ type ListSessionForksErrors = {
21271
21220
  */
21272
21221
  401: ErrorResponse;
21273
21222
  /**
21274
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21275
- *
21223
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21276
21224
  */
21277
21225
  403: ErrorResponse;
21278
21226
  /**
@@ -21314,8 +21262,7 @@ type GetSessionTagsErrors = {
21314
21262
  */
21315
21263
  401: ErrorResponse;
21316
21264
  /**
21317
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21318
- *
21265
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21319
21266
  */
21320
21267
  403: ErrorResponse;
21321
21268
  /**
@@ -21352,8 +21299,7 @@ type MergeSessionTagsErrors = {
21352
21299
  */
21353
21300
  401: ErrorResponse;
21354
21301
  /**
21355
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21356
- *
21302
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21357
21303
  */
21358
21304
  403: ErrorResponse;
21359
21305
  /**
@@ -21390,8 +21336,7 @@ type ReplaceSessionTagsErrors = {
21390
21336
  */
21391
21337
  401: ErrorResponse;
21392
21338
  /**
21393
- * The caller's role in the project does not carry this action, or the credential is scoped to a different project.
21394
- *
21339
+ * The credential is scoped to a different project, or the caller's role in the project does not carry this action.
21395
21340
  */
21396
21341
  403: ErrorResponse;
21397
21342
  /**
@@ -22635,16 +22580,15 @@ type RestoreCurrentUserStopErrors = {
22635
22580
  */
22636
22581
  401: ErrorResponse;
22637
22582
  /**
22638
- * The resource does not exist (existence is not leaked).
22583
+ * No such stop on this account, or it was already restored or dismissed.
22639
22584
  */
22640
22585
  404: ErrorResponse;
22641
22586
  /**
22642
- * The request conflicts with the resource's current state.
22587
+ * The stop cannot be restored now.
22643
22588
  */
22644
22589
  409: ErrorResponse;
22645
22590
  /**
22646
- * The upstream runtime, or Meta, could not complete the operation.
22647
- *
22591
+ * The runtime could not turn the item back on; the stop stays listed.
22648
22592
  */
22649
22593
  502: ErrorResponse;
22650
22594
  };
@@ -22673,7 +22617,7 @@ type DismissCurrentUserStopErrors = {
22673
22617
  */
22674
22618
  401: ErrorResponse;
22675
22619
  /**
22676
- * The resource does not exist (existence is not leaked).
22620
+ * No such stop on this account, or it was already restored or dismissed.
22677
22621
  */
22678
22622
  404: ErrorResponse;
22679
22623
  };
@@ -22819,7 +22763,7 @@ type CreateWebhookErrors = {
22819
22763
  */
22820
22764
  409: ErrorResponse;
22821
22765
  /**
22822
- * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
22766
+ * The requested path is not enabled on this deployment — a webhook secret cannot be stored where no credential-sealing key is configured.
22823
22767
  *
22824
22768
  */
22825
22769
  501: ErrorResponse;
@@ -22960,7 +22904,7 @@ type RotateWebhookSecretErrors = {
22960
22904
  */
22961
22905
  404: ErrorResponse;
22962
22906
  /**
22963
- * The requested path is not enabled on this deployment (e.g. embedded signup before Meta App credentials are configured, or a Discord channel before `CHANNEL_TOKEN_KEY` is set).
22907
+ * The requested path is not enabled on this deployment — a webhook secret cannot be stored where no credential-sealing key is configured.
22964
22908
  *
22965
22909
  */
22966
22910
  501: ErrorResponse;